oneentry 1.0.152 → 1.0.154

package/dist/blocks/blocksApi.d.ts

@@ -27,6 +27,7 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @param {number} [limit] - Parameter for pagination. 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.
      */
     getBlocks(type?: BlockType, langCode?: string, offset?: number, limit?: number): Promise<IBlocksResponse | IError>;
     /**
@@ -39,8 +40,25 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @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.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getBlockByMarker getBlockByMarker} documentation.
      */
     getBlockByMarker(marker: string, langCode?: string, offset?: number, limit?: number): Promise<IBlockEntity | IError>;
+    /**
+     * Enrich a single block in place.
+     *
+     * Lifts product display settings from `customSettings.productConfig` to
+     * numeric top-level fields, strips internal-only fields, and — when
+     * `loadProducts` is true — fetches the related products for
+     * `similar_products_block` / `product_block` blocks. Shared by `getBlocks`
+     * (array) and `getBlockByMarker` (single block). Mutates `block` in place.
+     * @param {any} block - Normalized block to enrich (mutated in place).
+     * @param {string} langCode - Language code passed to product sub-requests.
+     * @param {number} offset - Pagination offset for product sub-requests.
+     * @param {number} limit - Pagination limit for product sub-requests.
+     * @param {boolean} loadProducts - Whether to fetch related products.
+     * @returns {Promise<void>} Resolves when enrichment (incl. sub-requests) is done.
+     */
+    private _enrichBlock;
     /**
      * Get similar products by block marker.
      * @handleName getSimilarProducts
@@ -48,10 +66,12 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @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] - Sign price.
+     * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain 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.
+     * @returns {Promise<IProductsResponse | IError>} Returns the total count and an array of product items in object by specified block marker.
      * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getSimilarProducts getSimilarProducts} documentation.
      */
     private getSimilarProducts;
     /**
@@ -61,9 +81,11 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @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] - Sign price.
+     * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain 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
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getProductsByBlockMarker getProductsByBlockMarker} documentation.
      */
     private getProductsByBlockMarker;
     /**
@@ -72,9 +94,11 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @param {number} productId - Product id. Example: 1.
      * @param {string} marker - Block marker. Example: "frequently_ordered_block".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {string} [signPrice] - Sign price.
+     * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
      * @returns {Promise<IProductsResponse | IError>} Returns a products response with items and total.
      * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getFrequentlyOrderedProducts getFrequentlyOrderedProducts} documentation.
      */
     getFrequentlyOrderedProducts(productId: number, marker: string, langCode?: string, signPrice?: string): Promise<IProductsResponse | IError>;
     /**
@@ -84,6 +108,7 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @returns {Promise<ISearchBlock[] | IError>} Returns an array of ISearchBlock objects.
      * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/searchBlock searchBlock} documentation.
      */
     searchBlock(name: string, langCode?: string): Promise<ISearchBlock[] | IError>;
     /**
@@ -91,9 +116,11 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @handleName getCartComplement
      * @param {string} marker - Block marker. Example: "cart_complement_block".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {string} [signPrice] - Sign price.
+     * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
      * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
      * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getCartComplement getCartComplement} documentation.
      */
     getCartComplement(marker: string, langCode?: string, signPrice?: string): Promise<IProductsEntity[] | IError>;
     /**
@@ -108,6 +135,7 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
         }
      * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
      * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getCartComplementByProductIds getCartComplementByProductIds} documentation.
      */
     getCartComplementByProductIds(marker: string, body: IBlockProductsLookup): Promise<IProductsEntity[] | IError>;
     /**
@@ -115,9 +143,11 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @handleName getCartSimilar
      * @param {string} marker - Block marker. Example: "cart_similar_block".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {string} [signPrice] - Sign price.
+     * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
      * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
      * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getCartSimilar getCartSimilar} documentation.
      */
     getCartSimilar(marker: string, langCode?: string, signPrice?: string): Promise<IProductsEntity[] | IError>;
     /**
@@ -132,6 +162,7 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
         }
      * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
      * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getCartSimilarByProductIds getCartSimilarByProductIds} documentation.
      */
     getCartSimilarByProductIds(marker: string, body: IBlockProductsLookup): Promise<IProductsEntity[] | IError>;
     /**
@@ -139,9 +170,11 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @handleName getPersonalRecommendations
      * @param {string} marker - Block marker. Example: "personal_recommendations_block".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {string} [signPrice] - Sign price.
+     * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
      * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
      * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getPersonalRecommendations getPersonalRecommendations} documentation.
      */
     getPersonalRecommendations(marker: string, langCode?: string, signPrice?: string): Promise<IProductsEntity[] | IError>;
     /**
@@ -149,9 +182,11 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @handleName getRecentlyViewed
      * @param {string} marker - Block marker. Example: "recently_viewed_block".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {string} [signPrice] - Sign price.
+     * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
      * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
      * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getRecentlyViewed getRecentlyViewed} documentation.
      */
     getRecentlyViewed(marker: string, langCode?: string, signPrice?: string): Promise<IProductsEntity[] | IError>;
     /**
@@ -159,9 +194,11 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @handleName getRepeatPurchase
      * @param {string} marker - Block marker. Example: "repeat_purchase_block".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {string} [signPrice] - Sign price.
+     * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
      * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
      * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getRepeatPurchase getRepeatPurchase} documentation.
      */
     getRepeatPurchase(marker: string, langCode?: string, signPrice?: string): Promise<IProductsEntity[] | IError>;
     /**
@@ -170,6 +207,7 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @param {string} marker - Block marker. 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.
      */
     getSlides(marker: string): Promise<IBlockSlidesResponse | IError>;
     /**
@@ -177,9 +215,11 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @handleName getTrending
      * @param {string} marker - Block marker. Example: "trending_block".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {string} [signPrice] - Sign price.
+     * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
      * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
      * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getTrending getTrending} documentation.
      */
     getTrending(marker: string, langCode?: string, signPrice?: string): Promise<IProductsEntity[] | IError>;
     /**
@@ -187,9 +227,11 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @handleName getWishlistSimilar
      * @param {string} marker - Block marker. Example: "wishlist_similar_block".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {string} [signPrice] - Sign price.
+     * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
      * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
      * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getWishlistSimilar getWishlistSimilar} documentation.
      */
     getWishlistSimilar(marker: string, langCode?: string, signPrice?: string): Promise<IProductsEntity[] | IError>;
     /**
@@ -204,6 +246,7 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
         }
      * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
      * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getWishlistSimilarByProductIds getWishlistSimilarByProductIds} documentation.
      */
     getWishlistSimilarByProductIds(marker: string, body: IBlockProductsLookup): Promise<IProductsEntity[] | IError>;
 }

package/dist/blocks/blocksApi.js

@@ -3,6 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+/* eslint-disable jsdoc/reject-any-type */
 /* eslint-disable @typescript-eslint/no-explicit-any */
 const asyncModules_1 = __importDefault(require("../base/asyncModules"));
 const blocksSchemas_1 = require("./blocksSchemas");
@@ -31,6 +32,7 @@ class BlocksApi extends asyncModules_1.default {
      * @param {number} [limit] - Parameter for pagination. 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.
      */
     async getBlocks(type, langCode = this.state.lang, offset = 0, limit = 30) {
         // type is omitted from the query when not provided — the API rejects an
@@ -41,41 +43,8 @@ class BlocksApi extends asyncModules_1.default {
         const validated = this._validateResponse(response, blocksSchemas_1.BlocksResponseSchema);
         if (!this.state.traficLimit) {
             const normalizeResponse = this._normalizeData(validated);
-            await Promise.all(normalizeResponse.items.map(async (block) => {
-                const customSettings = block.customSettings;
-                if (customSettings &&
-                    Object.prototype.hasOwnProperty.call(customSettings, 'productConfig')) {
-                    if (customSettings.productConfig.countElementsPerRow)
-                        block.countElementsPerRow =
-                            +customSettings.productConfig.countElementsPerRow;
-                    if (customSettings.productConfig.quantity)
-                        block.quantity = +customSettings.productConfig.quantity;
-                }
-                delete block.customSettings;
-                delete block.attributesSetIdentifier;
-                delete block.productPageUrls;
-                if (block.type === 'similar_products_block') {
-                    try {
-                        await this.getSimilarProducts(block.identifier, langCode, offset, limit).then((result) => {
-                            block.similarProducts = result;
-                        });
-                    }
-                    catch {
-                        block.similarProducts = [];
-                    }
-                }
-                else if (block.type === 'product_block') {
-                    try {
-                        await this.getProductsByBlockMarker(block.identifier, langCode, offset, limit).then((result) => {
-                            block.products = result;
-                        });
-                    }
-                    catch {
-                        block.products = [];
-                    }
-                }
-            }));
-            return this._normalizeData(normalizeResponse);
+            await Promise.all(normalizeResponse.items.map((block) => this._enrichBlock(block, langCode, offset, limit, true)));
+            return normalizeResponse;
         }
         return this._normalizeData(validated);
     }
@@ -89,47 +58,70 @@ class BlocksApi extends asyncModules_1.default {
      * @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.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getBlockByMarker getBlockByMarker} documentation.
      */
     async getBlockByMarker(marker, langCode = this.state.lang, offset = 0, limit = 30) {
         const response = await this._fetchGet(`/marker/${marker}?langCode=${langCode}`);
         // Validate response if validation is enabled
         const validated = this._validateResponse(response, blocksSchemas_1.BlockEntitySchema);
         const normalizeResponse = this._normalizeData(validated);
-        const customSettings = normalizeResponse.customSettings;
+        await this._enrichBlock(normalizeResponse, langCode, offset, limit, !this.state.traficLimit);
+        return normalizeResponse;
+    }
+    /**
+     * Enrich a single block in place.
+     *
+     * Lifts product display settings from `customSettings.productConfig` to
+     * numeric top-level fields, strips internal-only fields, and — when
+     * `loadProducts` is true — fetches the related products for
+     * `similar_products_block` / `product_block` blocks. Shared by `getBlocks`
+     * (array) and `getBlockByMarker` (single block). Mutates `block` in place.
+     * @param {any} block - Normalized block to enrich (mutated in place).
+     * @param {string} langCode - Language code passed to product sub-requests.
+     * @param {number} offset - Pagination offset for product sub-requests.
+     * @param {number} limit - Pagination limit for product sub-requests.
+     * @param {boolean} loadProducts - Whether to fetch related products.
+     * @returns {Promise<void>} Resolves when enrichment (incl. sub-requests) is done.
+     */
+    async _enrichBlock(block, langCode, offset, limit, loadProducts) {
+        const customSettings = block.customSettings;
+        // Если у блока есть настройки отображения товаров (productConfig) —
+        // переносим их на верхний уровень блока в числовом формате (в API значения
+        // хранятся строками, поэтому приводим через «+»).
         if (customSettings &&
             Object.prototype.hasOwnProperty.call(customSettings, 'productConfig')) {
             if (customSettings.productConfig.countElementsPerRow)
-                normalizeResponse.countElementsPerRow =
+                block.countElementsPerRow =
                     +customSettings.productConfig.countElementsPerRow;
             if (customSettings.productConfig.quantity)
-                normalizeResponse.quantity = +customSettings.productConfig.quantity;
+                block.quantity = +customSettings.productConfig.quantity;
         }
-        delete normalizeResponse.customSettings;
-        delete normalizeResponse.attributesSetIdentifier;
-        delete normalizeResponse.productPageUrls;
-        if (!this.state.traficLimit) {
-            if (normalizeResponse.type === 'similar_products_block') {
-                try {
-                    await this.getSimilarProducts(normalizeResponse.identifier, langCode, offset, limit).then((result) => {
-                        normalizeResponse.similarProducts = result;
-                    });
-                }
-                catch {
-                    normalizeResponse.similarProducts = [];
-                }
+        // Убираем служебные/внутренние поля из итогового объекта блока.
+        delete block.customSettings;
+        delete block.attributesSetIdentifier;
+        delete block.productPageUrls;
+        // В режиме экономии трафика товары не подгружаем.
+        if (!loadProducts)
+            return;
+        // Подгружаем связанные товары по идентификатору блока. При ошибке запроса
+        // подставляем пустой массив, чтобы один упавший подзапрос не ронял весь
+        // ответ (в getBlocks — не ломал обработку остальных блоков).
+        if (block.type === 'similar_products_block') {
+            try {
+                block.similarProducts = await this.getSimilarProducts(block.identifier, langCode, offset, limit);
+            }
+            catch {
+                block.similarProducts = [];
+            }
+        }
+        else if (block.type === 'product_block') {
+            try {
+                block.products = await this.getProductsByBlockMarker(block.identifier, langCode, offset, limit);
             }
-            else if (normalizeResponse.type === 'product_block') {
-                try {
-                    await this.getProductsByBlockMarker(normalizeResponse.identifier, langCode, offset, limit).then((result) => {
-                        normalizeResponse.products = result;
-                    });
-                }
-                catch {
-                    normalizeResponse.products = [];
-                }
+            catch {
+                block.products = [];
             }
         }
-        return this._normalizeData(normalizeResponse);
     }
     /**
      * Get similar products by block marker.
@@ -138,10 +130,12 @@ class BlocksApi extends asyncModules_1.default {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {number} [offset] - Parameter for pagination. Default: 0.
      * @param {number} [limit] - Parameter for pagination. Default: 30.
-     * @param {string} [signPrice] - Sign price.
+     * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain 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.
+     * @returns {Promise<IProductsResponse | IError>} Returns the total count and an array of product items in object by specified block marker.
      * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getSimilarProducts getSimilarProducts} documentation.
      */
     async getSimilarProducts(marker, langCode = this.state.lang, offset = 0, limit = 30, signPrice, productId) {
         const query = {
@@ -161,9 +155,11 @@ class BlocksApi extends asyncModules_1.default {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {number} [offset] - Parameter for pagination. Default: 0.
      * @param {number} [limit] - Parameter for pagination. Default: 30.
-     * @param {string} [signPrice] - Sign price.
+     * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain 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
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getProductsByBlockMarker getProductsByBlockMarker} documentation.
      */
     async getProductsByBlockMarker(marker, langCode = this.state.lang, offset = 0, limit = 30, signPrice) {
         const query = {
@@ -181,9 +177,11 @@ class BlocksApi extends asyncModules_1.default {
      * @param {number} productId - Product id. Example: 1.
      * @param {string} marker - Block marker. Example: "frequently_ordered_block".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {string} [signPrice] - Sign price.
+     * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
      * @returns {Promise<IProductsResponse | IError>} Returns a products response with items and total.
      * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getFrequentlyOrderedProducts getFrequentlyOrderedProducts} documentation.
      */
     async getFrequentlyOrderedProducts(productId, marker, langCode = this.state.lang, signPrice) {
         const query = {
@@ -201,9 +199,10 @@ class BlocksApi extends asyncModules_1.default {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @returns {Promise<ISearchBlock[] | IError>} Returns an array of ISearchBlock objects.
      * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/searchBlock searchBlock} documentation.
      */
     async searchBlock(name, langCode = this.state.lang) {
-        const result = await this._fetchGet(`/quick/search?langCode=${langCode}&name=${name}`);
+        const result = await this._fetchGet(`/quick/search?langCode=${encodeURIComponent(langCode)}&name=${encodeURIComponent(name)}`);
         // Validate response if validation is enabled
         const validated = this._validateResponse(result, blocksSchemas_1.SearchBlocksResponseSchema);
         return validated;
@@ -213,9 +212,11 @@ class BlocksApi extends asyncModules_1.default {
      * @handleName getCartComplement
      * @param {string} marker - Block marker. Example: "cart_complement_block".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {string} [signPrice] - Sign price.
+     * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
      * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
      * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getCartComplement getCartComplement} documentation.
      */
     async getCartComplement(marker, langCode = this.state.lang, signPrice) {
         const query = { langCode, signPrice };
@@ -234,6 +235,7 @@ class BlocksApi extends asyncModules_1.default {
         }
      * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
      * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getCartComplementByProductIds getCartComplementByProductIds} documentation.
      */
     async getCartComplementByProductIds(marker, body) {
         const data = await this._fetchPost(`/${marker}/cart-complement`, { langCode: this.state.lang, ...body });
@@ -244,9 +246,11 @@ class BlocksApi extends asyncModules_1.default {
      * @handleName getCartSimilar
      * @param {string} marker - Block marker. Example: "cart_similar_block".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {string} [signPrice] - Sign price.
+     * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
      * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
      * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getCartSimilar getCartSimilar} documentation.
      */
     async getCartSimilar(marker, langCode = this.state.lang, signPrice) {
         const query = { langCode, signPrice };
@@ -265,6 +269,7 @@ class BlocksApi extends asyncModules_1.default {
         }
      * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
      * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getCartSimilarByProductIds getCartSimilarByProductIds} documentation.
      */
     async getCartSimilarByProductIds(marker, body) {
         const data = await this._fetchPost(`/${marker}/cart-similar`, { langCode: this.state.lang, ...body });
@@ -275,9 +280,11 @@ class BlocksApi extends asyncModules_1.default {
      * @handleName getPersonalRecommendations
      * @param {string} marker - Block marker. Example: "personal_recommendations_block".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {string} [signPrice] - Sign price.
+     * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
      * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
      * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getPersonalRecommendations getPersonalRecommendations} documentation.
      */
     async getPersonalRecommendations(marker, langCode = this.state.lang, signPrice) {
         const query = { langCode, signPrice };
@@ -289,9 +296,11 @@ class BlocksApi extends asyncModules_1.default {
      * @handleName getRecentlyViewed
      * @param {string} marker - Block marker. Example: "recently_viewed_block".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {string} [signPrice] - Sign price.
+     * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
      * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
      * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getRecentlyViewed getRecentlyViewed} documentation.
      */
     async getRecentlyViewed(marker, langCode = this.state.lang, signPrice) {
         const query = { langCode, signPrice };
@@ -303,9 +312,11 @@ class BlocksApi extends asyncModules_1.default {
      * @handleName getRepeatPurchase
      * @param {string} marker - Block marker. Example: "repeat_purchase_block".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {string} [signPrice] - Sign price.
+     * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
      * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
      * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getRepeatPurchase getRepeatPurchase} documentation.
      */
     async getRepeatPurchase(marker, langCode = this.state.lang, signPrice) {
         const query = { langCode, signPrice };
@@ -318,6 +329,7 @@ class BlocksApi extends asyncModules_1.default {
      * @param {string} marker - Block marker. 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.
      */
     async getSlides(marker) {
         const data = await this._fetchGet(`/${marker}/slides`);
@@ -328,9 +340,11 @@ class BlocksApi extends asyncModules_1.default {
      * @handleName getTrending
      * @param {string} marker - Block marker. Example: "trending_block".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {string} [signPrice] - Sign price.
+     * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
      * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
      * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getTrending getTrending} documentation.
      */
     async getTrending(marker, langCode = this.state.lang, signPrice) {
         const query = { langCode, signPrice };
@@ -342,9 +356,11 @@ class BlocksApi extends asyncModules_1.default {
      * @handleName getWishlistSimilar
      * @param {string} marker - Block marker. Example: "wishlist_similar_block".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {string} [signPrice] - Sign price.
+     * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
      * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
      * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getWishlistSimilar getWishlistSimilar} documentation.
      */
     async getWishlistSimilar(marker, langCode = this.state.lang, signPrice) {
         const query = { langCode, signPrice };
@@ -363,6 +379,7 @@ class BlocksApi extends asyncModules_1.default {
         }
      * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
      * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getWishlistSimilarByProductIds getWishlistSimilarByProductIds} documentation.
      */
     async getWishlistSimilarByProductIds(marker, body) {
         const data = await this._fetchPost(`/${marker}/wishlist-similar`, { langCode: this.state.lang, ...body });

package/dist/blocks/blocksInterfaces.d.ts

@@ -46,7 +46,8 @@ interface IBlocks {
      * @param {number} productId - Product id. Example: 1.
      * @param {string} marker - Block marker. Example: "frequently_ordered_block".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {string} [signPrice] - Sign price.
+     * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
      * @returns {IProductsResponse} A promise that resolves to a products response (items + total) or an error.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      */
@@ -56,7 +57,8 @@ interface IBlocks {
      * @handleName getCartComplement
      * @param {string} marker - Block marker. Example: "cart_complement_block".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {string} [signPrice] - Sign price.
+     * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
      * @returns {IProductsEntity[]} A promise that resolves to an array of products or an error.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      */
@@ -80,7 +82,8 @@ interface IBlocks {
      * @handleName getCartSimilar
      * @param {string} marker - Block marker. Example: "cart_similar_block".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {string} [signPrice] - Sign price.
+     * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
      * @returns {IProductsEntity[]} A promise that resolves to an array of products or an error.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      */
@@ -104,7 +107,8 @@ interface IBlocks {
      * @handleName getPersonalRecommendations
      * @param {string} marker - Block marker. Example: "personal_recommendations_block".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {string} [signPrice] - Sign price.
+     * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
      * @returns {IProductsEntity[]} A promise that resolves to an array of products or an error.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      */
@@ -114,7 +118,8 @@ interface IBlocks {
      * @handleName getRecentlyViewed
      * @param {string} marker - Block marker. Example: "recently_viewed_block".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {string} [signPrice] - Sign price.
+     * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
      * @returns {IProductsEntity[]} A promise that resolves to an array of products or an error.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      */
@@ -124,7 +129,8 @@ interface IBlocks {
      * @handleName getRepeatPurchase
      * @param {string} marker - Block marker. Example: "repeat_purchase_block".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {string} [signPrice] - Sign price.
+     * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
      * @returns {IProductsEntity[]} A promise that resolves to an array of products or an error.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      */
@@ -142,7 +148,8 @@ interface IBlocks {
      * @handleName getTrending
      * @param {string} marker - Block marker. Example: "trending_block".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {string} [signPrice] - Sign price.
+     * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
      * @returns {IProductsEntity[]} A promise that resolves to an array of products or an error.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      */
@@ -152,7 +159,8 @@ interface IBlocks {
      * @handleName getWishlistSimilar
      * @param {string} marker - Block marker. Example: "wishlist_similar_block".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {string} [signPrice] - Sign price.
+     * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
      * @returns {IProductsEntity[]} A promise that resolves to an array of products or an error.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      */
@@ -302,7 +310,8 @@ type BlockType = 'product' | 'error_page' | 'catalog_page' | 'product_preview' |
  * @property {number[]} productIds - Product identifiers to look up. Example: [1, 2, 3].
  * @property {string} [langCode] - Language code. Default: "en_US".
  * @property {number} [limit] - Max number of products to return. Example: 10.
- * @property {string} [signPrice] - Sign price.
+ * @property {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
+ * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
  * @description Body for the POST block product endpoints (cart-complement / cart-similar / wishlist-similar) that accept an explicit list of productIds.
  */
 interface IBlockProductsLookup {