@strapi/openapi 0.0.0 → 5.21.0

package/dist/utils/timer/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sources":["../../../src/utils/timer/factory.ts"],"sourcesContent":["import { Timer } from './timer';\n\nexport class TimerFactory {\n  create() {\n    return new Timer();\n  }\n}\n"],"names":["TimerFactory","create","Timer"],"mappings":";;;;AAEO,MAAMA,YAAAA,CAAAA;IACXC,MAAS,GAAA;AACP,QAAA,OAAO,IAAIC,WAAAA,EAAAA;AACb;AACF;;;;"}

package/dist/utils/timer/factory.mjs

@@ -0,0 +1,10 @@
+import { Timer } from './timer.mjs';
+
+class TimerFactory {
+    create() {
+        return new Timer();
+    }
+}
+
+export { TimerFactory };
+//# sourceMappingURL=factory.mjs.map

package/dist/utils/timer/factory.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.mjs","sources":["../../../src/utils/timer/factory.ts"],"sourcesContent":["import { Timer } from './timer';\n\nexport class TimerFactory {\n  create() {\n    return new Timer();\n  }\n}\n"],"names":["TimerFactory","create","Timer"],"mappings":";;AAEO,MAAMA,YAAAA,CAAAA;IACXC,MAAS,GAAA;AACP,QAAA,OAAO,IAAIC,KAAAA,EAAAA;AACb;AACF;;;;"}

package/dist/utils/timer/index.d.ts

@@ -0,0 +1,3 @@
+export { Timer } from './timer';
+export { TimerFactory } from './factory';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/timer/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/timer/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC"}

package/dist/utils/timer/timer.d.ts

@@ -0,0 +1,14 @@
+export declare class Timer {
+    private _startTime;
+    private _endTime;
+    private _elapsedTime;
+    constructor();
+    start(): number;
+    stop(): {
+        startTime: number;
+        endTime: number;
+        elapsedTime: number;
+    };
+    reset(): void;
+}
+//# sourceMappingURL=timer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"timer.d.ts","sourceRoot":"","sources":["../../../src/utils/timer/timer.ts"],"names":[],"mappings":"AAAA,qBAAa,KAAK;IAChB,OAAO,CAAC,UAAU,CAAgB;IAElC,OAAO,CAAC,QAAQ,CAAgB;IAEhC,OAAO,CAAC,YAAY,CAAgB;;IAQpC,KAAK,IAAI,MAAM;IAef,IAAI;;;;;IAWJ,KAAK,IAAI,IAAI;CAKd"}

package/dist/utils/timer/timer.js

@@ -0,0 +1,38 @@
+'use strict';
+
+class Timer {
+    start() {
+        if (this._startTime !== null) {
+            throw new Error('Timer is already started. Use `reset()` to reset the timer before starting it again.');
+        }
+        this._startTime = Date.now();
+        this._endTime = null;
+        this._elapsedTime = null;
+        return this._startTime;
+    }
+    stop() {
+        if (this._startTime === null) {
+            throw new Error('Timer is not started. Use `start()` to start the timer before stopping it.');
+        }
+        this._endTime = Date.now();
+        this._elapsedTime = this._endTime - this._startTime;
+        return {
+            startTime: this._startTime,
+            endTime: this._endTime,
+            elapsedTime: this._elapsedTime
+        };
+    }
+    reset() {
+        this._startTime = null;
+        this._endTime = null;
+        this._elapsedTime = null;
+    }
+    constructor(){
+        this._startTime = null;
+        this._endTime = null;
+        this._elapsedTime = null;
+    }
+}
+
+exports.Timer = Timer;
+//# sourceMappingURL=timer.js.map

package/dist/utils/timer/timer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timer.js","sources":["../../../src/utils/timer/timer.ts"],"sourcesContent":["export class Timer {\n  private _startTime: number | null;\n\n  private _endTime: number | null;\n\n  private _elapsedTime: number | null;\n\n  constructor() {\n    this._startTime = null;\n    this._endTime = null;\n    this._elapsedTime = null;\n  }\n\n  start(): number {\n    if (this._startTime !== null) {\n      throw new Error(\n        'Timer is already started. Use `reset()` to reset the timer before starting it again.'\n      );\n    }\n\n    this._startTime = Date.now();\n\n    this._endTime = null;\n    this._elapsedTime = null;\n\n    return this._startTime;\n  }\n\n  stop() {\n    if (this._startTime === null) {\n      throw new Error('Timer is not started. Use `start()` to start the timer before stopping it.');\n    }\n\n    this._endTime = Date.now();\n    this._elapsedTime = this._endTime - this._startTime;\n\n    return { startTime: this._startTime, endTime: this._endTime, elapsedTime: this._elapsedTime };\n  }\n\n  reset(): void {\n    this._startTime = null;\n    this._endTime = null;\n    this._elapsedTime = null;\n  }\n}\n"],"names":["Timer","start","_startTime","Error","Date","now","_endTime","_elapsedTime","stop","startTime","endTime","elapsedTime","reset","constructor"],"mappings":";;AAAO,MAAMA,KAAAA,CAAAA;IAaXC,KAAgB,GAAA;AACd,QAAA,IAAI,IAAI,CAACC,UAAU,KAAK,IAAM,EAAA;AAC5B,YAAA,MAAM,IAAIC,KACR,CAAA,sFAAA,CAAA;AAEJ;AAEA,QAAA,IAAI,CAACD,UAAU,GAAGE,IAAAA,CAAKC,GAAG,EAAA;QAE1B,IAAI,CAACC,QAAQ,GAAG,IAAA;QAChB,IAAI,CAACC,YAAY,GAAG,IAAA;QAEpB,OAAO,IAAI,CAACL,UAAU;AACxB;IAEAM,IAAO,GAAA;AACL,QAAA,IAAI,IAAI,CAACN,UAAU,KAAK,IAAM,EAAA;AAC5B,YAAA,MAAM,IAAIC,KAAM,CAAA,4EAAA,CAAA;AAClB;AAEA,QAAA,IAAI,CAACG,QAAQ,GAAGF,IAAAA,CAAKC,GAAG,EAAA;QACxB,IAAI,CAACE,YAAY,GAAG,IAAI,CAACD,QAAQ,GAAG,IAAI,CAACJ,UAAU;QAEnD,OAAO;YAAEO,SAAW,EAAA,IAAI,CAACP,UAAU;YAAEQ,OAAS,EAAA,IAAI,CAACJ,QAAQ;YAAEK,WAAa,EAAA,IAAI,CAACJ;AAAa,SAAA;AAC9F;IAEAK,KAAc,GAAA;QACZ,IAAI,CAACV,UAAU,GAAG,IAAA;QAClB,IAAI,CAACI,QAAQ,GAAG,IAAA;QAChB,IAAI,CAACC,YAAY,GAAG,IAAA;AACtB;IApCAM,WAAc,EAAA;QACZ,IAAI,CAACX,UAAU,GAAG,IAAA;QAClB,IAAI,CAACI,QAAQ,GAAG,IAAA;QAChB,IAAI,CAACC,YAAY,GAAG,IAAA;AACtB;AAiCF;;;;"}

package/dist/utils/timer/timer.mjs

@@ -0,0 +1,36 @@
+class Timer {
+    start() {
+        if (this._startTime !== null) {
+            throw new Error('Timer is already started. Use `reset()` to reset the timer before starting it again.');
+        }
+        this._startTime = Date.now();
+        this._endTime = null;
+        this._elapsedTime = null;
+        return this._startTime;
+    }
+    stop() {
+        if (this._startTime === null) {
+            throw new Error('Timer is not started. Use `start()` to start the timer before stopping it.');
+        }
+        this._endTime = Date.now();
+        this._elapsedTime = this._endTime - this._startTime;
+        return {
+            startTime: this._startTime,
+            endTime: this._endTime,
+            elapsedTime: this._elapsedTime
+        };
+    }
+    reset() {
+        this._startTime = null;
+        this._endTime = null;
+        this._elapsedTime = null;
+    }
+    constructor(){
+        this._startTime = null;
+        this._endTime = null;
+        this._elapsedTime = null;
+    }
+}
+
+export { Timer };
+//# sourceMappingURL=timer.mjs.map

package/dist/utils/timer/timer.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"timer.mjs","sources":["../../../src/utils/timer/timer.ts"],"sourcesContent":["export class Timer {\n  private _startTime: number | null;\n\n  private _endTime: number | null;\n\n  private _elapsedTime: number | null;\n\n  constructor() {\n    this._startTime = null;\n    this._endTime = null;\n    this._elapsedTime = null;\n  }\n\n  start(): number {\n    if (this._startTime !== null) {\n      throw new Error(\n        'Timer is already started. Use `reset()` to reset the timer before starting it again.'\n      );\n    }\n\n    this._startTime = Date.now();\n\n    this._endTime = null;\n    this._elapsedTime = null;\n\n    return this._startTime;\n  }\n\n  stop() {\n    if (this._startTime === null) {\n      throw new Error('Timer is not started. Use `start()` to start the timer before stopping it.');\n    }\n\n    this._endTime = Date.now();\n    this._elapsedTime = this._endTime - this._startTime;\n\n    return { startTime: this._startTime, endTime: this._endTime, elapsedTime: this._elapsedTime };\n  }\n\n  reset(): void {\n    this._startTime = null;\n    this._endTime = null;\n    this._elapsedTime = null;\n  }\n}\n"],"names":["Timer","start","_startTime","Error","Date","now","_endTime","_elapsedTime","stop","startTime","endTime","elapsedTime","reset","constructor"],"mappings":"AAAO,MAAMA,KAAAA,CAAAA;IAaXC,KAAgB,GAAA;AACd,QAAA,IAAI,IAAI,CAACC,UAAU,KAAK,IAAM,EAAA;AAC5B,YAAA,MAAM,IAAIC,KACR,CAAA,sFAAA,CAAA;AAEJ;AAEA,QAAA,IAAI,CAACD,UAAU,GAAGE,IAAAA,CAAKC,GAAG,EAAA;QAE1B,IAAI,CAACC,QAAQ,GAAG,IAAA;QAChB,IAAI,CAACC,YAAY,GAAG,IAAA;QAEpB,OAAO,IAAI,CAACL,UAAU;AACxB;IAEAM,IAAO,GAAA;AACL,QAAA,IAAI,IAAI,CAACN,UAAU,KAAK,IAAM,EAAA;AAC5B,YAAA,MAAM,IAAIC,KAAM,CAAA,4EAAA,CAAA;AAClB;AAEA,QAAA,IAAI,CAACG,QAAQ,GAAGF,IAAAA,CAAKC,GAAG,EAAA;QACxB,IAAI,CAACE,YAAY,GAAG,IAAI,CAACD,QAAQ,GAAG,IAAI,CAACJ,UAAU;QAEnD,OAAO;YAAEO,SAAW,EAAA,IAAI,CAACP,UAAU;YAAEQ,OAAS,EAAA,IAAI,CAACJ,QAAQ;YAAEK,WAAa,EAAA,IAAI,CAACJ;AAAa,SAAA;AAC9F;IAEAK,KAAc,GAAA;QACZ,IAAI,CAACV,UAAU,GAAG,IAAA;QAClB,IAAI,CAACI,QAAQ,GAAG,IAAA;QAChB,IAAI,CAACC,YAAY,GAAG,IAAA;AACtB;IApCAM,WAAc,EAAA;QACZ,IAAI,CAACX,UAAU,GAAG,IAAA;QAClB,IAAI,CAACI,QAAQ,GAAG,IAAA;QAChB,IAAI,CAACC,YAAY,GAAG,IAAA;AACtB;AAiCF;;;;"}

package/dist/utils/zod.d.ts

@@ -0,0 +1,39 @@
+import * as z from 'zod/v4';
+import type { OpenAPIV3_1 } from 'openapi-types';
+/**
+ * Converts a Zod schema to an OpenAPI Schema Object.
+ *
+ * @description
+ * Takes a Zod schema and converts it into an OpenAPI Schema Object (v3.1).
+ * It uses a local registry to handle the conversion process and generates the appropriate
+ * OpenAPI components.
+ *
+ * @param zodSchema - The Zod schema to convert to OpenAPI format. Can be any valid Zod schema.
+ *
+ * @returns An OpenAPI Schema Object representing the input Zod schema structure.
+ * If the conversion cannot be completed, returns undefined.
+ *
+ * @example
+ * ```typescript
+ * import * as z from 'zod/v4';
+ *
+ * // Create a Zod schema
+ * const userSchema = z.object({
+ *   id: z.number(),
+ *   name: z.string(),
+ *   email: z.string().email()
+ * });
+ *
+ * // Convert to OpenAPI schema
+ * const openAPISchema = zodToOpenAPI(userSchema);
+ * ```
+ */
+export declare const zodToOpenAPI: (zodSchema: z.ZodType) => OpenAPIV3_1.SchemaObject | OpenAPIV3_1.ReferenceObject;
+/**
+ * Generates a path string for referencing a component schema by its identifier.
+ *
+ * @param id - The identifier of the component schema.
+ * @returns The constructed path string for the specified component schema.
+ */
+export declare const toComponentsPath: (id: string) => string;
+//# sourceMappingURL=zod.d.ts.map

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

@@ -0,0 +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,cACZ,EAAE,OAAO,KACnB,YAAY,YAAY,GAAG,YAAY,eAsBzC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,OAAQ,MAAM,WAAiC,CAAC"}

package/dist/utils/zod.js

@@ -0,0 +1,86 @@
+'use strict';
+
+var node_crypto = require('node:crypto');
+var z = require('zod/v4');
+
+function _interopNamespaceDefault(e) {
+  var n = Object.create(null);
+  if (e) {
+    Object.keys(e).forEach(function (k) {
+      if (k !== 'default') {
+        var d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: function () { return e[k]; }
+        });
+      }
+    });
+  }
+  n.default = e;
+  return Object.freeze(n);
+}
+
+var z__namespace = /*#__PURE__*/_interopNamespaceDefault(z);
+
+/**
+ * Converts a Zod schema to an OpenAPI Schema Object.
+ *
+ * @description
+ * Takes a Zod schema and converts it into an OpenAPI Schema Object (v3.1).
+ * It uses a local registry to handle the conversion process and generates the appropriate
+ * OpenAPI components.
+ *
+ * @param zodSchema - The Zod schema to convert to OpenAPI format. Can be any valid Zod schema.
+ *
+ * @returns An OpenAPI Schema Object representing the input Zod schema structure.
+ * If the conversion cannot be completed, returns undefined.
+ *
+ * @example
+ * ```typescript
+ * import * as z from 'zod/v4';
+ *
+ * // Create a Zod schema
+ * const userSchema = z.object({
+ *   id: z.number(),
+ *   name: z.string(),
+ *   email: z.string().email()
+ * });
+ *
+ * // Convert to OpenAPI schema
+ * const openAPISchema = zodToOpenAPI(userSchema);
+ * ```
+ */ const zodToOpenAPI = (zodSchema)=>{
+    try {
+        const id = node_crypto.randomUUID();
+        const registry = z__namespace.registry();
+        // Add the schema to the local registry with a custom, unique ID
+        registry.add(zodSchema, {
+            id
+        });
+        // Copy the global registry definitions into the local registry to make sure references are resolved
+        // This prevent "__shared" definitions from being created
+        for (const [key, value] of z__namespace.globalRegistry._idmap){
+            registry.add(value, {
+                id: key
+            });
+        }
+        // Generate the schemas and only return the one we want, transform the URI path to be OpenAPI compliant
+        const { schemas } = z__namespace.toJSONSchema(registry, {
+            uri: toComponentsPath
+        });
+        // TODO: make sure it's compliant
+        return schemas[id];
+    } catch (e) {
+        throw new Error("Couldn't transform the zod schema into an OpenAPI schema");
+    }
+};
+/**
+ * Generates a path string for referencing a component schema by its identifier.
+ *
+ * @param id - The identifier of the component schema.
+ * @returns The constructed path string for the specified component schema.
+ */ const toComponentsPath = (id)=>`#/components/schemas/${id}`;
+
+exports.toComponentsPath = toComponentsPath;
+exports.zodToOpenAPI = zodToOpenAPI;
+//# sourceMappingURL=zod.js.map

package/dist/utils/zod.js.map

@@ -0,0 +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;;;;;;;;;;;;;;;;;;;;;;;;;;;IA6BaA,MAAAA,YAAAA,GAAe,CAC1BC,SAAAA,GAAAA;IAEA,IAAI;AACF,QAAA,MAAMC,EAAKC,GAAAA,sBAAAA,EAAAA;QACX,MAAMC,QAAAA,GAAWC,aAAED,QAAQ,EAAA;;QAG3BA,QAASE,CAAAA,GAAG,CAACL,SAAW,EAAA;AAAEC,YAAAA;AAAG,SAAA,CAAA;;;QAI7B,KAAK,MAAM,CAACK,GAAKC,EAAAA,KAAAA,CAAM,IAAIH,YAAEI,CAAAA,cAAc,CAACC,MAAM,CAAE;YAClDN,QAASE,CAAAA,GAAG,CAACE,KAAO,EAAA;gBAAEN,EAAIK,EAAAA;AAAI,aAAA,CAAA;AAChC;;AAGA,QAAA,MAAM,EAAEI,OAAO,EAAE,GAAGN,YAAEO,CAAAA,YAAY,CAACR,QAAU,EAAA;YAAES,GAAKC,EAAAA;AAAiB,SAAA,CAAA;;QAGrE,OAAOH,OAAO,CAACT,EAAG,CAAA;AACpB,KAAA,CAAE,OAAOa,CAAG,EAAA;AACV,QAAA,MAAM,IAAIC,KAAM,CAAA,0DAAA,CAAA;AAClB;AACF;AAEA;;;;;IAMaF,MAAAA,gBAAAA,GAAmB,CAACZ,EAAAA,GAAe,CAAC,qBAAqB,EAAEA,EAAG,CAAA;;;;;"}

package/dist/utils/zod.mjs

@@ -0,0 +1,64 @@
+import { randomUUID } from 'node:crypto';
+import * as z from 'zod/v4';
+
+/**
+ * Converts a Zod schema to an OpenAPI Schema Object.
+ *
+ * @description
+ * Takes a Zod schema and converts it into an OpenAPI Schema Object (v3.1).
+ * It uses a local registry to handle the conversion process and generates the appropriate
+ * OpenAPI components.
+ *
+ * @param zodSchema - The Zod schema to convert to OpenAPI format. Can be any valid Zod schema.
+ *
+ * @returns An OpenAPI Schema Object representing the input Zod schema structure.
+ * If the conversion cannot be completed, returns undefined.
+ *
+ * @example
+ * ```typescript
+ * import * as z from 'zod/v4';
+ *
+ * // Create a Zod schema
+ * const userSchema = z.object({
+ *   id: z.number(),
+ *   name: z.string(),
+ *   email: z.string().email()
+ * });
+ *
+ * // Convert to OpenAPI schema
+ * const openAPISchema = zodToOpenAPI(userSchema);
+ * ```
+ */ const zodToOpenAPI = (zodSchema)=>{
+    try {
+        const id = randomUUID();
+        const registry = z.registry();
+        // Add the schema to the local registry with a custom, unique ID
+        registry.add(zodSchema, {
+            id
+        });
+        // Copy the global registry definitions into the local registry to make sure references are resolved
+        // This prevent "__shared" definitions from being created
+        for (const [key, value] of z.globalRegistry._idmap){
+            registry.add(value, {
+                id: key
+            });
+        }
+        // Generate the schemas and only return the one we want, transform the URI path to be OpenAPI compliant
+        const { schemas } = z.toJSONSchema(registry, {
+            uri: toComponentsPath
+        });
+        // TODO: make sure it's compliant
+        return schemas[id];
+    } catch (e) {
+        throw new Error("Couldn't transform the zod schema into an OpenAPI schema");
+    }
+};
+/**
+ * Generates a path string for referencing a component schema by its identifier.
+ *
+ * @param id - The identifier of the component schema.
+ * @returns The constructed path string for the specified component schema.
+ */ const toComponentsPath = (id)=>`#/components/schemas/${id}`;
+
+export { toComponentsPath, zodToOpenAPI };
+//# sourceMappingURL=zod.mjs.map

package/dist/utils/zod.mjs.map

@@ -0,0 +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;;;;;;;;;;;;;;;;;;;;;;;;;;;IA6BaA,MAAAA,YAAAA,GAAe,CAC1BC,SAAAA,GAAAA;IAEA,IAAI;AACF,QAAA,MAAMC,EAAKC,GAAAA,UAAAA,EAAAA;QACX,MAAMC,QAAAA,GAAWC,EAAED,QAAQ,EAAA;;QAG3BA,QAASE,CAAAA,GAAG,CAACL,SAAW,EAAA;AAAEC,YAAAA;AAAG,SAAA,CAAA;;;QAI7B,KAAK,MAAM,CAACK,GAAKC,EAAAA,KAAAA,CAAM,IAAIH,CAAEI,CAAAA,cAAc,CAACC,MAAM,CAAE;YAClDN,QAASE,CAAAA,GAAG,CAACE,KAAO,EAAA;gBAAEN,EAAIK,EAAAA;AAAI,aAAA,CAAA;AAChC;;AAGA,QAAA,MAAM,EAAEI,OAAO,EAAE,GAAGN,CAAEO,CAAAA,YAAY,CAACR,QAAU,EAAA;YAAES,GAAKC,EAAAA;AAAiB,SAAA,CAAA;;QAGrE,OAAOH,OAAO,CAACT,EAAG,CAAA;AACpB,KAAA,CAAE,OAAOa,CAAG,EAAA;AACV,QAAA,MAAM,IAAIC,KAAM,CAAA,0DAAA,CAAA;AAClB;AACF;AAEA;;;;;IAMaF,MAAAA,gBAAAA,GAAmB,CAACZ,EAAAA,GAAe,CAAC,qBAAqB,EAAEA,EAAG,CAAA;;;;"}

package/package.json

@@ -1,11 +1,7 @@
 {
   "name": "@strapi/openapi",
-  "version": "0.0.0",
-  "description": "Strapi OpenAPI Package",
-  "keywords": [
-    "strapi",
-    "openapi"
-  ],
+  "version": "5.21.0",
+  "description": "A tool set to help generate and validate API documentation for Strapi projects",
   "homepage": "https://strapi.io",
   "bugs": {
     "url": "https://github.com/strapi/strapi/issues"
@@ -31,6 +27,16 @@
   "module": "./dist/index.mjs",
   "source": "./src/index.ts",
   "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "source": "./src/index.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
   "files": [
     "dist/"
   ],
@@ -38,18 +44,24 @@
     "build": "run -T npm-run-all clean --parallel build:code build:types",
     "build:code": "run -T  rollup -c",
     "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 .",
-    "test:ts": "run -T tsc --noEmit",
+    "prepublishOnly": "yarn clean && yarn build",
     "test:unit": "run -T jest",
-    "test:unit:watch": "run -T jest --watch",
-    "watch": "run -T  rollup -c -w"
-  },
-  "devDependencies": {
-    "tsconfig": "5.13.0"
+    "test:unit:watch": "run -T jest --watch"
   },
   "engines": {
     "node": ">=18.0.0 <=22.x.x",
     "npm": ">=6.0.0"
+  },
+  "dependencies": {
+    "debug": "4.3.4",
+    "openapi-types": "12.1.3",
+    "zod": "3.25.67"
+  },
+  "devDependencies": {
+    "@strapi/types": "5.21.0",
+    "@types/debug": "^4"
   }
 }