quota-axi 0.1.0

package/dist/src/lib/fs.js

@@ -0,0 +1,72 @@
+import { mkdirSync, readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, isAbsolute, join, relative, sep } from "node:path";
+export function collapseHome(path) {
+    const home = homedir();
+    if (path === home)
+        return "~";
+    if (!isAbsolute(path) && !startsWithHomePrefix(path, home))
+        return path;
+    const relativePath = relative(home, path);
+    if (relativePath === "")
+        return "~";
+    if (isHomeRelativePath(relativePath))
+        return `~/${normalizeRelativePath(relativePath)}`;
+    if (startsWithHomePrefix(path, home))
+        return `~/${path.slice(home.length + 1).replace(/\\/g, "/")}`;
+    return path;
+}
+function isHomeRelativePath(path) {
+    return path !== ".." && !path.startsWith(`..${sep}`) && !isAbsolute(path);
+}
+function normalizeRelativePath(path) {
+    return sep === "\\" ? path.replace(/\\/g, "/") : path;
+}
+function startsWithHomePrefix(path, home) {
+    const separator = path[home.length];
+    return (separator !== undefined &&
+        (separator === "/" || separator === "\\") &&
+        samePath(path.slice(0, home.length), home));
+}
+function samePath(left, right) {
+    if (process.platform === "win32")
+        return left.toLowerCase() === right.toLowerCase();
+    return left === right;
+}
+export function cacheFilePath() {
+    const base = process.env.XDG_CACHE_HOME || join(homedir(), ".cache");
+    return join(base, "quota-axi", "quotas.json");
+}
+export function ensurePrivateParent(file) {
+    mkdirSync(dirname(file), { recursive: true, mode: 0o700 });
+}
+export function readJsonFile(file) {
+    const result = readJsonFileResult(file);
+    return result.status === "success" ? result.value : undefined;
+}
+export function readJsonFileResult(file) {
+    let text;
+    try {
+        text = readFileSync(file, "utf8");
+    }
+    catch (error) {
+        if (errorCode(error) === "ENOENT")
+            return { status: "missing" };
+        return { status: "invalid", error: "file_read_error" };
+    }
+    try {
+        return { status: "success", value: JSON.parse(text) };
+    }
+    catch {
+        return { status: "invalid", error: "json_parse_error" };
+    }
+}
+function errorCode(error) {
+    return error &&
+        typeof error === "object" &&
+        "code" in error &&
+        typeof error.code === "string"
+        ? error.code
+        : undefined;
+}
+//# sourceMappingURL=fs.js.map

package/dist/src/lib/fs.js.map

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

package/dist/src/lib/process.d.ts

@@ -0,0 +1,4 @@
+import { type ChildProcess } from "node:child_process";
+export declare function execFileText(command: string, args: string[], timeoutMs: number): Promise<string>;
+export declare function commandExists(command: string): Promise<boolean>;
+export declare function terminateChild(child: ChildProcess): void;

package/dist/src/lib/process.js

@@ -0,0 +1,77 @@
+import { execFile } from "node:child_process";
+import { constants } from "node:fs";
+import { access, stat } from "node:fs/promises";
+import * as path from "node:path";
+export function execFileText(command, args, timeoutMs) {
+    return new Promise((resolve, reject) => {
+        execFile(command, args, { timeout: timeoutMs, maxBuffer: 1024 * 1024 }, (error, stdout) => {
+            if (error) {
+                reject(error);
+                return;
+            }
+            resolve(String(stdout));
+        });
+    });
+}
+export async function commandExists(command) {
+    const normalized = command.trim();
+    if (normalized.length === 0)
+        return false;
+    for (const candidate of commandPathCandidates(normalized)) {
+        if (await isExecutableFile(candidate))
+            return true;
+    }
+    return false;
+}
+function commandPathCandidates(command) {
+    if (hasPathSeparator(command))
+        return executableCandidates(command);
+    const pathValue = process.env.PATH;
+    if (!pathValue)
+        return [];
+    const pathApi = process.platform === "win32" ? path.win32 : path;
+    const delimiter = process.platform === "win32" ? path.win32.delimiter : path.delimiter;
+    return pathValue
+        .split(delimiter)
+        .map((entry) => entry.replace(/^"|"$/g, "") || ".")
+        .flatMap((entry) => executableCandidates(pathApi.join(entry, command)));
+}
+function executableCandidates(file) {
+    if (process.platform !== "win32")
+        return [file];
+    const pathApi = path.win32;
+    if (pathApi.extname(file))
+        return [file];
+    const extensions = (process.env.PATHEXT || ".COM;.EXE;.BAT;.CMD")
+        .split(";")
+        .map((extension) => extension.trim())
+        .filter(Boolean);
+    return extensions.map((extension) => `${file}${extension}`);
+}
+function hasPathSeparator(command) {
+    return command.includes("/") || command.includes("\\");
+}
+async function isExecutableFile(file) {
+    try {
+        const info = await stat(file);
+        if (!info.isFile())
+            return false;
+        await access(file, process.platform === "win32" ? constants.F_OK : constants.X_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function terminateChild(child) {
+    child.stdin?.destroy();
+    child.stdout?.destroy();
+    child.stderr?.destroy();
+    child.kill("SIGTERM");
+    if (child.exitCode !== null || child.signalCode !== null)
+        return;
+    const forceKill = setTimeout(() => child.kill("SIGKILL"), 2000);
+    forceKill.unref();
+    child.once("exit", () => clearTimeout(forceKill));
+}
+//# sourceMappingURL=process.js.map

package/dist/src/lib/process.js.map

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

package/dist/src/lib/time.d.ts

@@ -0,0 +1,5 @@
+export declare function nowIso(): string;
+export declare function clampPercent(value: number): number;
+export declare function percentRemaining(percentUsed: number | undefined): number | undefined;
+export declare function parseEpochOrIso(value: unknown): string | undefined;
+export declare function retryAfterToIso(value: string | null, now?: number): string | undefined;

package/dist/src/lib/time.js

@@ -0,0 +1,38 @@
+export function nowIso() {
+    return new Date().toISOString();
+}
+export function clampPercent(value) {
+    if (!Number.isFinite(value))
+        return 0;
+    return Math.min(100, Math.max(0, Math.round(value)));
+}
+export function percentRemaining(percentUsed) {
+    if (percentUsed === undefined)
+        return undefined;
+    return clampPercent(100 - percentUsed);
+}
+export function parseEpochOrIso(value) {
+    if (typeof value === "number" && Number.isFinite(value)) {
+        return new Date(value * 1000).toISOString();
+    }
+    if (typeof value === "string" && value.trim() !== "") {
+        const date = new Date(value);
+        if (!Number.isNaN(date.getTime())) {
+            return date.toISOString();
+        }
+        return value;
+    }
+    return undefined;
+}
+export function retryAfterToIso(value, now = Date.now()) {
+    const raw = value?.trim();
+    if (!raw)
+        return undefined;
+    const seconds = Number(raw);
+    if (Number.isFinite(seconds) && seconds >= 0) {
+        return new Date(now + seconds * 1000).toISOString();
+    }
+    const date = new Date(raw);
+    return Number.isNaN(date.getTime()) ? undefined : date.toISOString();
+}
+//# sourceMappingURL=time.js.map

package/dist/src/lib/time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.js","sourceRoot":"","sources":["../../../src/lib/time.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,MAAM;IACpB,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACtC,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,WAA+B;IAE/B,IAAI,WAAW,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAChD,OAAO,YAAY,CAAC,GAAG,GAAG,WAAW,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACxD,OAAO,IAAI,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;IAC9C,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACrD,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;YAClC,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC;QAC5B,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,KAAoB,EACpB,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE;IAEhB,MAAM,GAAG,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC;IAC1B,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAC;IAC3B,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC5B,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,IAAI,CAAC,EAAE,CAAC;QAC7C,OAAO,IAAI,IAAI,CAAC,GAAG,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;IACtD,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3B,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;AACvE,CAAC"}

package/dist/src/providers/claude.d.ts

@@ -0,0 +1,9 @@
+import type { AuthProviderReport, ProviderAdapter, ProviderOptions, ProviderQuota, QuotaWindow } from "../types.js";
+export declare const claudeAdapter: ProviderAdapter;
+export declare function fetchQuota(options: ProviderOptions): Promise<ProviderQuota>;
+export declare function inspectAuth(options: ProviderOptions): Promise<AuthProviderReport>;
+export declare function normalizeClaudeApiUsage(raw: unknown, plan?: string): {
+    plan?: string;
+    windows: QuotaWindow[];
+    refreshedAt: string;
+} | undefined;

package/dist/src/providers/claude.js

@@ -0,0 +1,425 @@
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { readCachedProvider } from "../cache.js";
+import { readJsonFileResult } from "../lib/fs.js";
+import { execFileText } from "../lib/process.js";
+import { clampPercent, nowIso, retryAfterToIso } from "../lib/time.js";
+import { failedProvider, sourceNames, staleFromCache, statusFromError, successProvider, withRemaining, } from "./common.js";
+const API_URL = "https://api.anthropic.com/api/oauth/usage";
+const OAUTH_BETA = "oauth-2025-04-20";
+const CLAUDE_CODE_USER_AGENT = "claude-code/2.1.202";
+const API_TIMEOUT_MS = 15_000;
+const KEYCHAIN_PROMPT_TIMEOUT_MS = 60_000;
+const KEYCHAIN_ITEM_NOT_FOUND_EXIT_CODE = 44;
+const CREDENTIAL_FILE = join(homedir(), ".claude", ".credentials.json");
+const KEYCHAIN_SERVICE = "Claude Code-credentials";
+export const claudeAdapter = {
+    id: "claude",
+    label: "Claude",
+    fetchQuota,
+    inspectAuth,
+};
+export async function fetchQuota(options) {
+    const attempts = [];
+    let finalError = "Claude quota unavailable";
+    let retryAfter;
+    const credentialStates = await readCredentialStates(options);
+    const credentials = credentialStates
+        .filter((state) => state.status === "available")
+        .map((state) => state.credentials)
+        .sort((a, b) => {
+        if (process.platform === "darwin") {
+            if (a.source === "keychain" && b.source !== "keychain")
+                return -1;
+            if (b.source === "keychain" && a.source !== "keychain")
+                return 1;
+        }
+        return (b.expiresAt ?? 0) - (a.expiresAt ?? 0);
+    });
+    for (const state of credentialStates) {
+        if (state.status === "available")
+            continue;
+        if (state.status === "skipped") {
+            attempts.push({
+                source: state.source.source,
+                status: "skipped",
+                error: state.source.error,
+            });
+            if (finalError === "Claude quota unavailable")
+                finalError = state.source.error ?? finalError;
+            continue;
+        }
+        attempts.push({
+            source: state.source.source,
+            status: "skipped",
+            error: `credentials_${state.status}`,
+        });
+        finalError = "Claude sign-in required";
+    }
+    if (credentials.length > 0) {
+        for (const credential of credentials) {
+            attempts.push({ source: "oauth", status: "failed" });
+            try {
+                const quota = await fetchOauthUsage(credential);
+                attempts[attempts.length - 1] = { source: "oauth", status: "success" };
+                return successProvider({
+                    provider: "claude",
+                    label: "Claude",
+                    source: "oauth",
+                    plan: quota.plan,
+                    account: quota.account,
+                    windows: quota.windows,
+                    refreshedAt: quota.refreshedAt,
+                    sourcesTried: sourceNames(attempts),
+                    attempts,
+                });
+            }
+            catch (error) {
+                const message = errorMessage(error);
+                attempts[attempts.length - 1] = {
+                    source: "oauth",
+                    status: "failed",
+                    error: message,
+                };
+                finalError = message;
+                if (error instanceof RateLimitError)
+                    retryAfter = error.retryAfter;
+                if (message === "Claude sign-in required") {
+                    continue;
+                }
+            }
+        }
+    }
+    const cached = readCachedProvider("claude");
+    if (cached) {
+        return staleFromCache(cached, finalError, sourceNames(attempts), attempts);
+    }
+    return failedProvider({
+        provider: "claude",
+        label: "Claude",
+        status: retryAfter ? "rate_limited" : statusFromError(finalError),
+        error: finalError,
+        retryAfter,
+        sourcesTried: sourceNames(attempts),
+        attempts,
+    });
+}
+export async function inspectAuth(options) {
+    const states = await readCredentialStates(options);
+    const sources = states.map((state) => {
+        if (state.status === "available") {
+            return {
+                source: state.credentials.source,
+                path: state.credentials.source === "oauth-file"
+                    ? CREDENTIAL_FILE
+                    : undefined,
+                status: "available",
+            };
+        }
+        return state.source;
+    });
+    return { provider: "claude", sources };
+}
+export function normalizeClaudeApiUsage(raw, plan) {
+    if (!raw || typeof raw !== "object")
+        return undefined;
+    const data = raw;
+    // The `limits` array (when present) is the vendor's own authoritative list
+    // of every window the account currently has, including ones scoped to a
+    // specific model (e.g. Fable, Opus). Prefer it over the fixed top-level
+    // fields so newly introduced scoped limits show up without code changes.
+    const scopedWindows = normalizeScopedLimits(data.limits);
+    const windows = scopedWindows.length > 0
+        ? scopedWindows
+        : [
+            normalizeWindow(data.five_hour, "five_hour", "session", "session"),
+            normalizeWindow(data.seven_day, "seven_day", "week", "weekly"),
+            normalizeWindow(data.seven_day_opus, "seven_day_opus", "opus week", "model"),
+        ].filter((window) => Boolean(window));
+    const extraUsage = normalizeExtraUsage(data.extra_usage);
+    if (extraUsage)
+        windows.push(extraUsage);
+    if (windows.length === 0)
+        return undefined;
+    return { plan, windows, refreshedAt: nowIso() };
+}
+function normalizeScopedLimits(raw) {
+    if (!Array.isArray(raw))
+        return [];
+    const windows = [];
+    for (const entry of raw) {
+        const window = normalizeScopedLimitEntry(entry);
+        if (window)
+            windows.push(window);
+    }
+    return windows;
+}
+function normalizeScopedLimitEntry(raw) {
+    if (!raw || typeof raw !== "object")
+        return undefined;
+    const entry = raw;
+    const percent = typeof entry.percent === "number" ? entry.percent : undefined;
+    if (percent === undefined)
+        return undefined;
+    const resetsAt = stringValue(entry.resets_at);
+    const scope = objectValue(entry.scope);
+    const model = scope ? objectValue(scope.model) : undefined;
+    const modelName = model ? stringValue(model.display_name) : undefined;
+    if (modelName) {
+        const modelKey = stringValue(model?.id) ?? slugify(modelName);
+        return withRemaining({
+            id: `model:${modelKey}`,
+            label: `${modelName} week`,
+            kind: "model",
+            percentUsed: clampPercent(percent),
+            resetsAt,
+        });
+    }
+    const group = stringValue(entry.group);
+    if (group === "session") {
+        return withRemaining({
+            id: "five_hour",
+            label: "session",
+            kind: "session",
+            percentUsed: clampPercent(percent),
+            resetsAt,
+        });
+    }
+    if (group === "weekly") {
+        return withRemaining({
+            id: "seven_day",
+            label: "week",
+            kind: "weekly",
+            percentUsed: clampPercent(percent),
+            resetsAt,
+        });
+    }
+    const kind = stringValue(entry.kind);
+    return withRemaining({
+        id: kind ?? "limit",
+        label: kind ?? "limit",
+        kind: "unknown",
+        percentUsed: clampPercent(percent),
+        resetsAt,
+    });
+}
+function slugify(value) {
+    return value
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "_")
+        .replace(/^_+|_+$/g, "");
+}
+async function readCredentialStates(options) {
+    const states = [];
+    const fileState = extractCredentialState(readJsonFileResult(CREDENTIAL_FILE), "oauth-file", CREDENTIAL_FILE);
+    states.push(fileState);
+    if (process.platform === "darwin") {
+        if (!options.allowKeychainPrompt) {
+            states.push({
+                status: "skipped",
+                source: {
+                    source: "keychain",
+                    status: "skipped",
+                    error: "keychain_prompt_required",
+                },
+            });
+        }
+        else {
+            states.push(await readKeychainCredentialState());
+        }
+    }
+    return states;
+}
+async function readKeychainCredentialState() {
+    let blob;
+    try {
+        blob = await execFileText("security", ["find-generic-password", "-s", KEYCHAIN_SERVICE, "-w"], KEYCHAIN_PROMPT_TIMEOUT_MS);
+    }
+    catch (error) {
+        return keychainFailureState(error);
+    }
+    try {
+        return extractCredentialState({ status: "success", value: JSON.parse(blob) }, "keychain");
+    }
+    catch {
+        return {
+            status: "invalid",
+            source: {
+                source: "keychain",
+                status: "invalid",
+                error: "json_parse_error",
+            },
+        };
+    }
+}
+function keychainFailureState(error) {
+    const failure = error;
+    if (failure.killed || failure.signal) {
+        return {
+            status: "skipped",
+            source: {
+                source: "keychain",
+                status: "skipped",
+                error: "keychain_prompt_timeout",
+            },
+        };
+    }
+    if (failure.code === KEYCHAIN_ITEM_NOT_FOUND_EXIT_CODE) {
+        return {
+            status: "missing",
+            source: { source: "keychain", status: "missing" },
+        };
+    }
+    return {
+        status: "skipped",
+        source: {
+            source: "keychain",
+            status: "skipped",
+            error: "keychain_access_denied",
+        },
+    };
+}
+function extractCredentialState(raw, source, path) {
+    if (raw.status === "missing")
+        return { status: "missing", source: { source, path, status: "missing" } };
+    if (raw.status === "invalid")
+        return {
+            status: "invalid",
+            source: { source, path, status: "invalid", error: raw.error },
+        };
+    const data = objectValue(raw.value);
+    if (!data)
+        return { status: "invalid", source: { source, path, status: "invalid" } };
+    const oauth = data.claudeAiOauth && typeof data.claudeAiOauth === "object"
+        ? data.claudeAiOauth
+        : data;
+    const accessToken = stringValue(oauth.accessToken) ?? stringValue(oauth.access_token);
+    if (!accessToken)
+        return { status: "invalid", source: { source, path, status: "invalid" } };
+    const expiresAt = expiresAtMillis(oauth.expiresAt);
+    if (expiresAt !== undefined && expiresAt <= Date.now())
+        return { status: "expired", source: { source, path, status: "expired" } };
+    const plan = stringValue(oauth.subscriptionType) ?? stringValue(data.subscriptionType);
+    return {
+        status: "available",
+        credentials: { source, accessToken, plan, expiresAt },
+    };
+}
+async function fetchOauthUsage(credentials) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), API_TIMEOUT_MS);
+    try {
+        const response = await fetch(API_URL, {
+            headers: {
+                authorization: `Bearer ${credentials.accessToken}`,
+                "anthropic-beta": OAUTH_BETA,
+                "User-Agent": CLAUDE_CODE_USER_AGENT,
+                "Content-Type": "application/json",
+                accept: "application/json",
+            },
+            signal: controller.signal,
+        });
+        rejectUnusableUsageResponse(response);
+        const quota = normalizeClaudeApiUsage(await response.json(), credentials.plan);
+        if (!quota)
+            throw new Error("Claude quota unavailable");
+        return quota;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+// Anthropic's OAuth usage endpoint follows plain HTTP semantics: 401/403 mean
+// the access token no longer authenticates, and 429 means the caller must
+// back off, honoring the standard `Retry-After` header (RFC 9110 - either a
+// delay in seconds or an HTTP-date).
+function rejectUnusableUsageResponse(response) {
+    if (response.status === 401 || response.status === 403) {
+        throw new Error("Claude sign-in required");
+    }
+    if (response.status === 429) {
+        throw new RateLimitError(retryAfterToIso(response.headers.get("retry-after")));
+    }
+    if (!response.ok) {
+        throw new Error(`Claude quota unavailable (${response.status})`);
+    }
+}
+function normalizeWindow(raw, id, label, kind) {
+    if (!raw || typeof raw !== "object")
+        return undefined;
+    const data = raw;
+    const used = typeof data.utilization === "number" ? data.utilization : undefined;
+    if (used === undefined)
+        return undefined;
+    return withRemaining({
+        id,
+        label,
+        kind,
+        percentUsed: clampPercent(used),
+        resetsAt: stringValue(data.resets_at) ?? stringValue(data.reset_at),
+    });
+}
+function normalizeExtraUsage(raw) {
+    if (!raw || typeof raw !== "object")
+        return undefined;
+    const data = raw;
+    if (data.is_enabled !== true)
+        return undefined;
+    const decimalPlaces = typeof data.decimal_places === "number" ? data.decimal_places : 2;
+    const minorUnitDivisor = 10 ** decimalPlaces;
+    const spentUsd = typeof data.used_credits === "number"
+        ? data.used_credits / minorUnitDivisor
+        : undefined;
+    const limitUsd = typeof data.monthly_limit === "number"
+        ? data.monthly_limit / minorUnitDivisor
+        : undefined;
+    const percentUsed = typeof data.utilization === "number"
+        ? clampPercent(data.utilization)
+        : spentUsd !== undefined && limitUsd && limitUsd > 0
+            ? clampPercent((spentUsd / limitUsd) * 100)
+            : undefined;
+    return withRemaining({
+        id: "extra_usage",
+        label: "extra usage",
+        kind: "credits",
+        percentUsed,
+        spentUsd,
+        limitUsd,
+    });
+}
+function objectValue(value) {
+    return value && typeof value === "object"
+        ? value
+        : undefined;
+}
+function stringValue(value) {
+    return typeof value === "string" && value.length > 0 ? value : undefined;
+}
+function expiresAtMillis(value) {
+    if (typeof value === "number" && Number.isFinite(value))
+        return value;
+    if (typeof value !== "string")
+        return undefined;
+    const trimmed = value.trim();
+    if (!trimmed)
+        return undefined;
+    const numeric = Number(trimmed);
+    if (Number.isFinite(numeric))
+        return numeric;
+    const parsed = Date.parse(trimmed);
+    return Number.isNaN(parsed) ? undefined : parsed;
+}
+function errorMessage(error) {
+    if (error instanceof Error && error.name === "AbortError")
+        return "Claude quota request timed out";
+    return error instanceof Error ? error.message : "Claude quota unavailable";
+}
+class RateLimitError extends Error {
+    retryAfter;
+    constructor(retryAfter) {
+        super("Claude quota endpoint rate limited");
+        this.retryAfter = retryAfter;
+    }
+}
+//# sourceMappingURL=claude.js.map