@decantr/telemetry 0.2.0 → 2.2.0

package/README.md

@@ -8,7 +8,7 @@ This package is the first layer of Decantr's usage intelligence system. It defin
 
 Decantr telemetry measures Decantr usage, not customer application data.
 
-Allowed signals include command names, registry sources, registry content IDs, package versions, workflow modes, success/failure, duration, audit scores, aggregate counts, marketing route labels, campaign tags, and referrer domains. Do not send prompts, source code, generated files, raw file paths, environment variables, secrets, API keys, email addresses, IP addresses, raw referrer URLs, click IDs, or user agents.
+Allowed signals include command names, registry sources, registry content IDs, package versions, workflow modes, success/failure, duration, audit scores, Project Health status/score/counts, aggregate counts, marketing route labels, campaign tags, and referrer domains. Do not send prompts, source code, generated files, health reports, finding evidence, raw file paths, environment variables, secrets, API keys, email addresses, IP addresses, raw referrer URLs, click IDs, or user agents.
 
 ## MVP Events
 
@@ -19,11 +19,27 @@ Allowed signals include command names, registry sources, registry content IDs, p
 - `execution_pack.selected`
 - `audit.completed`
 - `critique.completed`
+- `decantr.analyze.completed`
+- `decantr.init.completed`
+- `decantr.new.completed`
+- `decantr.refresh.completed`
+- `decantr.check.completed`
+- `decantr.health.healthy`
+- `health.report.generated`
+- `health.finding.prompt_requested`
+- `health.ci.failed`
+- `studio.started`
+- `studio.health_refreshed`
 - `content.validation.completed`
 - `content.publish.completed`
 - `user.signup.completed`
 - `org.created`
 - `api_key.created`
+- `billing.plan_clicked`
+- `billing.checkout_blocked`
+- `private_registry.gate_viewed`
+- `private_registry.intent_clicked`
+- `private_registry.content_listed`
 - `marketing_web.page_viewed`
 - `marketing_web.cta_clicked`
 - `marketing_web.outbound_clicked`
@@ -36,8 +52,11 @@ Allowed signals include command names, registry sources, registry content IDs, p
 - `registry_web.billing_viewed`
 - `registry_web.organization_viewed`
 - `registry_web.identity_linked`
+- `telemetry.identity_linked`
 
-Private registries do not need a separate telemetry surface yet. Use `registry.item.resolved` with `registrySource: "private"` and `visibility: "private"` when that product line lands.
+Private Registry remains manually provisioned and Enterprise-gated while the paywall is off. The telemetry surface records readiness and permitted usage only: gated views, intent clicks, and aggregate content-list counts. It does not collect private package slugs or customer source material.
+
+`DECANTR_TELEMETRY_EVENT_CATALOG` is the canonical source/event matrix. Public ingest should call `isTelemetryEventAllowedForSource(name, source)` and accept both `DECANTR_TELEMETRY_ACCEPTED_SCHEMA_VERSIONS` during rollout, while new emitters use schema `0.3.0`.
 
 ## Actor Attribution
 
@@ -51,7 +70,7 @@ Every event can carry `context.actorType` so Decantr can distinguish founder/int
 
 If omitted, sinks call `resolveTelemetryActorType(context)`. The hosted API normalizes public ingest events with server-authoritative attribution from Supabase identity flags, `telemetry_identity_aliases`, and fallback overrides through `DECANTR_INTERNAL_USER_IDS`, `DECANTR_INTERNAL_ORG_IDS`, `DECANTR_INTERNAL_INSTALL_IDS`, `DECANTR_INTERNAL_PROJECT_IDS`, and `DECANTR_INTERNAL_ANONYMOUS_IDS`.
 
-The registry admin portal exposes `/admin/telemetry` for managing `anonymous`, `install`, and `project` aliases without writing SQL. Aliases can be linked by user email/id or organization slug/id. Mutations are audit logged and clear the hosted API actor-resolution cache. `/admin/telemetry/usage` adds the protected PostHog query view for active identities, source/actor mix, paid-acquisition signals, failure signals, period-over-period trends, product signal buckets, operating alerts, stored rollup history, snapshot freshness, and unaliased identity candidates, with one-click candidate classification through the same audited alias flow. `/admin/reports` and individual organization admin pages read durable Supabase rollups written by the service-token protected snapshot runner, giving Decantr an owned business-intelligence history while PostHog remains the raw event explorer.
+The registry admin portal exposes `/admin/telemetry` for managing `anonymous`, `install`, and `project` aliases without writing SQL. Aliases can be linked by user email/id or organization slug/id. Opted-in CLI users can self-link opaque install/project ids with `decantr telemetry link --enable --org <slug>`, which calls the audited API alias flow and emits `telemetry.identity_linked`. Mutations clear the hosted API actor-resolution cache. `/admin/telemetry/usage` adds the protected PostHog query view for active identities, source/actor mix, paid-acquisition signals, failure signals, period-over-period trends, product signal buckets, operating alerts, stored rollup history, snapshot freshness, and unaliased identity candidates, with one-click candidate classification through the same audited alias flow. `/admin/reports` and individual organization admin pages read durable Supabase rollups written by the service-token protected snapshot runner, giving Decantr an owned business-intelligence history while PostHog remains the raw event explorer.
 
 ## Campaign Attribution
 

package/dist/client.js

@@ -1,5 +1,67 @@
 // src/events.ts
-var DECANTR_TELEMETRY_SCHEMA_VERSION = "0.1.0";
+var DECANTR_TELEMETRY_SCHEMA_VERSION = "0.3.0";
+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/privacy.ts
 var REDACTED_VALUE = "[redacted]";

package/dist/client.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/events.ts","../src/privacy.ts","../src/client.ts"],"sourcesContent":["export const DECANTR_TELEMETRY_SCHEMA_VERSION = '0.1.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';\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  'execution_pack.compiled',\n  'execution_pack.selected',\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  '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 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<'execution_pack.compiled', ExecutionPackCompiledProperties>\n  | TelemetryEventBase<'execution_pack.selected', ExecutionPackSelectedProperties>\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<'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"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/events.ts","../src/privacy.ts","../src/client.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"],"mappings":"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","names":[]}

package/dist/events.d.ts

@@ -1,4 +1,5 @@
-declare const DECANTR_TELEMETRY_SCHEMA_VERSION = "0.1.0";
+declare const DECANTR_TELEMETRY_SCHEMA_VERSION = "0.3.0";
+declare const DECANTR_TELEMETRY_ACCEPTED_SCHEMA_VERSIONS: readonly ["0.2.0", "0.3.0"];
 type TelemetrySource = 'api' | 'cli' | 'content-ci' | 'marketing-web' | 'mcp' | 'registry-web';
 type TelemetryEnvironment = 'development' | 'preview' | 'production' | 'test';
 declare const DECANTR_TELEMETRY_ACTOR_TYPES: readonly ["anonymous", "customer", "internal", "official_pipeline", "service"];
@@ -10,7 +11,14 @@ type ProjectScope = 'single-app' | 'workspace-app';
 type TelemetryContentType = 'archetype' | 'blueprint' | 'pattern' | 'shell' | 'theme';
 type TelemetryVisibility = 'private' | 'public' | 'team';
 type TelemetryAnalysisScope = 'hosted' | 'local';
-declare const DECANTR_TELEMETRY_EVENT_NAMES: readonly ["api_key.created", "audit.completed", "cli.command.completed", "content.publish.completed", "content.validation.completed", "critique.completed", "execution_pack.compiled", "execution_pack.selected", "marketing_web.command_clicked", "marketing_web.cta_clicked", "marketing_web.outbound_clicked", "marketing_web.page_viewed", "org.created", "registry_web.api_key_page_viewed", "registry_web.billing_viewed", "registry_web.content_opened", "registry_web.identity_linked", "registry_web.organization_viewed", "registry_web.page_viewed", "registry_web.search_performed", "registry_web.signup_clicked", "registry.item.resolved", "registry.sync.completed", "user.signup.completed"];
+type ProjectHealthTelemetryStatus = 'error' | 'healthy' | 'warning';
+type ProjectHealthFindingSeverity = 'error' | 'info' | 'warn';
+type ProjectHealthFindingSource = 'audit' | 'brownfield' | 'check' | 'interaction' | 'pack' | 'runtime';
+type ProjectHealthOutputFormat = 'json' | 'markdown' | 'text';
+type ProjectHealthFailOn = 'error' | 'none' | 'warn';
+type TelemetrySignalBucket = 'activation' | 'billing_intent' | 'cli_adoption' | 'commercial_intent' | 'content_pipeline' | 'hosted_intelligence' | 'identity_hygiene' | 'paid_acquisition' | 'private_registry_readiness' | 'product_activation' | 'project_health' | 'registry_discovery';
+type TelemetryPrivacyClass = 'aggregate' | 'opaque_identity' | 'public_metadata';
+declare const DECANTR_TELEMETRY_EVENT_NAMES: readonly ["api_key.created", "audit.completed", "cli.command.completed", "content.publish.completed", "content.validation.completed", "critique.completed", "decantr.analyze.completed", "decantr.check.completed", "decantr.health.healthy", "decantr.init.completed", "decantr.new.completed", "decantr.refresh.completed", "execution_pack.compiled", "execution_pack.selected", "health.ci.failed", "health.finding.prompt_requested", "health.report.generated", "marketing_web.command_clicked", "marketing_web.cta_clicked", "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", "registry_web.identity_linked", "registry_web.organization_viewed", "registry_web.page_viewed", "registry_web.search_performed", "registry_web.signup_clicked", "registry.item.resolved", "registry.sync.completed", "studio.health_refreshed", "studio.started", "telemetry.identity_linked", "user.signup.completed"];
 type DecantrTelemetryEventName = (typeof DECANTR_TELEMETRY_EVENT_NAMES)[number];
 type TelemetryPropertyValue = TelemetryPropertyValue[] | boolean | null | number | string | undefined | {
     [key: string]: TelemetryPropertyValue;
@@ -58,6 +66,83 @@ interface CliCommandCompletedProperties extends TelemetryProperties {
     targetFramework?: string;
     workflowMode?: WorkflowMode;
 }
+interface DecantrAnalyzeCompletedProperties extends TelemetryProperties {
+    command: 'analyze';
+    success: boolean;
+    durationMs?: number;
+    adoptionMode?: AdoptionMode;
+    componentCount?: number;
+    dependencyCategoryCount?: number;
+    errorCode?: string;
+    pageCount?: number;
+    projectScope?: ProjectScope;
+    routeCount?: number;
+    targetFramework?: string;
+    workflowMode?: WorkflowMode;
+}
+interface DecantrLifecycleCompletedProperties extends TelemetryProperties {
+    command: 'check' | 'init' | 'new' | 'refresh';
+    success: boolean;
+    durationMs: number;
+    adoptionMode?: AdoptionMode;
+    errorCode?: string;
+    offline?: boolean;
+    projectScope?: ProjectScope;
+    registrySource?: RegistrySource;
+    targetFramework?: string;
+    workflowMode?: WorkflowMode;
+}
+interface ProjectHealthTelemetryProperties extends TelemetryProperties {
+    success: boolean;
+    status: ProjectHealthTelemetryStatus;
+    score: number;
+    durationMs?: number;
+    adoptionMode?: AdoptionMode;
+    ci?: boolean;
+    errorCode?: string;
+    errorCount: number;
+    failOn?: ProjectHealthFailOn;
+    findingCount: number;
+    format?: ProjectHealthOutputFormat;
+    infoCount: number;
+    outputWritten?: boolean;
+    packManifestPresent?: boolean;
+    pageCount?: number;
+    projectScope?: ProjectScope;
+    reviewPackPresent?: boolean;
+    routeCount?: number;
+    runtimeAuditChecked?: boolean;
+    runtimeMatchedCount?: number;
+    runtimePassed?: boolean | null;
+    runtimeRouteCheckedCount?: number;
+    warnCount: number;
+    workflowMode?: WorkflowMode;
+}
+interface HealthFindingPromptRequestedProperties extends TelemetryProperties {
+    success: boolean;
+    findingFound: boolean;
+    adoptionMode?: AdoptionMode;
+    ci?: boolean;
+    findingSeverity?: ProjectHealthFindingSeverity;
+    findingSource?: ProjectHealthFindingSource;
+    projectScope?: ProjectScope;
+    workflowMode?: WorkflowMode;
+}
+interface HealthCiFailedProperties extends ProjectHealthTelemetryProperties {
+    failOn: 'error' | 'warn';
+}
+interface StudioStartedProperties extends TelemetryProperties {
+    success: boolean;
+    hostMode: 'custom' | 'loopback';
+    port: number;
+    adoptionMode?: AdoptionMode;
+    errorCode?: string;
+    projectScope?: ProjectScope;
+    workflowMode?: WorkflowMode;
+}
+interface StudioHealthRefreshedProperties extends ProjectHealthTelemetryProperties {
+    trigger: 'api-refresh';
+}
 interface RegistryItemResolvedProperties extends TelemetryProperties {
     contentType: TelemetryContentType;
     success: boolean;
@@ -212,7 +297,64 @@ interface RegistryWebCommercialPageViewedProperties extends CampaignAttributionP
     plan?: string;
     surface: string;
 }
-type DecantrTelemetryEvent = TelemetryEventBase<'api_key.created', ProductEventProperties> | TelemetryEventBase<'audit.completed', AuditCompletedProperties> | TelemetryEventBase<'cli.command.completed', CliCommandCompletedProperties> | TelemetryEventBase<'content.publish.completed', ContentPublishCompletedProperties> | TelemetryEventBase<'content.validation.completed', ContentValidationCompletedProperties> | TelemetryEventBase<'critique.completed', CritiqueCompletedProperties> | TelemetryEventBase<'execution_pack.compiled', ExecutionPackCompiledProperties> | TelemetryEventBase<'execution_pack.selected', ExecutionPackSelectedProperties> | TelemetryEventBase<'marketing_web.command_clicked', MarketingWebCommandClickedProperties> | TelemetryEventBase<'marketing_web.cta_clicked', MarketingWebCtaClickedProperties> | TelemetryEventBase<'marketing_web.outbound_clicked', MarketingWebOutboundClickedProperties> | TelemetryEventBase<'marketing_web.page_viewed', MarketingWebPageViewedProperties> | TelemetryEventBase<'org.created', ProductEventProperties> | TelemetryEventBase<'registry_web.api_key_page_viewed', RegistryWebCommercialPageViewedProperties> | TelemetryEventBase<'registry_web.billing_viewed', RegistryWebCommercialPageViewedProperties> | TelemetryEventBase<'registry_web.content_opened', RegistryWebContentOpenedProperties> | TelemetryEventBase<'registry_web.identity_linked', RegistryWebCommercialPageViewedProperties> | TelemetryEventBase<'registry_web.organization_viewed', RegistryWebCommercialPageViewedProperties> | TelemetryEventBase<'registry_web.page_viewed', RegistryWebPageViewedProperties> | TelemetryEventBase<'registry_web.search_performed', RegistryWebSearchPerformedProperties> | TelemetryEventBase<'registry_web.signup_clicked', RegistryWebCommercialPageViewedProperties> | TelemetryEventBase<'registry.item.resolved', RegistryItemResolvedProperties> | TelemetryEventBase<'registry.sync.completed', RegistrySyncCompletedProperties> | TelemetryEventBase<'user.signup.completed', ProductEventProperties>;
+interface TelemetryIdentityLinkedProperties extends TelemetryProperties {
+    success: boolean;
+    entrypoint?: string;
+    identityType?: 'anonymous' | 'install' | 'project';
+    linkCount?: number;
+    orgScoped?: boolean;
+    plan?: string;
+    surface?: string;
+}
+interface PrivateRegistryGateViewedProperties extends TelemetryProperties {
+    orgScoped: boolean;
+    plan?: string;
+    surface: string;
+    enterpriseOrgCount?: number;
+}
+interface PrivateRegistryIntentClickedProperties extends TelemetryProperties {
+    action: 'open_billing' | 'open_team' | 'open_private_registry';
+    orgScoped: boolean;
+    plan?: string;
+    surface: string;
+}
+interface PrivateRegistryContentListedProperties extends TelemetryProperties {
+    itemCount: number;
+    orgScoped: true;
+    plan?: string;
+    queryPresent?: boolean;
+    statusFilterPresent?: boolean;
+    surface: string;
+    typeFilterPresent?: boolean;
+    visibilityFilterPresent?: boolean;
+}
+interface BillingPlanClickedProperties extends TelemetryProperties {
+    billingEnabled: boolean;
+    currentPlan?: string;
+    orgScoped?: boolean;
+    plan: 'enterprise' | 'pro' | 'team';
+    surface: string;
+}
+interface BillingCheckoutBlockedProperties extends TelemetryProperties {
+    billingEnabled: boolean;
+    orgScoped?: boolean;
+    plan?: 'enterprise' | 'pro' | 'team';
+    reason: 'billing_coming_soon' | 'billing_not_configured' | 'not_authorized';
+    surface: string;
+}
+interface TelemetryEventCatalogEntry {
+    name: DecantrTelemetryEventName;
+    allowedSources: readonly TelemetrySource[];
+    bucket: TelemetrySignalBucket;
+    privacy: TelemetryPrivacyClass;
+    privacyNotes: string;
+    publicIngest: boolean;
+}
+declare const DECANTR_TELEMETRY_EVENT_CATALOG: readonly TelemetryEventCatalogEntry[];
+type DecantrTelemetryEvent = TelemetryEventBase<'api_key.created', ProductEventProperties> | TelemetryEventBase<'audit.completed', AuditCompletedProperties> | TelemetryEventBase<'billing.checkout_blocked', BillingCheckoutBlockedProperties> | TelemetryEventBase<'billing.plan_clicked', BillingPlanClickedProperties> | TelemetryEventBase<'cli.command.completed', CliCommandCompletedProperties> | TelemetryEventBase<'content.publish.completed', ContentPublishCompletedProperties> | TelemetryEventBase<'content.validation.completed', ContentValidationCompletedProperties> | TelemetryEventBase<'critique.completed', CritiqueCompletedProperties> | TelemetryEventBase<'decantr.analyze.completed', DecantrAnalyzeCompletedProperties> | TelemetryEventBase<'decantr.check.completed', DecantrLifecycleCompletedProperties> | TelemetryEventBase<'decantr.health.healthy', ProjectHealthTelemetryProperties> | TelemetryEventBase<'decantr.init.completed', DecantrLifecycleCompletedProperties> | TelemetryEventBase<'decantr.new.completed', DecantrLifecycleCompletedProperties> | TelemetryEventBase<'decantr.refresh.completed', DecantrLifecycleCompletedProperties> | TelemetryEventBase<'execution_pack.compiled', ExecutionPackCompiledProperties> | TelemetryEventBase<'execution_pack.selected', ExecutionPackSelectedProperties> | TelemetryEventBase<'health.ci.failed', HealthCiFailedProperties> | TelemetryEventBase<'health.finding.prompt_requested', HealthFindingPromptRequestedProperties> | TelemetryEventBase<'health.report.generated', ProjectHealthTelemetryProperties> | TelemetryEventBase<'marketing_web.command_clicked', MarketingWebCommandClickedProperties> | TelemetryEventBase<'marketing_web.cta_clicked', MarketingWebCtaClickedProperties> | TelemetryEventBase<'marketing_web.outbound_clicked', MarketingWebOutboundClickedProperties> | TelemetryEventBase<'marketing_web.page_viewed', MarketingWebPageViewedProperties> | TelemetryEventBase<'org.created', ProductEventProperties> | TelemetryEventBase<'private_registry.content_listed', PrivateRegistryContentListedProperties> | TelemetryEventBase<'private_registry.gate_viewed', PrivateRegistryGateViewedProperties> | TelemetryEventBase<'private_registry.intent_clicked', PrivateRegistryIntentClickedProperties> | TelemetryEventBase<'registry_web.api_key_page_viewed', RegistryWebCommercialPageViewedProperties> | TelemetryEventBase<'registry_web.billing_viewed', RegistryWebCommercialPageViewedProperties> | TelemetryEventBase<'registry_web.content_opened', RegistryWebContentOpenedProperties> | TelemetryEventBase<'registry_web.identity_linked', RegistryWebCommercialPageViewedProperties> | TelemetryEventBase<'registry_web.organization_viewed', RegistryWebCommercialPageViewedProperties> | TelemetryEventBase<'registry_web.page_viewed', RegistryWebPageViewedProperties> | TelemetryEventBase<'registry_web.search_performed', RegistryWebSearchPerformedProperties> | TelemetryEventBase<'registry_web.signup_clicked', RegistryWebCommercialPageViewedProperties> | TelemetryEventBase<'registry.item.resolved', RegistryItemResolvedProperties> | TelemetryEventBase<'registry.sync.completed', RegistrySyncCompletedProperties> | TelemetryEventBase<'studio.health_refreshed', StudioHealthRefreshedProperties> | TelemetryEventBase<'studio.started', StudioStartedProperties> | TelemetryEventBase<'telemetry.identity_linked', TelemetryIdentityLinkedProperties> | TelemetryEventBase<'user.signup.completed', ProductEventProperties>;
+declare function isDecantrTelemetrySchemaVersion(value: unknown): value is (typeof DECANTR_TELEMETRY_ACCEPTED_SCHEMA_VERSIONS)[number];
 declare function isDecantrTelemetryEventName(value: string): value is DecantrTelemetryEventName;
+declare function getTelemetryEventCatalogEntry(name: DecantrTelemetryEventName): TelemetryEventCatalogEntry;
+declare function isTelemetryEventAllowedForSource(name: DecantrTelemetryEventName, source: TelemetrySource): boolean;
 
-export { type AdoptionMode, type AuditCompletedProperties, type CampaignAttributionProperties, type CliCommandCompletedProperties, type ContentPublishCompletedProperties, type ContentValidationCompletedProperties, type CritiqueCompletedProperties, DECANTR_TELEMETRY_ACTOR_TYPES, DECANTR_TELEMETRY_EVENT_NAMES, DECANTR_TELEMETRY_SCHEMA_VERSION, type DecantrTelemetryEvent, type DecantrTelemetryEventName, type ExecutionPackCompiledProperties, type ExecutionPackSelectedProperties, type MarketingWebCommandClickedProperties, type MarketingWebCtaClickedProperties, type MarketingWebOutboundClickedProperties, type MarketingWebPageViewedProperties, type ProductEventProperties, type ProjectScope, type RegistryItemResolvedProperties, type RegistrySource, type RegistrySyncCompletedProperties, type RegistryWebCommercialPageViewedProperties, type RegistryWebContentOpenedProperties, type RegistryWebPageViewedProperties, type RegistryWebSearchPerformedProperties, type TelemetryActorResolutionOptions, type TelemetryActorType, type TelemetryAnalysisScope, type TelemetryContentType, type TelemetryContext, type TelemetryEnvironment, type TelemetryEventBase, type TelemetryProperties, type TelemetryPropertyValue, type TelemetrySource, type TelemetryVisibility, type WorkflowMode, isDecantrTelemetryEventName, isTelemetryActorType, resolveTelemetryActorType };
+export { type AdoptionMode, type AuditCompletedProperties, type BillingCheckoutBlockedProperties, type BillingPlanClickedProperties, type CampaignAttributionProperties, type CliCommandCompletedProperties, type ContentPublishCompletedProperties, type ContentValidationCompletedProperties, type CritiqueCompletedProperties, DECANTR_TELEMETRY_ACCEPTED_SCHEMA_VERSIONS, DECANTR_TELEMETRY_ACTOR_TYPES, DECANTR_TELEMETRY_EVENT_CATALOG, DECANTR_TELEMETRY_EVENT_NAMES, DECANTR_TELEMETRY_SCHEMA_VERSION, type DecantrAnalyzeCompletedProperties, type DecantrLifecycleCompletedProperties, type DecantrTelemetryEvent, type DecantrTelemetryEventName, type ExecutionPackCompiledProperties, type ExecutionPackSelectedProperties, type HealthCiFailedProperties, type HealthFindingPromptRequestedProperties, type MarketingWebCommandClickedProperties, type MarketingWebCtaClickedProperties, type MarketingWebOutboundClickedProperties, type MarketingWebPageViewedProperties, type PrivateRegistryContentListedProperties, type PrivateRegistryGateViewedProperties, type PrivateRegistryIntentClickedProperties, type ProductEventProperties, type ProjectHealthFailOn, type ProjectHealthFindingSeverity, type ProjectHealthFindingSource, type ProjectHealthOutputFormat, type ProjectHealthTelemetryProperties, type ProjectHealthTelemetryStatus, type ProjectScope, type RegistryItemResolvedProperties, type RegistrySource, type RegistrySyncCompletedProperties, type RegistryWebCommercialPageViewedProperties, type RegistryWebContentOpenedProperties, type RegistryWebPageViewedProperties, type RegistryWebSearchPerformedProperties, type StudioHealthRefreshedProperties, type StudioStartedProperties, type TelemetryActorResolutionOptions, type TelemetryActorType, type TelemetryAnalysisScope, type TelemetryContentType, type TelemetryContext, type TelemetryEnvironment, type TelemetryEventBase, type TelemetryEventCatalogEntry, type TelemetryIdentityLinkedProperties, type TelemetryPrivacyClass, type TelemetryProperties, type TelemetryPropertyValue, type TelemetrySignalBucket, type TelemetrySource, type TelemetryVisibility, type WorkflowMode, getTelemetryEventCatalogEntry, isDecantrTelemetryEventName, isDecantrTelemetrySchemaVersion, isTelemetryActorType, isTelemetryEventAllowedForSource, resolveTelemetryActorType };

package/dist/events.js

@@ -1,5 +1,9 @@
 // src/events.ts
-var DECANTR_TELEMETRY_SCHEMA_VERSION = "0.1.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,13 +18,27 @@ 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",
+  "decantr.new.completed",
+  "decantr.refresh.completed",
   "execution_pack.compiled",
   "execution_pack.selected",
+  "health.ci.failed",
+  "health.finding.prompt_requested",
+  "health.report.generated",
   "marketing_web.command_clicked",
   "marketing_web.cta_clicked",
   "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",
@@ -31,6 +49,9 @@ var DECANTR_TELEMETRY_EVENT_NAMES = [
   "registry_web.signup_clicked",
   "registry.item.resolved",
   "registry.sync.completed",
+  "studio.health_refreshed",
+  "studio.started",
+  "telemetry.identity_linked",
   "user.signup.completed"
 ];
 function isTelemetryActorType(value) {
@@ -62,15 +83,91 @@ 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."
+  };
+}
 export {
+  DECANTR_TELEMETRY_ACCEPTED_SCHEMA_VERSIONS,
   DECANTR_TELEMETRY_ACTOR_TYPES,
+  DECANTR_TELEMETRY_EVENT_CATALOG,
   DECANTR_TELEMETRY_EVENT_NAMES,
   DECANTR_TELEMETRY_SCHEMA_VERSION,
+  getTelemetryEventCatalogEntry,
   isDecantrTelemetryEventName,
+  isDecantrTelemetrySchemaVersion,
   isTelemetryActorType,
+  isTelemetryEventAllowedForSource,
   resolveTelemetryActorType
 };
 //# sourceMappingURL=events.js.map