oneentry 1.0.153 → 1.0.155

package/dist/base/stateModule.js

@@ -1,38 +1,9 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
 Object.defineProperty(exports, "__esModule", { value: true });
+// HTTP status codes for which a custom error handler may be configured.
+const ERROR_STATUS_CODES = [
+    400, 401, 403, 404, 429, 500, 502, 503, 504,
+];
 /**
  * State module for managing application state and configuration.
  * @description State module for managing application state and configuration.
@@ -45,7 +16,7 @@ class StateModule {
      * @description Constructor for StateModule.
      */
     constructor(url, config) {
-        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _0, _1;
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u;
         // In-flight token refresh, shared across all module instances (they share this
         // state object). De-duplicates concurrent refreshes so the single-use refresh
         // token is not burned by parallel requests. Null when no refresh is running.
@@ -56,6 +27,9 @@ class StateModule {
         // Normalize empty string to undefined: an explicit '' must not masquerade
         // as a set guest id (it would otherwise suppress id resolution).
         this.guestId = config.guestId || undefined;
+        // Same normalization as guestId: an explicit '' must not suppress the
+        // environment-derived fingerprint.
+        this.deviceMetadata = config.deviceMetadata || undefined;
         this.traficLimit = config.traficLimit || false;
         this.validationEnabled = (_c = (_b = config.validation) === null || _b === void 0 ? void 0 : _b.enabled) !== null && _c !== void 0 ? _c : false;
         this.validationStrictMode = (_e = (_d = config.validation) === null || _d === void 0 ? void 0 : _d.strictMode) !== null && _e !== void 0 ? _e : false;
@@ -64,71 +38,16 @@ class StateModule {
         this.refreshToken = (_k = (_j = config.auth) === null || _j === void 0 ? void 0 : _j.refreshToken) !== null && _k !== void 0 ? _k : undefined;
         this.providerMarker = (_m = (_l = config.auth) === null || _l === void 0 ? void 0 : _l.providerMarker) !== null && _m !== void 0 ? _m : 'email';
         this.customAuth = (_p = (_o = config.auth) === null || _o === void 0 ? void 0 : _o.customAuth) !== null && _p !== void 0 ? _p : false;
-        this.errorsFunctions = {
-            '400': undefined,
-            '401': undefined,
-            '403': undefined,
-            '404': undefined,
-            '429': undefined,
-            '500': undefined,
-            '502': undefined,
-            '503': undefined,
-            '504': undefined,
-        };
+        this.errorsFunctions = {};
         this.saveFunction = (_r = (_q = config.auth) === null || _q === void 0 ? void 0 : _q.saveFunction) !== null && _r !== void 0 ? _r : null;
-        if (config.errors) {
-            this.isShell = (_s = config.errors.isShell) !== null && _s !== void 0 ? _s : true;
-            if (config.errors.customErrors) {
-                this.errorsFunctions['400'] =
-                    (_t = config.errors.customErrors['400']) !== null && _t !== void 0 ? _t : undefined;
-                this.errorsFunctions['401'] =
-                    (_u = config.errors.customErrors['401']) !== null && _u !== void 0 ? _u : undefined;
-                this.errorsFunctions['403'] =
-                    (_v = config.errors.customErrors['403']) !== null && _v !== void 0 ? _v : undefined;
-                this.errorsFunctions['404'] =
-                    (_w = config.errors.customErrors['404']) !== null && _w !== void 0 ? _w : undefined;
-                this.errorsFunctions['429'] =
-                    (_x = config.errors.customErrors['429']) !== null && _x !== void 0 ? _x : undefined;
-                this.errorsFunctions['500'] =
-                    (_y = config.errors.customErrors['500']) !== null && _y !== void 0 ? _y : undefined;
-                this.errorsFunctions['502'] =
-                    (_z = config.errors.customErrors['502']) !== null && _z !== void 0 ? _z : undefined;
-                this.errorsFunctions['503'] =
-                    (_0 = config.errors.customErrors['503']) !== null && _0 !== void 0 ? _0 : undefined;
-                this.errorsFunctions['504'] =
-                    (_1 = config.errors.customErrors['504']) !== null && _1 !== void 0 ? _1 : undefined;
-            }
-        }
-        else {
-            this.isShell = true;
-        }
-        try {
-            if (typeof process === 'object' &&
-                +process.versions.node.split('.')[0] < 18) {
-                try {
-                    this._NO_FETCH = true;
-                    // Dynamically import https for older Node.js versions
-                    Promise.resolve().then(() => __importStar(require('https'))).then((https) => {
-                        this._https = https;
-                    })
-                        .catch(() => {
-                        this._https = null;
-                    });
-                    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+        this.isShell = (_t = (_s = config.errors) === null || _s === void 0 ? void 0 : _s.isShell) !== null && _t !== void 0 ? _t : true;
+        const customErrors = (_u = config.errors) === null || _u === void 0 ? void 0 : _u.customErrors;
+        if (customErrors) {
+            for (const code of ERROR_STATUS_CODES) {
+                if (customErrors[code]) {
+                    this.errorsFunctions[code] = customErrors[code];
                 }
-                catch (e) {
-                    this._https = null;
-                }
-            }
-            else {
-                this._NO_FETCH = false;
-                this._https = null;
             }
-            // eslint-disable-next-line @typescript-eslint/no-unused-vars
-        }
-        catch (e) {
-            this._NO_FETCH = false;
-            this._https = null;
         }
     }
 }

package/dist/base/syncModules.d.ts

@@ -40,6 +40,10 @@ export default abstract class SyncModules {
     protected _getFullPath(path: string): string;
     /**
      * Converts query parameters into a query string.
+     *
+     * Values are percent-encoded so free-text and special characters (spaces,
+     * `&`, `=`, non-ASCII) cannot corrupt the query string. Keys are known,
+     * machine-safe field names and are left as-is.
      * @param {IProductsQuery | IUploadingQuery | any} query - The query object containing key-value pairs.
      * @returns {string} A string representation of the query parameters.
      */
@@ -283,6 +287,30 @@ export default abstract class SyncModules {
      * @returns {any} The instance of SyncModules for chaining.
      */
     setGuestId(guestId: string): any;
+    /**
+     * Sets the device-metadata override in the state.
+     *
+     * Once set, the string is sent as the `x-device-metadata` header on POST
+     * requests and token refresh instead of 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 set the
+     * browser's string (obtained there via `getDeviceMetadata`). Pass an empty
+     * string to clear the override and fall back to the computed fingerprint.
+     * @param {string} deviceMetadata - The metadata string to send (empty string clears the override).
+     * @returns {any} The instance of SyncModules for chaining.
+     */
+    setDeviceMetadata(deviceMetadata: string): any;
+    /**
+     * Returns the device-metadata string the SDK sends as the `x-device-metadata` header.
+     *
+     * Public counterpart of `_getDeviceMetadata`: an explicit override (config or
+     * `setDeviceMetadata`) wins, otherwise the environment-derived fingerprint is
+     * computed. Use it in the browser to obtain the string that a server-side
+     * token-issuing flow (OAuth code exchange) must forward, so the issued refresh
+     * token stays refreshable from this browser.
+     * @returns {string} The metadata string sent with requests from this instance.
+     */
+    getDeviceMetadata(): string;
     /**
      * Get deviceMetadata
      *
@@ -309,6 +337,10 @@ export default abstract class SyncModules {
      * lives until the process restarts.
      *
      * In a Node.js environment (no `window`) returns a simplified object without screen/navigator.
+     *
+     * An explicitly provided string (`deviceMetadata` in config or `setDeviceMetadata`)
+     * takes precedence over the environment-derived fingerprint — this lets a server
+     * issue tokens bound to the browser's fingerprint (see `IConfig.deviceMetadata`).
      * @returns {string} - Returns an object containing device metadata.
      */
     protected _getDeviceMetadata(): string;

package/dist/base/syncModules.js

@@ -143,6 +143,10 @@ class SyncModules {
     }
     /**
      * Converts query parameters into a query string.
+     *
+     * Values are percent-encoded so free-text and special characters (spaces,
+     * `&`, `=`, non-ASCII) cannot corrupt the query string. Keys are known,
+     * machine-safe field names and are left as-is.
      * @param {IProductsQuery | IUploadingQuery | any} query - The query object containing key-value pairs.
      * @returns {string} A string representation of the query parameters.
      */
@@ -151,7 +155,7 @@ class SyncModules {
         // 0, false and '' are kept — they are semantically meaningful.
         return Object.keys(query)
             .filter((key) => query[key] !== null && query[key] !== undefined)
-            .map((key) => `${key}=${query[key]}`)
+            .map((key) => `${key}=${encodeURIComponent(query[key])}`)
             .join('&');
     }
     /**
@@ -694,6 +698,35 @@ class SyncModules {
         this.state.guestId = guestId || undefined;
         return this;
     }
+    /**
+     * Sets the device-metadata override in the state.
+     *
+     * Once set, the string is sent as the `x-device-metadata` header on POST
+     * requests and token refresh instead of 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 set the
+     * browser's string (obtained there via `getDeviceMetadata`). Pass an empty
+     * string to clear the override and fall back to the computed fingerprint.
+     * @param {string} deviceMetadata - The metadata string to send (empty string clears the override).
+     * @returns {any} The instance of SyncModules for chaining.
+     */
+    setDeviceMetadata(deviceMetadata) {
+        this.state.deviceMetadata = deviceMetadata || undefined;
+        return this;
+    }
+    /**
+     * Returns the device-metadata string the SDK sends as the `x-device-metadata` header.
+     *
+     * Public counterpart of `_getDeviceMetadata`: an explicit override (config or
+     * `setDeviceMetadata`) wins, otherwise the environment-derived fingerprint is
+     * computed. Use it in the browser to obtain the string that a server-side
+     * token-issuing flow (OAuth code exchange) must forward, so the issued refresh
+     * token stays refreshable from this browser.
+     * @returns {string} The metadata string sent with requests from this instance.
+     */
+    getDeviceMetadata() {
+        return this._getDeviceMetadata();
+    }
     /**
      * Get deviceMetadata
      *
@@ -720,10 +753,18 @@ class SyncModules {
      * lives until the process restarts.
      *
      * In a Node.js environment (no `window`) returns a simplified object without screen/navigator.
+     *
+     * An explicitly provided string (`deviceMetadata` in config or `setDeviceMetadata`)
+     * takes precedence over the environment-derived fingerprint — this lets a server
+     * issue tokens bound to the browser's fingerprint (see `IConfig.deviceMetadata`).
      * @returns {string} - Returns an object containing device metadata.
      */
     _getDeviceMetadata() {
         var _a;
+        // Explicit override wins: the API binds refresh tokens to this header, so
+        // server-side token issuance must be able to stamp the browser's string.
+        if (this.state.deviceMetadata)
+            return this.state.deviceMetadata;
         // Check if we're in a browser environment
         if (typeof globalThis === 'undefined') {
             return '';

package/dist/base/utils.d.ts

@@ -2,6 +2,7 @@
  * @interface IConfig
  * @property {string} [token] - If your project is protected by a token, specify this token in this parameter.
  * @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} [rawData] - Set to true to receive raw API responses without any transformation.
@@ -44,6 +45,7 @@
 interface IConfig {
     token?: string;
     guestId?: string;
+    deviceMetadata?: string;
     langCode?: string;
     traficLimit?: boolean;
     rawData?: boolean;

package/dist/blocks/blocksApi.d.ts

@@ -66,7 +66,8 @@ 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.
      * @throws {IError} When isShell=false and an error occurs during the fetch
@@ -80,7 +81,8 @@ 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.
@@ -92,7 +94,8 @@ 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.
@@ -113,7 +116,8 @@ 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.
@@ -139,7 +143,8 @@ 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.
@@ -165,7 +170,8 @@ 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.
@@ -176,7 +182,8 @@ 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.
@@ -187,7 +194,8 @@ 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.
@@ -207,7 +215,8 @@ 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.
@@ -218,7 +227,8 @@ 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.

package/dist/blocks/blocksApi.js

@@ -43,7 +43,12 @@ 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((block) => this._enrichBlock(block, langCode, offset, limit, true)));
+            // On API error responses (e.g. 403 without list permission, 422) the
+            // normalized value is an IError without `items` — skip enrichment and
+            // return it as-is
+            if (Array.isArray(normalizeResponse.items)) {
+                await Promise.all(normalizeResponse.items.map((block) => this._enrichBlock(block, langCode, offset, limit, true)));
+            }
             return normalizeResponse;
         }
         return this._normalizeData(validated);
@@ -130,7 +135,8 @@ 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.
      * @throws {IError} When isShell=false and an error occurs during the fetch
@@ -154,7 +160,8 @@ 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.
@@ -167,6 +174,11 @@ class BlocksApi extends asyncModules_1.default {
             signPrice,
         };
         const result = await this._fetchGet(`/${marker}/products?` + this._queryParamsToString(query));
+        // On API error responses there is no `items` array — return the (normalized)
+        // error as-is instead of producing `undefined` from `result.items`.
+        if (!Array.isArray(result === null || result === void 0 ? void 0 : result.items)) {
+            return this._normalizeData(result);
+        }
         return this._normalizeData(result.items);
     }
     /**
@@ -175,7 +187,8 @@ 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.
@@ -199,7 +212,7 @@ class BlocksApi extends asyncModules_1.default {
      * @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;
@@ -209,7 +222,8 @@ 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.
@@ -242,7 +256,8 @@ 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.
@@ -275,7 +290,8 @@ 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.
@@ -290,7 +306,8 @@ 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.
@@ -305,7 +322,8 @@ 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.
@@ -332,7 +350,8 @@ 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.
@@ -347,7 +366,8 @@ 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.

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 {

package/dist/index.d.ts

@@ -123,6 +123,7 @@ interface IDefineApi {
  * @param {IConfig} config - Custom configuration settings
  * @param {string} [config.token] - Optional token parameter
  * @param {string} [config.guestId] - Optional guest identifier sent as the `x-guest-id` header for guest cart/wishlist/activity flows (only while unauthenticated). In the browser, if omitted, a stable per-device id is generated and persisted in localStorage. On the server you MUST pass a per-visitor `guestId` (or call `setGuestId`): the SDK never auto-generates a server id, to avoid sharing one guest across visitors.
+ * @param {string} [config.deviceMetadata] - Optional device-metadata string sent as the `x-device-metadata` header instead of the environment-derived fingerprint. Refresh tokens are bound to this header, so a server issuing tokens for a browser (OAuth code exchange) must pass the browser's string (from `getDeviceMetadata()`), or the token will not be refreshable from that browser.
  * @param {string} [config.langCode] - Optional langCode parameter
  * @param {boolean} [config.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.
  * @param {string} [config.auth] - An object with authorization settings.