@lssm/lib.analytics 0.0.0-canary-20251217062943 → 0.0.0-canary-20251217072406

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

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

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

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

package/dist/funnel/analyzer.js

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

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

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

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

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

package/dist/lifecycle/posthog-bridge.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lssm/lib.analytics",
-  "version": "0.0.0-canary-20251217062943",
+  "version": "0.0.0-canary-20251217072406",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -23,12 +23,12 @@
     "test": "bun run"
   },
   "dependencies": {
-    "@lssm/lib.lifecycle": "0.0.0-canary-20251217062943",
+    "@lssm/lib.lifecycle": "0.0.0-canary-20251217072406",
     "dayjs": "^1.11.13"
   },
   "devDependencies": {
-    "@lssm/tool.tsdown": "0.0.0-canary-20251217062943",
-    "@lssm/tool.typescript": "0.0.0-canary-20251217062943",
+    "@lssm/tool.tsdown": "0.0.0-canary-20251217072406",
+    "@lssm/tool.typescript": "0.0.0-canary-20251217072406",
     "tsdown": "^0.17.4",
     "typescript": "^5.9.3"
   },