@diogonzafe/tokenwatch 0.7.0 → 0.9.0

package/dist/exporters.d.cts

@@ -1,4 +1,4 @@
-import { I as IExporter, U as UsageEntry } from './index-D9xq0RNg.cjs';
+import { I as IExporter, U as UsageEntry } from './index-fD5QLTWg.cjs';
 
 interface OTelAttributes {
     [key: string]: string | number | boolean | undefined;

package/dist/exporters.d.ts

@@ -1,4 +1,4 @@
-import { I as IExporter, U as UsageEntry } from './index-D9xq0RNg.js';
+import { I as IExporter, U as UsageEntry } from './index-fD5QLTWg.js';
 
 interface OTelAttributes {
     [key: string]: string | number | boolean | undefined;

package/dist/{index-D9xq0RNg.d.cts → index-fD5QLTWg.d.cts}

@@ -41,6 +41,9 @@ interface IExporter {
 interface TrackerConfig {
     /** 'memory' (default), 'sqlite', or a custom IStorage instance (e.g. PostgresStorage, MySQLStorage, MongoStorage) */
     storage?: 'memory' | 'sqlite' | IStorage;
+    /** Tag all entries recorded by this tracker with an application identifier.
+     *  Useful when multiple apps share a single database — each tracker stamps its own appId. */
+    appId?: string;
     /** USD threshold — fires webhookUrl when totalCostUSD exceeds this */
     alertThreshold?: number;
     /** Discord / Slack / generic webhook URL */
@@ -62,6 +65,10 @@ interface TrackerConfig {
     anomalyDetection?: AnomalyDetectionConfig;
     /** Custom exporter called after every tracked call (e.g. OTelExporter) */
     exporter?: IExporter;
+    /** TokenWatch Cloud API key — mirrors every tracked call to the cloud dashboard (fire-and-forget) */
+    cloudApiKey?: string;
+    /** Override the cloud ingest endpoint (default: https://api.tokenwatch.dev/v1/ingest) */
+    cloudEndpoint?: string;
 }
 interface UsageEntry {
     model: string;
@@ -81,6 +88,8 @@ interface UsageEntry {
     userId?: string;
     /** Product feature that triggered this call (set via __feature in provider params) */
     feature?: string;
+    /** Application identifier — set once in TrackerConfig.appId and stamped on every entry */
+    appId?: string;
     timestamp: string;
 }
 interface ModelStats {
@@ -105,6 +114,10 @@ interface FeatureStats {
     costUSD: number;
     calls: number;
 }
+interface AppStats {
+    costUSD: number;
+    calls: number;
+}
 interface ReportOptions {
     /** ISO string or Date — only include entries at or after this time */
     since?: string | Date;
@@ -123,6 +136,7 @@ interface Report {
     bySession: Record<string, SessionStats>;
     byUser: Record<string, UserStats>;
     byFeature: Record<string, FeatureStats>;
+    byApp: Record<string, AppStats>;
     period: {
         from: string;
         to: string;
@@ -176,6 +190,8 @@ interface TrackingMeta {
     __userId?: string;
     /** Tag this call with a product feature name — appears in report.byFeature */
     __feature?: string;
+    /** Override the tracker-level appId for this specific call */
+    __appId?: string;
 }
 
 export type { AnomalyDetectionConfig as A, BudgetConfig as B, CostForecast as C, FeatureStats as F, IExporter as I, LazyTracker as L, ModelPrice as M, PriceMap as P, Report as R, SessionStats as S, TrackerConfig as T, UsageEntry as U, Tracker as a, TrackingMeta as b, ForecastOptions as c, IStorage as d, ModelStats as e, PricesFile as f, ReportOptions as g, UserStats as h };

package/dist/{index-D9xq0RNg.d.ts → index-fD5QLTWg.d.ts}

@@ -41,6 +41,9 @@ interface IExporter {
 interface TrackerConfig {
     /** 'memory' (default), 'sqlite', or a custom IStorage instance (e.g. PostgresStorage, MySQLStorage, MongoStorage) */
     storage?: 'memory' | 'sqlite' | IStorage;
+    /** Tag all entries recorded by this tracker with an application identifier.
+     *  Useful when multiple apps share a single database — each tracker stamps its own appId. */
+    appId?: string;
     /** USD threshold — fires webhookUrl when totalCostUSD exceeds this */
     alertThreshold?: number;
     /** Discord / Slack / generic webhook URL */
@@ -62,6 +65,10 @@ interface TrackerConfig {
     anomalyDetection?: AnomalyDetectionConfig;
     /** Custom exporter called after every tracked call (e.g. OTelExporter) */
     exporter?: IExporter;
+    /** TokenWatch Cloud API key — mirrors every tracked call to the cloud dashboard (fire-and-forget) */
+    cloudApiKey?: string;
+    /** Override the cloud ingest endpoint (default: https://api.tokenwatch.dev/v1/ingest) */
+    cloudEndpoint?: string;
 }
 interface UsageEntry {
     model: string;
@@ -81,6 +88,8 @@ interface UsageEntry {
     userId?: string;
     /** Product feature that triggered this call (set via __feature in provider params) */
     feature?: string;
+    /** Application identifier — set once in TrackerConfig.appId and stamped on every entry */
+    appId?: string;
     timestamp: string;
 }
 interface ModelStats {
@@ -105,6 +114,10 @@ interface FeatureStats {
     costUSD: number;
     calls: number;
 }
+interface AppStats {
+    costUSD: number;
+    calls: number;
+}
 interface ReportOptions {
     /** ISO string or Date — only include entries at or after this time */
     since?: string | Date;
@@ -123,6 +136,7 @@ interface Report {
     bySession: Record<string, SessionStats>;
     byUser: Record<string, UserStats>;
     byFeature: Record<string, FeatureStats>;
+    byApp: Record<string, AppStats>;
     period: {
         from: string;
         to: string;
@@ -176,6 +190,8 @@ interface TrackingMeta {
     __userId?: string;
     /** Tag this call with a product feature name — appears in report.byFeature */
     __feature?: string;
+    /** Override the tracker-level appId for this specific call */
+    __appId?: string;
 }
 
 export type { AnomalyDetectionConfig as A, BudgetConfig as B, CostForecast as C, FeatureStats as F, IExporter as I, LazyTracker as L, ModelPrice as M, PriceMap as P, Report as R, SessionStats as S, TrackerConfig as T, UsageEntry as U, Tracker as a, TrackingMeta as b, ForecastOptions as c, IStorage as d, ModelStats as e, PricesFile as f, ReportOptions as g, UserStats as h };

package/dist/index.cjs

@@ -64,6 +64,40 @@ function calculateCost(inputTokens, outputTokens, price, cachedTokens = 0, cache
   return regularInputCost + cachedReadCost + cacheCreationCost + outputCost;
 }
 
+// src/exporters/cloud.ts
+var DEFAULT_ENDPOINT = "https://api.tokenwatch.dev/v1/ingest";
+var CloudExporter = class {
+  constructor(apiKey, endpoint) {
+    this.apiKey = apiKey;
+    this.endpoint = endpoint ?? DEFAULT_ENDPOINT;
+  }
+  apiKey;
+  endpoint;
+  export(entry) {
+    fetch(this.endpoint, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${this.apiKey}`
+      },
+      body: JSON.stringify({
+        model: entry.model,
+        inputTokens: entry.inputTokens,
+        outputTokens: entry.outputTokens,
+        reasoningTokens: entry.reasoningTokens ?? 0,
+        cachedTokens: entry.cachedTokens ?? 0,
+        cacheCreationTokens: entry.cacheCreationTokens ?? 0,
+        costUSD: entry.costUSD,
+        sessionId: entry.sessionId,
+        userId: entry.userId,
+        feature: entry.feature,
+        timestamp: entry.timestamp
+      })
+    }).catch(() => {
+    });
+  }
+};
+
 // src/core/suggestions.ts
 var PROVIDER_PREFIXES = ["gpt-", "claude-", "gemini-", "deepseek-"];
 function getProviderPrefix(model) {
@@ -154,6 +188,7 @@ var SqliteStorage = class {
         session_id            TEXT,
         user_id               TEXT,
         feature               TEXT,
+        app_id                TEXT,
         timestamp             TEXT    NOT NULL
       )
     `);
@@ -170,13 +205,16 @@ var SqliteStorage = class {
     if (!cols.includes("cache_creation_tokens")) {
       this.db.exec(`ALTER TABLE usage ADD COLUMN cache_creation_tokens INTEGER NOT NULL DEFAULT 0`);
     }
+    if (!cols.includes("app_id")) {
+      this.db.exec(`ALTER TABLE usage ADD COLUMN app_id TEXT`);
+    }
   }
   record(entry) {
     this.db.prepare(
       `INSERT INTO usage
          (model, input_tokens, output_tokens, reasoning_tokens, cached_tokens, cache_creation_tokens,
-          cost_usd, session_id, user_id, feature, timestamp)
-         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`
+          cost_usd, session_id, user_id, feature, app_id, timestamp)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`
     ).run(
       entry.model,
       entry.inputTokens,
@@ -188,6 +226,7 @@ var SqliteStorage = class {
       entry.sessionId ?? null,
       entry.userId ?? null,
       entry.feature ?? null,
+      entry.appId ?? null,
       entry.timestamp
     );
   }
@@ -204,6 +243,7 @@ var SqliteStorage = class {
       ...r.session_id != null && { sessionId: r.session_id },
       ...r.user_id != null && { userId: r.user_id },
       ...r.feature != null && { feature: r.feature },
+      ...r.app_id != null && { appId: r.app_id },
       timestamp: r.timestamp
     }));
   }
@@ -269,7 +309,7 @@ async function getRemotePrices() {
 
 // prices.json
 var prices_default = {
-  updated_at: "2026-04-24",
+  updated_at: "2026-06-09",
   source: "https://raw.githubusercontent.com/BerriAI/litellm/main/model_prices_and_context_window.json",
   models: {
     "gpt-4o": {
@@ -313,14 +353,12 @@ var prices_default = {
       input: 3,
       output: 15,
       cachedInput: 0.3,
-      cacheCreationInput: 3.75,
-      maxInputTokens: 1e6
+      maxInputTokens: 2e5
     },
     "claude-haiku-4-5": {
       input: 1,
       output: 5,
       cachedInput: 0.1,
-      cacheCreationInput: 1.25,
       maxInputTokens: 2e5
     },
     "gemini-2.5-pro": {
@@ -372,7 +410,6 @@ var prices_default = {
       input: 3,
       output: 15,
       cachedInput: 0.3,
-      cacheCreationInput: 3.75,
       maxInputTokens: 2e5
     },
     "gpt-oss-120b": {
@@ -865,9 +902,9 @@ var prices_default = {
       maxInputTokens: 163840
     },
     "deepseek-r1": {
-      input: 0.55,
-      output: 2.19,
-      maxInputTokens: 65536
+      input: 1.35,
+      output: 5.4,
+      maxInputTokens: 128e3
     },
     "deepseek-v3": {
       input: 0.27,
@@ -1307,7 +1344,7 @@ var prices_default = {
     "deepseek-r1-distill-llama-70b": {
       input: 0.99,
       output: 0.99,
-      maxInputTokens: 8e3
+      maxInputTokens: 32768
     },
     "deepseek-llama3.3-70b": {
       input: 0.2,
@@ -1591,7 +1628,97 @@ var prices_default = {
       input: 5,
       output: 30,
       cachedInput: 0.5,
+      maxInputTokens: 105e4
+    },
+    "gpt-5.5-2026-04-23": {
+      input: 5,
+      output: 30,
+      cachedInput: 0.5,
+      maxInputTokens: 105e4
+    },
+    "gpt-5.5-pro": {
+      input: 30,
+      output: 180,
+      cachedInput: 3,
+      maxInputTokens: 105e4
+    },
+    "gpt-5.5-pro-2026-04-23": {
+      input: 30,
+      output: 180,
+      cachedInput: 3,
+      maxInputTokens: 105e4
+    },
+    "gpt-5.4-mini-2026-03-17": {
+      input: 0.75,
+      output: 4.5,
+      cachedInput: 0.075,
+      maxInputTokens: 272e3
+    },
+    "gpt-5.4-nano-2026-03-17": {
+      input: 0.2,
+      output: 1.25,
+      cachedInput: 0.02,
       maxInputTokens: 272e3
+    },
+    "gpt-image-2": {
+      input: 5,
+      output: 10,
+      cachedInput: 1.25
+    },
+    "gpt-image-2-2026-04-21": {
+      input: 5,
+      output: 10,
+      cachedInput: 1.25
+    },
+    "gpt-realtime-2": {
+      input: 4,
+      output: 16,
+      cachedInput: 0.4,
+      maxInputTokens: 32e3
+    },
+    "gemini-3.5-flash": {
+      input: 1.5,
+      output: 9,
+      cachedInput: 0.15,
+      maxInputTokens: 1048576
+    },
+    "gemini-3.1-flash-lite": {
+      input: 0.25,
+      output: 1.5,
+      cachedInput: 0.025,
+      maxInputTokens: 1048576
+    },
+    "claude-opus-4-8": {
+      input: 5,
+      output: 25,
+      cachedInput: 0.5,
+      cacheCreationInput: 6.25,
+      maxInputTokens: 1e6
+    },
+    "claude-opus-4-8@default": {
+      input: 5,
+      output: 25,
+      cachedInput: 0.5,
+      cacheCreationInput: 6.25,
+      maxInputTokens: 1e6
+    },
+    "claude-4-sonnet": {
+      input: 3,
+      output: 15,
+      cachedInput: 0.3,
+      maxInputTokens: 2e5
+    },
+    "claude-4-opus": {
+      input: 5,
+      output: 25,
+      cachedInput: 0.5,
+      maxInputTokens: 2e5
+    },
+    "claude-3-7-sonnet": {
+      input: 3,
+      output: 15,
+      cachedInput: 0.3,
+      maxInputTokens: 2e5
     }
   }
 };
@@ -1631,7 +1758,10 @@ var TrackerConfigSchema = import_zod.z.object({
     windowHours: import_zod.z.number().positive().optional().default(24),
     mode: import_zod.z.enum(["once", "always"]).optional().default("once")
   }).optional(),
-  exporter: import_zod.z.custom((v) => v !== null && typeof v === "object" && typeof v.export === "function").optional()
+  exporter: import_zod.z.custom((v) => v !== null && typeof v === "object" && typeof v.export === "function").optional(),
+  appId: import_zod.z.string().optional(),
+  cloudApiKey: import_zod.z.string().optional(),
+  cloudEndpoint: import_zod.z.string().url().optional()
 });
 function createTracker(config = {}) {
   const parsed = TrackerConfigSchema.safeParse(config);
@@ -1650,9 +1780,13 @@ ${issues}`);
     budgets,
     suggestions,
     anomalyDetection,
-    exporter
+    exporter,
+    appId,
+    cloudApiKey,
+    cloudEndpoint
   } = parsed.data;
   const storage = typeof storageOption === "object" ? storageOption : createStorage(storageOption);
+  const cloudExporter = cloudApiKey ? new CloudExporter(cloudApiKey, cloudEndpoint) : null;
   let remotePrices;
   let pricesUpdatedAt = bundledUpdatedAt;
   if (syncPrices) {
@@ -1705,13 +1839,17 @@ ${issues}`);
     const full = {
       ...entry,
       costUSD,
-      timestamp: (/* @__PURE__ */ new Date()).toISOString()
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      ...appId !== void 0 && entry.appId === void 0 && { appId }
     };
     storage.record(full);
     if (exporter) {
       Promise.resolve(exporter.export(full)).catch(() => {
       });
     }
+    if (cloudExporter) {
+      cloudExporter.export(full);
+    }
     maybeFireAlerts(full);
     if (anomalyDetection) maybeDetectAnomaly(full);
     if (suggestions) {
@@ -1792,6 +1930,7 @@ ${issues}`);
     const bySession = {};
     const byUser = {};
     const byFeature = {};
+    const byApp = {};
     let totalInput = 0;
     let totalOutput = 0;
     let totalCost = 0;
@@ -1828,6 +1967,11 @@ ${issues}`);
         f.costUSD += e.costUSD;
         f.calls += 1;
       }
+      if (e.appId) {
+        const a = byApp[e.appId] ??= { costUSD: 0, calls: 0 };
+        a.costUSD += e.costUSD;
+        a.calls += 1;
+      }
     }
     if (options && entries.length > 0) {
       periodFrom = entries[0]?.timestamp ?? periodFrom;
@@ -1839,6 +1983,7 @@ ${issues}`);
       bySession,
       byUser,
       byFeature,
+      byApp,
       period: { from: periodFrom, to: lastTimestamp },
       ...pricesUpdatedAt ? { pricesUpdatedAt } : {}
     };
@@ -1943,7 +2088,7 @@ ${issues}`);
   }
   async function exportCSV() {
     const entries = await Promise.resolve(storage.getAll());
-    const header = "timestamp,model,inputTokens,outputTokens,reasoningTokens,cachedTokens,cacheCreationTokens,costUSD,sessionId,userId,feature";
+    const header = "timestamp,model,inputTokens,outputTokens,reasoningTokens,cachedTokens,cacheCreationTokens,costUSD,sessionId,userId,feature,appId";
     const rows = entries.map(
       (e) => [
         csvEscape(e.timestamp),
@@ -1956,7 +2101,8 @@ ${issues}`);
         e.costUSD.toFixed(8),
         csvEscape(e.sessionId ?? ""),
         csvEscape(e.userId ?? ""),
-        csvEscape(e.feature ?? "")
+        csvEscape(e.feature ?? ""),
+        csvEscape(e.appId ?? "")
       ].join(",")
     );
     return [header, ...rows].join("\n");
@@ -2017,7 +2163,7 @@ function csvEscape(value) {
 }
 
 // src/core/lazy-tracker.ts
-var CSV_HEADER = "timestamp,model,inputTokens,outputTokens,reasoningTokens,cachedTokens,cacheCreationTokens,costUSD,sessionId,userId,feature";
+var CSV_HEADER = "timestamp,model,inputTokens,outputTokens,reasoningTokens,cachedTokens,cacheCreationTokens,costUSD,sessionId,userId,feature,appId";
 function emptyReport() {
   const now = (/* @__PURE__ */ new Date()).toISOString();
   return {
@@ -2027,6 +2173,7 @@ function emptyReport() {
     bySession: {},
     byUser: {},
     byFeature: {},
+    byApp: {},
     period: { from: now, to: now }
   };
 }