import type { QuotaBucket, QuotaValue } from "./types.ts"; export function object(value: unknown): Record { return typeof value === "object" && value !== null && !Array.isArray(value) ? (value as Record) : {}; } export function list(value: unknown): unknown[] { return Array.isArray(value) ? value.slice(0, 256) : []; } export function finite(value: unknown): number | undefined { return typeof value === "number" && Number.isFinite(value) ? value : undefined; } /** Only for wire fields documented/observed as numeric strings. */ export function numeric(value: unknown): number | undefined { return typeof value === "string" && value.trim() !== "" ? finite(Number(value)) : finite(value); } export function label(value: unknown): string | undefined { if (typeof value !== "string") return undefined; return ( value .replace(/[\u0000-\u001f\u007f-\u009f]/g, "") .trim() .slice(0, 80) || undefined ); } export function isoTime(value: unknown): number | undefined { return typeof value === "string" ? finite(Date.parse(value)) : undefined; } export function epoch(value: unknown, factor = 1): number | undefined { const n = finite(value); return n !== undefined && n > 0 ? finite(n * factor) : undefined; } export function headerNumber( headers: Record, name: string, ): number | undefined { return numeric(headers[name]); } export function percent(value: unknown): QuotaValue { const n = finite(value); if (n === undefined) return { state: "unknown" }; const used = Math.min(100, Math.max(0, n)); return { state: "measured", unit: "percent", used, remaining: 100 - used, total: 100, }; } export function amount( unit: "requests" | "credits" | "currency" | "unknown", used: number | undefined, total: number | undefined, remaining?: number | undefined, unitLabel?: string | undefined, ): QuotaValue { used = used !== undefined && used >= 0 ? used : undefined; total = total !== undefined && total >= 0 ? total : undefined; remaining = remaining !== undefined && remaining >= 0 ? remaining : undefined; if (used === undefined && total !== undefined && remaining !== undefined) used = Math.max(0, total - remaining); if (remaining === undefined && total !== undefined && used !== undefined) remaining = Math.max(0, total - used); if (used === undefined && total === undefined && remaining === undefined) return { state: "unknown" }; return { state: "measured", unit, used, total, remaining, unitLabel }; } export function durationLabel( ms: number | undefined, fallback = "Usage", ): string { if (ms === undefined || ms <= 0) return fallback; if (ms === 604800000) return "Weekly"; if (ms % 86400000 === 0) return `${ms / 86400000}d`; if (ms % 3600000 === 0) return `${ms / 3600000}h`; if (ms % 60000 === 0) return `${ms / 60000}m`; return `${ms / 1000}s`; } export function windowBucket( id: string, name: string, value: QuotaValue, durationMs?: number | undefined, resetsAt?: number | undefined, scope?: string | undefined, ): QuotaBucket { return { id, label: name, kind: "allowance", observedAt: Date.now(), scope, period: { label: name, durationMs, resetsAt }, value, }; }