growsurf-ruby 1.3.0 → 1.5.0

data/lib/growsurf_ruby/resources/campaign.rb

@@ -18,6 +18,10 @@ module GrowsurfRuby
       # @return [GrowsurfRuby::Resources::Campaign::Rewards]
       attr_reader :rewards
 
+      # Program Resource management and secure FILE upload operations.
+      # @return [GrowsurfRuby::Resources::Campaign::ProgramResources]
+      attr_reader :resources
+
       # Program Editor "Design" tab configuration operations.
       # @return [GrowsurfRuby::Resources::Campaign::Design]
       attr_reader :design
@@ -34,6 +38,10 @@ module GrowsurfRuby
       # @return [GrowsurfRuby::Resources::Campaign::Installation]
       attr_reader :installation
 
+      # Integration status operations.
+      # @return [GrowsurfRuby::Resources::Campaign::Integrations]
+      attr_reader :integrations
+
       # Program webhook configuration operations.
       # @return [GrowsurfRuby::Resources::Campaign::Webhooks]
       attr_reader :webhooks
@@ -79,7 +87,7 @@ module GrowsurfRuby
       # Creates a new program, plus any optional campaign rewards. The new program is
       # created in `DRAFT` status and owned by the API key's bound team.
       #
-      # @overload create(type:, company_logo_image_url: nil, company_name: nil, currency_iso: nil, name: nil, rewards: nil, request_options: {})
+      # @overload create(type:, company_logo_image_url: nil, company_name: nil, currency_iso: nil, goal: nil, name: nil, rewards: nil, request_options: {})
       #
       # @param type [Symbol, GrowsurfRuby::Models::CampaignCreateParams::Type] The program type. Immutable after creation.
       #
@@ -89,6 +97,8 @@ module GrowsurfRuby
       #
       # @param currency_iso [String] ISO 4217 currency code. Defaults to USD. Chosen when the program is created and immutable afterward — it cannot be changed on update.
       #
+      # @param goal [Symbol, GrowsurfRuby::Models::CampaignCreateParams::Goal] What the program is for, which seeds share settings that suit that audience. Programs selling to businesses start with the LinkedIn share button visible; consumer, financial, education, insurance, newsletter, and waitlist programs start with it hidden. Set only when the program is created.
+      #
       # @param name [String] The program name. Defaults to a generated friendly label plus the creation date.
       #
       # @param rewards [Array<GrowsurfRuby::Models::Campaign::RewardCreateParams>] Optional inline rewards to create with the program.
@@ -531,13 +541,11 @@ module GrowsurfRuby
       #
       # Retrieves analytics for a program. Pass `interval` to also get a time-series
       # (`series`) alongside the totals, and `include` to add previous-period totals,
-      # status breakdowns, derived rates, or email performance. Add `email` to `include`
-      # for `sent` (accepted for delivery), `delivered`, `opened`, `clicked`, `bounced`,
-      # and `spamComplaints` metrics plus per-email-type breakdowns. Email rates are
-      # ratios from `0` to `1`, and `isPartial` identifies windows that begin before
-      # complete coverage.
+      # status breakdowns, derived rates, email performance, or participant engagement.
+      # Add `engagement` for covered activity totals, comparisons, series, and breakdowns.
+      # Unknown coverage returns explicit unavailable states rather than zeroes.
       #
-      # @overload retrieve_analytics(id, days: nil, end_date: nil, include: nil, interval: nil, start_date: nil, request_options: {})
+      # @overload retrieve_analytics(id, days: nil, end_date: nil, include: nil, interval: nil, platform: nil, start_date: nil, timezone: nil, request_options: {})
       #
       # @param id [String] GrowSurf program ID.
       #
@@ -549,8 +557,12 @@ module GrowsurfRuby
       #
       # @param interval [Symbol, GrowsurfRuby::Models::CampaignRetrieveAnalyticsParams::Interval] When set to `day`, `week`, or `month`, the response also includes a `series` array
       #
+      # @param platform [Symbol, GrowsurfRuby::Models::CampaignRetrieveAnalyticsParams::Platform] Limits engagement events to one client platform.
+      #
       # @param start_date [Integer] Start date of the analytics timeframe as a Unix timestamp in milliseconds. Requi
       #
+      # @param timezone [String] IANA timezone used for engagement interval boundaries and distinct-day calculations.
+      #
       # @param request_options [GrowsurfRuby::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [GrowsurfRuby::Models::CampaignRetrieveAnalyticsResponse]
@@ -568,6 +580,38 @@ module GrowsurfRuby
         )
       end
 
+      # Retrieves activation cohorts for a program. Each cohort follows eligible
+      # participants through portal views, sharing, referral visits, leads, and credited
+      # referrals. Coverage states distinguish unknown values from zeroes.
+      #
+      # @overload retrieve_activation_analytics(id, cohort_from: nil, cohort_to: nil, cohort_interval: nil, observation_window_days: nil, timezone: nil, request_options: {})
+      #
+      # @param id [String] GrowSurf program ID.
+      # @param cohort_from [Integer] Inclusive cohort enrollment start, as a Unix timestamp in milliseconds.
+      # @param cohort_to [Integer] Exclusive cohort enrollment end, as a Unix timestamp in milliseconds.
+      # @param cohort_interval [Symbol, GrowsurfRuby::Models::CampaignRetrieveActivationAnalyticsParams::CohortInterval] Cohort bucket size. Defaults to `day`.
+      # @param observation_window_days [Integer] Days after enrollment allowed for each participant to reach a stage. Use `7` or `30`.
+      # @param timezone [String] IANA timezone used for cohort bounds. Defaults to `UTC`.
+      # @param request_options [GrowsurfRuby::RequestOptions, Hash{Symbol=>Object}, nil]
+      # @return [GrowsurfRuby::Models::CampaignActivationAnalyticsResponse]
+      # @see GrowsurfRuby::Models::CampaignRetrieveActivationAnalyticsParams
+      def retrieve_activation_analytics(id, params = {})
+        parsed, options = GrowsurfRuby::CampaignRetrieveActivationAnalyticsParams.dump_request(params)
+        query = GrowsurfRuby::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: ["campaign/%1$s/analytics/activation", id],
+          query: query.transform_keys(
+            cohort_from: "cohortFrom",
+            cohort_to: "cohortTo",
+            cohort_interval: "cohortInterval",
+            observation_window_days: "observationWindowDays"
+          ),
+          model: GrowsurfRuby::Models::CampaignActivationAnalyticsResponse,
+          options: options
+        )
+      end
+
       # Some parameter documentations has been truncated, see
       # {GrowsurfRuby::Models::CampaignReviewAffiliateApplicationParams} for more
       # details.
@@ -653,10 +697,12 @@ module GrowsurfRuby
         @reward = GrowsurfRuby::Resources::Campaign::Reward.new(client: client)
         @commission = GrowsurfRuby::Resources::Campaign::Commission.new(client: client)
         @rewards = GrowsurfRuby::Resources::Campaign::Rewards.new(client: client)
+        @resources = GrowsurfRuby::Resources::Campaign::ProgramResources.new(client: client)
         @design = GrowsurfRuby::Resources::Campaign::Design.new(client: client)
         @emails = GrowsurfRuby::Resources::Campaign::Emails.new(client: client)
         @options = GrowsurfRuby::Resources::Campaign::Options.new(client: client)
         @installation = GrowsurfRuby::Resources::Campaign::Installation.new(client: client)
+        @integrations = GrowsurfRuby::Resources::Campaign::Integrations.new(client: client)
         @webhooks = GrowsurfRuby::Resources::Campaign::Webhooks.new(client: client)
       end
     end

data/lib/growsurf_ruby/resources/team.rb

@@ -87,11 +87,13 @@ module GrowsurfRuby
         )
       end
 
-      # Resends the email-verification message to the bound team's owner. The response
-      # never reveals the owner's email address. A `200` with `status: SENT` is returned
-      # only when an email was actually dispatched. Returns `400` if the email is
-      # already verified, and `429` if a verification email was sent too recently — wait
-      # a moment, then retry.
+      # Resends the email-verification message to the owner of the account the API key
+      # belongs to. This is the recovery path for a `403` with error code
+      # `EMAIL_NOT_VERIFIED_ERROR`, so it stays callable with any GrowSurf API key while the
+      # rest of the API is locked. The response never reveals the owner's email address. A
+      # `200` with `status: SENT` is returned only when an email was actually dispatched.
+      # Returns `400` if the email is already verified, and `429` if a verification email was
+      # sent too recently — wait a moment, then retry.
       #
       # @overload resend_owner_verification_email(request_options: {})
       #

data/lib/growsurf_ruby/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module GrowsurfRuby
-  VERSION = "1.3.0"
+  VERSION = "1.5.0"
 end

data/lib/growsurf_ruby.rb

@@ -52,6 +52,10 @@ require_relative "growsurf_ruby/errors"
 require_relative "growsurf_ruby/internal/transport/base_client"
 require_relative "growsurf_ruby/internal/transport/pooled_net_requester"
 require_relative "growsurf_ruby/client"
+require_relative "growsurf_ruby/models/analytics_availability"
+require_relative "growsurf_ruby/models/analytics_unavailable_reason"
+require_relative "growsurf_ruby/models/campaign_activation_analytics_response"
+require_relative "growsurf_ruby/models/campaign_engagement_analytics"
 require_relative "growsurf_ruby/models/campaign/create"
 require_relative "growsurf_ruby/models/campaign/participant"
 require_relative "growsurf_ruby/models/campaign/campaign_reward_list_response"
@@ -63,6 +67,7 @@ require_relative "growsurf_ruby/models/campaign/delete_reward_response"
 require_relative "growsurf_ruby/models/campaign/fraud_risk_level"
 require_relative "growsurf_ruby/models/campaign/participant_activity_logs_response"
 require_relative "growsurf_ruby/models/campaign/participant_add_params"
+require_relative "growsurf_ruby/models/campaign/participant_activation_analytics"
 require_relative "growsurf_ruby/models/email_analytics"
 require_relative "growsurf_ruby/models/campaign/participant_analytics_response"
 require_relative "growsurf_ruby/models/campaign/participant_bulk_delete_params"
@@ -95,6 +100,15 @@ require_relative "growsurf_ruby/models/campaign/participant_send_invites_respons
 require_relative "growsurf_ruby/models/campaign/participant_trigger_referral_params"
 require_relative "growsurf_ruby/models/campaign/participant_trigger_referral_response"
 require_relative "growsurf_ruby/models/campaign/participant_update_params"
+require_relative "growsurf_ruby/models/campaign/program_resource"
+require_relative "growsurf_ruby/models/campaign/program_resource_upload_result"
+require_relative "growsurf_ruby/models/campaign/program_resource_create_params"
+require_relative "growsurf_ruby/models/campaign/program_resource_delete_params"
+require_relative "growsurf_ruby/models/campaign/program_resource_list_response"
+require_relative "growsurf_ruby/models/campaign/program_resource_update_params"
+require_relative "growsurf_ruby/models/campaign/program_resource_upload_ticket"
+require_relative "growsurf_ruby/models/campaign/program_resource_upload_ticket_params"
+require_relative "growsurf_ruby/models/campaign/delete_program_resource_response"
 require_relative "growsurf_ruby/models/campaign/referral_source"
 require_relative "growsurf_ruby/models/campaign/referral_status"
 require_relative "growsurf_ruby/models/campaign/reward"
@@ -106,6 +120,8 @@ require_relative "growsurf_ruby/models/campaign/reward_delete_response"
 require_relative "growsurf_ruby/models/campaign/reward_fulfill_params"
 require_relative "growsurf_ruby/models/campaign/reward_fulfill_response"
 require_relative "growsurf_ruby/models/campaign/reward_update_params"
+require_relative "growsurf_ruby/models/campaign/integration"
+require_relative "growsurf_ruby/models/campaign/integration_list_response"
 require_relative "growsurf_ruby/models/campaign/webhook"
 require_relative "growsurf_ruby/models/campaign/webhook_create_params"
 require_relative "growsurf_ruby/models/campaign/webhook_delete_params"
@@ -141,6 +157,7 @@ require_relative "growsurf_ruby/models/campaign_list_referrals_params"
 require_relative "growsurf_ruby/models/campaign_list_response"
 require_relative "growsurf_ruby/models/campaign_resend_affiliate_invite_params"
 require_relative "growsurf_ruby/models/campaign_retrieve_affiliate_application_params"
+require_relative "growsurf_ruby/models/campaign_retrieve_activation_analytics_params"
 require_relative "growsurf_ruby/models/campaign_retrieve_analytics_params"
 require_relative "growsurf_ruby/models/campaign_retrieve_analytics_response"
 require_relative "growsurf_ruby/models/campaign_retrieve_params"
@@ -165,4 +182,6 @@ require_relative "growsurf_ruby/resources/campaign/options"
 require_relative "growsurf_ruby/resources/campaign/participant"
 require_relative "growsurf_ruby/resources/campaign/reward"
 require_relative "growsurf_ruby/resources/campaign/rewards"
+require_relative "growsurf_ruby/resources/campaign/program_resources"
+require_relative "growsurf_ruby/resources/campaign/integrations"
 require_relative "growsurf_ruby/resources/campaign/webhooks"

data/rbi/growsurf_ruby/internal/type/base_model.rbi

@@ -264,6 +264,16 @@ module GrowsurfRuby
         def deep_to_h
         end
 
+        sig { returns(T::Hash[String, String]) }
+        attr_reader :response_headers
+
+        # @api private
+        sig do
+          params(headers: T::Hash[String, String]).returns(T.self_type)
+        end
+        def attach_response_headers(headers)
+        end
+
         sig do
           params(keys: T.nilable(T::Array[Symbol])).returns(
             GrowsurfRuby::Internal::AnyHash

data/rbi/growsurf_ruby/internal/type/base_page.rbi

@@ -25,6 +25,9 @@ module GrowsurfRuby
         def to_enum
         end
 
+        sig { returns(T::Hash[String, String]) }
+        attr_reader :response_headers
+
         # @api private
         sig do
           params(

data/rbi/growsurf_ruby/models/analytics_availability.rbi

@@ -0,0 +1,19 @@
+# typed: strong
+
+module GrowsurfRuby
+  module Models
+    module AnalyticsAvailability
+      extend GrowsurfRuby::Internal::Type::Enum
+
+      OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+      AVAILABLE = T.let(:AVAILABLE, Symbol)
+      PARTIAL = T.let(:PARTIAL, Symbol)
+      UNAVAILABLE = T.let(:UNAVAILABLE, Symbol)
+
+      sig { override.returns(T::Array[Symbol]) }
+      def self.values
+      end
+    end
+  end
+end

data/rbi/growsurf_ruby/models/analytics_unavailable_reason.rbi

@@ -0,0 +1,23 @@
+# typed: strong
+
+module GrowsurfRuby
+  module Models
+    module AnalyticsUnavailableReason
+      extend GrowsurfRuby::Internal::Type::Enum
+
+      OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+      COVERAGE_UNAVAILABLE = T.let(:COVERAGE_UNAVAILABLE, Symbol)
+      PRE_COVERAGE = T.let(:PRE_COVERAGE, Symbol)
+      PARTIAL_COVERAGE = T.let(:PARTIAL_COVERAGE, Symbol)
+      INSUFFICIENT_COVERAGE = T.let(:INSUFFICIENT_COVERAGE, Symbol)
+      EMPTY_DENOMINATOR = T.let(:EMPTY_DENOMINATOR, Symbol)
+      QUERY_LIMIT_EXCEEDED = T.let(:QUERY_LIMIT_EXCEEDED, Symbol)
+      PARTICIPANT_NOT_ELIGIBLE = T.let(:PARTICIPANT_NOT_ELIGIBLE, Symbol)
+
+      sig { override.returns(T::Array[Symbol]) }
+      def self.values
+      end
+    end
+  end
+end

data/rbi/growsurf_ruby/models/campaign/delete_program_resource_response.rbi

@@ -0,0 +1,33 @@
+# typed: strong
+
+module GrowsurfRuby
+  module Models
+    module Campaign
+      class DeleteProgramResourceResponse < GrowsurfRuby::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              DeleteProgramResourceResponse,
+              GrowsurfRuby::Internal::AnyHash
+            )
+          end
+
+        sig { returns(String) }
+        attr_accessor :id
+
+        sig { returns(T::Boolean) }
+        attr_accessor :success
+
+        sig do
+          params(id: String, success: T::Boolean).returns(T.attached_class)
+        end
+        def self.new(id:, success:)
+        end
+
+        sig { override.returns({ id: String, success: T::Boolean }) }
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/growsurf_ruby/models/campaign/integration.rbi

@@ -0,0 +1,93 @@
+# typed: strong
+
+module GrowsurfRuby
+  module Models
+    module Campaign
+      class Integration < GrowsurfRuby::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              GrowsurfRuby::Models::Campaign::Integration,
+              GrowsurfRuby::Internal::AnyHash
+            )
+          end
+
+        # Stable integration key, the same value the GrowSurf dashboard uses for this
+        # integration.
+        sig { returns(String) }
+        attr_accessor :id
+
+        # Whether GrowSurf switched the integration off after repeated delivery failures.
+        # Its credentials are still stored, but it delivers nothing until it is
+        # reconnected in the GrowSurf dashboard.
+        sig { returns(T::Boolean) }
+        attr_accessor :auto_disabled
+
+        # Dashboard link that opens this integration's connect panel in the GrowSurf Program
+        # Editor. Give it to the person running the program: connecting an account is a step
+        # they complete in the dashboard, and the API cannot do it for them.
+        sig { returns(String) }
+        attr_accessor :connect_url
+
+        # Whether the program has stored credentials for this integration.
+        sig { returns(T::Boolean) }
+        attr_accessor :connected
+
+        # Whether the integration is switched on and currently working.
+        sig { returns(T::Boolean) }
+        attr_accessor :enabled
+
+        # Display name, matching what the GrowSurf dashboard calls this integration.
+        sig { returns(String) }
+        attr_accessor :name
+
+        # One integration a program can connect, with its current state.
+        sig do
+          params(
+            id: String,
+            auto_disabled: T::Boolean,
+            connect_url: String,
+            connected: T::Boolean,
+            enabled: T::Boolean,
+            name: String
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Stable integration key, the same value the GrowSurf dashboard uses for this
+          # integration.
+          id:,
+          # Whether GrowSurf switched the integration off after repeated delivery failures.
+          # Its credentials are still stored, but it delivers nothing until it is
+          # reconnected in the GrowSurf dashboard.
+          auto_disabled:,
+          # Dashboard link that opens this integration's connect panel in the GrowSurf Program
+          # Editor. Give it to the person running the program: connecting an account is a step
+          # they complete in the dashboard, and the API cannot do it for them.
+          connect_url:,
+          # Whether the program has stored credentials for this integration.
+          connected:,
+          # Whether the integration is switched on and currently working.
+          enabled:,
+          # Display name, matching what the GrowSurf dashboard calls this integration.
+          name:
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              id: String,
+              auto_disabled: T::Boolean,
+              connect_url: String,
+              connected: T::Boolean,
+              enabled: T::Boolean,
+              name: String
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/growsurf_ruby/models/campaign/integration_list_response.rbi

@@ -0,0 +1,46 @@
+# typed: strong
+
+module GrowsurfRuby
+  module Models
+    module Campaign
+      class IntegrationListResponse < GrowsurfRuby::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              GrowsurfRuby::Models::Campaign::IntegrationListResponse,
+              GrowsurfRuby::Internal::AnyHash
+            )
+          end
+
+        # Every integration this program can connect, in the order the GrowSurf dashboard
+        # lists them.
+        sig { returns(T::Array[GrowsurfRuby::Models::Campaign::Integration]) }
+        attr_accessor :integrations
+
+        sig do
+          params(
+            integrations:
+              T::Array[GrowsurfRuby::Models::Campaign::Integration::OrHash]
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Every integration this program can connect, in the order the GrowSurf dashboard
+          # lists them.
+          integrations:
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              integrations:
+                T::Array[GrowsurfRuby::Models::Campaign::Integration]
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/growsurf_ruby/models/campaign/participant_activation_analytics.rbi

@@ -0,0 +1,133 @@
+# typed: strong
+
+module GrowsurfRuby
+  module Models
+    module Campaign
+      class ParticipantActivationAnalytics < GrowsurfRuby::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              GrowsurfRuby::Models::Campaign::ParticipantActivationAnalytics,
+              GrowsurfRuby::Internal::AnyHash
+            )
+          end
+
+        sig { returns(T.nilable(Integer)) }
+        attr_accessor :coverage_start_at, :enrolled_as_advocate_at
+
+        sig { returns(Integer) }
+        attr_accessor :metric_contract_version
+
+        sig { returns(ProgramType::OrSymbol) }
+        attr_accessor :program_type
+
+        sig { returns(GrowsurfRuby::Models::AnalyticsAvailability::OrSymbol) }
+        attr_accessor :state
+
+        sig do
+          returns(
+            T.nilable(
+              GrowsurfRuby::Models::AnalyticsUnavailableReason::OrSymbol
+            )
+          )
+        end
+        attr_accessor :reason
+
+        sig { returns(Cohort) }
+        attr_accessor :cohort
+
+        sig { returns(Milestones) }
+        attr_accessor :milestones
+
+        sig { params(kwargs: T.untyped).returns(T.attached_class) }
+        def self.new(**kwargs)
+        end
+
+        module ProgramType
+          extend GrowsurfRuby::Internal::Type::Enum
+
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+          REFERRAL = T.let(:REFERRAL, Symbol)
+          AFFILIATE = T.let(:AFFILIATE, Symbol)
+          sig { override.returns(T::Array[Symbol]) }
+          def self.values
+          end
+        end
+
+        module AnchorField
+          extend GrowsurfRuby::Internal::Type::Enum
+
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+          ENROLLED_AS_ADVOCATE_AT = T.let(:enrolledAsAdvocateAt, Symbol)
+          APPROVED_AS_AFFILIATE_AT = T.let(:approvedAsAffiliateAt, Symbol)
+          sig { override.returns(T::Array[Symbol]) }
+          def self.values
+          end
+        end
+
+        module ShareChannel
+          extend GrowsurfRuby::Internal::Type::Enum
+
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+          EMAIL = T.let(:email, Symbol)
+          FACEBOOK = T.let(:facebook, Symbol)
+          TWITTER = T.let(:twitter, Symbol)
+          LINKEDIN = T.let(:linkedin, Symbol)
+          PINTEREST = T.let(:pinterest, Symbol)
+          THREADS = T.let(:threads, Symbol)
+          BLUESKY = T.let(:bluesky, Symbol)
+          SMS = T.let(:sms, Symbol)
+          MESSENGER = T.let(:messenger, Symbol)
+          WHATSAPP = T.let(:whatsapp, Symbol)
+          WECHAT = T.let(:wechat, Symbol)
+          TELEGRAM = T.let(:telegram, Symbol)
+          REDDIT = T.let(:reddit, Symbol)
+          TUMBLR = T.let(:tumblr, Symbol)
+          QRCODE = T.let(:qrcode, Symbol)
+          COPY_REF_LINK = T.let(:copyRefLink, Symbol)
+          IOS_NATIVE_SHARE = T.let(:iosNativeShare, Symbol)
+          ANDROID_NATIVE_SHARE = T.let(:androidNativeShare, Symbol)
+          sig { override.returns(T::Array[Symbol]) }
+          def self.values
+          end
+        end
+
+        class Cohort < GrowsurfRuby::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias { T.any(Cohort, GrowsurfRuby::Internal::AnyHash) }
+          sig { returns(AnchorField::OrSymbol) }
+          attr_accessor :anchor_field
+
+          sig { returns(T.nilable(Integer)) }
+          attr_accessor :anchor_at
+
+          sig { params(kwargs: T.untyped).returns(T.attached_class) }
+          def self.new(**kwargs)
+          end
+        end
+
+        class Milestones < GrowsurfRuby::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias { T.any(Milestones, GrowsurfRuby::Internal::AnyHash) }
+          sig { returns(T.nilable(Integer)) }
+          attr_accessor :first_portal_viewed_at,
+                        :first_referral_link_copied_at,
+                        :first_share_at,
+                        :first_unique_click_at,
+                        :first_lead_at,
+                        :first_referral_at,
+                        :first_reward_at,
+                        :first_commission_at,
+                        :payout_setup_completed_at
+
+          sig { returns(T.nilable(ShareChannel::OrSymbol)) }
+          attr_accessor :first_share_channel
+
+          sig { params(kwargs: T.untyped).returns(T.attached_class) }
+          def self.new(**kwargs)
+          end
+        end
+      end
+    end
+  end
+end