Api-WebSocketClient.h

/* Copyright (C) 2026 by Marc Boris Duerner
   SPDX-License-Identifier: LGPL-2.1-or-later WITH mif-exception
*/
 
#ifndef PT_HTTP_API_WEBSOCKETCLIENT_H
#define PT_HTTP_API_WEBSOCKETCLIENT_H
)
    {
    }
 
    Pt::System::MainLoop loop;
    Pt::Net::Endpoint ep("localhost", 80);
    Pt::Http::Client client(loop, ep);
    Pt::Http::WebSocket socket(client);
    socket.connected() += Pt::slot(onConnected);
    socket.closed() += Pt::slot(onClosed);
    socket.setTimeout(10000);
    socket.beginConnect("/ws");
    loop.run();
    @endcode
 
    Construct %WebSocket with the %Client that performs the
    handshake. Connect %connected() and call %beginConnect() with a
    request path, or with a %ws:// URL whose host and port are
    already the client's endpoint. The path and query of that URL
    become the request URL; the client does not take the host from
    the URL. The optional second argument is the Origin header.
    %beginConnect() fills a GET with Connection, Upgrade,
    Sec-WebSocket-Version 13 and Sec-WebSocket-Key, and sends it
    through the client. A finished 101 becomes the stream this
    socket formats. %endConnect() completes the handshake and throws
    if it failed. After that success the socket no longer uses the
    client for messages. A client masks every frame it writes.
 
    %closed() is emitted while this socket is still alive. The
    stream has already cleared its session pointer. Peer close, an
    I/O error, a close frame and destruction of the stream all emit
    it. It ends an outstanding send or receive. The owner deletes
    this socket. %setTimeout() bounds I/O after the upgrade. The
    handshake still uses the timeout of the client.
*/
 
#endif