@diogonzafe/tokenwatch 0.1.0

package/README.md

@@ -0,0 +1,250 @@
+# tokenwatch
+
+Transparent TypeScript wrapper that intercepts LLM API calls and tracks cost in real-time by session, user and model — without changing anything in your existing code.
+
+Supports **OpenAI**, **Anthropic**, **Google Gemini** and **DeepSeek**.
+
+## Installation
+
+```bash
+npm install tokenwatch
+```
+
+Peer dependencies (install only what you use):
+
+```bash
+npm install openai                  # OpenAI / DeepSeek
+npm install @anthropic-ai/sdk       # Anthropic
+npm install @google/generative-ai   # Gemini
+npm install better-sqlite3          # optional — only for storage: 'sqlite'
+```
+
+---
+
+## Setup
+
+```ts
+import { createTracker } from 'tokenwatch'
+
+const tracker = await createTracker({
+  // All fields are optional
+  storage: 'memory',           // 'memory' (default) | 'sqlite'
+  alertThreshold: 1.00,        // USD — fires webhookUrl when exceeded
+  webhookUrl: 'https://...',   // Discord / Slack webhook
+  syncPrices: true,            // fetch fresh prices from GitHub (default: true)
+  customPrices: {
+    'my-model': { input: 0.001, output: 0.002 }  // USD per 1M tokens
+  }
+})
+```
+
+---
+
+## OpenAI
+
+```ts
+import OpenAI from 'openai'
+import { wrapOpenAI } from 'tokenwatch'
+
+const openai = wrapOpenAI(new OpenAI(), tracker)
+
+const res = await openai.chat.completions.create({
+  model: 'gpt-4o',
+  messages: [{ role: 'user', content: 'Hello' }],
+  // Optional — removed before sending to the API
+  __sessionId: 'session_abc',
+  __userId: 'user_123',
+})
+// res is identical to the original OpenAI response — zero difference
+```
+
+Streaming is supported:
+
+```ts
+const stream = await openai.chat.completions.create({
+  model: 'gpt-4o',
+  messages: [...],
+  stream: true,
+  stream_options: { include_usage: true },  // required for usage in stream
+})
+
+for await (const chunk of stream) {
+  process.stdout.write(chunk.choices[0]?.delta?.content ?? '')
+}
+// Cost tracked automatically from the final chunk
+```
+
+---
+
+## Anthropic
+
+```ts
+import Anthropic from '@anthropic-ai/sdk'
+import { wrapAnthropic } from 'tokenwatch'
+
+const anthropic = wrapAnthropic(new Anthropic(), tracker)
+
+const res = await anthropic.messages.create({
+  model: 'claude-sonnet-4-6',
+  max_tokens: 1024,
+  messages: [{ role: 'user', content: 'Hello' }],
+  __sessionId: 'session_abc',
+  __userId: 'user_123',
+})
+```
+
+---
+
+## Google Gemini
+
+```ts
+import { GoogleGenerativeAI } from '@google/generative-ai'
+import { wrapGemini } from 'tokenwatch'
+
+const genAI = wrapGemini(new GoogleGenerativeAI(process.env.GEMINI_API_KEY!), tracker)
+
+const model = genAI.getGenerativeModel({ model: 'gemini-2.5-flash' })
+const result = await model.generateContent('Explain quantum computing')
+```
+
+---
+
+## DeepSeek
+
+DeepSeek uses an OpenAI-compatible API — just set `baseURL`:
+
+```ts
+import OpenAI from 'openai'
+import { wrapDeepSeek } from 'tokenwatch'
+
+const deepseek = wrapDeepSeek(
+  new OpenAI({
+    baseURL: 'https://api.deepseek.com',
+    apiKey: process.env.DEEPSEEK_API_KEY!,
+  }),
+  tracker,
+)
+
+const res = await deepseek.chat.completions.create({
+  model: 'deepseek-chat',
+  messages: [{ role: 'user', content: 'Hello' }],
+})
+```
+
+---
+
+## Reports
+
+```ts
+tracker.getReport()
+// {
+//   totalCostUSD: 0.087,
+//   totalTokens: { input: 24000, output: 6000 },
+//   byModel: {
+//     'gpt-4o': { costUSD: 0.062, calls: 5, tokens: { input: 20000, output: 5000 } },
+//     'claude-sonnet-4-6': { costUSD: 0.025, calls: 2, tokens: { input: 4000, output: 1000 } }
+//   },
+//   bySession: { 'session_abc': { costUSD: 0.045, calls: 4 } },
+//   byUser:    { 'user_123':    { costUSD: 0.087, calls: 7 } },
+//   period: { from: '2026-04-16T10:00:00Z', to: '2026-04-16T11:00:00Z' }
+// }
+
+tracker.reset()                     // clear all data
+tracker.resetSession('session_abc') // clear one session
+tracker.exportJSON()                // full report as JSON string
+tracker.exportCSV()                 // all calls as CSV string
+```
+
+---
+
+## Price Resolution
+
+Prices are resolved in this priority order:
+
+1. **`customPrices`** — your own overrides, highest priority
+2. **Remote `prices.json`** — fetched from GitHub, cached for 24h in `~/.tokenwatch/prices.json`
+3. **Bundled `prices.json`** — always-present fallback, updated weekly via GitHub Action
+
+If a model is not found in any layer, cost is recorded as **$0** with a `console.warn`.
+
+Prices are in **USD per 1 million tokens**.
+
+---
+
+## SQLite Storage
+
+For persistent tracking across restarts:
+
+```bash
+npm install better-sqlite3
+```
+
+```ts
+const tracker = await createTracker({ storage: 'sqlite' })
+// Data stored in ~/.tokenwatch/usage.db
+```
+
+---
+
+## Alerts & Webhooks
+
+```ts
+const tracker = await createTracker({
+  alertThreshold: 5.00,                          // USD
+  webhookUrl: 'https://hooks.slack.com/...',     // or Discord
+})
+// Webhook fires once when totalCostUSD crosses the threshold
+```
+
+Webhook payload:
+```json
+{ "text": "[tokenwatch] Alert: total cost reached $5.0012 USD (threshold: $5)" }
+```
+
+---
+
+## CLI
+
+```bash
+npx tokenwatch sync     # force update cached prices from remote
+npx tokenwatch prices   # list all models and current prices
+npx tokenwatch report   # show last saved report (SQLite)
+npx tokenwatch help     # show help
+```
+
+---
+
+## Bundled Models
+
+| Model | Input ($/1M) | Output ($/1M) |
+|---|---|---|
+| gpt-4o | $2.50 | $10.00 |
+| gpt-4o-mini | $0.15 | $0.60 |
+| gpt-5 | $1.25 | $10.00 |
+| gpt-5-mini | $0.25 | $2.00 |
+| gpt-5-nano | $0.05 | $0.40 |
+| claude-opus-4-6 | $5.00 | $25.00 |
+| claude-sonnet-4-6 | $3.00 | $15.00 |
+| claude-haiku-4-5 | $1.00 | $5.00 |
+| gemini-2.5-pro | $1.25 | $10.00 |
+| gemini-2.5-flash | $0.30 | $2.50 |
+| deepseek-chat | $0.28 | $0.42 |
+| deepseek-reasoner | $0.55 | $2.19 |
+
+Prices are automatically updated every Monday via GitHub Action.
+
+---
+
+## Behaviour Guarantees
+
+- `__sessionId` and `__userId` are **stripped before** the request reaches the API
+- The response object returned is **identical** to the original SDK response
+- Tracking operations are **synchronous and non-blocking** — zero latency added
+- If the API call **fails**, no cost is recorded and the original error is re-thrown unchanged
+- Streaming is fully supported — usage is accumulated from the final stream event
+
+---
+
+## License
+
+MIT

package/dist/cli.cjs

@@ -0,0 +1,112 @@
+#!/usr/bin/env node
+"use strict";
+
+// bin/cli.ts
+var import_node_fs2 = require("fs");
+var import_node_path2 = require("path");
+var import_node_url = require("url");
+
+// src/core/sync.ts
+var import_promises = require("fs/promises");
+var import_node_fs = require("fs");
+var import_node_os = require("os");
+var import_node_path = require("path");
+var CACHE_DIR = (0, import_node_path.join)((0, import_node_os.homedir)(), ".tokenwatch");
+var CACHE_FILE = (0, import_node_path.join)(CACHE_DIR, "prices.json");
+var CACHE_TTL_MS = 24 * 60 * 60 * 1e3;
+var REMOTE_URL = "https://raw.githubusercontent.com/diogonzafe/tokenwatch/main/prices.json";
+async function fetchRemotePrices(url = REMOTE_URL) {
+  try {
+    const res = await fetch(url, { signal: AbortSignal.timeout(8e3) });
+    if (!res.ok) return null;
+    const data = await res.json();
+    if (!data?.models) return null;
+    await persistCache(data);
+    return data.models;
+  } catch {
+    return null;
+  }
+}
+async function persistCache(data) {
+  try {
+    await (0, import_promises.mkdir)(CACHE_DIR, { recursive: true });
+    const payload = { ...data, _cachedAt: Date.now() };
+    await (0, import_promises.writeFile)(CACHE_FILE, JSON.stringify(payload, null, 2), "utf8");
+  } catch {
+  }
+}
+
+// bin/cli.ts
+var import_meta = {};
+var __dirname = (0, import_node_path2.dirname)((0, import_node_url.fileURLToPath)(import_meta.url));
+function loadBundledPrices() {
+  const pricesPath = (0, import_node_path2.join)(__dirname, "..", "prices.json");
+  const raw = (0, import_node_fs2.readFileSync)(pricesPath, "utf8");
+  const data = JSON.parse(raw);
+  return data.models;
+}
+async function cmdSync() {
+  console.log("Fetching latest prices from remote...");
+  const result = await fetchRemotePrices();
+  if (result) {
+    console.log(`\u2713 Prices updated. ${Object.keys(result).length} models cached.`);
+  } else {
+    console.error("\u2717 Failed to fetch remote prices. Check your internet connection.");
+    process.exit(1);
+  }
+}
+function cmdPrices() {
+  const models = loadBundledPrices();
+  const rows = Object.entries(models).map(([name, price]) => ({
+    model: name,
+    input: `$${price.input.toFixed(2)}/M`,
+    output: `$${price.output.toFixed(2)}/M`
+  }));
+  const maxName = Math.max(...rows.map((r) => r.model.length), 5);
+  const header = `${"Model".padEnd(maxName)}  ${"Input".padStart(12)}  ${"Output".padStart(12)}`;
+  const sep = "-".repeat(header.length);
+  console.log(header);
+  console.log(sep);
+  for (const row of rows) {
+    console.log(`${row.model.padEnd(maxName)}  ${row.input.padStart(12)}  ${row.output.padStart(12)}`);
+  }
+}
+function cmdHelp() {
+  console.log(`
+tokenwatch \u2014 CLI
+
+Commands:
+  sync      Fetch and cache latest model prices from remote
+  prices    List all bundled models and their current prices
+  report    Show last saved usage report (requires SQLite storage)
+  help      Show this help message
+`.trim());
+}
+async function main() {
+  const [, , cmd, ...args] = process.argv;
+  void args;
+  switch (cmd) {
+    case "sync":
+      await cmdSync();
+      break;
+    case "prices":
+      cmdPrices();
+      break;
+    case "report":
+      console.log("report command requires SQLite storage to be configured in your app.");
+      break;
+    case "help":
+    case void 0:
+      cmdHelp();
+      break;
+    default:
+      console.error(`Unknown command: ${cmd}
+Run "tokenwatch help" for usage.`);
+      process.exit(1);
+  }
+}
+main().catch((err) => {
+  console.error(err);
+  process.exit(1);
+});
+//# sourceMappingURL=cli.cjs.map

package/dist/cli.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../bin/cli.ts","../src/core/sync.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { readFileSync } from 'node:fs'\nimport { join, dirname } from 'node:path'\nimport { fileURLToPath } from 'node:url'\nimport { fetchRemotePrices } from '../src/core/sync.js'\n\nconst __dirname = dirname(fileURLToPath(import.meta.url))\n\nconst COMMANDS = ['sync', 'prices', 'report', 'help']\n\nfunction loadBundledPrices(): Record<string, { input: number; output: number }> {\n  const pricesPath = join(__dirname, '..', 'prices.json')\n  const raw = readFileSync(pricesPath, 'utf8')\n  const data = JSON.parse(raw) as {\n    updated_at: string\n    models: Record<string, { input: number; output: number }>\n  }\n  return data.models\n}\n\nasync function cmdSync(): Promise<void> {\n  console.log('Fetching latest prices from remote...')\n  const result = await fetchRemotePrices()\n  if (result) {\n    console.log(`✓ Prices updated. ${Object.keys(result).length} models cached.`)\n  } else {\n    console.error('✗ Failed to fetch remote prices. Check your internet connection.')\n    process.exit(1)\n  }\n}\n\nfunction cmdPrices(): void {\n  const models = loadBundledPrices()\n  const rows = Object.entries(models).map(([name, price]) => ({\n    model: name,\n    input: `$${price.input.toFixed(2)}/M`,\n    output: `$${price.output.toFixed(2)}/M`,\n  }))\n\n  const maxName = Math.max(...rows.map((r) => r.model.length), 5)\n  const header = `${'Model'.padEnd(maxName)}  ${'Input'.padStart(12)}  ${'Output'.padStart(12)}`\n  const sep = '-'.repeat(header.length)\n\n  console.log(header)\n  console.log(sep)\n  for (const row of rows) {\n    console.log(`${row.model.padEnd(maxName)}  ${row.input.padStart(12)}  ${row.output.padStart(12)}`)\n  }\n}\n\nfunction cmdHelp(): void {\n  console.log(`\ntokenwatch — CLI\n\nCommands:\n  sync      Fetch and cache latest model prices from remote\n  prices    List all bundled models and their current prices\n  report    Show last saved usage report (requires SQLite storage)\n  help      Show this help message\n`.trim())\n}\n\nasync function main(): Promise<void> {\n  const [, , cmd, ...args] = process.argv\n  void args\n\n  switch (cmd) {\n    case 'sync':\n      await cmdSync()\n      break\n    case 'prices':\n      cmdPrices()\n      break\n    case 'report':\n      console.log('report command requires SQLite storage to be configured in your app.')\n      break\n    case 'help':\n    case undefined:\n      cmdHelp()\n      break\n    default:\n      console.error(`Unknown command: ${cmd}\\nRun \"tokenwatch help\" for usage.`)\n      process.exit(1)\n  }\n}\n\nmain().catch((err: unknown) => {\n  console.error(err)\n  process.exit(1)\n})\n","import { readFile, writeFile, mkdir } from 'node:fs/promises'\nimport { existsSync } from 'node:fs'\nimport { homedir } from 'node:os'\nimport { join } from 'node:path'\nimport type { PricesFile, PriceMap } from '../types/index.js'\n\nconst CACHE_DIR = join(homedir(), '.tokenwatch')\nconst CACHE_FILE = join(CACHE_DIR, 'prices.json')\nconst CACHE_TTL_MS = 24 * 60 * 60 * 1000 // 24 hours\nconst REMOTE_URL =\n  'https://raw.githubusercontent.com/diogonzafe/tokenwatch/main/prices.json'\n\nexport async function fetchRemotePrices(url = REMOTE_URL): Promise<PriceMap | null> {\n  try {\n    const res = await fetch(url, { signal: AbortSignal.timeout(8_000) })\n    if (!res.ok) return null\n    const data = (await res.json()) as PricesFile\n    if (!data?.models) return null\n    await persistCache(data)\n    return data.models\n  } catch {\n    return null\n  }\n}\n\nexport async function loadCachedPrices(): Promise<PriceMap | null> {\n  if (!existsSync(CACHE_FILE)) return null\n  try {\n    const raw = await readFile(CACHE_FILE, 'utf8')\n    const data = JSON.parse(raw) as PricesFile & { _cachedAt?: number }\n    const age = Date.now() - (data._cachedAt ?? 0)\n    if (age > CACHE_TTL_MS) return null\n    return data.models ?? null\n  } catch {\n    return null\n  }\n}\n\nasync function persistCache(data: PricesFile): Promise<void> {\n  try {\n    await mkdir(CACHE_DIR, { recursive: true })\n    const payload = { ...data, _cachedAt: Date.now() }\n    await writeFile(CACHE_FILE, JSON.stringify(payload, null, 2), 'utf8')\n  } catch {\n    // best-effort — never throw\n  }\n}\n\n/**\n * Returns the best available remote price map:\n * 1. Valid local cache (< 24h)\n * 2. Fresh remote fetch (also updates cache)\n * 3. null if both fail\n */\nexport async function getRemotePrices(): Promise<PriceMap | null> {\n  const cached = await loadCachedPrices()\n  if (cached) return cached\n  return fetchRemotePrices()\n}\n"],"mappings":"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","names":["import_node_fs","import_node_path"]}

package/dist/cli.d.cts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/cli.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/cli.js

@@ -0,0 +1,110 @@
+#!/usr/bin/env node
+
+// bin/cli.ts
+import { readFileSync } from "fs";
+import { join as join2, dirname } from "path";
+import { fileURLToPath } from "url";
+
+// src/core/sync.ts
+import { readFile, writeFile, mkdir } from "fs/promises";
+import { existsSync } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+var CACHE_DIR = join(homedir(), ".tokenwatch");
+var CACHE_FILE = join(CACHE_DIR, "prices.json");
+var CACHE_TTL_MS = 24 * 60 * 60 * 1e3;
+var REMOTE_URL = "https://raw.githubusercontent.com/diogonzafe/tokenwatch/main/prices.json";
+async function fetchRemotePrices(url = REMOTE_URL) {
+  try {
+    const res = await fetch(url, { signal: AbortSignal.timeout(8e3) });
+    if (!res.ok) return null;
+    const data = await res.json();
+    if (!data?.models) return null;
+    await persistCache(data);
+    return data.models;
+  } catch {
+    return null;
+  }
+}
+async function persistCache(data) {
+  try {
+    await mkdir(CACHE_DIR, { recursive: true });
+    const payload = { ...data, _cachedAt: Date.now() };
+    await writeFile(CACHE_FILE, JSON.stringify(payload, null, 2), "utf8");
+  } catch {
+  }
+}
+
+// bin/cli.ts
+var __dirname = dirname(fileURLToPath(import.meta.url));
+function loadBundledPrices() {
+  const pricesPath = join2(__dirname, "..", "prices.json");
+  const raw = readFileSync(pricesPath, "utf8");
+  const data = JSON.parse(raw);
+  return data.models;
+}
+async function cmdSync() {
+  console.log("Fetching latest prices from remote...");
+  const result = await fetchRemotePrices();
+  if (result) {
+    console.log(`\u2713 Prices updated. ${Object.keys(result).length} models cached.`);
+  } else {
+    console.error("\u2717 Failed to fetch remote prices. Check your internet connection.");
+    process.exit(1);
+  }
+}
+function cmdPrices() {
+  const models = loadBundledPrices();
+  const rows = Object.entries(models).map(([name, price]) => ({
+    model: name,
+    input: `$${price.input.toFixed(2)}/M`,
+    output: `$${price.output.toFixed(2)}/M`
+  }));
+  const maxName = Math.max(...rows.map((r) => r.model.length), 5);
+  const header = `${"Model".padEnd(maxName)}  ${"Input".padStart(12)}  ${"Output".padStart(12)}`;
+  const sep = "-".repeat(header.length);
+  console.log(header);
+  console.log(sep);
+  for (const row of rows) {
+    console.log(`${row.model.padEnd(maxName)}  ${row.input.padStart(12)}  ${row.output.padStart(12)}`);
+  }
+}
+function cmdHelp() {
+  console.log(`
+tokenwatch \u2014 CLI
+
+Commands:
+  sync      Fetch and cache latest model prices from remote
+  prices    List all bundled models and their current prices
+  report    Show last saved usage report (requires SQLite storage)
+  help      Show this help message
+`.trim());
+}
+async function main() {
+  const [, , cmd, ...args] = process.argv;
+  void args;
+  switch (cmd) {
+    case "sync":
+      await cmdSync();
+      break;
+    case "prices":
+      cmdPrices();
+      break;
+    case "report":
+      console.log("report command requires SQLite storage to be configured in your app.");
+      break;
+    case "help":
+    case void 0:
+      cmdHelp();
+      break;
+    default:
+      console.error(`Unknown command: ${cmd}
+Run "tokenwatch help" for usage.`);
+      process.exit(1);
+  }
+}
+main().catch((err) => {
+  console.error(err);
+  process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../bin/cli.ts","../src/core/sync.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { readFileSync } from 'node:fs'\nimport { join, dirname } from 'node:path'\nimport { fileURLToPath } from 'node:url'\nimport { fetchRemotePrices } from '../src/core/sync.js'\n\nconst __dirname = dirname(fileURLToPath(import.meta.url))\n\nconst COMMANDS = ['sync', 'prices', 'report', 'help']\n\nfunction loadBundledPrices(): Record<string, { input: number; output: number }> {\n  const pricesPath = join(__dirname, '..', 'prices.json')\n  const raw = readFileSync(pricesPath, 'utf8')\n  const data = JSON.parse(raw) as {\n    updated_at: string\n    models: Record<string, { input: number; output: number }>\n  }\n  return data.models\n}\n\nasync function cmdSync(): Promise<void> {\n  console.log('Fetching latest prices from remote...')\n  const result = await fetchRemotePrices()\n  if (result) {\n    console.log(`✓ Prices updated. ${Object.keys(result).length} models cached.`)\n  } else {\n    console.error('✗ Failed to fetch remote prices. Check your internet connection.')\n    process.exit(1)\n  }\n}\n\nfunction cmdPrices(): void {\n  const models = loadBundledPrices()\n  const rows = Object.entries(models).map(([name, price]) => ({\n    model: name,\n    input: `$${price.input.toFixed(2)}/M`,\n    output: `$${price.output.toFixed(2)}/M`,\n  }))\n\n  const maxName = Math.max(...rows.map((r) => r.model.length), 5)\n  const header = `${'Model'.padEnd(maxName)}  ${'Input'.padStart(12)}  ${'Output'.padStart(12)}`\n  const sep = '-'.repeat(header.length)\n\n  console.log(header)\n  console.log(sep)\n  for (const row of rows) {\n    console.log(`${row.model.padEnd(maxName)}  ${row.input.padStart(12)}  ${row.output.padStart(12)}`)\n  }\n}\n\nfunction cmdHelp(): void {\n  console.log(`\ntokenwatch — CLI\n\nCommands:\n  sync      Fetch and cache latest model prices from remote\n  prices    List all bundled models and their current prices\n  report    Show last saved usage report (requires SQLite storage)\n  help      Show this help message\n`.trim())\n}\n\nasync function main(): Promise<void> {\n  const [, , cmd, ...args] = process.argv\n  void args\n\n  switch (cmd) {\n    case 'sync':\n      await cmdSync()\n      break\n    case 'prices':\n      cmdPrices()\n      break\n    case 'report':\n      console.log('report command requires SQLite storage to be configured in your app.')\n      break\n    case 'help':\n    case undefined:\n      cmdHelp()\n      break\n    default:\n      console.error(`Unknown command: ${cmd}\\nRun \"tokenwatch help\" for usage.`)\n      process.exit(1)\n  }\n}\n\nmain().catch((err: unknown) => {\n  console.error(err)\n  process.exit(1)\n})\n","import { readFile, writeFile, mkdir } from 'node:fs/promises'\nimport { existsSync } from 'node:fs'\nimport { homedir } from 'node:os'\nimport { join } from 'node:path'\nimport type { PricesFile, PriceMap } from '../types/index.js'\n\nconst CACHE_DIR = join(homedir(), '.tokenwatch')\nconst CACHE_FILE = join(CACHE_DIR, 'prices.json')\nconst CACHE_TTL_MS = 24 * 60 * 60 * 1000 // 24 hours\nconst REMOTE_URL =\n  'https://raw.githubusercontent.com/diogonzafe/tokenwatch/main/prices.json'\n\nexport async function fetchRemotePrices(url = REMOTE_URL): Promise<PriceMap | null> {\n  try {\n    const res = await fetch(url, { signal: AbortSignal.timeout(8_000) })\n    if (!res.ok) return null\n    const data = (await res.json()) as PricesFile\n    if (!data?.models) return null\n    await persistCache(data)\n    return data.models\n  } catch {\n    return null\n  }\n}\n\nexport async function loadCachedPrices(): Promise<PriceMap | null> {\n  if (!existsSync(CACHE_FILE)) return null\n  try {\n    const raw = await readFile(CACHE_FILE, 'utf8')\n    const data = JSON.parse(raw) as PricesFile & { _cachedAt?: number }\n    const age = Date.now() - (data._cachedAt ?? 0)\n    if (age > CACHE_TTL_MS) return null\n    return data.models ?? null\n  } catch {\n    return null\n  }\n}\n\nasync function persistCache(data: PricesFile): Promise<void> {\n  try {\n    await mkdir(CACHE_DIR, { recursive: true })\n    const payload = { ...data, _cachedAt: Date.now() }\n    await writeFile(CACHE_FILE, JSON.stringify(payload, null, 2), 'utf8')\n  } catch {\n    // best-effort — never throw\n  }\n}\n\n/**\n * Returns the best available remote price map:\n * 1. Valid local cache (< 24h)\n * 2. Fresh remote fetch (also updates cache)\n * 3. null if both fail\n */\nexport async function getRemotePrices(): Promise<PriceMap | null> {\n  const cached = await loadCachedPrices()\n  if (cached) return cached\n  return fetchRemotePrices()\n}\n"],"mappings":";;;AACA,SAAS,oBAAoB;AAC7B,SAAS,QAAAA,OAAM,eAAe;AAC9B,SAAS,qBAAqB;;;ACH9B,SAAS,UAAU,WAAW,aAAa;AAC3C,SAAS,kBAAkB;AAC3B,SAAS,eAAe;AACxB,SAAS,YAAY;AAGrB,IAAM,YAAY,KAAK,QAAQ,GAAG,aAAa;AAC/C,IAAM,aAAa,KAAK,WAAW,aAAa;AAChD,IAAM,eAAe,KAAK,KAAK,KAAK;AACpC,IAAM,aACJ;AAEF,eAAsB,kBAAkB,MAAM,YAAsC;AAClF,MAAI;AACF,UAAM,MAAM,MAAM,MAAM,KAAK,EAAE,QAAQ,YAAY,QAAQ,GAAK,EAAE,CAAC;AACnE,QAAI,CAAC,IAAI,GAAI,QAAO;AACpB,UAAM,OAAQ,MAAM,IAAI,KAAK;AAC7B,QAAI,CAAC,MAAM,OAAQ,QAAO;AAC1B,UAAM,aAAa,IAAI;AACvB,WAAO,KAAK;AAAA,EACd,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAeA,eAAe,aAAa,MAAiC;AAC3D,MAAI;AACF,UAAM,MAAM,WAAW,EAAE,WAAW,KAAK,CAAC;AAC1C,UAAM,UAAU,EAAE,GAAG,MAAM,WAAW,KAAK,IAAI,EAAE;AACjD,UAAM,UAAU,YAAY,KAAK,UAAU,SAAS,MAAM,CAAC,GAAG,MAAM;AAAA,EACtE,QAAQ;AAAA,EAER;AACF;;;ADxCA,IAAM,YAAY,QAAQ,cAAc,YAAY,GAAG,CAAC;AAIxD,SAAS,oBAAuE;AAC9E,QAAM,aAAaC,MAAK,WAAW,MAAM,aAAa;AACtD,QAAM,MAAM,aAAa,YAAY,MAAM;AAC3C,QAAM,OAAO,KAAK,MAAM,GAAG;AAI3B,SAAO,KAAK;AACd;AAEA,eAAe,UAAyB;AACtC,UAAQ,IAAI,uCAAuC;AACnD,QAAM,SAAS,MAAM,kBAAkB;AACvC,MAAI,QAAQ;AACV,YAAQ,IAAI,0BAAqB,OAAO,KAAK,MAAM,EAAE,MAAM,iBAAiB;AAAA,EAC9E,OAAO;AACL,YAAQ,MAAM,uEAAkE;AAChF,YAAQ,KAAK,CAAC;AAAA,EAChB;AACF;AAEA,SAAS,YAAkB;AACzB,QAAM,SAAS,kBAAkB;AACjC,QAAM,OAAO,OAAO,QAAQ,MAAM,EAAE,IAAI,CAAC,CAAC,MAAM,KAAK,OAAO;AAAA,IAC1D,OAAO;AAAA,IACP,OAAO,IAAI,MAAM,MAAM,QAAQ,CAAC,CAAC;AAAA,IACjC,QAAQ,IAAI,MAAM,OAAO,QAAQ,CAAC,CAAC;AAAA,EACrC,EAAE;AAEF,QAAM,UAAU,KAAK,IAAI,GAAG,KAAK,IAAI,CAAC,MAAM,EAAE,MAAM,MAAM,GAAG,CAAC;AAC9D,QAAM,SAAS,GAAG,QAAQ,OAAO,OAAO,CAAC,KAAK,QAAQ,SAAS,EAAE,CAAC,KAAK,SAAS,SAAS,EAAE,CAAC;AAC5F,QAAM,MAAM,IAAI,OAAO,OAAO,MAAM;AAEpC,UAAQ,IAAI,MAAM;AAClB,UAAQ,IAAI,GAAG;AACf,aAAW,OAAO,MAAM;AACtB,YAAQ,IAAI,GAAG,IAAI,MAAM,OAAO,OAAO,CAAC,KAAK,IAAI,MAAM,SAAS,EAAE,CAAC,KAAK,IAAI,OAAO,SAAS,EAAE,CAAC,EAAE;AAAA,EACnG;AACF;AAEA,SAAS,UAAgB;AACvB,UAAQ,IAAI;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQZ,KAAK,CAAC;AACR;AAEA,eAAe,OAAsB;AACnC,QAAM,CAAC,EAAE,EAAE,KAAK,GAAG,IAAI,IAAI,QAAQ;AACnC,OAAK;AAEL,UAAQ,KAAK;AAAA,IACX,KAAK;AACH,YAAM,QAAQ;AACd;AAAA,IACF,KAAK;AACH,gBAAU;AACV;AAAA,IACF,KAAK;AACH,cAAQ,IAAI,sEAAsE;AAClF;AAAA,IACF,KAAK;AAAA,IACL,KAAK;AACH,cAAQ;AACR;AAAA,IACF;AACE,cAAQ,MAAM,oBAAoB,GAAG;AAAA,iCAAoC;AACzE,cAAQ,KAAK,CAAC;AAAA,EAClB;AACF;AAEA,KAAK,EAAE,MAAM,CAAC,QAAiB;AAC7B,UAAQ,MAAM,GAAG;AACjB,UAAQ,KAAK,CAAC;AAChB,CAAC;","names":["join","join"]}