@strapi/utils 5.19.0 → 5.21.0

package/dist/validation/utilities.js

@@ -0,0 +1,123 @@
+'use strict';
+
+/**
+ * @file This file contains utility functions for working with Zod schemas.
+ * It provides functions to modify schemas (e.g., make them optional, readonly, or add default values),
+ * and to safely register and create schemas within Zod's global registry.
+ */ /**
+ * Transforms a Strapi UID into an OpenAPI-compliant component name.
+ *
+ * @param uid - The Strapi UID to transform (e.g., "basic.seo", "api::category.category", "plugin::upload.file")
+ * @returns The OpenAPI-compliant component name (e.g., "BasicSeoEntry", "ApiCategoryCategoryDocument", "PluginUploadFileDocument")
+ */ const transformUidToValidOpenApiName = (uid)=>{
+    const capitalize = (str)=>{
+        return str.charAt(0).toUpperCase() + str.slice(1);
+    };
+    const toPascalCase = (str)=>{
+        return str.split(/[-_]/).map(capitalize).join('');
+    };
+    // Check if it contains double colons (other namespaced UIDs)
+    if (uid.includes('::')) {
+        const [namespace, ...rest] = uid.split('::');
+        const namespacePart = toPascalCase(namespace);
+        const restParts = rest.join('.').split('.').map(toPascalCase).map(capitalize);
+        return `${capitalize(namespacePart)}${restParts.join('')}Document`;
+    }
+    if (uid.includes('.')) {
+        // basic.seo -> BasicSeoEntry
+        const parts = uid.split('.');
+        const transformedParts = parts.map(toPascalCase).map(capitalize);
+        return `${transformedParts.join('')}Entry`;
+    }
+    return `${toPascalCase(capitalize(uid))}Schema`;
+};
+/**
+ * Conditionally makes a Zod schema optional based on the `required` parameter.
+ *
+ * @param required - If `false` or `undefined`, the schema will be made optional. If `true`, the schema becomes non-optional.
+ * @returns A function that takes a Zod schema and returns a modified schema (optional or required).
+ * @example
+ * ```typescript
+ * const optionalString = maybeRequired(false)(z.string()); // z.ZodOptional<z.ZodString>
+ *
+ * const requiredString = maybeRequired(true)(z.string());  // z.ZodString
+ * ```
+ */ const maybeRequired = (required)=>{
+    return (schema)=>{
+        return required !== true ? schema.optional() : schema.nonoptional();
+    };
+};
+/**
+ * Conditionally makes a Zod schema readonly based on the `writable` parameter.
+ *
+ * @param writable - If `false`, the schema will be made readonly. If `true` or `undefined`, the schema remains unchanged.
+ * @returns A function that takes a Zod schema and returns a modified schema (readonly or original).
+ * @example
+ * ```typescript
+ * const readonlyNumber = maybeReadonly(false)(z.number()); // z.ZodReadonly<z.ZodNumber>
+ * const writableNumber = maybeReadonly(true)(z.number());  // z.ZodNumber
+ * ```
+ */ const maybeReadonly = (writable)=>{
+    return (schema)=>writable !== false ? schema : schema.readonly();
+};
+/**
+ * Conditionally adds a default value to a Zod schema based on the `defaultValue` parameter.
+ *
+ * @param defaultValue - The default value to apply to the schema. If `undefined`, no default value is added.
+ *                       If `defaultValue` is a function, its return value will be used as the default.
+ * @returns A function that takes a Zod schema and returns a modified schema (with default or original).
+ * @example
+ * ```typescript
+ * const stringWithDefault = maybeWithDefault("default")(z.string()); // z.ZodDefault<z.ZodString>
+ * const numberWithFunctionDefault = maybeWithDefault(() => Math.random())(z.number());
+ * ```
+ */ const maybeWithDefault = (defaultValue)=>{
+    return (schema)=>{
+        if (defaultValue === undefined) {
+            return schema;
+        }
+        const value = typeof defaultValue === 'function' ? defaultValue() : defaultValue;
+        return schema.default(value);
+    };
+};
+/**
+ * Conditionally applies `min` and `max` constraints to a Zod string, number, or array schema.
+ *
+ * @param min - The minimum value/length. If `undefined`, no minimum constraint is applied.
+ * @param max - The maximum value/length. If `undefined`, no maximum constraint is applied.
+ * @returns A function that takes a Zod string, number, or array schema and returns a modified schema (with min/max constraints or original).
+ * @example
+ * ```typescript
+ * const stringWithMinMax = maybeWithMinMax(5, 10)(z.string()); // z.ZodString with min(5) and max(10)
+ * const numberWithMinMax = maybeWithMinMax(0, 100)(z.number()); // z.ZodNumber with min(0) and max(100)
+ * ```
+ */ const maybeWithMinMax = (min, max)=>{
+    return (schema)=>{
+        return min !== undefined && max !== undefined ? schema.min(min).max(max) : schema;
+    };
+};
+/**
+ * Applies a series of modifier functions to a Zod schema sequentially.
+ *
+ * @template T - The type of the Zod schema.
+ * @param schema - The initial Zod schema to which modifiers will be applied.
+ * @param modifiers - An array of functions, each taking a Zod schema and returning a modified schema.
+ * @returns The final Zod schema after all modifiers have been applied.
+ * @example
+ * ```typescript
+ * const modifiedSchema = augmentSchema(z.string(), [
+ *   maybeRequired(false),
+ *   maybeWithDefault("test")
+ * ]);
+ * ```
+ */ const augmentSchema = (schema, modifiers)=>{
+    return modifiers.reduce((acc, modifier)=>modifier(acc), schema);
+};
+
+exports.augmentSchema = augmentSchema;
+exports.maybeReadonly = maybeReadonly;
+exports.maybeRequired = maybeRequired;
+exports.maybeWithDefault = maybeWithDefault;
+exports.maybeWithMinMax = maybeWithMinMax;
+exports.transformUidToValidOpenApiName = transformUidToValidOpenApiName;
+//# sourceMappingURL=utilities.js.map

package/dist/validation/utilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utilities.js","sources":["../../src/validation/utilities.ts"],"sourcesContent":["/**\n * @file This file contains utility functions for working with Zod schemas.\n * It provides functions to modify schemas (e.g., make them optional, readonly, or add default values),\n * and to safely register and create schemas within Zod's global registry.\n */\n\nimport * as z from 'zod/v4';\n\n/**\n * Transforms a Strapi UID into an OpenAPI-compliant component name.\n *\n * @param uid - The Strapi UID to transform (e.g., \"basic.seo\", \"api::category.category\", \"plugin::upload.file\")\n * @returns The OpenAPI-compliant component name (e.g., \"BasicSeoEntry\", \"ApiCategoryCategoryDocument\", \"PluginUploadFileDocument\")\n */\nexport const transformUidToValidOpenApiName = (uid: string): string => {\n  const capitalize = (str: string): string => {\n    return str.charAt(0).toUpperCase() + str.slice(1);\n  };\n\n  const toPascalCase = (str: string): string => {\n    return str.split(/[-_]/).map(capitalize).join('');\n  };\n\n  // Check if it contains double colons (other namespaced UIDs)\n  if (uid.includes('::')) {\n    const [namespace, ...rest] = uid.split('::');\n    const namespacePart = toPascalCase(namespace);\n    const restParts = rest.join('.').split('.').map(toPascalCase).map(capitalize);\n    return `${capitalize(namespacePart)}${restParts.join('')}Document`;\n  }\n\n  if (uid.includes('.')) {\n    // basic.seo -> BasicSeoEntry\n    const parts = uid.split('.');\n    const transformedParts = parts.map(toPascalCase).map(capitalize);\n    return `${transformedParts.join('')}Entry`;\n  }\n\n  return `${toPascalCase(capitalize(uid))}Schema`;\n};\n\n/**\n * Conditionally makes a Zod schema optional based on the `required` parameter.\n *\n * @param required - If `false` or `undefined`, the schema will be made optional. If `true`, the schema becomes non-optional.\n * @returns A function that takes a Zod schema and returns a modified schema (optional or required).\n * @example\n * ```typescript\n * const optionalString = maybeRequired(false)(z.string()); // z.ZodOptional<z.ZodString>\n *\n * const requiredString = maybeRequired(true)(z.string());  // z.ZodString\n * ```\n */\nexport const maybeRequired = (required?: boolean) => {\n  return <T extends z.Schema>(schema: T) => {\n    return required !== true ? schema.optional() : schema.nonoptional();\n  };\n};\n\n/**\n * Conditionally makes a Zod schema readonly based on the `writable` parameter.\n *\n * @param writable - If `false`, the schema will be made readonly. If `true` or `undefined`, the schema remains unchanged.\n * @returns A function that takes a Zod schema and returns a modified schema (readonly or original).\n * @example\n * ```typescript\n * const readonlyNumber = maybeReadonly(false)(z.number()); // z.ZodReadonly<z.ZodNumber>\n * const writableNumber = maybeReadonly(true)(z.number());  // z.ZodNumber\n * ```\n */\nexport const maybeReadonly = (writable?: boolean) => {\n  return <T extends z.Schema>(schema: T) => (writable !== false ? schema : schema.readonly());\n};\n\n/**\n * Conditionally adds a default value to a Zod schema based on the `defaultValue` parameter.\n *\n * @param defaultValue - The default value to apply to the schema. If `undefined`, no default value is added.\n *                       If `defaultValue` is a function, its return value will be used as the default.\n * @returns A function that takes a Zod schema and returns a modified schema (with default or original).\n * @example\n * ```typescript\n * const stringWithDefault = maybeWithDefault(\"default\")(z.string()); // z.ZodDefault<z.ZodString>\n * const numberWithFunctionDefault = maybeWithDefault(() => Math.random())(z.number());\n * ```\n */\nexport const maybeWithDefault = (defaultValue?: unknown) => {\n  return <T extends z.Schema>(schema: T) => {\n    if (defaultValue === undefined) {\n      return schema;\n    }\n\n    const value = typeof defaultValue === 'function' ? defaultValue() : defaultValue;\n    return schema.default(value);\n  };\n};\n\n/**\n * Conditionally applies `min` and `max` constraints to a Zod string, number, or array schema.\n *\n * @param min - The minimum value/length. If `undefined`, no minimum constraint is applied.\n * @param max - The maximum value/length. If `undefined`, no maximum constraint is applied.\n * @returns A function that takes a Zod string, number, or array schema and returns a modified schema (with min/max constraints or original).\n * @example\n * ```typescript\n * const stringWithMinMax = maybeWithMinMax(5, 10)(z.string()); // z.ZodString with min(5) and max(10)\n * const numberWithMinMax = maybeWithMinMax(0, 100)(z.number()); // z.ZodNumber with min(0) and max(100)\n * ```\n */\nexport const maybeWithMinMax = (min?: number, max?: number) => {\n  return <R extends z.ZodString | z.ZodEmail | z.ZodNumber | z.ZodArray<z.ZodAny>>(schema: R) => {\n    return min !== undefined && max !== undefined ? schema.min(min).max(max) : schema;\n  };\n};\n\n/**\n * Applies a series of modifier functions to a Zod schema sequentially.\n *\n * @template T - The type of the Zod schema.\n * @param schema - The initial Zod schema to which modifiers will be applied.\n * @param modifiers - An array of functions, each taking a Zod schema and returning a modified schema.\n * @returns The final Zod schema after all modifiers have been applied.\n * @example\n * ```typescript\n * const modifiedSchema = augmentSchema(z.string(), [\n *   maybeRequired(false),\n *   maybeWithDefault(\"test\")\n * ]);\n * ```\n */\nexport const augmentSchema = <T extends z.Schema>(\n  schema: T,\n  modifiers: ((schema: T) => z.Schema)[]\n) => {\n  return modifiers.reduce((acc, modifier) => modifier(acc) as T, schema);\n};\n"],"names":["transformUidToValidOpenApiName","uid","capitalize","str","charAt","toUpperCase","slice","toPascalCase","split","map","join","includes","namespace","rest","namespacePart","restParts","parts","transformedParts","maybeRequired","required","schema","optional","nonoptional","maybeReadonly","writable","readonly","maybeWithDefault","defaultValue","undefined","value","default","maybeWithMinMax","min","max","augmentSchema","modifiers","reduce","acc","modifier"],"mappings":"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"}

package/dist/validation/utilities.mjs

@@ -0,0 +1,116 @@
+/**
+ * @file This file contains utility functions for working with Zod schemas.
+ * It provides functions to modify schemas (e.g., make them optional, readonly, or add default values),
+ * and to safely register and create schemas within Zod's global registry.
+ */ /**
+ * Transforms a Strapi UID into an OpenAPI-compliant component name.
+ *
+ * @param uid - The Strapi UID to transform (e.g., "basic.seo", "api::category.category", "plugin::upload.file")
+ * @returns The OpenAPI-compliant component name (e.g., "BasicSeoEntry", "ApiCategoryCategoryDocument", "PluginUploadFileDocument")
+ */ const transformUidToValidOpenApiName = (uid)=>{
+    const capitalize = (str)=>{
+        return str.charAt(0).toUpperCase() + str.slice(1);
+    };
+    const toPascalCase = (str)=>{
+        return str.split(/[-_]/).map(capitalize).join('');
+    };
+    // Check if it contains double colons (other namespaced UIDs)
+    if (uid.includes('::')) {
+        const [namespace, ...rest] = uid.split('::');
+        const namespacePart = toPascalCase(namespace);
+        const restParts = rest.join('.').split('.').map(toPascalCase).map(capitalize);
+        return `${capitalize(namespacePart)}${restParts.join('')}Document`;
+    }
+    if (uid.includes('.')) {
+        // basic.seo -> BasicSeoEntry
+        const parts = uid.split('.');
+        const transformedParts = parts.map(toPascalCase).map(capitalize);
+        return `${transformedParts.join('')}Entry`;
+    }
+    return `${toPascalCase(capitalize(uid))}Schema`;
+};
+/**
+ * Conditionally makes a Zod schema optional based on the `required` parameter.
+ *
+ * @param required - If `false` or `undefined`, the schema will be made optional. If `true`, the schema becomes non-optional.
+ * @returns A function that takes a Zod schema and returns a modified schema (optional or required).
+ * @example
+ * ```typescript
+ * const optionalString = maybeRequired(false)(z.string()); // z.ZodOptional<z.ZodString>
+ *
+ * const requiredString = maybeRequired(true)(z.string());  // z.ZodString
+ * ```
+ */ const maybeRequired = (required)=>{
+    return (schema)=>{
+        return required !== true ? schema.optional() : schema.nonoptional();
+    };
+};
+/**
+ * Conditionally makes a Zod schema readonly based on the `writable` parameter.
+ *
+ * @param writable - If `false`, the schema will be made readonly. If `true` or `undefined`, the schema remains unchanged.
+ * @returns A function that takes a Zod schema and returns a modified schema (readonly or original).
+ * @example
+ * ```typescript
+ * const readonlyNumber = maybeReadonly(false)(z.number()); // z.ZodReadonly<z.ZodNumber>
+ * const writableNumber = maybeReadonly(true)(z.number());  // z.ZodNumber
+ * ```
+ */ const maybeReadonly = (writable)=>{
+    return (schema)=>writable !== false ? schema : schema.readonly();
+};
+/**
+ * Conditionally adds a default value to a Zod schema based on the `defaultValue` parameter.
+ *
+ * @param defaultValue - The default value to apply to the schema. If `undefined`, no default value is added.
+ *                       If `defaultValue` is a function, its return value will be used as the default.
+ * @returns A function that takes a Zod schema and returns a modified schema (with default or original).
+ * @example
+ * ```typescript
+ * const stringWithDefault = maybeWithDefault("default")(z.string()); // z.ZodDefault<z.ZodString>
+ * const numberWithFunctionDefault = maybeWithDefault(() => Math.random())(z.number());
+ * ```
+ */ const maybeWithDefault = (defaultValue)=>{
+    return (schema)=>{
+        if (defaultValue === undefined) {
+            return schema;
+        }
+        const value = typeof defaultValue === 'function' ? defaultValue() : defaultValue;
+        return schema.default(value);
+    };
+};
+/**
+ * Conditionally applies `min` and `max` constraints to a Zod string, number, or array schema.
+ *
+ * @param min - The minimum value/length. If `undefined`, no minimum constraint is applied.
+ * @param max - The maximum value/length. If `undefined`, no maximum constraint is applied.
+ * @returns A function that takes a Zod string, number, or array schema and returns a modified schema (with min/max constraints or original).
+ * @example
+ * ```typescript
+ * const stringWithMinMax = maybeWithMinMax(5, 10)(z.string()); // z.ZodString with min(5) and max(10)
+ * const numberWithMinMax = maybeWithMinMax(0, 100)(z.number()); // z.ZodNumber with min(0) and max(100)
+ * ```
+ */ const maybeWithMinMax = (min, max)=>{
+    return (schema)=>{
+        return min !== undefined && max !== undefined ? schema.min(min).max(max) : schema;
+    };
+};
+/**
+ * Applies a series of modifier functions to a Zod schema sequentially.
+ *
+ * @template T - The type of the Zod schema.
+ * @param schema - The initial Zod schema to which modifiers will be applied.
+ * @param modifiers - An array of functions, each taking a Zod schema and returning a modified schema.
+ * @returns The final Zod schema after all modifiers have been applied.
+ * @example
+ * ```typescript
+ * const modifiedSchema = augmentSchema(z.string(), [
+ *   maybeRequired(false),
+ *   maybeWithDefault("test")
+ * ]);
+ * ```
+ */ const augmentSchema = (schema, modifiers)=>{
+    return modifiers.reduce((acc, modifier)=>modifier(acc), schema);
+};
+
+export { augmentSchema, maybeReadonly, maybeRequired, maybeWithDefault, maybeWithMinMax, transformUidToValidOpenApiName };
+//# sourceMappingURL=utilities.mjs.map

package/dist/validation/utilities.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"utilities.mjs","sources":["../../src/validation/utilities.ts"],"sourcesContent":["/**\n * @file This file contains utility functions for working with Zod schemas.\n * It provides functions to modify schemas (e.g., make them optional, readonly, or add default values),\n * and to safely register and create schemas within Zod's global registry.\n */\n\nimport * as z from 'zod/v4';\n\n/**\n * Transforms a Strapi UID into an OpenAPI-compliant component name.\n *\n * @param uid - The Strapi UID to transform (e.g., \"basic.seo\", \"api::category.category\", \"plugin::upload.file\")\n * @returns The OpenAPI-compliant component name (e.g., \"BasicSeoEntry\", \"ApiCategoryCategoryDocument\", \"PluginUploadFileDocument\")\n */\nexport const transformUidToValidOpenApiName = (uid: string): string => {\n  const capitalize = (str: string): string => {\n    return str.charAt(0).toUpperCase() + str.slice(1);\n  };\n\n  const toPascalCase = (str: string): string => {\n    return str.split(/[-_]/).map(capitalize).join('');\n  };\n\n  // Check if it contains double colons (other namespaced UIDs)\n  if (uid.includes('::')) {\n    const [namespace, ...rest] = uid.split('::');\n    const namespacePart = toPascalCase(namespace);\n    const restParts = rest.join('.').split('.').map(toPascalCase).map(capitalize);\n    return `${capitalize(namespacePart)}${restParts.join('')}Document`;\n  }\n\n  if (uid.includes('.')) {\n    // basic.seo -> BasicSeoEntry\n    const parts = uid.split('.');\n    const transformedParts = parts.map(toPascalCase).map(capitalize);\n    return `${transformedParts.join('')}Entry`;\n  }\n\n  return `${toPascalCase(capitalize(uid))}Schema`;\n};\n\n/**\n * Conditionally makes a Zod schema optional based on the `required` parameter.\n *\n * @param required - If `false` or `undefined`, the schema will be made optional. If `true`, the schema becomes non-optional.\n * @returns A function that takes a Zod schema and returns a modified schema (optional or required).\n * @example\n * ```typescript\n * const optionalString = maybeRequired(false)(z.string()); // z.ZodOptional<z.ZodString>\n *\n * const requiredString = maybeRequired(true)(z.string());  // z.ZodString\n * ```\n */\nexport const maybeRequired = (required?: boolean) => {\n  return <T extends z.Schema>(schema: T) => {\n    return required !== true ? schema.optional() : schema.nonoptional();\n  };\n};\n\n/**\n * Conditionally makes a Zod schema readonly based on the `writable` parameter.\n *\n * @param writable - If `false`, the schema will be made readonly. If `true` or `undefined`, the schema remains unchanged.\n * @returns A function that takes a Zod schema and returns a modified schema (readonly or original).\n * @example\n * ```typescript\n * const readonlyNumber = maybeReadonly(false)(z.number()); // z.ZodReadonly<z.ZodNumber>\n * const writableNumber = maybeReadonly(true)(z.number());  // z.ZodNumber\n * ```\n */\nexport const maybeReadonly = (writable?: boolean) => {\n  return <T extends z.Schema>(schema: T) => (writable !== false ? schema : schema.readonly());\n};\n\n/**\n * Conditionally adds a default value to a Zod schema based on the `defaultValue` parameter.\n *\n * @param defaultValue - The default value to apply to the schema. If `undefined`, no default value is added.\n *                       If `defaultValue` is a function, its return value will be used as the default.\n * @returns A function that takes a Zod schema and returns a modified schema (with default or original).\n * @example\n * ```typescript\n * const stringWithDefault = maybeWithDefault(\"default\")(z.string()); // z.ZodDefault<z.ZodString>\n * const numberWithFunctionDefault = maybeWithDefault(() => Math.random())(z.number());\n * ```\n */\nexport const maybeWithDefault = (defaultValue?: unknown) => {\n  return <T extends z.Schema>(schema: T) => {\n    if (defaultValue === undefined) {\n      return schema;\n    }\n\n    const value = typeof defaultValue === 'function' ? defaultValue() : defaultValue;\n    return schema.default(value);\n  };\n};\n\n/**\n * Conditionally applies `min` and `max` constraints to a Zod string, number, or array schema.\n *\n * @param min - The minimum value/length. If `undefined`, no minimum constraint is applied.\n * @param max - The maximum value/length. If `undefined`, no maximum constraint is applied.\n * @returns A function that takes a Zod string, number, or array schema and returns a modified schema (with min/max constraints or original).\n * @example\n * ```typescript\n * const stringWithMinMax = maybeWithMinMax(5, 10)(z.string()); // z.ZodString with min(5) and max(10)\n * const numberWithMinMax = maybeWithMinMax(0, 100)(z.number()); // z.ZodNumber with min(0) and max(100)\n * ```\n */\nexport const maybeWithMinMax = (min?: number, max?: number) => {\n  return <R extends z.ZodString | z.ZodEmail | z.ZodNumber | z.ZodArray<z.ZodAny>>(schema: R) => {\n    return min !== undefined && max !== undefined ? schema.min(min).max(max) : schema;\n  };\n};\n\n/**\n * Applies a series of modifier functions to a Zod schema sequentially.\n *\n * @template T - The type of the Zod schema.\n * @param schema - The initial Zod schema to which modifiers will be applied.\n * @param modifiers - An array of functions, each taking a Zod schema and returning a modified schema.\n * @returns The final Zod schema after all modifiers have been applied.\n * @example\n * ```typescript\n * const modifiedSchema = augmentSchema(z.string(), [\n *   maybeRequired(false),\n *   maybeWithDefault(\"test\")\n * ]);\n * ```\n */\nexport const augmentSchema = <T extends z.Schema>(\n  schema: T,\n  modifiers: ((schema: T) => z.Schema)[]\n) => {\n  return modifiers.reduce((acc, modifier) => modifier(acc) as T, schema);\n};\n"],"names":["transformUidToValidOpenApiName","uid","capitalize","str","charAt","toUpperCase","slice","toPascalCase","split","map","join","includes","namespace","rest","namespacePart","restParts","parts","transformedParts","maybeRequired","required","schema","optional","nonoptional","maybeReadonly","writable","readonly","maybeWithDefault","defaultValue","undefined","value","default","maybeWithMinMax","min","max","augmentSchema","modifiers","reduce","acc","modifier"],"mappings":"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"}

package/dist/zod.js

@@ -17,11 +17,11 @@ const validateZod = (schema)=>(data)=>{
         }
     };
 const formatZodErrors = (zodError)=>({
-        errors: zodError.format((issue)=>{
+        errors: zodError.issues.map((issue)=>{
             return {
                 path: issue.path,
                 message: issue.message,
-                name: issue.code
+                name: 'ValidationError'
             };
         }),
         message: 'Validation error'

package/dist/zod.js.map

@@ -1 +1 @@
-{"version":3,"file":"zod.js","sources":["../src/zod.ts"],"sourcesContent":["import { z } from 'zod';\n\nimport { ValidationError } from './errors';\n\nexport const validateZod =\n  <T extends z.ZodTypeAny>(schema: T) =>\n  (data: unknown): z.TypeOf<T> => {\n    try {\n      return schema.parse(data);\n    } catch (error) {\n      if (error instanceof z.ZodError) {\n        const { message, errors } = formatZodErrors(error);\n        throw new ValidationError(message, { errors });\n      }\n\n      throw error;\n    }\n  };\n\nconst formatZodErrors = (zodError: z.ZodError) => ({\n  errors: zodError.format((issue) => {\n    return {\n      path: issue.path,\n      message: issue.message,\n      name: issue.code,\n    };\n  }),\n  message: 'Validation error',\n});\n"],"names":["validateZod","schema","data","parse","error","z","ZodError","message","errors","formatZodErrors","ValidationError","zodError","format","issue","path","name","code"],"mappings":";;;;;AAIaA,MAAAA,WAAAA,GACX,CAAyBC,MAAAA,GACzB,CAACC,IAAAA,GAAAA;QACC,IAAI;YACF,OAAOD,MAAAA,CAAOE,KAAK,CAACD,IAAAA,CAAAA;AACtB,SAAA,CAAE,OAAOE,KAAO,EAAA;YACd,IAAIA,KAAAA,YAAiBC,KAAEC,CAAAA,QAAQ,EAAE;AAC/B,gBAAA,MAAM,EAAEC,OAAO,UAAEC,QAAM,EAAE,GAAGC,eAAgBL,CAAAA,KAAAA,CAAAA;gBAC5C,MAAM,IAAIM,uBAAgBH,OAAS,EAAA;AAAEC,4BAAAA;AAAO,iBAAA,CAAA;AAC9C;YAEA,MAAMJ,KAAAA;AACR;;AAGJ,MAAMK,eAAAA,GAAkB,CAACE,QAAAA,IAA0B;QACjDH,MAAQG,EAAAA,QAAAA,CAASC,MAAM,CAAC,CAACC,KAAAA,GAAAA;YACvB,OAAO;AACLC,gBAAAA,IAAAA,EAAMD,MAAMC,IAAI;AAChBP,gBAAAA,OAAAA,EAASM,MAAMN,OAAO;AACtBQ,gBAAAA,IAAAA,EAAMF,MAAMG;AACd,aAAA;AACF,SAAA,CAAA;QACAT,OAAS,EAAA;KACX,CAAA;;;;"}
+{"version":3,"file":"zod.js","sources":["../src/zod.ts"],"sourcesContent":["import { z } from 'zod';\n\nimport { ValidationError } from './errors';\n\nexport const validateZod =\n  <T extends z.ZodTypeAny>(schema: T) =>\n  (data: unknown): z.TypeOf<T> => {\n    try {\n      return schema.parse(data);\n    } catch (error) {\n      if (error instanceof z.ZodError) {\n        const { message, errors } = formatZodErrors(error);\n        throw new ValidationError(message, { errors });\n      }\n\n      throw error;\n    }\n  };\n\nconst formatZodErrors = (zodError: z.ZodError) => ({\n  errors: zodError.issues.map((issue) => {\n    return {\n      path: issue.path,\n      message: issue.message,\n      name: 'ValidationError',\n    };\n  }),\n  message: 'Validation error',\n});\n"],"names":["validateZod","schema","data","parse","error","z","ZodError","message","errors","formatZodErrors","ValidationError","zodError","issues","map","issue","path","name"],"mappings":";;;;;AAIaA,MAAAA,WAAAA,GACX,CAAyBC,MAAAA,GACzB,CAACC,IAAAA,GAAAA;QACC,IAAI;YACF,OAAOD,MAAAA,CAAOE,KAAK,CAACD,IAAAA,CAAAA;AACtB,SAAA,CAAE,OAAOE,KAAO,EAAA;YACd,IAAIA,KAAAA,YAAiBC,KAAEC,CAAAA,QAAQ,EAAE;AAC/B,gBAAA,MAAM,EAAEC,OAAO,UAAEC,QAAM,EAAE,GAAGC,eAAgBL,CAAAA,KAAAA,CAAAA;gBAC5C,MAAM,IAAIM,uBAAgBH,OAAS,EAAA;AAAEC,4BAAAA;AAAO,iBAAA,CAAA;AAC9C;YAEA,MAAMJ,KAAAA;AACR;;AAGJ,MAAMK,eAAAA,GAAkB,CAACE,QAAAA,IAA0B;AACjDH,QAAAA,MAAAA,EAAQG,QAASC,CAAAA,MAAM,CAACC,GAAG,CAAC,CAACC,KAAAA,GAAAA;YAC3B,OAAO;AACLC,gBAAAA,IAAAA,EAAMD,MAAMC,IAAI;AAChBR,gBAAAA,OAAAA,EAASO,MAAMP,OAAO;gBACtBS,IAAM,EAAA;AACR,aAAA;AACF,SAAA,CAAA;QACAT,OAAS,EAAA;KACX,CAAA;;;;"}

package/dist/zod.mjs

@@ -15,11 +15,11 @@ const validateZod = (schema)=>(data)=>{
         }
     };
 const formatZodErrors = (zodError)=>({
-        errors: zodError.format((issue)=>{
+        errors: zodError.issues.map((issue)=>{
             return {
                 path: issue.path,
                 message: issue.message,
-                name: issue.code
+                name: 'ValidationError'
             };
         }),
         message: 'Validation error'

package/dist/zod.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"zod.mjs","sources":["../src/zod.ts"],"sourcesContent":["import { z } from 'zod';\n\nimport { ValidationError } from './errors';\n\nexport const validateZod =\n  <T extends z.ZodTypeAny>(schema: T) =>\n  (data: unknown): z.TypeOf<T> => {\n    try {\n      return schema.parse(data);\n    } catch (error) {\n      if (error instanceof z.ZodError) {\n        const { message, errors } = formatZodErrors(error);\n        throw new ValidationError(message, { errors });\n      }\n\n      throw error;\n    }\n  };\n\nconst formatZodErrors = (zodError: z.ZodError) => ({\n  errors: zodError.format((issue) => {\n    return {\n      path: issue.path,\n      message: issue.message,\n      name: issue.code,\n    };\n  }),\n  message: 'Validation error',\n});\n"],"names":["validateZod","schema","data","parse","error","z","ZodError","message","errors","formatZodErrors","ValidationError","zodError","format","issue","path","name","code"],"mappings":";;;AAIaA,MAAAA,WAAAA,GACX,CAAyBC,MAAAA,GACzB,CAACC,IAAAA,GAAAA;QACC,IAAI;YACF,OAAOD,MAAAA,CAAOE,KAAK,CAACD,IAAAA,CAAAA;AACtB,SAAA,CAAE,OAAOE,KAAO,EAAA;YACd,IAAIA,KAAAA,YAAiBC,CAAEC,CAAAA,QAAQ,EAAE;AAC/B,gBAAA,MAAM,EAAEC,OAAO,EAAEC,MAAM,EAAE,GAAGC,eAAgBL,CAAAA,KAAAA,CAAAA;gBAC5C,MAAM,IAAIM,gBAAgBH,OAAS,EAAA;AAAEC,oBAAAA;AAAO,iBAAA,CAAA;AAC9C;YAEA,MAAMJ,KAAAA;AACR;;AAGJ,MAAMK,eAAAA,GAAkB,CAACE,QAAAA,IAA0B;QACjDH,MAAQG,EAAAA,QAAAA,CAASC,MAAM,CAAC,CAACC,KAAAA,GAAAA;YACvB,OAAO;AACLC,gBAAAA,IAAAA,EAAMD,MAAMC,IAAI;AAChBP,gBAAAA,OAAAA,EAASM,MAAMN,OAAO;AACtBQ,gBAAAA,IAAAA,EAAMF,MAAMG;AACd,aAAA;AACF,SAAA,CAAA;QACAT,OAAS,EAAA;KACX,CAAA;;;;"}
+{"version":3,"file":"zod.mjs","sources":["../src/zod.ts"],"sourcesContent":["import { z } from 'zod';\n\nimport { ValidationError } from './errors';\n\nexport const validateZod =\n  <T extends z.ZodTypeAny>(schema: T) =>\n  (data: unknown): z.TypeOf<T> => {\n    try {\n      return schema.parse(data);\n    } catch (error) {\n      if (error instanceof z.ZodError) {\n        const { message, errors } = formatZodErrors(error);\n        throw new ValidationError(message, { errors });\n      }\n\n      throw error;\n    }\n  };\n\nconst formatZodErrors = (zodError: z.ZodError) => ({\n  errors: zodError.issues.map((issue) => {\n    return {\n      path: issue.path,\n      message: issue.message,\n      name: 'ValidationError',\n    };\n  }),\n  message: 'Validation error',\n});\n"],"names":["validateZod","schema","data","parse","error","z","ZodError","message","errors","formatZodErrors","ValidationError","zodError","issues","map","issue","path","name"],"mappings":";;;AAIaA,MAAAA,WAAAA,GACX,CAAyBC,MAAAA,GACzB,CAACC,IAAAA,GAAAA;QACC,IAAI;YACF,OAAOD,MAAAA,CAAOE,KAAK,CAACD,IAAAA,CAAAA;AACtB,SAAA,CAAE,OAAOE,KAAO,EAAA;YACd,IAAIA,KAAAA,YAAiBC,CAAEC,CAAAA,QAAQ,EAAE;AAC/B,gBAAA,MAAM,EAAEC,OAAO,EAAEC,MAAM,EAAE,GAAGC,eAAgBL,CAAAA,KAAAA,CAAAA;gBAC5C,MAAM,IAAIM,gBAAgBH,OAAS,EAAA;AAAEC,oBAAAA;AAAO,iBAAA,CAAA;AAC9C;YAEA,MAAMJ,KAAAA;AACR;;AAGJ,MAAMK,eAAAA,GAAkB,CAACE,QAAAA,IAA0B;AACjDH,QAAAA,MAAAA,EAAQG,QAASC,CAAAA,MAAM,CAACC,GAAG,CAAC,CAACC,KAAAA,GAAAA;YAC3B,OAAO;AACLC,gBAAAA,IAAAA,EAAMD,MAAMC,IAAI;AAChBR,gBAAAA,OAAAA,EAASO,MAAMP,OAAO;gBACtBS,IAAM,EAAA;AACR,aAAA;AACF,SAAA,CAAA;QACAT,OAAS,EAAA;KACX,CAAA;;;;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@strapi/utils",
-  "version": "5.19.0",
+  "version": "5.21.0",
   "description": "Shared utilities for the Strapi packages",
   "keywords": [
     "strapi",
@@ -55,16 +55,16 @@
     "p-map": "4.0.0",
     "preferred-pm": "3.1.2",
     "yup": "0.32.9",
-    "zod": "3.24.2"
+    "zod": "3.25.67"
   },
   "devDependencies": {
     "@types/http-errors": "2.0.4",
     "@types/koa": "2.13.4",
     "@types/node": "18.19.24",
-    "eslint-config-custom": "5.19.0",
+    "eslint-config-custom": "5.21.0",
     "koa": "2.16.1",
     "koa-body": "6.0.1",
-    "tsconfig": "5.19.0"
+    "tsconfig": "5.21.0"
   },
   "engines": {
     "node": ">=18.0.0 <=22.x.x",