nfe-io 0.3.1 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 0aae1eec0dd11fef2aaa85a5065d1bbf2a0dd32a
-  data.tar.gz: 14e245ee4c618155685fb1b4fdb688b1bb9c950c
+SHA256:
+  metadata.gz: 787947713cf27bbdb1f9e22775e2ef2aa59ef185e4015c8ae74e99864c833e2d
+  data.tar.gz: a32a98bcdbf26b3f4c6a9c143fd46d796d5e5b7e47114309efcb98a0f779f3da
 SHA512:
-  metadata.gz: a872c056d4d66d0e50de1e28d76e3e68f5ef24f789c8fe61cadddc7832d1dc743ba40372942f287f0e82da399ca43166db19cef3ba104b0e75019724a190b72c
-  data.tar.gz: 173e4ef82ece18aab30070a2293cac569573c1c8e0736516d9943037f1b9d1630354d52bbf4db5785dcc4c7ec816827716fd33f09eedbf9b7b003d44d856a045
+  metadata.gz: 495de7c5b904d2de20c731521b8bc608825dbcadb200d86ce98489638a634e57105df3cb17c2b1016c2fb15be59ada705079b624b7343a510dc02f20d6d7dd49
+  data.tar.gz: 37ab16497cb424cc9fb759c0c824c798cdc06fe5fb5ba35da78d2b7d546507cc194150040011510b5a0c7097672da2e7985b7be27b00ca972a9e998977a75498

data/CHANGELOG.md

@@ -0,0 +1,60 @@
+# Changelog
+
+Todas as mudanças relevantes deste projeto são documentadas aqui.
+
+O formato segue o [Keep a Changelog](https://keepachangelog.com/pt-BR/1.1.0/),
+e o projeto adere ao [Versionamento Semântico](https://semver.org/lang/pt-BR/).
+
+## [Não lançado]
+
+## [1.0.0] - 2026-07-02
+
+### Adicionado
+
+- `Nfe::Client.new(api_key:)` — entrypoint por instância (estilo Stripe), com fallback de
+  credencial via `ENV["NFE_API_KEY"]` / `ENV["NFE_DATA_API_KEY"]` (o argumento explícito vence).
+- 19 acessores de recurso `snake_case` e lazy — 17 canônicos (`service_invoices`,
+  `product_invoices`, `consumer_invoices`, `transportation_invoices`,
+  `inbound_product_invoices`, `product_invoice_query`, `consumer_invoice_query`, `companies`,
+  `legal_people`, `natural_people`, `webhooks`, `addresses`, `legal_entity_lookup`,
+  `natural_person_lookup`, `tax_calculation`, `tax_codes`, `state_taxes`) mais 2 RTC
+  (`service_invoices_rtc`, `product_invoices_rtc`).
+- Modelos imutáveis `Data.define` gerados a partir das specs OpenAPI, com assinaturas RBS
+  (`sig/**/*.rbs`) verificáveis pelo Steep e empacotadas na gem para type-check no consumidor.
+- Contrato assíncrono 202 discriminado: `create` retorna um `*Pending`
+  (`pending? -> true`/`issued? -> false`) ou um `*Issued` (`issued? -> true`); polling via
+  `retrieve` até `Nfe::FlowStatus.terminal?(flow_status)`.
+- Emissão RTC com tributos IBS/CBS/IS (`service_invoices_rtc`, `product_invoices_rtc`).
+- Verificação de webhook HMAC-SHA1 sobre os bytes crus da requisição
+  (`Nfe::Webhook.verify_signature`, comparação timing-safe, nunca levanta exceção) e
+  `Nfe::Webhook.construct_event`.
+- Roteamento multi-host automático por recurso (`api.nfe.io`, `api.nfse.io`,
+  `address.api.nfe.io`, `legalentity.api.nfe.io`, `naturalperson.api.nfe.io`, `nfe.api.nfe.io`).
+- Retry com backoff configurável (`max_retries`) para falhas transitórias.
+- Downloads binários (String `ASCII-8BIT`) para a maioria dos recursos; exceção:
+  `product_invoices` e `product_invoices_rtc` retornam `Nfe::NfeFileResource` (value object `{uri}`).
+- `Nfe::DateNormalizer` para normalização consistente de datas.
+- Modelo de duas chaves (`api_key` + `data_api_key`) com seleção automática por família de recurso.
+
+### Alterado
+
+- Namespace unificado em `Nfe`.
+- Piso de Ruby elevado para **3.2+**.
+- Paginação suporta os dois estilos da API: por página (`service_invoices`) e por cursor
+  (`product`/`consumer`/`state_taxes`), via `Nfe::ListResponse`/`Nfe::ListPage`.
+- Configuração migrada da API global para `Nfe::Client` por instância — ver `MIGRATION.md`.
+
+### Removido
+
+- Dependência de runtime `rest-client`.
+- Configuração global `Nfe.api_key`.
+- Classes achatadas da série `0.3.x` (ex.: `Nfe::ServiceInvoice.company_id(...).create`),
+  preservadas no branch `0.x-legacy`.
+
+## [0.3.2]
+
+- Última versão da série `0.x` (legada, baseada em `rest-client`). Congelada, sem manutenção.
+
+[Não lançado]: https://github.com/nfe/client-ruby/compare/v1.0.0...HEAD
+[1.0.0]: https://github.com/nfe/client-ruby/compare/v0.3.2...v1.0.0
+[0.3.2]: https://github.com/nfe/client-ruby/releases/tag/v0.3.2