http-2 1.0.2 → 1.1.0

data/sig/connection.rbs

@@ -5,8 +5,15 @@ module HTTP2
     include BufferUtils
 
     REQUEST_MANDATORY_HEADERS: Array[String]
+
     RESPONSE_MANDATORY_HEADERS: Array[String]
 
+    CONNECTION_FRAME_TYPES: Array[Symbol]
+
+    HEADERS_FRAME_TYPES: Array[Symbol]
+
+    STREAM_OPEN_STATES: Array[Symbol]
+
     attr_reader state: Symbol
 
     attr_reader local_window: Integer
@@ -22,14 +29,18 @@ module HTTP2
 
     @stream_id: Integer
     @active_stream_count: Integer
-    @last_activated_stream: Integer
     @last_stream_id: Integer
 
     @streams: Hash[Integer, Stream]
-    @streams_recently_closed: Hash[Integer, Stream]
+    @streams_recently_closed: Hash[Integer, Numeric]
 
     @framer: Framer
 
+    type role_type = :client | :server
+
+    @local_role: role_type
+    @remote_role: role_type
+
     @local_window_limit: Integer
     @remote_window_limit: Integer
 
@@ -40,6 +51,7 @@ module HTTP2
     @recv_buffer: String
     @continuation: Array[frame]
 
+    @h2c_upgrade: Symbol?
     @closed_since: Float?
     @received_frame: bool
 
@@ -54,18 +66,18 @@ module HTTP2
 
     def window_update: (Integer increment) -> void
 
-    def settings: (settings_enum) -> void
+    def settings: (settings_enum payload) -> void
 
     def receive: (string data) -> void
     alias << receive
 
-    def initialize: (?settings_hash) -> void
+    def initialize: (?connection_opts) -> void
 
     private
 
-    def send: (frame) -> void
+    def send: (frame frame) -> void
 
-    def encode: (frame) -> Array[String]
+    def encode: (frame frame) -> void
 
     def connection_frame?: (frame) -> bool
 
@@ -73,13 +85,13 @@ module HTTP2
 
     def ping_management: (frame) -> void
 
-    def validate_settings: (:client | :server, settings_enum) -> void
+    def validate_settings: (role_type, settings_enum) -> void
 
     def connection_settings: (frame) -> void
 
     def decode_headers: (frame) -> void
 
-    def encode_headers: (frame) -> Array[frame]
+    def encode_headers: (frame headers_frame) -> void
 
     def activate_stream: (id: Integer, **untyped) -> Stream
 

data/sig/emitter.rbs

@@ -1,13 +1,11 @@
 module HTTP2
   module Emitter
+    @listeners: Hash[Symbol, Array[^(*untyped) -> void]]
+
     def on: (Symbol event) { (*untyped) -> void } -> void
 
     def once: (Symbol event) { (*untyped) -> void } -> void
 
     def emit: (Symbol event, *untyped args) ?{ (*untyped) -> void } -> void
-
-    private
-
-    def listeners: (Symbol event)  -> Array[Proc]
   end
 end

data/sig/extensions.rbs

@@ -1,5 +1,7 @@
 module HTTP2
   module BufferUtils
+    def append_str: (String str, String data) -> void
+
     def read_str: (String str, Integer n) -> String
 
     def read_uint32: (String str) -> Integer
@@ -8,6 +10,6 @@ module HTTP2
   end
 
   module PackingExtensions
-    def pack: (Array[Integer] array_to_pack, String template, buffer: String, ?offset: Integer) -> String
+    def pack: (Array[Integer | String] array_to_pack, String template, buffer: String, ?offset: Integer) -> String
   end
 end

data/sig/flow_buffer.rbs

@@ -2,20 +2,22 @@ module HTTP2
   module FlowBuffer
     MAX_WINDOW_SIZE: Integer
 
+    attr_reader send_buffer: FrameBuffer
+
     def buffered_amount: () -> Integer
 
     def flush: () -> void
 
     private
 
-    def send_buffer: () -> FrameBuffer
-
-    def update_local_window: (frame) -> void
+    def update_local_window: (data_frame frame) -> void
 
     def calculate_window_update: (Integer) -> void
 
-    def send_data: (?frame? frame, ?bool encode) -> void
+    def send_data: (?data_frame? frame, ?bool encode) -> void
+
+    def send_frame: (data_frame frame, bool encode) -> void
 
-    def process_window_update: (frame: frame, ?encode: bool) -> void
+    def process_window_update: (frame: window_update_frame, ?encode: bool) -> void
   end
 end

data/sig/frame_buffer.rbs

@@ -4,7 +4,7 @@ module HTTP2
 
     @buffer: Array[data_frame]
 
-    def <<: (data_frame) -> void
+    def <<: (data_frame frame) -> void
 
     def empty?: () -> bool
 

data/sig/framer.rbs

@@ -1,5 +1,6 @@
 module HTTP2
   class Framer
+    include Error
     include PackingExtensions
     include BufferUtils
 
@@ -11,6 +12,8 @@ module HTTP2
 
     FRAME_TYPES: Hash[Symbol, Integer]
 
+    FRAME_TYPES_BY_NAME: Array[Symbol]
+
     FRAME_TYPES_WITH_PADDING: Array[Symbol]
 
     FRAME_FLAGS: Hash[Symbol, Hash[Symbol, Integer]]
@@ -38,6 +41,8 @@ module HTTP2
 
     def common_header: (frame, buffer: String) -> String
 
+    def read_common_header: (String buf) -> frame
+
     def read_common_frame: (String) -> frame
 
     def generate: (frame) -> String

data/sig/header/compressor.rbs

@@ -9,7 +9,7 @@ module HTTP2
 
       def integer: (Integer, Integer, buffer: String, ?offset: Integer) -> String
 
-      def string: (String) -> String
+      def string: (String, ?String buffer) -> String
 
       def header: (header_command, ?String) -> String
 
@@ -17,11 +17,13 @@ module HTTP2
 
       private
 
-      def initialize: (?context_hash options) -> void
+      def initialize: (?connection_opts options) -> void
 
-      def huffman_string: (String str) -> String
+      def huffman_string: (String str, ?String buffer) -> String
 
-      def plain_string: (String str) -> String
+      def plain_string: (String str, ?String buffer) -> String
+
+      def set_huffman_size: (String str, Integer huffman_offset) -> String
     end
   end
 end

data/sig/header/decompressor.rbs

@@ -3,6 +3,8 @@ module HTTP2
     class Decompressor
       include BufferUtils
 
+      FORBIDDEN_HEADERS: Array[String]
+
       @cc: EncodingContext
 
       def table_size=: (Integer) -> void
@@ -17,8 +19,7 @@ module HTTP2
                 | (String) -> Array[header_pair]
       private
 
-      def initialize: (context_hash options) -> untyped
-                    | () -> untyped
+      def initialize: (?connection_opts options) -> void
     end
   end
 end

data/sig/header/encoding_context.rbs

@@ -3,32 +3,50 @@ module HTTP2
     class EncodingContext
       STATIC_TABLE: Array[header_pair]
 
+      STATIC_TABLE_BY_FIELD: Hash[String, Array[[Integer, String]]]
+
+      STATIC_TABLE_SIZE: Integer
+
+      STATIC_ALL: Array[Symbol]
+
+      STATIC_NEVER: Array[Symbol]
+
+      DEFAULT_OPTIONS: context_hash
+
+      UPPER: Regexp
+
+
       attr_reader table: Array[header_pair]
 
       attr_reader options: context_hash
 
+      attr_reader current_table_size: Integer
+
+      @limit: Integer
+
+      @_table_updated: bool
+
       def dup: () -> EncodingContext
 
       def dereference: (Integer) -> header_pair
 
       def process: (header_command cmd) -> header_pair?
 
-      def encode: (_Each[header_pair]) -> Array[header_command]
+      def encode: (_Each[header_pair]) { (header_command) -> void } -> void
 
       def addcmd: (String name, String value) -> header_command
 
       def table_size=: (Integer) -> void
 
-      def current_table_size: () -> Integer
+      def listen_on_table: { () -> void } -> void
 
       private
 
-      def initialize: (context_hash options) -> untyped
-                    | () -> untyped
+      def initialize: (?connection_opts options) -> void
 
-      def add_to_table: (header_pair) -> void
+      def add_to_table: (string name, string value) -> void
 
-      def size_check: (header_pair?) -> bool
+      def size_check: (Integer cmdsize) -> bool
     end
   end
 end

data/sig/header/huffman.rbs

@@ -1,9 +1,25 @@
 module HTTP2
   module Header
-    class Huffman
-      def encode: (String str) -> String
+    module Huffman
+      include Error
+      extend PackingExtensions
+      extend BufferUtils
 
-      def decode: (String str) -> String
+      BITS_AT_ONCE: Integer
+
+      EOS: Integer
+
+      CODES: Array[[Integer, Integer]]
+
+      ENCODE_TABLE: Array[String]
+
+      MAX_FINAL_STATE: Integer
+
+      MACHINE: Array[Array[[Integer?, Integer]]]
+
+      def self?.encode: (String str, ?String buffer) -> String
+
+      def self?.decode: (String str) -> String
     end
   end
 end

data/sig/header.rbs

@@ -3,16 +3,19 @@ module HTTP2
     type header_key = :type | :name | :value | :index
     type header_value = Integer | String | :indexed | :changetablesize | :incremental | :noindex | :neverindexed
 
-    #type context_hash = {
-    #  huffman?: (:always | :never | :shorter),
-    #  index?: (:all | :static | :never),
-    #  table_size?: Integer
-    #}
-    type context_hash = Hash[Symbol, Symbol | Integer]
+    type context_hash = {
+     huffman: (:always | :never | :shorter),
+     index: (:all | :static | :never),
+     table_size: Integer
+    }
 
-    type header_command = Hash[header_key, header_value]
+    type header_type = :indexed | :incremental | :noindex | :neverindexed | :changetablesize
 
-    HEADREP: Hash[Symbol, Hash[Symbol, Integer]]
+    type header_command = { type: :indexed , name: Integer } |
+                          { type: (:incremental | :noindex | :neverindexed), name: Integer | String, value: String } |
+                          { type: :changetablesize, ?name: Integer, value: Integer }
+
+    HEADREP: Hash[header_type, { prefix: Integer, pattern: Integer }]
 
     NAIVE: Hash[Symbol, Symbol]
     LINEAR: Hash[Symbol, Symbol]

data/sig/stream.rbs

@@ -3,6 +3,8 @@ module HTTP2
     include FlowBuffer
     include Emitter
 
+    STREAM_OPEN_STATES: Array[Symbol]
+
     attr_reader id: Integer
     attr_reader state: Symbol
     attr_reader parent: Stream?
@@ -19,6 +21,7 @@ module HTTP2
     @_content_length: Integer?
     @_status_code: Integer?
     @_waiting_on_trailers: bool
+    @_trailers: Array[String]?
     @received_data: bool
     @activated: bool
 
@@ -26,15 +29,15 @@ module HTTP2
 
     def closed?: () -> bool
 
-    def receive: (frame) -> void
+    def receive: (frame frame) -> void
 
     alias << receive
 
-    def verify_trailers: (frame) -> void
+    def verify_trailers: (headers_frame frame) -> void
 
     def calculate_content_length: (Integer?) -> void
 
-    def send: (frame) -> void
+    def send: (frame frame) -> void
 
     def headers: (Enumerable[header_pair] headers, ?end_headers: bool, ?end_stream: bool) -> void
 
@@ -77,9 +80,9 @@ module HTTP2
 
     def complete_transition: (frame) -> void
 
-    def process_priority: ({weight: Integer, dependency: Integer, exclusive: bool}) -> void
+    def process_priority: (priority_frame frame) -> void
 
-    def end_frame?: () -> bool
+    def end_stream?: (frame frame) -> boolish
 
     def stream_error: (Symbol error, ?msg: String?) -> void
                     | () -> void

metadata

@@ -1,16 +1,15 @@
 --- !ruby/object:Gem::Specification
 name: http-2
 version: !ruby/object:Gem::Version
-  version: 1.0.2
+  version: 1.1.0
 platform: ruby
 authors:
 - Tiago Cardoso
 - Ilya Grigorik
 - Kaoru Maeda
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-11-05 00:00:00.000000000 Z
+date: 2025-04-10 00:00:00.000000000 Z
 dependencies: []
 description: Pure-ruby HTTP 2.0 protocol implementation
 email:
@@ -39,6 +38,7 @@ files:
 - lib/http/2/server.rb
 - lib/http/2/stream.rb
 - lib/http/2/version.rb
+- sig/2.rbs
 - sig/client.rbs
 - sig/connection.rbs
 - sig/emitter.rbs
@@ -52,7 +52,6 @@ files:
 - sig/header/decompressor.rbs
 - sig/header/encoding_context.rbs
 - sig/header/huffman.rbs
-- sig/next.rbs
 - sig/server.rbs
 - sig/stream.rbs
 homepage: https://github.com/igrigorik/http-2
@@ -64,7 +63,6 @@ metadata:
   source_code_uri: https://github.com/igrigorik/http-2
   homepage_uri: https://github.com/igrigorik/http-2
   rubygems_mfa_required: 'true'
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -79,8 +77,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.3
-signing_key:
+rubygems_version: 3.6.2
 specification_version: 4
 summary: Pure-ruby HTTP 2.0 protocol implementation
 test_files: []