@contractspec/lib.analytics 1.57.0 → 1.58.0

package/dist/cohort/index.js

@@ -1,3 +1,118 @@
-import { CohortTracker } from "./tracker.js";
+// @bun
+// src/cohort/tracker.ts
+import dayjs from "dayjs";
 
-export { CohortTracker };
+class CohortTracker {
+  analyze(events, definition) {
+    const groupedByUser = groupBy(events, (event) => event.userId);
+    const cohorts = 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())
+    };
+  }
+}
+
+class CohortStatsBuilder {
+  key;
+  definition;
+  users = new Set;
+  retentionMap = 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) ?? 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 = 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();
+}
+export {
+  CohortTracker
+};

package/dist/cohort/tracker.d.ts

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

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

@@ -1 +1 @@
-{"version":3,"file":"tracker.d.ts","names":[],"sources":["../../src/cohort/tracker.ts"],"mappings":";;;cAQa,aAAA;EACX,OAAA,CACE,MAAA,EAAQ,cAAA,IACR,UAAA,EAAY,gBAAA,GACX,cAAA;AAAA"}
+{"version":3,"file":"tracker.d.ts","sourceRoot":"","sources":["../../src/cohort/tracker.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,gBAAgB,EAEjB,MAAM,UAAU,CAAC;AAElB,qBAAa,aAAa;IACxB,OAAO,CACL,MAAM,EAAE,cAAc,EAAE,EACxB,UAAU,EAAE,gBAAgB,GAC3B,cAAc;CAuBlB"}

package/dist/cohort/tracker.js

@@ -1,99 +1,118 @@
+// @bun
+// src/cohort/tracker.ts
 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))
-		};
-	}
-};
+class CohortTracker {
+  analyze(events, definition) {
+    const groupedByUser = groupBy(events, (event) => event.userId);
+    const cohorts = 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())
+    };
+  }
+}
+
+class CohortStatsBuilder {
+  key;
+  definition;
+  users = new Set;
+  retentionMap = 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) ?? 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;
+  const map = 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");
-		default: return dt.startOf("month").format("YYYY-MM");
-	}
+  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");
-		default: return target.diff(start, "month");
-	}
+  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");
-		default: return dayjs(key, "YYYY-MM");
-	}
+  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();
+  return new Date(event.timestamp).getTime();
 }
-
-//#endregion
-export { CohortTracker };
-//# sourceMappingURL=tracker.js.map
+export {
+  CohortTracker
+};

package/dist/funnel/analyzer.d.ts

@@ -1,10 +1,6 @@
-import { AnalyticsEvent, FunnelAnalysis, FunnelDefinition } from "../types.js";
-
-//#region src/funnel/analyzer.d.ts
-declare class FunnelAnalyzer {
-  analyze(events: AnalyticsEvent[], definition: FunnelDefinition): FunnelAnalysis;
-  private evaluateUser;
+import type { AnalyticsEvent, FunnelAnalysis, FunnelDefinition } from '../types';
+export 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

@@ -1 +1 @@
-{"version":3,"file":"analyzer.d.ts","names":[],"sources":["../../src/funnel/analyzer.ts"],"mappings":";;;cAQa,cAAA;EACX,OAAA,CACE,MAAA,EAAQ,cAAA,IACR,UAAA,EAAY,gBAAA,GACX,cAAA;EAAA,QAmCK,YAAA;AAAA"}
+{"version":3,"file":"analyzer.d.ts","sourceRoot":"","sources":["../../src/funnel/analyzer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,gBAAgB,EAGjB,MAAM,UAAU,CAAC;AAElB,qBAAa,cAAc;IACzB,OAAO,CACL,MAAM,EAAE,cAAc,EAAE,EACxB,UAAU,EAAE,gBAAgB,GAC3B,cAAc;IAmCjB,OAAO,CAAC,YAAY;CAmCrB"}

package/dist/funnel/analyzer.js

@@ -1,64 +1,69 @@
-//#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;
-	}
-};
+// @bun
+// src/funnel/analyzer.ts
+class FunnelAnalyzer {
+  analyze(events, definition) {
+    const windowMs = (definition.windowHours ?? 72) * 60 * 60 * 1000;
+    const eventsByUser = groupByUser(events);
+    const stepCounts = definition.steps.map(() => 0);
+    for (const userEvents of eventsByUser.values()) {
+      const completionIndex = this.evaluateUser(userEvents, definition.steps, windowMs);
+      completionIndex.forEach((hit, stepIdx) => {
+        if (hit) {
+          stepCounts[stepIdx] = (stepCounts[stepIdx] ?? 0) + 1;
+        }
+      });
+    }
+    const totalUsers = eventsByUser.size;
+    const 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));
+      const dropOffRate = Number((1 - conversionRate).toFixed(3));
+      return { step, count, conversionRate, dropOffRate };
+    });
+    return {
+      definition,
+      totalUsers,
+      steps
+    };
+  }
+  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;
+  const map = 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
+export {
+  FunnelAnalyzer
+};

package/dist/funnel/index.d.ts

@@ -1,2 +1,2 @@
-import { FunnelAnalyzer } from "./analyzer.js";
-export { FunnelAnalyzer };
+export * from './analyzer';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/funnel/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC"}

package/dist/funnel/index.js

@@ -1,3 +1,69 @@
-import { FunnelAnalyzer } from "./analyzer.js";
-
-export { FunnelAnalyzer };
+// @bun
+// src/funnel/analyzer.ts
+class FunnelAnalyzer {
+  analyze(events, definition) {
+    const windowMs = (definition.windowHours ?? 72) * 60 * 60 * 1000;
+    const eventsByUser = groupByUser(events);
+    const stepCounts = definition.steps.map(() => 0);
+    for (const userEvents of eventsByUser.values()) {
+      const completionIndex = this.evaluateUser(userEvents, definition.steps, windowMs);
+      completionIndex.forEach((hit, stepIdx) => {
+        if (hit) {
+          stepCounts[stepIdx] = (stepCounts[stepIdx] ?? 0) + 1;
+        }
+      });
+    }
+    const totalUsers = eventsByUser.size;
+    const 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));
+      const dropOffRate = Number((1 - conversionRate).toFixed(3));
+      return { step, count, conversionRate, dropOffRate };
+    });
+    return {
+      definition,
+      totalUsers,
+      steps
+    };
+  }
+  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 = new Map;
+  for (const event of events) {
+    const list = map.get(event.userId) ?? [];
+    list.push(event);
+    map.set(event.userId, list);
+  }
+  return map;
+}
+export {
+  FunnelAnalyzer
+};

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

@@ -1,18 +1,14 @@
-import { GrowthHypothesis, GrowthMetric } from "../types.js";
-
-//#region src/growth/hypothesis-generator.d.ts
-interface HypothesisGeneratorOptions {
-  minDelta?: number;
+import type { GrowthHypothesis, GrowthMetric } from '../types';
+export 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;
+export 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

@@ -1 +1 @@
-{"version":3,"file":"hypothesis-generator.d.ts","names":[],"sources":["../../src/growth/hypothesis-generator.ts"],"mappings":";;;UAEiB,0BAAA;EACf,QAAA;AAAA;AAAA,cAGW,yBAAA;EAAA,iBACM,QAAA;cAEL,OAAA,GAAU,0BAAA;EAItB,QAAA,CAAS,OAAA,EAAS,YAAA,KAAiB,gBAAA;EAAA,QAQ3B,UAAA;EAAA,QAaA,KAAA;EAAA,QAMA,MAAA;EAAA,QAMA,SAAA;AAAA"}
+{"version":3,"file":"hypothesis-generator.d.ts","sourceRoot":"","sources":["../../src/growth/hypothesis-generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE/D,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,yBAAyB;IACpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEtB,OAAO,CAAC,EAAE,0BAA0B;IAIhD,QAAQ,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,gBAAgB,EAAE;IAQrD,OAAO,CAAC,UAAU;IAalB,OAAO,CAAC,KAAK;IAMb,OAAO,CAAC,MAAM;IAMd,OAAO,CAAC,SAAS;CAWlB"}