Expand API coverage, add Resource wrapper, error subclasses, tooling

.github/workflows/test.yml

@@ -9,7 +9,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        ruby_version: [2.7, 3.0, 3.1, 3.2, 3.3, 3.4]
+        ruby_version: ["3.0", "3.1", "3.2", "3.3", "3.4", "4.0"]
     env:
       CI: true
     steps:

.gitignore

@@ -18,4 +18,7 @@ _yardoc
 doc/
 
 .env
-.idea/
+.idea/
+
+# Local-only OpenAPI reference (used for gap analysis, not shipped)
+schema.json

.rubocop.yml

@@ -1,9 +1,12 @@
 plugins:
   - rubocop-rspec
+  - rubocop-rake
 
 AllCops:
+  TargetRubyVersion: 3.0
   DisplayCopNames: true
   NewCops: enable
+  SuggestExtensions: false
   Exclude:
     - bin/**/*
     - tmp/**/*
@@ -61,7 +64,8 @@ Lint/RedundantDirGlobSort:
   Enabled: false
 
 Metrics/ParameterLists:
-  Max: 7
+  Max: 8
+  MaxOptionalParameters: 4
 
 Metrics/BlockLength:
   Exclude:

.ruby-version

@@ -1 +1 @@
-2.7.8
+3.4.1

.yardopts

@@ -0,0 +1,10 @@
+--markup markdown
+--readme README.md
+--no-private
+--protected
+--output-dir docs/api
+--exclude /spec/
+--exclude /bin/
+lib/**/*.rb
+-
+LICENSE

Gemfile.lock

@@ -1,126 +1,123 @@
 PATH
   remote: .
   specs:
-    veryfi (3.0.0)
+    veryfi (4.0.0)
       base64 (~> 0.1)
-      faraday (>= 1.7, < 3.0)
+      faraday (>= 2.14.1, < 3.0)
       openssl (>= 2.2, < 4.1)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    activesupport (6.1.7.8)
-      concurrent-ruby (~> 1.0, >= 1.0.2)
-      i18n (>= 1.6, < 2)
-      minitest (>= 5.1)
-      tzinfo (~> 2.0)
-      zeitwerk (~> 2.3)
-    addressable (2.8.6)
-      public_suffix (>= 2.0.2, < 6.0)
+    addressable (2.9.0)
+      public_suffix (>= 2.0.2, < 8.0)
     ast (2.4.3)
     base64 (0.3.0)
-    bigdecimal (3.1.8)
-    bundler-audit (0.9.1)
-      bundler (>= 1.2.0, < 3)
+    bigdecimal (4.1.2)
+    bundler-audit (0.9.3)
+      bundler (>= 1.2.0)
       thor (~> 1.0)
     coderay (1.1.3)
-    concurrent-ruby (1.3.3)
-    crack (1.0.0)
+    crack (1.0.1)
       bigdecimal
       rexml
-    diff-lcs (1.5.1)
-    docile (1.4.0)
-    faraday (2.8.1)
-      base64
-      faraday-net_http (>= 2.0, < 3.1)
-      ruby2_keywords (>= 0.0.4)
-    faraday-net_http (3.0.2)
-    hashdiff (1.1.0)
-    i18n (1.14.5)
-      concurrent-ruby (~> 1.0)
-    json (2.18.0)
+    diff-lcs (1.6.2)
+    docile (1.4.1)
+    faraday (2.14.2)
+      faraday-net_http (>= 2.0, < 3.5)
+      json
+      logger
+    faraday-net_http (3.4.3)
+      net-http (~> 0.5)
+    hashdiff (1.2.1)
+    io-console (0.8.2)
+    json (2.19.5)
     language_server-protocol (3.17.0.5)
     lint_roller (1.1.0)
+    logger (1.7.0)
     method_source (1.1.0)
-    minitest (5.23.1)
-    openssl (4.0.0)
-    parallel (1.27.0)
-    parser (3.3.10.1)
+    net-http (0.9.1)
+      uri (>= 0.11.1)
+    openssl (4.0.2)
+    parallel (1.28.0)
+    parser (3.3.11.1)
       ast (~> 2.4.1)
       racc
-    prism (1.8.0)
-    pry (0.14.2)
+    prism (1.9.0)
+    pry (0.16.0)
       coderay (~> 1.1)
       method_source (~> 1.0)
-    public_suffix (5.0.5)
+      reline (>= 0.6.0)
+    public_suffix (5.1.1)
     racc (1.8.1)
     rainbow (3.1.1)
-    rake (13.2.1)
-    regexp_parser (2.11.3)
+    rake (13.4.2)
+    regexp_parser (2.12.0)
+    reline (0.6.3)
+      io-console (~> 0.5)
     rexml (3.4.4)
-    rspec (3.13.0)
+    rspec (3.13.2)
       rspec-core (~> 3.13.0)
       rspec-expectations (~> 3.13.0)
       rspec-mocks (~> 3.13.0)
-    rspec-core (3.13.0)
+    rspec-core (3.13.6)
       rspec-support (~> 3.13.0)
-    rspec-expectations (3.13.0)
+    rspec-expectations (3.13.5)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.13.0)
-    rspec-its (1.3.0)
+    rspec-its (1.3.1)
       rspec-core (>= 3.0.0)
       rspec-expectations (>= 3.0.0)
-    rspec-mocks (3.13.1)
+    rspec-mocks (3.13.8)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.13.0)
-    rspec-support (3.13.1)
-    rubocop (1.82.1)
+    rspec-support (3.13.7)
+    rubocop (1.86.2)
       json (~> 2.3)
       language_server-protocol (~> 3.17.0.2)
       lint_roller (~> 1.1.0)
-      parallel (~> 1.10)
+      parallel (>= 1.10)
       parser (>= 3.3.0.2)
       rainbow (>= 2.2.2, < 4.0)
       regexp_parser (>= 2.9.3, < 3.0)
-      rubocop-ast (>= 1.48.0, < 2.0)
+      rubocop-ast (>= 1.49.0, < 2.0)
       ruby-progressbar (~> 1.7)
       unicode-display_width (>= 2.4.0, < 4.0)
-    rubocop-ast (1.49.0)
+    rubocop-ast (1.49.1)
       parser (>= 3.3.7.2)
       prism (~> 1.7)
+    rubocop-rake (0.7.1)
+      lint_roller (~> 1.1)
+      rubocop (>= 1.72.1)
     rubocop-rspec (3.9.0)
       lint_roller (~> 1.1)
       rubocop (~> 1.81)
     ruby-progressbar (1.13.0)
-    ruby2_keywords (0.0.5)
     simplecov (0.22.0)
       docile (~> 1.1)
       simplecov-html (~> 0.11)
       simplecov_json_formatter (~> 0.1)
     simplecov-badge (2.0.2)
-    simplecov-html (0.12.3)
+    simplecov-html (0.13.2)
     simplecov_json_formatter (0.1.4)
-    thor (1.4.0)
-    tzinfo (2.0.6)
-      concurrent-ruby (~> 1.0)
+    thor (1.5.0)
     unicode-display_width (3.2.0)
       unicode-emoji (~> 4.1)
     unicode-emoji (4.2.0)
-    vcr (6.1.0)
-    webmock (3.23.1)
+    uri (1.1.1)
+    vcr (6.4.0)
+    webmock (3.26.2)
       addressable (>= 2.8.0)
       crack (>= 0.3.2)
       hashdiff (>= 0.4.0, < 2.0.0)
-    zeitwerk (2.6.15)
+    yard (0.9.44)
 
 PLATFORMS
-  arm64-darwin-23
+  arm64-darwin-25
   ruby
-  x86_64-darwin-19
   x86_64-linux
 
 DEPENDENCIES
-  activesupport (~> 6.0)
   bundler (~> 2.4)
   bundler-audit (~> 0.9)
   pry (~> 0.14)
@@ -129,12 +126,14 @@ DEPENDENCIES
   rspec (~> 3.9)
   rspec-its (~> 1.3)
   rubocop (~> 1.65)
+  rubocop-rake (~> 0.6)
   rubocop-rspec (~> 3.0)
   simplecov (~> 0.21)
   simplecov-badge (~> 2.0)
   vcr (~> 6.0)
   veryfi!
   webmock (~> 3.14)
+  yard (~> 0.9)
 
 BUNDLED WITH
    2.4.22