protocol-http 0.46.0 → 0.47.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 753df89051cc0eeff1cab5100a4ebc2a98e11bd3dce4a3fbcba890406c198c32
-  data.tar.gz: dbc6b80efe3fc8a430839868f160151a9490336cc39423e31cfd851076b72947
+  metadata.gz: f53b02520f9b41a2cf01a8e2637c7331dbfbd330ad13487036c2af363e948c2d
+  data.tar.gz: 803588a8a92cc588e027dd285c8d76705d4fb137e2a5fa9566b2897d1473be38
 SHA512:
-  metadata.gz: 104b449c9a3beaaf7f3c50e28eb21df3f2bef95b89ec954bd20a808a09b508f69d8e0387d6b41ed8e7dc02e41a85bc1116ff8f775694c4e0b26c3899b248f310
-  data.tar.gz: 3ea2e87c3375055aa89f8d9b73b549854cb53ecb90bf6ee3f75ffc4c4ae8b7fbb61b10119fbdb0d125287aea03c894c7327b79ee410d28a771faab24e2fcafa5
+  metadata.gz: a6cb23fc1e47567145ad6d30ab12b4157e3f5962de8a32c38702bdb979c5f9c9388f6b480104655a77dd83c42c5e3230b471efe683acda76e0a2576f0fd654e4
+  data.tar.gz: e61af805d44b682ad9da0de0753b6009a96ace3b68799a597523ac6d74d847923d810e2cc20ded2df569a57505c7a2abb768714153f47a46586df6ce9e9dd086

data/lib/protocol/http/header/priority.rb

@@ -10,54 +10,44 @@ module Protocol
 		module Header
 			# Represents the `priority` header, used to indicate the relative importance of an HTTP request.
 			#
-			# The `priority` header allows clients to express their preference for how resources should be prioritized by the server. It can include directives like `urgency` to specify the importance of a request, and `progressive` to indicate whether a response can be delivered incrementally.
+			# The `priority` header allows clients to express their preference for how resources should be prioritized by the server. It supports directives like `u=` to specify the urgency level of a request, and `i` to indicate whether a response can be delivered incrementally. The urgency levels range from 0 (highest priority) to 7 (lowest priority), while the `i` directive is a boolean flag.
 			class Priority < Split
-				# Urgency levels as defined in RFC 9218:
-				#
-				# These levels indicate the relative importance of a request, helping servers and intermediaries allocate resources efficiently. Properly setting urgency can significantly improve user-perceived performance by prioritizing critical content and deferring less important tasks.
-				module Urgency
-					# `background` priority indicates a request that is not time-sensitive and can be processed with minimal impact to other tasks. It is ideal for requests like analytics or logging, which do not directly impact the user's current experience.
-					BACKGROUND = "background"
-					
-					# `low` priority indicates a request that is important but not critical. It is suitable for content like non-blocking images, videos, or scripts that enhance the experience but do not affect core functionality.
-					LOW = "low"
-					
-					# `normal` priority (default) indicates the standard priority for most requests. It is appropriate for content like text, CSS, or essential images that are necessary for the primary user experience but do not require urgent delivery.
-					NORMAL = "normal"
-					
-					# `high` priority indicates the highest priority, used for requests that are essential and time-critical to the user experience. Examples include content above-the-fold on a webpage, critical API calls, or resources required for rendering.
-					HIGH = "high"
-				end
-				
-				# The `progressive` flag indicates that the response can be delivered incrementally (progressively) as data becomes available. This is particularly useful for large resources like images or video streams, where partial delivery improves the user experience by allowing content to render or play before the full response is received.
-				PROGRESSIVE = "progressive"
-				
 				# Initialize the priority header with the given value.
 				#
-				# @parameter value [String | Nil] the value of the priority header, if any.
+				# @parameter value [String | Nil] the value of the priority header, if any. The value should be a comma-separated string of directives.
 				def initialize(value = nil)
 					super(value&.downcase)
 				end
 				
 				# Add a value to the priority header.
+				#
+				# @parameter value [String] the directive to add to the header.
 				def << value
 					super(value.downcase)
 				end
 				
-				# Returns the urgency level if specified.
+				# The default urgency level if not specified.
+				DEFAULT_URGENCY = 3
+				
+				# Returns the urgency level if specified. 0 is the highest priority, and 7 is the lowest.
 				#
-				# @returns [String | Nil] the urgency level if specified, or `nil`.
-				def urgency
-					if value = self.find{|value| value.start_with?("urgency=")}
+				# @returns [Integer | Nil] the urgency level if specified, or `nil` if not present.
+				def urgency(default = DEFAULT_URGENCY)
+					if value = self.find { |value| value.start_with?("u=") }
 						_, level = value.split("=", 2)
-						
-						return level
+						return level.to_i
 					end
+					
+					return default
 				end
 				
-				# @returns [Boolean] whether the request should be delivered progressively.
-				def progressive?
-					self.include?(PROGRESSIVE)
+				# Checks if the response should be delivered incrementally.
+				#
+				# The `i` directive, when present, indicates that the response can be delivered incrementally as data becomes available.
+				#
+				# @returns [Boolean] whether the request should be delivered incrementally.
+				def incremental?
+					self.include?("i")
 				end
 			end
 		end

data/lib/protocol/http/version.rb

@@ -5,6 +5,6 @@
 
 module Protocol
 	module HTTP
-		VERSION = "0.46.0"
+		VERSION = "0.47.0"
 	end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: protocol-http
 version: !ruby/object:Gem::Version
-  version: 0.46.0
+  version: 0.47.0
 platform: ruby
 authors:
 - Samuel Williams