@strapi/core 5.18.1 → 5.20.0

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

@@ -0,0 +1,105 @@
+import type { Core, UID } from '@strapi/types';
+import { AbstractRouteValidator } from '@strapi/utils';
+import * as z from 'zod/v4';
+/**
+ * AbstractCoreRouteValidator provides the foundation for validating and managing core routes within a Strapi context for a specific model.
+ *
+ * This abstract class extends the base AbstractRouteValidator from utils to add schema-aware 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> extends AbstractRouteValidator {
+    /**
+     * 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.
+     */
+    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<{
+        [x: string]: 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<{
+        [x: string]: 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<{
+        [x: string]: string;
+    }>>;
+    /**
+     * 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<{
+        [x: string]: string;
+    }>>;
+    /**
+     * 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 ? import("@strapi/types/dist/schema").ContentType<T> : T extends `${string}.${string}` ? import("@strapi/types/dist/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]: import("@strapi/types/dist/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]: import("@strapi/types/dist/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<{
+        [x: string]: string;
+    }>, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
+}
+//# 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,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAE/C,OAAO,EAAgB,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B;;;;;;;;;GASG;AACH,8BAAsB,0BAA0B,CAC9C,CAAC,SAAS,GAAG,CAAC,MAAM,CACpB,SAAQ,sBAAsB;IAC9B;;;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;gBACgB,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC;IAM9C;;;;OAIG;IACH,IAAW,gBAAgB;;OAE1B;IAED;;;;OAIG;IACH,IAAW,qBAAqB;;OAE/B;IAED;;;;OAIG;IACH,IAAW,iBAAiB;;QAE3B;IAED;;;;OAIG;IACH,IAAW,sBAAsB;;QAEhC;IAED;;;;;;;OAOG;IACH,SAAS,KAAK,OAAO,gLAEpB;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"}

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

@@ -0,0 +1,116 @@
+'use strict';
+
+var strapiUtils = require('@strapi/utils');
+var z = require('zod/v4');
+
+function _interopNamespaceDefault(e) {
+  var n = Object.create(null);
+  if (e) {
+    Object.keys(e).forEach(function (k) {
+      if (k !== 'default') {
+        var d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: function () { return e[k]; }
+        });
+      }
+    });
+  }
+  n.default = e;
+  return Object.freeze(n);
+}
+
+var z__namespace = /*#__PURE__*/_interopNamespaceDefault(z);
+
+/**
+ * AbstractCoreRouteValidator provides the foundation for validating and managing core routes within a Strapi context for a specific model.
+ *
+ * This abstract class extends the base AbstractRouteValidator from utils to add schema-aware 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 extends strapiUtils.AbstractRouteValidator {
+    /**
+   * 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__namespace.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__namespace.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__namespace.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__namespace.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 z__namespace.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){
+        super();
+        this._strapi = strapi;
+        this._uid = uid;
+    }
+}
+
+exports.AbstractCoreRouteValidator = AbstractCoreRouteValidator;
+//# 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, UID } from '@strapi/types';\n\nimport { contentTypes, AbstractRouteValidator } from '@strapi/utils';\nimport * as z from 'zod/v4';\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 extends the base AbstractRouteValidator from utils to add schema-aware validation\n * 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<\n  T extends UID.Schema,\n> extends AbstractRouteValidator {\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  public constructor(strapi: Core.Strapi, uid: T) {\n    super();\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"],"names":["AbstractCoreRouteValidator","AbstractRouteValidator","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"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAKA;;;;;;;;;IAUO,MAAeA,0BAEZC,SAAAA,kCAAAA,CAAAA;AA2BR;;;;AAIC,MACD,IAAWC,gBAAmB,GAAA;QAC5B,OAAOC,YAAAA,CAAEC,IAAI,CAACC,MAAAA,CAAOC,IAAI,CAAC,IAAI,CAACC,aAAa,CAAA,CAAA;AAC9C;AAEA;;;;AAIC,MACD,IAAWC,qBAAwB,GAAA;QACjC,OAAOL,YAAAA,CAAEC,IAAI,CAACC,MAAAA,CAAOC,IAAI,CAAC,IAAI,CAACG,kBAAkB,CAAA,CAAA;AACnD;AAEA;;;;AAIC,MACD,IAAWC,iBAAoB,GAAA;AAC7B,QAAA,OAAOP,YAAEQ,CAAAA,KAAK,CAAC,IAAI,CAACT,gBAAgB,CAAA;AACtC;AAEA;;;;AAIC,MACD,IAAWU,sBAAyB,GAAA;AAClC,QAAA,OAAOT,YAAEQ,CAAAA,KAAK,CAAC,IAAI,CAACH,qBAAqB,CAAA;AAC3C;AAEA;;;;;;;AAOC,MACD,IAAcK,OAAU,GAAA;QACtB,OAAO,IAAI,CAACC,OAAO,CAACC,QAAQ,CAAC,IAAI,CAACC,IAAI,CAAA;AACxC;AAEA;;;;;;AAMC,MACD,IAAcT,aAAgB,GAAA;QAC5B,MAAMU,UAAAA,GAAaZ,OAAOa,OAAO,CAAC,IAAI,CAACL,OAAO,CAACI,UAAU,CAAA;QAEzD,MAAME,aAAAA,GAAgBF,UACnBG,CAAAA,MAAM,CAAC,CAAC,GAAGC,SAAU,CAAA,GAAKC,wBAAaC,CAAAA,iBAAiB,CAACF,SAAAA,CAAAA,CAAAA,CACzDD,MAAM,CAAC,CAAC,CAACI,aAAAA,CAAc,GAAK,CAACF,wBAAaG,CAAAA,kBAAkB,CAAC,IAAI,CAACZ,OAAO,EAAEW,aAAAA,CAAAA,CAAAA;QAE9E,OAAOnB,MAAAA,CAAOqB,WAAW,CAACP,aAAAA,CAAAA;AAC5B;AAEA;;;;;;AAMC,MACD,IAAcV,kBAAqB,GAAA;QACjC,MAAMQ,UAAAA,GAAaZ,OAAOa,OAAO,CAAC,IAAI,CAACL,OAAO,CAACI,UAAU,CAAA;QAEzD,MAAMU,kBAAAA,GAAqBV,UACxBG,CAAAA,MAAM,CAAC,CAAC,GAAGC,SAAAA,CAAU,GAAK,CAACC,wBAAaC,CAAAA,iBAAiB,CAACF,SAAAA,CAAAA,CAAAA,CAC1DD,MAAM,CAAC,CAAC,CAACI,aAAAA,CAAc,GAAK,CAACF,wBAAaG,CAAAA,kBAAkB,CAAC,IAAI,CAACZ,OAAO,EAAEW,aAAAA,CAAAA,CAAAA;QAE9E,OAAOnB,MAAAA,CAAOqB,WAAW,CAACC,kBAAAA,CAAAA;AAC5B;AAEA;;;;;MAMOC,WAAYC,CAAAA,IAAkB,EAAE;AACrC,QAAA,OAAO1B,aAAE2B,MAAM,CAAC,IAAI,CAAC5B,gBAAgB,EAAE2B,IAAAA,CAAAA;AACzC;AAtGA;;;;;AAKC,MACD,WAAmBE,CAAAA,MAAmB,EAAEC,GAAM,CAAE;QAC9C,KAAK,EAAA;QACL,IAAI,CAAClB,OAAO,GAAGiB,MAAAA;QACf,IAAI,CAACf,IAAI,GAAGgB,GAAAA;AACd;AA6FF;;;;"}

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

@@ -0,0 +1,95 @@
+import { AbstractRouteValidator, contentTypes } from '@strapi/utils';
+import * as z from 'zod/v4';
+
+/**
+ * AbstractCoreRouteValidator provides the foundation for validating and managing core routes within a Strapi context for a specific model.
+ *
+ * This abstract class extends the base AbstractRouteValidator from utils to add schema-aware 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 extends AbstractRouteValidator {
+    /**
+   * 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){
+        super();
+        this._strapi = strapi;
+        this._uid = uid;
+    }
+}
+
+export { AbstractCoreRouteValidator };
+//# 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, UID } from '@strapi/types';\n\nimport { contentTypes, AbstractRouteValidator } from '@strapi/utils';\nimport * as z from 'zod/v4';\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 extends the base AbstractRouteValidator from utils to add schema-aware validation\n * 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<\n  T extends UID.Schema,\n> extends AbstractRouteValidator {\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  public constructor(strapi: Core.Strapi, uid: T) {\n    super();\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"],"names":["AbstractCoreRouteValidator","AbstractRouteValidator","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"],"mappings":";;;AAKA;;;;;;;;;IAUO,MAAeA,0BAEZC,SAAAA,sBAAAA,CAAAA;AA2BR;;;;AAIC,MACD,IAAWC,gBAAmB,GAAA;QAC5B,OAAOC,CAAAA,CAAEC,IAAI,CAACC,MAAAA,CAAOC,IAAI,CAAC,IAAI,CAACC,aAAa,CAAA,CAAA;AAC9C;AAEA;;;;AAIC,MACD,IAAWC,qBAAwB,GAAA;QACjC,OAAOL,CAAAA,CAAEC,IAAI,CAACC,MAAAA,CAAOC,IAAI,CAAC,IAAI,CAACG,kBAAkB,CAAA,CAAA;AACnD;AAEA;;;;AAIC,MACD,IAAWC,iBAAoB,GAAA;AAC7B,QAAA,OAAOP,CAAEQ,CAAAA,KAAK,CAAC,IAAI,CAACT,gBAAgB,CAAA;AACtC;AAEA;;;;AAIC,MACD,IAAWU,sBAAyB,GAAA;AAClC,QAAA,OAAOT,CAAEQ,CAAAA,KAAK,CAAC,IAAI,CAACH,qBAAqB,CAAA;AAC3C;AAEA;;;;;;;AAOC,MACD,IAAcK,OAAU,GAAA;QACtB,OAAO,IAAI,CAACC,OAAO,CAACC,QAAQ,CAAC,IAAI,CAACC,IAAI,CAAA;AACxC;AAEA;;;;;;AAMC,MACD,IAAcT,aAAgB,GAAA;QAC5B,MAAMU,UAAAA,GAAaZ,OAAOa,OAAO,CAAC,IAAI,CAACL,OAAO,CAACI,UAAU,CAAA;QAEzD,MAAME,aAAAA,GAAgBF,UACnBG,CAAAA,MAAM,CAAC,CAAC,GAAGC,SAAU,CAAA,GAAKC,YAAaC,CAAAA,iBAAiB,CAACF,SAAAA,CAAAA,CAAAA,CACzDD,MAAM,CAAC,CAAC,CAACI,aAAAA,CAAc,GAAK,CAACF,YAAaG,CAAAA,kBAAkB,CAAC,IAAI,CAACZ,OAAO,EAAEW,aAAAA,CAAAA,CAAAA;QAE9E,OAAOnB,MAAAA,CAAOqB,WAAW,CAACP,aAAAA,CAAAA;AAC5B;AAEA;;;;;;AAMC,MACD,IAAcV,kBAAqB,GAAA;QACjC,MAAMQ,UAAAA,GAAaZ,OAAOa,OAAO,CAAC,IAAI,CAACL,OAAO,CAACI,UAAU,CAAA;QAEzD,MAAMU,kBAAAA,GAAqBV,UACxBG,CAAAA,MAAM,CAAC,CAAC,GAAGC,SAAAA,CAAU,GAAK,CAACC,YAAaC,CAAAA,iBAAiB,CAACF,SAAAA,CAAAA,CAAAA,CAC1DD,MAAM,CAAC,CAAC,CAACI,aAAAA,CAAc,GAAK,CAACF,YAAaG,CAAAA,kBAAkB,CAAC,IAAI,CAACZ,OAAO,EAAEW,aAAAA,CAAAA,CAAAA;QAE9E,OAAOnB,MAAAA,CAAOqB,WAAW,CAACC,kBAAAA,CAAAA;AAC5B;AAEA;;;;;MAMOC,WAAYC,CAAAA,IAAkB,EAAE;AACrC,QAAA,OAAO1B,EAAE2B,MAAM,CAAC,IAAI,CAAC5B,gBAAgB,EAAE2B,IAAAA,CAAAA;AACzC;AAtGA;;;;;AAKC,MACD,WAAmBE,CAAAA,MAAmB,EAAEC,GAAM,CAAE;QAC9C,KAAK,EAAA;QACL,IAAI,CAAClB,OAAO,GAAGiB,MAAAA;QACf,IAAI,CAACf,IAAI,GAAGgB,GAAAA;AACd;AA6FF;;;;"}

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

@@ -0,0 +1,34 @@
+import type { UID } from '@strapi/types';
+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> {
+    /**
+     * 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(): import("zod/v4").ZodObject<{}, import("zod/v4/core").$strip>;
+}
+//# 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,GAAG,EAAE,MAAM,eAAe,CAAC;AAIzC,OAAO,EAAE,0BAA0B,EAAE,MAAM,UAAU,CAAC;AAEtD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,2BAA4B,SAAQ,0BAA0B,CAAC,GAAG,CAAC,SAAS,CAAC;IACxF;;;;;;;;;;;;OAYG;IACH,IAAI,KAAK,iEAMR;CACF"}

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

@@ -0,0 +1,45 @@
+'use strict';
+
+var mappers = require('./mappers.js');
+var common = require('./common.js');
+
+// eslint-disable-next-line import/no-cycle
+/**
+ * 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;
+ * ```
+ */ class CoreComponentRouteValidator extends common.AbstractCoreRouteValidator {
+    /**
+   * 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() {
+        const { _scalarFields, _populatableFields } = this;
+        const entries = Object.entries({
+            ..._scalarFields,
+            ..._populatableFields
+        });
+        return mappers.createAttributesSchema(entries);
+    }
+}
+
+exports.CoreComponentRouteValidator = CoreComponentRouteValidator;
+//# sourceMappingURL=component.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"component.js","sources":["../../../../src/core-api/routes/validation/component.ts"],"sourcesContent":["import type { UID } from '@strapi/types';\n\n// eslint-disable-next-line import/no-cycle\nimport { createAttributesSchema } from './mappers';\nimport { AbstractCoreRouteValidator } from './common';\n\n/**\n * A component validator for core content-type routes.\n *\n * Provides validation schemas and utilities for handling component-specific validation in content-type routes.\n *\n * @example\n * ```ts\n * const strapi = // ... strapi instance\n * const uid = 'api::article.article'\n * const validator = new CoreComponentRouteValidator(strapi, uid);\n *\n * // Get validation schema for a component entry\n * const componentSchema = validator.component;\n * ```\n */\nexport class CoreComponentRouteValidator extends AbstractCoreRouteValidator<UID.Component> {\n  /**\n   * Generates a comprehensive validation schema for a single component entry.\n   *\n   * Combines scalar fields and populatable fields into a single schema.\n   *\n   * @returns A schema for validating complete entries\n   *\n   * @example\n   * ```ts\n   * const validator = new CoreComponentRouteValidator(strapi, uid);\n   * const entrySchema = validator.entry;\n   * ```\n   */\n  get entry() {\n    const { _scalarFields, _populatableFields } = this;\n\n    const entries = Object.entries({ ..._scalarFields, ..._populatableFields });\n\n    return createAttributesSchema(entries);\n  }\n}\n"],"names":["CoreComponentRouteValidator","AbstractCoreRouteValidator","entry","_scalarFields","_populatableFields","entries","Object","createAttributesSchema"],"mappings":";;;;;AAEA;AAIA;;;;;;;;;;;;;;IAeO,MAAMA,2BAAoCC,SAAAA,iCAAAA,CAAAA;AAC/C;;;;;;;;;;;;AAYC,MACD,IAAIC,KAAQ,GAAA;AACV,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;AAEzE,QAAA,OAAOG,8BAAuBF,CAAAA,OAAAA,CAAAA;AAChC;AACF;;;;"}

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

@@ -0,0 +1,43 @@
+import { createAttributesSchema } from './mappers.mjs';
+import { AbstractCoreRouteValidator } from './common.mjs';
+
+// eslint-disable-next-line import/no-cycle
+/**
+ * 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;
+ * ```
+ */ class CoreComponentRouteValidator extends AbstractCoreRouteValidator {
+    /**
+   * 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() {
+        const { _scalarFields, _populatableFields } = this;
+        const entries = Object.entries({
+            ..._scalarFields,
+            ..._populatableFields
+        });
+        return createAttributesSchema(entries);
+    }
+}
+
+export { CoreComponentRouteValidator };
+//# sourceMappingURL=component.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"component.mjs","sources":["../../../../src/core-api/routes/validation/component.ts"],"sourcesContent":["import type { UID } from '@strapi/types';\n\n// eslint-disable-next-line import/no-cycle\nimport { createAttributesSchema } from './mappers';\nimport { AbstractCoreRouteValidator } from './common';\n\n/**\n * A component validator for core content-type routes.\n *\n * Provides validation schemas and utilities for handling component-specific validation in content-type routes.\n *\n * @example\n * ```ts\n * const strapi = // ... strapi instance\n * const uid = 'api::article.article'\n * const validator = new CoreComponentRouteValidator(strapi, uid);\n *\n * // Get validation schema for a component entry\n * const componentSchema = validator.component;\n * ```\n */\nexport class CoreComponentRouteValidator extends AbstractCoreRouteValidator<UID.Component> {\n  /**\n   * Generates a comprehensive validation schema for a single component entry.\n   *\n   * Combines scalar fields and populatable fields into a single schema.\n   *\n   * @returns A schema for validating complete entries\n   *\n   * @example\n   * ```ts\n   * const validator = new CoreComponentRouteValidator(strapi, uid);\n   * const entrySchema = validator.entry;\n   * ```\n   */\n  get entry() {\n    const { _scalarFields, _populatableFields } = this;\n\n    const entries = Object.entries({ ..._scalarFields, ..._populatableFields });\n\n    return createAttributesSchema(entries);\n  }\n}\n"],"names":["CoreComponentRouteValidator","AbstractCoreRouteValidator","entry","_scalarFields","_populatableFields","entries","Object","createAttributesSchema"],"mappings":";;;AAEA;AAIA;;;;;;;;;;;;;;IAeO,MAAMA,2BAAoCC,SAAAA,0BAAAA,CAAAA;AAC/C;;;;;;;;;;;;AAYC,MACD,IAAIC,KAAQ,GAAA;AACV,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;AAEzE,QAAA,OAAOG,sBAAuBF,CAAAA,OAAAA,CAAAA;AAChC;AACF;;;;"}

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

@@ -0,0 +1,8 @@
+/**
+ * Defines the constant literal values for boolean representations.
+ *
+ * These values can be used to convert string representations of booleans (for example, 'true', 'false', '1', '0')
+ * into actual boolean types.
+ */
+export declare const BOOLEAN_LITERAL_VALUES: readonly ["t", "1", "true", "f", "0", "false"];
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/core-api/routes/validation/constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,sBAAsB,gDAAiD,CAAC"}

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

@@ -0,0 +1,18 @@
+'use strict';
+
+/**
+ * Defines the constant literal values for boolean representations.
+ *
+ * These values can be used to convert string representations of booleans (for example, 'true', 'false', '1', '0')
+ * into actual boolean types.
+ */ const BOOLEAN_LITERAL_VALUES = [
+    't',
+    '1',
+    'true',
+    'f',
+    '0',
+    'false'
+];
+
+exports.BOOLEAN_LITERAL_VALUES = BOOLEAN_LITERAL_VALUES;
+//# sourceMappingURL=constants.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sources":["../../../../src/core-api/routes/validation/constants.ts"],"sourcesContent":["/**\n * Defines the constant literal values for boolean representations.\n *\n * These values can be used to convert string representations of booleans (for example, 'true', 'false', '1', '0')\n * into actual boolean types.\n */\n\nexport const BOOLEAN_LITERAL_VALUES = ['t', '1', 'true', 'f', '0', 'false'] as const;\n"],"names":["BOOLEAN_LITERAL_VALUES"],"mappings":";;AAAA;;;;;UAOaA,sBAAyB,GAAA;AAAC,IAAA,GAAA;AAAK,IAAA,GAAA;AAAK,IAAA,MAAA;AAAQ,IAAA,GAAA;AAAK,IAAA,GAAA;AAAK,IAAA;;;;;"}

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

@@ -0,0 +1,16 @@
+/**
+ * Defines the constant literal values for boolean representations.
+ *
+ * These values can be used to convert string representations of booleans (for example, 'true', 'false', '1', '0')
+ * into actual boolean types.
+ */ const BOOLEAN_LITERAL_VALUES = [
+    't',
+    '1',
+    'true',
+    'f',
+    '0',
+    'false'
+];
+
+export { BOOLEAN_LITERAL_VALUES };
+//# sourceMappingURL=constants.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.mjs","sources":["../../../../src/core-api/routes/validation/constants.ts"],"sourcesContent":["/**\n * Defines the constant literal values for boolean representations.\n *\n * These values can be used to convert string representations of booleans (for example, 'true', 'false', '1', '0')\n * into actual boolean types.\n */\n\nexport const BOOLEAN_LITERAL_VALUES = ['t', '1', 'true', 'f', '0', 'false'] as const;\n"],"names":["BOOLEAN_LITERAL_VALUES"],"mappings":"AAAA;;;;;UAOaA,sBAAyB,GAAA;AAAC,IAAA,GAAA;AAAK,IAAA,GAAA;AAAK,IAAA,MAAA;AAAQ,IAAA,GAAA;AAAK,IAAA,GAAA;AAAK,IAAA;;;;;"}