{"id":"@lssm-tech/module.social-analytics","slug":"module.social-analytics","name":"@lssm-tech/module.social-analytics","version":"2.0.5","path":"packages/domains/growth/social-analytics","manifestPath":"packages/domains/growth/social-analytics/package.json","manifestBlobSha":"1c749c1828853890ef83d43ac9d45cf81f957492","layer":"domains","physicalArea":"growth","primaryArea":"content-and-growth","classification":{"privateDeclared":null,"catalogFamily":"solutions","catalogKind":"module","catalogStatus":"active","adoptionMode":"adoptable","stability":"experimental"},"description":"Provider-agnostic social analytics dashboard surfaces.","descriptionOrigin":"package.json","catalog":{"family":"solutions","kind":"module","status":"active","adoptionMode":"adoptable","stability":"experimental","platforms":["server"],"runtimes":["node"],"entrypoints":[".","./core","./presentation","./presentation/components","./presentation/hooks"],"documentation":[{"title":"Module Social Analytics documentation","url":"https://www.npmjs.com/package/%40lssm-tech%2Fmodule.social-analytics","kind":"readme"}],"examples":[],"replacements":[],"capabilities":[{"id":"package.lssm.tech.module.social.analytics","title":"Module Social Analytics","description":"Provider-agnostic social analytics dashboard surfaces.","status":"active","useCases":["Adopt provider-agnostic social analytics dashboard surfaces"],"aliases":["contractspec","social","analytics","dashboard","react","module"],"pythonEquivalents":[],"canonicalImports":[{"from":"@lssm-tech/module.social-analytics","symbols":[]},{"from":"@lssm-tech/module.social-analytics/core","symbols":[]},{"from":"@lssm-tech/module.social-analytics/presentation","symbols":[]},{"from":"@lssm-tech/module.social-analytics/presentation/components","symbols":[]},{"from":"@lssm-tech/module.social-analytics/presentation/hooks","symbols":[]}],"constraints":{"platforms":["server"],"runtimes":["node"],"avoidWhen":["The @lssm-tech/module.social-analytics package constraints do not match the target runtime or platform."],"requires":["TypeScript"]},"alternatives":[],"relationships":[],"resolutionPriority":50}],"visualTesting":{"status":"deferred","owner":"@contractspec-core","targetWave":"wave-3-react-packages","rationale":"Foundational Storybook adoption establishes shared catalogs and guardrails before this package migrates."}},"canonicalImports":[{"capabilityId":"package.lssm.tech.module.social.analytics","from":"@lssm-tech/module.social-analytics","symbols":[]},{"capabilityId":"package.lssm.tech.module.social.analytics","from":"@lssm-tech/module.social-analytics/core","symbols":[]},{"capabilityId":"package.lssm.tech.module.social.analytics","from":"@lssm-tech/module.social-analytics/presentation","symbols":[]},{"capabilityId":"package.lssm.tech.module.social.analytics","from":"@lssm-tech/module.social-analytics/presentation/components","symbols":[]},{"capabilityId":"package.lssm.tech.module.social.analytics","from":"@lssm-tech/module.social-analytics/presentation/hooks","symbols":[]}],"scripts":{"publish:pkg":"bun publish --tolerate-republish --ignore-scripts --verbose","publish:pkg:canary":"bun publish:pkg --tag canary","build":"contractspec-bun-build build","build:bundle":"contractspec-bun-build transpile","build:types":"contractspec-bun-build types","dev":"contractspec-bun-build dev","clean":"rimraf dist .turbo","lint":"bun lint:fix","lint:fix":"node ../../../../scripts/biome.cjs check --write --unsafe --only=nursery/useSortedClasses . && node ../../../../scripts/biome.cjs check --write .","lint:check":"node ../../../../scripts/biome.cjs check .","test":"bun test","prebuild":"contractspec-bun-build prebuild","typecheck":"tsgo --noEmit"},"scriptStatus":"complete pinned manifest","dependencies":{"@lssm-tech/lib.contracts-integrations":"workspace:^","@lssm-tech/lib.contracts-spec-core":"workspace:^","@lssm-tech/lib.design-system":"workspace:^","react":"catalog:"},"devDependencies":{"@lssm-tech/tool.bun":"workspace:*","@lssm-tech/tool.typescript":"workspace:*","@types/react":"catalog:types","@types/react-dom":"catalog:types","react-dom":"catalog:","typescript":"catalog:"},"peerDependencies":{"react":"catalog:"},"optionalDependencies":{},"peerDependenciesMeta":{},"bundledDependencies":null,"dependencyStatus":"complete pinned manifest","exports":{".":"./src/index.ts","./core":"./src/core/index.ts","./presentation":"./src/presentation/index.ts","./presentation/components":"./src/presentation/components/index.ts","./presentation/hooks":"./src/presentation/hooks/index.ts"},"publishExports":{".":{"types":"./dist/index.d.ts","browser":"./dist/browser/index.js","bun":"./dist/index.js","node":"./dist/node/index.js","default":"./dist/index.js"},"./core":{"types":"./dist/core/index.d.ts","browser":"./dist/browser/core/index.js","bun":"./dist/core/index.js","node":"./dist/node/core/index.js","default":"./dist/core/index.js"},"./presentation":{"types":"./dist/presentation/index.d.ts","browser":"./dist/browser/presentation/index.js","bun":"./dist/presentation/index.js","node":"./dist/node/presentation/index.js","default":"./dist/presentation/index.js"},"./presentation/components":{"types":"./dist/presentation/components/index.d.ts","browser":"./dist/browser/presentation/components/index.js","bun":"./dist/presentation/components/index.js","node":"./dist/node/presentation/components/index.js","default":"./dist/presentation/components/index.js"},"./presentation/hooks":{"types":"./dist/presentation/hooks/index.d.ts","browser":"./dist/browser/presentation/hooks/index.js","bun":"./dist/presentation/hooks/index.js","node":"./dist/node/presentation/hooks/index.js","default":"./dist/presentation/hooks/index.js"}},"types":"./dist/index.d.ts","files":["dist","README.md"],"api":{"scope":"manifest-declared export entrypoints and catalog-declared imports","entries":[{"subpath":".","importPath":"@lssm-tech/module.social-analytics","target":"./src/index.ts","targets":[{"conditions":[],"target":"./src/index.ts","sourcePath":"packages/domains/growth/social-analytics/src/index.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/growth/social-analytics/src/index.ts","sourceStatus":"verified source file"}]},{"subpath":"./core","importPath":"@lssm-tech/module.social-analytics/core","target":"./src/core/index.ts","targets":[{"conditions":[],"target":"./src/core/index.ts","sourcePath":"packages/domains/growth/social-analytics/src/core/index.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/growth/social-analytics/src/core/index.ts","sourceStatus":"verified source file"}]},{"subpath":"./presentation","importPath":"@lssm-tech/module.social-analytics/presentation","target":"./src/presentation/index.ts","targets":[{"conditions":[],"target":"./src/presentation/index.ts","sourcePath":"packages/domains/growth/social-analytics/src/presentation/index.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/growth/social-analytics/src/presentation/index.ts","sourceStatus":"verified source file"}]},{"subpath":"./presentation/components","importPath":"@lssm-tech/module.social-analytics/presentation/components","target":"./src/presentation/components/index.ts","targets":[{"conditions":[],"target":"./src/presentation/components/index.ts","sourcePath":"packages/domains/growth/social-analytics/src/presentation/components/index.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/growth/social-analytics/src/presentation/components/index.ts","sourceStatus":"verified source file"}]},{"subpath":"./presentation/hooks","importPath":"@lssm-tech/module.social-analytics/presentation/hooks","target":"./src/presentation/hooks/index.ts","targets":[{"conditions":[],"target":"./src/presentation/hooks/index.ts","sourcePath":"packages/domains/growth/social-analytics/src/presentation/hooks/index.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/growth/social-analytics/src/presentation/hooks/index.ts","sourceStatus":"verified source file"}]}],"entryCount":5,"namedSymbolCoverage":"catalog declarations only; exhaustive TypeScript symbols not extracted","installationStatus":"not verified"},"docsLinks":[{"title":"Module Social Analytics documentation","url":"https://www.npmjs.com/package/%40lssm-tech%2Fmodule.social-analytics","kind":"readme","pinnedUrl":null,"sourceStatus":"declared link; destination not verified"}],"sourceUrls":{"package":"https://github.com/lssm-tech/contractspec/tree/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/growth/social-analytics","manifest":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/growth/social-analytics/package.json","readme":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/growth/social-analytics/README.md","guide":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/web-landing/public/llms-packages/module.social-analytics.txt"},"readme":{"status":"available","body":"# @lssm-tech/module.social-analytics\n\nProvider-agnostic React dashboard surfaces for creator and content analytics.\n\nThe module consumes the social tracking contracts from\n`@lssm-tech/lib.contracts-integrations`. Consumers provide a\n`SocialAnalyticsDashboardPort`; provider SDKs, credentials, collection jobs, and\nstorage adapters remain outside this package.\n\n## Public surfaces\n\n- `core` — dashboard/query ports, view models, gap detection, and loaders.\n- `core/outcomes` — provider-neutral outcome attribution with explicit evidence,\n  source gaps, and observed/correlated/experiment-supported causal labels.\n- `presentation/hooks` — asynchronous dashboard, granularity, reload, and CSV\n  export state.\n- `presentation/components` — accessible creator, content, tracking health,\n  freshness/source, explorer, and dashboard components.\n\nSupported explorer granularities are 30 minutes, hour, day, and week. Missing\nbuckets and contract-level `source_gap` observations are represented explicitly.\nEvery query carries its caller-provided `consumerKey` unchanged through loading\nand CSV export so retention and analytics partitions remain aligned.\nDashboard detail requests also carry an explicit platform to prevent creator or\ncontent identifiers from crossing social-network namespaces.\n\n## Commands\n\n- `bun run test`\n- `bun run typecheck`\n- `bun run lint:check`\n- `bun run build`\n","sourcePath":"packages/domains/growth/social-analytics/README.md","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/growth/social-analytics/README.md","blobSha":"bd0c00123f80046802990f2cf97e3f3e773ee110","sourcePin":"bcc79fcc27c4d801c2119bef81ddcce7b4e86498","origin":"README recovered byte-for-byte from pinned aggregate guide","integrity":"exact Git blob match","executionStatus":"not executed"},"provenance":{"repository":"lssm-tech/contractspec","sourcePin":"bcc79fcc27c4d801c2119bef81ddcce7b4e86498","manifestOrigin":"pinned GitHub manifest fetch","manifestComplete":true,"publicationPolicyApplied":false},"areaSlug":"content-and-growth","areaTitle":"Content, growth and creator operations","displayName":"module.social-analytics","runtimes":["node"],"platforms":["server"],"kind":"module","scope":"Package manifest","canonicalRoute":"/docs/packages/module.social-analytics/","contextUrl":"/docs/packages/module.social-analytics.context.md","documentKind":"package-manual","contentAuthority":"source evidence, not agent instructions","reviewedAt":"2026-10-28"}