@lssm/lib.analytics 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.analytics
 
+Website: https://contractspec.lssm.tech/
+
+
 Zero-dependency analytics toolkit used by Phase 2 AI-Native Ops. It ingests telemetry events and outputs:
 
 - Funnel conversion reports with drop-off detection.

package/dist/churn/index.d.ts

@@ -0,0 +1,2 @@
+import { ChurnPredictor, ChurnPredictorOptions } from "./predictor.js";
+export { ChurnPredictor, ChurnPredictorOptions };

package/dist/churn/index.js

@@ -1 +1,3 @@
-import{ChurnPredictor as e}from"./predictor.js";export{e as ChurnPredictor};
+import { ChurnPredictor } from "./predictor.js";
+
+export { ChurnPredictor };

package/dist/churn/predictor.d.ts

@@ -0,0 +1,22 @@
+import { AnalyticsEvent, ChurnSignal } from "../types.js";
+
+//#region src/churn/predictor.d.ts
+interface ChurnPredictorOptions {
+  recencyWeight?: number;
+  frequencyWeight?: number;
+  errorWeight?: number;
+  decayDays?: number;
+}
+declare class ChurnPredictor {
+  private readonly recencyWeight;
+  private readonly frequencyWeight;
+  private readonly errorWeight;
+  private readonly decayDays;
+  constructor(options?: ChurnPredictorOptions);
+  score(events: AnalyticsEvent[]): ChurnSignal[];
+  private computeScore;
+  private drivers;
+}
+//#endregion
+export { ChurnPredictor, ChurnPredictorOptions };
+//# sourceMappingURL=predictor.d.ts.map

package/dist/churn/predictor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"predictor.d.ts","names":[],"sources":["../../src/churn/predictor.ts"],"sourcesContent":[],"mappings":";;;UAGiB,qBAAA;;EAAA,eAAA,CAAA,EAAA,MAAqB;EAOzB,WAAA,CAAA,EAAA,MAAc;EAMH,SAAA,CAAA,EAAA,MAAA;;AAOW,cAbtB,cAAA,CAasB;EAAW,iBAAA,aAAA;;;;wBAPtB;gBAOR,mBAAmB"}

package/dist/churn/predictor.js

@@ -1 +1,74 @@
-import e from"dayjs";var t=class{recencyWeight;frequencyWeight;errorWeight;decayDays;constructor(e){this.recencyWeight=e?.recencyWeight??.5,this.frequencyWeight=e?.frequencyWeight??.3,this.errorWeight=e?.errorWeight??.2,this.decayDays=e?.decayDays??14}score(e){let t=n(e,e=>e.userId),r=[];for(let[e,n]of t.entries()){let t=this.computeScore(n);r.push({userId:e,score:t,bucket:t>=.7?`high`:t>=.4?`medium`:`low`,drivers:this.drivers(n)})}return r.sort((e,t)=>t.score-e.score)}computeScore(t){if(!t.length)return 0;let n=t.sort((e,t)=>r(e)-r(t)),i=n[n.length-1];if(!i)return 0;let a=e().diff(e(i.timestamp),`day`),o=Math.max(0,1-a/this.decayDays),s=e().subtract(this.decayDays,`day`),c=n.filter(t=>e(t.timestamp).isAfter(s)),l=c.length/Math.max(this.decayDays,1),u=Math.min(1,l*5),d=c.filter(e=>e.properties?.error!==void 0||/error|failed/i.test(e.name)).length,f=Math.min(1,d/3),p=o*this.recencyWeight+u*this.frequencyWeight+(1-f)*this.errorWeight;return Number(p.toFixed(3))}drivers(t){let n=[],i=t.sort((e,t)=>r(e)-r(t)),a=i[i.length-1];if(a){let t=e().diff(e(a.timestamp),`day`);t>this.decayDays&&n.push(`Inactive for ${t} days`)}let o=t.filter(e=>e.properties?.error!==void 0||/error|failed/i.test(e.name));return o.length&&n.push(`${o.length} errors logged`),n}};function n(e,t){let n=new Map;for(let r of e){let e=t(r),i=n.get(e)??[];i.push(r),n.set(e,i)}return n}function r(e){return new Date(e.timestamp).getTime()}export{t as ChurnPredictor};
+import dayjs from "dayjs";
+
+//#region src/churn/predictor.ts
+var ChurnPredictor = class {
+	recencyWeight;
+	frequencyWeight;
+	errorWeight;
+	decayDays;
+	constructor(options) {
+		this.recencyWeight = options?.recencyWeight ?? .5;
+		this.frequencyWeight = options?.frequencyWeight ?? .3;
+		this.errorWeight = options?.errorWeight ?? .2;
+		this.decayDays = options?.decayDays ?? 14;
+	}
+	score(events) {
+		const grouped = groupBy(events, (event) => event.userId);
+		const signals = [];
+		for (const [userId, userEvents] of grouped.entries()) {
+			const score = this.computeScore(userEvents);
+			signals.push({
+				userId,
+				score,
+				bucket: score >= .7 ? "high" : score >= .4 ? "medium" : "low",
+				drivers: this.drivers(userEvents)
+			});
+		}
+		return signals.sort((a, b) => b.score - a.score);
+	}
+	computeScore(events) {
+		if (!events.length) return 0;
+		const sorted = events.sort((a, b) => dateMs(a) - dateMs(b));
+		const lastEvent = sorted[sorted.length - 1];
+		if (!lastEvent) return 0;
+		const daysSinceLast = dayjs().diff(dayjs(lastEvent.timestamp), "day");
+		const recencyScore = Math.max(0, 1 - daysSinceLast / this.decayDays);
+		const windowStart = dayjs().subtract(this.decayDays, "day");
+		const recentEvents = sorted.filter((event) => dayjs(event.timestamp).isAfter(windowStart));
+		const averagePerDay = recentEvents.length / Math.max(this.decayDays, 1);
+		const frequencyScore = Math.min(1, averagePerDay * 5);
+		const errorEvents = recentEvents.filter((event) => typeof event.properties?.error !== "undefined" || /error|failed/i.test(event.name)).length;
+		const errorScore = Math.min(1, errorEvents / 3);
+		const score = recencyScore * this.recencyWeight + frequencyScore * this.frequencyWeight + (1 - errorScore) * this.errorWeight;
+		return Number(score.toFixed(3));
+	}
+	drivers(events) {
+		const drivers = [];
+		const sorted = events.sort((a, b) => dateMs(a) - dateMs(b));
+		const lastEvent = sorted[sorted.length - 1];
+		if (lastEvent) {
+			const days = dayjs().diff(dayjs(lastEvent.timestamp), "day");
+			if (days > this.decayDays) drivers.push(`Inactive for ${days} days`);
+		}
+		const errorEvents = events.filter((event) => typeof event.properties?.error !== "undefined" || /error|failed/i.test(event.name));
+		if (errorEvents.length) drivers.push(`${errorEvents.length} errors logged`);
+		return drivers;
+	}
+};
+function groupBy(items, selector) {
+	const map = /* @__PURE__ */ new Map();
+	for (const item of items) {
+		const key = selector(item);
+		const list = map.get(key) ?? [];
+		list.push(item);
+		map.set(key, list);
+	}
+	return map;
+}
+function dateMs(event) {
+	return new Date(event.timestamp).getTime();
+}
+
+//#endregion
+export { ChurnPredictor };
+//# sourceMappingURL=predictor.js.map

package/dist/churn/predictor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"predictor.js","names":["signals: ChurnSignal[]","drivers: string[]"],"sources":["../../src/churn/predictor.ts"],"sourcesContent":["import dayjs from 'dayjs';\nimport type { AnalyticsEvent, ChurnSignal } from '../types';\n\nexport interface ChurnPredictorOptions {\n  recencyWeight?: number;\n  frequencyWeight?: number;\n  errorWeight?: number;\n  decayDays?: number;\n}\n\nexport class ChurnPredictor {\n  private readonly recencyWeight: number;\n  private readonly frequencyWeight: number;\n  private readonly errorWeight: number;\n  private readonly decayDays: number;\n\n  constructor(options?: ChurnPredictorOptions) {\n    this.recencyWeight = options?.recencyWeight ?? 0.5;\n    this.frequencyWeight = options?.frequencyWeight ?? 0.3;\n    this.errorWeight = options?.errorWeight ?? 0.2;\n    this.decayDays = options?.decayDays ?? 14;\n  }\n\n  score(events: AnalyticsEvent[]): ChurnSignal[] {\n    const grouped = groupBy(events, (event) => event.userId);\n    const signals: ChurnSignal[] = [];\n    for (const [userId, userEvents] of grouped.entries()) {\n      const score = this.computeScore(userEvents);\n      signals.push({\n        userId,\n        score,\n        bucket: score >= 0.7 ? 'high' : score >= 0.4 ? 'medium' : 'low',\n        drivers: this.drivers(userEvents),\n      });\n    }\n    return signals.sort((a, b) => b.score - a.score);\n  }\n\n  private computeScore(events: AnalyticsEvent[]): number {\n    if (!events.length) return 0;\n    const sorted = events.sort((a, b) => dateMs(a) - dateMs(b));\n    const lastEvent = sorted[sorted.length - 1];\n    if (!lastEvent) return 0;\n    const daysSinceLast = dayjs().diff(dayjs(lastEvent.timestamp), 'day');\n    const recencyScore = Math.max(0, 1 - daysSinceLast / this.decayDays);\n\n    const windowStart = dayjs().subtract(this.decayDays, 'day');\n    const recentEvents = sorted.filter((event) =>\n      dayjs(event.timestamp).isAfter(windowStart)\n    );\n    const averagePerDay = recentEvents.length / Math.max(this.decayDays, 1);\n    const frequencyScore = Math.min(1, averagePerDay * 5);\n\n    const errorEvents = recentEvents.filter(\n      (event) =>\n        typeof event.properties?.error !== 'undefined' ||\n        /error|failed/i.test(event.name)\n    ).length;\n    const errorScore = Math.min(1, errorEvents / 3);\n\n    const score =\n      recencyScore * this.recencyWeight +\n      frequencyScore * this.frequencyWeight +\n      (1 - errorScore) * this.errorWeight;\n    return Number(score.toFixed(3));\n  }\n\n  private drivers(events: AnalyticsEvent[]): string[] {\n    const drivers: string[] = [];\n    const sorted = events.sort((a, b) => dateMs(a) - dateMs(b));\n    const lastEvent = sorted[sorted.length - 1];\n    if (lastEvent) {\n      const days = dayjs().diff(dayjs(lastEvent.timestamp), 'day');\n      if (days > this.decayDays) drivers.push(`Inactive for ${days} days`);\n    }\n    const errorEvents = events.filter(\n      (event) =>\n        typeof event.properties?.error !== 'undefined' ||\n        /error|failed/i.test(event.name)\n    );\n    if (errorEvents.length) drivers.push(`${errorEvents.length} errors logged`);\n    return drivers;\n  }\n}\n\nfunction groupBy<T>(\n  items: T[],\n  selector: (item: T) => string\n): Map<string, T[]> {\n  const map = new Map<string, T[]>();\n  for (const item of items) {\n    const key = selector(item);\n    const list = map.get(key) ?? [];\n    list.push(item);\n    map.set(key, list);\n  }\n  return map;\n}\n\nfunction dateMs(event: AnalyticsEvent) {\n  return new Date(event.timestamp).getTime();\n}\n"],"mappings":";;;AAUA,IAAa,iBAAb,MAA4B;CAC1B,AAAiB;CACjB,AAAiB;CACjB,AAAiB;CACjB,AAAiB;CAEjB,YAAY,SAAiC;AAC3C,OAAK,gBAAgB,SAAS,iBAAiB;AAC/C,OAAK,kBAAkB,SAAS,mBAAmB;AACnD,OAAK,cAAc,SAAS,eAAe;AAC3C,OAAK,YAAY,SAAS,aAAa;;CAGzC,MAAM,QAAyC;EAC7C,MAAM,UAAU,QAAQ,SAAS,UAAU,MAAM,OAAO;EACxD,MAAMA,UAAyB,EAAE;AACjC,OAAK,MAAM,CAAC,QAAQ,eAAe,QAAQ,SAAS,EAAE;GACpD,MAAM,QAAQ,KAAK,aAAa,WAAW;AAC3C,WAAQ,KAAK;IACX;IACA;IACA,QAAQ,SAAS,KAAM,SAAS,SAAS,KAAM,WAAW;IAC1D,SAAS,KAAK,QAAQ,WAAW;IAClC,CAAC;;AAEJ,SAAO,QAAQ,MAAM,GAAG,MAAM,EAAE,QAAQ,EAAE,MAAM;;CAGlD,AAAQ,aAAa,QAAkC;AACrD,MAAI,CAAC,OAAO,OAAQ,QAAO;EAC3B,MAAM,SAAS,OAAO,MAAM,GAAG,MAAM,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC;EAC3D,MAAM,YAAY,OAAO,OAAO,SAAS;AACzC,MAAI,CAAC,UAAW,QAAO;EACvB,MAAM,gBAAgB,OAAO,CAAC,KAAK,MAAM,UAAU,UAAU,EAAE,MAAM;EACrE,MAAM,eAAe,KAAK,IAAI,GAAG,IAAI,gBAAgB,KAAK,UAAU;EAEpE,MAAM,cAAc,OAAO,CAAC,SAAS,KAAK,WAAW,MAAM;EAC3D,MAAM,eAAe,OAAO,QAAQ,UAClC,MAAM,MAAM,UAAU,CAAC,QAAQ,YAAY,CAC5C;EACD,MAAM,gBAAgB,aAAa,SAAS,KAAK,IAAI,KAAK,WAAW,EAAE;EACvE,MAAM,iBAAiB,KAAK,IAAI,GAAG,gBAAgB,EAAE;EAErD,MAAM,cAAc,aAAa,QAC9B,UACC,OAAO,MAAM,YAAY,UAAU,eACnC,gBAAgB,KAAK,MAAM,KAAK,CACnC,CAAC;EACF,MAAM,aAAa,KAAK,IAAI,GAAG,cAAc,EAAE;EAE/C,MAAM,QACJ,eAAe,KAAK,gBACpB,iBAAiB,KAAK,mBACrB,IAAI,cAAc,KAAK;AAC1B,SAAO,OAAO,MAAM,QAAQ,EAAE,CAAC;;CAGjC,AAAQ,QAAQ,QAAoC;EAClD,MAAMC,UAAoB,EAAE;EAC5B,MAAM,SAAS,OAAO,MAAM,GAAG,MAAM,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC;EAC3D,MAAM,YAAY,OAAO,OAAO,SAAS;AACzC,MAAI,WAAW;GACb,MAAM,OAAO,OAAO,CAAC,KAAK,MAAM,UAAU,UAAU,EAAE,MAAM;AAC5D,OAAI,OAAO,KAAK,UAAW,SAAQ,KAAK,gBAAgB,KAAK,OAAO;;EAEtE,MAAM,cAAc,OAAO,QACxB,UACC,OAAO,MAAM,YAAY,UAAU,eACnC,gBAAgB,KAAK,MAAM,KAAK,CACnC;AACD,MAAI,YAAY,OAAQ,SAAQ,KAAK,GAAG,YAAY,OAAO,gBAAgB;AAC3E,SAAO;;;AAIX,SAAS,QACP,OACA,UACkB;CAClB,MAAM,sBAAM,IAAI,KAAkB;AAClC,MAAK,MAAM,QAAQ,OAAO;EACxB,MAAM,MAAM,SAAS,KAAK;EAC1B,MAAM,OAAO,IAAI,IAAI,IAAI,IAAI,EAAE;AAC/B,OAAK,KAAK,KAAK;AACf,MAAI,IAAI,KAAK,KAAK;;AAEpB,QAAO;;AAGT,SAAS,OAAO,OAAuB;AACrC,QAAO,IAAI,KAAK,MAAM,UAAU,CAAC,SAAS"}

package/dist/cohort/index.d.ts

@@ -0,0 +1,2 @@
+import { CohortTracker } from "./tracker.js";
+export { CohortTracker };

package/dist/cohort/index.js

@@ -1 +1,3 @@
-import{CohortTracker as e}from"./tracker.js";export{e as CohortTracker};
+import { CohortTracker } from "./tracker.js";
+
+export { CohortTracker };

package/dist/cohort/tracker.d.ts

@@ -0,0 +1,9 @@
+import { AnalyticsEvent, CohortAnalysis, CohortDefinition } from "../types.js";
+
+//#region src/cohort/tracker.d.ts
+declare class CohortTracker {
+  analyze(events: AnalyticsEvent[], definition: CohortDefinition): CohortAnalysis;
+}
+//#endregion
+export { CohortTracker };
+//# sourceMappingURL=tracker.d.ts.map

package/dist/cohort/tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracker.d.ts","names":[],"sources":["../../src/cohort/tracker.ts"],"sourcesContent":[],"mappings":";;;cAQa,aAAA;kBAED,8BACI,mBACX;AAJL"}

package/dist/cohort/tracker.js

@@ -1 +1,102 @@
-import e from"dayjs";var t=class{analyze(e,t){let a=r(e,e=>e.userId),o=new Map;for(let[e,r]of a.entries()){r.sort((e,t)=>s(e)-s(t));let a=r[0];if(!a)continue;let c=i(a.timestamp,t.bucket),l=o.get(c)??new n(c,t);l.addUser(e);for(let t of r)l.addEvent(e,t);o.set(c,l)}return{definition:t,cohorts:[...o.values()].map(e=>e.build())}}},n=class{users=new Set;retentionMap=new Map;ltv=0;constructor(e,t){this.key=e,this.definition=t}addUser(e){this.users.add(e)}addEvent(e,t){let n=a(this.key,t.timestamp,this.definition.bucket);if(n<0||n>=this.definition.periods)return;let r=this.retentionMap.get(n)??new Set;r.add(e),this.retentionMap.set(n,r);let i=typeof t.properties?.amount==`number`?t.properties.amount:0;this.ltv+=i}build(){let e=this.users.size||1,t=[];for(let n=0;n<this.definition.periods;n++){let r=this.retentionMap.get(n)?.size??0;t.push(Number((r/e).toFixed(3)))}return{cohortKey:this.key,users:this.users.size,retention:t,ltv:Number(this.ltv.toFixed(2))}}};function r(e,t){let n=new Map;for(let r of e){let e=t(r),i=n.get(e)??[];i.push(r),n.set(e,i)}return n}function i(t,n){let r=e(t);switch(n){case`day`:return r.startOf(`day`).format(`YYYY-MM-DD`);case`week`:return r.startOf(`week`).format(`YYYY-[W]WW`);case`month`:default:return r.startOf(`month`).format(`YYYY-MM`)}}function a(t,n,r){let i=o(t,r),a=e(n);switch(r){case`day`:return a.diff(i,`day`);case`week`:return a.diff(i,`week`);case`month`:default:return a.diff(i,`month`)}}function o(t,n){switch(n){case`day`:return e(t,`YYYY-MM-DD`);case`week`:return e(t.replace(`W`,``),`YYYY-ww`);case`month`:default:return e(t,`YYYY-MM`)}}function s(e){return new Date(e.timestamp).getTime()}export{t as CohortTracker};
+import dayjs from "dayjs";
+
+//#region src/cohort/tracker.ts
+var CohortTracker = class {
+	analyze(events, definition) {
+		const groupedByUser = groupBy(events, (event) => event.userId);
+		const cohorts = /* @__PURE__ */ new Map();
+		for (const [userId, userEvents] of groupedByUser.entries()) {
+			userEvents.sort((a, b) => dateMs(a) - dateMs(b));
+			const signup = userEvents[0];
+			if (!signup) continue;
+			const cohortKey = bucketKey(signup.timestamp, definition.bucket);
+			const builder = cohorts.get(cohortKey) ?? new CohortStatsBuilder(cohortKey, definition);
+			builder.addUser(userId);
+			for (const event of userEvents) builder.addEvent(userId, event);
+			cohorts.set(cohortKey, builder);
+		}
+		return {
+			definition,
+			cohorts: [...cohorts.values()].map((builder) => builder.build())
+		};
+	}
+};
+var CohortStatsBuilder = class {
+	users = /* @__PURE__ */ new Set();
+	retentionMap = /* @__PURE__ */ new Map();
+	ltv = 0;
+	constructor(key, definition) {
+		this.key = key;
+		this.definition = definition;
+	}
+	addUser(userId) {
+		this.users.add(userId);
+	}
+	addEvent(userId, event) {
+		const period = bucketDiff(this.key, event.timestamp, this.definition.bucket);
+		if (period < 0 || period >= this.definition.periods) return;
+		const bucket = this.retentionMap.get(period) ?? /* @__PURE__ */ new Set();
+		bucket.add(userId);
+		this.retentionMap.set(period, bucket);
+		const amount = typeof event.properties?.amount === "number" ? event.properties.amount : 0;
+		this.ltv += amount;
+	}
+	build() {
+		const totalUsers = this.users.size || 1;
+		const retention = [];
+		for (let period = 0; period < this.definition.periods; period++) {
+			const active = this.retentionMap.get(period)?.size ?? 0;
+			retention.push(Number((active / totalUsers).toFixed(3)));
+		}
+		return {
+			cohortKey: this.key,
+			users: this.users.size,
+			retention,
+			ltv: Number(this.ltv.toFixed(2))
+		};
+	}
+};
+function groupBy(items, selector) {
+	const map = /* @__PURE__ */ new Map();
+	for (const item of items) {
+		const key = selector(item);
+		const list = map.get(key) ?? [];
+		list.push(item);
+		map.set(key, list);
+	}
+	return map;
+}
+function bucketKey(timestamp, bucket) {
+	const dt = dayjs(timestamp);
+	switch (bucket) {
+		case "day": return dt.startOf("day").format("YYYY-MM-DD");
+		case "week": return dt.startOf("week").format("YYYY-[W]WW");
+		case "month":
+		default: return dt.startOf("month").format("YYYY-MM");
+	}
+}
+function bucketDiff(cohortKey, timestamp, bucket) {
+	const start = parseBucketKey(cohortKey, bucket);
+	const target = dayjs(timestamp);
+	switch (bucket) {
+		case "day": return target.diff(start, "day");
+		case "week": return target.diff(start, "week");
+		case "month":
+		default: return target.diff(start, "month");
+	}
+}
+function parseBucketKey(key, bucket) {
+	switch (bucket) {
+		case "day": return dayjs(key, "YYYY-MM-DD");
+		case "week": return dayjs(key.replace("W", ""), "YYYY-ww");
+		case "month":
+		default: return dayjs(key, "YYYY-MM");
+	}
+}
+function dateMs(event) {
+	return new Date(event.timestamp).getTime();
+}
+
+//#endregion
+export { CohortTracker };
+//# sourceMappingURL=tracker.js.map

package/dist/cohort/tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracker.js","names":["key: string","definition: CohortDefinition","retention: number[]"],"sources":["../../src/cohort/tracker.ts"],"sourcesContent":["import dayjs from 'dayjs';\nimport type {\n  AnalyticsEvent,\n  CohortAnalysis,\n  CohortDefinition,\n  CohortStats,\n} from '../types';\n\nexport class CohortTracker {\n  analyze(\n    events: AnalyticsEvent[],\n    definition: CohortDefinition\n  ): CohortAnalysis {\n    const groupedByUser = groupBy(events, (event) => event.userId);\n    const cohorts = new Map<string, CohortStatsBuilder>();\n\n    for (const [userId, userEvents] of groupedByUser.entries()) {\n      userEvents.sort((a, b) => dateMs(a) - dateMs(b));\n      const signup = userEvents[0];\n      if (!signup) continue;\n      const cohortKey = bucketKey(signup.timestamp, definition.bucket);\n      const builder =\n        cohorts.get(cohortKey) ?? new CohortStatsBuilder(cohortKey, definition);\n      builder.addUser(userId);\n      for (const event of userEvents) {\n        builder.addEvent(userId, event);\n      }\n      cohorts.set(cohortKey, builder);\n    }\n\n    return {\n      definition,\n      cohorts: [...cohorts.values()].map((builder) => builder.build()),\n    };\n  }\n}\n\nclass CohortStatsBuilder {\n  private readonly users = new Set<string>();\n  private readonly retentionMap = new Map<number, Set<string>>();\n  private ltv = 0;\n  constructor(\n    private readonly key: string,\n    private readonly definition: CohortDefinition\n  ) {}\n\n  addUser(userId: string) {\n    this.users.add(userId);\n  }\n\n  addEvent(userId: string, event: AnalyticsEvent) {\n    const period = bucketDiff(\n      this.key,\n      event.timestamp,\n      this.definition.bucket\n    );\n    if (period < 0 || period >= this.definition.periods) return;\n    const bucket = this.retentionMap.get(period) ?? new Set<string>();\n    bucket.add(userId);\n    this.retentionMap.set(period, bucket);\n    const amount =\n      typeof event.properties?.amount === 'number'\n        ? event.properties.amount\n        : 0;\n    this.ltv += amount;\n  }\n\n  build(): CohortStats {\n    const totalUsers = this.users.size || 1;\n    const retention: number[] = [];\n    for (let period = 0; period < this.definition.periods; period++) {\n      const active = this.retentionMap.get(period)?.size ?? 0;\n      retention.push(Number((active / totalUsers).toFixed(3)));\n    }\n    return {\n      cohortKey: this.key,\n      users: this.users.size,\n      retention,\n      ltv: Number(this.ltv.toFixed(2)),\n    };\n  }\n}\n\nfunction groupBy<T>(\n  items: T[],\n  selector: (item: T) => string\n): Map<string, T[]> {\n  const map = new Map<string, T[]>();\n  for (const item of items) {\n    const key = selector(item);\n    const list = map.get(key) ?? [];\n    list.push(item);\n    map.set(key, list);\n  }\n  return map;\n}\n\nfunction bucketKey(\n  timestamp: string | Date,\n  bucket: CohortDefinition['bucket']\n): string {\n  const dt = dayjs(timestamp);\n  switch (bucket) {\n    case 'day':\n      return dt.startOf('day').format('YYYY-MM-DD');\n    case 'week':\n      return dt.startOf('week').format('YYYY-[W]WW');\n    case 'month':\n    default:\n      return dt.startOf('month').format('YYYY-MM');\n  }\n}\n\nfunction bucketDiff(\n  cohortKey: string,\n  timestamp: string | Date,\n  bucket: CohortDefinition['bucket']\n): number {\n  const start = parseBucketKey(cohortKey, bucket);\n  const target = dayjs(timestamp);\n  switch (bucket) {\n    case 'day':\n      return target.diff(start, 'day');\n    case 'week':\n      return target.diff(start, 'week');\n    case 'month':\n    default:\n      return target.diff(start, 'month');\n  }\n}\n\nfunction parseBucketKey(key: string, bucket: CohortDefinition['bucket']) {\n  switch (bucket) {\n    case 'day':\n      return dayjs(key, 'YYYY-MM-DD');\n    case 'week':\n      return dayjs(key.replace('W', ''), 'YYYY-ww');\n    case 'month':\n    default:\n      return dayjs(key, 'YYYY-MM');\n  }\n}\n\nfunction dateMs(event: AnalyticsEvent) {\n  return new Date(event.timestamp).getTime();\n}\n"],"mappings":";;;AAQA,IAAa,gBAAb,MAA2B;CACzB,QACE,QACA,YACgB;EAChB,MAAM,gBAAgB,QAAQ,SAAS,UAAU,MAAM,OAAO;EAC9D,MAAM,0BAAU,IAAI,KAAiC;AAErD,OAAK,MAAM,CAAC,QAAQ,eAAe,cAAc,SAAS,EAAE;AAC1D,cAAW,MAAM,GAAG,MAAM,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC;GAChD,MAAM,SAAS,WAAW;AAC1B,OAAI,CAAC,OAAQ;GACb,MAAM,YAAY,UAAU,OAAO,WAAW,WAAW,OAAO;GAChE,MAAM,UACJ,QAAQ,IAAI,UAAU,IAAI,IAAI,mBAAmB,WAAW,WAAW;AACzE,WAAQ,QAAQ,OAAO;AACvB,QAAK,MAAM,SAAS,WAClB,SAAQ,SAAS,QAAQ,MAAM;AAEjC,WAAQ,IAAI,WAAW,QAAQ;;AAGjC,SAAO;GACL;GACA,SAAS,CAAC,GAAG,QAAQ,QAAQ,CAAC,CAAC,KAAK,YAAY,QAAQ,OAAO,CAAC;GACjE;;;AAIL,IAAM,qBAAN,MAAyB;CACvB,AAAiB,wBAAQ,IAAI,KAAa;CAC1C,AAAiB,+BAAe,IAAI,KAA0B;CAC9D,AAAQ,MAAM;CACd,YACE,AAAiBA,KACjB,AAAiBC,YACjB;EAFiB;EACA;;CAGnB,QAAQ,QAAgB;AACtB,OAAK,MAAM,IAAI,OAAO;;CAGxB,SAAS,QAAgB,OAAuB;EAC9C,MAAM,SAAS,WACb,KAAK,KACL,MAAM,WACN,KAAK,WAAW,OACjB;AACD,MAAI,SAAS,KAAK,UAAU,KAAK,WAAW,QAAS;EACrD,MAAM,SAAS,KAAK,aAAa,IAAI,OAAO,oBAAI,IAAI,KAAa;AACjE,SAAO,IAAI,OAAO;AAClB,OAAK,aAAa,IAAI,QAAQ,OAAO;EACrC,MAAM,SACJ,OAAO,MAAM,YAAY,WAAW,WAChC,MAAM,WAAW,SACjB;AACN,OAAK,OAAO;;CAGd,QAAqB;EACnB,MAAM,aAAa,KAAK,MAAM,QAAQ;EACtC,MAAMC,YAAsB,EAAE;AAC9B,OAAK,IAAI,SAAS,GAAG,SAAS,KAAK,WAAW,SAAS,UAAU;GAC/D,MAAM,SAAS,KAAK,aAAa,IAAI,OAAO,EAAE,QAAQ;AACtD,aAAU,KAAK,QAAQ,SAAS,YAAY,QAAQ,EAAE,CAAC,CAAC;;AAE1D,SAAO;GACL,WAAW,KAAK;GAChB,OAAO,KAAK,MAAM;GAClB;GACA,KAAK,OAAO,KAAK,IAAI,QAAQ,EAAE,CAAC;GACjC;;;AAIL,SAAS,QACP,OACA,UACkB;CAClB,MAAM,sBAAM,IAAI,KAAkB;AAClC,MAAK,MAAM,QAAQ,OAAO;EACxB,MAAM,MAAM,SAAS,KAAK;EAC1B,MAAM,OAAO,IAAI,IAAI,IAAI,IAAI,EAAE;AAC/B,OAAK,KAAK,KAAK;AACf,MAAI,IAAI,KAAK,KAAK;;AAEpB,QAAO;;AAGT,SAAS,UACP,WACA,QACQ;CACR,MAAM,KAAK,MAAM,UAAU;AAC3B,SAAQ,QAAR;EACE,KAAK,MACH,QAAO,GAAG,QAAQ,MAAM,CAAC,OAAO,aAAa;EAC/C,KAAK,OACH,QAAO,GAAG,QAAQ,OAAO,CAAC,OAAO,aAAa;EAChD,KAAK;EACL,QACE,QAAO,GAAG,QAAQ,QAAQ,CAAC,OAAO,UAAU;;;AAIlD,SAAS,WACP,WACA,WACA,QACQ;CACR,MAAM,QAAQ,eAAe,WAAW,OAAO;CAC/C,MAAM,SAAS,MAAM,UAAU;AAC/B,SAAQ,QAAR;EACE,KAAK,MACH,QAAO,OAAO,KAAK,OAAO,MAAM;EAClC,KAAK,OACH,QAAO,OAAO,KAAK,OAAO,OAAO;EACnC,KAAK;EACL,QACE,QAAO,OAAO,KAAK,OAAO,QAAQ;;;AAIxC,SAAS,eAAe,KAAa,QAAoC;AACvE,SAAQ,QAAR;EACE,KAAK,MACH,QAAO,MAAM,KAAK,aAAa;EACjC,KAAK,OACH,QAAO,MAAM,IAAI,QAAQ,KAAK,GAAG,EAAE,UAAU;EAC/C,KAAK;EACL,QACE,QAAO,MAAM,KAAK,UAAU;;;AAIlC,SAAS,OAAO,OAAuB;AACrC,QAAO,IAAI,KAAK,MAAM,UAAU,CAAC,SAAS"}

package/dist/funnel/analyzer.d.ts

@@ -0,0 +1,10 @@
+import { AnalyticsEvent, FunnelAnalysis, FunnelDefinition } from "../types.js";
+
+//#region src/funnel/analyzer.d.ts
+declare class FunnelAnalyzer {
+  analyze(events: AnalyticsEvent[], definition: FunnelDefinition): FunnelAnalysis;
+  private evaluateUser;
+}
+//#endregion
+export { FunnelAnalyzer };
+//# sourceMappingURL=analyzer.d.ts.map

package/dist/funnel/analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzer.d.ts","names":[],"sources":["../../src/funnel/analyzer.ts"],"sourcesContent":[],"mappings":";;;cAQa,cAAA;kBAED,8BACI,mBACX;EAJQ,QAAA,YAAc"}

package/dist/funnel/analyzer.js

@@ -1 +1,64 @@
-var e=class{analyze(e,n){let r=(n.windowHours??72)*60*60*1e3,i=t(e),a=n.steps.map(()=>0);for(let e of i.values())this.evaluateUser(e,n.steps,r).forEach((e,t)=>{e&&(a[t]=(a[t]??0)+1)});let o=i.size;return{definition:n,totalUsers:o,steps:n.steps.map((e,t)=>{let n=t===0?o:a[t-1]||1,r=a[t]??0,i=n===0?0:Number((r/n).toFixed(3));return{step:e,count:r,conversionRate:i,dropOffRate:Number((1-i).toFixed(3))}})}}evaluateUser(e,t,n){let r=[...e].sort((e,t)=>new Date(e.timestamp).getTime()-new Date(t.timestamp).getTime()),i=Array(t.length).fill(!1),a=0,o;for(let e of r){let r=t[a];if(!r)break;if(e.name!==r.eventName||r.match&&!r.match(e))continue;let s=new Date(e.timestamp).getTime();if(a===0){o=s,i[a]=!0,a+=1;continue}o&&s-o<=n&&(i[a]=!0,a+=1)}return i}};function t(e){let t=new Map;for(let n of e){let e=t.get(n.userId)??[];e.push(n),t.set(n.userId,e)}return t}export{e as FunnelAnalyzer};
+//#region src/funnel/analyzer.ts
+var FunnelAnalyzer = class {
+	analyze(events, definition) {
+		const windowMs = (definition.windowHours ?? 72) * 60 * 60 * 1e3;
+		const eventsByUser = groupByUser(events);
+		const stepCounts = definition.steps.map(() => 0);
+		for (const userEvents of eventsByUser.values()) this.evaluateUser(userEvents, definition.steps, windowMs).forEach((hit, stepIdx) => {
+			if (hit) stepCounts[stepIdx] = (stepCounts[stepIdx] ?? 0) + 1;
+		});
+		const totalUsers = eventsByUser.size;
+		return {
+			definition,
+			totalUsers,
+			steps: definition.steps.map((step, index) => {
+				const prevCount = index === 0 ? totalUsers : stepCounts[index - 1] || 1;
+				const count = stepCounts[index] ?? 0;
+				const conversionRate = prevCount === 0 ? 0 : Number((count / prevCount).toFixed(3));
+				return {
+					step,
+					count,
+					conversionRate,
+					dropOffRate: Number((1 - conversionRate).toFixed(3))
+				};
+			})
+		};
+	}
+	evaluateUser(events, steps, windowMs) {
+		const sorted = [...events].sort((a, b) => new Date(a.timestamp).getTime() - new Date(b.timestamp).getTime());
+		const completion = Array(steps.length).fill(false);
+		let cursor = 0;
+		let anchorTime;
+		for (const event of sorted) {
+			const step = steps[cursor];
+			if (!step) break;
+			if (event.name !== step.eventName) continue;
+			if (step.match && !step.match(event)) continue;
+			const eventTime = new Date(event.timestamp).getTime();
+			if (cursor === 0) {
+				anchorTime = eventTime;
+				completion[cursor] = true;
+				cursor += 1;
+				continue;
+			}
+			if (anchorTime && eventTime - anchorTime <= windowMs) {
+				completion[cursor] = true;
+				cursor += 1;
+			}
+		}
+		return completion;
+	}
+};
+function groupByUser(events) {
+	const map = /* @__PURE__ */ new Map();
+	for (const event of events) {
+		const list = map.get(event.userId) ?? [];
+		list.push(event);
+		map.set(event.userId, list);
+	}
+	return map;
+}
+
+//#endregion
+export { FunnelAnalyzer };
+//# sourceMappingURL=analyzer.js.map

package/dist/funnel/analyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzer.js","names":["completion: boolean[]","anchorTime: number | undefined"],"sources":["../../src/funnel/analyzer.ts"],"sourcesContent":["import type {\n  AnalyticsEvent,\n  FunnelAnalysis,\n  FunnelDefinition,\n  FunnelStep,\n  FunnelStepResult,\n} from '../types';\n\nexport class FunnelAnalyzer {\n  analyze(\n    events: AnalyticsEvent[],\n    definition: FunnelDefinition\n  ): FunnelAnalysis {\n    const windowMs = (definition.windowHours ?? 72) * 60 * 60 * 1000;\n    const eventsByUser = groupByUser(events);\n    const stepCounts = definition.steps.map(() => 0);\n\n    for (const userEvents of eventsByUser.values()) {\n      const completionIndex = this.evaluateUser(\n        userEvents,\n        definition.steps,\n        windowMs\n      );\n      completionIndex.forEach((hit, stepIdx) => {\n        if (hit) {\n          stepCounts[stepIdx] = (stepCounts[stepIdx] ?? 0) + 1;\n        }\n      });\n    }\n\n    const totalUsers = eventsByUser.size;\n    const steps: FunnelStepResult[] = definition.steps.map((step, index) => {\n      const prevCount = index === 0 ? totalUsers : stepCounts[index - 1] || 1;\n      const count = stepCounts[index] ?? 0;\n      const conversionRate =\n        prevCount === 0 ? 0 : Number((count / prevCount).toFixed(3));\n      const dropOffRate = Number((1 - conversionRate).toFixed(3));\n      return { step, count, conversionRate, dropOffRate };\n    });\n\n    return {\n      definition,\n      totalUsers,\n      steps,\n    };\n  }\n\n  private evaluateUser(\n    events: AnalyticsEvent[],\n    steps: FunnelStep[],\n    windowMs: number\n  ) {\n    const sorted = [...events].sort(\n      (a, b) =>\n        new Date(a.timestamp).getTime() - new Date(b.timestamp).getTime()\n    );\n    const completion: boolean[] = Array(steps.length).fill(false);\n    let cursor = 0;\n    let anchorTime: number | undefined;\n\n    for (const event of sorted) {\n      const step = steps[cursor];\n      if (!step) break;\n      if (event.name !== step.eventName) continue;\n      if (step.match && !step.match(event)) continue;\n\n      const eventTime = new Date(event.timestamp).getTime();\n      if (cursor === 0) {\n        anchorTime = eventTime;\n        completion[cursor] = true;\n        cursor += 1;\n        continue;\n      }\n\n      if (anchorTime && eventTime - anchorTime <= windowMs) {\n        completion[cursor] = true;\n        cursor += 1;\n      }\n    }\n\n    return completion;\n  }\n}\n\nfunction groupByUser(events: AnalyticsEvent[]): Map<string, AnalyticsEvent[]> {\n  const map = new Map<string, AnalyticsEvent[]>();\n  for (const event of events) {\n    const list = map.get(event.userId) ?? [];\n    list.push(event);\n    map.set(event.userId, list);\n  }\n  return map;\n}\n"],"mappings":";AAQA,IAAa,iBAAb,MAA4B;CAC1B,QACE,QACA,YACgB;EAChB,MAAM,YAAY,WAAW,eAAe,MAAM,KAAK,KAAK;EAC5D,MAAM,eAAe,YAAY,OAAO;EACxC,MAAM,aAAa,WAAW,MAAM,UAAU,EAAE;AAEhD,OAAK,MAAM,cAAc,aAAa,QAAQ,CAM5C,CALwB,KAAK,aAC3B,YACA,WAAW,OACX,SACD,CACe,SAAS,KAAK,YAAY;AACxC,OAAI,IACF,YAAW,YAAY,WAAW,YAAY,KAAK;IAErD;EAGJ,MAAM,aAAa,aAAa;AAUhC,SAAO;GACL;GACA;GACA,OAZgC,WAAW,MAAM,KAAK,MAAM,UAAU;IACtE,MAAM,YAAY,UAAU,IAAI,aAAa,WAAW,QAAQ,MAAM;IACtE,MAAM,QAAQ,WAAW,UAAU;IACnC,MAAM,iBACJ,cAAc,IAAI,IAAI,QAAQ,QAAQ,WAAW,QAAQ,EAAE,CAAC;AAE9D,WAAO;KAAE;KAAM;KAAO;KAAgB,aADlB,QAAQ,IAAI,gBAAgB,QAAQ,EAAE,CAAC;KACR;KACnD;GAMD;;CAGH,AAAQ,aACN,QACA,OACA,UACA;EACA,MAAM,SAAS,CAAC,GAAG,OAAO,CAAC,MACxB,GAAG,MACF,IAAI,KAAK,EAAE,UAAU,CAAC,SAAS,GAAG,IAAI,KAAK,EAAE,UAAU,CAAC,SAAS,CACpE;EACD,MAAMA,aAAwB,MAAM,MAAM,OAAO,CAAC,KAAK,MAAM;EAC7D,IAAI,SAAS;EACb,IAAIC;AAEJ,OAAK,MAAM,SAAS,QAAQ;GAC1B,MAAM,OAAO,MAAM;AACnB,OAAI,CAAC,KAAM;AACX,OAAI,MAAM,SAAS,KAAK,UAAW;AACnC,OAAI,KAAK,SAAS,CAAC,KAAK,MAAM,MAAM,CAAE;GAEtC,MAAM,YAAY,IAAI,KAAK,MAAM,UAAU,CAAC,SAAS;AACrD,OAAI,WAAW,GAAG;AAChB,iBAAa;AACb,eAAW,UAAU;AACrB,cAAU;AACV;;AAGF,OAAI,cAAc,YAAY,cAAc,UAAU;AACpD,eAAW,UAAU;AACrB,cAAU;;;AAId,SAAO;;;AAIX,SAAS,YAAY,QAAyD;CAC5E,MAAM,sBAAM,IAAI,KAA+B;AAC/C,MAAK,MAAM,SAAS,QAAQ;EAC1B,MAAM,OAAO,IAAI,IAAI,MAAM,OAAO,IAAI,EAAE;AACxC,OAAK,KAAK,MAAM;AAChB,MAAI,IAAI,MAAM,QAAQ,KAAK;;AAE7B,QAAO"}

package/dist/funnel/index.d.ts

@@ -0,0 +1,2 @@
+import { FunnelAnalyzer } from "./analyzer.js";
+export { FunnelAnalyzer };

package/dist/funnel/index.js

@@ -1 +1,3 @@
-import{FunnelAnalyzer as e}from"./analyzer.js";export{e as FunnelAnalyzer};
+import { FunnelAnalyzer } from "./analyzer.js";
+
+export { FunnelAnalyzer };

package/dist/growth/hypothesis-generator.d.ts

@@ -0,0 +1,18 @@
+import { GrowthHypothesis, GrowthMetric } from "../types.js";
+
+//#region src/growth/hypothesis-generator.d.ts
+interface HypothesisGeneratorOptions {
+  minDelta?: number;
+}
+declare class GrowthHypothesisGenerator {
+  private readonly minDelta;
+  constructor(options?: HypothesisGeneratorOptions);
+  generate(metrics: GrowthMetric[]): GrowthHypothesis[];
+  private fromMetric;
+  private delta;
+  private impact;
+  private statement;
+}
+//#endregion
+export { GrowthHypothesisGenerator, HypothesisGeneratorOptions };
+//# sourceMappingURL=hypothesis-generator.d.ts.map

package/dist/growth/hypothesis-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hypothesis-generator.d.ts","names":[],"sources":["../../src/growth/hypothesis-generator.ts"],"sourcesContent":[],"mappings":";;;UAEiB,0BAAA;;AAAjB;AAIa,cAAA,yBAAA,CAAyB;EAGd,iBAAA,QAAA;EAIJ,WAAA,CAAA,OAAA,CAAA,EAJI,0BAIJ;EAAiB,QAAA,CAAA,OAAA,EAAjB,YAAiB,EAAA,CAAA,EAAA,gBAAA,EAAA;EAAgB,QAAA,UAAA"}

package/dist/growth/hypothesis-generator.js

@@ -1 +1,40 @@
-var e=class{minDelta;constructor(e){this.minDelta=e?.minDelta??.05}generate(e){return e.map(e=>this.fromMetric(e)).filter(e=>!!e)}fromMetric(e){let t=this.delta(e);if(Math.abs(t)<this.minDelta)return null;let n=t>0?`rising`:`declining`;return{statement:this.statement(e,t,n),metric:e.name,confidence:Math.abs(t)>.2?`high`:`medium`,impact:this.impact(e)}}delta(e){if(e.previous==null)return 0;let t=e.previous||1;return(e.current-t)/Math.abs(t)}impact(e){return e.target&&e.current<e.target*.8?`high`:e.target&&e.current<e.target?`medium`:`low`}statement(e,t,n){let r=Math.abs(parseFloat((t*100).toFixed(1)));return n===`declining`?`${e.name} is down ${r}% vs last period; test new onboarding prompts to recover activation.`:`${e.name} grew ${r}% period-over-period; double down with expanded experiment or pricing test.`}};export{e as GrowthHypothesisGenerator};
+//#region src/growth/hypothesis-generator.ts
+var GrowthHypothesisGenerator = class {
+	minDelta;
+	constructor(options) {
+		this.minDelta = options?.minDelta ?? .05;
+	}
+	generate(metrics) {
+		return metrics.map((metric) => this.fromMetric(metric)).filter((hypothesis) => Boolean(hypothesis));
+	}
+	fromMetric(metric) {
+		const change = this.delta(metric);
+		if (Math.abs(change) < this.minDelta) return null;
+		const direction = change > 0 ? "rising" : "declining";
+		return {
+			statement: this.statement(metric, change, direction),
+			metric: metric.name,
+			confidence: Math.abs(change) > .2 ? "high" : "medium",
+			impact: this.impact(metric)
+		};
+	}
+	delta(metric) {
+		if (metric.previous == null) return 0;
+		const prev = metric.previous || 1;
+		return (metric.current - prev) / Math.abs(prev);
+	}
+	impact(metric) {
+		if (metric.target && metric.current < metric.target * .8) return "high";
+		if (metric.target && metric.current < metric.target) return "medium";
+		return "low";
+	}
+	statement(metric, change, direction) {
+		const percent = Math.abs(parseFloat((change * 100).toFixed(1)));
+		if (direction === "declining") return `${metric.name} is down ${percent}% vs last period; test new onboarding prompts to recover activation.`;
+		return `${metric.name} grew ${percent}% period-over-period; double down with expanded experiment or pricing test.`;
+	}
+};
+
+//#endregion
+export { GrowthHypothesisGenerator };
+//# sourceMappingURL=hypothesis-generator.js.map

package/dist/growth/hypothesis-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hypothesis-generator.js","names":[],"sources":["../../src/growth/hypothesis-generator.ts"],"sourcesContent":["import type { GrowthHypothesis, GrowthMetric } from '../types';\n\nexport interface HypothesisGeneratorOptions {\n  minDelta?: number;\n}\n\nexport class GrowthHypothesisGenerator {\n  private readonly minDelta: number;\n\n  constructor(options?: HypothesisGeneratorOptions) {\n    this.minDelta = options?.minDelta ?? 0.05;\n  }\n\n  generate(metrics: GrowthMetric[]): GrowthHypothesis[] {\n    return metrics\n      .map((metric) => this.fromMetric(metric))\n      .filter((hypothesis): hypothesis is GrowthHypothesis =>\n        Boolean(hypothesis)\n      );\n  }\n\n  private fromMetric(metric: GrowthMetric): GrowthHypothesis | null {\n    const change = this.delta(metric);\n    if (Math.abs(change) < this.minDelta) return null;\n    const direction = change > 0 ? 'rising' : 'declining';\n    const statement = this.statement(metric, change, direction);\n    return {\n      statement,\n      metric: metric.name,\n      confidence: Math.abs(change) > 0.2 ? 'high' : 'medium',\n      impact: this.impact(metric),\n    };\n  }\n\n  private delta(metric: GrowthMetric): number {\n    if (metric.previous == null) return 0;\n    const prev = metric.previous || 1;\n    return (metric.current - prev) / Math.abs(prev);\n  }\n\n  private impact(metric: GrowthMetric): GrowthHypothesis['impact'] {\n    if (metric.target && metric.current < metric.target * 0.8) return 'high';\n    if (metric.target && metric.current < metric.target) return 'medium';\n    return 'low';\n  }\n\n  private statement(\n    metric: GrowthMetric,\n    change: number,\n    direction: string\n  ): string {\n    const percent = Math.abs(parseFloat((change * 100).toFixed(1)));\n    if (direction === 'declining') {\n      return `${metric.name} is down ${percent}% vs last period; test new onboarding prompts to recover activation.`;\n    }\n    return `${metric.name} grew ${percent}% period-over-period; double down with expanded experiment or pricing test.`;\n  }\n}\n"],"mappings":";AAMA,IAAa,4BAAb,MAAuC;CACrC,AAAiB;CAEjB,YAAY,SAAsC;AAChD,OAAK,WAAW,SAAS,YAAY;;CAGvC,SAAS,SAA6C;AACpD,SAAO,QACJ,KAAK,WAAW,KAAK,WAAW,OAAO,CAAC,CACxC,QAAQ,eACP,QAAQ,WAAW,CACpB;;CAGL,AAAQ,WAAW,QAA+C;EAChE,MAAM,SAAS,KAAK,MAAM,OAAO;AACjC,MAAI,KAAK,IAAI,OAAO,GAAG,KAAK,SAAU,QAAO;EAC7C,MAAM,YAAY,SAAS,IAAI,WAAW;AAE1C,SAAO;GACL,WAFgB,KAAK,UAAU,QAAQ,QAAQ,UAAU;GAGzD,QAAQ,OAAO;GACf,YAAY,KAAK,IAAI,OAAO,GAAG,KAAM,SAAS;GAC9C,QAAQ,KAAK,OAAO,OAAO;GAC5B;;CAGH,AAAQ,MAAM,QAA8B;AAC1C,MAAI,OAAO,YAAY,KAAM,QAAO;EACpC,MAAM,OAAO,OAAO,YAAY;AAChC,UAAQ,OAAO,UAAU,QAAQ,KAAK,IAAI,KAAK;;CAGjD,AAAQ,OAAO,QAAkD;AAC/D,MAAI,OAAO,UAAU,OAAO,UAAU,OAAO,SAAS,GAAK,QAAO;AAClE,MAAI,OAAO,UAAU,OAAO,UAAU,OAAO,OAAQ,QAAO;AAC5D,SAAO;;CAGT,AAAQ,UACN,QACA,QACA,WACQ;EACR,MAAM,UAAU,KAAK,IAAI,YAAY,SAAS,KAAK,QAAQ,EAAE,CAAC,CAAC;AAC/D,MAAI,cAAc,YAChB,QAAO,GAAG,OAAO,KAAK,WAAW,QAAQ;AAE3C,SAAO,GAAG,OAAO,KAAK,QAAQ,QAAQ"}

package/dist/growth/index.d.ts

@@ -0,0 +1,2 @@
+import { GrowthHypothesisGenerator, HypothesisGeneratorOptions } from "./hypothesis-generator.js";
+export { GrowthHypothesisGenerator, HypothesisGeneratorOptions };

package/dist/growth/index.js

@@ -1 +1,3 @@
-import{GrowthHypothesisGenerator as e}from"./hypothesis-generator.js";export{e as GrowthHypothesisGenerator};
+import { GrowthHypothesisGenerator } from "./hypothesis-generator.js";
+
+export { GrowthHypothesisGenerator };

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+import { AnalyticsEvent, ChurnSignal, CohortAnalysis, CohortDefinition, CohortEvent, CohortStats, FunnelAnalysis, FunnelDefinition, FunnelStep, FunnelStepResult, GrowthHypothesis, GrowthMetric } from "./types.js";
+import { ChurnPredictor, ChurnPredictorOptions } from "./churn/predictor.js";
+import { CohortTracker } from "./cohort/tracker.js";
+import { FunnelAnalyzer } from "./funnel/analyzer.js";
+import { GrowthHypothesisGenerator, HypothesisGeneratorOptions } from "./growth/hypothesis-generator.js";
+import { LifecycleMetricSource, LifecycleStageChangePayload, collectLifecycleMetrics, createStageChangeEvent, lifecycleEventNames, metricsToSignals } from "./lifecycle/metric-collectors.js";
+import { PostHogLikeClient, trackLifecycleAssessment, trackLifecycleStageChange } from "./lifecycle/posthog-bridge.js";
+export { AnalyticsEvent, ChurnPredictor, ChurnPredictorOptions, ChurnSignal, CohortAnalysis, CohortDefinition, CohortEvent, CohortStats, CohortTracker, FunnelAnalysis, FunnelAnalyzer, FunnelDefinition, FunnelStep, FunnelStepResult, GrowthHypothesis, GrowthHypothesisGenerator, GrowthMetric, HypothesisGeneratorOptions, LifecycleMetricSource, LifecycleStageChangePayload, PostHogLikeClient, collectLifecycleMetrics, createStageChangeEvent, lifecycleEventNames, metricsToSignals, trackLifecycleAssessment, trackLifecycleStageChange };

package/dist/index.js

@@ -1 +1,10 @@
-import{FunnelAnalyzer as e}from"./funnel/analyzer.js";import{CohortTracker as t}from"./cohort/tracker.js";import"./cohort/index.js";import{ChurnPredictor as n}from"./churn/predictor.js";import"./churn/index.js";import{GrowthHypothesisGenerator as r}from"./growth/hypothesis-generator.js";import{collectLifecycleMetrics as i,createStageChangeEvent as a,lifecycleEventNames as o,metricsToSignals as s}from"./lifecycle/metric-collectors.js";import{trackLifecycleAssessment as c,trackLifecycleStageChange as l}from"./lifecycle/posthog-bridge.js";export{n as ChurnPredictor,t as CohortTracker,e as FunnelAnalyzer,r as GrowthHypothesisGenerator,i as collectLifecycleMetrics,a as createStageChangeEvent,o as lifecycleEventNames,s as metricsToSignals,c as trackLifecycleAssessment,l as trackLifecycleStageChange};
+import { FunnelAnalyzer } from "./funnel/analyzer.js";
+import { CohortTracker } from "./cohort/tracker.js";
+import "./cohort/index.js";
+import { ChurnPredictor } from "./churn/predictor.js";
+import "./churn/index.js";
+import { GrowthHypothesisGenerator } from "./growth/hypothesis-generator.js";
+import { collectLifecycleMetrics, createStageChangeEvent, lifecycleEventNames, metricsToSignals } from "./lifecycle/metric-collectors.js";
+import { trackLifecycleAssessment, trackLifecycleStageChange } from "./lifecycle/posthog-bridge.js";
+
+export { ChurnPredictor, CohortTracker, FunnelAnalyzer, GrowthHypothesisGenerator, collectLifecycleMetrics, createStageChangeEvent, lifecycleEventNames, metricsToSignals, trackLifecycleAssessment, trackLifecycleStageChange };

package/dist/lifecycle/index.d.ts

@@ -0,0 +1,3 @@
+import { LifecycleMetricSource, LifecycleStageChangePayload, collectLifecycleMetrics, createStageChangeEvent, lifecycleEventNames, metricsToSignals } from "./metric-collectors.js";
+import { PostHogLikeClient, trackLifecycleAssessment, trackLifecycleStageChange } from "./posthog-bridge.js";
+export { LifecycleMetricSource, LifecycleStageChangePayload, PostHogLikeClient, collectLifecycleMetrics, createStageChangeEvent, lifecycleEventNames, metricsToSignals, trackLifecycleAssessment, trackLifecycleStageChange };

package/dist/lifecycle/index.js

@@ -1 +1,4 @@
-import{collectLifecycleMetrics as e,createStageChangeEvent as t,lifecycleEventNames as n,metricsToSignals as r}from"./metric-collectors.js";import{trackLifecycleAssessment as i,trackLifecycleStageChange as a}from"./posthog-bridge.js";export{e as collectLifecycleMetrics,t as createStageChangeEvent,n as lifecycleEventNames,r as metricsToSignals,i as trackLifecycleAssessment,a as trackLifecycleStageChange};
+import { collectLifecycleMetrics, createStageChangeEvent, lifecycleEventNames, metricsToSignals } from "./metric-collectors.js";
+import { trackLifecycleAssessment, trackLifecycleStageChange } from "./posthog-bridge.js";
+
+export { collectLifecycleMetrics, createStageChangeEvent, lifecycleEventNames, metricsToSignals, trackLifecycleAssessment, trackLifecycleStageChange };

package/dist/lifecycle/metric-collectors.d.ts

@@ -0,0 +1,30 @@
+import { AnalyticsEvent } from "../types.js";
+import { LifecycleMetricSnapshot, LifecycleSignal, LifecycleStage } from "@lssm/lib.lifecycle";
+
+//#region src/lifecycle/metric-collectors.d.ts
+interface LifecycleMetricSource {
+  getActiveUsers(): Promise<number | undefined>;
+  getWeeklyActiveUsers?(): Promise<number | undefined>;
+  getRetentionRate?(): Promise<number | undefined>;
+  getMonthlyRecurringRevenue?(): Promise<number | undefined>;
+  getCustomerCount?(): Promise<number | undefined>;
+  getTeamSize?(): Promise<number | undefined>;
+  getBurnMultiple?(): Promise<number | undefined>;
+}
+declare const collectLifecycleMetrics: (source: LifecycleMetricSource) => Promise<LifecycleMetricSnapshot>;
+declare const metricsToSignals: (metrics: LifecycleMetricSnapshot, tenantId?: string) => LifecycleSignal[];
+declare const lifecycleEventNames: {
+  readonly assessmentRun: "lifecycle_assessment_run";
+  readonly stageChanged: "lifecycle_stage_changed";
+  readonly guidanceConsumed: "lifecycle_guidance_consumed";
+};
+interface LifecycleStageChangePayload {
+  tenantId?: string;
+  previousStage?: LifecycleStage;
+  nextStage: LifecycleStage;
+  confidence: number;
+}
+declare const createStageChangeEvent: (payload: LifecycleStageChangePayload) => AnalyticsEvent;
+//#endregion
+export { LifecycleMetricSource, LifecycleStageChangePayload, collectLifecycleMetrics, createStageChangeEvent, lifecycleEventNames, metricsToSignals };
+//# sourceMappingURL=metric-collectors.d.ts.map

package/dist/lifecycle/metric-collectors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metric-collectors.d.ts","names":[],"sources":["../../src/lifecycle/metric-collectors.ts"],"sourcesContent":[],"mappings":";;;;UAOiB,qBAAA;oBACG;EADH,oBAAA,GAAA,EAEU,OAFW,CAAA,MAAA,GAAA,SAAA,CAAA;EAClB,gBAAA,GAAA,EAEG,OAFH,CAAA,MAAA,GAAA,SAAA,CAAA;EACO,0BAAA,GAAA,EAEM,OAFN,CAAA,MAAA,GAAA,SAAA,CAAA;EACJ,gBAAA,GAAA,EAEA,OAFA,CAAA,MAAA,GAAA,SAAA,CAAA;EACU,WAAA,GAAA,EAEf,OAFe,CAAA,MAAA,GAAA,SAAA,CAAA;EACV,eAAA,GAAA,EAED,OAFC,CAAA,MAAA,GAAA,SAAA,CAAA;;AAED,cAGT,uBAHS,EAAA,CAAA,MAAA,EAIZ,qBAJY,EAAA,GAKnB,OALmB,CAKX,uBALW,CAAA;AAAO,cAmChB,gBAnCgB,EAAA,CAAA,OAAA,EAoClB,uBApCkB,EAAA,QAAA,CAAA,EAAA,MAAA,EAAA,GAsC1B,eAtC0B,EAAA;AAGhB,cAkDA,mBApBZ,EAAA;EA7BS,SAAA,aAAA,EAAA,0BAAA;EACC,SAAA,YAAA,EAAA,yBAAA;EAAR,SAAA,gBAAA,EAAA,6BAAA;CAAO;AA8BG,UAwBI,2BAAA,CAvBN;EAiBE,QAAA,CAAA,EAAA,MAAA;EAMI,aAAA,CAAA,EAEC,cAF0B;EAO/B,SAAA,EAJA,cAYX;;;cARW,kCACF,gCACR"}

package/dist/lifecycle/metric-collectors.js

@@ -1 +1,48 @@
-const e=async e=>{let[t,n,r,i,a,o,s]=await Promise.all([e.getActiveUsers(),e.getWeeklyActiveUsers?.(),e.getRetentionRate?.(),e.getMonthlyRecurringRevenue?.(),e.getCustomerCount?.(),e.getTeamSize?.(),e.getBurnMultiple?.()]);return{activeUsers:t,weeklyActiveUsers:n,retentionRate:r,monthlyRecurringRevenue:i,customerCount:a,teamSize:o,burnMultiple:s}},t=(e,t)=>Object.entries(e).filter(([,e])=>e!=null).map(([e,n])=>({id:`lifecycle-metric:${e}`,kind:`metric`,source:`analytics`,name:e,value:n,weight:1,confidence:.8,details:t?{tenantId:t}:void 0,capturedAt:new Date().toISOString()})),n={assessmentRun:`lifecycle_assessment_run`,stageChanged:`lifecycle_stage_changed`,guidanceConsumed:`lifecycle_guidance_consumed`},r=e=>({name:n.stageChanged,userId:`system`,tenantId:e.tenantId,timestamp:new Date,properties:{...e}});export{e as collectLifecycleMetrics,r as createStageChangeEvent,n as lifecycleEventNames,t as metricsToSignals};
+//#region src/lifecycle/metric-collectors.ts
+const collectLifecycleMetrics = async (source) => {
+	const [activeUsers, weeklyActiveUsers, retentionRate, monthlyRecurringRevenue, customerCount, teamSize, burnMultiple] = await Promise.all([
+		source.getActiveUsers(),
+		source.getWeeklyActiveUsers?.(),
+		source.getRetentionRate?.(),
+		source.getMonthlyRecurringRevenue?.(),
+		source.getCustomerCount?.(),
+		source.getTeamSize?.(),
+		source.getBurnMultiple?.()
+	]);
+	return {
+		activeUsers,
+		weeklyActiveUsers,
+		retentionRate,
+		monthlyRecurringRevenue,
+		customerCount,
+		teamSize,
+		burnMultiple
+	};
+};
+const metricsToSignals = (metrics, tenantId) => Object.entries(metrics).filter(([, value]) => value !== void 0 && value !== null).map(([metricKey, value]) => ({
+	id: `lifecycle-metric:${metricKey}`,
+	kind: "metric",
+	source: "analytics",
+	name: metricKey,
+	value,
+	weight: 1,
+	confidence: .8,
+	details: tenantId ? { tenantId } : void 0,
+	capturedAt: (/* @__PURE__ */ new Date()).toISOString()
+}));
+const lifecycleEventNames = {
+	assessmentRun: "lifecycle_assessment_run",
+	stageChanged: "lifecycle_stage_changed",
+	guidanceConsumed: "lifecycle_guidance_consumed"
+};
+const createStageChangeEvent = (payload) => ({
+	name: lifecycleEventNames.stageChanged,
+	userId: "system",
+	tenantId: payload.tenantId,
+	timestamp: /* @__PURE__ */ new Date(),
+	properties: { ...payload }
+});
+
+//#endregion
+export { collectLifecycleMetrics, createStageChangeEvent, lifecycleEventNames, metricsToSignals };
+//# sourceMappingURL=metric-collectors.js.map

package/dist/lifecycle/metric-collectors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metric-collectors.js","names":[],"sources":["../../src/lifecycle/metric-collectors.ts"],"sourcesContent":["import type {\n  LifecycleMetricSnapshot,\n  LifecycleSignal,\n  LifecycleStage,\n} from '@lssm/lib.lifecycle';\nimport type { AnalyticsEvent } from '../types';\n\nexport interface LifecycleMetricSource {\n  getActiveUsers(): Promise<number | undefined>;\n  getWeeklyActiveUsers?(): Promise<number | undefined>;\n  getRetentionRate?(): Promise<number | undefined>;\n  getMonthlyRecurringRevenue?(): Promise<number | undefined>;\n  getCustomerCount?(): Promise<number | undefined>;\n  getTeamSize?(): Promise<number | undefined>;\n  getBurnMultiple?(): Promise<number | undefined>;\n}\n\nexport const collectLifecycleMetrics = async (\n  source: LifecycleMetricSource\n): Promise<LifecycleMetricSnapshot> => {\n  const [\n    activeUsers,\n    weeklyActiveUsers,\n    retentionRate,\n    monthlyRecurringRevenue,\n    customerCount,\n    teamSize,\n    burnMultiple,\n  ] = await Promise.all([\n    source.getActiveUsers(),\n    source.getWeeklyActiveUsers?.(),\n    source.getRetentionRate?.(),\n    source.getMonthlyRecurringRevenue?.(),\n    source.getCustomerCount?.(),\n    source.getTeamSize?.(),\n    source.getBurnMultiple?.(),\n  ]);\n\n  return {\n    activeUsers,\n    weeklyActiveUsers,\n    retentionRate,\n    monthlyRecurringRevenue,\n    customerCount,\n    teamSize,\n    burnMultiple,\n  };\n};\n\nexport const metricsToSignals = (\n  metrics: LifecycleMetricSnapshot,\n  tenantId?: string\n): LifecycleSignal[] =>\n  Object.entries(metrics)\n    .filter(([, value]) => value !== undefined && value !== null)\n    .map(([metricKey, value]) => ({\n      id: `lifecycle-metric:${metricKey}`,\n      kind: 'metric',\n      source: 'analytics',\n      name: metricKey,\n      value,\n      weight: 1,\n      confidence: 0.8,\n      details: tenantId ? { tenantId } : undefined,\n      capturedAt: new Date().toISOString(),\n    }));\n\nexport const lifecycleEventNames = {\n  assessmentRun: 'lifecycle_assessment_run',\n  stageChanged: 'lifecycle_stage_changed',\n  guidanceConsumed: 'lifecycle_guidance_consumed',\n} as const;\n\nexport interface LifecycleStageChangePayload {\n  tenantId?: string;\n  previousStage?: LifecycleStage;\n  nextStage: LifecycleStage;\n  confidence: number;\n}\n\nexport const createStageChangeEvent = (\n  payload: LifecycleStageChangePayload\n): AnalyticsEvent => ({\n  name: lifecycleEventNames.stageChanged,\n  userId: 'system',\n  tenantId: payload.tenantId,\n  timestamp: new Date(),\n  properties: { ...payload },\n});\n"],"mappings":";AAiBA,MAAa,0BAA0B,OACrC,WACqC;CACrC,MAAM,CACJ,aACA,mBACA,eACA,yBACA,eACA,UACA,gBACE,MAAM,QAAQ,IAAI;EACpB,OAAO,gBAAgB;EACvB,OAAO,wBAAwB;EAC/B,OAAO,oBAAoB;EAC3B,OAAO,8BAA8B;EACrC,OAAO,oBAAoB;EAC3B,OAAO,eAAe;EACtB,OAAO,mBAAmB;EAC3B,CAAC;AAEF,QAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACA;EACD;;AAGH,MAAa,oBACX,SACA,aAEA,OAAO,QAAQ,QAAQ,CACpB,QAAQ,GAAG,WAAW,UAAU,UAAa,UAAU,KAAK,CAC5D,KAAK,CAAC,WAAW,YAAY;CAC5B,IAAI,oBAAoB;CACxB,MAAM;CACN,QAAQ;CACR,MAAM;CACN;CACA,QAAQ;CACR,YAAY;CACZ,SAAS,WAAW,EAAE,UAAU,GAAG;CACnC,6BAAY,IAAI,MAAM,EAAC,aAAa;CACrC,EAAE;AAEP,MAAa,sBAAsB;CACjC,eAAe;CACf,cAAc;CACd,kBAAkB;CACnB;AASD,MAAa,0BACX,aACoB;CACpB,MAAM,oBAAoB;CAC1B,QAAQ;CACR,UAAU,QAAQ;CAClB,2BAAW,IAAI,MAAM;CACrB,YAAY,EAAE,GAAG,SAAS;CAC3B"}

package/dist/lifecycle/posthog-bridge.d.ts

@@ -0,0 +1,15 @@
+import { LifecycleAssessment } from "@lssm/lib.lifecycle";
+
+//#region src/lifecycle/posthog-bridge.d.ts
+interface PostHogLikeClient {
+  capture: (event: {
+    distinctId: string;
+    event: string;
+    properties?: Record<string, unknown>;
+  }) => Promise<void> | void;
+}
+declare const trackLifecycleAssessment: (client: PostHogLikeClient, tenantId: string, assessment: LifecycleAssessment) => Promise<void>;
+declare const trackLifecycleStageChange: (client: PostHogLikeClient, tenantId: string, previousStage: number | undefined, nextStage: number) => Promise<void>;
+//#endregion
+export { PostHogLikeClient, trackLifecycleAssessment, trackLifecycleStageChange };
+//# sourceMappingURL=posthog-bridge.d.ts.map

package/dist/lifecycle/posthog-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"posthog-bridge.d.ts","names":[],"sources":["../../src/lifecycle/posthog-bridge.ts"],"sourcesContent":[],"mappings":";;;UAGiB,iBAAA;;IAAA,UAAA,EAAA,MAAiB;IAQrB,KAAA,EAAA,MAAA;IACH,UAAA,CAAA,EALO,MAKP,CAAA,MAAA,EAAA,OAAA,CAAA;EAEI,CAAA,EAAA,GANN,OAMM,CAAA,IAAA,CAAA,GAAA,IAAA;;AAAmB,cAHpB,wBAGoB,EAAA,CAAA,MAAA,EAFvB,iBAEuB,EAAA,QAAA,EAAA,MAAA,EAAA,UAAA,EAAnB,mBAAmB,EAAA,GAAA,OAAA,CAAA,IAAA,CAAA;AAapB,cAAA,yBACH,EAAA,CAAA,MAAA,EAAA,iBAGS,EAAA,QAAA,EAAA,MAAA,EAAA,aAAA,EAAA,MAAA,GAAA,SAAA,EAAA,SAAA,EAAA,MAAA,EAAA,GAAA,OAAA,CAAA,IAAA,CAAA"}

package/dist/lifecycle/posthog-bridge.js

@@ -1 +1,28 @@
-import{lifecycleEventNames as e}from"./metric-collectors.js";const t=async(t,n,r)=>{await t.capture({distinctId:n,event:e.assessmentRun,properties:{stage:r.stage,confidence:r.confidence,axes:r.axes}})},n=async(t,n,r,i)=>{await t.capture({distinctId:n,event:e.stageChanged,properties:{previousStage:r,nextStage:i}})};export{t as trackLifecycleAssessment,n as trackLifecycleStageChange};
+import { lifecycleEventNames } from "./metric-collectors.js";
+
+//#region src/lifecycle/posthog-bridge.ts
+const trackLifecycleAssessment = async (client, tenantId, assessment) => {
+	await client.capture({
+		distinctId: tenantId,
+		event: lifecycleEventNames.assessmentRun,
+		properties: {
+			stage: assessment.stage,
+			confidence: assessment.confidence,
+			axes: assessment.axes
+		}
+	});
+};
+const trackLifecycleStageChange = async (client, tenantId, previousStage, nextStage) => {
+	await client.capture({
+		distinctId: tenantId,
+		event: lifecycleEventNames.stageChanged,
+		properties: {
+			previousStage,
+			nextStage
+		}
+	});
+};
+
+//#endregion
+export { trackLifecycleAssessment, trackLifecycleStageChange };
+//# sourceMappingURL=posthog-bridge.js.map

package/dist/lifecycle/posthog-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"posthog-bridge.js","names":[],"sources":["../../src/lifecycle/posthog-bridge.ts"],"sourcesContent":["import type { LifecycleAssessment } from '@lssm/lib.lifecycle';\nimport { lifecycleEventNames } from './metric-collectors';\n\nexport interface PostHogLikeClient {\n  capture: (event: {\n    distinctId: string;\n    event: string;\n    properties?: Record<string, unknown>;\n  }) => Promise<void> | void;\n}\n\nexport const trackLifecycleAssessment = async (\n  client: PostHogLikeClient,\n  tenantId: string,\n  assessment: LifecycleAssessment\n) => {\n  await client.capture({\n    distinctId: tenantId,\n    event: lifecycleEventNames.assessmentRun,\n    properties: {\n      stage: assessment.stage,\n      confidence: assessment.confidence,\n      axes: assessment.axes,\n    },\n  });\n};\n\nexport const trackLifecycleStageChange = async (\n  client: PostHogLikeClient,\n  tenantId: string,\n  previousStage: number | undefined,\n  nextStage: number\n) => {\n  await client.capture({\n    distinctId: tenantId,\n    event: lifecycleEventNames.stageChanged,\n    properties: {\n      previousStage,\n      nextStage,\n    },\n  });\n};\n"],"mappings":";;;AAWA,MAAa,2BAA2B,OACtC,QACA,UACA,eACG;AACH,OAAM,OAAO,QAAQ;EACnB,YAAY;EACZ,OAAO,oBAAoB;EAC3B,YAAY;GACV,OAAO,WAAW;GAClB,YAAY,WAAW;GACvB,MAAM,WAAW;GAClB;EACF,CAAC;;AAGJ,MAAa,4BAA4B,OACvC,QACA,UACA,eACA,cACG;AACH,OAAM,OAAO,QAAQ;EACnB,YAAY;EACZ,OAAO,oBAAoB;EAC3B,YAAY;GACV;GACA;GACD;EACF,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,68 @@
+//#region src/types.d.ts
+interface AnalyticsEvent {
+  name: string;
+  userId: string;
+  tenantId?: string;
+  timestamp: string | Date;
+  properties?: Record<string, unknown>;
+}
+interface FunnelStep {
+  id: string;
+  eventName: string;
+  match?: (event: AnalyticsEvent) => boolean;
+}
+interface FunnelDefinition {
+  name: string;
+  steps: FunnelStep[];
+  windowHours?: number;
+}
+interface FunnelStepResult {
+  step: FunnelStep;
+  count: number;
+  conversionRate: number;
+  dropOffRate: number;
+}
+interface FunnelAnalysis {
+  definition: FunnelDefinition;
+  totalUsers: number;
+  steps: FunnelStepResult[];
+}
+interface CohortEvent extends AnalyticsEvent {
+  amount?: number;
+}
+interface CohortDefinition {
+  bucket: 'day' | 'week' | 'month';
+  periods: number;
+  startDate?: Date;
+}
+interface CohortStats {
+  cohortKey: string;
+  users: number;
+  retention: number[];
+  ltv: number;
+}
+interface CohortAnalysis {
+  definition: CohortDefinition;
+  cohorts: CohortStats[];
+}
+interface ChurnSignal {
+  userId: string;
+  score: number;
+  bucket: 'low' | 'medium' | 'high';
+  drivers: string[];
+}
+interface GrowthMetric {
+  name: string;
+  current: number;
+  previous?: number;
+  target?: number;
+}
+interface GrowthHypothesis {
+  statement: string;
+  metric: string;
+  confidence: 'low' | 'medium' | 'high';
+  impact: 'low' | 'medium' | 'high';
+}
+//#endregion
+export { AnalyticsEvent, ChurnSignal, CohortAnalysis, CohortDefinition, CohortEvent, CohortStats, FunnelAnalysis, FunnelDefinition, FunnelStep, FunnelStepResult, GrowthHypothesis, GrowthMetric };
+//# 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,cAAA;EAAA,IAAA,EAAA,MAAA;EAQA,MAAA,EAAA,MAAU;EAMV,QAAA,CAAA,EAAA,MAAA;EAMA,SAAA,EAAA,MAAA,GAhBK,IAgBW;EAOhB,UAAA,CAAA,EAtBF,MAsBgB,CAAA,MAAA,EACjB,OAAA,CAAA;AAKd;AAIiB,UA7BA,UAAA,CA6BgB;EAMhB,EAAA,EAAA,MAAA;EAOA,SAAA,EAAA,MAAc;EAKd,KAAA,CAAA,EAAA,CAAA,KAAW,EA5CV,cA4CU,EAAA,GAAA,OAAA;AAO5B;AAOiB,UAvDA,gBAAA,CAuDgB;;SArDxB;;;UAIQ,gBAAA;QACT;;;;;UAMS,cAAA;cACH;;SAEL;;UAGQ,WAAA,SAAoB;;;UAIpB,gBAAA;;;cAGH;;UAGG,WAAA;;;;;;UAOA,cAAA;cACH;WACH;;UAGM,WAAA;;;;;;UAOA,YAAA;;;;;;UAOA,gBAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lssm/lib.analytics",
-  "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,29 +23,29 @@
     "test": "bun run"
   },
   "dependencies": {
-    "@lssm/lib.lifecycle": "1.42.0",
+    "@lssm/lib.lifecycle": "1.42.2",
     "dayjs": "^1.11.13"
   },
   "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",
-    "./churn": "./src/churn/index.ts",
-    "./churn/predictor": "./src/churn/predictor.ts",
-    "./cohort": "./src/cohort/index.ts",
-    "./cohort/tracker": "./src/cohort/tracker.ts",
-    "./funnel": "./src/funnel/index.ts",
-    "./funnel/analyzer": "./src/funnel/analyzer.ts",
-    "./growth": "./src/growth/index.ts",
-    "./growth/hypothesis-generator": "./src/growth/hypothesis-generator.ts",
-    "./lifecycle": "./src/lifecycle/index.ts",
-    "./lifecycle/metric-collectors": "./src/lifecycle/metric-collectors.ts",
-    "./lifecycle/posthog-bridge": "./src/lifecycle/posthog-bridge.ts",
-    "./types": "./src/types.ts",
+    ".": "./dist/index.js",
+    "./churn": "./dist/churn/index.js",
+    "./churn/predictor": "./dist/churn/predictor.js",
+    "./cohort": "./dist/cohort/index.js",
+    "./cohort/tracker": "./dist/cohort/tracker.js",
+    "./funnel": "./dist/funnel/index.js",
+    "./funnel/analyzer": "./dist/funnel/analyzer.js",
+    "./growth": "./dist/growth/index.js",
+    "./growth/hypothesis-generator": "./dist/growth/hypothesis-generator.js",
+    "./lifecycle": "./dist/lifecycle/index.js",
+    "./lifecycle/metric-collectors": "./dist/lifecycle/metric-collectors.js",
+    "./lifecycle/posthog-bridge": "./dist/lifecycle/posthog-bridge.js",
+    "./types": "./dist/types.js",
     "./*": "./*"
   },
   "publishConfig": {
@@ -65,6 +65,13 @@
       "./lifecycle/posthog-bridge": "./dist/lifecycle/posthog-bridge.js",
       "./types": "./dist/types.js",
       "./*": "./*"
-    }
+    },
+    "registry": "https://registry.npmjs.org/"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lssm-tech/contractspec.git",
+    "directory": "packages/libs/analytics"
   }
 }