lapsoss 0.4.2 → 0.4.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 93ff41a78372ad8d5080a5b7d87c2783a1f5834020df285e2db5eb28f0a54d61
-  data.tar.gz: 1cbceab257813d8e7659d9a31abd2cfba0a33a6f5585776ed426c984c32a61e4
+  metadata.gz: 5db26196bdbf6e69d90c126041f7310681e240ef22e61f0a3aee12035f7616da
+  data.tar.gz: 93a2c75b6af04e776aca9c24f3704ddba51b4a2432d5d6db0f736874bef17c69
 SHA512:
-  metadata.gz: da64a5b1ec01779137189432e8dfba438e3768a1af44f71de44f3827c6ef3f2eb27b49d1b6d88479a23c51218e328f4068a86b4e210a2f73b869d2ff7167bb30
-  data.tar.gz: 126e54769b4f4ad8dad6617c27b5a80aeba5ae073879b462c8c6e01346fbc6a78029aca8589b028b6eccf9900fd1cc24e8072d119098190dbb86ac0b88521eba
+  metadata.gz: 38d9d2d1c1e2f67997b71cae8776b2c7ef8b3aca5d13d563080304c63b84b1db227eb923618b1ae078223cfc20dfebf5d1620dcf01eed92ee62d53461bf36e1e
+  data.tar.gz: 1831cda3198ad594c850fd5579fed77aa9097ee4f497dd81374bb265ee237addc4d31fab0447d6164cff6fb64695869eba42366e0820647725d0725566158ff8

data/README.md

@@ -163,6 +163,7 @@ All adapters are pure Ruby implementations with no external SDK dependencies:
 - **Rollbar** - Complete error tracking with grouping
 - **AppSignal** - Error tracking and deploy markers
 - **Insight Hub** (formerly Bugsnag) - Error tracking with breadcrumbs
+- **Telebugs** - Sentry-compatible protocol (perfect for self-hosted alternatives)
 
 ## Configuration
 
@@ -186,6 +187,17 @@ Lapsoss.configure do |config|
 end
 ```
 
+### Using Sentry-Compatible Services
+
+```ruby
+# Telebugs, Glitchtip, or any Sentry-compatible service
+Lapsoss.configure do |config|
+  config.use_telebugs(dsn: ENV['TELEBUGS_DSN'])
+  # Or use use_sentry with a custom endpoint
+  config.use_sentry(dsn: ENV['SELF_HOSTED_SENTRY_DSN'])
+end
+```
+
 ### Advanced Configuration
 
 ```ruby
@@ -310,6 +322,103 @@ config.transport_timeout = 10
 config.transport_jitter = true # Prevent thundering herd
 ```
 
+## Testing in Rails Console
+
+Want to see Lapsoss in action? Try this in your Rails console:
+
+```ruby
+# Configure Lapsoss with the logger adapter for immediate visibility
+Lapsoss.configure do |config|
+  config.use_logger(name: :console_test)
+  config.async = false  # Synchronous for immediate output
+  config.debug = true   # Verbose logging
+end
+
+# Create a class that demonstrates error handling
+class Liberation
+  def self.liberate!
+    Rails.error.handle do
+      raise StandardError, "Freedom requires breaking chains!"
+    end
+    puts "✅ Continued execution after error"
+  end
+  
+  def self.revolt!
+    Rails.error.record do
+      raise RuntimeError, "Revolution cannot be stopped!"
+    end
+    puts "This won't print - error was re-raised"
+  end
+end
+
+# Test error capture (error is swallowed)
+Liberation.liberate!
+# You'll see the error logged but execution continues
+
+# Test error recording (error is re-raised)
+begin
+  Liberation.revolt!
+rescue => e
+  puts "Caught re-raised error: #{e.message}"
+end
+
+# Manual error reporting with context
+begin
+  1 / 0
+rescue => e
+  Rails.error.report(e, context: { user_id: 42, action: "console_test" })
+end
+
+# Check what was captured
+puts "\n🎉 Lapsoss captured all errors through Rails.error!"
+```
+
+You'll see all errors logged to your console with full backtraces and context. This same integration works automatically for all Rails controllers, jobs, and mailers.
+
+## Using Lapsoss Outside Rails
+
+Lapsoss provides the same convenient error handling methods directly, perfect for background jobs, rake tasks, or standalone scripts:
+
+```ruby
+# In your Sidekiq job, rake task, or any Ruby code
+require 'lapsoss'
+
+Lapsoss.configure do |config|
+  config.use_sentry(dsn: ENV['SENTRY_DSN'])
+end
+
+# Handle errors (swallow them)
+result = Lapsoss.handle do
+  risky_operation
+end
+# Returns nil if error occurred, or the block's result
+
+# Handle with fallback
+user = Lapsoss.handle(fallback: User.anonymous) do
+  User.find(id)
+end
+
+# Record errors (re-raise them)
+Lapsoss.record do
+  critical_operation  # Error is captured then re-raised
+end
+
+# Report errors manually
+begin
+  something_dangerous
+rescue => e
+  Lapsoss.report(e, user_id: user.id, context: 'background_job')
+  # Continue processing...
+end
+
+# These methods mirror Rails.error exactly:
+# - Lapsoss.handle   → Rails.error.handle
+# - Lapsoss.record   → Rails.error.record  
+# - Lapsoss.report   → Rails.error.report
+```
+
+This means your error handling code works the same way everywhere - in Rails controllers, background jobs, rake tasks, or standalone scripts.
+
 ## Creating Custom Adapters
 
 ```ruby
@@ -323,6 +432,26 @@ end
 Lapsoss::Registry.register(:my_service, MyAdapter)
 ```
 
+### Extending Existing Adapters
+
+For Sentry-compatible services, just extend the SentryAdapter:
+
+```ruby
+class TelebugsAdapter < Lapsoss::Adapters::SentryAdapter
+  def initialize(name = :telebugs, settings = {})
+    super(name, settings)
+  end
+  
+  private
+  
+  def build_headers(public_key)
+    super(public_key).merge(
+      "X-Telebugs-Client" => "lapsoss/#{Lapsoss::VERSION}"
+    )
+  end
+end
+```
+
 ## Contributing
 
 1. Fork it

data/lib/lapsoss/adapters/concerns/level_mapping.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require "active_support/concern"
+require "active_support/core_ext/class/attribute"
 require "active_support/core_ext/hash/indifferent_access"
 
 module Lapsoss

data/lib/lapsoss/adapters/telebugs_adapter.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+require_relative "sentry_adapter"
+
+module Lapsoss
+  module Adapters
+    # Telebugs adapter - uses Sentry protocol with Telebugs endpoints
+    # Telebugs is compatible with Sentry's API, so we inherit from SentryAdapter
+    class TelebugsAdapter < SentryAdapter
+      def initialize(name = :telebugs, settings = {})
+        super(name, settings)
+      end
+
+      private
+
+      # Override to parse Telebugs DSN format
+      def parse_dsn(dsn_string)
+        uri = URI.parse(dsn_string)
+        {
+          public_key: uri.user,
+          project_id: uri.path.split("/").last,
+          host: uri.host,
+          path: uri.path
+        }
+      end
+
+      # Override to build Telebugs-specific API path
+      def build_api_path(uri)
+        # Telebugs DSN: https://[key]@[host]/api/v1/sentry_errors/[project_id]
+        # But needs to hit: /api/v1/sentry_errors/api/[project_id]/envelope/
+        # Extract base path without project_id
+        path_parts = uri.path.split("/")
+        project_id = path_parts.last
+        base_path = path_parts[0..-2].join("/")
+
+        # Build the envelope path
+        "#{base_path}/api/#{project_id}/envelope/"
+      end
+
+      # Override to setup Telebugs endpoint
+      def setup_endpoint
+        uri = URI.parse(@settings[:dsn])
+        # For Telebug, we use the full URL without port (unless non-standard)
+        port = (uri.port == 443 || uri.port == 80) ? "" : ":#{uri.port}"
+        self.class.api_endpoint = "#{uri.scheme}://#{uri.host}#{port}"
+        self.class.api_path = build_api_path(uri)
+      end
+
+      # Override headers builder to add Telebugs-specific headers
+      def headers_for(envelope)
+        base_headers = super(envelope)
+        base_headers.merge(
+          "X-Telebugs-Client" => "lapsoss/#{Lapsoss::VERSION}"
+        )
+      end
+    end
+  end
+end

data/lib/lapsoss/configuration.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require "logger"
 require "active_support/configurable"
 
 module Lapsoss
@@ -84,6 +85,11 @@ module Lapsoss
       register_adapter(name, :sentry, **settings)
     end
 
+    # Convenience method for Telebugs (Sentry-compatible)
+    def use_telebugs(name: :telebugs, **settings)
+      register_adapter(name, :telebugs, **settings)
+    end
+
     # Convenience method for AppSignal
     def use_appsignal(name: :appsignal, **settings)
       register_adapter(name, :appsignal, **settings)

data/lib/lapsoss/railtie.rb

@@ -49,7 +49,7 @@ module Lapsoss
     end
 
     initializer "lapsoss.rails_error_subscriber", after: "lapsoss.add_middleware" do |app|
-      app.executor.error_reporter.subscribe(Lapsoss::RailsErrorSubscriber.new)
+      Rails.error.subscribe(Lapsoss::RailsErrorSubscriber.new)
     end
   end
 end

data/lib/lapsoss/version.rb

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

data/lib/lapsoss.rb

@@ -44,6 +44,29 @@ module Lapsoss
       client.capture_message(message, level: level, **context)
     end
 
+    # Rails.error-compatible methods for non-Rails environments
+
+    # Handle errors and swallow them (like Rails.error.handle)
+    def handle(error_class = StandardError, fallback: nil, **context)
+      yield
+    rescue error_class => e
+      capture_exception(e, **context.merge(handled: true))
+      fallback.respond_to?(:call) ? fallback.call : fallback
+    end
+
+    # Record errors and re-raise them (like Rails.error.record)
+    def record(error_class = StandardError, **context)
+      yield
+    rescue error_class => e
+      capture_exception(e, **context.merge(handled: false))
+      raise
+    end
+
+    # Report an error manually (like Rails.error.report)
+    def report(exception, handled: true, **context)
+      capture_exception(exception, **context.merge(handled: handled))
+    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.2
+  version: 0.4.5
 platform: ruby
 authors:
 - Abdelkader Boudih
@@ -225,6 +225,7 @@ files:
 - lib/lapsoss/adapters/logger_adapter.rb
 - lib/lapsoss/adapters/rollbar_adapter.rb
 - lib/lapsoss/adapters/sentry_adapter.rb
+- lib/lapsoss/adapters/telebugs_adapter.rb
 - lib/lapsoss/backtrace_frame.rb
 - lib/lapsoss/backtrace_frame_factory.rb
 - lib/lapsoss/backtrace_processor.rb