@diogonzafe/tokenwatch 0.2.1 → 0.5.0

package/dist/index.d.cts

@@ -1,8 +1,25 @@
-import { T as TrackerConfig, a as Tracker, b as TrackingMeta } from './index-B_EmA3K7.cjs';
-export { F as FeatureStats, I as IStorage, M as ModelPrice, c as ModelStats, P as PriceMap, d as PricesFile, R as Report, S as SessionStats, U as UsageEntry, e as UserStats } from './index-B_EmA3K7.cjs';
+import { T as TrackerConfig, a as Tracker, L as LazyTracker, b as TrackingMeta } from './index-CJKk1hHw.cjs';
+export { B as BudgetConfig, C as CostForecast, F as FeatureStats, c as ForecastOptions, I as IStorage, M as ModelPrice, d as ModelStats, P as PriceMap, e as PricesFile, R as Report, f as ReportOptions, S as SessionStats, U as UsageEntry, g as UserStats } from './index-CJKk1hHw.cjs';
 
 declare function createTracker(config?: TrackerConfig): Tracker;
 
+/**
+ * Creates a lazy tracker that acts as a silent no-op until `init()` is called.
+ *
+ * Ideal for module-level singletons where the tracker is imported before `createTracker()`
+ * can be called (e.g. Jest test environments, top-level module imports).
+ *
+ * @example
+ * // tracker.ts — safe to import anywhere, even before init
+ * export const tracker = createLazyTracker()
+ *
+ * // app.ts — initialize once at startup
+ * tracker.init({ storage: 'sqlite', syncPrices: true })
+ *
+ * // test.ts — never call init() and track() becomes a silent no-op
+ */
+declare function createLazyTracker(): LazyTracker;
+
 interface CompletionsLike {
     create(params: Record<string, unknown>): Promise<unknown>;
 }
@@ -98,4 +115,4 @@ interface GenAILike {
  */
 declare function wrapGemini<T extends GenAILike>(client: T, tracker: Tracker): T;
 
-export { Tracker, TrackerConfig, TrackingMeta, createTracker, wrapAnthropic, wrapOpenAI as wrapDeepSeek, wrapGemini, wrapOpenAI };
+export { LazyTracker, Tracker, TrackerConfig, TrackingMeta, createLazyTracker, createTracker, wrapAnthropic, wrapOpenAI as wrapDeepSeek, wrapGemini, wrapOpenAI };

package/dist/index.d.ts

@@ -1,8 +1,25 @@
-import { T as TrackerConfig, a as Tracker, b as TrackingMeta } from './index-B_EmA3K7.js';
-export { F as FeatureStats, I as IStorage, M as ModelPrice, c as ModelStats, P as PriceMap, d as PricesFile, R as Report, S as SessionStats, U as UsageEntry, e as UserStats } from './index-B_EmA3K7.js';
+import { T as TrackerConfig, a as Tracker, L as LazyTracker, b as TrackingMeta } from './index-CJKk1hHw.js';
+export { B as BudgetConfig, C as CostForecast, F as FeatureStats, c as ForecastOptions, I as IStorage, M as ModelPrice, d as ModelStats, P as PriceMap, e as PricesFile, R as Report, f as ReportOptions, S as SessionStats, U as UsageEntry, g as UserStats } from './index-CJKk1hHw.js';
 
 declare function createTracker(config?: TrackerConfig): Tracker;
 
+/**
+ * Creates a lazy tracker that acts as a silent no-op until `init()` is called.
+ *
+ * Ideal for module-level singletons where the tracker is imported before `createTracker()`
+ * can be called (e.g. Jest test environments, top-level module imports).
+ *
+ * @example
+ * // tracker.ts — safe to import anywhere, even before init
+ * export const tracker = createLazyTracker()
+ *
+ * // app.ts — initialize once at startup
+ * tracker.init({ storage: 'sqlite', syncPrices: true })
+ *
+ * // test.ts — never call init() and track() becomes a silent no-op
+ */
+declare function createLazyTracker(): LazyTracker;
+
 interface CompletionsLike {
     create(params: Record<string, unknown>): Promise<unknown>;
 }
@@ -98,4 +115,4 @@ interface GenAILike {
  */
 declare function wrapGemini<T extends GenAILike>(client: T, tracker: Tracker): T;
 
-export { Tracker, TrackerConfig, TrackingMeta, createTracker, wrapAnthropic, wrapOpenAI as wrapDeepSeek, wrapGemini, wrapOpenAI };
+export { LazyTracker, Tracker, TrackerConfig, TrackingMeta, createLazyTracker, createTracker, wrapAnthropic, wrapOpenAI as wrapDeepSeek, wrapGemini, wrapOpenAI };