@wix/auto_sdk_ecom_tip-settings 1.0.0 → 1.0.2

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 (25) hide show
  1. package/build/cjs/src/tips-settings-v1-tip-settings-tip-settings.public.d.ts +1 -1
  2. package/build/cjs/src/tips-settings-v1-tip-settings-tip-settings.types.d.ts +102 -42
  3. package/build/cjs/src/tips-settings-v1-tip-settings-tip-settings.types.js.map +1 -1
  4. package/build/cjs/src/tips-settings-v1-tip-settings-tip-settings.universal.d.ts +105 -43
  5. package/build/cjs/src/tips-settings-v1-tip-settings-tip-settings.universal.js +1 -1
  6. package/build/cjs/src/tips-settings-v1-tip-settings-tip-settings.universal.js.map +1 -1
  7. package/build/es/src/tips-settings-v1-tip-settings-tip-settings.public.d.ts +1 -1
  8. package/build/es/src/tips-settings-v1-tip-settings-tip-settings.types.d.ts +102 -42
  9. package/build/es/src/tips-settings-v1-tip-settings-tip-settings.types.js.map +1 -1
  10. package/build/es/src/tips-settings-v1-tip-settings-tip-settings.universal.d.ts +105 -43
  11. package/build/es/src/tips-settings-v1-tip-settings-tip-settings.universal.js +1 -1
  12. package/build/es/src/tips-settings-v1-tip-settings-tip-settings.universal.js.map +1 -1
  13. package/build/internal/cjs/src/tips-settings-v1-tip-settings-tip-settings.public.d.ts +1 -1
  14. package/build/internal/cjs/src/tips-settings-v1-tip-settings-tip-settings.types.d.ts +102 -42
  15. package/build/internal/cjs/src/tips-settings-v1-tip-settings-tip-settings.types.js.map +1 -1
  16. package/build/internal/cjs/src/tips-settings-v1-tip-settings-tip-settings.universal.d.ts +105 -43
  17. package/build/internal/cjs/src/tips-settings-v1-tip-settings-tip-settings.universal.js +1 -1
  18. package/build/internal/cjs/src/tips-settings-v1-tip-settings-tip-settings.universal.js.map +1 -1
  19. package/build/internal/es/src/tips-settings-v1-tip-settings-tip-settings.public.d.ts +1 -1
  20. package/build/internal/es/src/tips-settings-v1-tip-settings-tip-settings.types.d.ts +102 -42
  21. package/build/internal/es/src/tips-settings-v1-tip-settings-tip-settings.types.js.map +1 -1
  22. package/build/internal/es/src/tips-settings-v1-tip-settings-tip-settings.universal.d.ts +105 -43
  23. package/build/internal/es/src/tips-settings-v1-tip-settings-tip-settings.universal.js +1 -1
  24. package/build/internal/es/src/tips-settings-v1-tip-settings-tip-settings.universal.js.map +1 -1
  25. package/package.json +2 -2
@@ -57,7 +57,7 @@ interface CreateDefaultTipSettingsSignature {
57
57
  *
58
58
  *
59
59
  * The call fails if there is already an existing default `tipSettings` object.
60
- * @param - Dafault tip settings to create.
60
+ * @param - Default tip settings to create.
61
61
  */
62
62
  (tipSettings: TipSettings): Promise<CreateDefaultTipSettingsResponse & CreateDefaultTipSettingsResponseNonNullableFields>;
63
63
  }
@@ -2,13 +2,14 @@
2
2
  * Tip settings define how tips are calculated and distributed among staff. When
3
3
  * Wix Tips is installed, default settings are automatically created. You can't
4
4
  * delete these default settings but you can update them. Creating additional
5
- * settings allows business owners to customize tip screens for different payment
5
+ * settings allows Wix users to customize tip screens for different payment
6
6
  * terminals or set specific presets for various products or services.
7
7
  */
8
8
  export interface TipSettings extends TipSettingsIdentifierOneOf {
9
9
  /**
10
- * ID of the [location](https://dev.wix.com/docs/rest/business-management/locations/location-object)
10
+ * ID of the location ([SDK](https://dev.wix.com/docs/sdk/backend-modules/business-tools/locations/introduction) | [REST](https://dev.wix.com/docs/rest/business-management/locations/location-object))
11
11
  * for which the tip settings apply.
12
+ * @format GUID
12
13
  */
13
14
  locationId?: string | null;
14
15
  /**
@@ -16,44 +17,42 @@ export interface TipSettings extends TipSettingsIdentifierOneOf {
16
17
  * validate the ID you provide.
17
18
  *
18
19
  * Max: 30 characters
20
+ * @maxLength 30
19
21
  */
20
22
  paymentTerminalId?: string | null;
21
23
  /**
22
24
  * ID of the Wix user for whom the tip settings apply. For example, the site owner or a
23
25
  * [site collaborator](https://support.wix.com/en/article/inviting-people-to-contribute-to-your-site).
26
+ * @format GUID
24
27
  */
25
28
  userId?: string | null;
26
29
  /**
27
30
  * ID of the tip settings.
31
+ * @format GUID
28
32
  * @readonly
29
33
  */
30
34
  id?: string | null;
31
- /**
32
- * Tip type.
33
- *
34
- * Supported values:
35
- * + `UNKNOWN_TIP_TYPE`: There is no information about the tip type.
36
- * + `PERCENTAGE`: The tip is calculated as a percentage of the subtotal for all related line items.
37
- * + `AMOUNT`: The tip is a fixed amount.
38
- */
35
+ /** Tip type. */
39
36
  tipType?: TipType;
40
37
  /**
41
38
  * Information about the tip choices that Wix Tips displays to customers during the
42
- * [eCommerce checkout](https://dev.wix.com/docs/rest/business-solutions/e-commerce/checkout/checkout-object).
39
+ * eCommerce checkout ([SDK](https://dev.wix.com/docs/sdk/backend-modules/ecom/checkout/introduction) | [REST](https://dev.wix.com/docs/rest/business-solutions/e-commerce/checkout/introduction)).
43
40
  *
44
41
  * Min: `1` preset
45
42
  * Max: `3` presets
43
+ * @minSize 1
44
+ * @maxSize 3
46
45
  */
47
46
  presets?: Preset[];
48
47
  /**
49
48
  * Whether customer are allowed to tip during the
50
- * [eCommerce checkout](https://dev.wix.com/docs/rest/business-solutions/e-commerce/checkout/checkout-object).
49
+ * eCommerce checkout ([SDK](https://dev.wix.com/docs/sdk/backend-modules/ecom/checkout/introduction) | [REST](https://dev.wix.com/docs/rest/business-solutions/e-commerce/checkout/introduction)).
51
50
  *
52
51
  * Default: `true`
53
52
  */
54
53
  allowCustomerTip?: boolean | null;
55
54
  /**
56
- * Whether the business owners are given the option to add a tip during the
55
+ * Whether the Wix users are given the option to add a tip during the
57
56
  * payment collection flow in their dashboard.
58
57
  *
59
58
  * Default: `true`
@@ -68,8 +67,8 @@ export interface TipSettings extends TipSettingsIdentifierOneOf {
68
67
  */
69
68
  allowCustomAmount?: boolean | null;
70
69
  /**
71
- * Whether business owners are allowed to edit tip distributions. If set to
72
- * `false`, owners can't edit distributions after they were created.
70
+ * Whether Wix users are allowed to edit tip distributions. If set to
71
+ * `false`, Wix users can't edit distributions after they were created.
73
72
  *
74
73
  * Default: `true`
75
74
  */
@@ -97,22 +96,25 @@ export interface TipSettings extends TipSettingsIdentifierOneOf {
97
96
  */
98
97
  createdDate?: Date | null;
99
98
  /**
100
- * Date and time the tip settings were last updated
99
+ * Date and time the tip settings were last updated in
101
100
  * `YYYY-MM-DDThh:mm:ss.sssZ` format.
102
101
  * @readonly
103
102
  */
104
103
  updatedDate?: Date | null;
105
104
  /**
106
- * Whether these are the default tip settings. Wix Tips automatically creates
107
- * the default settings during the app's installation. You can't delete these
108
- * default settings but you can update them. Wix Tips uses the default settings
105
+ * Whether these are the default tip settings.
106
+ *
107
+ * Wix Tips automatically creates the default settings during
108
+ * the app's installation. You can't delete these default settings
109
+ * but you can update them. Wix Tips uses the default settings
109
110
  * to calculate tips, unless you specify other settings.
110
111
  * @readonly
111
112
  */
112
113
  default?: boolean | null;
113
114
  /**
114
115
  * ID of the app that has created the settings. See the list of app IDs for
115
- * [Wix business solutions](https://dev.wix.com/docs/rest/articles/getting-started/wix-business-solutions).
116
+ * Wix business solutions ([SDK](https://dev.wix.com/docs/sdk/articles/work-with-the-sdk/apps-created-by-wix) | [REST](https://dev.wix.com/docs/rest/articles/getting-started/apps-created-by-wix)).
117
+ * @format GUID
116
118
  */
117
119
  appId?: string | null;
118
120
  /**
@@ -124,8 +126,9 @@ export interface TipSettings extends TipSettingsIdentifierOneOf {
124
126
  /** @oneof */
125
127
  export interface TipSettingsIdentifierOneOf {
126
128
  /**
127
- * ID of the [location](https://dev.wix.com/docs/rest/business-management/locations/location-object)
129
+ * ID of the location ([SDK](https://dev.wix.com/docs/sdk/backend-modules/business-tools/locations/introduction) | [REST](https://dev.wix.com/docs/rest/business-management/locations/location-object))
128
130
  * for which the tip settings apply.
131
+ * @format GUID
129
132
  */
130
133
  locationId?: string | null;
131
134
  /**
@@ -133,11 +136,13 @@ export interface TipSettingsIdentifierOneOf {
133
136
  * validate the ID you provide.
134
137
  *
135
138
  * Max: 30 characters
139
+ * @maxLength 30
136
140
  */
137
141
  paymentTerminalId?: string | null;
138
142
  /**
139
143
  * ID of the Wix user for whom the tip settings apply. For example, the site owner or a
140
144
  * [site collaborator](https://support.wix.com/en/article/inviting-people-to-contribute-to-your-site).
145
+ * @format GUID
141
146
  */
142
147
  userId?: string | null;
143
148
  }
@@ -152,15 +157,15 @@ export declare enum TipType {
152
157
  export interface Preset {
153
158
  /**
154
159
  * Value of the preset tip choice that's displayed to customers in the
155
- * [eCommerce checkout](https://dev.wix.com/docs/rest/business-solutions/e-commerce/checkout/checkout-object).
160
+ * eCommerce checkout ([SDK](https://dev.wix.com/docs/sdk/backend-modules/ecom/checkout/introduction) | [REST](https://dev.wix.com/docs/rest/business-solutions/e-commerce/checkout/introduction)).
156
161
  * For example, `5`, `10`, and `15` percent or `1`, `3`, and `5` USD.
157
162
  *
158
163
  * Min: `0`
159
164
  */
160
165
  value?: number | null;
161
166
  /**
162
- * Whether this tip choice value is the dafault preset that's highlighted automatically in the
163
- * [eCommerce checkout](https://dev.wix.com/docs/rest/business-solutions/e-commerce/checkout/checkout-object).
167
+ * Whether this tip choice value is the default preset that's highlighted automatically in the
168
+ * eCommerce checkout ([SDK](https://dev.wix.com/docs/sdk/backend-modules/ecom/checkout/introduction) | [REST](https://dev.wix.com/docs/rest/business-solutions/e-commerce/checkout/introduction)).
164
169
  *
165
170
  * Default: `false`
166
171
  */
@@ -206,11 +211,20 @@ export interface QueryV2 extends QueryV2PagingMethodOneOf {
206
211
  /**
207
212
  * Sort object in the following format:
208
213
  * `[{"fieldName":"sortField1","order":"ASC"},{"fieldName":"sortField2","order":"DESC"}]`
214
+ * @maxSize 10
209
215
  */
210
216
  sort?: Sorting[];
211
- /** Array of projected fields. A list of specific field names to return. If `fieldsets` are also specified, the union of `fieldsets` and `fields` is returned. */
217
+ /**
218
+ * Array of projected fields. A list of specific field names to return. If `fieldsets` are also specified, the union of `fieldsets` and `fields` is returned.
219
+ * @maxLength 200
220
+ * @maxSize 10
221
+ */
212
222
  fields?: string[];
213
- /** Array of named, predefined sets of projected fields. A array of predefined named sets of fields to be returned. Specifying multiple `fieldsets` will return the union of fields from all sets. If `fields` are also specified, the union of `fieldsets` and `fields` is returned. */
223
+ /**
224
+ * Array of named, predefined sets of projected fields. A array of predefined named sets of fields to be returned. Specifying multiple `fieldsets` will return the union of fields from all sets. If `fields` are also specified, the union of `fieldsets` and `fields` is returned.
225
+ * @maxLength 200
226
+ * @maxSize 10
227
+ */
214
228
  fieldsets?: string[];
215
229
  }
216
230
  /** @oneof */
@@ -221,7 +235,10 @@ export interface QueryV2PagingMethodOneOf {
221
235
  cursorPaging?: CursorPaging;
222
236
  }
223
237
  export interface Sorting {
224
- /** Name of the field to sort by. */
238
+ /**
239
+ * Name of the field to sort by.
240
+ * @maxLength 512
241
+ */
225
242
  fieldName?: string;
226
243
  /** Sort order. */
227
244
  order?: SortOrder;
@@ -237,13 +254,17 @@ export interface Paging {
237
254
  offset?: number | null;
238
255
  }
239
256
  export interface CursorPaging {
240
- /** Maximum number of items to return in the results. */
257
+ /**
258
+ * Maximum number of items to return in the results.
259
+ * @max 100
260
+ */
241
261
  limit?: number | null;
242
262
  /**
243
263
  * Pointer to the next or previous page in the list of results.
244
264
  *
245
265
  * Pass the relevant cursor token from the `pagingMetadata` object in the previous call's response.
246
266
  * Not relevant for the first request.
267
+ * @maxLength 16000
247
268
  */
248
269
  cursor?: string | null;
249
270
  }
@@ -266,9 +287,15 @@ export interface PagingMetadataV2 {
266
287
  cursors?: Cursors;
267
288
  }
268
289
  export interface Cursors {
269
- /** Cursor string pointing to the next page in the list of results. */
290
+ /**
291
+ * Cursor string pointing to the next page in the list of results.
292
+ * @maxLength 16000
293
+ */
270
294
  next?: string | null;
271
- /** Cursor pointing to the previous page in the list of results. */
295
+ /**
296
+ * Cursor pointing to the previous page in the list of results.
297
+ * @maxLength 16000
298
+ */
272
299
  prev?: string | null;
273
300
  }
274
301
  export interface UpdateTipSettingsRequest {
@@ -288,7 +315,7 @@ export interface CreateTipSettingsResponse {
288
315
  tipSettings?: TipSettings;
289
316
  }
290
317
  export interface CreateDefaultTipSettingsRequest {
291
- /** Dafault tip settings to create. */
318
+ /** Default tip settings to create. */
292
319
  tipSettings: TipSettings;
293
320
  }
294
321
  export interface CreateDefaultTipSettingsResponse {
@@ -296,7 +323,10 @@ export interface CreateDefaultTipSettingsResponse {
296
323
  tipSettings?: TipSettings;
297
324
  }
298
325
  export interface DeleteTipSettingsRequest {
299
- /** ID of the `tipSettings` object to delete. */
326
+ /**
327
+ * ID of the `tipSettings` object to delete.
328
+ * @format GUID
329
+ */
300
330
  tipSettingsId: string | null;
301
331
  }
302
332
  export interface DeleteTipSettingsResponse {
@@ -374,9 +404,15 @@ export interface ActionEvent {
374
404
  bodyAsJson?: string;
375
405
  }
376
406
  export interface MessageEnvelope {
377
- /** App instance ID. */
407
+ /**
408
+ * App instance ID.
409
+ * @format GUID
410
+ */
378
411
  instanceId?: string | null;
379
- /** Event type. */
412
+ /**
413
+ * Event type.
414
+ * @maxLength 150
415
+ */
380
416
  eventType?: string;
381
417
  /** The identification type and identity data. */
382
418
  identity?: IdentificationData;
@@ -384,26 +420,50 @@ export interface MessageEnvelope {
384
420
  data?: string;
385
421
  }
386
422
  export interface IdentificationData extends IdentificationDataIdOneOf {
387
- /** ID of a site visitor that has not logged in to the site. */
423
+ /**
424
+ * ID of a site visitor that has not logged in to the site.
425
+ * @format GUID
426
+ */
388
427
  anonymousVisitorId?: string;
389
- /** ID of a site visitor that has logged in to the site. */
428
+ /**
429
+ * ID of a site visitor that has logged in to the site.
430
+ * @format GUID
431
+ */
390
432
  memberId?: string;
391
- /** ID of a Wix user (site owner, contributor, etc.). */
433
+ /**
434
+ * ID of a Wix user (site owner, contributor, etc.).
435
+ * @format GUID
436
+ */
392
437
  wixUserId?: string;
393
- /** ID of an app. */
438
+ /**
439
+ * ID of an app.
440
+ * @format GUID
441
+ */
394
442
  appId?: string;
395
443
  /** @readonly */
396
444
  identityType?: WebhookIdentityType;
397
445
  }
398
446
  /** @oneof */
399
447
  export interface IdentificationDataIdOneOf {
400
- /** ID of a site visitor that has not logged in to the site. */
448
+ /**
449
+ * ID of a site visitor that has not logged in to the site.
450
+ * @format GUID
451
+ */
401
452
  anonymousVisitorId?: string;
402
- /** ID of a site visitor that has logged in to the site. */
453
+ /**
454
+ * ID of a site visitor that has logged in to the site.
455
+ * @format GUID
456
+ */
403
457
  memberId?: string;
404
- /** ID of a Wix user (site owner, contributor, etc.). */
458
+ /**
459
+ * ID of a Wix user (site owner, contributor, etc.).
460
+ * @format GUID
461
+ */
405
462
  wixUserId?: string;
406
- /** ID of an app. */
463
+ /**
464
+ * ID of an app.
465
+ * @format GUID
466
+ */
407
467
  appId?: string;
408
468
  }
409
469
  export declare enum WebhookIdentityType {
@@ -1 +1 @@
1
- {"version":3,"file":"tips-settings-v1-tip-settings-tip-settings.types.js","sourceRoot":"","sources":["../../../src/tips-settings-v1-tip-settings-tip-settings.types.ts"],"names":[],"mappings":";;;AAiJA,IAAY,OAOX;AAPD,WAAY,OAAO;IACjB,kDAAkD;IAClD,gDAAqC,CAAA;IACrC,uFAAuF;IACvF,oCAAyB,CAAA;IACzB,iCAAiC;IACjC,4BAAiB,CAAA;AACnB,CAAC,EAPW,OAAO,uBAAP,OAAO,QAOlB;AAoBD,IAAY,uBAOX;AAPD,WAAY,uBAAuB;IACjC,mEAAmE;IACnE,wEAA6C,CAAA;IAC7C,oDAAoD;IACpD,0CAAe,CAAA;IACf,sDAAsD;IACtD,wDAA6B,CAAA;AAC/B,CAAC,EAPW,uBAAuB,uCAAvB,uBAAuB,QAOlC;AA2DD,IAAY,SAGX;AAHD,WAAY,SAAS;IACnB,wBAAW,CAAA;IACX,0BAAa,CAAA;AACf,CAAC,EAHW,SAAS,yBAAT,SAAS,QAGpB;AAwMD,IAAY,mBAMX;AAND,WAAY,mBAAmB;IAC7B,0CAAmB,CAAA;IACnB,8DAAuC,CAAA;IACvC,wCAAiB,CAAA;IACjB,4CAAqB,CAAA;IACrB,kCAAW,CAAA;AACb,CAAC,EANW,mBAAmB,mCAAnB,mBAAmB,QAM9B"}
1
+ {"version":3,"file":"tips-settings-v1-tip-settings-tip-settings.types.js","sourceRoot":"","sources":["../../../src/tips-settings-v1-tip-settings-tip-settings.types.ts"],"names":[],"mappings":";;;AAsJA,IAAY,OAOX;AAPD,WAAY,OAAO;IACjB,kDAAkD;IAClD,gDAAqC,CAAA;IACrC,uFAAuF;IACvF,oCAAyB,CAAA;IACzB,iCAAiC;IACjC,4BAAiB,CAAA;AACnB,CAAC,EAPW,OAAO,uBAAP,OAAO,QAOlB;AAoBD,IAAY,uBAOX;AAPD,WAAY,uBAAuB;IACjC,mEAAmE;IACnE,wEAA6C,CAAA;IAC7C,oDAAoD;IACpD,0CAAe,CAAA;IACf,sDAAsD;IACtD,wDAA6B,CAAA;AAC/B,CAAC,EAPW,uBAAuB,uCAAvB,uBAAuB,QAOlC;AAuED,IAAY,SAGX;AAHD,WAAY,SAAS;IACnB,wBAAW,CAAA;IACX,0BAAa,CAAA;AACf,CAAC,EAHW,SAAS,yBAAT,SAAS,QAGpB;AAmPD,IAAY,mBAMX;AAND,WAAY,mBAAmB;IAC7B,0CAAmB,CAAA;IACnB,8DAAuC,CAAA;IACvC,wCAAiB,CAAA;IACjB,4CAAqB,CAAA;IACrB,kCAAW,CAAA;AACb,CAAC,EANW,mBAAmB,mCAAnB,mBAAmB,QAM9B"}
@@ -2,13 +2,14 @@
2
2
  * Tip settings define how tips are calculated and distributed among staff. When
3
3
  * Wix Tips is installed, default settings are automatically created. You can't
4
4
  * delete these default settings but you can update them. Creating additional
5
- * settings allows business owners to customize tip screens for different payment
5
+ * settings allows Wix users to customize tip screens for different payment
6
6
  * terminals or set specific presets for various products or services.
7
7
  */
8
8
  export interface TipSettings extends TipSettingsIdentifierOneOf {
9
9
  /**
10
- * ID of the [location](https://dev.wix.com/docs/sdk/backend-modules/business-tools/locations/introduction)
10
+ * ID of the location ([SDK](https://dev.wix.com/docs/sdk/backend-modules/business-tools/locations/introduction) | [REST](https://dev.wix.com/docs/rest/business-management/locations/location-object))
11
11
  * for which the tip settings apply.
12
+ * @format GUID
12
13
  */
13
14
  locationId?: string | null;
14
15
  /**
@@ -16,42 +17,42 @@ export interface TipSettings extends TipSettingsIdentifierOneOf {
16
17
  * validate the ID you provide.
17
18
  *
18
19
  * Max: 30 characters
20
+ * @maxLength 30
19
21
  */
20
22
  paymentTerminalId?: string | null;
21
23
  /**
22
24
  * ID of the Wix user for whom the tip settings apply. For example, the site owner or a
23
25
  * [site collaborator](https://support.wix.com/en/article/inviting-people-to-contribute-to-your-site).
26
+ * @format GUID
24
27
  */
25
28
  userId?: string | null;
26
29
  /**
27
30
  * ID of the tip settings.
31
+ * @format GUID
28
32
  * @readonly
29
33
  */
30
34
  _id?: string | null;
31
- /**
32
- * Tip type.
33
- *
34
- * Supported values:
35
- * + `UNKNOWN_TIP_TYPE`: There is no information about the tip type.
36
- * + `PERCENTAGE`: The tip is calculated as a percentage of the subtotal for all related line items.
37
- * + `AMOUNT`: The tip is a fixed amount.
38
- */
35
+ /** Tip type. */
39
36
  tipType?: TipType;
40
37
  /**
41
38
  * Information about the tip choices that Wix Tips displays to customers during the
42
- * [eCommerce checkout](https://dev.wix.com/docs/sdk/backend-modules/ecom/checkout/setup).
39
+ * eCommerce checkout ([SDK](https://dev.wix.com/docs/sdk/backend-modules/ecom/checkout/introduction) | [REST](https://dev.wix.com/docs/rest/business-solutions/e-commerce/checkout/introduction)).
43
40
  *
44
41
  * Min: `1` preset
45
42
  * Max: `3` presets
43
+ * @minSize 1
44
+ * @maxSize 3
46
45
  */
47
46
  presets?: Preset[];
48
47
  /**
49
48
  * Whether customer are allowed to tip during the
50
- * [eCommerce checkout](https://dev.wix.com/docs/sdk/backend-modules/ecom/checkout/setup).
49
+ * eCommerce checkout ([SDK](https://dev.wix.com/docs/sdk/backend-modules/ecom/checkout/introduction) | [REST](https://dev.wix.com/docs/rest/business-solutions/e-commerce/checkout/introduction)).
50
+ *
51
+ * Default: `true`
51
52
  */
52
53
  allowCustomerTip?: boolean | null;
53
54
  /**
54
- * Whether the business owners are given the option to add a tip during the
55
+ * Whether the Wix users are given the option to add a tip during the
55
56
  * payment collection flow in their dashboard.
56
57
  *
57
58
  * Default: `true`
@@ -66,8 +67,8 @@ export interface TipSettings extends TipSettingsIdentifierOneOf {
66
67
  */
67
68
  allowCustomAmount?: boolean | null;
68
69
  /**
69
- * Whether business owners are allowed to edit tip distributions. If set to
70
- * `false`, owners can't edit distributions after they were created.
70
+ * Whether Wix users are allowed to edit tip distributions. If set to
71
+ * `false`, Wix users can't edit distributions after they were created.
71
72
  *
72
73
  * Default: `true`
73
74
  */
@@ -95,22 +96,25 @@ export interface TipSettings extends TipSettingsIdentifierOneOf {
95
96
  */
96
97
  _createdDate?: Date | null;
97
98
  /**
98
- * Date and time the tip settings were last updated
99
+ * Date and time the tip settings were last updated in
99
100
  * `YYYY-MM-DDThh:mm:ss.sssZ` format.
100
101
  * @readonly
101
102
  */
102
103
  _updatedDate?: Date | null;
103
104
  /**
104
- * Whether these are the default tip settings. Wix Tips automatically creates
105
- * the default settings during the app's installation. You can't delete these
106
- * default settings but you can update them. Wix Tips uses the default settings
105
+ * Whether these are the default tip settings.
106
+ *
107
+ * Wix Tips automatically creates the default settings during
108
+ * the app's installation. You can't delete these default settings
109
+ * but you can update them. Wix Tips uses the default settings
107
110
  * to calculate tips, unless you specify other settings.
108
111
  * @readonly
109
112
  */
110
113
  default?: boolean | null;
111
114
  /**
112
115
  * ID of the app that has created the settings. See the list of app IDs for
113
- * [Wix business solutions](https://dev.wix.com/docs/rest/articles/getting-started/wix-business-solutions).
116
+ * Wix business solutions ([SDK](https://dev.wix.com/docs/sdk/articles/work-with-the-sdk/apps-created-by-wix) | [REST](https://dev.wix.com/docs/rest/articles/getting-started/apps-created-by-wix)).
117
+ * @format GUID
114
118
  */
115
119
  appId?: string | null;
116
120
  /**
@@ -122,8 +126,9 @@ export interface TipSettings extends TipSettingsIdentifierOneOf {
122
126
  /** @oneof */
123
127
  export interface TipSettingsIdentifierOneOf {
124
128
  /**
125
- * ID of the [location](https://dev.wix.com/docs/sdk/backend-modules/business-tools/locations/introduction)
129
+ * ID of the location ([SDK](https://dev.wix.com/docs/sdk/backend-modules/business-tools/locations/introduction) | [REST](https://dev.wix.com/docs/rest/business-management/locations/location-object))
126
130
  * for which the tip settings apply.
131
+ * @format GUID
127
132
  */
128
133
  locationId?: string | null;
129
134
  /**
@@ -131,11 +136,13 @@ export interface TipSettingsIdentifierOneOf {
131
136
  * validate the ID you provide.
132
137
  *
133
138
  * Max: 30 characters
139
+ * @maxLength 30
134
140
  */
135
141
  paymentTerminalId?: string | null;
136
142
  /**
137
143
  * ID of the Wix user for whom the tip settings apply. For example, the site owner or a
138
144
  * [site collaborator](https://support.wix.com/en/article/inviting-people-to-contribute-to-your-site).
145
+ * @format GUID
139
146
  */
140
147
  userId?: string | null;
141
148
  }
@@ -150,15 +157,15 @@ export declare enum TipType {
150
157
  export interface Preset {
151
158
  /**
152
159
  * Value of the preset tip choice that's displayed to customers in the
153
- * [eCommerce checkout](https://dev.wix.com/docs/sdk/backend-modules/ecom/checkout/setup).
160
+ * eCommerce checkout ([SDK](https://dev.wix.com/docs/sdk/backend-modules/ecom/checkout/introduction) | [REST](https://dev.wix.com/docs/rest/business-solutions/e-commerce/checkout/introduction)).
154
161
  * For example, `5`, `10`, and `15` percent or `1`, `3`, and `5` USD.
155
162
  *
156
163
  * Min: `0`
157
164
  */
158
165
  value?: number | null;
159
166
  /**
160
- * Whether this tip choice value is the dafault preset that's highlighted automatically in the
161
- * [eCommerce checkout](https://dev.wix.com/docs/sdk/backend-modules/ecom/checkout/setup).
167
+ * Whether this tip choice value is the default preset that's highlighted automatically in the
168
+ * eCommerce checkout ([SDK](https://dev.wix.com/docs/sdk/backend-modules/ecom/checkout/introduction) | [REST](https://dev.wix.com/docs/rest/business-solutions/e-commerce/checkout/introduction)).
162
169
  *
163
170
  * Default: `false`
164
171
  */
@@ -204,11 +211,20 @@ export interface QueryV2 extends QueryV2PagingMethodOneOf {
204
211
  /**
205
212
  * Sort object in the following format:
206
213
  * `[{"fieldName":"sortField1","order":"ASC"},{"fieldName":"sortField2","order":"DESC"}]`
214
+ * @maxSize 10
207
215
  */
208
216
  sort?: Sorting[];
209
- /** Array of projected fields. A list of specific field names to return. If `fieldsets` are also specified, the union of `fieldsets` and `fields` is returned. */
217
+ /**
218
+ * Array of projected fields. A list of specific field names to return. If `fieldsets` are also specified, the union of `fieldsets` and `fields` is returned.
219
+ * @maxLength 200
220
+ * @maxSize 10
221
+ */
210
222
  fields?: string[];
211
- /** Array of named, predefined sets of projected fields. A array of predefined named sets of fields to be returned. Specifying multiple `fieldsets` will return the union of fields from all sets. If `fields` are also specified, the union of `fieldsets` and `fields` is returned. */
223
+ /**
224
+ * Array of named, predefined sets of projected fields. A array of predefined named sets of fields to be returned. Specifying multiple `fieldsets` will return the union of fields from all sets. If `fields` are also specified, the union of `fieldsets` and `fields` is returned.
225
+ * @maxLength 200
226
+ * @maxSize 10
227
+ */
212
228
  fieldsets?: string[];
213
229
  }
214
230
  /** @oneof */
@@ -219,7 +235,10 @@ export interface QueryV2PagingMethodOneOf {
219
235
  cursorPaging?: CursorPaging;
220
236
  }
221
237
  export interface Sorting {
222
- /** Name of the field to sort by. */
238
+ /**
239
+ * Name of the field to sort by.
240
+ * @maxLength 512
241
+ */
223
242
  fieldName?: string;
224
243
  /** Sort order. */
225
244
  order?: SortOrder;
@@ -235,13 +254,17 @@ export interface Paging {
235
254
  offset?: number | null;
236
255
  }
237
256
  export interface CursorPaging {
238
- /** Maximum number of items to return in the results. */
257
+ /**
258
+ * Maximum number of items to return in the results.
259
+ * @max 100
260
+ */
239
261
  limit?: number | null;
240
262
  /**
241
263
  * Pointer to the next or previous page in the list of results.
242
264
  *
243
265
  * Pass the relevant cursor token from the `pagingMetadata` object in the previous call's response.
244
266
  * Not relevant for the first request.
267
+ * @maxLength 16000
245
268
  */
246
269
  cursor?: string | null;
247
270
  }
@@ -264,9 +287,15 @@ export interface PagingMetadataV2 {
264
287
  cursors?: Cursors;
265
288
  }
266
289
  export interface Cursors {
267
- /** Cursor string pointing to the next page in the list of results. */
290
+ /**
291
+ * Cursor string pointing to the next page in the list of results.
292
+ * @maxLength 16000
293
+ */
268
294
  next?: string | null;
269
- /** Cursor pointing to the previous page in the list of results. */
295
+ /**
296
+ * Cursor pointing to the previous page in the list of results.
297
+ * @maxLength 16000
298
+ */
270
299
  prev?: string | null;
271
300
  }
272
301
  export interface UpdateTipSettingsRequest {
@@ -286,7 +315,7 @@ export interface CreateTipSettingsResponse {
286
315
  tipSettings?: TipSettings;
287
316
  }
288
317
  export interface CreateDefaultTipSettingsRequest {
289
- /** Dafault tip settings to create. */
318
+ /** Default tip settings to create. */
290
319
  tipSettings: TipSettings;
291
320
  }
292
321
  export interface CreateDefaultTipSettingsResponse {
@@ -294,7 +323,10 @@ export interface CreateDefaultTipSettingsResponse {
294
323
  tipSettings?: TipSettings;
295
324
  }
296
325
  export interface DeleteTipSettingsRequest {
297
- /** ID of the `tipSettings` object to delete. */
326
+ /**
327
+ * ID of the `tipSettings` object to delete.
328
+ * @format GUID
329
+ */
298
330
  tipSettingsId: string | null;
299
331
  }
300
332
  export interface DeleteTipSettingsResponse {
@@ -370,9 +402,15 @@ export interface ActionEvent {
370
402
  body?: string;
371
403
  }
372
404
  export interface MessageEnvelope {
373
- /** App instance ID. */
405
+ /**
406
+ * App instance ID.
407
+ * @format GUID
408
+ */
374
409
  instanceId?: string | null;
375
- /** Event type. */
410
+ /**
411
+ * Event type.
412
+ * @maxLength 150
413
+ */
376
414
  eventType?: string;
377
415
  /** The identification type and identity data. */
378
416
  identity?: IdentificationData;
@@ -380,26 +418,50 @@ export interface MessageEnvelope {
380
418
  data?: string;
381
419
  }
382
420
  export interface IdentificationData extends IdentificationDataIdOneOf {
383
- /** ID of a site visitor that has not logged in to the site. */
421
+ /**
422
+ * ID of a site visitor that has not logged in to the site.
423
+ * @format GUID
424
+ */
384
425
  anonymousVisitorId?: string;
385
- /** ID of a site visitor that has logged in to the site. */
426
+ /**
427
+ * ID of a site visitor that has logged in to the site.
428
+ * @format GUID
429
+ */
386
430
  memberId?: string;
387
- /** ID of a Wix user (site owner, contributor, etc.). */
431
+ /**
432
+ * ID of a Wix user (site owner, contributor, etc.).
433
+ * @format GUID
434
+ */
388
435
  wixUserId?: string;
389
- /** ID of an app. */
436
+ /**
437
+ * ID of an app.
438
+ * @format GUID
439
+ */
390
440
  appId?: string;
391
441
  /** @readonly */
392
442
  identityType?: WebhookIdentityType;
393
443
  }
394
444
  /** @oneof */
395
445
  export interface IdentificationDataIdOneOf {
396
- /** ID of a site visitor that has not logged in to the site. */
446
+ /**
447
+ * ID of a site visitor that has not logged in to the site.
448
+ * @format GUID
449
+ */
397
450
  anonymousVisitorId?: string;
398
- /** ID of a site visitor that has logged in to the site. */
451
+ /**
452
+ * ID of a site visitor that has logged in to the site.
453
+ * @format GUID
454
+ */
399
455
  memberId?: string;
400
- /** ID of a Wix user (site owner, contributor, etc.). */
456
+ /**
457
+ * ID of a Wix user (site owner, contributor, etc.).
458
+ * @format GUID
459
+ */
401
460
  wixUserId?: string;
402
- /** ID of an app. */
461
+ /**
462
+ * ID of an app.
463
+ * @format GUID
464
+ */
403
465
  appId?: string;
404
466
  }
405
467
  export declare enum WebhookIdentityType {
@@ -555,7 +617,7 @@ export declare function createTipSettings(tipSettings: TipSettings): Promise<Tip
555
617
  *
556
618
  *
557
619
  * The call fails if there is already an existing default `tipSettings` object.
558
- * @param tipSettings - Dafault tip settings to create.
620
+ * @param tipSettings - Default tip settings to create.
559
621
  * @public
560
622
  * @documentationMaturity preview
561
623
  * @requiredField tipSettings