oneentry 1.0.173 → 1.0.175

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

@@ -1,4 +1,5 @@
 import type { IError, ILocalizeInfo, IRating } from '../base/utils.js';
+import type { FormDataType } from '../forms-data/formsDataInterfaces.js';
 /**
  * @interface IAuthProvider
  * @description This interface defines methods for user authentication and registration through various auth providers.
@@ -133,8 +134,8 @@ interface IAuthProvider {
      * Retrieves all authentication providers.
      * @handleName getAuthProviders
      * @param {string} [langCode] - Optional language code for localization. Default: "en_US".
-     * @param {number} [offset] - Optional offset for pagination. Default: 0.
-     * @param {number} [limit] - Optional limit 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 {IAuthProvidersEntity[]} A promise that resolves to an array of auth provider entities or an error.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      * @description This method retrieves all authentication providers.
@@ -162,8 +163,8 @@ interface IAuthProvider {
     /**
      * User registration (authorization) via OAUTH.
      * @handleName oauthSignUp
-     * @param {string} marker - The text identifier of the authorization provider. Example: "email".
-     * @param {IOauthData} body - Object contains OAuth information for registration.
+     * @param {string} marker - Marker of the auth provider. Example: "email".
+     * @param {IOauthData} body - OAuth data for registration.
      * @example
         {
           "client_id": "34346983-luuct343473qdkqidjopdfp3eb3k4thp.apps.googleusercontent.com",
@@ -182,8 +183,8 @@ interface IAuthProvider {
 /**
  * Interface representing the structure of authentication form data.
  * @interface IAuthFormData
- * @property {string} marker - A unique identifier for the form field. Example: "email".
- * @property {string} type - The type of the form field, such as 'string', 'email', etc. Example: "string".
+ * @property {string} marker - Marker of the form field. Example: "email".
+ * @property {string} type - Type of the form field, for example `"string"` or `"email"`. Example: "string".
  * @property {string} value - The value entered in the form field. Example: "example@oneentry.cloud".
  * @description This interface defines the structure of authentication form data used in user registration and authentication processes.
  */
@@ -195,23 +196,23 @@ interface IAuthFormData {
 /**
  * Interface representing the data required for user registration.
  * @interface ISignUpData
- * @property {string} formIdentifier - The identifier for the registration form. Example: "reg".
+ * @property {string} formIdentifier - Marker of the registration form. Example: "reg".
  * @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 {INotificationData} notificationData - An object containing notification data, including email, phonePush, and phoneSMS.
+ * @property {Array} authData - Authentication fields, each with a `marker` and a `value`.
+ * @property {FormDataType | FormDataType[]} formData - Registration form fields. 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.
+ * @property {INotificationData} notificationData - Notification contacts: `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: IAuthData[];
-    formData: IAuthFormData | IAuthFormData[];
+    formData: FormDataType | FormDataType[];
     notificationData: INotificationData;
 }
 /**
  * @interface INotificationData
- * @property {string} email - User's email used for notifications. Example: "example@oneentry.cloud".
+ * @property {string} email - User 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.
@@ -227,7 +228,7 @@ interface INotificationData {
  * @property {string} client_id - The client ID for the OAuth application. Example: "34346983-luuct343473qdkqidjopdfp3eb3k4thp.apps.googleusercontent.com".
  * @property {string} client_secret - The client secret for the OAuth application. Example: "43434343434".
  * @property {string} code - The authorization code received from the OAuth provider. Example: "4/0AVMBsJgwewewewewewei4D7T6E_fbswxnL3g".
- * @property {string} grant_type - The grant type for the OAuth request. Example: "authorization_code".
+ * @property {string} grant_type - OAuth grant type. Example: "authorization_code".
  * @property {string} redirect_uri - The redirect URI for the OAuth application. Example: "http://localhost:3000".
  * @description User registration (❗️For a provider with user activation, the activation code is sent through the corresponding user notification method).
  */
@@ -241,12 +242,12 @@ interface IOauthData {
 /**
  * Interface representing a sign-up entity.
  * @interface ISignUpEntity
- * @property {number} id - The unique identifier of the sign-up entity. Example: 12345.
- * @property {string} updatedDate - The date when the sign-up entity was last updated. Example: "2023-10-01T12:00:00Z".
- * @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 {IAuthFormData[]} formData - Form data array.
+ * @property {number} id - ID of the user created by sign-up. Example: 12345.
+ * @property {string} updatedDate - Date the user was last updated. Example: "2023-10-01T12:00:00Z".
+ * @property {number} version - Version number of the user; changes with each update. Example: 1.
+ * @property {string} identifier - Marker of the user created by sign-up. Example: "signup_12345".
+ * @property {boolean} isActive - Whether the user account is active. Example: true.
+ * @property {IAuthFormData[]} formData - Form fields.
  * @example
     [
       {
@@ -254,22 +255,22 @@ interface IOauthData {
         "value": "John"
       }
     ]
- * @property {INotificationData} notificationData - An object containing notification data, including email, phonePush, and phoneSMS.
+ * @property {INotificationData} notificationData - Notification contacts: `email`, `phonePush` and `phoneSMS`.
  * @example
     {
       "email": "example@oneentry.cloud",
       "phonePush": ["+99999999999"],
       "phoneSMS": "+99999999999"
     }
- * @property {string} [locale] - The locale or language code associated with the sign-up entity. Example: "en_US".
- * @property {string} [createdDate] - The date when the sign-up entity was created. Example: "2023-10-01T12:00:00Z".
+ * @property {string} [locale] - Locale of the user created by sign-up. Example: "en_US".
+ * @property {string} [createdDate] - Creation date of the user record. Example: "2023-10-01T12:00:00Z".
  * @property {unknown} [importId] - Import identifier. Example: null.
- * @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 {IRating} [rating] - Rating data.
- * @property {number | null} [attributeSetId] - Identifier of the attribute set attached to the user, or null when none is attached. Example: null.
- * @property {Record<string, unknown>} [attributesSets] - Attribute sets attached to the user, keyed by marker; empty object when none. Example: {}.
+ * @property {string | null} [deletedAt] - Deletion date, or `null`. Example: null.
+ * @property {boolean} [isDeleted] - Whether the user account is deleted. Example: false.
+ * @property {Record<string, unknown>} [state] - Custom key-value data stored with the user. Example: {}.
+ * @property {IRating} [rating] - Rating data: average value, likes and dislikes, and the calculation method.
+ * @property {number | null} [attributeSetId] - ID of the attribute set attached to the user, or `null` when none is attached. Example: null.
+ * @property {Record<string, unknown>} [attributesSets] - Attribute sets attached to the user, keyed by marker; an empty object when there are none. Example: {}.
  * @description This interface defines the structure of a sign-up entity.
  */
 interface ISignUpEntity {
@@ -304,8 +305,8 @@ interface ICodeEntity {
 /**
  * Interface representing an authentication entity.
  * @interface IAuthEntity
- * @property {string} userIdentifier - The unique identifier for the user. Example: "user12345".
- * @property {string} authProviderIdentifier - The identifier for the authentication provider. Example: "email".
+ * @property {string} userIdentifier - User identifier (login), for example the email address. Example: "user12345".
+ * @property {string} authProviderIdentifier - Marker of the authentication provider. Example: "email".
  * @property {string} accessToken - The access token for the user session. Example: "abcdef123456".
  * @property {string} refreshToken - The refresh token for renewing the access token. Example: "ghijkl789012".
  * @description This interface defines the structure of an authentication entity.
@@ -319,24 +320,24 @@ interface IAuthEntity {
 /**
  * Interface representing an authentication provider entity.
  * @interface IAuthProvidersEntity
- * @property {number} id - The unique identifier of the auth provider entity. Example: 194.
- * @property {ILocalizeInfo} localizeInfos - Localized information for the auth provider.
+ * @property {number} id - ID of the auth provider. Example: 194.
+ * @property {ILocalizeInfo} localizeInfos - Localized data of the auth provider.
  * @example
     {
       "key": "value"
     }
- * @property {IAuthProvidersEntityConfig} config - Configuration settings for the auth provider, stored as a key-value pair object.
+ * @property {IAuthProvidersEntityConfig} config - Provider configuration as key-value pairs.
  * @example
     {
       "key": "value"
     }
- * @property {number} version - The version number of the auth provider entity. Example: 1.
- * @property {string} identifier - A unique string that identifies the auth provider. Example: "email".
- * @property {string} type - The type of the auth provider (e.g., 'email', 'google', etc.). Example: "email".
- * @property {string | null} formIdentifier - The identifier for the form associated with the auth provider, or null if not applicable. Example: "reg_form".
- * @property {string} userGroupIdentifier - The identifier for the userGroup associated with the auth provider. Example: "guest".
- * @property {boolean} isActive - Indicates whether the auth provider is active. Example: true.
- * @property {boolean} isCheckCode - Indicates whether the auth provider requires code verification. Example: false.
+ * @property {number} version - Version number of the auth provider; changes with each update. Example: 1.
+ * @property {string} identifier - Marker of the auth provider. Example: "email".
+ * @property {string} type - Type of the auth provider, for example `"email"`. Example: "email".
+ * @property {string | null} formIdentifier - Marker of the form linked to the auth provider, or `null` if there is none. Example: "reg_form".
+ * @property {string} userGroupIdentifier - Identifier of the user group linked to the auth provider. Example: "guest".
+ * @property {boolean} isActive - Whether the auth provider is active. Example: true.
+ * @property {boolean} isCheckCode - Whether the auth provider requires a verification code. Example: false.
  * @description This interface defines the structure of an authentication provider entity.
  */
 interface IAuthProvidersEntity {
@@ -355,12 +356,12 @@ interface IAuthProvidersEntity {
  * Interface representing an authentication provider config.
  * @interface IAuthProvidersEntityConfig
  * @property {string} accessTokenTtlSec - Access token time to live in seconds. Example: "3600".
- * @property {string} refreshTokenTtlMc - Refresh token time to live in milliseconds. Example: "86400000".
- * @property {string} deleteNoneActiveUsersAfterDays - Delete none active users after days. Example: "30".
- * @property {string} systemCodeTlsSec - System code time to live in seconds. Example: "86400".
- * @property {string} systemCodeLength - System code length. Example: "6".
+ * @property {string} refreshTokenTtlMc - Lifetime of the refresh token, in milliseconds. Example: "86400000".
+ * @property {string} deleteNoneActiveUsersAfterDays - Number of days after which inactive users are deleted. Example: "30".
+ * @property {string} systemCodeTlsSec - Lifetime of the one-time code, in seconds. Example: "86400".
+ * @property {string} systemCodeLength - Length of the one-time code. Example: "6".
  * @property {string | null} oauthAuthUrl - OAuth authorization URL. Example: null.
- * @property {string | null} systemCodeOnlyNumbers - System code only numbers flag. Example: null.
+ * @property {string | null} systemCodeOnlyNumbers - Whether the one-time code uses digits only; `null` when not set. Example: null.
  */
 interface IAuthProvidersEntityConfig {
     accessTokenTtlSec: string;
@@ -374,7 +375,7 @@ interface IAuthProvidersEntityConfig {
 /**
  * Authentication data object.
  * @interface IAuthData
- * @property {string} marker - The marker identifying the auth field. Example: "login".
+ * @property {string} marker - Marker of the auth form field. Example: "login".
  * @property {string} value - The value of the auth field. Example: "user@example.com".
  */
 interface IAuthData {
@@ -384,7 +385,7 @@ interface IAuthData {
 /**
  * Interface representing the body used in authentication requests.
  * @interface IAuthPostBody
- * @property {IAuthData[]} authData - An array of authentication data objects, each containing a marker and its corresponding value.
+ * @property {IAuthData[]} authData - Authentication fields, each with a `marker` and a `value`.
  * @example
     [
       {
@@ -400,16 +401,16 @@ interface IAuthPostBody {
 /**
  * Interface representing the active session data.
  * @interface IActiveSession
- * @property {object} deviceInfo - Information about the device used in the active session.
+ * @property {object} deviceInfo - Device used in the active session.
  * @example
     {
       "os": "Win32",
       "browser": "Node.js/22",
       "location": "en-US"
     }
- * @property {string} deviceInfo.os - The operating system of the active session. Example: "Win32".
- * @property {string} deviceInfo.browser - The browser used in the active session. Example: "Node.js/22".
- * @property {string} deviceInfo.location - The location of the active session. Example: "en-US".
+ * @property {string} deviceInfo.os - Operating system of the active session. Example: "Win32".
+ * @property {string} deviceInfo.browser - Browser of the active session. Example: "Node.js/22".
+ * @property {string} deviceInfo.location - Location of the active session. Example: "en-US".
  * @description This interface defines the structure of the body used in authentication requests, containing an array of authentication data.
  */
 interface IActiveSession {
@@ -417,8 +418,8 @@ interface IActiveSession {
 }
 /**
  * @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} os - Operating system of the active session. Example: "Win32".
+ * @property {string} browser - Browser of the active session. Example: "Node.js/22".
  * @property {string} location - The locale of the active session. Example: "en-US".
  * @description Information about the device tied to an active authentication session.
  */

package/esm/base/asyncModules.d.ts

@@ -82,7 +82,7 @@ export default abstract class AsyncModules extends SyncModules {
      *
      * With `isShell` disabled browserResponse throws, and the error is thrown on
      * from here too: returning it would break the `@throws` contract every caller
-     * documents, and a `try/catch` around the call would never fire (CMS-1067).
+     * documents, and a `try/catch` around the call would never fire.
      * @param {() => Promise<unknown>} request - Thunk performing the fetch call.
      * @returns {Promise<boolean | IError>} `true` on success, IError on failure when isShell=true.
      * @throws {IError} When isShell=false and the request fails.
@@ -115,7 +115,7 @@ export default abstract class AsyncModules extends SyncModules {
      * so both the success and the error branches handle empty bodies the same way.
      *
      * A body that is present but is not JSON — a gateway's HTML page in front of a
-     * 502, the platform's own admin page (CMS-957) — used to collapse into `{}`,
+     * 502, the platform's own admin page — used to collapse into `{}`,
      * which carries no `statusCode` and therefore does not read as an error at all:
      * a failed request came back looking like an empty success. It is described
      * instead, keeping the status the server actually sent.
@@ -135,8 +135,8 @@ export default abstract class AsyncModules extends SyncModules {
      * Describes a response whose body is not the JSON the API is supposed to send.
      *
      * The platform has been seen answering `200 OK` with `content-type: text/html`
-     * and the admin page as the body — every content endpoint at once, for minutes
-     * (CMS-957). A successful status carrying someone else's body is indistinguishable
+     * and the admin page as the body — every content endpoint at once, for minutes.
+     * A successful status carrying someone else's body is indistinguishable
      * from a real answer by status alone, and the only symptom used to be
      * `SyntaxError: Unexpected token '<'` from the JSON parser: a message about the
      * SDK's own parsing rather than about what the platform did. Callers read that as
@@ -157,9 +157,9 @@ export default abstract class AsyncModules extends SyncModules {
      * With `isShell` on, a failure is returned rather than thrown — and a dropped
      * connection throws a `TypeError`, whose `message` and `stack` are not
      * enumerable. Returned as it was, it serializes to `{}` and reads exactly
-     * like an empty answer: on the sanbenitocog pilot such a value entered the
+     * like an empty answer: such a value has entered a site's
      * page cache and was served for minutes after the link came back, and
-     * `next build` baked a site of 404s while reporting success (CMS-780).
+     * `next build` baked a site of 404s while reporting success.
      *
      * An object that already carries a `statusCode` is the platform's own error
      * and is passed through untouched. Everything else becomes

package/esm/base/asyncModules.js

@@ -133,7 +133,7 @@ export default class AsyncModules extends SyncModules {
      *
      * With `isShell` disabled browserResponse throws, and the error is thrown on
      * from here too: returning it would break the `@throws` contract every caller
-     * documents, and a `try/catch` around the call would never fire (CMS-1067).
+     * documents, and a `try/catch` around the call would never fire.
      * @param {() => Promise<unknown>} request - Thunk performing the fetch call.
      * @returns {Promise<boolean | IError>} `true` on success, IError on failure when isShell=true.
      * @throws {IError} When isShell=false and the request fails.
@@ -296,7 +296,7 @@ export default class AsyncModules extends SyncModules {
      * so both the success and the error branches handle empty bodies the same way.
      *
      * A body that is present but is not JSON — a gateway's HTML page in front of a
-     * 502, the platform's own admin page (CMS-957) — used to collapse into `{}`,
+     * 502, the platform's own admin page — used to collapse into `{}`,
      * which carries no `statusCode` and therefore does not read as an error at all:
      * a failed request came back looking like an empty success. It is described
      * instead, keeping the status the server actually sent.
@@ -420,8 +420,8 @@ export default class AsyncModules extends SyncModules {
      * Describes a response whose body is not the JSON the API is supposed to send.
      *
      * The platform has been seen answering `200 OK` with `content-type: text/html`
-     * and the admin page as the body — every content endpoint at once, for minutes
-     * (CMS-957). A successful status carrying someone else's body is indistinguishable
+     * and the admin page as the body — every content endpoint at once, for minutes.
+     * A successful status carrying someone else's body is indistinguishable
      * from a real answer by status alone, and the only symptom used to be
      * `SyntaxError: Unexpected token '<'` from the JSON parser: a message about the
      * SDK's own parsing rather than about what the platform did. Callers read that as
@@ -456,9 +456,9 @@ export default class AsyncModules extends SyncModules {
      * With `isShell` on, a failure is returned rather than thrown — and a dropped
      * connection throws a `TypeError`, whose `message` and `stack` are not
      * enumerable. Returned as it was, it serializes to `{}` and reads exactly
-     * like an empty answer: on the sanbenitocog pilot such a value entered the
+     * like an empty answer: such a value has entered a site's
      * page cache and was served for minutes after the link came back, and
-     * `next build` baked a site of 404s while reporting success (CMS-780).
+     * `next build` baked a site of 404s while reporting success.
      *
      * An object that already carries a `statusCode` is the platform's own error
      * and is passed through untouched. Everything else becomes

package/esm/base/syncModules.d.ts

@@ -88,7 +88,7 @@ export default abstract class SyncModules {
      * calls, a shared default. Normalizing in place sends the already-wrapped
      * value the second time, it is wrapped again, and the platform answers
      * `400 "formData.en_US[0].marker" is required` about a field the caller
-     * never sent (CMS-909).
+     * never sent.
      * @param {any} body - The body to normalize. Left unchanged.
      * @param {string} [langCode] - The language code for normalization.
      * @returns {any} A normalized copy of the body.

package/esm/base/syncModules.js

@@ -225,7 +225,7 @@ export default class SyncModules {
      * calls, a shared default. Normalizing in place sends the already-wrapped
      * value the second time, it is wrapped again, and the platform answers
      * `400 "formData.en_US[0].marker" is required` about a field the caller
-     * never sent (CMS-909).
+     * never sent.
      * @param {any} body - The body to normalize. Left unchanged.
      * @param {string} [langCode] - The language code for normalization.
      * @returns {any} A normalized copy of the body.

package/esm/base/utils.d.ts

@@ -431,7 +431,7 @@ interface IHttpHeaders {
  * @interface IHttpOptions
  * @property {string} method - HTTP method
  * @property {IHttpHeaders} headers - HTTP headers
- * @property {string | FormData | Blob} [body] - Request body
+ * @property {string | FormData | Blob} [body] - Request body.
  * @description Interface for HTTP request options
  */
 interface IHttpOptions {
@@ -443,8 +443,8 @@ interface IHttpOptions {
  * Response of a semantic (vector) search: the module's own list container plus `indexReady`.
  * @typedef {object} IVectorSearchResponse
  * @template T
- * @property {boolean} indexReady - `false` when no vectors are built yet for this entity and language: the query was not embedded, and empty `items` do not mean "nothing matched". `true` — an honest search result.
- * @description Every `…/vector/search` endpoint answers with `indexReady` next to its list (CMS-1074).
+ * @property {boolean} indexReady - `false` when no vectors are built yet for this entity and language: the query was not embedded, so empty `items` do not mean that nothing matched. `true` means the result comes from a real search.
+ * @description Every `…/vector/search` endpoint answers with `indexReady` next to its list.
  */
 type IVectorSearchResponse<T> = T & {
     indexReady: boolean;

package/esm/base/validation.d.ts

@@ -74,7 +74,7 @@ export declare const UserEntitySchema: 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/base/validation.js

@@ -137,7 +137,7 @@ export const UserEntitySchema = z.object({
     authProviderIdentifier: z.string(),
     formData: z.union([z.array(z.any()), z.record(z.string(), z.any())]),
     formIdentifier: z.string(),
-    total: z.string(),
+    total: z.string().optional(),
     groups: z.array(z.union([z.string(), z.number()])),
     state: z.record(z.string(), z.any()),
     moduleFormConfigs: z.array(z.any()).optional(),

package/esm/blocks/blocksApi.d.ts

@@ -23,8 +23,8 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @handleName getBlocks
      * @param {BlockType} [type] - Optional block type to filter by. Available values: "product" | "error_page" | "catalog_page" | "product_preview" | "similar_products_block" | "product_block" | "frequently_ordered_block" | "trending_block" | "recently_viewed_block" | "repeat_purchase_block" | "slider_block" | "personal_recommendations_block" | "cart_complement_block" | "cart_similar_block" | "wishlist_similar_block" | "form" | "common_page" | "common_block" | "order" | "service" | "external_page" | "discount" (see BlockType). When omitted, blocks of all types are returned. Example: 'product'.
      * @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<IBlocksResponse | IError>} Returns BlocksEntity object.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getBlocks getBlocks} documentation.
@@ -33,10 +33,10 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
     /**
      * Get block by marker.
      * @handleName getBlockByMarker
-     * @param {string} marker - Marker of Block. Example: "product_block".
+     * @param {string} marker - Marker of the block. Example: "product_block".
      * @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<IBlockEntity | IError>} - Returns a BlockEntity object.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description This method retrieves a block by its marker and includes additional information such as similar products or products associated with the block.
@@ -64,9 +64,9 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @handleName getSimilarProducts
      * @param {string} marker - Block identifier. Example: "similar_products_block".
      * @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 {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
+     * @param {number} [offset] - Number of records to skip. Default: 0.
+     * @param {number} [limit] - Maximum number of records to return. Default: 30.
+     * @param {string} [signPrice] - Marker of the order storage to fix prices for. When set, each product comes with a `signedPrice` that holds the price for a limited time.
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
      * @param {number} [productId] - Optional product id to find similar products for.
      * @returns {Promise<IProductsResponse | IError>} Returns the total count and an array of product items in object by specified block marker.
@@ -79,9 +79,9 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @handleName getProductsByBlockMarker
      * @param {string} marker - Block identifier. Example: "product_block".
      * @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 {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
+     * @param {number} [offset] - Number of records to skip. Default: 0.
+     * @param {number} [limit] - Maximum number of records to return. Default: 30.
+     * @param {string} [signPrice] - Marker of the order storage to fix prices for. When set, each product comes with a `signedPrice` that holds the price for a limited time.
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
      * @returns {Promise<IProductsEntity[] | IError>} Return array of BlocksEntity object.
      * @throws {IError} When isShell=false and an error occurs during the fetch
@@ -91,10 +91,10 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
     /**
      * Get frequently ordered products by block marker and product id.
      * @handleName getFrequentlyOrderedProducts
-     * @param {number} productId - Product id. Example: 1.
-     * @param {string} marker - Block marker. Example: "frequently_ordered_block".
+     * @param {number} productId - Product ID. Example: 1.
+     * @param {string} marker - Marker of the block. Example: "frequently_ordered_block".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
+     * @param {string} [signPrice] - Marker of the order storage to fix prices for. When set, each product comes with a `signedPrice` that holds the price for a limited time.
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
      * @param {number} [limit] - Maximum number of products to return. When omitted, the block's own quantity setting applies. Example: 10.
      * @returns {Promise<IProductsResponse | IError>} Returns a products response with items and total.
@@ -115,9 +115,9 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
     /**
      * Get "complete your cart" products by the cart from context (auth user or guest).
      * @handleName getCartComplement
-     * @param {string} marker - Block marker. Example: "cart_complement_block".
+     * @param {string} marker - Marker of the block. Example: "cart_complement_block".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
+     * @param {string} [signPrice] - Marker of the order storage to fix prices for. When set, each product comes with a `signedPrice` that holds the price for a limited time.
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
      * @param {number} [limit] - Maximum number of products to return. When omitted, the block's own quantity setting applies. Example: 10.
      * @returns {Promise<IProductsResponse | IError>} Returns an object with an array of products, total count and totalFound.
@@ -128,8 +128,8 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
     /**
      * Get "complete your cart" products by an explicit list of productIds (POST body).
      * @handleName getCartComplementByProductIds
-     * @param {string} marker - Block marker. Example: "cart_complement_block".
-     * @param {IBlockProductsLookup} body - Lookup body.
+     * @param {string} marker - Marker of the block. Example: "cart_complement_block".
+     * @param {IBlockProductsLookup} body - Lookup parameters.
      * @example
         {
           "productIds": [1, 2],
@@ -143,9 +143,9 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
     /**
      * Get "similar to cart" products by the cart from context (auth user or guest).
      * @handleName getCartSimilar
-     * @param {string} marker - Block marker. Example: "cart_similar_block".
+     * @param {string} marker - Marker of the block. Example: "cart_similar_block".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
+     * @param {string} [signPrice] - Marker of the order storage to fix prices for. When set, each product comes with a `signedPrice` that holds the price for a limited time.
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
      * @param {number} [limit] - Maximum number of products to return. When omitted, the block's own quantity setting applies. Example: 10.
      * @returns {Promise<IProductsResponse | IError>} Returns an object with an array of products, total count and totalFound.
@@ -156,8 +156,8 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
     /**
      * Get "similar to cart" products by an explicit list of productIds (POST body).
      * @handleName getCartSimilarByProductIds
-     * @param {string} marker - Block marker. Example: "cart_similar_block".
-     * @param {IBlockProductsLookup} body - Lookup body.
+     * @param {string} marker - Marker of the block. Example: "cart_similar_block".
+     * @param {IBlockProductsLookup} body - Lookup parameters.
      * @example
         {
           "productIds": [1, 2],
@@ -171,9 +171,9 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
     /**
      * Get personal recommendations for the user.
      * @handleName getPersonalRecommendations
-     * @param {string} marker - Block marker. Example: "personal_recommendations_block".
+     * @param {string} marker - Marker of the block. Example: "personal_recommendations_block".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
+     * @param {string} [signPrice] - Marker of the order storage to fix prices for. When set, each product comes with a `signedPrice` that holds the price for a limited time.
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
      * @param {number} [limit] - Maximum number of products to return. When omitted, the block's own quantity setting applies. Example: 10.
      * @returns {Promise<IProductsResponse | IError>} Returns an object with an array of products, total count and totalFound.
@@ -184,9 +184,9 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
     /**
      * Get recently viewed products.
      * @handleName getRecentlyViewed
-     * @param {string} marker - Block marker. Example: "recently_viewed_block".
+     * @param {string} marker - Marker of the block. Example: "recently_viewed_block".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
+     * @param {string} [signPrice] - Marker of the order storage to fix prices for. When set, each product comes with a `signedPrice` that holds the price for a limited time.
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
      * @param {number} [limit] - Maximum number of products to return. When omitted, the block's own quantity setting applies. Example: 10.
      * @returns {Promise<IProductsResponse | IError>} Returns an object with an array of products, total count and totalFound.
@@ -197,9 +197,9 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
     /**
      * Get products for repeat purchase.
      * @handleName getRepeatPurchase
-     * @param {string} marker - Block marker. Example: "repeat_purchase_block".
+     * @param {string} marker - Marker of the block. Example: "repeat_purchase_block".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
+     * @param {string} [signPrice] - Marker of the order storage to fix prices for. When set, each product comes with a `signedPrice` that holds the price for a limited time.
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
      * @param {number} [limit] - Maximum number of products to return. When omitted, the block's own quantity setting applies. Example: 10.
      * @returns {Promise<IProductsResponse | IError>} Returns an object with an array of products, total count and totalFound.
@@ -210,7 +210,7 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
     /**
      * Get the block's slides tree as a flat pre-order array (slider_block only).
      * @handleName getSlides
-     * @param {string} marker - Block marker. Example: "slider_block".
+     * @param {string} marker - Marker of the block. Example: "slider_block".
      * @returns {Promise<IBlockSlidesResponse | IError>} Returns the slides response.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getSlides getSlides} documentation.
@@ -219,9 +219,9 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
     /**
      * Get trending products of the block.
      * @handleName getTrending
-     * @param {string} marker - Block marker. Example: "trending_block".
+     * @param {string} marker - Marker of the block. Example: "trending_block".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
+     * @param {string} [signPrice] - Marker of the order storage to fix prices for. When set, each product comes with a `signedPrice` that holds the price for a limited time.
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
      * @param {number} [limit] - Maximum number of products to return. When omitted, the block's own quantity setting applies. Example: 10.
      * @returns {Promise<IProductsResponse | IError>} Returns an object with an array of products, total count and totalFound.
@@ -232,9 +232,9 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
     /**
      * Get "similar to wishlist" products by the wishlist from context (auth user or guest).
      * @handleName getWishlistSimilar
-     * @param {string} marker - Block marker. Example: "wishlist_similar_block".
+     * @param {string} marker - Marker of the block. Example: "wishlist_similar_block".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
+     * @param {string} [signPrice] - Marker of the order storage to fix prices for. When set, each product comes with a `signedPrice` that holds the price for a limited time.
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
      * @param {number} [limit] - Maximum number of products to return. When omitted, the block's own quantity setting applies. Example: 10.
      * @returns {Promise<IProductsResponse | IError>} Returns an object with an array of products, total count and totalFound.
@@ -245,8 +245,8 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
     /**
      * Get "similar to wishlist" products by an explicit list of productIds (POST body).
      * @handleName getWishlistSimilarByProductIds
-     * @param {string} marker - Block marker. Example: "wishlist_similar_block".
-     * @param {IBlockProductsLookup} body - Lookup body.
+     * @param {string} marker - Marker of the block. Example: "wishlist_similar_block".
+     * @param {IBlockProductsLookup} body - Lookup parameters.
      * @example
         {
           "productIds": [1, 2],