kobana 0.2.3 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c826dcdcf3f4d824b323ba7ae2c0d6fd53f148c8c785afcd2c6fd34dbdf1593f
-  data.tar.gz: c014e264cf67d522805bbd975e74c4805d9359cb2406589e15bdfd56ba549f6a
+  metadata.gz: 3bc6a9da2db1bd8cb2aa863f729e4ee3ef9cd4c143e9c38e5ce5e64c633e1f98
+  data.tar.gz: 2841dae640966617c6c9a897681cc26ae0ace4c933613ae0147d91ab0ffda53e
 SHA512:
-  metadata.gz: 7487722905d0571414401b83d4255e18779decb322a7b724ab78dea4d6393b4f510be6999395547abba805c6e4362352ad387a8046e204f24134e5fa6edf0ff2
-  data.tar.gz: 40fd5452ee3e80e339930645233b88c59d0530594093e7ccb12b67d36cd584f0d509b910c51c8c241648a384cfb90e54c0149f34322a0113fe4c6446ec0c495c
+  metadata.gz: 1740ebb8d3b894fd4b0b215450ea4563da1ece74da1002d046f874b8661007716989e9ed8c52279ed95983714e42cca1b3bc3a4c05e369910ca2aec6b68b67f8
+  data.tar.gz: 75ec69765d55582b1363d014ba78ebc4e93d5407e6aef4b18020bd1c3c78d1d4c59b8207d0d40bf9522e81a08364e03779d7743ebcd9a8b5894f15d58d91f4bf

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

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/configuration.rb

@@ -2,11 +2,12 @@
 
 module Kobana
   class Configuration
-    attr_accessor :api_token, :environment, :custom_headers, :debug
+    attr_accessor :api_token, :environment, :custom_headers, :debug, :api_version
 
     def initialize
       @custom_headers = {}
       @environment = :sandbox
+      @api_version = :v2
     end
 
     def inspect

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,13 +10,24 @@ 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
+          # Set defaults only if not already set by parent classes
           subclass.resource_endpoint ||= infer_resource_endpoint(subclass)
           subclass.primary_key ||= :uid
-          subclass.api_version ||= :v2
+          # Don't override api_version if it's already been set
+          subclass.api_version = :v2 unless subclass.instance_variable_defined?(:@api_version)
           subclass.errors ||= []
           subclass.default_attributes ||= {}
         end
@@ -34,7 +45,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 +73,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,10 @@ module Kobana
         end
 
         def base_url
-          @base_url ||= BASE_URI[api_version&.to_sym][Kobana.configuration.environment&.to_sym]
+          config = client&.configuration || Kobana.configuration
+          # Prioritize client configuration api_version over class api_version
+          version = config.api_version&.to_sym || api_version&.to_sym
+          BASE_URI[version][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.3"
+  VERSION = "0.3.1"
 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"

metadata

@@ -1,15 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: kobana
 version: !ruby/object:Gem::Version
-  version: 0.2.3
+  version: 0.3.1
 platform: ruby
 authors:
 - Kivanio Barbosa
 - Rafael Lima
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-08-09 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -72,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
@@ -96,7 +97,6 @@ metadata:
   bug_tracker_uri: https://github.com/universokobana/kobana-ruby-client/issues
   documentation_uri: https://github.com/universokobana/kobana-ruby-client/wiki
   rubygems_mfa_required: 'true'
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -111,8 +111,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.23
-signing_key:
+rubygems_version: 3.7.1
 specification_version: 4
 summary: Kobana API Client
 test_files: []