module.social-analytics

@lssm-tech/module.social-analytics

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.
• 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.

Commandes

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