chore(proto): sync from rcc 3d78f79

proto/layer.3.yml

@@ -2,52 +2,57 @@ version: 3
 description: Add avatars and more CDN safety, remove transport server
 
 enums:
+  #Тип вложния
   AttachmentType:
     type: int8
     values:
       - id: 0
-        name: IMAGE
+        name: IMAGE #Изображение 
       - id: 1
-        name: MESSAGES
+        name: MESSAGES #Сообщения (forwarded/reply)
       - id: 2
-        name: FILE
+        name: FILE #Файл
       - id: 4
-        name: CALL
+        name: CALL #Звонок
       - id: 5
-        name: VOICE
+        name: VOICE #Голосовое сообщение
       - id: 6
-        name: VIDEO_CIRCLE
+        name: VIDEO_CIRCLE #Видео сообщение (кружок)
       - id: 7
-        name: VIDEO
+        name: VIDEO #Видео
 
+  #Решение по девайсу, принять или отклонить вход
   DeviceSolution:
     type: int8
     values:
       - id: 0
-        name: ACCEPT
+        name: ACCEPT #Принять
       - id: 1
-        name: DECLINE
+        name: DECLINE #Отклонить
 
+  #Статус хэндшейка
   HandshakeStage:
     type: int8
     values:
       - id: 0
-        name: COMPLETED
+        name: COMPLETED #Пройден
       - id: 1
-        name: NEED_DEVICE_VERIFICATION
+        name: NEED_DEVICE_VERIFICATION #Не пройден (приложение рендерит UI подтвердите с другого устройства)
 
+  #Статус в группе
   GroupStatus:
     type: int8
     values:
       - id: 0
-        name: JOINED
+        name: JOINED #В группе
       - id: 1
-        name: INVALID
+        name: INVALID #Не валидная группа
       - id: 2
-        name: NOT_JOINED
+        name: NOT_JOINED #Можно зайт
       - id: 3
-        name: BANNED
+        name: BANNED #Заблокирован
 
+  #
   NotificationAction:
     type: int8
     values:
@@ -96,15 +101,16 @@ enums:
       - id: 2
         name: BATCH_END
 
+  #Тип WebRTC сигнала
   WebRTCType:
     type: int8
     values:
       - id: 0
-        name: OFFER
+        name: OFFER #Offer
       - id: 1
-        name: ANSWER
+        name: ANSWER #Answer
       - id: 2
-        name: ICE_CANDIDATE
+        name: ICE_CANDIDATE #Estabilishment candidate
 
   ResultCode:
     type: int8
@@ -114,13 +120,13 @@ enums:
       - id: 1
         name: ERROR
       - id: 2
-        name: INVALID #любая ошибка смысл которой зависит от контекста, например в случае с файловой системой - нет файла
+        name: INVALID #Любая ошибка смысл которой зависит от контекста, например в случае с файловой системой - нет файла
       - id: 3
-        name: USERNAME_TAKEN
+        name: USERNAME_TAKEN #Имя пользователя занято
       - id: 4
-        name: OVERSIZE #слишком большой размер файла
+        name: OVERSIZE #Слишком большой размер файла
       - id: 5
-        name: OVERLIFE #слишком большой TTL
+        name: OVERLIFE #Слишком большой TTL
 
   TokenType:
     type: int8
@@ -141,19 +147,19 @@ types:
   Attachment:
     fields:
       - id: 1
-        name: id
+        name: id #Случайная строка 
         type: string
       - id: 2
-        name: blob?
+        name: blob? #Только очень коротких типов
         type: string
       - id: 3
-        name: type
+        name: type #Тип вложения
         type: AttachmentType
       - id: 4
-        name: preview
+        name: preview #Превью
         type: string
       - id: 6
-        name: objectId
+        name: objectId #Выданный сервером objectId от cdn
         type: string
 
   #Медиа-файлы профиля такие как аватарки (фото) и будущие истории