jsonrpc-rails 0.5.3 → 0.5.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 16369528b9adcf6bc2b66b42365e475be375d330312694626d8244f2205e9df3
-  data.tar.gz: 4eeda34cff81e732d5aac37d684c81eba9c7a66de1729a7f1f2c1c8097de21fb
+  metadata.gz: 3c170f3b4c1b8b5d8903fc6202f317d98340c0939dae84117c062009f4128de3
+  data.tar.gz: 047dfecbe033df5e49a41a03d4c471452953358cb41bc95c0e2add3b9666ff81
 SHA512:
-  metadata.gz: ebefd2f90219d0dd655a9e7fc21023aa38b26de412e52102bdb6d2014a75f1975c284a417d2f353989e09360c34b56c07e42af89643e99bb3fe990db886a1039
-  data.tar.gz: 2c447976bc3b1dc7a8e9c2ffc695278bd7ec0e44bbad864f5810c16adefb901ec1212145a8d56865e4f7a59eba36b760db71e69addac2b70422f2b8276b53a7f
+  metadata.gz: 2346088ba624f426d7f26df3f1d3d46faec883d2b45ef929ccd53e4bb1085132e8c0d2491b0f322ade4592ef0ffc182b0e39f15c795a490c7f0e4d2a2a646de1
+  data.tar.gz: c76d9df6e6b1e5c7eab1498ac9cf4a544f00c796cab13ae487ff302ac77a500ed488bd920ce9f010391de96430ee888fa68d3388f898646ebd82045e9d919dfd

data/README.md

@@ -184,6 +184,58 @@ class MyApiController < ApplicationController
 end
 ```
 
+## Error Codes
+
+The gem implements the complete JSON-RPC 2.0 error specification. All error codes are defined in `lib/json_rpc/json_rpc_error.rb` and can be used either as numeric codes or symbols:
+
+| Code | Symbol | Name | Description |
+|------|--------|------|-------------|
+| -32700 | `:parse_error` | Parse Error | Invalid JSON was received by the server |
+| -32600 | `:invalid_request` | Invalid Request | The JSON sent is not a valid Request object |
+| -32601 | `:method_not_found` | Method Not Found | The method does not exist / is not available |
+| -32602 | `:invalid_params` | Invalid Params | Invalid method parameter(s) |
+| -32603 | `:internal_error` | Internal Error | Internal JSON-RPC error |
+| -32000 | `:server_error` | Server Error | Implementation-defined server error |
+
+### Usage Examples
+
+```ruby
+# Using numeric codes
+render jsonrpc: {}, error: -32601, id: 1
+
+# Using symbols
+render jsonrpc: {}, error: :method_not_found, id: 1
+
+# Creating error objects
+error = JSON_RPC::JsonRpcError.build(:invalid_params)
+render jsonrpc: JSON_RPC::Response.new(id: 1, error: error)
+```
+
+## JSONRPC Namespace
+
+The gem uses two main namespaces to separate core JSON-RPC functionality from Rails integration:
+
+### JSON_RPC Module (Core Specification)
+
+Contains the core JSON-RPC 2.0 specification objects:
+
+- **`JSON_RPC::Request`** - Represents a JSON-RPC request with method, params, and id
+- **`JSON_RPC::Response`** - Represents a JSON-RPC response with result or error
+- **`JSON_RPC::Notification`** - Represents a JSON-RPC notification (request without id)
+- **`JSON_RPC::JsonRpcError`** - Exception class for JSON-RPC errors with standard error codes
+- **`JSON_RPC::Parser`** - Utility for converting hashes to typed JSON-RPC objects
+
+### JSONRPC_Rails Module (Rails Integration)
+
+Contains Rails-specific integration components:
+
+- **`JSONRPC_Rails::Railtie`** - Rails initialization, middleware setup, and renderer registration
+- **`JSONRPC_Rails::Middleware::Validator`** - Rack middleware for validating JSON-RPC requests
+- **`JSONRPC_Rails::ControllerHelpers`** - Helper methods like `jsonrpc_params` and `jsonrpc_params_batch?`
+- **`JSONRPC_Rails::VERSION`** - Current gem version
+
+This separation ensures clean architecture where core JSON-RPC logic is independent of Rails, while Rails-specific features are properly isolated.
+
 ## Testing
 
 A dummy Rails application is included within the gem (located in `test/dummy`) to facilitate testing. You can run the tests from the **project root directory** by executing:

data/lib/jsonrpc_rails/middleware/validator.rb

@@ -2,6 +2,7 @@
 
 require "json"
 require "active_support/json"
+require "stringio"
 
 module JSONRPC_Rails
   module Middleware
@@ -31,7 +32,9 @@ module JSONRPC_Rails
                                      env["CONTENT_TYPE"]&.start_with?(CONTENT_TYPE)
 
         body = env["rack.input"].read
-        env["rack.input"].rewind
+        # Replace consumed input with fresh StringIO for downstream middleware
+        # This is Rack 3.0+ compatible and works with all input stream types
+        env["rack.input"] = StringIO.new(body)
 
         raw_payload = parse_json(body)
 
@@ -129,7 +132,7 @@ module JSONRPC_Rails
         error_obj = JSON_RPC::JsonRpcError.build(error_sym)
         payload   = JSON_RPC::Response.new(id: id, error: error_obj).to_json
 
-        [ status, { "Content-Type" => CONTENT_TYPE }, [ payload ] ]
+        [ status, { "content-type" => CONTENT_TYPE }, [ payload ] ]
       end
 
       # Extract ID from raw payload if possible

data/lib/jsonrpc_rails/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module JSONRPC_Rails
-  VERSION = "0.5.3"
+  VERSION = "0.5.4"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: jsonrpc-rails
 version: !ruby/object:Gem::Version
-  version: 0.5.3
+  version: 0.5.4
 platform: ruby
 authors:
 - Abdelkader Boudih