#pragma once

#include <stdbool.h>
#include <stddef.h>
#include <stdint.h>
#include "esp_err.h"

#ifdef __cplusplus
extern "C" {
#endif

/* 仅描述 WebSocket 传输事件，不携带 domain 层的业务会话语义。 */
typedef enum {
    MULTIMODAL_WS_EVENT_CONNECTED = 0,
    MULTIMODAL_WS_EVENT_DISCONNECTED,
    MULTIMODAL_WS_EVENT_ERROR,
    MULTIMODAL_WS_EVENT_TEXT_MESSAGE,
    MULTIMODAL_WS_EVENT_BINARY_MESSAGE,
} multimodal_ws_event_type_t;

/* data 指针只在事件回调期间有效，需要异步处理时必须复制。 */
typedef struct {
    multimodal_ws_event_type_t type;
    const uint8_t *data;
    size_t data_len;
} multimodal_ws_event_t;

typedef void (*multimodal_ws_event_callback_t)(const multimodal_ws_event_t *event,
                                               void *user_data);

/* start 复制鉴权信息和回调；stop 负责回收 client、队列及全部工作任务。 */
esp_err_t multimodal_ws_start(const char *bearer_token,
                              const char *workspace_id,
                              multimodal_ws_event_callback_t cb,
                              void *user_data);
esp_err_t multimodal_ws_stop(int timeout_ms);
bool multimodal_ws_is_connected(void);

/* 普通文本允许内部重试；realtime 接口使用更短锁等待和发送超时以保护实时性。 */
esp_err_t multimodal_ws_send_text(const char *label, const char *text);
esp_err_t multimodal_ws_send_text_realtime(const char *label, const char *text);
esp_err_t multimodal_ws_send_binary_realtime(const uint8_t *data, size_t len);

#ifdef __cplusplus
}
#endif