From 04789f83693edd897bf49116c7dc26ec4e82f968 Mon Sep 17 00:00:00 2001
From: Justin Gordon <justin@shakacode.com>
Date: Wed, 12 Nov 2025 11:40:31 -1000
Subject: [PATCH] Add RBS type signatures for error classes
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

This commit adds RBS type signatures for all error-related classes to
complete type coverage for the gem.

Classes added:
- ReactOnRails::Error - Base error class
- ReactOnRails::JsonParseError - JSON parsing error with context
- ReactOnRails::PrerenderError - Server rendering error with detailed info
- ReactOnRails::SmartError - Enhanced error with actionable suggestions

These signatures provide type information for error handling, helping
developers catch type-related issues during development.

Fixes #1954

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
---
 sig/react_on_rails/error.rbs            |  4 ++++
 sig/react_on_rails/json_parse_error.rbs | 10 +++++++++
 sig/react_on_rails/prerender_error.rbs  | 21 +++++++++++++++++++
 sig/react_on_rails/smart_error.rbs      | 28 +++++++++++++++++++++++++
 4 files changed, 63 insertions(+)
 create mode 100644 sig/react_on_rails/error.rbs
 create mode 100644 sig/react_on_rails/json_parse_error.rbs
 create mode 100644 sig/react_on_rails/prerender_error.rbs
 create mode 100644 sig/react_on_rails/smart_error.rbs

diff --git a/sig/react_on_rails/error.rbs b/sig/react_on_rails/error.rbs
new file mode 100644
index 0000000000..3f70a35681
--- /dev/null
+++ b/sig/react_on_rails/error.rbs
@@ -0,0 +1,4 @@
+module ReactOnRails
+  class Error < StandardError
+  end
+end
diff --git a/sig/react_on_rails/json_parse_error.rbs b/sig/react_on_rails/json_parse_error.rbs
new file mode 100644
index 0000000000..bbfa87013c
--- /dev/null
+++ b/sig/react_on_rails/json_parse_error.rbs
@@ -0,0 +1,10 @@
+module ReactOnRails
+  class JsonParseError < ::ReactOnRails::Error
+    attr_reader json: String
+
+    def initialize: (parse_error: StandardError, json: String) -> void
+    def to_honeybadger_context: () -> Hash[Symbol, untyped]
+    def raven_context: () -> Hash[Symbol, untyped]
+    def to_error_context: () -> Hash[Symbol, untyped]
+  end
+end
diff --git a/sig/react_on_rails/prerender_error.rbs b/sig/react_on_rails/prerender_error.rbs
new file mode 100644
index 0000000000..b0e523add2
--- /dev/null
+++ b/sig/react_on_rails/prerender_error.rbs
@@ -0,0 +1,21 @@
+module ReactOnRails
+  class PrerenderError < ::ReactOnRails::Error
+    MAX_ERROR_SNIPPET_TO_LOG: Integer
+
+    attr_reader component_name: String?
+    attr_reader err: StandardError?
+    attr_reader props: String?
+    attr_reader js_code: String?
+    attr_reader console_messages: String?
+
+    def initialize: (?component_name: String?, ?err: StandardError?, ?props: String?, ?js_code: String?, ?console_messages: String?) -> void
+    def to_honeybadger_context: () -> Hash[Symbol, untyped]
+    def raven_context: () -> Hash[Symbol, untyped]
+    def to_error_context: () -> Hash[Symbol, untyped]
+
+    private
+
+    def calc_message: (String? component_name, String? console_messages, StandardError? err, String? js_code, String? props) -> [String?, String]
+    def build_troubleshooting_suggestions: (String? component_name, StandardError? err, String? console_messages) -> String
+  end
+end
diff --git a/sig/react_on_rails/smart_error.rbs b/sig/react_on_rails/smart_error.rbs
new file mode 100644
index 0000000000..32f2dce566
--- /dev/null
+++ b/sig/react_on_rails/smart_error.rbs
@@ -0,0 +1,28 @@
+module ReactOnRails
+  class SmartError < Error
+    attr_reader error_type: Symbol
+    attr_reader component_name: String?
+    attr_reader props: String?
+    attr_reader js_code: String?
+    attr_reader additional_context: Hash[Symbol, untyped]
+
+    def initialize: (error_type: Symbol, ?component_name: String?, ?props: String?, ?js_code: String?, **untyped additional_context) -> void
+    def solution: () -> String
+
+    private
+
+    def build_error_message: () -> String
+    def error_type_title: () -> String
+    def error_description: () -> String
+    def component_not_registered_solution: () -> String
+    def missing_auto_loaded_bundle_solution: () -> String
+    def hydration_mismatch_solution: () -> String
+    def server_rendering_error_solution: () -> String
+    def redux_store_not_found_solution: () -> String
+    def configuration_error_solution: () -> String
+    def default_solution: () -> String
+    def additional_info: () -> String
+    def troubleshooting_section: () -> String
+    def find_similar_components: (String name) -> Array[String]
+  end
+end