whop_sdk 0.0.39 → 0.0.41

data/rbi/whop_sdk/models/ad_list_params.rbi

@@ -11,88 +11,182 @@ module WhopSDK
           T.any(WhopSDK::AdListParams, WhopSDK::Internal::AnyHash)
         end
 
-      # Filter by ad group. Provide exactly one of ad_group_id, campaign_id, or
-      # company_id.
+      # The account the ads belong to. Defaults to the account-scoped key's own account.
       sig { returns(T.nilable(String)) }
-      attr_accessor :ad_group_id
+      attr_reader :account_id
 
-      # Returns the elements in the list that come after the specified cursor.
+      sig { params(account_id: String).void }
+      attr_writer :account_id
+
+      # Only return ads in this ad campaign.
       sig { returns(T.nilable(String)) }
-      attr_accessor :after
+      attr_reader :ad_campaign_id
+
+      sig { params(ad_campaign_id: String).void }
+      attr_writer :ad_campaign_id
 
-      # Returns the elements in the list that come before the specified cursor.
+      # Only return ads in this ad group.
       sig { returns(T.nilable(String)) }
-      attr_accessor :before
+      attr_reader :ad_group_id
 
-      # Filter by campaign. Provide exactly one of ad_group_id, campaign_id, or
-      # company_id.
+      sig { params(ad_group_id: String).void }
+      attr_writer :ad_group_id
+
+      # Cursor to fetch the page after (from page_info.end_cursor).
       sig { returns(T.nilable(String)) }
-      attr_accessor :campaign_id
+      attr_reader :after
+
+      sig { params(after: String).void }
+      attr_writer :after
 
-      # Filter by company. Provide exactly one of ad_group_id, campaign_id, or
-      # company_id.
+      # Cursor to fetch the page before (from page_info.start_cursor).
       sig { returns(T.nilable(String)) }
-      attr_accessor :company_id
+      attr_reader :before
+
+      sig { params(before: String).void }
+      attr_writer :before
 
       # Only return ads created after this timestamp.
-      sig { returns(T.nilable(Time)) }
-      attr_accessor :created_after
+      sig { returns(T.nilable(String)) }
+      attr_reader :created_after
+
+      sig { params(created_after: String).void }
+      attr_writer :created_after
 
       # Only return ads created before this timestamp.
-      sig { returns(T.nilable(Time)) }
-      attr_accessor :created_before
+      sig { returns(T.nilable(String)) }
+      attr_reader :created_before
+
+      sig { params(created_before: String).void }
+      attr_writer :created_before
+
+      # The sort direction. Defaults to desc.
+      sig { returns(T.nilable(WhopSDK::AdListParams::Direction::OrSymbol)) }
+      attr_reader :direction
+
+      sig { params(direction: WhopSDK::AdListParams::Direction::OrSymbol).void }
+      attr_writer :direction
 
-      # Returns the first _n_ elements from the list.
+      # The number of ads to return.
       sig { returns(T.nilable(Integer)) }
-      attr_accessor :first
+      attr_reader :first
 
-      # Returns the last _n_ elements from the list.
+      sig { params(first: Integer).void }
+      attr_writer :first
+
+      # The number of ads to return from the end of the range.
       sig { returns(T.nilable(Integer)) }
-      attr_accessor :last
+      attr_reader :last
+
+      sig { params(last: Integer).void }
+      attr_writer :last
+
+      # The field to sort by. Defaults to created_at. Stat columns (spend, impressions,
+      # …) rank over the stats_from/stats_to window across the whole list, not just the
+      # current page. results, cost_per_result and return_on_ad_spend rank by the same
+      # Whop pixel-attributed values the response reports.
+      sig { returns(T.nilable(WhopSDK::AdListParams::Order::OrSymbol)) }
+      attr_reader :order
 
-      # The status of an external ad.
+      sig { params(order: WhopSDK::AdListParams::Order::OrSymbol).void }
+      attr_writer :order
+
+      # Filter ads by a title or ID substring.
+      sig { returns(T.nilable(String)) }
+      attr_reader :query
+
+      sig { params(query: String).void }
+      attr_writer :query
+
+      # Start of the stats window. Defaults to all-time.
+      sig { returns(T.nilable(String)) }
+      attr_reader :stats_from
+
+      sig { params(stats_from: String).void }
+      attr_writer :stats_from
+
+      # End of the stats window. Defaults to now.
+      sig { returns(T.nilable(String)) }
+      attr_reader :stats_to
+
+      sig { params(stats_to: String).void }
+      attr_writer :stats_to
+
+      # Only return ads with this status.
       sig { returns(T.nilable(WhopSDK::AdListParams::Status::OrSymbol)) }
-      attr_accessor :status
+      attr_reader :status
+
+      sig { params(status: WhopSDK::AdListParams::Status::OrSymbol).void }
+      attr_writer :status
+
+      # IANA timezone (e.g. America/New_York) the stats window is interpreted in. Bare
+      # stats_from/stats_to dates resolve to day boundaries on this clock. Defaults to
+      # UTC.
+      sig { returns(T.nilable(String)) }
+      attr_reader :time_zone
+
+      sig { params(time_zone: String).void }
+      attr_writer :time_zone
 
       sig do
         params(
-          ad_group_id: T.nilable(String),
-          after: T.nilable(String),
-          before: T.nilable(String),
-          campaign_id: T.nilable(String),
-          company_id: T.nilable(String),
-          created_after: T.nilable(Time),
-          created_before: T.nilable(Time),
-          first: T.nilable(Integer),
-          last: T.nilable(Integer),
-          status: T.nilable(WhopSDK::AdListParams::Status::OrSymbol),
+          account_id: String,
+          ad_campaign_id: String,
+          ad_group_id: String,
+          after: String,
+          before: String,
+          created_after: String,
+          created_before: String,
+          direction: WhopSDK::AdListParams::Direction::OrSymbol,
+          first: Integer,
+          last: Integer,
+          order: WhopSDK::AdListParams::Order::OrSymbol,
+          query: String,
+          stats_from: String,
+          stats_to: String,
+          status: WhopSDK::AdListParams::Status::OrSymbol,
+          time_zone: String,
           request_options: WhopSDK::RequestOptions::OrHash
         ).returns(T.attached_class)
       end
       def self.new(
-        # Filter by ad group. Provide exactly one of ad_group_id, campaign_id, or
-        # company_id.
+        # The account the ads belong to. Defaults to the account-scoped key's own account.
+        account_id: nil,
+        # Only return ads in this ad campaign.
+        ad_campaign_id: nil,
+        # Only return ads in this ad group.
         ad_group_id: nil,
-        # Returns the elements in the list that come after the specified cursor.
+        # Cursor to fetch the page after (from page_info.end_cursor).
         after: nil,
-        # Returns the elements in the list that come before the specified cursor.
+        # Cursor to fetch the page before (from page_info.start_cursor).
         before: nil,
-        # Filter by campaign. Provide exactly one of ad_group_id, campaign_id, or
-        # company_id.
-        campaign_id: nil,
-        # Filter by company. Provide exactly one of ad_group_id, campaign_id, or
-        # company_id.
-        company_id: nil,
         # Only return ads created after this timestamp.
         created_after: nil,
         # Only return ads created before this timestamp.
         created_before: nil,
-        # Returns the first _n_ elements from the list.
+        # The sort direction. Defaults to desc.
+        direction: nil,
+        # The number of ads to return.
         first: nil,
-        # Returns the last _n_ elements from the list.
+        # The number of ads to return from the end of the range.
         last: nil,
-        # The status of an external ad.
+        # The field to sort by. Defaults to created_at. Stat columns (spend, impressions,
+        # …) rank over the stats_from/stats_to window across the whole list, not just the
+        # current page. results, cost_per_result and return_on_ad_spend rank by the same
+        # Whop pixel-attributed values the response reports.
+        order: nil,
+        # Filter ads by a title or ID substring.
+        query: nil,
+        # Start of the stats window. Defaults to all-time.
+        stats_from: nil,
+        # End of the stats window. Defaults to now.
+        stats_to: nil,
+        # Only return ads with this status.
         status: nil,
+        # IANA timezone (e.g. America/New_York) the stats window is interpreted in. Bare
+        # stats_from/stats_to dates resolve to day boundaries on this clock. Defaults to
+        # UTC.
+        time_zone: nil,
         request_options: {}
       )
       end
@@ -100,16 +194,22 @@ module WhopSDK
       sig do
         override.returns(
           {
-            ad_group_id: T.nilable(String),
-            after: T.nilable(String),
-            before: T.nilable(String),
-            campaign_id: T.nilable(String),
-            company_id: T.nilable(String),
-            created_after: T.nilable(Time),
-            created_before: T.nilable(Time),
-            first: T.nilable(Integer),
-            last: T.nilable(Integer),
-            status: T.nilable(WhopSDK::AdListParams::Status::OrSymbol),
+            account_id: String,
+            ad_campaign_id: String,
+            ad_group_id: String,
+            after: String,
+            before: String,
+            created_after: String,
+            created_before: String,
+            direction: WhopSDK::AdListParams::Direction::OrSymbol,
+            first: Integer,
+            last: Integer,
+            order: WhopSDK::AdListParams::Order::OrSymbol,
+            query: String,
+            stats_from: String,
+            stats_to: String,
+            status: WhopSDK::AdListParams::Status::OrSymbol,
+            time_zone: String,
             request_options: WhopSDK::RequestOptions
           }
         )
@@ -117,7 +217,70 @@ module WhopSDK
       def to_hash
       end
 
-      # The status of an external ad.
+      # The sort direction. Defaults to desc.
+      module Direction
+        extend WhopSDK::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias { T.all(Symbol, WhopSDK::AdListParams::Direction) }
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        ASC = T.let(:asc, WhopSDK::AdListParams::Direction::TaggedSymbol)
+        DESC = T.let(:desc, WhopSDK::AdListParams::Direction::TaggedSymbol)
+
+        sig do
+          override.returns(
+            T::Array[WhopSDK::AdListParams::Direction::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
+
+      # The field to sort by. Defaults to created_at. Stat columns (spend, impressions,
+      # …) rank over the stats_from/stats_to window across the whole list, not just the
+      # current page. results, cost_per_result and return_on_ad_spend rank by the same
+      # Whop pixel-attributed values the response reports.
+      module Order
+        extend WhopSDK::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias { T.all(Symbol, WhopSDK::AdListParams::Order) }
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        CREATED_AT =
+          T.let(:created_at, WhopSDK::AdListParams::Order::TaggedSymbol)
+        UPDATED_AT =
+          T.let(:updated_at, WhopSDK::AdListParams::Order::TaggedSymbol)
+        SPEND = T.let(:spend, WhopSDK::AdListParams::Order::TaggedSymbol)
+        IMPRESSIONS =
+          T.let(:impressions, WhopSDK::AdListParams::Order::TaggedSymbol)
+        REACH = T.let(:reach, WhopSDK::AdListParams::Order::TaggedSymbol)
+        CLICKS = T.let(:clicks, WhopSDK::AdListParams::Order::TaggedSymbol)
+        UNIQUE_CLICKS =
+          T.let(:unique_clicks, WhopSDK::AdListParams::Order::TaggedSymbol)
+        FREQUENCY =
+          T.let(:frequency, WhopSDK::AdListParams::Order::TaggedSymbol)
+        CLICK_THROUGH_RATE =
+          T.let(:click_through_rate, WhopSDK::AdListParams::Order::TaggedSymbol)
+        RESULTS = T.let(:results, WhopSDK::AdListParams::Order::TaggedSymbol)
+        COST_PER_MILLE =
+          T.let(:cost_per_mille, WhopSDK::AdListParams::Order::TaggedSymbol)
+        COST_PER_CLICK =
+          T.let(:cost_per_click, WhopSDK::AdListParams::Order::TaggedSymbol)
+        COST_PER_RESULT =
+          T.let(:cost_per_result, WhopSDK::AdListParams::Order::TaggedSymbol)
+        RETURN_ON_AD_SPEND =
+          T.let(:return_on_ad_spend, WhopSDK::AdListParams::Order::TaggedSymbol)
+
+        sig do
+          override.returns(T::Array[WhopSDK::AdListParams::Order::TaggedSymbol])
+        end
+        def self.values
+        end
+      end
+
+      # Only return ads with this status.
       module Status
         extend WhopSDK::Internal::Type::Enum
 
@@ -127,11 +290,9 @@ module WhopSDK
 
         ACTIVE = T.let(:active, WhopSDK::AdListParams::Status::TaggedSymbol)
         PAUSED = T.let(:paused, WhopSDK::AdListParams::Status::TaggedSymbol)
-        INACTIVE = T.let(:inactive, WhopSDK::AdListParams::Status::TaggedSymbol)
         IN_REVIEW =
           T.let(:in_review, WhopSDK::AdListParams::Status::TaggedSymbol)
         REJECTED = T.let(:rejected, WhopSDK::AdListParams::Status::TaggedSymbol)
-        FLAGGED = T.let(:flagged, WhopSDK::AdListParams::Status::TaggedSymbol)
 
         sig do
           override.returns(

data/rbi/whop_sdk/models/ad_pause_params.rbi

@@ -0,0 +1,35 @@
+# typed: strong
+
+module WhopSDK
+  module Models
+    class AdPauseParams < WhopSDK::Internal::Type::BaseModel
+      extend WhopSDK::Internal::Type::RequestParameters::Converter
+      include WhopSDK::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(WhopSDK::AdPauseParams, WhopSDK::Internal::AnyHash)
+        end
+
+      sig { returns(String) }
+      attr_accessor :id
+
+      sig do
+        params(
+          id: String,
+          request_options: WhopSDK::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(id:, request_options: {})
+      end
+
+      sig do
+        override.returns(
+          { id: String, request_options: WhopSDK::RequestOptions }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/whop_sdk/models/ad_report_retrieve_params.rbi

@@ -19,39 +19,54 @@ module WhopSDK
       sig { returns(Time) }
       attr_accessor :to
 
-      # The unique identifier of an ad campaign. Mutually exclusive with `adGroupId` and
-      # `adId`.
-      sig { returns(T.nilable(String)) }
-      attr_accessor :ad_campaign_id
+      # Scope the report to these ad campaigns (max 100); stats are summed across them.
+      # Mutually exclusive with `companyId`, `adGroupIds`, and `adIds`.
+      sig { returns(T.nilable(T::Array[String])) }
+      attr_accessor :ad_campaign_ids
 
-      # The unique identifier of an ad group. Mutually exclusive with `adCampaignId` and
-      # `adId`.
-      sig { returns(T.nilable(String)) }
-      attr_accessor :ad_group_id
+      # Scope the report to these ad groups (max 100); stats are summed across them.
+      # Mutually exclusive with `companyId`, `adCampaignIds`, and `adIds`.
+      sig { returns(T.nilable(T::Array[String])) }
+      attr_accessor :ad_group_ids
 
-      # The unique identifier of an ad. Mutually exclusive with `adCampaignId` and
-      # `adGroupId`.
+      # Scope the report to these ads (max 100); stats are summed across them. Mutually
+      # exclusive with `companyId`, `adCampaignIds`, and `adGroupIds`.
+      sig { returns(T.nilable(T::Array[String])) }
+      attr_accessor :ad_ids
+
+      # Entity level to group an ad report by.
+      sig do
+        returns(T.nilable(WhopSDK::AdReportRetrieveParams::Breakdown::OrSymbol))
+      end
+      attr_accessor :breakdown
+
+      # The unique identifier of a company. Mutually exclusive with `adCampaignIds`,
+      # `adGroupIds`, and `adIds`. Use with `breakdown` to fan out across every
+      # campaign, ad group, or ad in the company without paging.
       sig { returns(T.nilable(String)) }
-      attr_accessor :ad_id
+      attr_accessor :company_id
 
       # ISO 4217 currency code to report `spend` in. Defaults to the company's ads
       # reporting currency.
       sig { returns(T.nilable(String)) }
       attr_accessor :currency
 
-      # When true, includes a per-day breakdown alongside the summary.
-      sig { returns(T.nilable(T::Boolean)) }
-      attr_accessor :include_daily
+      # Bucket size for external ad stat rows.
+      sig { returns(T.nilable(WhopSDK::Granularities::OrSymbol)) }
+      attr_accessor :granularity
 
       sig do
         params(
           from: Time,
           to: Time,
-          ad_campaign_id: T.nilable(String),
-          ad_group_id: T.nilable(String),
-          ad_id: T.nilable(String),
+          ad_campaign_ids: T.nilable(T::Array[String]),
+          ad_group_ids: T.nilable(T::Array[String]),
+          ad_ids: T.nilable(T::Array[String]),
+          breakdown:
+            T.nilable(WhopSDK::AdReportRetrieveParams::Breakdown::OrSymbol),
+          company_id: T.nilable(String),
           currency: T.nilable(String),
-          include_daily: T.nilable(T::Boolean),
+          granularity: T.nilable(WhopSDK::Granularities::OrSymbol),
           request_options: WhopSDK::RequestOptions::OrHash
         ).returns(T.attached_class)
       end
@@ -60,20 +75,26 @@ module WhopSDK
         from:,
         # Inclusive end of the reporting window.
         to:,
-        # The unique identifier of an ad campaign. Mutually exclusive with `adGroupId` and
-        # `adId`.
-        ad_campaign_id: nil,
-        # The unique identifier of an ad group. Mutually exclusive with `adCampaignId` and
-        # `adId`.
-        ad_group_id: nil,
-        # The unique identifier of an ad. Mutually exclusive with `adCampaignId` and
-        # `adGroupId`.
-        ad_id: nil,
+        # Scope the report to these ad campaigns (max 100); stats are summed across them.
+        # Mutually exclusive with `companyId`, `adGroupIds`, and `adIds`.
+        ad_campaign_ids: nil,
+        # Scope the report to these ad groups (max 100); stats are summed across them.
+        # Mutually exclusive with `companyId`, `adCampaignIds`, and `adIds`.
+        ad_group_ids: nil,
+        # Scope the report to these ads (max 100); stats are summed across them. Mutually
+        # exclusive with `companyId`, `adCampaignIds`, and `adGroupIds`.
+        ad_ids: nil,
+        # Entity level to group an ad report by.
+        breakdown: nil,
+        # The unique identifier of a company. Mutually exclusive with `adCampaignIds`,
+        # `adGroupIds`, and `adIds`. Use with `breakdown` to fan out across every
+        # campaign, ad group, or ad in the company without paging.
+        company_id: nil,
         # ISO 4217 currency code to report `spend` in. Defaults to the company's ads
         # reporting currency.
         currency: nil,
-        # When true, includes a per-day breakdown alongside the summary.
-        include_daily: nil,
+        # Bucket size for external ad stat rows.
+        granularity: nil,
         request_options: {}
       )
       end
@@ -83,17 +104,52 @@ module WhopSDK
           {
             from: Time,
             to: Time,
-            ad_campaign_id: T.nilable(String),
-            ad_group_id: T.nilable(String),
-            ad_id: T.nilable(String),
+            ad_campaign_ids: T.nilable(T::Array[String]),
+            ad_group_ids: T.nilable(T::Array[String]),
+            ad_ids: T.nilable(T::Array[String]),
+            breakdown:
+              T.nilable(WhopSDK::AdReportRetrieveParams::Breakdown::OrSymbol),
+            company_id: T.nilable(String),
             currency: T.nilable(String),
-            include_daily: T.nilable(T::Boolean),
+            granularity: T.nilable(WhopSDK::Granularities::OrSymbol),
             request_options: WhopSDK::RequestOptions
           }
         )
       end
       def to_hash
       end
+
+      # Entity level to group an ad report by.
+      module Breakdown
+        extend WhopSDK::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, WhopSDK::AdReportRetrieveParams::Breakdown)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        CAMPAIGN =
+          T.let(
+            :campaign,
+            WhopSDK::AdReportRetrieveParams::Breakdown::TaggedSymbol
+          )
+        AD_GROUP =
+          T.let(
+            :ad_group,
+            WhopSDK::AdReportRetrieveParams::Breakdown::TaggedSymbol
+          )
+        AD =
+          T.let(:ad, WhopSDK::AdReportRetrieveParams::Breakdown::TaggedSymbol)
+
+        sig do
+          override.returns(
+            T::Array[WhopSDK::AdReportRetrieveParams::Breakdown::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
     end
   end
 end