Source snapshot bcc79fcc · Declared package version 5.0.5. This page combines the checked-in package guide and manifest; commands and runtime behavior were not executed in this review.
Related ContractSpec packages include @lssm-tech/lib.contracts-integrations, @lssm-tech/lib.contracts-spec, @lssm-tech/lib.lifecycle, @lssm-tech/tool.bun, @lssm-tech/tool.typescript.
Related ContractSpec packages include @lssm-tech/lib.contracts-integrations, @lssm-tech/lib.contracts-spec, @lssm-tech/lib.lifecycle, @lssm-tech/tool.bun, @lssm-tech/tool.typescript.
Installation
npm install @lssm-tech/lib.analytics
or
bun add @lssm-tech/lib.analytics
Usage
Import the root entrypoint from @lssm-tech/lib.analytics, or choose a documented subpath when you only need one part of the package surface.
AnalyticsPort is the vendor-neutral write boundary for events and tenant or workspace groups. AnalyticsBackendProfileV1 binds exactly one analytics project to each environment. The default profile is EU-hosted with tenant and workspace grouping; US and explicitly hosted profiles are supported. Profiles carry credential references, retention, sampling, and residency intent rather than provider SDK types or secret values.
Architecture
src/churn is part of the package's public or composition surface.
src/cohort is part of the package's public or composition surface.
src/funnel is part of the package's public or composition surface.
src/growth is part of the package's public or composition surface.
src/index.ts is the root public barrel and package entrypoint.
src/lifecycle is part of the package's public or composition surface.
src/posthog is part of the package's public or composition surface.
src/types.ts is shared public type definitions.
Public Entry Points
Export . resolves through ./src/index.ts.
Export ./churn resolves through ./src/churn/index.ts.
Export ./churn/predictor resolves through ./src/churn/predictor.ts.
Export ./cohort resolves through ./src/cohort/index.ts.
Export ./cohort/tracker resolves through ./src/cohort/tracker.ts.
Export ./funnel resolves through ./src/funnel/index.ts.
Export ./funnel/analyzer resolves through ./src/funnel/analyzer.ts.
Export ./growth resolves through ./src/growth/index.ts.
Export ./growth/hypothesis-generator resolves through ./src/growth/hypothesis-generator.ts.
Export ./lifecycle resolves through ./src/lifecycle/index.ts.
The package publishes 16 total export subpaths; keep docs aligned with package.json.
Local Commands
bun run dev — contractspec-bun-build dev
bun run build — contractspec-bun-build build
bun run test — bun test --pass-with-no-tests
bun run lint — bun lint:fix
bun run lint:check — biome check .
bun run lint:fix — biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write .
bun run typecheck — tsgo --noEmit
bun run publish:pkg — bun publish --tolerate-republish --ignore-scripts --verbose
bun run publish:pkg:canary — bun publish:pkg --tag canary
bun run clean — rimraf dist .turbo
bun run build:bundle — contractspec-bun-build transpile
bun run build:types — contractspec-bun-build types
bun run prebuild — contractspec-bun-build prebuild
Recent Updates
Replace eslint+prettier by biomejs to optimize speed.
Notes
Event naming conventions must stay consistent with PostHog taxonomy.
Metric calculations affect live dashboards; verify formulas before changing.
Declared capabilities.
Lib Analytics
Product analytics and growth metrics
Use it to
Adopt product analytics and growth metrics
Requires
TypeScript
Choose another boundary when
The @lssm-tech/lib.analytics package constraints do not match the target runtime or platform.
These are package-manifest entry points. Named symbols listed above come from the capability catalogue; this is not an exhaustive TypeScript symbol reference.
