@codewithagents/openapi-server 1.8.0 → 1.10.0

package/dist/cli.cjs

@@ -18844,10 +18844,14 @@ function parseServerConfig(raw, base) {
   if (raw["input_schema"] !== void 0 && (typeof raw["input_schema"] !== "string" || !raw["input_schema"])) {
     throw new Error('"input_schema" must be a non-empty string path to your Zod schema file');
   }
+  if (raw["context_type"] !== void 0 && (typeof raw["context_type"] !== "string" || !raw["context_type"])) {
+    throw new Error('"context_type" must be a non-empty string TypeScript type name');
+  }
   return {
     ...base,
     framework,
-    input_schema: raw["input_schema"]
+    input_schema: raw["input_schema"],
+    context_type: raw["context_type"]
   };
 }
 async function loadConfigs2(cwd, configPath) {
@@ -18943,6 +18947,7 @@ function schemaToTsType(schema) {
   const s = schema;
   if (s.type === "number" || s.type === "integer") return "number";
   if (s.type === "boolean") return "boolean";
+  if (s.type === "array") return "string[]";
   return "string";
 }
 function getQueryParams(operation, spec) {
@@ -18953,35 +18958,137 @@ function getQueryParams(operation, spec) {
     const resolved = resolveParam(p, spec);
     if (resolved === void 0 || resolved.in !== "query") continue;
     const schema = resolved.schema;
-    result.push({
+    const resolvedStyle = resolved.style;
+    const resolvedExplode = resolved.explode;
+    const param = {
       name: normalizeParamName(resolved.name),
+      rawName: resolved.name,
       tsType: schemaToTsType(schema),
       required: resolved.required === true
-    });
+    };
+    if (resolvedStyle === "deepObject" && schema !== void 0 && !isRef3(schema)) {
+      const s = schema;
+      if (s.type === "object" && s.properties !== void 0) {
+        param.isDeepObject = true;
+        param.deepObjectProperties = Object.entries(s.properties).map(([key, propSchema]) => ({
+          key,
+          tsType: schemaToTsType(propSchema)
+        }));
+        const propFields = param.deepObjectProperties.map((p2) => `${p2.key}?: ${p2.tsType}`).join("; ");
+        param.tsType = `{ ${propFields} }`;
+      }
+    }
+    if (!param.isDeepObject && schema !== void 0 && !isRef3(schema) && schema.type === "array" && resolvedExplode === false) {
+      if (resolvedStyle === "spaceDelimited") {
+        param.delimiterStyle = "ssv";
+      } else if (resolvedStyle === "pipeDelimited") {
+        param.delimiterStyle = "psv";
+      } else {
+        param.delimiterStyle = "csv";
+      }
+    }
+    if (schema !== void 0 && !isRef3(schema)) {
+      const s = schema;
+      if (Array.isArray(s.enum)) param.enum = s.enum;
+      if (typeof s.minimum === "number") param.minimum = s.minimum;
+      if (typeof s.maximum === "number") param.maximum = s.maximum;
+      if (typeof s.exclusiveMinimum === "number") param.exclusiveMinimum = s.exclusiveMinimum;
+      if (typeof s.exclusiveMaximum === "number") param.exclusiveMaximum = s.exclusiveMaximum;
+      if (typeof s.minLength === "number") param.minLength = s.minLength;
+      if (typeof s.maxLength === "number") param.maxLength = s.maxLength;
+      if (typeof s.pattern === "string") param.pattern = s.pattern;
+    }
+    result.push(param);
   }
   return result;
 }
 function getBodyInfo(operation) {
   const requestBody = operation.requestBody;
   if (requestBody === void 0) return void 0;
-  if (isRef3(requestBody)) return { typeName: void 0 };
+  if (isRef3(requestBody)) {
+    return { typeName: void 0, contentType: "application/json", isSynthesized: false };
+  }
   const rb = requestBody;
   const content = rb.content;
-  if (content === void 0) return { typeName: void 0 };
+  if (content === void 0) {
+    return { typeName: void 0, contentType: "application/json", isSynthesized: false };
+  }
   const jsonContent = content["application/json"];
-  if (jsonContent === void 0 || jsonContent.schema === void 0) return { typeName: void 0 };
-  const schema = jsonContent.schema;
-  if (isRef3(schema)) {
-    return { typeName: refToName(schema.$ref) };
+  if (jsonContent !== void 0 && jsonContent.schema !== void 0) {
+    const schema = jsonContent.schema;
+    if (isRef3(schema)) {
+      return {
+        typeName: refToName(schema.$ref),
+        contentType: "application/json",
+        isSynthesized: false
+      };
+    }
+    const operationId = operation.operationId;
+    if (operationId !== void 0 && operationId.length > 0) {
+      return { typeName: toTypeName(operationId), contentType: "application/json", isSynthesized: true };
+    }
+    return { typeName: void 0, contentType: "application/json", isSynthesized: false };
+  }
+  const formContent = content["application/x-www-form-urlencoded"];
+  if (formContent !== void 0) {
+    const schema = formContent.schema;
+    if (schema !== void 0 && isRef3(schema)) {
+      return {
+        typeName: refToName(schema.$ref),
+        contentType: "application/x-www-form-urlencoded",
+        isSynthesized: false
+      };
+    }
+    const operationId = operation.operationId;
+    if (operationId !== void 0 && operationId.length > 0) {
+      return {
+        typeName: toTypeName(operationId),
+        contentType: "application/x-www-form-urlencoded",
+        isSynthesized: true
+      };
+    }
+    return { typeName: void 0, contentType: "application/x-www-form-urlencoded", isSynthesized: false };
+  }
+  const multipartContent = content["multipart/form-data"];
+  if (multipartContent !== void 0) {
+    const schema = multipartContent.schema;
+    if (schema !== void 0 && isRef3(schema)) {
+      return {
+        typeName: refToName(schema.$ref),
+        contentType: "multipart/form-data",
+        isSynthesized: false
+      };
+    }
+    const operationId = operation.operationId;
+    if (operationId !== void 0 && operationId.length > 0) {
+      return {
+        typeName: toTypeName(operationId),
+        contentType: "multipart/form-data",
+        isSynthesized: true
+      };
+    }
+    return { typeName: void 0, contentType: "multipart/form-data", isSynthesized: false };
+  }
+  const octetContent = content["application/octet-stream"];
+  if (octetContent !== void 0) {
+    return { typeName: void 0, contentType: "application/octet-stream", isSynthesized: false };
   }
-  return { typeName: void 0 };
+  return { typeName: void 0, contentType: "application/json", isSynthesized: false };
 }
 
 // src/plugins/service.ts
+function collectContentfulTwoxxCodes(responses) {
+  return Object.keys(responses).filter((k) => /^2\d\d$/.test(k) && k !== "204").sort();
+}
 function getReturnInfo(operation) {
   const responses = operation.responses;
   if (responses === void 0) return { typeName: void 0, isArray: false, isVoid: true };
-  for (const code of ["200", "201"]) {
+  const contentfulCodes = collectContentfulTwoxxCodes(responses);
+  const isMultiStatus = contentfulCodes.length > 1;
+  const twoxxCodes = ["200", "201", ...Object.keys(responses).filter(
+    (k) => /^2\d\d$/.test(k) && k !== "200" && k !== "201" && k !== "204"
+  )];
+  for (const code of twoxxCodes) {
     const response = responses[code];
     if (response === void 0) continue;
     if (isRef3(response)) continue;
@@ -18989,28 +19096,37 @@ function getReturnInfo(operation) {
     const content = resp.content;
     if (content === void 0) continue;
     const jsonContent = content["application/json"];
-    if (jsonContent === void 0 || jsonContent.schema === void 0) continue;
-    const schema = jsonContent.schema;
-    if (isRef3(schema)) {
-      return {
-        typeName: refToName(schema.$ref),
-        isArray: false,
-        isVoid: false
-      };
-    }
-    const s = schema;
-    if (s.type === "array") {
-      const items = s.items;
-      if (items !== void 0 && isRef3(items)) {
+    if (jsonContent !== void 0 && jsonContent.schema !== void 0) {
+      const schema = jsonContent.schema;
+      if (isRef3(schema)) {
         return {
-          typeName: refToName(items.$ref),
-          isArray: true,
-          isVoid: false
+          typeName: refToName(schema.$ref),
+          isArray: false,
+          isVoid: false,
+          isMultiStatus
         };
       }
-      return { typeName: void 0, isArray: true, isVoid: false };
+      const s = schema;
+      if (s.type === "array") {
+        const items = s.items;
+        if (items !== void 0 && isRef3(items)) {
+          return {
+            typeName: refToName(items.$ref),
+            isArray: true,
+            isVoid: false,
+            isMultiStatus
+          };
+        }
+        return { typeName: void 0, isArray: true, isVoid: false, isMultiStatus };
+      }
+      return { typeName: void 0, isArray: false, isVoid: false, isMultiStatus };
+    }
+    if (content["text/plain"] !== void 0) {
+      return { typeName: void 0, isArray: false, isVoid: false, primitiveType: "string" };
+    }
+    if (content["application/octet-stream"] !== void 0) {
+      return { typeName: void 0, isArray: false, isVoid: false, primitiveType: "Uint8Array" };
     }
-    return { typeName: void 0, isArray: false, isVoid: false };
   }
   if (responses["204"] !== void 0) {
     return { typeName: void 0, isArray: false, isVoid: true };
@@ -19019,6 +19135,16 @@ function getReturnInfo(operation) {
 }
 function buildReturnType(info) {
   if (info.isVoid) return "Promise<void>";
+  if (info.primitiveType !== void 0) return `Promise<${info.primitiveType}>`;
+  if (info.isMultiStatus === true) {
+    let bodyType;
+    if (info.typeName !== void 0) {
+      bodyType = info.isArray ? `${info.typeName}[]` : info.typeName;
+    } else {
+      bodyType = info.isArray ? "unknown[]" : "unknown";
+    }
+    return `Promise<{ status: number; body: ${bodyType} }>`;
+  }
   if (info.typeName !== void 0) {
     return info.isArray ? `Promise<${info.typeName}[]>` : `Promise<${info.typeName}>`;
   }
@@ -19037,6 +19163,11 @@ function collectOperations(spec) {
       const queryParams = getQueryParams(operation, spec);
       const bodyInfo = getBodyInfo(operation);
       const returnInfo = getReturnInfo(operation);
+      if (returnInfo.typeName === void 0 && !returnInfo.isVoid && returnInfo.primitiveType === void 0) {
+        console.warn(
+          `${methodName} (${method.toUpperCase()} ${path}): response type is unknown, no named response schema could be resolved from the spec. Add a named $ref response schema to get a typed return type and enable runtime validation.`
+        );
+      }
       operations.push({
         methodName,
         httpMethod: method,
@@ -19050,13 +19181,13 @@ function collectOperations(spec) {
   }
   return operations;
 }
-function buildMethodSignature(op) {
+function buildMethodSignature(op, options) {
   const args = [];
   for (const p of op.pathParams) {
     args.push(`${sanitizeOperationId2(p)}: string`);
   }
   if (op.bodyInfo !== void 0) {
-    const typeName = op.bodyInfo.typeName ?? "unknown";
+    const typeName = op.bodyInfo.typeName !== void 0 && !op.bodyInfo.isSynthesized ? op.bodyInfo.typeName : "unknown";
     args.push(`body: ${typeName}`);
   }
   if (op.queryParams.length > 0) {
@@ -19065,16 +19196,19 @@ function buildMethodSignature(op) {
     const paramsToken = allOptional ? "params?" : "params";
     args.push(`${paramsToken}: { ${fields} }`);
   }
+  if (options?.contextType !== void 0) {
+    args.push("ctx: Ctx");
+  }
   const returnType = buildReturnType(op.returnInfo);
   const argStr = args.join(", ");
   return `${op.methodName}(${argStr}): ${returnType}`;
 }
-function generateService(spec) {
+function generateService(spec, options) {
   const serviceName = deriveServiceName(spec);
   const operations = collectOperations(spec);
   const importTypes = /* @__PURE__ */ new Set();
   for (const op of operations) {
-    if (op.bodyInfo?.typeName !== void 0) {
+    if (op.bodyInfo?.typeName !== void 0 && !op.bodyInfo.isSynthesized) {
       importTypes.add(op.bodyInfo.typeName);
     }
     if (op.returnInfo.typeName !== void 0) {
@@ -19089,10 +19223,11 @@ function generateService(spec) {
     lines.push(`import type { ${sortedImports.join(", ")} } from './models.js'`);
     lines.push("");
   }
-  lines.push(`export interface ${serviceName} {`);
+  const interfaceDecl = options?.contextType !== void 0 ? `export interface ${serviceName}<Ctx = never> {` : `export interface ${serviceName} {`;
+  lines.push(interfaceDecl);
   for (const op of operations) {
     lines.push(`  /** ${op.httpMethod.toUpperCase()} ${op.path} */`);
-    lines.push(`  ${buildMethodSignature(op)}`);
+    lines.push(`  ${buildMethodSignature(op, options)}`);
   }
   lines.push("}");
   lines.push("");
@@ -19124,6 +19259,21 @@ function formatToZodModifier(format) {
 function pathParamZodExpr(schema) {
   if (schema === void 0 || isRef3(schema)) return void 0;
   const s = schema;
+  if (s.type === "integer" || s.type === "number") {
+    const hasMin = typeof s.minimum === "number";
+    const hasMax = typeof s.maximum === "number";
+    const hasExcMin = typeof s.exclusiveMinimum === "number";
+    const hasExcMax = typeof s.exclusiveMaximum === "number";
+    if (hasMin || hasMax || hasExcMin || hasExcMax) {
+      let expr = "z.coerce.number()";
+      if (hasMin) expr += `.min(${s.minimum})`;
+      if (hasMax) expr += `.max(${s.maximum})`;
+      if (hasExcMin) expr += `.gt(${s.exclusiveMinimum})`;
+      if (hasExcMax) expr += `.lt(${s.exclusiveMaximum})`;
+      return expr;
+    }
+    return void 0;
+  }
   if (s.type !== "string") return void 0;
   const format = s.format;
   if (format === void 0) return void 0;
@@ -19131,23 +19281,64 @@ function pathParamZodExpr(schema) {
   if (modifier === "") return void 0;
   return `z.string()${modifier}`;
 }
-function paramZodExpr(tsType, required, schema) {
+function queryParamDelimitedZodBase(_param) {
+  return "z.array(z.string())";
+}
+function queryParamDeepObjectZodBase(param) {
+  const propFields = (param.deepObjectProperties ?? []).map((p) => {
+    const coerced = p.tsType === "number" ? "z.coerce.number()" : "z.string()";
+    return `${p.key}: ${coerced}.optional()`;
+  });
+  return `z.object({ ${propFields.join(", ")} })`;
+}
+function queryParamNumberZodBase(param) {
+  let base = "z.coerce.number()";
+  if (param.minimum !== void 0) base += `.min(${param.minimum})`;
+  if (param.maximum !== void 0) base += `.max(${param.maximum})`;
+  if (param.exclusiveMinimum !== void 0) base += `.gt(${param.exclusiveMinimum})`;
+  if (param.exclusiveMaximum !== void 0) base += `.lt(${param.exclusiveMaximum})`;
+  return base;
+}
+function queryParamStringZodBase(param) {
+  let base;
+  if (param.enum !== void 0 && param.enum.length > 0) {
+    const members = param.enum.map((v) => JSON.stringify(v)).join(", ");
+    base = `z.enum([${members}])`;
+  } else {
+    base = "z.string()";
+  }
+  if (param.minLength !== void 0) base += `.min(${param.minLength})`;
+  if (param.maxLength !== void 0) base += `.max(${param.maxLength})`;
+  if (param.pattern !== void 0) base += `.regex(/${param.pattern}/)`;
+  return base;
+}
+function queryParamZodExpr(param) {
   let base;
-  if (tsType === "number") {
-    base = "z.number()";
-  } else if (tsType === "boolean") {
+  if (param.delimiterStyle !== void 0) {
+    base = queryParamDelimitedZodBase(param);
+  } else if (param.isDeepObject === true && param.deepObjectProperties !== void 0) {
+    base = queryParamDeepObjectZodBase(param);
+  } else if (param.tsType === "number") {
+    base = queryParamNumberZodBase(param);
+  } else if (param.tsType === "boolean") {
     base = "z.boolean()";
   } else {
-    if (schema !== void 0 && !isRef3(schema)) {
-      const s = schema;
-      const format = s.format;
-      const modifier = format !== void 0 ? formatToZodModifier(format) : "";
-      base = `z.string()${modifier}`;
-    } else {
-      base = "z.string()";
-    }
+    base = queryParamStringZodBase(param);
   }
-  return required ? base : `${base}.optional()`;
+  return param.required ? base : `${base}.optional()`;
+}
+function headerParamZodExpr(param) {
+  let base;
+  if (param.enum !== void 0 && param.enum.length > 0) {
+    const members = param.enum.map((v) => JSON.stringify(v)).join(", ");
+    base = `z.enum([${members}])`;
+  } else {
+    base = "z.string()";
+  }
+  if (param.minLength !== void 0) base += `.min(${param.minLength})`;
+  if (param.maxLength !== void 0) base += `.max(${param.maxLength})`;
+  if (param.pattern !== void 0) base += `.regex(/${param.pattern}/)`;
+  return param.required ? base : `${base}.optional()`;
 }
 function getPathParamValidations(operation, spec, rawPathParamNames) {
   const parameters = operation.parameters;
@@ -19167,6 +19358,19 @@ function getPathParamValidations(operation, spec, rawPathParamNames) {
   }
   return result;
 }
+function cookieParamZodExpr(param) {
+  let base;
+  if (param.enum !== void 0 && param.enum.length > 0) {
+    const members = param.enum.map((v) => JSON.stringify(v)).join(", ");
+    base = `z.enum([${members}])`;
+  } else {
+    base = "z.string()";
+  }
+  if (param.minLength !== void 0) base += `.min(${param.minLength})`;
+  if (param.maxLength !== void 0) base += `.max(${param.maxLength})`;
+  if (param.pattern !== void 0) base += `.regex(/${param.pattern}/)`;
+  return param.required ? base : `${base}.optional()`;
+}
 function getHeaderParams(operation, spec) {
   const parameters = operation.parameters;
   if (parameters === void 0) return [];
@@ -19174,21 +19378,74 @@ function getHeaderParams(operation, spec) {
   for (const p of parameters) {
     const resolved = resolveParam(p, spec);
     if (resolved === void 0 || resolved.in !== "header") continue;
-    result.push({
+    const param = {
       rawName: resolved.name,
       required: resolved.required === true
-    });
+    };
+    const schema = resolved.schema;
+    if (schema !== void 0 && !isRef3(schema)) {
+      const s = schema;
+      if (Array.isArray(s.enum)) param.enum = s.enum;
+      if (typeof s.minLength === "number") param.minLength = s.minLength;
+      if (typeof s.maxLength === "number") param.maxLength = s.maxLength;
+      if (typeof s.pattern === "string") param.pattern = s.pattern;
+    }
+    result.push(param);
   }
   return result;
 }
+function getCookieParams(operation, spec) {
+  const parameters = operation.parameters;
+  if (parameters === void 0) return [];
+  const result = [];
+  for (const p of parameters) {
+    const resolved = resolveParam(p, spec);
+    if (resolved === void 0 || resolved.in !== "cookie") continue;
+    const param = {
+      rawName: resolved.name,
+      required: resolved.required === true
+    };
+    const schema = resolved.schema;
+    if (schema !== void 0 && !isRef3(schema)) {
+      const s = schema;
+      if (Array.isArray(s.enum)) param.enum = s.enum;
+      if (typeof s.minLength === "number") param.minLength = s.minLength;
+      if (typeof s.maxLength === "number") param.maxLength = s.maxLength;
+      if (typeof s.pattern === "string") param.pattern = s.pattern;
+    }
+    result.push(param);
+  }
+  return result;
+}
+function queryParamHasConstraints(q) {
+  const constraintFields = [
+    q.enum,
+    q.minimum,
+    q.maximum,
+    q.exclusiveMinimum,
+    q.exclusiveMaximum,
+    q.minLength,
+    q.maxLength,
+    q.pattern,
+    q.delimiterStyle
+  ];
+  return constraintFields.some((f) => f !== void 0) || q.isDeepObject === true;
+}
 function queryParamsNeedValidation(queryParams) {
-  return queryParams.some((q) => q.required || q.tsType !== "string");
+  return queryParams.some(
+    (q) => q.required || q.tsType !== "string" || queryParamHasConstraints(q)
+  );
+}
+function delimiterChar(style) {
+  if (style === "ssv") return " ";
+  if (style === "psv") return "|";
+  return ",";
 }
 function emitQueryValidation(lines, queryParams, indent) {
   const inner = `${indent}  `;
   const fieldIndent = `${indent}    `;
   const fields = queryParams.map((q) => {
-    const expr = paramZodExpr(q.tsType, q.required);
+    const expr = queryParamZodExpr(q);
     return `${fieldIndent}${q.name}: ${expr}`;
   }).join(",\n");
   lines.push(`${inner}// Validate query parameters: returns 422 with Zod issues on failure`);
@@ -19209,7 +19466,7 @@ function emitPathValidation(lines, validations, indent, framework) {
     if (framework === "hono") {
       access = `c.req.param(${JSON.stringify(v.rawName)})`;
     } else if (framework === "express") {
-      access = `req.params[${JSON.stringify(v.rawName)}]`;
+      access = `req.params[${JSON.stringify(v.rawName)}] as string`;
     } else {
       access = /[^a-zA-Z0-9_$]/.test(v.rawName) ? `req.params[${JSON.stringify(v.rawName)}]` : `req.params.${v.rawName}`;
     }
@@ -19227,18 +19484,19 @@ function emitHeaderValidation(lines, headerParams, indent, framework) {
   const fieldIndent = `${indent}    `;
   const schemaFields = headerParams.map((h) => {
     const key = JSON.stringify(h.rawName);
-    const expr = h.required ? "z.string()" : "z.string().optional()";
+    const expr = headerParamZodExpr(h);
     return `${fieldIndent}${key}: ${expr}`;
   }).join(",\n");
   const rawFields = headerParams.map((h) => {
     const key = JSON.stringify(h.rawName);
+    const lookupKey = JSON.stringify(h.rawName.toLowerCase());
     let access;
     if (framework === "hono") {
       access = `c.req.header(${key})`;
     } else if (framework === "express") {
-      access = `req.headers[${key}] as string | undefined`;
+      access = `req.headers[${lookupKey}] as string | undefined`;
     } else {
-      access = `req.headers[${key}]`;
+      access = `req.headers[${lookupKey}]`;
     }
     return `${fieldIndent}${key}: ${access}`;
   }).join(",\n");
@@ -19249,24 +19507,124 @@ function emitHeaderValidation(lines, headerParams, indent, framework) {
   lines.push(rawFields);
   lines.push(`${inner}})`);
 }
+function emitCookieValidation(lines, cookieParams, indent, framework) {
+  const inner = `${indent}  `;
+  const fieldIndent = `${indent}    `;
+  const schemaFields = cookieParams.map((ck) => {
+    const key = JSON.stringify(ck.rawName);
+    const expr = cookieParamZodExpr(ck);
+    return `${fieldIndent}${key}: ${expr}`;
+  }).join(",\n");
+  const rawFields = cookieParams.map((ck) => {
+    const key = JSON.stringify(ck.rawName);
+    let access;
+    if (framework === "hono") {
+      access = `getCookie(c, ${key})`;
+    } else if (framework === "express") {
+      access = `req.cookies[${key}] as string | undefined`;
+    } else {
+      access = `req.cookies[${key}]`;
+    }
+    return `${fieldIndent}${key}: ${access}`;
+  }).join(",\n");
+  lines.push(`${inner}// Validate request cookies: returns 422 with Zod issues on failure`);
+  lines.push(`${inner}const _ckv = z.object({`);
+  lines.push(schemaFields);
+  lines.push(`${inner}}).safeParse({`);
+  lines.push(rawFields);
+  lines.push(`${inner}})`);
+}
 function response200IsVoid(resp) {
   if (isRef3(resp)) return false;
   const r = resp;
   const content = r.content;
   return content === void 0 || Object.keys(content).length === 0;
 }
+function detectResponseContentType(resp) {
+  if (isRef3(resp)) return "application/json";
+  const r = resp;
+  const content = r.content;
+  if (content === void 0) return "application/json";
+  if ("text/plain" in content) return "text/plain";
+  if ("application/octet-stream" in content) return "application/octet-stream";
+  return "application/json";
+}
 function getResponseStatus(operation, httpMethod) {
   const responses = operation.responses;
   if (responses === void 0) {
-    return httpMethod === "delete" ? { status: 204, isVoid: true } : { status: 200, isVoid: false };
+    return httpMethod === "delete" ? { status: 204, isVoid: true, responseContentType: "application/json" } : { status: 200, isVoid: false, responseContentType: "application/json" };
+  }
+  const contentfulTwoxxKeys = Object.keys(responses).filter((k) => /^2\d\d$/.test(k) && k !== "204").sort();
+  if (contentfulTwoxxKeys.length > 1) {
+    return {
+      status: 200,
+      isVoid: false,
+      responseContentType: "application/json",
+      isMultiStatus: true
+    };
+  }
+  if (responses["201"] !== void 0) {
+    return {
+      status: 201,
+      isVoid: false,
+      responseContentType: detectResponseContentType(responses["201"])
+    };
+  }
+  if (responses["204"] !== void 0) {
+    return { status: 204, isVoid: true, responseContentType: "application/json" };
   }
-  if (responses["201"] !== void 0) return { status: 201, isVoid: false };
-  if (responses["204"] !== void 0) return { status: 204, isVoid: true };
   if (responses["200"] !== void 0) {
-    if (response200IsVoid(responses["200"])) return { status: 204, isVoid: true };
-    return { status: 200, isVoid: false };
+    if (response200IsVoid(responses["200"])) {
+      return { status: 204, isVoid: true, responseContentType: "application/json" };
+    }
+    return {
+      status: 200,
+      isVoid: false,
+      responseContentType: detectResponseContentType(responses["200"])
+    };
   }
-  return httpMethod === "delete" ? { status: 204, isVoid: true } : { status: 200, isVoid: false };
+  const twoxxKeys = Object.keys(responses).filter(
+    (k) => /^2\d\d$/.test(k) && k !== "200" && k !== "201" && k !== "204"
+  );
+  if (twoxxKeys.length === 1) {
+    const code = parseInt(twoxxKeys[0], 10);
+    const resp = responses[twoxxKeys[0]];
+    const isVoid = isRef3(resp) ? false : (() => {
+      const r = resp;
+      const content = r.content;
+      return content === void 0 || Object.keys(content).length === 0;
+    })();
+    return { status: code, isVoid, responseContentType: detectResponseContentType(resp) };
+  }
+  return httpMethod === "delete" ? { status: 204, isVoid: true, responseContentType: "application/json" } : { status: 200, isVoid: false, responseContentType: "application/json" };
+}
+function getResponseTypeName(operation) {
+  const responses = operation.responses;
+  if (responses === void 0) return void 0;
+  const priority = ["200", "201", ...Object.keys(responses).filter(
+    (k) => /^2\d\d$/.test(k) && k !== "200" && k !== "201" && k !== "204"
+  )];
+  for (const code of priority) {
+    const response = responses[code];
+    if (response === void 0 || isRef3(response)) continue;
+    const resp = response;
+    const content = resp.content;
+    if (content === void 0) continue;
+    const jsonContent = content["application/json"];
+    if (jsonContent === void 0 || jsonContent.schema === void 0) continue;
+    const schema = jsonContent.schema;
+    if (isRef3(schema)) {
+      return { typeName: refToName(schema.$ref), isArray: false };
+    }
+    const s = schema;
+    if (s.type === "array" && s.items !== void 0 && isRef3(s.items)) {
+      return {
+        typeName: refToName(s.items.$ref),
+        isArray: true
+      };
+    }
+  }
+  return void 0;
 }
 function collectOperations2(spec) {
   const paths = spec.paths;
@@ -19281,8 +19639,10 @@ function collectOperations2(spec) {
       const pathParamValidations = getPathParamValidations(operation, spec, pathParams);
       const queryParams = getQueryParams(operation, spec);
       const headerParams = getHeaderParams(operation, spec);
+      const cookieParams = getCookieParams(operation, spec);
       const bodyInfo = getBodyInfo(operation);
       const responseStatus = getResponseStatus(operation, method);
+      const responseTypeInfo = getResponseTypeName(operation);
       operations.push({
         methodName,
         httpMethod: method,
@@ -19292,8 +19652,11 @@ function collectOperations2(spec) {
         pathParamValidations,
         queryParams,
         headerParams,
+        cookieParams,
         bodyInfo,
-        responseStatus
+        responseStatus,
+        responseTypeName: responseTypeInfo?.typeName,
+        responseIsArray: responseTypeInfo?.isArray
       });
     }
   }
@@ -19302,7 +19665,9 @@ function collectOperations2(spec) {
 function collectSortedBodyTypes(operations) {
   const bodyTypes = /* @__PURE__ */ new Set();
   for (const op of operations) {
-    if (op.bodyInfo?.typeName !== void 0) bodyTypes.add(op.bodyInfo.typeName);
+    if (op.bodyInfo?.typeName !== void 0 && !op.bodyInfo.isSynthesized) {
+      bodyTypes.add(op.bodyInfo.typeName);
+    }
   }
   return Array.from(bodyTypes).sort();
 }
@@ -19316,13 +19681,27 @@ function collectUsedSchemaNames(operations, schemaNames) {
   }
   return used;
 }
+function collectUsedResponseSchemaNames(operations, schemaNames) {
+  const used = /* @__PURE__ */ new Set();
+  for (const op of operations) {
+    if (op.responseTypeName === void 0) continue;
+    if (op.responseStatus.isMultiStatus === true) continue;
+    const schemaName = `${op.responseTypeName}Schema`;
+    if (schemaNames.has(schemaName)) used.add(schemaName);
+  }
+  return used;
+}
 function collectGeneratorSetup(operations, options) {
   const sortedBodyTypes = collectSortedBodyTypes(operations);
   const usedSchemaNames = options?.schemaNames !== void 0 ? collectUsedSchemaNames(operations, options.schemaNames) : /* @__PURE__ */ new Set();
-  const needsZod = usedSchemaNames.size > 0 && options?.schemaImportPath !== void 0 || operationsNeedZodForParams(operations);
-  return { sortedBodyTypes, usedSchemaNames, needsZod };
+  const usedResponseSchemaNames = options?.schemaNames !== void 0 ? collectUsedResponseSchemaNames(operations, options.schemaNames) : /* @__PURE__ */ new Set();
+  const hasArrayResponseSchema = usedResponseSchemaNames.size > 0 && operations.some(
+    (op) => op.responseIsArray === true && op.responseTypeName !== void 0 && usedResponseSchemaNames.has(`${op.responseTypeName}Schema`)
+  );
+  const needsZod = usedSchemaNames.size > 0 && options?.schemaImportPath !== void 0 || operationsNeedZodForParams(operations) || usedResponseSchemaNames.size > 0 && options?.schemaImportPath !== void 0 && hasArrayResponseSchema;
+  return { sortedBodyTypes, usedSchemaNames, usedResponseSchemaNames, needsZod };
 }
-function buildRouteHandler(op, indent, schemaNames) {
+function buildRouteHandler(op, indent, schemaNames, contextType) {
   const lines = [];
   lines.push(`${indent}app.${op.httpMethod}(${JSON.stringify(op.honoPath)}, async (c) => {`);
   if (op.pathParamValidations.length > 0) {
@@ -19334,7 +19713,27 @@ function buildRouteHandler(op, indent, schemaNames) {
     lines.push(`${indent}  }`);
   }
   if (op.queryParams.length > 0) {
+    const deepObjectParams = op.queryParams.filter((q) => q.isDeepObject === true);
+    if (deepObjectParams.length > 0) {
+      lines.push(`${indent}  const _dq = c.req.queries()`);
+      for (const q of deepObjectParams) {
+        const prefixLen = q.rawName.length + 1;
+        const bracketPrefix = q.rawName + "[";
+        lines.push(`${indent}  const ${q.name} = Object.fromEntries(`);
+        lines.push(
+          `${indent}    Object.entries(_dq).filter(([k]) => k.startsWith('${bracketPrefix}') && k.endsWith(']')).map(([k, vs]) => [k.slice(${prefixLen}, -1), vs[0]])`
+        );
+        lines.push(`${indent}  )`);
+      }
+    }
     const fields = op.queryParams.map((q) => {
+      if (q.isDeepObject === true) {
+        return `    ${q.name}`;
+      }
+      if (q.delimiterStyle !== void 0) {
+        const delim = JSON.stringify(delimiterChar(q.delimiterStyle));
+        return `    ${q.name}: c.req.query('${q.rawName}') !== undefined ? c.req.query('${q.rawName}')!.split(${delim}) : undefined`;
+      }
       if (q.tsType === "number") {
         return `    ${q.name}: c.req.query('${q.name}') !== undefined ? Number(c.req.query('${q.name}')) : undefined`;
       }
@@ -19360,10 +19759,42 @@ function buildRouteHandler(op, indent, schemaNames) {
     );
     lines.push(`${indent}  }`);
   }
+  if (op.cookieParams.length > 0) {
+    emitCookieValidation(lines, op.cookieParams, indent, "hono");
+    lines.push(`${indent}  if (!_ckv.success) {`);
+    lines.push(
+      `${indent}    return c.json({ error: 'Invalid request cookies', issues: _ckv.error.issues }, 422)`
+    );
+    lines.push(`${indent}  }`);
+  }
   let bodyVarName = "body";
   if (op.bodyInfo !== void 0) {
-    const typeAnnotation = op.bodyInfo.typeName !== void 0 ? `<${op.bodyInfo.typeName}>` : "";
-    lines.push(`${indent}  const body = await c.req.json${typeAnnotation}()`);
+    const typeDecl = op.bodyInfo.typeName !== void 0 && !op.bodyInfo.isSynthesized ? op.bodyInfo.typeName : "unknown";
+    if (op.bodyInfo.contentType === "application/x-www-form-urlencoded") {
+      lines.push(`${indent}  const _ct = c.req.header('content-type') ?? ''`);
+      lines.push(
+        `${indent}  if (!_ct.toLowerCase().startsWith('application/x-www-form-urlencoded')) {`
+      );
+      lines.push(`${indent}    return c.json({ error: 'Unsupported Media Type' }, 415)`);
+      lines.push(`${indent}  }`);
+      lines.push(`${indent}  const body: unknown = await c.req.parseBody()`);
+    } else if (op.bodyInfo.contentType === "multipart/form-data") {
+      lines.push(
+        `${indent}  // multipart/form-data: parseBody({ all: true }) collects repeated keys into arrays.`
+      );
+      lines.push(`${indent}  const body: unknown = await c.req.parseBody({ all: true })`);
+    } else {
+      lines.push(`${indent}  const _ct = c.req.header('content-type') ?? ''`);
+      lines.push(`${indent}  if (!_ct.toLowerCase().startsWith('application/json')) {`);
+      lines.push(`${indent}    return c.json({ error: 'Unsupported Media Type' }, 415)`);
+      lines.push(`${indent}  }`);
+      lines.push(`${indent}  let body: ${typeDecl}`);
+      lines.push(`${indent}  try {`);
+      lines.push(`${indent}    body = JSON.parse(await c.req.text()) as ${typeDecl}`);
+      lines.push(`${indent}  } catch {`);
+      lines.push(`${indent}    return c.json({ error: 'Invalid JSON body' }, 400)`);
+      lines.push(`${indent}  }`);
+    }
     const schemaName = op.bodyInfo.typeName !== void 0 ? `${op.bodyInfo.typeName}Schema` : void 0;
     if (schemaName !== void 0 && schemaNames !== void 0 && schemaNames.has(schemaName)) {
       lines.push(`${indent}  // Validate request body: returns 422 with Zod issues on failure`);
@@ -19373,7 +19804,7 @@ function buildRouteHandler(op, indent, schemaNames) {
         `${indent}    return c.json({ error: 'Invalid request body', issues: parseResult.error.issues }, 422)`
       );
       lines.push(`${indent}  }`);
-      lines.push(`${indent}  const validatedBody = parseResult.data`);
+      lines.push(`${indent}  const validatedBody = parseResult.data as ${typeDecl}`);
       bodyVarName = "validatedBody";
     }
   }
@@ -19385,21 +19816,54 @@ function buildRouteHandler(op, indent, schemaNames) {
     serviceArgs.push(bodyVarName);
   }
   if (op.queryParams.length > 0) {
-    serviceArgs.push("params");
+    serviceArgs.push(queryParamsNeedValidation(op.queryParams) ? "_qv.data" : "params");
+  }
+  if (contextType !== void 0) {
+    serviceArgs.push("c");
   }
   const serviceCall = `service.${op.methodName}(${serviceArgs.join(", ")})`;
+  lines.push(`${indent}  try {`);
   if (op.responseStatus.isVoid) {
-    lines.push(`${indent}  await ${serviceCall}`);
-    lines.push(`${indent}  return new Response(null, { status: ${op.responseStatus.status} })`);
-  } else if (op.responseStatus.status === 201) {
-    lines.push(`${indent}  return c.json(await ${serviceCall}, 201)`);
+    lines.push(`${indent}    await ${serviceCall}`);
+    lines.push(`${indent}    return new Response(null, { status: ${op.responseStatus.status} })`);
+  } else if (op.responseStatus.isMultiStatus === true) {
+    lines.push(`${indent}    const _envelope = await ${serviceCall}`);
+    lines.push(`${indent}    return c.json(_envelope.body, _envelope.status as any)`);
+  } else if (op.responseStatus.responseContentType === "text/plain") {
+    if (op.responseStatus.status === 200) {
+      lines.push(`${indent}    return c.text(await ${serviceCall})`);
+    } else {
+      lines.push(`${indent}    return c.text(await ${serviceCall}, ${op.responseStatus.status})`);
+    }
+  } else if (op.responseStatus.responseContentType === "application/octet-stream") {
+    if (op.responseStatus.status === 200) {
+      lines.push(`${indent}    const _result = await ${serviceCall}`);
+      lines.push(
+        `${indent}    return new Response(_result, { headers: { 'content-type': 'application/octet-stream' } })`
+      );
+    } else {
+      lines.push(`${indent}    const _result = await ${serviceCall}`);
+      lines.push(
+        `${indent}    return new Response(_result, { status: ${op.responseStatus.status}, headers: { 'content-type': 'application/octet-stream' } })`
+      );
+    }
+  } else if (op.responseStatus.status === 200) {
+    lines.push(`${indent}    return c.json(await ${serviceCall})`);
   } else {
-    lines.push(`${indent}  return c.json(await ${serviceCall})`);
+    lines.push(`${indent}    return c.json(await ${serviceCall}, ${op.responseStatus.status})`);
   }
+  lines.push(`${indent}  } catch (err) {`);
+  lines.push(`${indent}    if (err instanceof HttpError) {`);
+  lines.push(
+    `${indent}      return new Response(JSON.stringify({ error: err.message }), { status: err.status, headers: { 'content-type': 'application/json' } })`
+  );
+  lines.push(`${indent}    }`);
+  lines.push(`${indent}    throw err`);
+  lines.push(`${indent}  }`);
   lines.push(`${indent}})`);
   return lines.join("\n");
 }
-function buildExpressRouteHandler(op, indent, schemaNames) {
+function buildExpressRouteHandler(op, indent, schemaNames, contextType) {
   const lines = [];
   lines.push(
     `${indent}router.${op.httpMethod}(${JSON.stringify(op.honoPath)}, async (req: Request, res: Response) => {`
@@ -19414,6 +19878,13 @@ function buildExpressRouteHandler(op, indent, schemaNames) {
   }
   if (op.queryParams.length > 0) {
     const fields = op.queryParams.map((q) => {
+      if (q.isDeepObject === true) {
+        return `    ${q.name}: (req.query['${q.rawName}'] ?? {}) as Record<string, string | undefined>`;
+      }
+      if (q.delimiterStyle !== void 0) {
+        const delim = JSON.stringify(delimiterChar(q.delimiterStyle));
+        return `    ${q.name}: typeof req.query['${q.rawName}'] === 'string' ? (req.query['${q.rawName}'] as string).split(${delim}) : undefined`;
+      }
       if (q.tsType === "number") {
         return `    ${q.name}: Number(req.query['${q.name}'] as string)`;
       }
@@ -19442,59 +19913,133 @@ function buildExpressRouteHandler(op, indent, schemaNames) {
     );
     lines.push(`${indent}  }`);
   }
+  if (op.cookieParams.length > 0) {
+    emitCookieValidation(lines, op.cookieParams, indent, "express");
+    lines.push(`${indent}  if (!_ckv.success) {`);
+    lines.push(
+      `${indent}    return void res.status(422).json({ error: 'Invalid request cookies', issues: _ckv.error.issues })`
+    );
+    lines.push(`${indent}  }`);
+  }
   let bodyVarName = "body";
   if (op.bodyInfo !== void 0) {
-    const schemaName = op.bodyInfo.typeName !== void 0 ? `${op.bodyInfo.typeName}Schema` : void 0;
-    const useZod = schemaName !== void 0 && schemaNames !== void 0 && schemaNames.has(schemaName);
-    if (useZod) {
-      lines.push(`${indent}  // Validate request body: returns 422 with Zod issues on failure`);
-      lines.push(`${indent}  const parseResult = ${schemaName}.safeParse(req.body)`);
-      lines.push(`${indent}  if (!parseResult.success) {`);
+    if (op.bodyInfo.contentType === "multipart/form-data") {
       lines.push(
-        `${indent}    return void res.status(422).json({ error: 'Invalid request body', issues: parseResult.error.issues })`
+        `${indent}  // multipart/form-data: assumes multer middleware has populated req.files + req.body.`
       );
-      lines.push(`${indent}  }`);
-      lines.push(`${indent}  const validatedBody = parseResult.data`);
-      bodyVarName = "validatedBody";
+      lines.push(`${indent}  const body = { ...req.body, ...(req as any).files } as unknown`);
     } else {
-      const typeAnnotation = op.bodyInfo.typeName !== void 0 ? ` as ${op.bodyInfo.typeName}` : "";
-      lines.push(`${indent}  const body = req.body${typeAnnotation}`);
+      const schemaName = op.bodyInfo.typeName !== void 0 ? `${op.bodyInfo.typeName}Schema` : void 0;
+      const useZod = schemaName !== void 0 && schemaNames !== void 0 && schemaNames.has(schemaName);
+      if (useZod) {
+        lines.push(`${indent}  // Validate request body: returns 422 with Zod issues on failure`);
+        lines.push(`${indent}  const parseResult = ${schemaName}.safeParse(req.body)`);
+        lines.push(`${indent}  if (!parseResult.success) {`);
+        lines.push(
+          `${indent}    return void res.status(422).json({ error: 'Invalid request body', issues: parseResult.error.issues })`
+        );
+        lines.push(`${indent}  }`);
+        const typeDecl = op.bodyInfo.typeName !== void 0 && !op.bodyInfo.isSynthesized ? op.bodyInfo.typeName : "unknown";
+        lines.push(`${indent}  const validatedBody = parseResult.data as ${typeDecl}`);
+        bodyVarName = "validatedBody";
+      } else {
+        const typeAnnotation = op.bodyInfo.typeName !== void 0 && !op.bodyInfo.isSynthesized ? ` as ${op.bodyInfo.typeName}` : "";
+        lines.push(`${indent}  const body = req.body${typeAnnotation}`);
+      }
     }
   }
   const serviceArgs = [];
   for (const p of op.pathParams) {
-    serviceArgs.push(`req.params['${p}']!`);
+    serviceArgs.push(`(req.params['${p}'] as string)`);
   }
   if (op.bodyInfo !== void 0) {
     serviceArgs.push(bodyVarName);
   }
   if (op.queryParams.length > 0) {
-    serviceArgs.push("params");
+    serviceArgs.push(queryParamsNeedValidation(op.queryParams) ? "_qv.data" : "params");
+  }
+  if (contextType !== void 0) {
+    serviceArgs.push("req");
   }
   const serviceCall = `service.${op.methodName}(${serviceArgs.join(", ")})`;
+  lines.push(`${indent}  try {`);
   if (op.responseStatus.isVoid) {
-    lines.push(`${indent}  await ${serviceCall}`);
-    lines.push(`${indent}  res.status(${op.responseStatus.status}).end()`);
-  } else if (op.responseStatus.status === 201) {
-    lines.push(`${indent}  res.status(201).json(await ${serviceCall})`);
+    lines.push(`${indent}    await ${serviceCall}`);
+    lines.push(`${indent}    res.status(${op.responseStatus.status}).end()`);
+  } else if (op.responseStatus.isMultiStatus === true) {
+    lines.push(`${indent}    const _envelope = await ${serviceCall}`);
+    lines.push(`${indent}    res.status(_envelope.status).json(_envelope.body)`);
+  } else if (op.responseStatus.responseContentType === "text/plain") {
+    if (op.responseStatus.status === 200) {
+      lines.push(`${indent}    res.type('text/plain').send(await ${serviceCall})`);
+    } else {
+      lines.push(
+        `${indent}    res.status(${op.responseStatus.status}).type('text/plain').send(await ${serviceCall})`
+      );
+    }
+  } else if (op.responseStatus.responseContentType === "application/octet-stream") {
+    if (op.responseStatus.status === 200) {
+      lines.push(
+        `${indent}    res.setHeader('Content-Type', 'application/octet-stream').send(Buffer.from(await ${serviceCall}))`
+      );
+    } else {
+      lines.push(
+        `${indent}    res.status(${op.responseStatus.status}).setHeader('Content-Type', 'application/octet-stream').send(Buffer.from(await ${serviceCall}))`
+      );
+    }
+  } else if (op.responseStatus.status === 200) {
+    lines.push(`${indent}    res.json(await ${serviceCall})`);
   } else {
-    lines.push(`${indent}  res.json(await ${serviceCall})`);
-  }
+    lines.push(`${indent}    res.status(${op.responseStatus.status}).json(await ${serviceCall})`);
+  }
+  lines.push(`${indent}  } catch (err) {`);
+  lines.push(`${indent}    if (err instanceof HttpError) {`);
+  lines.push(`${indent}      return void res.status(err.status).json({ error: err.message })`);
+  lines.push(`${indent}    }`);
+  lines.push(`${indent}    throw err`);
+  lines.push(`${indent}  }`);
   lines.push(`${indent}})`);
   return lines.join("\n");
 }
-function buildFastifyRouteHandler(op, indent, schemaNames) {
+function buildFastifyRouteOptions(op, schemaNames) {
+  const parts = [];
+  const responseSchemaExpr = buildFastifyResponseSchemaExpr(op, schemaNames);
+  if (responseSchemaExpr !== void 0) {
+    parts.push(`schema: { response: { ${op.responseStatus.status}: ${responseSchemaExpr} } }`);
+  }
+  parts.push(`config: { operationId: '${op.methodName}' }`);
+  return `{ ${parts.join(", ")} }`;
+}
+function buildFastifyResponseSchemaExpr(op, schemaNames) {
+  if (schemaNames === void 0) return void 0;
+  if (op.responseTypeName === void 0) return void 0;
+  if (op.responseStatus.isMultiStatus === true) return void 0;
+  if (op.responseStatus.isVoid) return void 0;
+  const schemaName = `${op.responseTypeName}Schema`;
+  if (!schemaNames.has(schemaName)) return void 0;
+  return op.responseIsArray === true ? `z.array(${schemaName})` : schemaName;
+}
+function buildFastifyRouteHandler(op, indent, schemaNames, contextType) {
   const lines = [];
   const genericParts = [];
   if (op.queryParams.length > 0) {
-    const queryFields = op.queryParams.map((q) => {
-      if (q.tsType === "number") return `${q.name}?: number`;
-      if (q.tsType === "boolean") return `${q.name}?: boolean`;
-      return `${q.name}?: string`;
-    }).join("; ");
-    genericParts.push(`Querystring: { ${queryFields} }`);
-  }
-  if (op.bodyInfo !== void 0 && op.bodyInfo.typeName !== void 0) {
+    const hasDeepOrDelimited = op.queryParams.some(
+      (q) => q.isDeepObject === true || q.delimiterStyle !== void 0
+    );
+    let querystringType;
+    if (hasDeepOrDelimited) {
+      querystringType = "Record<string, string | string[] | undefined>";
+    } else {
+      const queryFields = op.queryParams.map((q) => {
+        if (q.tsType === "number") return `${q.name}?: number`;
+        if (q.tsType === "boolean") return `${q.name}?: boolean`;
+        return `${q.name}?: string`;
+      }).join("; ");
+      querystringType = `{ ${queryFields} }`;
+    }
+    genericParts.push(`Querystring: ${querystringType}`);
+  }
+  if (op.bodyInfo !== void 0 && op.bodyInfo.typeName !== void 0 && !op.bodyInfo.isSynthesized) {
     genericParts.push(`Body: ${op.bodyInfo.typeName}`);
   } else if (op.bodyInfo !== void 0) {
     genericParts.push("Body: unknown");
@@ -19504,27 +20049,60 @@ function buildFastifyRouteHandler(op, indent, schemaNames) {
     genericParts.push(`Params: { ${paramFields} }`);
   }
   const generic = genericParts.length > 0 ? `<{ ${genericParts.join("; ")} }>` : "";
+  const routeOpts = buildFastifyRouteOptions(op, schemaNames);
   lines.push(
-    `${indent}app.${op.httpMethod}${generic}(${JSON.stringify(op.honoPath)}, async (req, reply) => {`
+    `${indent}app.${op.httpMethod}${generic}(${JSON.stringify(op.honoPath)}, ${routeOpts}, async (req, reply) => {`
   );
   if (op.pathParamValidations.length > 0) {
     emitPathValidation(lines, op.pathParamValidations, indent, "fastify");
     lines.push(`${indent}  if (!_pv.success) {`);
-    lines.push(`${indent}    return reply.status(422).send({`);
+    lines.push(`${indent}    return (reply as FastifyReply).status(422).send({`);
     lines.push(`${indent}      error: 'Invalid path parameters',`);
     lines.push(`${indent}      issues: _pv.error.issues,`);
     lines.push(`${indent}    })`);
     lines.push(`${indent}  }`);
   }
   if (op.queryParams.length > 0) {
-    const fields = op.queryParams.map((q) => `    ${q.name}: req.query.${q.name}`).join(",\n");
+    const deepObjectParams = op.queryParams.filter((q) => q.isDeepObject === true);
+    const hasDeepOrDelimited = op.queryParams.some(
+      (q) => q.isDeepObject === true || q.delimiterStyle !== void 0
+    );
+    if (hasDeepOrDelimited) {
+      lines.push(
+        `${indent}  const _dq = req.query as unknown as Record<string, string | undefined>`
+      );
+    }
+    if (deepObjectParams.length > 0) {
+      for (const q of deepObjectParams) {
+        const prefixLen = q.rawName.length + 1;
+        const bracketPrefix = q.rawName + "[";
+        lines.push(`${indent}  const ${q.name} = Object.fromEntries(`);
+        lines.push(
+          `${indent}    Object.entries(_dq).filter(([k]) => k.startsWith('${bracketPrefix}') && k.endsWith(']')).map(([k, v]) => [k.slice(${prefixLen}, -1), v])`
+        );
+        lines.push(`${indent}  )`);
+      }
+    }
+    const fields = op.queryParams.map((q) => {
+      if (q.isDeepObject === true) {
+        return `    ${q.name}`;
+      }
+      if (q.delimiterStyle !== void 0) {
+        const delim = JSON.stringify(delimiterChar(q.delimiterStyle));
+        return `    ${q.name}: typeof _dq['${q.rawName}'] === 'string' ? _dq['${q.rawName}']!.split(${delim}) : undefined`;
+      }
+      if (q.tsType === "boolean") {
+        return hasDeepOrDelimited ? `    ${q.name}: _dq['${q.rawName}'] === 'true'` : `    ${q.name}: (req.query.${q.name} as unknown as string) === 'true'`;
+      }
+      return hasDeepOrDelimited ? `    ${q.name}: _dq['${q.rawName}']` : `    ${q.name}: req.query.${q.name}`;
+    }).join(",\n");
     lines.push(`${indent}  const params = {`);
     lines.push(fields);
     lines.push(`${indent}  }`);
     if (queryParamsNeedValidation(op.queryParams)) {
       emitQueryValidation(lines, op.queryParams, indent);
       lines.push(`${indent}  if (!_qv.success) {`);
-      lines.push(`${indent}    return reply.status(422).send({`);
+      lines.push(`${indent}    return (reply as FastifyReply).status(422).send({`);
       lines.push(`${indent}      error: 'Invalid query parameters',`);
       lines.push(`${indent}      issues: _qv.error.issues,`);
       lines.push(`${indent}    })`);
@@ -19534,25 +20112,46 @@ function buildFastifyRouteHandler(op, indent, schemaNames) {
   if (op.headerParams.length > 0) {
     emitHeaderValidation(lines, op.headerParams, indent, "fastify");
     lines.push(`${indent}  if (!_hv.success) {`);
-    lines.push(`${indent}    return reply.status(422).send({`);
+    lines.push(`${indent}    return (reply as FastifyReply).status(422).send({`);
     lines.push(`${indent}      error: 'Invalid request headers',`);
     lines.push(`${indent}      issues: _hv.error.issues,`);
     lines.push(`${indent}    })`);
     lines.push(`${indent}  }`);
   }
+  if (op.cookieParams.length > 0) {
+    emitCookieValidation(lines, op.cookieParams, indent, "fastify");
+    lines.push(`${indent}  if (!_ckv.success) {`);
+    lines.push(`${indent}    return (reply as FastifyReply).status(422).send({`);
+    lines.push(`${indent}      error: 'Invalid request cookies',`);
+    lines.push(`${indent}      issues: _ckv.error.issues,`);
+    lines.push(`${indent}    })`);
+    lines.push(`${indent}  }`);
+  }
   let bodyVarName = "req.body";
   if (op.bodyInfo !== void 0) {
-    const schemaName = op.bodyInfo.typeName !== void 0 ? `${op.bodyInfo.typeName}Schema` : void 0;
-    const useZod = schemaName !== void 0 && schemaNames !== void 0 && schemaNames.has(schemaName);
-    if (useZod) {
-      lines.push(`${indent}  // Validate request body: returns 422 with Zod issues on failure`);
-      lines.push(`${indent}  const parseResult = ${schemaName}.safeParse(req.body)`);
-      lines.push(`${indent}  if (!parseResult.success) {`);
+    if (op.bodyInfo.contentType === "multipart/form-data") {
       lines.push(
-        `${indent}    return reply.status(422).send({ error: 'Invalid request body', issues: parseResult.error.issues })`
+        `${indent}  // multipart/form-data: requires @fastify/multipart registered with { attachFieldsToBody: true }.`
       );
-      lines.push(`${indent}  }`);
-      bodyVarName = "parseResult.data";
+    } else if (op.bodyInfo.contentType === "application/octet-stream") {
+      lines.push(
+        `${indent}  // application/octet-stream: req.body is a Buffer from the registered content-type parser.`
+      );
+    } else {
+      const schemaName = op.bodyInfo.typeName !== void 0 ? `${op.bodyInfo.typeName}Schema` : void 0;
+      const useZod = schemaName !== void 0 && schemaNames !== void 0 && schemaNames.has(schemaName);
+      if (useZod) {
+        lines.push(`${indent}  // Validate request body: returns 422 with Zod issues on failure`);
+        lines.push(`${indent}  const parseResult = ${schemaName}.safeParse(req.body)`);
+        lines.push(`${indent}  if (!parseResult.success) {`);
+        lines.push(
+          `${indent}    return (reply as FastifyReply).status(422).send({ error: 'Invalid request body', issues: parseResult.error.issues })`
+        );
+        lines.push(`${indent}  }`);
+        const bodyCastType = op.bodyInfo.typeName !== void 0 && !op.bodyInfo.isSynthesized ? op.bodyInfo.typeName : "unknown";
+        lines.push(`${indent}  const validatedBody = parseResult.data as ${bodyCastType}`);
+        bodyVarName = "validatedBody";
+      }
     }
   }
   const serviceArgs = [];
@@ -19563,26 +20162,62 @@ function buildFastifyRouteHandler(op, indent, schemaNames) {
     serviceArgs.push(bodyVarName);
   }
   if (op.queryParams.length > 0) {
-    serviceArgs.push("params");
+    serviceArgs.push(queryParamsNeedValidation(op.queryParams) ? "_qv.data" : "params");
+  }
+  if (contextType !== void 0) {
+    serviceArgs.push("req");
   }
   const serviceCall = `service.${op.methodName}(${serviceArgs.join(", ")})`;
+  lines.push(`${indent}  try {`);
   if (op.responseStatus.isVoid) {
-    lines.push(`${indent}  await ${serviceCall}`);
-    lines.push(`${indent}  reply.status(${op.responseStatus.status}).send()`);
-  } else if (op.responseStatus.status === 201) {
-    lines.push(`${indent}  reply.status(201)`);
-    lines.push(`${indent}  return ${serviceCall}`);
+    lines.push(`${indent}    await ${serviceCall}`);
+    lines.push(`${indent}    reply.status(${op.responseStatus.status}).send()`);
+  } else if (op.responseStatus.isMultiStatus === true) {
+    lines.push(`${indent}    const _envelope = await ${serviceCall}`);
+    lines.push(`${indent}    return reply.status(_envelope.status).send(_envelope.body)`);
+  } else if (op.responseStatus.responseContentType === "text/plain") {
+    if (op.responseStatus.status === 200) {
+      lines.push(`${indent}    return reply.type('text/plain').send(await ${serviceCall})`);
+    } else {
+      lines.push(`${indent}    return reply.status(${op.responseStatus.status}).type('text/plain').send(await ${serviceCall})`);
+    }
+  } else if (op.responseStatus.responseContentType === "application/octet-stream") {
+    if (op.responseStatus.status === 200) {
+      lines.push(`${indent}    return reply.type('application/octet-stream').send(Buffer.from(await ${serviceCall}))`);
+    } else {
+      lines.push(`${indent}    return reply.status(${op.responseStatus.status}).type('application/octet-stream').send(Buffer.from(await ${serviceCall}))`);
+    }
+  } else if (op.responseStatus.status === 200) {
+    lines.push(`${indent}    return await ${serviceCall}`);
   } else {
-    lines.push(`${indent}  return ${serviceCall}`);
-  }
+    lines.push(`${indent}    reply.status(${op.responseStatus.status})`);
+    lines.push(`${indent}    return await ${serviceCall}`);
+  }
+  lines.push(`${indent}  } catch (err) {`);
+  lines.push(`${indent}    if (err instanceof HttpError) {`);
+  lines.push(`${indent}      return (reply as FastifyReply).status(err.status).send({ error: err.message })`);
+  lines.push(`${indent}    }`);
+  lines.push(`${indent}    throw err`);
+  lines.push(`${indent}  }`);
   lines.push(`${indent}})`);
   return lines.join("\n");
 }
+function httpErrorClassLines() {
+  return [
+    "export class HttpError extends Error {",
+    "  constructor(public readonly status: number, message: string) {",
+    "    super(message)",
+    "    this.name = 'HttpError'",
+    "  }",
+    "}"
+  ];
+}
 function operationsNeedZodForParams(operations) {
   for (const op of operations) {
     if (op.pathParamValidations.length > 0) return true;
     if (queryParamsNeedValidation(op.queryParams)) return true;
     if (op.headerParams.length > 0) return true;
+    if (op.cookieParams.length > 0) return true;
   }
   return false;
 }
@@ -19601,6 +20236,8 @@ function generateExpressRouter(spec, options) {
   if (sortedBodyTypes.length > 0) {
     lines.push(`import type { ${sortedBodyTypes.join(", ")} } from './models.js'`);
   }
+  const ctx = options?.contextType;
+  const serviceRef = ctx !== void 0 ? `${serviceName}<${ctx}>` : serviceName;
   lines.push(`import type { ${serviceName} } from './service.js'`);
   if (needsZod) {
     lines.push(`import { z } from 'zod'`);
@@ -19610,11 +20247,13 @@ function generateExpressRouter(spec, options) {
     lines.push(`import { ${sortedUsedSchemas.join(", ")} } from '${options.schemaImportPath}'`);
   }
   lines.push("");
-  lines.push(`export function createRouter(service: ${serviceName}): Router {`);
+  for (const l of httpErrorClassLines()) lines.push(l);
+  lines.push("");
+  lines.push(`export function createRouter(service: ${serviceRef}): Router {`);
   lines.push("  const router = Router()");
   lines.push("");
   for (const op of operations) {
-    lines.push(buildExpressRouteHandler(op, "  ", options?.schemaNames));
+    lines.push(buildExpressRouteHandler(op, "  ", options?.schemaNames, ctx));
     lines.push("");
   }
   lines.push("  return router");
@@ -19628,11 +20267,26 @@ function generateExpressRouter(spec, options) {
 function generateFastifyRouter(spec, options) {
   const serviceName = deriveServiceName(spec);
   const operations = collectOperations2(spec);
-  const { sortedBodyTypes, usedSchemaNames, needsZod } = collectGeneratorSetup(operations, options);
+  const { sortedBodyTypes, usedSchemaNames, usedResponseSchemaNames, needsZod } = collectGeneratorSetup(operations, options);
+  const allUsedSchemaNames = /* @__PURE__ */ new Set([...usedSchemaNames, ...usedResponseSchemaNames]);
+  const hasOctetStreamRequestBody = operations.some(
+    (op) => op.bodyInfo?.contentType === "application/octet-stream"
+  );
   const lines = [];
   lines.push("// This file is auto-generated. Do not edit manually.");
+  lines.push(
+    "// Fastify natively parses only application/json and text/plain request bodies."
+  );
+  lines.push(
+    "// For application/x-www-form-urlencoded bodies, register @fastify/formbody before this router."
+  );
+  lines.push(
+    "// For multipart/form-data bodies, register @fastify/multipart with { attachFieldsToBody: true } before this router."
+  );
   lines.push("");
-  lines.push("import type { FastifyInstance } from 'fastify'");
+  const ctx = options?.contextType;
+  const serviceRef = ctx !== void 0 ? `${serviceName}<${ctx}>` : serviceName;
+  lines.push("import type { FastifyInstance, FastifyReply } from 'fastify'");
   if (sortedBodyTypes.length > 0) {
     lines.push(`import type { ${sortedBodyTypes.join(", ")} } from './models.js'`);
   }
@@ -19640,15 +20294,41 @@ function generateFastifyRouter(spec, options) {
   if (needsZod) {
     lines.push(`import { z } from 'zod'`);
   }
-  if (usedSchemaNames.size > 0 && options?.schemaImportPath !== void 0) {
-    const sortedUsedSchemas = Array.from(usedSchemaNames).sort();
+  if (allUsedSchemaNames.size > 0 && options?.schemaImportPath !== void 0) {
+    const sortedUsedSchemas = Array.from(allUsedSchemaNames).sort();
     lines.push(`import { ${sortedUsedSchemas.join(", ")} } from '${options.schemaImportPath}'`);
   }
   lines.push("");
-  lines.push(`export function createRouter(app: FastifyInstance, service: ${serviceName}): void {`);
+  lines.push("declare module 'fastify' {");
+  lines.push("  interface FastifyContextConfig {");
+  lines.push("    operationId?: string");
+  lines.push("  }");
+  lines.push("}");
+  lines.push("");
+  for (const l of httpErrorClassLines()) lines.push(l);
+  lines.push("");
+  lines.push(`export function createRouter(app: FastifyInstance, service: ${serviceRef}): void {`);
+  if (hasOctetStreamRequestBody) {
+    lines.push(
+      "  app.addContentTypeParser('application/octet-stream', { parseAs: 'buffer' }, (req, body, done) => done(null, body))"
+    );
+  }
+  if (usedResponseSchemaNames.size > 0 && options?.schemaImportPath !== void 0) {
+    lines.push("  app.setSerializerCompiler(({ schema }) => {");
+    lines.push(
+      "    if (schema !== null && typeof schema === 'object' && 'parse' in schema) {"
+    );
+    lines.push(
+      "      const zodSchema = schema as { parse: (data: unknown) => unknown }"
+    );
+    lines.push("      return (data: unknown) => JSON.stringify(zodSchema.parse(data))");
+    lines.push("    }");
+    lines.push("    return (data: unknown) => JSON.stringify(data)");
+    lines.push("  })");
+  }
   for (const op of operations) {
     lines.push("");
-    lines.push(buildFastifyRouteHandler(op, "  ", options?.schemaNames));
+    lines.push(buildFastifyRouteHandler(op, "  ", options?.schemaNames, ctx));
   }
   lines.push("}");
   lines.push("");
@@ -19664,7 +20344,13 @@ function generateRouter(spec, options) {
   const lines = [];
   lines.push("// This file is auto-generated. Do not edit manually.");
   lines.push("");
+  const ctx = options?.contextType;
+  const serviceRef = ctx !== void 0 ? `${serviceName}<${ctx}>` : serviceName;
+  const needsGetCookie = operations.some((op) => op.cookieParams.length > 0);
   lines.push("import { Hono } from 'hono'");
+  if (needsGetCookie) {
+    lines.push("import { getCookie } from 'hono/cookie'");
+  }
   if (sortedBodyTypes.length > 0) {
     lines.push(`import type { ${sortedBodyTypes.join(", ")} } from './models.js'`);
   }
@@ -19677,11 +20363,13 @@ function generateRouter(spec, options) {
     lines.push(`import { ${sortedUsedSchemas.join(", ")} } from '${options.schemaImportPath}'`);
   }
   lines.push("");
-  lines.push(`export function createRouter(service: ${serviceName}): Hono {`);
+  for (const l of httpErrorClassLines()) lines.push(l);
+  lines.push("");
+  lines.push(`export function createRouter(service: ${serviceRef}): Hono {`);
   lines.push("  const app = new Hono()");
   lines.push("");
   for (const op of operations) {
-    lines.push(buildRouteHandler(op, "  ", options?.schemaNames));
+    lines.push(buildRouteHandler(op, "  ", options?.schemaNames, ctx));
     lines.push("");
   }
   lines.push("  return app");
@@ -19711,9 +20399,14 @@ async function generateOne(cwd, config, label) {
   const prefix = label !== void 0 ? `[${label}] ` : "";
   console.log(`${prefix}Parsing spec: ${inputPath}`);
   const spec = await parseSpec(inputPath);
-  const generatedFiles = [generateService(spec)];
+  const serviceOptions = config.context_type !== void 0 ? { contextType: config.context_type } : void 0;
+  const generatedFiles = [generateService(spec, serviceOptions)];
   if (framework !== "none") {
-    generatedFiles.push(buildRouterFile(spec, framework));
+    generatedFiles.push(
+      buildRouterFile(spec, framework, {
+        contextType: config.context_type
+      })
+    );
   }
   console.log(`${prefix}Writing output to: ${outputDir}`);
   await (0, import_promises2.mkdir)(outputDir, { recursive: true });
@@ -19746,7 +20439,8 @@ async function generateSchemaEnhancedRouter(cwd, config, spec, framework, output
   const schemaImportPathJs = schemaImportPath.replace(/\.ts$/, ".js");
   const routerFile = buildRouterFile(spec, framework, {
     schemaNames: exportedSchemas,
-    schemaImportPath: schemaImportPathJs
+    schemaImportPath: schemaImportPathJs,
+    contextType: config.context_type
   });
   const routerPath = (0, import_node_path2.join)(outputDir, routerFile.filename);
   await (0, import_promises2.writeFile)(routerPath, await formatTs(routerFile.content, routerPath), "utf-8");