(sigil websocket connection)

Construct a ws-connection struct.

Test if a value is a ws-connection struct.

Get the socket field of a ws-connection struct.

Get the state field of a ws-connection struct.

Get the url field of a ws-connection struct.

Get the host field of a ws-connection struct.

Get the buffer field of a ws-connection struct.

Get the fragments field of a ws-connection struct.

Set the state field of a ws-connection struct.

Set the buffer field of a ws-connection struct.

Set the fragments field of a ws-connection struct.

Set the fragments field of a ws-connection struct.

Construct a ws-message struct.

Test if a value is a ws-message struct.

Get the type field of a ws-message struct.

Get the data field of a ws-message struct.

Parse WebSocket URL into components Returns (scheme host port path) or #f on error

Generate random 16-byte key and base64 encode

Calculate expected Sec-WebSocket-Accept value

Build HTTP upgrade request

Parse HTTP response status line Returns status code or #f

Extract header value (case-insensitive)

Read HTTP response and validate handshake Returns #t on success, #f on failure

Write to socket (handles both TCP and TLS)

Read from socket (handles both TCP and TLS)

Close socket (handles both TCP and TLS)

Set socket to non-blocking mode (handles both TCP and TLS)

Connect to a WebSocket server url: WebSocket URL (ws:// or wss://) Returns ws-connection on success, #f on failure

Check if connection is open

Send a text message

Send a binary message

Send a ping frame

Receive a message (with async I/O support) Returns ws-message, 'closed, or #f on error When running in async scheduler, yields while waiting for data.

Internal: Read data and try to decode a message Returns ws-message, 'closed, 'need-more, or #f on error

Try to decode a complete message from buffer Returns ws-message, 'closed, 'need-more, or #f on error

Process a decoded frame Returns ws-message, 'closed, 'need-more, or #f on error

Close the WebSocket connection