growsurf-ruby 0.8.0 → 1.1.0

data/rbi/growsurf_ruby/models/campaign/participant_retrieve_analytics_params.rbi

@@ -0,0 +1,207 @@
+# typed: strong
+
+module GrowsurfRuby
+  module Models
+    module Campaign
+      class ParticipantRetrieveAnalyticsParams < GrowsurfRuby::Internal::Type::BaseModel
+        extend GrowsurfRuby::Internal::Type::RequestParameters::Converter
+        include GrowsurfRuby::Internal::Type::RequestParameters
+
+        OrHash =
+          T.type_alias do
+            T.any(
+              GrowsurfRuby::Campaign::ParticipantRetrieveAnalyticsParams,
+              GrowsurfRuby::Internal::AnyHash
+            )
+          end
+
+        sig { returns(String) }
+        attr_accessor :id
+
+        sig { returns(String) }
+        attr_accessor :participant_id_or_email
+
+        # Last number of days to retrieve analytics for. Defaults to 365. Maximum 1825.
+        sig { returns(T.nilable(Integer)) }
+        attr_reader :days
+
+        sig { params(days: Integer).void }
+        attr_writer :days
+
+        # End date of the analytics timeframe as a Unix timestamp in milliseconds.
+        # Required if `days` is not set.
+        sig { returns(T.nilable(Integer)) }
+        attr_reader :end_date
+
+        sig { params(end_date: Integer).void }
+        attr_writer :end_date
+
+        # Set to `series` to also return this participant's own activity per period.
+        sig do
+          returns(
+            T.nilable(
+              GrowsurfRuby::Campaign::ParticipantRetrieveAnalyticsParams::Include::OrSymbol
+            )
+          )
+        end
+        attr_reader :include
+
+        sig do
+          params(
+            include:
+              GrowsurfRuby::Campaign::ParticipantRetrieveAnalyticsParams::Include::OrSymbol
+          ).void
+        end
+        attr_writer :include
+
+        # Bucket size for the `series` (only used with `include=series`). Defaults to `day`.
+        sig do
+          returns(
+            T.nilable(
+              GrowsurfRuby::Campaign::ParticipantRetrieveAnalyticsParams::Interval::OrSymbol
+            )
+          )
+        end
+        attr_reader :interval
+
+        sig do
+          params(
+            interval:
+              GrowsurfRuby::Campaign::ParticipantRetrieveAnalyticsParams::Interval::OrSymbol
+          ).void
+        end
+        attr_writer :interval
+
+        # Start date of the analytics timeframe as a Unix timestamp in milliseconds.
+        # Required if `days` is not set.
+        sig { returns(T.nilable(Integer)) }
+        attr_reader :start_date
+
+        sig { params(start_date: Integer).void }
+        attr_writer :start_date
+
+        sig do
+          params(
+            id: String,
+            participant_id_or_email: String,
+            days: Integer,
+            end_date: Integer,
+            include:
+              GrowsurfRuby::Campaign::ParticipantRetrieveAnalyticsParams::Include::OrSymbol,
+            interval:
+              GrowsurfRuby::Campaign::ParticipantRetrieveAnalyticsParams::Interval::OrSymbol,
+            start_date: Integer,
+            request_options: GrowsurfRuby::RequestOptions::OrHash
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          id:,
+          participant_id_or_email:,
+          # Last number of days to retrieve analytics for. Defaults to 365. Maximum 1825.
+          days: nil,
+          # End date of the analytics timeframe as a Unix timestamp in milliseconds.
+          # Required if `days` is not set.
+          end_date: nil,
+          # Set to `series` to also return this participant's own activity per period.
+          include: nil,
+          # Bucket size for the `series` (only used with `include=series`). Defaults to `day`.
+          interval: nil,
+          # Start date of the analytics timeframe as a Unix timestamp in milliseconds.
+          # Required if `days` is not set.
+          start_date: nil,
+          request_options: {}
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              id: String,
+              participant_id_or_email: String,
+              days: Integer,
+              end_date: Integer,
+              include:
+                GrowsurfRuby::Campaign::ParticipantRetrieveAnalyticsParams::Include::OrSymbol,
+              interval:
+                GrowsurfRuby::Campaign::ParticipantRetrieveAnalyticsParams::Interval::OrSymbol,
+              start_date: Integer,
+              request_options: GrowsurfRuby::RequestOptions
+            }
+          )
+        end
+        def to_hash
+        end
+
+        # Set to `series` to also return this participant's own activity per period.
+        module Include
+          extend GrowsurfRuby::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(
+                Symbol,
+                GrowsurfRuby::Campaign::ParticipantRetrieveAnalyticsParams::Include
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          SERIES =
+            T.let(
+              :series,
+              GrowsurfRuby::Campaign::ParticipantRetrieveAnalyticsParams::Include::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                GrowsurfRuby::Campaign::ParticipantRetrieveAnalyticsParams::Include::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+
+        # Bucket size for the `series` (only used with `include=series`). Defaults to `day`.
+        module Interval
+          extend GrowsurfRuby::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(
+                Symbol,
+                GrowsurfRuby::Campaign::ParticipantRetrieveAnalyticsParams::Interval
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          DAY =
+            T.let(
+              :day,
+              GrowsurfRuby::Campaign::ParticipantRetrieveAnalyticsParams::Interval::TaggedSymbol
+            )
+          WEEK =
+            T.let(
+              :week,
+              GrowsurfRuby::Campaign::ParticipantRetrieveAnalyticsParams::Interval::TaggedSymbol
+            )
+          MONTH =
+            T.let(
+              :month,
+              GrowsurfRuby::Campaign::ParticipantRetrieveAnalyticsParams::Interval::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                GrowsurfRuby::Campaign::ParticipantRetrieveAnalyticsParams::Interval::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/growsurf_ruby/models/campaign/participant_update_params.rbi

@@ -46,6 +46,21 @@ module GrowsurfRuby
         sig { params(metadata: T::Hash[Symbol, T.anything]).void }
         attr_writer :metadata
 
+        # Freeform internal notes about the participant (internal only, never exposed to
+        # participants).
+        sig { returns(T.nilable(String)) }
+        attr_reader :notes
+
+        sig { params(notes: String).void }
+        attr_writer :notes
+
+        # The participant's PayPal email address, used for affiliate payouts.
+        sig { returns(T.nilable(String)) }
+        attr_reader :paypal_email
+
+        sig { params(paypal_email: String).void }
+        attr_writer :paypal_email
+
         sig do
           returns(
             T.nilable(
@@ -89,6 +104,8 @@ module GrowsurfRuby
             first_name: String,
             last_name: String,
             metadata: T::Hash[Symbol, T.anything],
+            notes: String,
+            paypal_email: String,
             referral_status:
               GrowsurfRuby::Campaign::ParticipantUpdateParams::ReferralStatus::OrSymbol,
             referred_by: String,
@@ -105,6 +122,11 @@ module GrowsurfRuby
           last_name: nil,
           # Shallow custom metadata object.
           metadata: nil,
+          # Freeform internal notes about the participant (internal only, never exposed to
+          # participants).
+          notes: nil,
+          # The participant's PayPal email address, used for affiliate payouts.
+          paypal_email: nil,
           referral_status: nil,
           referred_by: nil,
           unsubscribed: nil,
@@ -122,6 +144,8 @@ module GrowsurfRuby
               first_name: String,
               last_name: String,
               metadata: T::Hash[Symbol, T.anything],
+              notes: String,
+              paypal_email: String,
               referral_status:
                 GrowsurfRuby::Campaign::ParticipantUpdateParams::ReferralStatus::OrSymbol,
               referred_by: String,

data/rbi/growsurf_ruby/models/campaign/reward.rbi

@@ -41,6 +41,9 @@ module GrowsurfRuby
         sig { returns(T.nilable(Integer)) }
         attr_accessor :conversions_required
 
+        # Legacy static coupon code shown to the referrer in the reward-won email and
+        # webhook. Display text only; superseded by a connected billing integration's
+        # issued coupon when one exists.
         sig { returns(T.nilable(String)) }
         attr_accessor :coupon_code
 
@@ -63,18 +66,30 @@ module GrowsurfRuby
         end
         attr_accessor :limit_duration
 
+        # Text shown before a participant's referral count in milestone-progress copy.
+        # Applies to `MILESTONE` rewards.
         sig { returns(T.nilable(String)) }
         attr_accessor :next_milestone_prefix
 
+        # Text shown after a participant's referral count in milestone-progress copy.
+        # Applies to `MILESTONE` rewards.
         sig { returns(T.nilable(String)) }
         attr_accessor :next_milestone_suffix
 
+        # The number of winners (`LEADERBOARD` rewards only). With `limitDuration`
+        # `PER_MONTH` this many win each month, otherwise this many win in total.
         sig { returns(T.nilable(Integer)) }
         attr_accessor :number_of_winners
 
         sig { returns(T.nilable(Integer)) }
         attr_accessor :order
 
+        # Legacy static coupon code shown to the referred friend (double-sided rewards)
+        # in the reward-won email and webhook. Display text only; superseded by a
+        # connected billing integration's issued coupon when one exists.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :referral_coupon_code
+
         sig { returns(T.nilable(String)) }
         attr_accessor :referral_description
 
@@ -84,6 +99,28 @@ module GrowsurfRuby
         sig { params(referred_reward_upfront: T::Boolean).void }
         attr_writer :referred_reward_upfront
 
+        # Tax valuation for the referred friend's side of a double-sided reward.
+        sig { returns(T.nilable(GrowsurfRuby::RewardTaxValuation)) }
+        attr_reader :referred_value
+
+        sig do
+          params(
+            referred_value: T.nilable(GrowsurfRuby::RewardTaxValuation::OrHash)
+          ).void
+        end
+        attr_writer :referred_value
+
+        # Tax valuation for the reward (the referrer's side of a double-sided reward).
+        sig { returns(T.nilable(GrowsurfRuby::RewardTaxValuation)) }
+        attr_reader :value
+
+        sig do
+          params(
+            value: T.nilable(GrowsurfRuby::RewardTaxValuation::OrHash)
+          ).void
+        end
+        attr_writer :value
+
         sig do
           params(
             id: String,
@@ -105,8 +142,11 @@ module GrowsurfRuby
             next_milestone_suffix: T.nilable(String),
             number_of_winners: T.nilable(Integer),
             order: T.nilable(Integer),
+            referral_coupon_code: T.nilable(String),
             referral_description: T.nilable(String),
-            referred_reward_upfront: T::Boolean
+            referred_reward_upfront: T::Boolean,
+            referred_value: T.nilable(GrowsurfRuby::RewardTaxValuation::OrHash),
+            value: T.nilable(GrowsurfRuby::RewardTaxValuation::OrHash)
           ).returns(T.attached_class)
         end
         def self.new(
@@ -117,18 +157,35 @@ module GrowsurfRuby
           type:,
           commission_structure: nil,
           conversions_required: nil,
+          # Legacy static coupon code shown to the referrer in the reward-won email and
+          # webhook. Display text only; superseded by a connected billing integration's
+          # issued coupon when one exists.
           coupon_code: nil,
           description: nil,
           image_url: nil,
           # `-1` represents an unlimited reward in REST responses.
           limit: nil,
           limit_duration: nil,
+          # Text shown before a participant's referral count in milestone-progress copy.
+          # Applies to `MILESTONE` rewards.
           next_milestone_prefix: nil,
+          # Text shown after a participant's referral count in milestone-progress copy.
+          # Applies to `MILESTONE` rewards.
           next_milestone_suffix: nil,
+          # The number of winners (`LEADERBOARD` rewards only). With `limitDuration`
+          # `PER_MONTH` this many win each month, otherwise this many win in total.
           number_of_winners: nil,
           order: nil,
+          # Legacy static coupon code shown to the referred friend (double-sided rewards)
+          # in the reward-won email and webhook. Display text only; superseded by a
+          # connected billing integration's issued coupon when one exists.
+          referral_coupon_code: nil,
           referral_description: nil,
-          referred_reward_upfront: nil
+          referred_reward_upfront: nil,
+          # Tax valuation for the referred friend's side of a double-sided reward.
+          referred_value: nil,
+          # Tax valuation for the reward (the referrer's side of a double-sided reward).
+          value: nil
         )
         end
 
@@ -154,8 +211,11 @@ module GrowsurfRuby
               next_milestone_suffix: T.nilable(String),
               number_of_winners: T.nilable(Integer),
               order: T.nilable(Integer),
+              referral_coupon_code: T.nilable(String),
               referral_description: T.nilable(String),
-              referred_reward_upfront: T::Boolean
+              referred_reward_upfront: T::Boolean,
+              referred_value: T.nilable(GrowsurfRuby::RewardTaxValuation),
+              value: T.nilable(GrowsurfRuby::RewardTaxValuation)
             }
           )
         end

data/rbi/growsurf_ruby/models/campaign/reward_create_params.rbi

@@ -38,6 +38,9 @@ module GrowsurfRuby
         sig { params(conversions_required: Integer).void }
         attr_writer :conversions_required
 
+        # Legacy static coupon code shown to the referrer in the reward-won email and
+        # webhook. Display text only; superseded by a connected billing integration's
+        # issued coupon when one exists.
         sig { returns(T.nilable(String)) }
         attr_reader :coupon_code
 
@@ -56,18 +59,16 @@ module GrowsurfRuby
         sig { params(image_url: String).void }
         attr_writer :image_url
 
-        sig { returns(T.nilable(T::Boolean)) }
-        attr_reader :is_active
-
-        sig { params(is_active: T::Boolean).void }
-        attr_writer :is_active
-
+        # Whether the reward can be earned an unlimited number of times. Defaults to
+        # `true`, except `MILESTONE` rewards, which can only be earned once.
         sig { returns(T.nilable(T::Boolean)) }
         attr_reader :is_unlimited
 
         sig { params(is_unlimited: T::Boolean).void }
         attr_writer :is_unlimited
 
+        # Whether the reward is enabled. When `false` the reward is disabled: hidden from
+        # participants and no longer awarded, including those who already earned it.
         sig { returns(T.nilable(T::Boolean)) }
         attr_reader :is_visible
 
@@ -104,18 +105,25 @@ module GrowsurfRuby
         sig { params(metadata: T::Hash[Symbol, T.anything]).void }
         attr_writer :metadata
 
+        # Text shown before a participant's referral count in milestone-progress copy.
+        # Applies to `MILESTONE` rewards.
         sig { returns(T.nilable(String)) }
         attr_reader :next_milestone_prefix
 
         sig { params(next_milestone_prefix: String).void }
         attr_writer :next_milestone_prefix
 
+        # Text shown after a participant's referral count in milestone-progress copy.
+        # Applies to `MILESTONE` rewards.
         sig { returns(T.nilable(String)) }
         attr_reader :next_milestone_suffix
 
         sig { params(next_milestone_suffix: String).void }
         attr_writer :next_milestone_suffix
 
+        # The number of winners (`LEADERBOARD` rewards only). With `limitDuration`
+        # `PER_MONTH` this many win each month, otherwise this many win in total;
+        # omitting it defaults to `3`.
         sig { returns(T.nilable(Integer)) }
         attr_reader :number_of_winners
 
@@ -128,6 +136,9 @@ module GrowsurfRuby
         sig { params(order: Integer).void }
         attr_writer :order
 
+        # Legacy static coupon code shown to the referred friend (double-sided rewards)
+        # in the reward-won email and webhook. Display text only; superseded by a
+        # connected billing integration's issued coupon when one exists.
         sig { returns(T.nilable(String)) }
         attr_reader :referral_coupon_code
 
@@ -146,12 +157,30 @@ module GrowsurfRuby
         sig { params(referred_reward_upfront: T::Boolean).void }
         attr_writer :referred_reward_upfront
 
+        # Tax valuation for the referred friend's side of a double-sided reward.
+        # Defaults to not tax-reportable (a purchase rebate).
+        sig { returns(T.nilable(GrowsurfRuby::RewardTaxValuation)) }
+        attr_reader :referred_value
+
+        sig do
+          params(referred_value: GrowsurfRuby::RewardTaxValuation::OrHash).void
+        end
+        attr_writer :referred_value
+
         sig { returns(T.nilable(String)) }
         attr_reader :title
 
         sig { params(title: String).void }
         attr_writer :title
 
+        # Tax valuation for the reward (the referrer's side of a double-sided reward).
+        # Used by tax documentation / 1099 reporting.
+        sig { returns(T.nilable(GrowsurfRuby::RewardTaxValuation)) }
+        attr_reader :value
+
+        sig { params(value: GrowsurfRuby::RewardTaxValuation::OrHash).void }
+        attr_writer :value
+
         sig do
           params(
             type:
@@ -161,7 +190,6 @@ module GrowsurfRuby
             coupon_code: String,
             description: String,
             image_url: String,
-            is_active: T::Boolean,
             is_unlimited: T::Boolean,
             is_visible: T::Boolean,
             limit: Integer,
@@ -175,7 +203,9 @@ module GrowsurfRuby
             referral_coupon_code: String,
             referral_description: String,
             referred_reward_upfront: T::Boolean,
+            referred_value: GrowsurfRuby::RewardTaxValuation::OrHash,
             title: String,
+            value: GrowsurfRuby::RewardTaxValuation::OrHash,
             request_options: GrowsurfRuby::RequestOptions::OrHash
           ).returns(T.attached_class)
         end
@@ -183,24 +213,46 @@ module GrowsurfRuby
           type:,
           commission_structure: nil,
           conversions_required: nil,
+          # Legacy static coupon code shown to the referrer in the reward-won email and
+          # webhook. Display text only; superseded by a connected billing integration's
+          # issued coupon when one exists.
           coupon_code: nil,
           description: nil,
           image_url: nil,
-          is_active: nil,
+          # Whether the reward can be earned an unlimited number of times. Defaults to
+          # `true`, except `MILESTONE` rewards, which can only be earned once.
           is_unlimited: nil,
+          # Whether the reward is enabled. When `false` the reward is disabled: hidden from
+          # participants and no longer awarded, including those who already earned it.
           is_visible: nil,
           limit: nil,
           limit_duration: nil,
           # Custom key/value metadata (single-level; values are stored as strings).
           metadata: nil,
+          # Text shown before a participant's referral count in milestone-progress copy.
+          # Applies to `MILESTONE` rewards.
           next_milestone_prefix: nil,
+          # Text shown after a participant's referral count in milestone-progress copy.
+          # Applies to `MILESTONE` rewards.
           next_milestone_suffix: nil,
+          # The number of winners (`LEADERBOARD` rewards only). With `limitDuration`
+          # `PER_MONTH` this many win each month, otherwise this many win in total;
+          # omitting it defaults to `3`.
           number_of_winners: nil,
           order: nil,
+          # Legacy static coupon code shown to the referred friend (double-sided rewards)
+          # in the reward-won email and webhook. Display text only; superseded by a
+          # connected billing integration's issued coupon when one exists.
           referral_coupon_code: nil,
           referral_description: nil,
           referred_reward_upfront: nil,
+          # Tax valuation for the referred friend's side of a double-sided reward.
+          # Defaults to not tax-reportable (a purchase rebate).
+          referred_value: nil,
           title: nil,
+          # Tax valuation for the reward (the referrer's side of a double-sided reward).
+          # Used by tax documentation / 1099 reporting.
+          value: nil,
           request_options: {}
         )
         end
@@ -215,7 +267,6 @@ module GrowsurfRuby
               coupon_code: String,
               description: String,
               image_url: String,
-              is_active: T::Boolean,
               is_unlimited: T::Boolean,
               is_visible: T::Boolean,
               limit: Integer,
@@ -229,7 +280,9 @@ module GrowsurfRuby
               referral_coupon_code: String,
               referral_description: String,
               referred_reward_upfront: T::Boolean,
+              referred_value: GrowsurfRuby::RewardTaxValuation::OrHash,
               title: String,
+              value: GrowsurfRuby::RewardTaxValuation::OrHash,
               request_options: GrowsurfRuby::RequestOptions
             }
           )

data/rbi/growsurf_ruby/models/campaign/reward_delete_params.rbi

@@ -19,23 +19,23 @@ module GrowsurfRuby
         attr_accessor :id
 
         sig { returns(String) }
-        attr_accessor :reward_id
+        attr_accessor :campaign_reward_id
 
         sig do
           params(
             id: String,
-            reward_id: String,
+            campaign_reward_id: String,
             request_options: GrowsurfRuby::RequestOptions::OrHash
           ).returns(T.attached_class)
         end
-        def self.new(id:, reward_id:, request_options: {})
+        def self.new(id:, campaign_reward_id:, request_options: {})
         end
 
         sig do
           override.returns(
             {
               id: String,
-              reward_id: String,
+              campaign_reward_id: String,
               request_options: GrowsurfRuby::RequestOptions
             }
           )