Crate moosicbox_tunnel 

Tunneling protocol for HTTP and WebSocket requests over persistent connections.

This crate provides types and utilities for tunneling HTTP and WebSocket requests through a persistent connection, enabling bidirectional communication between clients and servers. The tunnel protocol supports request streaming, packet ordering, and multiple encoding formats.

Main Components

• TunnelRequest - Tagged enum for HTTP, WebSocket, or abort requests
• TunnelHttpRequest - HTTP request metadata and payload
• TunnelWsRequest - WebSocket request metadata and payload
• TunnelResponse - Response packets with headers, status, and body bytes
• TunnelStream - Async stream of response packets for a request
• TunnelEncoding - Encoding format for response data (binary or base64)

Features

• base64 (default) - Enables base64 encoding support for text-safe transmission

Structs

TunnelAbortRequest

Request to abort an in-progress tunnel request.

TunnelHttpRequest

HTTP request sent through the tunnel.

TunnelResponse

Response packet from a tunnel HTTP request.

TunnelStream

Stream of tunnel response packets.

TunnelWsRequest

WebSocket request sent through the tunnel.

TunnelWsResponse

Response for a WebSocket tunnel request.

Enums

Base64DecodeError

Errors that can occur when decoding base64-encoded tunnel responses.

TryFromBytesError

Errors that can occur when converting bytes to a tunnel response.

TunnelEncoding

Encoding format for tunnel response data.

TunnelRequest

Request sent through the tunnel.

TunnelStreamError

Errors that can occur when streaming tunnel responses.