@dudousxd/nestjs-codegen 0.2.1 → 0.4.0

package/dist/nest/index.js

@@ -32,112 +32,9 @@ var CodegenError = class extends Error {
   }
 };
 
-// src/adapters/zod.ts
-function toObjectKey(name) {
-  return /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(name) ? name : JSON.stringify(name);
-}
-function messageSuffix(messageRaw2) {
-  return messageRaw2 ? `{ message: ${messageRaw2} }` : "";
-}
-function renderStringChecks(checks) {
-  let out = "";
-  for (const c of checks) {
-    switch (c.check) {
-      case "email":
-        out += `.email(${messageSuffix(c.messageRaw)})`;
-        break;
-      case "url":
-        out += `.url(${messageSuffix(c.messageRaw)})`;
-        break;
-      case "uuid":
-        out += `.uuid(${messageSuffix(c.messageRaw)})`;
-        break;
-      case "regex":
-        out += `.regex(${c.pattern})`;
-        break;
-      case "min":
-        out += `.min(${c.value})`;
-        break;
-      case "max":
-        out += `.max(${c.value})`;
-        break;
-    }
-  }
-  return out;
-}
-function render(node, ctx) {
-  switch (node.kind) {
-    case "string":
-      return `z.string()${renderStringChecks(node.checks)}`;
-    case "number": {
-      let out = "z.number()";
-      for (const c of node.checks) {
-        if (c.check === "int") out += ".int()";
-        else if (c.check === "positive") out += ".positive()";
-        else if (c.check === "negative") out += ".negative()";
-        else if (c.check === "min") out += `.min(${c.value})`;
-        else if (c.check === "max") out += `.max(${c.value})`;
-      }
-      return out;
-    }
-    case "boolean":
-      return "z.boolean()";
-    case "date":
-      return "z.coerce.date()";
-    case "unknown":
-      return node.note ? `z.unknown() /* ${node.note} */` : "z.unknown()";
-    case "instanceof":
-      return `z.instanceof(${node.ctor})`;
-    case "enum":
-      return `z.enum([${node.literals.join(", ")}])`;
-    case "literal":
-      return `z.literal(${node.raw})`;
-    case "union":
-      return `z.union([${node.options.map((o) => render(o, ctx)).join(", ")}])`;
-    case "object": {
-      if (node.fields.length === 0) {
-        return node.passthrough ? "z.object({}).passthrough()" : "z.object({})";
-      }
-      const inner = node.fields.map((f) => `${toObjectKey(f.key)}: ${render(f.value, ctx)}`).join(", ");
-      return `z.object({ ${inner} })${node.passthrough ? ".passthrough()" : ""}`;
-    }
-    case "array":
-      return `z.array(${render(node.element, ctx)})`;
-    case "optional":
-      return `${render(node.inner, ctx)}.optional()`;
-    case "ref":
-      return node.name;
-    case "lazyRef":
-      return `z.lazy(() => ${node.name})`;
-    case "annotated": {
-      const comments = node.unmappable.map((n) => `/* @${n}: not translatable to zod (server-only) */`).join(" ");
-      return `${render(node.inner, ctx)} ${comments}`;
-    }
-  }
-}
-var zodAdapter = {
-  name: "zod",
-  importStatements(usage) {
-    return usage.used ? ["import { z } from 'zod';"] : [];
-  },
-  render,
-  inferType(schemaConst) {
-    return `z.infer<typeof ${schemaConst}>`;
-  },
-  renderModule(mod) {
-    const ctx = { named: mod.named };
-    const namedNestedSchemas = /* @__PURE__ */ new Map();
-    for (const [name, node] of mod.named) {
-      namedNestedSchemas.set(name, render(node, ctx));
-    }
-    return { schemaText: render(mod.root, ctx), namedNestedSchemas, warnings: mod.warnings };
-  }
-};
-
 // src/adapters/registry.ts
 function resolveAdapter(option) {
   if (typeof option !== "string") return option;
-  if (option === "zod") return zodAdapter;
   const pkg = `@dudousxd/nestjs-codegen-${option}`;
   const named = `${option}Adapter`;
   throw new ConfigError(
@@ -167,8 +64,21 @@ If this is intentional, move the file inside your project directory.`
 function resolveConfig(userConfig, cwd) {
   return applyDefaults(userConfig, cwd ?? process.cwd());
 }
+function validateUserConfig(userConfig) {
+  if (userConfig.validation == null) {
+    throw new ConfigError(
+      "validation adapter is required \u2014 install @dudousxd/nestjs-codegen-zod and pass zodAdapter, or use @dudousxd/nestjs-codegen-valibot / -arktype"
+    );
+  }
+  if (userConfig.pages && typeof userConfig.pages.glob !== "string") {
+    throw new ConfigError(
+      "Config validation failed: `pages.glob` must be a string when `pages` is set"
+    );
+  }
+}
 function applyDefaults(userConfig, cwd) {
-  const outDir = userConfig.codegen?.outDir ? resolveAbsolute(cwd, userConfig.codegen.outDir) : join(cwd, ".nestjs-inertia");
+  validateUserConfig(userConfig);
+  const outDir = userConfig.codegen?.outDir ? resolveAbsolute(cwd, userConfig.codegen.outDir) : join(cwd, ".nestjs-codegen");
   const resolvedCwd = userConfig.codegen?.cwd ? resolveAbsolute(cwd, userConfig.codegen.cwd) : cwd;
   let app = null;
   if (userConfig.app) {
@@ -186,7 +96,8 @@ function applyDefaults(userConfig, cwd) {
   }
   return {
     extensions: userConfig.extensions ?? [],
-    validation: resolveAdapter(userConfig.validation ?? "zod"),
+    // Non-null: validateUserConfig() above throws when `validation` is absent.
+    validation: resolveAdapter(userConfig.validation),
     pages: userConfig.pages ? {
       glob: userConfig.pages.glob,
       propsExport: userConfig.pages.propsExport ?? "ComponentProps",
@@ -213,15 +124,20 @@ function applyDefaults(userConfig, cwd) {
 
 // src/watch/watcher.ts
 import { readFile as readFile3 } from "fs/promises";
-import { join as join12 } from "path";
+import { join as join13 } from "path";
 import chokidar from "chokidar";
 
 // src/discovery/contracts-fast.ts
 import { join as join2, resolve as resolve3 } from "path";
 import fg from "fast-glob";
 import {
-  Node as Node6,
-  Project,
+  Node as Node7,
+  Project
+} from "ts-morph";
+
+// src/discovery/dto-type-resolver.ts
+import {
+  Node as Node5,
   SyntaxKind as SyntaxKind2
 } from "ts-morph";
 
@@ -236,20 +152,13 @@ import { dirname, resolve as resolve2 } from "path";
 import {
   Node
 } from "ts-morph";
-var _ctx = { projectRoot: "", tsconfigPaths: null };
-function setDiscoveryContext(ctx) {
-  const prev = _ctx;
-  _ctx = ctx;
-  return prev;
-}
-function restoreDiscoveryContext(ctx) {
-  _ctx = ctx;
+var _EMPTY_CTX = { projectRoot: "", tsconfigPaths: null };
+var _ctxByProject = /* @__PURE__ */ new WeakMap();
+function setDiscoveryContext(project, ctx) {
+  _ctxByProject.set(project, ctx);
 }
-function _projectRoot() {
-  return _ctx.projectRoot;
-}
-function _tsconfigPaths() {
-  return _ctx.tsconfigPaths;
+function _ctxFor(project) {
+  return _ctxByProject.get(project) ?? _EMPTY_CTX;
 }
 var _debug = process.env.NESTJS_INERTIA_DEBUG === "1";
 function dbg(...args) {
@@ -291,7 +200,7 @@ function findTypeInFile(name, file) {
   }
   return null;
 }
-function resolveModuleSpecifier(moduleSpecifier, sourceFile, _project) {
+function resolveModuleSpecifier(moduleSpecifier, sourceFile, project) {
   if (moduleSpecifier.startsWith(".")) {
     const dir = dirname(sourceFile.getFilePath());
     const noExt = moduleSpecifier.replace(/\.(js|ts)$/, "");
@@ -301,8 +210,9 @@ function resolveModuleSpecifier(moduleSpecifier, sourceFile, _project) {
       resolve2(dir, moduleSpecifier, "index.ts")
     ];
   }
-  const baseUrl = _projectRoot();
-  const tsconfigPaths = _tsconfigPaths();
+  const ctx = _ctxFor(project);
+  const baseUrl = ctx.projectRoot;
+  const tsconfigPaths = ctx.tsconfigPaths;
   dbg(
     "resolveModuleSpecifier",
     moduleSpecifier,
@@ -448,7 +358,7 @@ function resolveTypeRef(nodeOrName, sourceFile, project, opts) {
     if (!namedImport) continue;
     const moduleSpecifier = importDecl.getModuleSpecifierValue();
     if (opts.allowBareSpecifier && !moduleSpecifier.startsWith(".") && !moduleSpecifier.startsWith("/")) {
-      const tsconfigPaths = _tsconfigPaths();
+      const tsconfigPaths = _ctxFor(project).tsconfigPaths;
       const isAlias = tsconfigPaths != null && Object.keys(tsconfigPaths).some((p) => {
         const prefix = p.replace("*", "");
         return moduleSpecifier.startsWith(prefix);
@@ -517,10 +427,7 @@ function extractSchemaFromDto(classDecl, sourceFile, project) {
     depth: 0
   };
   const root = buildObject(classDecl, sourceFile, ctx);
-  for (const schemaName of ctx.recursiveSchemas) {
-    ctx.named.set(schemaName, { kind: "unknown", note: "recursive type \u2014 not expanded" });
-  }
-  return { root, named: ctx.named, warnings: ctx.warnings };
+  return { root, named: ctx.named, warnings: ctx.warnings, recursive: ctx.recursiveSchemas };
 }
 function buildObject(classDecl, classFile, ctx) {
   const props = classDecl.getProperties();
@@ -540,7 +447,7 @@ function buildProperty(prop, classFile, ctx) {
   const dec = (n) => decorators.get(n);
   const typeNode = prop.getTypeNode();
   const typeText = typeNode?.getText() ?? "unknown";
-  const isArrayType = !!typeNode && typeNode.getText().endsWith("[]");
+  const isArrayType = !!typeNode && Node2.isArrayTypeNode(typeNode);
   const typeRefName = resolveTypeFactoryName(dec("Type"));
   if (has("ValidateNested") || typeRefName) {
     const childName = typeRefName ?? singularClassName(typeText);
@@ -671,18 +578,27 @@ function baseFromType(typeText, isArrayType) {
   }
 }
 function buildNestedReference(className, fromFile, ctx) {
-  if (ctx.visiting.has(className) || ctx.depth >= 8) {
+  if (ctx.visiting.has(className)) {
     const reserved = ctx.emittedClasses.get(className) ?? aliasFor(className, ctx);
     ctx.emittedClasses.set(className, reserved);
     ctx.recursiveSchemas.add(reserved);
     if (!ctx.warnedDecorators.has(`recursive:${reserved}`)) {
       ctx.warnedDecorators.add(`recursive:${reserved}`);
-      const msg = `${className} is a recursive type and was not expanded; the generated schema uses unknown for it.`;
+      const msg = `${className} is a recursive type; the generated schema validates it via a lazy self-reference.`;
       ctx.warnings.push(msg);
       console.warn(`[nestjs-codegen] ${msg}`);
     }
     return { kind: "lazyRef", name: reserved };
   }
+  if (ctx.depth >= 8) {
+    if (!ctx.warnedDecorators.has(`deep:${className}`)) {
+      ctx.warnedDecorators.add(`deep:${className}`);
+      const msg = `${className} nesting is too deep to expand; the generated schema uses unknown for it.`;
+      ctx.warnings.push(msg);
+      console.warn(`[nestjs-codegen] ${msg}`);
+    }
+    return { kind: "unknown", note: "nesting too deep \u2014 not expanded" };
+  }
   const existing = ctx.emittedClasses.get(className);
   if (existing) return { kind: "ref", name: existing };
   const schemaName = aliasFor(className, ctx);
@@ -801,344 +717,14 @@ function inSchemaFromDecorator(decorator) {
   return null;
 }
 
-// src/discovery/dto-to-zod.ts
-import {
-  Node as Node3
-} from "ts-morph";
-var KNOWN_DECORATORS2 = /* @__PURE__ */ new Set([
-  "IsString",
-  "IsNumber",
-  "IsInt",
-  "IsBoolean",
-  "IsDate",
-  "IsEmail",
-  "IsUrl",
-  "IsUUID",
-  "MinLength",
-  "MaxLength",
-  "Length",
-  "Min",
-  "Max",
-  "IsPositive",
-  "IsNegative",
-  "Matches",
-  "IsEnum",
-  "IsIn",
-  "IsOptional",
-  "IsNotEmpty",
-  "IsArray",
-  "ValidateNested",
-  "Type",
-  "IsObject",
-  "Allow",
-  "IsDefined"
-]);
-function extractZodFromDto(classDecl, sourceFile, project) {
-  const ctx = {
-    sourceFile,
-    project,
-    namedNestedSchemas: /* @__PURE__ */ new Map(),
-    warnings: [],
-    warnedDecorators: /* @__PURE__ */ new Set(),
-    emittedClasses: /* @__PURE__ */ new Map(),
-    visiting: /* @__PURE__ */ new Set(),
-    recursiveSchemas: /* @__PURE__ */ new Set(),
-    depth: 0
-  };
-  const schemaText = buildObjectSchema(classDecl, sourceFile, ctx);
-  for (const schemaName of ctx.recursiveSchemas) {
-    ctx.namedNestedSchemas.set(schemaName, "z.unknown() /* recursive type \u2014 not expanded */");
-  }
-  return {
-    schemaText,
-    namedNestedSchemas: ctx.namedNestedSchemas,
-    warnings: ctx.warnings
-  };
-}
-function buildObjectSchema(classDecl, classFile, ctx) {
-  const props = classDecl.getProperties();
-  if (props.length === 0) {
-    return "z.object({}).passthrough()";
-  }
-  const fields = [];
-  for (const prop of props) {
-    const name = prop.getName();
-    const expr = buildPropertySchema(prop, classFile, ctx);
-    fields.push(`${toObjectKey2(name)}: ${expr}`);
-  }
-  return `z.object({ ${fields.join(", ")} })`;
-}
-function toObjectKey2(name) {
-  return /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(name) ? name : JSON.stringify(name);
-}
-function buildPropertySchema(prop, classFile, ctx) {
-  const decorators = /* @__PURE__ */ new Map();
-  for (const d of prop.getDecorators()) decorators.set(d.getName(), d);
-  const has = (n) => decorators.has(n);
-  const dec = (n) => decorators.get(n);
-  const typeNode = prop.getTypeNode();
-  const typeText = typeNode?.getText() ?? "unknown";
-  const isArrayType = !!typeNode && typeNode.getText().endsWith("[]");
-  const comments = [];
-  const typeRefName = resolveTypeFactoryName2(dec("Type"));
-  if (has("ValidateNested") || typeRefName) {
-    const childName = typeRefName ?? singularClassName2(typeText);
-    if (childName) {
-      const childExpr = buildNestedReference2(childName, classFile, ctx);
-      const wrapArray = has("IsArray") || isArrayType;
-      let expr2 = wrapArray ? `z.array(${childExpr})` : childExpr;
-      expr2 = applyPresence2(expr2, decorators);
-      return expr2;
-    }
-  }
-  let base = baseFromType2(typeText, isArrayType, ctx, classFile);
-  const refinements = [];
-  if (has("IsString")) base = "z.string()";
-  if (has("IsBoolean")) base = "z.boolean()";
-  if (has("IsDate")) base = "z.coerce.date()";
-  if (has("IsNumber")) base = "z.number()";
-  if (has("IsInt")) base = "z.number().int()";
-  if (has("IsObject") && !has("ValidateNested")) base = "z.object({}).passthrough()";
-  if (has("Allow")) base = "z.unknown()";
-  if (has("IsEmail")) {
-    base = ensureStringBase(base);
-    refinements.push(`.email(${messageArg(dec("IsEmail"))})`);
-  }
-  if (has("IsUrl")) {
-    base = ensureStringBase(base);
-    refinements.push(`.url(${messageArg(dec("IsUrl"))})`);
-  }
-  if (has("IsUUID")) {
-    base = ensureStringBase(base);
-    refinements.push(`.uuid(${messageArg(dec("IsUUID"))})`);
-  }
-  if (has("Matches")) {
-    const re = firstArgText2(dec("Matches"));
-    if (re) {
-      base = ensureStringBase(base);
-      refinements.push(`.regex(${re})`);
-    }
-  }
-  if (has("MinLength")) {
-    const n = numericArg2(dec("MinLength"));
-    if (n !== null) refinements.push(`.min(${n})`);
-  }
-  if (has("MaxLength")) {
-    const n = numericArg2(dec("MaxLength"));
-    if (n !== null) refinements.push(`.max(${n})`);
-  }
-  if (has("Length")) {
-    const [min, max] = numericArgs2(dec("Length"));
-    if (min !== null) refinements.push(`.min(${min})`);
-    if (max !== null) refinements.push(`.max(${max})`);
-  }
-  if (has("Min")) {
-    const n = numericArg2(dec("Min"));
-    if (n !== null) refinements.push(`.min(${n})`);
-  }
-  if (has("Max")) {
-    const n = numericArg2(dec("Max"));
-    if (n !== null) refinements.push(`.max(${n})`);
-  }
-  if (has("IsPositive")) refinements.push(".positive()");
-  if (has("IsNegative")) refinements.push(".negative()");
-  if (has("IsNotEmpty") && isStringBase(base)) refinements.push(".min(1)");
-  if (has("IsEnum")) {
-    const enumExpr = enumSchemaFromDecorator2(dec("IsEnum"), classFile, ctx);
-    if (enumExpr) base = enumExpr;
-  }
-  if (has("IsIn")) {
-    const inExpr = inSchemaFromDecorator2(dec("IsIn"));
-    if (inExpr) base = inExpr;
-  }
-  for (const name of decorators.keys()) {
-    if (!KNOWN_DECORATORS2.has(name)) {
-      comments.push(`/* @${name}: not translatable to zod (server-only) */`);
-      if (!ctx.warnedDecorators.has(name)) {
-        ctx.warnedDecorators.add(name);
-        const msg = `@${name} is not translatable to zod and was skipped (server-only validation).`;
-        ctx.warnings.push(msg);
-        console.warn(`[nestjs-codegen/forms] ${msg}`);
-      }
-    }
-  }
-  let expr = base + refinements.join("");
-  if (isArrayType && !expr.startsWith("z.array(")) {
-    expr = `z.array(${expr})`;
-  }
-  expr = applyPresence2(expr, decorators);
-  if (comments.length > 0) {
-    expr = `${expr} ${comments.join(" ")}`;
-  }
-  return expr;
-}
-function applyPresence2(expr, decorators) {
-  if (decorators.has("IsDefined")) return expr;
-  if (decorators.has("IsOptional")) return `${expr}.optional()`;
-  return expr;
-}
-function baseFromType2(typeText, isArrayType, ctx, classFile) {
-  const inner = isArrayType ? typeText.slice(0, -2).trim() : typeText;
-  switch (inner) {
-    case "string":
-      return "z.string()";
-    case "number":
-      return "z.number()";
-    case "boolean":
-      return "z.boolean()";
-    case "Date":
-      return "z.coerce.date()";
-    case "File":
-    case "Express.Multer.File":
-      return "z.instanceof(File)";
-    default:
-      return "z.unknown()";
-  }
-}
-function ensureStringBase(base) {
-  return isStringBase(base) ? base : "z.string()";
-}
-function isStringBase(base) {
-  return base.startsWith("z.string(");
-}
-function buildNestedReference2(className, fromFile, ctx) {
-  if (ctx.visiting.has(className) || ctx.depth >= 8) {
-    const reserved = ctx.emittedClasses.get(className) ?? aliasFor2(className, ctx);
-    ctx.emittedClasses.set(className, reserved);
-    ctx.recursiveSchemas.add(reserved);
-    if (!ctx.warnedDecorators.has(`recursive:${reserved}`)) {
-      ctx.warnedDecorators.add(`recursive:${reserved}`);
-      const msg = `${className} is a recursive type and was not expanded; the generated form schema uses z.unknown() for it.`;
-      ctx.warnings.push(msg);
-      console.warn(`[nestjs-codegen/forms] ${msg}`);
-    }
-    return `z.lazy(() => ${reserved})`;
-  }
-  const existing = ctx.emittedClasses.get(className);
-  if (existing) return existing;
-  const schemaName = aliasFor2(className, ctx);
-  const resolved = findType(className, fromFile, ctx.project);
-  if (!resolved || resolved.kind !== "class") {
-    return "z.object({}).passthrough()";
-  }
-  ctx.emittedClasses.set(className, schemaName);
-  ctx.visiting.add(className);
-  ctx.depth += 1;
-  const childText = buildObjectSchema(resolved.decl, resolved.file, ctx);
-  ctx.depth -= 1;
-  ctx.visiting.delete(className);
-  ctx.namedNestedSchemas.set(schemaName, childText);
-  return schemaName;
-}
-function aliasFor2(className, ctx) {
-  const baseName = `${className}Schema`;
-  let candidate = baseName;
-  let i = 1;
-  const used = new Set(ctx.namedNestedSchemas.keys());
-  for (const v of ctx.emittedClasses.values()) used.add(v);
-  while (used.has(candidate)) {
-    candidate = `${baseName}_${i}`;
-    i += 1;
-  }
-  return candidate;
-}
-function firstArg2(decorator) {
-  return decorator?.getArguments()[0];
-}
-function firstArgText2(decorator) {
-  const arg = firstArg2(decorator);
-  return arg ? arg.getText() : null;
-}
-function numericArg2(decorator) {
-  const arg = firstArg2(decorator);
-  if (arg && Node3.isNumericLiteral(arg)) return arg.getText();
-  return null;
-}
-function numericArgs2(decorator) {
-  const args = decorator?.getArguments() ?? [];
-  const num = (n) => n && Node3.isNumericLiteral(n) ? n.getText() : null;
-  return [num(args[0]), num(args[1])];
-}
-function messageArg(decorator) {
-  const args = decorator?.getArguments() ?? [];
-  for (const arg of args) {
-    if (Node3.isObjectLiteralExpression(arg)) {
-      for (const prop of arg.getProperties()) {
-        if (Node3.isPropertyAssignment(prop) && prop.getName() === "message") {
-          const init = prop.getInitializer();
-          if (init && Node3.isStringLiteral(init)) {
-            return `{ message: ${init.getText()} }`;
-          }
-        }
-      }
-    }
-  }
-  return "";
-}
-function resolveTypeFactoryName2(decorator) {
-  const arg = firstArg2(decorator);
-  if (!arg) return null;
-  if (Node3.isArrowFunction(arg)) {
-    const body = arg.getBody();
-    if (Node3.isIdentifier(body)) return body.getText();
-  }
-  return null;
-}
-function singularClassName2(typeText) {
-  const inner = typeText.endsWith("[]") ? typeText.slice(0, -2).trim() : typeText;
-  return /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(inner) ? inner : null;
-}
-function enumSchemaFromDecorator2(decorator, classFile, ctx) {
-  const arg = firstArg2(decorator);
-  if (!arg) return null;
-  if (Node3.isIdentifier(arg)) {
-    const name = arg.getText();
-    const resolved = findType(name, classFile, ctx.project);
-    if (resolved && resolved.kind === "enum") {
-      return `z.enum([${resolved.members.join(", ")}])`;
-    }
-    const msg = `@IsEnum(${name}): enum could not be resolved to literal members and is not importable into the generated form schema; falling back to z.unknown().`;
-    if (!ctx.warnedDecorators.has(`IsEnum:${name}`)) {
-      ctx.warnedDecorators.add(`IsEnum:${name}`);
-      ctx.warnings.push(msg);
-      console.warn(`[nestjs-codegen/forms] ${msg}`);
-    }
-    return `z.unknown() /* @IsEnum(${name}): enum not resolvable to literals */`;
-  }
-  if (Node3.isObjectLiteralExpression(arg)) {
-    const values = [];
-    for (const p of arg.getProperties()) {
-      if (!Node3.isPropertyAssignment(p)) continue;
-      const init = p.getInitializer();
-      if (init && Node3.isStringLiteral(init)) values.push(init.getText());
-    }
-    if (values.length > 0) return `z.enum([${values.join(", ")}])`;
-  }
-  return null;
-}
-function inSchemaFromDecorator2(decorator) {
-  const arg = firstArg2(decorator);
-  if (arg && Node3.isArrayLiteralExpression(arg)) {
-    const elements = arg.getElements();
-    const allStrings = elements.every((e) => Node3.isStringLiteral(e));
-    if (allStrings && elements.length > 0) {
-      return `z.enum([${elements.map((e) => e.getText()).join(", ")}])`;
-    }
-    if (elements.length > 0) {
-      return `z.union([${elements.map((e) => `z.literal(${e.getText()})`).join(", ")}])`;
-    }
-  }
-  return null;
-}
-
 // src/discovery/filter-for.ts
 import {
-  Node as Node5
+  Node as Node4
 } from "ts-morph";
 
 // src/discovery/filter-field-types.ts
 import {
-  Node as Node4,
+  Node as Node3,
   SyntaxKind
 } from "ts-morph";
 
@@ -1175,7 +761,7 @@ function markNullable(r, nullable) {
   return nullable ? { ...r, nullable: true } : r;
 }
 function classifyTypeNode(typeNode, sourceFile, project, opts) {
-  if (Node4.isUnionTypeNode(typeNode)) {
+  if (Node3.isUnionTypeNode(typeNode)) {
     let nullable = false;
     const stringLits = [];
     const numberLits = [];
@@ -1186,13 +772,13 @@ function classifyTypeNode(typeNode, sourceFile, project, opts) {
         nullable = true;
         continue;
       }
-      if (Node4.isLiteralTypeNode(member)) {
+      if (Node3.isLiteralTypeNode(member)) {
         const lit = member.getLiteral();
-        if (Node4.isStringLiteral(lit)) {
+        if (Node3.isStringLiteral(lit)) {
           stringLits.push(lit.getLiteralValue());
           continue;
         }
-        if (Node4.isNumericLiteral(lit)) {
+        if (Node3.isNumericLiteral(lit)) {
           numberLits.push(lit.getText());
           continue;
         }
@@ -1228,7 +814,7 @@ function classifyTypeNode(typeNode, sourceFile, project, opts) {
     default:
       break;
   }
-  if (Node4.isTypeReference(typeNode)) {
+  if (Node3.isTypeReference(typeNode)) {
     const refName = typeNode.getTypeName().getText();
     if (refName === "Date") return { kind: "date" };
     if (refName === "Record" || refName === "Object") return { kind: "json" };
@@ -1241,25 +827,25 @@ function classifyTypeNode(typeNode, sourceFile, project, opts) {
     if (typeRef) return { kind: "unknown", typeRef };
     return { kind: "unknown" };
   }
-  if (Node4.isTypeLiteral(typeNode)) return { kind: "json" };
+  if (Node3.isTypeLiteral(typeNode)) return { kind: "json" };
   return { kind: "unknown" };
 }
 function enumFromDecoratorArgs(args, sourceFile, project) {
   for (const arg of args) {
-    if (Node4.isArrowFunction(arg)) {
+    if (Node3.isArrowFunction(arg)) {
       const body = arg.getBody();
-      if (Node4.isIdentifier(body)) {
+      if (Node3.isIdentifier(body)) {
         const en = resolveEnumValues(body.getText(), sourceFile, project);
         if (en) return en;
       }
     }
-    if (Node4.isObjectLiteralExpression(arg)) {
+    if (Node3.isObjectLiteralExpression(arg)) {
       const itemsProp = arg.getProperty("items");
-      if (itemsProp && Node4.isPropertyAssignment(itemsProp)) {
+      if (itemsProp && Node3.isPropertyAssignment(itemsProp)) {
         const init = itemsProp.getInitializer();
-        if (init && Node4.isArrowFunction(init)) {
+        if (init && Node3.isArrowFunction(init)) {
           const body = init.getBody();
-          if (Node4.isIdentifier(body)) {
+          if (Node3.isIdentifier(body)) {
             const en = resolveEnumValues(body.getText(), sourceFile, project);
             if (en) return en;
           }
@@ -1282,7 +868,7 @@ function classifyFromColumnDecorator(prop, sourceFile, project) {
       return { kind: "string" };
     }
     for (const arg of args) {
-      if (Node4.isStringLiteral(arg)) {
+      if (Node3.isStringLiteral(arg)) {
         const raw = arg.getLiteralValue();
         const kind = classifyTypeKeyword(raw);
         if (kind) {
@@ -1290,11 +876,11 @@ function classifyFromColumnDecorator(prop, sourceFile, project) {
           return { kind };
         }
       }
-      if (Node4.isObjectLiteralExpression(arg)) {
+      if (Node3.isObjectLiteralExpression(arg)) {
         const enumProp = arg.getProperty("enum");
-        if (enumProp && Node4.isPropertyAssignment(enumProp)) {
+        if (enumProp && Node3.isPropertyAssignment(enumProp)) {
           const init = enumProp.getInitializer();
-          if (init && Node4.isIdentifier(init)) {
+          if (init && Node3.isIdentifier(init)) {
             const en = resolveEnumValues(init.getText(), sourceFile, project);
             if (en) {
               return en.numeric ? { kind: "number", enumValues: en.values, numericEnum: true } : { kind: "string", enumValues: en.values };
@@ -1303,9 +889,9 @@ function classifyFromColumnDecorator(prop, sourceFile, project) {
           }
         }
         const typeProp = arg.getProperty("type");
-        if (typeProp && Node4.isPropertyAssignment(typeProp)) {
+        if (typeProp && Node3.isPropertyAssignment(typeProp)) {
           const init = typeProp.getInitializer();
-          if (init && Node4.isStringLiteral(init)) {
+          if (init && Node3.isStringLiteral(init)) {
             const kind = classifyTypeKeyword(init.getLiteralValue());
             if (kind) return { kind };
           }
@@ -1341,7 +927,7 @@ function toFilterFieldType(name, r) {
 
 // src/discovery/filter-for.ts
 function classifyFilterForHint(typeInit) {
-  if (Node5.isStringLiteral(typeInit)) {
+  if (Node4.isStringLiteral(typeInit)) {
     switch (typeInit.getLiteralValue()) {
       case "string":
         return { kind: "string" };
@@ -1355,10 +941,10 @@ function classifyFilterForHint(typeInit) {
         return null;
     }
   }
-  if (Node5.isArrayLiteralExpression(typeInit)) {
+  if (Node4.isArrayLiteralExpression(typeInit)) {
     const values = [];
     for (const el of typeInit.getElements()) {
-      if (!Node5.isStringLiteral(el)) return null;
+      if (!Node4.isStringLiteral(el)) return null;
       values.push(el.getLiteralValue());
     }
     if (values.length === 0) return null;
@@ -1393,11 +979,11 @@ function extractFilterForHints(classDecl, project) {
     if (!filterForDec) continue;
     const args = filterForDec.getArguments();
     const keyArg = args[0];
-    const inputKey = keyArg && Node5.isStringLiteral(keyArg) ? keyArg.getLiteralValue() : method.getName();
+    const inputKey = keyArg && Node4.isStringLiteral(keyArg) ? keyArg.getLiteralValue() : method.getName();
     const optsArg = args[1];
-    if (optsArg && Node5.isObjectLiteralExpression(optsArg)) {
+    if (optsArg && Node4.isObjectLiteralExpression(optsArg)) {
       const typeProp = optsArg.getProperty("type");
-      if (typeProp && Node5.isPropertyAssignment(typeProp)) {
+      if (typeProp && Node4.isPropertyAssignment(typeProp)) {
         const typeInit = typeProp.getInitializer();
         if (typeInit) {
           const classified = classifyFilterForHint(typeInit);
@@ -1420,14 +1006,14 @@ function extractApplyFilterInfo(method, sourceFile, project) {
     const args = filterDecorator.getArguments();
     if (args.length === 0) continue;
     const filterClassArg = args[0];
-    if (!filterClassArg || !Node5.isIdentifier(filterClassArg)) continue;
+    if (!filterClassArg || !Node4.isIdentifier(filterClassArg)) continue;
     let source = "query";
     const optionsArg = args[1];
-    if (optionsArg && Node5.isObjectLiteralExpression(optionsArg)) {
+    if (optionsArg && Node4.isObjectLiteralExpression(optionsArg)) {
       const sourceProp = optionsArg.getProperty("source");
-      if (sourceProp && Node5.isPropertyAssignment(sourceProp)) {
+      if (sourceProp && Node4.isPropertyAssignment(sourceProp)) {
         const init = sourceProp.getInitializer();
-        if (init && Node5.isStringLiteral(init) && init.getLiteralValue() === "body") {
+        if (init && Node4.isStringLiteral(init) && init.getLiteralValue() === "body") {
           source = "body";
         }
       }
@@ -1490,22 +1076,22 @@ function resolveRelationEntity(prop, sourceFile, project) {
     const args = dec.getArguments();
     if (args.length === 0) continue;
     const arg = args[0];
-    if (Node5.isObjectLiteralExpression(arg)) {
+    if (Node4.isObjectLiteralExpression(arg)) {
       const entityProp = arg.getProperty("entity");
-      if (entityProp && Node5.isPropertyAssignment(entityProp)) {
+      if (entityProp && Node4.isPropertyAssignment(entityProp)) {
         const init = entityProp.getInitializer();
-        if (init && Node5.isArrowFunction(init)) {
+        if (init && Node4.isArrowFunction(init)) {
           const body = init.getBody();
-          if (Node5.isIdentifier(body)) {
+          if (Node4.isIdentifier(body)) {
             const resolved = findType(body.getText(), prop.getSourceFile(), project);
             if (resolved?.kind === "class") return resolved.decl;
           }
         }
       }
     }
-    if (Node5.isArrowFunction(arg)) {
+    if (Node4.isArrowFunction(arg)) {
       const body = arg.getBody();
-      if (Node5.isIdentifier(body)) {
+      if (Node4.isIdentifier(body)) {
         const resolved = findType(body.getText(), prop.getSourceFile(), project);
         if (resolved?.kind === "class") return resolved.decl;
       }
@@ -1529,11 +1115,11 @@ function extractFilterableEntityFields(filterClass, project) {
   const args = filterableDecorator.getArguments();
   if (args.length === 0) return [];
   const optionsArg = args[0];
-  if (!Node5.isObjectLiteralExpression(optionsArg)) return [];
+  if (!Node4.isObjectLiteralExpression(optionsArg)) return [];
   const entityProp = optionsArg.getProperty("entity");
-  if (!entityProp || !Node5.isPropertyAssignment(entityProp)) return [];
+  if (!entityProp || !Node4.isPropertyAssignment(entityProp)) return [];
   const entityInit = entityProp.getInitializer();
-  if (!entityInit || !Node5.isIdentifier(entityInit)) return [];
+  if (!entityInit || !Node4.isIdentifier(entityInit)) return [];
   const entityName = entityInit.getText();
   const filterSourceFile = filterClass.getSourceFile();
   const resolvedEntity = findType(entityName, filterSourceFile, project);
@@ -1549,17 +1135,17 @@ function extractFilterableEntityFields(filterClass, project) {
   const relationsDecorator = filterClass.getDecorators().find((d) => d.getName() === "Relations");
   if (relationsDecorator) {
     const relArgs = relationsDecorator.getArguments();
-    if (relArgs.length > 0 && Node5.isObjectLiteralExpression(relArgs[0])) {
+    if (relArgs.length > 0 && Node4.isObjectLiteralExpression(relArgs[0])) {
       for (const relProp of relArgs[0].getProperties()) {
-        if (!Node5.isPropertyAssignment(relProp)) continue;
+        if (!Node4.isPropertyAssignment(relProp)) continue;
         const relInit = relProp.getInitializer();
-        if (!relInit || !Node5.isObjectLiteralExpression(relInit)) continue;
+        if (!relInit || !Node4.isObjectLiteralExpression(relInit)) continue;
         const keysProp = relInit.getProperty("keys");
-        if (!keysProp || !Node5.isPropertyAssignment(keysProp)) continue;
+        if (!keysProp || !Node4.isPropertyAssignment(keysProp)) continue;
         const keysInit = keysProp.getInitializer();
-        if (!keysInit || !Node5.isArrayLiteralExpression(keysInit)) continue;
+        if (!keysInit || !Node4.isArrayLiteralExpression(keysInit)) continue;
         for (const el of keysInit.getElements()) {
-          if (Node5.isStringLiteral(el)) {
+          if (Node4.isStringLiteral(el)) {
             fields.push(toFilterFieldType(el.getLiteralValue(), { kind: "unknown" }));
           }
         }
@@ -1569,267 +1155,65 @@ function extractFilterableEntityFields(filterClass, project) {
   return fields;
 }
 
-// src/discovery/contracts-fast.ts
-async function discoverContractsFast(opts) {
-  const { cwd, glob, tsconfig } = opts;
-  const tsconfigPath = tsconfig ? resolve3(tsconfig) : join2(cwd, "tsconfig.json");
-  let project;
-  try {
-    project = new Project({
-      tsConfigFilePath: tsconfigPath,
-      skipAddingFilesFromTsConfig: true,
-      skipLoadingLibFiles: true,
-      skipFileDependencyResolution: true
-    });
-  } catch {
-    project = new Project({
-      skipAddingFilesFromTsConfig: true,
-      skipLoadingLibFiles: true,
-      skipFileDependencyResolution: true,
-      compilerOptions: {
-        allowJs: true,
-        resolveJsonModule: false,
-        strict: false
-      }
-    });
-  }
-  const files = await fg(glob, { cwd, absolute: true, onlyFiles: true });
-  for (const f of files) {
-    project.addSourceFileAtPath(f);
-  }
-  const routes = [];
-  const prevCtx = setDiscoveryContext({
-    projectRoot: cwd,
-    tsconfigPaths: loadTsconfigPaths(tsconfigPath)
-  });
-  try {
-    for (const sourceFile of project.getSourceFiles()) {
-      routes.push(...extractFromSourceFile(sourceFile, project));
-    }
-  } finally {
-    restoreDiscoveryContext(prevCtx);
-  }
-  return routes;
-}
-function zodAstToTs(node) {
-  if (!Node6.isCallExpression(node)) return "unknown";
-  const expr = node.getExpression();
-  if (Node6.isPropertyAccessExpression(expr)) {
-    const methodName = expr.getName();
-    const receiver = expr.getExpression();
-    if (methodName === "optional") {
-      return `${zodAstToTs(receiver)} | undefined`;
-    }
-    if (methodName === "nullable") {
-      return `${zodAstToTs(receiver)} | null`;
-    }
-    const args = node.getArguments();
-    switch (methodName) {
-      case "string":
-        return "string";
-      case "number":
-        return "number";
-      case "boolean":
-        return "boolean";
-      case "unknown":
-        return "unknown";
-      case "any":
-        return "unknown";
-      case "literal": {
-        const lit = args[0];
-        if (!lit) return "unknown";
-        if (Node6.isStringLiteral(lit)) return JSON.stringify(lit.getLiteralValue());
-        if (Node6.isNumericLiteral(lit)) return lit.getLiteralValue().toString();
-        if (lit.getKind() === SyntaxKind2.TrueKeyword) return "true";
-        if (lit.getKind() === SyntaxKind2.FalseKeyword) return "false";
-        return "unknown";
-      }
-      case "enum": {
-        const arrArg = args[0];
-        if (!arrArg || !Node6.isArrayLiteralExpression(arrArg)) return "unknown";
-        const members = arrArg.getElements().map(
-          (el) => Node6.isStringLiteral(el) ? JSON.stringify(el.getLiteralValue()) : "unknown"
-        );
-        return members.join(" | ");
-      }
-      case "array": {
-        const inner = args[0];
-        if (!inner) return "unknown";
-        return `Array<${zodAstToTs(inner)}>`;
-      }
-      case "object": {
-        const objArg = args[0];
-        if (!objArg || !Node6.isObjectLiteralExpression(objArg)) return "unknown";
-        const lines = [];
-        for (const prop of objArg.getProperties()) {
-          if (!Node6.isPropertyAssignment(prop)) continue;
-          const key = prop.getName();
-          const valNode = prop.getInitializer();
-          if (!valNode) continue;
-          const tsType = zodAstToTs(valNode);
-          const isOpt = isOptionalChain(valNode);
-          lines.push(`${key}${isOpt ? "?" : ""}: ${tsType}`);
-        }
-        return `{ ${lines.join("; ")} }`;
-      }
-      case "union": {
-        const arrArg = args[0];
-        if (!arrArg || !Node6.isArrayLiteralExpression(arrArg)) return "unknown";
-        return arrArg.getElements().map(zodAstToTs).join(" | ");
-      }
-      case "record": {
-        const valArg = args.length === 1 ? args[0] : args[1];
-        if (!valArg) return "unknown";
-        return `Record<string, ${zodAstToTs(valArg)}>`;
-      }
-      case "tuple": {
-        const arrArg = args[0];
-        if (!arrArg || !Node6.isArrayLiteralExpression(arrArg)) return "unknown";
-        return `[${arrArg.getElements().map(zodAstToTs).join(", ")}]`;
-      }
-      default:
-        return "unknown";
-    }
-  }
-  return "unknown";
-}
-function isOptionalChain(node) {
-  if (!Node6.isCallExpression(node)) return false;
-  const expr = node.getExpression();
-  return Node6.isPropertyAccessExpression(expr) && expr.getName() === "optional";
-}
-function decoratorStringArg(decoratorExpr) {
-  if (!decoratorExpr) return void 0;
-  if (Node6.isStringLiteral(decoratorExpr)) return decoratorExpr.getLiteralValue();
-  if (Node6.isArrayLiteralExpression(decoratorExpr)) {
-    const first = decoratorExpr.getElements()[0];
-    if (first && Node6.isStringLiteral(first)) return first.getLiteralValue();
-  }
-  return void 0;
-}
-function parseDefineContractCall(callExpr) {
-  if (!Node6.isCallExpression(callExpr)) return null;
-  const callee = callExpr.getExpression();
-  const calleeName = Node6.isIdentifier(callee) ? callee.getText() : Node6.isPropertyAccessExpression(callee) ? callee.getName() : "";
-  if (calleeName !== "defineContract") return null;
-  const args = callExpr.getArguments();
-  const optsArg = args[0];
-  if (!optsArg || !Node6.isObjectLiteralExpression(optsArg)) return null;
-  let query = null;
-  let body = null;
-  let response = "unknown";
-  let bodyZodText = null;
-  let queryZodText = null;
-  for (const prop of optsArg.getProperties()) {
-    if (!Node6.isPropertyAssignment(prop)) continue;
-    const propName = prop.getName();
-    const val = prop.getInitializer();
-    if (!val) continue;
-    if (propName === "query") {
-      query = zodAstToTs(val);
-      queryZodText = val.getText();
-    } else if (propName === "body") {
-      body = zodAstToTs(val);
-      bodyZodText = val.getText();
-    } else if (propName === "response") {
-      response = zodAstToTs(val);
-    }
-  }
-  return { query, body, response, bodyZodText, queryZodText };
-}
-function deriveClassSegment(className) {
-  const noSuffix = className.replace(/Controller$/, "");
-  if (!noSuffix) {
-    throw new Error(
-      `Controller class name "${className}" derives empty route segment after stripping "Controller". Add an @As(...) override at the class level.`
-    );
-  }
-  return noSuffix.charAt(0).toLowerCase() + noSuffix.slice(1);
-}
-function resolveRouteName(className, methodName, classAs, methodAs) {
-  const classPortion = classAs ?? deriveClassSegment(className);
-  const methodPortion = methodAs ?? methodName;
-  return `${classPortion}.${methodPortion}`;
-}
-function joinPaths(prefix, suffix) {
-  if (!prefix && !suffix) return "/";
-  if (!prefix) return suffix.startsWith("/") ? suffix : `/${suffix}`;
-  if (!suffix) return prefix.startsWith("/") ? prefix : `/${prefix}`;
-  const p = prefix.endsWith("/") ? prefix.slice(0, -1) : prefix;
-  const s = suffix.startsWith("/") ? suffix : `/${suffix}`;
-  const combined = p + s;
-  return combined === "" ? "/" : combined;
-}
-function extractParams(path) {
-  const matches = path.matchAll(/:(\w+)/g);
-  return Array.from(matches).map((m) => ({ name: m[1], source: "path" }));
-}
+// src/discovery/dto-type-resolver.ts
+var WRAPPER_TYPES = {
+  // MikroORM Ref/Reference/LoadedReference/IdentifiedReference are server-side
+  // wrappers around related entities; the wire shape is just the referenced
+  // entity. Unwrap to the type argument.
+  Ref: "unwrap",
+  Reference: "unwrap",
+  LoadedReference: "unwrap",
+  IdentifiedReference: "unwrap",
+  // MikroORM Opt<T> is a marker, Loaded<T, ...> is a wrapper; both reduce to T.
+  Opt: "unwrap",
+  Loaded: "unwrap",
+  // Promise<T> — unwrap
+  Promise: "unwrap",
+  // MikroORM Collection<T> serializes as an array of T on the wire.
+  Collection: "arrayOf",
+  // Array<T> generic form
+  Array: "arrayOf"
+};
+var PASSTHROUGH_UTILITY = /* @__PURE__ */ new Set([
+  "Record",
+  "Omit",
+  "Pick",
+  "Partial",
+  "Required",
+  "Readonly",
+  "Map",
+  "Set"
+]);
 function resolveTypeNodeToString(typeNode, sourceFile, project, depth) {
   if (depth <= 0) return "unknown";
-  if (Node6.isArrayTypeNode(typeNode)) {
+  if (Node5.isArrayTypeNode(typeNode)) {
     const elementType = typeNode.getElementTypeNode();
     return `Array<${resolveTypeNodeToString(elementType, sourceFile, project, depth)}>`;
   }
-  if (Node6.isUnionTypeNode(typeNode)) {
+  if (Node5.isUnionTypeNode(typeNode)) {
     return typeNode.getTypeNodes().map((t) => resolveTypeNodeToString(t, sourceFile, project, depth)).join(" | ");
   }
-  if (Node6.isIntersectionTypeNode(typeNode)) {
+  if (Node5.isIntersectionTypeNode(typeNode)) {
     return typeNode.getTypeNodes().map((t) => resolveTypeNodeToString(t, sourceFile, project, depth)).join(" & ");
   }
-  if (Node6.isParenthesizedTypeNode(typeNode)) {
+  if (Node5.isParenthesizedTypeNode(typeNode)) {
     return `(${resolveTypeNodeToString(typeNode.getTypeNode(), sourceFile, project, depth)})`;
   }
-  if (Node6.isTypeReference(typeNode)) {
+  if (Node5.isTypeReference(typeNode)) {
     const typeName = typeNode.getTypeName();
-    const name = Node6.isIdentifier(typeName) ? typeName.getText() : typeNode.getText();
+    const name = Node5.isIdentifier(typeName) ? typeName.getText() : typeNode.getText();
     if (name === "string" || name === "number" || name === "boolean") return name;
     if (name === "Date") return "string";
     if (name === "unknown" || name === "any" || name === "void") return "unknown";
     if (name === "StreamableFile" || name === "Observable" || name === "ReadableStream")
       return "unknown";
-    if (name === "Ref" || name === "Reference" || name === "LoadedReference" || name === "IdentifiedReference") {
-      const typeArgs = typeNode.getTypeArguments();
-      const firstTypeArg = typeArgs[0];
-      if (typeArgs.length > 0 && firstTypeArg !== void 0) {
-        return resolveTypeNodeToString(firstTypeArg, sourceFile, project, depth);
-      }
-      return "unknown";
-    }
-    if (name === "Collection") {
-      const typeArgs = typeNode.getTypeArguments();
-      const firstTypeArg = typeArgs[0];
-      if (typeArgs.length > 0 && firstTypeArg !== void 0) {
-        return `Array<${resolveTypeNodeToString(firstTypeArg, sourceFile, project, depth)}>`;
-      }
-      return "Array<unknown>";
-    }
-    if (name === "Opt" || name === "Loaded") {
-      const typeArgs = typeNode.getTypeArguments();
-      const firstTypeArg = typeArgs[0];
-      if (typeArgs.length > 0 && firstTypeArg !== void 0) {
-        return resolveTypeNodeToString(firstTypeArg, sourceFile, project, depth);
-      }
-      return "unknown";
+    const wrapperMode = WRAPPER_TYPES[name];
+    if (wrapperMode) {
+      return unwrapFirstTypeArg(typeNode, sourceFile, project, depth, wrapperMode);
     }
-    if (name === "Array") {
-      const typeArgs = typeNode.getTypeArguments();
-      const firstTypeArg = typeArgs[0];
-      if (typeArgs.length > 0 && firstTypeArg !== void 0) {
-        return `Array<${resolveTypeNodeToString(firstTypeArg, sourceFile, project, depth)}>`;
-      }
-      return "Array<unknown>";
-    }
-    if (["Record", "Omit", "Pick", "Partial", "Required", "Readonly", "Map", "Set"].includes(name)) {
+    if (PASSTHROUGH_UTILITY.has(name)) {
       return typeNode.getText();
     }
-    if (name === "Promise") {
-      const typeArgs = typeNode.getTypeArguments();
-      const firstTypeArg = typeArgs[0];
-      if (typeArgs.length > 0 && firstTypeArg !== void 0) {
-        return resolveTypeNodeToString(firstTypeArg, sourceFile, project, depth);
-      }
-      return "unknown";
-    }
     const resolved = findType(name, sourceFile, project);
     if (resolved) {
       return expandTypeDecl(resolved, project, depth - 1);
@@ -1845,6 +1229,15 @@ function resolveTypeNodeToString(typeNode, sourceFile, project, depth) {
   if (kind === SyntaxKind2.AnyKeyword) return "unknown";
   return typeNode.getText();
 }
+function unwrapFirstTypeArg(typeNode, sourceFile, project, depth, mode) {
+  const typeArgs = typeNode.getTypeArguments();
+  const firstTypeArg = typeArgs[0];
+  if (typeArgs.length > 0 && firstTypeArg !== void 0) {
+    const inner = resolveTypeNodeToString(firstTypeArg, sourceFile, project, depth);
+    return mode === "arrayOf" ? `Array<${inner}>` : inner;
+  }
+  return mode === "arrayOf" ? "Array<unknown>" : "unknown";
+}
 function expandTypeDecl(result, project, depth) {
   if (depth < 0) return "unknown";
   switch (result.kind) {
@@ -1910,7 +1303,7 @@ function extractParamsType(method, sourceFile, project) {
     const paramArgs = paramDecorator.getArguments();
     if (paramArgs.length === 0) continue;
     const nameArg = paramArgs[0];
-    if (!Node6.isStringLiteral(nameArg)) continue;
+    if (!Node5.isStringLiteral(nameArg)) continue;
     const paramName = nameArg.getLiteralValue();
     const typeNode = param.getTypeNode();
     const paramType = typeNode ? resolveTypeNodeToString(typeNode, sourceFile, project, 3) : "string";
@@ -1923,13 +1316,13 @@ function extractResponseType(method, sourceFile, project) {
   if (apiResponseDecorator) {
     const args = apiResponseDecorator.getArguments();
     const optsArg = args[0];
-    if (optsArg && Node6.isObjectLiteralExpression(optsArg)) {
+    if (optsArg && Node5.isObjectLiteralExpression(optsArg)) {
       for (const prop of optsArg.getProperties()) {
-        if (!Node6.isPropertyAssignment(prop)) continue;
+        if (!Node5.isPropertyAssignment(prop)) continue;
         if (prop.getName() !== "type") continue;
         const val = prop.getInitializer();
         if (!val) continue;
-        if (Node6.isArrayLiteralExpression(val)) {
+        if (Node5.isArrayLiteralExpression(val)) {
           const elements = val.getElements();
           const firstEl = elements[0];
           if (elements.length > 0 && firstEl !== void 0) {
@@ -1949,7 +1342,7 @@ function extractResponseType(method, sourceFile, project) {
   return "unknown";
 }
 function resolveIdentifierToClassType(node, sourceFile, project, depth) {
-  if (!Node6.isIdentifier(node)) return "unknown";
+  if (!Node5.isIdentifier(node)) return "unknown";
   const name = node.getText();
   const resolved = findType(name, sourceFile, project);
   if (resolved) {
@@ -1996,11 +1389,11 @@ function extractDtoContract(method, sourceFile, project) {
     if (apiResp) {
       const args = apiResp.getArguments();
       const optsArg = args[0];
-      if (optsArg && Node6.isObjectLiteralExpression(optsArg)) {
+      if (optsArg && Node5.isObjectLiteralExpression(optsArg)) {
         for (const prop of optsArg.getProperties()) {
-          if (Node6.isPropertyAssignment(prop) && prop.getName() === "type") {
+          if (Node5.isPropertyAssignment(prop) && prop.getName() === "type") {
             const val = prop.getInitializer();
-            if (val && Node6.isIdentifier(val)) {
+            if (val && Node5.isIdentifier(val)) {
               const name = val.getText();
               const localDecl = sourceFile.getInterface(name) || sourceFile.getClass(name) || sourceFile.getTypeAlias(name);
               if (localDecl?.isExported()) {
@@ -2017,27 +1410,18 @@ function extractDtoContract(method, sourceFile, project) {
       }
     }
   }
-  let bodyZodText = null;
-  let queryZodText = null;
   let bodySchema = null;
   let querySchema = null;
-  const formNested = {};
   const formWarnings = [];
   const bodyClass = resolveParamClass(method, "Body", sourceFile, project);
   if (bodyClass) {
-    const result = extractZodFromDto(bodyClass.decl, bodyClass.file, project);
-    bodyZodText = result.schemaText;
-    for (const [k, v] of result.namedNestedSchemas) formNested[k] = v;
-    formWarnings.push(...result.warnings);
     bodySchema = extractSchemaFromDto(bodyClass.decl, bodyClass.file, project);
+    formWarnings.push(...bodySchema.warnings);
   }
   const queryClass = resolveParamClass(method, "Query", sourceFile, project);
   if (queryClass) {
-    const result = extractZodFromDto(queryClass.decl, queryClass.file, project);
-    queryZodText = result.schemaText;
-    for (const [k, v] of result.namedNestedSchemas) formNested[k] = v;
-    formWarnings.push(...result.warnings);
     querySchema = extractSchemaFromDto(queryClass.decl, queryClass.file, project);
+    formWarnings.push(...querySchema.warnings);
   }
   return {
     query,
@@ -2050,9 +1434,6 @@ function extractDtoContract(method, sourceFile, project) {
     filterFields: filterInfo?.fieldNames ?? null,
     filterFieldTypes: filterInfo?.fieldTypes ?? null,
     filterSource: filterInfo?.source ?? null,
-    bodyZodText,
-    queryZodText,
-    formNestedSchemas: Object.keys(formNested).length > 0 ? formNested : null,
     formWarnings,
     bodySchema,
     querySchema
@@ -2072,6 +1453,201 @@ function resolveParamClass(method, decoratorName, sourceFile, project) {
   }
   return null;
 }
+
+// src/discovery/zod-ast-to-ts.ts
+import { Node as Node6, SyntaxKind as SyntaxKind3 } from "ts-morph";
+function zodAstToTs(node) {
+  if (!Node6.isCallExpression(node)) return "unknown";
+  const expr = node.getExpression();
+  if (Node6.isPropertyAccessExpression(expr)) {
+    const methodName = expr.getName();
+    const receiver = expr.getExpression();
+    if (methodName === "optional") {
+      return `${zodAstToTs(receiver)} | undefined`;
+    }
+    if (methodName === "nullable") {
+      return `${zodAstToTs(receiver)} | null`;
+    }
+    const args = node.getArguments();
+    switch (methodName) {
+      case "string":
+        return "string";
+      case "number":
+        return "number";
+      case "boolean":
+        return "boolean";
+      case "unknown":
+        return "unknown";
+      case "any":
+        return "unknown";
+      case "literal": {
+        const lit = args[0];
+        if (!lit) return "unknown";
+        if (Node6.isStringLiteral(lit)) return JSON.stringify(lit.getLiteralValue());
+        if (Node6.isNumericLiteral(lit)) return lit.getLiteralValue().toString();
+        if (lit.getKind() === SyntaxKind3.TrueKeyword) return "true";
+        if (lit.getKind() === SyntaxKind3.FalseKeyword) return "false";
+        return "unknown";
+      }
+      case "enum": {
+        const arrArg = args[0];
+        if (!arrArg || !Node6.isArrayLiteralExpression(arrArg)) return "unknown";
+        const members = arrArg.getElements().map(
+          (el) => Node6.isStringLiteral(el) ? JSON.stringify(el.getLiteralValue()) : "unknown"
+        );
+        return members.join(" | ");
+      }
+      case "array": {
+        const inner = args[0];
+        if (!inner) return "unknown";
+        return `Array<${zodAstToTs(inner)}>`;
+      }
+      case "object": {
+        const objArg = args[0];
+        if (!objArg || !Node6.isObjectLiteralExpression(objArg)) return "unknown";
+        const lines = [];
+        for (const prop of objArg.getProperties()) {
+          if (!Node6.isPropertyAssignment(prop)) continue;
+          const key = prop.getName();
+          const valNode = prop.getInitializer();
+          if (!valNode) continue;
+          const tsType = zodAstToTs(valNode);
+          const isOpt = isOptionalChain(valNode);
+          lines.push(`${key}${isOpt ? "?" : ""}: ${tsType}`);
+        }
+        return `{ ${lines.join("; ")} }`;
+      }
+      case "union": {
+        const arrArg = args[0];
+        if (!arrArg || !Node6.isArrayLiteralExpression(arrArg)) return "unknown";
+        return arrArg.getElements().map(zodAstToTs).join(" | ");
+      }
+      case "record": {
+        const valArg = args.length === 1 ? args[0] : args[1];
+        if (!valArg) return "unknown";
+        return `Record<string, ${zodAstToTs(valArg)}>`;
+      }
+      case "tuple": {
+        const arrArg = args[0];
+        if (!arrArg || !Node6.isArrayLiteralExpression(arrArg)) return "unknown";
+        return `[${arrArg.getElements().map(zodAstToTs).join(", ")}]`;
+      }
+      default:
+        return "unknown";
+    }
+  }
+  return "unknown";
+}
+function isOptionalChain(node) {
+  if (!Node6.isCallExpression(node)) return false;
+  const expr = node.getExpression();
+  return Node6.isPropertyAccessExpression(expr) && expr.getName() === "optional";
+}
+function parseDefineContractCall(callExpr) {
+  if (!Node6.isCallExpression(callExpr)) return null;
+  const callee = callExpr.getExpression();
+  const calleeName = Node6.isIdentifier(callee) ? callee.getText() : Node6.isPropertyAccessExpression(callee) ? callee.getName() : "";
+  if (calleeName !== "defineContract") return null;
+  const args = callExpr.getArguments();
+  const optsArg = args[0];
+  if (!optsArg || !Node6.isObjectLiteralExpression(optsArg)) return null;
+  let query = null;
+  let body = null;
+  let response = "unknown";
+  let bodyZodText = null;
+  let queryZodText = null;
+  for (const prop of optsArg.getProperties()) {
+    if (!Node6.isPropertyAssignment(prop)) continue;
+    const propName = prop.getName();
+    const val = prop.getInitializer();
+    if (!val) continue;
+    if (propName === "query") {
+      query = zodAstToTs(val);
+      queryZodText = val.getText();
+    } else if (propName === "body") {
+      body = zodAstToTs(val);
+      bodyZodText = val.getText();
+    } else if (propName === "response") {
+      response = zodAstToTs(val);
+    }
+  }
+  return { query, body, response, bodyZodText, queryZodText };
+}
+
+// src/discovery/contracts-fast.ts
+async function discoverContractsFast(opts) {
+  const { cwd, glob, tsconfig } = opts;
+  const tsconfigPath = tsconfig ? resolve3(tsconfig) : join2(cwd, "tsconfig.json");
+  let project;
+  try {
+    project = new Project({
+      tsConfigFilePath: tsconfigPath,
+      skipAddingFilesFromTsConfig: true,
+      skipLoadingLibFiles: true,
+      skipFileDependencyResolution: true
+    });
+  } catch {
+    project = new Project({
+      skipAddingFilesFromTsConfig: true,
+      skipLoadingLibFiles: true,
+      skipFileDependencyResolution: true,
+      compilerOptions: {
+        allowJs: true,
+        resolveJsonModule: false,
+        strict: false
+      }
+    });
+  }
+  const files = await fg(glob, { cwd, absolute: true, onlyFiles: true });
+  for (const f of files) {
+    project.addSourceFileAtPath(f);
+  }
+  const routes = [];
+  setDiscoveryContext(project, {
+    projectRoot: cwd,
+    tsconfigPaths: loadTsconfigPaths(tsconfigPath)
+  });
+  for (const sourceFile of project.getSourceFiles()) {
+    routes.push(...extractFromSourceFile(sourceFile, project));
+  }
+  return routes;
+}
+function decoratorStringArg(decoratorExpr) {
+  if (!decoratorExpr) return void 0;
+  if (Node7.isStringLiteral(decoratorExpr)) return decoratorExpr.getLiteralValue();
+  if (Node7.isArrayLiteralExpression(decoratorExpr)) {
+    const first = decoratorExpr.getElements()[0];
+    if (first && Node7.isStringLiteral(first)) return first.getLiteralValue();
+  }
+  return void 0;
+}
+function deriveClassSegment(className) {
+  const noSuffix = className.replace(/Controller$/, "");
+  if (!noSuffix) {
+    throw new Error(
+      `Controller class name "${className}" derives empty route segment after stripping "Controller". Add an @As(...) override at the class level.`
+    );
+  }
+  return noSuffix.charAt(0).toLowerCase() + noSuffix.slice(1);
+}
+function resolveRouteName(className, methodName, classAs, methodAs) {
+  const classPortion = classAs ?? deriveClassSegment(className);
+  const methodPortion = methodAs ?? methodName;
+  return `${classPortion}.${methodPortion}`;
+}
+function joinPaths(prefix, suffix) {
+  if (!prefix && !suffix) return "/";
+  if (!prefix) return suffix.startsWith("/") ? suffix : `/${suffix}`;
+  if (!suffix) return prefix.startsWith("/") ? prefix : `/${prefix}`;
+  const p = prefix.endsWith("/") ? prefix.slice(0, -1) : prefix;
+  const s = suffix.startsWith("/") ? suffix : `/${suffix}`;
+  const combined = p + s;
+  return combined === "" ? "/" : combined;
+}
+function extractParams(path) {
+  const matches = path.matchAll(/:(\w+)/g);
+  return Array.from(matches).map((m) => ({ name: m[1], source: "path" }));
+}
 var HTTP_METHOD_DECORATORS = {
   Get: "GET",
   Post: "POST",
@@ -2082,176 +1658,186 @@ var HTTP_METHOD_DECORATORS = {
   Head: "HEAD",
   All: "ALL"
 };
+function resolveVerb(method) {
+  for (const [decoratorName, verb] of Object.entries(HTTP_METHOD_DECORATORS)) {
+    const httpDecorator = method.getDecorator(decoratorName);
+    if (httpDecorator) {
+      const httpArgs = httpDecorator.getArguments();
+      const pathArg = httpArgs[0];
+      return { httpMethod: verb, handlerPath: decoratorStringArg(pathArg) ?? "" };
+    }
+  }
+  return null;
+}
+function readAsDecorator(node, label) {
+  const asDecorator = node.getDecorator("As");
+  if (!asDecorator) return void 0;
+  const asName = decoratorStringArg(asDecorator.getArguments()[0]);
+  if (!asName) {
+    throw new Error(`@As decorator on ${label} must have a non-empty string argument.`);
+  }
+  return asName;
+}
+function buildRoute(args) {
+  const {
+    className,
+    methodName,
+    resolvedMethod,
+    combinedPath,
+    classAs,
+    methodAs,
+    sourceFile,
+    seenNames,
+    contractSource
+  } = args;
+  const routeName = resolveRouteName(className, methodName, classAs, methodAs);
+  const qualifiedRef = `${className}.${methodName}`;
+  const existing = seenNames.get(routeName);
+  if (existing !== void 0) {
+    throw new Error(
+      `Route name collision: "${routeName}" is used by both "${existing}" and "${qualifiedRef}". Use @As(...) to give one of them a unique name.`
+    );
+  }
+  seenNames.set(routeName, qualifiedRef);
+  return {
+    method: resolvedMethod,
+    path: combinedPath,
+    name: routeName,
+    params: extractParams(combinedPath),
+    controllerRef: { className, methodName, filePath: sourceFile.getFilePath() },
+    contract: { contractSource }
+  };
+}
+function extractContractRoute(args) {
+  const { cls, method, applyContractDecorator, verb, prefix, className, sourceFile, seenNames } = args;
+  const firstDecoratorArg = applyContractDecorator.getArguments()[0];
+  if (!firstDecoratorArg) return null;
+  let contractDef = null;
+  let bodyZodRef = null;
+  let queryZodRef = null;
+  if (Node7.isCallExpression(firstDecoratorArg)) {
+    contractDef = parseDefineContractCall(firstDecoratorArg);
+  } else if (Node7.isIdentifier(firstDecoratorArg)) {
+    const identName = firstDecoratorArg.getText();
+    const varDecl = sourceFile.getVariableDeclaration(identName);
+    if (!varDecl) {
+      console.warn(
+        `[nestjs-codegen/fast] Cannot resolve '${identName}' in ${sourceFile.getFilePath()} (cross-file imports are out-of-scope for v1) \u2014 skipping`
+      );
+      return null;
+    }
+    const initializer = varDecl.getInitializer();
+    if (!initializer) return null;
+    contractDef = parseDefineContractCall(initializer);
+    if (contractDef && varDecl.isExported()) {
+      const filePath = sourceFile.getFilePath();
+      if (contractDef.body !== null) {
+        bodyZodRef = { name: `${identName}.body`, filePath };
+      }
+      if (contractDef.query !== null) {
+        queryZodRef = { name: `${identName}.query`, filePath };
+      }
+    }
+  } else {
+    console.warn(
+      `[nestjs-codegen/fast] @ApplyContract arg is not an identifier or call expression in ${sourceFile.getFilePath()} \u2014 skipping`
+    );
+    return null;
+  }
+  if (!contractDef) return null;
+  if (!verb) return null;
+  const resolvedPath = joinPaths(prefix, verb.handlerPath);
+  const methodName = method.getName();
+  const classAs = readAsDecorator(cls, `class ${className}`);
+  const methodAs = readAsDecorator(method, `${className}.${methodName}`);
+  return buildRoute({
+    className,
+    methodName,
+    resolvedMethod: verb.httpMethod,
+    combinedPath: resolvedPath,
+    classAs,
+    methodAs,
+    sourceFile,
+    seenNames,
+    contractSource: {
+      query: contractDef.query,
+      body: contractDef.body,
+      response: contractDef.response,
+      // Path A: capture both the importable ref and the raw text. The emitter
+      // prefers inlining the text (client-safe — re-exporting from a controller
+      // would drag server-only deps into the client bundle).
+      bodyZodRef,
+      bodyZodText: contractDef.bodyZodText,
+      queryZodRef,
+      queryZodText: contractDef.queryZodText
+    }
+  });
+}
+function extractDtoRoute(args) {
+  const { cls, method, verb, prefix, className, sourceFile, project, seenNames } = args;
+  if (!verb) return null;
+  const combined = joinPaths(prefix, verb.handlerPath);
+  const methodName = method.getName();
+  const classAs = readAsDecorator(cls, `class ${className}`);
+  const methodAs = readAsDecorator(method, `${className}.${methodName}`);
+  const dtoContract = extractDtoContract(method, sourceFile, project);
+  return buildRoute({
+    className,
+    methodName,
+    resolvedMethod: verb.httpMethod,
+    combinedPath: combined,
+    classAs,
+    methodAs,
+    sourceFile,
+    seenNames,
+    contractSource: {
+      query: dtoContract?.query ?? null,
+      body: dtoContract?.body ?? null,
+      response: dtoContract?.response ?? "unknown",
+      queryRef: dtoContract?.queryRef ?? null,
+      bodyRef: dtoContract?.bodyRef ?? null,
+      responseRef: dtoContract?.responseRef ?? null,
+      filterFields: dtoContract?.filterFields ?? null,
+      filterFieldTypes: dtoContract?.filterFieldTypes ?? null,
+      filterSource: dtoContract?.filterSource ?? null,
+      formWarnings: dtoContract?.formWarnings ?? [],
+      bodySchema: dtoContract?.bodySchema ?? null,
+      querySchema: dtoContract?.querySchema ?? null
+    }
+  });
+}
 function extractFromSourceFile(sourceFile, project) {
   const routes = [];
   const seenNames = /* @__PURE__ */ new Map();
-  const classes = sourceFile.getClasses();
-  for (const cls of classes) {
+  for (const cls of sourceFile.getClasses()) {
     const controllerDecorator = cls.getDecorator("Controller");
     if (!controllerDecorator) continue;
-    const controllerArgs = controllerDecorator.getArguments();
-    const firstArg3 = controllerArgs[0];
-    const prefix = decoratorStringArg(firstArg3) ?? "";
+    const firstArg2 = controllerDecorator.getArguments()[0];
+    const prefix = decoratorStringArg(firstArg2) ?? "";
     const className = cls.getName() ?? "Unknown";
     for (const method of cls.getMethods()) {
-      let httpMethod;
-      let handlerPath = "";
-      for (const [decoratorName, verb] of Object.entries(HTTP_METHOD_DECORATORS)) {
-        const httpDecorator = method.getDecorator(decoratorName);
-        if (httpDecorator) {
-          httpMethod = verb;
-          const httpArgs = httpDecorator.getArguments();
-          const pathArg = httpArgs[0];
-          handlerPath = decoratorStringArg(pathArg) ?? "";
-          break;
-        }
-      }
+      const verb = resolveVerb(method);
       const applyContractDecorator = method.getDecorator("ApplyContract");
-      if (applyContractDecorator) {
-        const decoratorArgs = applyContractDecorator.getArguments();
-        const firstDecoratorArg = decoratorArgs[0];
-        if (!firstDecoratorArg) continue;
-        let contractDef = null;
-        let bodyZodRef = null;
-        let queryZodRef = null;
-        if (Node6.isCallExpression(firstDecoratorArg)) {
-          contractDef = parseDefineContractCall(firstDecoratorArg);
-        } else if (Node6.isIdentifier(firstDecoratorArg)) {
-          const identName = firstDecoratorArg.getText();
-          const varDecl = sourceFile.getVariableDeclaration(identName);
-          if (!varDecl) {
-            console.warn(
-              `[nestjs-codegen/fast] Cannot resolve '${identName}' in ${sourceFile.getFilePath()} (cross-file imports are out-of-scope for v1) \u2014 skipping`
-            );
-            continue;
-          }
-          const initializer = varDecl.getInitializer();
-          if (!initializer) continue;
-          contractDef = parseDefineContractCall(initializer);
-          if (contractDef && varDecl.isExported()) {
-            const filePath = sourceFile.getFilePath();
-            if (contractDef.body !== null) {
-              bodyZodRef = { name: `${identName}.body`, filePath };
-            }
-            if (contractDef.query !== null) {
-              queryZodRef = { name: `${identName}.query`, filePath };
-            }
-          }
-        } else {
-          console.warn(
-            `[nestjs-codegen/fast] @ApplyContract arg is not an identifier or call expression in ${sourceFile.getFilePath()} \u2014 skipping`
-          );
-          continue;
-        }
-        if (!contractDef) continue;
-        if (!httpMethod) continue;
-        const resolvedMethod = httpMethod;
-        const resolvedPath = joinPaths(prefix, handlerPath);
-        const combined = resolvedPath;
-        const params = extractParams(combined);
-        const methodName = method.getName();
-        const classAsDecorator = cls.getDecorator("As");
-        let classAs;
-        if (classAsDecorator) {
-          const classAsArgs = classAsDecorator.getArguments();
-          const classAsName = decoratorStringArg(classAsArgs[0]);
-          if (!classAsName) {
-            throw new Error(
-              `@As decorator on class ${className} must have a non-empty string argument.`
-            );
-          }
-          classAs = classAsName;
-        }
-        const methodAsDecorator = method.getDecorator("As");
-        let methodAs;
-        if (methodAsDecorator) {
-          const methodAsArgs = methodAsDecorator.getArguments();
-          const methodAsName = decoratorStringArg(methodAsArgs[0]);
-          if (!methodAsName) {
-            throw new Error(
-              `@As decorator on ${className}.${methodName} must have a non-empty string argument.`
-            );
-          }
-          methodAs = methodAsName;
-        }
-        const routeName = resolveRouteName(className, methodName, classAs, methodAs);
-        const qualifiedRef = `${className}.${methodName}`;
-        const existing = seenNames.get(routeName);
-        if (existing !== void 0) {
-          throw new Error(
-            `Route name collision: "${routeName}" is used by both "${existing}" and "${qualifiedRef}". Use @As(...) to give one of them a unique name.`
-          );
-        }
-        seenNames.set(routeName, qualifiedRef);
-        routes.push({
-          method: resolvedMethod,
-          path: combined,
-          name: routeName,
-          params,
-          controllerRef: { className, methodName, filePath: sourceFile.getFilePath() },
-          contract: {
-            contractSource: {
-              query: contractDef.query,
-              body: contractDef.body,
-              response: contractDef.response,
-              // Path A: capture both the importable ref and the raw text. The
-              // emitter prefers inlining the text (client-safe — re-exporting from
-              // a controller would drag server-only deps into the client bundle).
-              bodyZodRef,
-              bodyZodText: contractDef.bodyZodText,
-              queryZodRef,
-              queryZodText: contractDef.queryZodText
-            }
-          }
-        });
-      } else {
-        if (!httpMethod) continue;
-        const combined = joinPaths(prefix, handlerPath);
-        const params = extractParams(combined);
-        const methodName = method.getName();
-        const classAsDecorator = cls.getDecorator("As");
-        let classAs;
-        if (classAsDecorator) {
-          const classAsArgs = classAsDecorator.getArguments();
-          const classAsName = decoratorStringArg(classAsArgs[0]);
-          if (classAsName) classAs = classAsName;
-        }
-        const methodAsDecorator = method.getDecorator("As");
-        let methodAs;
-        if (methodAsDecorator) {
-          const methodAsArgs = methodAsDecorator.getArguments();
-          const methodAsName = decoratorStringArg(methodAsArgs[0]);
-          if (methodAsName) methodAs = methodAsName;
-        }
-        const routeName = resolveRouteName(className, methodName, classAs, methodAs);
-        const dtoContract = extractDtoContract(method, sourceFile, project);
-        routes.push({
-          method: httpMethod,
-          path: combined,
-          name: routeName,
-          params,
-          controllerRef: { className, methodName, filePath: sourceFile.getFilePath() },
-          contract: {
-            contractSource: {
-              query: dtoContract?.query ?? null,
-              body: dtoContract?.body ?? null,
-              response: dtoContract?.response ?? "unknown",
-              queryRef: dtoContract?.queryRef ?? null,
-              bodyRef: dtoContract?.bodyRef ?? null,
-              responseRef: dtoContract?.responseRef ?? null,
-              filterFields: dtoContract?.filterFields ?? null,
-              filterFieldTypes: dtoContract?.filterFieldTypes ?? null,
-              filterSource: dtoContract?.filterSource ?? null,
-              bodyZodText: dtoContract?.bodyZodText ?? null,
-              queryZodText: dtoContract?.queryZodText ?? null,
-              formNestedSchemas: dtoContract?.formNestedSchemas ?? null,
-              formWarnings: dtoContract?.formWarnings ?? [],
-              bodySchema: dtoContract?.bodySchema ?? null,
-              querySchema: dtoContract?.querySchema ?? null
-            }
-          }
-        });
-      }
+      const route = applyContractDecorator ? extractContractRoute({
+        cls,
+        method,
+        applyContractDecorator,
+        verb,
+        prefix,
+        className,
+        sourceFile,
+        seenNames
+      }) : extractDtoRoute({
+        cls,
+        method,
+        verb,
+        prefix,
+        className,
+        sourceFile,
+        project,
+        seenNames
+      });
+      if (route) routes.push(route);
     }
   }
   return routes;
@@ -2259,8 +1845,7 @@ function extractFromSourceFile(sourceFile, project) {
 
 // src/generate.ts
 import { mkdir as mkdir7, writeFile as writeFile7 } from "fs/promises";
-import { dirname as dirname3, join as join10 } from "path";
-import { Project as Project3 } from "ts-morph";
+import { dirname as dirname3, join as join11 } from "path";
 
 // src/discovery/pages.ts
 import { readFile } from "fs/promises";
@@ -2315,7 +1900,8 @@ function extractPropsSource(source, exportName) {
 }
 
 // src/discovery/shared-props.ts
-import { Node as Node7, SyntaxKind as SyntaxKind3 } from "ts-morph";
+import { join as join4 } from "path";
+import { Node as Node8, Project as Project2, SyntaxKind as SyntaxKind4 } from "ts-morph";
 function discoverSharedProps(project, moduleEntry) {
   try {
     let sourceFile = project.getSourceFile(moduleEntry);
@@ -2326,23 +1912,48 @@ function discoverSharedProps(project, moduleEntry) {
         return null;
       }
     }
-    const forRootCall = findForRootCall(sourceFile);
-    if (!forRootCall) return null;
-    const initializer = findShareInitializer(forRootCall);
-    if (!initializer) return null;
-    return extractShareType(initializer, sourceFile, project);
+    const forRootCall = findForRootCall(sourceFile);
+    if (!forRootCall) return null;
+    const initializer = findShareInitializer(forRootCall);
+    if (!initializer) return null;
+    return extractShareType(initializer, sourceFile, project);
+  } catch {
+    return null;
+  }
+}
+function discoverSharedPropsFromConfig(config) {
+  if (!config.app?.moduleEntry) return null;
+  try {
+    const tsconfigPath = config.app.tsconfig ?? join4(config.codegen.cwd, "tsconfig.json");
+    let project;
+    try {
+      project = new Project2({
+        tsConfigFilePath: tsconfigPath,
+        skipAddingFilesFromTsConfig: true,
+        skipLoadingLibFiles: true,
+        skipFileDependencyResolution: true
+      });
+    } catch {
+      project = new Project2({
+        skipAddingFilesFromTsConfig: true,
+        skipLoadingLibFiles: true,
+        skipFileDependencyResolution: true,
+        compilerOptions: { allowJs: true, strict: false }
+      });
+    }
+    return discoverSharedProps(project, config.app.moduleEntry);
   } catch {
     return null;
   }
 }
 function findForRootCall(sourceFile) {
-  const callExpressions = sourceFile.getDescendantsOfKind(SyntaxKind3.CallExpression);
+  const callExpressions = sourceFile.getDescendantsOfKind(SyntaxKind4.CallExpression);
   for (const call of callExpressions) {
     const expr = call.getExpression();
-    if (!Node7.isPropertyAccessExpression(expr)) continue;
+    if (!Node8.isPropertyAccessExpression(expr)) continue;
     const methodName = expr.getName();
     const objectExpr = expr.getExpression();
-    if (methodName === "forRoot" && Node7.isIdentifier(objectExpr)) {
+    if (methodName === "forRoot" && Node8.isIdentifier(objectExpr)) {
       const name = objectExpr.getText();
       if (name === "InertiaModule") {
         return call;
@@ -2352,19 +1963,19 @@ function findForRootCall(sourceFile) {
   return null;
 }
 function findShareInitializer(forRootCall) {
-  if (!Node7.isCallExpression(forRootCall)) return null;
+  if (!Node8.isCallExpression(forRootCall)) return null;
   const args = forRootCall.getArguments();
-  const firstArg3 = args[0];
-  if (!firstArg3 || !Node7.isObjectLiteralExpression(firstArg3)) return null;
-  for (const prop of firstArg3.getProperties()) {
-    if (Node7.isPropertyAssignment(prop) && prop.getName() === "share") {
+  const firstArg2 = args[0];
+  if (!firstArg2 || !Node8.isObjectLiteralExpression(firstArg2)) return null;
+  for (const prop of firstArg2.getProperties()) {
+    if (Node8.isPropertyAssignment(prop) && prop.getName() === "share") {
       return prop.getInitializer() ?? null;
     }
   }
   return null;
 }
 function extractShareType(node, sourceFile, project) {
-  if (Node7.isIdentifier(node)) {
+  if (Node8.isIdentifier(node)) {
     const ref = resolveIdentifierToImportRef(node, sourceFile, project);
     if (ref) {
       return {
@@ -2374,22 +1985,22 @@ function extractShareType(node, sourceFile, project) {
       };
     }
   }
-  if (Node7.isArrowFunction(node)) {
+  if (Node8.isArrowFunction(node)) {
     const result = extractFromFunctionLike(node, sourceFile);
     return result ? { ...result, isImportRef: false } : null;
   }
-  if (Node7.isFunctionExpression(node)) {
+  if (Node8.isFunctionExpression(node)) {
     const result = extractFromFunctionLike(node, sourceFile);
     return result ? { ...result, isImportRef: false } : null;
   }
-  if (Node7.isObjectLiteralExpression(node)) {
+  if (Node8.isObjectLiteralExpression(node)) {
     const result = extractFromObjectLiteral(node);
     return result ? { ...result, isImportRef: false } : null;
   }
   return null;
 }
 function resolveIdentifierToImportRef(id, sourceFile, project) {
-  if (!Node7.isIdentifier(id)) return null;
+  if (!Node8.isIdentifier(id)) return null;
   const name = id.getText();
   const localFunc = sourceFile.getFunction(name);
   if (localFunc?.isExported()) {
@@ -2423,49 +2034,49 @@ function resolveIdentifierToImportRef(id, sourceFile, project) {
   return null;
 }
 function extractFromFunctionLike(node, _sourceFile) {
-  const returnTypeNode = Node7.isArrowFunction(node) || Node7.isFunctionExpression(node) ? node.getReturnTypeNode() : null;
+  const returnTypeNode = Node8.isArrowFunction(node) || Node8.isFunctionExpression(node) ? node.getReturnTypeNode() : null;
   if (returnTypeNode) {
     return extractFromReturnTypeAnnotation(returnTypeNode);
   }
-  if (Node7.isArrowFunction(node)) {
+  if (Node8.isArrowFunction(node)) {
     const body = node.getBody();
-    if (Node7.isParenthesizedExpression(body)) {
+    if (Node8.isParenthesizedExpression(body)) {
       const inner = body.getExpression();
-      if (Node7.isObjectLiteralExpression(inner)) {
+      if (Node8.isObjectLiteralExpression(inner)) {
         return extractFromObjectLiteral(inner);
       }
     }
-    if (Node7.isObjectLiteralExpression(body)) {
+    if (Node8.isObjectLiteralExpression(body)) {
       return extractFromObjectLiteral(body);
     }
-    if (Node7.isBlock(body)) {
+    if (Node8.isBlock(body)) {
       return extractFromBlockReturn(body);
     }
   }
-  if (Node7.isFunctionExpression(node)) {
+  if (Node8.isFunctionExpression(node)) {
     const body = node.getBody();
-    if (Node7.isBlock(body)) {
+    if (Node8.isBlock(body)) {
       return extractFromBlockReturn(body);
     }
   }
   return null;
 }
 function extractFromReturnTypeAnnotation(typeNode) {
-  if (Node7.isTypeReference(typeNode)) {
+  if (Node8.isTypeReference(typeNode)) {
     const typeName = typeNode.getTypeName();
-    if (Node7.isIdentifier(typeName) && typeName.getText() === "Promise") {
+    if (Node8.isIdentifier(typeName) && typeName.getText() === "Promise") {
       const typeArgs = typeNode.getTypeArguments();
-      const firstArg3 = typeArgs[0];
-      if (firstArg3) {
-        return extractFromReturnTypeAnnotation(firstArg3);
+      const firstArg2 = typeArgs[0];
+      if (firstArg2) {
+        return extractFromReturnTypeAnnotation(firstArg2);
       }
       return null;
     }
   }
-  if (Node7.isTypeLiteral(typeNode)) {
+  if (Node8.isTypeLiteral(typeNode)) {
     const properties = [];
     for (const member of typeNode.getMembers()) {
-      if (Node7.isPropertySignature(member)) {
+      if (Node8.isPropertySignature(member)) {
         const name = member.getName();
         const memberTypeNode = member.getTypeNode();
         const type = memberTypeNode ? memberTypeNode.getText() : "unknown";
@@ -2479,19 +2090,19 @@ function extractFromReturnTypeAnnotation(typeNode) {
   return null;
 }
 function extractFromBlockReturn(block) {
-  if (!Node7.isBlock(block)) return null;
+  if (!Node8.isBlock(block)) return null;
   const statements = block.getStatements();
   for (let i = statements.length - 1; i >= 0; i--) {
     const stmt = statements[i];
-    if (!Node7.isReturnStatement(stmt)) continue;
+    if (!Node8.isReturnStatement(stmt)) continue;
     const expr = stmt.getExpression();
     if (!expr) continue;
-    if (Node7.isObjectLiteralExpression(expr)) {
+    if (Node8.isObjectLiteralExpression(expr)) {
       return extractFromObjectLiteral(expr);
     }
-    if (Node7.isParenthesizedExpression(expr)) {
+    if (Node8.isParenthesizedExpression(expr)) {
       const inner = expr.getExpression();
-      if (Node7.isObjectLiteralExpression(inner)) {
+      if (Node8.isObjectLiteralExpression(inner)) {
         return extractFromObjectLiteral(inner);
       }
     }
@@ -2500,10 +2111,10 @@ function extractFromBlockReturn(block) {
   return null;
 }
 function extractFromObjectLiteral(objLiteral) {
-  if (!Node7.isObjectLiteralExpression(objLiteral)) return null;
+  if (!Node8.isObjectLiteralExpression(objLiteral)) return null;
   const properties = [];
   for (const prop of objLiteral.getProperties()) {
-    if (!Node7.isPropertyAssignment(prop)) continue;
+    if (!Node8.isPropertyAssignment(prop)) continue;
     const name = prop.getName();
     const initializer = prop.getInitializer();
     if (!initializer) continue;
@@ -2515,21 +2126,21 @@ function extractFromObjectLiteral(objLiteral) {
   return { typeString, properties, isImportRef: false };
 }
 function inferExpressionType(node) {
-  if (Node7.isStringLiteral(node)) return "string";
-  if (Node7.isTemplateExpression(node) || Node7.isNoSubstitutionTemplateLiteral(node))
+  if (Node8.isStringLiteral(node)) return "string";
+  if (Node8.isTemplateExpression(node) || Node8.isNoSubstitutionTemplateLiteral(node))
     return "string";
-  if (Node7.isNumericLiteral(node)) return "number";
-  if (node.getKind() === SyntaxKind3.TrueKeyword || node.getKind() === SyntaxKind3.FalseKeyword) {
+  if (Node8.isNumericLiteral(node)) return "number";
+  if (node.getKind() === SyntaxKind4.TrueKeyword || node.getKind() === SyntaxKind4.FalseKeyword) {
     return "boolean";
   }
-  if (node.getKind() === SyntaxKind3.NullKeyword) return "null";
-  if (Node7.isIdentifier(node) && node.getText() === "undefined") return "undefined";
-  if (Node7.isObjectLiteralExpression(node)) {
+  if (node.getKind() === SyntaxKind4.NullKeyword) return "null";
+  if (Node8.isIdentifier(node) && node.getText() === "undefined") return "undefined";
+  if (Node8.isObjectLiteralExpression(node)) {
     const props = node.getProperties();
     if (props.length === 0) return "Record<string, unknown>";
     const entries = [];
     for (const prop of props) {
-      if (!Node7.isPropertyAssignment(prop)) continue;
+      if (!Node8.isPropertyAssignment(prop)) continue;
       const key = prop.getName();
       const init = prop.getInitializer();
       if (!init) continue;
@@ -2538,23 +2149,23 @@ function inferExpressionType(node) {
     if (entries.length === 0) return "Record<string, unknown>";
     return `{ ${entries.join("; ")} }`;
   }
-  if (Node7.isArrayLiteralExpression(node)) {
+  if (Node8.isArrayLiteralExpression(node)) {
     const elements = node.getElements();
     if (elements.length === 0) return "Array<unknown>";
     const first = elements[0];
     if (first) return `Array<${inferExpressionType(first)}>`;
     return "Array<unknown>";
   }
-  if (Node7.isConditionalExpression(node)) {
+  if (Node8.isConditionalExpression(node)) {
     const whenTrue = inferExpressionType(node.getWhenTrue());
     const whenFalse = inferExpressionType(node.getWhenFalse());
     if (whenTrue === whenFalse) return whenTrue;
     return `${whenTrue} | ${whenFalse}`;
   }
-  if (Node7.isParenthesizedExpression(node)) {
+  if (Node8.isParenthesizedExpression(node)) {
     return inferExpressionType(node.getExpression());
   }
-  if (Node7.isAsExpression(node)) {
+  if (Node8.isAsExpression(node)) {
     const typeNode = node.getTypeNode();
     if (typeNode) return typeNode.getText();
   }
@@ -2563,25 +2174,14 @@ function inferExpressionType(node) {
 
 // src/emit/emit-api.ts
 import { mkdir, writeFile } from "fs/promises";
-import { isAbsolute as isAbsolute2, join as join4, relative as relative3 } from "path";
+import { isAbsolute as isAbsolute2, join as join5, relative as relative3 } from "path";
 
 // src/extension/registry.ts
-import { Project as Project2 } from "ts-morph";
+import { Project as Project3 } from "ts-morph";
 function resolveApiSlots(extensions) {
-  let transport;
-  let transportOwner;
   let layer;
   let layerOwner;
   for (const ext of extensions) {
-    if (ext.apiTransport) {
-      if (transport) {
-        throw new CodegenError(
-          `api transport claimed by both "${transportOwner}" and "${ext.name}" \u2014 only one extension may set apiTransport.`
-        );
-      }
-      transport = ext.apiTransport;
-      transportOwner = ext.name;
-    }
     if (ext.apiClientLayer) {
       if (layer) {
         throw new CodegenError(
@@ -2593,11 +2193,22 @@ function resolveApiSlots(extensions) {
     }
   }
   return {
-    ...transport ? { transport } : {},
     ...layer ? { layer } : {}
   };
 }
 var CORE_FILES = /* @__PURE__ */ new Set(["routes.ts", "api.ts", "forms.ts", "index.d.ts", "pages.d.ts"]);
+function mergeExclusive(target, incoming, {
+  owner,
+  describe
+}) {
+  for (const [key, value] of incoming) {
+    const prev = target.get(key);
+    if (prev !== void 0) {
+      throw new CodegenError(describe(key, prev.owner, owner));
+    }
+    target.set(key, { value, owner });
+  }
+}
 function createExtensionContext(config, getRoutes) {
   let project;
   return {
@@ -2609,7 +2220,7 @@ function createExtensionContext(config, getRoutes) {
     },
     project() {
       if (!project) {
-        project = new Project2({
+        project = new Project3({
           skipAddingFilesFromTsConfig: true,
           skipLoadingLibFiles: true,
           skipFileDependencyResolution: true,
@@ -2642,29 +2253,36 @@ async function collectEmittedFiles(extensions, ctx) {
           `Extension "${ext.name}" tried to emit the core-owned file "${file.path}". Core files (${[...CORE_FILES].join(", ")}) cannot be produced by extensions.`
         );
       }
-      const prev = owners.get(key);
-      if (prev !== void 0) {
-        throw new CodegenError(
-          `Output file "${file.path}" is emitted by both "${prev}" and "${ext.name}". Two extensions cannot write the same file.`
-        );
-      }
-      owners.set(key, ext.name);
+      mergeExclusive(owners, [[key, file]], {
+        owner: ext.name,
+        describe: (_key, prevOwner, owner) => `Output file "${file.path}" is emitted by both "${prevOwner}" and "${owner}". Two extensions cannot write the same file.`
+      });
       files.push(file);
     }
   }
   return files;
 }
 
+// src/extension/types.ts
+function requestShape(route) {
+  const cs = route.contract?.contractSource;
+  const isGet = route.method.toUpperCase() === "GET";
+  const isQuery = isGet || !!cs?.filterFields?.length;
+  const hasBody = !!cs?.bodyRef || cs?.body != null && cs.body !== "never";
+  const hasQuery = isGet || !!cs?.queryRef || cs?.query != null && cs.query !== "never";
+  return { isGet, isQuery, hasBody, hasQuery };
+}
+
 // src/emit/emit-api.ts
 async function emitApi(routes, outDir, opts = {}) {
   await mkdir(outDir, { recursive: true });
   const content = buildApiFile(routes, outDir, opts);
-  await writeFile(join4(outDir, "api.ts"), content, "utf8");
+  await writeFile(join5(outDir, "api.ts"), content, "utf8");
 }
 function splitName(name) {
   return name.split(".");
 }
-function toObjectKey3(segment) {
+function toObjectKey(segment) {
   if (/^[A-Za-z_$][A-Za-z0-9_$]*$/.test(segment)) {
     return segment;
   }
@@ -2771,7 +2389,7 @@ function emitRouterTypeBlock(tree, indent, outDir) {
   const pad = " ".repeat(indent);
   const lines = [];
   for (const [key, node] of tree) {
-    const objKey = toObjectKey3(key);
+    const objKey = toObjectKey(key);
     if (node.kind === "leaf") {
       const c = node;
       const method = c.method.toUpperCase();
@@ -2797,15 +2415,12 @@ function emitRouterTypeBlock(tree, indent, outDir) {
   return lines;
 }
 function buildRequestModel(c) {
-  const isGet = c.method.toUpperCase() === "GET";
   const m = c.method.toLowerCase();
   const flat = JSON.stringify(c.name);
   const path = JSON.stringify(c.path);
   const TA = buildRouterTypeAccess(c.name);
   const withParams = hasPathParams(c.params);
-  const hasBody = !!c.contractSource.bodyRef || c.contractSource.body != null && c.contractSource.body !== "never";
-  const isQuery = isGet || !!c.contractSource.filterFields?.length;
-  const hasQuery = isGet || !!c.contractSource.queryRef || c.contractSource.query != null && c.contractSource.query !== "never";
+  const { isGet, isQuery, hasBody, hasQuery } = requestShape(c.route);
   const fields = [];
   if (withParams) fields.push(`params: ${TA}['params']`);
   if (hasQuery) fields.push(`query?: ${TA}['query']`);
@@ -2827,7 +2442,6 @@ function buildRequestModel(c) {
     urlExpr,
     optsExpr,
     responseType: `${TA}['response']`,
-    bodyType: `${TA}['body']`,
     queryKeyExpr: `[${flat}, input] as const`
   };
 }
@@ -2875,7 +2489,7 @@ function emitApiObjectBlock(tree, indent, p) {
   const pad = " ".repeat(indent);
   const lines = [];
   for (const [key, node] of tree) {
-    const objKey = toObjectKey3(key);
+    const objKey = toObjectKey(key);
     if (node.kind === "branch") {
       lines.push(`${pad}${objKey}: {`);
       lines.push(...emitApiObjectBlock(node.children, indent + 2, p));
@@ -2883,30 +2497,28 @@ function emitApiObjectBlock(tree, indent, p) {
       continue;
     }
     const req = buildRequestModel(node);
-    const route = {
-      method: node.method,
-      path: node.path,
-      name: node.name,
-      params: node.params,
-      contract: { contractSource: node.contractSource },
-      ...node.controllerRef ? { controllerRef: node.controllerRef } : {}
+    const leaf = {
+      route: node.route,
+      request: req,
+      requestExpr: renderFetcherRequest(req)
     };
-    const leaf = { route, request: req, requestExpr: "" };
-    leaf.requestExpr = p.transport ? p.transport.renderRequest(leaf, p.ctx) : renderFetcherRequest(req);
-    const members = {};
-    if (p.layer) Object.assign(members, p.layer.buildMembers(leaf.requestExpr, leaf, p.ctx));
+    const owned = /* @__PURE__ */ new Map();
+    if (p.layer) {
+      mergeExclusive(owned, Object.entries(p.layer.buildMembers(leaf.requestExpr, leaf, p.ctx)), {
+        owner: p.layer.name,
+        describe: (name, prevOwner, owner) => `api member "${name}" on route "${req.routeName}" is contributed by more than one extension (conflict between "${prevOwner}" and "${owner}").`
+      });
+    }
     for (const ext of p.memberExts) {
       const extra = ext.apiMembers?.(leaf, p.ctx);
       if (!extra) continue;
-      for (const [name, value] of Object.entries(extra)) {
-        if (name in members) {
-          throw new Error(
-            `api member "${name}" on route "${req.routeName}" is contributed by more than one extension (conflict at "${ext.name}").`
-          );
-        }
-        members[name] = value;
-      }
+      mergeExclusive(owned, Object.entries(extra), {
+        owner: ext.name,
+        describe: (name, prevOwner, owner) => `api member "${name}" on route "${req.routeName}" is contributed by more than one extension (conflict between "${prevOwner}" and "${owner}").`
+      });
     }
+    const members = {};
+    for (const [name, { value }] of owned) members[name] = value;
     lines.push(...renderLeaf(pad, objKey, req, leaf.requestExpr, members));
   }
   return lines;
@@ -2915,10 +2527,82 @@ function buildRouterTypeAccess(name) {
   const segments = splitName(name);
   return `ApiRouter${segments.map((s) => `[${JSON.stringify(s)}]`).join("")}`;
 }
+var RESOLVER_HELPERS = [
+  // --- Recursive helper type _RouterAt: walks nested ApiRouter by dot-path ---
+  "type _RouterAt<R, P extends string> = P extends `${infer Head}.${infer Tail}`",
+  "  ? Head extends keyof R ? _RouterAt<R[Head], Tail> : never",
+  "  : P extends keyof R ? R[P] : never;",
+  "",
+  // --- ResolveByName: resolve a field from a dot-path name ---
+  "type ResolveByName<K extends string, Field extends string> = _RouterAt<ApiRouter, K> extends infer R ? Field extends keyof R ? R[Field] : never : never;",
+  "",
+  // --- ResolveByPath: scan all leaves for matching method + url ---
+  // Flattens ApiRouter recursively and finds the entry whose method === M and url === U.
+  "type _LeafValues<T> = T extends { method: string; url: string }",
+  "  ? T",
+  "  : T extends object ? _LeafValues<T[keyof T]> : never;",
+  "",
+  "type ResolveByPath<M extends string, U extends string, Field extends string> = _LeafValues<ApiRouter> extends infer L",
+  "  ? L extends { method: M; url: U }",
+  "    ? Field extends keyof L ? L[Field] : never",
+  "    : never",
+  "  : never;",
+  ""
+];
+var ROUTE_NAMESPACE = [
+  "export namespace Route {",
+  '  export type Response<K extends string> = ResolveByName<K, "response">;',
+  '  export type Body<K extends string> = ResolveByName<K, "body">;',
+  '  export type Query<K extends string> = ResolveByName<K, "query">;',
+  '  export type Params<K extends string> = ResolveByName<K, "params">;',
+  '  export type Error<K extends string> = ResolveByName<K, "error">;',
+  '  export type FilterFields<K extends string> = ResolveByName<K, "filterFields">;',
+  "  export type Request<K extends string> = {",
+  "    body: Body<K>;",
+  "    query: Query<K>;",
+  "    params: Params<K>;",
+  "  };",
+  "}",
+  ""
+];
+var PATH_NAMESPACE = [
+  "export namespace Path {",
+  '  export type Response<M extends string, U extends string> = ResolveByPath<M, U, "response">;',
+  '  export type Body<M extends string, U extends string> = ResolveByPath<M, U, "body">;',
+  '  export type Query<M extends string, U extends string> = ResolveByPath<M, U, "query">;',
+  '  export type Params<M extends string, U extends string> = ResolveByPath<M, U, "params">;',
+  '  export type Error<M extends string, U extends string> = ResolveByPath<M, U, "error">;',
+  '  export type FilterFields<M extends string, U extends string> = ResolveByPath<M, U, "filterFields">;',
+  "}",
+  ""
+];
+var EMPTY_ROUTE_NAMESPACE = [
+  "export namespace Route {",
+  "  export type Response<K extends string> = never;",
+  "  export type Body<K extends string> = never;",
+  "  export type Query<K extends string> = never;",
+  "  export type Params<K extends string> = never;",
+  "  export type Error<K extends string> = never;",
+  "  export type FilterFields<K extends string> = never;",
+  "  export type Request<K extends string> = { body: never; query: never; params: never };",
+  "}",
+  ""
+];
+var EMPTY_PATH_NAMESPACE = [
+  "export namespace Path {",
+  "  export type Response<M extends string, U extends string> = never;",
+  "  export type Body<M extends string, U extends string> = never;",
+  "  export type Query<M extends string, U extends string> = never;",
+  "  export type Params<M extends string, U extends string> = never;",
+  "  export type Error<M extends string, U extends string> = never;",
+  "  export type FilterFields<M extends string, U extends string> = never;",
+  "}",
+  ""
+];
 function buildApiFile(routes, outDir, opts = {}) {
   const fetcherImportPath = opts.fetcherImportPath;
   const extensions = opts.extensions ?? [];
-  const { transport, layer } = resolveApiSlots(extensions);
+  const { layer } = resolveApiSlots(extensions);
   const memberExts = extensions.filter((e) => e.apiMembers);
   const headerExts = extensions.filter((e) => e.apiHeader);
   const contracted = routes.filter((r) => r.contract);
@@ -2963,7 +2647,6 @@ function buildApiFile(routes, outDir, opts = {}) {
     seenImports.add(imp);
     extImports.push(imp);
   };
-  for (const imp of transport?.imports?.(ctx) ?? []) pushImport(imp);
   for (const imp of layer?.imports?.(ctx) ?? []) pushImport(imp);
   for (const ext of headerExts) {
     for (const imp of ext.apiHeader?.(ctx)?.imports ?? []) pushImport(imp);
@@ -3008,27 +2691,8 @@ function buildApiFile(routes, outDir, opts = {}) {
     lines.push("}");
     lines.push("export type Api = ReturnType<typeof createApi>;");
     lines.push("");
-    lines.push("export namespace Route {");
-    lines.push("  export type Response<K extends string> = never;");
-    lines.push("  export type Body<K extends string> = never;");
-    lines.push("  export type Query<K extends string> = never;");
-    lines.push("  export type Params<K extends string> = never;");
-    lines.push("  export type Error<K extends string> = never;");
-    lines.push("  export type FilterFields<K extends string> = never;");
-    lines.push(
-      "  export type Request<K extends string> = { body: never; query: never; params: never };"
-    );
-    lines.push("}");
-    lines.push("");
-    lines.push("export namespace Path {");
-    lines.push("  export type Response<M extends string, U extends string> = never;");
-    lines.push("  export type Body<M extends string, U extends string> = never;");
-    lines.push("  export type Query<M extends string, U extends string> = never;");
-    lines.push("  export type Params<M extends string, U extends string> = never;");
-    lines.push("  export type Error<M extends string, U extends string> = never;");
-    lines.push("  export type FilterFields<M extends string, U extends string> = never;");
-    lines.push("}");
-    lines.push("");
+    lines.push(...EMPTY_ROUTE_NAMESPACE);
+    lines.push(...EMPTY_PATH_NAMESPACE);
     return lines.join("\n");
   }
   const tree = /* @__PURE__ */ new Map();
@@ -3046,7 +2710,8 @@ function buildApiFile(routes, outDir, opts = {}) {
       path: r.path,
       params: r.params,
       controllerRef: r.controllerRef,
-      contractSource: c.contractSource
+      contractSource: c.contractSource,
+      route: r
     };
     insertIntoTree(tree, segments, leaf, name);
   }
@@ -3059,7 +2724,6 @@ function buildApiFile(routes, outDir, opts = {}) {
   lines.push("  return {");
   lines.push(
     ...emitApiObjectBlock(tree, 4, {
-      ...transport ? { transport } : {},
       ...layer ? { layer } : {},
       memberExts,
       ctx
@@ -3070,61 +2734,9 @@ function buildApiFile(routes, outDir, opts = {}) {
   lines.push("");
   lines.push("export type Api = ReturnType<typeof createApi>;");
   lines.push("");
-  lines.push("type _RouterAt<R, P extends string> = P extends `${infer Head}.${infer Tail}`");
-  lines.push("  ? Head extends keyof R ? _RouterAt<R[Head], Tail> : never");
-  lines.push("  : P extends keyof R ? R[P] : never;");
-  lines.push("");
-  lines.push(
-    "type ResolveByName<K extends string, Field extends string> = _RouterAt<ApiRouter, K> extends infer R ? Field extends keyof R ? R[Field] : never : never;"
-  );
-  lines.push("");
-  lines.push("type _LeafValues<T> = T extends { method: string; url: string }");
-  lines.push("  ? T");
-  lines.push("  : T extends object ? _LeafValues<T[keyof T]> : never;");
-  lines.push("");
-  lines.push(
-    "type ResolveByPath<M extends string, U extends string, Field extends string> = _LeafValues<ApiRouter> extends infer L"
-  );
-  lines.push("  ? L extends { method: M; url: U }");
-  lines.push("    ? Field extends keyof L ? L[Field] : never");
-  lines.push("    : never");
-  lines.push("  : never;");
-  lines.push("");
-  lines.push("export namespace Route {");
-  lines.push('  export type Response<K extends string> = ResolveByName<K, "response">;');
-  lines.push('  export type Body<K extends string> = ResolveByName<K, "body">;');
-  lines.push('  export type Query<K extends string> = ResolveByName<K, "query">;');
-  lines.push('  export type Params<K extends string> = ResolveByName<K, "params">;');
-  lines.push('  export type Error<K extends string> = ResolveByName<K, "error">;');
-  lines.push('  export type FilterFields<K extends string> = ResolveByName<K, "filterFields">;');
-  lines.push("  export type Request<K extends string> = {");
-  lines.push("    body: Body<K>;");
-  lines.push("    query: Query<K>;");
-  lines.push("    params: Params<K>;");
-  lines.push("  };");
-  lines.push("}");
-  lines.push("");
-  lines.push("export namespace Path {");
-  lines.push(
-    '  export type Response<M extends string, U extends string> = ResolveByPath<M, U, "response">;'
-  );
-  lines.push(
-    '  export type Body<M extends string, U extends string> = ResolveByPath<M, U, "body">;'
-  );
-  lines.push(
-    '  export type Query<M extends string, U extends string> = ResolveByPath<M, U, "query">;'
-  );
-  lines.push(
-    '  export type Params<M extends string, U extends string> = ResolveByPath<M, U, "params">;'
-  );
-  lines.push(
-    '  export type Error<M extends string, U extends string> = ResolveByPath<M, U, "error">;'
-  );
-  lines.push(
-    '  export type FilterFields<M extends string, U extends string> = ResolveByPath<M, U, "filterFields">;'
-  );
-  lines.push("}");
-  lines.push("");
+  lines.push(...RESOLVER_HELPERS);
+  lines.push(...ROUTE_NAMESPACE);
+  lines.push(...PATH_NAMESPACE);
   for (const ext of headerExts) {
     const statements = ext.apiHeader?.(ctx)?.statements;
     if (statements?.length) {
@@ -3136,7 +2748,7 @@ function buildApiFile(routes, outDir, opts = {}) {
 
 // src/emit/emit-cache.ts
 import { mkdir as mkdir2, stat, writeFile as writeFile2 } from "fs/promises";
-import { join as join5 } from "path";
+import { join as join6 } from "path";
 async function emitCache(pages, outDir) {
   await mkdir2(outDir, { recursive: true });
   const entries = await Promise.all(
@@ -3150,95 +2762,21 @@ async function emitCache(pages, outDir) {
     })
   );
   const cache = { pages: entries };
-  await writeFile2(join5(outDir, "components.json"), `${JSON.stringify(cache, null, 2)}
+  await writeFile2(join6(outDir, "components.json"), `${JSON.stringify(cache, null, 2)}
 `, "utf8");
 }
 
 // src/emit/emit-forms.ts
 import { mkdir as mkdir3, writeFile as writeFile3 } from "fs/promises";
-import { join as join6, relative as relative4 } from "path";
+import { join as join7, relative as relative4 } from "path";
 async function emitForms(routes, outDir, config, adapter) {
   if (config && config.enabled === false) return false;
-  if (adapter && adapter.name !== "zod") {
-    const content2 = buildFormsFileWithAdapter(routes, adapter);
-    if (content2 === null) return false;
-    await mkdir3(outDir, { recursive: true });
-    await writeFile3(join6(outDir, "forms.ts"), content2, "utf8");
-    return true;
-  }
-  const entries = collectFormEntries(routes);
-  if (entries.length === 0) return false;
+  const content = buildFormsFileWithAdapter(routes, outDir, adapter, config);
+  if (content === null) return false;
   await mkdir3(outDir, { recursive: true });
-  const content = buildFormsFile(entries, outDir, config);
-  await writeFile3(join6(outDir, "forms.ts"), content, "utf8");
+  await writeFile3(join7(outDir, "forms.ts"), content, "utf8");
   return true;
 }
-function buildFormsFileWithAdapter(routes, adapter) {
-  const sorted = [...routes].filter((r) => r.contract).sort((a, b) => a.name.localeCompare(b.name));
-  const methodNameCounts = /* @__PURE__ */ new Map();
-  for (const route of sorted) {
-    const cs = route.contract.contractSource;
-    if (!cs.bodySchema && !cs.querySchema) continue;
-    methodNameCounts.set(
-      deriveBaseName(route.name).method,
-      (methodNameCounts.get(deriveBaseName(route.name).method) ?? 0) + 1
-    );
-  }
-  const named = /* @__PURE__ */ new Map();
-  const decls = [];
-  const mapEntries = [];
-  let used = false;
-  for (const route of sorted) {
-    const cs = route.contract.contractSource;
-    const { method, full } = deriveBaseName(route.name);
-    const base = (methodNameCounts.get(method) ?? 0) > 1 ? full : method;
-    const block = [];
-    if (cs.bodyZodText && !cs.bodySchema) {
-      block.push(
-        `// warning: ${route.name} body is a defineContract (zod) schema; not translated to ${adapter.name} \u2014 use the zod adapter.`
-      );
-    }
-    let bodyConst;
-    if (cs.bodySchema) {
-      used = true;
-      const r = adapter.renderModule(cs.bodySchema);
-      for (const [n, t] of r.namedNestedSchemas) named.set(n, t);
-      bodyConst = `${base}BodySchema`;
-      block.push(`export const ${bodyConst} = ${r.schemaText};`);
-      block.push(`export type ${base}Body = ${adapter.inferType(bodyConst)};`);
-    }
-    if (cs.querySchema) {
-      used = true;
-      const r = adapter.renderModule(cs.querySchema);
-      for (const [n, t] of r.namedNestedSchemas) named.set(n, t);
-      const queryConst = `${base}QuerySchema`;
-      block.push(`export const ${queryConst} = ${r.schemaText};`);
-      block.push(`export type ${base}Query = ${adapter.inferType(queryConst)};`);
-    }
-    if (block.length === 0) continue;
-    decls.push(`// ${route.name}`, ...block, "");
-    if (bodyConst) mapEntries.push(`  ${JSON.stringify(route.name)}: ${bodyConst},`);
-  }
-  if (!used) return null;
-  const lines = ["// Generated by @dudousxd/nestjs-codegen. Do not edit."];
-  for (const imp of adapter.importStatements({ used: true })) lines.push(imp);
-  lines.push("");
-  if (named.size > 0) {
-    lines.push("// Hoisted nested schemas (shared across endpoints).");
-    for (const [n, t] of named) lines.push(`const ${n} = ${t};`);
-    lines.push("");
-  }
-  lines.push(...decls);
-  lines.push("/** Route name \u2192 body schema map. */");
-  lines.push("export const formSchemas = {");
-  lines.push(...mapEntries);
-  lines.push("} as const;");
-  lines.push("");
-  return lines.join("\n");
-}
-function hasSchema(src) {
-  return !!src && (src.ref !== null || src.text !== null);
-}
 function pascal(segment) {
   return segment.split(/[^a-zA-Z0-9]+/).filter(Boolean).map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join("");
 }
@@ -3248,37 +2786,6 @@ function deriveBaseName(routeName) {
   const full = segments.map(pascal).join("");
   return { method, full };
 }
-function collectFormEntries(routes) {
-  const sorted = [...routes].filter((r) => r.contract).sort((a, b) => a.name.localeCompare(b.name));
-  const methodNameCounts = /* @__PURE__ */ new Map();
-  const candidates = [];
-  for (const route of sorted) {
-    const cs = route.contract.contractSource;
-    const body = { ref: cs.bodyZodRef ?? null, text: cs.bodyZodText ?? null };
-    const query = { ref: cs.queryZodRef ?? null, text: cs.queryZodText ?? null };
-    if (!hasSchema(body) && !hasSchema(query)) continue;
-    const { method, full } = deriveBaseName(route.name);
-    methodNameCounts.set(method, (methodNameCounts.get(method) ?? 0) + 1);
-    candidates.push({ route, method, full });
-  }
-  const entries = [];
-  for (const { route, method, full } of candidates) {
-    const cs = route.contract.contractSource;
-    const collision = (methodNameCounts.get(method) ?? 0) > 1;
-    const baseName = collision ? full : method;
-    const body = { ref: cs.bodyZodRef ?? null, text: cs.bodyZodText ?? null };
-    const query = { ref: cs.queryZodRef ?? null, text: cs.queryZodText ?? null };
-    entries.push({
-      routeName: route.name,
-      baseName,
-      body: hasSchema(body) ? body : void 0,
-      query: hasSchema(query) ? query : void 0,
-      nestedSchemas: cs.formNestedSchemas ?? null,
-      warnings: cs.formWarnings ?? []
-    });
-  }
-  return entries;
-}
 function relImport(outDir, filePath) {
   let relPath = relative4(outDir, filePath).replace(/\.ts$/, "");
   if (!relPath.startsWith(".")) relPath = `./${relPath}`;
@@ -3287,85 +2794,8 @@ function relImport(outDir, filePath) {
 function refRootIdentifier(refName) {
   return refName.split(".")[0] ?? refName;
 }
-function buildFormsFile(entries, outDir, config) {
-  const zodImport = config?.zodImport ?? "zod";
-  const lines = [
-    "// Generated by @dudousxd/nestjs-codegen. Do not edit.",
-    `import { z } from '${zodImport}';`
-  ];
-  const importsByFile = /* @__PURE__ */ new Map();
-  const refAlias = /* @__PURE__ */ new Map();
-  for (const entry of entries) {
-    for (const src of [entry.body, entry.query]) {
-      if (src?.ref && !src.text) {
-        const root = refRootIdentifier(src.ref.name);
-        const set = importsByFile.get(src.ref.filePath) ?? /* @__PURE__ */ new Set();
-        set.add(root);
-        importsByFile.set(src.ref.filePath, set);
-      }
-    }
-  }
-  if (importsByFile.size > 0) {
-    const emitted = /* @__PURE__ */ new Set();
-    for (const [filePath, roots] of [...importsByFile.entries()].sort()) {
-      const relPath = relImport(outDir, filePath);
-      const specifiers = [];
-      for (const root of [...roots].sort()) {
-        if (emitted.has(root)) {
-          const alias = `${root}_${emitted.size}`;
-          specifiers.push(`${root} as ${alias}`);
-          emitted.add(alias);
-          refAlias.set(`${filePath}\0${root}`, alias);
-        } else {
-          specifiers.push(root);
-          emitted.add(root);
-          refAlias.set(`${filePath}\0${root}`, root);
-        }
-      }
-      lines.push(`import { ${specifiers.join(", ")} } from '${relPath}';`);
-    }
-  }
-  lines.push("");
-  const { globalSchemas, renamesByEntry } = planNestedSchemas(entries);
-  if (globalSchemas.size > 0) {
-    lines.push("// Hoisted nested schemas (shared across endpoints).");
-    for (const [name, text] of globalSchemas) {
-      lines.push(`const ${name} = ${text};`);
-    }
-    lines.push("");
-  }
-  const mapEntries = [];
-  for (const entry of entries) {
-    lines.push(`// ${entry.routeName}`);
-    if (entry.warnings && entry.warnings.length > 0) {
-      for (const w of entry.warnings) {
-        lines.push(`// warning: ${w}`);
-      }
-    }
-    const rename = renamesByEntry.get(entry) ?? null;
-    if (entry.body) {
-      const schemaName = `${entry.baseName}BodySchema`;
-      const typeName = `${entry.baseName}Body`;
-      const text = applyRenames(renderSchema(entry.body, outDir, refAlias), rename);
-      lines.push(`export const ${schemaName} = ${text};`);
-      lines.push(`export type ${typeName} = z.infer<typeof ${schemaName}>;`);
-      mapEntries.push(`  ${JSON.stringify(entry.routeName)}: ${schemaName},`);
-    }
-    if (entry.query) {
-      const schemaName = `${entry.baseName}QuerySchema`;
-      const typeName = `${entry.baseName}Query`;
-      const text = applyRenames(renderSchema(entry.query, outDir, refAlias), rename);
-      lines.push(`export const ${schemaName} = ${text};`);
-      lines.push(`export type ${typeName} = z.infer<typeof ${schemaName}>;`);
-    }
-    lines.push("");
-  }
-  lines.push("/** Route name \u2192 body schema map. */");
-  lines.push("export const formSchemas = {");
-  lines.push(...mapEntries);
-  lines.push("} as const;");
-  lines.push("");
-  return lines.join("\n");
+function hasSource(src) {
+  return !!(src.schema || src.zodText || src.zodRef);
 }
 function applyRenames(text, renames) {
   if (!renames || renames.size === 0) return text;
@@ -3431,20 +2861,182 @@ function planNestedSchemas(entries) {
   }
   return { globalSchemas, renamesByEntry };
 }
-function renderSchema(src, outDir, refAlias) {
-  if (src.text) return src.text;
-  if (src.ref) {
-    const root = refRootIdentifier(src.ref.name);
-    const alias = refAlias.get(`${src.ref.filePath}\0${root}`) ?? root;
-    const member = src.ref.name.slice(root.length);
-    return `${alias}${member}`;
+function buildFormsFileWithAdapter(routes, outDir, adapter, config) {
+  const acceptsRawZod = adapter.acceptsRawZodSource === true;
+  const sorted = [...routes].filter((r) => r.contract).sort((a, b) => a.name.localeCompare(b.name));
+  const methodNameCounts = /* @__PURE__ */ new Map();
+  const candidates = [];
+  for (const route of sorted) {
+    const cs = route.contract.contractSource;
+    const body = {
+      schema: cs.bodySchema ?? null,
+      zodText: cs.bodyZodText ?? null,
+      zodRef: cs.bodyZodRef ?? null
+    };
+    const query = {
+      schema: cs.querySchema ?? null,
+      zodText: cs.queryZodText ?? null,
+      zodRef: cs.queryZodRef ?? null
+    };
+    if (!hasSource(body) && !hasSource(query)) continue;
+    const { method, full } = deriveBaseName(route.name);
+    methodNameCounts.set(method, (methodNameCounts.get(method) ?? 0) + 1);
+    candidates.push({
+      routeName: route.name,
+      baseName: full,
+      // resolved below
+      body: hasSource(body) ? body : void 0,
+      query: hasSource(query) ? query : void 0,
+      nestedSchemas: cs.formNestedSchemas ?? null,
+      warnings: cs.formWarnings ?? []
+    });
+  }
+  const entries = candidates.map((c) => {
+    const { method, full } = deriveBaseName(c.routeName);
+    const collision = (methodNameCounts.get(method) ?? 0) > 1;
+    return { ...c, baseName: collision ? full : method };
+  });
+  if (entries.length === 0) return null;
+  const importsByFile = /* @__PURE__ */ new Map();
+  const refAlias = /* @__PURE__ */ new Map();
+  for (const entry of entries) {
+    for (const src of [entry.body, entry.query]) {
+      if (src?.zodRef && !src.zodText && !src.schema) {
+        const root = refRootIdentifier(src.zodRef.name);
+        const set = importsByFile.get(src.zodRef.filePath) ?? /* @__PURE__ */ new Set();
+        set.add(root);
+        importsByFile.set(src.zodRef.filePath, set);
+      }
+    }
+  }
+  const importLines = [];
+  if (importsByFile.size > 0) {
+    const emitted = /* @__PURE__ */ new Set();
+    for (const [filePath, roots] of [...importsByFile.entries()].sort()) {
+      const relPath = relImport(outDir, filePath);
+      const specifiers = [];
+      for (const root of [...roots].sort()) {
+        if (emitted.has(root)) {
+          const alias = `${root}_${emitted.size}`;
+          specifiers.push(`${root} as ${alias}`);
+          emitted.add(alias);
+          refAlias.set(`${filePath}\0${root}`, alias);
+        } else {
+          specifiers.push(root);
+          emitted.add(root);
+          refAlias.set(`${filePath}\0${root}`, root);
+        }
+      }
+      importLines.push(`import { ${specifiers.join(", ")} } from '${relPath}';`);
+    }
+  }
+  const { globalSchemas, renamesByEntry } = planNestedSchemas(entries);
+  const irNamed = /* @__PURE__ */ new Map();
+  const irTypeAliases = /* @__PURE__ */ new Map();
+  const irAnnotations = /* @__PURE__ */ new Map();
+  const decls = [];
+  const mapEntries = [];
+  let used = false;
+  const renderSource = (src, rename) => {
+    if (src.schema) {
+      const r = adapter.renderModule(src.schema);
+      for (const [n, t] of r.namedNestedSchemas) irNamed.set(n, t);
+      if (r.namedTypeAliases) for (const [n, t] of r.namedTypeAliases) irTypeAliases.set(n, t);
+      if (r.namedAnnotations) for (const [n, a] of r.namedAnnotations) irAnnotations.set(n, a);
+      return { text: r.schemaText };
+    }
+    if (src.zodText) {
+      if (!acceptsRawZod) {
+        return {
+          text: "",
+          warn: `is a defineContract (zod) schema; not translated to ${adapter.name} \u2014 use the zod adapter.`
+        };
+      }
+      return { text: applyRenames(src.zodText, rename) };
+    }
+    if (src.zodRef) {
+      if (!acceptsRawZod) {
+        return {
+          text: "",
+          warn: `is a defineContract (zod) schema; not translated to ${adapter.name} \u2014 use the zod adapter.`
+        };
+      }
+      const root = refRootIdentifier(src.zodRef.name);
+      const alias = refAlias.get(`${src.zodRef.filePath}\0${root}`) ?? root;
+      const member = src.zodRef.name.slice(root.length);
+      return { text: `${alias}${member}` };
+    }
+    return null;
+  };
+  for (const entry of entries) {
+    const block = [];
+    const rename = renamesByEntry.get(entry) ?? null;
+    let bodyConst;
+    if (entry.warnings && entry.warnings.length > 0) {
+      for (const w of entry.warnings) block.push(`// warning: ${w}`);
+    }
+    if (entry.body) {
+      const rendered = renderSource(entry.body, rename);
+      if (rendered?.warn) {
+        block.push(`// warning: ${entry.routeName} body ${rendered.warn}`);
+      } else if (rendered) {
+        used = true;
+        bodyConst = `${entry.baseName}BodySchema`;
+        block.push(`export const ${bodyConst} = ${rendered.text};`);
+        block.push(`export type ${entry.baseName}Body = ${adapter.inferType(bodyConst)};`);
+      }
+    }
+    if (entry.query) {
+      const rendered = renderSource(entry.query, rename);
+      if (rendered?.warn) {
+        block.push(`// warning: ${entry.routeName} query ${rendered.warn}`);
+      } else if (rendered) {
+        used = true;
+        const queryConst = `${entry.baseName}QuerySchema`;
+        block.push(`export const ${queryConst} = ${rendered.text};`);
+        block.push(`export type ${entry.baseName}Query = ${adapter.inferType(queryConst)};`);
+      }
+    }
+    if (block.length === 0) continue;
+    decls.push(`// ${entry.routeName}`, ...block, "");
+    if (bodyConst) mapEntries.push(`  ${JSON.stringify(entry.routeName)}: ${bodyConst},`);
+  }
+  if (!used) return null;
+  const lines = ["// Generated by @dudousxd/nestjs-codegen. Do not edit."];
+  if (acceptsRawZod) {
+    const zodImport = config?.zodImport ?? "zod";
+    lines.push(`import { z } from '${zodImport}';`);
+  } else {
+    for (const imp of adapter.importStatements({ used: true })) lines.push(imp);
+  }
+  lines.push(...importLines);
+  lines.push("");
+  const allNested = /* @__PURE__ */ new Map();
+  for (const [n, t] of globalSchemas) allNested.set(n, t);
+  for (const [n, t] of irNamed) if (!allNested.has(n)) allNested.set(n, t);
+  if (allNested.size > 0) {
+    lines.push("// Hoisted nested schemas (shared across endpoints).");
+    for (const [n, alias] of irTypeAliases) {
+      if (allNested.has(n)) lines.push(`${alias};`);
+    }
+    for (const [n, t] of allNested) {
+      const annotation = irAnnotations.get(n);
+      lines.push(`const ${n}${annotation ? `: ${annotation}` : ""} = ${t};`);
+    }
+    lines.push("");
   }
-  return "z.unknown()";
+  lines.push(...decls);
+  lines.push("/** Route name \u2192 body schema map. */");
+  lines.push("export const formSchemas = {");
+  lines.push(...mapEntries);
+  lines.push("} as const;");
+  lines.push("");
+  return lines.join("\n");
 }
 
 // src/emit/emit-index.ts
 import { mkdir as mkdir4, writeFile as writeFile4 } from "fs/promises";
-import { join as join7 } from "path";
+import { join as join8 } from "path";
 async function emitIndex(outDir, hasContracts = false, hasForms = false) {
   await mkdir4(outDir, { recursive: true });
   const exports = ["export * from './pages.js';", "export * from './routes.js';"];
@@ -3457,12 +3049,12 @@ async function emitIndex(outDir, hasContracts = false, hasForms = false) {
   const content = ["// Generated by @dudousxd/nestjs-codegen. Do not edit.", ...exports, ""].join(
     "\n"
   );
-  await writeFile4(join7(outDir, "index.d.ts"), content, "utf8");
+  await writeFile4(join8(outDir, "index.d.ts"), content, "utf8");
 }
 
 // src/emit/emit-pages.ts
 import { mkdir as mkdir5, writeFile as writeFile5 } from "fs/promises";
-import { join as join8, relative as relative5 } from "path";
+import { join as join9, relative as relative5 } from "path";
 async function emitPages(pages, outDir, _options = {}) {
   await mkdir5(outDir, { recursive: true });
   const pageNameUnion = pages.length > 0 ? pages.map((p) => JSON.stringify(p.name)).join(" | ") : "never";
@@ -3483,7 +3075,7 @@ ${augBody}
   }
 ${sharedPropsBlock}}
 `;
-  await writeFile5(join8(outDir, "pages.d.ts"), content, "utf8");
+  await writeFile5(join9(outDir, "pages.d.ts"), content, "utf8");
 }
 function buildSharedPropsBlock(sharedProps) {
   if (!sharedProps) return "";
@@ -3514,11 +3106,11 @@ function needsQuotes(name) {
 
 // src/emit/emit-routes.ts
 import { mkdir as mkdir6, writeFile as writeFile6 } from "fs/promises";
-import { join as join9 } from "path";
+import { join as join10 } from "path";
 async function emitRoutes(routes, outDir) {
   await mkdir6(outDir, { recursive: true });
   const content = buildRoutesFile(routes);
-  await writeFile6(join9(outDir, "routes.ts"), content, "utf8");
+  await writeFile6(join10(outDir, "routes.ts"), content, "utf8");
 }
 function buildRoutesFile(routes) {
   if (routes.length === 0) {
@@ -3646,30 +3238,7 @@ async function generate(config, inputRoutes = []) {
       propsExport: pagesConfig.propsExport,
       componentNameStrategy: pagesConfig.componentNameStrategy
     });
-    let sharedProps = null;
-    if (config.app?.moduleEntry) {
-      try {
-        const tsconfigPath = config.app.tsconfig ?? join10(config.codegen.cwd, "tsconfig.json");
-        let project;
-        try {
-          project = new Project3({
-            tsConfigFilePath: tsconfigPath,
-            skipAddingFilesFromTsConfig: true,
-            skipLoadingLibFiles: true,
-            skipFileDependencyResolution: true
-          });
-        } catch {
-          project = new Project3({
-            skipAddingFilesFromTsConfig: true,
-            skipLoadingLibFiles: true,
-            skipFileDependencyResolution: true,
-            compilerOptions: { allowJs: true, strict: false }
-          });
-        }
-        sharedProps = discoverSharedProps(project, config.app.moduleEntry);
-      } catch {
-      }
-    }
+    const sharedProps = discoverSharedPropsFromConfig(config);
     await emitPages(pages, config.codegen.outDir, {
       propsExport: pagesConfig.propsExport,
       sharedProps
@@ -3693,7 +3262,7 @@ async function generate(config, inputRoutes = []) {
   if (extensions.length > 0) {
     const extraFiles = await collectEmittedFiles(extensions, ctx);
     for (const file of extraFiles) {
-      const dest = join10(config.codegen.outDir, file.path);
+      const dest = join11(config.codegen.outDir, file.path);
       await mkdir7(dirname3(dest), { recursive: true });
       await writeFile7(dest, file.contents, "utf8");
     }
@@ -3703,7 +3272,7 @@ async function generate(config, inputRoutes = []) {
 // src/watch/lock-file.ts
 import { open } from "fs/promises";
 import { mkdir as mkdir8, readFile as readFile2, unlink } from "fs/promises";
-import { join as join11 } from "path";
+import { join as join12 } from "path";
 var LOCK_FILE = ".watcher.lock";
 function isProcessAlive(pid) {
   try {
@@ -3715,7 +3284,7 @@ function isProcessAlive(pid) {
 }
 async function acquireLock(outDir) {
   await mkdir8(outDir, { recursive: true });
-  const lockPath = join11(outDir, LOCK_FILE);
+  const lockPath = join12(outDir, LOCK_FILE);
   const lockData = { pid: process.pid, startedAt: (/* @__PURE__ */ new Date()).toISOString() };
   try {
     const fd = await open(lockPath, "wx");
@@ -3755,7 +3324,7 @@ async function watch(config, onChange) {
   if (lock === null) {
     let holderPid = "unknown";
     try {
-      const raw = await readFile3(join12(config.codegen.outDir, ".watcher.lock"), "utf8");
+      const raw = await readFile3(join13(config.codegen.outDir, ".watcher.lock"), "utf8");
       const data = JSON.parse(raw);
       if (data.pid !== void 0) holderPid = String(data.pid);
     } catch {
@@ -3783,7 +3352,7 @@ async function watch(config, onChange) {
   }
   let pagesDebounceTimer;
   const pagesGlob = config.pages?.glob ?? ".nestjs-codegen-no-pages";
-  const pagesWatcher = chokidar.watch(join12(config.codegen.cwd, pagesGlob), {
+  const pagesWatcher = chokidar.watch(join13(config.codegen.cwd, pagesGlob), {
     ignoreInitial: true,
     persistent: true,
     awaitWriteFinish: { stabilityThreshold: 80, pollInterval: 20 }
@@ -3809,7 +3378,7 @@ async function watch(config, onChange) {
   pagesWatcher.on("change", schedulePagesRegenerate);
   pagesWatcher.on("unlink", schedulePagesRegenerate);
   let contractsDebounceTimer;
-  const contractsWatcher = chokidar.watch(join12(config.codegen.cwd, config.contracts.glob), {
+  const contractsWatcher = chokidar.watch(join13(config.codegen.cwd, config.contracts.glob), {
     ignoreInitial: true,
     persistent: true,
     awaitWriteFinish: { stabilityThreshold: 80, pollInterval: 20 }
@@ -3839,7 +3408,7 @@ async function watch(config, onChange) {
   contractsWatcher.on("add", scheduleContractsRegenerate);
   contractsWatcher.on("change", scheduleContractsRegenerate);
   contractsWatcher.on("unlink", scheduleContractsRegenerate);
-  const formsWatcher = chokidar.watch(join12(config.codegen.cwd, config.forms.watch), {
+  const formsWatcher = chokidar.watch(join13(config.codegen.cwd, config.forms.watch), {
     ignoreInitial: true,
     persistent: true,
     awaitWriteFinish: { stabilityThreshold: 80, pollInterval: 20 }