@nervekit/orchestrator 0.1.0

package/dist/usage/anthropic-client.js

@@ -0,0 +1,207 @@
+import { mkdir, readFile, stat, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+const API_HOST = "api.anthropic.com";
+const API_PATH = "/api/oauth/usage";
+const API_URL = `https://${API_HOST}${API_PATH}`;
+const API_TIMEOUT_MS = 5000;
+const CACHE_MAX_AGE_MS = 30_000;
+const LOCK_MAX_AGE_MS = 10_000;
+const DEFAULT_RATE_LIMIT_BACKOFF_MS = 30_000;
+let cache = null;
+function cacheFile(cacheDir) {
+    return join(cacheDir, "anthropic-usage.json");
+}
+async function readCacheFile(cacheDir) {
+    const path = cacheFile(cacheDir);
+    try {
+        const raw = await readFile(path, "utf8");
+        return {
+            data: JSON.parse(raw),
+            time: (await stat(path)).mtimeMs,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+async function writeCacheFile(cacheDir, data) {
+    try {
+        await mkdir(cacheDir, { recursive: true });
+        await writeFile(cacheFile(cacheDir), JSON.stringify(data), "utf8");
+    }
+    catch {
+        // best-effort cache
+    }
+}
+function lockFile(cacheDir) {
+    return join(cacheDir, "anthropic-usage.lock");
+}
+async function readLock(cacheDir, nowMs) {
+    const path = lockFile(cacheDir);
+    try {
+        const parsed = JSON.parse(await readFile(path, "utf8"));
+        const blockedUntil = Number(parsed.blockedUntil);
+        return Number.isFinite(blockedUntil) && blockedUntil > nowMs
+            ? blockedUntil
+            : null;
+    }
+    catch {
+        try {
+            const blockedUntil = (await stat(path)).mtimeMs + LOCK_MAX_AGE_MS;
+            return blockedUntil > nowMs ? blockedUntil : null;
+        }
+        catch {
+            return null;
+        }
+    }
+}
+async function writeLock(cacheDir, blockedUntil) {
+    try {
+        await mkdir(cacheDir, { recursive: true });
+        await writeFile(lockFile(cacheDir), JSON.stringify({ blockedUntil }), "utf8");
+    }
+    catch {
+        // best-effort cross-process backoff
+    }
+}
+function parseRetryAfterMs(header, nowMs) {
+    const trimmed = header?.trim();
+    if (!trimmed)
+        return null;
+    if (/^\d+$/.test(trimmed)) {
+        const s = Number.parseInt(trimmed, 10);
+        return s > 0 ? s * 1000 : null;
+    }
+    const ms = Date.parse(trimmed);
+    if (Number.isNaN(ms))
+        return null;
+    return ms > nowMs ? ms - nowMs : null;
+}
+function toWindow(raw) {
+    if (!raw)
+        return null;
+    const usedPercent = raw.utilization != null ? Number(raw.utilization) : null;
+    const resetsAt = typeof raw.resets_at === "string" ? raw.resets_at : null;
+    if (usedPercent == null && resetsAt == null)
+        return null;
+    return {
+        usedPercent: usedPercent != null && Number.isFinite(usedPercent) ? usedPercent : null,
+        resetsAt,
+        resetAfterSeconds: null,
+        windowMinutes: null,
+    };
+}
+export function parseAnthropicUsageResponse(raw) {
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+    if (typeof parsed !== "object" || parsed === null)
+        return null;
+    const obj = parsed;
+    const session = toWindow(obj.five_hour);
+    const weekly = toWindow(obj.seven_day);
+    if (!session && !weekly)
+        return null;
+    return {
+        provider: "anthropic",
+        session,
+        weekly,
+        planType: null,
+        updatedAt: new Date().toISOString(),
+    };
+}
+async function fetchApi(token) {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), API_TIMEOUT_MS);
+    try {
+        const res = await fetch(API_URL, {
+            method: "GET",
+            headers: {
+                Authorization: `Bearer ${token}`,
+                "anthropic-beta": "oauth-2025-04-20",
+            },
+            signal: controller.signal,
+        });
+        if (res.ok)
+            return { kind: "success", body: await res.text() };
+        if (res.status === 429) {
+            return {
+                kind: "rate-limited",
+                retryAfterMs: parseRetryAfterMs(res.headers.get("retry-after"), Date.now()) ??
+                    DEFAULT_RATE_LIMIT_BACKOFF_MS,
+            };
+        }
+        return { kind: "error" };
+    }
+    catch {
+        return { kind: "error" };
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+/**
+ * Fetch Anthropic subscription usage (5h session + 7d weekly) using an OAuth
+ * bearer token. Memoized for {@link CACHE_MAX_AGE_MS} with rate-limit backoff;
+ * the last good snapshot is served on transient failures.
+ */
+export async function fetchAnthropicUsage(token, cacheDir) {
+    const now = Date.now();
+    if (cache &&
+        now - cache.time < CACHE_MAX_AGE_MS &&
+        cache.blockedUntil <= now) {
+        return cache.data;
+    }
+    const fileCache = await readCacheFile(cacheDir);
+    if (fileCache?.data && now - fileCache.time < CACHE_MAX_AGE_MS) {
+        cache = { data: fileCache.data, time: fileCache.time, blockedUntil: 0 };
+        return fileCache.data;
+    }
+    const lastKnown = cache?.data ?? fileCache?.data ?? null;
+    if (cache && cache.blockedUntil > now) {
+        return lastKnown;
+    }
+    const lockedUntil = await readLock(cacheDir, now);
+    if (lockedUntil) {
+        cache = { data: lastKnown, time: now, blockedUntil: lockedUntil };
+        return lastKnown;
+    }
+    await writeLock(cacheDir, now + LOCK_MAX_AGE_MS);
+    const resp = await fetchApi(token);
+    if (resp.kind === "rate-limited") {
+        await writeLock(cacheDir, now + resp.retryAfterMs);
+        cache = {
+            data: lastKnown,
+            time: now,
+            blockedUntil: now + resp.retryAfterMs,
+        };
+        return lastKnown;
+    }
+    if (resp.kind === "error") {
+        await writeLock(cacheDir, now + DEFAULT_RATE_LIMIT_BACKOFF_MS);
+        cache = {
+            data: lastKnown,
+            time: now,
+            blockedUntil: now + DEFAULT_RATE_LIMIT_BACKOFF_MS,
+        };
+        return lastKnown;
+    }
+    const data = parseAnthropicUsageResponse(resp.body);
+    if (!data) {
+        await writeLock(cacheDir, now + DEFAULT_RATE_LIMIT_BACKOFF_MS);
+        cache = {
+            data: lastKnown,
+            time: now,
+            blockedUntil: now + DEFAULT_RATE_LIMIT_BACKOFF_MS,
+        };
+        return lastKnown;
+    }
+    cache = { data, time: now, blockedUntil: 0 };
+    await writeCacheFile(cacheDir, data);
+    return data;
+}
+//# sourceMappingURL=anthropic-client.js.map

package/dist/usage/anthropic-client.js.map

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

package/dist/usage/codex-client.d.ts

@@ -0,0 +1,18 @@
+import type { SubscriptionUsage } from "@nerve/shared";
+type HeaderLike = Record<string, string | number | boolean | null | undefined>;
+/** Parse a Codex usage JSON payload into a normalized snapshot. */
+export declare function parseCodexUsageResponse(payload: unknown, nowMs?: number): SubscriptionUsage | null;
+/** Parse Codex rate-limit usage from provider response headers. */
+export declare function parseCodexUsageHeaders(headers: HeaderLike, nowMs?: number): SubscriptionUsage | null;
+/** Merge a newer snapshot over a base, preferring defined fields. */
+export declare function mergeCodexUsage(base: SubscriptionUsage | null, update: SubscriptionUsage): SubscriptionUsage;
+/**
+ * Fetch Codex subscription usage from the backend endpoint using an OAuth
+ * bearer token. Memoized for {@link CACHE_MAX_AGE_MS} with rate-limit backoff;
+ * live updates also arrive via {@link parseCodexUsageHeaders}.
+ */
+export declare function fetchCodexUsage(token: string, cacheDir: string): Promise<SubscriptionUsage | null>;
+/** Persist a header-derived snapshot into the cache. */
+export declare function writeCodexUsageCache(cacheDir: string, data: SubscriptionUsage): Promise<void>;
+export {};
+//# sourceMappingURL=codex-client.d.ts.map

package/dist/usage/codex-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-client.d.ts","sourceRoot":"","sources":["../../src/usage/codex-client.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAsB,MAAM,eAAe,CAAC;AAe3E,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;AAuI/E,mEAAmE;AACnE,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,OAAO,EAChB,KAAK,SAAa,GACjB,iBAAiB,GAAG,IAAI,CAkC1B;AAwCD,mEAAmE;AACnE,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,UAAU,EACnB,KAAK,SAAa,GACjB,iBAAiB,GAAG,IAAI,CAW1B;AAED,qEAAqE;AACrE,wBAAgB,eAAe,CAC7B,IAAI,EAAE,iBAAiB,GAAG,IAAI,EAC9B,MAAM,EAAE,iBAAiB,GACxB,iBAAiB,CASnB;AAwFD;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAiEnC;AAED,wDAAwD;AACxD,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,IAAI,CAAC,CAGf"}

package/dist/usage/codex-client.js

@@ -0,0 +1,316 @@
+import { mkdir, readFile, stat, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+const API_URL = "https://chatgpt.com/backend-api/wham/usage";
+const API_TIMEOUT_MS = 5000;
+const CACHE_MAX_AGE_MS = 30_000;
+const LOCK_MAX_AGE_MS = 10_000;
+const DEFAULT_RATE_LIMIT_BACKOFF_MS = 30_000;
+const ACCOUNT_ID_CLAIM = "https://api.openai.com/auth.chatgpt_account_id";
+let cache = null;
+function cacheFile(cacheDir) {
+    return join(cacheDir, "codex-usage.json");
+}
+async function readCacheFile(cacheDir) {
+    const path = cacheFile(cacheDir);
+    try {
+        return {
+            data: JSON.parse(await readFile(path, "utf8")),
+            time: (await stat(path)).mtimeMs,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+async function writeCacheFile(cacheDir, data) {
+    try {
+        await mkdir(cacheDir, { recursive: true });
+        await writeFile(cacheFile(cacheDir), JSON.stringify(data), "utf8");
+    }
+    catch {
+        // best-effort cache
+    }
+}
+function lockFile(cacheDir) {
+    return join(cacheDir, "codex-usage.lock");
+}
+async function readLock(cacheDir, nowMs) {
+    const path = lockFile(cacheDir);
+    try {
+        const parsed = JSON.parse(await readFile(path, "utf8"));
+        const blockedUntil = Number(parsed.blockedUntil);
+        return Number.isFinite(blockedUntil) && blockedUntil > nowMs
+            ? blockedUntil
+            : null;
+    }
+    catch {
+        try {
+            const blockedUntil = (await stat(path)).mtimeMs + LOCK_MAX_AGE_MS;
+            return blockedUntil > nowMs ? blockedUntil : null;
+        }
+        catch {
+            return null;
+        }
+    }
+}
+async function writeLock(cacheDir, blockedUntil) {
+    try {
+        await mkdir(cacheDir, { recursive: true });
+        await writeFile(lockFile(cacheDir), JSON.stringify({ blockedUntil }), "utf8");
+    }
+    catch {
+        // best-effort cross-process backoff
+    }
+}
+function numberValue(value) {
+    if (typeof value === "number" && Number.isFinite(value))
+        return value;
+    if (typeof value !== "string" || value.trim() === "")
+        return null;
+    const parsed = Number(value);
+    return Number.isFinite(parsed) ? parsed : null;
+}
+function stringValue(value) {
+    if (typeof value === "string" && value !== "")
+        return value;
+    if (typeof value === "number" && Number.isFinite(value))
+        return String(value);
+    return null;
+}
+function normalizeResetAt(value) {
+    if (value == null)
+        return null;
+    return value > 10_000_000_000 ? Math.round(value / 1000) : value;
+}
+function resetAfterFromResetAt(resetAt, nowMs) {
+    const normalized = normalizeResetAt(resetAt);
+    if (normalized == null)
+        return null;
+    return Math.max(0, Math.round(normalized - nowMs / 1000));
+}
+function parseApiWindow(window, nowMs) {
+    if (!window)
+        return null;
+    const usedPercent = numberValue(window.used_percent ?? window.usedPercent);
+    const resetAfterSeconds = numberValue(window.reset_after_seconds ?? window.resetAfterSeconds) ??
+        resetAfterFromResetAt(numberValue(window.reset_at ?? window.resetAt), nowMs);
+    const limitWindowSeconds = numberValue(window.limit_window_seconds ?? window.windowSeconds);
+    const windowMinutes = numberValue(window.window_minutes ?? window.windowMinutes) ??
+        (limitWindowSeconds != null ? limitWindowSeconds / 60 : null);
+    if (usedPercent == null &&
+        resetAfterSeconds == null &&
+        windowMinutes == null) {
+        return null;
+    }
+    return { usedPercent, resetsAt: null, resetAfterSeconds, windowMinutes };
+}
+/** Parse a Codex usage JSON payload into a normalized snapshot. */
+export function parseCodexUsageResponse(payload, nowMs = Date.now()) {
+    if (typeof payload !== "object" ||
+        payload === null ||
+        Array.isArray(payload)) {
+        return null;
+    }
+    const api = payload;
+    const session = parseApiWindow(api.rate_limit?.primary_window ?? api.rate_limit?.primaryWindow, nowMs);
+    const weekly = parseApiWindow(api.rate_limit?.secondary_window ?? api.rate_limit?.secondaryWindow, nowMs);
+    if (!session && !weekly)
+        return null;
+    return {
+        provider: "openai-codex",
+        session,
+        weekly,
+        planType: stringValue(api.plan_type ?? api.planType),
+        updatedAt: new Date().toISOString(),
+    };
+}
+function headerValue(headers, name) {
+    const wanted = `x-codex-${name}`.toLowerCase();
+    for (const [key, value] of Object.entries(headers)) {
+        if (key.toLowerCase() === wanted && value != null)
+            return String(value);
+    }
+    return undefined;
+}
+function headerNumber(headers, name) {
+    return numberValue(headerValue(headers, name));
+}
+function headerResetAfter(headers, prefix, nowMs) {
+    return (headerNumber(headers, `${prefix}-reset-after-seconds`) ??
+        resetAfterFromResetAt(headerNumber(headers, `${prefix}-reset-at`), nowMs));
+}
+function headerWindow(headers, prefix, nowMs) {
+    const usedPercent = headerNumber(headers, `${prefix}-used-percent`);
+    if (usedPercent == null)
+        return null;
+    return {
+        usedPercent,
+        resetsAt: null,
+        resetAfterSeconds: headerResetAfter(headers, prefix, nowMs),
+        windowMinutes: headerNumber(headers, `${prefix}-window-minutes`),
+    };
+}
+/** Parse Codex rate-limit usage from provider response headers. */
+export function parseCodexUsageHeaders(headers, nowMs = Date.now()) {
+    const session = headerWindow(headers, "primary", nowMs);
+    const weekly = headerWindow(headers, "secondary", nowMs);
+    if (!session && !weekly)
+        return null;
+    return {
+        provider: "openai-codex",
+        session,
+        weekly,
+        planType: headerValue(headers, "plan-type") ?? null,
+        updatedAt: new Date().toISOString(),
+    };
+}
+/** Merge a newer snapshot over a base, preferring defined fields. */
+export function mergeCodexUsage(base, update) {
+    if (!base)
+        return update;
+    return {
+        provider: "openai-codex",
+        session: update.session ?? base.session,
+        weekly: update.weekly ?? base.weekly,
+        planType: update.planType ?? base.planType,
+        updatedAt: update.updatedAt,
+    };
+}
+function decodeBase64UrlJson(segment) {
+    try {
+        const normalized = segment.replace(/-/g, "+").replace(/_/g, "/");
+        const padded = normalized.padEnd(normalized.length + ((4 - (normalized.length % 4)) % 4), "=");
+        const parsed = JSON.parse(Buffer.from(padded, "base64").toString("utf8"));
+        if (typeof parsed !== "object" ||
+            parsed === null ||
+            Array.isArray(parsed)) {
+            return null;
+        }
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+function extractAccountId(token) {
+    const [, payload] = token.split(".");
+    if (!payload)
+        return null;
+    const claims = decodeBase64UrlJson(payload);
+    return stringValue(claims?.[ACCOUNT_ID_CLAIM] ??
+        claims?.chatgpt_account_id ??
+        claims?.account_id);
+}
+function parseRetryAfterMs(header, nowMs) {
+    const trimmed = header?.trim();
+    if (!trimmed)
+        return null;
+    if (/^\d+$/.test(trimmed)) {
+        const s = Number.parseInt(trimmed, 10);
+        return s > 0 ? s * 1000 : null;
+    }
+    const ms = Date.parse(trimmed);
+    if (Number.isNaN(ms))
+        return null;
+    return ms > nowMs ? ms - nowMs : null;
+}
+async function fetchApi(token, accountId) {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), API_TIMEOUT_MS);
+    try {
+        const headers = {
+            Authorization: `Bearer ${token}`,
+            accept: "application/json",
+            "user-agent": "nerve/0.0.0",
+        };
+        if (accountId)
+            headers["chatgpt-account-id"] = accountId;
+        const res = await fetch(API_URL, {
+            method: "GET",
+            headers,
+            signal: controller.signal,
+        });
+        if (res.ok)
+            return { kind: "success", body: await res.json() };
+        if (res.status === 429) {
+            return {
+                kind: "rate-limited",
+                retryAfterMs: parseRetryAfterMs(res.headers.get("retry-after"), Date.now()) ??
+                    DEFAULT_RATE_LIMIT_BACKOFF_MS,
+            };
+        }
+        return { kind: "error" };
+    }
+    catch {
+        return { kind: "error" };
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+/**
+ * Fetch Codex subscription usage from the backend endpoint using an OAuth
+ * bearer token. Memoized for {@link CACHE_MAX_AGE_MS} with rate-limit backoff;
+ * live updates also arrive via {@link parseCodexUsageHeaders}.
+ */
+export async function fetchCodexUsage(token, cacheDir) {
+    const now = Date.now();
+    if (cache &&
+        now - cache.time < CACHE_MAX_AGE_MS &&
+        cache.blockedUntil <= now) {
+        return cache.data;
+    }
+    const fileCache = await readCacheFile(cacheDir);
+    if (fileCache?.data && now - fileCache.time < CACHE_MAX_AGE_MS) {
+        cache = { data: fileCache.data, time: fileCache.time, blockedUntil: 0 };
+        return fileCache.data;
+    }
+    const lastKnown = cache?.data ?? fileCache?.data ?? null;
+    if (cache && cache.blockedUntil > now) {
+        return lastKnown;
+    }
+    const lockedUntil = await readLock(cacheDir, now);
+    if (lockedUntil) {
+        cache = { data: lastKnown, time: now, blockedUntil: lockedUntil };
+        return lastKnown;
+    }
+    await writeLock(cacheDir, now + LOCK_MAX_AGE_MS);
+    const resp = await fetchApi(token, extractAccountId(token));
+    if (resp.kind === "rate-limited") {
+        await writeLock(cacheDir, now + resp.retryAfterMs);
+        cache = {
+            data: lastKnown,
+            time: now,
+            blockedUntil: now + resp.retryAfterMs,
+        };
+        return lastKnown;
+    }
+    if (resp.kind === "error") {
+        await writeLock(cacheDir, now + DEFAULT_RATE_LIMIT_BACKOFF_MS);
+        cache = {
+            data: lastKnown,
+            time: now,
+            blockedUntil: now + DEFAULT_RATE_LIMIT_BACKOFF_MS,
+        };
+        return lastKnown;
+    }
+    const data = parseCodexUsageResponse(resp.body);
+    if (!data) {
+        await writeLock(cacheDir, now + DEFAULT_RATE_LIMIT_BACKOFF_MS);
+        cache = {
+            data: lastKnown,
+            time: now,
+            blockedUntil: now + DEFAULT_RATE_LIMIT_BACKOFF_MS,
+        };
+        return lastKnown;
+    }
+    cache = { data, time: now, blockedUntil: 0 };
+    await writeCacheFile(cacheDir, data);
+    return data;
+}
+/** Persist a header-derived snapshot into the cache. */
+export async function writeCodexUsageCache(cacheDir, data) {
+    cache = { data, time: Date.now(), blockedUntil: 0 };
+    await writeCacheFile(cacheDir, data);
+}
+//# sourceMappingURL=codex-client.js.map

package/dist/usage/codex-client.js.map

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

package/dist/usage/subscription-usage-service.d.ts

@@ -0,0 +1,42 @@
+import { type SubscriptionUsage } from "@nerve/shared";
+import type { AuthManager } from "../auth.js";
+import type { EventBus } from "../infrastructure/events/index.js";
+type FetchUsage = (token: string, cacheDir: string) => Promise<SubscriptionUsage | null>;
+export interface SubscriptionUsageServiceDeps {
+    auth: AuthManager;
+    events: EventBus;
+    /** Directory for persisted usage caches (e.g. `<dataDir>/cache/usage`). */
+    cacheDir: string;
+    fetchAnthropicUsage?: FetchUsage;
+    fetchCodexUsage?: FetchUsage;
+    now?: () => number;
+}
+/**
+ * Manages provider subscription usage (Anthropic 5h/7d, Codex
+ * primary/secondary) for globally supported OAuth providers.
+ *
+ * Refreshing is request-driven: callers ask for fresh snapshots and the service
+ * debounces upstream provider calls to at most one attempt per provider every
+ * {@link MIN_REFRESH_INTERVAL_MS}. Codex also receives live header updates via
+ * {@link applyCodexHeaders}.
+ */
+export declare class SubscriptionUsageService {
+    #private;
+    constructor(deps: SubscriptionUsageServiceDeps);
+    start(): void;
+    stop(): void;
+    /** Current snapshots, optionally refreshing all globally supported providers. */
+    getSnapshots(options?: {
+        refresh?: boolean;
+    }): Promise<SubscriptionUsage[]>;
+    /** Mark a model provider as used and request a debounced refresh. */
+    touchProvider(provider: string): void;
+    /** Apply a Codex usage snapshot derived from provider response headers. */
+    applyCodexHeaders(headers: Record<string, string>): void;
+    private configuredSnapshots;
+    private refreshProvider;
+    private performRefresh;
+    private now;
+}
+export {};
+//# sourceMappingURL=subscription-usage-service.d.ts.map

package/dist/usage/subscription-usage-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription-usage-service.d.ts","sourceRoot":"","sources":["../../src/usage/subscription-usage-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,iBAAiB,EAEvB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAelE,KAAK,UAAU,GAAG,CAChB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,KACb,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;AAEvC,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,EAAE,QAAQ,CAAC;IACjB,2EAA2E;IAC3E,QAAQ,EAAE,MAAM,CAAC;IACjB,mBAAmB,CAAC,EAAE,UAAU,CAAC;IACjC,eAAe,CAAC,EAAE,UAAU,CAAC;IAC7B,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED;;;;;;;;GAQG;AACH,qBAAa,wBAAwB;;gBAMvB,IAAI,EAAE,4BAA4B;IAI9C,KAAK,IAAI,IAAI;IAIb,IAAI,IAAI,IAAI;IAIZ,iFAAiF;IAC3E,YAAY,CAChB,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAO,GAClC,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAS/B,qEAAqE;IACrE,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKrC,2EAA2E;IAC3E,iBAAiB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;YAgB1C,mBAAmB;IAajC,OAAO,CAAC,eAAe;YAWT,cAAc;IAqC5B,OAAO,CAAC,GAAG;CAGZ"}