@codewithagents/openapi-server 1.1.0 → 1.2.0

package/README.md

@@ -3,12 +3,13 @@
 [![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)
 
-Generate a typed server-side service interface and a [Hono](https://hono.dev) router from an OpenAPI 3.1 spec.
+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.
 
-- **Type-safe contract** — a TypeScript interface derived directly from your spec. The compiler tells you if your implementation drifts.
-- **Prettier-clean output** — every generated file passes `prettier --check` out of the box. Commit it, lint it, ship it.
-- **Zero boilerplate routing** — a ready-to-mount Hono router that extracts path params, query params, and request bodies, then delegates to your service.
-- **OpenAPI 3.1 only** — `$ref`, `allOf`, `anyOf`, `oneOf`, `type: ['string', 'null']`. No legacy compat.
+- **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`.
 
 ---
@@ -33,7 +34,7 @@ Requires [`@codewithagents/openapi-gen`](../openapi-gen) — run both generators
 {
   "input_openapi": "./spec/api.json",
   "output": "./generated",
-  "framework": "hono"
+  "framework": "hono"   // or "none" to skip the router and use any framework
 }
 ```
 
@@ -206,7 +207,7 @@ serve({ fetch: app.fetch, port: 3001 })
 
 ```json
 {
-  "input_openapi": "./spec/api.json",       // required — path to OpenAPI 3.1 spec (JSON or YAML)
+  "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
@@ -215,7 +216,7 @@ serve({ fetch: app.fetch, port: 3001 })
 
 | Field | Required | Default | Description |
 |---|---|---|---|
-| `input_openapi` | Yes | — | Path to OpenAPI 3.1 spec (JSON or YAML) |
+| `input_openapi` | Yes | — | Path to OpenAPI 3.x spec |
 | `output` | Yes | — | 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) |
@@ -275,12 +276,15 @@ Invalid requests get a structured `422` response instead of reaching your servic
 
 ---
 
-## Frameworks
+## Framework support
 
-| Framework | Status |
+`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:
+
+| Value | What you get |
 |---|---|
-| [Hono](https://hono.dev) | Supported |
-| Express | Planned |
-| Fastify | Planned |
+| `"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. |
 
-Set `"framework": "none"` to generate only the service interface without a router — useful if you want to wire up your own routing layer.
+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.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codewithagents/openapi-server",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Generate typed server-side service interfaces and framework routers from OpenAPI 3.1",
   "type": "module",
   "bin": {
@@ -18,7 +18,7 @@
   "dependencies": {
     "openapi-types": "^12.1.3",
     "prettier": "^3.5.3",
-    "@codewithagents/openapi-gen": "4.1.0"
+    "@codewithagents/openapi-gen": "4.2.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",