chargebee 2.63.0 → 2.64.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 296d2eccf7af2ab3d24e90fe64baa8496761a6785108b62c161fcd2c408f2e61
-  data.tar.gz: 973118c500afa122cdd08536a51fd68e82220be13ddb6dbb6724239bf64a841a
+  metadata.gz: fe14c7cb3dc2b603cd7c604c383759913f023c9a7ea6a35c9a1ce4856f4525ce
+  data.tar.gz: 4e6d015e8e33c469f4a389be822ca917ebc2075fccc63b7c1ff6591190716b7a
 SHA512:
-  metadata.gz: 6e1c0b75e91eb669dbc39baed6b5a9bc018b02c581bb2aeec8927891b82556fda02fa36d58c53560b67a35fd5b377bad4a5e09cd0ffeb7245610dd2964ad6a87
-  data.tar.gz: 75378fd389a1db7c9febff79334d7fc83ad8e151080cc9245c31c8f2fb552d836d2ec698a56c98c35d06530f5a7f8d6ee3b10e309ab5f6addb2ccfa311df99cc
+  metadata.gz: c4c935501f85f6a9ec2e3927df5c7e89b28039825a2e12c8434a38266f47bc0447474bb6392f2ec6b37406c7e893f2324a98ab0843e81b182d321a60dfa148fb
+  data.tar.gz: c6a285b0be75c689686eef529c6ae9b0447ecc1958341e8a9aa5a232ee45c648016d9a8ca71b08a0bc4994adf8b1e62af4cf79bda03c5286317c04717823f3ce

data/CHANGELOG.md

@@ -1,3 +1,19 @@
+### v2.64.0 (2025-11-10)
+* * * 
+
+### Error Handling
+  - Added new `ForbiddenError` class that inherits from `Error`
+  - Enhanced `handle_for_error` method to detect and handle 403 status codes
+  - Provides clear error message: "Access forbidden. You do not have permission to access this resource."
+
+### Code Quality Improvements
+  - Renamed `lib/chargebee/nativeRequest.rb` → `lib/chargebee/native_request.rb` to follow Ruby naming conventions
+  - Refactored `handle_for_error` to return error objects instead of raising them inline (cleaner separation of concerns)
+  - Added YARD documentation for `handle_for_error` method
+
+### Testing
+  - Added comprehensive test coverage for 403 error scenarios
+
 ### v2.63.0 (2025-10-28)
 * * * 
 

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    chargebee (2.63.0)
+    chargebee (2.64.0)
       cgi (>= 0.1.0, < 1.0.0)
 
 GEM

data/chargebee.gemspec

@@ -4,8 +4,8 @@ Gem::Specification.new do |s|
   s.rubygems_version = '1.3.5'
   s.required_ruby_version = '>= 1.9.3'
   s.name              = 'chargebee'
-  s.version           = '2.63.0'
-  s.date              = '2025-10-28'
+  s.version           = '2.64.0'
+  s.date              = '2025-11-10'
   s.summary     = "Ruby client for Chargebee API."
   s.description = "Subscription Billing - Simple. Secure. Affordable. More details at www.chargebee.com."
   s.metadata = {
@@ -140,7 +140,7 @@ Gem::Specification.new do |s|
     lib/chargebee/models/usage_file.rb
     lib/chargebee/models/virtual_bank_account.rb
     lib/chargebee/models/webhook_endpoint.rb
-    lib/chargebee/nativeRequest.rb
+    lib/chargebee/native_request.rb
     lib/chargebee/request.rb
     lib/chargebee/rest.rb
     lib/chargebee/result.rb

data/lib/chargebee/errors.rb

@@ -8,6 +8,8 @@ module ChargeBee
     end
   end
 
+  class ForbiddenError < Error; end
+
   class IOError < Error; end
 
   class APIError < Error

data/lib/chargebee/{nativeRequest.rb → native_request.rb}

@@ -167,26 +167,33 @@ module ChargeBee
       end
     end
 
+    # Handle errors returned by the ChargeBee API.
+    #
+    # @param rcode [Integer] HTTP status code.
+    # @param rbody [String] HTTP response body.
+    #
+    # @return [ChargeBee::Error] Appropriate ChargeBee error object.
     def self.handle_for_error(rcode, rbody)
       return Error.new("No response returned by ChargeBee API. HTTP status code: #{rcode}") if rcode == 204
+      return ForbiddenError.new("Access forbidden. You do not have permission to access this resource.") if rcode == 403
       begin
         error_obj = JSON.parse(rbody)
         error_obj = Util.symbolize_keys(error_obj)
       rescue Exception => e
-        raise Error.new("Error response not in JSON format. The http status code is #{rcode} \n #{rbody.inspect}", e)
+        return Error.new("Error response not in JSON format. The http status code is #{rcode} \n #{rbody.inspect}", e)
       end
-      type = error_obj[:type]
-      case type
+
+      case error_obj[:type]
       when "payment"
-        raise PaymentError.new(rcode, error_obj)
+        PaymentError.new(rcode, error_obj)
       when "operation_failed"
-        raise OperationFailedError.new(rcode, error_obj)
+        OperationFailedError.new(rcode, error_obj)
       when "invalid_request"
-        raise InvalidRequestError.new(rcode, error_obj)
+        InvalidRequestError.new(rcode, error_obj)
       when "ubb_batch_ingestion_invalid_request"
-        raise UbbBatchIngestionInvalidRequestError.new(rcode, error_obj)
+        UbbBatchIngestionInvalidRequestError.new(rcode, error_obj)
       else
-        raise APIError.new(rcode, error_obj)
+        APIError.new(rcode, error_obj)
       end
     end
 

data/lib/chargebee.rb

@@ -1,5 +1,5 @@
 require File.dirname(__FILE__) + '/chargebee/environment'
-require File.dirname(__FILE__) + '/chargebee/nativeRequest'
+require File.dirname(__FILE__) + '/chargebee/native_request'
 require File.dirname(__FILE__) + '/chargebee/util'
 require File.dirname(__FILE__) + '/chargebee/request'
 require File.dirname(__FILE__) + '/chargebee/result'
@@ -98,7 +98,7 @@ require File.dirname(__FILE__) + '/chargebee/models/offer_fulfillment'
 
 module ChargeBee
 
-  VERSION = '2.63.0'
+  VERSION = '2.64.0'
 
   @@default_env = nil
   @@verify_ca_certs = true

data/spec/chargebee/native_request_spec.rb

@@ -141,6 +141,19 @@ module ChargeBee
       end
     end
 
+    it "raises ForbiddenError for 403 status code" do
+      stub_request(:get, "https://dummy.chargebee.com/test").to_return(
+        body: "<html>\r\n<head><title>403 Forbidden</title></head>\r\n<body>\r\n<center><h1>403 Forbidden</h1></center>\r\n</body>\r\n</html>\r\n",
+        status: 403
+      )
+
+      expect {
+        NativeRequest.request(:get, "/test", env)
+      }.to raise_error(ForbiddenError) do |err|
+        expect(err.message).to eq("Access forbidden. You do not have permission to access this resource.")
+      end
+    end
+
     it "retries once on HTTP 503 and succeeds on second attempt" do
       stub_request(:get, "https://dummy.chargebee.com/test")
         .to_return({ status: 503, body: "temporary error" },

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: chargebee
 version: !ruby/object:Gem::Version
-  version: 2.63.0
+  version: 2.64.0
 platform: ruby
 authors:
 - Rajaraman S
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-10-28 00:00:00.000000000 Z
+date: 2025-11-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi
@@ -181,7 +181,7 @@ files:
 - lib/chargebee/models/usage_file.rb
 - lib/chargebee/models/virtual_bank_account.rb
 - lib/chargebee/models/webhook_endpoint.rb
-- lib/chargebee/nativeRequest.rb
+- lib/chargebee/native_request.rb
 - lib/chargebee/request.rb
 - lib/chargebee/rest.rb
 - lib/chargebee/result.rb