stigg 0.1.0.pre.beta.6 → 0.1.0.pre.beta.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8306af9f56c2866b0124eb07cd3302843917ee34605e8a3e05fd4184f6ec8e2c
-  data.tar.gz: 31872e5d20a38209c1c554a08af61d49326dee4ca86ca95cd663d4ac05992e38
+  metadata.gz: 70f15c897729ecad045000897480e8eb6737149b27d193d81043bf0fb911ce29
+  data.tar.gz: 769b53256d12fb857e847ddbec044e1e8ffb0f6516309091949105f7470617c8
 SHA512:
-  metadata.gz: 1461061f7a986b6070ae919e702152e50dc75bb1adcf893175cc2c5476096334334de5e89eedefe19a78f51f398dd9f2aefcb48efda70da72675201b6f63d969
-  data.tar.gz: 408a782be980012bd23a8a8a2edef308b90a761fa2c57d2007b6cd52d1a7b7ccb47b22a590ad21b8cf6e3e66ca139aaf9944a7fd8939a6ff0dac86d190307bdd
+  metadata.gz: fd0793b0bac6d6fb76e48c484a91d1b987665aac31a4ce5782e02acf94f044ebc50275df08406a33d3c98ab68bda1fd4704fe1c988b36e1f396ee94574dd423f
+  data.tar.gz: 21763c72383e15868a6919d4b4734e623ff1194a7095ab3b12ecd08ac9bd2781cb01c2464d3ed0164ba6f2abd140b239ffd3d86318a8dbd586ec2b0e8cf66678

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 0.1.0-beta.8 (2026-05-25)
+
+Full Changelog: [v0.1.0-beta.7...v0.1.0-beta.8](https://github.com/stiggio/stigg-ruby/compare/v0.1.0-beta.7...v0.1.0-beta.8)
+
+### Features
+
+* **api:** add entities resource with retrieve/list/archive/unarchive/upsert methods ([7ed5106](https://github.com/stiggio/stigg-ruby/commit/7ed5106db56d60583655a9750cf2a3e58c9fb3c7))
+
+## 0.1.0-beta.7 (2026-05-24)
+
+Full Changelog: [v0.1.0-beta.6...v0.1.0-beta.7](https://github.com/stiggio/stigg-ruby/compare/v0.1.0-beta.6...v0.1.0-beta.7)
+
+### Features
+
+* **api:** add entity_types resource with list/upsert to events beta ([0b33857](https://github.com/stiggio/stigg-ruby/commit/0b33857c6a530e5f4508a231d8545f7b2f28a19d))
+
 ## 0.1.0-beta.6 (2026-05-21)
 
 Full Changelog: [v0.1.0-beta.5...v0.1.0-beta.6](https://github.com/stiggio/stigg-ruby/compare/v0.1.0-beta.5...v0.1.0-beta.6)

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.6"
+gem "stigg", "~> 0.1.0.pre.beta.8"
 ```
 
 <!-- x-release-please-end -->

data/lib/stigg/client.rb

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

data/lib/stigg/models/v1_beta/customers/entitlement_check_params.rb

@@ -0,0 +1,79 @@
+# frozen_string_literal: true
+
+module Stigg
+  module Models
+    module V1Beta
+      module Customers
+        # @see Stigg::Resources::V1Beta::Customers::Entitlements#check
+        class EntitlementCheckParams < Stigg::Internal::Type::BaseModel
+          extend Stigg::Internal::Type::RequestParameters::Converter
+          include Stigg::Internal::Type::RequestParameters
+
+          # @!attribute id
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!attribute currency_id
+          #   Currency ID (refId) to check for credit entitlements. Mutually exclusive with
+          #   `featureId`.
+          #
+          #   @return [String, nil]
+          optional :currency_id, String
+
+          # @!attribute dimensions
+          #   Optional attribution map (e.g. `dimensions[userId]=u1`). When provided, the
+          #   response includes a `chains` array with per-entity governance limits.
+          #
+          #   @return [Hash{Symbol=>String}, nil]
+          optional :dimensions, Stigg::Internal::Type::HashOf[String]
+
+          # @!attribute feature_id
+          #   Feature ID (refId) to check. Mutually exclusive with `currencyId`.
+          #
+          #   @return [String, nil]
+          optional :feature_id, String
+
+          # @!attribute requested_usage
+          #   Requested usage amount to evaluate against the entitlement limit (numeric
+          #   features only)
+          #
+          #   @return [Integer, nil]
+          optional :requested_usage, Integer
+
+          # @!attribute requested_values
+          #   Requested values to evaluate against allowed values (enum features only)
+          #
+          #   @return [Array<String>, nil]
+          optional :requested_values, Stigg::Internal::Type::ArrayOf[String]
+
+          # @!attribute resource_id
+          #   Resource ID to scope the entitlement check to a specific resource
+          #
+          #   @return [String, nil]
+          optional :resource_id, String
+
+          # @!method initialize(id:, currency_id: nil, dimensions: nil, feature_id: nil, requested_usage: nil, requested_values: nil, resource_id: nil, request_options: {})
+          #   Some parameter documentations has been truncated, see
+          #   {Stigg::Models::V1Beta::Customers::EntitlementCheckParams} for more details.
+          #
+          #   @param id [String]
+          #
+          #   @param currency_id [String] Currency ID (refId) to check for credit entitlements. Mutually exclusive with `f
+          #
+          #   @param dimensions [Hash{Symbol=>String}] Optional attribution map (e.g. `dimensions[userId]=u1`). When provided, the resp
+          #
+          #   @param feature_id [String] Feature ID (refId) to check. Mutually exclusive with `currencyId`.
+          #
+          #   @param requested_usage [Integer] Requested usage amount to evaluate against the entitlement limit (numeric featur
+          #
+          #   @param requested_values [Array<String>] Requested values to evaluate against allowed values (enum features only)
+          #
+          #   @param resource_id [String] Resource ID to scope the entitlement check to a specific resource
+          #
+          #   @param request_options [Stigg::RequestOptions, Hash{Symbol=>Object}]
+        end
+      end
+    end
+  end
+end

data/lib/stigg/models/v1_beta/customers/entitlement_check_response.rb

@@ -0,0 +1,530 @@
+# frozen_string_literal: true
+
+module Stigg
+  module Models
+    module V1Beta
+      module Customers
+        # @see Stigg::Resources::V1Beta::Customers::Entitlements#check
+        class EntitlementCheckResponse < Stigg::Internal::Type::BaseModel
+          # @!attribute data
+          #   Feature entitlement with optional governance chains attached.
+          #
+          #   @return [Stigg::Models::V1Beta::Customers::EntitlementCheckResponse::Data::Feature, Stigg::Models::V1Beta::Customers::EntitlementCheckResponse::Data::Credit]
+          required :data, union: -> { Stigg::Models::V1Beta::Customers::EntitlementCheckResponse::Data }
+
+          # @!method initialize(data:)
+          #   Response object
+          #
+          #   @param data [Stigg::Models::V1Beta::Customers::EntitlementCheckResponse::Data::Feature, Stigg::Models::V1Beta::Customers::EntitlementCheckResponse::Data::Credit] Feature entitlement with optional governance chains attached.
+
+          # Feature entitlement with optional governance chains attached.
+          #
+          # @see Stigg::Models::V1Beta::Customers::EntitlementCheckResponse#data
+          module Data
+            extend Stigg::Internal::Type::Union
+
+            discriminator :type
+
+            # Feature entitlement with optional governance chains attached.
+            variant :FEATURE, -> { Stigg::Models::V1Beta::Customers::EntitlementCheckResponse::Data::Feature }
+
+            # Credit entitlement with optional governance chains attached.
+            variant :CREDIT, -> { Stigg::Models::V1Beta::Customers::EntitlementCheckResponse::Data::Credit }
+
+            class Feature < Stigg::Internal::Type::BaseModel
+              # @!attribute access_denied_reason
+              #
+              #   @return [Symbol, Stigg::Models::V1Beta::Customers::EntitlementCheckResponse::Data::Feature::AccessDeniedReason, nil]
+              required :access_denied_reason,
+                       enum: -> { Stigg::Models::V1Beta::Customers::EntitlementCheckResponse::Data::Feature::AccessDeniedReason },
+                       api_name: :accessDeniedReason,
+                       nil?: true
+
+              # @!attribute is_granted
+              #
+              #   @return [Boolean]
+              required :is_granted, Stigg::Internal::Type::Boolean, api_name: :isGranted
+
+              # @!attribute type
+              #
+              #   @return [Symbol, :FEATURE]
+              required :type, const: :FEATURE
+
+              # @!attribute chains
+              #   Per-entity rollups, one chain per resolved dimension. Omitted when dimensions
+              #   was not provided.
+              #
+              #   @return [Array<Array<Stigg::Models::V1Beta::Customers::EntitlementCheckResponse::Data::Feature::Chain>>, nil]
+              optional :chains,
+                       -> do
+                         Stigg::Internal::Type::ArrayOf[
+                           Stigg::Internal::Type::ArrayOf[Stigg::Models::V1Beta::Customers::EntitlementCheckResponse::Data::Feature::Chain]
+                         ]
+                       end
+
+              # @!attribute current_usage
+              #
+              #   @return [Float, nil]
+              optional :current_usage, Float, api_name: :currentUsage
+
+              # @!attribute entitlement_updated_at
+              #   Timestamp of the last update to the entitlement grant or configuration.
+              #
+              #   @return [Time, nil]
+              optional :entitlement_updated_at, Time, api_name: :entitlementUpdatedAt
+
+              # @!attribute feature
+              #
+              #   @return [Stigg::Models::V1Beta::Customers::EntitlementCheckResponse::Data::Feature::Feature, nil]
+              optional :feature,
+                       -> { Stigg::Models::V1Beta::Customers::EntitlementCheckResponse::Data::Feature::Feature }
+
+              # @!attribute has_unlimited_usage
+              #
+              #   @return [Boolean, nil]
+              optional :has_unlimited_usage, Stigg::Internal::Type::Boolean, api_name: :hasUnlimitedUsage
+
+              # @!attribute reset_period
+              #
+              #   @return [Symbol, Stigg::Models::V1Beta::Customers::EntitlementCheckResponse::Data::Feature::ResetPeriod, nil]
+              optional :reset_period,
+                       enum: -> { Stigg::Models::V1Beta::Customers::EntitlementCheckResponse::Data::Feature::ResetPeriod },
+                       api_name: :resetPeriod,
+                       nil?: true
+
+              # @!attribute usage_limit
+              #
+              #   @return [Float, nil]
+              optional :usage_limit, Float, api_name: :usageLimit, nil?: true
+
+              # @!attribute usage_period_anchor
+              #   The anchor for calculating the usage period for metered entitlements with a
+              #   reset period configured
+              #
+              #   @return [Time, nil]
+              optional :usage_period_anchor, Time, api_name: :usagePeriodAnchor
+
+              # @!attribute usage_period_end
+              #   The end date of the usage period for metered entitlements with a reset period
+              #   configured
+              #
+              #   @return [Time, nil]
+              optional :usage_period_end, Time, api_name: :usagePeriodEnd
+
+              # @!attribute usage_period_start
+              #   The start date of the usage period for metered entitlements with a reset period
+              #   configured
+              #
+              #   @return [Time, nil]
+              optional :usage_period_start, Time, api_name: :usagePeriodStart
+
+              # @!attribute valid_until
+              #   The next time the entitlement should be recalculated
+              #
+              #   @return [Time, nil]
+              optional :valid_until, Time, api_name: :validUntil
+
+              # @!method initialize(access_denied_reason:, is_granted:, chains: nil, current_usage: nil, entitlement_updated_at: nil, feature: nil, has_unlimited_usage: nil, reset_period: nil, usage_limit: nil, usage_period_anchor: nil, usage_period_end: nil, usage_period_start: nil, valid_until: nil, type: :FEATURE)
+              #   Some parameter documentations has been truncated, see
+              #   {Stigg::Models::V1Beta::Customers::EntitlementCheckResponse::Data::Feature} for
+              #   more details.
+              #
+              #   Feature entitlement with optional governance chains attached.
+              #
+              #   @param access_denied_reason [Symbol, Stigg::Models::V1Beta::Customers::EntitlementCheckResponse::Data::Feature::AccessDeniedReason, nil]
+              #
+              #   @param is_granted [Boolean]
+              #
+              #   @param chains [Array<Array<Stigg::Models::V1Beta::Customers::EntitlementCheckResponse::Data::Feature::Chain>>] Per-entity rollups, one chain per resolved dimension. Omitted when dimensions wa
+              #
+              #   @param current_usage [Float]
+              #
+              #   @param entitlement_updated_at [Time] Timestamp of the last update to the entitlement grant or configuration.
+              #
+              #   @param feature [Stigg::Models::V1Beta::Customers::EntitlementCheckResponse::Data::Feature::Feature]
+              #
+              #   @param has_unlimited_usage [Boolean]
+              #
+              #   @param reset_period [Symbol, Stigg::Models::V1Beta::Customers::EntitlementCheckResponse::Data::Feature::ResetPeriod, nil]
+              #
+              #   @param usage_limit [Float, nil]
+              #
+              #   @param usage_period_anchor [Time] The anchor for calculating the usage period for metered entitlements with a rese
+              #
+              #   @param usage_period_end [Time] The end date of the usage period for metered entitlements with a reset period co
+              #
+              #   @param usage_period_start [Time] The start date of the usage period for metered entitlements with a reset period
+              #
+              #   @param valid_until [Time] The next time the entitlement should be recalculated
+              #
+              #   @param type [Symbol, :FEATURE]
+
+              # @see Stigg::Models::V1Beta::Customers::EntitlementCheckResponse::Data::Feature#access_denied_reason
+              module AccessDeniedReason
+                extend Stigg::Internal::Type::Enum
+
+                FEATURE_NOT_FOUND = :FeatureNotFound
+                CUSTOMER_NOT_FOUND = :CustomerNotFound
+                CUSTOMER_IS_ARCHIVED = :CustomerIsArchived
+                CUSTOMER_RESOURCE_NOT_FOUND = :CustomerResourceNotFound
+                NO_ACTIVE_SUBSCRIPTION = :NoActiveSubscription
+                NO_FEATURE_ENTITLEMENT_IN_SUBSCRIPTION = :NoFeatureEntitlementInSubscription
+                REQUESTED_USAGE_EXCEEDING_LIMIT = :RequestedUsageExceedingLimit
+                REQUESTED_VALUES_MISMATCH = :RequestedValuesMismatch
+                BUDGET_EXCEEDED = :BudgetExceeded
+                UNKNOWN = :Unknown
+                FEATURE_TYPE_MISMATCH = :FeatureTypeMismatch
+                REVOKED = :Revoked
+                INSUFFICIENT_CREDITS = :InsufficientCredits
+                ENTITLEMENT_NOT_FOUND = :EntitlementNotFound
+
+                # @!method self.values
+                #   @return [Array<Symbol>]
+              end
+
+              class Chain < Stigg::Internal::Type::BaseModel
+                # @!attribute current_usage
+                #   Amount consumed by this entity in the current cadence period.
+                #
+                #   @return [Float]
+                required :current_usage, Float, api_name: :currentUsage
+
+                # @!attribute entity_id
+                #   External id of the entity within the customer.
+                #
+                #   @return [String]
+                required :entity_id, String, api_name: :entityId
+
+                # @!attribute is_granted
+                #   Whether this node alone permits the requested usage.
+                #
+                #   @return [Boolean]
+                required :is_granted, Stigg::Internal::Type::Boolean, api_name: :isGranted
+
+                # @!attribute usage_limit
+                #   Hard usage limit for this node; null when no assignment is configured.
+                #
+                #   @return [Float, nil]
+                required :usage_limit, Float, api_name: :usageLimit, nil?: true
+
+                # @!method initialize(current_usage:, entity_id:, is_granted:, usage_limit:)
+                #   Per-entity governance node — limit and current usage for a single resolved
+                #   entity.
+                #
+                #   @param current_usage [Float] Amount consumed by this entity in the current cadence period.
+                #
+                #   @param entity_id [String] External id of the entity within the customer.
+                #
+                #   @param is_granted [Boolean] Whether this node alone permits the requested usage.
+                #
+                #   @param usage_limit [Float, nil] Hard usage limit for this node; null when no assignment is configured.
+              end
+
+              # @see Stigg::Models::V1Beta::Customers::EntitlementCheckResponse::Data::Feature#feature
+              class Feature < Stigg::Internal::Type::BaseModel
+                # @!attribute id
+                #   The unique reference ID of the entitlement.
+                #
+                #   @return [String]
+                required :id, String
+
+                # @!attribute display_name
+                #   The human-readable name of the entitlement, shown in UI elements.
+                #
+                #   @return [String]
+                required :display_name, String, api_name: :displayName
+
+                # @!attribute feature_status
+                #   The current status of the feature.
+                #
+                #   @return [Symbol, Stigg::Models::V1Beta::Customers::EntitlementCheckResponse::Data::Feature::Feature::FeatureStatus]
+                required :feature_status,
+                         enum: -> { Stigg::Models::V1Beta::Customers::EntitlementCheckResponse::Data::Feature::Feature::FeatureStatus },
+                         api_name: :featureStatus
+
+                # @!attribute feature_type
+                #   The type of feature associated with the entitlement.
+                #
+                #   @return [Symbol, Stigg::Models::V1Beta::Customers::EntitlementCheckResponse::Data::Feature::Feature::FeatureType]
+                required :feature_type,
+                         enum: -> { Stigg::Models::V1Beta::Customers::EntitlementCheckResponse::Data::Feature::Feature::FeatureType },
+                         api_name: :featureType
+
+                # @!method initialize(id:, display_name:, feature_status:, feature_type:)
+                #   @param id [String] The unique reference ID of the entitlement.
+                #
+                #   @param display_name [String] The human-readable name of the entitlement, shown in UI elements.
+                #
+                #   @param feature_status [Symbol, Stigg::Models::V1Beta::Customers::EntitlementCheckResponse::Data::Feature::Feature::FeatureStatus] The current status of the feature.
+                #
+                #   @param feature_type [Symbol, Stigg::Models::V1Beta::Customers::EntitlementCheckResponse::Data::Feature::Feature::FeatureType] The type of feature associated with the entitlement.
+
+                # The current status of the feature.
+                #
+                # @see Stigg::Models::V1Beta::Customers::EntitlementCheckResponse::Data::Feature::Feature#feature_status
+                module FeatureStatus
+                  extend Stigg::Internal::Type::Enum
+
+                  NEW = :NEW
+                  SUSPENDED = :SUSPENDED
+                  ACTIVE = :ACTIVE
+
+                  # @!method self.values
+                  #   @return [Array<Symbol>]
+                end
+
+                # The type of feature associated with the entitlement.
+                #
+                # @see Stigg::Models::V1Beta::Customers::EntitlementCheckResponse::Data::Feature::Feature#feature_type
+                module FeatureType
+                  extend Stigg::Internal::Type::Enum
+
+                  BOOLEAN = :BOOLEAN
+                  NUMBER = :NUMBER
+                  ENUM = :ENUM
+
+                  # @!method self.values
+                  #   @return [Array<Symbol>]
+                end
+              end
+
+              # @see Stigg::Models::V1Beta::Customers::EntitlementCheckResponse::Data::Feature#reset_period
+              module ResetPeriod
+                extend Stigg::Internal::Type::Enum
+
+                YEAR = :YEAR
+                MONTH = :MONTH
+                WEEK = :WEEK
+                DAY = :DAY
+                HOUR = :HOUR
+
+                # @!method self.values
+                #   @return [Array<Symbol>]
+              end
+            end
+
+            class Credit < Stigg::Internal::Type::BaseModel
+              # @!attribute access_denied_reason
+              #
+              #   @return [Symbol, Stigg::Models::V1Beta::Customers::EntitlementCheckResponse::Data::Credit::AccessDeniedReason, nil]
+              required :access_denied_reason,
+                       enum: -> { Stigg::Models::V1Beta::Customers::EntitlementCheckResponse::Data::Credit::AccessDeniedReason },
+                       api_name: :accessDeniedReason,
+                       nil?: true
+
+              # @!attribute currency
+              #   The currency associated with a credit entitlement.
+              #
+              #   @return [Stigg::Models::V1Beta::Customers::EntitlementCheckResponse::Data::Credit::Currency]
+              required :currency,
+                       -> { Stigg::Models::V1Beta::Customers::EntitlementCheckResponse::Data::Credit::Currency }
+
+              # @!attribute current_usage
+              #
+              #   @return [Float]
+              required :current_usage, Float, api_name: :currentUsage
+
+              # @!attribute is_granted
+              #
+              #   @return [Boolean]
+              required :is_granted, Stigg::Internal::Type::Boolean, api_name: :isGranted
+
+              # @!attribute type
+              #
+              #   @return [Symbol, :CREDIT]
+              required :type, const: :CREDIT
+
+              # @!attribute usage_limit
+              #
+              #   @return [Float]
+              required :usage_limit, Float, api_name: :usageLimit
+
+              # @!attribute usage_updated_at
+              #   Timestamp of the last update to the credit usage.
+              #
+              #   @return [Time]
+              required :usage_updated_at, Time, api_name: :usageUpdatedAt
+
+              # @!attribute chains
+              #   Per-entity rollups, one chain per resolved dimension. Omitted when dimensions
+              #   was not provided.
+              #
+              #   @return [Array<Array<Stigg::Models::V1Beta::Customers::EntitlementCheckResponse::Data::Credit::Chain>>, nil]
+              optional :chains,
+                       -> do
+                         Stigg::Internal::Type::ArrayOf[
+                           Stigg::Internal::Type::ArrayOf[Stigg::Models::V1Beta::Customers::EntitlementCheckResponse::Data::Credit::Chain]
+                         ]
+                       end
+
+              # @!attribute entitlement_updated_at
+              #   Timestamp of the last update to the entitlement grant or configuration.
+              #
+              #   @return [Time, nil]
+              optional :entitlement_updated_at, Time, api_name: :entitlementUpdatedAt
+
+              # @!attribute usage_period_end
+              #   The end date of the current billing period for recurring credit grants.
+              #
+              #   @return [Time, nil]
+              optional :usage_period_end, Time, api_name: :usagePeriodEnd
+
+              # @!attribute valid_until
+              #   The next time the entitlement should be recalculated
+              #
+              #   @return [Time, nil]
+              optional :valid_until, Time, api_name: :validUntil
+
+              # @!method initialize(access_denied_reason:, currency:, current_usage:, is_granted:, usage_limit:, usage_updated_at:, chains: nil, entitlement_updated_at: nil, usage_period_end: nil, valid_until: nil, type: :CREDIT)
+              #   Some parameter documentations has been truncated, see
+              #   {Stigg::Models::V1Beta::Customers::EntitlementCheckResponse::Data::Credit} for
+              #   more details.
+              #
+              #   Credit entitlement with optional governance chains attached.
+              #
+              #   @param access_denied_reason [Symbol, Stigg::Models::V1Beta::Customers::EntitlementCheckResponse::Data::Credit::AccessDeniedReason, nil]
+              #
+              #   @param currency [Stigg::Models::V1Beta::Customers::EntitlementCheckResponse::Data::Credit::Currency] The currency associated with a credit entitlement.
+              #
+              #   @param current_usage [Float]
+              #
+              #   @param is_granted [Boolean]
+              #
+              #   @param usage_limit [Float]
+              #
+              #   @param usage_updated_at [Time] Timestamp of the last update to the credit usage.
+              #
+              #   @param chains [Array<Array<Stigg::Models::V1Beta::Customers::EntitlementCheckResponse::Data::Credit::Chain>>] Per-entity rollups, one chain per resolved dimension. Omitted when dimensions wa
+              #
+              #   @param entitlement_updated_at [Time] Timestamp of the last update to the entitlement grant or configuration.
+              #
+              #   @param usage_period_end [Time] The end date of the current billing period for recurring credit grants.
+              #
+              #   @param valid_until [Time] The next time the entitlement should be recalculated
+              #
+              #   @param type [Symbol, :CREDIT]
+
+              # @see Stigg::Models::V1Beta::Customers::EntitlementCheckResponse::Data::Credit#access_denied_reason
+              module AccessDeniedReason
+                extend Stigg::Internal::Type::Enum
+
+                FEATURE_NOT_FOUND = :FeatureNotFound
+                CUSTOMER_NOT_FOUND = :CustomerNotFound
+                CUSTOMER_IS_ARCHIVED = :CustomerIsArchived
+                CUSTOMER_RESOURCE_NOT_FOUND = :CustomerResourceNotFound
+                NO_ACTIVE_SUBSCRIPTION = :NoActiveSubscription
+                NO_FEATURE_ENTITLEMENT_IN_SUBSCRIPTION = :NoFeatureEntitlementInSubscription
+                REQUESTED_USAGE_EXCEEDING_LIMIT = :RequestedUsageExceedingLimit
+                REQUESTED_VALUES_MISMATCH = :RequestedValuesMismatch
+                BUDGET_EXCEEDED = :BudgetExceeded
+                UNKNOWN = :Unknown
+                FEATURE_TYPE_MISMATCH = :FeatureTypeMismatch
+                REVOKED = :Revoked
+                INSUFFICIENT_CREDITS = :InsufficientCredits
+                ENTITLEMENT_NOT_FOUND = :EntitlementNotFound
+
+                # @!method self.values
+                #   @return [Array<Symbol>]
+              end
+
+              # @see Stigg::Models::V1Beta::Customers::EntitlementCheckResponse::Data::Credit#currency
+              class Currency < Stigg::Internal::Type::BaseModel
+                # @!attribute currency_id
+                #   The unique identifier of the custom currency.
+                #
+                #   @return [String]
+                required :currency_id, String, api_name: :currencyId
+
+                # @!attribute display_name
+                #   The display name of the currency.
+                #
+                #   @return [String]
+                required :display_name, String, api_name: :displayName
+
+                # @!attribute description
+                #   A description of the currency.
+                #
+                #   @return [String, nil]
+                optional :description, String, nil?: true
+
+                # @!attribute metadata
+                #   Additional metadata associated with the currency.
+                #
+                #   @return [Hash{Symbol=>String}, nil]
+                optional :metadata, Stigg::Internal::Type::HashOf[String], nil?: true
+
+                # @!attribute unit_plural
+                #   The plural form of the currency unit.
+                #
+                #   @return [String, nil]
+                optional :unit_plural, String, api_name: :unitPlural, nil?: true
+
+                # @!attribute unit_singular
+                #   The singular form of the currency unit.
+                #
+                #   @return [String, nil]
+                optional :unit_singular, String, api_name: :unitSingular, nil?: true
+
+                # @!method initialize(currency_id:, display_name:, description: nil, metadata: nil, unit_plural: nil, unit_singular: nil)
+                #   The currency associated with a credit entitlement.
+                #
+                #   @param currency_id [String] The unique identifier of the custom currency.
+                #
+                #   @param display_name [String] The display name of the currency.
+                #
+                #   @param description [String, nil] A description of the currency.
+                #
+                #   @param metadata [Hash{Symbol=>String}, nil] Additional metadata associated with the currency.
+                #
+                #   @param unit_plural [String, nil] The plural form of the currency unit.
+                #
+                #   @param unit_singular [String, nil] The singular form of the currency unit.
+              end
+
+              class Chain < Stigg::Internal::Type::BaseModel
+                # @!attribute current_usage
+                #   Amount consumed by this entity in the current cadence period.
+                #
+                #   @return [Float]
+                required :current_usage, Float, api_name: :currentUsage
+
+                # @!attribute entity_id
+                #   External id of the entity within the customer.
+                #
+                #   @return [String]
+                required :entity_id, String, api_name: :entityId
+
+                # @!attribute is_granted
+                #   Whether this node alone permits the requested usage.
+                #
+                #   @return [Boolean]
+                required :is_granted, Stigg::Internal::Type::Boolean, api_name: :isGranted
+
+                # @!attribute usage_limit
+                #   Hard usage limit for this node; null when no assignment is configured.
+                #
+                #   @return [Float, nil]
+                required :usage_limit, Float, api_name: :usageLimit, nil?: true
+
+                # @!method initialize(current_usage:, entity_id:, is_granted:, usage_limit:)
+                #   Per-entity governance node — limit and current usage for a single resolved
+                #   entity.
+                #
+                #   @param current_usage [Float] Amount consumed by this entity in the current cadence period.
+                #
+                #   @param entity_id [String] External id of the entity within the customer.
+                #
+                #   @param is_granted [Boolean] Whether this node alone permits the requested usage.
+                #
+                #   @param usage_limit [Float, nil] Hard usage limit for this node; null when no assignment is configured.
+              end
+            end
+
+            # @!method self.variants
+            #   @return [Array(Stigg::Models::V1Beta::Customers::EntitlementCheckResponse::Data::Feature, Stigg::Models::V1Beta::Customers::EntitlementCheckResponse::Data::Credit)]
+          end
+        end
+      end
+    end
+  end
+end