@noego/wood 0.4.6 → 0.4.8

package/dist/tracing/trace_commit_writer.d.ts

@@ -0,0 +1,97 @@
+import { d as TraceProcess, c as TraceLevel, g as WoodTraceEventSnapshot } from '../trace_hub-Cob54qRx.js';
+import 'rxjs';
+
+/**
+ * A committed trace row. Ordering is authoritative on `commitSeq` — the
+ * writer-assigned monotonic sequence stamped at the single ingestion/commit
+ * boundary. `producerId` + `producerSeq` identify the producer-side stream;
+ * `timestamp` is retained for display but is NEVER used for cross-producer
+ * ordering (clocks across main/renderer are not causal).
+ */
+interface TraceCommitRow {
+    readonly commitSeq: number;
+    readonly producerId: string;
+    readonly producerSeq: number;
+    readonly process: TraceProcess;
+    readonly level: TraceLevel;
+    readonly type: string;
+    readonly source: string;
+    readonly message?: string;
+    readonly conversationId?: number | string;
+    readonly timestamp: string;
+    readonly payload?: Record<string, unknown>;
+}
+/**
+ * Storage boundary for committed trace rows. Implemented per-runtime: the app's
+ * test backend harness supplies a SQLite-backed adapter (better-sqlite3, which
+ * wood does not depend on). `persist` may be sync or async; the writer barrier
+ * awaits whatever it returns.
+ */
+interface WoodTracePersistencePort {
+    persist(row: TraceCommitRow): void | Promise<void>;
+    close?(): void | Promise<void>;
+}
+interface TraceFlushOptions {
+    timeoutMs?: number;
+}
+interface TraceFlushResult {
+    /** Highest `commitSeq` durably persisted at flush completion. */
+    readonly committedHighWaterMark: number;
+}
+interface TraceCommitWriterOptions {
+    /** Stable id for the main-process producer stream (default `'main'`). */
+    readonly mainProducerId?: string;
+}
+/**
+ * The single trace ingestion/commit boundary. Every trace event (main or, in
+ * later phases, renderer batches) is admitted here, assigned a monotonic
+ * `commitSeq`, and enqueued for persistence. `flush` drains the async write
+ * queue and returns the committed high-water mark — no sleeps, no polling.
+ */
+declare class TraceCommitWriter {
+    private readonly port;
+    private readonly mainProducerId;
+    private readonly seen;
+    private inflight;
+    private nextCommitSeq;
+    private committed;
+    private pendingError;
+    private rendererFlush;
+    constructor(port: WoodTracePersistencePort, options?: TraceCommitWriterOptions);
+    /**
+     * Admit one trace event. Returns the committed row (with its assigned
+     * `commitSeq`), or `null` if it is a duplicate of an already-admitted
+     * (producerId, producerSeq) pair — this is the batch-retry idempotency guard.
+     */
+    admit(event: WoodTraceEventSnapshot): TraceCommitRow | null;
+    /** WoodTraceEventSink shape — register via `tracer.registerSink(writer.sink)`. */
+    readonly sink: (event: WoodTraceEventSnapshot) => void;
+    highWaterMark(): number;
+    /**
+     * Install the renderer-flush hook (Phase 4 browser mode). The browser harness
+     * supplies a function that drains the page's in-flight renderer `__trace`
+     * round-trips; `flush()` awaits it before the main-writer barrier so
+     * renderer-origin traces are persisted deterministically. Backend mode leaves
+     * this unset and `requestRendererFlush` resolves immediately.
+     */
+    setRendererFlush(fn: (() => Promise<void>) | null): void;
+    /**
+     * Request that renderer producers flush their pending batches and await acks.
+     * In browser mode the installed hook (see {@link setRendererFlush}) round-trips
+     * the page to drain pending `__trace` deliveries. With no hook (backend mode,
+     * no renderer) this resolves immediately.
+     */
+    requestRendererFlush(): Promise<void>;
+    /**
+     * Drain the write queue and return the committed high-water mark. Awaits a
+     * barrier over all in-flight persists; with `timeoutMs` it rejects on a
+     * timer race rather than polling. Rejects if any persist failed.
+     */
+    flush(options?: TraceFlushOptions): Promise<TraceFlushResult>;
+    private awaitBarrier;
+    private enqueue;
+    private resolveProducerId;
+    private toRow;
+}
+
+export { type TraceCommitRow, TraceCommitWriter, type TraceCommitWriterOptions, type TraceFlushOptions, type TraceFlushResult, type WoodTracePersistencePort };

package/dist/tracing/trace_commit_writer.js

@@ -0,0 +1,135 @@
+class TraceCommitWriter {
+  constructor(port, options = {}) {
+    this.seen = /* @__PURE__ */ new Set();
+    this.inflight = [];
+    this.nextCommitSeq = 1;
+    this.committed = 0;
+    this.pendingError = null;
+    this.rendererFlush = null;
+    /** WoodTraceEventSink shape — register via `tracer.registerSink(writer.sink)`. */
+    this.sink = (event) => {
+      this.admit(event);
+    };
+    this.port = port;
+    this.mainProducerId = options.mainProducerId ?? "main";
+  }
+  /**
+   * Admit one trace event. Returns the committed row (with its assigned
+   * `commitSeq`), or `null` if it is a duplicate of an already-admitted
+   * (producerId, producerSeq) pair — this is the batch-retry idempotency guard.
+   */
+  admit(event) {
+    const producerId = this.resolveProducerId(event);
+    const producerSeq = event.traceSeq;
+    const identity = `${producerId}#${producerSeq}`;
+    if (this.seen.has(identity)) {
+      return null;
+    }
+    this.seen.add(identity);
+    const row = this.toRow(event, producerId, producerSeq);
+    this.enqueue(row);
+    return row;
+  }
+  highWaterMark() {
+    return this.committed;
+  }
+  /**
+   * Install the renderer-flush hook (Phase 4 browser mode). The browser harness
+   * supplies a function that drains the page's in-flight renderer `__trace`
+   * round-trips; `flush()` awaits it before the main-writer barrier so
+   * renderer-origin traces are persisted deterministically. Backend mode leaves
+   * this unset and `requestRendererFlush` resolves immediately.
+   */
+  setRendererFlush(fn) {
+    this.rendererFlush = fn;
+  }
+  /**
+   * Request that renderer producers flush their pending batches and await acks.
+   * In browser mode the installed hook (see {@link setRendererFlush}) round-trips
+   * the page to drain pending `__trace` deliveries. With no hook (backend mode,
+   * no renderer) this resolves immediately.
+   */
+  async requestRendererFlush() {
+    if (this.rendererFlush) {
+      await this.rendererFlush();
+    }
+  }
+  /**
+   * Drain the write queue and return the committed high-water mark. Awaits a
+   * barrier over all in-flight persists; with `timeoutMs` it rejects on a
+   * timer race rather than polling. Rejects if any persist failed.
+   */
+  async flush(options = {}) {
+    await this.requestRendererFlush();
+    const barrier = Promise.allSettled(this.inflight.slice());
+    await this.awaitBarrier(barrier, options.timeoutMs);
+    if (this.pendingError !== null) {
+      const error = this.pendingError;
+      this.pendingError = null;
+      throw error;
+    }
+    return { committedHighWaterMark: this.committed };
+  }
+  async awaitBarrier(barrier, timeoutMs) {
+    if (timeoutMs === void 0) {
+      await barrier;
+      return;
+    }
+    let timer = null;
+    const timeout = new Promise((_, reject) => {
+      timer = setTimeout(
+        () => reject(new Error(`trace flush barrier exceeded ${timeoutMs}ms`)),
+        timeoutMs
+      );
+    });
+    try {
+      await Promise.race([barrier.then(() => void 0), timeout]);
+    } finally {
+      if (timer !== null) {
+        clearTimeout(timer);
+      }
+    }
+  }
+  enqueue(row) {
+    const op = Promise.resolve().then(() => this.port.persist(row)).then(
+      () => {
+        if (row.commitSeq > this.committed) {
+          this.committed = row.commitSeq;
+        }
+      },
+      (error) => {
+        this.pendingError = error;
+      }
+    );
+    this.inflight.push(op);
+  }
+  resolveProducerId(event) {
+    if (event.process === "renderer") {
+      const rendererId = event.payload?.woodRendererProducerId;
+      return typeof rendererId === "string" ? rendererId : "renderer";
+    }
+    if (event.process === "main") {
+      return this.mainProducerId;
+    }
+    return event.process;
+  }
+  toRow(event, producerId, producerSeq) {
+    return {
+      commitSeq: this.nextCommitSeq++,
+      producerId,
+      producerSeq,
+      process: event.process,
+      level: event.level,
+      type: event.type,
+      source: event.source,
+      ...event.message !== void 0 ? { message: event.message } : {},
+      ...event.conversationId !== void 0 ? { conversationId: event.conversationId } : {},
+      timestamp: event.timestamp,
+      ...event.payload ? { payload: { ...event.payload } } : {}
+    };
+  }
+}
+export {
+  TraceCommitWriter
+};
+//# sourceMappingURL=trace_commit_writer.js.map

package/dist/tracing/trace_commit_writer.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/tracing/trace_commit_writer.ts"],"sourcesContent":["import type { TraceLevel, TraceProcess } from './trace_hub.js';\nimport type { WoodTraceEventSnapshot } from './types/wood_trace_sink.types.js';\n\n/**\n * A committed trace row. Ordering is authoritative on `commitSeq` — the\n * writer-assigned monotonic sequence stamped at the single ingestion/commit\n * boundary. `producerId` + `producerSeq` identify the producer-side stream;\n * `timestamp` is retained for display but is NEVER used for cross-producer\n * ordering (clocks across main/renderer are not causal).\n */\nexport interface TraceCommitRow {\n  readonly commitSeq: number;\n  readonly producerId: string;\n  readonly producerSeq: number;\n  readonly process: TraceProcess;\n  readonly level: TraceLevel;\n  readonly type: string;\n  readonly source: string;\n  readonly message?: string;\n  readonly conversationId?: number | string;\n  readonly timestamp: string;\n  readonly payload?: Record<string, unknown>;\n}\n\n/**\n * Storage boundary for committed trace rows. Implemented per-runtime: the app's\n * test backend harness supplies a SQLite-backed adapter (better-sqlite3, which\n * wood does not depend on). `persist` may be sync or async; the writer barrier\n * awaits whatever it returns.\n */\nexport interface WoodTracePersistencePort {\n  persist(row: TraceCommitRow): void | Promise<void>;\n  close?(): void | Promise<void>;\n}\n\nexport interface TraceFlushOptions {\n  timeoutMs?: number;\n}\n\nexport interface TraceFlushResult {\n  /** Highest `commitSeq` durably persisted at flush completion. */\n  readonly committedHighWaterMark: number;\n}\n\nexport interface TraceCommitWriterOptions {\n  /** Stable id for the main-process producer stream (default `'main'`). */\n  readonly mainProducerId?: string;\n}\n\n/**\n * The single trace ingestion/commit boundary. Every trace event (main or, in\n * later phases, renderer batches) is admitted here, assigned a monotonic\n * `commitSeq`, and enqueued for persistence. `flush` drains the async write\n * queue and returns the committed high-water mark — no sleeps, no polling.\n */\nexport class TraceCommitWriter {\n  private readonly port: WoodTracePersistencePort;\n  private readonly mainProducerId: string;\n  private readonly seen = new Set<string>();\n  private inflight: Promise<void>[] = [];\n  private nextCommitSeq = 1;\n  private committed = 0;\n  private pendingError: unknown = null;\n  private rendererFlush: (() => Promise<void>) | null = null;\n\n  constructor(port: WoodTracePersistencePort, options: TraceCommitWriterOptions = {}) {\n    this.port = port;\n    this.mainProducerId = options.mainProducerId ?? 'main';\n  }\n\n  /**\n   * Admit one trace event. Returns the committed row (with its assigned\n   * `commitSeq`), or `null` if it is a duplicate of an already-admitted\n   * (producerId, producerSeq) pair — this is the batch-retry idempotency guard.\n   */\n  admit(event: WoodTraceEventSnapshot): TraceCommitRow | null {\n    const producerId = this.resolveProducerId(event);\n    const producerSeq = event.traceSeq;\n    const identity = `${producerId}#${producerSeq}`;\n    if (this.seen.has(identity)) {\n      return null;\n    }\n    this.seen.add(identity);\n    const row = this.toRow(event, producerId, producerSeq);\n    this.enqueue(row);\n    return row;\n  }\n\n  /** WoodTraceEventSink shape — register via `tracer.registerSink(writer.sink)`. */\n  readonly sink = (event: WoodTraceEventSnapshot): void => {\n    this.admit(event);\n  };\n\n  highWaterMark(): number {\n    return this.committed;\n  }\n\n  /**\n   * Install the renderer-flush hook (Phase 4 browser mode). The browser harness\n   * supplies a function that drains the page's in-flight renderer `__trace`\n   * round-trips; `flush()` awaits it before the main-writer barrier so\n   * renderer-origin traces are persisted deterministically. Backend mode leaves\n   * this unset and `requestRendererFlush` resolves immediately.\n   */\n  setRendererFlush(fn: (() => Promise<void>) | null): void {\n    this.rendererFlush = fn;\n  }\n\n  /**\n   * Request that renderer producers flush their pending batches and await acks.\n   * In browser mode the installed hook (see {@link setRendererFlush}) round-trips\n   * the page to drain pending `__trace` deliveries. With no hook (backend mode,\n   * no renderer) this resolves immediately.\n   */\n  async requestRendererFlush(): Promise<void> {\n    if (this.rendererFlush) {\n      await this.rendererFlush();\n    }\n  }\n\n  /**\n   * Drain the write queue and return the committed high-water mark. Awaits a\n   * barrier over all in-flight persists; with `timeoutMs` it rejects on a\n   * timer race rather than polling. Rejects if any persist failed.\n   */\n  async flush(options: TraceFlushOptions = {}): Promise<TraceFlushResult> {\n    await this.requestRendererFlush();\n    const barrier = Promise.allSettled(this.inflight.slice());\n    await this.awaitBarrier(barrier, options.timeoutMs);\n    if (this.pendingError !== null) {\n      const error = this.pendingError;\n      this.pendingError = null;\n      throw error;\n    }\n    return { committedHighWaterMark: this.committed };\n  }\n\n  private async awaitBarrier(\n    barrier: Promise<unknown>,\n    timeoutMs: number | undefined,\n  ): Promise<void> {\n    if (timeoutMs === undefined) {\n      await barrier;\n      return;\n    }\n    let timer: ReturnType<typeof setTimeout> | null = null;\n    const timeout = new Promise<never>((_, reject) => {\n      timer = setTimeout(\n        () => reject(new Error(`trace flush barrier exceeded ${timeoutMs}ms`)),\n        timeoutMs,\n      );\n    });\n    try {\n      await Promise.race([barrier.then(() => undefined), timeout]);\n    } finally {\n      if (timer !== null) {\n        clearTimeout(timer);\n      }\n    }\n  }\n\n  private enqueue(row: TraceCommitRow): void {\n    const op = Promise.resolve()\n      .then(() => this.port.persist(row))\n      .then(\n        () => {\n          if (row.commitSeq > this.committed) {\n            this.committed = row.commitSeq;\n          }\n        },\n        (error: unknown) => {\n          this.pendingError = error;\n        },\n      );\n    this.inflight.push(op);\n  }\n\n  private resolveProducerId(event: WoodTraceEventSnapshot): string {\n    if (event.process === 'renderer') {\n      const rendererId = event.payload?.woodRendererProducerId;\n      return typeof rendererId === 'string' ? rendererId : 'renderer';\n    }\n    if (event.process === 'main') {\n      return this.mainProducerId;\n    }\n    return event.process;\n  }\n\n  private toRow(\n    event: WoodTraceEventSnapshot,\n    producerId: string,\n    producerSeq: number,\n  ): TraceCommitRow {\n    return {\n      commitSeq: this.nextCommitSeq++,\n      producerId,\n      producerSeq,\n      process: event.process,\n      level: event.level,\n      type: event.type,\n      source: event.source,\n      ...(event.message !== undefined ? { message: event.message } : {}),\n      ...(event.conversationId !== undefined ? { conversationId: event.conversationId } : {}),\n      timestamp: event.timestamp,\n      ...(event.payload ? { payload: { ...event.payload } } : {}),\n    };\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/tracing/trace_hub.cjs

@@ -22,8 +22,10 @@ __export(trace_hub_exports, {
   dispatchRendererTracePayload: () => dispatchRendererTracePayload,
   emitRendererTrace: () => emitRendererTrace,
   getTraceEvents$: () => getTraceEvents$,
+  normalizeTraceLevel: () => normalizeTraceLevel,
   publishMainTrace: () => publishMainTrace,
   publishTestTrace: () => publishTestTrace,
+  registerTraceSink: () => registerTraceSink,
   setMainTraceMinLevel: () => setMainTraceMinLevel,
   setRendererTraceEnabled: () => setRendererTraceEnabled,
   setRendererTraceMinLevel: () => setRendererTraceMinLevel,
@@ -39,6 +41,17 @@ const LEVEL_ORDER = {
   warn: 2,
   error: 3
 };
+const CUSTOM_LEVEL_ORDER = LEVEL_ORDER.info;
+function normalizeTraceLevel(level, fallback = "info") {
+  if (typeof level !== "string") {
+    return fallback;
+  }
+  const normalized = level.trim().toLowerCase();
+  return normalized.length > 0 ? normalized : fallback;
+}
+function traceLevelOrder(level) {
+  return LEVEL_ORDER[level] ?? CUSTOM_LEVEL_ORDER;
+}
 let rendererMinLevel = "debug";
 let rendererEnabled = false;
 let customRendererTraceTransport = null;
@@ -89,6 +102,7 @@ class TraceHub {
   constructor() {
     this.subject = new import_rxjs.Subject();
     this.shared$ = this.subject.asObservable().pipe((0, import_operators.share)());
+    this.sinks = /* @__PURE__ */ new Set();
     this.nextTraceSeq = 1;
     this.minLevels = {
       main: "debug",
@@ -102,6 +116,12 @@ class TraceHub {
   setMinLevel(process, level) {
     this.minLevels[process] = level;
   }
+  registerSink(sink) {
+    this.sinks.add(sink);
+    return () => {
+      this.sinks.delete(sink);
+    };
+  }
   publish(process, level, input) {
     const normalized = normalizeTraceInput(input);
     const event = {
@@ -111,11 +131,40 @@ class TraceHub {
       timestamp: (/* @__PURE__ */ new Date()).toISOString(),
       traceSeq: this.nextTraceSeq++
     };
-    if (LEVEL_ORDER[level] >= LEVEL_ORDER[this.minLevels[process]]) {
+    if (traceLevelOrder(level) >= traceLevelOrder(this.minLevels[process])) {
+      this.publishToSinks(event);
       this.subject.next(event);
     }
     return event;
   }
+  publishRendererToSinks(level, input) {
+    if (this.sinks.size === 0) {
+      return;
+    }
+    const event = {
+      ...input,
+      level,
+      process: "renderer",
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      traceSeq: this.nextTraceSeq++
+    };
+    this.publishToSinks(event);
+  }
+  publishToSinks(event) {
+    if (this.sinks.size === 0) {
+      return;
+    }
+    const snapshot = Object.freeze({
+      ...event,
+      ...event.payload ? { payload: Object.freeze({ ...event.payload }) } : {}
+    });
+    for (const sink of this.sinks) {
+      try {
+        sink(snapshot);
+      } catch {
+      }
+    }
+  }
 }
 function getGlobalTraceHub() {
   const globalObj = globalThis;
@@ -127,6 +176,9 @@ function getGlobalTraceHub() {
 function getTraceEvents$() {
   return getGlobalTraceHub().events$;
 }
+function registerTraceSink(sink) {
+  return getGlobalTraceHub().registerSink(sink);
+}
 function setMainTraceMinLevel(level) {
   getGlobalTraceHub().setMinLevel("main", level);
 }
@@ -145,7 +197,7 @@ function publishTestTrace(process, level, input) {
 }
 function dispatchRendererTracePayload(rawPayload, context) {
   const payload = rawPayload ?? {};
-  const level = payload.level === "debug" || payload.level === "info" || payload.level === "warn" || payload.level === "error" ? payload.level : "info";
+  const level = normalizeTraceLevel(payload.level);
   getGlobalTraceHub().publish("renderer", level, mergeTraceRuntimeContext(payload, context));
   return {
     ok: true,
@@ -159,10 +211,11 @@ function emitRendererTrace(level, input) {
   if (!rendererEnabled) {
     return;
   }
-  if (LEVEL_ORDER[level] < LEVEL_ORDER[rendererMinLevel]) {
+  if (traceLevelOrder(level) < traceLevelOrder(rendererMinLevel)) {
     return;
   }
   const normalized = { ...normalizeTraceInput(input), level };
+  getGlobalTraceHub().publishRendererToSinks(level, normalized);
   if (customRendererTraceTransport) {
     try {
       customRendererTraceTransport(normalized);
@@ -192,8 +245,10 @@ function clearTraceHubForTests() {
   dispatchRendererTracePayload,
   emitRendererTrace,
   getTraceEvents$,
+  normalizeTraceLevel,
   publishMainTrace,
   publishTestTrace,
+  registerTraceSink,
   setMainTraceMinLevel,
   setRendererTraceEnabled,
   setRendererTraceMinLevel,

package/dist/tracing/trace_hub.cjs.map

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

package/dist/tracing/trace_hub.d.cts

@@ -1,46 +1,2 @@
-import { Observable } from 'rxjs';
-
-type TraceLevel = 'debug' | 'info' | 'warn' | 'error';
-type TraceProcess = 'main' | 'renderer' | 'test';
-type TraceInput = {
-    source: string;
-    type: string;
-    message?: string;
-    conversationId?: number | string;
-    payload?: Record<string, unknown>;
-    windowId?: string;
-    webContentsId?: number;
-    routeKey?: string;
-    harnessId?: string;
-};
-type TraceEvent = TraceInput & {
-    level: TraceLevel;
-    process: TraceProcess;
-    timestamp: string;
-    traceSeq: number;
-};
-type TraceDispatchResult = {
-    ok: boolean;
-    forwarded: boolean;
-};
-type TraceRuntimeContext = {
-    windowId?: string;
-    webContentsId?: number;
-    routeKey?: string;
-    harnessId?: string;
-};
-type TraceWaitOptions = {
-    timeoutMs?: number;
-};
-declare function getTraceEvents$(): Observable<TraceEvent>;
-declare function setMainTraceMinLevel(level: TraceLevel): void;
-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, context?: TraceRuntimeContext): TraceDispatchResult;
-declare function setRendererTraceTransport(fn: ((payload: unknown) => void) | null): void;
-declare function emitRendererTrace(level: TraceLevel, input: TraceInput): void;
-declare function clearTraceHubForTests(): void;
-
-export { type TraceDispatchResult, type TraceEvent, type TraceInput, type TraceLevel, type TraceProcess, type TraceRuntimeContext, type TraceWaitOptions, clearTraceHubForTests, dispatchRendererTracePayload, emitRendererTrace, getTraceEvents$, publishMainTrace, publishTestTrace, setMainTraceMinLevel, setRendererTraceEnabled, setRendererTraceMinLevel, setRendererTraceTransport };
+import 'rxjs';
+export { S as StandardTraceLevel, T as TraceDispatchResult, a as TraceEvent, b as TraceInput, c as TraceLevel, d as TraceProcess, e as TraceRuntimeContext, f as TraceWaitOptions, i as clearTraceHubForTests, l as dispatchRendererTracePayload, m as emitRendererTrace, j as getTraceEvents$, t as normalizeTraceLevel, p as publishMainTrace, n as publishTestTrace, r as registerTraceSink, o as setMainTraceMinLevel, s as setRendererTraceEnabled, q as setRendererTraceMinLevel, k as setRendererTraceTransport } from '../trace_hub-Cob54qRx.cjs';

package/dist/tracing/trace_hub.d.ts

@@ -1,46 +1,2 @@
-import { Observable } from 'rxjs';
-
-type TraceLevel = 'debug' | 'info' | 'warn' | 'error';
-type TraceProcess = 'main' | 'renderer' | 'test';
-type TraceInput = {
-    source: string;
-    type: string;
-    message?: string;
-    conversationId?: number | string;
-    payload?: Record<string, unknown>;
-    windowId?: string;
-    webContentsId?: number;
-    routeKey?: string;
-    harnessId?: string;
-};
-type TraceEvent = TraceInput & {
-    level: TraceLevel;
-    process: TraceProcess;
-    timestamp: string;
-    traceSeq: number;
-};
-type TraceDispatchResult = {
-    ok: boolean;
-    forwarded: boolean;
-};
-type TraceRuntimeContext = {
-    windowId?: string;
-    webContentsId?: number;
-    routeKey?: string;
-    harnessId?: string;
-};
-type TraceWaitOptions = {
-    timeoutMs?: number;
-};
-declare function getTraceEvents$(): Observable<TraceEvent>;
-declare function setMainTraceMinLevel(level: TraceLevel): void;
-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, context?: TraceRuntimeContext): TraceDispatchResult;
-declare function setRendererTraceTransport(fn: ((payload: unknown) => void) | null): void;
-declare function emitRendererTrace(level: TraceLevel, input: TraceInput): void;
-declare function clearTraceHubForTests(): void;
-
-export { type TraceDispatchResult, type TraceEvent, type TraceInput, type TraceLevel, type TraceProcess, type TraceRuntimeContext, type TraceWaitOptions, clearTraceHubForTests, dispatchRendererTracePayload, emitRendererTrace, getTraceEvents$, publishMainTrace, publishTestTrace, setMainTraceMinLevel, setRendererTraceEnabled, setRendererTraceMinLevel, setRendererTraceTransport };
+import 'rxjs';
+export { S as StandardTraceLevel, T as TraceDispatchResult, a as TraceEvent, b as TraceInput, c as TraceLevel, d as TraceProcess, e as TraceRuntimeContext, f as TraceWaitOptions, i as clearTraceHubForTests, l as dispatchRendererTracePayload, m as emitRendererTrace, j as getTraceEvents$, t as normalizeTraceLevel, p as publishMainTrace, n as publishTestTrace, r as registerTraceSink, o as setMainTraceMinLevel, s as setRendererTraceEnabled, q as setRendererTraceMinLevel, k as setRendererTraceTransport } from '../trace_hub-Cob54qRx.js';

package/dist/tracing/trace_hub.js

@@ -7,6 +7,17 @@ const LEVEL_ORDER = {
   warn: 2,
   error: 3
 };
+const CUSTOM_LEVEL_ORDER = LEVEL_ORDER.info;
+function normalizeTraceLevel(level, fallback = "info") {
+  if (typeof level !== "string") {
+    return fallback;
+  }
+  const normalized = level.trim().toLowerCase();
+  return normalized.length > 0 ? normalized : fallback;
+}
+function traceLevelOrder(level) {
+  return LEVEL_ORDER[level] ?? CUSTOM_LEVEL_ORDER;
+}
 let rendererMinLevel = "debug";
 let rendererEnabled = false;
 let customRendererTraceTransport = null;
@@ -57,6 +68,7 @@ class TraceHub {
   constructor() {
     this.subject = new Subject();
     this.shared$ = this.subject.asObservable().pipe(share());
+    this.sinks = /* @__PURE__ */ new Set();
     this.nextTraceSeq = 1;
     this.minLevels = {
       main: "debug",
@@ -70,6 +82,12 @@ class TraceHub {
   setMinLevel(process, level) {
     this.minLevels[process] = level;
   }
+  registerSink(sink) {
+    this.sinks.add(sink);
+    return () => {
+      this.sinks.delete(sink);
+    };
+  }
   publish(process, level, input) {
     const normalized = normalizeTraceInput(input);
     const event = {
@@ -79,11 +97,40 @@ class TraceHub {
       timestamp: (/* @__PURE__ */ new Date()).toISOString(),
       traceSeq: this.nextTraceSeq++
     };
-    if (LEVEL_ORDER[level] >= LEVEL_ORDER[this.minLevels[process]]) {
+    if (traceLevelOrder(level) >= traceLevelOrder(this.minLevels[process])) {
+      this.publishToSinks(event);
       this.subject.next(event);
     }
     return event;
   }
+  publishRendererToSinks(level, input) {
+    if (this.sinks.size === 0) {
+      return;
+    }
+    const event = {
+      ...input,
+      level,
+      process: "renderer",
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      traceSeq: this.nextTraceSeq++
+    };
+    this.publishToSinks(event);
+  }
+  publishToSinks(event) {
+    if (this.sinks.size === 0) {
+      return;
+    }
+    const snapshot = Object.freeze({
+      ...event,
+      ...event.payload ? { payload: Object.freeze({ ...event.payload }) } : {}
+    });
+    for (const sink of this.sinks) {
+      try {
+        sink(snapshot);
+      } catch {
+      }
+    }
+  }
 }
 function getGlobalTraceHub() {
   const globalObj = globalThis;
@@ -95,6 +142,9 @@ function getGlobalTraceHub() {
 function getTraceEvents$() {
   return getGlobalTraceHub().events$;
 }
+function registerTraceSink(sink) {
+  return getGlobalTraceHub().registerSink(sink);
+}
 function setMainTraceMinLevel(level) {
   getGlobalTraceHub().setMinLevel("main", level);
 }
@@ -113,7 +163,7 @@ function publishTestTrace(process, level, input) {
 }
 function dispatchRendererTracePayload(rawPayload, context) {
   const payload = rawPayload ?? {};
-  const level = payload.level === "debug" || payload.level === "info" || payload.level === "warn" || payload.level === "error" ? payload.level : "info";
+  const level = normalizeTraceLevel(payload.level);
   getGlobalTraceHub().publish("renderer", level, mergeTraceRuntimeContext(payload, context));
   return {
     ok: true,
@@ -127,10 +177,11 @@ function emitRendererTrace(level, input) {
   if (!rendererEnabled) {
     return;
   }
-  if (LEVEL_ORDER[level] < LEVEL_ORDER[rendererMinLevel]) {
+  if (traceLevelOrder(level) < traceLevelOrder(rendererMinLevel)) {
     return;
   }
   const normalized = { ...normalizeTraceInput(input), level };
+  getGlobalTraceHub().publishRendererToSinks(level, normalized);
   if (customRendererTraceTransport) {
     try {
       customRendererTraceTransport(normalized);
@@ -159,8 +210,10 @@ export {
   dispatchRendererTracePayload,
   emitRendererTrace,
   getTraceEvents$,
+  normalizeTraceLevel,
   publishMainTrace,
   publishTestTrace,
+  registerTraceSink,
   setMainTraceMinLevel,
   setRendererTraceEnabled,
   setRendererTraceMinLevel,