@noego/wood 0.4.9 → 0.5.0

package/dist/tracing/trace_hub.js

@@ -21,6 +21,24 @@ function traceLevelOrder(level) {
 let rendererMinLevel = "debug";
 let rendererEnabled = false;
 let customRendererTraceTransport = null;
+let traceProducerId = null;
+function randomIdSuffix() {
+  const c = globalThis.crypto;
+  if (c && typeof c.randomUUID === "function") {
+    return c.randomUUID();
+  }
+  return `${Date.now().toString(36)}-${Math.random().toString(16).slice(2)}`;
+}
+function getTraceProducerId() {
+  if (traceProducerId === null) {
+    const processTag = typeof process !== "undefined" && process?.versions?.electron ? process.type === "renderer" ? "renderer" : "main" : typeof window !== "undefined" ? "renderer" : "main";
+    traceProducerId = `${processTag}:${randomIdSuffix()}`;
+  }
+  return traceProducerId;
+}
+function hasValidRemoteIdentity(event) {
+  return typeof event.timestamp === "string" && Number.isFinite(Date.parse(event.timestamp)) && typeof event.traceSeq === "number" && Number.isSafeInteger(event.traceSeq) && event.traceSeq >= 1;
+}
 function normalizeTraceInput(raw) {
   const input = raw ?? {};
   const source = typeof input.source === "string" && input.source.trim().length > 0 ? input.source : "unknown";
@@ -79,8 +97,8 @@ class TraceHub {
   get events$() {
     return this.shared$;
   }
-  setMinLevel(process, level) {
-    this.minLevels[process] = level;
+  setMinLevel(process2, level) {
+    this.minLevels[process2] = level;
   }
   registerSink(sink) {
     this.sinks.add(sink);
@@ -88,36 +106,61 @@ class TraceHub {
       this.sinks.delete(sink);
     };
   }
-  publish(process, level, input) {
+  publish(process2, level, input) {
     const normalized = normalizeTraceInput(input);
     const event = {
       ...normalized,
       level,
-      process,
+      process: process2,
       timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-      traceSeq: this.nextTraceSeq++
+      traceSeq: this.nextTraceSeq++,
+      producerId: getTraceProducerId()
     };
-    if (traceLevelOrder(level) >= traceLevelOrder(this.minLevels[process])) {
+    if (traceLevelOrder(level) >= traceLevelOrder(this.minLevels[process2])) {
       this.publishToSinks(event);
       this.subject.next(event);
     }
     return event;
   }
-  publishRendererToSinks(level, input) {
-    if (this.sinks.size === 0) {
-      return;
-    }
-    if (traceLevelOrder(level) < traceLevelOrder(this.minLevels.renderer)) {
-      return;
-    }
+  /**
+   * Single renderer admission point: assigns timestamp, traceSeq, and
+   * producerId exactly once, then delivers the same event to sinks and
+   * events$ subscribers. The returned event is what the renderer transport
+   * must forward — no downstream stage may regenerate its identity.
+   *
+   * Callers gate on rendererEnabled/level BEFORE calling, so gated-out events
+   * consume no traceSeq.
+   */
+  admitRenderer(level, input) {
     const event = {
       ...input,
       level,
       process: "renderer",
       timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-      traceSeq: this.nextTraceSeq++
+      traceSeq: this.nextTraceSeq++,
+      producerId: getTraceProducerId()
     };
     this.publishToSinks(event);
+    this.subject.next(event);
+    return event;
+  }
+  /**
+   * Delivers an event admitted by a remote producer (e.g. a renderer event
+   * received over IPC) to this hub's sinks and events$ subscribers without
+   * reassigning identity or advancing this hub's own traceSeq counter.
+   * The min-level gate for the event's process still applies — delivery
+   * filtering is not identity assignment.
+   */
+  ingest(event) {
+    if (event.producerId !== void 0 && event.producerId === getTraceProducerId()) {
+      return;
+    }
+    const gate = this.minLevels[event.process] ?? this.minLevels.renderer;
+    if (traceLevelOrder(event.level) < traceLevelOrder(gate)) {
+      return;
+    }
+    this.publishToSinks(event);
+    this.subject.next(event);
   }
   publishToSinks(event) {
     if (this.sinks.size === 0) {
@@ -161,18 +204,38 @@ function setRendererTraceEnabled(enabled) {
 function publishMainTrace(level, input) {
   return getGlobalTraceHub().publish("main", level, input);
 }
-function publishTestTrace(process, level, input) {
-  return getGlobalTraceHub().publish(process, level, input);
+function publishTestTrace(process2, level, input) {
+  return getGlobalTraceHub().publish(process2, level, input);
 }
 function dispatchRendererTracePayload(rawPayload, context) {
   const payload = rawPayload ?? {};
   const level = normalizeTraceLevel(payload.level);
+  if (hasValidRemoteIdentity(payload)) {
+    const merged = mergeTraceRuntimeContext(payload, context);
+    getGlobalTraceHub().ingest({
+      ...merged,
+      level,
+      process: "renderer",
+      timestamp: payload.timestamp,
+      traceSeq: payload.traceSeq,
+      ...typeof payload.producerId === "string" && payload.producerId.trim().length > 0 ? { producerId: payload.producerId } : {}
+    });
+    return { ok: true, forwarded: true };
+  }
   getGlobalTraceHub().publish("renderer", level, mergeTraceRuntimeContext(payload, context));
   return {
     ok: true,
     forwarded: true
   };
 }
+function ingestRemoteTraceEvent(event, context) {
+  if (!hasValidRemoteIdentity(event)) {
+    return false;
+  }
+  const merged = context ? { ...mergeTraceRuntimeContext(event, context), level: event.level, process: event.process, timestamp: event.timestamp, traceSeq: event.traceSeq, ...event.producerId ? { producerId: event.producerId } : {} } : event;
+  getGlobalTraceHub().ingest(merged);
+  return true;
+}
 function setRendererTraceTransport(fn) {
   customRendererTraceTransport = fn;
 }
@@ -183,11 +246,10 @@ function emitRendererTrace(level, input) {
   if (traceLevelOrder(level) < traceLevelOrder(rendererMinLevel)) {
     return;
   }
-  const normalized = { ...normalizeTraceInput(input), level };
-  getGlobalTraceHub().publishRendererToSinks(level, normalized);
+  const event = getGlobalTraceHub().admitRenderer(level, normalizeTraceInput(input));
   if (customRendererTraceTransport) {
     try {
-      customRendererTraceTransport(normalized);
+      customRendererTraceTransport(event);
       return;
     } catch {
     }
@@ -197,7 +259,7 @@ function emitRendererTrace(level, input) {
     return;
   }
   try {
-    bridge.__trace(normalized);
+    bridge.__trace(event);
   } catch {
   }
 }
@@ -207,12 +269,15 @@ function clearTraceHubForTests() {
   rendererMinLevel = "debug";
   rendererEnabled = false;
   customRendererTraceTransport = null;
+  traceProducerId = null;
 }
 export {
   clearTraceHubForTests,
   dispatchRendererTracePayload,
   emitRendererTrace,
   getTraceEvents$,
+  getTraceProducerId,
+  ingestRemoteTraceEvent,
   normalizeTraceLevel,
   publishMainTrace,
   publishTestTrace,

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';\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    if (traceLevelOrder(level) < traceLevelOrder(this.minLevels.renderer)) {\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":[]}
+{"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   * Durable producer identity stamped at admission. Together with traceSeq it\n   * forms the identity key `(producerId, traceSeq)` across merged streams\n   * (main + ingested renderer events).\n   */\n  producerId?: string;\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;\nlet traceProducerId: string | null = null;\n\nfunction randomIdSuffix(): string {\n  const c = globalThis.crypto;\n  if (c && typeof c.randomUUID === 'function') {\n    return c.randomUUID();\n  }\n  return `${Date.now().toString(36)}-${Math.random().toString(16).slice(2)}`;\n}\n\n/**\n * Returns this process's durable trace producer identity, created lazily.\n * The identity is stable for the process lifetime represented by the hub's\n * traceSeq stream.\n */\nexport function getTraceProducerId(): string {\n  if (traceProducerId === null) {\n    const processTag = typeof process !== 'undefined' && process?.versions?.electron\n      ? (process.type === 'renderer' ? 'renderer' : 'main')\n      : (typeof window !== 'undefined' ? 'renderer' : 'main');\n    traceProducerId = `${processTag}:${randomIdSuffix()}`;\n  }\n  return traceProducerId;\n}\n\n/** Validates that an event carries usable remote identity fields. */\nfunction hasValidRemoteIdentity(event: Partial<TraceEvent>): event is Partial<TraceEvent> & {\n  timestamp: string;\n  traceSeq: number;\n} {\n  return typeof event.timestamp === 'string'\n    && Number.isFinite(Date.parse(event.timestamp))\n    && typeof event.traceSeq === 'number'\n    && Number.isSafeInteger(event.traceSeq)\n    && event.traceSeq >= 1;\n}\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      producerId: getTraceProducerId(),\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  /**\n   * Single renderer admission point: assigns timestamp, traceSeq, and\n   * producerId exactly once, then delivers the same event to sinks and\n   * events$ subscribers. The returned event is what the renderer transport\n   * must forward — no downstream stage may regenerate its identity.\n   *\n   * Callers gate on rendererEnabled/level BEFORE calling, so gated-out events\n   * consume no traceSeq.\n   */\n  admitRenderer(level: TraceLevel, input: TraceInput): TraceEvent {\n    const event: TraceEvent = {\n      ...input,\n      level,\n      process: 'renderer',\n      timestamp: new Date().toISOString(),\n      traceSeq: this.nextTraceSeq++,\n      producerId: getTraceProducerId(),\n    };\n    this.publishToSinks(event);\n    this.subject.next(event);\n    return event;\n  }\n\n  /**\n   * Delivers an event admitted by a remote producer (e.g. a renderer event\n   * received over IPC) to this hub's sinks and events$ subscribers without\n   * reassigning identity or advancing this hub's own traceSeq counter.\n   * The min-level gate for the event's process still applies — delivery\n   * filtering is not identity assignment.\n   */\n  ingest(event: TraceEvent): void {\n    // Same-process echo suppression: an event this process's own producer\n    // admitted was already delivered to sinks and events$ at admission\n    // (same-process bridge/test compositions loop the transport back into the\n    // same hub). Ingest is for events admitted by a REMOTE producer.\n    if (event.producerId !== undefined && event.producerId === getTraceProducerId()) {\n      return;\n    }\n    const gate = this.minLevels[event.process as TraceProcess] ?? this.minLevels.renderer;\n    if (traceLevelOrder(event.level) < traceLevelOrder(gate)) {\n      return;\n    }\n    this.publishToSinks(event);\n    this.subject.next(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<TraceEvent> & { level?: unknown };\n  const level = normalizeTraceLevel(payload.level);\n\n  if (hasValidRemoteIdentity(payload)) {\n    // The renderer already admitted this event: preserve its identity, merge\n    // main-side runtime context, and ingest without re-stamping.\n    const merged = mergeTraceRuntimeContext(payload, context);\n    getGlobalTraceHub().ingest({\n      ...merged,\n      level,\n      process: 'renderer',\n      timestamp: payload.timestamp,\n      traceSeq: payload.traceSeq,\n      ...(typeof payload.producerId === 'string' && payload.producerId.trim().length > 0\n        ? { producerId: payload.producerId }\n        : {}),\n    });\n    return { ok: true, forwarded: true };\n  }\n\n  // Legacy sender without identity: fall back to main-side re-admission.\n  getGlobalTraceHub().publish('renderer', level, mergeTraceRuntimeContext(payload, context));\n  return {\n    ok: true,\n    forwarded: true,\n  };\n}\n\n/**\n * Delivers an already-admitted remote trace event (e.g. a renderer event\n * unwrapped from a persisted IPC batch) to this process's sinks and events$\n * observers. Identity is preserved: no new timestamp, traceSeq, or producerId\n * is assigned, this hub's own counter does not advance, and the event is not\n * re-forwarded through any renderer transport.\n */\nexport function ingestRemoteTraceEvent(\n  event: TraceEvent,\n  context?: TraceRuntimeContext,\n): boolean {\n  if (!hasValidRemoteIdentity(event)) {\n    return false;\n  }\n  const merged = context\n    ? { ...mergeTraceRuntimeContext(event, context), level: event.level, process: event.process, timestamp: event.timestamp, traceSeq: event.traceSeq, ...(event.producerId ? { producerId: event.producerId } : {}) }\n    : event;\n  getGlobalTraceHub().ingest(merged as TraceEvent);\n  return true;\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  // Gate before admission so gated-out events consume no traceSeq.\n  if (traceLevelOrder(level) < traceLevelOrder(rendererMinLevel)) {\n    return;\n  }\n\n  // Single admission point: the same event (with timestamp/traceSeq/producerId)\n  // is what local sinks, events$ subscribers, and the transport all see.\n  const event = getGlobalTraceHub().admitRenderer(level, normalizeTraceInput(input));\n\n  if (customRendererTraceTransport) {\n    try {\n      customRendererTraceTransport(event);\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(event);\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  traceProducerId = null;\n}\n"],"mappings":"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","names":["process"]}

package/dist/tracing/trace_provider.cjs

@@ -229,10 +229,9 @@ TestTracer = __decorateClass([
   __decorateParam(0, (0, import_ioc.Inject)(TraceProviderConfiguration))
 ], TestTracer);
 let TraceProvider = class extends FrameworkTracer {
-  constructor(configuration, container) {
+  constructor(configuration) {
     super();
     this.configuration = configuration;
-    this.container = container;
   }
   get mode() {
     return this.resolveImplementation().mode;
@@ -269,7 +268,21 @@ let TraceProvider = class extends FrameworkTracer {
     return this.resolveSync(MainTracer);
   }
   resolveSync(token) {
-    const resolved = this.container.instance(token);
+    let scope = import_ioc.ExecutionContext.current() ?? this.lastScope;
+    if (scope && scope.isDisposed?.()) {
+      const root = scope.contextRoot?.();
+      const liveRoot = root && !root.isDisposed?.() ? root : void 0;
+      if (!liveRoot) return inertTracer();
+      scope = liveRoot;
+      this.lastScope = scope;
+    }
+    if (!scope) {
+      throw new Error(
+        `TraceProvider cannot resolve ${token.name}: no active IoC execution context. Resolve TraceProvider through the container and call it from IoC-managed code.`
+      );
+    }
+    this.lastScope = scope;
+    const resolved = scope.instance(token);
     if (resolved instanceof Promise) {
       throw new Error(`${token.name} must resolve synchronously`);
     }
@@ -277,10 +290,12 @@ let TraceProvider = class extends FrameworkTracer {
   }
 };
 TraceProvider = __decorateClass([
-  (0, import_ioc.Provider)(),
-  __decorateParam(0, (0, import_ioc.Inject)(TraceProviderConfiguration)),
-  __decorateParam(1, (0, import_ioc.Inject)(import_ioc.SCOPED_CONTAINER))
+  (0, import_ioc.Component)({ scope: import_ioc.LoadAs.Singleton }),
+  __decorateParam(0, (0, import_ioc.Inject)(TraceProviderConfiguration))
 ], TraceProvider);
+function inertTracer() {
+  return new Proxy({}, { get: () => () => void 0 });
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   FrameworkTracer,

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  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":[]}
+{"version":3,"sources":["../../src/tracing/trace_provider.ts"],"sourcesContent":["import { Component, Inject, LoadAs, Provider, SCOPED_CONTAINER, type IContainer, ExecutionContext } 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/**\n * Singleton, not scoped: TraceProvider is injected by singleton and scoped\n * services alike, so it must be safe to capture. It therefore injects no\n * container — delegate tracers resolve through the ACTIVE IoC execution\n * context (D25/D26: method calls on IoC-resolved instances run under their\n * owning environment, so a scope is present whenever the provider is used\n * through the container). Delegates are root-shared Singletons, so any\n * scope of the owning hierarchy resolves the same instances; the last seen\n * scope is kept as a fallback for context-less call sites.\n */\n@Component({ scope: LoadAs.Singleton })\nexport class TraceProvider extends FrameworkTracer {\n  private lastScope: IContainer | undefined;\n\n  constructor(\n    @Inject(TraceProviderConfiguration) private readonly configuration: TraceProviderConfiguration,\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    let scope: IContainer | undefined = (ExecutionContext.current() as IContainer | undefined) ?? this.lastScope;\n    // Fire-and-forget emission can outlive the scope that was active when it\n    // was scheduled (a wood operation scope is disposed at dispatch end).\n    // Delegate tracers are root-shared Singletons, so degrade to the live\n    // hierarchy root rather than re-entering a disposed scope.\n    if (scope && (scope as { isDisposed?: () => boolean }).isDisposed?.()) {\n      const root = (scope as { contextRoot?: () => IContainer }).contextRoot?.();\n      const liveRoot = root && !(root as { isDisposed?: () => boolean }).isDisposed?.() ? root : undefined;\n      // The whole hierarchy is gone (environment teardown): emission from a\n      // service's own dispose hook is fire-and-forget by design, so it is\n      // dropped rather than failing the teardown it is part of.\n      if (!liveRoot) return inertTracer<T>();\n      scope = liveRoot;\n      this.lastScope = scope;\n    }\n    if (!scope) {\n      throw new Error(\n        `TraceProvider cannot resolve ${token.name}: no active IoC execution context. ` +\n        'Resolve TraceProvider through the container and call it from IoC-managed code.'\n      );\n    }\n    this.lastScope = scope;\n    const resolved = scope.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\n/** A delegate whose every method is a no-op: emission after the hierarchy is disposed. */\nfunction inertTracer<T>(): T {\n  return new Proxy({}, { get: () => () => undefined }) as T;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,iBAAyG;AAEzG,uBAaO;AAUA,MAAe,gBAAgB;AAAA,EAUpC,aAAa,MAAiD;AAC5D,eAAO,oCAAkB,IAAI;AAAA,EAC/B;AAAA,EAEA,OAAO,SAAwC;AAC7C,WAAO,IAAI,iBAAiB,MAAM,OAAO;AAAA,EAC3C;AACF;AAEA,MAAM,yBAAyB,gBAAgB;AAAA,EAC7C,YACmB,QACA,SACjB;AACA,UAAM;AAHW;AACA;AAAA,EAGnB;AAAA,EAEA,IAAI,OAA0B;AAC5B,WAAO,KAAK,OAAO;AAAA,EACrB;AAAA,EAEA,IAAI,UAAwB;AAC1B,WAAO,KAAK,OAAO;AAAA,EACrB;AAAA,EAEA,IAAI,UAAkC;AACpC,WAAO,KAAK,OAAO;AAAA,EACrB;AAAA,EAEA,QAAQ,OAAmB,OAAyB;AAClD,SAAK,OAAO,QAAQ,OAAO,KAAK,WAAW,KAAK,CAAC;AAAA,EACnD;AAAA,EAEA,MAAM,OAAyB;AAC7B,SAAK,OAAO,MAAM,KAAK,WAAW,KAAK,CAAC;AAAA,EAC1C;AAAA,EAEA,KAAK,OAAyB;AAC5B,SAAK,OAAO,KAAK,KAAK,WAAW,KAAK,CAAC;AAAA,EACzC;AAAA,EAEA,KAAK,OAAyB;AAC5B,SAAK,OAAO,KAAK,KAAK,WAAW,KAAK,CAAC;AAAA,EACzC;AAAA,EAEA,MAAM,OAAyB;AAC7B,SAAK,OAAO,MAAM,KAAK,WAAW,KAAK,CAAC;AAAA,EAC1C;AAAA,EAEQ,WAAW,OAA+B;AAChD,WAAO;AAAA,MACL,GAAG,KAAK;AAAA,MACR,GAAG;AAAA,IACL;AAAA,EACF;AACF;AAGO,IAAM,6BAAN,MAAiC;AAAA,EAAjC;AACL,SAAQ,OAA0B;AAClC,SAAQ,UAAwB;AAChC,SAAQ,WAAuB;AAC/B,SAAQ,UAA0B;AAClC,SAAQ,eAA8B;AAAA;AAAA,EAEtC,cAAc,MAA+B;AAC3C,SAAK,OAAO;AAAA,EACd;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,sBAAsB,cAAmC;AACvD,SAAK,eAAe;AAAA,EACtB;AAAA,EAEA,kBAAiC;AAC/B,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,iBAAiB,SAA6B;AAC5C,SAAK,UAAU;AACf,SAAK,0BAA0B;AAAA,EACjC;AAAA,EAEA,kBAAkB,OAAyB;AACzC,SAAK,WAAW;AAChB,SAAK,0BAA0B;AAAA,EACjC;AAAA,EAEA,iBAAiB,SAAwB;AACvC,SAAK,UAAU;AACf,SAAK,0BAA0B;AAAA,EACjC;AAAA,EAEA,UAA6B;AAC3B,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,aAA2B;AACzB,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,cAA0B;AACxB,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,aAAsB;AACpB,WAAO,KAAK,YAAY,KAAK,YAAY,aAAa,QAAQ;AAAA,EAChE;AAAA,EAEQ,4BAAkC;AACxC,QAAI,KAAK,YAAY,YAAY;AAC/B,oDAAwB,KAAK,WAAW,CAAC;AACzC,qDAAyB,KAAK,QAAQ;AACtC;AAAA,IACF;AAEA,+CAAqB,KAAK,QAAQ;AAAA,EACpC;AACF;AAhEa,6BAAN;AAAA,MADN,sBAAU,EAAE,OAAO,kBAAO,UAAU,CAAC;AAAA,GACzB;AAmEN,IAAM,aAAN,cAAyB,gBAAgB;AAAA,EAAzC;AAAA;AACL,SAAS,OAAO;AAChB,SAAS,UAAU;AACnB,SAAS,cAAU,kCAAgB;AAAA;AAAA,EAEnC,QAAQ,OAAmB,OAAyB;AAClD,2CAAiB,OAAO,KAAK;AAAA,EAC/B;AAAA,EAEA,MAAM,OAAyB;AAC7B,SAAK,QAAQ,SAAS,KAAK;AAAA,EAC7B;AAAA,EAEA,KAAK,OAAyB;AAC5B,SAAK,QAAQ,QAAQ,KAAK;AAAA,EAC5B;AAAA,EAEA,KAAK,OAAyB;AAC5B,SAAK,QAAQ,QAAQ,KAAK;AAAA,EAC5B;AAAA,EAEA,MAAM,OAAyB;AAC7B,SAAK,QAAQ,SAAS,KAAK;AAAA,EAC7B;AACF;AAxBa,aAAN;AAAA,MADN,sBAAU,EAAE,OAAO,kBAAO,UAAU,CAAC;AAAA,GACzB;AA2BN,IAAM,iBAAN,cAA6B,gBAAgB;AAAA,EAA7C;AAAA;AACL,SAAS,OAAO;AAChB,SAAS,UAAU;AACnB,SAAS,cAAU,kCAAgB;AAAA;AAAA,EAEnC,QAAQ,OAAmB,OAAyB;AAClD,4CAAkB,OAAO,KAAK;AAAA,EAChC;AAAA,EAEA,MAAM,OAAyB;AAC7B,SAAK,QAAQ,SAAS,KAAK;AAAA,EAC7B;AAAA,EAEA,KAAK,OAAyB;AAC5B,SAAK,QAAQ,QAAQ,KAAK;AAAA,EAC5B;AAAA,EAEA,KAAK,OAAyB;AAC5B,SAAK,QAAQ,QAAQ,KAAK;AAAA,EAC5B;AAAA,EAEA,MAAM,OAAyB;AAC7B,SAAK,QAAQ,SAAS,KAAK;AAAA,EAC7B;AACF;AAxBa,iBAAN;AAAA,MADN,sBAAU,EAAE,OAAO,kBAAO,UAAU,CAAC;AAAA,GACzB;AA2BN,IAAM,aAAN,cAAyB,gBAAgB;AAAA,EAI9C,YACuD,eACrD;AACA,UAAM;AAF+C;AAJvD,SAAS,OAAO;AAChB,SAAS,cAAU,kCAAgB;AAAA,EAMnC;AAAA,EAEA,IAAI,UAAwB;AAC1B,UAAM,UAAU,KAAK,cAAc,WAAW;AAC9C,QAAI,YAAY,WAAY,QAAO;AACnC,QAAI,YAAY,OAAQ,QAAO;AAC/B,WAAO;AAAA,EACT;AAAA,EAEA,QAAQ,OAAmB,OAAyB;AAClD,SAAK,QAAQ,OAAO,KAAK;AAAA,EAC3B;AAAA,EAEA,MAAM,OAAyB;AAC7B,SAAK,QAAQ,SAAS,KAAK;AAAA,EAC7B;AAAA,EAEA,KAAK,OAAyB;AAC5B,SAAK,QAAQ,QAAQ,KAAK;AAAA,EAC5B;AAAA,EAEA,KAAK,OAAyB;AAC5B,SAAK,QAAQ,QAAQ,KAAK;AAAA,EAC5B;AAAA,EAEA,MAAM,OAAyB;AAC7B,SAAK,QAAQ,SAAS,KAAK;AAAA,EAC7B;AAAA,EAEQ,QAAQ,OAAmB,OAAyB;AAC1D,2CAAiB,KAAK,SAAS,OAAO,KAAK;AAAA,EAC7C;AACF;AAxCa,aAAN;AAAA,MADN,sBAAU,EAAE,OAAO,kBAAO,UAAU,CAAC;AAAA,EAMjC,0CAAO,0BAA0B;AAAA,GALzB;AAqDN,IAAM,gBAAN,cAA4B,gBAAgB;AAAA,EAGjD,YACuD,eACrD;AACA,UAAM;AAF+C;AAAA,EAGvD;AAAA,EAEA,IAAI,OAA0B;AAC5B,WAAO,KAAK,sBAAsB,EAAE;AAAA,EACtC;AAAA,EAEA,IAAI,UAAwB;AAC1B,WAAO,KAAK,sBAAsB,EAAE;AAAA,EACtC;AAAA,EAEA,IAAI,UAAkC;AACpC,WAAO,KAAK,sBAAsB,EAAE;AAAA,EACtC;AAAA,EAEA,QAAQ,OAAmB,OAAyB;AAClD,SAAK,sBAAsB,EAAE,QAAQ,OAAO,KAAK;AAAA,EACnD;AAAA,EAEA,MAAM,OAAyB;AAC7B,SAAK,sBAAsB,EAAE,MAAM,KAAK;AAAA,EAC1C;AAAA,EAEA,KAAK,OAAyB;AAC5B,SAAK,sBAAsB,EAAE,KAAK,KAAK;AAAA,EACzC;AAAA,EAEA,KAAK,OAAyB;AAC5B,SAAK,sBAAsB,EAAE,KAAK,KAAK;AAAA,EACzC;AAAA,EAEA,MAAM,OAAyB;AAC7B,SAAK,sBAAsB,EAAE,MAAM,KAAK;AAAA,EAC1C;AAAA,EAEQ,wBAAyC;AAC/C,UAAM,OAAO,KAAK,cAAc,QAAQ;AACxC,QAAI,SAAS,QAAQ;AACnB,aAAO,KAAK,YAAY,UAAU;AAAA,IACpC;AAEA,QAAI,KAAK,cAAc,WAAW,MAAM,YAAY;AAClD,aAAO,KAAK,YAAY,cAAc;AAAA,IACxC;AAEA,WAAO,KAAK,YAAY,UAAU;AAAA,EACpC;AAAA,EAEQ,YAAe,OAAqC;AAC1D,QAAI,QAAiC,4BAAiB,QAAQ,KAAgC,KAAK;AAKnG,QAAI,SAAU,MAAyC,aAAa,GAAG;AACrE,YAAM,OAAQ,MAA6C,cAAc;AACzE,YAAM,WAAW,QAAQ,CAAE,KAAwC,aAAa,IAAI,OAAO;AAI3F,UAAI,CAAC,SAAU,QAAO,YAAe;AACrC,cAAQ;AACR,WAAK,YAAY;AAAA,IACnB;AACA,QAAI,CAAC,OAAO;AACV,YAAM,IAAI;AAAA,QACR,gCAAgC,MAAM,IAAI;AAAA,MAE5C;AAAA,IACF;AACA,SAAK,YAAY;AACjB,UAAM,WAAW,MAAM,SAAkB,KAAK;AAC9C,QAAI,oBAAoB,SAAS;AAC/B,YAAM,IAAI,MAAM,GAAG,MAAM,IAAI,6BAA6B;AAAA,IAC5D;AACA,WAAO;AAAA,EACT;AACF;AAnFa,gBAAN;AAAA,MADN,sBAAU,EAAE,OAAO,kBAAO,UAAU,CAAC;AAAA,EAKjC,0CAAO,0BAA0B;AAAA,GAJzB;AAsFb,SAAS,cAAoB;AAC3B,SAAO,IAAI,MAAM,CAAC,GAAG,EAAE,KAAK,MAAM,MAAM,OAAU,CAAC;AACrD;","names":[]}

package/dist/tracing/trace_provider.d.cts

@@ -1,6 +1,5 @@
-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';
+import { d as TraceProcess, a as TraceEvent, c as TraceLevel, b as TraceInput, W as WoodTraceEventSink, h as WoodTraceSinkDisposer } from '../trace_hub-Cpo_nVze.cjs';
 
 type TraceProviderMode = 'live' | 'test';
 type TraceRuntime = 'main' | 'renderer' | 'test';
@@ -73,10 +72,20 @@ declare class TestTracer extends FrameworkTracer {
     error(event: TraceInput): void;
     private publish;
 }
+/**
+ * Singleton, not scoped: TraceProvider is injected by singleton and scoped
+ * services alike, so it must be safe to capture. It therefore injects no
+ * container — delegate tracers resolve through the ACTIVE IoC execution
+ * context (D25/D26: method calls on IoC-resolved instances run under their
+ * owning environment, so a scope is present whenever the provider is used
+ * through the container). Delegates are root-shared Singletons, so any
+ * scope of the owning hierarchy resolves the same instances; the last seen
+ * scope is kept as a fallback for context-less call sites.
+ */
 declare class TraceProvider extends FrameworkTracer {
     private readonly configuration;
-    private readonly container;
-    constructor(configuration: TraceProviderConfiguration, container: IContainer);
+    private lastScope;
+    constructor(configuration: TraceProviderConfiguration);
     get mode(): TraceProviderMode;
     get process(): TraceProcess;
     get events$(): Observable<TraceEvent>;

package/dist/tracing/trace_provider.d.ts

@@ -1,6 +1,5 @@
-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';
+import { d as TraceProcess, a as TraceEvent, c as TraceLevel, b as TraceInput, W as WoodTraceEventSink, h as WoodTraceSinkDisposer } from '../trace_hub-Cpo_nVze.js';
 
 type TraceProviderMode = 'live' | 'test';
 type TraceRuntime = 'main' | 'renderer' | 'test';
@@ -73,10 +72,20 @@ declare class TestTracer extends FrameworkTracer {
     error(event: TraceInput): void;
     private publish;
 }
+/**
+ * Singleton, not scoped: TraceProvider is injected by singleton and scoped
+ * services alike, so it must be safe to capture. It therefore injects no
+ * container — delegate tracers resolve through the ACTIVE IoC execution
+ * context (D25/D26: method calls on IoC-resolved instances run under their
+ * owning environment, so a scope is present whenever the provider is used
+ * through the container). Delegates are root-shared Singletons, so any
+ * scope of the owning hierarchy resolves the same instances; the last seen
+ * scope is kept as a fallback for context-less call sites.
+ */
 declare class TraceProvider extends FrameworkTracer {
     private readonly configuration;
-    private readonly container;
-    constructor(configuration: TraceProviderConfiguration, container: IContainer);
+    private lastScope;
+    constructor(configuration: TraceProviderConfiguration);
     get mode(): TraceProviderMode;
     get process(): TraceProcess;
     get events$(): Observable<TraceEvent>;

package/dist/tracing/trace_provider.js

@@ -9,7 +9,7 @@ var __decorateClass = (decorators, target, key, kind) => {
   return result;
 };
 var __decorateParam = (index, decorator) => (target, key) => decorator(target, key, index);
-import { Component, Inject, LoadAs, Provider, SCOPED_CONTAINER } from "@noego/ioc";
+import { Component, Inject, LoadAs, ExecutionContext } from "@noego/ioc";
 import {
   emitRendererTrace,
   getTraceEvents$,
@@ -212,10 +212,9 @@ TestTracer = __decorateClass([
   __decorateParam(0, Inject(TraceProviderConfiguration))
 ], TestTracer);
 let TraceProvider = class extends FrameworkTracer {
-  constructor(configuration, container) {
+  constructor(configuration) {
     super();
     this.configuration = configuration;
-    this.container = container;
   }
   get mode() {
     return this.resolveImplementation().mode;
@@ -252,7 +251,21 @@ let TraceProvider = class extends FrameworkTracer {
     return this.resolveSync(MainTracer);
   }
   resolveSync(token) {
-    const resolved = this.container.instance(token);
+    let scope = ExecutionContext.current() ?? this.lastScope;
+    if (scope && scope.isDisposed?.()) {
+      const root = scope.contextRoot?.();
+      const liveRoot = root && !root.isDisposed?.() ? root : void 0;
+      if (!liveRoot) return inertTracer();
+      scope = liveRoot;
+      this.lastScope = scope;
+    }
+    if (!scope) {
+      throw new Error(
+        `TraceProvider cannot resolve ${token.name}: no active IoC execution context. Resolve TraceProvider through the container and call it from IoC-managed code.`
+      );
+    }
+    this.lastScope = scope;
+    const resolved = scope.instance(token);
     if (resolved instanceof Promise) {
       throw new Error(`${token.name} must resolve synchronously`);
     }
@@ -260,10 +273,12 @@ let TraceProvider = class extends FrameworkTracer {
   }
 };
 TraceProvider = __decorateClass([
-  Provider(),
-  __decorateParam(0, Inject(TraceProviderConfiguration)),
-  __decorateParam(1, Inject(SCOPED_CONTAINER))
+  Component({ scope: LoadAs.Singleton }),
+  __decorateParam(0, Inject(TraceProviderConfiguration))
 ], TraceProvider);
+function inertTracer() {
+  return new Proxy({}, { get: () => () => void 0 });
+}
 export {
   FrameworkTracer,
   MainTracer,

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  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":[]}
+{"version":3,"sources":["../../src/tracing/trace_provider.ts"],"sourcesContent":["import { Component, Inject, LoadAs, Provider, SCOPED_CONTAINER, type IContainer, ExecutionContext } 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/**\n * Singleton, not scoped: TraceProvider is injected by singleton and scoped\n * services alike, so it must be safe to capture. It therefore injects no\n * container — delegate tracers resolve through the ACTIVE IoC execution\n * context (D25/D26: method calls on IoC-resolved instances run under their\n * owning environment, so a scope is present whenever the provider is used\n * through the container). Delegates are root-shared Singletons, so any\n * scope of the owning hierarchy resolves the same instances; the last seen\n * scope is kept as a fallback for context-less call sites.\n */\n@Component({ scope: LoadAs.Singleton })\nexport class TraceProvider extends FrameworkTracer {\n  private lastScope: IContainer | undefined;\n\n  constructor(\n    @Inject(TraceProviderConfiguration) private readonly configuration: TraceProviderConfiguration,\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    let scope: IContainer | undefined = (ExecutionContext.current() as IContainer | undefined) ?? this.lastScope;\n    // Fire-and-forget emission can outlive the scope that was active when it\n    // was scheduled (a wood operation scope is disposed at dispatch end).\n    // Delegate tracers are root-shared Singletons, so degrade to the live\n    // hierarchy root rather than re-entering a disposed scope.\n    if (scope && (scope as { isDisposed?: () => boolean }).isDisposed?.()) {\n      const root = (scope as { contextRoot?: () => IContainer }).contextRoot?.();\n      const liveRoot = root && !(root as { isDisposed?: () => boolean }).isDisposed?.() ? root : undefined;\n      // The whole hierarchy is gone (environment teardown): emission from a\n      // service's own dispose hook is fire-and-forget by design, so it is\n      // dropped rather than failing the teardown it is part of.\n      if (!liveRoot) return inertTracer<T>();\n      scope = liveRoot;\n      this.lastScope = scope;\n    }\n    if (!scope) {\n      throw new Error(\n        `TraceProvider cannot resolve ${token.name}: no active IoC execution context. ` +\n        'Resolve TraceProvider through the container and call it from IoC-managed code.'\n      );\n    }\n    this.lastScope = scope;\n    const resolved = scope.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\n/** A delegate whose every method is a no-op: emission after the hierarchy is disposed. */\nfunction inertTracer<T>(): T {\n  return new Proxy({}, { get: () => () => undefined }) as T;\n}\n"],"mappings":"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","names":[]}

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

@@ -1 +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":[]}
+{"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     * Hub-admitted identity, present when the renderer TraceHub admitted the\n     * event before it reached the transport. The transport preserves these\n     * exactly; it stamps its own only for legacy senders that omit them.\n     */\n    readonly timestamp?: string;\n    readonly traceSeq?: number;\n    readonly producerId?: string;\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  /**\n   * Count of stamped events whose traceSeq regressed against this transport's\n   * sequence stream and were restamped as legacy. Nonzero means more than one\n   * admission source is feeding one transport — the invariant is broken.\n   */\n  identityRestamped: 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":[]}