@noego/wood 0.0.1

package/dist/controller/controller_resolver.cjs

@@ -0,0 +1,180 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var controller_resolver_exports = {};
+__export(controller_resolver_exports, {
+  ControllerResolver: () => ControllerResolver,
+  buildControllerArgs: () => buildControllerArgs
+});
+module.exports = __toCommonJS(controller_resolver_exports);
+var import_path = __toESM(require("path"), 1);
+var import_logger = require("@noego/logger");
+const logger = (0, import_logger.getLogger)("wood:controller");
+class ControllerResolver {
+  constructor(controllersDir, options) {
+    this.classCache = /* @__PURE__ */ new Map();
+    this.pathCache = /* @__PURE__ */ new Map();
+    this.baseDir = controllersDir;
+    this.mode = options?.mode ?? (process.env.WOOD_MODE === "development" ? "dev" : "bundled");
+  }
+  /**
+   * Check whether a controller name has been pre-registered (class or path).
+   */
+  has(name) {
+    return this.classCache.has(name) || this.pathCache.has(name);
+  }
+  /**
+   * Register an import path for a controller. The controller will be lazily
+   * imported from this path when first needed. This avoids circular dependencies
+   * at module load time.
+   */
+  registerPath(name, importPath) {
+    if (!importPath) {
+      throw new Error(`registerPath("${name}"): importPath cannot be empty`);
+    }
+    this.pathCache.set(name, importPath);
+  }
+  /**
+   * Resolve a controller name to its class.
+   *
+   * 1. Check class cache (already imported)
+   * 2. Check path cache (registered via registerPath) and lazily import
+   * 3. In dev mode only: fall back to filesystem resolution
+   *
+   * Classes are cached -- same class reference returned for same name.
+   */
+  async resolveClass(controllerName) {
+    const cached = this.classCache.get(controllerName);
+    if (cached) return cached;
+    const importPath = this.pathCache.get(controllerName);
+    if (importPath) {
+      const mod = await import(importPath);
+      const ControllerClass = mod.default ?? mod[Object.keys(mod)[0]];
+      if (!ControllerClass || typeof ControllerClass !== "function") {
+        throw new Error(
+          `Controller "${controllerName}" at ${importPath}: module does not export a class`
+        );
+      }
+      this.classCache.set(controllerName, ControllerClass);
+      logger.debug(`Resolved controller "${controllerName}" from registered path`);
+      return ControllerClass;
+    }
+    if (this.mode === "bundled") {
+      throw new Error(
+        `Controller "${controllerName}" is not registered. In bundled mode, all controllers must be pre-registered via controllers.generated.ts. Run "npx wood build" to regenerate the registration file.
+Registered controllers: [${Array.from(this.pathCache.keys()).join(", ")}]`
+      );
+    }
+    return this.resolveFromFilesystem(controllerName);
+  }
+  async resolveFromFilesystem(controllerName) {
+    const basePath = import_path.default.resolve(this.baseDir, controllerName);
+    const candidates = [
+      basePath + ".ts",
+      basePath + ".controller.ts",
+      basePath + ".js",
+      basePath + ".controller.js",
+      import_path.default.resolve(this.baseDir, controllerName, "index.ts"),
+      import_path.default.resolve(this.baseDir, controllerName, "index.js")
+    ];
+    let mod;
+    let loaded = false;
+    for (const candidate of candidates) {
+      try {
+        mod = await import(candidate);
+        loaded = true;
+        break;
+      } catch {
+      }
+    }
+    if (!loaded) {
+      throw new Error(
+        `Controller "${controllerName}" not found. Searched:
+` + candidates.map((c) => `  - ${c}`).join("\n")
+      );
+    }
+    const ControllerClass = mod.default ?? mod[Object.keys(mod)[0]];
+    if (!ControllerClass || typeof ControllerClass !== "function") {
+      throw new Error(
+        `Controller "${controllerName}": module does not export a class`
+      );
+    }
+    logger.debug(`Resolved controller "${controllerName}" from ${this.baseDir}`);
+    this.classCache.set(controllerName, ControllerClass);
+    return ControllerClass;
+  }
+  /**
+   * Create a controller instance using IoC container.
+   * Per-request scoped: container.extend() creates an isolated scope.
+   */
+  async createInstance(ControllerClass, container) {
+    const scopedContainer = container.extend();
+    return scopedContainer.instance(ControllerClass);
+  }
+  /**
+   * Pre-register a controller class by name so that resolveClass()
+   * finds it in the cache without attempting a filesystem import.
+   */
+  register(name, ControllerClass) {
+    if (typeof ControllerClass !== "function") {
+      throw new Error(`register("${name}"): expected a class/constructor, got ${typeof ControllerClass}`);
+    }
+    this.classCache.set(name, ControllerClass);
+  }
+  clearCache() {
+    this.classCache.clear();
+  }
+}
+function buildControllerArgs(ipcContext, container) {
+  return {
+    req: {
+      body: ipcContext.body ?? {},
+      params: ipcContext.params ?? {},
+      query: ipcContext.query ?? {},
+      context: ipcContext.context ?? {},
+      headers: {}
+    },
+    res: {
+      status: (_code) => {
+      },
+      cookie: (_name, _value, _opts) => {
+      },
+      clearCookie: (_name, _opts) => {
+      },
+      set: (_header, _value) => {
+      }
+    },
+    container
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ControllerResolver,
+  buildControllerArgs
+});
+//# sourceMappingURL=controller_resolver.cjs.map

package/dist/controller/controller_resolver.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/controller/controller_resolver.ts"],"sourcesContent":["import path from 'path';\nimport { getLogger } from '@noego/logger';\nimport type { IpcContext, ControllerArgs } from '../types/context.cjs';\n\nconst logger = getLogger('wood:controller');\n\nexport class ControllerResolver {\n  private baseDir: string;\n  private classCache = new Map<string, any>();\n  private pathCache = new Map<string, string>(); // name -> import path\n  private mode: 'bundled' | 'dev';\n\n  constructor(controllersDir: string, options?: { mode?: 'bundled' | 'dev' }) {\n    this.baseDir = controllersDir;\n    // Default to bundled mode for safety. Dev mode must be explicitly opted into.\n    this.mode = options?.mode ?? (process.env.WOOD_MODE === 'development' ? 'dev' : 'bundled');\n  }\n\n  /**\n   * Check whether a controller name has been pre-registered (class or path).\n   */\n  has(name: string): boolean {\n    return this.classCache.has(name) || this.pathCache.has(name);\n  }\n\n  /**\n   * Register an import path for a controller. The controller will be lazily\n   * imported from this path when first needed. This avoids circular dependencies\n   * at module load time.\n   */\n  registerPath(name: string, importPath: string): void {\n    if (!importPath) {\n      throw new Error(`registerPath(\"${name}\"): importPath cannot be empty`);\n    }\n    this.pathCache.set(name, importPath);\n  }\n\n  /**\n   * Resolve a controller name to its class.\n   *\n   * 1. Check class cache (already imported)\n   * 2. Check path cache (registered via registerPath) and lazily import\n   * 3. In dev mode only: fall back to filesystem resolution\n   *\n   * Classes are cached -- same class reference returned for same name.\n   */\n  async resolveClass(controllerName: string): Promise<any> {\n    const cached = this.classCache.get(controllerName);\n    if (cached) return cached;\n\n    // Check if import path is registered — lazily load it\n    const importPath = this.pathCache.get(controllerName);\n    if (importPath) {\n      const mod = await import(importPath);\n      const ControllerClass = mod.default ?? mod[Object.keys(mod)[0]];\n      if (!ControllerClass || typeof ControllerClass !== 'function') {\n        throw new Error(\n          `Controller \"${controllerName}\" at ${importPath}: module does not export a class`\n        );\n      }\n      this.classCache.set(controllerName, ControllerClass);\n      logger.debug(`Resolved controller \"${controllerName}\" from registered path`);\n      return ControllerClass;\n    }\n\n    if (this.mode === 'bundled') {\n      throw new Error(\n        `Controller \"${controllerName}\" is not registered. ` +\n        `In bundled mode, all controllers must be pre-registered via controllers.generated.ts. ` +\n        `Run \"npx wood build\" to regenerate the registration file.\\n` +\n        `Registered controllers: [${Array.from(this.pathCache.keys()).join(', ')}]`\n      );\n    }\n\n    // Dev mode: attempt dynamic filesystem imports\n    return this.resolveFromFilesystem(controllerName);\n  }\n\n  private async resolveFromFilesystem(controllerName: string): Promise<any> {\n    const basePath = path.resolve(this.baseDir, controllerName);\n    const candidates = [\n      basePath + '.ts',\n      basePath + '.controller.ts',\n      basePath + '.js',\n      basePath + '.controller.js',\n      path.resolve(this.baseDir, controllerName, 'index.ts'),\n      path.resolve(this.baseDir, controllerName, 'index.js'),\n    ];\n\n    let mod: any;\n    let loaded = false;\n\n    for (const candidate of candidates) {\n      try {\n        mod = await import(candidate);\n        loaded = true;\n        break;\n      } catch {\n        // Try next candidate\n      }\n    }\n\n    if (!loaded) {\n      throw new Error(\n        `Controller \"${controllerName}\" not found. Searched:\\n` +\n        candidates.map(c => `  - ${c}`).join('\\n')\n      );\n    }\n\n    const ControllerClass = mod.default ?? mod[Object.keys(mod)[0]];\n    if (!ControllerClass || typeof ControllerClass !== 'function') {\n      throw new Error(\n        `Controller \"${controllerName}\": module does not export a class`\n      );\n    }\n\n    logger.debug(`Resolved controller \"${controllerName}\" from ${this.baseDir}`);\n    this.classCache.set(controllerName, ControllerClass);\n    return ControllerClass;\n  }\n\n  /**\n   * Create a controller instance using IoC container.\n   * Per-request scoped: container.extend() creates an isolated scope.\n   */\n  async createInstance(ControllerClass: any, container: any): Promise<any> {\n    const scopedContainer = container.extend();\n    return scopedContainer.instance(ControllerClass);\n  }\n\n  /**\n   * Pre-register a controller class by name so that resolveClass()\n   * finds it in the cache without attempting a filesystem import.\n   */\n  register(name: string, ControllerClass: any): void {\n    if (typeof ControllerClass !== 'function') {\n      throw new Error(`register(\"${name}\"): expected a class/constructor, got ${typeof ControllerClass}`);\n    }\n    this.classCache.set(name, ControllerClass);\n  }\n\n  clearCache(): void {\n    this.classCache.clear();\n  }\n}\n\n/**\n * Build controller args from IPC context.\n * Creates a fake req/res that matches the Dinner web pattern so\n * existing controllers work without modification.\n */\nexport function buildControllerArgs(ipcContext: IpcContext, container: unknown): ControllerArgs {\n  return {\n    req: {\n      body: ipcContext.body ?? {},\n      params: ipcContext.params ?? {},\n      query: ipcContext.query ?? {},\n      context: ipcContext.context ?? {},\n      headers: {},\n    },\n    res: {\n      status: (_code: number) => {},\n      cookie: (_name: string, _value: string, _opts?: unknown) => {},\n      clearCookie: (_name: string, _opts?: unknown) => {},\n      set: (_header: string, _value: string) => {},\n    },\n    container,\n  };\n}\n"],"mappings":"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","names":["path"]}

package/dist/controller/controller_resolver.d.cts

@@ -0,0 +1,51 @@
+import { IpcContext, ControllerArgs } from '../types/context.cjs';
+
+declare class ControllerResolver {
+    private baseDir;
+    private classCache;
+    private pathCache;
+    private mode;
+    constructor(controllersDir: string, options?: {
+        mode?: 'bundled' | 'dev';
+    });
+    /**
+     * Check whether a controller name has been pre-registered (class or path).
+     */
+    has(name: string): boolean;
+    /**
+     * Register an import path for a controller. The controller will be lazily
+     * imported from this path when first needed. This avoids circular dependencies
+     * at module load time.
+     */
+    registerPath(name: string, importPath: string): void;
+    /**
+     * Resolve a controller name to its class.
+     *
+     * 1. Check class cache (already imported)
+     * 2. Check path cache (registered via registerPath) and lazily import
+     * 3. In dev mode only: fall back to filesystem resolution
+     *
+     * Classes are cached -- same class reference returned for same name.
+     */
+    resolveClass(controllerName: string): Promise<any>;
+    private resolveFromFilesystem;
+    /**
+     * Create a controller instance using IoC container.
+     * Per-request scoped: container.extend() creates an isolated scope.
+     */
+    createInstance(ControllerClass: any, container: any): Promise<any>;
+    /**
+     * Pre-register a controller class by name so that resolveClass()
+     * finds it in the cache without attempting a filesystem import.
+     */
+    register(name: string, ControllerClass: any): void;
+    clearCache(): void;
+}
+/**
+ * Build controller args from IPC context.
+ * Creates a fake req/res that matches the Dinner web pattern so
+ * existing controllers work without modification.
+ */
+declare function buildControllerArgs(ipcContext: IpcContext, container: unknown): ControllerArgs;
+
+export { ControllerResolver, buildControllerArgs };

package/dist/controller/controller_resolver.d.ts

@@ -0,0 +1,51 @@
+import { IpcContext, ControllerArgs } from '../types/context.js';
+
+declare class ControllerResolver {
+    private baseDir;
+    private classCache;
+    private pathCache;
+    private mode;
+    constructor(controllersDir: string, options?: {
+        mode?: 'bundled' | 'dev';
+    });
+    /**
+     * Check whether a controller name has been pre-registered (class or path).
+     */
+    has(name: string): boolean;
+    /**
+     * Register an import path for a controller. The controller will be lazily
+     * imported from this path when first needed. This avoids circular dependencies
+     * at module load time.
+     */
+    registerPath(name: string, importPath: string): void;
+    /**
+     * Resolve a controller name to its class.
+     *
+     * 1. Check class cache (already imported)
+     * 2. Check path cache (registered via registerPath) and lazily import
+     * 3. In dev mode only: fall back to filesystem resolution
+     *
+     * Classes are cached -- same class reference returned for same name.
+     */
+    resolveClass(controllerName: string): Promise<any>;
+    private resolveFromFilesystem;
+    /**
+     * Create a controller instance using IoC container.
+     * Per-request scoped: container.extend() creates an isolated scope.
+     */
+    createInstance(ControllerClass: any, container: any): Promise<any>;
+    /**
+     * Pre-register a controller class by name so that resolveClass()
+     * finds it in the cache without attempting a filesystem import.
+     */
+    register(name: string, ControllerClass: any): void;
+    clearCache(): void;
+}
+/**
+ * Build controller args from IPC context.
+ * Creates a fake req/res that matches the Dinner web pattern so
+ * existing controllers work without modification.
+ */
+declare function buildControllerArgs(ipcContext: IpcContext, container: unknown): ControllerArgs;
+
+export { ControllerResolver, buildControllerArgs };

package/dist/controller/controller_resolver.js

@@ -0,0 +1,145 @@
+import path from "path";
+import { getLogger } from "@noego/logger";
+const logger = getLogger("wood:controller");
+class ControllerResolver {
+  constructor(controllersDir, options) {
+    this.classCache = /* @__PURE__ */ new Map();
+    this.pathCache = /* @__PURE__ */ new Map();
+    this.baseDir = controllersDir;
+    this.mode = options?.mode ?? (process.env.WOOD_MODE === "development" ? "dev" : "bundled");
+  }
+  /**
+   * Check whether a controller name has been pre-registered (class or path).
+   */
+  has(name) {
+    return this.classCache.has(name) || this.pathCache.has(name);
+  }
+  /**
+   * Register an import path for a controller. The controller will be lazily
+   * imported from this path when first needed. This avoids circular dependencies
+   * at module load time.
+   */
+  registerPath(name, importPath) {
+    if (!importPath) {
+      throw new Error(`registerPath("${name}"): importPath cannot be empty`);
+    }
+    this.pathCache.set(name, importPath);
+  }
+  /**
+   * Resolve a controller name to its class.
+   *
+   * 1. Check class cache (already imported)
+   * 2. Check path cache (registered via registerPath) and lazily import
+   * 3. In dev mode only: fall back to filesystem resolution
+   *
+   * Classes are cached -- same class reference returned for same name.
+   */
+  async resolveClass(controllerName) {
+    const cached = this.classCache.get(controllerName);
+    if (cached) return cached;
+    const importPath = this.pathCache.get(controllerName);
+    if (importPath) {
+      const mod = await import(importPath);
+      const ControllerClass = mod.default ?? mod[Object.keys(mod)[0]];
+      if (!ControllerClass || typeof ControllerClass !== "function") {
+        throw new Error(
+          `Controller "${controllerName}" at ${importPath}: module does not export a class`
+        );
+      }
+      this.classCache.set(controllerName, ControllerClass);
+      logger.debug(`Resolved controller "${controllerName}" from registered path`);
+      return ControllerClass;
+    }
+    if (this.mode === "bundled") {
+      throw new Error(
+        `Controller "${controllerName}" is not registered. In bundled mode, all controllers must be pre-registered via controllers.generated.ts. Run "npx wood build" to regenerate the registration file.
+Registered controllers: [${Array.from(this.pathCache.keys()).join(", ")}]`
+      );
+    }
+    return this.resolveFromFilesystem(controllerName);
+  }
+  async resolveFromFilesystem(controllerName) {
+    const basePath = path.resolve(this.baseDir, controllerName);
+    const candidates = [
+      basePath + ".ts",
+      basePath + ".controller.ts",
+      basePath + ".js",
+      basePath + ".controller.js",
+      path.resolve(this.baseDir, controllerName, "index.ts"),
+      path.resolve(this.baseDir, controllerName, "index.js")
+    ];
+    let mod;
+    let loaded = false;
+    for (const candidate of candidates) {
+      try {
+        mod = await import(candidate);
+        loaded = true;
+        break;
+      } catch {
+      }
+    }
+    if (!loaded) {
+      throw new Error(
+        `Controller "${controllerName}" not found. Searched:
+` + candidates.map((c) => `  - ${c}`).join("\n")
+      );
+    }
+    const ControllerClass = mod.default ?? mod[Object.keys(mod)[0]];
+    if (!ControllerClass || typeof ControllerClass !== "function") {
+      throw new Error(
+        `Controller "${controllerName}": module does not export a class`
+      );
+    }
+    logger.debug(`Resolved controller "${controllerName}" from ${this.baseDir}`);
+    this.classCache.set(controllerName, ControllerClass);
+    return ControllerClass;
+  }
+  /**
+   * Create a controller instance using IoC container.
+   * Per-request scoped: container.extend() creates an isolated scope.
+   */
+  async createInstance(ControllerClass, container) {
+    const scopedContainer = container.extend();
+    return scopedContainer.instance(ControllerClass);
+  }
+  /**
+   * Pre-register a controller class by name so that resolveClass()
+   * finds it in the cache without attempting a filesystem import.
+   */
+  register(name, ControllerClass) {
+    if (typeof ControllerClass !== "function") {
+      throw new Error(`register("${name}"): expected a class/constructor, got ${typeof ControllerClass}`);
+    }
+    this.classCache.set(name, ControllerClass);
+  }
+  clearCache() {
+    this.classCache.clear();
+  }
+}
+function buildControllerArgs(ipcContext, container) {
+  return {
+    req: {
+      body: ipcContext.body ?? {},
+      params: ipcContext.params ?? {},
+      query: ipcContext.query ?? {},
+      context: ipcContext.context ?? {},
+      headers: {}
+    },
+    res: {
+      status: (_code) => {
+      },
+      cookie: (_name, _value, _opts) => {
+      },
+      clearCookie: (_name, _opts) => {
+      },
+      set: (_header, _value) => {
+      }
+    },
+    container
+  };
+}
+export {
+  ControllerResolver,
+  buildControllerArgs
+};
+//# sourceMappingURL=controller_resolver.js.map

package/dist/controller/controller_resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/controller/controller_resolver.ts"],"sourcesContent":["import path from 'path';\nimport { getLogger } from '@noego/logger';\nimport type { IpcContext, ControllerArgs } from '../types/context.js';\n\nconst logger = getLogger('wood:controller');\n\nexport class ControllerResolver {\n  private baseDir: string;\n  private classCache = new Map<string, any>();\n  private pathCache = new Map<string, string>(); // name -> import path\n  private mode: 'bundled' | 'dev';\n\n  constructor(controllersDir: string, options?: { mode?: 'bundled' | 'dev' }) {\n    this.baseDir = controllersDir;\n    // Default to bundled mode for safety. Dev mode must be explicitly opted into.\n    this.mode = options?.mode ?? (process.env.WOOD_MODE === 'development' ? 'dev' : 'bundled');\n  }\n\n  /**\n   * Check whether a controller name has been pre-registered (class or path).\n   */\n  has(name: string): boolean {\n    return this.classCache.has(name) || this.pathCache.has(name);\n  }\n\n  /**\n   * Register an import path for a controller. The controller will be lazily\n   * imported from this path when first needed. This avoids circular dependencies\n   * at module load time.\n   */\n  registerPath(name: string, importPath: string): void {\n    if (!importPath) {\n      throw new Error(`registerPath(\"${name}\"): importPath cannot be empty`);\n    }\n    this.pathCache.set(name, importPath);\n  }\n\n  /**\n   * Resolve a controller name to its class.\n   *\n   * 1. Check class cache (already imported)\n   * 2. Check path cache (registered via registerPath) and lazily import\n   * 3. In dev mode only: fall back to filesystem resolution\n   *\n   * Classes are cached -- same class reference returned for same name.\n   */\n  async resolveClass(controllerName: string): Promise<any> {\n    const cached = this.classCache.get(controllerName);\n    if (cached) return cached;\n\n    // Check if import path is registered — lazily load it\n    const importPath = this.pathCache.get(controllerName);\n    if (importPath) {\n      const mod = await import(importPath);\n      const ControllerClass = mod.default ?? mod[Object.keys(mod)[0]];\n      if (!ControllerClass || typeof ControllerClass !== 'function') {\n        throw new Error(\n          `Controller \"${controllerName}\" at ${importPath}: module does not export a class`\n        );\n      }\n      this.classCache.set(controllerName, ControllerClass);\n      logger.debug(`Resolved controller \"${controllerName}\" from registered path`);\n      return ControllerClass;\n    }\n\n    if (this.mode === 'bundled') {\n      throw new Error(\n        `Controller \"${controllerName}\" is not registered. ` +\n        `In bundled mode, all controllers must be pre-registered via controllers.generated.ts. ` +\n        `Run \"npx wood build\" to regenerate the registration file.\\n` +\n        `Registered controllers: [${Array.from(this.pathCache.keys()).join(', ')}]`\n      );\n    }\n\n    // Dev mode: attempt dynamic filesystem imports\n    return this.resolveFromFilesystem(controllerName);\n  }\n\n  private async resolveFromFilesystem(controllerName: string): Promise<any> {\n    const basePath = path.resolve(this.baseDir, controllerName);\n    const candidates = [\n      basePath + '.ts',\n      basePath + '.controller.ts',\n      basePath + '.js',\n      basePath + '.controller.js',\n      path.resolve(this.baseDir, controllerName, 'index.ts'),\n      path.resolve(this.baseDir, controllerName, 'index.js'),\n    ];\n\n    let mod: any;\n    let loaded = false;\n\n    for (const candidate of candidates) {\n      try {\n        mod = await import(candidate);\n        loaded = true;\n        break;\n      } catch {\n        // Try next candidate\n      }\n    }\n\n    if (!loaded) {\n      throw new Error(\n        `Controller \"${controllerName}\" not found. Searched:\\n` +\n        candidates.map(c => `  - ${c}`).join('\\n')\n      );\n    }\n\n    const ControllerClass = mod.default ?? mod[Object.keys(mod)[0]];\n    if (!ControllerClass || typeof ControllerClass !== 'function') {\n      throw new Error(\n        `Controller \"${controllerName}\": module does not export a class`\n      );\n    }\n\n    logger.debug(`Resolved controller \"${controllerName}\" from ${this.baseDir}`);\n    this.classCache.set(controllerName, ControllerClass);\n    return ControllerClass;\n  }\n\n  /**\n   * Create a controller instance using IoC container.\n   * Per-request scoped: container.extend() creates an isolated scope.\n   */\n  async createInstance(ControllerClass: any, container: any): Promise<any> {\n    const scopedContainer = container.extend();\n    return scopedContainer.instance(ControllerClass);\n  }\n\n  /**\n   * Pre-register a controller class by name so that resolveClass()\n   * finds it in the cache without attempting a filesystem import.\n   */\n  register(name: string, ControllerClass: any): void {\n    if (typeof ControllerClass !== 'function') {\n      throw new Error(`register(\"${name}\"): expected a class/constructor, got ${typeof ControllerClass}`);\n    }\n    this.classCache.set(name, ControllerClass);\n  }\n\n  clearCache(): void {\n    this.classCache.clear();\n  }\n}\n\n/**\n * Build controller args from IPC context.\n * Creates a fake req/res that matches the Dinner web pattern so\n * existing controllers work without modification.\n */\nexport function buildControllerArgs(ipcContext: IpcContext, container: unknown): ControllerArgs {\n  return {\n    req: {\n      body: ipcContext.body ?? {},\n      params: ipcContext.params ?? {},\n      query: ipcContext.query ?? {},\n      context: ipcContext.context ?? {},\n      headers: {},\n    },\n    res: {\n      status: (_code: number) => {},\n      cookie: (_name: string, _value: string, _opts?: unknown) => {},\n      clearCookie: (_name: string, _opts?: unknown) => {},\n      set: (_header: string, _value: string) => {},\n    },\n    container,\n  };\n}\n"],"mappings":"AAAA,OAAO,UAAU;AACjB,SAAS,iBAAiB;AAG1B,MAAM,SAAS,UAAU,iBAAiB;AAEnC,MAAM,mBAAmB;AAAA,EAM9B,YAAY,gBAAwB,SAAwC;AAJ5E,SAAQ,aAAa,oBAAI,IAAiB;AAC1C,SAAQ,YAAY,oBAAI,IAAoB;AAI1C,SAAK,UAAU;AAEf,SAAK,OAAO,SAAS,SAAS,QAAQ,IAAI,cAAc,gBAAgB,QAAQ;AAAA,EAClF;AAAA;AAAA;AAAA;AAAA,EAKA,IAAI,MAAuB;AACzB,WAAO,KAAK,WAAW,IAAI,IAAI,KAAK,KAAK,UAAU,IAAI,IAAI;AAAA,EAC7D;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,aAAa,MAAc,YAA0B;AACnD,QAAI,CAAC,YAAY;AACf,YAAM,IAAI,MAAM,iBAAiB,IAAI,gCAAgC;AAAA,IACvE;AACA,SAAK,UAAU,IAAI,MAAM,UAAU;AAAA,EACrC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWA,MAAM,aAAa,gBAAsC;AACvD,UAAM,SAAS,KAAK,WAAW,IAAI,cAAc;AACjD,QAAI,OAAQ,QAAO;AAGnB,UAAM,aAAa,KAAK,UAAU,IAAI,cAAc;AACpD,QAAI,YAAY;AACd,YAAM,MAAM,MAAM,OAAO;AACzB,YAAM,kBAAkB,IAAI,WAAW,IAAI,OAAO,KAAK,GAAG,EAAE,CAAC,CAAC;AAC9D,UAAI,CAAC,mBAAmB,OAAO,oBAAoB,YAAY;AAC7D,cAAM,IAAI;AAAA,UACR,eAAe,cAAc,QAAQ,UAAU;AAAA,QACjD;AAAA,MACF;AACA,WAAK,WAAW,IAAI,gBAAgB,eAAe;AACnD,aAAO,MAAM,wBAAwB,cAAc,wBAAwB;AAC3E,aAAO;AAAA,IACT;AAEA,QAAI,KAAK,SAAS,WAAW;AAC3B,YAAM,IAAI;AAAA,QACR,eAAe,cAAc;AAAA,2BAGD,MAAM,KAAK,KAAK,UAAU,KAAK,CAAC,EAAE,KAAK,IAAI,CAAC;AAAA,MAC1E;AAAA,IACF;AAGA,WAAO,KAAK,sBAAsB,cAAc;AAAA,EAClD;AAAA,EAEA,MAAc,sBAAsB,gBAAsC;AACxE,UAAM,WAAW,KAAK,QAAQ,KAAK,SAAS,cAAc;AAC1D,UAAM,aAAa;AAAA,MACjB,WAAW;AAAA,MACX,WAAW;AAAA,MACX,WAAW;AAAA,MACX,WAAW;AAAA,MACX,KAAK,QAAQ,KAAK,SAAS,gBAAgB,UAAU;AAAA,MACrD,KAAK,QAAQ,KAAK,SAAS,gBAAgB,UAAU;AAAA,IACvD;AAEA,QAAI;AACJ,QAAI,SAAS;AAEb,eAAW,aAAa,YAAY;AAClC,UAAI;AACF,cAAM,MAAM,OAAO;AACnB,iBAAS;AACT;AAAA,MACF,QAAQ;AAAA,MAER;AAAA,IACF;AAEA,QAAI,CAAC,QAAQ;AACX,YAAM,IAAI;AAAA,QACR,eAAe,cAAc;AAAA,IAC7B,WAAW,IAAI,OAAK,OAAO,CAAC,EAAE,EAAE,KAAK,IAAI;AAAA,MAC3C;AAAA,IACF;AAEA,UAAM,kBAAkB,IAAI,WAAW,IAAI,OAAO,KAAK,GAAG,EAAE,CAAC,CAAC;AAC9D,QAAI,CAAC,mBAAmB,OAAO,oBAAoB,YAAY;AAC7D,YAAM,IAAI;AAAA,QACR,eAAe,cAAc;AAAA,MAC/B;AAAA,IACF;AAEA,WAAO,MAAM,wBAAwB,cAAc,UAAU,KAAK,OAAO,EAAE;AAC3E,SAAK,WAAW,IAAI,gBAAgB,eAAe;AACnD,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,eAAe,iBAAsB,WAA8B;AACvE,UAAM,kBAAkB,UAAU,OAAO;AACzC,WAAO,gBAAgB,SAAS,eAAe;AAAA,EACjD;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,SAAS,MAAc,iBAA4B;AACjD,QAAI,OAAO,oBAAoB,YAAY;AACzC,YAAM,IAAI,MAAM,aAAa,IAAI,yCAAyC,OAAO,eAAe,EAAE;AAAA,IACpG;AACA,SAAK,WAAW,IAAI,MAAM,eAAe;AAAA,EAC3C;AAAA,EAEA,aAAmB;AACjB,SAAK,WAAW,MAAM;AAAA,EACxB;AACF;AAOO,SAAS,oBAAoB,YAAwB,WAAoC;AAC9F,SAAO;AAAA,IACL,KAAK;AAAA,MACH,MAAM,WAAW,QAAQ,CAAC;AAAA,MAC1B,QAAQ,WAAW,UAAU,CAAC;AAAA,MAC9B,OAAO,WAAW,SAAS,CAAC;AAAA,MAC5B,SAAS,WAAW,WAAW,CAAC;AAAA,MAChC,SAAS,CAAC;AAAA,IACZ;AAAA,IACA,KAAK;AAAA,MACH,QAAQ,CAAC,UAAkB;AAAA,MAAC;AAAA,MAC5B,QAAQ,CAAC,OAAe,QAAgB,UAAoB;AAAA,MAAC;AAAA,MAC7D,aAAa,CAAC,OAAe,UAAoB;AAAA,MAAC;AAAA,MAClD,KAAK,CAAC,SAAiB,WAAmB;AAAA,MAAC;AAAA,IAC7C;AAAA,IACA;AAAA,EACF;AACF;","names":[]}

package/dist/controller/index.cjs

@@ -0,0 +1,31 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var controller_exports = {};
+__export(controller_exports, {
+  ControllerResolver: () => import_controller_resolver.ControllerResolver,
+  buildControllerArgs: () => import_controller_resolver.buildControllerArgs
+});
+module.exports = __toCommonJS(controller_exports);
+var import_controller_resolver = require("./controller_resolver.cjs");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ControllerResolver,
+  buildControllerArgs
+});
+//# sourceMappingURL=index.cjs.map

package/dist/controller/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/controller/index.ts"],"sourcesContent":["export { ControllerResolver, buildControllerArgs } from './controller_resolver.cjs';\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,iCAAwD;","names":[]}

package/dist/controller/index.d.cts

@@ -0,0 +1,2 @@
+export { ControllerResolver, buildControllerArgs } from './controller_resolver.cjs';
+import '../types/context.cjs';

package/dist/controller/index.d.ts

@@ -0,0 +1,2 @@
+export { ControllerResolver, buildControllerArgs } from './controller_resolver.js';
+import '../types/context.js';

package/dist/controller/index.js

@@ -0,0 +1,6 @@
+import { ControllerResolver, buildControllerArgs } from "./controller_resolver.js";
+export {
+  ControllerResolver,
+  buildControllerArgs
+};
+//# sourceMappingURL=index.js.map

package/dist/controller/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/controller/index.ts"],"sourcesContent":["export { ControllerResolver, buildControllerArgs } from './controller_resolver.js';\n"],"mappings":"AAAA,SAAS,oBAAoB,2BAA2B;","names":[]}

package/dist/dev/backend_watcher.cjs

@@ -0,0 +1,108 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from2, except, desc) => {
+  if (from2 && typeof from2 === "object" || typeof from2 === "function") {
+    for (let key of __getOwnPropNames(from2))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from2[key], enumerable: !(desc = __getOwnPropDesc(from2, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var backend_watcher_exports = {};
+__export(backend_watcher_exports, {
+  BackendWatcher: () => BackendWatcher
+});
+module.exports = __toCommonJS(backend_watcher_exports);
+var import_chokidar = require("chokidar");
+var import_rxjs = require("rxjs");
+var import_logger = require("@noego/logger");
+const logger = (0, import_logger.getLogger)("wood:dev:backend-watcher");
+const MAX_CRASH_RESTARTS = 3;
+const STABILITY_THRESHOLD = 3e4;
+const BOOT_ERROR_THRESHOLD = 5e3;
+class BackendWatcher {
+  constructor(options) {
+    this.options = options;
+    this.watcher = null;
+    this.change$ = new import_rxjs.Subject();
+    this.crashCount = 0;
+    this.lastStartTime = 0;
+    this.paused = false;
+  }
+  start() {
+    this.watcher = (0, import_chokidar.watch)(this.options.patterns, {
+      cwd: this.options.cwd,
+      ignoreInitial: true
+    });
+    this.watcher.on("change", (filePath) => {
+      if (this.paused) {
+        logger.info("file change detected while paused, resuming restarts");
+        this.paused = false;
+        this.crashCount = 0;
+      }
+      logger.debug("backend file changed", { filePath });
+      this.change$.next(filePath);
+    });
+    this.change$.pipe(
+      (0, import_rxjs.debounceTime)(100),
+      (0, import_rxjs.switchMap)(() => (0, import_rxjs.from)(this.rebuild()))
+    ).subscribe({
+      error: (err) => {
+        logger.error("backend watcher pipeline error", { error: String(err) });
+      }
+    });
+  }
+  stop() {
+    this.watcher?.close();
+    this.change$.complete();
+  }
+  async rebuild() {
+    if (this.paused) return;
+    try {
+      logger.info("restarting backend");
+      await this.options.bridge.stop();
+      await this.options.buildFn();
+      const timeSinceLastStart = Date.now() - this.lastStartTime;
+      if (this.lastStartTime > 0 && timeSinceLastStart < STABILITY_THRESHOLD) {
+        this.crashCount++;
+        if (this.crashCount >= MAX_CRASH_RESTARTS) {
+          logger.error(
+            "backend crashed too many times in quick succession, pausing restarts",
+            { crashCount: this.crashCount }
+          );
+          this.paused = true;
+          return;
+        }
+      } else {
+        this.crashCount = 0;
+      }
+      this.lastStartTime = Date.now();
+      await this.options.bridge.start();
+      logger.info("backend restarted successfully");
+    } catch (err) {
+      const timeSinceBoot = Date.now() - this.lastStartTime;
+      if (timeSinceBoot < BOOT_ERROR_THRESHOLD) {
+        logger.error(
+          "backend failed to boot (exited within 5s), pausing auto-restart \u2014 fix the error and save to retry",
+          { error: String(err) }
+        );
+        this.paused = true;
+      } else {
+        logger.error("backend rebuild/restart failed", { error: String(err) });
+      }
+    }
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BackendWatcher
+});
+//# sourceMappingURL=backend_watcher.cjs.map

package/dist/dev/backend_watcher.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/dev/backend_watcher.ts"],"sourcesContent":["import { watch, type FSWatcher } from 'chokidar';\nimport { Subject, debounceTime, switchMap, from } from 'rxjs';\nimport { getLogger } from '@noego/logger';\nimport { BackendBridge } from '../bridge/backend_bridge.cjs';\n\nconst logger = getLogger('wood:dev:backend-watcher');\n\nexport interface BackendWatcherOptions {\n  patterns: string[];\n  bridge: BackendBridge;\n  buildFn: () => Promise<void>;\n  cwd: string;\n}\n\nconst MAX_CRASH_RESTARTS = 3;\nconst STABILITY_THRESHOLD = 30_000; // 30 seconds\nconst BOOT_ERROR_THRESHOLD = 5_000; // 5 seconds — quick exit = boot error, don't retry\n\nexport class BackendWatcher {\n  private watcher: FSWatcher | null = null;\n  private change$ = new Subject<string>();\n  private crashCount = 0;\n  private lastStartTime = 0;\n  private paused = false;\n\n  constructor(private options: BackendWatcherOptions) {}\n\n  start(): void {\n    this.watcher = watch(this.options.patterns, {\n      cwd: this.options.cwd,\n      ignoreInitial: true,\n    });\n\n    this.watcher.on('change', (filePath: string) => {\n      if (this.paused) {\n        // A file change while paused resets the pause — the developer likely fixed the issue\n        logger.info('file change detected while paused, resuming restarts');\n        this.paused = false;\n        this.crashCount = 0;\n      }\n      logger.debug('backend file changed', { filePath });\n      this.change$.next(filePath);\n    });\n\n    // RxJS pipeline: debounce rapid saves, switchMap cancels in-progress restarts\n    this.change$.pipe(\n      debounceTime(100),\n      switchMap(() => from(this.rebuild())),\n    ).subscribe({\n      error: (err) => {\n        logger.error('backend watcher pipeline error', { error: String(err) });\n      },\n    });\n  }\n\n  stop(): void {\n    this.watcher?.close();\n    this.change$.complete();\n  }\n\n  private async rebuild(): Promise<void> {\n    if (this.paused) return;\n\n    try {\n      logger.info('restarting backend');\n\n      // Stop backend\n      await this.options.bridge.stop();\n\n      // Rebuild\n      await this.options.buildFn();\n\n      // Check crash threshold — rapid crashes indicate a persistent issue\n      const timeSinceLastStart = Date.now() - this.lastStartTime;\n      if (this.lastStartTime > 0 && timeSinceLastStart < STABILITY_THRESHOLD) {\n        this.crashCount++;\n        if (this.crashCount >= MAX_CRASH_RESTARTS) {\n          logger.error(\n            'backend crashed too many times in quick succession, pausing restarts',\n            { crashCount: this.crashCount },\n          );\n          this.paused = true;\n          return;\n        }\n      } else {\n        this.crashCount = 0;\n      }\n\n      // Start backend\n      this.lastStartTime = Date.now();\n      await this.options.bridge.start();\n\n      // Boot error detection: if the backend exits very quickly after start,\n      // it likely has a fatal error (syntax error, missing dep, etc.)\n      // The bridge's onExit fires and state goes to 'stopped'.\n      // We check inline here — if bridge.start() resolved but then\n      // immediately exits, the next change will see it as a crash.\n      // However, we can also detect it if start() itself throws\n      // (bridge.waitForReady rejects on exit).\n\n      logger.info('backend restarted successfully');\n    } catch (err) {\n      const timeSinceBoot = Date.now() - this.lastStartTime;\n      if (timeSinceBoot < BOOT_ERROR_THRESHOLD) {\n        logger.error(\n          'backend failed to boot (exited within 5s), pausing auto-restart — fix the error and save to retry',\n          { error: String(err) },\n        );\n        this.paused = true;\n      } else {\n        logger.error('backend rebuild/restart failed', { error: String(err) });\n      }\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,sBAAsC;AACtC,kBAAuD;AACvD,oBAA0B;AAG1B,MAAM,aAAS,yBAAU,0BAA0B;AASnD,MAAM,qBAAqB;AAC3B,MAAM,sBAAsB;AAC5B,MAAM,uBAAuB;AAEtB,MAAM,eAAe;AAAA,EAO1B,YAAoB,SAAgC;AAAhC;AANpB,SAAQ,UAA4B;AACpC,SAAQ,UAAU,IAAI,oBAAgB;AACtC,SAAQ,aAAa;AACrB,SAAQ,gBAAgB;AACxB,SAAQ,SAAS;AAAA,EAEoC;AAAA,EAErD,QAAc;AACZ,SAAK,cAAU,uBAAM,KAAK,QAAQ,UAAU;AAAA,MAC1C,KAAK,KAAK,QAAQ;AAAA,MAClB,eAAe;AAAA,IACjB,CAAC;AAED,SAAK,QAAQ,GAAG,UAAU,CAAC,aAAqB;AAC9C,UAAI,KAAK,QAAQ;AAEf,eAAO,KAAK,sDAAsD;AAClE,aAAK,SAAS;AACd,aAAK,aAAa;AAAA,MACpB;AACA,aAAO,MAAM,wBAAwB,EAAE,SAAS,CAAC;AACjD,WAAK,QAAQ,KAAK,QAAQ;AAAA,IAC5B,CAAC;AAGD,SAAK,QAAQ;AAAA,UACX,0BAAa,GAAG;AAAA,UAChB,uBAAU,UAAM,kBAAK,KAAK,QAAQ,CAAC,CAAC;AAAA,IACtC,EAAE,UAAU;AAAA,MACV,OAAO,CAAC,QAAQ;AACd,eAAO,MAAM,kCAAkC,EAAE,OAAO,OAAO,GAAG,EAAE,CAAC;AAAA,MACvE;AAAA,IACF,CAAC;AAAA,EACH;AAAA,EAEA,OAAa;AACX,SAAK,SAAS,MAAM;AACpB,SAAK,QAAQ,SAAS;AAAA,EACxB;AAAA,EAEA,MAAc,UAAyB;AACrC,QAAI,KAAK,OAAQ;AAEjB,QAAI;AACF,aAAO,KAAK,oBAAoB;AAGhC,YAAM,KAAK,QAAQ,OAAO,KAAK;AAG/B,YAAM,KAAK,QAAQ,QAAQ;AAG3B,YAAM,qBAAqB,KAAK,IAAI,IAAI,KAAK;AAC7C,UAAI,KAAK,gBAAgB,KAAK,qBAAqB,qBAAqB;AACtE,aAAK;AACL,YAAI,KAAK,cAAc,oBAAoB;AACzC,iBAAO;AAAA,YACL;AAAA,YACA,EAAE,YAAY,KAAK,WAAW;AAAA,UAChC;AACA,eAAK,SAAS;AACd;AAAA,QACF;AAAA,MACF,OAAO;AACL,aAAK,aAAa;AAAA,MACpB;AAGA,WAAK,gBAAgB,KAAK,IAAI;AAC9B,YAAM,KAAK,QAAQ,OAAO,MAAM;AAUhC,aAAO,KAAK,gCAAgC;AAAA,IAC9C,SAAS,KAAK;AACZ,YAAM,gBAAgB,KAAK,IAAI,IAAI,KAAK;AACxC,UAAI,gBAAgB,sBAAsB;AACxC,eAAO;AAAA,UACL;AAAA,UACA,EAAE,OAAO,OAAO,GAAG,EAAE;AAAA,QACvB;AACA,aAAK,SAAS;AAAA,MAChB,OAAO;AACL,eAAO,MAAM,kCAAkC,EAAE,OAAO,OAAO,GAAG,EAAE,CAAC;AAAA,MACvE;AAAA,IACF;AAAA,EACF;AACF;","names":[]}