debugbundle 1.1.0 → 1.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 55cf00eddb0f7fc23cdc0b574d5c8c95f1b06575dfcef315e7c8f5c31278942b
-  data.tar.gz: 43e388045674fc42d1cc44f11365cb392aae7f3a09f64f3784c776cd96c79b6f
+  metadata.gz: a7c3b7839eda588014c28fc36b2c0337a754c42b2c75db59b3a18569d0c18dad
+  data.tar.gz: 39dabc4e2221bebede01e96faf24f6baa517cdeddb6495f28c0c25d2c5cd41df
 SHA512:
-  metadata.gz: e0beea973c239fdbe571ffbe9e62f48e206112414b9372466e6c99252bd4ed85dc6c349bed7986875d04b77d8e8a6525e35d9fcd3291b8066ffa60fad4d0d73a
-  data.tar.gz: 374744696cbd5d1cf8b05791ac67e9e275e33c88fa4d1d3e363056db7b44f3e225fff2c60d223ff4508440e69ec32ab045eb7d9271daea7601d7d758ec6c0569
+  metadata.gz: 117cc67dd6b26bd728563e901abe113efbb83b3a661c572f0d29e02bdc1828d326e89f604701fe8320af2b31ba9b1c0c747d87c61dc6f6f3f9cb7bf5319cac52
+  data.tar.gz: ea39d1fd9cf648ba1341f9aeb72900f899bb8ab3f384f6f02c6e50ccdd51fd666cf213492933ecb53911d1c224da6a5432a6e9a0e42f36dd07c712fd870d0a0b

data/README.md

@@ -314,7 +314,7 @@ This repository also ships a clean-install app-driven smoke harness that validat
 
 ```sh
 make smoke
-make smoke-published VERSION=1.1.0
+make smoke-published VERSION=1.1.2
 ```
 
 `make smoke` builds the gem, installs it into a fresh RubyGems home, drives a Rack request plus a browser relay batch through the public SDK surface, validates event envelope shape, and confirms the mock ingestion endpoint receives the expected service, environment, SDK metadata, and correlation fields.

data/lib/debugbundle/client.rb

@@ -41,9 +41,7 @@ module DebugBundle
     class << self
       attr_accessor :thread_exception_client
 
-      def dispatch_thread_exception(error)
-        thread_exception_client&.__send__(:capture_thread_exception, error)
-      end
+      def dispatch_thread_exception(error) = thread_exception_client&.__send__(:capture_thread_exception, error)
 
       def install_thread_exception_hook!
         THREAD_HOOK_MUTEX.synchronize do
@@ -128,18 +126,17 @@ module DebugBundle
       }
 
       causes = exception_causes(error)
-      payload['causes'] = causes unless causes.empty?
 
       probe_data = probe_snapshot
       payload['probe_data'] = probe_data unless probe_data.empty?
 
       extra_context = merged_context.except('request', 'response', 'correlation')
-      payload['context'] = extra_context unless extra_context.empty?
+      extra_context['causes'] = causes unless causes.empty?
 
       suppression_key = [payload['name'], payload['message'], payload['stack']].join(':')
       return unless @suppression.should_capture(suppression_key, now: monotonic_now)
 
-      enqueue_event(base_event('backend_exception', payload, merged_context))
+      enqueue_event(base_event('backend_exception', payload, extra_context))
     end
 
     def capture_error(error, context: nil, handled: true) = capture_exception(error, context: context, handled: handled)
@@ -181,8 +178,6 @@ module DebugBundle
         'response_status' => response_status,
         'duration_ms' => extract_duration_ms(merged_context, sanitized_response),
         'route_template' => merged_context['route_template'],
-        'controller' => merged_context['controller'],
-        'action' => merged_context['action'],
         'response_headers' => sanitized_response['headers'],
         'response_body' => sanitized_response['body']
       }
@@ -414,8 +409,8 @@ module DebugBundle
     def request_payload(request)
       source = object_to_hash(request)
       {
-        'method' => source['method'],
-        'path' => source['path'],
+        'method' => source['method'] || 'UNKNOWN',
+        'path' => source['path'] || '/',
         'query' => @redactor.redact_value(source['query'] || {}),
         'headers' => sanitized_headers(source['headers'] || {}),
         'body' => @redactor.redact_value(source['body'] || {})
@@ -494,7 +489,7 @@ module DebugBundle
     end
 
     def base_event(event_type, payload, context)
-      {
+      event = {
         'schema_version' => SCHEMA_VERSION,
         'event_id' => SecureRandom.uuid,
         'event_type' => event_type,
@@ -511,6 +506,9 @@ module DebugBundle
         'correlation' => correlation_payload(context),
         'payload' => @redactor.redact_value(payload)
       }
+      envelope_context = event_context(context)
+      event['context'] = envelope_context unless envelope_context.empty?
+      event
     end
 
     def service_name = config.service || DEFAULT_SERVICE_NAME
@@ -528,6 +526,18 @@ module DebugBundle
       }
     end
 
+    def event_context(context)
+      object_to_hash(context).except(
+        'request',
+        'response',
+        'correlation',
+        'request_id',
+        'trace_id',
+        'session_id',
+        'user_id_hash'
+      )
+    end
+
     def object_to_hash(value)
       case value
       when Hash

data/lib/debugbundle/relay/handler.rb

@@ -11,6 +11,7 @@ module DebugBundle
       frontend_breadcrumb
       request_event
       probe_event
+      analytics_event
     ].freeze
     BROWSER_SDK_NAME = '@debugbundle/sdk-browser'
     DEFAULT_MAX_BODY_BYTES = 262_144
@@ -192,20 +193,22 @@ module DebugBundle
             'name' => @service || service['name'].to_s,
             'environment' => @environment || service['environment'].to_s
           },
-          'correlation' => sanitize_correlation(correlation),
+          'correlation' => sanitize_correlation(correlation, event_type),
           'payload' => payload,
           'project_token' => @project_token
         }
       end
 
-      def sanitize_correlation(value)
+      def sanitize_correlation(value, event_type)
         correlation = value.is_a?(Hash) ? value : {}
-        {
-          'request_id' => string_or_nil(correlation['request_id']),
-          'trace_id' => string_or_nil(correlation['trace_id']),
-          'session_id' => string_or_nil(correlation['session_id']),
-          'user_id_hash' => string_or_nil(correlation['user_id_hash'])
-        }
+        keys = if event_type == 'analytics_event'
+                 %w[session_id visitor_id_hash user_id_hash trace_id deploy_id]
+               else
+                 %w[request_id trace_id session_id user_id_hash]
+               end
+        keys.each_with_object({}) do |key, sanitized|
+          sanitized[key] = string_or_nil(correlation[key]) if correlation.key?(key)
+        end
       end
 
       def string_or_nil(value)

data/lib/debugbundle/version.rb

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

data/spec/fixtures/event-envelope.schema.json

@@ -57,11 +57,16 @@
         "event_id": { "type": "string", "format": "uuid" },
         "event_type": { "type": "string", "minLength": 1 },
         "project_token": { "type": "string", "minLength": 1 },
+        "project_id": { "type": ["string", "null"], "format": "uuid" },
         "sdk_name": { "type": "string", "minLength": 1 },
         "sdk_version": { "type": "string", "minLength": 1 },
         "service": { "$ref": "#/$defs/service" },
         "occurred_at": { "type": "string", "format": "date-time" },
         "correlation": { "$ref": "#/$defs/correlation" },
+        "context": {
+          "type": "object",
+          "additionalProperties": true
+        },
         "payload": {}
       }
     },

data/spec/rack_middleware_spec.rb

@@ -195,10 +195,14 @@ RSpec.describe DebugBundle::Rack::Middleware do
     )
 
     client.flush
-    payload = transport_events.fetch(0).fetch(:events).fetch(0).fetch('payload')
+    event = transport_events.fetch(0).fetch(:events).fetch(0)
+    payload = event.fetch('payload')
+    context = event.fetch('context')
 
     expect(payload).to include(
-      'route_template' => '/patients/:patient_id/checkouts',
+      'route_template' => '/patients/:patient_id/checkouts'
+    )
+    expect(context).to include(
       'controller' => 'checkouts',
       'action' => 'create'
     )

data/spec/relay_spec.rb

@@ -57,6 +57,40 @@ RSpec.describe DebugBundle::Relay::Handler do
     end
   end
 
+  it 'preserves analytics correlation fields for analytics relay events' do
+    analytics_event = browser_event.merge(
+      'event_type' => 'analytics_event',
+      'correlation' => {
+        'session_id' => 'session-analytics',
+        'visitor_id_hash' => "sha256:#{'a' * 64}",
+        'user_id_hash' => nil,
+        'trace_id' => 'trace-analytics',
+        'deploy_id' => 'deploy-analytics'
+      },
+      'payload' => { 'kind' => 'page_view', 'privacy' => { 'mode' => 'standard', 'consent_granted' => true } }
+    )
+
+    Dir.mktmpdir do |directory|
+      handler = described_class.new(project_mode: :local_only, project_token: 'dbundle_proj_server',
+                                    local_events_dir: directory)
+      response = handler.handle(
+        method: 'POST',
+        headers: {
+          'host' => 'app.example.com',
+          'origin' => 'https://app.example.com',
+          'content-type' => 'application/json'
+        },
+        body: JSON.generate('batch' => [analytics_event]),
+        ip_address: '127.0.0.2'
+      )
+
+      expect(response.status).to eq(202)
+      file_name = Dir.children(directory).find { |entry| entry.end_with?('.events.json') }
+      event = JSON.parse(File.read(File.join(directory, file_name))).fetch(0)
+      expect(event.fetch('correlation')).to eq(analytics_event.fetch('correlation'))
+    end
+  end
+
   it 'rejects wrong origins' do
     handler = described_class.new(project_mode: :local_only, project_token: 'dbundle_proj_server')
     response = handler.handle(

data/spec/sidekiq_integration_spec.rb

@@ -50,7 +50,7 @@ if defined?(Sidekiq)
 
       expect(event.fetch('event_type')).to eq('backend_exception')
       expect(event.fetch('correlation')).to include('trace_id' => 'trace-chain-1')
-      expect(event.fetch('payload').fetch('context').fetch('job')).to include(
+      expect(event.fetch('context').fetch('job')).to include(
         'class' => 'CheckoutWorker',
         'queue' => 'critical',
         'jid' => 'jid-chain-1'

data/spec/sidekiq_middleware_spec.rb

@@ -40,7 +40,7 @@ RSpec.describe DebugBundle::Sidekiq::ServerMiddleware do
 
     expect(event.fetch('event_type')).to eq('backend_exception')
     expect(event.fetch('correlation')).to include('trace_id' => 'trace-job-1')
-    expect(event.fetch('payload').fetch('context').fetch('job')).to include(
+    expect(event.fetch('context').fetch('job')).to include(
       'class' => 'CheckoutWorker',
       'queue' => 'critical',
       'jid' => 'jid-1',

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: debugbundle
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.1.3
 platform: ruby
 authors:
 - DebugBundle
 bindir: exe
 cert_chain: []
-date: 2026-06-08 00:00:00.000000000 Z
+date: 2026-07-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base64