102 lines
7.4 KiB
C
102 lines
7.4 KiB
C
/*
|
||
* chat_sync — связь чат-сервиса с транспортом и группами.
|
||
* Отслеживает пиров, запускает member_sync, поддерживает кеш каналов и статус в GUI.
|
||
* UP/REINIT/пробуждение восстанавливают только общие каналы соответствующего пира.
|
||
* Отложенные запросы объединяются по (канал, пир); активными обменами и обновлениями владеет Merkle.
|
||
* Вход по ссылке держит отдельный NCD handle до результата join, а не только до UP.
|
||
* JOIN_INFO_REQ → JOIN_INFO_RESP → JOIN_REQUEST → JOIN_READY; правила — в chat_join.h.
|
||
* Жизненным циклом управляет chat_service_start/stop. Вызовы — в потоке uasync.
|
||
* Вход из GUI/JNI через отдельный chat_join_port, который копирует ссылку и удерживает очередь до close.
|
||
*/
|
||
|
||
#ifndef CHAT_SYNC_H
|
||
#define CHAT_SYNC_H
|
||
|
||
#ifdef __cplusplus
|
||
extern "C" {
|
||
#endif
|
||
|
||
#include <stdint.h>
|
||
#include <stddef.h>
|
||
|
||
struct UTUN_INSTANCE;
|
||
|
||
/* etcp service IDs (direct P2P): ETCP_ID_CHAT_SYNC / ETCP_ID_MEMBER_SYNC
|
||
* (etcp_bind, см. etcp_api.h) */
|
||
|
||
/* Управление JOIN, приглашениями и настройкой звука; история сообщений — в db_sync/Merkle. */
|
||
#define CS_MSG_ERROR 0x07
|
||
#define CS_MSG_CHANNEL_INVITE 0x0F /* push-invite: inviter → joiner */
|
||
/* В JOIN_INFO_REQ pass_len обязателен даже при пустом пароле (0); password передаётся без NUL. */
|
||
#define CS_MSG_JOIN_INFO_REQ 0x10 /* joiner → connection: {join_key:8, pass_len:1, password:pass_len} */
|
||
#define CS_MSG_JOIN_INFO_RESP 0x11 /* connection → joiner: channel info + connection's member record */
|
||
#define CS_MSG_JOIN_REQUEST 0x12 /* joiner → connection: {join_key:8, member...} */
|
||
#define CS_MSG_JOIN_READY 0x13 /* connection → joiner: {group_id:8} */
|
||
#define CS_MSG_SOUND_SETTING 0x14 /* peer → server: {sound_on:1} — per-chat play sound on message */
|
||
|
||
/* Управление JOIN (INFO_REQ/RESP, REQUEST, READY, ERROR): после type идёт attempt_id:8BE,
|
||
* затем payload, описанный выше. Ненулевой случайный ID новый для каждой локальной попытки;
|
||
* ответы проверяются по (peer, group, attempt_id, phase). CHANNEL_INVITE переносит предложение
|
||
* с join_key; получатель создаёт собственный attempt_id при принятии предложения. */
|
||
|
||
/* ── Public API ── */
|
||
|
||
/* Создать контекст, обработчики join и member_sync. 0/-1; повтор допустим. */
|
||
int chat_sync_init(struct UTUN_INSTANCE* inst);
|
||
/* uasync: закрыть приём команд и отменить локальный JOIN до остановки workers. */
|
||
void chat_sync_quiesce(struct UTUN_INSTANCE* inst);
|
||
/* uasync: отменить только активный request; чужая попытка сохраняется. */
|
||
void chat_sync_cancel_join(struct UTUN_INSTANCE* inst, uint64_t request);
|
||
/* Отменить ожидания, синхронизацию и таймеры, освободить контекст; данные каналов сохраняются. */
|
||
void chat_sync_destroy(struct UTUN_INSTANCE* inst);
|
||
|
||
/* Локальная попытка JOIN: uasync. Отрицательный возврат — отказ запуска без события;
|
||
* 0 — запущено, CHAT_EVT_CONNECT_RESULT ровно один раз, включая stop/delete.
|
||
* request=0 — без адресата UI; ненулевые ID вызывающий не переиспользует до завершения.
|
||
* link заимствован до возврата; request — корреляция интерфейса, не сетевой attempt_id. */
|
||
#define CHAT_CONNECT_ERROR -1
|
||
#define CHAT_CONNECT_TIMEOUT 2
|
||
#define CHAT_CONNECT_INVALID -7
|
||
#define CHAT_CONNECT_BUSY -8
|
||
#define CHAT_CONNECT_CANCELLED -9
|
||
int chat_sync_join_link(struct UTUN_INSTANCE* inst, uint64_t request, const char* link, size_t len);
|
||
/* Единый формат результата: peer:8,result:4,channel:8,request:8, native; только uasync. */
|
||
void chat_sync_join_result(struct UTUN_INSTANCE* inst, uint64_t request, uint64_t channel, uint64_t peer, int result);
|
||
|
||
/* uasync: пригласить адресата ссылки в свой channel; те же правила запуска/результата. */
|
||
int chat_sync_offer_link(struct UTUN_INSTANCE* inst, uint64_t request, uint64_t channel, const char* link, size_t len);
|
||
|
||
/* Пригласить target_node_id в канал ch_id (inviter → joiner).
|
||
Отправляет CS_MSG_CHANNEL_INVITE с описанием канала, подписями/профилем инвайтера и join_key. */
|
||
void chat_sync_invite_to_channel(struct UTUN_INSTANCE* inst, const char* ch_id, uint64_t target_node_id);
|
||
|
||
/* Принять входящее приглашение — продолжить протокол из chat_join.h. */
|
||
void chat_sync_accept_invite(struct UTUN_INSTANCE* inst, uint64_t channel_id, uint64_t inviter_node_id);
|
||
|
||
/* Отклонить входящее приглашение */
|
||
void chat_sync_deny_invite(struct UTUN_INSTANCE* inst, uint64_t channel_id, uint64_t inviter_node_id);
|
||
|
||
/* Присоединиться к каналу через уже подключённый узел (uasync-поток).
|
||
Соединение с target_node_id должно быть установлено (links_up && initialized).
|
||
Протокол: JOIN_INFO_REQ → JOIN_INFO_RESP → JOIN_REQUEST → JOIN_READY (chat_join.h).
|
||
Канал (DB + TOPO_GROUP) создаётся локально при получении JOIN_INFO_RESP;
|
||
это само по себе не даёт членства на других узлах. */
|
||
void chat_sync_join_channel(struct UTUN_INSTANCE* inst, const char* ch_id, uint64_t target_node_id);
|
||
|
||
/* Снять паузу и сбросить задержки повторных попыток во всех кешированных каналах с автоматическим планировщиком.
|
||
Планировщик пересматривает подключения; работающие соединения сохраняются.
|
||
Вызывается из auto_socket при появлении/изменении сетевой связности. */
|
||
void chat_sync_retry_channels_on_socket_change(struct UTUN_INSTANCE* inst);
|
||
|
||
/* Отменить отложенные запросы канала и немедленно убрать его из кеша (локальное удаление).
|
||
* Активные Merkle-сессии отменяет вызывающий код через member_sync_cancel_channel(). */
|
||
void chat_sync_on_channel_deleted(struct UTUN_INSTANCE* inst, const char* ch_id);
|
||
|
||
/* Разослать всем подключённым пирам канала смену per-chat настройки «play sound on message». */
|
||
void chat_sync_broadcast_sound_setting(struct UTUN_INSTANCE* inst, const char* ch_id, int on);
|
||
|
||
#ifdef __cplusplus
|
||
}
|
||
#endif
|
||
#endif /* CHAT_SYNC_H */
|