uncaught 0.1.0

data/lib/uncaught/types.rb

@@ -0,0 +1,84 @@
+# frozen_string_literal: true
+
+module Uncaught
+  # Severity levels mirroring syslog.
+  SEVERITY_LEVELS = %w[fatal error warning info debug].freeze
+
+  # Breadcrumb categories.
+  BREADCRUMB_TYPES = %w[click navigation api_call db_query auth console web_vital custom].freeze
+
+  # Issue statuses.
+  ISSUE_STATUSES = %w[open resolved ignored].freeze
+
+  # Transport modes.
+  TRANSPORT_MODES = %w[local console].freeze
+
+  # ---------------------------------------------------------------------------
+  # Struct definitions
+  # ---------------------------------------------------------------------------
+
+  # SDK metadata shipped with every event.
+  SdkInfo = Struct.new(:name, :version, keyword_init: true)
+
+  # Contextual HTTP request information attached to an event.
+  RequestInfo = Struct.new(:method, :url, :headers, :body, :query, keyword_init: true)
+
+  # Information about a failed external operation (DB, auth, API, etc.).
+  OperationInfo = Struct.new(:provider, :type, :method, :params, :error_code, :error_details, keyword_init: true)
+
+  # User context attached to events.
+  UserInfo = Struct.new(:id, :email, :username, :session_id, keyword_init: true)
+
+  # Structured representation of a captured error.
+  ErrorInfo = Struct.new(:message, :type, :stack, :resolved_stack, :component_stack, keyword_init: true)
+
+  # A single breadcrumb entry.
+  Breadcrumb = Struct.new(:type, :category, :message, :timestamp, :data, :level, keyword_init: true)
+
+  # Detected runtime / platform information.
+  EnvironmentInfo = Struct.new(
+    :framework, :framework_version, :runtime, :runtime_version,
+    :platform, :os, :browser, :browser_version, :device_type,
+    :locale, :timezone, :url, :deploy,
+    keyword_init: true
+  )
+
+  # The canonical event payload sent to transports.
+  UncaughtEvent = Struct.new(
+    :event_id, :timestamp, :project_key, :level, :fingerprint,
+    :release, :error, :breadcrumbs, :request, :operation,
+    :environment, :user, :user_feedback, :fix_prompt, :sdk,
+    keyword_init: true
+  )
+
+  # An entry in the issues.json index file.
+  IssueEntry = Struct.new(
+    :fingerprint, :title, :error_type, :count, :affected_users,
+    :first_seen, :last_seen, :status, :fix_prompt_file,
+    :latest_event_file, :release, :environment,
+    keyword_init: true
+  )
+
+  # Configuration object.
+  Configuration = Struct.new(
+    :project_key, :endpoint, :environment, :release, :debug,
+    :enabled, :max_breadcrumbs, :max_events_per_minute,
+    :before_send, :sanitize_keys, :ignore_errors,
+    :transport, :local_output_dir, :webhook_url,
+    :framework, :framework_version,
+    keyword_init: true
+  ) do
+    def initialize(**kwargs)
+      super(
+        enabled: true,
+        debug: false,
+        max_breadcrumbs: 20,
+        max_events_per_minute: 30,
+        transport: "local",
+        sanitize_keys: [],
+        ignore_errors: [],
+        **kwargs
+      )
+    end
+  end
+end

data/lib/uncaught/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Uncaught
+  VERSION = "0.1.0"
+end

data/lib/uncaught.rb

@@ -0,0 +1,122 @@
+# frozen_string_literal: true
+
+require "set"
+require "json"
+require "time"
+
+require_relative "uncaught/version"
+require_relative "uncaught/types"
+require_relative "uncaught/fingerprint"
+require_relative "uncaught/breadcrumbs"
+require_relative "uncaught/rate_limiter"
+require_relative "uncaught/sanitizer"
+require_relative "uncaught/env_detector"
+require_relative "uncaught/prompt_builder"
+require_relative "uncaught/transport"
+require_relative "uncaught/client"
+
+module Uncaught
+  class Error < StandardError; end
+
+  # Module-level singleton client.
+  @client = nil
+  @config = nil
+  @mutex = Mutex.new
+
+  class << self
+    # Configure the Uncaught SDK.
+    #
+    # @yield [Configuration] Yields the configuration object for modification.
+    # @return [Client] The configured client instance.
+    #
+    # @example
+    #   Uncaught.configure do |config|
+    #     config.project_key = "my-project"
+    #     config.environment = "production"
+    #     config.release = "1.0.0"
+    #   end
+    def configure
+      @mutex.synchronize do
+        @config ||= Configuration.new
+        yield @config if block_given?
+        @client = Client.new(@config)
+      end
+      @client
+    end
+
+    # Return the current singleton client, or nil if not configured.
+    #
+    # @return [Client, nil]
+    def client
+      @client
+    end
+
+    # Return the current configuration, or nil if not configured.
+    #
+    # @return [Configuration, nil]
+    def configuration
+      @config
+    end
+
+    # Convenience: capture an error on the singleton client.
+    #
+    # @param error [Exception, String, Hash]
+    # @param kwargs [Hash] Additional context (request:, operation:, level:, etc.)
+    # @return [String, nil] The event ID.
+    def capture_error(error, **kwargs)
+      return nil unless @client
+
+      @client.capture_error(error, **kwargs)
+    end
+
+    # Convenience: capture a message on the singleton client.
+    #
+    # @param message [String]
+    # @param level   [String]
+    # @return [String, nil]
+    def capture_message(message, level: "info")
+      return nil unless @client
+
+      @client.capture_message(message, level: level)
+    end
+
+    # Convenience: add a breadcrumb on the singleton client.
+    def add_breadcrumb(**kwargs)
+      return unless @client
+
+      @client.add_breadcrumb(**kwargs)
+    end
+
+    # Convenience: set user on the singleton client.
+    def set_user(user)
+      return unless @client
+
+      @client.set_user(user)
+    end
+
+    # Convenience: flush on the singleton client.
+    def flush
+      return unless @client
+
+      @client.flush
+    end
+
+    # Install global exception handler for at_exit.
+    #
+    # @example
+    #   Uncaught.install_at_exit_handler!
+    def install_at_exit_handler!
+      at_exit do
+        if $! && !$!.is_a?(SystemExit)
+          Uncaught.capture_error($!)
+          Uncaught.flush
+        end
+      end
+    end
+  end
+end
+
+# Auto-load Rails integration if Rails is present.
+if defined?(::Rails::Railtie)
+  require_relative "uncaught/integrations/rails"
+end

metadata

@@ -0,0 +1,55 @@
+--- !ruby/object:Gem::Specification
+name: uncaught
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Uncaught Dev
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2026-03-08 00:00:00.000000000 Z
+dependencies: []
+description: Catch bugs locally, get AI-powered fixes. Works with Rails and Sinatra.
+email: 
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/uncaught.rb
+- lib/uncaught/breadcrumbs.rb
+- lib/uncaught/client.rb
+- lib/uncaught/env_detector.rb
+- lib/uncaught/fingerprint.rb
+- lib/uncaught/integrations/rails.rb
+- lib/uncaught/integrations/sinatra.rb
+- lib/uncaught/prompt_builder.rb
+- lib/uncaught/rate_limiter.rb
+- lib/uncaught/sanitizer.rb
+- lib/uncaught/transport.rb
+- lib/uncaught/types.rb
+- lib/uncaught/version.rb
+homepage: https://github.com/ajeeshworkspace/uncaught
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.7.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.0.3.1
+signing_key: 
+specification_version: 4
+summary: Local-first, AI-ready error monitoring for Ruby
+test_files: []