@openlimiter/core 0.1.0

package/dist/forecast.js

@@ -0,0 +1,25 @@
+export function forecast(previous, current) {
+    if (previous.provider !== current.provider ||
+        previous.meter !== current.meter ||
+        previous.unit !== "PERCENT" ||
+        current.unit !== "PERCENT" ||
+        !Number.isFinite(previous.value) ||
+        !Number.isFinite(current.value) ||
+        previous.value < 0 ||
+        previous.value > 100 ||
+        current.value < 0 ||
+        current.value > 100)
+        return null;
+    const elapsedHours = (Date.parse(current.observedAt) - Date.parse(previous.observedAt)) / 3_600_000;
+    if (!Number.isFinite(elapsedHours) || elapsedHours <= 0)
+        return null;
+    const burnRatePerHour = (current.value - previous.value) / elapsedHours;
+    if (!Number.isFinite(burnRatePerHour) || burnRatePerHour <= 0)
+        return null;
+    const remaining = Math.max(0, 100 - current.value);
+    return {
+        burnRatePerHour,
+        hoursToExhaustion: remaining === 0 ? 0 : remaining / burnRatePerHour
+    };
+}
+//# sourceMappingURL=forecast.js.map

package/dist/forecast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forecast.js","sourceRoot":"","sources":["../src/forecast.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,QAAQ,CAAC,QAAkB,EAAE,OAAiB;IAC5D,IACE,QAAQ,CAAC,QAAQ,KAAK,OAAO,CAAC,QAAQ;QACtC,QAAQ,CAAC,KAAK,KAAK,OAAO,CAAC,KAAK;QAChC,QAAQ,CAAC,IAAI,KAAK,SAAS;QAC3B,OAAO,CAAC,IAAI,KAAK,SAAS;QAC1B,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC;QAChC,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC;QAC/B,QAAQ,CAAC,KAAK,GAAG,CAAC;QAClB,QAAQ,CAAC,KAAK,GAAG,GAAG;QACpB,OAAO,CAAC,KAAK,GAAG,CAAC;QACjB,OAAO,CAAC,KAAK,GAAG,GAAG;QACnB,OAAO,IAAI,CAAC;IACd,MAAM,YAAY,GAChB,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,GAAG,SAAS,CAAC;IACjF,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,YAAY,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACrE,MAAM,eAAe,GAAG,CAAC,OAAO,CAAC,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,YAAY,CAAC;IACxE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,eAAe,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3E,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IACnD,OAAO;QACL,eAAe;QACf,iBAAiB,EAAE,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,GAAG,eAAe;KACrE,CAAC;AACJ,CAAC"}

package/dist/format.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Display helpers that never round a usage value upward.
+ *
+ * Over reporting a quota would tell a human that a cap was reached when it was
+ * not, so every rendered number is truncated toward zero instead of rounded.
+ */
+/**
+ * Truncate a number to a fixed number of fraction digits and render it.
+ *
+ * The scaled value is first re read at twelve significant digits so that binary
+ * floating point noise (84.25 times 100 is 8425.000000000001) cannot push a
+ * value across a digit boundary in either direction.
+ */
+export declare function floorFixed(value: number, fractionDigits: number): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CAKxE"}

package/dist/format.js

@@ -0,0 +1,22 @@
+/**
+ * Display helpers that never round a usage value upward.
+ *
+ * Over reporting a quota would tell a human that a cap was reached when it was
+ * not, so every rendered number is truncated toward zero instead of rounded.
+ */
+const PRECISION_DIGITS = 12;
+/**
+ * Truncate a number to a fixed number of fraction digits and render it.
+ *
+ * The scaled value is first re read at twelve significant digits so that binary
+ * floating point noise (84.25 times 100 is 8425.000000000001) cannot push a
+ * value across a digit boundary in either direction.
+ */
+export function floorFixed(value, fractionDigits) {
+    if (!Number.isFinite(value))
+        return (0).toFixed(fractionDigits);
+    const scale = 10 ** fractionDigits;
+    const scaled = Number((value * scale).toPrecision(PRECISION_DIGITS));
+    return (Math.floor(scaled) / scale).toFixed(fractionDigits);
+}
+//# sourceMappingURL=format.js.map

package/dist/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAE5B;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAC,KAAa,EAAE,cAAsB;IAC9D,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IAChE,MAAM,KAAK,GAAG,EAAE,IAAI,cAAc,CAAC;IACnC,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAC,CAAC;IACrE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;AAC9D,CAAC"}

package/dist/freshness.d.ts

@@ -0,0 +1,3 @@
+import type { SnapshotState } from "./types.js";
+export declare function freshness(observedAt: string, expiresAt: string, now: string): SnapshotState;
+//# sourceMappingURL=freshness.d.ts.map

package/dist/freshness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"freshness.d.ts","sourceRoot":"","sources":["../src/freshness.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAOhD,wBAAgB,SAAS,CACvB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,GACV,aAAa,CAOf"}

package/dist/freshness.js

@@ -0,0 +1,15 @@
+function parseInstant(value) {
+    const parsed = Date.parse(value);
+    return Number.isFinite(parsed) ? parsed : null;
+}
+export function freshness(observedAt, expiresAt, now) {
+    const observed = parseInstant(observedAt);
+    const expires = parseInstant(expiresAt);
+    const current = parseInstant(now);
+    if (observed === null || expires === null || current === null)
+        return "unknown";
+    if (expires < observed || observed > current)
+        return "unknown";
+    return current <= expires ? "fresh" : "stale";
+}
+//# sourceMappingURL=freshness.js.map

package/dist/freshness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"freshness.js","sourceRoot":"","sources":["../src/freshness.ts"],"names":[],"mappings":"AAEA,SAAS,YAAY,CAAC,KAAa;IACjC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACjC,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,SAAS,CACvB,UAAkB,EAClB,SAAiB,EACjB,GAAW;IAEX,MAAM,QAAQ,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;IAC1C,MAAM,OAAO,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;IACxC,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IAClC,IAAI,QAAQ,KAAK,IAAI,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAChF,IAAI,OAAO,GAAG,QAAQ,IAAI,QAAQ,GAAG,OAAO;QAAE,OAAO,SAAS,CAAC;IAC/D,OAAO,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;AAChD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export * from "./cache.js";
+export * from "./forecast.js";
+export * from "./format.js";
+export * from "./freshness.js";
+export * from "./merge.js";
+export * from "./normalizer.js";
+export * from "./policy.js";
+export * from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+export * from "./cache.js";
+export * from "./forecast.js";
+export * from "./format.js";
+export * from "./freshness.js";
+export * from "./merge.js";
+export * from "./normalizer.js";
+export * from "./policy.js";
+export * from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC"}

package/dist/merge.d.ts

@@ -0,0 +1,12 @@
+import type { Snapshot } from "./types.js";
+/** Hard ceiling on how many snapshots one cache file may carry. */
+export declare const MAX_CACHE_ENTRIES = 64;
+/**
+ * Combine cached snapshots with freshly observed ones.
+ *
+ * One provider and meter pair holds exactly one snapshot. An incoming snapshot
+ * replaces the cached snapshot for that pair, every other cached row survives,
+ * and the result stays bounded by dropping the least recently observed rows.
+ */
+export declare function mergeSnapshots(existing: readonly Snapshot[], incoming: readonly Snapshot[], limit?: number): Snapshot[];
+//# sourceMappingURL=merge.d.ts.map

package/dist/merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.d.ts","sourceRoot":"","sources":["../src/merge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,mEAAmE;AACnE,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAqBpC;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,SAAS,QAAQ,EAAE,EAC7B,QAAQ,EAAE,SAAS,QAAQ,EAAE,EAC7B,KAAK,SAAoB,GACxB,QAAQ,EAAE,CAUZ"}

package/dist/merge.js

@@ -0,0 +1,40 @@
+/** Hard ceiling on how many snapshots one cache file may carry. */
+export const MAX_CACHE_ENTRIES = 64;
+/*
+ * A provider code and a meter name are both closed uppercase identifiers with
+ * no spaces, so joining them with one space cannot collide.
+ */
+function identity(snapshot) {
+    return snapshot.provider + " " + snapshot.meter;
+}
+function compareIdentity(left, right) {
+    const leftKey = identity(left);
+    const rightKey = identity(right);
+    return leftKey < rightKey ? -1 : leftKey > rightKey ? 1 : 0;
+}
+function observedMilliseconds(snapshot) {
+    const parsed = Date.parse(snapshot.observedAt);
+    return Number.isFinite(parsed) ? parsed : 0;
+}
+/**
+ * Combine cached snapshots with freshly observed ones.
+ *
+ * One provider and meter pair holds exactly one snapshot. An incoming snapshot
+ * replaces the cached snapshot for that pair, every other cached row survives,
+ * and the result stays bounded by dropping the least recently observed rows.
+ */
+export function mergeSnapshots(existing, incoming, limit = MAX_CACHE_ENTRIES) {
+    const byIdentity = new Map();
+    for (const snapshot of existing)
+        byIdentity.set(identity(snapshot), snapshot);
+    for (const snapshot of incoming)
+        byIdentity.set(identity(snapshot), snapshot);
+    const merged = [...byIdentity.values()];
+    if (merged.length <= limit)
+        return merged.sort(compareIdentity);
+    return merged
+        .sort((left, right) => observedMilliseconds(right) - observedMilliseconds(left))
+        .slice(0, limit)
+        .sort(compareIdentity);
+}
+//# sourceMappingURL=merge.js.map

package/dist/merge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.js","sourceRoot":"","sources":["../src/merge.ts"],"names":[],"mappings":"AAEA,mEAAmE;AACnE,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAEpC;;;GAGG;AACH,SAAS,QAAQ,CAAC,QAAkB;IAClC,OAAO,QAAQ,CAAC,QAAQ,GAAG,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC;AAClD,CAAC;AAED,SAAS,eAAe,CAAC,IAAc,EAAE,KAAe;IACtD,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IACjC,OAAO,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC9D,CAAC;AAED,SAAS,oBAAoB,CAAC,QAAkB;IAC9C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IAC/C,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAC5B,QAA6B,EAC7B,QAA6B,EAC7B,KAAK,GAAG,iBAAiB;IAEzB,MAAM,UAAU,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC/C,KAAK,MAAM,QAAQ,IAAI,QAAQ;QAAE,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC9E,KAAK,MAAM,QAAQ,IAAI,QAAQ;QAAE,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC9E,MAAM,MAAM,GAAG,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;IACxC,IAAI,MAAM,CAAC,MAAM,IAAI,KAAK;QAAE,OAAO,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAChE,OAAO,MAAM;SACV,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,oBAAoB,CAAC,KAAK,CAAC,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;SAC/E,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC;SACf,IAAI,CAAC,eAAe,CAAC,CAAC;AAC3B,CAAC"}

package/dist/normalizer.d.ts

@@ -0,0 +1,5 @@
+import { type RawMeter, type Snapshot } from "./types.js";
+export declare function normalizeMeter(raw: RawMeter): Snapshot | null;
+export declare function normalizeMeters(rawMeters: readonly RawMeter[]): Snapshot[];
+export declare function canonicalJson(value: unknown): string;
+//# sourceMappingURL=normalizer.d.ts.map

package/dist/normalizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizer.d.ts","sourceRoot":"","sources":["../src/normalizer.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,QAAQ,EACb,KAAK,QAAQ,EAKd,MAAM,YAAY,CAAC;AAuEpB,wBAAgB,cAAc,CAAC,GAAG,EAAE,QAAQ,GAAG,QAAQ,GAAG,IAAI,CAmC7D;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,SAAS,QAAQ,EAAE,GAAG,QAAQ,EAAE,CAK1E;AAUD,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEpD"}

package/dist/normalizer.js

@@ -0,0 +1,127 @@
+import { PROVIDER_CODES } from "./types.js";
+const units = new Set(["PERCENT", "CREDITS", "TOKENS", "REQUESTS"]);
+const sources = new Set([
+    "native_payload",
+    "documented_api",
+    "internal_payload",
+    "authenticated_page",
+    "manual_entry"
+]);
+const precisions = new Set(["exact", "estimated", "manual"]);
+const providerCodes = new Set(PROVIDER_CODES);
+const safeMeter = /^[A-Z][A-Z0-9_]{0,31}$/u;
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isIsoInstant(value) {
+    if (typeof value !== "string")
+        return false;
+    const parsed = Date.parse(value);
+    return Number.isFinite(parsed) && new Date(parsed).toISOString() === value;
+}
+function normalizeWindow(value) {
+    if (!isRecord(value))
+        return null;
+    const kind = value["kind"];
+    if (kind !== "rolling" &&
+        kind !== "fixed" &&
+        kind !== "lifetime" &&
+        kind !== "unknown")
+        return null;
+    const duration = value["durationSeconds"];
+    if (duration === undefined)
+        return { kind };
+    if (typeof duration !== "number" ||
+        !Number.isInteger(duration) ||
+        duration <= 0 ||
+        duration > 31_536_000)
+        return null;
+    return { kind, durationSeconds: duration };
+}
+function normalizeLabels(value) {
+    if (!isRecord(value) || value["verification"] !== "UNVERIFIED")
+        return null;
+    const credentialOrigin = value["credentialOrigin"];
+    const dataInterfaceStatus = value["dataInterfaceStatus"];
+    const automationRisk = value["automationRisk"];
+    if (credentialOrigin !== "official-local-tool" &&
+        credentialOrigin !== "user-key" &&
+        credentialOrigin !== "browser-session" &&
+        credentialOrigin !== "user-entered")
+        return null;
+    if (dataInterfaceStatus !== "native-statusline-payload" &&
+        dataInterfaceStatus !== "documented-api" &&
+        dataInterfaceStatus !== "internal-endpoint" &&
+        dataInterfaceStatus !== "authenticated-scrape" &&
+        dataInterfaceStatus !== "manual")
+        return null;
+    if (automationRisk !== "low" && automationRisk !== "high")
+        return null;
+    return {
+        credentialOrigin,
+        dataInterfaceStatus,
+        automationRisk,
+        verification: "UNVERIFIED"
+    };
+}
+export function normalizeMeter(raw) {
+    if (typeof raw.provider !== "string" || !providerCodes.has(raw.provider))
+        return null;
+    if (typeof raw.meter !== "string" || !safeMeter.test(raw.meter))
+        return null;
+    if (typeof raw.value !== "number" || !Number.isFinite(raw.value) || raw.value < 0) {
+        return null;
+    }
+    if (typeof raw.unit !== "string" || !units.has(raw.unit))
+        return null;
+    if (raw.unit === "PERCENT" && raw.value > 100)
+        return null;
+    if (raw.value > 1_000_000_000_000)
+        return null;
+    const window = normalizeWindow(raw.window);
+    const labels = normalizeLabels(raw.labels);
+    if (window === null || labels === null)
+        return null;
+    if (raw.resetAt !== null && !isIsoInstant(raw.resetAt))
+        return null;
+    if (typeof raw.source !== "string" || !sources.has(raw.source)) {
+        return null;
+    }
+    if (typeof raw.precision !== "string" ||
+        !precisions.has(raw.precision))
+        return null;
+    if (!isIsoInstant(raw.observedAt) || !isIsoInstant(raw.expiresAt))
+        return null;
+    if (Date.parse(raw.expiresAt) < Date.parse(raw.observedAt))
+        return null;
+    return {
+        provider: raw.provider,
+        meter: raw.meter,
+        value: raw.value,
+        unit: raw.unit,
+        window,
+        resetAt: raw.resetAt,
+        source: raw.source,
+        precision: raw.precision,
+        observedAt: raw.observedAt,
+        expiresAt: raw.expiresAt,
+        labels
+    };
+}
+export function normalizeMeters(rawMeters) {
+    return rawMeters.flatMap((raw) => {
+        const normalized = normalizeMeter(raw);
+        return normalized === null ? [] : [normalized];
+    });
+}
+function sortDeep(value) {
+    if (Array.isArray(value))
+        return value.map(sortDeep);
+    if (!isRecord(value))
+        return value;
+    return Object.fromEntries(Object.keys(value).sort().map((key) => [key, sortDeep(value[key])]));
+}
+export function canonicalJson(value) {
+    return JSON.stringify(sortDeep(value));
+}
+//# sourceMappingURL=normalizer.js.map

package/dist/normalizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizer.js","sourceRoot":"","sources":["../src/normalizer.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EAQf,MAAM,YAAY,CAAC;AAEpB,MAAM,KAAK,GAAG,IAAI,GAAG,CAAe,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC;AAClF,MAAM,OAAO,GAAG,IAAI,GAAG,CAAiB;IACtC,gBAAgB;IAChB,gBAAgB;IAChB,kBAAkB;IAClB,oBAAoB;IACpB,cAAc;CACf,CAAC,CAAC;AACH,MAAM,UAAU,GAAG,IAAI,GAAG,CAAoB,CAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC;AAChF,MAAM,aAAa,GAAG,IAAI,GAAG,CAAS,cAAc,CAAC,CAAC;AACtD,MAAM,SAAS,GAAG,yBAAyB,CAAC;AAE5C,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACjC,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC;AAC7E,CAAC;AAED,SAAS,eAAe,CAAC,KAAc;IACrC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAClC,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;IAC3B,IACE,IAAI,KAAK,SAAS;QAClB,IAAI,KAAK,OAAO;QAChB,IAAI,KAAK,UAAU;QACnB,IAAI,KAAK,SAAS;QAClB,OAAO,IAAI,CAAC;IACd,MAAM,QAAQ,GAAG,KAAK,CAAC,iBAAiB,CAAC,CAAC;IAC1C,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC5C,IACE,OAAO,QAAQ,KAAK,QAAQ;QAC5B,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC;QAC3B,QAAQ,IAAI,CAAC;QACb,QAAQ,GAAG,UAAU;QACrB,OAAO,IAAI,CAAC;IACd,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,QAAQ,EAAE,CAAC;AAC7C,CAAC;AAED,SAAS,eAAe,CAAC,KAAc;IACrC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,cAAc,CAAC,KAAK,YAAY;QAAE,OAAO,IAAI,CAAC;IAC5E,MAAM,gBAAgB,GAAG,KAAK,CAAC,kBAAkB,CAAC,CAAC;IACnD,MAAM,mBAAmB,GAAG,KAAK,CAAC,qBAAqB,CAAC,CAAC;IACzD,MAAM,cAAc,GAAG,KAAK,CAAC,gBAAgB,CAAC,CAAC;IAC/C,IACE,gBAAgB,KAAK,qBAAqB;QAC1C,gBAAgB,KAAK,UAAU;QAC/B,gBAAgB,KAAK,iBAAiB;QACtC,gBAAgB,KAAK,cAAc;QACnC,OAAO,IAAI,CAAC;IACd,IACE,mBAAmB,KAAK,2BAA2B;QACnD,mBAAmB,KAAK,gBAAgB;QACxC,mBAAmB,KAAK,mBAAmB;QAC3C,mBAAmB,KAAK,sBAAsB;QAC9C,mBAAmB,KAAK,QAAQ;QAChC,OAAO,IAAI,CAAC;IACd,IAAI,cAAc,KAAK,KAAK,IAAI,cAAc,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IACvE,OAAO;QACL,gBAAgB;QAChB,mBAAmB;QACnB,cAAc;QACd,YAAY,EAAE,YAAY;KAC3B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,GAAa;IAC1C,IAAI,OAAO,GAAG,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IACtF,IAAI,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7E,IAAI,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;QAClF,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAoB,CAAC;QAAE,OAAO,IAAI,CAAC;IACtF,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,GAAG,CAAC,KAAK,GAAG,GAAG;QAAE,OAAO,IAAI,CAAC;IAC3D,IAAI,GAAG,CAAC,KAAK,GAAG,iBAAiB;QAAE,OAAO,IAAI,CAAC;IAC/C,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3C,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACpD,IAAI,GAAG,CAAC,OAAO,KAAK,IAAI,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IACpE,IAAI,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAwB,CAAC,EAAE,CAAC;QACjF,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IACE,OAAO,GAAG,CAAC,SAAS,KAAK,QAAQ;QACjC,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,SAA8B,CAAC;QACnD,OAAO,IAAI,CAAC;IACd,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/E,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAC;IACxE,OAAO;QACL,QAAQ,EAAE,GAAG,CAAC,QAAgC;QAC9C,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,IAAI,EAAE,GAAG,CAAC,IAAoB;QAC9B,MAAM;QACN,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,MAAM,EAAE,GAAG,CAAC,MAAwB;QACpC,SAAS,EAAE,GAAG,CAAC,SAA8B;QAC7C,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,MAAM;KACP,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,SAA8B;IAC5D,OAAO,SAAS,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;QAC/B,MAAM,UAAU,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;QACvC,OAAO,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACrD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACnC,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CACpE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;AACzC,CAAC"}

package/dist/policy.d.ts

@@ -0,0 +1,3 @@
+import { type Advice, type ProviderCode, type Snapshot } from "./types.js";
+export declare function buildAdvice(snapshots: readonly Snapshot[], now: string, expectedProviders?: readonly ProviderCode[]): Advice;
+//# sourceMappingURL=policy.d.ts.map

package/dist/policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../src/policy.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,MAAM,EAGX,KAAK,YAAY,EACjB,KAAK,QAAQ,EACd,MAAM,YAAY,CAAC;AAsCpB,wBAAgB,WAAW,CACzB,SAAS,EAAE,SAAS,QAAQ,EAAE,EAC9B,GAAG,EAAE,MAAM,EACX,iBAAiB,GAAE,SAAS,YAAY,EAAmB,GAC1D,MAAM,CAqDR"}

package/dist/policy.js

@@ -0,0 +1,83 @@
+import { freshness } from "./freshness.js";
+import { PROVIDER_CODES } from "./types.js";
+function reasonFor(percent) {
+    if (percent >= 100)
+        return "AT_CAP";
+    if (percent >= 80)
+        return "NEAR_CAP";
+    return "HEALTHY";
+}
+const priority = {
+    UNKNOWN: 0,
+    HEALTHY: 1,
+    NEAR_CAP: 2,
+    AT_CAP: 3
+};
+function recommendationFor(known) {
+    const fresh = known.filter((provider) => provider.state === "fresh");
+    if (fresh.length === 0) {
+        return { code: "NONE", provider: null, reason: "NO_FRESH_DATA" };
+    }
+    const usable = fresh.filter((provider) => provider.usagePercent < 80);
+    if (usable.length === 0) {
+        return { code: "NONE", provider: null, reason: "NO_HEALTHY_PROVIDER" };
+    }
+    let best = usable[0];
+    for (const candidate of usable.slice(1)) {
+        if (candidate.usagePercent < best.usagePercent)
+            best = candidate;
+    }
+    const tied = usable.filter((candidate) => candidate.usagePercent === best.usagePercent).length > 1;
+    return {
+        code: "PREFER",
+        provider: best.provider,
+        reason: tied ? "ORDERED_TIE_BREAK" : "LOWEST_USAGE"
+    };
+}
+export function buildAdvice(snapshots, now, expectedProviders = PROVIDER_CODES) {
+    const known = [];
+    for (const provider of expectedProviders) {
+        const candidates = snapshots
+            .filter((snapshot) => snapshot.provider === provider && snapshot.unit === "PERCENT")
+            .map((snapshot) => ({
+            snapshot,
+            state: freshness(snapshot.observedAt, snapshot.expiresAt, now)
+        }))
+            .filter((entry) => entry.state !== "unknown")
+            .sort((left, right) => right.snapshot.value - left.snapshot.value);
+        const worst = candidates[0];
+        if (worst !== undefined) {
+            known.push({
+                provider,
+                state: worst.state,
+                usagePercent: worst.snapshot.value,
+                resetAt: worst.snapshot.resetAt
+            });
+        }
+    }
+    if (known.length === 0) {
+        return {
+            inject: false,
+            reason: "UNKNOWN",
+            recommendation: {
+                code: "NONE",
+                provider: null,
+                reason: "NO_KNOWN_PROVIDER"
+            },
+            providers: [],
+            unknownProviders: [...expectedProviders]
+        };
+    }
+    const unknownProviders = expectedProviders.filter((provider) => !known.some((entry) => entry.provider === provider));
+    const reason = known
+        .map((entry) => reasonFor(entry.usagePercent))
+        .reduce((worst, current) => priority[current] > priority[worst] ? current : worst, "HEALTHY");
+    return {
+        inject: true,
+        reason,
+        recommendation: recommendationFor(known),
+        providers: known,
+        unknownProviders
+    };
+}
+//# sourceMappingURL=policy.js.map

package/dist/policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.js","sourceRoot":"","sources":["../src/policy.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,89 @@
+export declare const PROVIDER_CODES: readonly ["CLAUDE", "OPENROUTER", "CODEX", "ANTIGRAVITY", "OPENCODE", "MANUAL"];
+export type ProviderCode = (typeof PROVIDER_CODES)[number];
+export type SnapshotState = "fresh" | "stale" | "unknown";
+export type SnapshotUnit = "PERCENT" | "CREDITS" | "TOKENS" | "REQUESTS";
+export type SnapshotPrecision = "exact" | "estimated" | "manual";
+export type SnapshotSource = "native_payload" | "documented_api" | "internal_payload" | "authenticated_page" | "manual_entry";
+export interface SnapshotWindow {
+    kind: "rolling" | "fixed" | "lifetime" | "unknown";
+    durationSeconds?: number;
+}
+export interface ConnectorLabels {
+    credentialOrigin: "official-local-tool" | "user-key" | "browser-session" | "user-entered";
+    dataInterfaceStatus: "native-statusline-payload" | "documented-api" | "internal-endpoint" | "authenticated-scrape" | "manual";
+    automationRisk: "low" | "high";
+    verification: "UNVERIFIED";
+}
+export interface Snapshot {
+    provider: ProviderCode;
+    meter: string;
+    value: number;
+    unit: SnapshotUnit;
+    window: SnapshotWindow;
+    resetAt: string | null;
+    source: SnapshotSource;
+    precision: SnapshotPrecision;
+    observedAt: string;
+    expiresAt: string;
+    labels: ConnectorLabels;
+}
+export interface RawMeter {
+    provider: unknown;
+    meter: unknown;
+    value: unknown;
+    unit: unknown;
+    window: unknown;
+    resetAt: unknown;
+    source: unknown;
+    precision: unknown;
+    observedAt: unknown;
+    expiresAt: unknown;
+    labels: unknown;
+}
+export interface ConnectorReadContext {
+    payload?: unknown;
+    now: string;
+    environment: Readonly<Record<string, string | undefined>>;
+}
+export type ConnectorResult = {
+    ok: true;
+    meters: readonly RawMeter[];
+} | {
+    ok: false;
+    reason: "unknown" | "unavailable" | "not_configured";
+};
+export interface ConnectorContract {
+    readonly id: Lowercase<ProviderCode>;
+    readonly displayName: string;
+    readonly labels: ConnectorLabels;
+    detect(environment: Readonly<Record<string, string | undefined>>): boolean;
+    read(context: ConnectorReadContext): Promise<ConnectorResult>;
+}
+export type AdviceReason = "HEALTHY" | "NEAR_CAP" | "AT_CAP" | "UNKNOWN";
+export type AdviceRecommendation = {
+    code: "PREFER";
+    provider: ProviderCode;
+    reason: "LOWEST_USAGE" | "ORDERED_TIE_BREAK";
+} | {
+    code: "NONE";
+    provider: null;
+    reason: "NO_KNOWN_PROVIDER" | "NO_FRESH_DATA" | "NO_HEALTHY_PROVIDER";
+};
+export interface AdviceProvider {
+    provider: ProviderCode;
+    state: "fresh" | "stale";
+    usagePercent: number;
+    resetAt: string | null;
+}
+export interface Advice {
+    inject: boolean;
+    reason: AdviceReason;
+    recommendation: AdviceRecommendation;
+    providers: readonly AdviceProvider[];
+    unknownProviders: readonly ProviderCode[];
+}
+export interface Forecast {
+    burnRatePerHour: number;
+    hoursToExhaustion: number | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,9 @@
+export const PROVIDER_CODES = [
+    "CLAUDE",
+    "OPENROUTER",
+    "CODEX",
+    "ANTIGRAVITY",
+    "OPENCODE",
+    "MANUAL"
+];
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,QAAQ;IACR,YAAY;IACZ,OAAO;IACP,aAAa;IACb,UAAU;IACV,QAAQ;CACA,CAAC"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@openlimiter/core",
+  "version": "0.1.0",
+  "description": "Shared types, quota models, cache handling, and forecasts for OpenLimiter.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "NOTICE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lucaswebsystems/openlimiter.git",
+    "directory": "packages/core"
+  },
+  "homepage": "https://openlimiter.com",
+  "bugs": {
+    "url": "https://github.com/lucaswebsystems/openlimiter/issues"
+  },
+  "license": "Apache-2.0",
+  "author": "Lucas Costa (https://lucaswebsystems.com)",
+  "keywords": [
+    "ai",
+    "quota",
+    "usage",
+    "meter",
+    "agents",
+    "claude",
+    "codex"
+  ],
+  "engines": {
+    "node": ">=24"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
+}