salopulse 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5c06e78cb26ed1b47d866b3cf8a0d403373cf9c8beb76ca91292b76505a56753
-  data.tar.gz: 71295dd725c6063cfd8bb72ea668ac8160e9e92878fcd46997eed64a8245a1b7
+  metadata.gz: 54e35ff25bd4f509773e4121f6f18612741353a90fdcfb2f8d17444b48019ebc
+  data.tar.gz: a0b1d4b69b96151d2de4a2662c6bde1ebfb4160ccc23320b9d5c6e9e89685147
 SHA512:
-  metadata.gz: 4181cb25abebd7be379e294e136a0c33e9c07e8bcaac9d01b1abc7fb14ed5b9927ad1e6adb645e7cb3233ab578b307ba248a8b0dcf135a796c06b470b20d5429
-  data.tar.gz: 732c617c949e3f8f7897f229ed0ad5fb82aa7d99828afb6d5b2891e8bee591f86330c5899b3dc14a3e6ff4606d343226ff95e2ad05a37b5c420bc8b9bfc5d4a9
+  metadata.gz: a22fbc00d2411e2b88a6af24fbc854ef13be0d4f7e10f1ba2b50d082861ece0582e86ed783aff4cfb01b3e86f560fb7090e1a83a56829d1634248831bdc6be91
+  data.tar.gz: 0fd9d36419e61fe1b0633cdc49685cc2599fde166f852a5eba0435fb5fe6e27c8f06de1a22f1bc788b1cfdf7c87a7b0cf9b66e3afda3184025f3bdf600d6a0d1

data/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 Format: [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
+## [0.4.0] - 2026-06-10
+
+### Added
+- `StackFrameBuilder` parses exception backtraces into structured frames and
+  attaches `pre_context`, `context_line`, and `post_context` source lines for
+  in-app frames. `capture_exception` now sends a `stack_frames` array
+  alongside the existing `stack_trace` string, enabling source-snippet
+  rendering in the dashboard
+- `Configuration#app_root` controls which paths are treated as in-app; defaults
+  to `Rails.root` when Rails is loaded and `Dir.pwd` otherwise
+
 ## [0.3.0] - 2026-06-08
 
 ### Added

data/lib/salopulse/client.rb

@@ -9,6 +9,7 @@ require_relative "flusher"
 require_relative "sanitizer"
 require_relative "local_fingerprint"
 require_relative "request_context"
+require_relative "stack_frame_builder"
 
 module Salopulse
   class Client
@@ -92,10 +93,12 @@ module Salopulse
       return unless sample?
 
       ctx = RequestContext.current
+      backtrace = Array(error.backtrace)
       data = {
         "error_class" => error.class.name,
         "message" => error.message.to_s,
-        "stack_trace" => Array(error.backtrace).join("\n"),
+        "stack_trace" => backtrace.join("\n"),
+        "stack_frames" => StackFrameBuilder.call(backtrace, app_root: configuration&.app_root),
         "endpoint" => ctx&.dig(:endpoint),
         "http_method" => ctx&.dig(:http_method)
       }

data/lib/salopulse/configuration.rb

@@ -4,7 +4,8 @@ module Salopulse
   class Configuration
     attr_accessor :dsn, :release, :environment, :sample_rate,
                   :flush_interval, :flush_batch_size, :n1_threshold,
-                  :before_send, :logger, :enabled, :max_buffer_size
+                  :before_send, :logger, :enabled, :max_buffer_size,
+                  :app_root
 
     def initialize
       @release = nil
@@ -17,6 +18,16 @@ module Salopulse
       @logger = Logger.new($stdout, level: Logger::WARN)
       @enabled = true
       @max_buffer_size = 10_000
+      @app_root = detect_app_root
+    end
+
+    private
+
+    def detect_app_root
+      return Rails.root.to_s if defined?(Rails) && Rails.respond_to?(:root) && Rails.root
+      Dir.pwd
+    rescue StandardError
+      Dir.pwd
     end
   end
 end

data/lib/salopulse/stack_frame_builder.rb

@@ -0,0 +1,97 @@
+module Salopulse
+  class StackFrameBuilder
+    BACKTRACE_LINE = /\A(?<file>.+?):(?<line>\d+):in\s+[`'](?<method>.+?)['`]\z/
+    CONTEXT_LINES = 5
+    MAX_FRAMES = 50
+    FRAMEWORK_MARKERS = [ "/gems/", "/rubygems/", "/bundle/" ].freeze
+
+    SOURCE_CACHE = {}
+    SOURCE_CACHE_MUTEX = Mutex.new
+    SOURCE_CACHE_LIMIT = 512
+
+    def self.call(backtrace, app_root: nil)
+      new(backtrace, app_root: app_root).call
+    end
+
+    def initialize(backtrace, app_root:)
+      @backtrace = Array(backtrace)
+      @app_root = app_root && File.expand_path(app_root.to_s)
+    end
+
+    def call
+      @backtrace.first(MAX_FRAMES).filter_map { |line| build_frame(line.to_s) }
+    end
+
+    private
+
+    def build_frame(raw)
+      match = BACKTRACE_LINE.match(raw)
+      return nil unless match
+
+      abs_path = match[:file]
+      lineno   = match[:line].to_i
+      in_app   = in_app?(abs_path)
+
+      frame = {
+        "file"     => relative_file(abs_path),
+        "abs_path" => abs_path,
+        "line"     => lineno,
+        "method"   => match[:method],
+        "in_app"   => in_app,
+        "package"  => detect_package(abs_path)
+      }
+
+      attach_source_context(frame, abs_path, lineno) if in_app
+      frame
+    end
+
+    def in_app?(file)
+      return false if FRAMEWORK_MARKERS.any? { |marker| file.include?(marker) }
+      return true unless @app_root
+
+      File.expand_path(file).start_with?(@app_root)
+    end
+
+    def detect_package(file)
+      match = file.match(%r{/gems/(?<package>[^/]+)/})
+      match && match[:package]
+    end
+
+    def relative_file(file)
+      return file unless @app_root
+
+      expanded = File.expand_path(file)
+      return file unless expanded.start_with?(@app_root)
+
+      expanded.sub(/\A#{Regexp.escape(@app_root)}\/?/, "")
+    end
+
+    def attach_source_context(frame, file, lineno)
+      lines = read_source(file)
+      return if lines.empty?
+
+      idx = lineno - 1
+      return if idx.negative? || idx >= lines.length
+
+      pre_start = [ idx - CONTEXT_LINES, 0 ].max
+      post_end  = [ idx + CONTEXT_LINES, lines.length - 1 ].min
+
+      frame["pre_context"]  = lines[pre_start...idx].map { |l| l.to_s.chomp }
+      frame["context_line"] = lines[idx].to_s.chomp
+      frame["post_context"] = lines[(idx + 1)..post_end].to_a.map { |l| l.to_s.chomp }
+    end
+
+    def read_source(file)
+      SOURCE_CACHE_MUTEX.synchronize do
+        return SOURCE_CACHE[file] if SOURCE_CACHE.key?(file)
+
+        SOURCE_CACHE.shift if SOURCE_CACHE.size >= SOURCE_CACHE_LIMIT
+        SOURCE_CACHE[file] = begin
+          File.readlines(file)
+        rescue StandardError
+          []
+        end
+      end
+    end
+  end
+end

data/lib/salopulse/version.rb

@@ -1,3 +1,3 @@
 module Salopulse
-  VERSION = "0.3.0".freeze
+  VERSION = "0.4.0".freeze
 end

data/lib/salopulse.rb

@@ -7,6 +7,7 @@ require_relative "salopulse/buffer"
 require_relative "salopulse/sanitizer"
 require_relative "salopulse/local_fingerprint"
 require_relative "salopulse/request_context"
+require_relative "salopulse/stack_frame_builder"
 require_relative "salopulse/transport"
 require_relative "salopulse/flusher"
 require_relative "salopulse/client"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: salopulse
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Salih İmran Büker
@@ -94,6 +94,7 @@ files:
 - lib/salopulse/railtie.rb
 - lib/salopulse/request_context.rb
 - lib/salopulse/sanitizer.rb
+- lib/salopulse/stack_frame_builder.rb
 - lib/salopulse/transport.rb
 - lib/salopulse/version.rb
 homepage: https://github.com/mersieS/salopulse-ruby-sdk