Add @api public tags to JSONRPC classes and errors

Enabled YARD lint enforcement for @api tags and added @api public annotations to all major JSONRPC classes, helpers, and error types. This clarifies public API surfaces for documentation and tooling.

Author: wilsonsilva

.yard-lint.yml

@@ -151,7 +151,7 @@ Tags/TagTypePosition:
 
 Tags/ApiTags:
   Description: 'Enforces @api tags on public objects.'
-  Enabled: false  # Opt-in validator
+  Enabled: true  # Opt-in validator
   Severity: error
   AllowedApis:
     - public

lib/jsonrpc/batch_request.rb

@@ -6,6 +6,8 @@ module JSONRPC
   # A batch request is an Array filled with Request objects to send several requests at once.
   # The Server should respond with an Array containing the corresponding Response objects.
   #
+  # @api public
+  #
   # @example Create a batch request with multiple requests
   #   batch = JSONRPC::BatchRequest.new([
   #     JSONRPC::Request.new(method: "sum", params: [1, 2, 4], id: "1"),

lib/jsonrpc/batch_response.rb

@@ -7,6 +7,8 @@ module JSONRPC
   # a Batch Request. The Server should respond with one Response for each Request
   # (except for Notifications which don't receive responses).
   #
+  # @api public
+  #
   # @example Create a batch response
   #   batch = JSONRPC::BatchResponse.new([
   #     JSONRPC::Response.new(result: 7, id: "1"),

lib/jsonrpc/errors/internal_error.rb

@@ -5,6 +5,8 @@ module JSONRPC
   #
   # Raised when there was an internal JSON-RPC error.
   #
+  # @api public
+  #
   # @example Create an internal error
   #   error = JSONRPC::Errors::InternalError.new(data: { details: 'Unexpected server error' })
   #

lib/jsonrpc/errors/invalid_params_error.rb

@@ -5,6 +5,8 @@ module JSONRPC
   #
   # Raised when invalid method parameter(s) were provided.
   #
+  # @api public
+  #
   # @example Create an invalid params error
   #   error = JSONRPC::InvalidParamsError.new(data: { details: "Expected array of integers" })
   #

lib/jsonrpc/errors/invalid_request_error.rb

@@ -5,6 +5,8 @@ module JSONRPC
   #
   # Raised when the JSON sent is not a valid Request object.
   #
+  # @api public
+  #
   # @example Create an invalid request error
   #   error = JSONRPC::InvalidRequestError.new(data: { details: "Method must be a string" })
   #

lib/jsonrpc/errors/method_not_found_error.rb

@@ -5,6 +5,8 @@ module JSONRPC
   #
   # Raised when the method does not exist / is not available.
   #
+  # @api public
+  #
   # @example Create a method not found error
   #   error = JSONRPC::MethodNotFound.new(data: { requested_method: "unknown_method" })
   #

lib/jsonrpc/errors/parse_error.rb

@@ -6,6 +6,8 @@ module JSONRPC
   # Raised when invalid JSON was received by the server.
   # An error occurred on the server while parsing the JSON text.
   #
+  # @api public
+  #
   # @example Create a parse error
   #   error = JSONRPC::ParseError.new(data: { details: "Unexpected end of input" })
   #

lib/jsonrpc/helpers.rb

@@ -2,6 +2,9 @@
 
 module JSONRPC
   # Framework-agnostic helpers for JSON-RPC
+  #
+  # @api public
+  #
   module Helpers
     # Extends the including class with ClassMethods when module is included
     #
@@ -21,6 +24,9 @@ def self.included(base)
     end
 
     # Class methods for registering JSON-RPC procedure handlers
+    #
+    # @api public
+    #
     module ClassMethods
       # Registers a JSON-RPC procedure with the given method name
       #

lib/jsonrpc/parser.rb

@@ -6,6 +6,8 @@ module JSONRPC
   # The Parser handles converting raw JSON strings into appropriate JSONRPC objects
   # based on the JSON-RPC 2.0 protocol specification.
   #
+  # @api public
+  #
   # @example Parse a request
   #   parser = JSONRPC::Parser.new
   #   request = parser.parse('{"jsonrpc":"2.0","method":"subtract","params":[42,23],"id":1}')