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
package/README.md CHANGED
@@ -97,6 +97,7 @@ const api = defineOneEntry('https://my-project.oneentry.cloud', {
97
97
  auth: {
98
98
  refreshToken: localStorage.getItem('refreshToken'),
99
99
  saveFunction: tokenFunction,
100
+ providerMarker: 'email',
100
101
  },
101
102
  })
102
103
  ```
@@ -110,6 +111,7 @@ const api = defineOneEntry('https://my-project.oneentry.cloud', {
110
111
  auth: {
111
112
  customAuth: true,
112
113
  refreshToken: localStorage.getItem('refreshToken'),
114
+ providerMarker: 'email',
113
115
  },
114
116
  })
115
117
  ```
@@ -147,6 +149,7 @@ const api = defineOneEntry('your-url', {
147
149
  auth: {
148
150
  customAuth: false,
149
151
  userToken: 'rerfesh.token',
152
+ providerMarker: 'email',
150
153
  saveFunction: saveTokenFromLocalStorage,
151
154
  },
152
155
  })
@@ -23,7 +23,8 @@ export default class AdminsApi extends AsyncModules implements IAdmins {
23
23
  /**
24
24
  * Get all admins objects with filters.
25
25
  * @handleName getAdminsInfo
26
- * @param {AttributeType[]} body - Array of filter objects with search conditions. Default: []. Example:
26
+ * @param {AttributeType[]} [body] - Array of filter objects with search conditions. Default: [].
27
+ * @example
27
28
  [
28
29
  {
29
30
  "attributeMarker": "num",
@@ -36,15 +37,14 @@ export default class AdminsApi extends AsyncModules implements IAdmins {
36
37
  "conditionValue": 3
37
38
  }
38
39
  ]
39
- * @param {string} body.attributeMarker - Text identifier (marker) of the attribute in the set. Example: "num".
40
- * @param {string} body.conditionMarker - Text identifier (marker) of the condition in the set. Example: "mth".
41
- * @param {string} body.conditionValue - Value of the condition. Example: 1.
42
- * @param {string} langCode - Language code. Default: "en_US".
43
- * @param {number} offset - Parameter for pagination. Default: 0.
44
- * @param {number} limit - Parameter for pagination. Default: 30.
40
+ * @param {string} [body.attributeMarker] - Text identifier (marker) of the attribute in the set. Example: "num".
41
+ * @param {string} [body.conditionMarker] - Text identifier (marker) of the condition in the set. Example: "mth".
42
+ * @param {string} [body.conditionValue] - Value of the condition. Example: 1.
43
+ * @param {string} [langCode] - Language code. Default: "en_US".
44
+ * @param {number} [offset] - Parameter for pagination. Default: 0.
45
+ * @param {number} [limit] - Parameter for pagination. Default: 30.
45
46
  * @returns {IAdminEntity[]} Returns an array of admin objects.
46
47
  * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
47
- * @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.
48
48
  */
49
49
  getAdminsInfo(body?: AttributeType[], langCode?: string, offset?: number, limit?: number): Promise<IAdminEntity[] | IError>;
50
50
  }
@@ -26,7 +26,8 @@ class AdminsApi extends asyncModules_1.default {
26
26
  /**
27
27
  * Get all admins objects with filters.
28
28
  * @handleName getAdminsInfo
29
- * @param {AttributeType[]} body - Array of filter objects with search conditions. Default: []. Example:
29
+ * @param {AttributeType[]} [body] - Array of filter objects with search conditions. Default: [].
30
+ * @example
30
31
  [
31
32
  {
32
33
  "attributeMarker": "num",
@@ -39,15 +40,14 @@ class AdminsApi extends asyncModules_1.default {
39
40
  "conditionValue": 3
40
41
  }
41
42
  ]
42
- * @param {string} body.attributeMarker - Text identifier (marker) of the attribute in the set. Example: "num".
43
- * @param {string} body.conditionMarker - Text identifier (marker) of the condition in the set. Example: "mth".
44
- * @param {string} body.conditionValue - Value of the condition. Example: 1.
45
- * @param {string} langCode - Language code. Default: "en_US".
46
- * @param {number} offset - Parameter for pagination. Default: 0.
47
- * @param {number} limit - Parameter for pagination. Default: 30.
43
+ * @param {string} [body.attributeMarker] - Text identifier (marker) of the attribute in the set. Example: "num".
44
+ * @param {string} [body.conditionMarker] - Text identifier (marker) of the condition in the set. Example: "mth".
45
+ * @param {string} [body.conditionValue] - Value of the condition. Example: 1.
46
+ * @param {string} [langCode] - Language code. Default: "en_US".
47
+ * @param {number} [offset] - Parameter for pagination. Default: 0.
48
+ * @param {number} [limit] - Parameter for pagination. Default: 30.
48
49
  * @returns {IAdminEntity[]} Returns an array of admin objects.
49
50
  * @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.
51
51
  */
52
52
  async getAdminsInfo(body = [], langCode = this.state.lang, offset = 0, limit = 30) {
53
53
  const query = {
@@ -8,19 +8,20 @@ interface IAdmins {
8
8
  /**
9
9
  * Get all admins objects with filters.
10
10
  * @handleName getAdminsInfo
11
- * @param {AttributeType[]} [body] - Array of filter objects with search conditions. Default: []. Example:
12
- [
13
- {
14
- "attributeMarker": "num",
15
- "conditionMarker": "mth",
16
- "conditionValue": 1
17
- },
18
- {
19
- "attributeMarker": "num",
20
- "conditionMarker": "lth",
21
- "conditionValue": 3
22
- }
23
- ]
11
+ * @param {AttributeType[]} [body] - Array of filter objects with search conditions. Default: [].
12
+ * @example
13
+ [
14
+ {
15
+ "attributeMarker": "num",
16
+ "conditionMarker": "mth",
17
+ "conditionValue": 1
18
+ },
19
+ {
20
+ "attributeMarker": "num",
21
+ "conditionMarker": "lth",
22
+ "conditionValue": 3
23
+ }
24
+ ]
24
25
  * @param {string} [body.attributeMarker] - Text identifier (marker) of the attribute in the set. Example: "num".
25
26
  * @param {string} [body.conditionMarker] - Text identifier (marker) of the condition in the set. Example: "mth".
26
27
  * @param {string} [body.conditionValue] - Value of the condition. Example: 1.
@@ -29,7 +30,6 @@ interface IAdmins {
29
30
  * @param {number} [limit] - Parameter for pagination. Default: 30.
30
31
  * @returns {IAdminEntity[]} Returns an array of admin objects.
31
32
  * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
32
- * @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.
33
33
  */
34
34
  getAdminsInfo(body: AttributeType[], langCode: string, offset: number, limit: number): Promise<IAdminEntity[] | IError>;
35
35
  }
@@ -61,7 +61,8 @@ interface IPosition {
61
61
  * @property {string | null} attributeSetIdentifier - The identifier of the attribute set. Example: "admins".
62
62
  * @property {number | null} position - Position number (for sorting). Example: 1.
63
63
  * @property {boolean} isSync - Page indexing flag (true or false). Example: true.
64
- * @property {IAttributeValues} attributeValues - Array of attribute values from the index (presented as a pair of user attribute identifier: attribute value). Example:
64
+ * @property {IAttributeValues} attributeValues - Array of attribute values from the index (presented as a pair of user attribute identifier: attribute value).
65
+ * @example
65
66
  [
66
67
  {
67
68
  "marker": {
@@ -30,7 +30,6 @@ export default class AttributesSetsApi extends AsyncModules implements IAttribut
30
30
  * @param {string} [sortBy] - identifier of the attribute set type. Default: "id".
31
31
  * @returns {IAttributesSetsResponse} Returns object with array of IAttributeSetsEntity and total items count.
32
32
  * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
33
- * @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.
34
33
  */
35
34
  getAttributes(langCode?: string, offset?: number, limit?: number, typeId?: any, sortBy?: string): Promise<IAttributesSetsResponse | IError>;
36
35
  /**
@@ -40,7 +39,6 @@ export default class AttributesSetsApi extends AsyncModules implements IAttribut
40
39
  * @param {string} [langCode] - Language code. Default: "en_US".
41
40
  * @returns {IAttributeSetsEntity[]} Returns an array of Attributes objects.
42
41
  * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
43
- * @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.
44
42
  */
45
43
  getAttributesByMarker(marker: string, langCode?: string): Promise<IAttributeSetsEntity[] | IError>;
46
44
  /**
@@ -51,7 +49,6 @@ export default class AttributesSetsApi extends AsyncModules implements IAttribut
51
49
  * @param {string} [langCode] - Language code. Default: "en_US".
52
50
  * @returns {IAttributesSetsEntity} Returns a single attribute object from the attribute set.
53
51
  * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
54
- * @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.
55
52
  */
56
53
  getSingleAttributeByMarkerSet(setMarker: string, attributeMarker: string, langCode?: string): Promise<IAttributesSetsEntity | IError>;
57
54
  /**
@@ -61,7 +58,6 @@ export default class AttributesSetsApi extends AsyncModules implements IAttribut
61
58
  * @param {string} [langCode] - Language code. Default: "en_US".
62
59
  * @returns {IAttributeSetsEntity} Returns one object of the attribute set.
63
60
  * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
64
- * @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.
65
61
  */
66
62
  getAttributeSetByMarker(marker: string, langCode?: string): Promise<IAttributeSetsEntity | IError>;
67
63
  }
@@ -33,7 +33,6 @@ class AttributesSetsApi extends asyncModules_1.default {
33
33
  * @param {string} [sortBy] - identifier of the attribute set type. Default: "id".
34
34
  * @returns {IAttributesSetsResponse} Returns object with array of IAttributeSetsEntity and total items count.
35
35
  * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
36
- * @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.
37
36
  */
38
37
  async getAttributes(langCode = this.state.lang, offset = 0, limit = 30,
39
38
  // eslint-disable-next-line @typescript-eslint/no-explicit-any
@@ -56,7 +55,6 @@ class AttributesSetsApi extends asyncModules_1.default {
56
55
  * @param {string} [langCode] - Language code. Default: "en_US".
57
56
  * @returns {IAttributeSetsEntity[]} Returns an array of Attributes objects.
58
57
  * @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.
60
58
  */
61
59
  async getAttributesByMarker(marker, langCode = this.state.lang) {
62
60
  const result = await this._fetchGet(`/${marker}/attributes?langCode=${langCode}`);
@@ -70,7 +68,6 @@ class AttributesSetsApi extends asyncModules_1.default {
70
68
  * @param {string} [langCode] - Language code. Default: "en_US".
71
69
  * @returns {IAttributesSetsEntity} Returns a single attribute object from the attribute set.
72
70
  * @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.
74
71
  */
75
72
  async getSingleAttributeByMarkerSet(setMarker, attributeMarker, langCode = this.state.lang) {
76
73
  const result = await this._fetchGet(`/${setMarker}/attributes/${attributeMarker}?langCode=${langCode}`);
@@ -83,7 +80,6 @@ class AttributesSetsApi extends asyncModules_1.default {
83
80
  * @param {string} [langCode] - Language code. Default: "en_US".
84
81
  * @returns {IAttributeSetsEntity} Returns one object of the attribute set.
85
82
  * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
86
- * @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.
87
83
  */
88
84
  async getAttributeSetByMarker(marker, langCode = this.state.lang) {
89
85
  const result = await this._fetchGet(`/marker/${marker}?langCode=${langCode}`);
@@ -62,33 +62,36 @@ type AttributeType = 'string' | 'text' | 'textWithHeader' | 'integer' | 'real' |
62
62
  * @property {any} [value] - Value of the attribute, which can be of any type.
63
63
  * @property {string} marker - Textual identifier of the attribute (marker). Example: "color", "size", "etc".
64
64
  * @property {number} position - Position number for sorting. Example: 1.
65
- * @property {IListTitle[] | Record<string, any>} [listTitles] - Array of values (with extended data) for list and radioButton attributes. Example:
66
- [
67
- {
68
- "title": "red",
69
- "value": 1,
70
- "position": 1,
71
- "extendedValue": null,
72
- "extendedValueType": null
73
- },
74
- {
75
- "title": "yellow",
76
- "value": 2,
77
- "position": 2,
78
- "extendedValue": null,
79
- "extendedValueType": null
80
- }
81
- ]
82
- * @property {Record<string, any>} [validators] - Set of validators for validation. Example:
83
- {
84
- "requiredValidator": {
85
- "strict": true
86
- },
87
- "defaultValueValidator": {
88
- "fieldDefaultValue": 11
89
- }
90
- }
91
- * @property {ILocalizeInfo} localizeInfos - The name of the template, taking into account localization. Example:
65
+ * @property {IListTitle[] | Record<string, any>} [listTitles] - Array of values (with extended data) for list and radioButton attributes.
66
+ * @example
67
+ [
68
+ {
69
+ "title": "red",
70
+ "value": 1,
71
+ "position": 1,
72
+ "extendedValue": null,
73
+ "extendedValueType": null
74
+ },
75
+ {
76
+ "title": "yellow",
77
+ "value": 2,
78
+ "position": 2,
79
+ "extendedValue": null,
80
+ "extendedValueType": null
81
+ }
82
+ ]
83
+ * @property {Record<string, any>} [validators] - Set of validators for validation.
84
+ * @example
85
+ {
86
+ "requiredValidator": {
87
+ "strict": true
88
+ },
89
+ "defaultValueValidator": {
90
+ "fieldDefaultValue": 11
91
+ }
92
+ }
93
+ * @property {ILocalizeInfo} localizeInfos - The name of the template, taking into account localization.
94
+ * @example
92
95
  {
93
96
  "title": "My attribute"
94
97
  }
@@ -116,7 +119,8 @@ interface IAttributesSetsEntity {
116
119
  * @property {string} identifier - A string that uniquely identifies the attribute set. Example: "attributeSet1".
117
120
  * @property {number} typeId - The numerical identifier representing the type of the attribute set. Example: 1.
118
121
  * @property {string} title - The title or name of the attribute set. Example: "Product Attributes".
119
- * @property {object} schema - The schema definition associated with the attribute set. This could represent the structure or rules for the data. Example:
122
+ * @property {object} schema - The schema definition associated with the attribute set. This could represent the structure or rules for the data.
123
+ * @example
120
124
  {
121
125
  "attribute1": {
122
126
  "id": 1,
@@ -130,7 +134,8 @@ interface IAttributesSetsEntity {
130
134
  }
131
135
  }
132
136
  * @property {boolean} isVisible - Indicates whether the attribute set is visible or not. Example: true.
133
- * @property {object} properties - Additional properties associated with the attribute set, which can be of any type. Example:
137
+ * @property {object} properties - Additional properties associated with the attribute set, which can be of any type.
138
+ * @example
134
139
  {
135
140
  "color": "red",
136
141
  "size": "M"
@@ -141,6 +146,7 @@ interface IAttributesSetsEntity {
141
146
  */
142
147
  interface IAttributeSetsEntity {
143
148
  id: number;
149
+ createdDate: string;
144
150
  updatedDate: string;
145
151
  version: number;
146
152
  identifier: string;
@@ -149,15 +155,19 @@ interface IAttributeSetsEntity {
149
155
  schema: object;
150
156
  isVisible: boolean;
151
157
  properties: object;
152
- type: string;
158
+ type: {
159
+ id: number;
160
+ type: string;
161
+ };
153
162
  position: number;
154
163
  }
155
164
  /**
156
165
  * Represents the response structure for attribute sets.
157
166
  * @interface IAttributesSetsResponse
158
167
  * @property {number} total - Total items. Example: 100.
159
- * @property {IAttributeSetsEntity[]} items - IAttributeSetsEntity array containing attribute set entities. Example:
160
- [
168
+ * @property {IAttributeSetsEntity[]} items - IAttributeSetsEntity array containing attribute set entities.
169
+ * @example
170
+ [
161
171
  {
162
172
  "id": 1,
163
173
  "identifier": "set1"
@@ -21,7 +21,8 @@ export default class AuthProviderApi extends AsyncModules implements IAuthProvid
21
21
  * User registration.
22
22
  * @handleName signUp
23
23
  * @param {string} marker - The text identifier of the authorization provider. Example: "email".
24
- * @param {ISignUpData} body - Request body. Example:
24
+ * @param {ISignUpData} body - Request body.
25
+ * @example
25
26
  {
26
27
  "formIdentifier": "reg",
27
28
  "authData": [
@@ -48,7 +49,8 @@ export default class AuthProviderApi extends AsyncModules implements IAuthProvid
48
49
  }
49
50
  }
50
51
  * @param {string} body.formIdentifier - The identifier for the registration form. Example: "reg".
51
- * @param {{ marker: string; value: string }[]} body.authData - An array of authentication data objects, each containing a marker and its corresponding value. Example:
52
+ * @param {{ marker: string; value: string }[]} body.authData - An array of authentication data objects, each containing a marker and its corresponding value.
53
+ * @example
52
54
  [
53
55
  {
54
56
  "marker": "login",
@@ -59,13 +61,15 @@ export default class AuthProviderApi extends AsyncModules implements IAuthProvid
59
61
  "value": "12345"
60
62
  }
61
63
  ]
62
- * @param {IAuthFormData} body.formData - The form data for the registration, which can be a single object or an array of objects. Example:
64
+ * @param {IAuthFormData} body.formData - The form data for the registration, which can be a single object or an array of objects.
65
+ * @example
63
66
  {
64
67
  "marker": "last_name",
65
68
  "type": "string",
66
69
  "value": "Name"
67
70
  }
68
- * @param {object} body.notificationData - An object containing notification data, including email, phonePush, and phoneSMS. Example:
71
+ * @param {object} body.notificationData - An object containing notification data, including email, phonePush, and phoneSMS.
72
+ * @example
69
73
  {
70
74
  "email": "example@oneentry.cloud",
71
75
  "phonePush": ["+99999999999"],
@@ -115,7 +119,8 @@ export default class AuthProviderApi extends AsyncModules implements IAuthProvid
115
119
  * User authorization.
116
120
  * @handleName auth
117
121
  * @param {string} marker - The text identifier of the authorization provider. Example: "email".
118
- * @param {IAuthPostBody} body - Objects contains auth information. Example:
122
+ * @param {IAuthPostBody} body - Objects contains auth information.
123
+ * @example
119
124
  {
120
125
  "authData": [
121
126
  {
@@ -128,7 +133,8 @@ export default class AuthProviderApi extends AsyncModules implements IAuthProvid
128
133
  }
129
134
  ]
130
135
  }
131
- * @param {{ marker: string; value: string | number }[]} body.authData - An array of authentication data objects, each containing a marker and its corresponding value. Example:
136
+ * @param {{ marker: string; value: string | number }[]} body.authData - An array of authentication data objects, each containing a marker and its corresponding value.
137
+ * @example
132
138
  [
133
139
  {
134
140
  "marker": "login",
@@ -159,7 +165,8 @@ export default class AuthProviderApi extends AsyncModules implements IAuthProvid
159
165
  * @param {string} token - Refresh token. Example: "abcdef123456".
160
166
  * @returns {boolean} Returns true if the logout was successful, or an error object if there was an issue.
161
167
  * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
162
- * @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.
168
+ * @description This method requires user authorization.
169
+ * @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}.
163
170
  */
164
171
  logout(marker: string, token: string): Promise<boolean | IError>;
165
172
  /**
@@ -168,7 +175,8 @@ export default class AuthProviderApi extends AsyncModules implements IAuthProvid
168
175
  * @param {string} marker - The text identifier of the authorization provider. Example: "email".
169
176
  * @returns {boolean} Returns true if the logout was successful, or an error object if there was an issue.
170
177
  * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
171
- * @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.
178
+ * @description This method requires user authorization.
179
+ * @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
180
  */
173
181
  logoutAll(marker: string): Promise<boolean | IError>;
174
182
  /**
@@ -209,7 +217,7 @@ export default class AuthProviderApi extends AsyncModules implements IAuthProvid
209
217
  getAuthProviderByMarker(marker: string, langCode?: string): Promise<IAuthProvidersEntity | IError>;
210
218
  /**
211
219
  * Getting active user sessions data.
212
- * @handleName getActiveSessions
220
+ * @handleName getActiveSessionsByMarker
213
221
  * @param {string} marker - The text identifier of the authorization provider. Example: "email".
214
222
  * @returns {IActiveSession[]} Returns an auth provider object.
215
223
  * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
@@ -220,7 +228,8 @@ export default class AuthProviderApi extends AsyncModules implements IAuthProvid
220
228
  * User registration (authorization) via OAUTH.
221
229
  * @handleName oauthSignUp
222
230
  * @param {string} marker - The text identifier of the authorization provider. Example: "email".
223
- * @param {IOAuthSignUpData} body - Object contains OAuth information for registration. Example:
231
+ * @param {IOAuthSignUpData} body - Object contains OAuth information for registration.
232
+ * @example
224
233
  {
225
234
  "client_id": "34346983-luuct343473qdkqidjopdfp3eb3k4thp.apps.googleusercontent.com",
226
235
  "client_secret": "43434343434",
@@ -25,7 +25,8 @@ class AuthProviderApi extends asyncModules_1.default {
25
25
  * User registration.
26
26
  * @handleName signUp
27
27
  * @param {string} marker - The text identifier of the authorization provider. Example: "email".
28
- * @param {ISignUpData} body - Request body. Example:
28
+ * @param {ISignUpData} body - Request body.
29
+ * @example
29
30
  {
30
31
  "formIdentifier": "reg",
31
32
  "authData": [
@@ -52,7 +53,8 @@ class AuthProviderApi extends asyncModules_1.default {
52
53
  }
53
54
  }
54
55
  * @param {string} body.formIdentifier - The identifier for the registration form. Example: "reg".
55
- * @param {{ marker: string; value: string }[]} body.authData - An array of authentication data objects, each containing a marker and its corresponding value. Example:
56
+ * @param {{ marker: string; value: string }[]} body.authData - An array of authentication data objects, each containing a marker and its corresponding value.
57
+ * @example
56
58
  [
57
59
  {
58
60
  "marker": "login",
@@ -63,13 +65,15 @@ class AuthProviderApi extends asyncModules_1.default {
63
65
  "value": "12345"
64
66
  }
65
67
  ]
66
- * @param {IAuthFormData} body.formData - The form data for the registration, which can be a single object or an array of objects. Example:
68
+ * @param {IAuthFormData} body.formData - The form data for the registration, which can be a single object or an array of objects.
69
+ * @example
67
70
  {
68
71
  "marker": "last_name",
69
72
  "type": "string",
70
73
  "value": "Name"
71
74
  }
72
- * @param {object} body.notificationData - An object containing notification data, including email, phonePush, and phoneSMS. Example:
75
+ * @param {object} body.notificationData - An object containing notification data, including email, phonePush, and phoneSMS.
76
+ * @example
73
77
  {
74
78
  "email": "example@oneentry.cloud",
75
79
  "phonePush": ["+99999999999"],
@@ -145,7 +149,8 @@ class AuthProviderApi extends asyncModules_1.default {
145
149
  * User authorization.
146
150
  * @handleName auth
147
151
  * @param {string} marker - The text identifier of the authorization provider. Example: "email".
148
- * @param {IAuthPostBody} body - Objects contains auth information. Example:
152
+ * @param {IAuthPostBody} body - Objects contains auth information.
153
+ * @example
149
154
  {
150
155
  "authData": [
151
156
  {
@@ -158,7 +163,8 @@ class AuthProviderApi extends asyncModules_1.default {
158
163
  }
159
164
  ]
160
165
  }
161
- * @param {{ marker: string; value: string | number }[]} body.authData - An array of authentication data objects, each containing a marker and its corresponding value. Example:
166
+ * @param {{ marker: string; value: string | number }[]} body.authData - An array of authentication data objects, each containing a marker and its corresponding value.
167
+ * @example
162
168
  [
163
169
  {
164
170
  "marker": "login",
@@ -207,7 +213,8 @@ class AuthProviderApi extends asyncModules_1.default {
207
213
  * @param {string} token - Refresh token. Example: "abcdef123456".
208
214
  * @returns {boolean} Returns true if the logout was successful, or an error object if there was an issue.
209
215
  * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
210
- * @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.
216
+ * @description This method requires user authorization.
217
+ * @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}.
211
218
  */
212
219
  async logout(marker, token) {
213
220
  const data = {
@@ -229,7 +236,8 @@ class AuthProviderApi extends asyncModules_1.default {
229
236
  * @param {string} marker - The text identifier of the authorization provider. Example: "email".
230
237
  * @returns {boolean} Returns true if the logout was successful, or an error object if there was an issue.
231
238
  * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
232
- * @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.
239
+ * @description This method requires user authorization.
240
+ * @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}.
233
241
  */
234
242
  async logoutAll(marker) {
235
243
  const result = await this._fetchPost(`/marker/${marker}/users/logout-all`);
@@ -297,7 +305,7 @@ class AuthProviderApi extends asyncModules_1.default {
297
305
  }
298
306
  /**
299
307
  * Getting active user sessions data.
300
- * @handleName getActiveSessions
308
+ * @handleName getActiveSessionsByMarker
301
309
  * @param {string} marker - The text identifier of the authorization provider. Example: "email".
302
310
  * @returns {IActiveSession[]} Returns an auth provider object.
303
311
  * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
@@ -311,7 +319,8 @@ class AuthProviderApi extends asyncModules_1.default {
311
319
  * User registration (authorization) via OAUTH.
312
320
  * @handleName oauthSignUp
313
321
  * @param {string} marker - The text identifier of the authorization provider. Example: "email".
314
- * @param {IOAuthSignUpData} body - Object contains OAuth information for registration. Example:
322
+ * @param {IOAuthSignUpData} body - Object contains OAuth information for registration.
323
+ * @example
315
324
  {
316
325
  "client_id": "34346983-luuct343473qdkqidjopdfp3eb3k4thp.apps.googleusercontent.com",
317
326
  "client_secret": "43434343434",
@@ -21,7 +21,8 @@ interface IAuthProvider {
21
21
  * Registers a new user.
22
22
  * @handleName signUp
23
23
  * @param {string} marker - The marker identifying the auth provider. Example: "email".
24
- * @param {ISignUpData} data - The data required for user registration. Example:
24
+ * @param {ISignUpData} data - The data required for user registration.
25
+ * @example
25
26
  {
26
27
  "formIdentifier": "reg",
27
28
  "authData": [
@@ -175,7 +176,8 @@ interface IAuthProvider {
175
176
  * User registration (authorization) via OAUTH.
176
177
  * @handleName oauthSignUp
177
178
  * @param {string} marker - The text identifier of the authorization provider. Example: "email".
178
- * @param {IOAuthSignUpData} body - Object contains OAuth information for registration. Example:
179
+ * @param {IOAuthSignUpData} body - Object contains OAuth information for registration.
180
+ * @example
179
181
  {
180
182
  "client_id": "34346983-luuct343473qdkqidjopdfp3eb3k4thp.apps.googleusercontent.com",
181
183
  "client_secret": "43434343434",
@@ -207,7 +209,8 @@ interface IAuthFormData {
207
209
  * Interface representing the data required for user registration.
208
210
  * @interface ISignUpData
209
211
  * @property {string} marker - The text identifier of the authorization provider. Example: "email".
210
- * @property {ISignUpData} body - Request body. Example:
212
+ * @property {ISignUpData} body - Request body.
213
+ * @example
211
214
  {
212
215
  "formIdentifier": "reg",
213
216
  "authData": [
@@ -234,7 +237,8 @@ interface IAuthFormData {
234
237
  }
235
238
  }
236
239
  * @property {string} body.formIdentifier - The identifier for the registration form. Example: "reg".
237
- * @property {{ marker: string; value: string }[]} body.authData - An array of authentication data objects, each containing a marker and its corresponding value. Example:
240
+ * @property {{ marker: string; value: string }[]} body.authData - An array of authentication data objects, each containing a marker and its corresponding value.
241
+ * @example
238
242
  [
239
243
  {
240
244
  "marker": "login",
@@ -245,13 +249,15 @@ interface IAuthFormData {
245
249
  "value": "12345"
246
250
  }
247
251
  ]
248
- * @property {IAuthFormData | IAuthFormData[]} body.formData - The form data for the registration, which can be a single object or an array of objects. Example:
252
+ * @property {IAuthFormData | IAuthFormData[]} body.formData - The form data for the registration, which can be a single object or an array of objects.
253
+ * @example
249
254
  {
250
255
  "marker": "last_name",
251
256
  "type": "string",
252
257
  "value": "Name"
253
258
  }
254
- * @property {object} body.notificationData - An object containing notification data, including email, phonePush, and phoneSMS. Example:
259
+ * @property {object} body.notificationData - An object containing notification data, including email, phonePush, and phoneSMS.
260
+ * @example
255
261
  {
256
262
  "email": "example@oneentry.cloud",
257
263
  "phonePush": ["+99999999999"],
@@ -299,7 +305,8 @@ interface IOAuthSignUpData {
299
305
  * @property {number} version - The version number of the sign-up entity. Example: 1.
300
306
  * @property {string} identifier - A unique string that identifies the sign-up entity. Example: "signup_12345".
301
307
  * @property {boolean} isActive - Indicates whether the sign-up entity is active. Example: true.
302
- * @property {{ marker: string; value: string }[]} formData - An array of objects representing the form data, each containing a marker and its corresponding value. Example:
308
+ * @property {{ marker: string; value: string }[]} formData - An array of objects representing the form data, each containing a marker and its corresponding value.
309
+ * @example
303
310
  [
304
311
  {
305
312
  "marker": "first_name",
@@ -310,7 +317,8 @@ interface IOAuthSignUpData {
310
317
  "value": "Doe"
311
318
  }
312
319
  ]
313
- * @property {object} notificationData - An object containing notification data, including email, phonePush, and phoneSMS. Example:
320
+ * @property {object} notificationData - An object containing notification data, including email, phonePush, and phoneSMS.
321
+ * @example
314
322
  {
315
323
  "email": "example@oneentry.cloud",
316
324
  "phonePush": ["+99999999999"],
@@ -410,7 +418,8 @@ interface IAuthProvidersEntityConfig {
410
418
  /**
411
419
  * Interface representing the body used in authentication requests.
412
420
  * @interface IAuthPostBody
413
- * @property {{ marker: string; value: string | number }[]} authData - An array of authentication data objects, each containing a marker and its corresponding value. Example:
421
+ * @property {{ marker: string; value: string | number }[]} authData - An array of authentication data objects, each containing a marker and its corresponding value.
422
+ * @example
414
423
  [
415
424
  {
416
425
  "marker": "login",
@@ -428,9 +437,16 @@ interface IAuthPostBody {
428
437
  /**
429
438
  * Interface representing the active session data.
430
439
  * @interface IActiveSession
431
- * @property {string} os - The operating system of the active session. Example: "Win32".
432
- * @property {string} browser - The browser used in the active session. Example: "Node.js/22".
433
- * @property {string} location - The location of the active session. Example: "ru-RU".
440
+ * @property {object} deviceInfo - Information about the device used in the active session.
441
+ * @example
442
+ {
443
+ "os": "Win32",
444
+ "browser": "Node.js/22",
445
+ "location": "ru-RU"
446
+ }
447
+ * @property {string} deviceInfo.os - The operating system of the active session. Example: "Win32".
448
+ * @property {string} deviceInfo.browser - The browser used in the active session. Example: "Node.js/22".
449
+ * @property {string} deviceInfo.location - The location of the active session. Example: "ru-RU".
434
450
  * @description This interface defines the structure of the body used in authentication requests, containing an array of authentication data.
435
451
  */
436
452
  interface IActiveSession {