stigg 0.1.0.pre.beta.41 → 0.1.0.pre.beta.42

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 53711470110d524ac93099766b63b17dbf739f38795e1884574872a3cf749d38
-  data.tar.gz: df87953f6033908bcea599f90ac45e572633133a65ccfe5db318f82aa1067c27
+  metadata.gz: 2663ec08e29edc72d72ea83c36533df69635192cbc1b2ee51a515f1655eeff10
+  data.tar.gz: 5878ac0a46cf891fa542ef614c4ad256738c3d79aae0cf8c4767f4d364b0e5af
 SHA512:
-  metadata.gz: c987781747d4bb7c8e3d0fac03b66fbabe37505cc834a4e022d8425dd5d9c7042b9272a9592662ee36134bc71cd55c3b6ab2952a9c7c1816d6103581f6f94c09
-  data.tar.gz: a976dc72dd83461f9ce7a9c98f5aa88c2e68d23fb4d1fc1811305b33aa9f40f55836a5a69986b68ea740bdaa56fca8b363dd83575e2b0dd04655cb7ea998cedc
+  metadata.gz: b70d57ef96bb56ffc8c69ce920f4ba6b011de6226c34c434cec10da555fcbdce53bb57a7a7174a1df12770781eff43512695c8e16154728106e013d27f8e0f67
+  data.tar.gz: 29f472a786a265a6f1c67307d58bdab85dc67d18d8b2a909ca8b12ee39c7934f9cc5732b3e97d38a7a8d1123aa267dcc934c200561a5afe27dffaf7c91ea9ec8

data/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 0.1.0-beta.42 (2026-07-18)
+
+Full Changelog: [v0.1.0-beta.41...v0.1.0-beta.42](https://github.com/stiggio/stigg-ruby/compare/v0.1.0-beta.41...v0.1.0-beta.42)
+
+### Features
+
+* **stlc:** configurable CI runner and private-production-repo support in workflow templates ([e1adb97](https://github.com/stiggio/stigg-ruby/commit/e1adb97da2b2c6b4bbdcd5ab511bd53b4d6dcef7))
+
+
+### Chores
+
+* **api:** move governance endpoint from events/beta to v1_beta namespace ([c1ad229](https://github.com/stiggio/stigg-ruby/commit/c1ad229d3436f542857fddcd7e01eba6e51fd582))
+
 ## 0.1.0-beta.41 (2026-07-14)
 
 Full Changelog: [v0.1.0-beta.40...v0.1.0-beta.41](https://github.com/stiggio/stigg-ruby/compare/v0.1.0-beta.40...v0.1.0-beta.41)

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

data/lib/stigg/models/v1_beta/customer_retrieve_governance_params.rb

@@ -0,0 +1,168 @@
+# frozen_string_literal: true
+
+module Stigg
+  module Models
+    module V1Beta
+      # @see Stigg::Resources::V1Beta::Customers#retrieve_governance
+      class CustomerRetrieveGovernanceParams < 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 currency_ids
+        #   Currency ids to include, repeated per value (e.g. `?currencyIds=credits`). Omit
+        #   both featureIds and currencyIds for tree mode.
+        #
+        #   @return [Array<String>, nil]
+        optional :currency_ids, Stigg::Internal::Type::ArrayOf[String]
+
+        # @!attribute entity_id_search
+        #   Case-insensitive substring match on the entity id (`%`/`_` matched literally).
+        #
+        #   @return [String, nil]
+        optional :entity_id_search, String
+
+        # @!attribute entity_type_ids
+        #   Filter to one or more entity types, repeated per value (e.g.
+        #   `?entityTypeIds=team&entityTypeIds=user`).
+        #
+        #   @return [Array<String>, nil]
+        optional :entity_type_ids, Stigg::Internal::Type::ArrayOf[String]
+
+        # @!attribute feature_ids
+        #   Feature ids to include, repeated per value (e.g.
+        #   `?featureIds=ai-tokens&featureIds=seats`). Omit both featureIds and currencyIds
+        #   for tree mode — every node in the hierarchy with no usage configuration
+        #   attached.
+        #
+        #   @return [Array<String>, nil]
+        optional :feature_ids, Stigg::Internal::Type::ArrayOf[String]
+
+        # @!attribute limit
+        #   Maximum number of items to return
+        #
+        #   @return [Integer, nil]
+        optional :limit, Integer
+
+        # @!attribute min_utilization
+        #   Only nodes with utilization ≥ this value (e.g. 0.8 for ≥80%, 1 for at/over
+        #   limit).
+        #
+        #   @return [Float, nil]
+        optional :min_utilization, Float
+
+        # @!attribute order
+        #   Sort direction: `asc` or `desc` (default `desc`).
+        #
+        #   @return [Symbol, Stigg::Models::V1Beta::CustomerRetrieveGovernanceParams::Order, nil]
+        optional :order, enum: -> { Stigg::V1Beta::CustomerRetrieveGovernanceParams::Order }
+
+        # @!attribute scope
+        #   Filter by configuration scope: `all` (default), `nodeWide` (`[]` only), or
+        #   `scoped` (non-empty only).
+        #
+        #   @return [Symbol, Stigg::Models::V1Beta::CustomerRetrieveGovernanceParams::Scope, nil]
+        optional :scope, enum: -> { Stigg::V1Beta::CustomerRetrieveGovernanceParams::Scope }
+
+        # @!attribute sort_by
+        #   Sort key: `utilization` (default, cross-capability-safe), `currentUsage`,
+        #   `usageLimit`, `scopeSize`, `id`, or `createdAt`.
+        #
+        #   @return [Symbol, Stigg::Models::V1Beta::CustomerRetrieveGovernanceParams::SortBy, nil]
+        optional :sort_by, enum: -> { Stigg::V1Beta::CustomerRetrieveGovernanceParams::SortBy }
+
+        # @!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(id:, after: nil, currency_ids: nil, entity_id_search: nil, entity_type_ids: nil, feature_ids: nil, limit: nil, min_utilization: nil, order: nil, scope: nil, sort_by: nil, x_account_id: nil, x_environment_id: nil, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Stigg::Models::V1Beta::CustomerRetrieveGovernanceParams} for more details.
+        #
+        #   @param id [String]
+        #
+        #   @param after [String] Return items that come after this cursor
+        #
+        #   @param currency_ids [Array<String>] Currency ids to include, repeated per value (e.g. `?currencyIds=credits`). Omit
+        #
+        #   @param entity_id_search [String] Case-insensitive substring match on the entity id (`%`/`_` matched literally).
+        #
+        #   @param entity_type_ids [Array<String>] Filter to one or more entity types, repeated per value (e.g. `?entityTypeIds=tea
+        #
+        #   @param feature_ids [Array<String>] Feature ids to include, repeated per value (e.g. `?featureIds=ai-tokens&featureI
+        #
+        #   @param limit [Integer] Maximum number of items to return
+        #
+        #   @param min_utilization [Float] Only nodes with utilization ≥ this value (e.g. 0.8 for ≥80%, 1 for at/over limit
+        #
+        #   @param order [Symbol, Stigg::Models::V1Beta::CustomerRetrieveGovernanceParams::Order] Sort direction: `asc` or `desc` (default `desc`).
+        #
+        #   @param scope [Symbol, Stigg::Models::V1Beta::CustomerRetrieveGovernanceParams::Scope] Filter by configuration scope: `all` (default), `nodeWide` (`[]` only), or `scop
+        #
+        #   @param sort_by [Symbol, Stigg::Models::V1Beta::CustomerRetrieveGovernanceParams::SortBy] Sort key: `utilization` (default, cross-capability-safe), `currentUsage`, `usage
+        #
+        #   @param x_account_id [String]
+        #
+        #   @param x_environment_id [String]
+        #
+        #   @param request_options [Stigg::RequestOptions, Hash{Symbol=>Object}]
+
+        # Sort direction: `asc` or `desc` (default `desc`).
+        module Order
+          extend Stigg::Internal::Type::Enum
+
+          ASC = :asc
+          DESC = :desc
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        # Filter by configuration scope: `all` (default), `nodeWide` (`[]` only), or
+        # `scoped` (non-empty only).
+        module Scope
+          extend Stigg::Internal::Type::Enum
+
+          ALL = :all
+          NODE_WIDE = :nodeWide
+          SCOPED = :scoped
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        # Sort key: `utilization` (default, cross-capability-safe), `currentUsage`,
+        # `usageLimit`, `scopeSize`, `id`, or `createdAt`.
+        module SortBy
+          extend Stigg::Internal::Type::Enum
+
+          UTILIZATION = :utilization
+          CURRENT_USAGE = :currentUsage
+          USAGE_LIMIT = :usageLimit
+          SCOPE_SIZE = :scopeSize
+          ID = :id
+          CREATED_AT = :createdAt
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end

data/lib/stigg/models/v1_beta/customer_retrieve_governance_response.rb

@@ -0,0 +1,161 @@
+# frozen_string_literal: true
+
+module Stigg
+  module Models
+    module V1Beta
+      # @see Stigg::Resources::V1Beta::Customers#retrieve_governance
+      class CustomerRetrieveGovernanceResponse < Stigg::Internal::Type::BaseModel
+        # @!attribute data
+        #
+        #   @return [Array<Stigg::Models::V1Beta::CustomerRetrieveGovernanceResponse::Data>]
+        required :data,
+                 -> { Stigg::Internal::Type::ArrayOf[Stigg::Models::V1Beta::CustomerRetrieveGovernanceResponse::Data] }
+
+        # @!attribute pagination
+        #
+        #   @return [Stigg::Models::V1Beta::CustomerRetrieveGovernanceResponse::Pagination]
+        required :pagination, -> { Stigg::Models::V1Beta::CustomerRetrieveGovernanceResponse::Pagination }
+
+        # @!method initialize(data:, pagination:)
+        #   Paginated list of governance tree nodes, each with its usage configuration and
+        #   current usage.
+        #
+        #   @param data [Array<Stigg::Models::V1Beta::CustomerRetrieveGovernanceResponse::Data>]
+        #   @param pagination [Stigg::Models::V1Beta::CustomerRetrieveGovernanceResponse::Pagination]
+
+        class Data < Stigg::Internal::Type::BaseModel
+          # @!attribute cadence
+          #   Usage-reset cadence as an ISO-8601 single-unit duration, e.g. `P1M`, `P30D`,
+          #   `PT1M`; `null` when the node has no usage configuration.
+          #
+          #   @return [String, nil]
+          required :cadence, String, nil?: true
+
+          # @!attribute current_usage
+          #   Usage consumed in the current cadence period (may lag the live counter by a
+          #   short interval).
+          #
+          #   @return [Float, nil]
+          required :current_usage, Float, api_name: :currentUsage, nil?: true
+
+          # @!attribute entity_id
+          #   External id of the entity at this node.
+          #
+          #   @return [String]
+          required :entity_id, String, api_name: :entityId
+
+          # @!attribute entity_type_id
+          #   External id of the entity type (e.g. `team`, `user`).
+          #
+          #   @return [String]
+          required :entity_type_id, String, api_name: :entityTypeId
+
+          # @!attribute parent_id
+          #   External id of the parent entity in the tree; `null` for a root. Use it to
+          #   rebuild the tree.
+          #
+          #   @return [String, nil]
+          required :parent_id, String, api_name: :parentId, nil?: true
+
+          # @!attribute scope_entity_ids
+          #   The configuration scope (entity ids). Empty is the node-wide configuration; a
+          #   non-empty set is a dimension-scoped sub-configuration.
+          #
+          #   @return [Array<String>]
+          required :scope_entity_ids, Stigg::Internal::Type::ArrayOf[String], api_name: :scopeEntityIds
+
+          # @!attribute usage_limit
+          #   Hard usage limit for this node per cadence period.
+          #
+          #   @return [Float, nil]
+          required :usage_limit, Float, api_name: :usageLimit, nil?: true
+
+          # @!attribute usage_period_end
+          #   Exclusive end of the cadence period — when usage resets; `null` once the period
+          #   has rolled over.
+          #
+          #   @return [Time, nil]
+          required :usage_period_end, Time, api_name: :usagePeriodEnd, nil?: true
+
+          # @!attribute usage_period_start
+          #   Start of the cadence period the usage snapshot belongs to; `null` once the
+          #   period has rolled over.
+          #
+          #   @return [Time, nil]
+          required :usage_period_start, Time, api_name: :usagePeriodStart, nil?: true
+
+          # @!attribute utilization
+          #   `currentUsage / usageLimit` (1 when usageLimit is 0 — always at limit). The
+          #   cross-capability-safe sort key.
+          #
+          #   @return [Float, nil]
+          required :utilization, Float, nil?: true
+
+          # @!attribute currency_id
+          #   The metered currency ID (present when the configured capability is a credit
+          #   currency).
+          #
+          #   @return [String, nil]
+          optional :currency_id, String, api_name: :currencyId
+
+          # @!attribute feature_id
+          #   The metered feature ID (present when the configured capability is a feature).
+          #
+          #   @return [String, nil]
+          optional :feature_id, String, api_name: :featureId
+
+          # @!method initialize(cadence:, current_usage:, entity_id:, entity_type_id:, parent_id:, scope_entity_ids:, usage_limit:, usage_period_end:, usage_period_start:, utilization:, currency_id: nil, feature_id: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Stigg::Models::V1Beta::CustomerRetrieveGovernanceResponse::Data} for more
+          #   details.
+          #
+          #   A node of the governance hierarchy tree with its usage configuration (limit,
+          #   cadence, scope) and current usage. Usage is read from a periodically-refreshed
+          #   read model and may lag the live counter by a short interval; it never gates
+          #   access.
+          #
+          #   @param cadence [String, nil] Usage-reset cadence as an ISO-8601 single-unit duration, e.g. `P1M`, `P30D`, `PT
+          #
+          #   @param current_usage [Float, nil] Usage consumed in the current cadence period (may lag the live counter by a shor
+          #
+          #   @param entity_id [String] External id of the entity at this node.
+          #
+          #   @param entity_type_id [String] External id of the entity type (e.g. `team`, `user`).
+          #
+          #   @param parent_id [String, nil] External id of the parent entity in the tree; `null` for a root. Use it to rebui
+          #
+          #   @param scope_entity_ids [Array<String>] The configuration scope (entity ids). Empty is the node-wide configuration; a no
+          #
+          #   @param usage_limit [Float, nil] Hard usage limit for this node per cadence period.
+          #
+          #   @param usage_period_end [Time, nil] Exclusive end of the cadence period — when usage resets; `null` once the period
+          #
+          #   @param usage_period_start [Time, nil] Start of the cadence period the usage snapshot belongs to; `null` once the perio
+          #
+          #   @param utilization [Float, nil] `currentUsage / usageLimit` (1 when usageLimit is 0 — always at limit). The cros
+          #
+          #   @param currency_id [String] The metered currency ID (present when the configured capability is a credit curr
+          #
+          #   @param feature_id [String] The metered feature ID (present when the configured capability is a feature).
+        end
+
+        # @see Stigg::Models::V1Beta::CustomerRetrieveGovernanceResponse#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
+
+          # @!method initialize(next_:)
+          #   Some parameter documentations has been truncated, see
+          #   {Stigg::Models::V1Beta::CustomerRetrieveGovernanceResponse::Pagination} for more
+          #   details.
+          #
+          #   @param next_ [String, nil] Cursor for fetching the next page of results, or null if no additional pages exi
+        end
+      end
+    end
+  end
+end

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

@@ -8,9 +8,6 @@ module Stigg
         # @return [Stigg::Resources::V1::Events::DataExport]
         attr_reader :data_export
 
-        # @return [Stigg::Resources::V1::Events::Beta]
-        attr_reader :beta
-
         # Some parameter documentations has been truncated, see
         # {Stigg::Models::V1::EventEstimateCostParams} for more details.
         #
@@ -88,7 +85,6 @@ module Stigg
         def initialize(client:)
           @client = client
           @data_export = Stigg::Resources::V1::Events::DataExport.new(client: client)
-          @beta = Stigg::Resources::V1::Events::Beta.new(client: client)
         end
       end
     end

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

@@ -13,6 +13,84 @@ module Stigg
         # @return [Stigg::Resources::V1Beta::Customers::Assignments]
         attr_reader :assignments
 
+        # Some parameter documentations has been truncated, see
+        # {Stigg::Models::V1Beta::CustomerRetrieveGovernanceParams} for more details.
+        #
+        # Queries the customer's governance hierarchy tree, returning a cursor-paginated
+        # list of nodes with their usage configuration (limit, cadence, scope) and current
+        # usage, sortable and filterable by usage. Each node carries `parentId` so the
+        # tree can be rebuilt client-side. Usage is read from a periodically-refreshed
+        # read model and never gates access.
+        #
+        # @overload retrieve_governance(id, after: nil, currency_ids: nil, entity_id_search: nil, entity_type_ids: nil, feature_ids: nil, limit: nil, min_utilization: nil, order: nil, scope: nil, sort_by: nil, x_account_id: nil, x_environment_id: nil, request_options: {})
+        #
+        # @param id [String] Path param: The customer ID.
+        #
+        # @param after [String] Query param: Return items that come after this cursor
+        #
+        # @param currency_ids [Array<String>] Query param: Currency ids to include, repeated per value (e.g. `?currencyIds=cre
+        #
+        # @param entity_id_search [String] Query param: Case-insensitive substring match on the entity id (`%`/`_` matched
+        #
+        # @param entity_type_ids [Array<String>] Query param: Filter to one or more entity types, repeated per value (e.g. `?enti
+        #
+        # @param feature_ids [Array<String>] Query param: Feature ids to include, repeated per value (e.g. `?featureIds=ai-to
+        #
+        # @param limit [Integer] Query param: Maximum number of items to return
+        #
+        # @param min_utilization [Float] Query param: Only nodes with utilization ≥ this value (e.g. 0.8 for ≥80%, 1 for
+        #
+        # @param order [Symbol, Stigg::Models::V1Beta::CustomerRetrieveGovernanceParams::Order] Query param: Sort direction: `asc` or `desc` (default `desc`).
+        #
+        # @param scope [Symbol, Stigg::Models::V1Beta::CustomerRetrieveGovernanceParams::Scope] Query param: Filter by configuration scope: `all` (default), `nodeWide` (`[]` on
+        #
+        # @param sort_by [Symbol, Stigg::Models::V1Beta::CustomerRetrieveGovernanceParams::SortBy] Query param: Sort key: `utilization` (default, cross-capability-safe), `currentU
+        #
+        # @param x_account_id [String] Header param: Account ID — optional when authenticating with a user JWT (Bearer
+        #
+        # @param x_environment_id [String] Header param: Environment ID — required when authenticating with a user JWT (Bea
+        #
+        # @param request_options [Stigg::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Stigg::Models::V1Beta::CustomerRetrieveGovernanceResponse]
+        #
+        # @see Stigg::Models::V1Beta::CustomerRetrieveGovernanceParams
+        def retrieve_governance(id, params = {})
+          query_params =
+            [
+              :after,
+              :currency_ids,
+              :entity_id_search,
+              :entity_type_ids,
+              :feature_ids,
+              :limit,
+              :min_utilization,
+              :order,
+              :scope,
+              :sort_by
+            ]
+          parsed, options = Stigg::V1Beta::CustomerRetrieveGovernanceParams.dump_request(params)
+          query = Stigg::Internal::Util.encode_query_params(parsed.slice(*query_params))
+          @client.request(
+            method: :get,
+            path: ["api/v1-beta/customers/%1$s/governance", id],
+            query: query.transform_keys(
+              currency_ids: "currencyIds",
+              entity_id_search: "entityIdSearch",
+              entity_type_ids: "entityTypeIds",
+              feature_ids: "featureIds",
+              min_utilization: "minUtilization",
+              sort_by: "sortBy"
+            ),
+            headers: parsed.except(*query_params).transform_keys(
+              x_account_id: "x-account-id",
+              x_environment_id: "x-environment-id"
+            ),
+            model: Stigg::Models::V1Beta::CustomerRetrieveGovernanceResponse,
+            options: options
+          )
+        end
+
         # @api private
         #
         # @param client [Stigg::Client]

data/lib/stigg/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Stigg
-  VERSION = "0.1.0.pre.beta.41"
+  VERSION = "0.1.0.pre.beta.42"
 end

data/lib/stigg.rb

@@ -140,8 +140,6 @@ require_relative "stigg/models/v1/event_estimate_cost_params"
 require_relative "stigg/models/v1/event_estimate_cost_response"
 require_relative "stigg/models/v1/event_report_params"
 require_relative "stigg/models/v1/event_report_response"
-require_relative "stigg/models/v1/events/beta/customer_retrieve_governance_params"
-require_relative "stigg/models/v1/events/beta/customer_retrieve_governance_response"
 require_relative "stigg/models/v1/events/data_export/destination_create_params"
 require_relative "stigg/models/v1/events/data_export/destination_create_response"
 require_relative "stigg/models/v1/events/data_export/destination_delete_params"
@@ -223,6 +221,8 @@ require_relative "stigg/models/v1/usage_history_params"
 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/v1_beta/customer_retrieve_governance_params"
+require_relative "stigg/models/v1_beta/customer_retrieve_governance_response"
 require_relative "stigg/models/v1_beta/customers/assignment_list_params"
 require_relative "stigg/models/v1_beta/customers/assignment_list_response"
 require_relative "stigg/models/v1_beta/customers/assignment_upsert_params"
@@ -257,8 +257,6 @@ require_relative "stigg/resources/v1/customers/integrations"
 require_relative "stigg/resources/v1/customers/payment_method"
 require_relative "stigg/resources/v1/customers/promotional_entitlements"
 require_relative "stigg/resources/v1/events"
-require_relative "stigg/resources/v1/events/beta"
-require_relative "stigg/resources/v1/events/beta/customers"
 require_relative "stigg/resources/v1/events/data_export"
 require_relative "stigg/resources/v1/events/data_export/destinations"
 require_relative "stigg/resources/v1/features"