oneentry 1.0.173 → 1.0.175

package/dist/users/usersInterfaces.d.ts

@@ -1,4 +1,4 @@
-import type { IAuthData, IAuthFormData, INotificationData } from '../auth-provider/authProvidersInterfaces';
+import type { IAuthData, INotificationData } from '../auth-provider/authProvidersInterfaces';
 import type { IError, IRating, IVectorSearchResponse } from '../base/utils';
 import type { IFormConfig } from '../forms/formsInterfaces';
 import type { FormDataType } from '../forms-data/formsDataInterfaces';
@@ -64,7 +64,7 @@ interface IUsersApi {
         ]
      * @param {string} body.authData[index].marker - Identifies the field being used. Example: "email_reg".
      * @param {string} body.authData[index].value - Contains the value of the field. Example: "example@oneentry.cloud".
-     * @param {string} body.formData - Contains additional data for the user.
+     * @param {FormDataType | FormDataType[]} body.formData - Form fields of the user. Field values: {@link FormDataType} — a value shaped by the field type (a string, a date object, a text object, a list, a file descriptor), not only a string. A file goes in as the descriptor `FileUploading.upload` returns: these methods do not upload a `File`/`Blob` themselves.
      * @example
         [
           {
@@ -75,7 +75,7 @@ interface IUsersApi {
         ]
      * @param {string} body.formData[index].marker - The marker of the field. Example: "last_name".
      * @param {string} body.formData[index].type - The type of the field. Example: "string".
-     * @param {string} body.formData[index].value - The value of the field. Example: "Username".
+     * @param {unknown} body.formData[index].value - The value of the field, shaped by its type. Example: "Username".
      * @param {string} body.notificationData - The notification data.
      * @example
         {
@@ -164,7 +164,7 @@ interface IUsersApi {
     /**
      * Remove an item from the cart.
      * @handleName removeCartItem
-     * @param {number} productId - Product identifier. Example: 12345.
+     * @param {number} productId - Product ID. Example: 12345.
      * @returns {Promise<ICartResponse | IError>} A promise resolving to the updated cart, or an error.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      * @description This method requires user authorization (or a guest context).
@@ -203,7 +203,7 @@ interface IUsersApi {
     /**
      * Remove an item from the wishlist.
      * @handleName removeWishlistItem
-     * @param {number} productId - Product identifier. Example: 12345.
+     * @param {number} productId - Product ID. Example: 12345.
      * @returns {Promise<IWishlistResponse | IError>} A promise resolving to the updated wishlist, or an error.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      * @description This method requires user authorization (or a guest context).
@@ -213,10 +213,10 @@ interface IUsersApi {
     /**
      * Semantic (vector) search for users.
      * @handleName getUsersByVectorSearch
-     * @param {IUsersVectorSearch} body - Vector search body. Example: `{ queryText: "john" }`.
+     * @param {IUsersVectorSearch} body - Vector search parameters. Example: `{ queryText: "john" }`.
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {number} [offset] - Parameter for pagination. Default: 0.
-     * @param {number} [limit] - Parameter for pagination. Default: 30.
+     * @param {number} [offset] - Number of records to skip. Default: 0.
+     * @param {number} [limit] - Maximum number of records to return. Default: 30.
      * @returns {Promise<IVectorSearchResponse<IUsersResponse> | IError>} A promise resolving to a users response (items + total), or an error.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      * @description This method performs a semantic (vector) search for users. It requires user authorization.
@@ -229,8 +229,8 @@ interface IUsersApi {
  * @interface IUsersVectorSearch
  * @property {string} queryText - Natural-language search query. Example: "john".
  * @property {number} [vectorDistanceThreshold] - Override of the cosine distance threshold (0..2). Example: 0.3.
- * @property {number} [maxHits] - Top-K candidates fetched before pagination. Default: 100. Max: 500. Example: 10.
- * @property {boolean} [debug] - When true, each returned item gets a `distance` field. Example: false.
+ * @property {number} [maxHits] - Number of top candidates fetched before pagination. Default: 100. Maximum: 500. Example: 10.
+ * @property {boolean} [debug] - When `true`, each returned item gets a `distance` field. Example: false.
  * @description Body for the users vector/search endpoint.
  */
 interface IUsersVectorSearch {
@@ -241,7 +241,7 @@ interface IUsersVectorSearch {
 }
 /**
  * @interface IUsersResponse
- * @property {IUserEntity[]} items - Array of found user objects.
+ * @property {IUserEntity[]} items - Users that match the query.
  * @property {number} total - Total number of found records. Example: 100.
  * @description This interface defines the structure of a response containing multiple user entities, including the total count and an array of user items.
  */
@@ -251,10 +251,10 @@ interface IUsersResponse {
 }
 /**
  * @interface IUserEntity
- * @property {number} id - Object identifier. Example: 12345.
- * @property {string} identifier - Text identifier for record field. Example: "user_12345".
- * @property {string} authProviderIdentifier - Text identifier of the authentication provider. Example: "auth_provider_12345".
- * @property {FormDataType[]} formData - Array of data form objects with the following values.
+ * @property {number} id - Object ID. Example: 12345.
+ * @property {string} identifier - Text identifier (marker) of the object. Example: "user_12345".
+ * @property {string} authProviderIdentifier - Marker of the authentication provider. Example: "auth_provider_12345".
+ * @property {FormDataType[]} formData - Form fields with their values.
  * @example
     [
       {
@@ -263,21 +263,21 @@ interface IUsersResponse {
         "value": "Username"
       }
     ]
- * @property {string} formIdentifier - Text identifier of the form. Example: "form_12345".
- * @property {string} total - Total value. Example: "0".
- * @property {Array<string | number>} groups - Array of user groups.
+ * @property {string} formIdentifier - Marker of the form. Example: "form_12345".
+ * @property {string} [total] - Deprecated, do not rely on it. A service counter that leaks into the response of a single user: always `"1"`, it carries no data about the user. The API reference does not describe it, and the field may disappear from the response. Example: "1".
+ * @property {Array<string | number>} groups - User groups.
  * @example
     [
       "group_1",
       "group_2"
     ]
- * @property {object} state - Object containing additional user state information.
+ * @property {object} state - Custom key-value data stored with the user.
  * @example
     {
       "key": "value"
     }
- * @property {Array<IFormConfig>} [moduleFormConfigs] - Optional array of form configuration objects associated with the user.
- * @property {IRating} [rating] - Rating data.
+ * @property {Array<IFormConfig>} [moduleFormConfigs] - Form configurations of the module associated with the user.
+ * @property {IRating} [rating] - Rating data: average value, likes and dislikes, and the calculation method.
  * @property {number} [distance] - Cosine distance to the query. Returned only by the semantic (vector) search endpoint when `debug: true` is passed in the search body. Example: 0.12.
  * @description Represents a user entity with various properties, including identifiers, form data, and user groups.
  */
@@ -287,7 +287,8 @@ interface IUserEntity {
     authProviderIdentifier: string;
     formData: FormDataType[];
     formIdentifier: string;
-    total: string;
+    /** @deprecated Service counter leaking into the response, always `"1"`; the field may disappear. */
+    total?: string;
     groups: Array<string | number>;
     state: Record<string, unknown>;
     moduleFormConfigs?: Array<IFormConfig>;
@@ -296,9 +297,9 @@ interface IUserEntity {
 }
 /**
  * @interface IUserBody
- * @property {string} formIdentifier - Text identifier of the form. Example: "form_12345".
- * @property {string} [langCode] - Language code for localization. Default: "en_US".
- * @property {IAuthData[]} [authData] - Array of authentication data objects with markers and values.
+ * @property {string} formIdentifier - Marker of the form. Example: "form_12345".
+ * @property {string} [langCode] - Language code. Default: "en_US".
+ * @property {IAuthData[]} [authData] - Authentication fields, each with a `marker` and a `value`.
  * @example
     [
       {
@@ -306,7 +307,7 @@ interface IUserEntity {
         "value": "12345"
       }
     ]
- * @property {IAuthFormData | IAuthFormData[]} [formData] - Form data object or array of form data objects.
+ * @property {FormDataType | FormDataType[]} [formData] - One form field object or an array of them. Field values: {@link FormDataType} — a value shaped by the field type (a string, a date object, a text object, a list, a file descriptor), not only a string. A file goes in as the descriptor `FileUploading.upload` returns: these methods do not upload a `File`/`Blob` themselves.
  * @example
     [
       {
@@ -320,14 +321,14 @@ interface IUserEntity {
         "value": "Doe"
       }
     ]
- * @property {object} [notificationData] - Object containing notification data, including email and phone information.
+ * @property {object} [notificationData] - Notification contacts: email and phone numbers.
  * @example
     {
       "email": "example@oneentry.cloud",
       "phonePush": ["+99999999999"],
       "phoneSMS": "+99999999999"
     }
- * @property {object} [state] - Object containing additional state information.
+ * @property {object} [state] - Custom key-value data stored with the user. Applied as a JSON Merge Patch: a key set to `null` is removed, other keys are overwritten, and omitted keys are kept.
  * @example
     {
       "key": "value"
@@ -338,15 +339,15 @@ interface IUserBody {
     formIdentifier: string;
     langCode?: string;
     authData?: IAuthData[];
-    formData?: IAuthFormData | IAuthFormData[];
+    formData?: FormDataType | FormDataType[];
     notificationData?: INotificationData;
     state?: Record<string, unknown>;
 }
 /**
  * @interface ICartItem
- * @property {number} productId - Product identifier. Example: 1.
+ * @property {number} productId - Product ID. Example: 1.
  * @property {number} qty - Quantity of the product in the cart. Example: 2.
- * @property {string} [addedAt] - ISO date when the item was added. Example: "2026-05-30T10:00:00.000Z".
+ * @property {string} [addedAt] - Date and time the item was added, in ISO 8601 format. Example: "2026-05-30T10:00:00.000Z".
  * @description A single cart item.
  */
 interface ICartItem {
@@ -356,7 +357,7 @@ interface ICartItem {
 }
 /**
  * @interface ICartResponse
- * @property {ICartItem[]} items - Cart items.
+ * @property {ICartItem[]} items - Items in the cart.
  * @property {number} total - Total number of items in the cart. Example: 3.
  * @description The user's or guest's cart.
  */
@@ -366,7 +367,7 @@ interface ICartResponse {
 }
 /**
  * @interface ICartSet
- * @property {ICartItem[]} items - New cart items. Example: `[{ productId: 1, qty: 2 }]`.
+ * @property {ICartItem[]} items - New contents of the cart. Example: `[{ productId: 1, qty: 2 }]`.
  * @description Body for replacing the whole cart.
  */
 interface ICartSet {
@@ -374,7 +375,7 @@ interface ICartSet {
 }
 /**
  * @interface ICartAddItem
- * @property {number} productId - Product identifier. Example: 1.
+ * @property {number} productId - Product ID. Example: 1.
  * @property {number} qty - Quantity to add. Example: 2.
  * @description Body for adding a single item to the cart.
  */
@@ -384,8 +385,8 @@ interface ICartAddItem {
 }
 /**
  * @interface IWishlistItem
- * @property {number} productId - Product identifier. Example: 1.
- * @property {string} [addedAt] - ISO date when the item was added. Example: "2026-05-30T10:00:00.000Z".
+ * @property {number} productId - Product ID. Example: 1.
+ * @property {string} [addedAt] - Date and time the item was added, in ISO 8601 format. Example: "2026-05-30T10:00:00.000Z".
  * @description A single wishlist item.
  */
 interface IWishlistItem {
@@ -394,7 +395,7 @@ interface IWishlistItem {
 }
 /**
  * @interface IWishlistResponse
- * @property {IWishlistItem[]} items - Wishlist items.
+ * @property {IWishlistItem[]} items - Items in the wishlist.
  * @property {number} total - Total number of items in the wishlist. Example: 3.
  * @description The user's or guest's wishlist.
  */
@@ -404,7 +405,7 @@ interface IWishlistResponse {
 }
 /**
  * @interface IWishlistSet
- * @property {IWishlistItem[]} items - New wishlist items. Example: `[{ productId: 1 }]`.
+ * @property {IWishlistItem[]} items - New contents of the wishlist. Example: `[{ productId: 1 }]`.
  * @description Body for replacing the whole wishlist.
  */
 interface IWishlistSet {
@@ -412,7 +413,7 @@ interface IWishlistSet {
 }
 /**
  * @interface IWishlistAddItem
- * @property {number} productId - Product identifier. Example: 1.
+ * @property {number} productId - Product ID. Example: 1.
  * @description Body for adding a single item to the wishlist.
  */
 interface IWishlistAddItem {

package/dist/users/usersSchemas.d.ts

@@ -13,7 +13,7 @@ export declare const UserResponseSchema: z.ZodObject<{
     authProviderIdentifier: z.ZodString;
     formData: z.ZodUnion<readonly [z.ZodArray<z.ZodAny>, z.ZodRecord<z.ZodString, z.ZodAny>]>;
     formIdentifier: z.ZodString;
-    total: z.ZodString;
+    total: z.ZodOptional<z.ZodString>;
     groups: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
     state: z.ZodRecord<z.ZodString, z.ZodAny>;
     moduleFormConfigs: z.ZodOptional<z.ZodArray<z.ZodAny>>;

package/esm/admins/adminsApi.d.ts

@@ -25,7 +25,7 @@ export default class AdminsApi extends AsyncModules implements IAdmins {
     /**
      * Get all admins objects with filters.
      * @handleName getAdminsInfo
-     * @param {IFilterParams[]} [body] - Array of filter objects with search conditions. Default: [].
+     * @param {IFilterParams[]} [body] - Filter objects with search conditions. Default: `[]`.
      * @example
         [
           {
@@ -39,12 +39,12 @@ export default class AdminsApi extends AsyncModules implements IAdmins {
             "conditionValue": 3
           }
         ]
-     * @param {string} [body.attributeMarker] - Text identifier (marker) of the attribute in the set. Example: "num".
+     * @param {string} [body.attributeMarker] - Marker of the attribute in the set. Example: "num".
      * @param {string} [body.conditionMarker] - Text identifier (marker) of the condition in the set. Example: "mth".
      * @param {number | string | null} [body.conditionValue] - Value of the condition. Example: "new".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {number} [offset] - Parameter for pagination. Default: 0.
-     * @param {number} [limit] - Parameter for pagination. Default: 30.
+     * @param {number} [offset] - Number of records to skip. Default: 0.
+     * @param {number} [limit] - Maximum number of records to return. Default: 30.
      * @returns {Promise<IAdminEntity[] | IError>} Returns an array of admin objects.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @see {@link https://js-sdk.oneentry.cloud/docs/admins/getAdminsInfo getAdminsInfo} documentation.
@@ -53,10 +53,10 @@ export default class AdminsApi extends AsyncModules implements IAdmins {
     /**
      * Semantic (vector) search for admins.
      * @handleName getAdminsByVectorSearch
-     * @param {IAdminsVectorSearch} body - Vector search body. Example: `{ queryText: "content manager" }`.
+     * @param {IAdminsVectorSearch} body - Vector search parameters. Example: `{ queryText: "content manager" }`.
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {number} [offset] - Parameter for pagination. Default: 0.
-     * @param {number} [limit] - Parameter for pagination. Default: 30.
+     * @param {number} [offset] - Number of records to skip. Default: 0.
+     * @param {number} [limit] - Maximum number of records to return. Default: 30.
      * @returns {Promise<IVectorSearchResponse<IAdminsResponse> | IError>} Returns an object with an array of found admins and total count.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description This method performs a semantic (vector) search for admins.

package/esm/admins/adminsApi.js

@@ -24,7 +24,7 @@ export default class AdminsApi extends AsyncModules {
     /**
      * Get all admins objects with filters.
      * @handleName getAdminsInfo
-     * @param {IFilterParams[]} [body] - Array of filter objects with search conditions. Default: [].
+     * @param {IFilterParams[]} [body] - Filter objects with search conditions. Default: `[]`.
      * @example
         [
           {
@@ -38,12 +38,12 @@ export default class AdminsApi extends AsyncModules {
             "conditionValue": 3
           }
         ]
-     * @param {string} [body.attributeMarker] - Text identifier (marker) of the attribute in the set. Example: "num".
+     * @param {string} [body.attributeMarker] - Marker of the attribute in the set. Example: "num".
      * @param {string} [body.conditionMarker] - Text identifier (marker) of the condition in the set. Example: "mth".
      * @param {number | string | null} [body.conditionValue] - Value of the condition. Example: "new".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {number} [offset] - Parameter for pagination. Default: 0.
-     * @param {number} [limit] - Parameter for pagination. Default: 30.
+     * @param {number} [offset] - Number of records to skip. Default: 0.
+     * @param {number} [limit] - Maximum number of records to return. Default: 30.
      * @returns {Promise<IAdminEntity[] | IError>} Returns an array of admin objects.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @see {@link https://js-sdk.oneentry.cloud/docs/admins/getAdminsInfo getAdminsInfo} documentation.
@@ -62,10 +62,10 @@ export default class AdminsApi extends AsyncModules {
     /**
      * Semantic (vector) search for admins.
      * @handleName getAdminsByVectorSearch
-     * @param {IAdminsVectorSearch} body - Vector search body. Example: `{ queryText: "content manager" }`.
+     * @param {IAdminsVectorSearch} body - Vector search parameters. Example: `{ queryText: "content manager" }`.
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {number} [offset] - Parameter for pagination. Default: 0.
-     * @param {number} [limit] - Parameter for pagination. Default: 30.
+     * @param {number} [offset] - Number of records to skip. Default: 0.
+     * @param {number} [limit] - Maximum number of records to return. Default: 30.
      * @returns {Promise<IVectorSearchResponse<IAdminsResponse> | IError>} Returns an object with an array of found admins and total count.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description This method performs a semantic (vector) search for admins.

package/esm/admins/adminsInterfaces.d.ts

@@ -9,7 +9,7 @@ interface IAdmins {
     /**
      * Get all admins objects with filters.
      * @handleName getAdminsInfo
-     * @param {IFilterParams[]} [body] - Array of filter objects with search conditions. Default: [].
+     * @param {IFilterParams[]} [body] - Filter objects with search conditions. Default: `[]`.
      * @example
         [
           {
@@ -23,12 +23,12 @@ interface IAdmins {
             "conditionValue": 3
           }
         ]
-     * @param {string} [body.attributeMarker] - Text identifier (marker) of the attribute in the set. Example: "num".
+     * @param {string} [body.attributeMarker] - Marker of the attribute in the set. Example: "num".
      * @param {string} [body.conditionMarker] - Text identifier (marker) of the condition in the set. Example: "mth".
      * @param {number | string | null} [body.conditionValue] - Value of the condition. Example: "new".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {number} [offset] - Parameter for pagination. Default: 0.
-     * @param {number} [limit] - Parameter for pagination. Default: 30.
+     * @param {number} [offset] - Number of records to skip. Default: 0.
+     * @param {number} [limit] - Maximum number of records to return. 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.
      */
@@ -36,10 +36,10 @@ interface IAdmins {
     /**
      * Semantic (vector) search for admins.
      * @handleName getAdminsByVectorSearch
-     * @param {IAdminsVectorSearch} body - Vector search body. Example: `{ queryText: "content manager" }`.
+     * @param {IAdminsVectorSearch} body - Vector search parameters. Example: `{ queryText: "content manager" }`.
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {number} [offset] - Parameter for pagination. Default: 0.
-     * @param {number} [limit] - Parameter for pagination. Default: 30.
+     * @param {number} [offset] - Number of records to skip. Default: 0.
+     * @param {number} [limit] - Maximum number of records to return. Default: 30.
      * @returns {IVectorSearchResponse<IAdminsResponse>} Returns an object with an array of found admins, total count and indexReady.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      */
@@ -50,8 +50,8 @@ interface IAdmins {
  * @interface IAdminsVectorSearch
  * @property {string} queryText - Natural-language search query. Example: "content manager".
  * @property {number} [vectorDistanceThreshold] - Override of the cosine distance threshold (0..2). Example: 0.3.
- * @property {number} [maxHits] - Top-K candidates fetched before pagination. Default: 100. Max: 500. Example: 10.
- * @property {boolean} [debug] - When true, each returned item gets a `distance` field. Example: false.
+ * @property {number} [maxHits] - Number of top candidates fetched before pagination. Default: 100. Maximum: 500. Example: 10.
+ * @property {boolean} [debug] - When `true`, each returned item gets a `distance` field. Example: false.
  * @description Body for the admins vector/search endpoint.
  */
 interface IAdminsVectorSearch {
@@ -62,7 +62,7 @@ interface IAdminsVectorSearch {
 }
 /**
  * @interface IAdminsResponse
- * @property {IAdminEntity[]} items - Array of found admin objects.
+ * @property {IAdminEntity[]} items - Admins that match the query.
  * @property {number} total - Total number of found records. Example: 100.
  * @description This interface defines the structure of a response containing multiple admin entities, including the total count and an array of admin items.
  */
@@ -73,12 +73,12 @@ interface IAdminsResponse {
 /**
  * Interface representing a Position entity.
  * @interface IPosition
- * @property {number} id - The unique identifier of the position. Example: 1764.
+ * @property {number} id - ID of the object. Example: 1764.
  * @property {boolean} [isLocked] - Indicates whether the position is locked or not. Example: false.
  * @property {number} objectId - The unique identifier of the object. Example: 120.
  * @property {number} [objectCategoryId] - The unique identifier of the object's category. Example: 5.
  * @property {string} objectType - The type of the object. Example: "admin".
- * @property {number} position - The position of the object. Example: 192.
+ * @property {number} position - Position of the object, used for sorting. Example: 192.
  * @description This interface outlines the properties associated with a position within a system.
  */
 interface IPosition {
@@ -92,13 +92,13 @@ interface IPosition {
 /**
  * Interface representing an Admin Entity.
  * @interface IAdminEntity
- * @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".
- * @property {number | null} position - Position number (for sorting). Example: 1.
- * @property {boolean} isSync - Page indexing flag (true or false). Example: true.
- * @property {IAttributeValues} attributeValues - Array of attribute values from the index (presented as a pair of user attribute identifier: attribute value).
+ * @property {number} id - Object ID. Example: 1764.
+ * @property {number | null} attributeSetId - ID of the attribute set in use. Example: 120.
+ * @property {string} identifier - Text identifier (marker) of the object. Example: "admin1".
+ * @property {string | null} attributeSetIdentifier - Marker of the attribute set. Example: "admins".
+ * @property {number | null} position - Position used for sorting. Example: 1.
+ * @property {boolean} isSync - Whether the page is indexed. Example: true.
+ * @property {IAttributeValues} attributeValues - Attribute values keyed by attribute marker.
  * @example
     [
       {
@@ -108,7 +108,7 @@ interface IPosition {
         }
       }
     ]
- * @property {IFormConfig[]} [moduleFormConfigs] - Array of module form configurations associated with the admin.
+ * @property {IFormConfig[]} [moduleFormConfigs] - Form configurations of the module associated with the admin.
  * @property {number} [distance] - Cosine distance to the query. Returned only by the semantic (vector) search endpoint when `debug: true` is passed in the search body. Example: 0.12.
  * @description This interface captures the essential details and additional attributes of an admin entity.
  */
@@ -127,8 +127,8 @@ interface IAdminEntity {
  * Interface representing a query for fetching admin data.
  * @interface IAdminQuery
  * @property {string} langCode - Language code. Default: "en_US".
- * @property {number} limit - Parameter for pagination. Default: 30.
- * @property {number} offset - Parameter for pagination. Default: 0.
+ * @property {number} limit - Maximum number of records to return. Default: 30.
+ * @property {number} offset - Number of records to skip. Default: 0.
  * @description This interface defines the parameters required for querying admin data, including optional defaults.
  */
 interface IAdminQuery {

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

@@ -24,10 +24,10 @@ export default class AttributesSetsApi extends AsyncModules implements IAttribut
      * 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".
+     * @param {number} [offset] - Number of records to skip. Default: 0.
+     * @param {number} [limit] - Maximum number of records to return. Default: 30.
+     * @param {number} [typeId] - ID of the attribute set type to filter by. Default: null.
+     * @param {string} [sortBy] - Field to sort by: `id` or `position`. 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.
@@ -36,7 +36,7 @@ export default class AttributesSetsApi extends AsyncModules implements IAttribut
     /**
      * Getting all attributes with data from the attribute set.
      * @handleName getAttributesByMarker
-     * @param {string} marker - Attribute marker. Example: "productAttributes".
+     * @param {string} marker - Marker of the attribute. 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
@@ -46,8 +46,8 @@ export default class AttributesSetsApi extends AsyncModules implements IAttribut
     /**
      * 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} setMarker - Marker of the attribute set. Example: "productAttributes".
+     * @param {string} attributeMarker - 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
@@ -57,7 +57,7 @@ export default class AttributesSetsApi extends AsyncModules implements IAttribut
     /**
      * 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} marker - Marker of the attribute set. 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

package/esm/attribute-sets/attributeSetsApi.js

@@ -24,10 +24,10 @@ export default class AttributesSetsApi extends AsyncModules {
      * 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".
+     * @param {number} [offset] - Number of records to skip. Default: 0.
+     * @param {number} [limit] - Maximum number of records to return. Default: 30.
+     * @param {number} [typeId] - ID of the attribute set type to filter by. Default: null.
+     * @param {string} [sortBy] - Field to sort by: `id` or `position`. 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.
@@ -51,7 +51,7 @@ export default class AttributesSetsApi extends AsyncModules {
     /**
      * Getting all attributes with data from the attribute set.
      * @handleName getAttributesByMarker
-     * @param {string} marker - Attribute marker. Example: "productAttributes".
+     * @param {string} marker - Marker of the attribute. 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
@@ -66,8 +66,8 @@ export default class AttributesSetsApi extends AsyncModules {
     /**
      * 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} setMarker - Marker of the attribute set. Example: "productAttributes".
+     * @param {string} attributeMarker - 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
@@ -82,7 +82,7 @@ export default class AttributesSetsApi extends AsyncModules {
     /**
      * 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} marker - Marker of the attribute set. 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