websocket_client.h

Go to the documentation of this file.

 
#ifndef KEEL_WEBSOCKET_CLIENT_H
#define KEEL_WEBSOCKET_CLIENT_H
 
#include <keel/allocator.h>
#include <keel/event_ctx.h>
#include <keel/tls.h>
#include <keel/websocket.h>
 
/* ── Defaults ────────────────────────────────────────────────────── */
 
#define KL_WS_CLIENT_DEFAULT_TIMEOUT_MS   30000
#define KL_WS_CLIENT_RECV_BUF_SIZE        8192
#define KL_WS_CLIENT_DEFAULT_MAX_FRAME    (16 * 1024 * 1024)
#define KL_WS_CLIENT_KEY_B64_SIZE         25
#define KL_WS_CLIENT_UPGRADE_BUF_INIT     512
 
/* ── Types ───────────────────────────────────────────────────────── */
 
typedef struct KlWsClientConn KlWsClientConn;
 
typedef struct {
    int          timeout_ms;       
    size_t       max_frame_size;   
    KlTlsConfig *tls;             
    const char  *protocol;        
    int          ping_interval_ms;  
} KlWsClientConfig;
 
typedef struct {
    void (*on_open)(KlWsClientConn *ws, void *user_data);             
    void (*on_message)(KlWsClientConn *ws, const char *data, size_t len,
                       int is_binary, void *user_data);                
    void (*on_close)(KlWsClientConn *ws, uint16_t code,
                     const char *reason, size_t reason_len, void *user_data); 
    void (*on_error)(KlWsClientConn *ws, const char *msg, void *user_data);   
} KlWsClientCallbacks;
 
/* ── Public API ──────────────────────────────────────────────────── */
 
KlWsClientConn *kl_ws_client_connect(KlEventCtx *ev, KlAllocator *alloc,
                                      const KlWsClientConfig *cfg,
                                      const char *url,
                                      const KlWsClientCallbacks *cbs,
                                      void *user_data);
 
int   kl_ws_client_send_text(KlWsClientConn *ws, const char *data, size_t len);
 
int   kl_ws_client_send_binary(KlWsClientConn *ws, const char *data, size_t len);
 
int   kl_ws_client_send_ping(KlWsClientConn *ws, const char *data, size_t len);
 
void  kl_ws_client_close(KlWsClientConn *ws, uint16_t code,
                          const char *reason, size_t reason_len);
 
void  kl_ws_client_free(KlWsClientConn *ws);
 
#endif