dead_bro 0.2.16 → 0.2.17

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0bfea7b6292743b5e6a0f7226c1bd8877ebfbe1131f95d5c1679f07377768ed2
-  data.tar.gz: '08ab07422afbd9d2d340e5195f47ceda9a184faa9a870e5464d6169dfc86ee6b'
+  metadata.gz: 0e9e839180ccf5281f99f831a4d437bdadd74a835c7e8f80fe321efb8bb1c9f7
+  data.tar.gz: c85de05b244a13bac3a2786624bd67f2f18d3b08c3ab3bcaa511857f8c276b90
 SHA512:
-  metadata.gz: 76822c848e35d76f6cb54d7953e9ad7bb68de09b706be6f7586c4c67a3e430074fcd33515394965aeeb1d41c74577295ce56942badb05d96fd390e1daefeb410
-  data.tar.gz: 2cd76061aa3f443723dfc3e934b1cd36e7e7576257f6637a4a1deab4e05c3154d309c9d4b59d084b46e89521774e47475a84fdc711db42d03b1dab496682d532
+  metadata.gz: 87c69d57f3c712fc993663e4f8df46ad49ec584f0ccdd3f5f1a6c5eededbc8a9542f2b0d4cee446fb049288c5d7f086528fa91f1467aa778dea4cfd4b09302e4
+  data.tar.gz: 1aed3c8185b4b1f14b7707c97c9d38baa5cb19da9c268d7f6ae11024563e4f9452048a61fdbe616a6adadb4847559f1459a0c5b695306a31a0d579a66e2b5825

data/CHANGELOG.md

@@ -1,5 +1,10 @@
 ## [Unreleased]
 
+## [0.2.17] - 2026-05-25
+
+### Added
+- `DeadBro.track(error, **context)`: manually report a rescued exception to the DeadBro backend from any `rescue` block. Accepts any `Exception` subclass and optional keyword arguments forwarded as a `:context` hash in the payload. The report includes exception class, message, a 50-frame backtrace, `occurred_at` timestamp, environment, and any captured log lines from the current request. Never raises — APM reporting will not interfere with your application code.
+
 ## [0.2.16] - 2026-05-24
 
 ### Added

data/lib/dead_bro/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module DeadBro
-  VERSION = "0.2.16"
+  VERSION = "0.2.17"
 end

data/lib/dead_bro.rb

@@ -137,6 +137,61 @@ module DeadBro
     @monitor = monitor
   end
 
+  # Manually report a rescued exception to the DeadBro backend.
+  #
+  # Call this from any rescue block to track an error even when your app
+  # handles it gracefully and doesn't re-raise.
+  #
+  # Usage:
+  #   begin
+  #     charge_card(user)
+  #   rescue Stripe::CardError => e
+  #     DeadBro.track(e, user_id: current_user.id, plan: "pro")
+  #     render json: { error: "Card declined" }, status: 422
+  #   end
+  #
+  # Any keyword arguments are forwarded as a :context hash in the payload.
+  def self.track(error, **context)
+    return unless error.is_a?(Exception)
+
+    begin
+      exception_class = error.class.name.to_s
+      event_name = exception_class.empty? ? "exception.tracked" : exception_class
+
+      payload = {
+        exception_class: exception_class,
+        message: error.message.to_s[0, 1000],
+        backtrace: Array(error.backtrace).first(50),
+        occurred_at: Process.clock_gettime(Process::CLOCK_REALTIME).to_i, # report time, not raise time
+        tracked: true,
+        rails_env: env,
+        app: begin
+               if defined?(Rails) && Rails.respond_to?(:application)
+                 Rails.application.class.module_parent_name
+               else
+                 ""
+               end
+             rescue StandardError
+               ""
+             end,
+        pid: Process.pid,
+        logs: begin
+          logger.logs
+        rescue StandardError
+          []
+        end
+      }
+
+      payload[:context] = context unless context.empty?
+
+      client.post_metric(event_name: event_name, payload: payload, force: true)
+    rescue StandardError => _e
+      # Never let APM reporting interfere with the host app
+    end
+
+    nil
+  end
+
   # Shared constant for tracking start time (used by all subscribers)
   TRACKING_START_TIME_KEY = :dead_bro_tracking_start_time
   MAX_TRACKING_DURATION_SECONDS = 3600 # 1 hour

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: dead_bro
 version: !ruby/object:Gem::Version
-  version: 0.2.16
+  version: 0.2.17
 platform: ruby
 authors:
 - Emanuel Comsa