エンティティ内蔵のクールダウン警告抑制

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秒に1回まで
const limiter = new RateLimiter(100, 60_000)

// リクエストを記録
for (let i = 0; i < 150; i++) {
  limiter.record()
  // 100回目で警告、101回目以降は60秒間抑制される
}

// 1分後に再度超過すると、また警告が発される
setTimeout(() => {
  limiter.record() // 警告が再度表示される
}, 61_000)