protocol-grpc 0.9.0 → 0.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7a4e884fa493dfbcc313a9c261b9d0cbeef027dc04b7ad99f031160f9231a8e5
-  data.tar.gz: f0bb7c75757eef5ae129197304ebe1922b928348b65560512ef110586d49ba66
+  metadata.gz: 26f2d23d59b86e4dc0dda296d1ed3d455c52c9741ced1a1c62bd8b24c6d0398e
+  data.tar.gz: 4f4b655efdec5d5e1bde611e1904112706a3f1548ee4b5c90d8b24b5a5b2c882
 SHA512:
-  metadata.gz: 1a9db6d101f6f41583d0b8c09fd00f7c4aa03de315e6a969484ae9c48b23a102b5c957bd47cd3c99d70c367e944d18f23e36c27436c8d8d897df7339d49bf9f7
-  data.tar.gz: 90f1f8718e1b147cae4a6140aa2b391cb513abe89fa53708c22f5fa8f40724c36c61f35ad448e5ccbcf5437cb4e9bc4e4ee4b4276ea9f1e26399716d55c6fc5c
+  metadata.gz: 7f2e77bb2014620f522bf84704dceae110ea22f1c580c9e714d077a3296b1226360910dd5872a8aee6a0d45fb0b273c0a1e074a9c9c7c562f0df4619b50340b0
+  data.tar.gz: '039d6f8f513430285ef84722a177c91e501c91c6e10f843b87f2c10df1dbed69b8e4196d44cc73264e1e9b3e749e8c7c75ae6a4da00653973c013588fb0c1f2a'

data/design.md

@@ -266,8 +266,14 @@ module Protocol
 		# Custom header policy for gRPC
 		# Extends Protocol::HTTP::Headers::POLICY with gRPC-specific headers
 		HEADER_POLICY = Protocol::HTTP::Headers::POLICY.merge(
+			# Request headers:
+			"grpc-timeout" => Header::Timeout,
+			"grpc-encoding" => Header::Encoding,
+			
+			# Response headers:
 			"grpc-status" => Header::Status,
 			"grpc-message" => Header::Message,
+		
 			# By default, all other headers follow standard HTTP policy
 			# But gRPC allows most metadata to be sent as trailers
 		).freeze

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

@@ -108,9 +108,19 @@ module Protocol
 				def decompress(data)
 					case @encoding
 					when "gzip"
-						Zlib::Gunzip.new.inflate(data)
+						# Gzip format: zlib stream with gzip header (RFC 1952)
+						# Use MAX_WBITS + 32 to handle gzip header and CRC
+						inflater = Zlib::Inflate.new(Zlib::MAX_WBITS + 32)
+						result = inflater.inflate(data)
+						inflater.close
+						result
 					when "deflate"
-						Zlib::Inflate.inflate(data)
+						# Zlib format (RFC 1950) - default window bits handle zlib header
+						# This matches HTTP's "deflate" content-encoding
+						inflater = Zlib::Inflate.new
+						result = inflater.inflate(data)
+						inflater.close
+						result
 					else
 						data
 					end

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

@@ -75,19 +75,26 @@ module Protocol
 				
 				protected
 				
-				# Compress data using the configured encoding.
+				# Compress data using the specified encoding.
+				# Per gRPC spec, compression is per-message and uses standard formats:
+				# - gzip: RFC 1952 (gzip format with headers and CRC)
+				# - deflate: RFC 1950 (zlib format, not raw deflate, for HTTP compatibility)
 				# @parameter data [String] The data to compress
+				# @parameter encoding [String | Nil] The encoding to use. If `nil`, uses @encoding.
 				# @returns [String] The compressed data
 				# @raises [Error] If compression fails
 				def compress(data)
 					case @encoding
 					when "gzip"
+						# Use GzipWriter for proper gzip format (includes headers, CRC)
 						io = StringIO.new
 						gz = Zlib::GzipWriter.new(io, @level)
 						gz.write(data)
 						gz.close
 						io.string
 					when "deflate"
+						# Use zlib format (RFC 1950) for HTTP compatibility
+						# This matches HTTP's "deflate" content-encoding
 						Zlib::Deflate.deflate(data, @level)
 					else
 						data # No compression or identity

data/lib/protocol/grpc/header/encoding.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2026, by Samuel Williams.
+
+module Protocol
+	module GRPC
+		module Header
+			# The `grpc-encoding` header represents the message compression encoding.
+			#
+			# The `grpc-encoding` header specifies the compression algorithm used for the message payload.
+			# Common values include "identity" (no compression), "gzip", "deflate", etc.
+			# This header can appear in both request and response headers, but not in trailers.
+			class Encoding < String
+				# Parse an encoding from a header value.
+				#
+				# @parameter value [String] The header value to parse (e.g., "identity", "gzip").
+				# @returns [Encoding] A new Encoding instance.
+				def self.parse(value)
+					new(value)
+				end
+				
+				# Coerce a value to an Encoding instance.
+				# Used by Protocol::HTTP::Headers when setting header values.
+				#
+				# @parameter value [Object] The value to coerce (will be converted to string).
+				# @returns [Encoding] A new Encoding instance.
+				def self.coerce(value)
+					new(value.to_s)
+				end
+				
+				# Initialize the encoding header with the given value.
+				#
+				# @parameter value [String] The encoding value (e.g., "identity", "gzip").
+				def initialize(value)
+					super(value.to_s)
+				end
+				
+				# Check if this encoding represents no compression (identity encoding).
+				#
+				# @returns [Boolean] `true` if the encoding is "identity" or empty.
+				def identity?
+					self == "identity" || self.empty?
+				end
+				
+				# Merge another encoding value (takes the new value, as encoding should only appear once)
+				# @parameter value [String] The new encoding value
+				def <<(value)
+					replace(value.to_s)
+					
+					return self
+				end
+				
+				# Whether this header is acceptable in HTTP trailers.
+				# The `grpc-encoding` header does not appear in trailers.
+				# @returns [Boolean] `false`, as grpc-encoding cannot appear in trailers.
+				def self.trailer?
+					false
+				end
+			end
+		end
+	end
+end

data/lib/protocol/grpc/header/timeout.rb

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2026, by Samuel Williams.
+
+require_relative "../methods"
+
+module Protocol
+	module GRPC
+		module Header
+			# The `grpc-timeout` header represents the gRPC request timeout.
+			#
+			# The `grpc-timeout` header specifies how long the client is willing to wait for an RPC to complete.
+			# The format is: value + unit (H=hours, M=minutes, S=seconds, m=milliseconds, u=microseconds, n=nanoseconds).
+			# This header appears only in request headers, not in trailers.
+			class Timeout < String
+				# Parse a timeout from a header value.
+				#
+				# @parameter value [String] The header value to parse (e.g., "5S", "1000m").
+				# @returns [Timeout] A new Timeout instance.
+				def self.parse(value)
+					new(value)
+				end
+				
+				# Coerce a value to a Timeout instance.
+				#
+				# If a Numeric is provided, it will be formatted as a gRPC timeout string using {Protocol::GRPC::Methods.format_timeout}.
+				#
+				# @parameter value [String | Numeric] The value to coerce.
+				# @returns [Timeout] A new Timeout instance.
+				def self.coerce(value)
+					if value.is_a?(Numeric)
+						return new(Protocol::GRPC::Methods.format_timeout(value))
+					else
+						return new(value.to_s)
+					end
+				end
+				
+				# Initialize the timeout header with the given value.
+				#
+				# @parameter value [String] The timeout value in gRPC format.
+				def initialize(value)
+					super(value.to_s)
+				end
+				
+				# Parse the timeout value to seconds.
+				#
+				# @returns [Numeric | Nil] Timeout in seconds, or `Nil` if value is invalid.
+				def to_seconds
+					Protocol::GRPC::Methods.parse_timeout(self)
+				end
+				
+				# Merge another timeout value (takes the new value, as timeout should only appear once)
+				# @parameter value [String] The new timeout value
+				def <<(value)
+					replace(value.to_s)
+					
+					return self
+				end
+				
+				# Whether this header is acceptable in HTTP trailers.
+				# The `grpc-timeout` header is request-only and does not appear in trailers.
+				# @returns [Boolean] `false`, as grpc-timeout cannot appear in trailers.
+				def self.trailer?
+					false
+				end
+			end
+		end
+	end
+end

data/lib/protocol/grpc/header.rb

@@ -8,6 +8,8 @@ require "protocol/http"
 require_relative "status"
 require_relative "header/status"
 require_relative "header/message"
+require_relative "header/timeout"
+require_relative "header/encoding"
 
 module Protocol
 	module GRPC
@@ -18,6 +20,11 @@ module Protocol
 		# Custom header policy for gRPC.
 		# Extends Protocol::HTTP::Headers::POLICY with gRPC-specific headers.
 		HEADER_POLICY = Protocol::HTTP::Headers::POLICY.merge(
+			# Request headers:
+			"grpc-timeout" => Header::Timeout,
+			"grpc-encoding" => Header::Encoding,
+			
+			# Response headers:
 			"grpc-status" => Header::Status,
 			"grpc-message" => Header::Message
 			# By default, all other headers follow standard HTTP policy, but gRPC allows most metadata to be sent as trailers.

data/lib/protocol/grpc/methods.rb

@@ -32,10 +32,14 @@ module Protocol
 			# @parameter content_type [String] Content type (default: "application/grpc+proto")
 			# @returns [Protocol::HTTP::Headers]
 			def self.build_headers(metadata: {}, timeout: nil, content_type: "application/grpc+proto")
-				headers = Protocol::HTTP::Headers.new
+				headers = Protocol::HTTP::Headers.new(policy: Protocol::GRPC::HEADER_POLICY)
 				headers["content-type"] = content_type
 				headers["te"] = "trailers"
-				headers["grpc-timeout"] = format_timeout(timeout) if timeout
+				
+				if timeout
+					# Coerced to proper format by header policy:
+					headers["grpc-timeout"] = timeout
+				end
 				
 				metadata.each do |key, value|
 					# Binary headers end with -bin and are base64 encoded:

data/lib/protocol/grpc/middleware.rb

@@ -27,6 +27,9 @@ module Protocol
 			def call(request)
 				return super unless grpc_request?(request)
 				
+				# Ensure the request headers are using the gRPC header policy:
+				request.headers.policy = Protocol::GRPC::HEADER_POLICY
+				
 				begin
 					dispatch(request)
 				rescue Error => error

data/lib/protocol/grpc/version.rb

@@ -7,7 +7,7 @@
 module Protocol
 	# @namespace
 	module GRPC
-		VERSION = "0.9.0"
+		VERSION = "0.10.0"
 	end
 end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: protocol-grpc
 version: !ruby/object:Gem::Version
-  version: 0.9.0
+  version: 0.10.0
 platform: ruby
 authors:
 - Samuel Williams
@@ -109,8 +109,10 @@ files:
 - lib/protocol/grpc/call.rb
 - lib/protocol/grpc/error.rb
 - lib/protocol/grpc/header.rb
+- lib/protocol/grpc/header/encoding.rb
 - lib/protocol/grpc/header/message.rb
 - lib/protocol/grpc/header/status.rb
+- lib/protocol/grpc/header/timeout.rb
 - lib/protocol/grpc/health_check.rb
 - lib/protocol/grpc/interface.rb
 - lib/protocol/grpc/metadata.rb