conexa 0.0.7 → 0.0.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8f797946a06e5b411bab47be327b805494a3baae97afb9faa629d0f5b45318a6
-  data.tar.gz: a4433c392325e634d6ded5996a809dc124a2e1d75c3239af8050fbf8f3402c47
+  metadata.gz: b1dba13ee9b0dc841e758d5cb0b9c468a480ca564129666814c0e25892ea4cff
+  data.tar.gz: 732eebd11f3ec3b5ee727f030ac51493fbce0e6212fb510dfcf5ba476d6424c4
 SHA512:
-  metadata.gz: 780a9f5f20b67d1b8a0917b41ff82e06536a79e9f23c29125c7627f2f84efd084e24d6d435d49603b7d3a1df65a5dd3880dea2c3168af653b71ae75800089fda
-  data.tar.gz: 86bf266d620205ca7d52416775feec983f4d197ade8c241f4812d443b6776c850a12ac66ca3fb517a768f6caa60957843f5bebdb1653e17e590fc40c6338f482
+  metadata.gz: c45016bd74d1e830ae18915be67be0f5a5e5dfc87581a9fe6685775b83c0aa08a4b8a10389d1ae9c92bfbffbf1b1b076b244c736c74002688f6be84e4115f02e
+  data.tar.gz: ff7831e660833da76d85325532889590d27f60451747980427ce7e2d8f7f5e48ec02960d5fdad5bfb5ea7abadab9fdec19e6e30c5bb2adbc0be2e9527680ec3b

data/CHANGELOG.md

@@ -7,6 +7,50 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.0.9] - 2026-03-30
+
+### Added
+- **New pagination model**: `limit`/`offset`/`hasNext` — more efficient, avoids calculating total records
+  - Pass `limit:` to any `.all` or `.find_by` to use the new pagination
+  - Old `page`/`size` pagination emits deprecation warning (deadline: 2026-08-01)
+- **New resources:**
+  - `Conexa::ReceivingMethod` — Meios de Recebimento (`/receivingMethods`, `/receivingMethod/:id`)
+  - `Conexa::PaymentMethod` — Meios de Pagamento (`/paymentMethods`, `/paymentMethod/:id`)
+  - `Conexa::BillCategory` — Categorias de Despesa (`/billCategories`, `/billCategory/:id`)
+  - `Conexa::BillSubcategory` — Subcategorias de Despesa (`/billSubcategories`, `/billSubcategory/:id`)
+  - `Conexa::CostCenter` — Centros de Custo (`/costCenters`, `/costCenter/:id`)
+  - `Conexa::Account` — Contas Bancárias (`/accounts`, `/account/:id`)
+  - `Conexa::ServiceCategory` — Categorias de Serviço (`/serviceCategories`, `/serviceCategory/:id`)
+  - `Conexa::RoomBooking` — Reservas de Sala (`/room/bookings`, `/room/booking`) with cancel, checkout, checkin
+- `Product` now supports full CRUD (POST `/product`, DELETE `/product/:id`) per API v2 update
+
+### Changed
+- `Model#extract_page_size_or_params` rewritten to support dual pagination modes
+- `Customer.persons`, `Customer.contracts`, `Customer.charges` migrated to `limit: 100`
+
+### Fixed
+- `Supplier` list URL corrected from `/supplier` to `/suppliers`
+- `Supplier` now has `primary_key_attribute :supplier_id`
+- `Product` now has `primary_key_attribute :product_id`
+
+## [0.0.8] - 2026-02-19
+
+### Fixed
+- `Auth.login` usava `Request.post` (inclui header Authorization) ao invés de `Request.auth`
+- `Model#primary_key_name` retornava nomes incorretos para classes compostas (ex: `creditcard_id` ao invés de `credit_card_id`)
+- `Model.destroy(id)` falhava para resources com `primary_key_attribute` definido
+- `Model#destroy` retornava Hash interno ao invés de `self`
+- `Person` tinha `find`, `all` e `find_by` desnecessariamente desabilitados (a API suporta todos os endpoints CRUD)
+
+### Added
+- Testes de autenticação com cassettes VCR (13 specs)
+- Testes de integração WebMock para Sale, RecurringSale, Plan, Product, Bill, Supplier, Company, CreditCard, Person e InvoicingMethod
+- Total de testes: 407 specs
+
+### Changed
+- `REFERENCE.md` reescrito com documentação completa de todos os endpoints baseada na collection Postman
+- nokogiri atualizado para 1.19.1
+
 ## [0.0.7] - 2026-02-12
 
 ### Added
@@ -43,7 +87,9 @@ 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.0.7...HEAD
+[Unreleased]: https://github.com/guilhermegazzinelli/conexa-ruby/compare/v0.0.9...HEAD
+[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
 [0.0.7]: https://github.com/guilhermegazzinelli/conexa-ruby/compare/v0.0.6...v0.0.7
 [0.0.6]: https://github.com/guilhermegazzinelli/conexa-ruby/compare/v0.0.5...v0.0.6
 [0.0.5]: https://github.com/guilhermegazzinelli/conexa-ruby/releases/tag/v0.0.5

data/Gemfile

@@ -11,8 +11,6 @@ gem "rspec", "~> 3.0"
 
 gem "rubocop", "~> 1.21"
 
-gem "solargraph"
-
 gem "standard"
 
 gem "debug"

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    conexa (0.0.6)
+    conexa (0.0.9)
       jwt
       multi_json
       rest-client
@@ -23,9 +23,7 @@ GEM
     addressable (2.8.7)
       public_suffix (>= 2.0.2, < 7.0)
     ast (2.4.2)
-    backport (1.2.0)
     base64 (0.2.0)
-    benchmark (0.3.0)
     bigdecimal (3.1.8)
     byebug (11.1.3)
     concurrent-ruby (1.3.4)
@@ -39,7 +37,6 @@ GEM
     diff-lcs (1.5.1)
     domain_name (0.6.20240107)
     drb (2.2.1)
-    e2mmap (0.1.0)
     factory_bot (6.5.0)
       activesupport (>= 5.0.0)
     faker (3.5.1)
@@ -54,14 +51,9 @@ GEM
     irb (1.14.1)
       rdoc (>= 4.0.0)
       reline (>= 0.4.2)
-    jaro_winkler (1.6.0)
     json (2.7.2)
     jwt (3.1.2)
       base64
-    kramdown (2.4.0)
-      rexml
-    kramdown-parser-gfm (1.1.0)
-      kramdown (~> 2.0)
     language_server-protocol (3.17.0.3)
     lint_roller (1.1.0)
     logger (1.6.1)
@@ -72,8 +64,6 @@ GEM
     minitest (5.25.1)
     multi_json (1.19.1)
     netrc (0.11.0)
-    nokogiri (1.16.7-x86_64-linux)
-      racc (~> 1.4)
     parallel (1.26.3)
     parser (3.3.5.0)
       ast (~> 2.4.1)
@@ -84,7 +74,6 @@ GEM
     racc (1.8.1)
     rainbow (3.1.1)
     rake (13.2.1)
-    rbs (2.8.4)
     rdoc (6.7.0)
       psych (>= 4.0.0)
     regexp_parser (2.9.2)
@@ -95,8 +84,6 @@ GEM
       http-cookie (>= 1.0.2, < 2.0)
       mime-types (>= 1.16, < 4.0)
       netrc (~> 0.8)
-    reverse_markdown (2.1.1)
-      nokogiri
     rexml (3.3.8)
     rspec (3.13.0)
       rspec-core (~> 3.13.0)
@@ -128,22 +115,6 @@ GEM
       rubocop-ast (>= 1.31.1, < 2.0)
     ruby-progressbar (1.13.0)
     securerandom (0.3.1)
-    solargraph (0.50.0)
-      backport (~> 1.2)
-      benchmark
-      bundler (~> 2.0)
-      diff-lcs (~> 1.4)
-      e2mmap
-      jaro_winkler (~> 1.5)
-      kramdown (~> 2.3)
-      kramdown-parser-gfm (~> 1.1)
-      parser (~> 3.0)
-      rbs (~> 2.0)
-      reverse_markdown (~> 2.0)
-      rubocop (~> 1.38)
-      thor (~> 1.0)
-      tilt (~> 2.0)
-      yard (~> 0.9, >= 0.9.24)
     standard (1.41.1)
       language_server-protocol (~> 3.17.0.2)
       lint_roller (~> 1.0)
@@ -157,8 +128,6 @@ GEM
       lint_roller (~> 1.1)
       rubocop-performance (~> 1.22.0)
     stringio (3.1.1)
-    thor (1.3.2)
-    tilt (2.4.0)
     tzinfo (2.0.6)
       concurrent-ruby (~> 1.0)
     unicode-display_width (2.6.0)
@@ -168,10 +137,10 @@ GEM
       addressable (>= 2.8.0)
       crack (>= 0.3.2)
       hashdiff (>= 0.4.0, < 2.0.0)
-    yard (0.9.37)
 
 PLATFORMS
-  x86_64-linux
+  ruby
+  x86_64-linux-gnu
 
 DEPENDENCIES
   byebug
@@ -182,7 +151,6 @@ DEPENDENCIES
   rake (~> 13.0)
   rspec (~> 3.0)
   rubocop (~> 1.21)
-  solargraph
   standard
   vcr
   webmock

data/README.md

@@ -120,12 +120,11 @@ customer.legal_person['cnpj']  # => "99.557.155/0001-90"
 # Update customer
 Conexa::Customer.update(127, name: 'New Name', cell_number: '11888887777')
 
-# List customers with filters
+# List customers with filters (new pagination)
 customers = Conexa::Customer.list(
   company_id: [3],
   is_active: true,
-  page: 1,
-  size: 20
+  limit: 20
 )
 ```
 
@@ -266,10 +265,75 @@ plan.price  # => 99.90
 
 ```ruby
 # List products
-products = Conexa::Product.list(company_id: [3])
+products = Conexa::Product.list(company_id: [3], limit: 50)
 
 # Retrieve product
 product = Conexa::Product.retrieve(101)
+
+# Create product
+product = Conexa::Product.create(name: 'Novo Produto', company_id: 3)
+
+# Delete product
+Conexa::Product.delete(101)
+```
+
+### Receiving Method
+
+```ruby
+methods = Conexa::ReceivingMethod.list(limit: 50)
+method = Conexa::ReceivingMethod.retrieve(11)
+method.name  # => "Cartão de Crédito"
+```
+
+### Payment Method
+
+```ruby
+methods = Conexa::PaymentMethod.list(limit: 50)
+method = Conexa::PaymentMethod.retrieve(2)
+```
+
+### Bill Category / Subcategory
+
+```ruby
+categories = Conexa::BillCategory.list(limit: 50)
+subcategories = Conexa::BillSubcategory.list(limit: 50)
+```
+
+### Cost Center
+
+```ruby
+centers = Conexa::CostCenter.list(limit: 50)
+center = Conexa::CostCenter.retrieve(11)
+```
+
+### Account
+
+```ruby
+accounts = Conexa::Account.list(limit: 50)
+account = Conexa::Account.retrieve(23)
+```
+
+### Service Category
+
+```ruby
+categories = Conexa::ServiceCategory.list(limit: 50)
+category = Conexa::ServiceCategory.retrieve(1)
+```
+
+### Room Booking
+
+```ruby
+# List bookings
+bookings = Conexa::RoomBooking.list(limit: 20)
+
+# Create booking
+booking = Conexa::RoomBooking.create(room_id: 5, customer_id: 127)
+
+# Cancel booking
+Conexa::RoomBooking.cancel(143063)
+
+# Checkin
+Conexa::RoomBooking.checkin(room_id: 5, customer_id: 127)
 ```
 
 ### Credit Card
@@ -306,25 +370,110 @@ company.document  # => "12.345.678/0001-90"
 
 ## Pagination
 
-All list endpoints return paginated results:
+### New Pagination (recommended) — `limit`/`offset`/`hasNext`
 
 ```ruby
-result = Conexa::Customer.list(page: 1, size: 20)
+result = Conexa::Customer.list(limit: 50)
 
-result.data                       # Array of customers
+result.data                    # Array of customers
+result.pagination.limit        # => 50
+result.pagination.offset       # => 0
+result.pagination.has_next     # => true/false
+
+# Iterate through all pages
+offset = 0
+loop do
+  result = Conexa::Customer.list(limit: 50, offset: offset)
+  result.data.each { |customer| process(customer) }
+  break unless result.pagination.has_next
+  offset += 50
+end
+```
+
+### Legacy Pagination (deprecated — will be removed 2026-08-01)
+
+```ruby
+# Still works but emits a deprecation warning
+result = Conexa::Customer.list(page: 1, size: 20)
 result.pagination.current_page    # => 1
 result.pagination.total_pages     # => 10
-result.pagination.total_items     # => 195
-result.pagination.item_per_page   # => 20
+```
+
+### Migration Guide: Legacy → New Pagination
+
+The legacy `page`/`size` pagination is deprecated and will be removed on **2026-08-01**. Follow these steps to migrate:
+
+#### 1. Replace `page`/`size` with `limit`/`offset`
+
+```ruby
+# BEFORE (legacy — deprecated)
+result = Conexa::Customer.list(page: 1, size: 50)
+result = Conexa::Customer.list(page: 2, size: 50)
+
+# AFTER (new)
+result = Conexa::Customer.list(limit: 50)               # offset defaults to 0
+result = Conexa::Customer.list(limit: 50, offset: 50)   # second page
+```
+
+**Conversion formula:** `offset = (page - 1) * size`
 
-# Iterate through pages
+#### 2. Update pagination metadata access
+
+```ruby
+# BEFORE (legacy)
+result.pagination  # => { "page" => 1, "size" => 50, "total" => 150 }
+total_pages = (result.pagination["total"].to_f / size).ceil
+
+# AFTER (new)
+result.pagination.limit      # => 50
+result.pagination.offset     # => 0
+result.pagination.has_next   # => true/false
+```
+
+#### 3. Update iteration loops
+
+```ruby
+# BEFORE (legacy)
+page = 1
 loop do
-  result.data.each { |customer| process(customer) }
-  break if result.pagination.current_page >= result.pagination.total_pages
-  result = Conexa::Customer.list(page: result.pagination.current_page + 1)
+  result = Conexa::Customer.list(page: page, size: 100)
+  break if result.empty?
+  result.data.each { |c| process(c) }
+  page += 1
 end
+
+# AFTER (new)
+offset = 0
+loop do
+  result = Conexa::Customer.list(limit: 100, offset: offset)
+  result.data.each { |c| process(c) }
+  break unless result.pagination.has_next
+  offset += 100
+end
+```
+
+#### 4. Remove positional arguments
+
+```ruby
+# BEFORE (legacy positional args)
+Conexa::Customer.all(2, 50)           # page 2, size 50
+Conexa::Customer.find_by({}, 1, 20)   # page 1, size 20
+
+# AFTER (new keyword args)
+Conexa::Customer.all(limit: 50, offset: 50)
+Conexa::Customer.find_by(limit: 20)
 ```
 
+#### Quick reference
+
+| Legacy | New |
+|---|---|
+| `page: 1, size: 50` | `limit: 50` (offset defaults to 0) |
+| `page: N, size: S` | `limit: S, offset: (N-1)*S` |
+| `pagination["total"]` | `pagination.has_next` |
+| `pagination["page"]` | `pagination.offset` |
+| Positional `(page, size)` | Keyword `limit:`, `offset:` |
+
 ## Error Handling
 
 ```ruby
@@ -360,7 +509,7 @@ end
 
 ## Rate Limiting
 
-The Conexa API has a limit of **100 requests per minute**. Response headers include:
+The Conexa API has a limit of **100 requests per minute** (changing to **60 requests per minute** on 2026-04-27). Response headers include:
 
 - `X-Rate-Limit-Limit`: Maximum requests in 60s
 - `X-Rate-Limit-Remaining`: Remaining requests in 60s

data/README_pt-BR.md

@@ -281,7 +281,7 @@ paginacao = pagina1.pagination
 # paginacao contém total de registros, total de páginas, etc.
 ```
 
-#### Iterando Por Todas as Páginas
+#### Iterando Por Todas as Páginas (legado — depreciado)
 
 ```ruby
 pagina = 1
@@ -301,6 +301,101 @@ loop do
 end
 ```
 
+### Nova Paginação (recomendada) — `limit`/`offset`/`hasNext`
+
+```ruby
+resultado = Conexa::Customer.all(limit: 50)
+
+resultado.data                    # Array de clientes
+resultado.pagination.limit        # => 50
+resultado.pagination.offset       # => 0
+resultado.pagination.has_next     # => true/false
+
+# Iterar por todas as páginas
+offset = 0
+loop do
+  resultado = Conexa::Customer.all(limit: 50, offset: offset)
+  resultado.data.each { |cliente| processa(cliente) }
+  break unless resultado.pagination.has_next
+  offset += 50
+end
+```
+
+### Guia de Migração: Paginação Legada → Nova
+
+A paginação legada `page`/`size` está depreciada e será removida em **01/08/2026**. Siga estes passos para migrar:
+
+#### 1. Substitua `page`/`size` por `limit`/`offset`
+
+```ruby
+# ANTES (legado — depreciado)
+resultado = Conexa::Customer.all(page: 1, size: 50)
+resultado = Conexa::Customer.all(page: 2, size: 50)
+
+# DEPOIS (novo)
+resultado = Conexa::Customer.all(limit: 50)               # offset padrão 0
+resultado = Conexa::Customer.all(limit: 50, offset: 50)   # segunda página
+```
+
+**Fórmula de conversão:** `offset = (page - 1) * size`
+
+#### 2. Atualize o acesso aos metadados de paginação
+
+```ruby
+# ANTES (legado)
+resultado.pagination  # => { "page" => 1, "size" => 50, "total" => 150 }
+total_paginas = (resultado.pagination["total"].to_f / tamanho).ceil
+
+# DEPOIS (novo)
+resultado.pagination.limit      # => 50
+resultado.pagination.offset     # => 0
+resultado.pagination.has_next   # => true/false
+```
+
+#### 3. Atualize os loops de iteração
+
+```ruby
+# ANTES (legado)
+pagina = 1
+loop do
+  resultado = Conexa::Customer.all(page: pagina, size: 100)
+  break if resultado.empty?
+  resultado.data.each { |c| processa(c) }
+  pagina += 1
+end
+
+# DEPOIS (novo)
+offset = 0
+loop do
+  resultado = Conexa::Customer.all(limit: 100, offset: offset)
+  resultado.data.each { |c| processa(c) }
+  break unless resultado.pagination.has_next
+  offset += 100
+end
+```
+
+#### 4. Remova argumentos posicionais
+
+```ruby
+# ANTES (argumentos posicionais legados)
+Conexa::Customer.all(2, 50)           # página 2, tamanho 50
+Conexa::Customer.find_by({}, 1, 20)   # página 1, tamanho 20
+
+# DEPOIS (argumentos nomeados)
+Conexa::Customer.all(limit: 50, offset: 50)
+Conexa::Customer.find_by(limit: 20)
+```
+
+#### Referência rápida
+
+| Legado | Novo |
+|---|---|
+| `page: 1, size: 50` | `limit: 50` (offset padrão 0) |
+| `page: N, size: S` | `limit: S, offset: (N-1)*S` |
+| `pagination["total"]` | `pagination.has_next` |
+| `pagination["page"]` | `pagination.offset` |
+| Posicional `(page, size)` | Nomeado `limit:`, `offset:` |
+
 ### Exemplos
 
 #### Clientes (Customers)