@wix/referral 1.0.11 → 1.0.13

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.
@@ -2,16 +2,21 @@ interface ReferralProgram$1 {
2
2
  /** Referral program name. */
3
3
  name?: string | null;
4
4
  /**
5
- * The status of the referral program. Possible values:
5
+ * Status of the referral program.
6
6
  *
7
- * - `UNKNOWN`: Status is unknown. This value is never used.
8
- * - `DRAFT`: Referral program is in a draft state and is currently being modified. Not yet active.
9
- * - `ACTIVE`: Referral program is active.
10
- * - `PAUSED`: Referral program is paused.
7
+ * Possible values:
8
+ *
9
+ * - `UNKNOWN`: The status of the referral program is unknown. This value is not used.
10
+ * - `DRAFT`: The referral program is in a draft state and is being modified. It is not yet active.
11
+ * - `ACTIVE`: The referral program is active.
12
+ * - `PAUSED`: The referral program is paused.
11
13
  * @readonly
12
14
  */
13
15
  status?: ProgramStatus$1;
14
- /** Revision number, which increments by 1 each time the program is updated. To prevent conflicting changes, the current `revision` must be passed when updating the program. */
16
+ /**
17
+ * Revision number, which increments by 1 each time the program is updated.
18
+ * To prevent conflicting changes, the current `revision` must be passed when updating the program.
19
+ */
15
20
  revision?: string | null;
16
21
  /**
17
22
  * Date and time the program was created.
@@ -19,7 +24,7 @@ interface ReferralProgram$1 {
19
24
  */
20
25
  createdDate?: Date;
21
26
  /**
22
- * Date and time the program was updated.
27
+ * Date and time the program was last updated.
23
28
  * @readonly
24
29
  */
25
30
  updatedDate?: Date;
@@ -34,7 +39,7 @@ interface ReferralProgram$1 {
34
39
  */
35
40
  referringCustomerReward?: Reward$3;
36
41
  /**
37
- * A list of actions that complete a referral. For an action to be considered successful, the referred friend must place and pay for an order.
42
+ * List of actions that complete a referral. For an action to be considered successful, the referred friend must place and pay for an order.
38
43
  *
39
44
  * Possible values:
40
45
  *
@@ -48,8 +53,12 @@ interface ReferralProgram$1 {
48
53
  successfulReferralActions?: Action$1[];
49
54
  /**
50
55
  * Whether the user has the required plan to use the referral program.
56
+ *
57
+ * Deprecated: Use `[GetReferralProgramPremiumFeatures](https://dev.wix.com/docs/velo/api-reference/wix-marketing-v2/referral-program/programs/get-referral-program-premium-features)` instead.
51
58
  * @readonly
52
59
  * @deprecated Whether the user has the required plan to use the referral program.
60
+ *
61
+ * Deprecated: Use `[GetReferralProgramPremiumFeatures](https://dev.wix.com/docs/velo/api-reference/wix-marketing-v2/referral-program/programs/get-referral-program-premium-features)` instead.
53
62
  * @replacedBy GetReferralProgramPremiumFeatures
54
63
  * @targetRemovalDate 2024-09-01
55
64
  */
@@ -200,7 +209,7 @@ declare enum Action$1 {
200
209
  }
201
210
  interface Emails$1 {
202
211
  /**
203
- * Encourage customers to refer their friends via email. Select which apps to enable.
212
+ * Configures email invitations to encourage customers to refer their friends. Select the apps for which this feature is enabled.
204
213
  *
205
214
  * Available apps:
206
215
  *
@@ -231,7 +240,7 @@ declare enum App$1 {
231
240
  }
232
241
  interface PremiumFeatures$1 {
233
242
  /**
234
- * Whether the user has the referral program feature.
243
+ * Whether the user has access to the referral program feature.
235
244
  * @readonly
236
245
  */
237
246
  referralProgram?: boolean;
@@ -454,16 +463,21 @@ interface ReferralProgram {
454
463
  /** Referral program name. */
455
464
  name?: string | null;
456
465
  /**
457
- * The status of the referral program. Possible values:
466
+ * Status of the referral program.
467
+ *
468
+ * Possible values:
458
469
  *
459
- * - `UNKNOWN`: Status is unknown. This value is never used.
460
- * - `DRAFT`: Referral program is in a draft state and is currently being modified. Not yet active.
461
- * - `ACTIVE`: Referral program is active.
462
- * - `PAUSED`: Referral program is paused.
470
+ * - `UNKNOWN`: The status of the referral program is unknown. This value is not used.
471
+ * - `DRAFT`: The referral program is in a draft state and is being modified. It is not yet active.
472
+ * - `ACTIVE`: The referral program is active.
473
+ * - `PAUSED`: The referral program is paused.
463
474
  * @readonly
464
475
  */
465
476
  status?: ProgramStatus;
466
- /** Revision number, which increments by 1 each time the program is updated. To prevent conflicting changes, the current `revision` must be passed when updating the program. */
477
+ /**
478
+ * Revision number, which increments by 1 each time the program is updated.
479
+ * To prevent conflicting changes, the current `revision` must be passed when updating the program.
480
+ */
467
481
  revision?: string | null;
468
482
  /**
469
483
  * Date and time the program was created.
@@ -471,7 +485,7 @@ interface ReferralProgram {
471
485
  */
472
486
  _createdDate?: Date;
473
487
  /**
474
- * Date and time the program was updated.
488
+ * Date and time the program was last updated.
475
489
  * @readonly
476
490
  */
477
491
  _updatedDate?: Date;
@@ -486,7 +500,7 @@ interface ReferralProgram {
486
500
  */
487
501
  referringCustomerReward?: Reward$2;
488
502
  /**
489
- * A list of actions that complete a referral. For an action to be considered successful, the referred friend must place and pay for an order.
503
+ * List of actions that complete a referral. For an action to be considered successful, the referred friend must place and pay for an order.
490
504
  *
491
505
  * Possible values:
492
506
  *
@@ -500,8 +514,12 @@ interface ReferralProgram {
500
514
  successfulReferralActions?: Action[];
501
515
  /**
502
516
  * Whether the user has the required plan to use the referral program.
517
+ *
518
+ * Deprecated: Use `[GetReferralProgramPremiumFeatures](https://dev.wix.com/docs/velo/api-reference/wix-marketing-v2/referral-program/programs/get-referral-program-premium-features)` instead.
503
519
  * @readonly
504
520
  * @deprecated Whether the user has the required plan to use the referral program.
521
+ *
522
+ * Deprecated: Use `[GetReferralProgramPremiumFeatures](https://dev.wix.com/docs/velo/api-reference/wix-marketing-v2/referral-program/programs/get-referral-program-premium-features)` instead.
505
523
  * @replacedBy GetReferralProgramPremiumFeatures
506
524
  * @targetRemovalDate 2024-09-01
507
525
  */
@@ -652,7 +670,7 @@ declare enum Action {
652
670
  }
653
671
  interface Emails {
654
672
  /**
655
- * Encourage customers to refer their friends via email. Select which apps to enable.
673
+ * Configures email invitations to encourage customers to refer their friends. Select the apps for which this feature is enabled.
656
674
  *
657
675
  * Available apps:
658
676
  *
@@ -683,7 +701,7 @@ declare enum App {
683
701
  }
684
702
  interface PremiumFeatures {
685
703
  /**
686
- * Whether the user has the referral program feature.
704
+ * Whether the user has access to the referral program feature.
687
705
  * @readonly
688
706
  */
689
707
  referralProgram?: boolean;
@@ -933,7 +951,6 @@ declare namespace meta$4 {
933
951
  export { type __PublicMethodMetaInfo$4 as __PublicMethodMetaInfo, meta$4_activateReferralProgram as activateReferralProgram, meta$4_generateAiSocialMediaPostsSuggestions as generateAiSocialMediaPostsSuggestions, meta$4_getAiSocialMediaPostsSuggestions as getAiSocialMediaPostsSuggestions, meta$4_getReferralProgram as getReferralProgram, meta$4_getReferralProgramPremiumFeatures as getReferralProgramPremiumFeatures, meta$4_pauseReferralProgram as pauseReferralProgram, meta$4_queryReferralPrograms as queryReferralPrograms, meta$4_updateReferralProgram as updateReferralProgram };
934
952
  }
935
953
 
936
- /** ReferralEvent. */
937
954
  interface ReferralEvent$1 extends ReferralEventEventTypeOneOf$1 {
938
955
  /** ReferredFriendSignupEvent is an event that is triggered when a referred friend signs up. */
939
956
  referredFriendSignupEvent?: ReferredFriendSignupEvent$1;
@@ -1248,34 +1265,41 @@ interface ReferredFriendActionRewardTypeOptionsOneOf$1 {
1248
1265
  }
1249
1266
  interface V1Coupon$3 {
1250
1267
  /**
1251
- * Coupon ID.
1268
+ * Coupon ID. Example: `8934b045-7052-4a90-be2b-832c70afc9da`.
1252
1269
  * @readonly
1253
1270
  */
1254
1271
  id?: string;
1255
1272
  /**
1256
- * Coupon code.
1273
+ * The code that customers can use to apply the coupon. Example: `6RFD2A3HSPXW`.
1257
1274
  * @readonly
1258
1275
  */
1259
1276
  code?: string;
1260
1277
  /**
1261
- * Coupon status.
1278
+ * Current status of the coupon.
1279
+ *
1280
+ * Possible values:
1281
+ *
1282
+ * - `UNKNOWN`: Unknown coupon status.
1283
+ * - `ACTIVE`: Coupon is active and can be applied.
1284
+ * - `APPLIED`: Coupon was already applied and can't be used anymore.
1285
+ * - `DELETED`: Coupon was deleted.
1262
1286
  * @readonly
1263
1287
  */
1264
1288
  status?: Status$5;
1265
1289
  /**
1266
- * Coupon specification.
1290
+ * Detailed specifications of the coupon.
1267
1291
  * @readonly
1268
1292
  */
1269
1293
  couponSpecification?: Coupon$3;
1270
1294
  }
1271
1295
  declare enum Status$5 {
1272
- /** Unknown coupon status. */
1296
+ /** The coupon status is unknown or not specified. */
1273
1297
  UNKNOWN = "UNKNOWN",
1274
- /** Coupon is active and can be applied. */
1298
+ /** The coupon is active and can be applied to purchases. */
1275
1299
  ACTIVE = "ACTIVE",
1276
- /** Coupon was already applied and can not be used anymore. */
1300
+ /** The coupon has been applied and can't be used again. */
1277
1301
  APPLIED = "APPLIED",
1278
- /** Coupon was deleted. */
1302
+ /** The coupon has been deleted and is no longer valid. */
1279
1303
  DELETED = "DELETED"
1280
1304
  }
1281
1305
  interface Coupon$3 extends CouponDiscountTypeOptionsOneOf$3, CouponScopeOrMinSubtotalOneOf$3 {
@@ -1368,7 +1392,7 @@ interface LoyaltyPoints$1 {
1368
1392
  */
1369
1393
  transactionId?: string;
1370
1394
  /**
1371
- * Loyalty points amount given.
1395
+ * The number of loyalty points awarded.
1372
1396
  * @readonly
1373
1397
  */
1374
1398
  amount?: number;
@@ -1467,7 +1491,6 @@ interface QueryReferredFriendActionsResponseNonNullableFields$1 {
1467
1491
  referredFriendActions: ReferredFriendActionNonNullableFields$1[];
1468
1492
  }
1469
1493
 
1470
- /** ReferralEvent. */
1471
1494
  interface ReferralEvent extends ReferralEventEventTypeOneOf {
1472
1495
  /** ReferredFriendSignupEvent is an event that is triggered when a referred friend signs up. */
1473
1496
  referredFriendSignupEvent?: ReferredFriendSignupEvent;
@@ -1782,34 +1805,41 @@ interface ReferredFriendActionRewardTypeOptionsOneOf {
1782
1805
  }
1783
1806
  interface V1Coupon$2 {
1784
1807
  /**
1785
- * Coupon ID.
1808
+ * Coupon ID. Example: `8934b045-7052-4a90-be2b-832c70afc9da`.
1786
1809
  * @readonly
1787
1810
  */
1788
1811
  _id?: string;
1789
1812
  /**
1790
- * Coupon code.
1813
+ * The code that customers can use to apply the coupon. Example: `6RFD2A3HSPXW`.
1791
1814
  * @readonly
1792
1815
  */
1793
1816
  code?: string;
1794
1817
  /**
1795
- * Coupon status.
1818
+ * Current status of the coupon.
1819
+ *
1820
+ * Possible values:
1821
+ *
1822
+ * - `UNKNOWN`: Unknown coupon status.
1823
+ * - `ACTIVE`: Coupon is active and can be applied.
1824
+ * - `APPLIED`: Coupon was already applied and can't be used anymore.
1825
+ * - `DELETED`: Coupon was deleted.
1796
1826
  * @readonly
1797
1827
  */
1798
1828
  status?: Status$4;
1799
1829
  /**
1800
- * Coupon specification.
1830
+ * Detailed specifications of the coupon.
1801
1831
  * @readonly
1802
1832
  */
1803
1833
  couponSpecification?: Coupon$2;
1804
1834
  }
1805
1835
  declare enum Status$4 {
1806
- /** Unknown coupon status. */
1836
+ /** The coupon status is unknown or not specified. */
1807
1837
  UNKNOWN = "UNKNOWN",
1808
- /** Coupon is active and can be applied. */
1838
+ /** The coupon is active and can be applied to purchases. */
1809
1839
  ACTIVE = "ACTIVE",
1810
- /** Coupon was already applied and can not be used anymore. */
1840
+ /** The coupon has been applied and can't be used again. */
1811
1841
  APPLIED = "APPLIED",
1812
- /** Coupon was deleted. */
1842
+ /** The coupon has been deleted and is no longer valid. */
1813
1843
  DELETED = "DELETED"
1814
1844
  }
1815
1845
  interface Coupon$2 extends CouponDiscountTypeOptionsOneOf$2, CouponScopeOrMinSubtotalOneOf$2 {
@@ -1902,7 +1932,7 @@ interface LoyaltyPoints {
1902
1932
  */
1903
1933
  transactionId?: string;
1904
1934
  /**
1905
- * Loyalty points amount given.
1935
+ * The number of loyalty points awarded.
1906
1936
  * @readonly
1907
1937
  */
1908
1938
  amount?: number;
@@ -2641,7 +2671,6 @@ declare namespace meta$2 {
2641
2671
  export { type __PublicMethodMetaInfo$2 as __PublicMethodMetaInfo, meta$2_getReferralReward as getReferralReward, meta$2_queryReferralRewards as queryReferralRewards };
2642
2672
  }
2643
2673
 
2644
- /** ReferredFriend is the main entity of ReferredFriends that can be used for lorem ipsum dolor */
2645
2674
  interface ReferredFriend$1 {
2646
2675
  /**
2647
2676
  * ReferredFriend ID.
@@ -2685,6 +2714,8 @@ declare enum Status$1 {
2685
2714
  ACTIONS_COMPLETED = "ACTIONS_COMPLETED"
2686
2715
  }
2687
2716
  interface CreateReferredFriendRequest$1 {
2717
+ /** Referral code for referred friend */
2718
+ referralCode?: string | null;
2688
2719
  }
2689
2720
  interface CreateReferredFriendResponse$1 {
2690
2721
  /** The created ReferredFriend. */
@@ -2727,26 +2758,32 @@ interface QueryReferredFriendRequest$1 {
2727
2758
  query: CursorQuery$3;
2728
2759
  }
2729
2760
  interface CursorQuery$3 extends CursorQueryPagingMethodOneOf$3 {
2730
- /** Cursor token pointing to a page of results. Not used in the first request. Following requests use the cursor token and not `filter` or `sort`. */
2761
+ /**
2762
+ * Cursor paging options.
2763
+ *
2764
+ * Learn more about [cursor paging](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#cursor-paging).
2765
+ */
2731
2766
  cursorPaging?: CursorPaging$3;
2732
2767
  /**
2733
- * Filter object in the following format:
2734
- * `"filter" : {
2735
- * "fieldName1": "value1",
2736
- * "fieldName2":{"$operator":"value2"}
2737
- * }`
2738
- * Example of operators: `$eq`, `$ne`, `$lt`, `$lte`, `$gt`, `$gte`, `$in`, `$hasSome`, `$hasAll`, `$startsWith`, `$contains`
2768
+ * Filter object.
2769
+ *
2770
+ * Learn more about the [filter section](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#the-filter-section).
2739
2771
  */
2740
2772
  filter?: Record<string, any> | null;
2741
2773
  /**
2742
- * Sort object in the following format:
2743
- * `[{"fieldName":"sortField1","order":"ASC"},{"fieldName":"sortField2","order":"DESC"}]`
2774
+ * Sort object.
2775
+ *
2776
+ * Learn more about the [sort section](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#the-sort-section).
2744
2777
  */
2745
2778
  sort?: Sorting$3[];
2746
2779
  }
2747
2780
  /** @oneof */
2748
2781
  interface CursorQueryPagingMethodOneOf$3 {
2749
- /** Cursor token pointing to a page of results. Not used in the first request. Following requests use the cursor token and not `filter` or `sort`. */
2782
+ /**
2783
+ * Cursor paging options.
2784
+ *
2785
+ * Learn more about [cursor paging](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#cursor-paging).
2786
+ */
2750
2787
  cursorPaging?: CursorPaging$3;
2751
2788
  }
2752
2789
  interface Sorting$3 {
@@ -2777,7 +2814,7 @@ interface QueryReferredFriendResponse$1 {
2777
2814
  metadata?: CursorPagingMetadata$3;
2778
2815
  }
2779
2816
  interface CursorPagingMetadata$3 {
2780
- /** Number of items returned in the response. */
2817
+ /** Number of items returned in current page. */
2781
2818
  count?: number | null;
2782
2819
  /** Cursor strings that point to the next page, previous page, or both. */
2783
2820
  cursors?: Cursors$3;
@@ -2817,7 +2854,6 @@ interface QueryReferredFriendResponseNonNullableFields$1 {
2817
2854
  referredFriends: ReferredFriendNonNullableFields$1[];
2818
2855
  }
2819
2856
 
2820
- /** ReferredFriend is the main entity of ReferredFriends that can be used for lorem ipsum dolor */
2821
2857
  interface ReferredFriend {
2822
2858
  /**
2823
2859
  * ReferredFriend ID.
@@ -2861,6 +2897,8 @@ declare enum Status {
2861
2897
  ACTIONS_COMPLETED = "ACTIONS_COMPLETED"
2862
2898
  }
2863
2899
  interface CreateReferredFriendRequest {
2900
+ /** Referral code for referred friend */
2901
+ referralCode?: string | null;
2864
2902
  }
2865
2903
  interface CreateReferredFriendResponse {
2866
2904
  /** The created ReferredFriend. */
@@ -2903,26 +2941,32 @@ interface QueryReferredFriendRequest {
2903
2941
  query: CursorQuery$2;
2904
2942
  }
2905
2943
  interface CursorQuery$2 extends CursorQueryPagingMethodOneOf$2 {
2906
- /** Cursor token pointing to a page of results. Not used in the first request. Following requests use the cursor token and not `filter` or `sort`. */
2944
+ /**
2945
+ * Cursor paging options.
2946
+ *
2947
+ * Learn more about [cursor paging](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#cursor-paging).
2948
+ */
2907
2949
  cursorPaging?: CursorPaging$2;
2908
2950
  /**
2909
- * Filter object in the following format:
2910
- * `"filter" : {
2911
- * "fieldName1": "value1",
2912
- * "fieldName2":{"$operator":"value2"}
2913
- * }`
2914
- * Example of operators: `$eq`, `$ne`, `$lt`, `$lte`, `$gt`, `$gte`, `$in`, `$hasSome`, `$hasAll`, `$startsWith`, `$contains`
2951
+ * Filter object.
2952
+ *
2953
+ * Learn more about the [filter section](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#the-filter-section).
2915
2954
  */
2916
2955
  filter?: Record<string, any> | null;
2917
2956
  /**
2918
- * Sort object in the following format:
2919
- * `[{"fieldName":"sortField1","order":"ASC"},{"fieldName":"sortField2","order":"DESC"}]`
2957
+ * Sort object.
2958
+ *
2959
+ * Learn more about the [sort section](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#the-sort-section).
2920
2960
  */
2921
2961
  sort?: Sorting$2[];
2922
2962
  }
2923
2963
  /** @oneof */
2924
2964
  interface CursorQueryPagingMethodOneOf$2 {
2925
- /** Cursor token pointing to a page of results. Not used in the first request. Following requests use the cursor token and not `filter` or `sort`. */
2965
+ /**
2966
+ * Cursor paging options.
2967
+ *
2968
+ * Learn more about [cursor paging](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#cursor-paging).
2969
+ */
2926
2970
  cursorPaging?: CursorPaging$2;
2927
2971
  }
2928
2972
  interface Sorting$2 {
@@ -2953,7 +2997,7 @@ interface QueryReferredFriendResponse {
2953
2997
  metadata?: CursorPagingMetadata$2;
2954
2998
  }
2955
2999
  interface CursorPagingMetadata$2 {
2956
- /** Number of items returned in the response. */
3000
+ /** Number of items returned in current page. */
2957
3001
  count?: number | null;
2958
3002
  /** Cursor strings that point to the next page, previous page, or both. */
2959
3003
  cursors?: Cursors$2;
@@ -3031,55 +3075,58 @@ declare namespace meta$1 {
3031
3075
  /** ReferringCustomer is the main entity of ReferringCustomers. */
3032
3076
  interface ReferringCustomer$1 {
3033
3077
  /**
3034
- * ReferringCustomer id.
3078
+ * ID of the referring customer.
3035
3079
  * @readonly
3036
3080
  */
3037
3081
  id?: string;
3038
3082
  /**
3039
- * Contact id.
3083
+ * Contact ID associated with the referring customer.
3040
3084
  * @readonly
3041
3085
  */
3042
3086
  contactId?: string;
3043
3087
  /**
3044
- * Referral code.
3088
+ * Unique code for the referral. For example, `GxpxwAoMqxH8`.
3045
3089
  * @readonly
3046
3090
  */
3047
3091
  referralCode?: string;
3048
- /** Represents the current state of an item. Each time the item is modified, its `revision` changes by the server. for an update operation to succeed, you MUST pass the latest revision. */
3092
+ /**
3093
+ * Revision number, which increments by 1 each time the referring customer is updated.
3094
+ * To prevent conflicting changes, the current revision must be passed when updating the referring customer.
3095
+ */
3049
3096
  revision?: string | null;
3050
3097
  /**
3051
- * Represents the time this ReferringCustomer was created.
3098
+ * Date and time the referring customer was created.
3052
3099
  * @readonly
3053
3100
  */
3054
3101
  createdDate?: Date;
3055
3102
  /**
3056
- * Represents the time this ReferringCustomer was last updated.
3103
+ * Date and time the referring customer was last updated.
3057
3104
  * @readonly
3058
3105
  */
3059
3106
  updatedDate?: Date;
3060
3107
  }
3061
3108
  interface GenerateReferringCustomerForContactRequest$1 {
3062
- /** Contact id or "me" to generate current identity's referring customer. */
3109
+ /** Contact ID or `"me"` to generate the current identity's referring customer. */
3063
3110
  contactId: string;
3064
3111
  }
3065
3112
  interface GenerateReferringCustomerForContactResponse$1 {
3066
- /** The created ReferringCustomer. */
3113
+ /** Created referring customer. */
3067
3114
  referringCustomer?: ReferringCustomer$1;
3068
3115
  }
3069
3116
  interface GetReferringCustomerRequest$1 {
3070
- /** Id of the ReferringCustomer to retrieve. */
3117
+ /** ID of the referring customer to retrieve. */
3071
3118
  referringCustomerId: string;
3072
3119
  }
3073
3120
  interface GetReferringCustomerResponse$1 {
3074
- /** The retrieved ReferringCustomer. */
3121
+ /** Retrieved referring customer. */
3075
3122
  referringCustomer?: ReferringCustomer$1;
3076
3123
  }
3077
3124
  interface GetReferringCustomerByReferralCodeRequest$1 {
3078
- /** Referral Code of the ReferringCustomer to retrieve. */
3125
+ /** Referral code of the referring customer to retrieve. */
3079
3126
  referralCode: string;
3080
3127
  }
3081
3128
  interface GetReferringCustomerByReferralCodeResponse$1 {
3082
- /** The retrieved ReferringCustomer. */
3129
+ /** Retrieved referring customer. */
3083
3130
  referringCustomer?: ReferringCustomer$1;
3084
3131
  }
3085
3132
  interface QueryReferringCustomersRequest$1 {
@@ -3087,26 +3134,32 @@ interface QueryReferringCustomersRequest$1 {
3087
3134
  query: CursorQuery$1;
3088
3135
  }
3089
3136
  interface CursorQuery$1 extends CursorQueryPagingMethodOneOf$1 {
3090
- /** Cursor token pointing to a page of results. Not used in the first request. Following requests use the cursor token and not `filter` or `sort`. */
3137
+ /**
3138
+ * Cursor paging options.
3139
+ *
3140
+ * Learn more about [cursor paging](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#cursor-paging).
3141
+ */
3091
3142
  cursorPaging?: CursorPaging$1;
3092
3143
  /**
3093
- * Filter object in the following format:
3094
- * `"filter" : {
3095
- * "fieldName1": "value1",
3096
- * "fieldName2":{"$operator":"value2"}
3097
- * }`
3098
- * Example of operators: `$eq`, `$ne`, `$lt`, `$lte`, `$gt`, `$gte`, `$in`, `$hasSome`, `$hasAll`, `$startsWith`, `$contains`
3144
+ * Filter object.
3145
+ *
3146
+ * Learn more about the [filter section](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#the-filter-section).
3099
3147
  */
3100
3148
  filter?: Record<string, any> | null;
3101
3149
  /**
3102
- * Sort object in the following format:
3103
- * `[{"fieldName":"sortField1","order":"ASC"},{"fieldName":"sortField2","order":"DESC"}]`
3150
+ * Sort object.
3151
+ *
3152
+ * Learn more about the [sort section](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#the-sort-section).
3104
3153
  */
3105
3154
  sort?: Sorting$1[];
3106
3155
  }
3107
3156
  /** @oneof */
3108
3157
  interface CursorQueryPagingMethodOneOf$1 {
3109
- /** Cursor token pointing to a page of results. Not used in the first request. Following requests use the cursor token and not `filter` or `sort`. */
3158
+ /**
3159
+ * Cursor paging options.
3160
+ *
3161
+ * Learn more about [cursor paging](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#cursor-paging).
3162
+ */
3110
3163
  cursorPaging?: CursorPaging$1;
3111
3164
  }
3112
3165
  interface Sorting$1 {
@@ -3131,13 +3184,13 @@ interface CursorPaging$1 {
3131
3184
  cursor?: string | null;
3132
3185
  }
3133
3186
  interface QueryReferringCustomersResponse$1 {
3134
- /** The retrieved ReferringCustomers. */
3187
+ /** List of retrieved referring customers. */
3135
3188
  referringCustomers?: ReferringCustomer$1[];
3136
3189
  /** Paging metadata. */
3137
3190
  metadata?: CursorPagingMetadata$1;
3138
3191
  }
3139
3192
  interface CursorPagingMetadata$1 {
3140
- /** Number of items returned in the response. */
3193
+ /** Number of items returned in current page. */
3141
3194
  count?: number | null;
3142
3195
  /** Cursor strings that point to the next page, previous page, or both. */
3143
3196
  cursors?: Cursors$1;
@@ -3156,9 +3209,9 @@ interface Cursors$1 {
3156
3209
  prev?: string | null;
3157
3210
  }
3158
3211
  interface DeleteReferringCustomerRequest$1 {
3159
- /** Id of the ReferringCustomer to delete. */
3212
+ /** ID of the referring customer to delete. */
3160
3213
  referringCustomerId: string;
3161
- /** The revision of the ReferringCustomer. */
3214
+ /** Revision number of the referring customer. */
3162
3215
  revision?: string;
3163
3216
  }
3164
3217
  interface DeleteReferringCustomerResponse$1 {
@@ -3184,55 +3237,58 @@ interface QueryReferringCustomersResponseNonNullableFields$1 {
3184
3237
  /** ReferringCustomer is the main entity of ReferringCustomers. */
3185
3238
  interface ReferringCustomer {
3186
3239
  /**
3187
- * ReferringCustomer id.
3240
+ * ID of the referring customer.
3188
3241
  * @readonly
3189
3242
  */
3190
3243
  _id?: string;
3191
3244
  /**
3192
- * Contact id.
3245
+ * Contact ID associated with the referring customer.
3193
3246
  * @readonly
3194
3247
  */
3195
3248
  contactId?: string;
3196
3249
  /**
3197
- * Referral code.
3250
+ * Unique code for the referral. For example, `GxpxwAoMqxH8`.
3198
3251
  * @readonly
3199
3252
  */
3200
3253
  referralCode?: string;
3201
- /** Represents the current state of an item. Each time the item is modified, its `revision` changes by the server. for an update operation to succeed, you MUST pass the latest revision. */
3254
+ /**
3255
+ * Revision number, which increments by 1 each time the referring customer is updated.
3256
+ * To prevent conflicting changes, the current revision must be passed when updating the referring customer.
3257
+ */
3202
3258
  revision?: string | null;
3203
3259
  /**
3204
- * Represents the time this ReferringCustomer was created.
3260
+ * Date and time the referring customer was created.
3205
3261
  * @readonly
3206
3262
  */
3207
3263
  _createdDate?: Date;
3208
3264
  /**
3209
- * Represents the time this ReferringCustomer was last updated.
3265
+ * Date and time the referring customer was last updated.
3210
3266
  * @readonly
3211
3267
  */
3212
3268
  _updatedDate?: Date;
3213
3269
  }
3214
3270
  interface GenerateReferringCustomerForContactRequest {
3215
- /** Contact id or "me" to generate current identity's referring customer. */
3271
+ /** Contact ID or `"me"` to generate the current identity's referring customer. */
3216
3272
  contactId: string;
3217
3273
  }
3218
3274
  interface GenerateReferringCustomerForContactResponse {
3219
- /** The created ReferringCustomer. */
3275
+ /** Created referring customer. */
3220
3276
  referringCustomer?: ReferringCustomer;
3221
3277
  }
3222
3278
  interface GetReferringCustomerRequest {
3223
- /** Id of the ReferringCustomer to retrieve. */
3279
+ /** ID of the referring customer to retrieve. */
3224
3280
  referringCustomerId: string;
3225
3281
  }
3226
3282
  interface GetReferringCustomerResponse {
3227
- /** The retrieved ReferringCustomer. */
3283
+ /** Retrieved referring customer. */
3228
3284
  referringCustomer?: ReferringCustomer;
3229
3285
  }
3230
3286
  interface GetReferringCustomerByReferralCodeRequest {
3231
- /** Referral Code of the ReferringCustomer to retrieve. */
3287
+ /** Referral code of the referring customer to retrieve. */
3232
3288
  referralCode: string;
3233
3289
  }
3234
3290
  interface GetReferringCustomerByReferralCodeResponse {
3235
- /** The retrieved ReferringCustomer. */
3291
+ /** Retrieved referring customer. */
3236
3292
  referringCustomer?: ReferringCustomer;
3237
3293
  }
3238
3294
  interface QueryReferringCustomersRequest {
@@ -3240,26 +3296,32 @@ interface QueryReferringCustomersRequest {
3240
3296
  query: CursorQuery;
3241
3297
  }
3242
3298
  interface CursorQuery extends CursorQueryPagingMethodOneOf {
3243
- /** Cursor token pointing to a page of results. Not used in the first request. Following requests use the cursor token and not `filter` or `sort`. */
3299
+ /**
3300
+ * Cursor paging options.
3301
+ *
3302
+ * Learn more about [cursor paging](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#cursor-paging).
3303
+ */
3244
3304
  cursorPaging?: CursorPaging;
3245
3305
  /**
3246
- * Filter object in the following format:
3247
- * `"filter" : {
3248
- * "fieldName1": "value1",
3249
- * "fieldName2":{"$operator":"value2"}
3250
- * }`
3251
- * Example of operators: `$eq`, `$ne`, `$lt`, `$lte`, `$gt`, `$gte`, `$in`, `$hasSome`, `$hasAll`, `$startsWith`, `$contains`
3306
+ * Filter object.
3307
+ *
3308
+ * Learn more about the [filter section](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#the-filter-section).
3252
3309
  */
3253
3310
  filter?: Record<string, any> | null;
3254
3311
  /**
3255
- * Sort object in the following format:
3256
- * `[{"fieldName":"sortField1","order":"ASC"},{"fieldName":"sortField2","order":"DESC"}]`
3312
+ * Sort object.
3313
+ *
3314
+ * Learn more about the [sort section](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#the-sort-section).
3257
3315
  */
3258
3316
  sort?: Sorting[];
3259
3317
  }
3260
3318
  /** @oneof */
3261
3319
  interface CursorQueryPagingMethodOneOf {
3262
- /** Cursor token pointing to a page of results. Not used in the first request. Following requests use the cursor token and not `filter` or `sort`. */
3320
+ /**
3321
+ * Cursor paging options.
3322
+ *
3323
+ * Learn more about [cursor paging](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#cursor-paging).
3324
+ */
3263
3325
  cursorPaging?: CursorPaging;
3264
3326
  }
3265
3327
  interface Sorting {
@@ -3284,13 +3346,13 @@ interface CursorPaging {
3284
3346
  cursor?: string | null;
3285
3347
  }
3286
3348
  interface QueryReferringCustomersResponse {
3287
- /** The retrieved ReferringCustomers. */
3349
+ /** List of retrieved referring customers. */
3288
3350
  referringCustomers?: ReferringCustomer[];
3289
3351
  /** Paging metadata. */
3290
3352
  metadata?: CursorPagingMetadata;
3291
3353
  }
3292
3354
  interface CursorPagingMetadata {
3293
- /** Number of items returned in the response. */
3355
+ /** Number of items returned in current page. */
3294
3356
  count?: number | null;
3295
3357
  /** Cursor strings that point to the next page, previous page, or both. */
3296
3358
  cursors?: Cursors;
@@ -3309,9 +3371,9 @@ interface Cursors {
3309
3371
  prev?: string | null;
3310
3372
  }
3311
3373
  interface DeleteReferringCustomerRequest {
3312
- /** Id of the ReferringCustomer to delete. */
3374
+ /** ID of the referring customer to delete. */
3313
3375
  referringCustomerId: string;
3314
- /** The revision of the ReferringCustomer. */
3376
+ /** Revision number of the referring customer. */
3315
3377
  revision?: string;
3316
3378
  }
3317
3379
  interface DeleteReferringCustomerResponse {