Luigit
repositories / pi-ext

pi-ext

bugabingas pi extensions

owned by admin

extensions/quota/src/types.ts

Raw
export type QuotaValue =
	| {
			state: "measured";
			unit: "percent" | "requests" | "credits" | "currency" | "unknown";
			unitLabel?: string | undefined;
			used?: number | undefined;
			remaining?: number | undefined;
			total?: number | undefined;
			usedPercent?: number | undefined;
	  }
	| { state: "unlimited" }
	| { state: "unknown" };

export interface QuotaBucket {
	id: string;
	label: string;
	kind: "allowance" | "balance" | "spend-cap";
	observedAt: number;
	scope?: string | undefined;
	period?:
		| {
				label: string;
				durationMs?: number | undefined;
				resetsAt?: number | undefined;
		  }
		| undefined;
	value: QuotaValue;
}

export interface ProviderQuota {
	provider: string;
	name: string;
	buckets: QuotaBucket[];
	/** Oldest retained observation when partial header updates are merged. */
	observedAt: number;
}

export interface QuotaProvider {
	name: string;
	fetch: (key: string) => Promise<ProviderQuota>;
	headers?:
		| ((headers: Record<string, string>) => ProviderQuota | undefined)
		| undefined;
}