In Entität eingebettete Cooldown-Warnungsunterdrückung

interface WarnableEntity {
  /** Zeitstempel der letzten Warnung (Millisekunden) */
  warnedAt: number | null
  /** Cooldown-Zeitraum für Warnungen (Millisekunden) */
  warnCooldown: number
}

/**
 * Basisklasse für Entitäten mit Cooldown-basierten Warnungen
 */
class CooldownWarner<T extends WarnableEntity> {
  constructor(protected entity: T) {}

  /**
   * Ermittelt, ob eine Warnung ausgegeben werden soll
   */
  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
  }

  /**
   * Gibt eine Warnung aus und aktualisiert warnedAt
   */
  protected warnBy(message: string): void {
    if (!this.shouldWarn()) {
      return
    }
    console.warn(message)
    this.entity.warnedAt = Date.now()
  }
}

/**
 * Beispielimplementierung: Ratenlimit-Entität
 */
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
    })
  }

  /**
   * Zeichnet eine Anfrage auf und warnt bei Bedarf
   */
  record(): void {
    this.entity.current++

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

  /**
   * Setzt den Zähler zurück
   */
  reset(): void {
    this.entity.current = 0
  }
}

// 100 Anfragen/Min Ratenlimit, höchstens einmal alle 60 Sekunden warnen
const limiter = new RateLimiter(100, 60_000)

// Anfragen aufzeichnen
for (let i = 0; i < 150; i++) {
  limiter.record()
  // Warnt bei der 100. Anfrage, danach 60s lang unterdrückt
}

// Nach 1 Minute löst erneutes Überschreiten eine weitere Warnung aus
setTimeout(() => {
  limiter.record() // Warnung wird erneut angezeigt
}, 61_000)