oneentry 1.0.152 → 1.0.154

package/dist/integration-collections/integrationCollectionsApi.js

@@ -44,6 +44,7 @@ class IntegrationCollectionsApi extends asyncModules_1.default {
      * @param {string} [userQuery.entityType] - Entity type. Example: "orders".
      * @param {number} [userQuery.entityId] - Entity identifier. Example: 1.
      * @returns {Promise<ICollectionEntity[] | IError>} Returns an array of ICollection objects or an error object if there was an issue.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/integration-collections/getICollections getICollections} documentation.
      */
     async getICollections(langCode = this.state.lang, userQuery) {
         // eslint-disable-next-line @typescript-eslint/no-explicit-any
@@ -60,6 +61,7 @@ class IntegrationCollectionsApi extends asyncModules_1.default {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @returns {Promise<ICollectionEntity | IError>} Returns an ICollection object or an error object if there was an issue.
      * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @see {@link https://js-sdk.oneentry.cloud/docs/integration-collections/getICollectionById getICollectionById} documentation.
      */
     async getICollectionById(id, langCode = this.state.lang) {
         const result = await this._fetchGet(`/${id}?` + this._queryParamsToString({ langCode }));
@@ -82,11 +84,12 @@ class IntegrationCollectionsApi extends asyncModules_1.default {
         }
      * @param {number} [userQuery.limit] - Optional parameter for pagination. Default: 0.
      * @param {number} [userQuery.offset] - Optional parameter for pagination. Default: 30.
-     * @param {number} [userQuery.entityType] - Entity type. Example: "orders".
+     * @param {string} [userQuery.entityType] - Entity type. Example: "orders".
      * @param {number} [userQuery.entityId] - Entity identifier. Example: 1.
      * @returns {Promise<ICollectionRowsResponce | IError>} Returns object ItemsWithTotal, where items is an array of requested objects.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Get all records belonging to the collection by collection id.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/integration-collections/getICollectionRowsById getICollectionRowsById} documentation.
      */
     async getICollectionRowsById(id, langCode = this.state.lang, userQuery) {
         const result = await this._fetchGet(`/${id}/rows?` +
@@ -110,6 +113,7 @@ class IntegrationCollectionsApi extends asyncModules_1.default {
         }
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Check for the existence of a text identifier (marker).
+     * @see {@link https://js-sdk.oneentry.cloud/docs/integration-collections/validateICollectionMarker validateICollectionMarker} documentation.
      */
     async validateICollectionMarker(marker) {
         const result = await this._fetchGet(`/marker-validation/${marker}`);
@@ -124,6 +128,7 @@ class IntegrationCollectionsApi extends asyncModules_1.default {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @returns {Promise<ICollectionRowsResponce | IError>} Returns CollectionRowEntity object.
      * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @see {@link https://js-sdk.oneentry.cloud/docs/integration-collections/getICollectionRowsByMarker getICollectionRowsByMarker} documentation.
      */
     async getICollectionRowsByMarker(marker, langCode = this.state.lang) {
         const result = await this._fetchGet(`/marker/${marker}/rows?langCode=${langCode}`);
@@ -139,6 +144,7 @@ class IntegrationCollectionsApi extends asyncModules_1.default {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @returns {Promise<ICollectionRow | IError>} Returns CollectionRowEntity object.
      * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @see {@link https://js-sdk.oneentry.cloud/docs/integration-collections/getICollectionRowByMarkerAndId getICollectionRowByMarkerAndId} documentation.
      */
     async getICollectionRowByMarkerAndId(marker, id, langCode = this.state.lang) {
         const result = await this._fetchGet(`/marker/${marker}/rows/${id}?langCode=${langCode}`);
@@ -166,6 +172,7 @@ class IntegrationCollectionsApi extends asyncModules_1.default {
      * @returns {Promise<ICollectionRow | IError>} Returns object of type ICollectionRow.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Create a record in the collection.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/integration-collections/createICollectionRow createICollectionRow} documentation.
      */
     async createICollectionRow(marker, body, langCode = this.state.lang) {
         const response = await this._fetchPost(`/marker/${marker}/rows?langCode=${langCode}`, body);
@@ -196,6 +203,7 @@ class IntegrationCollectionsApi extends asyncModules_1.default {
      * @returns {Promise<ICollectionRow | IError>} Returns object of type ICollectionRow.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Edit a record in the collection.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/integration-collections/updateICollectionRow updateICollectionRow} documentation.
      */
     async updateICollectionRow(marker, id, body, langCode = this.state.lang) {
         const response = await this._fetchPut(`/marker/${marker}/rows/${id}?` + `langCode=${langCode}`, body);
@@ -211,6 +219,7 @@ class IntegrationCollectionsApi extends asyncModules_1.default {
      * @returns {Promise<boolean | IError>} Returns true (in case of successful deletion) or false (in case of unsuccessful deletion) (permission "collections.row.delete" required for access)
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Deletion of collection record object
+     * @see {@link https://js-sdk.oneentry.cloud/docs/integration-collections/deleteICollectionRowByMarkerAndId deleteICollectionRowByMarkerAndId} documentation.
      */
     async deleteICollectionRowByMarkerAndId(marker, id) {
         const result = await this._fetchDelete(`/marker/${marker}/rows/${id}`);

package/dist/integration-collections/integrationCollectionsInterfaces.d.ts

@@ -50,7 +50,7 @@ interface ICollectionsApi {
         }
      * @param {number} [userQuery.limit] - Optional parameter for pagination. Default: 30.
      * @param {number} [userQuery.offset] - Optional parameter for pagination. Default: 0.
-     * @param {number} [userQuery.entityType] - Entity type. Example: "orders".
+     * @param {string} [userQuery.entityType] - Entity type. Example: "orders".
      * @param {number} [userQuery.entityId] - Entity identifier. Example: 1.
      * @returns {ICollectionRowsResponce} Returns object ItemsWithTotal, where items is an array of requested objects.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.

package/dist/locales/localesApi.d.ts

@@ -22,6 +22,7 @@ export default class LocalesApi extends AsyncModules implements ILocales {
      * @returns {Promise<ILocalEntity[] | IError>} Returns an array of LocaleEntity objects.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Find all active language localization objects.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/locales/getLocales getLocales} documentation.
      */
     getLocales(): Promise<Array<ILocalEntity> | IError>;
 }

package/dist/locales/localesApi.js

@@ -26,6 +26,7 @@ class LocalesApi extends asyncModules_1.default {
      * @returns {Promise<ILocalEntity[] | IError>} Returns an array of LocaleEntity objects.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Find all active language localization objects.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/locales/getLocales getLocales} documentation.
      */
     async getLocales() {
         const result = await this._fetchGet('/active/all');

package/dist/menus/menusApi.d.ts

@@ -24,6 +24,7 @@ export default class MenusApi extends AsyncModules implements IMenus {
      * @returns {Promise<IMenusEntity | IError>} Returns a single menu object as a ContentMenu object with included pages.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Get pages includes in menu by marker.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/menus/getMenusByMarker getMenusByMarker} documentation.
      */
     getMenusByMarker(marker: string, langCode?: string): Promise<IMenusEntity | IError>;
 }

package/dist/menus/menusApi.js

@@ -28,6 +28,7 @@ class MenusApi extends asyncModules_1.default {
      * @returns {Promise<IMenusEntity | IError>} Returns a single menu object as a ContentMenu object with included pages.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Get pages includes in menu by marker.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/menus/getMenusByMarker getMenusByMarker} documentation.
      */
     async getMenusByMarker(marker, langCode = this.state.lang) {
         const result = await this._fetchGet(`/marker/${marker}?langCode=${langCode}`);

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,14 @@ 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...".
+ * @see {@link https://js-sdk.oneentry.cloud/docs/orders/#Fixed-product-price-signedPrice Fixed product price} documentation.
  * @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 +314,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 +331,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>;
 }