Luigit
repositories / pi-ext

pi-ext

bugabingas pi extensions

owned by admin

extensions/quota/src/parse.ts

Raw
import 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,
	};
}