oneentry 1.0.145 → 1.0.147

package/dist/admins/adminsApi.d.ts

@@ -1,6 +1,7 @@
 import AsyncModules from '../base/asyncModules';
 import type StateModule from '../base/stateModule';
-import type { AttributeType, IError } from '../base/utils';
+import type { IError } from '../base/utils';
+import type { IFilterParams } from '../products/productsInterfaces';
 import type { IAdminEntity, IAdmins } from './adminsInterfaces';
 /**
  * Controllers for working with users - admins.
@@ -23,7 +24,7 @@ export default class AdminsApi extends AsyncModules implements IAdmins {
     /**
      * Get all admins objects with filters.
      * @handleName getAdminsInfo
-     * @param {AttributeType[]} [body] - Array of filter objects with search conditions. Default: [].
+     * @param {IFilterParams[]} [body] - Array of filter objects with search conditions. Default: [].
      * @example
         [
           {
@@ -46,5 +47,5 @@ export default class AdminsApi extends AsyncModules implements IAdmins {
      * @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>;
+    getAdminsInfo(body?: IFilterParams[], langCode?: string, offset?: number, limit?: number): Promise<IAdminEntity[] | IError>;
 }

package/dist/admins/adminsApi.js

@@ -27,7 +27,7 @@ class AdminsApi extends asyncModules_1.default {
     /**
      * Get all admins objects with filters.
      * @handleName getAdminsInfo
-     * @param {AttributeType[]} [body] - Array of filter objects with search conditions. Default: [].
+     * @param {IFilterParams[]} [body] - Array of filter objects with search conditions. Default: [].
      * @example
         [
           {

package/dist/admins/adminsInterfaces.d.ts

@@ -1,5 +1,6 @@
-import type { AttributeType, IAttributeValues, IError } from '../base/utils';
+import type { IAttributeValues, IError } from '../base/utils';
 import type { IFormConfig } from '../forms/formsInterfaces';
+import type { IFilterParams } from '../products/productsInterfaces';
 /**
  * @interface IAdmins
  * @description This interface defines the contract for any class that implements it
@@ -8,7 +9,7 @@ interface IAdmins {
     /**
      * Get all admins objects with filters.
      * @handleName getAdminsInfo
-     * @param {AttributeType[]} [body] - Array of filter objects with search conditions. Default: [].
+     * @param {IFilterParams[]} [body] - Array of filter objects with search conditions. Default: [].
      * @example
         [
           {
@@ -31,7 +32,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?: IFilterParams[], langCode?: string, offset?: number, limit?: number): Promise<IAdminEntity[] | IError>;
 }
 /**
  * Interface representing a Position entity.
@@ -83,7 +84,6 @@ interface IAdminEntity {
     isSync: boolean;
     attributeValues: IAttributeValues;
     moduleFormConfigs?: IFormConfig[];
-    [key: string]: unknown;
 }
 /**
  * Interface representing a query for fetching admin data.

package/dist/admins/adminsSchemas.d.ts

@@ -3,10 +3,6 @@
  * @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>;
@@ -14,9 +10,19 @@ export declare const AdminEntitySchema: z.ZodObject<{
     attributeSetIdentifier: z.ZodNullable<z.ZodString>;
     position: z.ZodNullable<z.ZodNumber>;
     isSync: z.ZodBoolean;
-    attributeValues: z.ZodRecord<z.ZodString, z.ZodAny>;
+    attributeValues: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodType<{
+        type: string;
+        value: unknown;
+        position?: number;
+        additionalFields?: Record<string, unknown> | unknown[];
+    }, unknown, z.core.$ZodTypeInternals<{
+        type: string;
+        value: unknown;
+        position?: number;
+        additionalFields?: Record<string, unknown> | unknown[];
+    }, unknown>>>>;
     moduleFormConfigs: z.ZodOptional<z.ZodArray<z.ZodAny>>;
-}, z.core.$catchall<z.ZodAny>>;
+}, z.core.$strip>;
 /**
  * Admins response schema (array of admin entities)
  */
@@ -27,6 +33,16 @@ export declare const AdminsResponseSchema: z.ZodArray<z.ZodObject<{
     attributeSetIdentifier: z.ZodNullable<z.ZodString>;
     position: z.ZodNullable<z.ZodNumber>;
     isSync: z.ZodBoolean;
-    attributeValues: z.ZodRecord<z.ZodString, z.ZodAny>;
+    attributeValues: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodType<{
+        type: string;
+        value: unknown;
+        position?: number;
+        additionalFields?: Record<string, unknown> | unknown[];
+    }, unknown, z.core.$ZodTypeInternals<{
+        type: string;
+        value: unknown;
+        position?: number;
+        additionalFields?: Record<string, unknown> | unknown[];
+    }, unknown>>>>;
     moduleFormConfigs: z.ZodOptional<z.ZodArray<z.ZodAny>>;
-}, z.core.$catchall<z.ZodAny>>>;
+}, z.core.$strip>>;

package/dist/admins/adminsSchemas.js

@@ -10,18 +10,24 @@ const zod_1 = require("zod");
  * Admin entity schema
  * Includes all fields returned by the API
  */
-exports.AdminEntitySchema = zod_1.z
-    .object({
+const AttributeValueSchema = zod_1.z.object({
+    type: zod_1.z.string(),
+    value: zod_1.z.unknown(),
+    position: zod_1.z.number().optional(),
+    additionalFields: zod_1.z
+        .union([zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()), zod_1.z.array(zod_1.z.unknown())])
+        .optional(),
+});
+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()),
+    attributeValues: zod_1.z.record(zod_1.z.string(), zod_1.z.record(zod_1.z.string(), AttributeValueSchema)),
     moduleFormConfigs: zod_1.z.array(zod_1.z.any()).optional(),
-})
-    .catchall(zod_1.z.any());
+});
 /**
  * Admins response schema (array of admin entities)
  */

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

@@ -1,4 +1,4 @@
-import type { IError, ILocalizeInfo } from '../base/utils';
+import type { IAttributeLocalizeInfo, IError, ITimeIntervalSchedule } from '../base/utils';
 /**
  * Interface for retrieving attributes based on markers and language codes.
  * @interface IAttributesSets
@@ -40,12 +40,37 @@ interface IAttributesSets {
  */
 interface IListTitle {
     title: string;
-    value: number | string;
-    position: string | number | null;
-    extended: {
-        value: string | null;
-        type: string | null;
-    };
+    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.
@@ -61,7 +86,7 @@ type AttributeType = 'string' | 'text' | 'textWithHeader' | 'integer' | 'real' |
  * @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[] | Record<string, unknown>} [listTitles] - Array of values (with extended data) for list and radioButton attributes.
+ * @property {IListTitle[]} listTitles - Array of values (with extended data) for list and radioButton attributes; empty array for non-list types.
  * @example
     [
       {
@@ -79,7 +104,7 @@ type AttributeType = 'string' | 'text' | 'textWithHeader' | 'integer' | 'real' |
         "extendedValueType": null
       }
     ]
- * @property {Record<string, unknown>} [validators] - Set of validators for validation.
+ * @property {IAttributeValidators} validators - Set of validators for validation; empty object when no validators are configured.
  * @example
     {
       "requiredValidator": {
@@ -89,12 +114,12 @@ type AttributeType = 'string' | 'text' | 'textWithHeader' | 'integer' | 'real' |
         "fieldDefaultValue": 11
       }
     }
- * @property {ILocalizeInfo} localizeInfos - The name of the template, taking into account localization.
+ * @property {IAttributeLocalizeInfo} localizeInfos - The name of the template, taking into account localization.
  * @example
    {
      "title": "My attribute"
    }
- * @property {Record<string, unknown>} [additionalFields] - Additional fields for the attribute (optional).
+ * @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 {
@@ -103,10 +128,75 @@ interface IAttributesSetsEntity {
     initialValue: unknown;
     marker: string;
     position: number;
-    listTitles?: IListTitle[] | Record<string, unknown>;
-    validators?: Record<string, unknown>;
-    localizeInfos: ILocalizeInfo;
-    additionalFields?: Record<string, unknown>;
+    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.
+ * @property {boolean} isPrice - Whether the field's numeric value is treated as the price for product entities. 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 {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 {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] - For `timeInterval` fields — current value/state of the schedule. 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;
+    additionalFields?: Record<string, IAttributeSchemaItem>;
+    validators?: IAttributeValidators;
+    splitUnit?: boolean | string;
+    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.
@@ -118,7 +208,7 @@ interface IAttributesSetsEntity {
  * @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.
  * @property {string} title - The title or name of the attribute set. Example: "Product Attributes".
- * @property {object} schema - The schema definition associated with the attribute set. This could represent the structure or rules for the data.
+ * @property {Record<string, IAttributeSchemaItem>} schema - Schema fields keyed by marker.
  * @example
    {
      "attribute1": {
@@ -133,7 +223,7 @@ interface IAttributesSetsEntity {
      }
    }
  * @property {boolean} isVisible - Indicates whether the attribute set is visible or not. Example: true.
- * @property {object} properties - Additional properties associated with the attribute set, which can be of any type.
+ * @property {Record<string, unknown>} properties - Additional properties associated with the attribute set; empty object when none.
  * @example
    {
      "color": "red",
@@ -151,15 +241,22 @@ interface IAttributeSetsEntity {
     identifier: string;
     typeId: number;
     title: string;
-    schema: object;
+    schema: Record<string, IAttributeSchemaItem>;
     isVisible: boolean;
-    properties: object;
-    type: {
-        id: number;
-        type: string;
-    };
+    properties: Record<string, unknown>;
+    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
@@ -182,4 +279,4 @@ interface IAttributesSetsResponse {
     total: number;
     items: IAttributeSetsEntity[];
 }
-export type { AttributeType, IAttributeSetsEntity, IAttributesSets, IAttributesSetsEntity, IAttributesSetsResponse, IListTitle, };
+export type { AttributeType, IAttributeSchemaItem, IAttributeSetsEntity, IAttributeSetTypeRef, IAttributesSets, IAttributesSetsEntity, IAttributesSetsResponse, IAttributeValidators, IListTitle, IListTitleEntityValue, IListTitleExtended, };

package/dist/auth-provider/authProvidersInterfaces.d.ts

@@ -1,4 +1,4 @@
-import type { IError, ILocalizeInfo } from '../base/utils';
+import type { IError, ILocalizeInfo, IRating } from '../base/utils';
 /**
  * @interface IAuthProvider
  * @description This interface defines methods for user authentication and registration through various auth providers.
@@ -199,22 +199,27 @@ interface IAuthFormData {
  * @property {string} [langCode] - Language code. Default: "en_US".
  * @property {Array} authData - An array of authentication data objects, each containing a marker and its corresponding value.
  * @property {IAuthFormData | IAuthFormData[]} formData - The form data for the registration.
- * @property {object} notificationData - An object containing notification data, including email, phonePush, and phoneSMS.
+ * @property {INotificationData} notificationData - An object containing notification data, including email, phonePush, and phoneSMS.
  * @description User registration (❗️For a provider with user activation, the activation code is sent through the corresponding user notification method).
  */
 interface ISignUpData {
     formIdentifier: string;
     langCode?: string;
-    authData: Array<{
-        marker: string;
-        value: string;
-    }>;
+    authData: IAuthData[];
     formData: IAuthFormData | IAuthFormData[];
-    notificationData: {
-        email: string;
-        phonePush: Array<string>;
-        phoneSMS?: string;
-    };
+    notificationData: INotificationData;
+}
+/**
+ * @interface INotificationData
+ * @property {string} email - User's email used for notifications. Example: "example@oneentry.cloud".
+ * @property {string[]} phonePush - Phone numbers used for push notifications. Example: ["+19999999999"].
+ * @property {string} [phoneSMS] - Phone number used for SMS notifications. Example: "+19999999999".
+ * @description Notification channels configured for a user.
+ */
+interface INotificationData {
+    email: string;
+    phonePush: string[];
+    phoneSMS?: string;
 }
 /**
  * Interface representing the data required for user registration via OAUTH.
@@ -241,17 +246,15 @@ interface IOauthData {
  * @property {number} version - The version number of the sign-up entity. Example: 1.
  * @property {string} identifier - A unique string that identifies the sign-up entity. Example: "signup_12345".
  * @property {boolean} isActive - Indicates whether the sign-up entity is active. Example: true.
- * @property {Array<object> | Record<string, unknown>} formData - Form data, can be an array or a localized record.
+ * @property {IAuthFormData[]} formData - Form data array.
  * @example
-    {
-      "en_US": [
-        {
-          "marker": "first_name",
-          "value": "John"
-        }
-      ]
-    }
- * @property {object} notificationData - An object containing notification data, including email, phonePush, and phoneSMS.
+    [
+      {
+        "marker": "first_name",
+        "value": "John"
+      }
+    ]
+ * @property {INotificationData} notificationData - An object containing notification data, including email, phonePush, and phoneSMS.
  * @example
     {
       "email": "example@oneentry.cloud",
@@ -264,7 +267,7 @@ interface IOauthData {
  * @property {string | null} [deletedAt] - Deletion date or null. Example: null.
  * @property {boolean} [isDeleted] - Whether the entity is deleted. Example: false.
  * @property {Record<string, unknown>} [state] - Additional state information. Example: {}.
- * @property {Record<string, unknown>} [rating] - Rating data. Example: {}.
+ * @property {IRating} [rating] - Rating data.
  * @description This interface defines the structure of a sign-up entity.
  */
 interface ISignUpEntity {
@@ -273,19 +276,15 @@ interface ISignUpEntity {
     version: number;
     identifier: string;
     isActive: boolean;
-    formData: Array<Record<string, any>> | Record<string, any>;
-    notificationData: {
-        email: string;
-        phonePush: Array<string>;
-        phoneSMS?: string;
-    };
+    formData: IAuthFormData[];
+    notificationData: INotificationData;
     locale?: string;
     createdDate?: string;
     importId?: unknown;
     deletedAt?: string | null;
     isDeleted?: boolean;
-    state?: Record<string, any>;
-    rating?: Record<string, unknown>;
+    state?: Record<string, unknown>;
+    rating?: IRating;
 }
 /**
  * Interface representing a code entity used for user registration or verification processes.
@@ -410,10 +409,18 @@ interface IAuthPostBody {
  * @description This interface defines the structure of the body used in authentication requests, containing an array of authentication data.
  */
 interface IActiveSession {
-    deviceInfo: {
-        os: string;
-        browser: string;
-        location: string;
-    };
+    deviceInfo: IDeviceInfo;
+}
+/**
+ * @interface IDeviceInfo
+ * @property {string} os - The operating system of the active session. Example: "Win32".
+ * @property {string} browser - The browser used in the active session. Example: "Node.js/22".
+ * @property {string} location - The locale of the active session. Example: "ru-RU".
+ * @description Information about the device tied to an active authentication session.
+ */
+interface IDeviceInfo {
+    os: string;
+    browser: string;
+    location: string;
 }
-export type { IActiveSession, IAuthData, IAuthEntity, IAuthFormData, IAuthPostBody, IAuthProvider, IAuthProvidersEntity, ICodeEntity, IOauthData, ISignUpData, ISignUpEntity, };
+export type { IActiveSession, IAuthData, IAuthEntity, IAuthFormData, IAuthPostBody, IAuthProvider, IAuthProvidersEntity, ICodeEntity, IDeviceInfo, INotificationData, IOauthData, ISignUpData, ISignUpEntity, };