@noego/wood 0.4.9 → 0.5.0

package/dist/parser/operations_parser.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/parser/operations_parser.ts"],"sourcesContent":["import yaml from 'js-yaml';\nimport { readFileSync } from 'fs';\nimport type { OperationDef, RawOperationsDocument, RawModuleDef, RawOperationEntry, RawModuleOperationEntry } from '../types/index.cjs';\n\nexport function parseOperations(yamlContent: string): Map<string, OperationDef> {\n  const doc = yaml.load(yamlContent) as RawOperationsDocument;\n  const operations = new Map<string, OperationDef>();\n\n  if (doc === null || doc === undefined) {\n    throw new Error('Operations document is empty: expected a top-level \"operations:\" or \"module:\" mapping.');\n  }\n  if (typeof doc !== 'object' || Array.isArray(doc)) {\n    throw new Error('Operations document must be a mapping with \"operations:\" and/or \"module:\" keys.');\n  }\n  if (!doc.operations && !doc.module) {\n    throw new Error('Operations document defines no operations: expected an \"operations:\" or \"module:\" key.');\n  }\n\n  // A channel may only be defined once. Two operations sharing a channel would\n  // silently overwrite each other (last-wins), dropping an RPC with no warning.\n  const set = (channel: string, def: OperationDef): void => {\n    if (operations.has(channel)) {\n      throw new Error(`Duplicate operation channel \"${channel}\": each channel may only be defined once.`);\n    }\n    operations.set(channel, def);\n  };\n\n  // 1. Parse flat operations (top-level `operations:` key)\n  if (doc.operations) {\n    for (const [channel, entry] of Object.entries(doc.operations)) {\n      set(channel, {\n        channel,\n        controller: entry.controller,\n        action: entry.action,\n        middleware: entry.middleware ?? [],\n        inputSchema: entry.input,\n        outputSchema: entry.output,\n      });\n    }\n  }\n\n  // 2. Parse module operations (`module:` key)\n  if (doc.module) {\n    for (const [moduleName, moduleDef] of Object.entries(doc.module)) {\n      const moduleController = moduleDef.controller;\n      const moduleMiddleware = moduleDef.middleware ?? [];\n\n      if (moduleDef.operations === null || moduleDef.operations === undefined) {\n        throw new Error(`Module \"${moduleName}\" has no \"operations:\" block.`);\n      }\n      if (typeof moduleDef.operations !== 'object' || Array.isArray(moduleDef.operations)) {\n        throw new Error(`Module \"${moduleName}\" \"operations:\" must be a mapping of operation names.`);\n      }\n\n      for (const [opName, opEntry] of Object.entries(moduleDef.operations)) {\n        const channel = `${moduleName}.${opName}`;\n\n        // Middleware: if operation explicitly sets middleware to [] or null, clear inherited\n        // Otherwise, prepend module middleware to operation middleware\n        let middleware: string[];\n        if (opEntry.middleware === null || (Array.isArray(opEntry.middleware) && opEntry.middleware.length === 0)) {\n          middleware = [];\n        } else {\n          middleware = [...moduleMiddleware, ...(opEntry.middleware ?? [])];\n        }\n\n        set(channel, {\n          channel,\n          controller: opEntry.controller ?? moduleController ?? '',\n          action: opEntry.action,\n          middleware,\n          inputSchema: opEntry.input,\n          outputSchema: opEntry.output,\n        });\n      }\n    }\n  }\n\n  // 3. Validate: every operation must have a controller and action\n  for (const [channel, op] of operations) {\n    if (!op.controller) {\n      throw new Error(`Operation \"${channel}\" has no controller defined`);\n    }\n    if (!op.action) {\n      throw new Error(`Operation \"${channel}\" has no action defined`);\n    }\n  }\n\n  return operations;\n}\n\n/** Parse from file path */\nexport function parseOperationsFile(filePath: string): Map<string, OperationDef> {\n  const content = readFileSync(filePath, 'utf-8');\n  return parseOperations(content);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,qBAAiB;AACjB,gBAA6B;AAGtB,SAAS,gBAAgB,aAAgD;AAC9E,QAAM,MAAM,eAAAA,QAAK,KAAK,WAAW;AACjC,QAAM,aAAa,oBAAI,IAA0B;AAEjD,MAAI,QAAQ,QAAQ,QAAQ,QAAW;AACrC,UAAM,IAAI,MAAM,wFAAwF;AAAA,EAC1G;AACA,MAAI,OAAO,QAAQ,YAAY,MAAM,QAAQ,GAAG,GAAG;AACjD,UAAM,IAAI,MAAM,iFAAiF;AAAA,EACnG;AACA,MAAI,CAAC,IAAI,cAAc,CAAC,IAAI,QAAQ;AAClC,UAAM,IAAI,MAAM,wFAAwF;AAAA,EAC1G;AAIA,QAAM,MAAM,CAAC,SAAiB,QAA4B;AACxD,QAAI,WAAW,IAAI,OAAO,GAAG;AAC3B,YAAM,IAAI,MAAM,gCAAgC,OAAO,2CAA2C;AAAA,IACpG;AACA,eAAW,IAAI,SAAS,GAAG;AAAA,EAC7B;AAGA,MAAI,IAAI,YAAY;AAClB,eAAW,CAAC,SAAS,KAAK,KAAK,OAAO,QAAQ,IAAI,UAAU,GAAG;AAC7D,UAAI,SAAS;AAAA,QACX;AAAA,QACA,YAAY,MAAM;AAAA,QAClB,QAAQ,MAAM;AAAA,QACd,YAAY,MAAM,cAAc,CAAC;AAAA,QACjC,aAAa,MAAM;AAAA,QACnB,cAAc,MAAM;AAAA,MACtB,CAAC;AAAA,IACH;AAAA,EACF;AAGA,MAAI,IAAI,QAAQ;AACd,eAAW,CAAC,YAAY,SAAS,KAAK,OAAO,QAAQ,IAAI,MAAM,GAAG;AAChE,YAAM,mBAAmB,UAAU;AACnC,YAAM,mBAAmB,UAAU,cAAc,CAAC;AAElD,UAAI,UAAU,eAAe,QAAQ,UAAU,eAAe,QAAW;AACvE,cAAM,IAAI,MAAM,WAAW,UAAU,+BAA+B;AAAA,MACtE;AACA,UAAI,OAAO,UAAU,eAAe,YAAY,MAAM,QAAQ,UAAU,UAAU,GAAG;AACnF,cAAM,IAAI,MAAM,WAAW,UAAU,uDAAuD;AAAA,MAC9F;AAEA,iBAAW,CAAC,QAAQ,OAAO,KAAK,OAAO,QAAQ,UAAU,UAAU,GAAG;AACpE,cAAM,UAAU,GAAG,UAAU,IAAI,MAAM;AAIvC,YAAI;AACJ,YAAI,QAAQ,eAAe,QAAS,MAAM,QAAQ,QAAQ,UAAU,KAAK,QAAQ,WAAW,WAAW,GAAI;AACzG,uBAAa,CAAC;AAAA,QAChB,OAAO;AACL,uBAAa,CAAC,GAAG,kBAAkB,GAAI,QAAQ,cAAc,CAAC,CAAE;AAAA,QAClE;AAEA,YAAI,SAAS;AAAA,UACX;AAAA,UACA,YAAY,QAAQ,cAAc,oBAAoB;AAAA,UACtD,QAAQ,QAAQ;AAAA,UAChB;AAAA,UACA,aAAa,QAAQ;AAAA,UACrB,cAAc,QAAQ;AAAA,QACxB,CAAC;AAAA,MACH;AAAA,IACF;AAAA,EACF;AAGA,aAAW,CAAC,SAAS,EAAE,KAAK,YAAY;AACtC,QAAI,CAAC,GAAG,YAAY;AAClB,YAAM,IAAI,MAAM,cAAc,OAAO,6BAA6B;AAAA,IACpE;AACA,QAAI,CAAC,GAAG,QAAQ;AACd,YAAM,IAAI,MAAM,cAAc,OAAO,yBAAyB;AAAA,IAChE;AAAA,EACF;AAEA,SAAO;AACT;AAGO,SAAS,oBAAoB,UAA6C;AAC/E,QAAM,cAAU,wBAAa,UAAU,OAAO;AAC9C,SAAO,gBAAgB,OAAO;AAChC;","names":["yaml"]}
+{"version":3,"sources":["../../src/parser/operations_parser.ts"],"sourcesContent":["import yaml from 'js-yaml';\nimport { readFileSync } from 'fs';\nimport type { OperationDef, RawOperationsDocument, RawModuleDef, RawOperationEntry, RawModuleOperationEntry } from '../types/index.cjs';\n\nexport function parseOperations(yamlContent: string): Map<string, OperationDef> {\n  const doc = yaml.load(yamlContent) as RawOperationsDocument;\n  return parseOperationsDocument(doc);\n}\n\n/**\n * Parse an already-loaded operations document (the object form of the YAML).\n * This is the production parser; parseOperations/parseOperationsFile are\n * thin loaders over it, and test environments select from the same\n * identities it produces.\n */\nexport function parseOperationsDocument(doc: RawOperationsDocument): Map<string, OperationDef> {\n  const operations = new Map<string, OperationDef>();\n\n  if (doc === null || doc === undefined) {\n    throw new Error('Operations document is empty: expected a top-level \"operations:\" or \"module:\" mapping.');\n  }\n  if (typeof doc !== 'object' || Array.isArray(doc)) {\n    throw new Error('Operations document must be a mapping with \"operations:\" and/or \"module:\" keys.');\n  }\n  if (!doc.operations && !doc.module) {\n    throw new Error('Operations document defines no operations: expected an \"operations:\" or \"module:\" key.');\n  }\n\n  // A channel may only be defined once. Two operations sharing a channel would\n  // silently overwrite each other (last-wins), dropping an RPC with no warning.\n  const set = (channel: string, def: OperationDef): void => {\n    if (operations.has(channel)) {\n      throw new Error(`Duplicate operation channel \"${channel}\": each channel may only be defined once.`);\n    }\n    operations.set(channel, def);\n  };\n\n  // 1. Parse flat operations (top-level `operations:` key)\n  if (doc.operations) {\n    for (const [channel, entry] of Object.entries(doc.operations)) {\n      set(channel, {\n        channel,\n        controller: entry.controller,\n        action: entry.action,\n        middleware: entry.middleware ?? [],\n        inputSchema: entry.input,\n        outputSchema: entry.output,\n      });\n    }\n  }\n\n  // 2. Parse module operations (`module:` key)\n  if (doc.module) {\n    for (const [moduleName, moduleDef] of Object.entries(doc.module)) {\n      const moduleController = moduleDef.controller;\n      const moduleMiddleware = moduleDef.middleware ?? [];\n\n      if (moduleDef.operations === null || moduleDef.operations === undefined) {\n        throw new Error(`Module \"${moduleName}\" has no \"operations:\" block.`);\n      }\n      if (typeof moduleDef.operations !== 'object' || Array.isArray(moduleDef.operations)) {\n        throw new Error(`Module \"${moduleName}\" \"operations:\" must be a mapping of operation names.`);\n      }\n\n      for (const [opName, opEntry] of Object.entries(moduleDef.operations)) {\n        const channel = `${moduleName}.${opName}`;\n\n        // Middleware: if operation explicitly sets middleware to [] or null, clear inherited\n        // Otherwise, prepend module middleware to operation middleware\n        let middleware: string[];\n        if (opEntry.middleware === null || (Array.isArray(opEntry.middleware) && opEntry.middleware.length === 0)) {\n          middleware = [];\n        } else {\n          middleware = [...moduleMiddleware, ...(opEntry.middleware ?? [])];\n        }\n\n        set(channel, {\n          channel,\n          module: moduleName,\n          controller: opEntry.controller ?? moduleController ?? '',\n          action: opEntry.action,\n          middleware,\n          inputSchema: opEntry.input,\n          outputSchema: opEntry.output,\n        });\n      }\n    }\n  }\n\n  // 3. Validate: every operation must have a controller and action\n  for (const [channel, op] of operations) {\n    if (!op.controller) {\n      throw new Error(`Operation \"${channel}\" has no controller defined`);\n    }\n    if (!op.action) {\n      throw new Error(`Operation \"${channel}\" has no action defined`);\n    }\n  }\n\n  return operations;\n}\n\n/** Parse from file path */\nexport function parseOperationsFile(filePath: string): Map<string, OperationDef> {\n  const content = readFileSync(filePath, 'utf-8');\n  return parseOperations(content);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,qBAAiB;AACjB,gBAA6B;AAGtB,SAAS,gBAAgB,aAAgD;AAC9E,QAAM,MAAM,eAAAA,QAAK,KAAK,WAAW;AACjC,SAAO,wBAAwB,GAAG;AACpC;AAQO,SAAS,wBAAwB,KAAuD;AAC7F,QAAM,aAAa,oBAAI,IAA0B;AAEjD,MAAI,QAAQ,QAAQ,QAAQ,QAAW;AACrC,UAAM,IAAI,MAAM,wFAAwF;AAAA,EAC1G;AACA,MAAI,OAAO,QAAQ,YAAY,MAAM,QAAQ,GAAG,GAAG;AACjD,UAAM,IAAI,MAAM,iFAAiF;AAAA,EACnG;AACA,MAAI,CAAC,IAAI,cAAc,CAAC,IAAI,QAAQ;AAClC,UAAM,IAAI,MAAM,wFAAwF;AAAA,EAC1G;AAIA,QAAM,MAAM,CAAC,SAAiB,QAA4B;AACxD,QAAI,WAAW,IAAI,OAAO,GAAG;AAC3B,YAAM,IAAI,MAAM,gCAAgC,OAAO,2CAA2C;AAAA,IACpG;AACA,eAAW,IAAI,SAAS,GAAG;AAAA,EAC7B;AAGA,MAAI,IAAI,YAAY;AAClB,eAAW,CAAC,SAAS,KAAK,KAAK,OAAO,QAAQ,IAAI,UAAU,GAAG;AAC7D,UAAI,SAAS;AAAA,QACX;AAAA,QACA,YAAY,MAAM;AAAA,QAClB,QAAQ,MAAM;AAAA,QACd,YAAY,MAAM,cAAc,CAAC;AAAA,QACjC,aAAa,MAAM;AAAA,QACnB,cAAc,MAAM;AAAA,MACtB,CAAC;AAAA,IACH;AAAA,EACF;AAGA,MAAI,IAAI,QAAQ;AACd,eAAW,CAAC,YAAY,SAAS,KAAK,OAAO,QAAQ,IAAI,MAAM,GAAG;AAChE,YAAM,mBAAmB,UAAU;AACnC,YAAM,mBAAmB,UAAU,cAAc,CAAC;AAElD,UAAI,UAAU,eAAe,QAAQ,UAAU,eAAe,QAAW;AACvE,cAAM,IAAI,MAAM,WAAW,UAAU,+BAA+B;AAAA,MACtE;AACA,UAAI,OAAO,UAAU,eAAe,YAAY,MAAM,QAAQ,UAAU,UAAU,GAAG;AACnF,cAAM,IAAI,MAAM,WAAW,UAAU,uDAAuD;AAAA,MAC9F;AAEA,iBAAW,CAAC,QAAQ,OAAO,KAAK,OAAO,QAAQ,UAAU,UAAU,GAAG;AACpE,cAAM,UAAU,GAAG,UAAU,IAAI,MAAM;AAIvC,YAAI;AACJ,YAAI,QAAQ,eAAe,QAAS,MAAM,QAAQ,QAAQ,UAAU,KAAK,QAAQ,WAAW,WAAW,GAAI;AACzG,uBAAa,CAAC;AAAA,QAChB,OAAO;AACL,uBAAa,CAAC,GAAG,kBAAkB,GAAI,QAAQ,cAAc,CAAC,CAAE;AAAA,QAClE;AAEA,YAAI,SAAS;AAAA,UACX;AAAA,UACA,QAAQ;AAAA,UACR,YAAY,QAAQ,cAAc,oBAAoB;AAAA,UACtD,QAAQ,QAAQ;AAAA,UAChB;AAAA,UACA,aAAa,QAAQ;AAAA,UACrB,cAAc,QAAQ;AAAA,QACxB,CAAC;AAAA,MACH;AAAA,IACF;AAAA,EACF;AAGA,aAAW,CAAC,SAAS,EAAE,KAAK,YAAY;AACtC,QAAI,CAAC,GAAG,YAAY;AAClB,YAAM,IAAI,MAAM,cAAc,OAAO,6BAA6B;AAAA,IACpE;AACA,QAAI,CAAC,GAAG,QAAQ;AACd,YAAM,IAAI,MAAM,cAAc,OAAO,yBAAyB;AAAA,IAChE;AAAA,EACF;AAEA,SAAO;AACT;AAGO,SAAS,oBAAoB,UAA6C;AAC/E,QAAM,cAAU,wBAAa,UAAU,OAAO;AAC9C,SAAO,gBAAgB,OAAO;AAChC;","names":["yaml"]}

package/dist/parser/operations_parser.d.cts

@@ -1,7 +1,14 @@
-import { OperationDef } from '../types/operations.cjs';
+import { OperationDef, RawOperationsDocument } from '../types/operations.cjs';
 
 declare function parseOperations(yamlContent: string): Map<string, OperationDef>;
+/**
+ * Parse an already-loaded operations document (the object form of the YAML).
+ * This is the production parser; parseOperations/parseOperationsFile are
+ * thin loaders over it, and test environments select from the same
+ * identities it produces.
+ */
+declare function parseOperationsDocument(doc: RawOperationsDocument): Map<string, OperationDef>;
 /** Parse from file path */
 declare function parseOperationsFile(filePath: string): Map<string, OperationDef>;
 
-export { parseOperations, parseOperationsFile };
+export { parseOperations, parseOperationsDocument, parseOperationsFile };

package/dist/parser/operations_parser.d.ts

@@ -1,7 +1,14 @@
-import { OperationDef } from '../types/operations.js';
+import { OperationDef, RawOperationsDocument } from '../types/operations.js';
 
 declare function parseOperations(yamlContent: string): Map<string, OperationDef>;
+/**
+ * Parse an already-loaded operations document (the object form of the YAML).
+ * This is the production parser; parseOperations/parseOperationsFile are
+ * thin loaders over it, and test environments select from the same
+ * identities it produces.
+ */
+declare function parseOperationsDocument(doc: RawOperationsDocument): Map<string, OperationDef>;
 /** Parse from file path */
 declare function parseOperationsFile(filePath: string): Map<string, OperationDef>;
 
-export { parseOperations, parseOperationsFile };
+export { parseOperations, parseOperationsDocument, parseOperationsFile };

package/dist/parser/operations_parser.js

@@ -2,6 +2,9 @@ import yaml from "js-yaml";
 import { readFileSync } from "fs";
 function parseOperations(yamlContent) {
   const doc = yaml.load(yamlContent);
+  return parseOperationsDocument(doc);
+}
+function parseOperationsDocument(doc) {
   const operations = /* @__PURE__ */ new Map();
   if (doc === null || doc === void 0) {
     throw new Error('Operations document is empty: expected a top-level "operations:" or "module:" mapping.');
@@ -50,6 +53,7 @@ function parseOperations(yamlContent) {
         }
         set(channel, {
           channel,
+          module: moduleName,
           controller: opEntry.controller ?? moduleController ?? "",
           action: opEntry.action,
           middleware,
@@ -75,6 +79,7 @@ function parseOperationsFile(filePath) {
 }
 export {
   parseOperations,
+  parseOperationsDocument,
   parseOperationsFile
 };
 //# sourceMappingURL=operations_parser.js.map

package/dist/parser/operations_parser.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/parser/operations_parser.ts"],"sourcesContent":["import yaml from 'js-yaml';\nimport { readFileSync } from 'fs';\nimport type { OperationDef, RawOperationsDocument, RawModuleDef, RawOperationEntry, RawModuleOperationEntry } from '../types/index.js';\n\nexport function parseOperations(yamlContent: string): Map<string, OperationDef> {\n  const doc = yaml.load(yamlContent) as RawOperationsDocument;\n  const operations = new Map<string, OperationDef>();\n\n  if (doc === null || doc === undefined) {\n    throw new Error('Operations document is empty: expected a top-level \"operations:\" or \"module:\" mapping.');\n  }\n  if (typeof doc !== 'object' || Array.isArray(doc)) {\n    throw new Error('Operations document must be a mapping with \"operations:\" and/or \"module:\" keys.');\n  }\n  if (!doc.operations && !doc.module) {\n    throw new Error('Operations document defines no operations: expected an \"operations:\" or \"module:\" key.');\n  }\n\n  // A channel may only be defined once. Two operations sharing a channel would\n  // silently overwrite each other (last-wins), dropping an RPC with no warning.\n  const set = (channel: string, def: OperationDef): void => {\n    if (operations.has(channel)) {\n      throw new Error(`Duplicate operation channel \"${channel}\": each channel may only be defined once.`);\n    }\n    operations.set(channel, def);\n  };\n\n  // 1. Parse flat operations (top-level `operations:` key)\n  if (doc.operations) {\n    for (const [channel, entry] of Object.entries(doc.operations)) {\n      set(channel, {\n        channel,\n        controller: entry.controller,\n        action: entry.action,\n        middleware: entry.middleware ?? [],\n        inputSchema: entry.input,\n        outputSchema: entry.output,\n      });\n    }\n  }\n\n  // 2. Parse module operations (`module:` key)\n  if (doc.module) {\n    for (const [moduleName, moduleDef] of Object.entries(doc.module)) {\n      const moduleController = moduleDef.controller;\n      const moduleMiddleware = moduleDef.middleware ?? [];\n\n      if (moduleDef.operations === null || moduleDef.operations === undefined) {\n        throw new Error(`Module \"${moduleName}\" has no \"operations:\" block.`);\n      }\n      if (typeof moduleDef.operations !== 'object' || Array.isArray(moduleDef.operations)) {\n        throw new Error(`Module \"${moduleName}\" \"operations:\" must be a mapping of operation names.`);\n      }\n\n      for (const [opName, opEntry] of Object.entries(moduleDef.operations)) {\n        const channel = `${moduleName}.${opName}`;\n\n        // Middleware: if operation explicitly sets middleware to [] or null, clear inherited\n        // Otherwise, prepend module middleware to operation middleware\n        let middleware: string[];\n        if (opEntry.middleware === null || (Array.isArray(opEntry.middleware) && opEntry.middleware.length === 0)) {\n          middleware = [];\n        } else {\n          middleware = [...moduleMiddleware, ...(opEntry.middleware ?? [])];\n        }\n\n        set(channel, {\n          channel,\n          controller: opEntry.controller ?? moduleController ?? '',\n          action: opEntry.action,\n          middleware,\n          inputSchema: opEntry.input,\n          outputSchema: opEntry.output,\n        });\n      }\n    }\n  }\n\n  // 3. Validate: every operation must have a controller and action\n  for (const [channel, op] of operations) {\n    if (!op.controller) {\n      throw new Error(`Operation \"${channel}\" has no controller defined`);\n    }\n    if (!op.action) {\n      throw new Error(`Operation \"${channel}\" has no action defined`);\n    }\n  }\n\n  return operations;\n}\n\n/** Parse from file path */\nexport function parseOperationsFile(filePath: string): Map<string, OperationDef> {\n  const content = readFileSync(filePath, 'utf-8');\n  return parseOperations(content);\n}\n"],"mappings":"AAAA,OAAO,UAAU;AACjB,SAAS,oBAAoB;AAGtB,SAAS,gBAAgB,aAAgD;AAC9E,QAAM,MAAM,KAAK,KAAK,WAAW;AACjC,QAAM,aAAa,oBAAI,IAA0B;AAEjD,MAAI,QAAQ,QAAQ,QAAQ,QAAW;AACrC,UAAM,IAAI,MAAM,wFAAwF;AAAA,EAC1G;AACA,MAAI,OAAO,QAAQ,YAAY,MAAM,QAAQ,GAAG,GAAG;AACjD,UAAM,IAAI,MAAM,iFAAiF;AAAA,EACnG;AACA,MAAI,CAAC,IAAI,cAAc,CAAC,IAAI,QAAQ;AAClC,UAAM,IAAI,MAAM,wFAAwF;AAAA,EAC1G;AAIA,QAAM,MAAM,CAAC,SAAiB,QAA4B;AACxD,QAAI,WAAW,IAAI,OAAO,GAAG;AAC3B,YAAM,IAAI,MAAM,gCAAgC,OAAO,2CAA2C;AAAA,IACpG;AACA,eAAW,IAAI,SAAS,GAAG;AAAA,EAC7B;AAGA,MAAI,IAAI,YAAY;AAClB,eAAW,CAAC,SAAS,KAAK,KAAK,OAAO,QAAQ,IAAI,UAAU,GAAG;AAC7D,UAAI,SAAS;AAAA,QACX;AAAA,QACA,YAAY,MAAM;AAAA,QAClB,QAAQ,MAAM;AAAA,QACd,YAAY,MAAM,cAAc,CAAC;AAAA,QACjC,aAAa,MAAM;AAAA,QACnB,cAAc,MAAM;AAAA,MACtB,CAAC;AAAA,IACH;AAAA,EACF;AAGA,MAAI,IAAI,QAAQ;AACd,eAAW,CAAC,YAAY,SAAS,KAAK,OAAO,QAAQ,IAAI,MAAM,GAAG;AAChE,YAAM,mBAAmB,UAAU;AACnC,YAAM,mBAAmB,UAAU,cAAc,CAAC;AAElD,UAAI,UAAU,eAAe,QAAQ,UAAU,eAAe,QAAW;AACvE,cAAM,IAAI,MAAM,WAAW,UAAU,+BAA+B;AAAA,MACtE;AACA,UAAI,OAAO,UAAU,eAAe,YAAY,MAAM,QAAQ,UAAU,UAAU,GAAG;AACnF,cAAM,IAAI,MAAM,WAAW,UAAU,uDAAuD;AAAA,MAC9F;AAEA,iBAAW,CAAC,QAAQ,OAAO,KAAK,OAAO,QAAQ,UAAU,UAAU,GAAG;AACpE,cAAM,UAAU,GAAG,UAAU,IAAI,MAAM;AAIvC,YAAI;AACJ,YAAI,QAAQ,eAAe,QAAS,MAAM,QAAQ,QAAQ,UAAU,KAAK,QAAQ,WAAW,WAAW,GAAI;AACzG,uBAAa,CAAC;AAAA,QAChB,OAAO;AACL,uBAAa,CAAC,GAAG,kBAAkB,GAAI,QAAQ,cAAc,CAAC,CAAE;AAAA,QAClE;AAEA,YAAI,SAAS;AAAA,UACX;AAAA,UACA,YAAY,QAAQ,cAAc,oBAAoB;AAAA,UACtD,QAAQ,QAAQ;AAAA,UAChB;AAAA,UACA,aAAa,QAAQ;AAAA,UACrB,cAAc,QAAQ;AAAA,QACxB,CAAC;AAAA,MACH;AAAA,IACF;AAAA,EACF;AAGA,aAAW,CAAC,SAAS,EAAE,KAAK,YAAY;AACtC,QAAI,CAAC,GAAG,YAAY;AAClB,YAAM,IAAI,MAAM,cAAc,OAAO,6BAA6B;AAAA,IACpE;AACA,QAAI,CAAC,GAAG,QAAQ;AACd,YAAM,IAAI,MAAM,cAAc,OAAO,yBAAyB;AAAA,IAChE;AAAA,EACF;AAEA,SAAO;AACT;AAGO,SAAS,oBAAoB,UAA6C;AAC/E,QAAM,UAAU,aAAa,UAAU,OAAO;AAC9C,SAAO,gBAAgB,OAAO;AAChC;","names":[]}
+{"version":3,"sources":["../../src/parser/operations_parser.ts"],"sourcesContent":["import yaml from 'js-yaml';\nimport { readFileSync } from 'fs';\nimport type { OperationDef, RawOperationsDocument, RawModuleDef, RawOperationEntry, RawModuleOperationEntry } from '../types/index.js';\n\nexport function parseOperations(yamlContent: string): Map<string, OperationDef> {\n  const doc = yaml.load(yamlContent) as RawOperationsDocument;\n  return parseOperationsDocument(doc);\n}\n\n/**\n * Parse an already-loaded operations document (the object form of the YAML).\n * This is the production parser; parseOperations/parseOperationsFile are\n * thin loaders over it, and test environments select from the same\n * identities it produces.\n */\nexport function parseOperationsDocument(doc: RawOperationsDocument): Map<string, OperationDef> {\n  const operations = new Map<string, OperationDef>();\n\n  if (doc === null || doc === undefined) {\n    throw new Error('Operations document is empty: expected a top-level \"operations:\" or \"module:\" mapping.');\n  }\n  if (typeof doc !== 'object' || Array.isArray(doc)) {\n    throw new Error('Operations document must be a mapping with \"operations:\" and/or \"module:\" keys.');\n  }\n  if (!doc.operations && !doc.module) {\n    throw new Error('Operations document defines no operations: expected an \"operations:\" or \"module:\" key.');\n  }\n\n  // A channel may only be defined once. Two operations sharing a channel would\n  // silently overwrite each other (last-wins), dropping an RPC with no warning.\n  const set = (channel: string, def: OperationDef): void => {\n    if (operations.has(channel)) {\n      throw new Error(`Duplicate operation channel \"${channel}\": each channel may only be defined once.`);\n    }\n    operations.set(channel, def);\n  };\n\n  // 1. Parse flat operations (top-level `operations:` key)\n  if (doc.operations) {\n    for (const [channel, entry] of Object.entries(doc.operations)) {\n      set(channel, {\n        channel,\n        controller: entry.controller,\n        action: entry.action,\n        middleware: entry.middleware ?? [],\n        inputSchema: entry.input,\n        outputSchema: entry.output,\n      });\n    }\n  }\n\n  // 2. Parse module operations (`module:` key)\n  if (doc.module) {\n    for (const [moduleName, moduleDef] of Object.entries(doc.module)) {\n      const moduleController = moduleDef.controller;\n      const moduleMiddleware = moduleDef.middleware ?? [];\n\n      if (moduleDef.operations === null || moduleDef.operations === undefined) {\n        throw new Error(`Module \"${moduleName}\" has no \"operations:\" block.`);\n      }\n      if (typeof moduleDef.operations !== 'object' || Array.isArray(moduleDef.operations)) {\n        throw new Error(`Module \"${moduleName}\" \"operations:\" must be a mapping of operation names.`);\n      }\n\n      for (const [opName, opEntry] of Object.entries(moduleDef.operations)) {\n        const channel = `${moduleName}.${opName}`;\n\n        // Middleware: if operation explicitly sets middleware to [] or null, clear inherited\n        // Otherwise, prepend module middleware to operation middleware\n        let middleware: string[];\n        if (opEntry.middleware === null || (Array.isArray(opEntry.middleware) && opEntry.middleware.length === 0)) {\n          middleware = [];\n        } else {\n          middleware = [...moduleMiddleware, ...(opEntry.middleware ?? [])];\n        }\n\n        set(channel, {\n          channel,\n          module: moduleName,\n          controller: opEntry.controller ?? moduleController ?? '',\n          action: opEntry.action,\n          middleware,\n          inputSchema: opEntry.input,\n          outputSchema: opEntry.output,\n        });\n      }\n    }\n  }\n\n  // 3. Validate: every operation must have a controller and action\n  for (const [channel, op] of operations) {\n    if (!op.controller) {\n      throw new Error(`Operation \"${channel}\" has no controller defined`);\n    }\n    if (!op.action) {\n      throw new Error(`Operation \"${channel}\" has no action defined`);\n    }\n  }\n\n  return operations;\n}\n\n/** Parse from file path */\nexport function parseOperationsFile(filePath: string): Map<string, OperationDef> {\n  const content = readFileSync(filePath, 'utf-8');\n  return parseOperations(content);\n}\n"],"mappings":"AAAA,OAAO,UAAU;AACjB,SAAS,oBAAoB;AAGtB,SAAS,gBAAgB,aAAgD;AAC9E,QAAM,MAAM,KAAK,KAAK,WAAW;AACjC,SAAO,wBAAwB,GAAG;AACpC;AAQO,SAAS,wBAAwB,KAAuD;AAC7F,QAAM,aAAa,oBAAI,IAA0B;AAEjD,MAAI,QAAQ,QAAQ,QAAQ,QAAW;AACrC,UAAM,IAAI,MAAM,wFAAwF;AAAA,EAC1G;AACA,MAAI,OAAO,QAAQ,YAAY,MAAM,QAAQ,GAAG,GAAG;AACjD,UAAM,IAAI,MAAM,iFAAiF;AAAA,EACnG;AACA,MAAI,CAAC,IAAI,cAAc,CAAC,IAAI,QAAQ;AAClC,UAAM,IAAI,MAAM,wFAAwF;AAAA,EAC1G;AAIA,QAAM,MAAM,CAAC,SAAiB,QAA4B;AACxD,QAAI,WAAW,IAAI,OAAO,GAAG;AAC3B,YAAM,IAAI,MAAM,gCAAgC,OAAO,2CAA2C;AAAA,IACpG;AACA,eAAW,IAAI,SAAS,GAAG;AAAA,EAC7B;AAGA,MAAI,IAAI,YAAY;AAClB,eAAW,CAAC,SAAS,KAAK,KAAK,OAAO,QAAQ,IAAI,UAAU,GAAG;AAC7D,UAAI,SAAS;AAAA,QACX;AAAA,QACA,YAAY,MAAM;AAAA,QAClB,QAAQ,MAAM;AAAA,QACd,YAAY,MAAM,cAAc,CAAC;AAAA,QACjC,aAAa,MAAM;AAAA,QACnB,cAAc,MAAM;AAAA,MACtB,CAAC;AAAA,IACH;AAAA,EACF;AAGA,MAAI,IAAI,QAAQ;AACd,eAAW,CAAC,YAAY,SAAS,KAAK,OAAO,QAAQ,IAAI,MAAM,GAAG;AAChE,YAAM,mBAAmB,UAAU;AACnC,YAAM,mBAAmB,UAAU,cAAc,CAAC;AAElD,UAAI,UAAU,eAAe,QAAQ,UAAU,eAAe,QAAW;AACvE,cAAM,IAAI,MAAM,WAAW,UAAU,+BAA+B;AAAA,MACtE;AACA,UAAI,OAAO,UAAU,eAAe,YAAY,MAAM,QAAQ,UAAU,UAAU,GAAG;AACnF,cAAM,IAAI,MAAM,WAAW,UAAU,uDAAuD;AAAA,MAC9F;AAEA,iBAAW,CAAC,QAAQ,OAAO,KAAK,OAAO,QAAQ,UAAU,UAAU,GAAG;AACpE,cAAM,UAAU,GAAG,UAAU,IAAI,MAAM;AAIvC,YAAI;AACJ,YAAI,QAAQ,eAAe,QAAS,MAAM,QAAQ,QAAQ,UAAU,KAAK,QAAQ,WAAW,WAAW,GAAI;AACzG,uBAAa,CAAC;AAAA,QAChB,OAAO;AACL,uBAAa,CAAC,GAAG,kBAAkB,GAAI,QAAQ,cAAc,CAAC,CAAE;AAAA,QAClE;AAEA,YAAI,SAAS;AAAA,UACX;AAAA,UACA,QAAQ;AAAA,UACR,YAAY,QAAQ,cAAc,oBAAoB;AAAA,UACtD,QAAQ,QAAQ;AAAA,UAChB;AAAA,UACA,aAAa,QAAQ;AAAA,UACrB,cAAc,QAAQ;AAAA,QACxB,CAAC;AAAA,MACH;AAAA,IACF;AAAA,EACF;AAGA,aAAW,CAAC,SAAS,EAAE,KAAK,YAAY;AACtC,QAAI,CAAC,GAAG,YAAY;AAClB,YAAM,IAAI,MAAM,cAAc,OAAO,6BAA6B;AAAA,IACpE;AACA,QAAI,CAAC,GAAG,QAAQ;AACd,YAAM,IAAI,MAAM,cAAc,OAAO,yBAAyB;AAAA,IAChE;AAAA,EACF;AAEA,SAAO;AACT;AAGO,SAAS,oBAAoB,UAA6C;AAC/E,QAAM,UAAU,aAAa,UAAU,OAAO;AAC9C,SAAO,gBAAgB,OAAO;AAChC;","names":[]}

package/dist/parser/views_parser.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/parser/views_parser.ts"],"sourcesContent":["import yaml from 'js-yaml';\nimport { readFileSync } from 'fs';\nimport type {\n  ViewDef,\n  RawViewsDocument,\n  RawLayoutEntry,\n  RawLayoutObjectEntry,\n  RawLayoutConfig,\n  RawLayoutGroupEntry,\n} from '../types';\n\nfunction validateControllerValue(controller: unknown, contextLabel: string): string | undefined {\n  if (controller === undefined) return undefined;\n  if (typeof controller !== 'string' || controller.trim().length === 0) {\n    throw new Error(`${contextLabel} has invalid controller. Expected a non-empty string.`);\n  }\n  return controller.trim();\n}\n\nfunction validatePreserveValue(preserve: unknown, contextLabel: string): boolean {\n  if (preserve === undefined) return false;\n  if (typeof preserve !== 'boolean') {\n    throw new Error(`${contextLabel} has invalid preserve. Expected a boolean.`);\n  }\n  return preserve;\n}\n\nfunction parseLayoutEntry(entry: RawLayoutEntry, viewKey: string, index: number): { path: string; controller?: string; preserve: boolean } {\n  if (typeof entry === 'string') {\n    const path = entry.trim();\n    if (!path) {\n      throw new Error(`View \"${viewKey}\" has invalid layout entry at index ${index}. Expected a non-empty path string.`);\n    }\n    return { path, preserve: false };\n  }\n\n  const layoutObj = entry as RawLayoutObjectEntry;\n  const layoutPath = layoutObj.path ?? layoutObj.view ?? layoutObj.layout;\n  if (typeof layoutPath !== 'string' || layoutPath.trim().length === 0) {\n    throw new Error(\n      `View \"${viewKey}\" has invalid layout object at index ${index}. ` +\n      'Expected one of: path, view, or layout as a non-empty string.',\n    );\n  }\n\n  return {\n    path: layoutPath.trim(),\n    controller: validateControllerValue(layoutObj.controller, `View \"${viewKey}\" layout[${index}]`),\n    preserve: validatePreserveValue(layoutObj.preserve, `View \"${viewKey}\" layout[${index}]`),\n  };\n}\n\nfunction isLayoutGroupEntry(entry: unknown): entry is RawLayoutGroupEntry {\n  if (!entry || typeof entry !== 'object' || Array.isArray(entry)) return false;\n  return Object.prototype.hasOwnProperty.call(entry, 'views');\n}\n\nfunction isLayoutObjectEntry(entry: unknown): entry is RawLayoutObjectEntry {\n  if (!entry || typeof entry !== 'object' || Array.isArray(entry)) return false;\n  return (\n    Object.prototype.hasOwnProperty.call(entry, 'path') ||\n    Object.prototype.hasOwnProperty.call(entry, 'view') ||\n    Object.prototype.hasOwnProperty.call(entry, 'layout') ||\n    Object.prototype.hasOwnProperty.call(entry, 'controller')\n  );\n}\n\nfunction normalizeLayouts(rawLayout: RawLayoutConfig | undefined, viewKey: string): {\n  entries: RawLayoutEntry[];\n  inheritedController?: string;\n  inheritedPreserve?: boolean;\n} {\n  if (rawLayout === undefined) {\n    return { entries: [] };\n  }\n\n  if (Array.isArray(rawLayout)) {\n    return { entries: rawLayout };\n  }\n\n  if (typeof rawLayout === 'string') {\n    return { entries: [rawLayout] };\n  }\n\n  if (isLayoutGroupEntry(rawLayout)) {\n    if (!Array.isArray(rawLayout.views)) {\n      throw new Error(`View \"${viewKey}\" has invalid layout object. \"views\" must be an array.`);\n    }\n\n    return {\n      entries: rawLayout.views,\n      inheritedController: validateControllerValue(rawLayout.controller, `View \"${viewKey}\" layout`),\n      inheritedPreserve: validatePreserveValue(rawLayout.preserve, `View \"${viewKey}\" layout`),\n    };\n  }\n\n  if (isLayoutObjectEntry(rawLayout)) {\n    return { entries: [rawLayout] };\n  }\n\n  throw new Error(\n    `View \"${viewKey}\" has invalid layout definition. Expected an array, a string path, or an object with \"views\".`,\n  );\n}\n\n/**\n * Parse views YAML content into a flat array of ViewDef.\n * Supports Wood-native `view:` format (dot-path keys).\n */\nexport function parseViews(yamlContent: string): ViewDef[] {\n  const doc = yaml.load(yamlContent) as RawViewsDocument;\n  const views: ViewDef[] = [];\n\n  // Wood-native `view:` format\n  // First segment = window name, rest = page name\n  if (doc.view) {\n    for (const [dotPath, entry] of Object.entries(doc.view)) {\n      const segments = dotPath.split('.');\n      const windowName = segments[0];\n      const pageName = segments.slice(1).join('.');\n\n      const normalizedLayouts = normalizeLayouts(entry.layout, dotPath);\n      const parsedLayouts = normalizedLayouts.entries.map((layoutEntry, index) =>\n        parseLayoutEntry(layoutEntry, dotPath, index),\n      );\n      if (normalizedLayouts.inheritedController) {\n        if (parsedLayouts.length === 0) {\n          throw new Error(\n            `View \"${dotPath}\" sets a layout controller but has no layout views. Define at least one layout entry.`,\n          );\n        }\n\n        const firstLayoutController = parsedLayouts[0].controller;\n        if (firstLayoutController && firstLayoutController !== normalizedLayouts.inheritedController) {\n          throw new Error(\n            `View \"${dotPath}\" has conflicting layout controllers. Use either layout.controller or layout.views[0].controller.`,\n          );\n        }\n        parsedLayouts[0].controller ??= normalizedLayouts.inheritedController;\n      }\n      if (normalizedLayouts.inheritedPreserve) {\n        if (parsedLayouts.length === 0) {\n          throw new Error(\n            `View \"${dotPath}\" sets layout preserve but has no layout views. Define at least one layout entry.`,\n          );\n        }\n        parsedLayouts[0].preserve = true;\n      }\n\n      const layoutPaths = parsedLayouts.map((layout) => layout.path);\n      const layoutControllers = parsedLayouts.map((layout) => layout.controller);\n      const layoutPreserve = parsedLayouts.map((layout) => layout.preserve);\n\n      const viewController = validateControllerValue(entry.controller, `View \"${dotPath}\"`);\n\n      const viewDef: ViewDef = {\n        windowName,\n        pageName,\n        viewPath: entry.view,\n        layouts: layoutPaths,\n        middleware: entry.middleware,\n        controller: viewController,\n      };\n\n      if (layoutControllers.some((value) => value !== undefined)) {\n        viewDef.layoutControllers = layoutControllers;\n      }\n      if (layoutPreserve.some((value) => value)) {\n        viewDef.layoutPreserve = layoutPreserve;\n      }\n\n      views.push(viewDef);\n    }\n  }\n\n  return views;\n}\n\n/** Read a YAML file from disk and parse it into ViewDef[]. */\nexport function parseViewsFile(filePath: string): ViewDef[] {\n  const content = readFileSync(filePath, 'utf-8');\n  return parseViews(content);\n}\n"],"mappings":"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","names":["yaml"]}
+{"version":3,"sources":["../../src/parser/views_parser.ts"],"sourcesContent":["import yaml from 'js-yaml';\nimport { readFileSync } from 'fs';\nimport type {\n  ViewDef,\n  RawViewsDocument,\n  RawLayoutEntry,\n  RawLayoutObjectEntry,\n  RawLayoutConfig,\n  RawLayoutGroupEntry,\n} from '../types/index.cjs';\n\nfunction validateControllerValue(controller: unknown, contextLabel: string): string | undefined {\n  if (controller === undefined) return undefined;\n  if (typeof controller !== 'string' || controller.trim().length === 0) {\n    throw new Error(`${contextLabel} has invalid controller. Expected a non-empty string.`);\n  }\n  return controller.trim();\n}\n\nfunction validatePreserveValue(preserve: unknown, contextLabel: string): boolean {\n  if (preserve === undefined) return false;\n  if (typeof preserve !== 'boolean') {\n    throw new Error(`${contextLabel} has invalid preserve. Expected a boolean.`);\n  }\n  return preserve;\n}\n\nfunction parseLayoutEntry(entry: RawLayoutEntry, viewKey: string, index: number): { path: string; controller?: string; preserve: boolean } {\n  if (typeof entry === 'string') {\n    const path = entry.trim();\n    if (!path) {\n      throw new Error(`View \"${viewKey}\" has invalid layout entry at index ${index}. Expected a non-empty path string.`);\n    }\n    return { path, preserve: false };\n  }\n\n  const layoutObj = entry as RawLayoutObjectEntry;\n  const layoutPath = layoutObj.path ?? layoutObj.view ?? layoutObj.layout;\n  if (typeof layoutPath !== 'string' || layoutPath.trim().length === 0) {\n    throw new Error(\n      `View \"${viewKey}\" has invalid layout object at index ${index}. ` +\n      'Expected one of: path, view, or layout as a non-empty string.',\n    );\n  }\n\n  return {\n    path: layoutPath.trim(),\n    controller: validateControllerValue(layoutObj.controller, `View \"${viewKey}\" layout[${index}]`),\n    preserve: validatePreserveValue(layoutObj.preserve, `View \"${viewKey}\" layout[${index}]`),\n  };\n}\n\nfunction isLayoutGroupEntry(entry: unknown): entry is RawLayoutGroupEntry {\n  if (!entry || typeof entry !== 'object' || Array.isArray(entry)) return false;\n  return Object.prototype.hasOwnProperty.call(entry, 'views');\n}\n\nfunction isLayoutObjectEntry(entry: unknown): entry is RawLayoutObjectEntry {\n  if (!entry || typeof entry !== 'object' || Array.isArray(entry)) return false;\n  return (\n    Object.prototype.hasOwnProperty.call(entry, 'path') ||\n    Object.prototype.hasOwnProperty.call(entry, 'view') ||\n    Object.prototype.hasOwnProperty.call(entry, 'layout') ||\n    Object.prototype.hasOwnProperty.call(entry, 'controller')\n  );\n}\n\nfunction normalizeLayouts(rawLayout: RawLayoutConfig | undefined, viewKey: string): {\n  entries: RawLayoutEntry[];\n  inheritedController?: string;\n  inheritedPreserve?: boolean;\n} {\n  if (rawLayout === undefined) {\n    return { entries: [] };\n  }\n\n  if (Array.isArray(rawLayout)) {\n    return { entries: rawLayout };\n  }\n\n  if (typeof rawLayout === 'string') {\n    return { entries: [rawLayout] };\n  }\n\n  if (isLayoutGroupEntry(rawLayout)) {\n    if (!Array.isArray(rawLayout.views)) {\n      throw new Error(`View \"${viewKey}\" has invalid layout object. \"views\" must be an array.`);\n    }\n\n    return {\n      entries: rawLayout.views,\n      inheritedController: validateControllerValue(rawLayout.controller, `View \"${viewKey}\" layout`),\n      inheritedPreserve: validatePreserveValue(rawLayout.preserve, `View \"${viewKey}\" layout`),\n    };\n  }\n\n  if (isLayoutObjectEntry(rawLayout)) {\n    return { entries: [rawLayout] };\n  }\n\n  throw new Error(\n    `View \"${viewKey}\" has invalid layout definition. Expected an array, a string path, or an object with \"views\".`,\n  );\n}\n\n/**\n * Parse views YAML content into a flat array of ViewDef.\n * Supports Wood-native `view:` format (dot-path keys).\n */\nexport function parseViews(yamlContent: string): ViewDef[] {\n  const doc = yaml.load(yamlContent) as RawViewsDocument;\n  const views: ViewDef[] = [];\n\n  // Wood-native `view:` format\n  // First segment = window name, rest = page name\n  if (doc.view) {\n    for (const [dotPath, entry] of Object.entries(doc.view)) {\n      const segments = dotPath.split('.');\n      const windowName = segments[0];\n      const pageName = segments.slice(1).join('.');\n\n      const normalizedLayouts = normalizeLayouts(entry.layout, dotPath);\n      const parsedLayouts = normalizedLayouts.entries.map((layoutEntry, index) =>\n        parseLayoutEntry(layoutEntry, dotPath, index),\n      );\n      if (normalizedLayouts.inheritedController) {\n        if (parsedLayouts.length === 0) {\n          throw new Error(\n            `View \"${dotPath}\" sets a layout controller but has no layout views. Define at least one layout entry.`,\n          );\n        }\n\n        const firstLayoutController = parsedLayouts[0].controller;\n        if (firstLayoutController && firstLayoutController !== normalizedLayouts.inheritedController) {\n          throw new Error(\n            `View \"${dotPath}\" has conflicting layout controllers. Use either layout.controller or layout.views[0].controller.`,\n          );\n        }\n        parsedLayouts[0].controller ??= normalizedLayouts.inheritedController;\n      }\n      if (normalizedLayouts.inheritedPreserve) {\n        if (parsedLayouts.length === 0) {\n          throw new Error(\n            `View \"${dotPath}\" sets layout preserve but has no layout views. Define at least one layout entry.`,\n          );\n        }\n        parsedLayouts[0].preserve = true;\n      }\n\n      const layoutPaths = parsedLayouts.map((layout) => layout.path);\n      const layoutControllers = parsedLayouts.map((layout) => layout.controller);\n      const layoutPreserve = parsedLayouts.map((layout) => layout.preserve);\n\n      const viewController = validateControllerValue(entry.controller, `View \"${dotPath}\"`);\n\n      const viewDef: ViewDef = {\n        windowName,\n        pageName,\n        viewPath: entry.view,\n        layouts: layoutPaths,\n        middleware: entry.middleware,\n        controller: viewController,\n      };\n\n      if (layoutControllers.some((value) => value !== undefined)) {\n        viewDef.layoutControllers = layoutControllers;\n      }\n      if (layoutPreserve.some((value) => value)) {\n        viewDef.layoutPreserve = layoutPreserve;\n      }\n\n      views.push(viewDef);\n    }\n  }\n\n  return views;\n}\n\n/** Read a YAML file from disk and parse it into ViewDef[]. */\nexport function parseViewsFile(filePath: string): ViewDef[] {\n  const content = readFileSync(filePath, 'utf-8');\n  return parseViews(content);\n}\n"],"mappings":"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","names":["yaml"]}

package/dist/parser/views_parser.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/parser/views_parser.ts"],"sourcesContent":["import yaml from 'js-yaml';\nimport { readFileSync } from 'fs';\nimport type {\n  ViewDef,\n  RawViewsDocument,\n  RawLayoutEntry,\n  RawLayoutObjectEntry,\n  RawLayoutConfig,\n  RawLayoutGroupEntry,\n} from '../types';\n\nfunction validateControllerValue(controller: unknown, contextLabel: string): string | undefined {\n  if (controller === undefined) return undefined;\n  if (typeof controller !== 'string' || controller.trim().length === 0) {\n    throw new Error(`${contextLabel} has invalid controller. Expected a non-empty string.`);\n  }\n  return controller.trim();\n}\n\nfunction validatePreserveValue(preserve: unknown, contextLabel: string): boolean {\n  if (preserve === undefined) return false;\n  if (typeof preserve !== 'boolean') {\n    throw new Error(`${contextLabel} has invalid preserve. Expected a boolean.`);\n  }\n  return preserve;\n}\n\nfunction parseLayoutEntry(entry: RawLayoutEntry, viewKey: string, index: number): { path: string; controller?: string; preserve: boolean } {\n  if (typeof entry === 'string') {\n    const path = entry.trim();\n    if (!path) {\n      throw new Error(`View \"${viewKey}\" has invalid layout entry at index ${index}. Expected a non-empty path string.`);\n    }\n    return { path, preserve: false };\n  }\n\n  const layoutObj = entry as RawLayoutObjectEntry;\n  const layoutPath = layoutObj.path ?? layoutObj.view ?? layoutObj.layout;\n  if (typeof layoutPath !== 'string' || layoutPath.trim().length === 0) {\n    throw new Error(\n      `View \"${viewKey}\" has invalid layout object at index ${index}. ` +\n      'Expected one of: path, view, or layout as a non-empty string.',\n    );\n  }\n\n  return {\n    path: layoutPath.trim(),\n    controller: validateControllerValue(layoutObj.controller, `View \"${viewKey}\" layout[${index}]`),\n    preserve: validatePreserveValue(layoutObj.preserve, `View \"${viewKey}\" layout[${index}]`),\n  };\n}\n\nfunction isLayoutGroupEntry(entry: unknown): entry is RawLayoutGroupEntry {\n  if (!entry || typeof entry !== 'object' || Array.isArray(entry)) return false;\n  return Object.prototype.hasOwnProperty.call(entry, 'views');\n}\n\nfunction isLayoutObjectEntry(entry: unknown): entry is RawLayoutObjectEntry {\n  if (!entry || typeof entry !== 'object' || Array.isArray(entry)) return false;\n  return (\n    Object.prototype.hasOwnProperty.call(entry, 'path') ||\n    Object.prototype.hasOwnProperty.call(entry, 'view') ||\n    Object.prototype.hasOwnProperty.call(entry, 'layout') ||\n    Object.prototype.hasOwnProperty.call(entry, 'controller')\n  );\n}\n\nfunction normalizeLayouts(rawLayout: RawLayoutConfig | undefined, viewKey: string): {\n  entries: RawLayoutEntry[];\n  inheritedController?: string;\n  inheritedPreserve?: boolean;\n} {\n  if (rawLayout === undefined) {\n    return { entries: [] };\n  }\n\n  if (Array.isArray(rawLayout)) {\n    return { entries: rawLayout };\n  }\n\n  if (typeof rawLayout === 'string') {\n    return { entries: [rawLayout] };\n  }\n\n  if (isLayoutGroupEntry(rawLayout)) {\n    if (!Array.isArray(rawLayout.views)) {\n      throw new Error(`View \"${viewKey}\" has invalid layout object. \"views\" must be an array.`);\n    }\n\n    return {\n      entries: rawLayout.views,\n      inheritedController: validateControllerValue(rawLayout.controller, `View \"${viewKey}\" layout`),\n      inheritedPreserve: validatePreserveValue(rawLayout.preserve, `View \"${viewKey}\" layout`),\n    };\n  }\n\n  if (isLayoutObjectEntry(rawLayout)) {\n    return { entries: [rawLayout] };\n  }\n\n  throw new Error(\n    `View \"${viewKey}\" has invalid layout definition. Expected an array, a string path, or an object with \"views\".`,\n  );\n}\n\n/**\n * Parse views YAML content into a flat array of ViewDef.\n * Supports Wood-native `view:` format (dot-path keys).\n */\nexport function parseViews(yamlContent: string): ViewDef[] {\n  const doc = yaml.load(yamlContent) as RawViewsDocument;\n  const views: ViewDef[] = [];\n\n  // Wood-native `view:` format\n  // First segment = window name, rest = page name\n  if (doc.view) {\n    for (const [dotPath, entry] of Object.entries(doc.view)) {\n      const segments = dotPath.split('.');\n      const windowName = segments[0];\n      const pageName = segments.slice(1).join('.');\n\n      const normalizedLayouts = normalizeLayouts(entry.layout, dotPath);\n      const parsedLayouts = normalizedLayouts.entries.map((layoutEntry, index) =>\n        parseLayoutEntry(layoutEntry, dotPath, index),\n      );\n      if (normalizedLayouts.inheritedController) {\n        if (parsedLayouts.length === 0) {\n          throw new Error(\n            `View \"${dotPath}\" sets a layout controller but has no layout views. Define at least one layout entry.`,\n          );\n        }\n\n        const firstLayoutController = parsedLayouts[0].controller;\n        if (firstLayoutController && firstLayoutController !== normalizedLayouts.inheritedController) {\n          throw new Error(\n            `View \"${dotPath}\" has conflicting layout controllers. Use either layout.controller or layout.views[0].controller.`,\n          );\n        }\n        parsedLayouts[0].controller ??= normalizedLayouts.inheritedController;\n      }\n      if (normalizedLayouts.inheritedPreserve) {\n        if (parsedLayouts.length === 0) {\n          throw new Error(\n            `View \"${dotPath}\" sets layout preserve but has no layout views. Define at least one layout entry.`,\n          );\n        }\n        parsedLayouts[0].preserve = true;\n      }\n\n      const layoutPaths = parsedLayouts.map((layout) => layout.path);\n      const layoutControllers = parsedLayouts.map((layout) => layout.controller);\n      const layoutPreserve = parsedLayouts.map((layout) => layout.preserve);\n\n      const viewController = validateControllerValue(entry.controller, `View \"${dotPath}\"`);\n\n      const viewDef: ViewDef = {\n        windowName,\n        pageName,\n        viewPath: entry.view,\n        layouts: layoutPaths,\n        middleware: entry.middleware,\n        controller: viewController,\n      };\n\n      if (layoutControllers.some((value) => value !== undefined)) {\n        viewDef.layoutControllers = layoutControllers;\n      }\n      if (layoutPreserve.some((value) => value)) {\n        viewDef.layoutPreserve = layoutPreserve;\n      }\n\n      views.push(viewDef);\n    }\n  }\n\n  return views;\n}\n\n/** Read a YAML file from disk and parse it into ViewDef[]. */\nexport function parseViewsFile(filePath: string): ViewDef[] {\n  const content = readFileSync(filePath, 'utf-8');\n  return parseViews(content);\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/parser/views_parser.ts"],"sourcesContent":["import yaml from 'js-yaml';\nimport { readFileSync } from 'fs';\nimport type {\n  ViewDef,\n  RawViewsDocument,\n  RawLayoutEntry,\n  RawLayoutObjectEntry,\n  RawLayoutConfig,\n  RawLayoutGroupEntry,\n} from '../types/index.js';\n\nfunction validateControllerValue(controller: unknown, contextLabel: string): string | undefined {\n  if (controller === undefined) return undefined;\n  if (typeof controller !== 'string' || controller.trim().length === 0) {\n    throw new Error(`${contextLabel} has invalid controller. Expected a non-empty string.`);\n  }\n  return controller.trim();\n}\n\nfunction validatePreserveValue(preserve: unknown, contextLabel: string): boolean {\n  if (preserve === undefined) return false;\n  if (typeof preserve !== 'boolean') {\n    throw new Error(`${contextLabel} has invalid preserve. Expected a boolean.`);\n  }\n  return preserve;\n}\n\nfunction parseLayoutEntry(entry: RawLayoutEntry, viewKey: string, index: number): { path: string; controller?: string; preserve: boolean } {\n  if (typeof entry === 'string') {\n    const path = entry.trim();\n    if (!path) {\n      throw new Error(`View \"${viewKey}\" has invalid layout entry at index ${index}. Expected a non-empty path string.`);\n    }\n    return { path, preserve: false };\n  }\n\n  const layoutObj = entry as RawLayoutObjectEntry;\n  const layoutPath = layoutObj.path ?? layoutObj.view ?? layoutObj.layout;\n  if (typeof layoutPath !== 'string' || layoutPath.trim().length === 0) {\n    throw new Error(\n      `View \"${viewKey}\" has invalid layout object at index ${index}. ` +\n      'Expected one of: path, view, or layout as a non-empty string.',\n    );\n  }\n\n  return {\n    path: layoutPath.trim(),\n    controller: validateControllerValue(layoutObj.controller, `View \"${viewKey}\" layout[${index}]`),\n    preserve: validatePreserveValue(layoutObj.preserve, `View \"${viewKey}\" layout[${index}]`),\n  };\n}\n\nfunction isLayoutGroupEntry(entry: unknown): entry is RawLayoutGroupEntry {\n  if (!entry || typeof entry !== 'object' || Array.isArray(entry)) return false;\n  return Object.prototype.hasOwnProperty.call(entry, 'views');\n}\n\nfunction isLayoutObjectEntry(entry: unknown): entry is RawLayoutObjectEntry {\n  if (!entry || typeof entry !== 'object' || Array.isArray(entry)) return false;\n  return (\n    Object.prototype.hasOwnProperty.call(entry, 'path') ||\n    Object.prototype.hasOwnProperty.call(entry, 'view') ||\n    Object.prototype.hasOwnProperty.call(entry, 'layout') ||\n    Object.prototype.hasOwnProperty.call(entry, 'controller')\n  );\n}\n\nfunction normalizeLayouts(rawLayout: RawLayoutConfig | undefined, viewKey: string): {\n  entries: RawLayoutEntry[];\n  inheritedController?: string;\n  inheritedPreserve?: boolean;\n} {\n  if (rawLayout === undefined) {\n    return { entries: [] };\n  }\n\n  if (Array.isArray(rawLayout)) {\n    return { entries: rawLayout };\n  }\n\n  if (typeof rawLayout === 'string') {\n    return { entries: [rawLayout] };\n  }\n\n  if (isLayoutGroupEntry(rawLayout)) {\n    if (!Array.isArray(rawLayout.views)) {\n      throw new Error(`View \"${viewKey}\" has invalid layout object. \"views\" must be an array.`);\n    }\n\n    return {\n      entries: rawLayout.views,\n      inheritedController: validateControllerValue(rawLayout.controller, `View \"${viewKey}\" layout`),\n      inheritedPreserve: validatePreserveValue(rawLayout.preserve, `View \"${viewKey}\" layout`),\n    };\n  }\n\n  if (isLayoutObjectEntry(rawLayout)) {\n    return { entries: [rawLayout] };\n  }\n\n  throw new Error(\n    `View \"${viewKey}\" has invalid layout definition. Expected an array, a string path, or an object with \"views\".`,\n  );\n}\n\n/**\n * Parse views YAML content into a flat array of ViewDef.\n * Supports Wood-native `view:` format (dot-path keys).\n */\nexport function parseViews(yamlContent: string): ViewDef[] {\n  const doc = yaml.load(yamlContent) as RawViewsDocument;\n  const views: ViewDef[] = [];\n\n  // Wood-native `view:` format\n  // First segment = window name, rest = page name\n  if (doc.view) {\n    for (const [dotPath, entry] of Object.entries(doc.view)) {\n      const segments = dotPath.split('.');\n      const windowName = segments[0];\n      const pageName = segments.slice(1).join('.');\n\n      const normalizedLayouts = normalizeLayouts(entry.layout, dotPath);\n      const parsedLayouts = normalizedLayouts.entries.map((layoutEntry, index) =>\n        parseLayoutEntry(layoutEntry, dotPath, index),\n      );\n      if (normalizedLayouts.inheritedController) {\n        if (parsedLayouts.length === 0) {\n          throw new Error(\n            `View \"${dotPath}\" sets a layout controller but has no layout views. Define at least one layout entry.`,\n          );\n        }\n\n        const firstLayoutController = parsedLayouts[0].controller;\n        if (firstLayoutController && firstLayoutController !== normalizedLayouts.inheritedController) {\n          throw new Error(\n            `View \"${dotPath}\" has conflicting layout controllers. Use either layout.controller or layout.views[0].controller.`,\n          );\n        }\n        parsedLayouts[0].controller ??= normalizedLayouts.inheritedController;\n      }\n      if (normalizedLayouts.inheritedPreserve) {\n        if (parsedLayouts.length === 0) {\n          throw new Error(\n            `View \"${dotPath}\" sets layout preserve but has no layout views. Define at least one layout entry.`,\n          );\n        }\n        parsedLayouts[0].preserve = true;\n      }\n\n      const layoutPaths = parsedLayouts.map((layout) => layout.path);\n      const layoutControllers = parsedLayouts.map((layout) => layout.controller);\n      const layoutPreserve = parsedLayouts.map((layout) => layout.preserve);\n\n      const viewController = validateControllerValue(entry.controller, `View \"${dotPath}\"`);\n\n      const viewDef: ViewDef = {\n        windowName,\n        pageName,\n        viewPath: entry.view,\n        layouts: layoutPaths,\n        middleware: entry.middleware,\n        controller: viewController,\n      };\n\n      if (layoutControllers.some((value) => value !== undefined)) {\n        viewDef.layoutControllers = layoutControllers;\n      }\n      if (layoutPreserve.some((value) => value)) {\n        viewDef.layoutPreserve = layoutPreserve;\n      }\n\n      views.push(viewDef);\n    }\n  }\n\n  return views;\n}\n\n/** Read a YAML file from disk and parse it into ViewDef[]. */\nexport function parseViewsFile(filePath: string): ViewDef[] {\n  const content = readFileSync(filePath, 'utf-8');\n  return parseViews(content);\n}\n"],"mappings":"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","names":[]}

package/dist/router/index.d.cts

@@ -1,2 +1,3 @@
 export { RESERVED_CHANNELS, ReservedChannel, ReservedChannelHandler, WoodRouter } from './wood_router.cjs';
 import '../types/operations.cjs';
+import '../types/context.cjs';

package/dist/router/index.d.ts

@@ -1,2 +1,3 @@
 export { RESERVED_CHANNELS, ReservedChannel, ReservedChannelHandler, WoodRouter } from './wood_router.js';
 import '../types/operations.js';
+import '../types/context.js';

package/dist/router/wood_router.cjs

@@ -29,6 +29,7 @@ var import_middleware_pipeline = require("../middleware/middleware_pipeline.cjs"
 var import_controller_resolver = require("../controller/controller_resolver.cjs");
 var import_controller_lifecycle = require("../controller/controller_lifecycle.cjs");
 var import_logger = require("@noego/logger");
+var import_ioc = require("@noego/ioc");
 var import_tracing = require("../tracing/index.js");
 const logger = (0, import_logger.getLogger)("wood:router");
 function extractTraceConversationId(value) {
@@ -53,6 +54,10 @@ const RESERVED_CHANNELS = [
   "__woodConfig",
   "__traceBatch"
 ];
+function controllerAlreadyRegistered(scope, ControllerClass) {
+  const candidate = scope;
+  return typeof candidate.isRegistered === "function" && candidate.isRegistered(ControllerClass);
+}
 class WoodRouter {
   // IoC Container
   constructor(options) {
@@ -168,8 +173,14 @@ class WoodRouter {
     }
     const ControllerClass = await this.controllerResolver.resolveClass(opDef.controller);
     const scopedContainer = this.container.extend();
-    const instance = await scopedContainer.instance(ControllerClass);
-    const args = (0, import_controller_resolver.buildControllerArgs)(ipcContext, scopedContainer);
+    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;
@@ -179,7 +190,7 @@ class WoodRouter {
           `Controller "${opDef.controller}" has no action "${opDef.action}"`
         );
       }
-      result = await action.call(instance, args);
+      result = await import_ioc.ExecutionContext.run(scopedContainer, () => action.call(instance, args));
       (0, import_tracing.publishMainTrace)("debug", {
         source: "wood.router",
         type: "dispatch.success",
@@ -206,6 +217,9 @@ class WoodRouter {
     } 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",
@@ -236,6 +250,15 @@ class WoodRouter {
   registerController(name, ControllerClass) {
     this.controllerResolver.register(name, ControllerClass);
   }
+  /**
+   * Pre-register the executable for a production middleware identity so it
+   * resolves from the registry instead of the filesystem — the bundled-mode
+   * path for middleware, and the seam test environments use to replace an
+   * identity's behavior without touching source topology.
+   */
+  registerMiddleware(spec, middleware) {
+    this.middlewareResolver.register(spec, middleware);
+  }
   /**
    * Register an import path for a controller. The controller will be lazily
    * imported from this path when first needed, avoiding circular dependencies.
@@ -243,6 +266,15 @@ class WoodRouter {
   registerControllerPath(name, importPath) {
     this.controllerResolver.registerPath(name, importPath);
   }
+  /**
+   * Register a caller-owned lazy loader for a controller: the module is
+   * imported through the CALLER's `() => import('…literal specifier…')` only
+   * on first dispatch, preserving the caller's module identity for the
+   * controller graph (thin production slices in tests).
+   */
+  registerControllerLoader(name, loader) {
+    this.controllerResolver.registerLoader(name, loader);
+  }
   /**
    * Validate that every controller referenced in loaded operations is
    * pre-registered in the controller resolver. Call this after

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 } from '../controller/controller_resolver.cjs';\nimport { disposeControllerLifecycle } from '../controller/controller_lifecycle.cjs';\nimport { getLogger } from '@noego/logger';\nimport { publishMainTrace } from '../tracing/index.js';\n\nconst logger = getLogger('wood:router');\n\nfunction extractTraceConversationId(value: unknown): number | string | undefined {\n  if (!value || typeof value !== 'object' || Array.isArray(value)) {\n    return undefined;\n  }\n\n  const record = value as Record<string, unknown>;\n  if (typeof record.conversationId === 'number' || typeof record.conversationId === 'string') {\n    return record.conversationId;\n  }\n  if (typeof record.threadId === 'number' || typeof record.threadId === 'string') {\n    return record.threadId;\n  }\n\n  return undefined;\n}\n\n/** Reserved internal channels prefixed with __ to avoid collisions with user operations. */\nexport const RESERVED_CHANNELS = [\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\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)\n    const scopedContainer = this.container.extend();\n    const instance = await scopedContainer.instance(ControllerClass);\n\n    // 6. Build controller args (fake req/res)\n    const args = buildControllerArgs(ipcContext, scopedContainer);\n\n    // 7. Call action, always dispose controller afterward\n    const action = instance[opDef.action];\n    let result: unknown;\n    let actionError: unknown;\n\n    try {\n      if (typeof action !== 'function') {\n        throw new Error(\n          `Controller \"${opDef.controller}\" has no action \"${opDef.action}\"`\n        );\n      }\n\n      result = await action.call(instance, args);\n      publishMainTrace('debug', {\n        source: 'wood.router',\n        type: 'dispatch.success',\n        ...(conversationId !== undefined ? { conversationId } : {}),\n        payload: {\n          channel,\n          controller: opDef.controller,\n          action: opDef.action,\n        },\n      });\n    } catch (error) {\n      actionError = error;\n      publishMainTrace('error', {\n        source: 'wood.router',\n        type: 'dispatch.error',\n        message: error instanceof Error ? error.message : String(error),\n        ...(conversationId !== undefined ? { conversationId } : {}),\n        payload: {\n          channel,\n          controller: opDef.controller,\n          action: opDef.action,\n        },\n      });\n    } finally {\n      try {\n        await disposeControllerLifecycle(instance);\n      } catch (disposeError) {\n        publishMainTrace('error', {\n          source: 'wood.router',\n          type: 'dispatch.dispose.error',\n          message: disposeError instanceof Error ? disposeError.message : String(disposeError),\n          ...(conversationId !== undefined ? { conversationId } : {}),\n          payload: {\n            channel,\n            controller: opDef.controller,\n            action: opDef.action,\n          },\n        });\n\n        if (!actionError) {\n          actionError = disposeError;\n        }\n      }\n    }\n\n    if (actionError) {\n      throw actionError;\n    }\n\n    return result;\n  }\n\n  /**\n   * Pre-register a controller class by name so it is resolved from\n   * the in-memory cache instead of the filesystem.\n   * This is the public API used by the generated registration file.\n   */\n  registerController(name: string, ControllerClass: any): void {\n    this.controllerResolver.register(name, ControllerClass);\n  }\n\n  /**\n   * Register an import path for a controller. The controller will be lazily\n   * imported from this path when first needed, avoiding circular dependencies.\n   */\n  registerControllerPath(name: string, importPath: string): void {\n    this.controllerResolver.registerPath(name, importPath);\n  }\n\n  /**\n   * Validate that every controller referenced in loaded operations is\n   * pre-registered in the controller resolver. Call this after\n   * loadOperations() + registerControllers() but before registerIpcHandlers().\n   *\n   * Throws with a clear error listing all missing controllers if any\n   * operation references a controller that was not pre-registered.\n   */\n  validateControllers(): void {\n    const missing: Array<{ channel: string; controller: string }> = [];\n\n    for (const [channel, opDef] of this.operations) {\n      if (!this.controllerResolver.has(opDef.controller)) {\n        missing.push({ channel, controller: opDef.controller });\n      }\n    }\n\n    if (missing.length > 0) {\n      const details = missing\n        .map(m => `  - channel \"${m.channel}\" requires controller \"${m.controller}\"`)\n        .join('\\n');\n\n      throw new Error(\n        `WoodRouter: ${missing.length} operation(s) reference controllers that are not registered.\\n` +\n        `This usually means controllers.generated.ts is missing or out of date.\\n` +\n        `Run \"npx wood build\" or \"npx wood dev\" to regenerate it.\\n\\n` +\n        `Missing controllers:\\n${details}`\n      );\n    }\n\n    logger.info(`All ${this.operations.size} operations have registered controllers`);\n  }\n\n  /**\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 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"]}

package/dist/router/wood_router.d.cts

@@ -1,4 +1,5 @@
 import { OperationDef } from '../types/operations.cjs';
+import { WoodMiddlewareFn } from '../types/context.cjs';
 
 /** Reserved internal channels prefixed with __ to avoid collisions with user operations. */
 declare const RESERVED_CHANNELS: readonly ["__load", "__navigate", "__window", "__debug", "__contextMenu", "__woodConfig", "__traceBatch"];
@@ -47,11 +48,25 @@ declare class WoodRouter {
      * This is the public API used by the generated registration file.
      */
     registerController(name: string, ControllerClass: any): void;
+    /**
+     * Pre-register the executable for a production middleware identity so it
+     * resolves from the registry instead of the filesystem — the bundled-mode
+     * path for middleware, and the seam test environments use to replace an
+     * identity's behavior without touching source topology.
+     */
+    registerMiddleware(spec: string, middleware: WoodMiddlewareFn): void;
     /**
      * Register an import path for a controller. The controller will be lazily
      * imported from this path when first needed, avoiding circular dependencies.
      */
     registerControllerPath(name: string, importPath: string): void;
+    /**
+     * Register a caller-owned lazy loader for a controller: the module is
+     * imported through the CALLER's `() => import('…literal specifier…')` only
+     * on first dispatch, preserving the caller's module identity for the
+     * controller graph (thin production slices in tests).
+     */
+    registerControllerLoader(name: string, loader: () => Promise<unknown>): void;
     /**
      * Validate that every controller referenced in loaded operations is
      * pre-registered in the controller resolver. Call this after

package/dist/router/wood_router.d.ts

@@ -1,4 +1,5 @@
 import { OperationDef } from '../types/operations.js';
+import { WoodMiddlewareFn } from '../types/context.js';
 
 /** Reserved internal channels prefixed with __ to avoid collisions with user operations. */
 declare const RESERVED_CHANNELS: readonly ["__load", "__navigate", "__window", "__debug", "__contextMenu", "__woodConfig", "__traceBatch"];
@@ -47,11 +48,25 @@ declare class WoodRouter {
      * This is the public API used by the generated registration file.
      */
     registerController(name: string, ControllerClass: any): void;
+    /**
+     * Pre-register the executable for a production middleware identity so it
+     * resolves from the registry instead of the filesystem — the bundled-mode
+     * path for middleware, and the seam test environments use to replace an
+     * identity's behavior without touching source topology.
+     */
+    registerMiddleware(spec: string, middleware: WoodMiddlewareFn): void;
     /**
      * Register an import path for a controller. The controller will be lazily
      * imported from this path when first needed, avoiding circular dependencies.
      */
     registerControllerPath(name: string, importPath: string): void;
+    /**
+     * Register a caller-owned lazy loader for a controller: the module is
+     * imported through the CALLER's `() => import('…literal specifier…')` only
+     * on first dispatch, preserving the caller's module identity for the
+     * controller graph (thin production slices in tests).
+     */
+    registerControllerLoader(name: string, loader: () => Promise<unknown>): void;
     /**
      * Validate that every controller referenced in loaded operations is
      * pre-registered in the controller resolver. Call this after

package/dist/router/wood_router.js

@@ -2,9 +2,10 @@ import { WoodValidationError } from "../types/index.js";
 import { SchemaValidator } from "../validation/schema_validator.js";
 import { MiddlewareResolver } from "../middleware/middleware_resolver.js";
 import { buildMiddlewareContext, executeMiddleware } from "../middleware/middleware_pipeline.js";
-import { ControllerResolver, buildControllerArgs } from "../controller/controller_resolver.js";
+import { ControllerResolver, buildControllerArgs, buildOperationContext, usesOperationContext } from "../controller/controller_resolver.js";
 import { disposeControllerLifecycle } from "../controller/controller_lifecycle.js";
 import { getLogger } from "@noego/logger";
+import { ExecutionContext } from "@noego/ioc";
 import { publishMainTrace } from "../tracing/index.js";
 const logger = getLogger("wood:router");
 function extractTraceConversationId(value) {
@@ -29,6 +30,10 @@ const RESERVED_CHANNELS = [
   "__woodConfig",
   "__traceBatch"
 ];
+function controllerAlreadyRegistered(scope, ControllerClass) {
+  const candidate = scope;
+  return typeof candidate.isRegistered === "function" && candidate.isRegistered(ControllerClass);
+}
 class WoodRouter {
   // IoC Container
   constructor(options) {
@@ -144,8 +149,14 @@ class WoodRouter {
     }
     const ControllerClass = await this.controllerResolver.resolveClass(opDef.controller);
     const scopedContainer = this.container.extend();
-    const instance = await scopedContainer.instance(ControllerClass);
-    const args = buildControllerArgs(ipcContext, scopedContainer);
+    if (!controllerAlreadyRegistered(scopedContainer, ControllerClass) && typeof scopedContainer.registerClass === "function") {
+      scopedContainer.registerClass(ControllerClass);
+    }
+    const instance = await ExecutionContext.run(
+      scopedContainer,
+      () => scopedContainer.instance(ControllerClass)
+    );
+    const args = usesOperationContext(ControllerClass) ? buildOperationContext(channel, ipcContext) : buildControllerArgs(ipcContext, scopedContainer);
     const action = instance[opDef.action];
     let result;
     let actionError;
@@ -155,7 +166,7 @@ class WoodRouter {
           `Controller "${opDef.controller}" has no action "${opDef.action}"`
         );
       }
-      result = await action.call(instance, args);
+      result = await ExecutionContext.run(scopedContainer, () => action.call(instance, args));
       publishMainTrace("debug", {
         source: "wood.router",
         type: "dispatch.success",
@@ -182,6 +193,9 @@ class WoodRouter {
     } finally {
       try {
         await disposeControllerLifecycle(instance);
+        if (typeof scopedContainer.dispose === "function") {
+          await scopedContainer.dispose();
+        }
       } catch (disposeError) {
         publishMainTrace("error", {
           source: "wood.router",
@@ -212,6 +226,15 @@ class WoodRouter {
   registerController(name, ControllerClass) {
     this.controllerResolver.register(name, ControllerClass);
   }
+  /**
+   * Pre-register the executable for a production middleware identity so it
+   * resolves from the registry instead of the filesystem — the bundled-mode
+   * path for middleware, and the seam test environments use to replace an
+   * identity's behavior without touching source topology.
+   */
+  registerMiddleware(spec, middleware) {
+    this.middlewareResolver.register(spec, middleware);
+  }
   /**
    * Register an import path for a controller. The controller will be lazily
    * imported from this path when first needed, avoiding circular dependencies.
@@ -219,6 +242,15 @@ class WoodRouter {
   registerControllerPath(name, importPath) {
     this.controllerResolver.registerPath(name, importPath);
   }
+  /**
+   * Register a caller-owned lazy loader for a controller: the module is
+   * imported through the CALLER's `() => import('…literal specifier…')` only
+   * on first dispatch, preserving the caller's module identity for the
+   * controller graph (thin production slices in tests).
+   */
+  registerControllerLoader(name, loader) {
+    this.controllerResolver.registerLoader(name, loader);
+  }
   /**
    * Validate that every controller referenced in loaded operations is
    * pre-registered in the controller resolver. Call this after