w3c_api 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b1b6d2f332eeee4355bee1550931410695851be8e5349ee1ef0168fe370dab36
-  data.tar.gz: b9d8dfa4caae188d47acbd6ebe28e5c29a37035a9e43b60bae880467de5f22df
+  metadata.gz: aca3cfabd692c0eaada3c4a188537a3609bd49f79001e15394648e05651a604a
+  data.tar.gz: cf15b6dc9c61577fd758d014e501b95891be435665b68e28d9b33343f3101381
 SHA512:
-  metadata.gz: 3b056eed82f4d6d6134f1e6f51b2b18a04d7e92683c359cdb5762495885afe5c142d8da2603cf05bf4c09eb75639343f7e0ec6c0433d38d9b8c602f417c4bae6
-  data.tar.gz: 43030538729e62863ddf3166c726c1f05a841d0b59a2c62f5590dce395a489601220be7ebd52b853ee5b55bb970209a60bc4ec74d29b091aa51af2f9de134580
+  metadata.gz: a8d9c16aeb023ee84208ee83d9448514e7f527673a882234aa1621f736c526b19f129086ceb1657ed17ec5b016c220a1c86ebb1046a9c34cc7c581da9eb271ed
+  data.tar.gz: 4a1055ebd67f8afdb6ecb33da8088ecb0b7b0ffdfd694e52f7dbd1e9e8d79d44c6fb9729a06acafbdb00667e6338da97fa2cd410eff776b65ea53bc925ceff3c

data/lib/w3c_api/hal.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require "singleton"
+require "faraday/retry"
 require "lutaml/hal"
 require_relative "models"
 
@@ -50,18 +51,55 @@ module W3cApi
     def client
       @client ||= Lutaml::Hal::Client.new(
         api_url: API_URL,
+        connection: connection,
         rate_limiting: rate_limiting_options,
       )
     end
 
+    # Faraday connection mirroring lutaml-hal's default middleware stack, with a
+    # retry layer for the failures lutaml-hal's RateLimiter does not cover: the
+    # W3C API signals rate-limiting with HTTP 403, plus transient connection and
+    # timeout errors. (lutaml-hal still retries 429 and 5xx.) Owning retries here
+    # means every consumer of the client is resilient without its own wrapper.
+    def connection
+      @connection ||= Faraday.new(url: API_URL.delete_suffix("/")) do |conn|
+        conn.request :retry, retry_options
+        conn.use Faraday::FollowRedirects::Middleware
+        conn.request :json
+        conn.response :json, content_type: /\bjson$/
+        conn.adapter Faraday.default_adapter
+      end
+    end
+
+    # Retry policy for the W3C-specific transient failures (HTTP 403 and
+    # connection/timeout). Grows 1, 2, 4, 8, 16s, matching rate_limiting_options.
+    def retry_options
+      {
+        max: 5,
+        interval: 1.0,
+        backoff_factor: 2,
+        max_interval: 30.0,
+        retry_statuses: [403],
+        exceptions: [
+          Errno::ETIMEDOUT, Timeout::Error,
+          Faraday::TimeoutError, Faraday::ConnectionFailed
+        ],
+      }
+    end
+
     # Configure rate limiting options
+    #
+    # lutaml-hal's RateLimiter retries 429 and 5xx responses with exponential
+    # backoff (base_delay * backoff_factor**(attempt - 1), capped at max_delay).
+    # These defaults grow 1, 2, 4, 8, 16s so a rate-limited or briefly
+    # overloaded W3C API is given real room to recover during a bulk crawl.
     def rate_limiting_options
       @rate_limiting_options ||= {
         enabled: true,
         max_retries: 5,
-        base_delay: 0.1,
-        max_delay: 10.0,
-        backoff_factor: 1.5,
+        base_delay: 1.0,
+        max_delay: 30.0,
+        backoff_factor: 2.0,
       }
     end
 

data/lib/w3c_api/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module W3cApi
-  VERSION = "0.2.0"
+  VERSION = "0.3.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: w3c_api
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-04-21 00:00:00.000000000 Z
+date: 2026-06-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -38,20 +38,34 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: faraday-retry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
 - !ruby/object:Gem::Dependency
   name: lutaml-hal
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.1.10
+        version: 0.2.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.1.10
+        version: 0.2.0
 - !ruby/object:Gem::Dependency
   name: lutaml-model
   requirement: !ruby/object:Gem::Requirement