@wix/referral 1.0.13 → 1.0.15

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.
@@ -952,106 +952,109 @@ declare namespace meta$4 {
952
952
  }
953
953
 
954
954
  interface ReferralEvent$1 extends ReferralEventEventTypeOneOf$1 {
955
- /** ReferredFriendSignupEvent is an event that is triggered when a referred friend signs up. */
955
+ /** Event triggered when a referred friend signs up. */
956
956
  referredFriendSignupEvent?: ReferredFriendSignupEvent$1;
957
- /** SuccessfulReferralEvent is an event that is triggered when a referral is successful. */
957
+ /** Event triggered when a referral is successful. For example, customer places and pays for an order. */
958
958
  successfulReferralEvent?: V1SuccessfulReferralEvent$1;
959
- /** ActionEvent is an event that is triggered when an action is performed. */
959
+ /** Event triggered when an action is performed. For example, placing an order. */
960
960
  actionEvent?: V1ActionEvent$1;
961
- /** RewardEvent is an event that is triggered when a reward is given. */
961
+ /** Event triggered when a reward is given. */
962
962
  rewardEvent?: RewardEvent$1;
963
963
  /**
964
- * ReferralEvent ID.
964
+ * Referral event ID.
965
965
  * @readonly
966
966
  */
967
967
  id?: string | null;
968
- /** Represents the current state of an item. Each time the item is modified, its `revision` changes. for an update operation to succeed, you MUST pass the latest revision. */
968
+ /**
969
+ * Revision number, which increments by 1 each time the referral event is updated.
970
+ * To prevent conflicting changes, the current revision must be passed when updating the referral event.
971
+ */
969
972
  revision?: string | null;
970
973
  /**
971
- * Represents the time this ReferralEvent was created.
974
+ * Date and time the referral event was created.
972
975
  * @readonly
973
976
  */
974
977
  createdDate?: Date;
975
978
  /**
976
- * Represents the time this ReferralEvent was last updated.
979
+ * Date and time the referral event was last updated.
977
980
  * @readonly
978
981
  */
979
982
  updatedDate?: Date;
980
983
  }
981
984
  /** @oneof */
982
985
  interface ReferralEventEventTypeOneOf$1 {
983
- /** ReferredFriendSignupEvent is an event that is triggered when a referred friend signs up. */
986
+ /** Event triggered when a referred friend signs up. */
984
987
  referredFriendSignupEvent?: ReferredFriendSignupEvent$1;
985
- /** SuccessfulReferralEvent is an event that is triggered when a referral is successful. */
988
+ /** Event triggered when a referral is successful. For example, customer places and pays for an order. */
986
989
  successfulReferralEvent?: V1SuccessfulReferralEvent$1;
987
- /** ActionEvent is an event that is triggered when an action is performed. */
990
+ /** Event triggered when an action is performed. For example, placing an order. */
988
991
  actionEvent?: V1ActionEvent$1;
989
- /** RewardEvent is an event that is triggered when a reward is given. */
992
+ /** Event triggered when a reward is given. */
990
993
  rewardEvent?: RewardEvent$1;
991
994
  }
992
995
  interface ReferredFriendSignupEvent$1 {
993
- /** The referred friend ID. */
996
+ /** ID of the referred friend */
994
997
  referredFriendId?: string;
995
998
  }
996
999
  interface V1SuccessfulReferralEvent$1 {
997
- /** The referred friend ID. */
1000
+ /** ID of the referred friend */
998
1001
  referredFriendId?: string;
999
- /** The referring customer ID. */
1002
+ /** ID of the referring customer */
1000
1003
  referringCustomerId?: string;
1001
1004
  }
1002
1005
  interface V1ActionEvent$1 {
1003
- /** The referred friend ID. */
1006
+ /** ID of the referred friend */
1004
1007
  referredFriendId?: string;
1005
- /** The referring customer ID. */
1008
+ /** ID of the referring customer */
1006
1009
  referringCustomerId?: string;
1007
- /** The trigger of the action. */
1010
+ /** Trigger for the action */
1008
1011
  trigger?: V1Trigger$1;
1009
- /** Amount. */
1012
+ /** Amount associated with the action. */
1010
1013
  amount?: string | null;
1011
- /** Currency. */
1014
+ /** Currency of the amount. */
1012
1015
  currency?: string | null;
1013
- /** Order ID. */
1016
+ /** ID of the associated order. */
1014
1017
  orderId?: string | null;
1015
1018
  }
1016
1019
  interface V1Trigger$1 {
1017
- /** The app id of the app that triggered the event. */
1020
+ /** ID of the app that triggered the event */
1018
1021
  appId?: string;
1019
- /** The activity type that triggered the event. */
1022
+ /** Type of activity that triggered the event */
1020
1023
  activityType?: string;
1021
1024
  }
1022
1025
  interface RewardEvent$1 extends RewardEventReceiverOneOf$1 {
1023
1026
  /**
1024
- * The referring customer ID.
1027
+ * ID of the rewarded referring customer.
1025
1028
  * @readonly
1026
1029
  */
1027
1030
  rewardedReferringCustomerId?: string;
1028
1031
  /**
1029
- * The referred friend ID.
1032
+ * ID of the rewarded referred friend.
1030
1033
  * @readonly
1031
1034
  */
1032
1035
  rewardedReferredFriendId?: string;
1033
- /** The referral reward ID. */
1036
+ /** ID of the referral reward. */
1034
1037
  referralRewardId?: string;
1035
- /** The reward type. */
1038
+ /** Type of reward. */
1036
1039
  rewardType?: Reward$1;
1037
1040
  }
1038
1041
  /** @oneof */
1039
1042
  interface RewardEventReceiverOneOf$1 {
1040
1043
  /**
1041
- * The referring customer ID.
1044
+ * ID of the rewarded referring customer.
1042
1045
  * @readonly
1043
1046
  */
1044
1047
  rewardedReferringCustomerId?: string;
1045
1048
  /**
1046
- * The referred friend ID.
1049
+ * ID of the rewarded referred friend.
1047
1050
  * @readonly
1048
1051
  */
1049
1052
  rewardedReferredFriendId?: string;
1050
1053
  }
1051
1054
  declare enum Reward$1 {
1052
- /** Unknown reward type. */
1055
+ /** Unknown reward. This field is not used. */
1053
1056
  UNKNOWN = "UNKNOWN",
1054
- /** Reward is a coupon. */
1057
+ /** Reward is a coupon */
1055
1058
  COUPON = "COUPON",
1056
1059
  /** Reward is loyalty points. */
1057
1060
  LOYALTY_POINTS = "LOYALTY_POINTS",
@@ -1059,15 +1062,15 @@ declare enum Reward$1 {
1059
1062
  NOTHING = "NOTHING"
1060
1063
  }
1061
1064
  interface GetReferralEventRequest$1 {
1062
- /** Id of the ReferralEvent to retrieve */
1065
+ /** ID of the referral event to retrieve. */
1063
1066
  referralEventId: string;
1064
1067
  }
1065
1068
  interface GetReferralEventResponse$1 {
1066
- /** The retrieved ReferralEvent */
1069
+ /** Retrieved referral event. */
1067
1070
  referralEvent?: ReferralEvent$1;
1068
1071
  }
1069
1072
  interface QueryReferralEventRequest$1 {
1070
- /** Query to filter ReferralEvents. */
1073
+ /** Query to filter referral events */
1071
1074
  query: CursorQuery$7;
1072
1075
  }
1073
1076
  interface CursorQuery$7 extends CursorQueryPagingMethodOneOf$7 {
@@ -1121,9 +1124,9 @@ interface CursorPaging$7 {
1121
1124
  cursor?: string | null;
1122
1125
  }
1123
1126
  interface QueryReferralEventResponse$1 {
1124
- /** List of ReferralEvents that match the query. */
1127
+ /** List of referral events. */
1125
1128
  referralEvents?: ReferralEvent$1[];
1126
- /** Paging metadata. */
1129
+ /** Metadata for the paginated results. */
1127
1130
  metadata?: CursorPagingMetadata$7;
1128
1131
  }
1129
1132
  interface CursorPagingMetadata$7 {
@@ -1148,72 +1151,71 @@ interface Cursors$7 {
1148
1151
  interface GetReferralStatisticsRequest$1 {
1149
1152
  }
1150
1153
  interface GetReferralStatisticsResponse$1 {
1151
- /** Total sign ups completed by referred friends */
1154
+ /** Total number of sign-ups completed by referred friends. */
1152
1155
  totalSignUpsCompleted?: number;
1153
- /** Total actions completed by referred friends */
1156
+ /** Total number of actions completed by referred friends. */
1154
1157
  totalActionsCompleted?: number;
1155
- /** Total amount of purchases made by referred friends */
1158
+ /** Total amount of purchases made by referred friends. */
1156
1159
  totalAmountGenerated?: string;
1157
1160
  }
1158
1161
  interface QueryReferringCustomerTotalsRequest$1 {
1159
- /** Query to filter ReferringCustomerTotals. */
1162
+ /** Query to filter referring customer totals. */
1160
1163
  query?: CursorQuery$7;
1161
- /** List of contact ids to filter ReferringCustomerTotals. */
1164
+ /** List of contact IDs to filter referring customer totals. */
1162
1165
  contactIds?: string[];
1163
1166
  }
1164
1167
  interface QueryReferringCustomerTotalsResponse$1 {
1165
- /** List of ReferringCustomerTotals that match the query. */
1166
1168
  referringCustomerTotals?: ReferringCustomerTotal$1[];
1167
- /** Paging metadata. */
1169
+ /** Paging metadata */
1168
1170
  metadata?: CursorPagingMetadata$7;
1169
1171
  }
1170
1172
  interface ReferringCustomerTotal$1 {
1171
1173
  /**
1172
- * Referring customer id.
1174
+ * ID of the referring customer.
1173
1175
  * @readonly
1174
1176
  */
1175
1177
  referringCustomerId?: string;
1176
1178
  /**
1177
- * Contact id.
1179
+ * Contact ID.
1178
1180
  * @readonly
1179
1181
  */
1180
1182
  contactId?: string;
1181
1183
  /**
1182
- * Last successful referral date.
1184
+ * Date and time of the last successful referral.
1183
1185
  * @readonly
1184
1186
  */
1185
1187
  lastSuccessfulReferral?: Date;
1186
1188
  /**
1187
- * Total successful referrals made by this customer.
1189
+ * Total number of successful referrals made by this customer.
1188
1190
  * @readonly
1189
1191
  */
1190
1192
  totalSuccessfulReferrals?: number;
1191
1193
  /**
1192
- * Total amount generated by friends referred by this customer.
1194
+ * Total amount of revenue generated by friends referred by this customer.
1193
1195
  * @readonly
1194
1196
  */
1195
1197
  totalAmountGenerated?: string;
1196
1198
  /**
1197
- * Last friend action date.
1199
+ * Date and time of the last friend action.
1198
1200
  * @readonly
1199
1201
  */
1200
1202
  lastFriendAction?: Date;
1201
1203
  /**
1202
- * Total friends that have actions done.
1204
+ * Number of friends who have completed actions.
1203
1205
  * @readonly
1204
1206
  */
1205
1207
  totalFriendsWithActions?: number;
1206
1208
  }
1207
1209
  interface QueryReferredFriendActionsRequest$1 {
1208
- /** Query to filter ReferredFriendActions. */
1210
+ /** Query to filter referred friend actions. */
1209
1211
  query?: CursorQuery$7;
1210
- /** List of contact ids to filter ReferredFriendActions. */
1212
+ /** List of contact IDs to filter referred friend actions. */
1211
1213
  contactIds?: string[];
1212
1214
  }
1213
1215
  interface QueryReferredFriendActionsResponse$1 {
1214
- /** List of ReferredFriendActions that match the query. */
1216
+ /** List of referred friend actions matching the query. */
1215
1217
  referredFriendActions?: ReferredFriendAction$1[];
1216
- /** Paging metadata. */
1218
+ /** Paging metadata */
1217
1219
  metadata?: CursorPagingMetadata$7;
1218
1220
  }
1219
1221
  interface ReferredFriendAction$1 extends ReferredFriendActionRewardTypeOptionsOneOf$1 {
@@ -1222,28 +1224,28 @@ interface ReferredFriendAction$1 extends ReferredFriendActionRewardTypeOptionsOn
1222
1224
  /** Loyalty points reward type options. */
1223
1225
  loyaltyPoints?: LoyaltyPoints$1;
1224
1226
  /**
1225
- * Referred friend id.
1227
+ * Referred friend ID.
1226
1228
  * @readonly
1227
1229
  */
1228
1230
  referredFriendId?: string;
1229
1231
  /**
1230
- * Contact id.
1232
+ * Contact ID.
1231
1233
  * @readonly
1232
1234
  */
1233
1235
  contactId?: string;
1234
1236
  /**
1235
- * First action trigger.
1237
+ * Trigger for the first action.
1236
1238
  * @readonly
1237
1239
  */
1238
1240
  trigger?: V1Trigger$1;
1239
1241
  /**
1240
- * First action date.
1242
+ * Date and time of the first action.
1241
1243
  * @readonly
1242
1244
  */
1243
1245
  actionDate?: Date;
1244
- /** Issued reward type. */
1246
+ /** Type of issued reward. */
1245
1247
  rewardType?: Reward$1;
1246
- /** Total number of actions. */
1248
+ /** Number of actions completed. */
1247
1249
  totalActions?: number;
1248
1250
  /**
1249
1251
  * Total amount spent by this referred friend.
@@ -1251,7 +1253,7 @@ interface ReferredFriendAction$1 extends ReferredFriendActionRewardTypeOptionsOn
1251
1253
  */
1252
1254
  totalAmountSpent?: string;
1253
1255
  /**
1254
- * friend signup date.
1256
+ * Date and time of friend signup.
1255
1257
  * @readonly
1256
1258
  */
1257
1259
  signupDate?: Date;
@@ -1492,106 +1494,109 @@ interface QueryReferredFriendActionsResponseNonNullableFields$1 {
1492
1494
  }
1493
1495
 
1494
1496
  interface ReferralEvent extends ReferralEventEventTypeOneOf {
1495
- /** ReferredFriendSignupEvent is an event that is triggered when a referred friend signs up. */
1497
+ /** Event triggered when a referred friend signs up. */
1496
1498
  referredFriendSignupEvent?: ReferredFriendSignupEvent;
1497
- /** SuccessfulReferralEvent is an event that is triggered when a referral is successful. */
1499
+ /** Event triggered when a referral is successful. For example, customer places and pays for an order. */
1498
1500
  successfulReferralEvent?: V1SuccessfulReferralEvent;
1499
- /** ActionEvent is an event that is triggered when an action is performed. */
1501
+ /** Event triggered when an action is performed. For example, placing an order. */
1500
1502
  actionEvent?: V1ActionEvent;
1501
- /** RewardEvent is an event that is triggered when a reward is given. */
1503
+ /** Event triggered when a reward is given. */
1502
1504
  rewardEvent?: RewardEvent;
1503
1505
  /**
1504
- * ReferralEvent ID.
1506
+ * Referral event ID.
1505
1507
  * @readonly
1506
1508
  */
1507
1509
  _id?: string | null;
1508
- /** Represents the current state of an item. Each time the item is modified, its `revision` changes. for an update operation to succeed, you MUST pass the latest revision. */
1510
+ /**
1511
+ * Revision number, which increments by 1 each time the referral event is updated.
1512
+ * To prevent conflicting changes, the current revision must be passed when updating the referral event.
1513
+ */
1509
1514
  revision?: string | null;
1510
1515
  /**
1511
- * Represents the time this ReferralEvent was created.
1516
+ * Date and time the referral event was created.
1512
1517
  * @readonly
1513
1518
  */
1514
1519
  _createdDate?: Date;
1515
1520
  /**
1516
- * Represents the time this ReferralEvent was last updated.
1521
+ * Date and time the referral event was last updated.
1517
1522
  * @readonly
1518
1523
  */
1519
1524
  _updatedDate?: Date;
1520
1525
  }
1521
1526
  /** @oneof */
1522
1527
  interface ReferralEventEventTypeOneOf {
1523
- /** ReferredFriendSignupEvent is an event that is triggered when a referred friend signs up. */
1528
+ /** Event triggered when a referred friend signs up. */
1524
1529
  referredFriendSignupEvent?: ReferredFriendSignupEvent;
1525
- /** SuccessfulReferralEvent is an event that is triggered when a referral is successful. */
1530
+ /** Event triggered when a referral is successful. For example, customer places and pays for an order. */
1526
1531
  successfulReferralEvent?: V1SuccessfulReferralEvent;
1527
- /** ActionEvent is an event that is triggered when an action is performed. */
1532
+ /** Event triggered when an action is performed. For example, placing an order. */
1528
1533
  actionEvent?: V1ActionEvent;
1529
- /** RewardEvent is an event that is triggered when a reward is given. */
1534
+ /** Event triggered when a reward is given. */
1530
1535
  rewardEvent?: RewardEvent;
1531
1536
  }
1532
1537
  interface ReferredFriendSignupEvent {
1533
- /** The referred friend ID. */
1538
+ /** ID of the referred friend */
1534
1539
  referredFriendId?: string;
1535
1540
  }
1536
1541
  interface V1SuccessfulReferralEvent {
1537
- /** The referred friend ID. */
1542
+ /** ID of the referred friend */
1538
1543
  referredFriendId?: string;
1539
- /** The referring customer ID. */
1544
+ /** ID of the referring customer */
1540
1545
  referringCustomerId?: string;
1541
1546
  }
1542
1547
  interface V1ActionEvent {
1543
- /** The referred friend ID. */
1548
+ /** ID of the referred friend */
1544
1549
  referredFriendId?: string;
1545
- /** The referring customer ID. */
1550
+ /** ID of the referring customer */
1546
1551
  referringCustomerId?: string;
1547
- /** The trigger of the action. */
1552
+ /** Trigger for the action */
1548
1553
  trigger?: V1Trigger;
1549
- /** Amount. */
1554
+ /** Amount associated with the action. */
1550
1555
  amount?: string | null;
1551
- /** Currency. */
1556
+ /** Currency of the amount. */
1552
1557
  currency?: string | null;
1553
- /** Order ID. */
1558
+ /** ID of the associated order. */
1554
1559
  orderId?: string | null;
1555
1560
  }
1556
1561
  interface V1Trigger {
1557
- /** The app id of the app that triggered the event. */
1562
+ /** ID of the app that triggered the event */
1558
1563
  appId?: string;
1559
- /** The activity type that triggered the event. */
1564
+ /** Type of activity that triggered the event */
1560
1565
  activityType?: string;
1561
1566
  }
1562
1567
  interface RewardEvent extends RewardEventReceiverOneOf {
1563
1568
  /**
1564
- * The referring customer ID.
1569
+ * ID of the rewarded referring customer.
1565
1570
  * @readonly
1566
1571
  */
1567
1572
  rewardedReferringCustomerId?: string;
1568
1573
  /**
1569
- * The referred friend ID.
1574
+ * ID of the rewarded referred friend.
1570
1575
  * @readonly
1571
1576
  */
1572
1577
  rewardedReferredFriendId?: string;
1573
- /** The referral reward ID. */
1578
+ /** ID of the referral reward. */
1574
1579
  referralRewardId?: string;
1575
- /** The reward type. */
1580
+ /** Type of reward. */
1576
1581
  rewardType?: Reward;
1577
1582
  }
1578
1583
  /** @oneof */
1579
1584
  interface RewardEventReceiverOneOf {
1580
1585
  /**
1581
- * The referring customer ID.
1586
+ * ID of the rewarded referring customer.
1582
1587
  * @readonly
1583
1588
  */
1584
1589
  rewardedReferringCustomerId?: string;
1585
1590
  /**
1586
- * The referred friend ID.
1591
+ * ID of the rewarded referred friend.
1587
1592
  * @readonly
1588
1593
  */
1589
1594
  rewardedReferredFriendId?: string;
1590
1595
  }
1591
1596
  declare enum Reward {
1592
- /** Unknown reward type. */
1597
+ /** Unknown reward. This field is not used. */
1593
1598
  UNKNOWN = "UNKNOWN",
1594
- /** Reward is a coupon. */
1599
+ /** Reward is a coupon */
1595
1600
  COUPON = "COUPON",
1596
1601
  /** Reward is loyalty points. */
1597
1602
  LOYALTY_POINTS = "LOYALTY_POINTS",
@@ -1599,15 +1604,15 @@ declare enum Reward {
1599
1604
  NOTHING = "NOTHING"
1600
1605
  }
1601
1606
  interface GetReferralEventRequest {
1602
- /** Id of the ReferralEvent to retrieve */
1607
+ /** ID of the referral event to retrieve. */
1603
1608
  referralEventId: string;
1604
1609
  }
1605
1610
  interface GetReferralEventResponse {
1606
- /** The retrieved ReferralEvent */
1611
+ /** Retrieved referral event. */
1607
1612
  referralEvent?: ReferralEvent;
1608
1613
  }
1609
1614
  interface QueryReferralEventRequest {
1610
- /** Query to filter ReferralEvents. */
1615
+ /** Query to filter referral events */
1611
1616
  query: CursorQuery$6;
1612
1617
  }
1613
1618
  interface CursorQuery$6 extends CursorQueryPagingMethodOneOf$6 {
@@ -1661,9 +1666,9 @@ interface CursorPaging$6 {
1661
1666
  cursor?: string | null;
1662
1667
  }
1663
1668
  interface QueryReferralEventResponse {
1664
- /** List of ReferralEvents that match the query. */
1669
+ /** List of referral events. */
1665
1670
  referralEvents?: ReferralEvent[];
1666
- /** Paging metadata. */
1671
+ /** Metadata for the paginated results. */
1667
1672
  metadata?: CursorPagingMetadata$6;
1668
1673
  }
1669
1674
  interface CursorPagingMetadata$6 {
@@ -1688,72 +1693,71 @@ interface Cursors$6 {
1688
1693
  interface GetReferralStatisticsRequest {
1689
1694
  }
1690
1695
  interface GetReferralStatisticsResponse {
1691
- /** Total sign ups completed by referred friends */
1696
+ /** Total number of sign-ups completed by referred friends. */
1692
1697
  totalSignUpsCompleted?: number;
1693
- /** Total actions completed by referred friends */
1698
+ /** Total number of actions completed by referred friends. */
1694
1699
  totalActionsCompleted?: number;
1695
- /** Total amount of purchases made by referred friends */
1700
+ /** Total amount of purchases made by referred friends. */
1696
1701
  totalAmountGenerated?: string;
1697
1702
  }
1698
1703
  interface QueryReferringCustomerTotalsRequest {
1699
- /** Query to filter ReferringCustomerTotals. */
1704
+ /** Query to filter referring customer totals. */
1700
1705
  query?: CursorQuery$6;
1701
- /** List of contact ids to filter ReferringCustomerTotals. */
1706
+ /** List of contact IDs to filter referring customer totals. */
1702
1707
  contactIds?: string[];
1703
1708
  }
1704
1709
  interface QueryReferringCustomerTotalsResponse {
1705
- /** List of ReferringCustomerTotals that match the query. */
1706
1710
  referringCustomerTotals?: ReferringCustomerTotal[];
1707
- /** Paging metadata. */
1711
+ /** Paging metadata */
1708
1712
  metadata?: CursorPagingMetadata$6;
1709
1713
  }
1710
1714
  interface ReferringCustomerTotal {
1711
1715
  /**
1712
- * Referring customer id.
1716
+ * ID of the referring customer.
1713
1717
  * @readonly
1714
1718
  */
1715
1719
  referringCustomerId?: string;
1716
1720
  /**
1717
- * Contact id.
1721
+ * Contact ID.
1718
1722
  * @readonly
1719
1723
  */
1720
1724
  contactId?: string;
1721
1725
  /**
1722
- * Last successful referral date.
1726
+ * Date and time of the last successful referral.
1723
1727
  * @readonly
1724
1728
  */
1725
1729
  lastSuccessfulReferral?: Date;
1726
1730
  /**
1727
- * Total successful referrals made by this customer.
1731
+ * Total number of successful referrals made by this customer.
1728
1732
  * @readonly
1729
1733
  */
1730
1734
  totalSuccessfulReferrals?: number;
1731
1735
  /**
1732
- * Total amount generated by friends referred by this customer.
1736
+ * Total amount of revenue generated by friends referred by this customer.
1733
1737
  * @readonly
1734
1738
  */
1735
1739
  totalAmountGenerated?: string;
1736
1740
  /**
1737
- * Last friend action date.
1741
+ * Date and time of the last friend action.
1738
1742
  * @readonly
1739
1743
  */
1740
1744
  lastFriendAction?: Date;
1741
1745
  /**
1742
- * Total friends that have actions done.
1746
+ * Number of friends who have completed actions.
1743
1747
  * @readonly
1744
1748
  */
1745
1749
  totalFriendsWithActions?: number;
1746
1750
  }
1747
1751
  interface QueryReferredFriendActionsRequest {
1748
- /** Query to filter ReferredFriendActions. */
1752
+ /** Query to filter referred friend actions. */
1749
1753
  query?: CursorQuery$6;
1750
- /** List of contact ids to filter ReferredFriendActions. */
1754
+ /** List of contact IDs to filter referred friend actions. */
1751
1755
  contactIds?: string[];
1752
1756
  }
1753
1757
  interface QueryReferredFriendActionsResponse {
1754
- /** List of ReferredFriendActions that match the query. */
1758
+ /** List of referred friend actions matching the query. */
1755
1759
  referredFriendActions?: ReferredFriendAction[];
1756
- /** Paging metadata. */
1760
+ /** Paging metadata */
1757
1761
  metadata?: CursorPagingMetadata$6;
1758
1762
  }
1759
1763
  interface ReferredFriendAction extends ReferredFriendActionRewardTypeOptionsOneOf {
@@ -1762,28 +1766,28 @@ interface ReferredFriendAction extends ReferredFriendActionRewardTypeOptionsOneO
1762
1766
  /** Loyalty points reward type options. */
1763
1767
  loyaltyPoints?: LoyaltyPoints;
1764
1768
  /**
1765
- * Referred friend id.
1769
+ * Referred friend ID.
1766
1770
  * @readonly
1767
1771
  */
1768
1772
  referredFriendId?: string;
1769
1773
  /**
1770
- * Contact id.
1774
+ * Contact ID.
1771
1775
  * @readonly
1772
1776
  */
1773
1777
  contactId?: string;
1774
1778
  /**
1775
- * First action trigger.
1779
+ * Trigger for the first action.
1776
1780
  * @readonly
1777
1781
  */
1778
1782
  trigger?: V1Trigger;
1779
1783
  /**
1780
- * First action date.
1784
+ * Date and time of the first action.
1781
1785
  * @readonly
1782
1786
  */
1783
1787
  actionDate?: Date;
1784
- /** Issued reward type. */
1788
+ /** Type of issued reward. */
1785
1789
  rewardType?: Reward;
1786
- /** Total number of actions. */
1790
+ /** Number of actions completed. */
1787
1791
  totalActions?: number;
1788
1792
  /**
1789
1793
  * Total amount spent by this referred friend.
@@ -1791,7 +1795,7 @@ interface ReferredFriendAction extends ReferredFriendActionRewardTypeOptionsOneO
1791
1795
  */
1792
1796
  totalAmountSpent?: string;
1793
1797
  /**
1794
- * friend signup date.
1798
+ * Date and time of friend signup.
1795
1799
  * @readonly
1796
1800
  */
1797
1801
  signupDate?: Date;
@@ -2673,34 +2677,35 @@ declare namespace meta$2 {
2673
2677
 
2674
2678
  interface ReferredFriend$1 {
2675
2679
  /**
2676
- * ReferredFriend ID.
2680
+ * ID of the referred friend.
2677
2681
  * @readonly
2678
2682
  */
2679
2683
  id?: string;
2680
2684
  /**
2681
- * ReferredFriend Contact ID.
2685
+ * Contact ID of the referred friend.
2682
2686
  * @readonly
2683
2687
  */
2684
2688
  contactId?: string;
2685
2689
  /**
2686
- * Customer who referred.
2690
+ * ID of the customer who referred this friend.
2687
2691
  * @readonly
2688
2692
  */
2689
2693
  referringCustomerId?: string;
2690
- /** Status of the ReferredFriend. */
2694
+ /** Status of the referred friend. */
2691
2695
  status?: Status$1;
2692
2696
  /**
2693
- * 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.
2697
+ * Revision number, which increments by 1 each time the referred friend is updated.
2698
+ * To prevent conflicting changes, the current revision must be passed when updating the referred friend.
2694
2699
  * @readonly
2695
2700
  */
2696
2701
  revision?: string | null;
2697
2702
  /**
2698
- * Represents the time this ReferredFriend was created.
2703
+ * Date and time the referred friend was created.
2699
2704
  * @readonly
2700
2705
  */
2701
2706
  createdDate?: Date;
2702
2707
  /**
2703
- * Represents the time this ReferredFriend was last updated.
2708
+ * Date and time the referred friend was last updated.
2704
2709
  * @readonly
2705
2710
  */
2706
2711
  updatedDate?: Date;
@@ -2708,47 +2713,49 @@ interface ReferredFriend$1 {
2708
2713
  declare enum Status$1 {
2709
2714
  /** Unknown status. */
2710
2715
  UNKNOWN = "UNKNOWN",
2711
- /** Initial status, when Referred friend joins site as member. */
2716
+ /** Initial status when the referred friend joins the site as a member. */
2712
2717
  SIGN_UP_COMPLETED = "SIGN_UP_COMPLETED",
2713
- /** After complete some actions (eg. Purchase Order), Action Completed Status is used. */
2718
+ /** Status after the referred friend completes specific actions, such as making a purchase. */
2714
2719
  ACTIONS_COMPLETED = "ACTIONS_COMPLETED"
2715
2720
  }
2716
2721
  interface CreateReferredFriendRequest$1 {
2717
- /** Referral code for referred friend */
2722
+ /** Referral code for the referred friend. */
2718
2723
  referralCode?: string | null;
2719
2724
  }
2720
2725
  interface CreateReferredFriendResponse$1 {
2721
- /** The created ReferredFriend. */
2726
+ /** Created referred friend. */
2722
2727
  referredFriend?: ReferredFriend$1;
2723
2728
  }
2724
2729
  interface GetReferredFriendRequest$1 {
2725
- /** Id of the ReferredFriend to retrieve. */
2730
+ /** ID of the referred friend to retrieve. */
2726
2731
  referredFriendId: string;
2727
2732
  }
2728
2733
  interface GetReferredFriendResponse$1 {
2729
- /** The retrieved ReferredFriend. */
2734
+ /** Retrieved referred friend. */
2730
2735
  referredFriend?: ReferredFriend$1;
2731
2736
  }
2732
2737
  interface GetReferredFriendByContactIdRequest$1 {
2733
- /** Contact id or "me" to get current identity's Contact. */
2738
+ /** Contact ID or "me" to get the current identity's contact. */
2734
2739
  contactId: string;
2735
2740
  }
2736
2741
  interface GetReferredFriendByContactIdResponse$1 {
2737
- /** The retrieved ReferredFriend. */
2742
+ /** Retrieved referred friend. */
2738
2743
  referredFriend?: ReferredFriend$1;
2739
2744
  }
2740
2745
  interface UpdateReferredFriendRequest$1 {
2741
- /** ReferredFriend to be updated, may be partial. */
2746
+ /** Referred friend to be updated. May be partial. */
2742
2747
  referredFriend: ReferredFriend$1;
2743
2748
  }
2744
2749
  interface UpdateReferredFriendResponse$1 {
2745
- /** The updated ReferredFriend. */
2750
+ /** Updated referred friend. */
2746
2751
  referredFriend?: ReferredFriend$1;
2747
2752
  }
2748
2753
  interface DeleteReferredFriendRequest$1 {
2749
- /** Id of the ReferredFriend to delete. */
2750
2754
  referredFriendId: string;
2751
- /** The revision of the ReferredFriend. */
2755
+ /**
2756
+ * Revision number, which increments by 1 each time the referred friend is updated.
2757
+ * To prevent conflicting changes, the current revision must be passed when updating the referred friend.
2758
+ */
2752
2759
  revision?: string;
2753
2760
  }
2754
2761
  interface DeleteReferredFriendResponse$1 {
@@ -2808,9 +2815,9 @@ interface CursorPaging$3 {
2808
2815
  cursor?: string | null;
2809
2816
  }
2810
2817
  interface QueryReferredFriendResponse$1 {
2811
- /** The retrieved ReferredFriends. */
2818
+ /** Retrieved referred friends. */
2812
2819
  referredFriends?: ReferredFriend$1[];
2813
- /** CursorPagingMetadata. */
2820
+ /** Cursor paging metadata. */
2814
2821
  metadata?: CursorPagingMetadata$3;
2815
2822
  }
2816
2823
  interface CursorPagingMetadata$3 {
@@ -2856,34 +2863,35 @@ interface QueryReferredFriendResponseNonNullableFields$1 {
2856
2863
 
2857
2864
  interface ReferredFriend {
2858
2865
  /**
2859
- * ReferredFriend ID.
2866
+ * ID of the referred friend.
2860
2867
  * @readonly
2861
2868
  */
2862
2869
  _id?: string;
2863
2870
  /**
2864
- * ReferredFriend Contact ID.
2871
+ * Contact ID of the referred friend.
2865
2872
  * @readonly
2866
2873
  */
2867
2874
  contactId?: string;
2868
2875
  /**
2869
- * Customer who referred.
2876
+ * ID of the customer who referred this friend.
2870
2877
  * @readonly
2871
2878
  */
2872
2879
  referringCustomerId?: string;
2873
- /** Status of the ReferredFriend. */
2880
+ /** Status of the referred friend. */
2874
2881
  status?: Status;
2875
2882
  /**
2876
- * 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.
2883
+ * Revision number, which increments by 1 each time the referred friend is updated.
2884
+ * To prevent conflicting changes, the current revision must be passed when updating the referred friend.
2877
2885
  * @readonly
2878
2886
  */
2879
2887
  revision?: string | null;
2880
2888
  /**
2881
- * Represents the time this ReferredFriend was created.
2889
+ * Date and time the referred friend was created.
2882
2890
  * @readonly
2883
2891
  */
2884
2892
  _createdDate?: Date;
2885
2893
  /**
2886
- * Represents the time this ReferredFriend was last updated.
2894
+ * Date and time the referred friend was last updated.
2887
2895
  * @readonly
2888
2896
  */
2889
2897
  _updatedDate?: Date;
@@ -2891,47 +2899,49 @@ interface ReferredFriend {
2891
2899
  declare enum Status {
2892
2900
  /** Unknown status. */
2893
2901
  UNKNOWN = "UNKNOWN",
2894
- /** Initial status, when Referred friend joins site as member. */
2902
+ /** Initial status when the referred friend joins the site as a member. */
2895
2903
  SIGN_UP_COMPLETED = "SIGN_UP_COMPLETED",
2896
- /** After complete some actions (eg. Purchase Order), Action Completed Status is used. */
2904
+ /** Status after the referred friend completes specific actions, such as making a purchase. */
2897
2905
  ACTIONS_COMPLETED = "ACTIONS_COMPLETED"
2898
2906
  }
2899
2907
  interface CreateReferredFriendRequest {
2900
- /** Referral code for referred friend */
2908
+ /** Referral code for the referred friend. */
2901
2909
  referralCode?: string | null;
2902
2910
  }
2903
2911
  interface CreateReferredFriendResponse {
2904
- /** The created ReferredFriend. */
2912
+ /** Created referred friend. */
2905
2913
  referredFriend?: ReferredFriend;
2906
2914
  }
2907
2915
  interface GetReferredFriendRequest {
2908
- /** Id of the ReferredFriend to retrieve. */
2916
+ /** ID of the referred friend to retrieve. */
2909
2917
  referredFriendId: string;
2910
2918
  }
2911
2919
  interface GetReferredFriendResponse {
2912
- /** The retrieved ReferredFriend. */
2920
+ /** Retrieved referred friend. */
2913
2921
  referredFriend?: ReferredFriend;
2914
2922
  }
2915
2923
  interface GetReferredFriendByContactIdRequest {
2916
- /** Contact id or "me" to get current identity's Contact. */
2924
+ /** Contact ID or "me" to get the current identity's contact. */
2917
2925
  contactId: string;
2918
2926
  }
2919
2927
  interface GetReferredFriendByContactIdResponse {
2920
- /** The retrieved ReferredFriend. */
2928
+ /** Retrieved referred friend. */
2921
2929
  referredFriend?: ReferredFriend;
2922
2930
  }
2923
2931
  interface UpdateReferredFriendRequest {
2924
- /** ReferredFriend to be updated, may be partial. */
2932
+ /** Referred friend to be updated. May be partial. */
2925
2933
  referredFriend: ReferredFriend;
2926
2934
  }
2927
2935
  interface UpdateReferredFriendResponse {
2928
- /** The updated ReferredFriend. */
2936
+ /** Updated referred friend. */
2929
2937
  referredFriend?: ReferredFriend;
2930
2938
  }
2931
2939
  interface DeleteReferredFriendRequest {
2932
- /** Id of the ReferredFriend to delete. */
2933
2940
  referredFriendId: string;
2934
- /** The revision of the ReferredFriend. */
2941
+ /**
2942
+ * Revision number, which increments by 1 each time the referred friend is updated.
2943
+ * To prevent conflicting changes, the current revision must be passed when updating the referred friend.
2944
+ */
2935
2945
  revision?: string;
2936
2946
  }
2937
2947
  interface DeleteReferredFriendResponse {
@@ -2991,9 +3001,9 @@ interface CursorPaging$2 {
2991
3001
  cursor?: string | null;
2992
3002
  }
2993
3003
  interface QueryReferredFriendResponse {
2994
- /** The retrieved ReferredFriends. */
3004
+ /** Retrieved referred friends. */
2995
3005
  referredFriends?: ReferredFriend[];
2996
- /** CursorPagingMetadata. */
3006
+ /** Cursor paging metadata. */
2997
3007
  metadata?: CursorPagingMetadata$2;
2998
3008
  }
2999
3009
  interface CursorPagingMetadata$2 {