whop_sdk 1.1.1 → 2.0.0

data/lib/whop_sdk/setup_intents/direct/client.rb

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module SetupIntents
+    module Direct
+      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
+
+        # Saves a card for later charges from card details the caller holds itself, for integrators whose own systems
+        # are PCI compliant. Card details are accepted only on the vault host, where the card is tokenized before it
+        # reaches Whop; the official SDKs route this operation there, and raw card details sent to the regular host are
+        # refused. (Whop's own clients, which tokenize with the Basis Theory SDK, send the resulting token intent id to
+        # the regular host.) The setup runs in the background: poll Retrieve setup status for its outcome and for
+        # anything the buyer must still do, such as 3D Secure. Once it succeeds, the saved payment method arrives on the
+        # `setup_intent.succeeded` webhook and in List payment methods for the member.
+        #
+        # @param request_options [Hash]
+        # @param params [Whop_sdk::SetupIntents::Direct::Types::CreateDirectRequest]
+        # @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
+        #
+        # @example
+        #   client.setup_intents.direct.create(
+        #     account_id: "biz_xxxxxxxxxxxxxx",
+        #     billing_details: {
+        #       address: {
+        #         country: "US",
+        #         postal_code: "94105"
+        #       },
+        #       email: "dana@shinetime.example",
+        #       name: "Dana Shine"
+        #     },
+        #     payment_method: {
+        #       type: "card"
+        #     }
+        #   )
+        #
+        # @return [Whop_sdk::Types::SetupIntent]
+        def create(request_options: {}, **params)
+          params = Whop_sdk::Internal::Types::Utils.normalize_keys(params)
+          request = Whop_sdk::Internal::JSON::Request.new(
+            base_url: request_options[:base_url] || @base_url || @environment&.dig(:vault),
+            method: "POST",
+            path: "setup_intents/direct",
+            body: Whop_sdk::SetupIntents::Direct::Types::CreateDirectRequest.new(params).to_h,
+            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)
+            Whop_sdk::Types::SetupIntent.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/setup_intents/direct/types/create_direct_request.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module SetupIntents
+    module Direct
+      module Types
+        class CreateDirectRequest < Internal::Types::Model
+          field :account_id, -> { String }, optional: false, nullable: false
+
+          field :billing_details, -> { Whop_sdk::SetupIntents::Direct::Types::CreateDirectRequestBillingDetails }, optional: false, nullable: false
+
+          field :currency, -> { String }, optional: true, nullable: false
+
+          field :member_id, -> { String }, optional: true, nullable: false
+
+          field :metadata, -> { Internal::Types::Hash[String, String] }, optional: true, nullable: false
+
+          field :payment_method, -> { Whop_sdk::SetupIntents::Direct::Types::CreateDirectRequestPaymentMethod }, optional: false, nullable: false
+
+          field :return_url, -> { String }, optional: true, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/whop_sdk/setup_intents/direct/types/create_direct_request_billing_details.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module SetupIntents
+    module Direct
+      module Types
+        # The buyer's billing details.
+        class CreateDirectRequestBillingDetails < Internal::Types::Model
+          field :address, -> { Whop_sdk::SetupIntents::Direct::Types::CreateDirectRequestBillingDetailsAddress }, optional: false, nullable: false
+
+          field :email, -> { String }, optional: false, nullable: false
+
+          field :name, -> { String }, optional: false, nullable: false
+
+          field :phone, -> { String }, optional: true, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/whop_sdk/setup_intents/direct/types/create_direct_request_billing_details_address.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module SetupIntents
+    module Direct
+      module Types
+        # The billing address.
+        class CreateDirectRequestBillingDetailsAddress < Internal::Types::Model
+          field :city, -> { String }, optional: true, nullable: false
+
+          field :country, -> { String }, optional: false, nullable: false
+
+          field :line1, -> { String }, optional: true, nullable: false
+
+          field :line2, -> { String }, optional: true, nullable: false
+
+          field :postal_code, -> { String }, optional: false, nullable: false
+
+          field :state, -> { String }, optional: true, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/whop_sdk/setup_intents/direct/types/create_direct_request_payment_method.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module SetupIntents
+    module Direct
+      module Types
+        # The payment method to save, as the raw details the caller holds. Raw details are accepted only on the vault
+        # host, where Whop's vault tokenizes them in transit; the official SDKs route this operation there. Whop's own
+        # clients, which tokenize with the Basis Theory SDK, send the resulting token intent id to the regular host.
+        class CreateDirectRequestPaymentMethod < Internal::Types::Model
+          field :card, -> { Whop_sdk::SetupIntents::Direct::Types::CreateDirectRequestPaymentMethodCard }, optional: true, nullable: false
+
+          field :type, -> { Whop_sdk::SetupIntents::Direct::Types::CreateDirectRequestPaymentMethodType }, optional: false, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/whop_sdk/setup_intents/direct/types/create_direct_request_payment_method_card.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module SetupIntents
+    module Direct
+      module Types
+        # The card to save. Present when `type` is `card`.
+        class CreateDirectRequestPaymentMethodCard < Internal::Types::Model
+          field :details, -> { Whop_sdk::SetupIntents::Direct::Types::CreateDirectRequestPaymentMethodCardDetails }, optional: false, nullable: false
+
+          field :network_transaction_id, -> { String }, optional: true, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/whop_sdk/setup_intents/direct/types/create_direct_request_payment_method_card_details.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module SetupIntents
+    module Direct
+      module Types
+        # The card's raw fields. Sent to the vault host and tokenized before it reaches Whop; Whop's servers never
+        # receive the number.
+        class CreateDirectRequestPaymentMethodCardDetails < Internal::Types::Model
+          field :cvc, -> { String }, optional: true, nullable: false
+
+          field :exp_month, -> { Integer }, optional: false, nullable: false
+
+          field :exp_year, -> { Integer }, optional: false, nullable: false
+
+          field :number, -> { String }, optional: false, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/whop_sdk/setup_intents/direct/types/create_direct_request_payment_method_type.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module SetupIntents
+    module Direct
+      module Types
+        module CreateDirectRequestPaymentMethodType
+          extend Whop_sdk::Internal::Types::Enum
+
+          CARD = "card"
+        end
+      end
+    end
+  end
+end

data/lib/whop_sdk/setup_intents/types/create_setup_intents_request.rb

@@ -3,13 +3,20 @@
 module Whop_sdk
   module SetupIntents
     module Types
-      # Parameters for CreateSetupIntent
       class CreateSetupIntentsRequest < Internal::Types::Model
-        extend Whop_sdk::Internal::Types::Union
+        field :account_id, -> { String }, optional: false, nullable: false
 
-        member -> { Whop_sdk::SetupIntents::Types::CreateSetupIntentsRequestConfirmationToken }
+        field :confirmation_token, -> { String }, optional: true, nullable: false
 
-        member -> { Whop_sdk::SetupIntents::Types::CreateSetupIntentsRequestPaymentMethodID }
+        field :currency, -> { String }, optional: true, nullable: false
+
+        field :email, -> { String }, optional: true, nullable: false
+
+        field :metadata, -> { Internal::Types::Hash[String, String] }, optional: true, nullable: false
+
+        field :payment_method_id, -> { String }, optional: true, nullable: false
+
+        field :return_url, -> { String }, optional: true, nullable: false
       end
     end
   end

data/lib/whop_sdk/setup_intents/types/list_setup_intents_request.rb

@@ -4,21 +4,25 @@ module Whop_sdk
   module SetupIntents
     module Types
       class ListSetupIntentsRequest < Internal::Types::Model
-        field :after, -> { String }, optional: true, nullable: false
+        field :account_id, -> { String }, optional: true, nullable: false
 
-        field :before, -> { String }, optional: true, nullable: false
+        field :status, -> { Whop_sdk::SetupIntents::Types::ListSetupIntentsRequestStatus }, optional: true, nullable: false
 
-        field :first, -> { Integer }, optional: true, nullable: false
+        field :created_before, -> { String }, optional: true, nullable: false
 
-        field :last, -> { Integer }, optional: true, nullable: false
+        field :created_after, -> { String }, optional: true, nullable: false
 
-        field :direction, -> { Whop_sdk::Types::Direction }, optional: true, nullable: false
+        field :order, -> { Whop_sdk::SetupIntents::Types::ListSetupIntentsRequestOrder }, optional: true, nullable: false
 
-        field :created_before, -> { String }, optional: true, nullable: false
+        field :direction, -> { Whop_sdk::SetupIntents::Types::ListSetupIntentsRequestDirection }, optional: true, nullable: false
 
-        field :created_after, -> { String }, optional: true, nullable: false
+        field :first, -> { Integer }, optional: true, nullable: false
+
+        field :after, -> { String }, optional: true, nullable: false
 
-        field :account_id, -> { String }, optional: false, nullable: false
+        field :last, -> { Integer }, optional: true, nullable: false
+
+        field :before, -> { String }, optional: true, nullable: false
       end
     end
   end

data/lib/whop_sdk/setup_intents/types/list_setup_intents_request_direction.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module SetupIntents
+    module Types
+      module ListSetupIntentsRequestDirection
+        extend Whop_sdk::Internal::Types::Enum
+
+        ASC = "asc"
+        DESC = "desc"
+      end
+    end
+  end
+end

data/lib/whop_sdk/setup_intents/types/list_setup_intents_request_order.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module SetupIntents
+    module Types
+      module ListSetupIntentsRequestOrder
+        extend Whop_sdk::Internal::Types::Enum
+
+        CREATED_AT = "created_at"
+      end
+    end
+  end
+end

data/lib/whop_sdk/setup_intents/types/list_setup_intents_request_status.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module SetupIntents
+    module Types
+      module ListSetupIntentsRequestStatus
+        extend Whop_sdk::Internal::Types::Enum
+
+        PROCESSING = "processing"
+        SUCCEEDED = "succeeded"
+        CANCELED = "canceled"
+        REQUIRES_ACTION = "requires_action"
+      end
+    end
+  end
+end

data/lib/whop_sdk/setup_intents/types/list_setup_intents_response.rb

@@ -3,11 +3,10 @@
 module Whop_sdk
   module SetupIntents
     module Types
-      # The connection type for SetupIntent.
       class ListSetupIntentsResponse < Internal::Types::Model
-        field :data, -> { Internal::Types::Array[Whop_sdk::Types::SetupIntentListItem] }, optional: false, nullable: false
+        field :data, -> { Internal::Types::Array[Whop_sdk::Types::SetupIntent] }, optional: false, nullable: false
 
-        field :page_info, -> { Whop_sdk::Types::PageInfo }, optional: false, nullable: false
+        field :page_info, -> { Whop_sdk::SetupIntents::Types::ListSetupIntentsResponsePageInfo }, optional: false, nullable: false
       end
     end
   end

data/lib/whop_sdk/setup_intents/types/list_setup_intents_response_page_info.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Whop_sdk
+  module SetupIntents
+    module Types
+      class ListSetupIntentsResponsePageInfo < 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

data/lib/whop_sdk/shipments/client.rb

@@ -4,10 +4,14 @@ module Whop_sdk
   module Shipments
     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:)
+      def initialize(client:, base_url: nil, environment: nil)
         @client = client
+        @base_url = base_url
+        @environment = environment
       end
 
       # Returns a paginated list of shipments for an account.
@@ -57,7 +61,7 @@ module Whop_sdk
         ) do |next_cursor|
           query_params["after"] = next_cursor
           request = Whop_sdk::Internal::JSON::Request.new(
-            base_url: request_options[:base_url],
+            base_url: request_options[:base_url] || @base_url || @environment&.dig(:api),
             method: "GET",
             path: "shipments",
             query: query_params,
@@ -99,7 +103,7 @@ module Whop_sdk
       def create(request_options: {}, **params)
         params = Whop_sdk::Internal::Types::Utils.normalize_keys(params)
         request = Whop_sdk::Internal::JSON::Request.new(
-          base_url: request_options[:base_url],
+          base_url: request_options[:base_url] || @base_url || @environment&.dig(:api),
           method: "POST",
           path: "shipments",
           body: Whop_sdk::Shipments::Types::CreateShipmentsRequest.new(params).to_h,
@@ -137,7 +141,7 @@ module Whop_sdk
       def retrieve(request_options: {}, **params)
         params = Whop_sdk::Internal::Types::Utils.normalize_keys(params)
         request = Whop_sdk::Internal::JSON::Request.new(
-          base_url: request_options[:base_url],
+          base_url: request_options[:base_url] || @base_url || @environment&.dig(:api),
           method: "GET",
           path: "shipments/#{URI.encode_uri_component(params[:id].to_s)}",
           request_options: request_options
@@ -181,7 +185,7 @@ module Whop_sdk
         body = request_data.except(*non_body_param_names)
 
         request = Whop_sdk::Internal::JSON::Request.new(
-          base_url: request_options[:base_url],
+          base_url: request_options[:base_url] || @base_url || @environment&.dig(:api),
           method: "PATCH",
           path: "shipments/#{URI.encode_uri_component(params[:id].to_s)}",
           body: body,

data/lib/whop_sdk/social_accounts/client.rb

@@ -4,10 +4,14 @@ module Whop_sdk
   module SocialAccounts
     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:)
+      def initialize(client:, base_url: nil, environment: nil)
         @client = client
+        @base_url = base_url
+        @environment = environment
       end
 
       # Lists the social accounts linked to an account or user.
@@ -57,7 +61,7 @@ module Whop_sdk
         ) do |next_cursor|
           query_params["after"] = next_cursor
           request = Whop_sdk::Internal::JSON::Request.new(
-            base_url: request_options[:base_url],
+            base_url: request_options[:base_url] || @base_url || @environment&.dig(:api),
             method: "GET",
             path: "social_accounts",
             query: query_params,
@@ -79,7 +83,7 @@ module Whop_sdk
         end
       end
 
-      # Creates or returns a Whop-managed Facebook page for an account.
+      # Creates or returns a Whop-managed Facebook page or TikTok account for an account.
       #
       # @param request_options [Hash]
       # @param params [Whop_sdk::SocialAccounts::Types::CreateSocialAccountsRequest]
@@ -96,7 +100,7 @@ module Whop_sdk
       def create(request_options: {}, **params)
         params = Whop_sdk::Internal::Types::Utils.normalize_keys(params)
         request = Whop_sdk::Internal::JSON::Request.new(
-          base_url: request_options[:base_url],
+          base_url: request_options[:base_url] || @base_url || @environment&.dig(:api),
           method: "POST",
           path: "social_accounts",
           body: Whop_sdk::SocialAccounts::Types::CreateSocialAccountsRequest.new(params).to_h,
@@ -117,6 +121,8 @@ module Whop_sdk
       end
 
       # Starts an OAuth connection flow and returns an authorize_url where the user can connect a social account.
+      # LinkedIn connects the authenticated user’s profile and must be completed in a browser signed in as that same
+      # Whop user.
       #
       # @param request_options [Hash]
       # @param params [Whop_sdk::SocialAccounts::Types::ConnectSocialAccountsRequest]
@@ -136,7 +142,7 @@ module Whop_sdk
       def connect(request_options: {}, **params)
         params = Whop_sdk::Internal::Types::Utils.normalize_keys(params)
         request = Whop_sdk::Internal::JSON::Request.new(
-          base_url: request_options[:base_url],
+          base_url: request_options[:base_url] || @base_url || @environment&.dig(:api),
           method: "POST",
           path: "social_accounts/connect",
           body: Whop_sdk::SocialAccounts::Types::ConnectSocialAccountsRequest.new(params).to_h,
@@ -180,7 +186,7 @@ module Whop_sdk
         query_params["user_id"] = params[:user_id] if params.key?(:user_id)
 
         request = Whop_sdk::Internal::JSON::Request.new(
-          base_url: request_options[:base_url],
+          base_url: request_options[:base_url] || @base_url || @environment&.dig(:api),
           method: "DELETE",
           path: "social_accounts/#{URI.encode_uri_component(params[:id].to_s)}",
           query: query_params,
@@ -227,7 +233,7 @@ module Whop_sdk
         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: request_options[:base_url] || @base_url || @environment&.dig(:api),
           method: "GET",
           path: "social_accounts/#{URI.encode_uri_component(params[:id].to_s)}/lead_forms",
           query: query_params,
@@ -284,7 +290,7 @@ module Whop_sdk
         ) do |next_cursor|
           query_params["after"] = next_cursor
           request = Whop_sdk::Internal::JSON::Request.new(
-            base_url: request_options[:base_url],
+            base_url: request_options[:base_url] || @base_url || @environment&.dig(:api),
             method: "GET",
             path: "social_accounts/#{URI.encode_uri_component(params[:id].to_s)}/posts",
             query: query_params,
@@ -305,6 +311,48 @@ module Whop_sdk
           end
         end
       end
+
+      # Refreshes the state of a social account. Use it to clear an `error` that has been resolved.
+      #
+      # @param request_options [Hash]
+      # @param params [Whop_sdk::SocialAccounts::Types::RefreshSocialAccountsRequest]
+      # @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
+      #
+      # @example
+      #   client.social_accounts.refresh(id: "id")
+      #
+      # @return [Whop_sdk::Types::SocialAccount]
+      def refresh(request_options: {}, **params)
+        params = Whop_sdk::Internal::Types::Utils.normalize_keys(params)
+        request_data = Whop_sdk::SocialAccounts::Types::RefreshSocialAccountsRequest.new(params).to_h
+        non_body_param_names = %w[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: "social_accounts/#{URI.encode_uri_component(params[:id].to_s)}/refresh",
+          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)
+          Whop_sdk::Types::SocialAccount.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

data/lib/whop_sdk/social_accounts/types/connect_social_accounts_request_platform.rb

@@ -8,6 +8,8 @@ module Whop_sdk
 
         META_BUSINESS = "meta_business"
         TIKTOK = "tiktok"
+        LINKEDIN = "linkedin"
+        SNAPCHAT = "snapchat"
       end
     end
   end

data/lib/whop_sdk/social_accounts/types/create_social_accounts_request_platform.rb

@@ -7,6 +7,7 @@ module Whop_sdk
         extend Whop_sdk::Internal::Types::Enum
 
         FACEBOOK = "facebook"
+        TIKTOK = "tiktok"
       end
     end
   end

data/lib/whop_sdk/social_accounts/types/list_social_accounts_request_platform.rb

@@ -13,6 +13,8 @@ module Whop_sdk
         FACEBOOK = "facebook"
         DISCORD = "discord"
         TELEGRAM = "telegram"
+        LINKEDIN = "linkedin"
+        SNAPCHAT = "snapchat"
       end
     end
   end

data/lib/whop_sdk/{recommended_actions/types/run_recommended_actions_request.rb → social_accounts/types/refresh_social_accounts_request.rb}

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
 module Whop_sdk
-  module RecommendedActions
+  module SocialAccounts
     module Types
-      class RunRecommendedActionsRequest < Internal::Types::Model
+      class RefreshSocialAccountsRequest < Internal::Types::Model
         field :id, -> { String }, optional: false, nullable: false
 
         field :account_id, -> { String }, optional: true, nullable: false