@contractspec/lib.cost-tracking 1.57.0 → 1.59.0

package/dist/browser/index.js

@@ -0,0 +1,163 @@
+// src/cost-model.ts
+var defaultCostModel = {
+  dbReadCost: 0.000002,
+  dbWriteCost: 0.00001,
+  computeMsCost: 0.00000015,
+  memoryMbMsCost: 0.00000002
+};
+function calculateSampleCost(sample, model) {
+  const external = (sample.externalCalls ?? []).reduce((sum, call) => sum + (call.cost ?? 0), 0);
+  return {
+    dbReads: (sample.dbReads ?? 0) * model.dbReadCost,
+    dbWrites: (sample.dbWrites ?? 0) * model.dbWriteCost,
+    compute: (sample.computeMs ?? 0) * model.computeMsCost,
+    memory: (sample.memoryMbMs ?? 0) * model.memoryMbMsCost,
+    external,
+    custom: sample.customCost ?? 0
+  };
+}
+// src/cost-tracker.ts
+class CostTracker {
+  options;
+  totals = new Map;
+  costModel;
+  constructor(options = {}) {
+    this.options = options;
+    this.costModel = options.costModel ?? defaultCostModel;
+  }
+  recordSample(sample) {
+    const breakdown = calculateSampleCost(sample, this.costModel);
+    const total = breakdown.dbReads + breakdown.dbWrites + breakdown.compute + breakdown.memory + breakdown.external + breakdown.custom;
+    const key = this.buildKey(sample.operation, sample.tenantId);
+    const existing = this.totals.get(key);
+    const summary = existing ? {
+      ...existing,
+      total: existing.total + total,
+      breakdown: {
+        dbReads: existing.breakdown.dbReads + breakdown.dbReads,
+        dbWrites: existing.breakdown.dbWrites + breakdown.dbWrites,
+        compute: existing.breakdown.compute + breakdown.compute,
+        memory: existing.breakdown.memory + breakdown.memory,
+        external: existing.breakdown.external + breakdown.external,
+        custom: existing.breakdown.custom + breakdown.custom
+      },
+      samples: existing.samples + 1
+    } : {
+      operation: sample.operation,
+      tenantId: sample.tenantId,
+      total,
+      breakdown: {
+        dbReads: breakdown.dbReads,
+        dbWrites: breakdown.dbWrites,
+        compute: breakdown.compute,
+        memory: breakdown.memory,
+        external: breakdown.external,
+        custom: breakdown.custom
+      },
+      samples: 1
+    };
+    this.totals.set(key, summary);
+    this.options.onSampleRecorded?.(sample, total);
+    return summary;
+  }
+  getTotals(filter) {
+    const items = Array.from(this.totals.values());
+    if (!filter?.tenantId) {
+      return items;
+    }
+    return items.filter((item) => item.tenantId === filter.tenantId);
+  }
+  reset() {
+    this.totals.clear();
+  }
+  buildKey(operation, tenantId) {
+    return tenantId ? `${tenantId}:${operation}` : operation;
+  }
+}
+// src/budget-alert-manager.ts
+class BudgetAlertManager {
+  options;
+  limits = new Map;
+  spend = new Map;
+  constructor(options) {
+    this.options = options;
+    for (const budget of options.budgets) {
+      this.limits.set(budget.tenantId, budget);
+      this.spend.set(budget.tenantId, 0);
+    }
+  }
+  track(summary) {
+    if (!summary.tenantId) {
+      return;
+    }
+    const current = (this.spend.get(summary.tenantId) ?? 0) + summary.total;
+    this.spend.set(summary.tenantId, current);
+    const budget = this.limits.get(summary.tenantId);
+    if (!budget) {
+      return;
+    }
+    const threshold = budget.alertThreshold ?? 0.8;
+    if (current >= budget.monthlyLimit * threshold) {
+      this.options.onAlert?.({
+        tenantId: summary.tenantId,
+        limit: budget.monthlyLimit,
+        total: current,
+        summary
+      });
+    }
+  }
+  getSpend(tenantId) {
+    return this.spend.get(tenantId) ?? 0;
+  }
+}
+// src/optimization-recommender.ts
+class OptimizationRecommender {
+  generate(summary) {
+    const suggestions = [];
+    const avgCost = summary.total / summary.samples;
+    if (summary.breakdown.dbReads / summary.samples > 1000) {
+      suggestions.push({
+        operation: summary.operation,
+        tenantId: summary.tenantId,
+        category: "n_plus_one",
+        message: "High average DB read count detected. Consider batching queries or adding pagination.",
+        evidence: { avgReads: summary.breakdown.dbReads / summary.samples }
+      });
+    }
+    if (summary.breakdown.compute / summary.total > 0.6) {
+      suggestions.push({
+        operation: summary.operation,
+        tenantId: summary.tenantId,
+        category: "batching",
+        message: "Compute dominates cost. Investigate hot loops or move heavy logic to background jobs.",
+        evidence: { computeShare: summary.breakdown.compute / summary.total }
+      });
+    }
+    if (summary.breakdown.external > avgCost * 0.5) {
+      suggestions.push({
+        operation: summary.operation,
+        tenantId: summary.tenantId,
+        category: "external",
+        message: "External provider spend is high. Reuse results or enable caching.",
+        evidence: { externalCost: summary.breakdown.external }
+      });
+    }
+    if (summary.breakdown.memory > summary.breakdown.compute * 1.2) {
+      suggestions.push({
+        operation: summary.operation,
+        tenantId: summary.tenantId,
+        category: "caching",
+        message: "Memory utilization suggests cached payloads linger. Tune TTL or stream responses.",
+        evidence: { memoryCost: summary.breakdown.memory }
+      });
+    }
+    return suggestions;
+  }
+}
+export {
+  defaultCostModel,
+  calculateSampleCost,
+  OptimizationRecommender,
+  CostTracker,
+  BudgetAlertManager
+};

package/dist/budget-alert-manager.d.ts

@@ -1,23 +1,19 @@
-import { OperationCostSummary, TenantBudget } from "./types.js";
-
-//#region src/budget-alert-manager.d.ts
-interface BudgetAlertManagerOptions {
-  budgets: TenantBudget[];
-  onAlert?: (payload: {
-    tenantId: string;
-    limit: number;
-    total: number;
-    summary: OperationCostSummary;
-  }) => void;
+import type { OperationCostSummary, TenantBudget } from './types';
+export interface BudgetAlertManagerOptions {
+    budgets: TenantBudget[];
+    onAlert?: (payload: {
+        tenantId: string;
+        limit: number;
+        total: number;
+        summary: OperationCostSummary;
+    }) => void;
 }
-declare class BudgetAlertManager {
-  private readonly options;
-  private readonly limits;
-  private readonly spend;
-  constructor(options: BudgetAlertManagerOptions);
-  track(summary: OperationCostSummary): void;
-  getSpend(tenantId: string): number;
+export declare class BudgetAlertManager {
+    private readonly options;
+    private readonly limits;
+    private readonly spend;
+    constructor(options: BudgetAlertManagerOptions);
+    track(summary: OperationCostSummary): void;
+    getSpend(tenantId: string): number;
 }
-//#endregion
-export { BudgetAlertManager, BudgetAlertManagerOptions };
 //# sourceMappingURL=budget-alert-manager.d.ts.map

package/dist/budget-alert-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"budget-alert-manager.d.ts","names":[],"sources":["../src/budget-alert-manager.ts"],"mappings":";;;UAEiB,yBAAA;EACf,OAAA,EAAS,YAAA;EACT,OAAA,IAAW,OAAA;IACT,QAAA;IACA,KAAA;IACA,KAAA;IACA,OAAA,EAAS,oBAAA;EAAA;AAAA;AAAA,cAIA,kBAAA;EAAA,iBAIkB,OAAA;EAAA,iBAHZ,MAAA;EAAA,iBACA,KAAA;cAEY,OAAA,EAAS,yBAAA;EAOtC,KAAA,CAAM,OAAA,EAAS,oBAAA;EAwBf,QAAA,CAAS,QAAA;AAAA"}
+{"version":3,"file":"budget-alert-manager.d.ts","sourceRoot":"","sources":["../src/budget-alert-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAElE,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,oBAAoB,CAAC;KAC/B,KAAK,IAAI,CAAC;CACZ;AAED,qBAAa,kBAAkB;IAIjB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmC;IAC1D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA6B;gBAEtB,OAAO,EAAE,yBAAyB;IAO/D,KAAK,CAAC,OAAO,EAAE,oBAAoB;IAwBnC,QAAQ,CAAC,QAAQ,EAAE,MAAM;CAG1B"}

package/dist/cost-model.d.ts

@@ -1,15 +1,11 @@
-import { CostModel, CostSample } from "./types.js";
-
-//#region src/cost-model.d.ts
-declare const defaultCostModel: CostModel;
-declare function calculateSampleCost(sample: CostSample, model: CostModel): {
-  dbReads: number;
-  dbWrites: number;
-  compute: number;
-  memory: number;
-  external: number;
-  custom: number;
+import type { CostModel, CostSample } from './types';
+export declare const defaultCostModel: CostModel;
+export declare function calculateSampleCost(sample: CostSample, model: CostModel): {
+    dbReads: number;
+    dbWrites: number;
+    compute: number;
+    memory: number;
+    external: number;
+    custom: number;
 };
-//#endregion
-export { calculateSampleCost, defaultCostModel };
 //# sourceMappingURL=cost-model.d.ts.map

package/dist/cost-model.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cost-model.d.ts","names":[],"sources":["../src/cost-model.ts"],"mappings":";;;cAEa,gBAAA,EAAkB,SAAA;AAAA,iBAOf,mBAAA,CAAoB,MAAA,EAAQ,UAAA,EAAY,KAAA,EAAO,SAAA"}
+{"version":3,"file":"cost-model.d.ts","sourceRoot":"","sources":["../src/cost-model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErD,eAAO,MAAM,gBAAgB,EAAE,SAK9B,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS;;;;;;;EAcvE"}

package/dist/cost-tracker.d.ts

@@ -1,22 +1,18 @@
-import { CostModel, CostSample, OperationCostSummary } from "./types.js";
-
-//#region src/cost-tracker.d.ts
-interface CostTrackerOptions {
-  costModel?: CostModel;
-  onSampleRecorded?: (sample: CostSample, total: number) => void;
+import type { CostModel, CostSample, OperationCostSummary } from './types';
+export interface CostTrackerOptions {
+    costModel?: CostModel;
+    onSampleRecorded?: (sample: CostSample, total: number) => void;
 }
-declare class CostTracker {
-  private readonly options;
-  private readonly totals;
-  private readonly costModel;
-  constructor(options?: CostTrackerOptions);
-  recordSample(sample: CostSample): OperationCostSummary;
-  getTotals(filter?: {
-    tenantId?: string;
-  }): OperationCostSummary[];
-  reset(): void;
-  private buildKey;
+export declare class CostTracker {
+    private readonly options;
+    private readonly totals;
+    private readonly costModel;
+    constructor(options?: CostTrackerOptions);
+    recordSample(sample: CostSample): OperationCostSummary;
+    getTotals(filter?: {
+        tenantId?: string;
+    }): OperationCostSummary[];
+    reset(): void;
+    private buildKey;
 }
-//#endregion
-export { CostTracker, CostTrackerOptions };
 //# sourceMappingURL=cost-tracker.d.ts.map

package/dist/cost-tracker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cost-tracker.d.ts","names":[],"sources":["../src/cost-tracker.ts"],"mappings":";;;UAGiB,kBAAA;EACf,SAAA,GAAY,SAAA;EACZ,gBAAA,IAAoB,MAAA,EAAQ,UAAA,EAAY,KAAA;AAAA;AAAA,cAG7B,WAAA;EAAA,iBAIkB,OAAA;EAAA,iBAHZ,MAAA;EAAA,iBACA,SAAA;cAEY,OAAA,GAAS,kBAAA;EAItC,YAAA,CAAa,MAAA,EAAQ,UAAA,GAAa,oBAAA;EA+ClC,SAAA,CAAU,MAAA;IAAW,QAAA;EAAA,IAAmB,oBAAA;EAQxC,KAAA,CAAA;EAAA,QAIQ,QAAA;AAAA"}
+{"version":3,"file":"cost-tracker.d.ts","sourceRoot":"","sources":["../src/cost-tracker.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAE3E,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CAChE;AAED,qBAAa,WAAW;IAIV,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2C;IAClE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;gBAET,OAAO,GAAE,kBAAuB;IAI7D,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,oBAAoB;IA+CtD,SAAS,CAAC,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE;IAQxC,KAAK;IAIL,OAAO,CAAC,QAAQ;CAGjB"}

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-import { BudgetAlert, CostModel, CostSample, ExternalCallCost, OperationCostSummary, OptimizationSuggestion, TenantBudget } from "./types.js";
-import { calculateSampleCost, defaultCostModel } from "./cost-model.js";
-import { CostTracker, CostTrackerOptions } from "./cost-tracker.js";
-import { BudgetAlertManager, BudgetAlertManagerOptions } from "./budget-alert-manager.js";
-import { OptimizationRecommender } from "./optimization-recommender.js";
-export { BudgetAlert, BudgetAlertManager, BudgetAlertManagerOptions, CostModel, CostSample, CostTracker, CostTrackerOptions, ExternalCallCost, OperationCostSummary, OptimizationRecommender, OptimizationSuggestion, TenantBudget, calculateSampleCost, defaultCostModel };
+export * from './types';
+export * from './cost-model';
+export * from './cost-tracker';
+export * from './budget-alert-manager';
+export * from './optimization-recommender';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC"}

package/dist/index.js

@@ -1,6 +1,164 @@
-import { calculateSampleCost, defaultCostModel } from "./cost-model.js";
-import { CostTracker } from "./cost-tracker.js";
-import { BudgetAlertManager } from "./budget-alert-manager.js";
-import { OptimizationRecommender } from "./optimization-recommender.js";
-
-export { BudgetAlertManager, CostTracker, OptimizationRecommender, calculateSampleCost, defaultCostModel };
+// @bun
+// src/cost-model.ts
+var defaultCostModel = {
+  dbReadCost: 0.000002,
+  dbWriteCost: 0.00001,
+  computeMsCost: 0.00000015,
+  memoryMbMsCost: 0.00000002
+};
+function calculateSampleCost(sample, model) {
+  const external = (sample.externalCalls ?? []).reduce((sum, call) => sum + (call.cost ?? 0), 0);
+  return {
+    dbReads: (sample.dbReads ?? 0) * model.dbReadCost,
+    dbWrites: (sample.dbWrites ?? 0) * model.dbWriteCost,
+    compute: (sample.computeMs ?? 0) * model.computeMsCost,
+    memory: (sample.memoryMbMs ?? 0) * model.memoryMbMsCost,
+    external,
+    custom: sample.customCost ?? 0
+  };
+}
+// src/cost-tracker.ts
+class CostTracker {
+  options;
+  totals = new Map;
+  costModel;
+  constructor(options = {}) {
+    this.options = options;
+    this.costModel = options.costModel ?? defaultCostModel;
+  }
+  recordSample(sample) {
+    const breakdown = calculateSampleCost(sample, this.costModel);
+    const total = breakdown.dbReads + breakdown.dbWrites + breakdown.compute + breakdown.memory + breakdown.external + breakdown.custom;
+    const key = this.buildKey(sample.operation, sample.tenantId);
+    const existing = this.totals.get(key);
+    const summary = existing ? {
+      ...existing,
+      total: existing.total + total,
+      breakdown: {
+        dbReads: existing.breakdown.dbReads + breakdown.dbReads,
+        dbWrites: existing.breakdown.dbWrites + breakdown.dbWrites,
+        compute: existing.breakdown.compute + breakdown.compute,
+        memory: existing.breakdown.memory + breakdown.memory,
+        external: existing.breakdown.external + breakdown.external,
+        custom: existing.breakdown.custom + breakdown.custom
+      },
+      samples: existing.samples + 1
+    } : {
+      operation: sample.operation,
+      tenantId: sample.tenantId,
+      total,
+      breakdown: {
+        dbReads: breakdown.dbReads,
+        dbWrites: breakdown.dbWrites,
+        compute: breakdown.compute,
+        memory: breakdown.memory,
+        external: breakdown.external,
+        custom: breakdown.custom
+      },
+      samples: 1
+    };
+    this.totals.set(key, summary);
+    this.options.onSampleRecorded?.(sample, total);
+    return summary;
+  }
+  getTotals(filter) {
+    const items = Array.from(this.totals.values());
+    if (!filter?.tenantId) {
+      return items;
+    }
+    return items.filter((item) => item.tenantId === filter.tenantId);
+  }
+  reset() {
+    this.totals.clear();
+  }
+  buildKey(operation, tenantId) {
+    return tenantId ? `${tenantId}:${operation}` : operation;
+  }
+}
+// src/budget-alert-manager.ts
+class BudgetAlertManager {
+  options;
+  limits = new Map;
+  spend = new Map;
+  constructor(options) {
+    this.options = options;
+    for (const budget of options.budgets) {
+      this.limits.set(budget.tenantId, budget);
+      this.spend.set(budget.tenantId, 0);
+    }
+  }
+  track(summary) {
+    if (!summary.tenantId) {
+      return;
+    }
+    const current = (this.spend.get(summary.tenantId) ?? 0) + summary.total;
+    this.spend.set(summary.tenantId, current);
+    const budget = this.limits.get(summary.tenantId);
+    if (!budget) {
+      return;
+    }
+    const threshold = budget.alertThreshold ?? 0.8;
+    if (current >= budget.monthlyLimit * threshold) {
+      this.options.onAlert?.({
+        tenantId: summary.tenantId,
+        limit: budget.monthlyLimit,
+        total: current,
+        summary
+      });
+    }
+  }
+  getSpend(tenantId) {
+    return this.spend.get(tenantId) ?? 0;
+  }
+}
+// src/optimization-recommender.ts
+class OptimizationRecommender {
+  generate(summary) {
+    const suggestions = [];
+    const avgCost = summary.total / summary.samples;
+    if (summary.breakdown.dbReads / summary.samples > 1000) {
+      suggestions.push({
+        operation: summary.operation,
+        tenantId: summary.tenantId,
+        category: "n_plus_one",
+        message: "High average DB read count detected. Consider batching queries or adding pagination.",
+        evidence: { avgReads: summary.breakdown.dbReads / summary.samples }
+      });
+    }
+    if (summary.breakdown.compute / summary.total > 0.6) {
+      suggestions.push({
+        operation: summary.operation,
+        tenantId: summary.tenantId,
+        category: "batching",
+        message: "Compute dominates cost. Investigate hot loops or move heavy logic to background jobs.",
+        evidence: { computeShare: summary.breakdown.compute / summary.total }
+      });
+    }
+    if (summary.breakdown.external > avgCost * 0.5) {
+      suggestions.push({
+        operation: summary.operation,
+        tenantId: summary.tenantId,
+        category: "external",
+        message: "External provider spend is high. Reuse results or enable caching.",
+        evidence: { externalCost: summary.breakdown.external }
+      });
+    }
+    if (summary.breakdown.memory > summary.breakdown.compute * 1.2) {
+      suggestions.push({
+        operation: summary.operation,
+        tenantId: summary.tenantId,
+        category: "caching",
+        message: "Memory utilization suggests cached payloads linger. Tune TTL or stream responses.",
+        evidence: { memoryCost: summary.breakdown.memory }
+      });
+    }
+    return suggestions;
+  }
+}
+export {
+  defaultCostModel,
+  calculateSampleCost,
+  OptimizationRecommender,
+  CostTracker,
+  BudgetAlertManager
+};

package/dist/node/index.js

@@ -0,0 +1,163 @@
+// src/cost-model.ts
+var defaultCostModel = {
+  dbReadCost: 0.000002,
+  dbWriteCost: 0.00001,
+  computeMsCost: 0.00000015,
+  memoryMbMsCost: 0.00000002
+};
+function calculateSampleCost(sample, model) {
+  const external = (sample.externalCalls ?? []).reduce((sum, call) => sum + (call.cost ?? 0), 0);
+  return {
+    dbReads: (sample.dbReads ?? 0) * model.dbReadCost,
+    dbWrites: (sample.dbWrites ?? 0) * model.dbWriteCost,
+    compute: (sample.computeMs ?? 0) * model.computeMsCost,
+    memory: (sample.memoryMbMs ?? 0) * model.memoryMbMsCost,
+    external,
+    custom: sample.customCost ?? 0
+  };
+}
+// src/cost-tracker.ts
+class CostTracker {
+  options;
+  totals = new Map;
+  costModel;
+  constructor(options = {}) {
+    this.options = options;
+    this.costModel = options.costModel ?? defaultCostModel;
+  }
+  recordSample(sample) {
+    const breakdown = calculateSampleCost(sample, this.costModel);
+    const total = breakdown.dbReads + breakdown.dbWrites + breakdown.compute + breakdown.memory + breakdown.external + breakdown.custom;
+    const key = this.buildKey(sample.operation, sample.tenantId);
+    const existing = this.totals.get(key);
+    const summary = existing ? {
+      ...existing,
+      total: existing.total + total,
+      breakdown: {
+        dbReads: existing.breakdown.dbReads + breakdown.dbReads,
+        dbWrites: existing.breakdown.dbWrites + breakdown.dbWrites,
+        compute: existing.breakdown.compute + breakdown.compute,
+        memory: existing.breakdown.memory + breakdown.memory,
+        external: existing.breakdown.external + breakdown.external,
+        custom: existing.breakdown.custom + breakdown.custom
+      },
+      samples: existing.samples + 1
+    } : {
+      operation: sample.operation,
+      tenantId: sample.tenantId,
+      total,
+      breakdown: {
+        dbReads: breakdown.dbReads,
+        dbWrites: breakdown.dbWrites,
+        compute: breakdown.compute,
+        memory: breakdown.memory,
+        external: breakdown.external,
+        custom: breakdown.custom
+      },
+      samples: 1
+    };
+    this.totals.set(key, summary);
+    this.options.onSampleRecorded?.(sample, total);
+    return summary;
+  }
+  getTotals(filter) {
+    const items = Array.from(this.totals.values());
+    if (!filter?.tenantId) {
+      return items;
+    }
+    return items.filter((item) => item.tenantId === filter.tenantId);
+  }
+  reset() {
+    this.totals.clear();
+  }
+  buildKey(operation, tenantId) {
+    return tenantId ? `${tenantId}:${operation}` : operation;
+  }
+}
+// src/budget-alert-manager.ts
+class BudgetAlertManager {
+  options;
+  limits = new Map;
+  spend = new Map;
+  constructor(options) {
+    this.options = options;
+    for (const budget of options.budgets) {
+      this.limits.set(budget.tenantId, budget);
+      this.spend.set(budget.tenantId, 0);
+    }
+  }
+  track(summary) {
+    if (!summary.tenantId) {
+      return;
+    }
+    const current = (this.spend.get(summary.tenantId) ?? 0) + summary.total;
+    this.spend.set(summary.tenantId, current);
+    const budget = this.limits.get(summary.tenantId);
+    if (!budget) {
+      return;
+    }
+    const threshold = budget.alertThreshold ?? 0.8;
+    if (current >= budget.monthlyLimit * threshold) {
+      this.options.onAlert?.({
+        tenantId: summary.tenantId,
+        limit: budget.monthlyLimit,
+        total: current,
+        summary
+      });
+    }
+  }
+  getSpend(tenantId) {
+    return this.spend.get(tenantId) ?? 0;
+  }
+}
+// src/optimization-recommender.ts
+class OptimizationRecommender {
+  generate(summary) {
+    const suggestions = [];
+    const avgCost = summary.total / summary.samples;
+    if (summary.breakdown.dbReads / summary.samples > 1000) {
+      suggestions.push({
+        operation: summary.operation,
+        tenantId: summary.tenantId,
+        category: "n_plus_one",
+        message: "High average DB read count detected. Consider batching queries or adding pagination.",
+        evidence: { avgReads: summary.breakdown.dbReads / summary.samples }
+      });
+    }
+    if (summary.breakdown.compute / summary.total > 0.6) {
+      suggestions.push({
+        operation: summary.operation,
+        tenantId: summary.tenantId,
+        category: "batching",
+        message: "Compute dominates cost. Investigate hot loops or move heavy logic to background jobs.",
+        evidence: { computeShare: summary.breakdown.compute / summary.total }
+      });
+    }
+    if (summary.breakdown.external > avgCost * 0.5) {
+      suggestions.push({
+        operation: summary.operation,
+        tenantId: summary.tenantId,
+        category: "external",
+        message: "External provider spend is high. Reuse results or enable caching.",
+        evidence: { externalCost: summary.breakdown.external }
+      });
+    }
+    if (summary.breakdown.memory > summary.breakdown.compute * 1.2) {
+      suggestions.push({
+        operation: summary.operation,
+        tenantId: summary.tenantId,
+        category: "caching",
+        message: "Memory utilization suggests cached payloads linger. Tune TTL or stream responses.",
+        evidence: { memoryCost: summary.breakdown.memory }
+      });
+    }
+    return suggestions;
+  }
+}
+export {
+  defaultCostModel,
+  calculateSampleCost,
+  OptimizationRecommender,
+  CostTracker,
+  BudgetAlertManager
+};

package/dist/optimization-recommender.d.ts

@@ -1,9 +1,5 @@
-import { OperationCostSummary, OptimizationSuggestion } from "./types.js";
-
-//#region src/optimization-recommender.d.ts
-declare class OptimizationRecommender {
-  generate(summary: OperationCostSummary): OptimizationSuggestion[];
+import type { OperationCostSummary, OptimizationSuggestion } from './types';
+export declare class OptimizationRecommender {
+    generate(summary: OperationCostSummary): OptimizationSuggestion[];
 }
-//#endregion
-export { OptimizationRecommender };
 //# sourceMappingURL=optimization-recommender.d.ts.map

package/dist/optimization-recommender.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"optimization-recommender.d.ts","names":[],"sources":["../src/optimization-recommender.ts"],"mappings":";;;cAEa,uBAAA;EACX,QAAA,CAAS,OAAA,EAAS,oBAAA,GAAuB,sBAAA;AAAA"}
+{"version":3,"file":"optimization-recommender.d.ts","sourceRoot":"","sources":["../src/optimization-recommender.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAE5E,qBAAa,uBAAuB;IAClC,QAAQ,CAAC,OAAO,EAAE,oBAAoB,GAAG,sBAAsB,EAAE;CAkDlE"}

package/dist/types.d.ts

@@ -1,63 +1,60 @@
-//#region src/types.d.ts
-interface ExternalCallCost {
-  provider: string;
-  cost?: number;
-  durationMs?: number;
-  requestCount?: number;
+export interface ExternalCallCost {
+    provider: string;
+    cost?: number;
+    durationMs?: number;
+    requestCount?: number;
 }
-interface CostSample {
-  operation: string;
-  tenantId?: string;
-  environment?: 'dev' | 'staging' | 'prod';
-  dbReads?: number;
-  dbWrites?: number;
-  computeMs?: number;
-  memoryMbMs?: number;
-  externalCalls?: ExternalCallCost[];
-  customCost?: number;
-  timestamp?: Date;
-  metadata?: Record<string, unknown>;
+export interface CostSample {
+    operation: string;
+    tenantId?: string;
+    environment?: 'dev' | 'staging' | 'prod';
+    dbReads?: number;
+    dbWrites?: number;
+    computeMs?: number;
+    memoryMbMs?: number;
+    externalCalls?: ExternalCallCost[];
+    customCost?: number;
+    timestamp?: Date;
+    metadata?: Record<string, unknown>;
 }
-interface CostModel {
-  dbReadCost: number;
-  dbWriteCost: number;
-  computeMsCost: number;
-  memoryMbMsCost: number;
+export interface CostModel {
+    dbReadCost: number;
+    dbWriteCost: number;
+    computeMsCost: number;
+    memoryMbMsCost: number;
 }
-interface OperationCostSummary {
-  operation: string;
-  tenantId?: string;
-  total: number;
-  breakdown: {
-    dbReads: number;
-    dbWrites: number;
-    compute: number;
-    memory: number;
-    external: number;
-    custom: number;
-  };
-  samples: number;
+export interface OperationCostSummary {
+    operation: string;
+    tenantId?: string;
+    total: number;
+    breakdown: {
+        dbReads: number;
+        dbWrites: number;
+        compute: number;
+        memory: number;
+        external: number;
+        custom: number;
+    };
+    samples: number;
 }
-interface TenantBudget {
-  tenantId: string;
-  monthlyLimit: number;
-  currency?: string;
-  alertThreshold?: number;
-  currentSpend?: number;
+export interface TenantBudget {
+    tenantId: string;
+    monthlyLimit: number;
+    currency?: string;
+    alertThreshold?: number;
+    currentSpend?: number;
 }
-interface OptimizationSuggestion {
-  operation: string;
-  tenantId?: string;
-  category: 'n_plus_one' | 'caching' | 'batching' | 'external';
-  message: string;
-  evidence: Record<string, unknown>;
+export interface OptimizationSuggestion {
+    operation: string;
+    tenantId?: string;
+    category: 'n_plus_one' | 'caching' | 'batching' | 'external';
+    message: string;
+    evidence: Record<string, unknown>;
 }
-interface BudgetAlert {
-  tenantId: string;
-  limit: number;
-  actual: number;
-  triggeredAt: Date;
+export interface BudgetAlert {
+    tenantId: string;
+    limit: number;
+    actual: number;
+    triggeredAt: Date;
 }
-//#endregion
-export { BudgetAlert, CostModel, CostSample, ExternalCallCost, OperationCostSummary, OptimizationSuggestion, TenantBudget };
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","names":[],"sources":["../src/types.ts"],"mappings":";UAAiB,gBAAA;EACf,QAAA;EACA,IAAA;EACA,UAAA;EACA,YAAA;AAAA;AAAA,UAGe,UAAA;EACf,SAAA;EACA,QAAA;EACA,WAAA;EACA,OAAA;EACA,QAAA;EACA,SAAA;EACA,UAAA;EACA,aAAA,GAAgB,gBAAA;EAChB,UAAA;EACA,SAAA,GAAY,IAAA;EACZ,QAAA,GAAW,MAAA;AAAA;AAAA,UAGI,SAAA;EACf,UAAA;EACA,WAAA;EACA,aAAA;EACA,cAAA;AAAA;AAAA,UAGe,oBAAA;EACf,SAAA;EACA,QAAA;EACA,KAAA;EACA,SAAA;IACE,OAAA;IACA,QAAA;IACA,OAAA;IACA,MAAA;IACA,QAAA;IACA,MAAA;EAAA;EAEF,OAAA;AAAA;AAAA,UAGe,YAAA;EACf,QAAA;EACA,YAAA;EACA,QAAA;EACA,cAAA;EACA,YAAA;AAAA;AAAA,UAGe,sBAAA;EACf,SAAA;EACA,QAAA;EACA,QAAA;EACA,OAAA;EACA,QAAA,EAAU,MAAA;AAAA;AAAA,UAGK,WAAA;EACf,QAAA;EACA,KAAA;EACA,MAAA;EACA,WAAA,EAAa,IAAA;AAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,KAAK,GAAG,SAAS,GAAG,MAAM,CAAC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,gBAAgB,EAAE,CAAC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE;QACT,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,YAAY,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,CAAC;IAC7D,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,IAAI,CAAC;CACnB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contractspec/lib.cost-tracking",
-  "version": "1.57.0",
+  "version": "1.59.0",
   "description": "API cost tracking and budgeting",
   "keywords": [
     "contractspec",
@@ -19,31 +19,36 @@
   "scripts": {
     "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose",
     "publish:pkg:canary": "bun publish:pkg --tag canary",
-    "build": "bun build:types && bun build:bundle",
-    "build:bundle": "tsdown",
-    "build:types": "tsc --noEmit",
-    "dev": "bun build:bundle --watch",
+    "build": "bun run prebuild && bun run build:bundle && bun run build:types",
+    "build:bundle": "contractspec-bun-build transpile",
+    "build:types": "contractspec-bun-build types",
+    "dev": "contractspec-bun-build dev",
     "clean": "rimraf dist .turbo",
     "lint": "bun lint:fix",
     "lint:fix": "eslint src --fix",
     "lint:check": "eslint src",
-    "test": "bun test"
+    "test": "bun test",
+    "prebuild": "contractspec-bun-build prebuild",
+    "typecheck": "tsc --noEmit"
   },
   "devDependencies": {
-    "@contractspec/tool.tsdown": "1.57.0",
-    "@contractspec/tool.typescript": "1.57.0",
-    "tsdown": "^0.20.3",
-    "typescript": "^5.9.3"
+    "@contractspec/tool.typescript": "1.59.0",
+    "typescript": "^5.9.3",
+    "@contractspec/tool.bun": "1.58.0"
   },
   "exports": {
-    ".": "./dist/index.js",
-    "./*": "./*"
+    ".": "./src/index.ts"
   },
   "publishConfig": {
     "access": "public",
     "exports": {
-      ".": "./dist/index.js",
-      "./*": "./*"
+      ".": {
+        "types": "./dist/index.d.ts",
+        "bun": "./dist/index.js",
+        "node": "./dist/node/index.mjs",
+        "browser": "./dist/browser/index.js",
+        "default": "./dist/index.js"
+      }
     },
     "registry": "https://registry.npmjs.org/"
   },

package/dist/budget-alert-manager.js

@@ -1,33 +0,0 @@
-//#region src/budget-alert-manager.ts
-var BudgetAlertManager = class {
-	limits = /* @__PURE__ */ new Map();
-	spend = /* @__PURE__ */ new Map();
-	constructor(options) {
-		this.options = options;
-		for (const budget of options.budgets) {
-			this.limits.set(budget.tenantId, budget);
-			this.spend.set(budget.tenantId, 0);
-		}
-	}
-	track(summary) {
-		if (!summary.tenantId) return;
-		const current = (this.spend.get(summary.tenantId) ?? 0) + summary.total;
-		this.spend.set(summary.tenantId, current);
-		const budget = this.limits.get(summary.tenantId);
-		if (!budget) return;
-		const threshold = budget.alertThreshold ?? .8;
-		if (current >= budget.monthlyLimit * threshold) this.options.onAlert?.({
-			tenantId: summary.tenantId,
-			limit: budget.monthlyLimit,
-			total: current,
-			summary
-		});
-	}
-	getSpend(tenantId) {
-		return this.spend.get(tenantId) ?? 0;
-	}
-};
-
-//#endregion
-export { BudgetAlertManager };
-//# sourceMappingURL=budget-alert-manager.js.map

package/dist/budget-alert-manager.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"budget-alert-manager.js","names":[],"sources":["../src/budget-alert-manager.ts"],"sourcesContent":["import type { OperationCostSummary, TenantBudget } from './types';\n\nexport interface BudgetAlertManagerOptions {\n  budgets: TenantBudget[];\n  onAlert?: (payload: {\n    tenantId: string;\n    limit: number;\n    total: number;\n    summary: OperationCostSummary;\n  }) => void;\n}\n\nexport class BudgetAlertManager {\n  private readonly limits = new Map<string, TenantBudget>();\n  private readonly spend = new Map<string, number>();\n\n  constructor(private readonly options: BudgetAlertManagerOptions) {\n    for (const budget of options.budgets) {\n      this.limits.set(budget.tenantId, budget);\n      this.spend.set(budget.tenantId, 0);\n    }\n  }\n\n  track(summary: OperationCostSummary) {\n    if (!summary.tenantId) {\n      return;\n    }\n\n    const current = (this.spend.get(summary.tenantId) ?? 0) + summary.total;\n    this.spend.set(summary.tenantId, current);\n\n    const budget = this.limits.get(summary.tenantId);\n    if (!budget) {\n      return;\n    }\n\n    const threshold = budget.alertThreshold ?? 0.8;\n    if (current >= budget.monthlyLimit * threshold) {\n      this.options.onAlert?.({\n        tenantId: summary.tenantId,\n        limit: budget.monthlyLimit,\n        total: current,\n        summary,\n      });\n    }\n  }\n\n  getSpend(tenantId: string) {\n    return this.spend.get(tenantId) ?? 0;\n  }\n}\n"],"mappings":";AAYA,IAAa,qBAAb,MAAgC;CAC9B,AAAiB,yBAAS,IAAI,KAA2B;CACzD,AAAiB,wBAAQ,IAAI,KAAqB;CAElD,YAAY,AAAiB,SAAoC;EAApC;AAC3B,OAAK,MAAM,UAAU,QAAQ,SAAS;AACpC,QAAK,OAAO,IAAI,OAAO,UAAU,OAAO;AACxC,QAAK,MAAM,IAAI,OAAO,UAAU,EAAE;;;CAItC,MAAM,SAA+B;AACnC,MAAI,CAAC,QAAQ,SACX;EAGF,MAAM,WAAW,KAAK,MAAM,IAAI,QAAQ,SAAS,IAAI,KAAK,QAAQ;AAClE,OAAK,MAAM,IAAI,QAAQ,UAAU,QAAQ;EAEzC,MAAM,SAAS,KAAK,OAAO,IAAI,QAAQ,SAAS;AAChD,MAAI,CAAC,OACH;EAGF,MAAM,YAAY,OAAO,kBAAkB;AAC3C,MAAI,WAAW,OAAO,eAAe,UACnC,MAAK,QAAQ,UAAU;GACrB,UAAU,QAAQ;GAClB,OAAO,OAAO;GACd,OAAO;GACP;GACD,CAAC;;CAIN,SAAS,UAAkB;AACzB,SAAO,KAAK,MAAM,IAAI,SAAS,IAAI"}

package/dist/cost-model.js

@@ -1,22 +0,0 @@
-//#region src/cost-model.ts
-const defaultCostModel = {
-	dbReadCost: 2e-6,
-	dbWriteCost: 1e-5,
-	computeMsCost: 15e-8,
-	memoryMbMsCost: 2e-8
-};
-function calculateSampleCost(sample, model) {
-	const external = (sample.externalCalls ?? []).reduce((sum, call) => sum + (call.cost ?? 0), 0);
-	return {
-		dbReads: (sample.dbReads ?? 0) * model.dbReadCost,
-		dbWrites: (sample.dbWrites ?? 0) * model.dbWriteCost,
-		compute: (sample.computeMs ?? 0) * model.computeMsCost,
-		memory: (sample.memoryMbMs ?? 0) * model.memoryMbMsCost,
-		external,
-		custom: sample.customCost ?? 0
-	};
-}
-
-//#endregion
-export { calculateSampleCost, defaultCostModel };
-//# sourceMappingURL=cost-model.js.map

package/dist/cost-model.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"cost-model.js","names":[],"sources":["../src/cost-model.ts"],"sourcesContent":["import type { CostModel, CostSample } from './types';\n\nexport const defaultCostModel: CostModel = {\n  dbReadCost: 0.000002,\n  dbWriteCost: 0.00001,\n  computeMsCost: 0.00000015,\n  memoryMbMsCost: 0.00000002,\n};\n\nexport function calculateSampleCost(sample: CostSample, model: CostModel) {\n  const external = (sample.externalCalls ?? []).reduce(\n    (sum, call) => sum + (call.cost ?? 0),\n    0\n  );\n\n  return {\n    dbReads: (sample.dbReads ?? 0) * model.dbReadCost,\n    dbWrites: (sample.dbWrites ?? 0) * model.dbWriteCost,\n    compute: (sample.computeMs ?? 0) * model.computeMsCost,\n    memory: (sample.memoryMbMs ?? 0) * model.memoryMbMsCost,\n    external,\n    custom: sample.customCost ?? 0,\n  };\n}\n"],"mappings":";AAEA,MAAa,mBAA8B;CACzC,YAAY;CACZ,aAAa;CACb,eAAe;CACf,gBAAgB;CACjB;AAED,SAAgB,oBAAoB,QAAoB,OAAkB;CACxE,MAAM,YAAY,OAAO,iBAAiB,EAAE,EAAE,QAC3C,KAAK,SAAS,OAAO,KAAK,QAAQ,IACnC,EACD;AAED,QAAO;EACL,UAAU,OAAO,WAAW,KAAK,MAAM;EACvC,WAAW,OAAO,YAAY,KAAK,MAAM;EACzC,UAAU,OAAO,aAAa,KAAK,MAAM;EACzC,SAAS,OAAO,cAAc,KAAK,MAAM;EACzC;EACA,QAAQ,OAAO,cAAc;EAC9B"}

package/dist/cost-tracker.js

@@ -1,61 +0,0 @@
-import { calculateSampleCost, defaultCostModel } from "./cost-model.js";
-
-//#region src/cost-tracker.ts
-var CostTracker = class {
-	totals = /* @__PURE__ */ new Map();
-	costModel;
-	constructor(options = {}) {
-		this.options = options;
-		this.costModel = options.costModel ?? defaultCostModel;
-	}
-	recordSample(sample) {
-		const breakdown = calculateSampleCost(sample, this.costModel);
-		const total = breakdown.dbReads + breakdown.dbWrites + breakdown.compute + breakdown.memory + breakdown.external + breakdown.custom;
-		const key = this.buildKey(sample.operation, sample.tenantId);
-		const existing = this.totals.get(key);
-		const summary = existing ? {
-			...existing,
-			total: existing.total + total,
-			breakdown: {
-				dbReads: existing.breakdown.dbReads + breakdown.dbReads,
-				dbWrites: existing.breakdown.dbWrites + breakdown.dbWrites,
-				compute: existing.breakdown.compute + breakdown.compute,
-				memory: existing.breakdown.memory + breakdown.memory,
-				external: existing.breakdown.external + breakdown.external,
-				custom: existing.breakdown.custom + breakdown.custom
-			},
-			samples: existing.samples + 1
-		} : {
-			operation: sample.operation,
-			tenantId: sample.tenantId,
-			total,
-			breakdown: {
-				dbReads: breakdown.dbReads,
-				dbWrites: breakdown.dbWrites,
-				compute: breakdown.compute,
-				memory: breakdown.memory,
-				external: breakdown.external,
-				custom: breakdown.custom
-			},
-			samples: 1
-		};
-		this.totals.set(key, summary);
-		this.options.onSampleRecorded?.(sample, total);
-		return summary;
-	}
-	getTotals(filter) {
-		const items = Array.from(this.totals.values());
-		if (!filter?.tenantId) return items;
-		return items.filter((item) => item.tenantId === filter.tenantId);
-	}
-	reset() {
-		this.totals.clear();
-	}
-	buildKey(operation, tenantId) {
-		return tenantId ? `${tenantId}:${operation}` : operation;
-	}
-};
-
-//#endregion
-export { CostTracker };
-//# sourceMappingURL=cost-tracker.js.map

package/dist/cost-tracker.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"cost-tracker.js","names":[],"sources":["../src/cost-tracker.ts"],"sourcesContent":["import { calculateSampleCost, defaultCostModel } from './cost-model';\nimport type { CostModel, CostSample, OperationCostSummary } from './types';\n\nexport interface CostTrackerOptions {\n  costModel?: CostModel;\n  onSampleRecorded?: (sample: CostSample, total: number) => void;\n}\n\nexport class CostTracker {\n  private readonly totals = new Map<string, OperationCostSummary>();\n  private readonly costModel: CostModel;\n\n  constructor(private readonly options: CostTrackerOptions = {}) {\n    this.costModel = options.costModel ?? defaultCostModel;\n  }\n\n  recordSample(sample: CostSample): OperationCostSummary {\n    const breakdown = calculateSampleCost(sample, this.costModel);\n    const total =\n      breakdown.dbReads +\n      breakdown.dbWrites +\n      breakdown.compute +\n      breakdown.memory +\n      breakdown.external +\n      breakdown.custom;\n\n    const key = this.buildKey(sample.operation, sample.tenantId);\n    const existing = this.totals.get(key);\n\n    const summary: OperationCostSummary = existing\n      ? {\n          ...existing,\n          total: existing.total + total,\n          breakdown: {\n            dbReads: existing.breakdown.dbReads + breakdown.dbReads,\n            dbWrites: existing.breakdown.dbWrites + breakdown.dbWrites,\n            compute: existing.breakdown.compute + breakdown.compute,\n            memory: existing.breakdown.memory + breakdown.memory,\n            external: existing.breakdown.external + breakdown.external,\n            custom: existing.breakdown.custom + breakdown.custom,\n          },\n          samples: existing.samples + 1,\n        }\n      : {\n          operation: sample.operation,\n          tenantId: sample.tenantId,\n          total,\n          breakdown: {\n            dbReads: breakdown.dbReads,\n            dbWrites: breakdown.dbWrites,\n            compute: breakdown.compute,\n            memory: breakdown.memory,\n            external: breakdown.external,\n            custom: breakdown.custom,\n          },\n          samples: 1,\n        };\n\n    this.totals.set(key, summary);\n    this.options.onSampleRecorded?.(sample, total);\n    return summary;\n  }\n\n  getTotals(filter?: { tenantId?: string }) {\n    const items = Array.from(this.totals.values());\n    if (!filter?.tenantId) {\n      return items;\n    }\n    return items.filter((item) => item.tenantId === filter.tenantId);\n  }\n\n  reset() {\n    this.totals.clear();\n  }\n\n  private buildKey(operation: string, tenantId?: string) {\n    return tenantId ? `${tenantId}:${operation}` : operation;\n  }\n}\n"],"mappings":";;;AAQA,IAAa,cAAb,MAAyB;CACvB,AAAiB,yBAAS,IAAI,KAAmC;CACjE,AAAiB;CAEjB,YAAY,AAAiB,UAA8B,EAAE,EAAE;EAAlC;AAC3B,OAAK,YAAY,QAAQ,aAAa;;CAGxC,aAAa,QAA0C;EACrD,MAAM,YAAY,oBAAoB,QAAQ,KAAK,UAAU;EAC7D,MAAM,QACJ,UAAU,UACV,UAAU,WACV,UAAU,UACV,UAAU,SACV,UAAU,WACV,UAAU;EAEZ,MAAM,MAAM,KAAK,SAAS,OAAO,WAAW,OAAO,SAAS;EAC5D,MAAM,WAAW,KAAK,OAAO,IAAI,IAAI;EAErC,MAAM,UAAgC,WAClC;GACE,GAAG;GACH,OAAO,SAAS,QAAQ;GACxB,WAAW;IACT,SAAS,SAAS,UAAU,UAAU,UAAU;IAChD,UAAU,SAAS,UAAU,WAAW,UAAU;IAClD,SAAS,SAAS,UAAU,UAAU,UAAU;IAChD,QAAQ,SAAS,UAAU,SAAS,UAAU;IAC9C,UAAU,SAAS,UAAU,WAAW,UAAU;IAClD,QAAQ,SAAS,UAAU,SAAS,UAAU;IAC/C;GACD,SAAS,SAAS,UAAU;GAC7B,GACD;GACE,WAAW,OAAO;GAClB,UAAU,OAAO;GACjB;GACA,WAAW;IACT,SAAS,UAAU;IACnB,UAAU,UAAU;IACpB,SAAS,UAAU;IACnB,QAAQ,UAAU;IAClB,UAAU,UAAU;IACpB,QAAQ,UAAU;IACnB;GACD,SAAS;GACV;AAEL,OAAK,OAAO,IAAI,KAAK,QAAQ;AAC7B,OAAK,QAAQ,mBAAmB,QAAQ,MAAM;AAC9C,SAAO;;CAGT,UAAU,QAAgC;EACxC,MAAM,QAAQ,MAAM,KAAK,KAAK,OAAO,QAAQ,CAAC;AAC9C,MAAI,CAAC,QAAQ,SACX,QAAO;AAET,SAAO,MAAM,QAAQ,SAAS,KAAK,aAAa,OAAO,SAAS;;CAGlE,QAAQ;AACN,OAAK,OAAO,OAAO;;CAGrB,AAAQ,SAAS,WAAmB,UAAmB;AACrD,SAAO,WAAW,GAAG,SAAS,GAAG,cAAc"}

package/dist/optimization-recommender.js

@@ -1,40 +0,0 @@
-//#region src/optimization-recommender.ts
-var OptimizationRecommender = class {
-	generate(summary) {
-		const suggestions = [];
-		const avgCost = summary.total / summary.samples;
-		if (summary.breakdown.dbReads / summary.samples > 1e3) suggestions.push({
-			operation: summary.operation,
-			tenantId: summary.tenantId,
-			category: "n_plus_one",
-			message: "High average DB read count detected. Consider batching queries or adding pagination.",
-			evidence: { avgReads: summary.breakdown.dbReads / summary.samples }
-		});
-		if (summary.breakdown.compute / summary.total > .6) suggestions.push({
-			operation: summary.operation,
-			tenantId: summary.tenantId,
-			category: "batching",
-			message: "Compute dominates cost. Investigate hot loops or move heavy logic to background jobs.",
-			evidence: { computeShare: summary.breakdown.compute / summary.total }
-		});
-		if (summary.breakdown.external > avgCost * .5) suggestions.push({
-			operation: summary.operation,
-			tenantId: summary.tenantId,
-			category: "external",
-			message: "External provider spend is high. Reuse results or enable caching.",
-			evidence: { externalCost: summary.breakdown.external }
-		});
-		if (summary.breakdown.memory > summary.breakdown.compute * 1.2) suggestions.push({
-			operation: summary.operation,
-			tenantId: summary.tenantId,
-			category: "caching",
-			message: "Memory utilization suggests cached payloads linger. Tune TTL or stream responses.",
-			evidence: { memoryCost: summary.breakdown.memory }
-		});
-		return suggestions;
-	}
-};
-
-//#endregion
-export { OptimizationRecommender };
-//# sourceMappingURL=optimization-recommender.js.map

package/dist/optimization-recommender.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"optimization-recommender.js","names":[],"sources":["../src/optimization-recommender.ts"],"sourcesContent":["import type { OperationCostSummary, OptimizationSuggestion } from './types';\n\nexport class OptimizationRecommender {\n  generate(summary: OperationCostSummary): OptimizationSuggestion[] {\n    const suggestions: OptimizationSuggestion[] = [];\n    const avgCost = summary.total / summary.samples;\n\n    if (summary.breakdown.dbReads / summary.samples > 1000) {\n      suggestions.push({\n        operation: summary.operation,\n        tenantId: summary.tenantId,\n        category: 'n_plus_one',\n        message:\n          'High average DB read count detected. Consider batching queries or adding pagination.',\n        evidence: { avgReads: summary.breakdown.dbReads / summary.samples },\n      });\n    }\n\n    if (summary.breakdown.compute / summary.total > 0.6) {\n      suggestions.push({\n        operation: summary.operation,\n        tenantId: summary.tenantId,\n        category: 'batching',\n        message:\n          'Compute dominates cost. Investigate hot loops or move heavy logic to background jobs.',\n        evidence: { computeShare: summary.breakdown.compute / summary.total },\n      });\n    }\n\n    if (summary.breakdown.external > avgCost * 0.5) {\n      suggestions.push({\n        operation: summary.operation,\n        tenantId: summary.tenantId,\n        category: 'external',\n        message:\n          'External provider spend is high. Reuse results or enable caching.',\n        evidence: { externalCost: summary.breakdown.external },\n      });\n    }\n\n    if (summary.breakdown.memory > summary.breakdown.compute * 1.2) {\n      suggestions.push({\n        operation: summary.operation,\n        tenantId: summary.tenantId,\n        category: 'caching',\n        message:\n          'Memory utilization suggests cached payloads linger. Tune TTL or stream responses.',\n        evidence: { memoryCost: summary.breakdown.memory },\n      });\n    }\n\n    return suggestions;\n  }\n}\n"],"mappings":";AAEA,IAAa,0BAAb,MAAqC;CACnC,SAAS,SAAyD;EAChE,MAAM,cAAwC,EAAE;EAChD,MAAM,UAAU,QAAQ,QAAQ,QAAQ;AAExC,MAAI,QAAQ,UAAU,UAAU,QAAQ,UAAU,IAChD,aAAY,KAAK;GACf,WAAW,QAAQ;GACnB,UAAU,QAAQ;GAClB,UAAU;GACV,SACE;GACF,UAAU,EAAE,UAAU,QAAQ,UAAU,UAAU,QAAQ,SAAS;GACpE,CAAC;AAGJ,MAAI,QAAQ,UAAU,UAAU,QAAQ,QAAQ,GAC9C,aAAY,KAAK;GACf,WAAW,QAAQ;GACnB,UAAU,QAAQ;GAClB,UAAU;GACV,SACE;GACF,UAAU,EAAE,cAAc,QAAQ,UAAU,UAAU,QAAQ,OAAO;GACtE,CAAC;AAGJ,MAAI,QAAQ,UAAU,WAAW,UAAU,GACzC,aAAY,KAAK;GACf,WAAW,QAAQ;GACnB,UAAU,QAAQ;GAClB,UAAU;GACV,SACE;GACF,UAAU,EAAE,cAAc,QAAQ,UAAU,UAAU;GACvD,CAAC;AAGJ,MAAI,QAAQ,UAAU,SAAS,QAAQ,UAAU,UAAU,IACzD,aAAY,KAAK;GACf,WAAW,QAAQ;GACnB,UAAU,QAAQ;GAClB,UAAU;GACV,SACE;GACF,UAAU,EAAE,YAAY,QAAQ,UAAU,QAAQ;GACnD,CAAC;AAGJ,SAAO"}