@lssm/lib.analytics 0.4.1 → 1.41.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lssm/lib.analytics",
-  "version": "0.4.1",
+  "version": "1.41.1",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -11,6 +11,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:bundle": "tsdown",
     "build:types": "tsc --noEmit",
@@ -22,32 +23,48 @@
     "test": "bun run"
   },
   "dependencies": {
-    "@lssm/lib.lifecycle": "0.3.1",
+    "@lssm/lib.lifecycle": "1.41.1",
     "dayjs": "^1.11.13"
   },
   "devDependencies": {
-    "@lssm/tool.tsdown": "0.12.1",
-    "@lssm/tool.typescript": "0.11.1",
-    "tsdown": "^0.16.6",
+    "@lssm/tool.tsdown": "1.41.1",
+    "@lssm/tool.typescript": "1.41.1",
+    "tsdown": "^0.17.4",
     "typescript": "^5.9.3"
   },
   "exports": {
-    ".": "./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",
+    ".": "./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",
     "./*": "./*"
   },
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "exports": {
+      ".": "./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",
+      "./*": "./*"
+    }
   }
 }

package/dist/churn/index.d.ts

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

package/dist/churn/predictor.d.ts

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

package/dist/cohort/index.d.ts

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

package/dist/cohort/tracker.d.ts

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

package/dist/funnel/analyzer.d.ts

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

package/dist/funnel/index.d.ts

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

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

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

package/dist/growth/index.d.ts

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

package/dist/index.d.ts

@@ -1,8 +0,0 @@
-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/lifecycle/index.d.ts

@@ -1,3 +0,0 @@
-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/metric-collectors.d.ts

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

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

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

package/dist/types.d.ts

@@ -1,67 +0,0 @@
-//#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 };