Clean up types.

Author: ioquatix

design.md

@@ -140,7 +140,7 @@ module Protocol
 
 			# Parse service and method from gRPC path
 			# @parameter path [String] e.g., "/my_service.Greeter/SayHello"
-			# @returns [Array(String, String)] [service, method]
+			# @returns [Tuple(String, String)] of service and method.
 			def self.parse_path(path)
 				parts = path.split("/")
 				[parts[1], parts[2]]
@@ -287,7 +287,7 @@ module Protocol
 
 			# Extract gRPC status message from headers
 			# @parameter headers [Protocol::HTTP::Headers]
-			# @returns [String, nil] Status message
+			# @returns [String | Nil] Status message
 			def self.extract_message(headers)
 				message = headers["grpc-message"]
 				message ? URI.decode_www_form_component(message) : nil
@@ -329,7 +329,7 @@ module Protocol
 				# @parameter body [Protocol::HTTP::Body::Readable] The underlying HTTP body
 				# @parameter message_class [Class, nil] Protobuf message class with .decode method
 				#   If nil, returns raw binary data (useful for channel adapters)
-				# @parameter encoding [String, nil] Compression encoding (from grpc-encoding header)
+				# @parameter encoding [String | Nil] Compression encoding (from grpc-encoding header)
 				def initialize(body, message_class: nil, encoding: nil)
 					super(body)
 					@message_class = message_class
@@ -408,7 +408,7 @@ module Protocol
 			# Writes length-prefixed gRPC messages
 			# This is the standard writable body for gRPC - all gRPC requests use message framing
 			class Writable < Protocol::HTTP::Body::Writable
-				# @parameter encoding [String, nil] Compression encoding (gzip, deflate, identity)
+				# @parameter encoding [String | Nil] Compression encoding (gzip, deflate, identity)
 				# @parameter level [Integer] Compression level if encoding is used
 				def initialize(encoding: nil, level: Zlib::DEFAULT_COMPRESSION, **options)
 					super(**options)
@@ -574,7 +574,7 @@ module Protocol
 			end
 
 			# Get peer information (client address)
-			# @returns [String, nil]
+			# @returns [String | Nil]
 			def peer
 				@request.peer&.to_s
 			end

lib/protocol/grpc/header/status.rb

@@ -18,7 +18,7 @@ def self.parse(value)
 
 				# Initialize the status header with the given value.
 				#
-				# @parameter value [String, Integer] The status code as a string or integer.
+				# @parameter value [String | Integer] The status code as a string or integer.
 				def initialize(value)
 					@value = value.to_i
 				end
@@ -38,7 +38,7 @@ def to_s
 				end
 
 				# Merge another status value (takes the new value, as status should only appear once)
-			# @parameter value [String, Integer] The new status code
+				# @parameter value [String | Integer] The new status code
 				def <<(value)
 					@value = value.to_i
 

lib/protocol/grpc/interface.rb

@@ -10,6 +10,8 @@ module GRPC
 		# Wrapper class to mark a message type as streamed.
 		# Used with the stream() helper method in RPC definitions.
 		class Streaming
+			# Initialize a new Streaming wrapper.
+			# @parameter message_class [Class] The message class being wrapped
 			def initialize(message_class)
 				@message_class = message_class
 			end
@@ -148,7 +150,7 @@ def initialize(name)
 			attr :name
 
 			# Build gRPC path for a method.
-			# @parameter method_name [String, Symbol] Method name in PascalCase (e.g., :SayHello)
+			# @parameter method_name [String | Symbol] Method name in PascalCase (e.g., :SayHello)
 			# @returns [String] gRPC path with PascalCase method name
 			def path(method_name)
 				Methods.build_path(@name, method_name.to_s)

lib/protocol/grpc/methods.rb

@@ -20,7 +20,7 @@ def self.build_path(service, method)
 
 			# Parse service and method from gRPC path.
 			# @parameter path [String] e.g., "/my_service.Greeter/SayHello"
-			# @returns [Array(String, String)] [service, method]
+			# @returns [Array(String | String)] [service, method]
 			def self.parse_path(path)
 				parts = path.split("/")
 				[parts[1], parts[2]]