oneentry 1.0.156 → 1.0.158

package/dist/base/syncModules.js

@@ -91,14 +91,17 @@ class SyncModules {
         /**
          * Sorts attributes by their positions.
          *
-         * The API returns attributes as an object `{ marker: AttrObject }`.
-         * Each attribute has a `position` field. The method rebuilds the object
-         * with keys sorted by ascending `position` so that the display order
-         * matches the order defined in the CMS.
-         * @param {any} data - The data containing attributes.
-         * @returns {any} Sorted attributes.
+         * Each attribute has a `position` field, and the API returns them in no
+         * particular order. The method rebuilds the collection sorted by ascending
+         * `position`, so the display order matches the order defined in the CMS.
+         * Both container shapes the API uses are handled: an object keyed by marker
+         * (`attributeValues`) and an array (form `attributes`).
+         * @param {any} data - The attributes collection to sort.
+         * @returns {any} Sorted attributes, in the same container shape.
          */
-        this._sortAttributes = (data) => Object.fromEntries(Object.entries(data).sort(([, a], [, b]) => a.position - b.position));
+        this._sortAttributes = (data) => Array.isArray(data)
+            ? [...data].sort((a, b) => a.position - b.position)
+            : Object.fromEntries(Object.entries(data).sort(([, a], [, b]) => a.position - b.position));
         this.state = state;
         this._url = state.url;
         this._nodeDeviceId = _generateId();
@@ -240,50 +243,42 @@ class SyncModules {
         return body;
     }
     /**
-     * Clears arrays within the data structure.
+     * Normalizes the value of a single attribute in place.
      *
-     * Traverses the data and fixes a specific edge case with image attributes:
-     * when an `image` attribute has a single-element array in `value`,
-     * the API returns an array but consumers expect a plain object.
-     * In that case `value` is unwrapped: `[img]` → `img`.
+     * Applies the three type-driven fixes the API response needs, so that an
+     * attribute of a given type always reaches the consumer in the same shape,
+     * no matter which collection it arrived in:
      *
-     * For all other keys the method recursively copies the structure unchanged.
-     * @param {Record<string, any>} data - The data to clear.
-     * @returns {any} Cleared data.
+     * 1. **Single-file values** (`image`, `file`) — the API always sends an array,
+     * even for one file: `[img]` → `img`. Multi-file values and `groupOfImages`
+     * (a collection by definition) stay an array.
+     * 2. **Empty values** — an attribute with no value comes back as an empty
+     * localization map `{}`; it is replaced with `null`, the same marker the
+     * numeric branch already produced.
+     * 3. **Numbers** (`integer`, `float`, `real`) — cast to a JS number; anything
+     * that is not a number (including an empty value) becomes `null`.
+     * @param {any} attr - The attribute object to normalize in place.
      */
-    _clearArray(data) {
-        if (Array.isArray(data)) {
-            return data.map((item) => this._clearArray(item));
+    _normalizeAttrValue(attr) {
+        if ((attr.type === 'image' || attr.type === 'file') &&
+            Array.isArray(attr.value) &&
+            attr.value.length === 1) {
+            attr.value = attr.value[0];
         }
-        else if (typeof data === 'object' && data) {
-            const normalizeData = {};
-            Object.keys(data).forEach((key) => {
-                if (Array.isArray(data[key])) {
-                    normalizeData[key] = this._clearArray(data[key]);
-                }
-                else if (!data[key] || typeof data[key] !== 'object') {
-                    normalizeData[key] = data[key];
-                }
-                else if (key === 'attributeValues') {
-                    const attrs = data[key];
-                    Object.keys(attrs).forEach((attr) => {
-                        // If an image attribute has a single-element value array,
-                        // unwrap it to a plain object for consumer convenience.
-                        if (attrs[attr].type === 'image' &&
-                            attrs[attr].value.length === 1) {
-                            attrs[attr].value = attrs[attr].value[0];
-                        }
-                    });
-                    normalizeData[key] = data[key];
-                }
-                else {
-                    normalizeData[key] = this._clearArray(data[key]);
-                }
-            });
-            return normalizeData;
+        // An attribute with no value arrives as an empty localization map.
+        if (attr.value &&
+            typeof attr.value === 'object' &&
+            !Array.isArray(attr.value) &&
+            Object.keys(attr.value).length === 0) {
+            attr.value = null;
         }
-        else {
-            return data;
+        if (attr.type === 'integer' ||
+            attr.type === 'float' ||
+            attr.type === 'real') {
+            // Number(null) is 0 and Number('') is 0 — an empty value must stay empty.
+            const isEmpty = attr.value === null || attr.value === undefined || attr.value === '';
+            const numValue = isEmpty ? NaN : Number(attr.value);
+            attr.value = isNaN(numValue) ? null : numValue;
         }
     }
     /**
@@ -306,18 +301,24 @@ class SyncModules {
      *
      * Handles three different attribute formats returned by the API:
      *
-     * **1. `attributeValues`** — attributes of pages, products and other entities.
-     * Contains an object `{ marker: AttrObject }`. For each attribute:
-     * - `_normalizeAdditionalFields` is called;
-     * - numeric types (`integer`, `float`) are cast to a JS number (or `null`);
-     * - the whole object is re-sorted by `position`.
+     * All three go through the same steps, so an attribute of a given type looks
+     * the same whichever collection it arrived in:
+     * - `_normalizeAdditionalFields` turns nested fields into a marker map;
+     * - `_normalizeAttrValue` unwraps single-file values, empties to `null` and
+     * casts numbers;
+     * - the collection is re-sorted by `position`.
+     *
+     * **1. `attributeValues`** — attributes of pages, products and other entities,
+     * an object `{ marker: AttrObject }`.
      *
-     * **2. `attributes`** — form attributes (different API structure).
-     * Same `additionalFields` processing,
-     * but numbers are not normalized here (commented out — logic differs).
+     * **2. `attributes`** — form attributes, an array (or a marker map on some
+     * endpoints); form-only boolean flags (`isLogin`, `isSignUp`, notifications)
+     * are additionally coerced from `null` to `false`. A form with no attributes
+     * arrives as an empty object `{}` — it is normalized to an empty array.
      *
-     * **3. `type`** — a single attribute from an attribute set.
-     * Same transformations as in case 1, but without sorting.
+     * **3. `type`** — a standalone attribute: an attribute-set entry, a form-data
+     * field or a nested `additionalFields` entry. Same transformations, but there
+     * is no collection to sort.
      *
      * `timeInterval` attributes are left exactly as the API returned them — a
      * compact recurrence rule. Resolving one into concrete slots is the caller's
@@ -334,11 +335,7 @@ class SyncModules {
             Object.keys(data.attributeValues).forEach((attr) => {
                 const d = data.attributeValues[attr];
                 this._normalizeAdditionalFields(d);
-                // normalize numbers
-                if (d.type === 'integer' || d.type === 'float') {
-                    const numValue = Number(d.value);
-                    d.value = isNaN(numValue) ? null : numValue;
-                }
+                this._normalizeAttrValue(d);
             });
             return {
                 ...data,
@@ -355,47 +352,37 @@ class SyncModules {
         // for forms attributes - forms attributes collections
         if ('attributes' in data) {
             const d = data.attributes;
+            // A form with no attributes arrives as an empty object `{}` — normalize
+            // it to an empty array, the container every non-empty form uses.
+            if (d &&
+                typeof d === 'object' &&
+                !Array.isArray(d) &&
+                Object.keys(d).length === 0) {
+                return { ...data, attributes: [] };
+            }
             Object.keys(d).forEach((attr) => {
                 this._normalizeAdditionalFields(d[attr]);
+                this._normalizeAttrValue(d[attr]);
                 for (const field of booleanFields) {
                     if (field in d[attr] && d[attr][field] === null) {
                         d[attr][field] = false;
                     }
                 }
             });
-            return data;
+            return { ...data, attributes: this._sortAttributes(d) };
         }
         //  For single attribute - for attribute sets
         if ('type' in data) {
             this._normalizeAdditionalFields(data);
+            this._normalizeAttrValue(data);
             for (const field of booleanFields) {
                 if (field in data && data[field] === null) {
                     data[field] = false;
                 }
             }
-            // Normalize numbers
-            if (data.type === 'integer' || data.type === 'float') {
-                const numValue = Number(data.value);
-                data.value = isNaN(numValue) ? null : numValue;
-            }
         }
         return data;
     }
-    /**
-     * Processes data after fetching or receiving it.
-     *
-     * Final post-processing of the API response: first unwraps localized fields
-     * (`_normalizeData`), then fixes single-element image attributes
-     * (`_clearArray`). Called at the end of every fetch method.
-     * @param {any} data - The data to process.
-     * @param {any} [langCode] - The language code for processing.
-     * @returns {any} Processed data.
-     */
-    _dataPostProcess(data, langCode = this.state.lang) {
-        const normalize = this._normalizeData(data, langCode);
-        const result = this._clearArray(normalize);
-        return result;
-    }
     /**
      * Sets the access token in the state.
      * @param {string} accessToken - The access token to set.

package/dist/base/timeIntervals.js

@@ -136,13 +136,14 @@ function _addSlotsFromRanges(day, ranges, out) {
         const endMinutes = _toMinutes(range === null || range === void 0 ? void 0 : range.end);
         if (startMinutes === null || endMinutes === null)
             return;
-        // A non-positive period would never advance the cursor; a non-numeric one
-        // would concatenate into it.
-        if (!Number.isFinite(range.period) || range.period <= 0)
+        // A non-positive period would never advance the cursor; a null or
+        // non-numeric one would concatenate into it.
+        const period = range === null || range === void 0 ? void 0 : range.period;
+        if (typeof period !== 'number' || !Number.isFinite(period) || period <= 0)
             return;
-        for (let minutes = startMinutes; minutes + range.period <= endMinutes; minutes += range.period) {
+        for (let minutes = startMinutes; minutes + period <= endMinutes; minutes += period) {
             const from = day + minutes * _MS_PER_MINUTE;
-            const to = day + (minutes + range.period) * _MS_PER_MINUTE;
+            const to = day + (minutes + period) * _MS_PER_MINUTE;
             out.push([new Date(from).toISOString(), new Date(to).toISOString()]);
         }
     });

package/dist/base/utils.d.ts

@@ -136,6 +136,7 @@ interface IAttributes {
  * @property {string | null} [plainValue] - Localized plain-text content (without HTML markup). Example: "Plain description".
  * @property {string | null} [htmlValue] - Localized HTML-rendered content. Example: "<p>Description</p>".
  * @property {string | null} [htmlContent] - Localized HTML body content for richer pages. Example: "<div>...</div>".
+ * @property {string | null} [plainContent] - Localized plain-text version of `htmlContent`; returned by pages and menus. Example: "Description".
  * @property {string | null} [menuTitle] - Localized title used in menus and navigation. Example: "Home".
  * @description Normalized localization payload for a single locale, returned by the SDK after unwrapping the API's per-language map.
  */
@@ -144,23 +145,26 @@ interface ILocalizeInfo {
     plainValue?: string | null;
     htmlValue?: string | null;
     htmlContent?: string | null;
+    plainContent?: string | null;
     menuTitle?: string | null;
 }
 /**
  * @interface IAttributeLocalizeInfo
+ * @property {string} [title] - Localized title of the attribute. Optional — the payload is an empty object when the attribute has no localization for the requested language (e.g. form attributes in list responses). Example: "Color".
  * @property {ITimeIntervalSchedule[]} [intervals] - For attributes of type `timeInterval`, the schedule data attached to the localization payload. Each entry is a compact recurrence rule — pass it to `expandTimeIntervals` to resolve concrete slots.
- * @description Extension of {@link ILocalizeInfo} used by attribute entities — adds attribute-type-specific fields the API exposes via `localizeInfos`.
+ * @description Extension of {@link ILocalizeInfo} used by attribute entities — adds attribute-type-specific fields the API exposes via `localizeInfos`. Unlike the base type, `title` is optional here.
  */
-interface IAttributeLocalizeInfo extends ILocalizeInfo {
+interface IAttributeLocalizeInfo extends Omit<ILocalizeInfo, 'title'> {
+    title?: string;
     intervals?: ITimeIntervalSchedule[];
     [key: string]: unknown;
 }
 /**
  * @interface ITimeIntervalSchedule
  * @property {string} id - Schedule entry identifier (UUID). Example: "c6466cd8-c55d-4583-97c5-42b684210f12".
- * @property {number} fullMonth - Month index this schedule covers (0-11). Example: 2.
+ * @property {number} [fullMonth] - Month index this schedule covers (0-11). Optional — present when the schedule is pinned to a month/year rather than an explicit date `range`. Example: 2.
  * @property {boolean} inEveryMonth - Whether the schedule repeats every month. Example: true.
- * @property {number} selectedYear - Year the schedule applies to. Example: 2025.
+ * @property {number} [selectedYear] - Year the schedule applies to. Optional — present when the schedule is pinned to a month/year rather than an explicit date `range`. Example: 2025.
  * @property {ITimeIntervalRange[]} intervals - Daily time ranges configured for the schedule.
  * @property {unknown[]} external - External overrides; empty array when none.
  * @property {string[]} range - Validity range as a pair of ISO dates `[from, to]`; empty array when none. When both entries are equal the schedule is anchored to that single day and its recurrence is open-ended. Example: ["2025-05-07T21:00:00.000Z", "2025-05-07T21:00:00.000Z"].
@@ -169,9 +173,9 @@ interface IAttributeLocalizeInfo extends ILocalizeInfo {
  */
 interface ITimeIntervalSchedule {
     id: string;
-    fullMonth: number;
+    fullMonth?: number;
     inEveryMonth: boolean;
-    selectedYear: number;
+    selectedYear?: number;
     intervals: ITimeIntervalRange[];
     external: unknown[];
     range: string[];
@@ -248,20 +252,20 @@ interface ITimeIntervalPoint {
  * @property {string} id - Range identifier (UUID).
  * @property {ITimeIntervalPoint} start - Start time of the range.
  * @property {ITimeIntervalPoint} end - End time of the range.
- * @property {number} period - Slot duration in minutes. Example: 60.
+ * @property {number | null} period - Slot duration in minutes; `null` when the range is not sliced into slots. Example: 60.
  * @description A single daily time range inside a {@link ITimeIntervalSchedule}.
  */
 interface ITimeIntervalRange {
     id: string;
     start: ITimeIntervalPoint;
     end: ITimeIntervalPoint;
-    period: number;
+    period: number | null;
 }
 /**
  * @interface IAttributeValue
  * @property {string} type - Attribute data type (e.g. "string", "integer", "list", "file", "image").
- * @property {unknown} value - Attribute value — actual TS type depends on `type` (string for "string"/"text", number for "integer", array for "list", etc.). Example: "Admins text".
- * @property {number} [position] - Sort position of the value inside its set. Example: 0.
+ * @property {unknown} value - Attribute value — actual TS type depends on `type`, and the SDK normalizes it to the same shape in every module: `string` for "string"/"text"; `number | null` for "integer"/"float"/"real"; the file object itself for a single-file "image"/"file" and an array of them for several; an array for "list" and "groupOfImages". An attribute with no value is always `null`. Example: "Admins text".
+ * @property {number} [position] - Sort position of the value inside its set; the containing collection is returned sorted by it. Example: 0.
  * @property {Record<string, IAttributeValue> | unknown[]} [additionalFields] - Nested attribute values keyed by marker; the API may also return an empty array when none are configured. Optional.
  * @property {boolean} [isIcon] - Block/preview attribute flag — whether the field is treated as an icon. Optional.
  * @property {boolean} [isProductPreview] - Block/preview attribute flag — whether the field is shown in product preview. Optional.

package/dist/blocks/blocksApi.d.ts

@@ -1,7 +1,7 @@
 import AsyncModules from '../base/asyncModules';
 import type StateModule from '../base/stateModule';
 import type { IError } from '../base/utils';
-import type { IProductsEntity, IProductsResponse } from '../products/productsInterfaces';
+import type { IProductsResponse } from '../products/productsInterfaces';
 import type { BlockType, IBlockEntity, IBlockProductsLookup, IBlocks, IBlockSlidesResponse, IBlocksResponse, ISearchBlock } from './blocksInterfaces';
 /**
  * Controllers for working with blocks.
@@ -118,11 +118,11 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @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.
      * @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.
+     * @returns {Promise<IProductsResponse | IError>} Returns an object with an array of products, total count and totalFound.
      * @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>;
+    getCartComplement(marker: string, langCode?: string, signPrice?: string): Promise<IProductsResponse | IError>;
     /**
      * Get "complete your cart" products by an explicit list of productIds (POST body).
      * @handleName getCartComplementByProductIds
@@ -133,11 +133,11 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
           "productIds": [1, 2],
           "langCode": "en_US"
         }
-     * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
+     * @returns {Promise<IProductsResponse | IError>} Returns an object with an array of products, total count and totalFound.
      * @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>;
+    getCartComplementByProductIds(marker: string, body: IBlockProductsLookup): Promise<IProductsResponse | IError>;
     /**
      * Get "similar to cart" products by the cart from context (auth user or guest).
      * @handleName getCartSimilar
@@ -145,11 +145,11 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @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.
      * @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.
+     * @returns {Promise<IProductsResponse | IError>} Returns an object with an array of products, total count and totalFound.
      * @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>;
+    getCartSimilar(marker: string, langCode?: string, signPrice?: string): Promise<IProductsResponse | IError>;
     /**
      * Get "similar to cart" products by an explicit list of productIds (POST body).
      * @handleName getCartSimilarByProductIds
@@ -160,11 +160,11 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
           "productIds": [1, 2],
           "langCode": "en_US"
         }
-     * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
+     * @returns {Promise<IProductsResponse | IError>} Returns an object with an array of products, total count and totalFound.
      * @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>;
+    getCartSimilarByProductIds(marker: string, body: IBlockProductsLookup): Promise<IProductsResponse | IError>;
     /**
      * Get personal recommendations for the user.
      * @handleName getPersonalRecommendations
@@ -172,11 +172,11 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @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.
      * @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.
+     * @returns {Promise<IProductsResponse | IError>} Returns an object with an array of products, total count and totalFound.
      * @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>;
+    getPersonalRecommendations(marker: string, langCode?: string, signPrice?: string): Promise<IProductsResponse | IError>;
     /**
      * Get recently viewed products.
      * @handleName getRecentlyViewed
@@ -184,11 +184,11 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @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.
      * @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.
+     * @returns {Promise<IProductsResponse | IError>} Returns an object with an array of products, total count and totalFound.
      * @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>;
+    getRecentlyViewed(marker: string, langCode?: string, signPrice?: string): Promise<IProductsResponse | IError>;
     /**
      * Get products for repeat purchase.
      * @handleName getRepeatPurchase
@@ -196,11 +196,11 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @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.
      * @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.
+     * @returns {Promise<IProductsResponse | IError>} Returns an object with an array of products, total count and totalFound.
      * @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>;
+    getRepeatPurchase(marker: string, langCode?: string, signPrice?: string): Promise<IProductsResponse | IError>;
     /**
      * Get the block's slides tree as a flat pre-order array (slider_block only).
      * @handleName getSlides
@@ -217,11 +217,11 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @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.
      * @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.
+     * @returns {Promise<IProductsResponse | IError>} Returns an object with an array of products, total count and totalFound.
      * @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>;
+    getTrending(marker: string, langCode?: string, signPrice?: string): Promise<IProductsResponse | IError>;
     /**
      * Get "similar to wishlist" products by the wishlist from context (auth user or guest).
      * @handleName getWishlistSimilar
@@ -229,11 +229,11 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @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.
      * @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.
+     * @returns {Promise<IProductsResponse | IError>} Returns an object with an array of products, total count and totalFound.
      * @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>;
+    getWishlistSimilar(marker: string, langCode?: string, signPrice?: string): Promise<IProductsResponse | IError>;
     /**
      * Get "similar to wishlist" products by an explicit list of productIds (POST body).
      * @handleName getWishlistSimilarByProductIds
@@ -244,9 +244,9 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
           "productIds": [1, 2],
           "langCode": "en_US"
         }
-     * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
+     * @returns {Promise<IProductsResponse | IError>} Returns an object with an array of products, total count and totalFound.
      * @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>;
+    getWishlistSimilarByProductIds(marker: string, body: IBlockProductsLookup): Promise<IProductsResponse | IError>;
 }

package/dist/blocks/blocksApi.js

@@ -224,7 +224,7 @@ class BlocksApi extends asyncModules_1.default {
      * @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.
      * @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.
+     * @returns {Promise<IProductsResponse | IError>} Returns an object with an array of products, total count and totalFound.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getCartComplement getCartComplement} documentation.
      */
@@ -243,7 +243,7 @@ class BlocksApi extends asyncModules_1.default {
           "productIds": [1, 2],
           "langCode": "en_US"
         }
-     * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
+     * @returns {Promise<IProductsResponse | IError>} Returns an object with an array of products, total count and totalFound.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getCartComplementByProductIds getCartComplementByProductIds} documentation.
      */
@@ -258,7 +258,7 @@ class BlocksApi extends asyncModules_1.default {
      * @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.
      * @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.
+     * @returns {Promise<IProductsResponse | IError>} Returns an object with an array of products, total count and totalFound.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getCartSimilar getCartSimilar} documentation.
      */
@@ -277,7 +277,7 @@ class BlocksApi extends asyncModules_1.default {
           "productIds": [1, 2],
           "langCode": "en_US"
         }
-     * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
+     * @returns {Promise<IProductsResponse | IError>} Returns an object with an array of products, total count and totalFound.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getCartSimilarByProductIds getCartSimilarByProductIds} documentation.
      */
@@ -292,7 +292,7 @@ class BlocksApi extends asyncModules_1.default {
      * @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.
      * @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.
+     * @returns {Promise<IProductsResponse | IError>} Returns an object with an array of products, total count and totalFound.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getPersonalRecommendations getPersonalRecommendations} documentation.
      */
@@ -308,7 +308,7 @@ class BlocksApi extends asyncModules_1.default {
      * @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.
      * @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.
+     * @returns {Promise<IProductsResponse | IError>} Returns an object with an array of products, total count and totalFound.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getRecentlyViewed getRecentlyViewed} documentation.
      */
@@ -324,7 +324,7 @@ class BlocksApi extends asyncModules_1.default {
      * @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.
      * @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.
+     * @returns {Promise<IProductsResponse | IError>} Returns an object with an array of products, total count and totalFound.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getRepeatPurchase getRepeatPurchase} documentation.
      */
@@ -352,7 +352,7 @@ class BlocksApi extends asyncModules_1.default {
      * @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.
      * @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.
+     * @returns {Promise<IProductsResponse | IError>} Returns an object with an array of products, total count and totalFound.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getTrending getTrending} documentation.
      */
@@ -368,7 +368,7 @@ class BlocksApi extends asyncModules_1.default {
      * @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.
      * @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.
+     * @returns {Promise<IProductsResponse | IError>} Returns an object with an array of products, total count and totalFound.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getWishlistSimilar getWishlistSimilar} documentation.
      */
@@ -387,7 +387,7 @@ class BlocksApi extends asyncModules_1.default {
           "productIds": [1, 2],
           "langCode": "en_US"
         }
-     * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
+     * @returns {Promise<IProductsResponse | IError>} Returns an object with an array of products, total count and totalFound.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getWishlistSimilarByProductIds getWishlistSimilarByProductIds} documentation.
      */