oneentry 1.0.136 → 1.0.138

package/README.md

@@ -155,6 +155,12 @@ const api = defineOneEntry('your-url', {
 })
 ```
 
+## Optional Features
+
+### API Response Validation
+
+OneEntry SDK supports optional validation of API responses using Zod. This feature is disabled by default and can be enabled for development or critical operations.
+
 ### Errors
 
 If you want to escape errors inside the sc, leave the "errors" property by default.
@@ -174,9 +180,15 @@ const api = defineOneEntry('your-url', {
     errors: {
         isShell: false,
         customErrors: {
-            400: (error) => console.error(error.message),
-            404: (error) => console.error(error.message),
-            500: (error) => console.error(error.message),
+            400: (error) => console.error('Bad Request:', error.message),
+            401: (error) => console.error('Unauthorized:', error.message),
+            403: (error) => console.error('Forbidden:', error.message),
+            404: (error) => console.error('Not Found:', error.message),
+            429: (error) => console.error('Rate Limit Exceeded:', error.message),
+            500: (error) => console.error('Server Error:', error.message),
+            502: (error) => console.error('Bad Gateway:', error.message),
+            503: (error) => console.error('Service Unavailable:', error.message),
+            504: (error) => console.error('Gateway Timeout:', error.message),
         },
     },
 })

package/configure.js

@@ -1,3 +1,23 @@
+#!/usr/bin/env node
+
+/**
+ * OneEntry SDK Configuration Tool
+ *
+ * Interactive CLI tool for initial SDK setup. Prompts the user for:
+ * - Project URL (must include https://)
+ * - Authentication token
+ *
+ * Generates an example.ts file with a TypeScript interface template
+ * containing the provided configuration values.
+ *
+ * Usage:
+ *   npx oneentry
+ *   or
+ *   oneentry (if installed globally)
+ *
+ * @see {@link https://github.com/OneEntry/oneentry-sdk} for more information
+ */
+
 /* eslint-disable no-undef */
 /* eslint-disable @typescript-eslint/no-require-imports */
 
@@ -19,9 +39,13 @@ rl.question('Enter project name with https://... : ', (name) => {
 });
 
 /**
- * Create interface
- * @param {*} name name
- * @param {*} token token
+ * Creates an example TypeScript interface file with SDK configuration
+ *
+ * Generates an example.ts file containing a BuildInterface type and
+ * IAttributesList interface with the provided project name and token.
+ *
+ * @param {string} name - Project URL with https:// (e.g., "https://example.oneentry.cloud")
+ * @param {string} token - Authentication token for API access
  */
 function createInterface(name, token) {
   const filePath = 'example.ts';

package/dist/admins/adminsApi.d.ts

@@ -43,8 +43,8 @@ export default class AdminsApi extends AsyncModules implements IAdmins {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {number} [offset] - Parameter for pagination. Default: 0.
      * @param {number} [limit] - Parameter for pagination. Default: 30.
-     * @returns {IAdminEntity[]} Returns an array of admin objects.
-     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @returns {Promise<IAdminEntity[] | IError>} Returns an array of admin objects.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
      */
     getAdminsInfo(body?: AttributeType[], langCode?: string, offset?: number, limit?: number): Promise<IAdminEntity[] | IError>;
 }

package/dist/admins/adminsApi.js

@@ -4,6 +4,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 const asyncModules_1 = __importDefault(require("../base/asyncModules"));
+const adminsSchemas_1 = require("./adminsSchemas");
 /**
  * Controllers for working with users - admins.
  * @class AdminsApi
@@ -46,8 +47,8 @@ class AdminsApi extends asyncModules_1.default {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {number} [offset] - Parameter for pagination. Default: 0.
      * @param {number} [limit] - Parameter for pagination. Default: 30.
-     * @returns {IAdminEntity[]} Returns an array of admin objects.
-     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @returns {Promise<IAdminEntity[] | IError>} Returns an array of admin objects.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
      */
     async getAdminsInfo(body = [], langCode = this.state.lang, offset = 0, limit = 30) {
         const query = {
@@ -56,7 +57,9 @@ class AdminsApi extends asyncModules_1.default {
             limit,
         };
         const response = await this._fetchPost(`?` + this._queryParamsToString(query), body);
-        return this._normalizeData(response, langCode);
+        // Validate response if validation is enabled
+        const validated = this._validateResponse(response, adminsSchemas_1.AdminsResponseSchema);
+        return this._normalizeData(validated, langCode);
     }
 }
 exports.default = AdminsApi;

package/dist/admins/adminsInterfaces.d.ts

@@ -31,7 +31,7 @@ interface IAdmins {
      * @returns {IAdminEntity[]} Returns an array of admin objects.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      */
-    getAdminsInfo(body: AttributeType[], langCode: string, offset: number, limit: number): Promise<IAdminEntity[] | IError>;
+    getAdminsInfo(body?: AttributeType[], langCode?: string, offset?: number, limit?: number): Promise<IAdminEntity[] | IError>;
 }
 /**
  * Interface representing a Position entity.
@@ -55,7 +55,7 @@ interface IPosition {
 /**
  * Interface representing an Admin Entity.
  * @interface IAdminEntity
- * @property {number | null} id - The identifier of the object. Example: 1764.
+ * @property {number} id - The identifier of the object. Example: 1764.
  * @property {number | null} attributeSetId - The identifier of the attribute set being used. Example: 120.
  * @property {string} identifier - The textual identifier for the record field. Example: "admin1".
  * @property {string | null} attributeSetIdentifier - The identifier of the attribute set. Example: "admins".

package/dist/admins/adminsSchemas.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Validation schemas for Admins module
+ * @description Zod schemas for validating admins-related API responses
+ */
+import { z } from 'zod';
+/**
+ * Admin entity schema
+ * Includes all fields returned by the API
+ */
+export declare const AdminEntitySchema: z.ZodObject<{
+    id: z.ZodNumber;
+    attributeSetId: z.ZodNullable<z.ZodNumber>;
+    identifier: z.ZodString;
+    attributeSetIdentifier: z.ZodNullable<z.ZodString>;
+    position: z.ZodNullable<z.ZodNumber>;
+    isSync: z.ZodBoolean;
+    attributeValues: z.ZodRecord<z.ZodString, z.ZodAny>;
+}, z.core.$catchall<z.ZodAny>>;
+/**
+ * Admins response schema (array of admin entities)
+ */
+export declare const AdminsResponseSchema: z.ZodArray<z.ZodObject<{
+    id: z.ZodNumber;
+    attributeSetId: z.ZodNullable<z.ZodNumber>;
+    identifier: z.ZodString;
+    attributeSetIdentifier: z.ZodNullable<z.ZodString>;
+    position: z.ZodNullable<z.ZodNumber>;
+    isSync: z.ZodBoolean;
+    attributeValues: z.ZodRecord<z.ZodString, z.ZodAny>;
+}, z.core.$catchall<z.ZodAny>>>;

package/dist/admins/adminsSchemas.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AdminsResponseSchema = exports.AdminEntitySchema = void 0;
+/**
+ * Validation schemas for Admins module
+ * @description Zod schemas for validating admins-related API responses
+ */
+const zod_1 = require("zod");
+/**
+ * Admin entity schema
+ * Includes all fields returned by the API
+ */
+exports.AdminEntitySchema = zod_1.z
+    .object({
+    id: zod_1.z.number(),
+    attributeSetId: zod_1.z.number().nullable(),
+    identifier: zod_1.z.string(),
+    attributeSetIdentifier: zod_1.z.string().nullable(),
+    position: zod_1.z.number().nullable(),
+    isSync: zod_1.z.boolean(),
+    attributeValues: zod_1.z.record(zod_1.z.string(), zod_1.z.any()),
+})
+    .catchall(zod_1.z.any()); // Allow additional dynamic properties
+/**
+ * Admins response schema (array of admin entities)
+ */
+exports.AdminsResponseSchema = zod_1.z.array(exports.AdminEntitySchema);

package/dist/attribute-sets/attributeSetsApi.d.ts

@@ -28,8 +28,8 @@ export default class AttributesSetsApi extends AsyncModules implements IAttribut
      * @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 {IAttributesSetsResponse} Returns object with array of IAttributeSetsEntity and total items count.
-     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @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
      */
     getAttributes(langCode?: string, offset?: number, limit?: number, typeId?: any, sortBy?: string): Promise<IAttributesSetsResponse | IError>;
     /**
@@ -37,8 +37,8 @@ export default class AttributesSetsApi extends AsyncModules implements IAttribut
      * @handleName getAttributesByMarker
      * @param {string} marker - Attribute marker. Example: "productAttributes".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @returns {IAttributeSetsEntity[]} Returns an array of Attributes objects.
-     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @returns {Promise<IAttributeSetsEntity[] | IError>} Returns an array of Attributes objects.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
      */
     getAttributesByMarker(marker: string, langCode?: string): Promise<IAttributeSetsEntity[] | IError>;
     /**
@@ -47,8 +47,8 @@ export default class AttributesSetsApi extends AsyncModules implements IAttribut
      * @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 {IAttributesSetsEntity} Returns a single attribute object from the attribute set.
-     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @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
      */
     getSingleAttributeByMarkerSet(setMarker: string, attributeMarker: string, langCode?: string): Promise<IAttributesSetsEntity | IError>;
     /**
@@ -56,8 +56,8 @@ export default class AttributesSetsApi extends AsyncModules implements IAttribut
      * @handleName getAttributeSetByMarker
      * @param {string} marker - marker of the attribute set object. Example: "productAttributes".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @returns {IAttributeSetsEntity} Returns one object of the attribute set.
-     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @returns {Promise<IAttributeSetsEntity | IError>} Returns one object of the attribute set.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
      */
     getAttributeSetByMarker(marker: string, langCode?: string): Promise<IAttributeSetsEntity | IError>;
 }

package/dist/attribute-sets/attributeSetsApi.js

@@ -4,6 +4,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 const asyncModules_1 = __importDefault(require("../base/asyncModules"));
+const attributeSetsSchemas_1 = require("./attributeSetsSchemas");
 /**
  * Controllers for working with attributes - AttributesSetsApi.
  * @class AttributesSetsApi
@@ -31,8 +32,8 @@ class AttributesSetsApi extends asyncModules_1.default {
      * @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 {IAttributesSetsResponse} Returns object with array of IAttributeSetsEntity and total items count.
-     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @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
      */
     async getAttributes(langCode = this.state.lang, offset = 0, limit = 30, 
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
@@ -46,19 +47,23 @@ class AttributesSetsApi extends asyncModules_1.default {
             sortBy,
         };
         const result = await this._fetchGet(`?` + this._queryParamsToString(query));
-        return this._dataPostProcess(result, langCode);
+        // Validate response if validation is enabled
+        const validated = this._validateResponse(result, attributeSetsSchemas_1.AttributeSetsResponseSchema);
+        return this._dataPostProcess(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 {IAttributeSetsEntity[]} Returns an array of Attributes objects.
-     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @returns {Promise<IAttributeSetsEntity[] | IError>} Returns an array of Attributes objects.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
      */
     async getAttributesByMarker(marker, langCode = this.state.lang) {
         const result = await this._fetchGet(`/${marker}/attributes?langCode=${langCode}`);
-        return this._dataPostProcess(result, langCode);
+        // Validate response if validation is enabled
+        const validated = this._validateResponse(result, attributeSetsSchemas_1.AttributesArrayResponseSchema);
+        return this._dataPostProcess(validated, langCode);
     }
     /**
      * Get a single attribute with data from the attribute sets.
@@ -66,24 +71,28 @@ class AttributesSetsApi extends asyncModules_1.default {
      * @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 {IAttributesSetsEntity} Returns a single attribute object from the attribute set.
-     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @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
      */
     async getSingleAttributeByMarkerSet(setMarker, attributeMarker, langCode = this.state.lang) {
         const result = await this._fetchGet(`/${setMarker}/attributes/${attributeMarker}?langCode=${langCode}`);
-        return this._dataPostProcess(result, langCode);
+        // Validate response if validation is enabled
+        const validated = this._validateResponse(result, attributeSetsSchemas_1.AttributeEntitySchema);
+        return this._dataPostProcess(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 {IAttributeSetsEntity} Returns one object of the attribute set.
-     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @returns {Promise<IAttributeSetsEntity | IError>} Returns one object of the attribute set.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
      */
     async getAttributeSetByMarker(marker, langCode = this.state.lang) {
         const result = await this._fetchGet(`/marker/${marker}?langCode=${langCode}`);
-        return this._dataPostProcess(result, langCode);
+        // Validate response if validation is enabled
+        const validated = this._validateResponse(result, attributeSetsSchemas_1.AttributeSetEntitySchema);
+        return this._dataPostProcess(validated, langCode);
     }
 }
 exports.default = AttributesSetsApi;

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

@@ -60,6 +60,7 @@ type AttributeType = 'string' | 'text' | 'textWithHeader' | 'integer' | 'real' |
  * @interface IAttributesSetsEntity
  * @property {AttributeType} type - Attribute type. Example: "string", "text", "integer", "etc".
  * @property {any} [value] - Value of the attribute, which can be of any type.
+ * @property {any} 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[] | Record<string, any>} [listTitles] - Array of values (with extended data) for list and radioButton attributes.
@@ -96,7 +97,6 @@ type AttributeType = 'string' | 'text' | 'textWithHeader' | 'integer' | 'real' |
      "title": "My attribute"
    }
  * @property {Record<string, any>} [additionalFields] - Additional fields for the attribute (optional).
- * @property {Record<string, any>} [settings] - Additional attribute settings (optional).
  * @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 {
@@ -109,13 +109,13 @@ interface IAttributesSetsEntity {
     validators?: Record<string, any>;
     localizeInfos: ILocalizeInfo;
     additionalFields?: Record<string, any>;
-    settings?: Record<string, any>;
 }
 /**
  * Represents an attribute set entity.
  * @interface IAttributeSetsEntity
  * @property {number} id - The unique identifier of the attribute set entity. Example: 123.
- * @property {string} updatedDate - The date when the attribute set was last updated, represented as a string. Example: "2023-10-01T12:00:00Z".
+ * @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 {number} typeId - The numerical identifier representing the type of the attribute set. Example: 1.

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

@@ -0,0 +1,90 @@
+/**
+ * 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>]>>;
+    settings: 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;
+    typeId: z.ZodNumber;
+    title: z.ZodString;
+    schema: z.ZodObject<{}, z.core.$loose>;
+    isVisible: z.ZodBoolean;
+    properties: z.ZodObject<{}, z.core.$loose>;
+    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;
+        typeId: z.ZodNumber;
+        title: z.ZodString;
+        schema: z.ZodObject<{}, z.core.$loose>;
+        isVisible: z.ZodBoolean;
+        properties: z.ZodObject<{}, z.core.$loose>;
+        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>]>>;
+    settings: z.ZodOptional<z.ZodUnion<readonly [z.ZodRecord<z.ZodString, z.ZodAny>, z.ZodArray<z.ZodAny>]>>;
+}, z.core.$strip>>;

package/dist/attribute-sets/attributeSetsSchemas.js

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