엔티티 내장 쿨다운 경고 억제

interface WarnableEntity {
  /** 마지막 경고 발생 시각 (밀리초) */
  warnedAt: number | null
  /** 경고 쿨다운 기간 (밀리초) */
  warnCooldown: number
}

/**
 * 쿨다운 기반 경고 엔티티의 기본 클래스
 */
class CooldownWarner<T extends WarnableEntity> {
  constructor(protected entity: T) {}

  /**
   * 경고를 발생시켜야 하는지 판단
   */
  protected shouldWarn(): boolean {
    const now = Date.now()
    if (this.entity.warnedAt === null) {
      return true
    }
    const elapsed = now - this.entity.warnedAt
    return elapsed >= this.entity.warnCooldown
  }

  /**
   * 경고를 발생시키고 warnedAt 업데이트
   */
  protected warnBy(message: string): void {
    if (!this.shouldWarn()) {
      return
    }
    console.warn(message)
    this.entity.warnedAt = Date.now()
  }
}

/**
 * 속도 제한 엔티티 구현 예제
 */
interface RateLimitEntity extends WarnableEntity {
  limit: number
  current: number
}

class RateLimiter extends CooldownWarner<RateLimitEntity> {
  constructor(limit: number, cooldown: number = 60_000) {
    super({
      limit,
      current: 0,
      warnedAt: null,
      warnCooldown: cooldown
    })
  }

  /**
   * 요청을 기록하고 필요시 경고
   */
  record(): void {
    this.entity.current++

    if (this.entity.current >= this.entity.limit) {
      this.warnBy(
        `Rate limit reached: ${this.entity.current}/${this.entity.limit}`
      )
    }
  }

  /**
   * 카운터 리셋
   */
  reset(): void {
    this.entity.current = 0
  }
}

// 분당 100개 요청 제한, 경고는 60초에 한 번까지
const limiter = new RateLimiter(100, 60_000)

// 요청 기록
for (let i = 0; i < 150; i++) {
  limiter.record()
  // 100번째에 경고, 이후 60초간 억제됨
}

// 1분 후 다시 초과하면 경고 재발생
setTimeout(() => {
  limiter.record() // 경고가 다시 표시됨
}, 61_000)