lapsoss 0.4.11 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a4370921854bb3be19bd9209a54da4a763833386b0ef917c6ec5a632a2941db9
-  data.tar.gz: 7df3efd16d2b889561b94a76c2d8ed7b7e764ca6b2a5b45e3edf510b58bcf8bc
+  metadata.gz: 7c8f5f1fbdb514808ad6accd57f448a1d997f86f8c53224456421879e78ee40e
+  data.tar.gz: ee76c128c4b6f7b0f7d51ff81700258d6a8e1fbde522400009fa682b49658c7f
 SHA512:
-  metadata.gz: 23f1efbcc3d5fb6cceb32f9d7794f1ce8943dfe51696b42c95c2bdc257acb0a6770c0470d2d72729f45e9beb7919948c46dea8db6bfb903381466c7dfd2ab771
-  data.tar.gz: 3fd7dbd3eca37712e7eec4fa9908939b797805d779d62f242c6c6e30f1ca7baeeb49470f1a1f7a1cd97f5d3d0320ecd116048870a2bb4d530380bcfd716243e5
+  metadata.gz: '0591e240fabe7f68e179a09f55d61bc03f26374ca7abd28bc4f5a67789644670342ef43d7f56ebff6c3e409e7df18fd77ae11e82ae5d6fe44af582add4e20efb'
+  data.tar.gz: f85e9148f94abe28ff69693169fc600641c99cf1d2f0d0204b95c3c3582e039d5fab19cc9a7b8442e09dd72b2d2c2ce33f71339d0967b068a3c1363dab583bd5

data/README.md

@@ -39,7 +39,7 @@ end
 ## Requirements
 
 - Ruby 3.3+
-- Rails 7.2+
+- Rails 8.1+
 
 ## Installation
 
@@ -69,7 +69,7 @@ That's it. No 500-line examples needed.
 
 ## Built for Rails, Not Around It
 
-Lapsoss integrates with Rails' native error reporting API introduced in Rails 7. No monkey-patching, no global error handlers:
+Lapsoss integrates with Rails' native error reporting API (`Rails.error`). No monkey-patching, no global error handlers:
 
 ```ruby
 # It just works with Rails.error:
@@ -116,6 +116,51 @@ end
 
 # Or use Rails.error directly with your configured services
 Rails.error.report(e, context: { user_id: current_user.id })
+
+# For "should never happen" paths, Rails.error.unexpected raises in
+# development/test and reports in production - and routes through Lapsoss too
+Rails.error.unexpected("Reached unreachable branch")
+```
+
+### Structured Events as Breadcrumbs
+
+Lapsoss automatically subscribes to the structured event reporter
+(`Rails.event`) and records emitted events as breadcrumbs. When an error is
+captured, the recent activity trail is attached to the report - no
+monkey-patching, just Rails' native API:
+
+```ruby
+Rails.event.notify("order.checkout_started", cart_id: cart.id)
+# ... an exception here includes that breadcrumb in the error report
+
+# Tags and context flow into breadcrumb metadata
+Rails.event.tagged(section: "checkout") do
+  Rails.event.notify("payment.authorized", amount: 42_00)
+end
+```
+
+Tune or disable it:
+
+```ruby
+Lapsoss.configure do |config|
+  config.capture_rails_events = false                            # opt out entirely
+  config.rails_event_filter = ->(event) { !event[:name].start_with?("noisy.") }
+end
+```
+
+Rails-side enrichment also composes: context added via `Rails.error.add_middleware`
+flows into the `context:` Lapsoss receives for free.
+
+### Silencing Capture
+
+Suppress delivery for a block (thread-local) - useful in tests or around
+expected-failure paths. Breadcrumbs and scope still accumulate; only delivery
+is skipped:
+
+```ruby
+Lapsoss.silence do
+  retry_flaky_third_party_call
+end
 ```
 
 ### No Global Patching Philosophy
@@ -329,7 +374,9 @@ end
 
 ### Filtering Errors
 
-You decide what errors to track. Lapsoss doesn't make assumptions:
+You decide what errors to track. Lapsoss doesn't make assumptions.
+
+**Execution order:** `exclusion_filter` runs first, then `before_send`.
 
 ```ruby
 Lapsoss.configure do |config|

data/lib/lapsoss/client.rb

@@ -80,6 +80,11 @@ module Lapsoss
     private
 
     def capture_event(event)
+      if Current.silenced
+        @configuration.logger.debug("[LAPSOSS] Event dropped: capture silenced via Lapsoss.silence")
+        return nil
+      end
+
       @configuration.logger.debug("[LAPSOSS] capture_event called, async: #{@configuration.async}, executor: #{@executor.inspect}")
 
       # Apply pipeline processing if enabled

data/lib/lapsoss/configuration.rb

@@ -14,7 +14,7 @@ module Lapsoss
                   :backtrace_strip_load_path, :backtrace_max_frames, :backtrace_enable_code_context,
                   :enable_pipeline, :pipeline_builder, :sampling_strategy,
                   :skip_rails_cache_errors, :force_sync_http, :capture_request_context,
-                  :exclusion_filter
+                  :exclusion_filter, :capture_rails_events, :rails_event_filter
     attr_reader :fingerprint_callback, :environment, :before_send, :sample_rate, :error_handler, :transport_timeout,
                 :transport_max_retries, :transport_initial_backoff, :transport_max_backoff, :transport_backoff_multiplier, :transport_ssl_verify, :default_context, :adapter_configs
 
@@ -62,6 +62,9 @@ module Lapsoss
       @sampling_strategy = nil
       # Rails error filtering
       @skip_rails_cache_errors = true
+      # Rails.event structured events as breadcrumbs (Rails 8.1+)
+      @capture_rails_events = true
+      @rails_event_filter = nil
       # HTTP client settings
       @force_sync_http = false
       # Capture request context in middleware

data/lib/lapsoss/current.rb

@@ -5,6 +5,7 @@ require "active_support/all"
 module Lapsoss
   class Current < ActiveSupport::CurrentAttributes
     attribute :scope, default: -> { Scope.new }
+    attribute :silenced, default: false
 
     def self.with_clean_scope
       previous_scope = scope

data/lib/lapsoss/rails_event_subscriber.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module Lapsoss
+  # Subscribes to Rails' structured event reporter (Rails.event, Rails 8.1+)
+  # and records emitted events as Lapsoss breadcrumbs, giving error reports an
+  # automatic activity trail without any monkey-patching.
+  class RailsEventSubscriber
+    def emit(event)
+      return unless Lapsoss.client
+
+      Lapsoss.add_breadcrumb(event[:name], type: :event, **breadcrumb_metadata(event))
+    end
+
+    private
+
+    def breadcrumb_metadata(event)
+      metadata = {}
+      payload = serialize_payload(event[:payload])
+      metadata[:payload] = payload if payload
+      metadata[:tags] = event[:tags] if event[:tags].present?
+      metadata[:context] = event[:context] if event[:context].present?
+
+      if (location = event[:source_location])
+        metadata[:source] = "#{location[:filepath]}:#{location[:lineno]}"
+      end
+
+      metadata
+    end
+
+    # Payloads are either hashes or arbitrary event objects, which Rails passes
+    # through as-is and expects subscribers to serialize.
+    def serialize_payload(payload)
+      case payload
+      when nil, Hash
+        payload
+      else
+        payload.respond_to?(:serialize) ? payload.serialize : payload.inspect
+      end
+    end
+  end
+end

data/lib/lapsoss/railtie.rb

@@ -39,6 +39,19 @@ module Lapsoss
       Rails.error.subscribe(Lapsoss::RailsErrorSubscriber.new)
     end
 
+    initializer "lapsoss.rails_event_subscriber" do
+      Rails.event.subscribe(Lapsoss::RailsEventSubscriber.new) do |event|
+        config = Lapsoss.configuration
+        if !config.capture_rails_events
+          false
+        elsif (filter = config.rails_event_filter)
+          !!filter.call(event)
+        else
+          true
+        end
+      end
+    end
+
     initializer "lapsoss.controller_transaction" do
       ActiveSupport.on_load(:action_controller) do
         require "lapsoss/rails_controller_transaction"

data/lib/lapsoss/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Lapsoss
-  VERSION = "0.4.11"
+  VERSION = "1.0.0"
 end

data/lib/lapsoss.rb

@@ -69,6 +69,20 @@ module Lapsoss
       capture_exception(exception, **context.merge(handled: handled))
     end
 
+    # Suppress all event capture for the duration of the block (thread-local).
+    # Breadcrumbs and scope still accumulate; only delivery is skipped.
+    def silence
+      previous = Current.silenced
+      Current.silenced = true
+      yield
+    ensure
+      Current.silenced = previous
+    end
+
+    def silenced?
+      Current.silenced
+    end
+
     def add_breadcrumb(message, type: :default, **metadata)
       client.add_breadcrumb(message, type: type, **metadata)
     end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lapsoss
 version: !ruby/object:Gem::Version
-  version: 0.4.11
+  version: 1.0.0
 platform: ruby
 authors:
 - Abdelkader Boudih
@@ -15,7 +15,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '7.2'
+        version: '8.1'
     - - "<"
       - !ruby/object:Gem::Version
         version: '9.0'
@@ -25,7 +25,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '7.2'
+        version: '8.1'
     - - "<"
       - !ruby/object:Gem::Version
         version: '9.0'
@@ -258,6 +258,7 @@ files:
 - lib/lapsoss/rails_controller_context.rb
 - lib/lapsoss/rails_controller_transaction.rb
 - lib/lapsoss/rails_error_subscriber.rb
+- lib/lapsoss/rails_event_subscriber.rb
 - lib/lapsoss/railtie.rb
 - lib/lapsoss/registry.rb
 - lib/lapsoss/release_tracker.rb
@@ -293,7 +294,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 4.0.10
 specification_version: 4
 summary: Modern error reporting with pluggable adapters for Rails applications
 test_files: []