@temporary-name/server 1.9.3-alpha.6ef4729e23affbe6454d37025d1dfc4d998b0649 → 1.9.3-alpha.72daecd600ae901064d3c4f8ab780582c1335ffe

package/dist/openapi/index.mjs

@@ -0,0 +1,782 @@
+import { isObject, stringifyJSON, findDeepMatches, clone, value, fallbackContractConfig, toHttpPath, assertNever } from '@temporary-name/shared';
+import * as z from '@temporary-name/zod';
+import { s as standardizeHTTPPath, r as resolveContractProcedures, g as getDynamicParams, i as isAPIErrorStatus } from '../shared/server.DEC2sW8B.mjs';
+import { Z as ZodToJsonSchemaConverter, g as getEventIteratorSchemaDetails } from '../shared/server.D1LXM1bf.mjs';
+import { TypeName } from '@temporary-name/interop/json-schema-typed/draft-2020-12';
+export { ContentEncoding as JSONSchemaContentEncoding, Format as JSONSchemaFormat, TypeName as JSONSchemaTypeName } from '@temporary-name/interop/json-schema-typed/draft-2020-12';
+import '@temporary-name/standard-server';
+import '@temporary-name/server/openapi';
+import 'zod/v4/core';
+
+const OPERATION_EXTENDER_SYMBOL = Symbol("ORPC_OPERATION_EXTENDER");
+function customOpenAPIOperation(o, extend) {
+  return new Proxy(o, {
+    get(target, prop, receiver) {
+      if (prop === OPERATION_EXTENDER_SYMBOL) {
+        return extend;
+      }
+      return Reflect.get(target, prop, receiver);
+    }
+  });
+}
+function getCustomOpenAPIOperation(o) {
+  return o[OPERATION_EXTENDER_SYMBOL];
+}
+function applyCustomOpenAPIOperation(operation, contract) {
+  const operationCustoms = [];
+  for (const middleware of contract["~orpc"].middlewares) {
+    const maybeExtender = getCustomOpenAPIOperation(middleware);
+    if (maybeExtender) {
+      operationCustoms.push(maybeExtender);
+    }
+  }
+  let currentOperation = operation;
+  for (const custom of operationCustoms) {
+    if (typeof custom === "function") {
+      currentOperation = custom(currentOperation, contract);
+    } else {
+      currentOperation = {
+        ...currentOperation,
+        ...custom
+      };
+    }
+  }
+  return currentOperation;
+}
+
+const LOGIC_KEYWORDS = [
+  "$dynamicRef",
+  "$ref",
+  "additionalItems",
+  "additionalProperties",
+  "allOf",
+  "anyOf",
+  "const",
+  "contains",
+  "contentEncoding",
+  "contentMediaType",
+  "contentSchema",
+  "dependencies",
+  "dependentRequired",
+  "dependentSchemas",
+  "else",
+  "enum",
+  "exclusiveMaximum",
+  "exclusiveMinimum",
+  "format",
+  "if",
+  "items",
+  "maxContains",
+  "maximum",
+  "maxItems",
+  "maxLength",
+  "maxProperties",
+  "minContains",
+  "minimum",
+  "minItems",
+  "minLength",
+  "minProperties",
+  "multipleOf",
+  "not",
+  "oneOf",
+  "pattern",
+  "patternProperties",
+  "prefixItems",
+  "properties",
+  "propertyNames",
+  "required",
+  "then",
+  "type",
+  "unevaluatedItems",
+  "unevaluatedProperties",
+  "uniqueItems"
+];
+
+function isFileSchema(schema) {
+  return isObject(schema) && schema.type === "string" && typeof schema.contentMediaType === "string";
+}
+function isObjectSchema(schema) {
+  return isObject(schema) && schema.type === "object";
+}
+function isAnySchema(schema) {
+  if (schema === true) {
+    return true;
+  }
+  if (Object.keys(schema).every((k) => !LOGIC_KEYWORDS.includes(k))) {
+    return true;
+  }
+  return false;
+}
+function separateObjectSchema(schema, separatedProperties) {
+  if (Object.keys(schema).some(
+    (k) => !["type", "properties", "required", "additionalProperties"].includes(k) && LOGIC_KEYWORDS.includes(k) && schema[k] !== void 0
+  )) {
+    return [{ type: "object" }, schema];
+  }
+  const matched = { ...schema };
+  const rest = { ...schema };
+  matched.properties = separatedProperties.reduce((acc, key) => {
+    const keySchema = schema.properties?.[key] ?? schema.additionalProperties;
+    if (keySchema !== void 0) {
+      acc[key] = keySchema;
+    }
+    return acc;
+  }, {});
+  matched.required = schema.required?.filter((key) => separatedProperties.includes(key));
+  matched.examples = schema.examples?.map((example) => {
+    if (!isObject(example)) {
+      return example;
+    }
+    return Object.entries(example).reduce(
+      (acc, [key, value]) => {
+        if (separatedProperties.includes(key)) {
+          acc[key] = value;
+        }
+        return acc;
+      },
+      {}
+    );
+  });
+  rest.properties = schema.properties && Object.entries(schema.properties).filter(([key]) => !separatedProperties.includes(key)).reduce(
+    (acc, [key, value]) => {
+      acc[key] = value;
+      return acc;
+    },
+    {}
+  );
+  rest.required = schema.required?.filter((key) => !separatedProperties.includes(key));
+  rest.examples = schema.examples?.map((example) => {
+    if (!isObject(example)) {
+      return example;
+    }
+    return Object.entries(example).reduce(
+      (acc, [key, value]) => {
+        if (!separatedProperties.includes(key)) {
+          acc[key] = value;
+        }
+        return acc;
+      },
+      {}
+    );
+  });
+  return [matched, rest];
+}
+function filterSchemaBranches(schema, check, matches = []) {
+  if (check(schema)) {
+    matches.push(schema);
+    return [matches, void 0];
+  }
+  if (isObject(schema)) {
+    for (const keyword of ["anyOf", "oneOf"]) {
+      if (schema[keyword] && Object.keys(schema).every((k) => k === keyword || !LOGIC_KEYWORDS.includes(k))) {
+        const rest = schema[keyword].map((s) => filterSchemaBranches(s, check, matches)[1]).filter((v) => !!v);
+        if (rest.length === 1 && typeof rest[0] === "object") {
+          return [matches, { ...schema, [keyword]: void 0, ...rest[0] }];
+        }
+        return [matches, { ...schema, [keyword]: rest }];
+      }
+    }
+  }
+  return [matches, schema];
+}
+function applySchemaOptionality(required, schema) {
+  if (required) {
+    return schema;
+  }
+  return {
+    anyOf: [schema, { not: {} }]
+  };
+}
+function expandUnionSchema(schema) {
+  if (typeof schema === "object") {
+    for (const keyword of ["anyOf", "oneOf"]) {
+      if (schema[keyword] && Object.keys(schema).every((k) => k === keyword || !LOGIC_KEYWORDS.includes(k))) {
+        return schema[keyword].flatMap((s) => expandUnionSchema(s));
+      }
+    }
+  }
+  return [schema];
+}
+function expandArrayableSchema(schema) {
+  const schemas = expandUnionSchema(schema);
+  if (schemas.length !== 2) {
+    return void 0;
+  }
+  const arraySchema = schemas.find(
+    (s) => typeof s === "object" && s.type === "array" && Object.keys(s).filter((k) => LOGIC_KEYWORDS.includes(k)).every((k) => k === "type" || k === "items")
+  );
+  if (arraySchema === void 0) {
+    return void 0;
+  }
+  const items1 = arraySchema.items;
+  const items2 = schemas.find((s) => s !== arraySchema);
+  if (stringifyJSON(items1) !== stringifyJSON(items2)) {
+    return void 0;
+  }
+  return [items2, arraySchema];
+}
+const PRIMITIVE_SCHEMA_TYPES = /* @__PURE__ */ new Set([
+  TypeName.String,
+  TypeName.Number,
+  TypeName.Integer,
+  TypeName.Boolean,
+  TypeName.Null
+]);
+function isPrimitiveSchema(schema) {
+  return expandUnionSchema(schema).every((s) => {
+    if (typeof s === "boolean") {
+      return false;
+    }
+    if (typeof s.type === "string" && PRIMITIVE_SCHEMA_TYPES.has(s.type)) {
+      return true;
+    }
+    if (s.const !== void 0) {
+      return true;
+    }
+    return false;
+  });
+}
+
+function toOpenAPIPath(path) {
+  return standardizeHTTPPath(path).replace(/\/\{\+([^}]+)\}/g, "/{$1}");
+}
+function toOpenAPIMethod(method) {
+  return method.toLocaleLowerCase();
+}
+function toOpenAPIContent(schema) {
+  const content = {};
+  const [matches, restSchema] = filterSchemaBranches(schema, isFileSchema);
+  for (const file of matches) {
+    content[file.contentMediaType] = {
+      schema: toOpenAPISchema(file)
+    };
+  }
+  if (restSchema !== void 0) {
+    content["application/json"] = {
+      schema: toOpenAPISchema(restSchema)
+    };
+    const isStillHasFileSchema = findDeepMatches((v) => isObject(v) && isFileSchema(v), restSchema).values.length > 0;
+    if (isStillHasFileSchema) {
+      content["multipart/form-data"] = {
+        schema: toOpenAPISchema(restSchema)
+      };
+    }
+  }
+  return content;
+}
+function toOpenAPIEventIteratorContent([yieldsRequired, yieldsSchema], [returnsRequired, returnsSchema]) {
+  return {
+    "text/event-stream": {
+      schema: toOpenAPISchema({
+        oneOf: [
+          {
+            type: "object",
+            properties: {
+              event: { const: "message" },
+              data: yieldsSchema,
+              id: { type: "string" },
+              retry: { type: "number" }
+            },
+            required: yieldsRequired ? ["event", "data"] : ["event"]
+          },
+          {
+            type: "object",
+            properties: {
+              event: { const: "done" },
+              data: returnsSchema,
+              id: { type: "string" },
+              retry: { type: "number" }
+            },
+            required: returnsRequired ? ["event", "data"] : ["event"]
+          },
+          {
+            type: "object",
+            properties: {
+              event: { const: "error" },
+              data: {},
+              id: { type: "string" },
+              retry: { type: "number" }
+            },
+            required: ["event"]
+          }
+        ]
+      })
+    }
+  };
+}
+function toOpenAPIParameters(schema, parameterIn) {
+  const parameters = [];
+  for (const key in schema.properties) {
+    const keySchema = schema.properties[key];
+    let isDeepObjectStyle = true;
+    if (parameterIn !== "query") {
+      isDeepObjectStyle = false;
+    } else if (isPrimitiveSchema(keySchema)) {
+      isDeepObjectStyle = false;
+    } else {
+      const [item] = expandArrayableSchema(keySchema) ?? [];
+      if (item !== void 0 && isPrimitiveSchema(item)) {
+        isDeepObjectStyle = false;
+      }
+    }
+    parameters.push({
+      name: key,
+      in: parameterIn,
+      required: schema.required?.includes(key),
+      schema: toOpenAPISchema(keySchema),
+      style: isDeepObjectStyle ? "deepObject" : void 0,
+      explode: isDeepObjectStyle ? true : void 0,
+      allowEmptyValue: parameterIn === "query" ? true : void 0,
+      allowReserved: parameterIn === "query" ? true : void 0
+    });
+  }
+  return parameters;
+}
+function checkParamsSchema(schema, params) {
+  const properties = Object.keys(schema.properties ?? {});
+  const required = schema.required ?? [];
+  if (properties.length !== params.length || properties.some((v) => !params.includes(v))) {
+    return false;
+  }
+  if (required.length !== params.length || required.some((v) => !params.includes(v))) {
+    return false;
+  }
+  return true;
+}
+function toOpenAPISchema(schema) {
+  return schema === true ? {} : schema === false ? { not: {} } : schema;
+}
+const OPENAPI_JSON_SCHEMA_REF_PREFIX = "#/components/schemas/";
+function resolveOpenAPIJsonSchemaRef(doc, schema) {
+  if (typeof schema !== "object" || !schema.$ref?.startsWith(OPENAPI_JSON_SCHEMA_REF_PREFIX)) {
+    return schema;
+  }
+  const name = schema.$ref.slice(OPENAPI_JSON_SCHEMA_REF_PREFIX.length);
+  const resolved = doc.components?.schemas?.[name];
+  return resolved ?? schema;
+}
+
+class OpenAPIGeneratorError extends Error {
+}
+async function generateOpenApiSpec(router, options = {}) {
+  const converter = typeof options.schemaConverter === "function" ? options.schemaConverter : new ZodToJsonSchemaConverter(options.schemaConverter ?? {}).convert;
+  const filter = options.filter ?? (({ contract, path }) => {
+    return !(options.exclude?.(contract, path) ?? false);
+  });
+  const doc = {
+    ...clone(options.spec),
+    info: options.spec?.info ?? { title: "API Reference", version: "0.0.0" },
+    openapi: "3.1.1"
+  };
+  const { baseSchemaConvertOptions } = await resolveCommonSchemas(doc, options.commonSchemas, converter);
+  const contracts = [];
+  await resolveContractProcedures({ path: [], router }, (traverseOptions) => {
+    if (!value(filter, traverseOptions)) {
+      return;
+    }
+    contracts.push(traverseOptions);
+  });
+  const namesByAuthConfig = /* @__PURE__ */ new Map();
+  const authConfigNames = /* @__PURE__ */ new Set();
+  for (const { contract } of contracts) {
+    for (const authConfig of contract["~orpc"].authConfigs) {
+      if (authConfig.type === "none" || namesByAuthConfig.has(authConfig)) {
+        continue;
+      }
+      const oasNameBase = authConfig.oasName ?? `${authConfig.type}Auth`;
+      let oasName = oasNameBase;
+      for (let i = 2; authConfigNames.has(oasName); i++) {
+        oasName = `${oasNameBase}${i}`;
+      }
+      namesByAuthConfig.set(authConfig, oasName);
+      authConfigNames.add(oasName);
+    }
+  }
+  if (namesByAuthConfig.size > 0) {
+    doc.components ??= {};
+    const schemes = doc.components.securitySchemes ??= {};
+    for (const [authConfig, name] of namesByAuthConfig) {
+      schemes[name] ??= authConfigToSecurityScheme(authConfig);
+    }
+  }
+  const errors = [];
+  for (const { contract, path } of contracts) {
+    const stringPath = path.join(".");
+    try {
+      const def = contract["~orpc"];
+      const method = toOpenAPIMethod(fallbackContractConfig("defaultMethod", def.route.method));
+      const httpPath = toOpenAPIPath(def.route.path ?? toHttpPath(path));
+      let operationObjectRef;
+      if (def.route.spec !== void 0 && typeof def.route.spec !== "function") {
+        operationObjectRef = def.route.spec;
+      } else {
+        operationObjectRef = {
+          operationId: def.route.operationId ?? stringPath,
+          summary: def.route.summary,
+          description: def.route.description,
+          deprecated: def.route.deprecated,
+          tags: def.route.tags?.map((tag) => tag)
+        };
+        const security = def.authConfigs.map(
+          (authConfig) => authConfig.type === "none" ? {} : { [namesByAuthConfig.get(authConfig)]: [] }
+        );
+        if (security.length > 0) {
+          operationObjectRef.security = security;
+        }
+        await handleRequest(doc, operationObjectRef, def, baseSchemaConvertOptions, converter);
+        await handleSuccessResponse(doc, operationObjectRef, def, baseSchemaConvertOptions, converter);
+        await handleErrorResponse(doc, operationObjectRef, def, baseSchemaConvertOptions, converter);
+      }
+      if (typeof def.route.spec === "function") {
+        operationObjectRef = def.route.spec(operationObjectRef);
+      }
+      doc.paths ??= {};
+      doc.paths[httpPath] ??= {};
+      doc.paths[httpPath][method] = applyCustomOpenAPIOperation(operationObjectRef, contract);
+    } catch (e) {
+      if (!(e instanceof OpenAPIGeneratorError)) {
+        throw e;
+      }
+      errors.push(
+        `[OpenAPIGenerator] Error occurred while generating OpenAPI for procedure at path: ${stringPath}
+${e.message}`
+      );
+    }
+  }
+  if (errors.length) {
+    throw new OpenAPIGeneratorError(
+      `Some error occurred during OpenAPI generation:
+
+${errors.join("\n\n")}`
+    );
+  }
+  return doc;
+}
+async function resolveCommonSchemas(doc, commonSchemas, converter) {
+  let undefinedErrorJsonSchema = {
+    type: "object",
+    properties: {
+      code: { type: "string" },
+      status: { type: "number" },
+      message: { type: "string" },
+      data: {}
+    },
+    required: ["code", "status", "message"]
+  };
+  const baseSchemaConvertOptions = {};
+  if (commonSchemas) {
+    baseSchemaConvertOptions.components = [];
+    for (const key in commonSchemas) {
+      const options = commonSchemas[key];
+      if (options.schema === void 0) {
+        continue;
+      }
+      const { schema, strategy = "input" } = options;
+      const [required, json] = await converter(schema, { strategy });
+      const allowedStrategies = [strategy];
+      if (strategy === "input") {
+        const [outputRequired, outputJson] = await converter(schema, { strategy: "output" });
+        if (outputRequired === required && stringifyJSON(outputJson) === stringifyJSON(json)) {
+          allowedStrategies.push("output");
+        }
+      } else if (strategy === "output") {
+        const [inputRequired, inputJson] = await converter(schema, { strategy: "input" });
+        if (inputRequired === required && stringifyJSON(inputJson) === stringifyJSON(json)) {
+          allowedStrategies.push("input");
+        }
+      }
+      baseSchemaConvertOptions.components.push({
+        schema,
+        required,
+        ref: `#/components/schemas/${key}`,
+        allowedStrategies
+      });
+    }
+    doc.components ??= {};
+    doc.components.schemas ??= {};
+    for (const key in commonSchemas) {
+      const options = commonSchemas[key];
+      if (options.schema === void 0) {
+        if (options.error === "UndefinedError") {
+          doc.components.schemas[key] = toOpenAPISchema(undefinedErrorJsonSchema);
+          undefinedErrorJsonSchema = { $ref: `#/components/schemas/${key}` };
+        }
+        continue;
+      }
+      const { schema, strategy = "input" } = options;
+      const [, json] = await converter(schema, {
+        ...baseSchemaConvertOptions,
+        strategy,
+        minStructureDepthForRef: 1
+        // not allow use $ref for root schemas
+      });
+      doc.components.schemas[key] = toOpenAPISchema(json);
+    }
+  }
+  return { baseSchemaConvertOptions, undefinedErrorJsonSchema };
+}
+async function handleRequest(doc, ref, def, baseSchemaConvertOptions, converter) {
+  const method = fallbackContractConfig("defaultMethod", def.route.method);
+  const dynamicParams = getDynamicParams(def.route.path)?.map((v) => v.name);
+  const [_pathRequired, pathSchema] = await converter(def.schemas.pathSchema, {
+    ...baseSchemaConvertOptions,
+    strategy: "input",
+    minStructureDepthForRef: 1
+  });
+  if (dynamicParams?.length) {
+    const error = new OpenAPIGeneratorError(
+      // TODO: fix this error
+      'When input structure is "compact", and path has dynamic params, input schema must be an object with all dynamic params as required.'
+    );
+    if (!isObjectSchema(pathSchema)) {
+      throw error;
+    }
+    if (!checkParamsSchema(pathSchema, dynamicParams)) {
+      throw error;
+    }
+    ref.parameters ??= [];
+    ref.parameters.push(...toOpenAPIParameters(pathSchema, "path"));
+  } else {
+    const error = new OpenAPIGeneratorError("Params set via path do not match those on the route");
+    if (!isObjectSchema(pathSchema)) {
+      throw error;
+    }
+    if (!checkParamsSchema(pathSchema, [])) {
+      throw error;
+    }
+  }
+  const [_queryRequired, querySchema] = await converter(def.schemas.querySchema, {
+    ...baseSchemaConvertOptions,
+    strategy: "input",
+    minStructureDepthForRef: 0
+  });
+  if (!isAnySchema(querySchema)) {
+    const resolvedSchema = resolveOpenAPIJsonSchemaRef(doc, querySchema);
+    if (!isObjectSchema(resolvedSchema)) {
+      throw new OpenAPIGeneratorError("Query param schema must satisfy: object | any | unknown");
+    }
+    ref.parameters ??= [];
+    ref.parameters.push(...toOpenAPIParameters(resolvedSchema, "query"));
+  }
+  if (method !== "GET") {
+    const details = getEventIteratorSchemaDetails(def.schemas.bodySchema);
+    if (details) {
+      ref.requestBody = {
+        required: true,
+        content: toOpenAPIEventIteratorContent(
+          await converter(details.yields, { ...baseSchemaConvertOptions, strategy: "input" }),
+          await converter(details.returns, { ...baseSchemaConvertOptions, strategy: "input" })
+        )
+      };
+    } else {
+      const [bodyRequired, bodySchema] = await converter(def.schemas.bodySchema, {
+        ...baseSchemaConvertOptions,
+        strategy: "input",
+        minStructureDepthForRef: 0
+      });
+      if (isAnySchema(bodySchema)) {
+        return;
+      }
+      ref.requestBody = {
+        required: bodyRequired,
+        content: toOpenAPIContent(bodySchema)
+      };
+    }
+  }
+}
+async function handleSuccessResponse(doc, ref, def, baseSchemaConvertOptions, converter) {
+  const outputSchema = def.schemas.outputSchema;
+  const status = fallbackContractConfig("defaultSuccessStatus", def.route.successStatus);
+  const description = fallbackContractConfig("defaultSuccessDescription", def.route?.successDescription);
+  const eventIteratorSchemaDetails = getEventIteratorSchemaDetails(outputSchema);
+  const outputStructure = fallbackContractConfig("defaultOutputStructure", def.route.outputStructure);
+  if (eventIteratorSchemaDetails) {
+    ref.responses ??= {};
+    ref.responses[status] = {
+      description,
+      content: toOpenAPIEventIteratorContent(
+        await converter(eventIteratorSchemaDetails.yields, {
+          ...baseSchemaConvertOptions,
+          strategy: "output"
+        }),
+        await converter(eventIteratorSchemaDetails.returns, {
+          ...baseSchemaConvertOptions,
+          strategy: "output"
+        })
+      )
+    };
+    return;
+  }
+  const [required, json] = await converter(outputSchema, {
+    ...baseSchemaConvertOptions,
+    strategy: "output",
+    minStructureDepthForRef: outputStructure === "detailed" ? 1 : 0
+  });
+  if (outputStructure === "compact") {
+    ref.responses ??= {};
+    ref.responses[status] = {
+      description
+    };
+    ref.responses[status].content = toOpenAPIContent(applySchemaOptionality(required, json));
+    return;
+  }
+  const handledStatuses = /* @__PURE__ */ new Set();
+  for (const item of expandUnionSchema(json)) {
+    const error = new OpenAPIGeneratorError(`
+      When output structure is "detailed", output schema must satisfy:
+      {
+        status?: number, // must be a literal number and in the range of 200-399
+        headers?: Record<string, unknown>,
+        body?: unknown
+      }
+
+      But got: ${stringifyJSON(item)}
+    `);
+    if (!isObjectSchema(item)) {
+      throw error;
+    }
+    let schemaStatus;
+    let schemaDescription;
+    if (item.properties?.status !== void 0) {
+      const statusSchema = resolveOpenAPIJsonSchemaRef(doc, item.properties.status);
+      if (typeof statusSchema !== "object" || statusSchema.const === void 0 || typeof statusSchema.const !== "number" || !Number.isInteger(statusSchema.const) || isAPIErrorStatus(statusSchema.const)) {
+        throw error;
+      }
+      schemaStatus = statusSchema.const;
+      schemaDescription = statusSchema.description;
+    }
+    const itemStatus = schemaStatus ?? status;
+    const itemDescription = schemaDescription ?? description;
+    if (handledStatuses.has(itemStatus)) {
+      throw new OpenAPIGeneratorError(`
+        When output structure is "detailed", each success status must be unique.
+        But got status: ${itemStatus} used more than once.
+      `);
+    }
+    handledStatuses.add(itemStatus);
+    ref.responses ??= {};
+    ref.responses[itemStatus] = {
+      description: itemDescription
+    };
+    if (item.properties?.headers !== void 0) {
+      const headersSchema = resolveOpenAPIJsonSchemaRef(doc, item.properties.headers);
+      if (!isObjectSchema(headersSchema)) {
+        throw error;
+      }
+      for (const key in headersSchema.properties) {
+        const headerSchema = headersSchema.properties[key];
+        if (headerSchema !== void 0) {
+          ref.responses[itemStatus].headers ??= {};
+          ref.responses[itemStatus].headers[key] = {
+            schema: toOpenAPISchema(headerSchema),
+            required: item.required?.includes("headers") && headersSchema.required?.includes(key)
+          };
+        }
+      }
+    }
+    if (item.properties?.body !== void 0) {
+      ref.responses[itemStatus].content = toOpenAPIContent(
+        applySchemaOptionality(item.required?.includes("body") ?? false, item.properties.body)
+      );
+    }
+  }
+}
+function authConfigToSecurityScheme(authConfig) {
+  switch (authConfig.type) {
+    case "basic":
+      return {
+        type: "http",
+        scheme: "basic",
+        description: authConfig.oasDescription
+      };
+    case "bearer":
+      return {
+        type: "http",
+        scheme: "bearer",
+        description: authConfig.oasDescription,
+        bearerFormat: authConfig.oasBearerFormat
+      };
+    case "header":
+      return {
+        type: "apiKey",
+        in: "header",
+        name: authConfig.name,
+        description: authConfig.oasDescription
+      };
+    case "query":
+      return {
+        type: "apiKey",
+        in: "query",
+        name: authConfig.name,
+        description: authConfig.oasDescription
+      };
+    case "cookie":
+      return {
+        type: "apiKey",
+        in: "cookie",
+        name: authConfig.name,
+        description: authConfig.oasDescription
+      };
+    default:
+      assertNever(authConfig, `Unsupported auth config type: ${authConfig.type}`);
+  }
+}
+async function handleErrorResponse(doc, ref, def, baseSchemaConvertOptions, converter) {
+  const errorMap = def.errorMap;
+  const errorResponsesByStatus = {};
+  for (const code in errorMap) {
+    const errorClass = errorMap[code];
+    if (!errorClass) {
+      continue;
+    }
+    const status = errorClass.status;
+    const type = errorClass.type;
+    const defaultMessage = errorClass.defaultMessage;
+    errorResponsesByStatus[status] ??= { status, errorSchemaVariants: [] };
+    const extraZod = z.object(errorClass.extraSchema).strict();
+    const [, extraSchema] = await converter(extraZod, {
+      ...baseSchemaConvertOptions,
+      strategy: "output"
+    });
+    if (!isObjectSchema(extraSchema)) {
+      throw new OpenAPIGeneratorError(
+        `Error response extra schema must be an object, but got: ${stringifyJSON(extraSchema)}`
+      );
+    }
+    errorResponsesByStatus[status].errorSchemaVariants.push({
+      type: "object",
+      properties: {
+        type: { const: type },
+        message: { type: "string", default: defaultMessage },
+        ...extraSchema.properties
+      },
+      required: ["type", "message", ...extraSchema.required ?? []]
+    });
+  }
+  ref.responses ??= {};
+  for (const statusString in errorResponsesByStatus) {
+    const errorResponse = errorResponsesByStatus[statusString];
+    if (statusString === "500") {
+      console.log(
+        errorResponse.errorSchemaVariants,
+        toOpenAPIContent({
+          oneOf: errorResponse.errorSchemaVariants
+        })
+      );
+    }
+    ref.responses[statusString] = {
+      description: statusString,
+      content: toOpenAPIContent(
+        errorResponse.errorSchemaVariants.length === 1 ? errorResponse.errorSchemaVariants[0] : {
+          oneOf: errorResponse.errorSchemaVariants
+        }
+      )
+    };
+  }
+}
+
+const oo = {
+  spec: customOpenAPIOperation
+};
+
+export { LOGIC_KEYWORDS, applyCustomOpenAPIOperation, applySchemaOptionality, checkParamsSchema, customOpenAPIOperation, expandArrayableSchema, expandUnionSchema, filterSchemaBranches, generateOpenApiSpec, getCustomOpenAPIOperation, isAnySchema, isFileSchema, isObjectSchema, isPrimitiveSchema, oo, resolveOpenAPIJsonSchemaRef, separateObjectSchema, toOpenAPIContent, toOpenAPIEventIteratorContent, toOpenAPIMethod, toOpenAPIParameters, toOpenAPIPath, toOpenAPISchema };