oneentry 1.0.159 → 1.0.161

package/esm/attribute-sets/attributeSetsApi.js

@@ -0,0 +1,97 @@
+import AsyncModules from '../base/asyncModules.js';
+import createSchemaLoader from '../base/lazySchema.js';
+const schema = createSchemaLoader(() => import('./attributeSetsSchemas.js'));
+/**
+ * Controllers for working with attributes - AttributesSetsApi.
+ * @class AttributesSetsApi
+ * @augments AsyncModules
+ * @implements {IAttributesSets}
+ * @description This class provides methods to interact with attribute sets, including fetching attributes, getting attributes by marker, and retrieving single attributes by marker and set.
+ */
+export default class AttributesSetsApi extends AsyncModules {
+    /**
+     * Initializes the AttributesSetsApi with the provided state module.
+     * @class
+     * @class AttributesSetsApi
+     * @param {StateModule} state - The state module containing configuration data.
+     * @description Constructor initializes the AttributesSetsApi with a given state.
+     */
+    constructor(state) {
+        super(state);
+        this._url = state.url + '/api/content/attributes-sets';
+    }
+    /**
+     * Getting all attribute sets objects.
+     * @handleName getAttributes
+     * @param {string} [langCode] - Language code. Default: "en_US".
+     * @param {number} [offset] - parameter offset of record selection. Default: 0.
+     * @param {number} [limit] - parameter limiting the selection of records. Default: 30.
+     * @param {number} [typeId] - identifier of the attribute set type. Default: null.
+     * @param {string} [sortBy] - identifier of the attribute set type. Default: "id".
+     * @returns {Promise<IAttributesSetsResponse | IError>} Returns object with array of IAttributeSetsEntity and total items count.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @see {@link https://js-sdk.oneentry.cloud/docs/attribute-sets/getAttributes getAttributes} documentation.
+     */
+    async getAttributes(langCode = this.state.lang, offset = 0, limit = 30, 
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    typeId = null, sortBy = 'id') {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const query = {
+            langCode,
+            offset,
+            limit,
+            typeId,
+            sortBy,
+        };
+        const result = await this._fetchGet(`?` + this._queryParamsToString(query));
+        // Validate response if validation is enabled
+        const validated = await this._validateResponse(result, schema('AttributeSetsResponseSchema'));
+        return this._normalizeData(validated, langCode);
+    }
+    /**
+     * Getting all attributes with data from the attribute set.
+     * @handleName getAttributesByMarker
+     * @param {string} marker - Attribute marker. Example: "productAttributes".
+     * @param {string} [langCode] - Language code. Default: "en_US".
+     * @returns {Promise<IAttributesSetsEntity[] | IError>} Returns an array of Attributes objects.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @see {@link https://js-sdk.oneentry.cloud/docs/attribute-sets/getAttributesByMarker getAttributesByMarker} documentation.
+     */
+    async getAttributesByMarker(marker, langCode = this.state.lang) {
+        const result = await this._fetchGet(`/${marker}/attributes?langCode=${langCode}`);
+        // Validate response if validation is enabled
+        const validated = await this._validateResponse(result, schema('AttributesArrayResponseSchema'));
+        return this._normalizeData(validated, langCode);
+    }
+    /**
+     * Get a single attribute with data from the attribute sets.
+     * @handleName getSingleAttributeByMarkerSet
+     * @param {string} setMarker - Text identifier (marker) of the attribute set. Example: "productAttributes".
+     * @param {string} attributeMarker - Text identifier (marker) of the attribute in the set. Example: "color".
+     * @param {string} [langCode] - Language code. Default: "en_US".
+     * @returns {Promise<IAttributesSetsEntity | IError>} Returns a single attribute object from the attribute set.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @see {@link https://js-sdk.oneentry.cloud/docs/attribute-sets/getSingleAttributeByMarkerSet getSingleAttributeByMarkerSet} documentation.
+     */
+    async getSingleAttributeByMarkerSet(setMarker, attributeMarker, langCode = this.state.lang) {
+        const result = await this._fetchGet(`/${setMarker}/attributes/${attributeMarker}?langCode=${langCode}`);
+        // Validate response if validation is enabled
+        const validated = await this._validateResponse(result, schema('AttributeEntitySchema'));
+        return this._normalizeData(validated, langCode);
+    }
+    /**
+     * Getting a single object from a set of attributes by marker.
+     * @handleName getAttributeSetByMarker
+     * @param {string} marker - marker of the attribute set object. Example: "productAttributes".
+     * @param {string} [langCode] - Language code. Default: "en_US".
+     * @returns {Promise<IAttributeSetsEntity | IError>} Returns one object of the attribute set.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @see {@link https://js-sdk.oneentry.cloud/docs/attribute-sets/getAttributeSetByMarker getAttributeSetByMarker} documentation.
+     */
+    async getAttributeSetByMarker(marker, langCode = this.state.lang) {
+        const result = await this._fetchGet(`/marker/${marker}?langCode=${langCode}`);
+        // Validate response if validation is enabled
+        const validated = await this._validateResponse(result, schema('AttributeSetEntitySchema'));
+        return this._normalizeData(validated, langCode);
+    }
+}

package/esm/attribute-sets/attributeSetsInterfaces.d.ts

@@ -0,0 +1,285 @@
+import type { IAttributeLocalizeInfo, IError, ITimeIntervalSchedule } from '../base/utils.js';
+/**
+ * Interface for retrieving attributes based on markers and language codes.
+ * @interface IAttributesSets
+ * @description This interface defines methods for retrieving attributes based on markers and language codes.
+ */
+interface IAttributesSets {
+    /**
+     * Fetches attributes by a specific marker.
+     * @handleName getAttributesByMarker
+     * @param {string} marker - The marker used to identify the attribute set. Example: "productAttributes".
+     * @param {string} [langCode] - The language code for localization purposes. Default: 'en_US'.
+     * @returns {IAttributesSetsEntity[]} A promise that resolves to an array of attribute entities or an error.
+     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @description This method fetches attributes by a specific marker.
+     */
+    getAttributesByMarker(marker: string, langCode: string): Promise<IAttributesSetsEntity[] | IError>;
+    /**
+     * Fetches a single attribute by its marker and the set marker.
+     * @handleName getSingleAttributeByMarkerSet
+     * @param {string} attributeMarker - The marker identifying the attribute. Example: "color".
+     * @param {string} setMarker - The marker identifying the attribute set. Example: "productAttributes".
+     * @param {string} [langCode] - The language code for localization purposes. Default: "en_US".
+     * @returns {IAttributesSetsEntity} A promise that resolves to an attribute set entity or an error.
+     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @description This method fetches a single attribute by its marker and the set marker.
+     */
+    getSingleAttributeByMarkerSet(attributeMarker: string, setMarker: string, langCode: string): Promise<IAttributesSetsEntity | IError>;
+}
+/**
+ * Represents the structure of a list item.
+ * @interface IListTitle
+ * @property {string} title - The title or name associated with the list item. Example: "Item Name".
+ * @property {number | string} value - The value of the list item, which can be either a number or a string depending on the context. Example: 42.
+ * @property {string | number | null} position - The position of the list item, which can be represented as a string, number, or null if not applicable. Example: 1.
+ * @property {object} extended - An object containing additional properties or metadata related to the list item. This could include any extra details that extend the basic information.
+ * @property {string | null} extended.value - The extended value, which can be a string or null. Example: "extra_value".
+ * @property {string | null} extended.type - The type of the extended value, which can be a string or null. Example: "color".
+ * @description This interface defines the structure of a list item, which includes properties for the title, value, position, and extended information.
+ */
+interface IListTitle {
+    title: string;
+    value: number | string | IListTitleEntityValue;
+    position?: string | number | null;
+    extended?: IListTitleExtended;
+}
+/**
+ * @interface IListTitleEntityValue
+ * @property {number | string} id - Identifier of the linked entity. Example: 10 or "p-10-2954".
+ * @property {number} depth - Nesting depth of the entity. Example: 1.
+ * @property {boolean} isPinned - Whether the entry is pinned in the list. Example: false.
+ * @property {number | null} parentId - Parent entity id, or null for top-level. Example: 10.
+ * @property {number | string} position - Sort position; numeric for products, lex-sortable string for categories.
+ * @property {boolean} [selected] - Whether the entry is currently selected. Optional.
+ * @description Object value used by `entity`-type {@link IListTitle} entries.
+ */
+interface IListTitleEntityValue {
+    id: number | string;
+    depth: number;
+    isPinned: boolean;
+    parentId: number | null;
+    position: number | string;
+    selected?: boolean;
+}
+/**
+ * @interface IListTitleExtended
+ * @property {string | null} value - Extended value associated with the list option (e.g. a hex color, code or extra label). Example: "#ff0000".
+ * @property {string | null} type - Type of the extended value. Example: "color".
+ * @description Optional extended payload attached to a {@link IListTitle} option.
+ */
+interface IListTitleExtended {
+    value: string | null;
+    type: string | null;
+}
+/**
+ * Defines the possible values for attribute types used in the system.
+ * @type {AttributeType}
+ * @description This type defines the possible values for attribute types used in the system.
+ */
+type AttributeType = 'string' | 'text' | 'textWithHeader' | 'integer' | 'real' | 'float' | 'dateTime' | 'date' | 'time' | 'file' | 'image' | 'groupOfImages' | 'radioButton' | 'list' | 'button' | 'spam' | 'entity' | 'timeInterval';
+/**
+ * Represents an attribute set entity.
+ * @interface IAttributesSetsEntity
+ * @property {AttributeType} type - Attribute type. Example: "string", "text", "integer", "etc".
+ * @property {unknown} [value] - Value of the attribute, normalized the same way as an entity attribute value: `number | null` for numeric types, the file object itself for a single-file `image`/`file`, `null` when the attribute carries no value.
+ * @property {unknown} initialValue - Initial value of the attribute.
+ * @property {string} marker - Textual identifier of the attribute (marker). Example: "color", "size", "etc".
+ * @property {number} position - Position number for sorting. Example: 1.
+ * @property {IListTitle[]} listTitles - Array of values (with extended data) for list and radioButton attributes; empty array for non-list types.
+ * @example
+    [
+      {
+        "title": "red",
+        "value": 1,
+        "position": 1,
+        "extendedValue": null,
+        "extendedValueType": null
+      },
+      {
+        "title": "yellow",
+        "value": 2,
+        "position": 2,
+        "extendedValue": null,
+        "extendedValueType": null
+      }
+    ]
+ * @property {IAttributeValidators} validators - Set of validators for validation; empty object when no validators are configured.
+ * @example
+    {
+      "requiredValidator": {
+        "strict": true
+      },
+      "defaultValueValidator": {
+        "fieldDefaultValue": 11
+      }
+    }
+ * @property {IAttributeLocalizeInfo} localizeInfos - The name of the template, taking into account localization.
+ * @example
+   {
+     "title": "My attribute"
+   }
+ * @property {Record<string, IAttributesSetsEntity>} additionalFields - Nested sub-attributes keyed by marker; empty object when none.
+ * @description This interface defines the structure of an attribute set entity, including its type, marker, position, validators, localization information, list titles, additional fields, and settings.
+ */
+interface IAttributesSetsEntity {
+    type: AttributeType;
+    value?: unknown;
+    initialValue: unknown;
+    marker: string;
+    position: number;
+    listTitles: IListTitle[];
+    validators: IAttributeValidators;
+    localizeInfos: IAttributeLocalizeInfo;
+    additionalFields: Record<string, IAttributesSetsEntity>;
+}
+/**
+ * @interface IAttributeSchemaItem
+ * @property {number} id - Unique identifier of the schema item. Example: 1.
+ * @property {string} identifier - Field marker (machine name) within the schema. Example: "name".
+ * @property {unknown} [initialValue] - Default value applied when the field is not filled. Optional — absent on some fields.
+ * @property {boolean} [isPrice] - Whether the field's numeric value is treated as the price for product entities. Optional — present on product (`forProducts`) attribute sets. Example: false.
+ * @property {boolean} isVisible - Whether the field is exposed in the public API/UI. Example: true.
+ * @property {IAttributeLocalizeInfo} localizeInfos - Localized labels for the field.
+ * @property {boolean} original - Whether the field is part of the original (system) schema, not a user extension. Example: true.
+ * @property {AttributeType} type - Attribute data type (e.g. "string", "file").
+ * @property {number} [position] - Sort position of the field inside the set. Optional. Example: 1.
+ * @property {IListTitle[]} [listTitles] - Options for `list`/`radioButton`/`entity` fields (with extended data or linked-entity values). Optional.
+ * @property {string} [listType] - For `entity` fields — how the option list is organized. Optional. Example: "nested".
+ * @property {string} [moduleIdentifier] - For `entity` fields — identifier of the module the linked entities are taken from. Optional. Example: "catalog".
+ * @property {number | null} [parentId] - Identifier of the parent field, `null` for top-level. Optional, seen on `groupOfImages` fields.
+ * @property {Record<string, IAttributeSchemaItem>} [additionalFields] - Nested sub-fields keyed by marker. Optional.
+ * @property {IAttributeValidators} [validators] - Validation rules for the field. Optional.
+ * @property {boolean | string} [splitUnit] - Splitting unit configuration; `false` when disabled, otherwise the unit name (e.g. "percent"). Optional, used by numeric fields.
+ * @property {number[] | boolean} [splitParts] - For split-price fields — ids of the schema fields the price is split into (e.g. [2, 3]); `false` when the field does not split. Optional.
+ * @property {boolean} [isCurrency] - Whether the field stores currency values. Optional.
+ * @property {boolean} [splitPrice] - Whether the price is split between several fields. Optional.
+ * @property {boolean} [isCompress] - Whether uploaded images are compressed. Optional, used by `image`/`groupOfImages` fields.
+ * @property {boolean} [receiveValues] - For `timeInterval` fields — whether the field receives precomputed values. Optional.
+ * @property {ITimeIntervalSchedule[]} [intervals] - For `timeInterval` fields — top-level schedule definition (separate from `localizeInfos.intervals`). Optional.
+ * @property {unknown} [value] - Current value of the field: `null` on numeric fields without a value, an array of schedule groups on `timeInterval` fields. Optional.
+ * @description Definition of a single field inside an attribute set's schema.
+ */
+interface IAttributeSchemaItem {
+    id: number;
+    identifier: string;
+    initialValue?: unknown;
+    isPrice?: boolean;
+    isVisible: boolean;
+    localizeInfos: IAttributeLocalizeInfo;
+    original: boolean;
+    type: AttributeType;
+    position?: number;
+    listTitles?: IListTitle[];
+    listType?: string;
+    moduleIdentifier?: string;
+    parentId?: number | null;
+    additionalFields?: Record<string, IAttributeSchemaItem>;
+    validators?: IAttributeValidators;
+    splitUnit?: boolean | string;
+    splitParts?: number[] | boolean;
+    isCurrency?: boolean;
+    splitPrice?: boolean;
+    isCompress?: boolean;
+    receiveValues?: boolean;
+    intervals?: ITimeIntervalSchedule[];
+    value?: unknown;
+}
+/**
+ * @interface IAttributeValidators
+ * @property {object} [requiredValidator] - Marks the field as required. Shape: `{ strict: boolean }`. Example: `{ strict: true }`.
+ * @property {object} [stringInspectionValidator] - Length constraints for string fields. Shape: `{ stringMin: number; stringMax: number; stringLength: number }`.
+ * @property {boolean} [emailInspectionValidator] - Toggle for email-format validation.
+ * @property {object} [defaultValueValidator] - Default value configuration with optional custom error text. Shape: `{ customErrorText?: string; fieldDefaultValue?: unknown; fieldDefaultValue2?: unknown }`.
+ * @description Map of validators applied to an attribute or form field. Set is extensible — additional validator types may be added by the API.
+ */
+interface IAttributeValidators {
+    requiredValidator?: {
+        strict: boolean;
+    };
+    stringInspectionValidator?: {
+        stringMin: number;
+        stringMax: number;
+        stringLength: number;
+    };
+    emailInspectionValidator?: boolean;
+    defaultValueValidator?: {
+        customErrorText?: string;
+        fieldDefaultValue?: unknown;
+        fieldDefaultValue2?: unknown;
+    };
+    [key: string]: unknown;
+}
+/**
+ * Represents an attribute set entity.
+ * @interface IAttributeSetsEntity
+ * @property {number} id - The unique identifier of the attribute set entity. Example: 123.
+ * @property {string} createdDate - The date when the attribute set was created. Example: "2023-10-01T12:00:00Z".
+ * @property {string} updatedDate - The date when the attribute set was last updated. Example: "2023-10-01T12:00:00Z".
+ * @property {number} version - The version number of the attribute set, used for tracking changes or updates. Example: 1.
+ * @property {string} identifier - A string that uniquely identifies the attribute set. Example: "attributeSet1".
+ * @property {string} title - The title or name of the attribute set. Example: "Product Attributes".
+ * @property {Record<string, IAttributeSchemaItem>} schema - Schema fields keyed by marker.
+ * @example
+   {
+     "attribute1": {
+       "id": 1,
+       "type": "string",
+       "isPrice": false,
+       "original": true,
+       "identifier": "string",
+       "localizeInfos": {
+         "en_US": { "title": "String" }
+       }
+     }
+   }
+ * @property {boolean} isVisible - Indicates whether the attribute set is visible or not. Example: true.
+ * @property {string} type - The type of the attribute set, which could be a specific classification or category. Example: "product", "user", "etc".
+ * @property {number} position - The position number for sorting the attribute set. Example: 1.
+ * @description This interface defines the structure of an attribute set entity.
+ */
+interface IAttributeSetsEntity {
+    id: number;
+    createdDate: string;
+    updatedDate: string;
+    version: number;
+    identifier: string;
+    title: string;
+    schema: Record<string, IAttributeSchemaItem>;
+    isVisible: boolean;
+    type: IAttributeSetTypeRef;
+    position: number;
+}
+/**
+ * @interface IAttributeSetTypeRef
+ * @property {number} id - Internal type identifier. Example: 1.
+ * @property {string} type - Type identifier (e.g. "forAdmins", "forForms", "forProducts"). Example: "forAdmins".
+ * @description Reference to the attribute set type — defines what entity the set is bound to.
+ */
+interface IAttributeSetTypeRef {
+    id: number;
+    type: string;
+}
+/**
+ * Represents the response structure for attribute sets.
+ * @interface IAttributesSetsResponse
+ * @property {number} total - Total items. Example: 100.
+ * @property {IAttributeSetsEntity[]} items - IAttributeSetsEntity array containing attribute set entities.
+ * @example
+    [
+     {
+       "id": 1,
+       "identifier": "set1"
+     },
+     {
+       "id": 2,
+       "identifier": "set2"
+     }
+   ]
+ * @description This interface defines the structure of a response object for attribute sets.
+ */
+interface IAttributesSetsResponse {
+    total: number;
+    items: IAttributeSetsEntity[];
+}
+export type { AttributeType, IAttributeSchemaItem, IAttributeSetsEntity, IAttributeSetTypeRef, IAttributesSets, IAttributesSetsEntity, IAttributesSetsResponse, IAttributeValidators, IListTitle, IListTitleEntityValue, IListTitleExtended, };

package/esm/attribute-sets/attributeSetsInterfaces.js

@@ -0,0 +1 @@
+export {};

package/esm/attribute-sets/attributeSetsSchemas.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Validation schemas for AttributeSets module
+ * @description Zod schemas for validating attribute sets-related API responses
+ */
+import { z } from 'zod';
+/**
+ * List title schema for list and radioButton attributes
+ */
+export declare const ListTitleSchema: z.ZodObject<{
+    title: z.ZodString;
+    value: z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>;
+    position: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodNull]>;
+    extended: z.ZodObject<{
+        value: z.ZodNullable<z.ZodString>;
+        type: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/**
+ * Attribute entity schema (single attribute from a set)
+ */
+export declare const AttributeEntitySchema: z.ZodObject<{
+    type: z.ZodString;
+    value: z.ZodOptional<z.ZodAny>;
+    initialValue: z.ZodAny;
+    marker: z.ZodString;
+    position: z.ZodNumber;
+    listTitles: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodAny>, z.ZodRecord<z.ZodString, z.ZodAny>]>>;
+    validators: z.ZodOptional<z.ZodUnion<readonly [z.ZodRecord<z.ZodString, z.ZodAny>, z.ZodArray<z.ZodAny>]>>;
+    localizeInfos: z.ZodUnion<readonly [z.ZodRecord<z.ZodString, z.ZodAny>, z.ZodArray<z.ZodAny>]>;
+    additionalFields: z.ZodOptional<z.ZodUnion<readonly [z.ZodRecord<z.ZodString, z.ZodAny>, z.ZodArray<z.ZodAny>]>>;
+}, z.core.$strip>;
+/**
+ * Attribute set entity schema (attribute set object)
+ */
+export declare const AttributeSetEntitySchema: z.ZodObject<{
+    id: z.ZodNumber;
+    createdDate: z.ZodString;
+    updatedDate: z.ZodString;
+    version: z.ZodNumber;
+    identifier: z.ZodString;
+    title: z.ZodString;
+    schema: z.ZodObject<{}, z.core.$loose>;
+    isVisible: z.ZodBoolean;
+    type: z.ZodObject<{
+        id: z.ZodNumber;
+        type: z.ZodString;
+    }, z.core.$strip>;
+    position: z.ZodNumber;
+}, z.core.$strip>;
+/**
+ * Attributes response schema (for getAttributes method)
+ */
+export declare const AttributeSetsResponseSchema: z.ZodObject<{
+    total: z.ZodNumber;
+    items: z.ZodArray<z.ZodObject<{
+        id: z.ZodNumber;
+        createdDate: z.ZodString;
+        updatedDate: z.ZodString;
+        version: z.ZodNumber;
+        identifier: z.ZodString;
+        title: z.ZodString;
+        schema: z.ZodObject<{}, z.core.$loose>;
+        isVisible: z.ZodBoolean;
+        type: z.ZodObject<{
+            id: z.ZodNumber;
+            type: z.ZodString;
+        }, z.core.$strip>;
+        position: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * Attributes array response schema (for getAttributesByMarker method)
+ */
+export declare const AttributesArrayResponseSchema: z.ZodArray<z.ZodObject<{
+    type: z.ZodString;
+    value: z.ZodOptional<z.ZodAny>;
+    initialValue: z.ZodAny;
+    marker: z.ZodString;
+    position: z.ZodNumber;
+    listTitles: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodAny>, z.ZodRecord<z.ZodString, z.ZodAny>]>>;
+    validators: z.ZodOptional<z.ZodUnion<readonly [z.ZodRecord<z.ZodString, z.ZodAny>, z.ZodArray<z.ZodAny>]>>;
+    localizeInfos: z.ZodUnion<readonly [z.ZodRecord<z.ZodString, z.ZodAny>, z.ZodArray<z.ZodAny>]>;
+    additionalFields: z.ZodOptional<z.ZodUnion<readonly [z.ZodRecord<z.ZodString, z.ZodAny>, z.ZodArray<z.ZodAny>]>>;
+}, z.core.$strip>>;

package/esm/attribute-sets/attributeSetsSchemas.js

@@ -0,0 +1,66 @@
+/**
+ * Validation schemas for AttributeSets module
+ * @description Zod schemas for validating attribute sets-related API responses
+ */
+import { z } from 'zod';
+/**
+ * List title schema for list and radioButton attributes
+ */
+export const ListTitleSchema = z.object({
+    title: z.string(),
+    value: z.union([z.number(), z.string()]),
+    position: z.union([z.string(), z.number(), z.null()]),
+    extended: z.object({
+        value: z.string().nullable(),
+        type: z.string().nullable(),
+    }),
+});
+/**
+ * Attribute entity schema (single attribute from a set)
+ */
+export const AttributeEntitySchema = z.object({
+    type: z.string(),
+    value: z.any().optional(),
+    initialValue: z.any(),
+    marker: z.string(),
+    position: z.number(),
+    listTitles: z
+        .union([z.array(z.any()), z.record(z.string(), z.any())])
+        .optional(),
+    validators: z
+        .union([z.record(z.string(), z.any()), z.array(z.any())])
+        .optional(),
+    localizeInfos: z.union([z.record(z.string(), z.any()), z.array(z.any())]),
+    additionalFields: z
+        .union([z.record(z.string(), z.any()), z.array(z.any())])
+        .optional(),
+});
+/**
+ * Attribute set entity schema (attribute set object)
+ */
+export const AttributeSetEntitySchema = z.object({
+    id: z.number(),
+    createdDate: z.string(),
+    updatedDate: z.string(),
+    version: z.number(),
+    identifier: z.string(),
+    title: z.string(),
+    schema: z.object({}).passthrough(),
+    isVisible: z.boolean(),
+    type: z.object({
+        id: z.number(),
+        type: z.string(),
+    }),
+    position: z.number(),
+});
+/**
+ * Attributes response schema (for getAttributes method)
+ */
+export const AttributeSetsResponseSchema = z.object({
+    total: z.number(),
+    items: z.array(AttributeSetEntitySchema),
+});
+/**
+ * Attributes array response schema (for getAttributesByMarker method)
+ */
+export const AttributesArrayResponseSchema = z.array(AttributeEntitySchema);