posthog-ruby 3.2.0 → 3.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 41c94649948ce4d629d17ccc7f5ed6649c7f9ed6e69ec491ca48bc638962cba4
-  data.tar.gz: 9a152790208aed756496e031faa0c2bf5a8dfba9bc8f74a1ac3510830132ac8a
+  metadata.gz: e895ef67d6f423e89151951d6868fa464c1efe64cee6dd37be8923351bf88467
+  data.tar.gz: 7bf79b2a93e79c8717e52ed2a6ca3261f0d3933859e05e0cee1c9c22aaaa77db
 SHA512:
-  metadata.gz: b50f6538f3e285387f33a68a4c792c615f95d77826d333481637c7d3321a5490ce0be5f4bdf2ccb4ea914ae9ee5302dc488c9b3bf24f057a6c7d9c72799142d1
-  data.tar.gz: b34492ba3808627183010ca98d3e77356a873df98b5163854814e60f8225238db51cbafdb9786e9cf83a4295537c365e380094fe39d489bb518e979acd0578d4
+  metadata.gz: 881cd65e3634adc8fe539fad751591876ffd070ed712b4de8533fdf38e231ba15fd126daa0afece1b1f06b27306c3afa00c1129e37c98202391593f439cfa886
+  data.tar.gz: 2333ef174f7f08858cf518d66ac60bd6c5fa8246d06b61c73c89c5e7d08cf2986b5b45bc952d6d18476b3b73257402ee5838a362da100da1b64d7c72f4ae38eb

data/lib/posthog/client.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require 'time'
+require 'securerandom'
 
 require 'posthog/defaults'
 require 'posthog/logging'
@@ -9,6 +10,7 @@ require 'posthog/send_worker'
 require 'posthog/noop_worker'
 require 'posthog/feature_flags'
 require 'posthog/send_feature_flags_options'
+require 'posthog/exception_capture'
 
 module PostHog
   class Client
@@ -144,6 +146,33 @@ module PostHog
       enqueue(FieldParser.parse_for_capture(attrs))
     end
 
+    # Captures an exception as an event
+    #
+    # @param [Exception, String, Object] exception The exception to capture, a string message, or exception-like object
+    # @param [String] distinct_id The ID for the user (optional, defaults to a generated UUID)
+    # @param [Hash] additional_properties Additional properties to include with the exception event (optional)
+    def capture_exception(exception, distinct_id = nil, additional_properties = {})
+      exception_info = ExceptionCapture.build_parsed_exception(exception)
+
+      return if exception_info.nil?
+
+      no_distinct_id_was_provided = distinct_id.nil?
+      distinct_id ||= SecureRandom.uuid
+
+      properties = { '$exception_list' => [exception_info] }
+      properties.merge!(additional_properties) if additional_properties && !additional_properties.empty?
+      properties['$process_person_profile'] = false if no_distinct_id_was_provided
+
+      event_data = {
+        distinct_id: distinct_id,
+        event: '$exception',
+        properties: properties,
+        timestamp: Time.now
+      }
+
+      capture(event_data)
+    end
+
     # Identifies a user
     #
     # @param [Hash] attrs

data/lib/posthog/exception_capture.rb

@@ -0,0 +1,116 @@
+# frozen_string_literal: true
+
+# Portions of this file are derived from getsentry/sentry-ruby by Software, Inc. dba Sentry
+# Licensed under the MIT License
+# - sentry-ruby/lib/sentry/interfaces/single_exception.rb
+# - sentry-ruby/lib/sentry/interfaces/stacktrace_builder.rb
+# - sentry-ruby/lib/sentry/backtrace.rb
+# - sentry-ruby/lib/sentry/interfaces/stacktrace.rb
+# - sentry-ruby/lib/sentry/linecache.rb
+
+# 💖 open source (under MIT License)
+
+module PostHog
+  module ExceptionCapture
+    RUBY_INPUT_FORMAT = /
+        ^ \s* (?: [a-zA-Z]: | uri:classloader: )? ([^:]+ | <.*>):
+        (\d+)
+        (?: :in\s('|`)(?:([\w:]+)\#)?([^']+)')?$
+      /x
+
+    def self.build_parsed_exception(value)
+      title, message, backtrace = coerce_exception_input(value)
+      return nil if title.nil?
+
+      build_single_exception_from_data(title, message, backtrace)
+    end
+
+    def self.build_single_exception_from_data(title, message, backtrace)
+      {
+        'type' => title,
+        'value' => message || '',
+        'mechanism' => {
+          'type' => 'generic',
+          'handled' => true
+        },
+        'stacktrace' => build_stacktrace(backtrace)
+      }
+    end
+
+    def self.build_stacktrace(backtrace)
+      return nil unless backtrace && !backtrace.empty?
+
+      frames = backtrace.first(50).map do |line|
+        parse_backtrace_line(line)
+      end.compact.reverse
+
+      {
+        'type' => 'raw',
+        'frames' => frames
+      }
+    end
+
+    def self.parse_backtrace_line(line)
+      match = line.match(RUBY_INPUT_FORMAT)
+      return nil unless match
+
+      file = match[1]
+      lineno = match[2].to_i
+      method_name = match[5]
+
+      frame = {
+        'filename' => File.basename(file),
+        'abs_path' => file,
+        'lineno' => lineno,
+        'function' => method_name,
+        'in_app' => !gem_path?(file),
+        'platform' => 'ruby'
+      }
+
+      add_context_lines(frame, file, lineno) if File.exist?(file)
+
+      frame
+    end
+
+    def self.gem_path?(path)
+      path.include?('/gems/') ||
+        path.include?('/ruby/') ||
+        path.include?('/.rbenv/') ||
+        path.include?('/.rvm/')
+    end
+
+    def self.add_context_lines(frame, file_path, lineno, context_size = 5)
+      lines = File.readlines(file_path)
+      return if lines.empty?
+
+      return unless lineno.positive? && lineno <= lines.length
+
+      pre_context_start = [lineno - context_size, 1].max
+      post_context_end = [lineno + context_size, lines.length].min
+
+      frame['context_line'] = lines[lineno - 1].chomp
+
+      frame['pre_context'] = lines[(pre_context_start - 1)...(lineno - 1)].map(&:chomp) if pre_context_start < lineno
+
+      frame['post_context'] = lines[lineno...(post_context_end)].map(&:chomp) if post_context_end > lineno
+    rescue StandardError
+      # Silently ignore file read errors
+    end
+
+    def self.coerce_exception_input(value)
+      if value.is_a?(String)
+        title = 'Error'
+        message = value
+        backtrace = nil
+      elsif value.respond_to?(:backtrace) && value.respond_to?(:message)
+        title = value.class.to_s
+        message = value.message || ''
+        backtrace = value.backtrace
+      else
+        return [nil, nil, nil]
+      end
+
+      [title, message, backtrace]
+    end
+  end
+end

data/lib/posthog/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module PostHog
-  VERSION = '3.2.0'
+  VERSION = '3.3.0'
 end

data/lib/posthog.rb

@@ -9,3 +9,4 @@ require 'posthog/send_worker'
 require 'posthog/transport'
 require 'posthog/response'
 require 'posthog/logging'
+require 'posthog/exception_capture'

metadata

@@ -1,13 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: posthog-ruby
 version: !ruby/object:Gem::Version
-  version: 3.2.0
+  version: 3.3.0
 platform: ruby
 authors:
 - ''
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-08-26 00:00:00.000000000 Z
+date: 2025-09-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
@@ -38,6 +39,7 @@ files:
 - lib/posthog/backoff_policy.rb
 - lib/posthog/client.rb
 - lib/posthog/defaults.rb
+- lib/posthog/exception_capture.rb
 - lib/posthog/feature_flag.rb
 - lib/posthog/feature_flags.rb
 - lib/posthog/field_parser.rb
@@ -55,6 +57,7 @@ licenses:
 - MIT
 metadata:
   rubygems_mfa_required: 'true'
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -69,7 +72,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.6
+rubygems_version: 3.5.3
+signing_key:
 specification_version: 4
 summary: PostHog library
 test_files: []