lib.analytics
Product analytics and growth metrics
@lssm-tech/lib.analyticsbun add @lssm-tech/lib.analyticsManifest declarations describe the current workspace; they do not verify registry publication or runtime execution.
Package guide
Website: https://contractspec.io
Product analytics and growth metrics.
What It Provides
- Layer: lib.
- Consumers: bundles, apps.
- 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/churnis part of the package's public or composition surface.src/cohortis part of the package's public or composition surface.src/funnelis part of the package's public or composition surface.src/growthis part of the package's public or composition surface.src/index.tsis the root public barrel and package entrypoint.src/lifecycleis part of the package's public or composition surface.src/measurementis the single consent-gated product measurement owner: value-free event sets (closed enums, booleans, bounded counts), a recorder that captures only with a granted preference for the exact policy revision, rejects undeclared or personal-data properties, never throws and bounds every consent/store/provider call, plus outcome aggregates keyed byproductApplicationId(reported as product outcomes, never employment impact), small-cohort suppression, and retention/withdrawal purge.src/posthogis part of the package's public or composition surface.src/types.tsis shared public type definitions.
Public Entry Points
- Export
.resolves through./src/index.ts. - Export
./churnresolves through./src/churn/index.ts. - Export
./churn/predictorresolves through./src/churn/predictor.ts. - Export
./cohortresolves through./src/cohort/index.ts. - Export
./cohort/trackerresolves through./src/cohort/tracker.ts. - Export
./funnelresolves through./src/funnel/index.ts. - Export
./funnel/analyzerresolves through./src/funnel/analyzer.ts. - Export
./growthresolves through./src/growth/index.ts. - Export
./growth/hypothesis-generatorresolves through./src/growth/hypothesis-generator.ts. - Export
./lifecycleresolves through./src/lifecycle/index.ts. - Export
./measurementresolves through./src/measurement/index.ts. - The package publishes 19 total export subpaths; keep docs aligned with
package.json.
Local Commands
bun run dev— contractspec-bun-build devbun run build— contractspec-bun-build buildbun run test— bun test --pass-with-no-testsbun run lint— bun lint:fixbun run lint:check— biome check .bun run lint:fix— biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write .bun run typecheck— tsgo --noEmitbun run publish:pkg— bun publish --tolerate-republish --ignore-scripts --verbosebun run publish:pkg:canary— bun publish:pkg --tag canarybun run clean— rimraf dist .turbobun run build:bundle— contractspec-bun-build transpilebun run build:types— contractspec-bun-build typesbun 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.
Relationships
Arrows point from a package to its direct dependency. Counts are derived from captured workspace manifests.
4 declarations
@lssm-tech/lib.contracts-spec-coreworkspace:^
Read the package manual ↗@lssm-tech/lib.contracts-integrationsworkspace:^
Read the package manual ↗@lssm-tech/lib.lifecycleworkspace:^
Read the package manual ↗dayjs^1.11.23
Declared capabilities
Product analytics and growth metrics
Scripts
publish:pkgbun publish --tolerate-republish --ignore-scripts --verbosepublish:pkg:canarybun publish:pkg --tag canarybuildcontractspec-bun-build buildbuild:bundlecontractspec-bun-build transpilebuild:typescontractspec-bun-build typesdevcontractspec-bun-build devcleanrimraf dist .turbolintbun lint:fixlint:fixnode ../../../../scripts/biome.cjs check --write --unsafe --only=nursery/useSortedClasses . && node ../../../../scripts/biome.cjs check --write .lint:checknode ../../../../scripts/biome.cjs check .testbun test --pass-with-no-testsprebuildcontractspec-bun-build prebuildtypechecktsgo --noEmit