oneentry 1.0.123 → 1.0.125

package/dist/orders/ordersApi.d.ts

@@ -3,106 +3,124 @@ import type StateModule from '../base/stateModule';
 import type { IError } from '../base/utils';
 import type { IBaseOrdersEntity, IOrderByMarkerEntity, IOrderData, IOrdersApi, IOrdersByMarkerEntity, IOrdersEntity } from './ordersInterfaces';
 /**
- * Controllers for working with orders
+ * Controllers for working with orders.
+ *
  * @handle /api/content/orders-storage
+ * @module OrdersApi
+ * @description This module provides methods for working with orders, including retrieving, creating, and updating orders in the order storage.
  */
 export default class OrdersApi extends AsyncModules implements IOrdersApi {
     protected state: StateModule;
     protected _url: string;
     constructor(state: StateModule);
     /**
-     * Getting all the order storage objects
-     * @description This method requires user authorization. For more information about configuring the authorization module, see the documentation in the configuration settings section of the SDK.
+     * Getting all the order storage objects.
      *
-     * @param {number} [langCode] - Optional language field
-     * @param {number} [offset] - Optional parameter for pagination, default is 0
-     * @param {number} [limit] - Optional parameter for pagination, default is 30
-     */
-    getAllOrdersStorage(langCode?: string, offset?: number, limit?: number): Promise<Array<IOrdersEntity> | IError>;
+     * @handleName getAllOrdersStorage
+     *
+     * @param {string} [langCode] - Language code. Default: "en_US".
+     * @param {number} [offset] - Optional parameter for pagination. Default: 0.
+     * @param {number} [limit] - Optional parameter for pagination. Default: 30.
+     * @return {IOrdersEntity[]} Returns an array of order storage objects.
+     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @description This method requires user authorization. For more information about configuring the authorization module, see the documentation in the configuration settings section of the SDK.
+     **/
+    getAllOrdersStorage(langCode?: string, offset?: number, limit?: number): Promise<IOrdersEntity[] | IError>;
     /**
-     * Getting all orders from the orders storage object created by the user
+     * Getting all orders from the orders storage object created by the user.
+     *
+     * @handleName getAllOrdersByMarker
      *
+     * @param {string} marker - Textual identifier of the order storage object. Example: "order_storage_1".
+     * @param {string} [langCode] - Language code. Default: "en_US".
+     * @param {number} [offset] - Offset parameter. Default: 0.
+     * @param {number} [limit] - Limit parameter. Default: 30.
+     * @return {IOrdersByMarkerEntity} Returns an object with the orders.
+     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      * @description This method requires user authorization. For more information about configuring the authorization module, see the documentation in the configuration settings section of the SDK.
-     * @param {string} [marker] - Textual identifier of the order storage object
-     * @param {string} [langCode] - Optional language field
-     * @param {number} [offset] - Offset parameter. Default 0
-     * @param {number} [limit] - Limit parameter. Default 30
      */
     getAllOrdersByMarker(marker: string, langCode?: string, offset?: number, limit?: number): Promise<IOrdersByMarkerEntity | IError>;
     /**
      * Retrieve one order storage object by marker.
      *
-     * @description This method requires user authorization. For more information about configuring the authorization module, see the documentation in the configuration settings section of the SDK.
-     * @param {string} [marker] - Marker of the order object
-     * @param {string} [langCode] - Language code
+     * @handleName getOrderByMarker
      *
-     * @returns Return object of order information.
+     * @param {string} marker - Marker of the order object. Example: "order_storage_1".
+     * @param {string} [langCode] - Language code. Default: "en_US".
+     * @return {IOrdersEntity} Return object of order information.
+     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @description This method requires user authorization. For more information about configuring the authorization module, see the documentation in the configuration settings section of the SDK.
      */
     getOrderByMarker(marker: string, langCode?: string): Promise<IOrdersEntity | IError>;
     /**
-     * Getting a single order from the order storage object created by the user
+     * Getting a single order from the order storage object created by the user.
      *
-     * @param {string} [marker] - The text identifier of the order storage object
-     * @param {number} [id] - ID of the order object
-     * @param {string} [langCode] - Optional language field
+     * @handleName getOrderByMarkerAndId
      *
+     * @param {string} marker - The text identifier of the order storage object. Example: "order_storage_1".
+     * @param {number} id - ID of the order object. Example: 12345.
+     * @param {string} [langCode] - Language code. Default: "en_US".
+     * @return {IOrderByMarkerEntity} Returns an object with the order.
+     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @description This method requires user authorization. For more information about configuring the authorization module, see the documentation in the configuration settings section of the SDK.
      */
     getOrderByMarkerAndId(marker: string, id: number, langCode?: string): Promise<IOrderByMarkerEntity | IError>;
     /**
      * Creation of an order in the order storage.
      *
-     * @param {string} marker - Textual identifier of the order storage object
-     * @param {IOrderData} data - Object for creating an order
-     * @param {String} langCode - Optional language field
+     * @handleName createOrder
      *
+     * @param {string} marker - Textual identifier of the order storage object. Example: "order_storage_1".
+     * @param {IOrderData} body - Object for creating an order. Example:
+        {
+          "formIdentifier": "bar-orders-form",
+          "paymentAccountIdentifier": "usd-payment",
+          "formData": {
+            "marker": "name_1",
+            "value": "Name",
+            "type": "string"
+          },
+          "products": [
+            {
+              "productId": 1,
+              "quantity": 2
+            }
+          ]
+        }
+     * @param {String} [langCode] - Language code. Default: "en_US".
+     * @return {IBaseOrdersEntity} Returns an object with the created order.
+     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      * @description This method requires user authorization. For more information about configuring the authorization module, see the documentation in the configuration settings section of the SDK.
-     *
-     * @example
-     * const body = {
-     *   "formIdentifier": "bar-orders-form",
-     *   "paymentAccountIdentifier": "usd-payment",
-     *   "formData": {
-     *       "marker": "name_1",
-     *       "value": "Name",
-     *       "type": "string"
-     *   },
-     *   "products": [
-     *     {
-     *       "productId": 1,
-     *       "quantity": 2,
-     *     }
-     *   ],
-     * }
-     *
-     * @returns Returns object for creating an order.
      */
-    createOrder(marker: string, data: IOrderData, langCode?: string): Promise<IBaseOrdersEntity | IError>;
+    createOrder(marker: string, body: IOrderData, langCode?: string): Promise<IBaseOrdersEntity | IError>;
     /**
      * Changing an order in the orders storage
      *
-     * @description This method requires user authorization. For more information about configuring the authorization module, see the documentation in the configuration settings section of the SDK.
-     * @param {string} [marker] - The text identifier of the order storage object
-     * @param {number} [id] - ID of the order object
-     * @param {IOrderData} [body] - Object for updating an order
-     * @param {string} [langCode] - Optional language field
+     * @handleName updateOrderByMarkerAndId
      *
-     * @example
-     * const body = {
-     *   "formIdentifier": "bar-orders-form",
-     *   "paymentAccountIdentifier": "usd-payment",
-     *   "formData": {
-     *       "marker": "name_1",
-     *       "value": "Name",
-     *       "type": "string"
-     *   },
-     *   "products": [
-     *     {
-     *       "productId": 1,
-     *       "quantity": 2
-     *     }
-     *   ],
-     *   "currency": "USD"
-     * }
+     * @param {string} marker - The text identifier of the order storage object. Example: "order_storage_1".
+     * @param {number} id - ID of the order object. Example: 12345.
+     * @param {IOrderData} body - Object for updating an order. Example:
+        {
+          "formIdentifier": "bar-orders-form",
+          "paymentAccountIdentifier": "usd-payment",
+          "formData": {
+            "marker": "name_1",
+            "value": "Name",
+            "type": "string"
+          },
+          "products": [
+            {
+              "productId": 1,
+              "quantity": 2
+            }
+          ],
+          "currency": "USD"
+        }
+     * @param {string} [langCode] - Language code. Default: "en_US".
+     * @return {IBaseOrdersEntity} Returns an object with the updated order.
+     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @description This method requires user authorization. For more information about configuring the authorization module, see the documentation in the configuration settings section of the SDK.
      */
     updateOrderByMarkerAndId(marker: string, id: number, body: IOrderData, langCode?: string): Promise<IBaseOrdersEntity | IError>;
 }

package/dist/orders/ordersApi.js

@@ -3,11 +3,13 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-/* eslint-disable @typescript-eslint/no-explicit-any */
 const asyncModules_1 = __importDefault(require("../base/asyncModules"));
 /**
- * Controllers for working with orders
+ * Controllers for working with orders.
+ *
  * @handle /api/content/orders-storage
+ * @module OrdersApi
+ * @description This module provides methods for working with orders, including retrieving, creating, and updating orders in the order storage.
  */
 class OrdersApi extends asyncModules_1.default {
     constructor(state) {
@@ -15,50 +17,65 @@ class OrdersApi extends asyncModules_1.default {
         this._url = state.url + '/api/content/orders-storage';
     }
     /**
-     * Getting all the order storage objects
-     * @description This method requires user authorization. For more information about configuring the authorization module, see the documentation in the configuration settings section of the SDK.
+     * Getting all the order storage objects.
      *
-     * @param {number} [langCode] - Optional language field
-     * @param {number} [offset] - Optional parameter for pagination, default is 0
-     * @param {number} [limit] - Optional parameter for pagination, default is 30
-     */
+     * @handleName getAllOrdersStorage
+     *
+     * @param {string} [langCode] - Language code. Default: "en_US".
+     * @param {number} [offset] - Optional parameter for pagination. Default: 0.
+     * @param {number} [limit] - Optional parameter for pagination. Default: 30.
+     * @return {IOrdersEntity[]} Returns an array of order storage objects.
+     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @description This method requires user authorization. For more information about configuring the authorization module, see the documentation in the configuration settings section of the SDK.
+     **/
     async getAllOrdersStorage(langCode = this.state.lang, offset = 0, limit = 30) {
         const result = await this._fetchGet(`?langCode=${langCode}&limit=${limit}&offset=${offset}`);
         return this._normalizeData(result);
     }
     /**
-     * Getting all orders from the orders storage object created by the user
+     * Getting all orders from the orders storage object created by the user.
      *
+     * @handleName getAllOrdersByMarker
+     *
+     * @param {string} marker - Textual identifier of the order storage object. Example: "order_storage_1".
+     * @param {string} [langCode] - Language code. Default: "en_US".
+     * @param {number} [offset] - Offset parameter. Default: 0.
+     * @param {number} [limit] - Limit parameter. Default: 30.
+     * @return {IOrdersByMarkerEntity} Returns an object with the orders.
+     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      * @description This method requires user authorization. For more information about configuring the authorization module, see the documentation in the configuration settings section of the SDK.
-     * @param {string} [marker] - Textual identifier of the order storage object
-     * @param {string} [langCode] - Optional language field
-     * @param {number} [offset] - Offset parameter. Default 0
-     * @param {number} [limit] - Limit parameter. Default 30
      */
     async getAllOrdersByMarker(marker, langCode = this.state.lang, offset = 0, limit = 30) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
         const result = await this._fetchGet(`/marker/${marker}/orders?langCode=${langCode}&limit=${limit}&offset=${offset}`);
         return this._normalizeData(result);
     }
     /**
      * Retrieve one order storage object by marker.
      *
-     * @description This method requires user authorization. For more information about configuring the authorization module, see the documentation in the configuration settings section of the SDK.
-     * @param {string} [marker] - Marker of the order object
-     * @param {string} [langCode] - Language code
+     * @handleName getOrderByMarker
      *
-     * @returns Return object of order information.
+     * @param {string} marker - Marker of the order object. Example: "order_storage_1".
+     * @param {string} [langCode] - Language code. Default: "en_US".
+     * @return {IOrdersEntity} Return object of order information.
+     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @description This method requires user authorization. For more information about configuring the authorization module, see the documentation in the configuration settings section of the SDK.
      */
     async getOrderByMarker(marker, langCode = this.state.lang) {
         const result = await this._fetchGet(`/marker/${marker}?langCode=${langCode}`);
         return this._normalizeData(result);
     }
     /**
-     * Getting a single order from the order storage object created by the user
+     * Getting a single order from the order storage object created by the user.
      *
-     * @param {string} [marker] - The text identifier of the order storage object
-     * @param {number} [id] - ID of the order object
-     * @param {string} [langCode] - Optional language field
+     * @handleName getOrderByMarkerAndId
      *
+     * @param {string} marker - The text identifier of the order storage object. Example: "order_storage_1".
+     * @param {number} id - ID of the order object. Example: 12345.
+     * @param {string} [langCode] - Language code. Default: "en_US".
+     * @return {IOrderByMarkerEntity} Returns an object with the order.
+     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @description This method requires user authorization. For more information about configuring the authorization module, see the documentation in the configuration settings section of the SDK.
      */
     async getOrderByMarkerAndId(marker, id, langCode = this.state.lang) {
         const result = await this._fetchGet(`/marker/${marker}/orders/${id}?langCode=${langCode}`);
@@ -67,68 +84,71 @@ class OrdersApi extends asyncModules_1.default {
     /**
      * Creation of an order in the order storage.
      *
-     * @param {string} marker - Textual identifier of the order storage object
-     * @param {IOrderData} data - Object for creating an order
-     * @param {String} langCode - Optional language field
+     * @handleName createOrder
      *
+     * @param {string} marker - Textual identifier of the order storage object. Example: "order_storage_1".
+     * @param {IOrderData} body - Object for creating an order. Example:
+        {
+          "formIdentifier": "bar-orders-form",
+          "paymentAccountIdentifier": "usd-payment",
+          "formData": {
+            "marker": "name_1",
+            "value": "Name",
+            "type": "string"
+          },
+          "products": [
+            {
+              "productId": 1,
+              "quantity": 2
+            }
+          ]
+        }
+     * @param {String} [langCode] - Language code. Default: "en_US".
+     * @return {IBaseOrdersEntity} Returns an object with the created order.
+     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      * @description This method requires user authorization. For more information about configuring the authorization module, see the documentation in the configuration settings section of the SDK.
-     *
-     * @example
-     * const body = {
-     *   "formIdentifier": "bar-orders-form",
-     *   "paymentAccountIdentifier": "usd-payment",
-     *   "formData": {
-     *       "marker": "name_1",
-     *       "value": "Name",
-     *       "type": "string"
-     *   },
-     *   "products": [
-     *     {
-     *       "productId": 1,
-     *       "quantity": 2,
-     *     }
-     *   ],
-     * }
-     *
-     * @returns Returns object for creating an order.
      */
-    async createOrder(marker, data, langCode = this.state.lang) {
+    async createOrder(marker, body, langCode = this.state.lang) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
         const formData = {};
-        formData[langCode] = Array.isArray(data.formData)
-            ? data.formData
-            : [data.formData];
-        data.formData = formData;
-        const result = await this._fetchPost(`/marker/${marker}/orders`, data);
+        formData[langCode] = Array.isArray(body.formData)
+            ? body.formData
+            : [body.formData];
+        body.formData = formData;
+        const result = await this._fetchPost(`/marker/${marker}/orders`, body);
         return this._normalizeData(result);
     }
     /**
      * Changing an order in the orders storage
      *
-     * @description This method requires user authorization. For more information about configuring the authorization module, see the documentation in the configuration settings section of the SDK.
-     * @param {string} [marker] - The text identifier of the order storage object
-     * @param {number} [id] - ID of the order object
-     * @param {IOrderData} [body] - Object for updating an order
-     * @param {string} [langCode] - Optional language field
+     * @handleName updateOrderByMarkerAndId
      *
-     * @example
-     * const body = {
-     *   "formIdentifier": "bar-orders-form",
-     *   "paymentAccountIdentifier": "usd-payment",
-     *   "formData": {
-     *       "marker": "name_1",
-     *       "value": "Name",
-     *       "type": "string"
-     *   },
-     *   "products": [
-     *     {
-     *       "productId": 1,
-     *       "quantity": 2
-     *     }
-     *   ],
-     *   "currency": "USD"
-     * }
+     * @param {string} marker - The text identifier of the order storage object. Example: "order_storage_1".
+     * @param {number} id - ID of the order object. Example: 12345.
+     * @param {IOrderData} body - Object for updating an order. Example:
+        {
+          "formIdentifier": "bar-orders-form",
+          "paymentAccountIdentifier": "usd-payment",
+          "formData": {
+            "marker": "name_1",
+            "value": "Name",
+            "type": "string"
+          },
+          "products": [
+            {
+              "productId": 1,
+              "quantity": 2
+            }
+          ],
+          "currency": "USD"
+        }
+     * @param {string} [langCode] - Language code. Default: "en_US".
+     * @return {IBaseOrdersEntity} Returns an object with the updated order.
+     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @description This method requires user authorization. For more information about configuring the authorization module, see the documentation in the configuration settings section of the SDK.
      */
     async updateOrderByMarkerAndId(marker, id, body, langCode = this.state.lang) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
         const formData = {};
         formData[langCode] = Array.isArray(body.formData)
             ? body.formData