WebSocketProvider.h

Go to the documentation of this file.

// Copyright (c) 2025 Dave R. Smith.
// Malena Framework — Licensed under PolyForm Noncommercial 1.0.0; commercial use requires a paid license. See LICENSE.
 
#ifndef MALENA_WEBSOCKET_PROVIDER_H
#define MALENA_WEBSOCKET_PROVIDER_H
 
#pragma once
 
#include <Malena/Providers/NetworkDispatcher.h>
#include <Malena/Engine/Networking/WebSocketClient.h>
#include <functional>
#include <string>
 
namespace ml
{
    class MALENA_API WebSocketProvider : public NetworkDispatcher
    {
    public:
        explicit WebSocketProvider(const std::string& keyField = "type");
 
        // ── Connection ───────────────────────────────────────────────────────

        void connect(const std::string& url);

        void disconnect();

        void send(const json& msg);

        void send(const std::string& text);
 
        // ── Lifecycle callbacks ──────────────────────────────────────────────

        void onOpen(std::function<void()> callback);

        void onClose(std::function<void(int, const std::string&)> callback);

        void onError(std::function<void(const std::string&)> callback);
 
        // ── Reconnection ─────────────────────────────────────────────────────

        void setReconnectDelay(int seconds);

        void setMaxReconnectAttempts(int n);
 
    private:
        WebSocketClient _ws;
    };
 
} // namespace ml
 
#endif // MALENA_WEBSOCKET_PROVIDER_H