@noego/wood 0.4.6 → 0.4.8

package/dist/runtime/runtime.cjs

@@ -27,10 +27,15 @@ var import_get_container = require("./get_container.cjs");
 var import_tracing = require("../tracing/index.js");
 var import_tracing2 = require("../tracing/index.js");
 var import_renderer_log_dispatcher = require("./renderer_log_dispatcher.js");
+var import_renderer_trace_batch_receiver_registry = require("./renderer_trace_batch_receiver_registry.js");
+var import_app_env = require("./app_env.js");
 const logger = (0, import_logger.getLogger)("wood:runtime");
 function normalizeRendererLogLevel(level) {
-  if (level === "debug" || level === "warn" || level === "error") {
-    return level;
+  if (typeof level === "string") {
+    const normalized = level.trim().toLowerCase();
+    if (normalized.length > 0) {
+      return normalized;
+    }
   }
   return "info";
 }
@@ -60,6 +65,11 @@ async function runtime(options) {
     rendererTraceMinLevel = "debug"
   } = options;
   const container = options.container ?? (0, import_get_container.getContainer)();
+  const rendererTraceBatchReceiver = options.rendererTraceBatchReceiver ?? (0, import_renderer_trace_batch_receiver_registry.getRendererTraceBatchReceiver)();
+  const rendererTraceBatchEnabled = rendererTraceBatchReceiver !== null;
+  const rendererTraceBatchHost = new import_tracing.RendererTraceBatchHost(
+    rendererTraceBatchReceiver
+  );
   logger.info("runtime start", {
     mode,
     hasProvidedContainer: !!options.container,
@@ -69,19 +79,18 @@ async function runtime(options) {
     enableRendererTraceBridge,
     traceMinLevel: traceMinLevel ?? "debug",
     rendererTraceEnabled,
-    rendererTraceMinLevel
+    rendererTraceMinLevel,
+    rendererTraceBatchEnabled
   });
-  if (traceMinLevel) {
-    (0, import_tracing2.setMainTraceMinLevel)(traceMinLevel);
-  }
-  (0, import_tracing2.setRendererTraceMinLevel)(rendererTraceMinLevel);
-  if (typeof container.instance === "function") {
-    const traceConfiguration = await container.instance(import_tracing.TraceProviderConfiguration);
-    traceConfiguration.configureRuntime("main");
-    if (traceMinLevel) {
-      traceConfiguration.configureMinLevel(traceMinLevel);
-    }
-  }
+  const traceSettings = {
+    enableRendererLogBridge,
+    enableRendererTraceBridge,
+    traceMinLevel,
+    rendererTraceEnabled,
+    rendererTraceMinLevel,
+    rendererTraceBatchEnabled
+  };
+  await configureRuntimeTracing(container, traceSettings);
   const router = new import_wood_router.WoodRouter({
     container,
     controllersDir,
@@ -94,49 +103,8 @@ async function runtime(options) {
   logger.info("runtime controller validation complete");
   router.precompileSchemas();
   logger.info("runtime schema pre-compilation complete");
-  router.registerReservedHandler("__load", async (data, event) => {
-    if (!options.onLoad) {
-      throw new Error('Reserved channel "__load" not configured. Provide runtime({ onLoad }).');
-    }
-    return options.onLoad(data, event);
-  });
-  router.registerReservedHandler("__navigate", async (data, event) => {
-    if (!options.onNavigate) {
-      throw new Error('Reserved channel "__navigate" not configured. Provide runtime({ onNavigate }).');
-    }
-    return options.onNavigate(data, event);
-  });
-  router.registerReservedHandler("__window", async (data, event) => {
-    if (!options.onWindow) {
-      throw new Error('Reserved channel "__window" not configured. Provide runtime({ onWindow }).');
-    }
-    return options.onWindow(data, event);
-  });
-  router.registerReservedHandler("__debug", async (data, event) => {
-    if (!options.onDebug) {
-      throw new Error('Reserved channel "__debug" not configured. Provide runtime({ onDebug }).');
-    }
-    return options.onDebug(data, event);
-  });
-  router.registerReservedHandler("__contextMenu", async (data, event) => {
-    if (!options.onContextMenu) {
-      throw new Error('Reserved channel "__contextMenu" not configured. Provide runtime({ onContextMenu }).');
-    }
-    return options.onContextMenu(data, event);
-  });
-  router.registerReservedHandler("__woodConfig", async () => {
-    return {
-      rendererTraceEnabled,
-      rendererTraceMinLevel
-    };
-  });
-  if (enableRendererLogBridge) {
-    registerRendererLogBridge(ipcMain);
-  }
-  ipcMain.removeAllListeners?.("__trace");
-  if (enableRendererTraceBridge && rendererTraceEnabled) {
-    registerRendererTraceBridge(ipcMain, options.resolveRendererTraceContext);
-  }
+  registerReservedRuntimeHandlers(router, options, traceSettings, rendererTraceBatchHost);
+  registerRuntimeObservationBridges(ipcMain, traceSettings, options.resolveRendererTraceContext);
   router.registerIpcHandlers(ipcMain);
   logger.info("runtime ipc handlers registered", {
     channelCount: router.getChannels().length,
@@ -145,6 +113,56 @@ async function runtime(options) {
   });
   return { router };
 }
+async function configureRuntimeTracing(container, settings) {
+  if (settings.traceMinLevel) {
+    (0, import_tracing2.setMainTraceMinLevel)(settings.traceMinLevel);
+  }
+  (0, import_tracing2.setRendererTraceMinLevel)(settings.rendererTraceMinLevel);
+  if (typeof container.instance !== "function") {
+    return;
+  }
+  const traceConfiguration = await container.instance(import_tracing.TraceProviderConfiguration);
+  traceConfiguration.configureRuntime("main");
+  if (settings.traceMinLevel) {
+    traceConfiguration.configureMinLevel(settings.traceMinLevel);
+  }
+}
+function registerReservedRuntimeHandlers(router, options, settings, rendererTraceBatchHost) {
+  router.registerReservedHandler("__load", requireRuntimeHandler("__load", "onLoad", options.onLoad));
+  router.registerReservedHandler("__navigate", requireRuntimeHandler("__navigate", "onNavigate", options.onNavigate));
+  router.registerReservedHandler("__window", requireRuntimeHandler("__window", "onWindow", options.onWindow));
+  router.registerReservedHandler("__debug", requireRuntimeHandler("__debug", "onDebug", options.onDebug));
+  router.registerReservedHandler(
+    "__contextMenu",
+    requireRuntimeHandler("__contextMenu", "onContextMenu", options.onContextMenu)
+  );
+  router.registerReservedHandler("__woodConfig", async () => ({
+    rendererTraceEnabled: settings.rendererTraceEnabled,
+    rendererTraceMinLevel: settings.rendererTraceMinLevel,
+    rendererTraceBatchEnabled: settings.rendererTraceBatchEnabled,
+    appEnv: options.appEnv ?? await (0, import_app_env.resolveWoodAppEnv)()
+  }));
+  router.registerReservedHandler("__traceBatch", async (data, event) => {
+    return rendererTraceBatchHost.receive(data, options.resolveRendererTraceContext?.(event) ?? {});
+  });
+}
+function registerRuntimeObservationBridges(ipcMain, settings, resolveContext) {
+  if (settings.enableRendererLogBridge) {
+    registerRendererLogBridge(ipcMain);
+  }
+  ipcMain.removeAllListeners?.("__trace");
+  if (settings.enableRendererTraceBridge && settings.rendererTraceEnabled) {
+    registerRendererTraceBridge(ipcMain, resolveContext);
+  }
+}
+function requireRuntimeHandler(channel, optionName, handler) {
+  return async (data, event) => {
+    if (!handler) {
+      throw new Error(`Reserved channel "${channel}" not configured. Provide runtime({ ${optionName} }).`);
+    }
+    return handler(data, event);
+  };
+}
 function registerRendererTraceBridge(ipcMain, resolveContext) {
   ipcMain.removeAllListeners?.("__trace");
   ipcMain.on("__trace", (event, rawPayload) => {

package/dist/runtime/runtime.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/runtime/runtime.ts"],"sourcesContent":["import { getLogger } from '@noego/logger';\nimport { WoodRouter } from '../router/wood_router.cjs';\nimport { getContainer } from './get_container.cjs';\nimport { TraceProviderConfiguration, dispatchRendererTracePayload } from '../tracing/index.js';\nimport {\n  setMainTraceMinLevel,\n  setRendererTraceMinLevel,\n  type TraceLevel,\n  type TraceRuntimeContext,\n} from '../tracing/index.js';\nimport {\n  getRendererLogDispatcher,\n  type RendererLogDispatchResult,\n  type RendererLogEntry,\n  type RendererLogLevel,\n} from './renderer_log_dispatcher.js';\n\nconst logger = getLogger('wood:runtime');\n\ntype IpcMainLike = {\n  handle: (channel: string, handler: (_event: unknown, data: unknown) => Promise<unknown> | unknown) => void;\n  on: (channel: string, handler: (_event: unknown, ...args: unknown[]) => void) => void;\n  removeHandler?: (channel: string) => void;\n  removeAllListeners?: (channel: string) => void;\n};\n\nexport interface RegisterRuntimeRouter {\n  registerController(name: string, cls: any): void;\n  loadOperations(operations: Map<string, any>): void;\n}\n\nexport interface RuntimeOptions {\n  ipcMain: IpcMainLike;\n  registerRuntime: (router: RegisterRuntimeRouter) => void;\n  container?: any;\n  controllersDir: string;\n  middlewareDir: string;\n  mode?: 'bundled' | 'dev';\n  enableRendererLogBridge?: boolean;\n  enableRendererTraceBridge?: boolean;\n  traceMinLevel?: TraceLevel;\n  rendererTraceEnabled?: boolean;\n  rendererTraceMinLevel?: TraceLevel;\n  onLoad?: (data: unknown, event?: unknown) => Promise<unknown>;\n  onNavigate?: (data: unknown, event?: unknown) => Promise<unknown>;\n  onWindow?: (data: unknown, event?: unknown) => Promise<unknown>;\n  onDebug?: (data: unknown, event?: unknown) => Promise<unknown>;\n  onContextMenu?: (data: unknown, event?: unknown) => Promise<unknown>;\n  resolveRendererTraceContext?: (event: unknown) => TraceRuntimeContext | undefined;\n}\n\nexport interface RuntimeResult {\n  router: WoodRouter;\n}\n\ntype RendererLogPayload = {\n  level: string;\n  logger: string;\n  message: string;\n  context?: unknown;\n};\n\ntype IpcInvokeEventLike = {\n  sender?: {\n    id?: number;\n  };\n};\n\nfunction normalizeRendererLogLevel(level: unknown): RendererLogLevel {\n  if (level === 'debug' || level === 'warn' || level === 'error') {\n    return level;\n  }\n  return 'info';\n}\n\nfunction coerceRendererLogPayload(\n  rawPayload: unknown,\n  event: unknown,\n): RendererLogEntry {\n  const payload = (rawPayload ?? {}) as Partial<RendererLogPayload>;\n  const ipcEvent = event as IpcInvokeEventLike;\n\n  return {\n    level: normalizeRendererLogLevel(payload.level),\n    logger: typeof payload.logger === 'string' && payload.logger.trim().length > 0\n      ? payload.logger\n      : 'renderer',\n    message: typeof payload.message === 'string' ? payload.message : '',\n    context: payload.context,\n    timestamp: new Date().toISOString(),\n    senderId: typeof ipcEvent?.sender?.id === 'number' ? ipcEvent.sender.id : null,\n  };\n}\n\n/**\n * Boot a bundled-safe Wood runtime using pre-generated static runtime artifacts.\n */\nexport async function runtime(options: RuntimeOptions): Promise<RuntimeResult> {\n  const {\n    ipcMain,\n    registerRuntime,\n    controllersDir,\n    middlewareDir,\n    mode = 'bundled',\n    enableRendererLogBridge = true,\n    enableRendererTraceBridge = true,\n    traceMinLevel,\n    rendererTraceEnabled = false,\n    rendererTraceMinLevel = 'debug',\n  } = options;\n\n  const container = options.container ?? getContainer();\n\n  logger.info('runtime start', {\n    mode,\n    hasProvidedContainer: !!options.container,\n    controllersDir,\n    middlewareDir,\n    enableRendererLogBridge,\n    enableRendererTraceBridge,\n    traceMinLevel: traceMinLevel ?? 'debug',\n    rendererTraceEnabled,\n    rendererTraceMinLevel,\n  });\n\n  if (traceMinLevel) {\n    setMainTraceMinLevel(traceMinLevel);\n  }\n  setRendererTraceMinLevel(rendererTraceMinLevel);\n\n  if (typeof container.instance === 'function') {\n    const traceConfiguration = await container.instance(TraceProviderConfiguration);\n    traceConfiguration.configureRuntime('main');\n    if (traceMinLevel) {\n      traceConfiguration.configureMinLevel(traceMinLevel);\n    }\n  }\n\n  const router = new WoodRouter({\n    container,\n    controllersDir,\n    middlewareDir,\n    mode,\n  });\n\n  registerRuntime(router);\n  logger.info('runtime registration complete');\n\n  router.validateControllers();\n  logger.info('runtime controller validation complete');\n\n  router.precompileSchemas();\n  logger.info('runtime schema pre-compilation complete');\n\n  router.registerReservedHandler('__load', async (data, event) => {\n    if (!options.onLoad) {\n      throw new Error('Reserved channel \"__load\" not configured. Provide runtime({ onLoad }).');\n    }\n    return options.onLoad(data, event);\n  });\n\n  router.registerReservedHandler('__navigate', async (data, event) => {\n    if (!options.onNavigate) {\n      throw new Error('Reserved channel \"__navigate\" not configured. Provide runtime({ onNavigate }).');\n    }\n    return options.onNavigate(data, event);\n  });\n\n  router.registerReservedHandler('__window', async (data, event) => {\n    if (!options.onWindow) {\n      throw new Error('Reserved channel \"__window\" not configured. Provide runtime({ onWindow }).');\n    }\n    return options.onWindow(data, event);\n  });\n\n  router.registerReservedHandler('__debug', async (data, event) => {\n    if (!options.onDebug) {\n      throw new Error('Reserved channel \"__debug\" not configured. Provide runtime({ onDebug }).');\n    }\n    return options.onDebug(data, event);\n  });\n\n  router.registerReservedHandler('__contextMenu', async (data, event) => {\n    if (!options.onContextMenu) {\n      throw new Error('Reserved channel \"__contextMenu\" not configured. Provide runtime({ onContextMenu }).');\n    }\n    return options.onContextMenu(data, event);\n  });\n\n  router.registerReservedHandler('__woodConfig', async () => {\n    return {\n      rendererTraceEnabled,\n      rendererTraceMinLevel,\n    };\n  });\n\n  if (enableRendererLogBridge) {\n    registerRendererLogBridge(ipcMain);\n  }\n\n  ipcMain.removeAllListeners?.('__trace');\n\n  if (enableRendererTraceBridge && rendererTraceEnabled) {\n    registerRendererTraceBridge(ipcMain, options.resolveRendererTraceContext);\n  }\n\n  router.registerIpcHandlers(ipcMain);\n  logger.info('runtime ipc handlers registered', {\n    channelCount: router.getChannels().length,\n    enableRendererLogBridge,\n    enableRendererTraceBridge,\n  });\n\n  return { router };\n}\n\nfunction registerRendererTraceBridge(\n  ipcMain: IpcMainLike,\n  resolveContext?: (event: unknown) => TraceRuntimeContext | undefined,\n): void {\n  ipcMain.removeAllListeners?.('__trace');\n\n  ipcMain.on('__trace', (event, rawPayload) => {\n    dispatchRendererTracePayload(rawPayload, resolveContext?.(event));\n  });\n\n  logger.info('renderer trace bridge registered (fire-and-forget)');\n}\n\nfunction registerRendererLogBridge(ipcMain: IpcMainLike): void {\n  const dispatcher = getRendererLogDispatcher();\n\n  ipcMain.removeAllListeners?.('__log');\n\n  ipcMain.on('__log', (_event, rawPayload) => {\n    const entry = coerceRendererLogPayload(rawPayload, null);\n    void dispatcher.dispatch(entry).then((result) => {\n      const typedResult = result as RendererLogDispatchResult;\n      if (!typedResult.ok) {\n        logger.warn('renderer log dispatch failed', {\n          logger: entry.logger,\n          messageLength: entry.message.length,\n          reason: typedResult.reason ?? null,\n          errorMessage: typedResult.errorMessage ?? null,\n        });\n      }\n    });\n  });\n\n  logger.info('renderer log bridge registered (fire-and-forget)');\n}\n"],"mappings":"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","names":["import_tracing"]}
+{"version":3,"sources":["../../src/runtime/runtime.ts"],"sourcesContent":["import { getLogger } from '@noego/logger';\nimport { WoodRouter } from '../router/wood_router.cjs';\nimport { getContainer } from './get_container.cjs';\nimport {\n  RendererTraceBatchHost,\n  TraceProviderConfiguration,\n  dispatchRendererTracePayload,\n} from '../tracing/index.js';\nimport {\n  setMainTraceMinLevel,\n  setRendererTraceMinLevel,\n  type TraceLevel,\n  type TraceRuntimeContext,\n  type WoodTraceBatchReceiver,\n} from '../tracing/index.js';\nimport {\n  getRendererLogDispatcher,\n  type RendererLogDispatchResult,\n  type RendererLogEntry,\n  type RendererLogLevel,\n} from './renderer_log_dispatcher.js';\nimport { getRendererTraceBatchReceiver } from './renderer_trace_batch_receiver_registry.js';\nimport { resolveWoodAppEnv, type WoodAppEnv } from './app_env.js';\n\nconst logger = getLogger('wood:runtime');\n\ntype IpcMainLike = {\n  handle: (channel: string, handler: (_event: unknown, data: unknown) => Promise<unknown> | unknown) => void;\n  on: (channel: string, handler: (_event: unknown, ...args: unknown[]) => void) => void;\n  removeHandler?: (channel: string) => void;\n  removeAllListeners?: (channel: string) => void;\n};\n\nexport interface RegisterRuntimeRouter {\n  registerController(name: string, cls: any): void;\n  loadOperations(operations: Map<string, any>): void;\n}\n\nexport interface RuntimeOptions {\n  ipcMain: IpcMainLike;\n  registerRuntime: (router: RegisterRuntimeRouter) => void;\n  container?: any;\n  controllersDir: string;\n  middlewareDir: string;\n  mode?: 'bundled' | 'dev';\n  /** Override the resolved app environment tier reported to renderers via __woodConfig. */\n  appEnv?: WoodAppEnv;\n  enableRendererLogBridge?: boolean;\n  enableRendererTraceBridge?: boolean;\n  traceMinLevel?: TraceLevel;\n  rendererTraceEnabled?: boolean;\n  rendererTraceMinLevel?: TraceLevel;\n  /** Resolves only with the acknowledgement produced by the downstream durable receiver. */\n  rendererTraceBatchReceiver?: WoodTraceBatchReceiver;\n  onLoad?: (data: unknown, event?: unknown) => Promise<unknown>;\n  onNavigate?: (data: unknown, event?: unknown) => Promise<unknown>;\n  onWindow?: (data: unknown, event?: unknown) => Promise<unknown>;\n  onDebug?: (data: unknown, event?: unknown) => Promise<unknown>;\n  onContextMenu?: (data: unknown, event?: unknown) => Promise<unknown>;\n  resolveRendererTraceContext?: (event: unknown) => TraceRuntimeContext | undefined;\n}\n\nexport interface RuntimeResult {\n  router: WoodRouter;\n}\n\ntype RendererLogPayload = {\n  level: string;\n  logger: string;\n  message: string;\n  context?: unknown;\n};\n\ntype IpcInvokeEventLike = {\n  sender?: {\n    id?: number;\n  };\n};\n\ntype RuntimeReservedHandler = (\n  data: unknown,\n  event?: unknown,\n) => Promise<unknown>;\n\ntype RuntimeTraceSettings = Readonly<{\n  enableRendererLogBridge: boolean;\n  enableRendererTraceBridge: boolean;\n  traceMinLevel: TraceLevel | undefined;\n  rendererTraceEnabled: boolean;\n  rendererTraceMinLevel: TraceLevel;\n  rendererTraceBatchEnabled: boolean;\n}>;\n\nfunction normalizeRendererLogLevel(level: unknown): RendererLogLevel {\n  if (typeof level === 'string') {\n    const normalized = level.trim().toLowerCase();\n    if (normalized.length > 0) {\n      return normalized;\n    }\n  }\n  return 'info';\n}\n\nfunction coerceRendererLogPayload(\n  rawPayload: unknown,\n  event: unknown,\n): RendererLogEntry {\n  const payload = (rawPayload ?? {}) as Partial<RendererLogPayload>;\n  const ipcEvent = event as IpcInvokeEventLike;\n\n  return {\n    level: normalizeRendererLogLevel(payload.level),\n    logger: typeof payload.logger === 'string' && payload.logger.trim().length > 0\n      ? payload.logger\n      : 'renderer',\n    message: typeof payload.message === 'string' ? payload.message : '',\n    context: payload.context,\n    timestamp: new Date().toISOString(),\n    senderId: typeof ipcEvent?.sender?.id === 'number' ? ipcEvent.sender.id : null,\n  };\n}\n\n/**\n * Boot a bundled-safe Wood runtime using pre-generated static runtime artifacts.\n */\nexport async function runtime(options: RuntimeOptions): Promise<RuntimeResult> {\n  const {\n    ipcMain,\n    registerRuntime,\n    controllersDir,\n    middlewareDir,\n    mode = 'bundled',\n    enableRendererLogBridge = true,\n    enableRendererTraceBridge = true,\n    traceMinLevel,\n    rendererTraceEnabled = false,\n    rendererTraceMinLevel = 'debug',\n  } = options;\n\n  const container = options.container ?? getContainer();\n  const rendererTraceBatchReceiver = options.rendererTraceBatchReceiver\n    ?? getRendererTraceBatchReceiver();\n  const rendererTraceBatchEnabled = rendererTraceBatchReceiver !== null;\n  const rendererTraceBatchHost = new RendererTraceBatchHost(\n    rendererTraceBatchReceiver,\n  );\n\n  logger.info('runtime start', {\n    mode,\n    hasProvidedContainer: !!options.container,\n    controllersDir,\n    middlewareDir,\n    enableRendererLogBridge,\n    enableRendererTraceBridge,\n    traceMinLevel: traceMinLevel ?? 'debug',\n    rendererTraceEnabled,\n    rendererTraceMinLevel,\n    rendererTraceBatchEnabled,\n  });\n\n  const traceSettings: RuntimeTraceSettings = {\n    enableRendererLogBridge,\n    enableRendererTraceBridge,\n    traceMinLevel,\n    rendererTraceEnabled,\n    rendererTraceMinLevel,\n    rendererTraceBatchEnabled,\n  };\n  await configureRuntimeTracing(container, traceSettings);\n\n  const router = new WoodRouter({\n    container,\n    controllersDir,\n    middlewareDir,\n    mode,\n  });\n\n  registerRuntime(router);\n  logger.info('runtime registration complete');\n\n  router.validateControllers();\n  logger.info('runtime controller validation complete');\n\n  router.precompileSchemas();\n  logger.info('runtime schema pre-compilation complete');\n\n  registerReservedRuntimeHandlers(router, options, traceSettings, rendererTraceBatchHost);\n  registerRuntimeObservationBridges(ipcMain, traceSettings, options.resolveRendererTraceContext);\n\n  router.registerIpcHandlers(ipcMain);\n  logger.info('runtime ipc handlers registered', {\n    channelCount: router.getChannels().length,\n    enableRendererLogBridge,\n    enableRendererTraceBridge,\n  });\n\n  return { router };\n}\n\nasync function configureRuntimeTracing(\n  container: any,\n  settings: RuntimeTraceSettings,\n): Promise<void> {\n  if (settings.traceMinLevel) {\n    setMainTraceMinLevel(settings.traceMinLevel);\n  }\n  setRendererTraceMinLevel(settings.rendererTraceMinLevel);\n  if (typeof container.instance !== 'function') {\n    return;\n  }\n\n  const traceConfiguration = await container.instance(TraceProviderConfiguration);\n  traceConfiguration.configureRuntime('main');\n  if (settings.traceMinLevel) {\n    traceConfiguration.configureMinLevel(settings.traceMinLevel);\n  }\n}\n\nfunction registerReservedRuntimeHandlers(\n  router: WoodRouter,\n  options: RuntimeOptions,\n  settings: RuntimeTraceSettings,\n  rendererTraceBatchHost: RendererTraceBatchHost,\n): void {\n  router.registerReservedHandler('__load', requireRuntimeHandler('__load', 'onLoad', options.onLoad));\n  router.registerReservedHandler('__navigate', requireRuntimeHandler('__navigate', 'onNavigate', options.onNavigate));\n  router.registerReservedHandler('__window', requireRuntimeHandler('__window', 'onWindow', options.onWindow));\n  router.registerReservedHandler('__debug', requireRuntimeHandler('__debug', 'onDebug', options.onDebug));\n  router.registerReservedHandler(\n    '__contextMenu',\n    requireRuntimeHandler('__contextMenu', 'onContextMenu', options.onContextMenu),\n  );\n  router.registerReservedHandler('__woodConfig', async () => ({\n    rendererTraceEnabled: settings.rendererTraceEnabled,\n    rendererTraceMinLevel: settings.rendererTraceMinLevel,\n    rendererTraceBatchEnabled: settings.rendererTraceBatchEnabled,\n    appEnv: options.appEnv ?? await resolveWoodAppEnv(),\n  }));\n  router.registerReservedHandler('__traceBatch', async (data, event) => {\n    return rendererTraceBatchHost.receive(data, options.resolveRendererTraceContext?.(event) ?? {});\n  });\n}\n\nfunction registerRuntimeObservationBridges(\n  ipcMain: IpcMainLike,\n  settings: RuntimeTraceSettings,\n  resolveContext: RuntimeOptions['resolveRendererTraceContext'],\n): void {\n  if (settings.enableRendererLogBridge) {\n    registerRendererLogBridge(ipcMain);\n  }\n  ipcMain.removeAllListeners?.('__trace');\n  if (settings.enableRendererTraceBridge && settings.rendererTraceEnabled) {\n    registerRendererTraceBridge(ipcMain, resolveContext);\n  }\n}\n\nfunction requireRuntimeHandler(\n  channel: string,\n  optionName: string,\n  handler: RuntimeReservedHandler | undefined,\n): RuntimeReservedHandler {\n  return async (data, event) => {\n    if (!handler) {\n      throw new Error(`Reserved channel \"${channel}\" not configured. Provide runtime({ ${optionName} }).`);\n    }\n    return handler(data, event);\n  };\n}\n\nfunction registerRendererTraceBridge(\n  ipcMain: IpcMainLike,\n  resolveContext?: (event: unknown) => TraceRuntimeContext | undefined,\n): void {\n  ipcMain.removeAllListeners?.('__trace');\n\n  ipcMain.on('__trace', (event, rawPayload) => {\n    dispatchRendererTracePayload(rawPayload, resolveContext?.(event));\n  });\n\n  logger.info('renderer trace bridge registered (fire-and-forget)');\n}\n\nfunction registerRendererLogBridge(ipcMain: IpcMainLike): void {\n  const dispatcher = getRendererLogDispatcher();\n\n  ipcMain.removeAllListeners?.('__log');\n\n  ipcMain.on('__log', (_event, rawPayload) => {\n    const entry = coerceRendererLogPayload(rawPayload, null);\n    void dispatcher.dispatch(entry).then((result) => {\n      const typedResult = result as RendererLogDispatchResult;\n      if (!typedResult.ok) {\n        logger.warn('renderer log dispatch failed', {\n          logger: entry.logger,\n          messageLength: entry.message.length,\n          reason: typedResult.reason ?? null,\n          errorMessage: typedResult.errorMessage ?? null,\n        });\n      }\n    });\n  });\n\n  logger.info('renderer log bridge registered (fire-and-forget)');\n}\n"],"mappings":"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","names":["import_tracing"]}

package/dist/runtime/runtime.d.cts

@@ -1,7 +1,10 @@
 import { WoodRouter } from '../router/wood_router.cjs';
-import { TraceLevel, TraceRuntimeContext } from '../tracing/trace_hub.cjs';
+import { c as TraceLevel, e as TraceRuntimeContext } from '../trace_hub-Cob54qRx.cjs';
+import { WoodTraceBatchReceiver } from '../tracing/types/wood_trace_batch.types.cjs';
+import { WoodAppEnv } from './app_env.cjs';
 import '../types/operations.cjs';
 import 'rxjs';
+import '@noego/telemetry/core';
 
 type IpcMainLike = {
     handle: (channel: string, handler: (_event: unknown, data: unknown) => Promise<unknown> | unknown) => void;
@@ -20,11 +23,15 @@ interface RuntimeOptions {
     controllersDir: string;
     middlewareDir: string;
     mode?: 'bundled' | 'dev';
+    /** Override the resolved app environment tier reported to renderers via __woodConfig. */
+    appEnv?: WoodAppEnv;
     enableRendererLogBridge?: boolean;
     enableRendererTraceBridge?: boolean;
     traceMinLevel?: TraceLevel;
     rendererTraceEnabled?: boolean;
     rendererTraceMinLevel?: TraceLevel;
+    /** Resolves only with the acknowledgement produced by the downstream durable receiver. */
+    rendererTraceBatchReceiver?: WoodTraceBatchReceiver;
     onLoad?: (data: unknown, event?: unknown) => Promise<unknown>;
     onNavigate?: (data: unknown, event?: unknown) => Promise<unknown>;
     onWindow?: (data: unknown, event?: unknown) => Promise<unknown>;

package/dist/runtime/runtime.d.ts

@@ -1,7 +1,10 @@
 import { WoodRouter } from '../router/wood_router.js';
-import { TraceLevel, TraceRuntimeContext } from '../tracing/trace_hub.js';
+import { c as TraceLevel, e as TraceRuntimeContext } from '../trace_hub-Cob54qRx.js';
+import { WoodTraceBatchReceiver } from '../tracing/types/wood_trace_batch.types.js';
+import { WoodAppEnv } from './app_env.js';
 import '../types/operations.js';
 import 'rxjs';
+import '@noego/telemetry/core';
 
 type IpcMainLike = {
     handle: (channel: string, handler: (_event: unknown, data: unknown) => Promise<unknown> | unknown) => void;
@@ -20,11 +23,15 @@ interface RuntimeOptions {
     controllersDir: string;
     middlewareDir: string;
     mode?: 'bundled' | 'dev';
+    /** Override the resolved app environment tier reported to renderers via __woodConfig. */
+    appEnv?: WoodAppEnv;
     enableRendererLogBridge?: boolean;
     enableRendererTraceBridge?: boolean;
     traceMinLevel?: TraceLevel;
     rendererTraceEnabled?: boolean;
     rendererTraceMinLevel?: TraceLevel;
+    /** Resolves only with the acknowledgement produced by the downstream durable receiver. */
+    rendererTraceBatchReceiver?: WoodTraceBatchReceiver;
     onLoad?: (data: unknown, event?: unknown) => Promise<unknown>;
     onNavigate?: (data: unknown, event?: unknown) => Promise<unknown>;
     onWindow?: (data: unknown, event?: unknown) => Promise<unknown>;

package/dist/runtime/runtime.js

@@ -1,7 +1,11 @@
 import { getLogger } from "@noego/logger";
 import { WoodRouter } from "../router/wood_router.js";
 import { getContainer } from "./get_container.js";
-import { TraceProviderConfiguration, dispatchRendererTracePayload } from "../tracing/index.js";
+import {
+  RendererTraceBatchHost,
+  TraceProviderConfiguration,
+  dispatchRendererTracePayload
+} from "../tracing/index.js";
 import {
   setMainTraceMinLevel,
   setRendererTraceMinLevel
@@ -9,10 +13,15 @@ import {
 import {
   getRendererLogDispatcher
 } from "./renderer_log_dispatcher.js";
+import { getRendererTraceBatchReceiver } from "./renderer_trace_batch_receiver_registry.js";
+import { resolveWoodAppEnv } from "./app_env.js";
 const logger = getLogger("wood:runtime");
 function normalizeRendererLogLevel(level) {
-  if (level === "debug" || level === "warn" || level === "error") {
-    return level;
+  if (typeof level === "string") {
+    const normalized = level.trim().toLowerCase();
+    if (normalized.length > 0) {
+      return normalized;
+    }
   }
   return "info";
 }
@@ -42,6 +51,11 @@ async function runtime(options) {
     rendererTraceMinLevel = "debug"
   } = options;
   const container = options.container ?? getContainer();
+  const rendererTraceBatchReceiver = options.rendererTraceBatchReceiver ?? getRendererTraceBatchReceiver();
+  const rendererTraceBatchEnabled = rendererTraceBatchReceiver !== null;
+  const rendererTraceBatchHost = new RendererTraceBatchHost(
+    rendererTraceBatchReceiver
+  );
   logger.info("runtime start", {
     mode,
     hasProvidedContainer: !!options.container,
@@ -51,19 +65,18 @@ async function runtime(options) {
     enableRendererTraceBridge,
     traceMinLevel: traceMinLevel ?? "debug",
     rendererTraceEnabled,
-    rendererTraceMinLevel
+    rendererTraceMinLevel,
+    rendererTraceBatchEnabled
   });
-  if (traceMinLevel) {
-    setMainTraceMinLevel(traceMinLevel);
-  }
-  setRendererTraceMinLevel(rendererTraceMinLevel);
-  if (typeof container.instance === "function") {
-    const traceConfiguration = await container.instance(TraceProviderConfiguration);
-    traceConfiguration.configureRuntime("main");
-    if (traceMinLevel) {
-      traceConfiguration.configureMinLevel(traceMinLevel);
-    }
-  }
+  const traceSettings = {
+    enableRendererLogBridge,
+    enableRendererTraceBridge,
+    traceMinLevel,
+    rendererTraceEnabled,
+    rendererTraceMinLevel,
+    rendererTraceBatchEnabled
+  };
+  await configureRuntimeTracing(container, traceSettings);
   const router = new WoodRouter({
     container,
     controllersDir,
@@ -76,49 +89,8 @@ async function runtime(options) {
   logger.info("runtime controller validation complete");
   router.precompileSchemas();
   logger.info("runtime schema pre-compilation complete");
-  router.registerReservedHandler("__load", async (data, event) => {
-    if (!options.onLoad) {
-      throw new Error('Reserved channel "__load" not configured. Provide runtime({ onLoad }).');
-    }
-    return options.onLoad(data, event);
-  });
-  router.registerReservedHandler("__navigate", async (data, event) => {
-    if (!options.onNavigate) {
-      throw new Error('Reserved channel "__navigate" not configured. Provide runtime({ onNavigate }).');
-    }
-    return options.onNavigate(data, event);
-  });
-  router.registerReservedHandler("__window", async (data, event) => {
-    if (!options.onWindow) {
-      throw new Error('Reserved channel "__window" not configured. Provide runtime({ onWindow }).');
-    }
-    return options.onWindow(data, event);
-  });
-  router.registerReservedHandler("__debug", async (data, event) => {
-    if (!options.onDebug) {
-      throw new Error('Reserved channel "__debug" not configured. Provide runtime({ onDebug }).');
-    }
-    return options.onDebug(data, event);
-  });
-  router.registerReservedHandler("__contextMenu", async (data, event) => {
-    if (!options.onContextMenu) {
-      throw new Error('Reserved channel "__contextMenu" not configured. Provide runtime({ onContextMenu }).');
-    }
-    return options.onContextMenu(data, event);
-  });
-  router.registerReservedHandler("__woodConfig", async () => {
-    return {
-      rendererTraceEnabled,
-      rendererTraceMinLevel
-    };
-  });
-  if (enableRendererLogBridge) {
-    registerRendererLogBridge(ipcMain);
-  }
-  ipcMain.removeAllListeners?.("__trace");
-  if (enableRendererTraceBridge && rendererTraceEnabled) {
-    registerRendererTraceBridge(ipcMain, options.resolveRendererTraceContext);
-  }
+  registerReservedRuntimeHandlers(router, options, traceSettings, rendererTraceBatchHost);
+  registerRuntimeObservationBridges(ipcMain, traceSettings, options.resolveRendererTraceContext);
   router.registerIpcHandlers(ipcMain);
   logger.info("runtime ipc handlers registered", {
     channelCount: router.getChannels().length,
@@ -127,6 +99,56 @@ async function runtime(options) {
   });
   return { router };
 }
+async function configureRuntimeTracing(container, settings) {
+  if (settings.traceMinLevel) {
+    setMainTraceMinLevel(settings.traceMinLevel);
+  }
+  setRendererTraceMinLevel(settings.rendererTraceMinLevel);
+  if (typeof container.instance !== "function") {
+    return;
+  }
+  const traceConfiguration = await container.instance(TraceProviderConfiguration);
+  traceConfiguration.configureRuntime("main");
+  if (settings.traceMinLevel) {
+    traceConfiguration.configureMinLevel(settings.traceMinLevel);
+  }
+}
+function registerReservedRuntimeHandlers(router, options, settings, rendererTraceBatchHost) {
+  router.registerReservedHandler("__load", requireRuntimeHandler("__load", "onLoad", options.onLoad));
+  router.registerReservedHandler("__navigate", requireRuntimeHandler("__navigate", "onNavigate", options.onNavigate));
+  router.registerReservedHandler("__window", requireRuntimeHandler("__window", "onWindow", options.onWindow));
+  router.registerReservedHandler("__debug", requireRuntimeHandler("__debug", "onDebug", options.onDebug));
+  router.registerReservedHandler(
+    "__contextMenu",
+    requireRuntimeHandler("__contextMenu", "onContextMenu", options.onContextMenu)
+  );
+  router.registerReservedHandler("__woodConfig", async () => ({
+    rendererTraceEnabled: settings.rendererTraceEnabled,
+    rendererTraceMinLevel: settings.rendererTraceMinLevel,
+    rendererTraceBatchEnabled: settings.rendererTraceBatchEnabled,
+    appEnv: options.appEnv ?? await resolveWoodAppEnv()
+  }));
+  router.registerReservedHandler("__traceBatch", async (data, event) => {
+    return rendererTraceBatchHost.receive(data, options.resolveRendererTraceContext?.(event) ?? {});
+  });
+}
+function registerRuntimeObservationBridges(ipcMain, settings, resolveContext) {
+  if (settings.enableRendererLogBridge) {
+    registerRendererLogBridge(ipcMain);
+  }
+  ipcMain.removeAllListeners?.("__trace");
+  if (settings.enableRendererTraceBridge && settings.rendererTraceEnabled) {
+    registerRendererTraceBridge(ipcMain, resolveContext);
+  }
+}
+function requireRuntimeHandler(channel, optionName, handler) {
+  return async (data, event) => {
+    if (!handler) {
+      throw new Error(`Reserved channel "${channel}" not configured. Provide runtime({ ${optionName} }).`);
+    }
+    return handler(data, event);
+  };
+}
 function registerRendererTraceBridge(ipcMain, resolveContext) {
   ipcMain.removeAllListeners?.("__trace");
   ipcMain.on("__trace", (event, rawPayload) => {

package/dist/runtime/runtime.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/runtime/runtime.ts"],"sourcesContent":["import { getLogger } from '@noego/logger';\nimport { WoodRouter } from '../router/wood_router.js';\nimport { getContainer } from './get_container.js';\nimport { TraceProviderConfiguration, dispatchRendererTracePayload } from '../tracing/index.js';\nimport {\n  setMainTraceMinLevel,\n  setRendererTraceMinLevel,\n  type TraceLevel,\n  type TraceRuntimeContext,\n} from '../tracing/index.js';\nimport {\n  getRendererLogDispatcher,\n  type RendererLogDispatchResult,\n  type RendererLogEntry,\n  type RendererLogLevel,\n} from './renderer_log_dispatcher.js';\n\nconst logger = getLogger('wood:runtime');\n\ntype IpcMainLike = {\n  handle: (channel: string, handler: (_event: unknown, data: unknown) => Promise<unknown> | unknown) => void;\n  on: (channel: string, handler: (_event: unknown, ...args: unknown[]) => void) => void;\n  removeHandler?: (channel: string) => void;\n  removeAllListeners?: (channel: string) => void;\n};\n\nexport interface RegisterRuntimeRouter {\n  registerController(name: string, cls: any): void;\n  loadOperations(operations: Map<string, any>): void;\n}\n\nexport interface RuntimeOptions {\n  ipcMain: IpcMainLike;\n  registerRuntime: (router: RegisterRuntimeRouter) => void;\n  container?: any;\n  controllersDir: string;\n  middlewareDir: string;\n  mode?: 'bundled' | 'dev';\n  enableRendererLogBridge?: boolean;\n  enableRendererTraceBridge?: boolean;\n  traceMinLevel?: TraceLevel;\n  rendererTraceEnabled?: boolean;\n  rendererTraceMinLevel?: TraceLevel;\n  onLoad?: (data: unknown, event?: unknown) => Promise<unknown>;\n  onNavigate?: (data: unknown, event?: unknown) => Promise<unknown>;\n  onWindow?: (data: unknown, event?: unknown) => Promise<unknown>;\n  onDebug?: (data: unknown, event?: unknown) => Promise<unknown>;\n  onContextMenu?: (data: unknown, event?: unknown) => Promise<unknown>;\n  resolveRendererTraceContext?: (event: unknown) => TraceRuntimeContext | undefined;\n}\n\nexport interface RuntimeResult {\n  router: WoodRouter;\n}\n\ntype RendererLogPayload = {\n  level: string;\n  logger: string;\n  message: string;\n  context?: unknown;\n};\n\ntype IpcInvokeEventLike = {\n  sender?: {\n    id?: number;\n  };\n};\n\nfunction normalizeRendererLogLevel(level: unknown): RendererLogLevel {\n  if (level === 'debug' || level === 'warn' || level === 'error') {\n    return level;\n  }\n  return 'info';\n}\n\nfunction coerceRendererLogPayload(\n  rawPayload: unknown,\n  event: unknown,\n): RendererLogEntry {\n  const payload = (rawPayload ?? {}) as Partial<RendererLogPayload>;\n  const ipcEvent = event as IpcInvokeEventLike;\n\n  return {\n    level: normalizeRendererLogLevel(payload.level),\n    logger: typeof payload.logger === 'string' && payload.logger.trim().length > 0\n      ? payload.logger\n      : 'renderer',\n    message: typeof payload.message === 'string' ? payload.message : '',\n    context: payload.context,\n    timestamp: new Date().toISOString(),\n    senderId: typeof ipcEvent?.sender?.id === 'number' ? ipcEvent.sender.id : null,\n  };\n}\n\n/**\n * Boot a bundled-safe Wood runtime using pre-generated static runtime artifacts.\n */\nexport async function runtime(options: RuntimeOptions): Promise<RuntimeResult> {\n  const {\n    ipcMain,\n    registerRuntime,\n    controllersDir,\n    middlewareDir,\n    mode = 'bundled',\n    enableRendererLogBridge = true,\n    enableRendererTraceBridge = true,\n    traceMinLevel,\n    rendererTraceEnabled = false,\n    rendererTraceMinLevel = 'debug',\n  } = options;\n\n  const container = options.container ?? getContainer();\n\n  logger.info('runtime start', {\n    mode,\n    hasProvidedContainer: !!options.container,\n    controllersDir,\n    middlewareDir,\n    enableRendererLogBridge,\n    enableRendererTraceBridge,\n    traceMinLevel: traceMinLevel ?? 'debug',\n    rendererTraceEnabled,\n    rendererTraceMinLevel,\n  });\n\n  if (traceMinLevel) {\n    setMainTraceMinLevel(traceMinLevel);\n  }\n  setRendererTraceMinLevel(rendererTraceMinLevel);\n\n  if (typeof container.instance === 'function') {\n    const traceConfiguration = await container.instance(TraceProviderConfiguration);\n    traceConfiguration.configureRuntime('main');\n    if (traceMinLevel) {\n      traceConfiguration.configureMinLevel(traceMinLevel);\n    }\n  }\n\n  const router = new WoodRouter({\n    container,\n    controllersDir,\n    middlewareDir,\n    mode,\n  });\n\n  registerRuntime(router);\n  logger.info('runtime registration complete');\n\n  router.validateControllers();\n  logger.info('runtime controller validation complete');\n\n  router.precompileSchemas();\n  logger.info('runtime schema pre-compilation complete');\n\n  router.registerReservedHandler('__load', async (data, event) => {\n    if (!options.onLoad) {\n      throw new Error('Reserved channel \"__load\" not configured. Provide runtime({ onLoad }).');\n    }\n    return options.onLoad(data, event);\n  });\n\n  router.registerReservedHandler('__navigate', async (data, event) => {\n    if (!options.onNavigate) {\n      throw new Error('Reserved channel \"__navigate\" not configured. Provide runtime({ onNavigate }).');\n    }\n    return options.onNavigate(data, event);\n  });\n\n  router.registerReservedHandler('__window', async (data, event) => {\n    if (!options.onWindow) {\n      throw new Error('Reserved channel \"__window\" not configured. Provide runtime({ onWindow }).');\n    }\n    return options.onWindow(data, event);\n  });\n\n  router.registerReservedHandler('__debug', async (data, event) => {\n    if (!options.onDebug) {\n      throw new Error('Reserved channel \"__debug\" not configured. Provide runtime({ onDebug }).');\n    }\n    return options.onDebug(data, event);\n  });\n\n  router.registerReservedHandler('__contextMenu', async (data, event) => {\n    if (!options.onContextMenu) {\n      throw new Error('Reserved channel \"__contextMenu\" not configured. Provide runtime({ onContextMenu }).');\n    }\n    return options.onContextMenu(data, event);\n  });\n\n  router.registerReservedHandler('__woodConfig', async () => {\n    return {\n      rendererTraceEnabled,\n      rendererTraceMinLevel,\n    };\n  });\n\n  if (enableRendererLogBridge) {\n    registerRendererLogBridge(ipcMain);\n  }\n\n  ipcMain.removeAllListeners?.('__trace');\n\n  if (enableRendererTraceBridge && rendererTraceEnabled) {\n    registerRendererTraceBridge(ipcMain, options.resolveRendererTraceContext);\n  }\n\n  router.registerIpcHandlers(ipcMain);\n  logger.info('runtime ipc handlers registered', {\n    channelCount: router.getChannels().length,\n    enableRendererLogBridge,\n    enableRendererTraceBridge,\n  });\n\n  return { router };\n}\n\nfunction registerRendererTraceBridge(\n  ipcMain: IpcMainLike,\n  resolveContext?: (event: unknown) => TraceRuntimeContext | undefined,\n): void {\n  ipcMain.removeAllListeners?.('__trace');\n\n  ipcMain.on('__trace', (event, rawPayload) => {\n    dispatchRendererTracePayload(rawPayload, resolveContext?.(event));\n  });\n\n  logger.info('renderer trace bridge registered (fire-and-forget)');\n}\n\nfunction registerRendererLogBridge(ipcMain: IpcMainLike): void {\n  const dispatcher = getRendererLogDispatcher();\n\n  ipcMain.removeAllListeners?.('__log');\n\n  ipcMain.on('__log', (_event, rawPayload) => {\n    const entry = coerceRendererLogPayload(rawPayload, null);\n    void dispatcher.dispatch(entry).then((result) => {\n      const typedResult = result as RendererLogDispatchResult;\n      if (!typedResult.ok) {\n        logger.warn('renderer log dispatch failed', {\n          logger: entry.logger,\n          messageLength: entry.message.length,\n          reason: typedResult.reason ?? null,\n          errorMessage: typedResult.errorMessage ?? null,\n        });\n      }\n    });\n  });\n\n  logger.info('renderer log bridge registered (fire-and-forget)');\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/runtime/runtime.ts"],"sourcesContent":["import { getLogger } from '@noego/logger';\nimport { WoodRouter } from '../router/wood_router.js';\nimport { getContainer } from './get_container.js';\nimport {\n  RendererTraceBatchHost,\n  TraceProviderConfiguration,\n  dispatchRendererTracePayload,\n} from '../tracing/index.js';\nimport {\n  setMainTraceMinLevel,\n  setRendererTraceMinLevel,\n  type TraceLevel,\n  type TraceRuntimeContext,\n  type WoodTraceBatchReceiver,\n} from '../tracing/index.js';\nimport {\n  getRendererLogDispatcher,\n  type RendererLogDispatchResult,\n  type RendererLogEntry,\n  type RendererLogLevel,\n} from './renderer_log_dispatcher.js';\nimport { getRendererTraceBatchReceiver } from './renderer_trace_batch_receiver_registry.js';\nimport { resolveWoodAppEnv, type WoodAppEnv } from './app_env.js';\n\nconst logger = getLogger('wood:runtime');\n\ntype IpcMainLike = {\n  handle: (channel: string, handler: (_event: unknown, data: unknown) => Promise<unknown> | unknown) => void;\n  on: (channel: string, handler: (_event: unknown, ...args: unknown[]) => void) => void;\n  removeHandler?: (channel: string) => void;\n  removeAllListeners?: (channel: string) => void;\n};\n\nexport interface RegisterRuntimeRouter {\n  registerController(name: string, cls: any): void;\n  loadOperations(operations: Map<string, any>): void;\n}\n\nexport interface RuntimeOptions {\n  ipcMain: IpcMainLike;\n  registerRuntime: (router: RegisterRuntimeRouter) => void;\n  container?: any;\n  controllersDir: string;\n  middlewareDir: string;\n  mode?: 'bundled' | 'dev';\n  /** Override the resolved app environment tier reported to renderers via __woodConfig. */\n  appEnv?: WoodAppEnv;\n  enableRendererLogBridge?: boolean;\n  enableRendererTraceBridge?: boolean;\n  traceMinLevel?: TraceLevel;\n  rendererTraceEnabled?: boolean;\n  rendererTraceMinLevel?: TraceLevel;\n  /** Resolves only with the acknowledgement produced by the downstream durable receiver. */\n  rendererTraceBatchReceiver?: WoodTraceBatchReceiver;\n  onLoad?: (data: unknown, event?: unknown) => Promise<unknown>;\n  onNavigate?: (data: unknown, event?: unknown) => Promise<unknown>;\n  onWindow?: (data: unknown, event?: unknown) => Promise<unknown>;\n  onDebug?: (data: unknown, event?: unknown) => Promise<unknown>;\n  onContextMenu?: (data: unknown, event?: unknown) => Promise<unknown>;\n  resolveRendererTraceContext?: (event: unknown) => TraceRuntimeContext | undefined;\n}\n\nexport interface RuntimeResult {\n  router: WoodRouter;\n}\n\ntype RendererLogPayload = {\n  level: string;\n  logger: string;\n  message: string;\n  context?: unknown;\n};\n\ntype IpcInvokeEventLike = {\n  sender?: {\n    id?: number;\n  };\n};\n\ntype RuntimeReservedHandler = (\n  data: unknown,\n  event?: unknown,\n) => Promise<unknown>;\n\ntype RuntimeTraceSettings = Readonly<{\n  enableRendererLogBridge: boolean;\n  enableRendererTraceBridge: boolean;\n  traceMinLevel: TraceLevel | undefined;\n  rendererTraceEnabled: boolean;\n  rendererTraceMinLevel: TraceLevel;\n  rendererTraceBatchEnabled: boolean;\n}>;\n\nfunction normalizeRendererLogLevel(level: unknown): RendererLogLevel {\n  if (typeof level === 'string') {\n    const normalized = level.trim().toLowerCase();\n    if (normalized.length > 0) {\n      return normalized;\n    }\n  }\n  return 'info';\n}\n\nfunction coerceRendererLogPayload(\n  rawPayload: unknown,\n  event: unknown,\n): RendererLogEntry {\n  const payload = (rawPayload ?? {}) as Partial<RendererLogPayload>;\n  const ipcEvent = event as IpcInvokeEventLike;\n\n  return {\n    level: normalizeRendererLogLevel(payload.level),\n    logger: typeof payload.logger === 'string' && payload.logger.trim().length > 0\n      ? payload.logger\n      : 'renderer',\n    message: typeof payload.message === 'string' ? payload.message : '',\n    context: payload.context,\n    timestamp: new Date().toISOString(),\n    senderId: typeof ipcEvent?.sender?.id === 'number' ? ipcEvent.sender.id : null,\n  };\n}\n\n/**\n * Boot a bundled-safe Wood runtime using pre-generated static runtime artifacts.\n */\nexport async function runtime(options: RuntimeOptions): Promise<RuntimeResult> {\n  const {\n    ipcMain,\n    registerRuntime,\n    controllersDir,\n    middlewareDir,\n    mode = 'bundled',\n    enableRendererLogBridge = true,\n    enableRendererTraceBridge = true,\n    traceMinLevel,\n    rendererTraceEnabled = false,\n    rendererTraceMinLevel = 'debug',\n  } = options;\n\n  const container = options.container ?? getContainer();\n  const rendererTraceBatchReceiver = options.rendererTraceBatchReceiver\n    ?? getRendererTraceBatchReceiver();\n  const rendererTraceBatchEnabled = rendererTraceBatchReceiver !== null;\n  const rendererTraceBatchHost = new RendererTraceBatchHost(\n    rendererTraceBatchReceiver,\n  );\n\n  logger.info('runtime start', {\n    mode,\n    hasProvidedContainer: !!options.container,\n    controllersDir,\n    middlewareDir,\n    enableRendererLogBridge,\n    enableRendererTraceBridge,\n    traceMinLevel: traceMinLevel ?? 'debug',\n    rendererTraceEnabled,\n    rendererTraceMinLevel,\n    rendererTraceBatchEnabled,\n  });\n\n  const traceSettings: RuntimeTraceSettings = {\n    enableRendererLogBridge,\n    enableRendererTraceBridge,\n    traceMinLevel,\n    rendererTraceEnabled,\n    rendererTraceMinLevel,\n    rendererTraceBatchEnabled,\n  };\n  await configureRuntimeTracing(container, traceSettings);\n\n  const router = new WoodRouter({\n    container,\n    controllersDir,\n    middlewareDir,\n    mode,\n  });\n\n  registerRuntime(router);\n  logger.info('runtime registration complete');\n\n  router.validateControllers();\n  logger.info('runtime controller validation complete');\n\n  router.precompileSchemas();\n  logger.info('runtime schema pre-compilation complete');\n\n  registerReservedRuntimeHandlers(router, options, traceSettings, rendererTraceBatchHost);\n  registerRuntimeObservationBridges(ipcMain, traceSettings, options.resolveRendererTraceContext);\n\n  router.registerIpcHandlers(ipcMain);\n  logger.info('runtime ipc handlers registered', {\n    channelCount: router.getChannels().length,\n    enableRendererLogBridge,\n    enableRendererTraceBridge,\n  });\n\n  return { router };\n}\n\nasync function configureRuntimeTracing(\n  container: any,\n  settings: RuntimeTraceSettings,\n): Promise<void> {\n  if (settings.traceMinLevel) {\n    setMainTraceMinLevel(settings.traceMinLevel);\n  }\n  setRendererTraceMinLevel(settings.rendererTraceMinLevel);\n  if (typeof container.instance !== 'function') {\n    return;\n  }\n\n  const traceConfiguration = await container.instance(TraceProviderConfiguration);\n  traceConfiguration.configureRuntime('main');\n  if (settings.traceMinLevel) {\n    traceConfiguration.configureMinLevel(settings.traceMinLevel);\n  }\n}\n\nfunction registerReservedRuntimeHandlers(\n  router: WoodRouter,\n  options: RuntimeOptions,\n  settings: RuntimeTraceSettings,\n  rendererTraceBatchHost: RendererTraceBatchHost,\n): void {\n  router.registerReservedHandler('__load', requireRuntimeHandler('__load', 'onLoad', options.onLoad));\n  router.registerReservedHandler('__navigate', requireRuntimeHandler('__navigate', 'onNavigate', options.onNavigate));\n  router.registerReservedHandler('__window', requireRuntimeHandler('__window', 'onWindow', options.onWindow));\n  router.registerReservedHandler('__debug', requireRuntimeHandler('__debug', 'onDebug', options.onDebug));\n  router.registerReservedHandler(\n    '__contextMenu',\n    requireRuntimeHandler('__contextMenu', 'onContextMenu', options.onContextMenu),\n  );\n  router.registerReservedHandler('__woodConfig', async () => ({\n    rendererTraceEnabled: settings.rendererTraceEnabled,\n    rendererTraceMinLevel: settings.rendererTraceMinLevel,\n    rendererTraceBatchEnabled: settings.rendererTraceBatchEnabled,\n    appEnv: options.appEnv ?? await resolveWoodAppEnv(),\n  }));\n  router.registerReservedHandler('__traceBatch', async (data, event) => {\n    return rendererTraceBatchHost.receive(data, options.resolveRendererTraceContext?.(event) ?? {});\n  });\n}\n\nfunction registerRuntimeObservationBridges(\n  ipcMain: IpcMainLike,\n  settings: RuntimeTraceSettings,\n  resolveContext: RuntimeOptions['resolveRendererTraceContext'],\n): void {\n  if (settings.enableRendererLogBridge) {\n    registerRendererLogBridge(ipcMain);\n  }\n  ipcMain.removeAllListeners?.('__trace');\n  if (settings.enableRendererTraceBridge && settings.rendererTraceEnabled) {\n    registerRendererTraceBridge(ipcMain, resolveContext);\n  }\n}\n\nfunction requireRuntimeHandler(\n  channel: string,\n  optionName: string,\n  handler: RuntimeReservedHandler | undefined,\n): RuntimeReservedHandler {\n  return async (data, event) => {\n    if (!handler) {\n      throw new Error(`Reserved channel \"${channel}\" not configured. Provide runtime({ ${optionName} }).`);\n    }\n    return handler(data, event);\n  };\n}\n\nfunction registerRendererTraceBridge(\n  ipcMain: IpcMainLike,\n  resolveContext?: (event: unknown) => TraceRuntimeContext | undefined,\n): void {\n  ipcMain.removeAllListeners?.('__trace');\n\n  ipcMain.on('__trace', (event, rawPayload) => {\n    dispatchRendererTracePayload(rawPayload, resolveContext?.(event));\n  });\n\n  logger.info('renderer trace bridge registered (fire-and-forget)');\n}\n\nfunction registerRendererLogBridge(ipcMain: IpcMainLike): void {\n  const dispatcher = getRendererLogDispatcher();\n\n  ipcMain.removeAllListeners?.('__log');\n\n  ipcMain.on('__log', (_event, rawPayload) => {\n    const entry = coerceRendererLogPayload(rawPayload, null);\n    void dispatcher.dispatch(entry).then((result) => {\n      const typedResult = result as RendererLogDispatchResult;\n      if (!typedResult.ok) {\n        logger.warn('renderer log dispatch failed', {\n          logger: entry.logger,\n          messageLength: entry.message.length,\n          reason: typedResult.reason ?? null,\n          errorMessage: typedResult.errorMessage ?? null,\n        });\n      }\n    });\n  });\n\n  logger.info('renderer log bridge registered (fire-and-forget)');\n}\n"],"mappings":"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","names":[]}