@wix/referral 1.0.13 → 1.0.14

package/type-bundles/meta.bundle.d.ts

@@ -952,106 +952,109 @@ declare namespace meta$4 {
 }
 
 interface ReferralEvent$1 extends ReferralEventEventTypeOneOf$1 {
-    /** ReferredFriendSignupEvent is an event that is triggered when a referred friend signs up. */
+    /** Event triggered when a referred friend signs up. */
     referredFriendSignupEvent?: ReferredFriendSignupEvent$1;
-    /** SuccessfulReferralEvent is an event that is triggered when a referral is successful. */
+    /** Event triggered when a referral is successful. For example, customer places and pays for an order. */
     successfulReferralEvent?: V1SuccessfulReferralEvent$1;
-    /** ActionEvent is an event that is triggered when an action is performed. */
+    /** Event triggered when an action is performed. For example, placing an order. */
     actionEvent?: V1ActionEvent$1;
-    /** RewardEvent is an event that is triggered when a reward is given. */
+    /** Event triggered when a reward is given. */
     rewardEvent?: RewardEvent$1;
     /**
-     * ReferralEvent ID.
+     * Referral event ID.
      * @readonly
      */
     id?: string | null;
-    /** 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. */
+    /**
+     * Revision number, which increments by 1 each time the referral event is updated.
+     * To prevent conflicting changes, the current revision must be passed when updating the referral event.
+     */
     revision?: string | null;
     /**
-     * Represents the time this ReferralEvent was created.
+     * Date and time the referral event was created.
      * @readonly
      */
     createdDate?: Date;
     /**
-     * Represents the time this ReferralEvent was last updated.
+     * Date and time the referral event was last updated.
      * @readonly
      */
     updatedDate?: Date;
 }
 /** @oneof */
 interface ReferralEventEventTypeOneOf$1 {
-    /** ReferredFriendSignupEvent is an event that is triggered when a referred friend signs up. */
+    /** Event triggered when a referred friend signs up. */
     referredFriendSignupEvent?: ReferredFriendSignupEvent$1;
-    /** SuccessfulReferralEvent is an event that is triggered when a referral is successful. */
+    /** Event triggered when a referral is successful. For example, customer places and pays for an order. */
     successfulReferralEvent?: V1SuccessfulReferralEvent$1;
-    /** ActionEvent is an event that is triggered when an action is performed. */
+    /** Event triggered when an action is performed. For example, placing an order. */
     actionEvent?: V1ActionEvent$1;
-    /** RewardEvent is an event that is triggered when a reward is given. */
+    /** Event triggered when a reward is given. */
     rewardEvent?: RewardEvent$1;
 }
 interface ReferredFriendSignupEvent$1 {
-    /** The referred friend ID. */
+    /** ID of the referred friend */
     referredFriendId?: string;
 }
 interface V1SuccessfulReferralEvent$1 {
-    /** The referred friend ID. */
+    /** ID of the referred friend */
     referredFriendId?: string;
-    /** The referring customer ID. */
+    /** ID of the referring customer */
     referringCustomerId?: string;
 }
 interface V1ActionEvent$1 {
-    /** The referred friend ID. */
+    /** ID of the referred friend */
     referredFriendId?: string;
-    /** The referring customer ID. */
+    /** ID of the referring customer */
     referringCustomerId?: string;
-    /** The trigger of the action. */
+    /** Trigger for the action */
     trigger?: V1Trigger$1;
-    /** Amount. */
+    /** Amount associated with the action. */
     amount?: string | null;
-    /** Currency. */
+    /** Currency of the amount. */
     currency?: string | null;
-    /** Order ID. */
+    /** ID of the associated order. */
     orderId?: string | null;
 }
 interface V1Trigger$1 {
-    /** The app id of the app that triggered the event. */
+    /** ID of the app that triggered the event */
     appId?: string;
-    /** The activity type that triggered the event. */
+    /** Type of activity that triggered the event */
     activityType?: string;
 }
 interface RewardEvent$1 extends RewardEventReceiverOneOf$1 {
     /**
-     * The referring customer ID.
+     * ID of the rewarded referring customer.
      * @readonly
      */
     rewardedReferringCustomerId?: string;
     /**
-     * The referred friend ID.
+     * ID of the rewarded referred friend.
      * @readonly
      */
     rewardedReferredFriendId?: string;
-    /** The referral reward ID. */
+    /** ID of the referral reward. */
     referralRewardId?: string;
-    /** The reward type. */
+    /** Type of reward. */
     rewardType?: Reward$1;
 }
 /** @oneof */
 interface RewardEventReceiverOneOf$1 {
     /**
-     * The referring customer ID.
+     * ID of the rewarded referring customer.
      * @readonly
      */
     rewardedReferringCustomerId?: string;
     /**
-     * The referred friend ID.
+     * ID of the rewarded referred friend.
      * @readonly
      */
     rewardedReferredFriendId?: string;
 }
 declare enum Reward$1 {
-    /** Unknown reward type. */
+    /** Unknown reward. This field is not used. */
     UNKNOWN = "UNKNOWN",
-    /** Reward is a coupon. */
+    /** Reward is a coupon */
     COUPON = "COUPON",
     /** Reward is loyalty points. */
     LOYALTY_POINTS = "LOYALTY_POINTS",
@@ -1059,15 +1062,15 @@ declare enum Reward$1 {
     NOTHING = "NOTHING"
 }
 interface GetReferralEventRequest$1 {
-    /** Id of the ReferralEvent to retrieve */
+    /** ID of the referral event to retrieve. */
     referralEventId: string;
 }
 interface GetReferralEventResponse$1 {
-    /** The retrieved ReferralEvent */
+    /** Retrieved referral event. */
     referralEvent?: ReferralEvent$1;
 }
 interface QueryReferralEventRequest$1 {
-    /** Query to filter ReferralEvents. */
+    /** Query to filter referral events */
     query: CursorQuery$7;
 }
 interface CursorQuery$7 extends CursorQueryPagingMethodOneOf$7 {
@@ -1121,9 +1124,9 @@ interface CursorPaging$7 {
     cursor?: string | null;
 }
 interface QueryReferralEventResponse$1 {
-    /** List of ReferralEvents that match the query. */
+    /** List of referral events. */
     referralEvents?: ReferralEvent$1[];
-    /** Paging metadata. */
+    /** Metadata for the paginated results. */
     metadata?: CursorPagingMetadata$7;
 }
 interface CursorPagingMetadata$7 {
@@ -1148,72 +1151,71 @@ interface Cursors$7 {
 interface GetReferralStatisticsRequest$1 {
 }
 interface GetReferralStatisticsResponse$1 {
-    /** Total sign ups completed by referred friends */
+    /** Total number of sign-ups completed by referred friends. */
     totalSignUpsCompleted?: number;
-    /** Total actions completed by referred friends */
+    /** Total number of actions completed by referred friends. */
     totalActionsCompleted?: number;
-    /** Total amount of purchases made by referred friends */
+    /** Total amount of purchases made by referred friends. */
     totalAmountGenerated?: string;
 }
 interface QueryReferringCustomerTotalsRequest$1 {
-    /** Query to filter ReferringCustomerTotals. */
+    /** Query to filter referring customer totals. */
     query?: CursorQuery$7;
-    /** List of contact ids to filter ReferringCustomerTotals. */
+    /** List of contact IDs to filter referring customer totals. */
     contactIds?: string[];
 }
 interface QueryReferringCustomerTotalsResponse$1 {
-    /** List of ReferringCustomerTotals that match the query. */
     referringCustomerTotals?: ReferringCustomerTotal$1[];
-    /** Paging metadata. */
+    /** Paging metadata */
     metadata?: CursorPagingMetadata$7;
 }
 interface ReferringCustomerTotal$1 {
     /**
-     * Referring customer id.
+     * ID of the referring customer.
      * @readonly
      */
     referringCustomerId?: string;
     /**
-     * Contact id.
+     * Contact ID.
      * @readonly
      */
     contactId?: string;
     /**
-     * Last successful referral date.
+     * Date and time of the last successful referral.
      * @readonly
      */
     lastSuccessfulReferral?: Date;
     /**
-     * Total successful referrals made by this customer.
+     * Total number of successful referrals made by this customer.
      * @readonly
      */
     totalSuccessfulReferrals?: number;
     /**
-     * Total amount generated by friends referred by this customer.
+     * Total amount of revenue generated by friends referred by this customer.
      * @readonly
      */
     totalAmountGenerated?: string;
     /**
-     * Last friend action date.
+     * Date and time of the last friend action.
      * @readonly
      */
     lastFriendAction?: Date;
     /**
-     * Total friends that have actions done.
+     * Number of friends who have completed actions.
      * @readonly
      */
     totalFriendsWithActions?: number;
 }
 interface QueryReferredFriendActionsRequest$1 {
-    /** Query to filter ReferredFriendActions. */
+    /** Query to filter referred friend actions. */
     query?: CursorQuery$7;
-    /** List of contact ids to filter ReferredFriendActions. */
+    /** List of contact IDs to filter referred friend actions. */
     contactIds?: string[];
 }
 interface QueryReferredFriendActionsResponse$1 {
-    /** List of ReferredFriendActions that match the query. */
+    /** List of referred friend actions matching the query. */
     referredFriendActions?: ReferredFriendAction$1[];
-    /** Paging metadata. */
+    /** Paging metadata */
     metadata?: CursorPagingMetadata$7;
 }
 interface ReferredFriendAction$1 extends ReferredFriendActionRewardTypeOptionsOneOf$1 {
@@ -1222,28 +1224,28 @@ interface ReferredFriendAction$1 extends ReferredFriendActionRewardTypeOptionsOn
     /** Loyalty points reward type options. */
     loyaltyPoints?: LoyaltyPoints$1;
     /**
-     * Referred friend id.
+     * Referred friend ID.
      * @readonly
      */
     referredFriendId?: string;
     /**
-     * Contact id.
+     * Contact ID.
      * @readonly
      */
     contactId?: string;
     /**
-     * First action trigger.
+     * Trigger for the first action.
      * @readonly
      */
     trigger?: V1Trigger$1;
     /**
-     * First action date.
+     * Date and time of the first action.
      * @readonly
      */
     actionDate?: Date;
-    /** Issued reward type. */
+    /** Type of issued reward. */
     rewardType?: Reward$1;
-    /** Total number of actions. */
+    /** Number of actions completed. */
     totalActions?: number;
     /**
      * Total amount spent by this referred friend.
@@ -1251,7 +1253,7 @@ interface ReferredFriendAction$1 extends ReferredFriendActionRewardTypeOptionsOn
      */
     totalAmountSpent?: string;
     /**
-     * friend signup date.
+     * Date and time of friend signup.
      * @readonly
      */
     signupDate?: Date;
@@ -1492,106 +1494,109 @@ interface QueryReferredFriendActionsResponseNonNullableFields$1 {
 }
 
 interface ReferralEvent extends ReferralEventEventTypeOneOf {
-    /** ReferredFriendSignupEvent is an event that is triggered when a referred friend signs up. */
+    /** Event triggered when a referred friend signs up. */
     referredFriendSignupEvent?: ReferredFriendSignupEvent;
-    /** SuccessfulReferralEvent is an event that is triggered when a referral is successful. */
+    /** Event triggered when a referral is successful. For example, customer places and pays for an order. */
     successfulReferralEvent?: V1SuccessfulReferralEvent;
-    /** ActionEvent is an event that is triggered when an action is performed. */
+    /** Event triggered when an action is performed. For example, placing an order. */
     actionEvent?: V1ActionEvent;
-    /** RewardEvent is an event that is triggered when a reward is given. */
+    /** Event triggered when a reward is given. */
     rewardEvent?: RewardEvent;
     /**
-     * ReferralEvent ID.
+     * Referral event ID.
      * @readonly
      */
     _id?: string | null;
-    /** 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. */
+    /**
+     * Revision number, which increments by 1 each time the referral event is updated.
+     * To prevent conflicting changes, the current revision must be passed when updating the referral event.
+     */
     revision?: string | null;
     /**
-     * Represents the time this ReferralEvent was created.
+     * Date and time the referral event was created.
      * @readonly
      */
     _createdDate?: Date;
     /**
-     * Represents the time this ReferralEvent was last updated.
+     * Date and time the referral event was last updated.
      * @readonly
      */
     _updatedDate?: Date;
 }
 /** @oneof */
 interface ReferralEventEventTypeOneOf {
-    /** ReferredFriendSignupEvent is an event that is triggered when a referred friend signs up. */
+    /** Event triggered when a referred friend signs up. */
     referredFriendSignupEvent?: ReferredFriendSignupEvent;
-    /** SuccessfulReferralEvent is an event that is triggered when a referral is successful. */
+    /** Event triggered when a referral is successful. For example, customer places and pays for an order. */
     successfulReferralEvent?: V1SuccessfulReferralEvent;
-    /** ActionEvent is an event that is triggered when an action is performed. */
+    /** Event triggered when an action is performed. For example, placing an order. */
     actionEvent?: V1ActionEvent;
-    /** RewardEvent is an event that is triggered when a reward is given. */
+    /** Event triggered when a reward is given. */
     rewardEvent?: RewardEvent;
 }
 interface ReferredFriendSignupEvent {
-    /** The referred friend ID. */
+    /** ID of the referred friend */
     referredFriendId?: string;
 }
 interface V1SuccessfulReferralEvent {
-    /** The referred friend ID. */
+    /** ID of the referred friend */
     referredFriendId?: string;
-    /** The referring customer ID. */
+    /** ID of the referring customer */
     referringCustomerId?: string;
 }
 interface V1ActionEvent {
-    /** The referred friend ID. */
+    /** ID of the referred friend */
     referredFriendId?: string;
-    /** The referring customer ID. */
+    /** ID of the referring customer */
     referringCustomerId?: string;
-    /** The trigger of the action. */
+    /** Trigger for the action */
     trigger?: V1Trigger;
-    /** Amount. */
+    /** Amount associated with the action. */
     amount?: string | null;
-    /** Currency. */
+    /** Currency of the amount. */
     currency?: string | null;
-    /** Order ID. */
+    /** ID of the associated order. */
     orderId?: string | null;
 }
 interface V1Trigger {
-    /** The app id of the app that triggered the event. */
+    /** ID of the app that triggered the event */
     appId?: string;
-    /** The activity type that triggered the event. */
+    /** Type of activity that triggered the event */
     activityType?: string;
 }
 interface RewardEvent extends RewardEventReceiverOneOf {
     /**
-     * The referring customer ID.
+     * ID of the rewarded referring customer.
      * @readonly
      */
     rewardedReferringCustomerId?: string;
     /**
-     * The referred friend ID.
+     * ID of the rewarded referred friend.
      * @readonly
      */
     rewardedReferredFriendId?: string;
-    /** The referral reward ID. */
+    /** ID of the referral reward. */
     referralRewardId?: string;
-    /** The reward type. */
+    /** Type of reward. */
     rewardType?: Reward;
 }
 /** @oneof */
 interface RewardEventReceiverOneOf {
     /**
-     * The referring customer ID.
+     * ID of the rewarded referring customer.
      * @readonly
      */
     rewardedReferringCustomerId?: string;
     /**
-     * The referred friend ID.
+     * ID of the rewarded referred friend.
      * @readonly
      */
     rewardedReferredFriendId?: string;
 }
 declare enum Reward {
-    /** Unknown reward type. */
+    /** Unknown reward. This field is not used. */
     UNKNOWN = "UNKNOWN",
-    /** Reward is a coupon. */
+    /** Reward is a coupon */
     COUPON = "COUPON",
     /** Reward is loyalty points. */
     LOYALTY_POINTS = "LOYALTY_POINTS",
@@ -1599,15 +1604,15 @@ declare enum Reward {
     NOTHING = "NOTHING"
 }
 interface GetReferralEventRequest {
-    /** Id of the ReferralEvent to retrieve */
+    /** ID of the referral event to retrieve. */
     referralEventId: string;
 }
 interface GetReferralEventResponse {
-    /** The retrieved ReferralEvent */
+    /** Retrieved referral event. */
     referralEvent?: ReferralEvent;
 }
 interface QueryReferralEventRequest {
-    /** Query to filter ReferralEvents. */
+    /** Query to filter referral events */
     query: CursorQuery$6;
 }
 interface CursorQuery$6 extends CursorQueryPagingMethodOneOf$6 {
@@ -1661,9 +1666,9 @@ interface CursorPaging$6 {
     cursor?: string | null;
 }
 interface QueryReferralEventResponse {
-    /** List of ReferralEvents that match the query. */
+    /** List of referral events. */
     referralEvents?: ReferralEvent[];
-    /** Paging metadata. */
+    /** Metadata for the paginated results. */
     metadata?: CursorPagingMetadata$6;
 }
 interface CursorPagingMetadata$6 {
@@ -1688,72 +1693,71 @@ interface Cursors$6 {
 interface GetReferralStatisticsRequest {
 }
 interface GetReferralStatisticsResponse {
-    /** Total sign ups completed by referred friends */
+    /** Total number of sign-ups completed by referred friends. */
     totalSignUpsCompleted?: number;
-    /** Total actions completed by referred friends */
+    /** Total number of actions completed by referred friends. */
     totalActionsCompleted?: number;
-    /** Total amount of purchases made by referred friends */
+    /** Total amount of purchases made by referred friends. */
     totalAmountGenerated?: string;
 }
 interface QueryReferringCustomerTotalsRequest {
-    /** Query to filter ReferringCustomerTotals. */
+    /** Query to filter referring customer totals. */
     query?: CursorQuery$6;
-    /** List of contact ids to filter ReferringCustomerTotals. */
+    /** List of contact IDs to filter referring customer totals. */
     contactIds?: string[];
 }
 interface QueryReferringCustomerTotalsResponse {
-    /** List of ReferringCustomerTotals that match the query. */
     referringCustomerTotals?: ReferringCustomerTotal[];
-    /** Paging metadata. */
+    /** Paging metadata */
     metadata?: CursorPagingMetadata$6;
 }
 interface ReferringCustomerTotal {
     /**
-     * Referring customer id.
+     * ID of the referring customer.
      * @readonly
      */
     referringCustomerId?: string;
     /**
-     * Contact id.
+     * Contact ID.
      * @readonly
      */
     contactId?: string;
     /**
-     * Last successful referral date.
+     * Date and time of the last successful referral.
      * @readonly
      */
     lastSuccessfulReferral?: Date;
     /**
-     * Total successful referrals made by this customer.
+     * Total number of successful referrals made by this customer.
      * @readonly
      */
     totalSuccessfulReferrals?: number;
     /**
-     * Total amount generated by friends referred by this customer.
+     * Total amount of revenue generated by friends referred by this customer.
      * @readonly
      */
     totalAmountGenerated?: string;
     /**
-     * Last friend action date.
+     * Date and time of the last friend action.
      * @readonly
      */
     lastFriendAction?: Date;
     /**
-     * Total friends that have actions done.
+     * Number of friends who have completed actions.
      * @readonly
      */
     totalFriendsWithActions?: number;
 }
 interface QueryReferredFriendActionsRequest {
-    /** Query to filter ReferredFriendActions. */
+    /** Query to filter referred friend actions. */
     query?: CursorQuery$6;
-    /** List of contact ids to filter ReferredFriendActions. */
+    /** List of contact IDs to filter referred friend actions. */
     contactIds?: string[];
 }
 interface QueryReferredFriendActionsResponse {
-    /** List of ReferredFriendActions that match the query. */
+    /** List of referred friend actions matching the query. */
     referredFriendActions?: ReferredFriendAction[];
-    /** Paging metadata. */
+    /** Paging metadata */
     metadata?: CursorPagingMetadata$6;
 }
 interface ReferredFriendAction extends ReferredFriendActionRewardTypeOptionsOneOf {
@@ -1762,28 +1766,28 @@ interface ReferredFriendAction extends ReferredFriendActionRewardTypeOptionsOneO
     /** Loyalty points reward type options. */
     loyaltyPoints?: LoyaltyPoints;
     /**
-     * Referred friend id.
+     * Referred friend ID.
      * @readonly
      */
     referredFriendId?: string;
     /**
-     * Contact id.
+     * Contact ID.
      * @readonly
      */
     contactId?: string;
     /**
-     * First action trigger.
+     * Trigger for the first action.
      * @readonly
      */
     trigger?: V1Trigger;
     /**
-     * First action date.
+     * Date and time of the first action.
      * @readonly
      */
     actionDate?: Date;
-    /** Issued reward type. */
+    /** Type of issued reward. */
     rewardType?: Reward;
-    /** Total number of actions. */
+    /** Number of actions completed. */
     totalActions?: number;
     /**
      * Total amount spent by this referred friend.
@@ -1791,7 +1795,7 @@ interface ReferredFriendAction extends ReferredFriendActionRewardTypeOptionsOneO
      */
     totalAmountSpent?: string;
     /**
-     * friend signup date.
+     * Date and time of friend signup.
      * @readonly
      */
     signupDate?: Date;