stigg 0.1.0.pre.beta.39 → 0.1.0.pre.beta.40

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1ca8af19b360c0e53c61b068cb9a1c035eb1ad282bc3e66f09b9054afbd6150c
-  data.tar.gz: a24b6c21c2dd7f37696fba89035eb3b557a6be4663a549309b268ff327fc16bf
+  metadata.gz: 2ff3e5412440a215842d03161ea3ebd53565493e6d16d45d0910d65cb4813e73
+  data.tar.gz: ceddb91f00c85987c709b90b3e4b0fffadadc0810651020f5bccf2962cc5de7b
 SHA512:
-  metadata.gz: e6fd739bce4d9b2be72e402caca86f297a519482e5b512f48864bbdfa9d2b21c8e029cb5b87fd7e23460ed4d2cc2f39cf25ae4e642b4e31714dad2eebb188703
-  data.tar.gz: c8235a7e6d019fa08a4d9b3295de9eb6b9614985d81d46b11b6da1725e6cb19e82ef64ef7bc59a4ecd31e806b3077eb988c1f40807ed7ed519418887f7416d54
+  metadata.gz: d05a8cb2584b1fb675b4cc0a6950c2948322e6d6782ef62334f1551cbab5bf32f893d35c46769197d8e64a66d2d4a33e1c500a54270e2395d8a3a9ad2a040017
+  data.tar.gz: a737412e440d091b7a17876ae773ccf1a6190295291159ba21b9f548fedf727842fdfa640645c172454c68c2d1bf8a570d641efdedebf7eb90dc3ea22bc13df5

data/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## 0.1.0-beta.40 (2026-07-14)
+
+Full Changelog: [v0.1.0-beta.39...v0.1.0-beta.40](https://github.com/stiggio/stigg-ruby/compare/v0.1.0-beta.39...v0.1.0-beta.40)
+
+### Features
+
+* **api:** add estimate endpoints to customers events/usage ([0244f08](https://github.com/stiggio/stigg-ruby/commit/0244f0830e39c3ad7d65433baa8566a1259869af))
+
+
+### Documentation
+
+* **api:** clarify delete behavior in data_export destinations ([690040d](https://github.com/stiggio/stigg-ruby/commit/690040d89d32b2b09edd8a3da3012c82f7897116))
+* **api:** update customers provision method description ([5c2ef75](https://github.com/stiggio/stigg-ruby/commit/5c2ef756c66511a1a6ee1069ee9c10270303febc))
+
 ## 0.1.0-beta.39 (2026-07-12)
 
 Full Changelog: [v0.1.0-beta.38...v0.1.0-beta.39](https://github.com/stiggio/stigg-ruby/compare/v0.1.0-beta.38...v0.1.0-beta.39)

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

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

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+module Stigg
+  module Models
+    module V1
+      # @see Stigg::Resources::V1::Events#estimate_cost
+      class EventEstimateCostParams < Stigg::Internal::Type::BaseModel
+        extend Stigg::Internal::Type::RequestParameters::Converter
+        include Stigg::Internal::Type::RequestParameters
+
+        # @!attribute customer_id
+        #   Customer id
+        #
+        #   @return [String]
+        required :customer_id, String, api_name: :customerId
+
+        # @!attribute event_name
+        #   The name of the usage event
+        #
+        #   @return [String]
+        required :event_name, String, api_name: :eventName
+
+        # @!attribute dimensions
+        #   Dimensions associated with the usage event
+        #
+        #   @return [Hash{Symbol=>String, Float, Boolean}, nil]
+        optional :dimensions,
+                 -> { Stigg::Internal::Type::HashOf[union: Stigg::V1::EventEstimateCostParams::Dimension] }
+
+        # @!attribute resource_id
+        #   Resource id
+        #
+        #   @return [String, nil]
+        optional :resource_id, String, api_name: :resourceId, nil?: true
+
+        # @!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(customer_id:, event_name:, dimensions: nil, resource_id: nil, x_account_id: nil, x_environment_id: nil, request_options: {})
+        #   @param customer_id [String] Customer id
+        #
+        #   @param event_name [String] The name of the usage event
+        #
+        #   @param dimensions [Hash{Symbol=>String, Float, Boolean}] Dimensions associated with the usage event
+        #
+        #   @param resource_id [String, nil] Resource id
+        #
+        #   @param x_account_id [String]
+        #
+        #   @param x_environment_id [String]
+        #
+        #   @param request_options [Stigg::RequestOptions, Hash{Symbol=>Object}]
+
+        module Dimension
+          extend Stigg::Internal::Type::Union
+
+          variant String
+
+          variant Float
+
+          variant Stigg::Internal::Type::Boolean
+
+          # @!method self.variants
+          #   @return [Array(String, Float, Boolean)]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,150 @@
+# frozen_string_literal: true
+
+module Stigg
+  module Models
+    module V1
+      # @see Stigg::Resources::V1::Events#estimate_cost
+      class EventEstimateCostResponse < Stigg::Internal::Type::BaseModel
+        # @!attribute data
+        #   Estimated credit cost, current balance and balance after
+        #
+        #   @return [Stigg::Models::V1::EventEstimateCostResponse::Data]
+        required :data, -> { Stigg::Models::V1::EventEstimateCostResponse::Data }
+
+        # @!method initialize(data:)
+        #   Response object
+        #
+        #   @param data [Stigg::Models::V1::EventEstimateCostResponse::Data] Estimated credit cost, current balance and balance after
+
+        # @see Stigg::Models::V1::EventEstimateCostResponse#data
+        class Data < Stigg::Internal::Type::BaseModel
+          # @!attribute estimates
+          #   Per-currency cost estimates
+          #
+          #   @return [Array<Stigg::Models::V1::EventEstimateCostResponse::Data::Estimate>]
+          required :estimates,
+                   -> { Stigg::Internal::Type::ArrayOf[Stigg::Models::V1::EventEstimateCostResponse::Data::Estimate] }
+
+          # @!attribute warnings
+          #   Request-level warnings about the estimation context
+          #
+          #   @return [Array<Symbol, Stigg::Models::V1::EventEstimateCostResponse::Data::Warning>]
+          required :warnings,
+                   -> { Stigg::Internal::Type::ArrayOf[enum: Stigg::Models::V1::EventEstimateCostResponse::Data::Warning] }
+
+          # @!method initialize(estimates:, warnings:)
+          #   Estimated credit cost, current balance and balance after
+          #
+          #   @param estimates [Array<Stigg::Models::V1::EventEstimateCostResponse::Data::Estimate>] Per-currency cost estimates
+          #
+          #   @param warnings [Array<Symbol, Stigg::Models::V1::EventEstimateCostResponse::Data::Warning>] Request-level warnings about the estimation context
+
+          class Estimate < Stigg::Internal::Type::BaseModel
+            # @!attribute balance_after_estimate
+            #   The credit balance after subtracting the estimated cost
+            #
+            #   @return [Float]
+            required :balance_after_estimate, Float, api_name: :balanceAfterEstimate
+
+            # @!attribute breakdown
+            #   Estimated cost contribution per feature
+            #
+            #   @return [Array<Stigg::Models::V1::EventEstimateCostResponse::Data::Estimate::Breakdown>]
+            required :breakdown,
+                     -> { Stigg::Internal::Type::ArrayOf[Stigg::Models::V1::EventEstimateCostResponse::Data::Estimate::Breakdown] }
+
+            # @!attribute currency_id
+            #   The credit currency identifier
+            #
+            #   @return [String]
+            required :currency_id, String, api_name: :currencyId
+
+            # @!attribute current_balance
+            #   The current credit balance, including not-yet-reconciled consumption
+            #
+            #   @return [Float]
+            required :current_balance, Float, api_name: :currentBalance
+
+            # @!attribute estimated_cost
+            #   The estimated credit cost of the reported event or usage
+            #
+            #   @return [Float]
+            required :estimated_cost, Float, api_name: :estimatedCost
+
+            # @!attribute would_overdraft
+            #   Whether the estimated consumption would bring the balance below zero
+            #
+            #   @return [Boolean]
+            required :would_overdraft, Stigg::Internal::Type::Boolean, api_name: :wouldOverdraft
+
+            # @!method initialize(balance_after_estimate:, breakdown:, currency_id:, current_balance:, estimated_cost:, would_overdraft:)
+            #   @param balance_after_estimate [Float] The credit balance after subtracting the estimated cost
+            #
+            #   @param breakdown [Array<Stigg::Models::V1::EventEstimateCostResponse::Data::Estimate::Breakdown>] Estimated cost contribution per feature
+            #
+            #   @param currency_id [String] The credit currency identifier
+            #
+            #   @param current_balance [Float] The current credit balance, including not-yet-reconciled consumption
+            #
+            #   @param estimated_cost [Float] The estimated credit cost of the reported event or usage
+            #
+            #   @param would_overdraft [Boolean] Whether the estimated consumption would bring the balance below zero
+
+            class Breakdown < Stigg::Internal::Type::BaseModel
+              # @!attribute cost
+              #   The estimated credit cost contributed by this feature
+              #
+              #   @return [Float]
+              required :cost, Float
+
+              # @!attribute feature_id
+              #   The feature whose meter contributed this cost
+              #
+              #   @return [String]
+              required :feature_id, String, api_name: :featureId
+
+              # @!attribute warning_code
+              #   Warning explaining why this cost may be inaccurate, if any
+              #
+              #   @return [Symbol, Stigg::Models::V1::EventEstimateCostResponse::Data::Estimate::Breakdown::WarningCode, nil]
+              required :warning_code,
+                       enum: -> { Stigg::Models::V1::EventEstimateCostResponse::Data::Estimate::Breakdown::WarningCode },
+                       api_name: :warningCode,
+                       nil?: true
+
+              # @!method initialize(cost:, feature_id:, warning_code:)
+              #   @param cost [Float] The estimated credit cost contributed by this feature
+              #
+              #   @param feature_id [String] The feature whose meter contributed this cost
+              #
+              #   @param warning_code [Symbol, Stigg::Models::V1::EventEstimateCostResponse::Data::Estimate::Breakdown::WarningCode, nil] Warning explaining why this cost may be inaccurate, if any
+
+              # Warning explaining why this cost may be inaccurate, if any
+              #
+              # @see Stigg::Models::V1::EventEstimateCostResponse::Data::Estimate::Breakdown#warning_code
+              module WarningCode
+                extend Stigg::Internal::Type::Enum
+
+                UNSUPPORTED_AGGREGATION = :UNSUPPORTED_AGGREGATION
+
+                # @!method self.values
+                #   @return [Array<Symbol>]
+              end
+            end
+          end
+
+          module Warning
+            extend Stigg::Internal::Type::Enum
+
+            RESOURCE_SCOPED_SUBSCRIPTION_EXISTS = :RESOURCE_SCOPED_SUBSCRIPTION_EXISTS
+            FEATURE_NOT_FOUND = :FEATURE_NOT_FOUND
+            FEATURE_NOT_CREDIT_BASED = :FEATURE_NOT_CREDIT_BASED
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,105 @@
+# frozen_string_literal: true
+
+module Stigg
+  module Models
+    module V1
+      # @see Stigg::Resources::V1::Usage#estimate_cost
+      class UsageEstimateCostParams < Stigg::Internal::Type::BaseModel
+        extend Stigg::Internal::Type::RequestParameters::Converter
+        include Stigg::Internal::Type::RequestParameters
+
+        # @!attribute customer_id
+        #   Customer id
+        #
+        #   @return [String]
+        required :customer_id, String, api_name: :customerId
+
+        # @!attribute feature_id
+        #   Feature id
+        #
+        #   @return [String]
+        required :feature_id, String, api_name: :featureId
+
+        # @!attribute value
+        #   The value to report for usage
+        #
+        #   @return [Integer]
+        required :value, Integer
+
+        # @!attribute dimensions
+        #   Additional dimensions for the usage report
+        #
+        #   @return [Hash{Symbol=>String, Float, Boolean}, nil]
+        optional :dimensions,
+                 -> { Stigg::Internal::Type::HashOf[union: Stigg::V1::UsageEstimateCostParams::Dimension] }
+
+        # @!attribute resource_id
+        #   Resource id
+        #
+        #   @return [String, nil]
+        optional :resource_id, String, api_name: :resourceId, nil?: true
+
+        # @!attribute update_behavior
+        #   The method by which the usage value should be updated
+        #
+        #   @return [Symbol, Stigg::Models::V1::UsageEstimateCostParams::UpdateBehavior, nil]
+        optional :update_behavior,
+                 enum: -> { Stigg::V1::UsageEstimateCostParams::UpdateBehavior },
+                 api_name: :updateBehavior
+
+        # @!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(customer_id:, feature_id:, value:, dimensions: nil, resource_id: nil, update_behavior: nil, x_account_id: nil, x_environment_id: nil, request_options: {})
+        #   @param customer_id [String] Customer id
+        #
+        #   @param feature_id [String] Feature id
+        #
+        #   @param value [Integer] The value to report for usage
+        #
+        #   @param dimensions [Hash{Symbol=>String, Float, Boolean}] Additional dimensions for the usage report
+        #
+        #   @param resource_id [String, nil] Resource id
+        #
+        #   @param update_behavior [Symbol, Stigg::Models::V1::UsageEstimateCostParams::UpdateBehavior] The method by which the usage value should be updated
+        #
+        #   @param x_account_id [String]
+        #
+        #   @param x_environment_id [String]
+        #
+        #   @param request_options [Stigg::RequestOptions, Hash{Symbol=>Object}]
+
+        module Dimension
+          extend Stigg::Internal::Type::Union
+
+          variant String
+
+          variant Float
+
+          variant Stigg::Internal::Type::Boolean
+
+          # @!method self.variants
+          #   @return [Array(String, Float, Boolean)]
+        end
+
+        # The method by which the usage value should be updated
+        module UpdateBehavior
+          extend Stigg::Internal::Type::Enum
+
+          DELTA = :DELTA
+          SET = :SET
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,150 @@
+# frozen_string_literal: true
+
+module Stigg
+  module Models
+    module V1
+      # @see Stigg::Resources::V1::Usage#estimate_cost
+      class UsageEstimateCostResponse < Stigg::Internal::Type::BaseModel
+        # @!attribute data
+        #   Estimated credit cost, current balance and balance after
+        #
+        #   @return [Stigg::Models::V1::UsageEstimateCostResponse::Data]
+        required :data, -> { Stigg::Models::V1::UsageEstimateCostResponse::Data }
+
+        # @!method initialize(data:)
+        #   Response object
+        #
+        #   @param data [Stigg::Models::V1::UsageEstimateCostResponse::Data] Estimated credit cost, current balance and balance after
+
+        # @see Stigg::Models::V1::UsageEstimateCostResponse#data
+        class Data < Stigg::Internal::Type::BaseModel
+          # @!attribute estimates
+          #   Per-currency cost estimates
+          #
+          #   @return [Array<Stigg::Models::V1::UsageEstimateCostResponse::Data::Estimate>]
+          required :estimates,
+                   -> { Stigg::Internal::Type::ArrayOf[Stigg::Models::V1::UsageEstimateCostResponse::Data::Estimate] }
+
+          # @!attribute warnings
+          #   Request-level warnings about the estimation context
+          #
+          #   @return [Array<Symbol, Stigg::Models::V1::UsageEstimateCostResponse::Data::Warning>]
+          required :warnings,
+                   -> { Stigg::Internal::Type::ArrayOf[enum: Stigg::Models::V1::UsageEstimateCostResponse::Data::Warning] }
+
+          # @!method initialize(estimates:, warnings:)
+          #   Estimated credit cost, current balance and balance after
+          #
+          #   @param estimates [Array<Stigg::Models::V1::UsageEstimateCostResponse::Data::Estimate>] Per-currency cost estimates
+          #
+          #   @param warnings [Array<Symbol, Stigg::Models::V1::UsageEstimateCostResponse::Data::Warning>] Request-level warnings about the estimation context
+
+          class Estimate < Stigg::Internal::Type::BaseModel
+            # @!attribute balance_after_estimate
+            #   The credit balance after subtracting the estimated cost
+            #
+            #   @return [Float]
+            required :balance_after_estimate, Float, api_name: :balanceAfterEstimate
+
+            # @!attribute breakdown
+            #   Estimated cost contribution per feature
+            #
+            #   @return [Array<Stigg::Models::V1::UsageEstimateCostResponse::Data::Estimate::Breakdown>]
+            required :breakdown,
+                     -> { Stigg::Internal::Type::ArrayOf[Stigg::Models::V1::UsageEstimateCostResponse::Data::Estimate::Breakdown] }
+
+            # @!attribute currency_id
+            #   The credit currency identifier
+            #
+            #   @return [String]
+            required :currency_id, String, api_name: :currencyId
+
+            # @!attribute current_balance
+            #   The current credit balance, including not-yet-reconciled consumption
+            #
+            #   @return [Float]
+            required :current_balance, Float, api_name: :currentBalance
+
+            # @!attribute estimated_cost
+            #   The estimated credit cost of the reported event or usage
+            #
+            #   @return [Float]
+            required :estimated_cost, Float, api_name: :estimatedCost
+
+            # @!attribute would_overdraft
+            #   Whether the estimated consumption would bring the balance below zero
+            #
+            #   @return [Boolean]
+            required :would_overdraft, Stigg::Internal::Type::Boolean, api_name: :wouldOverdraft
+
+            # @!method initialize(balance_after_estimate:, breakdown:, currency_id:, current_balance:, estimated_cost:, would_overdraft:)
+            #   @param balance_after_estimate [Float] The credit balance after subtracting the estimated cost
+            #
+            #   @param breakdown [Array<Stigg::Models::V1::UsageEstimateCostResponse::Data::Estimate::Breakdown>] Estimated cost contribution per feature
+            #
+            #   @param currency_id [String] The credit currency identifier
+            #
+            #   @param current_balance [Float] The current credit balance, including not-yet-reconciled consumption
+            #
+            #   @param estimated_cost [Float] The estimated credit cost of the reported event or usage
+            #
+            #   @param would_overdraft [Boolean] Whether the estimated consumption would bring the balance below zero
+
+            class Breakdown < Stigg::Internal::Type::BaseModel
+              # @!attribute cost
+              #   The estimated credit cost contributed by this feature
+              #
+              #   @return [Float]
+              required :cost, Float
+
+              # @!attribute feature_id
+              #   The feature whose meter contributed this cost
+              #
+              #   @return [String]
+              required :feature_id, String, api_name: :featureId
+
+              # @!attribute warning_code
+              #   Warning explaining why this cost may be inaccurate, if any
+              #
+              #   @return [Symbol, Stigg::Models::V1::UsageEstimateCostResponse::Data::Estimate::Breakdown::WarningCode, nil]
+              required :warning_code,
+                       enum: -> { Stigg::Models::V1::UsageEstimateCostResponse::Data::Estimate::Breakdown::WarningCode },
+                       api_name: :warningCode,
+                       nil?: true
+
+              # @!method initialize(cost:, feature_id:, warning_code:)
+              #   @param cost [Float] The estimated credit cost contributed by this feature
+              #
+              #   @param feature_id [String] The feature whose meter contributed this cost
+              #
+              #   @param warning_code [Symbol, Stigg::Models::V1::UsageEstimateCostResponse::Data::Estimate::Breakdown::WarningCode, nil] Warning explaining why this cost may be inaccurate, if any
+
+              # Warning explaining why this cost may be inaccurate, if any
+              #
+              # @see Stigg::Models::V1::UsageEstimateCostResponse::Data::Estimate::Breakdown#warning_code
+              module WarningCode
+                extend Stigg::Internal::Type::Enum
+
+                UNSUPPORTED_AGGREGATION = :UNSUPPORTED_AGGREGATION
+
+                # @!method self.values
+                #   @return [Array<Symbol>]
+              end
+            end
+          end
+
+          module Warning
+            extend Stigg::Internal::Type::Enum
+
+            RESOURCE_SCOPED_SUBSCRIPTION_EXISTS = :RESOURCE_SCOPED_SUBSCRIPTION_EXISTS
+            FEATURE_NOT_FOUND = :FEATURE_NOT_FOUND
+            FEATURE_NOT_CREDIT_BASED = :FEATURE_NOT_CREDIT_BASED
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+      end
+    end
+  end
+end

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

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

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

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

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

@@ -15,6 +15,12 @@ module Stigg
         # @return [Stigg::Resources::V1::Customers::Integrations]
         attr_reader :integrations
 
+        # @return [Stigg::Resources::V1::Customers::Events]
+        attr_reader :events
+
+        # @return [Stigg::Resources::V1::Customers::Usage]
+        attr_reader :usage
+
         # Some parameter documentations has been truncated, see
         # {Stigg::Models::V1::CustomerRetrieveParams} for more details.
         #
@@ -316,8 +322,7 @@ module Stigg
         # Some parameter documentations has been truncated, see
         # {Stigg::Models::V1::CustomerProvisionParams} for more details.
         #
-        # Creates a new customer and optionally provisions an initial subscription in a
-        # single operation.
+        # Creates a new customer.
         #
         # @overload provision(id:, billing_currency: nil, billing_id: nil, coupon_id: nil, default_payment_method: nil, email: nil, integrations: nil, language: nil, metadata: nil, name: nil, passthrough: nil, timezone: nil, x_account_id: nil, x_environment_id: nil, request_options: {})
         #
@@ -450,6 +455,8 @@ module Stigg
           @payment_method = Stigg::Resources::V1::Customers::PaymentMethod.new(client: client)
           @promotional_entitlements = Stigg::Resources::V1::Customers::PromotionalEntitlements.new(client: client)
           @integrations = Stigg::Resources::V1::Customers::Integrations.new(client: client)
+          @events = Stigg::Resources::V1::Customers::Events.new(client: client)
+          @usage = Stigg::Resources::V1::Customers::Usage.new(client: client)
         end
       end
     end

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

@@ -86,7 +86,9 @@ module Stigg
             # {Stigg::Models::V1::Events::DataExport::DestinationDeleteParams} for more
             # details.
             #
-            # Remove a destination from the DATA_EXPORT integration metadata. Idempotent.
+            # Disconnect a destination: stops the provider sync (deletes the provider
+            # destination) and removes it from the DATA_EXPORT integration. Non-destructive —
+            # the warehouse table is left intact. Idempotent.
             #
             # @overload delete(destination_id, x_account_id: nil, x_environment_id: nil, request_options: {})
             #

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

@@ -11,6 +11,45 @@ module Stigg
         # @return [Stigg::Resources::V1::Events::Beta]
         attr_reader :beta
 
+        # Some parameter documentations has been truncated, see
+        # {Stigg::Models::V1::EventEstimateCostParams} for more details.
+        #
+        # Estimates the credit cost of a usage event without ingesting it. Returns the
+        # estimated cost per credit currency, the current balance, and the balance after
+        # the estimated consumption.
+        #
+        # @overload estimate_cost(customer_id:, event_name:, dimensions: nil, resource_id: nil, x_account_id: nil, x_environment_id: nil, request_options: {})
+        #
+        # @param customer_id [String] Body param: Customer id
+        #
+        # @param event_name [String] Body param: The name of the usage event
+        #
+        # @param dimensions [Hash{Symbol=>String, Float, Boolean}] Body param: Dimensions associated with the usage event
+        #
+        # @param resource_id [String, nil] Body param: Resource id
+        #
+        # @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::V1::EventEstimateCostResponse]
+        #
+        # @see Stigg::Models::V1::EventEstimateCostParams
+        def estimate_cost(params)
+          parsed, options = Stigg::V1::EventEstimateCostParams.dump_request(params)
+          header_params = {x_account_id: "x-account-id", x_environment_id: "x-environment-id"}
+          @client.request(
+            method: :post,
+            path: "api/v1/events/estimate",
+            headers: parsed.slice(*header_params.keys).transform_keys(header_params),
+            body: parsed.except(*header_params.keys),
+            model: Stigg::Models::V1::EventEstimateCostResponse,
+            options: options
+          )
+        end
+
         # Some parameter documentations has been truncated, see
         # {Stigg::Models::V1::EventReportParams} for more details.
         #