@strapi/core 0.0.0-experimental.25e22c6cc9bc6b35392bb55d09f641a0a65e7403 → 0.0.0-experimental.25f7de53c1fc990bbb86d4aa43c379acfa838064

package/dist/core-api/routes/validation/common.d.ts

@@ -0,0 +1,135 @@
+import { type Core, Schema, type UID } from '@strapi/types';
+import { z } from 'zod';
+/**
+ * AbstractCoreRouteValidator provides the foundation for validating and managing core routes within a Strapi context for a specific model.
+ *
+ * This abstract class facilitates validation logic for scalar and populatable fields defined in a model schema.
+ *
+ * It uses runtime information about Strapi models to derive and expose schema validations.
+ *
+ * @template {UID.Schema} T Representing the schema identifier to be validated.
+ */
+export declare abstract class AbstractCoreRouteValidator<T extends UID.Schema> {
+    /**
+     * The `_strapi` variable serves as a reference to the core Strapi instance.
+     * It is used for interacting with the loaded model.
+     */
+    protected readonly _strapi: Core.Strapi;
+    /**
+     * A unique identifier used to represent a model within Strapi.
+     *
+     * The type of the identifier is generic to allow flexibility and ensure type safety
+     * when working with either content-types or components.
+     */
+    protected readonly _uid: T;
+    /**
+     * Protected constructor for initializing the class with the provided Strapi instance and unique identifier (UID).
+     *
+     * @param strapi The Strapi instance to be used.
+     * @param uid The unique identifier for the instance.
+     */
+    protected constructor(strapi: Core.Strapi, uid: T);
+    /**
+     * Retrieves an enum schema constructed from the keys of the scalar fields.
+     *
+     * @return A Zod enum containing the keys from the scalar fields.
+     */
+    get scalarFieldsEnum(): z.ZodEnum<[string]>;
+    /**
+     * Retrieves an enum schema constructed from the keys of fields that can be populated (relations, components, files, etc.)
+     *
+     * @return A ZodEnum object containing the list of populatable field keys.
+     */
+    get populatableFieldsEnum(): z.ZodEnum<[string]>;
+    /**
+     * Retrieves an array representation of the scalar fields.
+     *
+     * @return An array containing the scalar fields as defined by {@link scalarFieldsEnum}.
+     */
+    get scalarFieldsArray(): z.ZodArray<z.ZodEnum<[string]>, "many">;
+    /**
+     * Retrieves an array of populatable fields.
+     *
+     * @return A Zod array schema representing the available populatable fields as defined by {@link populatableFieldsEnum}.
+     */
+    get populatableFieldsArray(): z.ZodArray<z.ZodEnum<[string]>, "many">;
+    /**
+     * Retrieves the schema associated with the current model.
+     *
+     * The schema represents the structural definition of the model,
+     * as retrieved from the Strapi model associated with the given UID.
+     *
+     * @return The schema of the model retrieved from Strapi.
+     */
+    protected get _schema(): T extends UID.ContentType ? Schema.ContentType<T> : T extends `${string}.${string}` ? Schema.Component<T> : never;
+    /**
+     * Retrieves scalar fields from the object's schema attributes.
+     *
+     * Filters the schema attributes to include only those that are scalar and not private.
+     *
+     * @return An object composed of scalar fields from the schema attributes.
+     */
+    protected get _scalarFields(): {
+        [k: string]: Schema.Attribute.AnyAttribute;
+    };
+    /**
+     * Retrieves the populatable fields from the schema attributes.
+     *
+     * Filters the schema attributes to include only those that are populatable and not private.
+     *
+     * @return An object containing the populatable fields derived from the schema attributes.
+     */
+    protected get _populatableFields(): {
+        [k: string]: Schema.Attribute.AnyAttribute;
+    };
+    /**
+     * Creates a Zod schema as a record with scalar fields as keys and the specified type as values.
+     *
+     * @param type - The Zod type to use for the record's values.
+     * @return A Zod record schema with scalar fields as keys and the specified type as values.
+     */
+    fieldRecord(type: z.ZodTypeAny): z.ZodRecord<z.ZodEnum<[string]>, z.ZodTypeAny>;
+}
+/**
+ * Maps a Strapi attribute definition to a corresponding Zod validation schema.
+ * This function handles various Strapi attribute types and converts them into
+ * appropriate Zod validation schemas with their respective constraints.
+ *
+ * @param attribute - The Strapi attribute configuration object. Contains type information
+ *                   and validation rules for the attribute.
+ *
+ * @returns A Zod schema that corresponds to the input attribute's type and validation rules
+ *
+ * @example
+ * ```typescript
+ * // String attribute with constraints
+ * const stringAttribute = {
+ *   type: 'string',
+ *   minLength: 3,
+ *   maxLength: 50,
+ *   required: true
+ * };
+ * const stringSchema = mapAttributeToSchema(stringAttribute);
+ *
+ * // Enumeration attribute
+ * const enumAttribute = {
+ *   type: 'enumeration',
+ *   enum: ['draft', 'published', 'archived']
+ * };
+ * const enumSchema = mapAttributeToSchema(enumAttribute);
+ *
+ * // Media attribute with multiple files
+ * const mediaAttribute = {
+ *   type: 'media',
+ *   multiple: true
+ * };
+ * const mediaSchema = mapAttributeToSchema(mediaAttribute);
+ * ```
+ *
+ * @throws {Error} Throws an error if an unsupported attribute type is provided
+ *
+ * @remarks
+ * - Complex types (component, relation, dynamic zone) use placeholder schemas
+ */
+export declare const mapAttributeToSchema: (attribute: Schema.Attribute.AnyAttribute) => z.Schema;
+//# sourceMappingURL=common.d.ts.map

package/dist/core-api/routes/validation/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../../src/core-api/routes/validation/common.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,EAAE,KAAK,GAAG,EAAE,MAAM,eAAe,CAAC;AAE5D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;GAQG;AACH,8BAAsB,0BAA0B,CAAC,CAAC,SAAS,GAAG,CAAC,MAAM;IACnE;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC;IAExC;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IAE3B;;;;;OAKG;IACH,SAAS,aAAa,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC;IAKjD;;;;OAIG;IACH,IAAW,gBAAgB,wBAE1B;IAED;;;;OAIG;IACH,IAAW,qBAAqB,wBAE/B;IAED;;;;OAIG;IACH,IAAW,iBAAiB,4CAE3B;IAED;;;;OAIG;IACH,IAAW,sBAAsB,4CAEhC;IAED;;;;;;;OAOG;IACH,SAAS,KAAK,OAAO,sHAEpB;IAED;;;;;;OAMG;IACH,SAAS,KAAK,aAAa;;MAQ1B;IAED;;;;;;OAMG;IACH,SAAS,KAAK,kBAAkB;;MAQ/B;IAED;;;;;OAKG;IACI,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,UAAU;CAGtC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,eAAO,MAAM,oBAAoB,cAAe,OAAO,SAAS,CAAC,YAAY,KAAG,EAAE,MAqEjF,CAAC"}

package/dist/core-api/routes/validation/common.js

@@ -0,0 +1,201 @@
+'use strict';
+
+var strapiUtils = require('@strapi/utils');
+var zod = require('zod');
+
+/**
+ * AbstractCoreRouteValidator provides the foundation for validating and managing core routes within a Strapi context for a specific model.
+ *
+ * This abstract class facilitates validation logic for scalar and populatable fields defined in a model schema.
+ *
+ * It uses runtime information about Strapi models to derive and expose schema validations.
+ *
+ * @template {UID.Schema} T Representing the schema identifier to be validated.
+ */ class AbstractCoreRouteValidator {
+    /**
+   * Retrieves an enum schema constructed from the keys of the scalar fields.
+   *
+   * @return A Zod enum containing the keys from the scalar fields.
+   */ get scalarFieldsEnum() {
+        return zod.z.enum(Object.keys(this._scalarFields));
+    }
+    /**
+   * Retrieves an enum schema constructed from the keys of fields that can be populated (relations, components, files, etc.)
+   *
+   * @return A ZodEnum object containing the list of populatable field keys.
+   */ get populatableFieldsEnum() {
+        return zod.z.enum(Object.keys(this._populatableFields));
+    }
+    /**
+   * Retrieves an array representation of the scalar fields.
+   *
+   * @return An array containing the scalar fields as defined by {@link scalarFieldsEnum}.
+   */ get scalarFieldsArray() {
+        return zod.z.array(this.scalarFieldsEnum);
+    }
+    /**
+   * Retrieves an array of populatable fields.
+   *
+   * @return A Zod array schema representing the available populatable fields as defined by {@link populatableFieldsEnum}.
+   */ get populatableFieldsArray() {
+        return zod.z.array(this.populatableFieldsEnum);
+    }
+    /**
+   * Retrieves the schema associated with the current model.
+   *
+   * The schema represents the structural definition of the model,
+   * as retrieved from the Strapi model associated with the given UID.
+   *
+   * @return The schema of the model retrieved from Strapi.
+   */ get _schema() {
+        return this._strapi.getModel(this._uid);
+    }
+    /**
+   * Retrieves scalar fields from the object's schema attributes.
+   *
+   * Filters the schema attributes to include only those that are scalar and not private.
+   *
+   * @return An object composed of scalar fields from the schema attributes.
+   */ get _scalarFields() {
+        const attributes = Object.entries(this._schema.attributes);
+        const scalarEntries = attributes.filter(([, attribute])=>strapiUtils.contentTypes.isScalarAttribute(attribute)).filter(([attributeName])=>!strapiUtils.contentTypes.isPrivateAttribute(this._schema, attributeName));
+        return Object.fromEntries(scalarEntries);
+    }
+    /**
+   * Retrieves the populatable fields from the schema attributes.
+   *
+   * Filters the schema attributes to include only those that are populatable and not private.
+   *
+   * @return An object containing the populatable fields derived from the schema attributes.
+   */ get _populatableFields() {
+        const attributes = Object.entries(this._schema.attributes);
+        const populatableEntries = attributes.filter(([, attribute])=>!strapiUtils.contentTypes.isScalarAttribute(attribute)).filter(([attributeName])=>!strapiUtils.contentTypes.isPrivateAttribute(this._schema, attributeName));
+        return Object.fromEntries(populatableEntries);
+    }
+    /**
+   * Creates a Zod schema as a record with scalar fields as keys and the specified type as values.
+   *
+   * @param type - The Zod type to use for the record's values.
+   * @return A Zod record schema with scalar fields as keys and the specified type as values.
+   */ fieldRecord(type) {
+        return zod.z.record(this.scalarFieldsEnum, type);
+    }
+    /**
+   * Protected constructor for initializing the class with the provided Strapi instance and unique identifier (UID).
+   *
+   * @param strapi The Strapi instance to be used.
+   * @param uid The unique identifier for the instance.
+   */ constructor(strapi, uid){
+        this._strapi = strapi;
+        this._uid = uid;
+    }
+}
+/**
+ * Maps a Strapi attribute definition to a corresponding Zod validation schema.
+ * This function handles various Strapi attribute types and converts them into
+ * appropriate Zod validation schemas with their respective constraints.
+ *
+ * @param attribute - The Strapi attribute configuration object. Contains type information
+ *                   and validation rules for the attribute.
+ *
+ * @returns A Zod schema that corresponds to the input attribute's type and validation rules
+ *
+ * @example
+ * ```typescript
+ * // String attribute with constraints
+ * const stringAttribute = {
+ *   type: 'string',
+ *   minLength: 3,
+ *   maxLength: 50,
+ *   required: true
+ * };
+ * const stringSchema = mapAttributeToSchema(stringAttribute);
+ *
+ * // Enumeration attribute
+ * const enumAttribute = {
+ *   type: 'enumeration',
+ *   enum: ['draft', 'published', 'archived']
+ * };
+ * const enumSchema = mapAttributeToSchema(enumAttribute);
+ *
+ * // Media attribute with multiple files
+ * const mediaAttribute = {
+ *   type: 'media',
+ *   multiple: true
+ * };
+ * const mediaSchema = mapAttributeToSchema(mediaAttribute);
+ * ```
+ *
+ * @throws {Error} Throws an error if an unsupported attribute type is provided
+ *
+ * @remarks
+ * - Complex types (component, relation, dynamic zone) use placeholder schemas
+ */ const mapAttributeToSchema = (attribute)=>{
+    switch(attribute.type){
+        case 'string':
+        case 'text':
+        case 'richtext':
+            {
+                const { minLength, maxLength, required, default: def } = attribute;
+                return [
+                    zod.z.string()
+                ].map((schema)=>minLength !== undefined ? schema.min(minLength) : schema).map((schema)=>maxLength !== undefined ? schema.max(maxLength) : schema).map((schema)=>required ? schema : schema.optional()).map((schema)=>{
+                    if (typeof def === 'undefined') {
+                        return schema;
+                    }
+                    // Needed to infer the type and target the correct schema.default() version
+                    return typeof def === 'function' ? schema.default(def) : schema.default(def);
+                })[0];
+            }
+        case 'blocks':
+            return zod.z.string();
+        case 'float':
+            return zod.z.number().describe(`A float field`);
+        case 'decimal':
+            return zod.z.number().describe(`A decimal field`);
+        case 'biginteger':
+            return zod.z.number().describe(`A biginteger field`);
+        case 'integer':
+            return zod.z.number().int().describe(`An integer field`);
+        case 'boolean':
+            return zod.z.boolean().describe(`A boolean field`);
+        case 'date':
+        case 'datetime':
+        case 'timestamp':
+        case 'time':
+            return zod.z.string().datetime().describe(`A date field`);
+        case 'email':
+            return zod.z.string().email().describe(`An email field`);
+        case 'enumeration':
+            return zod.z.enum(attribute.enum).describe(`An enumeration field with possible values: ${attribute.enum.join(', ')}`);
+        case 'component':
+            {
+                const schema = zod.z.any().describe('imagine this is a component');
+                return attribute.repeatable ? zod.z.array(schema) : schema.nullable();
+            }
+        case 'relation':
+            {
+                const schema = zod.z.any().describe(`A related document`);
+                return strapiUtils.relations.isAnyToMany(attribute) ? zod.z.array(schema) : schema.nullable();
+            }
+        case 'dynamiczone':
+            return zod.z.array(zod.z.any()).describe('Imagine this is a dynamic zone').nullable();
+        case 'json':
+            return zod.z.any().describe(`A JSON field`);
+        case 'uid':
+            return zod.z.string().describe(`A unique identifier (UID) field`);
+        case 'password':
+            return zod.z.string().describe(`A password field`);
+        case 'media':
+            {
+                const schema = zod.z.any().describe(`A media field`);
+                return attribute.multiple ? zod.z.array(schema) : schema.nullable();
+            }
+        default:
+            throw new Error(`Unsupported attribute type: ${attribute['type']}`);
+    }
+};
+
+exports.AbstractCoreRouteValidator = AbstractCoreRouteValidator;
+exports.mapAttributeToSchema = mapAttributeToSchema;
+//# sourceMappingURL=common.js.map

package/dist/core-api/routes/validation/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sources":["../../../../src/core-api/routes/validation/common.ts"],"sourcesContent":["import { type Core, Schema, type UID } from '@strapi/types';\nimport { contentTypes, relations } from '@strapi/utils';\nimport { z } from 'zod';\n\n/**\n * AbstractCoreRouteValidator provides the foundation for validating and managing core routes within a Strapi context for a specific model.\n *\n * This abstract class facilitates validation logic for scalar and populatable fields defined in a model schema.\n *\n * It uses runtime information about Strapi models to derive and expose schema validations.\n *\n * @template {UID.Schema} T Representing the schema identifier to be validated.\n */\nexport abstract class AbstractCoreRouteValidator<T extends UID.Schema> {\n  /**\n   * The `_strapi` variable serves as a reference to the core Strapi instance.\n   * It is used for interacting with the loaded model.\n   */\n  protected readonly _strapi: Core.Strapi;\n\n  /**\n   * A unique identifier used to represent a model within Strapi.\n   *\n   * The type of the identifier is generic to allow flexibility and ensure type safety\n   * when working with either content-types or components.\n   */\n  protected readonly _uid: T;\n\n  /**\n   * Protected constructor for initializing the class with the provided Strapi instance and unique identifier (UID).\n   *\n   * @param strapi The Strapi instance to be used.\n   * @param uid The unique identifier for the instance.\n   */\n  protected constructor(strapi: Core.Strapi, uid: T) {\n    this._strapi = strapi;\n    this._uid = uid;\n  }\n\n  /**\n   * Retrieves an enum schema constructed from the keys of the scalar fields.\n   *\n   * @return A Zod enum containing the keys from the scalar fields.\n   */\n  public get scalarFieldsEnum() {\n    return z.enum(Object.keys(this._scalarFields) as [string]);\n  }\n\n  /**\n   * Retrieves an enum schema constructed from the keys of fields that can be populated (relations, components, files, etc.)\n   *\n   * @return A ZodEnum object containing the list of populatable field keys.\n   */\n  public get populatableFieldsEnum() {\n    return z.enum(Object.keys(this._populatableFields) as [string]);\n  }\n\n  /**\n   * Retrieves an array representation of the scalar fields.\n   *\n   * @return An array containing the scalar fields as defined by {@link scalarFieldsEnum}.\n   */\n  public get scalarFieldsArray() {\n    return z.array(this.scalarFieldsEnum);\n  }\n\n  /**\n   * Retrieves an array of populatable fields.\n   *\n   * @return A Zod array schema representing the available populatable fields as defined by {@link populatableFieldsEnum}.\n   */\n  public get populatableFieldsArray() {\n    return z.array(this.populatableFieldsEnum);\n  }\n\n  /**\n   * Retrieves the schema associated with the current model.\n   *\n   * The schema represents the structural definition of the model,\n   * as retrieved from the Strapi model associated with the given UID.\n   *\n   * @return The schema of the model retrieved from Strapi.\n   */\n  protected get _schema() {\n    return this._strapi.getModel(this._uid);\n  }\n\n  /**\n   * Retrieves scalar fields from the object's schema attributes.\n   *\n   * Filters the schema attributes to include only those that are scalar and not private.\n   *\n   * @return An object composed of scalar fields from the schema attributes.\n   */\n  protected get _scalarFields() {\n    const attributes = Object.entries(this._schema.attributes);\n\n    const scalarEntries = attributes\n      .filter(([, attribute]) => contentTypes.isScalarAttribute(attribute))\n      .filter(([attributeName]) => !contentTypes.isPrivateAttribute(this._schema, attributeName));\n\n    return Object.fromEntries(scalarEntries);\n  }\n\n  /**\n   * Retrieves the populatable fields from the schema attributes.\n   *\n   * Filters the schema attributes to include only those that are populatable and not private.\n   *\n   * @return An object containing the populatable fields derived from the schema attributes.\n   */\n  protected get _populatableFields() {\n    const attributes = Object.entries(this._schema.attributes);\n\n    const populatableEntries = attributes\n      .filter(([, attribute]) => !contentTypes.isScalarAttribute(attribute))\n      .filter(([attributeName]) => !contentTypes.isPrivateAttribute(this._schema, attributeName));\n\n    return Object.fromEntries(populatableEntries);\n  }\n\n  /**\n   * Creates a Zod schema as a record with scalar fields as keys and the specified type as values.\n   *\n   * @param type - The Zod type to use for the record's values.\n   * @return A Zod record schema with scalar fields as keys and the specified type as values.\n   */\n  public fieldRecord(type: z.ZodTypeAny) {\n    return z.record(this.scalarFieldsEnum, type);\n  }\n}\n\n/**\n * Maps a Strapi attribute definition to a corresponding Zod validation schema.\n * This function handles various Strapi attribute types and converts them into\n * appropriate Zod validation schemas with their respective constraints.\n *\n * @param attribute - The Strapi attribute configuration object. Contains type information\n *                   and validation rules for the attribute.\n *\n * @returns A Zod schema that corresponds to the input attribute's type and validation rules\n *\n * @example\n * ```typescript\n * // String attribute with constraints\n * const stringAttribute = {\n *   type: 'string',\n *   minLength: 3,\n *   maxLength: 50,\n *   required: true\n * };\n * const stringSchema = mapAttributeToSchema(stringAttribute);\n *\n * // Enumeration attribute\n * const enumAttribute = {\n *   type: 'enumeration',\n *   enum: ['draft', 'published', 'archived']\n * };\n * const enumSchema = mapAttributeToSchema(enumAttribute);\n *\n * // Media attribute with multiple files\n * const mediaAttribute = {\n *   type: 'media',\n *   multiple: true\n * };\n * const mediaSchema = mapAttributeToSchema(mediaAttribute);\n * ```\n *\n * @throws {Error} Throws an error if an unsupported attribute type is provided\n *\n * @remarks\n * - Complex types (component, relation, dynamic zone) use placeholder schemas\n */\nexport const mapAttributeToSchema = (attribute: Schema.Attribute.AnyAttribute): z.Schema => {\n  switch (attribute.type) {\n    case 'string':\n    case 'text':\n    case 'richtext': {\n      const { minLength, maxLength, required, default: def } = attribute;\n\n      return [z.string()]\n        .map((schema) => (minLength !== undefined ? schema.min(minLength) : schema))\n        .map((schema) => (maxLength !== undefined ? schema.max(maxLength) : schema))\n        .map((schema) => (required ? schema : schema.optional()))\n        .map((schema) => {\n          if (typeof def === 'undefined') {\n            return schema;\n          }\n\n          // Needed to infer the type and target the correct schema.default() version\n          return typeof def === 'function' ? schema.default(def) : schema.default(def);\n        })[0];\n    }\n    case 'blocks':\n      return z.string();\n    case 'float':\n      return z.number().describe(`A float field`);\n    case 'decimal':\n      return z.number().describe(`A decimal field`);\n    case 'biginteger':\n      return z.number().describe(`A biginteger field`);\n    case 'integer':\n      return z.number().int().describe(`An integer field`);\n    case 'boolean':\n      return z.boolean().describe(`A boolean field`);\n    case 'date':\n    case 'datetime':\n    case 'timestamp':\n    case 'time':\n      return z.string().datetime().describe(`A date field`);\n    case 'email':\n      return z.string().email().describe(`An email field`);\n    case 'enumeration':\n      return z\n        .enum(attribute.enum as [string])\n        .describe(`An enumeration field with possible values: ${attribute.enum.join(', ')}`);\n    case 'component': {\n      const schema = z.any().describe('imagine this is a component');\n\n      return attribute.repeatable ? z.array(schema) : schema.nullable();\n    }\n    case 'relation': {\n      const schema = z.any().describe(`A related document`);\n\n      return relations.isAnyToMany(attribute) ? z.array(schema) : schema.nullable();\n    }\n    case 'dynamiczone':\n      return z.array(z.any()).describe('Imagine this is a dynamic zone').nullable();\n    case 'json':\n      return z.any().describe(`A JSON field`);\n    case 'uid':\n      return z.string().describe(`A unique identifier (UID) field`);\n    case 'password':\n      return z.string().describe(`A password field`);\n    case 'media': {\n      const schema = z.any().describe(`A media field`);\n\n      return attribute.multiple ? z.array(schema) : schema.nullable();\n    }\n    default:\n      throw new Error(`Unsupported attribute type: ${attribute['type']}`);\n  }\n};\n"],"names":["AbstractCoreRouteValidator","scalarFieldsEnum","z","enum","Object","keys","_scalarFields","populatableFieldsEnum","_populatableFields","scalarFieldsArray","array","populatableFieldsArray","_schema","_strapi","getModel","_uid","attributes","entries","scalarEntries","filter","attribute","contentTypes","isScalarAttribute","attributeName","isPrivateAttribute","fromEntries","populatableEntries","fieldRecord","type","record","strapi","uid","mapAttributeToSchema","minLength","maxLength","required","default","def","string","map","schema","undefined","min","max","optional","number","describe","int","boolean","datetime","email","join","any","repeatable","nullable","relations","isAnyToMany","multiple","Error"],"mappings":"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"}

package/dist/core-api/routes/validation/common.mjs

@@ -0,0 +1,198 @@
+import { contentTypes, relations } from '@strapi/utils';
+import { z } from 'zod';
+
+/**
+ * AbstractCoreRouteValidator provides the foundation for validating and managing core routes within a Strapi context for a specific model.
+ *
+ * This abstract class facilitates validation logic for scalar and populatable fields defined in a model schema.
+ *
+ * It uses runtime information about Strapi models to derive and expose schema validations.
+ *
+ * @template {UID.Schema} T Representing the schema identifier to be validated.
+ */ class AbstractCoreRouteValidator {
+    /**
+   * Retrieves an enum schema constructed from the keys of the scalar fields.
+   *
+   * @return A Zod enum containing the keys from the scalar fields.
+   */ get scalarFieldsEnum() {
+        return z.enum(Object.keys(this._scalarFields));
+    }
+    /**
+   * Retrieves an enum schema constructed from the keys of fields that can be populated (relations, components, files, etc.)
+   *
+   * @return A ZodEnum object containing the list of populatable field keys.
+   */ get populatableFieldsEnum() {
+        return z.enum(Object.keys(this._populatableFields));
+    }
+    /**
+   * Retrieves an array representation of the scalar fields.
+   *
+   * @return An array containing the scalar fields as defined by {@link scalarFieldsEnum}.
+   */ get scalarFieldsArray() {
+        return z.array(this.scalarFieldsEnum);
+    }
+    /**
+   * Retrieves an array of populatable fields.
+   *
+   * @return A Zod array schema representing the available populatable fields as defined by {@link populatableFieldsEnum}.
+   */ get populatableFieldsArray() {
+        return z.array(this.populatableFieldsEnum);
+    }
+    /**
+   * Retrieves the schema associated with the current model.
+   *
+   * The schema represents the structural definition of the model,
+   * as retrieved from the Strapi model associated with the given UID.
+   *
+   * @return The schema of the model retrieved from Strapi.
+   */ get _schema() {
+        return this._strapi.getModel(this._uid);
+    }
+    /**
+   * Retrieves scalar fields from the object's schema attributes.
+   *
+   * Filters the schema attributes to include only those that are scalar and not private.
+   *
+   * @return An object composed of scalar fields from the schema attributes.
+   */ get _scalarFields() {
+        const attributes = Object.entries(this._schema.attributes);
+        const scalarEntries = attributes.filter(([, attribute])=>contentTypes.isScalarAttribute(attribute)).filter(([attributeName])=>!contentTypes.isPrivateAttribute(this._schema, attributeName));
+        return Object.fromEntries(scalarEntries);
+    }
+    /**
+   * Retrieves the populatable fields from the schema attributes.
+   *
+   * Filters the schema attributes to include only those that are populatable and not private.
+   *
+   * @return An object containing the populatable fields derived from the schema attributes.
+   */ get _populatableFields() {
+        const attributes = Object.entries(this._schema.attributes);
+        const populatableEntries = attributes.filter(([, attribute])=>!contentTypes.isScalarAttribute(attribute)).filter(([attributeName])=>!contentTypes.isPrivateAttribute(this._schema, attributeName));
+        return Object.fromEntries(populatableEntries);
+    }
+    /**
+   * Creates a Zod schema as a record with scalar fields as keys and the specified type as values.
+   *
+   * @param type - The Zod type to use for the record's values.
+   * @return A Zod record schema with scalar fields as keys and the specified type as values.
+   */ fieldRecord(type) {
+        return z.record(this.scalarFieldsEnum, type);
+    }
+    /**
+   * Protected constructor for initializing the class with the provided Strapi instance and unique identifier (UID).
+   *
+   * @param strapi The Strapi instance to be used.
+   * @param uid The unique identifier for the instance.
+   */ constructor(strapi, uid){
+        this._strapi = strapi;
+        this._uid = uid;
+    }
+}
+/**
+ * Maps a Strapi attribute definition to a corresponding Zod validation schema.
+ * This function handles various Strapi attribute types and converts them into
+ * appropriate Zod validation schemas with their respective constraints.
+ *
+ * @param attribute - The Strapi attribute configuration object. Contains type information
+ *                   and validation rules for the attribute.
+ *
+ * @returns A Zod schema that corresponds to the input attribute's type and validation rules
+ *
+ * @example
+ * ```typescript
+ * // String attribute with constraints
+ * const stringAttribute = {
+ *   type: 'string',
+ *   minLength: 3,
+ *   maxLength: 50,
+ *   required: true
+ * };
+ * const stringSchema = mapAttributeToSchema(stringAttribute);
+ *
+ * // Enumeration attribute
+ * const enumAttribute = {
+ *   type: 'enumeration',
+ *   enum: ['draft', 'published', 'archived']
+ * };
+ * const enumSchema = mapAttributeToSchema(enumAttribute);
+ *
+ * // Media attribute with multiple files
+ * const mediaAttribute = {
+ *   type: 'media',
+ *   multiple: true
+ * };
+ * const mediaSchema = mapAttributeToSchema(mediaAttribute);
+ * ```
+ *
+ * @throws {Error} Throws an error if an unsupported attribute type is provided
+ *
+ * @remarks
+ * - Complex types (component, relation, dynamic zone) use placeholder schemas
+ */ const mapAttributeToSchema = (attribute)=>{
+    switch(attribute.type){
+        case 'string':
+        case 'text':
+        case 'richtext':
+            {
+                const { minLength, maxLength, required, default: def } = attribute;
+                return [
+                    z.string()
+                ].map((schema)=>minLength !== undefined ? schema.min(minLength) : schema).map((schema)=>maxLength !== undefined ? schema.max(maxLength) : schema).map((schema)=>required ? schema : schema.optional()).map((schema)=>{
+                    if (typeof def === 'undefined') {
+                        return schema;
+                    }
+                    // Needed to infer the type and target the correct schema.default() version
+                    return typeof def === 'function' ? schema.default(def) : schema.default(def);
+                })[0];
+            }
+        case 'blocks':
+            return z.string();
+        case 'float':
+            return z.number().describe(`A float field`);
+        case 'decimal':
+            return z.number().describe(`A decimal field`);
+        case 'biginteger':
+            return z.number().describe(`A biginteger field`);
+        case 'integer':
+            return z.number().int().describe(`An integer field`);
+        case 'boolean':
+            return z.boolean().describe(`A boolean field`);
+        case 'date':
+        case 'datetime':
+        case 'timestamp':
+        case 'time':
+            return z.string().datetime().describe(`A date field`);
+        case 'email':
+            return z.string().email().describe(`An email field`);
+        case 'enumeration':
+            return z.enum(attribute.enum).describe(`An enumeration field with possible values: ${attribute.enum.join(', ')}`);
+        case 'component':
+            {
+                const schema = z.any().describe('imagine this is a component');
+                return attribute.repeatable ? z.array(schema) : schema.nullable();
+            }
+        case 'relation':
+            {
+                const schema = z.any().describe(`A related document`);
+                return relations.isAnyToMany(attribute) ? z.array(schema) : schema.nullable();
+            }
+        case 'dynamiczone':
+            return z.array(z.any()).describe('Imagine this is a dynamic zone').nullable();
+        case 'json':
+            return z.any().describe(`A JSON field`);
+        case 'uid':
+            return z.string().describe(`A unique identifier (UID) field`);
+        case 'password':
+            return z.string().describe(`A password field`);
+        case 'media':
+            {
+                const schema = z.any().describe(`A media field`);
+                return attribute.multiple ? z.array(schema) : schema.nullable();
+            }
+        default:
+            throw new Error(`Unsupported attribute type: ${attribute['type']}`);
+    }
+};
+
+export { AbstractCoreRouteValidator, mapAttributeToSchema };
+//# sourceMappingURL=common.mjs.map

package/dist/core-api/routes/validation/common.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.mjs","sources":["../../../../src/core-api/routes/validation/common.ts"],"sourcesContent":["import { type Core, Schema, type UID } from '@strapi/types';\nimport { contentTypes, relations } from '@strapi/utils';\nimport { z } from 'zod';\n\n/**\n * AbstractCoreRouteValidator provides the foundation for validating and managing core routes within a Strapi context for a specific model.\n *\n * This abstract class facilitates validation logic for scalar and populatable fields defined in a model schema.\n *\n * It uses runtime information about Strapi models to derive and expose schema validations.\n *\n * @template {UID.Schema} T Representing the schema identifier to be validated.\n */\nexport abstract class AbstractCoreRouteValidator<T extends UID.Schema> {\n  /**\n   * The `_strapi` variable serves as a reference to the core Strapi instance.\n   * It is used for interacting with the loaded model.\n   */\n  protected readonly _strapi: Core.Strapi;\n\n  /**\n   * A unique identifier used to represent a model within Strapi.\n   *\n   * The type of the identifier is generic to allow flexibility and ensure type safety\n   * when working with either content-types or components.\n   */\n  protected readonly _uid: T;\n\n  /**\n   * Protected constructor for initializing the class with the provided Strapi instance and unique identifier (UID).\n   *\n   * @param strapi The Strapi instance to be used.\n   * @param uid The unique identifier for the instance.\n   */\n  protected constructor(strapi: Core.Strapi, uid: T) {\n    this._strapi = strapi;\n    this._uid = uid;\n  }\n\n  /**\n   * Retrieves an enum schema constructed from the keys of the scalar fields.\n   *\n   * @return A Zod enum containing the keys from the scalar fields.\n   */\n  public get scalarFieldsEnum() {\n    return z.enum(Object.keys(this._scalarFields) as [string]);\n  }\n\n  /**\n   * Retrieves an enum schema constructed from the keys of fields that can be populated (relations, components, files, etc.)\n   *\n   * @return A ZodEnum object containing the list of populatable field keys.\n   */\n  public get populatableFieldsEnum() {\n    return z.enum(Object.keys(this._populatableFields) as [string]);\n  }\n\n  /**\n   * Retrieves an array representation of the scalar fields.\n   *\n   * @return An array containing the scalar fields as defined by {@link scalarFieldsEnum}.\n   */\n  public get scalarFieldsArray() {\n    return z.array(this.scalarFieldsEnum);\n  }\n\n  /**\n   * Retrieves an array of populatable fields.\n   *\n   * @return A Zod array schema representing the available populatable fields as defined by {@link populatableFieldsEnum}.\n   */\n  public get populatableFieldsArray() {\n    return z.array(this.populatableFieldsEnum);\n  }\n\n  /**\n   * Retrieves the schema associated with the current model.\n   *\n   * The schema represents the structural definition of the model,\n   * as retrieved from the Strapi model associated with the given UID.\n   *\n   * @return The schema of the model retrieved from Strapi.\n   */\n  protected get _schema() {\n    return this._strapi.getModel(this._uid);\n  }\n\n  /**\n   * Retrieves scalar fields from the object's schema attributes.\n   *\n   * Filters the schema attributes to include only those that are scalar and not private.\n   *\n   * @return An object composed of scalar fields from the schema attributes.\n   */\n  protected get _scalarFields() {\n    const attributes = Object.entries(this._schema.attributes);\n\n    const scalarEntries = attributes\n      .filter(([, attribute]) => contentTypes.isScalarAttribute(attribute))\n      .filter(([attributeName]) => !contentTypes.isPrivateAttribute(this._schema, attributeName));\n\n    return Object.fromEntries(scalarEntries);\n  }\n\n  /**\n   * Retrieves the populatable fields from the schema attributes.\n   *\n   * Filters the schema attributes to include only those that are populatable and not private.\n   *\n   * @return An object containing the populatable fields derived from the schema attributes.\n   */\n  protected get _populatableFields() {\n    const attributes = Object.entries(this._schema.attributes);\n\n    const populatableEntries = attributes\n      .filter(([, attribute]) => !contentTypes.isScalarAttribute(attribute))\n      .filter(([attributeName]) => !contentTypes.isPrivateAttribute(this._schema, attributeName));\n\n    return Object.fromEntries(populatableEntries);\n  }\n\n  /**\n   * Creates a Zod schema as a record with scalar fields as keys and the specified type as values.\n   *\n   * @param type - The Zod type to use for the record's values.\n   * @return A Zod record schema with scalar fields as keys and the specified type as values.\n   */\n  public fieldRecord(type: z.ZodTypeAny) {\n    return z.record(this.scalarFieldsEnum, type);\n  }\n}\n\n/**\n * Maps a Strapi attribute definition to a corresponding Zod validation schema.\n * This function handles various Strapi attribute types and converts them into\n * appropriate Zod validation schemas with their respective constraints.\n *\n * @param attribute - The Strapi attribute configuration object. Contains type information\n *                   and validation rules for the attribute.\n *\n * @returns A Zod schema that corresponds to the input attribute's type and validation rules\n *\n * @example\n * ```typescript\n * // String attribute with constraints\n * const stringAttribute = {\n *   type: 'string',\n *   minLength: 3,\n *   maxLength: 50,\n *   required: true\n * };\n * const stringSchema = mapAttributeToSchema(stringAttribute);\n *\n * // Enumeration attribute\n * const enumAttribute = {\n *   type: 'enumeration',\n *   enum: ['draft', 'published', 'archived']\n * };\n * const enumSchema = mapAttributeToSchema(enumAttribute);\n *\n * // Media attribute with multiple files\n * const mediaAttribute = {\n *   type: 'media',\n *   multiple: true\n * };\n * const mediaSchema = mapAttributeToSchema(mediaAttribute);\n * ```\n *\n * @throws {Error} Throws an error if an unsupported attribute type is provided\n *\n * @remarks\n * - Complex types (component, relation, dynamic zone) use placeholder schemas\n */\nexport const mapAttributeToSchema = (attribute: Schema.Attribute.AnyAttribute): z.Schema => {\n  switch (attribute.type) {\n    case 'string':\n    case 'text':\n    case 'richtext': {\n      const { minLength, maxLength, required, default: def } = attribute;\n\n      return [z.string()]\n        .map((schema) => (minLength !== undefined ? schema.min(minLength) : schema))\n        .map((schema) => (maxLength !== undefined ? schema.max(maxLength) : schema))\n        .map((schema) => (required ? schema : schema.optional()))\n        .map((schema) => {\n          if (typeof def === 'undefined') {\n            return schema;\n          }\n\n          // Needed to infer the type and target the correct schema.default() version\n          return typeof def === 'function' ? schema.default(def) : schema.default(def);\n        })[0];\n    }\n    case 'blocks':\n      return z.string();\n    case 'float':\n      return z.number().describe(`A float field`);\n    case 'decimal':\n      return z.number().describe(`A decimal field`);\n    case 'biginteger':\n      return z.number().describe(`A biginteger field`);\n    case 'integer':\n      return z.number().int().describe(`An integer field`);\n    case 'boolean':\n      return z.boolean().describe(`A boolean field`);\n    case 'date':\n    case 'datetime':\n    case 'timestamp':\n    case 'time':\n      return z.string().datetime().describe(`A date field`);\n    case 'email':\n      return z.string().email().describe(`An email field`);\n    case 'enumeration':\n      return z\n        .enum(attribute.enum as [string])\n        .describe(`An enumeration field with possible values: ${attribute.enum.join(', ')}`);\n    case 'component': {\n      const schema = z.any().describe('imagine this is a component');\n\n      return attribute.repeatable ? z.array(schema) : schema.nullable();\n    }\n    case 'relation': {\n      const schema = z.any().describe(`A related document`);\n\n      return relations.isAnyToMany(attribute) ? z.array(schema) : schema.nullable();\n    }\n    case 'dynamiczone':\n      return z.array(z.any()).describe('Imagine this is a dynamic zone').nullable();\n    case 'json':\n      return z.any().describe(`A JSON field`);\n    case 'uid':\n      return z.string().describe(`A unique identifier (UID) field`);\n    case 'password':\n      return z.string().describe(`A password field`);\n    case 'media': {\n      const schema = z.any().describe(`A media field`);\n\n      return attribute.multiple ? z.array(schema) : schema.nullable();\n    }\n    default:\n      throw new Error(`Unsupported attribute type: ${attribute['type']}`);\n  }\n};\n"],"names":["AbstractCoreRouteValidator","scalarFieldsEnum","z","enum","Object","keys","_scalarFields","populatableFieldsEnum","_populatableFields","scalarFieldsArray","array","populatableFieldsArray","_schema","_strapi","getModel","_uid","attributes","entries","scalarEntries","filter","attribute","contentTypes","isScalarAttribute","attributeName","isPrivateAttribute","fromEntries","populatableEntries","fieldRecord","type","record","strapi","uid","mapAttributeToSchema","minLength","maxLength","required","default","def","string","map","schema","undefined","min","max","optional","number","describe","int","boolean","datetime","email","join","any","repeatable","nullable","relations","isAnyToMany","multiple","Error"],"mappings":"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"}

package/dist/core-api/routes/validation/component.d.ts

@@ -0,0 +1,42 @@
+import type { Core, UID } from '@strapi/types';
+import { z } from 'zod';
+import { AbstractCoreRouteValidator } from './common';
+/**
+ * A component validator for core content-type routes.
+ *
+ * Provides validation schemas and utilities for handling component-specific validation in content-type routes.
+ *
+ * @example
+ * ```ts
+ * const strapi = // ... strapi instance
+ * const uid = 'api::article.article'
+ * const validator = new CoreComponentRouteValidator(strapi, uid);
+ *
+ * // Get validation schema for a component entry
+ * const componentSchema = validator.component;
+ * ```
+ */
+export declare class CoreComponentRouteValidator extends AbstractCoreRouteValidator<UID.Component> {
+    /**
+     * Creates a new instance of CoreComponentRouteValidator
+     *
+     * @param strapi - The Strapi instance
+     * @param uid - The component's unique identifier
+     */
+    constructor(strapi: Core.Strapi, uid: UID.Component);
+    /**
+     * Generates a comprehensive validation schema for a single component entry.
+     *
+     * Combines scalar fields and populatable fields into a single schema.
+     *
+     * @returns A schema for validating complete entries
+     *
+     * @example
+     * ```ts
+     * const validator = new CoreComponentRouteValidator(strapi, uid);
+     * const entrySchema = validator.entry;
+     * ```
+     */
+    get entry(): z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+}
+//# sourceMappingURL=component.d.ts.map

package/dist/core-api/routes/validation/component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component.d.ts","sourceRoot":"","sources":["../../../../src/core-api/routes/validation/component.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,0BAA0B,EAAwB,MAAM,UAAU,CAAC;AAE5E;;;;;;;;;;;;;;GAcG;AACH,qBAAa,2BAA4B,SAAQ,0BAA0B,CAAC,GAAG,CAAC,SAAS,CAAC;IACxF;;;;;OAKG;gBACS,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,SAAS;IAInD;;;;;;;;;;;;OAYG;IACH,IAAI,KAAK,mDAQR;CACF"}