SHA256
Обновить хранение вложений R2
This commit is contained in:
@@ -32,6 +32,7 @@ public final class DatabaseInitializer {
|
||||
public static final int SCHEMA_VERSION_39 = 39;
|
||||
public static final int SCHEMA_VERSION_40 = 40;
|
||||
public static final int SCHEMA_VERSION_41 = 41;
|
||||
public static final int SCHEMA_VERSION_42 = 42;
|
||||
public static final String POSTGRES_SCHEMA_RESOURCE = "postgres/schema_v1.sql";
|
||||
public static final String POSTGRES_MIGRATION_V31_RESOURCE = "postgres/migration_v31.sql";
|
||||
public static final String POSTGRES_MIGRATION_V32_RESOURCE = "postgres/migration_v32.sql";
|
||||
@@ -44,6 +45,7 @@ public final class DatabaseInitializer {
|
||||
public static final String POSTGRES_MIGRATION_V39_RESOURCE = "postgres/migration_v39.sql";
|
||||
public static final String POSTGRES_MIGRATION_V40_RESOURCE = "postgres/migration_v40.sql";
|
||||
public static final String POSTGRES_MIGRATION_V41_RESOURCE = "postgres/migration_v41.sql";
|
||||
public static final String POSTGRES_MIGRATION_V42_RESOURCE = "postgres/migration_v42.sql";
|
||||
|
||||
private DatabaseInitializer() {}
|
||||
|
||||
@@ -179,9 +181,13 @@ public final class DatabaseInitializer {
|
||||
runSqlScript(conn, POSTGRES_MIGRATION_V41_RESOURCE);
|
||||
currentVersion = readCurrentSchemaVersion(conn);
|
||||
}
|
||||
if (currentVersion != SCHEMA_VERSION_41) {
|
||||
if (currentVersion == SCHEMA_VERSION_41) {
|
||||
runSqlScript(conn, POSTGRES_MIGRATION_V42_RESOURCE);
|
||||
currentVersion = readCurrentSchemaVersion(conn);
|
||||
}
|
||||
if (currentVersion != SCHEMA_VERSION_42) {
|
||||
throw new SQLException(
|
||||
"Unsupported SHiNE DB v2 schema version: expected 41, found " + currentVersion);
|
||||
"Unsupported SHiNE DB v2 schema version: expected 42, found " + currentVersion);
|
||||
}
|
||||
normalizeBlockchainStateKeysToBase64(conn);
|
||||
}
|
||||
|
||||
@@ -0,0 +1,27 @@
|
||||
-- SHiNE v42: журнал выдачи разрешений R2 (не подтверждение успешного PUT).
|
||||
-- В DM записываются только зашифрованные объекты (включая манифест), без имени и MIME.
|
||||
BEGIN;
|
||||
CREATE TABLE IF NOT EXISTS public_file_uploads (
|
||||
id BIGINT GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
|
||||
user_login TEXT NOT NULL,
|
||||
file_hash TEXT NOT NULL,
|
||||
file_size_bytes BIGINT NOT NULL CHECK (file_size_bytes > 0),
|
||||
disposition TEXT NOT NULL CHECK (disposition IN ('upload_url_issued', 'already_exists')),
|
||||
requested_at TIMESTAMPTZ NOT NULL DEFAULT now()
|
||||
);
|
||||
CREATE INDEX IF NOT EXISTS public_file_uploads_user_time_idx ON public_file_uploads (user_login, requested_at DESC);
|
||||
CREATE INDEX IF NOT EXISTS public_file_uploads_hash_idx ON public_file_uploads (file_hash);
|
||||
|
||||
CREATE TABLE IF NOT EXISTS dm_file_uploads (
|
||||
id BIGINT GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
|
||||
user_login TEXT NOT NULL,
|
||||
file_hash TEXT NOT NULL,
|
||||
file_size_bytes BIGINT NOT NULL CHECK (file_size_bytes > 0),
|
||||
disposition TEXT NOT NULL CHECK (disposition IN ('upload_url_issued', 'already_exists')),
|
||||
requested_at TIMESTAMPTZ NOT NULL DEFAULT now()
|
||||
);
|
||||
CREATE INDEX IF NOT EXISTS dm_file_uploads_user_time_idx ON dm_file_uploads (user_login, requested_at DESC);
|
||||
CREATE INDEX IF NOT EXISTS dm_file_uploads_hash_idx ON dm_file_uploads (file_hash);
|
||||
|
||||
UPDATE db_schema_version SET schema_version = 42, updated_at_ms = (EXTRACT(EPOCH FROM clock_timestamp()) * 1000)::BIGINT WHERE id = 1;
|
||||
COMMIT;
|
||||
@@ -93,6 +93,7 @@ public final class R2DmPrepareServlet extends HttpServlet {
|
||||
}
|
||||
}
|
||||
}
|
||||
R2UploadAuditRecorder.record(req, true, fileId, size, result.path("exists").asBoolean(false));
|
||||
respond(resp, 200, result);
|
||||
} catch (Exception error) {
|
||||
getServletContext().log("R2 DM prepare failed", error);
|
||||
|
||||
@@ -85,6 +85,7 @@ public final class R2PrepareServlet extends HttpServlet {
|
||||
}
|
||||
}
|
||||
}
|
||||
R2UploadAuditRecorder.record(req, false, root, size, out.path("exists").asBoolean(false));
|
||||
respond(resp, 200, out);
|
||||
} catch (Exception e) {
|
||||
getServletContext().log("R2 prepare failure", e);
|
||||
|
||||
@@ -0,0 +1,41 @@
|
||||
package server.files;
|
||||
|
||||
import jakarta.servlet.http.HttpServletRequest;
|
||||
import shine.db.DbController;
|
||||
import shine.db.dao.ActiveSessionsDAO;
|
||||
import shine.db.entities.ActiveSessionEntry;
|
||||
|
||||
import java.sql.Connection;
|
||||
import java.sql.PreparedStatement;
|
||||
import java.sql.SQLException;
|
||||
|
||||
/**
|
||||
* Учёт выдачи разрешений R2. ВАЖНО: запись не удостоверяет завершённый PUT.
|
||||
* Не сохраняет исходные имена и MIME личных файлов.
|
||||
*/
|
||||
final class R2UploadAuditRecorder {
|
||||
private R2UploadAuditRecorder() {}
|
||||
|
||||
static void record(HttpServletRequest request, boolean dm, String fileHash, long size, boolean exists)
|
||||
throws SQLException {
|
||||
// Заголовок используется только ПОСЛЕ проверки Ed25519-подписи в вызывающем servlet.
|
||||
String sessionId = request.getHeader("X-Shine-Session-Id");
|
||||
if (sessionId == null || sessionId.isBlank()) throw new SQLException("Upload session ID missing");
|
||||
String table = dm ? "dm_file_uploads" : "public_file_uploads";
|
||||
try (Connection connection = DbController.getInstance().getConnection()) {
|
||||
ActiveSessionEntry session = ActiveSessionsDAO.getInstance().getBySessionId(connection, sessionId.trim());
|
||||
if (session == null || session.getLogin() == null || session.getLogin().isBlank()) {
|
||||
throw new SQLException("Upload session missing for audit");
|
||||
}
|
||||
String sql = "INSERT INTO " + table
|
||||
+ " (user_login, file_hash, file_size_bytes, disposition) VALUES (?, ?, ?, ?)";
|
||||
try (PreparedStatement statement = connection.prepareStatement(sql)) {
|
||||
statement.setString(1, session.getLogin());
|
||||
statement.setString(2, fileHash);
|
||||
statement.setLong(3, size);
|
||||
statement.setString(4, exists ? "already_exists" : "upload_url_issued");
|
||||
statement.executeUpdate();
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
+2
-2
@@ -1,2 +1,2 @@
|
||||
client.version=1.20.49
|
||||
server.version=1.16.25
|
||||
client.version=1.20.50
|
||||
server.version=1.16.26
|
||||
|
||||
@@ -1,5 +1,9 @@
|
||||
# HTTP API зашифрованных файлов личных сообщений
|
||||
|
||||
> **Текущий протокол DM v3 (2026-11):** новые вложения отправляются напрямую в R2 `shine-dm` после `POST /api/dm-files/prepare`; скачиваются по `https://dm-files.shineup.me/<Base58(SHA-256(ciphertext))>`. Большие файлы шифруются по 8 МиБ AES-256-GCM, список объектов находится в зашифрованном манифесте; BitTorrent v2 используется только в старых DM v2. Ниже разделы `PUT /dm-files/{fileId}` и `GET /dm-files/{fileId}` описывают **legacy** локальный сервер для v1/v2, а не новый R2. Полный текущий контракт см. `docs/Personal_Messages/Файлы_DM_v3_R2.md`.
|
||||
|
||||
> **Статистика v42:** сервер при успешной выдаче presigned URL или обнаружении уже существующего шифротекста добавляет запись в `dm_file_uploads` (`user_login`, `file_hash`, `file_size_bytes`, `requested_at`, `disposition`). Каждая зашифрованная часть/манифест — отдельный объект, имена и MIME исходного файла не сохраняются. **Запись не доказывает успешный PUT.** Шифрование, DM-протокол и клиент не изменяются.
|
||||
|
||||
## 1. Назначение
|
||||
|
||||
Ранее файлы DM хранились только на access-сервере отправителя. **Новые DM v3** хранятся в Cloudflare R2 `shine-dm`, а legacy `/dm-files` продолжает обслуживать старые файлы v1/v2.
|
||||
@@ -11,7 +15,7 @@ HTTP API не получает исходное имя файла, MIME-тип
|
||||
2. шифрует файл в браузере;
|
||||
3. считает `SHA-256(ciphertext)`;
|
||||
4. переводит 32-byte hash в Base58 — это `fileId` и имя файла на диске сервера;
|
||||
5. загружает ciphertext на свой access-сервер;
|
||||
5. для нового v3 загружает ciphertext напрямую в R2 (ниже описан legacy v1/v2);
|
||||
6. помещает URL, key, IV, исходное имя/MIME/размер в `<S:file...>` внутри plaintext DM;
|
||||
7. обычный механизм E2EE DM шифрует эту техническую вставку отдельно для отправителя и получателя.
|
||||
|
||||
|
||||
@@ -1,155 +1,52 @@
|
||||
# HTTP API публичных файлов каналов
|
||||
# Публичные вложения SHiNE: Cloudflare R2 и legacy API
|
||||
|
||||
## 1. Назначение
|
||||
## Действующий формат (15.11.2026)
|
||||
|
||||
Публичное вложение может храниться не в Arweave, а на текущем сервере доступа автора.
|
||||
Файловый слой намеренно максимально простой: он хранит только байты, адресованные их SHA-256.
|
||||
Новые публичные файлы и аватары используют **BitTorrent v2 Pieces Root**, закодированный **Base58** (32 байта; строка обычно 43–44 символа). Идентификатор не зависит от имени и MIME. Клиент вычисляет корень по подготовленным байтам. Содержимое файла **не проходит через Java**.
|
||||
|
||||
Канонический URL:
|
||||
- R2 bucket: `shine-files`.
|
||||
- Публичный GET: `https://files.shineup.me/<PR>` (ключ объекта = `PR`, без расширения).
|
||||
- Предпросмотр публичных изображений и видео использует прямой URL. Картинки `loading="lazy"`; публичные видео получают `src` только у видимой области через `IntersectionObserver` и запрашивают метаданные после входа в область. В старом браузере используется обычная загрузка metadata.
|
||||
- Отдельных preview-файлов нет. Скачивание/просмотр медиаконтента выполняет сам браузер (в том числе HTTP Range, если доступен).
|
||||
- Тип определяется по `mm`, затем по расширению `nm`; HTTP `Content-Type` объекта задаётся при PUT. Неизвестные файлы — `application/octet-stream`.
|
||||
- HTML, SVG и похожие активные типы отображаются как обычные файловые карточки. Перед открытием **из публичного интерфейса** показывается предупреждение с возможностью отмены. Это не серверная санитаризация и не гарантия безопасности прямого URL.
|
||||
|
||||
Формат публичного вложения (версия тега остаётся 1):
|
||||
|
||||
```text
|
||||
/files/<sha256>
|
||||
<S:att;v=1;nm=photo.jpg;sz=123456;pr=BASE58_ROOT;mm=image/jpeg>
|
||||
```
|
||||
|
||||
`sha256` — lowercase hex, ровно 64 символа.
|
||||
При использовании Arweave дополнительно передаётся `;ar=TXID` — существующая загрузка Arweave/Turbo не меняется. Источник выбирается по `ar` (если есть), иначе R2 по `pr`. Не добавлять `storage=r2` в постоянные записи. Общее описание — `docs/Blockchain/15_TEXT_Attachments.md`.
|
||||
|
||||
На диске сервер хранит один глобальный объект:
|
||||
Новые аватары: `<S:ava;v=2;sz=N;pr=BASE58_ROOT[;ar=TXID]>`. SHA-256 hex остаётся лишь в исторических файловых маршрутах, **новые аватары SHA-256 не создают**. Старые аватары v1 не мигрируются автоматически (v41 сбрасывает старые ссылки каналов).
|
||||
|
||||
```text
|
||||
<public.files.storageDir>/<sha256>
|
||||
## Выдача разрешения на загрузку
|
||||
|
||||
`POST /api/files/prepare` (JSON):
|
||||
|
||||
```json
|
||||
{"pr":"BASE58_ROOT","size":123456,"mm":"image/jpeg"}
|
||||
```
|
||||
|
||||
Имя пользователя, исходное имя файла, расширение, MIME и ссылка на сообщение в файловом хранилище не нужны. Одинаковые байты, загруженные разными пользователями, дедуплицируются в один объект.
|
||||
Сессионная Ed25519-подпись обязательна. Заголовки:
|
||||
|
||||
## 2. Конфигурация Java-сервера
|
||||
- `X-Shine-Session-Id`
|
||||
- `X-Shine-Time-Ms`
|
||||
- `X-Shine-Signature`
|
||||
|
||||
```properties
|
||||
public.files.enabled=true
|
||||
public.files.storageDir=data/public-files
|
||||
public.files.maxBytes=536870912
|
||||
```
|
||||
Подписываемая строка `PUBLIC_R2_PREPARE_V1:{sessionId}:{pr}:{size}:{mm}:{timeMs}`.
|
||||
|
||||
Для production рекомендуется задать `public.files.storageDir` абсолютным путём, который одновременно доступен Java для записи и Caddy для чтения.
|
||||
Сервер проверяет авторизацию, Base58 32-байтного PR, размер (≤500 МиБ), MIME, выполняет S3 `HeadObject`. Если объект уже существует с тем же размером — возвращает `exists:true`; если нет — `uploadUrl`, `requiredHeaders`, `fileUrl`. Браузер делает один **Presigned PUT** прямо в S3 Endpoint R2 с обязательными подписанными заголовками, включая `If-None-Match: *` для защиты от перезаписи. Действие не использует R2 credential в браузере.
|
||||
|
||||
Например:
|
||||
Java **не проверяет реальный Pieces Root содержимого** и не гарантирует строгий объём через один заявленный клиентом `size`; нет Multipart, квот или автоматической проверки фактического PUT после выдачи URL. Неверный PR у первоначального объекта может нарушать дедупликацию — это известный компромисс MVP.
|
||||
|
||||
```text
|
||||
/home/player/shine-public-files
|
||||
```
|
||||
Конфигурация сервера: `R2_ENDPOINT`, `R2_ACCESS_KEY_ID`, `R2_SECRET_ACCESS_KEY`, `r2.publicBucket=shine-files`. CORS корзины должен разрешать origin PWA и PUT с подписанными заголовками. Ключи — только на сервере.
|
||||
|
||||
## 3. PUT `/files/<sha256>`
|
||||
## Исторический локальный API SHA-256
|
||||
|
||||
Загружает immutable public file. PUT требует активную пользовательскую сессию.
|
||||
Старый `PublicFileServlet` обслуживает `/files/<64 lowercase hex SHA-256>` на локальном диске (`public.files.storageDir`). Для старых файлов может продолжать работать GET/HEAD/PUT с проверкой SHA-256 и HTTP Range. Новые `pr`-файлы туда **не загружаются**. Детали legacy передавать только при поддержке исторических данных, не использовать этот API в новых тегах.
|
||||
|
||||
Заголовки:
|
||||
## Учёт разрешений R2 (PostgreSQL v42)
|
||||
|
||||
```text
|
||||
Content-Type: application/octet-stream
|
||||
X-Shine-Session-Id: <active session id>
|
||||
X-Shine-Time-Ms: <unix time ms>
|
||||
X-Shine-Content-Length: <file bytes>
|
||||
X-Shine-Signature: <Ed25519 signature, Base64>
|
||||
```
|
||||
|
||||
Подписываемая строка UTF-8:
|
||||
|
||||
```text
|
||||
PUBLIC_FILE_UPLOAD_V1:{sessionId}:{sha256}:{size}:{timeMs}
|
||||
```
|
||||
|
||||
Сервер потоково принимает байты, заново считает SHA-256 и принимает объект только если:
|
||||
|
||||
```text
|
||||
SHA256(received bytes) == sha256 из URL
|
||||
```
|
||||
|
||||
Если корректный объект уже существует и размер совпадает, PUT идемпотентно отвечает `alreadyExists=true`.
|
||||
|
||||
## 4. GET и HEAD (включая HTTP Range)
|
||||
|
||||
Java servlet обслуживает `GET /files/<sha256>` и `HEAD /files/<sha256>`.
|
||||
Проверка SHA-256 **при чтении не выполняется**: хеш проверяется при исходном PUT,
|
||||
файл immutable, а скачивание не должно требовать предварительного прочтения всех байтов.
|
||||
Проверка корректности при повторном PUT уже имеющегося объекта сохранена.
|
||||
|
||||
Полный GET, как и прежде, возвращает `200 OK` и `Content-Length` всего файла.
|
||||
HEAD всегда возвращает метаданные **полного объекта** без тела и без обхода
|
||||
всего файла по байтам (Range в HEAD игнорируется).
|
||||
|
||||
Для `GET` с одним диапазоном:
|
||||
|
||||
```http
|
||||
Range: bytes=0-262143
|
||||
```
|
||||
|
||||
Ответ:
|
||||
|
||||
```http
|
||||
HTTP/1.1 206 Partial Content
|
||||
Accept-Ranges: bytes
|
||||
Content-Range: bytes 0-262143/<общий размер>
|
||||
Content-Length: 262144
|
||||
ETag: "<sha256>"
|
||||
```
|
||||
|
||||
Поддерживаются формы `bytes=START-END`, `bytes=START-` и `bytes=-SUFFIX`.
|
||||
Для составных или неудовлетворяемых диапазонов сервер возвращает `416` +
|
||||
`Content-Range: bytes */<общий размер>`. `If-Range` поддерживает точный
|
||||
совпадающий ETag; при несовпадении возвращается полный `200`.
|
||||
|
||||
Остальные заголовки:
|
||||
|
||||
```http
|
||||
Cache-Control: public, max-age=31536000, immutable
|
||||
Cross-Origin-Resource-Policy: cross-origin
|
||||
Access-Control-Allow-Origin: *
|
||||
```
|
||||
|
||||
Тип для MP4, WebM, Ogg и AVI Java определяет по первым байтам файла.
|
||||
Неизвестные типы остаются `application/octet-stream`. Протокол `S:att`
|
||||
не меняется, имя файла/тип на сервере не сохраняются.
|
||||
|
||||
При прямой выдаче Caddy (`file_server`) Range обеспечивает Caddy, а не Java.
|
||||
Следует проверить `Content-Type` (у файлов с именем SHA-256 нет расширения),
|
||||
а также корректность ответа `206` через публичный домен, особенно с CDN.
|
||||
Если нужен корректный MIME по сигнатуре, используйте HTTP reverse_proxy к Java
|
||||
из инструкции `deploy/PUBLIC_FILES_CADDY_CLOUDFLARE.md`.
|
||||
|
||||
## 5. Связь с `S:att`
|
||||
|
||||
```text
|
||||
<S:att;v=1;nm=photo.jpg;sz=12345;sha256=<64 hex>>
|
||||
```
|
||||
|
||||
означает public file на текущем сервере доступа автора.
|
||||
|
||||
```text
|
||||
<S:att;v=1;nm=photo.jpg;sz=12345;sha256=<64 hex>;ar=<txId>>
|
||||
```
|
||||
|
||||
означает Arweave.
|
||||
|
||||
Адрес сервера доступа в блок не записывается. При чтении клиент определяет текущий access server автора через его PDA и строит:
|
||||
|
||||
```text
|
||||
https://<current-access-server>/files/<sha256>
|
||||
```
|
||||
|
||||
## 6. Preview
|
||||
|
||||
В UI видео со storage=server получает прямую ссылку `/files/<sha256>` (без полного `fetch` в Blob): браузер сам запрашивает диапазоны, читает длительность и загружает стартовый кадр. Размер берётся из `sz` вложения. Для Arweave частичная загрузка зависит от gateway.
|
||||
|
||||
Отдельных preview-файлов сейчас нет. `preAr`, `preSha256`, `previewAr`, `previewSha256` не являются частью текущего протокола.
|
||||
|
||||
|
||||
## R2 direct upload (MVP, 2026-11)
|
||||
|
||||
New public attachments use BitTorrent v2 `pr` (canonical Base58 encoding of the 32-byte Pieces Root, normally 43–44 characters, variable length 32–44), `mm` (optional MIME) and `v=1`. Avatars retain the original SHA-256 `/files/<sha256>` API. The client signs `PUBLIC_R2_PREPARE_V1:{sessionId}:{pr}:{size}:{mm}:{timeMs}` with its Ed25519 session key, submits JSON `{pr,size,mm}` to `POST /api/files/prepare` and provides `X-Shine-Session-Id`, `X-Shine-Time-Ms` and `X-Shine-Signature`. The endpoint returns `exists`, `fileUrl`, and for missing objects `uploadUrl` and `requiredHeaders`. The browser uploads the original Blob directly to the S3 endpoint, not the Java server. A signature does not certify the hash of uploaded content. The public GET URL is `https://files.shineup.me/<pr>`; the R2 object key is exactly the same Base58 `pr` (no extension). Old Base64URL PR identifiers are not read or migrated. Arweave TX IDs and DM file identifiers keep their existing encodings. Client and Java server must be updated together.
|
||||
|
||||
Configuration: `R2_ENDPOINT`, `R2_ACCESS_KEY_ID`, `R2_SECRET_ACCESS_KEY`, `r2.publicBucket=shine-files` (or `r2.endpoint`, `r2.accessKeyId`, `r2.secretAccessKey` in trusted server config). Never publish keys. Configure browser CORS to permit signed PUT headers including `If-None-Match`. Max size: 500 MiB. Single PUT only, no multipart in this MVP.
|
||||
|
||||
|
||||
## Единый формат публичных идентификаторов
|
||||
Аватарки и публичные вложения имеют одинаковый `PR = Base58(BitTorrent v2 Pieces Root)` и сохраняются в **корень** R2 bucket `shine-files`, URL `https://files.shineup.me/<PR>`. Папки `avatars/` нет; загрузка идёт через `/api/files/prepare`, не через `/api/avatars/prepare`. После оптимизации изображения вычисляется PR от именно передаваемых байтов. `<S:ava;v=2;sz=N;pr=BASE58[;ar=TXID]>`; `ar` остаётся нативным Arweave TX ID в Base64URL. Старые `<S:ava;v=1;...sha256=...>` не поддерживаются.
|
||||
|
||||
Для потенциального **будущего** SHA-256 типа идентификатора публичного файла используем `Base58(SHA-256(bytes))`, а не hex. Это отдельный алгоритм, его нельзя смешивать с PR. На данный момент новые публичные вложения/аватарки не используют SHA-256 как идентификатор.
|
||||
В `public_file_uploads` пишется событие после успешной авторизации и решения S3: логин, PR, заявленный размер, `requested_at`, `disposition` (`upload_url_issued` или `already_exists`). **Это журнал выдачи разрешения/повторного использования, а не доказательство завершённого PUT.** Повторные попытки фиксируются отдельными строками. Лимитов и блокировок по журналу пока нет. Параллельная таблица DM описана в `docs/API/18_DM_File_Storage_API.md`.
|
||||
|
||||
@@ -1,132 +1,35 @@
|
||||
# Вложения в TEXT-сообщениях (`S:att v=1`)
|
||||
# Вложения в TEXT-сообщениях (`S:att;v=1`)
|
||||
|
||||
Документ фиксирует текущий формат вложений в текстовых блоках SHiNE.
|
||||
Технический префикс в UTF-8 `text` для `TEXT_POST`, `TEXT_REPLY`, `TEXT_EDIT_POST`, `TEXT_EDIT_REPLY`. Бинарный формат TEXT не меняется. До 10 вложений в начале сообщения, затем обычный текст; порядок сохраняется.
|
||||
|
||||
## Область применения
|
||||
|
||||
Формат применяется к UTF-8 полю `text` в TEXT-блоках:
|
||||
|
||||
- `TEXT_POST`
|
||||
- `TEXT_REPLY`
|
||||
- `TEXT_EDIT_POST`
|
||||
- `TEXT_EDIT_REPLY`
|
||||
|
||||
Бинарный формат `TextBody` не меняется. Вложения являются техническим префиксом внутри обычного текста.
|
||||
|
||||
## Общий вид
|
||||
|
||||
Arweave-вложение:
|
||||
## Канонический формат (2026-11)
|
||||
|
||||
```text
|
||||
<S:att;v=1;nm=report.pdf;sz=845221;sha256=0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef;ar=AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA>
|
||||
<S:att;v=1;nm=photo.jpg;sz=248193;pr=BASE58_ROOT;mm=image/jpeg>
|
||||
<S:att;v=1;nm=video.mp4;sz=15000000;pr=BASE58_ROOT;mm=video/mp4;ar=TXID>
|
||||
Текст публикации
|
||||
```
|
||||
|
||||
Public file на сервере доступа автора:
|
||||
- `v` — версия (1).
|
||||
- `nm` — имя файла в `encodeURIComponent`.
|
||||
- `sz` — размер подготовленных байтов в десятичном виде.
|
||||
- `pr` — **BitTorrent v2 Pieces Root (32 байта), Base58**, не SHA-256 целого файла; текущий стандарт новых вложений.
|
||||
- `mm` — необязательный MIME, в формате `type/subtype`; неизвестный — `application/octet-stream`.
|
||||
- `ar` — необязательный Arweave Transaction ID, нативный формат Arweave.
|
||||
- `sha256` — исторический lowercase hex SHA-256 для старых тегов/объектов; новые записи его не создают.
|
||||
|
||||
```text
|
||||
<S:att;v=1;nm=report.pdf;sz=845221;sha256=0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef>
|
||||
```
|
||||
`ar` присутствует → получить файл через Arweave gateway. Нет `ar`, есть `pr` → `https://files.shineup.me/<pr>`. Исторический `sha256` без `pr`/`ar` → прежний `/files/<sha256>` access-сервера автора. `storage=r2` и абсолютные URL в тег не записываются.
|
||||
|
||||
Несколько вложений идут подряд в самом начале текста:
|
||||
Идентификаторы новых аватаров — тоже **Base58(PR)**, но формат аватара отдельный: `<S:ava;v=2;sz=N;pr=ROOT[;ar=TXID]>`. Формат v1/SHA-256 аватаров больше не создаётся; миграция v41 не конвертирует старые значения.
|
||||
|
||||
```text
|
||||
<S:att;v=1;nm=photo.jpg;sz=248193;sha256=aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa>
|
||||
<S:att;v=1;nm=report.pdf;sz=845221;sha256=cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc;ar=DDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDD>
|
||||
Текст сообщения
|
||||
```
|
||||
## Отображение и безопасность
|
||||
|
||||
После последнего attach-блока идёт обычный пользовательский текст. Пользовательский текст может быть пустым, если есть хотя бы одно валидное вложение.
|
||||
Клиент берёт тип по `mm` (при его наличии), иначе пытается использовать расширение `nm`. Для HTTP-открытия URL без расширения R2 также хранит `Content-Type` в метаданных объекта. Изображения загружаются `loading="lazy"`; публичные видео не получают `src`, пока не приблизились к экрану (`IntersectionObserver` с fallback). Встроенное отображение использует исходный файл, дополнительных preview-объектов нет.
|
||||
|
||||
Клиент SHiNE ограничивает одно сообщение максимум 10 вложениями и сохраняет порядок attach-блоков.
|
||||
HTML, SVG, XHTML, JavaScript, XML по расширению или MIME выводятся карточками с подтверждением перед переходом из UI. Пользователь может отменить открытие; прямые ссылки R2/Arweave обходят это предупреждение. Это не изменение доступа, криптографии или правила хранения и **не даёт защиты от вредоносного содержимого на уровне HTTP**.
|
||||
|
||||
## Поля
|
||||
Публичные вложения сохраняются на R2 либо в Arweave без автоматического удаления; DM-вложения используют отдельный протокол, см. `docs/Personal_Messages/Файлы_DM_v3_R2.md`. Редактирование текста сохраняет технические attach-блоки и не переносит объекты между хранилищами.
|
||||
|
||||
Обязательные поля:
|
||||
## Совместимость
|
||||
|
||||
- `v=1` - версия формата attach-блока;
|
||||
- `nm` - имя файла, закодированное через `encodeURIComponent`;
|
||||
- `sz` - размер файла в байтах;
|
||||
- один из идентификаторов файла: `pr` — pieces root BitTorrent v2 (base64url, 43 символа) для новых вложений; `sha256` — hex SHA-256 (64 символа) для совместимости со старыми.
|
||||
|
||||
Опциональные поля:
|
||||
|
||||
- `ar` - короткий Arweave Transaction ID, 43 символа, без gateway URL;
|
||||
- `mm` - MIME типа `image/jpeg` или `video/mp4`; если отсутствует, UI использует расширение `nm`.
|
||||
|
||||
Источник определяется следующим образом:
|
||||
|
||||
- `ar` присутствует -> Arweave;
|
||||
- `ar` отсутствует, но есть `pr` -> публичный Cloudflare R2 (`https://files.shineup.me/<pr>`);
|
||||
- `ar` и `pr` отсутствуют, есть `sha256` -> старое файловое хранилище сервера доступа автора.
|
||||
|
||||
Адрес сервера автора, URL файла и login автора в attach-блок не записываются: автор уже известен из подписанного блока. Старые файлы разрешаются через сервер доступа, новые R2 — по `pr`.
|
||||
|
||||
## Preview
|
||||
|
||||
Отдельные preview-файлы в текущем протоколе **не поддерживаются и пока не нужны**.
|
||||
|
||||
Клиент не должен создавать или использовать поля `preAr`, `preSha256`, `previewAr`, `previewSha256`. Для изображения или видео используется исходный файл вложения.
|
||||
|
||||
Если такие поля встречаются в экспериментальных старых данных, текущая реализация может их игнорировать; они не являются частью канонического `S:att v=1`.
|
||||
|
||||
## Хранение файла
|
||||
|
||||
Сам файл всегда находится вне блокчейна.
|
||||
|
||||
### Arweave
|
||||
|
||||
Если присутствует `ar`, файл читается через настроенный Arweave gateway по указанному `txId`.
|
||||
|
||||
### Cloudflare R2 (новые публичные файлы)
|
||||
|
||||
Если `ar` отсутствует и указан `pr`, клиент использует прямой адрес `https://files.shineup.me/<pr>`. Браузер запрашивает исходное медиа напрямую; сервер Java в отдаче файла не участвует. При видео браузер может запрашивать только метаданные и нужные фрагменты через HTTP Range.
|
||||
|
||||
### Сервер доступа (старые вложения с SHA-256)
|
||||
|
||||
Если `ar` и `pr` отсутствуют, клиент:
|
||||
|
||||
1. определяет текущий сервер доступа автора сообщения;
|
||||
2. запрашивает файл по стандартному пути `/files/<sha256>`;
|
||||
3. использует прежний формат ссылок для совместимости с существующими сообщениями.
|
||||
|
||||
URL или домен конкретного сервера в блокчейн не записывается. Поэтому смена сервера доступа не требует изменения старых сообщений.
|
||||
|
||||
## Создание вложения в UI
|
||||
|
||||
UI предлагает два способа хранения публичных вложений: `Cloudflare R2` (через пункт сервера доступа) и `Arweave`. Отдельные preview-файлы не создаются.
|
||||
|
||||
После загрузки в R2 формируется `S:att v=1` с `pr` и `mm`, без `ar`. Для Arweave используется механизм Arweave/Turbo; дополнительно записывается `ar`.
|
||||
|
||||
Журнал загрузок Arweave хранится только в `sessionStorage` текущего браузера и не является частью блокчейна.
|
||||
|
||||
## Отображение
|
||||
|
||||
Клиент при чтении сообщения:
|
||||
|
||||
1. читает валидные attach-блоки только из начала текста;
|
||||
2. скрывает технические attach-строки;
|
||||
3. определяет источник по наличию `ar`;
|
||||
4. получает Arweave-файл по `txId`, R2-файл по `pr` либо старый server-файл по `/files/<sha256>`;
|
||||
5. определяет тип вложения по `mm` (если указан), иначе по расширению `nm`;
|
||||
6. изображение отображает из исходного файла;
|
||||
7. видео отображает из исходного файла и открывает HTML5-плеер;
|
||||
8. обычный файл показывает как карточку с именем, размером и скачиванием;
|
||||
9. при перелистывании останавливает воспроизводящееся видео;
|
||||
10. битый attach-блок игнорирует, не ломая остальное сообщение.
|
||||
|
||||
## Редактирование
|
||||
|
||||
При редактировании сообщения UI сохраняет существующие attach-блоки и меняет только пользовательский текст. Удаление сообщения выполняется через edit-блок с пустым текстом, как описано в `11_TEXT_Blocks.md`.
|
||||
|
||||
## Совместимость и ограничения
|
||||
|
||||
- полный URL в поле `ar` не используется;
|
||||
- для старых `sha256`-вложений MIME не записывался, тип UI определяется по расширению `nm`;
|
||||
- старые текстовые префиксы `<SHiNE:attach ...>` и `<S:attach ...>` могут продолжать читаться как совместимые формы;
|
||||
- отдельные preview-поля не входят в текущий протокол;
|
||||
- `width`, `height`, `duration` и `thumbnail` не записываются отдельными полями; новые вложения могут содержать `mm` (MIME).
|
||||
|
||||
|
||||
## MVP R2 (2026-11): новые публичные вложения
|
||||
|
||||
Для **новых** публичных вложений использовать `<S:att;v=1;nm=video.mp4;sz=12345;pr=BASE64URL;mm=video/mp4>`; при загрузке в Arweave добавляется `;ar=TXID`. `pr` — 32-байтный BitTorrent v2 pieces root в base64url без padding (43 символа), а не SHA-256 файла. `mm` необязателен; отсутствие означает `application/octet-stream`. Новое публичное вложение без `ar` скачивается с `https://files.shineup.me/<pr>`. `storage=r2` отсутствует. Новые аватары **не изменяются**: SHA-256 и старый API `/files/<sha256>` остаются. Существующий формат чтения `sha256` оставлен для ранее созданных данных и уже загруженных транзакций Arweave. Публичные изображения и видео показываются внутри сообщения из исходного файла (`<img>` / `<video preload="metadata">`) и открываются в общем просмотрщике; PDF, архивы и другие файлы остаются карточками. Тип определяется по `mm`, если он указан и не равен `application/octet-stream`, иначе — по расширению `nm`. Если браузер не может декодировать файл, сохраняется карточка для скачивания (если HEAD-запрос недоступен, показывается ошибка файла). Клиент не скачивает медиа целиком через JavaScript для предпросмотра. UI личных зашифрованных файлов не меняется.
|
||||
Парсер терпимо читает старое поле `sha256` и префиксы `<SHiNE:attach>`/`<S:attach>`, если данные сохранились. Массовая миграция не выполняется. Экспериментальные `preAr`, `preSha256`, `previewAr`, `previewSha256`, `width`, `duration`, `thumbnail` не входят в протокол.
|
||||
|
||||
@@ -92,3 +92,7 @@ DM v1 и DM v2 читаются прежними обработчиками (с
|
||||
- Java-сервер не доказывает соответствие присланных байтов объявленному SHA-256; повреждённые объекты обнаруживаются получателем. Подмена первого объекта до дедупликации требует отдельной доверенной проверки в будущем.
|
||||
- Заявленный размер и URL не защищают от всех злоупотреблений: для публичного запуска дополнительно нужны лимиты и мониторинг R2-расходов.
|
||||
- Удаление из R2 не удаляет уже скачанные копии, CDN-кэш и копии у получателей.
|
||||
|
||||
## Журнал выдачи R2 разрешений (PostgreSQL v42)
|
||||
|
||||
Сервер записывает в `dm_file_uploads` одну строку **на каждый зашифрованный объект**, для которого был выдан URL, либо обнаружено существование объекта. Поля: `user_login`, `file_hash` (Base58 SHA-256 ciphertext), `file_size_bytes`, `requested_at`, `disposition`. Это *не* подтверждение успешной передачи в R2 и *не* одна строка на исходный файл: один DM может содержать много частей и манифест. Ни исходное имя, ни MIME, ни AES-ключ не попадают в журнал. Криптография и формат `S:file;v=3` не меняются.
|
||||
|
||||
@@ -1,5 +1,6 @@
|
||||
import assert from 'node:assert/strict';
|
||||
import { preparePublicFile, fileMime } from '../../shine-UI/js/services/file-preparation-service.js';
|
||||
import { validatePublicPiecesRoot } from '../../shine-UI/js/services/public-pieces-root.js';
|
||||
|
||||
assert.equal(fileMime(new File(['x'], 'clip.mp4', { type: '' })), 'video/mp4');
|
||||
assert.equal(fileMime(new File(['x'], 'mystery', { type: '' })), 'application/octet-stream');
|
||||
@@ -7,7 +8,8 @@ for (const size of [1, 16384, 16385, 1048576, 1048577, 2097152]) {
|
||||
const blob = new File([new Uint8Array(size)], 'data.bin');
|
||||
const prepared = await preparePublicFile(blob);
|
||||
assert.equal(prepared.size, size);
|
||||
assert.match(prepared.pr, /^[A-Za-z0-9_-]{43}$/);
|
||||
assert.match(prepared.pr, /^[1-9A-HJ-NP-Za-km-z]{32,44}$/);
|
||||
assert.equal(validatePublicPiecesRoot(prepared.pr), true);
|
||||
assert.equal((await preparePublicFile(blob)).pr, prepared.pr);
|
||||
}
|
||||
console.log('R2 client preparation smoke tests OK');
|
||||
|
||||
@@ -0,0 +1,18 @@
|
||||
import assert from 'node:assert/strict';
|
||||
import { readFile } from 'node:fs/promises';
|
||||
const root = new URL('../../', import.meta.url);
|
||||
const migration = await readFile(new URL('SHiNE-server/shine-server-db/src/main/resources/postgres/migration_v42.sql', root), 'utf8');
|
||||
const boot = await readFile(new URL('SHiNE-server/shine-server-db/src/main/java/shine/db/DatabaseInitializer.java', root), 'utf8');
|
||||
const recorder = await readFile(new URL('SHiNE-server/src/main/java/server/files/R2UploadAuditRecorder.java', root), 'utf8');
|
||||
const publicApi = await readFile(new URL('SHiNE-server/src/main/java/server/files/R2PrepareServlet.java', root), 'utf8');
|
||||
const dmApi = await readFile(new URL('SHiNE-server/src/main/java/server/files/R2DmPrepareServlet.java', root), 'utf8');
|
||||
for (const table of ['public_file_uploads', 'dm_file_uploads']) {
|
||||
assert.ok(migration.includes(`CREATE TABLE IF NOT EXISTS ${table}`));
|
||||
assert.ok(recorder.includes(`"${table}"`));
|
||||
}
|
||||
assert.match(migration, /schema_version = 42/);
|
||||
assert.match(boot, /SCHEMA_VERSION_42 = 42/);
|
||||
assert.match(boot, /POSTGRES_MIGRATION_V42_RESOURCE/);
|
||||
assert.match(publicApi, /R2UploadAuditRecorder\.record\(req, false/);
|
||||
assert.match(dmApi, /R2UploadAuditRecorder\.record\(req, true/);
|
||||
console.log('R2 upload audit schema wiring OK');
|
||||
@@ -4429,7 +4429,10 @@
|
||||
"next_attachment": "Next attachment",
|
||||
"loading_file": "Loading file…",
|
||||
"bytes": "{count} B",
|
||||
"counter": "{current} of {total}"
|
||||
"counter": "{current} of {total}",
|
||||
"external_file_title": "Open external file",
|
||||
"external_file_warning": "You are opening a user-uploaded file. It may contain active code or unwanted content. SHiNE is not responsible for third-party file content. Continue?",
|
||||
"open_external_file": "Open file"
|
||||
},
|
||||
"call_ui": {
|
||||
"user": "user",
|
||||
|
||||
@@ -4429,7 +4429,10 @@
|
||||
"next_attachment": "Следующее вложение",
|
||||
"loading_file": "Загружаем файл…",
|
||||
"bytes": "{count} Б",
|
||||
"counter": "{current} из {total}"
|
||||
"counter": "{current} из {total}",
|
||||
"external_file_title": "Переход к внешнему файлу",
|
||||
"external_file_warning": "Вы открываете файл, загруженный пользователем. Он может содержать активный код или нежелательное содержимое. SHiNE не отвечает за содержимое сторонних файлов. Продолжить?",
|
||||
"open_external_file": "Открыть файл"
|
||||
},
|
||||
"call_ui": {
|
||||
"user": "пользователь",
|
||||
|
||||
@@ -1,6 +1,7 @@
|
||||
import { t, th } from '../i18n/index.js';
|
||||
import { formatNumber } from '../i18n/format.js';
|
||||
import { openMediaViewer } from '../components/media-viewer.js';
|
||||
import { confirmDialog } from '../components/confirm-dialog.js';
|
||||
import { buildArweaveDataUrl, sha256HexFromArrayBuffer, validateArweaveTxId, validateSha256Hex } from './arweave-file-service.js';
|
||||
import { resolvePublicFileUrl } from './public-file-service.js';
|
||||
import { validatePublicPiecesRoot } from './public-pieces-root.js';
|
||||
@@ -141,6 +142,69 @@ export function getAttachmentKind(attachment = {}) {
|
||||
return 'file';
|
||||
}
|
||||
|
||||
// HTML/SVG и похожие активные файлы не показываем встроенным медиаплеером.
|
||||
// Проверяем как MIME, так и расширение: оба значения сообщает сам отправитель.
|
||||
const ACTIVE_FILE_EXTENSIONS = new Set(['html', 'htm', 'xhtml', 'svg', 'js', 'mjs', 'xml']);
|
||||
const ACTIVE_FILE_MIMES = new Set([
|
||||
'text/html', 'application/xhtml+xml', 'image/svg+xml', 'text/javascript',
|
||||
'application/javascript', 'application/xml', 'text/xml',
|
||||
]);
|
||||
export function isPotentiallyActiveAttachment(item = {}) {
|
||||
const mime = String(item.mm || '').trim().toLowerCase().split(';')[0];
|
||||
return ACTIVE_FILE_MIMES.has(mime) || ACTIVE_FILE_EXTENSIONS.has(getAttachmentExtension(item.name));
|
||||
}
|
||||
|
||||
// Один наблюдатель на все видео, чтобы лента с сотней сообщений не создавалa
|
||||
// сотню сетевых запросов и отдельных IntersectionObserver.
|
||||
const pendingPublicVideoLoads = new Map();
|
||||
let publicVideoObserver = null;
|
||||
let publicVideoRemovalObserver = null;
|
||||
function stopUnusedVideoObservers() {
|
||||
if (pendingPublicVideoLoads.size) return;
|
||||
publicVideoObserver?.disconnect();
|
||||
publicVideoRemovalObserver?.disconnect();
|
||||
publicVideoObserver = null;
|
||||
publicVideoRemovalObserver = null;
|
||||
}
|
||||
function preparePublicVideoLazyLoad(video, url) {
|
||||
if (typeof IntersectionObserver !== 'function') {
|
||||
// Старые браузеры сохраняют обычное поведение.
|
||||
video.preload = 'metadata';
|
||||
video.src = url;
|
||||
return;
|
||||
}
|
||||
if (!publicVideoObserver) {
|
||||
publicVideoObserver = new IntersectionObserver((entries) => {
|
||||
for (const entry of entries) {
|
||||
if (!entry.isIntersecting) continue;
|
||||
const source = pendingPublicVideoLoads.get(entry.target);
|
||||
if (!source) continue;
|
||||
pendingPublicVideoLoads.delete(entry.target);
|
||||
publicVideoObserver?.unobserve(entry.target);
|
||||
if (entry.target.isConnected) {
|
||||
entry.target.preload = 'metadata';
|
||||
entry.target.src = source;
|
||||
}
|
||||
}
|
||||
stopUnusedVideoObservers();
|
||||
}, { rootMargin: '240px 0px' });
|
||||
}
|
||||
pendingPublicVideoLoads.set(video, url);
|
||||
publicVideoObserver.observe(video);
|
||||
// Отписка для удалённых из DOM видео: observer иначе держит ссылки на них.
|
||||
if (!publicVideoRemovalObserver && typeof MutationObserver === 'function' && document.documentElement) {
|
||||
publicVideoRemovalObserver = new MutationObserver(() => {
|
||||
for (const pending of pendingPublicVideoLoads.keys()) {
|
||||
if (pending.isConnected) continue;
|
||||
publicVideoObserver?.unobserve(pending);
|
||||
pendingPublicVideoLoads.delete(pending);
|
||||
}
|
||||
stopUnusedVideoObservers();
|
||||
});
|
||||
publicVideoRemovalObserver.observe(document.documentElement, { childList: true, subtree: true });
|
||||
}
|
||||
}
|
||||
|
||||
function isRecentMessage(messageTimestampMs) {
|
||||
const ts = Number(messageTimestampMs || 0);
|
||||
if (!Number.isFinite(ts) || ts <= 0) return false;
|
||||
@@ -199,7 +263,7 @@ function replaceWithUnavailable(slide, messageTimestampMs, storage = 'arweave',
|
||||
slide.replaceChildren(createUnavailableBlock(messageTimestampMs, storage, detail));
|
||||
}
|
||||
|
||||
function createFileCard({ item, url, messageTimestampMs, slide }) {
|
||||
function createFileCard({ item, url, messageTimestampMs, slide, warnOnOpen = false }) {
|
||||
const card = document.createElement('div');
|
||||
card.className = 'message-attachment-file-card';
|
||||
card.role = 'button';
|
||||
@@ -212,7 +276,21 @@ function createFileCard({ item, url, messageTimestampMs, slide }) {
|
||||
<div class="message-attachment-meta">${escapeHtml(formatBytes(item.size))}</div>
|
||||
</div>
|
||||
`;
|
||||
const openFile = () => window.open(url, '_blank', 'noopener');
|
||||
const openFile = async () => {
|
||||
if (warnOnOpen && isPotentiallyActiveAttachment(item)) {
|
||||
const confirmed = await confirmDialog({
|
||||
title: t('remaining.attachments.external_file_title'),
|
||||
text: t('remaining.attachments.external_file_warning'),
|
||||
confirmLabel: t('remaining.attachments.open_external_file'),
|
||||
});
|
||||
if (!confirmed) return;
|
||||
// Навигация в этой вкладке работает и после асинхронного подтверждения:
|
||||
// window.open() после Promise браузер может заблокировать как popup.
|
||||
window.location.assign(url);
|
||||
return;
|
||||
}
|
||||
window.open(url, '_blank', 'noopener');
|
||||
};
|
||||
card.addEventListener('click', (event) => {
|
||||
event.stopPropagation();
|
||||
openFile();
|
||||
@@ -241,7 +319,7 @@ function formatVideoDuration(seconds) {
|
||||
: `${String(minutes).padStart(2, '0')}:${secondsPart}`;
|
||||
}
|
||||
|
||||
function createMediaSlide({ item, url, kind, messageTimestampMs, slide, onOpen, onError = null }) {
|
||||
function createMediaSlide({ item, url, kind, messageTimestampMs, slide, onOpen, onError = null, lazyVideo = false }) {
|
||||
const frame = document.createElement('div');
|
||||
frame.className = `message-attachment-media-frame message-attachment-media-frame--${kind}`;
|
||||
frame.role = 'button';
|
||||
@@ -288,7 +366,7 @@ function createMediaSlide({ item, url, kind, messageTimestampMs, slide, onOpen,
|
||||
} else {
|
||||
const video = document.createElement('video');
|
||||
video.className = 'message-attachment-media';
|
||||
video.preload = 'metadata';
|
||||
video.preload = 'none';
|
||||
video.muted = true;
|
||||
video.playsInline = true;
|
||||
video.addEventListener('error', handleError, { once: true });
|
||||
@@ -310,7 +388,8 @@ function createMediaSlide({ item, url, kind, messageTimestampMs, slide, onOpen,
|
||||
try { video.currentTime = Math.min(0.05, video.duration); } catch { /* зависит от кодека */ }
|
||||
}
|
||||
}, { once: true });
|
||||
video.src = url;
|
||||
if (lazyVideo) preparePublicVideoLazyLoad(video, url);
|
||||
else { video.preload = 'metadata'; video.src = url; }
|
||||
const play = document.createElement('span');
|
||||
play.className = 'message-attachment-play';
|
||||
play.textContent = '▶';
|
||||
@@ -424,7 +503,7 @@ export function createAttachmentCarouselElement(attachments = [], {
|
||||
const resolvedUrls = new Map();
|
||||
const openPublicViewer = (selectedIndex) => {
|
||||
const media = items.flatMap((entry, i) => {
|
||||
const kind = getAttachmentKind(entry);
|
||||
const kind = isPotentiallyActiveAttachment(entry) ? 'file' : getAttachmentKind(entry);
|
||||
const url = resolvedUrls.get(i);
|
||||
return url && (kind === 'image' || kind === 'video')
|
||||
? [{ i, kind, url, name: entry.name }]
|
||||
@@ -440,15 +519,15 @@ export function createAttachmentCarouselElement(attachments = [], {
|
||||
wrap.append(slot);
|
||||
void resolveAttachmentDisplayUrl(item, options)
|
||||
.then(({ url }) => {
|
||||
const kind = getAttachmentKind(item);
|
||||
const kind = isPotentiallyActiveAttachment(item) ? 'file' : getAttachmentKind(item);
|
||||
const content = kind === 'file'
|
||||
? createFileCard({ item, url, messageTimestampMs, slide: slot })
|
||||
? createFileCard({ item, url, messageTimestampMs, slide: slot, warnOnOpen: true })
|
||||
: createMediaSlide({
|
||||
item, url, kind, messageTimestampMs, slide: slot,
|
||||
item, url, kind, messageTimestampMs, slide: slot, lazyVideo: true,
|
||||
onOpen: () => openPublicViewer(index),
|
||||
// Если формат/кодек не поддерживается браузером, файл всё ещё
|
||||
// можно открыть или скачать через обычную карточку.
|
||||
onError: () => slot.replaceChildren(createFileCard({ item, url, messageTimestampMs, slide: slot })),
|
||||
onError: () => slot.replaceChildren(createFileCard({ item, url, messageTimestampMs, slide: slot, warnOnOpen: true })),
|
||||
});
|
||||
resolvedUrls.set(index, url);
|
||||
slot.replaceChildren(content);
|
||||
|
||||
@@ -49,12 +49,15 @@ class TestElement {
|
||||
|
||||
function loadRenderer() {
|
||||
const viewerCalls = [];
|
||||
const warningCalls = [];
|
||||
const navigations = [];
|
||||
let approveWarning = true;
|
||||
const normalized = source
|
||||
.replace(/^import .*;\s*$/gm, '')
|
||||
.replace(/^export /gm, '');
|
||||
const factory = new Function('t', 'th', 'formatNumber', 'openMediaViewer', 'buildArweaveDataUrl',
|
||||
'validateArweaveTxId', 'validateSha256Hex', 'resolvePublicFileUrl', 'validatePublicPiecesRoot', 'document', 'window', 'fetch',
|
||||
`${normalized}\nreturn { getAttachmentKind, createAttachmentCarouselElement, parseMessageAttachments };`);
|
||||
'validateArweaveTxId', 'validateSha256Hex', 'resolvePublicFileUrl', 'validatePublicPiecesRoot', 'confirmDialog', 'document', 'window', 'fetch',
|
||||
`${normalized}\nreturn { getAttachmentKind, isPotentiallyActiveAttachment, createAttachmentCarouselElement, parseMessageAttachments };`);
|
||||
const api = factory(
|
||||
(key) => key,
|
||||
() => '<span>FILE</span></div>',
|
||||
@@ -65,11 +68,12 @@ function loadRenderer() {
|
||||
(id) => /^[a-f0-9]{64}$/.test(id),
|
||||
async ({ pr, sha256 }) => pr ? `https://files.shineup.me/${pr}` : `https://old.example/files/${sha256}`,
|
||||
validatePublicPiecesRoot,
|
||||
async (options) => { warningCalls.push(options); return approveWarning; },
|
||||
{ createElement: (tag) => new TestElement(tag) },
|
||||
{ location: { origin: 'https://shineup.me' }, open() {} },
|
||||
{ location: { origin: 'https://shineup.me', assign: (url) => navigations.push(url) }, open() {} },
|
||||
async () => ({ ok: true }),
|
||||
);
|
||||
return { ...api, viewerCalls };
|
||||
return { ...api, viewerCalls, warningCalls, navigations, setApproveWarning: (value) => { approveWarning = value; } };
|
||||
}
|
||||
|
||||
const settle = () => new Promise((resolve) => setImmediate(resolve));
|
||||
@@ -154,3 +158,55 @@ test('просмотрщик импортирует t для aria-label диал
|
||||
const viewer = await readFile(new URL('../js/components/media-viewer.js', import.meta.url), 'utf8');
|
||||
assert.match(viewer, /import \{ t, th \} from '\.\.\/i18n\/index\.js';/);
|
||||
});
|
||||
|
||||
|
||||
test('публичное видео не получает src до входа в область просмотра', async () => {
|
||||
const previous = globalThis.IntersectionObserver;
|
||||
const observers = [];
|
||||
class FakeIntersectionObserver {
|
||||
constructor(callback, options) { this.callback = callback; this.options = options; this.targets = new Set(); observers.push(this); }
|
||||
observe(node) { this.targets.add(node); }
|
||||
unobserve(node) { this.targets.delete(node); }
|
||||
disconnect() { this.targets.clear(); }
|
||||
reveal(node) { this.callback([{ target: node, isIntersecting: true }]); }
|
||||
}
|
||||
globalThis.IntersectionObserver = FakeIntersectionObserver;
|
||||
try {
|
||||
const { createAttachmentCarouselElement } = loadRenderer();
|
||||
const root = createAttachmentCarouselElement([{ name: 'clip.mp4', size: 1000, pr: 'A'.repeat(43), mm: 'video/mp4' }]);
|
||||
await settle();
|
||||
const video = root.querySelectorAll('video')[0];
|
||||
assert.equal(video.preload, 'none');
|
||||
assert.equal(video.src, undefined);
|
||||
assert.equal(observers.length, 1);
|
||||
observers[0].reveal(video);
|
||||
assert.equal(video.src, `https://files.shineup.me/${'A'.repeat(43)}`);
|
||||
assert.equal(video.preload, 'metadata');
|
||||
assert.equal(observers[0].targets.size, 0);
|
||||
} finally {
|
||||
if (previous === undefined) delete globalThis.IntersectionObserver;
|
||||
else globalThis.IntersectionObserver = previous;
|
||||
}
|
||||
});
|
||||
|
||||
test('HTML/SVG открываются только после подтверждения, отказ не навигирует', async () => {
|
||||
const api = loadRenderer();
|
||||
const root = api.createAttachmentCarouselElement([
|
||||
{ name: 'vector.svg', size: 500, pr: 'A'.repeat(43), mm: 'image/svg+xml' },
|
||||
{ name: 'run.html', size: 400, pr: 'A'.repeat(43), mm: 'text/html' },
|
||||
]);
|
||||
await settle();
|
||||
assert.equal(root.querySelectorAll('img').length, 0);
|
||||
assert.equal(root.querySelectorAll('video').length, 0);
|
||||
assert.match(root.children[0].children[0].className, /file-card/);
|
||||
api.setApproveWarning(false);
|
||||
root.children[0].children[0].fire('click');
|
||||
await settle();
|
||||
assert.equal(api.warningCalls.length, 1);
|
||||
assert.equal(api.navigations.length, 0);
|
||||
api.setApproveWarning(true);
|
||||
root.children[1].children[0].fire('click');
|
||||
await settle();
|
||||
assert.equal(api.warningCalls.length, 2);
|
||||
assert.deepEqual(api.navigations, [`https://files.shineup.me/${'A'.repeat(43)}`]);
|
||||
});
|
||||
|
||||
@@ -8,7 +8,7 @@ const settings = (preset) => ({ preset, custom: { dark: {}, light: {} } });
|
||||
|
||||
test('новая палитра доступна в настройках, а стандартная сохранена', () => {
|
||||
assert.equal(PALETTE_PRESETS.tg_midnight.label, 'TG · Midnight');
|
||||
assert.equal(PALETTE_PRESETS.aurora.label, 'Сияние');
|
||||
assert.equal(PALETTE_PRESETS.aurora.label, 'remaining.theme.shine'); // i18n ещё не инициализирован в Node
|
||||
});
|
||||
|
||||
test('каждая роль в тёмном и светлом TG содержит корректный HEX', () => {
|
||||
|
||||
Reference in New Issue
Block a user