oneentry 1.0.175 → 1.0.177

package/esm/blocks/blocksApi.js

@@ -22,7 +22,7 @@ export default class BlocksApi extends AsyncModules {
     /**
      * Get blocks by parameters.
      * @handleName getBlocks
-     * @param {BlockType} [type] - Optional block type to filter by. Available values: "product" | "error_page" | "catalog_page" | "product_preview" | "similar_products_block" | "product_block" | "frequently_ordered_block" | "trending_block" | "recently_viewed_block" | "repeat_purchase_block" | "slider_block" | "personal_recommendations_block" | "cart_complement_block" | "cart_similar_block" | "wishlist_similar_block" | "form" | "common_page" | "common_block" | "order" | "service" | "external_page" | "discount" (see BlockType). When omitted, blocks of all types are returned. Example: 'product'.
+     * @param {BlockType} [type] - Optional block type to filter by. Available values: "product" | "error_page" | "catalog_page" | "product_preview" | "similar_products_block" | "product_block" | "frequently_ordered_block" | "trending_block" | "recently_viewed_block" | "repeat_purchase_block" | "slider_block" | "personal_recommendations_block" | "cart_complement_block" | "cart_similar_block" | "wishlist_similar_block" | "form" | "common_page" | "common_block" | "order" | "service" | "external_page" | "discount" (see BlockType). When omitted, blocks of all types are returned. A type no block has (e.g. "product", which is a product type, not a block type) gives an empty list, not an error. Example: 'product_block'.
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {number} [offset] - Number of records to skip. Default: 0.
      * @param {number} [limit] - Maximum number of records to return. Default: 30.
@@ -35,19 +35,22 @@ export default class BlocksApi extends AsyncModules {
         // empty type value, so it must not be sent at all.
         const query = this._queryParamsToString({ langCode, type, offset, limit });
         const response = await this._fetchPost(`?${query}`);
+        // Display settings are lifted before validation: a strict schema drops
+        // `customSettings`, and with it `countElementsPerRow` and `quantity`
+        if (Array.isArray(response === null || response === void 0 ? void 0 : response.items)) {
+            response.items.forEach((block) => this._liftBlockSettings(block));
+        }
         // Validate response if validation is enabled
         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
-            // normalized value is an IError without `items` — skip enrichment and
-            // return it as-is
-            if (Array.isArray(normalizeResponse.items)) {
-                await Promise.all(normalizeResponse.items.map((block) => this._enrichBlock(block, langCode, offset, limit, true)));
-            }
-            return normalizeResponse;
+        const normalizeResponse = this._normalizeData(validated, langCode);
+        // On API error responses (e.g. 403 without list permission, 422) the
+        // normalized value is an IError without `items` — return it as-is.
+        // `offset` and `limit` page the list of blocks, not the products inside
+        // each block: passed on, `offset: 5` emptied every block's products.
+        if (!this.state.traficLimit && Array.isArray(normalizeResponse.items)) {
+            await Promise.all(normalizeResponse.items.map((block) => this._loadBlockProducts(block, langCode)));
         }
-        return this._normalizeData(validated);
+        return normalizeResponse;
     }
     /**
      * Get block by marker.
@@ -62,33 +65,29 @@ export default class BlocksApi extends AsyncModules {
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getBlockByMarker getBlockByMarker} documentation.
      */
     async getBlockByMarker(marker, langCode = this.state.lang, offset = 0, limit = 30) {
-        const response = await this._fetchGet(`/marker/${marker}?langCode=${langCode}`);
+        const response = await this._fetchGet(`/marker/${this._pathSegment(marker)}?langCode=${encodeURIComponent(langCode)}`);
+        if (response && !this._isErrorResponse(response)) {
+            this._liftBlockSettings(response);
+        }
         // Validate response if validation is enabled
         const validated = await this._validateResponse(response, schema('BlockEntitySchema'));
-        const normalizeResponse = this._normalizeData(validated);
-        await this._enrichBlock(normalizeResponse, langCode, offset, limit, !this.state.traficLimit);
+        const normalizeResponse = this._normalizeData(validated, langCode);
+        if (!this.state.traficLimit && !this._isErrorResponse(normalizeResponse)) {
+            await this._loadBlockProducts(normalizeResponse, langCode, offset, limit);
+        }
         return normalizeResponse;
     }
     /**
-     * Enrich a single block in place.
-     *
-     * Lifts product display settings from `customSettings.productConfig` to
-     * numeric top-level fields, strips internal-only fields, and — when
-     * `loadProducts` is true — fetches the related products for
-     * `similar_products_block` / `product_block` blocks. Shared by `getBlocks`
-     * (array) and `getBlockByMarker` (single block). Mutates `block` in place.
-     * @param {any} block - Normalized block to enrich (mutated in place).
-     * @param {string} langCode - Language code passed to product sub-requests.
-     * @param {number} offset - Pagination offset for product sub-requests.
-     * @param {number} limit - Pagination limit for product sub-requests.
-     * @param {boolean} loadProducts - Whether to fetch related products.
-     * @returns {Promise<void>} Resolves when enrichment (incl. sub-requests) is done.
+     * Lifts the product display settings of a block to top-level fields and drops internal ones.
+     * @param {any} block - A block as the API sent it.
+     * @description `customSettings.productConfig` holds `countElementsPerRow` and `quantity`
+     * as strings; they become numbers on the block. `customSettings`, `attributeSetIdentifier`
+     * and `productPageUrls` are internal and removed — in traffic-saving mode as well, which
+     * used to return them as they came; the set marker was misspelt (`attributesSetIdentifier`)
+     * and stayed in every block.
      */
-    async _enrichBlock(block, langCode, offset, limit, loadProducts) {
-        const customSettings = block.customSettings;
-        // Если у блока есть настройки отображения товаров (productConfig) —
-        // переносим их на верхний уровень блока в числовом формате (в API значения
-        // хранятся строками, поэтому приводим через «+»).
+    _liftBlockSettings(block) {
+        const customSettings = block === null || block === void 0 ? void 0 : block.customSettings;
         if (customSettings &&
             Object.prototype.hasOwnProperty.call(customSettings, 'productConfig')) {
             if (customSettings.productConfig.countElementsPerRow)
@@ -97,31 +96,43 @@ export default class BlocksApi extends AsyncModules {
             if (customSettings.productConfig.quantity)
                 block.quantity = +customSettings.productConfig.quantity;
         }
-        // Убираем служебные/внутренние поля из итогового объекта блока.
         delete block.customSettings;
-        delete block.attributesSetIdentifier;
+        delete block.attributeSetIdentifier;
         delete block.productPageUrls;
-        // В режиме экономии трафика товары не подгружаем.
-        if (!loadProducts)
-            return;
-        // Подгружаем связанные товары по идентификатору блока. При ошибке запроса
-        // подставляем пустой массив, чтобы один упавший подзапрос не ронял весь
-        // ответ (в getBlocks — не ломал обработку остальных блоков).
+    }
+    /**
+     * Attaches the products of a product or similar-products block.
+     * @param {any} block - A normalized block.
+     * @param {string} langCode - Language of the products.
+     * @param {number} [offset] - Products to skip.
+     * @param {number} [limit] - Products to return.
+     * @description A failed sub-request leaves an empty value of the declared type —
+     * `{ items: [], total: 0 }` for `similarProducts`, `[]` for `products` — instead of
+     * the error object or an array where a container is declared.
+     */
+    async _loadBlockProducts(block, langCode, offset, limit) {
         if (block.type === 'similar_products_block') {
+            let similar;
             try {
-                block.similarProducts = await this.getSimilarProducts(block.identifier, langCode, offset, limit);
+                similar = await this._asSubRequest().getSimilarProducts(block.identifier, langCode, offset, limit);
             }
             catch {
-                block.similarProducts = [];
+                similar = null;
             }
+            block.similarProducts =
+                similar && !this._isErrorResponse(similar)
+                    ? similar
+                    : { items: [], total: 0 };
         }
         else if (block.type === 'product_block') {
+            let products;
             try {
-                block.products = await this.getProductsByBlockMarker(block.identifier, langCode, offset, limit);
+                products = await this._asSubRequest().getProductsByBlockMarker(block.identifier, langCode, offset, limit);
             }
             catch {
-                block.products = [];
+                products = null;
             }
+            block.products = Array.isArray(products) ? products : [];
         }
     }
     /**
@@ -136,7 +147,6 @@ export default class BlocksApi extends AsyncModules {
      * @param {number} [productId] - Optional product id to find similar products for.
      * @returns {Promise<IProductsResponse | IError>} Returns the total count and an array of product items in object by specified block marker.
      * @throws {IError} When isShell=false and an error occurs during the fetch
-     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getSimilarProducts getSimilarProducts} documentation.
      */
     async getSimilarProducts(marker, langCode = this.state.lang, offset = 0, limit = 30, signPrice, productId) {
         const query = {
@@ -146,8 +156,9 @@ export default class BlocksApi extends AsyncModules {
             signPrice,
             productId,
         };
-        const result = await this._fetchGet(`/${marker}/similar-products?` + this._queryParamsToString(query));
-        return this._normalizeData(result);
+        const result = await this._fetchGet(`/${this._pathSegment(marker)}/similar-products?` +
+            this._queryParamsToString(query));
+        return this._normalizeData(result, langCode);
     }
     /**
      * Get products by block marker.
@@ -160,7 +171,6 @@ export default class BlocksApi extends AsyncModules {
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
      * @returns {Promise<IProductsEntity[] | IError>} Return array of BlocksEntity object.
      * @throws {IError} When isShell=false and an error occurs during the fetch
-     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getProductsByBlockMarker getProductsByBlockMarker} documentation.
      */
     async getProductsByBlockMarker(marker, langCode = this.state.lang, offset = 0, limit = 30, signPrice) {
         const query = {
@@ -169,13 +179,14 @@ export default class BlocksApi extends AsyncModules {
             limit,
             signPrice,
         };
-        const result = await this._fetchGet(`/${marker}/products?` + this._queryParamsToString(query));
+        const result = await this._fetchGet(`/${this._pathSegment(marker)}/products?` +
+            this._queryParamsToString(query));
         // On API error responses there is no `items` array — return the (normalized)
         // error as-is instead of producing `undefined` from `result.items`.
         if (!Array.isArray(result === null || result === void 0 ? void 0 : result.items)) {
-            return this._normalizeData(result);
+            return this._normalizeData(result, langCode);
         }
-        return this._normalizeData(result.items);
+        return this._normalizeData(result.items, langCode);
     }
     /**
      * Get frequently ordered products by block marker and product id.
@@ -196,9 +207,9 @@ export default class BlocksApi extends AsyncModules {
             signPrice,
             limit,
         };
-        const data = await this._fetchGet(`/${marker}/products/${productId}/frequently-ordered?` +
+        const data = await this._fetchGet(`/${this._pathSegment(marker)}/products/${this._pathSegment(String(productId))}/frequently-ordered?` +
             this._queryParamsToString(query));
-        return this._normalizeData(data);
+        return this._normalizeData(data, langCode);
     }
     /**
      * Quick search for block objects with limited output.
@@ -229,8 +240,9 @@ export default class BlocksApi extends AsyncModules {
      */
     async getCartComplement(marker, langCode = this.state.lang, signPrice, limit) {
         const query = { langCode, signPrice, limit };
-        const data = await this._fetchGet(`/${marker}/cart-complement?` + this._queryParamsToString(query));
-        return this._normalizeData(data);
+        const data = await this._fetchGet(`/${this._pathSegment(marker)}/cart-complement?` +
+            this._queryParamsToString(query));
+        return this._normalizeData(data, langCode);
     }
     /**
      * Get "complete your cart" products by an explicit list of productIds (POST body).
@@ -247,8 +259,11 @@ export default class BlocksApi extends AsyncModules {
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getCartComplementByProductIds getCartComplementByProductIds} documentation.
      */
     async getCartComplementByProductIds(marker, body) {
-        const data = await this._fetchPost(`/${marker}/cart-complement`, { langCode: this.state.lang, ...body });
-        return this._normalizeData(data);
+        var _a;
+        // An explicit `langCode: undefined` in the body used to override the default
+        const langCode = (_a = body.langCode) !== null && _a !== void 0 ? _a : this.state.lang;
+        const data = await this._fetchPost(`/${this._pathSegment(marker)}/cart-complement`, { ...body, langCode });
+        return this._normalizeData(data, langCode);
     }
     /**
      * Get "similar to cart" products by the cart from context (auth user or guest).
@@ -264,8 +279,9 @@ export default class BlocksApi extends AsyncModules {
      */
     async getCartSimilar(marker, langCode = this.state.lang, signPrice, limit) {
         const query = { langCode, signPrice, limit };
-        const data = await this._fetchGet(`/${marker}/cart-similar?` + this._queryParamsToString(query));
-        return this._normalizeData(data);
+        const data = await this._fetchGet(`/${this._pathSegment(marker)}/cart-similar?` +
+            this._queryParamsToString(query));
+        return this._normalizeData(data, langCode);
     }
     /**
      * Get "similar to cart" products by an explicit list of productIds (POST body).
@@ -282,8 +298,11 @@ export default class BlocksApi extends AsyncModules {
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getCartSimilarByProductIds getCartSimilarByProductIds} documentation.
      */
     async getCartSimilarByProductIds(marker, body) {
-        const data = await this._fetchPost(`/${marker}/cart-similar`, { langCode: this.state.lang, ...body });
-        return this._normalizeData(data);
+        var _a;
+        // An explicit `langCode: undefined` in the body used to override the default
+        const langCode = (_a = body.langCode) !== null && _a !== void 0 ? _a : this.state.lang;
+        const data = await this._fetchPost(`/${this._pathSegment(marker)}/cart-similar`, { ...body, langCode });
+        return this._normalizeData(data, langCode);
     }
     /**
      * Get personal recommendations for the user.
@@ -299,8 +318,9 @@ export default class BlocksApi extends AsyncModules {
      */
     async getPersonalRecommendations(marker, langCode = this.state.lang, signPrice, limit) {
         const query = { langCode, signPrice, limit };
-        const data = await this._fetchGet(`/${marker}/personal-recommendations?` + this._queryParamsToString(query));
-        return this._normalizeData(data);
+        const data = await this._fetchGet(`/${this._pathSegment(marker)}/personal-recommendations?` +
+            this._queryParamsToString(query));
+        return this._normalizeData(data, langCode);
     }
     /**
      * Get recently viewed products.
@@ -316,8 +336,9 @@ export default class BlocksApi extends AsyncModules {
      */
     async getRecentlyViewed(marker, langCode = this.state.lang, signPrice, limit) {
         const query = { langCode, signPrice, limit };
-        const data = await this._fetchGet(`/${marker}/recently-viewed?` + this._queryParamsToString(query));
-        return this._normalizeData(data);
+        const data = await this._fetchGet(`/${this._pathSegment(marker)}/recently-viewed?` +
+            this._queryParamsToString(query));
+        return this._normalizeData(data, langCode);
     }
     /**
      * Get products for repeat purchase.
@@ -333,8 +354,9 @@ export default class BlocksApi extends AsyncModules {
      */
     async getRepeatPurchase(marker, langCode = this.state.lang, signPrice, limit) {
         const query = { langCode, signPrice, limit };
-        const data = await this._fetchGet(`/${marker}/repeat-purchase?` + this._queryParamsToString(query));
-        return this._normalizeData(data);
+        const data = await this._fetchGet(`/${this._pathSegment(marker)}/repeat-purchase?` +
+            this._queryParamsToString(query));
+        return this._normalizeData(data, langCode);
     }
     /**
      * Get the block's slides tree as a flat pre-order array (slider_block only).
@@ -345,7 +367,7 @@ export default class BlocksApi extends AsyncModules {
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getSlides getSlides} documentation.
      */
     async getSlides(marker) {
-        const data = await this._fetchGet(`/${marker}/slides`);
+        const data = await this._fetchGet(`/${this._pathSegment(marker)}/slides`);
         return this._normalizeData(data);
     }
     /**
@@ -362,8 +384,9 @@ export default class BlocksApi extends AsyncModules {
      */
     async getTrending(marker, langCode = this.state.lang, signPrice, limit) {
         const query = { langCode, signPrice, limit };
-        const data = await this._fetchGet(`/${marker}/trending?` + this._queryParamsToString(query));
-        return this._normalizeData(data);
+        const data = await this._fetchGet(`/${this._pathSegment(marker)}/trending?` +
+            this._queryParamsToString(query));
+        return this._normalizeData(data, langCode);
     }
     /**
      * Get "similar to wishlist" products by the wishlist from context (auth user or guest).
@@ -379,8 +402,9 @@ export default class BlocksApi extends AsyncModules {
      */
     async getWishlistSimilar(marker, langCode = this.state.lang, signPrice, limit) {
         const query = { langCode, signPrice, limit };
-        const data = await this._fetchGet(`/${marker}/wishlist-similar?` + this._queryParamsToString(query));
-        return this._normalizeData(data);
+        const data = await this._fetchGet(`/${this._pathSegment(marker)}/wishlist-similar?` +
+            this._queryParamsToString(query));
+        return this._normalizeData(data, langCode);
     }
     /**
      * Get "similar to wishlist" products by an explicit list of productIds (POST body).
@@ -397,7 +421,10 @@ export default class BlocksApi extends AsyncModules {
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getWishlistSimilarByProductIds getWishlistSimilarByProductIds} documentation.
      */
     async getWishlistSimilarByProductIds(marker, body) {
-        const data = await this._fetchPost(`/${marker}/wishlist-similar`, { langCode: this.state.lang, ...body });
-        return this._normalizeData(data);
+        var _a;
+        // An explicit `langCode: undefined` in the body used to override the default
+        const langCode = (_a = body.langCode) !== null && _a !== void 0 ? _a : this.state.lang;
+        const data = await this._fetchPost(`/${this._pathSegment(marker)}/wishlist-similar`, { ...body, langCode });
+        return this._normalizeData(data, langCode);
     }
 }

package/esm/blocks/blocksInterfaces.d.ts

@@ -9,7 +9,7 @@ interface IBlocks {
     /**
      * Retrieves all block objects of a specific type.
      * @handleName getBlocks
-     * @param {BlockType} [type] - Optional type of blocks to retrieve. When omitted, blocks of all types are returned. Example: "product".
+     * @param {BlockType} [type] - Optional type of blocks to retrieve. When omitted, blocks of all types are returned. A type no block has (e.g. "product") gives an empty list, not an error. Example: "product_block".
      * @param {string} [langCode] - Optional language code for localization. Default: "en_US".
      * @param {number} [offset] - Number of records to skip. Default: 0.
      * @param {number} [limit] - Maximum number of records to return. Default: 30.
@@ -203,7 +203,7 @@ interface IBlocks {
         "localizeInfos": { "key": "value" },
         "position": 1,
         "templateIdentifier": null,
-        "type": "product",
+        "type": "product_block",
         "version": 1,
         "countElementsPerRow": 3,
         "quantity": 9,
@@ -214,11 +214,11 @@ interface IBlocks {
         "products": [
           {
           "id": 1,
-          "name": "Product 1"
+          "localizeInfos": { "title": "Product 1" }
           },
           {
           "id": 2,
-          "name": "Product 2"
+          "localizeInfos": { "title": "Product 2" }
           }
         ]
       }
@@ -252,7 +252,7 @@ interface IBlocksResponse {
     }
  * @property {number} version - Version number of the block. Example: 1.
  * @property {string} identifier - Marker of the block. Example: "block1".
- * @property {BlockType} type - Type of the block. Example: "product".
+ * @property {BlockType} type - Type of the block. Example: "product_block".
  * @property {number} position - Position of the block, used for sorting. Example: 1.
  * @property {string | null} templateIdentifier - Marker of the template used by the block, or `null`. Example: "template1".
  * @property {boolean} isVisible - Whether the block is visible. Example: true.
@@ -269,11 +269,11 @@ interface IBlocksResponse {
     [
      {
        "id": 1,
-       "name": "Product 1"
+       "localizeInfos": { "title": "Product 1" }
      },
      {
        "id": 2,
-       "name": "Product 2"
+       "localizeInfos": { "title": "Product 2" }
      }
     ]
  * @description Represents a block entity with various attributes and properties.
@@ -311,7 +311,7 @@ interface ISearchBlock {
  * @type {BlockType}
  * @description This type defines the possible values for block types used in the system: the types `GET /api/content/general-types` returns.
  * `'none'` was dropped — the platform has no such type and a filter by it answers `400 type must be a valid enum value`.
- * `'service'` is the platform's own name for the type, but the `type` filter of getBlocks and getTemplateByType currently refuses it with the same `400`; that is a platform defect.
+ * `'service'` is the platform's own name for the type; the `type` filter of getBlocks and getTemplateByType takes it in lower case.
  */
 type BlockType = 'product' | 'error_page' | 'catalog_page' | 'product_preview' | 'similar_products_block' | 'product_block' | 'frequently_ordered_block' | 'trending_block' | 'recently_viewed_block' | 'repeat_purchase_block' | 'slider_block' | 'personal_recommendations_block' | 'cart_complement_block' | 'cart_similar_block' | 'wishlist_similar_block' | 'form' | 'common_page' | 'common_block' | 'order' | 'service' | 'external_page' | 'discount';
 /**

package/esm/discounts/discountsApi.d.ts

@@ -3,12 +3,12 @@ import type StateModule from '../base/stateModule.js';
 import type { IError, IVectorSearchResponse } from '../base/utils.js';
 import type { IBonusBalanceEntity, IBonusHistoryResponse, IBonusTransactionType, ICouponValidationResult, IDiscountsApi, IDiscountsEntity, IDiscountsResponse, IDiscountsVectorSearch, IDiscountType } from './discountsInterfaces.js';
 /**
- * Controllers for working with events
- * @handle /api/content/events
+ * Controllers for working with discounts, coupons and the bonus balance
+ * @handle /api/content/discounts
  * @class DiscountsApi
  * @augments AsyncModules
  * @implements {IDiscountsApi}
- * @description This class provides methods to interact with events, including subscribing and unsubscribing to product events, and retrieving all subscriptions.
+ * @description This class provides methods for discounts: the list and one discount by marker, coupon validation, the bonus balance and its history, and vector search.
  */
 export default class DiscountsApi extends AsyncModules implements IDiscountsApi {
     protected state: StateModule;
@@ -38,7 +38,7 @@ export default class DiscountsApi extends AsyncModules implements IDiscountsApi
     /**
      * Get discount by marker
      * @handleName getDiscountByMarker
-     * @param {string} marker - Marker of the discount storage. Example: "discount_storage".
+     * @param {string} marker - Marker of the discount. Example: "example_discount".
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @returns {Promise<IDiscountsEntity | IError>} Returns an object containing discount by marker or an error object if there was an issue.
      * @throws {IError} When isShell=false and an error occurs during the fetch
@@ -58,16 +58,18 @@ export default class DiscountsApi extends AsyncModules implements IDiscountsApi
      * Get bonus transaction history of the current user.
      * @handleName getBonusHistory
      * @param {IBonusTransactionType} [type] - Transaction type to filter by.
-     * @param {string} [dateFrom] - Start of the date range.
-     * @param {string} [dateTo] - End of the date range.
+     * @param {string} [dateFrom] - Start of the date range. Full ISO date-time (`2026-01-01T00:00:00.000Z`); a bare date answers `400 dateFrom must be a ISOString`.
+     * @param {string} [dateTo] - End of the date range. Full ISO date-time (`2026-12-31T00:00:00.000Z`); a bare date answers `400 dateTo must be a ISOString`.
      * @param {number} [discountId] - Return only transactions of this discount ID.
      * @param {number} [moduleId] - Filter by module ID.
      * @param {boolean} [isAdmin] - Filter by the transaction's `isAdmin` flag.
+     * @param {number} [offset] - Number of transactions to skip, `0` or more. Default: 0.
+     * @param {number} [limit] - Maximum number of transactions to return, `1` or more. Default: 30.
      * @returns {Promise<IBonusHistoryResponse | IError>} Returns the container with the transactions and their total, or an error object.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @see {@link https://js-sdk.oneentry.cloud/docs/discounts/getBonusHistory getBonusHistory} documentation.
      */
-    getBonusHistory(type?: IBonusTransactionType, dateFrom?: string, dateTo?: string, discountId?: number, moduleId?: number, isAdmin?: boolean): Promise<IBonusHistoryResponse | IError>;
+    getBonusHistory(type?: IBonusTransactionType, dateFrom?: string, dateTo?: string, discountId?: number, moduleId?: number, isAdmin?: boolean, offset?: number, limit?: number): Promise<IBonusHistoryResponse | IError>;
     /**
      * Validate discounts coupon
      * @handleName validateDiscountsCoupon

package/esm/discounts/discountsApi.js

@@ -1,11 +1,11 @@
 import AsyncModules from '../base/asyncModules.js';
 /**
- * Controllers for working with events
- * @handle /api/content/events
+ * Controllers for working with discounts, coupons and the bonus balance
+ * @handle /api/content/discounts
  * @class DiscountsApi
  * @augments AsyncModules
  * @implements {IDiscountsApi}
- * @description This class provides methods to interact with events, including subscribing and unsubscribing to product events, and retrieving all subscriptions.
+ * @description This class provides methods for discounts: the list and one discount by marker, coupon validation, the bonus balance and its history, and vector search.
  */
 export default class DiscountsApi extends AsyncModules {
     /**
@@ -40,12 +40,12 @@ export default class DiscountsApi extends AsyncModules {
             type,
         };
         const data = await this._fetchGet(`?` + this._queryParamsToString(query));
-        return this._normalizeData(data);
+        return this._normalizeData(data, langCode);
     }
     /**
      * Get discount by marker
      * @handleName getDiscountByMarker
-     * @param {string} marker - Marker of the discount storage. Example: "discount_storage".
+     * @param {string} marker - Marker of the discount. Example: "example_discount".
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @returns {Promise<IDiscountsEntity | IError>} Returns an object containing discount by marker or an error object if there was an issue.
      * @throws {IError} When isShell=false and an error occurs during the fetch
@@ -53,12 +53,11 @@ export default class DiscountsApi extends AsyncModules {
      * @see {@link https://js-sdk.oneentry.cloud/docs/discounts/getDiscountByMarker getDiscountByMarker} documentation.
      */
     async getDiscountByMarker(marker, langCode = this.state.lang) {
-        const query = {
-            marker: '',
-            langCode,
-        };
-        const data = await this._fetchGet(`/marker/${marker}?` + this._queryParamsToString(query));
-        return this._normalizeData(data);
+        // The marker goes in the path; an empty `marker=` used to be sent along
+        const query = { langCode };
+        const data = await this._fetchGet(`/marker/${this._pathSegment(marker)}?` +
+            this._queryParamsToString(query));
+        return this._normalizeData(data, langCode);
     }
     /**
      * Get bonus balance of the current user.
@@ -75,16 +74,19 @@ export default class DiscountsApi extends AsyncModules {
      * Get bonus transaction history of the current user.
      * @handleName getBonusHistory
      * @param {IBonusTransactionType} [type] - Transaction type to filter by.
-     * @param {string} [dateFrom] - Start of the date range.
-     * @param {string} [dateTo] - End of the date range.
+     * @param {string} [dateFrom] - Start of the date range. Full ISO date-time (`2026-01-01T00:00:00.000Z`); a bare date answers `400 dateFrom must be a ISOString`.
+     * @param {string} [dateTo] - End of the date range. Full ISO date-time (`2026-12-31T00:00:00.000Z`); a bare date answers `400 dateTo must be a ISOString`.
      * @param {number} [discountId] - Return only transactions of this discount ID.
      * @param {number} [moduleId] - Filter by module ID.
      * @param {boolean} [isAdmin] - Filter by the transaction's `isAdmin` flag.
+     * @param {number} [offset] - Number of transactions to skip, `0` or more. Default: 0.
+     * @param {number} [limit] - Maximum number of transactions to return, `1` or more. Default: 30.
      * @returns {Promise<IBonusHistoryResponse | IError>} Returns the container with the transactions and their total, or an error object.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @see {@link https://js-sdk.oneentry.cloud/docs/discounts/getBonusHistory getBonusHistory} documentation.
      */
-    async getBonusHistory(type, dateFrom, dateTo, discountId, moduleId, isAdmin) {
+    async getBonusHistory(type, dateFrom, dateTo, discountId, moduleId, isAdmin, offset, limit) {
+        // The endpoint pages its answer; offset/limit were not reachable from the SDK
         const query = {
             type,
             dateFrom,
@@ -92,6 +94,8 @@ export default class DiscountsApi extends AsyncModules {
             discountId,
             moduleId,
             isAdmin,
+            offset,
+            limit,
         };
         const data = await this._fetchGet(`/bonus-balance/history?` + this._queryParamsToString(query));
         return this._normalizeData(data);

package/esm/discounts/discountsInterfaces.d.ts

@@ -10,7 +10,7 @@ type IDiscountType = 'DISCOUNT' | 'BONUS' | 'PERSONAL_DISCOUNT';
 interface IDiscountsApi {
     /**
      * Return all discounts.
-     * @handleName getAllSubscriptions
+     * @handleName getAllDiscounts
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {number} [offset] - Number of records to skip. Default: 0.
      * @param {number} [limit] - Maximum number of records to return. Default: 30.
@@ -23,7 +23,7 @@ interface IDiscountsApi {
     /**
      * Get discount by marker
      * @handleName getDiscountByMarker
-     * @param {string} marker - Marker of the discount storage. Example: "discount_storage".
+     * @param {string} marker - Marker of the discount. Example: "example_discount".
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @returns {Promise<IDiscountsEntity | IError>} Returns an object containing discount by marker or an error object if there was an issue.
      * @throws {IError} When isShell=false and an error occurs during the fetch
@@ -50,15 +50,17 @@ interface IDiscountsApi {
      * Get bonus transaction history of the current user.
      * @handleName getBonusHistory
      * @param {string} [type] - Transaction type to filter by.
-     * @param {string} [dateFrom] - Start of the date range.
-     * @param {string} [dateTo] - End of the date range.
+     * @param {string} [dateFrom] - Start of the date range. Full ISO date-time (`2026-01-01T00:00:00.000Z`); a bare date answers `400 dateFrom must be a ISOString`.
+     * @param {string} [dateTo] - End of the date range. Full ISO date-time (`2026-12-31T00:00:00.000Z`); a bare date answers `400 dateTo must be a ISOString`.
      * @param {number} [discountId] - Return only transactions of this discount ID.
      * @param {number} [moduleId] - Filter by module ID.
      * @param {boolean} [isAdmin] - Filter by the transaction's `isAdmin` flag.
+     * @param {number} [offset] - Number of transactions to skip, `0` or more. Default: 0.
+     * @param {number} [limit] - Maximum number of transactions to return, `1` or more. Default: 30.
      * @returns {Promise<IBonusHistoryResponse | IError>} Returns the container with the transactions and their total, or an error object.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      */
-    getBonusHistory(type?: IBonusTransactionType, dateFrom?: string, dateTo?: string, discountId?: number, moduleId?: number, isAdmin?: boolean): Promise<IBonusHistoryResponse | IError>;
+    getBonusHistory(type?: IBonusTransactionType, dateFrom?: string, dateTo?: string, discountId?: number, moduleId?: number, isAdmin?: boolean, offset?: number, limit?: number): Promise<IBonusHistoryResponse | IError>;
     /**
      * Semantic (vector) search for discounts.
      * @handleName getDiscountsByVectorSearch
@@ -133,7 +135,6 @@ interface IDiscountCondition {
  * @property {string} [attributeSetIdentifier] - Marker of the attribute set.
  * @property {Record<string, unknown>} [bonusEvent] - Bonus event configuration.
  * @property {number} [position] - Position used for sorting. Example: 1.
- * @property {number | string} [total] - Total count of related entries. Example: "1".
  * @property {number} [distance] - Cosine distance to the query. Returned only by the semantic (vector) search endpoint when `debug: true` is passed in the search body. Example: 0.12.
  */
 interface IDiscountsEntity {
@@ -157,7 +158,6 @@ interface IDiscountsEntity {
     attributeSetIdentifier?: string;
     bonusEvent?: Record<string, unknown> | null;
     position?: number;
-    total?: number | string;
     distance?: number;
 }
 /**
@@ -235,17 +235,19 @@ interface IDiscountByMarkerQuery {
     marker: string;
 }
 /**
- *
+ * Type of a bonus balance transaction: accrual, usage, reduction, the reversal of an accrual or a usage, or expiration.
  */
 type IBonusTransactionType = 'ACCRUAL' | 'USAGE' | 'REDUCE' | 'REVERSAL_ACCRUAL' | 'REVERSAL_USAGE' | 'EXPIRATION';
 /**
  * @interface IBonusHistoryQuery
  * @property {IBonusTransactionType} [type] - Transaction type to filter by.
- * @property {string} [dateFrom] - Start of the date range.
- * @property {string} [dateTo] - End of the date range.
+ * @property {string} [dateFrom] - Start of the date range. Full ISO date-time (`2026-01-01T00:00:00.000Z`); a bare date answers `400 dateFrom must be a ISOString`.
+ * @property {string} [dateTo] - End of the date range. Full ISO date-time (`2026-12-31T00:00:00.000Z`); a bare date answers `400 dateTo must be a ISOString`.
  * @property {number} [discountId] - Return only transactions of this discount ID.
  * @property {number} [moduleId] - Filter by module ID.
  * @property {boolean} [isAdmin] - Filter by the transaction's `isAdmin` flag.
+ * @property {number} [offset] - Number of transactions to skip. Default: 0.
+ * @property {number} [limit] - Maximum number of transactions to return. Default: 30.
  */
 interface IBonusHistoryQuery {
     type?: IBonusTransactionType;
@@ -254,6 +256,8 @@ interface IBonusHistoryQuery {
     discountId?: number;
     moduleId?: number;
     isAdmin?: boolean;
+    offset?: number;
+    limit?: number;
 }
 /**
  * @interface IBonusTransactionEntity