@noego/wood 0.4.6 → 0.4.7

package/dist/tracing/trace_hub.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/tracing/trace_hub.ts"],"sourcesContent":["import { Observable, Subject } from 'rxjs';\nimport { share } from 'rxjs/operators';\n\nexport type TraceLevel = 'debug' | 'info' | 'warn' | 'error';\nexport type TraceProcess = 'main' | 'renderer' | 'test';\n\nexport type TraceInput = {\n  source: string;\n  type: string;\n  message?: string;\n  conversationId?: number | string;\n  payload?: Record<string, unknown>;\n  windowId?: string;\n  webContentsId?: number;\n  routeKey?: string;\n  harnessId?: string;\n};\n\nexport type TraceEvent = TraceInput & {\n  level: TraceLevel;\n  process: TraceProcess;\n  timestamp: string;\n  traceSeq: number;\n};\n\nexport type TraceDispatchResult = {\n  ok: boolean;\n  forwarded: boolean;\n};\n\nexport type TraceRuntimeContext = {\n  windowId?: string;\n  webContentsId?: number;\n  routeKey?: string;\n  harnessId?: string;\n};\n\nexport type TraceWaitOptions = {\n  timeoutMs?: number;\n};\n\nconst TRACE_HUB_SYMBOL = Symbol.for('@noego/wood.trace.hub');\n\nconst LEVEL_ORDER: Record<TraceLevel, number> = {\n  debug: 0,\n  info: 1,\n  warn: 2,\n  error: 3,\n};\n\nlet rendererMinLevel: TraceLevel = 'debug';\nlet rendererEnabled = false;\nlet customRendererTraceTransport: ((payload: unknown) => void) | null = null;\n\ntype GlobalWithTraceHub = typeof globalThis & {\n  [TRACE_HUB_SYMBOL]?: TraceHub;\n};\n\ntype TraceBridgeLike = Record<string, unknown> & {\n  __trace?: (payload: unknown) => void;\n};\n\ntype GlobalWithTraceBridge = typeof globalThis & {\n  __NOEGO_WOOD_BRIDGE__?: unknown;\n  wood?: unknown;\n  window?: {\n    __NOEGO_WOOD_BRIDGE__?: unknown;\n    wood?: unknown;\n  };\n};\n\nfunction normalizeTraceInput(raw: unknown): TraceInput {\n  const input = (raw ?? {}) as Partial<TraceInput> & Record<string, unknown>;\n  const source = typeof input.source === 'string' && input.source.trim().length > 0\n    ? input.source\n    : 'unknown';\n  const type = typeof input.type === 'string' && input.type.trim().length > 0\n    ? input.type\n    : 'unknown';\n  const message = typeof input.message === 'string' ? input.message : undefined;\n  const conversationId = typeof input.conversationId === 'number' || typeof input.conversationId === 'string'\n    ? input.conversationId\n    : undefined;\n  const windowId = typeof input.windowId === 'string' && input.windowId.trim().length > 0\n    ? input.windowId\n    : undefined;\n  const webContentsId = typeof input.webContentsId === 'number' && Number.isFinite(input.webContentsId)\n    ? input.webContentsId\n    : undefined;\n  const routeKey = typeof input.routeKey === 'string' && input.routeKey.trim().length > 0\n    ? input.routeKey\n    : undefined;\n  const harnessId = typeof input.harnessId === 'string' && input.harnessId.trim().length > 0\n    ? input.harnessId\n    : undefined;\n  const payload = isRecord(input.payload) ? { ...input.payload } : undefined;\n\n  return {\n    source,\n    type,\n    ...(message ? { message } : {}),\n    ...(conversationId !== undefined ? { conversationId } : {}),\n    ...(windowId !== undefined ? { windowId } : {}),\n    ...(webContentsId !== undefined ? { webContentsId } : {}),\n    ...(routeKey !== undefined ? { routeKey } : {}),\n    ...(harnessId !== undefined ? { harnessId } : {}),\n    ...(payload ? { payload } : {}),\n  };\n}\n\nfunction mergeTraceRuntimeContext(input: unknown, context: TraceRuntimeContext | undefined): TraceInput {\n  if (!context) {\n    return normalizeTraceInput(input);\n  }\n  return normalizeTraceInput({\n    ...(isRecord(input) ? input : {}),\n    ...context,\n  });\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction resolveTraceBridge(): TraceBridgeLike | null {\n  const globalObj = globalThis as GlobalWithTraceBridge;\n  const bridge = globalObj.__NOEGO_WOOD_BRIDGE__\n    ?? globalObj.window?.__NOEGO_WOOD_BRIDGE__\n    ?? globalObj.wood\n    ?? globalObj.window?.wood;\n  if (!bridge || typeof bridge !== 'object') {\n    return null;\n  }\n  return bridge as TraceBridgeLike;\n}\n\nclass TraceHub {\n  private readonly subject = new Subject<TraceEvent>();\n  private readonly shared$ = this.subject.asObservable().pipe(share());\n  private nextTraceSeq = 1;\n  private minLevels: Record<TraceProcess, TraceLevel> = {\n    main: 'debug',\n    renderer: 'debug',\n    test: 'debug',\n  };\n\n  get events$(): Observable<TraceEvent> {\n    return this.shared$;\n  }\n\n  setMinLevel(process: TraceProcess, level: TraceLevel): void {\n    this.minLevels[process] = level;\n  }\n\n  publish(process: TraceProcess, level: TraceLevel, input: unknown): TraceEvent {\n    const normalized = normalizeTraceInput(input);\n    const event: TraceEvent = {\n      ...normalized,\n      level,\n      process,\n      timestamp: new Date().toISOString(),\n      traceSeq: this.nextTraceSeq++,\n    };\n    if (LEVEL_ORDER[level] >= LEVEL_ORDER[this.minLevels[process]]) {\n      this.subject.next(event);\n    }\n    return event;\n  }\n}\n\nfunction getGlobalTraceHub(): TraceHub {\n  const globalObj = globalThis as GlobalWithTraceHub;\n  if (!globalObj[TRACE_HUB_SYMBOL]) {\n    globalObj[TRACE_HUB_SYMBOL] = new TraceHub();\n  }\n  return globalObj[TRACE_HUB_SYMBOL] as TraceHub;\n}\n\nexport function getTraceEvents$(): Observable<TraceEvent> {\n  return getGlobalTraceHub().events$;\n}\n\nexport function setMainTraceMinLevel(level: TraceLevel): void {\n  getGlobalTraceHub().setMinLevel('main', level);\n}\n\nexport function setRendererTraceMinLevel(level: TraceLevel): void {\n  rendererMinLevel = level;\n  getGlobalTraceHub().setMinLevel('renderer', level);\n}\n\nexport function setRendererTraceEnabled(enabled: boolean): void {\n  rendererEnabled = enabled;\n}\n\nexport function publishMainTrace(level: TraceLevel, input: unknown): TraceEvent {\n  return getGlobalTraceHub().publish('main', level, input);\n}\n\nexport function publishTestTrace(process: TraceProcess, level: TraceLevel, input: unknown): TraceEvent {\n  return getGlobalTraceHub().publish(process, level, input);\n}\n\nexport function dispatchRendererTracePayload(\n  rawPayload: unknown,\n  context?: TraceRuntimeContext,\n): TraceDispatchResult {\n  const payload = (rawPayload ?? {}) as Partial<TraceInput> & { level?: TraceLevel };\n  const level = payload.level === 'debug' || payload.level === 'info' || payload.level === 'warn' || payload.level === 'error'\n    ? payload.level\n    : 'info';\n  getGlobalTraceHub().publish('renderer', level, mergeTraceRuntimeContext(payload, context));\n  return {\n    ok: true,\n    forwarded: true,\n  };\n}\n\nexport function setRendererTraceTransport(fn: ((payload: unknown) => void) | null): void {\n  customRendererTraceTransport = fn;\n}\n\nexport function emitRendererTrace(level: TraceLevel, input: TraceInput): void {\n  if (!rendererEnabled) {\n    return;\n  }\n  if (LEVEL_ORDER[level] < LEVEL_ORDER[rendererMinLevel]) {\n    return;\n  }\n  const normalized = { ...normalizeTraceInput(input), level };\n\n  if (customRendererTraceTransport) {\n    try {\n      customRendererTraceTransport(normalized);\n      return;\n    } catch {\n      // Fall through to bridge.__trace\n    }\n  }\n\n  const bridge = resolveTraceBridge();\n  if (!bridge || typeof bridge.__trace !== 'function') {\n    return;\n  }\n  try {\n    bridge.__trace(normalized);\n  } catch {\n    // Tracing is observational and must never break the caller.\n  }\n}\n\nexport function clearTraceHubForTests(): void {\n  const globalObj = globalThis as GlobalWithTraceHub;\n  delete globalObj[TRACE_HUB_SYMBOL];\n  rendererMinLevel = 'debug';\n  rendererEnabled = false;\n  customRendererTraceTransport = null;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/tracing/trace_hub.ts"],"sourcesContent":["import { Observable, Subject } from 'rxjs';\nimport { share } from 'rxjs/operators';\nimport type {\n  WoodTraceEventSink,\n  WoodTraceEventSnapshot,\n  WoodTraceSinkDisposer,\n} from './types/wood_trace_sink.types.js';\n\nexport type StandardTraceLevel = 'debug' | 'info' | 'warn' | 'error';\nexport type TraceLevel = StandardTraceLevel | (string & {});\nexport type TraceProcess = 'main' | 'renderer' | 'test';\n\nexport type TraceInput = {\n  source: string;\n  type: string;\n  message?: string;\n  conversationId?: number | string;\n  payload?: Record<string, unknown>;\n  windowId?: string;\n  webContentsId?: number;\n  routeKey?: string;\n  harnessId?: string;\n};\n\nexport type TraceEvent = TraceInput & {\n  level: TraceLevel;\n  process: TraceProcess;\n  timestamp: string;\n  traceSeq: number;\n};\n\nexport type TraceDispatchResult = {\n  ok: boolean;\n  forwarded: boolean;\n};\n\nexport type TraceRuntimeContext = {\n  windowId?: string;\n  webContentsId?: number;\n  routeKey?: string;\n  harnessId?: string;\n};\n\nexport type TraceWaitOptions = {\n  timeoutMs?: number;\n};\n\nconst TRACE_HUB_SYMBOL = Symbol.for('@noego/wood.trace.hub');\n\nconst LEVEL_ORDER: Record<StandardTraceLevel, number> = {\n  debug: 0,\n  info: 1,\n  warn: 2,\n  error: 3,\n};\nconst CUSTOM_LEVEL_ORDER = LEVEL_ORDER.info;\n\nexport function normalizeTraceLevel(level: unknown, fallback: TraceLevel = 'info'): TraceLevel {\n  if (typeof level !== 'string') {\n    return fallback;\n  }\n\n  const normalized = level.trim().toLowerCase();\n  return normalized.length > 0 ? normalized : fallback;\n}\n\nfunction traceLevelOrder(level: TraceLevel): number {\n  return LEVEL_ORDER[level as StandardTraceLevel] ?? CUSTOM_LEVEL_ORDER;\n}\n\nlet rendererMinLevel: TraceLevel = 'debug';\nlet rendererEnabled = false;\nlet customRendererTraceTransport: ((payload: unknown) => void) | null = null;\n\ntype GlobalWithTraceHub = typeof globalThis & {\n  [TRACE_HUB_SYMBOL]?: TraceHub;\n};\n\ntype TraceBridgeLike = Record<string, unknown> & {\n  __trace?: (payload: unknown) => void;\n};\n\ntype GlobalWithTraceBridge = typeof globalThis & {\n  __NOEGO_WOOD_BRIDGE__?: unknown;\n  wood?: unknown;\n  window?: {\n    __NOEGO_WOOD_BRIDGE__?: unknown;\n    wood?: unknown;\n  };\n};\n\nfunction normalizeTraceInput(raw: unknown): TraceInput {\n  const input = (raw ?? {}) as Partial<TraceInput> & Record<string, unknown>;\n  const source = typeof input.source === 'string' && input.source.trim().length > 0\n    ? input.source\n    : 'unknown';\n  const type = typeof input.type === 'string' && input.type.trim().length > 0\n    ? input.type\n    : 'unknown';\n  const message = typeof input.message === 'string' ? input.message : undefined;\n  const conversationId = typeof input.conversationId === 'number' || typeof input.conversationId === 'string'\n    ? input.conversationId\n    : undefined;\n  const windowId = typeof input.windowId === 'string' && input.windowId.trim().length > 0\n    ? input.windowId\n    : undefined;\n  const webContentsId = typeof input.webContentsId === 'number' && Number.isFinite(input.webContentsId)\n    ? input.webContentsId\n    : undefined;\n  const routeKey = typeof input.routeKey === 'string' && input.routeKey.trim().length > 0\n    ? input.routeKey\n    : undefined;\n  const harnessId = typeof input.harnessId === 'string' && input.harnessId.trim().length > 0\n    ? input.harnessId\n    : undefined;\n  const payload = isRecord(input.payload) ? { ...input.payload } : undefined;\n\n  return {\n    source,\n    type,\n    ...(message ? { message } : {}),\n    ...(conversationId !== undefined ? { conversationId } : {}),\n    ...(windowId !== undefined ? { windowId } : {}),\n    ...(webContentsId !== undefined ? { webContentsId } : {}),\n    ...(routeKey !== undefined ? { routeKey } : {}),\n    ...(harnessId !== undefined ? { harnessId } : {}),\n    ...(payload ? { payload } : {}),\n  };\n}\n\nfunction mergeTraceRuntimeContext(input: unknown, context: TraceRuntimeContext | undefined): TraceInput {\n  if (!context) {\n    return normalizeTraceInput(input);\n  }\n  return normalizeTraceInput({\n    ...(isRecord(input) ? input : {}),\n    ...context,\n  });\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction resolveTraceBridge(): TraceBridgeLike | null {\n  const globalObj = globalThis as GlobalWithTraceBridge;\n  const bridge = globalObj.__NOEGO_WOOD_BRIDGE__\n    ?? globalObj.window?.__NOEGO_WOOD_BRIDGE__\n    ?? globalObj.wood\n    ?? globalObj.window?.wood;\n  if (!bridge || typeof bridge !== 'object') {\n    return null;\n  }\n  return bridge as TraceBridgeLike;\n}\n\nclass TraceHub {\n  private readonly subject = new Subject<TraceEvent>();\n  private readonly shared$ = this.subject.asObservable().pipe(share());\n  private readonly sinks = new Set<WoodTraceEventSink>();\n  private nextTraceSeq = 1;\n  private minLevels: Record<TraceProcess, TraceLevel> = {\n    main: 'debug',\n    renderer: 'debug',\n    test: 'debug',\n  };\n\n  get events$(): Observable<TraceEvent> {\n    return this.shared$;\n  }\n\n  setMinLevel(process: TraceProcess, level: TraceLevel): void {\n    this.minLevels[process] = level;\n  }\n\n  registerSink(sink: WoodTraceEventSink): WoodTraceSinkDisposer {\n    this.sinks.add(sink);\n    return () => {\n      this.sinks.delete(sink);\n    };\n  }\n\n  publish(process: TraceProcess, level: TraceLevel, input: unknown): TraceEvent {\n    const normalized = normalizeTraceInput(input);\n    const event: TraceEvent = {\n      ...normalized,\n      level,\n      process,\n      timestamp: new Date().toISOString(),\n      traceSeq: this.nextTraceSeq++,\n    };\n    if (traceLevelOrder(level) >= traceLevelOrder(this.minLevels[process])) {\n      this.publishToSinks(event);\n      this.subject.next(event);\n    }\n    return event;\n  }\n\n  publishRendererToSinks(level: TraceLevel, input: TraceInput): void {\n    if (this.sinks.size === 0) {\n      return;\n    }\n    const event: TraceEvent = {\n      ...input,\n      level,\n      process: 'renderer',\n      timestamp: new Date().toISOString(),\n      traceSeq: this.nextTraceSeq++,\n    };\n    this.publishToSinks(event);\n  }\n\n  private publishToSinks(event: TraceEvent): void {\n    if (this.sinks.size === 0) {\n      return;\n    }\n    const snapshot: WoodTraceEventSnapshot = Object.freeze({\n      ...event,\n      ...(event.payload ? { payload: Object.freeze({ ...event.payload }) } : {}),\n    });\n    for (const sink of this.sinks) {\n      try {\n        sink(snapshot);\n      } catch {\n        // Trace sinks are observational and cannot fail trace callers or peers.\n      }\n    }\n  }\n}\n\nfunction getGlobalTraceHub(): TraceHub {\n  const globalObj = globalThis as GlobalWithTraceHub;\n  if (!globalObj[TRACE_HUB_SYMBOL]) {\n    globalObj[TRACE_HUB_SYMBOL] = new TraceHub();\n  }\n  return globalObj[TRACE_HUB_SYMBOL] as TraceHub;\n}\n\nexport function getTraceEvents$(): Observable<TraceEvent> {\n  return getGlobalTraceHub().events$;\n}\n\nexport function registerTraceSink(sink: WoodTraceEventSink): WoodTraceSinkDisposer {\n  return getGlobalTraceHub().registerSink(sink);\n}\n\nexport function setMainTraceMinLevel(level: TraceLevel): void {\n  getGlobalTraceHub().setMinLevel('main', level);\n}\n\nexport function setRendererTraceMinLevel(level: TraceLevel): void {\n  rendererMinLevel = level;\n  getGlobalTraceHub().setMinLevel('renderer', level);\n}\n\nexport function setRendererTraceEnabled(enabled: boolean): void {\n  rendererEnabled = enabled;\n}\n\nexport function publishMainTrace(level: TraceLevel, input: unknown): TraceEvent {\n  return getGlobalTraceHub().publish('main', level, input);\n}\n\nexport function publishTestTrace(process: TraceProcess, level: TraceLevel, input: unknown): TraceEvent {\n  return getGlobalTraceHub().publish(process, level, input);\n}\n\nexport function dispatchRendererTracePayload(\n  rawPayload: unknown,\n  context?: TraceRuntimeContext,\n): TraceDispatchResult {\n  const payload = (rawPayload ?? {}) as Partial<TraceInput> & { level?: unknown };\n  const level = normalizeTraceLevel(payload.level);\n  getGlobalTraceHub().publish('renderer', level, mergeTraceRuntimeContext(payload, context));\n  return {\n    ok: true,\n    forwarded: true,\n  };\n}\n\nexport function setRendererTraceTransport(fn: ((payload: unknown) => void) | null): void {\n  customRendererTraceTransport = fn;\n}\n\nexport function emitRendererTrace(level: TraceLevel, input: TraceInput): void {\n  if (!rendererEnabled) {\n    return;\n  }\n  if (traceLevelOrder(level) < traceLevelOrder(rendererMinLevel)) {\n    return;\n  }\n  const normalized = { ...normalizeTraceInput(input), level };\n  getGlobalTraceHub().publishRendererToSinks(level, normalized);\n\n  if (customRendererTraceTransport) {\n    try {\n      customRendererTraceTransport(normalized);\n      return;\n    } catch {\n      // Fall through to bridge.__trace\n    }\n  }\n\n  const bridge = resolveTraceBridge();\n  if (!bridge || typeof bridge.__trace !== 'function') {\n    return;\n  }\n  try {\n    bridge.__trace(normalized);\n  } catch {\n    // Tracing is observational and must never break the caller.\n  }\n}\n\nexport function clearTraceHubForTests(): void {\n  const globalObj = globalThis as GlobalWithTraceHub;\n  delete globalObj[TRACE_HUB_SYMBOL];\n  rendererMinLevel = 'debug';\n  rendererEnabled = false;\n  customRendererTraceTransport = null;\n}\n"],"mappings":"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","names":[]}

package/dist/tracing/trace_provider.cjs

@@ -38,6 +38,9 @@ module.exports = __toCommonJS(trace_provider_exports);
 var import_ioc = require("@noego/ioc");
 var import_trace_hub = require("./trace_hub.js");
 class FrameworkTracer {
+  registerSink(sink) {
+    return (0, import_trace_hub.registerTraceSink)(sink);
+  }
   extend(context) {
     return new ContextualTracer(this, context);
   }
@@ -57,6 +60,9 @@ class ContextualTracer extends FrameworkTracer {
   get events$() {
     return this.parent.events$;
   }
+  traceAt(level, event) {
+    this.parent.traceAt(level, this.mergeEvent(event));
+  }
   debug(event) {
     this.parent.debug(this.mergeEvent(event));
   }
@@ -82,10 +88,22 @@ let TraceProviderConfiguration = class {
     this.runtime = "main";
     this.minLevel = "debug";
     this.enabled = null;
+    this.databasePath = null;
   }
   configureMode(mode) {
     this.mode = mode;
   }
+  /**
+   * Point trace persistence at a concrete database file. Injected by the test
+   * backend harness (per-test `framework-trace.db`) BEFORE trace services
+   * initialize. `null` keeps the production/native persistence path.
+   */
+  configureDatabasePath(databasePath) {
+    this.databasePath = databasePath;
+  }
+  getDatabasePath() {
+    return this.databasePath;
+  }
   configureRuntime(runtime) {
     this.runtime = runtime;
     this.applyRuntimeConfiguration();
@@ -129,17 +147,20 @@ let MainTracer = class extends FrameworkTracer {
     this.process = "main";
     this.events$ = (0, import_trace_hub.getTraceEvents$)();
   }
+  traceAt(level, event) {
+    (0, import_trace_hub.publishMainTrace)(level, event);
+  }
   debug(event) {
-    (0, import_trace_hub.publishMainTrace)("debug", event);
+    this.traceAt("debug", event);
   }
   info(event) {
-    (0, import_trace_hub.publishMainTrace)("info", event);
+    this.traceAt("info", event);
   }
   warn(event) {
-    (0, import_trace_hub.publishMainTrace)("warn", event);
+    this.traceAt("warn", event);
   }
   error(event) {
-    (0, import_trace_hub.publishMainTrace)("error", event);
+    this.traceAt("error", event);
   }
 };
 MainTracer = __decorateClass([
@@ -152,17 +173,20 @@ let RendererTracer = class extends FrameworkTracer {
     this.process = "renderer";
     this.events$ = (0, import_trace_hub.getTraceEvents$)();
   }
+  traceAt(level, event) {
+    (0, import_trace_hub.emitRendererTrace)(level, event);
+  }
   debug(event) {
-    (0, import_trace_hub.emitRendererTrace)("debug", event);
+    this.traceAt("debug", event);
   }
   info(event) {
-    (0, import_trace_hub.emitRendererTrace)("info", event);
+    this.traceAt("info", event);
   }
   warn(event) {
-    (0, import_trace_hub.emitRendererTrace)("warn", event);
+    this.traceAt("warn", event);
   }
   error(event) {
-    (0, import_trace_hub.emitRendererTrace)("error", event);
+    this.traceAt("error", event);
   }
 };
 RendererTracer = __decorateClass([
@@ -181,17 +205,20 @@ let TestTracer = class extends FrameworkTracer {
     if (runtime === "main") return "main";
     return "test";
   }
+  traceAt(level, event) {
+    this.publish(level, event);
+  }
   debug(event) {
-    this.publish("debug", event);
+    this.traceAt("debug", event);
   }
   info(event) {
-    this.publish("info", event);
+    this.traceAt("info", event);
   }
   warn(event) {
-    this.publish("warn", event);
+    this.traceAt("warn", event);
   }
   error(event) {
-    this.publish("error", event);
+    this.traceAt("error", event);
   }
   publish(level, event) {
     (0, import_trace_hub.publishTestTrace)(this.process, level, event);
@@ -216,6 +243,9 @@ let TraceProvider = class extends FrameworkTracer {
   get events$() {
     return this.resolveImplementation().events$;
   }
+  traceAt(level, event) {
+    this.resolveImplementation().traceAt(level, event);
+  }
   debug(event) {
     this.resolveImplementation().debug(event);
   }

package/dist/tracing/trace_provider.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/tracing/trace_provider.ts"],"sourcesContent":["import { Component, Inject, LoadAs, Provider, SCOPED_CONTAINER, type IContainer } from '@noego/ioc';\nimport type { Observable } from 'rxjs';\nimport {\n  emitRendererTrace,\n  getTraceEvents$,\n  publishMainTrace,\n  publishTestTrace,\n  setMainTraceMinLevel,\n  setRendererTraceEnabled,\n  setRendererTraceMinLevel,\n  type TraceEvent,\n  type TraceInput,\n  type TraceLevel,\n  type TraceProcess,\n} from './trace_hub.js';\n\nexport type TraceProviderMode = 'live' | 'test';\nexport type TraceRuntime = 'main' | 'renderer' | 'test';\nexport type TraceContext = Partial<TraceInput>;\n\nexport abstract class FrameworkTracer {\n  abstract readonly mode: TraceProviderMode;\n  abstract readonly process: TraceProcess;\n  abstract readonly events$: Observable<TraceEvent>;\n  abstract debug(event: TraceInput): void;\n  abstract info(event: TraceInput): void;\n  abstract warn(event: TraceInput): void;\n  abstract error(event: TraceInput): void;\n\n  extend(context: TraceContext): FrameworkTracer {\n    return new ContextualTracer(this, context);\n  }\n}\n\nclass ContextualTracer extends FrameworkTracer {\n  constructor(\n    private readonly parent: FrameworkTracer,\n    private readonly context: TraceContext,\n  ) {\n    super();\n  }\n\n  get mode(): TraceProviderMode {\n    return this.parent.mode;\n  }\n\n  get process(): TraceProcess {\n    return this.parent.process;\n  }\n\n  get events$(): Observable<TraceEvent> {\n    return this.parent.events$;\n  }\n\n  debug(event: TraceInput): void {\n    this.parent.debug(this.mergeEvent(event));\n  }\n\n  info(event: TraceInput): void {\n    this.parent.info(this.mergeEvent(event));\n  }\n\n  warn(event: TraceInput): void {\n    this.parent.warn(this.mergeEvent(event));\n  }\n\n  error(event: TraceInput): void {\n    this.parent.error(this.mergeEvent(event));\n  }\n\n  private mergeEvent(event: TraceInput): TraceInput {\n    return {\n      ...this.context,\n      ...event,\n    };\n  }\n}\n\n@Component({ scope: LoadAs.Singleton })\nexport class TraceProviderConfiguration {\n  private mode: TraceProviderMode = 'live';\n  private runtime: TraceRuntime = 'main';\n  private minLevel: TraceLevel = 'debug';\n  private enabled: boolean | null = null;\n\n  configureMode(mode: TraceProviderMode): void {\n    this.mode = mode;\n  }\n\n  configureRuntime(runtime: TraceRuntime): void {\n    this.runtime = runtime;\n    this.applyRuntimeConfiguration();\n  }\n\n  configureMinLevel(level: TraceLevel): void {\n    this.minLevel = level;\n    this.applyRuntimeConfiguration();\n  }\n\n  configureEnabled(enabled: boolean): void {\n    this.enabled = enabled;\n    this.applyRuntimeConfiguration();\n  }\n\n  getMode(): TraceProviderMode {\n    return this.mode;\n  }\n\n  getRuntime(): TraceRuntime {\n    return this.runtime;\n  }\n\n  getMinLevel(): TraceLevel {\n    return this.minLevel;\n  }\n\n  getEnabled(): boolean {\n    return this.enabled ?? (this.runtime === 'renderer' ? false : true);\n  }\n\n  private applyRuntimeConfiguration(): void {\n    if (this.runtime === 'renderer') {\n      setRendererTraceEnabled(this.getEnabled());\n      setRendererTraceMinLevel(this.minLevel);\n      return;\n    }\n\n    setMainTraceMinLevel(this.minLevel);\n  }\n}\n\n@Component({ scope: LoadAs.Singleton })\nexport class MainTracer extends FrameworkTracer {\n  readonly mode = 'live' as const;\n  readonly process = 'main' as const;\n  readonly events$ = getTraceEvents$();\n\n  debug(event: TraceInput): void {\n    publishMainTrace('debug', event);\n  }\n\n  info(event: TraceInput): void {\n    publishMainTrace('info', event);\n  }\n\n  warn(event: TraceInput): void {\n    publishMainTrace('warn', event);\n  }\n\n  error(event: TraceInput): void {\n    publishMainTrace('error', event);\n  }\n}\n\n@Component({ scope: LoadAs.Singleton })\nexport class RendererTracer extends FrameworkTracer {\n  readonly mode = 'live' as const;\n  readonly process = 'renderer' as const;\n  readonly events$ = getTraceEvents$();\n\n  debug(event: TraceInput): void {\n    emitRendererTrace('debug', event);\n  }\n\n  info(event: TraceInput): void {\n    emitRendererTrace('info', event);\n  }\n\n  warn(event: TraceInput): void {\n    emitRendererTrace('warn', event);\n  }\n\n  error(event: TraceInput): void {\n    emitRendererTrace('error', event);\n  }\n}\n\n@Component({ scope: LoadAs.Singleton })\nexport class TestTracer extends FrameworkTracer {\n  readonly mode = 'test' as const;\n  readonly events$ = getTraceEvents$();\n\n  constructor(\n    @Inject(TraceProviderConfiguration) private readonly configuration: TraceProviderConfiguration,\n  ) {\n    super();\n  }\n\n  get process(): TraceProcess {\n    const runtime = this.configuration.getRuntime();\n    if (runtime === 'renderer') return 'renderer';\n    if (runtime === 'main') return 'main';\n    return 'test';\n  }\n\n  debug(event: TraceInput): void {\n    this.publish('debug', event);\n  }\n\n  info(event: TraceInput): void {\n    this.publish('info', event);\n  }\n\n  warn(event: TraceInput): void {\n    this.publish('warn', event);\n  }\n\n  error(event: TraceInput): void {\n    this.publish('error', event);\n  }\n\n  private publish(level: TraceLevel, event: TraceInput): void {\n    publishTestTrace(this.process, level, event);\n  }\n}\n\n@Provider()\nexport class TraceProvider extends FrameworkTracer {\n  constructor(\n    @Inject(TraceProviderConfiguration) private readonly configuration: TraceProviderConfiguration,\n    @Inject(SCOPED_CONTAINER) private readonly container: IContainer,\n  ) {\n    super();\n  }\n\n  get mode(): TraceProviderMode {\n    return this.resolveImplementation().mode;\n  }\n\n  get process(): TraceProcess {\n    return this.resolveImplementation().process;\n  }\n\n  get events$(): Observable<TraceEvent> {\n    return this.resolveImplementation().events$;\n  }\n\n  debug(event: TraceInput): void {\n    this.resolveImplementation().debug(event);\n  }\n\n  info(event: TraceInput): void {\n    this.resolveImplementation().info(event);\n  }\n\n  warn(event: TraceInput): void {\n    this.resolveImplementation().warn(event);\n  }\n\n  error(event: TraceInput): void {\n    this.resolveImplementation().error(event);\n  }\n\n  private resolveImplementation(): FrameworkTracer {\n    const mode = this.configuration.getMode();\n    if (mode === 'test') {\n      return this.resolveSync(TestTracer);\n    }\n\n    if (this.configuration.getRuntime() === 'renderer') {\n      return this.resolveSync(RendererTracer);\n    }\n\n    return this.resolveSync(MainTracer);\n  }\n\n  private resolveSync<T>(token: new (...args: any[]) => T): T {\n    const resolved = this.container.instance<T, true>(token);\n    if (resolved instanceof Promise) {\n      throw new Error(`${token.name} must resolve synchronously`);\n    }\n    return resolved;\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/tracing/trace_provider.ts"],"sourcesContent":["import { Component, Inject, LoadAs, Provider, SCOPED_CONTAINER, type IContainer } from '@noego/ioc';\nimport type { Observable } from 'rxjs';\nimport {\n  emitRendererTrace,\n  getTraceEvents$,\n  publishMainTrace,\n  publishTestTrace,\n  registerTraceSink,\n  setMainTraceMinLevel,\n  setRendererTraceEnabled,\n  setRendererTraceMinLevel,\n  type TraceEvent,\n  type TraceInput,\n  type TraceLevel,\n  type TraceProcess,\n} from './trace_hub.js';\nimport type {\n  WoodTraceEventSink,\n  WoodTraceSinkDisposer,\n} from './types/wood_trace_sink.types.js';\n\nexport type TraceProviderMode = 'live' | 'test';\nexport type TraceRuntime = 'main' | 'renderer' | 'test';\nexport type TraceContext = Partial<TraceInput>;\n\nexport abstract class FrameworkTracer {\n  abstract readonly mode: TraceProviderMode;\n  abstract readonly process: TraceProcess;\n  abstract readonly events$: Observable<TraceEvent>;\n  abstract traceAt(level: TraceLevel, event: TraceInput): void;\n  abstract debug(event: TraceInput): void;\n  abstract info(event: TraceInput): void;\n  abstract warn(event: TraceInput): void;\n  abstract error(event: TraceInput): void;\n\n  registerSink(sink: WoodTraceEventSink): WoodTraceSinkDisposer {\n    return registerTraceSink(sink);\n  }\n\n  extend(context: TraceContext): FrameworkTracer {\n    return new ContextualTracer(this, context);\n  }\n}\n\nclass ContextualTracer extends FrameworkTracer {\n  constructor(\n    private readonly parent: FrameworkTracer,\n    private readonly context: TraceContext,\n  ) {\n    super();\n  }\n\n  get mode(): TraceProviderMode {\n    return this.parent.mode;\n  }\n\n  get process(): TraceProcess {\n    return this.parent.process;\n  }\n\n  get events$(): Observable<TraceEvent> {\n    return this.parent.events$;\n  }\n\n  traceAt(level: TraceLevel, event: TraceInput): void {\n    this.parent.traceAt(level, this.mergeEvent(event));\n  }\n\n  debug(event: TraceInput): void {\n    this.parent.debug(this.mergeEvent(event));\n  }\n\n  info(event: TraceInput): void {\n    this.parent.info(this.mergeEvent(event));\n  }\n\n  warn(event: TraceInput): void {\n    this.parent.warn(this.mergeEvent(event));\n  }\n\n  error(event: TraceInput): void {\n    this.parent.error(this.mergeEvent(event));\n  }\n\n  private mergeEvent(event: TraceInput): TraceInput {\n    return {\n      ...this.context,\n      ...event,\n    };\n  }\n}\n\n@Component({ scope: LoadAs.Singleton })\nexport class TraceProviderConfiguration {\n  private mode: TraceProviderMode = 'live';\n  private runtime: TraceRuntime = 'main';\n  private minLevel: TraceLevel = 'debug';\n  private enabled: boolean | null = null;\n  private databasePath: string | null = null;\n\n  configureMode(mode: TraceProviderMode): void {\n    this.mode = mode;\n  }\n\n  /**\n   * Point trace persistence at a concrete database file. Injected by the test\n   * backend harness (per-test `framework-trace.db`) BEFORE trace services\n   * initialize. `null` keeps the production/native persistence path.\n   */\n  configureDatabasePath(databasePath: string | null): void {\n    this.databasePath = databasePath;\n  }\n\n  getDatabasePath(): string | null {\n    return this.databasePath;\n  }\n\n  configureRuntime(runtime: TraceRuntime): void {\n    this.runtime = runtime;\n    this.applyRuntimeConfiguration();\n  }\n\n  configureMinLevel(level: TraceLevel): void {\n    this.minLevel = level;\n    this.applyRuntimeConfiguration();\n  }\n\n  configureEnabled(enabled: boolean): void {\n    this.enabled = enabled;\n    this.applyRuntimeConfiguration();\n  }\n\n  getMode(): TraceProviderMode {\n    return this.mode;\n  }\n\n  getRuntime(): TraceRuntime {\n    return this.runtime;\n  }\n\n  getMinLevel(): TraceLevel {\n    return this.minLevel;\n  }\n\n  getEnabled(): boolean {\n    return this.enabled ?? (this.runtime === 'renderer' ? false : true);\n  }\n\n  private applyRuntimeConfiguration(): void {\n    if (this.runtime === 'renderer') {\n      setRendererTraceEnabled(this.getEnabled());\n      setRendererTraceMinLevel(this.minLevel);\n      return;\n    }\n\n    setMainTraceMinLevel(this.minLevel);\n  }\n}\n\n@Component({ scope: LoadAs.Singleton })\nexport class MainTracer extends FrameworkTracer {\n  readonly mode = 'live' as const;\n  readonly process = 'main' as const;\n  readonly events$ = getTraceEvents$();\n\n  traceAt(level: TraceLevel, event: TraceInput): void {\n    publishMainTrace(level, event);\n  }\n\n  debug(event: TraceInput): void {\n    this.traceAt('debug', event);\n  }\n\n  info(event: TraceInput): void {\n    this.traceAt('info', event);\n  }\n\n  warn(event: TraceInput): void {\n    this.traceAt('warn', event);\n  }\n\n  error(event: TraceInput): void {\n    this.traceAt('error', event);\n  }\n}\n\n@Component({ scope: LoadAs.Singleton })\nexport class RendererTracer extends FrameworkTracer {\n  readonly mode = 'live' as const;\n  readonly process = 'renderer' as const;\n  readonly events$ = getTraceEvents$();\n\n  traceAt(level: TraceLevel, event: TraceInput): void {\n    emitRendererTrace(level, event);\n  }\n\n  debug(event: TraceInput): void {\n    this.traceAt('debug', event);\n  }\n\n  info(event: TraceInput): void {\n    this.traceAt('info', event);\n  }\n\n  warn(event: TraceInput): void {\n    this.traceAt('warn', event);\n  }\n\n  error(event: TraceInput): void {\n    this.traceAt('error', event);\n  }\n}\n\n@Component({ scope: LoadAs.Singleton })\nexport class TestTracer extends FrameworkTracer {\n  readonly mode = 'test' as const;\n  readonly events$ = getTraceEvents$();\n\n  constructor(\n    @Inject(TraceProviderConfiguration) private readonly configuration: TraceProviderConfiguration,\n  ) {\n    super();\n  }\n\n  get process(): TraceProcess {\n    const runtime = this.configuration.getRuntime();\n    if (runtime === 'renderer') return 'renderer';\n    if (runtime === 'main') return 'main';\n    return 'test';\n  }\n\n  traceAt(level: TraceLevel, event: TraceInput): void {\n    this.publish(level, event);\n  }\n\n  debug(event: TraceInput): void {\n    this.traceAt('debug', event);\n  }\n\n  info(event: TraceInput): void {\n    this.traceAt('info', event);\n  }\n\n  warn(event: TraceInput): void {\n    this.traceAt('warn', event);\n  }\n\n  error(event: TraceInput): void {\n    this.traceAt('error', event);\n  }\n\n  private publish(level: TraceLevel, event: TraceInput): void {\n    publishTestTrace(this.process, level, event);\n  }\n}\n\n@Provider()\nexport class TraceProvider extends FrameworkTracer {\n  constructor(\n    @Inject(TraceProviderConfiguration) private readonly configuration: TraceProviderConfiguration,\n    @Inject(SCOPED_CONTAINER) private readonly container: IContainer,\n  ) {\n    super();\n  }\n\n  get mode(): TraceProviderMode {\n    return this.resolveImplementation().mode;\n  }\n\n  get process(): TraceProcess {\n    return this.resolveImplementation().process;\n  }\n\n  get events$(): Observable<TraceEvent> {\n    return this.resolveImplementation().events$;\n  }\n\n  traceAt(level: TraceLevel, event: TraceInput): void {\n    this.resolveImplementation().traceAt(level, event);\n  }\n\n  debug(event: TraceInput): void {\n    this.resolveImplementation().debug(event);\n  }\n\n  info(event: TraceInput): void {\n    this.resolveImplementation().info(event);\n  }\n\n  warn(event: TraceInput): void {\n    this.resolveImplementation().warn(event);\n  }\n\n  error(event: TraceInput): void {\n    this.resolveImplementation().error(event);\n  }\n\n  private resolveImplementation(): FrameworkTracer {\n    const mode = this.configuration.getMode();\n    if (mode === 'test') {\n      return this.resolveSync(TestTracer);\n    }\n\n    if (this.configuration.getRuntime() === 'renderer') {\n      return this.resolveSync(RendererTracer);\n    }\n\n    return this.resolveSync(MainTracer);\n  }\n\n  private resolveSync<T>(token: new (...args: any[]) => T): T {\n    const resolved = this.container.instance<T, true>(token);\n    if (resolved instanceof Promise) {\n      throw new Error(`${token.name} must resolve synchronously`);\n    }\n    return resolved;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/tracing/trace_provider.d.cts

@@ -1,6 +1,6 @@
-import { TraceProcess, TraceEvent, TraceInput, TraceLevel } from './trace_hub.cjs';
 import { IContainer } from '@noego/ioc';
 import { Observable } from 'rxjs';
+import { d as TraceProcess, a as TraceEvent, c as TraceLevel, b as TraceInput, W as WoodTraceEventSink, h as WoodTraceSinkDisposer } from '../trace_hub-Cob54qRx.cjs';
 
 type TraceProviderMode = 'live' | 'test';
 type TraceRuntime = 'main' | 'renderer' | 'test';
@@ -9,10 +9,12 @@ declare abstract class FrameworkTracer {
     abstract readonly mode: TraceProviderMode;
     abstract readonly process: TraceProcess;
     abstract readonly events$: Observable<TraceEvent>;
+    abstract traceAt(level: TraceLevel, event: TraceInput): void;
     abstract debug(event: TraceInput): void;
     abstract info(event: TraceInput): void;
     abstract warn(event: TraceInput): void;
     abstract error(event: TraceInput): void;
+    registerSink(sink: WoodTraceEventSink): WoodTraceSinkDisposer;
     extend(context: TraceContext): FrameworkTracer;
 }
 declare class TraceProviderConfiguration {
@@ -20,7 +22,15 @@ declare class TraceProviderConfiguration {
     private runtime;
     private minLevel;
     private enabled;
+    private databasePath;
     configureMode(mode: TraceProviderMode): void;
+    /**
+     * Point trace persistence at a concrete database file. Injected by the test
+     * backend harness (per-test `framework-trace.db`) BEFORE trace services
+     * initialize. `null` keeps the production/native persistence path.
+     */
+    configureDatabasePath(databasePath: string | null): void;
+    getDatabasePath(): string | null;
     configureRuntime(runtime: TraceRuntime): void;
     configureMinLevel(level: TraceLevel): void;
     configureEnabled(enabled: boolean): void;
@@ -34,6 +44,7 @@ declare class MainTracer extends FrameworkTracer {
     readonly mode: "live";
     readonly process: "main";
     readonly events$: Observable<TraceEvent>;
+    traceAt(level: TraceLevel, event: TraceInput): void;
     debug(event: TraceInput): void;
     info(event: TraceInput): void;
     warn(event: TraceInput): void;
@@ -43,6 +54,7 @@ declare class RendererTracer extends FrameworkTracer {
     readonly mode: "live";
     readonly process: "renderer";
     readonly events$: Observable<TraceEvent>;
+    traceAt(level: TraceLevel, event: TraceInput): void;
     debug(event: TraceInput): void;
     info(event: TraceInput): void;
     warn(event: TraceInput): void;
@@ -54,6 +66,7 @@ declare class TestTracer extends FrameworkTracer {
     readonly events$: Observable<TraceEvent>;
     constructor(configuration: TraceProviderConfiguration);
     get process(): TraceProcess;
+    traceAt(level: TraceLevel, event: TraceInput): void;
     debug(event: TraceInput): void;
     info(event: TraceInput): void;
     warn(event: TraceInput): void;
@@ -67,6 +80,7 @@ declare class TraceProvider extends FrameworkTracer {
     get mode(): TraceProviderMode;
     get process(): TraceProcess;
     get events$(): Observable<TraceEvent>;
+    traceAt(level: TraceLevel, event: TraceInput): void;
     debug(event: TraceInput): void;
     info(event: TraceInput): void;
     warn(event: TraceInput): void;

package/dist/tracing/trace_provider.d.ts

@@ -1,6 +1,6 @@
-import { TraceProcess, TraceEvent, TraceInput, TraceLevel } from './trace_hub.js';
 import { IContainer } from '@noego/ioc';
 import { Observable } from 'rxjs';
+import { d as TraceProcess, a as TraceEvent, c as TraceLevel, b as TraceInput, W as WoodTraceEventSink, h as WoodTraceSinkDisposer } from '../trace_hub-Cob54qRx.js';
 
 type TraceProviderMode = 'live' | 'test';
 type TraceRuntime = 'main' | 'renderer' | 'test';
@@ -9,10 +9,12 @@ declare abstract class FrameworkTracer {
     abstract readonly mode: TraceProviderMode;
     abstract readonly process: TraceProcess;
     abstract readonly events$: Observable<TraceEvent>;
+    abstract traceAt(level: TraceLevel, event: TraceInput): void;
     abstract debug(event: TraceInput): void;
     abstract info(event: TraceInput): void;
     abstract warn(event: TraceInput): void;
     abstract error(event: TraceInput): void;
+    registerSink(sink: WoodTraceEventSink): WoodTraceSinkDisposer;
     extend(context: TraceContext): FrameworkTracer;
 }
 declare class TraceProviderConfiguration {
@@ -20,7 +22,15 @@ declare class TraceProviderConfiguration {
     private runtime;
     private minLevel;
     private enabled;
+    private databasePath;
     configureMode(mode: TraceProviderMode): void;
+    /**
+     * Point trace persistence at a concrete database file. Injected by the test
+     * backend harness (per-test `framework-trace.db`) BEFORE trace services
+     * initialize. `null` keeps the production/native persistence path.
+     */
+    configureDatabasePath(databasePath: string | null): void;
+    getDatabasePath(): string | null;
     configureRuntime(runtime: TraceRuntime): void;
     configureMinLevel(level: TraceLevel): void;
     configureEnabled(enabled: boolean): void;
@@ -34,6 +44,7 @@ declare class MainTracer extends FrameworkTracer {
     readonly mode: "live";
     readonly process: "main";
     readonly events$: Observable<TraceEvent>;
+    traceAt(level: TraceLevel, event: TraceInput): void;
     debug(event: TraceInput): void;
     info(event: TraceInput): void;
     warn(event: TraceInput): void;
@@ -43,6 +54,7 @@ declare class RendererTracer extends FrameworkTracer {
     readonly mode: "live";
     readonly process: "renderer";
     readonly events$: Observable<TraceEvent>;
+    traceAt(level: TraceLevel, event: TraceInput): void;
     debug(event: TraceInput): void;
     info(event: TraceInput): void;
     warn(event: TraceInput): void;
@@ -54,6 +66,7 @@ declare class TestTracer extends FrameworkTracer {
     readonly events$: Observable<TraceEvent>;
     constructor(configuration: TraceProviderConfiguration);
     get process(): TraceProcess;
+    traceAt(level: TraceLevel, event: TraceInput): void;
     debug(event: TraceInput): void;
     info(event: TraceInput): void;
     warn(event: TraceInput): void;
@@ -67,6 +80,7 @@ declare class TraceProvider extends FrameworkTracer {
     get mode(): TraceProviderMode;
     get process(): TraceProcess;
     get events$(): Observable<TraceEvent>;
+    traceAt(level: TraceLevel, event: TraceInput): void;
     debug(event: TraceInput): void;
     info(event: TraceInput): void;
     warn(event: TraceInput): void;

package/dist/tracing/trace_provider.js

@@ -15,11 +15,15 @@ import {
   getTraceEvents$,
   publishMainTrace,
   publishTestTrace,
+  registerTraceSink,
   setMainTraceMinLevel,
   setRendererTraceEnabled,
   setRendererTraceMinLevel
 } from "./trace_hub.js";
 class FrameworkTracer {
+  registerSink(sink) {
+    return registerTraceSink(sink);
+  }
   extend(context) {
     return new ContextualTracer(this, context);
   }
@@ -39,6 +43,9 @@ class ContextualTracer extends FrameworkTracer {
   get events$() {
     return this.parent.events$;
   }
+  traceAt(level, event) {
+    this.parent.traceAt(level, this.mergeEvent(event));
+  }
   debug(event) {
     this.parent.debug(this.mergeEvent(event));
   }
@@ -64,10 +71,22 @@ let TraceProviderConfiguration = class {
     this.runtime = "main";
     this.minLevel = "debug";
     this.enabled = null;
+    this.databasePath = null;
   }
   configureMode(mode) {
     this.mode = mode;
   }
+  /**
+   * Point trace persistence at a concrete database file. Injected by the test
+   * backend harness (per-test `framework-trace.db`) BEFORE trace services
+   * initialize. `null` keeps the production/native persistence path.
+   */
+  configureDatabasePath(databasePath) {
+    this.databasePath = databasePath;
+  }
+  getDatabasePath() {
+    return this.databasePath;
+  }
   configureRuntime(runtime) {
     this.runtime = runtime;
     this.applyRuntimeConfiguration();
@@ -111,17 +130,20 @@ let MainTracer = class extends FrameworkTracer {
     this.process = "main";
     this.events$ = getTraceEvents$();
   }
+  traceAt(level, event) {
+    publishMainTrace(level, event);
+  }
   debug(event) {
-    publishMainTrace("debug", event);
+    this.traceAt("debug", event);
   }
   info(event) {
-    publishMainTrace("info", event);
+    this.traceAt("info", event);
   }
   warn(event) {
-    publishMainTrace("warn", event);
+    this.traceAt("warn", event);
   }
   error(event) {
-    publishMainTrace("error", event);
+    this.traceAt("error", event);
   }
 };
 MainTracer = __decorateClass([
@@ -134,17 +156,20 @@ let RendererTracer = class extends FrameworkTracer {
     this.process = "renderer";
     this.events$ = getTraceEvents$();
   }
+  traceAt(level, event) {
+    emitRendererTrace(level, event);
+  }
   debug(event) {
-    emitRendererTrace("debug", event);
+    this.traceAt("debug", event);
   }
   info(event) {
-    emitRendererTrace("info", event);
+    this.traceAt("info", event);
   }
   warn(event) {
-    emitRendererTrace("warn", event);
+    this.traceAt("warn", event);
   }
   error(event) {
-    emitRendererTrace("error", event);
+    this.traceAt("error", event);
   }
 };
 RendererTracer = __decorateClass([
@@ -163,17 +188,20 @@ let TestTracer = class extends FrameworkTracer {
     if (runtime === "main") return "main";
     return "test";
   }
+  traceAt(level, event) {
+    this.publish(level, event);
+  }
   debug(event) {
-    this.publish("debug", event);
+    this.traceAt("debug", event);
   }
   info(event) {
-    this.publish("info", event);
+    this.traceAt("info", event);
   }
   warn(event) {
-    this.publish("warn", event);
+    this.traceAt("warn", event);
   }
   error(event) {
-    this.publish("error", event);
+    this.traceAt("error", event);
   }
   publish(level, event) {
     publishTestTrace(this.process, level, event);
@@ -198,6 +226,9 @@ let TraceProvider = class extends FrameworkTracer {
   get events$() {
     return this.resolveImplementation().events$;
   }
+  traceAt(level, event) {
+    this.resolveImplementation().traceAt(level, event);
+  }
   debug(event) {
     this.resolveImplementation().debug(event);
   }

package/dist/tracing/trace_provider.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/tracing/trace_provider.ts"],"sourcesContent":["import { Component, Inject, LoadAs, Provider, SCOPED_CONTAINER, type IContainer } from '@noego/ioc';\nimport type { Observable } from 'rxjs';\nimport {\n  emitRendererTrace,\n  getTraceEvents$,\n  publishMainTrace,\n  publishTestTrace,\n  setMainTraceMinLevel,\n  setRendererTraceEnabled,\n  setRendererTraceMinLevel,\n  type TraceEvent,\n  type TraceInput,\n  type TraceLevel,\n  type TraceProcess,\n} from './trace_hub.js';\n\nexport type TraceProviderMode = 'live' | 'test';\nexport type TraceRuntime = 'main' | 'renderer' | 'test';\nexport type TraceContext = Partial<TraceInput>;\n\nexport abstract class FrameworkTracer {\n  abstract readonly mode: TraceProviderMode;\n  abstract readonly process: TraceProcess;\n  abstract readonly events$: Observable<TraceEvent>;\n  abstract debug(event: TraceInput): void;\n  abstract info(event: TraceInput): void;\n  abstract warn(event: TraceInput): void;\n  abstract error(event: TraceInput): void;\n\n  extend(context: TraceContext): FrameworkTracer {\n    return new ContextualTracer(this, context);\n  }\n}\n\nclass ContextualTracer extends FrameworkTracer {\n  constructor(\n    private readonly parent: FrameworkTracer,\n    private readonly context: TraceContext,\n  ) {\n    super();\n  }\n\n  get mode(): TraceProviderMode {\n    return this.parent.mode;\n  }\n\n  get process(): TraceProcess {\n    return this.parent.process;\n  }\n\n  get events$(): Observable<TraceEvent> {\n    return this.parent.events$;\n  }\n\n  debug(event: TraceInput): void {\n    this.parent.debug(this.mergeEvent(event));\n  }\n\n  info(event: TraceInput): void {\n    this.parent.info(this.mergeEvent(event));\n  }\n\n  warn(event: TraceInput): void {\n    this.parent.warn(this.mergeEvent(event));\n  }\n\n  error(event: TraceInput): void {\n    this.parent.error(this.mergeEvent(event));\n  }\n\n  private mergeEvent(event: TraceInput): TraceInput {\n    return {\n      ...this.context,\n      ...event,\n    };\n  }\n}\n\n@Component({ scope: LoadAs.Singleton })\nexport class TraceProviderConfiguration {\n  private mode: TraceProviderMode = 'live';\n  private runtime: TraceRuntime = 'main';\n  private minLevel: TraceLevel = 'debug';\n  private enabled: boolean | null = null;\n\n  configureMode(mode: TraceProviderMode): void {\n    this.mode = mode;\n  }\n\n  configureRuntime(runtime: TraceRuntime): void {\n    this.runtime = runtime;\n    this.applyRuntimeConfiguration();\n  }\n\n  configureMinLevel(level: TraceLevel): void {\n    this.minLevel = level;\n    this.applyRuntimeConfiguration();\n  }\n\n  configureEnabled(enabled: boolean): void {\n    this.enabled = enabled;\n    this.applyRuntimeConfiguration();\n  }\n\n  getMode(): TraceProviderMode {\n    return this.mode;\n  }\n\n  getRuntime(): TraceRuntime {\n    return this.runtime;\n  }\n\n  getMinLevel(): TraceLevel {\n    return this.minLevel;\n  }\n\n  getEnabled(): boolean {\n    return this.enabled ?? (this.runtime === 'renderer' ? false : true);\n  }\n\n  private applyRuntimeConfiguration(): void {\n    if (this.runtime === 'renderer') {\n      setRendererTraceEnabled(this.getEnabled());\n      setRendererTraceMinLevel(this.minLevel);\n      return;\n    }\n\n    setMainTraceMinLevel(this.minLevel);\n  }\n}\n\n@Component({ scope: LoadAs.Singleton })\nexport class MainTracer extends FrameworkTracer {\n  readonly mode = 'live' as const;\n  readonly process = 'main' as const;\n  readonly events$ = getTraceEvents$();\n\n  debug(event: TraceInput): void {\n    publishMainTrace('debug', event);\n  }\n\n  info(event: TraceInput): void {\n    publishMainTrace('info', event);\n  }\n\n  warn(event: TraceInput): void {\n    publishMainTrace('warn', event);\n  }\n\n  error(event: TraceInput): void {\n    publishMainTrace('error', event);\n  }\n}\n\n@Component({ scope: LoadAs.Singleton })\nexport class RendererTracer extends FrameworkTracer {\n  readonly mode = 'live' as const;\n  readonly process = 'renderer' as const;\n  readonly events$ = getTraceEvents$();\n\n  debug(event: TraceInput): void {\n    emitRendererTrace('debug', event);\n  }\n\n  info(event: TraceInput): void {\n    emitRendererTrace('info', event);\n  }\n\n  warn(event: TraceInput): void {\n    emitRendererTrace('warn', event);\n  }\n\n  error(event: TraceInput): void {\n    emitRendererTrace('error', event);\n  }\n}\n\n@Component({ scope: LoadAs.Singleton })\nexport class TestTracer extends FrameworkTracer {\n  readonly mode = 'test' as const;\n  readonly events$ = getTraceEvents$();\n\n  constructor(\n    @Inject(TraceProviderConfiguration) private readonly configuration: TraceProviderConfiguration,\n  ) {\n    super();\n  }\n\n  get process(): TraceProcess {\n    const runtime = this.configuration.getRuntime();\n    if (runtime === 'renderer') return 'renderer';\n    if (runtime === 'main') return 'main';\n    return 'test';\n  }\n\n  debug(event: TraceInput): void {\n    this.publish('debug', event);\n  }\n\n  info(event: TraceInput): void {\n    this.publish('info', event);\n  }\n\n  warn(event: TraceInput): void {\n    this.publish('warn', event);\n  }\n\n  error(event: TraceInput): void {\n    this.publish('error', event);\n  }\n\n  private publish(level: TraceLevel, event: TraceInput): void {\n    publishTestTrace(this.process, level, event);\n  }\n}\n\n@Provider()\nexport class TraceProvider extends FrameworkTracer {\n  constructor(\n    @Inject(TraceProviderConfiguration) private readonly configuration: TraceProviderConfiguration,\n    @Inject(SCOPED_CONTAINER) private readonly container: IContainer,\n  ) {\n    super();\n  }\n\n  get mode(): TraceProviderMode {\n    return this.resolveImplementation().mode;\n  }\n\n  get process(): TraceProcess {\n    return this.resolveImplementation().process;\n  }\n\n  get events$(): Observable<TraceEvent> {\n    return this.resolveImplementation().events$;\n  }\n\n  debug(event: TraceInput): void {\n    this.resolveImplementation().debug(event);\n  }\n\n  info(event: TraceInput): void {\n    this.resolveImplementation().info(event);\n  }\n\n  warn(event: TraceInput): void {\n    this.resolveImplementation().warn(event);\n  }\n\n  error(event: TraceInput): void {\n    this.resolveImplementation().error(event);\n  }\n\n  private resolveImplementation(): FrameworkTracer {\n    const mode = this.configuration.getMode();\n    if (mode === 'test') {\n      return this.resolveSync(TestTracer);\n    }\n\n    if (this.configuration.getRuntime() === 'renderer') {\n      return this.resolveSync(RendererTracer);\n    }\n\n    return this.resolveSync(MainTracer);\n  }\n\n  private resolveSync<T>(token: new (...args: any[]) => T): T {\n    const resolved = this.container.instance<T, true>(token);\n    if (resolved instanceof Promise) {\n      throw new Error(`${token.name} must resolve synchronously`);\n    }\n    return resolved;\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/tracing/trace_provider.ts"],"sourcesContent":["import { Component, Inject, LoadAs, Provider, SCOPED_CONTAINER, type IContainer } from '@noego/ioc';\nimport type { Observable } from 'rxjs';\nimport {\n  emitRendererTrace,\n  getTraceEvents$,\n  publishMainTrace,\n  publishTestTrace,\n  registerTraceSink,\n  setMainTraceMinLevel,\n  setRendererTraceEnabled,\n  setRendererTraceMinLevel,\n  type TraceEvent,\n  type TraceInput,\n  type TraceLevel,\n  type TraceProcess,\n} from './trace_hub.js';\nimport type {\n  WoodTraceEventSink,\n  WoodTraceSinkDisposer,\n} from './types/wood_trace_sink.types.js';\n\nexport type TraceProviderMode = 'live' | 'test';\nexport type TraceRuntime = 'main' | 'renderer' | 'test';\nexport type TraceContext = Partial<TraceInput>;\n\nexport abstract class FrameworkTracer {\n  abstract readonly mode: TraceProviderMode;\n  abstract readonly process: TraceProcess;\n  abstract readonly events$: Observable<TraceEvent>;\n  abstract traceAt(level: TraceLevel, event: TraceInput): void;\n  abstract debug(event: TraceInput): void;\n  abstract info(event: TraceInput): void;\n  abstract warn(event: TraceInput): void;\n  abstract error(event: TraceInput): void;\n\n  registerSink(sink: WoodTraceEventSink): WoodTraceSinkDisposer {\n    return registerTraceSink(sink);\n  }\n\n  extend(context: TraceContext): FrameworkTracer {\n    return new ContextualTracer(this, context);\n  }\n}\n\nclass ContextualTracer extends FrameworkTracer {\n  constructor(\n    private readonly parent: FrameworkTracer,\n    private readonly context: TraceContext,\n  ) {\n    super();\n  }\n\n  get mode(): TraceProviderMode {\n    return this.parent.mode;\n  }\n\n  get process(): TraceProcess {\n    return this.parent.process;\n  }\n\n  get events$(): Observable<TraceEvent> {\n    return this.parent.events$;\n  }\n\n  traceAt(level: TraceLevel, event: TraceInput): void {\n    this.parent.traceAt(level, this.mergeEvent(event));\n  }\n\n  debug(event: TraceInput): void {\n    this.parent.debug(this.mergeEvent(event));\n  }\n\n  info(event: TraceInput): void {\n    this.parent.info(this.mergeEvent(event));\n  }\n\n  warn(event: TraceInput): void {\n    this.parent.warn(this.mergeEvent(event));\n  }\n\n  error(event: TraceInput): void {\n    this.parent.error(this.mergeEvent(event));\n  }\n\n  private mergeEvent(event: TraceInput): TraceInput {\n    return {\n      ...this.context,\n      ...event,\n    };\n  }\n}\n\n@Component({ scope: LoadAs.Singleton })\nexport class TraceProviderConfiguration {\n  private mode: TraceProviderMode = 'live';\n  private runtime: TraceRuntime = 'main';\n  private minLevel: TraceLevel = 'debug';\n  private enabled: boolean | null = null;\n  private databasePath: string | null = null;\n\n  configureMode(mode: TraceProviderMode): void {\n    this.mode = mode;\n  }\n\n  /**\n   * Point trace persistence at a concrete database file. Injected by the test\n   * backend harness (per-test `framework-trace.db`) BEFORE trace services\n   * initialize. `null` keeps the production/native persistence path.\n   */\n  configureDatabasePath(databasePath: string | null): void {\n    this.databasePath = databasePath;\n  }\n\n  getDatabasePath(): string | null {\n    return this.databasePath;\n  }\n\n  configureRuntime(runtime: TraceRuntime): void {\n    this.runtime = runtime;\n    this.applyRuntimeConfiguration();\n  }\n\n  configureMinLevel(level: TraceLevel): void {\n    this.minLevel = level;\n    this.applyRuntimeConfiguration();\n  }\n\n  configureEnabled(enabled: boolean): void {\n    this.enabled = enabled;\n    this.applyRuntimeConfiguration();\n  }\n\n  getMode(): TraceProviderMode {\n    return this.mode;\n  }\n\n  getRuntime(): TraceRuntime {\n    return this.runtime;\n  }\n\n  getMinLevel(): TraceLevel {\n    return this.minLevel;\n  }\n\n  getEnabled(): boolean {\n    return this.enabled ?? (this.runtime === 'renderer' ? false : true);\n  }\n\n  private applyRuntimeConfiguration(): void {\n    if (this.runtime === 'renderer') {\n      setRendererTraceEnabled(this.getEnabled());\n      setRendererTraceMinLevel(this.minLevel);\n      return;\n    }\n\n    setMainTraceMinLevel(this.minLevel);\n  }\n}\n\n@Component({ scope: LoadAs.Singleton })\nexport class MainTracer extends FrameworkTracer {\n  readonly mode = 'live' as const;\n  readonly process = 'main' as const;\n  readonly events$ = getTraceEvents$();\n\n  traceAt(level: TraceLevel, event: TraceInput): void {\n    publishMainTrace(level, event);\n  }\n\n  debug(event: TraceInput): void {\n    this.traceAt('debug', event);\n  }\n\n  info(event: TraceInput): void {\n    this.traceAt('info', event);\n  }\n\n  warn(event: TraceInput): void {\n    this.traceAt('warn', event);\n  }\n\n  error(event: TraceInput): void {\n    this.traceAt('error', event);\n  }\n}\n\n@Component({ scope: LoadAs.Singleton })\nexport class RendererTracer extends FrameworkTracer {\n  readonly mode = 'live' as const;\n  readonly process = 'renderer' as const;\n  readonly events$ = getTraceEvents$();\n\n  traceAt(level: TraceLevel, event: TraceInput): void {\n    emitRendererTrace(level, event);\n  }\n\n  debug(event: TraceInput): void {\n    this.traceAt('debug', event);\n  }\n\n  info(event: TraceInput): void {\n    this.traceAt('info', event);\n  }\n\n  warn(event: TraceInput): void {\n    this.traceAt('warn', event);\n  }\n\n  error(event: TraceInput): void {\n    this.traceAt('error', event);\n  }\n}\n\n@Component({ scope: LoadAs.Singleton })\nexport class TestTracer extends FrameworkTracer {\n  readonly mode = 'test' as const;\n  readonly events$ = getTraceEvents$();\n\n  constructor(\n    @Inject(TraceProviderConfiguration) private readonly configuration: TraceProviderConfiguration,\n  ) {\n    super();\n  }\n\n  get process(): TraceProcess {\n    const runtime = this.configuration.getRuntime();\n    if (runtime === 'renderer') return 'renderer';\n    if (runtime === 'main') return 'main';\n    return 'test';\n  }\n\n  traceAt(level: TraceLevel, event: TraceInput): void {\n    this.publish(level, event);\n  }\n\n  debug(event: TraceInput): void {\n    this.traceAt('debug', event);\n  }\n\n  info(event: TraceInput): void {\n    this.traceAt('info', event);\n  }\n\n  warn(event: TraceInput): void {\n    this.traceAt('warn', event);\n  }\n\n  error(event: TraceInput): void {\n    this.traceAt('error', event);\n  }\n\n  private publish(level: TraceLevel, event: TraceInput): void {\n    publishTestTrace(this.process, level, event);\n  }\n}\n\n@Provider()\nexport class TraceProvider extends FrameworkTracer {\n  constructor(\n    @Inject(TraceProviderConfiguration) private readonly configuration: TraceProviderConfiguration,\n    @Inject(SCOPED_CONTAINER) private readonly container: IContainer,\n  ) {\n    super();\n  }\n\n  get mode(): TraceProviderMode {\n    return this.resolveImplementation().mode;\n  }\n\n  get process(): TraceProcess {\n    return this.resolveImplementation().process;\n  }\n\n  get events$(): Observable<TraceEvent> {\n    return this.resolveImplementation().events$;\n  }\n\n  traceAt(level: TraceLevel, event: TraceInput): void {\n    this.resolveImplementation().traceAt(level, event);\n  }\n\n  debug(event: TraceInput): void {\n    this.resolveImplementation().debug(event);\n  }\n\n  info(event: TraceInput): void {\n    this.resolveImplementation().info(event);\n  }\n\n  warn(event: TraceInput): void {\n    this.resolveImplementation().warn(event);\n  }\n\n  error(event: TraceInput): void {\n    this.resolveImplementation().error(event);\n  }\n\n  private resolveImplementation(): FrameworkTracer {\n    const mode = this.configuration.getMode();\n    if (mode === 'test') {\n      return this.resolveSync(TestTracer);\n    }\n\n    if (this.configuration.getRuntime() === 'renderer') {\n      return this.resolveSync(RendererTracer);\n    }\n\n    return this.resolveSync(MainTracer);\n  }\n\n  private resolveSync<T>(token: new (...args: any[]) => T): T {\n    const resolved = this.container.instance<T, true>(token);\n    if (resolved instanceof Promise) {\n      throw new Error(`${token.name} must resolve synchronously`);\n    }\n    return resolved;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/tracing/types/wood_trace_batch.types.cjs

@@ -0,0 +1,17 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var wood_trace_batch_types_exports = {};
+module.exports = __toCommonJS(wood_trace_batch_types_exports);
+//# sourceMappingURL=wood_trace_batch.types.cjs.map

package/dist/tracing/types/wood_trace_batch.types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/tracing/types/wood_trace_batch.types.ts"],"sourcesContent":["import type { MetadataSnapshotLimits } from '@noego/telemetry/core';\nimport type { TraceEvent, TraceInput, TraceLevel } from '../trace_hub.js';\n\nexport type WoodRendererTraceInput = Readonly<\n  Omit<TraceInput, 'payload'> & {\n    readonly level: TraceLevel;\n    readonly payload?: Readonly<Record<string, unknown>>;\n  }\n>;\n\nexport type WoodRendererTraceEvent = Readonly<\n  Omit<TraceEvent, 'payload'> & {\n    readonly payload?: Readonly<Record<string, unknown>>;\n  }\n>;\n\nexport type WoodTraceBatch = Readonly<{\n  kind: 'wood.trace.batch';\n  protocolVersion: 1;\n  producerId: string;\n  batchId: string;\n  sequenceStart: number;\n  sequenceEnd: number;\n  events: readonly WoodRendererTraceEvent[];\n}>;\n\nexport type WoodTraceBatchAcknowledgement =\n  /** The injected receiver's durable terminal committed every event. */\n  | Readonly<{\n      kind: 'committed';\n      batchId: string;\n      committedAtMs: number;\n      acceptedEvents: number;\n    }>\n  | Readonly<{\n      kind: 'retryable';\n      batchId: string;\n      reason: string;\n      retryAfterMs: number;\n    }>\n  | Readonly<{\n      kind: 'rejected';\n      batchId: string;\n      reason: string;\n    }>;\n\nexport type WoodTraceBatchRuntimeContext = Readonly<{\n  windowId?: string;\n  webContentsId?: number;\n  routeKey?: string;\n  harnessId?: string;\n}>;\n\nexport type WoodTraceBatchReceiver = (\n  batch: WoodTraceBatch,\n  context: WoodTraceBatchRuntimeContext,\n) => Promise<WoodTraceBatchAcknowledgement>;\n\nexport type WoodTraceBatchAdmissionResult =\n  | Readonly<{ kind: 'admitted'; sequence: number }>\n  | Readonly<{ kind: 'dropped'; sequence: number; reason: 'capacity' | 'closed' }>;\n\nexport type WoodTraceBatchTransportStatus = Readonly<{\n  state: 'accepting' | 'draining' | 'stopped';\n  producerId: string;\n  nextSequence: number;\n  queuedEvents: number;\n  inFlightBatchId: string | null;\n  droppedCapacity: number;\n  droppedClosed: number;\n  droppedRejected: number;\n  droppedRetryExhausted: number;\n  metadataTruncatedValues: number;\n  metadataRedactedValues: number;\n  metadataSerializationFailures: number;\n  committedBatches: number;\n  retryAttempts: number;\n}>;\n\nexport interface WoodTraceBatchPort {\n  postMessage(batch: WoodTraceBatch): void;\n  subscribe(listener: (message: unknown) => void): () => void;\n  close(): void;\n}\n\nexport type WoodTraceBatchTransportOptions = Readonly<{\n  producerId: string;\n  maxQueuedEvents: number;\n  maxBatchEvents: number;\n  acknowledgementTimeoutMs: number;\n  retryLimit: number;\n  retryBaseDelayMs: number;\n  now: () => number;\n  schedule: (work: () => void) => void;\n  delay: (durationMs: number) => Promise<void>;\n  metadataSnapshotLimits?: MetadataSnapshotLimits;\n}>;\n\nexport type WoodTraceBatchParseResult =\n  | Readonly<{ kind: 'not-batch' }>\n  | Readonly<{ kind: 'invalid'; batchId: string | null; reason: string }>\n  | Readonly<{ kind: 'valid'; batch: WoodTraceBatch }>;\n\nexport type WoodTraceAcknowledgementParseResult =\n  | Readonly<{ ok: true; acknowledgement: WoodTraceBatchAcknowledgement }>\n  | Readonly<{ ok: false; reason: string }>;\n\nexport type WoodTraceEventParseResult =\n  | Readonly<{ kind: 'valid'; event: WoodRendererTraceEvent }>\n  | Readonly<{ kind: 'invalid'; reason: string }>;\n\nexport type WoodTraceEventsParseResult =\n  | Readonly<{ kind: 'valid'; events: readonly WoodRendererTraceEvent[] }>\n  | Readonly<{ kind: 'invalid'; reason: string }>;\n\nexport type WoodTraceIdentityValidationResult =\n  | Readonly<{ kind: 'valid' }>\n  | Readonly<{ kind: 'invalid'; reason: string }>;\n"],"mappings":";;;;;;;;;;;;;;AAAA;AAAA;","names":[]}