@debugbundle/sdk-react-native 3.0.0 → 3.1.0

package/dist/safe-error-fields.js

@@ -0,0 +1,54 @@
+/** Read primitive native error fields without calling application accessors. */
+const nativePrototypes = new Set([Error.prototype, TypeError.prototype, RangeError.prototype, ReferenceError.prototype,
+    SyntaxError.prototype, URIError.prototype, EvalError.prototype, ...(typeof AggregateError === "function" ? [AggregateError.prototype] : [])]);
+const brandDescriptor = Object.getOwnPropertyDescriptor(Error, "isError");
+export const nativeBrand = brandDescriptor && "value" in brandDescriptor && typeof brandDescriptor.value === "function"
+    ? brandDescriptor.value : undefined;
+let nativeStackGetter;
+export function errorField(value, key) {
+    const own = Object.getOwnPropertyDescriptor(value, key);
+    if (own)
+        return "value" in own ? own.value : undefined;
+    let prototype = Object.getPrototypeOf(value);
+    for (let depth = 0; prototype && depth < 4; depth++) {
+        if (!nativePrototypes.has(prototype))
+            return undefined;
+        const descriptor = Object.getOwnPropertyDescriptor(prototype, key);
+        if (descriptor)
+            return "value" in descriptor ? descriptor.value : undefined;
+        prototype = Object.getPrototypeOf(prototype);
+    }
+    return undefined;
+}
+export function safeErrorStack(value) {
+    let prototype = Object.getPrototypeOf(value);
+    for (let depth = 0; prototype && depth < 4; depth++) {
+        if (!nativePrototypes.has(prototype) && prototype !== Object.prototype)
+            return undefined;
+        for (const key of ["name", "message"]) {
+            const descriptor = Object.getOwnPropertyDescriptor(prototype, key);
+            if (descriptor && (!("value" in descriptor) || typeof descriptor.value !== "string" || descriptor.value.length > 8192))
+                return undefined;
+        }
+        prototype = Object.getPrototypeOf(prototype);
+    }
+    for (const key of ["name", "message"]) {
+        const descriptor = Object.getOwnPropertyDescriptor(value, key);
+        if (descriptor && (!("value" in descriptor) || typeof descriptor.value !== "string" || descriptor.value.length > 8192))
+            return undefined;
+    }
+    const formatter = Object.getOwnPropertyDescriptor(Error, "prepareStackTrace");
+    const limit = Object.getOwnPropertyDescriptor(Error, "stackTraceLimit");
+    if (formatter && (!("value" in formatter) || formatter.value !== undefined) ||
+        limit && (!("value" in limit) || typeof limit.value !== "number" || limit.value < 0 || limit.value > 64))
+        return undefined;
+    const descriptor = Object.getOwnPropertyDescriptor(value, "stack");
+    if (descriptor && "value" in descriptor)
+        return descriptor.value;
+    if (descriptor?.get && nativeBrand?.(value)) {
+        nativeStackGetter ??= Object.getOwnPropertyDescriptor(new Error(), "stack")?.get;
+        if (descriptor.get === nativeStackGetter)
+            return descriptor.get.call(value);
+    }
+    return undefined;
+}

package/dist/types.d.ts

@@ -17,6 +17,9 @@ export interface DebugBundleConfig {
     maxEventsPerSession?: number;
     maxBreadcrumbs?: number;
     captureErrors?: boolean;
+    captureExceptionEvidence?: boolean;
+    captureRecoveryObservations?: boolean;
+    evidenceCapabilities?: EvidenceCapabilities;
     captureUnhandledRejections?: boolean;
     captureScreens?: boolean;
     captureActions?: boolean;
@@ -54,6 +57,9 @@ export interface ResolvedDebugBundleConfig {
     maxEventsPerSession: number;
     maxBreadcrumbs: number;
     captureErrors: boolean;
+    captureExceptionEvidence: boolean;
+    captureRecoveryObservations: boolean;
+    evidenceCapabilities: EvidenceCapabilities | null;
     captureUnhandledRejections: boolean;
     captureScreens: boolean;
     captureActions: boolean;
@@ -94,26 +100,28 @@ export interface DebugBundleResponseInfo {
     headers?: Record<string, string>;
 }
 export interface DebugBundleCaptureContext {
+    failureRef?: string;
+    evidenceScope?: EvidenceScope;
     [key: string]: unknown;
 }
 export interface DebugBundleProbeOptions {
     heavy?: boolean;
 }
 export interface DebugBundleEventEnvelope {
-    schema_version: "2026-03-01";
+    schema_version: string;
     event_id: string;
-    event_type: "frontend_exception" | "frontend_breadcrumb" | "log_event" | "request_event" | "error_suppressed" | "probe_event";
-    sdk_name: "@debugbundle/sdk-react-native";
+    event_type: "frontend_exception" | "backend_exception" | "diagnostic_context" | "deploy_metadata" | "frontend_breadcrumb" | "log_event" | "request_event" | "error_suppressed" | "probe_event";
+    sdk_name: string;
     sdk_version: string;
     service: {
         name: string;
         environment: string;
-        runtime: "react-native";
-        framework: "react-native";
+        runtime?: string | null;
+        framework?: string | null;
     };
     occurred_at: string;
     correlation?: {
-        trace_id: string | null;
+        trace_id?: string | null;
         request_id?: string | null;
         session_id?: string | null;
         user_id_hash?: string | null;
@@ -124,6 +132,10 @@ export interface DebugBundleEventEnvelope {
 export interface DebugBundleClient {
     readonly status: DebugBundleStatus;
     readonly lastEventAt: number | null;
+    readonly evidenceCapabilities?: EvidenceCapabilities;
+    beginOperation?(): OperationScope;
+    withOperationContext?<T>(operation: (scope: OperationScope) => T): T;
+    captureRecovery?(observation: RecoveryObservation): void;
     init(config: DebugBundleConfig): void;
     captureException(error: unknown, context?: DebugBundleCaptureContext): void;
     captureError(error: unknown, context?: DebugBundleCaptureContext): void;
@@ -140,6 +152,7 @@ export interface DebugBundleClient {
 export interface NativeDebugBundleModule {
     initialize(config: NativeDebugBundleConfig): Promise<NativeDebugBundleState> | NativeDebugBundleState;
     enqueueCanonicalEvent?(event: DebugBundleEventEnvelope): Promise<boolean | void> | boolean | void;
+    enqueueCanonicalEventJson?(event: string): Promise<boolean | void> | boolean | void;
     /** Compatibility fallback implemented by native binaries released before the canonical bridge. */
     enqueueEvent(event: DebugBundleEventEnvelope): Promise<void> | void;
     captureProbe?(label: string, data: unknown, occurredAt: string): Promise<boolean> | boolean;
@@ -157,7 +170,9 @@ export interface NativeDebugBundleState {
     status: DebugBundleStatus;
     lastEventAt?: number | null;
     device?: Record<string, unknown> | null;
+    evidenceCapabilities?: unknown;
     nativeModuleAvailable?: boolean;
     degradedReason?: string | null;
 }
+import type { EvidenceCapabilities, EvidenceScope, OperationScope, RecoveryObservation } from "./evidence-types.js";
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/ios/DebugBundleReactNative.swift

@@ -4,7 +4,7 @@ import DebugBundle
 
 @objc(DebugBundleReactNative)
 final class DebugBundleReactNative: NSObject {
-	private var currentSDKVersion = "3.0.0"
+	private var currentSDKVersion = "3.1.0"
 	private var currentService = "react-native-app"
 	private var currentEnvironment = "production"
 
@@ -14,7 +14,7 @@ final class DebugBundleReactNative: NSObject {
 		resolver resolve: @escaping RCTPromiseResolveBlock,
 		rejecter reject: @escaping RCTPromiseRejectBlock
 	) {
-		currentSDKVersion = config["sdkVersion"] as? String ?? "3.0.0"
+		currentSDKVersion = config["sdkVersion"] as? String ?? "3.1.0"
 		currentService = config["service"] as? String ?? "react-native-app"
 		currentEnvironment = config["environment"] as? String ?? "production"
 		let sdkConfig = DebugBundleConfig(
@@ -48,7 +48,11 @@ final class DebugBundleReactNative: NSObject {
 			redactFields: stringSet(config["redactFields"], fallback: DebugBundleConfig.defaultRedactFields),
 			headerAllowlist: stringSet(config["headerAllowlist"], fallback: DebugBundleConfig.defaultHeaderAllowlist),
 			sdkVersion: currentSDKVersion
-		)
+		).withEvidenceOptions(DebugBundleEvidenceOptions(
+			captureExceptionEvidence: config["captureExceptionEvidence"] as? Bool ?? true,
+			captureRecoveryObservations: config["captureRecoveryObservations"] as? Bool ?? false,
+			evidenceCapabilities: evidenceCapabilities(config["evidenceCapabilities"])
+		))
 		DebugBundle.initialize(sdkConfig, transport: DebugBundleHTTPTransport())
 		resolve(state())
 	}
@@ -62,6 +66,22 @@ final class DebugBundleReactNative: NSObject {
 		resolve(DebugBundle.captureExternalEvent(dictionary(event)))
 	}
 
+	@objc(enqueueCanonicalEventJson:resolve:reject:)
+	func enqueueCanonicalEventJson(
+		_ event: String,
+		resolver resolve: @escaping RCTPromiseResolveBlock,
+		rejecter reject: @escaping RCTPromiseRejectBlock
+	) {
+		// TurboModule's NSDictionary conversion drops nested nulls before Swift sees
+		// them. Decode only bounded JSON bytes, then use the same native admission path.
+		guard let data = boundedEventJSON(event),
+			let object = try? JSONSerialization.jsonObject(with: data) as? NSDictionary else {
+			resolve(false)
+			return
+		}
+		resolve(DebugBundle.captureExternalEvent(dictionary(object)))
+	}
+
 	@objc(enqueueEvent:resolve:reject:)
 	func enqueueEvent(
 		_ event: NSDictionary,
@@ -177,11 +197,45 @@ final class DebugBundleReactNative: NSObject {
 		[
 			"status": DebugBundle.status.rawValue,
 			"lastEventAt": DebugBundle.lastEventAt.map { $0.timeIntervalSince1970 * 1000 } ?? NSNull(),
-			"nativeModuleAvailable": true
+			"nativeModuleAvailable": true,
+			"evidenceCapabilities": ["version": DebugBundle.evidenceCapabilities.version, "features": DebugBundle.evidenceCapabilities.features]
 		]
 	}
 }
 
+private func evidenceCapabilities(_ value: Any?) -> DebugBundleEvidenceCapabilities? {
+	guard let value, !(value is NSNull) else { return nil }
+	guard let descriptor = value as? [String: Any], Set(descriptor.keys) == Set(["version", "features"]),
+		let features = descriptor["features"] as? [String], features.count <= 4,
+		features.allSatisfy({ $0.utf8.prefix(65).count <= 64 }),
+		let data = try? JSONSerialization.data(withJSONObject: descriptor), data.count <= 512,
+		let decoded = try? JSONDecoder().decode(DebugBundleEvidenceCapabilities.self, from: data) else {
+		return DebugBundleEvidenceCapabilities()
+	}
+	return decoded
+}
+
+private func boundedEventJSON(_ value: String) -> Data? {
+	guard value.utf8.prefix(65_537).count <= 65_536 else { return nil }
+	var depth = 0, quoted = false, escaped = false
+	for byte in value.utf8 {
+		if quoted {
+			if escaped { escaped = false }
+			else if byte == 92 { escaped = true }
+			else if byte == 34 { quoted = false }
+		} else if byte == 34 { quoted = true }
+		else if byte == 123 || byte == 91 {
+			depth += 1
+			if depth > 17 { return nil }
+		} else if byte == 125 || byte == 93 {
+			depth -= 1
+			if depth < 0 { return nil }
+		}
+	}
+	guard depth == 0, !quoted else { return nil }
+	return value.data(using: .utf8)
+}
+
 private func dictionary(_ value: NSDictionary) -> [String: Any?] {
 	var result: [String: Any?] = [:]
 	for (rawKey, rawValue) in value {

package/ios/DebugBundleReactNativeBridge.mm

@@ -24,6 +24,10 @@ RCT_EXTERN_METHOD(enqueueCanonicalEvent:(NSDictionary *)event
                   resolve:(RCTPromiseResolveBlock)resolve
                   reject:(RCTPromiseRejectBlock)reject)
 
+RCT_EXTERN_METHOD(enqueueCanonicalEventJson:(NSString *)event
+                  resolve:(RCTPromiseResolveBlock)resolve
+                  reject:(RCTPromiseRejectBlock)reject)
+
 RCT_EXTERN_METHOD(flush:(RCTPromiseResolveBlock)resolve
                   reject:(RCTPromiseRejectBlock)reject)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@debugbundle/sdk-react-native",
-  "version": "3.0.0",
+  "version": "3.1.0",
   "description": "React Native SDK for DebugBundle mobile event capture.",
   "license": "Apache-2.0",
   "type": "module",
@@ -49,7 +49,8 @@
     "DebugBundleReactNative.podspec",
     "CHANGELOG.md",
     "README.md",
-    "MIGRATION-3.0.md"
+    "MIGRATION-3.0.md",
+    "MIGRATION-3.1.md"
   ],
   "exports": {
     "./package.json": "./package.json",

package/src/NativeDebugBundleReactNative.ts

@@ -5,6 +5,7 @@ import { TurboModuleRegistry } from "react-native";
 export interface Spec extends TurboModule {
   initialize(config: UnsafeObject): Promise<UnsafeObject>;
   enqueueCanonicalEvent?(event: UnsafeObject): Promise<boolean>;
+  enqueueCanonicalEventJson?(event: string): Promise<boolean>;
   enqueueEvent(event: UnsafeObject): Promise<void>;
   captureProbe?(label: string, data: UnsafeObject, occurredAt: string): Promise<boolean>;
   isProbeActive?(label: string): boolean;

package/src/before-send.ts

@@ -1,178 +1,14 @@
 import type { DebugBundleBeforeSend, DebugBundleEventEnvelope } from "./types.js";
+import { canonicalEvent } from "./evidence-wire.js";
+import { EventValidationUnavailable, ownJSON } from "./owned-json.js";
 
-const ROOT_KEYS = new Set([
-  "schema_version",
-  "event_id",
-  "event_type",
-  "sdk_name",
-  "sdk_version",
-  "service",
-  "occurred_at",
-  "correlation",
-  "context",
-  "payload"
-]);
-
-const REQUIRED_PAYLOAD_FIELDS: Record<DebugBundleEventEnvelope["event_type"], string[]> = {
-  frontend_exception: ["name", "message", "stack"],
-  frontend_breadcrumb: ["breadcrumb_type", "data"],
-  log_event: ["level", "message", "attributes"],
-  request_event: ["method", "path", "query", "headers", "response_status", "duration_ms"],
-  error_suppressed: ["fingerprint", "suppressed_count", "window_seconds", "first_seen", "last_seen"],
-  probe_event: ["label", "data", "activation_id", "probe_label_pattern"]
-};
-const ALLOWED_PAYLOAD_FIELDS: Record<DebugBundleEventEnvelope["event_type"], Set<string>> = {
-  frontend_exception: new Set([
-    "name", "message", "stack", "route", "browser", "breadcrumbs", "device",
-    "browser_event", "rejection_reason", "dom_context", "probe_data"
-  ]),
-  frontend_breadcrumb: new Set(["breadcrumb_type", "route", "data", "device"]),
-  log_event: new Set(["level", "message", "attributes", "device"]),
-  request_event: new Set([
-    "method", "path", "query", "headers", "body", "response_status", "duration_ms",
-    "route_template", "response_headers", "response_body", "device"
-  ]),
-  error_suppressed: new Set([
-    "fingerprint", "suppressed_count", "window_seconds", "first_seen", "last_seen", "device"
-  ]),
-  probe_event: new Set(["label", "data", "activation_id", "probe_label_pattern", "device"])
-};
-
-const EVENT_TYPES = new Set(Object.keys(REQUIRED_PAYLOAD_FIELDS));
-const UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
-
-export function applyBeforeSend(
-  event: DebugBundleEventEnvelope,
-  hook: DebugBundleBeforeSend | null
-): DebugBundleEventEnvelope | null {
-  if (!hook) {
-    return event;
-  }
+export function applyBeforeSend(event: DebugBundleEventEnvelope, hook: DebugBundleBeforeSend | null): DebugBundleEventEnvelope | null {
+  if (!hook) return event;
   try {
-    const result = hook(cloneEvent(event));
-    // Hooks have synchronous return contracts. Contain mistaken async failures
-    // before treating their Promise as invalid and keeping the protected original.
-    if (result instanceof Promise) {
-      void result.catch(() => undefined);
-      return event;
-    }
-    if (result === null) {
-      return null;
-    }
-    return isValidEvent(result) ? result : event;
-  } catch {
-    return event;
-  }
-}
-
-function cloneEvent(event: DebugBundleEventEnvelope): DebugBundleEventEnvelope {
-  return JSON.parse(JSON.stringify(event)) as DebugBundleEventEnvelope;
-}
-
-function isValidEvent(event: unknown): event is DebugBundleEventEnvelope {
-  if (!isRecord(event) || !Object.keys(event).every((key) => ROOT_KEYS.has(key))) {
-    return false;
-  }
-  if (
-    event.schema_version !== "2026-03-01" ||
-    !UUID_PATTERN.test(stringValue(event.event_id)) ||
-    !EVENT_TYPES.has(stringValue(event.event_type)) ||
-    event.sdk_name !== "@debugbundle/sdk-react-native" ||
-    !nonEmptyString(event.sdk_version) ||
-    !isIsoTimestamp(event.occurred_at) ||
-    !isRecord(event.service) ||
-    !nonEmptyString(event.service.name) ||
-    !nonEmptyString(event.service.environment) ||
-    event.service.runtime !== "react-native" ||
-    event.service.framework !== "react-native" ||
-    !isRecord(event.payload)
-  ) {
-    return false;
-  }
-  const eventType = event.event_type as DebugBundleEventEnvelope["event_type"];
-  return (
-    REQUIRED_PAYLOAD_FIELDS[eventType].every((field) =>
-      Object.prototype.hasOwnProperty.call(event.payload, field)
-    ) &&
-    Object.keys(event.payload).every((field) => ALLOWED_PAYLOAD_FIELDS[eventType].has(field)) &&
-    hasValidPayloadShape(eventType, event.payload)
-  );
-}
-
-function hasValidPayloadShape(
-  eventType: DebugBundleEventEnvelope["event_type"],
-  payload: Record<string, unknown>
-): boolean {
-  switch (eventType) {
-    case "frontend_exception":
-      return (
-        hasNonEmptyStrings(payload, "name", "message", "stack") &&
-        (!("breadcrumbs" in payload) || Array.isArray(payload.breadcrumbs)) &&
-        optionalRecord(payload, "probe_data")
-      );
-    case "frontend_breadcrumb":
-      return hasNonEmptyStrings(payload, "breadcrumb_type") && isRecord(payload.data);
-    case "log_event":
-      return hasNonEmptyStrings(payload, "level", "message") && isRecord(payload.attributes);
-    case "request_event":
-      return (
-        hasNonEmptyStrings(payload, "method", "path") &&
-        isRecord(payload.query) &&
-        isRecord(payload.headers) &&
-        isNonNegativeNumber(payload.response_status) &&
-        isNonNegativeNumber(payload.duration_ms) &&
-        optionalRecord(payload, "response_headers")
-      );
-    case "error_suppressed":
-      return (
-        hasNonEmptyStrings(payload, "fingerprint") &&
-        isNonNegativeInteger(payload.suppressed_count) &&
-        isPositiveInteger(payload.window_seconds) &&
-        isIsoTimestamp(payload.first_seen) &&
-        isIsoTimestamp(payload.last_seen)
-      );
-    case "probe_event":
-      return (
-        hasNonEmptyStrings(payload, "label", "probe_label_pattern") &&
-        isRecord(payload.data) &&
-        (payload.activation_id === null ||
-          nonEmptyString(payload.activation_id) && UUID_PATTERN.test(payload.activation_id))
-      );
-  }
-}
-
-function hasNonEmptyStrings(payload: Record<string, unknown>, ...fields: string[]): boolean {
-  return fields.every((field) => nonEmptyString(payload[field]));
-}
-
-function optionalRecord(payload: Record<string, unknown>, field: string): boolean {
-  return !(field in payload) || isRecord(payload[field]);
-}
-
-function isNonNegativeNumber(value: unknown): boolean {
-  return typeof value === "number" && Number.isFinite(value) && value >= 0;
-}
-
-function isNonNegativeInteger(value: unknown): boolean {
-  return Number.isInteger(value) && (value as number) >= 0;
-}
-
-function isPositiveInteger(value: unknown): boolean {
-  return Number.isInteger(value) && (value as number) > 0;
-}
-
-function isRecord(value: unknown): value is Record<string, unknown> {
-  return Boolean(value && typeof value === "object" && !Array.isArray(value));
-}
-
-function nonEmptyString(value: unknown): value is string {
-  return typeof value === "string" && value.trim().length > 0;
-}
-
-function stringValue(value: unknown): string {
-  return typeof value === "string" ? value : "";
-}
-
-function isIsoTimestamp(value: unknown): boolean {
-  return nonEmptyString(value) && Number.isFinite(Date.parse(value));
+    const result = hook(JSON.parse(JSON.stringify(event)) as DebugBundleEventEnvelope);
+    if (result instanceof Promise) { void result.catch(() => undefined); return event; }
+    if (result === null) return null;
+    const owned = ownJSON(result);
+    return canonicalEvent(owned) ? owned as unknown as DebugBundleEventEnvelope : event;
+  } catch (error) { return error instanceof EventValidationUnavailable ? null : event; }
 }

package/src/canonical-schema.ts

@@ -0,0 +1,108 @@
+import { eventSchemaData } from "./event-schema-data.js";
+import { EventValidationUnavailable, jsonObject, type OwnedJSON } from "./owned-json.js";
+
+const KEYWORDS = new Set(["$schema", "$id", "$comment", "$ref", "type", "anyOf", "const", "enum", "properties",
+  "required", "additionalProperties", "items", "minimum", "maximum", "exclusiveMinimum", "minLength", "maxLength",
+  "minItems", "maxItems", "format", "pattern"]);
+const TYPES = new Set(["null", "boolean", "number", "integer", "string", "array", "object"]);
+const choices = (value: OwnedJSON | undefined): OwnedJSON[] => value === undefined ? [] : Array.isArray(value) ? value : [value];
+
+export function canonicalTimestamp(text: string): boolean {
+  if (!/^\d{4}-\d\d-\d\dT\d\d:\d\d:\d\d(?:\.\d+)?Z$/.test(text)) return false;
+  const year = Number(text.slice(0, 4)), month = Number(text.slice(5, 7)), day = Number(text.slice(8, 10));
+  const leap = year % 4 === 0 && (year % 100 !== 0 || year % 400 === 0);
+  const days = [31, leap ? 29 : 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31];
+  return month >= 1 && month <= 12 && day >= 1 && day <= days[month - 1]! &&
+    Number(text.slice(11, 13)) < 24 && Number(text.slice(14, 16)) < 60 && Number(text.slice(17, 19)) < 60;
+}
+
+/** Small closed Draft-7 interpreter for the generated accepting contract. */
+export class CanonicalSchema {
+  private refs = new Map<string, OwnedJSON>();
+  private patterns = new Map<string, RegExp>();
+  private root: OwnedJSON;
+  constructor(schema: unknown) { this.root = schema as OwnedJSON; this.compile(this.root); }
+
+  private resolve(ref: string): OwnedJSON {
+    const cached = this.refs.get(ref);
+    if (cached !== undefined) return cached;
+    if (!ref.startsWith("#/")) throw new EventValidationUnavailable();
+    let value: OwnedJSON | undefined = this.root;
+    for (const part of ref.slice(2).split("/")) {
+      const key = part.replace(/~1/g, "/").replace(/~0/g, "~");
+      value = Array.isArray(value) ? value[Number(key)] : jsonObject(value)?.[key];
+      if (value === undefined) throw new EventValidationUnavailable();
+    }
+    this.refs.set(ref, value);
+    return value;
+  }
+
+  private compile(schema: OwnedJSON): void {
+    if (typeof schema === "boolean") return;
+    const node = jsonObject(schema);
+    if (!node || Object.keys(node).some(key => !KEYWORDS.has(key)) ||
+      choices(node.type).some(value => typeof value !== "string" || !TYPES.has(value)) ||
+      node.format !== undefined && !["uuid", "date-time"].includes(String(node.format))) throw new EventValidationUnavailable();
+    if (typeof node.pattern === "string") this.patterns.set(node.pattern, new RegExp(node.pattern));
+    if (typeof node.$ref === "string" && !this.refs.has(node.$ref)) this.compile(this.resolve(node.$ref));
+    for (const child of Object.values(jsonObject(node.properties) ?? {})) this.compile(child);
+    for (const child of choices(node.anyOf)) this.compile(child);
+    for (const key of ["items", "additionalProperties"]) if (node[key] !== undefined) this.compile(node[key]);
+  }
+
+  accepts(value: OwnedJSON): boolean {
+    let steps = 100_000;
+    const check = (schema: OwnedJSON, value: OwnedJSON, depth: number): boolean => {
+      if (--steps < 0 || depth > 64) throw new EventValidationUnavailable();
+      if (typeof schema === "boolean") return schema;
+      const node = jsonObject(schema);
+      if (!node) throw new EventValidationUnavailable();
+      if (typeof node.$ref === "string") return check(this.resolve(node.$ref), value, depth + 1);
+      if (Array.isArray(node.anyOf) && !node.anyOf.some(child => check(child, value, depth + 1))) return false;
+      if (node.type !== undefined && !choices(node.type).some(type => this.matches(value, type))) return false;
+      if (node.const !== undefined && node.const !== value) return false;
+      if (Array.isArray(node.enum) && !node.enum.includes(value)) return false;
+      const object = jsonObject(value);
+      if (object) {
+        if (choices(node.required).some(key => typeof key !== "string" || !Object.hasOwn(object, key))) return false;
+        const fields = jsonObject(node.properties) ?? {};
+        for (const [key, child] of Object.entries(object)) {
+          if (!check((Object.hasOwn(fields, key) ? fields[key] : undefined) ?? node.additionalProperties ?? true, child, depth + 1)) return false;
+        }
+      }
+      if (Array.isArray(value)) {
+        if (typeof node.minItems === "number" && value.length < node.minItems ||
+          typeof node.maxItems === "number" && value.length > node.maxItems) return false;
+        if (node.items !== undefined && !value.every(child => check(node.items!, child, depth + 1))) return false;
+      }
+      if (typeof value === "string") {
+        if (typeof node.minLength === "number" && value.length < node.minLength ||
+          typeof node.maxLength === "number" && value.length > node.maxLength) return false;
+        if (typeof node.pattern === "string" && !this.patterns.get(node.pattern)!.test(value)) return false;
+        if (node.format === "uuid" && !/^[\da-f]{8}-(?:[\da-f]{4}-){3}[\da-f]{12}$/i.test(value)) return false;
+        if (node.format === "date-time" && !canonicalTimestamp(value)) return false;
+      }
+      if (typeof value === "number") {
+        if (typeof node.minimum === "number" && value < node.minimum || typeof node.maximum === "number" && value > node.maximum ||
+          typeof node.exclusiveMinimum === "number" && value <= node.exclusiveMinimum) return false;
+      }
+      return true;
+    };
+    return check(this.root, value, 0);
+  }
+  private matches(value: OwnedJSON, type: OwnedJSON): boolean {
+    if (type === "integer") return typeof value === "number" && Number.isFinite(value) && Number.isInteger(value);
+    if (type === "number") return typeof value === "number" && Number.isFinite(value);
+    if (type === "null") return value === null;
+    if (type === "array") return Array.isArray(value);
+    if (type === "object") return jsonObject(value) !== null;
+    return typeof value === type;
+  }
+}
+
+let schema: CanonicalSchema | null = null;
+try { schema = new CanonicalSchema(eventSchemaData); } catch { /* Unknown generated keywords fail closed. */ }
+export function canonicalShape(value: OwnedJSON): boolean {
+  if (!schema) throw new EventValidationUnavailable();
+  return schema.accepts(value);
+}