vindi-rails 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6f34e79050cac8b00e8adb6757a19bf53c5f8dc6d36e73a9dbd00a9e9d0225eb
-  data.tar.gz: 22e96970c0466b000dfa0335f9b375dd6cd947983796bb726bb4012c2951b704
+  metadata.gz: 9cc70a8b11e2e8ba106e24508d896f8c7d862c576b2a5567b9b761cbf4e576bc
+  data.tar.gz: 80020ce37d9eb50fbdfa3af086787c3f21dec7d9117b910a49f8ef35d699b4d1
 SHA512:
-  metadata.gz: 6a59dcae84e89f32fc84944528ae9e91ec154f85211c66201e88c8742af6129cf5c2d7b883407479cfdbac2112c7541478f43af4c2c662e059aa9ff7b3cec11d
-  data.tar.gz: 7327ed4fc6ededab8b4cb9a3da5baae263818d9567f4133c83faa3f6ec3575f723b586377d2b1a7695bbedda0b8584c79fa8562c2bd00d3d72d91c89f4e4d068
+  metadata.gz: d0ac13636a87643501770e84730fcc00686897057705fba0c2eed3a5f274832afbacbe9601fc81c882559ed6b4befc1afd907d06d66f88e49ccc123d411a9cf9
+  data.tar.gz: d2b83b3553f2850334b1e8820aeceabcce3bef8a49e0132b3afc44da595163eed5f2e3182b5c9483690a4b450be58c99f5ed6a3fefdc1d4bc45efcc8ded24910

data/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 All notable changes to this project will be documented in this file.
 
+---
+## [0.5.0] - 2026-06-21
+
+### Added
+- **Dynamic Multi-Merchant (Multi-Tenancy)**: Added thread-safe dynamic configuration capabilities via `Vindi.with_config` to allow executing blocks of API actions with different credentials or settings temporarily, without affecting other concurrent threads or the global state.
+
 ---
 ## [0.4.0] - 2026-06-15
 

data/CHANGELOG.pt-BR.md

@@ -2,6 +2,12 @@
 
 Todas as alterações notáveis neste projeto serão documentadas neste arquivo.
 
+---
+## [0.5.0] - 21-06-2026
+
+### Adicionado
+- **Multi-Merchant Dinâmico (Multi-Tenancy)**: Suporte a configurações dinâmicas e isoladas por thread (thread-safe) usando `Vindi.with_config` para executar blocos de ações da API com credenciais ou configurações diferentes temporariamente, sem interferir no estado global ou em outras threads concorrentes.
+
 ---
 ## [0.4.0] - 15-06-2026
 

data/README.md

@@ -46,6 +46,20 @@ Vindi.configure do |config|
 end
 ```
 
+### Dynamic Configuration (Multi-Merchant / Multi-Tenancy)
+
+If your application needs to handle multiple Vindi accounts or switch API credentials dynamically (e.g., in a multi-tenant SaaS application), you can use `Vindi.with_config` to run a block with temporary credentials. This operation is thread-safe:
+
+```ruby
+# Switch key and API url dynamically within a block
+Vindi.with_config(api_key: 'another_merchant_api_key', api_url: 'https://gp.vindi.com.br/api/v1') do
+  # Any API call here will use the overridden configuration
+  customers = Vindi::Customer.list
+end
+
+# The original global configuration is automatically restored outside the block
+```
+
 ## Usage
 
 Resources are mapped directly under the `Vindi` namespace.

data/README.pt-BR.md

@@ -46,6 +46,20 @@ Vindi.configure do |config|
 end
 ```
 
+### Configuração Dinâmica (Multi-Merchant / Multi-Tenancy)
+
+Se a sua aplicação precisa lidar com múltiplas contas da Vindi ou alternar credenciais da API dinamicamente (por exemplo, em uma aplicação SaaS multi-tenant), você pode usar `Vindi.with_config` para executar um bloco com credenciais temporárias. Esta operação é segura contra concorrência (thread-safe):
+
+```ruby
+# Altera a chave e a URL da API dinamicamente dentro de um bloco
+Vindi.with_config(api_key: 'outra_chave_api_do_merchant', api_url: 'https://gp.vindi.com.br/api/v1') do
+  # Qualquer chamada de API dentro deste bloco usará as configurações sobrescritas
+  clientes = Vindi::Customer.list
+end
+
+# A configuração global original é restaurada automaticamente fora do bloco
+```
+
 ## Utilização
 
 Os recursos são mapeados diretamente sob o namespace `Vindi`.

data/WIKI.md

@@ -549,4 +549,30 @@ Vindi.configure do |config|
 end
 ```
 
+---
+
+## 7. Dynamic Configuration (Multi-Merchant / Multi-Tenancy)
+
+When building multi-tenant SaaS applications, you may need to perform Vindi API calls on behalf of different merchant accounts, each with its own API key and configuration settings.
+
+To switch configuration settings on the fly in a thread-safe manner, use the `Vindi.with_config` method.
+
+### Example Usage
+
+```ruby
+# The global configuration is configured in the initializer
+# Vindi.configuration.api_key # => "global_api_key"
+
+# Temporarily switch credentials within a block
+Vindi.with_config(api_key: "merchant_b_api_key", api_url: "https://gp.vindi.com.br/api/v1") do
+  # Calls inside this block will use Merchant B's credentials and base URL
+  @plans = Vindi::Plan.list
+end
+
+# Once the block exits, the default global configuration is restored
+# Vindi.configuration.api_key # => "global_api_key"
+```
+
+The config override accepts either a hash of keys (`:api_key`, `:api_url`, `:cache_store`, etc.) or a complete `Vindi::Configuration` instance.
+
 

data/WIKI.pt-BR.md

@@ -549,4 +549,30 @@ Vindi.configure do |config|
 end
 ```
 
+---
+
+## 7. Configuração Dinâmica (Multi-Merchant / Multi-Tenancy)
+
+Ao construir aplicações SaaS multi-tenant, você pode precisar fazer chamadas à API da Vindi em nome de contas de merchants diferentes, cada uma com sua própria chave de API e parâmetros de configuração.
+
+Para alterar as configurações em tempo de execução de forma segura contra concorrência (thread-safe), use o método `Vindi.with_config`.
+
+### Exemplo de Uso
+
+```ruby
+# A configuração global é definida no inicializador (ex: config/initializers/vindi.rb)
+# Vindi.configuration.api_key # => "chave_global"
+
+# Altera temporariamente as credenciais dentro de um bloco
+Vindi.with_config(api_key: "chave_do_merchant_b", api_url: "https://gp.vindi.com.br/api/v1") do
+  # Chamadas de API dentro deste bloco usam a chave e URL do Merchant B
+  @plans = Vindi::Plan.list
+end
+
+# Após a saída do bloco, a configuração global padrão é restaurada automaticamente
+# Vindi.configuration.api_key # => "chave_global"
+```
+
+O override de configuração aceita tanto um hash de chaves (`:api_key`, `:api_url`, `:cache_store`, etc.) quanto uma instância completa da classe `Vindi::Configuration`.
+
 

data/lib/vindi/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Vindi
-  VERSION = "0.4.0"
+  VERSION = "0.5.0"
 end

data/lib/vindi.rb

@@ -1,59 +1,83 @@
-# frozen_string_literal: true
-
-require "rest-client"
-require "json"
-
-require_relative "vindi/version"
-require_relative "vindi/configuration"
-require_relative "vindi/errors"
-require_relative "vindi/client"
-require_relative "vindi/api_operations/create"
-require_relative "vindi/api_operations/delete"
-require_relative "vindi/api_operations/list"
-require_relative "vindi/api_operations/update"
-require_relative "vindi/resource"
-require_relative "vindi/railtie" if defined?(Rails)
-
-# Load all resources
-require_relative "vindi/resources/customer"
-require_relative "vindi/resources/payment_profile"
-require_relative "vindi/resources/subscription"
-require_relative "vindi/resources/charge"
-require_relative "vindi/resources/plan"
-require_relative "vindi/resources/product"
-require_relative "vindi/resources/payment_method"
-require_relative "vindi/resources/discount"
-require_relative "vindi/resources/product_item"
-require_relative "vindi/resources/period"
-require_relative "vindi/resources/bill"
-require_relative "vindi/resources/bill_item"
-require_relative "vindi/resources/transaction"
-require_relative "vindi/resources/usage"
-require_relative "vindi/resources/invoice"
-require_relative "vindi/resources/movement"
-require_relative "vindi/resources/message"
-require_relative "vindi/resources/export_batch"
-require_relative "vindi/resources/import_batch"
-require_relative "vindi/resources/issue"
-require_relative "vindi/resources/notification"
-require_relative "vindi/resources/merchant"
-require_relative "vindi/resources/merchant_user"
-require_relative "vindi/resources/role"
-require_relative "vindi/resources/user"
-require_relative "vindi/resources/public"
-require_relative "vindi/resources/affiliate"
-require_relative "vindi/resources/partner"
-
-module Vindi
-  class << self
-    attr_writer :configuration
-
-    def configuration
-      @configuration ||= Configuration.new
-    end
-
-    def configure
-      yield(configuration)
-    end
-  end
-end
+# frozen_string_literal: true
+
+require "rest-client"
+require "json"
+
+require_relative "vindi/version"
+require_relative "vindi/configuration"
+require_relative "vindi/errors"
+require_relative "vindi/client"
+require_relative "vindi/api_operations/create"
+require_relative "vindi/api_operations/delete"
+require_relative "vindi/api_operations/list"
+require_relative "vindi/api_operations/update"
+require_relative "vindi/resource"
+require_relative "vindi/railtie" if defined?(Rails)
+
+# Load all resources
+require_relative "vindi/resources/customer"
+require_relative "vindi/resources/payment_profile"
+require_relative "vindi/resources/subscription"
+require_relative "vindi/resources/charge"
+require_relative "vindi/resources/plan"
+require_relative "vindi/resources/product"
+require_relative "vindi/resources/payment_method"
+require_relative "vindi/resources/discount"
+require_relative "vindi/resources/product_item"
+require_relative "vindi/resources/period"
+require_relative "vindi/resources/bill"
+require_relative "vindi/resources/bill_item"
+require_relative "vindi/resources/transaction"
+require_relative "vindi/resources/usage"
+require_relative "vindi/resources/invoice"
+require_relative "vindi/resources/movement"
+require_relative "vindi/resources/message"
+require_relative "vindi/resources/export_batch"
+require_relative "vindi/resources/import_batch"
+require_relative "vindi/resources/issue"
+require_relative "vindi/resources/notification"
+require_relative "vindi/resources/merchant"
+require_relative "vindi/resources/merchant_user"
+require_relative "vindi/resources/role"
+require_relative "vindi/resources/user"
+require_relative "vindi/resources/public"
+require_relative "vindi/resources/affiliate"
+require_relative "vindi/resources/partner"
+
+module Vindi
+  class << self
+    attr_writer :configuration
+
+    def configuration
+      Thread.current[:vindi_config] || @configuration ||= Configuration.new
+    end
+
+    def configure
+      yield(configuration)
+    end
+
+    def with_config(config_override)
+      original_config = Thread.current[:vindi_config]
+      Thread.current[:vindi_config] = build_override_config(config_override)
+      yield
+    ensure
+      Thread.current[:vindi_config] = original_config
+    end
+
+    private
+
+    def build_override_config(override)
+      return override if override.is_a?(Configuration)
+
+      current = Thread.current[:vindi_config] || @configuration || Configuration.new
+      cloned = current.clone
+
+      override.each do |key, value|
+        setter = "#{key}="
+        cloned.public_send(setter, value) if cloned.respond_to?(setter)
+      end
+
+      cloned
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: vindi-rails
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Wesley Lima
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-06-15 00:00:00.000000000 Z
+date: 2026-06-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rest-client