@noego/wood 0.0.4 → 0.1.1

package/dist/testing/create_controller_harness.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/testing/create_controller_harness.ts"],"sourcesContent":["import { readFileSync } from 'node:fs';\nimport {\n  App,\n  clearClientAppForTests,\n  clearClientContainerForTests,\n  clearClientLoggersForTests,\n  clearClientNavigationForTests,\n  clearClientWindowControlsForTests,\n  getApp,\n  getWindowControls,\n  Ipc,\n  WOOD_INTERNAL_BRIDGE_KEY,\n} from '../client/index.js';\nimport { getIpc } from '../ipc/index.js';\nimport { Navigation, getNavigation } from '../navigation/index.js';\nimport { TraceProvider, TraceProviderConfiguration } from '../tracing/index.js';\nimport { parseOperations } from '../parser/operations_parser.cjs';\nimport type { OperationDef } from '../types/operations.cjs';\nimport { createRouterBridge, type RouterBridgeResult } from './create_router_bridge.cjs';\nimport { createTestRouter } from './create_test_router.cjs';\n\nexport interface CreateControllerHarnessOptions<T> {\n  controllerClass: new (...args: any[]) => T;\n  container: any;\n  operations: string | string[];\n  controllersDir: string;\n  middlewareDir?: string;\n  configureContainer?: (container: any) => void | Promise<void>;\n  configureRouter?: (router: ReturnType<typeof createTestRouter>['router']) => void | Promise<void>;\n  prepareClient?: (context: {\n    bridge: Record<string, any>;\n    events: RouterBridgeResult['events'];\n    navigation: Navigation;\n    container: any;\n  }) => void | Promise<void>;\n  initialize?: boolean;\n}\n\nexport interface ControllerHarnessResult<T> extends RouterBridgeResult {\n  controller: T;\n  container: any;\n  router: ReturnType<typeof createTestRouter>['router'];\n  navigation: Navigation;\n  trace: TraceProvider;\n  destroy: () => void;\n}\n\ntype MutableGlobal = typeof globalThis & {\n  [WOOD_INTERNAL_BRIDGE_KEY]?: unknown;\n  wood?: unknown;\n};\n\nfunction readOperations(input: string): Map<string, OperationDef> {\n  if (input.includes('\\n') || input.includes(':')) {\n    return parseOperations(input);\n  }\n\n  return parseOperations(readFileSync(input, 'utf-8'));\n}\n\nfunction mergeOperations(inputs: string | string[]): Map<string, OperationDef> {\n  const merged = new Map<string, OperationDef>();\n\n  for (const input of Array.isArray(inputs) ? inputs : [inputs]) {\n    for (const [channel, operation] of readOperations(input)) {\n      merged.set(channel, operation);\n    }\n  }\n\n  return merged;\n}\n\nfunction createRpcManifest(operations: Map<string, OperationDef>) {\n  return Array.from(operations.values()).map((operation) => ({\n    channel: operation.channel,\n    controller: operation.controller,\n    action: operation.action,\n    path: operation.channel.split('.'),\n    hasInput: !!operation.inputSchema,\n  }));\n}\n\nfunction registerClientBuiltins(container: any): void {\n  if (typeof container.registerFunction !== 'function') {\n    return;\n  }\n\n  const traceConfiguration = new TraceProviderConfiguration();\n  traceConfiguration.configureMode('test');\n  traceConfiguration.configureRuntime('renderer');\n\n  container.registerFunction(Navigation, () => getNavigation());\n  container.registerFunction(App, () => getApp());\n  container.registerFunction(Ipc, () => getIpc());\n  container.registerFunction(WindowControls, () => getWindowControls());\n  container.registerFunction(TraceProviderConfiguration, () => traceConfiguration);\n}\n\nclass WindowControls {\n  async open(_windowId: string, _options?: Record<string, unknown>): Promise<void> {}\n  async close(_windowId?: string): Promise<void> {}\n  async focus(_windowId: string): Promise<void> {}\n  async minimize(_windowId?: string): Promise<void> {}\n  async maximize(_windowId?: string): Promise<void> {}\n}\n\nexport async function createControllerHarness<T>(\n  options: CreateControllerHarnessOptions<T>,\n): Promise<ControllerHarnessResult<T>> {\n  await options.configureContainer?.(options.container);\n\n  if (typeof options.container.instance === 'function') {\n    const rootTraceConfiguration = await options.container.instance(TraceProviderConfiguration);\n    rootTraceConfiguration.configureMode('test');\n    rootTraceConfiguration.configureRuntime('main');\n  }\n\n  const operations = mergeOperations(options.operations);\n  const { router } = createTestRouter('', {\n    container: options.container,\n    controllersDir: options.controllersDir,\n    middlewareDir: options.middlewareDir,\n  });\n  router.loadOperations(operations);\n  await options.configureRouter?.(router);\n\n  const { bridge, events } = createRouterBridge(router);\n  const harnessBridge = Object.assign(bridge, {\n    __rpcManifest: createRpcManifest(operations),\n  });\n\n  const globalObj = globalThis as MutableGlobal;\n  const previousInternalBridge = globalObj[WOOD_INTERNAL_BRIDGE_KEY];\n  const previousWoodBridge = globalObj.wood;\n  globalObj[WOOD_INTERNAL_BRIDGE_KEY] = harnessBridge;\n  globalObj.wood = harnessBridge;\n\n  clearClientContainerForTests();\n  clearClientAppForTests();\n  clearClientNavigationForTests();\n  clearClientWindowControlsForTests();\n  clearClientLoggersForTests();\n\n  const scopedContainer = options.container.extend();\n  registerClientBuiltins(scopedContainer);\n  if (typeof scopedContainer.registerClass === 'function') {\n    scopedContainer.registerClass(options.controllerClass);\n  }\n  const navigation = getNavigation();\n  await options.prepareClient?.({\n    bridge: harnessBridge,\n    events,\n    navigation,\n    container: scopedContainer,\n  });\n\n  const controller = await scopedContainer.instance(options.controllerClass);\n  const trace = await scopedContainer.instance(TraceProvider);\n  if (options.initialize && typeof (controller as { initialize?: () => void }).initialize === 'function') {\n    await Promise.resolve(\n      (controller as { initialize: () => void | Promise<void> }).initialize(),\n    );\n  }\n\n  trace.info({\n    source: 'wood.testing.controller-harness',\n    type: 'harness.created',\n    payload: {\n      controllerClass: options.controllerClass.name,\n    },\n  });\n\n  return {\n    controller,\n    bridge: harnessBridge,\n    events,\n    router,\n    container: scopedContainer,\n    navigation,\n    trace,\n    destroy: () => {\n      trace.info({\n        source: 'wood.testing.controller-harness',\n        type: 'harness.destroyed',\n      });\n      if (typeof (controller as { destroy?: () => void }).destroy === 'function') {\n        (controller as { destroy: () => void }).destroy();\n      }\n      events.clear();\n      clearClientContainerForTests();\n      clearClientAppForTests();\n      clearClientNavigationForTests();\n      clearClientWindowControlsForTests();\n      clearClientLoggersForTests();\n\n      if (previousInternalBridge === undefined) {\n        delete globalObj[WOOD_INTERNAL_BRIDGE_KEY];\n      } else {\n        globalObj[WOOD_INTERNAL_BRIDGE_KEY] = previousInternalBridge;\n      }\n\n      if (previousWoodBridge === undefined) {\n        delete globalObj.wood;\n      } else {\n        globalObj.wood = previousWoodBridge;\n      }\n    },\n  };\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/testing/create_controller_harness.ts"],"sourcesContent":["import { readFileSync } from 'node:fs';\nimport {\n  App,\n  clearClientAppForTests,\n  clearClientContainerForTests,\n  clearClientLoggersForTests,\n  clearClientNavigationForTests,\n  clearClientWindowControlsForTests,\n  getApp,\n  getWindowControls,\n  Ipc,\n  WOOD_INTERNAL_BRIDGE_KEY,\n} from '../client/index.js';\nimport { getIpc } from '../ipc/index.js';\nimport { Navigation, getNavigation } from '../navigation/index.js';\nimport { TraceProvider, TraceProviderConfiguration } from '../tracing/index.js';\nimport { parseOperations } from '../parser/operations_parser.cjs';\nimport type { OperationDef } from '../types/operations.cjs';\nimport { disposeControllerLifecycle } from '../controller/controller_lifecycle.cjs';\nimport { createRouterBridge, type RouterBridgeResult } from './create_router_bridge.cjs';\nimport { createTestRouter } from './create_test_router.cjs';\n\nexport interface CreateControllerHarnessOptions<T> {\n  controllerClass: new (...args: any[]) => T;\n  container: any;\n  operations: string | string[];\n  controllersDir: string;\n  middlewareDir?: string;\n  configureContainer?: (container: any) => void | Promise<void>;\n  configureRouter?: (router: ReturnType<typeof createTestRouter>['router']) => void | Promise<void>;\n  prepareClient?: (context: {\n    bridge: Record<string, any>;\n    events: RouterBridgeResult['events'];\n    navigation: Navigation;\n    container: any;\n  }) => void | Promise<void>;\n  initialize?: boolean;\n}\n\nexport interface ControllerHarnessResult<T> extends RouterBridgeResult {\n  controller: T;\n  container: any;\n  router: ReturnType<typeof createTestRouter>['router'];\n  navigation: Navigation;\n  trace: TraceProvider;\n  destroy: () => void | Promise<void>;\n}\n\ntype MutableGlobal = typeof globalThis & {\n  [WOOD_INTERNAL_BRIDGE_KEY]?: unknown;\n  wood?: unknown;\n};\n\nfunction readOperations(input: string): Map<string, OperationDef> {\n  if (input.includes('\\n') || input.includes(':')) {\n    return parseOperations(input);\n  }\n\n  return parseOperations(readFileSync(input, 'utf-8'));\n}\n\nfunction mergeOperations(inputs: string | string[]): Map<string, OperationDef> {\n  const merged = new Map<string, OperationDef>();\n\n  for (const input of Array.isArray(inputs) ? inputs : [inputs]) {\n    for (const [channel, operation] of readOperations(input)) {\n      merged.set(channel, operation);\n    }\n  }\n\n  return merged;\n}\n\nfunction createRpcManifest(operations: Map<string, OperationDef>) {\n  return Array.from(operations.values()).map((operation) => ({\n    channel: operation.channel,\n    controller: operation.controller,\n    action: operation.action,\n    path: operation.channel.split('.'),\n    hasInput: !!operation.inputSchema,\n  }));\n}\n\nfunction registerClientBuiltins(container: any): void {\n  if (typeof container.registerFunction !== 'function') {\n    return;\n  }\n\n  const traceConfiguration = new TraceProviderConfiguration();\n  traceConfiguration.configureMode('test');\n  traceConfiguration.configureRuntime('renderer');\n  traceConfiguration.configureEnabled(true);\n\n  container.registerFunction(Navigation, () => getNavigation());\n  container.registerFunction(App, () => getApp());\n  container.registerFunction(Ipc, () => getIpc());\n  container.registerFunction(WindowControls, () => getWindowControls());\n  container.registerFunction(TraceProviderConfiguration, () => traceConfiguration);\n}\n\nclass WindowControls {\n  async open(_windowId: string, _options?: Record<string, unknown>): Promise<void> {}\n  async close(_windowId?: string): Promise<void> {}\n  async focus(_windowId: string): Promise<void> {}\n  async minimize(_windowId?: string): Promise<void> {}\n  async maximize(_windowId?: string): Promise<void> {}\n}\n\nexport async function createControllerHarness<T>(\n  options: CreateControllerHarnessOptions<T>,\n): Promise<ControllerHarnessResult<T>> {\n  await options.configureContainer?.(options.container);\n\n  if (typeof options.container.instance === 'function') {\n    const rootTraceConfiguration = await options.container.instance(TraceProviderConfiguration);\n    rootTraceConfiguration.configureMode('test');\n    rootTraceConfiguration.configureRuntime('main');\n  }\n\n  const operations = mergeOperations(options.operations);\n  const { router } = createTestRouter('', {\n    container: options.container,\n    controllersDir: options.controllersDir,\n    middlewareDir: options.middlewareDir,\n  });\n  router.loadOperations(operations);\n  await options.configureRouter?.(router);\n\n  const { bridge, events } = createRouterBridge(router);\n  const harnessBridge = Object.assign(bridge, {\n    __rpcManifest: createRpcManifest(operations),\n  });\n\n  const globalObj = globalThis as MutableGlobal;\n  const previousInternalBridge = globalObj[WOOD_INTERNAL_BRIDGE_KEY];\n  const previousWoodBridge = globalObj.wood;\n  globalObj[WOOD_INTERNAL_BRIDGE_KEY] = harnessBridge;\n  globalObj.wood = harnessBridge;\n\n  clearClientContainerForTests();\n  clearClientAppForTests();\n  clearClientNavigationForTests();\n  clearClientWindowControlsForTests();\n  clearClientLoggersForTests();\n\n  const scopedContainer = options.container.extend();\n  registerClientBuiltins(scopedContainer);\n  if (typeof scopedContainer.registerClass === 'function') {\n    scopedContainer.registerClass(options.controllerClass);\n  }\n  const navigation = getNavigation();\n  await options.prepareClient?.({\n    bridge: harnessBridge,\n    events,\n    navigation,\n    container: scopedContainer,\n  });\n\n  const controller = await scopedContainer.instance(options.controllerClass);\n  const trace = await scopedContainer.instance(TraceProvider);\n  if (options.initialize && typeof (controller as { initialize?: () => void }).initialize === 'function') {\n    await Promise.resolve(\n      (controller as { initialize: () => void | Promise<void> }).initialize(),\n    );\n  }\n\n  trace.info({\n    source: 'wood.testing.controller-harness',\n    type: 'harness.created',\n    payload: {\n      controllerClass: options.controllerClass.name,\n    },\n  });\n\n  return {\n    controller,\n    bridge: harnessBridge,\n    events,\n    router,\n    container: scopedContainer,\n    navigation,\n    trace,\n    destroy: async () => {\n      trace.info({\n        source: 'wood.testing.controller-harness',\n        type: 'harness.destroyed',\n      });\n      await disposeControllerLifecycle(controller);\n      events.clear();\n      clearClientContainerForTests();\n      clearClientAppForTests();\n      clearClientNavigationForTests();\n      clearClientWindowControlsForTests();\n      clearClientLoggersForTests();\n\n      if (previousInternalBridge === undefined) {\n        delete globalObj[WOOD_INTERNAL_BRIDGE_KEY];\n      } else {\n        globalObj[WOOD_INTERNAL_BRIDGE_KEY] = previousInternalBridge;\n      }\n\n      if (previousWoodBridge === undefined) {\n        delete globalObj.wood;\n      } else {\n        globalObj.wood = previousWoodBridge;\n      }\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,qBAA6B;AAC7B,oBAWO;AACP,iBAAuB;AACvB,wBAA0C;AAC1C,qBAA0D;AAC1D,+BAAgC;AAEhC,kCAA2C;AAC3C,kCAA4D;AAC5D,gCAAiC;AAiCjC,SAAS,eAAe,OAA0C;AAChE,MAAI,MAAM,SAAS,IAAI,KAAK,MAAM,SAAS,GAAG,GAAG;AAC/C,eAAO,0CAAgB,KAAK;AAAA,EAC9B;AAEA,aAAO,8CAAgB,6BAAa,OAAO,OAAO,CAAC;AACrD;AAEA,SAAS,gBAAgB,QAAsD;AAC7E,QAAM,SAAS,oBAAI,IAA0B;AAE7C,aAAW,SAAS,MAAM,QAAQ,MAAM,IAAI,SAAS,CAAC,MAAM,GAAG;AAC7D,eAAW,CAAC,SAAS,SAAS,KAAK,eAAe,KAAK,GAAG;AACxD,aAAO,IAAI,SAAS,SAAS;AAAA,IAC/B;AAAA,EACF;AAEA,SAAO;AACT;AAEA,SAAS,kBAAkB,YAAuC;AAChE,SAAO,MAAM,KAAK,WAAW,OAAO,CAAC,EAAE,IAAI,CAAC,eAAe;AAAA,IACzD,SAAS,UAAU;AAAA,IACnB,YAAY,UAAU;AAAA,IACtB,QAAQ,UAAU;AAAA,IAClB,MAAM,UAAU,QAAQ,MAAM,GAAG;AAAA,IACjC,UAAU,CAAC,CAAC,UAAU;AAAA,EACxB,EAAE;AACJ;AAEA,SAAS,uBAAuB,WAAsB;AACpD,MAAI,OAAO,UAAU,qBAAqB,YAAY;AACpD;AAAA,EACF;AAEA,QAAM,qBAAqB,IAAI,0CAA2B;AAC1D,qBAAmB,cAAc,MAAM;AACvC,qBAAmB,iBAAiB,UAAU;AAC9C,qBAAmB,iBAAiB,IAAI;AAExC,YAAU,iBAAiB,8BAAY,UAAM,iCAAc,CAAC;AAC5D,YAAU,iBAAiB,mBAAK,UAAM,sBAAO,CAAC;AAC9C,YAAU,iBAAiB,mBAAK,UAAM,mBAAO,CAAC;AAC9C,YAAU,iBAAiB,gBAAgB,UAAM,iCAAkB,CAAC;AACpE,YAAU,iBAAiB,2CAA4B,MAAM,kBAAkB;AACjF;AAEA,MAAM,eAAe;AAAA,EACnB,MAAM,KAAK,WAAmB,UAAmD;AAAA,EAAC;AAAA,EAClF,MAAM,MAAM,WAAmC;AAAA,EAAC;AAAA,EAChD,MAAM,MAAM,WAAkC;AAAA,EAAC;AAAA,EAC/C,MAAM,SAAS,WAAmC;AAAA,EAAC;AAAA,EACnD,MAAM,SAAS,WAAmC;AAAA,EAAC;AACrD;AAEA,eAAsB,wBACpB,SACqC;AACrC,QAAM,QAAQ,qBAAqB,QAAQ,SAAS;AAEpD,MAAI,OAAO,QAAQ,UAAU,aAAa,YAAY;AACpD,UAAM,yBAAyB,MAAM,QAAQ,UAAU,SAAS,yCAA0B;AAC1F,2BAAuB,cAAc,MAAM;AAC3C,2BAAuB,iBAAiB,MAAM;AAAA,EAChD;AAEA,QAAM,aAAa,gBAAgB,QAAQ,UAAU;AACrD,QAAM,EAAE,OAAO,QAAI,4CAAiB,IAAI;AAAA,IACtC,WAAW,QAAQ;AAAA,IACnB,gBAAgB,QAAQ;AAAA,IACxB,eAAe,QAAQ;AAAA,EACzB,CAAC;AACD,SAAO,eAAe,UAAU;AAChC,QAAM,QAAQ,kBAAkB,MAAM;AAEtC,QAAM,EAAE,QAAQ,OAAO,QAAI,gDAAmB,MAAM;AACpD,QAAM,gBAAgB,OAAO,OAAO,QAAQ;AAAA,IAC1C,eAAe,kBAAkB,UAAU;AAAA,EAC7C,CAAC;AAED,QAAM,YAAY;AAClB,QAAM,yBAAyB,UAAU,sCAAwB;AACjE,QAAM,qBAAqB,UAAU;AACrC,YAAU,sCAAwB,IAAI;AACtC,YAAU,OAAO;AAEjB,kDAA6B;AAC7B,4CAAuB;AACvB,mDAA8B;AAC9B,uDAAkC;AAClC,gDAA2B;AAE3B,QAAM,kBAAkB,QAAQ,UAAU,OAAO;AACjD,yBAAuB,eAAe;AACtC,MAAI,OAAO,gBAAgB,kBAAkB,YAAY;AACvD,oBAAgB,cAAc,QAAQ,eAAe;AAAA,EACvD;AACA,QAAM,iBAAa,iCAAc;AACjC,QAAM,QAAQ,gBAAgB;AAAA,IAC5B,QAAQ;AAAA,IACR;AAAA,IACA;AAAA,IACA,WAAW;AAAA,EACb,CAAC;AAED,QAAM,aAAa,MAAM,gBAAgB,SAAS,QAAQ,eAAe;AACzE,QAAM,QAAQ,MAAM,gBAAgB,SAAS,4BAAa;AAC1D,MAAI,QAAQ,cAAc,OAAQ,WAA2C,eAAe,YAAY;AACtG,UAAM,QAAQ;AAAA,MACX,WAA0D,WAAW;AAAA,IACxE;AAAA,EACF;AAEA,QAAM,KAAK;AAAA,IACT,QAAQ;AAAA,IACR,MAAM;AAAA,IACN,SAAS;AAAA,MACP,iBAAiB,QAAQ,gBAAgB;AAAA,IAC3C;AAAA,EACF,CAAC;AAED,SAAO;AAAA,IACL;AAAA,IACA,QAAQ;AAAA,IACR;AAAA,IACA;AAAA,IACA,WAAW;AAAA,IACX;AAAA,IACA;AAAA,IACA,SAAS,YAAY;AACnB,YAAM,KAAK;AAAA,QACT,QAAQ;AAAA,QACR,MAAM;AAAA,MACR,CAAC;AACD,gBAAM,wDAA2B,UAAU;AAC3C,aAAO,MAAM;AACb,sDAA6B;AAC7B,gDAAuB;AACvB,uDAA8B;AAC9B,2DAAkC;AAClC,oDAA2B;AAE3B,UAAI,2BAA2B,QAAW;AACxC,eAAO,UAAU,sCAAwB;AAAA,MAC3C,OAAO;AACL,kBAAU,sCAAwB,IAAI;AAAA,MACxC;AAEA,UAAI,uBAAuB,QAAW;AACpC,eAAO,UAAU;AAAA,MACnB,OAAO;AACL,kBAAU,OAAO;AAAA,MACnB;AAAA,IACF;AAAA,EACF;AACF;","names":[]}

package/dist/testing/create_controller_harness.d.cts

@@ -30,7 +30,7 @@ interface ControllerHarnessResult<T> extends RouterBridgeResult {
     router: ReturnType<typeof createTestRouter>['router'];
     navigation: Navigation;
     trace: TraceProvider;
-    destroy: () => void;
+    destroy: () => void | Promise<void>;
 }
 declare function createControllerHarness<T>(options: CreateControllerHarnessOptions<T>): Promise<ControllerHarnessResult<T>>;
 

package/dist/testing/create_controller_harness.d.ts

@@ -30,7 +30,7 @@ interface ControllerHarnessResult<T> extends RouterBridgeResult {
     router: ReturnType<typeof createTestRouter>['router'];
     navigation: Navigation;
     trace: TraceProvider;
-    destroy: () => void;
+    destroy: () => void | Promise<void>;
 }
 declare function createControllerHarness<T>(options: CreateControllerHarnessOptions<T>): Promise<ControllerHarnessResult<T>>;
 

package/dist/testing/create_controller_harness.js

@@ -15,6 +15,7 @@ import { getIpc } from "../ipc/index.js";
 import { Navigation, getNavigation } from "../navigation/index.js";
 import { TraceProvider, TraceProviderConfiguration } from "../tracing/index.js";
 import { parseOperations } from "../parser/operations_parser.js";
+import { disposeControllerLifecycle } from "../controller/controller_lifecycle.js";
 import { createRouterBridge } from "./create_router_bridge.js";
 import { createTestRouter } from "./create_test_router.js";
 function readOperations(input) {
@@ -48,6 +49,7 @@ function registerClientBuiltins(container) {
   const traceConfiguration = new TraceProviderConfiguration();
   traceConfiguration.configureMode("test");
   traceConfiguration.configureRuntime("renderer");
+  traceConfiguration.configureEnabled(true);
   container.registerFunction(Navigation, () => getNavigation());
   container.registerFunction(App, () => getApp());
   container.registerFunction(Ipc, () => getIpc());
@@ -129,14 +131,12 @@ async function createControllerHarness(options) {
     container: scopedContainer,
     navigation,
     trace,
-    destroy: () => {
+    destroy: async () => {
       trace.info({
         source: "wood.testing.controller-harness",
         type: "harness.destroyed"
       });
-      if (typeof controller.destroy === "function") {
-        controller.destroy();
-      }
+      await disposeControllerLifecycle(controller);
       events.clear();
       clearClientContainerForTests();
       clearClientAppForTests();

package/dist/testing/create_controller_harness.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/testing/create_controller_harness.ts"],"sourcesContent":["import { readFileSync } from 'node:fs';\nimport {\n  App,\n  clearClientAppForTests,\n  clearClientContainerForTests,\n  clearClientLoggersForTests,\n  clearClientNavigationForTests,\n  clearClientWindowControlsForTests,\n  getApp,\n  getWindowControls,\n  Ipc,\n  WOOD_INTERNAL_BRIDGE_KEY,\n} from '../client/index.js';\nimport { getIpc } from '../ipc/index.js';\nimport { Navigation, getNavigation } from '../navigation/index.js';\nimport { TraceProvider, TraceProviderConfiguration } from '../tracing/index.js';\nimport { parseOperations } from '../parser/operations_parser.js';\nimport type { OperationDef } from '../types/operations.js';\nimport { createRouterBridge, type RouterBridgeResult } from './create_router_bridge.js';\nimport { createTestRouter } from './create_test_router.js';\n\nexport interface CreateControllerHarnessOptions<T> {\n  controllerClass: new (...args: any[]) => T;\n  container: any;\n  operations: string | string[];\n  controllersDir: string;\n  middlewareDir?: string;\n  configureContainer?: (container: any) => void | Promise<void>;\n  configureRouter?: (router: ReturnType<typeof createTestRouter>['router']) => void | Promise<void>;\n  prepareClient?: (context: {\n    bridge: Record<string, any>;\n    events: RouterBridgeResult['events'];\n    navigation: Navigation;\n    container: any;\n  }) => void | Promise<void>;\n  initialize?: boolean;\n}\n\nexport interface ControllerHarnessResult<T> extends RouterBridgeResult {\n  controller: T;\n  container: any;\n  router: ReturnType<typeof createTestRouter>['router'];\n  navigation: Navigation;\n  trace: TraceProvider;\n  destroy: () => void;\n}\n\ntype MutableGlobal = typeof globalThis & {\n  [WOOD_INTERNAL_BRIDGE_KEY]?: unknown;\n  wood?: unknown;\n};\n\nfunction readOperations(input: string): Map<string, OperationDef> {\n  if (input.includes('\\n') || input.includes(':')) {\n    return parseOperations(input);\n  }\n\n  return parseOperations(readFileSync(input, 'utf-8'));\n}\n\nfunction mergeOperations(inputs: string | string[]): Map<string, OperationDef> {\n  const merged = new Map<string, OperationDef>();\n\n  for (const input of Array.isArray(inputs) ? inputs : [inputs]) {\n    for (const [channel, operation] of readOperations(input)) {\n      merged.set(channel, operation);\n    }\n  }\n\n  return merged;\n}\n\nfunction createRpcManifest(operations: Map<string, OperationDef>) {\n  return Array.from(operations.values()).map((operation) => ({\n    channel: operation.channel,\n    controller: operation.controller,\n    action: operation.action,\n    path: operation.channel.split('.'),\n    hasInput: !!operation.inputSchema,\n  }));\n}\n\nfunction registerClientBuiltins(container: any): void {\n  if (typeof container.registerFunction !== 'function') {\n    return;\n  }\n\n  const traceConfiguration = new TraceProviderConfiguration();\n  traceConfiguration.configureMode('test');\n  traceConfiguration.configureRuntime('renderer');\n\n  container.registerFunction(Navigation, () => getNavigation());\n  container.registerFunction(App, () => getApp());\n  container.registerFunction(Ipc, () => getIpc());\n  container.registerFunction(WindowControls, () => getWindowControls());\n  container.registerFunction(TraceProviderConfiguration, () => traceConfiguration);\n}\n\nclass WindowControls {\n  async open(_windowId: string, _options?: Record<string, unknown>): Promise<void> {}\n  async close(_windowId?: string): Promise<void> {}\n  async focus(_windowId: string): Promise<void> {}\n  async minimize(_windowId?: string): Promise<void> {}\n  async maximize(_windowId?: string): Promise<void> {}\n}\n\nexport async function createControllerHarness<T>(\n  options: CreateControllerHarnessOptions<T>,\n): Promise<ControllerHarnessResult<T>> {\n  await options.configureContainer?.(options.container);\n\n  if (typeof options.container.instance === 'function') {\n    const rootTraceConfiguration = await options.container.instance(TraceProviderConfiguration);\n    rootTraceConfiguration.configureMode('test');\n    rootTraceConfiguration.configureRuntime('main');\n  }\n\n  const operations = mergeOperations(options.operations);\n  const { router } = createTestRouter('', {\n    container: options.container,\n    controllersDir: options.controllersDir,\n    middlewareDir: options.middlewareDir,\n  });\n  router.loadOperations(operations);\n  await options.configureRouter?.(router);\n\n  const { bridge, events } = createRouterBridge(router);\n  const harnessBridge = Object.assign(bridge, {\n    __rpcManifest: createRpcManifest(operations),\n  });\n\n  const globalObj = globalThis as MutableGlobal;\n  const previousInternalBridge = globalObj[WOOD_INTERNAL_BRIDGE_KEY];\n  const previousWoodBridge = globalObj.wood;\n  globalObj[WOOD_INTERNAL_BRIDGE_KEY] = harnessBridge;\n  globalObj.wood = harnessBridge;\n\n  clearClientContainerForTests();\n  clearClientAppForTests();\n  clearClientNavigationForTests();\n  clearClientWindowControlsForTests();\n  clearClientLoggersForTests();\n\n  const scopedContainer = options.container.extend();\n  registerClientBuiltins(scopedContainer);\n  if (typeof scopedContainer.registerClass === 'function') {\n    scopedContainer.registerClass(options.controllerClass);\n  }\n  const navigation = getNavigation();\n  await options.prepareClient?.({\n    bridge: harnessBridge,\n    events,\n    navigation,\n    container: scopedContainer,\n  });\n\n  const controller = await scopedContainer.instance(options.controllerClass);\n  const trace = await scopedContainer.instance(TraceProvider);\n  if (options.initialize && typeof (controller as { initialize?: () => void }).initialize === 'function') {\n    await Promise.resolve(\n      (controller as { initialize: () => void | Promise<void> }).initialize(),\n    );\n  }\n\n  trace.info({\n    source: 'wood.testing.controller-harness',\n    type: 'harness.created',\n    payload: {\n      controllerClass: options.controllerClass.name,\n    },\n  });\n\n  return {\n    controller,\n    bridge: harnessBridge,\n    events,\n    router,\n    container: scopedContainer,\n    navigation,\n    trace,\n    destroy: () => {\n      trace.info({\n        source: 'wood.testing.controller-harness',\n        type: 'harness.destroyed',\n      });\n      if (typeof (controller as { destroy?: () => void }).destroy === 'function') {\n        (controller as { destroy: () => void }).destroy();\n      }\n      events.clear();\n      clearClientContainerForTests();\n      clearClientAppForTests();\n      clearClientNavigationForTests();\n      clearClientWindowControlsForTests();\n      clearClientLoggersForTests();\n\n      if (previousInternalBridge === undefined) {\n        delete globalObj[WOOD_INTERNAL_BRIDGE_KEY];\n      } else {\n        globalObj[WOOD_INTERNAL_BRIDGE_KEY] = previousInternalBridge;\n      }\n\n      if (previousWoodBridge === undefined) {\n        delete globalObj.wood;\n      } else {\n        globalObj.wood = previousWoodBridge;\n      }\n    },\n  };\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/testing/create_controller_harness.ts"],"sourcesContent":["import { readFileSync } from 'node:fs';\nimport {\n  App,\n  clearClientAppForTests,\n  clearClientContainerForTests,\n  clearClientLoggersForTests,\n  clearClientNavigationForTests,\n  clearClientWindowControlsForTests,\n  getApp,\n  getWindowControls,\n  Ipc,\n  WOOD_INTERNAL_BRIDGE_KEY,\n} from '../client/index.js';\nimport { getIpc } from '../ipc/index.js';\nimport { Navigation, getNavigation } from '../navigation/index.js';\nimport { TraceProvider, TraceProviderConfiguration } from '../tracing/index.js';\nimport { parseOperations } from '../parser/operations_parser.js';\nimport type { OperationDef } from '../types/operations.js';\nimport { disposeControllerLifecycle } from '../controller/controller_lifecycle.js';\nimport { createRouterBridge, type RouterBridgeResult } from './create_router_bridge.js';\nimport { createTestRouter } from './create_test_router.js';\n\nexport interface CreateControllerHarnessOptions<T> {\n  controllerClass: new (...args: any[]) => T;\n  container: any;\n  operations: string | string[];\n  controllersDir: string;\n  middlewareDir?: string;\n  configureContainer?: (container: any) => void | Promise<void>;\n  configureRouter?: (router: ReturnType<typeof createTestRouter>['router']) => void | Promise<void>;\n  prepareClient?: (context: {\n    bridge: Record<string, any>;\n    events: RouterBridgeResult['events'];\n    navigation: Navigation;\n    container: any;\n  }) => void | Promise<void>;\n  initialize?: boolean;\n}\n\nexport interface ControllerHarnessResult<T> extends RouterBridgeResult {\n  controller: T;\n  container: any;\n  router: ReturnType<typeof createTestRouter>['router'];\n  navigation: Navigation;\n  trace: TraceProvider;\n  destroy: () => void | Promise<void>;\n}\n\ntype MutableGlobal = typeof globalThis & {\n  [WOOD_INTERNAL_BRIDGE_KEY]?: unknown;\n  wood?: unknown;\n};\n\nfunction readOperations(input: string): Map<string, OperationDef> {\n  if (input.includes('\\n') || input.includes(':')) {\n    return parseOperations(input);\n  }\n\n  return parseOperations(readFileSync(input, 'utf-8'));\n}\n\nfunction mergeOperations(inputs: string | string[]): Map<string, OperationDef> {\n  const merged = new Map<string, OperationDef>();\n\n  for (const input of Array.isArray(inputs) ? inputs : [inputs]) {\n    for (const [channel, operation] of readOperations(input)) {\n      merged.set(channel, operation);\n    }\n  }\n\n  return merged;\n}\n\nfunction createRpcManifest(operations: Map<string, OperationDef>) {\n  return Array.from(operations.values()).map((operation) => ({\n    channel: operation.channel,\n    controller: operation.controller,\n    action: operation.action,\n    path: operation.channel.split('.'),\n    hasInput: !!operation.inputSchema,\n  }));\n}\n\nfunction registerClientBuiltins(container: any): void {\n  if (typeof container.registerFunction !== 'function') {\n    return;\n  }\n\n  const traceConfiguration = new TraceProviderConfiguration();\n  traceConfiguration.configureMode('test');\n  traceConfiguration.configureRuntime('renderer');\n  traceConfiguration.configureEnabled(true);\n\n  container.registerFunction(Navigation, () => getNavigation());\n  container.registerFunction(App, () => getApp());\n  container.registerFunction(Ipc, () => getIpc());\n  container.registerFunction(WindowControls, () => getWindowControls());\n  container.registerFunction(TraceProviderConfiguration, () => traceConfiguration);\n}\n\nclass WindowControls {\n  async open(_windowId: string, _options?: Record<string, unknown>): Promise<void> {}\n  async close(_windowId?: string): Promise<void> {}\n  async focus(_windowId: string): Promise<void> {}\n  async minimize(_windowId?: string): Promise<void> {}\n  async maximize(_windowId?: string): Promise<void> {}\n}\n\nexport async function createControllerHarness<T>(\n  options: CreateControllerHarnessOptions<T>,\n): Promise<ControllerHarnessResult<T>> {\n  await options.configureContainer?.(options.container);\n\n  if (typeof options.container.instance === 'function') {\n    const rootTraceConfiguration = await options.container.instance(TraceProviderConfiguration);\n    rootTraceConfiguration.configureMode('test');\n    rootTraceConfiguration.configureRuntime('main');\n  }\n\n  const operations = mergeOperations(options.operations);\n  const { router } = createTestRouter('', {\n    container: options.container,\n    controllersDir: options.controllersDir,\n    middlewareDir: options.middlewareDir,\n  });\n  router.loadOperations(operations);\n  await options.configureRouter?.(router);\n\n  const { bridge, events } = createRouterBridge(router);\n  const harnessBridge = Object.assign(bridge, {\n    __rpcManifest: createRpcManifest(operations),\n  });\n\n  const globalObj = globalThis as MutableGlobal;\n  const previousInternalBridge = globalObj[WOOD_INTERNAL_BRIDGE_KEY];\n  const previousWoodBridge = globalObj.wood;\n  globalObj[WOOD_INTERNAL_BRIDGE_KEY] = harnessBridge;\n  globalObj.wood = harnessBridge;\n\n  clearClientContainerForTests();\n  clearClientAppForTests();\n  clearClientNavigationForTests();\n  clearClientWindowControlsForTests();\n  clearClientLoggersForTests();\n\n  const scopedContainer = options.container.extend();\n  registerClientBuiltins(scopedContainer);\n  if (typeof scopedContainer.registerClass === 'function') {\n    scopedContainer.registerClass(options.controllerClass);\n  }\n  const navigation = getNavigation();\n  await options.prepareClient?.({\n    bridge: harnessBridge,\n    events,\n    navigation,\n    container: scopedContainer,\n  });\n\n  const controller = await scopedContainer.instance(options.controllerClass);\n  const trace = await scopedContainer.instance(TraceProvider);\n  if (options.initialize && typeof (controller as { initialize?: () => void }).initialize === 'function') {\n    await Promise.resolve(\n      (controller as { initialize: () => void | Promise<void> }).initialize(),\n    );\n  }\n\n  trace.info({\n    source: 'wood.testing.controller-harness',\n    type: 'harness.created',\n    payload: {\n      controllerClass: options.controllerClass.name,\n    },\n  });\n\n  return {\n    controller,\n    bridge: harnessBridge,\n    events,\n    router,\n    container: scopedContainer,\n    navigation,\n    trace,\n    destroy: async () => {\n      trace.info({\n        source: 'wood.testing.controller-harness',\n        type: 'harness.destroyed',\n      });\n      await disposeControllerLifecycle(controller);\n      events.clear();\n      clearClientContainerForTests();\n      clearClientAppForTests();\n      clearClientNavigationForTests();\n      clearClientWindowControlsForTests();\n      clearClientLoggersForTests();\n\n      if (previousInternalBridge === undefined) {\n        delete globalObj[WOOD_INTERNAL_BRIDGE_KEY];\n      } else {\n        globalObj[WOOD_INTERNAL_BRIDGE_KEY] = previousInternalBridge;\n      }\n\n      if (previousWoodBridge === undefined) {\n        delete globalObj.wood;\n      } else {\n        globalObj.wood = previousWoodBridge;\n      }\n    },\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/tracing/index.cjs

@@ -33,7 +33,9 @@ __export(tracing_exports, {
   publishMainTrace: () => import_trace_hub.publishMainTrace,
   publishTestTrace: () => import_trace_hub.publishTestTrace,
   setMainTraceMinLevel: () => import_trace_hub.setMainTraceMinLevel,
-  setRendererTraceMinLevel: () => import_trace_hub.setRendererTraceMinLevel
+  setRendererTraceEnabled: () => import_trace_hub.setRendererTraceEnabled,
+  setRendererTraceMinLevel: () => import_trace_hub.setRendererTraceMinLevel,
+  setRendererTraceTransport: () => import_trace_hub.setRendererTraceTransport
 });
 module.exports = __toCommonJS(tracing_exports);
 var import_trace_hub = require("./trace_hub.js");
@@ -55,6 +57,8 @@ var import_trace_provider = require("./trace_provider.js");
   publishMainTrace,
   publishTestTrace,
   setMainTraceMinLevel,
-  setRendererTraceMinLevel
+  setRendererTraceEnabled,
+  setRendererTraceMinLevel,
+  setRendererTraceTransport
 });
 //# sourceMappingURL=index.cjs.map

package/dist/tracing/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/tracing/index.ts"],"sourcesContent":["export {\n  clearTraceHubForTests,\n  createTraceCapture,\n  dispatchRendererTracePayload,\n  emitRendererTrace,\n  getTraceEvents$,\n  publishMainTrace,\n  publishTestTrace,\n  setMainTraceMinLevel,\n  setRendererTraceMinLevel,\n  TraceCapture,\n  type TraceCaptureOptions,\n  type TraceDispatchResult,\n  type TraceEvent,\n  type TraceInput,\n  type TraceLevel,\n  type TraceProcess,\n  type TraceWaitOptions,\n} from './trace_hub.js';\n\nexport {\n  FrameworkTracer,\n  MainTracer,\n  RendererTracer,\n  TestTracer,\n  TraceProvider,\n  TraceProviderConfiguration,\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,4BASO;","names":[]}
+{"version":3,"sources":["../../src/tracing/index.ts"],"sourcesContent":["export {\n  clearTraceHubForTests,\n  createTraceCapture,\n  dispatchRendererTracePayload,\n  emitRendererTrace,\n  getTraceEvents$,\n  publishMainTrace,\n  publishTestTrace,\n  setMainTraceMinLevel,\n  setRendererTraceEnabled,\n  setRendererTraceMinLevel,\n  setRendererTraceTransport,\n  TraceCapture,\n  type TraceCaptureOptions,\n  type TraceDispatchResult,\n  type TraceEvent,\n  type TraceInput,\n  type TraceLevel,\n  type TraceProcess,\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;AAAA;AAAA,uBAoBO;AAEP,4BAUO;","names":[]}

package/dist/tracing/index.d.cts

@@ -1,4 +1,4 @@
-export { TraceCapture, TraceCaptureOptions, TraceDispatchResult, TraceEvent, TraceInput, TraceLevel, TraceProcess, TraceWaitOptions, clearTraceHubForTests, createTraceCapture, dispatchRendererTracePayload, emitRendererTrace, getTraceEvents$, publishMainTrace, publishTestTrace, setMainTraceMinLevel, setRendererTraceMinLevel } from './trace_hub.cjs';
-export { FrameworkTracer, MainTracer, RendererTracer, TestTracer, TraceProvider, TraceProviderConfiguration, TraceProviderMode, TraceRuntime } from './trace_provider.cjs';
+export { TraceCapture, TraceCaptureOptions, TraceDispatchResult, TraceEvent, TraceInput, TraceLevel, TraceProcess, TraceWaitOptions, clearTraceHubForTests, createTraceCapture, dispatchRendererTracePayload, emitRendererTrace, getTraceEvents$, publishMainTrace, publishTestTrace, setMainTraceMinLevel, setRendererTraceEnabled, setRendererTraceMinLevel, setRendererTraceTransport } from './trace_hub.cjs';
+export { FrameworkTracer, MainTracer, RendererTracer, TestTracer, TraceContext, TraceProvider, TraceProviderConfiguration, TraceProviderMode, TraceRuntime } from './trace_provider.cjs';
 import 'rxjs';
 import '@noego/ioc';

package/dist/tracing/index.d.ts

@@ -1,4 +1,4 @@
-export { TraceCapture, TraceCaptureOptions, TraceDispatchResult, TraceEvent, TraceInput, TraceLevel, TraceProcess, TraceWaitOptions, clearTraceHubForTests, createTraceCapture, dispatchRendererTracePayload, emitRendererTrace, getTraceEvents$, publishMainTrace, publishTestTrace, setMainTraceMinLevel, setRendererTraceMinLevel } from './trace_hub.js';
-export { FrameworkTracer, MainTracer, RendererTracer, TestTracer, TraceProvider, TraceProviderConfiguration, TraceProviderMode, TraceRuntime } from './trace_provider.js';
+export { TraceCapture, TraceCaptureOptions, TraceDispatchResult, TraceEvent, TraceInput, TraceLevel, TraceProcess, TraceWaitOptions, clearTraceHubForTests, createTraceCapture, dispatchRendererTracePayload, emitRendererTrace, getTraceEvents$, publishMainTrace, publishTestTrace, setMainTraceMinLevel, setRendererTraceEnabled, setRendererTraceMinLevel, setRendererTraceTransport } from './trace_hub.js';
+export { FrameworkTracer, MainTracer, RendererTracer, TestTracer, TraceContext, TraceProvider, TraceProviderConfiguration, TraceProviderMode, TraceRuntime } from './trace_provider.js';
 import 'rxjs';
 import '@noego/ioc';

package/dist/tracing/index.js

@@ -7,7 +7,9 @@ import {
   publishMainTrace,
   publishTestTrace,
   setMainTraceMinLevel,
+  setRendererTraceEnabled,
   setRendererTraceMinLevel,
+  setRendererTraceTransport,
   TraceCapture
 } from "./trace_hub.js";
 import {
@@ -34,6 +36,8 @@ export {
   publishMainTrace,
   publishTestTrace,
   setMainTraceMinLevel,
-  setRendererTraceMinLevel
+  setRendererTraceEnabled,
+  setRendererTraceMinLevel,
+  setRendererTraceTransport
 };
 //# sourceMappingURL=index.js.map

package/dist/tracing/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/tracing/index.ts"],"sourcesContent":["export {\n  clearTraceHubForTests,\n  createTraceCapture,\n  dispatchRendererTracePayload,\n  emitRendererTrace,\n  getTraceEvents$,\n  publishMainTrace,\n  publishTestTrace,\n  setMainTraceMinLevel,\n  setRendererTraceMinLevel,\n  TraceCapture,\n  type TraceCaptureOptions,\n  type TraceDispatchResult,\n  type TraceEvent,\n  type TraceInput,\n  type TraceLevel,\n  type TraceProcess,\n  type TraceWaitOptions,\n} from './trace_hub.js';\n\nexport {\n  FrameworkTracer,\n  MainTracer,\n  RendererTracer,\n  TestTracer,\n  TraceProvider,\n  TraceProviderConfiguration,\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,OAGK;","names":[]}
+{"version":3,"sources":["../../src/tracing/index.ts"],"sourcesContent":["export {\n  clearTraceHubForTests,\n  createTraceCapture,\n  dispatchRendererTracePayload,\n  emitRendererTrace,\n  getTraceEvents$,\n  publishMainTrace,\n  publishTestTrace,\n  setMainTraceMinLevel,\n  setRendererTraceEnabled,\n  setRendererTraceMinLevel,\n  setRendererTraceTransport,\n  TraceCapture,\n  type TraceCaptureOptions,\n  type TraceDispatchResult,\n  type TraceEvent,\n  type TraceInput,\n  type TraceLevel,\n  type TraceProcess,\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,EACA;AAAA,EACA;AAAA,OAQK;AAEP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAIK;","names":[]}

package/dist/tracing/trace_hub.cjs

@@ -37,7 +37,9 @@ __export(trace_hub_exports, {
   publishMainTrace: () => publishMainTrace,
   publishTestTrace: () => publishTestTrace,
   setMainTraceMinLevel: () => setMainTraceMinLevel,
-  setRendererTraceMinLevel: () => setRendererTraceMinLevel
+  setRendererTraceEnabled: () => setRendererTraceEnabled,
+  setRendererTraceMinLevel: () => setRendererTraceMinLevel,
+  setRendererTraceTransport: () => setRendererTraceTransport
 });
 module.exports = __toCommonJS(trace_hub_exports);
 var import_rxjs = require("rxjs");
@@ -50,6 +52,8 @@ const LEVEL_ORDER = {
   error: 3
 };
 let rendererMinLevel = "debug";
+let rendererEnabled = false;
+let customRendererTraceTransport = null;
 function normalizeTraceInput(raw) {
   const input = raw ?? {};
   const source = typeof input.source === "string" && input.source.trim().length > 0 ? input.source : "unknown";
@@ -145,13 +149,17 @@ class TraceHub {
     this.subject = new import_rxjs.Subject();
     this.shared$ = this.subject.asObservable().pipe((0, import_operators.share)());
     this.nextTraceSeq = 1;
-    this.minLevel = "debug";
+    this.minLevels = {
+      main: "debug",
+      renderer: "debug",
+      test: "debug"
+    };
   }
   get events$() {
     return this.shared$;
   }
-  setMinLevel(level) {
-    this.minLevel = level;
+  setMinLevel(process, level) {
+    this.minLevels[process] = level;
   }
   publish(process, level, input) {
     const normalized = normalizeTraceInput(input);
@@ -162,7 +170,7 @@ class TraceHub {
       timestamp: (/* @__PURE__ */ new Date()).toISOString(),
       traceSeq: this.nextTraceSeq++
     };
-    if (LEVEL_ORDER[level] >= LEVEL_ORDER[this.minLevel]) {
+    if (LEVEL_ORDER[level] >= LEVEL_ORDER[this.minLevels[process]]) {
       this.subject.next(event);
     }
     return event;
@@ -182,10 +190,14 @@ function getTraceEvents$() {
   return getGlobalTraceHub().events$;
 }
 function setMainTraceMinLevel(level) {
-  getGlobalTraceHub().setMinLevel(level);
+  getGlobalTraceHub().setMinLevel("main", level);
 }
 function setRendererTraceMinLevel(level) {
   rendererMinLevel = level;
+  getGlobalTraceHub().setMinLevel("renderer", level);
+}
+function setRendererTraceEnabled(enabled) {
+  rendererEnabled = enabled;
 }
 function publishMainTrace(level, input) {
   return getGlobalTraceHub().publish("main", level, input);
@@ -202,19 +214,30 @@ function dispatchRendererTracePayload(rawPayload) {
     forwarded: true
   };
 }
+function setRendererTraceTransport(fn) {
+  customRendererTraceTransport = fn;
+}
 function emitRendererTrace(level, input) {
+  if (!rendererEnabled) {
+    return;
+  }
   if (LEVEL_ORDER[level] < LEVEL_ORDER[rendererMinLevel]) {
     return;
   }
+  const normalized = { ...normalizeTraceInput(input), level };
+  if (customRendererTraceTransport) {
+    try {
+      customRendererTraceTransport(normalized);
+      return;
+    } catch {
+    }
+  }
   const bridge = resolveTraceBridge();
   if (!bridge || typeof bridge.__trace !== "function") {
     return;
   }
   try {
-    bridge.__trace({
-      ...normalizeTraceInput(input),
-      level
-    });
+    bridge.__trace(normalized);
   } catch {
   }
 }
@@ -225,6 +248,8 @@ function clearTraceHubForTests() {
   const globalObj = globalThis;
   delete globalObj[TRACE_HUB_SYMBOL];
   rendererMinLevel = "debug";
+  rendererEnabled = false;
+  customRendererTraceTransport = null;
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
@@ -237,6 +262,8 @@ function clearTraceHubForTests() {
   publishMainTrace,
   publishTestTrace,
   setMainTraceMinLevel,
-  setRendererTraceMinLevel
+  setRendererTraceEnabled,
+  setRendererTraceMinLevel,
+  setRendererTraceTransport
 });
 //# sourceMappingURL=trace_hub.cjs.map

package/dist/tracing/trace_hub.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/tracing/trace_hub.ts"],"sourcesContent":["import { Observable, Subject, Subscription } from 'rxjs';\nimport { share } from 'rxjs/operators';\n\nexport type TraceLevel = 'debug' | 'info' | 'warn' | 'error';\nexport type TraceProcess = 'main' | 'renderer' | 'test';\n\nexport type TraceInput = {\n  source: string;\n  type: string;\n  message?: string;\n  conversationId?: number | string;\n  payload?: Record<string, unknown>;\n};\n\nexport type TraceEvent = TraceInput & {\n  level: TraceLevel;\n  process: TraceProcess;\n  timestamp: string;\n  traceSeq: number;\n};\n\nexport type TraceDispatchResult = {\n  ok: boolean;\n  forwarded: boolean;\n};\n\nexport type TraceCaptureOptions = {\n  maxEvents?: number;\n};\n\nexport type TraceWaitOptions = {\n  timeoutMs?: number;\n};\n\nconst TRACE_HUB_SYMBOL = Symbol.for('@noego/wood.trace.hub');\n\nconst LEVEL_ORDER: Record<TraceLevel, number> = {\n  debug: 0,\n  info: 1,\n  warn: 2,\n  error: 3,\n};\n\nlet rendererMinLevel: TraceLevel = 'debug';\n\ntype PendingWaiter = {\n  predicate: (event: TraceEvent) => boolean;\n  resolve: (event: TraceEvent) => void;\n  reject: (error: Error) => void;\n  timeoutId?: ReturnType<typeof setTimeout>;\n};\n\ntype GlobalWithTraceHub = typeof globalThis & {\n  [TRACE_HUB_SYMBOL]?: TraceHub;\n};\n\ntype TraceBridgeLike = Record<string, unknown> & {\n  __trace?: (payload: unknown) => void;\n};\n\ntype GlobalWithTraceBridge = typeof globalThis & {\n  __NOEGO_WOOD_BRIDGE__?: unknown;\n  wood?: unknown;\n  window?: {\n    __NOEGO_WOOD_BRIDGE__?: unknown;\n    wood?: unknown;\n  };\n};\n\nfunction normalizeTraceInput(raw: unknown): TraceInput {\n  const input = (raw ?? {}) as Partial<TraceInput> & Record<string, unknown>;\n  const source = typeof input.source === 'string' && input.source.trim().length > 0\n    ? input.source\n    : 'unknown';\n  const type = typeof input.type === 'string' && input.type.trim().length > 0\n    ? input.type\n    : 'unknown';\n  const message = typeof input.message === 'string' ? input.message : undefined;\n  const conversationId = typeof input.conversationId === 'number' || typeof input.conversationId === 'string'\n    ? input.conversationId\n    : undefined;\n  const payload = isRecord(input.payload) ? { ...input.payload } : undefined;\n\n  return {\n    source,\n    type,\n    ...(message ? { message } : {}),\n    ...(conversationId !== undefined ? { conversationId } : {}),\n    ...(payload ? { payload } : {}),\n  };\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction resolveTraceBridge(): TraceBridgeLike | null {\n  const globalObj = globalThis as GlobalWithTraceBridge;\n  const bridge = globalObj.__NOEGO_WOOD_BRIDGE__\n    ?? globalObj.window?.__NOEGO_WOOD_BRIDGE__\n    ?? globalObj.wood\n    ?? globalObj.window?.wood;\n  if (!bridge || typeof bridge !== 'object') {\n    return null;\n  }\n  return bridge as TraceBridgeLike;\n}\n\nexport class TraceCapture {\n  private readonly buffer: TraceEvent[] = [];\n  private readonly pending = new Set<PendingWaiter>();\n  private readonly maxEvents: number;\n  private subscription: Subscription;\n\n  constructor(\n    source$: Observable<TraceEvent>,\n    options: TraceCaptureOptions = {},\n  ) {\n    this.maxEvents = Math.max(1, options.maxEvents ?? 1000);\n    this.subscription = source$.subscribe((event) => {\n      this.buffer.push(event);\n      if (this.buffer.length > this.maxEvents) {\n        this.buffer.splice(0, this.buffer.length - this.maxEvents);\n      }\n      for (const waiter of Array.from(this.pending)) {\n        if (!waiter.predicate(event)) {\n          continue;\n        }\n        if (waiter.timeoutId) {\n          clearTimeout(waiter.timeoutId);\n        }\n        this.pending.delete(waiter);\n        waiter.resolve(event);\n      }\n    });\n  }\n\n  events(): TraceEvent[] {\n    return [...this.buffer];\n  }\n\n  async waitFor(\n    predicate: (event: TraceEvent) => boolean,\n    options: TraceWaitOptions = {},\n  ): Promise<TraceEvent> {\n    const existing = this.buffer.find(predicate);\n    if (existing) {\n      return existing;\n    }\n\n    return new Promise<TraceEvent>((resolve, reject) => {\n      const waiter: PendingWaiter = {\n        predicate,\n        resolve,\n        reject,\n      };\n      const timeoutMs = options.timeoutMs ?? 5000;\n      waiter.timeoutId = setTimeout(() => {\n        this.pending.delete(waiter);\n        reject(new Error(`Timed out waiting for trace event after ${timeoutMs}ms`));\n      }, timeoutMs);\n      this.pending.add(waiter);\n    });\n  }\n\n  async writeArtifact(targetPath: string): Promise<void> {\n    const [{ mkdir, writeFile }, pathModule] = await Promise.all([\n      import('node:fs/promises'),\n      import('node:path'),\n    ]);\n    await mkdir(pathModule.dirname(targetPath), { recursive: true });\n    const lines = this.buffer.map((event) => JSON.stringify(event)).join('\\n');\n    await writeFile(targetPath, `${lines}${lines.length > 0 ? '\\n' : ''}`, 'utf8');\n  }\n\n  stop(): void {\n    for (const waiter of this.pending) {\n      if (waiter.timeoutId) {\n        clearTimeout(waiter.timeoutId);\n      }\n      waiter.reject(new Error('Trace capture stopped before predicate matched'));\n    }\n    this.pending.clear();\n    this.subscription.unsubscribe();\n  }\n}\n\nclass TraceHub {\n  private readonly subject = new Subject<TraceEvent>();\n  private readonly shared$ = this.subject.asObservable().pipe(share());\n  private nextTraceSeq = 1;\n  private minLevel: TraceLevel = 'debug';\n\n  get events$(): Observable<TraceEvent> {\n    return this.shared$;\n  }\n\n  setMinLevel(level: TraceLevel): void {\n    this.minLevel = 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.minLevel]) {\n      this.subject.next(event);\n    }\n    return event;\n  }\n\n  capture(options: TraceCaptureOptions = {}): TraceCapture {\n    return new TraceCapture(this.events$, options);\n  }\n}\n\nfunction getGlobalTraceHub(): TraceHub {\n  const globalObj = globalThis as GlobalWithTraceHub;\n  if (!globalObj[TRACE_HUB_SYMBOL]) {\n    globalObj[TRACE_HUB_SYMBOL] = new TraceHub();\n  }\n  return globalObj[TRACE_HUB_SYMBOL] as TraceHub;\n}\n\nexport function getTraceEvents$(): Observable<TraceEvent> {\n  return getGlobalTraceHub().events$;\n}\n\nexport function setMainTraceMinLevel(level: TraceLevel): void {\n  getGlobalTraceHub().setMinLevel(level);\n}\n\nexport function setRendererTraceMinLevel(level: TraceLevel): void {\n  rendererMinLevel = level;\n}\n\nexport function publishMainTrace(level: TraceLevel, input: unknown): TraceEvent {\n  return getGlobalTraceHub().publish('main', level, input);\n}\n\nexport function publishTestTrace(process: TraceProcess, level: TraceLevel, input: unknown): TraceEvent {\n  return getGlobalTraceHub().publish(process, level, input);\n}\n\nexport function dispatchRendererTracePayload(rawPayload: unknown): TraceDispatchResult {\n  const payload = (rawPayload ?? {}) as Partial<TraceInput> & { level?: TraceLevel };\n  const level = payload.level === 'debug' || payload.level === 'info' || payload.level === 'warn' || payload.level === 'error'\n    ? payload.level\n    : 'info';\n  getGlobalTraceHub().publish('renderer', level, payload);\n  return {\n    ok: true,\n    forwarded: true,\n  };\n}\n\nexport function emitRendererTrace(level: TraceLevel, input: TraceInput): void {\n  if (LEVEL_ORDER[level] < LEVEL_ORDER[rendererMinLevel]) {\n    return;\n  }\n  const bridge = resolveTraceBridge();\n  if (!bridge || typeof bridge.__trace !== 'function') {\n    return;\n  }\n  try {\n    bridge.__trace({\n      ...normalizeTraceInput(input),\n      level,\n    });\n  } catch {\n    // Tracing is observational and must never break the caller.\n  }\n}\n\nexport function createTraceCapture(options: TraceCaptureOptions = {}): TraceCapture {\n  return getGlobalTraceHub().capture(options);\n}\n\nexport function clearTraceHubForTests(): void {\n  const globalObj = globalThis as GlobalWithTraceHub;\n  delete globalObj[TRACE_HUB_SYMBOL];\n  rendererMinLevel = 'debug';\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/tracing/trace_hub.ts"],"sourcesContent":["import { Observable, Subject, Subscription } from 'rxjs';\nimport { share } from 'rxjs/operators';\n\nexport type TraceLevel = 'debug' | 'info' | 'warn' | 'error';\nexport type TraceProcess = 'main' | 'renderer' | 'test';\n\nexport type TraceInput = {\n  source: string;\n  type: string;\n  message?: string;\n  conversationId?: number | string;\n  payload?: Record<string, unknown>;\n};\n\nexport type TraceEvent = TraceInput & {\n  level: TraceLevel;\n  process: TraceProcess;\n  timestamp: string;\n  traceSeq: number;\n};\n\nexport type TraceDispatchResult = {\n  ok: boolean;\n  forwarded: boolean;\n};\n\nexport type TraceCaptureOptions = {\n  maxEvents?: number;\n};\n\nexport type TraceWaitOptions = {\n  timeoutMs?: number;\n};\n\nconst TRACE_HUB_SYMBOL = Symbol.for('@noego/wood.trace.hub');\n\nconst LEVEL_ORDER: Record<TraceLevel, number> = {\n  debug: 0,\n  info: 1,\n  warn: 2,\n  error: 3,\n};\n\nlet rendererMinLevel: TraceLevel = 'debug';\nlet rendererEnabled = false;\nlet customRendererTraceTransport: ((payload: unknown) => void) | null = null;\n\ntype PendingWaiter = {\n  predicate: (event: TraceEvent) => boolean;\n  resolve: (event: TraceEvent) => void;\n  reject: (error: Error) => void;\n  timeoutId?: ReturnType<typeof setTimeout>;\n};\n\ntype GlobalWithTraceHub = typeof globalThis & {\n  [TRACE_HUB_SYMBOL]?: TraceHub;\n};\n\ntype TraceBridgeLike = Record<string, unknown> & {\n  __trace?: (payload: unknown) => void;\n};\n\ntype GlobalWithTraceBridge = typeof globalThis & {\n  __NOEGO_WOOD_BRIDGE__?: unknown;\n  wood?: unknown;\n  window?: {\n    __NOEGO_WOOD_BRIDGE__?: unknown;\n    wood?: unknown;\n  };\n};\n\nfunction normalizeTraceInput(raw: unknown): TraceInput {\n  const input = (raw ?? {}) as Partial<TraceInput> & Record<string, unknown>;\n  const source = typeof input.source === 'string' && input.source.trim().length > 0\n    ? input.source\n    : 'unknown';\n  const type = typeof input.type === 'string' && input.type.trim().length > 0\n    ? input.type\n    : 'unknown';\n  const message = typeof input.message === 'string' ? input.message : undefined;\n  const conversationId = typeof input.conversationId === 'number' || typeof input.conversationId === 'string'\n    ? input.conversationId\n    : undefined;\n  const payload = isRecord(input.payload) ? { ...input.payload } : undefined;\n\n  return {\n    source,\n    type,\n    ...(message ? { message } : {}),\n    ...(conversationId !== undefined ? { conversationId } : {}),\n    ...(payload ? { payload } : {}),\n  };\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction resolveTraceBridge(): TraceBridgeLike | null {\n  const globalObj = globalThis as GlobalWithTraceBridge;\n  const bridge = globalObj.__NOEGO_WOOD_BRIDGE__\n    ?? globalObj.window?.__NOEGO_WOOD_BRIDGE__\n    ?? globalObj.wood\n    ?? globalObj.window?.wood;\n  if (!bridge || typeof bridge !== 'object') {\n    return null;\n  }\n  return bridge as TraceBridgeLike;\n}\n\nexport class TraceCapture {\n  private readonly buffer: TraceEvent[] = [];\n  private readonly pending = new Set<PendingWaiter>();\n  private readonly maxEvents: number;\n  private subscription: Subscription;\n\n  constructor(\n    source$: Observable<TraceEvent>,\n    options: TraceCaptureOptions = {},\n  ) {\n    this.maxEvents = Math.max(1, options.maxEvents ?? 1000);\n    this.subscription = source$.subscribe((event) => {\n      this.buffer.push(event);\n      if (this.buffer.length > this.maxEvents) {\n        this.buffer.splice(0, this.buffer.length - this.maxEvents);\n      }\n      for (const waiter of Array.from(this.pending)) {\n        if (!waiter.predicate(event)) {\n          continue;\n        }\n        if (waiter.timeoutId) {\n          clearTimeout(waiter.timeoutId);\n        }\n        this.pending.delete(waiter);\n        waiter.resolve(event);\n      }\n    });\n  }\n\n  events(): TraceEvent[] {\n    return [...this.buffer];\n  }\n\n  async waitFor(\n    predicate: (event: TraceEvent) => boolean,\n    options: TraceWaitOptions = {},\n  ): Promise<TraceEvent> {\n    const existing = this.buffer.find(predicate);\n    if (existing) {\n      return existing;\n    }\n\n    return new Promise<TraceEvent>((resolve, reject) => {\n      const waiter: PendingWaiter = {\n        predicate,\n        resolve,\n        reject,\n      };\n      const timeoutMs = options.timeoutMs ?? 5000;\n      waiter.timeoutId = setTimeout(() => {\n        this.pending.delete(waiter);\n        reject(new Error(`Timed out waiting for trace event after ${timeoutMs}ms`));\n      }, timeoutMs);\n      this.pending.add(waiter);\n    });\n  }\n\n  async writeArtifact(targetPath: string): Promise<void> {\n    const [{ mkdir, writeFile }, pathModule] = await Promise.all([\n      import('node:fs/promises'),\n      import('node:path'),\n    ]);\n    await mkdir(pathModule.dirname(targetPath), { recursive: true });\n    const lines = this.buffer.map((event) => JSON.stringify(event)).join('\\n');\n    await writeFile(targetPath, `${lines}${lines.length > 0 ? '\\n' : ''}`, 'utf8');\n  }\n\n  stop(): void {\n    for (const waiter of this.pending) {\n      if (waiter.timeoutId) {\n        clearTimeout(waiter.timeoutId);\n      }\n      waiter.reject(new Error('Trace capture stopped before predicate matched'));\n    }\n    this.pending.clear();\n    this.subscription.unsubscribe();\n  }\n}\n\nclass TraceHub {\n  private readonly subject = new Subject<TraceEvent>();\n  private readonly shared$ = this.subject.asObservable().pipe(share());\n  private nextTraceSeq = 1;\n  private minLevels: Record<TraceProcess, TraceLevel> = {\n    main: 'debug',\n    renderer: 'debug',\n    test: 'debug',\n  };\n\n  get events$(): Observable<TraceEvent> {\n    return this.shared$;\n  }\n\n  setMinLevel(process: TraceProcess, level: TraceLevel): void {\n    this.minLevels[process] = level;\n  }\n\n  publish(process: TraceProcess, level: TraceLevel, input: unknown): TraceEvent {\n    const normalized = normalizeTraceInput(input);\n    const event: TraceEvent = {\n      ...normalized,\n      level,\n      process,\n      timestamp: new Date().toISOString(),\n      traceSeq: this.nextTraceSeq++,\n    };\n    if (LEVEL_ORDER[level] >= LEVEL_ORDER[this.minLevels[process]]) {\n      this.subject.next(event);\n    }\n    return event;\n  }\n\n  capture(options: TraceCaptureOptions = {}): TraceCapture {\n    return new TraceCapture(this.events$, options);\n  }\n}\n\nfunction getGlobalTraceHub(): TraceHub {\n  const globalObj = globalThis as GlobalWithTraceHub;\n  if (!globalObj[TRACE_HUB_SYMBOL]) {\n    globalObj[TRACE_HUB_SYMBOL] = new TraceHub();\n  }\n  return globalObj[TRACE_HUB_SYMBOL] as TraceHub;\n}\n\nexport function getTraceEvents$(): Observable<TraceEvent> {\n  return getGlobalTraceHub().events$;\n}\n\nexport function setMainTraceMinLevel(level: TraceLevel): void {\n  getGlobalTraceHub().setMinLevel('main', level);\n}\n\nexport function setRendererTraceMinLevel(level: TraceLevel): void {\n  rendererMinLevel = level;\n  getGlobalTraceHub().setMinLevel('renderer', level);\n}\n\nexport function setRendererTraceEnabled(enabled: boolean): void {\n  rendererEnabled = enabled;\n}\n\nexport function publishMainTrace(level: TraceLevel, input: unknown): TraceEvent {\n  return getGlobalTraceHub().publish('main', level, input);\n}\n\nexport function publishTestTrace(process: TraceProcess, level: TraceLevel, input: unknown): TraceEvent {\n  return getGlobalTraceHub().publish(process, level, input);\n}\n\nexport function dispatchRendererTracePayload(rawPayload: unknown): TraceDispatchResult {\n  const payload = (rawPayload ?? {}) as Partial<TraceInput> & { level?: TraceLevel };\n  const level = payload.level === 'debug' || payload.level === 'info' || payload.level === 'warn' || payload.level === 'error'\n    ? payload.level\n    : 'info';\n  getGlobalTraceHub().publish('renderer', level, payload);\n  return {\n    ok: true,\n    forwarded: true,\n  };\n}\n\nexport function setRendererTraceTransport(fn: ((payload: unknown) => void) | null): void {\n  customRendererTraceTransport = fn;\n}\n\nexport function emitRendererTrace(level: TraceLevel, input: TraceInput): void {\n  if (!rendererEnabled) {\n    return;\n  }\n  if (LEVEL_ORDER[level] < LEVEL_ORDER[rendererMinLevel]) {\n    return;\n  }\n  const normalized = { ...normalizeTraceInput(input), level };\n\n  if (customRendererTraceTransport) {\n    try {\n      customRendererTraceTransport(normalized);\n      return;\n    } catch {\n      // Fall through to bridge.__trace\n    }\n  }\n\n  const bridge = resolveTraceBridge();\n  if (!bridge || typeof bridge.__trace !== 'function') {\n    return;\n  }\n  try {\n    bridge.__trace(normalized);\n  } catch {\n    // Tracing is observational and must never break the caller.\n  }\n}\n\nexport function createTraceCapture(options: TraceCaptureOptions = {}): TraceCapture {\n  return getGlobalTraceHub().capture(options);\n}\n\nexport function clearTraceHubForTests(): void {\n  const globalObj = globalThis as GlobalWithTraceHub;\n  delete globalObj[TRACE_HUB_SYMBOL];\n  rendererMinLevel = 'debug';\n  rendererEnabled = false;\n  customRendererTraceTransport = null;\n}\n"],"mappings":"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","names":[]}

package/dist/tracing/trace_hub.d.cts

@@ -39,11 +39,13 @@ declare class TraceCapture {
 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): TraceDispatchResult;
+declare function setRendererTraceTransport(fn: ((payload: unknown) => void) | null): void;
 declare function emitRendererTrace(level: TraceLevel, input: TraceInput): void;
 declare function createTraceCapture(options?: TraceCaptureOptions): TraceCapture;
 declare function clearTraceHubForTests(): void;
 
-export { TraceCapture, type TraceCaptureOptions, type TraceDispatchResult, type TraceEvent, type TraceInput, type TraceLevel, type TraceProcess, type TraceWaitOptions, clearTraceHubForTests, createTraceCapture, dispatchRendererTracePayload, emitRendererTrace, getTraceEvents$, publishMainTrace, publishTestTrace, setMainTraceMinLevel, setRendererTraceMinLevel };
+export { TraceCapture, type TraceCaptureOptions, type TraceDispatchResult, type TraceEvent, type TraceInput, type TraceLevel, type TraceProcess, type TraceWaitOptions, clearTraceHubForTests, createTraceCapture, dispatchRendererTracePayload, emitRendererTrace, getTraceEvents$, publishMainTrace, publishTestTrace, setMainTraceMinLevel, setRendererTraceEnabled, setRendererTraceMinLevel, setRendererTraceTransport };

package/dist/tracing/trace_hub.d.ts

@@ -39,11 +39,13 @@ declare class TraceCapture {
 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): TraceDispatchResult;
+declare function setRendererTraceTransport(fn: ((payload: unknown) => void) | null): void;
 declare function emitRendererTrace(level: TraceLevel, input: TraceInput): void;
 declare function createTraceCapture(options?: TraceCaptureOptions): TraceCapture;
 declare function clearTraceHubForTests(): void;
 
-export { TraceCapture, type TraceCaptureOptions, type TraceDispatchResult, type TraceEvent, type TraceInput, type TraceLevel, type TraceProcess, type TraceWaitOptions, clearTraceHubForTests, createTraceCapture, dispatchRendererTracePayload, emitRendererTrace, getTraceEvents$, publishMainTrace, publishTestTrace, setMainTraceMinLevel, setRendererTraceMinLevel };
+export { TraceCapture, type TraceCaptureOptions, type TraceDispatchResult, type TraceEvent, type TraceInput, type TraceLevel, type TraceProcess, type TraceWaitOptions, clearTraceHubForTests, createTraceCapture, dispatchRendererTracePayload, emitRendererTrace, getTraceEvents$, publishMainTrace, publishTestTrace, setMainTraceMinLevel, setRendererTraceEnabled, setRendererTraceMinLevel, setRendererTraceTransport };

package/dist/tracing/trace_hub.js

@@ -8,6 +8,8 @@ const LEVEL_ORDER = {
   error: 3
 };
 let rendererMinLevel = "debug";
+let rendererEnabled = false;
+let customRendererTraceTransport = null;
 function normalizeTraceInput(raw) {
   const input = raw ?? {};
   const source = typeof input.source === "string" && input.source.trim().length > 0 ? input.source : "unknown";
@@ -103,13 +105,17 @@ class TraceHub {
     this.subject = new Subject();
     this.shared$ = this.subject.asObservable().pipe(share());
     this.nextTraceSeq = 1;
-    this.minLevel = "debug";
+    this.minLevels = {
+      main: "debug",
+      renderer: "debug",
+      test: "debug"
+    };
   }
   get events$() {
     return this.shared$;
   }
-  setMinLevel(level) {
-    this.minLevel = level;
+  setMinLevel(process, level) {
+    this.minLevels[process] = level;
   }
   publish(process, level, input) {
     const normalized = normalizeTraceInput(input);
@@ -120,7 +126,7 @@ class TraceHub {
       timestamp: (/* @__PURE__ */ new Date()).toISOString(),
       traceSeq: this.nextTraceSeq++
     };
-    if (LEVEL_ORDER[level] >= LEVEL_ORDER[this.minLevel]) {
+    if (LEVEL_ORDER[level] >= LEVEL_ORDER[this.minLevels[process]]) {
       this.subject.next(event);
     }
     return event;
@@ -140,10 +146,14 @@ function getTraceEvents$() {
   return getGlobalTraceHub().events$;
 }
 function setMainTraceMinLevel(level) {
-  getGlobalTraceHub().setMinLevel(level);
+  getGlobalTraceHub().setMinLevel("main", level);
 }
 function setRendererTraceMinLevel(level) {
   rendererMinLevel = level;
+  getGlobalTraceHub().setMinLevel("renderer", level);
+}
+function setRendererTraceEnabled(enabled) {
+  rendererEnabled = enabled;
 }
 function publishMainTrace(level, input) {
   return getGlobalTraceHub().publish("main", level, input);
@@ -160,19 +170,30 @@ function dispatchRendererTracePayload(rawPayload) {
     forwarded: true
   };
 }
+function setRendererTraceTransport(fn) {
+  customRendererTraceTransport = fn;
+}
 function emitRendererTrace(level, input) {
+  if (!rendererEnabled) {
+    return;
+  }
   if (LEVEL_ORDER[level] < LEVEL_ORDER[rendererMinLevel]) {
     return;
   }
+  const normalized = { ...normalizeTraceInput(input), level };
+  if (customRendererTraceTransport) {
+    try {
+      customRendererTraceTransport(normalized);
+      return;
+    } catch {
+    }
+  }
   const bridge = resolveTraceBridge();
   if (!bridge || typeof bridge.__trace !== "function") {
     return;
   }
   try {
-    bridge.__trace({
-      ...normalizeTraceInput(input),
-      level
-    });
+    bridge.__trace(normalized);
   } catch {
   }
 }
@@ -183,6 +204,8 @@ function clearTraceHubForTests() {
   const globalObj = globalThis;
   delete globalObj[TRACE_HUB_SYMBOL];
   rendererMinLevel = "debug";
+  rendererEnabled = false;
+  customRendererTraceTransport = null;
 }
 export {
   TraceCapture,
@@ -194,6 +217,8 @@ export {
   publishMainTrace,
   publishTestTrace,
   setMainTraceMinLevel,
-  setRendererTraceMinLevel
+  setRendererTraceEnabled,
+  setRendererTraceMinLevel,
+  setRendererTraceTransport
 };
 //# sourceMappingURL=trace_hub.js.map

package/dist/tracing/trace_hub.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/tracing/trace_hub.ts"],"sourcesContent":["import { Observable, Subject, Subscription } from 'rxjs';\nimport { share } from 'rxjs/operators';\n\nexport type TraceLevel = 'debug' | 'info' | 'warn' | 'error';\nexport type TraceProcess = 'main' | 'renderer' | 'test';\n\nexport type TraceInput = {\n  source: string;\n  type: string;\n  message?: string;\n  conversationId?: number | string;\n  payload?: Record<string, unknown>;\n};\n\nexport type TraceEvent = TraceInput & {\n  level: TraceLevel;\n  process: TraceProcess;\n  timestamp: string;\n  traceSeq: number;\n};\n\nexport type TraceDispatchResult = {\n  ok: boolean;\n  forwarded: boolean;\n};\n\nexport type TraceCaptureOptions = {\n  maxEvents?: number;\n};\n\nexport type TraceWaitOptions = {\n  timeoutMs?: number;\n};\n\nconst TRACE_HUB_SYMBOL = Symbol.for('@noego/wood.trace.hub');\n\nconst LEVEL_ORDER: Record<TraceLevel, number> = {\n  debug: 0,\n  info: 1,\n  warn: 2,\n  error: 3,\n};\n\nlet rendererMinLevel: TraceLevel = 'debug';\n\ntype PendingWaiter = {\n  predicate: (event: TraceEvent) => boolean;\n  resolve: (event: TraceEvent) => void;\n  reject: (error: Error) => void;\n  timeoutId?: ReturnType<typeof setTimeout>;\n};\n\ntype GlobalWithTraceHub = typeof globalThis & {\n  [TRACE_HUB_SYMBOL]?: TraceHub;\n};\n\ntype TraceBridgeLike = Record<string, unknown> & {\n  __trace?: (payload: unknown) => void;\n};\n\ntype GlobalWithTraceBridge = typeof globalThis & {\n  __NOEGO_WOOD_BRIDGE__?: unknown;\n  wood?: unknown;\n  window?: {\n    __NOEGO_WOOD_BRIDGE__?: unknown;\n    wood?: unknown;\n  };\n};\n\nfunction normalizeTraceInput(raw: unknown): TraceInput {\n  const input = (raw ?? {}) as Partial<TraceInput> & Record<string, unknown>;\n  const source = typeof input.source === 'string' && input.source.trim().length > 0\n    ? input.source\n    : 'unknown';\n  const type = typeof input.type === 'string' && input.type.trim().length > 0\n    ? input.type\n    : 'unknown';\n  const message = typeof input.message === 'string' ? input.message : undefined;\n  const conversationId = typeof input.conversationId === 'number' || typeof input.conversationId === 'string'\n    ? input.conversationId\n    : undefined;\n  const payload = isRecord(input.payload) ? { ...input.payload } : undefined;\n\n  return {\n    source,\n    type,\n    ...(message ? { message } : {}),\n    ...(conversationId !== undefined ? { conversationId } : {}),\n    ...(payload ? { payload } : {}),\n  };\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction resolveTraceBridge(): TraceBridgeLike | null {\n  const globalObj = globalThis as GlobalWithTraceBridge;\n  const bridge = globalObj.__NOEGO_WOOD_BRIDGE__\n    ?? globalObj.window?.__NOEGO_WOOD_BRIDGE__\n    ?? globalObj.wood\n    ?? globalObj.window?.wood;\n  if (!bridge || typeof bridge !== 'object') {\n    return null;\n  }\n  return bridge as TraceBridgeLike;\n}\n\nexport class TraceCapture {\n  private readonly buffer: TraceEvent[] = [];\n  private readonly pending = new Set<PendingWaiter>();\n  private readonly maxEvents: number;\n  private subscription: Subscription;\n\n  constructor(\n    source$: Observable<TraceEvent>,\n    options: TraceCaptureOptions = {},\n  ) {\n    this.maxEvents = Math.max(1, options.maxEvents ?? 1000);\n    this.subscription = source$.subscribe((event) => {\n      this.buffer.push(event);\n      if (this.buffer.length > this.maxEvents) {\n        this.buffer.splice(0, this.buffer.length - this.maxEvents);\n      }\n      for (const waiter of Array.from(this.pending)) {\n        if (!waiter.predicate(event)) {\n          continue;\n        }\n        if (waiter.timeoutId) {\n          clearTimeout(waiter.timeoutId);\n        }\n        this.pending.delete(waiter);\n        waiter.resolve(event);\n      }\n    });\n  }\n\n  events(): TraceEvent[] {\n    return [...this.buffer];\n  }\n\n  async waitFor(\n    predicate: (event: TraceEvent) => boolean,\n    options: TraceWaitOptions = {},\n  ): Promise<TraceEvent> {\n    const existing = this.buffer.find(predicate);\n    if (existing) {\n      return existing;\n    }\n\n    return new Promise<TraceEvent>((resolve, reject) => {\n      const waiter: PendingWaiter = {\n        predicate,\n        resolve,\n        reject,\n      };\n      const timeoutMs = options.timeoutMs ?? 5000;\n      waiter.timeoutId = setTimeout(() => {\n        this.pending.delete(waiter);\n        reject(new Error(`Timed out waiting for trace event after ${timeoutMs}ms`));\n      }, timeoutMs);\n      this.pending.add(waiter);\n    });\n  }\n\n  async writeArtifact(targetPath: string): Promise<void> {\n    const [{ mkdir, writeFile }, pathModule] = await Promise.all([\n      import('node:fs/promises'),\n      import('node:path'),\n    ]);\n    await mkdir(pathModule.dirname(targetPath), { recursive: true });\n    const lines = this.buffer.map((event) => JSON.stringify(event)).join('\\n');\n    await writeFile(targetPath, `${lines}${lines.length > 0 ? '\\n' : ''}`, 'utf8');\n  }\n\n  stop(): void {\n    for (const waiter of this.pending) {\n      if (waiter.timeoutId) {\n        clearTimeout(waiter.timeoutId);\n      }\n      waiter.reject(new Error('Trace capture stopped before predicate matched'));\n    }\n    this.pending.clear();\n    this.subscription.unsubscribe();\n  }\n}\n\nclass TraceHub {\n  private readonly subject = new Subject<TraceEvent>();\n  private readonly shared$ = this.subject.asObservable().pipe(share());\n  private nextTraceSeq = 1;\n  private minLevel: TraceLevel = 'debug';\n\n  get events$(): Observable<TraceEvent> {\n    return this.shared$;\n  }\n\n  setMinLevel(level: TraceLevel): void {\n    this.minLevel = 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.minLevel]) {\n      this.subject.next(event);\n    }\n    return event;\n  }\n\n  capture(options: TraceCaptureOptions = {}): TraceCapture {\n    return new TraceCapture(this.events$, options);\n  }\n}\n\nfunction getGlobalTraceHub(): TraceHub {\n  const globalObj = globalThis as GlobalWithTraceHub;\n  if (!globalObj[TRACE_HUB_SYMBOL]) {\n    globalObj[TRACE_HUB_SYMBOL] = new TraceHub();\n  }\n  return globalObj[TRACE_HUB_SYMBOL] as TraceHub;\n}\n\nexport function getTraceEvents$(): Observable<TraceEvent> {\n  return getGlobalTraceHub().events$;\n}\n\nexport function setMainTraceMinLevel(level: TraceLevel): void {\n  getGlobalTraceHub().setMinLevel(level);\n}\n\nexport function setRendererTraceMinLevel(level: TraceLevel): void {\n  rendererMinLevel = level;\n}\n\nexport function publishMainTrace(level: TraceLevel, input: unknown): TraceEvent {\n  return getGlobalTraceHub().publish('main', level, input);\n}\n\nexport function publishTestTrace(process: TraceProcess, level: TraceLevel, input: unknown): TraceEvent {\n  return getGlobalTraceHub().publish(process, level, input);\n}\n\nexport function dispatchRendererTracePayload(rawPayload: unknown): TraceDispatchResult {\n  const payload = (rawPayload ?? {}) as Partial<TraceInput> & { level?: TraceLevel };\n  const level = payload.level === 'debug' || payload.level === 'info' || payload.level === 'warn' || payload.level === 'error'\n    ? payload.level\n    : 'info';\n  getGlobalTraceHub().publish('renderer', level, payload);\n  return {\n    ok: true,\n    forwarded: true,\n  };\n}\n\nexport function emitRendererTrace(level: TraceLevel, input: TraceInput): void {\n  if (LEVEL_ORDER[level] < LEVEL_ORDER[rendererMinLevel]) {\n    return;\n  }\n  const bridge = resolveTraceBridge();\n  if (!bridge || typeof bridge.__trace !== 'function') {\n    return;\n  }\n  try {\n    bridge.__trace({\n      ...normalizeTraceInput(input),\n      level,\n    });\n  } catch {\n    // Tracing is observational and must never break the caller.\n  }\n}\n\nexport function createTraceCapture(options: TraceCaptureOptions = {}): TraceCapture {\n  return getGlobalTraceHub().capture(options);\n}\n\nexport function clearTraceHubForTests(): void {\n  const globalObj = globalThis as GlobalWithTraceHub;\n  delete globalObj[TRACE_HUB_SYMBOL];\n  rendererMinLevel = 'debug';\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/tracing/trace_hub.ts"],"sourcesContent":["import { Observable, Subject, Subscription } from 'rxjs';\nimport { share } from 'rxjs/operators';\n\nexport type TraceLevel = 'debug' | 'info' | 'warn' | 'error';\nexport type TraceProcess = 'main' | 'renderer' | 'test';\n\nexport type TraceInput = {\n  source: string;\n  type: string;\n  message?: string;\n  conversationId?: number | string;\n  payload?: Record<string, unknown>;\n};\n\nexport type TraceEvent = TraceInput & {\n  level: TraceLevel;\n  process: TraceProcess;\n  timestamp: string;\n  traceSeq: number;\n};\n\nexport type TraceDispatchResult = {\n  ok: boolean;\n  forwarded: boolean;\n};\n\nexport type TraceCaptureOptions = {\n  maxEvents?: number;\n};\n\nexport type TraceWaitOptions = {\n  timeoutMs?: number;\n};\n\nconst TRACE_HUB_SYMBOL = Symbol.for('@noego/wood.trace.hub');\n\nconst LEVEL_ORDER: Record<TraceLevel, number> = {\n  debug: 0,\n  info: 1,\n  warn: 2,\n  error: 3,\n};\n\nlet rendererMinLevel: TraceLevel = 'debug';\nlet rendererEnabled = false;\nlet customRendererTraceTransport: ((payload: unknown) => void) | null = null;\n\ntype PendingWaiter = {\n  predicate: (event: TraceEvent) => boolean;\n  resolve: (event: TraceEvent) => void;\n  reject: (error: Error) => void;\n  timeoutId?: ReturnType<typeof setTimeout>;\n};\n\ntype GlobalWithTraceHub = typeof globalThis & {\n  [TRACE_HUB_SYMBOL]?: TraceHub;\n};\n\ntype TraceBridgeLike = Record<string, unknown> & {\n  __trace?: (payload: unknown) => void;\n};\n\ntype GlobalWithTraceBridge = typeof globalThis & {\n  __NOEGO_WOOD_BRIDGE__?: unknown;\n  wood?: unknown;\n  window?: {\n    __NOEGO_WOOD_BRIDGE__?: unknown;\n    wood?: unknown;\n  };\n};\n\nfunction normalizeTraceInput(raw: unknown): TraceInput {\n  const input = (raw ?? {}) as Partial<TraceInput> & Record<string, unknown>;\n  const source = typeof input.source === 'string' && input.source.trim().length > 0\n    ? input.source\n    : 'unknown';\n  const type = typeof input.type === 'string' && input.type.trim().length > 0\n    ? input.type\n    : 'unknown';\n  const message = typeof input.message === 'string' ? input.message : undefined;\n  const conversationId = typeof input.conversationId === 'number' || typeof input.conversationId === 'string'\n    ? input.conversationId\n    : undefined;\n  const payload = isRecord(input.payload) ? { ...input.payload } : undefined;\n\n  return {\n    source,\n    type,\n    ...(message ? { message } : {}),\n    ...(conversationId !== undefined ? { conversationId } : {}),\n    ...(payload ? { payload } : {}),\n  };\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction resolveTraceBridge(): TraceBridgeLike | null {\n  const globalObj = globalThis as GlobalWithTraceBridge;\n  const bridge = globalObj.__NOEGO_WOOD_BRIDGE__\n    ?? globalObj.window?.__NOEGO_WOOD_BRIDGE__\n    ?? globalObj.wood\n    ?? globalObj.window?.wood;\n  if (!bridge || typeof bridge !== 'object') {\n    return null;\n  }\n  return bridge as TraceBridgeLike;\n}\n\nexport class TraceCapture {\n  private readonly buffer: TraceEvent[] = [];\n  private readonly pending = new Set<PendingWaiter>();\n  private readonly maxEvents: number;\n  private subscription: Subscription;\n\n  constructor(\n    source$: Observable<TraceEvent>,\n    options: TraceCaptureOptions = {},\n  ) {\n    this.maxEvents = Math.max(1, options.maxEvents ?? 1000);\n    this.subscription = source$.subscribe((event) => {\n      this.buffer.push(event);\n      if (this.buffer.length > this.maxEvents) {\n        this.buffer.splice(0, this.buffer.length - this.maxEvents);\n      }\n      for (const waiter of Array.from(this.pending)) {\n        if (!waiter.predicate(event)) {\n          continue;\n        }\n        if (waiter.timeoutId) {\n          clearTimeout(waiter.timeoutId);\n        }\n        this.pending.delete(waiter);\n        waiter.resolve(event);\n      }\n    });\n  }\n\n  events(): TraceEvent[] {\n    return [...this.buffer];\n  }\n\n  async waitFor(\n    predicate: (event: TraceEvent) => boolean,\n    options: TraceWaitOptions = {},\n  ): Promise<TraceEvent> {\n    const existing = this.buffer.find(predicate);\n    if (existing) {\n      return existing;\n    }\n\n    return new Promise<TraceEvent>((resolve, reject) => {\n      const waiter: PendingWaiter = {\n        predicate,\n        resolve,\n        reject,\n      };\n      const timeoutMs = options.timeoutMs ?? 5000;\n      waiter.timeoutId = setTimeout(() => {\n        this.pending.delete(waiter);\n        reject(new Error(`Timed out waiting for trace event after ${timeoutMs}ms`));\n      }, timeoutMs);\n      this.pending.add(waiter);\n    });\n  }\n\n  async writeArtifact(targetPath: string): Promise<void> {\n    const [{ mkdir, writeFile }, pathModule] = await Promise.all([\n      import('node:fs/promises'),\n      import('node:path'),\n    ]);\n    await mkdir(pathModule.dirname(targetPath), { recursive: true });\n    const lines = this.buffer.map((event) => JSON.stringify(event)).join('\\n');\n    await writeFile(targetPath, `${lines}${lines.length > 0 ? '\\n' : ''}`, 'utf8');\n  }\n\n  stop(): void {\n    for (const waiter of this.pending) {\n      if (waiter.timeoutId) {\n        clearTimeout(waiter.timeoutId);\n      }\n      waiter.reject(new Error('Trace capture stopped before predicate matched'));\n    }\n    this.pending.clear();\n    this.subscription.unsubscribe();\n  }\n}\n\nclass TraceHub {\n  private readonly subject = new Subject<TraceEvent>();\n  private readonly shared$ = this.subject.asObservable().pipe(share());\n  private nextTraceSeq = 1;\n  private minLevels: Record<TraceProcess, TraceLevel> = {\n    main: 'debug',\n    renderer: 'debug',\n    test: 'debug',\n  };\n\n  get events$(): Observable<TraceEvent> {\n    return this.shared$;\n  }\n\n  setMinLevel(process: TraceProcess, level: TraceLevel): void {\n    this.minLevels[process] = level;\n  }\n\n  publish(process: TraceProcess, level: TraceLevel, input: unknown): TraceEvent {\n    const normalized = normalizeTraceInput(input);\n    const event: TraceEvent = {\n      ...normalized,\n      level,\n      process,\n      timestamp: new Date().toISOString(),\n      traceSeq: this.nextTraceSeq++,\n    };\n    if (LEVEL_ORDER[level] >= LEVEL_ORDER[this.minLevels[process]]) {\n      this.subject.next(event);\n    }\n    return event;\n  }\n\n  capture(options: TraceCaptureOptions = {}): TraceCapture {\n    return new TraceCapture(this.events$, options);\n  }\n}\n\nfunction getGlobalTraceHub(): TraceHub {\n  const globalObj = globalThis as GlobalWithTraceHub;\n  if (!globalObj[TRACE_HUB_SYMBOL]) {\n    globalObj[TRACE_HUB_SYMBOL] = new TraceHub();\n  }\n  return globalObj[TRACE_HUB_SYMBOL] as TraceHub;\n}\n\nexport function getTraceEvents$(): Observable<TraceEvent> {\n  return getGlobalTraceHub().events$;\n}\n\nexport function setMainTraceMinLevel(level: TraceLevel): void {\n  getGlobalTraceHub().setMinLevel('main', level);\n}\n\nexport function setRendererTraceMinLevel(level: TraceLevel): void {\n  rendererMinLevel = level;\n  getGlobalTraceHub().setMinLevel('renderer', level);\n}\n\nexport function setRendererTraceEnabled(enabled: boolean): void {\n  rendererEnabled = enabled;\n}\n\nexport function publishMainTrace(level: TraceLevel, input: unknown): TraceEvent {\n  return getGlobalTraceHub().publish('main', level, input);\n}\n\nexport function publishTestTrace(process: TraceProcess, level: TraceLevel, input: unknown): TraceEvent {\n  return getGlobalTraceHub().publish(process, level, input);\n}\n\nexport function dispatchRendererTracePayload(rawPayload: unknown): TraceDispatchResult {\n  const payload = (rawPayload ?? {}) as Partial<TraceInput> & { level?: TraceLevel };\n  const level = payload.level === 'debug' || payload.level === 'info' || payload.level === 'warn' || payload.level === 'error'\n    ? payload.level\n    : 'info';\n  getGlobalTraceHub().publish('renderer', level, payload);\n  return {\n    ok: true,\n    forwarded: true,\n  };\n}\n\nexport function setRendererTraceTransport(fn: ((payload: unknown) => void) | null): void {\n  customRendererTraceTransport = fn;\n}\n\nexport function emitRendererTrace(level: TraceLevel, input: TraceInput): void {\n  if (!rendererEnabled) {\n    return;\n  }\n  if (LEVEL_ORDER[level] < LEVEL_ORDER[rendererMinLevel]) {\n    return;\n  }\n  const normalized = { ...normalizeTraceInput(input), level };\n\n  if (customRendererTraceTransport) {\n    try {\n      customRendererTraceTransport(normalized);\n      return;\n    } catch {\n      // Fall through to bridge.__trace\n    }\n  }\n\n  const bridge = resolveTraceBridge();\n  if (!bridge || typeof bridge.__trace !== 'function') {\n    return;\n  }\n  try {\n    bridge.__trace(normalized);\n  } catch {\n    // Tracing is observational and must never break the caller.\n  }\n}\n\nexport function createTraceCapture(options: TraceCaptureOptions = {}): TraceCapture {\n  return getGlobalTraceHub().capture(options);\n}\n\nexport function clearTraceHubForTests(): void {\n  const globalObj = globalThis as GlobalWithTraceHub;\n  delete globalObj[TRACE_HUB_SYMBOL];\n  rendererMinLevel = 'debug';\n  rendererEnabled = false;\n  customRendererTraceTransport = null;\n}\n"],"mappings":"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","names":[]}