ANSCMSCORE/anscloud-gateway/include/anscloud/gateway/gateway_agent.h

#pragma once
#ifndef ANSCLOUD_GATEWAY_AGENT_H
#define ANSCLOUD_GATEWAY_AGENT_H

#include <anscloud/common/types.h>
#include <anscloud/common/i_message_broker.h>
#include <string>
#include <functional>
#include <memory>
#include <vector>
#include <future>

#ifdef ANSCLOUD_GATEWAY_EXPORTS
  #define ANSCLOUD_GATEWAY_API __declspec(dllexport)
#else
  #define ANSCLOUD_GATEWAY_API __declspec(dllimport)
#endif

namespace anscloud {

//=============================================================================
// Gateway Configuration
//=============================================================================
struct GatewayCredentials {
    std::string username;
    std::string password;
    std::string vhost = "/";
};

struct GatewayAgentConfig {
    BrokerConfig       broker;
    GatewayCredentials credentials;
    int  device_timeout_seconds         = 90;
    int  default_command_timeout_seconds = 30;
    int  max_pending_commands           = 1000;
};

struct GatewayStats {
    uint64_t commands_sent       = 0;
    uint64_t commands_responded  = 0;
    uint64_t commands_timed_out  = 0;
    uint64_t telemetry_received  = 0;
    uint64_t events_received     = 0;
    uint64_t heartbeats_received = 0;
    int      devices_online      = 0;
    int      devices_total       = 0;
    int      pending_commands    = 0;
    uint64_t uptime_seconds      = 0;
};

struct BatchResult {
    std::vector<std::pair<std::string, CommandResult>> results;  // device_id -> result
    int succeeded = 0;
    int failed    = 0;
    int timed_out = 0;
};

//=============================================================================
// GatewayAgent - CMS gateway for consuming device messages & sending commands
//
//   GatewayAgent gw([](){ return std::make_unique<MyRabbitMQBroker>(); });
//   gw.configure(config);
//   gw.on_telemetry([](const DeviceTelemetry& t){ /* store */ });
//   gw.on_event([](const DeviceEvent& e){ /* process */ });
//   gw.start();
//
//   auto result = gw.send_command("AIBOX-001", CommandType::GetConfig);
//
//=============================================================================
class ANSCLOUD_GATEWAY_API GatewayAgent {
public:
    explicit GatewayAgent(BrokerFactory factory);
    ~GatewayAgent();

    GatewayAgent(const GatewayAgent&) = delete;
    GatewayAgent& operator=(const GatewayAgent&) = delete;
    GatewayAgent(GatewayAgent&&) noexcept;
    GatewayAgent& operator=(GatewayAgent&&) noexcept;

    //--- Configuration -------------------------------------------------------
    void configure(const GatewayAgentConfig& config);

    //--- Lifecycle -----------------------------------------------------------
    bool start();
    void stop();
    bool is_running() const;
    bool is_connected() const;

    //--- Commands (synchronous RPC) ------------------------------------------
    CommandResult send_command(const std::string& device_id,
                               CommandType type,
                               const std::string& params_json = "{}",
                               int timeout_seconds = 0);  // 0 = use default

    std::future<CommandResult> send_command_async(const std::string& device_id,
                                                   CommandType type,
                                                   const std::string& params_json = "{}",
                                                   int timeout_seconds = 0);

    CommandResult send_custom_command(const std::string& device_id,
                                      const std::string& custom_type,
                                      const std::string& params_json = "{}",
                                      int timeout_seconds = 0);

    void send_command_fire_and_forget(const std::string& device_id,
                                      CommandType type,
                                      const std::string& params_json = "{}");

    BatchResult send_batch_command(const std::vector<std::string>& device_ids,
                                   CommandType type,
                                   const std::string& params_json = "{}",
                                   int timeout_seconds = 0);

    void send_broadcast(const std::string& message);

    //--- Device tracking -----------------------------------------------------
    std::vector<DeviceState> get_all_devices() const;
    DeviceState get_device(const std::string& device_id) const;
    std::vector<DeviceState> get_online_devices() const;
    bool is_device_online(const std::string& device_id) const;

    //--- Callbacks -----------------------------------------------------------
    using TelemetryCallback    = std::function<void(const DeviceTelemetry&)>;
    using HeartbeatCallback    = std::function<void(const Heartbeat&)>;
    using EventCallback        = std::function<void(const DeviceEvent&)>;
    using DeviceStatusCallback = std::function<void(const std::string& device_id, DeviceStatus status)>;

    void on_telemetry(TelemetryCallback cb);
    void on_heartbeat(HeartbeatCallback cb);
    void on_event(EventCallback cb);
    void on_device_status_changed(DeviceStatusCallback cb);
    void on_connection_changed(ConnectionCallback cb);
    void on_error(ErrorCallback cb);

    //--- Stats ---------------------------------------------------------------
    GatewayStats get_stats() const;

private:
    class Impl;
    std::unique_ptr<Impl> m_impl;
};

} // namespace anscloud

#endif // ANSCLOUD_GATEWAY_AGENT_H