orb-billing 0.1.0.pre.alpha.33

data/rbi/lib/orb/models/customers/credits/top_up_create_response.rbi

@@ -0,0 +1,175 @@
+# typed: strong
+
+module Orb
+  module Models
+    module Customers
+      module Credits
+        class TopUpCreateResponse < Orb::BaseModel
+          sig { returns(String) }
+          attr_accessor :id
+
+          # The amount to increment when the threshold is reached.
+          sig { returns(String) }
+          attr_accessor :amount
+
+          # The currency or custom pricing unit to use for this top-up. If this is a
+          #   real-world currency, it must match the customer's invoicing currency.
+          sig { returns(String) }
+          attr_accessor :currency
+
+          # Settings for invoices generated by triggered top-ups.
+          sig { returns(Orb::Models::Customers::Credits::TopUpCreateResponse::InvoiceSettings) }
+          attr_reader :invoice_settings
+
+          sig do
+            params(
+              invoice_settings: T.any(Orb::Models::Customers::Credits::TopUpCreateResponse::InvoiceSettings, Orb::Util::AnyHash)
+            )
+              .void
+          end
+          attr_writer :invoice_settings
+
+          # How much, in the customer's currency, to charge for each unit.
+          sig { returns(String) }
+          attr_accessor :per_unit_cost_basis
+
+          # The threshold at which to trigger the top-up. If the balance is at or below this
+          #   threshold, the top-up will be triggered.
+          sig { returns(String) }
+          attr_accessor :threshold
+
+          # The number of days or months after which the top-up expires. If unspecified, it
+          #   does not expire.
+          sig { returns(T.nilable(Integer)) }
+          attr_accessor :expires_after
+
+          # The unit of expires_after.
+          sig { returns(T.nilable(Orb::Models::Customers::Credits::TopUpCreateResponse::ExpiresAfterUnit::TaggedSymbol)) }
+          attr_accessor :expires_after_unit
+
+          sig do
+            params(
+              id: String,
+              amount: String,
+              currency: String,
+              invoice_settings: T.any(Orb::Models::Customers::Credits::TopUpCreateResponse::InvoiceSettings, Orb::Util::AnyHash),
+              per_unit_cost_basis: String,
+              threshold: String,
+              expires_after: T.nilable(Integer),
+              expires_after_unit: T.nilable(Orb::Models::Customers::Credits::TopUpCreateResponse::ExpiresAfterUnit::OrSymbol)
+            )
+              .returns(T.attached_class)
+          end
+          def self.new(
+            id:,
+            amount:,
+            currency:,
+            invoice_settings:,
+            per_unit_cost_basis:,
+            threshold:,
+            expires_after: nil,
+            expires_after_unit: nil
+          )
+          end
+
+          sig do
+            override
+              .returns(
+                {
+                  id: String,
+                  amount: String,
+                  currency: String,
+                  invoice_settings: Orb::Models::Customers::Credits::TopUpCreateResponse::InvoiceSettings,
+                  per_unit_cost_basis: String,
+                  threshold: String,
+                  expires_after: T.nilable(Integer),
+                  expires_after_unit: T.nilable(Orb::Models::Customers::Credits::TopUpCreateResponse::ExpiresAfterUnit::TaggedSymbol)
+                }
+              )
+          end
+          def to_hash
+          end
+
+          class InvoiceSettings < Orb::BaseModel
+            # Whether the credits purchase invoice should auto collect with the customer's
+            #   saved payment method.
+            sig { returns(T::Boolean) }
+            attr_accessor :auto_collection
+
+            # The net terms determines the difference between the invoice date and the issue
+            #   date for the invoice. If you intend the invoice to be due on issue, set this
+            #   to 0.
+            sig { returns(Integer) }
+            attr_accessor :net_terms
+
+            # An optional memo to display on the invoice.
+            sig { returns(T.nilable(String)) }
+            attr_accessor :memo
+
+            # If true, new credit blocks created by this top-up will require that the
+            #   corresponding invoice is paid before they can be drawn down from.
+            sig { returns(T.nilable(T::Boolean)) }
+            attr_reader :require_successful_payment
+
+            sig { params(require_successful_payment: T::Boolean).void }
+            attr_writer :require_successful_payment
+
+            # Settings for invoices generated by triggered top-ups.
+            sig do
+              params(
+                auto_collection: T::Boolean,
+                net_terms: Integer,
+                memo: T.nilable(String),
+                require_successful_payment: T::Boolean
+              )
+                .returns(T.attached_class)
+            end
+            def self.new(auto_collection:, net_terms:, memo: nil, require_successful_payment: nil)
+            end
+
+            sig do
+              override
+                .returns(
+                  {
+                    auto_collection: T::Boolean,
+                    net_terms: Integer,
+                    memo: T.nilable(String),
+                    require_successful_payment: T::Boolean
+                  }
+                )
+            end
+            def to_hash
+            end
+          end
+
+          # The unit of expires_after.
+          module ExpiresAfterUnit
+            extend Orb::Enum
+
+            TaggedSymbol =
+              T.type_alias { T.all(Symbol, Orb::Models::Customers::Credits::TopUpCreateResponse::ExpiresAfterUnit) }
+            OrSymbol =
+              T.type_alias do
+                T.any(
+                  Symbol,
+                  String,
+                  Orb::Models::Customers::Credits::TopUpCreateResponse::ExpiresAfterUnit::TaggedSymbol
+                )
+              end
+
+            DAY = T.let(:day, Orb::Models::Customers::Credits::TopUpCreateResponse::ExpiresAfterUnit::TaggedSymbol)
+            MONTH =
+              T.let(:month, Orb::Models::Customers::Credits::TopUpCreateResponse::ExpiresAfterUnit::TaggedSymbol)
+
+            sig do
+              override
+                .returns(T::Array[Orb::Models::Customers::Credits::TopUpCreateResponse::ExpiresAfterUnit::TaggedSymbol])
+            end
+            def self.values
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/lib/orb/models/customers/credits/top_up_delete_by_external_id_params.rbi

@@ -0,0 +1,31 @@
+# typed: strong
+
+module Orb
+  module Models
+    module Customers
+      module Credits
+        class TopUpDeleteByExternalIDParams < Orb::BaseModel
+          extend Orb::Type::RequestParameters::Converter
+          include Orb::RequestParameters
+
+          sig { returns(String) }
+          attr_accessor :external_customer_id
+
+          sig do
+            params(
+              external_customer_id: String,
+              request_options: T.any(Orb::RequestOptions, Orb::Util::AnyHash)
+            )
+              .returns(T.attached_class)
+          end
+          def self.new(external_customer_id:, request_options: {})
+          end
+
+          sig { override.returns({external_customer_id: String, request_options: Orb::RequestOptions}) }
+          def to_hash
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/lib/orb/models/customers/credits/top_up_delete_params.rbi

@@ -0,0 +1,28 @@
+# typed: strong
+
+module Orb
+  module Models
+    module Customers
+      module Credits
+        class TopUpDeleteParams < Orb::BaseModel
+          extend Orb::Type::RequestParameters::Converter
+          include Orb::RequestParameters
+
+          sig { returns(String) }
+          attr_accessor :customer_id
+
+          sig do
+            params(customer_id: String, request_options: T.any(Orb::RequestOptions, Orb::Util::AnyHash))
+              .returns(T.attached_class)
+          end
+          def self.new(customer_id:, request_options: {})
+          end
+
+          sig { override.returns({customer_id: String, request_options: Orb::RequestOptions}) }
+          def to_hash
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/lib/orb/models/customers/credits/top_up_list_by_external_id_params.rbi

@@ -0,0 +1,49 @@
+# typed: strong
+
+module Orb
+  module Models
+    module Customers
+      module Credits
+        class TopUpListByExternalIDParams < Orb::BaseModel
+          extend Orb::Type::RequestParameters::Converter
+          include Orb::RequestParameters
+
+          # Cursor for pagination. This can be populated by the `next_cursor` value returned
+          #   from the initial request.
+          sig { returns(T.nilable(String)) }
+          attr_accessor :cursor
+
+          # The number of items to fetch. Defaults to 20.
+          sig { returns(T.nilable(Integer)) }
+          attr_reader :limit
+
+          sig { params(limit: Integer).void }
+          attr_writer :limit
+
+          sig do
+            params(
+              cursor: T.nilable(String),
+              limit: Integer,
+              request_options: T.any(Orb::RequestOptions, Orb::Util::AnyHash)
+            )
+              .returns(T.attached_class)
+          end
+          def self.new(cursor: nil, limit: nil, request_options: {})
+          end
+
+          sig do
+            override.returns(
+              {
+                cursor: T.nilable(String),
+                limit: Integer,
+                request_options: Orb::RequestOptions
+              }
+            )
+          end
+          def to_hash
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/lib/orb/models/customers/credits/top_up_list_by_external_id_response.rbi

@@ -0,0 +1,188 @@
+# typed: strong
+
+module Orb
+  module Models
+    module Customers
+      module Credits
+        class TopUpListByExternalIDResponse < Orb::BaseModel
+          sig { returns(String) }
+          attr_accessor :id
+
+          # The amount to increment when the threshold is reached.
+          sig { returns(String) }
+          attr_accessor :amount
+
+          # The currency or custom pricing unit to use for this top-up. If this is a
+          #   real-world currency, it must match the customer's invoicing currency.
+          sig { returns(String) }
+          attr_accessor :currency
+
+          # Settings for invoices generated by triggered top-ups.
+          sig { returns(Orb::Models::Customers::Credits::TopUpListByExternalIDResponse::InvoiceSettings) }
+          attr_reader :invoice_settings
+
+          sig do
+            params(
+              invoice_settings: T.any(Orb::Models::Customers::Credits::TopUpListByExternalIDResponse::InvoiceSettings, Orb::Util::AnyHash)
+            )
+              .void
+          end
+          attr_writer :invoice_settings
+
+          # How much, in the customer's currency, to charge for each unit.
+          sig { returns(String) }
+          attr_accessor :per_unit_cost_basis
+
+          # The threshold at which to trigger the top-up. If the balance is at or below this
+          #   threshold, the top-up will be triggered.
+          sig { returns(String) }
+          attr_accessor :threshold
+
+          # The number of days or months after which the top-up expires. If unspecified, it
+          #   does not expire.
+          sig { returns(T.nilable(Integer)) }
+          attr_accessor :expires_after
+
+          # The unit of expires_after.
+          sig do
+            returns(
+              T.nilable(Orb::Models::Customers::Credits::TopUpListByExternalIDResponse::ExpiresAfterUnit::TaggedSymbol)
+            )
+          end
+          attr_accessor :expires_after_unit
+
+          sig do
+            params(
+              id: String,
+              amount: String,
+              currency: String,
+              invoice_settings: T.any(Orb::Models::Customers::Credits::TopUpListByExternalIDResponse::InvoiceSettings, Orb::Util::AnyHash),
+              per_unit_cost_basis: String,
+              threshold: String,
+              expires_after: T.nilable(Integer),
+              expires_after_unit: T.nilable(Orb::Models::Customers::Credits::TopUpListByExternalIDResponse::ExpiresAfterUnit::OrSymbol)
+            )
+              .returns(T.attached_class)
+          end
+          def self.new(
+            id:,
+            amount:,
+            currency:,
+            invoice_settings:,
+            per_unit_cost_basis:,
+            threshold:,
+            expires_after: nil,
+            expires_after_unit: nil
+          )
+          end
+
+          sig do
+            override
+              .returns(
+                {
+                  id: String,
+                  amount: String,
+                  currency: String,
+                  invoice_settings: Orb::Models::Customers::Credits::TopUpListByExternalIDResponse::InvoiceSettings,
+                  per_unit_cost_basis: String,
+                  threshold: String,
+                  expires_after: T.nilable(Integer),
+                  expires_after_unit: T.nilable(Orb::Models::Customers::Credits::TopUpListByExternalIDResponse::ExpiresAfterUnit::TaggedSymbol)
+                }
+              )
+          end
+          def to_hash
+          end
+
+          class InvoiceSettings < Orb::BaseModel
+            # Whether the credits purchase invoice should auto collect with the customer's
+            #   saved payment method.
+            sig { returns(T::Boolean) }
+            attr_accessor :auto_collection
+
+            # The net terms determines the difference between the invoice date and the issue
+            #   date for the invoice. If you intend the invoice to be due on issue, set this
+            #   to 0.
+            sig { returns(Integer) }
+            attr_accessor :net_terms
+
+            # An optional memo to display on the invoice.
+            sig { returns(T.nilable(String)) }
+            attr_accessor :memo
+
+            # If true, new credit blocks created by this top-up will require that the
+            #   corresponding invoice is paid before they can be drawn down from.
+            sig { returns(T.nilable(T::Boolean)) }
+            attr_reader :require_successful_payment
+
+            sig { params(require_successful_payment: T::Boolean).void }
+            attr_writer :require_successful_payment
+
+            # Settings for invoices generated by triggered top-ups.
+            sig do
+              params(
+                auto_collection: T::Boolean,
+                net_terms: Integer,
+                memo: T.nilable(String),
+                require_successful_payment: T::Boolean
+              )
+                .returns(T.attached_class)
+            end
+            def self.new(auto_collection:, net_terms:, memo: nil, require_successful_payment: nil)
+            end
+
+            sig do
+              override
+                .returns(
+                  {
+                    auto_collection: T::Boolean,
+                    net_terms: Integer,
+                    memo: T.nilable(String),
+                    require_successful_payment: T::Boolean
+                  }
+                )
+            end
+            def to_hash
+            end
+          end
+
+          # The unit of expires_after.
+          module ExpiresAfterUnit
+            extend Orb::Enum
+
+            TaggedSymbol =
+              T.type_alias { T.all(Symbol, Orb::Models::Customers::Credits::TopUpListByExternalIDResponse::ExpiresAfterUnit) }
+            OrSymbol =
+              T.type_alias do
+                T.any(
+                  Symbol,
+                  String,
+                  Orb::Models::Customers::Credits::TopUpListByExternalIDResponse::ExpiresAfterUnit::TaggedSymbol
+                )
+              end
+
+            DAY =
+              T.let(
+                :day,
+                Orb::Models::Customers::Credits::TopUpListByExternalIDResponse::ExpiresAfterUnit::TaggedSymbol
+              )
+            MONTH =
+              T.let(
+                :month,
+                Orb::Models::Customers::Credits::TopUpListByExternalIDResponse::ExpiresAfterUnit::TaggedSymbol
+              )
+
+            sig do
+              override
+                .returns(
+                  T::Array[Orb::Models::Customers::Credits::TopUpListByExternalIDResponse::ExpiresAfterUnit::TaggedSymbol]
+                )
+            end
+            def self.values
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/lib/orb/models/customers/credits/top_up_list_params.rbi

@@ -0,0 +1,49 @@
+# typed: strong
+
+module Orb
+  module Models
+    module Customers
+      module Credits
+        class TopUpListParams < Orb::BaseModel
+          extend Orb::Type::RequestParameters::Converter
+          include Orb::RequestParameters
+
+          # Cursor for pagination. This can be populated by the `next_cursor` value returned
+          #   from the initial request.
+          sig { returns(T.nilable(String)) }
+          attr_accessor :cursor
+
+          # The number of items to fetch. Defaults to 20.
+          sig { returns(T.nilable(Integer)) }
+          attr_reader :limit
+
+          sig { params(limit: Integer).void }
+          attr_writer :limit
+
+          sig do
+            params(
+              cursor: T.nilable(String),
+              limit: Integer,
+              request_options: T.any(Orb::RequestOptions, Orb::Util::AnyHash)
+            )
+              .returns(T.attached_class)
+          end
+          def self.new(cursor: nil, limit: nil, request_options: {})
+          end
+
+          sig do
+            override.returns(
+              {
+                cursor: T.nilable(String),
+                limit: Integer,
+                request_options: Orb::RequestOptions
+              }
+            )
+          end
+          def to_hash
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/lib/orb/models/customers/credits/top_up_list_response.rbi

@@ -0,0 +1,168 @@
+# typed: strong
+
+module Orb
+  module Models
+    module Customers
+      module Credits
+        class TopUpListResponse < Orb::BaseModel
+          sig { returns(String) }
+          attr_accessor :id
+
+          # The amount to increment when the threshold is reached.
+          sig { returns(String) }
+          attr_accessor :amount
+
+          # The currency or custom pricing unit to use for this top-up. If this is a
+          #   real-world currency, it must match the customer's invoicing currency.
+          sig { returns(String) }
+          attr_accessor :currency
+
+          # Settings for invoices generated by triggered top-ups.
+          sig { returns(Orb::Models::Customers::Credits::TopUpListResponse::InvoiceSettings) }
+          attr_reader :invoice_settings
+
+          sig do
+            params(
+              invoice_settings: T.any(Orb::Models::Customers::Credits::TopUpListResponse::InvoiceSettings, Orb::Util::AnyHash)
+            )
+              .void
+          end
+          attr_writer :invoice_settings
+
+          # How much, in the customer's currency, to charge for each unit.
+          sig { returns(String) }
+          attr_accessor :per_unit_cost_basis
+
+          # The threshold at which to trigger the top-up. If the balance is at or below this
+          #   threshold, the top-up will be triggered.
+          sig { returns(String) }
+          attr_accessor :threshold
+
+          # The number of days or months after which the top-up expires. If unspecified, it
+          #   does not expire.
+          sig { returns(T.nilable(Integer)) }
+          attr_accessor :expires_after
+
+          # The unit of expires_after.
+          sig { returns(T.nilable(Orb::Models::Customers::Credits::TopUpListResponse::ExpiresAfterUnit::TaggedSymbol)) }
+          attr_accessor :expires_after_unit
+
+          sig do
+            params(
+              id: String,
+              amount: String,
+              currency: String,
+              invoice_settings: T.any(Orb::Models::Customers::Credits::TopUpListResponse::InvoiceSettings, Orb::Util::AnyHash),
+              per_unit_cost_basis: String,
+              threshold: String,
+              expires_after: T.nilable(Integer),
+              expires_after_unit: T.nilable(Orb::Models::Customers::Credits::TopUpListResponse::ExpiresAfterUnit::OrSymbol)
+            )
+              .returns(T.attached_class)
+          end
+          def self.new(
+            id:,
+            amount:,
+            currency:,
+            invoice_settings:,
+            per_unit_cost_basis:,
+            threshold:,
+            expires_after: nil,
+            expires_after_unit: nil
+          )
+          end
+
+          sig do
+            override
+              .returns(
+                {
+                  id: String,
+                  amount: String,
+                  currency: String,
+                  invoice_settings: Orb::Models::Customers::Credits::TopUpListResponse::InvoiceSettings,
+                  per_unit_cost_basis: String,
+                  threshold: String,
+                  expires_after: T.nilable(Integer),
+                  expires_after_unit: T.nilable(Orb::Models::Customers::Credits::TopUpListResponse::ExpiresAfterUnit::TaggedSymbol)
+                }
+              )
+          end
+          def to_hash
+          end
+
+          class InvoiceSettings < Orb::BaseModel
+            # Whether the credits purchase invoice should auto collect with the customer's
+            #   saved payment method.
+            sig { returns(T::Boolean) }
+            attr_accessor :auto_collection
+
+            # The net terms determines the difference between the invoice date and the issue
+            #   date for the invoice. If you intend the invoice to be due on issue, set this
+            #   to 0.
+            sig { returns(Integer) }
+            attr_accessor :net_terms
+
+            # An optional memo to display on the invoice.
+            sig { returns(T.nilable(String)) }
+            attr_accessor :memo
+
+            # If true, new credit blocks created by this top-up will require that the
+            #   corresponding invoice is paid before they can be drawn down from.
+            sig { returns(T.nilable(T::Boolean)) }
+            attr_reader :require_successful_payment
+
+            sig { params(require_successful_payment: T::Boolean).void }
+            attr_writer :require_successful_payment
+
+            # Settings for invoices generated by triggered top-ups.
+            sig do
+              params(
+                auto_collection: T::Boolean,
+                net_terms: Integer,
+                memo: T.nilable(String),
+                require_successful_payment: T::Boolean
+              )
+                .returns(T.attached_class)
+            end
+            def self.new(auto_collection:, net_terms:, memo: nil, require_successful_payment: nil)
+            end
+
+            sig do
+              override
+                .returns(
+                  {
+                    auto_collection: T::Boolean,
+                    net_terms: Integer,
+                    memo: T.nilable(String),
+                    require_successful_payment: T::Boolean
+                  }
+                )
+            end
+            def to_hash
+            end
+          end
+
+          # The unit of expires_after.
+          module ExpiresAfterUnit
+            extend Orb::Enum
+
+            TaggedSymbol =
+              T.type_alias { T.all(Symbol, Orb::Models::Customers::Credits::TopUpListResponse::ExpiresAfterUnit) }
+            OrSymbol =
+              T.type_alias { T.any(Symbol, String, Orb::Models::Customers::Credits::TopUpListResponse::ExpiresAfterUnit::TaggedSymbol) }
+
+            DAY = T.let(:day, Orb::Models::Customers::Credits::TopUpListResponse::ExpiresAfterUnit::TaggedSymbol)
+            MONTH = T.let(:month, Orb::Models::Customers::Credits::TopUpListResponse::ExpiresAfterUnit::TaggedSymbol)
+
+            sig do
+              override
+                .returns(T::Array[Orb::Models::Customers::Credits::TopUpListResponse::ExpiresAfterUnit::TaggedSymbol])
+            end
+            def self.values
+            end
+          end
+        end
+      end
+    end
+  end
+end