@dokploy/trpc-openapi 0.0.5 → 3.1.0-beta.0

package/LICENSE

@@ -1,21 +1,9 @@
 MIT License
 
-Copyright (c) 2021 James Berry <jb@jamesbe.com>
+Copyright 2024 Mario Campa
 
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
 
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
 
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -1,60 +1,60 @@
-![trpc-openapi](assets/trpc-openapi-readme.png)
-
+<p align="center">
+  <img src="assets/trpc-openapi.svg">
+</p>
 <div align="center">
-  <h1>trpc-openapi</h1>
-  <a href="https://www.npmjs.com/package/trpc-openapi"><img src="https://img.shields.io/npm/v/trpc-openapi.svg?style=flat&color=brightgreen" target="_blank" /></a>
+  <h1>trpc-to-openapi</h1>
+  <a href="https://www.npmjs.com/package/trpc-to-openapi"><img src="https://img.shields.io/npm/v/trpc-to-openapi.svg?style=flat&color=brightgreen" target="_blank" /></a>
   <a href="./LICENSE"><img src="https://img.shields.io/badge/license-MIT-black" /></a>
-  <a href="https://trpc.io/discord" target="_blank"><img src="https://img.shields.io/badge/chat-discord-blue.svg" /></a>
   <br />
   <hr />
 </div>
 
-
-
 ## **[OpenAPI](https://swagger.io/specification/) support for [tRPC](https://trpc.io/)** 🧩
 
+- Support for tRPC ^11.1.0 and Zod ^4
+- Easy REST endpoints for your tRPC procedures.
+- Perfect for incremental adoption.
+- Supports all OpenAPI versions.
 
-# Note
+Note: This project is a fork of a fork, with full credit to the original authors. It appears that the original author has abandoned the project, so I plan to add new features in the near future.
 
-We use this package to generate OpenAPI documents for our tRPC endpoints in https://github.com/Dokploy/dokploy
+### Branch `dokploy-openapi-features` (Dokploy-style defaults)
 
-We make some changes to make input, output and meta parameters be optional by default.
+This branch adds behavior used by [Dokploy](https://github.com/Dokploy/dokploy) for generating OpenAPI documents:
 
-1. We make optional input and output parameters required by default.
-2. We make .meta optional for all procedures.
-3. Introduce 2 flags to .meta() to override and additional parameters.
-4. `override` parameter overrides the default value and will take the whole object of openapi.
-5. `additional` parameters will be default values + the values provided in the openapi object.
+1. **Optional input/output as required in OpenAPI** – Optional Zod fields are exposed as required in the OpenAPI spec by default.
+2. **`.meta()` is optional** – Procedures are included in OpenAPI even without `.meta({ openapi: { ... } })`. Defaults: `method` (GET for queries, POST for mutations), `path` from procedure key (e.g. `user.list` → `/user/list`), `enabled: true`, `tags` from first path segment, `protect: true`.
+3. **`override` and `additional` in `.meta().openapi`**  
+   - **`override: true`** – Only the object you pass is used (no defaults).  
+   - **`additional: true`** – Defaults are applied first, then merged with your `openapi` object.  
+   - Otherwise (default) – Your `openapi` object is merged with defaults (your values take precedence where provided).
 
+**tRPC v10:** This branch is built for `@trpc/server` ^11 and Zod ^4. If you use `@trpc/server` ^10 (e.g. ^10.45.x), consider [@dokploy/trpc-openapi](https://github.com/dokploy/trpc-openapi), which supports tRPC 10 and Zod 3/4.
 
 ## Usage
 
-- Easy REST endpoints for your tRPC procedures.
-- Perfect for incremental adoption.
-- OpenAPI version 3.0.3.
-
-**1. Install `@dokploy/trpc-openapi`.**
+**1. Install `trpc-to-openapi`.**
 
 ```bash
+# pnpm
+pnpm add trpc-to-openapi
 # npm
-npm install @dokploy/trpc-openapi
+npm install trpc-to-openapi
 # yarn
-yarn add @dokploy/trpc-openapi
+yarn add trpc-to-openapi
 ```
 
 **2. Add `OpenApiMeta` to your tRPC instance.**
 
 ```typescript
 import { initTRPC } from '@trpc/server';
-import { OpenApiMeta } from '@dokploy/trpc-openapi';
+import { OpenApiMeta } from 'trpc-to-openapi';
 
 const t = initTRPC.meta<OpenApiMeta>().create(); /* 👈 */
 ```
 
 **3. Enable `openapi` support for a procedure.**
 
-
-
 ```typescript
 export const appRouter = t.router({
   sayHello: t.procedure
@@ -63,6 +63,13 @@ export const appRouter = t.router({
     .output(z.object({ greeting: z.string() }))
     .query(({ input }) => {
       return { greeting: `Hello ${input.name}!` };
+    }),
+
+  getStatus: t.procedure
+    .meta({ /* 👉 */ openapi: { method: 'GET', path: '/status' } })
+    .output(z.object({ status: z.string() }))
+    .query(() => {
+      return { status: 'healthy' };
     });
 });
 ```
@@ -70,27 +77,34 @@ export const appRouter = t.router({
 **4. Generate an OpenAPI document.**
 
 ```typescript
-import { generateOpenApiDocument } from 'trpc-openapi';
+import { generateOpenApiDocument } from 'trpc-to-openapi';
 
 import { appRouter } from '../appRouter';
+import { UserSchema, ProductSchema } from '../schemas';
 
 /* 👇 */
 export const openApiDocument = generateOpenApiDocument(appRouter, {
   title: 'tRPC OpenAPI',
   version: '1.0.0',
   baseUrl: 'http://localhost:3000',
+  defs: {
+    UserSchema,
+    ProductSchema,
+  },
 });
 ```
 
-**5. Add an `trpc-openapi` handler to your app.**
+**5. Add an `trpc-to-openapi` handler to your app.**
 
-We currently support adapters for [`Express`](http://expressjs.com/), [`Next.js`](https://nextjs.org/), [`Serverless`](https://www.serverless.com/), [`Fastify`](https://www.fastify.io/), [`Nuxt`](https://nuxtjs.org/) & [`Node:HTTP`](https://nodejs.org/api/http.html).
+We currently support adapters for [`Express`](http://expressjs.com/), [`Next.js`](https://nextjs.org/), [`Fastify`](https://www.fastify.io/), [`Nuxt`](https://nuxtjs.org/) & [`Node:HTTP`](https://nodejs.org/api/http.html).
 
 [`Fetch`](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API), [`Cloudflare Workers`](https://workers.cloudflare.com/) & more soon™, PRs are welcomed 🙌.
 
+No support for AWS lambdas
+
 ```typescript
 import http from 'http';
-import { createOpenApiHttpHandler } from 'trpc-openapi';
+import { createOpenApiHttpHandler } from 'trpc-to-openapi';
 
 import { appRouter } from '../appRouter';
 
@@ -103,22 +117,29 @@ server.listen(3000);
 
 ```typescript
 // client.ts
-const res = await fetch('http://localhost:3000/say-hello?name=James', { method: 'GET' });
-const body = await res.json(); /* { greeting: 'Hello James!' } */
+const res = await fetch('http://localhost:3000/say-hello?name=OpenAPI', { method: 'GET' });
+const body = await res.json(); /* { greeting: 'Hello OpenAPI!' } */
+
+const statusRes = await fetch('http://localhost:3000/status', { method: 'GET' });
+const statusBody = await statusRes.json(); /* { status: 'healthy' } */
 ```
 
 ## Requirements
 
 Peer dependencies:
 
-- [`tRPC`](https://github.com/trpc/trpc) Server v10 (`@trpc/server`) must be installed.
-- [`Zod`](https://github.com/colinhacks/zod) v3 (`zod@^3.14.4`) must be installed (recommended `^3.20.0`).
+- [`tRPC`](https://github.com/trpc/trpc) Server v11 (`@trpc/server`) must be installed.
+- [`Zod`](https://github.com/colinhacks/zod) v4 (`zod@^4.0.0`) must be installed.
 
 For a procedure to support OpenAPI the following _must_ be true:
 
+- An `output` parser is present AND uses `Zod` validation.
+- If an `input` parser is present, it must use `Zod` validation.
+- Query `input` parsers (when present) extend `Object<{ [string]: String | Number | BigInt | Date }>` or `Void`.
+- Mutation `input` parsers (when present) extend `Object<{ [string]: AnyType }>` or `Void`.
 - `meta.openapi.method` is `GET`, `POST`, `PATCH`, `PUT` or `DELETE`.
 - `meta.openapi.path` is a string starting with `/`.
-- `meta.openapi.path` parameters exist in `input` parser as `String | Number | BigInt | Date`
+- `meta.openapi.path` parameters (when present) exist in `input` parser as `String | Number | BigInt | Date`
 
 Please note:
 
@@ -128,7 +149,7 @@ Please note:
 
 ## HTTP Requests
 
-Procedures with a `GET`/`DELETE` method will accept inputs via URL `query parameters`. Procedures with a `POST`/`PATCH`/`PUT` method will accept inputs via the `request body` with a `application/json` or `application/x-www-form-urlencoded` content type.
+Procedures with a `GET`/`DELETE` method will accept inputs via URL `query parameters`. Procedures with a `POST`/`PATCH`/`PUT` method will accept inputs via the `request body` with a `application/json` content type.
 
 ### Path parameters
 
@@ -151,10 +172,10 @@ export const appRouter = t.router({
 });
 
 // Client
-const res = await fetch('http://localhost:3000/say-hello/James?greeting=Hello' /* 👈 */, {
+const res = await fetch('http://localhost:3000/say-hello/Lily?greeting=Hello' /* 👈 */, {
   method: 'GET',
 });
-const body = await res.json(); /* { greeting: 'Hello James!' } */
+const body = await res.json(); /* { greeting: 'Hello Lily!' } */
 ```
 
 ### Request body
@@ -172,17 +193,17 @@ export const appRouter = t.router({
 });
 
 // Client
-const res = await fetch('http://localhost:3000/say-hello/James' /* 👈 */, {
+const res = await fetch('http://localhost:3000/say-hello/Lily' /* 👈 */, {
   method: 'POST',
   headers: { 'Content-Type': 'application/json' },
   body: JSON.stringify({ greeting: 'Hello' }),
 });
-const body = await res.json(); /* { greeting: 'Hello James!' } */
+const body = await res.json(); /* { greeting: 'Hello Lily!' } */
 ```
 
 ### Custom headers
 
-Any custom headers can be specified in the `meta.openapi.headers` array, these headers will not be validated on request. Please consider using [Authorization](#authorization) for first-class OpenAPI auth/security support.
+Any custom headers can be specified in the `meta.openapi.requestHeaders` and `meta.openapi.responseHeaders` zod object schema, these headers will not be validated. Please consider using [Authorization](#authorization) for first-class OpenAPI auth/security support.
 
 ## HTTP Responses
 
@@ -202,14 +223,14 @@ Explore a [complete example here](examples/with-nextjs/src/server/router.ts).
 
 ```typescript
 import { TRPCError, initTRPC } from '@trpc/server';
-import { OpenApiMeta } from '@dokploy/trpc-openapi';
+import { OpenApiMeta } from 'trpc-to-openapi';
 
 type User = { id: string; name: string };
 
 const users: User[] = [
   {
     id: 'usr_123',
-    name: 'James',
+    name: 'Lily',
   },
 ];
 
@@ -247,7 +268,7 @@ const res = await fetch('http://localhost:3000/say-hello', {
   method: 'GET',
   headers: { Authorization: 'Bearer usr_123' } /* 👈 */,
 });
-const body = await res.json(); /* { greeting: 'Hello James!' } */
+const body = await res.json(); /* { greeting: 'Hello Lily!' } */
 ```
 
 ## Examples
@@ -261,7 +282,7 @@ Please see [full example here](examples/with-express).
 ```typescript
 import { createExpressMiddleware } from '@trpc/server/adapters/express';
 import express from 'express';
-import { createOpenApiExpressMiddleware } from 'trpc-openapi';
+import { createOpenApiExpressMiddleware } from 'trpc-to-openapi';
 
 import { appRouter } from '../appRouter';
 
@@ -273,29 +294,51 @@ app.use('/api', createOpenApiExpressMiddleware({ router: appRouter })); /* 👈
 app.listen(3000);
 ```
 
-#### With Next.js
+#### With Next.js app router
 
-Please see [full example here](examples/with-nextjs).
+Please see [full example here](examples/with-nextjs-appdir).
 
 ```typescript
-// pages/api/[...trpc].ts
-import { createOpenApiNextHandler } from 'trpc-openapi';
-
-import { appRouter } from '../../server/appRouter';
+// src/app/[...trpc]/route.ts
+import { appRouter } from '~/server/api/root';
+import { createContext } from '~/server/api/trpc';
+import { type NextRequest } from 'next/server';
+import { createOpenApiFetchHandler } from 'trpc-to-openapi';
+
+export const dynamic = 'force-dynamic';
+
+const handler = (req: NextRequest) => {
+  // Handle incoming OpenAPI requests
+  return createOpenApiFetchHandler({
+    endpoint: '/',
+    router: appRouter,
+    createContext: () => createContext(req),
+    req,
+  });
+};
 
-export default createOpenApiNextHandler({ router: appRouter });
+export {
+  handler as GET,
+  handler as POST,
+  handler as PUT,
+  handler as PATCH,
+  handler as DELETE,
+  handler as OPTIONS,
+  handler as HEAD,
+};
 ```
 
-#### With AWS Lambda
+#### With Next.js pages router
 
-Please see [full example here](examples/with-serverless).
+Please see [full example here](examples/with-nextjs).
 
 ```typescript
-import { createOpenApiAwsLambdaHandler } from 'trpc-openapi';
+// pages/api/[...trpc].ts
+import { createOpenApiNextHandler } from 'trpc-to-openapi';
 
-import { appRouter } from './appRouter';
+import { appRouter } from '../../server/appRouter';
 
-export const openApi = createOpenApiAwsLambdaHandler({ router: appRouter });
+export default createOpenApiNextHandler({ router: appRouter });
 ```
 
 #### With Fastify
@@ -305,7 +348,7 @@ Please see [full example here](examples/with-fastify).
 ```typescript
 import { fastifyTRPCPlugin } from '@trpc/server/adapters/fastify';
 import Fastify from 'fastify';
-import { fastifyTRPCOpenApiPlugin } from 'trpc-openapi';
+import { fastifyTRPCOpenApiPlugin } from 'trpc-to-openapi';
 
 import { appRouter } from './router';
 
@@ -327,34 +370,36 @@ main();
 
 Please see [full typings here](src/generator/index.ts).
 
-| Property          | Type                                   | Description                                             | Required |
-| ----------------- | -------------------------------------- | ------------------------------------------------------- | -------- |
-| `title`           | `string`                               | The title of the API.                                   | `true`   |
-| `description`     | `string`                               | A short description of the API.                         | `false`  |
-| `version`         | `string`                               | The version of the OpenAPI document.                    | `true`   |
-| `baseUrl`         | `string`                               | The base URL of the target server.                      | `true`   |
-| `docsUrl`         | `string`                               | A URL to any external documentation.                    | `false`  |
-| `tags`            | `string[]`                             | A list for ordering endpoint groups.                    | `false`  |
-| `securitySchemes` | `Record<string, SecuritySchemeObject>` | Defaults to `Authorization` header with `Bearer` scheme | `false`  |
+| Property          | Type                                                                                       | Description                                                                                 | Required |
+| ----------------- | ------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------- | -------- |
+| `title`           | `string`                                                                                   | The title of the API.                                                                       | `true`   |
+| `description`     | `string`                                                                                   | A short description of the API.                                                             | `false`  |
+| `version`         | `string`                                                                                   | The version of the OpenAPI document.                                                        | `true`   |
+| `baseUrl`         | `string`                                                                                   | The base URL of the target server.                                                          | `true`   |
+| `docsUrl`         | `string`                                                                                   | A URL to any external documentation.                                                        | `false`  |
+| `tags`            | `string[]`                                                                                 | A list for ordering endpoint groups.                                                        | `false`  |
+| `securitySchemes` | `Record<string, SecuritySchemeObject>`                                                     | Defaults to `Authorization` header with `Bearer` scheme                                     | `false`  |
+| `filter`          | `(ctx: { metadata: { openapi: NonNullable<OpenApiMeta['openapi']> } & TMeta }) => boolean` | Optional filter function to include/exclude procedures from the generated OpenAPI document. | `false`  |
 
 #### OpenApiMeta
 
 Please see [full typings here](src/types.ts).
 
-| Property       | Type                | Description                                                                                          | Required | Default                |
-| -------------- | ------------------- | ---------------------------------------------------------------------------------------------------- | -------- | ---------------------- |
-| `enabled`      | `boolean`           | Exposes this procedure to `trpc-openapi` adapters and on the OpenAPI document.                       | `false`  | `true`                 |
-| `override`     | `boolean`           | Overrides the default value of the parameter.                                                        | `false`  | `false`                |
-| `additional`   | `boolean`           | Adds the parameter to the default value of the parameter.
-| `method`       | `HttpMethod`        | HTTP method this endpoint is exposed on. Value can be `GET`, `POST`, `PATCH`, `PUT` or `DELETE`.     | `true`   | `undefined`            |
-| `path`         | `string`            | Pathname this endpoint is exposed on. Value must start with `/`, specify path parameters using `{}`. | `true`   | `undefined`            |
-| `protect`      | `boolean`           | Requires this endpoint to use a security scheme.                                                     | `false`  | `false`                |
-| `summary`      | `string`            | A short summary of the endpoint included in the OpenAPI document.                                    | `false`  | `undefined`            |
-| `description`  | `string`            | A verbose description of the endpoint included in the OpenAPI document.                              | `false`  | `undefined`            |
-| `tags`         | `string[]`          | A list of tags used for logical grouping of endpoints in the OpenAPI document.                       | `false`  | `undefined`            |
-| `headers`      | `ParameterObject[]` | An array of custom headers to add for this endpoint in the OpenAPI document.                         | `false`  | `undefined`            |
-| `contentTypes` | `ContentType[]`     | A set of content types specified as accepted in the OpenAPI document.                                | `false`  | `['application/json']` |
-| `deprecated`   | `boolean`           | Whether or not to mark an endpoint as deprecated                                                     | `false`  | `false`                |
+| Property             | Type                                    | Description                                                                                                                    | Required | Default                 |
+| -------------------- | --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ | -------- | ----------------------- |
+| `enabled`            | `boolean`                               | Exposes this procedure to `trpc-to-openapi` adapters and on the OpenAPI document.                                              | `false`  | `true`                  |
+| `method`             | `HttpMethod`                            | HTTP method this endpoint is exposed on. Value can be `GET`, `POST`, `PATCH`, `PUT` or `DELETE`.                               | `true`   | `undefined`             |
+| `path`               | `string`                                | Pathname this endpoint is exposed on. Value must start with `/`, specify path parameters using `{}`.                           | `true`   | `undefined`             |
+| `protect`            | `boolean`                               | Requires this endpoint to use a security scheme.                                                                               | `false`  | `true`                  |
+| `summary`            | `string`                                | A short summary of the endpoint included in the OpenAPI document.                                                              | `false`  | `undefined`             |
+| `description`        | `string`                                | A verbose description of the endpoint included in the OpenAPI document.                                                        | `false`  | `undefined`             |
+| `tags`               | `string[]`                              | A list of tags used for logical grouping of endpoints in the OpenAPI document.                                                 | `false`  | `undefined`             |
+| `requestHeaders`     | `AnyZodObject`                          | A zod object schema describing any custom headers to add to the request for this endpoint in the OpenAPI document.             | `false`  | `undefined`             |
+| `responseHeaders`    | `AnyZodObject`                          | A zod object schema describing any custom headers to add to the response for this endpoint in the OpenAPI document.            | `false`  | `undefined`             |
+| `successDescription` | `string`                                | A string to use as the description for a successful response.                                                                  | `false`  | `'Successful response'` |
+| `errorResponses`     | `number[] \| { [key: number]: string }` | A list of error response codes or an object of response codes and their description to add to the responses for this endpoint. | `false`  | `undefined`             |
+| `contentTypes`       | `OpenApiContentType[]`                  | A set of content types specified as accepted in the OpenAPI document.                                                          | `false`  | `['application/json']`  |
+| `deprecated`         | `boolean`                               | Whether or not to mark an endpoint as deprecated                                                                               | `false`  | `false`                 |
 
 #### CreateOpenApiNodeHttpHandlerOptions
 
@@ -370,13 +415,49 @@ Please see [full typings here](src/adapters/node-http/core.ts).
 
 ---
 
-_Still using tRPC v9? See our [`.interop()`](examples/with-interop) example._
-
 ## License
 
 Distributed under the MIT License. See LICENSE for more information.
 
-## Contact
+**Filtering Procedures in OpenAPI Output**
+
+You can use the `filter` option to selectively include or exclude procedures from the generated OpenAPI document. The filter function receives a context object with the procedure's metadata. Return `true` to include the procedure, or `false` to exclude it.
+
+**Example:**
+
+```typescript
+const appRouter = t.router({
+  publicProc: t.procedure
+    .meta({ openapi: { method: 'GET', path: '/public' }, isPublic: true })
+    .input(z.object({}))
+    .output(z.object({ result: z.string() }))
+    .query(() => ({ result: 'public' })),
+  privateProc: t.procedure
+    .meta({ openapi: { method: 'GET', path: '/private' }, isPublic: false })
+    .input(z.object({}))
+    .output(z.object({ result: z.string() }))
+    .query(() => ({ result: 'private' })),
+});
 
-James Berry - Follow me on Twitter [@jlalmes](https://twitter.com/jlalmes) 💚
-# trpc-openapi
+// Only include procedures where isPublic is true
+const openApiDocument = generateOpenApiDocument(appRouter, {
+  ...defaultDocOpts,
+  filter: ({ metadata }) => metadata.isPublic === true,
+});
+
+// openApiDocument.paths will only include '/public'
+```
+
+You can also pass a metadata generic to `generateOpenApiDocument` to get proper types for your custom metadata in the filter function:
+
+```typescript
+// Define your custom metadata type
+interface MyMeta {
+  isPublic: boolean;
+}
+
+const openApiDocument = generateOpenApiDocument<MyMeta>(appRouter, {
+  ...defaultDocOpts,
+  filter: ({ metadata }) => metadata.isPublic === true,
+});
+```

package/dist/cjs/adapters/express.d.ts

@@ -0,0 +1,6 @@
+import { Request, Response } from 'express';
+import { OpenApiRouter } from '../types';
+import { CreateOpenApiNodeHttpHandlerOptions } from './node-http';
+export type CreateOpenApiExpressMiddlewareOptions<TRouter extends OpenApiRouter> = CreateOpenApiNodeHttpHandlerOptions<TRouter, Request, Response>;
+export declare const createOpenApiExpressMiddleware: <TRouter extends OpenApiRouter>(opts: CreateOpenApiExpressMiddlewareOptions<TRouter>) => (req: Request, res: Response) => Promise<void>;
+//# sourceMappingURL=express.d.ts.map

package/dist/cjs/adapters/express.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"express.d.ts","sourceRoot":"","sources":["../../../src/adapters/express.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAE5C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,mCAAmC,EAAgC,MAAM,aAAa,CAAC;AAEhG,MAAM,MAAM,qCAAqC,CAAC,OAAO,SAAS,aAAa,IAC7E,mCAAmC,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;AAElE,eAAO,MAAM,8BAA8B,GAAI,OAAO,SAAS,aAAa,EAC1E,MAAM,qCAAqC,CAAC,OAAO,CAAC,MAItC,KAAK,OAAO,EAAE,KAAK,QAAQ,kBAG1C,CAAC"}

package/dist/{adapters → cjs/adapters}/express.js

@@ -1,9 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createOpenApiExpressMiddleware = void 0;
-const core_1 = require("./node-http/core");
+const node_http_1 = require("./node-http");
 const createOpenApiExpressMiddleware = (opts) => {
-    const openApiHttpHandler = (0, core_1.createOpenApiNodeHttpHandler)(opts);
+    const openApiHttpHandler = (0, node_http_1.createOpenApiNodeHttpHandler)(opts);
     return async (req, res) => {
         await openApiHttpHandler(req, res);
     };

package/dist/cjs/adapters/express.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"express.js","sourceRoot":"","sources":["../../../src/adapters/express.ts"],"names":[],"mappings":";;;AAGA,2CAAgG;AAKzF,MAAM,8BAA8B,GAAG,CAC5C,IAAoD,EACpD,EAAE;IACF,MAAM,kBAAkB,GAAG,IAAA,wCAA4B,EAAC,IAAI,CAAC,CAAC;IAE9D,OAAO,KAAK,EAAE,GAAY,EAAE,GAAa,EAAE,EAAE;QAC3C,MAAM,kBAAkB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACrC,CAAC,CAAC;AACJ,CAAC,CAAC;AARW,QAAA,8BAA8B,kCAQzC"}

package/dist/cjs/adapters/fastify.d.ts

@@ -0,0 +1,9 @@
+import { AnyRouter } from '@trpc/server';
+import { FastifyInstance } from 'fastify';
+import { OpenApiRouter } from '../types';
+import { CreateOpenApiNodeHttpHandlerOptions } from './node-http';
+export type CreateOpenApiFastifyPluginOptions<TRouter extends OpenApiRouter> = CreateOpenApiNodeHttpHandlerOptions<TRouter, any, any> & {
+    basePath?: `/${string}`;
+};
+export declare function fastifyTRPCOpenApiPlugin<TRouter extends AnyRouter>(fastify: FastifyInstance, opts: CreateOpenApiFastifyPluginOptions<TRouter>, done: (err?: Error) => void): void;
+//# sourceMappingURL=fastify.d.ts.map

package/dist/cjs/adapters/fastify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fastify.d.ts","sourceRoot":"","sources":["../../../src/adapters/fastify.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,eAAe,EAAgC,MAAM,SAAS,CAAC;AAIxE,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,mCAAmC,EAAgC,MAAM,aAAa,CAAC;AAyBhG,MAAM,MAAM,iCAAiC,CAAC,OAAO,SAAS,aAAa,IACzE,mCAAmC,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG;IACvD,QAAQ,CAAC,EAAE,IAAI,MAAM,EAAE,CAAC;CACzB,CAAC;AAEJ,wBAAgB,wBAAwB,CAAC,OAAO,SAAS,SAAS,EAChE,OAAO,EAAE,eAAe,EACxB,IAAI,EAAE,iCAAiC,CAAC,OAAO,CAAC,EAChD,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,KAAK,IAAI,QAwE5B"}

package/dist/cjs/adapters/fastify.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fastifyTRPCOpenApiPlugin = fastifyTRPCOpenApiPlugin;
+const node_http_1 = require("./node-http");
+function fastifyTRPCOpenApiPlugin(fastify, opts, done) {
+    var _a;
+    let prefix = (_a = opts.basePath) !== null && _a !== void 0 ? _a : '';
+    // if prefix ends with a slash, remove it
+    if (prefix.endsWith('/')) {
+        prefix = prefix.slice(0, -1);
+    }
+    const openApiHttpHandler = (0, node_http_1.createOpenApiNodeHttpHandler)(opts);
+    fastify.route({
+        method: ['GET', 'POST', 'PATCH', 'PUT', 'DELETE'],
+        url: `${prefix}/*`,
+        handler: async (request, reply) => {
+            const prefixRemovedFromUrl = request.url.replace(fastify.prefix, '').replace(prefix, '');
+            request.raw.url = prefixRemovedFromUrl;
+            // Add Node.js request methods to Fastify request
+            const requestWithNodeMethods = request;
+            // Add event emitter methods
+            requestWithNodeMethods.once = request.raw.once.bind(request.raw);
+            requestWithNodeMethods.on = request.raw.on.bind(request.raw);
+            requestWithNodeMethods.off = request.raw.off.bind(request.raw);
+            requestWithNodeMethods.destroy = request.raw.destroy.bind(request.raw);
+            // Add Node.js response methods to Fastify reply
+            const replyWithNodeMethods = reply;
+            // Add statusCode property
+            void Object.defineProperty(replyWithNodeMethods, 'statusCode', {
+                set(value) {
+                    void reply.code(value);
+                },
+                get() {
+                    return reply.raw.statusCode;
+                },
+                enumerable: true,
+                configurable: true,
+            });
+            // Add setHeader method
+            replyWithNodeMethods.setHeader = (key, value) => {
+                void reply.header(key, value);
+            };
+            // Add end method
+            replyWithNodeMethods.end = (data) => {
+                if (!reply.sent) {
+                    void reply.send(data);
+                }
+            };
+            // Add properties and methods needed by incomingMessageToRequest
+            replyWithNodeMethods.socket = reply.raw.socket;
+            replyWithNodeMethods.connection = reply.raw.connection;
+            replyWithNodeMethods.finished = reply.raw.finished;
+            replyWithNodeMethods.headersSent = reply.raw.headersSent;
+            // Add event emitter methods
+            replyWithNodeMethods.once = reply.raw.once.bind(reply.raw);
+            replyWithNodeMethods.on = reply.raw.on.bind(reply.raw);
+            replyWithNodeMethods.off = reply.raw.off.bind(reply.raw);
+            replyWithNodeMethods.emit = reply.raw.emit.bind(reply.raw);
+            replyWithNodeMethods.removeListener = reply.raw.removeListener.bind(reply.raw);
+            return await openApiHttpHandler(requestWithNodeMethods, replyWithNodeMethods);
+        },
+    });
+    done();
+}
+//# sourceMappingURL=fastify.js.map

package/dist/cjs/adapters/fastify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fastify.js","sourceRoot":"","sources":["../../../src/adapters/fastify.ts"],"names":[],"mappings":"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"}

package/dist/cjs/adapters/fetch.d.ts

@@ -0,0 +1,8 @@
+import { FetchHandlerOptions } from '@trpc/server/adapters/fetch';
+import { OpenApiRouter } from '../types';
+export type CreateOpenApiFetchHandlerOptions<TRouter extends OpenApiRouter> = Omit<FetchHandlerOptions<TRouter>, 'batching'> & {
+    req: Request;
+    endpoint: `/${string}`;
+};
+export declare const createOpenApiFetchHandler: <TRouter extends OpenApiRouter>(opts: CreateOpenApiFetchHandlerOptions<TRouter>) => Promise<Response>;
+//# sourceMappingURL=fetch.d.ts.map

package/dist/cjs/adapters/fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../../src/adapters/fetch.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAGlE,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGzC,MAAM,MAAM,gCAAgC,CAAC,OAAO,SAAS,aAAa,IAAI,IAAI,CAChF,mBAAmB,CAAC,OAAO,CAAC,EAC5B,UAAU,CACX,GAAG;IACF,GAAG,EAAE,OAAO,CAAC;IACb,QAAQ,EAAE,IAAI,MAAM,EAAE,CAAC;CACxB,CAAC;AAsEF,eAAO,MAAM,yBAAyB,GAAU,OAAO,SAAS,aAAa,EAC3E,MAAM,gCAAgC,CAAC,OAAO,CAAC,KAC9C,OAAO,CAAC,QAAQ,CAuClB,CAAC"}