Добавить Turbo-загрузку и превью для вложений

2026-08-04 19:09:54 +04:00
parent 391b18a5ac
commit 75b75fd223
13 changed files with 1445 additions and 690 deletions
@@ -45,7 +45,7 @@ TEXT-тип хранит сообщения и редактирования.
 - Такой edit трактуется как логическое удаление содержимого сообщения.
 - Для удаления используется именно edit-блок; отдельного `DELETE`-подтипа нет.

-## Вложения в текстовых сообщениях (`SHiNE:attach v=1`)
+## Вложения в текстовых сообщениях (`SHiNE:attach v=1/v=2`)

 Для `TEXT_POST`, `TEXT_REPLY`, `TEXT_EDIT_POST` и `TEXT_EDIT_REPLY` клиент может хранить вложения как технические строки в начале обычного `text`.

@@ -59,15 +59,22 @@ TEXT-тип хранит сообщения и редактирования.
 <SHiNE:attach;v=1;name=report.pdf;size=845221;sha256=0123...;ar=AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA>
 ```

+Для файлов с отдельным превью клиент может использовать расширенный вариант:
+
+```text
+<SHiNE:attach;v=2;name=video.mp4;size=5820193;sha256=bbbb...;ar=CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC;previewAr=DDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDD;previewSha256=eeee...>
+```
+
 Несколько вложений идут подряд в самом начале текста, по одному блоку на строку. После последнего блока идёт обычный пользовательский текст.

 Обязательные поля:

- `v=1`
+- `v=1` или `v=2`
 - `name` - имя файла, закодированное через `encodeURIComponent`
 - `size` - размер файла в байтах
 - `sha256` - SHA-256 исходного файла в hex
 - `ar` - короткий Arweave Transaction ID, без полного URL
+- для `v=2` дополнительно могут присутствовать `previewAr` и `previewSha256`

 Правила клиента:

@@ -76,4 +83,4 @@ TEXT-тип хранит сообщения и редактирования.
 - старые клиенты без поддержки вложений могут показывать технические строки как обычный текст;
 - пустой пользовательский текст допустим, если перед ним есть хотя бы один валидный attach-блок.

-Файлы хранятся вне блокчейна, в Arweave. В блокчейне остаются только `txId`, имя, размер и SHA-256.
+Файлы хранятся вне блокчейна, в Arweave. В блокчейне остаются только `txId`, имя, размер, SHA-256 и, при наличии отдельного preview-файла, `previewAr/previewSha256`.