privy_ruby 0.0.2 → 0.2.0

data/lib/privy/models/oauth_grant.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+module Privy
+  module Models
+    class OAuthGrant < Privy::Internal::Type::BaseModel
+      # @!attribute id
+      #   The grant identifier.
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute created_at
+      #   When the grant was first created.
+      #
+      #   @return [Time]
+      required :created_at, Time
+
+      # @!attribute grant_type
+      #   The OAuth grant type that created this grant.
+      #
+      #   @return [Symbol, Privy::Models::OAuthGrant::GrantType]
+      required :grant_type, enum: -> { Privy::OAuthGrant::GrantType }
+
+      # @!attribute last_used_at
+      #   When the grant was last used (e.g. token refreshed).
+      #
+      #   @return [Time]
+      required :last_used_at, Time
+
+      # @!method initialize(id:, created_at:, grant_type:, last_used_at:)
+      #   An active OAuth grant representing an authorized session.
+      #
+      #   @param id [String] The grant identifier.
+      #
+      #   @param created_at [Time] When the grant was first created.
+      #
+      #   @param grant_type [Symbol, Privy::Models::OAuthGrant::GrantType] The OAuth grant type that created this grant.
+      #
+      #   @param last_used_at [Time] When the grant was last used (e.g. token refreshed).
+
+      # The OAuth grant type that created this grant.
+      #
+      # @see Privy::Models::OAuthGrant#grant_type
+      module GrantType
+        extend Privy::Internal::Type::Enum
+
+        DEVICE_CODE = :device_code
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/privy/models/oauth_grant_list_response.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Privy
+  module Models
+    class OAuthGrantListResponse < Privy::Internal::Type::BaseModel
+      # @!attribute data
+      #   Active grants.
+      #
+      #   @return [Array<Privy::Models::OAuthGrant>]
+      required :data, -> { Privy::Internal::Type::ArrayOf[Privy::OAuthGrant] }
+
+      # @!method initialize(data:)
+      #   List of active OAuth grants for the authenticated user.
+      #
+      #   @param data [Array<Privy::Models::OAuthGrant>] Active grants.
+    end
+  end
+end

data/lib/privy/models/oauth_grant_revoke_response.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module Privy
+  module Models
+    class OAuthGrantRevokeResponse < Privy::Internal::Type::BaseModel
+      # @!attribute success
+      #   Whether the revocation was processed.
+      #
+      #   @return [Boolean, Privy::Models::OAuthGrantRevokeResponse::Success]
+      required :success, enum: -> { Privy::OAuthGrantRevokeResponse::Success }
+
+      # @!method initialize(success:)
+      #   Response from revoking an OAuth grant.
+      #
+      #   @param success [Boolean, Privy::Models::OAuthGrantRevokeResponse::Success] Whether the revocation was processed.
+
+      # Whether the revocation was processed.
+      #
+      # @see Privy::Models::OAuthGrantRevokeResponse#success
+      module Success
+        extend Privy::Internal::Type::Enum
+
+        TRUE = true
+
+        # @!method self.values
+        #   @return [Array<Boolean>]
+      end
+    end
+  end
+end

data/lib/privy/models/oauth_token_authorization_code_request_body.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+module Privy
+  module Models
+    class OAuthTokenAuthorizationCodeRequestBody < Privy::Internal::Type::BaseModel
+      # @!attribute code
+      #   The authorization code received from the authorization endpoint.
+      #
+      #   @return [String]
+      required :code, String
+
+      # @!attribute grant_type
+      #
+      #   @return [Symbol, Privy::Models::OAuthTokenAuthorizationCodeRequestBody::GrantType]
+      required :grant_type, enum: -> { Privy::OAuthTokenAuthorizationCodeRequestBody::GrantType }
+
+      # @!attribute client_id
+      #   The client ID. Alternative to Basic auth header.
+      #
+      #   @return [String, nil]
+      optional :client_id, String
+
+      # @!attribute client_secret
+      #   The client secret. Alternative to Basic auth header.
+      #
+      #   @return [String, nil]
+      optional :client_secret, String
+
+      # @!attribute redirect_uri
+      #   The redirect URI used in the authorization request.
+      #
+      #   @return [String, nil]
+      optional :redirect_uri, String
+
+      # @!method initialize(code:, grant_type:, client_id: nil, client_secret: nil, redirect_uri: nil)
+      #   Request body for the authorization_code grant type.
+      #
+      #   @param code [String] The authorization code received from the authorization endpoint.
+      #
+      #   @param grant_type [Symbol, Privy::Models::OAuthTokenAuthorizationCodeRequestBody::GrantType]
+      #
+      #   @param client_id [String] The client ID. Alternative to Basic auth header.
+      #
+      #   @param client_secret [String] The client secret. Alternative to Basic auth header.
+      #
+      #   @param redirect_uri [String] The redirect URI used in the authorization request.
+
+      # @see Privy::Models::OAuthTokenAuthorizationCodeRequestBody#grant_type
+      module GrantType
+        extend Privy::Internal::Type::Enum
+
+        AUTHORIZATION_CODE = :authorization_code
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/privy/models/oauth_token_device_code_pending_error.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module Privy
+  module Models
+    class OAuthTokenDeviceCodePendingError < Privy::Internal::Type::BaseModel
+      # @!attribute error
+      #   The error code indicating why the token request failed.
+      #
+      #   @return [Symbol, Privy::Models::OAuthTokenDeviceCodePendingError::Error]
+      required :error, enum: -> { Privy::OAuthTokenDeviceCodePendingError::Error }
+
+      # @!attribute error_description
+      #   Human-readable description of the error.
+      #
+      #   @return [String, nil]
+      optional :error_description, String
+
+      # @!attribute interval
+      #   The minimum polling interval in seconds.
+      #
+      #   @return [Float, nil]
+      optional :interval, Float
+
+      # @!method initialize(error:, error_description: nil, interval: nil)
+      #   Error response returned while the device authorization is still pending (RFC
+      #   8628 Section 3.5).
+      #
+      #   @param error [Symbol, Privy::Models::OAuthTokenDeviceCodePendingError::Error] The error code indicating why the token request failed.
+      #
+      #   @param error_description [String] Human-readable description of the error.
+      #
+      #   @param interval [Float] The minimum polling interval in seconds.
+
+      # The error code indicating why the token request failed.
+      #
+      # @see Privy::Models::OAuthTokenDeviceCodePendingError#error
+      module Error
+        extend Privy::Internal::Type::Enum
+
+        AUTHORIZATION_PENDING = :authorization_pending
+        SLOW_DOWN = :slow_down
+        ACCESS_DENIED = :access_denied
+        EXPIRED_TOKEN = :expired_token
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/privy/models/oauth_token_device_code_request_body.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module Privy
+  module Models
+    class OAuthTokenDeviceCodeRequestBody < Privy::Internal::Type::BaseModel
+      # @!attribute device_code
+      #   The device code received from the device authorization endpoint.
+      #
+      #   @return [String]
+      required :device_code, String
+
+      # @!attribute grant_type
+      #
+      #   @return [Symbol, Privy::Models::OAuthTokenDeviceCodeRequestBody::GrantType]
+      required :grant_type, enum: -> { Privy::OAuthTokenDeviceCodeRequestBody::GrantType }
+
+      # @!method initialize(device_code:, grant_type:)
+      #   Request body for the urn:ietf:params:oauth:grant-type:device_code grant type
+      #   (RFC 8628). Used by CLI clients to poll for authorization.
+      #
+      #   @param device_code [String] The device code received from the device authorization endpoint.
+      #
+      #   @param grant_type [Symbol, Privy::Models::OAuthTokenDeviceCodeRequestBody::GrantType]
+
+      # @see Privy::Models::OAuthTokenDeviceCodeRequestBody#grant_type
+      module GrantType
+        extend Privy::Internal::Type::Enum
+
+        URN_IETF_PARAMS_OAUTH_GRANT_TYPE_DEVICE_CODE = :"urn:ietf:params:oauth:grant-type:device_code"
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/privy/models/oauth_token_grant_type.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Privy
+  module Models
+    # The OAuth grant type for the token request.
+    module OAuthTokenGrantType
+      extend Privy::Internal::Type::Enum
+
+      AUTHORIZATION_CODE = :authorization_code
+      URN_IETF_PARAMS_OAUTH_GRANT_TYPE_DEVICE_CODE = :"urn:ietf:params:oauth:grant-type:device_code"
+      REFRESH_TOKEN = :refresh_token
+
+      # @!method self.values
+      #   @return [Array<Symbol>]
+    end
+  end
+end

data/lib/privy/models/oauth_token_refresh_token_request_body.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module Privy
+  module Models
+    class OAuthTokenRefreshTokenRequestBody < Privy::Internal::Type::BaseModel
+      # @!attribute grant_type
+      #
+      #   @return [Symbol, Privy::Models::OAuthTokenRefreshTokenRequestBody::GrantType]
+      required :grant_type, enum: -> { Privy::OAuthTokenRefreshTokenRequestBody::GrantType }
+
+      # @!attribute refresh_token
+      #   The refresh token to exchange for a new access token.
+      #
+      #   @return [String]
+      required :refresh_token, String
+
+      # @!method initialize(grant_type:, refresh_token:)
+      #   Request body for the refresh_token grant type. Rotates the refresh token and
+      #   issues a new access token.
+      #
+      #   @param grant_type [Symbol, Privy::Models::OAuthTokenRefreshTokenRequestBody::GrantType]
+      #
+      #   @param refresh_token [String] The refresh token to exchange for a new access token.
+
+      # @see Privy::Models::OAuthTokenRefreshTokenRequestBody#grant_type
+      module GrantType
+        extend Privy::Internal::Type::Enum
+
+        REFRESH_TOKEN = :refresh_token
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/privy/models/oauth_token_request_body.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Privy
+  module Models
+    # Request body for the OAuth token endpoint, discriminated by grant_type.
+    module OAuthTokenRequestBody
+      extend Privy::Internal::Type::Union
+
+      discriminator :grant_type
+
+      # Request body for the authorization_code grant type.
+      variant :authorization_code, -> { Privy::OAuthTokenAuthorizationCodeRequestBody }
+
+      # Request body for the urn:ietf:params:oauth:grant-type:device_code grant type (RFC 8628). Used by CLI clients to poll for authorization.
+      variant :"urn:ietf:params:oauth:grant-type:device_code", -> { Privy::OAuthTokenDeviceCodeRequestBody }
+
+      # Request body for the refresh_token grant type. Rotates the refresh token and issues a new access token.
+      variant :refresh_token, -> { Privy::OAuthTokenRefreshTokenRequestBody }
+
+      # @!method self.variants
+      #   @return [Array(Privy::Models::OAuthTokenAuthorizationCodeRequestBody, Privy::Models::OAuthTokenDeviceCodeRequestBody, Privy::Models::OAuthTokenRefreshTokenRequestBody)]
+    end
+  end
+end

data/lib/privy/models/oauth_token_success_response.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+module Privy
+  module Models
+    class OAuthTokenSuccessResponse < Privy::Internal::Type::BaseModel
+      # @!attribute access_token
+      #   The issued access token.
+      #
+      #   @return [String]
+      required :access_token, String
+
+      # @!attribute token_type
+      #   The type of token issued.
+      #
+      #   @return [Symbol, Privy::Models::OAuthTokenSuccessResponse::TokenType]
+      required :token_type, enum: -> { Privy::OAuthTokenSuccessResponse::TokenType }
+
+      # @!attribute expires_in
+      #   The lifetime in seconds of the access token.
+      #
+      #   @return [Float, nil]
+      optional :expires_in, Float
+
+      # @!attribute refresh_token
+      #   A refresh token for obtaining new access tokens. Issued for device_code and
+      #   refresh_token grants.
+      #
+      #   @return [String, nil]
+      optional :refresh_token, String
+
+      # @!method initialize(access_token:, token_type:, expires_in: nil, refresh_token: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Privy::Models::OAuthTokenSuccessResponse} for more details.
+      #
+      #   Successful token response per RFC 6749 Section 5.1.
+      #
+      #   @param access_token [String] The issued access token.
+      #
+      #   @param token_type [Symbol, Privy::Models::OAuthTokenSuccessResponse::TokenType] The type of token issued.
+      #
+      #   @param expires_in [Float] The lifetime in seconds of the access token.
+      #
+      #   @param refresh_token [String] A refresh token for obtaining new access tokens. Issued for device_code and refr
+
+      # The type of token issued.
+      #
+      # @see Privy::Models::OAuthTokenSuccessResponse#token_type
+      module TokenType
+        extend Privy::Internal::Type::Enum
+
+        BEARER = :Bearer
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/privy/models/onramp_session_fees.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Privy
+  module Models
+    class OnrampSessionFees < Privy::Internal::Type::BaseModel
+      # @!attribute network_fee_amount
+      #
+      #   @return [String, nil]
+      required :network_fee_amount, String, nil?: true
+
+      # @!attribute transaction_fee_amount
+      #
+      #   @return [String, nil]
+      required :transaction_fee_amount, String, nil?: true
+
+      # @!method initialize(network_fee_amount:, transaction_fee_amount:)
+      #   Fee breakdown for a Stripe onramp transaction.
+      #
+      #   @param network_fee_amount [String, nil]
+      #   @param transaction_fee_amount [String, nil]
+    end
+  end
+end

data/lib/privy/models/onramp_session_params.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+module Privy
+  module Models
+    class OnrampSessionParams < Privy::Internal::Type::BaseModel
+      # @!attribute crypto_customer_id
+      #
+      #   @return [String]
+      required :crypto_customer_id, String
+
+      # @!attribute destination_currency
+      #   Cryptocurrency symbol. Uppercase alphanumeric, 2-10 characters.
+      #
+      #   @return [String]
+      required :destination_currency, String
+
+      # @!attribute destination_network
+      #
+      #   @return [String]
+      required :destination_network, String
+
+      # @!attribute payment_token
+      #
+      #   @return [String]
+      required :payment_token, String
+
+      # @!attribute source_amount
+      #
+      #   @return [String]
+      required :source_amount, String
+
+      # @!attribute source_currency
+      #   ISO 4217 fiat currency code. Three uppercase ASCII letters.
+      #
+      #   @return [String]
+      required :source_currency, String
+
+      # @!attribute wallet_address
+      #
+      #   @return [String]
+      required :wallet_address, String
+
+      # @!method initialize(crypto_customer_id:, destination_currency:, destination_network:, payment_token:, source_amount:, source_currency:, wallet_address:)
+      #   Parameters for creating a Stripe onramp session.
+      #
+      #   @param crypto_customer_id [String]
+      #
+      #   @param destination_currency [String] Cryptocurrency symbol. Uppercase alphanumeric, 2-10 characters.
+      #
+      #   @param destination_network [String]
+      #
+      #   @param payment_token [String]
+      #
+      #   @param source_amount [String]
+      #
+      #   @param source_currency [String] ISO 4217 fiat currency code. Three uppercase ASCII letters.
+      #
+      #   @param wallet_address [String]
+    end
+  end
+end

data/lib/privy/models/onramp_session_transaction_details.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+module Privy
+  module Models
+    class OnrampSessionTransactionDetails < Privy::Internal::Type::BaseModel
+      # @!attribute destination_amount
+      #
+      #   @return [String, nil]
+      required :destination_amount, String, nil?: true
+
+      # @!attribute destination_currency
+      #
+      #   @return [String, nil]
+      required :destination_currency, String, nil?: true
+
+      # @!attribute destination_network
+      #
+      #   @return [String, nil]
+      required :destination_network, String, nil?: true
+
+      # @!attribute fees
+      #   Fee breakdown for a Stripe onramp transaction.
+      #
+      #   @return [Privy::Models::OnrampSessionTransactionDetails::Fees]
+      required :fees, -> { Privy::OnrampSessionTransactionDetails::Fees }
+
+      # @!attribute source_amount
+      #
+      #   @return [String, nil]
+      required :source_amount, String, nil?: true
+
+      # @!attribute source_currency
+      #
+      #   @return [String, nil]
+      required :source_currency, String, nil?: true
+
+      # @!method initialize(destination_amount:, destination_currency:, destination_network:, fees:, source_amount:, source_currency:)
+      #   Transaction details returned from a Stripe onramp session.
+      #
+      #   @param destination_amount [String, nil]
+      #
+      #   @param destination_currency [String, nil]
+      #
+      #   @param destination_network [String, nil]
+      #
+      #   @param fees [Privy::Models::OnrampSessionTransactionDetails::Fees] Fee breakdown for a Stripe onramp transaction.
+      #
+      #   @param source_amount [String, nil]
+      #
+      #   @param source_currency [String, nil]
+
+      # @see Privy::Models::OnrampSessionTransactionDetails#fees
+      class Fees < Privy::Models::OnrampSessionFees
+        # @!method initialize
+        #   Fee breakdown for a Stripe onramp transaction.
+      end
+    end
+  end
+end

data/lib/privy/models/refresh_stripe_quote_response.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Privy
+  module Models
+    class RefreshStripeQuoteResponse < Privy::Internal::Type::BaseModel
+      # @!attribute quote
+      #   A refreshed quote.
+      #
+      #   @return [Privy::Models::StripeQuote]
+      required :quote, -> { Privy::StripeQuote }
+
+      # @!method initialize(quote:)
+      #   Refreshed quote with new expiry.
+      #
+      #   @param quote [Privy::Models::StripeQuote] A refreshed quote.
+    end
+  end
+end

data/lib/privy/models/rule_delete_intent_response.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+module Privy
+  module Models
+    # @see Privy::Resources::Intents#delete_policy_rule
+    class RuleDeleteIntentResponse < Privy::Models::BaseIntentResponse
+      # @!attribute intent_type
+      #
+      #   @return [Symbol, Privy::Models::RuleDeleteIntentResponse::IntentType]
+      required :intent_type, enum: -> { Privy::RuleDeleteIntentResponse::IntentType }
+
+      # @!attribute request_details
+      #   Request details for deleting a rule via intent.
+      #
+      #   @return [Privy::Models::RuleIntentDeleteRequestDetails]
+      required :request_details, -> { Privy::RuleIntentDeleteRequestDetails }
+
+      # @!attribute action_result
+      #   Result of rule execution (only present if status is 'executed' or 'failed')
+      #
+      #   @return [Privy::Models::BaseActionResult, nil]
+      optional :action_result, -> { Privy::BaseActionResult }
+
+      # @!attribute current_resource_data
+      #   A rule that defines the conditions and action to take if the conditions are
+      #   true.
+      #
+      #   @return [Privy::Models::PolicyRuleResponse, nil]
+      optional :current_resource_data, -> { Privy::PolicyRuleResponse }
+
+      # @!attribute policy
+      #   A policy for controlling wallet operations.
+      #
+      #   @return [Privy::Models::Policy, nil]
+      optional :policy, -> { Privy::Policy }
+
+      # @!method initialize(intent_type:, request_details:, action_result: nil, current_resource_data: nil, policy: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Privy::Models::RuleDeleteIntentResponse} for more details.
+      #
+      #   Response for a delete rule intent
+      #
+      #   @param intent_type [Symbol, Privy::Models::RuleDeleteIntentResponse::IntentType]
+      #
+      #   @param request_details [Privy::Models::RuleIntentDeleteRequestDetails] Request details for deleting a rule via intent.
+      #
+      #   @param action_result [Privy::Models::BaseActionResult] Result of rule execution (only present if status is 'executed' or 'failed')
+      #
+      #   @param current_resource_data [Privy::Models::PolicyRuleResponse] A rule that defines the conditions and action to take if the conditions are true
+      #
+      #   @param policy [Privy::Models::Policy] A policy for controlling wallet operations.
+
+      module IntentType
+        extend Privy::Internal::Type::Enum
+
+        RULE = :RULE
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/privy/models/rule_intent_response.rb

@@ -2,7 +2,6 @@
 
 module Privy
   module Models
-    # @see Privy::Resources::Intents#create_policy_rule
     class RuleIntentResponse < Privy::Models::BaseIntentResponse
       # @!attribute intent_type
       #