@orpc/openapi 0.0.0-next.af8ac85 → 0.0.0-next.b2e67f7

package/dist/index.js

@@ -1,9 +1,53 @@
 import {
-  JSONSerializer,
-  forEachAllContractProcedure,
-  forEachContractProcedure,
-  standardizeHTTPPath
-} from "./chunk-KNYXLM77.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";
@@ -35,15 +79,166 @@ var OpenAPIContentBuilder = class {
   }
 };
 
+// src/openapi-generator.ts
+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";
+
+// src/openapi-error.ts
+var OpenAPIError = class extends Error {
+};
+
+// src/openapi-input-structure-parser.ts
+import { fallbackContractConfig } from "@orpc/contract";
+var OpenAPIInputStructureParser = class {
+  constructor(schemaConverter, schemaUtils, pathParser) {
+    this.schemaConverter = schemaConverter;
+    this.schemaUtils = schemaUtils;
+    this.pathParser = pathParser;
+  }
+  parse(contract, structure) {
+    const inputSchema = this.schemaConverter.convert(contract["~orpc"].inputSchema, { strategy: "input" });
+    const method = fallbackContractConfig("defaultMethod", contract["~orpc"].route?.method);
+    const httpPath = contract["~orpc"].route?.path;
+    if (this.schemaUtils.isAnySchema(inputSchema)) {
+      return {
+        paramsSchema: void 0,
+        querySchema: void 0,
+        headersSchema: void 0,
+        bodySchema: void 0
+      };
+    }
+    if (structure === "detailed") {
+      return this.parseDetailedSchema(inputSchema);
+    } else {
+      return this.parseCompactSchema(inputSchema, method, httpPath);
+    }
+  }
+  parseDetailedSchema(inputSchema) {
+    if (!this.schemaUtils.isObjectSchema(inputSchema)) {
+      throw new OpenAPIError(`When input structure is 'detailed', input schema must be an object.`);
+    }
+    if (inputSchema.properties && Object.keys(inputSchema.properties).some((key) => !["params", "query", "headers", "body"].includes(key))) {
+      throw new OpenAPIError(`When input structure is 'detailed', input schema must be only can contain 'params', 'query', 'headers' and 'body' properties.`);
+    }
+    let paramsSchema = inputSchema.properties?.params;
+    let querySchema = inputSchema.properties?.query;
+    let headersSchema = inputSchema.properties?.headers;
+    const bodySchema = inputSchema.properties?.body;
+    if (paramsSchema !== void 0 && this.schemaUtils.isAnySchema(paramsSchema)) {
+      paramsSchema = void 0;
+    }
+    if (paramsSchema !== void 0 && !this.schemaUtils.isObjectSchema(paramsSchema)) {
+      throw new OpenAPIError(`When input structure is 'detailed', params schema in input schema must be an object.`);
+    }
+    if (querySchema !== void 0 && this.schemaUtils.isAnySchema(querySchema)) {
+      querySchema = void 0;
+    }
+    if (querySchema !== void 0 && !this.schemaUtils.isObjectSchema(querySchema)) {
+      throw new OpenAPIError(`When input structure is 'detailed', query schema in input schema must be an object.`);
+    }
+    if (headersSchema !== void 0 && this.schemaUtils.isAnySchema(headersSchema)) {
+      headersSchema = void 0;
+    }
+    if (headersSchema !== void 0 && !this.schemaUtils.isObjectSchema(headersSchema)) {
+      throw new OpenAPIError(`When input structure is 'detailed', headers schema in input schema must be an object.`);
+    }
+    return { paramsSchema, querySchema, headersSchema, bodySchema };
+  }
+  parseCompactSchema(inputSchema, method, httpPath) {
+    const dynamic = httpPath ? this.pathParser.parseDynamicParams(httpPath) : [];
+    if (dynamic.length === 0) {
+      if (method === "GET") {
+        let querySchema = inputSchema;
+        if (querySchema !== void 0 && this.schemaUtils.isAnySchema(querySchema)) {
+          querySchema = void 0;
+        }
+        if (querySchema !== void 0 && !this.schemaUtils.isObjectSchema(querySchema)) {
+          throw new OpenAPIError(`When input structure is 'compact' and method is 'GET', input schema must be an object.`);
+        }
+        return {
+          paramsSchema: void 0,
+          querySchema,
+          headersSchema: void 0,
+          bodySchema: void 0
+        };
+      }
+      return {
+        paramsSchema: void 0,
+        querySchema: void 0,
+        headersSchema: void 0,
+        bodySchema: inputSchema
+      };
+    }
+    if (!this.schemaUtils.isObjectSchema(inputSchema)) {
+      throw new OpenAPIError(`When input structure is 'compact' and path has dynamic parameters, input schema must be an object.`);
+    }
+    const [params, rest] = this.schemaUtils.separateObjectSchema(inputSchema, dynamic.map((v) => v.name));
+    return {
+      paramsSchema: params,
+      querySchema: method === "GET" ? rest : void 0,
+      headersSchema: void 0,
+      bodySchema: method !== "GET" ? rest : void 0
+    };
+  }
+};
+
+// src/openapi-output-structure-parser.ts
+var OpenAPIOutputStructureParser = class {
+  constructor(schemaConverter, schemaUtils) {
+    this.schemaConverter = schemaConverter;
+    this.schemaUtils = schemaUtils;
+  }
+  parse(contract, structure) {
+    const outputSchema = this.schemaConverter.convert(contract["~orpc"].outputSchema, { strategy: "output" });
+    if (this.schemaUtils.isAnySchema(outputSchema)) {
+      return {
+        headersSchema: void 0,
+        bodySchema: void 0
+      };
+    }
+    if (structure === "detailed") {
+      return this.parseDetailedSchema(outputSchema);
+    } else {
+      return this.parseCompactSchema(outputSchema);
+    }
+  }
+  parseDetailedSchema(outputSchema) {
+    if (!this.schemaUtils.isObjectSchema(outputSchema)) {
+      throw new OpenAPIError(`When output structure is 'detailed', output schema must be an object.`);
+    }
+    if (outputSchema.properties && Object.keys(outputSchema.properties).some((key) => !["headers", "body"].includes(key))) {
+      throw new OpenAPIError(`When output structure is 'detailed', output schema must be only can contain 'headers' and 'body' properties.`);
+    }
+    let headersSchema = outputSchema.properties?.headers;
+    const bodySchema = outputSchema.properties?.body;
+    if (headersSchema !== void 0 && this.schemaUtils.isAnySchema(headersSchema)) {
+      headersSchema = void 0;
+    }
+    if (headersSchema !== void 0 && !this.schemaUtils.isObjectSchema(headersSchema)) {
+      throw new OpenAPIError(`When output structure is 'detailed', headers schema in output schema must be an object.`);
+    }
+    return { headersSchema, bodySchema };
+  }
+  parseCompactSchema(outputSchema) {
+    return {
+      headersSchema: void 0,
+      bodySchema: outputSchema
+    };
+  }
+};
+
 // src/openapi-parameters-builder.ts
-import { get, isPlainObject } 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];
       });
@@ -63,6 +258,14 @@ var OpenAPIParametersBuilder = class {
     }
     return parameters;
   }
+  buildHeadersObject(jsonSchema, options) {
+    const parameters = this.build("header", jsonSchema, options);
+    const headersObject = {};
+    for (const param of parameters) {
+      headersObject[param.name] = omit(param, ["name", "in"]);
+    }
+    return headersObject;
+  }
 };
 
 // src/openapi-path-parser.ts
@@ -96,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";
@@ -132,20 +335,20 @@ 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).length === 0;
+    return schema === true || Object.keys(schema).filter((key) => !NON_LOGIC_KEYWORDS.includes(key)).length === 0;
   }
   isUndefinableSchema(schema) {
     const [matches] = this.filterSchemaBranches(schema, (schema2) => {
       if (typeof schema2 === "boolean") {
         return schema2;
       }
-      return Object.keys(schema2).length === 0;
+      return Object.keys(schema2).filter((key) => !NON_LOGIC_KEYWORDS.includes(key)).length === 0;
     });
     return matches.length > 0;
   }
@@ -158,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]) => {
@@ -174,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]) => {
@@ -218,136 +421,269 @@ var SchemaUtils = class {
 
 // src/openapi-generator.ts
 var OpenAPIGenerator = class {
+  contentBuilder;
+  parametersBuilder;
+  schemaConverter;
+  schemaUtils;
+  jsonSerializer;
+  pathParser;
+  inputStructureParser;
+  outputStructureParser;
+  errorHandlerStrategy;
+  ignoreUndefinedPathProcedures;
+  considerMissingTagDefinitionAsError;
+  strictErrorResponses;
   constructor(options) {
-    this.options = options;
     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);
+    this.outputStructureParser = options?.outputStructureParser ?? new OpenAPIOutputStructureParser(this.schemaConverter, this.schemaUtils);
+    this.errorHandlerStrategy = options?.errorHandlerStrategy ?? "throw";
+    this.ignoreUndefinedPathProcedures = options?.ignoreUndefinedPathProcedures ?? false;
+    this.considerMissingTagDefinitionAsError = options?.considerMissingTagDefinitionAsError ?? false;
+    this.strictErrorResponses = options?.strictErrorResponses ?? true;
   }
-  contentBuilder;
-  parametersBuilder;
-  schemaConverter;
-  schemaUtils;
-  jsonSerializer;
-  pathParser;
   async generate(router, doc) {
     const builder = new OpenApiBuilder({
       ...doc,
       openapi: "3.1.1"
     });
     const rootTags = doc.tags?.map((tag) => tag.name) ?? [];
-    await forEachAllContractProcedure(router, ({ contract, path }) => {
-      const def = contract["~orpc"];
-      if (this.options?.ignoreUndefinedPathProcedures && def.route?.path === void 0) {
-        return;
-      }
-      const method = def.route?.method ?? "POST";
-      const httpPath = def.route?.path ? standardizeHTTPPath(def.route?.path) : `/${path.map(encodeURIComponent).join("/")}`;
-      let inputSchema = this.schemaConverter.convert(def.InputSchema, { strategy: "input" });
-      const outputSchema = this.schemaConverter.convert(def.OutputSchema, { strategy: "output" });
-      const params = (() => {
-        const dynamic = this.pathParser.parseDynamicParams(httpPath);
-        if (!dynamic.length) {
-          return void 0;
-        }
-        if (this.schemaUtils.isAnySchema(inputSchema)) {
-          return void 0;
+    await eachAllContractProcedure({
+      path: [],
+      router
+    }, ({ contract, path }) => {
+      try {
+        const def = contract["~orpc"];
+        if (this.ignoreUndefinedPathProcedures && def.route?.path === void 0) {
+          return;
         }
-        if (!this.schemaUtils.isObjectSchema(inputSchema)) {
-          this.handleError(
-            new Error(
-              `When path has parameters, input schema must be an object [${path.join(".")}]`
-            )
-          );
-          return void 0;
+        const method = fallbackContractConfig2("defaultMethod", def.route?.method);
+        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,
+          status: fallbackORPCErrorStatus(code, config?.status)
+        })), (error) => error.status);
+        for (const status in errors) {
+          const configs = errors[status];
+          if (!configs || configs.length === 0) {
+            continue;
+          }
+          const schemas = configs.map(({ data, code, message }) => {
+            const json = {
+              type: "object",
+              properties: {
+                defined: { const: true },
+                code: { const: code },
+                status: { const: Number(status) },
+                message: { type: "string", default: message },
+                data: {}
+              },
+              required: ["defined", "code", "status", "message"]
+            };
+            if (data) {
+              const dataJson = this.schemaConverter.convert(data, { strategy: "output" });
+              json.properties.data = dataJson;
+              if (!this.schemaUtils.isUndefinableSchema(dataJson)) {
+                json.required.push("data");
+              }
+            }
+            return json;
+          });
+          if (this.strictErrorResponses) {
+            schemas.push({
+              type: "object",
+              properties: {
+                defined: { const: false },
+                code: { type: "string" },
+                status: { type: "number" },
+                message: { type: "string" },
+                data: {}
+              },
+              required: ["defined", "code", "status", "message"]
+            });
+          }
+          const contentSchema = schemas.length === 1 ? schemas[0] : {
+            oneOf: schemas
+          };
+          responses[status] = {
+            description: status,
+            content: this.contentBuilder.build(contentSchema)
+          };
         }
-        const [matched, rest] = this.schemaUtils.separateObjectSchema(inputSchema, dynamic.map((v) => v.name));
-        inputSchema = rest;
-        return this.parametersBuilder.build("path", matched, {
-          example: def.inputExample,
-          required: true
-        });
-      })();
-      const query = (() => {
-        if (method !== "GET" || Object.keys(inputSchema).length === 0) {
-          return void 0;
-        }
-        if (this.schemaUtils.isAnySchema(inputSchema)) {
-          return void 0;
-        }
-        if (!this.schemaUtils.isObjectSchema(inputSchema)) {
-          this.handleError(
-            new Error(
-              `When method is GET, input schema must be an object [${path.join(".")}]`
-            )
-          );
-          return void 0;
-        }
-        return this.parametersBuilder.build("query", inputSchema, {
-          example: def.inputExample
-        });
-      })();
-      const parameters = [...params ?? [], ...query ?? []];
-      const requestBody = (() => {
-        if (method === "GET") {
-          return void 0;
+        if (this.considerMissingTagDefinitionAsError && def.route?.tags) {
+          const missingTag = def.route?.tags.find((tag) => !rootTags.includes(tag));
+          if (missingTag !== void 0) {
+            throw new OpenAPIError(
+              `Tag "${missingTag}" is missing definition. Please define it in OpenAPI root tags object`
+            );
+          }
         }
-        return {
-          required: this.schemaUtils.isUndefinableSchema(inputSchema),
-          content: this.contentBuilder.build(inputSchema, {
-            example: def.inputExample
-          })
+        const operation = {
+          summary: def.route?.summary,
+          description: def.route?.description,
+          deprecated: def.route?.deprecated,
+          tags: def.route?.tags ? [...def.route.tags] : void 0,
+          operationId: path.join("."),
+          parameters: parameters.length ? parameters : void 0,
+          requestBody,
+          responses
         };
-      })();
-      const successResponse = {
-        description: "OK",
-        content: this.contentBuilder.build(outputSchema, {
-          example: def.outputExample
-        })
-      };
-      if (this.options?.considerMissingTagDefinitionAsError && def.route?.tags) {
-        const missingTag = def.route?.tags.find((tag) => !rootTags.includes(tag));
-        if (missingTag !== void 0) {
-          this.handleError(
-            new Error(
-              `Tag "${missingTag}" is missing definition. Please define it in OpenAPI root tags object. [${path.join(".")}]`
-            )
-          );
+        const extendedOperation = extendOperation(operation, contract);
+        builder.addPath(httpPath, {
+          [method.toLocaleLowerCase()]: extendedOperation
+        });
+      } catch (e) {
+        if (e instanceof OpenAPIError) {
+          const error = new OpenAPIError(`
+            Generate OpenAPI Error: ${e.message}
+            Happened at path: ${path.join(".")}
+          `, { cause: e });
+          if (this.errorHandlerStrategy === "throw") {
+            throw error;
+          }
+          if (this.errorHandlerStrategy === "log") {
+            console.error(error);
+          }
+        } else {
+          throw e;
         }
       }
-      const operation = {
-        summary: def.route?.summary,
-        description: def.route?.description,
-        deprecated: def.route?.deprecated,
-        tags: def.route?.tags ? [...def.route.tags] : void 0,
-        operationId: path.join("."),
-        parameters: parameters.length ? parameters : void 0,
-        requestBody,
-        responses: {
-          [def.route?.successStatus ?? 200]: successResponse
-        }
-      };
-      builder.addPath(httpPath, {
-        [method.toLocaleLowerCase()]: operation
-      });
     });
-    return this.jsonSerializer.serialize(builder.getSpec());
-  }
-  handleError(error) {
-    if (this.options?.throwOnError) {
-      throw error;
-    }
-    console.error(error);
+    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,
@@ -355,8 +691,11 @@ export {
   OpenAPIPathParser,
   OpenApiBuilder,
   SchemaUtils,
-  forEachAllContractProcedure,
-  forEachContractProcedure,
-  standardizeHTTPPath
+  extendOperation,
+  getOperationExtender,
+  oo,
+  setOperationExtender,
+  standardizeHTTPPath,
+  toOpenAPI31RoutePattern
 };
 //# sourceMappingURL=index.js.map