stigg 0.1.0.pre.beta.14 → 0.1.0.pre.beta.15

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c9117206db59896a0717cd20a4eba11f6178ae050b00f11f79e889f11ce708f7
-  data.tar.gz: '091e774e5a22d91c076061a5fb19651b0a09dd5447a8e818488d0e0c498d1ca0'
+  metadata.gz: b18ddc978487c294f6f5084fc93cd48e74274aaa076fe1880e21b77fb6c279c9
+  data.tar.gz: 76d23067795110fd6f35bac6e44b2b2b05e3ed25b845e0c8375d09105d24aa55
 SHA512:
-  metadata.gz: 4d4a3bd930aaca2cdfdae184318b72816406aa7bde3ccc7bad47cb9851bd446f045bad7641c282b23715c3382d743151a687f73fa0211e8417d617ae5ac30def
-  data.tar.gz: 985d39d4b28c08dd916d032939ec1b8ca31ac52d27ed7a52b290d7d3269a0782c0fc2967a896e5278d4a71ebf6eb3d5e5600468d146b8cd46af4f4c03aaa7cda
+  metadata.gz: e2d17c42187c79fab8a11500e3b361ae75e8033ee68890a77a0a5080a827796cdb92ee5df6ae9792a3b99c9856c552c5d9643d84e37f23e3aa334746f840f18a
+  data.tar.gz: cfad2d0da8535998a4b1b0cd0c125e136a51b3a4df8e6e127f92132452c66088153be43acd4c48e7d27f5acb92413413e2efff215421d96afa5d2c00b689dfff

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.1.0-beta.15 (2026-06-02)
+
+Full Changelog: [v0.1.0-beta.14...v0.1.0-beta.15](https://github.com/stiggio/stigg-ruby/compare/v0.1.0-beta.14...v0.1.0-beta.15)
+
+### Features
+
+* **api:** add pagination to credits get_usage method ([9c116ed](https://github.com/stiggio/stigg-ruby/commit/9c116edfec5202435552f5cb746cc63217051ef2))
+
 ## 0.1.0-beta.14 (2026-06-02)
 
 Full Changelog: [v0.1.0-beta.13...v0.1.0-beta.14](https://github.com/stiggio/stigg-ruby/compare/v0.1.0-beta.13...v0.1.0-beta.14)

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

data/lib/stigg/client.rb

@@ -21,9 +21,6 @@ module Stigg
     # @return [Stigg::Resources::V1]
     attr_reader :v1
 
-    # @return [Stigg::Resources::V1Beta]
-    attr_reader :v1_beta
-
     # @api private
     #
     # @return [Hash{String=>String}]
@@ -84,7 +81,6 @@ 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/credit_get_usage_params.rb

@@ -14,6 +14,18 @@ module Stigg
         #   @return [String]
         required :customer_id, String
 
+        # @!attribute after
+        #   Return items that come after this cursor
+        #
+        #   @return [String, nil]
+        optional :after, String
+
+        # @!attribute before
+        #   Return items that come before this cursor
+        #
+        #   @return [String, nil]
+        optional :before, String
+
         # @!attribute currency_id
         #   Filter by currency ID
         #
@@ -34,6 +46,12 @@ module Stigg
         #   @return [String, nil]
         optional :group_by, String
 
+        # @!attribute limit
+        #   Maximum number of items to return
+        #
+        #   @return [Integer, nil]
+        optional :limit, Integer
+
         # @!attribute resource_id
         #   Filter by resource ID
         #
@@ -54,18 +72,24 @@ module Stigg
         #   @return [Symbol, Stigg::Models::V1::CreditGetUsageParams::TimeRange, nil]
         optional :time_range, enum: -> { Stigg::V1::CreditGetUsageParams::TimeRange }
 
-        # @!method initialize(customer_id:, currency_id: nil, end_date: nil, group_by: nil, resource_id: nil, start_date: nil, time_range: nil, request_options: {})
+        # @!method initialize(customer_id:, after: nil, before: nil, currency_id: nil, end_date: nil, group_by: nil, limit: nil, resource_id: nil, start_date: nil, time_range: nil, request_options: {})
         #   Some parameter documentations has been truncated, see
         #   {Stigg::Models::V1::CreditGetUsageParams} for more details.
         #
         #   @param customer_id [String] Filter by customer ID (required)
         #
+        #   @param after [String] Return items that come after this cursor
+        #
+        #   @param before [String] Return items that come before this cursor
+        #
         #   @param currency_id [String] Filter by currency ID
         #
         #   @param end_date [Time] End date for the credit usage time range (ISO 8601). Defaults to now when startD
         #
         #   @param group_by [String] Comma-separated list of feature dimension keys to group usage series by (up to 3
         #
+        #   @param limit [Integer] Maximum number of items to return
+        #
         #   @param resource_id [String] Filter by resource ID
         #
         #   @param start_date [Time] Start date for the credit usage time range (ISO 8601). Takes precedence over tim

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

@@ -24,6 +24,14 @@ module Stigg
           #   @return [Stigg::Models::V1::CreditGetUsageResponse::Data::Currency, nil]
           required :currency, -> { Stigg::Models::V1::CreditGetUsageResponse::Data::Currency }, nil?: true
 
+          # @!attribute pagination
+          #   Cursor-based pagination for the returned series. `next`/`prev` are opaque
+          #   cursors; pass them back as `after`/`before` to traverse pages. The series axis
+          #   is `groupBy` when provided, otherwise `featureId`
+          #
+          #   @return [Stigg::Models::V1::CreditGetUsageResponse::Data::Pagination]
+          required :pagination, -> { Stigg::Models::V1::CreditGetUsageResponse::Data::Pagination }
+
           # @!attribute series
           #   Credit usage series grouped by feature
           #
@@ -31,11 +39,16 @@ module Stigg
           required :series,
                    -> { Stigg::Internal::Type::ArrayOf[Stigg::Models::V1::CreditGetUsageResponse::Data::Series] }
 
-          # @!method initialize(currency:, series:)
+          # @!method initialize(currency:, pagination:, series:)
+          #   Some parameter documentations has been truncated, see
+          #   {Stigg::Models::V1::CreditGetUsageResponse::Data} for more details.
+          #
           #   Credit usage data grouped by feature with time-series points
           #
           #   @param currency [Stigg::Models::V1::CreditGetUsageResponse::Data::Currency, nil] The custom currency used for credit measurement
           #
+          #   @param pagination [Stigg::Models::V1::CreditGetUsageResponse::Data::Pagination] Cursor-based pagination for the returned series. `next`/`prev` are opaque cursor
+          #
           #   @param series [Array<Stigg::Models::V1::CreditGetUsageResponse::Data::Series>] Credit usage series grouped by feature
 
           # @see Stigg::Models::V1::CreditGetUsageResponse::Data#currency
@@ -84,6 +97,34 @@ module Stigg
             #   @param symbol [String, nil] The currency symbol
           end
 
+          # @see Stigg::Models::V1::CreditGetUsageResponse::Data#pagination
+          class Pagination < Stigg::Internal::Type::BaseModel
+            # @!attribute next_
+            #   Cursor for fetching the next page of results, or null if no additional pages
+            #   exist
+            #
+            #   @return [String, nil]
+            required :next_, String, api_name: :next, nil?: true
+
+            # @!attribute prev
+            #   Cursor for fetching the previous page of results, or null if at the beginning
+            #
+            #   @return [String, nil]
+            required :prev, String, nil?: true
+
+            # @!method initialize(next_:, prev:)
+            #   Some parameter documentations has been truncated, see
+            #   {Stigg::Models::V1::CreditGetUsageResponse::Data::Pagination} for more details.
+            #
+            #   Cursor-based pagination for the returned series. `next`/`prev` are opaque
+            #   cursors; pass them back as `after`/`before` to traverse pages. The series axis
+            #   is `groupBy` when provided, otherwise `featureId`
+            #
+            #   @param next_ [String, nil] Cursor for fetching the next page of results, or null if no additional pages exi
+            #
+            #   @param prev [String, nil] Cursor for fetching the previous page of results, or null if at the beginning
+          end
+
           class Series < Stigg::Internal::Type::BaseModel
             # @!attribute feature_id
             #   The feature ID; null when grouping by dimensions only

data/lib/stigg/models/v1/events/beta/customers/assignment_list_params.rb

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+module Stigg
+  module Models
+    module V1
+      module Events
+        module Beta
+          module Customers
+            # @see Stigg::Resources::V1::Events::Beta::Customers::Assignments#list
+            class AssignmentListParams < Stigg::Internal::Type::BaseModel
+              extend Stigg::Internal::Type::RequestParameters::Converter
+              include Stigg::Internal::Type::RequestParameters
+
+              # @!attribute id
+              #
+              #   @return [String]
+              required :id, String
+
+              # @!attribute after
+              #   Return items that come after this cursor
+              #
+              #   @return [String, nil]
+              optional :after, String
+
+              # @!attribute before
+              #   Return items that come before this cursor
+              #
+              #   @return [String, nil]
+              optional :before, String
+
+              # @!attribute capability_id
+              #   Filter assignments to a specific capability refId
+              #
+              #   @return [String, nil]
+              optional :capability_id, String
+
+              # @!attribute entity_id
+              #   Filter assignments to a specific entity refId
+              #
+              #   @return [String, nil]
+              optional :entity_id, String
+
+              # @!attribute limit
+              #   Maximum number of items to return
+              #
+              #   @return [Integer, nil]
+              optional :limit, Integer
+
+              # @!method initialize(id:, after: nil, before: nil, capability_id: nil, entity_id: nil, limit: nil, request_options: {})
+              #   @param id [String]
+              #
+              #   @param after [String] Return items that come after this cursor
+              #
+              #   @param before [String] Return items that come before this cursor
+              #
+              #   @param capability_id [String] Filter assignments to a specific capability refId
+              #
+              #   @param entity_id [String] Filter assignments to a specific entity refId
+              #
+              #   @param limit [Integer] Maximum number of items to return
+              #
+              #   @param request_options [Stigg::RequestOptions, Hash{Symbol=>Object}]
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/stigg/models/v1/events/beta/customers/assignment_list_response.rb

@@ -0,0 +1,90 @@
+# frozen_string_literal: true
+
+module Stigg
+  module Models
+    module V1
+      module Events
+        module Beta
+          module Customers
+            # @see Stigg::Resources::V1::Events::Beta::Customers::Assignments#list
+            class AssignmentListResponse < Stigg::Internal::Type::BaseModel
+              # @!attribute id
+              #   Synthetic UUID identifier — also the cursor anchor for paginated lists
+              #
+              #   @return [String]
+              required :id, String
+
+              # @!attribute cadence
+              #   Usage-reset cadence. Currently only `MONTH` is supported
+              #
+              #   @return [Symbol, Stigg::Models::V1::Events::Beta::Customers::AssignmentListResponse::Cadence]
+              required :cadence,
+                       enum: -> { Stigg::Models::V1::Events::Beta::Customers::AssignmentListResponse::Cadence }
+
+              # @!attribute capability_id
+              #   The capability refId this assignment grants
+              #
+              #   @return [String]
+              required :capability_id, String, api_name: :capabilityId
+
+              # @!attribute created_at
+              #   Timestamp of when the record was created
+              #
+              #   @return [Time]
+              required :created_at, Time, api_name: :createdAt
+
+              # @!attribute entity_id
+              #   The entity refId this assignment is attached to
+              #
+              #   @return [String]
+              required :entity_id, String, api_name: :entityId
+
+              # @!attribute updated_at
+              #   Timestamp of when the record was last updated
+              #
+              #   @return [Time]
+              required :updated_at, Time, api_name: :updatedAt
+
+              # @!attribute usage_limit
+              #   Maximum usage allowed within one cadence window
+              #
+              #   @return [Float]
+              required :usage_limit, Float, api_name: :usageLimit
+
+              # @!method initialize(id:, cadence:, capability_id:, created_at:, entity_id:, updated_at:, usage_limit:)
+              #   A capability assignment for an entity belonging to a customer. Defines how much
+              #   of the capability the entity may consume (`usageLimit`) and how often the
+              #   counter resets (`cadence`).
+              #
+              #   @param id [String] Synthetic UUID identifier — also the cursor anchor for paginated lists
+              #
+              #   @param cadence [Symbol, Stigg::Models::V1::Events::Beta::Customers::AssignmentListResponse::Cadence] Usage-reset cadence. Currently only `MONTH` is supported
+              #
+              #   @param capability_id [String] The capability refId this assignment grants
+              #
+              #   @param created_at [Time] Timestamp of when the record was created
+              #
+              #   @param entity_id [String] The entity refId this assignment is attached to
+              #
+              #   @param updated_at [Time] Timestamp of when the record was last updated
+              #
+              #   @param usage_limit [Float] Maximum usage allowed within one cadence window
+
+              # Usage-reset cadence. Currently only `MONTH` is supported
+              #
+              # @see Stigg::Models::V1::Events::Beta::Customers::AssignmentListResponse#cadence
+              module Cadence
+                extend Stigg::Internal::Type::Enum
+
+                MONTH = :MONTH
+
+                # @!method self.values
+                #   @return [Array<Symbol>]
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/stigg/models/v1/events/beta/customers/assignment_upsert_params.rb

@@ -0,0 +1,91 @@
+# frozen_string_literal: true
+
+module Stigg
+  module Models
+    module V1
+      module Events
+        module Beta
+          module Customers
+            # @see Stigg::Resources::V1::Events::Beta::Customers::Assignments#upsert
+            class AssignmentUpsertParams < Stigg::Internal::Type::BaseModel
+              extend Stigg::Internal::Type::RequestParameters::Converter
+              include Stigg::Internal::Type::RequestParameters
+
+              # @!attribute id
+              #
+              #   @return [String]
+              required :id, String
+
+              # @!attribute assignments
+              #   Assignments to upsert (1–100 per request)
+              #
+              #   @return [Array<Stigg::Models::V1::Events::Beta::Customers::AssignmentUpsertParams::Assignment>]
+              required :assignments,
+                       -> { Stigg::Internal::Type::ArrayOf[Stigg::V1::Events::Beta::Customers::AssignmentUpsertParams::Assignment] }
+
+              # @!method initialize(id:, assignments:, request_options: {})
+              #   @param id [String]
+              #
+              #   @param assignments [Array<Stigg::Models::V1::Events::Beta::Customers::AssignmentUpsertParams::Assignment>] Assignments to upsert (1–100 per request)
+              #
+              #   @param request_options [Stigg::RequestOptions, Hash{Symbol=>Object}]
+
+              class Assignment < Stigg::Internal::Type::BaseModel
+                # @!attribute capability_id
+                #   The capability refId this assignment grants
+                #
+                #   @return [String]
+                required :capability_id, String, api_name: :capabilityId
+
+                # @!attribute entity_id
+                #   The entity refId this assignment is attached to
+                #
+                #   @return [String]
+                required :entity_id, String, api_name: :entityId
+
+                # @!attribute cadence
+                #   Usage-reset cadence (required on create). Currently only `MONTH` is supported
+                #
+                #   @return [Symbol, Stigg::Models::V1::Events::Beta::Customers::AssignmentUpsertParams::Assignment::Cadence, nil]
+                optional :cadence,
+                         enum: -> { Stigg::V1::Events::Beta::Customers::AssignmentUpsertParams::Assignment::Cadence }
+
+                # @!attribute usage_limit
+                #   Maximum usage allowed within one cadence window (required on create)
+                #
+                #   @return [Float, nil]
+                optional :usage_limit, Float, api_name: :usageLimit
+
+                # @!method initialize(capability_id:, entity_id:, cadence: nil, usage_limit: nil)
+                #   A single assignment to create or update. The natural key is the
+                #   `(entityId, capabilityId)` pair. On create both `usageLimit` and `cadence` are
+                #   required; on update they may be omitted individually to preserve the existing
+                #   value.
+                #
+                #   @param capability_id [String] The capability refId this assignment grants
+                #
+                #   @param entity_id [String] The entity refId this assignment is attached to
+                #
+                #   @param cadence [Symbol, Stigg::Models::V1::Events::Beta::Customers::AssignmentUpsertParams::Assignment::Cadence] Usage-reset cadence (required on create). Currently only `MONTH` is supported
+                #
+                #   @param usage_limit [Float] Maximum usage allowed within one cadence window (required on create)
+
+                # Usage-reset cadence (required on create). Currently only `MONTH` is supported
+                #
+                # @see Stigg::Models::V1::Events::Beta::Customers::AssignmentUpsertParams::Assignment#cadence
+                module Cadence
+                  extend Stigg::Internal::Type::Enum
+
+                  MONTH = :MONTH
+
+                  # @!method self.values
+                  #   @return [Array<Symbol>]
+                end
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/stigg/models/v1/events/beta/customers/assignment_upsert_response.rb

@@ -0,0 +1,103 @@
+# frozen_string_literal: true
+
+module Stigg
+  module Models
+    module V1
+      module Events
+        module Beta
+          module Customers
+            # @see Stigg::Resources::V1::Events::Beta::Customers::Assignments#upsert
+            class AssignmentUpsertResponse < Stigg::Internal::Type::BaseModel
+              # @!attribute data
+              #
+              #   @return [Array<Stigg::Models::V1::Events::Beta::Customers::AssignmentUpsertResponse::Data>]
+              required :data,
+                       -> { Stigg::Internal::Type::ArrayOf[Stigg::Models::V1::Events::Beta::Customers::AssignmentUpsertResponse::Data] }
+
+              # @!method initialize(data:)
+              #   Assignments after upsert.
+              #
+              #   @param data [Array<Stigg::Models::V1::Events::Beta::Customers::AssignmentUpsertResponse::Data>]
+
+              class Data < Stigg::Internal::Type::BaseModel
+                # @!attribute id
+                #   Synthetic UUID identifier — also the cursor anchor for paginated lists
+                #
+                #   @return [String]
+                required :id, String
+
+                # @!attribute cadence
+                #   Usage-reset cadence. Currently only `MONTH` is supported
+                #
+                #   @return [Symbol, Stigg::Models::V1::Events::Beta::Customers::AssignmentUpsertResponse::Data::Cadence]
+                required :cadence,
+                         enum: -> { Stigg::Models::V1::Events::Beta::Customers::AssignmentUpsertResponse::Data::Cadence }
+
+                # @!attribute capability_id
+                #   The capability refId this assignment grants
+                #
+                #   @return [String]
+                required :capability_id, String, api_name: :capabilityId
+
+                # @!attribute created_at
+                #   Timestamp of when the record was created
+                #
+                #   @return [Time]
+                required :created_at, Time, api_name: :createdAt
+
+                # @!attribute entity_id
+                #   The entity refId this assignment is attached to
+                #
+                #   @return [String]
+                required :entity_id, String, api_name: :entityId
+
+                # @!attribute updated_at
+                #   Timestamp of when the record was last updated
+                #
+                #   @return [Time]
+                required :updated_at, Time, api_name: :updatedAt
+
+                # @!attribute usage_limit
+                #   Maximum usage allowed within one cadence window
+                #
+                #   @return [Float]
+                required :usage_limit, Float, api_name: :usageLimit
+
+                # @!method initialize(id:, cadence:, capability_id:, created_at:, entity_id:, updated_at:, usage_limit:)
+                #   A capability assignment for an entity belonging to a customer. Defines how much
+                #   of the capability the entity may consume (`usageLimit`) and how often the
+                #   counter resets (`cadence`).
+                #
+                #   @param id [String] Synthetic UUID identifier — also the cursor anchor for paginated lists
+                #
+                #   @param cadence [Symbol, Stigg::Models::V1::Events::Beta::Customers::AssignmentUpsertResponse::Data::Cadence] Usage-reset cadence. Currently only `MONTH` is supported
+                #
+                #   @param capability_id [String] The capability refId this assignment grants
+                #
+                #   @param created_at [Time] Timestamp of when the record was created
+                #
+                #   @param entity_id [String] The entity refId this assignment is attached to
+                #
+                #   @param updated_at [Time] Timestamp of when the record was last updated
+                #
+                #   @param usage_limit [Float] Maximum usage allowed within one cadence window
+
+                # Usage-reset cadence. Currently only `MONTH` is supported
+                #
+                # @see Stigg::Models::V1::Events::Beta::Customers::AssignmentUpsertResponse::Data#cadence
+                module Cadence
+                  extend Stigg::Internal::Type::Enum
+
+                  MONTH = :MONTH
+
+                  # @!method self.values
+                  #   @return [Array<Symbol>]
+                end
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/stigg/models/v1/events/beta/customers/entitlement_check_params.rb

@@ -0,0 +1,84 @@
+# frozen_string_literal: true
+
+module Stigg
+  module Models
+    module V1
+      module Events
+        module Beta
+          module Customers
+            # @see Stigg::Resources::V1::Events::Beta::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::V1::Events::Beta::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
+  end
+end