stigg 0.1.0.pre.beta.54 → 0.1.0.pre.beta.55

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b656b4ba3fc90ca4486804b4c37637e9468716350c477bc6f5316c2ad696125c
-  data.tar.gz: 904bb67fde8fc93166f60586984d8fa1fc341a4744fb20f27681e1de2bd17b4f
+  metadata.gz: 22ad9d5621e65d220a1610dc9dcf3701d56317fb243354e3ac20b9218793d9a6
+  data.tar.gz: e9cc80ef3ebbc84fb8579ebe7e63dcfaa2d2222955877744bb87af23ce46d38e
 SHA512:
-  metadata.gz: b2c4c488e943c64427f91576620d000470f7b635b17c607ae79270791c8ad7c0da49802513601e255c21fe7d69b340f1174086db4ac6ba4b1ab784afcd2f851a
-  data.tar.gz: df2b4bbf81244e2c668f270859b864f1eab1c77d9c7cfe86c429323e4ab5109eda04248cd3bcd61ac0e8b12e539e04748c4d4347ad2422f99c4c2a20a0e5cfac
+  metadata.gz: 70be9b6e78f9a97c1966d62559d9dbd0dd523359a1b1375b9eca48cbb21ca4476c1d39b83c400813845b530c95e9242003e6ebeac2bd6622a3ed520afd276f1c
+  data.tar.gz: 569fa41d256f010d8e6e0e025924f161d77462bfff09ae1cc5c9dc4fcacaa5bdc8b6fdce72f996e6a5df0e8c134b98d680ec52b82986ca25db33f4e150e86f23

data/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## [0.1.0-beta.55](https://github.com/stiggio/stigg-ruby/compare/v0.1.0-beta.54...v0.1.0-beta.55) (2026-10-15)
+
+
+### Features
+
+* **STIGG-10154:** generate the v2 usage report ([64e8a4d](https://github.com/stiggio/stigg-ruby/commit/64e8a4d06caf1fbcd929a7a17dcdf8a7d3020807))
+
+
+### Bug Fixes
+
+* sync OpenAPI spec from stigg-api ([fcbbfa0](https://github.com/stiggio/stigg-ruby/commit/fcbbfa088bb96e8db3d3ab222a0327cbd496f48d))
+* sync OpenAPI spec from stigg-api ([404305e](https://github.com/stiggio/stigg-ruby/commit/404305e71b4e8a58df318ca9304f70224c7338f3))
+* sync OpenAPI spec from stigg-api ([36888c2](https://github.com/stiggio/stigg-ruby/commit/36888c2b5dee5e5c9b0ce961b4c2c8881fcef60a))
+
+
+### Chores
+
+* normalize version.rb to gem prerelease format for stlc codegen ([5d99ffb](https://github.com/stiggio/stigg-ruby/commit/5d99ffba236fb2e7a68ecf451927b00feefb42b8))
+
 ## [0.1.0-beta.54](https://github.com/stiggio/stigg-ruby/compare/v0.1.0-beta.53...v0.1.0-beta.54) (2026-09-29)
 
 

data/README.md

@@ -24,7 +24,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "stigg", "~> 0.1.0.pre.beta.53"
+gem "stigg", "~> 0.1.0.pre.beta.54"
 ```
 
 <!-- x-release-please-end -->

data/lib/stigg/client.rb

@@ -24,6 +24,9 @@ module Stigg
     # @return [Stigg::Resources::V1Beta]
     attr_reader :v1_beta
 
+    # @return [Stigg::Resources::V2]
+    attr_reader :v2
+
     # @api private
     #
     # @return [Hash{String=>String}]
@@ -85,6 +88,7 @@ module Stigg
 
       @v1 = Stigg::Resources::V1.new(client: self)
       @v1_beta = Stigg::Resources::V1Beta.new(client: self)
+      @v2 = Stigg::Resources::V2.new(client: self)
     end
   end
 end

data/lib/stigg/models/v1/credits/consumption_consume_response.rb

@@ -50,13 +50,23 @@ module Stigg
             #   @return [Stigg::Models::V1::Credits::ConsumptionConsumeResponse::Data::Credit, nil]
             optional :credit, -> { Stigg::Models::V1::Credits::ConsumptionConsumeResponse::Data::Credit }, nil?: true
 
+            # @!attribute entities
+            #   The current usage of each governance entitlement this request counted towards.
+            #   Absent when governance is not enabled or the usage is unknown. Entitlements
+            #   whose usage could not be read, and those of repeated idempotent requests, are
+            #   left out
+            #
+            #   @return [Array<Stigg::Models::V1::Credits::ConsumptionConsumeResponse::Data::Entity>, nil]
+            optional :entities,
+                     -> { Stigg::Internal::Type::ArrayOf[Stigg::Models::V1::Credits::ConsumptionConsumeResponse::Data::Entity] }
+
             # @!attribute resource_id
             #   The resource the consumption was attributed to
             #
             #   @return [String, nil]
             optional :resource_id, String, api_name: :resourceId, nil?: true
 
-            # @!method initialize(amount:, currency_id:, customer_id:, timestamp:, credit: nil, resource_id: nil)
+            # @!method initialize(amount:, currency_id:, customer_id:, timestamp:, credit: nil, entities: nil, resource_id: nil)
             #   Some parameter documentations has been truncated, see
             #   {Stigg::Models::V1::Credits::ConsumptionConsumeResponse::Data} for more details.
             #
@@ -72,6 +82,8 @@ module Stigg
             #
             #   @param credit [Stigg::Models::V1::Credits::ConsumptionConsumeResponse::Data::Credit, nil] The optimistic credit balance after consumption (when sync credit consumption is
             #
+            #   @param entities [Array<Stigg::Models::V1::Credits::ConsumptionConsumeResponse::Data::Entity>] The current usage of each governance entitlement this request counted towards. A
+            #
             #   @param resource_id [String, nil] The resource the consumption was attributed to
 
             # @see Stigg::Models::V1::Credits::ConsumptionConsumeResponse::Data#credit
@@ -129,6 +141,89 @@ module Stigg
               #
               #   @param usage_period_end [Time, nil] End of the current credit grant period (when recurring credits reset), if applic
             end
+
+            class Entity < Stigg::Internal::Type::BaseModel
+              # @!attribute current_usage
+              #   The absolute usage counted against the entitlement
+              #
+              #   @return [Float]
+              required :current_usage, Float, api_name: :currentUsage
+
+              # @!attribute customer_id
+              #   The customer whose usage counted towards the entitlement
+              #
+              #   @return [String]
+              required :customer_id, String, api_name: :customerId
+
+              # @!attribute entitlement_id
+              #   The governance entitlement the usage counts towards
+              #
+              #   @return [String]
+              required :entitlement_id, String, api_name: :entitlementId
+
+              # @!attribute entity_id
+              #   The governance entity the entitlement belongs to
+              #
+              #   @return [String]
+              required :entity_id, String, api_name: :entityId
+
+              # @!attribute resource_id
+              #   The customer resource the usage counted from; `null` for customer-level usage
+              #
+              #   @return [String, nil]
+              required :resource_id, String, api_name: :resourceId, nil?: true
+
+              # @!attribute scope_entity_ids
+              #   The entities the entitlement is scoped to (empty when it is not scoped)
+              #
+              #   @return [Array<String>]
+              required :scope_entity_ids, Stigg::Internal::Type::ArrayOf[String], api_name: :scopeEntityIds
+
+              # @!attribute usage_updated_at
+              #   When the entitlement usage was last updated
+              #
+              #   @return [Time]
+              required :usage_updated_at, Time, api_name: :usageUpdatedAt
+
+              # @!attribute currency_id
+              #   The credit currency the entitlement governs (exactly one of featureId and
+              #   currencyId is set)
+              #
+              #   @return [String, nil]
+              optional :currency_id, String, api_name: :currencyId
+
+              # @!attribute feature_id
+              #   The feature the entitlement governs (exactly one of featureId and currencyId is
+              #   set)
+              #
+              #   @return [String, nil]
+              optional :feature_id, String, api_name: :featureId
+
+              # @!method initialize(current_usage:, customer_id:, entitlement_id:, entity_id:, resource_id:, scope_entity_ids:, usage_updated_at:, currency_id: nil, feature_id: nil)
+              #   Some parameter documentations has been truncated, see
+              #   {Stigg::Models::V1::Credits::ConsumptionConsumeResponse::Data::Entity} for more
+              #   details.
+              #
+              #   The usage counted against one governance entitlement
+              #
+              #   @param current_usage [Float] The absolute usage counted against the entitlement
+              #
+              #   @param customer_id [String] The customer whose usage counted towards the entitlement
+              #
+              #   @param entitlement_id [String] The governance entitlement the usage counts towards
+              #
+              #   @param entity_id [String] The governance entity the entitlement belongs to
+              #
+              #   @param resource_id [String, nil] The customer resource the usage counted from; `null` for customer-level usage
+              #
+              #   @param scope_entity_ids [Array<String>] The entities the entitlement is scoped to (empty when it is not scoped)
+              #
+              #   @param usage_updated_at [Time] When the entitlement usage was last updated
+              #
+              #   @param currency_id [String] The credit currency the entitlement governs (exactly one of featureId and curren
+              #
+              #   @param feature_id [String] The feature the entitlement governs (exactly one of featureId and currencyId is
+            end
           end
         end
       end

data/lib/stigg/models/v1/customer_list_response.rb

@@ -305,6 +305,13 @@ module Stigg
           #   @return [String, nil]
           required :billing_id, String, api_name: :billingId, nil?: true
 
+          # @!attribute card_brand
+          #   The card brand of the default payment method, as reported by the billing
+          #   provider (e.g. visa, mastercard, amex)
+          #
+          #   @return [String, nil]
+          required :card_brand, String, api_name: :cardBrand, nil?: true
+
           # @!attribute card_expiry_month
           #   The expiration month of the default payment method
           #
@@ -331,11 +338,24 @@ module Stigg
                    enum: -> { Stigg::Models::V1::CustomerListResponse::DefaultPaymentMethod::Type },
                    nil?: true
 
-          # @!method initialize(billing_id:, card_expiry_month:, card_expiry_year:, card_last4_digits:, type:)
+          # @!attribute wallet_type
+          #   The digital wallet used to add the default card payment method, as reported by
+          #   the billing provider (e.g. apple_pay, google_pay)
+          #
+          #   @return [String, nil]
+          required :wallet_type, String, api_name: :walletType, nil?: true
+
+          # @!method initialize(billing_id:, card_brand:, card_expiry_month:, card_expiry_year:, card_last4_digits:, type:, wallet_type:)
+          #   Some parameter documentations has been truncated, see
+          #   {Stigg::Models::V1::CustomerListResponse::DefaultPaymentMethod} for more
+          #   details.
+          #
           #   The default payment method details
           #
           #   @param billing_id [String, nil] The default payment method id
           #
+          #   @param card_brand [String, nil] The card brand of the default payment method, as reported by the billing provide
+          #
           #   @param card_expiry_month [Float, nil] The expiration month of the default payment method
           #
           #   @param card_expiry_year [Float, nil] The expiration year of the default payment method
@@ -343,6 +363,8 @@ module Stigg
           #   @param card_last4_digits [String, nil] The last 4 digits of the default payment method
           #
           #   @param type [Symbol, Stigg::Models::V1::CustomerListResponse::DefaultPaymentMethod::Type, nil] The default payment method type
+          #
+          #   @param wallet_type [String, nil] The digital wallet used to add the default card payment method, as reported by t
 
           # The default payment method type
           #

data/lib/stigg/models/v1/customer_response.rb

@@ -318,6 +318,13 @@ module Stigg
             #   @return [String, nil]
             required :billing_id, String, api_name: :billingId, nil?: true
 
+            # @!attribute card_brand
+            #   The card brand of the default payment method, as reported by the billing
+            #   provider (e.g. visa, mastercard, amex)
+            #
+            #   @return [String, nil]
+            required :card_brand, String, api_name: :cardBrand, nil?: true
+
             # @!attribute card_expiry_month
             #   The expiration month of the default payment method
             #
@@ -346,11 +353,24 @@ module Stigg
                      },
                      nil?: true
 
-            # @!method initialize(billing_id:, card_expiry_month:, card_expiry_year:, card_last4_digits:, type:)
+            # @!attribute wallet_type
+            #   The digital wallet used to add the default card payment method, as reported by
+            #   the billing provider (e.g. apple_pay, google_pay)
+            #
+            #   @return [String, nil]
+            required :wallet_type, String, api_name: :walletType, nil?: true
+
+            # @!method initialize(billing_id:, card_brand:, card_expiry_month:, card_expiry_year:, card_last4_digits:, type:, wallet_type:)
+            #   Some parameter documentations has been truncated, see
+            #   {Stigg::Models::V1::CustomerResponse::Data::DefaultPaymentMethod} for more
+            #   details.
+            #
             #   The default payment method details
             #
             #   @param billing_id [String, nil] The default payment method id
             #
+            #   @param card_brand [String, nil] The card brand of the default payment method, as reported by the billing provide
+            #
             #   @param card_expiry_month [Float, nil] The expiration month of the default payment method
             #
             #   @param card_expiry_year [Float, nil] The expiration year of the default payment method
@@ -358,6 +378,8 @@ module Stigg
             #   @param card_last4_digits [String, nil] The last 4 digits of the default payment method
             #
             #   @param type [Symbol, Stigg::Models::V1::CustomerResponse::Data::DefaultPaymentMethod::Type, nil] The default payment method type
+            #
+            #   @param wallet_type [String, nil] The digital wallet used to add the default card payment method, as reported by t
 
             # The default payment method type
             #

data/lib/stigg/models/v2/usage_report_params.rb

@@ -0,0 +1,150 @@
+# frozen_string_literal: true
+
+module Stigg
+  module Models
+    module V2
+      # @see Stigg::Resources::V2::Usage#report
+      class UsageReportParams < Stigg::Internal::Type::BaseModel
+        extend Stigg::Internal::Type::RequestParameters::Converter
+        include Stigg::Internal::Type::RequestParameters
+
+        # @!attribute usages
+        #   A list of usage reports to be submitted in bulk
+        #
+        #   @return [Array<Stigg::Models::V2::UsageReportParams::Usage>]
+        required :usages, -> { Stigg::Internal::Type::ArrayOf[Stigg::V2::UsageReportParams::Usage] }
+
+        # @!attribute x_account_id
+        #
+        #   @return [String, nil]
+        optional :x_account_id, String
+
+        # @!attribute x_environment_id
+        #
+        #   @return [String, nil]
+        optional :x_environment_id, String
+
+        # @!method initialize(usages:, x_account_id: nil, x_environment_id: nil, request_options: {})
+        #   @param usages [Array<Stigg::Models::V2::UsageReportParams::Usage>] A list of usage reports to be submitted in bulk
+        #
+        #   @param x_account_id [String]
+        #
+        #   @param x_environment_id [String]
+        #
+        #   @param request_options [Stigg::RequestOptions, Hash{Symbol=>Object}]
+
+        class Usage < Stigg::Internal::Type::BaseModel
+          # @!attribute customer_id
+          #   Customer id
+          #
+          #   @return [String]
+          required :customer_id, String, api_name: :customerId
+
+          # @!attribute feature_id
+          #   Feature id
+          #
+          #   @return [String]
+          required :feature_id, String, api_name: :featureId
+
+          # @!attribute value
+          #   The value to report for usage. Must be a whole number — the REST API does not
+          #   accept fractional (float) usage values; scale up (e.g. report cents instead of
+          #   dollars, or milliseconds instead of seconds) if you need sub-unit precision.
+          #
+          #   @return [Integer]
+          required :value, Integer
+
+          # @!attribute created_at
+          #   Timestamp of when the record was created
+          #
+          #   @return [Time, nil]
+          optional :created_at, Time, api_name: :createdAt
+
+          # @!attribute dimensions
+          #   Additional dimensions for the usage report
+          #
+          #   @return [Hash{Symbol=>String, Float, Boolean}, nil]
+          optional :dimensions,
+                   -> { Stigg::Internal::Type::HashOf[union: Stigg::V2::UsageReportParams::Usage::Dimension] }
+
+          # @!attribute idempotency_key
+          #   A key you provide to safely retry the same usage report without double-counting
+          #   it. Reports with a previously-seen idempotency key are deduplicated for 7 days;
+          #   after that window a retry is treated as new usage.
+          #
+          #   @return [String, nil]
+          optional :idempotency_key, String, api_name: :idempotencyKey
+
+          # @!attribute resource_id
+          #   The customer resource this usage applies to. Optional — only required if the
+          #   customer has multiple resources (for example, one subscription per workspace or
+          #   site) and usage needs to be tracked separately per resource; omit it to report
+          #   usage at the customer level.
+          #
+          #   @return [String, nil]
+          optional :resource_id, String, api_name: :resourceId, nil?: true
+
+          # @!attribute update_behavior
+          #   How the reported value is applied: DELTA (default) adds it to the feature's
+          #   current usage; SET treats it as the new absolute usage total, and Stigg computes
+          #   the delta internally.
+          #
+          #   @return [Symbol, Stigg::Models::V2::UsageReportParams::Usage::UpdateBehavior, nil]
+          optional :update_behavior,
+                   enum: -> { Stigg::V2::UsageReportParams::Usage::UpdateBehavior },
+                   api_name: :updateBehavior
+
+          # @!method initialize(customer_id:, feature_id:, value:, created_at: nil, dimensions: nil, idempotency_key: nil, resource_id: nil, update_behavior: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Stigg::Models::V2::UsageReportParams::Usage} for more details.
+          #
+          #   Single usage measurement
+          #
+          #   @param customer_id [String] Customer id
+          #
+          #   @param feature_id [String] Feature id
+          #
+          #   @param value [Integer] The value to report for usage. Must be a whole number — the REST API does not ac
+          #
+          #   @param created_at [Time] Timestamp of when the record was created
+          #
+          #   @param dimensions [Hash{Symbol=>String, Float, Boolean}] Additional dimensions for the usage report
+          #
+          #   @param idempotency_key [String] A key you provide to safely retry the same usage report without double-counting
+          #
+          #   @param resource_id [String, nil] The customer resource this usage applies to. Optional — only required if the cus
+          #
+          #   @param update_behavior [Symbol, Stigg::Models::V2::UsageReportParams::Usage::UpdateBehavior] How the reported value is applied: DELTA (default) adds it to the feature's curr
+
+          module Dimension
+            extend Stigg::Internal::Type::Union
+
+            variant String
+
+            variant Float
+
+            variant Stigg::Internal::Type::Boolean
+
+            # @!method self.variants
+            #   @return [Array(String, Float, Boolean)]
+          end
+
+          # How the reported value is applied: DELTA (default) adds it to the feature's
+          # current usage; SET treats it as the new absolute usage total, and Stigg computes
+          # the delta internally.
+          #
+          # @see Stigg::Models::V2::UsageReportParams::Usage#update_behavior
+          module UpdateBehavior
+            extend Stigg::Internal::Type::Enum
+
+            DELTA = :DELTA
+            SET = :SET
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+      end
+    end
+  end
+end