oneentry 1.0.172 → 1.0.174

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

@@ -4,7 +4,7 @@
  * @property {string} [guestId] - Guest identifier sent as the `x-guest-id` header on unauthenticated requests. Lets cart/wishlist/activity endpoints work for a guest. In the browser a stable id is auto-generated (localStorage) when omitted; on the server pass a per-visitor id. Can also be set later via `setGuestId`.
  * @property {string} [deviceMetadata] - Device-metadata string sent as the `x-device-metadata` header on POST requests and token refresh, overriding the environment-derived fingerprint. The API binds refresh tokens to this header, so server-side flows that issue tokens on behalf of a browser (e.g. an OAuth code exchange) must pass the browser's string here — otherwise the token is bound to the server's fingerprint and cannot be refreshed from the browser. Obtain the string in the browser via `getDeviceMetadata()`. Can also be set later via `setDeviceMetadata`.
  * @property {string} [langCode] - specify the default language to avoid specifying it in every request.
- * @property {boolean} [traficLimit] - Some methods use multiple queries to make it easier to work with the API. Set this parameter to "false" to save traffic and decide for yourself what data you need.
+ * @property {boolean} [traficLimit] - Some methods use multiple queries to make it easier to work with the API. Set it to `true` to save traffic and decide for yourself what data you need: the SDK then skips its follow-up requests (full pages behind quick search results, products of page blocks), and some results change shape — e.g. `searchPage` returns short `{ id, title }` cards. Default: false.
  * @property {boolean} [rawData] - Set to true to keep an attribute's nested `additionalFields` as the
  * array the API sends, instead of the marker-keyed map the SDK builds by default. It turns off only that
  * transformation — locale unwrapping, sorting by `position`, single-file unwrapping and number casting
@@ -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/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],

package/esm/blocks/blocksApi.js

@@ -24,8 +24,8 @@ export default class BlocksApi extends AsyncModules {
      * @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.
@@ -52,10 +52,10 @@ export default class BlocksApi extends AsyncModules {
     /**
      * 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.
@@ -129,9 +129,9 @@ export default class BlocksApi extends AsyncModules {
      * @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.
@@ -154,9 +154,9 @@ export default class BlocksApi extends AsyncModules {
      * @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
@@ -180,10 +180,10 @@ export default class BlocksApi extends AsyncModules {
     /**
      * 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.
@@ -218,9 +218,9 @@ export default class BlocksApi extends AsyncModules {
     /**
      * 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.
@@ -235,8 +235,8 @@ export default class BlocksApi extends AsyncModules {
     /**
      * 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],
@@ -253,9 +253,9 @@ export default class BlocksApi extends AsyncModules {
     /**
      * 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.
@@ -270,8 +270,8 @@ export default class BlocksApi extends AsyncModules {
     /**
      * 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],
@@ -288,9 +288,9 @@ export default class BlocksApi extends AsyncModules {
     /**
      * 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.
@@ -305,9 +305,9 @@ export default class BlocksApi extends AsyncModules {
     /**
      * 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.
@@ -322,9 +322,9 @@ export default class BlocksApi extends AsyncModules {
     /**
      * 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.
@@ -339,7 +339,7 @@ export default class BlocksApi extends AsyncModules {
     /**
      * 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.
@@ -351,9 +351,9 @@ export default class BlocksApi extends AsyncModules {
     /**
      * 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.
@@ -368,9 +368,9 @@ export default class BlocksApi extends AsyncModules {
     /**
      * 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.
@@ -385,8 +385,8 @@ export default class BlocksApi extends AsyncModules {
     /**
      * 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],