oneentry 1.0.173 → 1.0.175

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

@@ -14,8 +14,8 @@ interface ICollectionsApi {
           "limit": 30,
           "offset": 0
         }
-     * @param {number} [userQuery.limit] - Parameter for pagination. Default: 30.
-     * @param {number} [userQuery.offset] - Parameter for pagination. Default: 0.
+     * @param {number} [userQuery.limit] - Maximum number of records to return. Default: 30.
+     * @param {number} [userQuery.offset] - Number of records to skip. Default: 0.
      * @returns {ICollectionEntity[]} Returns an array of ICollection objects or an error object if there was an issue.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      * @description This method gets all collections.
@@ -24,7 +24,7 @@ interface ICollectionsApi {
     /**
      * Get a single collection object by id.
      * @handleName getICollectionById
-     * @param {number} id - Collection id. Example: 1.
+     * @param {number} id - Collection ID. Example: 1.
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @returns {ICollectionEntity} Returns an ICollection object or an error object if there was an issue.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
@@ -34,9 +34,9 @@ interface ICollectionsApi {
     /**
      * Get all records belonging to the collection by collection id.
      * @handleName getICollectionRowsById
-     * @param {number} id - Collection id.
+     * @param {number} id - Collection ID.
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {ICollectionQuery} [userQuery] - Optional set query parameters.
+     * @param {ICollectionQuery} [userQuery] - Optional query parameters.
      * @example
         {
           "limit": 30,
@@ -44,10 +44,10 @@ interface ICollectionsApi {
           "entityType": "orders",
           "entityId": 1
         }
-     * @param {number} [userQuery.limit] - Optional parameter for pagination. Default: 30.
-     * @param {number} [userQuery.offset] - Optional parameter for pagination. Default: 0.
+     * @param {number} [userQuery.limit] - Maximum number of records to return. Default: 30.
+     * @param {number} [userQuery.offset] - Number of records to skip. Default: 0.
      * @param {string} [userQuery.entityType] - Entity type. Example: "orders".
-     * @param {number} [userQuery.entityId] - Entity identifier. Example: 1.
+     * @param {number} [userQuery.entityId] - Entity ID. 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.
      * @description This method gets all records belonging to the collection by collection id.
@@ -56,7 +56,7 @@ interface ICollectionsApi {
     /**
      * Check for the existence of a text identifier (marker).
      * @handleName validateICollectionMarker
-     * @param {string} marker - Collection marker. Example: "collection1".
+     * @param {string} marker - Marker of the collection. Example: "collection1".
      * @returns {ICollectionIsValid} Returns an object with a boolean property `valid` indicating whether the marker is valid or not.
      * @example
         {
@@ -69,7 +69,7 @@ interface ICollectionsApi {
     /**
      * Getting all records from the collection.
      * @handleName getICollectionRowsByMarker
-     * @param {string} marker - Collection text identifier. Example: "collection1".
+     * @param {string} marker - Marker of the collection. Example: "collection1".
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @returns {ICollectionRowsResponce} Returns collection row entity object.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
@@ -79,8 +79,8 @@ interface ICollectionsApi {
     /**
      * Getting one record from the collection.
      * @handleName getICollectionRowByMarkerAndId
-     * @param {string} marker - Collection text identifier. Example: "collection1".
-     * @param {number} id - Collection record identifier. Example: 1.
+     * @param {string} marker - Marker of the collection. Example: "collection1".
+     * @param {number} id - Collection record ID. Example: 1.
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @returns {ICollectionRow} Returns collection row entity object.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
@@ -90,8 +90,8 @@ interface ICollectionsApi {
     /**
      * Create a record in the collection.
      * @handleName createICollectionRow
-     * @param {string} marker - Collection text identifier. Example: "collection1".
-     * @param {ICollectionFormObject} body - Object for creating a record.
+     * @param {string} marker - Marker of the collection. Example: "collection1".
+     * @param {ICollectionFormObject} body - Data for the new record.
      * @example
         {
           "formIdentifier": "collection-form",
@@ -112,9 +112,9 @@ interface ICollectionsApi {
     /**
      * Edit a record in the collection.
      * @handleName updateICollectionRow
-     * @param {string} marker - Text identifier of the collection. Example: "collection1".
+     * @param {string} marker - Marker of the collection. Example: "collection1".
      * @param {number} id - Row id. Example: 12.
-     * @param {ICollectionFormObject} body - Object for updating a record in the collection.
+     * @param {ICollectionFormObject} body - Data for updating the collection record.
      * @example
         {
           "formIdentifier": "collection-form",
@@ -135,8 +135,8 @@ interface ICollectionsApi {
     /**
      * Deletion of collection record object
      * @handleName deleteICollectionRowByMarkerAndId
-     * @param {string} marker - text identifier of the collection Example: "collection1".
-     * @param {number} id - record identifier in the collection Example: 12.
+     * @param {string} marker - Marker of the collection. Example: "collection1".
+     * @param {number} id - ID of the collection row. Example: 12.
      * @returns {boolean} Returns true (in case of successful deletion) or false (in case of unsuccessful deletion) (permission "collections.row.delete" required for access)
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      * @description This method deletes a collection record object.
@@ -146,16 +146,16 @@ interface ICollectionsApi {
 /**
  * Collection object
  * @interface ICollectionEntity
- * @property {number} id - Object identifier. Example: 1.
- * @property {string | null} identifier - Text identifier for record field. Example: "collection1".
- * @property {number | null} formId - Identifier for the form used by the order storage. Example: 1234.
- * @property {ILocalizeInfo} localizeInfos - Localized information about the collection.
+ * @property {number} id - Object ID. Example: 1.
+ * @property {string | null} identifier - Text identifier (marker) of the object. Example: "collection1".
+ * @property {number | null} formId - ID of the form used by the collection. Example: 1234.
+ * @property {ILocalizeInfo} localizeInfos - Localized data of the collection.
  * @example
     {
       "title": "Admins text"
     }
- * @property {number | null} attributeSetId - Identifier of the set of attributes used by the form attached to the collection. Example: 1234 or null if not applicable.
- * @property {string | null} selectedAttributeMarkers - Text identifiers of form object attributes for display in the data table. Example: "collection_marker".
+ * @property {number | null} attributeSetId - ID of the attribute set used by the collection's form. Example: 1234 or null if not applicable.
+ * @property {string | null} selectedAttributeMarkers - Markers of the form attributes shown as columns in the data table. Example: "collection_marker".
  * @description Represents a collection object with various properties, including identifiers, form information, and localized data.
  */
 interface ICollectionEntity {
@@ -188,8 +188,8 @@ interface ICollectionResponce {
  * Collection form data object
  * @interface ICollectionFormData
  * @property {string} marker - Text identifier (marker) of the form field. Example: "collection_marker".
- * @property {string} type - Type of the form field, such as "text", "number", "date", "etc". Example: "number".
- * @property {string} value - Value of the form field, which can be a "string", "number", "date", "etc". Example: "Collection marker".
+ * @property {string} type - Type of the form field, for example `"text"`, `"number"` or `"date"`. Example: "number".
+ * @property {string} value - Value of the form field. Example: "Collection marker".
  * @description Represents a form data object within a collection, containing a marker, type, and value.
  */
 interface ICollectionFormData {
@@ -200,7 +200,7 @@ interface ICollectionFormData {
 /**
  * Collection form object
  * @interface ICollectionFormObject
- * @property {string} formIdentifier - Text identifier (marker) of the form. Example: "collection-form".
+ * @property {string} formIdentifier - Marker of the form. Example: "collection-form".
  * @property {ICollectionFormData[] | Record<string, ICollectionFormData[]>} formData - Field values: a flat array `[{ marker, type, value }]` (as in the example), or the same array wrapped in a language code — `{ "en_US": [...] }`. The platform stores both; the SDK sends the value as is.
  * @example
     [
@@ -222,11 +222,11 @@ interface ICollectionFormObject {
 /**
  * Collection row object
  * @interface ICollectionRow
- * @property {number} id - Object identifier. Example: 1.
- * @property {string} createdDate - Date of creation of the record. Example: "2023-01-01T00:00:00Z".
- * @property {string} updatedDate - Date of last update of the record. Example: "2023-01-02T00:00:00Z".
- * @property {number | null} [collectionId] - collectionId associated with the collection row. Example: "product", "order", "etc".
- * @property {ICollectionFormData[]} formData - Array of form data objects associated with the collection row.
+ * @property {number} id - Object ID. Example: 1.
+ * @property {string} createdDate - Creation date of the record. Example: "2023-01-01T00:00:00Z".
+ * @property {string} updatedDate - Date the record was last updated. Example: "2023-01-02T00:00:00Z".
+ * @property {number | null} [collectionId] - ID of the collection the row belongs to. Example: "product", "order", "etc".
+ * @property {ICollectionFormData[]} formData - Form fields of the collection row.
  * @example
     [
       {
@@ -235,12 +235,12 @@ interface ICollectionFormObject {
         "value": "Value"
       }
     ]
- * @property {string | null} entityType - Type of the entity associated with the collection row. Example: "product", "order", "etc".
- * @property {number | null} entityId - Identifier of the entity associated with the collection row. Example: 12345.
- * @property {string | null} [attributeSetIdentifier] - Identifier of the attribute set used by the form attached to the collection row, or null if not applicable. Example: "attributeSet1" or null.
+ * @property {string | null} entityType - Type of the entity the collection row is linked to. Example: "product", "order", "etc".
+ * @property {number | null} entityId - ID of the entity the collection row is linked to. Example: 12345.
+ * @property {string | null} [attributeSetIdentifier] - Marker of the attribute set used by the form attached to the collection row, or `null` if there is none. Example: "attributeSet1" or null.
  * @property {string | null} [langCode] - Language code the row was stored under. Example: "en_US".
- * @property {string | null} [formIdentifier] - Text identifier of the form the row was created from; returned by the create/update row endpoints. Example: "collection_form".
- * @property {string} total - Total count. Example: "1".
+ * @property {string | null} [formIdentifier] - Marker of the form the row was created from; returned by the create and update row endpoints. Example: "collection_form".
+ * @property {string} total - Total number of records. Example: "1".
  * @description Represents a row in a collection, containing various properties such as identifiers, dates, form data, and an optional total value.
  */
 interface ICollectionRow {
@@ -259,7 +259,7 @@ interface ICollectionRow {
 /**
  * Collection rows response object
  * @interface ICollectionRowsResponce
- * @property {ICollectionRow[]} items - Array of collection row objects.
+ * @property {ICollectionRow[]} items - Rows of the collection.
  * @example
     [
       {
@@ -288,7 +288,7 @@ interface ICollectionRowsResponce {
 /**
  * Collection is valid object
  * @interface ICollectionIsValid
- * @property {boolean} valid - Valid marker object. Example: true.
+ * @property {boolean} valid - Whether the marker is valid. Example: true.
  * @description Represents a response from the validateICollectionMarker.
  */
 interface ICollectionIsValid {
@@ -297,10 +297,10 @@ interface ICollectionIsValid {
 /**
  * Query parameters for collection row requests. All of them are optional.
  * @interface ICollectionQuery
- * @property {number} [limit] - Parameter for pagination. Default: 30.
- * @property {number} [offset] - Parameter for pagination. Default: 0.
+ * @property {number} [limit] - Maximum number of records to return. Default: 30.
+ * @property {number} [offset] - Number of records to skip. Default: 0.
  * @property {string} [entityType] - Entity type. Example: "orders".
- * @property {number} [entityId] - Entity identifier. Example: 1.
+ * @property {number} [entityId] - Entity ID. Example: 1.
  */
 interface ICollectionQuery {
     limit?: number;
@@ -311,8 +311,8 @@ interface ICollectionQuery {
 /**
  * Query parameters for getICollections: pagination only — the collection list takes no entity filter.
  * @typedef {object} ICollectionsListQuery
- * @property {number} [limit] - Parameter for pagination. Default: 30.
- * @property {number} [offset] - Parameter for pagination. Default: 0.
+ * @property {number} [limit] - Maximum number of records to return. Default: 30.
+ * @property {number} [offset] - Number of records to skip. Default: 0.
  */
 type ICollectionsListQuery = Pick<ICollectionQuery, 'limit' | 'offset'>;
 export type { ICollectionEntity, ICollectionFormObject, ICollectionIsValid, ICollectionQuery, ICollectionResponce, ICollectionRow, ICollectionRowsResponce, ICollectionsApi, ICollectionsListQuery, };

package/esm/locales/localesInterfaces.d.ts

@@ -17,14 +17,14 @@ interface ILocales {
 /**
  * The `ILocalEntity` interface defines the structure of a locales entity, including its identifiers, name, and other properties.
  * @interface ILocalEntity
- * @property {number} id - The unique identifier of the locales. Example: 1.
- * @property {string} shortCode - The shortCode of locales. Example: "en".
- * @property {string} code - The full language code. Example: "en_US".
- * @property {string} name - The language name. Example: "English".
- * @property {string} nativeName - The native language name. Example: "English".
- * @property {boolean} isActive - Active language flag. Example: true.
- * @property {string | null} image - The language image. Example: "https://example.com/images/en.png".
- * @property {number} position - The language position. Example: 1.
+ * @property {number} id - ID of the language. Example: 1.
+ * @property {string} shortCode - Short language code, for example `"en"`. Example: "en".
+ * @property {string} code - Full language code, such as `en_US`. Example: "en_US".
+ * @property {string} name - Name of the language. Example: "English".
+ * @property {string} nativeName - Name of the language in that language. Example: "English".
+ * @property {boolean} isActive - Whether the language is active. Example: true.
+ * @property {string | null} image - Image associated with the language. Example: "https://example.com/images/en.png".
+ * @property {number} position - Position of the language in the list. Example: 1.
  * @description This interface defines the structure of a locales entity, including its identifiers, name, and other properties.
  */
 interface ILocalEntity {

package/esm/menus/menusApi.d.ts

@@ -19,7 +19,7 @@ export default class MenusApi extends AsyncModules implements IMenus {
     /**
      * Get pages includes in menu by marker.
      * @handleName getMenusByMarker
-     * @param {string} marker - Menu marker. Example: "main_menu".
+     * @param {string} marker - Marker of the menu. Example: "main_menu".
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @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

package/esm/menus/menusApi.js

@@ -19,7 +19,7 @@ export default class MenusApi extends AsyncModules {
     /**
      * Get pages includes in menu by marker.
      * @handleName getMenusByMarker
-     * @param {string} marker - Menu marker. Example: "main_menu".
+     * @param {string} marker - Marker of the menu. Example: "main_menu".
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @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

package/esm/menus/menusInterfaces.d.ts

@@ -7,7 +7,7 @@ interface IMenus {
     /**
      * Get pages includes in menu by marker.
      * @handleName getMenusByMarker
-     * @param {string} marker - Menu marker. Example: "main_menu".
+     * @param {string} marker - Marker of the menu. Example: "main_menu".
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @returns {IMenusEntity} Returns a single menu object as a ContentMenu object with included pages.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
@@ -17,7 +17,7 @@ interface IMenus {
 }
 /**
  * @interface IMenusPages
- * @property {IMenusPages[]} children - Contains array with child page objects.
+ * @property {IMenusPages[]} children - Nested menu items (child pages).
  * @example
     [
       {
@@ -29,21 +29,21 @@ interface IMenus {
         "position": 1
       }
     ]
- * @property {number | null} id - The unique identifier of the menu. Example: 1.
- * @property {string | null} pageUrl - The page url string. Example: "about".
- * @property {ILocalizeInfo} localizeInfos - The menu data, taking into account localization.
+ * @property {number | null} id - ID of the menu. Example: 1.
+ * @property {string | null} pageUrl - URL of the page. Example: "about".
+ * @property {ILocalizeInfo} localizeInfos - Localized menu data.
  * @example
     {
       "title": "menu"
     }
- * @property {IAttributeValues} attributeValues - Attributes sets.
+ * @property {IAttributeValues} attributeValues - Attribute values of the page, keyed by attribute marker.
  * @example
     {
       "color": "red",
       "size": "large"
     }
- * @property {number} position - The menu position. Example: 1.
- * @property {number | null} parentId - The menu parent id. Example: null.
+ * @property {number} position - Position used for sorting. Example: 1.
+ * @property {number | null} parentId - ID of the parent menu item; `null` for a top-level item. Example: null.
  * @property {'page' | 'custom' | null} [parentType] - Kind of the parent item: `page` for a menu page, `custom` for a custom item; `null` together with `parentId` means top level. Page ids and custom item ids overlap, so the parent is ambiguous without it. Example: null.
  * @property {'page' | 'custom'} [itemType] - Kind of this item itself: `page` or `custom`. This is the value the item's children must pass in `parentType`. Example: "page".
  * @description This interface defines the structure of a menu page entity, including its identifiers, localization information, attributes, and hierarchical relationships.
@@ -61,14 +61,14 @@ interface IMenusPages {
 }
 /**
  * @interface IMenusEntity
- * @property {number} id - The unique identifier of the menu. Example: 1.
- * @property {string} identifier - The menu identifier. Example: "main_menu".
- * @property {ILocalizeInfo} localizeInfos - Contains localization information.
+ * @property {number} id - ID of the menu. Example: 1.
+ * @property {string} identifier - Marker of the menu. Example: "main_menu".
+ * @property {ILocalizeInfo} localizeInfos - Localized menu data.
  * @example
     {
       "title": "menu"
     }
- * @property {IMenusPages[]} pages - Array of menu pages.
+ * @property {IMenusPages[]} pages - Pages in the menu.
  * @example
     [
       {

package/esm/orders/ordersApi.d.ts

@@ -22,8 +22,8 @@ export default class OrdersApi extends AsyncModules implements IOrdersApi {
      * Getting all the order storage objects.
      * @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.
+     * @param {number} [offset] - Number of records to skip. Default: 0.
+     * @param {number} [limit] - Maximum number of records to return. Default: 30.
      * @returns {Promise<IOrdersEntity[] | IError>} Returns an array of order storage objects.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description This method requires user authorization.
@@ -34,10 +34,10 @@ export default class OrdersApi extends AsyncModules implements IOrdersApi {
     /**
      * 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} marker - Marker of the order storage. 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.
+     * @param {number} [offset] - Number of records to skip. Default: 0.
+     * @param {number} [limit] - Maximum number of records to return. Default: 30.
      * @returns {Promise<IOrdersByMarkerEntity | IError>} Returns an object with the orders.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description This method requires user authorization.
@@ -48,7 +48,7 @@ export default class OrdersApi extends AsyncModules implements IOrdersApi {
     /**
      * Retrieve one order storage object by marker.
      * @handleName getOrdersStorageByMarker
-     * @param {string} marker - Marker of the order object. Example: "order_storage_1".
+     * @param {string} marker - Marker of the order storage. Example: "order_storage_1".
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @returns {Promise<IOrdersEntity | IError>} Return object of order information.
      * @throws {IError} When isShell=false and an error occurs during the fetch
@@ -60,8 +60,8 @@ export default class OrdersApi extends AsyncModules implements IOrdersApi {
     /**
      * Getting a single order from the order storage object created by the user.
      * @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} marker - Marker of the order storage. Example: "order_storage_1".
+     * @param {number} id - Order ID. Example: 12345.
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @returns {Promise<IOrderByMarkerEntity | IError>} Returns an object with the order.
      * @throws {IError} When isShell=false and an error occurs during the fetch
@@ -73,7 +73,7 @@ export default class OrdersApi extends AsyncModules implements IOrdersApi {
     /**
      * Getting a single order created by the user, by its own id.
      * @handleName getOrderById
-     * @param {number} id - ID of the order object. Example: 12345.
+     * @param {number} id - Order ID. Example: 12345.
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @returns {Promise<IOrderByMarkerEntity | IError>} Returns an object with the order.
      * @throws {IError} When isShell=false and an error occurs during the fetch
@@ -87,7 +87,7 @@ export default class OrdersApi extends AsyncModules implements IOrdersApi {
     /**
      * Preview order calculation with discounts and coupons (without saving).
      * @handleName previewOrder
-     * @param {ICreateOrderPreview} body - Order preview body.
+     * @param {ICreateOrderPreview} body - Order preview parameters.
      * @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
@@ -99,8 +99,8 @@ export default class OrdersApi extends AsyncModules implements IOrdersApi {
     /**
      * Creation of an order in the order storage.
      * @handleName createOrder
-     * @param {string} marker - Textual identifier of the order storage object. Example: "order_storage_1".
-     * @param {IOrderData} body - Object for creating an order.
+     * @param {string} marker - Marker of the order storage. Example: "order_storage_1".
+     * @param {IOrderData} body - Data for the new order.
      * @example
         {
           "formIdentifier": "bar-orders-form",
@@ -128,9 +128,9 @@ export default class OrdersApi extends AsyncModules implements IOrdersApi {
     /**
      * Changing an order in the orders storage
      * @handleName updateOrderByMarkerAndId
-     * @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.
+     * @param {string} marker - Marker of the order storage. Example: "order_storage_1".
+     * @param {number} id - Order ID. Example: 12345.
+     * @param {IOrderData} body - Data for updating the order.
      * @example
         {
           "formIdentifier": "bar-orders-form",
@@ -159,10 +159,10 @@ export default class OrdersApi extends AsyncModules implements IOrdersApi {
     /**
      * Get all orders statuses by Storage marker
      * @handleName getAllStatusesByStorageMarker
-     * @param {string} marker - Textual identifier of the order storage object. Example: "order_storage_1".
+     * @param {string} marker - Marker of the order storage. 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.
+     * @param {number} [offset] - Number of records to skip. Default: 0.
+     * @param {number} [limit] - Maximum number of records to return. Default: 30.
      * @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}.
@@ -172,7 +172,7 @@ export default class OrdersApi extends AsyncModules implements IOrdersApi {
     /**
      * Get all refund requests for an order.
      * @handleName getRefunds
-     * @param {number} id - Order id. Example: 1.
+     * @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.
@@ -181,8 +181,8 @@ export default class OrdersApi extends AsyncModules implements IOrdersApi {
     /**
      * Create a refund request for an order.
      * @handleName createRefundRequest
-     * @param {number} id - Order id. Example: 1.
-     * @param {ICreateRefundRequest} body - Refund request body.
+     * @param {number} id - Order ID. Example: 1.
+     * @param {ICreateRefundRequest} body - Refund request data.
      * @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.
@@ -191,7 +191,7 @@ export default class OrdersApi extends AsyncModules implements IOrdersApi {
     /**
      * Cancel a refund request for an order.
      * @handleName cancelRefundRequest
-     * @param {number} id - Order id. Example: 1.
+     * @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.
@@ -200,10 +200,10 @@ export default class OrdersApi extends AsyncModules implements IOrdersApi {
     /**
      * Semantic (vector) search for the current user's orders.
      * @handleName getOrdersByVectorSearch
-     * @param {IOrdersVectorSearch} body - Vector search body. Example: `{ queryText: "winter jacket" }`.
+     * @param {IOrdersVectorSearch} body - Vector search parameters. Example: `{ queryText: "winter jacket" }`.
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {number} [offset] - Parameter for pagination. Default: 0.
-     * @param {number} [limit] - Parameter for pagination. Default: 30.
+     * @param {number} [offset] - Number of records to skip. Default: 0.
+     * @param {number} [limit] - Maximum number of records to return. Default: 30.
      * @returns {Promise<IVectorSearchResponse<IOrdersByMarkerEntity> | IError>} Returns an object with an array of found orders and total count.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description This method performs a semantic (vector) search over the orders of the authorized user. It requires user authorization.
@@ -231,7 +231,7 @@ export default class OrdersApi extends AsyncModules implements IOrdersApi {
      * a reused body — a retry, a shared template — arrive wrapped twice: `createOrder`
      * answered `400 formData's marker '#0' marker is required`, and
      * `updateOrderByMarkerAndId` answered `200` and stored the broken `formData` in
-     * the order (CMS-1063).
+     * the order.
      * @param {IOrderData} body - Order body as the caller passed it. Left unchanged.
      * @param {string} langCode - Locale key to wrap `formData` into.
      * @returns {object} A new body with `formData` as `{ [langCode]: [...] }`.