growsurf-ruby 1.4.0 → 1.5.0

data/lib/growsurf_ruby/resources/campaign/participant.rb

@@ -8,7 +8,7 @@ module GrowsurfRuby
         #
         # @overload retrieve(participant_id_or_email, id:, request_options: {})
         #
-        # @param participant_id_or_email [String] GrowSurf participant ID or URL-encoded participant email address.
+        # @param participant_id_or_email [String] GrowSurf participant ID or unencoded participant email address (the SDK encodes it automatically).
         #
         # @param id [String] GrowSurf program ID.
         #
@@ -39,7 +39,7 @@ module GrowsurfRuby
         #
         # @overload update(participant_id_or_email, id:, affiliate_status: nil, email: nil, first_name: nil, last_name: nil, metadata: nil, notes: nil, referral_status: nil, referred_by: nil, unsubscribed: nil, vanity_keys: nil, request_options: {})
         #
-        # @param participant_id_or_email [String] Path param: GrowSurf participant ID or URL-encoded participant email address.
+        # @param participant_id_or_email [String] Path param: GrowSurf participant ID or unencoded participant email address (the SDK encodes it automatically).
         #
         # @param id [String] Path param: GrowSurf program ID.
         #
@@ -87,7 +87,7 @@ module GrowsurfRuby
         #
         # @overload delete(participant_id_or_email, id:, request_options: {})
         #
-        # @param participant_id_or_email [String] GrowSurf participant ID or URL-encoded participant email address.
+        # @param participant_id_or_email [String] GrowSurf participant ID or unencoded participant email address (the SDK encodes it automatically).
         #
         # @param id [String] GrowSurf program ID.
         #
@@ -200,7 +200,7 @@ module GrowsurfRuby
         #
         # @overload list_commissions(participant_id_or_email, id:, limit: nil, next_id: nil, status: nil, request_options: {})
         #
-        # @param participant_id_or_email [String] Path param: GrowSurf participant ID or URL-encoded participant email address.
+        # @param participant_id_or_email [String] Path param: GrowSurf participant ID or unencoded participant email address (the SDK encodes it automatically).
         #
         # @param id [String] Path param: GrowSurf program ID.
         #
@@ -236,7 +236,7 @@ module GrowsurfRuby
         #
         # @overload list_payouts(participant_id_or_email, id:, limit: nil, next_id: nil, status: nil, request_options: {})
         #
-        # @param participant_id_or_email [String] Path param: GrowSurf participant ID or URL-encoded participant email address.
+        # @param participant_id_or_email [String] Path param: GrowSurf participant ID or unencoded participant email address (the SDK encodes it automatically).
         #
         # @param id [String] Path param: GrowSurf program ID.
         #
@@ -271,7 +271,7 @@ module GrowsurfRuby
         #
         # @overload list_referrals(participant_id_or_email, id:, desc: nil, email: nil, first_name: nil, last_name: nil, limit: nil, next_id: nil, offset: nil, referral_status: nil, sort_by: nil, request_options: {})
         #
-        # @param participant_id_or_email [String] Path param: GrowSurf participant ID or URL-encoded participant email address.
+        # @param participant_id_or_email [String] Path param: GrowSurf participant ID or unencoded participant email address (the SDK encodes it automatically).
         #
         # @param id [String] Path param: GrowSurf program ID.
         #
@@ -324,7 +324,7 @@ module GrowsurfRuby
         #
         # @overload list_rewards(participant_id_or_email, id:, limit: nil, next_id: nil, request_options: {})
         #
-        # @param participant_id_or_email [String] Path param: GrowSurf participant ID or URL-encoded participant email address.
+        # @param participant_id_or_email [String] Path param: GrowSurf participant ID or unencoded participant email address (the SDK encodes it automatically).
         #
         # @param id [String] Path param: GrowSurf program ID.
         #
@@ -360,9 +360,9 @@ module GrowsurfRuby
         # de-duplicated — without one, a resent sale would create a second commission.
         # Reuse the same identifier(s) when refunding.
         #
-        # @overload record_transaction(participant_id_or_email, id:, currency:, gross_amount:, amount_cash_net: nil, amount_paid: nil, charge_id: nil, customer_id: nil, description: nil, external_id: nil, invoice_id: nil, invoice_subtotal_excluding_tax: nil, invoice_total: nil, invoice_total_excluding_tax: nil, net_amount: nil, order_id: nil, paid_at: nil, payment_id: nil, payment_intent_id: nil, subscription_id: nil, tax_amount: nil, total_tax_amount: nil, total_tax_amounts: nil, total_taxes: nil, transaction_id: nil, request_options: {})
+        # @overload record_transaction(participant_id_or_email, id:, currency:, gross_amount:, amount_cash_net: nil, amount_paid: nil, charge_id: nil, customer_id: nil, description: nil, external_id: nil, invoice_id: nil, invoice_subtotal_excluding_tax: nil, invoice_total: nil, invoice_total_excluding_tax: nil, net_amount: nil, order_id: nil, paid_at: nil, payment_id: nil, payment_intent_id: nil, subscription_id: nil, tax_amount: nil, total_tax_amount: nil, total_tax_amounts: nil, total_taxes: nil, transaction_id: nil, payment_provider: nil, test_mode: nil, request_options: {})
         #
-        # @param participant_id_or_email [String] Path param: GrowSurf participant ID or URL-encoded participant email address.
+        # @param participant_id_or_email [String] Path param: GrowSurf participant ID or unencoded participant email address (the SDK encodes it automatically).
         #
         # @param id [String] Path param: GrowSurf program ID.
         #
@@ -437,11 +437,12 @@ module GrowsurfRuby
         # and reverses or adjusts the referrer's commission. The inverse of Record
         # Affiliate Transaction. Identify the original transaction with the same
         # identifier(s) you sent when recording it. Commissions already paid out to the
-        # affiliate are not clawed back; the amendment is recorded for tax reporting only.
+        # affiliate are not clawed back. The amendment still updates the sale revenue used
+        # in program reporting; full refunds and chargebacks also update tax reporting.
         #
-        # @overload refund_transaction(participant_id_or_email, id:, amendment_type: nil, amount: nil, amount_refunded: nil, charge_id: nil, currency: nil, description: nil, external_id: nil, invoice_id: nil, order_id: nil, payment_id: nil, payment_intent_id: nil, refund_amount: nil, refund_id: nil, refund_status: nil, transaction_id: nil, request_options: {})
+        # @overload refund_transaction(participant_id_or_email, id:, amendment_type: nil, amount: nil, amount_refunded: nil, charge_id: nil, currency: nil, description: nil, external_id: nil, invoice_id: nil, order_id: nil, payment_id: nil, payment_intent_id: nil, refund_amount: nil, refund_id: nil, refund_status: nil, transaction_id: nil, payment_provider: nil, test_mode: nil, request_options: {})
         #
-        # @param participant_id_or_email [String] Path param: GrowSurf participant ID or URL-encoded participant email address.
+        # @param participant_id_or_email [String] Path param: GrowSurf participant ID or unencoded participant email address (the SDK encodes it automatically).
         #
         # @param id [String] Path param: GrowSurf program ID.
         #
@@ -501,7 +502,7 @@ module GrowsurfRuby
         #
         # @overload send_invites(participant_id_or_email, id:, email_addresses:, message_text:, subject_text:, request_options: {})
         #
-        # @param participant_id_or_email [String] Path param: GrowSurf participant ID or URL-encoded participant email address.
+        # @param participant_id_or_email [String] Path param: GrowSurf participant ID or unencoded participant email address (the SDK encodes it automatically).
         #
         # @param id [String] Path param: GrowSurf program ID.
         #
@@ -543,7 +544,7 @@ module GrowsurfRuby
         #
         # @overload trigger_referral(participant_id_or_email, id:, delay_in_days: nil, request_options: {})
         #
-        # @param participant_id_or_email [String] Path param: GrowSurf participant ID or URL-encoded participant email address.
+        # @param participant_id_or_email [String] Path param: GrowSurf participant ID or unencoded participant email address (the SDK encodes it automatically).
         #
         # @param id [String] Path param: GrowSurf program ID.
         #
@@ -577,7 +578,7 @@ module GrowsurfRuby
         #
         # @overload cancel_delayed_referral(participant_id_or_email, id:, request_options: {})
         #
-        # @param participant_id_or_email [String] GrowSurf participant ID or URL-encoded participant email address.
+        # @param participant_id_or_email [String] GrowSurf participant ID or unencoded participant email address (the SDK encodes it automatically).
         #
         # @param id [String] GrowSurf program ID.
         #
@@ -611,7 +612,7 @@ module GrowsurfRuby
         #
         # @overload email(participant_id_or_email, id:, body: nil, email_type: nil, preheader: nil, subject: nil, request_options: {})
         #
-        # @param participant_id_or_email [String] Path param: GrowSurf participant ID or URL-encoded participant email address.
+        # @param participant_id_or_email [String] Path param: GrowSurf participant ID or unencoded participant email address (the SDK encodes it automatically).
         #
         # @param id [String] Path param: GrowSurf program ID.
         #
@@ -648,7 +649,7 @@ module GrowsurfRuby
         #
         # @overload list_activity_logs(participant_id_or_email, id:, limit: nil, offset: nil, request_options: {})
         #
-        # @param participant_id_or_email [String] Path param: GrowSurf participant ID or URL-encoded participant email address.
+        # @param participant_id_or_email [String] Path param: GrowSurf participant ID or unencoded participant email address (the SDK encodes it automatically).
         #
         # @param id [String] Path param: GrowSurf program ID.
         #
@@ -686,14 +687,14 @@ module GrowsurfRuby
         # commission, and payout metrics for affiliate programs). Pass `include=email`
         # for `sent` (accepted for delivery), `delivered`, `opened`, `clicked`,
         # `bounced`, and `spamComplaints` metrics attributed to this participant,
-        # including invitations they sent. Use `include=email,series` to include the
-        # same counts in each UTC series bucket. `days`, `startDate`, and `endDate`
-        # filter only the optional `series` and `email` data. They do not filter the
-        # top-level `analytics`, `ranks`, or `shareCount` values.
+        # including invitations they sent. Add `activation` for the cohort anchor and
+        # covered first milestones. Use `include=activation,series` to add covered portal
+        # views and share actions to each series bucket. Unknown history stays `null` with
+        # an explicit coverage state.
         #
         # @overload retrieve_analytics(participant_id_or_email, id:, days: nil, end_date: nil, include: nil, interval: nil, start_date: nil, request_options: {})
         #
-        # @param participant_id_or_email [String] GrowSurf participant ID or URL-encoded participant email address.
+        # @param participant_id_or_email [String] GrowSurf participant ID or unencoded participant email address (the SDK encodes it automatically).
         #
         # @param id [String] GrowSurf program ID.
         #
@@ -737,7 +738,7 @@ module GrowsurfRuby
         #
         # @overload get_payout_destination(participant_id_or_email, id:, request_options: {})
         #
-        # @param participant_id_or_email [String] Path param: GrowSurf participant ID or URL-encoded participant email address.
+        # @param participant_id_or_email [String] Path param: GrowSurf participant ID or unencoded participant email address (the SDK encodes it automatically).
         #
         # @param id [String] Path param: GrowSurf program ID.
         #
@@ -767,7 +768,7 @@ module GrowsurfRuby
         #
         # @overload request_payout_destination_confirmation(participant_id_or_email, id:, provider:, request_options: {})
         #
-        # @param participant_id_or_email [String] Path param: GrowSurf participant ID or URL-encoded participant email address.
+        # @param participant_id_or_email [String] Path param: GrowSurf participant ID or unencoded participant email address (the SDK encodes it automatically).
         #
         # @param id [String] Path param: GrowSurf program ID.
         #

data/lib/growsurf_ruby/resources/campaign/program_resources.rb

@@ -0,0 +1,112 @@
+# frozen_string_literal: true
+
+module GrowsurfRuby
+  module Resources
+    class Campaign
+      # Program Resource management and secure FILE upload operations.
+      class ProgramResources
+        def list(id, params = {})
+          @client.request(
+            method: :get,
+            path: ["campaign/%1$s/resources", id],
+            model: GrowsurfRuby::Campaign::ProgramResourceListResponse,
+            options: params[:request_options]
+          )
+        end
+
+        def create(id, params)
+          parsed, options = GrowsurfRuby::Campaign::ProgramResourceCreateParams.dump_request(params)
+          validate_write!(parsed, creating: true)
+          @client.request(
+            method: :post,
+            path: ["campaign/%1$s/resources", id],
+            body: parsed,
+            model: GrowsurfRuby::Campaign::ProgramResource,
+            options: options
+          )
+        end
+
+        def update(resource_id, params)
+          parsed, options = GrowsurfRuby::Campaign::ProgramResourceUpdateParams.dump_request(params)
+          id = parsed.delete(:id) { raise ArgumentError.new("missing required path argument id") }
+          validate_write!(parsed, creating: false)
+          @client.request(
+            method: :patch,
+            path: ["campaign/%1$s/resources/%2$s", id, resource_id],
+            body: parsed,
+            model: GrowsurfRuby::Campaign::ProgramResource,
+            options: options
+          )
+        end
+
+        def delete(resource_id, params)
+          parsed, options = GrowsurfRuby::Campaign::ProgramResourceDeleteParams.dump_request(params)
+          id = parsed.delete(:id) { raise ArgumentError.new("missing required path argument id") }
+          @client.request(
+            method: :delete,
+            path: ["campaign/%1$s/resources/%2$s", id, resource_id],
+            model: GrowsurfRuby::Campaign::DeleteProgramResourceResponse,
+            options: options
+          )
+        end
+
+        def create_upload_ticket(id, params)
+          parsed, options = GrowsurfRuby::Campaign::ProgramResourceUploadTicketParams.dump_request(params)
+          file_name = parsed[:fileName]
+          unless file_name.is_a?(String) && file_name.length.between?(1, 120)
+            raise ArgumentError.new("Program Resource file_name must contain 1 through 120 characters")
+          end
+          @client.request(
+            method: :post,
+            path: ["campaign/%1$s/resource-upload-tickets", id],
+            body: parsed,
+            model: GrowsurfRuby::Campaign::ProgramResourceUploadTicket,
+            options: options
+          )
+        end
+
+        # @api private
+        def initialize(client:)
+          @client = client
+        end
+
+        private
+
+        # Rejects Resource field combinations excluded by the public REST contract.
+        def validate_write!(params, creating:)
+          if !creating && params.empty?
+            raise ArgumentError.new("Program Resource update requires at least one field")
+          end
+
+          position = params[:position]
+          if params.key?(:position) && (!position.is_a?(Integer) || !position.between?(0, 99))
+            raise ArgumentError.new("Program Resource position must be an integer from 0 through 99")
+          end
+
+          has_upload_ticket = params.key?(:uploadTicket)
+          has_upload_result = params.key?(:uploadResult)
+          if has_upload_ticket != has_upload_result
+            raise ArgumentError.new("upload_ticket and upload_result must be supplied together")
+          end
+
+          supplied_types = []
+          supplied_types << :LINK if params.key?(:url)
+          supplied_types << :TEXT if params.key?(:text)
+          supplied_types << :FILE if has_upload_ticket
+          raise ArgumentError.new("send content fields for only one Program Resource type") if supplied_types.length > 1
+
+          type = params[:type]
+          if supplied_types.any? && !type.nil? && supplied_types.first != type
+            raise ArgumentError.new("content fields must match the selected Program Resource type")
+          end
+          if !creating && !type.nil? && supplied_types != [type]
+            raise ArgumentError.new("changing a Program Resource type requires its replacement content")
+          end
+          return unless creating && (supplied_types.empty? || supplied_types.first != type)
+
+          raise ArgumentError.new("create requires content fields for the selected Program Resource type")
+        end
+      end
+    end
+  end
+end

data/lib/growsurf_ruby/resources/campaign/rewards.rb

@@ -28,7 +28,8 @@ module GrowsurfRuby
         # The reward type must be compatible with the program type (affiliate programs
         # support only `AFFILIATE` rewards; referral programs support all other types).
         # Enabling an active reward of a type automatically enables that reward type on
-        # the program.
+        # the program. For an affiliate reward, `commissionStructure.event: LEAD`
+        # requires a `FIXED` commission with a positive `amount`.
         #
         # @overload create(id, type:, commission_structure: nil, conversions_required: nil, coupon_code: nil, description: nil, event: nil, image_url: nil, is_unlimited: nil, is_visible: nil, limit: nil, limit_duration: nil, metadata: nil, next_milestone_prefix: nil, next_milestone_suffix: nil, number_of_winners: nil, order: nil, referral_coupon_code: nil, referral_description: nil, referred_reward_upfront: nil, referred_value: nil, title: nil, value: nil, request_options: {})
         #
@@ -36,7 +37,7 @@ module GrowsurfRuby
         #
         # @param type [Symbol, GrowsurfRuby::Models::Campaign::RewardCreateParams::Type] Body param: The reward type. Immutable after creation.
         #
-        # @param commission_structure [GrowsurfRuby::Models::CommissionStructure] Body param
+        # @param commission_structure [GrowsurfRuby::Models::CommissionStructure] Body param: The affiliate commission structure. Required when creating an `AFFILIATE` reward. A `FIXED` commission requires `amount`; a `PERCENT` commission requires `percent`.
         #
         # @param conversions_required [Integer] Body param
         #
@@ -98,7 +99,8 @@ module GrowsurfRuby
         # immutable and cannot be changed. When the update replaces `metadata`, renamed
         # keys automatically rewrite any `{{campaignReward[…]}}` references in campaign
         # copy; removing a key that campaign copy still references returns a `409` listing
-        # the referencing fields.
+        # the referencing fields. For an affiliate reward, `commissionStructure.event:
+        # LEAD` requires a `FIXED` commission with a positive `amount`.
         #
         # @overload update(campaign_reward_id, id:, commission_structure: nil, conversions_required: nil, coupon_code: nil, description: nil, event: nil, image_url: nil, is_unlimited: nil, is_visible: nil, limit: nil, limit_duration: nil, metadata: nil, next_milestone_prefix: nil, next_milestone_suffix: nil, number_of_winners: nil, order: nil, referral_coupon_code: nil, referral_description: nil, referred_reward_upfront: nil, referred_value: nil, title: nil, value: nil, request_options: {})
         #
@@ -106,7 +108,7 @@ module GrowsurfRuby
         #
         # @param id [String] Path param: GrowSurf program ID.
         #
-        # @param commission_structure [GrowsurfRuby::Models::CommissionStructure] Body param
+        # @param commission_structure [GrowsurfRuby::Models::CommissionStructure] Body param: The affiliate commission structure. A `FIXED` commission requires `amount`; a `PERCENT` commission requires `percent`.
         #
         # @param conversions_required [Integer] Body param
         #

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.4.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