lapsoss 0.4.4 → 0.4.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3c9422cb2f9fa0e1ae582a771fd337d61177d9236db6cd3dfc96edf3fefc7777
-  data.tar.gz: d1dc595b8fcd5e00feb9f01087e77700bb49452a6b358a309ce630d6b29bd203
+  metadata.gz: bc2f5c5b2a06b525bb921e683c87a201e93507c795b6cff7e4cddc33d3716880
+  data.tar.gz: 3d5bce60161f233758b0f39fdf54197ac7c5b0db921709ac3e1a4e54531bf669
 SHA512:
-  metadata.gz: 218bbe054b15df5457996cfda82aa6227477446dc0a5be24680acbae4c4ff3edfaf7217adfc96814aba94fe09331300253f4a499a85055b2fbac8df83a8336fb
-  data.tar.gz: d5b0f10802bfe6c938cf90e8a322b0bc940b11d3bca9fde5efcaf96964c5753c09e04ae453087844cb455056b2cd6fd242e846e99ce59270d25962367daa7bda
+  metadata.gz: 569ae7372bbe9f3984c0cb1b13074e1442af9f34cb21e74124f04db1a62227a7ac08c8d856d08c739e9da05a799c288260b72e62e8e7df44f5fa853bfacf5d7b
+  data.tar.gz: 6e17e4ffdd5d757fb70414da87e188ee12dbc1469bb37ac978554c2fc5146e5f86ebb257daefe37748e3129140d402d34c517ac1c756aa56c56defdd41a159e9

data/README.md

@@ -163,7 +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
-- **Telebug** - Sentry-compatible protocol (perfect for self-hosted alternatives)
+- **Telebugs** - Sentry-compatible protocol (perfect for self-hosted alternatives)
 
 ## Configuration
 
@@ -190,9 +190,9 @@ end
 ### Using Sentry-Compatible Services
 
 ```ruby
-# Telebug, Glitchtip, or any Sentry-compatible service
+# Telebugs, Glitchtip, or any Sentry-compatible service
 Lapsoss.configure do |config|
-  config.use_telebug(dsn: ENV['TELEBUG_DSN'])
+  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
@@ -437,8 +437,8 @@ Lapsoss::Registry.register(:my_service, MyAdapter)
 For Sentry-compatible services, just extend the SentryAdapter:
 
 ```ruby
-class TelebugAdapter < Lapsoss::Adapters::SentryAdapter
-  def initialize(name = :telebug, settings = {})
+class TelebugsAdapter < Lapsoss::Adapters::SentryAdapter
+  def initialize(name = :telebugs, settings = {})
     super(name, settings)
   end
   
@@ -446,7 +446,7 @@ class TelebugAdapter < Lapsoss::Adapters::SentryAdapter
   
   def build_headers(public_key)
     super(public_key).merge(
-      "X-Telebug-Client" => "lapsoss/#{Lapsoss::VERSION}"
+      "X-Telebugs-Client" => "lapsoss/#{Lapsoss::VERSION}"
     )
   end
 end

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

@@ -122,7 +122,7 @@ module Lapsoss
         end
 
         def user_agent
-          "Lapsoss/#{Lapsoss::VERSION} Ruby/#{RUBY_VERSION} Rails/#{Rails.version if defined?(Rails)}"
+          Base::USER_AGENT
         end
       end
     end

data/lib/lapsoss/adapters/sentry_adapter.rb

@@ -2,6 +2,7 @@
 
 require "active_support/core_ext/object/blank"
 require "uri"
+require "lapsoss/runtime_context"
 
 module Lapsoss
   module Adapters
@@ -80,7 +81,7 @@ module Lapsoss
           content_type: "application/json"
         }
 
-        item_payload = build_envelope_wrapper(event)
+        item_payload = build_sentry_event(event)
 
         # Sentry envelope is newline-delimited JSON
         [
@@ -90,6 +91,88 @@ module Lapsoss
         ].join("\n")
       end
 
+      # Build Sentry-compliant event structure
+      def build_sentry_event(event)
+        context = RuntimeContext.current
+        event_id = event.fingerprint.presence || SecureRandom.uuid
+
+        base_event = {
+          event_id: event_id,
+          timestamp: format_timestamp(event.timestamp),
+          platform: "ruby",
+          level: map_level(event.level),
+          environment: event.environment.presence || "production",
+          release: context.release,
+          server_name: context.server_name,
+          modules: context.modules,
+          contexts: context.to_contexts,
+          tags: event.tags.presence,
+          user: event.user_context.presence,
+          extra: event.extra.presence,
+          breadcrumbs: format_breadcrumbs(event.breadcrumbs),
+          sdk: {
+            name: "sentry.ruby",
+            version: Lapsoss::VERSION
+          }
+        }.compact_blank
+
+        # Add event-specific data
+        case event.type
+        when :exception
+          base_event.merge(build_exception_envelope(event))
+        when :message
+          base_event.merge(
+            message: event.message,
+            level: map_level(event.level)
+          )
+        else
+          base_event
+        end
+      end
+
+      def build_exception_envelope(event)
+        {
+          exception: {
+            values: [ {
+              type: event.exception_type,
+              value: event.exception_message,
+              module: nil,
+              thread_id: Thread.current.object_id,
+              stacktrace: build_sentry_stacktrace(event),
+              mechanism: { type: "generic", handled: true }
+            } ]
+          },
+          threads: {
+            values: [ {
+              id: Thread.current.object_id,
+              name: Thread.current.name,
+              crashed: true,
+              current: true
+            } ]
+          }
+        }
+      end
+
+      def build_sentry_stacktrace(event)
+        return nil unless event.has_backtrace?
+
+        frames = event.backtrace_frames.map do |frame|
+          {
+            filename: frame.filename,
+            abs_path: frame.absolute_path || frame.filename,
+            function: frame.method_name || frame.function,
+            lineno: frame.line_number,
+            in_app: frame.in_app,
+            pre_context: frame.code_context&.dig(:pre_context),
+            context_line: frame.code_context&.dig(:context_line),
+            post_context: frame.code_context&.dig(:post_context)
+          }.compact
+        end
+
+        # Sentry expects frames in reverse order (oldest to newest)
+        { frames: frames.reverse }
+      end
+
       # Override serialization for Sentry's envelope format
       def serialize_payload(envelope_string)
         # Sentry envelopes are already formatted, just compress if needed

data/lib/lapsoss/adapters/{telebug_adapter.rb → telebugs_adapter.rb}

@@ -4,16 +4,16 @@ require_relative "sentry_adapter"
 
 module Lapsoss
   module Adapters
-    # Telebug adapter - uses Sentry protocol with Telebug endpoints
-    # Telebug is compatible with Sentry's API, so we inherit from SentryAdapter
-    class TelebugAdapter < SentryAdapter
-      def initialize(name = :telebug, settings = {})
+    # 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 Telebug DSN format
+      # Override to parse Telebugs DSN format
       def parse_dsn(dsn_string)
         uri = URI.parse(dsn_string)
         {
@@ -24,15 +24,20 @@ module Lapsoss
         }
       end
 
-      # Override to build Telebug-specific API path
+      # Override to build Telebugs-specific API path
       def build_api_path(uri)
-        # Telebug uses: https://[key]@[host]/api/v1/sentry_errors/[project_id]
-        # The path is already complete: /api/v1/sentry_errors/4
-        # Unlike Sentry which needs /api/[project_id]/envelope/
-        uri.path
+        # 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 Telebug endpoint
+      # 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)
@@ -41,18 +46,13 @@ module Lapsoss
         self.class.api_path = build_api_path(uri)
       end
 
-      # Override headers builder to add Telebug-specific headers
+      # Override headers builder to add Telebugs-specific headers
       def headers_for(envelope)
         base_headers = super(envelope)
         base_headers.merge(
-          "X-Telebug-Client" => "lapsoss/#{Lapsoss::VERSION}"
+          "X-Telebugs-Client" => "lapsoss/#{Lapsoss::VERSION}"
         )
       end
-
-      # Override user agent for Telebug
-      def user_agent
-        "lapsoss-telebug/#{Lapsoss::VERSION}"
-      end
     end
   end
 end

data/lib/lapsoss/backtrace_frame.rb

@@ -3,6 +3,7 @@
 module Lapsoss
   BacktraceFrame = Data.define(
     :filename,
+    :absolute_path,
     :line_number,
     :method_name,
     :in_app,
@@ -19,6 +20,7 @@ module Lapsoss
     def to_h
       {
         filename: filename,
+        absolute_path: absolute_path,
         line_number: line_number,
         method: method_name,
         function: function,
@@ -30,9 +32,13 @@ module Lapsoss
     end
 
     def add_code_context(processor, context_lines = 3)
-      return unless filename && line_number && File.exist?(filename)
+      return unless line_number
 
-      with(code_context: processor.get_code_context(filename, line_number, context_lines))
+      # Use absolute path if available, otherwise try filename
+      path_to_read = absolute_path || filename
+      return unless path_to_read
+
+      with(code_context: processor.get_code_context(path_to_read, line_number, context_lines))
     end
 
     def valid?

data/lib/lapsoss/backtrace_frame_factory.rb

@@ -75,10 +75,14 @@ module Lapsoss
       filename, line_number, method_name, function, module_name, block_info = parse_line_components
 
       in_app = determine_app_status(filename)
-      filename = normalize_path(filename) if filename
+
+      # Keep both absolute and normalized paths
+      absolute_path = filename
+      normalized_filename = normalize_path(filename) if filename
 
       BacktraceFrame.new(
-        filename: filename,
+        filename: normalized_filename,
+        absolute_path: absolute_path,
         line_number: line_number,
         method_name: method_name,
         in_app: in_app,

data/lib/lapsoss/backtrace_processor.rb

@@ -196,8 +196,7 @@ module Lapsoss
 
     # Get code context around a specific line number using ActiveSupport::Cache
     def get_code_context(filename, line_number, context_lines = 3)
-      return nil unless filename && File.exist?(filename)
-      return nil if File.size(filename) > (@config[:max_file_size] || (1024 * 1024))
+      return nil unless filename
 
       lines = @file_cache.fetch(filename) do
         read_file_safely(filename)
@@ -229,6 +228,9 @@ module Lapsoss
     private
 
     def read_file_safely(filename)
+      # Don't read huge files
+      return [] if File.exist?(filename) && File.size(filename) > (@config[:max_file_size] || (1024 * 1024))
+
       File.readlines(filename, chomp: true)
     rescue StandardError
       []

data/lib/lapsoss/configuration.rb

@@ -85,9 +85,9 @@ module Lapsoss
       register_adapter(name, :sentry, **settings)
     end
 
-    # Convenience method for Telebug (Sentry-compatible)
-    def use_telebug(name: :telebug, **settings)
-      register_adapter(name, :telebug, **settings)
+    # Convenience method for Telebugs (Sentry-compatible)
+    def use_telebugs(name: :telebugs, **settings)
+      register_adapter(name, :telebugs, **settings)
     end
 
     # Convenience method for AppSignal

data/lib/lapsoss/runtime_context.rb

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+
+require "rbconfig"
+require "socket"
+
+module Lapsoss
+  # Boot-time context collection using Data class
+  RuntimeContext = Data.define(:os, :runtime, :modules, :server_name, :release) do
+    def self.current
+      @current ||= new(
+        os: collect_os_context,
+        runtime: collect_runtime_context,
+        modules: collect_modules,
+        server_name: collect_server_name,
+        release: collect_release
+      )
+    end
+
+    def self.collect_os_context
+      {
+        name: RbConfig::CONFIG["host_os"],
+        version: `uname -r 2>/dev/null`.strip.presence,
+        build: `uname -v 2>/dev/null`.strip.presence,
+        kernel_version: `uname -a 2>/dev/null`.strip.presence,
+        machine: RbConfig::CONFIG["host_cpu"]
+      }.compact
+    rescue
+      { name: RbConfig::CONFIG["host_os"] }
+    end
+
+    def self.collect_runtime_context
+      {
+        name: "ruby",
+        version: RUBY_DESCRIPTION
+      }
+    end
+
+    def self.collect_modules
+      return {} unless defined?(Bundler)
+
+      Bundler.load.specs.each_with_object({}) do |spec, h|
+        h[spec.name] = spec.version.to_s
+      end
+    rescue
+      {}
+    end
+
+    def self.collect_server_name
+      Socket.gethostname
+    rescue
+      "unknown"
+    end
+
+    def self.collect_release
+      # Try to get from git if available
+      if File.exist?(".git")
+        `git rev-parse HEAD 2>/dev/null`.strip.presence
+      end
+    rescue
+      nil
+    end
+
+    def to_contexts
+      {
+        os: os,
+        runtime: runtime
+      }
+    end
+  end
+end

data/lib/lapsoss/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lapsoss
 version: !ruby/object:Gem::Version
-  version: 0.4.4
+  version: 0.4.6
 platform: ruby
 authors:
 - Abdelkader Boudih
@@ -225,7 +225,7 @@ files:
 - lib/lapsoss/adapters/logger_adapter.rb
 - lib/lapsoss/adapters/rollbar_adapter.rb
 - lib/lapsoss/adapters/sentry_adapter.rb
-- lib/lapsoss/adapters/telebug_adapter.rb
+- lib/lapsoss/adapters/telebugs_adapter.rb
 - lib/lapsoss/backtrace_frame.rb
 - lib/lapsoss/backtrace_frame_factory.rb
 - lib/lapsoss/backtrace_processor.rb
@@ -255,6 +255,7 @@ files:
 - lib/lapsoss/registry.rb
 - lib/lapsoss/release_tracker.rb
 - lib/lapsoss/router.rb
+- lib/lapsoss/runtime_context.rb
 - lib/lapsoss/sampling/base.rb
 - lib/lapsoss/sampling/rate_limiter.rb
 - lib/lapsoss/sampling/uniform_sampler.rb