/**
 * chatCore failed-request usage record builder (Quality Gate v2 / Fase 9 — chatCore god-file
 * decomposition, #3501).
 *
 * Pure core of handleChatCore's persistFailureUsage closure: builds the usage-history entry for a
 * failed request (zeroed tokens/timing, success:false, the unknown/undefined fallbacks, and the
 * combo-strategy gate). The handler keeps the impure parts byte-identically: it computes
 * `latencyMs` (Date.now() - startTime) and fires the fire-and-forget saveRequestUsage(...).catch().
 */

export function buildFailureUsageRecord(opts: {
  provider: string | null | undefined;
  model: string | null | undefined;
  connectionId: string | null | undefined;
  apiKeyInfo: { id?: string; name?: string } | null | undefined;
  effectiveServiceTier: string;
  isCombo: boolean;
  comboStrategy: string | null | undefined;
  statusCode: number;
  errorCode: string | null | undefined;
  latencyMs: number;
  endpoint?: string | null | undefined;
}) {
  return {
    provider: opts.provider || "unknown",
    model: opts.model || "unknown",
    tokens: { input: 0, output: 0, cacheRead: 0, cacheCreation: 0, reasoning: 0 },
    status: String(opts.statusCode),
    success: false,
    latencyMs: opts.latencyMs,
    timeToFirstTokenMs: 0,
    errorCode: opts.errorCode || String(opts.statusCode),
    timestamp: new Date().toISOString(),
    connectionId: opts.connectionId || undefined,
    apiKeyId: opts.apiKeyInfo?.id || undefined,
    apiKeyName: opts.apiKeyInfo?.name || undefined,
    serviceTier: opts.effectiveServiceTier,
    comboStrategy: opts.isCombo ? opts.comboStrategy || undefined : undefined,
    endpoint: opts.endpoint || undefined,
  };
}