protocol-jsonrpc 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 0605256ce9da467440c5c83f3d871eef77a465a33553f9f3fbb7d5f4f4edbcd2
+  data.tar.gz: baa116715ac8ad29ad29f5cf188dcba524e6bcfbce4f88ecfd69288736bac692
+SHA512:
+  metadata.gz: 8843f873055775f88cd4d5780d21ae605c3ebd688c94f700388be5edddbf3e795ceb15ba69557ddafe7a08224b7f95d52a3c1a68357fd1ea427af54a2cf64868
+  data.tar.gz: 7b8cd982a41aa44003629fdea9dc16d6ce447eb1cdaf3c25e26600e61dee5674490eed22f5b3183b71fcd48375270447ae4f8f29b21b8986889633840628bb3e

data/CHANGELOG.md

@@ -0,0 +1,5 @@
+## [Unreleased]
+
+## [0.1.0] - 2025-04-20
+
+- Initial release

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2025 Martin Emde
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,276 @@
+# Protocol::Jsonrpc
+
+A Ruby library for implementing JSON-RPC 2.0 protocol clients and servers.
+
+Design influenced by [protocol-websocket](https://github.com/socketry/protocol-websocket) by Samuel Williams ([@ioquatix](https://github.com/ioquatix)).
+Thanks Samuel!
+
+## Installation
+
+Add the gem to your project:
+
+```bash
+bundle add protocol-jsonrpc
+```
+
+If bundler is not being used to manage dependencies, install the gem by executing:
+
+```bash
+gem install protocol-jsonrpc
+```
+
+## Core Concepts
+
+Protocol::Jsonrpc has several core concepts:
+
+- A `Protocol::Jsonrpc::Message` is the base class which represents JSON-RPC message structures
+- A `Protocol::Jsonrpc::Framer` wraps an underlying stream (like a socket) for reading and writing JSON-RPC messages
+- A `Protocol::Jsonrpc::Connection` wraps a framer and provides higher-level methods for communication
+- Various message types including `RequestMessage`, `ResponseMessage`, `NotificationMessage`, and `ErrorMessage`
+
+## Basic Usage
+
+### Simple Example
+
+Here's a basic example showing how to create a JSON-RPC connection over a socket pair:
+
+```ruby
+require 'protocol/jsonrpc'
+require 'protocol/jsonrpc/connection'
+require 'socket'
+
+# Create a socket pair for testing
+client_socket, server_socket = UNIXSocket.pair
+
+# Create connections for both client and server
+client = Protocol::Jsonrpc::Connection.new(Protocol::Jsonrpc::Framer.new(client_socket))
+server = Protocol::Jsonrpc::Connection.new(Protocol::Jsonrpc::Framer.new(server_socket))
+
+# Client sends a request
+subtract = Protocol::Jsonrpc::RequestMessage.new(method: "subtract", params: [42, 23])
+client.write(subtract)
+
+# Server reads the request
+message = server.read
+# => <#Protocol::Jsonrpc::RequestMessage id:"...", method: "subtract", params: [42, 23]>
+
+# Server processes the request (calculating the result)
+result = message.params.inject(:-) if message.method == "subtract"
+
+# Server sends a response
+server.write(message.reply(result))
+
+# Client reads the response
+response = client.read
+response.result # => 19
+
+# Close connections
+client.close
+server.close
+```
+
+### Realistic Server Implementation
+
+For a more realistic server implementation:
+
+```ruby
+require 'protocol/jsonrpc'
+require 'protocol/jsonrpc/connection'
+require 'socket'
+
+server = TCPServer.new('localhost', 4567)
+socket = server.accept
+connection = Protocol::Jsonrpc::Connection.new(Protocol::Jsonrpc::Framer.new(socket))
+
+# Simple dispatcher for handling different methods
+handlers = {
+  "add" => ->(params) { params.sum },
+  "subtract" => ->(params) { params.reduce(:-) },
+  "multiply" => ->(params) { params.reduce(:*) },
+  "divide" => ->(params) { params.reduce(:/) }
+}
+
+# Track pending requests awaiting responses
+pending_requests = {}
+
+# Main server loop
+begin
+  while (message = connection.read)
+    case message
+    when Protocol::Jsonrpc::RequestMessage
+      puts "Received request: #{message.method}"
+
+      if handlers.key?(message.method)
+        result = handlers[message.method].call(message.params)
+        connection.write(message.reply(result))
+      else
+        error = Protocol::Jsonrpc::MethodNotFoundError.new
+        connection.write(message.reply(error))
+      end
+
+    when Protocol::Jsonrpc::NotificationMessage
+      puts "Notification: #{message.method}"
+      # Handle notification (no response needed)
+
+    when Protocol::Jsonrpc::ResponseMessage
+      puts "Response: #{message.result}"
+      # Process response for an earlier request
+      request = pending_requests.delete(message.id)
+      request.call(message) if request
+
+    when Protocol::Jsonrpc::ErrorMessage
+      puts "Error: #{message.error.message}"
+      request = pending_requests.delete(message.id)
+      request.call(message) if request
+    end
+  end
+rescue Errno::EPIPE, IOError => e
+  puts "Connection closed: #{e.message}"
+ensure
+  connection.close
+  socket.close
+  server.close
+end
+```
+
+## Message Types
+
+### Request Message
+
+```ruby
+# Create a request with positional parameters
+request = Protocol::Jsonrpc::RequestMessage.new(
+  method: "subtract",
+  params: [42, 23],
+  id: 1  # Optional, auto-generated if not provided
+)
+
+# Create a request with named parameters
+request = Protocol::Jsonrpc::RequestMessage.new(
+  method: "subtract",
+  params: { minuend: 42, subtrahend: 23 },
+  id: 2
+)
+```
+
+### Notification Message
+
+Notifications are similar to requests but don't expect a response:
+
+```ruby
+notification = Protocol::Jsonrpc::NotificationMessage.new(
+  method: "update",
+  params: [1, 2, 3, 4, 5]
+)
+```
+
+### Response Message
+
+Typically created by replying to a request:
+
+```ruby
+# From a request object
+response = request.reply(19)
+
+# Or directly
+response = Protocol::Jsonrpc::ResponseMessage.new(
+  result: 19,
+  id: 1
+)
+```
+
+### Error Message
+
+For error responses:
+
+```ruby
+# Create from an error object
+error = Protocol::Jsonrpc::InvalidParamsError.new("Invalid parameters")
+error_response = request.reply(error)
+
+# Standard error types include:
+# - ParseError
+# - InvalidRequestError
+# - MethodNotFoundError
+# - InvalidParamsError
+# - InternalError
+# - ServerError
+```
+
+## Batch Processing
+
+JSON-RPC supports batch requests and responses:
+
+```ruby
+batch = [
+  Protocol::Jsonrpc::RequestMessage.new(method: "sum", params: [1, 2, 4]),
+  Protocol::Jsonrpc::NotificationMessage.new(method: "notify_hello", params: [7]),
+  Protocol::Jsonrpc::RequestMessage.new(method: "subtract", params: [42, 23])
+]
+
+# Send batch request
+client.write(batch)
+
+# Process batch on server
+messages = server.read
+
+batch_response = messages.filter_map do |msg|
+  case msg
+  when Protocol::Jsonrpc::RequestMessage
+    # Only add responses for requests, not notifications
+    if msg.method == "sum"
+      msg.reply(msg.params.sum)
+    elsif msg.method == "subtract"
+      msg.reply(msg.params.reduce(:-))
+    else
+      msg.reply(Protocol::Jsonrpc::MethodNotFoundError.new)
+    end
+  when Protocol::Jsonrpc::NotificationMessage
+    handle_notification(msg)
+    nil
+  end
+end
+
+# Send batch response if not empty
+server.write(batch_response) unless batch_response.empty?
+```
+
+## Custom Framers
+
+The supplied Framer is designed for a bidirectional socket.
+You can also supply your own framer:
+
+```ruby
+class MyFramer
+  def flush; end
+  def close; end
+
+  # Return an object that response to unpack
+  def read_frame
+  end
+
+  # Accepts a
+  def write_frame(frame)
+  end
+end
+
+
+client = Protocol::Jsonrpc::Connection.new(MyFramer.new)
+client.read # calls read_frame, calling unpack on the returned object
+
+message = Protocol::Jsonrpc::NotificationMessage.new(method: "hello", params: ["world"])
+client.write(message) # calls write_frame with any message responding to `as_json`
+
+```
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/martinemde/protocol-jsonrpc.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/lib/protocol/jsonrpc/connection.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright 2025 by Martin Emde
+
+require_relative "message"
+
+module Protocol
+  module Jsonrpc
+    class Connection
+      # Initialize a new Connection instance
+      # @param framer [Protocol::Jsonrpc::Framer] Any class implementing the Framer interface
+      def initialize(framer)
+        @framer = framer
+      end
+
+      def flush
+        @framer.flush
+      end
+
+      def close
+        @framer.close
+      end
+
+      # Read a message from the framer
+      # @yield [Protocol::Jsonrpc::Message] The read message
+      # @return [Protocol::Jsonrpc::Message] The read message
+      def read(&block)
+        flush
+        frame = read_frame
+        message = Message.load(frame.unpack)
+        yield message if block_given?
+        message
+      end
+
+      # Write a message to the framer
+      # @param message [Protocol::Jsonrpc::Message, Array<Protocol::Jsonrpc::Message>] The message(s) to write
+      # @return [Boolean] True if successful
+      def write(message)
+        frame = Frame.pack(message)
+        write_frame(frame)
+        true
+      end
+
+      # Low level read a frame from the framer
+      # @yield [Protocol::Jsonrpc::Frame] The read frame
+      # @return [Protocol::Jsonrpc::Frame] The read frame
+      def read_frame(&)
+        frame = @framer.read_frame
+        yield frame if block_given?
+        frame
+      end
+
+      # Low level write a frame to the framer
+      # @param frame [Protocol::Jsonrpc::Frame] The frame to write
+      # @return [Boolean] True if successful
+      def write_frame(frame)
+        @framer.write_frame(frame)
+      end
+    end
+  end
+end

data/lib/protocol/jsonrpc/error.rb

@@ -0,0 +1,136 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright 2025 by Martin Emde
+
+require "securerandom"
+require "json"
+
+module Protocol
+  module Jsonrpc
+    class Error < StandardError
+      PARSE_ERROR = -32_700
+      INVALID_REQUEST = -32_600
+      METHOD_NOT_FOUND = -32_601
+      INVALID_PARAMS = -32_602
+      INTERNAL_ERROR = -32_603
+
+      MESSAGES = Hash.new("Error").merge(
+        PARSE_ERROR => "Parse error",
+        INVALID_REQUEST => "Invalid Request",
+        METHOD_NOT_FOUND => "Method not found",
+        INVALID_PARAMS => "Invalid params",
+        INTERNAL_ERROR => "Internal error"
+      ).freeze
+
+      # Factory method to create the appropriate error type
+      # @param id [String, Integer] The request ID
+      # @param error [Hash] The error data from the JSON-RPC response
+      # @return [Error] The appropriate error instance
+      def self.from_message(code:, message:, data: nil, id: nil)
+        case code
+        when PARSE_ERROR
+          ParseError.new(message, data:, id:)
+        when INVALID_REQUEST
+          InvalidRequestError.new(message, data:, id:)
+        when METHOD_NOT_FOUND
+          MethodNotFoundError.new(message, data:, id:)
+        when INVALID_PARAMS
+          InvalidParamsError.new(message, data:, id:)
+        when INTERNAL_ERROR
+          InternalError.new(message, data:, id:)
+        else
+          new(message, data:, id:)
+        end
+      end
+
+      def self.wrap(error)
+        case error
+        in Hash
+          error = error.transform_keys(&:to_sym)
+          from_message(**error)
+        in Jsonrpc::Error
+          error
+        in JSON::ParserError
+          ParseError.new(error.message, data: error)
+        in StandardError
+          InternalError.new(error.message, data: error)
+        else
+          raise error
+        end
+      end
+
+      attr_reader :data, :code, :id
+
+      def initialize(message = nil, data: nil, id: nil)
+        message = nil if message&.empty?
+        super([MESSAGES[code], message].compact.uniq.join(": "))
+        @data = data
+        @id = id
+      end
+
+      def reply(id: @id)
+        ErrorMessage.new(id:, error: self)
+      end
+
+      def to_h
+        h = {code:, message:}
+        h[:data] = data if data
+        h
+      end
+
+      def [](key)
+        case key
+        when :code
+          code
+        when :message
+          message
+        when :data
+          data
+        else
+          raise KeyError, "Invalid key: #{key}"
+        end
+      end
+    end
+
+    # Error raised when a JSON-RPC parse error is received from the server
+    # Raised when error code is -32700
+    class ParseError < Error
+      def code
+        PARSE_ERROR
+      end
+    end
+
+    # Error raised when a JSON-RPC invalid request error is received from the server
+    # Raised when error code is -32600
+    class InvalidRequestError < Error
+      def code
+        INVALID_REQUEST
+      end
+    end
+
+    # Error raised when a JSON-RPC method not found error is received from the server
+    # Raised when error code is -32601
+    class MethodNotFoundError < Error
+      def code
+        METHOD_NOT_FOUND
+      end
+    end
+
+    # Error raised when a JSON-RPC invalid params error is received from the server
+    # Raised when error code is -32602
+    class InvalidParamsError < Error
+      def code
+        INVALID_PARAMS
+      end
+    end
+
+    # Error raised when a JSON-RPC internal error is received from the server
+    # Raised when error code is -32603
+    class InternalError < Error
+      def code
+        INTERNAL_ERROR
+      end
+    end
+  end
+end

data/lib/protocol/jsonrpc/error_message.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright 2025 by Martin Emde
+
+require_relative "message"
+
+module Protocol
+  module Jsonrpc
+    ErrorMessage = Data.define(:id, :error) do
+      include Message
+
+      def initialize(id:, error:)
+        unless id.nil? || id.is_a?(String) || id.is_a?(Numeric)
+          raise InvalidRequestError.new("ID must be nil, string or number", id: id)
+        end
+
+        error = Error.wrap(error)
+
+        super
+      end
+
+      def to_h = super.merge(id:, error: error.to_h)
+
+      def response? = true
+    end
+  end
+end

data/lib/protocol/jsonrpc/frame.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright 2025 by Martin Emde
+
+require "json"
+require_relative "error"
+
+module Protocol
+  module Jsonrpc
+    # Frame represents the raw JSON data structure of a JSON-RPC message
+    # before it's validated and converted into a proper Message object.
+    # This handles the parsing of JSON and initial structure validation.
+    Frame = Data.define(:json) do
+      # Read a frame from the stream
+      # @param stream [IO] The stream to read from
+      # @return [Frame, nil] The parsed frame or nil if the stream is empty
+      def self.read(stream)
+        json = stream.gets
+        return nil if json.nil?
+        new(json:)
+      end
+
+      # Unpack the json into a JSON object
+      # @return [Hash] The parsed JSON object
+      def unpack
+        JSON.parse(json, symbolize_names: true)
+      rescue JSON::ParserError => e
+        raise ParseError.new("Failed to parse message: #{e.message}", data: json)
+      end
+
+      def self.pack(message)
+        case message
+        when Array
+          new(json: message.map { |msg| msg.is_a?(Message) ? msg.as_json : msg }.to_json)
+        when Hash, Message
+          new(json: message.to_json)
+        else
+          raise ArgumentError, "Invalid message type: #{message.class}"
+        end
+      end
+
+      def write(stream)
+        stream.write("#{json}\n")
+      end
+    end
+  end
+end

data/lib/protocol/jsonrpc/framer.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright 2025 by Martin Emde
+
+require "protocol/jsonrpc/frame"
+
+module Protocol
+  module Jsonrpc
+    class Framer
+      def initialize(stream, frame_class: Frame)
+        @stream = stream
+        @frame_class = frame_class
+      end
+
+      # Read a frame from the stream
+      # @return [Frame] The parsed frame
+      def read_frame(&block)
+        frame = @frame_class.read(@stream)
+        yield frame if block_given?
+        frame
+      end
+
+      # Write a frame to the stream
+      # @param frame [Frame] The frame to write
+      def write_frame(frame)
+        frame.write(@stream)
+      end
+
+      # Flush the stream
+      def flush
+        @stream.flush
+      end
+
+      # Close the stream
+      def close
+        @stream.close
+      end
+    end
+  end
+end

data/lib/protocol/jsonrpc/message.rb

@@ -0,0 +1,104 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright 2025 by Martin Emde
+
+require "json"
+require "securerandom"
+require "timeout"
+require_relative "error"
+
+module Protocol
+  module Jsonrpc
+    # JsonrpcMessage provides stateless operations for creating and validating JSON-RPC messages.
+    # This class handles the pure functional aspects of JSON-RPC like:
+    # - Creating properly formatted request/notification messages
+    # - Validating incoming messages
+    # - Parsing responses and errors
+    module Message
+      JSONRPC_VERSION = "2.0"
+
+      class << self
+        # Validate, and return the JSON-RPC message or batch
+        # @param data [Hash, Array] The parsed message
+        # @return [Message, Array<Message>] The parsed message or batch
+        # @raise [ParseError] If the message cannot be parsed
+        # @raise [InvalidRequestError] If the message is invalid
+        def load(data)
+          case data
+          when Hash
+            from_hash(data)
+          when Array
+            from_array(data)
+          else
+            raise InvalidRequestError.new("Invalid request object", data: data.inspect)
+          end
+        end
+
+        # This is wrong. It seems like we need something more like
+        # an enumerator where we can run the full parse, handle, response
+        # cycle for each item in the array, aggregating the results and
+        # errors and then returning the array.
+        #
+        # The problem is that the errors should get raised and then
+        # handled which turns them into ErrorMessages and then the errors
+        # get returned to the client.
+        #
+        # Ideally this array handling would be invisible to the connection
+        # which would just handle one at a time with the array wrapper
+        # being applied by a single place that handles the batching.
+        def from_array(array)
+          raise InvalidRequestError.new("Empty batch", data: array.inspect) if array.empty?
+
+          array.map do |msg|
+            from_hash(msg)
+          rescue => e
+            Error.wrap(e)
+          end
+        end
+
+        # @param parsed [Hash] The parsed message
+        # @return [Message] The parsed message
+        def from_hash(parsed)
+          raise InvalidRequestError.new("Request is not an object", data: parsed) unless parsed.is_a?(Hash)
+          raise InvalidRequestError.new("Unexpected JSON-RPC version", data: parsed) unless parsed[:jsonrpc] == JSONRPC_VERSION
+
+          case parsed
+          in { id:, error: }
+            ErrorMessage.new(id:, error: Error.from_message(**error))
+          in { id:, result: }
+            ResponseMessage.new(id:, result:)
+          in { id:, method: }
+            RequestMessage.new(id:, method:, params: parsed[:params])
+          in { method: }
+            NotificationMessage.new(method:, params: parsed[:params])
+          else
+            raise ParseError.new("Unknown message: #{parsed.inspect}", data: parsed)
+          end
+        end
+      end
+
+      def to_h = {jsonrpc: JSONRPC_VERSION}
+
+      def to_hash = to_h
+
+      def as_json = to_h
+
+      def to_json(...) = JSON.generate(as_json, ...)
+
+      def to_s = to_json
+
+      def response? = false
+
+      def match?(message) = false
+
+      def reply(result_or_error)
+        if result_or_error.is_a?(StandardError)
+          ErrorMessage.new(id:, error: result_or_error)
+        else
+          ResponseMessage.new(id:, result: result_or_error)
+        end
+      end
+    end
+  end
+end

data/lib/protocol/jsonrpc/notification_message.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright 2025 by Martin Emde
+
+require_relative "message"
+
+module Protocol
+  module Jsonrpc
+    NotificationMessage = Data.define(:method, :params) do
+      include Message
+
+      def initialize(method:, params: nil)
+        super
+
+        unless method.is_a?(String)
+          raise InvalidRequestError.new("Method must be a string", data: method.inspect)
+        end
+        unless params.nil? || params.is_a?(Array) || params.is_a?(Hash)
+          raise InvalidRequestError.new("Params must be an array or object", data: params.inspect)
+        end
+      end
+
+      def to_h
+        h = super.merge(method:)
+        h[:params] = params if params
+        h
+      end
+
+      def id = nil
+
+      def reply = nil
+
+      def response? = false
+    end
+  end
+end

data/lib/protocol/jsonrpc/request_message.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright 2025 by Martin Emde
+
+require "securerandom"
+require_relative "message"
+
+module Protocol
+  module Jsonrpc
+    RequestMessage = Data.define(:method, :params, :id) do
+      include Message
+
+      def initialize(method:, params: nil, id: SecureRandom.uuid)
+        unless method.is_a?(String)
+          raise InvalidRequestError.new("Method must be a string", data: method.inspect)
+        end
+        unless params.nil? || params.is_a?(Array) || params.is_a?(Hash)
+          raise InvalidRequestError.new("Params must be an array or object", data: params.inspect)
+        end
+        unless id.is_a?(String) || id.is_a?(Numeric)
+          raise InvalidRequestError.new("ID must be a string or number", id:)
+        end
+
+        super
+      end
+
+      def to_h
+        h = super.merge(id:, method:)
+        h[:params] = params if params
+        h
+      end
+
+      def response? = false
+    end
+  end
+end

data/lib/protocol/jsonrpc/response_message.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright 2025 by Martin Emde
+
+require_relative "message"
+
+module Protocol
+  module Jsonrpc
+    ResponseMessage = Data.define(:id, :result) do
+      include Message
+
+      def initialize(id:, result:)
+        unless id.nil? || id.is_a?(String) || id.is_a?(Numeric)
+          raise InvalidRequestError.new("ID must be nil, string or number", id:)
+        end
+
+        super
+      end
+
+      def to_h = super.merge(id:, result:)
+
+      def response? = true
+    end
+  end
+end

data/lib/protocol/jsonrpc/version.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright 2025 by Martin Emde
+
+module Protocol
+  module Jsonrpc
+    VERSION = "0.1.0"
+  end
+end

data/lib/protocol/jsonrpc.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright 2025 by Martin Emde
+
+require_relative "jsonrpc/version"
+require_relative "jsonrpc/error"
+require_relative "jsonrpc/message"
+require_relative "jsonrpc/connection"
+require_relative "jsonrpc/error_message"
+require_relative "jsonrpc/notification_message"
+require_relative "jsonrpc/request_message"
+require_relative "jsonrpc/response_message"
+
+module Protocol
+  module Jsonrpc
+  end
+end

data/sig/protocol/jsonrpc.rbs

@@ -0,0 +1,6 @@
+module Protocol
+  module Jsonrpc
+    VERSION: String
+    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+  end
+end

metadata

@@ -0,0 +1,73 @@
+--- !ruby/object:Gem::Specification
+name: protocol-jsonrpc
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Martin Emde
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.10'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.10'
+description: JSON-RPC 2.0 protocol implementation
+email:
+- me@martinemde.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE.txt
+- README.md
+- lib/protocol/jsonrpc.rb
+- lib/protocol/jsonrpc/connection.rb
+- lib/protocol/jsonrpc/error.rb
+- lib/protocol/jsonrpc/error_message.rb
+- lib/protocol/jsonrpc/frame.rb
+- lib/protocol/jsonrpc/framer.rb
+- lib/protocol/jsonrpc/message.rb
+- lib/protocol/jsonrpc/notification_message.rb
+- lib/protocol/jsonrpc/request_message.rb
+- lib/protocol/jsonrpc/response_message.rb
+- lib/protocol/jsonrpc/version.rb
+- sig/protocol/jsonrpc.rbs
+homepage: https://github.com/martinemde/protocol-jsonrpc
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/martinemde/protocol-jsonrpc
+  source_code_uri: https://github.com/martinemde/protocol-jsonrpc
+  changelog_uri: https://github.com/martinemde/protocol-jsonrpc/blob/main/CHANGELOG.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.1.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.7
+specification_version: 4
+summary: JSON-RPC 2.0 protocol implementation
+test_files: []