@noego/wood 0.4.5 → 0.4.7

package/dist/testing/index.js

@@ -12,11 +12,25 @@ import {
   browser,
   createBrowserBridgeFixture
 } from "./browser.js";
+import {
+  InProcessRouterTransport,
+  LoopbackRemoteTransport,
+  LoopbackRemoteTransportServer,
+  assertLoopbackSerializable,
+  LoopbackSerializationError,
+  buildTransportBridge
+} from "../transport/index.js";
 import { TraceRecorder } from "../trace-testing/index.js";
 export {
+  InProcessRouterTransport,
+  LoopbackRemoteTransport,
+  LoopbackRemoteTransportServer,
+  LoopbackSerializationError,
   RouterBridgeEvents,
   TraceRecorder,
+  assertLoopbackSerializable,
   browser,
+  buildTransportBridge,
   createBrowserBridgeFixture,
   createControllerHarness,
   createRouterBridge,

package/dist/testing/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/testing/index.ts"],"sourcesContent":["export { createTestContainer } from './create_test_container.js';\nexport {\n  createControllerHarness,\n  type ControllerHarnessResult,\n  type CreateControllerHarnessOptions,\n} from './create_controller_harness.js';\nexport { createTestRouter, type TestRouterResult } from './create_test_router.js';\nexport { mockElectron, getElectronMockFactory } from './mock_electron.js';\nexport {\n  createRouterBridge,\n  RouterBridgeEvents,\n  type RouterBridgeResult,\n} from './create_router_bridge.js';\nexport {\n  browser,\n  createBrowserBridgeFixture,\n  type MountedWoodBridge,\n  type MountedWoodComponent,\n  type MountedWoodNavigation,\n  type MountedWoodRoute,\n  type MountedWoodSurface,\n  type MountedWoodTree,\n  type MountComponentOptions,\n  type MountRouteOptions,\n  type MountTreeOptions,\n  type WoodBridgeFixtureContext,\n  type WoodBridgeFixtureInput,\n  type WoodBridgeRecordedCall,\n  type WoodBridgeRecordedEvent,\n  type WoodBrowserExpect,\n  type WoodBrowserHarness,\n  type WoodBrowserHarnessConfig,\n  type WoodBrowserPageContext,\n  type WoodBrowserTraceConfig,\n  type WoodViewport,\n} from './browser.js';\nexport { TraceRecorder } from '../trace-testing/index.js';\nexport type {\n  TraceDispatchResult,\n  TraceEvent,\n  TraceInput,\n  TraceWaitOptions,\n} from '../tracing/index.js';\n"],"mappings":"AAAA,SAAS,2BAA2B;AACpC;AAAA,EACE;AAAA,OAGK;AACP,SAAS,wBAA+C;AACxD,SAAS,cAAc,8BAA8B;AACrD;AAAA,EACE;AAAA,EACA;AAAA,OAEK;AACP;AAAA,EACE;AAAA,EACA;AAAA,OAoBK;AACP,SAAS,qBAAqB;","names":[]}
+{"version":3,"sources":["../../src/testing/index.ts"],"sourcesContent":["export { createTestContainer } from './create_test_container.js';\nexport {\n  createControllerHarness,\n  type ControllerHarnessResult,\n  type CreateControllerHarnessOptions,\n} from './create_controller_harness.js';\nexport { createTestRouter, type TestRouterResult } from './create_test_router.js';\nexport { mockElectron, getElectronMockFactory } from './mock_electron.js';\nexport {\n  createRouterBridge,\n  RouterBridgeEvents,\n  type RouterBridgeResult,\n} from './create_router_bridge.js';\nexport {\n  browser,\n  createBrowserBridgeFixture,\n  type MountedWoodBridge,\n  type MountedWoodComponent,\n  type MountedWoodNavigation,\n  type MountedWoodRoute,\n  type MountedWoodSurface,\n  type MountedWoodTree,\n  type MountComponentOptions,\n  type MountRouteOptions,\n  type MountTreeOptions,\n  type WoodBridgeFixtureContext,\n  type WoodBridgeFixtureInput,\n  type WoodBridgeRecordedCall,\n  type WoodBridgeRecordedEvent,\n  type WoodRpcManifestEntryInput,\n  type WoodBrowserExpect,\n  type WoodHitTestResult,\n  type WoodRectSnapshot,\n  type WoodBrowserHarness,\n  type WoodBrowserHarnessConfig,\n  type WoodBrowserPageContext,\n  type WoodBrowserTraceConfig,\n  type WoodViewport,\n} from './browser.js';\nexport {\n  InProcessRouterTransport,\n  LoopbackRemoteTransport,\n  LoopbackRemoteTransportServer,\n  assertLoopbackSerializable,\n  LoopbackSerializationError,\n  buildTransportBridge,\n  type WoodRpcTransport,\n  type WoodChannelContract,\n  type WoodChannelMapLike,\n  type WoodChannelInput,\n  type WoodChannelOutput,\n  type TypedCall,\n  type TransportBridgeResult,\n} from '../transport/index.js';\nexport { TraceRecorder } from '../trace-testing/index.js';\nexport type {\n  TraceDispatchResult,\n  TraceEvent,\n  TraceInput,\n  TraceWaitOptions,\n} from '../tracing/index.js';\n"],"mappings":"AAAA,SAAS,2BAA2B;AACpC;AAAA,EACE;AAAA,OAGK;AACP,SAAS,wBAA+C;AACxD,SAAS,cAAc,8BAA8B;AACrD;AAAA,EACE;AAAA,EACA;AAAA,OAEK;AACP;AAAA,EACE;AAAA,EACA;AAAA,OAuBK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAQK;AACP,SAAS,qBAAqB;","names":[]}

package/dist/trace-testing/index.d.cts

@@ -1,6 +1,6 @@
 export { TraceAssertions, TraceCountSummary, TraceFilter, TraceQuery, TraceRecorderEnableOptions, createTraceAssertions, createTraceQuery, matchesTrace, readPath } from '@noego/trace/testing';
 export { TraceRecorder } from './trace_recorder.cjs';
-import '../tracing/trace_hub.cjs';
+import '../trace_hub-Cob54qRx.cjs';
 import 'rxjs';
 import '../tracing/trace_provider.cjs';
 import '@noego/ioc';

package/dist/trace-testing/index.d.ts

@@ -1,6 +1,6 @@
 export { TraceAssertions, TraceCountSummary, TraceFilter, TraceQuery, TraceRecorderEnableOptions, createTraceAssertions, createTraceQuery, matchesTrace, readPath } from '@noego/trace/testing';
 export { TraceRecorder } from './trace_recorder.js';
-import '../tracing/trace_hub.js';
+import '../trace_hub-Cob54qRx.js';
 import 'rxjs';
 import '../tracing/trace_provider.js';
 import '@noego/ioc';

package/dist/trace-testing/trace_recorder.d.cts

@@ -1,6 +1,6 @@
 import { TraceRecorder as TraceRecorder$1 } from '@noego/trace/testing';
 export { TraceObservableSource, TraceRecorderEnableOptions, TraceRecorderSource, TraceWaitOptions } from '@noego/trace/testing';
-import { TraceEvent } from '../tracing/trace_hub.cjs';
+import { a as TraceEvent } from '../trace_hub-Cob54qRx.cjs';
 import { FrameworkTracer } from '../tracing/trace_provider.cjs';
 import 'rxjs';
 import '@noego/ioc';

package/dist/trace-testing/trace_recorder.d.ts

@@ -1,6 +1,6 @@
 import { TraceRecorder as TraceRecorder$1 } from '@noego/trace/testing';
 export { TraceObservableSource, TraceRecorderEnableOptions, TraceRecorderSource, TraceWaitOptions } from '@noego/trace/testing';
-import { TraceEvent } from '../tracing/trace_hub.js';
+import { a as TraceEvent } from '../trace_hub-Cob54qRx.js';
 import { FrameworkTracer } from '../tracing/trace_provider.js';
 import 'rxjs';
 import '@noego/ioc';

package/dist/trace-transport/index.cjs

@@ -0,0 +1,32 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var trace_transport_exports = {};
+__export(trace_transport_exports, {
+  RendererTraceBatchTransport: () => import_renderer_trace_batch_transport.RendererTraceBatchTransport,
+  WoodTraceBatchContract: () => import_wood_trace_batch_contract.WoodTraceBatchContract
+});
+module.exports = __toCommonJS(trace_transport_exports);
+var import_renderer_trace_batch_transport = require("../tracing/renderer_trace_batch_transport.js");
+var import_wood_trace_batch_contract = require("../tracing/wood_trace_batch_contract.js");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  RendererTraceBatchTransport,
+  WoodTraceBatchContract
+});
+//# sourceMappingURL=index.cjs.map

package/dist/trace-transport/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/trace-transport/index.ts"],"sourcesContent":["export { RendererTraceBatchTransport } from '../tracing/renderer_trace_batch_transport.js';\nexport { WoodTraceBatchContract } from '../tracing/wood_trace_batch_contract.js';\nexport type {\n  WoodRendererTraceEvent,\n  WoodRendererTraceInput,\n  WoodTraceBatch,\n  WoodTraceBatchAcknowledgement,\n  WoodTraceBatchAdmissionResult,\n  WoodTraceBatchPort,\n  WoodTraceBatchTransportOptions,\n  WoodTraceBatchTransportStatus,\n} from '../tracing/types/wood_trace_batch.types.js';\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,4CAA4C;AAC5C,uCAAuC;","names":[]}

package/dist/trace-transport/index.d.cts

@@ -0,0 +1,6 @@
+export { RendererTraceBatchTransport } from '../tracing/renderer_trace_batch_transport.cjs';
+export { WoodTraceBatchContract } from '../tracing/wood_trace_batch_contract.cjs';
+export { WoodRendererTraceEvent, WoodRendererTraceInput, WoodTraceBatch, WoodTraceBatchAcknowledgement, WoodTraceBatchAdmissionResult, WoodTraceBatchPort, WoodTraceBatchTransportOptions, WoodTraceBatchTransportStatus } from '../tracing/types/wood_trace_batch.types.cjs';
+import '@noego/telemetry/core';
+import '../trace_hub-Cob54qRx.cjs';
+import 'rxjs';

package/dist/trace-transport/index.d.ts

@@ -0,0 +1,6 @@
+export { RendererTraceBatchTransport } from '../tracing/renderer_trace_batch_transport.js';
+export { WoodTraceBatchContract } from '../tracing/wood_trace_batch_contract.js';
+export { WoodRendererTraceEvent, WoodRendererTraceInput, WoodTraceBatch, WoodTraceBatchAcknowledgement, WoodTraceBatchAdmissionResult, WoodTraceBatchPort, WoodTraceBatchTransportOptions, WoodTraceBatchTransportStatus } from '../tracing/types/wood_trace_batch.types.js';
+import '@noego/telemetry/core';
+import '../trace_hub-Cob54qRx.js';
+import 'rxjs';

package/dist/trace-transport/index.js

@@ -0,0 +1,7 @@
+import { RendererTraceBatchTransport } from "../tracing/renderer_trace_batch_transport.js";
+import { WoodTraceBatchContract } from "../tracing/wood_trace_batch_contract.js";
+export {
+  RendererTraceBatchTransport,
+  WoodTraceBatchContract
+};
+//# sourceMappingURL=index.js.map

package/dist/trace-transport/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/trace-transport/index.ts"],"sourcesContent":["export { RendererTraceBatchTransport } from '../tracing/renderer_trace_batch_transport.js';\nexport { WoodTraceBatchContract } from '../tracing/wood_trace_batch_contract.js';\nexport type {\n  WoodRendererTraceEvent,\n  WoodRendererTraceInput,\n  WoodTraceBatch,\n  WoodTraceBatchAcknowledgement,\n  WoodTraceBatchAdmissionResult,\n  WoodTraceBatchPort,\n  WoodTraceBatchTransportOptions,\n  WoodTraceBatchTransportStatus,\n} from '../tracing/types/wood_trace_batch.types.js';\n"],"mappings":"AAAA,SAAS,mCAAmC;AAC5C,SAAS,8BAA8B;","names":[]}

package/dist/trace_hub-Cob54qRx.d.cts

@@ -0,0 +1,56 @@
+import { Observable } from 'rxjs';
+
+/** A caller-independent, shallow immutable Wood trace event. */
+type WoodTraceEventSnapshot = Readonly<Omit<TraceEvent, 'payload'> & {
+    readonly payload?: Readonly<Record<string, unknown>>;
+}>;
+type WoodTraceEventSink = (event: WoodTraceEventSnapshot) => void;
+type WoodTraceSinkDisposer = () => void;
+
+type StandardTraceLevel = 'debug' | 'info' | 'warn' | 'error';
+type TraceLevel = StandardTraceLevel | (string & {});
+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 normalizeTraceLevel(level: unknown, fallback?: TraceLevel): TraceLevel;
+declare function getTraceEvents$(): Observable<TraceEvent>;
+declare function registerTraceSink(sink: WoodTraceEventSink): WoodTraceSinkDisposer;
+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 StandardTraceLevel as S, type TraceDispatchResult as T, type WoodTraceEventSink as W, type TraceEvent as a, type TraceInput as b, type TraceLevel as c, type TraceProcess as d, type TraceRuntimeContext as e, type TraceWaitOptions as f, type WoodTraceEventSnapshot as g, type WoodTraceSinkDisposer as h, clearTraceHubForTests as i, getTraceEvents$ as j, setRendererTraceTransport as k, dispatchRendererTracePayload as l, emitRendererTrace as m, publishTestTrace as n, setMainTraceMinLevel as o, publishMainTrace as p, setRendererTraceMinLevel as q, registerTraceSink as r, setRendererTraceEnabled as s, normalizeTraceLevel as t };

package/dist/trace_hub-Cob54qRx.d.ts

@@ -0,0 +1,56 @@
+import { Observable } from 'rxjs';
+
+/** A caller-independent, shallow immutable Wood trace event. */
+type WoodTraceEventSnapshot = Readonly<Omit<TraceEvent, 'payload'> & {
+    readonly payload?: Readonly<Record<string, unknown>>;
+}>;
+type WoodTraceEventSink = (event: WoodTraceEventSnapshot) => void;
+type WoodTraceSinkDisposer = () => void;
+
+type StandardTraceLevel = 'debug' | 'info' | 'warn' | 'error';
+type TraceLevel = StandardTraceLevel | (string & {});
+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 normalizeTraceLevel(level: unknown, fallback?: TraceLevel): TraceLevel;
+declare function getTraceEvents$(): Observable<TraceEvent>;
+declare function registerTraceSink(sink: WoodTraceEventSink): WoodTraceSinkDisposer;
+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 StandardTraceLevel as S, type TraceDispatchResult as T, type WoodTraceEventSink as W, type TraceEvent as a, type TraceInput as b, type TraceLevel as c, type TraceProcess as d, type TraceRuntimeContext as e, type TraceWaitOptions as f, type WoodTraceEventSnapshot as g, type WoodTraceSinkDisposer as h, clearTraceHubForTests as i, getTraceEvents$ as j, setRendererTraceTransport as k, dispatchRendererTracePayload as l, emitRendererTrace as m, publishTestTrace as n, setMainTraceMinLevel as o, publishMainTrace as p, setRendererTraceMinLevel as q, registerTraceSink as r, setRendererTraceEnabled as s, normalizeTraceLevel as t };

package/dist/tracing/index.cjs

@@ -20,16 +20,21 @@ var tracing_exports = {};
 __export(tracing_exports, {
   FrameworkTracer: () => import_trace_provider.FrameworkTracer,
   MainTracer: () => import_trace_provider.MainTracer,
+  RendererTraceBatchHost: () => import_renderer_trace_batch_host.RendererTraceBatchHost,
+  RendererTraceBatchTransport: () => import_renderer_trace_batch_transport.RendererTraceBatchTransport,
   RendererTracer: () => import_trace_provider.RendererTracer,
   TestTracer: () => import_trace_provider.TestTracer,
+  TraceCommitWriter: () => import_trace_commit_writer.TraceCommitWriter,
   TraceProvider: () => import_trace_provider.TraceProvider,
   TraceProviderConfiguration: () => import_trace_provider.TraceProviderConfiguration,
+  WoodTraceBatchContract: () => import_wood_trace_batch_contract.WoodTraceBatchContract,
   clearTraceHubForTests: () => import_trace_hub.clearTraceHubForTests,
   dispatchRendererTracePayload: () => import_trace_hub.dispatchRendererTracePayload,
   emitRendererTrace: () => import_trace_hub.emitRendererTrace,
   getTraceEvents$: () => import_trace_hub.getTraceEvents$,
   publishMainTrace: () => import_trace_hub.publishMainTrace,
   publishTestTrace: () => import_trace_hub.publishTestTrace,
+  registerTraceSink: () => import_trace_hub.registerTraceSink,
   setMainTraceMinLevel: () => import_trace_hub.setMainTraceMinLevel,
   setRendererTraceEnabled: () => import_trace_hub.setRendererTraceEnabled,
   setRendererTraceMinLevel: () => import_trace_hub.setRendererTraceMinLevel,
@@ -37,21 +42,30 @@ __export(tracing_exports, {
 });
 module.exports = __toCommonJS(tracing_exports);
 var import_trace_hub = require("./trace_hub.js");
+var import_renderer_trace_batch_host = require("./renderer_trace_batch_host.js");
+var import_renderer_trace_batch_transport = require("./renderer_trace_batch_transport.js");
+var import_wood_trace_batch_contract = require("./wood_trace_batch_contract.js");
+var import_trace_commit_writer = require("./trace_commit_writer.js");
 var import_trace_provider = require("./trace_provider.js");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   FrameworkTracer,
   MainTracer,
+  RendererTraceBatchHost,
+  RendererTraceBatchTransport,
   RendererTracer,
   TestTracer,
+  TraceCommitWriter,
   TraceProvider,
   TraceProviderConfiguration,
+  WoodTraceBatchContract,
   clearTraceHubForTests,
   dispatchRendererTracePayload,
   emitRendererTrace,
   getTraceEvents$,
   publishMainTrace,
   publishTestTrace,
+  registerTraceSink,
   setMainTraceMinLevel,
   setRendererTraceEnabled,
   setRendererTraceMinLevel,

package/dist/tracing/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/tracing/index.ts"],"sourcesContent":["export {\n  clearTraceHubForTests,\n  dispatchRendererTracePayload,\n  emitRendererTrace,\n  getTraceEvents$,\n  publishMainTrace,\n  publishTestTrace,\n  setMainTraceMinLevel,\n  setRendererTraceEnabled,\n  setRendererTraceMinLevel,\n  setRendererTraceTransport,\n  type TraceDispatchResult,\n  type TraceEvent,\n  type TraceInput,\n  type TraceLevel,\n  type TraceProcess,\n  type TraceRuntimeContext,\n  type TraceWaitOptions,\n} from './trace_hub.js';\n\nexport {\n  FrameworkTracer,\n  MainTracer,\n  RendererTracer,\n  TestTracer,\n  TraceProvider,\n  TraceProviderConfiguration,\n  type TraceContext,\n  type TraceProviderMode,\n  type TraceRuntime,\n} from './trace_provider.js';\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,uBAkBO;AAEP,4BAUO;","names":[]}
+{"version":3,"sources":["../../src/tracing/index.ts"],"sourcesContent":["export {\n  clearTraceHubForTests,\n  dispatchRendererTracePayload,\n  emitRendererTrace,\n  getTraceEvents$,\n  publishMainTrace,\n  publishTestTrace,\n  registerTraceSink,\n  setMainTraceMinLevel,\n  setRendererTraceEnabled,\n  setRendererTraceMinLevel,\n  setRendererTraceTransport,\n  type TraceDispatchResult,\n  type TraceEvent,\n  type TraceInput,\n  type TraceLevel,\n  type TraceProcess,\n  type TraceRuntimeContext,\n  type TraceWaitOptions,\n} from './trace_hub.js';\n\nexport { RendererTraceBatchHost } from './renderer_trace_batch_host.js';\nexport { RendererTraceBatchTransport } from './renderer_trace_batch_transport.js';\nexport { WoodTraceBatchContract } from './wood_trace_batch_contract.js';\nexport type {\n  WoodRendererTraceEvent,\n  WoodRendererTraceInput,\n  WoodTraceAcknowledgementParseResult,\n  WoodTraceBatch,\n  WoodTraceBatchAcknowledgement,\n  WoodTraceBatchAdmissionResult,\n  WoodTraceBatchParseResult,\n  WoodTraceBatchPort,\n  WoodTraceBatchReceiver,\n  WoodTraceBatchRuntimeContext,\n  WoodTraceBatchTransportOptions,\n  WoodTraceBatchTransportStatus,\n  WoodTraceEventParseResult,\n  WoodTraceEventsParseResult,\n  WoodTraceIdentityValidationResult,\n} from './types/wood_trace_batch.types.js';\nexport type {\n  WoodTraceEventSink,\n  WoodTraceEventSnapshot,\n  WoodTraceSinkDisposer,\n} from './types/wood_trace_sink.types.js';\n\nexport {\n  TraceCommitWriter,\n  type TraceCommitRow,\n  type TraceCommitWriterOptions,\n  type TraceFlushOptions,\n  type TraceFlushResult,\n  type WoodTracePersistencePort,\n} from './trace_commit_writer.js';\n\nexport {\n  FrameworkTracer,\n  MainTracer,\n  RendererTracer,\n  TestTracer,\n  TraceProvider,\n  TraceProviderConfiguration,\n  type TraceContext,\n  type TraceProviderMode,\n  type TraceRuntime,\n} from './trace_provider.js';\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,uBAmBO;AAEP,uCAAuC;AACvC,4CAA4C;AAC5C,uCAAuC;AAwBvC,iCAOO;AAEP,4BAUO;","names":[]}

package/dist/tracing/index.d.cts

@@ -1,4 +1,10 @@
-export { TraceDispatchResult, TraceEvent, TraceInput, TraceLevel, TraceProcess, TraceRuntimeContext, TraceWaitOptions, clearTraceHubForTests, dispatchRendererTracePayload, emitRendererTrace, getTraceEvents$, publishMainTrace, publishTestTrace, setMainTraceMinLevel, setRendererTraceEnabled, setRendererTraceMinLevel, setRendererTraceTransport } from './trace_hub.cjs';
+export { T as TraceDispatchResult, a as TraceEvent, b as TraceInput, c as TraceLevel, d as TraceProcess, e as TraceRuntimeContext, f as TraceWaitOptions, W as WoodTraceEventSink, g as WoodTraceEventSnapshot, h as WoodTraceSinkDisposer, i as clearTraceHubForTests, l as dispatchRendererTracePayload, m as emitRendererTrace, j as getTraceEvents$, 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';
+export { RendererTraceBatchHost } from './renderer_trace_batch_host.cjs';
+export { RendererTraceBatchTransport } from './renderer_trace_batch_transport.cjs';
+export { WoodTraceBatchContract } from './wood_trace_batch_contract.cjs';
+export { WoodRendererTraceEvent, WoodRendererTraceInput, WoodTraceAcknowledgementParseResult, WoodTraceBatch, WoodTraceBatchAcknowledgement, WoodTraceBatchAdmissionResult, WoodTraceBatchParseResult, WoodTraceBatchPort, WoodTraceBatchReceiver, WoodTraceBatchRuntimeContext, WoodTraceBatchTransportOptions, WoodTraceBatchTransportStatus, WoodTraceEventParseResult, WoodTraceEventsParseResult, WoodTraceIdentityValidationResult } from './types/wood_trace_batch.types.cjs';
+export { TraceCommitRow, TraceCommitWriter, TraceCommitWriterOptions, TraceFlushOptions, TraceFlushResult, WoodTracePersistencePort } from './trace_commit_writer.cjs';
 export { FrameworkTracer, MainTracer, RendererTracer, TestTracer, TraceContext, TraceProvider, TraceProviderConfiguration, TraceProviderMode, TraceRuntime } from './trace_provider.cjs';
 import 'rxjs';
+import '@noego/telemetry/core';
 import '@noego/ioc';

package/dist/tracing/index.d.ts

@@ -1,4 +1,10 @@
-export { TraceDispatchResult, TraceEvent, TraceInput, TraceLevel, TraceProcess, TraceRuntimeContext, TraceWaitOptions, clearTraceHubForTests, dispatchRendererTracePayload, emitRendererTrace, getTraceEvents$, publishMainTrace, publishTestTrace, setMainTraceMinLevel, setRendererTraceEnabled, setRendererTraceMinLevel, setRendererTraceTransport } from './trace_hub.js';
+export { T as TraceDispatchResult, a as TraceEvent, b as TraceInput, c as TraceLevel, d as TraceProcess, e as TraceRuntimeContext, f as TraceWaitOptions, W as WoodTraceEventSink, g as WoodTraceEventSnapshot, h as WoodTraceSinkDisposer, i as clearTraceHubForTests, l as dispatchRendererTracePayload, m as emitRendererTrace, j as getTraceEvents$, 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';
+export { RendererTraceBatchHost } from './renderer_trace_batch_host.js';
+export { RendererTraceBatchTransport } from './renderer_trace_batch_transport.js';
+export { WoodTraceBatchContract } from './wood_trace_batch_contract.js';
+export { WoodRendererTraceEvent, WoodRendererTraceInput, WoodTraceAcknowledgementParseResult, WoodTraceBatch, WoodTraceBatchAcknowledgement, WoodTraceBatchAdmissionResult, WoodTraceBatchParseResult, WoodTraceBatchPort, WoodTraceBatchReceiver, WoodTraceBatchRuntimeContext, WoodTraceBatchTransportOptions, WoodTraceBatchTransportStatus, WoodTraceEventParseResult, WoodTraceEventsParseResult, WoodTraceIdentityValidationResult } from './types/wood_trace_batch.types.js';
+export { TraceCommitRow, TraceCommitWriter, TraceCommitWriterOptions, TraceFlushOptions, TraceFlushResult, WoodTracePersistencePort } from './trace_commit_writer.js';
 export { FrameworkTracer, MainTracer, RendererTracer, TestTracer, TraceContext, TraceProvider, TraceProviderConfiguration, TraceProviderMode, TraceRuntime } from './trace_provider.js';
 import 'rxjs';
+import '@noego/telemetry/core';
 import '@noego/ioc';

package/dist/tracing/index.js

@@ -5,11 +5,18 @@ import {
   getTraceEvents$,
   publishMainTrace,
   publishTestTrace,
+  registerTraceSink,
   setMainTraceMinLevel,
   setRendererTraceEnabled,
   setRendererTraceMinLevel,
   setRendererTraceTransport
 } from "./trace_hub.js";
+import { RendererTraceBatchHost } from "./renderer_trace_batch_host.js";
+import { RendererTraceBatchTransport } from "./renderer_trace_batch_transport.js";
+import { WoodTraceBatchContract } from "./wood_trace_batch_contract.js";
+import {
+  TraceCommitWriter
+} from "./trace_commit_writer.js";
 import {
   FrameworkTracer,
   MainTracer,
@@ -21,16 +28,21 @@ import {
 export {
   FrameworkTracer,
   MainTracer,
+  RendererTraceBatchHost,
+  RendererTraceBatchTransport,
   RendererTracer,
   TestTracer,
+  TraceCommitWriter,
   TraceProvider,
   TraceProviderConfiguration,
+  WoodTraceBatchContract,
   clearTraceHubForTests,
   dispatchRendererTracePayload,
   emitRendererTrace,
   getTraceEvents$,
   publishMainTrace,
   publishTestTrace,
+  registerTraceSink,
   setMainTraceMinLevel,
   setRendererTraceEnabled,
   setRendererTraceMinLevel,

package/dist/tracing/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/tracing/index.ts"],"sourcesContent":["export {\n  clearTraceHubForTests,\n  dispatchRendererTracePayload,\n  emitRendererTrace,\n  getTraceEvents$,\n  publishMainTrace,\n  publishTestTrace,\n  setMainTraceMinLevel,\n  setRendererTraceEnabled,\n  setRendererTraceMinLevel,\n  setRendererTraceTransport,\n  type TraceDispatchResult,\n  type TraceEvent,\n  type TraceInput,\n  type TraceLevel,\n  type TraceProcess,\n  type TraceRuntimeContext,\n  type TraceWaitOptions,\n} from './trace_hub.js';\n\nexport {\n  FrameworkTracer,\n  MainTracer,\n  RendererTracer,\n  TestTracer,\n  TraceProvider,\n  TraceProviderConfiguration,\n  type TraceContext,\n  type TraceProviderMode,\n  type TraceRuntime,\n} from './trace_provider.js';\n"],"mappings":"AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAQK;AAEP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAIK;","names":[]}
+{"version":3,"sources":["../../src/tracing/index.ts"],"sourcesContent":["export {\n  clearTraceHubForTests,\n  dispatchRendererTracePayload,\n  emitRendererTrace,\n  getTraceEvents$,\n  publishMainTrace,\n  publishTestTrace,\n  registerTraceSink,\n  setMainTraceMinLevel,\n  setRendererTraceEnabled,\n  setRendererTraceMinLevel,\n  setRendererTraceTransport,\n  type TraceDispatchResult,\n  type TraceEvent,\n  type TraceInput,\n  type TraceLevel,\n  type TraceProcess,\n  type TraceRuntimeContext,\n  type TraceWaitOptions,\n} from './trace_hub.js';\n\nexport { RendererTraceBatchHost } from './renderer_trace_batch_host.js';\nexport { RendererTraceBatchTransport } from './renderer_trace_batch_transport.js';\nexport { WoodTraceBatchContract } from './wood_trace_batch_contract.js';\nexport type {\n  WoodRendererTraceEvent,\n  WoodRendererTraceInput,\n  WoodTraceAcknowledgementParseResult,\n  WoodTraceBatch,\n  WoodTraceBatchAcknowledgement,\n  WoodTraceBatchAdmissionResult,\n  WoodTraceBatchParseResult,\n  WoodTraceBatchPort,\n  WoodTraceBatchReceiver,\n  WoodTraceBatchRuntimeContext,\n  WoodTraceBatchTransportOptions,\n  WoodTraceBatchTransportStatus,\n  WoodTraceEventParseResult,\n  WoodTraceEventsParseResult,\n  WoodTraceIdentityValidationResult,\n} from './types/wood_trace_batch.types.js';\nexport type {\n  WoodTraceEventSink,\n  WoodTraceEventSnapshot,\n  WoodTraceSinkDisposer,\n} from './types/wood_trace_sink.types.js';\n\nexport {\n  TraceCommitWriter,\n  type TraceCommitRow,\n  type TraceCommitWriterOptions,\n  type TraceFlushOptions,\n  type TraceFlushResult,\n  type WoodTracePersistencePort,\n} from './trace_commit_writer.js';\n\nexport {\n  FrameworkTracer,\n  MainTracer,\n  RendererTracer,\n  TestTracer,\n  TraceProvider,\n  TraceProviderConfiguration,\n  type TraceContext,\n  type TraceProviderMode,\n  type TraceRuntime,\n} from './trace_provider.js';\n"],"mappings":"AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAQK;AAEP,SAAS,8BAA8B;AACvC,SAAS,mCAAmC;AAC5C,SAAS,8BAA8B;AAwBvC;AAAA,EACE;AAAA,OAMK;AAEP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAIK;","names":[]}

package/dist/tracing/renderer_trace_batch_host.cjs

@@ -0,0 +1,80 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var renderer_trace_batch_host_exports = {};
+__export(renderer_trace_batch_host_exports, {
+  RendererTraceBatchHost: () => RendererTraceBatchHost
+});
+module.exports = __toCommonJS(renderer_trace_batch_host_exports);
+var import_wood_trace_batch_contract = require("./wood_trace_batch_contract.js");
+const RECEIVER_RETRY_MS = 100;
+class RendererTraceBatchHost {
+  constructor(receiver) {
+    this.receiver = receiver;
+    this.contract = new import_wood_trace_batch_contract.WoodTraceBatchContract();
+  }
+  async receive(input, context) {
+    const parsed = this.contract.parse(input);
+    if (parsed.kind === "not-batch") {
+      return this.rejected("unknown", "Payload is not a Wood trace batch");
+    }
+    if (parsed.kind === "invalid") {
+      return this.rejected(parsed.batchId ?? "unknown", parsed.reason);
+    }
+    if (!this.receiver) {
+      return this.retryable(
+        parsed.batch.batchId,
+        "renderer trace batch receiver is not configured"
+      );
+    }
+    let acknowledgement;
+    try {
+      acknowledgement = await this.receiver(parsed.batch, context);
+    } catch (error) {
+      return this.retryable(parsed.batch.batchId, this.errorMessage(error));
+    }
+    const validated = this.contract.parseAcknowledgement(acknowledgement);
+    if (!validated.ok || validated.acknowledgement.batchId !== parsed.batch.batchId) {
+      return this.retryable(parsed.batch.batchId, "renderer trace batch receiver returned an invalid acknowledgement");
+    }
+    const committedCountMismatch = validated.acknowledgement.kind === "committed" && validated.acknowledgement.acceptedEvents !== parsed.batch.events.length;
+    if (committedCountMismatch) {
+      return this.retryable(parsed.batch.batchId, "renderer trace batch receiver committed a partial batch");
+    }
+    return validated.acknowledgement;
+  }
+  errorMessage(error) {
+    return (error instanceof Error ? error.message : String(error)).slice(0, 512);
+  }
+  rejected(batchId, reason) {
+    return Object.freeze({ kind: "rejected", batchId, reason });
+  }
+  retryable(batchId, reason) {
+    return Object.freeze({
+      kind: "retryable",
+      batchId,
+      reason,
+      retryAfterMs: RECEIVER_RETRY_MS
+    });
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  RendererTraceBatchHost
+});
+//# sourceMappingURL=renderer_trace_batch_host.cjs.map

package/dist/tracing/renderer_trace_batch_host.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/tracing/renderer_trace_batch_host.ts"],"sourcesContent":["import { WoodTraceBatchContract } from './wood_trace_batch_contract.js';\nimport type {\n  WoodTraceBatchAcknowledgement,\n  WoodTraceBatchReceiver,\n  WoodTraceBatchRuntimeContext,\n} from './types/wood_trace_batch.types.js';\n\nconst RECEIVER_RETRY_MS = 100;\n\nexport class RendererTraceBatchHost {\n  private readonly contract = new WoodTraceBatchContract();\n\n  constructor(private readonly receiver: WoodTraceBatchReceiver | null) {}\n\n  async receive(\n    input: unknown,\n    context: WoodTraceBatchRuntimeContext,\n  ): Promise<WoodTraceBatchAcknowledgement> {\n    const parsed = this.contract.parse(input);\n    if (parsed.kind === 'not-batch') {\n      return this.rejected('unknown', 'Payload is not a Wood trace batch');\n    }\n    if (parsed.kind === 'invalid') {\n      return this.rejected(parsed.batchId ?? 'unknown', parsed.reason);\n    }\n    if (!this.receiver) {\n      return this.retryable(\n        parsed.batch.batchId,\n        'renderer trace batch receiver is not configured',\n      );\n    }\n\n    let acknowledgement: WoodTraceBatchAcknowledgement;\n    try {\n      acknowledgement = await this.receiver(parsed.batch, context);\n    } catch (error) {\n      return this.retryable(parsed.batch.batchId, this.errorMessage(error));\n    }\n\n    const validated = this.contract.parseAcknowledgement(acknowledgement);\n    if (!validated.ok || validated.acknowledgement.batchId !== parsed.batch.batchId) {\n      return this.retryable(parsed.batch.batchId, 'renderer trace batch receiver returned an invalid acknowledgement');\n    }\n    const committedCountMismatch = validated.acknowledgement.kind === 'committed'\n      && validated.acknowledgement.acceptedEvents !== parsed.batch.events.length;\n    if (committedCountMismatch) {\n      return this.retryable(parsed.batch.batchId, 'renderer trace batch receiver committed a partial batch');\n    }\n    return validated.acknowledgement;\n  }\n\n  private errorMessage(error: unknown): string {\n    return (error instanceof Error ? error.message : String(error)).slice(0, 512);\n  }\n\n  private rejected(batchId: string, reason: string): WoodTraceBatchAcknowledgement {\n    return Object.freeze({ kind: 'rejected', batchId, reason });\n  }\n\n  private retryable(batchId: string, reason: string): WoodTraceBatchAcknowledgement {\n    return Object.freeze({\n      kind: 'retryable',\n      batchId,\n      reason,\n      retryAfterMs: RECEIVER_RETRY_MS,\n    });\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,uCAAuC;AAOvC,MAAM,oBAAoB;AAEnB,MAAM,uBAAuB;AAAA,EAGlC,YAA6B,UAAyC;AAAzC;AAF7B,SAAiB,WAAW,IAAI,wDAAuB;AAAA,EAEgB;AAAA,EAEvE,MAAM,QACJ,OACA,SACwC;AACxC,UAAM,SAAS,KAAK,SAAS,MAAM,KAAK;AACxC,QAAI,OAAO,SAAS,aAAa;AAC/B,aAAO,KAAK,SAAS,WAAW,mCAAmC;AAAA,IACrE;AACA,QAAI,OAAO,SAAS,WAAW;AAC7B,aAAO,KAAK,SAAS,OAAO,WAAW,WAAW,OAAO,MAAM;AAAA,IACjE;AACA,QAAI,CAAC,KAAK,UAAU;AAClB,aAAO,KAAK;AAAA,QACV,OAAO,MAAM;AAAA,QACb;AAAA,MACF;AAAA,IACF;AAEA,QAAI;AACJ,QAAI;AACF,wBAAkB,MAAM,KAAK,SAAS,OAAO,OAAO,OAAO;AAAA,IAC7D,SAAS,OAAO;AACd,aAAO,KAAK,UAAU,OAAO,MAAM,SAAS,KAAK,aAAa,KAAK,CAAC;AAAA,IACtE;AAEA,UAAM,YAAY,KAAK,SAAS,qBAAqB,eAAe;AACpE,QAAI,CAAC,UAAU,MAAM,UAAU,gBAAgB,YAAY,OAAO,MAAM,SAAS;AAC/E,aAAO,KAAK,UAAU,OAAO,MAAM,SAAS,mEAAmE;AAAA,IACjH;AACA,UAAM,yBAAyB,UAAU,gBAAgB,SAAS,eAC7D,UAAU,gBAAgB,mBAAmB,OAAO,MAAM,OAAO;AACtE,QAAI,wBAAwB;AAC1B,aAAO,KAAK,UAAU,OAAO,MAAM,SAAS,yDAAyD;AAAA,IACvG;AACA,WAAO,UAAU;AAAA,EACnB;AAAA,EAEQ,aAAa,OAAwB;AAC3C,YAAQ,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,GAAG,MAAM,GAAG,GAAG;AAAA,EAC9E;AAAA,EAEQ,SAAS,SAAiB,QAA+C;AAC/E,WAAO,OAAO,OAAO,EAAE,MAAM,YAAY,SAAS,OAAO,CAAC;AAAA,EAC5D;AAAA,EAEQ,UAAU,SAAiB,QAA+C;AAChF,WAAO,OAAO,OAAO;AAAA,MACnB,MAAM;AAAA,MACN;AAAA,MACA;AAAA,MACA,cAAc;AAAA,IAChB,CAAC;AAAA,EACH;AACF;","names":[]}

package/dist/tracing/renderer_trace_batch_host.d.cts

@@ -0,0 +1,16 @@
+import { WoodTraceBatchReceiver, WoodTraceBatchRuntimeContext, WoodTraceBatchAcknowledgement } from './types/wood_trace_batch.types.cjs';
+import '@noego/telemetry/core';
+import '../trace_hub-Cob54qRx.cjs';
+import 'rxjs';
+
+declare class RendererTraceBatchHost {
+    private readonly receiver;
+    private readonly contract;
+    constructor(receiver: WoodTraceBatchReceiver | null);
+    receive(input: unknown, context: WoodTraceBatchRuntimeContext): Promise<WoodTraceBatchAcknowledgement>;
+    private errorMessage;
+    private rejected;
+    private retryable;
+}
+
+export { RendererTraceBatchHost };

package/dist/tracing/renderer_trace_batch_host.d.ts

@@ -0,0 +1,16 @@
+import { WoodTraceBatchReceiver, WoodTraceBatchRuntimeContext, WoodTraceBatchAcknowledgement } from './types/wood_trace_batch.types.js';
+import '@noego/telemetry/core';
+import '../trace_hub-Cob54qRx.js';
+import 'rxjs';
+
+declare class RendererTraceBatchHost {
+    private readonly receiver;
+    private readonly contract;
+    constructor(receiver: WoodTraceBatchReceiver | null);
+    receive(input: unknown, context: WoodTraceBatchRuntimeContext): Promise<WoodTraceBatchAcknowledgement>;
+    private errorMessage;
+    private rejected;
+    private retryable;
+}
+
+export { RendererTraceBatchHost };

package/dist/tracing/renderer_trace_batch_host.js

@@ -0,0 +1,56 @@
+import { WoodTraceBatchContract } from "./wood_trace_batch_contract.js";
+const RECEIVER_RETRY_MS = 100;
+class RendererTraceBatchHost {
+  constructor(receiver) {
+    this.receiver = receiver;
+    this.contract = new WoodTraceBatchContract();
+  }
+  async receive(input, context) {
+    const parsed = this.contract.parse(input);
+    if (parsed.kind === "not-batch") {
+      return this.rejected("unknown", "Payload is not a Wood trace batch");
+    }
+    if (parsed.kind === "invalid") {
+      return this.rejected(parsed.batchId ?? "unknown", parsed.reason);
+    }
+    if (!this.receiver) {
+      return this.retryable(
+        parsed.batch.batchId,
+        "renderer trace batch receiver is not configured"
+      );
+    }
+    let acknowledgement;
+    try {
+      acknowledgement = await this.receiver(parsed.batch, context);
+    } catch (error) {
+      return this.retryable(parsed.batch.batchId, this.errorMessage(error));
+    }
+    const validated = this.contract.parseAcknowledgement(acknowledgement);
+    if (!validated.ok || validated.acknowledgement.batchId !== parsed.batch.batchId) {
+      return this.retryable(parsed.batch.batchId, "renderer trace batch receiver returned an invalid acknowledgement");
+    }
+    const committedCountMismatch = validated.acknowledgement.kind === "committed" && validated.acknowledgement.acceptedEvents !== parsed.batch.events.length;
+    if (committedCountMismatch) {
+      return this.retryable(parsed.batch.batchId, "renderer trace batch receiver committed a partial batch");
+    }
+    return validated.acknowledgement;
+  }
+  errorMessage(error) {
+    return (error instanceof Error ? error.message : String(error)).slice(0, 512);
+  }
+  rejected(batchId, reason) {
+    return Object.freeze({ kind: "rejected", batchId, reason });
+  }
+  retryable(batchId, reason) {
+    return Object.freeze({
+      kind: "retryable",
+      batchId,
+      reason,
+      retryAfterMs: RECEIVER_RETRY_MS
+    });
+  }
+}
+export {
+  RendererTraceBatchHost
+};
+//# sourceMappingURL=renderer_trace_batch_host.js.map

package/dist/tracing/renderer_trace_batch_host.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/tracing/renderer_trace_batch_host.ts"],"sourcesContent":["import { WoodTraceBatchContract } from './wood_trace_batch_contract.js';\nimport type {\n  WoodTraceBatchAcknowledgement,\n  WoodTraceBatchReceiver,\n  WoodTraceBatchRuntimeContext,\n} from './types/wood_trace_batch.types.js';\n\nconst RECEIVER_RETRY_MS = 100;\n\nexport class RendererTraceBatchHost {\n  private readonly contract = new WoodTraceBatchContract();\n\n  constructor(private readonly receiver: WoodTraceBatchReceiver | null) {}\n\n  async receive(\n    input: unknown,\n    context: WoodTraceBatchRuntimeContext,\n  ): Promise<WoodTraceBatchAcknowledgement> {\n    const parsed = this.contract.parse(input);\n    if (parsed.kind === 'not-batch') {\n      return this.rejected('unknown', 'Payload is not a Wood trace batch');\n    }\n    if (parsed.kind === 'invalid') {\n      return this.rejected(parsed.batchId ?? 'unknown', parsed.reason);\n    }\n    if (!this.receiver) {\n      return this.retryable(\n        parsed.batch.batchId,\n        'renderer trace batch receiver is not configured',\n      );\n    }\n\n    let acknowledgement: WoodTraceBatchAcknowledgement;\n    try {\n      acknowledgement = await this.receiver(parsed.batch, context);\n    } catch (error) {\n      return this.retryable(parsed.batch.batchId, this.errorMessage(error));\n    }\n\n    const validated = this.contract.parseAcknowledgement(acknowledgement);\n    if (!validated.ok || validated.acknowledgement.batchId !== parsed.batch.batchId) {\n      return this.retryable(parsed.batch.batchId, 'renderer trace batch receiver returned an invalid acknowledgement');\n    }\n    const committedCountMismatch = validated.acknowledgement.kind === 'committed'\n      && validated.acknowledgement.acceptedEvents !== parsed.batch.events.length;\n    if (committedCountMismatch) {\n      return this.retryable(parsed.batch.batchId, 'renderer trace batch receiver committed a partial batch');\n    }\n    return validated.acknowledgement;\n  }\n\n  private errorMessage(error: unknown): string {\n    return (error instanceof Error ? error.message : String(error)).slice(0, 512);\n  }\n\n  private rejected(batchId: string, reason: string): WoodTraceBatchAcknowledgement {\n    return Object.freeze({ kind: 'rejected', batchId, reason });\n  }\n\n  private retryable(batchId: string, reason: string): WoodTraceBatchAcknowledgement {\n    return Object.freeze({\n      kind: 'retryable',\n      batchId,\n      reason,\n      retryAfterMs: RECEIVER_RETRY_MS,\n    });\n  }\n}\n"],"mappings":"AAAA,SAAS,8BAA8B;AAOvC,MAAM,oBAAoB;AAEnB,MAAM,uBAAuB;AAAA,EAGlC,YAA6B,UAAyC;AAAzC;AAF7B,SAAiB,WAAW,IAAI,uBAAuB;AAAA,EAEgB;AAAA,EAEvE,MAAM,QACJ,OACA,SACwC;AACxC,UAAM,SAAS,KAAK,SAAS,MAAM,KAAK;AACxC,QAAI,OAAO,SAAS,aAAa;AAC/B,aAAO,KAAK,SAAS,WAAW,mCAAmC;AAAA,IACrE;AACA,QAAI,OAAO,SAAS,WAAW;AAC7B,aAAO,KAAK,SAAS,OAAO,WAAW,WAAW,OAAO,MAAM;AAAA,IACjE;AACA,QAAI,CAAC,KAAK,UAAU;AAClB,aAAO,KAAK;AAAA,QACV,OAAO,MAAM;AAAA,QACb;AAAA,MACF;AAAA,IACF;AAEA,QAAI;AACJ,QAAI;AACF,wBAAkB,MAAM,KAAK,SAAS,OAAO,OAAO,OAAO;AAAA,IAC7D,SAAS,OAAO;AACd,aAAO,KAAK,UAAU,OAAO,MAAM,SAAS,KAAK,aAAa,KAAK,CAAC;AAAA,IACtE;AAEA,UAAM,YAAY,KAAK,SAAS,qBAAqB,eAAe;AACpE,QAAI,CAAC,UAAU,MAAM,UAAU,gBAAgB,YAAY,OAAO,MAAM,SAAS;AAC/E,aAAO,KAAK,UAAU,OAAO,MAAM,SAAS,mEAAmE;AAAA,IACjH;AACA,UAAM,yBAAyB,UAAU,gBAAgB,SAAS,eAC7D,UAAU,gBAAgB,mBAAmB,OAAO,MAAM,OAAO;AACtE,QAAI,wBAAwB;AAC1B,aAAO,KAAK,UAAU,OAAO,MAAM,SAAS,yDAAyD;AAAA,IACvG;AACA,WAAO,UAAU;AAAA,EACnB;AAAA,EAEQ,aAAa,OAAwB;AAC3C,YAAQ,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,GAAG,MAAM,GAAG,GAAG;AAAA,EAC9E;AAAA,EAEQ,SAAS,SAAiB,QAA+C;AAC/E,WAAO,OAAO,OAAO,EAAE,MAAM,YAAY,SAAS,OAAO,CAAC;AAAA,EAC5D;AAAA,EAEQ,UAAU,SAAiB,QAA+C;AAChF,WAAO,OAAO,OAAO;AAAA,MACnB,MAAM;AAAA,MACN;AAAA,MACA;AAAA,MACA,cAAc;AAAA,IAChB,CAAC;AAAA,EACH;AACF;","names":[]}