VNOX-Server/protocol/lnex.proto

syntax = "proto3";
package lnex;

// ─── HANDSHAKE ──────────────────────────────────────────────────────────────

message Hello {
  string lnex_version     = 1;
  bytes  server_pubkey    = 2;
  bytes  challenge_nonce  = 3;
  string node_name        = 4;
  bytes  server_eph_pubkey = 5;
  bool   private_mode     = 6;
}

message Auth {
  bytes  client_pubkey    = 1;
  string nickname         = 2;
  string lnex_version     = 3;
  bytes  signature        = 4;
  bytes  client_eph_pubkey = 5;
}

message Session {
  string session_id = 1;
  string token      = 2;
  int64  expires_at = 3;
}

// ─── KEEPALIVE ──────────────────────────────────────────────────────────────

message Ping  { int64 timestamp = 1; }
message Pong  { int64 timestamp = 1; }

// ─── ERROR / DISCONNECT ─────────────────────────────────────────────────────

message Error      { uint32 code = 1; string message = 2; }
message Disconnect { string reason = 1; }

// ─── CHANNELS ───────────────────────────────────────────────────────────────

message JoinChannel { string channel_id = 1; }
message LeaveChannel { string channel_id = 1; }

message ChannelState {
  string          channel_id     = 1;
  string          channel_name   = 2;
  string          kind           = 3;
  repeated MemberInfo members    = 4;
  string          voice_endpoint = 5;
  optional string guild_id       = 6;
}

message MemberInfo {
  string user_id  = 1;
  string nickname = 2;
  bool   in_voice = 3;
}

message ChannelCreate {
  string          channel_id   = 1;
  string          channel_name = 2;
  string          kind         = 3;
  optional string guild_id     = 4;
}

message ChannelDelete { string channel_id = 1; }

message ChannelEdit {
  string channel_id   = 1;
  string channel_name = 2;
}

message ChannelList {
  repeated ChannelListItem channels = 1;
  optional string          guild_id = 2;
}

message ChannelListItem {
  string          channel_id   = 1;
  string          channel_name = 2;
  string          kind         = 3;
  optional string guild_id     = 4;
}

message UserJoin  { string channel_id = 1; string user_id = 2; string nickname = 3; }
message UserLeave { string channel_id = 1; string user_id = 2; }

// ─── CHAT ────────────────────────────────────────────────────────────────────

message ChatMessage {
  string          message_id = 1;
  string          channel_id = 2;
  string          sender_id  = 3;
  string          content    = 4;
  int64           timestamp  = 5;
  bool            edited     = 6;
  optional string reply_to   = 7;
}

message ChatHistory {
  string               channel_id = 1;
  repeated ChatMessage messages   = 2;
}

message ReactionPayload {
  string message_id = 1;
  string channel_id = 2;
  string emoji      = 3;
  string user_id    = 4;
}

message MessageEdit {
  string message_id = 1;
  string channel_id = 2;
  string content    = 3;
}

message MessageDelete {
  string message_id = 1;
  string channel_id = 2;
}

// ─── VOICE ──────────────────────────────────────────────────────────────────

message VoiceState {
  string user_id    = 1;
  string channel_id = 2;
  string state      = 3;
}

// ─── GUILDS ─────────────────────────────────────────────────────────────────

message GuildCreate { string name = 1; }

message GuildInfo {
  string id           = 1;
  string owner_id     = 2;
  string name         = 3;
  int64  member_count = 4;
  int64  created_at   = 5;
}

message GuildDelete { string guild_id = 1; }
message GuildList { repeated GuildInfo guilds = 1; }

message GuildMemberJoin  { string guild_id = 1; }
message GuildMemberLeave { string guild_id = 1; string user_id = 2; }
message GuildMemberKick  { string guild_id = 1; string user_id = 2; }

message RoleCreate {
  string          guild_id    = 1;
  string          name        = 2;
  optional string color       = 3;
  optional uint64 permissions = 4;
  string          id          = 5;
}

message RoleDelete {
  string guild_id = 1;
  string role_id  = 2;
}

message InviteCreate {
  string          guild_id            = 1;
  optional int64  max_uses            = 2;
  optional int64  expires_in_seconds  = 3;
}

message InviteInfo {
  string          id          = 1;
  string          guild_id    = 2;
  string          guild_name  = 3;
  string          code        = 4;
  string          creator_id  = 5;
  optional int64  max_uses    = 6;
  int64           uses        = 7;
  optional int64  expires_at  = 8;
  int64           created_at  = 9;
}

message InviteAccept {
  string code       = 1;
  string guild_id   = 2;
  string guild_name = 3;
}

message InviteDelete {
  string guild_id   = 1;
  string invite_id  = 2;
}

message GuildAuditLogFetch {
  string guild_id = 1;
  int64  limit    = 2;
}

message AuditLogEntry {
  string          id           = 1;
  string          guild_id     = 2;
  string          actor_id     = 3;
  string          action       = 4;
  optional string target_id    = 5;
  optional string target_type  = 6;
  optional string reason       = 7;
  int64           created_at   = 8;
}

message GuildAuditLog {
  string                 guild_id = 1;
  repeated AuditLogEntry entries  = 2;
}

message GuildMemberListFetch { string guild_id = 1; }

message GuildMemberInfo {
  string user_id    = 1;
  string nickname   = 2;
  int64  joined_at  = 3;
  string role_color = 4;
  string role_name  = 5;
  bool   is_owner   = 6;
}

message GuildMemberList {
  string                   guild_id = 1;
  repeated GuildMemberInfo members  = 2;
}

message RoleAssign {
  string guild_id = 1;
  string user_id  = 2;
  string role_id  = 3;
}

message GuildRoleListFetch { string guild_id = 1; }

message GuildRoleInfo {
  string id          = 1;
  string guild_id    = 2;
  string name        = 3;
  string color       = 4;
  uint64 permissions = 5;
  int32  position    = 6;
}

message GuildRoleList {
  string                guild_id = 1;
  repeated GuildRoleInfo roles   = 2;
}

// ─── DIRECT MESSAGES ────────────────────────────────────────────────────────

message DmStart {
  string target_user_id = 1;
}

message DmStartResponse {
  string            dm_id          = 1;
  string            other_user_id  = 2;
  string            other_nickname = 3;
  repeated DmMessage messages      = 4;
  uint32            unread_count   = 5;
}

message DmMessage {
  string dm_id     = 1;
  string sender_id = 2;
  string content   = 3;
  int64  timestamp = 4;
}

message DmHistory {
  string          dm_id         = 1;
  repeated DmMessage messages   = 2;
  optional string search_query  = 3;
  optional int64  limit         = 4;
}

message DmReadAck {
  string dm_id = 1;
}

// ─── FRIENDS ────────────────────────────────────────────────────────────────

message FriendRequest { string to_user_id = 1; }
message FriendAccept  { string from_user_id = 1; }
message FriendDecline { string from_user_id = 1; }
message FriendRemove  { string user_id = 1; }

message FriendInfo {
  string user_id   = 1;
  string nickname  = 2;
  string status    = 3;
  int64  since     = 4;
}

message FriendList { repeated FriendInfo friends = 1; }

message BlockUser   { string user_id = 1; }
message UnblockUser { string user_id = 1; }
message BlockList   { repeated string blocked = 1; }

message FriendEvent {
  string          event    = 1;
  string          user_id  = 2;
  optional string nickname = 3;
}

// ─── PRESENCE ──────────────────────────────────────────────────────────────

message PresenceUpdate {
  string          status         = 1;
  optional string activity_type  = 2;
  optional string activity_text  = 3;
}

message PresenceInfo {
  string          user_id        = 1;
  string          nickname       = 2;
  string          status         = 3;
  optional string activity_type  = 4;
  optional string activity_text  = 5;
}

message PresenceSync  { repeated PresenceInfo presences = 1; }

message PresenceEvent {
  string          user_id        = 1;
  string          nickname       = 2;
  string          status         = 3;
  optional string activity_type  = 4;
  optional string activity_text  = 5;
}

// ─── READ RECEIPT & TYPING ─────────────────────────────────────────────────

message ReadReceipt {
  string channel_id            = 1;
  string last_read_message_id  = 2;
  string user_id               = 3;
}

message TypingStart {
  string channel_id = 1;
}

// ─── AD-HOC RESPONSE / BROADCAST TYPES ──────────────────────────────────────

message ReadReceiptBroadcast {
  string channel_id           = 1;
  string user_id              = 2;
  string last_read_message_id = 3;
}

message UserRoleUpdate {
  string user_id   = 1;
  string guild_id  = 2;
  string color     = 3;
}

message TypingBroadcast {
  string user_id   = 1;
  string nickname  = 2;
  string channel_id = 3;
}

message SimpleResponse {
  bool            ok       = 1;
  optional string user_id  = 2;
  optional string role_id  = 3;
}

// ─── E2EE for Direct Messages ────────────────────────────────────────────────

message E2eeDmKeyExchange {
  string dm_id           = 1;
  bytes  e2ee_public_key = 2;
}

message E2eeDmKeyExchangeAck {
  string dm_id = 1;
}

message E2eeDmMessage {
  string dm_id     = 1;
  string sender_id = 2;
  bytes  ciphertext = 3;
  int64  timestamp  = 4;
}

message E2eeDmHistory {
  string          dm_id         = 1;
  repeated E2eeDmMessage messages = 2;
  optional int64  limit         = 3;
}