conexa 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 76a95e870fc63f79b15b5227f1f0a10d94471efe573662dc626e42e57cf77b82
-  data.tar.gz: 92fce7222c5b9adad92e6524e6dbfb3466bc1282a81768c5872922af37d2085b
+  metadata.gz: c71329999c6d13c4e935ef1e37a8eca6df5811c44d0326184cc1676d31fb199b
+  data.tar.gz: c6f6946375a05712ed7d952a4314738e86a2429bf3a249e269d2fd40b254c11f
 SHA512:
-  metadata.gz: 4071bc748f2855c39eb48e7360bf4d519f0502d898ca7e915c88c41115bb85422766a2e0274d9ab39ac032de69507dd2275b5fa976de26b8dc586846f3089814
-  data.tar.gz: 2962227ceb63eb324be8289502669995d4ac4d1136fd18570f972024b0774e0ff874c5c71d7fca8c296cd882850284415d8ce784312d1867d7471b3783ec79d3
+  metadata.gz: 13fc7859937cd156cd8ae68b78d6c303b62460d4f6e682f270f58927e87c8a99e29e7d43a4814318b53ed5c5e20ce5e0ea3892d46db8d4d08147e9aea79a690e
+  data.tar.gz: c1ae89758b0cea23df6c5f5cc16895c060baef04da9a31fefd58eb7ac9c7ba1b1483dfc44b81c00ddfb592cada2e34cace170237e5f298b3ea8b3217572bd1c9

data/CHANGELOG.md

@@ -7,6 +7,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.1.1] - 2026-03-31
+
+### Added
+- Instance methods `Customer#persons`, `Customer#contracts`, `Customer#charges` for idiomatic Ruby usage
+  - `customer = Conexa::Customer.find(127); customer.persons` — fetches persons for the loaded customer
+- Class methods `Customer.persons(id)`, `Customer.contracts(id)`, `Customer.charges(id)` remain available
+  - Useful to save a request when you don't need the customer data itself
+
+### Changed
+- Customer sub-resource methods now available in both class and instance forms
+
 ## [0.1.0] - 2026-03-31
 
 ### Added
@@ -122,7 +133,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Charge with settle and PIX methods
 - Pagination support
 
-[Unreleased]: https://github.com/guilhermegazzinelli/conexa-ruby/compare/v0.1.0...HEAD
+[Unreleased]: https://github.com/guilhermegazzinelli/conexa-ruby/compare/v0.1.1...HEAD
+[0.1.1]: https://github.com/guilhermegazzinelli/conexa-ruby/compare/v0.1.0...v0.1.1
 [0.1.0]: https://github.com/guilhermegazzinelli/conexa-ruby/compare/v0.0.9...v0.1.0
 [0.0.9]: https://github.com/guilhermegazzinelli/conexa-ruby/compare/v0.0.8...v0.0.9
 [0.0.8]: https://github.com/guilhermegazzinelli/conexa-ruby/compare/v0.0.7...v0.0.8

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    conexa (0.1.0)
+    conexa (0.1.1)
       jwt
       multi_json
       rest-client

data/README.md

@@ -129,6 +129,17 @@ customers = Conexa::Customer.all(
   is_active: true,
   limit: 20
 )
+
+# Sub-resources (instance methods)
+customer = Conexa::Customer.find(127)
+customer.persons     # => persons for this customer
+customer.contracts   # => contracts for this customer
+customer.charges     # => charges for this customer
+
+# Sub-resources (class methods — saves a request)
+Conexa::Customer.persons(127)
+Conexa::Customer.contracts(127)
+Conexa::Customer.charges(127)
 ```
 
 ### Contract

data/README_pt-BR.md

@@ -452,6 +452,21 @@ cliente.destroy
 clientes = Conexa::Customer.find({ name: 'João Silva' }, 1, 20)
 ```
 
+##### Sub-recursos do Cliente
+
+```ruby
+# Via instância (quando já possui o customer carregado)
+cliente = Conexa::Customer.find(127)
+cliente.persons     # => Lista de persons deste cliente
+cliente.contracts   # => Lista de contratos deste cliente
+cliente.charges     # => Lista de cobranças deste cliente
+
+# Via classe (economiza um request, não precisa buscar o customer)
+Conexa::Customer.persons(127)
+Conexa::Customer.contracts(127)
+Conexa::Customer.charges(127)
+```
+
 #### Faturas (Bills)
 
 ##### Criando uma Fatura

data/REFERENCE.md

@@ -32,7 +32,7 @@ Conexa is a Brazilian SaaS platform for **recurring billing**, **subscription ma
 
 ```ruby
 # Gemfile
-gem 'conexa', '~> 0.1.0'
+gem 'conexa', '~> 0.1.1'
 
 # Or install directly
 gem install conexa
@@ -211,7 +211,13 @@ customer.destroy
 # or
 Conexa::Customer.destroy(127)
 
-# Sub-resources
+# Sub-resources (instance methods — requires fetching customer first)
+customer = Conexa::Customer.find(127)
+customer.persons    # List persons for this customer
+customer.contracts  # List contracts for this customer
+customer.charges    # List charges for this customer
+
+# Sub-resources (class methods — saves a request, no need to fetch customer)
 Conexa::Customer.persons(127)    # List persons for customer
 Conexa::Customer.contracts(127)  # List contracts for customer
 Conexa::Customer.charges(127)    # List charges for customer
@@ -1265,6 +1271,10 @@ The API enforces a limit of 100 requests per minute (changing to **60 requests p
 
 ## Version History
 
+- **v0.1.1** - Add instance methods for Customer sub-resources (persons, contracts, charges)
+- **v0.1.0** - Default new pagination, Result#next_page, code review fixes, 502 specs
+- **v0.0.9** - New pagination model (limit/offset), new API v2 resources
+- **v0.0.8** - Fix Auth.login, integration tests, REFERENCE.md rewrite
 - **v0.0.7** - Add Auth resource, fix Auth.login, add test suite with VCR
 - **v0.0.6** - Fix nil guard in camelize_hash, fix Result#empty? delegation
 - **v0.0.5** - Initial public release

data/lib/conexa/resources/customer.rb

@@ -71,22 +71,40 @@ module Conexa
       Address.new(@attributes['address'])
     end
 
+    # List persons (requesters) for this customer
+    # @return [Result] List of persons
+    def persons
+      Conexa::Person.all(customer_id: id, limit: 100)
+    end
+
+    # List contracts for this customer
+    # @return [Result] List of contracts
+    def contracts
+      Conexa::Contract.all(customer_id: [id], limit: 100)
+    end
+
+    # List charges for this customer
+    # @return [Result] List of charges
+    def charges
+      Conexa::Charge.all(customer_id: [id], limit: 100)
+    end
+
     class << self
-      # List persons (requesters) for a customer
+      # List persons (requesters) for a customer without fetching the customer first
       # @param customer_id [Integer] Customer ID
       # @return [Result] List of persons
       def persons(customer_id)
         Conexa::Person.all(customer_id: customer_id, limit: 100)
       end
 
-      # List contracts for a customer
+      # List contracts for a customer without fetching the customer first
       # @param customer_id [Integer] Customer ID
       # @return [Result] List of contracts
       def contracts(customer_id)
         Conexa::Contract.all(customer_id: [customer_id], limit: 100)
       end
 
-      # List charges for a customer
+      # List charges for a customer without fetching the customer first
       # @param customer_id [Integer] Customer ID
       # @return [Result] List of charges
       def charges(customer_id)

data/lib/conexa/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Conexa
-  VERSION = "0.1.0"
+  VERSION = "0.1.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: conexa
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Guilherme Gazzinelli