http-2 1.0.1 → 1.1.0

data/lib/http/2/stream.rb

@@ -40,6 +40,8 @@ module HTTP2
     include Emitter
     include Error
 
+    STREAM_OPEN_STATES = %i[open half_closed_local half_closing closing].freeze
+
     # Stream ID (odd for client initiated streams, even otherwise).
     attr_reader :id
 
@@ -80,6 +82,11 @@ module HTTP2
       @id = id
       @weight = weight
       @dependency = dependency
+
+      # from mixins
+      @listeners = Hash.new { |hash, key| hash[key] = [] }
+      @send_buffer = FrameBuffer.new
+
       process_priority(weight: weight, dependency: dependency, exclusive: exclusive)
       @local_window_max_size = connection.local_settings[:settings_initial_window_size]
       @local_window = connection.local_settings[:settings_initial_window_size]
@@ -88,7 +95,7 @@ module HTTP2
       @state  = state
       @error  = false
       @closed = false
-      @_method = @_content_length = @_status_code = nil
+      @_method = @_content_length = @_status_code = @_trailers = nil
       @_waiting_on_trailers = false
       @received_data = false
       @activated = false
@@ -113,9 +120,7 @@ module HTTP2
         # If a DATA frame is received whose stream is not in "open" or
         # "half closed (local)" state, the recipient MUST respond with a
         # stream error (Section 5.4.2) of type STREAM_CLOSED.
-        stream_error(:stream_closed) unless @state == :open ||
-                                            @state == :half_closed_local ||
-                                            @state == :half_closing || @state == :closing ||
+        stream_error(:stream_closed) unless STREAM_OPEN_STATES.include?(@state) ||
                                             (@state == :closed && @closed == :local_rst)
         @received_data = true
         calculate_content_length(frame[:length])

data/lib/http/2/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module HTTP2
-  VERSION = "1.0.1"
+  VERSION = "1.1.0"
 end

data/lib/http/2.rb

@@ -1,6 +1,11 @@
 # frozen_string_literal: true
 
 require "http/2/version"
+
+module HTTP2
+  EMPTY = [].freeze
+end
+
 require "http/2/extensions"
 require "http/2/base64"
 require "http/2/error"

data/sig/{next.rbs → 2.rbs}

@@ -7,7 +7,18 @@ module HTTP2
 
   DEFAULT_MAX_CONCURRENT_STREAMS: Integer
 
-  type settings_hash = Hash[Symbol, Integer]
+  EMPTY: []
+
+  type connection_opts = Hash[Symbol, untyped]
+
+  type settings_hash = {
+    settings_header_table_size: Integer,
+    settings_enable_push: Integer,
+    settings_max_concurrent_streams:  Integer,
+    settings_initial_window_size: Integer,
+    settings_max_frame_size: Integer,
+    settings_max_header_list_size: Integer
+  }
 
   type settings_ary = Array[settings_enum]
 
@@ -30,44 +41,44 @@ module HTTP2
   # # FRAMES
   type frame_control_flags = Array[:end_headers | :end_stream]
 
+  type common_frame = { stream: Integer }
+
   # # HEADERS
-  # type headers_frame = {
-  #   type: :headers, flags: frame_control_flags, stream: Integer, payload: Enumerable[header_pair],
-  #   ?method: Symbol, ?trailer: Array[String], ?content_length: Integer, ?padding: Integer
-  # }
+  type headers_frame = common_frame & {
+    type: :headers, flags: frame_control_flags, payload: Enumerable[header_pair] | String,
+    ?method: Symbol, ?trailer: Array[String], ?content_length: Integer, ?padding: Integer
+  }
 
   # # DATA
-  type data_frame = { type: :data, flags: frame_control_flags, stream: Integer, length: Integer, payload: String, padding: Integer }
-                  | { type: :data, flags: frame_control_flags, stream: Integer, length: Integer, payload: String }
-                  | { type: :data, flags: frame_control_flags, payload: String }
+  type data_frame = { type: :data, flags: frame_control_flags, ?length: Integer, payload: String, ?padding: Integer }
 
   # # PUSH_PROMISE
-  # type push_promise_frame = { type: :push_promise, promise_stream: Integer, flags: frame_control_flags, stream: Integer, ?method: Symbol, ?trailer: Array[String], ?content_length: Integer, payload: Enumerable[header_pair], ?padding: Integer }
+  type push_promise_frame = { type: :push_promise, promise_stream: Integer, flags: frame_control_flags, ?method: Symbol, ?trailer: Array[String], ?content_length: Integer, payload: Enumerable[header_pair], ?padding: Integer }
 
   # # SETTINGS
-  # type settings_frame = { type: :settings, stream: 0, payload: Array[[Symbol | Integer, Integer]] }
+  type settings_frame = { type: :settings, payload: Array[[Symbol | Integer, Integer]] }
 
   # # WINDOW_UPDATE
-  # type window_update_frame = { type: :window_update, stream: Integer, increment: Integer }
+  type window_update_frame = { type: :window_update, increment: Integer }
 
   # # PRIORITY
-  type priority_frame = { type: :priority, stream: Integer, dependency: Integer, exclusive: bool, weight: Integer }
+  type priority_frame = { dependency: Integer, exclusive: bool, weight: Integer }
 
   # # ALTSVC
-  # type altsvc_frame = { type: :altsvc, stream: 0, max_age: Integer, port: Integer, proto: "String", host: String }
+  type altsvc_frame = { type: :altsvc, max_age: Integer, port: Integer, proto: "String", host: String }
 
   # # ORIGIN
-  # type origin_frame = { type: :origin, stream: 0, origin: Array[String] }
+  type origin_frame = { type: :origin, origin: Array[String] }
 
   # # PING
-  # type ping_frame = { type: :ping, payload: String, length: Integer }
+  type ping_frame = { type: :ping, payload: String, length: Integer }
 
   # # GOAWAY
-  # type goaway_frame = { type: :goaway, stream: 0, last_stream: Integer, error: Symbol? }
+  type goaway_frame = { type: :goaway, last_stream: Integer, error: Symbol? }
 
-  # type frame = headers_frame | data_frame | push_promise_frame |
+  # type frame = common_frame & (headers_frame | data_frame | push_promise_frame |
   #              settings_frame | window_update_frame | priority_frame | altsvc_frame |
-  #              origin_frame | ping_frame | goaway_frame
+  #              origin_frame | ping_frame | goaway_frame)
 
   type frame_key = :type | :flags | :stream | :padding | :ignore |
                    # headers

data/sig/client.rbs

@@ -1,5 +1,7 @@
 module HTTP2
   class Client < Connection
+    @h2c_upgrade: Symbol?
+
     def upgrade: () -> Stream
 
     def send_connection_preface: () -> void

data/sig/connection.rbs

@@ -2,10 +2,18 @@ module HTTP2
   class Connection
     include FlowBuffer
     include Emitter
+    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
@@ -21,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
 
@@ -39,6 +51,7 @@ module HTTP2
     @recv_buffer: String
     @continuation: Array[frame]
 
+    @h2c_upgrade: Symbol?
     @closed_since: Float?
     @received_frame: bool
 
@@ -53,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
 
@@ -72,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,15 @@
 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
+
+    def shift_byte: (String str) -> Integer
+  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,6 +1,8 @@
 module HTTP2
   class Framer
+    include Error
     include PackingExtensions
+    include BufferUtils
 
     DEFAULT_MAX_FRAME_SIZE: Integer
 
@@ -10,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]]
@@ -37,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

@@ -1,6 +1,10 @@
 module HTTP2
   module Header
     class Decompressor
+      include BufferUtils
+
+      FORBIDDEN_HEADERS: Array[String]
+
       @cc: EncodingContext
 
       def table_size=: (Integer) -> void
@@ -15,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.1
+  version: 1.1.0
 platform: ruby
 authors:
 - Tiago Cardoso
 - Ilya Grigorik
 - Kaoru Maeda
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-07-26 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: []