@absolutejs/billing 0.3.2 → 0.5.0

package/dist/index.d.ts

@@ -22,8 +22,15 @@
  * old usage snapshot through a new plan without touching any
  * vendor SDK.
  */
-/** Integer micros — 1,000,000 micros = 1 unit of the currency. */
+/**
+ * An integer amount in a plan's sub-units. 1,000,000 (micros) by default, but
+ * a plan may choose a finer denomination — see `Plan.denomination`.
+ */
 export type Micros = number;
+/** Sub-units per currency unit when a plan does not say otherwise. */
+export declare const DEFAULT_DENOMINATION = 1000000;
+/** Nanos — the denomination token-priced APIs need. */
+export declare const NANO_DENOMINATION = 1000000000;
 /**
  * Round a fractional micros value to an integer. The substrate uses
  * **truncation** (banker's-style would surprise callers expecting
@@ -83,6 +90,17 @@ export type PricedDimension = {
 export type Plan = {
     /** Human label for the invoice (`'pro'`, `'enterprise'`, etc.). */
     name: string;
+    /**
+     * Sub-units per currency unit. Defaults to 1,000,000 (micros).
+     *
+     * Micros are too coarse for token-priced APIs: at $0.16 per million
+     * embedding tokens a five-token call costs $0.0000008, which truncates to
+     * ZERO in micros — so a plan priced in micros systematically under-bills
+     * its cheapest calls. Set `1_000_000_000` to price in nanos, or any other
+     * power of ten the vendor's rate card needs. Every `*Micros` field on the
+     * plan and the invoice is denominated in these sub-units.
+     */
+    denomination?: number;
     /** Optional flat base fee charged once per invoice period. */
     basePriceMicros?: Micros;
     /**
@@ -145,6 +163,8 @@ export type Invoice = {
     tenant: string;
     plan: string;
     currency: string;
+    /** Sub-units per currency unit these amounts are in (default micros). */
+    denomination: number;
     period: InvoicePeriod;
     lineItems: LineItem[];
     /** Sum of all `lineItems[].amountMicros`. */
@@ -169,7 +189,8 @@ export declare const computeInvoice: ({ plan, tenant, period, usage, currency, }
  * — no Intl side effects. For locales / advanced formatting, pipe
  * through `Intl.NumberFormat` yourself.
  */
-export declare const formatMicros: (amount: Micros, currency: string, { minorUnits }?: {
+export declare const formatMicros: (amount: Micros, currency: string, { denomination, minorUnits, }?: {
+    denomination?: number;
     minorUnits?: number;
 }) => string;
 export { readProviderBalances, type ProviderBalance, type ProviderBalanceConfig, type ProviderBalanceKind, type ProviderBalanceStatus, type BraveUsageSnapshot, type EmbeddingUsageSnapshot, } from "./balances";

package/dist/index.js

@@ -380,6 +380,8 @@ var readProviderBalances = async (config) => {
 };
 
 // src/index.ts
+var DEFAULT_DENOMINATION = 1e6;
+var NANO_DENOMINATION = 1e9;
 var roundMicros = (value, rounding) => {
   if (rounding === "truncate")
     return Math.trunc(value);
@@ -503,23 +505,29 @@ var computeInvoice = ({
     });
     totalMicros = floor;
   }
+  const denomination = plan.denomination ?? DEFAULT_DENOMINATION;
   const invoice = {
     currency: currency ?? plan.currency ?? "usd",
+    denomination,
     lineItems,
     period,
     plan: plan.name,
     tenant,
     totalMicros,
-    totalUnits: totalMicros / 1e6
+    totalUnits: totalMicros / denomination
   };
   if (plan.metadata !== undefined)
     invoice.metadata = plan.metadata;
   return invoice;
 };
-var formatMicros = (amount, currency, { minorUnits = 2 } = {}) => {
+var formatMicros = (amount, currency, {
+  denomination = DEFAULT_DENOMINATION,
+  minorUnits = 2
+} = {}) => {
   const sign = amount < 0 ? "-" : "";
   const abs = Math.abs(amount);
-  const wholeMicrosPerMinor = 10 ** (6 - minorUnits);
+  const exponent = Math.round(Math.log10(denomination));
+  const wholeMicrosPerMinor = 10 ** (exponent - minorUnits);
   const minorTotal = Math.round(abs / wholeMicrosPerMinor);
   const divisor = 10 ** minorUnits;
   const whole = Math.trunc(minorTotal / divisor);
@@ -534,8 +542,10 @@ export {
   readProviderBalances,
   formatMicros,
   createPlan,
-  computeInvoice
+  computeInvoice,
+  NANO_DENOMINATION,
+  DEFAULT_DENOMINATION
 };
 
-//# debugId=B81091439AEF4A5064756E2164756E21
+//# debugId=D50F9899A29C0CBA64756E2164756E21
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -3,9 +3,9 @@
   "sources": ["../src/balances.ts", "../src/index.ts"],
   "sourcesContent": [
     "/**\n * Provider balances — read each upstream vendor's OWN reported balance / quota /\n * spend from their billing-or-usage API, normalized to one shape. The inverse of\n * `computeInvoice`: that prices YOUR usage into an invoice; this reads what the\n * vendors you pay say you have left (or have spent). Useful for an ops dashboard\n * that reconciles your own metering against vendor truth.\n *\n * These are free reporting endpoints — they run no model and incur no per-call\n * charge (just rate limits). Pure + dependency-free: pass credentials in, get\n * snapshots out. One provider failing never affects the others.\n *\n * Coverage by what each vendor exposes:\n *   - balance ($ left):   Twilio, Deepgram\n *   - quota (units left):  ElevenLabs (chars), Apollo (calls/day), Brave (queries)\n *   - cost ($ spent):      Anthropic, OpenAI — no balance API exists, only spend\n *\n * Brave has no API at all; the host app captures rate-limit headers off its own\n * search calls and passes the latest snapshot in (`config.brave`).\n */\n\nconst FETCH_TIMEOUT_MS = 6000;\n// The LLM providers' org cost-report endpoints are slow (OpenAI's regularly\n// takes ~6s); give them a generous timeout since the result is cached.\nconst COST_FETCH_TIMEOUT_MS = 20_000;\nconst MS_PER_SECOND = 1000;\nconst MS_PER_DAY = 86_400_000;\nconst MILLION = 1_000_000;\nconst THOUSAND = 1000;\nconst COST_WINDOW_DAYS = 30;\n\nexport type ProviderBalanceKind = \"balance\" | \"quota\" | \"cost\" | \"none\";\nexport type ProviderBalanceStatus = \"ok\" | \"unconfigured\" | \"error\";\n\nexport type ProviderBalance = {\n  /** Human summary line, e.g. \"$42.10 left\" or \"1.2M / 2M chars\". */\n  detail: string;\n  checkedAt: string;\n  kind: ProviderBalanceKind;\n  label: string;\n  /** The vendor's spend/limit when known; null when not exposed. */\n  limit: number | null;\n  /** Caveat for the tile (e.g. \"no balance API — Admin key needed\"). */\n  note: string | null;\n  provider: string;\n  /** Remaining balance/quota for kind balance|quota; null otherwise. */\n  remaining: number | null;\n  resetDate: string | null;\n  status: ProviderBalanceStatus;\n  /** Vendor plan/tier where exposed (ElevenLabs \"pro\", Twilio \"Full\"); else null. */\n  tier: string | null;\n  unit: string;\n  used: number | null;\n};\n\n/** Rate-limit snapshot the host app captures off its own Brave search responses\n *  (Brave has no usage API). The 30-day-window header is `monthly*`. */\nexport type BraveUsageSnapshot = {\n  capturedAt: string;\n  monthlyLimit: number | null;\n  monthlyRemaining: number | null;\n  resetSeconds: number | null;\n};\n\n/**\n * Per-provider credentials. Include a provider's key to get its tile; omit it to\n * skip the provider entirely. A present-but-empty credential yields an\n * \"unconfigured\" tile (so a dashboard can show every provider it cares about and\n * label the ones missing a key).\n */\n/** Embedding consumption the host measured itself, against the plan's cap.\n *  Vector vendors meter tokens per month and simply refuse once spent, so\n *  this is the number that predicts an outage. */\nexport type EmbeddingUsageSnapshot = {\n  capturedAt: string;\n  /** True when the provider is currently refusing embeddings. */\n  exhausted?: boolean;\n  monthlyTokenLimit: number;\n  resetDate?: string | null;\n  tokensUsed: number;\n};\n\nexport type ProviderBalanceConfig = {\n  anthropic?: { adminKey: string };\n  apollo?: { apiKey: string };\n  brave?: BraveUsageSnapshot | null;\n  /** Host-supplied embedding usage. Pinecone exposes no usage API to an\n   *  ordinary key, so — like Brave — the app reports what it metered. */\n  pinecone?: EmbeddingUsageSnapshot | null;\n  deepgram?: { apiKey: string };\n  elevenlabs?: { apiKey: string };\n  openai?: { adminKey: string };\n  twilio?: { accountSid: string; authToken: string };\n};\n\nconst nowIso = () => new Date().toISOString();\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === \"object\" && value !== null;\n\nconst numberOf = (value: unknown) =>\n  typeof value === \"number\" && Number.isFinite(value) ? value : null;\n\nconst usd = (amount: number) => `$${amount.toFixed(2)}`;\n\nconst compact = (value: number) => {\n  if (value >= MILLION) return `${(value / MILLION).toFixed(1)}M`;\n  if (value >= THOUSAND) return `${(value / THOUSAND).toFixed(0)}K`;\n\n  return String(value);\n};\n\nconst base = (provider: string, label: string) => {\n  const result: ProviderBalance = {\n    checkedAt: nowIso(),\n    detail: \"\",\n    kind: \"none\",\n    label,\n    limit: null,\n    note: null,\n    provider,\n    remaining: null,\n    resetDate: null,\n    status: \"error\",\n    tier: null,\n    unit: \"\",\n    used: null,\n  };\n\n  return result;\n};\n\nconst unconfigured = (provider: string, label: string, note: string) => {\n  const result: ProviderBalance = {\n    ...base(provider, label),\n    note,\n    status: \"unconfigured\",\n  };\n\n  return result;\n};\n\nconst errored = (provider: string, label: string, message: string) => {\n  const result: ProviderBalance = {\n    ...base(provider, label),\n    detail: \"Couldn't reach provider\",\n    note: message,\n  };\n\n  return result;\n};\n\nconst fetchJson = async (\n  url: string,\n  headers: Record<string, string>,\n  opts: { method?: string; timeoutMs?: number } = {},\n) => {\n  const controller = new AbortController();\n  const timer = setTimeout(\n    () => controller.abort(),\n    opts.timeoutMs ?? FETCH_TIMEOUT_MS,\n  );\n  try {\n    const response = await fetch(url, {\n      headers,\n      method: opts.method ?? \"GET\",\n      signal: controller.signal,\n    });\n    if (!response.ok) {\n      // Surface the vendor's own error text (truncated) so the tile is\n      // actionable — e.g. Deepgram's \"needs the billing:read scope\".\n      const body = await response.text().catch(() => \"\");\n      const snippet = body.replace(/\\s+/g, \" \").trim().slice(0, 160);\n      throw new Error(\n        snippet\n          ? `HTTP ${response.status}: ${snippet}`\n          : `HTTP ${response.status}`,\n      );\n    }\n    const json: unknown = await response.json();\n\n    return json;\n  } finally {\n    clearTimeout(timer);\n  }\n};\n\n// --- Twilio: real account balance + plan type -----------------------------\nconst twilioBalance = async (creds: {\n  accountSid: string;\n  authToken: string;\n}) => {\n  if (!creds.accountSid || !creds.authToken) {\n    return unconfigured(\"twilio\", \"Twilio\", \"Twilio credentials unset\");\n  }\n  try {\n    const auth = Buffer.from(`${creds.accountSid}:${creds.authToken}`).toString(\n      \"base64\",\n    );\n    const headers: Record<string, string> = { Authorization: `Basic ${auth}` };\n    const [data, account] = await Promise.all([\n      fetchJson(\n        `https://api.twilio.com/2010-04-01/Accounts/${creds.accountSid}/Balance.json`,\n        headers,\n      ),\n      fetchJson(\n        `https://api.twilio.com/2010-04-01/Accounts/${creds.accountSid}.json`,\n        headers,\n      ),\n    ]);\n    const balance = isRecord(data) ? numberOf(Number(data.balance)) : null;\n    const currency =\n      isRecord(data) && typeof data.currency === \"string\"\n        ? data.currency\n        : \"USD\";\n    const accountType =\n      isRecord(account) && typeof account.type === \"string\"\n        ? account.type\n        : null;\n    if (balance === null) throw new Error(\"no balance field\");\n    const result: ProviderBalance = {\n      ...base(\"twilio\", \"Twilio\"),\n      detail: `${currency} ${balance.toFixed(2)} left`,\n      kind: \"balance\",\n      remaining: balance,\n      status: \"ok\",\n      tier: accountType,\n      unit: currency,\n    };\n\n    return result;\n  } catch (error) {\n    return errored(\"twilio\", \"Twilio\", String(error));\n  }\n};\n\n// --- Deepgram: real $ balance summed across projects ----------------------\nconst extractProjectIds = (projects: unknown) => {\n  const list =\n    isRecord(projects) && Array.isArray(projects.projects)\n      ? projects.projects\n      : [];\n\n  return list\n    .map((proj) =>\n      isRecord(proj) && typeof proj.project_id === \"string\"\n        ? proj.project_id\n        : null,\n    )\n    .filter((id): id is string => id !== null);\n};\n\nconst sumBalances = (balances: unknown) => {\n  const rows =\n    isRecord(balances) && Array.isArray(balances.balances)\n      ? balances.balances\n      : [];\n\n  return rows.reduce<number>(\n    (total, row) => total + (isRecord(row) ? (numberOf(row.amount) ?? 0) : 0),\n    0,\n  );\n};\n\nconst fetchDeepgramTotal = async (headers: Record<string, string>) => {\n  const projects = await fetchJson(\n    \"https://api.deepgram.com/v1/projects\",\n    headers,\n  );\n  let total = 0;\n  for (const projectId of extractProjectIds(projects)) {\n    // eslint-disable-next-line no-await-in-loop -- a couple of projects at most\n    const balances = await fetchJson(\n      `https://api.deepgram.com/v1/projects/${projectId}/balances`,\n      headers,\n    );\n    total += sumBalances(balances);\n  }\n\n  return total;\n};\n\nconst deepgramBalance = async (creds: { apiKey: string }) => {\n  if (!creds.apiKey)\n    return unconfigured(\"deepgram\", \"Deepgram\", \"API key unset\");\n  try {\n    const total = await fetchDeepgramTotal({\n      Authorization: `Token ${creds.apiKey}`,\n    });\n    const result: ProviderBalance = {\n      ...base(\"deepgram\", \"Deepgram\"),\n      detail: `${usd(total)} left`,\n      kind: \"balance\",\n      remaining: total,\n      status: \"ok\",\n      unit: \"USD\",\n    };\n\n    return result;\n  } catch (error) {\n    return errored(\"deepgram\", \"Deepgram\", String(error));\n  }\n};\n\n// --- ElevenLabs: real character quota used / limit + tier -----------------\nconst elevenLabsBalance = async (creds: { apiKey: string }) => {\n  if (!creds.apiKey)\n    return unconfigured(\"elevenlabs\", \"ElevenLabs\", \"API key unset\");\n  try {\n    const data = await fetchJson(\n      \"https://api.elevenlabs.io/v1/user/subscription\",\n      {\n        \"xi-api-key\": creds.apiKey,\n      },\n    );\n    const usedChars = isRecord(data) ? numberOf(data.character_count) : null;\n    const limitChars = isRecord(data) ? numberOf(data.character_limit) : null;\n    if (usedChars === null || limitChars === null) {\n      throw new Error(\"no character fields\");\n    }\n    const resetUnix = isRecord(data)\n      ? numberOf(data.next_character_count_reset_unix)\n      : null;\n    const tier =\n      isRecord(data) && typeof data.tier === \"string\" ? data.tier : null;\n    const remaining = Math.max(0, limitChars - usedChars);\n    const result: ProviderBalance = {\n      ...base(\"elevenlabs\", \"ElevenLabs\"),\n      detail: `${compact(remaining)} / ${compact(limitChars)} chars left`,\n      kind: \"quota\",\n      limit: limitChars,\n      remaining,\n      resetDate: resetUnix\n        ? new Date(resetUnix * MS_PER_SECOND).toISOString()\n        : null,\n      status: \"ok\",\n      tier,\n      unit: \"characters\",\n      used: usedChars,\n    };\n\n    return result;\n  } catch (error) {\n    return errored(\"elevenlabs\", \"ElevenLabs\", String(error));\n  }\n};\n\n// --- Apollo: real per-endpoint API quota (master key required) ------------\nconst pickBusiestDayQuota = (data: unknown) => {\n  let consumed = 0;\n  let limit = 0;\n  if (!isRecord(data)) return { consumed, limit };\n  for (const value of Object.values(data)) {\n    const day = isRecord(value) && isRecord(value.day) ? value.day : null;\n    if (!day) continue;\n    const dayLimit = numberOf(day.limit) ?? 0;\n    if (dayLimit <= limit) continue;\n    limit = dayLimit;\n    consumed = numberOf(day.consumed) ?? 0;\n  }\n\n  return { consumed, limit };\n};\n\nconst apolloResult = (consumed: number, limit: number) => {\n  if (limit === 0) {\n    const noQuota: ProviderBalance = {\n      ...base(\"apollo\", \"Apollo\"),\n      detail: \"Reached Apollo (no day quota in response)\",\n      note: \"If usage stats 403, the key must be an Apollo master key.\",\n      status: \"ok\",\n    };\n\n    return noQuota;\n  }\n  const result: ProviderBalance = {\n    ...base(\"apollo\", \"Apollo\"),\n    detail: `${Math.max(0, limit - consumed)} / ${limit} calls left today`,\n    kind: \"quota\",\n    limit,\n    remaining: Math.max(0, limit - consumed),\n    status: \"ok\",\n    unit: \"calls\",\n    used: consumed,\n  };\n\n  return result;\n};\n\nconst apolloBalance = async (creds: { apiKey: string }) => {\n  if (!creds.apiKey) return unconfigured(\"apollo\", \"Apollo\", \"API key unset\");\n  try {\n    // POST (not GET) per Apollo's API; needs the master key.\n    const data = await fetchJson(\n      \"https://api.apollo.io/api/v1/usage_stats/api_usage_stats\",\n      { \"Content-Type\": \"application/json\", \"X-Api-Key\": creds.apiKey },\n      { method: \"POST\" },\n    );\n    const { consumed, limit } = pickBusiestDayQuota(data);\n\n    return apolloResult(consumed, limit);\n  } catch (error) {\n    return errored(\n      \"apollo\",\n      \"Apollo\",\n      `${error} — usage stats need the Apollo master key`,\n    );\n  }\n};\n\n// --- Pinecone: no usage API for an ordinary key; same host-snapshot shape --\nconst compactTokens = (tokens: number) => {\n  const MILLION = 1_000_000;\n  const THOUSAND = 1000;\n  if (tokens >= MILLION) return `${(tokens / MILLION).toFixed(1)}M`;\n\n  return `${Math.round(tokens / THOUSAND)}k`;\n};\n\nconst pineconeBalance = (snap: EmbeddingUsageSnapshot | null | undefined) => {\n  if (!snap) {\n    return unconfigured(\n      \"pinecone\",\n      \"Pinecone embeddings\",\n      \"No embedding usage reported yet — the host supplies this from its own metering.\",\n    );\n  }\n  const remaining = Math.max(0, snap.monthlyTokenLimit - snap.tokensUsed);\n  const quota: ProviderBalance = {\n    ...base(\"pinecone\", \"Pinecone embeddings\"),\n    checkedAt: snap.capturedAt,\n    detail: snap.exhausted\n      ? `${compactTokens(snap.tokensUsed)} / ${compactTokens(snap.monthlyTokenLimit)} tokens — quota spent, embeddings refused`\n      : `${compactTokens(snap.tokensUsed)} / ${compactTokens(snap.monthlyTokenLimit)} tokens this month`,\n    kind: \"quota\",\n    limit: snap.monthlyTokenLimit,\n    note: \"Counted from the host's own metering — Pinecone exposes no usage API.\",\n    remaining,\n    resetDate: snap.resetDate ?? null,\n    status: \"ok\",\n    unit: \"tokens\",\n    used: snap.tokensUsed,\n  };\n\n  return quota;\n};\n\n// --- Brave: no API; read the snapshot the host captured off its own calls --\nconst braveBalance = (snap: BraveUsageSnapshot | null | undefined) => {\n  if (!snap) {\n    return unconfigured(\n      \"brave\",\n      \"Brave Search\",\n      \"No usage captured yet — appears after the next web search.\",\n    );\n  }\n  if (snap.monthlyLimit && snap.monthlyLimit > 0) {\n    const remaining = snap.monthlyRemaining ?? 0;\n    const quota: ProviderBalance = {\n      ...base(\"brave\", \"Brave Search\"),\n      checkedAt: snap.capturedAt,\n      detail: `${remaining} / ${snap.monthlyLimit} queries left this month`,\n      kind: \"quota\",\n      limit: snap.monthlyLimit,\n      remaining,\n      status: \"ok\",\n      unit: \"queries\",\n      used: snap.monthlyLimit - remaining,\n    };\n\n    return quota;\n  }\n  const metered: ProviderBalance = {\n    ...base(\"brave\", \"Brave Search\"),\n    checkedAt: snap.capturedAt,\n    detail: \"Metered · pay-as-you-go\",\n    note: \"No prepaid cap — billed per query; the host's spend cap is the ceiling.\",\n    status: \"ok\",\n    tier: \"metered\",\n  };\n\n  return metered;\n};\n\nconst costWindowStart = () => Date.now() - COST_WINDOW_DAYS * MS_PER_DAY;\n\n// --- OpenAI: real spend (no balance API). Needs an sk-admin- Admin key. ----\nconst sumOpenAiCosts = (data: unknown) => {\n  const buckets = isRecord(data) && Array.isArray(data.data) ? data.data : [];\n\n  return buckets.reduce<number>((total, bucket) => {\n    const results =\n      isRecord(bucket) && Array.isArray(bucket.results) ? bucket.results : [];\n    const bucketSum = results.reduce<number>((sub, row) => {\n      const amount = isRecord(row) && isRecord(row.amount) ? row.amount : null;\n      const value = amount ? Number(amount.value) : NaN;\n\n      return sub + (Number.isFinite(value) ? value : 0);\n    }, 0);\n\n    return total + bucketSum;\n  }, 0);\n};\n\nconst openaiBalance = async (creds: { adminKey: string }) => {\n  if (!creds.adminKey) {\n    return unconfigured(\n      \"openai\",\n      \"OpenAI\",\n      \"No balance API. Provide an sk-admin- Admin key to show real spend.\",\n    );\n  }\n  try {\n    const startTime = Math.floor(costWindowStart() / MS_PER_SECOND);\n    const data = await fetchJson(\n      `https://api.openai.com/v1/organization/costs?start_time=${startTime}&limit=${COST_WINDOW_DAYS + 1}`,\n      { Authorization: `Bearer ${creds.adminKey}` },\n      { timeoutMs: COST_FETCH_TIMEOUT_MS },\n    );\n    const result: ProviderBalance = {\n      ...base(\"openai\", \"OpenAI\"),\n      detail: `${usd(sumOpenAiCosts(data))} spent (30d)`,\n      kind: \"cost\",\n      note: \"No balance API — real provider-reported spend, not balance.\",\n      status: \"ok\",\n    };\n\n    return result;\n  } catch (error) {\n    return errored(\"openai\", \"OpenAI\", String(error));\n  }\n};\n\n// --- Anthropic: real spend (no balance API). Needs an sk-ant-admin key. ----\nconst sumAnthropicCosts = (data: unknown) => {\n  const buckets = isRecord(data) && Array.isArray(data.data) ? data.data : [];\n\n  return buckets.reduce<number>((total, bucket) => {\n    const results =\n      isRecord(bucket) && Array.isArray(bucket.results) ? bucket.results : [];\n    const bucketSum = results.reduce<number>((sub, row) => {\n      if (!isRecord(row)) return sub;\n      const raw = row.amount ?? row.cost ?? row.value;\n      const value = Number(isRecord(raw) ? (raw.value ?? raw.amount) : raw);\n\n      return sub + (Number.isFinite(value) ? value : 0);\n    }, 0);\n\n    return total + bucketSum;\n  }, 0);\n};\n\nconst anthropicBalance = async (creds: { adminKey: string }) => {\n  if (!creds.adminKey) {\n    return unconfigured(\n      \"anthropic\",\n      \"Anthropic\",\n      \"No balance API. Provide an sk-ant-admin Admin key to show real spend.\",\n    );\n  }\n  try {\n    const startedAt = new Date(costWindowStart()).toISOString();\n    const data = await fetchJson(\n      `https://api.anthropic.com/v1/organizations/cost_report?starting_at=${startedAt}`,\n      { \"anthropic-version\": \"2023-06-01\", \"x-api-key\": creds.adminKey },\n      { timeoutMs: COST_FETCH_TIMEOUT_MS },\n    );\n    const result: ProviderBalance = {\n      ...base(\"anthropic\", \"Anthropic\"),\n      detail: `${usd(sumAnthropicCosts(data))} spent (30d)`,\n      kind: \"cost\",\n      note: \"No balance API — real provider-reported spend, not balance.\",\n      status: \"ok\",\n    };\n\n    return result;\n  } catch (error) {\n    return errored(\n      \"anthropic\",\n      \"Anthropic\",\n      `${error} — needs an sk-ant-admin Admin key (a regular API key won't work).`,\n    );\n  }\n};\n\n/**\n * Read every configured provider's real balance/quota/spend in parallel. Only\n * providers present in `config` produce a tile. Each runs independently — one\n * failing returns an \"error\" tile, never rejects the whole call. Stateless: the\n * caller owns any caching (these are free reporting calls, ~1/min is plenty).\n */\nexport const readProviderBalances = async (\n  config: ProviderBalanceConfig,\n): Promise<ProviderBalance[]> => {\n  const jobs: Array<Promise<ProviderBalance>> = [];\n  if (config.twilio) jobs.push(twilioBalance(config.twilio));\n  if (config.deepgram) jobs.push(deepgramBalance(config.deepgram));\n  if (config.elevenlabs) jobs.push(elevenLabsBalance(config.elevenlabs));\n  if (config.apollo) jobs.push(apolloBalance(config.apollo));\n  if (\"brave\" in config) jobs.push(Promise.resolve(braveBalance(config.brave)));\n  if (\"pinecone\" in config) {\n    jobs.push(Promise.resolve(pineconeBalance(config.pinecone)));\n  }\n  if (config.anthropic) jobs.push(anthropicBalance(config.anthropic));\n  if (config.openai) jobs.push(openaiBalance(config.openai));\n\n  return Promise.all(jobs);\n};\n",
-    "/**\n * @absolutejs/billing — cost-model substrate for the AbsoluteJS PaaS.\n *\n * Two pieces:\n *\n *   - `createPlan(...)` — declarative pricing config: optional flat\n *     base fee + per-dimension unit prices, with optional graduated\n *     tiers and free-tier allowances per dimension.\n *\n *   - `computeInvoice({ plan, period, tenant, usage, currency? })`\n *     — pure function that turns a `@absolutejs/metering`-shaped\n *     `Usage` snapshot (or any record of metered numbers) into an\n *     `Invoice` of line items + total. All money math is done in\n *     integer **micros** (1 micro = 1/1,000,000 of a currency unit\n *     — the same denomination Stripe uses internally) so float\n *     drift is structurally impossible.\n *\n * Invoice sinks (push to Stripe, post to QuickBooks, mail a PDF)\n * live OUTSIDE this package, in `@absolutejs/billing-adapters/*`.\n * Keeping the substrate pure means the control plane can preview\n * invoices, run dry-run \"would-charge\" projections, and replay an\n * old usage snapshot through a new plan without touching any\n * vendor SDK.\n */\n\n// =============================================================================\n// Money primitives\n// =============================================================================\n\n/** Integer micros — 1,000,000 micros = 1 unit of the currency. */\nexport type Micros = number;\n\n/**\n * Round a fractional micros value to an integer. The substrate uses\n * **truncation** (banker's-style would surprise callers expecting\n * \"$0.0009 → $0.00\" not \"$0.0009 → $0.001\"). Plans override per-plan.\n */\nexport type Rounding = \"truncate\" | \"round-half-up\";\n\nconst roundMicros = (value: number, rounding: Rounding): Micros => {\n  if (rounding === \"truncate\") return Math.trunc(value);\n  return Math.round(value);\n};\n\n// =============================================================================\n// Pricing config\n// =============================================================================\n\n/**\n * One step in a graduated-tier price table. `upTo` is the inclusive\n * upper bound (in metered units, NOT micros) for this band.\n * `perUnitMicros` is what the customer pays per single metered unit\n * within this band. The last entry must have `upTo: Infinity` to\n * cover any overflow.\n */\nexport type PricingTier = {\n  upTo: number;\n  perUnitMicros: number;\n};\n\n/**\n * Per-dimension pricing. Three shapes:\n *\n *   - Flat per-unit: `{ perUnitMicros: 200, unit: 1024 * 1024 }`\n *     charges 200 micros ($0.0002) per MB of usage.\n *\n *   - Tiered: `{ tiers: [...], unit: 1 }` charges per the first\n *     matching `PricingTier` band.\n *\n *   - Custom: `{ price: (quantity) => micros, unit: 1 }` — escape\n *     hatch for surge / caps / non-monotonic pricing. The substrate\n *     stays pure; you ship whatever function you want.\n *\n * `freeTier` is subtracted from the metered quantity BEFORE pricing\n * — the conventional \"first N units free\" rule.\n *\n * `unit` is the metered-unit denominator: 1 means \"price per single\n * metered unit\", 1024*1024 means \"price per MB when quantity is in\n * bytes.\" Default 1.\n *\n * `label` overrides the line-item display name.\n */\nexport type PricedDimension = {\n  label?: string;\n  freeTier?: number;\n  unit?: number;\n} & (\n  | { perUnitMicros: number; tiers?: never; price?: never }\n  | { tiers: PricingTier[]; perUnitMicros?: never; price?: never }\n  | {\n      price: (chargedQuantity: number) => Micros;\n      perUnitMicros?: never;\n      tiers?: never;\n    }\n);\n\nexport type Plan = {\n  /** Human label for the invoice (`'pro'`, `'enterprise'`, etc.). */\n  name: string;\n  /** Optional flat base fee charged once per invoice period. */\n  basePriceMicros?: Micros;\n  /**\n   * Dimensions priced from usage. Keys must match keys on the\n   * `usage` record passed to `computeInvoice`. Anything not listed\n   * is ignored.\n   */\n  pricedDimensions: Record<string, PricedDimension>;\n  /** Default currency for invoices generated from this plan. */\n  currency?: string;\n  /** Rounding strategy applied per line item. Default `'truncate'`. */\n  rounding?: Rounding;\n  /**\n   * Minimum charge (in micros) — if the computed total is below\n   * this floor, the invoice total is raised to the floor and a\n   * single `'minimum-charge-adjustment'` line item captures the\n   * difference. Defaults to 0 (no floor).\n   */\n  minimumChargeMicros?: Micros;\n  /** Arbitrary plan-level metadata that flows through to invoices. */\n  metadata?: Record<string, string>;\n};\n\nexport const createPlan = (plan: Plan): Plan => {\n  for (const [key, dim] of Object.entries(plan.pricedDimensions)) {\n    if (dim.tiers !== undefined) {\n      if (dim.tiers.length === 0) {\n        throw new Error(`billing: dimension '${key}' has no tiers`);\n      }\n      const last = dim.tiers[dim.tiers.length - 1];\n      if (last !== undefined && Number.isFinite(last.upTo)) {\n        throw new Error(\n          `billing: dimension '${key}' final tier must have upTo: Infinity`,\n        );\n      }\n      let prev = 0;\n      for (let i = 0; i < dim.tiers.length; i += 1) {\n        const tier = dim.tiers[i]!;\n        if (tier.upTo < prev) {\n          throw new Error(\n            `billing: dimension '${key}' tier #${i} upTo (${tier.upTo}) must be >= previous (${prev})`,\n          );\n        }\n        prev = tier.upTo;\n      }\n    }\n  }\n  return plan;\n};\n\n// =============================================================================\n// Invoice shape\n// =============================================================================\n\nexport type LineItem = {\n  /**\n   * Stable key for the line item. For priced dimensions it's the\n   * usage-record key (`'requests'`, `'cpuMs'`, etc.). For the base\n   * fee it's `'base'`. For minimum-charge top-up it's\n   * `'minimum-charge-adjustment'`.\n   */\n  key: string;\n  /** Human-readable label. */\n  label: string;\n  /** Metered units BEFORE applying free tier. 0 for the base fee. */\n  quantity: number;\n  /** Metered units AFTER applying free tier (what's actually charged). */\n  chargedQuantity: number;\n  /** Free-tier units subtracted from `quantity`. */\n  freeTier?: number;\n  /** Charge for this line in integer micros. */\n  amountMicros: Micros;\n  /**\n   * Tier-by-tier breakdown when graduated pricing was used. Each\n   * entry: `{ tierIndex, unitsInTier, perUnitMicros, amountMicros }`.\n   */\n  tierBreakdown?: Array<{\n    tierIndex: number;\n    unitsInTier: number;\n    perUnitMicros: number;\n    amountMicros: Micros;\n  }>;\n};\n\nexport type InvoicePeriod = {\n  /** Inclusive period start (`Date.now()` ms). */\n  start: number;\n  /** Exclusive period end. */\n  end: number;\n};\n\nexport type Invoice = {\n  tenant: string;\n  plan: string;\n  currency: string;\n  period: InvoicePeriod;\n  lineItems: LineItem[];\n  /** Sum of all `lineItems[].amountMicros`. */\n  totalMicros: Micros;\n  /** Convenience: `totalMicros / 1_000_000` as a number. */\n  totalUnits: number;\n  /** Plan-level metadata copied through unchanged. */\n  metadata?: Record<string, string>;\n};\n\n// =============================================================================\n// Pricing math\n// =============================================================================\n\ntype ComputeDimensionInput = {\n  quantity: number;\n  dim: PricedDimension;\n  rounding: Rounding;\n};\n\ntype ComputeDimensionResult = {\n  amountMicros: Micros;\n  chargedQuantity: number;\n  tierBreakdown?: LineItem[\"tierBreakdown\"];\n};\n\nconst computeDimension = ({\n  quantity,\n  dim,\n  rounding,\n}: ComputeDimensionInput): ComputeDimensionResult => {\n  const free = dim.freeTier ?? 0;\n  const charged = Math.max(0, quantity - free);\n  const unit = dim.unit ?? 1;\n  const chargedUnits = unit === 1 ? charged : charged / unit;\n\n  if (dim.perUnitMicros !== undefined) {\n    const amountMicros = roundMicros(\n      chargedUnits * dim.perUnitMicros,\n      rounding,\n    );\n    return { amountMicros, chargedQuantity: charged };\n  }\n\n  if (dim.price !== undefined) {\n    const amountMicros = roundMicros(dim.price(charged), rounding);\n    return { amountMicros, chargedQuantity: charged };\n  }\n\n  // Tiered pricing — walk tiers, allocate chargedUnits into bands.\n  const tierBreakdown: NonNullable<LineItem[\"tierBreakdown\"]> = [];\n  let remaining = chargedUnits;\n  let bandFloor = 0;\n  let totalMicros = 0;\n  for (let i = 0; i < dim.tiers!.length && remaining > 0; i += 1) {\n    const tier = dim.tiers![i]!;\n    const bandWidth = tier.upTo - bandFloor;\n    const unitsInTier = Math.min(remaining, bandWidth);\n    if (unitsInTier > 0) {\n      const tierMicros = roundMicros(\n        unitsInTier * tier.perUnitMicros,\n        rounding,\n      );\n      tierBreakdown.push({\n        amountMicros: tierMicros,\n        perUnitMicros: tier.perUnitMicros,\n        tierIndex: i,\n        unitsInTier,\n      });\n      totalMicros += tierMicros;\n    }\n    remaining -= unitsInTier;\n    bandFloor = tier.upTo;\n  }\n  return {\n    amountMicros: totalMicros,\n    chargedQuantity: charged,\n    tierBreakdown,\n  };\n};\n\n// =============================================================================\n// computeInvoice — pure\n// =============================================================================\n\nexport type ComputeInvoiceInput = {\n  plan: Plan;\n  tenant: string;\n  period: InvoicePeriod;\n  /** Metered numbers keyed by the same names as `plan.pricedDimensions`. */\n  usage: Record<string, number>;\n  /** Override the plan's currency (e.g. for tenant-local invoicing). */\n  currency?: string;\n};\n\nexport const computeInvoice = ({\n  plan,\n  tenant,\n  period,\n  usage,\n  currency,\n}: ComputeInvoiceInput): Invoice => {\n  const rounding = plan.rounding ?? \"truncate\";\n  const lineItems: LineItem[] = [];\n\n  if (plan.basePriceMicros !== undefined && plan.basePriceMicros > 0) {\n    lineItems.push({\n      amountMicros: plan.basePriceMicros,\n      chargedQuantity: 1,\n      key: \"base\",\n      label: `${plan.name} base fee`,\n      quantity: 1,\n    });\n  }\n\n  for (const [key, dim] of Object.entries(plan.pricedDimensions)) {\n    const quantity = usage[key] ?? 0;\n    if (!Number.isFinite(quantity) || quantity < 0) continue;\n    const result = computeDimension({ dim, quantity, rounding });\n    if (result.amountMicros === 0 && result.chargedQuantity === 0) continue;\n    const item: LineItem = {\n      amountMicros: result.amountMicros,\n      chargedQuantity: result.chargedQuantity,\n      key,\n      label: dim.label ?? key,\n      quantity,\n    };\n    if (dim.freeTier !== undefined) item.freeTier = dim.freeTier;\n    if (result.tierBreakdown !== undefined && result.tierBreakdown.length > 0) {\n      item.tierBreakdown = result.tierBreakdown;\n    }\n    lineItems.push(item);\n  }\n\n  let totalMicros = lineItems.reduce((sum, item) => sum + item.amountMicros, 0);\n\n  const floor = plan.minimumChargeMicros ?? 0;\n  if (floor > 0 && totalMicros < floor) {\n    const gap = floor - totalMicros;\n    lineItems.push({\n      amountMicros: gap,\n      chargedQuantity: 1,\n      key: \"minimum-charge-adjustment\",\n      label: \"Minimum charge adjustment\",\n      quantity: 1,\n    });\n    totalMicros = floor;\n  }\n\n  const invoice: Invoice = {\n    currency: currency ?? plan.currency ?? \"usd\",\n    lineItems,\n    period,\n    plan: plan.name,\n    tenant,\n    totalMicros,\n    totalUnits: totalMicros / 1_000_000,\n  };\n  if (plan.metadata !== undefined) invoice.metadata = plan.metadata;\n  return invoice;\n};\n\n// =============================================================================\n// Display helpers\n// =============================================================================\n\n/**\n * Format an integer micros amount as a human currency string. Pure\n * — no Intl side effects. For locales / advanced formatting, pipe\n * through `Intl.NumberFormat` yourself.\n */\nexport const formatMicros = (\n  amount: Micros,\n  currency: string,\n  { minorUnits = 2 }: { minorUnits?: number } = {},\n): string => {\n  const sign = amount < 0 ? \"-\" : \"\";\n  const abs = Math.abs(amount);\n  const wholeMicrosPerMinor = 10 ** (6 - minorUnits);\n  const minorTotal = Math.round(abs / wholeMicrosPerMinor);\n  const divisor = 10 ** minorUnits;\n  const whole = Math.trunc(minorTotal / divisor);\n  const upper = currency.toUpperCase();\n  if (minorUnits === 0) return `${sign}${whole} ${upper}`;\n  const fraction = minorTotal % divisor;\n  const fractionStr = fraction.toString().padStart(minorUnits, \"0\");\n  return `${sign}${whole}.${fractionStr} ${upper}`;\n};\n\n// Provider balances — read upstream vendors' real balance/quota/spend (the\n// inverse of computeInvoice). See ./balances.\nexport {\n  readProviderBalances,\n  type ProviderBalance,\n  type ProviderBalanceConfig,\n  type ProviderBalanceKind,\n  type ProviderBalanceStatus,\n  type BraveUsageSnapshot,\n  type EmbeddingUsageSnapshot,\n} from \"./balances\";\n"
+    "/**\n * @absolutejs/billing — cost-model substrate for the AbsoluteJS PaaS.\n *\n * Two pieces:\n *\n *   - `createPlan(...)` — declarative pricing config: optional flat\n *     base fee + per-dimension unit prices, with optional graduated\n *     tiers and free-tier allowances per dimension.\n *\n *   - `computeInvoice({ plan, period, tenant, usage, currency? })`\n *     — pure function that turns a `@absolutejs/metering`-shaped\n *     `Usage` snapshot (or any record of metered numbers) into an\n *     `Invoice` of line items + total. All money math is done in\n *     integer **micros** (1 micro = 1/1,000,000 of a currency unit\n *     — the same denomination Stripe uses internally) so float\n *     drift is structurally impossible.\n *\n * Invoice sinks (push to Stripe, post to QuickBooks, mail a PDF)\n * live OUTSIDE this package, in `@absolutejs/billing-adapters/*`.\n * Keeping the substrate pure means the control plane can preview\n * invoices, run dry-run \"would-charge\" projections, and replay an\n * old usage snapshot through a new plan without touching any\n * vendor SDK.\n */\n\n// =============================================================================\n// Money primitives\n// =============================================================================\n\n/**\n * An integer amount in a plan's sub-units. 1,000,000 (micros) by default, but\n * a plan may choose a finer denomination — see `Plan.denomination`.\n */\nexport type Micros = number;\n\n/** Sub-units per currency unit when a plan does not say otherwise. */\nexport const DEFAULT_DENOMINATION = 1_000_000;\n\n/** Nanos — the denomination token-priced APIs need. */\nexport const NANO_DENOMINATION = 1_000_000_000;\n\n/**\n * Round a fractional micros value to an integer. The substrate uses\n * **truncation** (banker's-style would surprise callers expecting\n * \"$0.0009 → $0.00\" not \"$0.0009 → $0.001\"). Plans override per-plan.\n */\nexport type Rounding = \"truncate\" | \"round-half-up\";\n\nconst roundMicros = (value: number, rounding: Rounding): Micros => {\n  if (rounding === \"truncate\") return Math.trunc(value);\n  return Math.round(value);\n};\n\n// =============================================================================\n// Pricing config\n// =============================================================================\n\n/**\n * One step in a graduated-tier price table. `upTo` is the inclusive\n * upper bound (in metered units, NOT micros) for this band.\n * `perUnitMicros` is what the customer pays per single metered unit\n * within this band. The last entry must have `upTo: Infinity` to\n * cover any overflow.\n */\nexport type PricingTier = {\n  upTo: number;\n  perUnitMicros: number;\n};\n\n/**\n * Per-dimension pricing. Three shapes:\n *\n *   - Flat per-unit: `{ perUnitMicros: 200, unit: 1024 * 1024 }`\n *     charges 200 micros ($0.0002) per MB of usage.\n *\n *   - Tiered: `{ tiers: [...], unit: 1 }` charges per the first\n *     matching `PricingTier` band.\n *\n *   - Custom: `{ price: (quantity) => micros, unit: 1 }` — escape\n *     hatch for surge / caps / non-monotonic pricing. The substrate\n *     stays pure; you ship whatever function you want.\n *\n * `freeTier` is subtracted from the metered quantity BEFORE pricing\n * — the conventional \"first N units free\" rule.\n *\n * `unit` is the metered-unit denominator: 1 means \"price per single\n * metered unit\", 1024*1024 means \"price per MB when quantity is in\n * bytes.\" Default 1.\n *\n * `label` overrides the line-item display name.\n */\nexport type PricedDimension = {\n  label?: string;\n  freeTier?: number;\n  unit?: number;\n} & (\n  | { perUnitMicros: number; tiers?: never; price?: never }\n  | { tiers: PricingTier[]; perUnitMicros?: never; price?: never }\n  | {\n      price: (chargedQuantity: number) => Micros;\n      perUnitMicros?: never;\n      tiers?: never;\n    }\n);\n\nexport type Plan = {\n  /** Human label for the invoice (`'pro'`, `'enterprise'`, etc.). */\n  name: string;\n  /**\n   * Sub-units per currency unit. Defaults to 1,000,000 (micros).\n   *\n   * Micros are too coarse for token-priced APIs: at $0.16 per million\n   * embedding tokens a five-token call costs $0.0000008, which truncates to\n   * ZERO in micros — so a plan priced in micros systematically under-bills\n   * its cheapest calls. Set `1_000_000_000` to price in nanos, or any other\n   * power of ten the vendor's rate card needs. Every `*Micros` field on the\n   * plan and the invoice is denominated in these sub-units.\n   */\n  denomination?: number;\n  /** Optional flat base fee charged once per invoice period. */\n  basePriceMicros?: Micros;\n  /**\n   * Dimensions priced from usage. Keys must match keys on the\n   * `usage` record passed to `computeInvoice`. Anything not listed\n   * is ignored.\n   */\n  pricedDimensions: Record<string, PricedDimension>;\n  /** Default currency for invoices generated from this plan. */\n  currency?: string;\n  /** Rounding strategy applied per line item. Default `'truncate'`. */\n  rounding?: Rounding;\n  /**\n   * Minimum charge (in micros) — if the computed total is below\n   * this floor, the invoice total is raised to the floor and a\n   * single `'minimum-charge-adjustment'` line item captures the\n   * difference. Defaults to 0 (no floor).\n   */\n  minimumChargeMicros?: Micros;\n  /** Arbitrary plan-level metadata that flows through to invoices. */\n  metadata?: Record<string, string>;\n};\n\nexport const createPlan = (plan: Plan): Plan => {\n  for (const [key, dim] of Object.entries(plan.pricedDimensions)) {\n    if (dim.tiers !== undefined) {\n      if (dim.tiers.length === 0) {\n        throw new Error(`billing: dimension '${key}' has no tiers`);\n      }\n      const last = dim.tiers[dim.tiers.length - 1];\n      if (last !== undefined && Number.isFinite(last.upTo)) {\n        throw new Error(\n          `billing: dimension '${key}' final tier must have upTo: Infinity`,\n        );\n      }\n      let prev = 0;\n      for (let i = 0; i < dim.tiers.length; i += 1) {\n        const tier = dim.tiers[i]!;\n        if (tier.upTo < prev) {\n          throw new Error(\n            `billing: dimension '${key}' tier #${i} upTo (${tier.upTo}) must be >= previous (${prev})`,\n          );\n        }\n        prev = tier.upTo;\n      }\n    }\n  }\n  return plan;\n};\n\n// =============================================================================\n// Invoice shape\n// =============================================================================\n\nexport type LineItem = {\n  /**\n   * Stable key for the line item. For priced dimensions it's the\n   * usage-record key (`'requests'`, `'cpuMs'`, etc.). For the base\n   * fee it's `'base'`. For minimum-charge top-up it's\n   * `'minimum-charge-adjustment'`.\n   */\n  key: string;\n  /** Human-readable label. */\n  label: string;\n  /** Metered units BEFORE applying free tier. 0 for the base fee. */\n  quantity: number;\n  /** Metered units AFTER applying free tier (what's actually charged). */\n  chargedQuantity: number;\n  /** Free-tier units subtracted from `quantity`. */\n  freeTier?: number;\n  /** Charge for this line in integer micros. */\n  amountMicros: Micros;\n  /**\n   * Tier-by-tier breakdown when graduated pricing was used. Each\n   * entry: `{ tierIndex, unitsInTier, perUnitMicros, amountMicros }`.\n   */\n  tierBreakdown?: Array<{\n    tierIndex: number;\n    unitsInTier: number;\n    perUnitMicros: number;\n    amountMicros: Micros;\n  }>;\n};\n\nexport type InvoicePeriod = {\n  /** Inclusive period start (`Date.now()` ms). */\n  start: number;\n  /** Exclusive period end. */\n  end: number;\n};\n\nexport type Invoice = {\n  tenant: string;\n  plan: string;\n  currency: string;\n  /** Sub-units per currency unit these amounts are in (default micros). */\n  denomination: number;\n  period: InvoicePeriod;\n  lineItems: LineItem[];\n  /** Sum of all `lineItems[].amountMicros`. */\n  totalMicros: Micros;\n  /** Convenience: `totalMicros / 1_000_000` as a number. */\n  totalUnits: number;\n  /** Plan-level metadata copied through unchanged. */\n  metadata?: Record<string, string>;\n};\n\n// =============================================================================\n// Pricing math\n// =============================================================================\n\ntype ComputeDimensionInput = {\n  quantity: number;\n  dim: PricedDimension;\n  rounding: Rounding;\n};\n\ntype ComputeDimensionResult = {\n  amountMicros: Micros;\n  chargedQuantity: number;\n  tierBreakdown?: LineItem[\"tierBreakdown\"];\n};\n\nconst computeDimension = ({\n  quantity,\n  dim,\n  rounding,\n}: ComputeDimensionInput): ComputeDimensionResult => {\n  const free = dim.freeTier ?? 0;\n  const charged = Math.max(0, quantity - free);\n  const unit = dim.unit ?? 1;\n  const chargedUnits = unit === 1 ? charged : charged / unit;\n\n  if (dim.perUnitMicros !== undefined) {\n    const amountMicros = roundMicros(\n      chargedUnits * dim.perUnitMicros,\n      rounding,\n    );\n    return { amountMicros, chargedQuantity: charged };\n  }\n\n  if (dim.price !== undefined) {\n    const amountMicros = roundMicros(dim.price(charged), rounding);\n    return { amountMicros, chargedQuantity: charged };\n  }\n\n  // Tiered pricing — walk tiers, allocate chargedUnits into bands.\n  const tierBreakdown: NonNullable<LineItem[\"tierBreakdown\"]> = [];\n  let remaining = chargedUnits;\n  let bandFloor = 0;\n  let totalMicros = 0;\n  for (let i = 0; i < dim.tiers!.length && remaining > 0; i += 1) {\n    const tier = dim.tiers![i]!;\n    const bandWidth = tier.upTo - bandFloor;\n    const unitsInTier = Math.min(remaining, bandWidth);\n    if (unitsInTier > 0) {\n      const tierMicros = roundMicros(\n        unitsInTier * tier.perUnitMicros,\n        rounding,\n      );\n      tierBreakdown.push({\n        amountMicros: tierMicros,\n        perUnitMicros: tier.perUnitMicros,\n        tierIndex: i,\n        unitsInTier,\n      });\n      totalMicros += tierMicros;\n    }\n    remaining -= unitsInTier;\n    bandFloor = tier.upTo;\n  }\n  return {\n    amountMicros: totalMicros,\n    chargedQuantity: charged,\n    tierBreakdown,\n  };\n};\n\n// =============================================================================\n// computeInvoice — pure\n// =============================================================================\n\nexport type ComputeInvoiceInput = {\n  plan: Plan;\n  tenant: string;\n  period: InvoicePeriod;\n  /** Metered numbers keyed by the same names as `plan.pricedDimensions`. */\n  usage: Record<string, number>;\n  /** Override the plan's currency (e.g. for tenant-local invoicing). */\n  currency?: string;\n};\n\nexport const computeInvoice = ({\n  plan,\n  tenant,\n  period,\n  usage,\n  currency,\n}: ComputeInvoiceInput): Invoice => {\n  const rounding = plan.rounding ?? \"truncate\";\n  const lineItems: LineItem[] = [];\n\n  if (plan.basePriceMicros !== undefined && plan.basePriceMicros > 0) {\n    lineItems.push({\n      amountMicros: plan.basePriceMicros,\n      chargedQuantity: 1,\n      key: \"base\",\n      label: `${plan.name} base fee`,\n      quantity: 1,\n    });\n  }\n\n  for (const [key, dim] of Object.entries(plan.pricedDimensions)) {\n    const quantity = usage[key] ?? 0;\n    if (!Number.isFinite(quantity) || quantity < 0) continue;\n    const result = computeDimension({ dim, quantity, rounding });\n    if (result.amountMicros === 0 && result.chargedQuantity === 0) continue;\n    const item: LineItem = {\n      amountMicros: result.amountMicros,\n      chargedQuantity: result.chargedQuantity,\n      key,\n      label: dim.label ?? key,\n      quantity,\n    };\n    if (dim.freeTier !== undefined) item.freeTier = dim.freeTier;\n    if (result.tierBreakdown !== undefined && result.tierBreakdown.length > 0) {\n      item.tierBreakdown = result.tierBreakdown;\n    }\n    lineItems.push(item);\n  }\n\n  let totalMicros = lineItems.reduce((sum, item) => sum + item.amountMicros, 0);\n\n  const floor = plan.minimumChargeMicros ?? 0;\n  if (floor > 0 && totalMicros < floor) {\n    const gap = floor - totalMicros;\n    lineItems.push({\n      amountMicros: gap,\n      chargedQuantity: 1,\n      key: \"minimum-charge-adjustment\",\n      label: \"Minimum charge adjustment\",\n      quantity: 1,\n    });\n    totalMicros = floor;\n  }\n\n  const denomination = plan.denomination ?? DEFAULT_DENOMINATION;\n  const invoice: Invoice = {\n    currency: currency ?? plan.currency ?? \"usd\",\n    denomination,\n    lineItems,\n    period,\n    plan: plan.name,\n    tenant,\n    totalMicros,\n    totalUnits: totalMicros / denomination,\n  };\n  if (plan.metadata !== undefined) invoice.metadata = plan.metadata;\n  return invoice;\n};\n\n// =============================================================================\n// Display helpers\n// =============================================================================\n\n/**\n * Format an integer micros amount as a human currency string. Pure\n * — no Intl side effects. For locales / advanced formatting, pipe\n * through `Intl.NumberFormat` yourself.\n */\nexport const formatMicros = (\n  amount: Micros,\n  currency: string,\n  {\n    denomination = DEFAULT_DENOMINATION,\n    minorUnits = 2,\n  }: { denomination?: number; minorUnits?: number } = {},\n): string => {\n  const sign = amount < 0 ? \"-\" : \"\";\n  const abs = Math.abs(amount);\n  const exponent = Math.round(Math.log10(denomination));\n  const wholeMicrosPerMinor = 10 ** (exponent - minorUnits);\n  const minorTotal = Math.round(abs / wholeMicrosPerMinor);\n  const divisor = 10 ** minorUnits;\n  const whole = Math.trunc(minorTotal / divisor);\n  const upper = currency.toUpperCase();\n  if (minorUnits === 0) return `${sign}${whole} ${upper}`;\n  const fraction = minorTotal % divisor;\n  const fractionStr = fraction.toString().padStart(minorUnits, \"0\");\n  return `${sign}${whole}.${fractionStr} ${upper}`;\n};\n\n// Provider balances — read upstream vendors' real balance/quota/spend (the\n// inverse of computeInvoice). See ./balances.\nexport {\n  readProviderBalances,\n  type ProviderBalance,\n  type ProviderBalanceConfig,\n  type ProviderBalanceKind,\n  type ProviderBalanceStatus,\n  type BraveUsageSnapshot,\n  type EmbeddingUsageSnapshot,\n} from \"./balances\";\n"
   ],
-  "mappings": "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",
-  "debugId": "B81091439AEF4A5064756E2164756E21",
+  "mappings": "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",
+  "debugId": "D50F9899A29C0CBA64756E2164756E21",
   "names": []
 }

package/dist/ledger.d.ts

@@ -0,0 +1,56 @@
+/** One priced, metered event, ready to persist. */
+export type LedgerEntry = {
+    /** Charge in integer sub-units of the plan's denomination (see
+     *  `Plan.denomination`) — never a float. */
+    amount: number;
+    /** What the customer is billed in the product's own unit. */
+    credits: number;
+    /** Product-level grouping ("chat", "voice"), not the vendor's. */
+    feature?: string | null;
+    model?: string;
+    /** "llm" | "tts" | "embedding" | whatever the product meters. */
+    operation: string;
+    provider: string;
+    /** Idempotency handle for at-least-once callers. */
+    requestId?: string;
+    /** Null for system/background work with nobody to bill. */
+    tenant?: string | null;
+};
+export type LedgerCommit = {
+    /** Append the row AND debit `entry.credits` from the tenant's balance in a
+     *  single atomic unit. Called with tenant null for unattributed work, where
+     *  there is nothing to debit. */
+    commit: (entry: LedgerEntry) => Promise<void>;
+    /** Fold the entry into a derived daily aggregate. Best-effort by contract:
+     *  this module swallows its failures. */
+    rollup?: (entry: LedgerEntry) => Promise<void>;
+    /** Total sub-units charged since `since`, for the spend cap. */
+    spentSince?: (since: Date) => Promise<number>;
+};
+export type UsageLedgerOptions = {
+    /** Sub-units per credit. A peg of 1_000 with micros means 1 credit =
+     *  $0.001. Required for credit conversion; omit to bill in raw amounts. */
+    creditPegSubUnits?: number;
+    /** Reported when a rollup fails. The charge already succeeded. */
+    onRollupError?: (error: unknown, entry: LedgerEntry) => void;
+    store: LedgerCommit;
+};
+/**
+ * Credits for a charge. Ceiling, not rounding: a product that sells credits
+ * must never hand out a fraction it cannot deduct, and rounding down means
+ * the smallest calls are free — which is how a "cheap" endpoint becomes an
+ * unmetered one.
+ */
+export declare const creditsFor: (amount: number, pegSubUnits: number) => number;
+export type UsageLedger = {
+    /** Price-agnostic: hand it an amount already in sub-units. Returns what was
+     *  written, including the credits it derived. */
+    record: (entry: Omit<LedgerEntry, "credits"> & {
+        credits?: number;
+    }) => Promise<LedgerEntry>;
+    /** True once spend since `since` reaches `capSubUnits`. Fails OPEN — a
+     *  broken cap must not take down paid features, and the per-provider
+     *  budgets are still in front. */
+    overCap: (capSubUnits: number, since: Date) => Promise<boolean>;
+};
+export declare const createUsageLedger: (options: UsageLedgerOptions) => UsageLedger;

package/dist/ledger.js

@@ -0,0 +1,54 @@
+// @bun
+var __defProp = Object.defineProperty;
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
+
+// src/ledger.ts
+var creditsFor = (amount, pegSubUnits) => {
+  if (pegSubUnits <= 0)
+    return 0;
+  return Math.ceil(amount / pegSubUnits);
+};
+var createUsageLedger = (options) => {
+  const { creditPegSubUnits, onRollupError, store } = options;
+  return {
+    overCap: async (capSubUnits, since) => {
+      if (!store.spentSince)
+        return false;
+      try {
+        return await store.spentSince(since) >= capSubUnits;
+      } catch {
+        return false;
+      }
+    },
+    record: async (input) => {
+      const credits = input.credits ?? (creditPegSubUnits === undefined ? 0 : creditsFor(input.amount, creditPegSubUnits));
+      const entry = { ...input, credits };
+      await store.commit(entry);
+      if (store.rollup) {
+        await store.rollup(entry).catch((error) => {
+          onRollupError?.(error, entry);
+        });
+      }
+      return entry;
+    }
+  };
+};
+export {
+  creditsFor,
+  createUsageLedger
+};
+
+//# debugId=0E1FB04E107E92A964756E2164756E21
+//# sourceMappingURL=ledger.js.map

package/dist/ledger.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/ledger.ts"],
+  "sourcesContent": [
+    "// The layer between a meter and an invoice: every metered event gets priced,\n// converted to the customer's credit unit, written to an append-only ledger,\n// debited against a balance, and folded into a daily rollup that a spend cap\n// can read. Every app billing a metered API rebuilds this, and each one\n// rediscovers the same three traps:\n//\n//   - Money in floats. Summing float ledger rows drifts; one real deployment\n//     lost 2 cents across 25,740 rows before anyone noticed. Amounts here are\n//     integer sub-units (see Plan.denomination) and are only ever added.\n//   - The debit and the ledger row diverging. If the row is written but the\n//     balance is not debited, a customer gets free usage; the reverse\n//     over-charges. They must land together, so the store commits them as one\n//     unit — this module never splits them.\n//   - The rollup being treated as truth. It is a derived index, rebuildable\n//     from the ledger, so a rollup failure must never fail the charge.\n//\n// Storage stays the host's business (Postgres, ClickHouse, anything). This\n// owns the policy and the arithmetic, which is the part that is identical\n// everywhere — and the part that is worth getting wrong only once.\n\n/** One priced, metered event, ready to persist. */\nexport type LedgerEntry = {\n  /** Charge in integer sub-units of the plan's denomination (see\n   *  `Plan.denomination`) — never a float. */\n  amount: number;\n  /** What the customer is billed in the product's own unit. */\n  credits: number;\n  /** Product-level grouping (\"chat\", \"voice\"), not the vendor's. */\n  feature?: string | null;\n  model?: string;\n  /** \"llm\" | \"tts\" | \"embedding\" | whatever the product meters. */\n  operation: string;\n  provider: string;\n  /** Idempotency handle for at-least-once callers. */\n  requestId?: string;\n  /** Null for system/background work with nobody to bill. */\n  tenant?: string | null;\n};\n\nexport type LedgerCommit = {\n  /** Append the row AND debit `entry.credits` from the tenant's balance in a\n   *  single atomic unit. Called with tenant null for unattributed work, where\n   *  there is nothing to debit. */\n  commit: (entry: LedgerEntry) => Promise<void>;\n  /** Fold the entry into a derived daily aggregate. Best-effort by contract:\n   *  this module swallows its failures. */\n  rollup?: (entry: LedgerEntry) => Promise<void>;\n  /** Total sub-units charged since `since`, for the spend cap. */\n  spentSince?: (since: Date) => Promise<number>;\n};\n\nexport type UsageLedgerOptions = {\n  /** Sub-units per credit. A peg of 1_000 with micros means 1 credit =\n   *  $0.001. Required for credit conversion; omit to bill in raw amounts. */\n  creditPegSubUnits?: number;\n  /** Reported when a rollup fails. The charge already succeeded. */\n  onRollupError?: (error: unknown, entry: LedgerEntry) => void;\n  store: LedgerCommit;\n};\n\n/**\n * Credits for a charge. Ceiling, not rounding: a product that sells credits\n * must never hand out a fraction it cannot deduct, and rounding down means\n * the smallest calls are free — which is how a \"cheap\" endpoint becomes an\n * unmetered one.\n */\nexport const creditsFor = (amount: number, pegSubUnits: number) => {\n  if (pegSubUnits <= 0) return 0;\n\n  return Math.ceil(amount / pegSubUnits);\n};\n\nexport type UsageLedger = {\n  /** Price-agnostic: hand it an amount already in sub-units. Returns what was\n   *  written, including the credits it derived. */\n  record: (\n    entry: Omit<LedgerEntry, \"credits\"> & { credits?: number },\n  ) => Promise<LedgerEntry>;\n  /** True once spend since `since` reaches `capSubUnits`. Fails OPEN — a\n   *  broken cap must not take down paid features, and the per-provider\n   *  budgets are still in front. */\n  overCap: (capSubUnits: number, since: Date) => Promise<boolean>;\n};\n\nexport const createUsageLedger = (options: UsageLedgerOptions): UsageLedger => {\n  const { creditPegSubUnits, onRollupError, store } = options;\n\n  return {\n    overCap: async (capSubUnits, since) => {\n      if (!store.spentSince) return false;\n      try {\n        return (await store.spentSince(since)) >= capSubUnits;\n      } catch {\n        return false;\n      }\n    },\n    record: async (input) => {\n      const credits =\n        input.credits ??\n        (creditPegSubUnits === undefined\n          ? 0\n          : creditsFor(input.amount, creditPegSubUnits));\n      const entry: LedgerEntry = { ...input, credits };\n      // The charge is the thing that must not be lost; it is awaited and its\n      // failure propagates to the caller.\n      await store.commit(entry);\n      // The rollup is a derived index — rebuildable from the ledger — so its\n      // failure is reported, never raised.\n      if (store.rollup) {\n        await store.rollup(entry).catch((error: unknown) => {\n          onRollupError?.(error, entry);\n        });\n      }\n\n      return entry;\n    },\n  };\n};\n"
+  ],
+  "mappings": ";;;;;;;;;;;;;;;;;AAkEO,IAAM,aAAa,CAAC,QAAgB,gBAAwB;AAAA,EACjE,IAAI,eAAe;AAAA,IAAG,OAAO;AAAA,EAE7B,OAAO,KAAK,KAAK,SAAS,WAAW;AAAA;AAehC,IAAM,oBAAoB,CAAC,YAA6C;AAAA,EAC7E,QAAQ,mBAAmB,eAAe,UAAU;AAAA,EAEpD,OAAO;AAAA,IACL,SAAS,OAAO,aAAa,UAAU;AAAA,MACrC,IAAI,CAAC,MAAM;AAAA,QAAY,OAAO;AAAA,MAC9B,IAAI;AAAA,QACF,OAAQ,MAAM,MAAM,WAAW,KAAK,KAAM;AAAA,QAC1C,MAAM;AAAA,QACN,OAAO;AAAA;AAAA;AAAA,IAGX,QAAQ,OAAO,UAAU;AAAA,MACvB,MAAM,UACJ,MAAM,YACL,sBAAsB,YACnB,IACA,WAAW,MAAM,QAAQ,iBAAiB;AAAA,MAChD,MAAM,QAAqB,KAAK,OAAO,QAAQ;AAAA,MAG/C,MAAM,MAAM,OAAO,KAAK;AAAA,MAGxB,IAAI,MAAM,QAAQ;AAAA,QAChB,MAAM,MAAM,OAAO,KAAK,EAAE,MAAM,CAAC,UAAmB;AAAA,UAClD,gBAAgB,OAAO,KAAK;AAAA,SAC7B;AAAA,MACH;AAAA,MAEA,OAAO;AAAA;AAAA,EAEX;AAAA;",
+  "debugId": "0E1FB04E107E92A964756E2164756E21",
+  "names": []
+}

package/dist/manifest.js

@@ -380,6 +380,8 @@ var readProviderBalances = async (config) => {
 };
 
 // src/index.ts
+var DEFAULT_DENOMINATION = 1e6;
+var NANO_DENOMINATION = 1e9;
 var roundMicros = (value, rounding) => {
   if (rounding === "truncate")
     return Math.trunc(value);
@@ -503,23 +505,29 @@ var computeInvoice = ({
     });
     totalMicros = floor;
   }
+  const denomination = plan.denomination ?? DEFAULT_DENOMINATION;
   const invoice = {
     currency: currency ?? plan.currency ?? "usd",
+    denomination,
     lineItems,
     period,
     plan: plan.name,
     tenant,
     totalMicros,
-    totalUnits: totalMicros / 1e6
+    totalUnits: totalMicros / denomination
   };
   if (plan.metadata !== undefined)
     invoice.metadata = plan.metadata;
   return invoice;
 };
-var formatMicros = (amount, currency, { minorUnits = 2 } = {}) => {
+var formatMicros = (amount, currency, {
+  denomination = DEFAULT_DENOMINATION,
+  minorUnits = 2
+} = {}) => {
   const sign = amount < 0 ? "-" : "";
   const abs = Math.abs(amount);
-  const wholeMicrosPerMinor = 10 ** (6 - minorUnits);
+  const exponent = Math.round(Math.log10(denomination));
+  const wholeMicrosPerMinor = 10 ** (exponent - minorUnits);
   const minorTotal = Math.round(abs / wholeMicrosPerMinor);
   const divisor = 10 ** minorUnits;
   const whole = Math.trunc(minorTotal / divisor);
@@ -3447,5 +3455,5 @@ export {
   manifest
 };
 
-//# debugId=09E8F37D0FC879F864756E2164756E21
+//# debugId=FB56701BA9401D2A64756E2164756E21
 //# sourceMappingURL=manifest.js.map