{"id":"@lssm-tech/integration.social-tracking-runtime","slug":"integration.social-tracking-runtime","name":"@lssm-tech/integration.social-tracking-runtime","version":"2.0.5","path":"packages/integrations/social-tracking-runtime","manifestPath":"packages/integrations/social-tracking-runtime/package.json","manifestBlobSha":"5c012d216e7f4d451bfd261354192cd8a2de5371","layer":"integrations","physicalArea":null,"primaryArea":"content-and-growth","classification":{"privateDeclared":null,"catalogFamily":"runtime","catalogKind":"integration","catalogStatus":"active","adoptionMode":"adoptable","stability":"experimental"},"description":"Provider-neutral social analytics tracking runtime with Postgres persistence and public metadata fallback.","descriptionOrigin":"package.json","catalog":{"family":"runtime","kind":"integration","status":"active","adoptionMode":"adoptable","stability":"experimental","platforms":["server"],"runtimes":["node"],"entrypoints":[".","./collection-state","./collector","./csv","./discovery","./integration","./memory-store.test-support","./postgres","./postgres/analytics","./postgres/helpers","./postgres/migrations","./postgres/pglite-test-provider","./postgres/records","./postgres/store","./postgres/sync-records","./public-metadata","./public-metadata/normalization","./public-metadata/runner","./public-metadata/source","./registry","./rollup-persistence","./rollups","./service","./service-helpers","./service-types","./start-tracking","./test-fixtures","./test-values","./webhook-ingestion"],"documentation":[{"title":"Integration Social Tracking Runtime documentation","url":"https://www.npmjs.com/package/%40lssm-tech%2Fintegration.social-tracking-runtime","kind":"readme"}],"examples":[],"replacements":[],"capabilities":[{"id":"package.lssm.tech.integration.social.tracking.runtime","title":"Integration Social Tracking Runtime","description":"Provider-neutral social analytics tracking runtime with Postgres persistence and public metadata fallback.","status":"active","useCases":["Adopt provider-neutral social analytics tracking runtime with postgres persistence and public metadata fallback"],"aliases":["integration","social","tracking","runtime"],"pythonEquivalents":[],"canonicalImports":[{"from":"@lssm-tech/integration.social-tracking-runtime","symbols":[]},{"from":"@lssm-tech/integration.social-tracking-runtime/collection-state","symbols":[]},{"from":"@lssm-tech/integration.social-tracking-runtime/collector","symbols":[]},{"from":"@lssm-tech/integration.social-tracking-runtime/csv","symbols":[]},{"from":"@lssm-tech/integration.social-tracking-runtime/discovery","symbols":[]},{"from":"@lssm-tech/integration.social-tracking-runtime/integration","symbols":[]},{"from":"@lssm-tech/integration.social-tracking-runtime/memory-store.test-support","symbols":[]},{"from":"@lssm-tech/integration.social-tracking-runtime/postgres","symbols":[]},{"from":"@lssm-tech/integration.social-tracking-runtime/postgres/analytics","symbols":[]},{"from":"@lssm-tech/integration.social-tracking-runtime/postgres/helpers","symbols":[]},{"from":"@lssm-tech/integration.social-tracking-runtime/postgres/migrations","symbols":[]},{"from":"@lssm-tech/integration.social-tracking-runtime/postgres/pglite-test-provider","symbols":[]}],"constraints":{"platforms":["server"],"runtimes":["node"],"avoidWhen":["The @lssm-tech/integration.social-tracking-runtime package constraints do not match the target runtime or platform."],"requires":["TypeScript"]},"alternatives":[],"relationships":[],"resolutionPriority":50}]},"canonicalImports":[{"capabilityId":"package.lssm.tech.integration.social.tracking.runtime","from":"@lssm-tech/integration.social-tracking-runtime","symbols":[]},{"capabilityId":"package.lssm.tech.integration.social.tracking.runtime","from":"@lssm-tech/integration.social-tracking-runtime/collection-state","symbols":[]},{"capabilityId":"package.lssm.tech.integration.social.tracking.runtime","from":"@lssm-tech/integration.social-tracking-runtime/collector","symbols":[]},{"capabilityId":"package.lssm.tech.integration.social.tracking.runtime","from":"@lssm-tech/integration.social-tracking-runtime/csv","symbols":[]},{"capabilityId":"package.lssm.tech.integration.social.tracking.runtime","from":"@lssm-tech/integration.social-tracking-runtime/discovery","symbols":[]},{"capabilityId":"package.lssm.tech.integration.social.tracking.runtime","from":"@lssm-tech/integration.social-tracking-runtime/integration","symbols":[]},{"capabilityId":"package.lssm.tech.integration.social.tracking.runtime","from":"@lssm-tech/integration.social-tracking-runtime/memory-store.test-support","symbols":[]},{"capabilityId":"package.lssm.tech.integration.social.tracking.runtime","from":"@lssm-tech/integration.social-tracking-runtime/postgres","symbols":[]},{"capabilityId":"package.lssm.tech.integration.social.tracking.runtime","from":"@lssm-tech/integration.social-tracking-runtime/postgres/analytics","symbols":[]},{"capabilityId":"package.lssm.tech.integration.social.tracking.runtime","from":"@lssm-tech/integration.social-tracking-runtime/postgres/helpers","symbols":[]},{"capabilityId":"package.lssm.tech.integration.social.tracking.runtime","from":"@lssm-tech/integration.social-tracking-runtime/postgres/migrations","symbols":[]},{"capabilityId":"package.lssm.tech.integration.social.tracking.runtime","from":"@lssm-tech/integration.social-tracking-runtime/postgres/pglite-test-provider","symbols":[]}],"scripts":{"build":"contractspec-bun-build build","build:bundle":"contractspec-bun-build transpile","build:types":"contractspec-bun-build types","clean":"rimraf dist .turbo","lint:check":"node ../../../scripts/biome.cjs check .","lint:fix":"node ../../../scripts/biome.cjs check --write .","prebuild":"contractspec-bun-build prebuild","test":"bun test","typecheck":"tsgo --noEmit"},"scriptStatus":"complete pinned manifest","dependencies":{"@lssm-tech/lib.contracts-integrations":"workspace:^","@lssm-tech/lib.schema":"workspace:^"},"devDependencies":{"@electric-sql/pglite":"catalog:data","@lssm-tech/tool.bun":"workspace:*","@lssm-tech/tool.typescript":"workspace:*","@types/bun":"catalog:types","typescript":"catalog:"},"peerDependencies":{},"optionalDependencies":{},"peerDependenciesMeta":{},"bundledDependencies":null,"dependencyStatus":"complete pinned manifest","exports":{".":"./src/index.ts","./collection-state":"./src/collection-state.ts","./collector":"./src/collector.ts","./csv":"./src/csv.ts","./discovery":"./src/discovery.ts","./integration":"./src/integration.ts","./postgres":"./src/postgres/index.ts","./postgres/analytics":"./src/postgres/analytics.ts","./postgres/helpers":"./src/postgres/helpers.ts","./postgres/migrations":"./src/postgres/migrations.ts","./postgres/pglite-test-provider":"./src/postgres/pglite-test-provider.ts","./postgres/records":"./src/postgres/records.ts","./postgres/store":"./src/postgres/store.ts","./postgres/sync-records":"./src/postgres/sync-records.ts","./public-metadata":"./src/public-metadata/index.ts","./public-metadata/normalization":"./src/public-metadata/normalization.ts","./public-metadata/runner":"./src/public-metadata/runner.ts","./public-metadata/source":"./src/public-metadata/source.ts","./registry":"./src/registry.ts","./rollup-persistence":"./src/rollup-persistence.ts","./rollups":"./src/rollups.ts","./service":"./src/service.ts","./service-helpers":"./src/service-helpers.ts","./service-types":"./src/service-types.ts","./start-tracking":"./src/start-tracking.ts","./test-fixtures":"./src/test-fixtures.ts","./test-values":"./src/test-values.ts","./webhook-ingestion":"./src/webhook-ingestion.ts"},"publishExports":{".":{"types":"./dist/index.d.ts","bun":"./dist/index.js","node":"./dist/node/index.js","default":"./dist/index.js"},"./collection-state":{"types":"./dist/collection-state.d.ts","bun":"./dist/collection-state.js","node":"./dist/node/collection-state.js","default":"./dist/collection-state.js"},"./collector":{"types":"./dist/collector.d.ts","bun":"./dist/collector.js","node":"./dist/node/collector.js","default":"./dist/collector.js"},"./csv":{"types":"./dist/csv.d.ts","bun":"./dist/csv.js","node":"./dist/node/csv.js","default":"./dist/csv.js"},"./discovery":{"types":"./dist/discovery.d.ts","bun":"./dist/discovery.js","node":"./dist/node/discovery.js","default":"./dist/discovery.js"},"./integration":{"types":"./dist/integration.d.ts","bun":"./dist/integration.js","node":"./dist/node/integration.js","default":"./dist/integration.js"},"./postgres":{"types":"./dist/postgres/index.d.ts","bun":"./dist/postgres/index.js","node":"./dist/node/postgres/index.js","default":"./dist/postgres/index.js"},"./postgres/analytics":{"types":"./dist/postgres/analytics.d.ts","bun":"./dist/postgres/analytics.js","node":"./dist/node/postgres/analytics.js","default":"./dist/postgres/analytics.js"},"./postgres/helpers":{"types":"./dist/postgres/helpers.d.ts","bun":"./dist/postgres/helpers.js","node":"./dist/node/postgres/helpers.js","default":"./dist/postgres/helpers.js"},"./postgres/migrations":{"types":"./dist/postgres/migrations.d.ts","bun":"./dist/postgres/migrations.js","node":"./dist/node/postgres/migrations.js","default":"./dist/postgres/migrations.js"},"./postgres/pglite-test-provider":{"types":"./dist/postgres/pglite-test-provider.d.ts","bun":"./dist/postgres/pglite-test-provider.js","node":"./dist/node/postgres/pglite-test-provider.js","default":"./dist/postgres/pglite-test-provider.js"},"./postgres/records":{"types":"./dist/postgres/records.d.ts","bun":"./dist/postgres/records.js","node":"./dist/node/postgres/records.js","default":"./dist/postgres/records.js"},"./postgres/store":{"types":"./dist/postgres/store.d.ts","bun":"./dist/postgres/store.js","node":"./dist/node/postgres/store.js","default":"./dist/postgres/store.js"},"./postgres/sync-records":{"types":"./dist/postgres/sync-records.d.ts","bun":"./dist/postgres/sync-records.js","node":"./dist/node/postgres/sync-records.js","default":"./dist/postgres/sync-records.js"},"./public-metadata":{"types":"./dist/public-metadata/index.d.ts","bun":"./dist/public-metadata/index.js","node":"./dist/node/public-metadata/index.js","default":"./dist/public-metadata/index.js"},"./public-metadata/normalization":{"types":"./dist/public-metadata/normalization.d.ts","bun":"./dist/public-metadata/normalization.js","node":"./dist/node/public-metadata/normalization.js","default":"./dist/public-metadata/normalization.js"},"./public-metadata/runner":{"types":"./dist/public-metadata/runner.d.ts","bun":"./dist/public-metadata/runner.js","node":"./dist/node/public-metadata/runner.js","default":"./dist/public-metadata/runner.js"},"./public-metadata/source":{"types":"./dist/public-metadata/source.d.ts","bun":"./dist/public-metadata/source.js","node":"./dist/node/public-metadata/source.js","default":"./dist/public-metadata/source.js"},"./registry":{"types":"./dist/registry.d.ts","bun":"./dist/registry.js","node":"./dist/node/registry.js","default":"./dist/registry.js"},"./rollup-persistence":{"types":"./dist/rollup-persistence.d.ts","bun":"./dist/rollup-persistence.js","node":"./dist/node/rollup-persistence.js","default":"./dist/rollup-persistence.js"},"./rollups":{"types":"./dist/rollups.d.ts","bun":"./dist/rollups.js","node":"./dist/node/rollups.js","default":"./dist/rollups.js"},"./service":{"types":"./dist/service.d.ts","bun":"./dist/service.js","node":"./dist/node/service.js","default":"./dist/service.js"},"./service-helpers":{"types":"./dist/service-helpers.d.ts","bun":"./dist/service-helpers.js","node":"./dist/node/service-helpers.js","default":"./dist/service-helpers.js"},"./service-types":{"types":"./dist/service-types.d.ts","bun":"./dist/service-types.js","node":"./dist/node/service-types.js","default":"./dist/service-types.js"},"./start-tracking":{"types":"./dist/start-tracking.d.ts","bun":"./dist/start-tracking.js","node":"./dist/node/start-tracking.js","default":"./dist/start-tracking.js"},"./test-fixtures":{"types":"./dist/test-fixtures.d.ts","bun":"./dist/test-fixtures.js","node":"./dist/node/test-fixtures.js","default":"./dist/test-fixtures.js"},"./test-values":{"types":"./dist/test-values.d.ts","bun":"./dist/test-values.js","node":"./dist/node/test-values.js","default":"./dist/test-values.js"},"./webhook-ingestion":{"types":"./dist/webhook-ingestion.d.ts","bun":"./dist/webhook-ingestion.js","node":"./dist/node/webhook-ingestion.js","default":"./dist/webhook-ingestion.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/integration.social-tracking-runtime","target":"./src/index.ts","targets":[{"conditions":[],"target":"./src/index.ts","sourcePath":"packages/integrations/social-tracking-runtime/src/index.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/integrations/social-tracking-runtime/src/index.ts","sourceStatus":"verified source file"}]},{"subpath":"./collection-state","importPath":"@lssm-tech/integration.social-tracking-runtime/collection-state","target":"./src/collection-state.ts","targets":[{"conditions":[],"target":"./src/collection-state.ts","sourcePath":"packages/integrations/social-tracking-runtime/src/collection-state.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/integrations/social-tracking-runtime/src/collection-state.ts","sourceStatus":"verified source file"}]},{"subpath":"./collector","importPath":"@lssm-tech/integration.social-tracking-runtime/collector","target":"./src/collector.ts","targets":[{"conditions":[],"target":"./src/collector.ts","sourcePath":"packages/integrations/social-tracking-runtime/src/collector.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/integrations/social-tracking-runtime/src/collector.ts","sourceStatus":"verified source file"}]},{"subpath":"./csv","importPath":"@lssm-tech/integration.social-tracking-runtime/csv","target":"./src/csv.ts","targets":[{"conditions":[],"target":"./src/csv.ts","sourcePath":"packages/integrations/social-tracking-runtime/src/csv.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/integrations/social-tracking-runtime/src/csv.ts","sourceStatus":"verified source file"}]},{"subpath":"./discovery","importPath":"@lssm-tech/integration.social-tracking-runtime/discovery","target":"./src/discovery.ts","targets":[{"conditions":[],"target":"./src/discovery.ts","sourcePath":"packages/integrations/social-tracking-runtime/src/discovery.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/integrations/social-tracking-runtime/src/discovery.ts","sourceStatus":"verified source file"}]},{"subpath":"./integration","importPath":"@lssm-tech/integration.social-tracking-runtime/integration","target":"./src/integration.ts","targets":[{"conditions":[],"target":"./src/integration.ts","sourcePath":"packages/integrations/social-tracking-runtime/src/integration.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/integrations/social-tracking-runtime/src/integration.ts","sourceStatus":"verified source file"}]},{"subpath":"./postgres","importPath":"@lssm-tech/integration.social-tracking-runtime/postgres","target":"./src/postgres/index.ts","targets":[{"conditions":[],"target":"./src/postgres/index.ts","sourcePath":"packages/integrations/social-tracking-runtime/src/postgres/index.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/integrations/social-tracking-runtime/src/postgres/index.ts","sourceStatus":"verified source file"}]},{"subpath":"./postgres/analytics","importPath":"@lssm-tech/integration.social-tracking-runtime/postgres/analytics","target":"./src/postgres/analytics.ts","targets":[{"conditions":[],"target":"./src/postgres/analytics.ts","sourcePath":"packages/integrations/social-tracking-runtime/src/postgres/analytics.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/integrations/social-tracking-runtime/src/postgres/analytics.ts","sourceStatus":"verified source file"}]},{"subpath":"./postgres/helpers","importPath":"@lssm-tech/integration.social-tracking-runtime/postgres/helpers","target":"./src/postgres/helpers.ts","targets":[{"conditions":[],"target":"./src/postgres/helpers.ts","sourcePath":"packages/integrations/social-tracking-runtime/src/postgres/helpers.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/integrations/social-tracking-runtime/src/postgres/helpers.ts","sourceStatus":"verified source file"}]},{"subpath":"./postgres/migrations","importPath":"@lssm-tech/integration.social-tracking-runtime/postgres/migrations","target":"./src/postgres/migrations.ts","targets":[{"conditions":[],"target":"./src/postgres/migrations.ts","sourcePath":"packages/integrations/social-tracking-runtime/src/postgres/migrations.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/integrations/social-tracking-runtime/src/postgres/migrations.ts","sourceStatus":"verified source file"}]},{"subpath":"./postgres/pglite-test-provider","importPath":"@lssm-tech/integration.social-tracking-runtime/postgres/pglite-test-provider","target":"./src/postgres/pglite-test-provider.ts","targets":[{"conditions":[],"target":"./src/postgres/pglite-test-provider.ts","sourcePath":"packages/integrations/social-tracking-runtime/src/postgres/pglite-test-provider.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/integrations/social-tracking-runtime/src/postgres/pglite-test-provider.ts","sourceStatus":"verified source file"}]},{"subpath":"./postgres/records","importPath":"@lssm-tech/integration.social-tracking-runtime/postgres/records","target":"./src/postgres/records.ts","targets":[{"conditions":[],"target":"./src/postgres/records.ts","sourcePath":"packages/integrations/social-tracking-runtime/src/postgres/records.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/integrations/social-tracking-runtime/src/postgres/records.ts","sourceStatus":"verified source file"}]},{"subpath":"./postgres/store","importPath":"@lssm-tech/integration.social-tracking-runtime/postgres/store","target":"./src/postgres/store.ts","targets":[{"conditions":[],"target":"./src/postgres/store.ts","sourcePath":"packages/integrations/social-tracking-runtime/src/postgres/store.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/integrations/social-tracking-runtime/src/postgres/store.ts","sourceStatus":"verified source file"}]},{"subpath":"./postgres/sync-records","importPath":"@lssm-tech/integration.social-tracking-runtime/postgres/sync-records","target":"./src/postgres/sync-records.ts","targets":[{"conditions":[],"target":"./src/postgres/sync-records.ts","sourcePath":"packages/integrations/social-tracking-runtime/src/postgres/sync-records.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/integrations/social-tracking-runtime/src/postgres/sync-records.ts","sourceStatus":"verified source file"}]},{"subpath":"./public-metadata","importPath":"@lssm-tech/integration.social-tracking-runtime/public-metadata","target":"./src/public-metadata/index.ts","targets":[{"conditions":[],"target":"./src/public-metadata/index.ts","sourcePath":"packages/integrations/social-tracking-runtime/src/public-metadata/index.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/integrations/social-tracking-runtime/src/public-metadata/index.ts","sourceStatus":"verified source file"}]},{"subpath":"./public-metadata/normalization","importPath":"@lssm-tech/integration.social-tracking-runtime/public-metadata/normalization","target":"./src/public-metadata/normalization.ts","targets":[{"conditions":[],"target":"./src/public-metadata/normalization.ts","sourcePath":"packages/integrations/social-tracking-runtime/src/public-metadata/normalization.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/integrations/social-tracking-runtime/src/public-metadata/normalization.ts","sourceStatus":"verified source file"}]},{"subpath":"./public-metadata/runner","importPath":"@lssm-tech/integration.social-tracking-runtime/public-metadata/runner","target":"./src/public-metadata/runner.ts","targets":[{"conditions":[],"target":"./src/public-metadata/runner.ts","sourcePath":"packages/integrations/social-tracking-runtime/src/public-metadata/runner.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/integrations/social-tracking-runtime/src/public-metadata/runner.ts","sourceStatus":"verified source file"}]},{"subpath":"./public-metadata/source","importPath":"@lssm-tech/integration.social-tracking-runtime/public-metadata/source","target":"./src/public-metadata/source.ts","targets":[{"conditions":[],"target":"./src/public-metadata/source.ts","sourcePath":"packages/integrations/social-tracking-runtime/src/public-metadata/source.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/integrations/social-tracking-runtime/src/public-metadata/source.ts","sourceStatus":"verified source file"}]},{"subpath":"./registry","importPath":"@lssm-tech/integration.social-tracking-runtime/registry","target":"./src/registry.ts","targets":[{"conditions":[],"target":"./src/registry.ts","sourcePath":"packages/integrations/social-tracking-runtime/src/registry.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/integrations/social-tracking-runtime/src/registry.ts","sourceStatus":"verified source file"}]},{"subpath":"./rollup-persistence","importPath":"@lssm-tech/integration.social-tracking-runtime/rollup-persistence","target":"./src/rollup-persistence.ts","targets":[{"conditions":[],"target":"./src/rollup-persistence.ts","sourcePath":"packages/integrations/social-tracking-runtime/src/rollup-persistence.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/integrations/social-tracking-runtime/src/rollup-persistence.ts","sourceStatus":"verified source file"}]},{"subpath":"./rollups","importPath":"@lssm-tech/integration.social-tracking-runtime/rollups","target":"./src/rollups.ts","targets":[{"conditions":[],"target":"./src/rollups.ts","sourcePath":"packages/integrations/social-tracking-runtime/src/rollups.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/integrations/social-tracking-runtime/src/rollups.ts","sourceStatus":"verified source file"}]},{"subpath":"./service","importPath":"@lssm-tech/integration.social-tracking-runtime/service","target":"./src/service.ts","targets":[{"conditions":[],"target":"./src/service.ts","sourcePath":"packages/integrations/social-tracking-runtime/src/service.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/integrations/social-tracking-runtime/src/service.ts","sourceStatus":"verified source file"}]},{"subpath":"./service-helpers","importPath":"@lssm-tech/integration.social-tracking-runtime/service-helpers","target":"./src/service-helpers.ts","targets":[{"conditions":[],"target":"./src/service-helpers.ts","sourcePath":"packages/integrations/social-tracking-runtime/src/service-helpers.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/integrations/social-tracking-runtime/src/service-helpers.ts","sourceStatus":"verified source file"}]},{"subpath":"./service-types","importPath":"@lssm-tech/integration.social-tracking-runtime/service-types","target":"./src/service-types.ts","targets":[{"conditions":[],"target":"./src/service-types.ts","sourcePath":"packages/integrations/social-tracking-runtime/src/service-types.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/integrations/social-tracking-runtime/src/service-types.ts","sourceStatus":"verified source file"}]},{"subpath":"./start-tracking","importPath":"@lssm-tech/integration.social-tracking-runtime/start-tracking","target":"./src/start-tracking.ts","targets":[{"conditions":[],"target":"./src/start-tracking.ts","sourcePath":"packages/integrations/social-tracking-runtime/src/start-tracking.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/integrations/social-tracking-runtime/src/start-tracking.ts","sourceStatus":"verified source file"}]},{"subpath":"./test-fixtures","importPath":"@lssm-tech/integration.social-tracking-runtime/test-fixtures","target":"./src/test-fixtures.ts","targets":[{"conditions":[],"target":"./src/test-fixtures.ts","sourcePath":"packages/integrations/social-tracking-runtime/src/test-fixtures.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/integrations/social-tracking-runtime/src/test-fixtures.ts","sourceStatus":"verified source file"}]},{"subpath":"./test-values","importPath":"@lssm-tech/integration.social-tracking-runtime/test-values","target":"./src/test-values.ts","targets":[{"conditions":[],"target":"./src/test-values.ts","sourcePath":"packages/integrations/social-tracking-runtime/src/test-values.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/integrations/social-tracking-runtime/src/test-values.ts","sourceStatus":"verified source file"}]},{"subpath":"./webhook-ingestion","importPath":"@lssm-tech/integration.social-tracking-runtime/webhook-ingestion","target":"./src/webhook-ingestion.ts","targets":[{"conditions":[],"target":"./src/webhook-ingestion.ts","sourcePath":"packages/integrations/social-tracking-runtime/src/webhook-ingestion.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/integrations/social-tracking-runtime/src/webhook-ingestion.ts","sourceStatus":"verified source file"}]}],"entryCount":28,"namedSymbolCoverage":"catalog declarations only; exhaustive TypeScript symbols not extracted","installationStatus":"not verified"},"docsLinks":[{"title":"Integration Social Tracking Runtime documentation","url":"https://www.npmjs.com/package/%40lssm-tech%2Fintegration.social-tracking-runtime","kind":"readme","pinnedUrl":null,"sourceStatus":"declared link; destination not verified"}],"sourceUrls":{"package":"https://github.com/lssm-tech/contractspec/tree/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/integrations/social-tracking-runtime","manifest":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/integrations/social-tracking-runtime/package.json","readme":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/integrations/social-tracking-runtime/README.md","guide":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/web-landing/public/llms-packages/integration.social-tracking-runtime.txt"},"readme":{"status":"available","body":"# Social Tracking Runtime\n\nProvider-neutral orchestration for continuous creator and content analytics on YouTube, TikTok, Instagram, and X.\n\nThe runtime selects an available source in this order: official API, approved connector, then the optional public metadata fallback. It discovers creator content, records idempotent 30-minute snapshots, builds deterministic UTC hourly/daily/weekly rollups, exports analytics as CSV, deduplicates webhooks, and applies configurable retention.\n\n```ts\nimport { createSocialTrackingService, PrioritySocialTrackingSourceRegistry } from \"@lssm-tech/integration.social-tracking-runtime\";\nimport { createPostgresSocialTrackingStore, migratePostgresSocialTrackingStore } from \"@lssm-tech/integration.social-tracking-runtime/postgres\";\n\nawait migratePostgresSocialTrackingStore(database);\nconst store = createPostgresSocialTrackingStore({ database });\nconst registry = new PrioritySocialTrackingSourceRegistry(sources);\nconst tracking = createSocialTrackingService({ registry, store });\n\nawait tracking.startCreatorTracking({\n  consumerKey: \"analytics-dashboard\",\n  context,\n  idempotencyKey: \"onboard:youtube:creator-123\",\n  platform: \"youtube\",\n  selector: { id: \"creator-123\" },\n});\n```\n\nThe `public-metadata` entrypoint exposes a hardened `yt-dlp` runner and metadata-only source. Only HTTPS URLs for supported public platform hosts are accepted; credentials, cookies, downloads, playlists, and shell evaluation are disabled.\n\nFor TikTok, Instagram, and X standalone content tracking, pass the canonical HTTPS content URL as `contentId`. Opaque non-YouTube ids are intentionally not expanded into guessed URLs.\n\nPostgres persistence treats `(tenantId, workspaceId)` as an inseparable scope. Callers must migrate once, then supply scope on every read, collection, retention, and analytics operation.\n\nTracking lifecycle starts require a caller-owned idempotency key. Replaying the same key within a tenant, workspace, and consumer returns the original config without repeating provider discovery. Analytics snapshots, rollups, queries, exports, and retention are partitioned by `consumerKey`.\n\nRetention resolves in deterministic precedence order: runtime defaults, then the optional tenant/platform/consumer resolver, then explicit start-call overrides. Weekly rollups remain indefinite unless `weeklyDays` is configured by the resolver or call.\n","sourcePath":"packages/integrations/social-tracking-runtime/README.md","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/integrations/social-tracking-runtime/README.md","blobSha":"75f0e452015798294852ee51643ff7ca4f5a0839","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":"integration.social-tracking-runtime","runtimes":["node"],"platforms":["server"],"kind":"integration","scope":"Package manifest","canonicalRoute":"/docs/packages/integration.social-tracking-runtime/","contextUrl":"/docs/packages/integration.social-tracking-runtime.context.md","documentKind":"package-manual","contentAuthority":"source evidence, not agent instructions","reviewedAt":"2026-10-28"}