grpc-dc 0.37.1

data/lib/grpcdc/events_pb.rb

@@ -0,0 +1,432 @@
+# Generated code: use without restriction (see GENERATED-CODE-LICENSE.md).
+module EventsPb
+# @generated by protoc-gen-grpc-dc-ruby. DO NOT EDIT.
+EventsPbVarint = lambda do |value|
+  out = +"".b
+  v = value & 0xffffffffffffffff
+  while v > 0x7f
+    out << ((v & 0x7f) | 0x80)
+    v >>= 7
+  end
+  out << v
+  out
+end
+
+  class Writer
+    def initialize
+      @out = String.new(encoding: Encoding::BINARY)
+    end
+
+    def varint(value)
+      @out << EventsPbVarint.call(value)
+    end
+
+    def tag(field, wire)
+      varint((field << 3) | wire)
+    end
+
+    def bytes_field(field, payload)
+      tag(field, 2)
+      varint(payload.bytesize)
+      @out << payload.b
+    end
+
+    def string_field(field, value)
+      return if value.nil? || value.empty?
+
+      bytes_field(field, value.encode(Encoding::UTF_8).b)
+    end
+
+    def fixed(fmt, value)
+      @out << [value].pack(fmt)
+    end
+
+    def raw(payload)
+      @out << payload.b
+    end
+
+    def to_bytes
+      @out
+    end
+  end
+
+  class Reader
+    def initialize(buf)
+      @buf = buf.b
+      @pos = 0
+    end
+
+    def done?
+      @pos >= @buf.bytesize
+    end
+
+    def varint
+      result = 0
+      shift = 0
+      loop do
+        raise ArgumentError, "truncated varint" if @pos >= @buf.bytesize
+
+        b = @buf.getbyte(@pos)
+        @pos += 1
+        result |= (b & 0x7f) << shift
+        return result if (b & 0x80).zero?
+
+        shift += 7
+        raise ArgumentError, "varint too long" if shift >= 70
+      end
+    end
+
+    def take(n)
+      raise ArgumentError, "truncated field" if @pos + n > @buf.bytesize
+
+      value = @buf.byteslice(@pos, n)
+      @pos += n
+      value
+    end
+
+    # [number, wire, varint_value, bytes_value, fixed_value] or nil.
+    def field
+      return nil if done?
+
+      start = @pos
+      tag = varint
+      num = tag >> 3
+      wire = tag & 7
+      raw = -> { @buf.byteslice(start, @pos - start) }
+      case wire
+      when 0 then [num, wire, varint, "".b, "".b, raw.call]
+      when 2
+        n = varint
+        v = take(n)
+        [num, wire, 0, v, "".b, raw.call]
+      when 1
+        v = take(8)
+        [num, wire, 0, "".b, v, raw.call]
+      when 5
+        v = take(4)
+        [num, wire, 0, "".b, v, raw.call]
+      else raise ArgumentError, "bad wire type"
+      end
+    end
+  end
+
+  module Tag
+    TAG_UNSPECIFIED = 0
+    TOPIC = 1
+    SOURCE = 2
+    KIND = 3
+  end
+
+  class TagValue
+    attr_accessor :tag, :string_value, :int_value, :double_value, :bool_value, :enum_value, :unknown_fields
+
+    def initialize(tag: 0, string_value: "", int_value: 0, double_value: 0.0, bool_value: false, enum_value: 0)
+      @tag = tag
+      @string_value = string_value
+      @int_value = int_value
+      @double_value = double_value
+      @bool_value = bool_value
+      @enum_value = enum_value
+      @unknown_fields = "".b
+    end
+
+    def marshal_dc
+      w = Writer.new
+    if @tag != 0
+      w.tag(1, 0)
+      w.varint(@tag)
+    end
+    unless (@int_value != 0 || @double_value != 0 || @bool_value || @enum_value != 0)
+    w.string_field(2, @string_value)
+    end
+    unless (@double_value != 0 || @bool_value || @enum_value != 0)
+    if @int_value != 0
+      w.tag(3, 0)
+      w.varint(@int_value)
+    end
+    end
+    unless (@bool_value || @enum_value != 0)
+    if @double_value != 0
+      w.tag(4, 1)
+      w.fixed("E", @double_value)
+    end
+    end
+    unless (@enum_value != 0)
+    if @bool_value
+      w.tag(5, 0)
+      w.varint((@bool_value ? 1 : 0))
+    end
+    end
+    if @enum_value != 0
+      w.tag(6, 0)
+      w.varint(@enum_value)
+    end
+      w.raw(@unknown_fields)
+      w.to_bytes
+    end
+
+    def unmarshal_dc(data)
+      @unknown_fields = "".b
+      @tag = 0
+      @string_value = ""
+      @int_value = 0
+      @double_value = 0.0
+      @bool_value = false
+      @enum_value = 0
+      r = Reader.new(data)
+      loop do
+        item = r.field
+        break if item.nil?
+
+        num, wire, varint_value, bytes_value, fixed_value, raw_value = item
+        case num
+      when 1
+        @tag = (((varint_value & 0xffffffff) ^ 0x80000000) - 0x80000000)
+      when 2
+        @int_value = 0
+        @double_value = 0.0
+        @bool_value = false
+        @enum_value = 0
+        @string_value = bytes_value.dup.force_encoding(Encoding::UTF_8)
+      when 3
+        @string_value = ""
+        @double_value = 0.0
+        @bool_value = false
+        @enum_value = 0
+        @int_value = (((varint_value & 0xffffffffffffffff) ^ 0x8000000000000000) - 0x8000000000000000)
+      when 4
+        @string_value = ""
+        @int_value = 0
+        @bool_value = false
+        @enum_value = 0
+        @double_value = fixed_value.unpack1("E")
+      when 5
+        @string_value = ""
+        @int_value = 0
+        @double_value = 0.0
+        @enum_value = 0
+        @bool_value = (varint_value != 0)
+      when 6
+        @string_value = ""
+        @int_value = 0
+        @double_value = 0.0
+        @bool_value = false
+        @enum_value = (((varint_value & 0xffffffff) ^ 0x80000000) - 0x80000000)
+        else
+          @unknown_fields = @unknown_fields + raw_value
+        end
+      end
+      self
+    end
+
+    def ==(other)
+      other.is_a?(TagValue) && @tag == other.tag && @string_value == other.string_value && @int_value == other.int_value && @double_value == other.double_value && @bool_value == other.bool_value && @enum_value == other.enum_value
+    end
+  end
+
+  class PublishRequest
+    attr_accessor :tags, :payload, :publisher_id, :unknown_fields
+
+    def initialize(tags: [], payload: "".b, publisher_id: "")
+      @tags = tags
+      @payload = payload
+      @publisher_id = publisher_id
+      @unknown_fields = "".b
+    end
+
+    def marshal_dc
+      w = Writer.new
+    @tags.each { |x| w.bytes_field(1, x.marshal_dc) }
+    if @payload.bytesize > 0
+      w.bytes_field(2, @payload)
+    end
+    w.string_field(3, @publisher_id)
+      w.raw(@unknown_fields)
+      w.to_bytes
+    end
+
+    def unmarshal_dc(data)
+      @unknown_fields = "".b
+      @tags = []
+      @payload = "".b
+      @publisher_id = ""
+      r = Reader.new(data)
+      loop do
+        item = r.field
+        break if item.nil?
+
+        num, wire, varint_value, bytes_value, fixed_value, raw_value = item
+        case num
+      when 1
+        item = TagValue.new
+        item.unmarshal_dc(bytes_value)
+        @tags << item
+      when 2
+        @payload = bytes_value
+      when 3
+        @publisher_id = bytes_value.dup.force_encoding(Encoding::UTF_8)
+        else
+          @unknown_fields = @unknown_fields + raw_value
+        end
+      end
+      self
+    end
+
+    def ==(other)
+      other.is_a?(PublishRequest) && @tags == other.tags && @payload == other.payload && @publisher_id == other.publisher_id
+    end
+  end
+
+  class PublishReply
+    attr_accessor :seq, :unknown_fields
+
+    def initialize(seq: 0)
+      @seq = seq
+      @unknown_fields = "".b
+    end
+
+    def marshal_dc
+      w = Writer.new
+    if @seq != 0
+      w.tag(1, 0)
+      w.varint(@seq)
+    end
+      w.raw(@unknown_fields)
+      w.to_bytes
+    end
+
+    def unmarshal_dc(data)
+      @unknown_fields = "".b
+      @seq = 0
+      r = Reader.new(data)
+      loop do
+        item = r.field
+        break if item.nil?
+
+        num, wire, varint_value, bytes_value, fixed_value, raw_value = item
+        case num
+      when 1
+        @seq = (varint_value & 0xffffffffffffffff)
+        else
+          @unknown_fields = @unknown_fields + raw_value
+        end
+      end
+      self
+    end
+
+    def ==(other)
+      other.is_a?(PublishReply) && @seq == other.seq
+    end
+  end
+
+  class SubscribeRequest
+    attr_accessor :filter, :unknown_fields
+
+    def initialize(filter: [])
+      @filter = filter
+      @unknown_fields = "".b
+    end
+
+    def marshal_dc
+      w = Writer.new
+    @filter.each { |x| w.bytes_field(1, x.marshal_dc) }
+      w.raw(@unknown_fields)
+      w.to_bytes
+    end
+
+    def unmarshal_dc(data)
+      @unknown_fields = "".b
+      @filter = []
+      r = Reader.new(data)
+      loop do
+        item = r.field
+        break if item.nil?
+
+        num, wire, varint_value, bytes_value, fixed_value, raw_value = item
+        case num
+      when 1
+        item = TagValue.new
+        item.unmarshal_dc(bytes_value)
+        @filter << item
+        else
+          @unknown_fields = @unknown_fields + raw_value
+        end
+      end
+      self
+    end
+
+    def ==(other)
+      other.is_a?(SubscribeRequest) && @filter == other.filter
+    end
+  end
+
+  class Event
+    attr_accessor :tags, :payload, :seq, :publisher_id, :timestamp_unix_ms, :unknown_fields
+
+    def initialize(tags: [], payload: "".b, seq: 0, publisher_id: "", timestamp_unix_ms: 0)
+      @tags = tags
+      @payload = payload
+      @seq = seq
+      @publisher_id = publisher_id
+      @timestamp_unix_ms = timestamp_unix_ms
+      @unknown_fields = "".b
+    end
+
+    def marshal_dc
+      w = Writer.new
+    @tags.each { |x| w.bytes_field(1, x.marshal_dc) }
+    if @payload.bytesize > 0
+      w.bytes_field(2, @payload)
+    end
+    if @seq != 0
+      w.tag(3, 0)
+      w.varint(@seq)
+    end
+    w.string_field(4, @publisher_id)
+    if @timestamp_unix_ms != 0
+      w.tag(5, 0)
+      w.varint(@timestamp_unix_ms)
+    end
+      w.raw(@unknown_fields)
+      w.to_bytes
+    end
+
+    def unmarshal_dc(data)
+      @unknown_fields = "".b
+      @tags = []
+      @payload = "".b
+      @seq = 0
+      @publisher_id = ""
+      @timestamp_unix_ms = 0
+      r = Reader.new(data)
+      loop do
+        item = r.field
+        break if item.nil?
+
+        num, wire, varint_value, bytes_value, fixed_value, raw_value = item
+        case num
+      when 1
+        item = TagValue.new
+        item.unmarshal_dc(bytes_value)
+        @tags << item
+      when 2
+        @payload = bytes_value
+      when 3
+        @seq = (varint_value & 0xffffffffffffffff)
+      when 4
+        @publisher_id = bytes_value.dup.force_encoding(Encoding::UTF_8)
+      when 5
+        @timestamp_unix_ms = (((varint_value & 0xffffffffffffffff) ^ 0x8000000000000000) - 0x8000000000000000)
+        else
+          @unknown_fields = @unknown_fields + raw_value
+        end
+      end
+      self
+    end
+
+    def ==(other)
+      other.is_a?(Event) && @tags == other.tags && @payload == other.payload && @seq == other.seq && @publisher_id == other.publisher_id && @timestamp_unix_ms == other.timestamp_unix_ms
+    end
+  end
+
+end

data/lib/grpcdc/loopback.rb

@@ -0,0 +1,43 @@
+# @generated by grpc-dc codegen. DO NOT EDIT.
+# SPDX-License-Identifier: Apache-2.0
+# In-memory transport pair for tests (one queue per direction).
+
+require_relative "endpoint"
+
+module Grpcdc
+  class MemoryTransport < Transport
+    SENTINEL = Object.new
+
+    def initialize(inbox, outbox)
+      super()
+      @inbox = inbox
+      @outbox = outbox
+      @closed = false
+    end
+
+    def send(data)
+      raise EOFError, "transport closed" if @closed
+
+      @outbox << data.b.dup
+    end
+
+    def recv
+      item = @inbox.pop
+      raise EOFError, "transport closed" if item.equal?(SENTINEL)
+
+      item
+    end
+
+    def close
+      @closed = true
+      @inbox << SENTINEL
+    end
+  end
+
+  # Two connected in-memory transports.
+  def self.memory_transport_pair
+    a_to_b = Queue.new
+    b_to_a = Queue.new
+    [MemoryTransport.new(b_to_a, a_to_b), MemoryTransport.new(a_to_b, b_to_a)]
+  end
+end

data/lib/grpcdc/server.rb

@@ -0,0 +1,106 @@
+# @generated by grpc-dc codegen. DO NOT EDIT.
+# SPDX-License-Identifier: Apache-2.0
+# Server: dispatches inbound calls to registered methods.
+
+require_relative "codec"
+require_relative "endpoint"
+require_relative "wire_gen"
+
+module Grpcdc
+  KIND_UNARY = "unary"
+  KIND_SERVER_STREAMING = "server-streaming"
+  KIND_CLIENT_STREAMING = "client-streaming"
+  KIND_BIDI = "bidi"
+
+  # Reads request messages of one inbound call.
+  class RequestStream
+    def initialize(stream_input)
+      @input = stream_input
+    end
+
+    # Next request payload; EOFError at half-close.
+    def recv_raw
+      loop do
+        event = @input.get
+        raise StatusError.new(CODE_UNAVAILABLE, "data channel closed") if event.nil?
+
+        case event.kind
+        when EVENT_DATA
+          return event.payload
+        when EVENT_HALF_CLOSE
+          raise EOFError, "half-close"
+        when EVENT_TRAILERS, EVENT_RST
+          raise event.status
+        end
+      end
+    end
+
+    def recv_into(req)
+      req.unmarshal_dc(recv_raw)
+      req
+    end
+  end
+
+  class Method
+    attr_reader :name, :path, :kind, :handler
+
+    # handler: callable(ctx, RequestStream, sink) -> nil
+    def initialize(name, path, kind, handler)
+      @name = name
+      @path = path
+      @kind = kind
+      @handler = handler
+    end
+  end
+
+  class ServiceDesc
+    attr_reader :name, :methods
+
+    def initialize(name, methods)
+      @name = name
+      @methods = methods
+    end
+  end
+
+  # Dispatches inbound calls to registered methods.
+  class Server
+    def initialize
+      @methods = {}
+    end
+
+    def register_service(desc)
+      desc.methods.each { |method| @methods[method.path] = method }
+    end
+
+    # Attach to a transport (even stream ids); returns Endpoint.
+    def serve_transport(transport)
+      endpoint = Endpoint.new(transport, creator: false)
+      serve_endpoint(endpoint)
+      endpoint
+    end
+
+    def serve_endpoint(endpoint)
+      endpoint.set_dispatcher(method(:dispatch))
+      endpoint.start
+    end
+
+    private
+
+    def dispatch(ctx, headers, stream_input, sink)
+      method = @methods[headers.path]
+      if method.nil?
+        return StatusError.new(CODE_UNIMPLEMENTED, "unknown method #{headers.path}")
+      end
+
+      trace_ctx = Grpcdc.trace_start("server", headers.path, Grpcdc.parse_traceparent((headers.metadata || {})["traceparent"]))
+      result = nil
+      begin
+        method.handler.call(ctx, RequestStream.new(stream_input), sink)
+      rescue StandardError => e # StatusError passes through via to_status
+        result = Grpcdc.to_status(e)
+      end
+      Grpcdc.trace_end("server", headers.path, trace_ctx, result.nil? ? "OK" : Grpcdc.status_name(result.code))
+      result
+    end
+  end
+end

data/lib/grpcdc/sidecar.rb

@@ -0,0 +1,63 @@
+# @generated by grpc-dc codegen. DO NOT EDIT.
+# SPDX-License-Identifier: Apache-2.0
+# Transport over the Rust WebRTC-Direct sidecar: the sidecar
+# owns DTLS/SCTP/TURN and bridges one datachannel to a local
+# TCP socket using u32 big-endian length-prefixed messages
+# (one prefix per DataChannel message). Stdlib only.
+
+require "socket"
+require_relative "endpoint"
+
+module Grpcdc
+  class SidecarTransport < Transport
+    def initialize(sock)
+      super()
+      @sock = sock
+      @buf = +"".b
+      @closed = false
+    end
+
+    def self.connect(host, port)
+      new(TCPSocket.new(host, port))
+    end
+
+    def self.from_socket(sock)
+      new(sock)
+    end
+
+    def send(data)
+      raise EOFError, "transport closed" if @closed
+
+      payload = data.b
+      @sock.write([payload.bytesize].pack("N") + payload)
+    end
+
+    def recv
+      fill(4)
+      length = @buf.unpack1("N")
+      @buf = @buf.byteslice(4..) || +"".b
+      fill(length)
+      payload = @buf.byteslice(0, length) || +"".b
+      @buf = @buf.byteslice(length..) || +"".b
+      payload
+    end
+
+    def close
+      @closed = true
+      @sock.close
+    rescue IOError
+      nil
+    end
+
+    private
+
+    def fill(need)
+      while @buf.bytesize < need
+        chunk = @sock.readpartial(65_536)
+        raise EOFError, "transport closed" if chunk.nil? || chunk.empty?
+
+        @buf << chunk.b
+      end
+    end
+  end
+end

data/lib/grpcdc/wire_gen.rb

@@ -0,0 +1,58 @@
+# SPDX-License-Identifier: Apache-2.0
+# @generated by grpc-dc codegen. DO NOT EDIT.
+
+# Frame type bytes and gRPC status codes (SPEC.md).
+
+module Grpcdc
+  FRAME_HEADERS = 1  # call headers, JSON {path, metadata}
+  FRAME_DATA = 2  # one serialized protobuf message
+  FRAME_TRAILERS = 3  # terminal status, JSON {code, message}
+  FRAME_HALF_CLOSE = 4  # client finished sending
+  FRAME_RST = 5  # abort stream, JSON {code, message}
+
+  CODE_OK = 0
+  CODE_CANCELLED = 1
+  CODE_UNKNOWN = 2
+  CODE_INVALID_ARGUMENT = 3
+  CODE_DEADLINE_EXCEEDED = 4
+  CODE_NOT_FOUND = 5
+  CODE_ALREADY_EXISTS = 6
+  CODE_PERMISSION_DENIED = 7
+  CODE_RESOURCE_EXHAUSTED = 8
+  CODE_FAILED_PRECONDITION = 9
+  CODE_ABORTED = 10
+  CODE_OUT_OF_RANGE = 11
+  CODE_UNIMPLEMENTED = 12
+  CODE_INTERNAL = 13
+  CODE_UNAVAILABLE = 14
+  CODE_DATA_LOSS = 15
+  CODE_UNAUTHENTICATED = 16
+
+  FRAME_NAMES = {
+    "HEADERS" => 1,
+    "DATA" => 2,
+    "TRAILERS" => 3,
+    "HALF-CLOSE" => 4,
+    "RST" => 5,
+  }.freeze
+
+  STATUS_NAMES = {
+    0 => "OK",
+    1 => "CANCELLED",
+    2 => "UNKNOWN",
+    3 => "INVALID-ARGUMENT",
+    4 => "DEADLINE-EXCEEDED",
+    5 => "NOT-FOUND",
+    6 => "ALREADY-EXISTS",
+    7 => "PERMISSION-DENIED",
+    8 => "RESOURCE-EXHAUSTED",
+    9 => "FAILED-PRECONDITION",
+    10 => "ABORTED",
+    11 => "OUT-OF-RANGE",
+    12 => "UNIMPLEMENTED",
+    13 => "INTERNAL",
+    14 => "UNAVAILABLE",
+    15 => "DATA-LOSS",
+    16 => "UNAUTHENTICATED",
+  }.freeze
+end

data/lib/grpcdc.rb

@@ -0,0 +1,12 @@
+# @generated by grpc-dc codegen. DO NOT EDIT.
+# SPDX-License-Identifier: Apache-2.0
+# grpcdc: gRPC over WebRTC DataChannels (generated runtime).
+
+require_relative "grpcdc/wire_gen"
+require_relative "grpcdc/codec"
+require_relative "grpcdc/endpoint"
+require_relative "grpcdc/channel"
+require_relative "grpcdc/server"
+require_relative "grpcdc/loopback"
+require_relative "grpcdc/sidecar"
+require_relative "grpcdc/dynamic"