@noego/wood 0.5.0 → 0.6.0

package/dist/router/wood_router.cjs

@@ -22,6 +22,7 @@ __export(wood_router_exports, {
   WoodRouter: () => WoodRouter
 });
 module.exports = __toCommonJS(wood_router_exports);
+var import_reflect_metadata = require("reflect-metadata");
 var import_types = require("../types/index.cjs");
 var import_schema_validator = require("../validation/schema_validator.cjs");
 var import_middleware_resolver = require("../middleware/middleware_resolver.cjs");
@@ -58,15 +59,42 @@ function controllerAlreadyRegistered(scope, ControllerClass) {
   const candidate = scope;
   return typeof candidate.isRegistered === "function" && candidate.isRegistered(ControllerClass);
 }
+async function dispatchReserved(container, reserved, data, event) {
+  const scope = container.extend();
+  let outcome;
+  try {
+    outcome = { ok: true, value: await import_ioc.ExecutionContext.run(scope, () => reserved(data, event)) };
+  } catch (error) {
+    outcome = { ok: false, error };
+  }
+  try {
+    await import_ioc.ExecutionContext.run(scope, () => scope.dispose?.());
+  } catch (cleanupError) {
+    throw Object.assign(new Error("Wood reserved operation cleanup failed"), {
+      cause: outcome.ok ? cleanupError : outcome.error,
+      errors: [...outcome.ok ? [] : [outcome.error], cleanupError]
+    });
+  }
+  if (!outcome.ok) throw outcome.error;
+  return outcome.value;
+}
 class WoodRouter {
   // IoC Container
   constructor(options) {
     this.operations = /* @__PURE__ */ new Map();
     this.reservedHandlers = /* @__PURE__ */ new Map();
+    /**
+     * The request lifecycle -- mirrors Dinner's pipeline.
+     *
+     * channel -> build context -> middleware -> validate -> resolve controller
+     * -> create instance -> build args -> call action -> return result
+     */
+    this.accepting = true;
+    this.pending = /* @__PURE__ */ new Map();
     this.container = options.container;
-    this.validator = new import_schema_validator.SchemaValidator();
-    this.middlewareResolver = new import_middleware_resolver.MiddlewareResolver(options.middlewareDir);
-    this.controllerResolver = new import_controller_resolver.ControllerResolver(options.controllersDir, {
+    this.validator = options.validator ?? new import_schema_validator.SchemaValidator();
+    this.middlewareResolver = options.middlewareResolver ?? new import_middleware_resolver.MiddlewareResolver(options.middlewareDir);
+    this.controllerResolver = options.controllerResolver ?? new import_controller_resolver.ControllerResolver(options.controllersDir, {
       mode: options.mode
     });
   }
@@ -101,40 +129,131 @@ class WoodRouter {
     }
     for (const channel of RESERVED_CHANNELS) {
       ipcMain.handle(channel, async (_event, data) => {
-        const handler = this.reservedHandlers.get(channel);
-        if (!handler) {
-          throw new Error(`No handler registered for reserved channel "${channel}"`);
-        }
-        return handler(data, _event);
+        return this.dispatch(channel, data, _event);
       });
     }
     logger.debug(
       `Registered ${this.operations.size} operation handlers and ${RESERVED_CHANNELS.length} reserved channels`
     );
   }
-  /**
-   * The request lifecycle -- mirrors Dinner's pipeline.
-   *
-   * channel -> build context -> middleware -> validate -> resolve controller
-   * -> create instance -> build args -> call action -> return result
-   */
-  async dispatch(channel, data, event) {
-    const opDef = this.operations.get(channel);
-    if (!opDef) {
-      throw new Error(`Unknown operation: "${channel}"`);
+  dispatch(channel, data, event) {
+    if (!this.accepting) return Promise.reject(new Error("Wood router is closed"));
+    const work = this.dispatchOwned(channel, data, event);
+    this.pending.set(work, channel);
+    void work.then(() => this.pending.delete(work), () => this.pending.delete(work));
+    return work;
+  }
+  async drain(timeoutMs = 5e3) {
+    if (!Number.isFinite(timeoutMs) || timeoutMs < 0) throw new Error("Wood drain timeoutMs must be finite and non-negative");
+    let timer;
+    try {
+      await Promise.race([
+        (async () => {
+          while (this.pending.size) await Promise.allSettled([...this.pending.keys()]);
+        })(),
+        new Promise((_, reject) => {
+          timer = setTimeout(() => reject(new Error(
+            `Wood drain timed out: pending operations: ${[...this.pending.values()].join(", ")}`
+          )), timeoutMs);
+        })
+      ]);
+    } finally {
+      if (timer !== void 0) clearTimeout(timer);
+    }
+  }
+  async dispose(timeoutMs) {
+    this.accepting = false;
+    await this.drain(timeoutMs);
+  }
+  async dispatchOwned(channel, data, event) {
+    const reserved = this.reservedHandlers.get(channel);
+    if (reserved) return dispatchReserved(this.container, reserved, data, event);
+    if (RESERVED_CHANNELS.includes(channel)) {
+      throw new Error(`No handler registered for reserved channel "${channel}"`);
     }
+    const opDef = this.operations.get(channel);
+    if (!opDef) throw new Error(`Unknown operation: "${channel}"`);
     const conversationId = extractTraceConversationId(data);
-    (0, import_tracing.publishMainTrace)("debug", {
-      source: "wood.router",
-      type: "dispatch.start",
-      ...conversationId !== void 0 ? { conversationId } : {},
-      payload: {
-        channel,
-        controller: opDef.controller,
-        action: opDef.action
-      }
-    });
-    const ipcContext = {
+    this.publishDispatchTrace("dispatch.start", channel, opDef, conversationId);
+    const ControllerClass = await this.prepareController(opDef);
+    const outcome = await this.executeOperation(
+      channel,
+      data,
+      event,
+      opDef,
+      ControllerClass,
+      conversationId
+    );
+    if (!outcome.ok) {
+      this.publishDispatchError(channel, opDef, conversationId, outcome.error);
+      throw outcome.error;
+    }
+    this.publishDispatchTrace("dispatch.success", channel, opDef, conversationId);
+    return outcome.value;
+  }
+  async prepareController(opDef) {
+    const ControllerClass = await this.controllerResolver.resolveClass(opDef.controller);
+    const singletonController = Reflect.getMetadata(/* @__PURE__ */ Symbol.for("ioc:component:options"), ControllerClass)?.scope === import_ioc.LoadAs.Singleton;
+    if (singletonController && typeof this.container.isRegistered === "function" && !controllerAlreadyRegistered(this.container, ControllerClass)) {
+      this.container.registerClass?.(ControllerClass);
+    }
+    return ControllerClass;
+  }
+  async executeOperation(channel, data, event, opDef, ControllerClass, conversationId) {
+    const scopedContainer = this.container.extend();
+    const state = { instance: void 0, ownsController: false };
+    let outcome;
+    const cleanup = [];
+    try {
+      const value = await import_ioc.ExecutionContext.run(
+        scopedContainer,
+        () => this.invokeController(
+          channel,
+          data,
+          event,
+          opDef,
+          ControllerClass,
+          conversationId,
+          scopedContainer,
+          state
+        )
+      );
+      outcome = { ok: true, value };
+    } catch (error) {
+      outcome = { ok: false, error };
+    } finally {
+      await this.cleanupOperation(scopedContainer, state, cleanup);
+    }
+    if (cleanup.length) {
+      throw Object.assign(
+        new Error(`Wood operation cleanup failed${outcome.ok ? "" : ": " + String(outcome.error)}`),
+        {
+          cause: outcome.ok ? cleanup[0] : outcome.error,
+          errors: [...outcome.ok ? [] : [outcome.error], ...cleanup]
+        }
+      );
+    }
+    return outcome;
+  }
+  async invokeController(channel, data, event, opDef, ControllerClass, conversationId, scopedContainer, state) {
+    const ipcContext = this.buildIpcContext(data, event);
+    await this.executeOperationMiddleware(channel, opDef, ipcContext);
+    this.validateOperation(channel, opDef, ipcContext, conversationId);
+    state.ownsController = !controllerAlreadyRegistered(this.container, ControllerClass);
+    if (!controllerAlreadyRegistered(scopedContainer, ControllerClass) && typeof scopedContainer.registerClass === "function") {
+      scopedContainer.registerClass(ControllerClass);
+    }
+    state.instance = await scopedContainer.instance(ControllerClass);
+    (0, import_controller_lifecycle.guardControllerLifecycleOnce)(state.instance);
+    const args = (0, import_controller_resolver.usesOperationContext)(ControllerClass) ? (0, import_controller_resolver.buildOperationContext)(channel, ipcContext) : (0, import_controller_resolver.buildControllerArgs)(ipcContext, scopedContainer);
+    const action = state.instance[opDef.action];
+    if (typeof action !== "function") {
+      throw new Error(`Controller "${opDef.controller}" has no action "${opDef.action}"`);
+    }
+    return await action.call(state.instance, args);
+  }
+  buildIpcContext(data, event) {
+    return {
       body: data ?? {},
       params: data ?? {},
       query: {},
@@ -142,105 +261,67 @@ class WoodRouter {
       sender: event?.sender,
       windowId: void 0
     };
-    if (opDef.middleware.length > 0) {
-      const mwContext = (0, import_middleware_pipeline.buildMiddlewareContext)(ipcContext, channel);
-      const middlewareFns = await Promise.all(
-        opDef.middleware.map((spec) => this.middlewareResolver.resolve(spec))
-      );
-      await (0, import_middleware_pipeline.executeMiddleware)(middlewareFns, mwContext);
-    }
-    if (opDef.inputSchema) {
-      const result2 = this.validator.validate(
+  }
+  async executeOperationMiddleware(channel, opDef, ipcContext) {
+    if (!opDef.middleware.length) return;
+    const mwContext = (0, import_middleware_pipeline.buildMiddlewareContext)(ipcContext, channel);
+    const middlewareFns = await Promise.all(
+      opDef.middleware.map((spec) => this.middlewareResolver.resolve(spec))
+    );
+    await (0, import_middleware_pipeline.executeMiddleware)(middlewareFns, mwContext);
+  }
+  validateOperation(channel, opDef, ipcContext, conversationId) {
+    if (!opDef.inputSchema) return;
+    const result = this.validator.validate(
+      channel,
+      opDef.inputSchema,
+      ipcContext.body
+    );
+    if (result.valid) return;
+    (0, import_tracing.publishMainTrace)("error", {
+      source: "wood.router",
+      type: "dispatch.validation_error",
+      message: "Request validation failed",
+      ...conversationId !== void 0 ? { conversationId } : {},
+      payload: {
         channel,
-        opDef.inputSchema,
-        ipcContext.body
-      );
-      if (!result2.valid) {
-        (0, import_tracing.publishMainTrace)("error", {
-          source: "wood.router",
-          type: "dispatch.validation_error",
-          message: "Request validation failed",
-          ...conversationId !== void 0 ? { conversationId } : {},
-          payload: {
-            channel,
-            controller: opDef.controller,
-            action: opDef.action,
-            errorCount: result2.errors?.length ?? 0
-          }
-        });
-        throw new import_types.WoodValidationError("Request validation failed", result2.errors ?? []);
+        controller: opDef.controller,
+        action: opDef.action,
+        errorCount: result.errors?.length ?? 0
       }
-    }
-    const ControllerClass = await this.controllerResolver.resolveClass(opDef.controller);
-    const scopedContainer = this.container.extend();
-    if (!controllerAlreadyRegistered(scopedContainer, ControllerClass) && typeof scopedContainer.registerClass === "function") {
-      scopedContainer.registerClass(ControllerClass);
-    }
-    const instance = await import_ioc.ExecutionContext.run(
-      scopedContainer,
-      () => scopedContainer.instance(ControllerClass)
-    );
-    const args = (0, import_controller_resolver.usesOperationContext)(ControllerClass) ? (0, import_controller_resolver.buildOperationContext)(channel, ipcContext) : (0, import_controller_resolver.buildControllerArgs)(ipcContext, scopedContainer);
-    const action = instance[opDef.action];
-    let result;
-    let actionError;
-    try {
-      if (typeof action !== "function") {
-        throw new Error(
-          `Controller "${opDef.controller}" has no action "${opDef.action}"`
-        );
+    });
+    throw new import_types.WoodValidationError("Request validation failed", result.errors ?? []);
+  }
+  async cleanupOperation(scopedContainer, state, cleanup) {
+    await import_ioc.ExecutionContext.run(scopedContainer, async () => {
+      try {
+        if (state.ownsController) await (0, import_controller_lifecycle.disposeControllerLifecycle)(state.instance);
+      } catch (error) {
+        cleanup.push(error);
       }
-      result = await import_ioc.ExecutionContext.run(scopedContainer, () => action.call(instance, args));
-      (0, import_tracing.publishMainTrace)("debug", {
-        source: "wood.router",
-        type: "dispatch.success",
-        ...conversationId !== void 0 ? { conversationId } : {},
-        payload: {
-          channel,
-          controller: opDef.controller,
-          action: opDef.action
-        }
-      });
-    } catch (error) {
-      actionError = error;
-      (0, import_tracing.publishMainTrace)("error", {
-        source: "wood.router",
-        type: "dispatch.error",
-        message: error instanceof Error ? error.message : String(error),
-        ...conversationId !== void 0 ? { conversationId } : {},
-        payload: {
-          channel,
-          controller: opDef.controller,
-          action: opDef.action
-        }
-      });
-    } finally {
       try {
-        await (0, import_controller_lifecycle.disposeControllerLifecycle)(instance);
-        if (typeof scopedContainer.dispose === "function") {
-          await scopedContainer.dispose();
-        }
-      } 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;
-        }
+        await scopedContainer.dispose?.();
+      } catch (error) {
+        cleanup.push(error);
       }
-    }
-    if (actionError) {
-      throw actionError;
-    }
-    return result;
+    });
+  }
+  publishDispatchTrace(type, channel, opDef, conversationId) {
+    (0, import_tracing.publishMainTrace)("debug", {
+      source: "wood.router",
+      type,
+      ...conversationId !== void 0 ? { conversationId } : {},
+      payload: { channel, controller: opDef.controller, action: opDef.action }
+    });
+  }
+  publishDispatchError(channel, opDef, conversationId, error) {
+    (0, import_tracing.publishMainTrace)("error", {
+      source: "wood.router",
+      type: "dispatch.error",
+      message: error instanceof Error ? error.message : String(error),
+      ...conversationId !== void 0 ? { conversationId } : {},
+      payload: { channel, controller: opDef.controller, action: opDef.action }
+    });
   }
   /**
    * 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 { WoodValidationError } 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, buildOperationContext, usesOperationContext } from '../controller/controller_resolver.cjs';\nimport { disposeControllerLifecycle } from '../controller/controller_lifecycle.cjs';\nimport { getLogger } from '@noego/logger';\nimport { ExecutionContext } from '@noego/ioc';\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 = [\n  '__load',\n  '__navigate',\n  '__window',\n  '__debug',\n  '__contextMenu',\n  '__woodConfig',\n  '__traceBatch',\n] 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\n/**\n * Whether the scope (or an ancestor) already holds a registration for the\n * controller token. Containers without the query (fakes, older runtimes)\n * report false so the router registers as it always did.\n */\nfunction controllerAlreadyRegistered(scope: unknown, ControllerClass: unknown): boolean {\n  const candidate = scope as { isRegistered?: (label: unknown) => boolean };\n  return typeof candidate.isRegistered === 'function' && candidate.isRegistered(ControllerClass);\n}\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        publishMainTrace('error', {\n          source: 'wood.router',\n          type: 'dispatch.validation_error',\n          message: 'Request validation failed',\n          ...(conversationId !== undefined ? { conversationId } : {}),\n          payload: {\n            channel,\n            controller: opDef.controller,\n            action: opDef.action,\n            errorCount: result.errors?.length ?? 0,\n          },\n        });\n        throw new WoodValidationError('Request validation failed', result.errors ?? []);\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). Plain\n    // undecorated controller classes are part of Wood's contract, so the\n    // class is registered on the scope first — a bare registration defers\n    // to @Component options when the class is decorated. A registration\n    // already present in the hierarchy (a root-level substitution of the\n    // controller token, e.g. a test seam) is left untouched so it keeps\n    // deciding how the controller resolves inside this dispatch scope.\n    const scopedContainer = this.container.extend();\n    if (!controllerAlreadyRegistered(scopedContainer, ControllerClass)\n      && typeof scopedContainer.registerClass === 'function') {\n      scopedContainer.registerClass(ControllerClass);\n    }\n    // Framework boundary (D25): the whole operation — controller\n    // construction included — executes under the operation scope's context.\n    // Constructors may invoke injected collaborators, and any caller context\n    // (e.g. an in-process renderer harness bridging into this backend root)\n    // must be severed exactly as the production IPC process hop severs it.\n    const instance = await ExecutionContext.run(scopedContainer, () =>\n      scopedContainer.instance(ControllerClass)\n    );\n\n    // 6. Build the action argument: native operation context for controllers\n    // that opted in (static woodContext = 'operation'), legacy fake req/res\n    // args for everything else (migration-only compat).\n    const args = usesOperationContext(ControllerClass)\n      ? buildOperationContext(channel, ipcContext)\n      : 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      // Framework boundary: the dispatch executes under ITS operation scope\n      // (D25 — boundaries establish context automatically). This also severs\n      // any caller context, e.g. an in-process renderer harness bridging a\n      // call into this backend root — the production equivalent is the IPC\n      // process hop, which carries no context at all.\n      result = await ExecutionContext.run(scopedContainer, () => 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        // One operation = one IoC scope: dispose the complete scoped graph\n        // (services, state, resources), not only the controller instance.\n        // The controller-lifecycle hook runs first so legacy dispose/destroy\n        // conventions keep their ordering; scope disposal dedupes instances\n        // it has already seen. Containers without dispose() (legacy fakes)\n        // are tolerated during migration.\n        if (typeof (scopedContainer as { dispose?: () => Promise<void> }).dispose === 'function') {\n          await (scopedContainer as { dispose: () => Promise<void> }).dispose();\n        }\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   * Pre-register the executable for a production middleware identity so it\n   * resolves from the registry instead of the filesystem — the bundled-mode\n   * path for middleware, and the seam test environments use to replace an\n   * identity's behavior without touching source topology.\n   */\n  registerMiddleware(spec: string, middleware: import('../types/index.cjs').WoodMiddlewareFn): void {\n    this.middlewareResolver.register(spec, middleware);\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   * Register a caller-owned lazy loader for a controller: the module is\n   * imported through the CALLER's `() => import('…literal specifier…')` only\n   * on first dispatch, preserving the caller's module identity for the\n   * controller graph (thin production slices in tests).\n   */\n  registerControllerLoader(name: string, loader: () => Promise<unknown>): void {\n    this.controllerResolver.registerLoader(name, loader);\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  /**\n   * Eagerly compile every operation's inputSchema so a malformed schema fails\n   * at startup (with the offending channel named) instead of throwing an opaque\n   * ajv error on the first request to that channel. Call after loadOperations().\n   */\n  precompileSchemas(): void {\n    let compiled = 0;\n    for (const [channel, opDef] of this.operations) {\n      if (opDef.inputSchema) {\n        this.validator.precompile(channel, opDef.inputSchema as Record<string, unknown>);\n        compiled += 1;\n      }\n    }\n    logger.info(`Pre-compiled ${compiled} operation input schema(s)`);\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"]}
+{"version":3,"sources":["../../src/router/wood_router.ts"],"sourcesContent":["import 'reflect-metadata';\nimport type { OperationDef, IpcContext, WoodMiddlewareContext } from '../types/index.cjs';\nimport { WoodValidationError } 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, buildOperationContext, usesOperationContext } from '../controller/controller_resolver.cjs';\nimport { disposeControllerLifecycle, guardControllerLifecycleOnce } from '../controller/controller_lifecycle.cjs';\nimport { getLogger } from '@noego/logger';\nimport { ExecutionContext, LoadAs } from '@noego/ioc';\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 = [\n  '__load',\n  '__navigate',\n  '__window',\n  '__debug',\n  '__contextMenu',\n  '__woodConfig',\n  '__traceBatch',\n] 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\n/**\n * Whether the scope (or an ancestor) already holds a registration for the\n * controller token. Containers without the query (fakes, older runtimes)\n * report false so the router registers as it always did.\n */\nfunction controllerAlreadyRegistered(scope: unknown, ControllerClass: unknown): boolean {\n  const candidate = scope as { isRegistered?: (label: unknown) => boolean };\n  return typeof candidate.isRegistered === 'function' && candidate.isRegistered(ControllerClass);\n}\n\ntype ControllerClass = new (...args: any[]) => any;\n\ninterface ControllerExecutionState {\n  instance: any;\n  ownsController: boolean;\n}\n\ntype OperationOutcome =\n  | { readonly ok: true; readonly value: unknown }\n  | { readonly ok: false; readonly error: unknown };\n\nasync function dispatchReserved(\n  container: any,\n  reserved: ReservedChannelHandler,\n  data: unknown,\n  event?: any,\n): Promise<unknown> {\n  const scope = container.extend();\n  let outcome: OperationOutcome;\n  try {\n    outcome = { ok: true, value: await ExecutionContext.run(scope, () => reserved(data, event)) };\n  } catch (error) {\n    outcome = { ok: false, error };\n  }\n\n  try {\n    await ExecutionContext.run(scope, () => scope.dispose?.());\n  } catch (cleanupError) {\n    throw Object.assign(new Error('Wood reserved operation cleanup failed'), {\n      cause: outcome.ok ? cleanupError : outcome.error,\n      errors: [...(outcome.ok ? [] : [outcome.error]), cleanupError],\n    });\n  }\n  if (!outcome.ok) throw outcome.error;\n  return outcome.value;\n}\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    validator?: SchemaValidator;\n    middlewareResolver?: MiddlewareResolver;\n    controllerResolver?: ControllerResolver;\n  }) {\n    this.container = options.container;\n    this.validator = options.validator ?? new SchemaValidator();\n    this.middlewareResolver = options.middlewareResolver ?? new MiddlewareResolver(options.middlewareDir);\n    this.controllerResolver = options.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        return this.dispatch(channel, 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  private accepting = true;\n  private readonly pending = new Map<Promise<unknown>, string>();\n\n  dispatch(channel: string, data: unknown, event?: any): Promise<unknown> {\n    if (!this.accepting) return Promise.reject(new Error('Wood router is closed'));\n    const work = this.dispatchOwned(channel, data, event);\n    this.pending.set(work, channel);\n    void work.then(() => this.pending.delete(work), () => this.pending.delete(work));\n    return work;\n  }\n\n  async drain(timeoutMs = 5000): Promise<void> {\n    if (!Number.isFinite(timeoutMs) || timeoutMs < 0) throw new Error('Wood drain timeoutMs must be finite and non-negative');\n    let timer: ReturnType<typeof setTimeout> | undefined;\n    try {\n      await Promise.race([\n        (async () => { while (this.pending.size) await Promise.allSettled([...this.pending.keys()]); })(),\n        new Promise<never>((_, reject) => { timer = setTimeout(() => reject(new Error(\n          `Wood drain timed out: pending operations: ${[...this.pending.values()].join(', ')}`,\n        )), timeoutMs); }),\n      ]);\n    } finally { if (timer !== undefined) clearTimeout(timer); }\n  }\n\n  async dispose(timeoutMs?: number): Promise<void> {\n    this.accepting = false;\n    await this.drain(timeoutMs);\n  }\n\n  private async dispatchOwned(channel: string, data: unknown, event?: any): Promise<unknown> {\n    const reserved = this.reservedHandlers.get(channel as ReservedChannel);\n    if (reserved) return dispatchReserved(this.container, reserved, data, event);\n    if ((RESERVED_CHANNELS as readonly string[]).includes(channel)) {\n      throw new Error(`No handler registered for reserved channel \"${channel}\"`);\n    }\n\n    const opDef = this.operations.get(channel);\n    if (!opDef) throw new Error(`Unknown operation: \"${channel}\"`);\n\n    const conversationId = extractTraceConversationId(data);\n    this.publishDispatchTrace('dispatch.start', channel, opDef, conversationId);\n    const ControllerClass = await this.prepareController(opDef);\n    const outcome = await this.executeOperation(\n      channel,\n      data,\n      event,\n      opDef,\n      ControllerClass,\n      conversationId,\n    );\n    if (!outcome.ok) {\n      this.publishDispatchError(channel, opDef, conversationId, outcome.error);\n      throw outcome.error;\n    }\n    this.publishDispatchTrace('dispatch.success', channel, opDef, conversationId);\n    return outcome.value;\n  }\n\n  private async prepareController(opDef: OperationDef): Promise<ControllerClass> {\n    // Register discovered controller definitions on the application root before\n    // extending: child scopes snapshot registrations, while singleton ownership\n    // is root-wide. Registering first in a request scope breaks the next request.\n    const ControllerClass = await this.controllerResolver.resolveClass(opDef.controller);\n    const singletonController =\n      Reflect.getMetadata(Symbol.for('ioc:component:options'), ControllerClass)?.scope === LoadAs.Singleton;\n    if (singletonController && typeof this.container.isRegistered === 'function'\n      && !controllerAlreadyRegistered(this.container, ControllerClass)) {\n      this.container.registerClass?.(ControllerClass);\n    }\n    return ControllerClass;\n  }\n\n  private async executeOperation(\n    channel: string,\n    data: unknown,\n    event: any,\n    opDef: OperationDef,\n    ControllerClass: ControllerClass,\n    conversationId: number | string | undefined,\n  ): Promise<OperationOutcome> {\n    const scopedContainer = this.container.extend();\n    const state: ControllerExecutionState = { instance: undefined, ownsController: false };\n    let outcome: OperationOutcome;\n    const cleanup: unknown[] = [];\n    try {\n      const value = await ExecutionContext.run(\n        scopedContainer,\n        () => this.invokeController(\n          channel,\n          data,\n          event,\n          opDef,\n          ControllerClass,\n          conversationId,\n          scopedContainer,\n          state,\n        ),\n      );\n      outcome = { ok: true, value };\n    } catch (error) {\n      outcome = { ok: false, error };\n    } finally {\n      await this.cleanupOperation(scopedContainer, state, cleanup);\n    }\n\n    if (cleanup.length) {\n      throw Object.assign(\n        new Error(`Wood operation cleanup failed${outcome.ok ? '' : ': ' + String(outcome.error)}`),\n        {\n          cause: outcome.ok ? cleanup[0] : outcome.error,\n          errors: [...(outcome.ok ? [] : [outcome.error]), ...cleanup],\n        },\n      );\n    }\n    return outcome;\n  }\n\n  private async invokeController(\n    channel: string,\n    data: unknown,\n    event: any,\n    opDef: OperationDef,\n    ControllerClass: ControllerClass,\n    conversationId: number | string | undefined,\n    scopedContainer: any,\n    state: ControllerExecutionState,\n  ): Promise<unknown> {\n    const ipcContext = this.buildIpcContext(data, event);\n    await this.executeOperationMiddleware(channel, opDef, ipcContext);\n    this.validateOperation(channel, opDef, ipcContext, conversationId);\n\n    // Resolve the controller through the inherited, pre-overlay definition.\n    state.ownsController = !controllerAlreadyRegistered(this.container, ControllerClass);\n    if (!controllerAlreadyRegistered(scopedContainer, ControllerClass)\n      && typeof scopedContainer.registerClass === 'function') {\n      scopedContainer.registerClass(ControllerClass);\n    }\n\n    // Framework boundary (D25): the whole operation — controller construction\n    // included — executes under the operation scope's context. Constructors may\n    // invoke injected collaborators, and any caller context must be severed\n    // exactly as the production IPC process hop severs it.\n    state.instance = await scopedContainer.instance(ControllerClass);\n    guardControllerLifecycleOnce(state.instance);\n    const args = usesOperationContext(ControllerClass)\n      ? buildOperationContext(channel, ipcContext)\n      : buildControllerArgs(ipcContext, scopedContainer);\n    const action = state.instance[opDef.action];\n    if (typeof action !== 'function') {\n      throw new Error(`Controller \"${opDef.controller}\" has no action \"${opDef.action}\"`);\n    }\n    return await action.call(state.instance, args);\n  }\n\n  private buildIpcContext(data: unknown, event: any): IpcContext {\n    return {\n      body: data ?? {},\n      params: (data as any) ?? {},\n      query: {},\n      context: {},\n      sender: event?.sender,\n      windowId: undefined,\n    };\n  }\n\n  private async executeOperationMiddleware(\n    channel: string,\n    opDef: OperationDef,\n    ipcContext: IpcContext,\n  ): Promise<void> {\n    if (!opDef.middleware.length) return;\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  private validateOperation(\n    channel: string,\n    opDef: OperationDef,\n    ipcContext: IpcContext,\n    conversationId: number | string | undefined,\n  ): void {\n    if (!opDef.inputSchema) return;\n    const result = this.validator.validate(\n      channel,\n      opDef.inputSchema as Record<string, unknown>,\n      ipcContext.body,\n    );\n    if (result.valid) return;\n    publishMainTrace('error', {\n      source: 'wood.router',\n      type: 'dispatch.validation_error',\n      message: 'Request validation failed',\n      ...(conversationId !== undefined ? { conversationId } : {}),\n      payload: {\n        channel,\n        controller: opDef.controller,\n        action: opDef.action,\n        errorCount: result.errors?.length ?? 0,\n      },\n    });\n    throw new WoodValidationError('Request validation failed', result.errors ?? []);\n  }\n\n  private async cleanupOperation(\n    scopedContainer: any,\n    state: ControllerExecutionState,\n    cleanup: unknown[],\n  ): Promise<void> {\n    // Each cleanup is attempted even if the preceding hook rejects.\n    await ExecutionContext.run(scopedContainer, async () => {\n      try {\n        if (state.ownsController) await disposeControllerLifecycle(state.instance);\n      } catch (error) {\n        cleanup.push(error);\n      }\n      try {\n        await scopedContainer.dispose?.();\n      } catch (error) {\n        cleanup.push(error);\n      }\n    });\n  }\n\n  private publishDispatchTrace(\n    type: 'dispatch.start' | 'dispatch.success',\n    channel: string,\n    opDef: OperationDef,\n    conversationId: number | string | undefined,\n  ): void {\n    publishMainTrace('debug', {\n      source: 'wood.router',\n      type,\n      ...(conversationId !== undefined ? { conversationId } : {}),\n      payload: { channel, controller: opDef.controller, action: opDef.action },\n    });\n  }\n\n  private publishDispatchError(\n    channel: string,\n    opDef: OperationDef,\n    conversationId: number | string | undefined,\n    error: unknown,\n  ): void {\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: { channel, controller: opDef.controller, action: opDef.action },\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   * Pre-register the executable for a production middleware identity so it\n   * resolves from the registry instead of the filesystem — the bundled-mode\n   * path for middleware, and the seam test environments use to replace an\n   * identity's behavior without touching source topology.\n   */\n  registerMiddleware(spec: string, middleware: import('../types/index.cjs').WoodMiddlewareFn): void {\n    this.middlewareResolver.register(spec, middleware);\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   * Register a caller-owned lazy loader for a controller: the module is\n   * imported through the CALLER's `() => import('…literal specifier…')` only\n   * on first dispatch, preserving the caller's module identity for the\n   * controller graph (thin production slices in tests).\n   */\n  registerControllerLoader(name: string, loader: () => Promise<unknown>): void {\n    this.controllerResolver.registerLoader(name, loader);\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  /**\n   * Eagerly compile every operation's inputSchema so a malformed schema fails\n   * at startup (with the offending channel named) instead of throwing an opaque\n   * ajv error on the first request to that channel. Call after loadOperations().\n   */\n  precompileSchemas(): void {\n    let compiled = 0;\n    for (const [channel, opDef] of this.operations) {\n      if (opDef.inputSchema) {\n        this.validator.precompile(channel, opDef.inputSchema as Record<string, unknown>);\n        compiled += 1;\n      }\n    }\n    logger.info(`Pre-compiled ${compiled} operation input schema(s)`);\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":[]}

package/dist/router/wood_router.d.cts

@@ -1,5 +1,8 @@
 import { OperationDef } from '../types/operations.cjs';
 import { WoodMiddlewareFn } from '../types/context.cjs';
+import { SchemaValidator } from '../validation/schema_validator.cjs';
+import { MiddlewareResolver } from '../middleware/middleware_resolver.cjs';
+import { ControllerResolver } from '../controller/controller_resolver.cjs';
 
 /** Reserved internal channels prefixed with __ to avoid collisions with user operations. */
 declare const RESERVED_CHANNELS: readonly ["__load", "__navigate", "__window", "__debug", "__contextMenu", "__woodConfig", "__traceBatch"];
@@ -18,6 +21,9 @@ declare class WoodRouter {
         controllersDir: string;
         middlewareDir: string;
         mode?: 'bundled' | 'dev';
+        validator?: SchemaValidator;
+        middlewareResolver?: MiddlewareResolver;
+        controllerResolver?: ControllerResolver;
     });
     /**
      * Load operations from a parsed operations map.
@@ -41,7 +47,21 @@ declare class WoodRouter {
      * channel -> build context -> middleware -> validate -> resolve controller
      * -> create instance -> build args -> call action -> return result
      */
+    private accepting;
+    private readonly pending;
     dispatch(channel: string, data: unknown, event?: any): Promise<unknown>;
+    drain(timeoutMs?: number): Promise<void>;
+    dispose(timeoutMs?: number): Promise<void>;
+    private dispatchOwned;
+    private prepareController;
+    private executeOperation;
+    private invokeController;
+    private buildIpcContext;
+    private executeOperationMiddleware;
+    private validateOperation;
+    private cleanupOperation;
+    private publishDispatchTrace;
+    private publishDispatchError;
     /**
      * Pre-register a controller class by name so it is resolved from
      * the in-memory cache instead of the filesystem.

package/dist/router/wood_router.d.ts

@@ -1,5 +1,8 @@
 import { OperationDef } from '../types/operations.js';
 import { WoodMiddlewareFn } from '../types/context.js';
+import { SchemaValidator } from '../validation/schema_validator.js';
+import { MiddlewareResolver } from '../middleware/middleware_resolver.js';
+import { ControllerResolver } from '../controller/controller_resolver.js';
 
 /** Reserved internal channels prefixed with __ to avoid collisions with user operations. */
 declare const RESERVED_CHANNELS: readonly ["__load", "__navigate", "__window", "__debug", "__contextMenu", "__woodConfig", "__traceBatch"];
@@ -18,6 +21,9 @@ declare class WoodRouter {
         controllersDir: string;
         middlewareDir: string;
         mode?: 'bundled' | 'dev';
+        validator?: SchemaValidator;
+        middlewareResolver?: MiddlewareResolver;
+        controllerResolver?: ControllerResolver;
     });
     /**
      * Load operations from a parsed operations map.
@@ -41,7 +47,21 @@ declare class WoodRouter {
      * channel -> build context -> middleware -> validate -> resolve controller
      * -> create instance -> build args -> call action -> return result
      */
+    private accepting;
+    private readonly pending;
     dispatch(channel: string, data: unknown, event?: any): Promise<unknown>;
+    drain(timeoutMs?: number): Promise<void>;
+    dispose(timeoutMs?: number): Promise<void>;
+    private dispatchOwned;
+    private prepareController;
+    private executeOperation;
+    private invokeController;
+    private buildIpcContext;
+    private executeOperationMiddleware;
+    private validateOperation;
+    private cleanupOperation;
+    private publishDispatchTrace;
+    private publishDispatchError;
     /**
      * Pre-register a controller class by name so it is resolved from
      * the in-memory cache instead of the filesystem.