oneentry 1.0.128 → 1.0.131

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (64) hide show
  1. package/README.md +3 -0
  2. package/dist/admins/adminsApi.d.ts +8 -8
  3. package/dist/admins/adminsApi.js +8 -8
  4. package/dist/admins/adminsInterfaces.d.ts +16 -15
  5. package/dist/attribute-sets/attributeSetsApi.d.ts +0 -4
  6. package/dist/attribute-sets/attributeSetsApi.js +0 -4
  7. package/dist/attribute-sets/attributeSetsInterfaces.d.ts +42 -32
  8. package/dist/auth-provider/authProviderApi.d.ts +19 -10
  9. package/dist/auth-provider/authProviderApi.js +19 -10
  10. package/dist/auth-provider/authProvidersInterfaces.d.ts +28 -12
  11. package/dist/base/asyncModules.js +13 -6
  12. package/dist/base/result.d.ts +9 -9
  13. package/dist/base/result.js +10 -10
  14. package/dist/base/stateModule.d.ts +6 -5
  15. package/dist/base/stateModule.js +15 -14
  16. package/dist/base/syncModules.d.ts +10 -5
  17. package/dist/base/syncModules.js +14 -7
  18. package/dist/base/utils.d.ts +34 -11
  19. package/dist/blocks/blocksApi.d.ts +0 -4
  20. package/dist/blocks/blocksApi.js +0 -4
  21. package/dist/config.d.ts +1 -1
  22. package/dist/config.js +3 -1
  23. package/dist/events/eventsApi.d.ts +6 -3
  24. package/dist/events/eventsApi.js +6 -3
  25. package/dist/events/eventsInterfaces.d.ts +2 -1
  26. package/dist/file-uploading/fileUploadingApi.d.ts +12 -6
  27. package/dist/file-uploading/fileUploadingApi.js +12 -6
  28. package/dist/file-uploading/fileUploadingInterfaces.d.ts +10 -5
  29. package/dist/forms/formsApi.d.ts +4 -2
  30. package/dist/forms/formsApi.js +4 -2
  31. package/dist/forms/formsInterfaces.d.ts +2 -1
  32. package/dist/forms-data/formsDataApi.d.ts +28 -6
  33. package/dist/forms-data/formsDataApi.js +28 -6
  34. package/dist/forms-data/formsDataInterfaces.d.ts +64 -22
  35. package/dist/general-types/generalTypesInterfaces.d.ts +2 -2
  36. package/dist/index.d.ts +1 -0
  37. package/dist/index.js +1 -0
  38. package/dist/integration-collections/integrationCollectionsApi.d.ts +10 -5
  39. package/dist/integration-collections/integrationCollectionsApi.js +10 -5
  40. package/dist/integration-collections/integrationCollectionsInterfaces.d.ts +20 -10
  41. package/dist/menus/menusInterfaces.d.ts +8 -4
  42. package/dist/orders/ordersApi.d.ts +16 -8
  43. package/dist/orders/ordersApi.js +16 -8
  44. package/dist/orders/ordersInterfaces.d.ts +39 -18
  45. package/dist/pages/pagesApi.d.ts +2 -1
  46. package/dist/pages/pagesApi.js +2 -1
  47. package/dist/pages/pagesInterfaces.d.ts +10 -5
  48. package/dist/payments/paymentsApi.d.ts +20 -12
  49. package/dist/payments/paymentsApi.js +20 -12
  50. package/dist/payments/paymentsInterfaces.d.ts +28 -9
  51. package/dist/product-statuses/productStatusesInterfaces.d.ts +5 -4
  52. package/dist/products/productsApi.d.ts +28 -15
  53. package/dist/products/productsApi.js +28 -15
  54. package/dist/products/productsInterfaces.d.ts +33 -18
  55. package/dist/system/systemApi.d.ts +2 -1
  56. package/dist/system/systemApi.js +2 -1
  57. package/dist/templates/templatesInterfaces.d.ts +3 -2
  58. package/dist/templates-preview/templatesPreviewInterfaces.d.ts +8 -4
  59. package/dist/users/usersApi.d.ts +14 -7
  60. package/dist/users/usersApi.js +14 -7
  61. package/dist/users/usersInterfaces.d.ts +23 -11
  62. package/dist/web-socket/wsApi.d.ts +2 -1
  63. package/dist/web-socket/wsApi.js +2 -1
  64. package/package.json +9 -8
@@ -22,7 +22,8 @@ export default class IntegrationCollectionsApi extends AsyncModules implements I
22
22
  * Get all collections.
23
23
  * @handleName getICollections
24
24
  * @param {string} [langCode] - Language code. Default: "en_US".
25
- * @param {object} [userQuery] - Optional set query parameters. Example:
25
+ * @param {object} [userQuery] - Optional set query parameters.
26
+ * @example
26
27
  {
27
28
  "limit": 0,
28
29
  "offset": 30,
@@ -58,7 +59,8 @@ export default class IntegrationCollectionsApi extends AsyncModules implements I
58
59
  * @handleName getICollectionRowsById
59
60
  * @param {number} id - Collection id. Example: 1.
60
61
  * @param {string} [langCode] - Language code. Default: "en_US".
61
- * @param {any} [userQuery] - Optional set query parameters. Example:
62
+ * @param {any} [userQuery] - Optional set query parameters.
63
+ * @example
62
64
  {
63
65
  "limit": 0,
64
66
  "offset": 30,
@@ -83,7 +85,8 @@ export default class IntegrationCollectionsApi extends AsyncModules implements I
83
85
  * Check for the existence of a text identifier (marker).
84
86
  * @handleName validateICollectionMarker
85
87
  * @param {string} marker - Collection marker. Example: "collection1".
86
- * @returns {ICollectionIsValid} Returns an object with a boolean property `valid` indicating whether the marker is valid or not. Example:
88
+ * @returns {ICollectionIsValid} Returns an object with a boolean property `valid` indicating whether the marker is valid or not.
89
+ * @example
87
90
  {
88
91
  "valid": true
89
92
  }
@@ -116,7 +119,8 @@ export default class IntegrationCollectionsApi extends AsyncModules implements I
116
119
  * Create a record in the collection.
117
120
  * @handleName createICollectionRow
118
121
  * @param {string} marker - Collection text identifier. Example: "collection1".
119
- * @param {ICollectionFormObject} body - Object for creating a record. Example:
122
+ * @param {ICollectionFormObject} body - Object for creating a record.
123
+ * @example
120
124
  {
121
125
  "formIdentifier": "collection-form",
122
126
  "formData": [
@@ -138,7 +142,8 @@ export default class IntegrationCollectionsApi extends AsyncModules implements I
138
142
  * @handleName updateICollectionRow
139
143
  * @param {string} marker - Text identifier of the collection. Example: "collection1".
140
144
  * @param {number} id - Row identifier in the collection. Example: 12.
141
- * @param {object} body - Object for updating a record in the collection. Example:
145
+ * @param {object} body - Object for updating a record in the collection.
146
+ * @example
142
147
  {
143
148
  "formIdentifier": "collection-form",
144
149
  "formData": [
@@ -31,7 +31,8 @@ class IntegrationCollectionsApi extends asyncModules_1.default {
31
31
  * Get all collections.
32
32
  * @handleName getICollections
33
33
  * @param {string} [langCode] - Language code. Default: "en_US".
34
- * @param {object} [userQuery] - Optional set query parameters. Example:
34
+ * @param {object} [userQuery] - Optional set query parameters.
35
+ * @example
35
36
  {
36
37
  "limit": 0,
37
38
  "offset": 30,
@@ -70,7 +71,8 @@ class IntegrationCollectionsApi extends asyncModules_1.default {
70
71
  * @handleName getICollectionRowsById
71
72
  * @param {number} id - Collection id. Example: 1.
72
73
  * @param {string} [langCode] - Language code. Default: "en_US".
73
- * @param {any} [userQuery] - Optional set query parameters. Example:
74
+ * @param {any} [userQuery] - Optional set query parameters.
75
+ * @example
74
76
  {
75
77
  "limit": 0,
76
78
  "offset": 30,
@@ -98,7 +100,8 @@ class IntegrationCollectionsApi extends asyncModules_1.default {
98
100
  * Check for the existence of a text identifier (marker).
99
101
  * @handleName validateICollectionMarker
100
102
  * @param {string} marker - Collection marker. Example: "collection1".
101
- * @returns {ICollectionIsValid} Returns an object with a boolean property `valid` indicating whether the marker is valid or not. Example:
103
+ * @returns {ICollectionIsValid} Returns an object with a boolean property `valid` indicating whether the marker is valid or not.
104
+ * @example
102
105
  {
103
106
  "valid": true
104
107
  }
@@ -140,7 +143,8 @@ class IntegrationCollectionsApi extends asyncModules_1.default {
140
143
  * Create a record in the collection.
141
144
  * @handleName createICollectionRow
142
145
  * @param {string} marker - Collection text identifier. Example: "collection1".
143
- * @param {ICollectionFormObject} body - Object for creating a record. Example:
146
+ * @param {ICollectionFormObject} body - Object for creating a record.
147
+ * @example
144
148
  {
145
149
  "formIdentifier": "collection-form",
146
150
  "formData": [
@@ -165,7 +169,8 @@ class IntegrationCollectionsApi extends asyncModules_1.default {
165
169
  * @handleName updateICollectionRow
166
170
  * @param {string} marker - Text identifier of the collection. Example: "collection1".
167
171
  * @param {number} id - Row identifier in the collection. Example: 12.
168
- * @param {object} body - Object for updating a record in the collection. Example:
172
+ * @param {object} body - Object for updating a record in the collection.
173
+ * @example
169
174
  {
170
175
  "formIdentifier": "collection-form",
171
176
  "formData": [
@@ -17,7 +17,8 @@ interface ICollectionsApi {
17
17
  * Get all collections.
18
18
  * @handleName getICollections
19
19
  * @param {string} [langCode] - Language code. Default: "en_US".
20
- * @param {any} [userQuery] - Query parameters. Example:
20
+ * @param {any} [userQuery] - Query parameters.
21
+ * @example
21
22
  {
22
23
  "limit": 30,
23
24
  "offset": 0,
@@ -53,7 +54,8 @@ interface ICollectionsApi {
53
54
  * @handleName getICollectionRowsById
54
55
  * @param {number} id - Collection id.
55
56
  * @param {string} [langCode] - Language code. Default: "en_US".
56
- * @param {any} [userQuery] - Optional set query parameters. Example:
57
+ * @param {any} [userQuery] - Optional set query parameters.
58
+ * @example
57
59
  {
58
60
  "limit": 30,
59
61
  "offset": 0,
@@ -73,7 +75,8 @@ interface ICollectionsApi {
73
75
  * Check for the existence of a text identifier (marker).
74
76
  * @handleName validateICollectionMarker
75
77
  * @param {string} marker - Collection marker. Example: "collection1".
76
- * @returns {ICollectionIsValid} Returns an object with a boolean property `valid` indicating whether the marker is valid or not. Example:
78
+ * @returns {ICollectionIsValid} Returns an object with a boolean property `valid` indicating whether the marker is valid or not.
79
+ * @example
77
80
  {
78
81
  "valid": true
79
82
  }
@@ -106,7 +109,8 @@ interface ICollectionsApi {
106
109
  * Create a record in the collection.
107
110
  * @handleName createICollectionRow
108
111
  * @param {string} marker - Collection text identifier. Example: "collection1".
109
- * @param {ICollectionFormObject} body - Object for creating a record. Example:
112
+ * @param {ICollectionFormObject} body - Object for creating a record.
113
+ * @example
110
114
  {
111
115
  "formIdentifier": "collection-form",
112
116
  "formData": [
@@ -128,7 +132,8 @@ interface ICollectionsApi {
128
132
  * @handleName updateICollectionRow
129
133
  * @param {string} marker - Text identifier of the collection. Example: "collection1".
130
134
  * @param {number} id - Row id. Example: 12.
131
- * @param {ICollectionFormObject} body - Object for updating a record in the collection. Example:
135
+ * @param {ICollectionFormObject} body - Object for updating a record in the collection.
136
+ * @example
132
137
  {
133
138
  "formIdentifier": "collection-form",
134
139
  "formData": [
@@ -162,7 +167,8 @@ interface ICollectionsApi {
162
167
  * @property {number} id - Object identifier. Example: 1.
163
168
  * @property {string | null} identifier - Text identifier for record field. Example: "collection1".
164
169
  * @property {number | null} formId - Identifier for the form used by the order storage. Example: 1234.
165
- * @property {ILocalizeInfo} localizeInfos - Localized information about the collection. Example:
170
+ * @property {ILocalizeInfo} localizeInfos - Localized information about the collection.
171
+ * @example
166
172
  {
167
173
  "title": "Admins text"
168
174
  }
@@ -181,7 +187,8 @@ interface ICollectionEntity {
181
187
  /**
182
188
  * Collection response object
183
189
  * @interface ICollectionResponce
184
- * @property {ICollectionEntity[]} items - Array of collection objects. Example:
190
+ * @property {ICollectionEntity[]} items - Array of collection objects.
191
+ * @example
185
192
  [
186
193
  {
187
194
  "id": 1,
@@ -212,7 +219,8 @@ interface ICollectionFormData {
212
219
  * Collection form object
213
220
  * @interface ICollectionFormObject
214
221
  * @property {string} formIdentifier - Text identifier (marker) of the form. Example: "collection-form".
215
- * @property {Record<string, ICollectionFormData>} formData - An object where keys are form field markers and values are arrays of ICollectionFormData objects. Example:
222
+ * @property {Record<string, ICollectionFormData>} formData - An object where keys are form field markers and values are arrays of ICollectionFormData objects.
223
+ * @example
216
224
  [
217
225
  {
218
226
  "marker": "name_1",
@@ -238,7 +246,8 @@ interface ICollectionFormObject {
238
246
  * @property {string} createdDate - Date of creation of the record. Example: "2023-01-01T00:00:00Z".
239
247
  * @property {string} updatedDate - Date of last update of the record. Example: "2023-01-02T00:00:00Z".
240
248
  * @property {number | null} [collectionId] - collectionId associated with the collection row. Example: "product", "order", "etc".
241
- * @property {ICollectionFormData[]} formData - Array of form data objects associated with the collection row. Example:
249
+ * @property {ICollectionFormData[]} formData - Array of form data objects associated with the collection row.
250
+ * @example
242
251
  [
243
252
  {
244
253
  "marker": "name_1",
@@ -266,7 +275,8 @@ interface ICollectionRow {
266
275
  /**
267
276
  * Collection rows response object
268
277
  * @interface ICollectionRowsResponce
269
- * @property {ICollectionRow[]} items - Array of collection row objects. Example:
278
+ * @property {ICollectionRow[]} items - Array of collection row objects.
279
+ * @example
270
280
  [
271
281
  {
272
282
  "id": 1,
@@ -18,7 +18,8 @@ interface IMenus {
18
18
  }
19
19
  /**
20
20
  * @interface IMenusPages
21
- * @property {IMenusPages[]} children - Contains array with child page objects. Example:
21
+ * @property {IMenusPages[]} children - Contains array with child page objects.
22
+ * @example
22
23
  [
23
24
  {
24
25
  "id": null,
@@ -31,11 +32,13 @@ interface IMenus {
31
32
  ]
32
33
  * @property {number} id - The unique identifier of the menu. Example: 1.
33
34
  * @property {string} pageUrl - The page url string. Example: "about".
34
- * @property {ILocalizeInfo} localizeInfos - The menu data, taking into account localization. Example:
35
+ * @property {ILocalizeInfo} localizeInfos - The menu data, taking into account localization.
36
+ * @example
35
37
  {
36
38
  "title": "menu"
37
39
  }
38
- * @property {IAttributeValues} attributeValues - Attributes sets. Example:
40
+ * @property {IAttributeValues} attributeValues - Attributes sets.
41
+ * @example
39
42
  {
40
43
  "color": "red",
41
44
  "size": "large"
@@ -58,7 +61,8 @@ interface IMenusPages {
58
61
  * @property {number} id - The unique identifier of the menu. Example: 1.
59
62
  * @property {string} identifier - The menu identifier. Example: "main_menu".
60
63
  * @property {ILocalizeInfo} localizeInfos - Contains localization information. Example: {"title": "menu"}.
61
- * @property {IMenusPages[]} pages - Array of menu pages. Example:
64
+ * @property {IMenusPages[]} pages - Array of menu pages.
65
+ * @example
62
66
  [
63
67
  {
64
68
  "id": null,
@@ -25,7 +25,8 @@ export default class OrdersApi extends AsyncModules implements IOrdersApi {
25
25
  * @param {number} [limit] - Optional parameter for pagination. Default: 30.
26
26
  * @returns {IOrdersEntity[]} Returns an array of order storage objects.
27
27
  * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
28
- * @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.
28
+ * @description This method requires user authorization.
29
+ * @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}.
29
30
  */
30
31
  getAllOrdersStorage(langCode?: string, offset?: number, limit?: number): Promise<IOrdersEntity[] | IError>;
31
32
  /**
@@ -37,7 +38,8 @@ export default class OrdersApi extends AsyncModules implements IOrdersApi {
37
38
  * @param {number} [limit] - Limit parameter. Default: 30.
38
39
  * @returns {IOrdersByMarkerEntity} Returns an object with the orders.
39
40
  * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
40
- * @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.
41
+ * @description This method requires user authorization.
42
+ * @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}.
41
43
  */
42
44
  getAllOrdersByMarker(marker: string, langCode?: string, offset?: number, limit?: number): Promise<IOrdersByMarkerEntity | IError>;
43
45
  /**
@@ -47,7 +49,8 @@ export default class OrdersApi extends AsyncModules implements IOrdersApi {
47
49
  * @param {string} [langCode] - Language code. Default: "en_US".
48
50
  * @returns {IOrdersEntity} Return object of order information.
49
51
  * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
50
- * @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.
52
+ * @description This method requires user authorization.
53
+ * @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}.
51
54
  */
52
55
  getOrderByMarker(marker: string, langCode?: string): Promise<IOrdersEntity | IError>;
53
56
  /**
@@ -58,14 +61,16 @@ export default class OrdersApi extends AsyncModules implements IOrdersApi {
58
61
  * @param {string} [langCode] - Language code. Default: "en_US".
59
62
  * @returns {IOrderByMarkerEntity} Returns an object with the order.
60
63
  * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
61
- * @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.
64
+ * @description This method requires user authorization.
65
+ * @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}.
62
66
  */
63
67
  getOrderByMarkerAndId(marker: string, id: number, langCode?: string): Promise<IOrderByMarkerEntity | IError>;
64
68
  /**
65
69
  * Creation of an order in the order storage.
66
70
  * @handleName createOrder
67
71
  * @param {string} marker - Textual identifier of the order storage object. Example: "order_storage_1".
68
- * @param {IOrderData} body - Object for creating an order. Example:
72
+ * @param {IOrderData} body - Object for creating an order.
73
+ * @example
69
74
  {
70
75
  "formIdentifier": "bar-orders-form",
71
76
  "paymentAccountIdentifier": "usd-payment",
@@ -84,7 +89,8 @@ export default class OrdersApi extends AsyncModules implements IOrdersApi {
84
89
  * @param {string} [langCode] - Language code. Default: "en_US".
85
90
  * @returns {IBaseOrdersEntity} Returns an object with the created order.
86
91
  * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
87
- * @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.
92
+ * @description This method requires user authorization.
93
+ * @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}.
88
94
  */
89
95
  createOrder(marker: string, body: IOrderData, langCode?: string): Promise<IBaseOrdersEntity | IError>;
90
96
  /**
@@ -92,7 +98,8 @@ export default class OrdersApi extends AsyncModules implements IOrdersApi {
92
98
  * @handleName updateOrderByMarkerAndId
93
99
  * @param {string} marker - The text identifier of the order storage object. Example: "order_storage_1".
94
100
  * @param {number} id - ID of the order object. Example: 12345.
95
- * @param {IOrderData} body - Object for updating an order. Example:
101
+ * @param {IOrderData} body - Object for updating an order.
102
+ * @example
96
103
  {
97
104
  "formIdentifier": "bar-orders-form",
98
105
  "paymentAccountIdentifier": "usd-payment",
@@ -112,7 +119,8 @@ export default class OrdersApi extends AsyncModules implements IOrdersApi {
112
119
  * @param {string} [langCode] - Language code. Default: "en_US".
113
120
  * @returns {IBaseOrdersEntity} Returns an object with the updated order.
114
121
  * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
115
- * @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.
122
+ * @description This method requires user authorization.
123
+ * @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}.
116
124
  */
117
125
  updateOrderByMarkerAndId(marker: string, id: number, body: IOrderData, langCode?: string): Promise<IBaseOrdersEntity | IError>;
118
126
  }
@@ -28,7 +28,8 @@ class OrdersApi extends asyncModules_1.default {
28
28
  * @param {number} [limit] - Optional parameter for pagination. Default: 30.
29
29
  * @returns {IOrdersEntity[]} Returns an array of order storage objects.
30
30
  * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
31
- * @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.
31
+ * @description This method requires user authorization.
32
+ * @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}.
32
33
  */
33
34
  async getAllOrdersStorage(langCode = this.state.lang, offset = 0, limit = 30) {
34
35
  const result = await this._fetchGet(`?langCode=${langCode}&limit=${limit}&offset=${offset}`);
@@ -43,7 +44,8 @@ class OrdersApi extends asyncModules_1.default {
43
44
  * @param {number} [limit] - Limit parameter. Default: 30.
44
45
  * @returns {IOrdersByMarkerEntity} Returns an object with the orders.
45
46
  * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
46
- * @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.
47
+ * @description This method requires user authorization.
48
+ * @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}.
47
49
  */
48
50
  async getAllOrdersByMarker(marker, langCode = this.state.lang, offset = 0, limit = 30) {
49
51
  const result = await this._fetchGet(`/marker/${marker}/orders?langCode=${langCode}&limit=${limit}&offset=${offset}`);
@@ -56,7 +58,8 @@ class OrdersApi extends asyncModules_1.default {
56
58
  * @param {string} [langCode] - Language code. Default: "en_US".
57
59
  * @returns {IOrdersEntity} Return object of order information.
58
60
  * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
59
- * @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.
61
+ * @description This method requires user authorization.
62
+ * @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}.
60
63
  */
61
64
  async getOrderByMarker(marker, langCode = this.state.lang) {
62
65
  const result = await this._fetchGet(`/marker/${marker}?langCode=${langCode}`);
@@ -70,7 +73,8 @@ class OrdersApi extends asyncModules_1.default {
70
73
  * @param {string} [langCode] - Language code. Default: "en_US".
71
74
  * @returns {IOrderByMarkerEntity} Returns an object with the order.
72
75
  * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
73
- * @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.
76
+ * @description This method requires user authorization.
77
+ * @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}.
74
78
  */
75
79
  async getOrderByMarkerAndId(marker, id, langCode = this.state.lang) {
76
80
  const result = await this._fetchGet(`/marker/${marker}/orders/${id}?langCode=${langCode}`);
@@ -80,7 +84,8 @@ class OrdersApi extends asyncModules_1.default {
80
84
  * Creation of an order in the order storage.
81
85
  * @handleName createOrder
82
86
  * @param {string} marker - Textual identifier of the order storage object. Example: "order_storage_1".
83
- * @param {IOrderData} body - Object for creating an order. Example:
87
+ * @param {IOrderData} body - Object for creating an order.
88
+ * @example
84
89
  {
85
90
  "formIdentifier": "bar-orders-form",
86
91
  "paymentAccountIdentifier": "usd-payment",
@@ -99,7 +104,8 @@ class OrdersApi extends asyncModules_1.default {
99
104
  * @param {string} [langCode] - Language code. Default: "en_US".
100
105
  * @returns {IBaseOrdersEntity} Returns an object with the created order.
101
106
  * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
102
- * @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.
107
+ * @description This method requires user authorization.
108
+ * @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}.
103
109
  */
104
110
  async createOrder(marker, body, langCode = this.state.lang) {
105
111
  // eslint-disable-next-line @typescript-eslint/no-explicit-any
@@ -116,7 +122,8 @@ class OrdersApi extends asyncModules_1.default {
116
122
  * @handleName updateOrderByMarkerAndId
117
123
  * @param {string} marker - The text identifier of the order storage object. Example: "order_storage_1".
118
124
  * @param {number} id - ID of the order object. Example: 12345.
119
- * @param {IOrderData} body - Object for updating an order. Example:
125
+ * @param {IOrderData} body - Object for updating an order.
126
+ * @example
120
127
  {
121
128
  "formIdentifier": "bar-orders-form",
122
129
  "paymentAccountIdentifier": "usd-payment",
@@ -136,7 +143,8 @@ class OrdersApi extends asyncModules_1.default {
136
143
  * @param {string} [langCode] - Language code. Default: "en_US".
137
144
  * @returns {IBaseOrdersEntity} Returns an object with the updated order.
138
145
  * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
139
- * @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.
146
+ * @description This method requires user authorization.
147
+ * @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}.
140
148
  */
141
149
  async updateOrderByMarkerAndId(marker, id, body, langCode = this.state.lang) {
142
150
  // eslint-disable-next-line @typescript-eslint/no-explicit-any
@@ -19,7 +19,8 @@ interface IOrdersApi {
19
19
  * @param {number} [limit] - Optional parameter for pagination. Default: 30.
20
20
  * @returns {Promise<IOrdersEntity[] | IError>} Returns an array of order storage objects.
21
21
  * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
22
- * @description This method gets all the order storage objects.
22
+ * @description This method gets all the order storage objects. This method requires user authorization.
23
+ * @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}.
23
24
  */
24
25
  getAllOrdersStorage(langCode?: string, offset?: number, limit?: number): Promise<IOrdersEntity[] | IError>;
25
26
  /**
@@ -31,7 +32,8 @@ interface IOrdersApi {
31
32
  * @param {number} [limit] - Limit parameter. Default: 30.
32
33
  * @returns {Promise<IOrdersByMarkerEntity | IError>} Returns an object with the orders.
33
34
  * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
34
- * @description This method gets all orders from the orders storage object created by the user.
35
+ * @description This method gets all orders from the orders storage object created by the user. This method requires user authorization.
36
+ * @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}.
35
37
  */
36
38
  getAllOrdersByMarker(marker: string, langCode?: string, offset?: number, limit?: number): Promise<IOrdersByMarkerEntity | IError>;
37
39
  /**
@@ -41,7 +43,8 @@ interface IOrdersApi {
41
43
  * @param {string} [langCode] - Language code. Default: "en_US".
42
44
  * @returns {Promise<IOrdersEntity | IError>} Return object of order information.
43
45
  * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
44
- * @description This method retrieves one order storage object by marker.
46
+ * @description This method retrieves one order storage object by marker. This method requires user authorization.
47
+ * @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}.
45
48
  */
46
49
  getOrderByMarker(marker: string, langCode?: string): Promise<IOrdersEntity | IError>;
47
50
  /**
@@ -52,14 +55,16 @@ interface IOrdersApi {
52
55
  * @param {string} [langCode] - Language code. Default: "en_US".
53
56
  * @returns {Promise<IOrderByMarkerEntity | IError>} Returns an object with the order.
54
57
  * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
55
- * @description This method gets a single order from the order storage object created by the user.
58
+ * @description This method gets a single order from the order storage object created by the user. This method requires user authorization.
59
+ * @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}.
56
60
  */
57
61
  getOrderByMarkerAndId(marker: string, id: number, langCode?: string): Promise<IOrderByMarkerEntity | IError>;
58
62
  /**
59
63
  * Creation of an order in the order storage.
60
64
  * @handleName createOrder
61
65
  * @param {string} marker - Textual identifier of the order storage object. Example: "order_storage_1".
62
- * @param {IOrderData} body - Object for creating an order. Example:
66
+ * @param {IOrderData} body - Object for creating an order.
67
+ * @example
63
68
  {
64
69
  "formIdentifier": "bar-orders-form",
65
70
  "paymentAccountIdentifier": "usd-payment",
@@ -78,7 +83,8 @@ interface IOrdersApi {
78
83
  * @param {string} [langCode] - Language code. Default: "en_US".
79
84
  * @returns {Promise<IBaseOrdersEntity | IError>} Returns an object with the created order.
80
85
  * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
81
- * @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.
86
+ * @description This method requires user authorization.
87
+ * @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}.
82
88
  */
83
89
  createOrder(marker: string, body: IOrderData, langCode: string): Promise<IBaseOrdersEntity | IError>;
84
90
  /**
@@ -86,7 +92,8 @@ interface IOrdersApi {
86
92
  * @handleName updateOrderByMarkerAndId
87
93
  * @param {string} marker - The text identifier of the order storage object. Example: "order_storage_1".
88
94
  * @param {number} id - ID of the order object. Example: 12345.
89
- * @param {IOrderData} body - Object for updating an order. Example:
95
+ * @param {IOrderData} body - Object for updating an order.
96
+ * @example
90
97
  {
91
98
  "formIdentifier": "bar-orders-form",
92
99
  "paymentAccountIdentifier": "usd-payment",
@@ -106,14 +113,16 @@ interface IOrdersApi {
106
113
  * @param {string} [langCode] - Language code. Default: "en_US".
107
114
  * @returns {Promise<IBaseOrdersEntity | IError>} Returns an object with the updated order.
108
115
  * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
109
- * @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.
116
+ * @description This method requires user authorization.
117
+ * @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}.
110
118
  */
111
119
  updateOrderByMarkerAndId(marker: string, id: number, body: IOrderData, langCode?: string): Promise<IBaseOrdersEntity | IError>;
112
120
  }
113
121
  /**
114
122
  * Interface for the orders storage object.
115
123
  * @interface IOrdersByMarkerEntity
116
- * @property {IOrderByMarkerEntity[]} items - Array of order storage objects. Example:
124
+ * @property {IOrderByMarkerEntity[]} items - Array of order storage objects.
125
+ * @example
117
126
  [
118
127
  {
119
128
  "id": 55,
@@ -177,7 +186,8 @@ interface IPicture {
177
186
  * @property {number} quantity - Product quantity. Example: 1.
178
187
  * @property {string} title - Product title. Example: "Cosmo".
179
188
  * @property {string | null} sku - Product sku. Example: "SKU".
180
- * @property {any} previewImage - Product previewImage. Example:
189
+ * @property {any} previewImage - Product previewImage.
190
+ * @example
181
191
  {
182
192
  "filename": "image.jpg",
183
193
  "downloadLink": "https://example.com/image.jpg",
@@ -244,7 +254,8 @@ interface IOrderProductsData {
244
254
  * @property {number} id - Object identifier. Example: 1.
245
255
  * @property {string} formIdentifier - Text identifier of the form. Example: "bar-orders-form".
246
256
  * @property {string} paymentAccountIdentifier - Text identifier of the order payment. Example: "payment-1".
247
- * @property {IOrdersFormData[]} formData - Data submitted by the form linked to the order store. Example:
257
+ * @property {IOrdersFormData[]} formData - Data submitted by the form linked to the order store.
258
+ * @example
248
259
  [
249
260
  {
250
261
  "marker": "name_1",
@@ -252,7 +263,8 @@ interface IOrderProductsData {
252
263
  "type": "string"
253
264
  }
254
265
  ]
255
- * @property {IOrderProductsData[]} products - Array of products added to order. Example:
266
+ * @property {IOrderProductsData[]} products - Array of products added to order.
267
+ * @example
256
268
  [
257
269
  {
258
270
  "id": 2957,
@@ -282,7 +294,8 @@ interface IBaseOrdersEntity {
282
294
  /**
283
295
  * Interface representing a response from the order storage.
284
296
  * @interface IBaseOrdersEntityResponse
285
- * @property {IBaseOrdersEntity[]} items - Array of order storage objects. Example:
297
+ * @property {IBaseOrdersEntity[]} items - Array of order storage objects.
298
+ * @example
286
299
  [
287
300
  {
288
301
  "id": 2957,
@@ -338,7 +351,8 @@ interface IPaymentAccountIdentifiers {
338
351
  * @interface IOrderData
339
352
  * @property {string} formIdentifier - Text identifier of the form object linked to the order repository. Example: "bar-orders-form".
340
353
  * @property {string} paymentAccountIdentifier - Text identifier of the payment object linked to the order repository. Example: "payment-1".
341
- * @property {IOrdersFormData | IOrdersFormData[]} formData - Form data linked to the order repository. Example:
354
+ * @property {IOrdersFormData | IOrdersFormData[]} formData - Form data linked to the order repository.
355
+ * @example
342
356
  [
343
357
  {
344
358
  "marker": "name_1",
@@ -346,7 +360,7 @@ interface IPaymentAccountIdentifiers {
346
360
  "type": "string"
347
361
  }
348
362
  ]
349
- * @property {IOrderProductData[]} products - An array of ordered products. Example: .
363
+ * @property {IOrderProductData[]} products - An array of ordered products. Example: [].
350
364
  * @description Represents the data required to create or update an order in the order storage.
351
365
  */
352
366
  interface IOrderData {
@@ -363,7 +377,8 @@ interface IOrderData {
363
377
  * @property {string} createdDate - Date when the order was created. Example: "2023-10-01T12:00:00Z".
364
378
  * @property {string} [statusIdentifier] - Text identifier of the order status. Example: "order-status-1".
365
379
  * @property {string} [formIdentifier] - Text identifier of the form. Example: "bar-orders-form".
366
- * @property {IOrdersFormData[]} formData - Data submitted by the form linked to the order store. Example:
380
+ * @property {IOrdersFormData[]} formData - Data submitted by the form linked to the order store.
381
+ * @example
367
382
  [
368
383
  {
369
384
  "marker": "order_name",
@@ -375,8 +390,14 @@ interface IOrderData {
375
390
  * @property {string} totalSum - Total order amount. Example: "100.00".
376
391
  * @property {string} currency - Currency used to pay for the order. Example: "USD".
377
392
  * @property {string | null} [paymentAccountIdentifier] - Textual identifier for the order payment. Example: "payment-1".
378
- * @property {Record<string, any>} paymentAccountLocalizeInfos - Payment account name considering localization. Example: { "en_US": "USD Payment", "ru_RU": "Оплата в долларах США" }.
379
- * @property {IOrderProducts[]} products - Array of products added to order. Example:
393
+ * @property {Record<string, any>} paymentAccountLocalizeInfos - Payment account name considering localization.
394
+ * @example
395
+ {
396
+ "en_US": "USD Payment",
397
+ "ru_RU": "Оплата в долларах США"
398
+ }
399
+ * @property {IOrderProducts[]} products - Array of products added to order.
400
+ * @example
380
401
  [
381
402
  {
382
403
  "id": 1,
@@ -97,7 +97,8 @@ export default class PageApi extends AsyncModules implements IPageApi {
97
97
  /**
98
98
  * Add template data to pages
99
99
  * @handleName addTemplateToPages
100
- * @param {IPagesEntity[]} data - An array of page objects (IPagesEntity[]) to which template data will be added. Example:
100
+ * @param {IPagesEntity[]} data - An array of page objects (IPagesEntity[]) to which template data will be added.
101
+ * @example
101
102
  [
102
103
  {
103
104
  "id": 8,
@@ -245,7 +245,8 @@ class PageApi extends asyncModules_1.default {
245
245
  /**
246
246
  * Add template data to pages
247
247
  * @handleName addTemplateToPages
248
- * @param {IPagesEntity[]} data - An array of page objects (IPagesEntity[]) to which template data will be added. Example:
248
+ * @param {IPagesEntity[]} data - An array of page objects (IPagesEntity[]) to which template data will be added.
249
+ * @example
249
250
  [
250
251
  {
251
252
  "id": 8,
@@ -112,7 +112,8 @@ interface IPageConfig {
112
112
  * @property {ILocalizeInfo} localizeInfos - The name of the page, taking into account localization. Example:
113
113
  * @property {object} processingData - Form data. Example: {}.
114
114
  * @property {number} position - The position of the object. Example: 0.
115
- * @property {IAttributes[]} attributes - Array of attribute values from the used attribute set for displaying the form (taking into account the specified language). Example:
115
+ * @property {IAttributes[]} attributes - Array of attribute values from the used attribute set for displaying the form (taking into account the specified language).
116
+ * @example
116
117
  [
117
118
  {
118
119
  "type": "list",
@@ -164,7 +165,8 @@ interface IPositionForm {
164
165
  * @property {string | null} templateIdentifier - User id of the linked template. Example: null.
165
166
  * @property {boolean} isVisible - A sign of page visibility. Example: true.
166
167
  * @property {boolean} isSync - Indication of page indexing. Example: false.
167
- * @property {AttributeType} attributeValues - Array of attribute values from the index (represented as a pair of user attribute id: attribute value). Example:
168
+ * @property {AttributeType} attributeValues - Array of attribute values from the index (represented as a pair of user attribute id: attribute value).
169
+ * @example
168
170
  {
169
171
  "block-text": {
170
172
  "type": "string",
@@ -212,7 +214,8 @@ interface IPositionBlock {
212
214
  * @property {Types} type - Page type. Example: "common_page".
213
215
  * @property {string | null} templateIdentifier - User id of the linked template. Example: "template".
214
216
  * @property {string | null} attributeSetIdentifier - Set of attributes id. Example: "page".
215
- * @property {AttributeType} attributeValues - Array of attribute values from the index (represented as a pair of user attribute id: attribute value). Example:
217
+ * @property {AttributeType} attributeValues - Array of attribute values from the index (represented as a pair of user attribute id: attribute value).
218
+ * @example
216
219
  {
217
220
  "text": {
218
221
  "type": "string",
@@ -224,14 +227,16 @@ interface IPositionBlock {
224
227
  * @property {boolean} isSync - Indication of page indexing. Example: true.
225
228
  * @property {any} [template] - Template object. Example:
226
229
  * @property {number} [position] - Item number (for sorting). Example: 2.
227
- * @property {any} [config] - Output settings for catalog pages. Example:
230
+ * @property {any} [config] - Output settings for catalog pages.
231
+ * @example
228
232
  {
229
233
  "rowsPerPage": 1,
230
234
  "productsPerRow": 1
231
235
  }
232
236
  * @property {number} [products] - The number of products linked to the page. Example: 0.
233
237
  * @property {number} [childrenCount] - Children count. Example: 1.
234
- * @property {any} [blocks] - blocks. Example:
238
+ * @property {any} [blocks] - blocks.
239
+ * @example
235
240
  {
236
241
  "id": 4,
237
242
  "attributeSetIdentifier": null,