debugbundle 2.0.0 → 2.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 154069d58e3649c8b90ab0b5567749fef0b0ae27756354467d2f54e347c20bdb
-  data.tar.gz: 10364db06a596a352b0b96cdfda8b54fe6ec228ab2a4682b89740d38ca0f2a09
+  metadata.gz: de914935eb26ac5a4a4c7a21e91e13f92fcdef0949c8a19cc9566adf70fa7b5d
+  data.tar.gz: ff2d61415de5d618556d00f4918e4d3a29af38ae7be2bddafc088304a7b11e2b
 SHA512:
-  metadata.gz: 529aa156d0361a75d06a6b9c1f1dd9950269c1c0c82a97367436a6987a8546c0f9274631c1027e0e5585147b18e34ce5a441eca453891a442e105617370f373f
-  data.tar.gz: 3d768b54c0ca11c5ed227bbe02ece3ad61a40a77597028366e900c1cc42a4e4777bb93fc837dfc2eeee030e610c0756993fb363f0d2eab5e17457b34b0c66e02
+  metadata.gz: 7655a43d83ce82e3d7cd6febebc560a2c6c31dde18df9b3a579897fa236c1094c36bc170aa203f1a412caca0ff86c1d6bf529745e9b69e48d55c88799ba84531
+  data.tar.gz: 06b7e321fe0bae17dfe91bd4ffecd4288f84c0151a9909def3d18c02fc1e5f4e262171b7318a2bed337876a0ed7740c9d1d31d0ab518b187a05f72e0db0fcf49

data/README.md

@@ -368,3 +368,9 @@ The repository ships a GitHub Actions release workflow at `.github/workflows/rel
 ## License
 
 Apache-2.0. See LICENSE.
+
+## Delivery acknowledgement and retry limits
+
+The built-in HTTP transport requires the canonical ingestion acknowledgement (`accepted`, `rejected`, and `errors`). Empty responses, unrelated JSON, malformed counts, or invalid rejection indices retain the full batch with backoff. Valid acknowledgements remove accepted and terminally rejected events and retry only the indexed retryable rejections; an all-rejected batch does not advance `lastEventAt`.
+
+File transports and explicitly supplied custom/legacy transports retain their documented bodyless success fallback. A custom transport that returns acknowledgement fields must return the complete canonical shape. Retry hints (delay seconds or HTTP dates) are bounded to five minutes and measured from response receipt, including partial/protocol acknowledgements and retryable server failures. Without a server hint, existing retry timing is preserved. Failures remain contained within the SDK's existing delivery path.

data/lib/debugbundle/acknowledgement.rb

@@ -11,8 +11,8 @@ module DebugBundle
 
     module_function
 
-    def decide(body, batch_length)
-      return { kind: :legacy } unless body.is_a?(Hash) && FIELDS.any? { |field| body.key?(field) }
+    def decide(body, batch_length, required: false)
+      return missing_acknowledgement(required) unless body.is_a?(Hash) && FIELDS.any? { |field| body.key?(field) }
       return protocol_failure unless FIELDS.all? { |field| body.key?(field) }
 
       accepted = body['accepted']
@@ -55,5 +55,9 @@ module DebugBundle
     def protocol_failure
       { kind: :protocol_failure }
     end
+
+    def missing_acknowledgement(required)
+      required ? protocol_failure : { kind: :legacy }
+    end
   end
 end

data/lib/debugbundle/client.rb

@@ -443,10 +443,10 @@ module DebugBundle
         case result.status_code
         when 200..299
           handle_successful_result(result, batch)
-        when 429
+        when 429, 500..599
           @consecutive_failures += 1
-          retry_after_seconds = (result.retry_after_seconds || 1).clamp(1, RETRY_AFTER_CAP_SECONDS)
-          @retry_at = now + retry_after_seconds
+          retry_after_seconds = bounded_retry_hint(result.retry_after_seconds)
+          @retry_at = now + retry_after_seconds if result.status_code == 429 || !result.retry_after_seconds.nil?
           false
         when 400..499
           remove_buffered_events(batch)
@@ -515,9 +515,15 @@ module DebugBundle
 
     private
 
+    def bounded_retry_hint(value)
+      return 1 unless value.is_a?(Numeric) && value.real? && value.finite?
+
+      value.clamp(1, RETRY_AFTER_CAP_SECONDS)
+    end
+
     def handle_successful_result(result, batch)
-      decision = Acknowledgement.decide(result.body, batch.length)
-      return handle_protocol_failure if decision[:kind] == :protocol_failure
+      decision = Acknowledgement.decide(result.body, batch.length, required: @transport.is_a?(Transport::HttpTransport))
+      return handle_protocol_failure(result.retry_after_seconds) if decision[:kind] == :protocol_failure
 
       if decision[:kind] == :legacy
         remove_buffered_events(batch)
@@ -532,7 +538,7 @@ module DebugBundle
 
       if retryable_events.any?
         @consecutive_failures += 1
-        @retry_at = now + 1
+        @retry_at = now + bounded_retry_hint(result.retry_after_seconds)
         @acknowledgement_state = :degraded
         false
       else
@@ -543,9 +549,9 @@ module DebugBundle
       end
     end
 
-    def handle_protocol_failure
+    def handle_protocol_failure(retry_hint)
       @consecutive_failures += 1
-      @retry_at = now + 1
+      @retry_at = now + bounded_retry_hint(retry_hint)
       @acknowledgement_state = :degraded
       false
     end

data/lib/debugbundle/transport.rb

@@ -4,6 +4,7 @@ require 'json'
 require 'net/http'
 require 'securerandom'
 require 'uri'
+require 'time'
 require 'fileutils'
 
 module DebugBundle
@@ -83,8 +84,11 @@ module DebugBundle
       def parse_retry_after(value)
         return nil if value.nil? || value.strip.empty?
 
-        seconds = Integer(Float(value))
-        seconds.clamp(0, RETRY_AFTER_CAP_SECONDS)
+        seconds = Float(value, exception: false)
+        seconds = Time.httpdate(value) - Time.now if seconds.nil?
+        return nil unless seconds.finite?
+
+        seconds.clamp(0, RETRY_AFTER_CAP_SECONDS).to_i
       rescue ArgumentError, TypeError
         nil
       end

data/lib/debugbundle/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module DebugBundle
-  VERSION = '2.0.0'
+  VERSION = '2.0.1'
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: debugbundle
 version: !ruby/object:Gem::Version
-  version: 2.0.0
+  version: 2.0.1
 platform: ruby
 authors:
 - DebugBundle
 bindir: exe
 cert_chain: []
-date: 2026-09-25 00:00:00.000000000 Z
+date: 2026-09-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base64