async-grpc 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a4796002440be1be16d777561582938e9ba8651636a7ebdc14e5f2ec5500e317
-  data.tar.gz: 47658a764095cc220dc087f9c12199cbfd78490c32f25949f4c93d94790525bc
+  metadata.gz: dc699a3d9a47acc1b8bdb7196b0da1280847caa14d5405e0150e8608cd701501
+  data.tar.gz: 3884004454f86b2a7cd7c1ad460c00f6c820edae6b0bccc7a87d177a0cccee72
 SHA512:
-  metadata.gz: e2ec6aff5358f4385d8d99db9ddcdfb2bf0987a50fbf2eefa12baebbbbebeeb6c206244fc57f7d73676be899e2d373975111f325cc147603b9b73ba3d0767a74
-  data.tar.gz: d1b3823eb2ce13f7c2ed01e8cccefb36bb7a17500f25b260ffa7227e0bb0d3c77c06cf05f5ae7b6e0e963ab408d9ba398200da3f6bec0d3e23fb3647dd4977d1
+  metadata.gz: 6d487819bdab689d575b8985e84b81d1ad1293126f9a7f64d697853cf723a4cdf67bb607f0e20faa0f1e547baf0eea6d9dc102da576b450bcba5e42f72ad2e95
+  data.tar.gz: 9f2bf511ff8fc16db342add52bedbfbf1c924c6109346e9d3e877abb2e2ff6f03f40c50ef9a46406df2895b22b6a32845a22a7d444617ed65bc11ab4ee82ae52

checksums.yaml.gz.sig

@@ -0,0 +1,3 @@
+���Zژ�
�X�7X�tE����Q�-�w��3J^��Db��
�����]9��_�F�
+#��?a���#;�8ʗ(xB�������P��"�q.����ȺOy�|M]l����v [x�I��Y92�%�H�+n���'��	~zJ@%q�;�8�س��L<Y��3
+vJ�s�ڿ'��a���#m�5���w�&A[�]� �s�
(?�M��+���SG烰G!�<�A�4�+8j����5��7Q�;j��A���μ/Bva%L���%7(BKN�d���˪���y���Z�ALrXRሼ�����'<�[�ve4�J]�MsM���TO�q ���X<���I������ʪ�i}�n�Pkw��y�
��Y�~P`����

data/context/getting-started.md

@@ -169,6 +169,3 @@ Async do
 	server.run
 end
 ```
-
-
-

data/design.md

@@ -318,13 +318,18 @@ module Async
 				end
 			end
 			
-			# Check gRPC status and raise error if not OK
+		# Check gRPC status and raise error if not OK
 			def check_status!(response)
 				status = Protocol::GRPC::Metadata.extract_status(response.headers)
-				if status != Protocol::GRPC::Status::OK
-					message = Protocol::GRPC::Metadata.extract_message(response.headers)
-					raise Protocol::GRPC::Error.new(status, message)
-				end
+				
+				return if status == Protocol::GRPC::Status::OK
+				
+				message = Protocol::GRPC::Metadata.extract_message(response.headers)
+				metadata = Protocol::GRPC::Methods.extract_metadata(response.headers)
+				
+				remote_error = RemoteError.for(message, metadata)
+				
+				raise Protocol::GRPC::Error.for(status, metadata: metadata), cause: remote_error
 			end
 		end
 	end
@@ -1001,7 +1006,7 @@ This enables async-grpc to be used as a drop-in replacement for the standard `gr
 ### Phase 1: Core Client (✅ Designed)
    - `Async::GRPC::Client` with all four RPC types
    - `Async::GRPC::ServerCall` context object (enhances Protocol::GRPC::Call)
-   - Basic error handling and status checking
+   - Error handling with backtrace support via `RemoteError` and exception chaining
    - Response body wrapping pattern
    - **Server**: Just use `Protocol::GRPC::Middleware` with `Async::HTTP::Server` (no wrapper needed!)
 

data/lib/async/grpc/client.rb

@@ -16,6 +16,7 @@ require "protocol/grpc/body/writable_body"
 require "protocol/grpc/metadata"
 require "protocol/grpc/error"
 require_relative "stub"
+require_relative "remote_error"
 
 module Async
 	module GRPC
@@ -100,7 +101,9 @@ module Async
 			def call(request)
 				request.headers = @headers.merge(request.headers)
 				
-				super
+				super.tap do |response|
+					response.headers.policy = Protocol::GRPC::HEADER_POLICY
+				end
 			end
 			
 			# Make a gRPC call.
@@ -166,19 +169,17 @@ module Async
 				begin
 					# Read body first - trailers are only available after body is consumed
 					response_encoding = response.headers["grpc-encoding"]
-					readable_body = Protocol::GRPC::Body::ReadableBody.new(
-						response.body,
-						message_class: response_class,
-						encoding: response_encoding
-					)
+					response_body = Protocol::GRPC::Body::ReadableBody.wrap(response, message_class: response_class, encoding: response_encoding)
 					
-					message = readable_body.read
-					readable_body.close
+					if response_body
+						response_value = response_body.read
+						response_body.close
+					end
 					
 					# Check status after reading body (trailers are now available)
 					check_status!(response)
 					
-					message
+					return response_value
 				ensure
 					response.close
 				end
@@ -203,32 +204,19 @@ module Async
 				response = call(http_request)
 				
 				begin
-					# Set gRPC policy BEFORE reading body so trailers are processed correctly:
-					unless response.headers.policy == Protocol::GRPC::HEADER_POLICY
-						response.headers.policy = Protocol::GRPC::HEADER_POLICY
-					end
-					
 					# Read body first - trailers are only available after body is consumed:
 					response_encoding = response.headers["grpc-encoding"]
-					readable_body = Protocol::GRPC::Body::ReadableBody.new(
-						response.body,
-						message_class: response_class,
-						encoding: response_encoding
-					)
-					
-					return readable_body unless block_given?
+					response_body = Protocol::GRPC::Body::ReadableBody.wrap(response, message_class: response_class, encoding: response_encoding)
 					
-					begin
-						readable_body.each(&block)
-					ensure
-						readable_body.close
+					if block_given? and response_body
+						response_body.each(&block)
 					end
 					
 					# Check status after reading all body chunks (trailers are now available):
 					check_status!(response)
 					
-					readable_body
-				rescue StandardError
+					return response_body
+				rescue
 					response.close
 					raise
 				end
@@ -327,24 +315,16 @@ module Async
 			# @parameter response [Protocol::HTTP::Response]
 			# @raises [Protocol::GRPC::Error] If status is not OK
 			def check_status!(response)
-				# Policy should already be set before calling this method:
-				# But ensure it's set just in case
-				unless response.headers.policy == Protocol::GRPC::HEADER_POLICY
-					response.headers.policy = Protocol::GRPC::HEADER_POLICY
-				end
-				
 				status = Protocol::GRPC::Metadata.extract_status(response.headers)
 				
-				# If status is UNKNOWN (not found), default to OK:
-				# This handles cases where trailers aren't available or status wasn't set
-				status = Protocol::GRPC::Status::OK if status == Protocol::GRPC::Status::UNKNOWN
-				
 				return if status == Protocol::GRPC::Status::OK
 				
 				message = Protocol::GRPC::Metadata.extract_message(response.headers)
 				metadata = Protocol::GRPC::Methods.extract_metadata(response.headers)
 				
-				raise Protocol::GRPC::Error.for(status, message, metadata: metadata)
+				remote_error = RemoteError.for(message, metadata)
+				
+				raise Protocol::GRPC::Error.for(status, metadata: metadata), cause: remote_error
 			end
 		end
 	end

data/lib/async/grpc/dispatcher_middleware.rb

@@ -3,6 +3,9 @@
 # Released under the MIT License.
 # Copyright, 2025, by Samuel Williams.
 
+require "async"
+require "async/deadline"
+
 require "protocol/grpc/middleware"
 require "protocol/grpc/methods"
 require "protocol/grpc/call"
@@ -41,6 +44,38 @@ module Async
 			
 			protected
 			
+			def invoke_service(service, handler_method, input, output, call)
+				begin
+					service.send(handler_method, input, output, call)
+				ensure
+					# Close input stream:
+					input.close
+					
+					# Close output stream:
+					output.close_write unless output.closed?
+				end
+				
+				# Mark trailers and add status (if not already set by handler):
+				if call.response&.headers
+					call.response.headers.trailer!
+					
+					# Only add OK status if grpc-status hasn't been set by the handler:
+					unless call.response.headers["grpc-status"]
+						Protocol::GRPC::Metadata.add_status!(call.response.headers, status: Protocol::GRPC::Status::OK)
+					end
+				end
+			end
+			
+			def dispatch_to_service(service, handler_method, input, output, call, deadline, parent: Async::Task.current)
+				if deadline
+					parent.with_timeout(deadline) do
+						invoke_service(service, handler_method, input, output, call)
+					end
+				else
+					invoke_service(service, handler_method, input, output, call)
+				end
+			end
+			
 			# Dispatch the request to the appropriate service.
 			# @parameter request [Protocol::HTTP::Request] The HTTP request
 			# @returns [Protocol::HTTP::Response] The HTTP response
@@ -66,9 +101,9 @@ module Async
 					raise Protocol::GRPC::Error.new(Protocol::GRPC::Status::UNIMPLEMENTED, "Method not found: #{method_name}")
 				end
 				
-				handler_method = rpc_descriptor[:method]
-				request_class = rpc_descriptor[:request_class]
-				response_class = rpc_descriptor[:response_class]
+				handler_method = rpc_descriptor.method
+				request_class = rpc_descriptor.request_class
+				response_class = rpc_descriptor.response_class
 				
 				# Verify handler method exists:
 				unless service.respond_to?(handler_method, true)
@@ -80,34 +115,34 @@ module Async
 				input = Protocol::GRPC::Body::ReadableBody.new(request.body, message_class: request_class, encoding: encoding)
 				output = Protocol::GRPC::Body::WritableBody.new(message_class: response_class, encoding: encoding)
 				
-				# Create call context:
+				# Create response headers:
 				response_headers = Protocol::HTTP::Headers.new([], nil, policy: Protocol::GRPC::HEADER_POLICY)
 				response_headers["content-type"] = "application/grpc+proto"
 				response_headers["grpc-encoding"] = encoding if encoding
 				
+				# Create response object:
+				response = Protocol::HTTP::Response[200, response_headers, output]
+				
 				# Parse deadline from timeout header:
-				timeout_value = request.headers["grpc-timeout"]
-				deadline = if timeout_value
-					timeout_seconds = Protocol::GRPC::Methods.parse_timeout(timeout_value)
-					require "async/deadline"
-					Async::Deadline.start(timeout_seconds) if timeout_seconds
+				timeout = Protocol::GRPC::Methods.parse_timeout(request.headers["grpc-timeout"])
+				deadline = if timeout
+					Async::Deadline.start(timeout)
 				end
 				
-				call = Protocol::GRPC::Call.new(request, deadline: deadline)
-				
-				# Call the handler method on the service:
-				service.send(handler_method, input, output, call)
+				# Create call context with request and response:
+				call = Protocol::GRPC::Call.new(request, response, deadline: deadline)
 				
-				# Close output stream:
-				output.close_write unless output.closed?
-				
-				# Mark trailers and add status:
-				response_headers.trailer!
-				Protocol::GRPC::Metadata.add_status_trailer!(response_headers, status: Protocol::GRPC::Status::OK)
+				if rpc_descriptor.streaming?
+					Async do |task|
+						dispatch_to_service(service, handler_method, input, output, call, deadline, parent: task)
+					end
+				else
+					# Unary call:
+					dispatch_to_service(service, handler_method, input, output, call, deadline)
+				end
 				
-				Protocol::HTTP::Response[200, response_headers, output]
+				response
 			end
 		end
 	end
 end
-

data/lib/async/grpc/remote_error.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2025, by Samuel Williams.
+
+module Async
+	module GRPC
+		class RemoteError < StandardError
+			def self.for(message, metadata)
+				self.new(message).tap do |error|
+					if backtrace = metadata.delete("backtrace")
+						# Backtrace is always an array (Split header format):
+						error.set_backtrace(backtrace)
+					end
+				end
+			end
+		end
+	end
+end

data/lib/async/grpc/service.rb

@@ -58,36 +58,12 @@ module Async
 				descriptions = {}
 				
 				@interface_class.rpcs.each do |pascal_case_name, rpc|
-					# Use explicit method name if provided, otherwise convert PascalCase to snake_case:
-					ruby_method_name = if rpc.method
-						rpc.method
-					else
-						snake_case_name = pascal_case_to_snake_case(pascal_case_name.to_s)
-						snake_case_name.to_sym
-					end
-					
-					descriptions[pascal_case_name.to_s] = {
-						method: ruby_method_name,
-						request_class: rpc.request_class,
-						response_class: rpc.response_class,
-						streaming: rpc.streaming
-					}
+					# rpc.method is always set (either explicitly or auto-converted in Interface.rpc)
+					descriptions[pascal_case_name.to_s] = rpc
 				end
 				
 				descriptions
 			end
-			
-		private
-			
-			# Convert PascalCase to snake_case.
-			# @parameter pascal_case [String] PascalCase string (e.g., "SayHello")
-			# @returns [String] snake_case string (e.g., "say_hello")
-			def pascal_case_to_snake_case(pascal_case)
-				pascal_case
-					.gsub(/([A-Z]+)([A-Z][a-z])/, '\1_\2')  # Insert underscore before capital letters followed by lowercase
-					.gsub(/([a-z\d])([A-Z])/, '\1_\2')      # Insert underscore between lowercase/digit and uppercase
-					.downcase
-			end
 		end
 	end
 end

data/lib/async/grpc/stub.rb

@@ -24,8 +24,8 @@ module Async
 					# rpc.method is always set (either explicit or auto-converted from PascalCase)
 					snake_case_method = rpc.method
 					
-					# Index by snake_case method name, storing RPC and PascalCase name for path building
-					@rpcs_by_method[snake_case_method] = [rpc, pascal_case_name]
+					# Index by snake_case method name, storing RPC (which includes name field)
+					@rpcs_by_method[snake_case_method] = rpc
 				end
 			end
 			
@@ -53,8 +53,7 @@ module Async
 					encoding = options.delete(:encoding)
 					
 					# Delegate to client.invoke with PascalCase method name (for interface lookup):
-					@client.invoke(@interface, interface_method_name, request, metadata: metadata, timeout: timeout, encoding: encoding,
-						&block)
+					@client.invoke(@interface, interface_method_name, request, metadata: metadata, timeout: timeout, encoding: encoding, &block)
 				else
 					super
 				end
@@ -78,8 +77,8 @@ module Async
 			# @returns [Array(Protocol::GRPC::RPC, Symbol) | Array(Nil, Nil)] RPC definition and PascalCase method name, or nil if not found
 			def lookup_rpc(method_name)
 				if @rpcs_by_method.key?(method_name)
-					rpc, pascal_case_name = @rpcs_by_method[method_name]
-					return [rpc, pascal_case_name]
+					rpc = @rpcs_by_method[method_name]
+					return [rpc, rpc.name]
 				end
 				
 				[nil, nil]

data/lib/async/grpc/version.rb

@@ -7,6 +7,7 @@
 module Async
 	# @namespace
 	module GRPC
-		VERSION = "0.1.0"
+		VERSION = "0.2.0"
 	end
 end
+

data/readme.md

@@ -12,8 +12,7 @@ Asynchronous gRPC client and server implementation built on top of `protocol-grp
   - **Method-based stubs** - Create type-safe stubs from `Protocol::GRPC::Interface` definitions. Accepts both PascalCase and snake\_case method names for convenience.
   - **Server middleware** - `DispatcherMiddleware` routes requests to registered services based on path.
   - **All RPC patterns** - Supports unary, server streaming, client streaming, and bidirectional streaming RPCs.
-  - **Interface-based services** - Define services using `Protocol::GRPC::Interface` with automatic PascalCase to snake\_case method name conversion for Ruby implementations.
-  - **HTTP/2 transport** - Built on `async-http` with automatic HTTP/2 multiplexing and connection pooling.
+  - **HTTP/1 and HTTP/2 transport** - Built on `async-http` with automatic HTTP/2 multiplexing and connection pooling.
 
 ## Usage
 
@@ -25,8 +24,17 @@ Please see the [project documentation](https://socketry.github.io/async-grpc/) f
 
 Please see the [project releases](https://socketry.github.io/async-grpc/releases/index) for all releases.
 
+### v0.2.0
+
+  - Added `Async::GRPC::RemoteError` class to encapsulate remote error details including message and backtrace extracted from response headers.
+  - Client-side error handling now extracts backtraces from response metadata and sets them on `RemoteError`, which is chained as the `cause` of `Protocol::GRPC::Error` for better debugging.
+  - Updated to use `Protocol::GRPC::Metadata.add_status!` instead of deprecated `add_status_trailer!` method.
+  - Tidy up request and response body handling.
+
 ### v0.1.0
 
+  - Initial hack.
+
 ## See Also
 
   - [protocol-grpc](https://github.com/socketry/protocol-grpc) — Protocol abstractions for gRPC that this gem builds upon.

data/releases.md

@@ -1,3 +1,12 @@
 # Releases
 
+## v0.2.0
+
+  - Added `Async::GRPC::RemoteError` class to encapsulate remote error details including message and backtrace extracted from response headers.
+  - Client-side error handling now extracts backtraces from response metadata and sets them on `RemoteError`, which is chained as the `cause` of `Protocol::GRPC::Error` for better debugging.
+  - Updated to use `Protocol::GRPC::Metadata.add_status!` instead of deprecated `add_status_trailer!` method.
+  - Tidy up request and response body handling.
+
 ## v0.1.0
+
+  - Initial hack.

metadata

@@ -1,12 +1,41 @@
 --- !ruby/object:Gem::Specification
 name: async-grpc
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.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
@@ -29,14 +58,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.2'
+        version: '0.5'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.2'
+        version: '0.5'
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -48,6 +77,7 @@ files:
 - lib/async/grpc.rb
 - lib/async/grpc/client.rb
 - lib/async/grpc/dispatcher_middleware.rb
+- lib/async/grpc/remote_error.rb
 - lib/async/grpc/service.rb
 - lib/async/grpc/stub.rb
 - lib/async/grpc/version.rb