@orpc/openapi 0.0.0-next.ccd4e42 → 0.0.0-next.d0e429d

package/README.md

@@ -0,0 +1,91 @@
+<div align="center">
+  <image align="center" src="https://orpc.unnoq.com/logo.webp" width=280 />
+</div>
+
+<h1></h1>
+
+<div align="center">
+  <a href="https://codecov.io/gh/unnoq/orpc">
+    <img alt="codecov" src="https://codecov.io/gh/unnoq/orpc/branch/main/graph/badge.svg">
+  </a>
+  <a href="https://www.npmjs.com/package/@orpc/openapi">
+    <img alt="weekly downloads" src="https://img.shields.io/npm/dw/%40orpc%2Fopenapi?logo=npm" />
+  </a>
+  <a href="https://github.com/unnoq/orpc/blob/main/LICENSE">
+    <img alt="MIT License" src="https://img.shields.io/github/license/unnoq/orpc?logo=open-source-initiative" />
+  </a>
+  <a href="https://discord.gg/TXEbwRBvQn">
+    <img alt="Discord" src="https://img.shields.io/discord/1308966753044398161?color=7389D8&label&logo=discord&logoColor=ffffff" />
+  </a>
+</div>
+
+<h3 align="center">Typesafe APIs Made Simple 🪄</h3>
+
+**oRPC is a powerful combination of RPC and OpenAPI**, makes it easy to build APIs that are end-to-end type-safe and adhere to OpenAPI standards, ensuring a smooth and enjoyable developer experience.
+
+---
+
+## Highlights
+
+- **End-to-End Type Safety 🔒**: Ensure complete type safety from inputs to outputs and errors, bridging server and client seamlessly.
+- **First-Class OpenAPI 📄**: Adheres to the OpenAPI standard out of the box, ensuring seamless integration and comprehensive API documentation.
+- **Contract-First Development 📜**: (Optional) Define your API contract upfront and implement it with confidence.
+- **Exceptional Developer Experience ✨**: Enjoy a streamlined workflow with robust typing and clear, in-code documentation.
+- **Multi-Runtime Support 🌍**: Run your code seamlessly on Cloudflare, Deno, Bun, Node.js, and more.
+- **Framework Integrations 🧩**: Supports Tanstack Query (React, Vue), Pinia Colada, and more.
+- **Server Actions ⚡️**: Fully compatible with React Server Actions on Next.js, TanStack Start, and more.
+- **Standard Schema Support 🗂️**: Effortlessly work with Zod, Valibot, ArkType, and others right out of the box.
+- **Fast & Lightweight 💨**: Built on native APIs across all runtimes – optimized for speed and efficiency.
+- **Native Types 📦**: Enjoy built-in support for Date, File, Blob, BigInt, URL and more with no extra setup.
+- **Lazy Router ⏱️**: Improve cold start times with our lazy routing feature.
+- **SSE & Streaming 📡**: Provides SSE and streaming features – perfect for real-time notifications and AI-powered streaming responses.
+- **Reusability 🔄**: Write once and reuse your code across multiple purposes effortlessly.
+- **Extendability 🔌**: Easily enhance oRPC with plugins, middleware, and interceptors.
+- **Reliability 🛡️**: Well-tested, fully TypeScript, production-ready, and MIT licensed for peace of mind.
+- **Simplicity 💡**: Enjoy straightforward, clean code with no hidden magic.
+
+## Documentation
+
+You can find the full documentation [here](https://orpc.unnoq.com).
+
+## Packages
+
+- [@orpc/contract](https://www.npmjs.com/package/@orpc/contract): Build your API contract.
+- [@orpc/server](https://www.npmjs.com/package/@orpc/server): Build your API or implement API contract.
+- [@orpc/client](https://www.npmjs.com/package/@orpc/client): Consume your API on the client with type-safety.
+- [@orpc/react-query](https://www.npmjs.com/package/@orpc/react-query): Integration with [React Query](https://tanstack.com/query/latest/docs/framework/react/overview).
+- [@orpc/vue-query](https://www.npmjs.com/package/@orpc/vue-query): Integration with [Vue Query](https://tanstack.com/query/latest/docs/framework/vue/overview).
+- [@orpc/vue-colada](https://www.npmjs.com/package/@orpc/vue-colada): Integration with [Pinia Colada](https://pinia-colada.esm.dev/).
+- [@orpc/openapi](https://www.npmjs.com/package/@orpc/openapi): Generate OpenAPI specs and handle OpenAPI requests.
+- [@orpc/zod](https://www.npmjs.com/package/@orpc/zod): More schemas that [Zod](https://zod.dev/) doesn't support yet.
+
+## `@orpc/openapi`
+
+Generate OpenAPI specs and handle OpenAPI requests. Read the [documentation](https://orpc.unnoq.com/docs/openapi/getting-started) for more information.
+
+```ts
+import { createServer } from 'node:http'
+import { OpenAPIHandler } from '@orpc/openapi/node'
+import { CORSPlugin } from '@orpc/server/plugins'
+
+const handler = new OpenAPIHandler(router, {
+  plugins: [new CORSPlugin()]
+})
+
+const server = createServer(async (req, res) => {
+  const result = await handler.handle(req, res, {
+    context: { headers: req.headers }
+  })
+
+  if (!result.matched) {
+    res.statusCode = 404
+    res.end('No procedure matched')
+  }
+})
+
+server.listen(3000, '127.0.0.1', () => console.log('Listening on 127.0.0.1:3000'))
+```
+
+## License
+
+Distributed under the MIT License. See [LICENSE](https://github.com/unnoq/orpc/blob/main/LICENSE) for more information.

package/dist/{chunk-HQ34JZI7.js → chunk-5TK7F2TC.js}

@@ -1,27 +1,27 @@
 import {
   OpenAPICodec,
   OpenAPIMatcher
-} from "./chunk-M5HOHBLW.js";
+} from "./chunk-LTTK3H5J.js";
 
 // src/adapters/fetch/openapi-handler.ts
-import { fetchRequestToStandardRequest, standardResponseToFetchResponse } from "@orpc/server/fetch";
 import { StandardHandler } from "@orpc/server/standard";
+import { toFetchResponse, toStandardRequest } from "@orpc/standard-server-fetch";
 var OpenAPIHandler = class {
   standardHandler;
   constructor(router, options) {
-    const matcher = options?.matcher ?? new OpenAPIMatcher(options);
-    const codec = options?.codec ?? new OpenAPICodec(options);
+    const matcher = options?.matcher ?? new OpenAPIMatcher();
+    const codec = options?.codec ?? new OpenAPICodec();
     this.standardHandler = new StandardHandler(router, matcher, codec, options);
   }
-  async handle(request, ...rest) {
-    const standardRequest = fetchRequestToStandardRequest(request);
-    const result = await this.standardHandler.handle(standardRequest, ...rest);
+  async handle(request, ...[options]) {
+    const standardRequest = toStandardRequest(request);
+    const result = await this.standardHandler.handle(standardRequest, options);
     if (!result.matched) {
       return result;
     }
     return {
       matched: true,
-      response: standardResponseToFetchResponse(result.response)
+      response: toFetchResponse(result.response, options)
     };
   }
 };
@@ -29,4 +29,4 @@ var OpenAPIHandler = class {
 export {
   OpenAPIHandler
 };
-//# sourceMappingURL=chunk-HQ34JZI7.js.map
+//# sourceMappingURL=chunk-5TK7F2TC.js.map

package/dist/chunk-LTTK3H5J.js

@@ -0,0 +1,157 @@
+import {
+  standardizeHTTPPath
+} from "./chunk-XGHV4TH3.js";
+
+// src/adapters/standard/openapi-codec.ts
+import { OpenAPISerializer } from "@orpc/client/openapi";
+import { fallbackContractConfig } from "@orpc/contract";
+import { isObject } from "@orpc/shared";
+var OpenAPICodec = class {
+  constructor(serializer = new OpenAPISerializer()) {
+    this.serializer = serializer;
+  }
+  async decode(request, params, procedure) {
+    const inputStructure = fallbackContractConfig("defaultInputStructure", procedure["~orpc"].route.inputStructure);
+    if (inputStructure === "compact") {
+      const data = request.method === "GET" ? this.serializer.deserialize(request.url.searchParams) : this.serializer.deserialize(await request.body());
+      if (data === void 0) {
+        return params;
+      }
+      if (isObject(data)) {
+        return {
+          ...params,
+          ...data
+        };
+      }
+      return data;
+    }
+    const deserializeSearchParams = () => {
+      return this.serializer.deserialize(request.url.searchParams);
+    };
+    return {
+      params,
+      get query() {
+        const value = deserializeSearchParams();
+        Object.defineProperty(this, "query", { value, writable: true });
+        return value;
+      },
+      set query(value) {
+        Object.defineProperty(this, "query", { value, writable: true });
+      },
+      headers: request.headers,
+      body: this.serializer.deserialize(await request.body())
+    };
+  }
+  encode(output, procedure) {
+    const successStatus = fallbackContractConfig("defaultSuccessStatus", procedure["~orpc"].route.successStatus);
+    const outputStructure = fallbackContractConfig("defaultOutputStructure", procedure["~orpc"].route.outputStructure);
+    if (outputStructure === "compact") {
+      return {
+        status: successStatus,
+        headers: {},
+        body: this.serializer.serialize(output)
+      };
+    }
+    if (!isObject(output)) {
+      throw new Error(
+        'Invalid output structure for "detailed" output. Expected format: { body: any, headers?: Record<string, string | string[] | undefined> }'
+      );
+    }
+    return {
+      status: successStatus,
+      headers: output.headers ?? {},
+      body: this.serializer.serialize(output.body)
+    };
+  }
+  encodeError(error) {
+    return {
+      status: error.status,
+      headers: {},
+      body: this.serializer.serialize(error.toJSON())
+    };
+  }
+};
+
+// src/adapters/standard/openapi-matcher.ts
+import { fallbackContractConfig as fallbackContractConfig2 } from "@orpc/contract";
+import { convertPathToHttpPath, createContractedProcedure, eachContractProcedure, getLazyRouterPrefix, getRouterChild, isProcedure, unlazy } from "@orpc/server";
+import { addRoute, createRouter, findRoute } from "rou3";
+var OpenAPIMatcher = class {
+  tree = createRouter();
+  pendingRouters = [];
+  init(router, path = []) {
+    const laziedOptions = eachContractProcedure({
+      router,
+      path
+    }, ({ path: path2, contract }) => {
+      const method = fallbackContractConfig2("defaultMethod", contract["~orpc"].route.method);
+      const httpPath = contract["~orpc"].route.path ? toRou3Pattern(contract["~orpc"].route.path) : convertPathToHttpPath(path2);
+      if (isProcedure(contract)) {
+        addRoute(this.tree, method, httpPath, {
+          path: path2,
+          contract,
+          procedure: contract,
+          // this mean dev not used contract-first so we can used contract as procedure directly
+          router
+        });
+      } else {
+        addRoute(this.tree, method, httpPath, {
+          path: path2,
+          contract,
+          procedure: void 0,
+          router
+        });
+      }
+    });
+    this.pendingRouters.push(...laziedOptions.map((option) => ({
+      ...option,
+      httpPathPrefix: convertPathToHttpPath(option.path),
+      laziedPrefix: getLazyRouterPrefix(option.lazied)
+    })));
+  }
+  async match(method, pathname) {
+    if (this.pendingRouters.length) {
+      const newPendingRouters = [];
+      for (const pendingRouter of this.pendingRouters) {
+        if (!pendingRouter.laziedPrefix || pathname.startsWith(pendingRouter.laziedPrefix) || pathname.startsWith(pendingRouter.httpPathPrefix)) {
+          const { default: router } = await unlazy(pendingRouter.lazied);
+          this.init(router, pendingRouter.path);
+        } else {
+          newPendingRouters.push(pendingRouter);
+        }
+      }
+      this.pendingRouters = newPendingRouters;
+    }
+    const match = findRoute(this.tree, method, pathname);
+    if (!match) {
+      return void 0;
+    }
+    if (!match.data.procedure) {
+      const { default: maybeProcedure } = await unlazy(getRouterChild(match.data.router, ...match.data.path));
+      if (!isProcedure(maybeProcedure)) {
+        throw new Error(`
+          [Contract-First] Missing or invalid implementation for procedure at path: ${convertPathToHttpPath(match.data.path)}.
+          Ensure that the procedure is correctly defined and matches the expected contract.
+        `);
+      }
+      match.data.procedure = createContractedProcedure(match.data.contract, maybeProcedure);
+    }
+    return {
+      path: match.data.path,
+      procedure: match.data.procedure,
+      params: match.params ? decodeParams(match.params) : void 0
+    };
+  }
+};
+function toRou3Pattern(path) {
+  return standardizeHTTPPath(path).replace(/\{\+([^}]+)\}/g, "**:$1").replace(/\{([^}]+)\}/g, ":$1");
+}
+function decodeParams(params) {
+  return Object.fromEntries(Object.entries(params).map(([key, value]) => [key, decodeURIComponent(value)]));
+}
+
+export {
+  OpenAPICodec,
+  OpenAPIMatcher
+};
+//# sourceMappingURL=chunk-LTTK3H5J.js.map

package/dist/chunk-XGHV4TH3.js

@@ -0,0 +1,13 @@
+// src/utils.ts
+function standardizeHTTPPath(path) {
+  return `/${path.replace(/\/{2,}/g, "/").replace(/^\/|\/$/g, "")}`;
+}
+function toOpenAPI31RoutePattern(path) {
+  return standardizeHTTPPath(path).replace(/\{\+([^}]+)\}/g, "{$1}");
+}
+
+export {
+  standardizeHTTPPath,
+  toOpenAPI31RoutePattern
+};
+//# sourceMappingURL=chunk-XGHV4TH3.js.map

package/dist/fetch.js

@@ -1,8 +1,8 @@
 import {
   OpenAPIHandler
-} from "./chunk-HQ34JZI7.js";
-import "./chunk-M5HOHBLW.js";
-import "./chunk-BHJYKXQL.js";
+} from "./chunk-5TK7F2TC.js";
+import "./chunk-LTTK3H5J.js";
+import "./chunk-XGHV4TH3.js";
 export {
   OpenAPIHandler
 };

package/dist/hono.js

@@ -1,8 +1,8 @@
 import {
   OpenAPIHandler
-} from "./chunk-HQ34JZI7.js";
-import "./chunk-M5HOHBLW.js";
-import "./chunk-BHJYKXQL.js";
+} from "./chunk-5TK7F2TC.js";
+import "./chunk-LTTK3H5J.js";
+import "./chunk-XGHV4TH3.js";
 export {
   OpenAPIHandler
 };

package/dist/index.js

@@ -1,7 +1,53 @@
 import {
-  JSONSerializer,
-  standardizeHTTPPath
-} from "./chunk-BHJYKXQL.js";
+  standardizeHTTPPath,
+  toOpenAPI31RoutePattern
+} from "./chunk-XGHV4TH3.js";
+
+// src/openapi-operation-extender.ts
+import { isProcedure } from "@orpc/server";
+var OPERATION_EXTENDER_SYMBOL = Symbol("ORPC_OPERATION_EXTENDER");
+function setOperationExtender(o, extend) {
+  return new Proxy(o, {
+    get(target, prop, receiver) {
+      if (prop === OPERATION_EXTENDER_SYMBOL) {
+        return extend;
+      }
+      return Reflect.get(target, prop, receiver);
+    }
+  });
+}
+function getOperationExtender(o) {
+  return o[OPERATION_EXTENDER_SYMBOL];
+}
+function extendOperation(operation, procedure) {
+  const operationExtenders = [];
+  for (const errorItem of Object.values(procedure["~orpc"].errorMap)) {
+    const maybeExtender = getOperationExtender(errorItem);
+    if (maybeExtender) {
+      operationExtenders.push(maybeExtender);
+    }
+  }
+  if (isProcedure(procedure)) {
+    for (const middleware of procedure["~orpc"].middlewares) {
+      const maybeExtender = getOperationExtender(middleware);
+      if (maybeExtender) {
+        operationExtenders.push(maybeExtender);
+      }
+    }
+  }
+  let currentOperation = operation;
+  for (const extender of operationExtenders) {
+    if (typeof extender === "function") {
+      currentOperation = extender(currentOperation, procedure);
+    } else {
+      currentOperation = {
+        ...currentOperation,
+        ...extender
+      };
+    }
+  }
+  return currentOperation;
+}
 
 // src/openapi.ts
 import { OpenApiBuilder } from "openapi3-ts/oas31";
@@ -34,7 +80,9 @@ var OpenAPIContentBuilder = class {
 };
 
 // src/openapi-generator.ts
-import { fallbackContractConfig as fallbackContractConfig2, fallbackORPCErrorStatus } from "@orpc/contract";
+import { fallbackORPCErrorStatus } from "@orpc/client";
+import { OpenAPIJsonSerializer } from "@orpc/client/openapi";
+import { fallbackContractConfig as fallbackContractConfig2, getEventIteratorSchemaDetails } from "@orpc/contract";
 import { eachAllContractProcedure } from "@orpc/server";
 import { group } from "@orpc/shared";
 
@@ -183,14 +231,14 @@ var OpenAPIOutputStructureParser = class {
 };
 
 // src/openapi-parameters-builder.ts
-import { get, isPlainObject, omit } from "@orpc/shared";
+import { get, isObject, omit } from "@orpc/shared";
 var OpenAPIParametersBuilder = class {
   build(paramIn, jsonSchema, options) {
     const parameters = [];
     for (const name in jsonSchema.properties) {
       const schema = jsonSchema.properties[name];
       const paramExamples = jsonSchema.examples?.filter((example) => {
-        return isPlainObject(example) && name in example;
+        return isObject(example) && name in example;
       }).map((example) => {
         return example[name];
       });
@@ -251,7 +299,7 @@ var CompositeSchemaConverter = class {
 };
 
 // src/schema-utils.ts
-import { isPlainObject as isPlainObject2 } from "@orpc/shared";
+import { isObject as isObject2 } from "@orpc/shared";
 
 // src/schema.ts
 import * as JSONSchema from "json-schema-typed/draft-2020-12";
@@ -287,10 +335,10 @@ var NON_LOGIC_KEYWORDS = [
 // src/schema-utils.ts
 var SchemaUtils = class {
   isFileSchema(schema) {
-    return typeof schema === "object" && schema.type === "string" && typeof schema.contentMediaType === "string";
+    return isObject2(schema) && schema.type === "string" && typeof schema.contentMediaType === "string";
   }
   isObjectSchema(schema) {
-    return typeof schema === "object" && schema.type === "object";
+    return isObject2(schema) && schema.type === "object";
   }
   isAnySchema(schema) {
     return schema === true || Object.keys(schema).filter((key) => !NON_LOGIC_KEYWORDS.includes(key)).length === 0;
@@ -313,7 +361,7 @@ var SchemaUtils = class {
     }, {});
     matched.required = schema.required?.filter((key) => separatedProperties.includes(key));
     matched.examples = schema.examples?.map((example) => {
-      if (!isPlainObject2(example)) {
+      if (!isObject2(example)) {
         return example;
       }
       return Object.entries(example).reduce((acc, [key, value]) => {
@@ -329,7 +377,7 @@ var SchemaUtils = class {
     }, {});
     rest.required = schema.required?.filter((key) => !separatedProperties.includes(key));
     rest.examples = schema.examples?.map((example) => {
-      if (!isPlainObject2(example)) {
+      if (!isObject2(example)) {
         return example;
       }
       return Object.entries(example).reduce((acc, [key, value]) => {
@@ -389,7 +437,7 @@ var OpenAPIGenerator = class {
     this.parametersBuilder = options?.parametersBuilder ?? new OpenAPIParametersBuilder();
     this.schemaConverter = new CompositeSchemaConverter(options?.schemaConverters ?? []);
     this.schemaUtils = options?.schemaUtils ?? new SchemaUtils();
-    this.jsonSerializer = options?.jsonSerializer ?? new JSONSerializer();
+    this.jsonSerializer = options?.jsonSerializer ?? new OpenAPIJsonSerializer();
     this.contentBuilder = options?.contentBuilder ?? new OpenAPIContentBuilder(this.schemaUtils);
     this.pathParser = new OpenAPIPathParser();
     this.inputStructureParser = options?.inputStructureParser ?? new OpenAPIInputStructureParser(this.schemaConverter, this.schemaUtils, this.pathParser);
@@ -415,27 +463,124 @@ var OpenAPIGenerator = class {
           return;
         }
         const method = fallbackContractConfig2("defaultMethod", def.route?.method);
-        const httpPath = def.route?.path ? standardizeHTTPPath(def.route?.path) : `/${path.map(encodeURIComponent).join("/")}`;
-        const inputStructure = fallbackContractConfig2("defaultInputStructure", def.route?.inputStructure);
-        const outputStructure = fallbackContractConfig2("defaultOutputStructure", def.route?.outputStructure);
-        const { paramsSchema, querySchema, headersSchema, bodySchema } = this.inputStructureParser.parse(contract, inputStructure);
-        const { headersSchema: resHeadersSchema, bodySchema: resBodySchema } = this.outputStructureParser.parse(contract, outputStructure);
-        const params = paramsSchema ? this.parametersBuilder.build("path", paramsSchema, {
-          required: true
-        }) : [];
-        const query = querySchema ? this.parametersBuilder.build("query", querySchema) : [];
-        const headers = headersSchema ? this.parametersBuilder.build("header", headersSchema) : [];
-        const parameters = [...params, ...query, ...headers];
-        const requestBody = bodySchema !== void 0 ? {
-          required: this.schemaUtils.isUndefinableSchema(bodySchema),
-          content: this.contentBuilder.build(bodySchema)
-        } : void 0;
-        const responses = {};
-        responses[fallbackContractConfig2("defaultSuccessStatus", def.route?.successStatus)] = {
-          description: fallbackContractConfig2("defaultSuccessDescription", def.route?.successDescription),
-          content: resBodySchema !== void 0 ? this.contentBuilder.build(resBodySchema) : void 0,
-          headers: resHeadersSchema !== void 0 ? this.parametersBuilder.buildHeadersObject(resHeadersSchema) : void 0
-        };
+        const httpPath = def.route?.path ? toOpenAPI31RoutePattern(def.route?.path) : `/${path.map(encodeURIComponent).join("/")}`;
+        const { parameters, requestBody } = (() => {
+          const eventIteratorSchemaDetails = getEventIteratorSchemaDetails(def.inputSchema);
+          if (eventIteratorSchemaDetails) {
+            const requestBody3 = {
+              required: true,
+              content: {
+                "text/event-stream": {
+                  schema: {
+                    oneOf: [
+                      {
+                        type: "object",
+                        properties: {
+                          event: { type: "string", const: "message" },
+                          data: this.schemaConverter.convert(eventIteratorSchemaDetails.yields, { strategy: "input" }),
+                          id: { type: "string" },
+                          retry: { type: "number" }
+                        },
+                        required: ["event", "data"]
+                      },
+                      {
+                        type: "object",
+                        properties: {
+                          event: { type: "string", const: "done" },
+                          data: this.schemaConverter.convert(eventIteratorSchemaDetails.returns, { strategy: "input" }),
+                          id: { type: "string" },
+                          retry: { type: "number" }
+                        },
+                        required: ["event", "data"]
+                      },
+                      {
+                        type: "object",
+                        properties: {
+                          event: { type: "string", const: "error" },
+                          data: {},
+                          id: { type: "string" },
+                          retry: { type: "number" }
+                        },
+                        required: ["event", "data"]
+                      }
+                    ]
+                  }
+                }
+              }
+            };
+            return { requestBody: requestBody3, parameters: [] };
+          }
+          const inputStructure = fallbackContractConfig2("defaultInputStructure", def.route?.inputStructure);
+          const { paramsSchema, querySchema, headersSchema, bodySchema } = this.inputStructureParser.parse(contract, inputStructure);
+          const params = paramsSchema ? this.parametersBuilder.build("path", paramsSchema, {
+            required: true
+          }) : [];
+          const query = querySchema ? this.parametersBuilder.build("query", querySchema) : [];
+          const headers = headersSchema ? this.parametersBuilder.build("header", headersSchema) : [];
+          const parameters2 = [...params, ...query, ...headers];
+          const requestBody2 = bodySchema !== void 0 ? {
+            required: this.schemaUtils.isUndefinableSchema(bodySchema),
+            content: this.contentBuilder.build(bodySchema)
+          } : void 0;
+          return { parameters: parameters2, requestBody: requestBody2 };
+        })();
+        const { responses } = (() => {
+          const eventIteratorSchemaDetails = getEventIteratorSchemaDetails(def.outputSchema);
+          if (eventIteratorSchemaDetails) {
+            const responses3 = {};
+            responses3[fallbackContractConfig2("defaultSuccessStatus", def.route?.successStatus)] = {
+              description: fallbackContractConfig2("defaultSuccessDescription", def.route?.successDescription),
+              content: {
+                "text/event-stream": {
+                  schema: {
+                    oneOf: [
+                      {
+                        type: "object",
+                        properties: {
+                          event: { type: "string", const: "message" },
+                          data: this.schemaConverter.convert(eventIteratorSchemaDetails.yields, { strategy: "input" }),
+                          id: { type: "string" },
+                          retry: { type: "number" }
+                        },
+                        required: ["event", "data"]
+                      },
+                      {
+                        type: "object",
+                        properties: {
+                          event: { type: "string", const: "done" },
+                          data: this.schemaConverter.convert(eventIteratorSchemaDetails.returns, { strategy: "input" }),
+                          id: { type: "string" },
+                          retry: { type: "number" }
+                        },
+                        required: ["event", "data"]
+                      },
+                      {
+                        type: "object",
+                        properties: {
+                          event: { type: "string", const: "error" },
+                          data: {},
+                          id: { type: "string" },
+                          retry: { type: "number" }
+                        },
+                        required: ["event", "data"]
+                      }
+                    ]
+                  }
+                }
+              }
+            };
+            return { responses: responses3 };
+          }
+          const outputStructure = fallbackContractConfig2("defaultOutputStructure", def.route?.outputStructure);
+          const { headersSchema: resHeadersSchema, bodySchema: resBodySchema } = this.outputStructureParser.parse(contract, outputStructure);
+          const responses2 = {};
+          responses2[fallbackContractConfig2("defaultSuccessStatus", def.route?.successStatus)] = {
+            description: fallbackContractConfig2("defaultSuccessDescription", def.route?.successDescription),
+            content: resBodySchema !== void 0 ? this.contentBuilder.build(resBodySchema) : void 0,
+            headers: resHeadersSchema !== void 0 ? this.parametersBuilder.buildHeadersObject(resHeadersSchema) : void 0
+          };
+          return { responses: responses2 };
+        })();
         const errors = group(Object.entries(def.errorMap ?? {}).filter(([_, config]) => config).map(([code, config]) => ({
           ...config,
           code,
@@ -506,8 +651,9 @@ var OpenAPIGenerator = class {
           requestBody,
           responses
         };
+        const extendedOperation = extendOperation(operation, contract);
         builder.addPath(httpPath, {
-          [method.toLocaleLowerCase()]: operation
+          [method.toLocaleLowerCase()]: extendedOperation
         });
       } catch (e) {
         if (e instanceof OpenAPIError) {
@@ -526,14 +672,18 @@ var OpenAPIGenerator = class {
         }
       }
     });
-    return this.jsonSerializer.serialize(builder.getSpec());
+    return this.jsonSerializer.serialize(builder.getSpec())[0];
   }
 };
+
+// src/index.ts
+var oo = {
+  spec: setOperationExtender
+};
 export {
   CompositeSchemaConverter,
   JSONSchema,
   Format as JSONSchemaFormat,
-  JSONSerializer,
   NON_LOGIC_KEYWORDS,
   OpenAPIContentBuilder,
   OpenAPIGenerator,
@@ -541,6 +691,11 @@ export {
   OpenAPIPathParser,
   OpenApiBuilder,
   SchemaUtils,
-  standardizeHTTPPath
+  extendOperation,
+  getOperationExtender,
+  oo,
+  setOperationExtender,
+  standardizeHTTPPath,
+  toOpenAPI31RoutePattern
 };
 //# sourceMappingURL=index.js.map

package/dist/next.js

@@ -1,8 +1,8 @@
 import {
   OpenAPIHandler
-} from "./chunk-HQ34JZI7.js";
-import "./chunk-M5HOHBLW.js";
-import "./chunk-BHJYKXQL.js";
+} from "./chunk-5TK7F2TC.js";
+import "./chunk-LTTK3H5J.js";
+import "./chunk-XGHV4TH3.js";
 export {
   OpenAPIHandler
 };