whop_sdk 2.2.0 → 2.3.0

data/lib/whop_sdk/external_accounts/lead_forms/client.rb

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module ExternalAccounts
+    module LeadForms
+      class Client
+        # @param client [Whop_sdk::Internal::Http::RawClient]
+        # @param base_url [String, nil]
+        # @param environment [Hash[Symbol, String], nil]
+        #
+        # @return [void]
+        def initialize(client:, base_url: nil, environment: nil)
+          @client = client
+          @base_url = base_url
+          @environment = environment
+        end
+
+        # Lists the active lead (instant) forms that already exist on a connected Facebook page, so an ad can reuse one
+        # as its `lead_gen_form_id` instead of authoring a new form. Every active form comes back in a single response —
+        # the list is not paginated.
+        #
+        # @param request_options [Hash]
+        # @param params [Hash]
+        # @option request_options [String] :base_url
+        # @option request_options [Hash{String => Object}] :additional_headers
+        # @option request_options [Hash{String => Object}] :additional_query_parameters
+        # @option request_options [Hash{String => Object}] :additional_body_parameters
+        # @option request_options [Integer] :timeout_in_seconds
+        # @option params [String] :id
+        # @option params [String] :account_id
+        #
+        # @example
+        #   client.external_accounts.lead_forms.list(
+        #     id: "id",
+        #     account_id: "account_id"
+        #   )
+        #
+        # @return [Whop_sdk::ExternalAccounts::LeadForms::Types::ListLeadFormsResponse]
+        def list(request_options: {}, **params)
+          params = Whop_sdk::Internal::Types::Utils.normalize_keys(params)
+          query_params = {}
+          query_params["account_id"] = params[:account_id] if params.key?(:account_id)
+
+          request = Whop_sdk::Internal::JSON::Request.new(
+            base_url: request_options[:base_url] || @base_url || @environment&.dig(:api),
+            method: "GET",
+            path: "external_accounts/#{URI.encode_uri_component(params[:id].to_s)}/lead_forms",
+            query: query_params,
+            request_options: request_options
+          )
+          begin
+            response = @client.send(request)
+          rescue Net::HTTPRequestTimeout
+            raise Whop_sdk::Errors::TimeoutError
+          end
+          code = response.code.to_i
+          if code.between?(200, 299)
+            (response.body.to_s.empty? ? nil : Whop_sdk::ExternalAccounts::LeadForms::Types::ListLeadFormsResponse.load(response.body))
+          else
+            error_class = Whop_sdk::Errors::ResponseError.subclass_for_code(code)
+            raise error_class.new(response.body, code: code)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/whop_sdk/external_accounts/lead_forms/types/list_lead_forms_request.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module ExternalAccounts
+    module LeadForms
+      module Types
+        class ListLeadFormsRequest < Internal::Types::Model
+          field :id, -> { String }, optional: false, nullable: false
+
+          field :account_id, -> { String }, optional: false, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/whop_sdk/external_accounts/lead_forms/types/list_lead_forms_response.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module ExternalAccounts
+    module LeadForms
+      module Types
+        class ListLeadFormsResponse < Internal::Types::Model
+          field :data, -> { Internal::Types::Array[Whop_sdk::Types::ExternalAccountLeadForm] }, optional: false, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/whop_sdk/external_accounts/partners/client.rb

@@ -0,0 +1,168 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module ExternalAccounts
+    module Partners
+      class Client
+        # @param client [Whop_sdk::Internal::Http::RawClient]
+        # @param base_url [String, nil]
+        # @param environment [Hash[Symbol, String], nil]
+        #
+        # @return [void]
+        def initialize(client:, base_url: nil, environment: nil)
+          @client = client
+          @base_url = base_url
+          @environment = environment
+        end
+
+        # Lists the creators an Instagram account runs partnership ads with, and where each creator's permission stands.
+        #
+        # @param request_options [Hash]
+        # @param params [Hash]
+        # @option request_options [String] :base_url
+        # @option request_options [Hash{String => Object}] :additional_headers
+        # @option request_options [Hash{String => Object}] :additional_query_parameters
+        # @option request_options [Hash{String => Object}] :additional_body_parameters
+        # @option request_options [Integer] :timeout_in_seconds
+        # @option params [String] :external_account_id
+        # @option params [String, nil] :account_id
+        # @option params [Integer, nil] :first
+        # @option params [String, nil] :after
+        #
+        # @example
+        #   client.external_accounts.partners.list(external_account_id: "external_account_id")
+        #
+        # @return [Whop_sdk::ExternalAccounts::Partners::Types::ListPartnersResponse]
+        def list(request_options: {}, **params)
+          params = Whop_sdk::Internal::Types::Utils.normalize_keys(params)
+          query_params = {}
+          query_params["account_id"] = params[:account_id] if params.key?(:account_id)
+          query_params["first"] = params[:first] if params.key?(:first)
+          query_params["after"] = params[:after] if params.key?(:after)
+
+          Whop_sdk::Internal::CursorItemIterator.new(
+            cursor_field: :end_cursor,
+            item_field: :data,
+            initial_cursor: query_params["after"]
+          ) do |next_cursor|
+            query_params["after"] = next_cursor
+            request = Whop_sdk::Internal::JSON::Request.new(
+              base_url: request_options[:base_url] || @base_url || @environment&.dig(:api),
+              method: "GET",
+              path: "external_accounts/#{URI.encode_uri_component(params[:external_account_id].to_s)}/partners",
+              query: query_params,
+              request_options: request_options
+            )
+            begin
+              response = @client.send(request)
+            rescue Net::HTTPRequestTimeout
+              raise Whop_sdk::Errors::TimeoutError
+            end
+            code = response.code.to_i
+            if code.between?(200, 299)
+              parsed_response = (response.body.to_s.empty? ? nil : Whop_sdk::ExternalAccounts::Partners::Types::ListPartnersResponse.load(response.body))
+              [parsed_response, response]
+            else
+              error_class = Whop_sdk::Errors::ResponseError.subclass_for_code(code)
+              raise error_class.new(response.body, code: code)
+            end
+          end
+        end
+
+        # Invites an Instagram creator to run partnership ads with an Instagram account. The creator approves the
+        # invitation in the Instagram app, and `partnership_status` stays `pending` until they do;
+        # [refresh](/api-reference/beta/external-accounts/refresh) the partner to pick up their answer.
+        #
+        # @param request_options [Hash]
+        # @param params [Whop_sdk::ExternalAccounts::Partners::Types::CreatePartnersRequest]
+        # @option request_options [String] :base_url
+        # @option request_options [Hash{String => Object}] :additional_headers
+        # @option request_options [Hash{String => Object}] :additional_query_parameters
+        # @option request_options [Hash{String => Object}] :additional_body_parameters
+        # @option request_options [Integer] :timeout_in_seconds
+        # @option params [String] :external_account_id
+        #
+        # @example
+        #   client.external_accounts.partners.create(
+        #     external_account_id: "external_account_id",
+        #     username: "@luverahealth"
+        #   )
+        #
+        # @return [Whop_sdk::Types::ExternalAccount]
+        def create(request_options: {}, **params)
+          params = Whop_sdk::Internal::Types::Utils.normalize_keys(params)
+          request_data = Whop_sdk::ExternalAccounts::Partners::Types::CreatePartnersRequest.new(params).to_h
+          non_body_param_names = %w[external_account_id]
+          body = request_data.except(*non_body_param_names)
+
+          request = Whop_sdk::Internal::JSON::Request.new(
+            base_url: request_options[:base_url] || @base_url || @environment&.dig(:api),
+            method: "POST",
+            path: "external_accounts/#{URI.encode_uri_component(params[:external_account_id].to_s)}/partners",
+            body: body,
+            request_options: request_options
+          )
+          begin
+            response = @client.send(request)
+          rescue Net::HTTPRequestTimeout
+            raise Whop_sdk::Errors::TimeoutError
+          end
+          code = response.code.to_i
+          if code.between?(200, 299)
+            (response.body.to_s.empty? ? nil : Whop_sdk::Types::ExternalAccount.load(response.body))
+          else
+            error_class = Whop_sdk::Errors::ResponseError.subclass_for_code(code)
+            raise error_class.new(response.body, code: code)
+          end
+        end
+
+        # Revokes a creator's permission to run partnership ads with an Instagram account. Every account that advertises
+        # as the Instagram account loses the partner, since the permission belongs to the Instagram account.
+        #
+        # @param request_options [Hash]
+        # @param params [Hash]
+        # @option request_options [String] :base_url
+        # @option request_options [Hash{String => Object}] :additional_headers
+        # @option request_options [Hash{String => Object}] :additional_query_parameters
+        # @option request_options [Hash{String => Object}] :additional_body_parameters
+        # @option request_options [Integer] :timeout_in_seconds
+        # @option params [String] :external_account_id
+        # @option params [String] :id
+        # @option params [String, nil] :account_id
+        #
+        # @example
+        #   client.external_accounts.partners.delete(
+        #     external_account_id: "external_account_id",
+        #     id: "id"
+        #   )
+        #
+        # @return [Whop_sdk::ExternalAccounts::Partners::Types::DeletePartnersResponse]
+        def delete(request_options: {}, **params)
+          params = Whop_sdk::Internal::Types::Utils.normalize_keys(params)
+          query_params = {}
+          query_params["account_id"] = params[:account_id] if params.key?(:account_id)
+
+          request = Whop_sdk::Internal::JSON::Request.new(
+            base_url: request_options[:base_url] || @base_url || @environment&.dig(:api),
+            method: "DELETE",
+            path: "external_accounts/#{URI.encode_uri_component(params[:external_account_id].to_s)}/partners/#{URI.encode_uri_component(params[:id].to_s)}",
+            query: query_params,
+            request_options: request_options
+          )
+          begin
+            response = @client.send(request)
+          rescue Net::HTTPRequestTimeout
+            raise Whop_sdk::Errors::TimeoutError
+          end
+          code = response.code.to_i
+          if code.between?(200, 299)
+            (response.body.to_s.empty? ? nil : Whop_sdk::ExternalAccounts::Partners::Types::DeletePartnersResponse.load(response.body))
+          else
+            error_class = Whop_sdk::Errors::ResponseError.subclass_for_code(code)
+            raise error_class.new(response.body, code: code)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/whop_sdk/external_accounts/partners/types/create_partners_request.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module ExternalAccounts
+    module Partners
+      module Types
+        class CreatePartnersRequest < Internal::Types::Model
+          field :external_account_id, -> { String }, optional: false, nullable: false
+
+          field :account_id, -> { String }, optional: true, nullable: false
+
+          field :username, -> { String }, optional: false, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/whop_sdk/external_accounts/partners/types/delete_partners_request.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module ExternalAccounts
+    module Partners
+      module Types
+        class DeletePartnersRequest < Internal::Types::Model
+          field :external_account_id, -> { String }, optional: false, nullable: false
+
+          field :id, -> { String }, optional: false, nullable: false
+
+          field :account_id, -> { String }, optional: true, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/whop_sdk/external_accounts/partners/types/delete_partners_response.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module ExternalAccounts
+    module Partners
+      module Types
+        class DeletePartnersResponse < Internal::Types::Model
+          field :deleted, -> { Internal::Types::Boolean }, optional: false, nullable: false
+
+          field :id, -> { String }, optional: false, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/whop_sdk/external_accounts/partners/types/list_partners_request.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module ExternalAccounts
+    module Partners
+      module Types
+        class ListPartnersRequest < Internal::Types::Model
+          field :external_account_id, -> { String }, optional: false, nullable: false
+
+          field :account_id, -> { String }, optional: true, nullable: false
+
+          field :first, -> { Integer }, optional: true, nullable: false
+
+          field :after, -> { String }, optional: true, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/whop_sdk/external_accounts/partners/types/list_partners_response.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module ExternalAccounts
+    module Partners
+      module Types
+        class ListPartnersResponse < Internal::Types::Model
+          field :data, -> { Internal::Types::Array[Whop_sdk::Types::ExternalAccount] }, optional: false, nullable: false
+
+          field :page_info, -> { Whop_sdk::ExternalAccounts::Partners::Types::ListPartnersResponsePageInfo }, optional: false, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/whop_sdk/external_accounts/partners/types/list_partners_response_page_info.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module ExternalAccounts
+    module Partners
+      module Types
+        class ListPartnersResponsePageInfo < Internal::Types::Model
+          field :end_cursor, -> { String }, optional: false, nullable: true
+
+          field :has_next_page, -> { Internal::Types::Boolean }, optional: false, nullable: false
+
+          field :has_previous_page, -> { Internal::Types::Boolean }, optional: false, nullable: false
+
+          field :start_cursor, -> { String }, optional: false, nullable: true
+        end
+      end
+    end
+  end
+end

data/lib/whop_sdk/external_accounts/posts/client.rb

@@ -0,0 +1,79 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module ExternalAccounts
+    module Posts
+      class Client
+        # @param client [Whop_sdk::Internal::Http::RawClient]
+        # @param base_url [String, nil]
+        # @param environment [Hash[Symbol, String], nil]
+        #
+        # @return [void]
+        def initialize(client:, base_url: nil, environment: nil)
+          @client = client
+          @base_url = base_url
+          @environment = environment
+        end
+
+        # Lists the existing posts of a connected Facebook page, Instagram account, or TikTok account.
+        #
+        # @param request_options [Hash]
+        # @param params [Hash]
+        # @option request_options [String] :base_url
+        # @option request_options [Hash{String => Object}] :additional_headers
+        # @option request_options [Hash{String => Object}] :additional_query_parameters
+        # @option request_options [Hash{String => Object}] :additional_body_parameters
+        # @option request_options [Integer] :timeout_in_seconds
+        # @option params [String] :id
+        # @option params [String] :account_id
+        # @option params [String, nil] :post_id
+        # @option params [Integer, nil] :first
+        # @option params [String, nil] :after
+        #
+        # @example
+        #   client.external_accounts.posts.list(
+        #     id: "id",
+        #     account_id: "account_id"
+        #   )
+        #
+        # @return [Whop_sdk::ExternalAccounts::Posts::Types::ListPostsResponse]
+        def list(request_options: {}, **params)
+          params = Whop_sdk::Internal::Types::Utils.normalize_keys(params)
+          query_params = {}
+          query_params["account_id"] = params[:account_id] if params.key?(:account_id)
+          query_params["post_id"] = params[:post_id] if params.key?(:post_id)
+          query_params["first"] = params[:first] if params.key?(:first)
+          query_params["after"] = params[:after] if params.key?(:after)
+
+          Whop_sdk::Internal::CursorItemIterator.new(
+            cursor_field: :end_cursor,
+            item_field: :data,
+            initial_cursor: query_params["after"]
+          ) do |next_cursor|
+            query_params["after"] = next_cursor
+            request = Whop_sdk::Internal::JSON::Request.new(
+              base_url: request_options[:base_url] || @base_url || @environment&.dig(:api),
+              method: "GET",
+              path: "external_accounts/#{URI.encode_uri_component(params[:id].to_s)}/posts",
+              query: query_params,
+              request_options: request_options
+            )
+            begin
+              response = @client.send(request)
+            rescue Net::HTTPRequestTimeout
+              raise Whop_sdk::Errors::TimeoutError
+            end
+            code = response.code.to_i
+            if code.between?(200, 299)
+              parsed_response = (response.body.to_s.empty? ? nil : Whop_sdk::ExternalAccounts::Posts::Types::ListPostsResponse.load(response.body))
+              [parsed_response, response]
+            else
+              error_class = Whop_sdk::Errors::ResponseError.subclass_for_code(code)
+              raise error_class.new(response.body, code: code)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/whop_sdk/external_accounts/posts/types/list_posts_request.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module ExternalAccounts
+    module Posts
+      module Types
+        class ListPostsRequest < Internal::Types::Model
+          field :id, -> { String }, optional: false, nullable: false
+
+          field :account_id, -> { String }, optional: false, nullable: false
+
+          field :post_id, -> { String }, optional: true, nullable: false
+
+          field :first, -> { Integer }, optional: true, nullable: false
+
+          field :after, -> { String }, optional: true, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/whop_sdk/external_accounts/posts/types/list_posts_response.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module ExternalAccounts
+    module Posts
+      module Types
+        class ListPostsResponse < Internal::Types::Model
+          field :data, -> { Internal::Types::Array[Whop_sdk::Types::ExternalAccountPost] }, optional: false, nullable: false
+
+          field :page_info, -> { Whop_sdk::ExternalAccounts::Posts::Types::ListPostsResponsePageInfo }, optional: false, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/whop_sdk/external_accounts/posts/types/list_posts_response_page_info.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module ExternalAccounts
+    module Posts
+      module Types
+        class ListPostsResponsePageInfo < Internal::Types::Model
+          field :end_cursor, -> { String }, optional: false, nullable: true
+
+          field :has_next_page, -> { Internal::Types::Boolean }, optional: false, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/whop_sdk/external_accounts/types/connect_external_accounts_request.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module ExternalAccounts
+    module Types
+      class ConnectExternalAccountsRequest < Internal::Types::Model
+        field :account_id, -> { String }, optional: true, nullable: false
+
+        field :platform, -> { Whop_sdk::ExternalAccounts::Types::ConnectExternalAccountsRequestPlatform }, optional: false, nullable: false
+
+        field :redirect_url, -> { String }, optional: false, nullable: false
+
+        field :scopes, -> { Internal::Types::Array[Whop_sdk::ExternalAccounts::Types::ConnectExternalAccountsRequestScopesItem] }, optional: true, nullable: false
+      end
+    end
+  end
+end

data/lib/whop_sdk/external_accounts/types/connect_external_accounts_request_platform.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module ExternalAccounts
+    module Types
+      module ConnectExternalAccountsRequestPlatform
+        extend Whop_sdk::Internal::Types::Enum
+
+        META_BUSINESS = "meta_business"
+        TIKTOK = "tiktok"
+        LINKEDIN = "linkedin"
+        YOUTUBE = "youtube"
+        SNAPCHAT = "snapchat"
+      end
+    end
+  end
+end

data/lib/whop_sdk/external_accounts/types/connect_external_accounts_request_scopes_item.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module ExternalAccounts
+    module Types
+      module ConnectExternalAccountsRequestScopesItem
+        extend Whop_sdk::Internal::Types::Enum
+
+        ADVERTISE = "advertise"
+      end
+    end
+  end
+end

data/lib/whop_sdk/external_accounts/types/connect_external_accounts_response.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module ExternalAccounts
+    module Types
+      class ConnectExternalAccountsResponse < Internal::Types::Model
+        field :authorize_url, -> { String }, optional: false, nullable: false
+      end
+    end
+  end
+end

data/lib/whop_sdk/external_accounts/types/create_external_accounts_request.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module ExternalAccounts
+    module Types
+      class CreateExternalAccountsRequest < Internal::Types::Model
+        field :account_id, -> { String }, optional: true, nullable: false
+
+        field :platform, -> { Whop_sdk::ExternalAccounts::Types::CreateExternalAccountsRequestPlatform }, optional: false, nullable: false
+      end
+    end
+  end
+end

data/lib/whop_sdk/external_accounts/types/create_external_accounts_request_platform.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module ExternalAccounts
+    module Types
+      module CreateExternalAccountsRequestPlatform
+        extend Whop_sdk::Internal::Types::Enum
+
+        FACEBOOK = "facebook"
+        TIKTOK = "tiktok"
+      end
+    end
+  end
+end

data/lib/whop_sdk/external_accounts/types/delete_external_accounts_request.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module ExternalAccounts
+    module Types
+      class DeleteExternalAccountsRequest < Internal::Types::Model
+        field :id, -> { String }, optional: false, nullable: false
+
+        field :account_id, -> { String }, optional: true, nullable: false
+
+        field :user_id, -> { String }, optional: true, nullable: false
+      end
+    end
+  end
+end

data/lib/whop_sdk/external_accounts/types/delete_external_accounts_response.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module ExternalAccounts
+    module Types
+      class DeleteExternalAccountsResponse < Internal::Types::Model
+        field :deleted, -> { Internal::Types::Boolean }, optional: false, nullable: false
+
+        field :id, -> { String }, optional: false, nullable: false
+      end
+    end
+  end
+end

data/lib/whop_sdk/external_accounts/types/list_external_accounts_request.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module ExternalAccounts
+    module Types
+      class ListExternalAccountsRequest < Internal::Types::Model
+        field :account_id, -> { String }, optional: true, nullable: false
+
+        field :user_id, -> { String }, optional: true, nullable: false
+
+        field :platform, -> { Whop_sdk::ExternalAccounts::Types::ListExternalAccountsRequestPlatform }, optional: true, nullable: false
+
+        field :trust_level, -> { Whop_sdk::ExternalAccounts::Types::ListExternalAccountsRequestTrustLevel }, optional: true, nullable: false
+
+        field :verified, -> { Internal::Types::Boolean }, optional: true, nullable: false
+
+        field :scopes, -> { Whop_sdk::ExternalAccounts::Types::ListExternalAccountsRequestScopesItem }, optional: true, nullable: false
+
+        field :first, -> { Integer }, optional: true, nullable: false
+
+        field :after, -> { String }, optional: true, nullable: false
+
+        field :last, -> { Integer }, optional: true, nullable: false
+
+        field :before, -> { String }, optional: true, nullable: false
+
+        field :order, -> { Whop_sdk::ExternalAccounts::Types::ListExternalAccountsRequestOrder }, optional: true, nullable: false
+
+        field :direction, -> { Whop_sdk::ExternalAccounts::Types::ListExternalAccountsRequestDirection }, optional: true, nullable: false
+      end
+    end
+  end
+end