@noego/wood 0.3.0 → 0.4.1

package/dist/tracing/trace_hub.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/tracing/trace_hub.ts"],"sourcesContent":["import { Observable, Subject, Subscription } 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};\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 TraceCaptureOptions = {\n  maxEvents?: number;\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 PendingWaiter = {\n  predicate: (event: TraceEvent) => boolean;\n  resolve: (event: TraceEvent) => void;\n  reject: (error: Error) => void;\n  timeoutId?: ReturnType<typeof setTimeout>;\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 payload = isRecord(input.payload) ? { ...input.payload } : undefined;\n\n  return {\n    source,\n    type,\n    ...(message ? { message } : {}),\n    ...(conversationId !== undefined ? { conversationId } : {}),\n    ...(payload ? { payload } : {}),\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\nexport class TraceCapture {\n  private readonly buffer: TraceEvent[] = [];\n  private readonly pending = new Set<PendingWaiter>();\n  private readonly maxEvents: number;\n  private subscription: Subscription;\n\n  constructor(\n    source$: Observable<TraceEvent>,\n    options: TraceCaptureOptions = {},\n  ) {\n    this.maxEvents = Math.max(1, options.maxEvents ?? 1000);\n    this.subscription = source$.subscribe((event) => {\n      this.buffer.push(event);\n      if (this.buffer.length > this.maxEvents) {\n        this.buffer.splice(0, this.buffer.length - this.maxEvents);\n      }\n      for (const waiter of Array.from(this.pending)) {\n        if (!waiter.predicate(event)) {\n          continue;\n        }\n        if (waiter.timeoutId) {\n          clearTimeout(waiter.timeoutId);\n        }\n        this.pending.delete(waiter);\n        waiter.resolve(event);\n      }\n    });\n  }\n\n  events(): TraceEvent[] {\n    return [...this.buffer];\n  }\n\n  async waitFor(\n    predicate: (event: TraceEvent) => boolean,\n    options: TraceWaitOptions = {},\n  ): Promise<TraceEvent> {\n    const existing = this.buffer.find(predicate);\n    if (existing) {\n      return existing;\n    }\n\n    return new Promise<TraceEvent>((resolve, reject) => {\n      const waiter: PendingWaiter = {\n        predicate,\n        resolve,\n        reject,\n      };\n      const timeoutMs = options.timeoutMs ?? 5000;\n      waiter.timeoutId = setTimeout(() => {\n        this.pending.delete(waiter);\n        reject(new Error(`Timed out waiting for trace event after ${timeoutMs}ms`));\n      }, timeoutMs);\n      this.pending.add(waiter);\n    });\n  }\n\n  async writeArtifact(targetPath: string): Promise<void> {\n    const [{ mkdir, writeFile }, pathModule] = await Promise.all([\n      import('node:fs/promises'),\n      import('node:path'),\n    ]);\n    await mkdir(pathModule.dirname(targetPath), { recursive: true });\n    const lines = this.buffer.map((event) => JSON.stringify(event)).join('\\n');\n    await writeFile(targetPath, `${lines}${lines.length > 0 ? '\\n' : ''}`, 'utf8');\n  }\n\n  stop(): void {\n    for (const waiter of this.pending) {\n      if (waiter.timeoutId) {\n        clearTimeout(waiter.timeoutId);\n      }\n      waiter.reject(new Error('Trace capture stopped before predicate matched'));\n    }\n    this.pending.clear();\n    this.subscription.unsubscribe();\n  }\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  capture(options: TraceCaptureOptions = {}): TraceCapture {\n    return new TraceCapture(this.events$, options);\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(rawPayload: unknown): 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, payload);\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 createTraceCapture(options: TraceCaptureOptions = {}): TraceCapture {\n  return getGlobalTraceHub().capture(options);\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, Subscription } 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 TraceCaptureOptions = {\n  maxEvents?: number;\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 PendingWaiter = {\n  predicate: (event: TraceEvent) => boolean;\n  resolve: (event: TraceEvent) => void;\n  reject: (error: Error) => void;\n  timeoutId?: ReturnType<typeof setTimeout>;\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\nexport class TraceCapture {\n  private readonly buffer: TraceEvent[] = [];\n  private readonly pending = new Set<PendingWaiter>();\n  private readonly maxEvents: number;\n  private subscription: Subscription;\n\n  constructor(\n    source$: Observable<TraceEvent>,\n    options: TraceCaptureOptions = {},\n  ) {\n    this.maxEvents = Math.max(1, options.maxEvents ?? 1000);\n    this.subscription = source$.subscribe((event) => {\n      this.buffer.push(event);\n      if (this.buffer.length > this.maxEvents) {\n        this.buffer.splice(0, this.buffer.length - this.maxEvents);\n      }\n      for (const waiter of Array.from(this.pending)) {\n        if (!waiter.predicate(event)) {\n          continue;\n        }\n        if (waiter.timeoutId) {\n          clearTimeout(waiter.timeoutId);\n        }\n        this.pending.delete(waiter);\n        waiter.resolve(event);\n      }\n    });\n  }\n\n  events(): TraceEvent[] {\n    return [...this.buffer];\n  }\n\n  async waitFor(\n    predicate: (event: TraceEvent) => boolean,\n    options: TraceWaitOptions = {},\n  ): Promise<TraceEvent> {\n    const existing = this.buffer.find(predicate);\n    if (existing) {\n      return existing;\n    }\n\n    return new Promise<TraceEvent>((resolve, reject) => {\n      const waiter: PendingWaiter = {\n        predicate,\n        resolve,\n        reject,\n      };\n      const timeoutMs = options.timeoutMs ?? 5000;\n      waiter.timeoutId = setTimeout(() => {\n        this.pending.delete(waiter);\n        reject(new Error(`Timed out waiting for trace event after ${timeoutMs}ms`));\n      }, timeoutMs);\n      this.pending.add(waiter);\n    });\n  }\n\n  async writeArtifact(targetPath: string): Promise<void> {\n    const [{ mkdir, writeFile }, pathModule] = await Promise.all([\n      import('node:fs/promises'),\n      import('node:path'),\n    ]);\n    await mkdir(pathModule.dirname(targetPath), { recursive: true });\n    const lines = this.buffer.map((event) => JSON.stringify(event)).join('\\n');\n    await writeFile(targetPath, `${lines}${lines.length > 0 ? '\\n' : ''}`, 'utf8');\n  }\n\n  stop(): void {\n    for (const waiter of this.pending) {\n      if (waiter.timeoutId) {\n        clearTimeout(waiter.timeoutId);\n      }\n      waiter.reject(new Error('Trace capture stopped before predicate matched'));\n    }\n    this.pending.clear();\n    this.subscription.unsubscribe();\n  }\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  capture(options: TraceCaptureOptions = {}): TraceCapture {\n    return new TraceCapture(this.events$, options);\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 createTraceCapture(options: TraceCaptureOptions = {}): TraceCapture {\n  return getGlobalTraceHub().capture(options);\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_hub.d.cts

@@ -8,6 +8,10 @@ type TraceInput = {
     message?: string;
     conversationId?: number | string;
     payload?: Record<string, unknown>;
+    windowId?: string;
+    webContentsId?: number;
+    routeKey?: string;
+    harnessId?: string;
 };
 type TraceEvent = TraceInput & {
     level: TraceLevel;
@@ -19,6 +23,12 @@ type TraceDispatchResult = {
     ok: boolean;
     forwarded: boolean;
 };
+type TraceRuntimeContext = {
+    windowId?: string;
+    webContentsId?: number;
+    routeKey?: string;
+    harnessId?: string;
+};
 type TraceCaptureOptions = {
     maxEvents?: number;
 };
@@ -42,10 +52,10 @@ declare function setRendererTraceMinLevel(level: TraceLevel): void;
 declare function setRendererTraceEnabled(enabled: boolean): void;
 declare function publishMainTrace(level: TraceLevel, input: unknown): TraceEvent;
 declare function publishTestTrace(process: TraceProcess, level: TraceLevel, input: unknown): TraceEvent;
-declare function dispatchRendererTracePayload(rawPayload: unknown): TraceDispatchResult;
+declare function dispatchRendererTracePayload(rawPayload: unknown, context?: TraceRuntimeContext): TraceDispatchResult;
 declare function setRendererTraceTransport(fn: ((payload: unknown) => void) | null): void;
 declare function emitRendererTrace(level: TraceLevel, input: TraceInput): void;
 declare function createTraceCapture(options?: TraceCaptureOptions): TraceCapture;
 declare function clearTraceHubForTests(): void;
 
-export { TraceCapture, type TraceCaptureOptions, type TraceDispatchResult, type TraceEvent, type TraceInput, type TraceLevel, type TraceProcess, type TraceWaitOptions, clearTraceHubForTests, createTraceCapture, dispatchRendererTracePayload, emitRendererTrace, getTraceEvents$, publishMainTrace, publishTestTrace, setMainTraceMinLevel, setRendererTraceEnabled, setRendererTraceMinLevel, setRendererTraceTransport };
+export { TraceCapture, type TraceCaptureOptions, type TraceDispatchResult, type TraceEvent, type TraceInput, type TraceLevel, type TraceProcess, type TraceRuntimeContext, type TraceWaitOptions, clearTraceHubForTests, createTraceCapture, dispatchRendererTracePayload, emitRendererTrace, getTraceEvents$, publishMainTrace, publishTestTrace, setMainTraceMinLevel, setRendererTraceEnabled, setRendererTraceMinLevel, setRendererTraceTransport };

package/dist/tracing/trace_hub.d.ts

@@ -8,6 +8,10 @@ type TraceInput = {
     message?: string;
     conversationId?: number | string;
     payload?: Record<string, unknown>;
+    windowId?: string;
+    webContentsId?: number;
+    routeKey?: string;
+    harnessId?: string;
 };
 type TraceEvent = TraceInput & {
     level: TraceLevel;
@@ -19,6 +23,12 @@ type TraceDispatchResult = {
     ok: boolean;
     forwarded: boolean;
 };
+type TraceRuntimeContext = {
+    windowId?: string;
+    webContentsId?: number;
+    routeKey?: string;
+    harnessId?: string;
+};
 type TraceCaptureOptions = {
     maxEvents?: number;
 };
@@ -42,10 +52,10 @@ declare function setRendererTraceMinLevel(level: TraceLevel): void;
 declare function setRendererTraceEnabled(enabled: boolean): void;
 declare function publishMainTrace(level: TraceLevel, input: unknown): TraceEvent;
 declare function publishTestTrace(process: TraceProcess, level: TraceLevel, input: unknown): TraceEvent;
-declare function dispatchRendererTracePayload(rawPayload: unknown): TraceDispatchResult;
+declare function dispatchRendererTracePayload(rawPayload: unknown, context?: TraceRuntimeContext): TraceDispatchResult;
 declare function setRendererTraceTransport(fn: ((payload: unknown) => void) | null): void;
 declare function emitRendererTrace(level: TraceLevel, input: TraceInput): void;
 declare function createTraceCapture(options?: TraceCaptureOptions): TraceCapture;
 declare function clearTraceHubForTests(): void;
 
-export { TraceCapture, type TraceCaptureOptions, type TraceDispatchResult, type TraceEvent, type TraceInput, type TraceLevel, type TraceProcess, type TraceWaitOptions, clearTraceHubForTests, createTraceCapture, dispatchRendererTracePayload, emitRendererTrace, getTraceEvents$, publishMainTrace, publishTestTrace, setMainTraceMinLevel, setRendererTraceEnabled, setRendererTraceMinLevel, setRendererTraceTransport };
+export { TraceCapture, type TraceCaptureOptions, type TraceDispatchResult, type TraceEvent, type TraceInput, type TraceLevel, type TraceProcess, type TraceRuntimeContext, type TraceWaitOptions, clearTraceHubForTests, createTraceCapture, dispatchRendererTracePayload, emitRendererTrace, getTraceEvents$, publishMainTrace, publishTestTrace, setMainTraceMinLevel, setRendererTraceEnabled, setRendererTraceMinLevel, setRendererTraceTransport };

package/dist/tracing/trace_hub.js

@@ -16,15 +16,32 @@ function normalizeTraceInput(raw) {
   const type = typeof input.type === "string" && input.type.trim().length > 0 ? input.type : "unknown";
   const message = typeof input.message === "string" ? input.message : void 0;
   const conversationId = typeof input.conversationId === "number" || typeof input.conversationId === "string" ? input.conversationId : void 0;
+  const windowId = typeof input.windowId === "string" && input.windowId.trim().length > 0 ? input.windowId : void 0;
+  const webContentsId = typeof input.webContentsId === "number" && Number.isFinite(input.webContentsId) ? input.webContentsId : void 0;
+  const routeKey = typeof input.routeKey === "string" && input.routeKey.trim().length > 0 ? input.routeKey : void 0;
+  const harnessId = typeof input.harnessId === "string" && input.harnessId.trim().length > 0 ? input.harnessId : void 0;
   const payload = isRecord(input.payload) ? { ...input.payload } : void 0;
   return {
     source,
     type,
     ...message ? { message } : {},
     ...conversationId !== void 0 ? { conversationId } : {},
+    ...windowId !== void 0 ? { windowId } : {},
+    ...webContentsId !== void 0 ? { webContentsId } : {},
+    ...routeKey !== void 0 ? { routeKey } : {},
+    ...harnessId !== void 0 ? { harnessId } : {},
     ...payload ? { payload } : {}
   };
 }
+function mergeTraceRuntimeContext(input, context) {
+  if (!context) {
+    return normalizeTraceInput(input);
+  }
+  return normalizeTraceInput({
+    ...isRecord(input) ? input : {},
+    ...context
+  });
+}
 function isRecord(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -161,10 +178,10 @@ function publishMainTrace(level, input) {
 function publishTestTrace(process, level, input) {
   return getGlobalTraceHub().publish(process, level, input);
 }
-function dispatchRendererTracePayload(rawPayload) {
+function dispatchRendererTracePayload(rawPayload, context) {
   const payload = rawPayload ?? {};
   const level = payload.level === "debug" || payload.level === "info" || payload.level === "warn" || payload.level === "error" ? payload.level : "info";
-  getGlobalTraceHub().publish("renderer", level, payload);
+  getGlobalTraceHub().publish("renderer", level, mergeTraceRuntimeContext(payload, context));
   return {
     ok: true,
     forwarded: true

package/dist/tracing/trace_hub.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/tracing/trace_hub.ts"],"sourcesContent":["import { Observable, Subject, Subscription } 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};\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 TraceCaptureOptions = {\n  maxEvents?: number;\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 PendingWaiter = {\n  predicate: (event: TraceEvent) => boolean;\n  resolve: (event: TraceEvent) => void;\n  reject: (error: Error) => void;\n  timeoutId?: ReturnType<typeof setTimeout>;\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 payload = isRecord(input.payload) ? { ...input.payload } : undefined;\n\n  return {\n    source,\n    type,\n    ...(message ? { message } : {}),\n    ...(conversationId !== undefined ? { conversationId } : {}),\n    ...(payload ? { payload } : {}),\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\nexport class TraceCapture {\n  private readonly buffer: TraceEvent[] = [];\n  private readonly pending = new Set<PendingWaiter>();\n  private readonly maxEvents: number;\n  private subscription: Subscription;\n\n  constructor(\n    source$: Observable<TraceEvent>,\n    options: TraceCaptureOptions = {},\n  ) {\n    this.maxEvents = Math.max(1, options.maxEvents ?? 1000);\n    this.subscription = source$.subscribe((event) => {\n      this.buffer.push(event);\n      if (this.buffer.length > this.maxEvents) {\n        this.buffer.splice(0, this.buffer.length - this.maxEvents);\n      }\n      for (const waiter of Array.from(this.pending)) {\n        if (!waiter.predicate(event)) {\n          continue;\n        }\n        if (waiter.timeoutId) {\n          clearTimeout(waiter.timeoutId);\n        }\n        this.pending.delete(waiter);\n        waiter.resolve(event);\n      }\n    });\n  }\n\n  events(): TraceEvent[] {\n    return [...this.buffer];\n  }\n\n  async waitFor(\n    predicate: (event: TraceEvent) => boolean,\n    options: TraceWaitOptions = {},\n  ): Promise<TraceEvent> {\n    const existing = this.buffer.find(predicate);\n    if (existing) {\n      return existing;\n    }\n\n    return new Promise<TraceEvent>((resolve, reject) => {\n      const waiter: PendingWaiter = {\n        predicate,\n        resolve,\n        reject,\n      };\n      const timeoutMs = options.timeoutMs ?? 5000;\n      waiter.timeoutId = setTimeout(() => {\n        this.pending.delete(waiter);\n        reject(new Error(`Timed out waiting for trace event after ${timeoutMs}ms`));\n      }, timeoutMs);\n      this.pending.add(waiter);\n    });\n  }\n\n  async writeArtifact(targetPath: string): Promise<void> {\n    const [{ mkdir, writeFile }, pathModule] = await Promise.all([\n      import('node:fs/promises'),\n      import('node:path'),\n    ]);\n    await mkdir(pathModule.dirname(targetPath), { recursive: true });\n    const lines = this.buffer.map((event) => JSON.stringify(event)).join('\\n');\n    await writeFile(targetPath, `${lines}${lines.length > 0 ? '\\n' : ''}`, 'utf8');\n  }\n\n  stop(): void {\n    for (const waiter of this.pending) {\n      if (waiter.timeoutId) {\n        clearTimeout(waiter.timeoutId);\n      }\n      waiter.reject(new Error('Trace capture stopped before predicate matched'));\n    }\n    this.pending.clear();\n    this.subscription.unsubscribe();\n  }\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  capture(options: TraceCaptureOptions = {}): TraceCapture {\n    return new TraceCapture(this.events$, options);\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(rawPayload: unknown): 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, payload);\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 createTraceCapture(options: TraceCaptureOptions = {}): TraceCapture {\n  return getGlobalTraceHub().capture(options);\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, Subscription } 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 TraceCaptureOptions = {\n  maxEvents?: number;\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 PendingWaiter = {\n  predicate: (event: TraceEvent) => boolean;\n  resolve: (event: TraceEvent) => void;\n  reject: (error: Error) => void;\n  timeoutId?: ReturnType<typeof setTimeout>;\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\nexport class TraceCapture {\n  private readonly buffer: TraceEvent[] = [];\n  private readonly pending = new Set<PendingWaiter>();\n  private readonly maxEvents: number;\n  private subscription: Subscription;\n\n  constructor(\n    source$: Observable<TraceEvent>,\n    options: TraceCaptureOptions = {},\n  ) {\n    this.maxEvents = Math.max(1, options.maxEvents ?? 1000);\n    this.subscription = source$.subscribe((event) => {\n      this.buffer.push(event);\n      if (this.buffer.length > this.maxEvents) {\n        this.buffer.splice(0, this.buffer.length - this.maxEvents);\n      }\n      for (const waiter of Array.from(this.pending)) {\n        if (!waiter.predicate(event)) {\n          continue;\n        }\n        if (waiter.timeoutId) {\n          clearTimeout(waiter.timeoutId);\n        }\n        this.pending.delete(waiter);\n        waiter.resolve(event);\n      }\n    });\n  }\n\n  events(): TraceEvent[] {\n    return [...this.buffer];\n  }\n\n  async waitFor(\n    predicate: (event: TraceEvent) => boolean,\n    options: TraceWaitOptions = {},\n  ): Promise<TraceEvent> {\n    const existing = this.buffer.find(predicate);\n    if (existing) {\n      return existing;\n    }\n\n    return new Promise<TraceEvent>((resolve, reject) => {\n      const waiter: PendingWaiter = {\n        predicate,\n        resolve,\n        reject,\n      };\n      const timeoutMs = options.timeoutMs ?? 5000;\n      waiter.timeoutId = setTimeout(() => {\n        this.pending.delete(waiter);\n        reject(new Error(`Timed out waiting for trace event after ${timeoutMs}ms`));\n      }, timeoutMs);\n      this.pending.add(waiter);\n    });\n  }\n\n  async writeArtifact(targetPath: string): Promise<void> {\n    const [{ mkdir, writeFile }, pathModule] = await Promise.all([\n      import('node:fs/promises'),\n      import('node:path'),\n    ]);\n    await mkdir(pathModule.dirname(targetPath), { recursive: true });\n    const lines = this.buffer.map((event) => JSON.stringify(event)).join('\\n');\n    await writeFile(targetPath, `${lines}${lines.length > 0 ? '\\n' : ''}`, 'utf8');\n  }\n\n  stop(): void {\n    for (const waiter of this.pending) {\n      if (waiter.timeoutId) {\n        clearTimeout(waiter.timeoutId);\n      }\n      waiter.reject(new Error('Trace capture stopped before predicate matched'));\n    }\n    this.pending.clear();\n    this.subscription.unsubscribe();\n  }\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  capture(options: TraceCaptureOptions = {}): TraceCapture {\n    return new TraceCapture(this.events$, options);\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 createTraceCapture(options: TraceCaptureOptions = {}): TraceCapture {\n  return getGlobalTraceHub().capture(options);\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":"AAAA,SAAqB,eAA6B;AAClD,SAAS,aAAa;AA4CtB,MAAM,mBAAmB,uBAAO,IAAI,uBAAuB;AAE3D,MAAM,cAA0C;AAAA,EAC9C,OAAO;AAAA,EACP,MAAM;AAAA,EACN,MAAM;AAAA,EACN,OAAO;AACT;AAEA,IAAI,mBAA+B;AACnC,IAAI,kBAAkB;AACtB,IAAI,+BAAoE;AA0BxE,SAAS,oBAAoB,KAA0B;AACrD,QAAM,QAAS,OAAO,CAAC;AACvB,QAAM,SAAS,OAAO,MAAM,WAAW,YAAY,MAAM,OAAO,KAAK,EAAE,SAAS,IAC5E,MAAM,SACN;AACJ,QAAM,OAAO,OAAO,MAAM,SAAS,YAAY,MAAM,KAAK,KAAK,EAAE,SAAS,IACtE,MAAM,OACN;AACJ,QAAM,UAAU,OAAO,MAAM,YAAY,WAAW,MAAM,UAAU;AACpE,QAAM,iBAAiB,OAAO,MAAM,mBAAmB,YAAY,OAAO,MAAM,mBAAmB,WAC/F,MAAM,iBACN;AACJ,QAAM,WAAW,OAAO,MAAM,aAAa,YAAY,MAAM,SAAS,KAAK,EAAE,SAAS,IAClF,MAAM,WACN;AACJ,QAAM,gBAAgB,OAAO,MAAM,kBAAkB,YAAY,OAAO,SAAS,MAAM,aAAa,IAChG,MAAM,gBACN;AACJ,QAAM,WAAW,OAAO,MAAM,aAAa,YAAY,MAAM,SAAS,KAAK,EAAE,SAAS,IAClF,MAAM,WACN;AACJ,QAAM,YAAY,OAAO,MAAM,cAAc,YAAY,MAAM,UAAU,KAAK,EAAE,SAAS,IACrF,MAAM,YACN;AACJ,QAAM,UAAU,SAAS,MAAM,OAAO,IAAI,EAAE,GAAG,MAAM,QAAQ,IAAI;AAEjE,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,GAAI,UAAU,EAAE,QAAQ,IAAI,CAAC;AAAA,IAC7B,GAAI,mBAAmB,SAAY,EAAE,eAAe,IAAI,CAAC;AAAA,IACzD,GAAI,aAAa,SAAY,EAAE,SAAS,IAAI,CAAC;AAAA,IAC7C,GAAI,kBAAkB,SAAY,EAAE,cAAc,IAAI,CAAC;AAAA,IACvD,GAAI,aAAa,SAAY,EAAE,SAAS,IAAI,CAAC;AAAA,IAC7C,GAAI,cAAc,SAAY,EAAE,UAAU,IAAI,CAAC;AAAA,IAC/C,GAAI,UAAU,EAAE,QAAQ,IAAI,CAAC;AAAA,EAC/B;AACF;AAEA,SAAS,yBAAyB,OAAgB,SAAsD;AACtG,MAAI,CAAC,SAAS;AACZ,WAAO,oBAAoB,KAAK;AAAA,EAClC;AACA,SAAO,oBAAoB;AAAA,IACzB,GAAI,SAAS,KAAK,IAAI,QAAQ,CAAC;AAAA,IAC/B,GAAG;AAAA,EACL,CAAC;AACH;AAEA,SAAS,SAAS,OAAkD;AAClE,SAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAC5E;AAEA,SAAS,qBAA6C;AACpD,QAAM,YAAY;AAClB,QAAM,SAAS,UAAU,yBACpB,UAAU,QAAQ,yBAClB,UAAU,QACV,UAAU,QAAQ;AACvB,MAAI,CAAC,UAAU,OAAO,WAAW,UAAU;AACzC,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAEO,MAAM,aAAa;AAAA,EAMxB,YACE,SACA,UAA+B,CAAC,GAChC;AARF,SAAiB,SAAuB,CAAC;AACzC,SAAiB,UAAU,oBAAI,IAAmB;AAQhD,SAAK,YAAY,KAAK,IAAI,GAAG,QAAQ,aAAa,GAAI;AACtD,SAAK,eAAe,QAAQ,UAAU,CAAC,UAAU;AAC/C,WAAK,OAAO,KAAK,KAAK;AACtB,UAAI,KAAK,OAAO,SAAS,KAAK,WAAW;AACvC,aAAK,OAAO,OAAO,GAAG,KAAK,OAAO,SAAS,KAAK,SAAS;AAAA,MAC3D;AACA,iBAAW,UAAU,MAAM,KAAK,KAAK,OAAO,GAAG;AAC7C,YAAI,CAAC,OAAO,UAAU,KAAK,GAAG;AAC5B;AAAA,QACF;AACA,YAAI,OAAO,WAAW;AACpB,uBAAa,OAAO,SAAS;AAAA,QAC/B;AACA,aAAK,QAAQ,OAAO,MAAM;AAC1B,eAAO,QAAQ,KAAK;AAAA,MACtB;AAAA,IACF,CAAC;AAAA,EACH;AAAA,EAEA,SAAuB;AACrB,WAAO,CAAC,GAAG,KAAK,MAAM;AAAA,EACxB;AAAA,EAEA,MAAM,QACJ,WACA,UAA4B,CAAC,GACR;AACrB,UAAM,WAAW,KAAK,OAAO,KAAK,SAAS;AAC3C,QAAI,UAAU;AACZ,aAAO;AAAA,IACT;AAEA,WAAO,IAAI,QAAoB,CAAC,SAAS,WAAW;AAClD,YAAM,SAAwB;AAAA,QAC5B;AAAA,QACA;AAAA,QACA;AAAA,MACF;AACA,YAAM,YAAY,QAAQ,aAAa;AACvC,aAAO,YAAY,WAAW,MAAM;AAClC,aAAK,QAAQ,OAAO,MAAM;AAC1B,eAAO,IAAI,MAAM,2CAA2C,SAAS,IAAI,CAAC;AAAA,MAC5E,GAAG,SAAS;AACZ,WAAK,QAAQ,IAAI,MAAM;AAAA,IACzB,CAAC;AAAA,EACH;AAAA,EAEA,MAAM,cAAc,YAAmC;AACrD,UAAM,CAAC,EAAE,OAAO,UAAU,GAAG,UAAU,IAAI,MAAM,QAAQ,IAAI;AAAA,MAC3D,OAAO,kBAAkB;AAAA,MACzB,OAAO,WAAW;AAAA,IACpB,CAAC;AACD,UAAM,MAAM,WAAW,QAAQ,UAAU,GAAG,EAAE,WAAW,KAAK,CAAC;AAC/D,UAAM,QAAQ,KAAK,OAAO,IAAI,CAAC,UAAU,KAAK,UAAU,KAAK,CAAC,EAAE,KAAK,IAAI;AACzE,UAAM,UAAU,YAAY,GAAG,KAAK,GAAG,MAAM,SAAS,IAAI,OAAO,EAAE,IAAI,MAAM;AAAA,EAC/E;AAAA,EAEA,OAAa;AACX,eAAW,UAAU,KAAK,SAAS;AACjC,UAAI,OAAO,WAAW;AACpB,qBAAa,OAAO,SAAS;AAAA,MAC/B;AACA,aAAO,OAAO,IAAI,MAAM,gDAAgD,CAAC;AAAA,IAC3E;AACA,SAAK,QAAQ,MAAM;AACnB,SAAK,aAAa,YAAY;AAAA,EAChC;AACF;AAEA,MAAM,SAAS;AAAA,EAAf;AACE,SAAiB,UAAU,IAAI,QAAoB;AACnD,SAAiB,UAAU,KAAK,QAAQ,aAAa,EAAE,KAAK,MAAM,CAAC;AACnE,SAAQ,eAAe;AACvB,SAAQ,YAA8C;AAAA,MACpD,MAAM;AAAA,MACN,UAAU;AAAA,MACV,MAAM;AAAA,IACR;AAAA;AAAA,EAEA,IAAI,UAAkC;AACpC,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,YAAY,SAAuB,OAAyB;AAC1D,SAAK,UAAU,OAAO,IAAI;AAAA,EAC5B;AAAA,EAEA,QAAQ,SAAuB,OAAmB,OAA4B;AAC5E,UAAM,aAAa,oBAAoB,KAAK;AAC5C,UAAM,QAAoB;AAAA,MACxB,GAAG;AAAA,MACH;AAAA,MACA;AAAA,MACA,YAAW,oBAAI,KAAK,GAAE,YAAY;AAAA,MAClC,UAAU,KAAK;AAAA,IACjB;AACA,QAAI,YAAY,KAAK,KAAK,YAAY,KAAK,UAAU,OAAO,CAAC,GAAG;AAC9D,WAAK,QAAQ,KAAK,KAAK;AAAA,IACzB;AACA,WAAO;AAAA,EACT;AAAA,EAEA,QAAQ,UAA+B,CAAC,GAAiB;AACvD,WAAO,IAAI,aAAa,KAAK,SAAS,OAAO;AAAA,EAC/C;AACF;AAEA,SAAS,oBAA8B;AACrC,QAAM,YAAY;AAClB,MAAI,CAAC,UAAU,gBAAgB,GAAG;AAChC,cAAU,gBAAgB,IAAI,IAAI,SAAS;AAAA,EAC7C;AACA,SAAO,UAAU,gBAAgB;AACnC;AAEO,SAAS,kBAA0C;AACxD,SAAO,kBAAkB,EAAE;AAC7B;AAEO,SAAS,qBAAqB,OAAyB;AAC5D,oBAAkB,EAAE,YAAY,QAAQ,KAAK;AAC/C;AAEO,SAAS,yBAAyB,OAAyB;AAChE,qBAAmB;AACnB,oBAAkB,EAAE,YAAY,YAAY,KAAK;AACnD;AAEO,SAAS,wBAAwB,SAAwB;AAC9D,oBAAkB;AACpB;AAEO,SAAS,iBAAiB,OAAmB,OAA4B;AAC9E,SAAO,kBAAkB,EAAE,QAAQ,QAAQ,OAAO,KAAK;AACzD;AAEO,SAAS,iBAAiB,SAAuB,OAAmB,OAA4B;AACrG,SAAO,kBAAkB,EAAE,QAAQ,SAAS,OAAO,KAAK;AAC1D;AAEO,SAAS,6BACd,YACA,SACqB;AACrB,QAAM,UAAW,cAAc,CAAC;AAChC,QAAM,QAAQ,QAAQ,UAAU,WAAW,QAAQ,UAAU,UAAU,QAAQ,UAAU,UAAU,QAAQ,UAAU,UACjH,QAAQ,QACR;AACJ,oBAAkB,EAAE,QAAQ,YAAY,OAAO,yBAAyB,SAAS,OAAO,CAAC;AACzF,SAAO;AAAA,IACL,IAAI;AAAA,IACJ,WAAW;AAAA,EACb;AACF;AAEO,SAAS,0BAA0B,IAA+C;AACvF,iCAA+B;AACjC;AAEO,SAAS,kBAAkB,OAAmB,OAAyB;AAC5E,MAAI,CAAC,iBAAiB;AACpB;AAAA,EACF;AACA,MAAI,YAAY,KAAK,IAAI,YAAY,gBAAgB,GAAG;AACtD;AAAA,EACF;AACA,QAAM,aAAa,EAAE,GAAG,oBAAoB,KAAK,GAAG,MAAM;AAE1D,MAAI,8BAA8B;AAChC,QAAI;AACF,mCAA6B,UAAU;AACvC;AAAA,IACF,QAAQ;AAAA,IAER;AAAA,EACF;AAEA,QAAM,SAAS,mBAAmB;AAClC,MAAI,CAAC,UAAU,OAAO,OAAO,YAAY,YAAY;AACnD;AAAA,EACF;AACA,MAAI;AACF,WAAO,QAAQ,UAAU;AAAA,EAC3B,QAAQ;AAAA,EAER;AACF;AAEO,SAAS,mBAAmB,UAA+B,CAAC,GAAiB;AAClF,SAAO,kBAAkB,EAAE,QAAQ,OAAO;AAC5C;AAEO,SAAS,wBAA8B;AAC5C,QAAM,YAAY;AAClB,SAAO,UAAU,gBAAgB;AACjC,qBAAmB;AACnB,oBAAkB;AAClB,iCAA+B;AACjC;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noego/wood",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -43,6 +43,12 @@
       "import": "./dist/testing/index.js",
       "default": "./dist/testing/index.js"
     },
+    "./trace-testing": {
+      "types": "./dist/trace-testing/index.d.ts",
+      "require": "./dist/trace-testing/index.cjs",
+      "import": "./dist/trace-testing/index.js",
+      "default": "./dist/trace-testing/index.js"
+    },
     "./client": {
       "types": "./dist/client/index.d.ts",
       "require": "./dist/client/index.cjs",
@@ -73,6 +79,12 @@
       "import": "./dist/stick/index.js",
       "default": "./dist/stick/index.js"
     },
+    "./dev": {
+      "types": "./dist/dev/index.d.ts",
+      "require": "./dist/dev/index.cjs",
+      "import": "./dist/dev/index.js",
+      "default": "./dist/dev/index.js"
+    },
     "./recursive-render": "./src/components/WoodRecursiveRender.svelte",
     "./navigation-shell": "./src/components/NavigationShell.svelte",
     "./components": "./src/components/index.js",