protocol-grpc 0.2.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1918529ed154432a768c783d4677b6912017fb3acd4054fd392c79fbdc97c9b3
-  data.tar.gz: f076c43f3f1a6e429f0b057eb5ce512f4405fb350b88dfbfdddf2a476ccbf949
+  metadata.gz: 301c1d74991d960be7af4b50850ffa24aab9e4c2c7aedc97759518027aacfe18
+  data.tar.gz: ac2fe4b32aa211ef8dbf4329a8677ae09deced47ab21816c0b6fb361d346dcd2
 SHA512:
-  metadata.gz: 593456adb014c6caa239365a9652253838d7f0930fd2d898c052914a8535a3e34aa40905f951e01d7e2c2b77d27e49c1445f113b3b88f53d54e42fd572dc4501
-  data.tar.gz: b14442b758e562affbc13011a2e5d982d40d0cd742d844921fb8e5efe63cecc5fa7fc633656f8fd7ef13b0f1acde18ceea9f0864aa8adf3bf571ee07558a17db
+  metadata.gz: 2467aaa36d36c6d011ee4913984defc1974d008bf25081777863d83b4c3c7c7825556ae571a99cc74858a7eece0c99cf253953230bbb7220244082a2c32bd95f
+  data.tar.gz: 222fe2052157790f288d72f6f6feff1ad42d507ab188e2bce23cbf0f2e9fa63d7eb0966f774935e5ae0ad3e5a497170f8b126f9dfa4d10ccf53b7f385d7b8437

checksums.yaml.gz.sig

@@ -0,0 +1,4 @@
+P��*/�Z�Y�6��ox����p�y�9[��?G���V��seW 7�<�5�g��r�F��)�XX.z4�
+��f3
+/b�\B�e�w�P�!�E���g���
+mh4���Uhbr�%ё�>jͪ1��[���_�,�Fȃ��{�t_z�c��m�����u�͈��'�3`	�Q4����:��=������1�!B���P��Cٝ�4�j��.’��H��?�on��ђ��rrW�L

data/context/getting-started.md

@@ -129,4 +129,3 @@ call.deadline.exceeded?  # => false
 # Access peer information
 call.peer  # => Protocol::HTTP::Address
 ```
-

data/design.md

@@ -779,10 +779,10 @@ module Protocol
 				# Handle the RPC
 				begin
 					handle_rpc(request, handler, handler_method, request_class, response_class)
-				rescue Error => e
-					trailers_only_error(e.status_code, e.message)
-				rescue => e
-					trailers_only_error(Status::INTERNAL, e.message)
+				rescue Error => error
+					trailers_only_error(e.status_code, error.message)
+				rescue => error
+					trailers_only_error(Status::INTERNAL, error.message)
 				end
 			end
 			

data/lib/protocol/grpc/body/readable_body.rb

@@ -4,6 +4,7 @@
 # Copyright, 2025, by Samuel Williams.
 
 require "protocol/http"
+require "protocol/http/body/wrapper"
 require "zlib"
 
 module Protocol
@@ -12,56 +13,41 @@ module Protocol
 		module Body
 			# Represents a readable body for gRPC messages with length-prefixed framing.
 			# This is the standard readable body for gRPC - all gRPC responses use message framing.
-			class ReadableBody
+			# Wraps the underlying HTTP body and transforms raw chunks into decoded gRPC messages.
+			class ReadableBody < Protocol::HTTP::Body::Wrapper
+				# Wrap the body of a message.
+				#
+				# @parameter message [Request | Response] The message to wrap.
+				# @parameter options [Hash] The options to pass to the initializer.
+				# @returns [ReadableBody | Nil] The wrapped body or `nil` if the message has no body.
+				def self.wrap(message, **options)
+					if body = message.body
+						message.body = self.new(body, **options)
+					end
+					
+					return message.body
+				end
+				
 				# Initialize a new readable body for gRPC messages.
 				# @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)
 				def initialize(body, message_class: nil, encoding: nil)
-					@body = body
+					super(body)
 					@message_class = message_class
 					@encoding = encoding
 					@buffer = String.new.force_encoding(Encoding::BINARY)
-					@closed = false
 				end
 				
-				# @attribute [Protocol::HTTP::Body::Readable] The underlying HTTP body.
-				attr_reader :body
-				
 				# @attribute [String | Nil] The compression encoding.
 				attr_reader :encoding
 				
-				# Close the input body.
-				# @parameter error [Exception | Nil] Optional error that caused the close
-				# @returns [Nil]
-				def close(error = nil)
-					@closed = true
-					
-					if @body
-						@body.close(error)
-						@body = nil
-					end
-					
-					nil
-				end
-				
-				# Check if the stream has been closed.
-				# @returns [Boolean] `true` if the stream is closed, `false` otherwise
-				def closed?
-					@closed or @body.nil?
-				end
-				
-				# Check if there are any input chunks remaining.
-				# @returns [Boolean] `true` if the body is empty, `false` otherwise
-				def empty?
-					@body.nil?
-				end
-				
 				# Read the next gRPC message.
+				# Overrides Wrapper#read to transform raw HTTP body chunks into decoded gRPC messages.
 				# @returns [Object | String | Nil] Decoded message, raw binary, or `Nil` if stream ended
 				def read
-					return nil if closed?
+					return nil if @body.nil? || @body.empty?
 					
 					# Read 5-byte prefix: 1 byte compression flag + 4 bytes length
 					prefix = read_exactly(5)
@@ -87,24 +73,6 @@ module Protocol
 					end
 				end
 				
-				# Enumerate all messages until finished, then invoke {close}.
-				# @yields {|message| ...} The block to call with each message.
-				def each
-					return to_enum unless block_given?
-					
-					error = nil
-					begin
-						while (message = read)
-							yield message
-						end
-					rescue StandardError => e
-						error = e
-						raise
-					ensure
-						close(error)
-					end
-				end
-				
 			private
 				
 				# Read exactly n bytes from the underlying body.
@@ -113,28 +81,18 @@ module Protocol
 				def read_exactly(n)
 					# Fill buffer until we have enough data:
 					while @buffer.bytesize < n
-						return nil if closed?
+						return nil if @body.nil? || @body.empty?
 						
 						# Read chunk from underlying body:
 						chunk = @body.read
 						
 						if chunk.nil?
 							# End of stream:
-							if @body && !@closed
-								@body.close
-								@closed = true
-							end
 							return nil
 						end
 						
 						# Append to buffer:
 						@buffer << chunk.force_encoding(Encoding::BINARY)
-						
-						# Check if body is empty and close if needed:
-						if @body.empty?
-							@body.close
-							@closed = true
-						end
 					end
 					
 					# Extract the required data:

data/lib/protocol/grpc/call.rb

@@ -12,9 +12,11 @@ module Protocol
 		class Call
 			# Initialize a new RPC call context.
 			# @parameter request [Protocol::HTTP::Request] The HTTP request
+			# @parameter response [Protocol::HTTP::Response | Nil] The HTTP response (for setting metadata and trailers)
 			# @parameter deadline [Async::Deadline | Nil] Deadline for the call
-			def initialize(request, deadline: nil)
+			def initialize(request, response = nil, deadline: nil)
 				@request = request
+				@response = response
 				@deadline = deadline
 				@cancelled = false
 			end
@@ -22,6 +24,9 @@ module Protocol
 			# @attribute [Protocol::HTTP::Request] The underlying HTTP request.
 			attr_reader :request
 			
+			# @attribute [Protocol::HTTP::Response | Nil] The HTTP response.
+			attr_reader :response
+			
 			# @attribute [Async::Deadline | Nil] The deadline for this call.
 			attr_reader :deadline
 			

data/lib/protocol/grpc/header.rb

@@ -20,9 +20,9 @@ module Protocol
 			class Status
 				# Initialize the status header with the given value.
 				#
-				# @parameter value [String, Integer] The status code as a string or integer.
+				# @parameter value [String, Integer, Array] The status code as a string, integer, or array (takes first element).
 				def initialize(value)
-					@value = value.is_a?(String) ? value.to_i : value.to_i
+					@value = normalize_value(value)
 				end
 				
 				# Get the status code as an integer.
@@ -40,12 +40,24 @@ module Protocol
 				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, Array] The new status code
 				def <<(value)
-					@value = value.is_a?(String) ? value.to_i : value.to_i
+					@value = normalize_value(value)
 					self
 				end
 				
+			private
+				
+				# Normalize a value to an integer status code.
+				# Handles arrays (from external clients), strings, and integers.
+				# @parameter value [String, Integer, Array] The raw value
+				# @returns [Integer] The normalized status code
+				def normalize_value(value)
+					# Handle Array case (may occur with external clients)
+					actual_value = value.is_a?(Array) ? value.flatten.compact.first : value
+					actual_value.to_i
+				end
+				
 				# Whether this header is acceptable in HTTP trailers.
 				# The `grpc-status` header can appear in trailers as per the gRPC specification.
 				# @returns [Boolean] `true`, as grpc-status can appear in trailers.

data/lib/protocol/grpc/interface.rb

@@ -11,10 +11,17 @@ module Protocol
 		# Can be used by both client stubs and server implementations.
 		class Interface
 			# RPC method definition
-			RPC = Struct.new(:request_class, :response_class, :streaming, :method, keyword_init: true) do
-				def initialize(request_class:, response_class:, streaming: :unary, method: nil)
+			RPC = Struct.new(:name, :request_class, :response_class, :streaming, :method, keyword_init: true) do
+				def initialize(name:, request_class:, response_class:, streaming: :unary, method: nil)
 					super
 				end
+				
+				# Check if this RPC is a streaming RPC (server, client, or bidirectional).
+				# Server-side handlers for streaming RPCs are expected to block until all messages are sent.
+				# @returns [Boolean] `true` if streaming, `false` if unary
+				def streaming?
+					streaming != :unary
+				end
 			end
 			
 			# Hook called when a subclass is created.
@@ -33,6 +40,8 @@ module Protocol
 			# @parameter streaming [Symbol] Streaming type (:unary, :server_streaming, :client_streaming, :bidirectional)
 			# @parameter method [Symbol | Nil] Optional explicit Ruby method name (snake_case). If not provided, automatically converts PascalCase to snake_case.
 			def self.rpc(name, **options)
+				options[:name] = name
+				
 				# Ensure snake_case method name is always available
 				options[:method] ||= pascal_case_to_snake_case(name.to_s).to_sym
 				
@@ -104,4 +113,4 @@ module Protocol
 			end
 		end
 	end
-end
+end

data/lib/protocol/grpc/metadata.rb

@@ -33,8 +33,22 @@ module Protocol
 					status.to_i
 				else
 					# Fallback for when header policy isn't used
-					status_value = status.is_a?(Array) ? status.first : status.to_s
-					status_value.to_i
+					# Handle Array case (may occur with external clients)
+					status_value = if status.is_a?(Array)
+						# Flatten and take first non-nil value, recursively handle nested arrays
+						flattened = status.flatten.compact.first
+						# If still an array, take first element
+						flattened.is_a?(Array) ? flattened.first : flattened
+					else
+						status
+					end
+					
+					# Convert to string then integer to handle various types
+					# Handle case where status_value might still be an array somehow
+					if status_value.is_a?(Array)
+						status_value = status_value.first
+					end
+					status_value.to_s.to_i
 				end
 			end
 			

data/lib/protocol/grpc/version.rb

@@ -7,6 +7,6 @@
 module Protocol
 	# @namespace
 	module GRPC
-		VERSION = "0.2.0"
+		VERSION = "0.4.0"
 	end
 end

data/readme.md

@@ -28,9 +28,19 @@ Please see the [project documentation](https://socketry.github.io/protocol-grpc/
 
 Please see the [project releases](https://socketry.github.io/protocol-grpc/releases/index) for all releases.
 
+### v0.4.0
+
+  - Add `RPC#name`.
+
+### v0.3.0
+
+  - **Breaking**: `Protocol::GRPC::Call` now takes a `response` object parameter instead of separate `response_headers`.
+  - **Breaking**: Removed `Call#response_headers` method. Use `call.response.headers` directly.
+  - Added `RPC#streaming?` method to check if an RPC is streaming.
+
 ### v0.2.0
 
-  - `RCP#method` is always defined (snake case).
+  - `RPC#method` is always defined (snake case).
 
 ### v0.1.0
 

data/releases.md

@@ -1,8 +1,18 @@
 # Releases
 
+## v0.4.0
+
+  - Add `RPC#name`.
+
+## v0.3.0
+
+  - **Breaking**: `Protocol::GRPC::Call` now takes a `response` object parameter instead of separate `response_headers`.
+  - **Breaking**: Removed `Call#response_headers` method. Use `call.response.headers` directly.
+  - Added `RPC#streaming?` method to check if an RPC is streaming.
+
 ## v0.2.0
 
-  - `RCP#method` is always defined (snake case).
+  - `RPC#method` is always defined (snake case).
 
 ## v0.1.0
 

metadata

@@ -1,12 +1,41 @@
 --- !ruby/object:Gem::Specification
 name: protocol-grpc
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Samuel Williams
 bindir: bin
-cert_chain: []
+cert_chain:
+- |
+  -----BEGIN CERTIFICATE-----
+  MIIE2DCCA0CgAwIBAgIBATANBgkqhkiG9w0BAQsFADBhMRgwFgYDVQQDDA9zYW11
+  ZWwud2lsbGlhbXMxHTAbBgoJkiaJk/IsZAEZFg1vcmlvbnRyYW5zZmVyMRIwEAYK
+  CZImiZPyLGQBGRYCY28xEjAQBgoJkiaJk/IsZAEZFgJuejAeFw0yMjA4MDYwNDUz
+  MjRaFw0zMjA4MDMwNDUzMjRaMGExGDAWBgNVBAMMD3NhbXVlbC53aWxsaWFtczEd
+  MBsGCgmSJomT8ixkARkWDW9yaW9udHJhbnNmZXIxEjAQBgoJkiaJk/IsZAEZFgJj
+  bzESMBAGCgmSJomT8ixkARkWAm56MIIBojANBgkqhkiG9w0BAQEFAAOCAY8AMIIB
+  igKCAYEAomvSopQXQ24+9DBB6I6jxRI2auu3VVb4nOjmmHq7XWM4u3HL+pni63X2
+  9qZdoq9xt7H+RPbwL28LDpDNflYQXoOhoVhQ37Pjn9YDjl8/4/9xa9+NUpl9XDIW
+  sGkaOY0eqsQm1pEWkHJr3zn/fxoKPZPfaJOglovdxf7dgsHz67Xgd/ka+Wo1YqoE
+  e5AUKRwUuvaUaumAKgPH+4E4oiLXI4T1Ff5Q7xxv6yXvHuYtlMHhYfgNn8iiW8WN
+  XibYXPNP7NtieSQqwR/xM6IRSoyXKuS+ZNGDPUUGk8RoiV/xvVN4LrVm9upSc0ss
+  RZ6qwOQmXCo/lLcDUxJAgG95cPw//sI00tZan75VgsGzSWAOdjQpFM0l4dxvKwHn
+  tUeT3ZsAgt0JnGqNm2Bkz81kG4A2hSyFZTFA8vZGhp+hz+8Q573tAR89y9YJBdYM
+  zp0FM4zwMNEUwgfRzv1tEVVUEXmoFCyhzonUUw4nE4CFu/sE3ffhjKcXcY//qiSW
+  xm4erY3XAgMBAAGjgZowgZcwCQYDVR0TBAIwADALBgNVHQ8EBAMCBLAwHQYDVR0O
+  BBYEFO9t7XWuFf2SKLmuijgqR4sGDlRsMC4GA1UdEQQnMCWBI3NhbXVlbC53aWxs
+  aWFtc0BvcmlvbnRyYW5zZmVyLmNvLm56MC4GA1UdEgQnMCWBI3NhbXVlbC53aWxs
+  aWFtc0BvcmlvbnRyYW5zZmVyLmNvLm56MA0GCSqGSIb3DQEBCwUAA4IBgQB5sxkE
+  cBsSYwK6fYpM+hA5B5yZY2+L0Z+27jF1pWGgbhPH8/FjjBLVn+VFok3CDpRqwXCl
+  xCO40JEkKdznNy2avOMra6PFiQyOE74kCtv7P+Fdc+FhgqI5lMon6tt9rNeXmnW/
+  c1NaMRdxy999hmRGzUSFjozcCwxpy/LwabxtdXwXgSay4mQ32EDjqR1TixS1+smp
+  8C/NCWgpIfzpHGJsjvmH2wAfKtTTqB9CVKLCWEnCHyCaRVuKkrKjqhYCdmMBqCws
+  JkxfQWC+jBVeG9ZtPhQgZpfhvh+6hMhraUYRQ6XGyvBqEUe+yo6DKIT3MtGE2+CP
+  eX9i9ZWBydWb8/rvmwmX2kkcBbX0hZS1rcR593hGc61JR6lvkGYQ2MYskBveyaxt
+  Q2K9NVun/S785AP05vKkXZEFYxqG6EW012U4oLcFl5MySFajYXRYbuUpH6AY+HP8
+  voD0MPg1DssDLKwXyt1eKD/+Fq0bFWhwVM/1XiAXL7lyYUyOq24KHgQ2Csg=
+  -----END CERTIFICATE-----
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency