@codewithagents/openapi-server 1.2.0 → 1.3.1

package/README.md

@@ -1,16 +1,20 @@
 # @codewithagents/openapi-server
 
 [![npm](https://img.shields.io/npm/v/@codewithagents/openapi-server.svg)](https://npmjs.com/package/@codewithagents/openapi-server)
-[![codecov](https://codecov.io/gh/codewithagents/glue/graph/badge.svg?flag=openapi-server)](https://codecov.io/gh/codewithagents/glue)
+[![CI](https://github.com/codewithagents/openapi-zod-ts/actions/workflows/ci.yml/badge.svg)](https://github.com/codewithagents/openapi-zod-ts/actions/workflows/ci.yml)
+[![codecov](https://codecov.io/gh/codewithagents/openapi-zod-ts/graph/badge.svg?flag=openapi-server)](https://codecov.io/gh/codewithagents/openapi-zod-ts)
+[![CodeQL](https://github.com/codewithagents/openapi-zod-ts/actions/workflows/codeql.yml/badge.svg)](https://github.com/codewithagents/openapi-zod-ts/actions/workflows/codeql.yml)
 
-Generate a typed service interface from your OpenAPI 3.x spec. Framework-agnostic by design — wire it to Hono, Express, Fastify, or any router you already use.
+📖 **[Full documentation](https://openapi.codewithagents.de/openapi-server)**
 
-- **Framework-agnostic service interface** — `service.ts` is a plain TypeScript interface with no framework imports. Implement it however you want: Hono, Express, Fastify, Koa, plain `http`, Bun, Deno — anything.
-- **Optional router scaffolding** — set `"framework": "hono"` and get a ready-to-mount Hono router as a starting point. Set `"framework": "none"` and wire the interface yourself. The generated code only ever imports what you already have.
-- **Type-safe contract** — the compiler tells you if your implementation drifts from the spec. Add an endpoint in the spec and forget to implement it: TypeScript fails the build.
-- **Prettier-clean output** — every generated file passes `prettier --check` out of the box.
-- **OpenAPI 3.x** — 3.1.x primary target, 3.0.x best-effort. Full support for `$ref`, `allOf`, `anyOf`, `oneOf`, `nullable`.
-- **TypeScript strict mode** — all output passes `strict: true`.
+Generate a typed service interface from your OpenAPI 3.x spec. Framework-agnostic by design: wire it to Hono, Express, Fastify, or any router you already use.
+
+- **Framework-agnostic service interface**: `service.ts` is a plain TypeScript interface with no framework imports. Implement it however you want: Hono, Express, Fastify, Koa, plain `http`, Bun, Deno, or anything else.
+- **Optional router scaffolding**: set `"framework": "hono"` and get a ready-to-mount Hono router as a starting point. Set `"framework": "none"` and wire the interface yourself. The generated code only ever imports what you already have.
+- **Type-safe contract**: the compiler tells you if your implementation drifts from the spec. Add an endpoint in the spec and forget to implement it. TypeScript fails the build.
+- **Prettier-clean output**: every generated file passes `prettier --check` out of the box.
+- **OpenAPI 3.x**: 3.1.x primary target, 3.0.x best-effort. Full support for `$ref`, `allOf`, `anyOf`, `oneOf`, `nullable`.
+- **TypeScript strict mode**: all output passes `strict: true`.
 
 ---
 
@@ -22,7 +26,7 @@ pnpm add -D @codewithagents/openapi-server
 npm install -D @codewithagents/openapi-server
 ```
 
-Requires [`@codewithagents/openapi-gen`](../openapi-gen) — run both generators together.
+Requires [`@codewithagents/openapi-gen`](../openapi-gen). Run both generators together.
 
 ---
 
@@ -48,8 +52,8 @@ npx openapi-server
 
 | File | What it contains |
 |---|---|
-| `service.ts` | TypeScript interface — one method per API operation |
-| `router.ts` | `createRouter(service)` factory — mounts every route on a Hono app |
+| `service.ts` | TypeScript interface, one method per API operation |
+| `router.ts` | `createRouter(service)` factory, mounts every route on a Hono app |
 
 Run `openapi-gen` first (or together) so `models.ts` exists before `service.ts` imports from it:
 
@@ -133,7 +137,7 @@ The router handles:
 - Path params: `{id}` → `:id` (Hono style), extracted via `c.req.param()`
 - Query params: extracted and typed (`string`, `number`, `boolean`)
 - Request bodies: parsed via `c.req.json<T>()` with the correct model type
-- Response status: `200` for GET, `201` for POST, `204` for DELETE — derived from your spec
+- Response status: `200` for GET, `201` for POST, `204` for DELETE, derived from your spec
 
 ---
 
@@ -203,23 +207,25 @@ serve({ fetch: app.fetch, port: 3001 })
 
 ## Config reference
 
+See the [full configuration reference](https://openapi.codewithagents.de/openapi-server#configuration) in the docs for a detailed options table and the `--config` CLI flag.
+
 `openapi-server.config.json`:
 
 ```json
 {
-  "input_openapi": "./spec/api.json",       // required — path to OpenAPI 3.x spec (JSON or YAML)
-  "output": "./generated",                  // required — directory to write generated files
-  "framework": "hono",                      // optional — router target (default: "hono")
-  "input_schema": "./generated/schemas.ts"  // optional — Zod schema file for request validation
+  "input_openapi": "./spec/api.json",       // required: path to OpenAPI 3.x spec (JSON or YAML)
+  "output": "./generated",                  // required: directory to write generated files
+  "framework": "hono",                      // optional: router target (default: "hono")
+  "input_schema": "./generated/schemas.ts"  // optional: Zod schema file for request validation
 }
 ```
 
 | Field | Required | Default | Description |
 |---|---|---|---|
-| `input_openapi` | Yes | — | Path to OpenAPI 3.x spec |
-| `output` | Yes | — | Directory to write `service.ts` and `router.ts` |
+| `input_openapi` | Yes | n/a | Path to OpenAPI 3.x spec |
+| `output` | Yes | n/a | Directory to write `service.ts` and `router.ts` |
 | `framework` | No | `"hono"` | Router framework to generate. Use `"none"` to generate only `service.ts` |
-| `input_schema` | No | — | Path to user-owned Zod schema file. Enables server-side request validation (see below) |
+| `input_schema` | No | none | Path to user-owned Zod schema file. Enables server-side request validation (see below) |
 
 Use `--config <path>` to point at a config file in a different location:
 
@@ -233,6 +239,8 @@ Relative paths in the config resolve from the config file's directory.
 
 ## Zod request validation (`input_schema`)
 
+See the [Zod validation](https://openapi.codewithagents.de/openapi-server#zod-validation-input_schema) section in the docs for the two-pass generation flow and schema naming convention.
+
 Point `input_schema` at the same `schemas.ts` you use with `@codewithagents/openapi-gen`. The server generator adds runtime validation to every route that receives a request body:
 
 **Config:**
@@ -270,9 +278,9 @@ Invalid requests get a structured `422` response instead of reaching your servic
 }
 ```
 
-**Same schemas, both sides of the wire** — `openapi-gen` validates outgoing requests in the browser; `openapi-server` validates incoming requests on the server. One `schemas.ts`, one source of truth.
+**Same schemas, both sides of the wire**: `openapi-gen` validates outgoing requests in the browser; `openapi-server` validates incoming requests on the server. One `schemas.ts`, one source of truth.
 
-**Drift detection** — if schemas diverge from the spec (extra schema, missing schema), the generator warns to stderr. Builds still succeed — the warning is advisory.
+**Drift detection**: if schemas diverge from the spec (extra schema, missing schema), the generator warns to stderr. Builds still succeed; the warning is advisory.
 
 ---
 
@@ -280,11 +288,33 @@ Invalid requests get a structured `422` response instead of reaching your servic
 
 `service.ts` has no framework imports at all. It is always generated, always framework-agnostic, and works with anything.
 
-`router.ts` is optional and currently supports:
+`router.ts` is optional and supports:
 
 | Value | What you get |
 |---|---|
-| `"none"` | Only `service.ts`. Wire the interface to Express, Fastify, Koa, plain Node `http`, Bun, Deno, or anything else yourself. |
-| `"hono"` | `service.ts` + a ready-to-mount `router.ts` using [Hono](https://hono.dev). Hono must be in your own `dependencies` — this package adds nothing. |
+| `"none"` | Only `service.ts`. Wire the interface yourself. |
+| `"hono"` | `service.ts` + a ready-to-mount `router.ts` using [Hono](https://hono.dev). Includes optional Zod request validation via `input_schema`. |
+| `"express"` | `service.ts` + a ready-to-mount `router.ts` using [Express](https://expressjs.com) `Router`. Apply `express.json()` middleware before mounting. |
+| `"fastify"` | `service.ts` + a route-registering `router.ts` using [Fastify](https://fastify.dev). Routes are registered onto a `FastifyInstance`; see mount pattern below. |
+
+The framework package must be in your own `dependencies`. This package adds nothing at runtime.
+
+**Mounting patterns:**
+
+```ts
+// Hono
+app.route('/api', createRouter(service))
+
+// Express
+app.use(express.json())
+app.use('/api', createRouter(service))
+
+// Fastify: createRouter registers routes onto the instance rather than returning one
+fastify.register(async (instance) => { createRouter(instance, service) }, { prefix: '/api' })
+```
+
+The `"none"` path is always available and keeps the zero-footprint promise: the generated code has no runtime dependencies that you did not already choose.
+
+## Error handling and troubleshooting
 
-More router targets (Express, Fastify) are planned. The `"none"` path is always available and keeps the zero-footprint promise: the generated code has no runtime dependencies that you did not already choose.
+The generated router does not wrap service calls in `try/catch`. Errors propagate to the framework's own error handler. See [Error handling](https://openapi.codewithagents.de/openapi-server#error-handling) in the docs for per-framework error handler examples and [Troubleshooting](https://openapi.codewithagents.de/openapi-server#troubleshooting) for common issues such as missing Zod validation or `Cannot find module './models.js'`.

package/dist/cli.cjs

@@ -18478,8 +18478,8 @@ async function loadConfig(cwd2, configPath) {
   if (typeof config["output"] !== "string" || !config["output"]) {
     throw new Error('Config missing required field: "output" (output directory)');
   }
-  if (config["framework"] !== void 0 && config["framework"] !== "hono" && config["framework"] !== "none") {
-    throw new Error('"framework" must be either "hono" or "none"');
+  if (config["framework"] !== void 0 && config["framework"] !== "hono" && config["framework"] !== "express" && config["framework"] !== "fastify" && config["framework"] !== "none") {
+    throw new Error('"framework" must be one of: "hono", "express", "fastify", or "none"');
   }
   if (config["input_schema"] !== void 0 && (typeof config["input_schema"] !== "string" || !config["input_schema"])) {
     throw new Error('"input_schema" must be a non-empty string path to your Zod schema file');
@@ -18505,8 +18505,14 @@ async function parseSpec(inputPath) {
 
 // ../openapi-gen/dist/utils/naming.js
 function toTypeName(name) {
-  const result = name.replace(/[^a-zA-Z0-9]+(.)/g, (_, char) => char.toUpperCase()).replace(/[^a-zA-Z0-9]+$/, "").replace(/^[^a-zA-Z_$]/, "_").replace(/^(.)/, (_, char) => char.toUpperCase());
-  return result.length > 0 ? result : "_";
+  const parts = name.split(/[^a-zA-Z0-9]+/).filter(Boolean);
+  if (parts.length === 0)
+    return "_";
+  const joined = parts.map((part, i) => i === 0 ? part : part[0].toUpperCase() + part.slice(1)).join("");
+  const prefixed = /^[^a-zA-Z_$]/.test(joined) ? `_${joined}` : joined;
+  const titled = prefixed.replace(/^(.)/, (_, char) => char.toUpperCase());
+  const safe = titled.replace(/[^a-zA-Z0-9_$]/g, "");
+  return safe.length > 0 ? safe : "_";
 }
 
 // src/plugins/service.ts
@@ -18582,7 +18588,11 @@ function deriveOperationName(method, path) {
   return prefix + parts.join("");
 }
 function normalizeParamName(name) {
-  return name.replace(/\[\]$/, "").replace(/'/g, "").replace(/[^a-zA-Z0-9]+([a-zA-Z])/g, (_, char) => char.toUpperCase()).replace(/[^a-zA-Z0-9]+$/, "").replace(/^[^a-zA-Z_$]/, "_");
+  const stripped = name.replace(/\[\]$/, "").replace(/'/g, "");
+  const parts = stripped.split(/[^a-zA-Z0-9]+/).filter(Boolean);
+  if (parts.length === 0) return "_";
+  const camel = parts.map((part, i) => i === 0 ? part : part[0].toUpperCase() + part.slice(1)).join("");
+  return /^[^a-zA-Z_$]/.test(camel) ? `_${camel}` : camel;
 }
 function getQueryParams(operation, spec) {
   const parameters = operation.parameters;
@@ -18635,13 +18645,21 @@ function getReturnInfo(operation) {
     if (jsonContent === void 0 || jsonContent.schema === void 0) continue;
     const schema = jsonContent.schema;
     if (isRef(schema)) {
-      return { typeName: refToName(schema.$ref), isArray: false, isVoid: false };
+      return {
+        typeName: refToName(schema.$ref),
+        isArray: false,
+        isVoid: false
+      };
     }
     const s = schema;
     if (s.type === "array") {
       const items = s.items;
       if (items !== void 0 && isRef(items)) {
-        return { typeName: refToName(items.$ref), isArray: true, isVoid: false };
+        return {
+          typeName: refToName(items.$ref),
+          isArray: true,
+          isVoid: false
+        };
       }
       return { typeName: void 0, isArray: true, isVoid: false };
     }
@@ -18813,7 +18831,18 @@ function deriveOperationName2(method, path) {
   return prefix + parts.join("");
 }
 function normalizeParamName2(name) {
-  return name.replace(/\[\]$/, "").replace(/'/g, "").replace(/[^a-zA-Z0-9]+([a-zA-Z])/g, (_, char) => char.toUpperCase()).replace(/[^a-zA-Z0-9]+$/, "").replace(/^[^a-zA-Z_$]/, "_");
+  const stripped = name.replace(/\[\]$/, "").replace(/'/g, "");
+  const parts = stripped.split(/[^a-zA-Z0-9]+/).filter(Boolean);
+  if (parts.length === 0) return "_";
+  const camel = parts.map((part, i) => i === 0 ? part : part[0].toUpperCase() + part.slice(1)).join("");
+  return /^[^a-zA-Z_$]/.test(camel) ? `_${camel}` : camel;
+}
+function schemaToTsType(schema) {
+  if (schema === void 0 || isRef2(schema)) return "string";
+  const s = schema;
+  if (s.type === "number" || s.type === "integer") return "number";
+  if (s.type === "boolean") return "boolean";
+  return "string";
 }
 function getQueryParams2(operation, spec) {
   const parameters = operation.parameters;
@@ -18823,15 +18852,9 @@ function getQueryParams2(operation, spec) {
     const resolved = resolveParam2(p, spec);
     if (resolved === void 0 || resolved.in !== "query") continue;
     const schema = resolved.schema;
-    let tsType = "string";
-    if (schema !== void 0 && !isRef2(schema)) {
-      const s = schema;
-      if (s.type === "number" || s.type === "integer") tsType = "number";
-      else if (s.type === "boolean") tsType = "boolean";
-    }
     result.push({
       name: normalizeParamName2(resolved.name),
-      tsType,
+      tsType: schemaToTsType(schema),
       required: resolved.required === true
     });
   }
@@ -18852,25 +18875,24 @@ function getBodyInfo2(operation) {
   }
   return { typeName: void 0 };
 }
+function response200IsVoid(resp) {
+  if (isRef2(resp)) return false;
+  const r = resp;
+  const content = r.content;
+  return content === void 0 || Object.keys(content).length === 0;
+}
 function getResponseStatus(operation, httpMethod) {
   const responses = operation.responses;
-  if (responses !== void 0) {
-    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) {
-      const resp = responses["200"];
-      if (!isRef2(resp)) {
-        const r = resp;
-        const content = r.content;
-        if (content === void 0 || Object.keys(content).length === 0) {
-          return { status: 204, isVoid: true };
-        }
-      }
-      return { status: 200, isVoid: false };
-    }
+  if (responses === void 0) {
+    return httpMethod === "delete" ? { status: 204, isVoid: true } : { status: 200, isVoid: false };
   }
-  if (httpMethod === "delete") return { status: 204, isVoid: true };
-  return { status: 200, isVoid: false };
+  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 };
+  }
+  return httpMethod === "delete" ? { status: 204, isVoid: true } : { status: 200, isVoid: false };
 }
 function collectOperations2(spec) {
   const paths = spec.paths;
@@ -18919,9 +18941,7 @@ function buildRouteHandler(op, indent, schemaNames) {
     lines.push(`${indent}  const body = await c.req.json${typeAnnotation}()`);
     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 \u2014 returns 422 with Zod issues on failure`
-      );
+      lines.push(`${indent}  // Validate request body: returns 422 with Zod issues on failure`);
       lines.push(`${indent}  const parseResult = ${schemaName}.safeParse(body)`);
       lines.push(`${indent}  if (!parseResult.success) {`);
       lines.push(
@@ -18954,6 +18974,235 @@ function buildRouteHandler(op, indent, schemaNames) {
   lines.push(`${indent}})`);
   return lines.join("\n");
 }
+function buildExpressRouteHandler(op, indent, schemaNames) {
+  const lines = [];
+  lines.push(
+    `${indent}router.${op.httpMethod}('${op.honoPath}', async (req: Request, res: Response) => {`
+  );
+  if (op.queryParams.length > 0) {
+    const fields = op.queryParams.map((q) => {
+      if (q.tsType === "number") {
+        return `    ${q.name}: Number(req.query['${q.name}'] as string)`;
+      }
+      if (q.tsType === "boolean") {
+        return `    ${q.name}: req.query['${q.name}'] === 'true'`;
+      }
+      return `    ${q.name}: req.query['${q.name}'] as string | undefined`;
+    }).join(",\n");
+    lines.push(`${indent}  const params = {`);
+    lines.push(fields);
+    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) {`);
+      lines.push(
+        `${indent}    return void res.status(422).json({ error: 'Invalid request body', issues: parseResult.error.issues })`
+      );
+      lines.push(`${indent}  }`);
+      lines.push(`${indent}  const validatedBody = parseResult.data`);
+      bodyVarName = "validatedBody";
+    } else {
+      const typeAnnotation = op.bodyInfo.typeName !== void 0 ? ` 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}']!`);
+  }
+  if (op.bodyInfo !== void 0) {
+    serviceArgs.push(bodyVarName);
+  }
+  if (op.queryParams.length > 0) {
+    serviceArgs.push("params");
+  }
+  const serviceCall = `service.${op.methodName}(${serviceArgs.join(", ")})`;
+  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})`);
+  } else {
+    lines.push(`${indent}  res.json(await ${serviceCall})`);
+  }
+  lines.push(`${indent}})`);
+  return lines.join("\n");
+}
+function generateExpressRouter(spec, options) {
+  const serviceName = deriveServiceName2(spec);
+  const operations = collectOperations2(spec);
+  const bodyTypes = /* @__PURE__ */ new Set();
+  for (const op of operations) {
+    if (op.bodyInfo?.typeName !== void 0) {
+      bodyTypes.add(op.bodyInfo.typeName);
+    }
+  }
+  const sortedBodyTypes = Array.from(bodyTypes).sort();
+  const usedSchemaNames = /* @__PURE__ */ new Set();
+  if (options?.schemaNames !== void 0) {
+    for (const op of operations) {
+      const typeName = op.bodyInfo?.typeName;
+      if (typeName !== void 0) {
+        const schemaName = `${typeName}Schema`;
+        if (options.schemaNames.has(schemaName)) {
+          usedSchemaNames.add(schemaName);
+        }
+      }
+    }
+  }
+  const lines = [];
+  lines.push("// This file is auto-generated. Do not edit manually.");
+  lines.push(
+    "// Express: apply express.json() middleware before mounting this router so req.body is populated."
+  );
+  lines.push("");
+  lines.push("import { Router } from 'express'");
+  lines.push("import type { Request, Response } from 'express'");
+  if (sortedBodyTypes.length > 0) {
+    lines.push(`import type { ${sortedBodyTypes.join(", ")} } from './models.js'`);
+  }
+  lines.push(`import type { ${serviceName} } from './service.js'`);
+  if (usedSchemaNames.size > 0 && options?.schemaImportPath !== void 0) {
+    lines.push(`import { z } from 'zod'`);
+    const sortedUsedSchemas = Array.from(usedSchemaNames).sort();
+    lines.push(`import { ${sortedUsedSchemas.join(", ")} } from '${options.schemaImportPath}'`);
+  }
+  lines.push("");
+  lines.push(`export function createRouter(service: ${serviceName}): Router {`);
+  lines.push("  const router = Router()");
+  lines.push("");
+  for (const op of operations) {
+    lines.push(buildExpressRouteHandler(op, "  ", options?.schemaNames));
+    lines.push("");
+  }
+  lines.push("  return router");
+  lines.push("}");
+  lines.push("");
+  return {
+    filename: "router.ts",
+    content: lines.join("\n")
+  };
+}
+function buildFastifyRouteHandler(op, indent, schemaNames) {
+  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) {
+    genericParts.push(`Body: ${op.bodyInfo.typeName}`);
+  } else if (op.bodyInfo !== void 0) {
+    genericParts.push("Body: unknown");
+  }
+  if (op.pathParams.length > 0) {
+    const paramFields = op.pathParams.map((p) => `${p}: string`).join("; ");
+    genericParts.push(`Params: { ${paramFields} }`);
+  }
+  const generic = genericParts.length > 0 ? `<{ ${genericParts.join("; ")} }>` : "";
+  lines.push(`${indent}app.${op.httpMethod}${generic}('${op.honoPath}', async (req, reply) => {`);
+  if (op.queryParams.length > 0) {
+    const fields = op.queryParams.map((q) => `    ${q.name}: req.query.${q.name}`).join(",\n");
+    lines.push(`${indent}  const params = {`);
+    lines.push(fields);
+    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) {`);
+      lines.push(
+        `${indent}    return reply.status(422).send({ error: 'Invalid request body', issues: parseResult.error.issues })`
+      );
+      lines.push(`${indent}  }`);
+      bodyVarName = "parseResult.data";
+    }
+  }
+  const serviceArgs = [];
+  for (const p of op.pathParams) {
+    serviceArgs.push(`req.params.${p}`);
+  }
+  if (op.bodyInfo !== void 0) {
+    serviceArgs.push(bodyVarName);
+  }
+  if (op.queryParams.length > 0) {
+    serviceArgs.push("params");
+  }
+  const serviceCall = `service.${op.methodName}(${serviceArgs.join(", ")})`;
+  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}`);
+  } else {
+    lines.push(`${indent}  return ${serviceCall}`);
+  }
+  lines.push(`${indent}})`);
+  return lines.join("\n");
+}
+function generateFastifyRouter(spec, options) {
+  const serviceName = deriveServiceName2(spec);
+  const operations = collectOperations2(spec);
+  const bodyTypes = /* @__PURE__ */ new Set();
+  for (const op of operations) {
+    if (op.bodyInfo?.typeName !== void 0) {
+      bodyTypes.add(op.bodyInfo.typeName);
+    }
+  }
+  const sortedBodyTypes = Array.from(bodyTypes).sort();
+  const usedSchemaNames = /* @__PURE__ */ new Set();
+  if (options?.schemaNames !== void 0) {
+    for (const op of operations) {
+      const typeName = op.bodyInfo?.typeName;
+      if (typeName !== void 0) {
+        const schemaName = `${typeName}Schema`;
+        if (options.schemaNames.has(schemaName)) {
+          usedSchemaNames.add(schemaName);
+        }
+      }
+    }
+  }
+  const lines = [];
+  lines.push("// This file is auto-generated. Do not edit manually.");
+  lines.push("");
+  lines.push("import type { FastifyInstance } from 'fastify'");
+  if (sortedBodyTypes.length > 0) {
+    lines.push(`import type { ${sortedBodyTypes.join(", ")} } from './models.js'`);
+  }
+  lines.push(`import type { ${serviceName} } from './service.js'`);
+  if (usedSchemaNames.size > 0 && options?.schemaImportPath !== void 0) {
+    lines.push(`import { z } from 'zod'`);
+    const sortedUsedSchemas = Array.from(usedSchemaNames).sort();
+    lines.push(`import { ${sortedUsedSchemas.join(", ")} } from '${options.schemaImportPath}'`);
+  }
+  lines.push("");
+  lines.push(`export function createRouter(app: FastifyInstance, service: ${serviceName}): void {`);
+  for (const op of operations) {
+    lines.push("");
+    lines.push(buildFastifyRouteHandler(op, "  ", options?.schemaNames));
+  }
+  lines.push("}");
+  lines.push("");
+  return {
+    filename: "router.ts",
+    content: lines.join("\n")
+  };
+}
 function generateRouter(spec, options) {
   const serviceName = deriveServiceName2(spec);
   const operations = collectOperations2(spec);
@@ -18987,9 +19236,7 @@ function generateRouter(spec, options) {
   if (usedSchemaNames.size > 0 && options?.schemaImportPath !== void 0) {
     lines.push(`import { z } from 'zod'`);
     const sortedUsedSchemas = Array.from(usedSchemaNames).sort();
-    lines.push(
-      `import { ${sortedUsedSchemas.join(", ")} } from '${options.schemaImportPath}'`
-    );
+    lines.push(`import { ${sortedUsedSchemas.join(", ")} } from '${options.schemaImportPath}'`);
   }
   lines.push("");
   lines.push(`export function createRouter(service: ${serviceName}): Hono {`);
@@ -19026,6 +19273,10 @@ async function generate2(cwd2, configPath) {
   generatedFiles.push(generateService(spec));
   if (framework === "hono") {
     generatedFiles.push(generateRouter(spec));
+  } else if (framework === "express") {
+    generatedFiles.push(generateExpressRouter(spec));
+  } else if (framework === "fastify") {
+    generatedFiles.push(generateFastifyRouter(spec));
   }
   console.log(`Writing output to: ${outputDir}`);
   await (0, import_promises2.mkdir)(outputDir, { recursive: true });
@@ -19034,7 +19285,7 @@ async function generate2(cwd2, configPath) {
     await (0, import_promises2.writeFile)(filePath, await formatTs(file.content, filePath), "utf-8");
     console.log(`  \u2713 ${file.filename}`);
   }
-  if (framework === "hono" && config.input_schema !== void 0) {
+  if ((framework === "hono" || framework === "express" || framework === "fastify") && config.input_schema !== void 0) {
     const schemaPath = (0, import_node_path2.resolve)(cwd2, config.input_schema);
     let schemaContent;
     try {
@@ -19052,10 +19303,15 @@ async function generate2(cwd2, configPath) {
       const relPath = (0, import_node_path2.relative)(outputDir, schemaPath).replace(/\\/g, "/");
       const schemaImportPath = relPath.startsWith(".") ? relPath : `./${relPath}`;
       const schemaImportPathJs = schemaImportPath.replace(/\.ts$/, ".js");
-      const routerFile = generateRouter(spec, {
-        schemaNames: exportedSchemas,
-        schemaImportPath: schemaImportPathJs
-      });
+      const routerOptions = { schemaNames: exportedSchemas, schemaImportPath: schemaImportPathJs };
+      let routerFile;
+      if (framework === "hono") {
+        routerFile = generateRouter(spec, routerOptions);
+      } else if (framework === "express") {
+        routerFile = generateExpressRouter(spec, routerOptions);
+      } else {
+        routerFile = generateFastifyRouter(spec, routerOptions);
+      }
       const routerPath = (0, import_node_path2.join)(outputDir, routerFile.filename);
       await (0, import_promises2.writeFile)(routerPath, await formatTs(routerFile.content, routerPath), "utf-8");
       console.log(`  \u2713 router.ts (with Zod validation for ${exportedSchemas.size} schema(s))`);

package/dist/config.d.ts

@@ -4,7 +4,7 @@ export interface ServerConfig {
     /** Directory to write generated files */
     output: string;
     /** Framework to generate a router for. Default: 'none' */
-    framework?: 'hono' | 'none';
+    framework?: 'hono' | 'express' | 'fastify' | 'none';
     /** Path to user-owned Zod schema file (same file as openapi-gen's input_schema). Optional. */
     input_schema?: string;
 }

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,YAAY;IAC3B,uDAAuD;IACvD,aAAa,EAAE,MAAM,CAAA;IACrB,yCAAyC;IACzC,MAAM,EAAE,MAAM,CAAA;IACd,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAC3B,8FAA8F;IAC9F,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAcD,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAI3D;AAED,wBAAgB,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAW/D;AAED,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAW7D;AAED,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CA0DxF"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,YAAY;IAC3B,uDAAuD;IACvD,aAAa,EAAE,MAAM,CAAA;IACrB,yCAAyC;IACzC,MAAM,EAAE,MAAM,CAAA;IACd,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,CAAA;IACnD,8FAA8F;IAC9F,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAgCD,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAI3D;AAED,wBAAgB,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAW/D;AAED,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAW7D;AAGD,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CA4DxF"}