/**
 * @file connection_url_builder.h
 * @brief WebSocket URL 构建（cfg JSON 序列化 + 鉴权参数拼接）
 */

#ifndef CORE_CONNECTION_URL_BUILDER_H
#define CORE_CONNECTION_URL_BUILDER_H

#ifdef __cplusplus
extern "C" {
#endif

typedef struct engine_internal_ctx engine_internal_ctx_t;

/**
 * @brief 根据引擎配置构建 WebSocket 连接 URL
 *
 * 根据配置生成连接地址。
 * USERSERVER 模式会先获取 token。
 *
 * @return 静态缓冲区中的 URL 指针；失败返回 NULL
 * @note 下次调用会覆盖本次返回结果
 */
const char *conn_url_build(engine_internal_ctx_t *ctx);

#ifdef __cplusplus
}
#endif

#endif /* CORE_CONNECTION_URL_BUILDER_H */
