oneentry 1.0.157 → 1.0.158

package/changelog.md

@@ -1,5 +1,59 @@
 # SDK Change Log
 
+## v.1.0.158
+
+### What's New
+
+- Orders > `IOrderStatus` — four fields the API already returns on every status are now declared (all optional, like the rest of the interface): `axis` (status pipeline, e.g. `"payment"`), `isCancelFinal`, `isFinalSuccess`, `isMapped`.
+
+- Base > `ILocalizeInfo` — `plainContent?: string | null` is now declared: pages and menus return it as the plain-text counterpart of `htmlContent`.
+
+- Events > `IFormSubscriptionsResponse` — new exported type describing the container returned by `getFormSubscriptions`: `{ items: IListFormSubscription[]; total: number }`.
+
+- Products > `IProductsResponse` — `totalFound?: number` is now declared (and validated by `ProductsResponseSchema`): block product endpoints (`similarProducts` inside blocks, cart/wishlist recommendations, frequently ordered) return it alongside `items`/`total`; the `Products.getProducts*` endpoints do not, hence optional.
+
+- Products > `IProductBlockSimilarRule` — rewritten to match the real shape of `customSettings.similarProductRules[]` returned by `getProductBlockById`: `{ id, title, attributeMarker, conditionMarker, conditionValue, statusMarker, pageUrls }`. The previously declared fields (`property`, `includes`, `keywords`, `strict`) never occurred in real data.
+
+- AttributeSets > `IAttributeSchemaItem` — six fields the API already returns on schema items are now declared (all optional):
+  - `position` — sort position of the field inside the set;
+  - `listTitles` (`IListTitle[]`) — options for `list`/`radioButton`/`entity` fields, with extended data or linked-entity values;
+  - `listType` — for `entity` fields, how the option list is organized (e.g. `"nested"`);
+  - `moduleIdentifier` — for `entity` fields, the module the linked entities are taken from (e.g. `"catalog"`);
+  - `parentId` — parent field id, `null` for top-level;
+  - `splitParts` (`number[] | boolean`) — for split-price fields, ids of the schema fields the price is split into, `false` when the field does not split.
+
+### What's Changed
+
+- **Breaking** — Blocks > the ten recommendation methods (`getCartComplement`, `getCartComplementByProductIds`, `getCartSimilar`, `getCartSimilarByProductIds`, `getWishlistSimilar`, `getWishlistSimilarByProductIds`, `getTrending`, `getPersonalRecommendations`, `getRecentlyViewed`, `getRepeatPurchase`) — the declared return type is corrected from `IProductsEntity[]` to `IProductsResponse`: the endpoints actually return a container `{ items, total, totalFound? }`, and the SDK does not unwrap it. Type-level fix only; the response itself is unchanged — code that (incorrectly) called `res.map(...)` never worked on real data.
+
+- **Breaking** — Products > `getProductsByVectorSearch` — the declared return type is corrected from `IProductsEntity[]` to `IProductsResponse`: the endpoint returns `{ items, total }`. Type-level fix only.
+
+- **Breaking** — Events > `getFormSubscriptions` — the declared return type is corrected from `IListFormSubscription[]` to the new `IFormSubscriptionsResponse`: the endpoint returns `{ items, total }`. Type-level fix only.
+
+- Orders > `IBaseOrdersEntity.totalSum` — type corrected from `string` to `number`: `createOrder` and `updateOrderByMarkerAndId` return a number (e.g. `285`), which the Zod schemas (`CreateOrderResponseSchema` / `UpdateOrderResponseSchema`) already declared. `IOrderByMarkerEntity.totalSum` stays `string` — the by-marker endpoints really return `"300.00"`.
+
+- Forms > `IFormAttribute` — the seven auth/notification flags (`isLogin`, `isSignUp`, `isPassword`, `isSignUpRequired`, `isNotificationEmail`, `isNotificationPhonePush`, `isNotificationPhoneSMS`) are now optional: the API returns them only on attributes of sign-in/sign-up forms.
+
+- Forms > `IFormLocalizeInfo` — `title` is now optional: the API returns an empty `localizeInfos` object when the form has no localization for the requested language (all list responses on the test project). Same for attribute localization: Base > `IAttributeLocalizeInfo.title` is now optional too.
+
+- Forms > `IFormAttributeAdditionalField.marker` — now optional: entries of `additionalFields` arrive as `{ type, value }`, the marker is the map key.
+
+- Forms > a form with no attributes now returns `attributes: []`: the API sends an empty **object** (`{}`) in that case, and the SDK normalizes it to an empty array in `_normalizeAttr`, so `attributes` is always `IFormAttribute[]` and `form.attributes.map(...)` is safe on every form.
+
+- Events > `IContentApiEvent.module` — now optional: system events not bound to a module (e.g. `send_code`, `registration_event`) come without it.
+
+- Discounts > `IDiscountsEntity.attributeSetId` and `IDiscountValue.maxAmount` — type widened to `number | null`: both arrive as `null` when not configured.
+
+- Products > `IProductBlockProductConfig` — `quantity` and `countElementsPerRow` are now optional: `customSettings.productConfig` arrives as an empty object when the block is not configured.
+
+- Base > `ITimeIntervalRange.period` — type corrected to `number | null`: ranges that are not sliced into slots carry `period: null`. The runtime (`expandTimeIntervals`) already guarded against it; only the type (and the internal narrowing in `_addSlotsFromRanges`) changed.
+
+- AttributeSets > `getAttributesByMarker` — the declared return type is corrected from `IAttributeSetsEntity[]` (the attribute **set** entity: `id`, `schema`, `createdDate`, …) to `IAttributesSetsEntity[]` — the attribute entities the endpoint actually returns (`marker`, `type`, `value`, `listTitles`, `validators`, `localizeInfos`, `additionalFields`, …). Type-level fix only; runtime behavior and the response itself are unchanged.
+
+- AttributeSets > `IAttributeSchemaItem` — `initialValue` and `isPrice` are now optional: the API omits them on some fields (`isPrice` is returned only on product attribute sets).
+
+- Base > `ITimeIntervalSchedule` — `fullMonth` and `selectedYear` are now optional: the API returns them only when the schedule is pinned to a month/year rather than an explicit date `range`.
+
 ## v.1.0.157
 
 ### What's New

package/dist/attribute-sets/attributeSetsApi.d.ts

@@ -38,11 +38,11 @@ export default class AttributesSetsApi extends AsyncModules implements IAttribut
      * @handleName getAttributesByMarker
      * @param {string} marker - Attribute marker. Example: "productAttributes".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @returns {Promise<IAttributeSetsEntity[] | IError>} Returns an array of Attributes objects.
+     * @returns {Promise<IAttributesSetsEntity[] | IError>} Returns an array of Attributes objects.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @see {@link https://js-sdk.oneentry.cloud/docs/attribute-sets/getAttributesByMarker getAttributesByMarker} documentation.
      */
-    getAttributesByMarker(marker: string, langCode?: string): Promise<IAttributeSetsEntity[] | IError>;
+    getAttributesByMarker(marker: string, langCode?: string): Promise<IAttributesSetsEntity[] | IError>;
     /**
      * Get a single attribute with data from the attribute sets.
      * @handleName getSingleAttributeByMarkerSet

package/dist/attribute-sets/attributeSetsApi.js

@@ -57,7 +57,7 @@ class AttributesSetsApi extends asyncModules_1.default {
      * @handleName getAttributesByMarker
      * @param {string} marker - Attribute marker. Example: "productAttributes".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @returns {Promise<IAttributeSetsEntity[] | IError>} Returns an array of Attributes objects.
+     * @returns {Promise<IAttributesSetsEntity[] | IError>} Returns an array of Attributes objects.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @see {@link https://js-sdk.oneentry.cloud/docs/attribute-sets/getAttributesByMarker getAttributesByMarker} documentation.
      */

package/dist/attribute-sets/attributeSetsInterfaces.d.ts

@@ -10,11 +10,11 @@ interface IAttributesSets {
      * @handleName getAttributesByMarker
      * @param {string} marker - The marker used to identify the attribute set. Example: "productAttributes".
      * @param {string} [langCode] - The language code for localization purposes. Default: 'en_US'.
-     * @returns {IAttributeSetsEntity[]} A promise that resolves to an array of attribute set entities or an error.
+     * @returns {IAttributesSetsEntity[]} A promise that resolves to an array of attribute entities or an error.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      * @description This method fetches attributes by a specific marker.
      */
-    getAttributesByMarker(marker: string, langCode: string): Promise<IAttributeSetsEntity[] | IError>;
+    getAttributesByMarker(marker: string, langCode: string): Promise<IAttributesSetsEntity[] | IError>;
     /**
      * Fetches a single attribute by its marker and the set marker.
      * @handleName getSingleAttributeByMarkerSet
@@ -137,35 +137,47 @@ interface IAttributesSetsEntity {
  * @interface IAttributeSchemaItem
  * @property {number} id - Unique identifier of the schema item. Example: 1.
  * @property {string} identifier - Field marker (machine name) within the schema. Example: "name".
- * @property {unknown} initialValue - Default value applied when the field is not filled.
- * @property {boolean} isPrice - Whether the field's numeric value is treated as the price for product entities. Example: false.
+ * @property {unknown} [initialValue] - Default value applied when the field is not filled. Optional — absent on some fields.
+ * @property {boolean} [isPrice] - Whether the field's numeric value is treated as the price for product entities. Optional — present on product (`forProducts`) attribute sets. Example: false.
  * @property {boolean} isVisible - Whether the field is exposed in the public API/UI. Example: true.
  * @property {IAttributeLocalizeInfo} localizeInfos - Localized labels for the field.
  * @property {boolean} original - Whether the field is part of the original (system) schema, not a user extension. Example: true.
  * @property {AttributeType} type - Attribute data type (e.g. "string", "file").
+ * @property {number} [position] - Sort position of the field inside the set. Optional. Example: 1.
+ * @property {IListTitle[]} [listTitles] - Options for `list`/`radioButton`/`entity` fields (with extended data or linked-entity values). Optional.
+ * @property {string} [listType] - For `entity` fields — how the option list is organized. Optional. Example: "nested".
+ * @property {string} [moduleIdentifier] - For `entity` fields — identifier of the module the linked entities are taken from. Optional. Example: "catalog".
+ * @property {number | null} [parentId] - Identifier of the parent field, `null` for top-level. Optional, seen on `groupOfImages` fields.
  * @property {Record<string, IAttributeSchemaItem>} [additionalFields] - Nested sub-fields keyed by marker. Optional.
  * @property {IAttributeValidators} [validators] - Validation rules for the field. Optional.
  * @property {boolean | string} [splitUnit] - Splitting unit configuration; `false` when disabled, otherwise the unit name (e.g. "percent"). Optional, used by numeric fields.
+ * @property {number[] | boolean} [splitParts] - For split-price fields — ids of the schema fields the price is split into (e.g. [2, 3]); `false` when the field does not split. Optional.
  * @property {boolean} [isCurrency] - Whether the field stores currency values. Optional.
  * @property {boolean} [splitPrice] - Whether the price is split between several fields. Optional.
  * @property {boolean} [isCompress] - Whether uploaded images are compressed. Optional, used by `image`/`groupOfImages` fields.
  * @property {boolean} [receiveValues] - For `timeInterval` fields — whether the field receives precomputed values. Optional.
  * @property {ITimeIntervalSchedule[]} [intervals] - For `timeInterval` fields — top-level schedule definition (separate from `localizeInfos.intervals`). Optional.
- * @property {unknown} [value] - For `timeInterval` fields — current value/state of the schedule. Optional.
+ * @property {unknown} [value] - Current value of the field: `null` on numeric fields without a value, an array of schedule groups on `timeInterval` fields. Optional.
  * @description Definition of a single field inside an attribute set's schema.
  */
 interface IAttributeSchemaItem {
     id: number;
     identifier: string;
-    initialValue: unknown;
-    isPrice: boolean;
+    initialValue?: unknown;
+    isPrice?: boolean;
     isVisible: boolean;
     localizeInfos: IAttributeLocalizeInfo;
     original: boolean;
     type: AttributeType;
+    position?: number;
+    listTitles?: IListTitle[];
+    listType?: string;
+    moduleIdentifier?: string;
+    parentId?: number | null;
     additionalFields?: Record<string, IAttributeSchemaItem>;
     validators?: IAttributeValidators;
     splitUnit?: boolean | string;
+    splitParts?: number[] | boolean;
     isCurrency?: boolean;
     splitPrice?: boolean;
     isCompress?: boolean;

package/dist/base/syncModules.d.ts

@@ -145,7 +145,8 @@ export default abstract class SyncModules {
      *
      * **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`.
+     * 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 standalone attribute: an attribute-set entry, a form-data
      * field or a nested `additionalFields` entry. Same transformations, but there

package/dist/base/syncModules.js

@@ -313,7 +313,8 @@ class SyncModules {
      *
      * **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`.
+     * 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 standalone attribute: an attribute-set entry, a form-data
      * field or a nested `additionalFields` entry. Same transformations, but there
@@ -351,6 +352,14 @@ 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]);

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,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

@@ -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.
      */

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}.

package/dist/events/eventsInterfaces.d.ts

@@ -61,12 +61,12 @@ interface 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>} A promise that resolves to an array of form subscriptions or an error.
+     * @returns {Promise<IFormSubscriptionsResponse | IError>} A promise that resolves to an object with an array of form subscriptions and total count, or an error.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      * @description This method returns all form subscriptions. 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}.
      */
-    getFormSubscriptions(offset?: number, limit?: number): Promise<IListFormSubscription[] | IError>;
+    getFormSubscriptions(offset?: number, limit?: number): Promise<IFormSubscriptionsResponse | IError>;
     /**
      * Unsubscribe from form notifications by marker.
      * @handleName unsubscribeFromForm
@@ -131,14 +131,14 @@ interface ISubscribeBody {
  * @property {number} id - Event identifier. Example: 1.
  * @property {string} identifier - Event text identifier. Example: "price_change".
  * @property {Record<string, unknown>} localizeInfos - Localized info of the event.
- * @property {string} module - Module the event belongs to. Example: "catalog".
+ * @property {string} [module] - Module the event belongs to; absent on system events not bound to a module (e.g. "send_code"). Example: "catalog".
  * @description Represents a single available event.
  */
 interface IContentApiEvent {
     id: number;
     identifier: string;
     localizeInfos: Record<string, unknown>;
-    module: string;
+    module?: string;
 }
 /**
  * Represents a form subscription item.
@@ -151,6 +151,17 @@ interface IListFormSubscription {
     eventMarker: string;
     formDataId: number;
 }
+/**
+ * Represents the response of the form subscriptions list endpoint.
+ * @interface IFormSubscriptionsResponse
+ * @property {IListFormSubscription[]} items - Array of form subscriptions.
+ * @property {number} total - Total number of subscriptions. Example: 0.
+ * @description Container returned by `getFormSubscriptions`.
+ */
+interface IFormSubscriptionsResponse {
+    items: IListFormSubscription[];
+    total: number;
+}
 /**
  * Body for subscribing to / unsubscribing from a form event.
  * @interface ISubscribeFormEvent
@@ -162,4 +173,4 @@ interface ISubscribeFormEvent {
     formDataId: number;
     status?: string;
 }
-export type { IContentApiEvent, IEvents, IListFormSubscription, ISubscribeBody, ISubscribeFormEvent, ISubscriptions, };
+export type { IContentApiEvent, IEvents, IFormSubscriptionsResponse, IListFormSubscription, ISubscribeBody, ISubscribeFormEvent, ISubscriptions, };

package/dist/forms/formsInterfaces.d.ts

@@ -71,7 +71,7 @@ interface IFromPages {
  * @property {string} identifier - The textual identifier for the record field. Example: "form_contact_us".
  * @property {string} processingType - Type of form processing. Example: "async".
  * @property {number | null} templateId - The identifier of the template used by the form, or null if no template is used. Example: 6789.
- * @property {IFormAttribute[]} attributes - Form fields with their localization, validators and form-specific flags, sorted by `position`.
+ * @property {IFormAttribute[]} attributes - Form fields with their localization, validators and form-specific flags, sorted by `position`. The API returns an empty object for forms with no attributes — the SDK normalizes it to an empty array.
  * @property {number | string} [total] - Total count of related entries. Example: "1".
  * @property {IFormConfig[]} [moduleFormConfigs] - Array of module form configurations associated with the form.
  * @description This interface defines the structure of a form entity, including its identifiers, attributes, and processing data.
@@ -92,15 +92,17 @@ interface IFormsEntity {
 }
 /**
  * @interface IFormLocalizeInfo
+ * @property {string} [title] - Localized name of the form. Optional — the payload is an empty object when the form has no localization for the requested language (e.g. in list responses). Example: "Contact form".
  * @property {string} [titleForSite] - Public-facing title shown on the website. Example: "Form title (for application)".
  * @property {string} [successMessage] - Message shown to the user after successful submission.
  * @property {string} [unsuccessMessage] - Message shown to the user after a failed submission.
  * @property {string} [urlAddress] - URL where the form data is sent for processing (used by `processingType: "url"`).
  * @property {string} [database] - Database flag/id used by the form processor (stringly-typed in the API: "0" / "1" / id).
  * @property {string} [script] - Script flag/id used by the form processor (stringly-typed in the API: "0" / "1" / id).
- * @description Localization payload of a form — extends {@link ILocalizeInfo} with form-side fields (messages, processing config).
+ * @description Localization payload of a form — extends {@link ILocalizeInfo} with form-side fields (messages, processing config). Unlike the base type, `title` is optional here.
  */
-interface IFormLocalizeInfo extends ILocalizeInfo {
+interface IFormLocalizeInfo extends Omit<ILocalizeInfo, 'title'> {
+    title?: string;
     titleForSite?: string;
     successMessage?: string;
     unsuccessMessage?: string;
@@ -120,14 +122,14 @@ interface IFormLocalizeInfo extends ILocalizeInfo {
  * @property {IAttributeValidators} validators - Validation rules; empty object when no validators are configured.
  * @property {Record<string, unknown>} settings - Field-specific configuration; empty object by default.
  * @property {Record<string, IFormAttributeAdditionalField>} additionalFields - Nested sub-fields keyed by marker; empty object when none.
- * @property {boolean} isLogin - Whether this field carries the login value used for authentication. Example: false.
- * @property {boolean} isSignUp - Whether this field is required during sign-up. Example: false.
- * @property {boolean} isPassword - Whether this field carries the password value used for authentication. Example: false.
- * @property {boolean} isSignUpRequired - Whether this field is required during sign-up. Example: false.
- * @property {boolean} isNotificationEmail - Whether this field stores the email used for notifications. Example: false.
- * @property {boolean} isNotificationPhonePush - Whether this field stores the phone number used for push notifications. Example: false.
- * @property {boolean} isNotificationPhoneSMS - Whether this field stores the phone number used for SMS notifications. Example: false.
- * @description Definition of a single field inside a form — extends a generic attribute with form-specific authentication / notification flags.
+ * @property {boolean} [isLogin] - Whether this field carries the login value used for authentication. Optional — present only on attributes of sign-in/sign-up forms. Example: false.
+ * @property {boolean} [isSignUp] - Whether this field is required during sign-up. Optional — present only on attributes of sign-in/sign-up forms. Example: false.
+ * @property {boolean} [isPassword] - Whether this field carries the password value used for authentication. Optional — present only on attributes of sign-in/sign-up forms. Example: false.
+ * @property {boolean} [isSignUpRequired] - Whether this field is required during sign-up. Optional — present only on attributes of sign-in/sign-up forms. Example: false.
+ * @property {boolean} [isNotificationEmail] - Whether this field stores the email used for notifications. Optional — present only on attributes of sign-in/sign-up forms. Example: false.
+ * @property {boolean} [isNotificationPhonePush] - Whether this field stores the phone number used for push notifications. Optional — present only on attributes of sign-in/sign-up forms. Example: false.
+ * @property {boolean} [isNotificationPhoneSMS] - Whether this field stores the phone number used for SMS notifications. Optional — present only on attributes of sign-in/sign-up forms. Example: false.
+ * @description Definition of a single field inside a form — extends a generic attribute with form-specific authentication / notification flags (returned only for sign-in/sign-up forms).
  */
 interface IFormAttribute {
     marker: string;
@@ -140,24 +142,24 @@ interface IFormAttribute {
     validators: IAttributeValidators;
     settings: Record<string, unknown>;
     additionalFields: Record<string, IFormAttributeAdditionalField>;
-    isLogin: boolean;
-    isSignUp: boolean;
-    isPassword: boolean;
-    isSignUpRequired: boolean;
-    isNotificationEmail: boolean;
-    isNotificationPhonePush: boolean;
-    isNotificationPhoneSMS: boolean;
+    isLogin?: boolean;
+    isSignUp?: boolean;
+    isPassword?: boolean;
+    isSignUpRequired?: boolean;
+    isNotificationEmail?: boolean;
+    isNotificationPhonePush?: boolean;
+    isNotificationPhoneSMS?: boolean;
     [key: string]: unknown;
 }
 /**
  * @interface IFormAttributeAdditionalField
- * @property {string} marker - Marker of the additional field. Example: "additional_field".
+ * @property {string} [marker] - Marker of the additional field. Optional — the API returns entries as `{ type, value }`, the marker itself is the key of the `additionalFields` map. Example: "additional_field".
  * @property {string} type - Type of the additional field. Example: "string".
  * @property {unknown} value - Value of the additional field, normalized like any other attribute value: `number | null` for numeric types, the file object itself for a single-file `image`/`file`, `null` when empty. Example: "Additional field data".
  * @description A single nested entry inside {@link IFormAttribute}'s `additionalFields` map.
  */
 interface IFormAttributeAdditionalField {
-    marker: string;
+    marker?: string;
     type: string;
     value: unknown;
 }

package/dist/orders/ordersInterfaces.d.ts

@@ -314,7 +314,7 @@ interface IOrderProductsData {
       }
     ]
  * @property {string} currency - Currency used to pay for the order. Example: "USD".
- * @property {string} totalSum - Total order amount. Example: "150".
+ * @property {number} totalSum - Total order amount. Example: 150.
  * @property {string} [createdDate] - Order creation date. Example: "2023-10-01T12:00:00Z".
  * @property {string} [statusIdentifier] - Text identifier of order status object (if not set, default status will be assigned). Example: "status-1".
  * @property {ILocalizeInfo} [statusLocalizeInfos] - Localized status name assigned to the created/updated order.
@@ -332,7 +332,7 @@ interface IBaseOrdersEntity {
     formData: IOrdersFormData[];
     products: IOrderProductsData[];
     currency: string;
-    totalSum: string;
+    totalSum: number;
     createdDate?: string;
     statusIdentifier?: string;
     statusLocalizeInfos?: ILocalizeInfo;
@@ -608,10 +608,14 @@ interface IOrderByMarkerEntity {
  * @interface IOrderStatus
  * @property {number} [id] - Status identifier. Example: 1.
  * @property {ILocalizeInfo} [localizeInfos] - Localized information for the status.
- * @property {string} [identifier] - Text identifier of the status. Example: "inProgress".
+ * @property {string} [identifier] - Text identifier of the status. Example: "inProgress-payment".
  * @property {number} [position] - Position of the status. Example: 1.
  * @property {boolean} [isUsed] - Whether the status is in use. Example: true.
  * @property {boolean} [isDefault] - Whether the status is the default status. Example: true.
+ * @property {string} [axis] - Status axis (pipeline) the status belongs to. Example: "payment".
+ * @property {boolean} [isCancelFinal] - Whether the status is a final cancellation status. Example: false.
+ * @property {boolean} [isFinalSuccess] - Whether the status is a final successful status. Example: true.
+ * @property {boolean} [isMapped] - Whether the status is mapped to its axis. Example: true.
  */
 interface IOrderStatus {
     id?: number;
@@ -620,6 +624,10 @@ interface IOrderStatus {
     position?: number;
     isUsed?: boolean;
     isDefault?: boolean;
+    axis?: string;
+    isCancelFinal?: boolean;
+    isFinalSuccess?: boolean;
+    isMapped?: boolean;
 }
 /**
  * Interface representing a product in an order preview.

package/dist/products/productsApi.d.ts

@@ -350,12 +350,12 @@ export default class ProductsApi extends AsyncModules implements IProductsApi {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {number} [offset] - Parameter for pagination. Default: 0.
      * @param {number} [limit] - Parameter for pagination. Default: 30.
-     * @returns {Promise<IProductsEntity[] | IError>} Array with ProductEntity objects.
+     * @returns {Promise<IProductsResponse | IError>} Returns an object with an array of found products and total count.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description This method performs a semantic (vector) search for products.
      * @see {@link https://js-sdk.oneentry.cloud/docs/products/getProductsByVectorSearch getProductsByVectorSearch} documentation.
      */
-    getProductsByVectorSearch(body: IVectorSearchProducts, langCode?: string, offset?: number, limit?: number): Promise<IProductsEntity[] | IError>;
+    getProductsByVectorSearch(body: IVectorSearchProducts, langCode?: string, offset?: number, limit?: number): Promise<IProductsResponse | IError>;
     /**
      * Get products by page url.
      * @param {string} url - Page url.

package/dist/products/productsApi.js

@@ -443,7 +443,7 @@ class ProductsApi 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.
-     * @returns {Promise<IProductsEntity[] | IError>} Array with ProductEntity objects.
+     * @returns {Promise<IProductsResponse | IError>} Returns an object with an array of found products and total count.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description This method performs a semantic (vector) search for products.
      * @see {@link https://js-sdk.oneentry.cloud/docs/products/getProductsByVectorSearch getProductsByVectorSearch} documentation.

package/dist/products/productsInterfaces.d.ts

@@ -299,11 +299,11 @@ interface IProductsApi {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {number} [offset] - Parameter for pagination. Default: 0.
      * @param {number} [limit] - Parameter for pagination. Default: 30.
-     * @returns {IProductsEntity[]} Array with ProductEntity objects.
+     * @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.
      * @description This method performs a semantic (vector) search for products.
      */
-    getProductsByVectorSearch(body: IVectorSearchProducts, langCode?: string, offset?: number, limit?: number): Promise<IProductsEntity[] | IError>;
+    getProductsByVectorSearch(body: IVectorSearchProducts, langCode?: string, offset?: number, limit?: number): Promise<IProductsResponse | IError>;
 }
 /**
  * @interface IProductsQueryBase
@@ -533,11 +533,13 @@ interface IProductsEntity {
         "title": "Product 2"
       }
     ]
+ * @property {number} [totalFound] - Number of products matched before limits are applied; returned by block product endpoints (`similarProducts`, cart/wishlist recommendations, frequently ordered). Optional. Example: 2.
  * @description This interface defines the structure of a response containing multiple product entities, including the total count and an array of product items.
  */
 interface IProductsResponse {
     items: IProductsEntity[];
     total: number;
+    totalFound?: number;
 }
 /**
  * @interface IProductSearchResult
@@ -644,31 +646,37 @@ interface IProductBlockSettings {
 }
 /**
  * @interface IProductBlockProductConfig
- * @property {string | number} quantity - Number of products to render. Example: 9.
- * @property {string | number} countElementsPerRow - Products per row. Example: 3.
+ * @property {string | number} [quantity] - Number of products to render; absent when the block config is empty. Example: 9.
+ * @property {string | number} [countElementsPerRow] - Products per row; absent when the block config is empty. Example: 3.
  * @property {string | number} [sortType] - Sort field. Example: "price".
  * @property {string | number} [sortOrder] - Sort direction. Example: "ASC".
- * @description Layout config for products inside a {@link IProductBlock}.
+ * @description Layout config for products inside a {@link IProductBlock}; an empty object when the block is not configured.
  */
 interface IProductBlockProductConfig {
-    quantity: string | number;
-    countElementsPerRow: string | number;
+    quantity?: string | number;
+    countElementsPerRow?: string | number;
     sortType?: string | number;
     sortOrder?: string | number;
 }
 /**
  * @interface IProductBlockSimilarRule
- * @property {string} property - Product property to match on. Example: "categories".
- * @property {string} includes - Match strategy (e.g. "any", "all"). Example: "any".
- * @property {string} keywords - Keywords used for the match. Example: "foo,bar".
- * @property {string} strict - Strictness flag ("true"/"false") of the match. Example: "false".
+ * @property {string} id - Rule identifier (UUID). Example: "812ee2bb-a90f-4743-9643-663f87acedf5".
+ * @property {string} title - Rule title; empty string when not set. Example: "".
+ * @property {string} attributeMarker - Marker of the product attribute the rule matches on. Example: "nameofproduct_3".
+ * @property {string} conditionMarker - Condition operator applied to the attribute. Example: "in".
+ * @property {string} conditionValue - Value the condition compares against. Example: "Blue".
+ * @property {string} statusMarker - Product status marker the rule is limited to; empty string when not limited. Example: "".
+ * @property {string[]} pageUrls - Page URLs the rule is scoped to; empty array when not restricted.
  * @description Single rule used to compute similar products for a {@link IProductBlock}.
  */
 interface IProductBlockSimilarRule {
-    property: string;
-    includes: string;
-    keywords: string;
-    strict: string;
+    id: string;
+    title: string;
+    attributeMarker: string;
+    conditionMarker: string;
+    conditionValue: string;
+    statusMarker: string;
+    pageUrls: string[];
 }
 interface IProductBlock {
     id: number;

package/dist/products/productsSchemas.d.ts

@@ -106,6 +106,7 @@ export declare const ProductsResponseSchema: 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>;
 /**
  * Single product response schema

package/dist/products/productsSchemas.js

@@ -74,6 +74,7 @@ exports.ProductEntitySchema = zod_1.z.object({
 exports.ProductsResponseSchema = zod_1.z.object({
     items: zod_1.z.array(exports.ProductEntitySchema),
     total: zod_1.z.number(),
+    totalFound: zod_1.z.number().optional(),
 });
 /**
  * Single product response schema

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oneentry",
-  "version": "1.0.157",
+  "version": "1.0.158",
   "description": "OneEntry NPM package",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",