@strapi/openapi 5.50.2 → 5.51.0

package/dist/post-processor/component-writer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"component-writer.d.ts","sourceRoot":"","sources":["../../src/post-processor/component-writer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,qBAAa,gBAAiB,YAAW,aAAa;IACpD,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;CAc5C"}
+{"version":3,"file":"component-writer.d.ts","sourceRoot":"","sources":["../../src/post-processor/component-writer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,qBAAa,gBAAiB,YAAW,aAAa;IACpD,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;CAoB5C"}

package/dist/post-processor/component-writer.js

@@ -29,6 +29,11 @@ class ComponentsWriter {
         const { schemas } = z__namespace.toJSONSchema(z__namespace.globalRegistry, {
             uri: zod.toComponentsPath
         });
+        for (const schema of Object.values(schemas ?? {})){
+            if (schema && typeof schema === 'object') {
+                zod.stripJsonSchemaId(schema);
+            }
+        }
         const existingComponents = output.data.components ?? {};
         output.data.components = {
             ...existingComponents,

package/dist/post-processor/component-writer.js.map

@@ -1 +1 @@
-{"version":3,"file":"component-writer.js","sources":["../../src/post-processor/component-writer.ts"],"sourcesContent":["import { OpenAPIV3_1 } from 'openapi-types';\nimport * as z from 'zod/v4';\nimport type { DocumentContext } from '../types';\nimport { toComponentsPath } from '../utils/zod';\nimport type { PostProcessor } from './types';\n\nexport class ComponentsWriter implements PostProcessor {\n  postProcess(context: DocumentContext): void {\n    const { output } = context;\n\n    const { schemas } = z.toJSONSchema(z.globalRegistry, {\n      uri: toComponentsPath,\n    }) as OpenAPIV3_1.ComponentsObject;\n\n    const existingComponents = output.data.components ?? {};\n\n    output.data.components = {\n      ...existingComponents,\n      schemas,\n    };\n  }\n}\n"],"names":["ComponentsWriter","postProcess","context","output","schemas","z","toJSONSchema","globalRegistry","uri","toComponentsPath","existingComponents","data","components"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AAMO,MAAMA,gBAAAA,CAAAA;AACXC,IAAAA,WAAAA,CAAYC,OAAwB,EAAQ;QAC1C,MAAM,EAAEC,MAAM,EAAE,GAAGD,OAAAA;QAEnB,MAAM,EAAEE,OAAO,EAAE,GAAGC,aAAEC,YAAY,CAACD,YAAAA,CAAEE,cAAc,EAAE;YACnDC,GAAAA,EAAKC;AACP,SAAA,CAAA;AAEA,QAAA,MAAMC,qBAAqBP,MAAAA,CAAOQ,IAAI,CAACC,UAAU,IAAI,EAAC;QAEtDT,MAAAA,CAAOQ,IAAI,CAACC,UAAU,GAAG;AACvB,YAAA,GAAGF,kBAAkB;AACrBN,YAAAA;AACF,SAAA;AACF,IAAA;AACF;;;;"}
+{"version":3,"file":"component-writer.js","sources":["../../src/post-processor/component-writer.ts"],"sourcesContent":["import { OpenAPIV3_1 } from 'openapi-types';\nimport * as z from 'zod/v4';\nimport type { DocumentContext } from '../types';\nimport { stripJsonSchemaId, toComponentsPath } from '../utils/zod';\nimport type { PostProcessor } from './types';\n\nexport class ComponentsWriter implements PostProcessor {\n  postProcess(context: DocumentContext): void {\n    const { output } = context;\n\n    const { schemas } = z.toJSONSchema(z.globalRegistry, {\n      uri: toComponentsPath,\n    }) as OpenAPIV3_1.ComponentsObject;\n\n    for (const schema of Object.values(schemas ?? {})) {\n      if (schema && typeof schema === 'object') {\n        stripJsonSchemaId(schema);\n      }\n    }\n\n    const existingComponents = output.data.components ?? {};\n\n    output.data.components = {\n      ...existingComponents,\n      schemas,\n    };\n  }\n}\n"],"names":["ComponentsWriter","postProcess","context","output","schemas","z","toJSONSchema","globalRegistry","uri","toComponentsPath","schema","Object","values","stripJsonSchemaId","existingComponents","data","components"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AAMO,MAAMA,gBAAAA,CAAAA;AACXC,IAAAA,WAAAA,CAAYC,OAAwB,EAAQ;QAC1C,MAAM,EAAEC,MAAM,EAAE,GAAGD,OAAAA;QAEnB,MAAM,EAAEE,OAAO,EAAE,GAAGC,aAAEC,YAAY,CAACD,YAAAA,CAAEE,cAAc,EAAE;YACnDC,GAAAA,EAAKC;AACP,SAAA,CAAA;AAEA,QAAA,KAAK,MAAMC,MAAAA,IAAUC,MAAAA,CAAOC,MAAM,CAACR,OAAAA,IAAW,EAAC,CAAA,CAAI;YACjD,IAAIM,MAAAA,IAAU,OAAOA,MAAAA,KAAW,QAAA,EAAU;gBACxCG,qBAAAA,CAAkBH,MAAAA,CAAAA;AACpB,YAAA;AACF,QAAA;AAEA,QAAA,MAAMI,qBAAqBX,MAAAA,CAAOY,IAAI,CAACC,UAAU,IAAI,EAAC;QAEtDb,MAAAA,CAAOY,IAAI,CAACC,UAAU,GAAG;AACvB,YAAA,GAAGF,kBAAkB;AACrBV,YAAAA;AACF,SAAA;AACF,IAAA;AACF;;;;"}

package/dist/post-processor/component-writer.mjs

@@ -1,5 +1,5 @@
 import * as z from 'zod/v4';
-import { toComponentsPath } from '../utils/zod.mjs';
+import { toComponentsPath, stripJsonSchemaId } from '../utils/zod.mjs';
 
 class ComponentsWriter {
     postProcess(context) {
@@ -7,6 +7,11 @@ class ComponentsWriter {
         const { schemas } = z.toJSONSchema(z.globalRegistry, {
             uri: toComponentsPath
         });
+        for (const schema of Object.values(schemas ?? {})){
+            if (schema && typeof schema === 'object') {
+                stripJsonSchemaId(schema);
+            }
+        }
         const existingComponents = output.data.components ?? {};
         output.data.components = {
             ...existingComponents,

package/dist/post-processor/component-writer.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"component-writer.mjs","sources":["../../src/post-processor/component-writer.ts"],"sourcesContent":["import { OpenAPIV3_1 } from 'openapi-types';\nimport * as z from 'zod/v4';\nimport type { DocumentContext } from '../types';\nimport { toComponentsPath } from '../utils/zod';\nimport type { PostProcessor } from './types';\n\nexport class ComponentsWriter implements PostProcessor {\n  postProcess(context: DocumentContext): void {\n    const { output } = context;\n\n    const { schemas } = z.toJSONSchema(z.globalRegistry, {\n      uri: toComponentsPath,\n    }) as OpenAPIV3_1.ComponentsObject;\n\n    const existingComponents = output.data.components ?? {};\n\n    output.data.components = {\n      ...existingComponents,\n      schemas,\n    };\n  }\n}\n"],"names":["ComponentsWriter","postProcess","context","output","schemas","z","toJSONSchema","globalRegistry","uri","toComponentsPath","existingComponents","data","components"],"mappings":";;;AAMO,MAAMA,gBAAAA,CAAAA;AACXC,IAAAA,WAAAA,CAAYC,OAAwB,EAAQ;QAC1C,MAAM,EAAEC,MAAM,EAAE,GAAGD,OAAAA;QAEnB,MAAM,EAAEE,OAAO,EAAE,GAAGC,EAAEC,YAAY,CAACD,CAAAA,CAAEE,cAAc,EAAE;YACnDC,GAAAA,EAAKC;AACP,SAAA,CAAA;AAEA,QAAA,MAAMC,qBAAqBP,MAAAA,CAAOQ,IAAI,CAACC,UAAU,IAAI,EAAC;QAEtDT,MAAAA,CAAOQ,IAAI,CAACC,UAAU,GAAG;AACvB,YAAA,GAAGF,kBAAkB;AACrBN,YAAAA;AACF,SAAA;AACF,IAAA;AACF;;;;"}
+{"version":3,"file":"component-writer.mjs","sources":["../../src/post-processor/component-writer.ts"],"sourcesContent":["import { OpenAPIV3_1 } from 'openapi-types';\nimport * as z from 'zod/v4';\nimport type { DocumentContext } from '../types';\nimport { stripJsonSchemaId, toComponentsPath } from '../utils/zod';\nimport type { PostProcessor } from './types';\n\nexport class ComponentsWriter implements PostProcessor {\n  postProcess(context: DocumentContext): void {\n    const { output } = context;\n\n    const { schemas } = z.toJSONSchema(z.globalRegistry, {\n      uri: toComponentsPath,\n    }) as OpenAPIV3_1.ComponentsObject;\n\n    for (const schema of Object.values(schemas ?? {})) {\n      if (schema && typeof schema === 'object') {\n        stripJsonSchemaId(schema);\n      }\n    }\n\n    const existingComponents = output.data.components ?? {};\n\n    output.data.components = {\n      ...existingComponents,\n      schemas,\n    };\n  }\n}\n"],"names":["ComponentsWriter","postProcess","context","output","schemas","z","toJSONSchema","globalRegistry","uri","toComponentsPath","schema","Object","values","stripJsonSchemaId","existingComponents","data","components"],"mappings":";;;AAMO,MAAMA,gBAAAA,CAAAA;AACXC,IAAAA,WAAAA,CAAYC,OAAwB,EAAQ;QAC1C,MAAM,EAAEC,MAAM,EAAE,GAAGD,OAAAA;QAEnB,MAAM,EAAEE,OAAO,EAAE,GAAGC,EAAEC,YAAY,CAACD,CAAAA,CAAEE,cAAc,EAAE;YACnDC,GAAAA,EAAKC;AACP,SAAA,CAAA;AAEA,QAAA,KAAK,MAAMC,MAAAA,IAAUC,MAAAA,CAAOC,MAAM,CAACR,OAAAA,IAAW,EAAC,CAAA,CAAI;YACjD,IAAIM,MAAAA,IAAU,OAAOA,MAAAA,KAAW,QAAA,EAAU;gBACxCG,iBAAAA,CAAkBH,MAAAA,CAAAA;AACpB,YAAA;AACF,QAAA;AAEA,QAAA,MAAMI,qBAAqBX,MAAAA,CAAOY,IAAI,CAACC,UAAU,IAAI,EAAC;QAEtDb,MAAAA,CAAOY,IAAI,CAACC,UAAU,GAAG;AACvB,YAAA,GAAGF,kBAAkB;AACrBV,YAAAA;AACF,SAAA;AACF,IAAA;AACF;;;;"}

package/dist/utils/zod.d.ts

@@ -1,5 +1,11 @@
 import * as z from 'zod/v4';
 import type { OpenAPIV3_1 } from 'openapi-types';
+/**
+ * Zod ≥3.25.76 embeds `$id` in `toJSONSchema` output (set after `override`).
+ * Strip it so OpenAPI documents stay stable — inline schemas use random UUIDs
+ * as registry ids — and match the pre-3.25.76 shape.
+ */
+export declare const stripJsonSchemaId: <T extends object>(schema: T) => T;
 /**
  * Converts a Zod schema to an OpenAPI Schema Object.
  *

package/dist/utils/zod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"zod.d.ts","sourceRoot":"","sources":["../../src/utils/zod.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,eAAO,MAAM,YAAY,GACvB,WAAW,CAAC,CAAC,OAAO,KACnB,WAAW,CAAC,YAAY,GAAG,WAAW,CAAC,eAsBzC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAAI,IAAI,MAAM,WAAiC,CAAC"}
+{"version":3,"file":"zod.d.ts","sourceRoot":"","sources":["../../src/utils/zod.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAAI,CAAC,SAAS,MAAM,EAAE,QAAQ,CAAC,KAAG,CAK/D,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,YAAY,GACvB,WAAW,CAAC,CAAC,OAAO,KACnB,WAAW,CAAC,YAAY,GAAG,WAAW,CAAC,eAsBzC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAAI,IAAI,MAAM,WAAiC,CAAC"}

package/dist/utils/zod.js

@@ -23,6 +23,16 @@ function _interopNamespace(e) {
 
 var z__namespace = /*#__PURE__*/_interopNamespace(z);
 
+/**
+ * Zod ≥3.25.76 embeds `$id` in `toJSONSchema` output (set after `override`).
+ * Strip it so OpenAPI documents stay stable — inline schemas use random UUIDs
+ * as registry ids — and match the pre-3.25.76 shape.
+ */ const stripJsonSchemaId = (schema)=>{
+    if ('$id' in schema) {
+        delete schema.$id;
+    }
+    return schema;
+};
 /**
  * Converts a Zod schema to an OpenAPI Schema Object.
  *
@@ -70,7 +80,7 @@ var z__namespace = /*#__PURE__*/_interopNamespace(z);
             uri: toComponentsPath
         });
         // TODO: make sure it's compliant
-        return schemas[id];
+        return stripJsonSchemaId(schemas[id]);
     } catch (e) {
         throw new Error("Couldn't transform the zod schema into an OpenAPI schema");
     }
@@ -82,6 +92,7 @@ var z__namespace = /*#__PURE__*/_interopNamespace(z);
  * @returns The constructed path string for the specified component schema.
  */ const toComponentsPath = (id)=>`#/components/schemas/${id}`;
 
+exports.stripJsonSchemaId = stripJsonSchemaId;
 exports.toComponentsPath = toComponentsPath;
 exports.zodToOpenAPI = zodToOpenAPI;
 //# sourceMappingURL=zod.js.map

package/dist/utils/zod.js.map

@@ -1 +1 @@
-{"version":3,"file":"zod.js","sources":["../../src/utils/zod.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\nimport * as z from 'zod/v4';\n\nimport type { OpenAPIV3_1 } from 'openapi-types';\n\n/**\n * Converts a Zod schema to an OpenAPI Schema Object.\n *\n * @description\n * Takes a Zod schema and converts it into an OpenAPI Schema Object (v3.1).\n * It uses a local registry to handle the conversion process and generates the appropriate\n * OpenAPI components.\n *\n * @param zodSchema - The Zod schema to convert to OpenAPI format. Can be any valid Zod schema.\n *\n * @returns An OpenAPI Schema Object representing the input Zod schema structure.\n * If the conversion cannot be completed, returns undefined.\n *\n * @example\n * ```typescript\n * import * as z from 'zod/v4';\n *\n * // Create a Zod schema\n * const userSchema = z.object({\n *   id: z.number(),\n *   name: z.string(),\n *   email: z.string().email()\n * });\n *\n * // Convert to OpenAPI schema\n * const openAPISchema = zodToOpenAPI(userSchema);\n * ```\n */\n\nexport const zodToOpenAPI = (\n  zodSchema: z.ZodType\n): OpenAPIV3_1.SchemaObject | OpenAPIV3_1.ReferenceObject => {\n  try {\n    const id = randomUUID();\n    const registry = z.registry<{ id: string }>();\n\n    // Add the schema to the local registry with a custom, unique ID\n    registry.add(zodSchema, { id });\n\n    // Copy the global registry definitions into the local registry to make sure references are resolved\n    // This prevent \"__shared\" definitions from being created\n    for (const [key, value] of z.globalRegistry._idmap) {\n      registry.add(value, { id: key });\n    }\n\n    // Generate the schemas and only return the one we want, transform the URI path to be OpenAPI compliant\n    const { schemas } = z.toJSONSchema(registry, { uri: toComponentsPath });\n\n    // TODO: make sure it's compliant\n    return schemas[id] as OpenAPIV3_1.SchemaObject;\n  } catch (e) {\n    throw new Error(\"Couldn't transform the zod schema into an OpenAPI schema\");\n  }\n};\n\n/**\n * Generates a path string for referencing a component schema by its identifier.\n *\n * @param id - The identifier of the component schema.\n * @returns The constructed path string for the specified component schema.\n */\nexport const toComponentsPath = (id: string) => `#/components/schemas/${id}`;\n"],"names":["zodToOpenAPI","zodSchema","id","randomUUID","registry","z","add","key","value","globalRegistry","_idmap","schemas","toJSONSchema","uri","toComponentsPath","e","Error"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AAKA;;;;;;;;;;;;;;;;;;;;;;;;;;;IA6BO,MAAMA,YAAAA,GAAe,CAC1BC,SAAAA,GAAAA;IAEA,IAAI;AACF,QAAA,MAAMC,EAAAA,GAAKC,sBAAAA,EAAAA;QACX,MAAMC,QAAAA,GAAWC,aAAED,QAAQ,EAAA;;QAG3BA,QAAAA,CAASE,GAAG,CAACL,SAAAA,EAAW;AAAEC,YAAAA;AAAG,SAAA,CAAA;;;QAI7B,KAAK,MAAM,CAACK,GAAAA,EAAKC,KAAAA,CAAM,IAAIH,YAAAA,CAAEI,cAAc,CAACC,MAAM,CAAE;YAClDN,QAAAA,CAASE,GAAG,CAACE,KAAAA,EAAO;gBAAEN,EAAAA,EAAIK;AAAI,aAAA,CAAA;AAChC,QAAA;;AAGA,QAAA,MAAM,EAAEI,OAAO,EAAE,GAAGN,YAAAA,CAAEO,YAAY,CAACR,QAAAA,EAAU;YAAES,GAAAA,EAAKC;AAAiB,SAAA,CAAA;;QAGrE,OAAOH,OAAO,CAACT,EAAAA,CAAG;AACpB,IAAA,CAAA,CAAE,OAAOa,CAAAA,EAAG;AACV,QAAA,MAAM,IAAIC,KAAAA,CAAM,0DAAA,CAAA;AAClB,IAAA;AACF;AAEA;;;;;UAMaF,gBAAAA,GAAmB,CAACZ,KAAe,CAAC,qBAAqB,EAAEA,EAAAA,CAAAA;;;;;"}
+{"version":3,"file":"zod.js","sources":["../../src/utils/zod.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\nimport * as z from 'zod/v4';\n\nimport type { OpenAPIV3_1 } from 'openapi-types';\n\n/**\n * Zod ≥3.25.76 embeds `$id` in `toJSONSchema` output (set after `override`).\n * Strip it so OpenAPI documents stay stable — inline schemas use random UUIDs\n * as registry ids — and match the pre-3.25.76 shape.\n */\nexport const stripJsonSchemaId = <T extends object>(schema: T): T => {\n  if ('$id' in schema) {\n    delete (schema as { $id?: string }).$id;\n  }\n  return schema;\n};\n\n/**\n * Converts a Zod schema to an OpenAPI Schema Object.\n *\n * @description\n * Takes a Zod schema and converts it into an OpenAPI Schema Object (v3.1).\n * It uses a local registry to handle the conversion process and generates the appropriate\n * OpenAPI components.\n *\n * @param zodSchema - The Zod schema to convert to OpenAPI format. Can be any valid Zod schema.\n *\n * @returns An OpenAPI Schema Object representing the input Zod schema structure.\n * If the conversion cannot be completed, returns undefined.\n *\n * @example\n * ```typescript\n * import * as z from 'zod/v4';\n *\n * // Create a Zod schema\n * const userSchema = z.object({\n *   id: z.number(),\n *   name: z.string(),\n *   email: z.string().email()\n * });\n *\n * // Convert to OpenAPI schema\n * const openAPISchema = zodToOpenAPI(userSchema);\n * ```\n */\nexport const zodToOpenAPI = (\n  zodSchema: z.ZodType\n): OpenAPIV3_1.SchemaObject | OpenAPIV3_1.ReferenceObject => {\n  try {\n    const id = randomUUID();\n    const registry = z.registry<{ id: string }>();\n\n    // Add the schema to the local registry with a custom, unique ID\n    registry.add(zodSchema, { id });\n\n    // Copy the global registry definitions into the local registry to make sure references are resolved\n    // This prevent \"__shared\" definitions from being created\n    for (const [key, value] of z.globalRegistry._idmap) {\n      registry.add(value, { id: key });\n    }\n\n    // Generate the schemas and only return the one we want, transform the URI path to be OpenAPI compliant\n    const { schemas } = z.toJSONSchema(registry, { uri: toComponentsPath });\n\n    // TODO: make sure it's compliant\n    return stripJsonSchemaId(schemas[id] as OpenAPIV3_1.SchemaObject);\n  } catch (e) {\n    throw new Error(\"Couldn't transform the zod schema into an OpenAPI schema\");\n  }\n};\n\n/**\n * Generates a path string for referencing a component schema by its identifier.\n *\n * @param id - The identifier of the component schema.\n * @returns The constructed path string for the specified component schema.\n */\nexport const toComponentsPath = (id: string) => `#/components/schemas/${id}`;\n"],"names":["stripJsonSchemaId","schema","$id","zodToOpenAPI","zodSchema","id","randomUUID","registry","z","add","key","value","globalRegistry","_idmap","schemas","toJSONSchema","uri","toComponentsPath","e","Error"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AAKA;;;;IAKO,MAAMA,iBAAAA,GAAoB,CAAmBC,MAAAA,GAAAA;AAClD,IAAA,IAAI,SAASA,MAAAA,EAAQ;QACnB,OAAQA,OAA4BC,GAAG;AACzC,IAAA;IACA,OAAOD,MAAAA;AACT;AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;IA4BO,MAAME,YAAAA,GAAe,CAC1BC,SAAAA,GAAAA;IAEA,IAAI;AACF,QAAA,MAAMC,EAAAA,GAAKC,sBAAAA,EAAAA;QACX,MAAMC,QAAAA,GAAWC,aAAED,QAAQ,EAAA;;QAG3BA,QAAAA,CAASE,GAAG,CAACL,SAAAA,EAAW;AAAEC,YAAAA;AAAG,SAAA,CAAA;;;QAI7B,KAAK,MAAM,CAACK,GAAAA,EAAKC,KAAAA,CAAM,IAAIH,YAAAA,CAAEI,cAAc,CAACC,MAAM,CAAE;YAClDN,QAAAA,CAASE,GAAG,CAACE,KAAAA,EAAO;gBAAEN,EAAAA,EAAIK;AAAI,aAAA,CAAA;AAChC,QAAA;;AAGA,QAAA,MAAM,EAAEI,OAAO,EAAE,GAAGN,YAAAA,CAAEO,YAAY,CAACR,QAAAA,EAAU;YAAES,GAAAA,EAAKC;AAAiB,SAAA,CAAA;;QAGrE,OAAOjB,iBAAAA,CAAkBc,OAAO,CAACT,EAAAA,CAAG,CAAA;AACtC,IAAA,CAAA,CAAE,OAAOa,CAAAA,EAAG;AACV,QAAA,MAAM,IAAIC,KAAAA,CAAM,0DAAA,CAAA;AAClB,IAAA;AACF;AAEA;;;;;UAMaF,gBAAAA,GAAmB,CAACZ,KAAe,CAAC,qBAAqB,EAAEA,EAAAA,CAAAA;;;;;;"}

package/dist/utils/zod.mjs

@@ -1,6 +1,16 @@
 import { randomUUID } from 'node:crypto';
 import * as z from 'zod/v4';
 
+/**
+ * Zod ≥3.25.76 embeds `$id` in `toJSONSchema` output (set after `override`).
+ * Strip it so OpenAPI documents stay stable — inline schemas use random UUIDs
+ * as registry ids — and match the pre-3.25.76 shape.
+ */ const stripJsonSchemaId = (schema)=>{
+    if ('$id' in schema) {
+        delete schema.$id;
+    }
+    return schema;
+};
 /**
  * Converts a Zod schema to an OpenAPI Schema Object.
  *
@@ -48,7 +58,7 @@ import * as z from 'zod/v4';
             uri: toComponentsPath
         });
         // TODO: make sure it's compliant
-        return schemas[id];
+        return stripJsonSchemaId(schemas[id]);
     } catch (e) {
         throw new Error("Couldn't transform the zod schema into an OpenAPI schema");
     }
@@ -60,5 +70,5 @@ import * as z from 'zod/v4';
  * @returns The constructed path string for the specified component schema.
  */ const toComponentsPath = (id)=>`#/components/schemas/${id}`;
 
-export { toComponentsPath, zodToOpenAPI };
+export { stripJsonSchemaId, toComponentsPath, zodToOpenAPI };
 //# sourceMappingURL=zod.mjs.map

package/dist/utils/zod.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"zod.mjs","sources":["../../src/utils/zod.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\nimport * as z from 'zod/v4';\n\nimport type { OpenAPIV3_1 } from 'openapi-types';\n\n/**\n * Converts a Zod schema to an OpenAPI Schema Object.\n *\n * @description\n * Takes a Zod schema and converts it into an OpenAPI Schema Object (v3.1).\n * It uses a local registry to handle the conversion process and generates the appropriate\n * OpenAPI components.\n *\n * @param zodSchema - The Zod schema to convert to OpenAPI format. Can be any valid Zod schema.\n *\n * @returns An OpenAPI Schema Object representing the input Zod schema structure.\n * If the conversion cannot be completed, returns undefined.\n *\n * @example\n * ```typescript\n * import * as z from 'zod/v4';\n *\n * // Create a Zod schema\n * const userSchema = z.object({\n *   id: z.number(),\n *   name: z.string(),\n *   email: z.string().email()\n * });\n *\n * // Convert to OpenAPI schema\n * const openAPISchema = zodToOpenAPI(userSchema);\n * ```\n */\n\nexport const zodToOpenAPI = (\n  zodSchema: z.ZodType\n): OpenAPIV3_1.SchemaObject | OpenAPIV3_1.ReferenceObject => {\n  try {\n    const id = randomUUID();\n    const registry = z.registry<{ id: string }>();\n\n    // Add the schema to the local registry with a custom, unique ID\n    registry.add(zodSchema, { id });\n\n    // Copy the global registry definitions into the local registry to make sure references are resolved\n    // This prevent \"__shared\" definitions from being created\n    for (const [key, value] of z.globalRegistry._idmap) {\n      registry.add(value, { id: key });\n    }\n\n    // Generate the schemas and only return the one we want, transform the URI path to be OpenAPI compliant\n    const { schemas } = z.toJSONSchema(registry, { uri: toComponentsPath });\n\n    // TODO: make sure it's compliant\n    return schemas[id] as OpenAPIV3_1.SchemaObject;\n  } catch (e) {\n    throw new Error(\"Couldn't transform the zod schema into an OpenAPI schema\");\n  }\n};\n\n/**\n * Generates a path string for referencing a component schema by its identifier.\n *\n * @param id - The identifier of the component schema.\n * @returns The constructed path string for the specified component schema.\n */\nexport const toComponentsPath = (id: string) => `#/components/schemas/${id}`;\n"],"names":["zodToOpenAPI","zodSchema","id","randomUUID","registry","z","add","key","value","globalRegistry","_idmap","schemas","toJSONSchema","uri","toComponentsPath","e","Error"],"mappings":";;;AAKA;;;;;;;;;;;;;;;;;;;;;;;;;;;IA6BO,MAAMA,YAAAA,GAAe,CAC1BC,SAAAA,GAAAA;IAEA,IAAI;AACF,QAAA,MAAMC,EAAAA,GAAKC,UAAAA,EAAAA;QACX,MAAMC,QAAAA,GAAWC,EAAED,QAAQ,EAAA;;QAG3BA,QAAAA,CAASE,GAAG,CAACL,SAAAA,EAAW;AAAEC,YAAAA;AAAG,SAAA,CAAA;;;QAI7B,KAAK,MAAM,CAACK,GAAAA,EAAKC,KAAAA,CAAM,IAAIH,CAAAA,CAAEI,cAAc,CAACC,MAAM,CAAE;YAClDN,QAAAA,CAASE,GAAG,CAACE,KAAAA,EAAO;gBAAEN,EAAAA,EAAIK;AAAI,aAAA,CAAA;AAChC,QAAA;;AAGA,QAAA,MAAM,EAAEI,OAAO,EAAE,GAAGN,CAAAA,CAAEO,YAAY,CAACR,QAAAA,EAAU;YAAES,GAAAA,EAAKC;AAAiB,SAAA,CAAA;;QAGrE,OAAOH,OAAO,CAACT,EAAAA,CAAG;AACpB,IAAA,CAAA,CAAE,OAAOa,CAAAA,EAAG;AACV,QAAA,MAAM,IAAIC,KAAAA,CAAM,0DAAA,CAAA;AAClB,IAAA;AACF;AAEA;;;;;UAMaF,gBAAAA,GAAmB,CAACZ,KAAe,CAAC,qBAAqB,EAAEA,EAAAA,CAAAA;;;;"}
+{"version":3,"file":"zod.mjs","sources":["../../src/utils/zod.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\nimport * as z from 'zod/v4';\n\nimport type { OpenAPIV3_1 } from 'openapi-types';\n\n/**\n * Zod ≥3.25.76 embeds `$id` in `toJSONSchema` output (set after `override`).\n * Strip it so OpenAPI documents stay stable — inline schemas use random UUIDs\n * as registry ids — and match the pre-3.25.76 shape.\n */\nexport const stripJsonSchemaId = <T extends object>(schema: T): T => {\n  if ('$id' in schema) {\n    delete (schema as { $id?: string }).$id;\n  }\n  return schema;\n};\n\n/**\n * Converts a Zod schema to an OpenAPI Schema Object.\n *\n * @description\n * Takes a Zod schema and converts it into an OpenAPI Schema Object (v3.1).\n * It uses a local registry to handle the conversion process and generates the appropriate\n * OpenAPI components.\n *\n * @param zodSchema - The Zod schema to convert to OpenAPI format. Can be any valid Zod schema.\n *\n * @returns An OpenAPI Schema Object representing the input Zod schema structure.\n * If the conversion cannot be completed, returns undefined.\n *\n * @example\n * ```typescript\n * import * as z from 'zod/v4';\n *\n * // Create a Zod schema\n * const userSchema = z.object({\n *   id: z.number(),\n *   name: z.string(),\n *   email: z.string().email()\n * });\n *\n * // Convert to OpenAPI schema\n * const openAPISchema = zodToOpenAPI(userSchema);\n * ```\n */\nexport const zodToOpenAPI = (\n  zodSchema: z.ZodType\n): OpenAPIV3_1.SchemaObject | OpenAPIV3_1.ReferenceObject => {\n  try {\n    const id = randomUUID();\n    const registry = z.registry<{ id: string }>();\n\n    // Add the schema to the local registry with a custom, unique ID\n    registry.add(zodSchema, { id });\n\n    // Copy the global registry definitions into the local registry to make sure references are resolved\n    // This prevent \"__shared\" definitions from being created\n    for (const [key, value] of z.globalRegistry._idmap) {\n      registry.add(value, { id: key });\n    }\n\n    // Generate the schemas and only return the one we want, transform the URI path to be OpenAPI compliant\n    const { schemas } = z.toJSONSchema(registry, { uri: toComponentsPath });\n\n    // TODO: make sure it's compliant\n    return stripJsonSchemaId(schemas[id] as OpenAPIV3_1.SchemaObject);\n  } catch (e) {\n    throw new Error(\"Couldn't transform the zod schema into an OpenAPI schema\");\n  }\n};\n\n/**\n * Generates a path string for referencing a component schema by its identifier.\n *\n * @param id - The identifier of the component schema.\n * @returns The constructed path string for the specified component schema.\n */\nexport const toComponentsPath = (id: string) => `#/components/schemas/${id}`;\n"],"names":["stripJsonSchemaId","schema","$id","zodToOpenAPI","zodSchema","id","randomUUID","registry","z","add","key","value","globalRegistry","_idmap","schemas","toJSONSchema","uri","toComponentsPath","e","Error"],"mappings":";;;AAKA;;;;IAKO,MAAMA,iBAAAA,GAAoB,CAAmBC,MAAAA,GAAAA;AAClD,IAAA,IAAI,SAASA,MAAAA,EAAQ;QACnB,OAAQA,OAA4BC,GAAG;AACzC,IAAA;IACA,OAAOD,MAAAA;AACT;AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;IA4BO,MAAME,YAAAA,GAAe,CAC1BC,SAAAA,GAAAA;IAEA,IAAI;AACF,QAAA,MAAMC,EAAAA,GAAKC,UAAAA,EAAAA;QACX,MAAMC,QAAAA,GAAWC,EAAED,QAAQ,EAAA;;QAG3BA,QAAAA,CAASE,GAAG,CAACL,SAAAA,EAAW;AAAEC,YAAAA;AAAG,SAAA,CAAA;;;QAI7B,KAAK,MAAM,CAACK,GAAAA,EAAKC,KAAAA,CAAM,IAAIH,CAAAA,CAAEI,cAAc,CAACC,MAAM,CAAE;YAClDN,QAAAA,CAASE,GAAG,CAACE,KAAAA,EAAO;gBAAEN,EAAAA,EAAIK;AAAI,aAAA,CAAA;AAChC,QAAA;;AAGA,QAAA,MAAM,EAAEI,OAAO,EAAE,GAAGN,CAAAA,CAAEO,YAAY,CAACR,QAAAA,EAAU;YAAES,GAAAA,EAAKC;AAAiB,SAAA,CAAA;;QAGrE,OAAOjB,iBAAAA,CAAkBc,OAAO,CAACT,EAAAA,CAAG,CAAA;AACtC,IAAA,CAAA,CAAE,OAAOa,CAAAA,EAAG;AACV,QAAA,MAAM,IAAIC,KAAAA,CAAM,0DAAA,CAAA;AAClB,IAAA;AACF;AAEA;;;;;UAMaF,gBAAAA,GAAmB,CAACZ,KAAe,CAAC,qBAAqB,EAAEA,EAAAA,CAAAA;;;;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@strapi/openapi",
-  "version": "5.50.2",
+  "version": "5.51.0",
   "description": "A tool set to help generate and validate API documentation for Strapi projects",
   "homepage": "https://strapi.io",
   "bugs": {
@@ -60,10 +60,10 @@
   "dependencies": {
     "debug": "4.3.4",
     "openapi-types": "12.1.3",
-    "zod": "3.25.67"
+    "zod": "3.25.76"
   },
   "devDependencies": {
-    "@strapi/types": "5.50.2",
+    "@strapi/types": "5.51.0",
     "@types/debug": "^4",
     "@types/jest": "29.5.2",
     "@types/node": "20.19.41",