billingrails 0.1.5 → 0.1.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7a5b67a14d5de893e9a3ee00b839d59c99661274987a60d80daf906962ad45a6
-  data.tar.gz: 698cd398f19a126ba47bc1f045d36baf17d8e60968c4cbd6c0cdd35f82605115
+  metadata.gz: 6e7060b0d621a12ffd9d32d45ae3ae37008c7ccb639aeaa01c17fd3ed8d9db97
+  data.tar.gz: a3f901c1ddd2c84196041fbf5394d2e467ed188c052fef3323df1de42d3e3880
 SHA512:
-  metadata.gz: d60ec418d12ada5c355e3fc1e5a121f38458ab9ba5ca727cfb333a215f6e5b98267c7fdc53eb9180fb71cfee600411611349b4975108c1c47e2cd2692ea0ebf9
-  data.tar.gz: 5ec2da2339853212f4ca5ffc504fe6b7d3861344a196cb79ebc682da86ca3a2c4cf5342da3797b6f9874bcc30a900d0fa110485cfaaff690fa1704352f06b326
+  metadata.gz: c36ce4151f805a5e5b1e4b932996fd0b9c583787f3f3082fb607919cd1aaf02227cf21bb4ceaa29f7af7209ca732e7eb6b765470af6f207a83c497bd09ba00ad
+  data.tar.gz: 11334c3a58ab78315561ae71cdcd5509a53f9fb1d9b6416fab058b87f53616784acd6935eb1c3dec42f1deea4aadecc362befc72e0dd2a7b07462b8d04eb3ae4

data/lib/billingrails/client.rb

@@ -9,8 +9,11 @@ module Billingrails
   class Client
     DEFAULT_BASE_URL = 'https://api.billingrails.com/v1'
     DEFAULT_TIMEOUT = 30
+    DEFAULT_MAX_RETRIES = 3
 
-    attr_reader :api_key, :base_url, :timeout
+    RETRYABLE_HTTP_STATUSES = [429, 500, 502, 503, 504].freeze
+
+    attr_reader :api_key, :base_url, :timeout, :max_retries
     attr_reader :accounts, :invoices, :payments, :payment_links
     attr_reader :events, :meters, :plans, :fees, :prices, :subscriptions
     attr_reader :discounts, :credit_grants
@@ -20,10 +23,12 @@ module Billingrails
     # @param api_key [String] Your API key
     # @param base_url [String] Base URL for API requests
     # @param timeout [Integer] Request timeout in seconds
-    def initialize(api_key:, base_url: DEFAULT_BASE_URL, timeout: DEFAULT_TIMEOUT)
+    # @param max_retries [Integer] Max attempts per call for retryable HTTP statuses (see RETRYABLE_HTTP_STATUSES); connection errors are not retried. Default 3.
+    def initialize(api_key:, base_url: DEFAULT_BASE_URL, timeout: DEFAULT_TIMEOUT, max_retries: DEFAULT_MAX_RETRIES)
       @api_key = api_key
       @base_url = base_url.chomp('/')
       @timeout = timeout
+      @max_retries = max_retries
       validate_config!
 
       # Initialize top-level resources
@@ -35,9 +40,8 @@ module Billingrails
 
       @subscriptions = Resources::Subscriptions.new(self)
       @products = Resources::Products.new(self)
-      @fees = Resources::Fees.new(self)
       @prices = Resources::Prices.new(self)
-      @offerings = Resources::Offerings.new(self)
+      @plans = Resources::Plans.new(self)
       @events = Resources::Events.new(self)
       @meters = Resources::Meters.new(self)
 
@@ -55,10 +59,43 @@ module Billingrails
     # @return [Hash] Parsed response body
     def request(method, path, body: nil, params: nil)
       uri = build_uri(path, params)
-      request = build_request(method, uri, body)
-      
-      response = execute_request(uri, request)
-      handle_response(response)
+      http_request = build_request(method, uri, body)
+
+      last_exception = nil
+      last_error_response = nil
+
+      @max_retries.times do |attempt|
+        begin
+          response = execute_request(uri, http_request)
+        rescue StandardError => e
+          last_exception = e
+          break
+        end
+
+        last_exception = nil
+        code = response.code.to_i
+
+        if (200..299).cover?(code)
+          return {} if response.body.nil? || response.body.empty?
+          return JSON.parse(response.body)
+        end
+
+        if attempt < @max_retries - 1 && retryable_status?(code)
+          sleep(2**attempt)
+          next
+        end
+
+        last_error_response = response
+        break
+      end
+
+      if last_error_response
+        handle_response(last_error_response)
+      elsif last_exception
+        raise ConnectionError, "Failed to connect to API: #{last_exception.message}"
+      else
+        raise ConnectionError, 'Failed to connect to API'
+      end
     end
 
     private
@@ -67,6 +104,10 @@ module Billingrails
       raise ArgumentError, 'api_key is required' if @api_key.nil? || @api_key.empty?
     end
 
+    def retryable_status?(code)
+      RETRYABLE_HTTP_STATUSES.include?(code)
+    end
+
     def build_uri(path, params)
       uri = URI.parse("#{@base_url}#{path}")
       if params && !params.empty?
@@ -104,11 +145,7 @@ module Billingrails
       http.read_timeout = @timeout
       http.open_timeout = @timeout
 
-      begin
-        http.request(request)
-      rescue StandardError => e
-        raise ConnectionError, "Failed to connect to API: #{e.message}"
-      end
+      http.request(request)
     end
 
     def handle_response(response)
@@ -134,13 +171,15 @@ module Billingrails
     def handle_error_response(response, error_class)
       error_data = JSON.parse(response.body) rescue {}
       message = error_data['message'] || response.message
-      
+      nested = error_data['error']
+      nested = {} unless nested.is_a?(Hash)
+
       raise error_class.new(
         message,
         status: response.code.to_i,
-        code: error_data['error']['code'],
-        type: error_data['error']['type'],
-        details: error_data['error']['details']
+        code: nested['code'],
+        type: nested['type'],
+        details: nested['details']
       )
     end
   end

data/lib/billingrails/resources/{offerings.rb → plans.rb}

@@ -4,100 +4,100 @@
 
 module Billingrails
   module Resources
-    # Offerings resource
-    class Offerings
+    # Plans resource
+    class Plans
       # @param client [Client] The API client
       def initialize(client)
         @client = client
       end
 
-      # List offerings
+      # List plans
       #
-      # Retrieves a list of offerings.
+      # Retrieves a list of plans.
       #
       # @param params [Hash, nil] Query parameters
       # @return [Hash] Response data
       def list(params: nil)
-        path = "/offerings"
+        path = "/plans"
         @client.request(:get, path, params: params)
       end
 
-      # Create an offering
+      # Create a plan
       #
-      # Creates an offering with optional items (products/fees and prices).
+      # Creates a plan.
       #
       # @param data [Hash] Request body
       # @return [Hash] Response data
       def create(data)
-        path = "/offerings"
+        path = "/plans"
         @client.request(:post, path, body: data)
       end
 
-      # Retrieve an offering
+      # Retrieve a plan
       #
-      # Retrieves an offering by ID.
+      # Retrieves a plan by ID.
       #
       # @param id [String] Resource ID
       # @param params [Hash, nil] Query parameters
       # @return [Hash] Response data
       def retrieve(id, params: nil)
-        path = "/offerings/#{id}"
+        path = "/plans/#{id}"
         @client.request(:get, path, params: params)
       end
 
-      # Update an offering
+      # Update a plan
       #
-      # Updates an offering (name, description, trial_period_days, items). Fails if the offering is used by any subscription.
+      # Updates a plan.
       #
       # @param id [String] Resource ID
       # @param data [Hash] Request body
       # @return [Hash] Response data
       def update(id, data)
-        path = "/offerings/#{id}"
+        path = "/plans/#{id}"
         @client.request(:put, path, body: data)
       end
 
-      # Delete an offering
+      # Delete a plan
       #
-      # Soft-deletes an offering. Fails if the offering is used by any subscription.
+      # Deletes a plan.
       #
       # @param id [String] Resource ID
       # @return [Hash] Response data
       def delete(id)
-        path = "/offerings/#{id}"
+        path = "/plans/#{id}"
         @client.request(:delete, path)
       end
 
-      # Archive an offering
+      # Archive a plan
       #
-      # Archives an offering. Fails if the offering is used by any subscription.
+      # Archives a plan.
       #
       # @param id [String] Resource ID
       # @return [Hash] Response data
       def archive(id)
-        path = "/offerings/#{id}/archive"
+        path = "/plans/#{id}/archive"
         @client.request(:post, path)
       end
 
-      # Unarchive an offering
+      # Unarchive a plan
       #
-      # Restores an archived offering to active status.
+      # Restores an archived plan.
       #
       # @param id [String] Resource ID
       # @return [Hash] Response data
       def unarchive(id)
-        path = "/offerings/#{id}/unarchive"
+        path = "/plans/#{id}/unarchive"
         @client.request(:post, path)
       end
 
-      # Duplicate an offering
+      # Duplicate a plan
       #
-      # Creates a new offering with the same attributes and items. The new offering's origin_id is set to the source offering.
+      # Creates a new plan with the same attributes and items. The new plan's origin_id is set to the source plan.
       #
       # @param id [String] Resource ID
       # @return [Hash] Response data
       def duplicate(id)
-        path = "/offerings/#{id}/duplicate"
+        path = "/plans/#{id}/duplicate"
         @client.request(:post, path)
       end
 

data/lib/billingrails/resources/prices.rb

@@ -11,6 +11,17 @@ module Billingrails
         @client = client
       end
 
+      # List prices
+      #
+      # Retrieves a paginated list of prices.
+      #
+      # @param params [Hash, nil] Query parameters
+      # @return [Hash] Response data
+      def list(params: nil)
+        path = "/prices"
+        @client.request(:get, path, params: params)
+      end
+
       # Create a price
       #
       # Creates a price.
@@ -59,7 +70,7 @@ module Billingrails
 
       # Archive a price
       #
-      # Archives a price, making it inactive for new subscriptions.
+      # Archives a price.
       #
       # @param id [String] Resource ID
       # @return [Hash] Response data
@@ -70,7 +81,7 @@ module Billingrails
 
       # Unarchive a price
       #
-      # Restores an archived price to active status.
+      # Restores an archived price.
       #
       # @param id [String] Resource ID
       # @return [Hash] Response data

data/lib/billingrails/resources/products.rb

@@ -59,7 +59,7 @@ module Billingrails
 
       # Archive a product
       #
-      # Archives a product, making it inactive for new subscriptions.
+      # Archives a product.
       #
       # @param id [String] Resource ID
       # @return [Hash] Response data
@@ -70,7 +70,7 @@ module Billingrails
 
       # Unarchive a product
       #
-      # Restores an archived product to active status.
+      # Restores an archived product.
       #
       # @param id [String] Resource ID
       # @return [Hash] Response data

data/lib/billingrails/resources/tax_rates.rb

@@ -70,7 +70,7 @@ module Billingrails
 
       # Archive a tax rate
       #
-      # Archives a tax rate. Sets status to archived.
+      # Archives a tax rate.
       #
       # @param id [String] Resource ID
       # @return [Hash] Response data

data/lib/billingrails/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Billingrails
-  VERSION = '0.1.5'
+  VERSION = '0.1.7'
 end

data/lib/billingrails.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-# This file is auto-generated. Do not edit manually.
-
 require_relative 'billingrails/version'
 require_relative 'billingrails/errors'
 require_relative 'billingrails/client'
@@ -9,8 +7,7 @@ require_relative 'billingrails/client'
 require_relative 'billingrails/resources/accounts'
 require_relative 'billingrails/resources/checkout_sessions'
 require_relative 'billingrails/resources/events'
-require_relative 'billingrails/resources/fees'
-require_relative 'billingrails/resources/offerings'
+require_relative 'billingrails/resources/plans'
 require_relative 'billingrails/resources/meters'
 require_relative 'billingrails/resources/products'
 require_relative 'billingrails/resources/subscriptions'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: billingrails
 version: !ruby/object:Gem::Version
-  version: 0.1.5
+  version: 0.1.7
 platform: ruby
 authors:
 - Billingrails
@@ -84,12 +84,11 @@ files:
 - lib/billingrails/resources/credit_grants.rb
 - lib/billingrails/resources/discounts.rb
 - lib/billingrails/resources/events.rb
-- lib/billingrails/resources/fees.rb
 - lib/billingrails/resources/invoices.rb
 - lib/billingrails/resources/meters.rb
-- lib/billingrails/resources/offerings.rb
 - lib/billingrails/resources/payment_links.rb
 - lib/billingrails/resources/payments.rb
+- lib/billingrails/resources/plans.rb
 - lib/billingrails/resources/prices.rb
 - lib/billingrails/resources/products.rb
 - lib/billingrails/resources/subscriptions.rb

data/lib/billingrails/resources/fees.rb

@@ -1,94 +0,0 @@
-# frozen_string_literal: true
-
-# This file is auto-generated. Do not edit manually.
-
-module Billingrails
-  module Resources
-    # Fees resource
-    class Fees
-      # @param client [Client] The API client
-      def initialize(client)
-        @client = client
-      end
-
-      # List fees
-      #
-      # Retrieve a list of fees.
-      #
-      # @return [Hash] Response data
-      def list()
-        path = "/fees"
-        @client.request(:get, path)
-      end
-
-      # Create a fee
-      #
-      # Creates a fee.
-      #
-      # @param data [Hash] Request body
-      # @return [Hash] Response data
-      def create(data)
-        path = "/fees"
-        @client.request(:post, path, body: data)
-      end
-
-      # Retrieve fee
-      #
-      # Retrieves a fee by ID.
-      #
-      # @param id [String] Resource ID
-      # @param params [Hash, nil] Query parameters
-      # @return [Hash] Response data
-      def retrieve(id, params: nil)
-        path = "/fees/#{id}"
-        @client.request(:get, path, params: params)
-      end
-
-      # Update a fee
-      #
-      # Updates a fee.
-      #
-      # @param id [String] Resource ID
-      # @param data [Hash] Request body
-      # @return [Hash] Response data
-      def update(id, data)
-        path = "/fees/#{id}"
-        @client.request(:put, path, body: data)
-      end
-
-      # Delete a fee
-      #
-      # Deletes a fee.
-      #
-      # @param id [String] Resource ID
-      # @return [Hash] Response data
-      def delete(id)
-        path = "/fees/#{id}"
-        @client.request(:delete, path)
-      end
-
-      # Archive a fee
-      #
-      # Archives a fee, making it inactive for new subscriptions.
-      #
-      # @param id [String] Resource ID
-      # @return [Hash] Response data
-      def archive(id)
-        path = "/fees/#{id}/archive"
-        @client.request(:post, path)
-      end
-
-      # Unarchive a fee
-      #
-      # Restores an archived fee to active status.
-      #
-      # @param id [String] Resource ID
-      # @return [Hash] Response data
-      def unarchive(id)
-        path = "/fees/#{id}/unarchive"
-        @client.request(:post, path)
-      end
-
-    end
-  end
-end