@decantr/telemetry 0.1.0 → 0.1.2

package/README.md

@@ -24,9 +24,29 @@ Allowed signals include command names, registry sources, registry content IDs, p
 - `user.signup.completed`
 - `org.created`
 - `api_key.created`
+- `registry_web.page_viewed`
+- `registry_web.search_performed`
+- `registry_web.content_opened`
+- `registry_web.signup_clicked`
+- `registry_web.api_key_page_viewed`
+- `registry_web.billing_viewed`
+- `registry_web.organization_viewed`
+- `registry_web.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.
 
+## Actor Attribution
+
+Every event can carry `context.actorType` so Decantr can distinguish founder/internal usage from real customer adoption without relying on remembered PostHog person ids.
+
+- `anonymous`: unauthenticated registry/API browsing or resolution with only an anonymous id.
+- `customer`: authenticated hosted usage, org/project usage, or opted-in CLI install/project usage.
+- `internal`: Decantr team traffic identified by server-side opaque id allowlists or explicit internal CLI env.
+- `official_pipeline`: Decantr-owned content validation/publish automation.
+- `service`: backend service events that are not attributable to a user, org, install, project, or anonymous visitor.
+
+If omitted, sinks call `resolveTelemetryActorType(context)`. The hosted API also normalizes public ingest events and can override known Decantr-owned IDs through `DECANTR_INTERNAL_USER_IDS`, `DECANTR_INTERNAL_ORG_IDS`, `DECANTR_INTERNAL_INSTALL_IDS`, `DECANTR_INTERNAL_PROJECT_IDS`, and `DECANTR_INTERNAL_ANONYMOUS_IDS`.
+
 ## PostHog
 
 ```ts

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 = 'api' | 'cli' | 'content-ci' | 'mcp' | 'registry-web';\nexport type TelemetryEnvironment = 'development' | 'preview' | 'production' | 'test';\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  'org.created',\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  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 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 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<'org.created', ProductEventProperties>\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.1.0';\n\nexport type TelemetrySource = 'api' | 'cli' | 'content-ci' | 'mcp' | '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  '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 RegistryWebPageViewedProperties extends TelemetryProperties {\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 TelemetryProperties {\n  contentType?: string;\n  queryLength: number;\n  resultCount?: number;\n  sort?: string;\n  sourceFilter?: string;\n  surface: string;\n}\n\nexport interface RegistryWebContentOpenedProperties extends TelemetryProperties {\n  contentSource?: string;\n  contentType: string;\n  namespace?: string;\n  slug?: string;\n  surface: string;\n}\n\nexport interface RegistryWebCommercialPageViewedProperties extends TelemetryProperties {\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<'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":[]}

package/dist/events.d.ts

@@ -1,6 +1,8 @@
 declare const DECANTR_TELEMETRY_SCHEMA_VERSION = "0.1.0";
 type TelemetrySource = 'api' | 'cli' | 'content-ci' | 'mcp' | 'registry-web';
 type TelemetryEnvironment = 'development' | 'preview' | 'production' | 'test';
+declare const DECANTR_TELEMETRY_ACTOR_TYPES: readonly ["anonymous", "customer", "internal", "official_pipeline", "service"];
+type TelemetryActorType = (typeof DECANTR_TELEMETRY_ACTOR_TYPES)[number];
 type RegistrySource = 'cache' | 'custom' | 'none' | 'official' | 'private';
 type WorkflowMode = 'brownfield-attach' | 'greenfield-contract-only' | 'greenfield-scaffold' | 'hybrid-compose';
 type AdoptionMode = 'contract-only' | 'decantr-css' | 'style-bridge';
@@ -8,7 +10,7 @@ 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", "org.created", "registry.item.resolved", "registry.sync.completed", "user.signup.completed"];
+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", "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 DecantrTelemetryEventName = (typeof DECANTR_TELEMETRY_EVENT_NAMES)[number];
 type TelemetryPropertyValue = TelemetryPropertyValue[] | boolean | null | number | string | undefined | {
     [key: string]: TelemetryPropertyValue;
@@ -16,6 +18,7 @@ type TelemetryPropertyValue = TelemetryPropertyValue[] | boolean | null | number
 type TelemetryProperties = Record<string, TelemetryPropertyValue>;
 interface TelemetryContext {
     source: TelemetrySource;
+    actorType?: TelemetryActorType;
     environment?: TelemetryEnvironment;
     serviceName?: string;
     serviceVersion?: string;
@@ -28,6 +31,15 @@ interface TelemetryContext {
     userId?: string;
     orgId?: string;
 }
+interface TelemetryActorResolutionOptions {
+    internalAnonymousIds?: readonly string[] | ReadonlySet<string>;
+    internalInstallIds?: readonly string[] | ReadonlySet<string>;
+    internalOrgIds?: readonly string[] | ReadonlySet<string>;
+    internalProjectIds?: readonly string[] | ReadonlySet<string>;
+    internalUserIds?: readonly string[] | ReadonlySet<string>;
+}
+declare function isTelemetryActorType(value: unknown): value is TelemetryActorType;
+declare function resolveTelemetryActorType(context: TelemetryContext, options?: TelemetryActorResolutionOptions): TelemetryActorType;
 interface TelemetryEventBase<Name extends DecantrTelemetryEventName = DecantrTelemetryEventName, Properties extends TelemetryProperties = TelemetryProperties> {
     name: Name;
     context: TelemetryContext;
@@ -124,7 +136,36 @@ interface ProductEventProperties extends TelemetryProperties {
     entrypoint?: string;
     plan?: 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<'org.created', ProductEventProperties> | TelemetryEventBase<'registry.item.resolved', RegistryItemResolvedProperties> | TelemetryEventBase<'registry.sync.completed', RegistrySyncCompletedProperties> | TelemetryEventBase<'user.signup.completed', ProductEventProperties>;
+interface RegistryWebPageViewedProperties extends TelemetryProperties {
+    authenticated: boolean;
+    orgScoped?: boolean;
+    plan?: string;
+    queryPresent?: boolean;
+    route: string;
+    routePath: string;
+    surface: string;
+}
+interface RegistryWebSearchPerformedProperties extends TelemetryProperties {
+    contentType?: string;
+    queryLength: number;
+    resultCount?: number;
+    sort?: string;
+    sourceFilter?: string;
+    surface: string;
+}
+interface RegistryWebContentOpenedProperties extends TelemetryProperties {
+    contentSource?: string;
+    contentType: string;
+    namespace?: string;
+    slug?: string;
+    surface: string;
+}
+interface RegistryWebCommercialPageViewedProperties extends TelemetryProperties {
+    orgScoped?: boolean;
+    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<'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>;
 declare function isDecantrTelemetryEventName(value: string): value is DecantrTelemetryEventName;
 
-export { type AdoptionMode, type AuditCompletedProperties, type CliCommandCompletedProperties, type ContentPublishCompletedProperties, type ContentValidationCompletedProperties, type CritiqueCompletedProperties, DECANTR_TELEMETRY_EVENT_NAMES, DECANTR_TELEMETRY_SCHEMA_VERSION, type DecantrTelemetryEvent, type DecantrTelemetryEventName, type ExecutionPackCompiledProperties, type ExecutionPackSelectedProperties, type ProductEventProperties, type ProjectScope, type RegistryItemResolvedProperties, type RegistrySource, type RegistrySyncCompletedProperties, type TelemetryAnalysisScope, type TelemetryContentType, type TelemetryContext, type TelemetryEnvironment, type TelemetryEventBase, type TelemetryProperties, type TelemetryPropertyValue, type TelemetrySource, type TelemetryVisibility, type WorkflowMode, isDecantrTelemetryEventName };
+export { type AdoptionMode, type AuditCompletedProperties, 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 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 };

package/dist/events.js

@@ -1,5 +1,12 @@
 // src/events.ts
 var DECANTR_TELEMETRY_SCHEMA_VERSION = "0.1.0";
+var DECANTR_TELEMETRY_ACTOR_TYPES = [
+  "anonymous",
+  "customer",
+  "internal",
+  "official_pipeline",
+  "service"
+];
 var DECANTR_TELEMETRY_EVENT_NAMES = [
   "api_key.created",
   "audit.completed",
@@ -10,16 +17,56 @@ var DECANTR_TELEMETRY_EVENT_NAMES = [
   "execution_pack.compiled",
   "execution_pack.selected",
   "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"
 ];
+function isTelemetryActorType(value) {
+  return typeof value === "string" && DECANTR_TELEMETRY_ACTOR_TYPES.includes(value);
+}
+function resolveTelemetryActorType(context, options = {}) {
+  if (context.actorType) return context.actorType;
+  if (context.source === "content-ci") {
+    return "official_pipeline";
+  }
+  if (matchesInternalActor(context, options)) {
+    return "internal";
+  }
+  if (context.userId || context.orgId || context.projectId || context.installId) {
+    return "customer";
+  }
+  if (context.anonymousId) {
+    return "anonymous";
+  }
+  return "service";
+}
+function matchesInternalActor(context, options) {
+  return idListHas(options.internalAnonymousIds, context.anonymousId) || idListHas(options.internalInstallIds, context.installId) || idListHas(options.internalOrgIds, context.orgId) || idListHas(options.internalProjectIds, context.projectId) || idListHas(options.internalUserIds, context.userId);
+}
+function idListHas(values, value) {
+  if (!values || !value) return false;
+  if (typeof values.has === "function") {
+    return values.has(value);
+  }
+  return values.includes(value);
+}
 function isDecantrTelemetryEventName(value) {
   return DECANTR_TELEMETRY_EVENT_NAMES.includes(value);
 }
 export {
+  DECANTR_TELEMETRY_ACTOR_TYPES,
   DECANTR_TELEMETRY_EVENT_NAMES,
   DECANTR_TELEMETRY_SCHEMA_VERSION,
-  isDecantrTelemetryEventName
+  isDecantrTelemetryEventName,
+  isTelemetryActorType,
+  resolveTelemetryActorType
 };
 //# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/events.ts"],"sourcesContent":["export const DECANTR_TELEMETRY_SCHEMA_VERSION = '0.1.0';\n\nexport type TelemetrySource = 'api' | 'cli' | 'content-ci' | 'mcp' | 'registry-web';\nexport type TelemetryEnvironment = 'development' | 'preview' | 'production' | 'test';\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  'org.created',\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  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 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 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<'org.created', ProductEventProperties>\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"],"mappings":";AAAO,IAAM,mCAAmC;AAgBzC,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;AACF;AA0JO,SAAS,4BAA4B,OAAmD;AAC7F,SAAQ,8BAAoD,SAAS,KAAK;AAC5E;","names":[]}
+{"version":3,"sources":["../src/events.ts"],"sourcesContent":["export const DECANTR_TELEMETRY_SCHEMA_VERSION = '0.1.0';\n\nexport type TelemetrySource = 'api' | 'cli' | 'content-ci' | 'mcp' | '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  '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 RegistryWebPageViewedProperties extends TelemetryProperties {\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 TelemetryProperties {\n  contentType?: string;\n  queryLength: number;\n  resultCount?: number;\n  sort?: string;\n  sourceFilter?: string;\n  surface: string;\n}\n\nexport interface RegistryWebContentOpenedProperties extends TelemetryProperties {\n  contentSource?: string;\n  contentType: string;\n  namespace?: string;\n  slug?: string;\n  surface: string;\n}\n\nexport interface RegistryWebCommercialPageViewedProperties extends TelemetryProperties {\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<'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"],"mappings":";AAAO,IAAM,mCAAmC;AAIzC,IAAM,gCAAgC;AAAA,EAC3C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAcO,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;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;AAuKO,SAAS,4BAA4B,OAAmD;AAC7F,SAAQ,8BAAoD,SAAS,KAAK;AAC5E;","names":[]}

package/dist/index.d.ts

@@ -1,4 +1,4 @@
 export { FetchTelemetrySinkOptions, TelemetryClient, TelemetryClientOptions, TelemetrySink, createFetchTelemetrySink, createNoopTelemetrySink, createTelemetryClient } from './client.js';
-export { AdoptionMode, AuditCompletedProperties, CliCommandCompletedProperties, ContentPublishCompletedProperties, ContentValidationCompletedProperties, CritiqueCompletedProperties, DECANTR_TELEMETRY_EVENT_NAMES, DECANTR_TELEMETRY_SCHEMA_VERSION, DecantrTelemetryEvent, DecantrTelemetryEventName, ExecutionPackCompiledProperties, ExecutionPackSelectedProperties, ProductEventProperties, ProjectScope, RegistryItemResolvedProperties, RegistrySource, RegistrySyncCompletedProperties, TelemetryAnalysisScope, TelemetryContentType, TelemetryContext, TelemetryEnvironment, TelemetryProperties, TelemetryPropertyValue, TelemetrySource, TelemetryVisibility, WorkflowMode, isDecantrTelemetryEventName } from './events.js';
+export { AdoptionMode, AuditCompletedProperties, CliCommandCompletedProperties, ContentPublishCompletedProperties, ContentValidationCompletedProperties, CritiqueCompletedProperties, DECANTR_TELEMETRY_ACTOR_TYPES, DECANTR_TELEMETRY_EVENT_NAMES, DECANTR_TELEMETRY_SCHEMA_VERSION, DecantrTelemetryEvent, DecantrTelemetryEventName, ExecutionPackCompiledProperties, ExecutionPackSelectedProperties, ProductEventProperties, ProjectScope, RegistryItemResolvedProperties, RegistrySource, RegistrySyncCompletedProperties, RegistryWebCommercialPageViewedProperties, RegistryWebContentOpenedProperties, RegistryWebPageViewedProperties, RegistryWebSearchPerformedProperties, TelemetryActorResolutionOptions, TelemetryActorType, TelemetryAnalysisScope, TelemetryContentType, TelemetryContext, TelemetryEnvironment, TelemetryProperties, TelemetryPropertyValue, TelemetrySource, TelemetryVisibility, WorkflowMode, isDecantrTelemetryEventName, isTelemetryActorType, 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,12 @@
 // src/events.ts
 var DECANTR_TELEMETRY_SCHEMA_VERSION = "0.1.0";
+var DECANTR_TELEMETRY_ACTOR_TYPES = [
+  "anonymous",
+  "customer",
+  "internal",
+  "official_pipeline",
+  "service"
+];
 var DECANTR_TELEMETRY_EVENT_NAMES = [
   "api_key.created",
   "audit.completed",
@@ -10,10 +17,47 @@ var DECANTR_TELEMETRY_EVENT_NAMES = [
   "execution_pack.compiled",
   "execution_pack.selected",
   "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"
 ];
+function isTelemetryActorType(value) {
+  return typeof value === "string" && DECANTR_TELEMETRY_ACTOR_TYPES.includes(value);
+}
+function resolveTelemetryActorType(context, options = {}) {
+  if (context.actorType) return context.actorType;
+  if (context.source === "content-ci") {
+    return "official_pipeline";
+  }
+  if (matchesInternalActor(context, options)) {
+    return "internal";
+  }
+  if (context.userId || context.orgId || context.projectId || context.installId) {
+    return "customer";
+  }
+  if (context.anonymousId) {
+    return "anonymous";
+  }
+  return "service";
+}
+function matchesInternalActor(context, options) {
+  return idListHas(options.internalAnonymousIds, context.anonymousId) || idListHas(options.internalInstallIds, context.installId) || idListHas(options.internalOrgIds, context.orgId) || idListHas(options.internalProjectIds, context.projectId) || idListHas(options.internalUserIds, context.userId);
+}
+function idListHas(values, value) {
+  if (!values || !value) return false;
+  if (typeof values.has === "function") {
+    return values.has(value);
+  }
+  return values.includes(value);
+}
 function isDecantrTelemetryEventName(value) {
   return DECANTR_TELEMETRY_EVENT_NAMES.includes(value);
 }
@@ -223,6 +267,12 @@ function toPostHogProperties(event, options) {
     ...event.properties,
     $groups: groups,
     $process_person_profile: options.processPersonProfile ?? false,
+    decantr_anonymous_id: event.context.anonymousId ?? null,
+    decantr_actor_type: resolveTelemetryActorType(event.context),
+    decantr_install_id: event.context.installId ?? null,
+    decantr_org_id: event.context.orgId ?? null,
+    decantr_project_id: event.context.projectId ?? null,
+    decantr_session_id: event.context.sessionId ?? null,
     decantr_schema_version: DECANTR_TELEMETRY_SCHEMA_VERSION,
     decantr_source: event.context.source,
     decantr_environment: event.context.environment ?? "production",
@@ -233,6 +283,7 @@ function toPostHogProperties(event, options) {
   };
 }
 export {
+  DECANTR_TELEMETRY_ACTOR_TYPES,
   DECANTR_TELEMETRY_EVENT_NAMES,
   DECANTR_TELEMETRY_SCHEMA_VERSION,
   REDACTED_VALUE,
@@ -242,6 +293,8 @@ export {
   createTelemetryClient,
   isDecantrTelemetryEventName,
   isSensitiveTelemetryKey,
+  isTelemetryActorType,
+  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.1.0';\n\nexport type TelemetrySource = 'api' | 'cli' | 'content-ci' | 'mcp' | 'registry-web';\nexport type TelemetryEnvironment = 'development' | 'preview' | 'production' | 'test';\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  'org.created',\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  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 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 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<'org.created', ProductEventProperties>\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","import type { TelemetrySink } from './client.js';\nimport {\n  DECANTR_TELEMETRY_SCHEMA_VERSION,\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 = (options.host ?? 'https://us.i.posthog.com').replace(/\\/+$/, '');\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 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_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.1.0';\n\nexport type TelemetrySource = 'api' | 'cli' | 'content-ci' | 'mcp' | '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  '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 RegistryWebPageViewedProperties extends TelemetryProperties {\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 TelemetryProperties {\n  contentType?: string;\n  queryLength: number;\n  resultCount?: number;\n  sort?: string;\n  sourceFilter?: string;\n  surface: string;\n}\n\nexport interface RegistryWebContentOpenedProperties extends TelemetryProperties {\n  contentSource?: string;\n  contentType: string;\n  namespace?: string;\n  slug?: string;\n  surface: string;\n}\n\nexport interface RegistryWebCommercialPageViewedProperties extends TelemetryProperties {\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<'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","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 = (options.host ?? 'https://us.i.posthog.com').replace(/\\/+$/, '');\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 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,31 @@
 // src/events.ts
 var DECANTR_TELEMETRY_SCHEMA_VERSION = "0.1.0";
+function resolveTelemetryActorType(context, options = {}) {
+  if (context.actorType) return context.actorType;
+  if (context.source === "content-ci") {
+    return "official_pipeline";
+  }
+  if (matchesInternalActor(context, options)) {
+    return "internal";
+  }
+  if (context.userId || context.orgId || context.projectId || context.installId) {
+    return "customer";
+  }
+  if (context.anonymousId) {
+    return "anonymous";
+  }
+  return "service";
+}
+function matchesInternalActor(context, options) {
+  return idListHas(options.internalAnonymousIds, context.anonymousId) || idListHas(options.internalInstallIds, context.installId) || idListHas(options.internalOrgIds, context.orgId) || idListHas(options.internalProjectIds, context.projectId) || idListHas(options.internalUserIds, context.userId);
+}
+function idListHas(values, value) {
+  if (!values || !value) return false;
+  if (typeof values.has === "function") {
+    return values.has(value);
+  }
+  return values.includes(value);
+}
 
 // src/posthog.ts
 function createPostHogTelemetrySink(options) {
@@ -48,6 +74,12 @@ function toPostHogProperties(event, options) {
     ...event.properties,
     $groups: groups,
     $process_person_profile: options.processPersonProfile ?? false,
+    decantr_anonymous_id: event.context.anonymousId ?? null,
+    decantr_actor_type: resolveTelemetryActorType(event.context),
+    decantr_install_id: event.context.installId ?? null,
+    decantr_org_id: event.context.orgId ?? null,
+    decantr_project_id: event.context.projectId ?? null,
+    decantr_session_id: event.context.sessionId ?? null,
     decantr_schema_version: DECANTR_TELEMETRY_SCHEMA_VERSION,
     decantr_source: event.context.source,
     decantr_environment: event.context.environment ?? "production",

package/dist/posthog.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/events.ts","../src/posthog.ts"],"sourcesContent":["export const DECANTR_TELEMETRY_SCHEMA_VERSION = '0.1.0';\n\nexport type TelemetrySource = 'api' | 'cli' | 'content-ci' | 'mcp' | 'registry-web';\nexport type TelemetryEnvironment = 'development' | 'preview' | 'production' | 'test';\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  'org.created',\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  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 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 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<'org.created', ProductEventProperties>\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 { TelemetrySink } from './client.js';\nimport {\n  DECANTR_TELEMETRY_SCHEMA_VERSION,\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 = (options.host ?? 'https://us.i.posthog.com').replace(/\\/+$/, '');\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 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_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":";AAAO,IAAM,mCAAmC;;;ACezC,SAAS,2BAA2B,SAAqD;AAC9F,QAAM,QAAQ,QAAQ,QAAQ,4BAA4B,QAAQ,QAAQ,EAAE;AAC5E,QAAM,YAAY,QAAQ,SAAS,WAAW;AAE9C,SAAO;AAAA,IACL,MAAM,QAAQ,OAAO;AACnB,YAAM,aAAa,kBAAkB,KAAK;AAC1C,UAAI,CAAC,YAAY;AACf,cAAM,IAAI;AAAA,UACR;AAAA,QACF;AAAA,MACF;AAEA,YAAM,aAAa,IAAI,gBAAgB;AACvC,YAAM,UAAU,WAAW,MAAM,WAAW,MAAM,GAAG,QAAQ,aAAa,GAAI;AAE9E,UAAI;AACF,cAAM,WAAW,MAAM,UAAU,GAAG,IAAI,YAAY;AAAA,UAClD,QAAQ;AAAA,UACR,SAAS,EAAE,gBAAgB,mBAAmB;AAAA,UAC9C,MAAM,KAAK,UAAU;AAAA,YACnB,SAAS,QAAQ;AAAA,YACjB,OAAO,MAAM;AAAA,YACb,aAAa;AAAA,YACb,YAAY,oBAAoB,OAAO,OAAO;AAAA,YAC9C,WAAW,MAAM;AAAA,UACnB,CAAC;AAAA,UACD,QAAQ,WAAW;AAAA,QACrB,CAAC;AAED,YAAI,CAAC,SAAS,IAAI;AAChB,gBAAM,IAAI,MAAM,iCAAiC,SAAS,MAAM,GAAG;AAAA,QACrE;AAAA,MACF,UAAE;AACA,qBAAa,OAAO;AAAA,MACtB;AAAA,IACF;AAAA,EACF;AACF;AAEA,SAAS,kBAAkB,OAAkD;AAC3E,SACE,MAAM,QAAQ,UACd,MAAM,QAAQ,aACd,MAAM,QAAQ,aACd,MAAM,QAAQ;AAElB;AAEA,SAAS,oBACP,OACA,SACqB;AACrB,QAAM,SAAiC,CAAC;AACxC,MAAI,MAAM,QAAQ,MAAO,QAAO,eAAe,MAAM,QAAQ;AAC7D,MAAI,MAAM,QAAQ,UAAW,QAAO,UAAU,MAAM,QAAQ;AAE5D,SAAO;AAAA,IACL,GAAG,MAAM;AAAA,IACT,SAAS;AAAA,IACT,yBAAyB,QAAQ,wBAAwB;AAAA,IACzD,wBAAwB;AAAA,IACxB,gBAAgB,MAAM,QAAQ;AAAA,IAC9B,qBAAqB,MAAM,QAAQ,eAAe;AAAA,IAClD,iBAAiB,MAAM,QAAQ,kBAAkB;AAAA,IACjD,iBAAiB,MAAM,QAAQ,kBAAkB;AAAA,IACjD,cAAc,MAAM,QAAQ,eAAe;AAAA,IAC3C,iBAAiB,MAAM,QAAQ,kBAAkB;AAAA,EACnD;AACF;","names":[]}
+{"version":3,"sources":["../src/events.ts","../src/posthog.ts"],"sourcesContent":["export const DECANTR_TELEMETRY_SCHEMA_VERSION = '0.1.0';\n\nexport type TelemetrySource = 'api' | 'cli' | 'content-ci' | 'mcp' | '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  '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 RegistryWebPageViewedProperties extends TelemetryProperties {\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 TelemetryProperties {\n  contentType?: string;\n  queryLength: number;\n  resultCount?: number;\n  sort?: string;\n  sourceFilter?: string;\n  surface: string;\n}\n\nexport interface RegistryWebContentOpenedProperties extends TelemetryProperties {\n  contentSource?: string;\n  contentType: string;\n  namespace?: string;\n  slug?: string;\n  surface: string;\n}\n\nexport interface RegistryWebCommercialPageViewedProperties extends TelemetryProperties {\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<'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 { 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 = (options.host ?? 'https://us.i.posthog.com').replace(/\\/+$/, '');\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 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decantr/telemetry",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Privacy-preserving telemetry contracts, clients, and analytics sinks for Decantr",
   "author": "Decantr AI",
   "license": "MIT",