zod-nest 3.2.6 → 3.4.0

package/dist/index.mjs

@@ -1037,6 +1037,101 @@ var ZodNestModule = class _ZodNestModule {
     };
   }
 };
+
+// src/document/http-methods.ts
+var OPENAPI_OPERATION_KEYS = [
+  "get",
+  "put",
+  "post",
+  "delete",
+  "options",
+  "head",
+  "patch",
+  "trace",
+  "query"
+];
+var EXTENSION_OPERATION_KEYS = [
+  "search",
+  "propfind",
+  "proppatch",
+  "mkcol",
+  "copy",
+  "move",
+  "lock",
+  "unlock"
+];
+var HTTP_METHODS = [
+  ...OPENAPI_OPERATION_KEYS,
+  ...EXTENSION_OPERATION_KEYS
+];
+var ADDITIONAL_OPERATIONS_KEY = "additionalOperations";
+var isRecord = /* @__PURE__ */ __name((value) => value !== null && typeof value === "object", "isRecord");
+var operationsOfPathItem = /* @__PURE__ */ __name((pathItem) => {
+  const operations = [];
+  for (const method of HTTP_METHODS) {
+    const operation = pathItem[method];
+    if (isRecord(operation)) {
+      operations.push(operation);
+    }
+  }
+  const additional = pathItem[ADDITIONAL_OPERATIONS_KEY];
+  if (isRecord(additional)) {
+    for (const operation of Object.values(additional)) {
+      if (isRecord(operation)) {
+        operations.push(operation);
+      }
+    }
+  }
+  return operations;
+}, "operationsOfPathItem");
+var forEachOperation = /* @__PURE__ */ __name((doc, fn) => {
+  const paths = doc.paths;
+  if (!isRecord(paths)) {
+    return;
+  }
+  for (const pathItem of Object.values(paths)) {
+    if (!isRecord(pathItem)) {
+      continue;
+    }
+    for (const operation of operationsOfPathItem(pathItem)) {
+      fn(operation);
+    }
+  }
+}, "forEachOperation");
+
+// src/document/additional-operations.ts
+var isRecord2 = /* @__PURE__ */ __name((value) => value !== null && typeof value === "object", "isRecord");
+var relocateExtensionOperations = /* @__PURE__ */ __name((doc) => {
+  const paths = doc.paths;
+  if (!isRecord2(paths)) {
+    return;
+  }
+  for (const pathItem of Object.values(paths)) {
+    if (!isRecord2(pathItem)) {
+      continue;
+    }
+    relocateInPathItem(pathItem);
+  }
+}, "relocateExtensionOperations");
+var relocateInPathItem = /* @__PURE__ */ __name((pathItem) => {
+  const relocated = {};
+  for (const method of EXTENSION_OPERATION_KEYS) {
+    const operation = pathItem[method];
+    if (!isRecord2(operation)) {
+      continue;
+    }
+    relocated[method.toUpperCase()] = operation;
+    delete pathItem[method];
+  }
+  if (Object.keys(relocated).length === 0) {
+    return;
+  }
+  const existing = pathItem[ADDITIONAL_OPERATIONS_KEY];
+  pathItem[ADDITIONAL_OPERATIONS_KEY] = isRecord2(existing) ? {
+    ...relocated,
+    ...existing
+  } : relocated;
+}, "relocateInPathItem");
 var URI = /* @__PURE__ */ __name((id) => `#/components/schemas/${id}`, "URI");
 var bulkEmit = /* @__PURE__ */ __name((opts) => {
   const knownIds = new Set(opts.registry.ids());
@@ -1076,46 +1171,6 @@ var runPass = /* @__PURE__ */ __name((opts, io, knownIds) => {
   return filtered;
 }, "runPass");
 
-// src/document/http-methods.ts
-var HTTP_METHODS = [
-  "get",
-  "put",
-  "post",
-  "delete",
-  "options",
-  "head",
-  "patch",
-  "trace",
-  "query",
-  "search",
-  "propfind",
-  "proppatch",
-  "mkcol",
-  "copy",
-  "move",
-  "lock",
-  "unlock"
-];
-var forEachOperation = /* @__PURE__ */ __name((doc, fn) => {
-  const paths = doc.paths;
-  if (paths === null || typeof paths !== "object") {
-    return;
-  }
-  for (const pathItem of Object.values(paths)) {
-    if (pathItem === null || typeof pathItem !== "object") {
-      continue;
-    }
-    const pathRecord = pathItem;
-    for (const method of HTTP_METHODS) {
-      const op = pathRecord[method];
-      if (op === null || typeof op !== "object") {
-        continue;
-      }
-      fn(op);
-    }
-  }
-}, "forEachOperation");
-
 // src/document/walk-refs.ts
 var walkRefs = /* @__PURE__ */ __name((node, visit) => {
   if (node === null || typeof node !== "object") {
@@ -1188,22 +1243,12 @@ var collectInputExposedIds = /* @__PURE__ */ __name((doc, classToDtoId, knownIds
     if (!isPlainRecord2(pathItem)) {
       continue;
     }
-    for (const operation of operationsOf(pathItem)) {
+    for (const operation of operationsOfPathItem(pathItem)) {
       collectRefsFromOperation(operation, classToDtoId, knownIds, ids);
     }
   }
   return ids;
 }, "collectInputExposedIds");
-var operationsOf = /* @__PURE__ */ __name((pathItem) => {
-  const out = [];
-  for (const method of HTTP_METHODS) {
-    const op = pathItem[method];
-    if (isPlainRecord2(op)) {
-      out.push(op);
-    }
-  }
-  return out;
-}, "operationsOf");
 var collectRefsFromOperation = /* @__PURE__ */ __name((operation, classToDtoId, knownIds, ids) => {
   if (isPlainRecord2(operation.requestBody)) {
     collectRefsFromContent(operation.requestBody.content, classToDtoId, knownIds, ids);
@@ -1265,7 +1310,7 @@ var collectOutputExposedIds = /* @__PURE__ */ __name((doc, classToDtoId, knownId
     if (!isPlainRecord2(pathItem)) {
       continue;
     }
-    for (const operation of operationsOf(pathItem)) {
+    for (const operation of operationsOfPathItem(pathItem)) {
       collectRefsFromResponses(operation.responses, classToDtoId, knownIds, ids);
     }
   }
@@ -1724,6 +1769,25 @@ var decorateIfPresent = /* @__PURE__ */ __name((schemas, key) => {
   };
 }, "decorateIfPresent");
 
+// src/document/openapi-version.ts
+var SUPPORTED_OPENAPI_SERIES = [
+  "3.1",
+  "3.2"
+];
+var DEFAULT_OPENAPI_VERSION = "3.1.0";
+var SUPPORTED_VERSION_PATTERN = /^3\.[12]\.\d+(?:-.+)?$/;
+var resolveOpenApiVersion = /* @__PURE__ */ __name((doc) => {
+  const declared = doc.openapi;
+  if (typeof declared !== "string" || declared === "") {
+    return DEFAULT_OPENAPI_VERSION;
+  }
+  if (SUPPORTED_VERSION_PATTERN.test(declared)) {
+    return declared;
+  }
+  console.warn(`[zod-nest] Document declares OpenAPI \`${declared}\`, which zod-nest does not emit; emitting \`${DEFAULT_OPENAPI_VERSION}\` instead. Supported: ${SUPPORTED_OPENAPI_SERIES.map((series) => `${series}.x`).join(", ")}. Set one via \`DocumentBuilder.setOpenAPIVersion()\` to silence this.`);
+  return DEFAULT_OPENAPI_VERSION;
+}, "resolveOpenApiVersion");
+
 // src/document/ref-titles.ts
 var applyRefTitles = /* @__PURE__ */ __name((doc) => {
   const schemas = doc.components?.schemas;
@@ -1793,11 +1857,7 @@ var rewriteRefs = /* @__PURE__ */ __name((params) => {
   }
 }, "rewriteRefs");
 var rewriteResponseSubtree = /* @__PURE__ */ __name((pathItem, divergentOutputIds) => {
-  for (const method of HTTP_METHODS) {
-    const op = pathItem[method];
-    if (op === null || typeof op !== "object") {
-      continue;
-    }
+  for (const op of operationsOfPathItem(pathItem)) {
     const responses = op.responses;
     if (responses === null || typeof responses !== "object") {
       continue;
@@ -1876,7 +1936,6 @@ var withForcedExposure = /* @__PURE__ */ __name((collected, registry) => {
     classToDtoId: collected.classToDtoId
   };
 }, "withForcedExposure");
-var OPENAPI_VERSION = "3.1.0";
 var applyZodNest = /* @__PURE__ */ __name((doc, opts = {}) => {
   const registry = opts.registry ?? defaultRegistry;
   const collected = collectUsage(doc, registry);
@@ -1917,7 +1976,11 @@ var applyZodNest = /* @__PURE__ */ __name((doc, opts = {}) => {
     doc,
     collected: extended
   });
-  doc.openapi = OPENAPI_VERSION;
+  const openApiVersion = resolveOpenApiVersion(doc);
+  if (openApiVersion.startsWith("3.2.")) {
+    relocateExtensionOperations(doc);
+  }
+  doc.openapi = openApiVersion;
   return doc;
 }, "applyZodNest");