oneentry 1.0.151 → 1.0.153

package/dist/orders/ordersApi.d.ts

@@ -28,6 +28,7 @@ export default class OrdersApi extends AsyncModules implements IOrdersApi {
      * @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/orders/getAllOrdersStorage getAllOrdersStorage} documentation.
      */
     getAllOrdersStorage(langCode?: string, offset?: number, limit?: number): Promise<IOrdersEntity[] | IError>;
     /**
@@ -41,6 +42,7 @@ export default class OrdersApi extends AsyncModules implements IOrdersApi {
      * @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/orders/getAllOrdersByMarker getAllOrdersByMarker} documentation.
      */
     getAllOrdersByMarker(marker: string, langCode?: string, offset?: number, limit?: number): Promise<IOrdersByMarkerEntity | IError>;
     /**
@@ -52,6 +54,7 @@ export default class OrdersApi extends AsyncModules implements IOrdersApi {
      * @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/orders/getOrdersStorageByMarker getOrdersStorageByMarker} documentation.
      */
     getOrdersStorageByMarker(marker: string, langCode?: string): Promise<IOrdersEntity | IError>;
     /**
@@ -64,6 +67,7 @@ export default class OrdersApi extends AsyncModules implements IOrdersApi {
      * @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/orders/getOrderByMarkerAndId getOrderByMarkerAndId} documentation.
      */
     getOrderByMarkerAndId(marker: string, id: number, langCode?: string): Promise<IOrderByMarkerEntity | IError>;
     /**
@@ -73,8 +77,9 @@ export default class OrdersApi extends AsyncModules implements IOrdersApi {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @returns {Promise<IOrderPreviewResponse | IError>} Returns an object with the order preview.
      * @throws {IError} When isShell=false and an error occurs during the fetch
-     * @description This method requires user authorization ???.
+     * @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/orders/previewOrder previewOrder} documentation.
      */
     previewOrder(body: ICreateOrderPreview, langCode?: string): Promise<IOrderPreviewResponse | IError>;
     /**
@@ -103,6 +108,7 @@ export default class OrdersApi extends AsyncModules implements IOrdersApi {
      * @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/orders/createOrder createOrder} documentation.
      */
     createOrder(marker: string, body: IOrderData, langCode?: string): Promise<IBaseOrdersEntity | IError>;
     /**
@@ -133,6 +139,7 @@ export default class OrdersApi extends AsyncModules implements IOrdersApi {
      * @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/orders/updateOrderByMarkerAndId updateOrderByMarkerAndId} documentation.
      */
     updateOrderByMarkerAndId(marker: string, id: number, body: IOrderData, langCode?: string): Promise<IBaseOrdersEntity | IError>;
     /**
@@ -145,6 +152,7 @@ export default class OrdersApi extends AsyncModules implements IOrdersApi {
      * @returns {Promise<IOrderStatus[] | IError>} Returns an object with the orders statuses.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @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/orders/getAllStatusesByStorageMarker getAllStatusesByStorageMarker} documentation.
      */
     getAllStatusesByStorageMarker(marker: string, langCode?: string, offset?: number, limit?: number): Promise<IOrderStatus[] | IError>;
     /**
@@ -153,6 +161,7 @@ export default class OrdersApi extends AsyncModules implements IOrdersApi {
      * @param {number} id - Order id. Example: 1.
      * @returns {Promise<IRefundRequest[] | IError>} Returns array of refund requests.
      * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @see {@link https://js-sdk.oneentry.cloud/docs/orders/getRefunds getRefunds} documentation.
      */
     getRefunds(id: number): Promise<IRefundRequest[] | IError>;
     /**
@@ -162,6 +171,7 @@ export default class OrdersApi extends AsyncModules implements IOrdersApi {
      * @param {ICreateRefundRequest} body - Refund request body.
      * @returns {Promise<boolean | IError>} Returns true if the refund request was created successfully.
      * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @see {@link https://js-sdk.oneentry.cloud/docs/orders/createRefundRequest createRefundRequest} documentation.
      */
     createRefundRequest(id: number, body: ICreateRefundRequest): Promise<boolean | IError>;
     /**
@@ -170,6 +180,20 @@ export default class OrdersApi extends AsyncModules implements IOrdersApi {
      * @param {number} id - Order id. Example: 1.
      * @returns {Promise<boolean | IError>} Returns true if the refund request was cancelled successfully.
      * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @see {@link https://js-sdk.oneentry.cloud/docs/orders/cancelRefundRequest cancelRefundRequest} documentation.
      */
     cancelRefundRequest(id: number): Promise<boolean | IError>;
+    /**
+     * Runs a fetch against the `/orders` base URL instead of the default
+     * `/orders-storage`, then restores the original URL.
+     *
+     * Refund endpoints live under `/api/content/orders`, while this class is based
+     * on `/api/content/orders-storage`. The helper swaps `_url` for the duration of
+     * the call and restores it in `finally`, so the base URL is restored even if
+     * the request throws.
+     * @param {() => Promise<T>} fetcher - Thunk performing the fetch call.
+     * @returns {Promise<T>} The fetcher result.
+     * @template T
+     */
+    private _withOrdersUrl;
 }

package/dist/orders/ordersApi.js

@@ -32,6 +32,7 @@ class OrdersApi extends asyncModules_1.default {
      * @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/orders/getAllOrdersStorage getAllOrdersStorage} documentation.
      */
     async getAllOrdersStorage(langCode = this.state.lang, offset = 0, limit = 30) {
         const result = await this._fetchGet(`?langCode=${langCode}&limit=${limit}&offset=${offset}`);
@@ -48,6 +49,7 @@ class OrdersApi extends asyncModules_1.default {
      * @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/orders/getAllOrdersByMarker getAllOrdersByMarker} documentation.
      */
     async getAllOrdersByMarker(marker, langCode = this.state.lang, offset = 0, limit = 30) {
         const result = await this._fetchGet(`/marker/${marker}/orders?langCode=${langCode}&limit=${limit}&offset=${offset}`);
@@ -64,6 +66,7 @@ class OrdersApi extends asyncModules_1.default {
      * @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/orders/getOrdersStorageByMarker getOrdersStorageByMarker} documentation.
      */
     async getOrdersStorageByMarker(marker, langCode = this.state.lang) {
         const result = await this._fetchGet(`/marker/${marker}?langCode=${langCode}`);
@@ -79,6 +82,7 @@ class OrdersApi extends asyncModules_1.default {
      * @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/orders/getOrderByMarkerAndId getOrderByMarkerAndId} documentation.
      */
     async getOrderByMarkerAndId(marker, id, langCode = this.state.lang) {
         const result = await this._fetchGet(`/marker/${marker}/orders/${id}?langCode=${langCode}`);
@@ -93,8 +97,9 @@ class OrdersApi extends asyncModules_1.default {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @returns {Promise<IOrderPreviewResponse | IError>} Returns an object with the order preview.
      * @throws {IError} When isShell=false and an error occurs during the fetch
-     * @description This method requires user authorization ???.
+     * @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/orders/previewOrder previewOrder} documentation.
      */
     async previewOrder(body, langCode = this.state.lang) {
         const result = await this._fetchPost(`/orders/preview?langCode=${langCode}`, body);
@@ -126,6 +131,7 @@ class OrdersApi extends asyncModules_1.default {
      * @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/orders/createOrder createOrder} documentation.
      */
     async createOrder(marker, body, langCode = this.state.lang) {
         // eslint-disable-next-line @typescript-eslint/no-explicit-any
@@ -167,6 +173,7 @@ class OrdersApi extends asyncModules_1.default {
      * @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/orders/updateOrderByMarkerAndId updateOrderByMarkerAndId} documentation.
      */
     async updateOrderByMarkerAndId(marker, id, body, langCode = this.state.lang) {
         // eslint-disable-next-line @typescript-eslint/no-explicit-any
@@ -190,6 +197,7 @@ class OrdersApi extends asyncModules_1.default {
      * @returns {Promise<IOrderStatus[] | IError>} Returns an object with the orders statuses.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @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/orders/getAllStatusesByStorageMarker getAllStatusesByStorageMarker} documentation.
      */
     async getAllStatusesByStorageMarker(marker, langCode = this.state.lang, offset = 0, limit = 30) {
         const query = {
@@ -206,12 +214,10 @@ class OrdersApi extends asyncModules_1.default {
      * @param {number} id - Order id. Example: 1.
      * @returns {Promise<IRefundRequest[] | IError>} Returns array of refund requests.
      * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @see {@link https://js-sdk.oneentry.cloud/docs/orders/getRefunds getRefunds} documentation.
      */
     async getRefunds(id) {
-        const savedUrl = this._url;
-        this._url = this._ordersUrl;
-        const data = await this._fetchGet(`/${id}/refund`);
-        this._url = savedUrl;
+        const data = await this._withOrdersUrl(() => this._fetchGet(`/${id}/refund`));
         return this._normalizeData(data);
     }
     /**
@@ -221,12 +227,10 @@ class OrdersApi extends asyncModules_1.default {
      * @param {ICreateRefundRequest} body - Refund request body.
      * @returns {Promise<boolean | IError>} Returns true if the refund request was created successfully.
      * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @see {@link https://js-sdk.oneentry.cloud/docs/orders/createRefundRequest createRefundRequest} documentation.
      */
     async createRefundRequest(id, body) {
-        const savedUrl = this._url;
-        this._url = this._ordersUrl;
-        const data = await this._fetchPost(`/${id}/refund`, body);
-        this._url = savedUrl;
+        const data = await this._withOrdersUrl(() => this._fetchPost(`/${id}/refund`, body));
         return this._normalizeData(data);
     }
     /**
@@ -235,13 +239,33 @@ class OrdersApi extends asyncModules_1.default {
      * @param {number} id - Order id. Example: 1.
      * @returns {Promise<boolean | IError>} Returns true if the refund request was cancelled successfully.
      * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @see {@link https://js-sdk.oneentry.cloud/docs/orders/cancelRefundRequest cancelRefundRequest} documentation.
      */
     async cancelRefundRequest(id) {
+        const data = await this._withOrdersUrl(() => this._fetchDelete(`/${id}/refund`));
+        return this._normalizeData(data);
+    }
+    /**
+     * Runs a fetch against the `/orders` base URL instead of the default
+     * `/orders-storage`, then restores the original URL.
+     *
+     * Refund endpoints live under `/api/content/orders`, while this class is based
+     * on `/api/content/orders-storage`. The helper swaps `_url` for the duration of
+     * the call and restores it in `finally`, so the base URL is restored even if
+     * the request throws.
+     * @param {() => Promise<T>} fetcher - Thunk performing the fetch call.
+     * @returns {Promise<T>} The fetcher result.
+     * @template T
+     */
+    async _withOrdersUrl(fetcher) {
         const savedUrl = this._url;
         this._url = this._ordersUrl;
-        const data = await this._fetchDelete(`/${id}/refund`);
-        this._url = savedUrl;
-        return this._normalizeData(data);
+        try {
+            return await fetcher();
+        }
+        finally {
+            this._url = savedUrl;
+        }
     }
 }
 exports.default = OrdersApi;

package/dist/orders/ordersInterfaces.d.ts

@@ -266,11 +266,13 @@ interface IOrdersFormData {
  * @interface IOrderProductData
  * @property {number} productId - Product identifier. Example: 1.
  * @property {number} quantity - Quantity of the product. Example: 2.
+ * @property {string} [signedPrice] - The signed price of the product is obtained along with the product data when `signPrice` is set. Example: "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...".
  * @description Represents a product data in an order.
  */
 interface IOrderProductData {
     productId: number;
     quantity: number;
+    signedPrice?: string;
 }
 /**
  * Interface representing product data in an order.
@@ -311,7 +313,7 @@ interface IOrderProductsData {
       }
     ]
  * @property {string} currency - Currency used to pay for the order. Example: "USD".
- * @property {number} totalSum - Total order amount. Example: "150".
+ * @property {string} 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 {string} [couponCode] -
@@ -328,7 +330,7 @@ interface IBaseOrdersEntity {
     formData: IOrdersFormData[];
     products: IOrderProductsData[];
     currency: string;
-    totalSum: number;
+    totalSum: string;
     createdDate?: string;
     statusIdentifier?: string;
     couponCode?: string;

package/dist/pages/pagesApi.d.ts

@@ -23,6 +23,7 @@ export default class PagesApi extends AsyncModules implements IPagesApi {
      * @returns {Promise<IPagesEntity[] | IError>} Returns all created pages without parents as an array of PageEntity objects or an empty array [] (if there is no data)
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Get all top-level page objects.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/pages/getRootPages getRootPages} documentation.
      */
     getRootPages(langCode?: string): Promise<IPagesEntity[] | IError>;
     /**
@@ -32,6 +33,7 @@ export default class PagesApi extends AsyncModules implements IPagesApi {
      * @returns {Promise<IPagesEntity[] | IError>} Returns all created pages as an array of PageEntity objects or an empty array [] (if there is no data).
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Get all page objects with product information as an array.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/pages/getPages getPages} documentation.
      */
     getPages(langCode?: string): Promise<IPagesEntity[] | IError>;
     /**
@@ -42,6 +44,7 @@ export default class PagesApi extends AsyncModules implements IPagesApi {
      * @returns {Promise<IPagesEntity | IError>} Returns PageEntity object
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Get page object with information about forms, blocks, menus, linked to the page.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/pages/getPageById getPageById} documentation.
      */
     getPageById(id: number, langCode?: string): Promise<IPagesEntity | IError>;
     /**
@@ -52,6 +55,7 @@ export default class PagesApi extends AsyncModules implements IPagesApi {
      * @returns {Promise<IPagesEntity | IError>} Returns PageEntity object
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Get page object with information about forms, blocks, menus, linked to the page by URL.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/pages/getPageByUrl getPageByUrl} documentation.
      */
     getPageByUrl(url: string, langCode?: string): Promise<IPagesEntity | IError>;
     /**
@@ -62,6 +66,7 @@ export default class PagesApi extends AsyncModules implements IPagesApi {
      * @returns {Promise<IPagesEntity | IError>} Returns all created pages as an array of PageEntity objects or an empty array [] (if there is no data) for the selected parent
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Get child pages object with information as an array.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/pages/getChildPagesByParentUrl getChildPagesByParentUrl} documentation.
      */
     getChildPagesByParentUrl(url: string, langCode?: string): Promise<IPagesEntity[] | IError>;
     /**
@@ -72,6 +77,7 @@ export default class PagesApi extends AsyncModules implements IPagesApi {
      * @returns {Promise<IPositionBlock[] | IError>} Returns all blocks as an array of PositionBlock objects or an empty array [] (if there is no data) for the selected parent
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Get all blocks by page url.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/pages/getBlocksByPageUrl getBlocksByPageUrl} documentation.
      */
     getBlocksByPageUrl(url: string, langCode?: string): Promise<IPositionBlock[] | IError>;
     /**
@@ -81,6 +87,7 @@ export default class PagesApi extends AsyncModules implements IPagesApi {
      * @returns {Promise<IPageConfig | IError>} Returns a ConfigPage object with page display settings
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Get settings for the page.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/pages/getConfigPageByUrl getConfigPageByUrl} documentation.
      */
     getConfigPageByUrl(url: string): Promise<IPageConfig | IError>;
     /**
@@ -92,6 +99,7 @@ export default class PagesApi extends AsyncModules implements IPagesApi {
      * @returns {Promise<IPagesEntity[] | IError>} Returns all created pages as an array of PageEntity objects or an empty array [] (if there is no data)
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Quick search for page objects with limited output.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/pages/searchPage searchPage} documentation.
      */
     searchPage(name: string, url?: string, langCode?: string): Promise<IPagesEntity[] | IError>;
     /**
@@ -146,6 +154,7 @@ export default class PagesApi extends AsyncModules implements IPagesApi {
      * @returns {Promise<any | IError>} An array of page objects with template data added
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Add template data to page by page templateIdentifier
+     * @see {@link https://js-sdk.oneentry.cloud/docs/pages/addTemplateToPage addTemplateToPage} documentation.
      */
     protected addTemplateToPage(data: IPagesEntity): Promise<any | IError>;
 }

package/dist/pages/pagesApi.js

@@ -30,6 +30,7 @@ class PagesApi extends asyncModules_1.default {
      * @returns {Promise<IPagesEntity[] | IError>} Returns all created pages without parents as an array of PageEntity objects or an empty array [] (if there is no data)
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Get all top-level page objects.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/pages/getRootPages getRootPages} documentation.
      */
     async getRootPages(langCode = this.state.lang) {
         // Fetch data from the server using a GET request to retrieve root pages for the specified language code
@@ -48,6 +49,7 @@ class PagesApi extends asyncModules_1.default {
      * @returns {Promise<IPagesEntity[] | IError>} Returns all created pages as an array of PageEntity objects or an empty array [] (if there is no data).
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Get all page objects with product information as an array.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/pages/getPages getPages} documentation.
      */
     async getPages(langCode = this.state.lang) {
         // Fetch data from the server using a GET request to retrieve all pages for the specified language code
@@ -67,6 +69,7 @@ class PagesApi extends asyncModules_1.default {
      * @returns {Promise<IPagesEntity | IError>} Returns PageEntity object
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Get page object with information about forms, blocks, menus, linked to the page.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/pages/getPageById getPageById} documentation.
      */
     async getPageById(id, langCode = this.state.lang) {
         // Fetch data from the server using a GET request to retrieve page details by ID and language code
@@ -86,6 +89,7 @@ class PagesApi extends asyncModules_1.default {
      * @returns {Promise<IPagesEntity | IError>} Returns PageEntity object
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Get page object with information about forms, blocks, menus, linked to the page by URL.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/pages/getPageByUrl getPageByUrl} documentation.
      */
     async getPageByUrl(url, langCode = this.state.lang) {
         // Fetch data from the server using a GET request with the specified URL and language code
@@ -105,6 +109,7 @@ class PagesApi extends asyncModules_1.default {
      * @returns {Promise<IPagesEntity | IError>} Returns all created pages as an array of PageEntity objects or an empty array [] (if there is no data) for the selected parent
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Get child pages object with information as an array.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/pages/getChildPagesByParentUrl getChildPagesByParentUrl} documentation.
      */
     async getChildPagesByParentUrl(url, langCode = this.state.lang) {
         // Fetch data from the server using a GET request to retrieve child pages for the specified parent URL and language code
@@ -124,66 +129,54 @@ class PagesApi extends asyncModules_1.default {
      * @returns {Promise<IPositionBlock[] | IError>} Returns all blocks as an array of PositionBlock objects or an empty array [] (if there is no data) for the selected parent
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Get all blocks by page url.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/pages/getBlocksByPageUrl getBlocksByPageUrl} documentation.
      */
     async getBlocksByPageUrl(url, langCode = this.state.lang) {
         const response = await this._fetchGet(`/${url}/blocks?langCode=${langCode}`);
         // Normalize the fetched response data
         const normalizeResponse = this._normalizeData(response);
-        // Iterate over each item in the normalized response
-        normalizeResponse.map((item) => {
+        if (!Array.isArray(normalizeResponse)) {
+            return normalizeResponse;
+        }
+        // Helper module wrapping the block product endpoints (similar / products).
+        const staffModule = new StaffModule(this.state);
+        // Enrich every block in parallel: product / similar blocks
+        await Promise.all(normalizeResponse.map(async (item) => {
             const customSettings = item.customSettings;
-            // Check if customSettings contains 'productConfig' property
+            // Lift product display settings (stored as strings) to numeric top-level fields.
             if (customSettings &&
                 Object.prototype.hasOwnProperty.call(customSettings, 'productConfig')) {
-                // If 'countElementsPerRow' exists, set it on the item
                 if (customSettings.productConfig.countElementsPerRow)
                     item.countElementsPerRow =
                         +customSettings.productConfig.countElementsPerRow;
-                // If 'quantity' exists, set it on the item
                 if (customSettings.productConfig.quantity)
                     item.quantity = +customSettings.productConfig.quantity;
             }
-            // Remove unnecessary properties from the item
+            // Remove internal-only properties from the result.
             delete item.customSettings;
             delete item.attributesSetIdentifier;
-            // Return the modified item
-            return item;
-        });
-        // Check if traffic limit is not set
-        if (!this.state.traficLimit) {
-            // Create an instance of 'StaffModule' with the current state
-            const staffModule = new StaffModule(this.state);
-            // If the block type is 'similar_products_block', fetch similar products
-            if (normalizeResponse.type === 'similar_products_block') {
+            // In traffic-saving mode skip the extra product requests.
+            if (this.state.traficLimit)
+                return;
+            // Attach related products by block type. StaffModule already normalizes its results.
+            if (item.type === 'similar_products_block') {
                 try {
-                    await staffModule
-                        .getSimilarProducts(normalizeResponse.identifier, langCode)
-                        .then((result) => {
-                        normalizeResponse.similarProducts = this._normalizeData(result);
-                    });
+                    item.similarProducts = await staffModule.getSimilarProducts(item.identifier, langCode);
                 }
                 catch {
-                    // Handle errors by setting an empty array
-                    normalizeResponse.similarProducts = [];
+                    item.similarProducts = [];
                 }
-                // If the block type is 'product_block', fetch products
             }
-            else if (normalizeResponse.type === 'product_block') {
+            else if (item.type === 'product_block') {
                 try {
-                    await staffModule
-                        .getProductsByBlockMarker(normalizeResponse.identifier, langCode)
-                        .then((result) => {
-                        normalizeResponse.products = this._normalizeData(result);
-                    });
+                    item.products = await staffModule.getProductsByBlockMarker(item.identifier, langCode);
                 }
                 catch {
-                    // Handle errors by setting an empty array
-                    normalizeResponse.products = [];
+                    item.products = [];
                 }
             }
-        }
-        // Return the final normalized response
-        return this._normalizeData(normalizeResponse);
+        }));
+        return normalizeResponse;
     }
     /**
      * Get settings for the page.
@@ -192,6 +185,7 @@ class PagesApi extends asyncModules_1.default {
      * @returns {Promise<IPageConfig | IError>} Returns a ConfigPage object with page display settings
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Get settings for the page.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/pages/getConfigPageByUrl getConfigPageByUrl} documentation.
      */
     async getConfigPageByUrl(url) {
         // Fetch data from the server using a GET request to retrieve forms for the specified page URL and language code
@@ -210,6 +204,7 @@ class PagesApi extends asyncModules_1.default {
      * @returns {Promise<IPagesEntity[] | IError>} Returns all created pages as an array of PageEntity objects or an empty array [] (if there is no data)
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Quick search for page objects with limited output.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/pages/searchPage searchPage} documentation.
      */
     async searchPage(name, url, langCode = this.state.lang) {
         // Fetch data from the server using a GET request to perform a quick search by page name and language code
@@ -332,6 +327,7 @@ class PagesApi extends asyncModules_1.default {
      * @returns {Promise<any | IError>} An array of page objects with template data added
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Add template data to page by page templateIdentifier
+     * @see {@link https://js-sdk.oneentry.cloud/docs/pages/addTemplateToPage addTemplateToPage} documentation.
      */
     async addTemplateToPage(data) {
         // Check if 'templateIdentifier' exists in 'data' and is not null or an empty string
@@ -352,10 +348,8 @@ class PagesApi extends asyncModules_1.default {
                 };
             }
             catch (error) {
-                // Log any errors that occur during the template fetching process
                 // eslint-disable-next-line no-undef, no-console
                 console.error('Template fetch error: ', error);
-                // Return the original data object unchanged if an error occurs
                 return data;
             }
         }
@@ -375,11 +369,12 @@ class StaffModule extends asyncModules_1.default {
         super(state); // Call parent constructor
         this._url = state.url + '/api/content/blocks'; // Set URL for content blocks
     }
-    // Method to fetch similar products by marker
+    // Method to fetch similar products by marker. Returns the full response
+    // ({ total, items }) to match BlocksApi's similarProducts contract.
     async getSimilarProducts(marker, langCode = this.state.lang, offset = 0, limit = 30) {
         // Fetch similar products from the server
         const result = await this._fetchGet(`/${marker}/similar-products?langCode=${langCode}&offset=${offset}&limit=${limit}`);
-        return this._normalizeData(result.items);
+        return this._normalizeData(result);
     }
     // Method to fetch products by block marker
     async getProductsByBlockMarker(marker, langCode = this.state.lang, offset = 0, limit = 30) {

package/dist/pages/pagesInterfaces.d.ts

@@ -1,6 +1,7 @@
 import type { IAttributes, IAttributeValues, IError, ILocalizeInfo, IRating, LangType } from '../base/utils';
 import type { BlockType, IBlockEntity } from '../blocks/blocksInterfaces';
 import type { IFormConfig } from '../forms/formsInterfaces';
+import type { IProductsEntity, IProductsResponse } from '../products/productsInterfaces';
 import type { ITemplateEntity } from '../templates/templatesInterfaces';
 /**
  * @interface IPagesApi
@@ -185,6 +186,8 @@ interface IPositionForm {
     }
  * @property {number} [countElementsPerRow] - Number of elements displayed per row in the block, if applicable. Example: 3.
  * @property {number} [quantity] - Quantity pages in block. Example: 1.
+ * @property {IProductsResponse} [similarProducts] - Similar products response (total + items). Present only for "similar_products_block" blocks and only when traffic-saving mode is off.
+ * @property {IProductsEntity[]} [products] - Array of products associated with the block. Present only for "product_block" blocks and only when traffic-saving mode is off.
  * @description This interface defines the structure of a position block entity, including its identifiers, attributes, and visibility.
  */
 interface IPositionBlock {
@@ -201,6 +204,8 @@ interface IPositionBlock {
     attributeValues: IAttributeValues;
     countElementsPerRow?: number;
     quantity?: number;
+    similarProducts?: IProductsResponse;
+    products?: IProductsEntity[];
 }
 /**
  * PageType

package/dist/payments/paymentsApi.d.ts

@@ -25,6 +25,7 @@ export default class PaymentsApi extends AsyncModules implements IPaymentsApi {
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description This method gets list of payment sessions. 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/payments/getSessions getSessions} documentation.
      */
     getSessions(offset?: number, limit?: number): Promise<ISessionsEntity | IError>;
     /**
@@ -35,6 +36,7 @@ export default class PaymentsApi extends AsyncModules implements IPaymentsApi {
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description This method gets a single payment session object by its identifier. 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/payments/getSessionById getSessionById} documentation.
      */
     getSessionById(id: number): Promise<ISessionEntity | IError>;
     /**
@@ -45,6 +47,7 @@ export default class PaymentsApi extends AsyncModules implements IPaymentsApi {
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description This method gets one payment session object by order identifier. 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/payments/getSessionByOrderId getSessionByOrderId} documentation.
      */
     getSessionByOrderId(id: number): Promise<ISessionEntity | ISessionEntity[] | IError>;
     /**
@@ -57,6 +60,7 @@ export default class PaymentsApi extends AsyncModules implements IPaymentsApi {
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description This method creates a payment session. 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/payments/createSession createSession} documentation.
      */
     createSession(orderId: number, type: 'session' | 'intent', automaticTaxEnabled?: boolean): Promise<ISessionEntity | IError>;
     /**
@@ -66,6 +70,7 @@ export default class PaymentsApi extends AsyncModules implements IPaymentsApi {
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description This method gets all payment accounts as an array. 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/payments/getAccounts getAccounts} documentation.
      */
     getAccounts(): Promise<IAccountsEntity[] | IError>;
     /**
@@ -77,6 +82,7 @@ export default class PaymentsApi extends AsyncModules implements IPaymentsApi {
      * @description Get a single payment account object by its identifier.
      * @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/payments/getAccountById getAccountById} documentation.
      */
     getAccountById(id: number): Promise<IAccountsEntity | IError>;
 }