chargebee 2.74.0 → 2.76.0

data/lib/chargebee/models/virtual_bank_account.rb

@@ -14,7 +14,7 @@ module ChargeBee
     options = {
         :isIdempotent => true
       }
-    Request.send('post', uri_path("virtual_bank_accounts","create_using_permanent_token"), params, env, headers,nil, false, jsonKeys, options)
+    Request.send('post', uri_path("virtual_bank_accounts","create_using_permanent_token"), params, env, headers,nil, false, jsonKeys, options, telemetry_resource: "virtualBankAccount", telemetry_operation: "createUsingPermanentToken")
   end
 
   def self.create(params, env=nil, headers={})
@@ -23,21 +23,21 @@ module ChargeBee
     options = {
         :isIdempotent => true
       }
-    Request.send('post', uri_path("virtual_bank_accounts"), params, env, headers,nil, false, jsonKeys, options)
+    Request.send('post', uri_path("virtual_bank_accounts"), params, env, headers,nil, false, jsonKeys, options, telemetry_resource: "virtualBankAccount", telemetry_operation: "create")
   end
 
   def self.retrieve(id, env=nil, headers={})
     jsonKeys = { 
     }
     options = {}
-    Request.send('get', uri_path("virtual_bank_accounts",id.to_s), {}, env, headers,nil, false, jsonKeys, options)
+    Request.send('get', uri_path("virtual_bank_accounts",id.to_s), {}, env, headers,nil, false, jsonKeys, options, telemetry_resource: "virtualBankAccount", telemetry_operation: "retrieve")
   end
 
   def self.list(params={}, env=nil, headers={})
     jsonKeys = { 
     }
     options = {}
-    Request.send_list_request('get', uri_path("virtual_bank_accounts"), params, env, headers,nil, false, jsonKeys, options)
+    Request.send_list_request('get', uri_path("virtual_bank_accounts"), params, env, headers,nil, false, jsonKeys, options, telemetry_resource: "virtualBankAccount", telemetry_operation: "list")
   end
 
   def self.delete(id, env=nil, headers={})
@@ -46,7 +46,7 @@ module ChargeBee
     options = {
         :isIdempotent => true
       }
-    Request.send('post', uri_path("virtual_bank_accounts",id.to_s,"delete"), {}, env, headers,nil, false, jsonKeys, options)
+    Request.send('post', uri_path("virtual_bank_accounts",id.to_s,"delete"), {}, env, headers,nil, false, jsonKeys, options, telemetry_resource: "virtualBankAccount", telemetry_operation: "delete")
   end
 
   def self.delete_local(id, env=nil, headers={})
@@ -55,7 +55,7 @@ module ChargeBee
     options = {
         :isIdempotent => true
       }
-    Request.send('post', uri_path("virtual_bank_accounts",id.to_s,"delete_local"), {}, env, headers,nil, false, jsonKeys, options)
+    Request.send('post', uri_path("virtual_bank_accounts",id.to_s,"delete_local"), {}, env, headers,nil, false, jsonKeys, options, telemetry_resource: "virtualBankAccount", telemetry_operation: "deleteLocal")
   end
 
   end # ~VirtualBankAccount

data/lib/chargebee/models/webhook_endpoint.rb

@@ -13,7 +13,7 @@ module ChargeBee
     options = {
         :isIdempotent => true
       }
-    Request.send('post', uri_path("webhook_endpoints"), params, env, headers,nil, false, jsonKeys, options)
+    Request.send('post', uri_path("webhook_endpoints"), params, env, headers,nil, false, jsonKeys, options, telemetry_resource: "webhookEndpoint", telemetry_operation: "create")
   end
 
   def self.update(id, params={}, env=nil, headers={})
@@ -22,14 +22,14 @@ module ChargeBee
     options = {
         :isIdempotent => true
       }
-    Request.send('post', uri_path("webhook_endpoints",id.to_s), params, env, headers,nil, false, jsonKeys, options)
+    Request.send('post', uri_path("webhook_endpoints",id.to_s), params, env, headers,nil, false, jsonKeys, options, telemetry_resource: "webhookEndpoint", telemetry_operation: "update")
   end
 
   def self.retrieve(id, env=nil, headers={})
     jsonKeys = { 
     }
     options = {}
-    Request.send('get', uri_path("webhook_endpoints",id.to_s), {}, env, headers,nil, false, jsonKeys, options)
+    Request.send('get', uri_path("webhook_endpoints",id.to_s), {}, env, headers,nil, false, jsonKeys, options, telemetry_resource: "webhookEndpoint", telemetry_operation: "retrieve")
   end
 
   def self.delete(id, env=nil, headers={})
@@ -38,14 +38,14 @@ module ChargeBee
     options = {
         :isIdempotent => true
       }
-    Request.send('post', uri_path("webhook_endpoints",id.to_s,"delete"), {}, env, headers,nil, false, jsonKeys, options)
+    Request.send('post', uri_path("webhook_endpoints",id.to_s,"delete"), {}, env, headers,nil, false, jsonKeys, options, telemetry_resource: "webhookEndpoint", telemetry_operation: "delete")
   end
 
   def self.list(params={}, env=nil, headers={})
     jsonKeys = { 
     }
     options = {}
-    Request.send_list_request('get', uri_path("webhook_endpoints"), params, env, headers,nil, false, jsonKeys, options)
+    Request.send_list_request('get', uri_path("webhook_endpoints"), params, env, headers,nil, false, jsonKeys, options, telemetry_resource: "webhookEndpoint", telemetry_operation: "list")
   end
 
   end # ~WebhookEndpoint

data/lib/chargebee/request.rb

@@ -1,7 +1,7 @@
 module ChargeBee
   class Request
 
-    def self.send_list_request(method, url, params={}, env=nil, headers={}, sub_domain=nil, isJsonRequest=nil, jsonKeys={}, options={})
+    def self.send_list_request(method, url, params={}, env=nil, headers={}, sub_domain=nil, isJsonRequest=nil, jsonKeys={}, options={}, telemetry_resource=nil, telemetry_operation=nil)
       serialized = {}
       params.each do |k, v|
         if(v.kind_of? Array)
@@ -9,19 +9,48 @@ module ChargeBee
         end
         serialized["#{k}"] = v
       end
-      self.send(method, url, serialized, env, headers, sub_domain, isJsonRequest=nil, jsonKeys={}, options)
+      self.send(method, url, serialized, env, headers, sub_domain, isJsonRequest, jsonKeys, options, telemetry_resource, telemetry_operation)
     end
 
-    def self.send(method, url, params={}, env=nil, headers={}, sub_domain=nil, isJsonRequest=nil, jsonKeys={}, options={})
+    def self.send(method, url, params={}, env=nil, headers={}, sub_domain=nil, isJsonRequest=nil, jsonKeys={}, options={}, telemetry_resource=nil, telemetry_operation=nil)
+      telemetry_resource, telemetry_operation = normalize_telemetry_args(telemetry_resource, telemetry_operation)
       env ||= ChargeBee.default_env
       ser_params = isJsonRequest ? params : Util.serialize(params, nil, nil, jsonKeys)
-      resp, rheaders, rcode = NativeRequest.request(method, url, env, ser_params||={}, headers, sub_domain, isJsonRequest, options)
-      if resp&.has_key?(:list)
-        ListResult.new(resp[:list], resp[:next_offset], rheaders, rcode)
-      else
-        Result.new(resp, rheaders, rcode)
+      http_url = TelemetryExecutor.build_http_url(env, sub_domain, url)
+      normalized_headers = headers || {}
+
+      TelemetryExecutor.execute(
+        env,
+        telemetry_resource: telemetry_resource,
+        telemetry_operation: telemetry_operation,
+        method: method,
+        http_url: http_url,
+        request_headers: normalized_headers,
+      ) do |telemetry_headers|
+        merged_headers = normalized_headers.dup
+        if telemetry_headers
+          telemetry_headers.each { |key, value| merged_headers[key] = value }
+        end
+        resp, rheaders, rcode = NativeRequest.request(method, url, env, ser_params||={}, merged_headers, sub_domain, isJsonRequest, options)
+        result = if resp && resp.has_key?(:list)
+          ListResult.new(resp[:list], resp[:next_offset], rheaders, rcode)
+        else
+          Result.new(resp, rheaders, rcode)
+        end
+        [rcode.to_i, result]
       end
     end
 
+    def self.normalize_telemetry_args(telemetry_resource, telemetry_operation)
+      if telemetry_resource.is_a?(Hash) && telemetry_operation.nil? &&
+         (telemetry_resource.key?(:telemetry_resource) || telemetry_resource.key?(:telemetry_operation))
+        h = telemetry_resource
+        return [h[:telemetry_resource], h[:telemetry_operation]]
+      end
+
+      [telemetry_resource, telemetry_operation]
+    end
+    private_class_method :normalize_telemetry_args
+
   end
 end

data/lib/chargebee/telemetry/request_telemetry_context.rb

@@ -0,0 +1,29 @@
+# This file is auto-generated by Chargebee.
+# For more information on how to make changes to this file, please see the README.
+# Reach out to dx@chargebee.com for any questions.
+# Copyright 2026 Chargebee Inc.
+
+module ChargeBee
+  module Telemetry
+    # Context passed to TelemetryAdapter#on_request_start.
+    class RequestTelemetryContext
+      attr_reader :span_name, :resource, :operation, :http_method, :http_url, :server_address,
+                  :chargebee_site, :chargebee_api_version, :sdk_name, :sdk_version, :start_attributes
+
+      def initialize(span_name:, resource:, operation:, http_method:, http_url:, server_address:,
+                     chargebee_site:, chargebee_api_version:, sdk_name:, sdk_version:, start_attributes:)
+        @span_name = span_name
+        @resource = resource
+        @operation = operation
+        @http_method = http_method
+        @http_url = http_url
+        @server_address = server_address
+        @chargebee_site = chargebee_site
+        @chargebee_api_version = chargebee_api_version
+        @sdk_name = sdk_name
+        @sdk_version = sdk_version
+        @start_attributes = start_attributes.freeze
+      end
+    end
+  end
+end

data/lib/chargebee/telemetry/request_telemetry_error.rb

@@ -0,0 +1,20 @@
+# This file is auto-generated by Chargebee.
+# For more information on how to make changes to this file, please see the README.
+# Reach out to dx@chargebee.com for any questions.
+# Copyright 2026 Chargebee Inc.
+
+module ChargeBee
+  module Telemetry
+    # Error details attached to RequestTelemetryResult on failed requests.
+    class RequestTelemetryError
+      attr_reader :message, :chargebee_error_code, :chargebee_api_error_type, :chargebee_error_param
+
+      def initialize(message:, chargebee_error_code: nil, chargebee_api_error_type: nil, chargebee_error_param: nil)
+        @message = message
+        @chargebee_error_code = chargebee_error_code
+        @chargebee_api_error_type = chargebee_api_error_type
+        @chargebee_error_param = chargebee_error_param
+      end
+    end
+  end
+end

data/lib/chargebee/telemetry/request_telemetry_result.rb

@@ -0,0 +1,20 @@
+# This file is auto-generated by Chargebee.
+# For more information on how to make changes to this file, please see the README.
+# Reach out to dx@chargebee.com for any questions.
+# Copyright 2026 Chargebee Inc.
+
+module ChargeBee
+  module Telemetry
+    # Result passed to TelemetryAdapter#on_request_end.
+    class RequestTelemetryResult
+      attr_reader :http_status_code, :duration_ms, :error, :end_attributes
+
+      def initialize(http_status_code:, duration_ms:, error:, end_attributes:)
+        @http_status_code = http_status_code
+        @duration_ms = duration_ms
+        @error = error
+        @end_attributes = end_attributes.freeze
+      end
+    end
+  end
+end

data/lib/chargebee/telemetry/telemetry_adapter.rb

@@ -0,0 +1,32 @@
+# This file is auto-generated by Chargebee.
+# For more information on how to make changes to this file, please see the README.
+# Reach out to dx@chargebee.com for any questions.
+# Copyright 2026 Chargebee Inc.
+
+module ChargeBee
+  module Telemetry
+    # Optional telemetry adapter for observability integrations (e.g. OpenTelemetry).
+    #
+    # When not configured, the SDK skips all telemetry work — zero overhead. The SDK stores the
+    # adapter by reference and never clones or deep-copies it.
+    #
+    # Implementations may inject W3C trace context headers (traceparent, tracestate) into
+    # request_headers during on_request_start.
+    module TelemetryAdapter
+      # Called once per SDK API call before the request is sent (including before retries).
+      #
+      # context contains prebuilt start attributes. request_headers is a mutable map for trace propagation.
+      # Returns an opaque handle passed back to on_request_end, or nil if span creation was skipped.
+      def on_request_start(context, request_headers)
+        raise NotImplementedError
+      end
+
+      # Called once per SDK API call after the final response or terminal failure.
+      #
+      # handle is the value returned from on_request_start and may be nil. result contains prebuilt end attributes.
+      def on_request_end(handle, result)
+        raise NotImplementedError
+      end
+    end
+  end
+end

data/lib/chargebee/telemetry/telemetry_attribute_keys.rb

@@ -0,0 +1,33 @@
+# This file is auto-generated by Chargebee.
+# For more information on how to make changes to this file, please see the README.
+# Reach out to dx@chargebee.com for any questions.
+# Copyright 2026 Chargebee Inc.
+
+module ChargeBee
+  module Telemetry
+    # Span attribute keys shared across Chargebee SDKs.
+    module TelemetryAttributeKeys
+      SDK_NAME = 'chargebee-ruby'.freeze
+      TELEMETRY_SPAN_NAME_PREFIX = 'chargebee'.freeze
+
+      HTTP_REQUEST_HEADER_ATTRIBUTE_PREFIX = 'http.request.header.'.freeze
+      CHARGEBEE_TELEMETRY_HEADER_PREFIX = 'chargebee-'.freeze
+      CHARGEBEE_TELEMETRY_HEADER_EXCLUDE_PREFIX = 'chargebee-request-origin-'.freeze
+
+      URL_FULL = 'url.full'.freeze
+      HTTP_REQUEST_METHOD = 'http.request.method'.freeze
+      HTTP_RESPONSE_STATUS_CODE = 'http.response.status_code'.freeze
+      SERVER_ADDRESS = 'server.address'.freeze
+      ERROR_TYPE = 'error.type'.freeze
+      CHARGEBEE_SITE = 'chargebee.site'.freeze
+      CHARGEBEE_API_VERSION = 'chargebee.api_version'.freeze
+      CHARGEBEE_RESOURCE = 'chargebee.resource'.freeze
+      CHARGEBEE_OPERATION = 'chargebee.operation'.freeze
+      CHARGEBEE_SDK_NAME = 'chargebee.sdk.name'.freeze
+      CHARGEBEE_SDK_VERSION = 'chargebee.sdk.version'.freeze
+      CHARGEBEE_ERROR_CODE = 'chargebee.error.code'.freeze
+      CHARGEBEE_ERROR_TYPE = 'chargebee.error.type'.freeze
+      CHARGEBEE_ERROR_PARAM = 'chargebee.error.param'.freeze
+    end
+  end
+end

data/lib/chargebee/telemetry/telemetry_support.rb

@@ -0,0 +1,123 @@
+# This file is auto-generated by Chargebee.
+# For more information on how to make changes to this file, please see the README.
+# Reach out to dx@chargebee.com for any questions.
+# Copyright 2026 Chargebee Inc.
+
+module ChargeBee
+  module Telemetry
+    # Helpers for building standardized Chargebee telemetry context and results.
+    class TelemetrySupport
+      class << self
+        def build_span_name(resource, operation)
+          "#{TelemetryAttributeKeys::TELEMETRY_SPAN_NAME_PREFIX}.#{resource}.#{operation}"
+        end
+
+        def resolve_chargebee_api_version(api_path)
+          api_path == '/api/v1' ? 'v1' : 'v2'
+        end
+
+        def build_request_start_span_attributes(resource, operation, http_method, http_url, server_address,
+                                                chargebee_site, chargebee_api_version, sdk_version, request_headers = {})
+          {
+            TelemetryAttributeKeys::URL_FULL => http_url,
+            TelemetryAttributeKeys::HTTP_REQUEST_METHOD => http_method,
+            TelemetryAttributeKeys::SERVER_ADDRESS => server_address,
+            TelemetryAttributeKeys::CHARGEBEE_SITE => chargebee_site,
+            TelemetryAttributeKeys::CHARGEBEE_API_VERSION => chargebee_api_version,
+            TelemetryAttributeKeys::CHARGEBEE_RESOURCE => resource,
+            TelemetryAttributeKeys::CHARGEBEE_OPERATION => operation,
+            TelemetryAttributeKeys::CHARGEBEE_SDK_NAME => TelemetryAttributeKeys::SDK_NAME,
+            TelemetryAttributeKeys::CHARGEBEE_SDK_VERSION => sdk_version,
+          }.merge(build_request_header_span_attributes(request_headers))
+        end
+
+        # Promotes chargebee-* request headers to http.request.header.* attributes; excludes the chargebee-request-origin-* PII family.
+        def build_request_header_span_attributes(request_headers)
+          attributes = {}
+          return attributes if request_headers.nil?
+
+          request_headers.each do |name, value|
+            next if name.nil? || value.nil?
+
+            lower_name = name.to_s.downcase
+            next unless lower_name.start_with?(TelemetryAttributeKeys::CHARGEBEE_TELEMETRY_HEADER_PREFIX)
+            next if lower_name.start_with?(TelemetryAttributeKeys::CHARGEBEE_TELEMETRY_HEADER_EXCLUDE_PREFIX)
+
+            attributes["#{TelemetryAttributeKeys::HTTP_REQUEST_HEADER_ATTRIBUTE_PREFIX}#{lower_name}"] = value.to_s
+          end
+
+          attributes
+        end
+
+        def build_request_end_span_attributes(http_status_code, error)
+          attributes = {
+            TelemetryAttributeKeys::HTTP_RESPONSE_STATUS_CODE => http_status_code,
+          }
+
+          if error
+            if error.chargebee_api_error_type
+              attributes[TelemetryAttributeKeys::ERROR_TYPE] = error.chargebee_api_error_type
+              attributes[TelemetryAttributeKeys::CHARGEBEE_ERROR_TYPE] = error.chargebee_api_error_type
+            end
+            attributes[TelemetryAttributeKeys::CHARGEBEE_ERROR_CODE] = error.chargebee_error_code if error.chargebee_error_code
+            attributes[TelemetryAttributeKeys::CHARGEBEE_ERROR_PARAM] = error.chargebee_error_param if error.chargebee_error_param
+          end
+
+          attributes
+        end
+
+        def build_request_telemetry_context(resource, operation, http_method, http_url, server_address,
+                                            chargebee_site, chargebee_api_version, sdk_version, request_headers = {})
+          RequestTelemetryContext.new(
+            span_name: build_span_name(resource, operation),
+            resource: resource,
+            operation: operation,
+            http_method: http_method,
+            http_url: http_url,
+            server_address: server_address,
+            chargebee_site: chargebee_site,
+            chargebee_api_version: chargebee_api_version,
+            sdk_name: TelemetryAttributeKeys::SDK_NAME,
+            sdk_version: sdk_version,
+            start_attributes: build_request_start_span_attributes(
+              resource, operation, http_method, http_url, server_address, chargebee_site, chargebee_api_version, sdk_version, request_headers
+            ),
+          )
+        end
+
+        def build_request_telemetry_result(http_status_code, duration_ms, error)
+          RequestTelemetryResult.new(
+            http_status_code: http_status_code,
+            duration_ms: duration_ms,
+            error: error,
+            end_attributes: build_request_end_span_attributes(http_status_code, error),
+          )
+        end
+
+        def extract_request_telemetry_error(err)
+          return nil if err.nil?
+
+          message = err.message.to_s
+          message = 'Chargebee API request failed' if message.empty?
+
+          if err.is_a?(ChargeBee::APIError)
+            return RequestTelemetryError.new(
+              message: message,
+              chargebee_error_code: err.api_error_code,
+              chargebee_api_error_type: err.type.to_s,
+              chargebee_error_param: err.param,
+            )
+          end
+
+          RequestTelemetryError.new(message: message)
+        end
+
+        def extract_http_status_code(err)
+          return err.http_status_code if err.is_a?(ChargeBee::APIError)
+
+          nil
+        end
+      end
+    end
+  end
+end

data/lib/chargebee/telemetry_executor.rb

@@ -0,0 +1,95 @@
+require 'uri'
+
+module ChargeBee
+  class TelemetryExecutor
+    class << self
+      def execute(env, telemetry_resource:, telemetry_operation:, method:, http_url:, request_headers: {})
+        adapter = env.telemetry_adapter
+        if adapter.nil? || telemetry_resource.to_s.empty? || telemetry_operation.to_s.empty?
+          _status, result = yield(nil)
+          return result
+        end
+
+        start = Process.clock_gettime(Process::CLOCK_MONOTONIC)
+        headers = {}
+        handle = start_telemetry(
+          env, adapter, telemetry_resource, telemetry_operation, method, http_url, request_headers, headers
+        )
+
+        begin
+          telemetry_headers = headers.empty? ? nil : headers
+          status_code, result = yield(telemetry_headers)
+          end_telemetry_success(adapter, handle, start, status_code)
+          result
+        rescue => err
+          end_telemetry_failure(adapter, handle, start, err)
+          raise
+        end
+      end
+
+      def build_http_url(env, sub_domain, url)
+        path = url.start_with?('/') ? url : "/#{url}"
+        full = env.api_url(path, sub_domain)
+        uri = URI.parse(full)
+        "#{uri.scheme}://#{uri.host}#{uri.path}"
+      end
+
+      private
+
+      def start_telemetry(env, adapter, resource, operation, method, http_url, request_headers, headers)
+        uri = URI.parse(http_url)
+        host = uri.host || ''
+        api_path = "/api/#{Environment::API_VERSION}"
+        context = Telemetry::TelemetrySupport.build_request_telemetry_context(
+          resource,
+          operation,
+          method.to_s.upcase,
+          http_url,
+          host,
+          env.site,
+          Telemetry::TelemetrySupport.resolve_chargebee_api_version(api_path),
+          ChargeBee::VERSION,
+          request_headers,
+        )
+        safe_on_request_start(env, adapter, context, headers)
+      end
+
+      def end_telemetry_success(adapter, handle, start, http_status_code)
+        duration_ms = elapsed_ms(start)
+        result = Telemetry::TelemetrySupport.build_request_telemetry_result(http_status_code, duration_ms, nil)
+        safe_on_request_end(adapter, handle, result)
+      end
+
+      def end_telemetry_failure(adapter, handle, start, err)
+        status_code = Telemetry::TelemetrySupport.extract_http_status_code(err) || 500
+        duration_ms = elapsed_ms(start)
+        telemetry_error = Telemetry::TelemetrySupport.extract_request_telemetry_error(err)
+        result = Telemetry::TelemetrySupport.build_request_telemetry_result(status_code, duration_ms, telemetry_error)
+        safe_on_request_end(adapter, handle, result)
+      end
+
+      def safe_on_request_start(env, adapter, context, headers)
+        adapter.on_request_start(context, headers)
+      rescue => err
+        log_telemetry_error(env, 'on_request_start', err)
+        nil
+      end
+
+      def safe_on_request_end(adapter, handle, result)
+        adapter.on_request_end(handle, result)
+      rescue => err
+        warn "[ChargeBee] Telemetry adapter on_request_end failed: #{err}"
+      end
+
+      def log_telemetry_error(env, phase, err)
+        return unless env.enable_debug_logs
+
+        warn "[ChargeBee] Telemetry adapter #{phase} failed: #{err}. Continuing without telemetry."
+      end
+
+      def elapsed_ms(start)
+        ((Process.clock_gettime(Process::CLOCK_MONOTONIC) - start) * 1000).round
+      end
+    end
+  end
+end

data/lib/chargebee.rb

@@ -7,6 +7,14 @@ require File.dirname(__FILE__) + '/chargebee/list_result'
 
 require File.dirname(__FILE__) + '/chargebee/errors'
 
+require File.dirname(__FILE__) + '/chargebee/telemetry/telemetry_attribute_keys'
+require File.dirname(__FILE__) + '/chargebee/telemetry/request_telemetry_context'
+require File.dirname(__FILE__) + '/chargebee/telemetry/request_telemetry_error'
+require File.dirname(__FILE__) + '/chargebee/telemetry/request_telemetry_result'
+require File.dirname(__FILE__) + '/chargebee/telemetry/telemetry_adapter'
+require File.dirname(__FILE__) + '/chargebee/telemetry/telemetry_support'
+require File.dirname(__FILE__) + '/chargebee/telemetry_executor'
+
 require File.dirname(__FILE__) + '/chargebee/models/model'
 require File.dirname(__FILE__) + '/chargebee/models/addon'
 require File.dirname(__FILE__) + '/chargebee/models/address'
@@ -121,7 +129,7 @@ require File.dirname(__FILE__) + '/chargebee/models/webhook_endpoint'
 
 module ChargeBee
 
-  VERSION = '2.74.0'
+  VERSION = '2.76.0'
 
   @@default_env = nil
   @@verify_ca_certs = true

data/spec/chargebee/request_telemetry_spec.rb

@@ -0,0 +1,75 @@
+require 'spec_helper'
+
+describe ChargeBee::Request do
+  class InjectTraceAdapter
+    include ChargeBee::Telemetry::TelemetryAdapter
+
+    def on_request_start(_context, request_headers)
+      request_headers['traceparent'] = '00-test-trace'
+      nil
+    end
+
+    def on_request_end(_handle, _result)
+    end
+  end
+
+  it 'does not mutate caller headers when telemetry injects trace headers' do
+    env = ChargeBee::Environment.new(
+      api_key: 'test_key',
+      site: 'acme',
+      telemetry_adapter: InjectTraceAdapter.new,
+    )
+    original_headers = { 'chargebee-foo' => 'bar' }
+    headers = original_headers.dup
+
+    ChargeBee::NativeRequest.expects(:request).with do |_method, _url, _env, _params, merged_headers, *_rest|
+      expect(merged_headers['traceparent']).to eq('00-test-trace')
+      expect(merged_headers['chargebee-foo']).to eq('bar')
+      true
+    end.returns([{}, {}, '200'])
+
+    ChargeBee::Request.send(
+      'get',
+      '/customers',
+      {},
+      env,
+      headers,
+      nil,
+      false,
+      {},
+      {},
+      telemetry_resource: 'customer',
+      telemetry_operation: 'list',
+    )
+
+    expect(headers).to eq(original_headers)
+    expect(headers).not_to have_key('traceparent')
+  end
+
+  it 'accepts nil headers when telemetry injects trace headers' do
+    env = ChargeBee::Environment.new(
+      api_key: 'test_key',
+      site: 'acme',
+      telemetry_adapter: InjectTraceAdapter.new,
+    )
+
+    ChargeBee::NativeRequest.expects(:request).with do |_method, _url, _env, _params, merged_headers, *_rest|
+      expect(merged_headers['traceparent']).to eq('00-test-trace')
+      true
+    end.returns([{}, {}, '200'])
+
+    ChargeBee::Request.send(
+      'get',
+      '/customers',
+      {},
+      env,
+      nil,
+      nil,
+      false,
+      {},
+      {},
+      'customer',
+      'list',
+    )
+  end
+end