oneentry 1.0.157 → 1.0.159

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,14 +252,14 @@ 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

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

@@ -1,4 +1,37 @@
 "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;
+    };
+})();
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -6,7 +39,8 @@ 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");
+const lazySchema_1 = __importDefault(require("../base/lazySchema"));
+const schema = (0, lazySchema_1.default)(() => Promise.resolve().then(() => __importStar(require('./blocksSchemas'))));
 /**
  * Controllers for working with blocks.
  * @handle /api/content/blocks
@@ -40,7 +74,7 @@ class BlocksApi extends asyncModules_1.default {
         const query = this._queryParamsToString({ langCode, type, offset, limit });
         const response = await this._fetchPost(`?${query}`);
         // Validate response if validation is enabled
-        const validated = this._validateResponse(response, blocksSchemas_1.BlocksResponseSchema);
+        const validated = await this._validateResponse(response, schema('BlocksResponseSchema'));
         if (!this.state.traficLimit) {
             const normalizeResponse = this._normalizeData(validated);
             // On API error responses (e.g. 403 without list permission, 422) the
@@ -68,7 +102,7 @@ class BlocksApi extends asyncModules_1.default {
     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 validated = await this._validateResponse(response, schema('BlockEntitySchema'));
         const normalizeResponse = this._normalizeData(validated);
         await this._enrichBlock(normalizeResponse, langCode, offset, limit, !this.state.traficLimit);
         return normalizeResponse;
@@ -214,7 +248,7 @@ class BlocksApi extends asyncModules_1.default {
     async searchBlock(name, langCode = this.state.lang) {
         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);
+        const validated = await this._validateResponse(result, schema('SearchBlocksResponseSchema'));
         return validated;
     }
     /**
@@ -224,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/getCartComplement getCartComplement} documentation.
      */
@@ -243,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/getCartComplementByProductIds getCartComplementByProductIds} documentation.
      */
@@ -258,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/getCartSimilar getCartSimilar} documentation.
      */
@@ -277,7 +311,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 +326,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 +342,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 +358,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 +386,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 +402,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 +421,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.
      */

package/dist/blocks/blocksInterfaces.d.ts

@@ -59,10 +59,10 @@ interface 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 {IProductsEntity[]} A promise that resolves to an array of products or an error.
+     * @returns {IProductsResponse} A promise that resolves to a products response (items + total + totalFound) or an error.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      */
-    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
@@ -73,10 +73,10 @@ interface IBlocks {
           "productIds": [1, 2],
           "langCode": "en_US"
         }
-     * @returns {IProductsEntity[]} A promise that resolves to an array of products or an error.
+     * @returns {IProductsResponse} A promise that resolves to a products response (items + total + totalFound) or an error.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      */
-    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
@@ -84,10 +84,10 @@ interface 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 {IProductsEntity[]} A promise that resolves to an array of products or an error.
+     * @returns {IProductsResponse} A promise that resolves to a products response (items + total + totalFound) or an error.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      */
-    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
@@ -98,10 +98,10 @@ interface IBlocks {
           "productIds": [1, 2],
           "langCode": "en_US"
         }
-     * @returns {IProductsEntity[]} A promise that resolves to an array of products or an error.
+     * @returns {IProductsResponse} A promise that resolves to a products response (items + total + totalFound) or an error.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      */
-    getCartSimilarByProductIds(marker: string, body: IBlockProductsLookup): Promise<IProductsEntity[] | IError>;
+    getCartSimilarByProductIds(marker: string, body: IBlockProductsLookup): Promise<IProductsResponse | IError>;
     /**
      * Get personal recommendations for the user.
      * @handleName getPersonalRecommendations
@@ -109,10 +109,10 @@ interface 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 {IProductsEntity[]} A promise that resolves to an array of products or an error.
+     * @returns {IProductsResponse} A promise that resolves to a products response (items + total + totalFound) or an error.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      */
-    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
@@ -120,10 +120,10 @@ interface 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 {IProductsEntity[]} A promise that resolves to an array of products or an error.
+     * @returns {IProductsResponse} A promise that resolves to a products response (items + total + totalFound) or an error.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      */
-    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
@@ -131,10 +131,10 @@ interface 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 {IProductsEntity[]} A promise that resolves to an array of products or an error.
+     * @returns {IProductsResponse} A promise that resolves to a products response (items + total + totalFound) or an error.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      */
-    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
@@ -150,10 +150,10 @@ interface 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 {IProductsEntity[]} A promise that resolves to an array of products or an error.
+     * @returns {IProductsResponse} A promise that resolves to a products response (items + total + totalFound) or an error.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      */
-    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
@@ -161,10 +161,10 @@ interface 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 {IProductsEntity[]} A promise that resolves to an array of products or an error.
+     * @returns {IProductsResponse} A promise that resolves to a products response (items + total + totalFound) or an error.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      */
-    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
@@ -175,10 +175,10 @@ interface IBlocks {
           "productIds": [1, 2],
           "langCode": "en_US"
         }
-     * @returns {IProductsEntity[]} A promise that resolves to an array of products or an error.
+     * @returns {IProductsResponse} A promise that resolves to a products response (items + total + totalFound) or an error.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      */
-    getWishlistSimilarByProductIds(marker: string, body: IBlockProductsLookup): Promise<IProductsEntity[] | IError>;
+    getWishlistSimilarByProductIds(marker: string, body: IBlockProductsLookup): Promise<IProductsResponse | IError>;
 }
 /**
  * Represents a response from the blocks API.

package/dist/blocks/blocksSchemas.d.ts

@@ -53,6 +53,7 @@ export declare const BlockEntitySchema: z.ZodObject<{
             discountConfig: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
         }, z.core.$strip>>;
         total: z.ZodNumber;
+        totalFound: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>;
     countElementsPerRow: z.ZodOptional<z.ZodNumber>;
     quantity: z.ZodOptional<z.ZodNumber>;
@@ -149,6 +150,7 @@ export declare const BlocksResponseSchema: z.ZodObject<{
                 discountConfig: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
             }, z.core.$strip>>;
             total: z.ZodNumber;
+            totalFound: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>;
         countElementsPerRow: z.ZodOptional<z.ZodNumber>;
         quantity: z.ZodOptional<z.ZodNumber>;

package/dist/discounts/discountsInterfaces.d.ts

@@ -88,7 +88,7 @@ interface IDiscountCondition {
  * Represents a discount entity.
  * @interface IDiscountsEntity
  * @property {number} id - The unique identifier of the discount.
- * @property {number} [attributeSetId] - The identifier of the discount.
+ * @property {number | null} [attributeSetId] - The identifier of the attribute set linked to the discount, or `null` when no set is linked.
  * @property {ILocalizeInfo} [localizeInfos] - The name of the discount.
  * @property {number} [version] - The version of the discount.
  * @property {string} [identifier] - The identifier of the discount.
@@ -111,7 +111,7 @@ interface IDiscountCondition {
  */
 interface IDiscountsEntity {
     id: number;
-    attributeSetId?: number;
+    attributeSetId?: number | null;
     localizeInfos?: ILocalizeInfo;
     version?: number;
     identifier?: string;
@@ -137,14 +137,14 @@ interface IDiscountsEntity {
  * @property {'TO_PRODUCT' | 'TO_ORDER'} applicability - What the discount applies to. Example: "TO_PRODUCT".
  * @property {'FIXED_AMOUNT' | 'PERCENT'} discountType - How the discount value is interpreted. Example: "FIXED_AMOUNT".
  * @property {number} value - Discount amount (currency units for FIXED_AMOUNT, percentage points for PERCENT). Example: 10.
- * @property {number} [maxAmount] - Optional cap on the absolute discount applied. Example: 5.
+ * @property {number | null} [maxAmount] - Cap on the absolute discount applied, or `null` when uncapped. Example: 5.
  * @description Configuration of the discount calculation.
  */
 interface IDiscountValue {
     applicability: 'TO_PRODUCT' | 'TO_ORDER';
     discountType: 'FIXED_AMOUNT' | 'PERCENT';
     value: number;
-    maxAmount?: number;
+    maxAmount?: number | null;
 }
 /**
  * @interface ICouponEntity

package/dist/events/eventsApi.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 { IContentApiEvent, IEvents, IListFormSubscription, ISubscribeFormEvent, ISubscriptions } from './eventsInterfaces';
+import type { IContentApiEvent, IEvents, IFormSubscriptionsResponse, ISubscribeFormEvent, ISubscriptions } from './eventsInterfaces';
 /**
  * Controllers for working with events
  * @handle /api/content/events
@@ -86,13 +86,13 @@ export default class EventsApi extends AsyncModules implements IEvents {
      * @handleName getFormSubscriptions
      * @param {number} [offset] - Optional offset for pagination. Default: 0.
      * @param {number} [limit] - Optional limit for pagination. Default: 30.
-     * @returns {Promise<IListFormSubscription[] | IError>} Returns an array of form subscriptions.
+     * @returns {Promise<IFormSubscriptionsResponse | IError>} Returns an object with an array of form subscriptions and total count.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description This method requires user authorization.
      * @see For more information about configuring the {@link https://js-sdk.oneentry.cloud/docs/category/authprovider authorization module}, see the documentation in the  {@link https://js-sdk.oneentry.cloud/docs/category/authprovider configuration settings section of the SDK}.
      * @see {@link https://js-sdk.oneentry.cloud/docs/events/getFormSubscriptions getFormSubscriptions} documentation.
      */
-    getFormSubscriptions(offset?: number, limit?: number): Promise<IListFormSubscription[] | IError>;
+    getFormSubscriptions(offset?: number, limit?: number): Promise<IFormSubscriptionsResponse | IError>;
     /**
      * Unsubscribe from form notifications by marker.
      * @handleName unsubscribeFromForm

package/dist/events/eventsApi.js

@@ -115,7 +115,7 @@ class EventsApi extends asyncModules_1.default {
      * @handleName getFormSubscriptions
      * @param {number} [offset] - Optional offset for pagination. Default: 0.
      * @param {number} [limit] - Optional limit for pagination. Default: 30.
-     * @returns {Promise<IListFormSubscription[] | IError>} Returns an array of form subscriptions.
+     * @returns {Promise<IFormSubscriptionsResponse | IError>} Returns an object with an array of form subscriptions and total count.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description This method requires user authorization.
      * @see For more information about configuring the {@link https://js-sdk.oneentry.cloud/docs/category/authprovider authorization module}, see the documentation in the  {@link https://js-sdk.oneentry.cloud/docs/category/authprovider configuration settings section of the SDK}.