Skip to content
ContractSpec
Start here

Package manual · domains

·Content, growth and creator operations

module.social-analytics

Provider-agnostic social analytics dashboard surfaces.

domainsmodulev2.0.5experimentalservernode
@lssm-tech/module.social-analytics
bun add @lssm-tech/module.social-analytics
Package source ↗Manifest ↗

Manifest declarations describe the current workspace; they do not verify registry publication or runtime execution.

Package guide

Provider-agnostic React dashboard surfaces for creator and content analytics.

The module consumes the social tracking contracts from @lssm-tech/lib.contracts-integrations. Consumers provide a SocialAnalyticsDashboardPort; provider SDKs, credentials, collection jobs, and storage adapters remain outside this package.

Public surfaces

  • core — dashboard/query ports, view models, gap detection, and loaders.
  • core/outcomes — provider-neutral outcome attribution with explicit evidence, source gaps, and observed/correlated/experiment-supported causal labels.
  • core/connected-account — capability grants, account qualification and en/fr connection-state copy over the contract capability matrix; only metric reading can show as granted.
  • presentation/hooks — asynchronous dashboard, granularity, reload, and CSV export state.
  • presentation/components — accessible creator, content, tracking health, freshness/source, explorer, and dashboard components.

Supported explorer granularities are 30 minutes, hour, day, and week. Missing buckets and contract-level source_gap observations are represented explicitly. Every query carries its caller-provided consumerKey unchanged through loading and CSV export so retention and analytics partitions remain aligned. Dashboard detail requests also carry an explicit platform to prevent creator or content identifiers from crossing social-network namespaces.

Commands

  • bun run test
  • bun run typecheck
  • bun run lint:check
  • bun run build

Relationships

THIS PACKAGEmodule.social-analytics6 import paths

Arrows point from a package to its direct dependency. Counts are derived from captured workspace manifests.

4 declarations

Declared capabilities

Module Social Analytics

Provider-agnostic social analytics dashboard surfaces.

Scripts

  • publish:pkgbun publish --tolerate-republish --ignore-scripts --verbose
  • publish:pkg:canarybun publish:pkg --tag canary
  • buildcontractspec-bun-build build
  • build:bundlecontractspec-bun-build transpile
  • build:typescontractspec-bun-build types
  • devcontractspec-bun-build dev
  • cleanrimraf dist .turbo
  • lintbun lint:fix
  • lint:fixnode ../../../../scripts/biome.cjs check --write --unsafe --only=nursery/useSortedClasses . && node ../../../../scripts/biome.cjs check --write .
  • lint:checknode ../../../../scripts/biome.cjs check .
  • testbun test
  • prebuildcontractspec-bun-build prebuild
  • typechecktsgo --noEmit