diff --git a/SHiNE-server/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/handlers/channels/ChannelsReadSupport.java b/SHiNE-server/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/handlers/channels/ChannelsReadSupport.java index e5737672..0cb6637c 100644 --- a/SHiNE-server/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/handlers/channels/ChannelsReadSupport.java +++ b/SHiNE-server/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/handlers/channels/ChannelsReadSupport.java @@ -53,7 +53,7 @@ final class ChannelsReadSupport { String stateSql = """ SELECT slug, display_name, channel_description, channel_type_code, channel_type_version, - ava_ar, ava_sha256, ava_size, meta_updated_at_ms, is_deleted, deleted_at_ms, deleted_block_number + created_at_ms, ava_ar, ava_sha256, ava_size, meta_updated_at_ms, is_deleted, deleted_at_ms, deleted_block_number FROM channel_names_state WHERE LOWER(owner_login)=LOWER(?) AND channel_root_block_number = ? LIMIT 1 @@ -68,6 +68,7 @@ final class ChannelsReadSupport { meta.channelDescription = String.valueOf(rs.getString("channel_description") == null ? "" : rs.getString("channel_description")); meta.channelTypeCode = rs.getInt("channel_type_code"); meta.channelTypeVersion = rs.getInt("channel_type_version"); + meta.createdAtMs = rs.getLong("created_at_ms"); meta.avaAr = String.valueOf(rs.getString("ava_ar") == null ? "" : rs.getString("ava_ar")); meta.avaSha256 = String.valueOf(rs.getString("ava_sha256") == null ? "" : rs.getString("ava_sha256")); meta.avaSize = rs.getLong("ava_size"); @@ -116,6 +117,7 @@ final class ChannelsReadSupport { meta.avaAr = parsedMeta.avaAr(); meta.avaSha256 = parsedMeta.avaSha256(); meta.avaSize = parsedMeta.avaSize(); + meta.createdAtMs = e.timestamp * 1000L; meta.metaUpdatedAtMs = e.timestamp * 1000L; } } else { @@ -713,6 +715,7 @@ final class ChannelsReadSupport { String avaAr = ""; String avaSha256 = ""; long avaSize = 0L; + long createdAtMs = 0L; long metaUpdatedAtMs = 0L; boolean deleted = false; long deletedAtMs = 0L; diff --git a/SHiNE-server/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/handlers/channels/Net_GetChannelMessages_Handler.java b/SHiNE-server/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/handlers/channels/Net_GetChannelMessages_Handler.java index 752cadc3..997dc1a9 100644 --- a/SHiNE-server/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/handlers/channels/Net_GetChannelMessages_Handler.java +++ b/SHiNE-server/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/handlers/channels/Net_GetChannelMessages_Handler.java @@ -67,6 +67,7 @@ public class Net_GetChannelMessages_Handler implements JsonMessageHandler { channel.setAvaSha256(meta.avaSha256); channel.setAvaSize(meta.avaSize); channel.setMetaUpdatedAtMs(meta.metaUpdatedAtMs); + channel.setCreatedAtMs(meta.createdAtMs); channel.setChannelTypeCode(meta.channelTypeCode); channel.setChannelTypeVersion(meta.channelTypeVersion); channel.setSubscribersCount(loadSubscribersCount(c, ownerBch, lineCode, meta.channelTypeCode)); diff --git a/SHiNE-server/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/handlers/channels/entyties/Net_GetChannelMessages_Response.java b/SHiNE-server/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/handlers/channels/entyties/Net_GetChannelMessages_Response.java index ed7813f4..3fcb486a 100644 --- a/SHiNE-server/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/handlers/channels/entyties/Net_GetChannelMessages_Response.java +++ b/SHiNE-server/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/handlers/channels/entyties/Net_GetChannelMessages_Response.java @@ -30,6 +30,7 @@ public class Net_GetChannelMessages_Response extends Net_Response { private String avaSha256; private Long avaSize; private Long metaUpdatedAtMs; + private Long createdAtMs; private Integer channelTypeCode; private Integer channelTypeVersion; private Integer subscribersCount; @@ -65,6 +66,9 @@ public class Net_GetChannelMessages_Response extends Net_Response { public Long getMetaUpdatedAtMs() { return metaUpdatedAtMs; } public void setMetaUpdatedAtMs(Long metaUpdatedAtMs) { this.metaUpdatedAtMs = metaUpdatedAtMs; } + public Long getCreatedAtMs() { return createdAtMs; } + public void setCreatedAtMs(Long createdAtMs) { this.createdAtMs = createdAtMs; } + public Integer getChannelTypeCode() { return channelTypeCode; } public void setChannelTypeCode(Integer channelTypeCode) { this.channelTypeCode = channelTypeCode; } diff --git a/SHiNE-server/src/main/java/server/files/PublicFileApiConfigurator.java b/SHiNE-server/src/main/java/server/files/PublicFileApiConfigurator.java new file mode 100644 index 00000000..5703ac1d --- /dev/null +++ b/SHiNE-server/src/main/java/server/files/PublicFileApiConfigurator.java @@ -0,0 +1,14 @@ +package server.files; + +import org.eclipse.jetty.servlet.ServletContextHandler; +import org.eclipse.jetty.servlet.ServletHolder; + +/** Регистрирует HTTP API публичного content-addressed хранилища. */ +public final class PublicFileApiConfigurator { + + private PublicFileApiConfigurator() {} + + public static void register(ServletContextHandler context) { + context.addServlet(new ServletHolder(new PublicFileServlet()), "/files/*"); + } +} diff --git a/SHiNE-server/src/main/java/server/files/PublicFileServlet.java b/SHiNE-server/src/main/java/server/files/PublicFileServlet.java new file mode 100644 index 00000000..6c91db2c --- /dev/null +++ b/SHiNE-server/src/main/java/server/files/PublicFileServlet.java @@ -0,0 +1,407 @@ +package server.files; + +import com.fasterxml.jackson.databind.ObjectMapper; +import com.fasterxml.jackson.databind.node.ObjectNode; +import jakarta.servlet.http.HttpServlet; +import jakarta.servlet.http.HttpServletRequest; +import jakarta.servlet.http.HttpServletResponse; +import server.logic.ws_protocol.Base64Ws; +import server.logic.ws_protocol.JSON.utils.AuthKeyUtils; +import shine.db.dao.ActiveSessionsDAO; +import shine.db.entities.ActiveSessionEntry; +import utils.config.AppConfig; +import utils.crypto.Ed25519Util; + +import java.io.IOException; +import java.io.InputStream; +import java.io.OutputStream; +import java.nio.charset.StandardCharsets; +import java.nio.file.AtomicMoveNotSupportedException; +import java.nio.file.FileAlreadyExistsException; +import java.nio.file.Files; +import java.nio.file.Path; +import java.nio.file.StandardCopyOption; +import java.nio.file.attribute.PosixFilePermission; +import java.security.MessageDigest; +import java.security.NoSuchAlgorithmException; +import java.sql.SQLException; +import java.util.HexFormat; +import java.util.Objects; +import java.util.Set; +import java.util.regex.Pattern; + +/** + * Публичное content-addressed хранилище SHiNE. + * + * Идентификатор объекта — lowercase hex SHA-256 исходных байтов. Сервер не хранит + * имя, расширение, MIME или владельца внутри пути файла. Одинаковые байты всех + * пользователей дедуплицируются в один объект: data/public-files/. + * + * В production GET/HEAD /files/ рекомендуется отдавать Caddy напрямую с + * того же каталога и кэшировать Cloudflare. Этот servlet оставляет GET/HEAD как + * рабочий fallback; PUT всегда проходит через Java, с проверкой session-signature + * и повторным вычислением SHA-256 полученных байтов. + */ +public final class PublicFileServlet extends HttpServlet { + + private static final ObjectMapper MAPPER = new ObjectMapper(); + private static final Pattern FILE_ID_PATTERN = Pattern.compile("^[0-9a-f]{64}$"); + + private static final String HEADER_SESSION_ID = "X-Shine-Session-Id"; + private static final String HEADER_TIME_MS = "X-Shine-Time-Ms"; + private static final String HEADER_CONTENT_LENGTH = "X-Shine-Content-Length"; + private static final String HEADER_SIGNATURE = "X-Shine-Signature"; + + private static final long DEFAULT_MAX_BYTES = 512L * 1024L * 1024L; + private static final long MAX_AUTH_SKEW_MS = 60_000L; + + private final boolean enabled; + private final Path storageDir; + private final long maxBytes; + + public PublicFileServlet() { + AppConfig config = AppConfig.getInstance(); + this.enabled = readBoolean(config, "public.files.enabled", true); + this.storageDir = Path.of(readString(config, "public.files.storageDir", "data/public-files")) + .toAbsolutePath() + .normalize(); + this.maxBytes = Math.max(1L, readLong(config, "public.files.maxBytes", DEFAULT_MAX_BYTES)); + } + + @Override + protected void doOptions(HttpServletRequest req, HttpServletResponse resp) { + applyCors(resp); + resp.setStatus(HttpServletResponse.SC_NO_CONTENT); + } + + @Override + protected void doPut(HttpServletRequest req, HttpServletResponse resp) throws IOException { + applyCors(resp); + if (!enabled) { + writeError(resp, HttpServletResponse.SC_NOT_FOUND, "FILES_DISABLED", "Публичные файлы отключены на сервере"); + return; + } + + String fileId = extractFileId(req); + if (fileId == null) { + writeError(resp, HttpServletResponse.SC_BAD_REQUEST, "BAD_FILE_ID", "Ожидается lowercase SHA-256 в URL /files/"); + return; + } + + UploadAuth auth; + try { + auth = readAndVerifyUploadAuth(req, fileId); + } catch (AuthFailure failure) { + writeError(resp, failure.httpStatus, failure.code, failure.getMessage()); + return; + } + + if (auth.declaredLength > maxBytes) { + writeError(resp, HttpServletResponse.SC_REQUEST_ENTITY_TOO_LARGE, "FILE_TOO_LARGE", "Файл превышает лимит сервера"); + return; + } + + Files.createDirectories(storageDir); + Path target = safeTarget(fileId); + if (target == null) { + writeError(resp, HttpServletResponse.SC_BAD_REQUEST, "BAD_FILE_ID", "Некорректный SHA-256 файла"); + return; + } + + if (Files.isRegularFile(target)) { + StoredObjectCheck stored = verifyStoredObject(target, fileId); + if (stored.valid()) { + if (stored.size() != auth.declaredLength) { + writeError(resp, HttpServletResponse.SC_CONFLICT, "FILE_ID_CONFLICT", "Файл с таким SHA-256 уже существует с другим размером"); + return; + } + ensurePublicReadable(target); + writeUploadOk(resp, fileId, auth.declaredLength, true); + return; + } + Files.deleteIfExists(target); + } + + Path temp = Files.createTempFile(storageDir, ".public-upload-", ".tmp"); + boolean tempMoved = false; + try { + MessageDigest digest = sha256Digest(); + long actualLength = 0L; + byte[] buffer = new byte[64 * 1024]; + try (InputStream in = req.getInputStream(); OutputStream out = Files.newOutputStream(temp)) { + int read; + while ((read = in.read(buffer)) >= 0) { + if (read == 0) continue; + actualLength += read; + if (actualLength > maxBytes || actualLength > auth.declaredLength) { + writeError(resp, HttpServletResponse.SC_REQUEST_ENTITY_TOO_LARGE, "FILE_TOO_LARGE", "Получено больше байтов, чем разрешено"); + return; + } + digest.update(buffer, 0, read); + out.write(buffer, 0, read); + } + } + + if (actualLength != auth.declaredLength) { + writeError(resp, HttpServletResponse.SC_BAD_REQUEST, "LENGTH_MISMATCH", "Размер загруженного файла не совпал с подписанным размером"); + return; + } + + String actualId = HexFormat.of().formatHex(digest.digest()); + if (!Objects.equals(fileId, actualId)) { + writeError(resp, HttpServletResponse.SC_BAD_REQUEST, "HASH_MISMATCH", "SHA-256 полученных байтов не совпал с адресом файла"); + return; + } + + boolean alreadyExists = false; + try { + try { + Files.move(temp, target, StandardCopyOption.ATOMIC_MOVE); + } catch (AtomicMoveNotSupportedException ignored) { + Files.move(temp, target); + } + tempMoved = true; + } catch (FileAlreadyExistsException race) { + StoredObjectCheck stored = verifyStoredObject(target, fileId); + if (stored.valid() && stored.size() == actualLength) { + alreadyExists = true; + } else { + Files.deleteIfExists(target); + try { + Files.move(temp, target, StandardCopyOption.ATOMIC_MOVE); + } catch (AtomicMoveNotSupportedException ignored) { + Files.move(temp, target); + } + tempMoved = true; + } + } + + ensurePublicReadable(target); + writeUploadOk(resp, fileId, actualLength, alreadyExists); + } finally { + if (!tempMoved) Files.deleteIfExists(temp); + } + } + + @Override + protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws IOException { + serveFile(req, resp, false); + } + + @Override + protected void doHead(HttpServletRequest req, HttpServletResponse resp) throws IOException { + serveFile(req, resp, true); + } + + private void serveFile(HttpServletRequest req, HttpServletResponse resp, boolean headOnly) throws IOException { + applyCors(resp); + if (!enabled) { + writeError(resp, HttpServletResponse.SC_NOT_FOUND, "FILES_DISABLED", "Публичные файлы отключены на сервере"); + return; + } + + String fileId = extractFileId(req); + Path target = fileId == null ? null : safeTarget(fileId); + if (target == null || !Files.isRegularFile(target)) { + writeError(resp, HttpServletResponse.SC_NOT_FOUND, "FILE_NOT_FOUND", "Файл не найден"); + return; + } + + StoredObjectCheck stored = verifyStoredObject(target, fileId); + if (!stored.valid()) { + Files.deleteIfExists(target); + writeError(resp, HttpServletResponse.SC_NOT_FOUND, "FILE_NOT_FOUND", "Файл не найден"); + return; + } + + resp.setStatus(HttpServletResponse.SC_OK); + resp.setContentType("application/octet-stream"); + resp.setHeader("Content-Length", Long.toString(stored.size())); + resp.setHeader("ETag", "\"" + fileId + "\""); + resp.setHeader("Cache-Control", "public, max-age=31536000, immutable"); + resp.setHeader("Cross-Origin-Resource-Policy", "cross-origin"); + if (!headOnly) { + try (InputStream in = Files.newInputStream(target); OutputStream out = resp.getOutputStream()) { + in.transferTo(out); + } + } + } + + private static StoredObjectCheck verifyStoredObject(Path target, String expectedFileId) throws IOException { + MessageDigest digest = sha256Digest(); + long size = 0L; + byte[] buffer = new byte[64 * 1024]; + try (InputStream in = Files.newInputStream(target)) { + int read; + while ((read = in.read(buffer)) >= 0) { + if (read == 0) continue; + size += read; + digest.update(buffer, 0, read); + } + } + String actual = HexFormat.of().formatHex(digest.digest()); + return new StoredObjectCheck(Objects.equals(expectedFileId, actual), size); + } + + private UploadAuth readAndVerifyUploadAuth(HttpServletRequest req, String fileId) throws AuthFailure { + String sessionId = requiredHeader(req, HEADER_SESSION_ID); + String timeRaw = requiredHeader(req, HEADER_TIME_MS); + String lengthRaw = requiredHeader(req, HEADER_CONTENT_LENGTH); + String signatureRaw = requiredHeader(req, HEADER_SIGNATURE); + + long timeMs; + long declaredLength; + try { + timeMs = Long.parseLong(timeRaw); + declaredLength = Long.parseLong(lengthRaw); + } catch (NumberFormatException badNumber) { + throw new AuthFailure(HttpServletResponse.SC_BAD_REQUEST, "BAD_UPLOAD_HEADERS", "Некорректные числовые заголовки загрузки"); + } + if (declaredLength <= 0L) { + throw new AuthFailure(HttpServletResponse.SC_BAD_REQUEST, "BAD_UPLOAD_LENGTH", "Файл должен содержать хотя бы один байт"); + } + long nowMs = System.currentTimeMillis(); + if (timeMs < nowMs - MAX_AUTH_SKEW_MS || timeMs > nowMs + MAX_AUTH_SKEW_MS) { + throw new AuthFailure(HttpServletResponse.SC_UNAUTHORIZED, "UPLOAD_AUTH_EXPIRED", "Подпись загрузки устарела"); + } + + ActiveSessionEntry session; + try { + session = ActiveSessionsDAO.getInstance().getBySessionId(sessionId); + } catch (SQLException dbError) { + throw new AuthFailure(HttpServletResponse.SC_INTERNAL_SERVER_ERROR, "SESSION_LOOKUP_FAILED", "Не удалось проверить пользовательскую сессию"); + } + if (session == null || session.getSessionKey() == null || session.getSessionKey().isBlank()) { + throw new AuthFailure(HttpServletResponse.SC_UNAUTHORIZED, "SESSION_NOT_FOUND", "Активная сессия не найдена"); + } + + byte[] signature; + byte[] publicKey; + try { + signature = Base64Ws.decodeLen(signatureRaw, Ed25519Util.SIGNATURE_LEN, "signature"); + publicKey = AuthKeyUtils.parseEd25519PublicKey(session.getSessionKey(), "sessionKey"); + } catch (RuntimeException badKey) { + throw new AuthFailure(HttpServletResponse.SC_UNAUTHORIZED, "BAD_UPLOAD_SIGNATURE", "Некорректная подпись загрузки"); + } + + String preimage = uploadPreimage(sessionId, fileId, declaredLength, timeMs); + if (!Ed25519Util.verify(preimage.getBytes(StandardCharsets.UTF_8), signature, publicKey)) { + throw new AuthFailure(HttpServletResponse.SC_UNAUTHORIZED, "BAD_UPLOAD_SIGNATURE", "Подпись загрузки не прошла проверку"); + } + return new UploadAuth(declaredLength); + } + + private static String uploadPreimage(String sessionId, String fileId, long size, long timeMs) { + return "PUBLIC_FILE_UPLOAD_V1:" + sessionId + ':' + fileId + ':' + size + ':' + timeMs; + } + + private String extractFileId(HttpServletRequest req) { + String pathInfo = String.valueOf(req.getPathInfo() == null ? "" : req.getPathInfo()).trim(); + if (!pathInfo.startsWith("/") || pathInfo.indexOf('/', 1) >= 0) return null; + String fileId = pathInfo.substring(1); + return FILE_ID_PATTERN.matcher(fileId).matches() ? fileId : null; + } + + private Path safeTarget(String fileId) { + if (fileId == null || !FILE_ID_PATTERN.matcher(fileId).matches()) return null; + Path target = storageDir.resolve(fileId).normalize(); + return target.getParent() != null && target.getParent().equals(storageDir) ? target : null; + } + + private static String requiredHeader(HttpServletRequest req, String name) throws AuthFailure { + String value = req.getHeader(name); + if (value == null || value.isBlank()) { + throw new AuthFailure(HttpServletResponse.SC_UNAUTHORIZED, "MISSING_UPLOAD_AUTH", "Не хватает заголовка " + name); + } + return value.trim(); + } + + private static void ensurePublicReadable(Path target) throws IOException { + try { + Files.setPosixFilePermissions(target, Set.of( + PosixFilePermission.OWNER_READ, + PosixFilePermission.OWNER_WRITE, + PosixFilePermission.GROUP_READ, + PosixFilePermission.OTHERS_READ + )); + } catch (UnsupportedOperationException ignored) { + // Не-POSIX FS: доступом управляет сама файловая система. + } + } + + private static MessageDigest sha256Digest() throws IOException { + try { + return MessageDigest.getInstance("SHA-256"); + } catch (NoSuchAlgorithmException impossible) { + throw new IOException("SHA-256 недоступен", impossible); + } + } + + private static boolean readBoolean(AppConfig config, String key, boolean fallback) { + String value = config.getParam(key); + return value == null || value.isBlank() ? fallback : Boolean.parseBoolean(value.trim()); + } + + private static long readLong(AppConfig config, String key, long fallback) { + String value = config.getParam(key); + if (value == null || value.isBlank()) return fallback; + try { + return Long.parseLong(value.trim()); + } catch (NumberFormatException ignored) { + return fallback; + } + } + + private static String readString(AppConfig config, String key, String fallback) { + String value = config.getParam(key); + return value == null || value.isBlank() ? fallback : value.trim(); + } + + private static void applyCors(HttpServletResponse resp) { + resp.setHeader("Access-Control-Allow-Origin", "*"); + resp.setHeader("Access-Control-Allow-Methods", "GET, HEAD, PUT, OPTIONS"); + resp.setHeader("Access-Control-Allow-Headers", + "Content-Type, X-Shine-Session-Id, X-Shine-Time-Ms, X-Shine-Content-Length, X-Shine-Signature"); + resp.setHeader("Access-Control-Expose-Headers", "Content-Length, ETag"); + resp.setHeader("Vary", "Origin"); + } + + private static void writeUploadOk(HttpServletResponse resp, String fileId, long size, boolean alreadyExists) throws IOException { + ObjectNode payload = MAPPER.createObjectNode(); + payload.put("ok", true); + payload.put("fileId", fileId); + payload.put("sha256", fileId); + payload.put("size", size); + payload.put("alreadyExists", alreadyExists); + writeJson(resp, HttpServletResponse.SC_OK, payload); + } + + private static void writeError(HttpServletResponse resp, int status, String code, String message) throws IOException { + ObjectNode payload = MAPPER.createObjectNode(); + payload.put("ok", false); + payload.put("error", code); + payload.put("message", message); + writeJson(resp, status, payload); + } + + private static void writeJson(HttpServletResponse resp, int status, ObjectNode payload) throws IOException { + resp.setStatus(status); + resp.setCharacterEncoding(StandardCharsets.UTF_8.name()); + resp.setContentType("application/json;charset=UTF-8"); + MAPPER.writeValue(resp.getOutputStream(), payload); + } + + private record StoredObjectCheck(boolean valid, long size) {} + private record UploadAuth(long declaredLength) {} + + private static final class AuthFailure extends Exception { + private final int httpStatus; + private final String code; + + private AuthFailure(int httpStatus, String code, String message) { + super(message); + this.httpStatus = httpStatus; + this.code = code; + } + } +} diff --git a/SHiNE-server/src/main/java/server/ws/WsServer.java b/SHiNE-server/src/main/java/server/ws/WsServer.java index 4f247e01..40cec097 100644 --- a/SHiNE-server/src/main/java/server/ws/WsServer.java +++ b/SHiNE-server/src/main/java/server/ws/WsServer.java @@ -11,6 +11,7 @@ import server.archive.ArweaveBlockPublisherScheduler; import server.archive.ArweaveBlockSyncScheduler; import server.debug.DebugApiConfigurator; import server.files.DmFileApiConfigurator; +import server.files.PublicFileApiConfigurator; import server.sync.PeriodicBlockchainSyncService; import server.sync.PeriodicDmDeliveryService; import server.sync.SolanaUsersSyncStartupService; @@ -82,6 +83,10 @@ public final class WsServer { // Зашифрованные вложения личных сообщений: PUT/GET /dm-files/{sha256-base58} DmFileApiConfigurator.register(context); + // Публичные immutable-вложения каналов: PUT/GET/HEAD /files/{sha256-hex}. + // В production GET/HEAD может перехватывать Caddy и отдавать файл прямо с диска. + PublicFileApiConfigurator.register(context); + // Инициализация контейнера WebSocket JettyWebSocketServletContainerInitializer.configure(context, (servletContext, wsContainer) -> { // Таймаут простоя соединения (Jetty 11 синтаксис) diff --git a/SHiNE-server/src/main/resources/application.properties b/SHiNE-server/src/main/resources/application.properties index 038a0bc9..e40dba6d 100644 --- a/SHiNE-server/src/main/resources/application.properties +++ b/SHiNE-server/src/main/resources/application.properties @@ -72,6 +72,15 @@ dm.files.storageDir=data/dm-files # Значение 50 MiB сохранено для совместимости с DM file v1. dm.files.maxBytes=52428816 +# ================================ +# Public immutable file storage +# ================================ +# Исходные байты публичного вложения. Имя файла = lowercase hex SHA-256(bytes). +# GET/HEAD работает через Java даже без Caddy; в production можно отдать этот путь напрямую Caddy. +public.files.enabled=true +public.files.storageDir=data/public-files +public.files.maxBytes=536870912 + webpush.vapid.public=BOdoWZndZRaNe9kyUFsJ5-xEfFABXNKennAKg15Z7ycAwUIQ7yDV_sIWWYJCwJriN4g9oU-CyJPrn1U6lfxuDbI webpush.vapid.private=3hCt7XxTvLzuoxinjT5QcKRQEBnGZHXn8ZilU31RPNE webpush.vapid.subject=mailto:admin@shine.local diff --git a/TODO/PUBLIC_ATTACHMENTS_TODO.md b/TODO/PUBLIC_ATTACHMENTS_TODO.md new file mode 100644 index 00000000..c74f2e3e --- /dev/null +++ b/TODO/PUBLIC_ATTACHMENTS_TODO.md @@ -0,0 +1,213 @@ +# TODO — публичные вложенные файлы + +## Цель + +Довести публичную раздачу вложений до production-схемы: +сервер SHiNE остаётся origin-хранилищем файлов, а Cloudflare используется перед ним +для HTTPS, кэширования и CDN. + +Отдельный CDN-сервис на данном этапе не требуется, если Cloudflare нормально кэширует +ответы серверного file endpoint. + +--- + +## 1. Настроить Cloudflare + +- Подключить домен/поддомен для публичных вложений. +- Проксировать file endpoint через Cloudflare. +- Проверить HTTPS. +- Настроить Cache Rules для публичных неизменяемых файлов. +- По возможности использовать длинный TTL для файлов, адресуемых по хэшу/ID. +- Проверить корректную работу Range-запросов и ответов `206 Partial Content`. +- Не кэшировать служебные API-ответы и ошибки, которые кэшировать не нужно. + +### Предпочтительная схема + +Client +→ Cloudflare +→ SHiNE server file endpoint +→ локальное файловое хранилище сервера + +То есть отдельную CDN-реализацию внутри SHiNE делать не обязательно: +сервер должен корректно отдавать файлы, а Cloudflare занимается внешним кэшем/CDN. + +--- + +## 2. Полноценная HTTP-отдача файлов + +Для публичного file endpoint реализовать/проверить: + +### GET + +- Полная отдача файла. +- Правильный `Content-Type`. +- Правильный `Content-Length`. +- `Content-Disposition`, где это необходимо. +- Стабильное имя/ID файла в URL. +- Корректный `404`, если файла нет. + +### HEAD + +- Те же HTTP-заголовки, что и для `GET`, но без тела файла. +- Нужен для проверки размера, типа и существования файла. +- Не должен читать весь файл в память. + +### Range requests + +Поддержать: + +`Range: bytes=start-end` + +и ответ: + +`206 Partial Content` + +с корректными: + +- `Accept-Ranges: bytes` +- `Content-Range` +- `Content-Length` + +Также обработать: + +- `bytes=N-` +- при необходимости `bytes=-N` +- некорректный диапазон → `416 Range Not Satisfiable` + +Важно: сервер не должен загружать весь большой файл в RAM ради выдачи небольшого диапазона. + +--- + +## 3. Докачка файлов + +Клиент должен иметь возможность продолжить загрузку после обрыва. + +Сценарий: + +1. Клиент уже скачал первые N байт. +2. Повторный запрос отправляется с: + `Range: bytes=N-` +3. Сервер возвращает остаток через `206 Partial Content`. + +Желательно дополнительно использовать: + +- `ETag` +- `Last-Modified` +- `If-Range` + +Это позволит убедиться, что докачивается та же версия файла. + +--- + +## 4. Кэширование + +Для неизменяемых публичных файлов желательно: + +- адресовать файл стабильным ID/хэшем; +- после публикации не изменять содержимое под тем же ID; +- отдавать подходящий `Cache-Control`; +- использовать `ETag`. + +Если содержимое изменилось — лучше создавать новый объект/ID, а не менять содержимое старого URL. + +--- + +## 5. Безопасность и корректность + +Проверить: + +- защиту от `../` и path traversal; +- невозможность запросить произвольный файл сервера; +- ограничения допустимых директорий; +- корректность MIME-type; +- лимиты размера; +- отсутствие передачи внутренних filesystem-path клиенту; +- логирование подозрительных и битых запросов. + +--- + +## 6. Garbage Collector / проверка файлов — позже + +Добавить фоновый или периодический сборщик мусора. + +Он должен уметь: + +### Проверять физические файлы + +- существует ли файл; +- соответствует ли размер; +- соответствует ли SHA-256/ожидаемый hash; +- не повреждён ли файл; +- есть ли для него запись в БД. + +### Проверять БД + +- есть ли физический файл для каждой актуальной записи; +- нет ли записей, указывающих на отсутствующие файлы. + +### Находить orphan-файлы + +Файлы, которые лежат на диске, но больше ни на что не ссылаются. + +На первом этапе безопаснее: + +- только находить; +- писать отчёт; +- ничего автоматически не удалять. + +Позже можно добавить grace period: +orphan найден → помечен → повторно проверен через несколько дней → только потом допускается удаление. + +### Никогда сразу не удалять + +До появления уверенной reference-модели GC должен работать в режиме аудита. + +--- + +## 7. Метрики и обслуживание — желательно позже + +Добавить базовые метрики: + +- объём файлов на диске; +- количество файлов; +- число GET / HEAD / Range запросов; +- объём исходящего трафика; +- доля `206`; +- `404` / `416`; +- ошибки чтения файлов; +- количество orphan/corrupted файлов по результатам GC. + +--- + +## Приоритет реализации + +### Сначала + +1. `GET` +2. `HEAD` +3. `Range` / `206 Partial Content` +4. нормальная докачка +5. `ETag` / `If-Range` +6. Cloudflare перед file endpoint +7. Cache Rules + +### Затем + +8. мониторинг +9. проверка целостности файлов +10. garbage collector в audit-only режиме +11. автоматическая очистка только после отдельного решения + +--- + +## Основное архитектурное решение + +На текущем этапе отдельный собственный CDN-слой SHiNE не нужен. + +**SHiNE server = origin файлов** + +**Cloudflare = внешний CDN/cache** + +Сервер должен корректно поддерживать стандартный HTTP для больших файлов и частичной выдачи. +Тогда браузеры, загрузчики и Cloudflare смогут нормально работать с файлами без отдельного +протокола SHiNE для скачивания. diff --git a/VERSION.properties b/VERSION.properties index 866a3ecf..1c898d9a 100644 --- a/VERSION.properties +++ b/VERSION.properties @@ -1,2 +1,2 @@ -client.version=1.14.12 -server.version=1.12.11 +client.version=1.14.13 +server.version=1.12.12 diff --git a/deploy/PUBLIC_FILES_CADDY_CLOUDFLARE.md b/deploy/PUBLIC_FILES_CADDY_CLOUDFLARE.md new file mode 100644 index 00000000..4c2662f4 --- /dev/null +++ b/deploy/PUBLIC_FILES_CADDY_CLOUDFLARE.md @@ -0,0 +1,164 @@ +# Public files: Caddy + Cloudflare на том же домене + +Цель: использовать один домен `shineup.me`, но обрабатывать `/files/` отдельно от UI/API. + +- `PUT /files/` -> Java SHiNE server, потому что нужна session-signature и проверка SHA-256; +- `GET/HEAD /files/` -> Caddy напрямую с диска; +- `/ws`, `/dm-files/*` и остальные маршруты работают как раньше; +- Cloudflare кэширует только `/files/*`. + +## 1. Один каталог для Java и Caddy + +Например: + +```text +/home/player/shine-public-files +``` + +Java запускается с: + +```text +-Dpublic.files.storageDir=/home/player/shine-public-files +``` + +`deploy/scripts/deploy_server.sh` поддерживает переменную: + +```bash +REMOTE_PUBLIC_FILES_DIR=/home/player/shine-public-files +``` + +Caddy должен иметь право прохода к родительским каталогам и чтения файлов. `PublicFileServlet` после успешного PUT выставляет финальному файлу права `0644` на POSIX-системах, но права родительского каталога всё равно нужно проверить. Например: + +```bash +chmod 755 /home/player/shine-public-files +``` + +Если `/home/player` закрыт для пользователя `caddy`, используйте каталог в `/srv`/`/var/lib` или настройте группу/ACL вместо расширения доступа ко всему home. + +## 2. Caddyfile + +Маршруты `/files/*` должны стоять **до SPA fallback**. + +```caddyfile +shineup.me { + encode zstd gzip + + @publicFilesRead { + method GET HEAD + path_regexp public_file ^/files/[0-9a-f]{64}$ + } + handle @publicFilesRead { + uri strip_prefix /files + root * /home/player/shine-public-files + header { + Cache-Control "public, max-age=31536000, immutable" + Access-Control-Allow-Origin "*" + Cross-Origin-Resource-Policy "cross-origin" + } + file_server + } + + @publicFilesWrite { + method PUT OPTIONS + path /files/* + } + handle @publicFilesWrite { + reverse_proxy 127.0.0.1:7070 + } + + @ws path /ws /ws/* + handle @ws { + reverse_proxy 127.0.0.1:7070 + } + + @dmfiles path /dm-files /dm-files/* + handle @dmfiles { + reverse_proxy 127.0.0.1:7070 + } + + handle { + root * /home/player/SHiNE/shine-ui + try_files {path} /index.html + file_server + header -Etag + header { + Cache-Control "no-store, no-cache, must-revalidate, max-age=0" + Pragma "no-cache" + Expires "0" + } + } +} +``` + +Если используется отдельный `:80` site block, тот же `/files` routing нужно добавить и туда либо перенаправлять HTTP на HTTPS. + +После изменения: + +```bash +sudo caddy validate --config /etc/caddy/Caddyfile +sudo systemctl reload caddy +``` + +## 3. Cloudflare Cache Rules + +### Rule 1: public files + +Условие: + +```text +Hostname equals shineup.me +AND URI Path starts with /files/ +``` + +Настройки: + +```text +Cache eligibility: Eligible for cache +Edge TTL: Override origin / большой TTL (например 1 год) +``` + +URL immutable: новые байты всегда имеют новый SHA-256 и, следовательно, новый URL. Поэтому purge при обновлении файла не нужен. + +### Rule 2: всё остальное + +Чтобы исключить случайное кэширование динамики, можно добавить правило: + +```text +Hostname equals shineup.me +AND URI Path does not start with /files/ +``` + +и выставить: + +```text +Cache eligibility: Bypass cache +``` + +UI дополнительно уже отправляет `Cache-Control: no-store` через Caddy. + +## 4. Проверка + +Загрузить файл через UI, затем проверить: + +```bash +curl -I https://shineup.me/files/ +``` + +Ожидается: + +```text +HTTP/2 200 +cache-control: public, max-age=31536000, immutable +content-length: ... +etag: ... +``` + +При повторных запросах после прогрева Cloudflare в ответе должен появиться соответствующий cache status (`HIT`). + +## 5. Важно + +- сам Java server не должен использоваться как основной download path в production; +- Caddy читает ровно те же файлы, которые записывает Java; +- никакие имена пользователей или MIME не входят в path; +- `/files/` публичен: это вложение публичного сообщения; +- удаление сообщения не должно автоматически удалять объект из `public-files`, потому что тот же SHA-256 может использоваться другими сообщениями или пользователями. diff --git a/deploy/README.md b/deploy/README.md index 77851b69..6df33c88 100644 --- a/deploy/README.md +++ b/deploy/README.md @@ -33,6 +33,7 @@ - `CONFIGURE_TURN_IN_SHINE.md` — как подключить TURN к SHiNE backend. - `SETUP_SERVER_FROM_ZERO.md` — настройка SHiNE-сервера и UI с нуля. - `SETUP_TURN_SERVER.md` — настройка TURN через Caddy/DNS/TLS. +- `PUBLIC_FILES_CADDY_CLOUDFLARE.md` — `/files/` на том же домене: Caddy читает с диска, Cloudflare кэширует только public files. - `AGENT_BOT_CODER_LOCAL_SYSTEMD.md` — локальный systemd-deploy Telegram-бота агента-кодера. - `AGENTS.md` — правила для агента при деплое. diff --git a/deploy/scripts/deploy_server.sh b/deploy/scripts/deploy_server.sh index d9be6e23..a24d230f 100755 --- a/deploy/scripts/deploy_server.sh +++ b/deploy/scripts/deploy_server.sh @@ -10,6 +10,7 @@ REMOTE_SERVER_DIR="${REMOTE_SERVER_DIR:?REMOTE_SERVER_DIR is required}" REMOTE_LOGS_DIR="${REMOTE_LOGS_DIR:-$REMOTE_SERVER_DIR/logs}" REMOTE_DATA_DIR="${REMOTE_DATA_DIR:-$REMOTE_SERVER_DIR/data}" REMOTE_DM_FILES_DIR="${REMOTE_DM_FILES_DIR:-}" +REMOTE_PUBLIC_FILES_DIR="${REMOTE_PUBLIC_FILES_DIR:-}" REMOTE_SERVICE_NAME="${REMOTE_SERVICE_NAME:?REMOTE_SERVICE_NAME is required}" SERVER_PORT="${SERVER_PORT:?SERVER_PORT is required}" LOCAL_JAR="${LOCAL_JAR:-$ROOT_DIR/SHiNE-server/build/libs/shine-server.jar}" @@ -55,7 +56,7 @@ Type=simple User=player Group=player WorkingDirectory=$REMOTE_SERVER_DIR -ExecStart=/usr/bin/java -Dserver.port=$SERVER_PORT${REMOTE_DM_FILES_DIR:+ -Ddm.files.storageDir=$REMOTE_DM_FILES_DIR} -jar $REMOTE_SERVER_DIR/shine-server.jar +ExecStart=/usr/bin/java -Dserver.port=$SERVER_PORT${REMOTE_DM_FILES_DIR:+ -Ddm.files.storageDir=$REMOTE_DM_FILES_DIR}${REMOTE_PUBLIC_FILES_DIR:+ -Dpublic.files.enabled=true -Dpublic.files.storageDir=$REMOTE_PUBLIC_FILES_DIR} -jar $REMOTE_SERVER_DIR/shine-server.jar Restart=always RestartSec=3 @@ -63,11 +64,10 @@ RestartSec=3 WantedBy=multi-user.target EOF -if [[ -n "$REMOTE_DM_FILES_DIR" ]]; then - ssh "$REMOTE_HOST" "mkdir -p '$REMOTE_SERVER_DIR' '$REMOTE_DATA_DIR' '$REMOTE_LOGS_DIR' '$REMOTE_DM_FILES_DIR'" -else - ssh "$REMOTE_HOST" "mkdir -p '$REMOTE_SERVER_DIR' '$REMOTE_DATA_DIR' '$REMOTE_LOGS_DIR'" -fi +REMOTE_EXTRA_DIRS="" +[[ -n "$REMOTE_DM_FILES_DIR" ]] && REMOTE_EXTRA_DIRS+=" '$REMOTE_DM_FILES_DIR'" +[[ -n "$REMOTE_PUBLIC_FILES_DIR" ]] && REMOTE_EXTRA_DIRS+=" '$REMOTE_PUBLIC_FILES_DIR'" +ssh "$REMOTE_HOST" "mkdir -p '$REMOTE_SERVER_DIR' '$REMOTE_DATA_DIR' '$REMOTE_LOGS_DIR'$REMOTE_EXTRA_DIRS" rsync -az --timeout=120 "$LOCAL_JAR" "$REMOTE_HOST:$REMOTE_SERVER_DIR/shine-server.jar" rsync -az "$TMP_DIR/$REMOTE_SERVICE_NAME.service" "$REMOTE_HOST:/tmp/$REMOTE_SERVICE_NAME.service" diff --git a/deploy/scripts/test_t1_server.sh b/deploy/scripts/test_t1_server.sh index f61c5d91..5de73bc8 100755 --- a/deploy/scripts/test_t1_server.sh +++ b/deploy/scripts/test_t1_server.sh @@ -5,6 +5,7 @@ REMOTE_HOST="player@t1.shineup.me" \ TARGET_DOMAIN="t1.shineup.me" \ REMOTE_SERVER_DIR="/home/player/t1/server" \ REMOTE_DM_FILES_DIR="/home/player/test-dm-files" \ +REMOTE_PUBLIC_FILES_DIR="/home/player/test-public-files" \ REMOTE_SERVICE_NAME="shine-t1" \ SERVER_PORT="7101" \ bash "$(dirname "$0")/deploy_server.sh" diff --git a/deploy/scripts/test_t2_server.sh b/deploy/scripts/test_t2_server.sh index 04c1a151..408b96a4 100755 --- a/deploy/scripts/test_t2_server.sh +++ b/deploy/scripts/test_t2_server.sh @@ -5,6 +5,7 @@ REMOTE_HOST="player@t2.shineup.me" \ TARGET_DOMAIN="t2.shineup.me" \ REMOTE_SERVER_DIR="/home/player/t2/server" \ REMOTE_DM_FILES_DIR="/home/player/test-dm-files" \ +REMOTE_PUBLIC_FILES_DIR="/home/player/test-public-files" \ REMOTE_SERVICE_NAME="shine-t2" \ SERVER_PORT="7102" \ bash "$(dirname "$0")/deploy_server.sh" diff --git a/deploy/scripts/test_t3_server.sh b/deploy/scripts/test_t3_server.sh index 430bea9c..355e7470 100755 --- a/deploy/scripts/test_t3_server.sh +++ b/deploy/scripts/test_t3_server.sh @@ -5,6 +5,7 @@ REMOTE_HOST="player@t3.shineup.me" \ TARGET_DOMAIN="t3.shineup.me" \ REMOTE_SERVER_DIR="/home/player/t3/server" \ REMOTE_DM_FILES_DIR="/home/player/test-dm-files" \ +REMOTE_PUBLIC_FILES_DIR="/home/player/test-public-files" \ REMOTE_SERVICE_NAME="shine-t3" \ SERVER_PORT="7103" \ bash "$(dirname "$0")/deploy_server.sh" diff --git a/deploy/scripts/test_t4_server.sh b/deploy/scripts/test_t4_server.sh index 0e603082..2a07aa47 100755 --- a/deploy/scripts/test_t4_server.sh +++ b/deploy/scripts/test_t4_server.sh @@ -5,6 +5,7 @@ REMOTE_HOST="player@t4.shineup.me" \ TARGET_DOMAIN="t4.shineup.me" \ REMOTE_SERVER_DIR="/home/player/t4/server" \ REMOTE_DM_FILES_DIR="/home/player/test-dm-files" \ +REMOTE_PUBLIC_FILES_DIR="/home/player/test-public-files" \ REMOTE_SERVICE_NAME="shine-t4" \ SERVER_PORT="7104" \ bash "$(dirname "$0")/deploy_server.sh" diff --git a/docs/API/09_Operations_Index.md b/docs/API/09_Operations_Index.md index 1005d8e5..71d5539f 100644 --- a/docs/API/09_Operations_Index.md +++ b/docs/API/09_Operations_Index.md @@ -91,5 +91,6 @@ - Межсерверные DM-операции пока доверяют `sourceServerLogin`; отдельная межсерверная авторизация запланирована позднее. - `ServerHello` пока принимает заявленный `serverLogin` на доверии и не является криптографической аутентификацией. - HTTP endpoints зашифрованных DM-файлов (`PUT/GET/HEAD/OPTIONS /dm-files/{fileId}`) не являются WebSocket `op` и описаны отдельно в `18_DM_File_Storage_API.md`. +- HTTP endpoints публичных content-addressed файлов (`PUT/GET/HEAD/OPTIONS /files/{sha256}`) также не являются WebSocket `op` и описаны отдельно в `21_Public_File_Storage_API.md`. - Классы `Net_MarkChannelMessagesSeen_*` существуют в коде, но операция `MarkChannelMessagesSeen` не зарегистрирована в `JsonHandlerRegistry`, поэтому в публичный список API не входит. - HTTP debug endpoints из `src/main/java/server/debug/` не входят в этот индекс WebSocket `op`; они описаны отдельно в `13_HTTP_Debug_API.md`. diff --git a/docs/API/21_Public_File_Storage_API.md b/docs/API/21_Public_File_Storage_API.md new file mode 100644 index 00000000..62897651 --- /dev/null +++ b/docs/API/21_Public_File_Storage_API.md @@ -0,0 +1,104 @@ +# HTTP API публичных файлов каналов + +## 1. Назначение + +Публичное вложение может храниться не в Arweave, а на текущем сервере доступа автора. +Файловый слой намеренно максимально простой: он хранит только байты, адресованные их SHA-256. + +Канонический URL: + +```text +/files/ +``` + +`sha256` — lowercase hex, ровно 64 символа. + +На диске сервер хранит один глобальный объект: + +```text +/ +``` + +Имя пользователя, исходное имя файла, расширение, MIME и ссылка на сообщение в файловом хранилище не нужны. Одинаковые байты, загруженные разными пользователями, дедуплицируются в один объект. + +## 2. Конфигурация Java-сервера + +```properties +public.files.enabled=true +public.files.storageDir=data/public-files +public.files.maxBytes=536870912 +``` + +Для production рекомендуется задать `public.files.storageDir` абсолютным путём, который одновременно доступен Java для записи и Caddy для чтения. + +Например: + +```text +/home/player/shine-public-files +``` + +## 3. PUT `/files/` + +Загружает immutable public file. PUT требует активную пользовательскую сессию. + +Заголовки: + +```text +Content-Type: application/octet-stream +X-Shine-Session-Id: +X-Shine-Time-Ms: +X-Shine-Content-Length: +X-Shine-Signature: +``` + +Подписываемая строка 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 + +Java servlet умеет `GET` и `HEAD` как fallback. В production рекомендуется не пропускать чтение через Java: Caddy должен отдавать файл непосредственно с диска. + +Ответ immutable: + +```text +Cache-Control: public, max-age=31536000, immutable +ETag: "" +Content-Type: application/octet-stream +``` + +Файловое хранилище не определяет тип контента. Официальный клиент решает, как интерпретировать байты, на основании имени `nm` из `S:att`. Если пользователь указал неверное расширение или положил неподходящие байты, клиент просто не сможет отобразить такой media-файл. + +## 5. Связь с `S:att` + +```text +> +``` + +означает public file на текущем сервере доступа автора. + +```text +;ar=> +``` + +означает Arweave. + +Адрес сервера доступа в блок не записывается. При чтении клиент определяет текущий access server автора через его PDA и строит: + +```text +https:///files/ +``` + +## 6. Preview + +Отдельных preview-файлов сейчас нет. `preAr`, `preSha256`, `previewAr`, `previewSha256` не являются частью текущего протокола. diff --git a/docs/Blockchain/11_TEXT_Blocks.md b/docs/Blockchain/11_TEXT_Blocks.md index 9e4f00bf..f37f3b7c 100644 --- a/docs/Blockchain/11_TEXT_Blocks.md +++ b/docs/Blockchain/11_TEXT_Blocks.md @@ -111,16 +111,16 @@ Login/fork для edit не подписываются: edit может ссыл Бинарный формат `TextBody` не меняется: вложения являются частью UTF-8 текста. -Один блок вложения: +Arweave-вложение: ```text ``` -Для файлов с отдельным превью клиент может использовать расширенный вариант: +Вложение на сервере доступа автора: ```text - + ``` Несколько вложений идут подряд в самом начале текста, по одному блоку на строку. После последнего блока идёт обычный пользовательский текст. @@ -131,8 +131,18 @@ Login/fork для edit не подписываются: edit может ссыл - `nm` - имя файла, закодированное через `encodeURIComponent` - `sz` - размер файла в байтах - `sha256` - SHA-256 исходного файла в hex -- `ar` - короткий Arweave Transaction ID, без полного URL -- при наличии превью дополнительно могут присутствовать `preAr` и `preSha256` + +Опциональное поле: + +- `ar` - короткий Arweave Transaction ID, без полного URL. + +Правило источника файла: + +- `ar` присутствует -> файл хранится в Arweave; +- `ar` отсутствует -> файл хранится как public file на текущем сервере доступа автора и читается по `/files/`; +- адрес сервера доступа в attach-блок не записывается. + +Отдельные preview-файлы сейчас **не поддерживаются и не являются частью текущего протокола**. Поля `preAr`, `preSha256`, `previewAr`, `previewSha256` новые клиенты создавать не должны. Изображения и видео отображаются из исходного файла. Правила клиента: @@ -141,4 +151,4 @@ Login/fork для edit не подписываются: edit может ссыл - старые клиенты без поддержки вложений могут показывать технические строки как обычный текст; - пустой пользовательский текст допустим, если перед ним есть хотя бы один валидный attach-блок. -Файлы хранятся вне блокчейна, в Arweave. В блокчейне остаются только `txId`, имя, размер, SHA-256 и, при наличии отдельного preview-файла, `preAr/preSha256`. +Сам файл всегда хранится вне блокчейна. В блокчейне остаются имя, размер, SHA-256 и, только для Arweave-вложения, `ar`. diff --git a/docs/Blockchain/15_TEXT_Attachments.md b/docs/Blockchain/15_TEXT_Attachments.md index 1896401e..ddb40871 100644 --- a/docs/Blockchain/15_TEXT_Attachments.md +++ b/docs/Blockchain/15_TEXT_Attachments.md @@ -15,112 +15,109 @@ ## Общий вид -Канонический attach-блок: +Arweave-вложение: ```text ``` -Блок с превью: +Public file на сервере доступа автора: ```text - + ``` Несколько вложений идут подряд в самом начале текста: ```text - + Текст сообщения ``` После последнего attach-блока идёт обычный пользовательский текст. Пользовательский текст может быть пустым, если есть хотя бы одно валидное вложение. -Клиент SHiNE ограничивает одно сообщение максимум 10 вложениями и сохраняет порядок attach-блоков в том порядке, в котором пользователь прикрепил файлы. +Клиент SHiNE ограничивает одно сообщение максимум 10 вложениями и сохраняет порядок attach-блоков. ## Поля -Обязательные поля канонического формата: +Обязательные поля: - `v=1` - версия формата attach-блока; - `nm` - имя файла, закодированное через `encodeURIComponent`; - `sz` - размер файла в байтах; -- `sha256` - SHA-256 исходного файла в hex, 64 символа; +- `sha256` - SHA-256 исходного файла в hex, 64 символа. + +Опциональное поле: + - `ar` - короткий Arweave Transaction ID, 43 символа, без gateway URL. -Дополнительные поля для превью: +Источник определяется только наличием `ar`: -- `preAr` - короткий Arweave Transaction ID файла-превью; -- `preSha256` - SHA-256 файла-превью в hex. +- `ar` присутствует -> Arweave; +- `ar` отсутствует -> public file текущего сервера доступа автора. + +Адрес сервера доступа, URL файла и login автора в attach-блок не записываются: автор уже известен из подписанного блока, а актуальный сервер доступа определяется отдельно. + +## Preview + +Отдельные preview-файлы в текущем протоколе **не поддерживаются и пока не нужны**. + +Клиент не должен создавать или использовать поля `preAr`, `preSha256`, `previewAr`, `previewSha256`. Для изображения или видео используется исходный файл вложения. + +Если такие поля встречаются в экспериментальных старых данных, текущая реализация может их игнорировать; они не являются частью канонического `S:att v=1`. ## Хранение файла -Файл хранится вне блокчейна в Arweave. В блокчейне хранится только метаинформация, достаточная для отображения и проверки: +Сам файл всегда находится вне блокчейна. -- имя файла; -- размер; -- SHA-256; -- Arweave `txId`. +### Arweave -Опционально для видео или больших изображений может храниться отдельный второй файл-превью. В таком случае основной attach-блок остаётся одним, но дополнительно указывает `preAr/preSha256`. +Если присутствует `ar`, файл читается через настроенный Arweave gateway по указанному `txId`. + +### Сервер доступа + +Если `ar` отсутствует, клиент: + +1. определяет текущий сервер доступа автора сообщения; +2. запрашивает файл по стандартному пути `/files/`; +3. при необходимости проверяет полученные байты по `sha256` из блока. + +Физическое хранилище сервера является content-addressed: один и тот же SHA-256 должен соответствовать одному набору байтов. Это позволяет дедуплицировать одинаковые файлы разных пользователей. + +URL или домен конкретного сервера в блокчейн не записывается. Поэтому смена сервера доступа не требует изменения старых сообщений. ## Создание вложения в UI -UI поддерживает три сценария: +UI предлагает два способа хранения: `Сервер доступа` и `Arweave`. По умолчанию выбран сервер доступа. Отдельные preview-файлы не создаются. -- загрузить новый файл в Arweave выбранным Arweave-кошельком; -- ввести существующий `txId`, скачать файл через Arweave gateway и локально посчитать `size/sha256`; -- выбрать файл из журнала файлов, загруженных в текущей браузерной сессии. +После успешной загрузки на сервер доступа формируется тот же `S:att v=1`, но без поля `ar`. Для Arweave используется существующий механизм Arweave/Turbo и добавляется `ar`. -Для видеофайлов UI может по желанию пользователя автоматически создать превью из первого кадра. Технически клиент загружает два файла: - -- основной видеофайл; -- отдельное изображение-превью. - -После успешной загрузки в журнале хранится один элемент основного файла, но с полями `preAr/preSha256`. В UI такой элемент помечается как файл `С превью`. - -При ручном добавлении существующего `txId` для видео UI также позволяет вручную указать `txId` файла-превью. - -Журнал хранится только в `sessionStorage` текущего браузера и не является частью блокчейна. -В настройках клиента есть отдельный экран `Загрузка файлов`: пользователь может заранее загрузить файл в Arweave без создания сообщения, увидеть компактную плитку с именем, размером, временем загрузки, `txId` и статусом доступности через gateway, а затем выбрать этот файл из истории при создании сообщения. -Если файл загружен заранее, но ещё не был отправлен ни в одном сообщении SHiNE, клиент показывает локальный флаг `Не добавлен в SHiNE`. Флаг снимается после успешной отправки сообщения с этим вложением. -Если история очищена, уже созданные сообщения не меняются: в блокчейне остаются attach-блоки с `txId`. +Журнал загрузок Arweave хранится только в `sessionStorage` текущего браузера и не является частью блокчейна. ## Отображение -Новый клиент при чтении сообщения: +Клиент при чтении сообщения: 1. читает валидные attach-блоки только из начала текста; 2. скрывает технические attach-строки; -3. отображает вложения над пользовательским текстом; -4. показывает вложения горизонтальной каруселью: одно вложение на экране, переключение свайпом или стрелками, счётчик вида `1 из 3`; -5. определяет тип вложения по расширению имени файла: - - изображение показывает как ограниченное по размеру превью; - - видео показывает как превью с кнопкой воспроизведения и открывает большой HTML5-плеер по нажатию; - - обычный файл показывает как карточку с именем, расширением, размером и скачиванием; -6. если у видео есть `preAr/preSha256`, использует отдельный preview-файл как `poster` и как большую превью-плитку в журнале загрузок; -7. при перелистывании останавливает воспроизводящееся видео; -8. если attach-блок битый, игнорирует только этот блок и продолжает отображать сообщение. - -Если файл по ссылке Arweave gateway недоступен, клиент показывает диагностический блок: - -- если сообщение создано менее 20 минут назад: файл, скорее всего, ещё не распространился в Arweave, нужно повторить через несколько минут; -- если сообщение старше 20 минут: файл считается недоступным. - -Старые клиенты без поддержки формата могут показывать attach-блоки как обычный текст. +3. определяет источник по наличию `ar`; +4. получает Arweave-файл по `txId` либо server-файл по `/files/` текущего сервера доступа автора; +5. определяет тип вложения по расширению `nm`; +6. изображение отображает из исходного файла; +7. видео отображает из исходного файла и открывает HTML5-плеер; +8. обычный файл показывает как карточку с именем, размером и скачиванием; +9. при перелистывании останавливает воспроизводящееся видео; +10. битый attach-блок игнорирует, не ломая остальное сообщение. ## Редактирование -При редактировании сообщения UI сохраняет существующие attach-блоки и меняет только пользовательский текст. Удаление сообщения по-прежнему выполняется через edit-блок с пустым текстом, как описано в `11_TEXT_Blocks.md`. +При редактировании сообщения UI сохраняет существующие attach-блоки и меняет только пользовательский текст. Удаление сообщения выполняется через edit-блок с пустым текстом, как описано в `11_TEXT_Blocks.md`. ## Совместимость и ограничения -- `ar` допускает только короткий Arweave `txId`, полный URL не используется; -- MIME type не записывается, поэтому UI определяет image/video/file по расширению имени файла; -- старые блоки ``, промежуточные `` и новые `` читаются одинаково; -- старые поля `name/size/previewAr/previewSha256` и новые `nm/sz/preAr/preSha256` читаются одинаково; -- старые блоки `v=2` продолжают читаться как legacy-форма вложения с превью; -- `preAr/preSha256` используются только если присутствуют оба поля и оба валидны; -- MIME type, width, height, duration и thumbnail не записываются в блокчейн отдельными полями; -- проверка существующего `txId` скачивает файл локально через gateway, поэтому UI ограничивает максимальный размер такой проверки. +- полный URL в поле `ar` не используется; +- MIME type не записывается, тип UI определяется по расширению `nm`; +- старые текстовые префиксы `` и `` могут продолжать читаться как совместимые формы; +- отдельные preview-поля не входят в текущий протокол; +- MIME type, width, height, duration и thumbnail не записываются в блокчейн отдельными полями. diff --git a/docs/Blockchain/CHANGELOG.md b/docs/Blockchain/CHANGELOG.md index d5e05b4b..7ed04031 100644 --- a/docs/Blockchain/CHANGELOG.md +++ b/docs/Blockchain/CHANGELOG.md @@ -9,6 +9,13 @@ - Bootstrap/rebuild восстанавливает delete-state из канонической истории с учётом segmented forks по логическому `login`, поэтому root из старого fork остаётся валидным. - Схема PostgreSQL поднята до v31; добавлен безопасный переход v30 -> v31. +## 2026-10-07 — Public files на access server + +- Отдельные preview-файлы вложений выведены из текущего протокола и UI. `preAr/preSha256` и `previewAr/previewSha256` больше не создаются и не используются. +- Для `S:att v=1` источник определяется наличием `ar`: `ar` есть -> Arweave; `ar` отсутствует -> public file текущего сервера доступа автора по `/files/`. +- Добавлено публичное content-addressed хранение исходных байтов на access server: один глобальный объект на lowercase hex SHA-256, дедупликация между пользователями, signed `PUT /files/`. Адрес сервера, MIME и owner в блок не добавляются. +- UI каналов получил выбор `Сервер доступа` / `Arweave`; сервер доступа выбран по умолчанию. Для server-вложения клиент определяет актуальный access server автора по PDA. + ## 2026-10-02 — Transport namespace `test5591` - Текущий ANS-104 namespace переключён с `test5590` на `test5591`: `App=test5591`; channel index теперь постоянный и не зависит от namespace: `c=`. diff --git a/shine-UI/js/components/arweave-attachment-manager.js b/shine-UI/js/components/arweave-attachment-manager.js index 89a86fa8..58ccb356 100644 --- a/shine-UI/js/components/arweave-attachment-manager.js +++ b/shine-UI/js/components/arweave-attachment-manager.js @@ -7,7 +7,7 @@ import { validateArweaveTxId, } from '../services/arweave-file-service.js'; import { addArweaveWalletSecret, getArweaveBalance, getArweaveWalletChoices } from '../services/arweave-wallet-service.js'; -import { escapeHtml, formatBytes, getAttachmentKind, normalizeAttachment } from '../services/attachment-format.js'; +import { escapeHtml, formatBytes, normalizeAttachment } from '../services/attachment-format.js'; import { getStoredSolanaWalletChoices } from '../services/solana-wallet-service.js'; import { iconHtml } from './ui-icon.js'; import { @@ -36,25 +36,6 @@ function normalizeHistoryItem(input = {}) { }; } -function hasAttachmentPreview(item) { - return !!String(item?.preview?.ar || '').trim(); -} - -function isVideoAttachmentName(name) { - return getAttachmentKind({ name }) === 'video'; -} - -function buildHistoryPreviewMarkup(item, gateway) { - if (!hasAttachmentPreview(item)) return ''; - const previewTxId = String(item.preview.ar || '').trim(); - const previewUrl = buildArweaveDataUrl({ gateway, txId: previewTxId }); - return ` -
- Превью ${escapeHtml(item.name)} -
Есть превью
-
- `; -} export function readArweaveAttachmentHistory(login) { try { @@ -217,45 +198,6 @@ async function resizeImageFileToAvatar(file) { return new File([blob], 'avatar.jpg', { type: 'image/jpeg', lastModified: Date.now() }); } -async function createVideoPreviewFile(file) { - const source = file instanceof File ? file : null; - if (!source) throw new Error('Выберите видеофайл.'); - const blobUrl = URL.createObjectURL(source); - try { - const video = await new Promise((resolve, reject) => { - const node = document.createElement('video'); - node.preload = 'metadata'; - node.muted = true; - node.playsInline = true; - node.onloadeddata = () => resolve(node); - node.onerror = () => reject(new Error('Не удалось открыть видео для создания превью.')); - node.src = blobUrl; - }); - const width = Number(video.videoWidth || 0); - const height = Number(video.videoHeight || 0); - if (!width || !height) { - throw new Error('Не удалось определить размер видео для превью.'); - } - const maxSide = 640; - const scale = Math.min(1, maxSide / Math.max(width, height)); - const canvas = document.createElement('canvas'); - canvas.width = Math.max(1, Math.round(width * scale)); - canvas.height = Math.max(1, Math.round(height * scale)); - const ctx = canvas.getContext('2d'); - if (!ctx) throw new Error('Canvas недоступен для создания превью.'); - ctx.drawImage(video, 0, 0, canvas.width, canvas.height); - const blob = await new Promise((resolve) => canvas.toBlob(resolve, 'image/jpeg', 0.86)); - if (!blob) throw new Error('Не удалось собрать preview image.'); - const baseName = String(source.name || 'video').replace(/\.[^.]+$/u, '') || 'video'; - return new File([blob], `${baseName}-preview.jpg`, { - type: 'image/jpeg', - lastModified: Date.now(), - }); - } finally { - URL.revokeObjectURL(blobUrl); - } -} - export function openArweaveAttachmentManager({ login, storagePwd, @@ -298,10 +240,6 @@ export function openArweaveAttachmentManager({ let selectedUploadTransport = String(uploadTransport || '').trim().toLowerCase() === 'arweave' ? 'arweave' : 'turbo'; let selectedFile = null; let selectedSha256 = ''; - let selectedPreviewEnabled = false; - let selectedPreviewFile = null; - let selectedPreviewSha256 = ''; - let selectedPreviewPriceInfo = null; let priceInfo = null; let balanceInfo = null; let autoOpenedFileDialogOnce = false; @@ -394,14 +332,14 @@ export function openArweaveAttachmentManager({ } }; - const renderTurboMeta = (mainMetaEl, previewMetaEl) => { - if (!mainMetaEl || !previewMetaEl) return; + const renderTurboMeta = (mainMetaEl) => { + if (!mainMetaEl) return; const turboAddress = String(balanceInfo?.address || priceInfo?.address || '').trim(); const turboCredits = balanceInfo ? formatTurboCredits(balanceInfo.effectiveCredits, 6) : '–'; const solBalance = balanceInfo ? `${escapeHtml(String(balanceInfo.solBalance ?? 0))} SOL` : '–'; const uploadPrice = priceInfo ? `${formatTurboCredits(priceInfo.credits, 6)} credits` : '–'; const fileSize = selectedFile ? formatBytes(selectedFile.size) : '–'; - const isFreeSize = selectedFile && combinedUploadSize() <= getFreeTurboUploadBytesLimit(); + const isFreeSize = selectedFile && Number(selectedFile.size || 0) <= getFreeTurboUploadBytesLimit(); const summary = selectedFile ? `Размер ${escapeHtml(fileSize)} · ${isFreeSize ? 'бесплатно через Turbo' @@ -419,26 +357,16 @@ export function openArweaveAttachmentManager({
Бесплатно до ${escapeHtml(formatBytes(getFreeTurboUploadBytesLimit()))}
`; - previewMetaEl.innerHTML = ''; - if (selectedPreviewEnabled && selectedPreviewFile) { - previewMetaEl.innerHTML = ` -
Файл превью
-
Имя: ${escapeHtml(selectedPreviewFile.name)}
-
Размер превью: ${escapeHtml(formatBytes(selectedPreviewFile.size))}
-
SHA-256 превью: ${escapeHtml(selectedPreviewSha256 || '–')}
-
Цена превью: ${escapeHtml(selectedPreviewPriceInfo ? `${formatTurboCredits(selectedPreviewPriceInfo.credits, 6)} credits` : '–')}
- `; - } }; - const refreshTurboBalance = async (mainMetaEl, previewMetaEl, errorEl) => { + const refreshTurboBalance = async (mainMetaEl, errorEl) => { try { balanceInfo = await getTurboBalanceForStoredSolanaKey({ login: cleanLogin, storagePwd: cleanStoragePwd, keySource: selectedTurboKeySource, }); - renderTurboMeta(mainMetaEl, previewMetaEl); + renderTurboMeta(mainMetaEl); if (errorEl && String(errorEl.textContent || '').includes('Turbo balance')) { setText(errorEl, ''); } @@ -447,7 +375,7 @@ export function openArweaveAttachmentManager({ } }; - const promptTurboTopUp = async (mainMetaEl, previewMetaEl, errorEl) => { + const promptTurboTopUp = async (mainMetaEl, errorEl) => { const value = window.prompt('Сколько SOL перевести в Turbo?', '0.01'); if (value == null) return; setText(errorEl, 'Пополняем Turbo...'); @@ -458,32 +386,15 @@ export function openArweaveAttachmentManager({ keySource: selectedTurboKeySource, amountSol: value, }); - await refreshTurboBalance(mainMetaEl, previewMetaEl, errorEl); + await refreshTurboBalance(mainMetaEl, errorEl); setText(errorEl, `Turbo пополнен. Tx: ${result.txId || 'отправлено'}`); } catch (error) { setText(errorEl, error?.message || 'Не удалось пополнить Turbo.'); } }; - const resetPreviewState = () => { - selectedPreviewEnabled = false; - selectedPreviewFile = null; - selectedPreviewSha256 = ''; - selectedPreviewPriceInfo = null; - }; - - const isPreviewEligibleForCurrentFile = () => ( - !isAvatarMode - && selectedFile instanceof File - && isVideoAttachmentName(selectedFile.name) - ); - - const combinedUploadSize = () => { - return Number(selectedFile?.size || 0) + Number(selectedPreviewEnabled ? (selectedPreviewFile?.size || 0) : 0); - }; - - const renderArweaveMeta = (mainMetaEl, previewMetaEl) => { - if (!mainMetaEl || !previewMetaEl) return; + const renderArweaveMeta = (mainMetaEl) => { + if (!mainMetaEl) return; mainMetaEl.innerHTML = ` ${isAvatarMode ? '' : `
Имя: ${escapeHtml(selectedFile?.name || 'file')}
`}
Размер: ${escapeHtml(formatBytes(selectedFile?.size || 0))}
@@ -491,44 +402,27 @@ export function openArweaveAttachmentManager({
Цена: ${escapeHtml(Number(priceInfo?.ar || 0).toLocaleString('ru-RU', { maximumFractionDigits: 6 }))} AR
Баланс кошелька: ${escapeHtml(Number(balanceInfo?.ar || 0).toLocaleString('ru-RU', { maximumFractionDigits: 6 }))} AR
`; - previewMetaEl.innerHTML = ''; - if (selectedPreviewEnabled && selectedPreviewFile) { - previewMetaEl.innerHTML = ` -
Файл превью
-
Имя: ${escapeHtml(selectedPreviewFile.name)}
-
Размер превью: ${escapeHtml(formatBytes(selectedPreviewFile.size))}
-
SHA-256 превью: ${escapeHtml(selectedPreviewSha256 || '–')}
-
Цена превью: ${escapeHtml(selectedPreviewPriceInfo ? `${Number(selectedPreviewPriceInfo.ar || 0).toLocaleString('ru-RU', { maximumFractionDigits: 6 })} AR` : '–')}
- `; - } }; - const recalculateArweaveState = async (mainMetaEl, previewMetaEl, errorEl, uploadBtn) => { + const recalculateArweaveState = async (mainMetaEl, errorEl, uploadBtn) => { uploadBtn.disabled = true; priceInfo = null; balanceInfo = null; - selectedPreviewPriceInfo = null; setText(errorEl, ''); if (!selectedFile || !selectedSha256) { setText(mainMetaEl, ''); - setText(previewMetaEl, ''); return; } const wallet = selectedWallet(); if (!wallet?.address) throw new Error('Выберите Arweave-кошелёк.'); const mainPrice = await getArweaveUploadPrice({ gateway: cleanGateway, byteLength: selectedFile.size }); - let totalWinston = BigInt(mainPrice.winston); - if (selectedPreviewEnabled && selectedPreviewFile) { - const previewPrice = await getArweaveUploadPrice({ gateway: cleanGateway, byteLength: selectedPreviewFile.size }); - selectedPreviewPriceInfo = previewPrice; - totalWinston += BigInt(previewPrice.winston); - } + const totalWinston = BigInt(mainPrice.winston); balanceInfo = await getArweaveBalance({ gateway: cleanGateway, address: wallet.address }); priceInfo = { ar: Number(totalWinston) / 1e12, winston: totalWinston.toString(), }; - renderArweaveMeta(mainMetaEl, previewMetaEl); + renderArweaveMeta(mainMetaEl); const hasFunds = BigInt(balanceInfo.winston) >= totalWinston; if (!hasFunds) { setText(errorEl, 'Недостаточно AR на выбранном кошельке.'); @@ -537,14 +431,13 @@ export function openArweaveAttachmentManager({ uploadBtn.disabled = false; }; - const refreshTurboStateForCurrentFile = async (mainMetaEl, previewMetaEl, errorEl, uploadBtn) => { + const refreshTurboStateForCurrentFile = async (mainMetaEl, errorEl, uploadBtn) => { uploadBtn.disabled = true; priceInfo = null; balanceInfo = null; - selectedPreviewPriceInfo = null; setText(errorEl, ''); if (!selectedFile || !selectedSha256) { - renderTurboMeta(mainMetaEl, previewMetaEl); + renderTurboMeta(mainMetaEl); return; } try { @@ -554,21 +447,11 @@ export function openArweaveAttachmentManager({ keySource: selectedTurboKeySource, byteLength: selectedFile.size, }); - let totalWinc = BigInt(mainPrice.winc); - if (selectedPreviewEnabled && selectedPreviewFile) { - const previewPrice = await estimateTurboUploadPrice({ - login: cleanLogin, - storagePwd: cleanStoragePwd, - keySource: selectedTurboKeySource, - byteLength: selectedPreviewFile.size, - }); - selectedPreviewPriceInfo = previewPrice; - totalWinc += BigInt(previewPrice.winc); - } + const totalWinc = BigInt(mainPrice.winc); priceInfo = { ...mainPrice, - byteLength: combinedUploadSize(), - isFree: combinedUploadSize() <= getFreeTurboUploadBytesLimit(), + byteLength: Number(selectedFile.size || 0), + isFree: Number(selectedFile.size || 0) <= getFreeTurboUploadBytesLimit(), winc: totalWinc.toString(), credits: Number(totalWinc) / 1_000_000_000_000, }; @@ -577,7 +460,7 @@ export function openArweaveAttachmentManager({ storagePwd: cleanStoragePwd, keySource: selectedTurboKeySource, }); - renderTurboMeta(mainMetaEl, previewMetaEl); + renderTurboMeta(mainMetaEl); if (!priceInfo.isFree && BigInt(balanceInfo.effectiveWinc) < BigInt(priceInfo.winc)) { setText(errorEl, 'Turbo balance недостаточен. Нажмите «Пополнить Turbo».'); return; @@ -632,11 +515,6 @@ export function openArweaveAttachmentManager({ Файл не выбран `}
- -

${turboMode ? '' : ''} @@ -649,18 +527,14 @@ export function openArweaveAttachmentManager({ const walletEl = root.querySelector('#ar-attach-wallet'); const fileEl = root.querySelector('#ar-attach-file'); const mainMetaEl = root.querySelector('[data-meta-main="true"]'); - const previewMetaEl = root.querySelector('[data-meta-preview="true"]'); const errorEl = root.querySelector('[data-error="true"]'); const uploadBtn = root.querySelector('[data-action="upload"]'); - const previewOptionEl = root.querySelector('[data-preview-option="true"]'); - const previewToggleEl = root.querySelector('[data-preview-toggle="true"]'); root.querySelector('[data-action="switch-arweave"]')?.addEventListener('click', async () => { if (selectedUploadTransport === 'arweave') return; selectedUploadTransport = 'arweave'; selectedFile = null; selectedSha256 = ''; - resetPreviewState(); priceInfo = null; balanceInfo = null; await showUpload(); @@ -670,7 +544,6 @@ export function openArweaveAttachmentManager({ selectedUploadTransport = 'turbo'; selectedFile = null; selectedSha256 = ''; - resetPreviewState(); priceInfo = null; balanceInfo = null; await showUpload(); @@ -680,7 +553,7 @@ export function openArweaveAttachmentManager({ if (turboMode) { await loadTurboKeyChoices(errorEl); - await refreshTurboStateForCurrentFile(mainMetaEl, previewMetaEl, errorEl, uploadBtn); + await refreshTurboStateForCurrentFile(mainMetaEl, errorEl, uploadBtn); } else { await loadWallets(errorEl); if (walletEl) { @@ -692,21 +565,19 @@ export function openArweaveAttachmentManager({ uploadBtn.disabled = true; selectedFile = null; selectedSha256 = ''; - resetPreviewState(); - priceInfo = null; + priceInfo = null; balanceInfo = null; if (fileEl) fileEl.value = ''; setText(mainMetaEl, ''); - setText(previewMetaEl, ''); }); } } root.querySelectorAll('[data-action="cancel"]').forEach((btn) => btn.addEventListener('click', () => close(resolve, null))); root.querySelector('[data-action="topup"]')?.addEventListener('click', async () => { - await promptTurboTopUp(mainMetaEl, previewMetaEl, errorEl); + await promptTurboTopUp(mainMetaEl, errorEl); if (turboMode && selectedFile && selectedSha256) { - await refreshTurboStateForCurrentFile(mainMetaEl, previewMetaEl, errorEl, uploadBtn); + await refreshTurboStateForCurrentFile(mainMetaEl, errorEl, uploadBtn); } }); if (!turboMode) { @@ -720,15 +591,11 @@ export function openArweaveAttachmentManager({ fileEl?.addEventListener('change', async () => { selectedFile = fileEl.files?.[0] || null; selectedSha256 = ''; - resetPreviewState(); priceInfo = null; balanceInfo = null; uploadBtn.disabled = true; setText(errorEl, ''); setText(mainMetaEl, ''); - setText(previewMetaEl, ''); - if (previewToggleEl instanceof HTMLInputElement) previewToggleEl.checked = false; - if (previewOptionEl) previewOptionEl.hidden = true; if (!selectedFile) return; try { @@ -740,46 +607,16 @@ export function openArweaveAttachmentManager({ } const buffer = await selectedFile.arrayBuffer(); selectedSha256 = await sha256HexFromArrayBuffer(buffer); - if (previewOptionEl && isPreviewEligibleForCurrentFile()) { - previewOptionEl.hidden = false; - } if (turboMode) { - await refreshTurboStateForCurrentFile(mainMetaEl, previewMetaEl, errorEl, uploadBtn); + await refreshTurboStateForCurrentFile(mainMetaEl, errorEl, uploadBtn); } else { - await recalculateArweaveState(mainMetaEl, previewMetaEl, errorEl, uploadBtn); + await recalculateArweaveState(mainMetaEl, errorEl, uploadBtn); } } catch (error) { setText(errorEl, error?.message || 'Не удалось подготовить файл.'); } }); - previewToggleEl?.addEventListener('change', async () => { - if (!(previewToggleEl instanceof HTMLInputElement)) return; - if (!selectedFile || !isPreviewEligibleForCurrentFile()) { - previewToggleEl.checked = false; - return; - } - uploadBtn.disabled = true; - selectedPreviewEnabled = previewToggleEl.checked; - selectedPreviewFile = null; - selectedPreviewSha256 = ''; - setText(errorEl, ''); - try { - if (selectedPreviewEnabled) { - selectedPreviewFile = await createVideoPreviewFile(selectedFile); - selectedPreviewSha256 = await sha256HexFromArrayBuffer(await selectedPreviewFile.arrayBuffer()); - } - if (turboMode) { - await refreshTurboStateForCurrentFile(mainMetaEl, previewMetaEl, errorEl, uploadBtn); - } else { - await recalculateArweaveState(mainMetaEl, previewMetaEl, errorEl, uploadBtn); - } - } catch (error) { - resetPreviewState(); - previewToggleEl.checked = false; - setText(errorEl, error?.message || 'Не удалось подготовить превью.'); - } - }); uploadBtn?.addEventListener('click', async () => { if (!selectedFile || !selectedSha256) { @@ -796,31 +633,6 @@ export function openArweaveAttachmentManager({ uploadBtn.disabled = true; setText(errorEl, turboMode ? 'Загружаем файл через Turbo...' : 'Загружаем файл в Arweave...'); try { - let previewUpload = null; - if (selectedPreviewEnabled && selectedPreviewFile && selectedPreviewSha256) { - previewUpload = turboMode - ? await uploadFileWithTurbo({ - login: cleanLogin, - storagePwd: cleanStoragePwd, - keySource: selectedTurboKeySource, - file: selectedPreviewFile, - shineType: 'attachment-preview', - tags: [ - { name: 'SHiNE-Login', value: cleanLogin }, - { name: 'SHiNE-Attachment-Preview-For', value: selectedFile.name || 'file' }, - ], - }) - : await uploadArweaveFile({ - gateway: cleanGateway, - jwk: selectedWallet()?.jwk, - file: selectedPreviewFile, - shineType: 'attachment-preview', - tags: [ - { name: 'SHiNE-Login', value: cleanLogin }, - { name: 'SHiNE-Attachment-Preview-For', value: selectedFile.name || 'file' }, - ], - }); - } const uploaded = turboMode ? await uploadFileWithTurbo({ login: cleanLogin, @@ -851,12 +663,6 @@ export function openArweaveAttachmentManager({ sha256: selectedSha256, ar: uploaded.id, uploadTransport: turboMode ? 'turbo' : 'arweave', - preview: previewUpload?.id && selectedPreviewSha256 - ? { - ar: previewUpload.id, - sha256: selectedPreviewSha256, - } - : undefined, uploadedAtMs: Date.now(), purpose: isAvatarMode ? 'avatar' : 'attachment', }, { pendingPlacement: historyOnly && !isAvatarMode }); @@ -867,13 +673,10 @@ export function openArweaveAttachmentManager({ }); if (selectedFile && selectedSha256) { - if (previewOptionEl && isPreviewEligibleForCurrentFile()) { - previewOptionEl.hidden = false; - } if (turboMode) { - await refreshTurboStateForCurrentFile(mainMetaEl, previewMetaEl, errorEl, uploadBtn); + await refreshTurboStateForCurrentFile(mainMetaEl, errorEl, uploadBtn); } else { - await recalculateArweaveState(mainMetaEl, previewMetaEl, errorEl, uploadBtn); + await recalculateArweaveState(mainMetaEl, errorEl, uploadBtn); } } @@ -894,14 +697,6 @@ export function openArweaveAttachmentManager({ `} - -

@@ -914,67 +709,33 @@ export function openArweaveAttachmentManager({ bindBackdrop(); const txEl = root.querySelector('#ar-existing-txid'); const nameEl = root.querySelector('#ar-existing-name'); - const previewWrapEl = root.querySelector('[data-existing-preview-wrap="true"]'); - const previewToggleEl = root.querySelector('[data-existing-preview-toggle="true"]'); - const previewFieldsEl = root.querySelector('[data-existing-preview-fields="true"]'); - const previewTxEl = root.querySelector('#ar-existing-preview-txid'); const metaEl = root.querySelector('[data-meta="true"]'); const errorEl = root.querySelector('[data-error="true"]'); const checkBtn = root.querySelector('[data-action="check"]'); root.querySelector('[data-action="back"]')?.addEventListener('click', showUpload); - nameEl?.addEventListener('input', () => { - const isVideo = isVideoAttachmentName(String(nameEl.value || '').trim()); - if (previewWrapEl) previewWrapEl.hidden = !isVideo; - if (!isVideo) { - if (previewToggleEl instanceof HTMLInputElement) previewToggleEl.checked = false; - if (previewFieldsEl) previewFieldsEl.hidden = true; - if (previewTxEl) previewTxEl.value = ''; - } - }); - previewToggleEl?.addEventListener('change', () => { - if (previewFieldsEl && previewToggleEl instanceof HTMLInputElement) { - previewFieldsEl.hidden = !previewToggleEl.checked; - } - }); checkBtn?.addEventListener('click', async () => { const txId = String(txEl?.value || '').trim(); const name = isAvatarMode ? 'Аватар' : (String(nameEl?.value || '').trim() || 'arweave-file'); - const wantsPreview = !isAvatarMode && previewToggleEl instanceof HTMLInputElement && previewToggleEl.checked; - const previewTxId = String(previewTxEl?.value || '').trim(); if (!validateArweaveTxId(txId)) { setText(errorEl, 'Некорректный Transaction ID Arweave.'); return; } - if (wantsPreview && !validateArweaveTxId(previewTxId)) { - setText(errorEl, 'Некорректный Transaction ID превью.'); - return; - } checkBtn.disabled = true; setText(errorEl, 'Скачиваем файл и считаем SHA-256...'); setText(metaEl, ''); try { const meta = await loadArweaveFileMetadata({ gateway: cleanGateway, txId }); - let preview = null; - if (wantsPreview) { - const previewMeta = await loadArweaveFileMetadata({ gateway: cleanGateway, txId: previewTxId }); - preview = { - ar: previewTxId, - sha256: previewMeta.sha256Hex, - }; - } const item = normalizeAttachment({ name, size: meta.sizeBytes, sha256: meta.sha256Hex, ar: txId, - preview, uploadedAtMs: Date.now(), purpose: isAvatarMode ? 'avatar' : 'attachment', }); metaEl.innerHTML = `
Размер: ${escapeHtml(formatBytes(item.size))}
SHA-256: ${escapeHtml(item.sha256)}
- ${item.preview ? '
Превью будет добавлено вместе с файлом.
' : ''} `; setText(errorEl, ''); const addBtn = document.createElement('button'); @@ -1005,13 +766,11 @@ export function openArweaveAttachmentManager({ ${rows.length ? rows.map((item, index) => { const isSelected = selectedTxIdSet.has(item.ar); return ` -
- ${buildHistoryPreviewMarkup(item, cleanGateway)} +
${escapeHtml(item.name)}${item.purpose === 'avatar' ? ' · аватар' : ''}
${escapeHtml(formatBytes(item.size))} ${escapeHtml(formatArweaveHistoryTime(item.uploadedAtMs))} - ${hasAttachmentPreview(item) ? 'С превью' : ''} Проверяем... ${item.pendingPlacement ? 'Ещё не прикреплён' : ''}
diff --git a/shine-UI/js/components/channel-attachment-manager.js b/shine-UI/js/components/channel-attachment-manager.js new file mode 100644 index 00000000..bc498a73 --- /dev/null +++ b/shine-UI/js/components/channel-attachment-manager.js @@ -0,0 +1,158 @@ +import { openArweaveAttachmentManager } from './arweave-attachment-manager.js'; +import { formatBytes } from '../services/attachment-format.js'; +import { uploadPublicFile } from '../services/public-file-service.js'; +import { state } from '../state.js'; +import { toUserMessage } from '../services/ui-error-texts.js'; + +export function openChannelAttachmentManager({ + login, + storagePwd = '', + gateway = '', + selectedTxIds = [], + signal = null, +} = {}) { + const cleanLogin = String(login || '').trim(); + const root = document.createElement('div'); + root.className = 'public-attachment-manager-root'; + document.body.append(root); + + let closed = false; + let selectedFile = null; + let uploading = false; + + const close = (resolve, value = null) => { + if (closed) return; + closed = true; + root.remove(); + resolve(value); + }; + + return new Promise((resolve) => { + const onAbort = () => close(resolve, null); + if (signal?.aborted) { onAbort(); return; } + signal?.addEventListener('abort', onAbort, { once: true }); + + root.innerHTML = ` + + `; + + const modal = root.querySelector('[data-public-attachment-modal="true"]'); + const fileInput = root.querySelector('[data-role="file"]'); + const selectedEl = root.querySelector('[data-role="selected"]'); + const statusEl = root.querySelector('[data-role="status"]'); + const errorEl = root.querySelector('[data-role="error"]'); + const uploadButton = root.querySelector('[data-action="upload"]'); + const arweaveButton = root.querySelector('[data-action="arweave"]'); + const radios = [...root.querySelectorAll('input[name="attachment-storage"]')]; + + const setSource = (value) => { + root.querySelectorAll('.public-attachment-manager__source').forEach((label) => { + label.classList.toggle('is-selected', label.querySelector('input')?.value === value); + }); + root.querySelector('[data-panel="server"]').hidden = value !== 'server'; + root.querySelector('[data-panel="arweave"]').hidden = value !== 'arweave'; + }; + + radios.forEach((radio) => radio.addEventListener('change', () => setSource(radio.value))); + root.querySelector('[data-action="close"]')?.addEventListener('click', () => close(resolve, null)); + modal?.addEventListener('click', (event) => { + if (event.target === modal && !uploading) close(resolve, null); + }); + + fileInput?.addEventListener('change', () => { + selectedFile = fileInput.files?.[0] || null; + if (selectedEl) selectedEl.textContent = selectedFile + ? `${selectedFile.name} · ${formatBytes(selectedFile.size)}` + : 'Файл не выбран.'; + if (errorEl) errorEl.textContent = ''; + if (statusEl) statusEl.textContent = ''; + if (uploadButton) uploadButton.disabled = !selectedFile; + }); + + uploadButton?.addEventListener('click', async () => { + if (!selectedFile || uploading) return; + uploading = true; + uploadButton.disabled = true; + fileInput.disabled = true; + if (errorEl) errorEl.textContent = ''; + try { + const item = await uploadPublicFile({ + file: selectedFile, + login: cleanLogin, + sessionId: state.session.sessionId, + wsUrl: state.entrySettings.shineServer, + onStatus: (message) => { if (statusEl) statusEl.textContent = message; }, + }); + close(resolve, item); + } catch (error) { + if (errorEl) errorEl.textContent = toUserMessage(error, 'Не удалось загрузить файл.'); + if (statusEl) statusEl.textContent = ''; + uploading = false; + fileInput.disabled = false; + uploadButton.disabled = !selectedFile; + } + }); + + arweaveButton?.addEventListener('click', async () => { + if (uploading) return; + uploading = true; + root.hidden = true; + try { + const item = await openArweaveAttachmentManager({ + login: cleanLogin, + storagePwd, + gateway, + selectedTxIds, + signal, + }); + if (item) close(resolve, item); + else { + uploading = false; + root.hidden = false; + } + } catch (error) { + uploading = false; + root.hidden = false; + if (errorEl) errorEl.textContent = toUserMessage(error, 'Не удалось открыть Arweave.'); + } + }); + }); +} diff --git a/shine-UI/js/components/channel-editor.js b/shine-UI/js/components/channel-editor.js index 08fdb531..2c42a361 100644 --- a/shine-UI/js/components/channel-editor.js +++ b/shine-UI/js/components/channel-editor.js @@ -1,5 +1,6 @@ import { iconHtml } from './ui-icon.js'; -import { markArweaveAttachmentPlaced, openArweaveAttachmentManager } from './arweave-attachment-manager.js'; +import { markArweaveAttachmentPlaced } from './arweave-attachment-manager.js'; +import { openChannelAttachmentManager } from './channel-attachment-manager.js'; import { composeMessageWithAttachments, MAX_MESSAGE_ATTACHMENTS } from '../services/attachment-format.js'; import { state } from '../state.js'; import { toUserMessage } from '../services/ui-error-texts.js'; @@ -266,7 +267,7 @@ export function openChannelEditor({ attachments: [...attachments], }); completed = true; - attachments.forEach((item) => markArweaveAttachmentPlaced(login, item)); + attachments.filter((item) => item?.ar).forEach((item) => markArweaveAttachmentPlaced(login, item)); // Не удаляем новый черновик, открытый после закрытия отправляющего редактора. if (!closed || drafts.get(storageKey)?.text === textarea.value) drafts.delete(storageKey); if (!isActive() || closed) return; @@ -286,7 +287,7 @@ export function openChannelEditor({ }; const onDocumentKeydown = (event) => { - if (!overlay.isConnected || document.querySelector('.ar-attachment-manager-root')) return; + if (!overlay.isConnected || document.querySelector('.ar-attachment-manager-root, .public-attachment-manager-root')) return; if (event.key === 'Escape') { event.preventDefault(); close(); @@ -338,7 +339,7 @@ export function openChannelEditor({ picking = true; dialog.inert = true; sync(); - const item = await openArweaveAttachmentManager({ + const item = await openChannelAttachmentManager({ login, storagePwd: state.session.storagePwdInMemory, gateway: state.entrySettings.arweaveServer, diff --git a/shine-UI/js/components/ui-icon.js b/shine-UI/js/components/ui-icon.js index 010cace4..54a82f44 100644 --- a/shine-UI/js/components/ui-icon.js +++ b/shine-UI/js/components/ui-icon.js @@ -2,6 +2,7 @@ const paths = { heart: '', message: '', more: '', + moreVertical: '', forward: '', download: '', reply: '', diff --git a/shine-UI/js/pages/arweave-uploads-view.js b/shine-UI/js/pages/arweave-uploads-view.js index 10475127..ff42c427 100644 --- a/shine-UI/js/pages/arweave-uploads-view.js +++ b/shine-UI/js/pages/arweave-uploads-view.js @@ -21,7 +21,7 @@ function setStatusBadge(node, status, label) { function renderTile(item, index) { const tile = document.createElement('article'); - tile.className = `ar-attachment-history-tile ar-attachment-history-tile--page${item?.preview?.ar ? ' ar-attachment-history-tile--with-preview' : ''}`; + tile.className = 'ar-attachment-history-tile ar-attachment-history-tile--page'; const name = document.createElement('strong'); name.className = 'ar-attachment-history-name'; @@ -39,12 +39,6 @@ function renderTile(item, index) { const time = document.createElement('span'); time.textContent = formatArweaveHistoryTime(item.uploadedAtMs); meta.append(status, size, time); - if (item?.preview?.ar) { - const previewFlag = document.createElement('span'); - previewFlag.className = 'ar-attachment-placement-flag'; - previewFlag.textContent = 'С превью'; - meta.append(previewFlag); - } if (item.pendingPlacement) { const flag = document.createElement('span'); flag.className = 'ar-attachment-placement-flag'; diff --git a/shine-UI/js/pages/channel-about-view.js b/shine-UI/js/pages/channel-about-view.js index 0b462641..d177c8cc 100644 --- a/shine-UI/js/pages/channel-about-view.js +++ b/shine-UI/js/pages/channel-about-view.js @@ -2,6 +2,7 @@ import { iconHtml } from '../components/ui-icon.js'; import { createTopBar } from '../components/topbar.js'; import { confirmDialog } from '../components/confirm-dialog.js'; import { renderAvatar } from '../components/avatar-image.js'; +import { markArweaveAttachmentPlaced, openArweaveAttachmentManager } from '../components/arweave-attachment-manager.js'; import { authService, setChannelsFeed, state } from '../state.js'; import { navigateBack, getPreviousTrackedPath } from '../router.js'; import { @@ -70,6 +71,112 @@ function ownerDisplayName(snapshot, ownerLogin) { return [firstName, lastName].filter(Boolean).join(' ').trim() || String(ownerLogin || '').trim() || 'Владелец канала'; } +function formatChannelCreatedAt(value) { + const time = Number(value || 0); + if (!Number.isFinite(time) || time <= 0) return 'Неизвестно'; + try { + return new Intl.DateTimeFormat('ru-RU', { day: '2-digit', month: 'long', year: 'numeric' }).format(new Date(time)); + } catch { + return new Date(time).toLocaleDateString('ru-RU'); + } +} + +function openChannelProfileEditor({ channel, selector, onSaved }) { + const root = document.getElementById('modal-root'); + if (!root) return; + let selectedAvatar = String(channel?.avaAr || '').trim() ? { + name: 'Аватар', + ar: String(channel.avaAr || '').trim(), + sha256: String(channel?.avaSha256 || '').trim(), + size: Number(channel?.avaSize || 0), + purpose: 'avatar', + } : null; + + const cleanTitle = String(channel?.displayName || channel?.displayTitle || channel?.channelName || '').trim(); + const cleanDescription = String(channel?.channelDescription || channel?.description || '').trim(); + + root.innerHTML = ` + + `; + + const renderPreview = () => { + const slot = root.querySelector('#channel-profile-edit-avatar-preview'); + if (!slot) return; + const title = String(root.querySelector('#channel-profile-edit-title')?.value || cleanTitle).trim(); + slot.innerHTML = ''; + slot.append(renderAvatar({ + initials: (title || 'К').slice(0, 1).toUpperCase(), + avatar: selectedAvatar?.ar ? { ar: selectedAvatar.ar } : null, + size: 'xl', + className: 'channel-about-avatar channel-profile-avatar', + title: title || 'Канал', + alt: 'Аватар канала', + })); + }; + renderPreview(); + + root.querySelector('#channel-profile-edit-cancel')?.addEventListener('click', () => { root.innerHTML = ''; }); + root.querySelector('#channel-profile-edit-title')?.addEventListener('input', renderPreview); + root.querySelector('#channel-profile-edit-avatar')?.addEventListener('click', async () => { + const errorEl = root.querySelector('#channel-profile-edit-error'); + try { + const item = await openArweaveAttachmentManager({ + login: state.session.login, + storagePwd: state.session.storagePwdInMemory, + gateway: state.entrySettings.arweaveServer, + mode: 'avatar', + historyPurpose: 'avatar', + }); + if (!item) return; + selectedAvatar = item; + renderPreview(); + } catch (error) { + if (errorEl) errorEl.textContent = toUserMessage(error, 'Не удалось выбрать аватар.'); + } + }); + + root.querySelector('#channel-profile-edit-save')?.addEventListener('click', async () => { + const save = root.querySelector('#channel-profile-edit-save'); + const errorEl = root.querySelector('#channel-profile-edit-error'); + const title = String(root.querySelector('#channel-profile-edit-title')?.value || '').trim(); + const description = String(root.querySelector('#channel-profile-edit-description')?.value || '').trim(); + if (Array.from(title).length > 50 || Array.from(description).length > 250) { + if (errorEl) errorEl.textContent = 'Название — до 50 символов, описание — до 250.'; + return; + } + save.disabled = true; + if (errorEl) errorEl.textContent = ''; + try { + const login = String(state.session.login || '').trim(); + const storagePwd = String(state.session.storagePwdInMemory || '').trim(); + if (!login || !storagePwd) throw new Error('Для изменения профиля нужно войти заново.'); + await authService.addBlockChannelMeta({ login, storagePwd, channel: selector, title, description, avatar: selectedAvatar }); + if (selectedAvatar?.ar) markArweaveAttachmentPlaced(login, selectedAvatar); + root.innerHTML = ''; + showToast('Профиль канала обновлён'); + onSaved?.(); + } catch (error) { + save.disabled = false; + if (errorEl) errorEl.textContent = toUserMessage(error, 'Не удалось изменить профиль канала.'); + } + }); +} + function isSelectorMatch(row, selector) { return Boolean( row?.channel @@ -109,13 +216,26 @@ async function resolveChannelSelector(route) { String(item?.channel?.channelName || '').trim().toLowerCase() === channelName.toLowerCase() && String(item?.channel?.ownerLogin || '').trim().toLowerCase() === ownerLoginNormalized )); - if (!row?.channel?.channelRoot) throw new Error('Канал не найден.'); + if (row?.channel?.channelRoot) { + const rootBlockchainName = String(row.channel.ownerBlockchainName || ownerRef).trim(); + return { + ownerBlockchainName: rootBlockchainName, + channelRootBlockNumber: Number(row.channel.channelRoot.blockNumber), + channelRootBlockHash: normalizeHash(row.channel.channelRoot.blockHash), + channelName, + }; + } - const rootBlockchainName = String(row.channel.ownerBlockchainName || ownerRef).trim(); + const profileChannels = await authService.listUserProfileChannels(ownerLogin, 'owned', 500, 0, true); + const deletedRow = (Array.isArray(profileChannels?.channels) ? profileChannels.channels : []).find((item) => ( + String(item?.slug || '').trim().toLowerCase() === channelName.toLowerCase() + && String(item?.ownerLogin || '').trim().toLowerCase() === ownerLoginNormalized + )); + if (!deletedRow) throw new Error('Канал не найден.'); return { - ownerBlockchainName: rootBlockchainName, - channelRootBlockNumber: Number(row.channel.channelRoot.blockNumber), - channelRootBlockHash: normalizeHash(row.channel.channelRoot.blockHash), + ownerBlockchainName: String(deletedRow.ownerBlockchainName || ownerRef).trim(), + channelRootBlockNumber: Number(deletedRow.rootBlockNumber), + channelRootBlockHash: normalizeHash(deletedRow.rootBlockHashHex), channelName, }; } @@ -479,6 +599,7 @@ export function render({ navigate, route, chrome }) {
${cameFromChannel ? '' : ``} + ${isOwnChannel ? `` : ''} ${subscriptionTile} ${isOwnChannel ? '' : ``}
@@ -488,6 +609,9 @@ export function render({ navigate, route, chrome }) { Описание

${escapeHtml(description || 'Описание не задано.')}

+
+ Создан${escapeHtml(formatChannelCreatedAt(channel?.createdAtMs))} +
${isOwnChannel && !isDeleted ? `` : ''}