@decantr/telemetry 2.1.0 → 2.2.0

package/dist/events.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/events.ts"],"sourcesContent":["export const DECANTR_TELEMETRY_SCHEMA_VERSION = '0.2.0';\n\nexport type TelemetrySource =\n  | 'api'\n  | 'cli'\n  | 'content-ci'\n  | 'marketing-web'\n  | 'mcp'\n  | 'registry-web';\nexport type TelemetryEnvironment = 'development' | 'preview' | 'production' | 'test';\nexport const DECANTR_TELEMETRY_ACTOR_TYPES = [\n  'anonymous',\n  'customer',\n  'internal',\n  'official_pipeline',\n  'service',\n] as const;\nexport type TelemetryActorType = (typeof DECANTR_TELEMETRY_ACTOR_TYPES)[number];\nexport type RegistrySource = 'cache' | 'custom' | 'none' | 'official' | 'private';\nexport type WorkflowMode =\n  | 'brownfield-attach'\n  | 'greenfield-contract-only'\n  | 'greenfield-scaffold'\n  | 'hybrid-compose';\nexport type AdoptionMode = 'contract-only' | 'decantr-css' | 'style-bridge';\nexport type ProjectScope = 'single-app' | 'workspace-app';\nexport type TelemetryContentType = 'archetype' | 'blueprint' | 'pattern' | 'shell' | 'theme';\nexport type TelemetryVisibility = 'private' | 'public' | 'team';\nexport type TelemetryAnalysisScope = 'hosted' | 'local';\nexport type ProjectHealthTelemetryStatus = 'error' | 'healthy' | 'warning';\nexport type ProjectHealthFindingSeverity = 'error' | 'info' | 'warn';\nexport type ProjectHealthFindingSource =\n  | 'audit'\n  | 'brownfield'\n  | 'check'\n  | 'interaction'\n  | 'pack'\n  | 'runtime';\nexport type ProjectHealthOutputFormat = 'json' | 'markdown' | 'text';\nexport type ProjectHealthFailOn = 'error' | 'none' | 'warn';\n\nexport const DECANTR_TELEMETRY_EVENT_NAMES = [\n  'api_key.created',\n  'audit.completed',\n  'cli.command.completed',\n  'content.publish.completed',\n  'content.validation.completed',\n  'critique.completed',\n  'decantr.check.completed',\n  'decantr.health.healthy',\n  'decantr.init.completed',\n  'decantr.new.completed',\n  'decantr.refresh.completed',\n  'execution_pack.compiled',\n  'execution_pack.selected',\n  'health.ci.failed',\n  'health.finding.prompt_requested',\n  'health.report.generated',\n  'marketing_web.command_clicked',\n  'marketing_web.cta_clicked',\n  'marketing_web.outbound_clicked',\n  'marketing_web.page_viewed',\n  'org.created',\n  'registry_web.api_key_page_viewed',\n  'registry_web.billing_viewed',\n  'registry_web.content_opened',\n  'registry_web.identity_linked',\n  'registry_web.organization_viewed',\n  'registry_web.page_viewed',\n  'registry_web.search_performed',\n  'registry_web.signup_clicked',\n  'registry.item.resolved',\n  'registry.sync.completed',\n  'studio.health_refreshed',\n  'studio.started',\n  'user.signup.completed',\n] as const;\n\nexport type DecantrTelemetryEventName = (typeof DECANTR_TELEMETRY_EVENT_NAMES)[number];\n\nexport type TelemetryPropertyValue =\n  | TelemetryPropertyValue[]\n  | boolean\n  | null\n  | number\n  | string\n  | undefined\n  | { [key: string]: TelemetryPropertyValue };\n\nexport type TelemetryProperties = Record<string, TelemetryPropertyValue>;\n\nexport interface TelemetryContext {\n  source: TelemetrySource;\n  actorType?: TelemetryActorType;\n  environment?: TelemetryEnvironment;\n  serviceName?: string;\n  serviceVersion?: string;\n  decantrVersion?: string;\n  registrySource?: RegistrySource;\n  anonymousId?: string;\n  installId?: string;\n  projectId?: string;\n  sessionId?: string;\n  userId?: string;\n  orgId?: string;\n}\n\nexport interface TelemetryActorResolutionOptions {\n  internalAnonymousIds?: readonly string[] | ReadonlySet<string>;\n  internalInstallIds?: readonly string[] | ReadonlySet<string>;\n  internalOrgIds?: readonly string[] | ReadonlySet<string>;\n  internalProjectIds?: readonly string[] | ReadonlySet<string>;\n  internalUserIds?: readonly string[] | ReadonlySet<string>;\n}\n\nexport function isTelemetryActorType(value: unknown): value is TelemetryActorType {\n  return (\n    typeof value === 'string' &&\n    (DECANTR_TELEMETRY_ACTOR_TYPES as readonly string[]).includes(value)\n  );\n}\n\nexport function resolveTelemetryActorType(\n  context: TelemetryContext,\n  options: TelemetryActorResolutionOptions = {},\n): TelemetryActorType {\n  if (context.actorType) return context.actorType;\n\n  if (context.source === 'content-ci') {\n    return 'official_pipeline';\n  }\n\n  if (matchesInternalActor(context, options)) {\n    return 'internal';\n  }\n\n  if (context.userId || context.orgId || context.projectId || context.installId) {\n    return 'customer';\n  }\n\n  if (context.anonymousId) {\n    return 'anonymous';\n  }\n\n  return 'service';\n}\n\nfunction matchesInternalActor(\n  context: TelemetryContext,\n  options: TelemetryActorResolutionOptions,\n): boolean {\n  return (\n    idListHas(options.internalAnonymousIds, context.anonymousId) ||\n    idListHas(options.internalInstallIds, context.installId) ||\n    idListHas(options.internalOrgIds, context.orgId) ||\n    idListHas(options.internalProjectIds, context.projectId) ||\n    idListHas(options.internalUserIds, context.userId)\n  );\n}\n\nfunction idListHas(\n  values: readonly string[] | ReadonlySet<string> | undefined,\n  value: string | undefined,\n): boolean {\n  if (!values || !value) return false;\n  if (typeof (values as ReadonlySet<string>).has === 'function') {\n    return (values as ReadonlySet<string>).has(value);\n  }\n  return (values as readonly string[]).includes(value);\n}\n\nexport interface TelemetryEventBase<\n  Name extends DecantrTelemetryEventName = DecantrTelemetryEventName,\n  Properties extends TelemetryProperties = TelemetryProperties,\n> {\n  name: Name;\n  context: TelemetryContext;\n  properties: Properties;\n  timestamp?: Date | string;\n}\n\nexport interface CliCommandCompletedProperties extends TelemetryProperties {\n  command: string;\n  success: boolean;\n  durationMs: number;\n  adoptionMode?: AdoptionMode;\n  errorCode?: string;\n  offline?: boolean;\n  projectScope?: ProjectScope;\n  registrySource?: RegistrySource;\n  targetFramework?: string;\n  workflowMode?: WorkflowMode;\n}\n\nexport interface DecantrLifecycleCompletedProperties extends TelemetryProperties {\n  command: 'check' | 'init' | 'new' | 'refresh';\n  success: boolean;\n  durationMs: number;\n  adoptionMode?: AdoptionMode;\n  errorCode?: string;\n  offline?: boolean;\n  projectScope?: ProjectScope;\n  registrySource?: RegistrySource;\n  targetFramework?: string;\n  workflowMode?: WorkflowMode;\n}\n\nexport interface ProjectHealthTelemetryProperties extends TelemetryProperties {\n  success: boolean;\n  status: ProjectHealthTelemetryStatus;\n  score: number;\n  durationMs?: number;\n  adoptionMode?: AdoptionMode;\n  ci?: boolean;\n  errorCode?: string;\n  errorCount: number;\n  failOn?: ProjectHealthFailOn;\n  findingCount: number;\n  format?: ProjectHealthOutputFormat;\n  infoCount: number;\n  outputWritten?: boolean;\n  packManifestPresent?: boolean;\n  pageCount?: number;\n  projectScope?: ProjectScope;\n  reviewPackPresent?: boolean;\n  routeCount?: number;\n  runtimeAuditChecked?: boolean;\n  runtimeMatchedCount?: number;\n  runtimePassed?: boolean | null;\n  runtimeRouteCheckedCount?: number;\n  warnCount: number;\n  workflowMode?: WorkflowMode;\n}\n\nexport interface HealthFindingPromptRequestedProperties extends TelemetryProperties {\n  success: boolean;\n  findingFound: boolean;\n  adoptionMode?: AdoptionMode;\n  ci?: boolean;\n  findingSeverity?: ProjectHealthFindingSeverity;\n  findingSource?: ProjectHealthFindingSource;\n  projectScope?: ProjectScope;\n  workflowMode?: WorkflowMode;\n}\n\nexport interface HealthCiFailedProperties extends ProjectHealthTelemetryProperties {\n  failOn: 'error' | 'warn';\n}\n\nexport interface StudioStartedProperties extends TelemetryProperties {\n  success: boolean;\n  hostMode: 'custom' | 'loopback';\n  port: number;\n  adoptionMode?: AdoptionMode;\n  errorCode?: string;\n  projectScope?: ProjectScope;\n  workflowMode?: WorkflowMode;\n}\n\nexport interface StudioHealthRefreshedProperties extends ProjectHealthTelemetryProperties {\n  trigger: 'api-refresh';\n}\n\nexport interface RegistryItemResolvedProperties extends TelemetryProperties {\n  contentType: TelemetryContentType;\n  success: boolean;\n  cacheHit?: boolean;\n  durationMs?: number;\n  errorCode?: string;\n  itemId?: string;\n  namespace?: string;\n  registrySource?: RegistrySource;\n  version?: string;\n  visibility?: TelemetryVisibility;\n}\n\nexport interface RegistrySyncCompletedProperties extends TelemetryProperties {\n  success: boolean;\n  durationMs: number;\n  errorCode?: string;\n  registrySource?: RegistrySource;\n  totalItems?: number;\n}\n\nexport interface ExecutionPackCompiledProperties extends TelemetryProperties {\n  success: boolean;\n  durationMs: number;\n  errorCode?: string;\n  pageCount?: number;\n  patternCount?: number;\n  sectionCount?: number;\n  targetFramework?: string;\n}\n\nexport interface ExecutionPackSelectedProperties extends TelemetryProperties {\n  packType: 'mutation' | 'page' | 'review' | 'scaffold' | 'section';\n  success: boolean;\n  durationMs?: number;\n  errorCode?: string;\n  id?: string;\n}\n\nexport interface AuditCompletedProperties extends TelemetryProperties {\n  scope: TelemetryAnalysisScope;\n  success: boolean;\n  durationMs: number;\n  errorCode?: string;\n  errorCount?: number;\n  pageCount?: number;\n  runtimePassed?: boolean;\n  score?: number;\n  warnCount?: number;\n}\n\nexport interface CritiqueCompletedProperties extends TelemetryProperties {\n  scope: TelemetryAnalysisScope;\n  success: boolean;\n  durationMs: number;\n  errorCode?: string;\n  errorCount?: number;\n  infoCount?: number;\n  overall?: number;\n  warnCount?: number;\n}\n\nexport interface ContentValidationCompletedProperties extends TelemetryProperties {\n  valid: boolean;\n  contentType?: TelemetryContentType;\n  durationMs?: number;\n  errorCount?: number;\n  itemCount?: number;\n  warningCount?: number;\n}\n\nexport interface ContentPublishCompletedProperties extends TelemetryProperties {\n  contentType: TelemetryContentType;\n  success: boolean;\n  durationMs: number;\n  errorCode?: string;\n  namespace?: string;\n  visibility?: TelemetryVisibility;\n}\n\nexport interface ProductEventProperties extends TelemetryProperties {\n  success?: boolean;\n  channel?: string;\n  entrypoint?: string;\n  plan?: string;\n}\n\nexport interface CampaignAttributionProperties extends TelemetryProperties {\n  attributionClickIdProvider?: string | null;\n  attributionClickIdPresent?: boolean;\n  attributionFirstLandingPath?: string | null;\n  attributionFirstReferrerDomain?: string | null;\n  attributionFirstUtmCampaign?: string | null;\n  attributionFirstUtmContent?: string | null;\n  attributionFirstUtmId?: string | null;\n  attributionFirstUtmMedium?: string | null;\n  attributionFirstUtmSource?: string | null;\n  attributionFirstUtmTerm?: string | null;\n  attributionLandingPath?: string | null;\n  attributionLastLandingPath?: string | null;\n  attributionLastReferrerDomain?: string | null;\n  attributionLastUtmCampaign?: string | null;\n  attributionLastUtmContent?: string | null;\n  attributionLastUtmId?: string | null;\n  attributionLastUtmMedium?: string | null;\n  attributionLastUtmSource?: string | null;\n  attributionLastUtmTerm?: string | null;\n  attributionReferrerDomain?: string | null;\n  attributionUtmCampaign?: string | null;\n  attributionUtmContent?: string | null;\n  attributionUtmId?: string | null;\n  attributionUtmMedium?: string | null;\n  attributionUtmSource?: string | null;\n  attributionUtmTerm?: string | null;\n}\n\nexport interface MarketingWebPageViewedProperties extends CampaignAttributionProperties {\n  routePath: string;\n  surface: string;\n}\n\nexport interface MarketingWebCtaClickedProperties extends CampaignAttributionProperties {\n  destination: string;\n  label?: string | null;\n  surface: string;\n}\n\nexport interface MarketingWebOutboundClickedProperties extends CampaignAttributionProperties {\n  destination: string;\n  label?: string | null;\n  surface: string;\n}\n\nexport interface MarketingWebCommandClickedProperties extends CampaignAttributionProperties {\n  commandKind: 'cli' | 'mcp' | 'other';\n  commandLabel?: string | null;\n  surface: string;\n}\n\nexport interface RegistryWebPageViewedProperties extends CampaignAttributionProperties {\n  authenticated: boolean;\n  orgScoped?: boolean;\n  plan?: string;\n  queryPresent?: boolean;\n  route: string;\n  routePath: string;\n  surface: string;\n}\n\nexport interface RegistryWebSearchPerformedProperties extends CampaignAttributionProperties {\n  contentType?: string;\n  queryLength: number;\n  resultCount?: number;\n  sort?: string;\n  sourceFilter?: string;\n  surface: string;\n}\n\nexport interface RegistryWebContentOpenedProperties extends CampaignAttributionProperties {\n  contentSource?: string;\n  contentType: string;\n  namespace?: string;\n  slug?: string;\n  surface: string;\n}\n\nexport interface RegistryWebCommercialPageViewedProperties extends CampaignAttributionProperties {\n  orgScoped?: boolean;\n  plan?: string;\n  surface: string;\n}\n\nexport type DecantrTelemetryEvent =\n  | TelemetryEventBase<'api_key.created', ProductEventProperties>\n  | TelemetryEventBase<'audit.completed', AuditCompletedProperties>\n  | TelemetryEventBase<'cli.command.completed', CliCommandCompletedProperties>\n  | TelemetryEventBase<'content.publish.completed', ContentPublishCompletedProperties>\n  | TelemetryEventBase<'content.validation.completed', ContentValidationCompletedProperties>\n  | TelemetryEventBase<'critique.completed', CritiqueCompletedProperties>\n  | TelemetryEventBase<'decantr.check.completed', DecantrLifecycleCompletedProperties>\n  | TelemetryEventBase<'decantr.health.healthy', ProjectHealthTelemetryProperties>\n  | TelemetryEventBase<'decantr.init.completed', DecantrLifecycleCompletedProperties>\n  | TelemetryEventBase<'decantr.new.completed', DecantrLifecycleCompletedProperties>\n  | TelemetryEventBase<'decantr.refresh.completed', DecantrLifecycleCompletedProperties>\n  | TelemetryEventBase<'execution_pack.compiled', ExecutionPackCompiledProperties>\n  | TelemetryEventBase<'execution_pack.selected', ExecutionPackSelectedProperties>\n  | TelemetryEventBase<'health.ci.failed', HealthCiFailedProperties>\n  | TelemetryEventBase<'health.finding.prompt_requested', HealthFindingPromptRequestedProperties>\n  | TelemetryEventBase<'health.report.generated', ProjectHealthTelemetryProperties>\n  | TelemetryEventBase<'marketing_web.command_clicked', MarketingWebCommandClickedProperties>\n  | TelemetryEventBase<'marketing_web.cta_clicked', MarketingWebCtaClickedProperties>\n  | TelemetryEventBase<'marketing_web.outbound_clicked', MarketingWebOutboundClickedProperties>\n  | TelemetryEventBase<'marketing_web.page_viewed', MarketingWebPageViewedProperties>\n  | TelemetryEventBase<'org.created', ProductEventProperties>\n  | TelemetryEventBase<'registry_web.api_key_page_viewed', RegistryWebCommercialPageViewedProperties>\n  | TelemetryEventBase<'registry_web.billing_viewed', RegistryWebCommercialPageViewedProperties>\n  | TelemetryEventBase<'registry_web.content_opened', RegistryWebContentOpenedProperties>\n  | TelemetryEventBase<'registry_web.identity_linked', RegistryWebCommercialPageViewedProperties>\n  | TelemetryEventBase<'registry_web.organization_viewed', RegistryWebCommercialPageViewedProperties>\n  | TelemetryEventBase<'registry_web.page_viewed', RegistryWebPageViewedProperties>\n  | TelemetryEventBase<'registry_web.search_performed', RegistryWebSearchPerformedProperties>\n  | TelemetryEventBase<'registry_web.signup_clicked', RegistryWebCommercialPageViewedProperties>\n  | TelemetryEventBase<'registry.item.resolved', RegistryItemResolvedProperties>\n  | TelemetryEventBase<'registry.sync.completed', RegistrySyncCompletedProperties>\n  | TelemetryEventBase<'studio.health_refreshed', StudioHealthRefreshedProperties>\n  | TelemetryEventBase<'studio.started', StudioStartedProperties>\n  | TelemetryEventBase<'user.signup.completed', ProductEventProperties>;\n\nexport function isDecantrTelemetryEventName(value: string): value is DecantrTelemetryEventName {\n  return (DECANTR_TELEMETRY_EVENT_NAMES as readonly string[]).includes(value);\n}\n"],"mappings":";AAAO,IAAM,mCAAmC;AAUzC,IAAM,gCAAgC;AAAA,EAC3C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAyBO,IAAM,gCAAgC;AAAA,EAC3C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAuCO,SAAS,qBAAqB,OAA6C;AAChF,SACE,OAAO,UAAU,YAChB,8BAAoD,SAAS,KAAK;AAEvE;AAEO,SAAS,0BACd,SACA,UAA2C,CAAC,GACxB;AACpB,MAAI,QAAQ,UAAW,QAAO,QAAQ;AAEtC,MAAI,QAAQ,WAAW,cAAc;AACnC,WAAO;AAAA,EACT;AAEA,MAAI,qBAAqB,SAAS,OAAO,GAAG;AAC1C,WAAO;AAAA,EACT;AAEA,MAAI,QAAQ,UAAU,QAAQ,SAAS,QAAQ,aAAa,QAAQ,WAAW;AAC7E,WAAO;AAAA,EACT;AAEA,MAAI,QAAQ,aAAa;AACvB,WAAO;AAAA,EACT;AAEA,SAAO;AACT;AAEA,SAAS,qBACP,SACA,SACS;AACT,SACE,UAAU,QAAQ,sBAAsB,QAAQ,WAAW,KAC3D,UAAU,QAAQ,oBAAoB,QAAQ,SAAS,KACvD,UAAU,QAAQ,gBAAgB,QAAQ,KAAK,KAC/C,UAAU,QAAQ,oBAAoB,QAAQ,SAAS,KACvD,UAAU,QAAQ,iBAAiB,QAAQ,MAAM;AAErD;AAEA,SAAS,UACP,QACA,OACS;AACT,MAAI,CAAC,UAAU,CAAC,MAAO,QAAO;AAC9B,MAAI,OAAQ,OAA+B,QAAQ,YAAY;AAC7D,WAAQ,OAA+B,IAAI,KAAK;AAAA,EAClD;AACA,SAAQ,OAA6B,SAAS,KAAK;AACrD;AA8SO,SAAS,4BAA4B,OAAmD;AAC7F,SAAQ,8BAAoD,SAAS,KAAK;AAC5E;","names":[]}
+{"version":3,"sources":["../src/events.ts"],"sourcesContent":["export const DECANTR_TELEMETRY_SCHEMA_VERSION = '0.3.0';\nexport const DECANTR_TELEMETRY_ACCEPTED_SCHEMA_VERSIONS = [\n  '0.2.0',\n  DECANTR_TELEMETRY_SCHEMA_VERSION,\n] as const;\n\nexport type TelemetrySource =\n  | 'api'\n  | 'cli'\n  | 'content-ci'\n  | 'marketing-web'\n  | 'mcp'\n  | 'registry-web';\nexport type TelemetryEnvironment = 'development' | 'preview' | 'production' | 'test';\nexport const DECANTR_TELEMETRY_ACTOR_TYPES = [\n  'anonymous',\n  'customer',\n  'internal',\n  'official_pipeline',\n  'service',\n] as const;\nexport type TelemetryActorType = (typeof DECANTR_TELEMETRY_ACTOR_TYPES)[number];\nexport type RegistrySource = 'cache' | 'custom' | 'none' | 'official' | 'private';\nexport type WorkflowMode =\n  | 'brownfield-attach'\n  | 'greenfield-contract-only'\n  | 'greenfield-scaffold'\n  | 'hybrid-compose';\nexport type AdoptionMode = 'contract-only' | 'decantr-css' | 'style-bridge';\nexport type ProjectScope = 'single-app' | 'workspace-app';\nexport type TelemetryContentType = 'archetype' | 'blueprint' | 'pattern' | 'shell' | 'theme';\nexport type TelemetryVisibility = 'private' | 'public' | 'team';\nexport type TelemetryAnalysisScope = 'hosted' | 'local';\nexport type ProjectHealthTelemetryStatus = 'error' | 'healthy' | 'warning';\nexport type ProjectHealthFindingSeverity = 'error' | 'info' | 'warn';\nexport type ProjectHealthFindingSource =\n  | 'audit'\n  | 'brownfield'\n  | 'check'\n  | 'interaction'\n  | 'pack'\n  | 'runtime';\nexport type ProjectHealthOutputFormat = 'json' | 'markdown' | 'text';\nexport type ProjectHealthFailOn = 'error' | 'none' | 'warn';\nexport type TelemetrySignalBucket =\n  | 'activation'\n  | 'billing_intent'\n  | 'cli_adoption'\n  | 'commercial_intent'\n  | 'content_pipeline'\n  | 'hosted_intelligence'\n  | 'identity_hygiene'\n  | 'paid_acquisition'\n  | 'private_registry_readiness'\n  | 'product_activation'\n  | 'project_health'\n  | 'registry_discovery';\nexport type TelemetryPrivacyClass = 'aggregate' | 'opaque_identity' | 'public_metadata';\n\nexport const DECANTR_TELEMETRY_EVENT_NAMES = [\n  'api_key.created',\n  'audit.completed',\n  'cli.command.completed',\n  'content.publish.completed',\n  'content.validation.completed',\n  'critique.completed',\n  'decantr.analyze.completed',\n  'decantr.check.completed',\n  'decantr.health.healthy',\n  'decantr.init.completed',\n  'decantr.new.completed',\n  'decantr.refresh.completed',\n  'execution_pack.compiled',\n  'execution_pack.selected',\n  'health.ci.failed',\n  'health.finding.prompt_requested',\n  'health.report.generated',\n  'marketing_web.command_clicked',\n  'marketing_web.cta_clicked',\n  'marketing_web.outbound_clicked',\n  'marketing_web.page_viewed',\n  'org.created',\n  'billing.checkout_blocked',\n  'billing.plan_clicked',\n  'private_registry.content_listed',\n  'private_registry.gate_viewed',\n  'private_registry.intent_clicked',\n  'registry_web.api_key_page_viewed',\n  'registry_web.billing_viewed',\n  'registry_web.content_opened',\n  'registry_web.identity_linked',\n  'registry_web.organization_viewed',\n  'registry_web.page_viewed',\n  'registry_web.search_performed',\n  'registry_web.signup_clicked',\n  'registry.item.resolved',\n  'registry.sync.completed',\n  'studio.health_refreshed',\n  'studio.started',\n  'telemetry.identity_linked',\n  'user.signup.completed',\n] as const;\n\nexport type DecantrTelemetryEventName = (typeof DECANTR_TELEMETRY_EVENT_NAMES)[number];\n\nexport type TelemetryPropertyValue =\n  | TelemetryPropertyValue[]\n  | boolean\n  | null\n  | number\n  | string\n  | undefined\n  | { [key: string]: TelemetryPropertyValue };\n\nexport type TelemetryProperties = Record<string, TelemetryPropertyValue>;\n\nexport interface TelemetryContext {\n  source: TelemetrySource;\n  actorType?: TelemetryActorType;\n  environment?: TelemetryEnvironment;\n  serviceName?: string;\n  serviceVersion?: string;\n  decantrVersion?: string;\n  registrySource?: RegistrySource;\n  anonymousId?: string;\n  installId?: string;\n  projectId?: string;\n  sessionId?: string;\n  userId?: string;\n  orgId?: string;\n}\n\nexport interface TelemetryActorResolutionOptions {\n  internalAnonymousIds?: readonly string[] | ReadonlySet<string>;\n  internalInstallIds?: readonly string[] | ReadonlySet<string>;\n  internalOrgIds?: readonly string[] | ReadonlySet<string>;\n  internalProjectIds?: readonly string[] | ReadonlySet<string>;\n  internalUserIds?: readonly string[] | ReadonlySet<string>;\n}\n\nexport function isTelemetryActorType(value: unknown): value is TelemetryActorType {\n  return (\n    typeof value === 'string' &&\n    (DECANTR_TELEMETRY_ACTOR_TYPES as readonly string[]).includes(value)\n  );\n}\n\nexport function resolveTelemetryActorType(\n  context: TelemetryContext,\n  options: TelemetryActorResolutionOptions = {},\n): TelemetryActorType {\n  if (context.actorType) return context.actorType;\n\n  if (context.source === 'content-ci') {\n    return 'official_pipeline';\n  }\n\n  if (matchesInternalActor(context, options)) {\n    return 'internal';\n  }\n\n  if (context.userId || context.orgId || context.projectId || context.installId) {\n    return 'customer';\n  }\n\n  if (context.anonymousId) {\n    return 'anonymous';\n  }\n\n  return 'service';\n}\n\nfunction matchesInternalActor(\n  context: TelemetryContext,\n  options: TelemetryActorResolutionOptions,\n): boolean {\n  return (\n    idListHas(options.internalAnonymousIds, context.anonymousId) ||\n    idListHas(options.internalInstallIds, context.installId) ||\n    idListHas(options.internalOrgIds, context.orgId) ||\n    idListHas(options.internalProjectIds, context.projectId) ||\n    idListHas(options.internalUserIds, context.userId)\n  );\n}\n\nfunction idListHas(\n  values: readonly string[] | ReadonlySet<string> | undefined,\n  value: string | undefined,\n): boolean {\n  if (!values || !value) return false;\n  if (typeof (values as ReadonlySet<string>).has === 'function') {\n    return (values as ReadonlySet<string>).has(value);\n  }\n  return (values as readonly string[]).includes(value);\n}\n\nexport interface TelemetryEventBase<\n  Name extends DecantrTelemetryEventName = DecantrTelemetryEventName,\n  Properties extends TelemetryProperties = TelemetryProperties,\n> {\n  name: Name;\n  context: TelemetryContext;\n  properties: Properties;\n  timestamp?: Date | string;\n}\n\nexport interface CliCommandCompletedProperties extends TelemetryProperties {\n  command: string;\n  success: boolean;\n  durationMs: number;\n  adoptionMode?: AdoptionMode;\n  errorCode?: string;\n  offline?: boolean;\n  projectScope?: ProjectScope;\n  registrySource?: RegistrySource;\n  targetFramework?: string;\n  workflowMode?: WorkflowMode;\n}\n\nexport interface DecantrAnalyzeCompletedProperties extends TelemetryProperties {\n  command: 'analyze';\n  success: boolean;\n  durationMs?: number;\n  adoptionMode?: AdoptionMode;\n  componentCount?: number;\n  dependencyCategoryCount?: number;\n  errorCode?: string;\n  pageCount?: number;\n  projectScope?: ProjectScope;\n  routeCount?: number;\n  targetFramework?: string;\n  workflowMode?: WorkflowMode;\n}\n\nexport interface DecantrLifecycleCompletedProperties extends TelemetryProperties {\n  command: 'check' | 'init' | 'new' | 'refresh';\n  success: boolean;\n  durationMs: number;\n  adoptionMode?: AdoptionMode;\n  errorCode?: string;\n  offline?: boolean;\n  projectScope?: ProjectScope;\n  registrySource?: RegistrySource;\n  targetFramework?: string;\n  workflowMode?: WorkflowMode;\n}\n\nexport interface ProjectHealthTelemetryProperties extends TelemetryProperties {\n  success: boolean;\n  status: ProjectHealthTelemetryStatus;\n  score: number;\n  durationMs?: number;\n  adoptionMode?: AdoptionMode;\n  ci?: boolean;\n  errorCode?: string;\n  errorCount: number;\n  failOn?: ProjectHealthFailOn;\n  findingCount: number;\n  format?: ProjectHealthOutputFormat;\n  infoCount: number;\n  outputWritten?: boolean;\n  packManifestPresent?: boolean;\n  pageCount?: number;\n  projectScope?: ProjectScope;\n  reviewPackPresent?: boolean;\n  routeCount?: number;\n  runtimeAuditChecked?: boolean;\n  runtimeMatchedCount?: number;\n  runtimePassed?: boolean | null;\n  runtimeRouteCheckedCount?: number;\n  warnCount: number;\n  workflowMode?: WorkflowMode;\n}\n\nexport interface HealthFindingPromptRequestedProperties extends TelemetryProperties {\n  success: boolean;\n  findingFound: boolean;\n  adoptionMode?: AdoptionMode;\n  ci?: boolean;\n  findingSeverity?: ProjectHealthFindingSeverity;\n  findingSource?: ProjectHealthFindingSource;\n  projectScope?: ProjectScope;\n  workflowMode?: WorkflowMode;\n}\n\nexport interface HealthCiFailedProperties extends ProjectHealthTelemetryProperties {\n  failOn: 'error' | 'warn';\n}\n\nexport interface StudioStartedProperties extends TelemetryProperties {\n  success: boolean;\n  hostMode: 'custom' | 'loopback';\n  port: number;\n  adoptionMode?: AdoptionMode;\n  errorCode?: string;\n  projectScope?: ProjectScope;\n  workflowMode?: WorkflowMode;\n}\n\nexport interface StudioHealthRefreshedProperties extends ProjectHealthTelemetryProperties {\n  trigger: 'api-refresh';\n}\n\nexport interface RegistryItemResolvedProperties extends TelemetryProperties {\n  contentType: TelemetryContentType;\n  success: boolean;\n  cacheHit?: boolean;\n  durationMs?: number;\n  errorCode?: string;\n  itemId?: string;\n  namespace?: string;\n  registrySource?: RegistrySource;\n  version?: string;\n  visibility?: TelemetryVisibility;\n}\n\nexport interface RegistrySyncCompletedProperties extends TelemetryProperties {\n  success: boolean;\n  durationMs: number;\n  errorCode?: string;\n  registrySource?: RegistrySource;\n  totalItems?: number;\n}\n\nexport interface ExecutionPackCompiledProperties extends TelemetryProperties {\n  success: boolean;\n  durationMs: number;\n  errorCode?: string;\n  pageCount?: number;\n  patternCount?: number;\n  sectionCount?: number;\n  targetFramework?: string;\n}\n\nexport interface ExecutionPackSelectedProperties extends TelemetryProperties {\n  packType: 'mutation' | 'page' | 'review' | 'scaffold' | 'section';\n  success: boolean;\n  durationMs?: number;\n  errorCode?: string;\n  id?: string;\n}\n\nexport interface AuditCompletedProperties extends TelemetryProperties {\n  scope: TelemetryAnalysisScope;\n  success: boolean;\n  durationMs: number;\n  errorCode?: string;\n  errorCount?: number;\n  pageCount?: number;\n  runtimePassed?: boolean;\n  score?: number;\n  warnCount?: number;\n}\n\nexport interface CritiqueCompletedProperties extends TelemetryProperties {\n  scope: TelemetryAnalysisScope;\n  success: boolean;\n  durationMs: number;\n  errorCode?: string;\n  errorCount?: number;\n  infoCount?: number;\n  overall?: number;\n  warnCount?: number;\n}\n\nexport interface ContentValidationCompletedProperties extends TelemetryProperties {\n  valid: boolean;\n  contentType?: TelemetryContentType;\n  durationMs?: number;\n  errorCount?: number;\n  itemCount?: number;\n  warningCount?: number;\n}\n\nexport interface ContentPublishCompletedProperties extends TelemetryProperties {\n  contentType: TelemetryContentType;\n  success: boolean;\n  durationMs: number;\n  errorCode?: string;\n  namespace?: string;\n  visibility?: TelemetryVisibility;\n}\n\nexport interface ProductEventProperties extends TelemetryProperties {\n  success?: boolean;\n  channel?: string;\n  entrypoint?: string;\n  plan?: string;\n}\n\nexport interface CampaignAttributionProperties extends TelemetryProperties {\n  attributionClickIdProvider?: string | null;\n  attributionClickIdPresent?: boolean;\n  attributionFirstLandingPath?: string | null;\n  attributionFirstReferrerDomain?: string | null;\n  attributionFirstUtmCampaign?: string | null;\n  attributionFirstUtmContent?: string | null;\n  attributionFirstUtmId?: string | null;\n  attributionFirstUtmMedium?: string | null;\n  attributionFirstUtmSource?: string | null;\n  attributionFirstUtmTerm?: string | null;\n  attributionLandingPath?: string | null;\n  attributionLastLandingPath?: string | null;\n  attributionLastReferrerDomain?: string | null;\n  attributionLastUtmCampaign?: string | null;\n  attributionLastUtmContent?: string | null;\n  attributionLastUtmId?: string | null;\n  attributionLastUtmMedium?: string | null;\n  attributionLastUtmSource?: string | null;\n  attributionLastUtmTerm?: string | null;\n  attributionReferrerDomain?: string | null;\n  attributionUtmCampaign?: string | null;\n  attributionUtmContent?: string | null;\n  attributionUtmId?: string | null;\n  attributionUtmMedium?: string | null;\n  attributionUtmSource?: string | null;\n  attributionUtmTerm?: string | null;\n}\n\nexport interface MarketingWebPageViewedProperties extends CampaignAttributionProperties {\n  routePath: string;\n  surface: string;\n}\n\nexport interface MarketingWebCtaClickedProperties extends CampaignAttributionProperties {\n  destination: string;\n  label?: string | null;\n  surface: string;\n}\n\nexport interface MarketingWebOutboundClickedProperties extends CampaignAttributionProperties {\n  destination: string;\n  label?: string | null;\n  surface: string;\n}\n\nexport interface MarketingWebCommandClickedProperties extends CampaignAttributionProperties {\n  commandKind: 'cli' | 'mcp' | 'other';\n  commandLabel?: string | null;\n  surface: string;\n}\n\nexport interface RegistryWebPageViewedProperties extends CampaignAttributionProperties {\n  authenticated: boolean;\n  orgScoped?: boolean;\n  plan?: string;\n  queryPresent?: boolean;\n  route: string;\n  routePath: string;\n  surface: string;\n}\n\nexport interface RegistryWebSearchPerformedProperties extends CampaignAttributionProperties {\n  contentType?: string;\n  queryLength: number;\n  resultCount?: number;\n  sort?: string;\n  sourceFilter?: string;\n  surface: string;\n}\n\nexport interface RegistryWebContentOpenedProperties extends CampaignAttributionProperties {\n  contentSource?: string;\n  contentType: string;\n  namespace?: string;\n  slug?: string;\n  surface: string;\n}\n\nexport interface RegistryWebCommercialPageViewedProperties extends CampaignAttributionProperties {\n  orgScoped?: boolean;\n  plan?: string;\n  surface: string;\n}\n\nexport interface TelemetryIdentityLinkedProperties extends TelemetryProperties {\n  success: boolean;\n  entrypoint?: string;\n  identityType?: 'anonymous' | 'install' | 'project';\n  linkCount?: number;\n  orgScoped?: boolean;\n  plan?: string;\n  surface?: string;\n}\n\nexport interface PrivateRegistryGateViewedProperties extends TelemetryProperties {\n  orgScoped: boolean;\n  plan?: string;\n  surface: string;\n  enterpriseOrgCount?: number;\n}\n\nexport interface PrivateRegistryIntentClickedProperties extends TelemetryProperties {\n  action: 'open_billing' | 'open_team' | 'open_private_registry';\n  orgScoped: boolean;\n  plan?: string;\n  surface: string;\n}\n\nexport interface PrivateRegistryContentListedProperties extends TelemetryProperties {\n  itemCount: number;\n  orgScoped: true;\n  plan?: string;\n  queryPresent?: boolean;\n  statusFilterPresent?: boolean;\n  surface: string;\n  typeFilterPresent?: boolean;\n  visibilityFilterPresent?: boolean;\n}\n\nexport interface BillingPlanClickedProperties extends TelemetryProperties {\n  billingEnabled: boolean;\n  currentPlan?: string;\n  orgScoped?: boolean;\n  plan: 'enterprise' | 'pro' | 'team';\n  surface: string;\n}\n\nexport interface BillingCheckoutBlockedProperties extends TelemetryProperties {\n  billingEnabled: boolean;\n  orgScoped?: boolean;\n  plan?: 'enterprise' | 'pro' | 'team';\n  reason: 'billing_coming_soon' | 'billing_not_configured' | 'not_authorized';\n  surface: string;\n}\n\nexport interface TelemetryEventCatalogEntry {\n  name: DecantrTelemetryEventName;\n  allowedSources: readonly TelemetrySource[];\n  bucket: TelemetrySignalBucket;\n  privacy: TelemetryPrivacyClass;\n  privacyNotes: string;\n  publicIngest: boolean;\n}\n\nconst API_ONLY = ['api'] as const;\nconst CLI_ONLY = ['cli'] as const;\nconst REGISTRY_WEB_ONLY = ['registry-web'] as const;\nconst MARKETING_WEB_ONLY = ['marketing-web'] as const;\nconst CONTENT_CI_AND_API = ['content-ci', 'api'] as const;\nconst REGISTRY_RESOLUTION_SOURCES = ['api', 'cli', 'mcp'] as const;\n\nexport const DECANTR_TELEMETRY_EVENT_CATALOG: readonly TelemetryEventCatalogEntry[] = [\n  eventCatalogEntry('api_key.created', API_ONLY, 'activation', 'aggregate', false),\n  eventCatalogEntry('audit.completed', API_ONLY, 'hosted_intelligence', 'aggregate', false),\n  eventCatalogEntry('cli.command.completed', CLI_ONLY, 'cli_adoption', 'aggregate', true),\n  eventCatalogEntry('content.publish.completed', CONTENT_CI_AND_API, 'content_pipeline', 'aggregate', true),\n  eventCatalogEntry('content.validation.completed', CONTENT_CI_AND_API, 'content_pipeline', 'aggregate', true),\n  eventCatalogEntry('critique.completed', API_ONLY, 'hosted_intelligence', 'aggregate', false),\n  eventCatalogEntry('decantr.analyze.completed', CLI_ONLY, 'product_activation', 'aggregate', true),\n  eventCatalogEntry('decantr.check.completed', CLI_ONLY, 'product_activation', 'aggregate', true),\n  eventCatalogEntry('decantr.health.healthy', CLI_ONLY, 'project_health', 'aggregate', true),\n  eventCatalogEntry('decantr.init.completed', CLI_ONLY, 'product_activation', 'aggregate', true),\n  eventCatalogEntry('decantr.new.completed', CLI_ONLY, 'product_activation', 'aggregate', true),\n  eventCatalogEntry('decantr.refresh.completed', CLI_ONLY, 'product_activation', 'aggregate', true),\n  eventCatalogEntry('execution_pack.compiled', API_ONLY, 'hosted_intelligence', 'aggregate', false),\n  eventCatalogEntry('execution_pack.selected', API_ONLY, 'hosted_intelligence', 'aggregate', false),\n  eventCatalogEntry('health.ci.failed', CLI_ONLY, 'project_health', 'aggregate', true),\n  eventCatalogEntry('health.finding.prompt_requested', CLI_ONLY, 'project_health', 'aggregate', true),\n  eventCatalogEntry('health.report.generated', CLI_ONLY, 'project_health', 'aggregate', true),\n  eventCatalogEntry('marketing_web.command_clicked', MARKETING_WEB_ONLY, 'paid_acquisition', 'public_metadata', true),\n  eventCatalogEntry('marketing_web.cta_clicked', MARKETING_WEB_ONLY, 'paid_acquisition', 'public_metadata', true),\n  eventCatalogEntry('marketing_web.outbound_clicked', MARKETING_WEB_ONLY, 'paid_acquisition', 'public_metadata', true),\n  eventCatalogEntry('marketing_web.page_viewed', MARKETING_WEB_ONLY, 'paid_acquisition', 'public_metadata', true),\n  eventCatalogEntry('org.created', API_ONLY, 'activation', 'aggregate', false),\n  eventCatalogEntry('billing.checkout_blocked', ['api', 'registry-web'], 'billing_intent', 'aggregate', true),\n  eventCatalogEntry('billing.plan_clicked', REGISTRY_WEB_ONLY, 'billing_intent', 'aggregate', true),\n  eventCatalogEntry('private_registry.content_listed', REGISTRY_WEB_ONLY, 'private_registry_readiness', 'aggregate', true),\n  eventCatalogEntry('private_registry.gate_viewed', REGISTRY_WEB_ONLY, 'private_registry_readiness', 'aggregate', true),\n  eventCatalogEntry('private_registry.intent_clicked', REGISTRY_WEB_ONLY, 'private_registry_readiness', 'aggregate', true),\n  eventCatalogEntry('registry_web.api_key_page_viewed', REGISTRY_WEB_ONLY, 'commercial_intent', 'public_metadata', true),\n  eventCatalogEntry('registry_web.billing_viewed', REGISTRY_WEB_ONLY, 'commercial_intent', 'public_metadata', true),\n  eventCatalogEntry('registry_web.content_opened', REGISTRY_WEB_ONLY, 'registry_discovery', 'public_metadata', true),\n  eventCatalogEntry('registry_web.identity_linked', REGISTRY_WEB_ONLY, 'identity_hygiene', 'opaque_identity', true),\n  eventCatalogEntry('registry_web.organization_viewed', REGISTRY_WEB_ONLY, 'commercial_intent', 'aggregate', true),\n  eventCatalogEntry('registry_web.page_viewed', REGISTRY_WEB_ONLY, 'registry_discovery', 'public_metadata', true),\n  eventCatalogEntry('registry_web.search_performed', REGISTRY_WEB_ONLY, 'registry_discovery', 'aggregate', true),\n  eventCatalogEntry('registry_web.signup_clicked', REGISTRY_WEB_ONLY, 'activation', 'public_metadata', true),\n  eventCatalogEntry('registry.item.resolved', REGISTRY_RESOLUTION_SOURCES, 'registry_discovery', 'aggregate', true),\n  eventCatalogEntry('registry.sync.completed', CLI_ONLY, 'cli_adoption', 'aggregate', true),\n  eventCatalogEntry('studio.health_refreshed', CLI_ONLY, 'project_health', 'aggregate', true),\n  eventCatalogEntry('studio.started', CLI_ONLY, 'project_health', 'aggregate', true),\n  eventCatalogEntry('telemetry.identity_linked', API_ONLY, 'identity_hygiene', 'opaque_identity', false),\n  eventCatalogEntry('user.signup.completed', API_ONLY, 'activation', 'aggregate', false),\n];\n\nconst TELEMETRY_EVENT_CATALOG_BY_NAME = new Map(\n  DECANTR_TELEMETRY_EVENT_CATALOG.map((entry) => [entry.name, entry]),\n);\n\nexport type DecantrTelemetryEvent =\n  | TelemetryEventBase<'api_key.created', ProductEventProperties>\n  | TelemetryEventBase<'audit.completed', AuditCompletedProperties>\n  | TelemetryEventBase<'billing.checkout_blocked', BillingCheckoutBlockedProperties>\n  | TelemetryEventBase<'billing.plan_clicked', BillingPlanClickedProperties>\n  | TelemetryEventBase<'cli.command.completed', CliCommandCompletedProperties>\n  | TelemetryEventBase<'content.publish.completed', ContentPublishCompletedProperties>\n  | TelemetryEventBase<'content.validation.completed', ContentValidationCompletedProperties>\n  | TelemetryEventBase<'critique.completed', CritiqueCompletedProperties>\n  | TelemetryEventBase<'decantr.analyze.completed', DecantrAnalyzeCompletedProperties>\n  | TelemetryEventBase<'decantr.check.completed', DecantrLifecycleCompletedProperties>\n  | TelemetryEventBase<'decantr.health.healthy', ProjectHealthTelemetryProperties>\n  | TelemetryEventBase<'decantr.init.completed', DecantrLifecycleCompletedProperties>\n  | TelemetryEventBase<'decantr.new.completed', DecantrLifecycleCompletedProperties>\n  | TelemetryEventBase<'decantr.refresh.completed', DecantrLifecycleCompletedProperties>\n  | TelemetryEventBase<'execution_pack.compiled', ExecutionPackCompiledProperties>\n  | TelemetryEventBase<'execution_pack.selected', ExecutionPackSelectedProperties>\n  | TelemetryEventBase<'health.ci.failed', HealthCiFailedProperties>\n  | TelemetryEventBase<'health.finding.prompt_requested', HealthFindingPromptRequestedProperties>\n  | TelemetryEventBase<'health.report.generated', ProjectHealthTelemetryProperties>\n  | TelemetryEventBase<'marketing_web.command_clicked', MarketingWebCommandClickedProperties>\n  | TelemetryEventBase<'marketing_web.cta_clicked', MarketingWebCtaClickedProperties>\n  | TelemetryEventBase<'marketing_web.outbound_clicked', MarketingWebOutboundClickedProperties>\n  | TelemetryEventBase<'marketing_web.page_viewed', MarketingWebPageViewedProperties>\n  | TelemetryEventBase<'org.created', ProductEventProperties>\n  | TelemetryEventBase<'private_registry.content_listed', PrivateRegistryContentListedProperties>\n  | TelemetryEventBase<'private_registry.gate_viewed', PrivateRegistryGateViewedProperties>\n  | TelemetryEventBase<'private_registry.intent_clicked', PrivateRegistryIntentClickedProperties>\n  | TelemetryEventBase<'registry_web.api_key_page_viewed', RegistryWebCommercialPageViewedProperties>\n  | TelemetryEventBase<'registry_web.billing_viewed', RegistryWebCommercialPageViewedProperties>\n  | TelemetryEventBase<'registry_web.content_opened', RegistryWebContentOpenedProperties>\n  | TelemetryEventBase<'registry_web.identity_linked', RegistryWebCommercialPageViewedProperties>\n  | TelemetryEventBase<'registry_web.organization_viewed', RegistryWebCommercialPageViewedProperties>\n  | TelemetryEventBase<'registry_web.page_viewed', RegistryWebPageViewedProperties>\n  | TelemetryEventBase<'registry_web.search_performed', RegistryWebSearchPerformedProperties>\n  | TelemetryEventBase<'registry_web.signup_clicked', RegistryWebCommercialPageViewedProperties>\n  | TelemetryEventBase<'registry.item.resolved', RegistryItemResolvedProperties>\n  | TelemetryEventBase<'registry.sync.completed', RegistrySyncCompletedProperties>\n  | TelemetryEventBase<'studio.health_refreshed', StudioHealthRefreshedProperties>\n  | TelemetryEventBase<'studio.started', StudioStartedProperties>\n  | TelemetryEventBase<'telemetry.identity_linked', TelemetryIdentityLinkedProperties>\n  | TelemetryEventBase<'user.signup.completed', ProductEventProperties>;\n\nexport function isDecantrTelemetrySchemaVersion(\n  value: unknown,\n): value is (typeof DECANTR_TELEMETRY_ACCEPTED_SCHEMA_VERSIONS)[number] {\n  return (\n    typeof value === 'string' &&\n    (DECANTR_TELEMETRY_ACCEPTED_SCHEMA_VERSIONS as readonly string[]).includes(value)\n  );\n}\n\nexport function isDecantrTelemetryEventName(value: string): value is DecantrTelemetryEventName {\n  return (DECANTR_TELEMETRY_EVENT_NAMES as readonly string[]).includes(value);\n}\n\nexport function getTelemetryEventCatalogEntry(\n  name: DecantrTelemetryEventName,\n): TelemetryEventCatalogEntry {\n  return TELEMETRY_EVENT_CATALOG_BY_NAME.get(name)!;\n}\n\nexport function isTelemetryEventAllowedForSource(\n  name: DecantrTelemetryEventName,\n  source: TelemetrySource,\n): boolean {\n  return getTelemetryEventCatalogEntry(name).allowedSources.includes(source);\n}\n\nfunction eventCatalogEntry(\n  name: DecantrTelemetryEventName,\n  allowedSources: readonly TelemetrySource[],\n  bucket: TelemetrySignalBucket,\n  privacy: TelemetryPrivacyClass,\n  publicIngest: boolean,\n): TelemetryEventCatalogEntry {\n  return {\n    name,\n    allowedSources,\n    bucket,\n    privacy,\n    publicIngest,\n    privacyNotes:\n      privacy === 'aggregate'\n        ? 'Aggregate product metadata only; no source, prompts, raw paths, emails, or secrets.'\n        : privacy === 'opaque_identity'\n          ? 'Opaque Decantr identity ids only; no emails, source, prompts, raw paths, or secrets.'\n          : 'Public product or acquisition metadata only; no raw referrer URLs, user agents, emails, or click ids.',\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.ts

@@ -1,4 +1,4 @@
 export { FetchTelemetrySinkOptions, TelemetryClient, TelemetryClientOptions, TelemetrySink, createFetchTelemetrySink, createNoopTelemetrySink, createTelemetryClient } from './client.js';
-export { AdoptionMode, AuditCompletedProperties, CampaignAttributionProperties, CliCommandCompletedProperties, ContentPublishCompletedProperties, ContentValidationCompletedProperties, CritiqueCompletedProperties, DECANTR_TELEMETRY_ACTOR_TYPES, DECANTR_TELEMETRY_EVENT_NAMES, DECANTR_TELEMETRY_SCHEMA_VERSION, DecantrLifecycleCompletedProperties, DecantrTelemetryEvent, DecantrTelemetryEventName, ExecutionPackCompiledProperties, ExecutionPackSelectedProperties, HealthCiFailedProperties, HealthFindingPromptRequestedProperties, MarketingWebCommandClickedProperties, MarketingWebCtaClickedProperties, MarketingWebOutboundClickedProperties, MarketingWebPageViewedProperties, ProductEventProperties, ProjectHealthFailOn, ProjectHealthFindingSeverity, ProjectHealthFindingSource, ProjectHealthOutputFormat, ProjectHealthTelemetryProperties, ProjectHealthTelemetryStatus, ProjectScope, RegistryItemResolvedProperties, RegistrySource, RegistrySyncCompletedProperties, RegistryWebCommercialPageViewedProperties, RegistryWebContentOpenedProperties, RegistryWebPageViewedProperties, RegistryWebSearchPerformedProperties, StudioHealthRefreshedProperties, StudioStartedProperties, TelemetryActorResolutionOptions, TelemetryActorType, TelemetryAnalysisScope, TelemetryContentType, TelemetryContext, TelemetryEnvironment, TelemetryProperties, TelemetryPropertyValue, TelemetrySource, TelemetryVisibility, WorkflowMode, isDecantrTelemetryEventName, isTelemetryActorType, resolveTelemetryActorType } from './events.js';
+export { AdoptionMode, AuditCompletedProperties, BillingCheckoutBlockedProperties, BillingPlanClickedProperties, CampaignAttributionProperties, CliCommandCompletedProperties, ContentPublishCompletedProperties, ContentValidationCompletedProperties, CritiqueCompletedProperties, DECANTR_TELEMETRY_ACCEPTED_SCHEMA_VERSIONS, DECANTR_TELEMETRY_ACTOR_TYPES, DECANTR_TELEMETRY_EVENT_CATALOG, DECANTR_TELEMETRY_EVENT_NAMES, DECANTR_TELEMETRY_SCHEMA_VERSION, DecantrAnalyzeCompletedProperties, DecantrLifecycleCompletedProperties, DecantrTelemetryEvent, DecantrTelemetryEventName, ExecutionPackCompiledProperties, ExecutionPackSelectedProperties, HealthCiFailedProperties, HealthFindingPromptRequestedProperties, MarketingWebCommandClickedProperties, MarketingWebCtaClickedProperties, MarketingWebOutboundClickedProperties, MarketingWebPageViewedProperties, PrivateRegistryContentListedProperties, PrivateRegistryGateViewedProperties, PrivateRegistryIntentClickedProperties, ProductEventProperties, ProjectHealthFailOn, ProjectHealthFindingSeverity, ProjectHealthFindingSource, ProjectHealthOutputFormat, ProjectHealthTelemetryProperties, ProjectHealthTelemetryStatus, ProjectScope, RegistryItemResolvedProperties, RegistrySource, RegistrySyncCompletedProperties, RegistryWebCommercialPageViewedProperties, RegistryWebContentOpenedProperties, RegistryWebPageViewedProperties, RegistryWebSearchPerformedProperties, StudioHealthRefreshedProperties, StudioStartedProperties, TelemetryActorResolutionOptions, TelemetryActorType, TelemetryAnalysisScope, TelemetryContentType, TelemetryContext, TelemetryEnvironment, TelemetryEventCatalogEntry, TelemetryIdentityLinkedProperties, TelemetryPrivacyClass, TelemetryProperties, TelemetryPropertyValue, TelemetrySignalBucket, TelemetrySource, TelemetryVisibility, WorkflowMode, getTelemetryEventCatalogEntry, isDecantrTelemetryEventName, isDecantrTelemetrySchemaVersion, isTelemetryActorType, isTelemetryEventAllowedForSource, resolveTelemetryActorType } from './events.js';
 export { PostHogTelemetrySinkOptions, createPostHogTelemetrySink } from './posthog.js';
 export { REDACTED_VALUE, TelemetryRedactionOptions, isSensitiveTelemetryKey, sanitizeTelemetryEvent, sanitizeTelemetryValue } from './privacy.js';

package/dist/index.js

@@ -1,5 +1,9 @@
 // src/events.ts
-var DECANTR_TELEMETRY_SCHEMA_VERSION = "0.2.0";
+var DECANTR_TELEMETRY_SCHEMA_VERSION = "0.3.0";
+var DECANTR_TELEMETRY_ACCEPTED_SCHEMA_VERSIONS = [
+  "0.2.0",
+  DECANTR_TELEMETRY_SCHEMA_VERSION
+];
 var DECANTR_TELEMETRY_ACTOR_TYPES = [
   "anonymous",
   "customer",
@@ -14,6 +18,7 @@ var DECANTR_TELEMETRY_EVENT_NAMES = [
   "content.publish.completed",
   "content.validation.completed",
   "critique.completed",
+  "decantr.analyze.completed",
   "decantr.check.completed",
   "decantr.health.healthy",
   "decantr.init.completed",
@@ -29,6 +34,11 @@ var DECANTR_TELEMETRY_EVENT_NAMES = [
   "marketing_web.outbound_clicked",
   "marketing_web.page_viewed",
   "org.created",
+  "billing.checkout_blocked",
+  "billing.plan_clicked",
+  "private_registry.content_listed",
+  "private_registry.gate_viewed",
+  "private_registry.intent_clicked",
   "registry_web.api_key_page_viewed",
   "registry_web.billing_viewed",
   "registry_web.content_opened",
@@ -41,6 +51,7 @@ var DECANTR_TELEMETRY_EVENT_NAMES = [
   "registry.sync.completed",
   "studio.health_refreshed",
   "studio.started",
+  "telemetry.identity_linked",
   "user.signup.completed"
 ];
 function isTelemetryActorType(value) {
@@ -72,9 +83,80 @@ function idListHas(values, value) {
   }
   return values.includes(value);
 }
+var API_ONLY = ["api"];
+var CLI_ONLY = ["cli"];
+var REGISTRY_WEB_ONLY = ["registry-web"];
+var MARKETING_WEB_ONLY = ["marketing-web"];
+var CONTENT_CI_AND_API = ["content-ci", "api"];
+var REGISTRY_RESOLUTION_SOURCES = ["api", "cli", "mcp"];
+var DECANTR_TELEMETRY_EVENT_CATALOG = [
+  eventCatalogEntry("api_key.created", API_ONLY, "activation", "aggregate", false),
+  eventCatalogEntry("audit.completed", API_ONLY, "hosted_intelligence", "aggregate", false),
+  eventCatalogEntry("cli.command.completed", CLI_ONLY, "cli_adoption", "aggregate", true),
+  eventCatalogEntry("content.publish.completed", CONTENT_CI_AND_API, "content_pipeline", "aggregate", true),
+  eventCatalogEntry("content.validation.completed", CONTENT_CI_AND_API, "content_pipeline", "aggregate", true),
+  eventCatalogEntry("critique.completed", API_ONLY, "hosted_intelligence", "aggregate", false),
+  eventCatalogEntry("decantr.analyze.completed", CLI_ONLY, "product_activation", "aggregate", true),
+  eventCatalogEntry("decantr.check.completed", CLI_ONLY, "product_activation", "aggregate", true),
+  eventCatalogEntry("decantr.health.healthy", CLI_ONLY, "project_health", "aggregate", true),
+  eventCatalogEntry("decantr.init.completed", CLI_ONLY, "product_activation", "aggregate", true),
+  eventCatalogEntry("decantr.new.completed", CLI_ONLY, "product_activation", "aggregate", true),
+  eventCatalogEntry("decantr.refresh.completed", CLI_ONLY, "product_activation", "aggregate", true),
+  eventCatalogEntry("execution_pack.compiled", API_ONLY, "hosted_intelligence", "aggregate", false),
+  eventCatalogEntry("execution_pack.selected", API_ONLY, "hosted_intelligence", "aggregate", false),
+  eventCatalogEntry("health.ci.failed", CLI_ONLY, "project_health", "aggregate", true),
+  eventCatalogEntry("health.finding.prompt_requested", CLI_ONLY, "project_health", "aggregate", true),
+  eventCatalogEntry("health.report.generated", CLI_ONLY, "project_health", "aggregate", true),
+  eventCatalogEntry("marketing_web.command_clicked", MARKETING_WEB_ONLY, "paid_acquisition", "public_metadata", true),
+  eventCatalogEntry("marketing_web.cta_clicked", MARKETING_WEB_ONLY, "paid_acquisition", "public_metadata", true),
+  eventCatalogEntry("marketing_web.outbound_clicked", MARKETING_WEB_ONLY, "paid_acquisition", "public_metadata", true),
+  eventCatalogEntry("marketing_web.page_viewed", MARKETING_WEB_ONLY, "paid_acquisition", "public_metadata", true),
+  eventCatalogEntry("org.created", API_ONLY, "activation", "aggregate", false),
+  eventCatalogEntry("billing.checkout_blocked", ["api", "registry-web"], "billing_intent", "aggregate", true),
+  eventCatalogEntry("billing.plan_clicked", REGISTRY_WEB_ONLY, "billing_intent", "aggregate", true),
+  eventCatalogEntry("private_registry.content_listed", REGISTRY_WEB_ONLY, "private_registry_readiness", "aggregate", true),
+  eventCatalogEntry("private_registry.gate_viewed", REGISTRY_WEB_ONLY, "private_registry_readiness", "aggregate", true),
+  eventCatalogEntry("private_registry.intent_clicked", REGISTRY_WEB_ONLY, "private_registry_readiness", "aggregate", true),
+  eventCatalogEntry("registry_web.api_key_page_viewed", REGISTRY_WEB_ONLY, "commercial_intent", "public_metadata", true),
+  eventCatalogEntry("registry_web.billing_viewed", REGISTRY_WEB_ONLY, "commercial_intent", "public_metadata", true),
+  eventCatalogEntry("registry_web.content_opened", REGISTRY_WEB_ONLY, "registry_discovery", "public_metadata", true),
+  eventCatalogEntry("registry_web.identity_linked", REGISTRY_WEB_ONLY, "identity_hygiene", "opaque_identity", true),
+  eventCatalogEntry("registry_web.organization_viewed", REGISTRY_WEB_ONLY, "commercial_intent", "aggregate", true),
+  eventCatalogEntry("registry_web.page_viewed", REGISTRY_WEB_ONLY, "registry_discovery", "public_metadata", true),
+  eventCatalogEntry("registry_web.search_performed", REGISTRY_WEB_ONLY, "registry_discovery", "aggregate", true),
+  eventCatalogEntry("registry_web.signup_clicked", REGISTRY_WEB_ONLY, "activation", "public_metadata", true),
+  eventCatalogEntry("registry.item.resolved", REGISTRY_RESOLUTION_SOURCES, "registry_discovery", "aggregate", true),
+  eventCatalogEntry("registry.sync.completed", CLI_ONLY, "cli_adoption", "aggregate", true),
+  eventCatalogEntry("studio.health_refreshed", CLI_ONLY, "project_health", "aggregate", true),
+  eventCatalogEntry("studio.started", CLI_ONLY, "project_health", "aggregate", true),
+  eventCatalogEntry("telemetry.identity_linked", API_ONLY, "identity_hygiene", "opaque_identity", false),
+  eventCatalogEntry("user.signup.completed", API_ONLY, "activation", "aggregate", false)
+];
+var TELEMETRY_EVENT_CATALOG_BY_NAME = new Map(
+  DECANTR_TELEMETRY_EVENT_CATALOG.map((entry) => [entry.name, entry])
+);
+function isDecantrTelemetrySchemaVersion(value) {
+  return typeof value === "string" && DECANTR_TELEMETRY_ACCEPTED_SCHEMA_VERSIONS.includes(value);
+}
 function isDecantrTelemetryEventName(value) {
   return DECANTR_TELEMETRY_EVENT_NAMES.includes(value);
 }
+function getTelemetryEventCatalogEntry(name) {
+  return TELEMETRY_EVENT_CATALOG_BY_NAME.get(name);
+}
+function isTelemetryEventAllowedForSource(name, source) {
+  return getTelemetryEventCatalogEntry(name).allowedSources.includes(source);
+}
+function eventCatalogEntry(name, allowedSources, bucket, privacy, publicIngest) {
+  return {
+    name,
+    allowedSources,
+    bucket,
+    privacy,
+    publicIngest,
+    privacyNotes: privacy === "aggregate" ? "Aggregate product metadata only; no source, prompts, raw paths, emails, or secrets." : privacy === "opaque_identity" ? "Opaque Decantr identity ids only; no emails, source, prompts, raw paths, or secrets." : "Public product or acquisition metadata only; no raw referrer URLs, user agents, emails, or click ids."
+  };
+}
 
 // src/privacy.ts
 var REDACTED_VALUE = "[redacted]";
@@ -304,7 +386,9 @@ function toPostHogProperties(event, options) {
   };
 }
 export {
+  DECANTR_TELEMETRY_ACCEPTED_SCHEMA_VERSIONS,
   DECANTR_TELEMETRY_ACTOR_TYPES,
+  DECANTR_TELEMETRY_EVENT_CATALOG,
   DECANTR_TELEMETRY_EVENT_NAMES,
   DECANTR_TELEMETRY_SCHEMA_VERSION,
   REDACTED_VALUE,
@@ -312,9 +396,12 @@ export {
   createNoopTelemetrySink,
   createPostHogTelemetrySink,
   createTelemetryClient,
+  getTelemetryEventCatalogEntry,
   isDecantrTelemetryEventName,
+  isDecantrTelemetrySchemaVersion,
   isSensitiveTelemetryKey,
   isTelemetryActorType,
+  isTelemetryEventAllowedForSource,
   resolveTelemetryActorType,
   sanitizeTelemetryEvent,
   sanitizeTelemetryValue

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/events.ts","../src/privacy.ts","../src/client.ts","../src/posthog.ts"],"sourcesContent":["export const DECANTR_TELEMETRY_SCHEMA_VERSION = '0.2.0';\n\nexport type TelemetrySource =\n  | 'api'\n  | 'cli'\n  | 'content-ci'\n  | 'marketing-web'\n  | 'mcp'\n  | 'registry-web';\nexport type TelemetryEnvironment = 'development' | 'preview' | 'production' | 'test';\nexport const DECANTR_TELEMETRY_ACTOR_TYPES = [\n  'anonymous',\n  'customer',\n  'internal',\n  'official_pipeline',\n  'service',\n] as const;\nexport type TelemetryActorType = (typeof DECANTR_TELEMETRY_ACTOR_TYPES)[number];\nexport type RegistrySource = 'cache' | 'custom' | 'none' | 'official' | 'private';\nexport type WorkflowMode =\n  | 'brownfield-attach'\n  | 'greenfield-contract-only'\n  | 'greenfield-scaffold'\n  | 'hybrid-compose';\nexport type AdoptionMode = 'contract-only' | 'decantr-css' | 'style-bridge';\nexport type ProjectScope = 'single-app' | 'workspace-app';\nexport type TelemetryContentType = 'archetype' | 'blueprint' | 'pattern' | 'shell' | 'theme';\nexport type TelemetryVisibility = 'private' | 'public' | 'team';\nexport type TelemetryAnalysisScope = 'hosted' | 'local';\nexport type ProjectHealthTelemetryStatus = 'error' | 'healthy' | 'warning';\nexport type ProjectHealthFindingSeverity = 'error' | 'info' | 'warn';\nexport type ProjectHealthFindingSource =\n  | 'audit'\n  | 'brownfield'\n  | 'check'\n  | 'interaction'\n  | 'pack'\n  | 'runtime';\nexport type ProjectHealthOutputFormat = 'json' | 'markdown' | 'text';\nexport type ProjectHealthFailOn = 'error' | 'none' | 'warn';\n\nexport const DECANTR_TELEMETRY_EVENT_NAMES = [\n  'api_key.created',\n  'audit.completed',\n  'cli.command.completed',\n  'content.publish.completed',\n  'content.validation.completed',\n  'critique.completed',\n  'decantr.check.completed',\n  'decantr.health.healthy',\n  'decantr.init.completed',\n  'decantr.new.completed',\n  'decantr.refresh.completed',\n  'execution_pack.compiled',\n  'execution_pack.selected',\n  'health.ci.failed',\n  'health.finding.prompt_requested',\n  'health.report.generated',\n  'marketing_web.command_clicked',\n  'marketing_web.cta_clicked',\n  'marketing_web.outbound_clicked',\n  'marketing_web.page_viewed',\n  'org.created',\n  'registry_web.api_key_page_viewed',\n  'registry_web.billing_viewed',\n  'registry_web.content_opened',\n  'registry_web.identity_linked',\n  'registry_web.organization_viewed',\n  'registry_web.page_viewed',\n  'registry_web.search_performed',\n  'registry_web.signup_clicked',\n  'registry.item.resolved',\n  'registry.sync.completed',\n  'studio.health_refreshed',\n  'studio.started',\n  'user.signup.completed',\n] as const;\n\nexport type DecantrTelemetryEventName = (typeof DECANTR_TELEMETRY_EVENT_NAMES)[number];\n\nexport type TelemetryPropertyValue =\n  | TelemetryPropertyValue[]\n  | boolean\n  | null\n  | number\n  | string\n  | undefined\n  | { [key: string]: TelemetryPropertyValue };\n\nexport type TelemetryProperties = Record<string, TelemetryPropertyValue>;\n\nexport interface TelemetryContext {\n  source: TelemetrySource;\n  actorType?: TelemetryActorType;\n  environment?: TelemetryEnvironment;\n  serviceName?: string;\n  serviceVersion?: string;\n  decantrVersion?: string;\n  registrySource?: RegistrySource;\n  anonymousId?: string;\n  installId?: string;\n  projectId?: string;\n  sessionId?: string;\n  userId?: string;\n  orgId?: string;\n}\n\nexport interface TelemetryActorResolutionOptions {\n  internalAnonymousIds?: readonly string[] | ReadonlySet<string>;\n  internalInstallIds?: readonly string[] | ReadonlySet<string>;\n  internalOrgIds?: readonly string[] | ReadonlySet<string>;\n  internalProjectIds?: readonly string[] | ReadonlySet<string>;\n  internalUserIds?: readonly string[] | ReadonlySet<string>;\n}\n\nexport function isTelemetryActorType(value: unknown): value is TelemetryActorType {\n  return (\n    typeof value === 'string' &&\n    (DECANTR_TELEMETRY_ACTOR_TYPES as readonly string[]).includes(value)\n  );\n}\n\nexport function resolveTelemetryActorType(\n  context: TelemetryContext,\n  options: TelemetryActorResolutionOptions = {},\n): TelemetryActorType {\n  if (context.actorType) return context.actorType;\n\n  if (context.source === 'content-ci') {\n    return 'official_pipeline';\n  }\n\n  if (matchesInternalActor(context, options)) {\n    return 'internal';\n  }\n\n  if (context.userId || context.orgId || context.projectId || context.installId) {\n    return 'customer';\n  }\n\n  if (context.anonymousId) {\n    return 'anonymous';\n  }\n\n  return 'service';\n}\n\nfunction matchesInternalActor(\n  context: TelemetryContext,\n  options: TelemetryActorResolutionOptions,\n): boolean {\n  return (\n    idListHas(options.internalAnonymousIds, context.anonymousId) ||\n    idListHas(options.internalInstallIds, context.installId) ||\n    idListHas(options.internalOrgIds, context.orgId) ||\n    idListHas(options.internalProjectIds, context.projectId) ||\n    idListHas(options.internalUserIds, context.userId)\n  );\n}\n\nfunction idListHas(\n  values: readonly string[] | ReadonlySet<string> | undefined,\n  value: string | undefined,\n): boolean {\n  if (!values || !value) return false;\n  if (typeof (values as ReadonlySet<string>).has === 'function') {\n    return (values as ReadonlySet<string>).has(value);\n  }\n  return (values as readonly string[]).includes(value);\n}\n\nexport interface TelemetryEventBase<\n  Name extends DecantrTelemetryEventName = DecantrTelemetryEventName,\n  Properties extends TelemetryProperties = TelemetryProperties,\n> {\n  name: Name;\n  context: TelemetryContext;\n  properties: Properties;\n  timestamp?: Date | string;\n}\n\nexport interface CliCommandCompletedProperties extends TelemetryProperties {\n  command: string;\n  success: boolean;\n  durationMs: number;\n  adoptionMode?: AdoptionMode;\n  errorCode?: string;\n  offline?: boolean;\n  projectScope?: ProjectScope;\n  registrySource?: RegistrySource;\n  targetFramework?: string;\n  workflowMode?: WorkflowMode;\n}\n\nexport interface DecantrLifecycleCompletedProperties extends TelemetryProperties {\n  command: 'check' | 'init' | 'new' | 'refresh';\n  success: boolean;\n  durationMs: number;\n  adoptionMode?: AdoptionMode;\n  errorCode?: string;\n  offline?: boolean;\n  projectScope?: ProjectScope;\n  registrySource?: RegistrySource;\n  targetFramework?: string;\n  workflowMode?: WorkflowMode;\n}\n\nexport interface ProjectHealthTelemetryProperties extends TelemetryProperties {\n  success: boolean;\n  status: ProjectHealthTelemetryStatus;\n  score: number;\n  durationMs?: number;\n  adoptionMode?: AdoptionMode;\n  ci?: boolean;\n  errorCode?: string;\n  errorCount: number;\n  failOn?: ProjectHealthFailOn;\n  findingCount: number;\n  format?: ProjectHealthOutputFormat;\n  infoCount: number;\n  outputWritten?: boolean;\n  packManifestPresent?: boolean;\n  pageCount?: number;\n  projectScope?: ProjectScope;\n  reviewPackPresent?: boolean;\n  routeCount?: number;\n  runtimeAuditChecked?: boolean;\n  runtimeMatchedCount?: number;\n  runtimePassed?: boolean | null;\n  runtimeRouteCheckedCount?: number;\n  warnCount: number;\n  workflowMode?: WorkflowMode;\n}\n\nexport interface HealthFindingPromptRequestedProperties extends TelemetryProperties {\n  success: boolean;\n  findingFound: boolean;\n  adoptionMode?: AdoptionMode;\n  ci?: boolean;\n  findingSeverity?: ProjectHealthFindingSeverity;\n  findingSource?: ProjectHealthFindingSource;\n  projectScope?: ProjectScope;\n  workflowMode?: WorkflowMode;\n}\n\nexport interface HealthCiFailedProperties extends ProjectHealthTelemetryProperties {\n  failOn: 'error' | 'warn';\n}\n\nexport interface StudioStartedProperties extends TelemetryProperties {\n  success: boolean;\n  hostMode: 'custom' | 'loopback';\n  port: number;\n  adoptionMode?: AdoptionMode;\n  errorCode?: string;\n  projectScope?: ProjectScope;\n  workflowMode?: WorkflowMode;\n}\n\nexport interface StudioHealthRefreshedProperties extends ProjectHealthTelemetryProperties {\n  trigger: 'api-refresh';\n}\n\nexport interface RegistryItemResolvedProperties extends TelemetryProperties {\n  contentType: TelemetryContentType;\n  success: boolean;\n  cacheHit?: boolean;\n  durationMs?: number;\n  errorCode?: string;\n  itemId?: string;\n  namespace?: string;\n  registrySource?: RegistrySource;\n  version?: string;\n  visibility?: TelemetryVisibility;\n}\n\nexport interface RegistrySyncCompletedProperties extends TelemetryProperties {\n  success: boolean;\n  durationMs: number;\n  errorCode?: string;\n  registrySource?: RegistrySource;\n  totalItems?: number;\n}\n\nexport interface ExecutionPackCompiledProperties extends TelemetryProperties {\n  success: boolean;\n  durationMs: number;\n  errorCode?: string;\n  pageCount?: number;\n  patternCount?: number;\n  sectionCount?: number;\n  targetFramework?: string;\n}\n\nexport interface ExecutionPackSelectedProperties extends TelemetryProperties {\n  packType: 'mutation' | 'page' | 'review' | 'scaffold' | 'section';\n  success: boolean;\n  durationMs?: number;\n  errorCode?: string;\n  id?: string;\n}\n\nexport interface AuditCompletedProperties extends TelemetryProperties {\n  scope: TelemetryAnalysisScope;\n  success: boolean;\n  durationMs: number;\n  errorCode?: string;\n  errorCount?: number;\n  pageCount?: number;\n  runtimePassed?: boolean;\n  score?: number;\n  warnCount?: number;\n}\n\nexport interface CritiqueCompletedProperties extends TelemetryProperties {\n  scope: TelemetryAnalysisScope;\n  success: boolean;\n  durationMs: number;\n  errorCode?: string;\n  errorCount?: number;\n  infoCount?: number;\n  overall?: number;\n  warnCount?: number;\n}\n\nexport interface ContentValidationCompletedProperties extends TelemetryProperties {\n  valid: boolean;\n  contentType?: TelemetryContentType;\n  durationMs?: number;\n  errorCount?: number;\n  itemCount?: number;\n  warningCount?: number;\n}\n\nexport interface ContentPublishCompletedProperties extends TelemetryProperties {\n  contentType: TelemetryContentType;\n  success: boolean;\n  durationMs: number;\n  errorCode?: string;\n  namespace?: string;\n  visibility?: TelemetryVisibility;\n}\n\nexport interface ProductEventProperties extends TelemetryProperties {\n  success?: boolean;\n  channel?: string;\n  entrypoint?: string;\n  plan?: string;\n}\n\nexport interface CampaignAttributionProperties extends TelemetryProperties {\n  attributionClickIdProvider?: string | null;\n  attributionClickIdPresent?: boolean;\n  attributionFirstLandingPath?: string | null;\n  attributionFirstReferrerDomain?: string | null;\n  attributionFirstUtmCampaign?: string | null;\n  attributionFirstUtmContent?: string | null;\n  attributionFirstUtmId?: string | null;\n  attributionFirstUtmMedium?: string | null;\n  attributionFirstUtmSource?: string | null;\n  attributionFirstUtmTerm?: string | null;\n  attributionLandingPath?: string | null;\n  attributionLastLandingPath?: string | null;\n  attributionLastReferrerDomain?: string | null;\n  attributionLastUtmCampaign?: string | null;\n  attributionLastUtmContent?: string | null;\n  attributionLastUtmId?: string | null;\n  attributionLastUtmMedium?: string | null;\n  attributionLastUtmSource?: string | null;\n  attributionLastUtmTerm?: string | null;\n  attributionReferrerDomain?: string | null;\n  attributionUtmCampaign?: string | null;\n  attributionUtmContent?: string | null;\n  attributionUtmId?: string | null;\n  attributionUtmMedium?: string | null;\n  attributionUtmSource?: string | null;\n  attributionUtmTerm?: string | null;\n}\n\nexport interface MarketingWebPageViewedProperties extends CampaignAttributionProperties {\n  routePath: string;\n  surface: string;\n}\n\nexport interface MarketingWebCtaClickedProperties extends CampaignAttributionProperties {\n  destination: string;\n  label?: string | null;\n  surface: string;\n}\n\nexport interface MarketingWebOutboundClickedProperties extends CampaignAttributionProperties {\n  destination: string;\n  label?: string | null;\n  surface: string;\n}\n\nexport interface MarketingWebCommandClickedProperties extends CampaignAttributionProperties {\n  commandKind: 'cli' | 'mcp' | 'other';\n  commandLabel?: string | null;\n  surface: string;\n}\n\nexport interface RegistryWebPageViewedProperties extends CampaignAttributionProperties {\n  authenticated: boolean;\n  orgScoped?: boolean;\n  plan?: string;\n  queryPresent?: boolean;\n  route: string;\n  routePath: string;\n  surface: string;\n}\n\nexport interface RegistryWebSearchPerformedProperties extends CampaignAttributionProperties {\n  contentType?: string;\n  queryLength: number;\n  resultCount?: number;\n  sort?: string;\n  sourceFilter?: string;\n  surface: string;\n}\n\nexport interface RegistryWebContentOpenedProperties extends CampaignAttributionProperties {\n  contentSource?: string;\n  contentType: string;\n  namespace?: string;\n  slug?: string;\n  surface: string;\n}\n\nexport interface RegistryWebCommercialPageViewedProperties extends CampaignAttributionProperties {\n  orgScoped?: boolean;\n  plan?: string;\n  surface: string;\n}\n\nexport type DecantrTelemetryEvent =\n  | TelemetryEventBase<'api_key.created', ProductEventProperties>\n  | TelemetryEventBase<'audit.completed', AuditCompletedProperties>\n  | TelemetryEventBase<'cli.command.completed', CliCommandCompletedProperties>\n  | TelemetryEventBase<'content.publish.completed', ContentPublishCompletedProperties>\n  | TelemetryEventBase<'content.validation.completed', ContentValidationCompletedProperties>\n  | TelemetryEventBase<'critique.completed', CritiqueCompletedProperties>\n  | TelemetryEventBase<'decantr.check.completed', DecantrLifecycleCompletedProperties>\n  | TelemetryEventBase<'decantr.health.healthy', ProjectHealthTelemetryProperties>\n  | TelemetryEventBase<'decantr.init.completed', DecantrLifecycleCompletedProperties>\n  | TelemetryEventBase<'decantr.new.completed', DecantrLifecycleCompletedProperties>\n  | TelemetryEventBase<'decantr.refresh.completed', DecantrLifecycleCompletedProperties>\n  | TelemetryEventBase<'execution_pack.compiled', ExecutionPackCompiledProperties>\n  | TelemetryEventBase<'execution_pack.selected', ExecutionPackSelectedProperties>\n  | TelemetryEventBase<'health.ci.failed', HealthCiFailedProperties>\n  | TelemetryEventBase<'health.finding.prompt_requested', HealthFindingPromptRequestedProperties>\n  | TelemetryEventBase<'health.report.generated', ProjectHealthTelemetryProperties>\n  | TelemetryEventBase<'marketing_web.command_clicked', MarketingWebCommandClickedProperties>\n  | TelemetryEventBase<'marketing_web.cta_clicked', MarketingWebCtaClickedProperties>\n  | TelemetryEventBase<'marketing_web.outbound_clicked', MarketingWebOutboundClickedProperties>\n  | TelemetryEventBase<'marketing_web.page_viewed', MarketingWebPageViewedProperties>\n  | TelemetryEventBase<'org.created', ProductEventProperties>\n  | TelemetryEventBase<'registry_web.api_key_page_viewed', RegistryWebCommercialPageViewedProperties>\n  | TelemetryEventBase<'registry_web.billing_viewed', RegistryWebCommercialPageViewedProperties>\n  | TelemetryEventBase<'registry_web.content_opened', RegistryWebContentOpenedProperties>\n  | TelemetryEventBase<'registry_web.identity_linked', RegistryWebCommercialPageViewedProperties>\n  | TelemetryEventBase<'registry_web.organization_viewed', RegistryWebCommercialPageViewedProperties>\n  | TelemetryEventBase<'registry_web.page_viewed', RegistryWebPageViewedProperties>\n  | TelemetryEventBase<'registry_web.search_performed', RegistryWebSearchPerformedProperties>\n  | TelemetryEventBase<'registry_web.signup_clicked', RegistryWebCommercialPageViewedProperties>\n  | TelemetryEventBase<'registry.item.resolved', RegistryItemResolvedProperties>\n  | TelemetryEventBase<'registry.sync.completed', RegistrySyncCompletedProperties>\n  | TelemetryEventBase<'studio.health_refreshed', StudioHealthRefreshedProperties>\n  | TelemetryEventBase<'studio.started', StudioStartedProperties>\n  | TelemetryEventBase<'user.signup.completed', ProductEventProperties>;\n\nexport function isDecantrTelemetryEventName(value: string): value is DecantrTelemetryEventName {\n  return (DECANTR_TELEMETRY_EVENT_NAMES as readonly string[]).includes(value);\n}\n","import type { DecantrTelemetryEvent, TelemetryPropertyValue } from './events.js';\n\nexport const REDACTED_VALUE = '[redacted]';\n\nconst DEFAULT_MAX_STRING_LENGTH = 240;\nconst DEFAULT_MAX_ARRAY_LENGTH = 25;\nconst DEFAULT_MAX_OBJECT_KEYS = 80;\nconst DEFAULT_MAX_DEPTH = 4;\n\nconst SENSITIVE_KEY_PATTERNS = [\n  /^api[_-]?key$/i,\n  /^authorization$/i,\n  /^code$/i,\n  /^content$/i,\n  /^contents$/i,\n  /^cookie$/i,\n  /^cwd$/i,\n  /^email$/i,\n  /^env$/i,\n  /^file[_-]?contents$/i,\n  /^file[_-]?path$/i,\n  /^home$/i,\n  /^ip[_-]?address$/i,\n  /^password$/i,\n  /^path$/i,\n  /^prompt$/i,\n  /^raw[_-]?prompt$/i,\n  /^secret$/i,\n  /^source$/i,\n  /^source[_-]?code$/i,\n  /^token$/i,\n  /^url$/i,\n  /^user[_-]?agent$/i,\n];\n\nexport interface TelemetryRedactionOptions {\n  maxArrayLength?: number;\n  maxDepth?: number;\n  maxObjectKeys?: number;\n  maxStringLength?: number;\n  redactedValue?: string;\n  sensitiveKeyPatterns?: RegExp[];\n}\n\nexport function isSensitiveTelemetryKey(key: string, patterns = SENSITIVE_KEY_PATTERNS): boolean {\n  return patterns.some((pattern) => pattern.test(key));\n}\n\nexport function sanitizeTelemetryValue(\n  value: TelemetryPropertyValue,\n  options: TelemetryRedactionOptions = {},\n  depth = 0,\n): TelemetryPropertyValue {\n  const maxDepth = options.maxDepth ?? DEFAULT_MAX_DEPTH;\n  if (depth > maxDepth) {\n    return options.redactedValue ?? REDACTED_VALUE;\n  }\n\n  if (typeof value === 'string') {\n    const maxStringLength = options.maxStringLength ?? DEFAULT_MAX_STRING_LENGTH;\n    return value.length > maxStringLength ? `${value.slice(0, maxStringLength)}...` : value;\n  }\n\n  if (typeof value === 'number' || typeof value === 'boolean' || value === null) {\n    return value;\n  }\n\n  if (value === undefined) {\n    return null;\n  }\n\n  if (Array.isArray(value)) {\n    const maxArrayLength = options.maxArrayLength ?? DEFAULT_MAX_ARRAY_LENGTH;\n    return value\n      .slice(0, maxArrayLength)\n      .map((entry) => sanitizeTelemetryValue(entry, options, depth + 1));\n  }\n\n  const redactedValue = options.redactedValue ?? REDACTED_VALUE;\n  const sensitiveKeyPatterns = options.sensitiveKeyPatterns ?? SENSITIVE_KEY_PATTERNS;\n  const maxObjectKeys = options.maxObjectKeys ?? DEFAULT_MAX_OBJECT_KEYS;\n  const entries = Object.entries(value).slice(0, maxObjectKeys);\n  const sanitized: Record<string, TelemetryPropertyValue> = {};\n\n  for (const [key, entryValue] of entries) {\n    sanitized[key] = isSensitiveTelemetryKey(key, sensitiveKeyPatterns)\n      ? redactedValue\n      : sanitizeTelemetryValue(entryValue, options, depth + 1);\n  }\n\n  return sanitized;\n}\n\nexport function sanitizeTelemetryEvent(\n  event: DecantrTelemetryEvent,\n  options: TelemetryRedactionOptions = {},\n): DecantrTelemetryEvent {\n  return {\n    ...event,\n    properties: sanitizeTelemetryValue(\n      event.properties,\n      options,\n    ) as DecantrTelemetryEvent['properties'],\n  } as DecantrTelemetryEvent;\n}\n","import {\n  DECANTR_TELEMETRY_SCHEMA_VERSION,\n  type DecantrTelemetryEvent,\n  type TelemetryContext,\n} from './events.js';\nimport { sanitizeTelemetryEvent, type TelemetryRedactionOptions } from './privacy.js';\n\nexport interface TelemetrySink {\n  capture(event: DecantrTelemetryEvent): Promise<void> | void;\n  flush?(): Promise<void> | void;\n}\n\nexport interface TelemetryClient {\n  capture(event: DecantrTelemetryEvent): Promise<void>;\n  flush(): Promise<void>;\n}\n\nexport interface TelemetryClientOptions {\n  context?: Partial<TelemetryContext>;\n  enabled?: boolean;\n  onError?: (error: unknown, event: DecantrTelemetryEvent) => void;\n  redaction?: TelemetryRedactionOptions;\n  sink?: TelemetrySink;\n}\n\nexport interface FetchTelemetrySinkOptions {\n  endpoint: string;\n  fetch?: typeof fetch;\n  headers?: HeadersInit | (() => HeadersInit);\n  timeoutMs?: number;\n}\n\nexport function createNoopTelemetrySink(): TelemetrySink {\n  return {\n    capture() {\n      return undefined;\n    },\n  };\n}\n\nexport function createTelemetryClient(options: TelemetryClientOptions = {}): TelemetryClient {\n  const enabled = options.enabled ?? true;\n  const sink = options.sink ?? createNoopTelemetrySink();\n  const pending = new Set<Promise<void>>();\n\n  async function capture(event: DecantrTelemetryEvent): Promise<void> {\n    if (!enabled) return;\n\n    const enriched = sanitizeTelemetryEvent(\n      {\n        ...event,\n        context: {\n          ...options.context,\n          ...event.context,\n        },\n        timestamp: normalizeTimestamp(event.timestamp),\n      } as DecantrTelemetryEvent,\n      options.redaction,\n    );\n\n    const promise = Promise.resolve()\n      .then(() => sink.capture(enriched))\n      .catch((error) => {\n        options.onError?.(error, enriched);\n      })\n      .then(() => undefined);\n\n    pending.add(promise);\n    promise.finally(() => pending.delete(promise));\n    await promise;\n  }\n\n  async function flush(): Promise<void> {\n    await Promise.allSettled([...pending]);\n    await sink.flush?.();\n  }\n\n  return { capture, flush };\n}\n\nexport function createFetchTelemetrySink(options: FetchTelemetrySinkOptions): TelemetrySink {\n  const fetchImpl = options.fetch ?? globalThis.fetch;\n\n  return {\n    async capture(event) {\n      const controller = new AbortController();\n      const timeout = setTimeout(() => controller.abort(), options.timeoutMs ?? 3000);\n\n      try {\n        const response = await fetchImpl(options.endpoint, {\n          method: 'POST',\n          headers: {\n            'Content-Type': 'application/json',\n            ...normalizeHeaders(\n              typeof options.headers === 'function' ? options.headers() : options.headers,\n            ),\n          },\n          body: JSON.stringify({\n            schemaVersion: DECANTR_TELEMETRY_SCHEMA_VERSION,\n            event,\n          }),\n          signal: controller.signal,\n        });\n\n        if (!response.ok) {\n          throw new Error(`Telemetry endpoint returned HTTP ${response.status}.`);\n        }\n      } finally {\n        clearTimeout(timeout);\n      }\n    },\n  };\n}\n\nfunction normalizeTimestamp(timestamp: Date | string | undefined): string {\n  if (timestamp instanceof Date) {\n    return timestamp.toISOString();\n  }\n  return timestamp ?? new Date().toISOString();\n}\n\nfunction normalizeHeaders(headers: HeadersInit | undefined): Record<string, string> {\n  if (!headers) return {};\n\n  if (headers instanceof Headers) {\n    return Object.fromEntries(headers.entries());\n  }\n\n  if (Array.isArray(headers)) {\n    return Object.fromEntries(headers);\n  }\n\n  return headers as Record<string, string>;\n}\n","import type { TelemetrySink } from './client.js';\nimport {\n  DECANTR_TELEMETRY_SCHEMA_VERSION,\n  resolveTelemetryActorType,\n  type DecantrTelemetryEvent,\n  type TelemetryProperties,\n} from './events.js';\n\nexport interface PostHogTelemetrySinkOptions {\n  apiKey: string;\n  fetch?: typeof fetch;\n  host?: string;\n  processPersonProfile?: boolean;\n  timeoutMs?: number;\n}\n\nexport function createPostHogTelemetrySink(options: PostHogTelemetrySinkOptions): TelemetrySink {\n  const host = trimTrailingSlashes(options.host ?? 'https://us.i.posthog.com');\n  const fetchImpl = options.fetch ?? globalThis.fetch;\n\n  return {\n    async capture(event) {\n      const distinctId = resolveDistinctId(event);\n      if (!distinctId) {\n        throw new Error(\n          'PostHog telemetry requires an opaque user, install, project, or anonymous id.',\n        );\n      }\n\n      const controller = new AbortController();\n      const timeout = setTimeout(() => controller.abort(), options.timeoutMs ?? 3000);\n\n      try {\n        const response = await fetchImpl(`${host}/i/v0/e/`, {\n          method: 'POST',\n          headers: { 'Content-Type': 'application/json' },\n          body: JSON.stringify({\n            api_key: options.apiKey,\n            event: event.name,\n            distinct_id: distinctId,\n            properties: toPostHogProperties(event, options),\n            timestamp: event.timestamp,\n          }),\n          signal: controller.signal,\n        });\n\n        if (!response.ok) {\n          throw new Error(`PostHog capture returned HTTP ${response.status}.`);\n        }\n      } finally {\n        clearTimeout(timeout);\n      }\n    },\n  };\n}\n\nfunction trimTrailingSlashes(value: string): string {\n  let end = value.length;\n  while (end > 0 && value.charCodeAt(end - 1) === 47) {\n    end -= 1;\n  }\n  return value.slice(0, end);\n}\n\nfunction resolveDistinctId(event: DecantrTelemetryEvent): string | undefined {\n  return (\n    event.context.userId ??\n    event.context.installId ??\n    event.context.projectId ??\n    event.context.anonymousId\n  );\n}\n\nfunction toPostHogProperties(\n  event: DecantrTelemetryEvent,\n  options: PostHogTelemetrySinkOptions,\n): TelemetryProperties {\n  const groups: Record<string, string> = {};\n  if (event.context.orgId) groups.organization = event.context.orgId;\n  if (event.context.projectId) groups.project = event.context.projectId;\n\n  return {\n    ...event.properties,\n    $groups: groups,\n    $process_person_profile: options.processPersonProfile ?? false,\n    decantr_anonymous_id: event.context.anonymousId ?? null,\n    decantr_actor_type: resolveTelemetryActorType(event.context),\n    decantr_install_id: event.context.installId ?? null,\n    decantr_org_id: event.context.orgId ?? null,\n    decantr_project_id: event.context.projectId ?? null,\n    decantr_session_id: event.context.sessionId ?? null,\n    decantr_schema_version: DECANTR_TELEMETRY_SCHEMA_VERSION,\n    decantr_source: event.context.source,\n    decantr_environment: event.context.environment ?? 'production',\n    decantr_version: event.context.decantrVersion ?? null,\n    registry_source: event.context.registrySource ?? null,\n    service_name: event.context.serviceName ?? null,\n    service_version: event.context.serviceVersion ?? null,\n  };\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/events.ts","../src/privacy.ts","../src/client.ts","../src/posthog.ts"],"sourcesContent":["export const DECANTR_TELEMETRY_SCHEMA_VERSION = '0.3.0';\nexport const DECANTR_TELEMETRY_ACCEPTED_SCHEMA_VERSIONS = [\n  '0.2.0',\n  DECANTR_TELEMETRY_SCHEMA_VERSION,\n] as const;\n\nexport type TelemetrySource =\n  | 'api'\n  | 'cli'\n  | 'content-ci'\n  | 'marketing-web'\n  | 'mcp'\n  | 'registry-web';\nexport type TelemetryEnvironment = 'development' | 'preview' | 'production' | 'test';\nexport const DECANTR_TELEMETRY_ACTOR_TYPES = [\n  'anonymous',\n  'customer',\n  'internal',\n  'official_pipeline',\n  'service',\n] as const;\nexport type TelemetryActorType = (typeof DECANTR_TELEMETRY_ACTOR_TYPES)[number];\nexport type RegistrySource = 'cache' | 'custom' | 'none' | 'official' | 'private';\nexport type WorkflowMode =\n  | 'brownfield-attach'\n  | 'greenfield-contract-only'\n  | 'greenfield-scaffold'\n  | 'hybrid-compose';\nexport type AdoptionMode = 'contract-only' | 'decantr-css' | 'style-bridge';\nexport type ProjectScope = 'single-app' | 'workspace-app';\nexport type TelemetryContentType = 'archetype' | 'blueprint' | 'pattern' | 'shell' | 'theme';\nexport type TelemetryVisibility = 'private' | 'public' | 'team';\nexport type TelemetryAnalysisScope = 'hosted' | 'local';\nexport type ProjectHealthTelemetryStatus = 'error' | 'healthy' | 'warning';\nexport type ProjectHealthFindingSeverity = 'error' | 'info' | 'warn';\nexport type ProjectHealthFindingSource =\n  | 'audit'\n  | 'brownfield'\n  | 'check'\n  | 'interaction'\n  | 'pack'\n  | 'runtime';\nexport type ProjectHealthOutputFormat = 'json' | 'markdown' | 'text';\nexport type ProjectHealthFailOn = 'error' | 'none' | 'warn';\nexport type TelemetrySignalBucket =\n  | 'activation'\n  | 'billing_intent'\n  | 'cli_adoption'\n  | 'commercial_intent'\n  | 'content_pipeline'\n  | 'hosted_intelligence'\n  | 'identity_hygiene'\n  | 'paid_acquisition'\n  | 'private_registry_readiness'\n  | 'product_activation'\n  | 'project_health'\n  | 'registry_discovery';\nexport type TelemetryPrivacyClass = 'aggregate' | 'opaque_identity' | 'public_metadata';\n\nexport const DECANTR_TELEMETRY_EVENT_NAMES = [\n  'api_key.created',\n  'audit.completed',\n  'cli.command.completed',\n  'content.publish.completed',\n  'content.validation.completed',\n  'critique.completed',\n  'decantr.analyze.completed',\n  'decantr.check.completed',\n  'decantr.health.healthy',\n  'decantr.init.completed',\n  'decantr.new.completed',\n  'decantr.refresh.completed',\n  'execution_pack.compiled',\n  'execution_pack.selected',\n  'health.ci.failed',\n  'health.finding.prompt_requested',\n  'health.report.generated',\n  'marketing_web.command_clicked',\n  'marketing_web.cta_clicked',\n  'marketing_web.outbound_clicked',\n  'marketing_web.page_viewed',\n  'org.created',\n  'billing.checkout_blocked',\n  'billing.plan_clicked',\n  'private_registry.content_listed',\n  'private_registry.gate_viewed',\n  'private_registry.intent_clicked',\n  'registry_web.api_key_page_viewed',\n  'registry_web.billing_viewed',\n  'registry_web.content_opened',\n  'registry_web.identity_linked',\n  'registry_web.organization_viewed',\n  'registry_web.page_viewed',\n  'registry_web.search_performed',\n  'registry_web.signup_clicked',\n  'registry.item.resolved',\n  'registry.sync.completed',\n  'studio.health_refreshed',\n  'studio.started',\n  'telemetry.identity_linked',\n  'user.signup.completed',\n] as const;\n\nexport type DecantrTelemetryEventName = (typeof DECANTR_TELEMETRY_EVENT_NAMES)[number];\n\nexport type TelemetryPropertyValue =\n  | TelemetryPropertyValue[]\n  | boolean\n  | null\n  | number\n  | string\n  | undefined\n  | { [key: string]: TelemetryPropertyValue };\n\nexport type TelemetryProperties = Record<string, TelemetryPropertyValue>;\n\nexport interface TelemetryContext {\n  source: TelemetrySource;\n  actorType?: TelemetryActorType;\n  environment?: TelemetryEnvironment;\n  serviceName?: string;\n  serviceVersion?: string;\n  decantrVersion?: string;\n  registrySource?: RegistrySource;\n  anonymousId?: string;\n  installId?: string;\n  projectId?: string;\n  sessionId?: string;\n  userId?: string;\n  orgId?: string;\n}\n\nexport interface TelemetryActorResolutionOptions {\n  internalAnonymousIds?: readonly string[] | ReadonlySet<string>;\n  internalInstallIds?: readonly string[] | ReadonlySet<string>;\n  internalOrgIds?: readonly string[] | ReadonlySet<string>;\n  internalProjectIds?: readonly string[] | ReadonlySet<string>;\n  internalUserIds?: readonly string[] | ReadonlySet<string>;\n}\n\nexport function isTelemetryActorType(value: unknown): value is TelemetryActorType {\n  return (\n    typeof value === 'string' &&\n    (DECANTR_TELEMETRY_ACTOR_TYPES as readonly string[]).includes(value)\n  );\n}\n\nexport function resolveTelemetryActorType(\n  context: TelemetryContext,\n  options: TelemetryActorResolutionOptions = {},\n): TelemetryActorType {\n  if (context.actorType) return context.actorType;\n\n  if (context.source === 'content-ci') {\n    return 'official_pipeline';\n  }\n\n  if (matchesInternalActor(context, options)) {\n    return 'internal';\n  }\n\n  if (context.userId || context.orgId || context.projectId || context.installId) {\n    return 'customer';\n  }\n\n  if (context.anonymousId) {\n    return 'anonymous';\n  }\n\n  return 'service';\n}\n\nfunction matchesInternalActor(\n  context: TelemetryContext,\n  options: TelemetryActorResolutionOptions,\n): boolean {\n  return (\n    idListHas(options.internalAnonymousIds, context.anonymousId) ||\n    idListHas(options.internalInstallIds, context.installId) ||\n    idListHas(options.internalOrgIds, context.orgId) ||\n    idListHas(options.internalProjectIds, context.projectId) ||\n    idListHas(options.internalUserIds, context.userId)\n  );\n}\n\nfunction idListHas(\n  values: readonly string[] | ReadonlySet<string> | undefined,\n  value: string | undefined,\n): boolean {\n  if (!values || !value) return false;\n  if (typeof (values as ReadonlySet<string>).has === 'function') {\n    return (values as ReadonlySet<string>).has(value);\n  }\n  return (values as readonly string[]).includes(value);\n}\n\nexport interface TelemetryEventBase<\n  Name extends DecantrTelemetryEventName = DecantrTelemetryEventName,\n  Properties extends TelemetryProperties = TelemetryProperties,\n> {\n  name: Name;\n  context: TelemetryContext;\n  properties: Properties;\n  timestamp?: Date | string;\n}\n\nexport interface CliCommandCompletedProperties extends TelemetryProperties {\n  command: string;\n  success: boolean;\n  durationMs: number;\n  adoptionMode?: AdoptionMode;\n  errorCode?: string;\n  offline?: boolean;\n  projectScope?: ProjectScope;\n  registrySource?: RegistrySource;\n  targetFramework?: string;\n  workflowMode?: WorkflowMode;\n}\n\nexport interface DecantrAnalyzeCompletedProperties extends TelemetryProperties {\n  command: 'analyze';\n  success: boolean;\n  durationMs?: number;\n  adoptionMode?: AdoptionMode;\n  componentCount?: number;\n  dependencyCategoryCount?: number;\n  errorCode?: string;\n  pageCount?: number;\n  projectScope?: ProjectScope;\n  routeCount?: number;\n  targetFramework?: string;\n  workflowMode?: WorkflowMode;\n}\n\nexport interface DecantrLifecycleCompletedProperties extends TelemetryProperties {\n  command: 'check' | 'init' | 'new' | 'refresh';\n  success: boolean;\n  durationMs: number;\n  adoptionMode?: AdoptionMode;\n  errorCode?: string;\n  offline?: boolean;\n  projectScope?: ProjectScope;\n  registrySource?: RegistrySource;\n  targetFramework?: string;\n  workflowMode?: WorkflowMode;\n}\n\nexport interface ProjectHealthTelemetryProperties extends TelemetryProperties {\n  success: boolean;\n  status: ProjectHealthTelemetryStatus;\n  score: number;\n  durationMs?: number;\n  adoptionMode?: AdoptionMode;\n  ci?: boolean;\n  errorCode?: string;\n  errorCount: number;\n  failOn?: ProjectHealthFailOn;\n  findingCount: number;\n  format?: ProjectHealthOutputFormat;\n  infoCount: number;\n  outputWritten?: boolean;\n  packManifestPresent?: boolean;\n  pageCount?: number;\n  projectScope?: ProjectScope;\n  reviewPackPresent?: boolean;\n  routeCount?: number;\n  runtimeAuditChecked?: boolean;\n  runtimeMatchedCount?: number;\n  runtimePassed?: boolean | null;\n  runtimeRouteCheckedCount?: number;\n  warnCount: number;\n  workflowMode?: WorkflowMode;\n}\n\nexport interface HealthFindingPromptRequestedProperties extends TelemetryProperties {\n  success: boolean;\n  findingFound: boolean;\n  adoptionMode?: AdoptionMode;\n  ci?: boolean;\n  findingSeverity?: ProjectHealthFindingSeverity;\n  findingSource?: ProjectHealthFindingSource;\n  projectScope?: ProjectScope;\n  workflowMode?: WorkflowMode;\n}\n\nexport interface HealthCiFailedProperties extends ProjectHealthTelemetryProperties {\n  failOn: 'error' | 'warn';\n}\n\nexport interface StudioStartedProperties extends TelemetryProperties {\n  success: boolean;\n  hostMode: 'custom' | 'loopback';\n  port: number;\n  adoptionMode?: AdoptionMode;\n  errorCode?: string;\n  projectScope?: ProjectScope;\n  workflowMode?: WorkflowMode;\n}\n\nexport interface StudioHealthRefreshedProperties extends ProjectHealthTelemetryProperties {\n  trigger: 'api-refresh';\n}\n\nexport interface RegistryItemResolvedProperties extends TelemetryProperties {\n  contentType: TelemetryContentType;\n  success: boolean;\n  cacheHit?: boolean;\n  durationMs?: number;\n  errorCode?: string;\n  itemId?: string;\n  namespace?: string;\n  registrySource?: RegistrySource;\n  version?: string;\n  visibility?: TelemetryVisibility;\n}\n\nexport interface RegistrySyncCompletedProperties extends TelemetryProperties {\n  success: boolean;\n  durationMs: number;\n  errorCode?: string;\n  registrySource?: RegistrySource;\n  totalItems?: number;\n}\n\nexport interface ExecutionPackCompiledProperties extends TelemetryProperties {\n  success: boolean;\n  durationMs: number;\n  errorCode?: string;\n  pageCount?: number;\n  patternCount?: number;\n  sectionCount?: number;\n  targetFramework?: string;\n}\n\nexport interface ExecutionPackSelectedProperties extends TelemetryProperties {\n  packType: 'mutation' | 'page' | 'review' | 'scaffold' | 'section';\n  success: boolean;\n  durationMs?: number;\n  errorCode?: string;\n  id?: string;\n}\n\nexport interface AuditCompletedProperties extends TelemetryProperties {\n  scope: TelemetryAnalysisScope;\n  success: boolean;\n  durationMs: number;\n  errorCode?: string;\n  errorCount?: number;\n  pageCount?: number;\n  runtimePassed?: boolean;\n  score?: number;\n  warnCount?: number;\n}\n\nexport interface CritiqueCompletedProperties extends TelemetryProperties {\n  scope: TelemetryAnalysisScope;\n  success: boolean;\n  durationMs: number;\n  errorCode?: string;\n  errorCount?: number;\n  infoCount?: number;\n  overall?: number;\n  warnCount?: number;\n}\n\nexport interface ContentValidationCompletedProperties extends TelemetryProperties {\n  valid: boolean;\n  contentType?: TelemetryContentType;\n  durationMs?: number;\n  errorCount?: number;\n  itemCount?: number;\n  warningCount?: number;\n}\n\nexport interface ContentPublishCompletedProperties extends TelemetryProperties {\n  contentType: TelemetryContentType;\n  success: boolean;\n  durationMs: number;\n  errorCode?: string;\n  namespace?: string;\n  visibility?: TelemetryVisibility;\n}\n\nexport interface ProductEventProperties extends TelemetryProperties {\n  success?: boolean;\n  channel?: string;\n  entrypoint?: string;\n  plan?: string;\n}\n\nexport interface CampaignAttributionProperties extends TelemetryProperties {\n  attributionClickIdProvider?: string | null;\n  attributionClickIdPresent?: boolean;\n  attributionFirstLandingPath?: string | null;\n  attributionFirstReferrerDomain?: string | null;\n  attributionFirstUtmCampaign?: string | null;\n  attributionFirstUtmContent?: string | null;\n  attributionFirstUtmId?: string | null;\n  attributionFirstUtmMedium?: string | null;\n  attributionFirstUtmSource?: string | null;\n  attributionFirstUtmTerm?: string | null;\n  attributionLandingPath?: string | null;\n  attributionLastLandingPath?: string | null;\n  attributionLastReferrerDomain?: string | null;\n  attributionLastUtmCampaign?: string | null;\n  attributionLastUtmContent?: string | null;\n  attributionLastUtmId?: string | null;\n  attributionLastUtmMedium?: string | null;\n  attributionLastUtmSource?: string | null;\n  attributionLastUtmTerm?: string | null;\n  attributionReferrerDomain?: string | null;\n  attributionUtmCampaign?: string | null;\n  attributionUtmContent?: string | null;\n  attributionUtmId?: string | null;\n  attributionUtmMedium?: string | null;\n  attributionUtmSource?: string | null;\n  attributionUtmTerm?: string | null;\n}\n\nexport interface MarketingWebPageViewedProperties extends CampaignAttributionProperties {\n  routePath: string;\n  surface: string;\n}\n\nexport interface MarketingWebCtaClickedProperties extends CampaignAttributionProperties {\n  destination: string;\n  label?: string | null;\n  surface: string;\n}\n\nexport interface MarketingWebOutboundClickedProperties extends CampaignAttributionProperties {\n  destination: string;\n  label?: string | null;\n  surface: string;\n}\n\nexport interface MarketingWebCommandClickedProperties extends CampaignAttributionProperties {\n  commandKind: 'cli' | 'mcp' | 'other';\n  commandLabel?: string | null;\n  surface: string;\n}\n\nexport interface RegistryWebPageViewedProperties extends CampaignAttributionProperties {\n  authenticated: boolean;\n  orgScoped?: boolean;\n  plan?: string;\n  queryPresent?: boolean;\n  route: string;\n  routePath: string;\n  surface: string;\n}\n\nexport interface RegistryWebSearchPerformedProperties extends CampaignAttributionProperties {\n  contentType?: string;\n  queryLength: number;\n  resultCount?: number;\n  sort?: string;\n  sourceFilter?: string;\n  surface: string;\n}\n\nexport interface RegistryWebContentOpenedProperties extends CampaignAttributionProperties {\n  contentSource?: string;\n  contentType: string;\n  namespace?: string;\n  slug?: string;\n  surface: string;\n}\n\nexport interface RegistryWebCommercialPageViewedProperties extends CampaignAttributionProperties {\n  orgScoped?: boolean;\n  plan?: string;\n  surface: string;\n}\n\nexport interface TelemetryIdentityLinkedProperties extends TelemetryProperties {\n  success: boolean;\n  entrypoint?: string;\n  identityType?: 'anonymous' | 'install' | 'project';\n  linkCount?: number;\n  orgScoped?: boolean;\n  plan?: string;\n  surface?: string;\n}\n\nexport interface PrivateRegistryGateViewedProperties extends TelemetryProperties {\n  orgScoped: boolean;\n  plan?: string;\n  surface: string;\n  enterpriseOrgCount?: number;\n}\n\nexport interface PrivateRegistryIntentClickedProperties extends TelemetryProperties {\n  action: 'open_billing' | 'open_team' | 'open_private_registry';\n  orgScoped: boolean;\n  plan?: string;\n  surface: string;\n}\n\nexport interface PrivateRegistryContentListedProperties extends TelemetryProperties {\n  itemCount: number;\n  orgScoped: true;\n  plan?: string;\n  queryPresent?: boolean;\n  statusFilterPresent?: boolean;\n  surface: string;\n  typeFilterPresent?: boolean;\n  visibilityFilterPresent?: boolean;\n}\n\nexport interface BillingPlanClickedProperties extends TelemetryProperties {\n  billingEnabled: boolean;\n  currentPlan?: string;\n  orgScoped?: boolean;\n  plan: 'enterprise' | 'pro' | 'team';\n  surface: string;\n}\n\nexport interface BillingCheckoutBlockedProperties extends TelemetryProperties {\n  billingEnabled: boolean;\n  orgScoped?: boolean;\n  plan?: 'enterprise' | 'pro' | 'team';\n  reason: 'billing_coming_soon' | 'billing_not_configured' | 'not_authorized';\n  surface: string;\n}\n\nexport interface TelemetryEventCatalogEntry {\n  name: DecantrTelemetryEventName;\n  allowedSources: readonly TelemetrySource[];\n  bucket: TelemetrySignalBucket;\n  privacy: TelemetryPrivacyClass;\n  privacyNotes: string;\n  publicIngest: boolean;\n}\n\nconst API_ONLY = ['api'] as const;\nconst CLI_ONLY = ['cli'] as const;\nconst REGISTRY_WEB_ONLY = ['registry-web'] as const;\nconst MARKETING_WEB_ONLY = ['marketing-web'] as const;\nconst CONTENT_CI_AND_API = ['content-ci', 'api'] as const;\nconst REGISTRY_RESOLUTION_SOURCES = ['api', 'cli', 'mcp'] as const;\n\nexport const DECANTR_TELEMETRY_EVENT_CATALOG: readonly TelemetryEventCatalogEntry[] = [\n  eventCatalogEntry('api_key.created', API_ONLY, 'activation', 'aggregate', false),\n  eventCatalogEntry('audit.completed', API_ONLY, 'hosted_intelligence', 'aggregate', false),\n  eventCatalogEntry('cli.command.completed', CLI_ONLY, 'cli_adoption', 'aggregate', true),\n  eventCatalogEntry('content.publish.completed', CONTENT_CI_AND_API, 'content_pipeline', 'aggregate', true),\n  eventCatalogEntry('content.validation.completed', CONTENT_CI_AND_API, 'content_pipeline', 'aggregate', true),\n  eventCatalogEntry('critique.completed', API_ONLY, 'hosted_intelligence', 'aggregate', false),\n  eventCatalogEntry('decantr.analyze.completed', CLI_ONLY, 'product_activation', 'aggregate', true),\n  eventCatalogEntry('decantr.check.completed', CLI_ONLY, 'product_activation', 'aggregate', true),\n  eventCatalogEntry('decantr.health.healthy', CLI_ONLY, 'project_health', 'aggregate', true),\n  eventCatalogEntry('decantr.init.completed', CLI_ONLY, 'product_activation', 'aggregate', true),\n  eventCatalogEntry('decantr.new.completed', CLI_ONLY, 'product_activation', 'aggregate', true),\n  eventCatalogEntry('decantr.refresh.completed', CLI_ONLY, 'product_activation', 'aggregate', true),\n  eventCatalogEntry('execution_pack.compiled', API_ONLY, 'hosted_intelligence', 'aggregate', false),\n  eventCatalogEntry('execution_pack.selected', API_ONLY, 'hosted_intelligence', 'aggregate', false),\n  eventCatalogEntry('health.ci.failed', CLI_ONLY, 'project_health', 'aggregate', true),\n  eventCatalogEntry('health.finding.prompt_requested', CLI_ONLY, 'project_health', 'aggregate', true),\n  eventCatalogEntry('health.report.generated', CLI_ONLY, 'project_health', 'aggregate', true),\n  eventCatalogEntry('marketing_web.command_clicked', MARKETING_WEB_ONLY, 'paid_acquisition', 'public_metadata', true),\n  eventCatalogEntry('marketing_web.cta_clicked', MARKETING_WEB_ONLY, 'paid_acquisition', 'public_metadata', true),\n  eventCatalogEntry('marketing_web.outbound_clicked', MARKETING_WEB_ONLY, 'paid_acquisition', 'public_metadata', true),\n  eventCatalogEntry('marketing_web.page_viewed', MARKETING_WEB_ONLY, 'paid_acquisition', 'public_metadata', true),\n  eventCatalogEntry('org.created', API_ONLY, 'activation', 'aggregate', false),\n  eventCatalogEntry('billing.checkout_blocked', ['api', 'registry-web'], 'billing_intent', 'aggregate', true),\n  eventCatalogEntry('billing.plan_clicked', REGISTRY_WEB_ONLY, 'billing_intent', 'aggregate', true),\n  eventCatalogEntry('private_registry.content_listed', REGISTRY_WEB_ONLY, 'private_registry_readiness', 'aggregate', true),\n  eventCatalogEntry('private_registry.gate_viewed', REGISTRY_WEB_ONLY, 'private_registry_readiness', 'aggregate', true),\n  eventCatalogEntry('private_registry.intent_clicked', REGISTRY_WEB_ONLY, 'private_registry_readiness', 'aggregate', true),\n  eventCatalogEntry('registry_web.api_key_page_viewed', REGISTRY_WEB_ONLY, 'commercial_intent', 'public_metadata', true),\n  eventCatalogEntry('registry_web.billing_viewed', REGISTRY_WEB_ONLY, 'commercial_intent', 'public_metadata', true),\n  eventCatalogEntry('registry_web.content_opened', REGISTRY_WEB_ONLY, 'registry_discovery', 'public_metadata', true),\n  eventCatalogEntry('registry_web.identity_linked', REGISTRY_WEB_ONLY, 'identity_hygiene', 'opaque_identity', true),\n  eventCatalogEntry('registry_web.organization_viewed', REGISTRY_WEB_ONLY, 'commercial_intent', 'aggregate', true),\n  eventCatalogEntry('registry_web.page_viewed', REGISTRY_WEB_ONLY, 'registry_discovery', 'public_metadata', true),\n  eventCatalogEntry('registry_web.search_performed', REGISTRY_WEB_ONLY, 'registry_discovery', 'aggregate', true),\n  eventCatalogEntry('registry_web.signup_clicked', REGISTRY_WEB_ONLY, 'activation', 'public_metadata', true),\n  eventCatalogEntry('registry.item.resolved', REGISTRY_RESOLUTION_SOURCES, 'registry_discovery', 'aggregate', true),\n  eventCatalogEntry('registry.sync.completed', CLI_ONLY, 'cli_adoption', 'aggregate', true),\n  eventCatalogEntry('studio.health_refreshed', CLI_ONLY, 'project_health', 'aggregate', true),\n  eventCatalogEntry('studio.started', CLI_ONLY, 'project_health', 'aggregate', true),\n  eventCatalogEntry('telemetry.identity_linked', API_ONLY, 'identity_hygiene', 'opaque_identity', false),\n  eventCatalogEntry('user.signup.completed', API_ONLY, 'activation', 'aggregate', false),\n];\n\nconst TELEMETRY_EVENT_CATALOG_BY_NAME = new Map(\n  DECANTR_TELEMETRY_EVENT_CATALOG.map((entry) => [entry.name, entry]),\n);\n\nexport type DecantrTelemetryEvent =\n  | TelemetryEventBase<'api_key.created', ProductEventProperties>\n  | TelemetryEventBase<'audit.completed', AuditCompletedProperties>\n  | TelemetryEventBase<'billing.checkout_blocked', BillingCheckoutBlockedProperties>\n  | TelemetryEventBase<'billing.plan_clicked', BillingPlanClickedProperties>\n  | TelemetryEventBase<'cli.command.completed', CliCommandCompletedProperties>\n  | TelemetryEventBase<'content.publish.completed', ContentPublishCompletedProperties>\n  | TelemetryEventBase<'content.validation.completed', ContentValidationCompletedProperties>\n  | TelemetryEventBase<'critique.completed', CritiqueCompletedProperties>\n  | TelemetryEventBase<'decantr.analyze.completed', DecantrAnalyzeCompletedProperties>\n  | TelemetryEventBase<'decantr.check.completed', DecantrLifecycleCompletedProperties>\n  | TelemetryEventBase<'decantr.health.healthy', ProjectHealthTelemetryProperties>\n  | TelemetryEventBase<'decantr.init.completed', DecantrLifecycleCompletedProperties>\n  | TelemetryEventBase<'decantr.new.completed', DecantrLifecycleCompletedProperties>\n  | TelemetryEventBase<'decantr.refresh.completed', DecantrLifecycleCompletedProperties>\n  | TelemetryEventBase<'execution_pack.compiled', ExecutionPackCompiledProperties>\n  | TelemetryEventBase<'execution_pack.selected', ExecutionPackSelectedProperties>\n  | TelemetryEventBase<'health.ci.failed', HealthCiFailedProperties>\n  | TelemetryEventBase<'health.finding.prompt_requested', HealthFindingPromptRequestedProperties>\n  | TelemetryEventBase<'health.report.generated', ProjectHealthTelemetryProperties>\n  | TelemetryEventBase<'marketing_web.command_clicked', MarketingWebCommandClickedProperties>\n  | TelemetryEventBase<'marketing_web.cta_clicked', MarketingWebCtaClickedProperties>\n  | TelemetryEventBase<'marketing_web.outbound_clicked', MarketingWebOutboundClickedProperties>\n  | TelemetryEventBase<'marketing_web.page_viewed', MarketingWebPageViewedProperties>\n  | TelemetryEventBase<'org.created', ProductEventProperties>\n  | TelemetryEventBase<'private_registry.content_listed', PrivateRegistryContentListedProperties>\n  | TelemetryEventBase<'private_registry.gate_viewed', PrivateRegistryGateViewedProperties>\n  | TelemetryEventBase<'private_registry.intent_clicked', PrivateRegistryIntentClickedProperties>\n  | TelemetryEventBase<'registry_web.api_key_page_viewed', RegistryWebCommercialPageViewedProperties>\n  | TelemetryEventBase<'registry_web.billing_viewed', RegistryWebCommercialPageViewedProperties>\n  | TelemetryEventBase<'registry_web.content_opened', RegistryWebContentOpenedProperties>\n  | TelemetryEventBase<'registry_web.identity_linked', RegistryWebCommercialPageViewedProperties>\n  | TelemetryEventBase<'registry_web.organization_viewed', RegistryWebCommercialPageViewedProperties>\n  | TelemetryEventBase<'registry_web.page_viewed', RegistryWebPageViewedProperties>\n  | TelemetryEventBase<'registry_web.search_performed', RegistryWebSearchPerformedProperties>\n  | TelemetryEventBase<'registry_web.signup_clicked', RegistryWebCommercialPageViewedProperties>\n  | TelemetryEventBase<'registry.item.resolved', RegistryItemResolvedProperties>\n  | TelemetryEventBase<'registry.sync.completed', RegistrySyncCompletedProperties>\n  | TelemetryEventBase<'studio.health_refreshed', StudioHealthRefreshedProperties>\n  | TelemetryEventBase<'studio.started', StudioStartedProperties>\n  | TelemetryEventBase<'telemetry.identity_linked', TelemetryIdentityLinkedProperties>\n  | TelemetryEventBase<'user.signup.completed', ProductEventProperties>;\n\nexport function isDecantrTelemetrySchemaVersion(\n  value: unknown,\n): value is (typeof DECANTR_TELEMETRY_ACCEPTED_SCHEMA_VERSIONS)[number] {\n  return (\n    typeof value === 'string' &&\n    (DECANTR_TELEMETRY_ACCEPTED_SCHEMA_VERSIONS as readonly string[]).includes(value)\n  );\n}\n\nexport function isDecantrTelemetryEventName(value: string): value is DecantrTelemetryEventName {\n  return (DECANTR_TELEMETRY_EVENT_NAMES as readonly string[]).includes(value);\n}\n\nexport function getTelemetryEventCatalogEntry(\n  name: DecantrTelemetryEventName,\n): TelemetryEventCatalogEntry {\n  return TELEMETRY_EVENT_CATALOG_BY_NAME.get(name)!;\n}\n\nexport function isTelemetryEventAllowedForSource(\n  name: DecantrTelemetryEventName,\n  source: TelemetrySource,\n): boolean {\n  return getTelemetryEventCatalogEntry(name).allowedSources.includes(source);\n}\n\nfunction eventCatalogEntry(\n  name: DecantrTelemetryEventName,\n  allowedSources: readonly TelemetrySource[],\n  bucket: TelemetrySignalBucket,\n  privacy: TelemetryPrivacyClass,\n  publicIngest: boolean,\n): TelemetryEventCatalogEntry {\n  return {\n    name,\n    allowedSources,\n    bucket,\n    privacy,\n    publicIngest,\n    privacyNotes:\n      privacy === 'aggregate'\n        ? 'Aggregate product metadata only; no source, prompts, raw paths, emails, or secrets.'\n        : privacy === 'opaque_identity'\n          ? 'Opaque Decantr identity ids only; no emails, source, prompts, raw paths, or secrets.'\n          : 'Public product or acquisition metadata only; no raw referrer URLs, user agents, emails, or click ids.',\n  };\n}\n","import type { DecantrTelemetryEvent, TelemetryPropertyValue } from './events.js';\n\nexport const REDACTED_VALUE = '[redacted]';\n\nconst DEFAULT_MAX_STRING_LENGTH = 240;\nconst DEFAULT_MAX_ARRAY_LENGTH = 25;\nconst DEFAULT_MAX_OBJECT_KEYS = 80;\nconst DEFAULT_MAX_DEPTH = 4;\n\nconst SENSITIVE_KEY_PATTERNS = [\n  /^api[_-]?key$/i,\n  /^authorization$/i,\n  /^code$/i,\n  /^content$/i,\n  /^contents$/i,\n  /^cookie$/i,\n  /^cwd$/i,\n  /^email$/i,\n  /^env$/i,\n  /^file[_-]?contents$/i,\n  /^file[_-]?path$/i,\n  /^home$/i,\n  /^ip[_-]?address$/i,\n  /^password$/i,\n  /^path$/i,\n  /^prompt$/i,\n  /^raw[_-]?prompt$/i,\n  /^secret$/i,\n  /^source$/i,\n  /^source[_-]?code$/i,\n  /^token$/i,\n  /^url$/i,\n  /^user[_-]?agent$/i,\n];\n\nexport interface TelemetryRedactionOptions {\n  maxArrayLength?: number;\n  maxDepth?: number;\n  maxObjectKeys?: number;\n  maxStringLength?: number;\n  redactedValue?: string;\n  sensitiveKeyPatterns?: RegExp[];\n}\n\nexport function isSensitiveTelemetryKey(key: string, patterns = SENSITIVE_KEY_PATTERNS): boolean {\n  return patterns.some((pattern) => pattern.test(key));\n}\n\nexport function sanitizeTelemetryValue(\n  value: TelemetryPropertyValue,\n  options: TelemetryRedactionOptions = {},\n  depth = 0,\n): TelemetryPropertyValue {\n  const maxDepth = options.maxDepth ?? DEFAULT_MAX_DEPTH;\n  if (depth > maxDepth) {\n    return options.redactedValue ?? REDACTED_VALUE;\n  }\n\n  if (typeof value === 'string') {\n    const maxStringLength = options.maxStringLength ?? DEFAULT_MAX_STRING_LENGTH;\n    return value.length > maxStringLength ? `${value.slice(0, maxStringLength)}...` : value;\n  }\n\n  if (typeof value === 'number' || typeof value === 'boolean' || value === null) {\n    return value;\n  }\n\n  if (value === undefined) {\n    return null;\n  }\n\n  if (Array.isArray(value)) {\n    const maxArrayLength = options.maxArrayLength ?? DEFAULT_MAX_ARRAY_LENGTH;\n    return value\n      .slice(0, maxArrayLength)\n      .map((entry) => sanitizeTelemetryValue(entry, options, depth + 1));\n  }\n\n  const redactedValue = options.redactedValue ?? REDACTED_VALUE;\n  const sensitiveKeyPatterns = options.sensitiveKeyPatterns ?? SENSITIVE_KEY_PATTERNS;\n  const maxObjectKeys = options.maxObjectKeys ?? DEFAULT_MAX_OBJECT_KEYS;\n  const entries = Object.entries(value).slice(0, maxObjectKeys);\n  const sanitized: Record<string, TelemetryPropertyValue> = {};\n\n  for (const [key, entryValue] of entries) {\n    sanitized[key] = isSensitiveTelemetryKey(key, sensitiveKeyPatterns)\n      ? redactedValue\n      : sanitizeTelemetryValue(entryValue, options, depth + 1);\n  }\n\n  return sanitized;\n}\n\nexport function sanitizeTelemetryEvent(\n  event: DecantrTelemetryEvent,\n  options: TelemetryRedactionOptions = {},\n): DecantrTelemetryEvent {\n  return {\n    ...event,\n    properties: sanitizeTelemetryValue(\n      event.properties,\n      options,\n    ) as DecantrTelemetryEvent['properties'],\n  } as DecantrTelemetryEvent;\n}\n","import {\n  DECANTR_TELEMETRY_SCHEMA_VERSION,\n  type DecantrTelemetryEvent,\n  type TelemetryContext,\n} from './events.js';\nimport { sanitizeTelemetryEvent, type TelemetryRedactionOptions } from './privacy.js';\n\nexport interface TelemetrySink {\n  capture(event: DecantrTelemetryEvent): Promise<void> | void;\n  flush?(): Promise<void> | void;\n}\n\nexport interface TelemetryClient {\n  capture(event: DecantrTelemetryEvent): Promise<void>;\n  flush(): Promise<void>;\n}\n\nexport interface TelemetryClientOptions {\n  context?: Partial<TelemetryContext>;\n  enabled?: boolean;\n  onError?: (error: unknown, event: DecantrTelemetryEvent) => void;\n  redaction?: TelemetryRedactionOptions;\n  sink?: TelemetrySink;\n}\n\nexport interface FetchTelemetrySinkOptions {\n  endpoint: string;\n  fetch?: typeof fetch;\n  headers?: HeadersInit | (() => HeadersInit);\n  timeoutMs?: number;\n}\n\nexport function createNoopTelemetrySink(): TelemetrySink {\n  return {\n    capture() {\n      return undefined;\n    },\n  };\n}\n\nexport function createTelemetryClient(options: TelemetryClientOptions = {}): TelemetryClient {\n  const enabled = options.enabled ?? true;\n  const sink = options.sink ?? createNoopTelemetrySink();\n  const pending = new Set<Promise<void>>();\n\n  async function capture(event: DecantrTelemetryEvent): Promise<void> {\n    if (!enabled) return;\n\n    const enriched = sanitizeTelemetryEvent(\n      {\n        ...event,\n        context: {\n          ...options.context,\n          ...event.context,\n        },\n        timestamp: normalizeTimestamp(event.timestamp),\n      } as DecantrTelemetryEvent,\n      options.redaction,\n    );\n\n    const promise = Promise.resolve()\n      .then(() => sink.capture(enriched))\n      .catch((error) => {\n        options.onError?.(error, enriched);\n      })\n      .then(() => undefined);\n\n    pending.add(promise);\n    promise.finally(() => pending.delete(promise));\n    await promise;\n  }\n\n  async function flush(): Promise<void> {\n    await Promise.allSettled([...pending]);\n    await sink.flush?.();\n  }\n\n  return { capture, flush };\n}\n\nexport function createFetchTelemetrySink(options: FetchTelemetrySinkOptions): TelemetrySink {\n  const fetchImpl = options.fetch ?? globalThis.fetch;\n\n  return {\n    async capture(event) {\n      const controller = new AbortController();\n      const timeout = setTimeout(() => controller.abort(), options.timeoutMs ?? 3000);\n\n      try {\n        const response = await fetchImpl(options.endpoint, {\n          method: 'POST',\n          headers: {\n            'Content-Type': 'application/json',\n            ...normalizeHeaders(\n              typeof options.headers === 'function' ? options.headers() : options.headers,\n            ),\n          },\n          body: JSON.stringify({\n            schemaVersion: DECANTR_TELEMETRY_SCHEMA_VERSION,\n            event,\n          }),\n          signal: controller.signal,\n        });\n\n        if (!response.ok) {\n          throw new Error(`Telemetry endpoint returned HTTP ${response.status}.`);\n        }\n      } finally {\n        clearTimeout(timeout);\n      }\n    },\n  };\n}\n\nfunction normalizeTimestamp(timestamp: Date | string | undefined): string {\n  if (timestamp instanceof Date) {\n    return timestamp.toISOString();\n  }\n  return timestamp ?? new Date().toISOString();\n}\n\nfunction normalizeHeaders(headers: HeadersInit | undefined): Record<string, string> {\n  if (!headers) return {};\n\n  if (headers instanceof Headers) {\n    return Object.fromEntries(headers.entries());\n  }\n\n  if (Array.isArray(headers)) {\n    return Object.fromEntries(headers);\n  }\n\n  return headers as Record<string, string>;\n}\n","import type { TelemetrySink } from './client.js';\nimport {\n  DECANTR_TELEMETRY_SCHEMA_VERSION,\n  resolveTelemetryActorType,\n  type DecantrTelemetryEvent,\n  type TelemetryProperties,\n} from './events.js';\n\nexport interface PostHogTelemetrySinkOptions {\n  apiKey: string;\n  fetch?: typeof fetch;\n  host?: string;\n  processPersonProfile?: boolean;\n  timeoutMs?: number;\n}\n\nexport function createPostHogTelemetrySink(options: PostHogTelemetrySinkOptions): TelemetrySink {\n  const host = trimTrailingSlashes(options.host ?? 'https://us.i.posthog.com');\n  const fetchImpl = options.fetch ?? globalThis.fetch;\n\n  return {\n    async capture(event) {\n      const distinctId = resolveDistinctId(event);\n      if (!distinctId) {\n        throw new Error(\n          'PostHog telemetry requires an opaque user, install, project, or anonymous id.',\n        );\n      }\n\n      const controller = new AbortController();\n      const timeout = setTimeout(() => controller.abort(), options.timeoutMs ?? 3000);\n\n      try {\n        const response = await fetchImpl(`${host}/i/v0/e/`, {\n          method: 'POST',\n          headers: { 'Content-Type': 'application/json' },\n          body: JSON.stringify({\n            api_key: options.apiKey,\n            event: event.name,\n            distinct_id: distinctId,\n            properties: toPostHogProperties(event, options),\n            timestamp: event.timestamp,\n          }),\n          signal: controller.signal,\n        });\n\n        if (!response.ok) {\n          throw new Error(`PostHog capture returned HTTP ${response.status}.`);\n        }\n      } finally {\n        clearTimeout(timeout);\n      }\n    },\n  };\n}\n\nfunction trimTrailingSlashes(value: string): string {\n  let end = value.length;\n  while (end > 0 && value.charCodeAt(end - 1) === 47) {\n    end -= 1;\n  }\n  return value.slice(0, end);\n}\n\nfunction resolveDistinctId(event: DecantrTelemetryEvent): string | undefined {\n  return (\n    event.context.userId ??\n    event.context.installId ??\n    event.context.projectId ??\n    event.context.anonymousId\n  );\n}\n\nfunction toPostHogProperties(\n  event: DecantrTelemetryEvent,\n  options: PostHogTelemetrySinkOptions,\n): TelemetryProperties {\n  const groups: Record<string, string> = {};\n  if (event.context.orgId) groups.organization = event.context.orgId;\n  if (event.context.projectId) groups.project = event.context.projectId;\n\n  return {\n    ...event.properties,\n    $groups: groups,\n    $process_person_profile: options.processPersonProfile ?? false,\n    decantr_anonymous_id: event.context.anonymousId ?? null,\n    decantr_actor_type: resolveTelemetryActorType(event.context),\n    decantr_install_id: event.context.installId ?? null,\n    decantr_org_id: event.context.orgId ?? null,\n    decantr_project_id: event.context.projectId ?? null,\n    decantr_session_id: event.context.sessionId ?? null,\n    decantr_schema_version: DECANTR_TELEMETRY_SCHEMA_VERSION,\n    decantr_source: event.context.source,\n    decantr_environment: event.context.environment ?? 'production',\n    decantr_version: event.context.decantrVersion ?? null,\n    registry_source: event.context.registrySource ?? null,\n    service_name: event.context.serviceName ?? null,\n    service_version: event.context.serviceVersion ?? null,\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/posthog.js

@@ -1,5 +1,5 @@
 // src/events.ts
-var DECANTR_TELEMETRY_SCHEMA_VERSION = "0.2.0";
+var DECANTR_TELEMETRY_SCHEMA_VERSION = "0.3.0";
 function resolveTelemetryActorType(context, options = {}) {
   if (context.actorType) return context.actorType;
   if (context.source === "content-ci") {
@@ -26,6 +26,68 @@ function idListHas(values, value) {
   }
   return values.includes(value);
 }
+var API_ONLY = ["api"];
+var CLI_ONLY = ["cli"];
+var REGISTRY_WEB_ONLY = ["registry-web"];
+var MARKETING_WEB_ONLY = ["marketing-web"];
+var CONTENT_CI_AND_API = ["content-ci", "api"];
+var REGISTRY_RESOLUTION_SOURCES = ["api", "cli", "mcp"];
+var DECANTR_TELEMETRY_EVENT_CATALOG = [
+  eventCatalogEntry("api_key.created", API_ONLY, "activation", "aggregate", false),
+  eventCatalogEntry("audit.completed", API_ONLY, "hosted_intelligence", "aggregate", false),
+  eventCatalogEntry("cli.command.completed", CLI_ONLY, "cli_adoption", "aggregate", true),
+  eventCatalogEntry("content.publish.completed", CONTENT_CI_AND_API, "content_pipeline", "aggregate", true),
+  eventCatalogEntry("content.validation.completed", CONTENT_CI_AND_API, "content_pipeline", "aggregate", true),
+  eventCatalogEntry("critique.completed", API_ONLY, "hosted_intelligence", "aggregate", false),
+  eventCatalogEntry("decantr.analyze.completed", CLI_ONLY, "product_activation", "aggregate", true),
+  eventCatalogEntry("decantr.check.completed", CLI_ONLY, "product_activation", "aggregate", true),
+  eventCatalogEntry("decantr.health.healthy", CLI_ONLY, "project_health", "aggregate", true),
+  eventCatalogEntry("decantr.init.completed", CLI_ONLY, "product_activation", "aggregate", true),
+  eventCatalogEntry("decantr.new.completed", CLI_ONLY, "product_activation", "aggregate", true),
+  eventCatalogEntry("decantr.refresh.completed", CLI_ONLY, "product_activation", "aggregate", true),
+  eventCatalogEntry("execution_pack.compiled", API_ONLY, "hosted_intelligence", "aggregate", false),
+  eventCatalogEntry("execution_pack.selected", API_ONLY, "hosted_intelligence", "aggregate", false),
+  eventCatalogEntry("health.ci.failed", CLI_ONLY, "project_health", "aggregate", true),
+  eventCatalogEntry("health.finding.prompt_requested", CLI_ONLY, "project_health", "aggregate", true),
+  eventCatalogEntry("health.report.generated", CLI_ONLY, "project_health", "aggregate", true),
+  eventCatalogEntry("marketing_web.command_clicked", MARKETING_WEB_ONLY, "paid_acquisition", "public_metadata", true),
+  eventCatalogEntry("marketing_web.cta_clicked", MARKETING_WEB_ONLY, "paid_acquisition", "public_metadata", true),
+  eventCatalogEntry("marketing_web.outbound_clicked", MARKETING_WEB_ONLY, "paid_acquisition", "public_metadata", true),
+  eventCatalogEntry("marketing_web.page_viewed", MARKETING_WEB_ONLY, "paid_acquisition", "public_metadata", true),
+  eventCatalogEntry("org.created", API_ONLY, "activation", "aggregate", false),
+  eventCatalogEntry("billing.checkout_blocked", ["api", "registry-web"], "billing_intent", "aggregate", true),
+  eventCatalogEntry("billing.plan_clicked", REGISTRY_WEB_ONLY, "billing_intent", "aggregate", true),
+  eventCatalogEntry("private_registry.content_listed", REGISTRY_WEB_ONLY, "private_registry_readiness", "aggregate", true),
+  eventCatalogEntry("private_registry.gate_viewed", REGISTRY_WEB_ONLY, "private_registry_readiness", "aggregate", true),
+  eventCatalogEntry("private_registry.intent_clicked", REGISTRY_WEB_ONLY, "private_registry_readiness", "aggregate", true),
+  eventCatalogEntry("registry_web.api_key_page_viewed", REGISTRY_WEB_ONLY, "commercial_intent", "public_metadata", true),
+  eventCatalogEntry("registry_web.billing_viewed", REGISTRY_WEB_ONLY, "commercial_intent", "public_metadata", true),
+  eventCatalogEntry("registry_web.content_opened", REGISTRY_WEB_ONLY, "registry_discovery", "public_metadata", true),
+  eventCatalogEntry("registry_web.identity_linked", REGISTRY_WEB_ONLY, "identity_hygiene", "opaque_identity", true),
+  eventCatalogEntry("registry_web.organization_viewed", REGISTRY_WEB_ONLY, "commercial_intent", "aggregate", true),
+  eventCatalogEntry("registry_web.page_viewed", REGISTRY_WEB_ONLY, "registry_discovery", "public_metadata", true),
+  eventCatalogEntry("registry_web.search_performed", REGISTRY_WEB_ONLY, "registry_discovery", "aggregate", true),
+  eventCatalogEntry("registry_web.signup_clicked", REGISTRY_WEB_ONLY, "activation", "public_metadata", true),
+  eventCatalogEntry("registry.item.resolved", REGISTRY_RESOLUTION_SOURCES, "registry_discovery", "aggregate", true),
+  eventCatalogEntry("registry.sync.completed", CLI_ONLY, "cli_adoption", "aggregate", true),
+  eventCatalogEntry("studio.health_refreshed", CLI_ONLY, "project_health", "aggregate", true),
+  eventCatalogEntry("studio.started", CLI_ONLY, "project_health", "aggregate", true),
+  eventCatalogEntry("telemetry.identity_linked", API_ONLY, "identity_hygiene", "opaque_identity", false),
+  eventCatalogEntry("user.signup.completed", API_ONLY, "activation", "aggregate", false)
+];
+var TELEMETRY_EVENT_CATALOG_BY_NAME = new Map(
+  DECANTR_TELEMETRY_EVENT_CATALOG.map((entry) => [entry.name, entry])
+);
+function eventCatalogEntry(name, allowedSources, bucket, privacy, publicIngest) {
+  return {
+    name,
+    allowedSources,
+    bucket,
+    privacy,
+    publicIngest,
+    privacyNotes: privacy === "aggregate" ? "Aggregate product metadata only; no source, prompts, raw paths, emails, or secrets." : privacy === "opaque_identity" ? "Opaque Decantr identity ids only; no emails, source, prompts, raw paths, or secrets." : "Public product or acquisition metadata only; no raw referrer URLs, user agents, emails, or click ids."
+  };
+}
 
 // src/posthog.ts
 function createPostHogTelemetrySink(options) {