orb-billing 1.15.0 → 1.17.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1d305b878bb757ab7c0461ba4d35bd2560e829eae8bb2676103b62b27773d82f
-  data.tar.gz: d5253fbeb8bdec63084816df8c75aa129a131a3f041cccef9fa4c20b87aac356
+  metadata.gz: 3ef35d682805182fd540072d1a6829ceddb3e8e438bfee769fa34b2689cc5347
+  data.tar.gz: 43a3a581105890a3a7d2e680e7345a7dfccd407df8598ab8c36a1644efa66d17
 SHA512:
-  metadata.gz: cef11be3d2248ba0e2acd7567cbf84ea311cbb155037959b97c936a5209278fd8eb77182fc10705cbc46dd34f3742bb0c7575bf946388a5787f9af720a945b54
-  data.tar.gz: 6385a21d5e76d000caebb5cfffde20e82a03b1629237969091403563b615fd76d22af28dd8c59210021d62a73aaa51a42342bd9e2464902e2092440e0c9e261a
+  metadata.gz: dfab4687dfb93e20ee62d120aeebeddee6de07b01dc4232014cbf1bd3870de6b3f2175ba88b3b4e09bfc009416d68ccaaa06cd4dc541f4609a0b8270dad1974d
+  data.tar.gz: 52733526759b6679171fae76c1bb136a72c4ea0ecb1f1cd42661ddc4bd7e35c083f0616488304badafe03d9f74887f0b4b1edd4c493b353c2dd14676762ba9db

data/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## [1.17.0](https://github.com/orbcorp/orb-ruby/compare/v1.16.0...v1.17.0) (2026-07-15)
+
+
+### Features
+
+* **api:** deprecate debug mode ingestion response field ([65ab353](https://github.com/orbcorp/orb-ruby/commit/65ab353b1838ee8e6ed45ac4036601af4f80d10a))
+
+## [1.16.0](https://github.com/orbcorp/orb-ruby/compare/v1.15.0...v1.16.0) (2026-07-14)
+
+
+### Features
+
+* **api:** add `commitment` credit block source and `credit_commitment` field ([e094d85](https://github.com/orbcorp/orb-ruby/commit/e094d856b497ebc13b962e45e504b3596198c156))
+* **api:** api update ([9c391e2](https://github.com/orbcorp/orb-ruby/commit/9c391e2ae05b0e0579b7807b63d08d0d4da9f37b))
+
 ## [1.15.0](https://github.com/orbcorp/orb-ruby/compare/v1.14.0...v1.15.0) (2026-07-10)
 
 

data/README.md

@@ -15,7 +15,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "orb-billing", "~> 1.14.0"
+gem "orb-billing", "~> 1.16.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/orb/models/billable_metric.rb

@@ -36,6 +36,13 @@ module Orb
       #   @return [String]
       required :name, String
 
+      # @!attribute sql
+      #   The SQL definition of the metric. For metrics defined via configuration rather
+      #   than SQL, this is a derived SQL representation.
+      #
+      #   @return [String]
+      required :sql, String
+
       # @!attribute status
       #
       #   @return [Symbol, Orb::Models::BillableMetric::Status]
@@ -48,7 +55,7 @@ module Orb
                Orb::Internal::Type::ArrayOf[Orb::Internal::Type::HashOf[Orb::Internal::Type::Unknown]],
                nil?: true
 
-      # @!method initialize(id:, description:, item:, metadata:, name:, status:, parameter_definitions: nil)
+      # @!method initialize(id:, description:, item:, metadata:, name:, sql:, status:, parameter_definitions: nil)
       #   Some parameter documentations has been truncated, see
       #   {Orb::Models::BillableMetric} for more details.
       #
@@ -66,6 +73,8 @@ module Orb
       #
       #   @param name [String]
       #
+      #   @param sql [String] The SQL definition of the metric. For metrics defined via configuration rather t
+      #
       #   @param status [Symbol, Orb::Models::BillableMetric::Status]
       #
       #   @param parameter_definitions [Array<Hash{Symbol=>Object}>, nil]

data/lib/orb/models/credit_block_list_invoices_response.rb

@@ -35,7 +35,8 @@ module Orb
 
         # @!attribute credit_block_source
         #   How this credit block was created: `allocation` (a subscription's recurring
-        #   credit allocation), `top_up` (an automatic balance-threshold top-up), or
+        #   credit allocation), `top_up` (an automatic balance-threshold top-up),
+        #   `commitment` (a subscription commitment true-up rolled forward as credit), or
         #   `manual` (a manual credit ledger increment, including credits voided or expired
         #   off another block).
         #
@@ -92,7 +93,16 @@ module Orb
                  -> { Orb::Models::CreditBlockListInvoicesResponse::Block::CreditAllocation },
                  nil?: true
 
-        # @!method initialize(id:, balance:, credit_block_source:, effective_date:, expiry_date:, filters:, maximum_initial_balance:, metadata:, per_unit_cost_basis:, status:, credit_allocation: nil)
+        # @!attribute credit_commitment
+        #   The subscription commitment whose true-up rolled forward into this credit block.
+        #   Present only when `credit_block_source` is `commitment`.
+        #
+        #   @return [Orb::Models::CreditBlockListInvoicesResponse::Block::CreditCommitment, nil]
+        optional :credit_commitment,
+                 -> { Orb::Models::CreditBlockListInvoicesResponse::Block::CreditCommitment },
+                 nil?: true
+
+        # @!method initialize(id:, balance:, credit_block_source:, effective_date:, expiry_date:, filters:, maximum_initial_balance:, metadata:, per_unit_cost_basis:, status:, credit_allocation: nil, credit_commitment: nil)
         #   Some parameter documentations has been truncated, see
         #   {Orb::Models::CreditBlockListInvoicesResponse::Block} for more details.
         #
@@ -119,9 +129,12 @@ module Orb
         #   @param status [Symbol, Orb::Models::CreditBlockListInvoicesResponse::Block::Status]
         #
         #   @param credit_allocation [Orb::Models::CreditBlockListInvoicesResponse::Block::CreditAllocation, nil] The credit allocation that funded a block. Extends the allocation resource
+        #
+        #   @param credit_commitment [Orb::Models::CreditBlockListInvoicesResponse::Block::CreditCommitment, nil] The subscription commitment whose true-up rolled forward into this credit block.
 
         # How this credit block was created: `allocation` (a subscription's recurring
-        # credit allocation), `top_up` (an automatic balance-threshold top-up), or
+        # credit allocation), `top_up` (an automatic balance-threshold top-up),
+        # `commitment` (a subscription commitment true-up rolled forward as credit), or
         # `manual` (a manual credit ledger increment, including credits voided or expired
         # off another block).
         #
@@ -131,6 +144,7 @@ module Orb
 
           ALLOCATION = :allocation
           TOP_UP = :top_up
+          COMMITMENT = :commitment
           MANUAL = :manual
 
           # @!method self.values
@@ -317,6 +331,29 @@ module Orb
             end
           end
         end
+
+        # @see Orb::Models::CreditBlockListInvoicesResponse::Block#credit_commitment
+        class CreditCommitment < Orb::Internal::Type::BaseModel
+          # @!attribute id
+          #   The ID of the subscription commitment this block was rolled forward from.
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!attribute subscription_id
+          #   The subscription the commitment belongs to.
+          #
+          #   @return [String, nil]
+          optional :subscription_id, String, nil?: true
+
+          # @!method initialize(id:, subscription_id: nil)
+          #   The subscription commitment whose true-up rolled forward into this credit block.
+          #   Present only when `credit_block_source` is `commitment`.
+          #
+          #   @param id [String] The ID of the subscription commitment this block was rolled forward from.
+          #
+          #   @param subscription_id [String, nil] The subscription the commitment belongs to.
+        end
       end
 
       class Invoice < Orb::Internal::Type::BaseModel

data/lib/orb/models/credit_block_retrieve_response.rb

@@ -16,7 +16,8 @@ module Orb
 
       # @!attribute credit_block_source
       #   How this credit block was created: `allocation` (a subscription's recurring
-      #   credit allocation), `top_up` (an automatic balance-threshold top-up), or
+      #   credit allocation), `top_up` (an automatic balance-threshold top-up),
+      #   `commitment` (a subscription commitment true-up rolled forward as credit), or
       #   `manual` (a manual credit ledger increment, including credits voided or expired
       #   off another block).
       #
@@ -69,7 +70,14 @@ module Orb
       #   @return [Orb::Models::CreditBlockRetrieveResponse::CreditAllocation, nil]
       optional :credit_allocation, -> { Orb::Models::CreditBlockRetrieveResponse::CreditAllocation }, nil?: true
 
-      # @!method initialize(id:, balance:, credit_block_source:, effective_date:, expiry_date:, filters:, maximum_initial_balance:, metadata:, per_unit_cost_basis:, status:, credit_allocation: nil)
+      # @!attribute credit_commitment
+      #   The subscription commitment whose true-up rolled forward into this credit block.
+      #   Present only when `credit_block_source` is `commitment`.
+      #
+      #   @return [Orb::Models::CreditBlockRetrieveResponse::CreditCommitment, nil]
+      optional :credit_commitment, -> { Orb::Models::CreditBlockRetrieveResponse::CreditCommitment }, nil?: true
+
+      # @!method initialize(id:, balance:, credit_block_source:, effective_date:, expiry_date:, filters:, maximum_initial_balance:, metadata:, per_unit_cost_basis:, status:, credit_allocation: nil, credit_commitment: nil)
       #   Some parameter documentations has been truncated, see
       #   {Orb::Models::CreditBlockRetrieveResponse} for more details.
       #
@@ -96,9 +104,12 @@ module Orb
       #   @param status [Symbol, Orb::Models::CreditBlockRetrieveResponse::Status]
       #
       #   @param credit_allocation [Orb::Models::CreditBlockRetrieveResponse::CreditAllocation, nil] The credit allocation that funded a block. Extends the allocation resource
+      #
+      #   @param credit_commitment [Orb::Models::CreditBlockRetrieveResponse::CreditCommitment, nil] The subscription commitment whose true-up rolled forward into this credit block.
 
       # How this credit block was created: `allocation` (a subscription's recurring
-      # credit allocation), `top_up` (an automatic balance-threshold top-up), or
+      # credit allocation), `top_up` (an automatic balance-threshold top-up),
+      # `commitment` (a subscription commitment true-up rolled forward as credit), or
       # `manual` (a manual credit ledger increment, including credits voided or expired
       # off another block).
       #
@@ -108,6 +119,7 @@ module Orb
 
         ALLOCATION = :allocation
         TOP_UP = :top_up
+        COMMITMENT = :commitment
         MANUAL = :manual
 
         # @!method self.values
@@ -292,6 +304,29 @@ module Orb
           end
         end
       end
+
+      # @see Orb::Models::CreditBlockRetrieveResponse#credit_commitment
+      class CreditCommitment < Orb::Internal::Type::BaseModel
+        # @!attribute id
+        #   The ID of the subscription commitment this block was rolled forward from.
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute subscription_id
+        #   The subscription the commitment belongs to.
+        #
+        #   @return [String, nil]
+        optional :subscription_id, String, nil?: true
+
+        # @!method initialize(id:, subscription_id: nil)
+        #   The subscription commitment whose true-up rolled forward into this credit block.
+        #   Present only when `credit_block_source` is `commitment`.
+        #
+        #   @param id [String] The ID of the subscription commitment this block was rolled forward from.
+        #
+        #   @param subscription_id [String, nil] The subscription the commitment belongs to.
+      end
     end
   end
 end

data/lib/orb/models/customers/credit_list_by_external_id_response.rb

@@ -17,7 +17,8 @@ module Orb
 
         # @!attribute credit_block_source
         #   How this credit block was created: `allocation` (a subscription's recurring
-        #   credit allocation), `top_up` (an automatic balance-threshold top-up), or
+        #   credit allocation), `top_up` (an automatic balance-threshold top-up),
+        #   `commitment` (a subscription commitment true-up rolled forward as credit), or
         #   `manual` (a manual credit ledger increment, including credits voided or expired
         #   off another block).
         #
@@ -74,7 +75,16 @@ module Orb
                  -> { Orb::Models::Customers::CreditListByExternalIDResponse::CreditAllocation },
                  nil?: true
 
-        # @!method initialize(id:, balance:, credit_block_source:, effective_date:, expiry_date:, filters:, maximum_initial_balance:, metadata:, per_unit_cost_basis:, status:, credit_allocation: nil)
+        # @!attribute credit_commitment
+        #   The subscription commitment whose true-up rolled forward into this credit block.
+        #   Present only when `credit_block_source` is `commitment`.
+        #
+        #   @return [Orb::Models::Customers::CreditListByExternalIDResponse::CreditCommitment, nil]
+        optional :credit_commitment,
+                 -> { Orb::Models::Customers::CreditListByExternalIDResponse::CreditCommitment },
+                 nil?: true
+
+        # @!method initialize(id:, balance:, credit_block_source:, effective_date:, expiry_date:, filters:, maximum_initial_balance:, metadata:, per_unit_cost_basis:, status:, credit_allocation: nil, credit_commitment: nil)
         #   Some parameter documentations has been truncated, see
         #   {Orb::Models::Customers::CreditListByExternalIDResponse} for more details.
         #
@@ -99,9 +109,12 @@ module Orb
         #   @param status [Symbol, Orb::Models::Customers::CreditListByExternalIDResponse::Status]
         #
         #   @param credit_allocation [Orb::Models::Customers::CreditListByExternalIDResponse::CreditAllocation, nil] The credit allocation that funded a block. Extends the allocation resource
+        #
+        #   @param credit_commitment [Orb::Models::Customers::CreditListByExternalIDResponse::CreditCommitment, nil] The subscription commitment whose true-up rolled forward into this credit block.
 
         # How this credit block was created: `allocation` (a subscription's recurring
-        # credit allocation), `top_up` (an automatic balance-threshold top-up), or
+        # credit allocation), `top_up` (an automatic balance-threshold top-up),
+        # `commitment` (a subscription commitment true-up rolled forward as credit), or
         # `manual` (a manual credit ledger increment, including credits voided or expired
         # off another block).
         #
@@ -111,6 +124,7 @@ module Orb
 
           ALLOCATION = :allocation
           TOP_UP = :top_up
+          COMMITMENT = :commitment
           MANUAL = :manual
 
           # @!method self.values
@@ -295,6 +309,29 @@ module Orb
             end
           end
         end
+
+        # @see Orb::Models::Customers::CreditListByExternalIDResponse#credit_commitment
+        class CreditCommitment < Orb::Internal::Type::BaseModel
+          # @!attribute id
+          #   The ID of the subscription commitment this block was rolled forward from.
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!attribute subscription_id
+          #   The subscription the commitment belongs to.
+          #
+          #   @return [String, nil]
+          optional :subscription_id, String, nil?: true
+
+          # @!method initialize(id:, subscription_id: nil)
+          #   The subscription commitment whose true-up rolled forward into this credit block.
+          #   Present only when `credit_block_source` is `commitment`.
+          #
+          #   @param id [String] The ID of the subscription commitment this block was rolled forward from.
+          #
+          #   @param subscription_id [String, nil] The subscription the commitment belongs to.
+        end
       end
     end
   end

data/lib/orb/models/customers/credit_list_response.rb

@@ -17,7 +17,8 @@ module Orb
 
         # @!attribute credit_block_source
         #   How this credit block was created: `allocation` (a subscription's recurring
-        #   credit allocation), `top_up` (an automatic balance-threshold top-up), or
+        #   credit allocation), `top_up` (an automatic balance-threshold top-up),
+        #   `commitment` (a subscription commitment true-up rolled forward as credit), or
         #   `manual` (a manual credit ledger increment, including credits voided or expired
         #   off another block).
         #
@@ -72,7 +73,16 @@ module Orb
                  -> { Orb::Models::Customers::CreditListResponse::CreditAllocation },
                  nil?: true
 
-        # @!method initialize(id:, balance:, credit_block_source:, effective_date:, expiry_date:, filters:, maximum_initial_balance:, metadata:, per_unit_cost_basis:, status:, credit_allocation: nil)
+        # @!attribute credit_commitment
+        #   The subscription commitment whose true-up rolled forward into this credit block.
+        #   Present only when `credit_block_source` is `commitment`.
+        #
+        #   @return [Orb::Models::Customers::CreditListResponse::CreditCommitment, nil]
+        optional :credit_commitment,
+                 -> { Orb::Models::Customers::CreditListResponse::CreditCommitment },
+                 nil?: true
+
+        # @!method initialize(id:, balance:, credit_block_source:, effective_date:, expiry_date:, filters:, maximum_initial_balance:, metadata:, per_unit_cost_basis:, status:, credit_allocation: nil, credit_commitment: nil)
         #   Some parameter documentations has been truncated, see
         #   {Orb::Models::Customers::CreditListResponse} for more details.
         #
@@ -97,9 +107,12 @@ module Orb
         #   @param status [Symbol, Orb::Models::Customers::CreditListResponse::Status]
         #
         #   @param credit_allocation [Orb::Models::Customers::CreditListResponse::CreditAllocation, nil] The credit allocation that funded a block. Extends the allocation resource
+        #
+        #   @param credit_commitment [Orb::Models::Customers::CreditListResponse::CreditCommitment, nil] The subscription commitment whose true-up rolled forward into this credit block.
 
         # How this credit block was created: `allocation` (a subscription's recurring
-        # credit allocation), `top_up` (an automatic balance-threshold top-up), or
+        # credit allocation), `top_up` (an automatic balance-threshold top-up),
+        # `commitment` (a subscription commitment true-up rolled forward as credit), or
         # `manual` (a manual credit ledger increment, including credits voided or expired
         # off another block).
         #
@@ -109,6 +122,7 @@ module Orb
 
           ALLOCATION = :allocation
           TOP_UP = :top_up
+          COMMITMENT = :commitment
           MANUAL = :manual
 
           # @!method self.values
@@ -291,6 +305,29 @@ module Orb
             end
           end
         end
+
+        # @see Orb::Models::Customers::CreditListResponse#credit_commitment
+        class CreditCommitment < Orb::Internal::Type::BaseModel
+          # @!attribute id
+          #   The ID of the subscription commitment this block was rolled forward from.
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!attribute subscription_id
+          #   The subscription the commitment belongs to.
+          #
+          #   @return [String, nil]
+          optional :subscription_id, String, nil?: true
+
+          # @!method initialize(id:, subscription_id: nil)
+          #   The subscription commitment whose true-up rolled forward into this credit block.
+          #   Present only when `credit_block_source` is `commitment`.
+          #
+          #   @param id [String] The ID of the subscription commitment this block was rolled forward from.
+          #
+          #   @param subscription_id [String, nil] The subscription the commitment belongs to.
+        end
       end
     end
   end

data/lib/orb/models/event_ingest_response.rb

@@ -13,8 +13,7 @@ module Orb
                -> { Orb::Internal::Type::ArrayOf[Orb::Models::EventIngestResponse::ValidationFailed] }
 
       # @!attribute debug
-      #   Optional debug information (only present when debug=true is passed to the
-      #   endpoint). Contains ingested and duplicate event idempotency keys.
+      #   @deprecated
       #
       #   @return [Orb::Models::EventIngestResponse::Debug, nil]
       optional :debug, -> { Orb::Models::EventIngestResponse::Debug }, nil?: true
@@ -25,7 +24,7 @@ module Orb
       #
       #   @param validation_failed [Array<Orb::Models::EventIngestResponse::ValidationFailed>] Contains all failing validation events. In the case of a 200, this array will al
       #
-      #   @param debug [Orb::Models::EventIngestResponse::Debug, nil] Optional debug information (only present when debug=true is passed to the endpoi
+      #   @param debug [Orb::Models::EventIngestResponse::Debug, nil]
 
       class ValidationFailed < Orb::Internal::Type::BaseModel
         # @!attribute idempotency_key
@@ -50,6 +49,8 @@ module Orb
         #   @param validation_errors [Array<String>] An array of strings corresponding to validation failures for this idempotency_ke
       end
 
+      # @deprecated
+      #
       # @see Orb::Models::EventIngestResponse#debug
       class Debug < Orb::Internal::Type::BaseModel
         # @!attribute duplicate
@@ -63,9 +64,6 @@ module Orb
         required :ingested, Orb::Internal::Type::ArrayOf[String]
 
         # @!method initialize(duplicate:, ingested:)
-        #   Optional debug information (only present when debug=true is passed to the
-        #   endpoint). Contains ingested and duplicate event idempotency keys.
-        #
         #   @param duplicate [Array<String>]
         #   @param ingested [Array<String>]
       end

data/lib/orb/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Orb
-  VERSION = "1.15.0"
+  VERSION = "1.17.0"
 end

data/rbi/orb/models/billable_metric.rbi

@@ -31,6 +31,11 @@ module Orb
       sig { returns(String) }
       attr_accessor :name
 
+      # The SQL definition of the metric. For metrics defined via configuration rather
+      # than SQL, this is a derived SQL representation.
+      sig { returns(String) }
+      attr_accessor :sql
+
       sig { returns(Orb::BillableMetric::Status::TaggedSymbol) }
       attr_accessor :status
 
@@ -47,6 +52,7 @@ module Orb
           item: Orb::Item::OrHash,
           metadata: T::Hash[Symbol, String],
           name: String,
+          sql: String,
           status: Orb::BillableMetric::Status::OrSymbol,
           parameter_definitions:
             T.nilable(T::Array[T::Hash[Symbol, T.anything]])
@@ -65,6 +71,9 @@ module Orb
         # `null`.
         metadata:,
         name:,
+        # The SQL definition of the metric. For metrics defined via configuration rather
+        # than SQL, this is a derived SQL representation.
+        sql:,
         status:,
         parameter_definitions: nil
       )
@@ -78,6 +87,7 @@ module Orb
             item: Orb::Item,
             metadata: T::Hash[Symbol, String],
             name: String,
+            sql: String,
             status: Orb::BillableMetric::Status::TaggedSymbol,
             parameter_definitions:
               T.nilable(T::Array[T::Hash[Symbol, T.anything]])

data/rbi/orb/models/credit_block_list_invoices_response.rbi

@@ -71,7 +71,8 @@ module Orb
         attr_accessor :balance
 
         # How this credit block was created: `allocation` (a subscription's recurring
-        # credit allocation), `top_up` (an automatic balance-threshold top-up), or
+        # credit allocation), `top_up` (an automatic balance-threshold top-up),
+        # `commitment` (a subscription commitment true-up rolled forward as credit), or
         # `manual` (a manual credit ledger increment, including credits voided or expired
         # off another block).
         sig do
@@ -137,6 +138,27 @@ module Orb
         end
         attr_writer :credit_allocation
 
+        # The subscription commitment whose true-up rolled forward into this credit block.
+        # Present only when `credit_block_source` is `commitment`.
+        sig do
+          returns(
+            T.nilable(
+              Orb::Models::CreditBlockListInvoicesResponse::Block::CreditCommitment
+            )
+          )
+        end
+        attr_reader :credit_commitment
+
+        sig do
+          params(
+            credit_commitment:
+              T.nilable(
+                Orb::Models::CreditBlockListInvoicesResponse::Block::CreditCommitment::OrHash
+              )
+          ).void
+        end
+        attr_writer :credit_commitment
+
         # The Credit Block resource models prepaid credits within Orb.
         sig do
           params(
@@ -158,6 +180,10 @@ module Orb
             credit_allocation:
               T.nilable(
                 Orb::Models::CreditBlockListInvoicesResponse::Block::CreditAllocation::OrHash
+              ),
+            credit_commitment:
+              T.nilable(
+                Orb::Models::CreditBlockListInvoicesResponse::Block::CreditCommitment::OrHash
               )
           ).returns(T.attached_class)
         end
@@ -165,7 +191,8 @@ module Orb
           id:,
           balance:,
           # How this credit block was created: `allocation` (a subscription's recurring
-          # credit allocation), `top_up` (an automatic balance-threshold top-up), or
+          # credit allocation), `top_up` (an automatic balance-threshold top-up),
+          # `commitment` (a subscription commitment true-up rolled forward as credit), or
           # `manual` (a manual credit ledger increment, including credits voided or expired
           # off another block).
           credit_block_source:,
@@ -182,7 +209,10 @@ module Orb
           status:,
           # The credit allocation that funded a block. Extends the allocation resource
           # serialized on prices with the catalog-item attribution of the funding price.
-          credit_allocation: nil
+          credit_allocation: nil,
+          # The subscription commitment whose true-up rolled forward into this credit block.
+          # Present only when `credit_block_source` is `commitment`.
+          credit_commitment: nil
         )
         end
 
@@ -207,6 +237,10 @@ module Orb
               credit_allocation:
                 T.nilable(
                   Orb::Models::CreditBlockListInvoicesResponse::Block::CreditAllocation
+                ),
+              credit_commitment:
+                T.nilable(
+                  Orb::Models::CreditBlockListInvoicesResponse::Block::CreditCommitment
                 )
             }
           )
@@ -215,7 +249,8 @@ module Orb
         end
 
         # How this credit block was created: `allocation` (a subscription's recurring
-        # credit allocation), `top_up` (an automatic balance-threshold top-up), or
+        # credit allocation), `top_up` (an automatic balance-threshold top-up),
+        # `commitment` (a subscription commitment true-up rolled forward as credit), or
         # `manual` (a manual credit ledger increment, including credits voided or expired
         # off another block).
         module CreditBlockSource
@@ -240,6 +275,11 @@ module Orb
               :top_up,
               Orb::Models::CreditBlockListInvoicesResponse::Block::CreditBlockSource::TaggedSymbol
             )
+          COMMITMENT =
+            T.let(
+              :commitment,
+              Orb::Models::CreditBlockListInvoicesResponse::Block::CreditBlockSource::TaggedSymbol
+            )
           MANUAL =
             T.let(
               :manual,
@@ -686,6 +726,45 @@ module Orb
             end
           end
         end
+
+        class CreditCommitment < Orb::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Orb::Models::CreditBlockListInvoicesResponse::Block::CreditCommitment,
+                Orb::Internal::AnyHash
+              )
+            end
+
+          # The ID of the subscription commitment this block was rolled forward from.
+          sig { returns(String) }
+          attr_accessor :id
+
+          # The subscription the commitment belongs to.
+          sig { returns(T.nilable(String)) }
+          attr_accessor :subscription_id
+
+          # The subscription commitment whose true-up rolled forward into this credit block.
+          # Present only when `credit_block_source` is `commitment`.
+          sig do
+            params(id: String, subscription_id: T.nilable(String)).returns(
+              T.attached_class
+            )
+          end
+          def self.new(
+            # The ID of the subscription commitment this block was rolled forward from.
+            id:,
+            # The subscription the commitment belongs to.
+            subscription_id: nil
+          )
+          end
+
+          sig do
+            override.returns({ id: String, subscription_id: T.nilable(String) })
+          end
+          def to_hash
+          end
+        end
       end
 
       class Invoice < Orb::Internal::Type::BaseModel