repositories / pi-ext
pi-ext
bugabingas pi extensions
owned by admin
extensions/quota/src/parse.ts
Rawimport type { QuotaBucket, QuotaValue } from "./types.ts";
export function object(value: unknown): Record<string, unknown> {
return typeof value === "object" && value !== null && !Array.isArray(value)
? (value as Record<string, unknown>)
: {};
}
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<string, string>,
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,
};
}