@strapi/core 0.0.0-experimental.25041a58cd2af628963c29620b4657416a4d772e → 0.0.0-experimental.25f7de53c1fc990bbb86d4aa43c379acfa838064

package/dist/core-api/routes/validation/content-type.d.ts

@@ -0,0 +1,139 @@
+import type { Core, UID } from '@strapi/types';
+import { z } from 'zod';
+import { AbstractCoreRouteValidator } from './common';
+type QueryParam = 'fields' | 'populate' | 'sort';
+/**
+ * A validator for core content-type routes.
+ *
+ * Provides validation schemas and utilities for handling content-type-specific route validation.
+ *
+ * @example
+ * ```ts
+ * const strapi = // ... strapi instance
+ * const uid = 'api::article.article'
+ * const validator = new CoreContentTypeRouteValidator(strapi, uid);
+ *
+ * // Get validation schema for document
+ * const documentSchema = validator.document;
+ *
+ * // Validate query parameters
+ * const querySchema = validator.query(['fields', 'populate', 'sort']);
+ * ```
+ */
+export declare class CoreContentTypeRouteValidator extends AbstractCoreRouteValidator<UID.ContentType> {
+    /**
+     * Creates a new instance of CoreContentTypeRouteValidator
+     *
+     * @param strapi - The Strapi instance
+     * @param uid - The content-type's unique identifier
+     */
+    constructor(strapi: Core.Strapi, uid: UID.ContentType);
+    /**
+     * Generates a validation schema for document IDs
+     *
+     * @returns A schema that validates UUIDs
+     *
+     * @example
+     * ```ts
+     * const validator = new CoreContentTypeRouteValidator(strapi, uid);
+     * const idSchema = validator.documentID;
+     * ```
+     */
+    get documentID(): z.ZodString;
+    /**
+     * Generates a comprehensive validation schema for a single document.
+     *
+     * Combines scalar fields and populatable fields into a single schema.
+     *
+     * @returns A schema for validating complete documents
+     *
+     * @example
+     * ```ts
+     * const validator = new CoreContentTypeRouteValidator(strapi, uid);
+     * const docSchema = validator.document;
+     * ```
+     */
+    get document(): z.ZodObject<{
+        documentId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        documentId: string;
+    }, {
+        documentId: string;
+    }>;
+    /**
+     * Generates a validation schema for an array of documents
+     *
+     * @returns A schema for validating arrays of documents
+     *
+     * @example
+     * ```ts
+     * const validator = new CoreContentTypeRouteValidator(strapi, uid);
+     * const docsSchema = validator.documents;
+     * ```
+     */
+    get documents(): z.ZodArray<z.ZodObject<{
+        documentId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        documentId: string;
+    }, {
+        documentId: string;
+    }>, "many">;
+    /**
+     * Creates validation schemas for query parameters
+     *
+     * @param params - Array of query parameters to validate ('fields', 'populate', 'sort', ...)
+     * @returns Object containing validation schemas for requested parameters
+     *
+     * @example
+     * ```ts
+     * const validator = new CoreContentTypeRouteValidator(strapi, uid);
+     * const querySchemas = validator.query(['fields', 'populate']);
+     * ```
+     */
+    query(params: QueryParam[]): Partial<Record<QueryParam, z.Schema>>;
+    /**
+     * Generates a validation schema for field selection in queries
+     *
+     * @returns A schema for validating field selection
+     *
+     * @example
+     * ```ts
+     * const validator = new CoreContentTypeRouteValidator(strapi, uid);
+     * const fieldsSchema = validator.queryFields;
+     * ```
+     */
+    get queryFields(): z.ZodReadonly<z.ZodArray<z.ZodEnum<[string]>, "many">>;
+    /**
+     * Generates a validation schema for populate operations.
+     *
+     * Allows wildcard (*), single field, and multiple field population.
+     *
+     * @returns A schema for validating populate parameters
+     *
+     * @example
+     * ```ts
+     * const validator = new CoreContentTypeRouteValidator(strapi, uid);
+     * const populateSchema = validator.queryPopulate;
+     * ```
+     */
+    get queryPopulate(): z.ZodUnion<[z.ZodReadonly<z.ZodLiteral<"*">>, z.ZodReadonly<z.ZodEnum<[string]>>, z.ZodArray<z.ZodEnum<[string]>, "many">]>;
+    /**
+     * Generates a validation schema for sorting parameters.
+     *
+     * Allows various sorting formats including single field, multiple fields, and direction specifications
+     *
+     * @returns A schema for validating sort parameters
+     *
+     * @example
+     * ```ts
+     * const validator = new CoreContentTypeRouteValidator(strapi, uid);
+     * const sortSchema = validator.querySort;
+     * ```
+     *
+     * @remarks
+     * - Nested sorts are currently not supported
+     */
+    get querySort(): z.ZodOptional<z.ZodUnion<[z.ZodEnum<[string]>, z.ZodArray<z.ZodEnum<[string]>, "many">, z.ZodRecord<z.ZodEnum<[string]>, z.ZodTypeAny>, z.ZodArray<z.ZodRecord<z.ZodEnum<[string]>, z.ZodTypeAny>, "many">]>>;
+}
+export {};
+//# sourceMappingURL=content-type.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"content-type.d.ts","sourceRoot":"","sources":["../../../../src/core-api/routes/validation/content-type.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,KAAK,UAAU,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAC;AAEjD;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,6BAA8B,SAAQ,0BAA0B,CAAC,GAAG,CAAC,WAAW,CAAC;IAC5F;;;;;OAKG;gBACS,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,WAAW;IAIrD;;;;;;;;;;OAUG;IACH,IAAI,UAAU,gBAEb;IAED;;;;;;;;;;;;OAYG;IACH,IAAI,QAAQ;;;;;;OAYX;IAED;;;;;;;;;;OAUG;IACH,IAAI,SAAS;;;;;;gBAEZ;IAED;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;IAalE;;;;;;;;;;OAUG;IACH,IAAI,WAAW,2DAMd;IAED;;;;;;;;;;;;OAYG;IACH,IAAI,aAAa,gIAiBhB;IAED;;;;;;;;;;;;;;;OAeG;IACH,IAAI,SAAS,kNAgBZ;CACF"}

package/dist/core-api/routes/validation/content-type.js

@@ -0,0 +1,176 @@
+'use strict';
+
+var zod = require('zod');
+var common = require('./common.js');
+
+/**
+ * A validator for core content-type routes.
+ *
+ * Provides validation schemas and utilities for handling content-type-specific route validation.
+ *
+ * @example
+ * ```ts
+ * const strapi = // ... strapi instance
+ * const uid = 'api::article.article'
+ * const validator = new CoreContentTypeRouteValidator(strapi, uid);
+ *
+ * // Get validation schema for document
+ * const documentSchema = validator.document;
+ *
+ * // Validate query parameters
+ * const querySchema = validator.query(['fields', 'populate', 'sort']);
+ * ```
+ */ class CoreContentTypeRouteValidator extends common.AbstractCoreRouteValidator {
+    /**
+   * Generates a validation schema for document IDs
+   *
+   * @returns A schema that validates UUIDs
+   *
+   * @example
+   * ```ts
+   * const validator = new CoreContentTypeRouteValidator(strapi, uid);
+   * const idSchema = validator.documentID;
+   * ```
+   */ get documentID() {
+        return zod.z.string().uuid().describe('The document ID, represented by a UUID');
+    }
+    /**
+   * Generates a comprehensive validation schema for a single document.
+   *
+   * Combines scalar fields and populatable fields into a single schema.
+   *
+   * @returns A schema for validating complete documents
+   *
+   * @example
+   * ```ts
+   * const validator = new CoreContentTypeRouteValidator(strapi, uid);
+   * const docSchema = validator.document;
+   * ```
+   */ get document() {
+        const { _scalarFields, _populatableFields } = this;
+        const entries = Object.entries({
+            ..._scalarFields,
+            ..._populatableFields
+        });
+        const attributesSchema = entries.reduce((acc, [attributeName, attribute])=>{
+            return acc.merge(zod.z.object({
+                [attributeName]: common.mapAttributeToSchema(attribute)
+            }));
+        }, zod.z.object({}));
+        const defaultSchema = zod.z.object({
+            documentId: this.documentID
+        });
+        return defaultSchema.merge(attributesSchema);
+    }
+    /**
+   * Generates a validation schema for an array of documents
+   *
+   * @returns A schema for validating arrays of documents
+   *
+   * @example
+   * ```ts
+   * const validator = new CoreContentTypeRouteValidator(strapi, uid);
+   * const docsSchema = validator.documents;
+   * ```
+   */ get documents() {
+        return zod.z.array(this.document);
+    }
+    /**
+   * Creates validation schemas for query parameters
+   *
+   * @param params - Array of query parameters to validate ('fields', 'populate', 'sort', ...)
+   * @returns Object containing validation schemas for requested parameters
+   *
+   * @example
+   * ```ts
+   * const validator = new CoreContentTypeRouteValidator(strapi, uid);
+   * const querySchemas = validator.query(['fields', 'populate']);
+   * ```
+   */ query(params) {
+        const map = {
+            fields: ()=>this.queryFields,
+            populate: ()=>this.queryPopulate,
+            sort: ()=>this.querySort
+        };
+        return params.reduce((acc, param)=>({
+                ...acc,
+                [param]: map[param]()
+            }), {});
+    }
+    /**
+   * Generates a validation schema for field selection in queries
+   *
+   * @returns A schema for validating field selection
+   *
+   * @example
+   * ```ts
+   * const validator = new CoreContentTypeRouteValidator(strapi, uid);
+   * const fieldsSchema = validator.queryFields;
+   * ```
+   */ get queryFields() {
+        return this.scalarFieldsArray.readonly().describe(`The fields to return, this doesn't include populatable fields like relations, components, files, or dynamic zones`);
+    }
+    /**
+   * Generates a validation schema for populate operations.
+   *
+   * Allows wildcard (*), single field, and multiple field population.
+   *
+   * @returns A schema for validating populate parameters
+   *
+   * @example
+   * ```ts
+   * const validator = new CoreContentTypeRouteValidator(strapi, uid);
+   * const populateSchema = validator.queryPopulate;
+   * ```
+   */ get queryPopulate() {
+        const wildcardPopulate = zod.z.literal('*').readonly().describe('Populate all the first level relations, components, files, and dynamic zones for the entry');
+        const singleFieldPopulate = this.populatableFieldsEnum.readonly().describe('Populate a single relation, component, file, or dynamic zone');
+        const multiPopulate = this.populatableFieldsArray.describe('Populate a selection of multiple relations, components, files, or dynamic zones');
+        return zod.z.union([
+            wildcardPopulate,
+            singleFieldPopulate,
+            multiPopulate
+        ]);
+    }
+    /**
+   * Generates a validation schema for sorting parameters.
+   *
+   * Allows various sorting formats including single field, multiple fields, and direction specifications
+   *
+   * @returns A schema for validating sort parameters
+   *
+   * @example
+   * ```ts
+   * const validator = new CoreContentTypeRouteValidator(strapi, uid);
+   * const sortSchema = validator.querySort;
+   * ```
+   *
+   * @remarks
+   * - Nested sorts are currently not supported
+   */ get querySort() {
+        const orderDirection = zod.z.enum([
+            'asc',
+            'desc'
+        ]);
+        // TODO: Handle nested sorts but very low priority, very little usage
+        return zod.z.union([
+            this.scalarFieldsEnum,
+            this.scalarFieldsArray,
+            this.fieldRecord(orderDirection),
+            zod.z.array(this.fieldRecord(orderDirection))
+        ], {
+            description: 'Sort Union'
+        }).optional().describe('Sort the result');
+    }
+    /**
+   * Creates a new instance of CoreContentTypeRouteValidator
+   *
+   * @param strapi - The Strapi instance
+   * @param uid - The content-type's unique identifier
+   */ constructor(strapi, uid){
+        super(strapi, uid);
+    }
+}
+
+exports.CoreContentTypeRouteValidator = CoreContentTypeRouteValidator;
+//# sourceMappingURL=content-type.js.map

package/dist/core-api/routes/validation/content-type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-type.js","sources":["../../../../src/core-api/routes/validation/content-type.ts"],"sourcesContent":["import type { Core, UID } from '@strapi/types';\nimport { z } from 'zod';\n\nimport { AbstractCoreRouteValidator, mapAttributeToSchema } from './common';\n\ntype QueryParam = 'fields' | 'populate' | 'sort';\n\n/**\n * A validator for core content-type routes.\n *\n * Provides validation schemas and utilities for handling content-type-specific route validation.\n *\n * @example\n * ```ts\n * const strapi = // ... strapi instance\n * const uid = 'api::article.article'\n * const validator = new CoreContentTypeRouteValidator(strapi, uid);\n *\n * // Get validation schema for document\n * const documentSchema = validator.document;\n *\n * // Validate query parameters\n * const querySchema = validator.query(['fields', 'populate', 'sort']);\n * ```\n */\nexport class CoreContentTypeRouteValidator extends AbstractCoreRouteValidator<UID.ContentType> {\n  /**\n   * Creates a new instance of CoreContentTypeRouteValidator\n   *\n   * @param strapi - The Strapi instance\n   * @param uid - The content-type's unique identifier\n   */\n  constructor(strapi: Core.Strapi, uid: UID.ContentType) {\n    super(strapi, uid);\n  }\n\n  /**\n   * Generates a validation schema for document IDs\n   *\n   * @returns A schema that validates UUIDs\n   *\n   * @example\n   * ```ts\n   * const validator = new CoreContentTypeRouteValidator(strapi, uid);\n   * const idSchema = validator.documentID;\n   * ```\n   */\n  get documentID() {\n    return z.string().uuid().describe('The document ID, represented by a UUID');\n  }\n\n  /**\n   * Generates a comprehensive validation schema for a single document.\n   *\n   * Combines scalar fields and populatable fields into a single schema.\n   *\n   * @returns A schema for validating complete documents\n   *\n   * @example\n   * ```ts\n   * const validator = new CoreContentTypeRouteValidator(strapi, uid);\n   * const docSchema = validator.document;\n   * ```\n   */\n  get document() {\n    const { _scalarFields, _populatableFields } = this;\n\n    const entries = Object.entries({ ..._scalarFields, ..._populatableFields });\n\n    const attributesSchema = entries.reduce((acc, [attributeName, attribute]) => {\n      return acc.merge(z.object({ [attributeName]: mapAttributeToSchema(attribute) }));\n    }, z.object({}));\n\n    const defaultSchema = z.object({ documentId: this.documentID });\n\n    return defaultSchema.merge(attributesSchema);\n  }\n\n  /**\n   * Generates a validation schema for an array of documents\n   *\n   * @returns A schema for validating arrays of documents\n   *\n   * @example\n   * ```ts\n   * const validator = new CoreContentTypeRouteValidator(strapi, uid);\n   * const docsSchema = validator.documents;\n   * ```\n   */\n  get documents() {\n    return z.array(this.document);\n  }\n\n  /**\n   * Creates validation schemas for query parameters\n   *\n   * @param params - Array of query parameters to validate ('fields', 'populate', 'sort', ...)\n   * @returns Object containing validation schemas for requested parameters\n   *\n   * @example\n   * ```ts\n   * const validator = new CoreContentTypeRouteValidator(strapi, uid);\n   * const querySchemas = validator.query(['fields', 'populate']);\n   * ```\n   */\n  query(params: QueryParam[]): Partial<Record<QueryParam, z.Schema>> {\n    const map = {\n      fields: () => this.queryFields,\n      populate: () => this.queryPopulate,\n      sort: () => this.querySort,\n    };\n\n    return params.reduce(\n      (acc, param) => ({ ...acc, [param]: map[param]() }),\n      {} as Partial<Record<QueryParam, z.Schema>>\n    );\n  }\n\n  /**\n   * Generates a validation schema for field selection in queries\n   *\n   * @returns A schema for validating field selection\n   *\n   * @example\n   * ```ts\n   * const validator = new CoreContentTypeRouteValidator(strapi, uid);\n   * const fieldsSchema = validator.queryFields;\n   * ```\n   */\n  get queryFields() {\n    return this.scalarFieldsArray\n      .readonly()\n      .describe(\n        `The fields to return, this doesn't include populatable fields like relations, components, files, or dynamic zones`\n      );\n  }\n\n  /**\n   * Generates a validation schema for populate operations.\n   *\n   * Allows wildcard (*), single field, and multiple field population.\n   *\n   * @returns A schema for validating populate parameters\n   *\n   * @example\n   * ```ts\n   * const validator = new CoreContentTypeRouteValidator(strapi, uid);\n   * const populateSchema = validator.queryPopulate;\n   * ```\n   */\n  get queryPopulate() {\n    const wildcardPopulate = z\n      .literal('*')\n      .readonly()\n      .describe(\n        'Populate all the first level relations, components, files, and dynamic zones for the entry'\n      );\n\n    const singleFieldPopulate = this.populatableFieldsEnum\n      .readonly()\n      .describe('Populate a single relation, component, file, or dynamic zone');\n\n    const multiPopulate = this.populatableFieldsArray.describe(\n      'Populate a selection of multiple relations, components, files, or dynamic zones'\n    );\n\n    return z.union([wildcardPopulate, singleFieldPopulate, multiPopulate]);\n  }\n\n  /**\n   * Generates a validation schema for sorting parameters.\n   *\n   * Allows various sorting formats including single field, multiple fields, and direction specifications\n   *\n   * @returns A schema for validating sort parameters\n   *\n   * @example\n   * ```ts\n   * const validator = new CoreContentTypeRouteValidator(strapi, uid);\n   * const sortSchema = validator.querySort;\n   * ```\n   *\n   * @remarks\n   * - Nested sorts are currently not supported\n   */\n  get querySort() {\n    const orderDirection = z.enum(['asc', 'desc']);\n\n    // TODO: Handle nested sorts but very low priority, very little usage\n    return z\n      .union(\n        [\n          this.scalarFieldsEnum, // 'name' | 'title'\n          this.scalarFieldsArray, // ['name', 'title']\n          this.fieldRecord(orderDirection), // { name: 'desc' } | { title: 'asc' }\n          z.array(this.fieldRecord(orderDirection)), // [{ name: 'desc'}, { title: 'asc' }]\n        ],\n        { description: 'Sort Union' }\n      )\n      .optional()\n      .describe('Sort the result');\n  }\n}\n"],"names":["CoreContentTypeRouteValidator","AbstractCoreRouteValidator","documentID","z","string","uuid","describe","document","_scalarFields","_populatableFields","entries","Object","attributesSchema","reduce","acc","attributeName","attribute","merge","object","mapAttributeToSchema","defaultSchema","documentId","documents","array","query","params","map","fields","queryFields","populate","queryPopulate","sort","querySort","param","scalarFieldsArray","readonly","wildcardPopulate","literal","singleFieldPopulate","populatableFieldsEnum","multiPopulate","populatableFieldsArray","union","orderDirection","enum","scalarFieldsEnum","fieldRecord","description","optional","constructor","strapi","uid"],"mappings":"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"}

package/dist/core-api/routes/validation/content-type.mjs

@@ -0,0 +1,174 @@
+import { z } from 'zod';
+import { AbstractCoreRouteValidator, mapAttributeToSchema } from './common.mjs';
+
+/**
+ * A validator for core content-type routes.
+ *
+ * Provides validation schemas and utilities for handling content-type-specific route validation.
+ *
+ * @example
+ * ```ts
+ * const strapi = // ... strapi instance
+ * const uid = 'api::article.article'
+ * const validator = new CoreContentTypeRouteValidator(strapi, uid);
+ *
+ * // Get validation schema for document
+ * const documentSchema = validator.document;
+ *
+ * // Validate query parameters
+ * const querySchema = validator.query(['fields', 'populate', 'sort']);
+ * ```
+ */ class CoreContentTypeRouteValidator extends AbstractCoreRouteValidator {
+    /**
+   * Generates a validation schema for document IDs
+   *
+   * @returns A schema that validates UUIDs
+   *
+   * @example
+   * ```ts
+   * const validator = new CoreContentTypeRouteValidator(strapi, uid);
+   * const idSchema = validator.documentID;
+   * ```
+   */ get documentID() {
+        return z.string().uuid().describe('The document ID, represented by a UUID');
+    }
+    /**
+   * Generates a comprehensive validation schema for a single document.
+   *
+   * Combines scalar fields and populatable fields into a single schema.
+   *
+   * @returns A schema for validating complete documents
+   *
+   * @example
+   * ```ts
+   * const validator = new CoreContentTypeRouteValidator(strapi, uid);
+   * const docSchema = validator.document;
+   * ```
+   */ get document() {
+        const { _scalarFields, _populatableFields } = this;
+        const entries = Object.entries({
+            ..._scalarFields,
+            ..._populatableFields
+        });
+        const attributesSchema = entries.reduce((acc, [attributeName, attribute])=>{
+            return acc.merge(z.object({
+                [attributeName]: mapAttributeToSchema(attribute)
+            }));
+        }, z.object({}));
+        const defaultSchema = z.object({
+            documentId: this.documentID
+        });
+        return defaultSchema.merge(attributesSchema);
+    }
+    /**
+   * Generates a validation schema for an array of documents
+   *
+   * @returns A schema for validating arrays of documents
+   *
+   * @example
+   * ```ts
+   * const validator = new CoreContentTypeRouteValidator(strapi, uid);
+   * const docsSchema = validator.documents;
+   * ```
+   */ get documents() {
+        return z.array(this.document);
+    }
+    /**
+   * Creates validation schemas for query parameters
+   *
+   * @param params - Array of query parameters to validate ('fields', 'populate', 'sort', ...)
+   * @returns Object containing validation schemas for requested parameters
+   *
+   * @example
+   * ```ts
+   * const validator = new CoreContentTypeRouteValidator(strapi, uid);
+   * const querySchemas = validator.query(['fields', 'populate']);
+   * ```
+   */ query(params) {
+        const map = {
+            fields: ()=>this.queryFields,
+            populate: ()=>this.queryPopulate,
+            sort: ()=>this.querySort
+        };
+        return params.reduce((acc, param)=>({
+                ...acc,
+                [param]: map[param]()
+            }), {});
+    }
+    /**
+   * Generates a validation schema for field selection in queries
+   *
+   * @returns A schema for validating field selection
+   *
+   * @example
+   * ```ts
+   * const validator = new CoreContentTypeRouteValidator(strapi, uid);
+   * const fieldsSchema = validator.queryFields;
+   * ```
+   */ get queryFields() {
+        return this.scalarFieldsArray.readonly().describe(`The fields to return, this doesn't include populatable fields like relations, components, files, or dynamic zones`);
+    }
+    /**
+   * Generates a validation schema for populate operations.
+   *
+   * Allows wildcard (*), single field, and multiple field population.
+   *
+   * @returns A schema for validating populate parameters
+   *
+   * @example
+   * ```ts
+   * const validator = new CoreContentTypeRouteValidator(strapi, uid);
+   * const populateSchema = validator.queryPopulate;
+   * ```
+   */ get queryPopulate() {
+        const wildcardPopulate = z.literal('*').readonly().describe('Populate all the first level relations, components, files, and dynamic zones for the entry');
+        const singleFieldPopulate = this.populatableFieldsEnum.readonly().describe('Populate a single relation, component, file, or dynamic zone');
+        const multiPopulate = this.populatableFieldsArray.describe('Populate a selection of multiple relations, components, files, or dynamic zones');
+        return z.union([
+            wildcardPopulate,
+            singleFieldPopulate,
+            multiPopulate
+        ]);
+    }
+    /**
+   * Generates a validation schema for sorting parameters.
+   *
+   * Allows various sorting formats including single field, multiple fields, and direction specifications
+   *
+   * @returns A schema for validating sort parameters
+   *
+   * @example
+   * ```ts
+   * const validator = new CoreContentTypeRouteValidator(strapi, uid);
+   * const sortSchema = validator.querySort;
+   * ```
+   *
+   * @remarks
+   * - Nested sorts are currently not supported
+   */ get querySort() {
+        const orderDirection = z.enum([
+            'asc',
+            'desc'
+        ]);
+        // TODO: Handle nested sorts but very low priority, very little usage
+        return z.union([
+            this.scalarFieldsEnum,
+            this.scalarFieldsArray,
+            this.fieldRecord(orderDirection),
+            z.array(this.fieldRecord(orderDirection))
+        ], {
+            description: 'Sort Union'
+        }).optional().describe('Sort the result');
+    }
+    /**
+   * Creates a new instance of CoreContentTypeRouteValidator
+   *
+   * @param strapi - The Strapi instance
+   * @param uid - The content-type's unique identifier
+   */ constructor(strapi, uid){
+        super(strapi, uid);
+    }
+}
+
+export { CoreContentTypeRouteValidator };
+//# sourceMappingURL=content-type.mjs.map

package/dist/core-api/routes/validation/content-type.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-type.mjs","sources":["../../../../src/core-api/routes/validation/content-type.ts"],"sourcesContent":["import type { Core, UID } from '@strapi/types';\nimport { z } from 'zod';\n\nimport { AbstractCoreRouteValidator, mapAttributeToSchema } from './common';\n\ntype QueryParam = 'fields' | 'populate' | 'sort';\n\n/**\n * A validator for core content-type routes.\n *\n * Provides validation schemas and utilities for handling content-type-specific route validation.\n *\n * @example\n * ```ts\n * const strapi = // ... strapi instance\n * const uid = 'api::article.article'\n * const validator = new CoreContentTypeRouteValidator(strapi, uid);\n *\n * // Get validation schema for document\n * const documentSchema = validator.document;\n *\n * // Validate query parameters\n * const querySchema = validator.query(['fields', 'populate', 'sort']);\n * ```\n */\nexport class CoreContentTypeRouteValidator extends AbstractCoreRouteValidator<UID.ContentType> {\n  /**\n   * Creates a new instance of CoreContentTypeRouteValidator\n   *\n   * @param strapi - The Strapi instance\n   * @param uid - The content-type's unique identifier\n   */\n  constructor(strapi: Core.Strapi, uid: UID.ContentType) {\n    super(strapi, uid);\n  }\n\n  /**\n   * Generates a validation schema for document IDs\n   *\n   * @returns A schema that validates UUIDs\n   *\n   * @example\n   * ```ts\n   * const validator = new CoreContentTypeRouteValidator(strapi, uid);\n   * const idSchema = validator.documentID;\n   * ```\n   */\n  get documentID() {\n    return z.string().uuid().describe('The document ID, represented by a UUID');\n  }\n\n  /**\n   * Generates a comprehensive validation schema for a single document.\n   *\n   * Combines scalar fields and populatable fields into a single schema.\n   *\n   * @returns A schema for validating complete documents\n   *\n   * @example\n   * ```ts\n   * const validator = new CoreContentTypeRouteValidator(strapi, uid);\n   * const docSchema = validator.document;\n   * ```\n   */\n  get document() {\n    const { _scalarFields, _populatableFields } = this;\n\n    const entries = Object.entries({ ..._scalarFields, ..._populatableFields });\n\n    const attributesSchema = entries.reduce((acc, [attributeName, attribute]) => {\n      return acc.merge(z.object({ [attributeName]: mapAttributeToSchema(attribute) }));\n    }, z.object({}));\n\n    const defaultSchema = z.object({ documentId: this.documentID });\n\n    return defaultSchema.merge(attributesSchema);\n  }\n\n  /**\n   * Generates a validation schema for an array of documents\n   *\n   * @returns A schema for validating arrays of documents\n   *\n   * @example\n   * ```ts\n   * const validator = new CoreContentTypeRouteValidator(strapi, uid);\n   * const docsSchema = validator.documents;\n   * ```\n   */\n  get documents() {\n    return z.array(this.document);\n  }\n\n  /**\n   * Creates validation schemas for query parameters\n   *\n   * @param params - Array of query parameters to validate ('fields', 'populate', 'sort', ...)\n   * @returns Object containing validation schemas for requested parameters\n   *\n   * @example\n   * ```ts\n   * const validator = new CoreContentTypeRouteValidator(strapi, uid);\n   * const querySchemas = validator.query(['fields', 'populate']);\n   * ```\n   */\n  query(params: QueryParam[]): Partial<Record<QueryParam, z.Schema>> {\n    const map = {\n      fields: () => this.queryFields,\n      populate: () => this.queryPopulate,\n      sort: () => this.querySort,\n    };\n\n    return params.reduce(\n      (acc, param) => ({ ...acc, [param]: map[param]() }),\n      {} as Partial<Record<QueryParam, z.Schema>>\n    );\n  }\n\n  /**\n   * Generates a validation schema for field selection in queries\n   *\n   * @returns A schema for validating field selection\n   *\n   * @example\n   * ```ts\n   * const validator = new CoreContentTypeRouteValidator(strapi, uid);\n   * const fieldsSchema = validator.queryFields;\n   * ```\n   */\n  get queryFields() {\n    return this.scalarFieldsArray\n      .readonly()\n      .describe(\n        `The fields to return, this doesn't include populatable fields like relations, components, files, or dynamic zones`\n      );\n  }\n\n  /**\n   * Generates a validation schema for populate operations.\n   *\n   * Allows wildcard (*), single field, and multiple field population.\n   *\n   * @returns A schema for validating populate parameters\n   *\n   * @example\n   * ```ts\n   * const validator = new CoreContentTypeRouteValidator(strapi, uid);\n   * const populateSchema = validator.queryPopulate;\n   * ```\n   */\n  get queryPopulate() {\n    const wildcardPopulate = z\n      .literal('*')\n      .readonly()\n      .describe(\n        'Populate all the first level relations, components, files, and dynamic zones for the entry'\n      );\n\n    const singleFieldPopulate = this.populatableFieldsEnum\n      .readonly()\n      .describe('Populate a single relation, component, file, or dynamic zone');\n\n    const multiPopulate = this.populatableFieldsArray.describe(\n      'Populate a selection of multiple relations, components, files, or dynamic zones'\n    );\n\n    return z.union([wildcardPopulate, singleFieldPopulate, multiPopulate]);\n  }\n\n  /**\n   * Generates a validation schema for sorting parameters.\n   *\n   * Allows various sorting formats including single field, multiple fields, and direction specifications\n   *\n   * @returns A schema for validating sort parameters\n   *\n   * @example\n   * ```ts\n   * const validator = new CoreContentTypeRouteValidator(strapi, uid);\n   * const sortSchema = validator.querySort;\n   * ```\n   *\n   * @remarks\n   * - Nested sorts are currently not supported\n   */\n  get querySort() {\n    const orderDirection = z.enum(['asc', 'desc']);\n\n    // TODO: Handle nested sorts but very low priority, very little usage\n    return z\n      .union(\n        [\n          this.scalarFieldsEnum, // 'name' | 'title'\n          this.scalarFieldsArray, // ['name', 'title']\n          this.fieldRecord(orderDirection), // { name: 'desc' } | { title: 'asc' }\n          z.array(this.fieldRecord(orderDirection)), // [{ name: 'desc'}, { title: 'asc' }]\n        ],\n        { description: 'Sort Union' }\n      )\n      .optional()\n      .describe('Sort the result');\n  }\n}\n"],"names":["CoreContentTypeRouteValidator","AbstractCoreRouteValidator","documentID","z","string","uuid","describe","document","_scalarFields","_populatableFields","entries","Object","attributesSchema","reduce","acc","attributeName","attribute","merge","object","mapAttributeToSchema","defaultSchema","documentId","documents","array","query","params","map","fields","queryFields","populate","queryPopulate","sort","querySort","param","scalarFieldsArray","readonly","wildcardPopulate","literal","singleFieldPopulate","populatableFieldsEnum","multiPopulate","populatableFieldsArray","union","orderDirection","enum","scalarFieldsEnum","fieldRecord","description","optional","constructor","strapi","uid"],"mappings":";;;AAOA;;;;;;;;;;;;;;;;;IAkBO,MAAMA,6BAAsCC,SAAAA,0BAAAA,CAAAA;AAWjD;;;;;;;;;;AAUC,MACD,IAAIC,UAAa,GAAA;AACf,QAAA,OAAOC,EAAEC,MAAM,EAAA,CAAGC,IAAI,EAAA,CAAGC,QAAQ,CAAC,wCAAA,CAAA;AACpC;AAEA;;;;;;;;;;;;AAYC,MACD,IAAIC,QAAW,GAAA;AACb,QAAA,MAAM,EAAEC,aAAa,EAAEC,kBAAkB,EAAE,GAAG,IAAI;QAElD,MAAMC,OAAAA,GAAUC,MAAOD,CAAAA,OAAO,CAAC;AAAE,YAAA,GAAGF,aAAa;AAAE,YAAA,GAAGC;AAAmB,SAAA,CAAA;QAEzE,MAAMG,gBAAAA,GAAmBF,QAAQG,MAAM,CAAC,CAACC,GAAK,EAAA,CAACC,eAAeC,SAAU,CAAA,GAAA;AACtE,YAAA,OAAOF,GAAIG,CAAAA,KAAK,CAACd,CAAAA,CAAEe,MAAM,CAAC;gBAAE,CAACH,aAAAA,GAAgBI,oBAAqBH,CAAAA,SAAAA;AAAW,aAAA,CAAA,CAAA;SAC5Eb,EAAAA,CAAAA,CAAEe,MAAM,CAAC,EAAC,CAAA,CAAA;QAEb,MAAME,aAAAA,GAAgBjB,CAAEe,CAAAA,MAAM,CAAC;YAAEG,UAAY,EAAA,IAAI,CAACnB;AAAW,SAAA,CAAA;QAE7D,OAAOkB,aAAAA,CAAcH,KAAK,CAACL,gBAAAA,CAAAA;AAC7B;AAEA;;;;;;;;;;AAUC,MACD,IAAIU,SAAY,GAAA;AACd,QAAA,OAAOnB,CAAEoB,CAAAA,KAAK,CAAC,IAAI,CAAChB,QAAQ,CAAA;AAC9B;AAEA;;;;;;;;;;;MAYAiB,KAAAA,CAAMC,MAAoB,EAAyC;AACjE,QAAA,MAAMC,GAAM,GAAA;YACVC,MAAQ,EAAA,IAAM,IAAI,CAACC,WAAW;YAC9BC,QAAU,EAAA,IAAM,IAAI,CAACC,aAAa;YAClCC,IAAM,EAAA,IAAM,IAAI,CAACC;AACnB,SAAA;AAEA,QAAA,OAAOP,OAAOZ,MAAM,CAClB,CAACC,GAAAA,EAAKmB,SAAW;AAAE,gBAAA,GAAGnB,GAAG;AAAE,gBAAA,CAACmB,KAAM,GAAEP,GAAG,CAACO,KAAM,CAAA;AAAG,aAAA,GACjD,EAAC,CAAA;AAEL;AAEA;;;;;;;;;;AAUC,MACD,IAAIL,WAAc,GAAA;QAChB,OAAO,IAAI,CAACM,iBAAiB,CAC1BC,QAAQ,GACR7B,QAAQ,CACP,CAAC,iHAAiH,CAAC,CAAA;AAEzH;AAEA;;;;;;;;;;;;AAYC,MACD,IAAIwB,aAAgB,GAAA;QAClB,MAAMM,gBAAAA,GAAmBjC,EACtBkC,OAAO,CAAC,KACRF,QAAQ,EAAA,CACR7B,QAAQ,CACP,4FAAA,CAAA;QAGJ,MAAMgC,mBAAAA,GAAsB,IAAI,CAACC,qBAAqB,CACnDJ,QAAQ,EAAA,CACR7B,QAAQ,CAAC,8DAAA,CAAA;AAEZ,QAAA,MAAMkC,gBAAgB,IAAI,CAACC,sBAAsB,CAACnC,QAAQ,CACxD,iFAAA,CAAA;QAGF,OAAOH,CAAAA,CAAEuC,KAAK,CAAC;AAACN,YAAAA,gBAAAA;AAAkBE,YAAAA,mBAAAA;AAAqBE,YAAAA;AAAc,SAAA,CAAA;AACvE;AAEA;;;;;;;;;;;;;;;AAeC,MACD,IAAIR,SAAY,GAAA;QACd,MAAMW,cAAAA,GAAiBxC,CAAEyC,CAAAA,IAAI,CAAC;AAAC,YAAA,KAAA;AAAO,YAAA;AAAO,SAAA,CAAA;;QAG7C,OAAOzC,CAAAA,CACJuC,KAAK,CACJ;AACE,YAAA,IAAI,CAACG,gBAAgB;AACrB,YAAA,IAAI,CAACX,iBAAiB;YACtB,IAAI,CAACY,WAAW,CAACH,cAAAA,CAAAA;AACjBxC,YAAAA,CAAAA,CAAEoB,KAAK,CAAC,IAAI,CAACuB,WAAW,CAACH,cAAAA,CAAAA;SAC1B,EACD;YAAEI,WAAa,EAAA;SAEhBC,CAAAA,CAAAA,QAAQ,EACR1C,CAAAA,QAAQ,CAAC,iBAAA,CAAA;AACd;AA/KA;;;;;AAKC,MACD2C,WAAYC,CAAAA,MAAmB,EAAEC,GAAoB,CAAE;AACrD,QAAA,KAAK,CAACD,MAAQC,EAAAA,GAAAA,CAAAA;AAChB;AAwKF;;;;"}

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

@@ -0,0 +1,4 @@
+export { AbstractCoreRouteValidator, mapAttributeToSchema } from './common';
+export { CoreContentTypeRouteValidator } from './content-type';
+export { CoreComponentRouteValidator } from './component';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core-api/routes/validation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAC5E,OAAO,EAAE,6BAA6B,EAAE,MAAM,gBAAgB,CAAC;AAC/D,OAAO,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC"}