@noego/wood 0.5.0 → 0.6.0

package/dist/runtime/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/runtime/index.ts"],"sourcesContent":["export { createWoodRoot, getContainer, clearContainerRegistryForTests } from './get_container.js';\nexport type { GetContainerOptions, CreateWoodRootOptions } from './get_container.js';\n\nexport {\n  getApplicationRoot,\n  setApplicationRoot,\n  clearApplicationRootForTests,\n} from './application_root.js';\n\nexport { runtime } from './runtime.js';\nexport type { RuntimeOptions, RuntimeResult, RegisterRuntimeRouter } from './runtime.js';\n\nexport {\n  getRendererLogDispatcher,\n  clearRendererLogDispatcherForTests,\n} from './renderer_log_dispatcher.js';\nexport type {\n  RendererLogLevel,\n  RendererLogEntry,\n  RendererLogCallback,\n  RendererLogDispatchResult,\n} from './renderer_log_dispatcher.js';\n\nexport {\n  clearRendererTraceBatchReceiverForTests,\n  getRendererTraceBatchReceiver,\n  setRendererTraceBatchReceiver,\n} from './renderer_trace_batch_receiver_registry.js';\n\nexport {\n  getRendererConfigExtension,\n  resolveRendererConfigExtension,\n  setRendererConfigExtension,\n} from './renderer_config_extension.js';\nexport type { RendererConfigExtension } from './renderer_config_extension.js';\n\nexport { dispatchRendererTracePayload } from '../tracing/index.js';\nexport type { TraceDispatchResult } from '../tracing/index.js';\n"],"mappings":"AAAA,SAAS,gBAAgB,cAAc,sCAAsC;AAG7E;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEP,SAAS,eAAe;AAGxB;AAAA,EACE;AAAA,EACA;AAAA,OACK;AAQP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAGP,SAAS,oCAAoC;","names":[]}
+{"version":3,"sources":["../../src/runtime/index.ts"],"sourcesContent":["export { createWoodRoot, getContainer, clearContainerRegistryForTests } from './get_container.js';\nexport type { GetContainerOptions, CreateWoodRootOptions } from './get_container.js';\n\nexport {\n  getApplicationRoot,\n  setApplicationRoot,\n  clearApplicationRootForTests,\n} from './application_root.js';\n\nexport { runtime } from './runtime.js';\nexport type { RuntimeOptions, RuntimeResult, RegisterRuntimeRouter } from './runtime.js';\n\nexport {\n  getRendererLogDispatcher,\n  RendererLogDispatcher,\n  clearRendererLogDispatcherForTests,\n} from './renderer_log_dispatcher.js';\nexport type {\n  RendererLogLevel,\n  RendererLogEntry,\n  RendererLogCallback,\n  RendererLogDispatchResult,\n} from './renderer_log_dispatcher.js';\n\nexport {\n  clearRendererTraceBatchReceiverForTests,\n  getRendererTraceBatchReceiver,\n  setRendererTraceBatchReceiver,\n} from './renderer_trace_batch_receiver_registry.js';\n\nexport {\n  getRendererConfigExtension,\n  resolveRendererConfigExtension,\n  setRendererConfigExtension,\n} from './renderer_config_extension.js';\nexport type { RendererConfigExtension } from './renderer_config_extension.js';\n\nexport { dispatchRendererTracePayload } from '../tracing/index.js';\nexport type { TraceDispatchResult } from '../tracing/index.js';\n\nexport { installWoodRuntime, WoodRouter, SchemaValidator, MiddlewareResolver, ControllerResolver } from './runtime_module.js';\nexport type { WoodRuntimeModuleOptions } from './runtime_module.js';\n"],"mappings":"AAAA,SAAS,gBAAgB,cAAc,sCAAsC;AAG7E;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEP,SAAS,eAAe;AAGxB;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAQP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAGP,SAAS,oCAAoC;AAG7C,SAAS,oBAAoB,YAAY,iBAAiB,oBAAoB,0BAA0B;","names":[]}

package/dist/runtime/renderer_config_extension.cjs

@@ -30,8 +30,7 @@ function setRendererConfigExtension(extension) {
 function getRendererConfigExtension() {
   return globalThis[EXTENSION_SYMBOL] ?? null;
 }
-async function resolveRendererConfigExtension() {
-  const extension = getRendererConfigExtension();
+async function resolveRendererConfigExtension(extension = getRendererConfigExtension()) {
   if (!extension) return {};
   try {
     const value = await extension();

package/dist/runtime/renderer_config_extension.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/runtime/renderer_config_extension.ts"],"sourcesContent":["const EXTENSION_SYMBOL = Symbol.for('@noego/wood.runtime.renderer-config-extension');\n\n/**\n * App-supplied provider of extra fields merged into the `__woodConfig` payload\n * the renderer fetches at boot. Lets the main process hand renderers boot-time\n * facts Wood itself knows nothing about — e.g. the loopback port and per-boot\n * token of an external log sink — without a new IPC channel or preload method.\n *\n * Reserved Wood keys (rendererTrace*, appEnv) always win over extension keys.\n */\nexport type RendererConfigExtension = () =>\n  | Readonly<Record<string, unknown>>\n  | Promise<Readonly<Record<string, unknown>>>;\n\ntype GlobalWithExtension = typeof globalThis & {\n  [EXTENSION_SYMBOL]?: RendererConfigExtension | null;\n};\n\nexport function setRendererConfigExtension(extension: RendererConfigExtension | null): void {\n  (globalThis as GlobalWithExtension)[EXTENSION_SYMBOL] = extension;\n}\n\nexport function getRendererConfigExtension(): RendererConfigExtension | null {\n  return (globalThis as GlobalWithExtension)[EXTENSION_SYMBOL] ?? null;\n}\n\n/**\n * Resolves the extension fields for one `__woodConfig` request. A throwing or\n * malformed extension yields `{}` — config delivery must never fail the\n * renderer boot because of an app-side provider.\n */\nexport async function resolveRendererConfigExtension(): Promise<Record<string, unknown>> {\n  const extension = getRendererConfigExtension();\n  if (!extension) return {};\n  try {\n    const value = await extension();\n    if (typeof value !== 'object' || value === null || Array.isArray(value)) return {};\n    return { ...value };\n  } catch {\n    return {};\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAAM,mBAAmB,uBAAO,IAAI,+CAA+C;AAkB5E,SAAS,2BAA2B,WAAiD;AAC1F,EAAC,WAAmC,gBAAgB,IAAI;AAC1D;AAEO,SAAS,6BAA6D;AAC3E,SAAQ,WAAmC,gBAAgB,KAAK;AAClE;AAOA,eAAsB,iCAAmE;AACvF,QAAM,YAAY,2BAA2B;AAC7C,MAAI,CAAC,UAAW,QAAO,CAAC;AACxB,MAAI;AACF,UAAM,QAAQ,MAAM,UAAU;AAC9B,QAAI,OAAO,UAAU,YAAY,UAAU,QAAQ,MAAM,QAAQ,KAAK,EAAG,QAAO,CAAC;AACjF,WAAO,EAAE,GAAG,MAAM;AAAA,EACpB,QAAQ;AACN,WAAO,CAAC;AAAA,EACV;AACF;","names":[]}
+{"version":3,"sources":["../../src/runtime/renderer_config_extension.ts"],"sourcesContent":["const EXTENSION_SYMBOL = Symbol.for('@noego/wood.runtime.renderer-config-extension');\n\n/**\n * App-supplied provider of extra fields merged into the `__woodConfig` payload\n * the renderer fetches at boot. Lets the main process hand renderers boot-time\n * facts Wood itself knows nothing about — e.g. the loopback port and per-boot\n * token of an external log sink — without a new IPC channel or preload method.\n *\n * Reserved Wood keys (rendererTrace*, appEnv) always win over extension keys.\n */\nexport type RendererConfigExtension = () =>\n  | Readonly<Record<string, unknown>>\n  | Promise<Readonly<Record<string, unknown>>>;\n\ntype GlobalWithExtension = typeof globalThis & {\n  [EXTENSION_SYMBOL]?: RendererConfigExtension | null;\n};\n\nexport function setRendererConfigExtension(extension: RendererConfigExtension | null): void {\n  (globalThis as GlobalWithExtension)[EXTENSION_SYMBOL] = extension;\n}\n\nexport function getRendererConfigExtension(): RendererConfigExtension | null {\n  return (globalThis as GlobalWithExtension)[EXTENSION_SYMBOL] ?? null;\n}\n\n/**\n * Resolves the extension fields for one `__woodConfig` request. A throwing or\n * malformed extension yields `{}` — config delivery must never fail the\n * renderer boot because of an app-side provider.\n */\nexport async function resolveRendererConfigExtension(extension: RendererConfigExtension | null = getRendererConfigExtension()): Promise<Record<string, unknown>> {\n  if (!extension) return {};\n  try {\n    const value = await extension();\n    if (typeof value !== 'object' || value === null || Array.isArray(value)) return {};\n    return { ...value };\n  } catch {\n    return {};\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAAM,mBAAmB,uBAAO,IAAI,+CAA+C;AAkB5E,SAAS,2BAA2B,WAAiD;AAC1F,EAAC,WAAmC,gBAAgB,IAAI;AAC1D;AAEO,SAAS,6BAA6D;AAC3E,SAAQ,WAAmC,gBAAgB,KAAK;AAClE;AAOA,eAAsB,+BAA+B,YAA4C,2BAA2B,GAAqC;AAC/J,MAAI,CAAC,UAAW,QAAO,CAAC;AACxB,MAAI;AACF,UAAM,QAAQ,MAAM,UAAU;AAC9B,QAAI,OAAO,UAAU,YAAY,UAAU,QAAQ,MAAM,QAAQ,KAAK,EAAG,QAAO,CAAC;AACjF,WAAO,EAAE,GAAG,MAAM;AAAA,EACpB,QAAQ;AACN,WAAO,CAAC;AAAA,EACV;AACF;","names":[]}

package/dist/runtime/renderer_config_extension.d.cts

@@ -14,6 +14,6 @@ declare function getRendererConfigExtension(): RendererConfigExtension | null;
  * malformed extension yields `{}` — config delivery must never fail the
  * renderer boot because of an app-side provider.
  */
-declare function resolveRendererConfigExtension(): Promise<Record<string, unknown>>;
+declare function resolveRendererConfigExtension(extension?: RendererConfigExtension | null): Promise<Record<string, unknown>>;
 
 export { type RendererConfigExtension, getRendererConfigExtension, resolveRendererConfigExtension, setRendererConfigExtension };

package/dist/runtime/renderer_config_extension.d.ts

@@ -14,6 +14,6 @@ declare function getRendererConfigExtension(): RendererConfigExtension | null;
  * malformed extension yields `{}` — config delivery must never fail the
  * renderer boot because of an app-side provider.
  */
-declare function resolveRendererConfigExtension(): Promise<Record<string, unknown>>;
+declare function resolveRendererConfigExtension(extension?: RendererConfigExtension | null): Promise<Record<string, unknown>>;
 
 export { type RendererConfigExtension, getRendererConfigExtension, resolveRendererConfigExtension, setRendererConfigExtension };

package/dist/runtime/renderer_config_extension.js

@@ -5,8 +5,7 @@ function setRendererConfigExtension(extension) {
 function getRendererConfigExtension() {
   return globalThis[EXTENSION_SYMBOL] ?? null;
 }
-async function resolveRendererConfigExtension() {
-  const extension = getRendererConfigExtension();
+async function resolveRendererConfigExtension(extension = getRendererConfigExtension()) {
   if (!extension) return {};
   try {
     const value = await extension();

package/dist/runtime/renderer_config_extension.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/runtime/renderer_config_extension.ts"],"sourcesContent":["const EXTENSION_SYMBOL = Symbol.for('@noego/wood.runtime.renderer-config-extension');\n\n/**\n * App-supplied provider of extra fields merged into the `__woodConfig` payload\n * the renderer fetches at boot. Lets the main process hand renderers boot-time\n * facts Wood itself knows nothing about — e.g. the loopback port and per-boot\n * token of an external log sink — without a new IPC channel or preload method.\n *\n * Reserved Wood keys (rendererTrace*, appEnv) always win over extension keys.\n */\nexport type RendererConfigExtension = () =>\n  | Readonly<Record<string, unknown>>\n  | Promise<Readonly<Record<string, unknown>>>;\n\ntype GlobalWithExtension = typeof globalThis & {\n  [EXTENSION_SYMBOL]?: RendererConfigExtension | null;\n};\n\nexport function setRendererConfigExtension(extension: RendererConfigExtension | null): void {\n  (globalThis as GlobalWithExtension)[EXTENSION_SYMBOL] = extension;\n}\n\nexport function getRendererConfigExtension(): RendererConfigExtension | null {\n  return (globalThis as GlobalWithExtension)[EXTENSION_SYMBOL] ?? null;\n}\n\n/**\n * Resolves the extension fields for one `__woodConfig` request. A throwing or\n * malformed extension yields `{}` — config delivery must never fail the\n * renderer boot because of an app-side provider.\n */\nexport async function resolveRendererConfigExtension(): Promise<Record<string, unknown>> {\n  const extension = getRendererConfigExtension();\n  if (!extension) return {};\n  try {\n    const value = await extension();\n    if (typeof value !== 'object' || value === null || Array.isArray(value)) return {};\n    return { ...value };\n  } catch {\n    return {};\n  }\n}\n"],"mappings":"AAAA,MAAM,mBAAmB,uBAAO,IAAI,+CAA+C;AAkB5E,SAAS,2BAA2B,WAAiD;AAC1F,EAAC,WAAmC,gBAAgB,IAAI;AAC1D;AAEO,SAAS,6BAA6D;AAC3E,SAAQ,WAAmC,gBAAgB,KAAK;AAClE;AAOA,eAAsB,iCAAmE;AACvF,QAAM,YAAY,2BAA2B;AAC7C,MAAI,CAAC,UAAW,QAAO,CAAC;AACxB,MAAI;AACF,UAAM,QAAQ,MAAM,UAAU;AAC9B,QAAI,OAAO,UAAU,YAAY,UAAU,QAAQ,MAAM,QAAQ,KAAK,EAAG,QAAO,CAAC;AACjF,WAAO,EAAE,GAAG,MAAM;AAAA,EACpB,QAAQ;AACN,WAAO,CAAC;AAAA,EACV;AACF;","names":[]}
+{"version":3,"sources":["../../src/runtime/renderer_config_extension.ts"],"sourcesContent":["const EXTENSION_SYMBOL = Symbol.for('@noego/wood.runtime.renderer-config-extension');\n\n/**\n * App-supplied provider of extra fields merged into the `__woodConfig` payload\n * the renderer fetches at boot. Lets the main process hand renderers boot-time\n * facts Wood itself knows nothing about — e.g. the loopback port and per-boot\n * token of an external log sink — without a new IPC channel or preload method.\n *\n * Reserved Wood keys (rendererTrace*, appEnv) always win over extension keys.\n */\nexport type RendererConfigExtension = () =>\n  | Readonly<Record<string, unknown>>\n  | Promise<Readonly<Record<string, unknown>>>;\n\ntype GlobalWithExtension = typeof globalThis & {\n  [EXTENSION_SYMBOL]?: RendererConfigExtension | null;\n};\n\nexport function setRendererConfigExtension(extension: RendererConfigExtension | null): void {\n  (globalThis as GlobalWithExtension)[EXTENSION_SYMBOL] = extension;\n}\n\nexport function getRendererConfigExtension(): RendererConfigExtension | null {\n  return (globalThis as GlobalWithExtension)[EXTENSION_SYMBOL] ?? null;\n}\n\n/**\n * Resolves the extension fields for one `__woodConfig` request. A throwing or\n * malformed extension yields `{}` — config delivery must never fail the\n * renderer boot because of an app-side provider.\n */\nexport async function resolveRendererConfigExtension(extension: RendererConfigExtension | null = getRendererConfigExtension()): Promise<Record<string, unknown>> {\n  if (!extension) return {};\n  try {\n    const value = await extension();\n    if (typeof value !== 'object' || value === null || Array.isArray(value)) return {};\n    return { ...value };\n  } catch {\n    return {};\n  }\n}\n"],"mappings":"AAAA,MAAM,mBAAmB,uBAAO,IAAI,+CAA+C;AAkB5E,SAAS,2BAA2B,WAAiD;AAC1F,EAAC,WAAmC,gBAAgB,IAAI;AAC1D;AAEO,SAAS,6BAA6D;AAC3E,SAAQ,WAAmC,gBAAgB,KAAK;AAClE;AAOA,eAAsB,+BAA+B,YAA4C,2BAA2B,GAAqC;AAC/J,MAAI,CAAC,UAAW,QAAO,CAAC;AACxB,MAAI;AACF,UAAM,QAAQ,MAAM,UAAU;AAC9B,QAAI,OAAO,UAAU,YAAY,UAAU,QAAQ,MAAM,QAAQ,KAAK,EAAG,QAAO,CAAC;AACjF,WAAO,EAAE,GAAG,MAAM;AAAA,EACpB,QAAQ;AACN,WAAO,CAAC;AAAA,EACV;AACF;","names":[]}

package/dist/runtime/renderer_log_dispatcher.cjs

@@ -18,6 +18,7 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var renderer_log_dispatcher_exports = {};
 __export(renderer_log_dispatcher_exports, {
+  RendererLogDispatcher: () => RendererLogDispatcher,
   clearRendererLogDispatcherForTests: () => clearRendererLogDispatcherForTests,
   getRendererLogDispatcher: () => getRendererLogDispatcher
 });
@@ -73,6 +74,7 @@ function clearRendererLogDispatcherForTests() {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  RendererLogDispatcher,
   clearRendererLogDispatcherForTests,
   getRendererLogDispatcher
 });

package/dist/runtime/renderer_log_dispatcher.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/runtime/renderer_log_dispatcher.ts"],"sourcesContent":["const RENDERER_LOG_DISPATCHER_SYMBOL = Symbol.for('@noego/wood.runtime.renderer-log-dispatcher');\n\nexport type RendererLogLevel = 'debug' | 'info' | 'warn' | 'error' | (string & {});\n\nexport type RendererLogEntry = {\n  level: RendererLogLevel;\n  logger: string;\n  message: string;\n  context?: unknown;\n  timestamp: string;\n  senderId?: number | null;\n};\n\nexport type RendererLogCallback = (entry: RendererLogEntry) => void | Promise<void>;\n\nexport type RendererLogDispatchResult = {\n  ok: boolean;\n  forwarded: boolean;\n  configured: boolean;\n  reason?: 'unconfigured' | 'callback-error';\n  errorMessage?: string;\n};\n\nclass RendererLogDispatcher {\n  private callback: RendererLogCallback | null = null;\n\n  setCallback(callback: RendererLogCallback | null): void {\n    this.callback = callback;\n  }\n\n  getCallback(): RendererLogCallback | null {\n    return this.callback;\n  }\n\n  async dispatch(entry: RendererLogEntry): Promise<RendererLogDispatchResult> {\n    if (!this.callback) {\n      return {\n        ok: true,\n        forwarded: false,\n        configured: false,\n        reason: 'unconfigured',\n      };\n    }\n\n    try {\n      await this.callback(entry);\n      return {\n        ok: true,\n        forwarded: true,\n        configured: true,\n      };\n    } catch (error) {\n      return {\n        ok: false,\n        forwarded: false,\n        configured: true,\n        reason: 'callback-error',\n        errorMessage: error instanceof Error ? error.message : String(error),\n      };\n    }\n  }\n}\n\ntype GlobalWithRendererLogDispatcher = typeof globalThis & {\n  [RENDERER_LOG_DISPATCHER_SYMBOL]?: RendererLogDispatcher;\n};\n\nexport function getRendererLogDispatcher(): RendererLogDispatcher {\n  const globalObj = globalThis as GlobalWithRendererLogDispatcher;\n  if (!globalObj[RENDERER_LOG_DISPATCHER_SYMBOL]) {\n    globalObj[RENDERER_LOG_DISPATCHER_SYMBOL] = new RendererLogDispatcher();\n  }\n  return globalObj[RENDERER_LOG_DISPATCHER_SYMBOL] as RendererLogDispatcher;\n}\n\nexport function clearRendererLogDispatcherForTests(): void {\n  const globalObj = globalThis as GlobalWithRendererLogDispatcher;\n  delete globalObj[RENDERER_LOG_DISPATCHER_SYMBOL];\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAAM,iCAAiC,uBAAO,IAAI,6CAA6C;AAuB/F,MAAM,sBAAsB;AAAA,EAA5B;AACE,SAAQ,WAAuC;AAAA;AAAA,EAE/C,YAAY,UAA4C;AACtD,SAAK,WAAW;AAAA,EAClB;AAAA,EAEA,cAA0C;AACxC,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,MAAM,SAAS,OAA6D;AAC1E,QAAI,CAAC,KAAK,UAAU;AAClB,aAAO;AAAA,QACL,IAAI;AAAA,QACJ,WAAW;AAAA,QACX,YAAY;AAAA,QACZ,QAAQ;AAAA,MACV;AAAA,IACF;AAEA,QAAI;AACF,YAAM,KAAK,SAAS,KAAK;AACzB,aAAO;AAAA,QACL,IAAI;AAAA,QACJ,WAAW;AAAA,QACX,YAAY;AAAA,MACd;AAAA,IACF,SAAS,OAAO;AACd,aAAO;AAAA,QACL,IAAI;AAAA,QACJ,WAAW;AAAA,QACX,YAAY;AAAA,QACZ,QAAQ;AAAA,QACR,cAAc,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAAA,MACrE;AAAA,IACF;AAAA,EACF;AACF;AAMO,SAAS,2BAAkD;AAChE,QAAM,YAAY;AAClB,MAAI,CAAC,UAAU,8BAA8B,GAAG;AAC9C,cAAU,8BAA8B,IAAI,IAAI,sBAAsB;AAAA,EACxE;AACA,SAAO,UAAU,8BAA8B;AACjD;AAEO,SAAS,qCAA2C;AACzD,QAAM,YAAY;AAClB,SAAO,UAAU,8BAA8B;AACjD;","names":[]}
+{"version":3,"sources":["../../src/runtime/renderer_log_dispatcher.ts"],"sourcesContent":["const RENDERER_LOG_DISPATCHER_SYMBOL = Symbol.for('@noego/wood.runtime.renderer-log-dispatcher');\n\nexport type RendererLogLevel = 'debug' | 'info' | 'warn' | 'error' | (string & {});\n\nexport type RendererLogEntry = {\n  level: RendererLogLevel;\n  logger: string;\n  message: string;\n  context?: unknown;\n  timestamp: string;\n  senderId?: number | null;\n};\n\nexport type RendererLogCallback = (entry: RendererLogEntry) => void | Promise<void>;\n\nexport type RendererLogDispatchResult = {\n  ok: boolean;\n  forwarded: boolean;\n  configured: boolean;\n  reason?: 'unconfigured' | 'callback-error';\n  errorMessage?: string;\n};\n\nexport class RendererLogDispatcher {\n  private callback: RendererLogCallback | null = null;\n\n  setCallback(callback: RendererLogCallback | null): void {\n    this.callback = callback;\n  }\n\n  getCallback(): RendererLogCallback | null {\n    return this.callback;\n  }\n\n  async dispatch(entry: RendererLogEntry): Promise<RendererLogDispatchResult> {\n    if (!this.callback) {\n      return {\n        ok: true,\n        forwarded: false,\n        configured: false,\n        reason: 'unconfigured',\n      };\n    }\n\n    try {\n      await this.callback(entry);\n      return {\n        ok: true,\n        forwarded: true,\n        configured: true,\n      };\n    } catch (error) {\n      return {\n        ok: false,\n        forwarded: false,\n        configured: true,\n        reason: 'callback-error',\n        errorMessage: error instanceof Error ? error.message : String(error),\n      };\n    }\n  }\n}\n\ntype GlobalWithRendererLogDispatcher = typeof globalThis & {\n  [RENDERER_LOG_DISPATCHER_SYMBOL]?: RendererLogDispatcher;\n};\n\nexport function getRendererLogDispatcher(): RendererLogDispatcher {\n  const globalObj = globalThis as GlobalWithRendererLogDispatcher;\n  if (!globalObj[RENDERER_LOG_DISPATCHER_SYMBOL]) {\n    globalObj[RENDERER_LOG_DISPATCHER_SYMBOL] = new RendererLogDispatcher();\n  }\n  return globalObj[RENDERER_LOG_DISPATCHER_SYMBOL] as RendererLogDispatcher;\n}\n\nexport function clearRendererLogDispatcherForTests(): void {\n  const globalObj = globalThis as GlobalWithRendererLogDispatcher;\n  delete globalObj[RENDERER_LOG_DISPATCHER_SYMBOL];\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAAM,iCAAiC,uBAAO,IAAI,6CAA6C;AAuBxF,MAAM,sBAAsB;AAAA,EAA5B;AACL,SAAQ,WAAuC;AAAA;AAAA,EAE/C,YAAY,UAA4C;AACtD,SAAK,WAAW;AAAA,EAClB;AAAA,EAEA,cAA0C;AACxC,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,MAAM,SAAS,OAA6D;AAC1E,QAAI,CAAC,KAAK,UAAU;AAClB,aAAO;AAAA,QACL,IAAI;AAAA,QACJ,WAAW;AAAA,QACX,YAAY;AAAA,QACZ,QAAQ;AAAA,MACV;AAAA,IACF;AAEA,QAAI;AACF,YAAM,KAAK,SAAS,KAAK;AACzB,aAAO;AAAA,QACL,IAAI;AAAA,QACJ,WAAW;AAAA,QACX,YAAY;AAAA,MACd;AAAA,IACF,SAAS,OAAO;AACd,aAAO;AAAA,QACL,IAAI;AAAA,QACJ,WAAW;AAAA,QACX,YAAY;AAAA,QACZ,QAAQ;AAAA,QACR,cAAc,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAAA,MACrE;AAAA,IACF;AAAA,EACF;AACF;AAMO,SAAS,2BAAkD;AAChE,QAAM,YAAY;AAClB,MAAI,CAAC,UAAU,8BAA8B,GAAG;AAC9C,cAAU,8BAA8B,IAAI,IAAI,sBAAsB;AAAA,EACxE;AACA,SAAO,UAAU,8BAA8B;AACjD;AAEO,SAAS,qCAA2C;AACzD,QAAM,YAAY;AAClB,SAAO,UAAU,8BAA8B;AACjD;","names":[]}

package/dist/runtime/renderer_log_dispatcher.d.cts

@@ -24,4 +24,4 @@ declare class RendererLogDispatcher {
 declare function getRendererLogDispatcher(): RendererLogDispatcher;
 declare function clearRendererLogDispatcherForTests(): void;
 
-export { type RendererLogCallback, type RendererLogDispatchResult, type RendererLogEntry, type RendererLogLevel, clearRendererLogDispatcherForTests, getRendererLogDispatcher };
+export { type RendererLogCallback, type RendererLogDispatchResult, RendererLogDispatcher, type RendererLogEntry, type RendererLogLevel, clearRendererLogDispatcherForTests, getRendererLogDispatcher };

package/dist/runtime/renderer_log_dispatcher.d.ts

@@ -24,4 +24,4 @@ declare class RendererLogDispatcher {
 declare function getRendererLogDispatcher(): RendererLogDispatcher;
 declare function clearRendererLogDispatcherForTests(): void;
 
-export { type RendererLogCallback, type RendererLogDispatchResult, type RendererLogEntry, type RendererLogLevel, clearRendererLogDispatcherForTests, getRendererLogDispatcher };
+export { type RendererLogCallback, type RendererLogDispatchResult, RendererLogDispatcher, type RendererLogEntry, type RendererLogLevel, clearRendererLogDispatcherForTests, getRendererLogDispatcher };

package/dist/runtime/renderer_log_dispatcher.js

@@ -48,6 +48,7 @@ function clearRendererLogDispatcherForTests() {
   delete globalObj[RENDERER_LOG_DISPATCHER_SYMBOL];
 }
 export {
+  RendererLogDispatcher,
   clearRendererLogDispatcherForTests,
   getRendererLogDispatcher
 };

package/dist/runtime/renderer_log_dispatcher.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/runtime/renderer_log_dispatcher.ts"],"sourcesContent":["const RENDERER_LOG_DISPATCHER_SYMBOL = Symbol.for('@noego/wood.runtime.renderer-log-dispatcher');\n\nexport type RendererLogLevel = 'debug' | 'info' | 'warn' | 'error' | (string & {});\n\nexport type RendererLogEntry = {\n  level: RendererLogLevel;\n  logger: string;\n  message: string;\n  context?: unknown;\n  timestamp: string;\n  senderId?: number | null;\n};\n\nexport type RendererLogCallback = (entry: RendererLogEntry) => void | Promise<void>;\n\nexport type RendererLogDispatchResult = {\n  ok: boolean;\n  forwarded: boolean;\n  configured: boolean;\n  reason?: 'unconfigured' | 'callback-error';\n  errorMessage?: string;\n};\n\nclass RendererLogDispatcher {\n  private callback: RendererLogCallback | null = null;\n\n  setCallback(callback: RendererLogCallback | null): void {\n    this.callback = callback;\n  }\n\n  getCallback(): RendererLogCallback | null {\n    return this.callback;\n  }\n\n  async dispatch(entry: RendererLogEntry): Promise<RendererLogDispatchResult> {\n    if (!this.callback) {\n      return {\n        ok: true,\n        forwarded: false,\n        configured: false,\n        reason: 'unconfigured',\n      };\n    }\n\n    try {\n      await this.callback(entry);\n      return {\n        ok: true,\n        forwarded: true,\n        configured: true,\n      };\n    } catch (error) {\n      return {\n        ok: false,\n        forwarded: false,\n        configured: true,\n        reason: 'callback-error',\n        errorMessage: error instanceof Error ? error.message : String(error),\n      };\n    }\n  }\n}\n\ntype GlobalWithRendererLogDispatcher = typeof globalThis & {\n  [RENDERER_LOG_DISPATCHER_SYMBOL]?: RendererLogDispatcher;\n};\n\nexport function getRendererLogDispatcher(): RendererLogDispatcher {\n  const globalObj = globalThis as GlobalWithRendererLogDispatcher;\n  if (!globalObj[RENDERER_LOG_DISPATCHER_SYMBOL]) {\n    globalObj[RENDERER_LOG_DISPATCHER_SYMBOL] = new RendererLogDispatcher();\n  }\n  return globalObj[RENDERER_LOG_DISPATCHER_SYMBOL] as RendererLogDispatcher;\n}\n\nexport function clearRendererLogDispatcherForTests(): void {\n  const globalObj = globalThis as GlobalWithRendererLogDispatcher;\n  delete globalObj[RENDERER_LOG_DISPATCHER_SYMBOL];\n}\n"],"mappings":"AAAA,MAAM,iCAAiC,uBAAO,IAAI,6CAA6C;AAuB/F,MAAM,sBAAsB;AAAA,EAA5B;AACE,SAAQ,WAAuC;AAAA;AAAA,EAE/C,YAAY,UAA4C;AACtD,SAAK,WAAW;AAAA,EAClB;AAAA,EAEA,cAA0C;AACxC,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,MAAM,SAAS,OAA6D;AAC1E,QAAI,CAAC,KAAK,UAAU;AAClB,aAAO;AAAA,QACL,IAAI;AAAA,QACJ,WAAW;AAAA,QACX,YAAY;AAAA,QACZ,QAAQ;AAAA,MACV;AAAA,IACF;AAEA,QAAI;AACF,YAAM,KAAK,SAAS,KAAK;AACzB,aAAO;AAAA,QACL,IAAI;AAAA,QACJ,WAAW;AAAA,QACX,YAAY;AAAA,MACd;AAAA,IACF,SAAS,OAAO;AACd,aAAO;AAAA,QACL,IAAI;AAAA,QACJ,WAAW;AAAA,QACX,YAAY;AAAA,QACZ,QAAQ;AAAA,QACR,cAAc,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAAA,MACrE;AAAA,IACF;AAAA,EACF;AACF;AAMO,SAAS,2BAAkD;AAChE,QAAM,YAAY;AAClB,MAAI,CAAC,UAAU,8BAA8B,GAAG;AAC9C,cAAU,8BAA8B,IAAI,IAAI,sBAAsB;AAAA,EACxE;AACA,SAAO,UAAU,8BAA8B;AACjD;AAEO,SAAS,qCAA2C;AACzD,QAAM,YAAY;AAClB,SAAO,UAAU,8BAA8B;AACjD;","names":[]}
+{"version":3,"sources":["../../src/runtime/renderer_log_dispatcher.ts"],"sourcesContent":["const RENDERER_LOG_DISPATCHER_SYMBOL = Symbol.for('@noego/wood.runtime.renderer-log-dispatcher');\n\nexport type RendererLogLevel = 'debug' | 'info' | 'warn' | 'error' | (string & {});\n\nexport type RendererLogEntry = {\n  level: RendererLogLevel;\n  logger: string;\n  message: string;\n  context?: unknown;\n  timestamp: string;\n  senderId?: number | null;\n};\n\nexport type RendererLogCallback = (entry: RendererLogEntry) => void | Promise<void>;\n\nexport type RendererLogDispatchResult = {\n  ok: boolean;\n  forwarded: boolean;\n  configured: boolean;\n  reason?: 'unconfigured' | 'callback-error';\n  errorMessage?: string;\n};\n\nexport class RendererLogDispatcher {\n  private callback: RendererLogCallback | null = null;\n\n  setCallback(callback: RendererLogCallback | null): void {\n    this.callback = callback;\n  }\n\n  getCallback(): RendererLogCallback | null {\n    return this.callback;\n  }\n\n  async dispatch(entry: RendererLogEntry): Promise<RendererLogDispatchResult> {\n    if (!this.callback) {\n      return {\n        ok: true,\n        forwarded: false,\n        configured: false,\n        reason: 'unconfigured',\n      };\n    }\n\n    try {\n      await this.callback(entry);\n      return {\n        ok: true,\n        forwarded: true,\n        configured: true,\n      };\n    } catch (error) {\n      return {\n        ok: false,\n        forwarded: false,\n        configured: true,\n        reason: 'callback-error',\n        errorMessage: error instanceof Error ? error.message : String(error),\n      };\n    }\n  }\n}\n\ntype GlobalWithRendererLogDispatcher = typeof globalThis & {\n  [RENDERER_LOG_DISPATCHER_SYMBOL]?: RendererLogDispatcher;\n};\n\nexport function getRendererLogDispatcher(): RendererLogDispatcher {\n  const globalObj = globalThis as GlobalWithRendererLogDispatcher;\n  if (!globalObj[RENDERER_LOG_DISPATCHER_SYMBOL]) {\n    globalObj[RENDERER_LOG_DISPATCHER_SYMBOL] = new RendererLogDispatcher();\n  }\n  return globalObj[RENDERER_LOG_DISPATCHER_SYMBOL] as RendererLogDispatcher;\n}\n\nexport function clearRendererLogDispatcherForTests(): void {\n  const globalObj = globalThis as GlobalWithRendererLogDispatcher;\n  delete globalObj[RENDERER_LOG_DISPATCHER_SYMBOL];\n}\n"],"mappings":"AAAA,MAAM,iCAAiC,uBAAO,IAAI,6CAA6C;AAuBxF,MAAM,sBAAsB;AAAA,EAA5B;AACL,SAAQ,WAAuC;AAAA;AAAA,EAE/C,YAAY,UAA4C;AACtD,SAAK,WAAW;AAAA,EAClB;AAAA,EAEA,cAA0C;AACxC,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,MAAM,SAAS,OAA6D;AAC1E,QAAI,CAAC,KAAK,UAAU;AAClB,aAAO;AAAA,QACL,IAAI;AAAA,QACJ,WAAW;AAAA,QACX,YAAY;AAAA,QACZ,QAAQ;AAAA,MACV;AAAA,IACF;AAEA,QAAI;AACF,YAAM,KAAK,SAAS,KAAK;AACzB,aAAO;AAAA,QACL,IAAI;AAAA,QACJ,WAAW;AAAA,QACX,YAAY;AAAA,MACd;AAAA,IACF,SAAS,OAAO;AACd,aAAO;AAAA,QACL,IAAI;AAAA,QACJ,WAAW;AAAA,QACX,YAAY;AAAA,QACZ,QAAQ;AAAA,QACR,cAAc,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAAA,MACrE;AAAA,IACF;AAAA,EACF;AACF;AAMO,SAAS,2BAAkD;AAChE,QAAM,YAAY;AAClB,MAAI,CAAC,UAAU,8BAA8B,GAAG;AAC9C,cAAU,8BAA8B,IAAI,IAAI,sBAAsB;AAAA,EACxE;AACA,SAAO,UAAU,8BAA8B;AACjD;AAEO,SAAS,qCAA2C;AACzD,QAAM,YAAY;AAClB,SAAO,UAAU,8BAA8B;AACjD;","names":[]}

package/dist/runtime/runtime.cjs

@@ -21,15 +21,17 @@ __export(runtime_exports, {
   runtime: () => runtime
 });
 module.exports = __toCommonJS(runtime_exports);
+var import_renderer_trace_batch_receiver_registry = require("./renderer_trace_batch_receiver_registry.js");
 var import_logger = require("@noego/logger");
 var import_wood_router = require("../router/wood_router.cjs");
 var import_get_container = require("./get_container.cjs");
+var import_ioc = require("@noego/ioc");
+var import_runtime_module = require("./runtime_module.js");
 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_log_batch_receiver = require("./renderer_log_batch_receiver.js");
 var import_renderer_config_extension = require("./renderer_config_extension.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) {
@@ -55,7 +57,6 @@ function coerceRendererLogPayload(rawPayload, event) {
 }
 async function runtime(options) {
   const {
-    ipcMain,
     registerRuntime,
     controllersDir,
     middlewareDir,
@@ -66,60 +67,110 @@ async function runtime(options) {
     rendererTraceEnabled = false,
     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 container = options.container ?? (0, import_get_container.createWoodRoot)();
+  const rendererTraceBatchReceiver = options.rendererTraceBatchReceiver ?? (options.legacyGlobals ? (0, import_renderer_trace_batch_receiver_registry.getRendererTraceBatchReceiver)() : null);
   const rendererTraceBatchEnabled = rendererTraceBatchReceiver !== null;
-  const rendererTraceBatchHost = new import_tracing.RendererTraceBatchHost(
-    rendererTraceBatchReceiver
-  );
-  logger.info("runtime start", {
-    mode,
-    hasProvidedContainer: !!options.container,
-    controllersDir,
-    middlewareDir,
-    enableRendererLogBridge,
-    enableRendererTraceBridge,
-    traceMinLevel: traceMinLevel ?? "debug",
-    rendererTraceEnabled,
-    rendererTraceMinLevel,
-    rendererTraceBatchEnabled
-  });
-  const traceSettings = {
-    enableRendererLogBridge,
-    enableRendererTraceBridge,
-    traceMinLevel,
-    rendererTraceEnabled,
-    rendererTraceMinLevel,
-    rendererTraceBatchEnabled
+  const handlers = [];
+  const listeners = [];
+  let router;
+  let closing;
+  const dispose = (timeoutMs) => closing ?? (closing = (async () => {
+    const errors = [];
+    for (const channel of handlers.splice(0)) {
+      try {
+        options.ipcMain.removeHandler?.(channel);
+      } catch (error) {
+        errors.push(error);
+      }
+    }
+    for (const [channel, listener] of listeners.splice(0)) {
+      try {
+        if (options.ipcMain.removeListener) options.ipcMain.removeListener(channel, listener);
+        else options.ipcMain.removeAllListeners?.(channel);
+      } catch (error) {
+        errors.push(error);
+      }
+    }
+    let drained = true;
+    try {
+      await router?.dispose(timeoutMs);
+    } catch (error) {
+      drained = false;
+      errors.push(error);
+    }
+    if (!options.container && drained) {
+      try {
+        await import_ioc.ExecutionContext.run(container, () => container.dispose());
+      } catch (error) {
+        errors.push(error);
+      }
+    }
+    if (errors.length) throw Object.assign(new Error("Wood runtime cleanup failed"), { errors });
+  })().catch((error) => {
+    closing = void 0;
+    throw error;
+  }));
+  const ipcMain = {
+    handle(channel, handler) {
+      options.ipcMain.handle(channel, handler);
+      handlers.push(channel);
+    },
+    on(channel, listener) {
+      options.ipcMain.on(channel, listener);
+      listeners.push([channel, listener]);
+    }
   };
-  await configureRuntimeTracing(container, traceSettings);
-  const router = new import_wood_router.WoodRouter({
-    container,
-    controllersDir,
-    middlewareDir,
-    mode
-  });
-  registerRuntime(router);
-  logger.info("runtime registration complete");
-  router.validateControllers();
-  logger.info("runtime controller validation complete");
-  router.precompileSchemas();
-  logger.info("runtime schema pre-compilation complete");
-  registerReservedRuntimeHandlers(router, options, traceSettings, rendererTraceBatchHost);
-  registerRuntimeObservationBridges(ipcMain, traceSettings, options.resolveRendererTraceContext);
-  router.registerIpcHandlers(ipcMain);
-  logger.info("runtime ipc handlers registered", {
-    channelCount: router.getChannels().length,
-    enableRendererLogBridge,
-    enableRendererTraceBridge
-  });
-  return { router };
+  try {
+    (0, import_runtime_module.installWoodRuntime)(container, { controllersDir, middlewareDir, mode, registerRuntime });
+    if (!container.isRegistered(import_tracing.RendererTraceBatchHost)) {
+      container.registerFunction(import_tracing.RendererTraceBatchHost, () => new import_tracing.RendererTraceBatchHost(rendererTraceBatchReceiver));
+    }
+    const rendererTraceBatchHost = await import_ioc.ExecutionContext.run(container, () => container.get(import_tracing.RendererTraceBatchHost));
+    logger.info("runtime start", {
+      mode,
+      hasProvidedContainer: !!options.container,
+      controllersDir,
+      middlewareDir,
+      enableRendererLogBridge,
+      enableRendererTraceBridge,
+      traceMinLevel: traceMinLevel ?? "debug",
+      rendererTraceEnabled,
+      rendererTraceMinLevel,
+      rendererTraceBatchEnabled
+    });
+    const traceSettings = {
+      enableRendererLogBridge,
+      enableRendererTraceBridge,
+      traceMinLevel,
+      rendererTraceEnabled,
+      rendererTraceMinLevel,
+      rendererTraceBatchEnabled
+    };
+    await configureRuntimeTracing(container, traceSettings, options.legacyGlobals ?? false);
+    router = await import_ioc.ExecutionContext.run(container, () => container.get(import_wood_router.WoodRouter));
+    registerReservedRuntimeHandlers(router, options, traceSettings, rendererTraceBatchHost);
+    registerRuntimeObservationBridges(ipcMain, traceSettings, options.resolveRendererTraceContext, options.rendererLogDispatcher ?? (options.legacyGlobals ? (0, import_renderer_log_dispatcher.getRendererLogDispatcher)() : new import_renderer_log_dispatcher.RendererLogDispatcher()));
+    router.registerIpcHandlers(ipcMain);
+    logger.info("runtime ipc handlers registered", {
+      channelCount: router.getChannels().length,
+      enableRendererLogBridge,
+      enableRendererTraceBridge
+    });
+    return { router, dispose };
+  } catch (error) {
+    try {
+      await dispose();
+    } catch (cleanupError) {
+      throw Object.assign(new Error("Wood runtime startup and cleanup failed"), { cause: error, errors: [error, cleanupError] });
+    }
+    throw error;
+  }
 }
-async function configureRuntimeTracing(container, settings) {
-  if (settings.traceMinLevel) {
-    (0, import_tracing2.setMainTraceMinLevel)(settings.traceMinLevel);
+async function configureRuntimeTracing(container, settings, legacyGlobals) {
+  if (legacyGlobals) {
+    if (settings.traceMinLevel) (0, import_tracing2.setMainTraceMinLevel)(settings.traceMinLevel);
+    (0, import_tracing2.setRendererTraceMinLevel)(settings.rendererTraceMinLevel);
   }
-  (0, import_tracing2.setRendererTraceMinLevel)(settings.rendererTraceMinLevel);
   if (typeof container.instance !== "function") {
     return;
   }
@@ -140,7 +191,7 @@ function registerReservedRuntimeHandlers(router, options, settings, rendererTrac
   );
   router.registerReservedHandler("__woodConfig", async () => ({
     // App extension fields first so Wood's reserved keys always win.
-    ...await (0, import_renderer_config_extension.resolveRendererConfigExtension)(),
+    ...await (0, import_renderer_config_extension.resolveRendererConfigExtension)(options.rendererConfigExtension ?? (options.legacyGlobals ? void 0 : null)),
     rendererTraceEnabled: settings.rendererTraceEnabled,
     rendererTraceMinLevel: settings.rendererTraceMinLevel,
     rendererTraceBatchEnabled: settings.rendererTraceBatchEnabled,
@@ -150,9 +201,9 @@ function registerReservedRuntimeHandlers(router, options, settings, rendererTrac
     return rendererTraceBatchHost.receive(data, options.resolveRendererTraceContext?.(event) ?? {});
   });
 }
-function registerRuntimeObservationBridges(ipcMain, settings, resolveContext) {
+function registerRuntimeObservationBridges(ipcMain, settings, resolveContext, dispatcher) {
   if (settings.enableRendererLogBridge) {
-    registerRendererLogBridge(ipcMain);
+    registerRendererLogBridge(ipcMain, dispatcher);
   }
   ipcMain.removeAllListeners?.("__trace");
   if (settings.enableRendererTraceBridge && settings.rendererTraceEnabled) {
@@ -174,8 +225,7 @@ function registerRendererTraceBridge(ipcMain, resolveContext) {
   });
   logger.info("renderer trace bridge registered (fire-and-forget)");
 }
-function registerRendererLogBridge(ipcMain) {
-  const dispatcher = (0, import_renderer_log_dispatcher.getRendererLogDispatcher)();
+function registerRendererLogBridge(ipcMain, dispatcher) {
   ipcMain.removeAllListeners?.("__log");
   ipcMain.on("__log", (_event, rawPayload) => {
     const entry = coerceRendererLogPayload(rawPayload, null);

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 {\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 { dispatchRendererLogBatch } from './renderer_log_batch_receiver.js';\nimport { resolveRendererConfigExtension } from './renderer_config_extension.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    // App extension fields first so Wood's reserved keys always win.\n    ...(await resolveRendererConfigExtension()),\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  ipcMain.removeAllListeners?.('__log_batch');\n\n  ipcMain.on('__log_batch', (_event, rawPayload) => {\n    const result = dispatchRendererLogBatch(rawPayload);\n    if (!result.ok) {\n      logger.warn('renderer log batch rejected', {\n        reason: result.reason ?? null,\n        errorMessage: result.errorMessage ?? null,\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 { getRendererTraceBatchReceiver } from './renderer_trace_batch_receiver_registry.js';\nimport { getLogger } from '@noego/logger';\nimport { WoodRouter } from '../router/wood_router.cjs';\nimport { createWoodRoot } from './get_container.cjs';\nimport { ExecutionContext } from '@noego/ioc';\nimport { installWoodRuntime } from './runtime_module.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  RendererLogDispatcher,\n  type RendererLogDispatchResult,\n  type RendererLogEntry,\n  type RendererLogLevel,\n} from './renderer_log_dispatcher.js';\nimport { dispatchRendererLogBatch } from './renderer_log_batch_receiver.js';\nimport { resolveRendererConfigExtension, type RendererConfigExtension } from './renderer_config_extension.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  removeListener?: (channel: string, listener: (...args: any[]) => void) => 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  /** Explicit migration adapter for the old process-global observation hooks. */\n  legacyGlobals?: boolean;\n  rendererLogDispatcher?: RendererLogDispatcher;\n  rendererConfigExtension?: RendererConfigExtension;\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  /** Stop admission, drain operations, remove owned IPC handlers and dispose an internally created root. */\n  dispose(timeoutMs?: number): Promise<void>;\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    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 ?? createWoodRoot();\n  const rendererTraceBatchReceiver = options.rendererTraceBatchReceiver\n    ?? (options.legacyGlobals ? getRendererTraceBatchReceiver() : null);\n  const rendererTraceBatchEnabled = rendererTraceBatchReceiver !== null;\n  const handlers: string[] = [];\n  const listeners: Array<[string, (...args: any[]) => void]> = [];\n  let router: WoodRouter | undefined;\n  let closing: Promise<void> | undefined;\n  const dispose = (timeoutMs?: number): Promise<void> => closing ??= (async () => {\n    const errors: unknown[] = [];\n    for (const channel of handlers.splice(0)) {\n      try { options.ipcMain.removeHandler?.(channel); } catch (error) { errors.push(error); }\n    }\n    for (const [channel, listener] of listeners.splice(0)) {\n      try {\n        if (options.ipcMain.removeListener) options.ipcMain.removeListener(channel, listener);\n        else options.ipcMain.removeAllListeners?.(channel);\n      } catch (error) { errors.push(error); }\n    }\n    let drained = true;\n    try { await router?.dispose(timeoutMs); } catch (error) { drained = false; errors.push(error); }\n    // Pending work retains its root after a timeout. The caller can retry disposal.\n    if (!options.container && drained) {\n      try { await ExecutionContext.run(container, () => container.dispose()); } catch (error) { errors.push(error); }\n    }\n    if (errors.length) throw Object.assign(new Error('Wood runtime cleanup failed'), { errors });\n  })().catch(error => { closing = undefined; throw error; });\n  const ipcMain: IpcMainLike = {\n    handle(channel, handler) {\n      options.ipcMain.handle(channel, handler);\n      handlers.push(channel);\n    },\n    on(channel, listener) {\n      options.ipcMain.on(channel, listener);\n      listeners.push([channel, listener]);\n    },\n  };\n  try {\n  installWoodRuntime(container, { controllersDir, middlewareDir, mode, registerRuntime });\n  if (!container.isRegistered(RendererTraceBatchHost)) {\n    container.registerFunction(RendererTraceBatchHost, () => new RendererTraceBatchHost(rendererTraceBatchReceiver));\n  }\n  const rendererTraceBatchHost = await ExecutionContext.run(container, () => container.get(RendererTraceBatchHost)) as RendererTraceBatchHost;\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, options.legacyGlobals ?? false);\n\n  router = await ExecutionContext.run(container, () => container.get(WoodRouter)) as WoodRouter;\n\n  registerReservedRuntimeHandlers(router, options, traceSettings, rendererTraceBatchHost);\n  registerRuntimeObservationBridges(ipcMain, traceSettings, options.resolveRendererTraceContext, options.rendererLogDispatcher ?? (options.legacyGlobals ? getRendererLogDispatcher() : new RendererLogDispatcher()));\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, dispose };\n  } catch (error) {\n    try { await dispose(); } catch (cleanupError) {\n      throw Object.assign(new Error('Wood runtime startup and cleanup failed'), { cause: error, errors: [error, cleanupError] });\n    }\n    throw error;\n  }\n}\n\nasync function configureRuntimeTracing(\n  container: any,\n  settings: RuntimeTraceSettings,\n  legacyGlobals: boolean,\n): Promise<void> {\n  if (legacyGlobals) {\n    if (settings.traceMinLevel) setMainTraceMinLevel(settings.traceMinLevel);\n    setRendererTraceMinLevel(settings.rendererTraceMinLevel);\n  }\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    // App extension fields first so Wood's reserved keys always win.\n    ...(await resolveRendererConfigExtension(options.rendererConfigExtension ?? (options.legacyGlobals ? undefined : null))),\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  dispatcher: RendererLogDispatcher,\n): void {\n  if (settings.enableRendererLogBridge) {\n    registerRendererLogBridge(ipcMain, dispatcher);\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, dispatcher: RendererLogDispatcher): void {\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  ipcMain.removeAllListeners?.('__log_batch');\n\n  ipcMain.on('__log_batch', (_event, rawPayload) => {\n    const result = dispatchRendererLogBatch(rawPayload);\n    if (!result.ok) {\n      logger.warn('renderer log batch rejected', {\n        reason: result.reason ?? null,\n        errorMessage: result.errorMessage ?? null,\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,9 +1,14 @@
 import { WoodRouter } from '../router/wood_router.cjs';
 import { c as TraceLevel, e as TraceRuntimeContext } from '../trace_hub-Cpo_nVze.cjs';
 import { WoodTraceBatchReceiver } from '../tracing/types/wood_trace_batch.types.cjs';
+import { RendererLogDispatcher } from './renderer_log_dispatcher.cjs';
+import { RendererConfigExtension } from './renderer_config_extension.cjs';
 import { WoodAppEnv } from './app_env.cjs';
 import '../types/operations.cjs';
 import '../types/context.cjs';
+import '../validation/schema_validator.cjs';
+import '../middleware/middleware_resolver.cjs';
+import '../controller/controller_resolver.cjs';
 import 'rxjs';
 import '@noego/telemetry/core';
 
@@ -12,6 +17,7 @@ type IpcMainLike = {
     on: (channel: string, handler: (_event: unknown, ...args: unknown[]) => void) => void;
     removeHandler?: (channel: string) => void;
     removeAllListeners?: (channel: string) => void;
+    removeListener?: (channel: string, listener: (...args: any[]) => void) => void;
 };
 interface RegisterRuntimeRouter {
     registerController(name: string, cls: any): void;
@@ -19,6 +25,10 @@ interface RegisterRuntimeRouter {
 }
 interface RuntimeOptions {
     ipcMain: IpcMainLike;
+    /** Explicit migration adapter for the old process-global observation hooks. */
+    legacyGlobals?: boolean;
+    rendererLogDispatcher?: RendererLogDispatcher;
+    rendererConfigExtension?: RendererConfigExtension;
     registerRuntime: (router: RegisterRuntimeRouter) => void;
     container?: any;
     controllersDir: string;
@@ -42,6 +52,8 @@ interface RuntimeOptions {
 }
 interface RuntimeResult {
     router: WoodRouter;
+    /** Stop admission, drain operations, remove owned IPC handlers and dispose an internally created root. */
+    dispose(timeoutMs?: number): Promise<void>;
 }
 /**
  * Boot a bundled-safe Wood runtime using pre-generated static runtime artifacts.

package/dist/runtime/runtime.d.ts

@@ -1,9 +1,14 @@
 import { WoodRouter } from '../router/wood_router.js';
 import { c as TraceLevel, e as TraceRuntimeContext } from '../trace_hub-Cpo_nVze.js';
 import { WoodTraceBatchReceiver } from '../tracing/types/wood_trace_batch.types.js';
+import { RendererLogDispatcher } from './renderer_log_dispatcher.js';
+import { RendererConfigExtension } from './renderer_config_extension.js';
 import { WoodAppEnv } from './app_env.js';
 import '../types/operations.js';
 import '../types/context.js';
+import '../validation/schema_validator.js';
+import '../middleware/middleware_resolver.js';
+import '../controller/controller_resolver.js';
 import 'rxjs';
 import '@noego/telemetry/core';
 
@@ -12,6 +17,7 @@ type IpcMainLike = {
     on: (channel: string, handler: (_event: unknown, ...args: unknown[]) => void) => void;
     removeHandler?: (channel: string) => void;
     removeAllListeners?: (channel: string) => void;
+    removeListener?: (channel: string, listener: (...args: any[]) => void) => void;
 };
 interface RegisterRuntimeRouter {
     registerController(name: string, cls: any): void;
@@ -19,6 +25,10 @@ interface RegisterRuntimeRouter {
 }
 interface RuntimeOptions {
     ipcMain: IpcMainLike;
+    /** Explicit migration adapter for the old process-global observation hooks. */
+    legacyGlobals?: boolean;
+    rendererLogDispatcher?: RendererLogDispatcher;
+    rendererConfigExtension?: RendererConfigExtension;
     registerRuntime: (router: RegisterRuntimeRouter) => void;
     container?: any;
     controllersDir: string;
@@ -42,6 +52,8 @@ interface RuntimeOptions {
 }
 interface RuntimeResult {
     router: WoodRouter;
+    /** Stop admission, drain operations, remove owned IPC handlers and dispose an internally created root. */
+    dispose(timeoutMs?: number): Promise<void>;
 }
 /**
  * Boot a bundled-safe Wood runtime using pre-generated static runtime artifacts.