@strapi/openapi 5.50.1 → 5.51.0

package/dist/assemblers/document/factory.d.ts

@@ -3,6 +3,8 @@ export declare class DocumentAssemblerFactory {
     createAll(): Assembler.Document[];
     private _createInfoAssembler;
     private _createMetadataAssembler;
+    private _createSecurityAssembler;
+    private _createServerAssembler;
     private _createPathsAssembler;
 }
 //# sourceMappingURL=factory.d.ts.map

package/dist/assemblers/document/factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/assemblers/document/factory.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAMpC,qBAAa,wBAAwB;IACnC,SAAS,IAAI,SAAS,CAAC,QAAQ,EAAE;IAQjC,OAAO,CAAC,oBAAoB;IAI5B,OAAO,CAAC,wBAAwB;IAIhC,OAAO,CAAC,qBAAqB;CAQ9B"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/assemblers/document/factory.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAQpC,qBAAa,wBAAwB;IACnC,SAAS,IAAI,SAAS,CAAC,QAAQ,EAAE;IAUjC,OAAO,CAAC,oBAAoB;IAI5B,OAAO,CAAC,wBAAwB;IAIhC,OAAO,CAAC,wBAAwB;IAIhC,OAAO,CAAC,sBAAsB;IAI9B,OAAO,CAAC,qBAAqB;CAQ9B"}

package/dist/assemblers/document/factory.js

@@ -13,12 +13,16 @@ require('./path/path-item/operation/operation.js');
 require('./path/path-item/operation/operation-id.js');
 require('./path/path-item/operation/parameters.js');
 require('./path/path-item/operation/tags.js');
+var security = require('./security.js');
+var server = require('./server.js');
 
 class DocumentAssemblerFactory {
     createAll() {
         return [
             this._createMetadataAssembler(),
             this._createInfoAssembler(),
+            this._createServerAssembler(),
+            this._createSecurityAssembler(),
             this._createPathsAssembler()
         ];
     }
@@ -28,6 +32,12 @@ class DocumentAssemblerFactory {
     _createMetadataAssembler() {
         return new metadata.DocumentMetadataAssembler();
     }
+    _createSecurityAssembler() {
+        return new security.DocumentSecurityAssembler();
+    }
+    _createServerAssembler() {
+        return new server.DocumentServerAssembler();
+    }
     _createPathsAssembler(assemblerFactory = new factory.PathAssemblerFactory(), contextFactory = new path.PathContextFactory()) {
         const assemblers = assemblerFactory.createAll();
         return new path$1.DocumentPathsAssembler(assemblers, contextFactory);

package/dist/assemblers/document/factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"factory.js","sources":["../../../src/assemblers/document/factory.ts"],"sourcesContent":["import { PathContextFactory } from '../../context';\n\nimport type { Assembler } from '..';\n\nimport { DocumentInfoAssembler } from './info';\nimport { DocumentMetadataAssembler } from './metadata';\nimport { DocumentPathsAssembler, PathAssemblerFactory } from './path';\n\nexport class DocumentAssemblerFactory {\n  createAll(): Assembler.Document[] {\n    return [\n      this._createMetadataAssembler(),\n      this._createInfoAssembler(),\n      this._createPathsAssembler(),\n    ];\n  }\n\n  private _createInfoAssembler() {\n    return new DocumentInfoAssembler();\n  }\n\n  private _createMetadataAssembler() {\n    return new DocumentMetadataAssembler();\n  }\n\n  private _createPathsAssembler(\n    assemblerFactory: PathAssemblerFactory = new PathAssemblerFactory(),\n    contextFactory: PathContextFactory = new PathContextFactory()\n  ) {\n    const assemblers = assemblerFactory.createAll();\n\n    return new DocumentPathsAssembler(assemblers, contextFactory);\n  }\n}\n"],"names":["DocumentAssemblerFactory","createAll","_createMetadataAssembler","_createInfoAssembler","_createPathsAssembler","DocumentInfoAssembler","DocumentMetadataAssembler","assemblerFactory","PathAssemblerFactory","contextFactory","PathContextFactory","assemblers","DocumentPathsAssembler"],"mappings":";;;;;;;;;;;;;;;;AAQO,MAAMA,wBAAAA,CAAAA;IACXC,SAAAA,GAAkC;QAChC,OAAO;AACL,YAAA,IAAI,CAACC,wBAAwB,EAAA;AAC7B,YAAA,IAAI,CAACC,oBAAoB,EAAA;AACzB,YAAA,IAAI,CAACC,qBAAqB;AAC3B,SAAA;AACH,IAAA;IAEQD,oBAAAA,GAAuB;AAC7B,QAAA,OAAO,IAAIE,0BAAAA,EAAAA;AACb,IAAA;IAEQH,wBAAAA,GAA2B;AACjC,QAAA,OAAO,IAAII,kCAAAA,EAAAA;AACb,IAAA;AAEQF,IAAAA,qBAAAA,CACNG,mBAAyC,IAAIC,4BAAAA,EAAsB,EACnEC,cAAAA,GAAqC,IAAIC,yBAAoB,EAC7D;QACA,MAAMC,UAAAA,GAAaJ,iBAAiBN,SAAS,EAAA;QAE7C,OAAO,IAAIW,8BAAuBD,UAAAA,EAAYF,cAAAA,CAAAA;AAChD,IAAA;AACF;;;;"}
+{"version":3,"file":"factory.js","sources":["../../../src/assemblers/document/factory.ts"],"sourcesContent":["import { PathContextFactory } from '../../context';\n\nimport type { Assembler } from '..';\n\nimport { DocumentInfoAssembler } from './info';\nimport { DocumentMetadataAssembler } from './metadata';\nimport { DocumentPathsAssembler, PathAssemblerFactory } from './path';\nimport { DocumentSecurityAssembler } from './security';\nimport { DocumentServerAssembler } from './server';\n\nexport class DocumentAssemblerFactory {\n  createAll(): Assembler.Document[] {\n    return [\n      this._createMetadataAssembler(),\n      this._createInfoAssembler(),\n      this._createServerAssembler(),\n      this._createSecurityAssembler(),\n      this._createPathsAssembler(),\n    ];\n  }\n\n  private _createInfoAssembler() {\n    return new DocumentInfoAssembler();\n  }\n\n  private _createMetadataAssembler() {\n    return new DocumentMetadataAssembler();\n  }\n\n  private _createSecurityAssembler() {\n    return new DocumentSecurityAssembler();\n  }\n\n  private _createServerAssembler() {\n    return new DocumentServerAssembler();\n  }\n\n  private _createPathsAssembler(\n    assemblerFactory: PathAssemblerFactory = new PathAssemblerFactory(),\n    contextFactory: PathContextFactory = new PathContextFactory()\n  ) {\n    const assemblers = assemblerFactory.createAll();\n\n    return new DocumentPathsAssembler(assemblers, contextFactory);\n  }\n}\n"],"names":["DocumentAssemblerFactory","createAll","_createMetadataAssembler","_createInfoAssembler","_createServerAssembler","_createSecurityAssembler","_createPathsAssembler","DocumentInfoAssembler","DocumentMetadataAssembler","DocumentSecurityAssembler","DocumentServerAssembler","assemblerFactory","PathAssemblerFactory","contextFactory","PathContextFactory","assemblers","DocumentPathsAssembler"],"mappings":";;;;;;;;;;;;;;;;;;AAUO,MAAMA,wBAAAA,CAAAA;IACXC,SAAAA,GAAkC;QAChC,OAAO;AACL,YAAA,IAAI,CAACC,wBAAwB,EAAA;AAC7B,YAAA,IAAI,CAACC,oBAAoB,EAAA;AACzB,YAAA,IAAI,CAACC,sBAAsB,EAAA;AAC3B,YAAA,IAAI,CAACC,wBAAwB,EAAA;AAC7B,YAAA,IAAI,CAACC,qBAAqB;AAC3B,SAAA;AACH,IAAA;IAEQH,oBAAAA,GAAuB;AAC7B,QAAA,OAAO,IAAII,0BAAAA,EAAAA;AACb,IAAA;IAEQL,wBAAAA,GAA2B;AACjC,QAAA,OAAO,IAAIM,kCAAAA,EAAAA;AACb,IAAA;IAEQH,wBAAAA,GAA2B;AACjC,QAAA,OAAO,IAAII,kCAAAA,EAAAA;AACb,IAAA;IAEQL,sBAAAA,GAAyB;AAC/B,QAAA,OAAO,IAAIM,8BAAAA,EAAAA;AACb,IAAA;AAEQJ,IAAAA,qBAAAA,CACNK,mBAAyC,IAAIC,4BAAAA,EAAsB,EACnEC,cAAAA,GAAqC,IAAIC,yBAAoB,EAC7D;QACA,MAAMC,UAAAA,GAAaJ,iBAAiBV,SAAS,EAAA;QAE7C,OAAO,IAAIe,8BAAuBD,UAAAA,EAAYF,cAAAA,CAAAA;AAChD,IAAA;AACF;;;;"}

package/dist/assemblers/document/factory.mjs

@@ -11,12 +11,16 @@ import './path/path-item/operation/operation.mjs';
 import './path/path-item/operation/operation-id.mjs';
 import './path/path-item/operation/parameters.mjs';
 import './path/path-item/operation/tags.mjs';
+import { DocumentSecurityAssembler } from './security.mjs';
+import { DocumentServerAssembler } from './server.mjs';
 
 class DocumentAssemblerFactory {
     createAll() {
         return [
             this._createMetadataAssembler(),
             this._createInfoAssembler(),
+            this._createServerAssembler(),
+            this._createSecurityAssembler(),
             this._createPathsAssembler()
         ];
     }
@@ -26,6 +30,12 @@ class DocumentAssemblerFactory {
     _createMetadataAssembler() {
         return new DocumentMetadataAssembler();
     }
+    _createSecurityAssembler() {
+        return new DocumentSecurityAssembler();
+    }
+    _createServerAssembler() {
+        return new DocumentServerAssembler();
+    }
     _createPathsAssembler(assemblerFactory = new PathAssemblerFactory(), contextFactory = new PathContextFactory()) {
         const assemblers = assemblerFactory.createAll();
         return new DocumentPathsAssembler(assemblers, contextFactory);

package/dist/assemblers/document/factory.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"factory.mjs","sources":["../../../src/assemblers/document/factory.ts"],"sourcesContent":["import { PathContextFactory } from '../../context';\n\nimport type { Assembler } from '..';\n\nimport { DocumentInfoAssembler } from './info';\nimport { DocumentMetadataAssembler } from './metadata';\nimport { DocumentPathsAssembler, PathAssemblerFactory } from './path';\n\nexport class DocumentAssemblerFactory {\n  createAll(): Assembler.Document[] {\n    return [\n      this._createMetadataAssembler(),\n      this._createInfoAssembler(),\n      this._createPathsAssembler(),\n    ];\n  }\n\n  private _createInfoAssembler() {\n    return new DocumentInfoAssembler();\n  }\n\n  private _createMetadataAssembler() {\n    return new DocumentMetadataAssembler();\n  }\n\n  private _createPathsAssembler(\n    assemblerFactory: PathAssemblerFactory = new PathAssemblerFactory(),\n    contextFactory: PathContextFactory = new PathContextFactory()\n  ) {\n    const assemblers = assemblerFactory.createAll();\n\n    return new DocumentPathsAssembler(assemblers, contextFactory);\n  }\n}\n"],"names":["DocumentAssemblerFactory","createAll","_createMetadataAssembler","_createInfoAssembler","_createPathsAssembler","DocumentInfoAssembler","DocumentMetadataAssembler","assemblerFactory","PathAssemblerFactory","contextFactory","PathContextFactory","assemblers","DocumentPathsAssembler"],"mappings":";;;;;;;;;;;;;;AAQO,MAAMA,wBAAAA,CAAAA;IACXC,SAAAA,GAAkC;QAChC,OAAO;AACL,YAAA,IAAI,CAACC,wBAAwB,EAAA;AAC7B,YAAA,IAAI,CAACC,oBAAoB,EAAA;AACzB,YAAA,IAAI,CAACC,qBAAqB;AAC3B,SAAA;AACH,IAAA;IAEQD,oBAAAA,GAAuB;AAC7B,QAAA,OAAO,IAAIE,qBAAAA,EAAAA;AACb,IAAA;IAEQH,wBAAAA,GAA2B;AACjC,QAAA,OAAO,IAAII,yBAAAA,EAAAA;AACb,IAAA;AAEQF,IAAAA,qBAAAA,CACNG,mBAAyC,IAAIC,oBAAAA,EAAsB,EACnEC,cAAAA,GAAqC,IAAIC,oBAAoB,EAC7D;QACA,MAAMC,UAAAA,GAAaJ,iBAAiBN,SAAS,EAAA;QAE7C,OAAO,IAAIW,uBAAuBD,UAAAA,EAAYF,cAAAA,CAAAA;AAChD,IAAA;AACF;;;;"}
+{"version":3,"file":"factory.mjs","sources":["../../../src/assemblers/document/factory.ts"],"sourcesContent":["import { PathContextFactory } from '../../context';\n\nimport type { Assembler } from '..';\n\nimport { DocumentInfoAssembler } from './info';\nimport { DocumentMetadataAssembler } from './metadata';\nimport { DocumentPathsAssembler, PathAssemblerFactory } from './path';\nimport { DocumentSecurityAssembler } from './security';\nimport { DocumentServerAssembler } from './server';\n\nexport class DocumentAssemblerFactory {\n  createAll(): Assembler.Document[] {\n    return [\n      this._createMetadataAssembler(),\n      this._createInfoAssembler(),\n      this._createServerAssembler(),\n      this._createSecurityAssembler(),\n      this._createPathsAssembler(),\n    ];\n  }\n\n  private _createInfoAssembler() {\n    return new DocumentInfoAssembler();\n  }\n\n  private _createMetadataAssembler() {\n    return new DocumentMetadataAssembler();\n  }\n\n  private _createSecurityAssembler() {\n    return new DocumentSecurityAssembler();\n  }\n\n  private _createServerAssembler() {\n    return new DocumentServerAssembler();\n  }\n\n  private _createPathsAssembler(\n    assemblerFactory: PathAssemblerFactory = new PathAssemblerFactory(),\n    contextFactory: PathContextFactory = new PathContextFactory()\n  ) {\n    const assemblers = assemblerFactory.createAll();\n\n    return new DocumentPathsAssembler(assemblers, contextFactory);\n  }\n}\n"],"names":["DocumentAssemblerFactory","createAll","_createMetadataAssembler","_createInfoAssembler","_createServerAssembler","_createSecurityAssembler","_createPathsAssembler","DocumentInfoAssembler","DocumentMetadataAssembler","DocumentSecurityAssembler","DocumentServerAssembler","assemblerFactory","PathAssemblerFactory","contextFactory","PathContextFactory","assemblers","DocumentPathsAssembler"],"mappings":";;;;;;;;;;;;;;;;AAUO,MAAMA,wBAAAA,CAAAA;IACXC,SAAAA,GAAkC;QAChC,OAAO;AACL,YAAA,IAAI,CAACC,wBAAwB,EAAA;AAC7B,YAAA,IAAI,CAACC,oBAAoB,EAAA;AACzB,YAAA,IAAI,CAACC,sBAAsB,EAAA;AAC3B,YAAA,IAAI,CAACC,wBAAwB,EAAA;AAC7B,YAAA,IAAI,CAACC,qBAAqB;AAC3B,SAAA;AACH,IAAA;IAEQH,oBAAAA,GAAuB;AAC7B,QAAA,OAAO,IAAII,qBAAAA,EAAAA;AACb,IAAA;IAEQL,wBAAAA,GAA2B;AACjC,QAAA,OAAO,IAAIM,yBAAAA,EAAAA;AACb,IAAA;IAEQH,wBAAAA,GAA2B;AACjC,QAAA,OAAO,IAAII,yBAAAA,EAAAA;AACb,IAAA;IAEQL,sBAAAA,GAAyB;AAC/B,QAAA,OAAO,IAAIM,uBAAAA,EAAAA;AACb,IAAA;AAEQJ,IAAAA,qBAAAA,CACNK,mBAAyC,IAAIC,oBAAAA,EAAsB,EACnEC,cAAAA,GAAqC,IAAIC,oBAAoB,EAC7D;QACA,MAAMC,UAAAA,GAAaJ,iBAAiBV,SAAS,EAAA;QAE7C,OAAO,IAAIe,uBAAuBD,UAAAA,EAAYF,cAAAA,CAAAA;AAChD,IAAA;AACF;;;;"}

package/dist/assemblers/document/path/path-item/operation/parameters.d.ts

@@ -5,5 +5,11 @@ export declare class OperationParametersAssembler implements Assembler.Operation
     assemble(context: OperationContext, route: Core.Route): void;
     private _getPathParameters;
     private _getQueryParameters;
+    /**
+     * Resolve composite OpenAPI schemas (allOf/anyOf/oneOf) into a flat object shape
+     * so nested Strapi query params can be emitted as bracket notation (e.g. pagination[page]).
+     */
+    private _resolveSchema;
+    private _extractCommonProperties;
 }
 //# sourceMappingURL=parameters.d.ts.map

package/dist/assemblers/document/path/path-item/operation/parameters.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parameters.d.ts","sourceRoot":"","sources":["../../../../../../src/assemblers/document/path/path-item/operation/parameters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAE1C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAQ7D,qBAAa,4BAA6B,YAAW,SAAS,CAAC,SAAS;IACtE,QAAQ,CAAC,OAAO,EAAE,gBAAgB,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,GAAG,IAAI;IAe5D,OAAO,CAAC,kBAAkB;IAoB1B,OAAO,CAAC,mBAAmB;CAuB5B"}
+{"version":3,"file":"parameters.d.ts","sourceRoot":"","sources":["../../../../../../src/assemblers/document/path/path-item/operation/parameters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAE1C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAY7D,qBAAa,4BAA6B,YAAW,SAAS,CAAC,SAAS;IACtE,QAAQ,CAAC,OAAO,EAAE,gBAAgB,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,GAAG,IAAI;IAe5D,OAAO,CAAC,kBAAkB;IAoB1B,OAAO,CAAC,mBAAmB;IAmD3B;;;OAGG;IACH,OAAO,CAAC,cAAc;IA2CtB,OAAO,CAAC,wBAAwB;CAqCjC"}

package/dist/assemblers/document/path/path-item/operation/parameters.js

@@ -2,6 +2,7 @@
 
 var debug$1 = require('../../../../../utils/debug.js');
 var zod = require('../../../../../utils/zod.js');
+var queryParamStyles = require('../../../query-param-styles.js');
 
 const debug = debug$1.createDebugger('assembler:parameters');
 class OperationParametersAssembler {
@@ -46,21 +47,112 @@ class OperationParametersAssembler {
         for (const [name, zodSchema] of Object.entries(query)){
             const required = !zodSchema.isOptional();
             const schema = zod.zodToOpenAPI(zodSchema);
-            const param = {
-                name,
-                in: 'query',
-                required,
-                schema
-            };
-            // In Strapi, query params are always interpreted as query strings, which isn't supported by the specification
-            // TODO: Make that configurable somehow
-            Object.assign(param, {
-                'x-strapi-serialize': 'querystring'
-            });
-            queryParams.push(param);
+            const resolvedSchema = this._resolveSchema(schema);
+            if (queryParamStyles.hasExpandableObjectProperties(resolvedSchema)) {
+                for (const [propName, propSchema] of Object.entries(resolvedSchema.properties)){
+                    const isRequired = resolvedSchema.required?.includes(propName) ?? false;
+                    const param = {
+                        name: `${name}[${propName}]`,
+                        in: 'query',
+                        required: isRequired,
+                        schema: propSchema
+                    };
+                    Object.assign(param, {
+                        'x-strapi-serialize': 'querystring'
+                    });
+                    queryParams.push(param);
+                }
+            } else if (queryParamStyles.shouldUseDeepObjectStyle(name, resolvedSchema)) {
+                const param = {
+                    name,
+                    in: 'query',
+                    required,
+                    schema: resolvedSchema,
+                    style: 'deepObject',
+                    explode: true
+                };
+                Object.assign(param, {
+                    'x-strapi-serialize': 'querystring'
+                });
+                queryParams.push(param);
+            } else {
+                const param = {
+                    name,
+                    in: 'query',
+                    required,
+                    schema
+                };
+                Object.assign(param, {
+                    'x-strapi-serialize': 'querystring'
+                });
+                queryParams.push(param);
+            }
         }
         return queryParams;
     }
+    /**
+   * Resolve composite OpenAPI schemas (allOf/anyOf/oneOf) into a flat object shape
+   * so nested Strapi query params can be emitted as bracket notation (e.g. pagination[page]).
+   */ _resolveSchema(schema) {
+        if (schema.type === 'object' && schema.properties) {
+            return schema;
+        }
+        if (schema.allOf && Array.isArray(schema.allOf)) {
+            const mergedSchema = {
+                type: 'object',
+                properties: {},
+                required: []
+            };
+            for (const subSchema of schema.allOf){
+                if (!('$ref' in subSchema)) {
+                    const hasAnyOfOneOf = Boolean(subSchema.anyOf || subSchema.oneOf);
+                    const resolved = this._resolveSchema(subSchema);
+                    if (resolved.type === 'object' && resolved.properties) {
+                        Object.assign(mergedSchema.properties, resolved.properties);
+                        if (resolved.required && !hasAnyOfOneOf) {
+                            mergedSchema.required = [
+                                ...mergedSchema.required ?? [],
+                                ...resolved.required
+                            ];
+                        }
+                    }
+                }
+            }
+            return queryParamStyles.hasExpandableObjectProperties(mergedSchema) ? mergedSchema : schema;
+        }
+        if (schema.anyOf && Array.isArray(schema.anyOf)) {
+            return this._extractCommonProperties(schema.anyOf, false);
+        }
+        if (schema.oneOf && Array.isArray(schema.oneOf)) {
+            return this._extractCommonProperties(schema.oneOf, false);
+        }
+        return schema;
+    }
+    _extractCommonProperties(schemas, preserveRequired = true) {
+        const objectSchemas = schemas.filter((s)=>!('$ref' in s)).map((s)=>this._resolveSchema(s)).filter((s)=>s.type === 'object' && s.properties);
+        if (objectSchemas.length === 0) {
+            return schemas[0];
+        }
+        const allProperties = {};
+        let allRequired = [];
+        for (const objSchema of objectSchemas){
+            Object.assign(allProperties, objSchema.properties);
+            if (preserveRequired && objSchema.required) {
+                allRequired.push(...objSchema.required);
+            }
+        }
+        if (!preserveRequired) {
+            allRequired = [];
+        }
+        if (Object.keys(allProperties).length === 0) {
+            return schemas[0];
+        }
+        return {
+            type: 'object',
+            properties: allProperties,
+            required: allRequired
+        };
+    }
 }
 
 exports.OperationParametersAssembler = OperationParametersAssembler;

package/dist/assemblers/document/path/path-item/operation/parameters.js.map

@@ -1 +1 @@
-{"version":3,"file":"parameters.js","sources":["../../../../../../src/assemblers/document/path/path-item/operation/parameters.ts"],"sourcesContent":["import type { Core } from '@strapi/types';\nimport type { OpenAPIV3_1 } from 'openapi-types';\nimport type { Assembler } from '../../../..';\n\nimport type { OperationContext } from '../../../../../types';\nimport { createDebugger, zodToOpenAPI } from '../../../../../utils';\n\nconst debug = createDebugger('assembler:parameters');\n\ntype PathParameterObject = OpenAPIV3_1.ParameterObject & { in: 'path' };\ntype QueryParameterObject = OpenAPIV3_1.ParameterObject & { in: 'query' };\n\nexport class OperationParametersAssembler implements Assembler.Operation {\n  assemble(context: OperationContext, route: Core.Route): void {\n    debug('assembling parameters for %o %o...', route.method, route.path);\n\n    const pathParameters = this._getPathParameters(route);\n    debug('found %o path parameters', pathParameters.length);\n\n    const queryParameters = this._getQueryParameters(route);\n    debug('found %o query parameters', queryParameters.length);\n\n    const parameters = [...pathParameters, ...queryParameters];\n    debug('assembled %o parameters for %o %o', parameters.length, route.method, route.path);\n\n    context.output.data.parameters = parameters;\n  }\n\n  private _getPathParameters(route: Core.Route): PathParameterObject[] {\n    const { params } = route.request ?? {};\n\n    // TODO: Allow auto inference (from path) if enabled through configuration\n    if (!params) {\n      return [];\n    }\n\n    const pathParams: PathParameterObject[] = [];\n\n    for (const [name, zodSchema] of Object.entries(params)) {\n      const required = !zodSchema.isOptional();\n      const schema = zodToOpenAPI(zodSchema) as any;\n\n      pathParams.push({ name, in: 'path', required, schema });\n    }\n\n    return pathParams;\n  }\n\n  private _getQueryParameters(route: Core.Route): QueryParameterObject[] {\n    const { query } = route.request ?? {};\n\n    if (!query) {\n      return [];\n    }\n\n    const queryParams: QueryParameterObject[] = [];\n\n    for (const [name, zodSchema] of Object.entries(query)) {\n      const required = !zodSchema.isOptional();\n      const schema = zodToOpenAPI(zodSchema) as any;\n      const param: QueryParameterObject = { name, in: 'query', required, schema };\n\n      // In Strapi, query params are always interpreted as query strings, which isn't supported by the specification\n      // TODO: Make that configurable somehow\n      Object.assign(param, { 'x-strapi-serialize': 'querystring' });\n\n      queryParams.push(param);\n    }\n\n    return queryParams;\n  }\n}\n"],"names":["debug","createDebugger","OperationParametersAssembler","assemble","context","route","method","path","pathParameters","_getPathParameters","length","queryParameters","_getQueryParameters","parameters","output","data","params","request","pathParams","name","zodSchema","Object","entries","required","isOptional","schema","zodToOpenAPI","push","in","query","queryParams","param","assign"],"mappings":";;;;;AAOA,MAAMA,QAAQC,sBAAAA,CAAe,sBAAA,CAAA;AAKtB,MAAMC,4BAAAA,CAAAA;IACXC,QAAAA,CAASC,OAAyB,EAAEC,KAAiB,EAAQ;AAC3DL,QAAAA,KAAAA,CAAM,oCAAA,EAAsCK,KAAAA,CAAMC,MAAM,EAAED,MAAME,IAAI,CAAA;AAEpE,QAAA,MAAMC,cAAAA,GAAiB,IAAI,CAACC,kBAAkB,CAACJ,KAAAA,CAAAA;QAC/CL,KAAAA,CAAM,0BAAA,EAA4BQ,eAAeE,MAAM,CAAA;AAEvD,QAAA,MAAMC,eAAAA,GAAkB,IAAI,CAACC,mBAAmB,CAACP,KAAAA,CAAAA;QACjDL,KAAAA,CAAM,2BAAA,EAA6BW,gBAAgBD,MAAM,CAAA;AAEzD,QAAA,MAAMG,UAAAA,GAAa;AAAIL,YAAAA,GAAAA,cAAAA;AAAmBG,YAAAA,GAAAA;AAAgB,SAAA;QAC1DX,KAAAA,CAAM,mCAAA,EAAqCa,WAAWH,MAAM,EAAEL,MAAMC,MAAM,EAAED,MAAME,IAAI,CAAA;AAEtFH,QAAAA,OAAAA,CAAQU,MAAM,CAACC,IAAI,CAACF,UAAU,GAAGA,UAAAA;AACnC,IAAA;AAEQJ,IAAAA,kBAAAA,CAAmBJ,KAAiB,EAAyB;AACnE,QAAA,MAAM,EAAEW,MAAM,EAAE,GAAGX,KAAAA,CAAMY,OAAO,IAAI,EAAC;;AAGrC,QAAA,IAAI,CAACD,MAAAA,EAAQ;AACX,YAAA,OAAO,EAAE;AACX,QAAA;AAEA,QAAA,MAAME,aAAoC,EAAE;QAE5C,KAAK,MAAM,CAACC,IAAAA,EAAMC,SAAAA,CAAU,IAAIC,MAAAA,CAAOC,OAAO,CAACN,MAAAA,CAAAA,CAAS;YACtD,MAAMO,QAAAA,GAAW,CAACH,SAAAA,CAAUI,UAAU,EAAA;AACtC,YAAA,MAAMC,SAASC,gBAAAA,CAAaN,SAAAA,CAAAA;AAE5BF,YAAAA,UAAAA,CAAWS,IAAI,CAAC;AAAER,gBAAAA,IAAAA;gBAAMS,EAAAA,EAAI,MAAA;AAAQL,gBAAAA,QAAAA;AAAUE,gBAAAA;AAAO,aAAA,CAAA;AACvD,QAAA;QAEA,OAAOP,UAAAA;AACT,IAAA;AAEQN,IAAAA,mBAAAA,CAAoBP,KAAiB,EAA0B;AACrE,QAAA,MAAM,EAAEwB,KAAK,EAAE,GAAGxB,KAAAA,CAAMY,OAAO,IAAI,EAAC;AAEpC,QAAA,IAAI,CAACY,KAAAA,EAAO;AACV,YAAA,OAAO,EAAE;AACX,QAAA;AAEA,QAAA,MAAMC,cAAsC,EAAE;QAE9C,KAAK,MAAM,CAACX,IAAAA,EAAMC,SAAAA,CAAU,IAAIC,MAAAA,CAAOC,OAAO,CAACO,KAAAA,CAAAA,CAAQ;YACrD,MAAMN,QAAAA,GAAW,CAACH,SAAAA,CAAUI,UAAU,EAAA;AACtC,YAAA,MAAMC,SAASC,gBAAAA,CAAaN,SAAAA,CAAAA;AAC5B,YAAA,MAAMW,KAAAA,GAA8B;AAAEZ,gBAAAA,IAAAA;gBAAMS,EAAAA,EAAI,OAAA;AAASL,gBAAAA,QAAAA;AAAUE,gBAAAA;AAAO,aAAA;;;YAI1EJ,MAAAA,CAAOW,MAAM,CAACD,KAAAA,EAAO;gBAAE,oBAAA,EAAsB;AAAc,aAAA,CAAA;AAE3DD,YAAAA,WAAAA,CAAYH,IAAI,CAACI,KAAAA,CAAAA;AACnB,QAAA;QAEA,OAAOD,WAAAA;AACT,IAAA;AACF;;;;"}
+{"version":3,"file":"parameters.js","sources":["../../../../../../src/assemblers/document/path/path-item/operation/parameters.ts"],"sourcesContent":["import type { Core } from '@strapi/types';\nimport type { OpenAPIV3_1 } from 'openapi-types';\nimport type { Assembler } from '../../../..';\n\nimport type { OperationContext } from '../../../../../types';\nimport { createDebugger, zodToOpenAPI } from '../../../../../utils';\nimport {\n  hasExpandableObjectProperties,\n  shouldUseDeepObjectStyle,\n} from '../../../query-param-styles';\n\nconst debug = createDebugger('assembler:parameters');\n\ntype PathParameterObject = OpenAPIV3_1.ParameterObject & { in: 'path' };\ntype QueryParameterObject = OpenAPIV3_1.ParameterObject & { in: 'query' };\n\nexport class OperationParametersAssembler implements Assembler.Operation {\n  assemble(context: OperationContext, route: Core.Route): void {\n    debug('assembling parameters for %o %o...', route.method, route.path);\n\n    const pathParameters = this._getPathParameters(route);\n    debug('found %o path parameters', pathParameters.length);\n\n    const queryParameters = this._getQueryParameters(route);\n    debug('found %o query parameters', queryParameters.length);\n\n    const parameters = [...pathParameters, ...queryParameters];\n    debug('assembled %o parameters for %o %o', parameters.length, route.method, route.path);\n\n    context.output.data.parameters = parameters;\n  }\n\n  private _getPathParameters(route: Core.Route): PathParameterObject[] {\n    const { params } = route.request ?? {};\n\n    // TODO: Allow auto inference (from path) if enabled through configuration\n    if (!params) {\n      return [];\n    }\n\n    const pathParams: PathParameterObject[] = [];\n\n    for (const [name, zodSchema] of Object.entries(params)) {\n      const required = !zodSchema.isOptional();\n      const schema = zodToOpenAPI(zodSchema) as any;\n\n      pathParams.push({ name, in: 'path', required, schema });\n    }\n\n    return pathParams;\n  }\n\n  private _getQueryParameters(route: Core.Route): QueryParameterObject[] {\n    const { query } = route.request ?? {};\n\n    if (!query) {\n      return [];\n    }\n\n    const queryParams: QueryParameterObject[] = [];\n\n    for (const [name, zodSchema] of Object.entries(query)) {\n      const required = !zodSchema.isOptional();\n      const schema = zodToOpenAPI(zodSchema) as any;\n\n      const resolvedSchema = this._resolveSchema(schema);\n\n      if (hasExpandableObjectProperties(resolvedSchema)) {\n        for (const [propName, propSchema] of Object.entries(resolvedSchema.properties!)) {\n          const isRequired = resolvedSchema.required?.includes(propName) ?? false;\n\n          const param: QueryParameterObject = {\n            name: `${name}[${propName}]`,\n            in: 'query',\n            required: isRequired,\n            schema: propSchema as any,\n          };\n\n          Object.assign(param, { 'x-strapi-serialize': 'querystring' });\n          queryParams.push(param);\n        }\n      } else if (shouldUseDeepObjectStyle(name, resolvedSchema)) {\n        const param: QueryParameterObject = {\n          name,\n          in: 'query',\n          required,\n          schema: resolvedSchema as any,\n          style: 'deepObject',\n          explode: true,\n        };\n\n        Object.assign(param, { 'x-strapi-serialize': 'querystring' });\n        queryParams.push(param);\n      } else {\n        const param: QueryParameterObject = { name, in: 'query', required, schema };\n        Object.assign(param, { 'x-strapi-serialize': 'querystring' });\n        queryParams.push(param);\n      }\n    }\n\n    return queryParams;\n  }\n\n  /**\n   * Resolve composite OpenAPI schemas (allOf/anyOf/oneOf) into a flat object shape\n   * so nested Strapi query params can be emitted as bracket notation (e.g. pagination[page]).\n   */\n  private _resolveSchema(schema: OpenAPIV3_1.SchemaObject): OpenAPIV3_1.SchemaObject {\n    if (schema.type === 'object' && schema.properties) {\n      return schema;\n    }\n\n    if (schema.allOf && Array.isArray(schema.allOf)) {\n      const mergedSchema: OpenAPIV3_1.SchemaObject = {\n        type: 'object',\n        properties: {},\n        required: [],\n      };\n\n      for (const subSchema of schema.allOf) {\n        if (!('$ref' in subSchema)) {\n          const hasAnyOfOneOf = Boolean(subSchema.anyOf || subSchema.oneOf);\n          const resolved = this._resolveSchema(subSchema);\n\n          if (resolved.type === 'object' && resolved.properties) {\n            Object.assign(mergedSchema.properties!, resolved.properties);\n            if (resolved.required && !hasAnyOfOneOf) {\n              mergedSchema.required = [\n                ...(mergedSchema.required ?? []),\n                ...(resolved.required as string[]),\n              ];\n            }\n          }\n        }\n      }\n\n      return hasExpandableObjectProperties(mergedSchema) ? mergedSchema : schema;\n    }\n\n    if (schema.anyOf && Array.isArray(schema.anyOf)) {\n      return this._extractCommonProperties(schema.anyOf, false);\n    }\n\n    if (schema.oneOf && Array.isArray(schema.oneOf)) {\n      return this._extractCommonProperties(schema.oneOf, false);\n    }\n\n    return schema;\n  }\n\n  private _extractCommonProperties(\n    schemas: OpenAPIV3_1.SchemaObject[],\n    preserveRequired = true\n  ): OpenAPIV3_1.SchemaObject {\n    const objectSchemas = schemas\n      .filter((s): s is OpenAPIV3_1.SchemaObject => !('$ref' in s))\n      .map((s) => this._resolveSchema(s))\n      .filter((s) => s.type === 'object' && s.properties);\n\n    if (objectSchemas.length === 0) {\n      return schemas[0] as OpenAPIV3_1.SchemaObject;\n    }\n\n    const allProperties: Record<string, OpenAPIV3_1.SchemaObject> = {};\n    let allRequired: string[] = [];\n\n    for (const objSchema of objectSchemas) {\n      Object.assign(allProperties, objSchema.properties);\n      if (preserveRequired && objSchema.required) {\n        allRequired.push(...(objSchema.required as string[]));\n      }\n    }\n\n    if (!preserveRequired) {\n      allRequired = [];\n    }\n\n    if (Object.keys(allProperties).length === 0) {\n      return schemas[0] as OpenAPIV3_1.SchemaObject;\n    }\n\n    return {\n      type: 'object',\n      properties: allProperties,\n      required: allRequired,\n    };\n  }\n}\n"],"names":["debug","createDebugger","OperationParametersAssembler","assemble","context","route","method","path","pathParameters","_getPathParameters","length","queryParameters","_getQueryParameters","parameters","output","data","params","request","pathParams","name","zodSchema","Object","entries","required","isOptional","schema","zodToOpenAPI","push","in","query","queryParams","resolvedSchema","_resolveSchema","hasExpandableObjectProperties","propName","propSchema","properties","isRequired","includes","param","assign","shouldUseDeepObjectStyle","style","explode","type","allOf","Array","isArray","mergedSchema","subSchema","hasAnyOfOneOf","Boolean","anyOf","oneOf","resolved","_extractCommonProperties","schemas","preserveRequired","objectSchemas","filter","s","map","allProperties","allRequired","objSchema","keys"],"mappings":"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"}

package/dist/assemblers/document/path/path-item/operation/parameters.mjs

@@ -1,5 +1,6 @@
 import { createDebugger } from '../../../../../utils/debug.mjs';
 import { zodToOpenAPI } from '../../../../../utils/zod.mjs';
+import { hasExpandableObjectProperties, shouldUseDeepObjectStyle } from '../../../query-param-styles.mjs';
 
 const debug = createDebugger('assembler:parameters');
 class OperationParametersAssembler {
@@ -44,21 +45,112 @@ class OperationParametersAssembler {
         for (const [name, zodSchema] of Object.entries(query)){
             const required = !zodSchema.isOptional();
             const schema = zodToOpenAPI(zodSchema);
-            const param = {
-                name,
-                in: 'query',
-                required,
-                schema
-            };
-            // In Strapi, query params are always interpreted as query strings, which isn't supported by the specification
-            // TODO: Make that configurable somehow
-            Object.assign(param, {
-                'x-strapi-serialize': 'querystring'
-            });
-            queryParams.push(param);
+            const resolvedSchema = this._resolveSchema(schema);
+            if (hasExpandableObjectProperties(resolvedSchema)) {
+                for (const [propName, propSchema] of Object.entries(resolvedSchema.properties)){
+                    const isRequired = resolvedSchema.required?.includes(propName) ?? false;
+                    const param = {
+                        name: `${name}[${propName}]`,
+                        in: 'query',
+                        required: isRequired,
+                        schema: propSchema
+                    };
+                    Object.assign(param, {
+                        'x-strapi-serialize': 'querystring'
+                    });
+                    queryParams.push(param);
+                }
+            } else if (shouldUseDeepObjectStyle(name, resolvedSchema)) {
+                const param = {
+                    name,
+                    in: 'query',
+                    required,
+                    schema: resolvedSchema,
+                    style: 'deepObject',
+                    explode: true
+                };
+                Object.assign(param, {
+                    'x-strapi-serialize': 'querystring'
+                });
+                queryParams.push(param);
+            } else {
+                const param = {
+                    name,
+                    in: 'query',
+                    required,
+                    schema
+                };
+                Object.assign(param, {
+                    'x-strapi-serialize': 'querystring'
+                });
+                queryParams.push(param);
+            }
         }
         return queryParams;
     }
+    /**
+   * Resolve composite OpenAPI schemas (allOf/anyOf/oneOf) into a flat object shape
+   * so nested Strapi query params can be emitted as bracket notation (e.g. pagination[page]).
+   */ _resolveSchema(schema) {
+        if (schema.type === 'object' && schema.properties) {
+            return schema;
+        }
+        if (schema.allOf && Array.isArray(schema.allOf)) {
+            const mergedSchema = {
+                type: 'object',
+                properties: {},
+                required: []
+            };
+            for (const subSchema of schema.allOf){
+                if (!('$ref' in subSchema)) {
+                    const hasAnyOfOneOf = Boolean(subSchema.anyOf || subSchema.oneOf);
+                    const resolved = this._resolveSchema(subSchema);
+                    if (resolved.type === 'object' && resolved.properties) {
+                        Object.assign(mergedSchema.properties, resolved.properties);
+                        if (resolved.required && !hasAnyOfOneOf) {
+                            mergedSchema.required = [
+                                ...mergedSchema.required ?? [],
+                                ...resolved.required
+                            ];
+                        }
+                    }
+                }
+            }
+            return hasExpandableObjectProperties(mergedSchema) ? mergedSchema : schema;
+        }
+        if (schema.anyOf && Array.isArray(schema.anyOf)) {
+            return this._extractCommonProperties(schema.anyOf, false);
+        }
+        if (schema.oneOf && Array.isArray(schema.oneOf)) {
+            return this._extractCommonProperties(schema.oneOf, false);
+        }
+        return schema;
+    }
+    _extractCommonProperties(schemas, preserveRequired = true) {
+        const objectSchemas = schemas.filter((s)=>!('$ref' in s)).map((s)=>this._resolveSchema(s)).filter((s)=>s.type === 'object' && s.properties);
+        if (objectSchemas.length === 0) {
+            return schemas[0];
+        }
+        const allProperties = {};
+        let allRequired = [];
+        for (const objSchema of objectSchemas){
+            Object.assign(allProperties, objSchema.properties);
+            if (preserveRequired && objSchema.required) {
+                allRequired.push(...objSchema.required);
+            }
+        }
+        if (!preserveRequired) {
+            allRequired = [];
+        }
+        if (Object.keys(allProperties).length === 0) {
+            return schemas[0];
+        }
+        return {
+            type: 'object',
+            properties: allProperties,
+            required: allRequired
+        };
+    }
 }
 
 export { OperationParametersAssembler };

package/dist/assemblers/document/path/path-item/operation/parameters.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"parameters.mjs","sources":["../../../../../../src/assemblers/document/path/path-item/operation/parameters.ts"],"sourcesContent":["import type { Core } from '@strapi/types';\nimport type { OpenAPIV3_1 } from 'openapi-types';\nimport type { Assembler } from '../../../..';\n\nimport type { OperationContext } from '../../../../../types';\nimport { createDebugger, zodToOpenAPI } from '../../../../../utils';\n\nconst debug = createDebugger('assembler:parameters');\n\ntype PathParameterObject = OpenAPIV3_1.ParameterObject & { in: 'path' };\ntype QueryParameterObject = OpenAPIV3_1.ParameterObject & { in: 'query' };\n\nexport class OperationParametersAssembler implements Assembler.Operation {\n  assemble(context: OperationContext, route: Core.Route): void {\n    debug('assembling parameters for %o %o...', route.method, route.path);\n\n    const pathParameters = this._getPathParameters(route);\n    debug('found %o path parameters', pathParameters.length);\n\n    const queryParameters = this._getQueryParameters(route);\n    debug('found %o query parameters', queryParameters.length);\n\n    const parameters = [...pathParameters, ...queryParameters];\n    debug('assembled %o parameters for %o %o', parameters.length, route.method, route.path);\n\n    context.output.data.parameters = parameters;\n  }\n\n  private _getPathParameters(route: Core.Route): PathParameterObject[] {\n    const { params } = route.request ?? {};\n\n    // TODO: Allow auto inference (from path) if enabled through configuration\n    if (!params) {\n      return [];\n    }\n\n    const pathParams: PathParameterObject[] = [];\n\n    for (const [name, zodSchema] of Object.entries(params)) {\n      const required = !zodSchema.isOptional();\n      const schema = zodToOpenAPI(zodSchema) as any;\n\n      pathParams.push({ name, in: 'path', required, schema });\n    }\n\n    return pathParams;\n  }\n\n  private _getQueryParameters(route: Core.Route): QueryParameterObject[] {\n    const { query } = route.request ?? {};\n\n    if (!query) {\n      return [];\n    }\n\n    const queryParams: QueryParameterObject[] = [];\n\n    for (const [name, zodSchema] of Object.entries(query)) {\n      const required = !zodSchema.isOptional();\n      const schema = zodToOpenAPI(zodSchema) as any;\n      const param: QueryParameterObject = { name, in: 'query', required, schema };\n\n      // In Strapi, query params are always interpreted as query strings, which isn't supported by the specification\n      // TODO: Make that configurable somehow\n      Object.assign(param, { 'x-strapi-serialize': 'querystring' });\n\n      queryParams.push(param);\n    }\n\n    return queryParams;\n  }\n}\n"],"names":["debug","createDebugger","OperationParametersAssembler","assemble","context","route","method","path","pathParameters","_getPathParameters","length","queryParameters","_getQueryParameters","parameters","output","data","params","request","pathParams","name","zodSchema","Object","entries","required","isOptional","schema","zodToOpenAPI","push","in","query","queryParams","param","assign"],"mappings":";;;AAOA,MAAMA,QAAQC,cAAAA,CAAe,sBAAA,CAAA;AAKtB,MAAMC,4BAAAA,CAAAA;IACXC,QAAAA,CAASC,OAAyB,EAAEC,KAAiB,EAAQ;AAC3DL,QAAAA,KAAAA,CAAM,oCAAA,EAAsCK,KAAAA,CAAMC,MAAM,EAAED,MAAME,IAAI,CAAA;AAEpE,QAAA,MAAMC,cAAAA,GAAiB,IAAI,CAACC,kBAAkB,CAACJ,KAAAA,CAAAA;QAC/CL,KAAAA,CAAM,0BAAA,EAA4BQ,eAAeE,MAAM,CAAA;AAEvD,QAAA,MAAMC,eAAAA,GAAkB,IAAI,CAACC,mBAAmB,CAACP,KAAAA,CAAAA;QACjDL,KAAAA,CAAM,2BAAA,EAA6BW,gBAAgBD,MAAM,CAAA;AAEzD,QAAA,MAAMG,UAAAA,GAAa;AAAIL,YAAAA,GAAAA,cAAAA;AAAmBG,YAAAA,GAAAA;AAAgB,SAAA;QAC1DX,KAAAA,CAAM,mCAAA,EAAqCa,WAAWH,MAAM,EAAEL,MAAMC,MAAM,EAAED,MAAME,IAAI,CAAA;AAEtFH,QAAAA,OAAAA,CAAQU,MAAM,CAACC,IAAI,CAACF,UAAU,GAAGA,UAAAA;AACnC,IAAA;AAEQJ,IAAAA,kBAAAA,CAAmBJ,KAAiB,EAAyB;AACnE,QAAA,MAAM,EAAEW,MAAM,EAAE,GAAGX,KAAAA,CAAMY,OAAO,IAAI,EAAC;;AAGrC,QAAA,IAAI,CAACD,MAAAA,EAAQ;AACX,YAAA,OAAO,EAAE;AACX,QAAA;AAEA,QAAA,MAAME,aAAoC,EAAE;QAE5C,KAAK,MAAM,CAACC,IAAAA,EAAMC,SAAAA,CAAU,IAAIC,MAAAA,CAAOC,OAAO,CAACN,MAAAA,CAAAA,CAAS;YACtD,MAAMO,QAAAA,GAAW,CAACH,SAAAA,CAAUI,UAAU,EAAA;AACtC,YAAA,MAAMC,SAASC,YAAAA,CAAaN,SAAAA,CAAAA;AAE5BF,YAAAA,UAAAA,CAAWS,IAAI,CAAC;AAAER,gBAAAA,IAAAA;gBAAMS,EAAAA,EAAI,MAAA;AAAQL,gBAAAA,QAAAA;AAAUE,gBAAAA;AAAO,aAAA,CAAA;AACvD,QAAA;QAEA,OAAOP,UAAAA;AACT,IAAA;AAEQN,IAAAA,mBAAAA,CAAoBP,KAAiB,EAA0B;AACrE,QAAA,MAAM,EAAEwB,KAAK,EAAE,GAAGxB,KAAAA,CAAMY,OAAO,IAAI,EAAC;AAEpC,QAAA,IAAI,CAACY,KAAAA,EAAO;AACV,YAAA,OAAO,EAAE;AACX,QAAA;AAEA,QAAA,MAAMC,cAAsC,EAAE;QAE9C,KAAK,MAAM,CAACX,IAAAA,EAAMC,SAAAA,CAAU,IAAIC,MAAAA,CAAOC,OAAO,CAACO,KAAAA,CAAAA,CAAQ;YACrD,MAAMN,QAAAA,GAAW,CAACH,SAAAA,CAAUI,UAAU,EAAA;AACtC,YAAA,MAAMC,SAASC,YAAAA,CAAaN,SAAAA,CAAAA;AAC5B,YAAA,MAAMW,KAAAA,GAA8B;AAAEZ,gBAAAA,IAAAA;gBAAMS,EAAAA,EAAI,OAAA;AAASL,gBAAAA,QAAAA;AAAUE,gBAAAA;AAAO,aAAA;;;YAI1EJ,MAAAA,CAAOW,MAAM,CAACD,KAAAA,EAAO;gBAAE,oBAAA,EAAsB;AAAc,aAAA,CAAA;AAE3DD,YAAAA,WAAAA,CAAYH,IAAI,CAACI,KAAAA,CAAAA;AACnB,QAAA;QAEA,OAAOD,WAAAA;AACT,IAAA;AACF;;;;"}
+{"version":3,"file":"parameters.mjs","sources":["../../../../../../src/assemblers/document/path/path-item/operation/parameters.ts"],"sourcesContent":["import type { Core } from '@strapi/types';\nimport type { OpenAPIV3_1 } from 'openapi-types';\nimport type { Assembler } from '../../../..';\n\nimport type { OperationContext } from '../../../../../types';\nimport { createDebugger, zodToOpenAPI } from '../../../../../utils';\nimport {\n  hasExpandableObjectProperties,\n  shouldUseDeepObjectStyle,\n} from '../../../query-param-styles';\n\nconst debug = createDebugger('assembler:parameters');\n\ntype PathParameterObject = OpenAPIV3_1.ParameterObject & { in: 'path' };\ntype QueryParameterObject = OpenAPIV3_1.ParameterObject & { in: 'query' };\n\nexport class OperationParametersAssembler implements Assembler.Operation {\n  assemble(context: OperationContext, route: Core.Route): void {\n    debug('assembling parameters for %o %o...', route.method, route.path);\n\n    const pathParameters = this._getPathParameters(route);\n    debug('found %o path parameters', pathParameters.length);\n\n    const queryParameters = this._getQueryParameters(route);\n    debug('found %o query parameters', queryParameters.length);\n\n    const parameters = [...pathParameters, ...queryParameters];\n    debug('assembled %o parameters for %o %o', parameters.length, route.method, route.path);\n\n    context.output.data.parameters = parameters;\n  }\n\n  private _getPathParameters(route: Core.Route): PathParameterObject[] {\n    const { params } = route.request ?? {};\n\n    // TODO: Allow auto inference (from path) if enabled through configuration\n    if (!params) {\n      return [];\n    }\n\n    const pathParams: PathParameterObject[] = [];\n\n    for (const [name, zodSchema] of Object.entries(params)) {\n      const required = !zodSchema.isOptional();\n      const schema = zodToOpenAPI(zodSchema) as any;\n\n      pathParams.push({ name, in: 'path', required, schema });\n    }\n\n    return pathParams;\n  }\n\n  private _getQueryParameters(route: Core.Route): QueryParameterObject[] {\n    const { query } = route.request ?? {};\n\n    if (!query) {\n      return [];\n    }\n\n    const queryParams: QueryParameterObject[] = [];\n\n    for (const [name, zodSchema] of Object.entries(query)) {\n      const required = !zodSchema.isOptional();\n      const schema = zodToOpenAPI(zodSchema) as any;\n\n      const resolvedSchema = this._resolveSchema(schema);\n\n      if (hasExpandableObjectProperties(resolvedSchema)) {\n        for (const [propName, propSchema] of Object.entries(resolvedSchema.properties!)) {\n          const isRequired = resolvedSchema.required?.includes(propName) ?? false;\n\n          const param: QueryParameterObject = {\n            name: `${name}[${propName}]`,\n            in: 'query',\n            required: isRequired,\n            schema: propSchema as any,\n          };\n\n          Object.assign(param, { 'x-strapi-serialize': 'querystring' });\n          queryParams.push(param);\n        }\n      } else if (shouldUseDeepObjectStyle(name, resolvedSchema)) {\n        const param: QueryParameterObject = {\n          name,\n          in: 'query',\n          required,\n          schema: resolvedSchema as any,\n          style: 'deepObject',\n          explode: true,\n        };\n\n        Object.assign(param, { 'x-strapi-serialize': 'querystring' });\n        queryParams.push(param);\n      } else {\n        const param: QueryParameterObject = { name, in: 'query', required, schema };\n        Object.assign(param, { 'x-strapi-serialize': 'querystring' });\n        queryParams.push(param);\n      }\n    }\n\n    return queryParams;\n  }\n\n  /**\n   * Resolve composite OpenAPI schemas (allOf/anyOf/oneOf) into a flat object shape\n   * so nested Strapi query params can be emitted as bracket notation (e.g. pagination[page]).\n   */\n  private _resolveSchema(schema: OpenAPIV3_1.SchemaObject): OpenAPIV3_1.SchemaObject {\n    if (schema.type === 'object' && schema.properties) {\n      return schema;\n    }\n\n    if (schema.allOf && Array.isArray(schema.allOf)) {\n      const mergedSchema: OpenAPIV3_1.SchemaObject = {\n        type: 'object',\n        properties: {},\n        required: [],\n      };\n\n      for (const subSchema of schema.allOf) {\n        if (!('$ref' in subSchema)) {\n          const hasAnyOfOneOf = Boolean(subSchema.anyOf || subSchema.oneOf);\n          const resolved = this._resolveSchema(subSchema);\n\n          if (resolved.type === 'object' && resolved.properties) {\n            Object.assign(mergedSchema.properties!, resolved.properties);\n            if (resolved.required && !hasAnyOfOneOf) {\n              mergedSchema.required = [\n                ...(mergedSchema.required ?? []),\n                ...(resolved.required as string[]),\n              ];\n            }\n          }\n        }\n      }\n\n      return hasExpandableObjectProperties(mergedSchema) ? mergedSchema : schema;\n    }\n\n    if (schema.anyOf && Array.isArray(schema.anyOf)) {\n      return this._extractCommonProperties(schema.anyOf, false);\n    }\n\n    if (schema.oneOf && Array.isArray(schema.oneOf)) {\n      return this._extractCommonProperties(schema.oneOf, false);\n    }\n\n    return schema;\n  }\n\n  private _extractCommonProperties(\n    schemas: OpenAPIV3_1.SchemaObject[],\n    preserveRequired = true\n  ): OpenAPIV3_1.SchemaObject {\n    const objectSchemas = schemas\n      .filter((s): s is OpenAPIV3_1.SchemaObject => !('$ref' in s))\n      .map((s) => this._resolveSchema(s))\n      .filter((s) => s.type === 'object' && s.properties);\n\n    if (objectSchemas.length === 0) {\n      return schemas[0] as OpenAPIV3_1.SchemaObject;\n    }\n\n    const allProperties: Record<string, OpenAPIV3_1.SchemaObject> = {};\n    let allRequired: string[] = [];\n\n    for (const objSchema of objectSchemas) {\n      Object.assign(allProperties, objSchema.properties);\n      if (preserveRequired && objSchema.required) {\n        allRequired.push(...(objSchema.required as string[]));\n      }\n    }\n\n    if (!preserveRequired) {\n      allRequired = [];\n    }\n\n    if (Object.keys(allProperties).length === 0) {\n      return schemas[0] as OpenAPIV3_1.SchemaObject;\n    }\n\n    return {\n      type: 'object',\n      properties: allProperties,\n      required: allRequired,\n    };\n  }\n}\n"],"names":["debug","createDebugger","OperationParametersAssembler","assemble","context","route","method","path","pathParameters","_getPathParameters","length","queryParameters","_getQueryParameters","parameters","output","data","params","request","pathParams","name","zodSchema","Object","entries","required","isOptional","schema","zodToOpenAPI","push","in","query","queryParams","resolvedSchema","_resolveSchema","hasExpandableObjectProperties","propName","propSchema","properties","isRequired","includes","param","assign","shouldUseDeepObjectStyle","style","explode","type","allOf","Array","isArray","mergedSchema","subSchema","hasAnyOfOneOf","Boolean","anyOf","oneOf","resolved","_extractCommonProperties","schemas","preserveRequired","objectSchemas","filter","s","map","allProperties","allRequired","objSchema","keys"],"mappings":"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"}

package/dist/assemblers/document/query-param-styles.d.ts

@@ -0,0 +1,10 @@
+import type { OpenAPIV3_1 } from 'openapi-types';
+/**
+ * Query params whose values are open-ended records parsed from bracket notation
+ * (e.g. filters[title][$eq]=hello). These are described as deepObject in OpenAPI
+ * rather than expanded into fixed sub-keys.
+ */
+export declare const DEEP_OBJECT_QUERY_PARAMS: Set<string>;
+export declare const shouldUseDeepObjectStyle: (name: string, schema: OpenAPIV3_1.SchemaObject) => boolean;
+export declare const hasExpandableObjectProperties: (schema: OpenAPIV3_1.SchemaObject) => boolean;
+//# sourceMappingURL=query-param-styles.d.ts.map

package/dist/assemblers/document/query-param-styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-param-styles.d.ts","sourceRoot":"","sources":["../../../src/assemblers/document/query-param-styles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,aAAuB,CAAC;AAE7D,eAAO,MAAM,wBAAwB,GACnC,MAAM,MAAM,EACZ,QAAQ,WAAW,CAAC,YAAY,KAC/B,OAWF,CAAC;AAEF,eAAO,MAAM,6BAA6B,GAAI,QAAQ,WAAW,CAAC,YAAY,KAAG,OAIhF,CAAC"}

package/dist/assemblers/document/query-param-styles.js

@@ -0,0 +1,23 @@
+'use strict';
+
+/**
+ * Query params whose values are open-ended records parsed from bracket notation
+ * (e.g. filters[title][$eq]=hello). These are described as deepObject in OpenAPI
+ * rather than expanded into fixed sub-keys.
+ */ const DEEP_OBJECT_QUERY_PARAMS = new Set([
+    'filters'
+]);
+const shouldUseDeepObjectStyle = (name, schema)=>{
+    if (DEEP_OBJECT_QUERY_PARAMS.has(name)) {
+        return true;
+    }
+    return schema.type === 'object' && (!schema.properties || Object.keys(schema.properties).length === 0) && schema.additionalProperties !== undefined && schema.additionalProperties !== false;
+};
+const hasExpandableObjectProperties = (schema)=>{
+    return Boolean(schema.type === 'object' && schema.properties && Object.keys(schema.properties).length > 0);
+};
+
+exports.DEEP_OBJECT_QUERY_PARAMS = DEEP_OBJECT_QUERY_PARAMS;
+exports.hasExpandableObjectProperties = hasExpandableObjectProperties;
+exports.shouldUseDeepObjectStyle = shouldUseDeepObjectStyle;
+//# sourceMappingURL=query-param-styles.js.map

package/dist/assemblers/document/query-param-styles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-param-styles.js","sources":["../../../src/assemblers/document/query-param-styles.ts"],"sourcesContent":["import type { OpenAPIV3_1 } from 'openapi-types';\n\n/**\n * Query params whose values are open-ended records parsed from bracket notation\n * (e.g. filters[title][$eq]=hello). These are described as deepObject in OpenAPI\n * rather than expanded into fixed sub-keys.\n */\nexport const DEEP_OBJECT_QUERY_PARAMS = new Set(['filters']);\n\nexport const shouldUseDeepObjectStyle = (\n  name: string,\n  schema: OpenAPIV3_1.SchemaObject\n): boolean => {\n  if (DEEP_OBJECT_QUERY_PARAMS.has(name)) {\n    return true;\n  }\n\n  return (\n    schema.type === 'object' &&\n    (!schema.properties || Object.keys(schema.properties).length === 0) &&\n    schema.additionalProperties !== undefined &&\n    schema.additionalProperties !== false\n  );\n};\n\nexport const hasExpandableObjectProperties = (schema: OpenAPIV3_1.SchemaObject): boolean => {\n  return Boolean(\n    schema.type === 'object' && schema.properties && Object.keys(schema.properties).length > 0\n  );\n};\n"],"names":["DEEP_OBJECT_QUERY_PARAMS","Set","shouldUseDeepObjectStyle","name","schema","has","type","properties","Object","keys","length","additionalProperties","undefined","hasExpandableObjectProperties","Boolean"],"mappings":";;AAEA;;;;AAIC,IACM,MAAMA,wBAAAA,GAA2B,IAAIC,GAAAA,CAAI;AAAC,IAAA;CAAU;AAEpD,MAAMC,wBAAAA,GAA2B,CACtCC,IAAAA,EACAC,MAAAA,GAAAA;IAEA,IAAIJ,wBAAAA,CAAyBK,GAAG,CAACF,IAAAA,CAAAA,EAAO;QACtC,OAAO,IAAA;AACT,IAAA;IAEA,OACEC,MAAAA,CAAOE,IAAI,KAAK,QAAA,KACf,CAACF,MAAAA,CAAOG,UAAU,IAAIC,MAAAA,CAAOC,IAAI,CAACL,OAAOG,UAAU,CAAA,CAAEG,MAAM,KAAK,CAAA,CAAA,IACjEN,MAAAA,CAAOO,oBAAoB,KAAKC,SAAAA,IAChCR,MAAAA,CAAOO,oBAAoB,KAAK,KAAA;AAEpC;AAEO,MAAME,gCAAgC,CAACT,MAAAA,GAAAA;AAC5C,IAAA,OAAOU,OAAAA,CACLV,MAAAA,CAAOE,IAAI,KAAK,YAAYF,MAAAA,CAAOG,UAAU,IAAIC,MAAAA,CAAOC,IAAI,CAACL,MAAAA,CAAOG,UAAU,CAAA,CAAEG,MAAM,GAAG,CAAA,CAAA;AAE7F;;;;;;"}

package/dist/assemblers/document/query-param-styles.mjs

@@ -0,0 +1,19 @@
+/**
+ * Query params whose values are open-ended records parsed from bracket notation
+ * (e.g. filters[title][$eq]=hello). These are described as deepObject in OpenAPI
+ * rather than expanded into fixed sub-keys.
+ */ const DEEP_OBJECT_QUERY_PARAMS = new Set([
+    'filters'
+]);
+const shouldUseDeepObjectStyle = (name, schema)=>{
+    if (DEEP_OBJECT_QUERY_PARAMS.has(name)) {
+        return true;
+    }
+    return schema.type === 'object' && (!schema.properties || Object.keys(schema.properties).length === 0) && schema.additionalProperties !== undefined && schema.additionalProperties !== false;
+};
+const hasExpandableObjectProperties = (schema)=>{
+    return Boolean(schema.type === 'object' && schema.properties && Object.keys(schema.properties).length > 0);
+};
+
+export { DEEP_OBJECT_QUERY_PARAMS, hasExpandableObjectProperties, shouldUseDeepObjectStyle };
+//# sourceMappingURL=query-param-styles.mjs.map

package/dist/assemblers/document/query-param-styles.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-param-styles.mjs","sources":["../../../src/assemblers/document/query-param-styles.ts"],"sourcesContent":["import type { OpenAPIV3_1 } from 'openapi-types';\n\n/**\n * Query params whose values are open-ended records parsed from bracket notation\n * (e.g. filters[title][$eq]=hello). These are described as deepObject in OpenAPI\n * rather than expanded into fixed sub-keys.\n */\nexport const DEEP_OBJECT_QUERY_PARAMS = new Set(['filters']);\n\nexport const shouldUseDeepObjectStyle = (\n  name: string,\n  schema: OpenAPIV3_1.SchemaObject\n): boolean => {\n  if (DEEP_OBJECT_QUERY_PARAMS.has(name)) {\n    return true;\n  }\n\n  return (\n    schema.type === 'object' &&\n    (!schema.properties || Object.keys(schema.properties).length === 0) &&\n    schema.additionalProperties !== undefined &&\n    schema.additionalProperties !== false\n  );\n};\n\nexport const hasExpandableObjectProperties = (schema: OpenAPIV3_1.SchemaObject): boolean => {\n  return Boolean(\n    schema.type === 'object' && schema.properties && Object.keys(schema.properties).length > 0\n  );\n};\n"],"names":["DEEP_OBJECT_QUERY_PARAMS","Set","shouldUseDeepObjectStyle","name","schema","has","type","properties","Object","keys","length","additionalProperties","undefined","hasExpandableObjectProperties","Boolean"],"mappings":"AAEA;;;;AAIC,IACM,MAAMA,wBAAAA,GAA2B,IAAIC,GAAAA,CAAI;AAAC,IAAA;CAAU;AAEpD,MAAMC,wBAAAA,GAA2B,CACtCC,IAAAA,EACAC,MAAAA,GAAAA;IAEA,IAAIJ,wBAAAA,CAAyBK,GAAG,CAACF,IAAAA,CAAAA,EAAO;QACtC,OAAO,IAAA;AACT,IAAA;IAEA,OACEC,MAAAA,CAAOE,IAAI,KAAK,QAAA,KACf,CAACF,MAAAA,CAAOG,UAAU,IAAIC,MAAAA,CAAOC,IAAI,CAACL,OAAOG,UAAU,CAAA,CAAEG,MAAM,KAAK,CAAA,CAAA,IACjEN,MAAAA,CAAOO,oBAAoB,KAAKC,SAAAA,IAChCR,MAAAA,CAAOO,oBAAoB,KAAK,KAAA;AAEpC;AAEO,MAAME,gCAAgC,CAACT,MAAAA,GAAAA;AAC5C,IAAA,OAAOU,OAAAA,CACLV,MAAAA,CAAOE,IAAI,KAAK,YAAYF,MAAAA,CAAOG,UAAU,IAAIC,MAAAA,CAAOC,IAAI,CAACL,MAAAA,CAAOG,UAAU,CAAA,CAAEG,MAAM,GAAG,CAAA,CAAA;AAE7F;;;;"}

package/dist/assemblers/document/security.d.ts

@@ -0,0 +1,8 @@
+import type { DocumentContext } from '../../types';
+import type { Assembler } from '..';
+export declare class DocumentSecurityAssembler implements Assembler.Document {
+    assemble(context: DocumentContext): void;
+    private _getSecuritySchemes;
+    private _getGlobalSecurity;
+}
+//# sourceMappingURL=security.d.ts.map

package/dist/assemblers/document/security.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"security.d.ts","sourceRoot":"","sources":["../../../src/assemblers/document/security.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AASpC,qBAAa,yBAA0B,YAAW,SAAS,CAAC,QAAQ;IAClE,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAcxC,OAAO,CAAC,mBAAmB;IAqB3B,OAAO,CAAC,kBAAkB;CAU3B"}

package/dist/assemblers/document/security.js

@@ -0,0 +1,45 @@
+'use strict';
+
+const DEFAULT_BEARER_AUTH = {
+    type: 'http',
+    scheme: 'bearer',
+    bearerFormat: 'JWT',
+    description: 'JWT Bearer token for authentication'
+};
+class DocumentSecurityAssembler {
+    assemble(context) {
+        const { strapi } = context;
+        const securitySchemes = this._getSecuritySchemes(strapi);
+        const security = this._getGlobalSecurity(strapi);
+        if (context.output.data.components === undefined) {
+            context.output.data.components = {};
+        }
+        context.output.data.components.securitySchemes = securitySchemes;
+        context.output.data.security = security;
+    }
+    _getSecuritySchemes(strapi) {
+        const securityConfig = strapi.config.get('openapi.security') ?? {};
+        const schemes = {};
+        if (!securityConfig.bearerAuth) {
+            schemes.bearerAuth = DEFAULT_BEARER_AUTH;
+        }
+        for (const [name, config] of Object.entries(securityConfig)){
+            schemes[name] = config;
+        }
+        return schemes;
+    }
+    _getGlobalSecurity(strapi) {
+        const globalSecurity = strapi.config.get('openapi.globalSecurity');
+        if (globalSecurity) {
+            return globalSecurity;
+        }
+        return [
+            {
+                bearerAuth: []
+            }
+        ];
+    }
+}
+
+exports.DocumentSecurityAssembler = DocumentSecurityAssembler;
+//# sourceMappingURL=security.js.map

package/dist/assemblers/document/security.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"security.js","sources":["../../../src/assemblers/document/security.ts"],"sourcesContent":["import type { Core } from '@strapi/types';\nimport type { OpenAPIV3_1 } from 'openapi-types';\n\nimport type { DocumentContext } from '../../types';\n\nimport type { Assembler } from '..';\n\nconst DEFAULT_BEARER_AUTH: OpenAPIV3_1.HttpSecurityScheme = {\n  type: 'http',\n  scheme: 'bearer',\n  bearerFormat: 'JWT',\n  description: 'JWT Bearer token for authentication',\n};\n\nexport class DocumentSecurityAssembler implements Assembler.Document {\n  assemble(context: DocumentContext): void {\n    const { strapi } = context;\n\n    const securitySchemes = this._getSecuritySchemes(strapi);\n    const security = this._getGlobalSecurity(strapi);\n\n    if (context.output.data.components === undefined) {\n      context.output.data.components = {};\n    }\n\n    context.output.data.components.securitySchemes = securitySchemes;\n    context.output.data.security = security;\n  }\n\n  private _getSecuritySchemes(\n    strapi: Core.Strapi\n  ): Record<string, OpenAPIV3_1.SecuritySchemeObject> {\n    const securityConfig =\n      strapi.config.get<\n        Record<string, OpenAPIV3_1.ReferenceObject | OpenAPIV3_1.SecuritySchemeObject>\n      >('openapi.security') ?? {};\n\n    const schemes: Record<string, OpenAPIV3_1.SecuritySchemeObject> = {};\n\n    if (!securityConfig.bearerAuth) {\n      schemes.bearerAuth = DEFAULT_BEARER_AUTH;\n    }\n\n    for (const [name, config] of Object.entries(securityConfig)) {\n      schemes[name] = config as OpenAPIV3_1.SecuritySchemeObject;\n    }\n\n    return schemes;\n  }\n\n  private _getGlobalSecurity(strapi: Core.Strapi): OpenAPIV3_1.Document['security'] {\n    const globalSecurity =\n      strapi.config.get<OpenAPIV3_1.Document['security']>('openapi.globalSecurity');\n\n    if (globalSecurity) {\n      return globalSecurity;\n    }\n\n    return [{ bearerAuth: [] }];\n  }\n}\n"],"names":["DEFAULT_BEARER_AUTH","type","scheme","bearerFormat","description","DocumentSecurityAssembler","assemble","context","strapi","securitySchemes","_getSecuritySchemes","security","_getGlobalSecurity","output","data","components","undefined","securityConfig","config","get","schemes","bearerAuth","name","Object","entries","globalSecurity"],"mappings":";;AAOA,MAAMA,mBAAAA,GAAsD;IAC1DC,IAAAA,EAAM,MAAA;IACNC,MAAAA,EAAQ,QAAA;IACRC,YAAAA,EAAc,KAAA;IACdC,WAAAA,EAAa;AACf,CAAA;AAEO,MAAMC,yBAAAA,CAAAA;AACXC,IAAAA,QAAAA,CAASC,OAAwB,EAAQ;QACvC,MAAM,EAAEC,MAAM,EAAE,GAAGD,OAAAA;AAEnB,QAAA,MAAME,eAAAA,GAAkB,IAAI,CAACC,mBAAmB,CAACF,MAAAA,CAAAA;AACjD,QAAA,MAAMG,QAAAA,GAAW,IAAI,CAACC,kBAAkB,CAACJ,MAAAA,CAAAA;AAEzC,QAAA,IAAID,QAAQM,MAAM,CAACC,IAAI,CAACC,UAAU,KAAKC,SAAAA,EAAW;AAChDT,YAAAA,OAAAA,CAAQM,MAAM,CAACC,IAAI,CAACC,UAAU,GAAG,EAAC;AACpC,QAAA;AAEAR,QAAAA,OAAAA,CAAQM,MAAM,CAACC,IAAI,CAACC,UAAU,CAACN,eAAe,GAAGA,eAAAA;AACjDF,QAAAA,OAAAA,CAAQM,MAAM,CAACC,IAAI,CAACH,QAAQ,GAAGA,QAAAA;AACjC,IAAA;AAEQD,IAAAA,mBAAAA,CACNF,MAAmB,EAC+B;AAClD,QAAA,MAAMS,iBACJT,MAAAA,CAAOU,MAAM,CAACC,GAAG,CAEf,uBAAuB,EAAC;AAE5B,QAAA,MAAMC,UAA4D,EAAC;QAEnE,IAAI,CAACH,cAAAA,CAAeI,UAAU,EAAE;AAC9BD,YAAAA,OAAAA,CAAQC,UAAU,GAAGrB,mBAAAA;AACvB,QAAA;QAEA,KAAK,MAAM,CAACsB,IAAAA,EAAMJ,MAAAA,CAAO,IAAIK,MAAAA,CAAOC,OAAO,CAACP,cAAAA,CAAAA,CAAiB;YAC3DG,OAAO,CAACE,KAAK,GAAGJ,MAAAA;AAClB,QAAA;QAEA,OAAOE,OAAAA;AACT,IAAA;AAEQR,IAAAA,kBAAAA,CAAmBJ,MAAmB,EAAoC;AAChF,QAAA,MAAMiB,cAAAA,GACJjB,MAAAA,CAAOU,MAAM,CAACC,GAAG,CAAmC,wBAAA,CAAA;AAEtD,QAAA,IAAIM,cAAAA,EAAgB;YAClB,OAAOA,cAAAA;AACT,QAAA;QAEA,OAAO;AAAC,YAAA;AAAEJ,gBAAAA,UAAAA,EAAY;AAAG;AAAE,SAAA;AAC7B,IAAA;AACF;;;;"}

package/dist/assemblers/document/security.mjs

@@ -0,0 +1,43 @@
+const DEFAULT_BEARER_AUTH = {
+    type: 'http',
+    scheme: 'bearer',
+    bearerFormat: 'JWT',
+    description: 'JWT Bearer token for authentication'
+};
+class DocumentSecurityAssembler {
+    assemble(context) {
+        const { strapi } = context;
+        const securitySchemes = this._getSecuritySchemes(strapi);
+        const security = this._getGlobalSecurity(strapi);
+        if (context.output.data.components === undefined) {
+            context.output.data.components = {};
+        }
+        context.output.data.components.securitySchemes = securitySchemes;
+        context.output.data.security = security;
+    }
+    _getSecuritySchemes(strapi) {
+        const securityConfig = strapi.config.get('openapi.security') ?? {};
+        const schemes = {};
+        if (!securityConfig.bearerAuth) {
+            schemes.bearerAuth = DEFAULT_BEARER_AUTH;
+        }
+        for (const [name, config] of Object.entries(securityConfig)){
+            schemes[name] = config;
+        }
+        return schemes;
+    }
+    _getGlobalSecurity(strapi) {
+        const globalSecurity = strapi.config.get('openapi.globalSecurity');
+        if (globalSecurity) {
+            return globalSecurity;
+        }
+        return [
+            {
+                bearerAuth: []
+            }
+        ];
+    }
+}
+
+export { DocumentSecurityAssembler };
+//# sourceMappingURL=security.mjs.map

package/dist/assemblers/document/security.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"security.mjs","sources":["../../../src/assemblers/document/security.ts"],"sourcesContent":["import type { Core } from '@strapi/types';\nimport type { OpenAPIV3_1 } from 'openapi-types';\n\nimport type { DocumentContext } from '../../types';\n\nimport type { Assembler } from '..';\n\nconst DEFAULT_BEARER_AUTH: OpenAPIV3_1.HttpSecurityScheme = {\n  type: 'http',\n  scheme: 'bearer',\n  bearerFormat: 'JWT',\n  description: 'JWT Bearer token for authentication',\n};\n\nexport class DocumentSecurityAssembler implements Assembler.Document {\n  assemble(context: DocumentContext): void {\n    const { strapi } = context;\n\n    const securitySchemes = this._getSecuritySchemes(strapi);\n    const security = this._getGlobalSecurity(strapi);\n\n    if (context.output.data.components === undefined) {\n      context.output.data.components = {};\n    }\n\n    context.output.data.components.securitySchemes = securitySchemes;\n    context.output.data.security = security;\n  }\n\n  private _getSecuritySchemes(\n    strapi: Core.Strapi\n  ): Record<string, OpenAPIV3_1.SecuritySchemeObject> {\n    const securityConfig =\n      strapi.config.get<\n        Record<string, OpenAPIV3_1.ReferenceObject | OpenAPIV3_1.SecuritySchemeObject>\n      >('openapi.security') ?? {};\n\n    const schemes: Record<string, OpenAPIV3_1.SecuritySchemeObject> = {};\n\n    if (!securityConfig.bearerAuth) {\n      schemes.bearerAuth = DEFAULT_BEARER_AUTH;\n    }\n\n    for (const [name, config] of Object.entries(securityConfig)) {\n      schemes[name] = config as OpenAPIV3_1.SecuritySchemeObject;\n    }\n\n    return schemes;\n  }\n\n  private _getGlobalSecurity(strapi: Core.Strapi): OpenAPIV3_1.Document['security'] {\n    const globalSecurity =\n      strapi.config.get<OpenAPIV3_1.Document['security']>('openapi.globalSecurity');\n\n    if (globalSecurity) {\n      return globalSecurity;\n    }\n\n    return [{ bearerAuth: [] }];\n  }\n}\n"],"names":["DEFAULT_BEARER_AUTH","type","scheme","bearerFormat","description","DocumentSecurityAssembler","assemble","context","strapi","securitySchemes","_getSecuritySchemes","security","_getGlobalSecurity","output","data","components","undefined","securityConfig","config","get","schemes","bearerAuth","name","Object","entries","globalSecurity"],"mappings":"AAOA,MAAMA,mBAAAA,GAAsD;IAC1DC,IAAAA,EAAM,MAAA;IACNC,MAAAA,EAAQ,QAAA;IACRC,YAAAA,EAAc,KAAA;IACdC,WAAAA,EAAa;AACf,CAAA;AAEO,MAAMC,yBAAAA,CAAAA;AACXC,IAAAA,QAAAA,CAASC,OAAwB,EAAQ;QACvC,MAAM,EAAEC,MAAM,EAAE,GAAGD,OAAAA;AAEnB,QAAA,MAAME,eAAAA,GAAkB,IAAI,CAACC,mBAAmB,CAACF,MAAAA,CAAAA;AACjD,QAAA,MAAMG,QAAAA,GAAW,IAAI,CAACC,kBAAkB,CAACJ,MAAAA,CAAAA;AAEzC,QAAA,IAAID,QAAQM,MAAM,CAACC,IAAI,CAACC,UAAU,KAAKC,SAAAA,EAAW;AAChDT,YAAAA,OAAAA,CAAQM,MAAM,CAACC,IAAI,CAACC,UAAU,GAAG,EAAC;AACpC,QAAA;AAEAR,QAAAA,OAAAA,CAAQM,MAAM,CAACC,IAAI,CAACC,UAAU,CAACN,eAAe,GAAGA,eAAAA;AACjDF,QAAAA,OAAAA,CAAQM,MAAM,CAACC,IAAI,CAACH,QAAQ,GAAGA,QAAAA;AACjC,IAAA;AAEQD,IAAAA,mBAAAA,CACNF,MAAmB,EAC+B;AAClD,QAAA,MAAMS,iBACJT,MAAAA,CAAOU,MAAM,CAACC,GAAG,CAEf,uBAAuB,EAAC;AAE5B,QAAA,MAAMC,UAA4D,EAAC;QAEnE,IAAI,CAACH,cAAAA,CAAeI,UAAU,EAAE;AAC9BD,YAAAA,OAAAA,CAAQC,UAAU,GAAGrB,mBAAAA;AACvB,QAAA;QAEA,KAAK,MAAM,CAACsB,IAAAA,EAAMJ,MAAAA,CAAO,IAAIK,MAAAA,CAAOC,OAAO,CAACP,cAAAA,CAAAA,CAAiB;YAC3DG,OAAO,CAACE,KAAK,GAAGJ,MAAAA;AAClB,QAAA;QAEA,OAAOE,OAAAA;AACT,IAAA;AAEQR,IAAAA,kBAAAA,CAAmBJ,MAAmB,EAAoC;AAChF,QAAA,MAAMiB,cAAAA,GACJjB,MAAAA,CAAOU,MAAM,CAACC,GAAG,CAAmC,wBAAA,CAAA;AAEtD,QAAA,IAAIM,cAAAA,EAAgB;YAClB,OAAOA,cAAAA;AACT,QAAA;QAEA,OAAO;AAAC,YAAA;AAAEJ,gBAAAA,UAAAA,EAAY;AAAG;AAAE,SAAA;AAC7B,IAAA;AACF;;;;"}

package/dist/assemblers/document/server.d.ts

@@ -0,0 +1,13 @@
+import type { OpenAPIV3_1 } from 'openapi-types';
+import type { DocumentContext } from '../../types';
+import type { Assembler } from '..';
+export interface ServerConfig {
+    url: string;
+    description?: string;
+    variables?: Record<string, OpenAPIV3_1.ServerVariableObject>;
+}
+export declare class DocumentServerAssembler implements Assembler.Document {
+    assemble(context: DocumentContext): void;
+    private _getServers;
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/assemblers/document/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/assemblers/document/server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAGjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAEpC,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,oBAAoB,CAAC,CAAC;CAC9D;AAID,qBAAa,uBAAwB,YAAW,SAAS,CAAC,QAAQ;IAChE,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAMxC,OAAO,CAAC,WAAW;CAgBpB"}

package/dist/assemblers/document/server.js

@@ -0,0 +1,25 @@
+'use strict';
+
+const DEFAULT_SERVER_URL = 'http://localhost:1337';
+class DocumentServerAssembler {
+    assemble(context) {
+        const { strapi } = context;
+        context.output.data.servers = this._getServers(strapi);
+    }
+    _getServers(strapi) {
+        const serverConfig = strapi.config.get('openapi.servers') ?? [];
+        if (serverConfig.length > 0) {
+            return serverConfig;
+        }
+        const serverUrl = strapi.config.get('server.url') ?? DEFAULT_SERVER_URL;
+        return [
+            {
+                url: serverUrl,
+                description: 'Default server'
+            }
+        ];
+    }
+}
+
+exports.DocumentServerAssembler = DocumentServerAssembler;
+//# sourceMappingURL=server.js.map

package/dist/assemblers/document/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sources":["../../../src/assemblers/document/server.ts"],"sourcesContent":["import type { OpenAPIV3_1 } from 'openapi-types';\n\nimport type { Core } from '@strapi/types';\nimport type { DocumentContext } from '../../types';\n\nimport type { Assembler } from '..';\n\nexport interface ServerConfig {\n  url: string;\n  description?: string;\n  variables?: Record<string, OpenAPIV3_1.ServerVariableObject>;\n}\n\nconst DEFAULT_SERVER_URL = 'http://localhost:1337';\n\nexport class DocumentServerAssembler implements Assembler.Document {\n  assemble(context: DocumentContext): void {\n    const { strapi } = context;\n\n    context.output.data.servers = this._getServers(strapi);\n  }\n\n  private _getServers(strapi: Core.Strapi): OpenAPIV3_1.ServerObject[] {\n    const serverConfig = strapi.config.get<ServerConfig[]>('openapi.servers') ?? [];\n\n    if (serverConfig.length > 0) {\n      return serverConfig;\n    }\n\n    const serverUrl = strapi.config.get<string>('server.url') ?? DEFAULT_SERVER_URL;\n\n    return [\n      {\n        url: serverUrl,\n        description: 'Default server',\n      },\n    ];\n  }\n}\n"],"names":["DEFAULT_SERVER_URL","DocumentServerAssembler","assemble","context","strapi","output","data","servers","_getServers","serverConfig","config","get","length","serverUrl","url","description"],"mappings":";;AAaA,MAAMA,kBAAAA,GAAqB,uBAAA;AAEpB,MAAMC,uBAAAA,CAAAA;AACXC,IAAAA,QAAAA,CAASC,OAAwB,EAAQ;QACvC,MAAM,EAAEC,MAAM,EAAE,GAAGD,OAAAA;QAEnBA,OAAAA,CAAQE,MAAM,CAACC,IAAI,CAACC,OAAO,GAAG,IAAI,CAACC,WAAW,CAACJ,MAAAA,CAAAA;AACjD,IAAA;AAEQI,IAAAA,WAAAA,CAAYJ,MAAmB,EAA8B;AACnE,QAAA,MAAMK,eAAeL,MAAAA,CAAOM,MAAM,CAACC,GAAG,CAAiB,sBAAsB,EAAE;QAE/E,IAAIF,YAAAA,CAAaG,MAAM,GAAG,CAAA,EAAG;YAC3B,OAAOH,YAAAA;AACT,QAAA;AAEA,QAAA,MAAMI,YAAYT,MAAAA,CAAOM,MAAM,CAACC,GAAG,CAAS,YAAA,CAAA,IAAiBX,kBAAAA;QAE7D,OAAO;AACL,YAAA;gBACEc,GAAAA,EAAKD,SAAAA;gBACLE,WAAAA,EAAa;AACf;AACD,SAAA;AACH,IAAA;AACF;;;;"}

package/dist/assemblers/document/server.mjs

@@ -0,0 +1,23 @@
+const DEFAULT_SERVER_URL = 'http://localhost:1337';
+class DocumentServerAssembler {
+    assemble(context) {
+        const { strapi } = context;
+        context.output.data.servers = this._getServers(strapi);
+    }
+    _getServers(strapi) {
+        const serverConfig = strapi.config.get('openapi.servers') ?? [];
+        if (serverConfig.length > 0) {
+            return serverConfig;
+        }
+        const serverUrl = strapi.config.get('server.url') ?? DEFAULT_SERVER_URL;
+        return [
+            {
+                url: serverUrl,
+                description: 'Default server'
+            }
+        ];
+    }
+}
+
+export { DocumentServerAssembler };
+//# sourceMappingURL=server.mjs.map

package/dist/assemblers/document/server.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.mjs","sources":["../../../src/assemblers/document/server.ts"],"sourcesContent":["import type { OpenAPIV3_1 } from 'openapi-types';\n\nimport type { Core } from '@strapi/types';\nimport type { DocumentContext } from '../../types';\n\nimport type { Assembler } from '..';\n\nexport interface ServerConfig {\n  url: string;\n  description?: string;\n  variables?: Record<string, OpenAPIV3_1.ServerVariableObject>;\n}\n\nconst DEFAULT_SERVER_URL = 'http://localhost:1337';\n\nexport class DocumentServerAssembler implements Assembler.Document {\n  assemble(context: DocumentContext): void {\n    const { strapi } = context;\n\n    context.output.data.servers = this._getServers(strapi);\n  }\n\n  private _getServers(strapi: Core.Strapi): OpenAPIV3_1.ServerObject[] {\n    const serverConfig = strapi.config.get<ServerConfig[]>('openapi.servers') ?? [];\n\n    if (serverConfig.length > 0) {\n      return serverConfig;\n    }\n\n    const serverUrl = strapi.config.get<string>('server.url') ?? DEFAULT_SERVER_URL;\n\n    return [\n      {\n        url: serverUrl,\n        description: 'Default server',\n      },\n    ];\n  }\n}\n"],"names":["DEFAULT_SERVER_URL","DocumentServerAssembler","assemble","context","strapi","output","data","servers","_getServers","serverConfig","config","get","length","serverUrl","url","description"],"mappings":"AAaA,MAAMA,kBAAAA,GAAqB,uBAAA;AAEpB,MAAMC,uBAAAA,CAAAA;AACXC,IAAAA,QAAAA,CAASC,OAAwB,EAAQ;QACvC,MAAM,EAAEC,MAAM,EAAE,GAAGD,OAAAA;QAEnBA,OAAAA,CAAQE,MAAM,CAACC,IAAI,CAACC,OAAO,GAAG,IAAI,CAACC,WAAW,CAACJ,MAAAA,CAAAA;AACjD,IAAA;AAEQI,IAAAA,WAAAA,CAAYJ,MAAmB,EAA8B;AACnE,QAAA,MAAMK,eAAeL,MAAAA,CAAOM,MAAM,CAACC,GAAG,CAAiB,sBAAsB,EAAE;QAE/E,IAAIF,YAAAA,CAAaG,MAAM,GAAG,CAAA,EAAG;YAC3B,OAAOH,YAAAA;AACT,QAAA;AAEA,QAAA,MAAMI,YAAYT,MAAAA,CAAOM,MAAM,CAACC,GAAG,CAAS,YAAA,CAAA,IAAiBX,kBAAAA;QAE7D,OAAO;AACL,YAAA;gBACEc,GAAAA,EAAKD,SAAAA;gBACLE,WAAAA,EAAa;AACf;AACD,SAAA;AACH,IAAA;AACF;;;;"}

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;CAS5C"}
+{"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,7 +29,14 @@ 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,
             schemas
         };
     }

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    output.data.components = { schemas };\n  }\n}\n"],"names":["ComponentsWriter","postProcess","context","output","schemas","z","toJSONSchema","globalRegistry","uri","toComponentsPath","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;QAEAN,MAAAA,CAAOO,IAAI,CAACC,UAAU,GAAG;AAAEP,YAAAA;AAAQ,SAAA;AACrC,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,7 +7,14 @@ 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,
             schemas
         };
     }

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    output.data.components = { schemas };\n  }\n}\n"],"names":["ComponentsWriter","postProcess","context","output","schemas","z","toJSONSchema","globalRegistry","uri","toComponentsPath","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;QAEAN,MAAAA,CAAOO,IAAI,CAACC,UAAU,GAAG;AAAEP,YAAAA;AAAQ,SAAA;AACrC,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.1",
+  "version": "5.51.0",
   "description": "A tool set to help generate and validate API documentation for Strapi projects",
   "homepage": "https://strapi.io",
   "bugs": {
@@ -47,8 +47,9 @@
     "build:types": "run -T tsc -p tsconfig.build.json --emitDeclarationOnly",
     "watch": "run -T rollup -c -w",
     "clean": "run -T rimraf ./dist",
-    "lint": "run -T eslint .",
+    "lint": "run -T eslint . --max-warnings=0",
     "prepublishOnly": "yarn clean && yarn build",
+    "test:ts": "run -T tsc -p tsconfig.json",
     "test:unit": "run -T jest",
     "test:unit:watch": "run -T jest --watch"
   },
@@ -59,10 +60,13 @@
   "dependencies": {
     "debug": "4.3.4",
     "openapi-types": "12.1.3",
-    "zod": "3.25.67"
+    "zod": "3.25.76"
   },
   "devDependencies": {
-    "@strapi/types": "5.50.1",
-    "@types/debug": "^4"
+    "@strapi/types": "5.51.0",
+    "@types/debug": "^4",
+    "@types/jest": "29.5.2",
+    "@types/node": "20.19.41",
+    "jest": "29.6.0"
   }
 }