@lssm/lib.cost-tracking 1.42.0 → 1.42.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Chaman Ventures, SASU
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,5 +1,8 @@
 # @lssm/lib.cost-tracking
 
+Website: https://contractspec.lssm.tech/
+
+
 Cost attribution, budgeting, and optimization helpers for ContractSpec operations.
 
 ## Features

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

@@ -0,0 +1,23 @@
+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;
+}
+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

@@ -0,0 +1 @@
+{"version":3,"file":"budget-alert-manager.d.ts","names":[],"sources":["../src/budget-alert-manager.ts"],"sourcesContent":[],"mappings":";;;UAEiB,yBAAA;WACN;EADM,OAAA,CAAA,EAAA,CAAA,OAAA,EAAA;IAUJ,QAAA,EAAA,MAAA;;;aAJA;;;cAIA,kBAAA;;;;uBAI2B;iBAOvB"}

package/dist/budget-alert-manager.js

@@ -1 +1,33 @@
-var e=class{limits=new Map;spend=new Map;constructor(e){this.options=e;for(let t of e.budgets)this.limits.set(t.tenantId,t),this.spend.set(t.tenantId,0)}track(e){if(!e.tenantId)return;let t=(this.spend.get(e.tenantId)??0)+e.total;this.spend.set(e.tenantId,t);let n=this.limits.get(e.tenantId);if(!n)return;let r=n.alertThreshold??.8;t>=n.monthlyLimit*r&&this.options.onAlert?.({tenantId:e.tenantId,limit:n.monthlyLimit,total:t,summary:e})}getSpend(e){return this.spend.get(e)??0}};export{e as BudgetAlertManager};
+//#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

@@ -0,0 +1 @@
+{"version":3,"file":"budget-alert-manager.js","names":["options: BudgetAlertManagerOptions"],"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,AAAiBA,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.d.ts

@@ -0,0 +1,15 @@
+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;
+};
+//#endregion
+export { calculateSampleCost, defaultCostModel };
+//# sourceMappingURL=cost-model.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cost-model.d.ts","names":[],"sources":["../src/cost-model.ts"],"sourcesContent":[],"mappings":";;;cAEa,kBAAkB;iBAOf,mBAAA,SAA4B,mBAAmB;EAPlD,OAAA,EAAA,MAAA;EAOG,QAAA,EAAA,MAAA"}

package/dist/cost-model.js

@@ -1 +1,22 @@
-const e={dbReadCost:2e-6,dbWriteCost:1e-5,computeMsCost:15e-8,memoryMbMsCost:2e-8};function t(e,t){let n=(e.externalCalls??[]).reduce((e,t)=>e+(t.cost??0),0);return{dbReads:(e.dbReads??0)*t.dbReadCost,dbWrites:(e.dbWrites??0)*t.dbWriteCost,compute:(e.computeMs??0)*t.computeMsCost,memory:(e.memoryMbMs??0)*t.memoryMbMsCost,external:n,custom:e.customCost??0}}export{t as calculateSampleCost,e as defaultCostModel};
+//#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

@@ -0,0 +1 @@
+{"version":3,"file":"cost-model.js","names":["defaultCostModel: CostModel"],"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,MAAaA,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.d.ts

@@ -0,0 +1,22 @@
+import { CostModel, CostSample, OperationCostSummary } from "./types.js";
+
+//#region src/cost-tracker.d.ts
+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;
+}
+//#endregion
+export { CostTracker, CostTrackerOptions };
+//# sourceMappingURL=cost-tracker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cost-tracker.d.ts","names":[],"sources":["../src/cost-tracker.ts"],"sourcesContent":[],"mappings":";;;UAGiB,kBAAA;cACH;EADG,gBAAA,CAAA,EAAA,CAAA,MAAkB,EAEL,UADhB,EAAA,KACgB,EAAA,MAAA,EAAU,GAAA,IAAA;AAGxC;AAIwC,cAJ3B,WAAA,CAI2B;EAIjB,iBAAA,OAAA;EAAa,iBAAA,MAAA;EA+CM,iBAAA,SAAA;EAAA,WAAA,CAAA,OAAA,CAAA,EAnDF,kBAmDE;uBA/CnB,aAAa;;;MA+CM"}

package/dist/cost-tracker.js

@@ -1 +1,61 @@
-import{calculateSampleCost as e,defaultCostModel as t}from"./cost-model.js";var n=class{totals=new Map;costModel;constructor(e={}){this.options=e,this.costModel=e.costModel??t}recordSample(t){let n=e(t,this.costModel),r=n.dbReads+n.dbWrites+n.compute+n.memory+n.external+n.custom,i=this.buildKey(t.operation,t.tenantId),a=this.totals.get(i),o=a?{...a,total:a.total+r,breakdown:{dbReads:a.breakdown.dbReads+n.dbReads,dbWrites:a.breakdown.dbWrites+n.dbWrites,compute:a.breakdown.compute+n.compute,memory:a.breakdown.memory+n.memory,external:a.breakdown.external+n.external,custom:a.breakdown.custom+n.custom},samples:a.samples+1}:{operation:t.operation,tenantId:t.tenantId,total:r,breakdown:{dbReads:n.dbReads,dbWrites:n.dbWrites,compute:n.compute,memory:n.memory,external:n.external,custom:n.custom},samples:1};return this.totals.set(i,o),this.options.onSampleRecorded?.(t,r),o}getTotals(e){let t=Array.from(this.totals.values());return e?.tenantId?t.filter(t=>t.tenantId===e.tenantId):t}reset(){this.totals.clear()}buildKey(e,t){return t?`${t}:${e}`:e}};export{n as CostTracker};
+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

@@ -0,0 +1 @@
+{"version":3,"file":"cost-tracker.js","names":["options: CostTrackerOptions","summary: OperationCostSummary"],"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,AAAiBA,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,MAAMC,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/index.d.ts

@@ -0,0 +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 };

package/dist/index.js

@@ -1 +1,6 @@
-import{calculateSampleCost as e,defaultCostModel as t}from"./cost-model.js";import{CostTracker as n}from"./cost-tracker.js";import{BudgetAlertManager as r}from"./budget-alert-manager.js";import{OptimizationRecommender as i}from"./optimization-recommender.js";export{r as BudgetAlertManager,n as CostTracker,i as OptimizationRecommender,e as calculateSampleCost,t as defaultCostModel};
+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 };

package/dist/optimization-recommender.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"optimization-recommender.d.ts","names":[],"sources":["../src/optimization-recommender.ts"],"sourcesContent":[],"mappings":";;;cAEa,uBAAA;oBACO,uBAAuB;AAD3C"}

package/dist/optimization-recommender.js

@@ -1 +1,40 @@
-var e=class{generate(e){let t=[],n=e.total/e.samples;return e.breakdown.dbReads/e.samples>1e3&&t.push({operation:e.operation,tenantId:e.tenantId,category:`n_plus_one`,message:`High average DB read count detected. Consider batching queries or adding pagination.`,evidence:{avgReads:e.breakdown.dbReads/e.samples}}),e.breakdown.compute/e.total>.6&&t.push({operation:e.operation,tenantId:e.tenantId,category:`batching`,message:`Compute dominates cost. Investigate hot loops or move heavy logic to background jobs.`,evidence:{computeShare:e.breakdown.compute/e.total}}),e.breakdown.external>n*.5&&t.push({operation:e.operation,tenantId:e.tenantId,category:`external`,message:`External provider spend is high. Reuse results or enable caching.`,evidence:{externalCost:e.breakdown.external}}),e.breakdown.memory>e.breakdown.compute*1.2&&t.push({operation:e.operation,tenantId:e.tenantId,category:`caching`,message:`Memory utilization suggests cached payloads linger. Tune TTL or stream responses.`,evidence:{memoryCost:e.breakdown.memory}}),t}};export{e as OptimizationRecommender};
+//#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

@@ -0,0 +1 @@
+{"version":3,"file":"optimization-recommender.js","names":["suggestions: OptimizationSuggestion[]"],"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,MAAMA,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"}

package/dist/types.d.ts

@@ -0,0 +1,63 @@
+//#region src/types.d.ts
+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>;
+}
+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;
+}
+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>;
+}
+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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","names":[],"sources":["../src/types.ts"],"sourcesContent":[],"mappings":";UAAiB,gBAAA;EAAA,QAAA,EAAA,MAAA;EAOA,IAAA,CAAA,EAAA,MAAU;EAQT,UAAA,CAAA,EAAA,MAAA;EAEJ,YAAA,CAAA,EAAA,MAAA;;AACK,UAXF,UAAA,CAWE;EAGF,SAAA,EAAA,MAAS;EAOT,QAAA,CAAA,EAAA,MAAA;EAeA,WAAA,CAAA,EAAA,KAAY,GAAA,SAAA,GAAA,MAAA;EAQZ,OAAA,CAAA,EAAA,MAAA;EAQA,QAAA,CAAA,EAAA,MAAW;;;kBA5CV;;cAEJ;aACD;;UAGI,SAAA;;;;;;UAOA,oBAAA;;;;;;;;;;;;;;UAeA,YAAA;;;;;;;UAQA,sBAAA;;;;;YAKL;;UAGK,WAAA;;;;eAIF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lssm/lib.cost-tracking",
-  "version": "1.42.0",
+  "version": "1.42.2",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -12,7 +12,7 @@
   "scripts": {
     "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose",
     "publish:pkg:canary": "bun publish:pkg --tag canary",
-    "build": "bun build:bundle && bun build:types",
+    "build": "bun build:types && bun build:bundle",
     "build:bundle": "tsdown",
     "build:types": "tsc --noEmit",
     "dev": "bun build:bundle --watch",
@@ -23,13 +23,13 @@
     "test": "bun run"
   },
   "devDependencies": {
-    "@lssm/tool.tsdown": "1.42.0",
-    "@lssm/tool.typescript": "1.42.0",
-    "tsdown": "^0.17.4",
+    "@lssm/tool.tsdown": "1.42.2",
+    "@lssm/tool.typescript": "1.42.2",
+    "tsdown": "^0.18.3",
     "typescript": "^5.9.3"
   },
   "exports": {
-    ".": "./src/index.ts",
+    ".": "./dist/index.js",
     "./*": "./*"
   },
   "publishConfig": {
@@ -37,6 +37,13 @@
     "exports": {
       ".": "./dist/index.js",
       "./*": "./*"
-    }
+    },
+    "registry": "https://registry.npmjs.org/"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lssm-tech/contractspec.git",
+    "directory": "packages/libs/cost-tracking"
   }
 }