connectrpc-async 0.1.0

data/sig/connectrpc-async.rbs

@@ -0,0 +1,165 @@
+module ConnectRPC
+  module Async
+    VERSION: String
+    type tls = { certificate_chain: Array[String], private_key: String, client_ca: Array[String]? }
+    type tls_snapshot = { version: String, certificate_chain: Array[String], private_key: String, client_ca: Array[String]? }
+    type tls_category = :invalid | :source | :version_conflict | :timeout | :closed
+    type tls_status = { state: :new | :starting | :running | :closing | :closed, generation: Integer?, category: tls_category?, source_check_age: Float?, publication_age: Float? }
+    type tls_event = { category: tls_category, status: tls_status }
+    interface _TLSProvider
+      def call: () -> tls_snapshot
+    end
+    interface _TLSErrorHandler
+      def call: (tls_event) -> void
+    end
+    interface _Callback
+      def call: () -> void
+    end
+    interface _Headers
+      def header: () -> Enumerator[[String, String], Array[[String, String]]]
+    end
+    interface _Body
+      def read: () -> String?
+      def length: () -> Integer?
+      def close: (?Exception?) -> void
+    end
+    interface _Request
+      def path: () -> String
+      def method: () -> String
+      def headers: () -> _Headers
+      def body: () -> _Body?
+    end
+    interface _Response
+      def status: () -> Integer
+      def headers: () -> _Headers
+      def body: () -> _Body?
+      def body=: (_Body?) -> _Body?
+    end
+    interface _Application
+      def call: (_Request, ?lifecycle: Instrumentation::Handle?) -> _Response?
+    end
+    interface _LifecycleFactory
+      def call: (_Request) -> Instrumentation::Handle?
+    end
+    # A scheduled task is opaque apart from its supported wait/stop operations.
+    interface _Task
+      def wait: () -> top
+      def stop: () -> void
+    end
+    interface _Socket
+      def close: () -> void
+      def closed?: () -> bool
+      def remote_address: () -> Addrinfo
+    end
+    interface _Accepted
+      def serve: () -> void
+      def close: () -> void
+      def wait_closed: () -> nil
+      def timeout=: (Numeric?) -> Numeric?
+      def remote_address: () -> Addrinfo
+    end
+    class Application
+      def initialize: (server: Server, ?fallback: (_Application | ^(_Request) -> _Response?)?) -> void
+      def start_call: (_Request) -> Instrumentation::Handle?
+      def call: (_Request, ?lifecycle: Instrumentation::Handle?) -> _Response?
+    end
+    class TLSConfiguration
+      class Error < ArgumentError
+        def initialize: (tls_category) -> void
+        attr_reader category: tls_category
+      end
+      def initialize: (?tls: tls?, ?tls_provider: (_TLSProvider | ^() -> tls_snapshot)?, ?refresh_interval: Numeric, ?refresh_jitter: Numeric, ?refresh_timeout: Numeric, ?on_error: (_TLSErrorHandler | ^(tls_event) -> void)?, ?alpn_protocols: Array[String]) -> void
+      attr_reader generation: Integer?
+      def status: () -> tls_status
+      def start: () -> self
+      def refresh: () -> Integer
+      def reload: (certificate_chain: Array[String], private_key: String, client_ca: Array[String]?) -> Integer
+      def close: () -> self
+    end
+    class Host
+      def initialize: (server: Server, ?host: String, ?port: Integer, ?tls: tls?, ?tls_provider: (_TLSProvider | ^() -> tls_snapshot)?, ?max_connections: Integer, ?max_requests: Integer, ?handshake_timeout: Numeric, ?idle_timeout: Numeric?, ?refresh_interval: Numeric, ?refresh_jitter: Numeric, ?refresh_timeout: Numeric, ?on_tls_error: (_TLSErrorHandler | ^(tls_event) -> void)?) -> void
+      attr_reader port: Integer?
+      attr_reader addresses: Array[Addrinfo]
+      def start: () -> self
+      def wait: () -> nil
+      def close: (?grace: Numeric) -> bool?
+      def reload_tls: (certificate_chain: Array[String], private_key: String, client_ca: Array[String]?) -> Integer
+      def refresh_tls: () -> Integer
+      def drain_tls: (?grace: Numeric) -> bool
+      def tls_generation: () -> Integer?
+      def tls_status: () -> tls_status
+      def peer_certificate: () -> OpenSSL::X509::Certificate?
+    end
+    type connection_state = :idle | :connecting | :ready | :transient_failure | :closing | :closed
+    type connection_outcome = :ready | :refused | :timeout | :tls | :protocol | :closed | :other
+    class Backoff
+      def initialize: (?base: Numeric, ?multiplier: Numeric, ?jitter: Numeric, ?max: Numeric) -> void
+      attr_reader base: Numeric
+      attr_reader multiplier: Numeric
+      attr_reader jitter: Numeric
+      attr_reader max: Numeric
+      def ==: (untyped other) -> bool
+      def eql?: (untyped other) -> bool
+      def hash: () -> Integer
+    end
+    class ConnectionPolicy
+      def initialize: (?backoff: Backoff?, ?wait_for_ready: bool, ?max_pending_bytes: Integer?) -> void
+      attr_reader backoff: Backoff?
+      attr_reader wait_for_ready: bool
+      attr_reader max_pending_bytes: Integer?
+      def ==: (untyped other) -> bool
+      def eql?: (untyped other) -> bool
+      def hash: () -> Integer
+    end
+    # Frozen observation values, delivered on the owner reactor.
+    class ConnectionEvent
+      attr_reader type: :state_changed | :attempt_finished | :admission_rejected
+      attr_reader state: connection_state
+      attr_reader previous_state: connection_state?
+      attr_reader outcome: connection_outcome?
+      attr_reader duration: Float?
+      attr_reader active: Integer
+      attr_reader draining: Integer
+      attr_reader pending_calls: Integer
+      attr_reader pending_bytes: Integer
+    end
+    interface _ConnectionObserver
+      def call: (ConnectionEvent) -> void
+    end
+    class Transport
+      def initialize: (origin: String, ?ca_file: String?, ?certificate_chain: Array[String]?, ?private_key: String?, ?connection_limit: Integer, ?max_requests: Integer, ?connect_timeout: Numeric, ?connection_policy: ConnectionPolicy, ?connection_observer: (_ConnectionObserver | ^(ConnectionEvent) -> void)?) -> void
+      def connection_state: () -> connection_state
+      def grpc_capabilities: () -> Array[grpc_cardinality]
+    def open_grpc_stream: [T] (StreamRequest) { (_GRPCStreamExchange) -> T } -> T
+    def streaming_capabilities: () -> Array[streaming_cardinality]
+      def open_stream: [T] (StreamRequest) { (_StreamExchange) -> T } -> T
+      def call: (TransportRequest) -> TransportResponse
+      def close: (?grace: Numeric) -> bool
+    end
+    class HTTP1Transport
+      def initialize: (origin: String, ?ca_file: String?, ?certificate_chain: Array[String]?, ?private_key: String?, ?connection_limit: Integer, ?max_requests: Integer, ?connect_timeout: Numeric) -> void
+      def streaming_capabilities: () -> Array[:server_stream | :client_stream]
+      def open_stream: [T] (StreamRequest) { (_StreamExchange) -> T } -> T
+      def call: (TransportRequest) -> TransportResponse
+      def close: (?grace: Numeric) -> bool
+    end
+    class ServerSession
+      # http1 is a backend resource-construction boundary, deliberately opaque.
+      interface _HTTP1Factory
+        def call: (Object, progress: Object, generation: Integer?) -> Object
+      end
+      def initialize: (application: _Application | ^(_Request, ?lifecycle: Instrumentation::Handle?) -> _Response?, ?tls: tls?, ?tls_provider: (_TLSProvider | ^() -> tls_snapshot)?, ?max_connections: Integer, ?max_requests: Integer, ?handshake_timeout: Numeric, ?idle_timeout: Numeric?, ?refresh_interval: Numeric, ?refresh_jitter: Numeric, ?refresh_timeout: Numeric, ?on_tls_error: (_TLSErrorHandler | ^(tls_event) -> void)?, ?alpn_protocols: Array[String], ?http1: _HTTP1Factory?, ?stop_accepting: (_Callback | ^() -> void)?, ?on_request_rejected: (_Callback | ^() -> void)?, ?lifecycle_factory: (_LifecycleFactory | ^(_Request) -> Instrumentation::Handle?)?) -> void
+      def start: () -> self
+      def close: (?grace: Numeric) -> bool?
+      def abort: () -> self
+      def accept: (_Socket) -> _Accepted?
+      def schedule: () { (_Task) -> top } -> _Task
+      def reload_tls: (certificate_chain: Array[String], private_key: String, client_ca: Array[String]?) -> Integer
+      def refresh_tls: () -> Integer
+      def drain_tls: (?grace: Numeric) -> bool
+      def tls_generation: () -> Integer?
+      def tls_status: () -> tls_status
+      def peer_certificate: () -> OpenSSL::X509::Certificate?
+    end
+  end
+end

data/sig/manifest.yaml

@@ -0,0 +1,4 @@
+dependencies:
+  - name: connectrpc
+  - name: openssl
+  - name: socket

metadata

@@ -0,0 +1,202 @@
+--- !ruby/object:Gem::Specification
+name: connectrpc-async
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- jimeh
+bindir: bin
+cert_chain: []
+date: 2026-11-15 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: connectrpc
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.0
+- !ruby/object:Gem::Dependency
+  name: async-http
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.105.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.105.0
+- !ruby/object:Gem::Dependency
+  name: async
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.46.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.46.0
+- !ruby/object:Gem::Dependency
+  name: async-pool
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.12.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.12.0
+- !ruby/object:Gem::Dependency
+  name: protocol-http2
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.29.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.29.2
+- !ruby/object:Gem::Dependency
+  name: protocol-http1
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.41.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.41.1
+- !ruby/object:Gem::Dependency
+  name: protocol-http
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.72.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.72.1
+- !ruby/object:Gem::Dependency
+  name: io-endpoint
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.19.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.19.0
+- !ruby/object:Gem::Dependency
+  name: io-stream
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.14.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.14.0
+- !ruby/object:Gem::Dependency
+  name: openssl
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 4.0.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 4.0.2
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- lib/connectrpc/async.rb
+- lib/connectrpc/async/application.rb
+- lib/connectrpc/async/completion_join.rb
+- lib/connectrpc/async/connection.rb
+- lib/connectrpc/async/connection_manager.rb
+- lib/connectrpc/async/connection_policy.rb
+- lib/connectrpc/async/host.rb
+- lib/connectrpc/async/http1_connection.rb
+- lib/connectrpc/async/http1_exchange.rb
+- lib/connectrpc/async/http1_stream.rb
+- lib/connectrpc/async/http1_transport.rb
+- lib/connectrpc/async/ingress.rb
+- lib/connectrpc/async/internal.rb
+- lib/connectrpc/async/server_session.rb
+- lib/connectrpc/async/stream_exchange.rb
+- lib/connectrpc/async/tls.rb
+- lib/connectrpc/async/tls_configuration.rb
+- lib/connectrpc/async/transport.rb
+- lib/connectrpc/async/version.rb
+- sig/connectrpc-async.rbs
+- sig/manifest.yaml
+homepage: https://github.com/jimeh/connectrpc-ruby
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.4'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: Optional Async host and HTTP/1.1 and HTTP/2 ConnectRPC transports
+test_files: []