API 参考

namespace croupier::sdk {
    // 核心类
    class CroupierClient;
    struct ClientConfig;

    // 描述符
    struct FunctionDescriptor;
    struct VirtualObjectDescriptor;
    struct ComponentDescriptor;

    // 工具
    namespace utils {
        nlohmann::json ParseJSON(const std::string& str);
        std::string ToJSON(const nlohmann::json& json);
    }
}

using FunctionHandler = std::function<std::string(const std::string& context, const std::string& payload)>;

struct ClientConfig {
    std::string agent_addr = "127.0.0.1:19090";  // Agent 地址
    std::string game_id;                          // 游戏 ID
    std::string env = "development";              // 环境
    std::string service_id = "cpp-service";       // 服务 ID
    bool insecure = true;                         // 是否跳过 TLS 验证
    int timeout_seconds = 30;                     // 超时时间

    // 重连配置
    bool auto_reconnect = true;
    int reconnect_interval_seconds = 5;
    int reconnect_max_attempts = 0;  // 0 = 无限

    // 安全配置
    struct {
        std::string cert_file;
        std::string key_file;
        std::string ca_file;
        std::string server_name;
    } security;

    // 认证配置
    struct {
        std::string token;
        std::map<std::string, std::string> headers;
    } auth;
};

struct FunctionDescriptor {
    std::string id;                    // 函数 ID，如 "wallet.transfer"
    std::string version;               // 版本号，如 "0.1.0"
    std::string name;                  // 显示名称
    std::string description;           // 描述
    nlohmann::json input_schema;       // 输入 Schema
    nlohmann::json output_schema;      // 输出 Schema
    std::vector<std::string> tags;     // 标签
    int timeout_ms = 30000;            // 超时时间（毫秒）
};

struct VirtualObjectDescriptor {
    std::string id;                    // 对象 ID
    std::string version;               // 版本号
    std::string name;                  // 显示名称
    std::string description;           // 描述
    std::map<std::string, std::string> operations;  // 操作映射
    nlohmann::json schema;             // 数据 Schema
    nlohmann::json metadata;           // 元数据
};

CroupierClient(const ClientConfig& config);

bool RegisterFunction(const FunctionDescriptor& desc, FunctionHandler handler);

bool RegisterVirtualObject(
    const VirtualObjectDescriptor& desc,
    const std::map<std::string, FunctionHandler>& handlers
);

bool RegisterComponent(const ComponentDescriptor& comp);

bool Connect();

void Serve();

void Stop();

void Close();

bool IsConnected() const;

nlohmann::json ParseJSON(const std::string& str);

std::string ToJSON(const nlohmann::json& json);

bool ValidateJSON(const nlohmann::json& data, const nlohmann::json& schema);

class ClientConfigLoader {
public:
    // 从文件加载
    ClientConfig LoadFromFile(const std::string& file_path);

    // 从 JSON 字符串加载
    ClientConfig LoadFromJson(const std::string& json_content);

    // 带环境变量覆盖加载
    ClientConfig LoadWithEnvironmentOverrides(
        const std::string& file_path,
        const std::string& env_prefix = "CROUPIER_"
    );

    // 验证配置
    std::vector<std::string> ValidateConfig(const ClientConfig& config);

    // 生成示例配置
    std::string GenerateExampleConfig(const std::string& env = "development");
};

class CroupierException : public std::runtime_error {
public:
    explicit CroupierException(const std::string& message);
    explicit CroupierException(const std::string& code, const std::string& message);
};

using ConnectionCallback = std::function<void(bool connected)>;

using ErrorCallback = std::function<void(const std::string& error)>;

using LogCallback = std::function<void(const std::string& level, const std::string& message)>;