protocol-http2 0.25.0 → 0.26.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b8f43f3f03b10cd9477abc3b46090c9e8902eda24994ee6b7ded6d5ee801895d
-  data.tar.gz: f72cb844993482f485cbb713e4c71d08cb1a9b83bef2d9551f9db7e754d7a34b
+  metadata.gz: 88d933bf4cd35251d305cd05fa6654acfbeee446982af751bd221e976dff2313
+  data.tar.gz: e78f3a10d74fccfd63d098af1910c0b846b093aeb446860da5105e306410b401
 SHA512:
-  metadata.gz: c6b7113982c91dcd97920ce8c44330093c3cd90f2d1623928333e5c5ebbf09358b678452cda940f0645da5a1bbe7f1a1b6dc155344913cdee1dafd14b33f2f75
-  data.tar.gz: bdae54364a9e64218bb10c20112ffc6b3511098b68c305a06c8789ecabcfe1d62d2954ba1bee0451fea5014313f1d7e0c782dd49127986c632b87b9890195902
+  metadata.gz: e2a037ad5d8c96c9c8dc6f2352a7ebdeaf3b0b52354c408e965cb689439eb5d94ec2dc9e1d4ef27903c5334c1310a852d6896cc9f52d9f60d917d92e230ffae1
+  data.tar.gz: 5472ccf116f877b341d5793f7166656c924d6c6c8ca0a8080c86856834109ddc8bd0993a41e080f50d80cbaeffb9453c50731dbc96a97007ea1e7434d83d1f39

data/lib/protocol/http2/connection.rb

@@ -238,7 +238,7 @@ module Protocol
 				self.close!
 				
 				# Streams above the last stream ID were not processed by the remote peer and are safe to retry (RFC 9113 §6.8).
-				error = ::Protocol::HTTP::RequestRefusedError.new("GOAWAY: request not processed.")
+				error = ::Protocol::HTTP::RefusedError.new("GOAWAY: request not processed.")
 				
 				@streams.each_value do |stream|
 					if stream.id > @remote_stream_id

data/lib/protocol/http2/error.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2019-2025, by Samuel Williams.
+# Copyright, 2019-2026, by Samuel Williams.
 
 require "protocol/http/error"
 
@@ -50,6 +50,33 @@ module Protocol
 			
 			# The endpoint requires that HTTP/1.1 be used instead of HTTP/2.
 			HTTP_1_1_REQUIRED = 0xD
+			
+			MESSAGES = {
+				NO_ERROR => "No error.",
+				PROTOCOL_ERROR => "Protocol error!",
+				INTERNAL_ERROR => "Internal error!",
+				FLOW_CONTROL_ERROR => "Flow control error!",
+				SETTINGS_TIMEOUT => "Settings timeout!",
+				STREAM_CLOSED => "Stream closed!",
+				FRAME_SIZE_ERROR => "Frame size error!",
+				REFUSED_STREAM => "Stream refused.",
+				CANCEL => "Stream cancelled.",
+				COMPRESSION_ERROR => "Compression error!",
+				CONNECT_ERROR => "Connect error!",
+				ENHANCE_YOUR_CALM => "Enhance your calm!",
+				INADEQUATE_SECURITY => "Inadequate security!",
+				HTTP_1_1_REQUIRED => "HTTP/1.1 required.",
+			}
+			
+			# Get the message for a given HTTP/2 error code.
+			# @parameter code [Integer] The HTTP/2 error code.
+			# @returns [String] The error message.
+			def self.message_for(code)
+				return MESSAGES.fetch(code) do
+					# Unknown error codes are allowed by the protocol, but don't have a static message.
+					"Unknown code: #{code}!"
+				end
+			end
 		end
 		
 		# Raised if connection header is missing or invalid indicating that
@@ -62,6 +89,13 @@ module Protocol
 		# which signals termination of the current connection. You *cannot*
 		# recover from this exception, or any exceptions subclassed from it.
 		class ProtocolError < Error
+			# Build a protocol error for a given HTTP/2 error code.
+			# @parameter code [Integer] The HTTP/2 error code.
+			# @returns [ProtocolError] The protocol error.
+			def self.for(code)
+				return self.new(Error.message_for(code), code)
+			end
+			
 			# Initialize a protocol error with message and error code.
 			# @parameter message [String] The error message.
 			# @parameter code [Integer] The HTTP/2 error code.

data/lib/protocol/http2/stream.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2019-2025, by Samuel Williams.
+# Copyright, 2019-2026, by Samuel Williams.
 
 require_relative "connection"
 
@@ -250,7 +250,11 @@ module Protocol
 				@connection.delete(@id)
 				
 				if error_code
-					error = StreamError.new("Stream closed!", error_code)
+					if error_code == REFUSED_STREAM
+						error = ::Protocol::HTTP::RefusedError.new("Stream refused.")
+					else
+						error = StreamError.for(error_code)
+					end
 				end
 				
 				self.closed(error)

data/lib/protocol/http2/version.rb

@@ -7,6 +7,6 @@
 module Protocol
 	# @namespace
 	module HTTP2
-		VERSION = "0.25.0"
+		VERSION = "0.26.1"
 	end
 end

data/readme.md

@@ -14,6 +14,14 @@ Please see the [project documentation](https://socketry.github.io/protocol-http2
 
 Please see the [project releases](https://socketry.github.io/protocol-http2/releases/index) for all releases.
 
+### v0.26.1
+
+  - Improve `StreamError` messages for HTTP/2 stream reset error codes.
+
+### v0.26.0
+
+  - On RST\_STREAM with REFUSED\_STREAM, close the stream with `Protocol::HTTP::RefusedError` instead of `StreamError`.
+
 ### v0.25.0
 
   - On GOAWAY, proactively close unprocessed streams (ID above `last_stream_id`) with `Protocol::HTTP::RequestRefusedError`, enabling safe retry of non-idempotent requests.
@@ -51,16 +59,6 @@ Please see the [project releases](https://socketry.github.io/protocol-http2/rele
 
   - Reduced the number of window update frames sent to improve network efficiency.
 
-### v0.19.3
-
-  - Improved window update frame handling and performance optimizations.
-  - Better implementation of `Window#inspect` for debugging.
-
-### v0.19.2
-
-  - Added traces to framer for better debugging and monitoring capabilities.
-  - Minor fixes to logging output.
-
 ## See Also
 
   - [Async::HTTP](https://github.com/socketry/async-http) - A high-level HTTP client and server implementation.

data/releases.md

@@ -1,5 +1,13 @@
 # Releases
 
+## v0.26.1
+
+  - Improve `StreamError` messages for HTTP/2 stream reset error codes.
+
+## v0.26.0
+
+  - On RST\_STREAM with REFUSED\_STREAM, close the stream with `Protocol::HTTP::RefusedError` instead of `StreamError`.
+
 ## v0.25.0
 
   - On GOAWAY, proactively close unprocessed streams (ID above `last_stream_id`) with `Protocol::HTTP::RequestRefusedError`, enabling safe retry of non-idempotent requests.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: protocol-http2
 version: !ruby/object:Gem::Version
-  version: 0.25.0
+  version: 0.26.1
 platform: ruby
 authors:
 - Samuel Williams
@@ -62,14 +62,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.61'
+        version: '0.62'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.61'
+        version: '0.62'
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -123,7 +123,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.6
+rubygems_version: 4.0.10
 specification_version: 4
 summary: A low level implementation of the HTTP/2 protocol.
 test_files: []