kobana 0.2.2 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 06e867bd6a5f43fffa94d2d2837eff31956d6787b7f9f16f9ec667c3fb9bc701
-  data.tar.gz: 9cacd5ed0e2eb94291f729066fed588e8ec0de72d6f0cef58222682b8d101635
+  metadata.gz: 2c043850d8aa7c1f2df33d4956d25b6606c7318ec32350589ddd2da9fe75ea28
+  data.tar.gz: 81f645783198fa6a2e48f5fd660200c90c8c85cfe8439a4ec4de29a4fe299b0b
 SHA512:
-  metadata.gz: fab7517c0c4a5cd39c0baa101522cd746617223f61b21a718b8a151ea926b07036eeb85b9adaade0fc54c7954079b00219e283c9feeb764fb5901c674ff76bfd
-  data.tar.gz: c6d51837860dc19d7753917359515aae443ffd79298b1b66f8a8c7447905fa70d2c6f8c356e85f995d8e4ec756fdeacd663a108cbde7496e9b09575c3243575f
+  metadata.gz: d165e5d9808c537d5966edaed2734c11b7f1679fd8d98baa37b82870a2f9a2bd9bc104af292af11caabeffd1a7ab28f9e66400d675934646a017cde0a4e3d0e3
+  data.tar.gz: 25e70219061793ec35b1747d193cbee5b524a9abb82a7fc102071b423391a9c18257453fc19c309ef45c76b94363767e1436150d2382598df3b761f866b1c97b

data/README.md

@@ -36,6 +36,8 @@ $ gem install kobana
 
 ### Configuration
 
+#### Global Configuration (Single API Token)
+
 Configure your API key by creating an initializer in your Rails project:
 
 `config/initializers/kobana.rb`
@@ -49,12 +51,52 @@ end
 
 Replace `'YOUR_API_TOKEN'` with your actual API key from the corresponding environment.
 
+#### Multi-Client Configuration (Multiple API Tokens)
+
+For applications that need to work with multiple Kobana accounts simultaneously (e.g., multi-tenant applications), you can create multiple client instances:
+
+```ruby
+# Create separate clients for different accounts
+client1 = Kobana::Client.new(
+  api_token: 'CLIENT1_API_TOKEN',
+  environment: :production
+)
+
+client2 = Kobana::Client.new(
+  api_token: 'CLIENT2_API_TOKEN',
+  environment: :sandbox
+)
+
+# Use client-specific resources
+pix1 = client1.charge.pix.create(attributes)
+pix2 = client2.charge.pix.create(attributes)
+
+# Each client maintains its own configuration
+account1 = client1.financial.account.find(account_id)
+account2 = client2.financial.account.find(account_id)
+```
+
+You can also configure clients after initialization:
+
+```ruby
+client = Kobana::Client.new
+client.configure do |config|
+  config.api_token = 'YOUR_API_TOKEN'
+  config.environment = :production
+  config.custom_headers = { 'X-Custom-Header' => 'Value' }
+  config.debug = true
+end
+```
+
 ### Usage
 
+The gem supports both global configuration (backward compatible) and multi-client usage patterns.
+
 #### **Charges**
 
 ##### Creating a Charge
 
+Using global configuration:
 ```ruby
 attributes = {
   'amount' => 100.50,
@@ -71,7 +113,15 @@ attributes = {
   'custom_data' => '{"order_id": "12345"}'
 }
 
+# Global configuration approach (backward compatible)
 pix = Kobana::Resources::Charge::Pix.create(attributes)
+```
+
+Using client-specific configuration:
+```ruby
+# Client-specific approach
+client = Kobana::Client.new(api_token: 'YOUR_TOKEN')
+pix = client.charge.pix.create(attributes)
 pix.id # 1
 pix.new_record? false
 pix.created? # true
@@ -110,7 +160,7 @@ puts result
 ```ruby
 attributes = { ... }
 
-bank_billet = Kobana::Resources::BankBillet::BankBillet.create(attributes)
+bank_billet = Kobana::Resources::Charge::BankBillet.create(attributes)
 puts bank_billet
 ```
 
@@ -118,13 +168,13 @@ puts bank_billet
 
 ```ruby
 bank_billet_id = 1  # Replace with your charge ID
-bank_billet = Kobana::Resources::BankBillet::BankBillet.find(bank_billet_id)
+bank_billet = Kobana::Resources::Charge::BankBillet.find(bank_billet_id)
 puts bank_billet
 ```
 
 ##### Listing All Bank Billets
 
 ```ruby
-bank_billets = Kobana::Resources::BankBillet::BankBillet.all
+bank_billets = Kobana::Resources::Charge::BankBillet.all
 puts bank_billets
 ```

data/lib/kobana/client.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+module Kobana
+  class Client
+    attr_reader :configuration
+
+    def initialize(api_token: nil, environment: :sandbox, custom_headers: {}, debug: false, **extra_config)
+      @configuration = Configuration.new
+      @configuration.api_token = api_token
+      @configuration.environment = environment
+      @configuration.custom_headers = custom_headers
+      @configuration.debug = debug
+
+      # Allow any additional configuration options
+      extra_config.each do |key, value|
+        @configuration.public_send("#{key}=", value) if @configuration.respond_to?("#{key}=")
+      end
+    end
+
+    def configure
+      yield(@configuration) if block_given?
+    end
+
+    # Dynamically create resource accessors with metaprogramming
+    %i[charge financial admin].each do |resource_type|
+      define_method(resource_type) do
+        instance_variable_get("@#{resource_type}") ||
+          instance_variable_set("@#{resource_type}",
+                                ResourceProxy.new(self, Resources.const_get(resource_type.to_s.capitalize)))
+      end
+    end
+
+    # Generic proxy for all resource modules
+    class ResourceProxy
+      def initialize(client, module_ref)
+        @client = client
+        @module = module_ref
+      end
+
+      def method_missing(method_name, *args, &)
+        # Convert method name to class name (e.g., :pix => Pix, :account_balance => AccountBalance)
+        class_name = method_name.to_s.split("_").map(&:capitalize).join
+
+        # Try to find the resource class
+        if @module.const_defined?(class_name)
+          resource_class = @module.const_get(class_name)
+          # Return a client-bound version of the class
+          resource_class.with_client(@client)
+        else
+          super
+        end
+      end
+
+      def respond_to_missing?(method_name, include_private = false)
+        class_name = method_name.to_s.split("_").map(&:capitalize).join
+        @module.const_defined?(class_name) || super
+      end
+    end
+  end
+end

data/lib/kobana/errors.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module Kobana
+  class Error < StandardError; end
+
+  class ConfigurationError < Error; end
+  class ConnectionError < Error; end
+  class ResourceNotFoundError < Error; end
+  class UnauthorizedError < Error; end
+  class ValidationError < Error; end
+
+  class APIError < Error
+    attr_reader :status, :response_body, :errors
+
+    def initialize(message = nil, status: nil, response_body: nil, errors: nil)
+      @status = status
+      @response_body = response_body
+      @errors = errors
+      super(message || default_message)
+    end
+
+    private
+
+    def default_message
+      "API request failed with status #{status}"
+    end
+  end
+end

data/lib/kobana/resources/base.rb

@@ -10,7 +10,16 @@ module Kobana
       include Operations
 
       class << self
-        attr_accessor :primary_key, :api_version, :resource_endpoint, :errors, :default_attributes
+        attr_accessor :primary_key, :api_version, :resource_endpoint, :errors, :default_attributes, :client
+
+        def with_client(client)
+          @client_classes ||= {}.compare_by_identity
+          @client_classes[client] ||= begin
+            klass = Class.new(self)
+            klass.client = client
+            klass
+          end
+        end
 
         def inherited(subclass)
           super
@@ -34,7 +43,7 @@ module Kobana
         end
 
         def interpolate(template, attributes)
-          template.gsub(/\{([^\}]+)\}/) do
+          template.gsub(/\{([^}]+)\}/) do
             key = Regexp.last_match(1)
             begin
               if key.include?(".")
@@ -62,6 +71,11 @@ module Kobana
         @errors = []
       end
 
+      # Access to client configuration through class
+      def client
+        self.class.client
+      end
+
       def [](key)
         attributes[key.to_sym]
       end

data/lib/kobana/resources/connection.rb

@@ -22,23 +22,44 @@ module Kobana
 
       module ClassMethods
         def headers
+          config = client&.configuration || Kobana.configuration
           {
-            "Authorization" => "Bearer #{Kobana.configuration.api_token}",
+            "Authorization" => "Bearer #{config.api_token}",
             "Content-Type" => "application/json"
-          }.merge(Kobana.configuration.custom_headers)
+          }.merge(config.custom_headers)
         end
 
         def connection
+          config = client&.configuration || Kobana.configuration
+          # Don't cache connection when debugging to ensure logger works
+          return build_connection(config) if config.debug
+
+          @connection ||= build_connection(config)
+        end
+
+        private
+
+        def build_connection(config)
           Faraday.new(url: base_url) do |faraday|
             faraday.request :url_encoded
             faraday.request :json
             faraday.adapter Faraday.default_adapter
             faraday.headers = headers
-            faraday.response :logger, logger if Kobana.configuration.debug
+            faraday.response :logger, logger if config.debug
           end
         end
 
+        public
+
         def multipart_connection
+          config = client&.configuration || Kobana.configuration
+          # Don't cache connection when debugging
+          return build_multipart_connection(config) if config.debug
+
+          @multipart_connection ||= build_multipart_connection(config)
+        end
+
+        def build_multipart_connection(config)
           Faraday.new(url: base_url) do |faraday|
             faraday.request :multipart
             faraday.request :url_encoded
@@ -46,14 +67,14 @@ module Kobana
             faraday.headers = headers.merge(
               "Content-Type" => "multipart/form-data"
             )
-            faraday.response :logger, logger if Kobana.configuration.debug
+            faraday.response :logger, logger if config.debug
           end
         end
 
         def logger
           logger = Logger.new($stdout)
           logger.formatter = proc do |severity, datetime, _progname, msg|
-            redacted_msg = msg.gsub(/(Bearer|Token)\s+[A-Za-z0-9\-_\.]+/, '\1 [REDACTED]')
+            redacted_msg = msg.gsub(/(Bearer|Token)\s+[A-Za-z0-9\-_.]+/, '\1 [REDACTED]')
             "#{severity} #{datetime}: #{redacted_msg}\n"
           end
           logger
@@ -84,7 +105,8 @@ module Kobana
         end
 
         def base_url
-          @base_url ||= BASE_URI[api_version&.to_sym][Kobana.configuration.environment&.to_sym]
+          config = client&.configuration || Kobana.configuration
+          BASE_URI[api_version&.to_sym][config.environment&.to_sym]
         end
       end
     end

data/lib/kobana/resources/operations.rb

@@ -60,7 +60,7 @@ module Kobana
           if options[:find_by_id]
             find(params, options[:find_params]) || create(attributes)
           else
-            find_by(params, options) || create(attributes.merge(params.deep_symbolize_keys))
+            find_by(params, options) || create(attributes.merge(params.deep_symbolize_keys), options)
           end
         end
 
@@ -72,6 +72,22 @@ module Kobana
         end
       end
 
+      def save
+        if new_record?
+          response = self.class.create(attributes)
+          if response.created?
+            @attributes = response.attributes
+            @errors = []
+            true
+          else
+            @errors = response.errors
+            false
+          end
+        else
+          update({})
+        end
+      end
+
       def update(new_attributes = {})
         return if new_attributes.empty?
 
@@ -79,7 +95,7 @@ module Kobana
         response = request(:put, uri, data.to_json)
         case response[:status]
         when 200..204
-          new(response[:data].merge(updated: true))
+          self.class.new(response[:data].merge(updated: true))
         else
           handle_error_response(response)
           resource = self.class.new(attributes.merge(updated: false))

data/lib/kobana/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Kobana
-  VERSION = "0.2.2"
+  VERSION = "0.3.0"
 end

data/lib/kobana.rb

@@ -7,6 +7,7 @@ require "json"
 require "support/string"
 require "support/hash"
 require "kobana/configuration"
+require "kobana/errors"
 
 module Kobana
   class << self
@@ -22,6 +23,7 @@ module Kobana
   end
 
   autoload :Version, "kobana/version"
+  autoload :Client, "kobana/client"
 
   module Resources
     autoload :Base, "kobana/resources/base"

data/lib/support/hash.rb

@@ -1,21 +1,35 @@
 # frozen_string_literal: true
 
-class Hash
-  def deep_symbolize_keys
-    result = {}
-    each do |key, value|
-      sym_key = key.respond_to?(:to_sym) ? key.to_sym : key
-      result[sym_key] =
+unless defined?(ActiveSupport)
+  class Hash
+    unless method_defined?(:deep_symbolize_keys)
+      def deep_symbolize_keys
+        result = {}
+        each do |key, value|
+          sym_key = key.respond_to?(:to_sym) ? key.to_sym : key
+          result[sym_key] = deep_symbolize_value(value)
+        end
+        result
+      end
+
+      private
+
+      def deep_symbolize_value(value)
         case value
         when Hash
           value.deep_symbolize_keys
         when Array
-          value.map { |v| v.is_a?(Hash) ? v.deep_symbolize_keys : v }
+          deep_symbolize_array(value)
         else
           value
         end
+      end
+
+      def deep_symbolize_array(array)
+        array.map do |element|
+          element.is_a?(Hash) ? element.deep_symbolize_keys : element
+        end
+      end
     end
-    result
   end
-  # rubocop:enable Metrics/MethodLength
 end

data/lib/support/string.rb

@@ -1,21 +1,27 @@
 # frozen_string_literal: true
 
-class String
-  def pluralize
-    if end_with?("y") && !%w[a e i o u].include?(self[-2].downcase)
-      "#{self[0..-2]}ies"
-    elsif end_with?("s", "sh", "ch", "x", "z")
-      "#{self}es"
-    else
-      "#{self}s"
+unless defined?(ActiveSupport)
+  class String
+    unless method_defined?(:pluralize)
+      def pluralize
+        if end_with?("y") && !%w[a e i o u].include?(self[-2].downcase)
+          "#{self[0..-2]}ies"
+        elsif end_with?("s", "sh", "ch", "x", "z")
+          "#{self}es"
+        else
+          "#{self}s"
+        end
+      end
     end
-  end
 
-  def underscore
-    word = gsub("::", "/")
-    word.gsub!(/([A-Z]+)([A-Z][a-z])/, '\1_\2')
-    word.gsub!(/([a-z\d])([A-Z])/, '\1_\2')
-    word.tr!("-", "_")
-    word.downcase
+    unless method_defined?(:underscore)
+      def underscore
+        word = gsub("::", "/")
+        word.gsub!(/([A-Z]+)([A-Z][a-z])/, '\1_\2')
+        word.gsub!(/([a-z\d])([A-Z])/, '\1_\2')
+        word.tr!("-", "_")
+        word.downcase
+      end
+    end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: kobana
 version: !ruby/object:Gem::Version
-  version: 0.2.2
+  version: 0.3.0
 platform: ruby
 authors:
 - Kivanio Barbosa
 - Rafael Lima
 bindir: bin
 cert_chain: []
-date: 2025-07-15 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -71,7 +71,9 @@ files:
 - README.md
 - Rakefile
 - lib/kobana.rb
+- lib/kobana/client.rb
 - lib/kobana/configuration.rb
+- lib/kobana/errors.rb
 - lib/kobana/resources/admin/subaccount.rb
 - lib/kobana/resources/base.rb
 - lib/kobana/resources/charge/bank_billet.rb
@@ -109,7 +111,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.1
+rubygems_version: 3.7.1
 specification_version: 4
 summary: Kobana API Client
 test_files: []