stigg 0.1.0.pre.alpha.31 → 0.1.0.pre.alpha.32

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1f76677364b48fa19978b6c1be54ce03e13b82eed41369b2f464afb9b702cb18
-  data.tar.gz: cff78ceace6922608322816eda5180687139d9259e5ac9d1eae15e8a3d2ba6a7
+  metadata.gz: 1970872531257b548e6bc9d969c71559ccff3069ed072a557c6f889f04f2bf6f
+  data.tar.gz: ff0dbeaec065ffa03567b2d51146b431ecb95887980cd7d3200a8134fe822c2b
 SHA512:
-  metadata.gz: 988742a7d39b4841dd00dc4d4501a359f1ad8017a0934be4961dbe9e8dbd90a9e6aa714a05e3bff8f6db321385ea183a0eb107637bdca4f32543d3fae9d6be32
-  data.tar.gz: 04be3076ce1c92172b63e2394073c25b2022b2fd27574073beb1f600c2b8a4eab9bb2ce896ddf22229222220b8b89a364096950b6a481c7021edbe97fbe5a83d
+  metadata.gz: 97211f61f9da955119dd1d8802244c12105db6795f092018782a955e73d5ba4ddd4bd30d3d516160b1cb0a3a5e4e269525872aeb03e0c1676f3f040797de715e
+  data.tar.gz: 7b2cfa97d3b7251232c3de69f37b7c0dafd5b5a8f930b48e24f504a3511fccabb77a13641ef292876de8b445c8d1d9f07b0952220fef645ead16fd7c42b567b2

data/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 0.1.0-alpha.32 (2026-05-06)
+
+Full Changelog: [v0.1.0-alpha.31...v0.1.0-alpha.32](https://github.com/stiggio/stigg-ruby/compare/v0.1.0-alpha.31...v0.1.0-alpha.32)
+
+### Features
+
+* **api:** add check_entitlement method to customers ([9674756](https://github.com/stiggio/stigg-ruby/commit/9674756aad61c7a93dc4eb27947563c35eec46a5))
+
+
+### Chores
+
+* **internal:** regenerate SDK with no functional changes ([c50162d](https://github.com/stiggio/stigg-ruby/commit/c50162dea06451169a1edede170c995999c6d4fb))
+
 ## 0.1.0-alpha.31 (2026-04-29)
 
 Full Changelog: [v0.1.0-alpha.30...v0.1.0-alpha.31](https://github.com/stiggio/stigg-ruby/compare/v0.1.0-alpha.30...v0.1.0-alpha.31)

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.alpha.31"
+gem "stigg", "~> 0.1.0.pre.alpha.32"
 ```
 
 <!-- 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::Internal]
+    attr_reader :internal
+
     # @api private
     #
     # @return [Hash{String=>String}]
@@ -81,6 +84,7 @@ module Stigg
       )
 
       @v1 = Stigg::Resources::V1.new(client: self)
+      @internal = Stigg::Resources::Internal.new(client: self)
     end
   end
 end

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

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+module Stigg
+  module Models
+    module V1
+      # @see Stigg::Resources::V1::Customers#check_entitlement
+      class CustomerCheckEntitlementParams < 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 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, feature_id: nil, requested_usage: nil, requested_values: nil, resource_id: nil, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Stigg::Models::V1::CustomerCheckEntitlementParams} for more details.
+        #
+        #   @param id [String]
+        #
+        #   @param currency_id [String] Currency ID (refId) to check for credit entitlements. Mutually exclusive with `f
+        #
+        #   @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

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

@@ -0,0 +1,409 @@
+# frozen_string_literal: true
+
+module Stigg
+  module Models
+    module V1
+      # @see Stigg::Resources::V1::Customers#check_entitlement
+      class CustomerCheckEntitlementResponse < Stigg::Internal::Type::BaseModel
+        # @!attribute data
+        #
+        #   @return [Stigg::Models::V1::CustomerCheckEntitlementResponse::Data::Feature, Stigg::Models::V1::CustomerCheckEntitlementResponse::Data::Credit]
+        required :data, union: -> { Stigg::Models::V1::CustomerCheckEntitlementResponse::Data }
+
+        # @!method initialize(data:)
+        #   Response object
+        #
+        #   @param data [Stigg::Models::V1::CustomerCheckEntitlementResponse::Data::Feature, Stigg::Models::V1::CustomerCheckEntitlementResponse::Data::Credit]
+
+        # @see Stigg::Models::V1::CustomerCheckEntitlementResponse#data
+        module Data
+          extend Stigg::Internal::Type::Union
+
+          discriminator :type
+
+          variant :FEATURE, -> { Stigg::Models::V1::CustomerCheckEntitlementResponse::Data::Feature }
+
+          variant :CREDIT, -> { Stigg::Models::V1::CustomerCheckEntitlementResponse::Data::Credit }
+
+          class Feature < Stigg::Internal::Type::BaseModel
+            # @!attribute access_denied_reason
+            #
+            #   @return [Symbol, Stigg::Models::V1::CustomerCheckEntitlementResponse::Data::Feature::AccessDeniedReason, nil]
+            required :access_denied_reason,
+                     enum: -> { Stigg::Models::V1::CustomerCheckEntitlementResponse::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 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::V1::CustomerCheckEntitlementResponse::Data::Feature::Feature, nil]
+            optional :feature, -> { Stigg::Models::V1::CustomerCheckEntitlementResponse::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::V1::CustomerCheckEntitlementResponse::Data::Feature::ResetPeriod, nil]
+            optional :reset_period,
+                     enum: -> { Stigg::Models::V1::CustomerCheckEntitlementResponse::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:, 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::V1::CustomerCheckEntitlementResponse::Data::Feature} for more
+            #   details.
+            #
+            #   @param access_denied_reason [Symbol, Stigg::Models::V1::CustomerCheckEntitlementResponse::Data::Feature::AccessDeniedReason, nil]
+            #
+            #   @param is_granted [Boolean]
+            #
+            #   @param current_usage [Float]
+            #
+            #   @param entitlement_updated_at [Time] Timestamp of the last update to the entitlement grant or configuration.
+            #
+            #   @param feature [Stigg::Models::V1::CustomerCheckEntitlementResponse::Data::Feature::Feature]
+            #
+            #   @param has_unlimited_usage [Boolean]
+            #
+            #   @param reset_period [Symbol, Stigg::Models::V1::CustomerCheckEntitlementResponse::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::V1::CustomerCheckEntitlementResponse::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
+
+            # @see Stigg::Models::V1::CustomerCheckEntitlementResponse::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::V1::CustomerCheckEntitlementResponse::Data::Feature::Feature::FeatureStatus]
+              required :feature_status,
+                       enum: -> { Stigg::Models::V1::CustomerCheckEntitlementResponse::Data::Feature::Feature::FeatureStatus },
+                       api_name: :featureStatus
+
+              # @!attribute feature_type
+              #   The type of feature associated with the entitlement.
+              #
+              #   @return [Symbol, Stigg::Models::V1::CustomerCheckEntitlementResponse::Data::Feature::Feature::FeatureType]
+              required :feature_type,
+                       enum: -> { Stigg::Models::V1::CustomerCheckEntitlementResponse::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::V1::CustomerCheckEntitlementResponse::Data::Feature::Feature::FeatureStatus] The current status of the feature.
+              #
+              #   @param feature_type [Symbol, Stigg::Models::V1::CustomerCheckEntitlementResponse::Data::Feature::Feature::FeatureType] The type of feature associated with the entitlement.
+
+              # The current status of the feature.
+              #
+              # @see Stigg::Models::V1::CustomerCheckEntitlementResponse::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::V1::CustomerCheckEntitlementResponse::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::V1::CustomerCheckEntitlementResponse::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::V1::CustomerCheckEntitlementResponse::Data::Credit::AccessDeniedReason, nil]
+            required :access_denied_reason,
+                     enum: -> { Stigg::Models::V1::CustomerCheckEntitlementResponse::Data::Credit::AccessDeniedReason },
+                     api_name: :accessDeniedReason,
+                     nil?: true
+
+            # @!attribute currency
+            #   The currency associated with a credit entitlement.
+            #
+            #   @return [Stigg::Models::V1::CustomerCheckEntitlementResponse::Data::Credit::Currency]
+            required :currency, -> { Stigg::Models::V1::CustomerCheckEntitlementResponse::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 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:, entitlement_updated_at: nil, usage_period_end: nil, valid_until: nil, type: :CREDIT)
+            #   @param access_denied_reason [Symbol, Stigg::Models::V1::CustomerCheckEntitlementResponse::Data::Credit::AccessDeniedReason, nil]
+            #
+            #   @param currency [Stigg::Models::V1::CustomerCheckEntitlementResponse::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 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::V1::CustomerCheckEntitlementResponse::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::V1::CustomerCheckEntitlementResponse::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
+          end
+
+          # @!method self.variants
+          #   @return [Array(Stigg::Models::V1::CustomerCheckEntitlementResponse::Data::Feature, Stigg::Models::V1::CustomerCheckEntitlementResponse::Data::Credit)]
+        end
+      end
+    end
+  end
+end

data/lib/stigg/resources/internal/beta/event_queues.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Stigg
+  module Resources
+    class Internal
+      class Beta
+        class EventQueues
+          # @api private
+          #
+          # @param client [Stigg::Client]
+          def initialize(client:)
+            @client = client
+          end
+        end
+      end
+    end
+  end
+end

data/lib/stigg/resources/internal/beta.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Stigg
+  module Resources
+    class Internal
+      class Beta
+        # @return [Stigg::Resources::Internal::Beta::EventQueues]
+        attr_reader :event_queues
+
+        # @api private
+        #
+        # @param client [Stigg::Client]
+        def initialize(client:)
+          @client = client
+          @event_queues = Stigg::Resources::Internal::Beta::EventQueues.new(client: client)
+        end
+      end
+    end
+  end
+end

data/lib/stigg/resources/internal.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Stigg
+  module Resources
+    class Internal
+      # @return [Stigg::Resources::Internal::Beta]
+      attr_reader :beta
+
+      # @api private
+      #
+      # @param client [Stigg::Client]
+      def initialize(client:)
+        @client = client
+        @beta = Stigg::Resources::Internal::Beta.new(client: client)
+      end
+    end
+  end
+end

data/lib/stigg/resources/v1/customers.rb

@@ -134,6 +134,55 @@ module Stigg
           )
         end
 
+        # Some parameter documentations has been truncated, see
+        # {Stigg::Models::V1::CustomerCheckEntitlementParams} for more details.
+        #
+        # Checks a single entitlement (feature or credit) for a customer or resource.
+        # Supports `requestedUsage` and `requestedValues` to evaluate against limits or
+        # enum values.
+        #
+        # **Warning:** This REST API endpoint lacks built-in client-side caching, fallback
+        # mechanisms, and low-latency guarantees. It is not recommended for hot-path
+        # entitlement checks. For production use, consider using the Stigg Node Server SDK
+        # with caching or the Sidecar for low-latency cached responses.
+        #
+        # @overload check_entitlement(id, currency_id: nil, feature_id: nil, requested_usage: nil, requested_values: nil, resource_id: nil, request_options: {})
+        #
+        # @param id [String] The unique identifier of the entity
+        #
+        # @param currency_id [String] Currency ID (refId) to check for credit entitlements. Mutually exclusive with `f
+        #
+        # @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}, nil]
+        #
+        # @return [Stigg::Models::V1::CustomerCheckEntitlementResponse]
+        #
+        # @see Stigg::Models::V1::CustomerCheckEntitlementParams
+        def check_entitlement(id, params = {})
+          parsed, options = Stigg::V1::CustomerCheckEntitlementParams.dump_request(params)
+          query = Stigg::Internal::Util.encode_query_params(parsed)
+          @client.request(
+            method: :get,
+            path: ["api/v1/customers/%1$s/entitlements/check", id],
+            query: query.transform_keys(
+              currency_id: "currencyId",
+              feature_id: "featureId",
+              requested_usage: "requestedUsage",
+              requested_values: "requestedValues",
+              resource_id: "resourceId"
+            ),
+            model: Stigg::Models::V1::CustomerCheckEntitlementResponse,
+            options: options
+          )
+        end
+
         # Imports multiple customers in bulk. Used for migrating customer data from
         # external systems.
         #

data/lib/stigg/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Stigg
-  VERSION = "0.1.0.pre.alpha.31"
+  VERSION = "0.1.0.pre.alpha.32"
 end

data/lib/stigg.rb

@@ -80,6 +80,8 @@ require_relative "stigg/models/v1/coupon_list_response"
 require_relative "stigg/models/v1/coupon_retrieve_params"
 require_relative "stigg/models/v1/coupon_update_coupon_params"
 require_relative "stigg/models/v1/customer_archive_params"
+require_relative "stigg/models/v1/customer_check_entitlement_params"
+require_relative "stigg/models/v1/customer_check_entitlement_response"
 require_relative "stigg/models/v1/customer_import_params"
 require_relative "stigg/models/v1/customer_import_response"
 require_relative "stigg/models/v1/customer_integration_response"
@@ -185,6 +187,9 @@ require_relative "stigg/models/v1/usage_history_response"
 require_relative "stigg/models/v1/usage_report_params"
 require_relative "stigg/models/v1/usage_report_response"
 require_relative "stigg/models"
+require_relative "stigg/resources/internal"
+require_relative "stigg/resources/internal/beta"
+require_relative "stigg/resources/internal/beta/event_queues"
 require_relative "stigg/resources/v1"
 require_relative "stigg/resources/v1/addons"
 require_relative "stigg/resources/v1/addons/entitlements"