snoopy_afip 4.3.0 → 4.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ddb431b984f379cd6f6030e90734cf449d025e804cacdc039a746bd5f2ab44b4
-  data.tar.gz: cc2af52ee88ac9e1abcb9f6d7f478f6dbaad8abe99e5b51c7585f0e5ec7c856e
+  metadata.gz: 35130f258e01ade599f3cc2926ba8db91fb5f3b89692a55376e087575f399a1b
+  data.tar.gz: d708113acb8d0a3a7e3c01cb34482f8082ac790e69716217597d6645042414e3
 SHA512:
-  metadata.gz: 260af80a82dbde4632293ee5458acdfff10fd98f33412e21c18d24b07fbe88e29eafda3d98d84fadda48e51cf793f45e59ac2ecc0c156a68d0c552b8bace6852
-  data.tar.gz: 4d6f545f2004b35986f41d2e7f67ba931dbc4a056f948a5b670ab66a7cd7201aba9c6cd461efe511d3a13800f79cb61c6fa9baecc93048c244ff34013367ba53
+  metadata.gz: 559248bc96a670668347e0707567d5b24f54732a9a08ef40dddc40d68cd53764fd19914efea411d8902ed277655e5cca27e7279b099d1a933a4a31ff4827c577
+  data.tar.gz: 3e56da1b87f9e1a019de90c662c9dadf9ede67197faab7c6c2370f660a342864f600588a2ab5751c4a578efb441a282a67767f8fa6f187be8cea24932bc8c05d

data/.github/workflows/main.yml

@@ -0,0 +1,31 @@
+name: Ruby
+
+on:
+  push:
+    branches:
+      - master
+
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    name: Ruby ${{ matrix.ruby }}
+    strategy:
+      matrix:
+        ruby:
+          # La gema en master corre sobre el stack savon 2.12 (httpi 2.x), que
+          # requiere Ruby 2.7. Al mergear el upgrade a savon 2.17 (#19), subir a 3.x.
+          - '2.7'
+
+    steps:
+      - uses: actions/checkout@v5
+        with:
+          persist-credentials: false
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby }}
+          bundler-cache: true
+      - name: Run specs
+        run: bundle exec rspec

data/.github/workflows/release.yml

@@ -0,0 +1,33 @@
+name: Publish to RubyGems
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  build:
+    name: Build + Publish
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+
+    steps:
+    - uses: actions/checkout@v5
+
+    - name: Set up Ruby
+      uses: ruby/setup-ruby@v1
+      with:
+        ruby-version: '3.2'
+
+    - name: Publish to RubyGems
+      run: |
+        mkdir -p $HOME/.gem
+        touch $HOME/.gem/credentials
+        chmod 0600 $HOME/.gem/credentials
+        printf -- "---\n:rubygems_api_key: ${RUBYGEMS_API_KEY}\n" > $HOME/.gem/credentials
+        gem build *.gemspec
+        gem push *.gem
+      env:
+        RUBYGEMS_API_KEY: ${{ secrets.RUBYGEMS_API_KEY }}

data/AGENTS.md

@@ -0,0 +1,100 @@
+# AGENTS.md — snoopy_afip
+
+Fuente de verdad para reglas, convenciones, estructura, documentación, entorno y arquitectura de esta gema. Leer antes de hacer cambios.
+
+## 1. Identidad
+
+`snoopy_afip` es una gema Ruby que adapta la **Facturación Electrónica de AFIP (Argentina)**. Expone el módulo `Snoopy`.
+
+Resuelve dos servicios SOAP de AFIP (vía `savon`):
+
+- **WSAA** (autenticación): obtiene `token`, `sign` y `expiration_time` a partir de una clave privada y un certificado. Implementado en `Snoopy::AuthenticationAdapter`.
+- **WSFE** (autorización de comprobantes electrónicos): autoriza facturas/notas de crédito contra el web service. Implementado en `Snoopy::AuthorizeAdapter`, operando sobre objetos `Snoopy::Bill`.
+
+Verificado en: `snoopy_afip.gemspec` (`summary = "Adaptador AFIP wsfe."`, `description = "Adaptador para Web Service de Facturación Electrónica Argentina (AFIP)"`), `README.md` y `lib/`.
+
+## 2. Convenciones del framework
+
+El repo consume skills del framework de agentes, declaradas en `skills.yml`. Las skills se sincronizan en `.agents/skills/` y traen conocimiento específico de cada herramienta o dependencia.
+
+- Antes de responder o actuar sobre un tema cubierto por una skill, leer la skill correspondiente en `.agents/skills/`.
+- Skills declaradas hoy (`skills.yml`): `multi-vendor-feedback`, `yard`, `quality-code`, `gem-release`, `arch-structure`, `arch-compose`, `arch-enrich`, `skill-feedback`, `agent-issue`, `bug-report`, `dev-flow`, `documentation-writer`, `matrix-element`.
+- MCPs declarados: `github`, `clickup`.
+
+## 3. Entorno
+
+- Lenguaje: **Ruby**. No hay `.ruby-version` en el repo (no fijar una versión que no esté declarada).
+- Dependencias resueltas en `Gemfile.lock`. Dependencia de runtime principal: `savon ~> 2.12.1` (cliente SOAP), declarada en el `.gemspec`.
+- Gestión de versiones de Ruby con **chruby** (no rvm, no rbenv).
+- **Bundler** para dependencias (`BUNDLED WITH 2.1.4` en `Gemfile.lock`). Instalar con `bundle install`.
+
+## 4. RuboCop
+
+Esta gema **no** tiene `.rubocop.yml` configurado actualmente. La skill `quality-code` está declarada en `skills.yml` para calidad de código. Aplicar las reglas de calidad solo si se incorpora una configuración de RuboCop al repo; en ese caso, correr `bundle exec rubocop -a` antes de commitear.
+
+## 5. YARD
+
+Documentación incremental con la skill `yard`. Medir cobertura de doc con:
+
+```bash
+bundle exec yard stats --list-undoc
+```
+
+Documentar el código nuevo o modificado.
+
+## 6. Testing
+
+Framework: **RSpec** (verificado en `spec/spec_helper.rb` con `require 'rspec'` y specs `describe`/`it` en `spec/snoopy_afip/`). Correr la suite con:
+
+```bash
+bundle exec rspec
+```
+
+El código nuevo debe venir con tests. La suite (`spec/snoopy_afip/{bill,authorize_adapter,authentication_adapter,exceptions}_spec.rb`) son unit puros, sin fixtures ni llamadas reales a AFIP; usar placeholders, nunca CUIT/credenciales reales.
+
+**Runtime: la suite corre bajo Ruby 2.7.x** (runtime del consumidor). En Ruby 3.x la gema **no carga** — el stack de savon 2.12 (httpi 2.x) depende de `kconv` y `Rack::Utils::HeaderHash`, removidos en Ruby 3.x / rack 3. Correr en 3.x requiere el upgrade de savon a 2.15+ (ver `docs/test/testing.md`). El `Gemfile.lock` está resuelto para 2.7.
+
+## 7. Releases
+
+La versión vive en `lib/snoopy_afip/version.rb` (`Snoopy::VERSION`).
+
+**Release automatizado por GitHub Actions** (`.github/workflows/release.yml`): publicar = bump de `version.rb` + commit + `git tag vX.Y.Z` + push del tag → el workflow corre `gem build` + `gem push` a RubyGems. Requiere el secret `RUBYGEMS_API_KEY` en el repo. No hace falta `gem push` manual.
+
+**CI** (`.github/workflows/main.yml`): corre `bundle exec rspec` en cada push a master y PR. Hoy en **Ruby 2.7** (stack savon 2.12); subir a 3.x al mergear el upgrade de savon (#19).
+
+## 8. Arquitectura
+
+Derivada de `lib/` (módulo `Snoopy`, autoloads en `lib/snoopy_afip.rb`):
+
+- **`Snoopy`** (`lib/snoopy_afip.rb`): módulo de configuración global vía `attr_accessor` (`cuit`, `sale_point`, `service_url`, `auth_url`, `pkey`, `cert`, `default_document_type`, `default_concept`, `default_currency`, `own_iva_cond`, `open_timeout`, `read_timeout`, `verbose`). `open_timeout`/`read_timeout` por defecto en 30. Expone helpers `auth_hash` y `bill_types`.
+- **`Snoopy::Client`** (`client.rb`): envoltorio fino sobre `Savon.client`; `#call` aplica `Timeout` y traduce fallos a `Snoopy::Exception::ServerTimeout` / `Snoopy::Exception::ClientError`.
+- **`Snoopy::AuthenticationAdapter`** (`authentication_adapter.rb`): flujo WSAA — genera TRA/CMS y obtiene `token`/`sign`/`expiration_time`. También métodos de generación de clave privada y de solicitud de certificado (`generate_pkey`, `generate_certificate_request_with_ruby`, `..._with_bash`).
+- **`Snoopy::AuthorizeAdapter`** (`authorize_adapter.rb`): flujo WSFE — toma un `Bill` más credenciales (`token`/`sign`/`cuit`/`pkey`/`cert`), arma el request, llama al web service y parsea la respuesta en capas independientes (resultado/CAE, `afip_errors`, `afip_events`, `afip_observations`); expone `set_bill_number!` y `authorize!`.
+- **`Snoopy::Bill`** (`bill.rb`): modela el comprobante; valida con `valid?`/`errors` y consulta estado de aprobación con `approved?`, `partial_approved?`, `rejected?`.
+- **`Snoopy::Constants`** (`constants.rb`) y **`Snoopy::Exception`** (`exceptions.rb`): tablas de dominio (tipos de documento, alícuotas, condiciones de IVA) y jerarquía de excepciones.
+- **`lib/snoopy_afip/core_ext/`**: extensiones a `String`, `Hash` y `Float`.
+
+El acoplamiento de las capas de parseo es deliberado (ver README §"No Explota"): un cambio de formato de AFIP en una capa no debe tumbar el parseo de las demás.
+
+## Mapa de conocimiento (cómo leer la doc de este repo)
+
+- **Tu conocimiento = la UNIÓN de este repo + sus asociados.** No termina en el `docs/<capa>/` local: incluye la doc de los servicios/gemas de `skills.yml`. Un flujo o pregunta que cruza repos no vive como doc estática en ninguno — se compone on-demand recorriendo el grafo: seguí las anclas (`docs/consumed/`, `**Canónico:**`) hasta los repos asociados y unificá.
+- **Entrá por** [`skill/SKILL.md`](skill/SKILL.md) — índice de agente; resume el contrato y linkea el detalle.
+- **Detalle por capa** (`docs/<capa>/`), cobertura declarada:
+
+  | capa | estado |
+  |---|---|
+  | `docs/interface/` (RFC-004) | presente |
+  | `docs/topology/` (RFC-006) | presente |
+  | `docs/consumed/` (RFC-018) | presente — AFIP WSAA + WSFE |
+  | `docs/errors/` (RFC-020) | presente |
+  | `docs/config/` (RFC-012) | presente |
+  | `docs/test/` (RFC-013) | presente |
+  | `docs/glossary/` (RFC-009) | presente |
+  | `docs/behavior/` (RFC-007) | presente |
+  | `docs/api/` (RFC-003) | **n/a** — gema SOAP, sin superficie HTTP/CLI/eventos propia |
+  | `docs/data/` (RFC-002) | **n/a** — sin base de datos |
+  | `docs/events/` (RFC-005) · multi-tenancy (RFC-023) | **n/a** — sin pub/sub ni tenant |
+
+- **Qué consumimos:** [`docs/consumed/afip.md`](docs/consumed/afip.md) (RFC-018) — servicios SOAP externos de AFIP.
+- **Navegar una ancla cross-repo:** tomá la key de servicio en `skills.yml` (`services.<dep>.repo`) → ese repo es un checkout hermano local o alcanzable por GitHub MCP. La doc de los asociados ES parte de tu conocimiento accesible. (Hoy las dependencias de esta gema son externas a AFIP, no del fleet.)

data/CHANGELOG.md

@@ -0,0 +1,44 @@
+# Changelog
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
+and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
+
+## [4.3.1] - 2026-06-29
+### Fixed
+- `AuthorizeAdapter`: los rescues de parseo registraban con `errors << …` sobre un Hash (NoMethodError) y la consulta referenciaba una constante mal namespaceada (NameError), enmascarando el error real de AFIP. Ahora registran el mensaje sin explotar — sostiene el diseño "No Explota" (#10).
+- `Snoopy::Exception::ServerTimeout` quedaba fuera de la jerarquía de la gema, así que `rescue` de la base no lo atrapaba (#11).
+
+### Added
+- `Snoopy::Exception::Error`: módulo paraguas para `rescue` de todos los errores de la gema (incluido el timeout) sin romper `rescue Timeout::Error` (#11).
+
+### Removed
+- `Snoopy.auth_hash`: código muerto que siempre levantaba NameError (constantes `Snoopy::TOKEN`/`Snoopy::SIGN` inexistentes) (#12).
+
+### Changed
+- Higiene del `.gemspec` (`required_ruby_version >= 2.5`, fecha automática).
+- Suite RSpec reescrita contra la API actual y `Gemfile.lock` regenerado (#13).
+- Documentación de arquitectura (`docs/<capa>/`, README, `skill/SKILL.md`) regenerada.
+- CI y publicación a RubyGems automatizados por GitHub Actions (tag `v*`).
+
+## [3.0.2] - July 14, 2017
+### Added
+- `Cms Builder exception`.
+
+## [3.0.0] - June 29, 2017
+### Added
+- `Authentication Class` destinada a la comunicación con el **WSAA**.
+- `Authorize Class` destinada a la comunicación con el **WSFE**.
+- `Client Class` destinada para crear el cliente de `Savon`.
+- Mejor manejo de Exceptions.
+- Validaciones en el modelo `Bill`.
+
+### Changed
+- Se pasó toda la logica de comunicación con el **WSFE** del modelo `Bill` al modelo `Authorize`.
+- No se crea mas el rchivo para la clave privada, devuelve en RAW.
+- No se crea mas un archivo para almacenar el _token_, _sign_, se devuelve en RAW.
+- Evitar raisear si se logró autorizar una factura con el **WSFE**. Manejo en el errors del `Bill` o el `Authorize`.
+
+### Removed
+- Eliminiado modulo `AuthData`.
+- Eliminado el uso de `Bash` para autenticar en el **WSAA**.

data/CLAUDE.md

@@ -0,0 +1,15 @@
+# Claude Code Notes
+
+## Fuente de verdad del repositorio
+
+Las reglas, convenciones, estructura y contexto del proyecto viven en `AGENTS.md`.
+
+- Leer `AGENTS.md` antes de hacer cambios.
+- Tratar `AGENTS.md` como fuente de verdad para identidad, estructura, documentación, convenciones del framework, entorno, y arquitectura.
+
+## Propósito de este archivo
+
+`CLAUDE.md` queda reservado para instrucciones o notas específicas de Claude Code.
+
+- No duplicar aquí reglas generales del repositorio.
+- Si una regla aplica a cualquier agente, moverla a `AGENTS.md`.

data/Gemfile

@@ -1,6 +1,10 @@
 source "http://rubygems.org"
 
 gemspec
+
+# httpi 2.x (vía savon 2.12) usa Rack::Utils::HeaderHash, removido en rack 3.
+# Pin de entorno de test; el consumidor Rails trae su propio rack 2.x.
+gem "rack", "~> 2.2"
 # group :development do
 #   platforms :ruby_18 do
 #     gem "ruby-debug"

data/Gemfile.lock

@@ -1,31 +1,72 @@
 PATH
   remote: .
   specs:
-    snoopy_afip (4.0.1)
-      akami (~> 1.3.1)
-      nokogiri (~> 1.10.9)
-      nori (~> 2.6.0)
-      savon (~> 2.12.0)
-      wasabi (~> 3.5.0)
+    snoopy_afip (4.3.1)
+      savon (~> 2.12.1)
 
 GEM
   remote: http://rubygems.org/
   specs:
-    akami (1.3.1)
+    activesupport (7.1.6)
+      base64
+      benchmark (>= 0.3)
+      bigdecimal
+      concurrent-ruby (~> 1.0, >= 1.0.2)
+      connection_pool (>= 2.2.5)
+      drb
+      i18n (>= 1.6, < 2)
+      logger (>= 1.4.2)
+      minitest (>= 5.1)
+      mutex_m
+      securerandom (>= 0.3)
+      tzinfo (~> 2.0)
+    addressable (2.9.0)
+      public_suffix (>= 2.0.2, < 8.0)
+    akami (1.3.2)
       gyoku (>= 0.4.0)
       nokogiri
-    builder (3.2.4)
-    gyoku (1.3.1)
+    base64 (0.3.0)
+    benchmark (0.5.0)
+    bigdecimal (4.1.2)
+    builder (3.3.0)
+    concurrent-ruby (1.3.7)
+    connection_pool (2.5.5)
+    diff-lcs (1.6.2)
+    drb (2.2.3)
+    gyoku (1.4.0)
       builder (>= 2.1.2)
-    httpi (2.4.4)
+      rexml (~> 3.0)
+    httpi (2.5.0)
       rack
       socksify
-    mini_portile2 (2.4.0)
-    nokogiri (1.10.9)
-      mini_portile2 (~> 2.4.0)
+    i18n (1.14.8)
+      concurrent-ruby (~> 1.0)
+    logger (1.7.0)
+    minitest (5.26.1)
+    mutex_m (0.3.0)
+    nokogiri (1.15.7-arm64-darwin)
+      racc (~> 1.4)
+    nokogiri (1.15.7-x86_64-linux)
+      racc (~> 1.4)
     nori (2.6.0)
-    rack (2.2.2)
-    savon (2.12.0)
+    public_suffix (5.1.1)
+    racc (1.8.1)
+    rack (2.2.23)
+    rexml (3.4.4)
+    rspec (3.13.2)
+      rspec-core (~> 3.13.0)
+      rspec-expectations (~> 3.13.0)
+      rspec-mocks (~> 3.13.0)
+    rspec-core (3.13.6)
+      rspec-support (~> 3.13.0)
+    rspec-expectations (3.13.5)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-mocks (3.13.8)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-support (3.13.7)
+    savon (2.12.1)
       akami (~> 1.2)
       builder (>= 2.1.2)
       gyoku (~> 1.2)
@@ -33,16 +74,24 @@ GEM
       nokogiri (>= 1.8.1)
       nori (~> 2.4)
       wasabi (~> 3.4)
-    socksify (1.7.1)
-    wasabi (3.5.0)
+    securerandom (0.3.2)
+    socksify (1.8.1)
+    tzinfo (2.0.6)
+      concurrent-ruby (~> 1.0)
+    wasabi (3.7.0)
+      addressable
       httpi (~> 2.0)
       nokogiri (>= 1.4.2)
 
 PLATFORMS
-  ruby
+  arm64-darwin-24
+  x86_64-linux
 
 DEPENDENCIES
+  activesupport
+  rack (~> 2.2)
+  rspec (~> 3.13)
   snoopy_afip!
 
 BUNDLED WITH
-   2.1.4
+   2.4.22