oneentry 1.0.149 → 1.0.151

package/dist/base/syncModules.js

@@ -1,52 +1,83 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-// Module-level device ID cache — survives class re-instantiation,
-// but resets on page reload if localStorage is unavailable.
-let _persistentDeviceId = null;
+// localStorage keys for the persistent browser-side identifiers.
+const _DEVICE_ID_STORAGE_KEY = 'oneentry_device_id';
+const _GUEST_ID_STORAGE_KEY = 'oneentry_guest_id';
+// Module-level cache of persistent IDs keyed by storage key — survives class
+// re-instantiation, but resets on page reload if localStorage is unavailable.
+const _persistentIds = {};
 /**
- * Returns a stable device ID for the browser environment.
+ * Generates a new opaque identifier.
  *
- * Algorithm:
+ * Prefers a cryptographically secure source (Web Crypto, exposed as
+ * `globalThis.crypto` in browsers and Node.js >= 18): `randomUUID()` when
+ * available, otherwise random bytes rendered as a base-36 string. Falls back to
+ * a timestamp + `Math.random()` only when no CSPRNG exists (e.g. very old Node).
+ *
+ * The result contains no special characters, so it is safe to use both in
+ * localStorage and in HTTP headers.
+ * @returns {string} A freshly generated identifier.
+ */
+function _generateId() {
+    const cryptoObj = typeof globalThis !== 'undefined' ? globalThis.crypto : undefined;
+    if (cryptoObj === null || cryptoObj === void 0 ? void 0 : cryptoObj.randomUUID) {
+        return cryptoObj.randomUUID();
+    }
+    if (cryptoObj === null || cryptoObj === void 0 ? void 0 : cryptoObj.getRandomValues) {
+        const bytes = cryptoObj.getRandomValues(new Uint8Array(18));
+        let result = '';
+        for (let i = 0; i < bytes.length; i++) {
+            result += bytes[i].toString(36).padStart(2, '0');
+        }
+        return result;
+    }
+    // Last-resort fallback for environments without Web Crypto.
+    // Non-cryptographic, but adequate when nothing better is available.
+    return (Date.now().toString(36) +
+        Math.random().toString(36).substring(2, 15) +
+        Math.random().toString(36).substring(2, 15));
+}
+/**
+ * Returns a stable identifier for the browser environment, persisted in localStorage.
+ *
+ * Algorithm (per `storageKey`):
  * 1. If the module-level cache is already populated — return it (fastest path).
- * 2. Otherwise try reading the ID from localStorage (key `oneentry_device_id`).
+ * 2. Otherwise try reading the ID from localStorage under `storageKey`.
  * This ensures the same browser gets the same ID across sessions and tabs.
- * 3. If localStorage has nothing — generate a new ID from timestamp + random,
- * persist it to localStorage and cache it in the module variable.
+ * 3. If localStorage has nothing — generate a new ID, persist it to localStorage
+ * and cache it in the module variable.
  * 4. If localStorage is unavailable (SSR, private mode, iframe sandbox) —
- * return null; the caller falls back to `_nodeDeviceId`.
- * @returns {string | null} Device ID or null if localStorage is unavailable.
+ * return null; the caller falls back to a per-instance Node id.
+ * @param {string} storageKey - localStorage key under which the ID is stored.
+ * @returns {string | null} The identifier or null if localStorage is unavailable.
  */
-function _getBrowserDeviceId() {
+function _getPersistentBrowserId(storageKey) {
     const win = typeof globalThis !== 'undefined' ? globalThis.window : undefined;
     if (!(win === null || win === void 0 ? void 0 : win.localStorage))
         return null;
-    if (_persistentDeviceId)
-        return _persistentDeviceId;
+    if (_persistentIds[storageKey])
+        return _persistentIds[storageKey];
     try {
-        const stored = win.localStorage.getItem('oneentry_device_id');
+        const stored = win.localStorage.getItem(storageKey);
         if (stored) {
-            _persistentDeviceId = stored;
-            return _persistentDeviceId;
+            _persistentIds[storageKey] = stored;
+            return _persistentIds[storageKey];
         }
         // eslint-disable-next-line @typescript-eslint/no-unused-vars
     }
     catch (_e) {
         // ignore
     }
-    // Generate ID: base-36 timestamp + two random segments.
-    // base-36 is more compact than hex and contains no special characters.
-    const id = Date.now().toString(36) +
-        Math.random().toString(36).substring(2, 15) +
-        Math.random().toString(36).substring(2, 15);
-    _persistentDeviceId = id;
+    const id = _generateId();
+    _persistentIds[storageKey] = id;
     try {
-        win.localStorage.setItem('oneentry_device_id', id);
+        win.localStorage.setItem(storageKey, id);
         // eslint-disable-next-line @typescript-eslint/no-unused-vars
     }
     catch (_e) {
         // ignore
     }
-    return _persistentDeviceId;
+    return _persistentIds[storageKey];
 }
 /**
  * Abstract class representing synchronization modules.
@@ -70,10 +101,37 @@ class SyncModules {
         this._sortAttributes = (data) => Object.fromEntries(Object.entries(data).sort(([, a], [, b]) => a.position - b.position));
         this.state = state;
         this._url = state.url;
-        this._nodeDeviceId =
-            Date.now().toString(36) +
-                Math.random().toString(36).substring(2, 15) +
-                Math.random().toString(36).substring(2, 15);
+        this._nodeDeviceId = _generateId();
+    }
+    /**
+     * Resolves the guest identifier for the current request, or `undefined`.
+     *
+     * Resolution order:
+     * 1. An explicitly configured `state.guestId` (from config or `setGuestId`) — wins.
+     * 2. A persistent browser ID stored in localStorage (key `oneentry_guest_id`),
+     * stable across sessions and tabs — mirrors the device-metadata strategy.
+     * Once resolved it is cached into `state.guestId` (safe: one browser = one user).
+     * 3. Otherwise `undefined` — the `x-guest-id` header is simply omitted.
+     *
+     * IMPORTANT (server-side): the SDK never invents a guest id on the server.
+     * `defineOneEntry` is typically created once and shared across many visitors,
+     * so a silently-generated server id would be cached into the shared state and
+     * leak one guest cart/wishlist across all anonymous visitors. On the server
+     * you must pass a per-visitor `guestId` (config or `setGuestId`) yourself.
+     * @returns {string | undefined} The guest identifier, or undefined when none is available.
+     */
+    _getGuestId() {
+        if (this.state.guestId)
+            return this.state.guestId;
+        // Browser only: a localStorage-backed id is safe to cache into shared state,
+        // because a single browser maps to a single guest.
+        const browserId = _getPersistentBrowserId(_GUEST_ID_STORAGE_KEY);
+        if (browserId) {
+            this.state.guestId = browserId;
+            return browserId;
+        }
+        // No localStorage and no explicit id (e.g. Node/SSR) — do not invent one.
+        return undefined;
     }
     /**
      * Constructs the full URL path by appending the given path to the base URL.
@@ -622,6 +680,20 @@ class SyncModules {
         this.state.refreshToken = refreshToken;
         return this;
     }
+    /**
+     * Sets the guest identifier in the state.
+     *
+     * Once set, it is sent as the `x-guest-id` header on unauthenticated requests,
+     * enabling guest cart/wishlist/activity flows. Pass an empty string to clear it
+     * (the SDK then falls back to the localStorage-backed id in the browser, or to
+     * no guest id at all on the server).
+     * @param {string} guestId - The guest identifier to set (empty string clears it).
+     * @returns {any} The instance of SyncModules for chaining.
+     */
+    setGuestId(guestId) {
+        this.state.guestId = guestId || undefined;
+        return this;
+    }
     /**
      * Get deviceMetadata
      *
@@ -643,7 +715,7 @@ class SyncModules {
      * 3. Concatenates the hash and the first 12 characters of instanceId.
      *
      * **instanceId strategy:**
-     * - Browser: `_getBrowserDeviceId()` — read from localStorage, stable across sessions.
+     * - Browser: `_getPersistentBrowserId('oneentry_device_id')` — read from localStorage, stable across sessions.
      * - Node.js / no localStorage: `_nodeDeviceId` — generated at instance creation,
      * lives until the process restarts.
      *
@@ -658,7 +730,7 @@ class SyncModules {
         }
         // Access navigator through globalThis.window object to avoid direct reference
         const win = globalThis.window;
-        const instanceId = (_a = _getBrowserDeviceId()) !== null && _a !== void 0 ? _a : this._nodeDeviceId;
+        const instanceId = (_a = _getPersistentBrowserId(_DEVICE_ID_STORAGE_KEY)) !== null && _a !== void 0 ? _a : this._nodeDeviceId;
         // Node.js environment
         if (!win) {
             return JSON.stringify({

package/dist/base/utils.d.ts

@@ -1,6 +1,7 @@
 /**
  * @interface IConfig
  * @property {string} [token] - If your project is protected by a token, specify this token in this parameter.
+ * @property {string} [guestId] - Guest identifier sent as the `x-guest-id` header on unauthenticated requests. Lets cart/wishlist/activity endpoints work for a guest. In the browser a stable id is auto-generated (localStorage) when omitted; on the server pass a per-visitor id. Can also be set later via `setGuestId`.
  * @property {string} [langCode] - specify the default language to avoid specifying it in every request.
  * @property {boolean} [traficLimit] - Some methods use multiple queries to make it easier to work with the API. Set this parameter to "false" to save traffic and decide for yourself what data you need.
  * @property {boolean} [rawData] - Set to true to receive raw API responses without any transformation.
@@ -42,6 +43,7 @@
  */
 interface IConfig {
     token?: string;
+    guestId?: string;
     langCode?: string;
     traficLimit?: boolean;
     rawData?: boolean;
@@ -255,12 +257,13 @@ interface IError {
 /**
  * @interface IHttpHeaders
  * @property {string} [Authorization] - Authorization header.
- * @description Interface for HTTP headers. Supports the standard `Content-Type`, `Authorization`, and OneEntry-specific `x-app-token` / `x-device-metadata` headers, plus arbitrary string entries via the index signature.
+ * @description Interface for HTTP headers. Supports the standard `Content-Type`, `Authorization`, and OneEntry-specific `x-app-token` / `x-device-metadata` / `x-guest-id` (guest cart/wishlist/activity) headers, plus arbitrary string entries via the index signature.
  */
 interface IHttpHeaders {
     'Content-Type'?: string;
     'x-app-token'?: string;
     'x-device-metadata'?: string;
+    'x-guest-id'?: string;
     Authorization?: string;
     [key: string]: string | undefined;
 }

package/dist/blocks/blocksApi.d.ts

@@ -1,8 +1,8 @@
 import AsyncModules from '../base/asyncModules';
 import type StateModule from '../base/stateModule';
 import type { IError } from '../base/utils';
-import type { IProductsResponse } from '../products/productsInterfaces';
-import type { BlockType, IBlockEntity, IBlocks, IBlocksResponse, ISearchBlock } from './blocksInterfaces';
+import type { IProductsEntity, IProductsResponse } from '../products/productsInterfaces';
+import type { BlockType, IBlockEntity, IBlockProductsLookup, IBlocks, IBlockSlidesResponse, IBlocksResponse, ISearchBlock } from './blocksInterfaces';
 /**
  * Controllers for working with blocks.
  * @handle /api/content/blocks
@@ -21,7 +21,7 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
     /**
      * Get blocks by parameters.
      * @handleName getBlocks
-     * @param {BlockType} type - Available values: "product" | "error_page" | "catalog_page" | "product_preview" | "similar_products_block" | "product_block" | "form" | "common_page" | "common_block" | "order" | "service" | "none". 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" | "form" | "common_page" | "common_block" | "order" | "service" | "none". When omitted, blocks of all types are returned. Example: 'product'.
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {number} [offset] - Parameter for pagination. Default: 0.
      * @param {number} [limit] - Parameter for pagination. Default: 30.
@@ -49,6 +49,7 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @param {number} [offset] - Parameter for pagination. Default: 0.
      * @param {number} [limit] - Parameter for pagination. Default: 30.
      * @param {string} [signPrice] - Sign price.
+     * @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
      */
@@ -85,4 +86,124 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @throws {IError} When isShell=false and an error occurs during the fetch
      */
     searchBlock(name: string, langCode?: string): Promise<ISearchBlock[] | IError>;
+    /**
+     * Get "complete your cart" products by the cart from context (auth user or guest).
+     * @handleName getCartComplement
+     * @param {string} marker - Block marker. Example: "cart_complement_block".
+     * @param {string} [langCode] - Language code. Default: "en_US".
+     * @param {string} [signPrice] - Sign price.
+     * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     */
+    getCartComplement(marker: string, langCode?: string, signPrice?: string): Promise<IProductsEntity[] | IError>;
+    /**
+     * Get "complete your cart" products by an explicit list of productIds (POST body).
+     * @handleName getCartComplementByProductIds
+     * @param {string} marker - Block marker. Example: "cart_complement_block".
+     * @param {IBlockProductsLookup} body - Lookup body.
+     * @example
+        {
+          "productIds": [1, 2],
+          "langCode": "en_US"
+        }
+     * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     */
+    getCartComplementByProductIds(marker: string, body: IBlockProductsLookup): Promise<IProductsEntity[] | IError>;
+    /**
+     * Get "similar to cart" products by the cart from context (auth user or guest).
+     * @handleName getCartSimilar
+     * @param {string} marker - Block marker. Example: "cart_similar_block".
+     * @param {string} [langCode] - Language code. Default: "en_US".
+     * @param {string} [signPrice] - Sign price.
+     * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     */
+    getCartSimilar(marker: string, langCode?: string, signPrice?: string): Promise<IProductsEntity[] | IError>;
+    /**
+     * Get "similar to cart" products by an explicit list of productIds (POST body).
+     * @handleName getCartSimilarByProductIds
+     * @param {string} marker - Block marker. Example: "cart_similar_block".
+     * @param {IBlockProductsLookup} body - Lookup body.
+     * @example
+        {
+          "productIds": [1, 2],
+          "langCode": "en_US"
+        }
+     * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     */
+    getCartSimilarByProductIds(marker: string, body: IBlockProductsLookup): Promise<IProductsEntity[] | IError>;
+    /**
+     * Get personal recommendations for the user.
+     * @handleName getPersonalRecommendations
+     * @param {string} marker - Block marker. Example: "personal_recommendations_block".
+     * @param {string} [langCode] - Language code. Default: "en_US".
+     * @param {string} [signPrice] - Sign price.
+     * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     */
+    getPersonalRecommendations(marker: string, langCode?: string, signPrice?: string): Promise<IProductsEntity[] | IError>;
+    /**
+     * Get recently viewed products.
+     * @handleName getRecentlyViewed
+     * @param {string} marker - Block marker. Example: "recently_viewed_block".
+     * @param {string} [langCode] - Language code. Default: "en_US".
+     * @param {string} [signPrice] - Sign price.
+     * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     */
+    getRecentlyViewed(marker: string, langCode?: string, signPrice?: string): Promise<IProductsEntity[] | IError>;
+    /**
+     * Get products for repeat purchase.
+     * @handleName getRepeatPurchase
+     * @param {string} marker - Block marker. Example: "repeat_purchase_block".
+     * @param {string} [langCode] - Language code. Default: "en_US".
+     * @param {string} [signPrice] - Sign price.
+     * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     */
+    getRepeatPurchase(marker: string, langCode?: string, signPrice?: string): Promise<IProductsEntity[] | IError>;
+    /**
+     * Get the block's slides tree as a flat pre-order array (slider_block only).
+     * @handleName getSlides
+     * @param {string} marker - Block marker. Example: "slider_block".
+     * @returns {Promise<IBlockSlidesResponse | IError>} Returns the slides response.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     */
+    getSlides(marker: string): Promise<IBlockSlidesResponse | IError>;
+    /**
+     * Get trending products of the block.
+     * @handleName getTrending
+     * @param {string} marker - Block marker. Example: "trending_block".
+     * @param {string} [langCode] - Language code. Default: "en_US".
+     * @param {string} [signPrice] - Sign price.
+     * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     */
+    getTrending(marker: string, langCode?: string, signPrice?: string): Promise<IProductsEntity[] | IError>;
+    /**
+     * Get "similar to wishlist" products by the wishlist from context (auth user or guest).
+     * @handleName getWishlistSimilar
+     * @param {string} marker - Block marker. Example: "wishlist_similar_block".
+     * @param {string} [langCode] - Language code. Default: "en_US".
+     * @param {string} [signPrice] - Sign price.
+     * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     */
+    getWishlistSimilar(marker: string, langCode?: string, signPrice?: string): Promise<IProductsEntity[] | IError>;
+    /**
+     * Get "similar to wishlist" products by an explicit list of productIds (POST body).
+     * @handleName getWishlistSimilarByProductIds
+     * @param {string} marker - Block marker. Example: "wishlist_similar_block".
+     * @param {IBlockProductsLookup} body - Lookup body.
+     * @example
+        {
+          "productIds": [1, 2],
+          "langCode": "en_US"
+        }
+     * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     */
+    getWishlistSimilarByProductIds(marker: string, body: IBlockProductsLookup): Promise<IProductsEntity[] | IError>;
 }

package/dist/blocks/blocksApi.js

@@ -25,15 +25,18 @@ class BlocksApi extends asyncModules_1.default {
     /**
      * Get blocks by parameters.
      * @handleName getBlocks
-     * @param {BlockType} type - Available values: "product" | "error_page" | "catalog_page" | "product_preview" | "similar_products_block" | "product_block" | "form" | "common_page" | "common_block" | "order" | "service" | "none". 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" | "form" | "common_page" | "common_block" | "order" | "service" | "none". When omitted, blocks of all types are returned. Example: 'product'.
      * @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<IBlocksResponse | IError>} Returns BlocksEntity object.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      */
-    async getBlocks(type = '', langCode = this.state.lang, offset = 0, limit = 30) {
-        const response = await this._fetchPost(`?langCode=${langCode}&type=${type}&offset=${offset}&limit=${limit}`);
+    async getBlocks(type, langCode = this.state.lang, offset = 0, limit = 30) {
+        // type is omitted from the query when not provided — the API rejects an
+        // 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}`);
         // Validate response if validation is enabled
         const validated = this._validateResponse(response, blocksSchemas_1.BlocksResponseSchema);
         if (!this.state.traficLimit) {
@@ -136,15 +139,17 @@ class BlocksApi extends asyncModules_1.default {
      * @param {number} [offset] - Parameter for pagination. Default: 0.
      * @param {number} [limit] - Parameter for pagination. Default: 30.
      * @param {string} [signPrice] - Sign price.
+     * @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
      */
-    async getSimilarProducts(marker, langCode = this.state.lang, offset = 0, limit = 30, signPrice) {
+    async getSimilarProducts(marker, langCode = this.state.lang, offset = 0, limit = 30, signPrice, productId) {
         const query = {
             langCode,
             offset,
             limit,
             signPrice,
+            productId,
         };
         const result = await this._fetchGet(`/${marker}/similar-products?` + this._queryParamsToString(query));
         return this._normalizeData(result);
@@ -203,5 +208,165 @@ class BlocksApi extends asyncModules_1.default {
         const validated = this._validateResponse(result, blocksSchemas_1.SearchBlocksResponseSchema);
         return validated;
     }
+    /**
+     * Get "complete your cart" products by the cart from context (auth user or guest).
+     * @handleName getCartComplement
+     * @param {string} marker - Block marker. Example: "cart_complement_block".
+     * @param {string} [langCode] - Language code. Default: "en_US".
+     * @param {string} [signPrice] - Sign price.
+     * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     */
+    async getCartComplement(marker, langCode = this.state.lang, signPrice) {
+        const query = { langCode, signPrice };
+        const data = await this._fetchGet(`/${marker}/cart-complement?` + this._queryParamsToString(query));
+        return this._normalizeData(data);
+    }
+    /**
+     * Get "complete your cart" products by an explicit list of productIds (POST body).
+     * @handleName getCartComplementByProductIds
+     * @param {string} marker - Block marker. Example: "cart_complement_block".
+     * @param {IBlockProductsLookup} body - Lookup body.
+     * @example
+        {
+          "productIds": [1, 2],
+          "langCode": "en_US"
+        }
+     * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     */
+    async getCartComplementByProductIds(marker, body) {
+        const data = await this._fetchPost(`/${marker}/cart-complement`, { langCode: this.state.lang, ...body });
+        return this._normalizeData(data);
+    }
+    /**
+     * Get "similar to cart" products by the cart from context (auth user or guest).
+     * @handleName getCartSimilar
+     * @param {string} marker - Block marker. Example: "cart_similar_block".
+     * @param {string} [langCode] - Language code. Default: "en_US".
+     * @param {string} [signPrice] - Sign price.
+     * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     */
+    async getCartSimilar(marker, langCode = this.state.lang, signPrice) {
+        const query = { langCode, signPrice };
+        const data = await this._fetchGet(`/${marker}/cart-similar?` + this._queryParamsToString(query));
+        return this._normalizeData(data);
+    }
+    /**
+     * Get "similar to cart" products by an explicit list of productIds (POST body).
+     * @handleName getCartSimilarByProductIds
+     * @param {string} marker - Block marker. Example: "cart_similar_block".
+     * @param {IBlockProductsLookup} body - Lookup body.
+     * @example
+        {
+          "productIds": [1, 2],
+          "langCode": "en_US"
+        }
+     * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     */
+    async getCartSimilarByProductIds(marker, body) {
+        const data = await this._fetchPost(`/${marker}/cart-similar`, { langCode: this.state.lang, ...body });
+        return this._normalizeData(data);
+    }
+    /**
+     * Get personal recommendations for the user.
+     * @handleName getPersonalRecommendations
+     * @param {string} marker - Block marker. Example: "personal_recommendations_block".
+     * @param {string} [langCode] - Language code. Default: "en_US".
+     * @param {string} [signPrice] - Sign price.
+     * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     */
+    async getPersonalRecommendations(marker, langCode = this.state.lang, signPrice) {
+        const query = { langCode, signPrice };
+        const data = await this._fetchGet(`/${marker}/personal-recommendations?` + this._queryParamsToString(query));
+        return this._normalizeData(data);
+    }
+    /**
+     * Get recently viewed products.
+     * @handleName getRecentlyViewed
+     * @param {string} marker - Block marker. Example: "recently_viewed_block".
+     * @param {string} [langCode] - Language code. Default: "en_US".
+     * @param {string} [signPrice] - Sign price.
+     * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     */
+    async getRecentlyViewed(marker, langCode = this.state.lang, signPrice) {
+        const query = { langCode, signPrice };
+        const data = await this._fetchGet(`/${marker}/recently-viewed?` + this._queryParamsToString(query));
+        return this._normalizeData(data);
+    }
+    /**
+     * Get products for repeat purchase.
+     * @handleName getRepeatPurchase
+     * @param {string} marker - Block marker. Example: "repeat_purchase_block".
+     * @param {string} [langCode] - Language code. Default: "en_US".
+     * @param {string} [signPrice] - Sign price.
+     * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     */
+    async getRepeatPurchase(marker, langCode = this.state.lang, signPrice) {
+        const query = { langCode, signPrice };
+        const data = await this._fetchGet(`/${marker}/repeat-purchase?` + this._queryParamsToString(query));
+        return this._normalizeData(data);
+    }
+    /**
+     * Get the block's slides tree as a flat pre-order array (slider_block only).
+     * @handleName getSlides
+     * @param {string} marker - Block marker. Example: "slider_block".
+     * @returns {Promise<IBlockSlidesResponse | IError>} Returns the slides response.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     */
+    async getSlides(marker) {
+        const data = await this._fetchGet(`/${marker}/slides`);
+        return this._normalizeData(data);
+    }
+    /**
+     * Get trending products of the block.
+     * @handleName getTrending
+     * @param {string} marker - Block marker. Example: "trending_block".
+     * @param {string} [langCode] - Language code. Default: "en_US".
+     * @param {string} [signPrice] - Sign price.
+     * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     */
+    async getTrending(marker, langCode = this.state.lang, signPrice) {
+        const query = { langCode, signPrice };
+        const data = await this._fetchGet(`/${marker}/trending?` + this._queryParamsToString(query));
+        return this._normalizeData(data);
+    }
+    /**
+     * Get "similar to wishlist" products by the wishlist from context (auth user or guest).
+     * @handleName getWishlistSimilar
+     * @param {string} marker - Block marker. Example: "wishlist_similar_block".
+     * @param {string} [langCode] - Language code. Default: "en_US".
+     * @param {string} [signPrice] - Sign price.
+     * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     */
+    async getWishlistSimilar(marker, langCode = this.state.lang, signPrice) {
+        const query = { langCode, signPrice };
+        const data = await this._fetchGet(`/${marker}/wishlist-similar?` + this._queryParamsToString(query));
+        return this._normalizeData(data);
+    }
+    /**
+     * Get "similar to wishlist" products by an explicit list of productIds (POST body).
+     * @handleName getWishlistSimilarByProductIds
+     * @param {string} marker - Block marker. Example: "wishlist_similar_block".
+     * @param {IBlockProductsLookup} body - Lookup body.
+     * @example
+        {
+          "productIds": [1, 2],
+          "langCode": "en_US"
+        }
+     * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     */
+    async getWishlistSimilarByProductIds(marker, body) {
+        const data = await this._fetchPost(`/${marker}/wishlist-similar`, { langCode: this.state.lang, ...body });
+        return this._normalizeData(data);
+    }
 }
 exports.default = BlocksApi;