@lssm/lib.cost-tracking 0.0.0-canary-20251217063201 → 0.0.0-canary-20251217072406

package/dist/budget-alert-manager.js

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

package/dist/cost-model.js

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

package/dist/cost-tracker.js

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

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.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lssm/lib.cost-tracking",
-  "version": "0.0.0-canary-20251217063201",
+  "version": "0.0.0-canary-20251217072406",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -23,8 +23,8 @@
     "test": "bun run"
   },
   "devDependencies": {
-    "@lssm/tool.tsdown": "0.0.0-canary-20251217063201",
-    "@lssm/tool.typescript": "0.0.0-canary-20251217063201",
+    "@lssm/tool.tsdown": "0.0.0-canary-20251217072406",
+    "@lssm/tool.typescript": "0.0.0-canary-20251217072406",
     "tsdown": "^0.17.4",
     "typescript": "^5.9.3"
   },