@noego/wood 0.0.4 → 0.1.1

package/dist/router/wood_router.cjs

@@ -26,6 +26,7 @@ var import_schema_validator = require("../validation/schema_validator.cjs");
 var import_middleware_resolver = require("../middleware/middleware_resolver.cjs");
 var import_middleware_pipeline = require("../middleware/middleware_pipeline.cjs");
 var import_controller_resolver = require("../controller/controller_resolver.cjs");
+var import_controller_lifecycle = require("../controller/controller_lifecycle.cjs");
 var import_logger = require("@noego/logger");
 var import_tracing = require("../tracing/index.js");
 const logger = (0, import_logger.getLogger)("wood:router");
@@ -135,16 +136,16 @@ class WoodRouter {
       await (0, import_middleware_pipeline.executeMiddleware)(middlewareFns, mwContext);
     }
     if (opDef.inputSchema) {
-      const result = this.validator.validate(
+      const result2 = this.validator.validate(
         channel,
         opDef.inputSchema,
         ipcContext.body
       );
-      if (!result.valid) {
+      if (!result2.valid) {
         return {
           error: "VALIDATION_ERROR",
           message: "Request validation failed",
-          details: result.errors
+          details: result2.errors
         };
       }
     }
@@ -153,13 +154,15 @@ class WoodRouter {
     const instance = await scopedContainer.instance(ControllerClass);
     const args = (0, import_controller_resolver.buildControllerArgs)(ipcContext, scopedContainer);
     const action = instance[opDef.action];
-    if (typeof action !== "function") {
-      throw new Error(
-        `Controller "${opDef.controller}" has no action "${opDef.action}"`
-      );
-    }
+    let result;
+    let actionError;
     try {
-      const result = await action.call(instance, args);
+      if (typeof action !== "function") {
+        throw new Error(
+          `Controller "${opDef.controller}" has no action "${opDef.action}"`
+        );
+      }
+      result = await action.call(instance, args);
       (0, import_tracing.publishMainTrace)("debug", {
         source: "wood.router",
         type: "dispatch.success",
@@ -170,8 +173,8 @@ class WoodRouter {
           action: opDef.action
         }
       });
-      return result;
     } catch (error) {
+      actionError = error;
       (0, import_tracing.publishMainTrace)("error", {
         source: "wood.router",
         type: "dispatch.error",
@@ -183,8 +186,30 @@ class WoodRouter {
           action: opDef.action
         }
       });
-      throw error;
+    } finally {
+      try {
+        await (0, import_controller_lifecycle.disposeControllerLifecycle)(instance);
+      } catch (disposeError) {
+        (0, import_tracing.publishMainTrace)("error", {
+          source: "wood.router",
+          type: "dispatch.dispose.error",
+          message: disposeError instanceof Error ? disposeError.message : String(disposeError),
+          ...conversationId !== void 0 ? { conversationId } : {},
+          payload: {
+            channel,
+            controller: opDef.controller,
+            action: opDef.action
+          }
+        });
+        if (!actionError) {
+          actionError = disposeError;
+        }
+      }
+    }
+    if (actionError) {
+      throw actionError;
     }
+    return result;
   }
   /**
    * Pre-register a controller class by name so it is resolved from

package/dist/router/wood_router.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/router/wood_router.ts"],"sourcesContent":["import type { OperationDef, IpcContext, WoodMiddlewareContext } from '../types/index.cjs';\nimport { SchemaValidator } from '../validation/schema_validator.cjs';\nimport { MiddlewareResolver } from '../middleware/middleware_resolver.cjs';\nimport { buildMiddlewareContext, executeMiddleware } from '../middleware/middleware_pipeline.cjs';\nimport { ControllerResolver, buildControllerArgs } from '../controller/controller_resolver.cjs';\nimport { getLogger } from '@noego/logger';\nimport { publishMainTrace } from '../tracing/index.js';\n\nconst logger = getLogger('wood:router');\n\nfunction extractTraceConversationId(value: unknown): number | string | undefined {\n  if (!value || typeof value !== 'object' || Array.isArray(value)) {\n    return undefined;\n  }\n\n  const record = value as Record<string, unknown>;\n  if (typeof record.conversationId === 'number' || typeof record.conversationId === 'string') {\n    return record.conversationId;\n  }\n  if (typeof record.threadId === 'number' || typeof record.threadId === 'string') {\n    return record.threadId;\n  }\n\n  return undefined;\n}\n\n/** Reserved internal channels prefixed with __ to avoid collisions with user operations. */\nexport const RESERVED_CHANNELS = ['__load', '__navigate', '__window', '__debug', '__contextMenu', '__woodConfig'] as const;\nexport type ReservedChannel = (typeof RESERVED_CHANNELS)[number];\n\n/** Handler signature for reserved channels. */\nexport type ReservedChannelHandler = (data: unknown, event?: any) => Promise<unknown>;\n\nexport class WoodRouter {\n  private operations = new Map<string, OperationDef>();\n  private reservedHandlers = new Map<ReservedChannel, ReservedChannelHandler>();\n  private validator: SchemaValidator;\n  private middlewareResolver: MiddlewareResolver;\n  private controllerResolver: ControllerResolver;\n  private container: any; // IoC Container\n\n  constructor(options: {\n    container: any;\n    controllersDir: string;\n    middlewareDir: string;\n    mode?: 'bundled' | 'dev';\n  }) {\n    this.container = options.container;\n    this.validator = new SchemaValidator();\n    this.middlewareResolver = new MiddlewareResolver(options.middlewareDir);\n    this.controllerResolver = new ControllerResolver(options.controllersDir, {\n      mode: options.mode,\n    });\n  }\n\n  /**\n   * Load operations from a parsed operations map.\n   */\n  loadOperations(operations: Map<string, OperationDef>): void {\n    for (const [channel, opDef] of operations) {\n      this.operations.set(channel, opDef);\n    }\n    logger.debug(`Loaded ${operations.size} operations`);\n  }\n\n  /**\n   * Register a handler for a reserved channel (__load, __navigate, __window).\n   * These channels are internal to Wood and serve as extension points for\n   * the loader runner, navigation system, and window manager.\n   */\n  registerReservedHandler(channel: ReservedChannel, handler: ReservedChannelHandler): void {\n    this.reservedHandlers.set(channel, handler);\n    logger.debug(`Registered reserved handler for \"${channel}\"`);\n  }\n\n  /**\n   * Register IPC handlers for all operations and reserved channels.\n   * In production: registers with ipcMain.handle\n   * In testing/bridge mode: handlers are callable via dispatch()\n   */\n  registerIpcHandlers(ipcMain: any): void {\n    for (const channel of this.operations.keys()) {\n      ipcMain.handle(channel, async (_event: any, data: unknown) => {\n        return this.dispatch(channel, data, _event);\n      });\n    }\n\n    // Register reserved channels\n    for (const channel of RESERVED_CHANNELS) {\n      ipcMain.handle(channel, async (_event: any, data: unknown) => {\n        const handler = this.reservedHandlers.get(channel);\n        if (!handler) {\n          throw new Error(`No handler registered for reserved channel \"${channel}\"`);\n        }\n        return handler(data, _event);\n      });\n    }\n\n    logger.debug(\n      `Registered ${this.operations.size} operation handlers and ${RESERVED_CHANNELS.length} reserved channels`\n    );\n  }\n\n  /**\n   * The request lifecycle -- mirrors Dinner's pipeline.\n   *\n   * channel -> build context -> middleware -> validate -> resolve controller\n   * -> create instance -> build args -> call action -> return result\n   */\n  async dispatch(channel: string, data: unknown, event?: any): Promise<unknown> {\n    const opDef = this.operations.get(channel);\n    if (!opDef) {\n      throw new Error(`Unknown operation: \"${channel}\"`);\n    }\n\n    const conversationId = extractTraceConversationId(data);\n    publishMainTrace('debug', {\n      source: 'wood.router',\n      type: 'dispatch.start',\n      ...(conversationId !== undefined ? { conversationId } : {}),\n      payload: {\n        channel,\n        controller: opDef.controller,\n        action: opDef.action,\n      },\n    });\n\n    // 1. Build IPC context\n    const ipcContext: IpcContext = {\n      body: data ?? {},\n      params: (data as any) ?? {},\n      query: {},\n      context: {},\n      sender: event?.sender,\n      windowId: undefined,\n    };\n\n    // 2. Execute middleware sequentially\n    if (opDef.middleware.length > 0) {\n      const mwContext = buildMiddlewareContext(ipcContext, channel);\n      const middlewareFns = await Promise.all(\n        opDef.middleware.map(spec => this.middlewareResolver.resolve(spec))\n      );\n      await executeMiddleware(middlewareFns, mwContext);\n    }\n\n    // 3. Validate input (if schema defined)\n    if (opDef.inputSchema) {\n      const result = this.validator.validate(\n        channel,\n        opDef.inputSchema as Record<string, unknown>,\n        ipcContext.body\n      );\n      if (!result.valid) {\n        return {\n          error: 'VALIDATION_ERROR',\n          message: 'Request validation failed',\n          details: result.errors,\n        };\n      }\n    }\n\n    // 4. Resolve controller class (cached)\n    const ControllerClass = await this.controllerResolver.resolveClass(opDef.controller);\n\n    // 5. Create instance via IoC (per-request scoped container)\n    const scopedContainer = this.container.extend();\n    const instance = await scopedContainer.instance(ControllerClass);\n\n    // 6. Build controller args (fake req/res)\n    const args = buildControllerArgs(ipcContext, scopedContainer);\n\n    // 7. Call action, return result\n    const action = instance[opDef.action];\n    if (typeof action !== 'function') {\n      throw new Error(\n        `Controller \"${opDef.controller}\" has no action \"${opDef.action}\"`\n      );\n    }\n\n    try {\n      const result = await action.call(instance, args);\n      publishMainTrace('debug', {\n        source: 'wood.router',\n        type: 'dispatch.success',\n        ...(conversationId !== undefined ? { conversationId } : {}),\n        payload: {\n          channel,\n          controller: opDef.controller,\n          action: opDef.action,\n        },\n      });\n      return result;\n    } catch (error) {\n      publishMainTrace('error', {\n        source: 'wood.router',\n        type: 'dispatch.error',\n        message: error instanceof Error ? error.message : String(error),\n        ...(conversationId !== undefined ? { conversationId } : {}),\n        payload: {\n          channel,\n          controller: opDef.controller,\n          action: opDef.action,\n        },\n      });\n      throw error;\n    }\n  }\n\n  /**\n   * Pre-register a controller class by name so it is resolved from\n   * the in-memory cache instead of the filesystem.\n   * This is the public API used by the generated registration file.\n   */\n  registerController(name: string, ControllerClass: any): void {\n    this.controllerResolver.register(name, ControllerClass);\n  }\n\n  /**\n   * Register an import path for a controller. The controller will be lazily\n   * imported from this path when first needed, avoiding circular dependencies.\n   */\n  registerControllerPath(name: string, importPath: string): void {\n    this.controllerResolver.registerPath(name, importPath);\n  }\n\n  /**\n   * Validate that every controller referenced in loaded operations is\n   * pre-registered in the controller resolver. Call this after\n   * loadOperations() + registerControllers() but before registerIpcHandlers().\n   *\n   * Throws with a clear error listing all missing controllers if any\n   * operation references a controller that was not pre-registered.\n   */\n  validateControllers(): void {\n    const missing: Array<{ channel: string; controller: string }> = [];\n\n    for (const [channel, opDef] of this.operations) {\n      if (!this.controllerResolver.has(opDef.controller)) {\n        missing.push({ channel, controller: opDef.controller });\n      }\n    }\n\n    if (missing.length > 0) {\n      const details = missing\n        .map(m => `  - channel \"${m.channel}\" requires controller \"${m.controller}\"`)\n        .join('\\n');\n\n      throw new Error(\n        `WoodRouter: ${missing.length} operation(s) reference controllers that are not registered.\\n` +\n        `This usually means controllers.generated.ts is missing or out of date.\\n` +\n        `Run \"npx wood build\" or \"npx wood dev\" to regenerate it.\\n\\n` +\n        `Missing controllers:\\n${details}`\n      );\n    }\n\n    logger.info(`All ${this.operations.size} operations have registered controllers`);\n  }\n\n  /** Get all registered operation channels. */\n  getChannels(): string[] {\n    return Array.from(this.operations.keys());\n  }\n\n  /** Get a specific operation definition. */\n  getOperation(channel: string): OperationDef | undefined {\n    return this.operations.get(channel);\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/router/wood_router.ts"],"sourcesContent":["import type { OperationDef, IpcContext, WoodMiddlewareContext } from '../types/index.cjs';\nimport { SchemaValidator } from '../validation/schema_validator.cjs';\nimport { MiddlewareResolver } from '../middleware/middleware_resolver.cjs';\nimport { buildMiddlewareContext, executeMiddleware } from '../middleware/middleware_pipeline.cjs';\nimport { ControllerResolver, buildControllerArgs } from '../controller/controller_resolver.cjs';\nimport { disposeControllerLifecycle } from '../controller/controller_lifecycle.cjs';\nimport { getLogger } from '@noego/logger';\nimport { publishMainTrace } from '../tracing/index.js';\n\nconst logger = getLogger('wood:router');\n\nfunction extractTraceConversationId(value: unknown): number | string | undefined {\n  if (!value || typeof value !== 'object' || Array.isArray(value)) {\n    return undefined;\n  }\n\n  const record = value as Record<string, unknown>;\n  if (typeof record.conversationId === 'number' || typeof record.conversationId === 'string') {\n    return record.conversationId;\n  }\n  if (typeof record.threadId === 'number' || typeof record.threadId === 'string') {\n    return record.threadId;\n  }\n\n  return undefined;\n}\n\n/** Reserved internal channels prefixed with __ to avoid collisions with user operations. */\nexport const RESERVED_CHANNELS = ['__load', '__navigate', '__window', '__debug', '__contextMenu', '__woodConfig'] as const;\nexport type ReservedChannel = (typeof RESERVED_CHANNELS)[number];\n\n/** Handler signature for reserved channels. */\nexport type ReservedChannelHandler = (data: unknown, event?: any) => Promise<unknown>;\n\nexport class WoodRouter {\n  private operations = new Map<string, OperationDef>();\n  private reservedHandlers = new Map<ReservedChannel, ReservedChannelHandler>();\n  private validator: SchemaValidator;\n  private middlewareResolver: MiddlewareResolver;\n  private controllerResolver: ControllerResolver;\n  private container: any; // IoC Container\n\n  constructor(options: {\n    container: any;\n    controllersDir: string;\n    middlewareDir: string;\n    mode?: 'bundled' | 'dev';\n  }) {\n    this.container = options.container;\n    this.validator = new SchemaValidator();\n    this.middlewareResolver = new MiddlewareResolver(options.middlewareDir);\n    this.controllerResolver = new ControllerResolver(options.controllersDir, {\n      mode: options.mode,\n    });\n  }\n\n  /**\n   * Load operations from a parsed operations map.\n   */\n  loadOperations(operations: Map<string, OperationDef>): void {\n    for (const [channel, opDef] of operations) {\n      this.operations.set(channel, opDef);\n    }\n    logger.debug(`Loaded ${operations.size} operations`);\n  }\n\n  /**\n   * Register a handler for a reserved channel (__load, __navigate, __window).\n   * These channels are internal to Wood and serve as extension points for\n   * the loader runner, navigation system, and window manager.\n   */\n  registerReservedHandler(channel: ReservedChannel, handler: ReservedChannelHandler): void {\n    this.reservedHandlers.set(channel, handler);\n    logger.debug(`Registered reserved handler for \"${channel}\"`);\n  }\n\n  /**\n   * Register IPC handlers for all operations and reserved channels.\n   * In production: registers with ipcMain.handle\n   * In testing/bridge mode: handlers are callable via dispatch()\n   */\n  registerIpcHandlers(ipcMain: any): void {\n    for (const channel of this.operations.keys()) {\n      ipcMain.handle(channel, async (_event: any, data: unknown) => {\n        return this.dispatch(channel, data, _event);\n      });\n    }\n\n    // Register reserved channels\n    for (const channel of RESERVED_CHANNELS) {\n      ipcMain.handle(channel, async (_event: any, data: unknown) => {\n        const handler = this.reservedHandlers.get(channel);\n        if (!handler) {\n          throw new Error(`No handler registered for reserved channel \"${channel}\"`);\n        }\n        return handler(data, _event);\n      });\n    }\n\n    logger.debug(\n      `Registered ${this.operations.size} operation handlers and ${RESERVED_CHANNELS.length} reserved channels`\n    );\n  }\n\n  /**\n   * The request lifecycle -- mirrors Dinner's pipeline.\n   *\n   * channel -> build context -> middleware -> validate -> resolve controller\n   * -> create instance -> build args -> call action -> return result\n   */\n  async dispatch(channel: string, data: unknown, event?: any): Promise<unknown> {\n    const opDef = this.operations.get(channel);\n    if (!opDef) {\n      throw new Error(`Unknown operation: \"${channel}\"`);\n    }\n\n    const conversationId = extractTraceConversationId(data);\n    publishMainTrace('debug', {\n      source: 'wood.router',\n      type: 'dispatch.start',\n      ...(conversationId !== undefined ? { conversationId } : {}),\n      payload: {\n        channel,\n        controller: opDef.controller,\n        action: opDef.action,\n      },\n    });\n\n    // 1. Build IPC context\n    const ipcContext: IpcContext = {\n      body: data ?? {},\n      params: (data as any) ?? {},\n      query: {},\n      context: {},\n      sender: event?.sender,\n      windowId: undefined,\n    };\n\n    // 2. Execute middleware sequentially\n    if (opDef.middleware.length > 0) {\n      const mwContext = buildMiddlewareContext(ipcContext, channel);\n      const middlewareFns = await Promise.all(\n        opDef.middleware.map(spec => this.middlewareResolver.resolve(spec))\n      );\n      await executeMiddleware(middlewareFns, mwContext);\n    }\n\n    // 3. Validate input (if schema defined)\n    if (opDef.inputSchema) {\n      const result = this.validator.validate(\n        channel,\n        opDef.inputSchema as Record<string, unknown>,\n        ipcContext.body\n      );\n      if (!result.valid) {\n        return {\n          error: 'VALIDATION_ERROR',\n          message: 'Request validation failed',\n          details: result.errors,\n        };\n      }\n    }\n\n    // 4. Resolve controller class (cached)\n    const ControllerClass = await this.controllerResolver.resolveClass(opDef.controller);\n\n    // 5. Create instance via IoC (per-request scoped container)\n    const scopedContainer = this.container.extend();\n    const instance = await scopedContainer.instance(ControllerClass);\n\n    // 6. Build controller args (fake req/res)\n    const args = buildControllerArgs(ipcContext, scopedContainer);\n\n    // 7. Call action, always dispose controller afterward\n    const action = instance[opDef.action];\n    let result: unknown;\n    let actionError: unknown;\n\n    try {\n      if (typeof action !== 'function') {\n        throw new Error(\n          `Controller \"${opDef.controller}\" has no action \"${opDef.action}\"`\n        );\n      }\n\n      result = await action.call(instance, args);\n      publishMainTrace('debug', {\n        source: 'wood.router',\n        type: 'dispatch.success',\n        ...(conversationId !== undefined ? { conversationId } : {}),\n        payload: {\n          channel,\n          controller: opDef.controller,\n          action: opDef.action,\n        },\n      });\n    } catch (error) {\n      actionError = error;\n      publishMainTrace('error', {\n        source: 'wood.router',\n        type: 'dispatch.error',\n        message: error instanceof Error ? error.message : String(error),\n        ...(conversationId !== undefined ? { conversationId } : {}),\n        payload: {\n          channel,\n          controller: opDef.controller,\n          action: opDef.action,\n        },\n      });\n    } finally {\n      try {\n        await disposeControllerLifecycle(instance);\n      } catch (disposeError) {\n        publishMainTrace('error', {\n          source: 'wood.router',\n          type: 'dispatch.dispose.error',\n          message: disposeError instanceof Error ? disposeError.message : String(disposeError),\n          ...(conversationId !== undefined ? { conversationId } : {}),\n          payload: {\n            channel,\n            controller: opDef.controller,\n            action: opDef.action,\n          },\n        });\n\n        if (!actionError) {\n          actionError = disposeError;\n        }\n      }\n    }\n\n    if (actionError) {\n      throw actionError;\n    }\n\n    return result;\n  }\n\n  /**\n   * Pre-register a controller class by name so it is resolved from\n   * the in-memory cache instead of the filesystem.\n   * This is the public API used by the generated registration file.\n   */\n  registerController(name: string, ControllerClass: any): void {\n    this.controllerResolver.register(name, ControllerClass);\n  }\n\n  /**\n   * Register an import path for a controller. The controller will be lazily\n   * imported from this path when first needed, avoiding circular dependencies.\n   */\n  registerControllerPath(name: string, importPath: string): void {\n    this.controllerResolver.registerPath(name, importPath);\n  }\n\n  /**\n   * Validate that every controller referenced in loaded operations is\n   * pre-registered in the controller resolver. Call this after\n   * loadOperations() + registerControllers() but before registerIpcHandlers().\n   *\n   * Throws with a clear error listing all missing controllers if any\n   * operation references a controller that was not pre-registered.\n   */\n  validateControllers(): void {\n    const missing: Array<{ channel: string; controller: string }> = [];\n\n    for (const [channel, opDef] of this.operations) {\n      if (!this.controllerResolver.has(opDef.controller)) {\n        missing.push({ channel, controller: opDef.controller });\n      }\n    }\n\n    if (missing.length > 0) {\n      const details = missing\n        .map(m => `  - channel \"${m.channel}\" requires controller \"${m.controller}\"`)\n        .join('\\n');\n\n      throw new Error(\n        `WoodRouter: ${missing.length} operation(s) reference controllers that are not registered.\\n` +\n        `This usually means controllers.generated.ts is missing or out of date.\\n` +\n        `Run \"npx wood build\" or \"npx wood dev\" to regenerate it.\\n\\n` +\n        `Missing controllers:\\n${details}`\n      );\n    }\n\n    logger.info(`All ${this.operations.size} operations have registered controllers`);\n  }\n\n  /** Get all registered operation channels. */\n  getChannels(): string[] {\n    return Array.from(this.operations.keys());\n  }\n\n  /** Get a specific operation definition. */\n  getOperation(channel: string): OperationDef | undefined {\n    return this.operations.get(channel);\n  }\n}\n"],"mappings":"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","names":["result"]}

package/dist/router/wood_router.js

@@ -2,6 +2,7 @@ import { SchemaValidator } from "../validation/schema_validator.js";
 import { MiddlewareResolver } from "../middleware/middleware_resolver.js";
 import { buildMiddlewareContext, executeMiddleware } from "../middleware/middleware_pipeline.js";
 import { ControllerResolver, buildControllerArgs } from "../controller/controller_resolver.js";
+import { disposeControllerLifecycle } from "../controller/controller_lifecycle.js";
 import { getLogger } from "@noego/logger";
 import { publishMainTrace } from "../tracing/index.js";
 const logger = getLogger("wood:router");
@@ -111,16 +112,16 @@ class WoodRouter {
       await executeMiddleware(middlewareFns, mwContext);
     }
     if (opDef.inputSchema) {
-      const result = this.validator.validate(
+      const result2 = this.validator.validate(
         channel,
         opDef.inputSchema,
         ipcContext.body
       );
-      if (!result.valid) {
+      if (!result2.valid) {
         return {
           error: "VALIDATION_ERROR",
           message: "Request validation failed",
-          details: result.errors
+          details: result2.errors
         };
       }
     }
@@ -129,13 +130,15 @@ class WoodRouter {
     const instance = await scopedContainer.instance(ControllerClass);
     const args = buildControllerArgs(ipcContext, scopedContainer);
     const action = instance[opDef.action];
-    if (typeof action !== "function") {
-      throw new Error(
-        `Controller "${opDef.controller}" has no action "${opDef.action}"`
-      );
-    }
+    let result;
+    let actionError;
     try {
-      const result = await action.call(instance, args);
+      if (typeof action !== "function") {
+        throw new Error(
+          `Controller "${opDef.controller}" has no action "${opDef.action}"`
+        );
+      }
+      result = await action.call(instance, args);
       publishMainTrace("debug", {
         source: "wood.router",
         type: "dispatch.success",
@@ -146,8 +149,8 @@ class WoodRouter {
           action: opDef.action
         }
       });
-      return result;
     } catch (error) {
+      actionError = error;
       publishMainTrace("error", {
         source: "wood.router",
         type: "dispatch.error",
@@ -159,8 +162,30 @@ class WoodRouter {
           action: opDef.action
         }
       });
-      throw error;
+    } finally {
+      try {
+        await disposeControllerLifecycle(instance);
+      } catch (disposeError) {
+        publishMainTrace("error", {
+          source: "wood.router",
+          type: "dispatch.dispose.error",
+          message: disposeError instanceof Error ? disposeError.message : String(disposeError),
+          ...conversationId !== void 0 ? { conversationId } : {},
+          payload: {
+            channel,
+            controller: opDef.controller,
+            action: opDef.action
+          }
+        });
+        if (!actionError) {
+          actionError = disposeError;
+        }
+      }
+    }
+    if (actionError) {
+      throw actionError;
     }
+    return result;
   }
   /**
    * Pre-register a controller class by name so it is resolved from

package/dist/router/wood_router.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/router/wood_router.ts"],"sourcesContent":["import type { OperationDef, IpcContext, WoodMiddlewareContext } from '../types/index.js';\nimport { SchemaValidator } from '../validation/schema_validator.js';\nimport { MiddlewareResolver } from '../middleware/middleware_resolver.js';\nimport { buildMiddlewareContext, executeMiddleware } from '../middleware/middleware_pipeline.js';\nimport { ControllerResolver, buildControllerArgs } from '../controller/controller_resolver.js';\nimport { getLogger } from '@noego/logger';\nimport { publishMainTrace } from '../tracing/index.js';\n\nconst logger = getLogger('wood:router');\n\nfunction extractTraceConversationId(value: unknown): number | string | undefined {\n  if (!value || typeof value !== 'object' || Array.isArray(value)) {\n    return undefined;\n  }\n\n  const record = value as Record<string, unknown>;\n  if (typeof record.conversationId === 'number' || typeof record.conversationId === 'string') {\n    return record.conversationId;\n  }\n  if (typeof record.threadId === 'number' || typeof record.threadId === 'string') {\n    return record.threadId;\n  }\n\n  return undefined;\n}\n\n/** Reserved internal channels prefixed with __ to avoid collisions with user operations. */\nexport const RESERVED_CHANNELS = ['__load', '__navigate', '__window', '__debug', '__contextMenu', '__woodConfig'] as const;\nexport type ReservedChannel = (typeof RESERVED_CHANNELS)[number];\n\n/** Handler signature for reserved channels. */\nexport type ReservedChannelHandler = (data: unknown, event?: any) => Promise<unknown>;\n\nexport class WoodRouter {\n  private operations = new Map<string, OperationDef>();\n  private reservedHandlers = new Map<ReservedChannel, ReservedChannelHandler>();\n  private validator: SchemaValidator;\n  private middlewareResolver: MiddlewareResolver;\n  private controllerResolver: ControllerResolver;\n  private container: any; // IoC Container\n\n  constructor(options: {\n    container: any;\n    controllersDir: string;\n    middlewareDir: string;\n    mode?: 'bundled' | 'dev';\n  }) {\n    this.container = options.container;\n    this.validator = new SchemaValidator();\n    this.middlewareResolver = new MiddlewareResolver(options.middlewareDir);\n    this.controllerResolver = new ControllerResolver(options.controllersDir, {\n      mode: options.mode,\n    });\n  }\n\n  /**\n   * Load operations from a parsed operations map.\n   */\n  loadOperations(operations: Map<string, OperationDef>): void {\n    for (const [channel, opDef] of operations) {\n      this.operations.set(channel, opDef);\n    }\n    logger.debug(`Loaded ${operations.size} operations`);\n  }\n\n  /**\n   * Register a handler for a reserved channel (__load, __navigate, __window).\n   * These channels are internal to Wood and serve as extension points for\n   * the loader runner, navigation system, and window manager.\n   */\n  registerReservedHandler(channel: ReservedChannel, handler: ReservedChannelHandler): void {\n    this.reservedHandlers.set(channel, handler);\n    logger.debug(`Registered reserved handler for \"${channel}\"`);\n  }\n\n  /**\n   * Register IPC handlers for all operations and reserved channels.\n   * In production: registers with ipcMain.handle\n   * In testing/bridge mode: handlers are callable via dispatch()\n   */\n  registerIpcHandlers(ipcMain: any): void {\n    for (const channel of this.operations.keys()) {\n      ipcMain.handle(channel, async (_event: any, data: unknown) => {\n        return this.dispatch(channel, data, _event);\n      });\n    }\n\n    // Register reserved channels\n    for (const channel of RESERVED_CHANNELS) {\n      ipcMain.handle(channel, async (_event: any, data: unknown) => {\n        const handler = this.reservedHandlers.get(channel);\n        if (!handler) {\n          throw new Error(`No handler registered for reserved channel \"${channel}\"`);\n        }\n        return handler(data, _event);\n      });\n    }\n\n    logger.debug(\n      `Registered ${this.operations.size} operation handlers and ${RESERVED_CHANNELS.length} reserved channels`\n    );\n  }\n\n  /**\n   * The request lifecycle -- mirrors Dinner's pipeline.\n   *\n   * channel -> build context -> middleware -> validate -> resolve controller\n   * -> create instance -> build args -> call action -> return result\n   */\n  async dispatch(channel: string, data: unknown, event?: any): Promise<unknown> {\n    const opDef = this.operations.get(channel);\n    if (!opDef) {\n      throw new Error(`Unknown operation: \"${channel}\"`);\n    }\n\n    const conversationId = extractTraceConversationId(data);\n    publishMainTrace('debug', {\n      source: 'wood.router',\n      type: 'dispatch.start',\n      ...(conversationId !== undefined ? { conversationId } : {}),\n      payload: {\n        channel,\n        controller: opDef.controller,\n        action: opDef.action,\n      },\n    });\n\n    // 1. Build IPC context\n    const ipcContext: IpcContext = {\n      body: data ?? {},\n      params: (data as any) ?? {},\n      query: {},\n      context: {},\n      sender: event?.sender,\n      windowId: undefined,\n    };\n\n    // 2. Execute middleware sequentially\n    if (opDef.middleware.length > 0) {\n      const mwContext = buildMiddlewareContext(ipcContext, channel);\n      const middlewareFns = await Promise.all(\n        opDef.middleware.map(spec => this.middlewareResolver.resolve(spec))\n      );\n      await executeMiddleware(middlewareFns, mwContext);\n    }\n\n    // 3. Validate input (if schema defined)\n    if (opDef.inputSchema) {\n      const result = this.validator.validate(\n        channel,\n        opDef.inputSchema as Record<string, unknown>,\n        ipcContext.body\n      );\n      if (!result.valid) {\n        return {\n          error: 'VALIDATION_ERROR',\n          message: 'Request validation failed',\n          details: result.errors,\n        };\n      }\n    }\n\n    // 4. Resolve controller class (cached)\n    const ControllerClass = await this.controllerResolver.resolveClass(opDef.controller);\n\n    // 5. Create instance via IoC (per-request scoped container)\n    const scopedContainer = this.container.extend();\n    const instance = await scopedContainer.instance(ControllerClass);\n\n    // 6. Build controller args (fake req/res)\n    const args = buildControllerArgs(ipcContext, scopedContainer);\n\n    // 7. Call action, return result\n    const action = instance[opDef.action];\n    if (typeof action !== 'function') {\n      throw new Error(\n        `Controller \"${opDef.controller}\" has no action \"${opDef.action}\"`\n      );\n    }\n\n    try {\n      const result = await action.call(instance, args);\n      publishMainTrace('debug', {\n        source: 'wood.router',\n        type: 'dispatch.success',\n        ...(conversationId !== undefined ? { conversationId } : {}),\n        payload: {\n          channel,\n          controller: opDef.controller,\n          action: opDef.action,\n        },\n      });\n      return result;\n    } catch (error) {\n      publishMainTrace('error', {\n        source: 'wood.router',\n        type: 'dispatch.error',\n        message: error instanceof Error ? error.message : String(error),\n        ...(conversationId !== undefined ? { conversationId } : {}),\n        payload: {\n          channel,\n          controller: opDef.controller,\n          action: opDef.action,\n        },\n      });\n      throw error;\n    }\n  }\n\n  /**\n   * Pre-register a controller class by name so it is resolved from\n   * the in-memory cache instead of the filesystem.\n   * This is the public API used by the generated registration file.\n   */\n  registerController(name: string, ControllerClass: any): void {\n    this.controllerResolver.register(name, ControllerClass);\n  }\n\n  /**\n   * Register an import path for a controller. The controller will be lazily\n   * imported from this path when first needed, avoiding circular dependencies.\n   */\n  registerControllerPath(name: string, importPath: string): void {\n    this.controllerResolver.registerPath(name, importPath);\n  }\n\n  /**\n   * Validate that every controller referenced in loaded operations is\n   * pre-registered in the controller resolver. Call this after\n   * loadOperations() + registerControllers() but before registerIpcHandlers().\n   *\n   * Throws with a clear error listing all missing controllers if any\n   * operation references a controller that was not pre-registered.\n   */\n  validateControllers(): void {\n    const missing: Array<{ channel: string; controller: string }> = [];\n\n    for (const [channel, opDef] of this.operations) {\n      if (!this.controllerResolver.has(opDef.controller)) {\n        missing.push({ channel, controller: opDef.controller });\n      }\n    }\n\n    if (missing.length > 0) {\n      const details = missing\n        .map(m => `  - channel \"${m.channel}\" requires controller \"${m.controller}\"`)\n        .join('\\n');\n\n      throw new Error(\n        `WoodRouter: ${missing.length} operation(s) reference controllers that are not registered.\\n` +\n        `This usually means controllers.generated.ts is missing or out of date.\\n` +\n        `Run \"npx wood build\" or \"npx wood dev\" to regenerate it.\\n\\n` +\n        `Missing controllers:\\n${details}`\n      );\n    }\n\n    logger.info(`All ${this.operations.size} operations have registered controllers`);\n  }\n\n  /** Get all registered operation channels. */\n  getChannels(): string[] {\n    return Array.from(this.operations.keys());\n  }\n\n  /** Get a specific operation definition. */\n  getOperation(channel: string): OperationDef | undefined {\n    return this.operations.get(channel);\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/router/wood_router.ts"],"sourcesContent":["import type { OperationDef, IpcContext, WoodMiddlewareContext } from '../types/index.js';\nimport { SchemaValidator } from '../validation/schema_validator.js';\nimport { MiddlewareResolver } from '../middleware/middleware_resolver.js';\nimport { buildMiddlewareContext, executeMiddleware } from '../middleware/middleware_pipeline.js';\nimport { ControllerResolver, buildControllerArgs } from '../controller/controller_resolver.js';\nimport { disposeControllerLifecycle } from '../controller/controller_lifecycle.js';\nimport { getLogger } from '@noego/logger';\nimport { publishMainTrace } from '../tracing/index.js';\n\nconst logger = getLogger('wood:router');\n\nfunction extractTraceConversationId(value: unknown): number | string | undefined {\n  if (!value || typeof value !== 'object' || Array.isArray(value)) {\n    return undefined;\n  }\n\n  const record = value as Record<string, unknown>;\n  if (typeof record.conversationId === 'number' || typeof record.conversationId === 'string') {\n    return record.conversationId;\n  }\n  if (typeof record.threadId === 'number' || typeof record.threadId === 'string') {\n    return record.threadId;\n  }\n\n  return undefined;\n}\n\n/** Reserved internal channels prefixed with __ to avoid collisions with user operations. */\nexport const RESERVED_CHANNELS = ['__load', '__navigate', '__window', '__debug', '__contextMenu', '__woodConfig'] as const;\nexport type ReservedChannel = (typeof RESERVED_CHANNELS)[number];\n\n/** Handler signature for reserved channels. */\nexport type ReservedChannelHandler = (data: unknown, event?: any) => Promise<unknown>;\n\nexport class WoodRouter {\n  private operations = new Map<string, OperationDef>();\n  private reservedHandlers = new Map<ReservedChannel, ReservedChannelHandler>();\n  private validator: SchemaValidator;\n  private middlewareResolver: MiddlewareResolver;\n  private controllerResolver: ControllerResolver;\n  private container: any; // IoC Container\n\n  constructor(options: {\n    container: any;\n    controllersDir: string;\n    middlewareDir: string;\n    mode?: 'bundled' | 'dev';\n  }) {\n    this.container = options.container;\n    this.validator = new SchemaValidator();\n    this.middlewareResolver = new MiddlewareResolver(options.middlewareDir);\n    this.controllerResolver = new ControllerResolver(options.controllersDir, {\n      mode: options.mode,\n    });\n  }\n\n  /**\n   * Load operations from a parsed operations map.\n   */\n  loadOperations(operations: Map<string, OperationDef>): void {\n    for (const [channel, opDef] of operations) {\n      this.operations.set(channel, opDef);\n    }\n    logger.debug(`Loaded ${operations.size} operations`);\n  }\n\n  /**\n   * Register a handler for a reserved channel (__load, __navigate, __window).\n   * These channels are internal to Wood and serve as extension points for\n   * the loader runner, navigation system, and window manager.\n   */\n  registerReservedHandler(channel: ReservedChannel, handler: ReservedChannelHandler): void {\n    this.reservedHandlers.set(channel, handler);\n    logger.debug(`Registered reserved handler for \"${channel}\"`);\n  }\n\n  /**\n   * Register IPC handlers for all operations and reserved channels.\n   * In production: registers with ipcMain.handle\n   * In testing/bridge mode: handlers are callable via dispatch()\n   */\n  registerIpcHandlers(ipcMain: any): void {\n    for (const channel of this.operations.keys()) {\n      ipcMain.handle(channel, async (_event: any, data: unknown) => {\n        return this.dispatch(channel, data, _event);\n      });\n    }\n\n    // Register reserved channels\n    for (const channel of RESERVED_CHANNELS) {\n      ipcMain.handle(channel, async (_event: any, data: unknown) => {\n        const handler = this.reservedHandlers.get(channel);\n        if (!handler) {\n          throw new Error(`No handler registered for reserved channel \"${channel}\"`);\n        }\n        return handler(data, _event);\n      });\n    }\n\n    logger.debug(\n      `Registered ${this.operations.size} operation handlers and ${RESERVED_CHANNELS.length} reserved channels`\n    );\n  }\n\n  /**\n   * The request lifecycle -- mirrors Dinner's pipeline.\n   *\n   * channel -> build context -> middleware -> validate -> resolve controller\n   * -> create instance -> build args -> call action -> return result\n   */\n  async dispatch(channel: string, data: unknown, event?: any): Promise<unknown> {\n    const opDef = this.operations.get(channel);\n    if (!opDef) {\n      throw new Error(`Unknown operation: \"${channel}\"`);\n    }\n\n    const conversationId = extractTraceConversationId(data);\n    publishMainTrace('debug', {\n      source: 'wood.router',\n      type: 'dispatch.start',\n      ...(conversationId !== undefined ? { conversationId } : {}),\n      payload: {\n        channel,\n        controller: opDef.controller,\n        action: opDef.action,\n      },\n    });\n\n    // 1. Build IPC context\n    const ipcContext: IpcContext = {\n      body: data ?? {},\n      params: (data as any) ?? {},\n      query: {},\n      context: {},\n      sender: event?.sender,\n      windowId: undefined,\n    };\n\n    // 2. Execute middleware sequentially\n    if (opDef.middleware.length > 0) {\n      const mwContext = buildMiddlewareContext(ipcContext, channel);\n      const middlewareFns = await Promise.all(\n        opDef.middleware.map(spec => this.middlewareResolver.resolve(spec))\n      );\n      await executeMiddleware(middlewareFns, mwContext);\n    }\n\n    // 3. Validate input (if schema defined)\n    if (opDef.inputSchema) {\n      const result = this.validator.validate(\n        channel,\n        opDef.inputSchema as Record<string, unknown>,\n        ipcContext.body\n      );\n      if (!result.valid) {\n        return {\n          error: 'VALIDATION_ERROR',\n          message: 'Request validation failed',\n          details: result.errors,\n        };\n      }\n    }\n\n    // 4. Resolve controller class (cached)\n    const ControllerClass = await this.controllerResolver.resolveClass(opDef.controller);\n\n    // 5. Create instance via IoC (per-request scoped container)\n    const scopedContainer = this.container.extend();\n    const instance = await scopedContainer.instance(ControllerClass);\n\n    // 6. Build controller args (fake req/res)\n    const args = buildControllerArgs(ipcContext, scopedContainer);\n\n    // 7. Call action, always dispose controller afterward\n    const action = instance[opDef.action];\n    let result: unknown;\n    let actionError: unknown;\n\n    try {\n      if (typeof action !== 'function') {\n        throw new Error(\n          `Controller \"${opDef.controller}\" has no action \"${opDef.action}\"`\n        );\n      }\n\n      result = await action.call(instance, args);\n      publishMainTrace('debug', {\n        source: 'wood.router',\n        type: 'dispatch.success',\n        ...(conversationId !== undefined ? { conversationId } : {}),\n        payload: {\n          channel,\n          controller: opDef.controller,\n          action: opDef.action,\n        },\n      });\n    } catch (error) {\n      actionError = error;\n      publishMainTrace('error', {\n        source: 'wood.router',\n        type: 'dispatch.error',\n        message: error instanceof Error ? error.message : String(error),\n        ...(conversationId !== undefined ? { conversationId } : {}),\n        payload: {\n          channel,\n          controller: opDef.controller,\n          action: opDef.action,\n        },\n      });\n    } finally {\n      try {\n        await disposeControllerLifecycle(instance);\n      } catch (disposeError) {\n        publishMainTrace('error', {\n          source: 'wood.router',\n          type: 'dispatch.dispose.error',\n          message: disposeError instanceof Error ? disposeError.message : String(disposeError),\n          ...(conversationId !== undefined ? { conversationId } : {}),\n          payload: {\n            channel,\n            controller: opDef.controller,\n            action: opDef.action,\n          },\n        });\n\n        if (!actionError) {\n          actionError = disposeError;\n        }\n      }\n    }\n\n    if (actionError) {\n      throw actionError;\n    }\n\n    return result;\n  }\n\n  /**\n   * Pre-register a controller class by name so it is resolved from\n   * the in-memory cache instead of the filesystem.\n   * This is the public API used by the generated registration file.\n   */\n  registerController(name: string, ControllerClass: any): void {\n    this.controllerResolver.register(name, ControllerClass);\n  }\n\n  /**\n   * Register an import path for a controller. The controller will be lazily\n   * imported from this path when first needed, avoiding circular dependencies.\n   */\n  registerControllerPath(name: string, importPath: string): void {\n    this.controllerResolver.registerPath(name, importPath);\n  }\n\n  /**\n   * Validate that every controller referenced in loaded operations is\n   * pre-registered in the controller resolver. Call this after\n   * loadOperations() + registerControllers() but before registerIpcHandlers().\n   *\n   * Throws with a clear error listing all missing controllers if any\n   * operation references a controller that was not pre-registered.\n   */\n  validateControllers(): void {\n    const missing: Array<{ channel: string; controller: string }> = [];\n\n    for (const [channel, opDef] of this.operations) {\n      if (!this.controllerResolver.has(opDef.controller)) {\n        missing.push({ channel, controller: opDef.controller });\n      }\n    }\n\n    if (missing.length > 0) {\n      const details = missing\n        .map(m => `  - channel \"${m.channel}\" requires controller \"${m.controller}\"`)\n        .join('\\n');\n\n      throw new Error(\n        `WoodRouter: ${missing.length} operation(s) reference controllers that are not registered.\\n` +\n        `This usually means controllers.generated.ts is missing or out of date.\\n` +\n        `Run \"npx wood build\" or \"npx wood dev\" to regenerate it.\\n\\n` +\n        `Missing controllers:\\n${details}`\n      );\n    }\n\n    logger.info(`All ${this.operations.size} operations have registered controllers`);\n  }\n\n  /** Get all registered operation channels. */\n  getChannels(): string[] {\n    return Array.from(this.operations.keys());\n  }\n\n  /** Get a specific operation definition. */\n  getOperation(channel: string): OperationDef | undefined {\n    return this.operations.get(channel);\n  }\n}\n"],"mappings":"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","names":["result"]}

package/dist/runtime/runtime.cjs

@@ -55,7 +55,9 @@ async function runtime(options) {
     mode = "bundled",
     enableRendererLogBridge = true,
     enableRendererTraceBridge = true,
-    traceMinLevel
+    traceMinLevel,
+    rendererTraceEnabled = false,
+    rendererTraceMinLevel = "debug"
   } = options;
   const container = options.container ?? (0, import_get_container.getContainer)();
   logger.info("runtime start", {
@@ -65,11 +67,14 @@ async function runtime(options) {
     middlewareDir,
     enableRendererLogBridge,
     enableRendererTraceBridge,
-    traceMinLevel: traceMinLevel ?? "debug"
+    traceMinLevel: traceMinLevel ?? "debug",
+    rendererTraceEnabled,
+    rendererTraceMinLevel
   });
   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");
@@ -119,13 +124,15 @@ async function runtime(options) {
   });
   router.registerReservedHandler("__woodConfig", async () => {
     return {
-      traceMinLevel: traceMinLevel ?? "debug"
+      rendererTraceEnabled,
+      rendererTraceMinLevel
     };
   });
   if (enableRendererLogBridge) {
     registerRendererLogBridge(ipcMain);
   }
-  if (enableRendererTraceBridge) {
+  ipcMain.removeAllListeners?.("__trace");
+  if (enableRendererTraceBridge && rendererTraceEnabled) {
     registerRendererTraceBridge(ipcMain);
   }
   router.registerIpcHandlers(ipcMain);

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 { setMainTraceMinLevel, type TraceLevel } 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  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}\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  } = 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  });\n\n  if (traceMinLevel) {\n    setMainTraceMinLevel(traceMinLevel);\n  }\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.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      traceMinLevel: traceMinLevel ?? 'debug',\n    };\n  });\n\n  if (enableRendererLogBridge) {\n    registerRendererLogBridge(ipcMain);\n  }\n\n  if (enableRendererTraceBridge) {\n    registerRendererTraceBridge(ipcMain);\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(ipcMain: IpcMainLike): void {\n  ipcMain.removeAllListeners?.('__trace');\n\n  ipcMain.on('__trace', (_event, rawPayload) => {\n    dispatchRendererTracePayload(rawPayload);\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 { TraceProviderConfiguration, dispatchRendererTracePayload } from '../tracing/index.js';\nimport { setMainTraceMinLevel, setRendererTraceMinLevel, type TraceLevel } 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}\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.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);\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(ipcMain: IpcMainLike): void {\n  ipcMain.removeAllListeners?.('__trace');\n\n  ipcMain.on('__trace', (_event, rawPayload) => {\n    dispatchRendererTracePayload(rawPayload);\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":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,oBAA0B;AAC1B,yBAA2B;AAC3B,2BAA6B;AAC7B,qBAAyE;AACzE,IAAAA,kBAAgF;AAChF,qCAKO;AAEP,MAAM,aAAS,yBAAU,cAAc;AAkDvC,SAAS,0BAA0B,OAAkC;AACnE,MAAI,UAAU,WAAW,UAAU,UAAU,UAAU,SAAS;AAC9D,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAEA,SAAS,yBACP,YACA,OACkB;AAClB,QAAM,UAAW,cAAc,CAAC;AAChC,QAAM,WAAW;AAEjB,SAAO;AAAA,IACL,OAAO,0BAA0B,QAAQ,KAAK;AAAA,IAC9C,QAAQ,OAAO,QAAQ,WAAW,YAAY,QAAQ,OAAO,KAAK,EAAE,SAAS,IACzE,QAAQ,SACR;AAAA,IACJ,SAAS,OAAO,QAAQ,YAAY,WAAW,QAAQ,UAAU;AAAA,IACjE,SAAS,QAAQ;AAAA,IACjB,YAAW,oBAAI,KAAK,GAAE,YAAY;AAAA,IAClC,UAAU,OAAO,UAAU,QAAQ,OAAO,WAAW,SAAS,OAAO,KAAK;AAAA,EAC5E;AACF;AAKA,eAAsB,QAAQ,SAAiD;AAC7E,QAAM;AAAA,IACJ;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,OAAO;AAAA,IACP,0BAA0B;AAAA,IAC1B,4BAA4B;AAAA,IAC5B;AAAA,IACA,uBAAuB;AAAA,IACvB,wBAAwB;AAAA,EAC1B,IAAI;AAEJ,QAAM,YAAY,QAAQ,iBAAa,mCAAa;AAEpD,SAAO,KAAK,iBAAiB;AAAA,IAC3B;AAAA,IACA,sBAAsB,CAAC,CAAC,QAAQ;AAAA,IAChC;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,eAAe,iBAAiB;AAAA,IAChC;AAAA,IACA;AAAA,EACF,CAAC;AAED,MAAI,eAAe;AACjB,8CAAqB,aAAa;AAAA,EACpC;AACA,gDAAyB,qBAAqB;AAE9C,MAAI,OAAO,UAAU,aAAa,YAAY;AAC5C,UAAM,qBAAqB,MAAM,UAAU,SAAS,yCAA0B;AAC9E,uBAAmB,iBAAiB,MAAM;AAC1C,QAAI,eAAe;AACjB,yBAAmB,kBAAkB,aAAa;AAAA,IACpD;AAAA,EACF;AAEA,QAAM,SAAS,IAAI,8BAAW;AAAA,IAC5B;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC;AAED,kBAAgB,MAAM;AACtB,SAAO,KAAK,+BAA+B;AAE3C,SAAO,oBAAoB;AAC3B,SAAO,KAAK,wCAAwC;AAEpD,SAAO,wBAAwB,UAAU,OAAO,MAAM,UAAU;AAC9D,QAAI,CAAC,QAAQ,QAAQ;AACnB,YAAM,IAAI,MAAM,wEAAwE;AAAA,IAC1F;AACA,WAAO,QAAQ,OAAO,MAAM,KAAK;AAAA,EACnC,CAAC;AAED,SAAO,wBAAwB,cAAc,OAAO,MAAM,UAAU;AAClE,QAAI,CAAC,QAAQ,YAAY;AACvB,YAAM,IAAI,MAAM,gFAAgF;AAAA,IAClG;AACA,WAAO,QAAQ,WAAW,MAAM,KAAK;AAAA,EACvC,CAAC;AAED,SAAO,wBAAwB,YAAY,OAAO,MAAM,UAAU;AAChE,QAAI,CAAC,QAAQ,UAAU;AACrB,YAAM,IAAI,MAAM,4EAA4E;AAAA,IAC9F;AACA,WAAO,QAAQ,SAAS,MAAM,KAAK;AAAA,EACrC,CAAC;AAED,SAAO,wBAAwB,WAAW,OAAO,MAAM,UAAU;AAC/D,QAAI,CAAC,QAAQ,SAAS;AACpB,YAAM,IAAI,MAAM,0EAA0E;AAAA,IAC5F;AACA,WAAO,QAAQ,QAAQ,MAAM,KAAK;AAAA,EACpC,CAAC;AAED,SAAO,wBAAwB,iBAAiB,OAAO,MAAM,UAAU;AACrE,QAAI,CAAC,QAAQ,eAAe;AAC1B,YAAM,IAAI,MAAM,sFAAsF;AAAA,IACxG;AACA,WAAO,QAAQ,cAAc,MAAM,KAAK;AAAA,EAC1C,CAAC;AAED,SAAO,wBAAwB,gBAAgB,YAAY;AACzD,WAAO;AAAA,MACL;AAAA,MACA;AAAA,IACF;AAAA,EACF,CAAC;AAED,MAAI,yBAAyB;AAC3B,8BAA0B,OAAO;AAAA,EACnC;AAEA,UAAQ,qBAAqB,SAAS;AAEtC,MAAI,6BAA6B,sBAAsB;AACrD,gCAA4B,OAAO;AAAA,EACrC;AAEA,SAAO,oBAAoB,OAAO;AAClC,SAAO,KAAK,mCAAmC;AAAA,IAC7C,cAAc,OAAO,YAAY,EAAE;AAAA,IACnC;AAAA,IACA;AAAA,EACF,CAAC;AAED,SAAO,EAAE,OAAO;AAClB;AAEA,SAAS,4BAA4B,SAA4B;AAC/D,UAAQ,qBAAqB,SAAS;AAEtC,UAAQ,GAAG,WAAW,CAAC,QAAQ,eAAe;AAC5C,qDAA6B,UAAU;AAAA,EACzC,CAAC;AAED,SAAO,KAAK,oDAAoD;AAClE;AAEA,SAAS,0BAA0B,SAA4B;AAC7D,QAAM,iBAAa,yDAAyB;AAE5C,UAAQ,qBAAqB,OAAO;AAEpC,UAAQ,GAAG,SAAS,CAAC,QAAQ,eAAe;AAC1C,UAAM,QAAQ,yBAAyB,YAAY,IAAI;AACvD,SAAK,WAAW,SAAS,KAAK,EAAE,KAAK,CAAC,WAAW;AAC/C,YAAM,cAAc;AACpB,UAAI,CAAC,YAAY,IAAI;AACnB,eAAO,KAAK,gCAAgC;AAAA,UAC1C,QAAQ,MAAM;AAAA,UACd,eAAe,MAAM,QAAQ;AAAA,UAC7B,QAAQ,YAAY,UAAU;AAAA,UAC9B,cAAc,YAAY,gBAAgB;AAAA,QAC5C,CAAC;AAAA,MACH;AAAA,IACF,CAAC;AAAA,EACH,CAAC;AAED,SAAO,KAAK,kDAAkD;AAChE;","names":["import_tracing"]}

package/dist/runtime/runtime.d.cts

@@ -23,6 +23,8 @@ interface RuntimeOptions {
     enableRendererLogBridge?: boolean;
     enableRendererTraceBridge?: boolean;
     traceMinLevel?: TraceLevel;
+    rendererTraceEnabled?: boolean;
+    rendererTraceMinLevel?: TraceLevel;
     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

@@ -23,6 +23,8 @@ interface RuntimeOptions {
     enableRendererLogBridge?: boolean;
     enableRendererTraceBridge?: boolean;
     traceMinLevel?: TraceLevel;
+    rendererTraceEnabled?: boolean;
+    rendererTraceMinLevel?: TraceLevel;
     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

@@ -2,7 +2,7 @@ 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 { setMainTraceMinLevel } from "../tracing/index.js";
+import { setMainTraceMinLevel, setRendererTraceMinLevel } from "../tracing/index.js";
 import {
   getRendererLogDispatcher
 } from "./renderer_log_dispatcher.js";
@@ -34,7 +34,9 @@ async function runtime(options) {
     mode = "bundled",
     enableRendererLogBridge = true,
     enableRendererTraceBridge = true,
-    traceMinLevel
+    traceMinLevel,
+    rendererTraceEnabled = false,
+    rendererTraceMinLevel = "debug"
   } = options;
   const container = options.container ?? getContainer();
   logger.info("runtime start", {
@@ -44,11 +46,14 @@ async function runtime(options) {
     middlewareDir,
     enableRendererLogBridge,
     enableRendererTraceBridge,
-    traceMinLevel: traceMinLevel ?? "debug"
+    traceMinLevel: traceMinLevel ?? "debug",
+    rendererTraceEnabled,
+    rendererTraceMinLevel
   });
   if (traceMinLevel) {
     setMainTraceMinLevel(traceMinLevel);
   }
+  setRendererTraceMinLevel(rendererTraceMinLevel);
   if (typeof container.instance === "function") {
     const traceConfiguration = await container.instance(TraceProviderConfiguration);
     traceConfiguration.configureRuntime("main");
@@ -98,13 +103,15 @@ async function runtime(options) {
   });
   router.registerReservedHandler("__woodConfig", async () => {
     return {
-      traceMinLevel: traceMinLevel ?? "debug"
+      rendererTraceEnabled,
+      rendererTraceMinLevel
     };
   });
   if (enableRendererLogBridge) {
     registerRendererLogBridge(ipcMain);
   }
-  if (enableRendererTraceBridge) {
+  ipcMain.removeAllListeners?.("__trace");
+  if (enableRendererTraceBridge && rendererTraceEnabled) {
     registerRendererTraceBridge(ipcMain);
   }
   router.registerIpcHandlers(ipcMain);

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 { setMainTraceMinLevel, type TraceLevel } 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  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}\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  } = 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  });\n\n  if (traceMinLevel) {\n    setMainTraceMinLevel(traceMinLevel);\n  }\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.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      traceMinLevel: traceMinLevel ?? 'debug',\n    };\n  });\n\n  if (enableRendererLogBridge) {\n    registerRendererLogBridge(ipcMain);\n  }\n\n  if (enableRendererTraceBridge) {\n    registerRendererTraceBridge(ipcMain);\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(ipcMain: IpcMainLike): void {\n  ipcMain.removeAllListeners?.('__trace');\n\n  ipcMain.on('__trace', (_event, rawPayload) => {\n    dispatchRendererTracePayload(rawPayload);\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 { TraceProviderConfiguration, dispatchRendererTracePayload } from '../tracing/index.js';\nimport { setMainTraceMinLevel, setRendererTraceMinLevel, type TraceLevel } 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}\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.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);\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(ipcMain: IpcMainLike): void {\n  ipcMain.removeAllListeners?.('__trace');\n\n  ipcMain.on('__trace', (_event, rawPayload) => {\n    dispatchRendererTracePayload(rawPayload);\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":[]}

package/dist/testing/create_controller_harness.cjs

@@ -27,6 +27,7 @@ var import_ipc = require("../ipc/index.js");
 var import_navigation = require("../navigation/index.js");
 var import_tracing = require("../tracing/index.js");
 var import_operations_parser = require("../parser/operations_parser.cjs");
+var import_controller_lifecycle = require("../controller/controller_lifecycle.cjs");
 var import_create_router_bridge = require("./create_router_bridge.cjs");
 var import_create_test_router = require("./create_test_router.cjs");
 function readOperations(input) {
@@ -60,6 +61,7 @@ function registerClientBuiltins(container) {
   const traceConfiguration = new import_tracing.TraceProviderConfiguration();
   traceConfiguration.configureMode("test");
   traceConfiguration.configureRuntime("renderer");
+  traceConfiguration.configureEnabled(true);
   container.registerFunction(import_navigation.Navigation, () => (0, import_navigation.getNavigation)());
   container.registerFunction(import_client.App, () => (0, import_client.getApp)());
   container.registerFunction(import_client.Ipc, () => (0, import_ipc.getIpc)());
@@ -141,14 +143,12 @@ async function createControllerHarness(options) {
     container: scopedContainer,
     navigation,
     trace,
-    destroy: () => {
+    destroy: async () => {
       trace.info({
         source: "wood.testing.controller-harness",
         type: "harness.destroyed"
       });
-      if (typeof controller.destroy === "function") {
-        controller.destroy();
-      }
+      await (0, import_controller_lifecycle.disposeControllerLifecycle)(controller);
       events.clear();
       (0, import_client.clearClientContainerForTests)();
       (0, import_client.clearClientAppForTests)();