From fbc1773553d88de7cc3827155e92536e35b28a68 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=D0=9D=D0=B8=D0=BA=D0=B8=D1=82=D0=B0?= Date: Tue, 10 Nov 2026 10:57:36 +0300 Subject: [PATCH 1/2] =?UTF-8?q?=D0=A0=D0=B5=D0=B0=D0=BB=D0=B8=D0=B7=D0=BE?= =?UTF-8?q?=D0=B2=D0=B0=D1=82=D1=8C=20=D0=BB=D0=B0=D0=B1=D0=BE=D1=80=D0=B0?= =?UTF-8?q?=D1=82=D0=BE=D1=80=D0=BD=D1=83=D1=8E=20=D1=80=D0=B0=D0=B1=D0=BE?= =?UTF-8?q?=D1=82=D1=83=204?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .dockerignore | 2 + .gitignore | 4 +- Dockerfile | 39 + Makefile | 33 +- REPORT.md | 198 ++++- compose.yaml | 171 +++++ docs/ARCHITECTURE.md | 38 + docs/PR.md | 24 + evidence/attachments.json | 68 ++ evidence/consistency.json | 343 +++++++++ evidence/failover.txt | 52 ++ evidence/image-ui-api.txt | 2 + evidence/image-ui.json | 20 + evidence/persistence.txt | 17 + evidence/ui-image-previews.jpg | Bin 0 -> 54339 bytes evidence/ui-image-viewer-desktop.jpg | Bin 0 -> 14164 bytes evidence/ui-image-viewer-mobile.jpg | Bin 0 -> 15412 bytes evidence/verification.txt | 8 + infra/haproxy.cfg | 40 + scripts/compose.sh | 4 + scripts/init-secrets.py | 19 + scripts/init-secrets.sh | 3 + scripts/restart.sh | 7 + scripts/stop-one.sh | 13 + src/Messenger.Api/Contracts/AttachmentDto.cs | 4 + src/Messenger.Api/Contracts/ChatCursor.cs | 7 + src/Messenger.Api/Contracts/ChatDto.cs | 3 + src/Messenger.Api/Contracts/ChatPreviewDto.cs | 4 + .../Contracts/CreateChatRequest.cs | 6 + .../Contracts/CreateMessageRequest.cs | 8 + .../Contracts/CreateUserRequest.cs | 7 + src/Messenger.Api/Contracts/MessageDto.cs | 3 + src/Messenger.Api/Contracts/SessionDto.cs | 3 + src/Messenger.Api/Contracts/UserDto.cs | 3 + src/Messenger.Api/Data/AppDatabase.cs | 206 +++++ src/Messenger.Api/Data/Attachments.cs | 22 + src/Messenger.Api/Data/ChatPreviews.cs | 51 ++ src/Messenger.Api/Data/DatabaseMigrator.cs | 40 + src/Messenger.Api/Data/Entities/ChatEntity.cs | 6 + .../Data/Entities/MessageEntity.cs | 6 + .../Data/Entities/SessionEntity.cs | 3 + src/Messenger.Api/Data/Entities/UserEntity.cs | 6 + src/Messenger.Api/Data/MessageRequests.cs | 91 +++ .../Data/Migrations/001_initial.sql | 43 ++ .../Data/Migrations/002_idempotency.sql | 11 + .../Data/Migrations/003_reactions.sql | 6 + .../Data/Migrations/004_attachments.sql | 11 + src/Messenger.Api/Data/Reactions.cs | 48 ++ src/Messenger.Api/Data/UtcClock.cs | 11 + .../Endpoints/AttachmentEndpoints.cs | 51 ++ src/Messenger.Api/Endpoints/AuthEndpoints.cs | 60 ++ src/Messenger.Api/Endpoints/ChatEndpoints.cs | 67 ++ .../Endpoints/HealthEndpoints.cs | 18 + .../Endpoints/MessageEndpoints.cs | 80 ++ .../Endpoints/ReactionEndpoints.cs | 39 + src/Messenger.Api/Endpoints/UiEndpoints.cs | 80 ++ src/Messenger.Api/Endpoints/UserEndpoints.cs | 40 + .../Infrastructure/ClusterPresence.cs | 55 ++ .../Infrastructure/InstanceIdentity.cs | 6 + .../Infrastructure/ReadinessState.cs | 8 + .../Infrastructure/RedisSessionCache.cs | 58 ++ src/Messenger.Api/Infrastructure/S3Storage.cs | 26 + src/Messenger.Api/Messenger.Api.csproj | 22 + .../Middleware/ExceptionHandlingMiddleware.cs | 42 ++ .../Middleware/InstanceMiddleware.cs | 18 + .../Middleware/RequestIdMiddleware.cs | 16 + .../Middleware/RequestLoggingMiddleware.cs | 25 + src/Messenger.Api/Program.cs | 110 +++ .../Properties/launchSettings.json | 23 + src/Messenger.Api/Services/ApiSupport.cs | 93 +++ .../Services/AttachmentException.cs | 6 + .../Services/AttachmentReconciler.cs | 97 +++ .../Services/AttachmentService.cs | 76 ++ src/Messenger.Api/Services/ChatService.cs | 16 + src/Messenger.Api/Services/CursorService.cs | 49 ++ src/Messenger.Api/Services/MessageService.cs | 13 + src/Messenger.Api/Services/PasswordService.cs | 28 + src/Messenger.Api/Services/SessionService.cs | 65 ++ src/Messenger.Api/Services/UserService.cs | 24 + .../appsettings.Development.json | 8 + src/Messenger.Api/appsettings.json | 9 + src/Messenger.Api/wwwroot/app.css | 438 +++++++++++ src/Messenger.Api/wwwroot/app.js | 703 ++++++++++++++++++ .../wwwroot/assets/chat-pattern.svg | 7 + .../wwwroot/assets/kolovertysh-empty-320.webp | Bin 0 -> 26422 bytes .../wwwroot/assets/kolovertysh-error-320.webp | Bin 0 -> 31826 bytes .../assets/kolovertysh-welcome-320.webp | Bin 0 -> 20050 bytes .../assets/kolovertysh-welcome-640.webp | Bin 0 -> 55878 bytes .../wwwroot/assets/kolovertysh.svg | 63 ++ src/Messenger.Api/wwwroot/attachments.css | 61 ++ src/Messenger.Api/wwwroot/attachments.js | 191 +++++ src/Messenger.Api/wwwroot/avatars.js | 42 ++ src/Messenger.Api/wwwroot/cluster-view.js | 90 +++ src/Messenger.Api/wwwroot/diagnostics.js | 113 +++ src/Messenger.Api/wwwroot/index.html | 169 +++++ src/Messenger.Api/wwwroot/mascots.js | 143 ++++ src/Messenger.Api/wwwroot/message-view.js | 96 +++ src/Messenger.Api/wwwroot/polish.css | 41 + src/Messenger.Api/wwwroot/reactions.js | 45 ++ src/Messenger.Api/wwwroot/showcase.css | 41 + student-tests/attachments.py | 61 ++ student-tests/consistency.py | 105 +++ student-tests/fixtures/sample.jpg | Bin 0 -> 8506 bytes 103 files changed, 5424 insertions(+), 27 deletions(-) create mode 100644 Dockerfile create mode 100644 compose.yaml create mode 100644 docs/ARCHITECTURE.md create mode 100644 docs/PR.md create mode 100644 evidence/attachments.json create mode 100644 evidence/consistency.json create mode 100644 evidence/failover.txt create mode 100644 evidence/image-ui-api.txt create mode 100644 evidence/image-ui.json create mode 100644 evidence/persistence.txt create mode 100644 evidence/ui-image-previews.jpg create mode 100644 evidence/ui-image-viewer-desktop.jpg create mode 100644 evidence/ui-image-viewer-mobile.jpg create mode 100644 evidence/verification.txt create mode 100644 infra/haproxy.cfg create mode 100755 scripts/compose.sh create mode 100644 scripts/init-secrets.py create mode 100755 scripts/init-secrets.sh create mode 100755 scripts/restart.sh create mode 100755 scripts/stop-one.sh create mode 100644 src/Messenger.Api/Contracts/AttachmentDto.cs create mode 100644 src/Messenger.Api/Contracts/ChatCursor.cs create mode 100644 src/Messenger.Api/Contracts/ChatDto.cs create mode 100644 src/Messenger.Api/Contracts/ChatPreviewDto.cs create mode 100644 src/Messenger.Api/Contracts/CreateChatRequest.cs create mode 100644 src/Messenger.Api/Contracts/CreateMessageRequest.cs create mode 100644 src/Messenger.Api/Contracts/CreateUserRequest.cs create mode 100644 src/Messenger.Api/Contracts/MessageDto.cs create mode 100644 src/Messenger.Api/Contracts/SessionDto.cs create mode 100644 src/Messenger.Api/Contracts/UserDto.cs create mode 100644 src/Messenger.Api/Data/AppDatabase.cs create mode 100644 src/Messenger.Api/Data/Attachments.cs create mode 100644 src/Messenger.Api/Data/ChatPreviews.cs create mode 100644 src/Messenger.Api/Data/DatabaseMigrator.cs create mode 100644 src/Messenger.Api/Data/Entities/ChatEntity.cs create mode 100644 src/Messenger.Api/Data/Entities/MessageEntity.cs create mode 100644 src/Messenger.Api/Data/Entities/SessionEntity.cs create mode 100644 src/Messenger.Api/Data/Entities/UserEntity.cs create mode 100644 src/Messenger.Api/Data/MessageRequests.cs create mode 100644 src/Messenger.Api/Data/Migrations/001_initial.sql create mode 100644 src/Messenger.Api/Data/Migrations/002_idempotency.sql create mode 100644 src/Messenger.Api/Data/Migrations/003_reactions.sql create mode 100644 src/Messenger.Api/Data/Migrations/004_attachments.sql create mode 100644 src/Messenger.Api/Data/Reactions.cs create mode 100644 src/Messenger.Api/Data/UtcClock.cs create mode 100644 src/Messenger.Api/Endpoints/AttachmentEndpoints.cs create mode 100644 src/Messenger.Api/Endpoints/AuthEndpoints.cs create mode 100644 src/Messenger.Api/Endpoints/ChatEndpoints.cs create mode 100644 src/Messenger.Api/Endpoints/HealthEndpoints.cs create mode 100644 src/Messenger.Api/Endpoints/MessageEndpoints.cs create mode 100644 src/Messenger.Api/Endpoints/ReactionEndpoints.cs create mode 100644 src/Messenger.Api/Endpoints/UiEndpoints.cs create mode 100644 src/Messenger.Api/Endpoints/UserEndpoints.cs create mode 100644 src/Messenger.Api/Infrastructure/ClusterPresence.cs create mode 100644 src/Messenger.Api/Infrastructure/InstanceIdentity.cs create mode 100644 src/Messenger.Api/Infrastructure/ReadinessState.cs create mode 100644 src/Messenger.Api/Infrastructure/RedisSessionCache.cs create mode 100644 src/Messenger.Api/Infrastructure/S3Storage.cs create mode 100644 src/Messenger.Api/Messenger.Api.csproj create mode 100644 src/Messenger.Api/Middleware/ExceptionHandlingMiddleware.cs create mode 100644 src/Messenger.Api/Middleware/InstanceMiddleware.cs create mode 100644 src/Messenger.Api/Middleware/RequestIdMiddleware.cs create mode 100644 src/Messenger.Api/Middleware/RequestLoggingMiddleware.cs create mode 100644 src/Messenger.Api/Program.cs create mode 100644 src/Messenger.Api/Properties/launchSettings.json create mode 100644 src/Messenger.Api/Services/ApiSupport.cs create mode 100644 src/Messenger.Api/Services/AttachmentException.cs create mode 100644 src/Messenger.Api/Services/AttachmentReconciler.cs create mode 100644 src/Messenger.Api/Services/AttachmentService.cs create mode 100644 src/Messenger.Api/Services/ChatService.cs create mode 100644 src/Messenger.Api/Services/CursorService.cs create mode 100644 src/Messenger.Api/Services/MessageService.cs create mode 100644 src/Messenger.Api/Services/PasswordService.cs create mode 100644 src/Messenger.Api/Services/SessionService.cs create mode 100644 src/Messenger.Api/Services/UserService.cs create mode 100644 src/Messenger.Api/appsettings.Development.json create mode 100644 src/Messenger.Api/appsettings.json create mode 100644 src/Messenger.Api/wwwroot/app.css create mode 100644 src/Messenger.Api/wwwroot/app.js create mode 100644 src/Messenger.Api/wwwroot/assets/chat-pattern.svg create mode 100644 src/Messenger.Api/wwwroot/assets/kolovertysh-empty-320.webp create mode 100644 src/Messenger.Api/wwwroot/assets/kolovertysh-error-320.webp create mode 100644 src/Messenger.Api/wwwroot/assets/kolovertysh-welcome-320.webp create mode 100644 src/Messenger.Api/wwwroot/assets/kolovertysh-welcome-640.webp create mode 100644 src/Messenger.Api/wwwroot/assets/kolovertysh.svg create mode 100644 src/Messenger.Api/wwwroot/attachments.css create mode 100644 src/Messenger.Api/wwwroot/attachments.js create mode 100644 src/Messenger.Api/wwwroot/avatars.js create mode 100644 src/Messenger.Api/wwwroot/cluster-view.js create mode 100644 src/Messenger.Api/wwwroot/diagnostics.js create mode 100644 src/Messenger.Api/wwwroot/index.html create mode 100644 src/Messenger.Api/wwwroot/mascots.js create mode 100644 src/Messenger.Api/wwwroot/message-view.js create mode 100644 src/Messenger.Api/wwwroot/polish.css create mode 100644 src/Messenger.Api/wwwroot/reactions.js create mode 100644 src/Messenger.Api/wwwroot/showcase.css create mode 100644 student-tests/attachments.py create mode 100644 student-tests/consistency.py create mode 100644 student-tests/fixtures/sample.jpg diff --git a/.dockerignore b/.dockerignore index bc16e556..781f0450 100644 --- a/.dockerignore +++ b/.dockerignore @@ -16,5 +16,7 @@ backups .venv __pycache__ node_modules +**/bin +**/obj evidence .DS_Store diff --git a/.gitignore b/.gitignore index b5a71896..60be5d67 100644 --- a/.gitignore +++ b/.gitignore @@ -11,7 +11,7 @@ certs/private/ *.pem *.tfstate* volumes/ -data/ +/data/ backups/ # Runtime/build artifacts .venv/ @@ -30,3 +30,5 @@ coverage/ .vscode/ # Keep small, sanitized evidence summaries in evidence/ under version control. # Inspect git diff --cached: ignore rules are not a secret scanner. + +/.local/ diff --git a/Dockerfile b/Dockerfile new file mode 100644 index 00000000..162159c5 --- /dev/null +++ b/Dockerfile @@ -0,0 +1,39 @@ +FROM mcr.microsoft.com/dotnet/sdk:9.0.306 AS build + +WORKDIR /src + +COPY src/Messenger.Api/Messenger.Api.csproj src/Messenger.Api/ +RUN dotnet restore src/Messenger.Api/Messenger.Api.csproj + +COPY src/Messenger.Api/ src/Messenger.Api/ + +RUN dotnet publish src/Messenger.Api/Messenger.Api.csproj \ + -c Release \ + --no-restore \ + -o /app/publish + + +FROM mcr.microsoft.com/dotnet/aspnet:9.0.10 AS runtime + +RUN apt-get update \ + && apt-get install -y --no-install-recommends curl \ + && rm -rf /var/lib/apt/lists/* + +WORKDIR /app +ARG BUILD_REVISION=local +LABEL org.opencontainers.image.revision=$BUILD_REVISION + +COPY --from=build /app/publish . + +ENV APP_HOST=0.0.0.0 +ENV APP_PORT=8080 +ENV APP_ENV=lab + +EXPOSE 8080 + +USER app + +HEALTHCHECK --interval=10s --timeout=3s --start-period=5s --retries=3 \ + CMD curl --fail --silent http://127.0.0.1:8080/health/ready > /dev/null || exit 1 + +ENTRYPOINT ["dotnet", "Messenger.Api.dll"] diff --git a/Makefile b/Makefile index 5d86d171..0d5c3b2b 100644 --- a/Makefile +++ b/Makefile @@ -1,5 +1,5 @@ -PYTHON ?= python3 -BASE_URL ?= http://localhost:8080 +PYTHON ?= .venv/bin/python +BASE_URL ?= http://localhost:18084 CA_FILE ?= ACTION_SCRIPT ?= TLS_ARGS = $(if $(CA_FILE),--ca-file "$(CA_FILE)",) @@ -28,3 +28,32 @@ test-persistence: test-failover: @test -n "$(ACTION_SCRIPT)" || (echo "Set ACTION_SCRIPT to your implemented executable stop-one hook"; exit 2) $(PYTHON) tests/resilience.py --mode failover --action-script "$(ACTION_SCRIPT)" --base-url "$(BASE_URL)" $(TLS_ARGS) + +.PHONY: setup up down build restore-api reconcile reconcile-apply +setup: + python3 -m venv .venv + .venv/bin/python -m pip install -r requirements-dev.txt + ./scripts/init-secrets.sh +up: + ./scripts/init-secrets.sh + ./scripts/compose.sh build api + ./scripts/compose.sh up -d --wait --wait-timeout 120 +build: + dotnet build src/Messenger.Api +restore-api: + ./scripts/compose.sh up -d --wait api lb +reconcile: + ./scripts/compose.sh exec -T api dotnet Messenger.Api.dll --reconcile +reconcile-apply: + ./scripts/compose.sh exec -T api dotnet Messenger.Api.dll --reconcile --apply +down: + ./scripts/compose.sh down + +.PHONY: student-test +student-test: + $(PYTHON) student-tests/attachments.py --base-url "$(BASE_URL)" + +.PHONY: research-grade5 +research-grade5: + $(PYTHON) student-tests/consistency.py --base-url "$(BASE_URL)" + diff --git a/REPORT.md b/REPORT.md index 9ad2b84f..e04bdefc 100644 --- a/REPORT.md +++ b/REPORT.md @@ -1,37 +1,187 @@ -# Отчёт — лабораторная 4 +# Лабораторная 4 -- Автор, группа: TODO -- Целевая оценка; выбранный трек 5, если нужен: TODO -- Commit/PR: TODO после публикации -- Использованные источники, библиотеки и помощь ИИ: TODO +Автор: Каменский Никита, БВТ-2302. +Цель: 5, трек 2 «Согласованность двух хранилищ». -## Запуск из чистого clone +## Запуск -TODO: версии runtime/образов, prerequisites, команды создания локальных secrets/.env, build, миграций, запуска, ожидания готовности, тестов и остановки. Указать необходимые действия оператора. Не вставлять секреты. Отдельно указать безопасную остановку и команду намеренного удаления учебных данных. +Нужны Docker Desktop, Python 3.9+, доступ в интернет для сборки. +Локальная сборка без Docker дополнительно требует .NET SDK 9. -## Архитектура и решения +```sh +make setup +make up +make check +make test +make student-test +make test-persistence ACTION_SCRIPT=scripts/restart.sh +make test-failover ACTION_SCRIPT=scripts/stop-one.sh +make restore-api +make research-grade5 +``` -TODO: схема процессов/хранилищ, источник истины, транзакционные границы, ограничения. Что перенесено из lab3, что изменено в этой работе. Соответствие переменных из .env.example реальной конфигурации. +Интерфейс: http://localhost:18084/. Регистрация требует пароль 12–128 символов. +Кнопка со скрепкой загружает PNG/JPEG; до отправки видна миниатюра, которую +можно убрать. В сообщении превью появляется автоматически. Нажатие открывает +просмотр на весь экран с увеличением, скачиванием и переходом между изображениями. +Стрелки клавиатуры перелистывают, Esc закрывает просмотр; на телефоне есть свайп. +Скачивание сохраняет исходное имя и байты файла. +Автоматический повтор загрузки не используется: повтор POST может создать новый файл. -## Доказательства критериев +Остановить с сохранением данных: `make down`. Намеренно удалить учебные данные: +`./scripts/compose.sh down -v`. Последняя команда удаляет PostgreSQL и S3 volumes. -| Критерий README | Команда/сценарий | Наблюдаемый результат | Файл доказательства | -| --- | --- | --- | --- | -| Публичный smoke | make test | TODO | TODO | -| Остальные пункты уровня 3 | TODO | TODO | TODO | -| Все пункты уровня 4, если заявлен | TODO | TODO | TODO | -| Выбранный трек 5, если заявлен | TODO | TODO | TODO | +Секреты создаёт scripts/init-secrets.py в исключённой из Git папке secrets/. +Повторный запуск сохраняет существующие ключи. Миграции выполняет отдельный +сервис migrate с транзакционной блокировкой. s3-bootstrap создаёт bucket +только при его отсутствии и использует отдельную административную пару ключей. +API получает другую пару: Read/Write/List только bucket messenger. +Bootstrap не использует пользовательские credentials и не выводит их. -TODO: добавить отдельную строку для каждого заявленного критерия. PASS без команды и наблюдения не является доказательством. Проверка инфраструктурного hook требует подтверждения, какие реальные процессы/хранилища перезапущены. +Версии: .NET SDK 9.0.306/runtime 9.0.10, PostgreSQL 17.6, Redis 7.4.2, +HAProxy 3.2.7-alpine, SeaweedFS 3.97, AWSSDK.S3 4.0.0, SkiaSharp 3.119.1. +Контейнер API работает под непривилегированным пользователем app. -## Эксперименты и отказы +## Архитектура -TODO: гипотеза, hardware/лимиты, версии, объём данных, профиль нагрузки, concurrency/arrival rate, длительность/прогрев, повторы, успешные RPS, ошибки, p50/p95/p99, CPU/RAM. Сохранить raw summary без tokens и объяснить ограничения измерения. +Клиент обращается к HAProxy, который распределяет запросы между двумя API. +PostgreSQL хранит пользователей, чаты, сообщения, сессии, ключи идемпотентности +и метаданные вложений. Redis хранит кэш сессий и heartbeat. SeaweedFS хранит +оригиналы в приватном S3 bucket. Наружу опубликован только HAProxy на localhost. -| Воздействие | Что ожидаем | Что наблюдали | Время восстановления / потеря данных | -| --- | --- | --- | --- | -| TODO | TODO | TODO | TODO | +Из Lab3 перенесены собственные исходники, интерфейс, Dockerfile, HAProxy и +операционные скрипты. Skeleton, публичные tests и contracts взяты из Lab4. +Сопоставление всех критериев с файлами: docs/ARCHITECTURE.md. -## Ограничения и следующие шаги +Новые маршруты: POST /api/v1/chats/{id}/attachments, GET /api/v1/attachments/{id} +и GET /api/v1/attachments/{id}/content. Перед обработкой проверяются Bearer и +членство в чате; чужое и неизвестное вложение возвращают одинаковый 404. +Публичные метаданные не содержат object key и адрес S3. Filename никогда не +используется в пути. Случайный ключ: originals/. -TODO: какие отказы выдерживаются и какие нет; что не реализовано; где учебное упрощение; какое улучшение подтверждено, а какое пока гипотеза. +У сообщения появился attachment_ids: 0–10 уникальных UUID из того же чата. +Пустой текст разрешён только с вложениями. Порядок ID сохраняется. Хеш +идемпотентности включает текст и массив ID. Отсутствующий массив равен []. +Запись сообщения и ключа идемпотентности остаётся одной транзакцией PostgreSQL. + +Превью запрашиваются с Bearer при приближении к видимой области, одновременно +не более двух загрузок. При уходе изображения за экран запрос отменяется, +blob URL освобождается; активный просмотр удерживает оригинал до закрытия. +При смене чата или сессии ресурсы освобождаются. Проверки интерфейса и +скачанного оригинала: evidence/image-ui.json. + +## Память, лимиты и ошибки + +Размер проверяется по Content-Length и по реально прочитанным байтам. +Предел — 10 MiB. Содержимое копируется во временный файл буфером 64 KiB. +Временный файл нужен только для проверки и PUT; он не является хранилищем +оригиналов и удаляется при закрытии. API не должен иметь этот файл для GET. +SkiaSharp определяет формат и размеры до выделения bitmap. Предел — +40 млн пикселей. После проверки выполняется полное декодирование первого кадра. +Исходные байты отправляются без перекодирования. AWS chunk encoding отключён: +SeaweedFS 3.97 должен получить именно оригинал, без служебных SigV4 chunk frames. Повреждение/неверный MIME — +415; превышение bytes/pixels — 413; опасное имя — 400. + +Одна API одновременно обслуживает одну загрузку/декодирование; остальные +ждут семафор с отменой. Общий deadline upload — 90 секунд, SDK S3 — 20 секунд, +непрозрачных retries нет. Декодированный RGBA bitmap до 160 млн байт плюс +накладные расходы. Лимит каждой API — 512 MiB; S3 — 512 MiB. +Результаты 10 одновременно начатых PNG uploads и выборочные замеры +memory.current обеих API: evidence/attachments.json. Замеры каждые 100 ms +плюс время docker exec; краткий пик между выборками может быть пропущен. + +Readiness зависит от PostgreSQL и S3; liveness проверяет процесс. При отказе +S3 HAProxy исключает API, поэтому его собственный 503 может быть без JSON +и X-Instance-Id. Ошибки, созданные API, имеют общий формат контракта. +Redis не критичен для сохранности сессии: PostgreSQL остаётся источником истины. + +## Согласованность и очистка + +201 возвращается только после успешного S3 PUT и COMMIT метаданных. +У S3 и PostgreSQL нет общей транзакции. Ошибка после PUT может оставить orphan. +При неопределённом исходе COMMIT нельзя немедленно удалять файл: COMMIT мог +состояться. Такие случаи исправляются последующей сверкой. + +Все загрузки и сообщения со ссылками получают shared advisory lock 48260104 +в PostgreSQL. Reconciler получает exclusive lock, поэтому во время сверки +публикация и новые ссылки не могут обогнать проверку. Это компромисс для +учебного стенда: длительная сверка задерживает запись, запускать её следует +в техническое окно. GET продолжает работать. Только наши writers соблюдают +протокол; прямые изменения оператором во время сверки не поддерживаются. + +```sh +make reconcile # dry-run, только показать действия +make reconcile-apply # применить действия +``` + +Grace period по умолчанию 3600 секунд, минимум 120. Учитываются время создания +метаданных и LastModified объекта. Fresh пропускаются. Старый объект без +метаданных удаляется только при отсутствии ссылки сообщения на его UUID. +Старое непривязанное вложение удаляется из обоих хранилищ. Оригинал, на который +ссылается сообщение, не удаляется. Если файл используется сообщением, но его метаданные были удалены напрямую +из БД, сверка сообщает missing_metadata и сохраняет байты. Оператор должен +восстановить метаданные из резервной копии. Если используемый оригинал пропал, запись +помечается missing: публичный GET метаданных/content возвращает 409, +сообщение и ID сохраняются. Восстановление байтов требует резервной копии. +Автоматическое восстановление отсутствующего оригинала не заявляется. + +S3 обходится страницами до 1000 объектов, PostgreSQL — до 200 записей по UUID. +Повтор удалений безопасен. Если процесс прервётся между удалением байтов и +метаданных, следующая сверка удалит оставшуюся старую непривязанную запись. +Если S3 недоступен, сверка останавливается: timeout не принимается за отсутствие. +Общий timeout команды — 5 минут. Подробный список действий требует памяти, +пропорциональной числу найденных проблем; для больших хранилищ нужен вывод потоком. + +## Проверки критериев + +| Критерий | Проверка | Доказательство | +| --- | --- | --- | +| Текстовые сообщения, сессии, идемпотентность, файлы и ACL | make test | evidence/verification.txt | +| Размер, пиксели, повреждение, MIME, filename, чужой чат и ID | make student-test | evidence/attachments.json | +| 10 параллельных upload, RAM | make student-test | evidence/attachments.json | +| Сохранность оригинала и прежней сессии после restart | make test-persistence | evidence/persistence.txt | +| Остановка загрузившей API, чтение из другой | make test-failover | evidence/failover.txt | +| Приватный bucket, ограниченные ключи | make research-grade5 | evidence/consistency.json | +| Обрыв загрузки, PUT с ошибкой БД, отказ S3 | make research-grade5 | evidence/consistency.json | +| Dry-run, repair, повтор, fresh и used, стоимость | make research-grade5 | evidence/consistency.json | + +Гипотеза исследования: при едином протоколе блокировок и grace period можно +находить и очищать старые orphan/unreferenced данные, сохраняя свежие и +используемые файлы. Методика вводит недостающий S3 объект и отказ SQL INSERT +после PUT, выполняет dry-run, apply и повтор. LastModified не подделывается: +тест действительно ждёт минимальный safety interval. Команда сообщает число +объектов, строк, S3-запросов, elapsed_ms и peak_process_bytes. + +## Результаты эксперимента + +На локальном Docker Desktop: Linux/aarch64, 8 CPU, 4106604544 байт памяти VM. +10 одновременно начатых загрузок PNG по 3147775 байт завершились без ошибок. +Пик выборок memory.current API: 220725248 и 160665600 байт при лимите 512 MiB +на каждую. Точные времена, исходные выборки и условия сохранены в attachments.json. + +После очистки три одинаковых dry-run обхода 11 объектов и 13 строк выполнили +по 12 S3-запросов. Длительности: 331.6, 891.0 и 447.3 ms, медиана 447.3 ms. +PeakWorkingSet процесса около 109 MB включает запуск CLR и SDK; это не +чистая память только алгоритма. Малый набор и один host не позволяют +экстраполировать результат на миллионы объектов. Отдельно сохранены dry-run, +apply и повтор с действиями и затратами. Проверены fresh, used, потеря +метаданных используемого файла, потеря самого объекта, SQL-ошибка после PUT, +обрыв HTTP и недоступность S3. + +## Ограничения + +Один Docker-host, PostgreSQL, HAProxy и SeaweedFS остаются точками отказа. +Это не защита от потери узла. Нет репликации S3 и резервного копирования. +Прямой presigned upload, worker и thumbnail не реализованы: это другой трек +или следующая лабораторная. История сообщений сохраняет keyset пагинацию +по (created_at,id); snapshot между HTTP-запросами не гарантируется. + +Переменные .env.example — логические имена skeleton. Фактическое соответствие: +CACHE_URL_FILE/SESSION_STORE заменены REDIS_URL + PostgreSQL session lookup; +S3_ACCESS_KEY_ID_FILE → S3_ACCESS_KEY_FILE, S3_SECRET_ACCESS_KEY_FILE → +S3_SECRET_KEY_FILE. Endpoint http://s3:8333, bucket messenger, регион us-east-1. +MAX_UPLOAD_BYTES/MAX_IMAGE_PIXELS/IDEMPOTENCY_TTL_SECONDS фиксированы контрактом +в коде: 10485760/40000000/86400. APP_ENV не меняет семантику API. + +Источники: contracts Lab4, официальная документация AWS SDK for .NET, +SeaweedFS S3 Credentials, SkiaSharp. ChatGPT использован при реализации и проверках. diff --git a/compose.yaml b/compose.yaml new file mode 100644 index 00000000..b0a323c1 --- /dev/null +++ b/compose.yaml @@ -0,0 +1,171 @@ +name: mtusi2026lab4 + +x-api: &api + image: messenger-lab4:local + build: . + environment: + APP_HOST: 0.0.0.0 + APP_PORT: 8080 + DATABASE_URL_FILE: /run/secrets/database_url + REDIS_URL: redis:6379 + SESSION_TTL_SECONDS: ${SESSION_TTL_SECONDS:-3600} + DB_POOL_SIZE: ${DB_POOL_SIZE:-20} + S3_ENDPOINT: http://s3:8333 + S3_BUCKET: messenger + S3_ACCESS_KEY_FILE: /run/secrets/s3_access + S3_SECRET_KEY_FILE: /run/secrets/s3_secret + MESSAGE_BATCHING: ${MESSAGE_BATCHING:-true} + Logging__LogLevel__Default: Warning + Logging__LogLevel__Microsoft.Hosting.Lifetime: Information + secrets: + - database_url + - s3_access + - s3_secret + cpus: ${API_CPUS:-1} + mem_limit: ${API_MEMORY:-512m} + stop_grace_period: 10s + healthcheck: + test: ["CMD", "curl", "--fail", "--silent", "--max-time", "1", "http://127.0.0.1:8080/health/ready"] + interval: 2s + timeout: 2s + retries: 5 + start_period: 5s + restart: unless-stopped + depends_on: + s3-bootstrap: + condition: service_completed_successfully + migrate: + condition: service_completed_successfully + redis: + condition: service_healthy + +services: + postgres: + image: postgres:17.6 + environment: + POSTGRES_DB: messenger + POSTGRES_USER: messenger + POSTGRES_PASSWORD_FILE: /run/secrets/postgres_password + secrets: + - postgres_password + volumes: + - postgres_data:/var/lib/postgresql/data + cpus: ${POSTGRES_CPUS:-0.5} + mem_limit: 512m + healthcheck: + test: ["CMD-SHELL", "pg_isready -U messenger -d messenger"] + interval: 2s + timeout: 2s + retries: 30 + restart: unless-stopped + + redis: + image: redis:7.4.2-alpine + command: ["redis-server", "--save", "", "--appendonly", "no", "--maxmemory", "64mb", "--maxmemory-policy", "allkeys-lru"] + cpus: 0.25 + mem_limit: 96m + healthcheck: + test: ["CMD", "redis-cli", "ping"] + interval: 2s + timeout: 2s + retries: 15 + restart: unless-stopped + + migrate: + image: messenger-lab4:local + command: ["--migrate"] + environment: + DATABASE_URL_FILE: /run/secrets/database_url + secrets: + - database_url + cpus: 0.5 + mem_limit: 256m + restart: "no" + healthcheck: + disable: true + depends_on: + postgres: + condition: service_healthy + + s3: + image: chrislusf/seaweedfs:3.97 + command: ["server", "-dir=/data", "-ip=s3", "-master.volumeSizeLimitMB=100", "-volume.max=8", "-filer", "-s3", "-s3.config=/run/secrets/s3_config"] + secrets: + - s3_config + volumes: + - s3_data:/data + cpus: 0.5 + mem_limit: 512m + restart: unless-stopped + healthcheck: + test: ["CMD-SHELL", "wget -S -O /dev/null http://127.0.0.1:8333/ 2>&1 | grep -q '403'"] + interval: 2s + timeout: 2s + retries: 40 + start_period: 35s + + s3-bootstrap: + image: messenger-lab4:local + command: ["--bootstrap"] + environment: + S3_ENDPOINT: http://s3:8333 + S3_ACCESS_KEY_FILE: /run/secrets/s3_admin_access + S3_SECRET_KEY_FILE: /run/secrets/s3_admin_secret + secrets: + - s3_admin_access + - s3_admin_secret + depends_on: + s3: + condition: service_healthy + restart: on-failure + healthcheck: + disable: true + ulimits: + core: 0 + cpus: 0.25 + mem_limit: 128m + + api: + <<: *api + deploy: + replicas: ${API_REPLICAS:-2} + + lb: + image: haproxy:3.2.7-alpine + volumes: + - ./infra/haproxy.cfg:/usr/local/etc/haproxy/haproxy.cfg:ro + ports: + - "127.0.0.1:${API_PORT:-18084}:8080" + cpus: 0.5 + mem_limit: 96m + stop_grace_period: 10s + healthcheck: + test: ["CMD-SHELL", "wget -q -O /dev/null http://127.0.0.1:8080/health/ready"] + interval: 2s + timeout: 2s + retries: 30 + start_period: 5s + restart: unless-stopped + depends_on: + api: + condition: service_healthy + +secrets: + s3_config: + file: ./secrets/s3_config + s3_admin_access: + file: ./secrets/s3_admin_access + s3_admin_secret: + file: ./secrets/s3_admin_secret + s3_access: + file: ./secrets/s3_access + s3_secret: + file: ./secrets/s3_secret + postgres_password: + file: ./secrets/postgres_password + database_url: + file: ./secrets/database_url + +volumes: + s3_data: + postgres_data: diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md new file mode 100644 index 00000000..79065658 --- /dev/null +++ b/docs/ARCHITECTURE.md @@ -0,0 +1,38 @@ +# Переход Lab3 → Lab4 + +Цель: оценка 5, трек 2 «Согласованность двух хранилищ». + +| Критерий | Lab3 | Изменения Lab4 | +| --- | --- | --- | +| Две взаимозаменяемые API | HAProxy, общий PostgreSQL, сессии, Idempotency-Key | Сохранить; файлы доступны обеим API | +| Разделение данных | Сообщения в PostgreSQL | Метаданные Attachment в PostgreSQL, оригиналы в SeaweedFS | +| Загрузка | AttachmentIds отклоняются | Binary PNG/JPEG, до 10 MiB и 40 млн пикселей, 201 после S3 и COMMIT | +| Доступ | Bearer и членство в чате | Те же проверки перед метаданными, байтами и привязкой файла | +| Сообщения | Только текст | До 10 уникальных вложений; текст может быть пустым с вложениями | +| Идемпотентность | Хеш текста | Хеш текста и списка вложений, атомарно с сообщением | +| Проверка файлов | Отсутствует | MIME по содержимому, декодирование, опасные имена, лимиты до выделения памяти | +| Отказы | Отказ API и restart | Дополнить отказом S3, обрывом upload, сбоем COMMIT после PUT | +| Ограничение RAM | Лимиты контейнеров | Поток на временный диск, ограниченный буфер, семафор декодирования, timeout | +| Приватность bucket | Отсутствует | Идемпотентный bootstrap, отдельные credentials API, без внешних S3-портов | +| Согласованность | Одна транзакция PostgreSQL | Компенсация/сверка S3 и PostgreSQL с grace period | +| Исследование на 5 | Масштабирование API | Orphan/missing, dry-run/apply, повтор, защита свежих и используемых файлов, стоимость обхода | + +## Файлы + +- Endpoints/AttachmentEndpoints.cs: HTTP, аутентификация, доступ, валидация. +- Contracts/AttachmentDto.cs: публичные поля без object key. +- Services/AttachmentService.cs: ограниченная загрузка и проверка изображения. +- Infrastructure/S3Storage.cs: чтение и запись SeaweedFS через AWS SDK. +- Data/Attachments.cs и миграция 004: метаданные и связи. +- Services/AttachmentReconciler.cs: сверка двух хранилищ, отдельная CLI-команда. + +## Границы + +PostgreSQL и S3 не имеют общей транзакции. Загрузка держит общую блокировку +обслуживания вложений в PostgreSQL до завершения PUT и COMMIT. При обрыве +процесса после PUT останется orphan. Reconciler получает исключительную +блокировку, перечитывает метаданные и удаляет только старые неиспользуемые +объекты. Свежие файлы защищает grace period, используемые — ссылка сообщения. +Отсутствующий оригинал используемого вложения восстановить без резервной +копии невозможно: сверка фиксирует missing и сохраняет ссылки сообщения. +Один Docker-host, одна БД и один SeaweedFS остаются точками отказа. diff --git a/docs/PR.md b/docs/PR.md new file mode 100644 index 00000000..6472ac7d --- /dev/null +++ b/docs/PR.md @@ -0,0 +1,24 @@ +ЛР 4 - БВТ-2302 - Каменский - на 5 + +Автор / группа: Каменский Никита, БВТ-2302. +Целевая оценка: 5. Трек 2: согласованность двух хранилищ. + +Из Lab3 перенесены собственные API, PostgreSQL, Redis, две API-реплики за HAProxy +и интерфейс. Добавлены приватный S3 bucket SeaweedFS, загрузка и авторизованное +скачивание PNG/JPEG, метаданные и ссылки на вложения в сообщениях. + +Проверены размер, число пикселей, MIME, повреждённые файлы, чужой чат, +10 одновременных загрузок с замерами памяти, restart и переключение API. +Reconciler поддерживает dry-run/apply, grace period и повторный запуск. +Проверены orphan/missing, ошибка БД после PUT, обрыв загрузки и отказ S3; +свежие и используемые файлы сохраняются. + +Чистый запуск: make setup, make up. Проверки: make check, make validate, +make test, make student-test, make research-grade5; persistence/failover по REPORT.md. +Результаты: REPORT.md и evidence/. + +Контракт, публичные tests и README задания сохранены. PostgreSQL, S3, +балансировщик и один Docker-host остаются точками отказа. Утраченные байты +невозможно восстановить без резервной копии; missing отмечается явно. + +ChatGPT использован при реализации и проверках. diff --git a/evidence/attachments.json b/evidence/attachments.json new file mode 100644 index 00000000..0630382b --- /dev/null +++ b/evidence/attachments.json @@ -0,0 +1,68 @@ +{ + "checks": [ + "filename", + "size", + "decoded pixels", + "damaged image", + "MIME mismatch", + "private chat", + "foreign attachment", + "idempotency" + ], + "concurrency": 10, + "file_bytes": 3147775, + "decoded_pixels": 1048576, + "seconds": 1.6615432920007152, + "successful_uploads": 10, + "errors": 0, + "p95_seconds": 1.653438166998967, + "peak_api_cgroup_bytes": [ + 220725248, + 160665600 + ], + "samples": [ + { + "at": 1794257730.2808042, + "bytes": [ + 203374592, + 140251136 + ] + }, + { + "at": 1794257730.521431, + "bytes": [ + 210403328, + 146546688 + ] + }, + { + "at": 1794257730.779288, + "bytes": [ + 218071040, + 150061056 + ] + }, + { + "at": 1794257731.005748, + "bytes": [ + 217665536, + 149602304 + ] + }, + { + "at": 1794257731.277846, + "bytes": [ + 220725248, + 155983872 + ] + }, + { + "at": 1794257731.580511, + "bytes": [ + 217796608, + 160665600 + ] + } + ], + "limits": "512 MiB per API; one decoder/upload per API; 64 KiB copy buffer" +} diff --git a/evidence/consistency.json b/evidence/consistency.json new file mode 100644 index 00000000..b414d7ec --- /dev/null +++ b/evidence/consistency.json @@ -0,0 +1,343 @@ +{ + "scan_samples": [ + { + "mode": "dry-run", + "grace_seconds": 120, + "objects": 11, + "rows": 13, + "s3_requests": 12, + "elapsed_ms": 331.6122, + "peak_process_bytes": 109236224, + "actions": [ + { + "kind": "missing_metadata", + "key": "originals/d96908adeb83441eb7e01b224c82891e", + "action": "preserved_used_original" + }, + { + "kind": "missing", + "id": "2eca82ac-62ef-4e6d-b9fd-cba86685189b", + "action": "would_mark_missing" + }, + { + "kind": "missing", + "id": "8bb8a27c-fdcc-41eb-b5f5-7f18ea19674f", + "action": "would_mark_missing" + }, + { + "kind": "missing", + "id": "bdc4e3a3-7659-4ec1-8b55-60b0f16843c9", + "action": "would_mark_missing" + } + ] + }, + { + "mode": "dry-run", + "grace_seconds": 120, + "objects": 11, + "rows": 13, + "s3_requests": 12, + "elapsed_ms": 891.0122, + "peak_process_bytes": 109002752, + "actions": [ + { + "kind": "missing_metadata", + "key": "originals/d96908adeb83441eb7e01b224c82891e", + "action": "preserved_used_original" + }, + { + "kind": "missing", + "id": "2eca82ac-62ef-4e6d-b9fd-cba86685189b", + "action": "would_mark_missing" + }, + { + "kind": "missing", + "id": "8bb8a27c-fdcc-41eb-b5f5-7f18ea19674f", + "action": "would_mark_missing" + }, + { + "kind": "missing", + "id": "bdc4e3a3-7659-4ec1-8b55-60b0f16843c9", + "action": "would_mark_missing" + } + ] + }, + { + "mode": "dry-run", + "grace_seconds": 120, + "objects": 11, + "rows": 13, + "s3_requests": 12, + "elapsed_ms": 447.3227, + "peak_process_bytes": 108912640, + "actions": [ + { + "kind": "missing_metadata", + "key": "originals/d96908adeb83441eb7e01b224c82891e", + "action": "preserved_used_original" + }, + { + "kind": "missing", + "id": "2eca82ac-62ef-4e6d-b9fd-cba86685189b", + "action": "would_mark_missing" + }, + { + "kind": "missing", + "id": "8bb8a27c-fdcc-41eb-b5f5-7f18ea19674f", + "action": "would_mark_missing" + }, + { + "kind": "missing", + "id": "bdc4e3a3-7659-4ec1-8b55-60b0f16843c9", + "action": "would_mark_missing" + } + ] + } + ], + "checks": [ + "Private bucket and scoped credentials; injected missing S3 object", + "Interrupted upload not published; DB failure after PUT leaves reconcilable orphan; S3 outage recovers", + "dry-run is read-only", + "old orphan and unused data removed", + "referenced missing marked, link retained", + "fresh and referenced originals preserved, including missing metadata", + "repeat is idempotent" + ], + "dry_run": { + "mode": "dry-run", + "grace_seconds": 120, + "objects": 24, + "rows": 24, + "s3_requests": 24, + "elapsed_ms": 357.8247, + "peak_process_bytes": 110813184, + "actions": [ + { + "kind": "missing_metadata", + "key": "originals/d96908adeb83441eb7e01b224c82891e", + "action": "preserved_used_original" + }, + { + "kind": "orphan", + "key": "originals/e3a392e3f738404cba19b468fe352717", + "action": "would_delete" + }, + { + "kind": "orphan", + "key": "originals/ea6da2ae592743b5b73c50d88327c373", + "action": "would_delete" + }, + { + "kind": "unreferenced", + "id": "006bad4a-a53f-428d-ad1d-a7ba2c09d86f", + "action": "would_delete" + }, + { + "kind": "unreferenced", + "id": "02c88001-0bf8-486d-820a-801a78e69ff4", + "action": "would_delete" + }, + { + "kind": "unreferenced", + "id": "10456f24-dbcc-42f6-97d9-b436b758a8f0", + "action": "would_delete" + }, + { + "kind": "unreferenced", + "id": "2b26cc4b-027c-4edc-b9af-812165df6a08", + "action": "would_delete" + }, + { + "kind": "missing", + "id": "2eca82ac-62ef-4e6d-b9fd-cba86685189b", + "action": "would_mark_missing" + }, + { + "kind": "unreferenced", + "id": "6421d396-be20-489b-9887-f27c39572c63", + "action": "would_delete" + }, + { + "kind": "unreferenced", + "id": "71cc04ef-ee0f-4939-a080-d471e7e5c715", + "action": "would_delete" + }, + { + "kind": "unreferenced", + "id": "74975234-bbb8-42a0-99ce-53b0f40a6229", + "action": "would_delete" + }, + { + "kind": "missing", + "id": "8bb8a27c-fdcc-41eb-b5f5-7f18ea19674f", + "action": "would_mark_missing" + }, + { + "kind": "unreferenced", + "id": "9e1834dc-a0b5-45d2-97a7-5c4c3a72178a", + "action": "would_delete" + }, + { + "kind": "unreferenced", + "id": "a2d209c6-6565-4284-ba3b-4e199caf417e", + "action": "would_delete" + }, + { + "kind": "missing", + "id": "bdc4e3a3-7659-4ec1-8b55-60b0f16843c9", + "action": "would_mark_missing" + }, + { + "kind": "unreferenced", + "id": "be5bac60-6b2d-4271-9315-064734e5987b", + "action": "would_delete" + }, + { + "kind": "unreferenced", + "id": "dd176b2b-3e1a-4bd1-a25e-4be60276c2f0", + "action": "would_delete" + }, + { + "kind": "unreferenced", + "id": "ddce32cc-af2a-433e-b103-e833ca6d8945", + "action": "would_delete" + } + ] + }, + "apply": { + "mode": "apply", + "grace_seconds": 120, + "objects": 24, + "rows": 24, + "s3_requests": 38, + "elapsed_ms": 498.8064, + "peak_process_bytes": 110981120, + "actions": [ + { + "kind": "missing_metadata", + "key": "originals/d96908adeb83441eb7e01b224c82891e", + "action": "preserved_used_original" + }, + { + "kind": "orphan", + "key": "originals/e3a392e3f738404cba19b468fe352717", + "action": "deleted" + }, + { + "kind": "orphan", + "key": "originals/ea6da2ae592743b5b73c50d88327c373", + "action": "deleted" + }, + { + "kind": "unreferenced", + "id": "006bad4a-a53f-428d-ad1d-a7ba2c09d86f", + "action": "deleted" + }, + { + "kind": "unreferenced", + "id": "02c88001-0bf8-486d-820a-801a78e69ff4", + "action": "deleted" + }, + { + "kind": "unreferenced", + "id": "10456f24-dbcc-42f6-97d9-b436b758a8f0", + "action": "deleted" + }, + { + "kind": "unreferenced", + "id": "2b26cc4b-027c-4edc-b9af-812165df6a08", + "action": "deleted" + }, + { + "kind": "missing", + "id": "2eca82ac-62ef-4e6d-b9fd-cba86685189b", + "action": "marked_missing" + }, + { + "kind": "unreferenced", + "id": "6421d396-be20-489b-9887-f27c39572c63", + "action": "deleted" + }, + { + "kind": "unreferenced", + "id": "71cc04ef-ee0f-4939-a080-d471e7e5c715", + "action": "deleted" + }, + { + "kind": "unreferenced", + "id": "74975234-bbb8-42a0-99ce-53b0f40a6229", + "action": "deleted" + }, + { + "kind": "missing", + "id": "8bb8a27c-fdcc-41eb-b5f5-7f18ea19674f", + "action": "marked_missing" + }, + { + "kind": "unreferenced", + "id": "9e1834dc-a0b5-45d2-97a7-5c4c3a72178a", + "action": "deleted" + }, + { + "kind": "unreferenced", + "id": "a2d209c6-6565-4284-ba3b-4e199caf417e", + "action": "deleted" + }, + { + "kind": "missing", + "id": "bdc4e3a3-7659-4ec1-8b55-60b0f16843c9", + "action": "marked_missing" + }, + { + "kind": "unreferenced", + "id": "be5bac60-6b2d-4271-9315-064734e5987b", + "action": "deleted" + }, + { + "kind": "unreferenced", + "id": "dd176b2b-3e1a-4bd1-a25e-4be60276c2f0", + "action": "deleted" + }, + { + "kind": "unreferenced", + "id": "ddce32cc-af2a-433e-b103-e833ca6d8945", + "action": "deleted" + } + ] + }, + "repeat": { + "mode": "apply", + "grace_seconds": 120, + "objects": 11, + "rows": 13, + "s3_requests": 12, + "elapsed_ms": 346.2962, + "peak_process_bytes": 108949504, + "actions": [ + { + "kind": "missing_metadata", + "key": "originals/d96908adeb83441eb7e01b224c82891e", + "action": "preserved_used_original" + }, + { + "kind": "missing", + "id": "2eca82ac-62ef-4e6d-b9fd-cba86685189b", + "action": "marked_missing" + }, + { + "kind": "missing", + "id": "8bb8a27c-fdcc-41eb-b5f5-7f18ea19674f", + "action": "marked_missing" + }, + { + "kind": "missing", + "id": "bdc4e3a3-7659-4ec1-8b55-60b0f16843c9", + "action": "marked_missing" + } + ] + }, + "safety_wait_seconds": 111.50906662500347, + "assumption": "exclusive PostgreSQL advisory gate; all app writers use shared gate; 120s minimum grace; no automatic restore without backup", + "source_sha256": "453a3911fc23e5b218fac508073a3d93b6ace5f530a0ddec7619f153d8532d6f", + "environment": "linux aarch64 8 CPUs 4106604544 bytes RAM" +} diff --git a/evidence/failover.txt b/evidence/failover.txt new file mode 100644 index 00000000..2171601b --- /dev/null +++ b/evidence/failover.txt @@ -0,0 +1,52 @@ +.venv/bin/python tests/resilience.py --mode failover --action-script "scripts/stop-one.sh" --base-url "http://localhost:18084" +Executing explicit failover hook; hook output suppressed to avoid leaking secrets. +{"observed_instances_before": 2, "successful_writes": 128, "failed_attempts": 0, "first_recovery_seconds": 1.098} +PASS: failover preserved confirmed data and existing session. Hook scope needs operator evidence. +NAME IMAGE COMMAND SERVICE CREATED STATUS PORTS +mtusi2026lab4-api-1 messenger-lab4:local "dotnet Messenger.Ap…" api 30 seconds ago Up 26 seconds (healthy) 8080/tcp +mtusi2026lab4-lb-1 haproxy:3.2.7-alpine "docker-entrypoint.s…" lb 10 minutes ago Up 30 seconds (healthy) 127.0.0.1:18084->8080/tcp +mtusi2026lab4-postgres-1 postgres:17.6 "docker-entrypoint.s…" postgres 10 minutes ago Up 54 seconds (healthy) 5432/tcp +mtusi2026lab4-redis-1 redis:7.4.2-alpine "docker-entrypoint.s…" redis 10 minutes ago Up 54 seconds (healthy) 6379/tcp +mtusi2026lab4-s3-1 chrislusf/seaweedfs:3.97 "/entrypoint.sh serv…" s3 9 minutes ago Up 51 seconds (healthy) 7333/tcp, 8080/tcp, 8333/tcp, 8888/tcp, 9333/tcp, 18080/tcp, 18888/tcp, 19333/tcp +./scripts/compose.sh up -d --wait api lb + Container mtusi2026lab4-api-1 Running + Container mtusi2026lab4-lb-1 Running + Container mtusi2026lab4-postgres-1 Running + Container mtusi2026lab4-redis-1 Running + Container mtusi2026lab4-s3-1 Running + Container mtusi2026lab4-postgres-1 Waiting + Container mtusi2026lab4-s3-1 Waiting + Container mtusi2026lab4-postgres-1 Healthy + Container mtusi2026lab4-migrate-1 Starting + Container mtusi2026lab4-s3-1 Healthy + Container mtusi2026lab4-s3-bootstrap-1 Starting + Container mtusi2026lab4-migrate-1 Started + Container mtusi2026lab4-s3-bootstrap-1 Started + Container mtusi2026lab4-redis-1 Waiting + Container mtusi2026lab4-s3-bootstrap-1 Waiting + Container mtusi2026lab4-migrate-1 Waiting + Container mtusi2026lab4-migrate-1 Exited + Container mtusi2026lab4-redis-1 Healthy + Container mtusi2026lab4-s3-bootstrap-1 Exited + Container mtusi2026lab4-api-2 Starting + Container mtusi2026lab4-api-2 Started + Container mtusi2026lab4-api-1 Waiting + Container mtusi2026lab4-api-2 Waiting + Container mtusi2026lab4-api-1 Healthy + Container mtusi2026lab4-api-2 Healthy + Container mtusi2026lab4-s3-bootstrap-1 Waiting + Container mtusi2026lab4-api-1 Waiting + Container mtusi2026lab4-api-2 Waiting + Container mtusi2026lab4-lb-1 Waiting + Container mtusi2026lab4-postgres-1 Waiting + Container mtusi2026lab4-redis-1 Waiting + Container mtusi2026lab4-migrate-1 Waiting + Container mtusi2026lab4-s3-1 Waiting + Container mtusi2026lab4-s3-1 Healthy + Container mtusi2026lab4-postgres-1 Healthy + Container mtusi2026lab4-redis-1 Healthy + Container mtusi2026lab4-migrate-1 Exited + Container mtusi2026lab4-lb-1 Healthy + Container mtusi2026lab4-s3-bootstrap-1 Exited + Container mtusi2026lab4-api-1 Healthy + Container mtusi2026lab4-api-2 Healthy diff --git a/evidence/image-ui-api.txt b/evidence/image-ui-api.txt new file mode 100644 index 00000000..0f0e3314 --- /dev/null +++ b/evidence/image-ui-api.txt @@ -0,0 +1,2 @@ +.venv/bin/python tests/smoke.py --base-url "http://localhost:18084" +PASS: lab4 public API scenario; infrastructure and grading evidence remain separate. diff --git a/evidence/image-ui.json b/evidence/image-ui.json new file mode 100644 index 00000000..82ef2802 --- /dev/null +++ b/evidence/image-ui.json @@ -0,0 +1,20 @@ +{ + "checks": [ + "automatic inline PNG/JPEG previews", + "filename and size", + "full-screen viewer", + "arrow-key gallery navigation", + "zoom toggle", + "Escape closes and restores focus", + "original filename and byte-identical download", + "draft thumbnail and attachment-only send", + "desktop 1280x720 without page overflow", + "mobile 319px fit and zoom" + ], + "download_sha256": "88585921771cc8ab0afac847728ab899c418c92d8d5ee2cdfeeda8b84a3c61de", + "screenshots": [ + "ui-image-previews.jpg", + "ui-image-viewer-desktop.jpg", + "ui-image-viewer-mobile.jpg" + ] +} diff --git a/evidence/persistence.txt b/evidence/persistence.txt new file mode 100644 index 00000000..f5f6aaaf --- /dev/null +++ b/evidence/persistence.txt @@ -0,0 +1,17 @@ +NAME IMAGE COMMAND SERVICE CREATED STATUS PORTS +mtusi2026lab4-api-1 sha256:549dc2226f2146641dea8a7c5931a905ae1a14df4075934bdba21d34bb7ed499 "dotnet Messenger.Ap…" api About a minute ago Up About a minute (healthy) 8080/tcp +mtusi2026lab4-api-2 sha256:549dc2226f2146641dea8a7c5931a905ae1a14df4075934bdba21d34bb7ed499 "dotnet Messenger.Ap…" api About a minute ago Up About a minute (healthy) 8080/tcp +mtusi2026lab4-lb-1 haproxy:3.2.7-alpine "docker-entrypoint.s…" lb 9 minutes ago Up 7 minutes (healthy) 127.0.0.1:18084->8080/tcp +mtusi2026lab4-postgres-1 postgres:17.6 "docker-entrypoint.s…" postgres 9 minutes ago Up 9 minutes (healthy) 5432/tcp +mtusi2026lab4-redis-1 redis:7.4.2-alpine "docker-entrypoint.s…" redis 9 minutes ago Up 9 minutes (healthy) 6379/tcp +mtusi2026lab4-s3-1 chrislusf/seaweedfs:3.97 "/entrypoint.sh serv…" s3 8 minutes ago Up 2 minutes (healthy) 7333/tcp, 8080/tcp, 8333/tcp, 8888/tcp, 9333/tcp, 18080/tcp, 18888/tcp, 19333/tcp +.venv/bin/python tests/resilience.py --mode persistence --action-script "scripts/restart.sh" --base-url "http://localhost:18084" +Executing explicit persistence hook; hook output suppressed to avoid leaking secrets. +PASS: persistence preserved confirmed data and existing session. Hook scope needs operator evidence. +NAME IMAGE COMMAND SERVICE CREATED STATUS PORTS +mtusi2026lab4-api-1 messenger-lab4:local "dotnet Messenger.Ap…" api 9 seconds ago Up 5 seconds (healthy) 8080/tcp +mtusi2026lab4-api-2 messenger-lab4:local "dotnet Messenger.Ap…" api 9 seconds ago Up 5 seconds (healthy) 8080/tcp +mtusi2026lab4-lb-1 haproxy:3.2.7-alpine "docker-entrypoint.s…" lb 10 minutes ago Up 9 seconds (healthy) 127.0.0.1:18084->8080/tcp +mtusi2026lab4-postgres-1 postgres:17.6 "docker-entrypoint.s…" postgres 10 minutes ago Up 33 seconds (healthy) 5432/tcp +mtusi2026lab4-redis-1 redis:7.4.2-alpine "docker-entrypoint.s…" redis 10 minutes ago Up 33 seconds (healthy) 6379/tcp +mtusi2026lab4-s3-1 chrislusf/seaweedfs:3.97 "/entrypoint.sh serv…" s3 8 minutes ago Up 30 seconds (healthy) 7333/tcp, 8080/tcp, 8333/tcp, 8888/tcp, 9333/tcp, 18080/tcp, 18888/tcp, 19333/tcp diff --git a/evidence/ui-image-previews.jpg b/evidence/ui-image-previews.jpg new file mode 100644 index 0000000000000000000000000000000000000000..da78fdf11b132c54f29ffc84e8efeb8c0834627c GIT binary patch literal 54339 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

+Hw_J%Xl3#YcHXz7C8NVsJHgLXmj(nD~vVu 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 E0EmV9*8l(j literal 0 HcmV?d00001 diff --git a/evidence/ui-image-viewer-desktop.jpg b/evidence/ui-image-viewer-desktop.jpg new file mode 100644 index 0000000000000000000000000000000000000000..4884a4c6291b4add74c911511d04cb8a73663d9a GIT binary patch literal 14164 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 N%K!f?aP^Gxe*qsWEt&uT literal 0 HcmV?d00001 diff --git a/evidence/verification.txt b/evidence/verification.txt new file mode 100644 index 00000000..198bdced --- /dev/null +++ b/evidence/verification.txt @@ -0,0 +1,8 @@ +.venv/bin/python tests/smoke.py --base-url "http://localhost:18084" +PASS: lab4 public API scenario; infrastructure and grading evidence remain separate. +.venv/bin/python student-tests/attachments.py --base-url "http://localhost:18084" +PASS: attachment validation, access, replay and 10 parallel uploads +.venv/bin/python student-tests/attachments.py --base-url "http://localhost:18084" +PASS: attachment validation, access, replay and 10 parallel uploads +.venv/bin/python tests/smoke.py --base-url "http://localhost:18084" +PASS: lab4 public API scenario; infrastructure and grading evidence remain separate. diff --git a/infra/haproxy.cfg b/infra/haproxy.cfg new file mode 100644 index 00000000..752b0535 --- /dev/null +++ b/infra/haproxy.cfg @@ -0,0 +1,40 @@ +global + maxconn 2000 + stats socket ipv4@127.0.0.1:9999 level admin + hard-stop-after 8s + +defaults + mode http + timeout connect 500ms + timeout check 500ms + timeout client 15s + timeout server 12s + timeout http-request 5s + timeout http-keep-alive 5s + timeout queue 2s + retries 1 + +resolvers docker + nameserver dns 127.0.0.11:53 + accepted_payload_size 8192 + resolve_retries 2 + timeout resolve 500ms + timeout retry 500ms + hold valid 1s + hold nx 1s + hold other 1s + hold refused 1s + hold timeout 1s + hold obsolete 0s + +frontend public + bind :8080 + default_backend messenger + +backend messenger + balance roundrobin + option httpchk + http-check send meth GET uri /health/ready ver HTTP/1.1 hdr Host localhost + http-check expect status 200 + default-server check inter 500ms fastinter 250ms downinter 500ms fall 2 rise 2 + server-template api 1-8 api:8080 resolvers docker resolve-prefer ipv4 init-addr none diff --git a/scripts/compose.sh b/scripts/compose.sh new file mode 100755 index 00000000..26472c9c --- /dev/null +++ b/scripts/compose.sh @@ -0,0 +1,4 @@ +#!/bin/sh +set -eu +root="$(CDPATH= cd -- "$(dirname "$0")/.." && pwd)" +exec docker compose --project-name mtusi2026lab4 --project-directory "$root" "$@" diff --git a/scripts/init-secrets.py b/scripts/init-secrets.py new file mode 100644 index 00000000..e96ea437 --- /dev/null +++ b/scripts/init-secrets.py @@ -0,0 +1,19 @@ +#!/usr/bin/env python3 +from pathlib import Path +import secrets,json,os +os.umask(0o077) +p=Path(__file__).resolve().parents[1]/'secrets';p.mkdir(exist_ok=True) +def secret(name,size=24): + f=p/name + if not f.exists(): f.write_text(secrets.token_hex(size)) + return f.read_text().strip() +pw=secret('postgres_password') +f=p/'database_url' +if not f.exists(): f.write_text('Host=postgres;Port=5432;Database=messenger;Username=messenger;Password='+pw) +admin=secret('s3_admin_access',12); admin_secret=secret('s3_admin_secret') +access=secret('s3_access',12); key=secret('s3_secret') +config={'identities':[ + {'name':'bootstrap','credentials':[{'accessKey':admin,'secretKey':admin_secret}],'actions':['Admin','Read','Write','List','Tagging']}, + {'name':'messenger','credentials':[{'accessKey':access,'secretKey':key}],'actions':['Read:messenger','Write:messenger','List:messenger']}]} +(p/'s3_config').write_text(json.dumps(config)) +print('Local secrets ready') diff --git a/scripts/init-secrets.sh b/scripts/init-secrets.sh new file mode 100755 index 00000000..063eb4ac --- /dev/null +++ b/scripts/init-secrets.sh @@ -0,0 +1,3 @@ +#!/bin/sh +set -eu +exec python3 "$(dirname "$0")/init-secrets.py" diff --git a/scripts/restart.sh b/scripts/restart.sh new file mode 100755 index 00000000..d5d6510a --- /dev/null +++ b/scripts/restart.sh @@ -0,0 +1,7 @@ +#!/bin/sh +set -eu +cd "$(dirname "$0")/.." +./scripts/compose.sh restart postgres redis s3 +./scripts/compose.sh up -d --wait --wait-timeout 60 postgres redis s3 +./scripts/compose.sh restart api lb +./scripts/compose.sh up -d --wait --wait-timeout 60 api lb diff --git a/scripts/stop-one.sh b/scripts/stop-one.sh new file mode 100755 index 00000000..2a7bee58 --- /dev/null +++ b/scripts/stop-one.sh @@ -0,0 +1,13 @@ +#!/bin/sh +set -eu +cd "$(dirname "$0")/.." +test -n "${TARGET_INSTANCE_ID:-}" || { echo "TARGET_INSTANCE_ID is required" >&2; exit 1; } +for id in $(./scripts/compose.sh ps -q api); do + instance="$(docker exec "$id" curl -fsS -D - -o /dev/null http://127.0.0.1:8080/health/live | tr -d '\r' | awk 'tolower($1) == "x-instance-id:" { print $2 }')" + if [ "$instance" = "$TARGET_INSTANCE_ID" ]; then + docker stop --time 8 "$id" >/dev/null + exit 0 + fi +done +echo "Requested API instance was not found" >&2 +exit 1 diff --git a/src/Messenger.Api/Contracts/AttachmentDto.cs b/src/Messenger.Api/Contracts/AttachmentDto.cs new file mode 100644 index 00000000..ca40a661 --- /dev/null +++ b/src/Messenger.Api/Contracts/AttachmentDto.cs @@ -0,0 +1,4 @@ +namespace Messenger.Api.Contracts; +public sealed record AttachmentDto(Guid Id, Guid ChatId, Guid OwnerId, string Filename, + string ContentType, long SizeBytes, string Sha256, string Status, object[] Variants, + string? ErrorCode, string CreatedAt, string UpdatedAt); diff --git a/src/Messenger.Api/Contracts/ChatCursor.cs b/src/Messenger.Api/Contracts/ChatCursor.cs new file mode 100644 index 00000000..f8a7fb06 --- /dev/null +++ b/src/Messenger.Api/Contracts/ChatCursor.cs @@ -0,0 +1,7 @@ +namespace Messenger.Api.Contracts; + +public sealed record ChatCursor( + string Scope, + string CreatedAt, + Guid Id +); diff --git a/src/Messenger.Api/Contracts/ChatDto.cs b/src/Messenger.Api/Contracts/ChatDto.cs new file mode 100644 index 00000000..67a757a1 --- /dev/null +++ b/src/Messenger.Api/Contracts/ChatDto.cs @@ -0,0 +1,3 @@ +namespace Messenger.Api.Contracts; + +public sealed record ChatDto(Guid Id, string Title, List MemberIds, string CreatedAt); diff --git a/src/Messenger.Api/Contracts/ChatPreviewDto.cs b/src/Messenger.Api/Contracts/ChatPreviewDto.cs new file mode 100644 index 00000000..4dded210 --- /dev/null +++ b/src/Messenger.Api/Contracts/ChatPreviewDto.cs @@ -0,0 +1,4 @@ +namespace Messenger.Api.Contracts; + +public sealed record ChatPreviewDto( + Guid Id, string Title, List MemberIds, string CreatedAt, MessageDto? LastMessage); diff --git a/src/Messenger.Api/Contracts/CreateChatRequest.cs b/src/Messenger.Api/Contracts/CreateChatRequest.cs new file mode 100644 index 00000000..cd55763b --- /dev/null +++ b/src/Messenger.Api/Contracts/CreateChatRequest.cs @@ -0,0 +1,6 @@ +namespace Messenger.Api.Contracts; + +public sealed record CreateChatRequest( + string? Title, + List? MemberIds +); diff --git a/src/Messenger.Api/Contracts/CreateMessageRequest.cs b/src/Messenger.Api/Contracts/CreateMessageRequest.cs new file mode 100644 index 00000000..2d7136a8 --- /dev/null +++ b/src/Messenger.Api/Contracts/CreateMessageRequest.cs @@ -0,0 +1,8 @@ +using System.Text.Json; + +namespace Messenger.Api.Contracts; + +public sealed record CreateMessageRequest( + string? Text, + JsonElement AttachmentIds = default +); diff --git a/src/Messenger.Api/Contracts/CreateUserRequest.cs b/src/Messenger.Api/Contracts/CreateUserRequest.cs new file mode 100644 index 00000000..cd60371d --- /dev/null +++ b/src/Messenger.Api/Contracts/CreateUserRequest.cs @@ -0,0 +1,7 @@ +namespace Messenger.Api.Contracts; + +public sealed record CreateUserRequest( + string? Username, + string? DisplayName, + string? Password +); diff --git a/src/Messenger.Api/Contracts/MessageDto.cs b/src/Messenger.Api/Contracts/MessageDto.cs new file mode 100644 index 00000000..b45c9398 --- /dev/null +++ b/src/Messenger.Api/Contracts/MessageDto.cs @@ -0,0 +1,3 @@ +namespace Messenger.Api.Contracts; + +public sealed record MessageDto(Guid Id, Guid ChatId, Guid SenderId, string Text, string CreatedAt, Guid[] AttachmentIds); diff --git a/src/Messenger.Api/Contracts/SessionDto.cs b/src/Messenger.Api/Contracts/SessionDto.cs new file mode 100644 index 00000000..8e0177f0 --- /dev/null +++ b/src/Messenger.Api/Contracts/SessionDto.cs @@ -0,0 +1,3 @@ +namespace Messenger.Api.Contracts; + +public sealed record SessionDto(string Token, string TokenType, string ExpiresAt, UserDto User); diff --git a/src/Messenger.Api/Contracts/UserDto.cs b/src/Messenger.Api/Contracts/UserDto.cs new file mode 100644 index 00000000..d3ebc3c0 --- /dev/null +++ b/src/Messenger.Api/Contracts/UserDto.cs @@ -0,0 +1,3 @@ +namespace Messenger.Api.Contracts; + +public sealed record UserDto(Guid Id, string Username, string DisplayName, string CreatedAt); diff --git a/src/Messenger.Api/Data/AppDatabase.cs b/src/Messenger.Api/Data/AppDatabase.cs new file mode 100644 index 00000000..ce29d472 --- /dev/null +++ b/src/Messenger.Api/Data/AppDatabase.cs @@ -0,0 +1,206 @@ +using Messenger.Api.Data.Entities; +using System.Net.Sockets; +using Npgsql; + +namespace Messenger.Api.Data; + +public sealed partial class AppDatabase(NpgsqlDataSource dataSource, IConfiguration configuration) +{ + public async Task IsReadyAsync() + { + try + { + await using var command = dataSource.CreateCommand("SELECT 1"); + return (int)(await command.ExecuteScalarAsync())! == 1; + } + catch (Exception exception) when (exception is NpgsqlException or SocketException or TimeoutException) + { + return false; + } + } + + public async Task FindUserByUsernameAsync(string username) + { + await using var command = dataSource.CreateCommand( + "SELECT id, username, display_name, password_hash, created_at FROM users WHERE username = @username"); + command.Parameters.AddWithValue("username", username); + await using var reader = await command.ExecuteReaderAsync(); + return await reader.ReadAsync() ? ReadUser(reader) : null; + } + + public async Task FindUserByIdAsync(Guid id) + { + await using var command = dataSource.CreateCommand( + "SELECT id, username, display_name, password_hash, created_at FROM users WHERE id = @id"); + command.Parameters.AddWithValue("id", id); + await using var reader = await command.ExecuteReaderAsync(); + return await reader.ReadAsync() ? ReadUser(reader) : null; + } + + public async Task> ListChatUsersAsync(Guid chatId) + { + await using var command = dataSource.CreateCommand(""" + SELECT u.id, u.username, u.display_name, u.password_hash, u.created_at + FROM users u JOIN chat_members m ON m.user_id = u.id + WHERE m.chat_id = @chat_id ORDER BY u.display_name, u.id + """); + command.Parameters.AddWithValue("chat_id", chatId); + await using var reader = await command.ExecuteReaderAsync(); + var result = new List(); + while (await reader.ReadAsync()) result.Add(ReadUser(reader)); + return result; + } + + public async Task CreateUserAsync(string username, string displayName, string passwordHash) + { + var user = new UserEntity(Guid.NewGuid(), username, displayName, passwordHash, UtcClock.Now()); + await using var command = dataSource.CreateCommand( + "INSERT INTO users(id, username, display_name, password_hash, created_at) VALUES (@id, @username, @display_name, @password_hash, @created_at)"); + command.Parameters.AddWithValue("id", user.Id); + command.Parameters.AddWithValue("username", user.Username); + command.Parameters.AddWithValue("display_name", user.DisplayName); + command.Parameters.AddWithValue("password_hash", user.PasswordHash); + command.Parameters.AddWithValue("created_at", user.CreatedAt); + await command.ExecuteNonQueryAsync(); + return user; + } + + public async Task CreateSessionAsync(byte[] tokenHash, Guid userId, DateTime expiresAt) + { + await using var command = dataSource.CreateCommand( + "INSERT INTO sessions(token_hash, user_id, expires_at, created_at) VALUES (@token_hash, @user_id, @expires_at, @created_at)"); + command.Parameters.AddWithValue("token_hash", tokenHash); + command.Parameters.AddWithValue("user_id", userId); + command.Parameters.AddWithValue("expires_at", expiresAt); + command.Parameters.AddWithValue("created_at", UtcClock.Now()); + await command.ExecuteNonQueryAsync(); + } + + public async Task FindActiveSessionAsync(byte[] tokenHash) + { + await using var command = dataSource.CreateCommand(""" + SELECT user_id, expires_at FROM sessions + WHERE token_hash = @token_hash AND revoked_at IS NULL AND expires_at > now() + """); + command.Parameters.AddWithValue("token_hash", tokenHash); + await using var reader = await command.ExecuteReaderAsync(); + return await reader.ReadAsync() ? new SessionEntity(reader.GetGuid(0), reader.GetDateTime(1)) : null; + } + + public async Task RevokeSessionAsync(byte[] tokenHash) + { + await using var command = dataSource.CreateCommand(""" + UPDATE sessions SET revoked_at = now() + WHERE token_hash = @token_hash AND revoked_at IS NULL AND expires_at > now() + """); + command.Parameters.AddWithValue("token_hash", tokenHash); + return await command.ExecuteNonQueryAsync() == 1; + } + + public async Task CreateChatAsync(string title, List memberIds) + { + await using var connection = await dataSource.OpenConnectionAsync(); + await using var transaction = await connection.BeginTransactionAsync(); + + await using (var membersCommand = new NpgsqlCommand( + "SELECT count(*) FROM users WHERE id = ANY(@member_ids)", connection, transaction)) + { + membersCommand.Parameters.AddWithValue("member_ids", memberIds.ToArray()); + if ((long)(await membersCommand.ExecuteScalarAsync())! != memberIds.Count) + { + await transaction.RollbackAsync(); + return null; + } + } + + var chat = new ChatEntity(Guid.NewGuid(), title, memberIds, UtcClock.Now()); + await using (var chatCommand = new NpgsqlCommand( + "INSERT INTO chats(id, title, created_at) VALUES (@id, @title, @created_at)", connection, transaction)) + { + chatCommand.Parameters.AddWithValue("id", chat.Id); + chatCommand.Parameters.AddWithValue("title", chat.Title); + chatCommand.Parameters.AddWithValue("created_at", chat.CreatedAt); + await chatCommand.ExecuteNonQueryAsync(); + } + + await using (var membershipCommand = new NpgsqlCommand( + "INSERT INTO chat_members(chat_id, user_id) SELECT @chat_id, unnest(CAST(@member_ids AS uuid[]))", connection, transaction)) + { + membershipCommand.Parameters.AddWithValue("chat_id", chat.Id); + membershipCommand.Parameters.AddWithValue("member_ids", memberIds.ToArray()); + await membershipCommand.ExecuteNonQueryAsync(); + } + + await transaction.CommitAsync(); + return chat; + } + + public async Task FindChatForMemberAsync(Guid chatId, Guid userId) + { + await using var command = dataSource.CreateCommand(""" + SELECT c.id, c.title, c.created_at, + ARRAY(SELECT m.user_id FROM chat_members m WHERE m.chat_id = c.id ORDER BY m.user_id) + FROM chats c + WHERE c.id = @chat_id AND EXISTS ( + SELECT 1 FROM chat_members m WHERE m.chat_id = c.id AND m.user_id = @user_id) + """); + command.Parameters.AddWithValue("chat_id", chatId); + command.Parameters.AddWithValue("user_id", userId); + await using var reader = await command.ExecuteReaderAsync(); + return await reader.ReadAsync() ? ReadChat(reader) : null; + } + + public async Task> ListChatsAsync(Guid userId, DateTime? cursorTime, Guid? cursorId, int count) + { + var sql = """ + SELECT c.id, c.title, c.created_at, + ARRAY(SELECT m2.user_id FROM chat_members m2 WHERE m2.chat_id = c.id ORDER BY m2.user_id) + FROM chats c JOIN chat_members m ON m.chat_id = c.id + WHERE m.user_id = @user_id + """; + if (cursorTime is not null) + sql += " AND (c.created_at, c.id) > (@cursor_time, @cursor_id)"; + sql += " ORDER BY c.created_at, c.id LIMIT @count"; + + await using var command = dataSource.CreateCommand(sql); + command.Parameters.AddWithValue("user_id", userId); + if (cursorTime is not null) + { + command.Parameters.AddWithValue("cursor_time", cursorTime.Value); + command.Parameters.AddWithValue("cursor_id", cursorId!.Value); + } + command.Parameters.AddWithValue("count", count); + await using var reader = await command.ExecuteReaderAsync(); + var result = new List(); + while (await reader.ReadAsync()) result.Add(ReadChat(reader)); + return result; + } + + public async Task> ListMessagesAsync(Guid chatId, DateTime? cursorTime, Guid? cursorId, int count, bool newestFirst = false) + { + var sql = "SELECT id, chat_id, sender_id, text, created_at, attachment_ids FROM messages WHERE chat_id = @chat_id"; + if (cursorTime is not null) + sql += newestFirst ? " AND (created_at, id) < (@cursor_time, @cursor_id)" : " AND (created_at, id) > (@cursor_time, @cursor_id)"; + sql += newestFirst ? " ORDER BY created_at DESC, id DESC LIMIT @count" : " ORDER BY created_at, id LIMIT @count"; + + await using var command = dataSource.CreateCommand(sql); + command.Parameters.AddWithValue("chat_id", chatId); + if (cursorTime is not null) + { + command.Parameters.AddWithValue("cursor_time", cursorTime.Value); + command.Parameters.AddWithValue("cursor_id", cursorId!.Value); + } + command.Parameters.AddWithValue("count", count); + await using var reader = await command.ExecuteReaderAsync(); + var result = new List(); + while (await reader.ReadAsync()) result.Add(new MessageEntity( + reader.GetGuid(0), reader.GetGuid(1), reader.GetGuid(2), reader.GetString(3), reader.GetDateTime(4), reader.GetFieldValue(5))); + return result; + } + + private static UserEntity ReadUser(NpgsqlDataReader reader) => new( + reader.GetGuid(0), reader.GetString(1), reader.GetString(2), reader.GetString(3), reader.GetDateTime(4)); + + private static ChatEntity ReadChat(NpgsqlDataReader reader) => new( + reader.GetGuid(0), reader.GetString(1), reader.GetFieldValue(3).ToList(), reader.GetDateTime(2)); +} diff --git a/src/Messenger.Api/Data/Attachments.cs b/src/Messenger.Api/Data/Attachments.cs new file mode 100644 index 00000000..c1968457 --- /dev/null +++ b/src/Messenger.Api/Data/Attachments.cs @@ -0,0 +1,22 @@ +using Messenger.Api.Contracts; +using Npgsql; +namespace Messenger.Api.Data; +public sealed partial class AppDatabase +{ + public const long AttachmentGate = 48260104; + public async Task<(AttachmentDto Dto, string Key)?> FindAttachmentAsync(Guid id, Guid actor) + { + await using var cmd = dataSource.CreateCommand(""" + SELECT a.id,a.chat_id,a.owner_id,a.filename,a.content_type,a.size_bytes,a.sha256, + a.status,a.created_at,a.updated_at,a.object_key + FROM attachments a JOIN chat_members m ON m.chat_id=a.chat_id + WHERE a.id=@id AND m.user_id=@actor + """); + cmd.Parameters.AddWithValue("id",id); cmd.Parameters.AddWithValue("actor",actor); + await using var r=await cmd.ExecuteReaderAsync(); + return await r.ReadAsync() ? (ReadAttachment(r),r.GetString(10)) : null; + } + public static AttachmentDto ReadAttachment(NpgsqlDataReader r) => new(r.GetGuid(0),r.GetGuid(1), + r.GetGuid(2),r.GetString(3),r.GetString(4),r.GetInt64(5),r.GetString(6),r.GetString(7), + [],null,r.GetDateTime(8).ToString("O"),r.GetDateTime(9).ToString("O")); +} diff --git a/src/Messenger.Api/Data/ChatPreviews.cs b/src/Messenger.Api/Data/ChatPreviews.cs new file mode 100644 index 00000000..40d63209 --- /dev/null +++ b/src/Messenger.Api/Data/ChatPreviews.cs @@ -0,0 +1,51 @@ +using Messenger.Api.Contracts; +using Npgsql; + +namespace Messenger.Api.Data; + +public sealed partial class AppDatabase +{ + public async Task> ListChatPreviewsAsync(Guid userId, DateTime? cursorTime, Guid? cursorId, int count) + { + var query = """ + WITH page AS ( + SELECT c.id, c.title, c.created_at, + ARRAY(SELECT m.user_id FROM chat_members m WHERE m.chat_id = c.id ORDER BY m.user_id) AS member_ids + FROM chats c JOIN chat_members membership ON membership.chat_id = c.id + WHERE membership.user_id = @user_id + """; + if (cursorTime is not null) query += " AND (c.created_at, c.id) > (@cursor_time, @cursor_id)"; + query += """ + ORDER BY c.created_at, c.id LIMIT @count + ) + SELECT p.id, p.title, p.created_at, p.member_ids, + latest.id, latest.sender_id, latest.text, latest.created_at, latest.attachment_ids + FROM page p + LEFT JOIN LATERAL ( + SELECT id, sender_id, text, created_at, attachment_ids + FROM messages WHERE chat_id = p.id + ORDER BY created_at DESC, id DESC LIMIT 1 + ) latest ON true + ORDER BY p.created_at, p.id + """; + await using var command = dataSource.CreateCommand(query); + command.Parameters.AddWithValue("user_id", userId); + command.Parameters.AddWithValue("count", count); + if (cursorTime is not null) + { + command.Parameters.AddWithValue("cursor_time", cursorTime.Value); + command.Parameters.AddWithValue("cursor_id", cursorId!.Value); + } + await using var reader = await command.ExecuteReaderAsync(); + var result = new List(); + while (await reader.ReadAsync()) + { + var id = reader.GetGuid(0); + var message = reader.IsDBNull(4) ? null : new MessageDto(reader.GetGuid(4), id, + reader.GetGuid(5), reader.GetString(6), reader.GetDateTime(7).ToString("O"), reader.GetFieldValue(8)); + result.Add(new ChatPreviewDto(id, reader.GetString(1), reader.GetFieldValue(3).ToList(), + reader.GetDateTime(2).ToString("O"), message)); + } + return result; + } +} diff --git a/src/Messenger.Api/Data/DatabaseMigrator.cs b/src/Messenger.Api/Data/DatabaseMigrator.cs new file mode 100644 index 00000000..91cb8068 --- /dev/null +++ b/src/Messenger.Api/Data/DatabaseMigrator.cs @@ -0,0 +1,40 @@ +using Npgsql; + +namespace Messenger.Api.Data; + +public static class DatabaseMigrator +{ + public static async Task ApplyAsync(NpgsqlDataSource dataSource) + { + await using var connection = await dataSource.OpenConnectionAsync(); + await using var transaction = await connection.BeginTransactionAsync(); + await using (var command = new NpgsqlCommand("SELECT pg_advisory_xact_lock(202602)", connection, transaction)) + await command.ExecuteNonQueryAsync(); + await using (var command = new NpgsqlCommand( + "CREATE TABLE IF NOT EXISTS schema_migrations (version integer PRIMARY KEY, applied_at timestamptz NOT NULL)", + connection, transaction)) + await command.ExecuteNonQueryAsync(); + + var assembly = typeof(DatabaseMigrator).Assembly; + var migrations = assembly.GetManifestResourceNames() + .Where(name => name.Contains(".Data.Migrations.", StringComparison.Ordinal) && name.EndsWith(".sql", StringComparison.Ordinal)) + .Order(StringComparer.Ordinal); + foreach (var name in migrations) + { + var version = int.Parse(name.Split('.')[^2].Split('_')[0]); + await using var check = new NpgsqlCommand("SELECT EXISTS (SELECT 1 FROM schema_migrations WHERE version = @version)", connection, transaction); + check.Parameters.AddWithValue("version", version); + if ((bool)(await check.ExecuteScalarAsync())!) continue; + + await using var stream = assembly.GetManifestResourceStream(name)!; + using var reader = new StreamReader(stream); + await using (var migration = new NpgsqlCommand(await reader.ReadToEndAsync(), connection, transaction)) + await migration.ExecuteNonQueryAsync(); + await using var record = new NpgsqlCommand( + "INSERT INTO schema_migrations(version, applied_at) VALUES (@version, now())", connection, transaction); + record.Parameters.AddWithValue("version", version); + await record.ExecuteNonQueryAsync(); + } + await transaction.CommitAsync(); + } +} diff --git a/src/Messenger.Api/Data/Entities/ChatEntity.cs b/src/Messenger.Api/Data/Entities/ChatEntity.cs new file mode 100644 index 00000000..9daea081 --- /dev/null +++ b/src/Messenger.Api/Data/Entities/ChatEntity.cs @@ -0,0 +1,6 @@ +namespace Messenger.Api.Data.Entities; + +public sealed record ChatEntity(Guid Id, string Title, List MemberIds, DateTime CreatedAt) +{ + public Contracts.ChatDto ToDto() => new(Id, Title, MemberIds, CreatedAt.ToString("O")); +} diff --git a/src/Messenger.Api/Data/Entities/MessageEntity.cs b/src/Messenger.Api/Data/Entities/MessageEntity.cs new file mode 100644 index 00000000..cd4614a8 --- /dev/null +++ b/src/Messenger.Api/Data/Entities/MessageEntity.cs @@ -0,0 +1,6 @@ +namespace Messenger.Api.Data.Entities; + +public sealed record MessageEntity(Guid Id, Guid ChatId, Guid SenderId, string Text, DateTime CreatedAt, Guid[]? AttachmentIds = null) +{ + public Contracts.MessageDto ToDto() => new(Id, ChatId, SenderId, Text, CreatedAt.ToString("O"), AttachmentIds ?? []); +} diff --git a/src/Messenger.Api/Data/Entities/SessionEntity.cs b/src/Messenger.Api/Data/Entities/SessionEntity.cs new file mode 100644 index 00000000..ddb29de1 --- /dev/null +++ b/src/Messenger.Api/Data/Entities/SessionEntity.cs @@ -0,0 +1,3 @@ +namespace Messenger.Api.Data.Entities; + +public sealed record SessionEntity(Guid UserId, DateTime ExpiresAt); diff --git a/src/Messenger.Api/Data/Entities/UserEntity.cs b/src/Messenger.Api/Data/Entities/UserEntity.cs new file mode 100644 index 00000000..9389ce4c --- /dev/null +++ b/src/Messenger.Api/Data/Entities/UserEntity.cs @@ -0,0 +1,6 @@ +namespace Messenger.Api.Data.Entities; + +public sealed record UserEntity(Guid Id, string Username, string DisplayName, string PasswordHash, DateTime CreatedAt) +{ + public Contracts.UserDto ToDto() => new(Id, Username, DisplayName, CreatedAt.ToString("O")); +} diff --git a/src/Messenger.Api/Data/MessageRequests.cs b/src/Messenger.Api/Data/MessageRequests.cs new file mode 100644 index 00000000..4b6a26f4 --- /dev/null +++ b/src/Messenger.Api/Data/MessageRequests.cs @@ -0,0 +1,91 @@ +using System.Security.Cryptography; +using System.Text; +using Messenger.Api.Data.Entities; +using Npgsql; + +namespace Messenger.Api.Data; + +public sealed partial class AppDatabase +{ + private bool BatchCommands => !string.Equals(configuration["MESSAGE_BATCHING"], "false", StringComparison.OrdinalIgnoreCase); + + public async Task CreateMessageOnceAsync(Guid chatId, Guid senderId, string text, string key, Guid[] attachmentIds) + { + var hash = SHA256.HashData(System.Text.Json.JsonSerializer.SerializeToUtf8Bytes(new { text, attachment_ids = attachmentIds })); + await using var connection = await dataSource.OpenConnectionAsync(); + await using var transaction = await connection.BeginTransactionAsync(); + + await using (var gate = new NpgsqlCommand($"SELECT pg_advisory_xact_lock_shared({AttachmentGate})",connection,transaction)) + await gate.ExecuteNonQueryAsync(); + if (attachmentIds.Length>0) + { + await using var attachments = new NpgsqlCommand("SELECT id,status FROM attachments WHERE chat_id=@chat AND id=ANY(@ids)",connection,transaction); + attachments.Parameters.AddWithValue("chat",chatId); attachments.Parameters.AddWithValue("ids",attachmentIds); + await using var found = await attachments.ExecuteReaderAsync(); + var count=0; var ready=true; + while(await found.ReadAsync()) { count++; ready &= found.GetString(1)=="ready"; } + if(count!=attachmentIds.Length) throw new Services.AttachmentException(404,"not_found","Вложение не найдено"); + if(!ready) throw new Services.AttachmentException(409,"conflict","Вложение недоступно"); + } + // A transaction-scoped lock coordinates the same request across all API processes. + if (!BatchCommands) + await using (var gate = new NpgsqlCommand("SELECT pg_advisory_xact_lock(hashtextextended(@scope, 0))", connection, transaction)) + { + gate.Parameters.AddWithValue("scope", $"{senderId}:POST:/api/v1/chats/{chatId}/messages:{key}"); + await gate.ExecuteNonQueryAsync(); + } + await using (var previous = new NpgsqlCommand((BatchCommands ? "SELECT pg_advisory_xact_lock(hashtextextended(@scope, 0));" : "") + """ + SELECT r.request_hash, m.id, m.chat_id, m.sender_id, m.text, m.created_at, m.attachment_ids + FROM message_requests r JOIN messages m ON m.id = r.message_id + WHERE r.user_id = @user_id AND r.chat_id = @chat_id AND r.request_key = @key + AND r.expires_at > clock_timestamp() + """, connection, transaction)) + { + previous.Parameters.AddWithValue("scope", $"{senderId}:POST:/api/v1/chats/{chatId}/messages:{key}"); + previous.Parameters.AddWithValue("user_id", senderId); + previous.Parameters.AddWithValue("chat_id", chatId); + previous.Parameters.AddWithValue("key", key); + await using var reader = await previous.ExecuteReaderAsync(); + if (BatchCommands) await reader.NextResultAsync(); + if (await reader.ReadAsync()) + { + var same = reader.GetFieldValue(0).AsSpan().SequenceEqual(hash); + var result = same ? new MessageEntity(reader.GetGuid(1), reader.GetGuid(2), reader.GetGuid(3), reader.GetString(4), reader.GetDateTime(5), reader.GetFieldValue(6)) : null; + await reader.DisposeAsync(); + await transaction.CommitAsync(); + return result; + } + } + if (!BatchCommands) + await using (var cleanup = new NpgsqlCommand(""" + DELETE FROM message_requests + WHERE user_id = @user_id AND chat_id = @chat_id AND request_key = @key + """, connection, transaction)) + { + cleanup.Parameters.AddWithValue("user_id", senderId); + cleanup.Parameters.AddWithValue("chat_id", chatId); + cleanup.Parameters.AddWithValue("key", key); + await cleanup.ExecuteNonQueryAsync(); + } + var message = new MessageEntity(Guid.NewGuid(), chatId, senderId, text, UtcClock.Now(), attachmentIds); + await using (var insert = new NpgsqlCommand((BatchCommands ? "DELETE FROM message_requests WHERE user_id = @sender_id AND chat_id = @chat_id AND request_key = @key;" : "") + """ + INSERT INTO messages(id, chat_id, sender_id, text, created_at, attachment_ids) + VALUES (@id, @chat_id, @sender_id, @text, @created_at, @attachments); + INSERT INTO message_requests(user_id, chat_id, request_key, request_hash, message_id, expires_at) + VALUES (@sender_id, @chat_id, @key, @hash, @id, clock_timestamp() + interval '24 hours'); + """, connection, transaction)) + { + insert.Parameters.AddWithValue("attachments", attachmentIds); + insert.Parameters.AddWithValue("id", message.Id); + insert.Parameters.AddWithValue("chat_id", chatId); + insert.Parameters.AddWithValue("sender_id", senderId); + insert.Parameters.AddWithValue("text", text); + insert.Parameters.AddWithValue("created_at", message.CreatedAt); + insert.Parameters.AddWithValue("key", key); + insert.Parameters.AddWithValue("hash", hash); + await insert.ExecuteNonQueryAsync(); + } + await transaction.CommitAsync(); + return message; + } +} diff --git a/src/Messenger.Api/Data/Migrations/001_initial.sql b/src/Messenger.Api/Data/Migrations/001_initial.sql new file mode 100644 index 00000000..2cf544fc --- /dev/null +++ b/src/Messenger.Api/Data/Migrations/001_initial.sql @@ -0,0 +1,43 @@ +CREATE TABLE users ( + id uuid PRIMARY KEY, + username text NOT NULL UNIQUE CHECK (username ~ '^[a-z0-9_]{3,32}$'), + display_name text NOT NULL, + password_hash text NOT NULL, + created_at timestamptz NOT NULL +); + +CREATE TABLE chats ( + id uuid PRIMARY KEY, + title text NOT NULL, + created_at timestamptz NOT NULL +); + +CREATE TABLE chat_members ( + chat_id uuid NOT NULL REFERENCES chats(id), + user_id uuid NOT NULL REFERENCES users(id), + PRIMARY KEY (chat_id, user_id) +); + +CREATE INDEX chat_members_user_chat_idx ON chat_members (user_id, chat_id); +CREATE INDEX chats_created_id_idx ON chats (created_at, id); + +CREATE TABLE messages ( + id uuid PRIMARY KEY, + chat_id uuid NOT NULL REFERENCES chats(id), + sender_id uuid NOT NULL REFERENCES users(id), + text text NOT NULL, + created_at timestamptz NOT NULL +); + +CREATE INDEX messages_chat_created_id_idx ON messages (chat_id, created_at, id); + +CREATE TABLE sessions ( + token_hash bytea PRIMARY KEY, + user_id uuid NOT NULL REFERENCES users(id), + expires_at timestamptz NOT NULL, + revoked_at timestamptz, + created_at timestamptz NOT NULL +); + +CREATE INDEX sessions_user_id_idx ON sessions (user_id); +CREATE INDEX sessions_expires_at_idx ON sessions (expires_at); diff --git a/src/Messenger.Api/Data/Migrations/002_idempotency.sql b/src/Messenger.Api/Data/Migrations/002_idempotency.sql new file mode 100644 index 00000000..9ec17406 --- /dev/null +++ b/src/Messenger.Api/Data/Migrations/002_idempotency.sql @@ -0,0 +1,11 @@ +CREATE TABLE message_requests ( + user_id uuid NOT NULL REFERENCES users(id), + chat_id uuid NOT NULL REFERENCES chats(id), + request_key text NOT NULL, + request_hash bytea NOT NULL, + message_id uuid NOT NULL REFERENCES messages(id), + expires_at timestamptz NOT NULL, + PRIMARY KEY (user_id, chat_id, request_key) +); + +CREATE INDEX message_requests_expires_idx ON message_requests (expires_at); diff --git a/src/Messenger.Api/Data/Migrations/003_reactions.sql b/src/Messenger.Api/Data/Migrations/003_reactions.sql new file mode 100644 index 00000000..c4b1e44b --- /dev/null +++ b/src/Messenger.Api/Data/Migrations/003_reactions.sql @@ -0,0 +1,6 @@ +CREATE TABLE message_reactions ( + message_id uuid NOT NULL REFERENCES messages(id) ON DELETE CASCADE, + user_id uuid NOT NULL REFERENCES users(id) ON DELETE CASCADE, + reaction text NOT NULL CHECK (reaction IN ('like', 'love', 'laugh', 'mushroom')), + PRIMARY KEY (message_id, user_id, reaction) +); diff --git a/src/Messenger.Api/Data/Migrations/004_attachments.sql b/src/Messenger.Api/Data/Migrations/004_attachments.sql new file mode 100644 index 00000000..ec837482 --- /dev/null +++ b/src/Messenger.Api/Data/Migrations/004_attachments.sql @@ -0,0 +1,11 @@ +CREATE TABLE attachments ( + id uuid PRIMARY KEY, chat_id uuid NOT NULL REFERENCES chats(id), + owner_id uuid NOT NULL REFERENCES users(id), filename text NOT NULL, + content_type text NOT NULL, size_bytes bigint NOT NULL CHECK (size_bytes BETWEEN 1 AND 10485760), + sha256 text NOT NULL, object_key text NOT NULL UNIQUE, + status text NOT NULL CHECK (status IN ('ready','missing')), + created_at timestamptz NOT NULL, updated_at timestamptz NOT NULL +); +CREATE INDEX attachments_created_idx ON attachments(created_at, id); +ALTER TABLE messages ADD COLUMN attachment_ids uuid[] NOT NULL DEFAULT '{}'; +CREATE INDEX messages_attachments_idx ON messages USING gin(attachment_ids); diff --git a/src/Messenger.Api/Data/Reactions.cs b/src/Messenger.Api/Data/Reactions.cs new file mode 100644 index 00000000..7d40ffce --- /dev/null +++ b/src/Messenger.Api/Data/Reactions.cs @@ -0,0 +1,48 @@ +using Npgsql; + +namespace Messenger.Api.Data; + +public sealed record ReactionDto(Guid MessageId, string Reaction, int Count, bool Mine); + +public sealed partial class AppDatabase +{ + public async Task SetReactionAsync(Guid chatId, Guid messageId, Guid userId, string reaction, bool present) + { + await using var command = dataSource.CreateCommand(present ? """ + WITH target AS (SELECT id FROM messages WHERE id = @message_id AND chat_id = @chat_id), + written AS ( + INSERT INTO message_reactions(message_id, user_id, reaction) + SELECT id, @user_id, @reaction FROM target ON CONFLICT DO NOTHING + ) SELECT EXISTS(SELECT 1 FROM target) + """ : """ + WITH target AS (SELECT id FROM messages WHERE id = @message_id AND chat_id = @chat_id), + removed AS ( + DELETE FROM message_reactions WHERE message_id IN (SELECT id FROM target) + AND user_id = @user_id AND reaction = @reaction + ) SELECT EXISTS(SELECT 1 FROM target) + """); + command.Parameters.AddWithValue("chat_id", chatId); + command.Parameters.AddWithValue("message_id", messageId); + command.Parameters.AddWithValue("user_id", userId); + command.Parameters.AddWithValue("reaction", reaction); + return (bool)(await command.ExecuteScalarAsync())!; + } + + public async Task> ListReactionsAsync(Guid chatId, Guid[] messageIds, Guid userId) + { + await using var command = dataSource.CreateCommand(""" + SELECT r.message_id, r.reaction, count(*)::integer, bool_or(r.user_id = @user_id) + FROM message_reactions r JOIN messages m ON m.id = r.message_id + WHERE m.chat_id = @chat_id AND m.id = ANY(@message_ids) + GROUP BY r.message_id, r.reaction ORDER BY r.message_id, r.reaction + """); + command.Parameters.AddWithValue("chat_id", chatId); + command.Parameters.AddWithValue("message_ids", messageIds); + command.Parameters.AddWithValue("user_id", userId); + await using var reader = await command.ExecuteReaderAsync(); + var items = new List(); + while (await reader.ReadAsync()) + items.Add(new(reader.GetGuid(0), reader.GetString(1), reader.GetInt32(2), reader.GetBoolean(3))); + return items; + } +} diff --git a/src/Messenger.Api/Data/UtcClock.cs b/src/Messenger.Api/Data/UtcClock.cs new file mode 100644 index 00000000..30f9fbf7 --- /dev/null +++ b/src/Messenger.Api/Data/UtcClock.cs @@ -0,0 +1,11 @@ +namespace Messenger.Api.Data; + +public static class UtcClock +{ + // PostgreSQL timestamptz stores microseconds; keep the response identical to the saved value. + public static DateTime Now() + { + var ticks = DateTime.UtcNow.Ticks; + return new DateTime(ticks - ticks % 10, DateTimeKind.Utc); + } +} diff --git a/src/Messenger.Api/Endpoints/AttachmentEndpoints.cs b/src/Messenger.Api/Endpoints/AttachmentEndpoints.cs new file mode 100644 index 00000000..550d44e1 --- /dev/null +++ b/src/Messenger.Api/Endpoints/AttachmentEndpoints.cs @@ -0,0 +1,51 @@ +using Messenger.Api.Data; +using Messenger.Api.Infrastructure; +using Messenger.Api.Services; +using Amazon.S3; +using Amazon.S3.Model; +using static Messenger.Api.Services.ApiSupport; +namespace Messenger.Api.Endpoints; +public static class AttachmentEndpoints +{ + public static IEndpointRouteBuilder MapAttachmentEndpoints(this IEndpointRouteBuilder app) + { + app.MapPost("/api/v1/chats/{chat_id}/attachments",async(string chat_id,HttpContext ctx, + SessionService sessions,ChatService chats,AttachmentService files)=> { + var(actor,_)=await sessions.AuthenticateAsync(ctx); if(actor is null) return Unauthorized(ctx); + if(!Guid.TryParse(chat_id,out var chat)) return ApiError(ctx,400,"invalid_request","Некорректный chat_id"); + if(await chats.FindForMemberAsync(chat,actor.Id) is null) return ApiError(ctx,404,"not_found","Чат не найден"); + var names=ctx.Request.Query["filename"]; var name=names.ToString(); + if(names.Count!=1 || string.IsNullOrWhiteSpace(name) || name.EnumerateRunes().Count()>255 || name.Any(c=>char.IsControl(c)||c is '/' or '\\')) + return ApiError(ctx,400,"invalid_request","Некорректное имя файла"); + if(ctx.Request.ContentType?.Split(';')[0].Trim() is not "image/png" and not "image/jpeg") + return ApiError(ctx,415,"unsupported_media_type","Требуется PNG или JPEG"); + return Results.Json(await files.UploadAsync(ctx.Request,chat,actor.Id,name),statusCode:201); + }); + app.MapGet("/api/v1/attachments/{attachment_id}",async(string attachment_id,HttpContext ctx, + SessionService sessions,AppDatabase db)=> { + var(actor,_)=await sessions.AuthenticateAsync(ctx); if(actor is null) return Unauthorized(ctx); + if(!Guid.TryParse(attachment_id,out var id)) return ApiError(ctx,400,"invalid_request","Некорректный ID"); + var file=await db.FindAttachmentAsync(id,actor.Id); + if(file is null) return ApiError(ctx,404,"not_found","Вложение не найдено"); + return file.Value.Dto.Status=="ready" ? Results.Ok(file.Value.Dto) : ApiError(ctx,409,"conflict","Оригинал недоступен"); + }); + app.MapGet("/api/v1/attachments/{attachment_id}/content",async(string attachment_id,HttpContext ctx, + SessionService sessions,AppDatabase db,S3Storage storage)=> { + var(actor,_)=await sessions.AuthenticateAsync(ctx); if(actor is null) return Unauthorized(ctx); + if(!Guid.TryParse(attachment_id,out var id)) return ApiError(ctx,400,"invalid_request","Некорректный ID"); + var file=await db.FindAttachmentAsync(id,actor.Id); + if(file is null) return ApiError(ctx,404,"not_found","Вложение не найдено"); + if(file.Value.Dto.Status!="ready") return ApiError(ctx,409,"conflict","Оригинал недоступен"); + if(ctx.Request.Query.TryGetValue("variant",out var variant) && variant!="original") + return ApiError(ctx,404,"not_found","Вариант не найден"); + try { + var original=await storage.Client.GetObjectAsync(storage.Bucket,file.Value.Key,ctx.RequestAborted); + return Results.Stream(async stream=> {using(original) {await original.ResponseStream.CopyToAsync(stream,ctx.RequestAborted);}}, + file.Value.Dto.ContentType,file.Value.Dto.Filename); + } catch(AmazonS3Exception ex) when(ex.StatusCode==System.Net.HttpStatusCode.NotFound) { + return ApiError(ctx,503,"unavailable","Оригинал временно недоступен"); + } + }); + return app; + } +} diff --git a/src/Messenger.Api/Endpoints/AuthEndpoints.cs b/src/Messenger.Api/Endpoints/AuthEndpoints.cs new file mode 100644 index 00000000..ebc792eb --- /dev/null +++ b/src/Messenger.Api/Endpoints/AuthEndpoints.cs @@ -0,0 +1,60 @@ +using System.Text; +using System.Text.RegularExpressions; +using Messenger.Api.Services; +using static Messenger.Api.Services.ApiSupport; + +namespace Messenger.Api.Endpoints; + +public static class AuthEndpoints +{ + private static readonly UTF8Encoding StrictUtf8 = new(false, true); + + public static IEndpointRouteBuilder MapAuthEndpoints(this IEndpointRouteBuilder app) + { + app.MapPost("/api/v1/auth/sessions", async (HttpContext context, SessionService sessions) => + { + if (!context.Request.Headers.TryGetValue("Authorization", out var header)) + return Unauthorized(context, basic: true); + + var authorization = header.ToString(); + if (!authorization.StartsWith("Basic ", StringComparison.OrdinalIgnoreCase)) + return Unauthorized(context, basic: true); + + string credentials; + try + { + credentials = StrictUtf8.GetString(Convert.FromBase64String(authorization[6..])); + } + catch (Exception exception) when (exception is FormatException or DecoderFallbackException) + { + return Unauthorized(context, basic: true); + } + + var delimiter = credentials.IndexOf(':'); + if (delimiter < 0) return Unauthorized(context, basic: true); + var username = credentials[..delimiter]; + var password = credentials[(delimiter + 1)..]; + if (!Regex.IsMatch(username, "\\A[a-z0-9_]{3,32}\\z")) + return Unauthorized(context, basic: true); + + if (context.Request.ContentLength > 0 || context.Request.Headers.ContainsKey("Transfer-Encoding")) + return ApiError(context, 400, "invalid_request", "Вход принимает Basic без тела запроса"); + + var session = await sessions.LoginAsync(username, password); + return session is null + ? Unauthorized(context, basic: true) + : Results.Json(session, statusCode: StatusCodes.Status201Created); + }); + + app.MapDelete("/api/v1/auth/sessions/current", async (HttpContext context, SessionService sessions) => + { + var (user, tokenHash) = await sessions.AuthenticateAsync(context); + if (user is null || tokenHash is null) return Unauthorized(context); + return await sessions.RevokeAsync(tokenHash) + ? Results.NoContent() + : Unauthorized(context); + }); + + return app; + } +} diff --git a/src/Messenger.Api/Endpoints/ChatEndpoints.cs b/src/Messenger.Api/Endpoints/ChatEndpoints.cs new file mode 100644 index 00000000..127feb04 --- /dev/null +++ b/src/Messenger.Api/Endpoints/ChatEndpoints.cs @@ -0,0 +1,67 @@ +using Messenger.Api.Contracts; +using Messenger.Api.Services; +using static Messenger.Api.Services.ApiSupport; + +namespace Messenger.Api.Endpoints; + +public static class ChatEndpoints +{ + public static IEndpointRouteBuilder MapChatEndpoints(this IEndpointRouteBuilder app) + { + app.MapPost("/api/v1/chats", async (HttpContext context, SessionService sessions, ChatService chats) => + { + var (actor, _) = await sessions.AuthenticateAsync(context); + if (actor is null) return Unauthorized(context); + + var (request, error) = await ReadJsonAsync(context); + if (error is not null) return error; + if (string.IsNullOrWhiteSpace(request!.Title) || request.Title.EnumerateRunes().Count() > 100) + return ApiError(context, 400, "invalid_request", "Некорректное название чата"); + if (request.MemberIds is null || request.MemberIds.Count is < 1 or > 100 || + request.MemberIds.Distinct().Count() != request.MemberIds.Count || + !request.MemberIds.Contains(actor.Id)) + return ApiError(context, 400, "invalid_request", "Некорректный список участников"); + + var chat = await chats.CreateAsync(request.Title, request.MemberIds); + return chat is null + ? ApiError(context, 400, "invalid_request", "Один из участников не существует") + : Results.Json(chat, statusCode: StatusCodes.Status201Created); + }); + + app.MapGet("/api/v1/chats", async (HttpContext context, SessionService sessions, ChatService chats) => + { + var (actor, _) = await sessions.AuthenticateAsync(context); + if (actor is null) return Unauthorized(context); + var (limit, limitError) = ParseLimit(context); + if (limitError is not null) return limitError; + var (cursor, cursorTime, cursorError) = ParseCursor(context, $"user:{actor.Id}"); + if (cursorError is not null) return cursorError; + + var page = await chats.ListAsync(actor.Id, cursorTime, cursor?.Id, limit + 1); + string? nextCursor = null; + if (page.Count > limit) + { + var last = page[limit - 1]; + nextCursor = CursorService.EncodeChatCursor(new ChatCursor($"user:{actor.Id}", last.CreatedAt, last.Id)); + page = page.Take(limit).ToList(); + } + return Results.Ok(new { items = page, next_cursor = nextCursor }); + }); + + app.MapGet("/api/v1/chats/{chat_id}", async ( + string chat_id, HttpContext context, SessionService sessions, ChatService chats) => + { + var (actor, _) = await sessions.AuthenticateAsync(context); + if (actor is null) return Unauthorized(context); + if (!Guid.TryParse(chat_id, out var chatId)) + return ApiError(context, 400, "invalid_request", "Некорректный chat_id"); + + var chat = await chats.FindForMemberAsync(chatId, actor.Id); + return chat is null + ? ApiError(context, 404, "not_found", "Чат не найден") + : Results.Ok(chat); + }); + + return app; + } +} diff --git a/src/Messenger.Api/Endpoints/HealthEndpoints.cs b/src/Messenger.Api/Endpoints/HealthEndpoints.cs new file mode 100644 index 00000000..da8f4eb0 --- /dev/null +++ b/src/Messenger.Api/Endpoints/HealthEndpoints.cs @@ -0,0 +1,18 @@ +using Messenger.Api.Data; +using Messenger.Api.Services; +using Messenger.Api.Infrastructure; + +namespace Messenger.Api.Endpoints; + +public static class HealthEndpoints +{ + public static IEndpointRouteBuilder MapHealthEndpoints(this IEndpointRouteBuilder app) + { + app.MapGet("/health/live", () => Results.Ok(new { status = "ok" })); + app.MapGet("/health/ready", async (HttpContext context, AppDatabase database, ReadinessState readiness, S3Storage storage) => + !readiness.IsStopping && await database.IsReadyAsync() && await storage.ReadyAsync() + ? Results.Ok(new { status = "ok" }) + : ApiSupport.ApiError(context, 503, "unavailable", "Хранилище недоступно")); + return app; + } +} diff --git a/src/Messenger.Api/Endpoints/MessageEndpoints.cs b/src/Messenger.Api/Endpoints/MessageEndpoints.cs new file mode 100644 index 00000000..db0b9985 --- /dev/null +++ b/src/Messenger.Api/Endpoints/MessageEndpoints.cs @@ -0,0 +1,80 @@ +using Messenger.Api.Contracts; +using Messenger.Api.Services; +using System.Text.Json; +using static Messenger.Api.Services.ApiSupport; + +namespace Messenger.Api.Endpoints; + +public static class MessageEndpoints +{ + public static IEndpointRouteBuilder MapMessageEndpoints(this IEndpointRouteBuilder app) + { + app.MapPost("/api/v1/chats/{chat_id}/messages", async ( + string chat_id, HttpContext context, SessionService sessions, ChatService chats, MessageService messages) => + { + var (actor, _) = await sessions.AuthenticateAsync(context); + if (actor is null) return Unauthorized(context); + if (!Guid.TryParse(chat_id, out var chatId)) + return ApiError(context, 400, "invalid_request", "Некорректный chat_id"); + if (await chats.FindForMemberAsync(chatId, actor.Id) is null) + return ApiError(context, 404, "not_found", "Чат не найден"); + + var keys = context.Request.Headers["Idempotency-Key"]; + var key = keys.ToString(); + if (keys.Count != 1 || key.Length is < 1 or > 128 || + key.Any(c => !char.IsAsciiLetterOrDigit(c) && c is not '.' and not '_' and not ':' and not '-')) + return ApiError(context, 400, "invalid_request", "Требуется корректный Idempotency-Key"); + + var (request, error) = await ReadJsonAsync(context); + if (error is not null) return error; + if (request!.Text is null || request.Text.EnumerateRunes().Count() > 4000) + return ApiError(context, 400, "invalid_request", "Некорректный текст сообщения"); + var ids = new List(); + if (request.AttachmentIds.ValueKind != JsonValueKind.Undefined) + { + if (request.AttachmentIds.ValueKind != JsonValueKind.Array || request.AttachmentIds.GetArrayLength()>10) + return ApiError(context,400,"invalid_request","Некорректный список вложений"); + foreach(var item in request.AttachmentIds.EnumerateArray()) + { + if(item.ValueKind!=JsonValueKind.String || !item.TryGetGuid(out var id) || ids.Contains(id)) + return ApiError(context,400,"invalid_request","Некорректный ID вложения"); + ids.Add(id); + } + } + if(string.IsNullOrWhiteSpace(request.Text) && ids.Count==0) + return ApiError(context,400,"invalid_request","Нужен текст или вложение"); + + var message = await messages.CreateAsync(chatId, actor.Id, request.Text, key, ids.ToArray()); + if (message is null) + return ApiError(context, 409, "conflict", "Этот ключ уже использован для другого сообщения"); + return Results.Json(message, statusCode: StatusCodes.Status201Created); + }); + + app.MapGet("/api/v1/chats/{chat_id}/messages", async ( + string chat_id, HttpContext context, SessionService sessions, ChatService chats, MessageService messages) => + { + var (actor, _) = await sessions.AuthenticateAsync(context); + if (actor is null) return Unauthorized(context); + if (!Guid.TryParse(chat_id, out var chatId)) + return ApiError(context, 400, "invalid_request", "Некорректный chat_id"); + if (await chats.FindForMemberAsync(chatId, actor.Id) is null) + return ApiError(context, 404, "not_found", "Чат не найден"); + var (limit, limitError) = ParseLimit(context); + if (limitError is not null) return limitError; + var (cursor, cursorTime, cursorError) = ParseCursor(context, $"chat:{chatId}"); + if (cursorError is not null) return cursorError; + + var page = await messages.ListAsync(chatId, cursorTime, cursor?.Id, limit + 1); + string? nextCursor = null; + if (page.Count > limit) + { + var last = page[limit - 1]; + nextCursor = CursorService.EncodeChatCursor(new ChatCursor($"chat:{chatId}", last.CreatedAt, last.Id)); + page = page.Take(limit).ToList(); + } + return Results.Ok(new { items = page, next_cursor = nextCursor }); + }); + + return app; + } +} diff --git a/src/Messenger.Api/Endpoints/ReactionEndpoints.cs b/src/Messenger.Api/Endpoints/ReactionEndpoints.cs new file mode 100644 index 00000000..5459a1a4 --- /dev/null +++ b/src/Messenger.Api/Endpoints/ReactionEndpoints.cs @@ -0,0 +1,39 @@ +using Messenger.Api.Data; +using Messenger.Api.Services; +using static Messenger.Api.Services.ApiSupport; + +namespace Messenger.Api.Endpoints; + +public static class ReactionEndpoints +{ + public static IEndpointRouteBuilder MapReactionEndpoints(this IEndpointRouteBuilder app) + { + app.MapGet("/api/ui/chats/{chat_id}/reactions", async ( + string chat_id, HttpContext context, SessionService sessions, ChatService chats, AppDatabase database) => + { + var (actor, _) = await sessions.AuthenticateAsync(context); + if (actor is null) return Unauthorized(context); + if (!Guid.TryParse(chat_id, out var chatId)) return ApiError(context, 400, "invalid_request", "Некорректный chat_id"); + if (await chats.FindForMemberAsync(chatId, actor.Id) is null) return ApiError(context, 404, "not_found", "Чат не найден"); + var values = context.Request.Query["message_ids"].ToString().Split(','); + if (values.Length is < 1 or > 100 || values.Any(value => !Guid.TryParse(value, out _))) + return ApiError(context, 400, "invalid_request", "Укажите от 1 до 100 ID сообщений"); + var ids = values.Select(Guid.Parse).Distinct().ToArray(); + return Results.Ok(new { items = await database.ListReactionsAsync(chatId, ids, actor.Id) }); + }); + app.MapMethods("/api/ui/chats/{chat_id}/messages/{message_id}/reactions/{reaction}", ["PUT", "DELETE"], async ( + string chat_id, string message_id, string reaction, HttpContext context, + SessionService sessions, ChatService chats, AppDatabase database) => + { + var (actor, _) = await sessions.AuthenticateAsync(context); + if (actor is null) return Unauthorized(context); + if (!Guid.TryParse(chat_id, out var chatId) || !Guid.TryParse(message_id, out var messageId) + || reaction is not ("like" or "love" or "laugh" or "mushroom")) + return ApiError(context, 400, "invalid_request", "Некорректная реакция или ID"); + if (await chats.FindForMemberAsync(chatId, actor.Id) is null) return ApiError(context, 404, "not_found", "Чат не найден"); + return await database.SetReactionAsync(chatId, messageId, actor.Id, reaction, context.Request.Method == "PUT") + ? Results.NoContent() : ApiError(context, 404, "not_found", "Сообщение не найдено"); + }); + return app; + } +} diff --git a/src/Messenger.Api/Endpoints/UiEndpoints.cs b/src/Messenger.Api/Endpoints/UiEndpoints.cs new file mode 100644 index 00000000..752d7fe0 --- /dev/null +++ b/src/Messenger.Api/Endpoints/UiEndpoints.cs @@ -0,0 +1,80 @@ +using Messenger.Api.Contracts; +using Messenger.Api.Services; +using Messenger.Api.Data; +using Messenger.Api.Infrastructure; +using static Messenger.Api.Services.ApiSupport; + +namespace Messenger.Api.Endpoints; + +public static class UiEndpoints +{ + // The required /api/v1 history stays ascending. The web client has a separate, + // optional route to open a large chat at its newest page and page backwards. + public static IEndpointRouteBuilder MapUiEndpoints(this IEndpointRouteBuilder app) + { + app.MapGet("/api/ui/cluster", async (HttpContext context, SessionService sessions, ClusterPresence presence) => + { + var (actor, _) = await sessions.AuthenticateAsync(context); + if (actor is null) return Unauthorized(context); + context.Response.Headers.CacheControl = "no-store"; + return Results.Ok(await presence.ReadAsync()); + }); + + app.MapGet("/api/ui/chats", async (HttpContext context, SessionService sessions, AppDatabase database) => + { + var (actor, _) = await sessions.AuthenticateAsync(context); + if (actor is null) return Unauthorized(context); + var (limit, limitError) = ParseLimit(context); + if (limitError is not null) return limitError; + var (cursor, cursorTime, cursorError) = ParseCursor(context, $"ui-chats:{actor.Id}"); + if (cursorError is not null) return cursorError; + var page = await database.ListChatPreviewsAsync(actor.Id, cursorTime, cursor?.Id, limit + 1); + string? nextCursor = null; + if (page.Count > limit) + { + var last = page[limit - 1]; + nextCursor = CursorService.EncodeChatCursor(new ChatCursor($"ui-chats:{actor.Id}", last.CreatedAt, last.Id)); + page = page.Take(limit).ToList(); + } + return Results.Ok(new { items = page, next_cursor = nextCursor }); + }); + + app.MapGet("/api/ui/chats/{chat_id}/members", async ( + string chat_id, HttpContext context, SessionService sessions, ChatService chats, UserService users) => + { + var (actor, _) = await sessions.AuthenticateAsync(context); + if (actor is null) return Unauthorized(context); + if (!Guid.TryParse(chat_id, out var chatId)) + return ApiError(context, 400, "invalid_request", "Некорректный chat_id"); + if (await chats.FindForMemberAsync(chatId, actor.Id) is null) + return ApiError(context, 404, "not_found", "Чат не найден"); + return Results.Ok(new { items = await users.ListForChatAsync(chatId) }); + }); + + app.MapGet("/api/ui/chats/{chat_id}/messages", async ( + string chat_id, HttpContext context, SessionService sessions, ChatService chats, MessageService messages) => + { + var (actor, _) = await sessions.AuthenticateAsync(context); + if (actor is null) return Unauthorized(context); + if (!Guid.TryParse(chat_id, out var chatId)) + return ApiError(context, 400, "invalid_request", "Некорректный chat_id"); + if (await chats.FindForMemberAsync(chatId, actor.Id) is null) + return ApiError(context, 404, "not_found", "Чат не найден"); + var (limit, limitError) = ParseLimit(context); + if (limitError is not null) return limitError; + var (cursor, cursorTime, cursorError) = ParseCursor(context, $"recent-chat:{chatId}"); + if (cursorError is not null) return cursorError; + + var page = await messages.ListAsync(chatId, cursorTime, cursor?.Id, limit + 1, newestFirst: true); + string? nextCursor = null; + if (page.Count > limit) + { + var last = page[limit - 1]; + nextCursor = CursorService.EncodeChatCursor(new ChatCursor($"recent-chat:{chatId}", last.CreatedAt, last.Id)); + page = page.Take(limit).ToList(); + } + return Results.Ok(new { items = page, next_cursor = nextCursor }); + }); + return app; + } +} diff --git a/src/Messenger.Api/Endpoints/UserEndpoints.cs b/src/Messenger.Api/Endpoints/UserEndpoints.cs new file mode 100644 index 00000000..a6725b19 --- /dev/null +++ b/src/Messenger.Api/Endpoints/UserEndpoints.cs @@ -0,0 +1,40 @@ +using System.Text.RegularExpressions; +using Messenger.Api.Contracts; +using Messenger.Api.Services; +using static Messenger.Api.Services.ApiSupport; + +namespace Messenger.Api.Endpoints; + +public static class UserEndpoints +{ + public static IEndpointRouteBuilder MapUserEndpoints(this IEndpointRouteBuilder app) + { + app.MapPost("/api/v1/users", async (HttpContext context, UserService users) => + { + var (request, error) = await ReadJsonAsync(context); + if (error is not null) return error; + + if (request!.Username is null || !Regex.IsMatch(request.Username, "\\A[a-z0-9_]{3,32}\\z")) + return ApiError(context, 400, "invalid_request", "Некорректный username"); + if (string.IsNullOrWhiteSpace(request.DisplayName) || + request.DisplayName.EnumerateRunes().Count() is < 1 or > 100) + return ApiError(context, 400, "invalid_request", "Некорректный display_name"); + if (string.IsNullOrWhiteSpace(request.Password) || + request.Password.EnumerateRunes().Count() is < 12 or > 128) + return ApiError(context, 400, "invalid_request", "Пароль должен содержать 12-128 символов"); + + var user = await users.RegisterAsync(request.Username, request.DisplayName, request.Password); + return user is null + ? ApiError(context, 409, "conflict", "Username уже занят") + : Results.Json(user, statusCode: StatusCodes.Status201Created); + }); + + app.MapGet("/api/v1/users/me", async (HttpContext context, SessionService sessions) => + { + var (user, _) = await sessions.AuthenticateAsync(context); + return user is null ? Unauthorized(context) : Results.Ok(user); + }); + + return app; + } +} diff --git a/src/Messenger.Api/Infrastructure/ClusterPresence.cs b/src/Messenger.Api/Infrastructure/ClusterPresence.cs new file mode 100644 index 00000000..adccb65b --- /dev/null +++ b/src/Messenger.Api/Infrastructure/ClusterPresence.cs @@ -0,0 +1,55 @@ +using Messenger.Api.Data; +using StackExchange.Redis; + +namespace Messenger.Api.Infrastructure; + +// Registry entries live ten minutes; an eight-second heartbeat gap means unavailable. +// A Redis outage is reported as unknown, never as proof that an API has stopped. +public sealed class ClusterPresence(IConnectionMultiplexer redis, InstanceIdentity identity, + ReadinessState readiness, AppDatabase database, ILogger logger) : BackgroundService +{ + private const string Registry = "messenger:ui:instances"; + public sealed record Node(string Id, bool Ready, long LastSeen); + public sealed record Snapshot(bool RedisAvailable, bool PostgresAvailable, long CheckedAt, List Instances); + + protected override async Task ExecuteAsync(CancellationToken stoppingToken) + { + using var timer = new PeriodicTimer(TimeSpan.FromSeconds(2)); + try + { + do + { + try + { + if (redis.IsConnected && !readiness.IsStopping && await database.IsReadyAsync()) + { + var db = redis.GetDatabase(); + var now = DateTimeOffset.UtcNow.ToUnixTimeMilliseconds(); + await db.SortedSetAddAsync(Registry, identity.Id, now).WaitAsync(TimeSpan.FromSeconds(1), stoppingToken); + await db.SortedSetRemoveRangeByScoreAsync(Registry, double.NegativeInfinity, now - 600_000); + await db.KeyExpireAsync(Registry, TimeSpan.FromMinutes(15)); + } + } + catch (Exception error) when (error is RedisException or TimeoutException) + { logger.LogDebug("Cluster heartbeat unavailable"); } + } while (await timer.WaitForNextTickAsync(stoppingToken)); + } + catch (OperationCanceledException) when (stoppingToken.IsCancellationRequested) { } + } + + public async Task ReadAsync() + { + var now = DateTimeOffset.UtcNow.ToUnixTimeMilliseconds(); + var postgres = await database.IsReadyAsync(); + try + { + if (!redis.IsConnected) return new(false, postgres, now, []); + var entries = await redis.GetDatabase().SortedSetRangeByScoreWithScoresAsync(Registry, + now - 600_000, double.PositiveInfinity).WaitAsync(TimeSpan.FromSeconds(1)); + return new(true, postgres, now, entries.Select(entry => new Node(entry.Element.ToString(), + now - entry.Score < 8000, (long)entry.Score)).ToList()); + } + catch (Exception error) when (error is RedisException or TimeoutException) + { return new(false, postgres, now, []); } + } +} diff --git a/src/Messenger.Api/Infrastructure/InstanceIdentity.cs b/src/Messenger.Api/Infrastructure/InstanceIdentity.cs new file mode 100644 index 00000000..855f4460 --- /dev/null +++ b/src/Messenger.Api/Infrastructure/InstanceIdentity.cs @@ -0,0 +1,6 @@ +namespace Messenger.Api.Infrastructure; + +public sealed class InstanceIdentity +{ + public string Id { get; } = Guid.NewGuid().ToString("N"); +} diff --git a/src/Messenger.Api/Infrastructure/ReadinessState.cs b/src/Messenger.Api/Infrastructure/ReadinessState.cs new file mode 100644 index 00000000..35981ef2 --- /dev/null +++ b/src/Messenger.Api/Infrastructure/ReadinessState.cs @@ -0,0 +1,8 @@ +namespace Messenger.Api.Infrastructure; + +public sealed class ReadinessState +{ + private int _stopping; + public bool IsStopping => Volatile.Read(ref _stopping) != 0; + public void Stop() => Interlocked.Exchange(ref _stopping, 1); +} diff --git a/src/Messenger.Api/Infrastructure/RedisSessionCache.cs b/src/Messenger.Api/Infrastructure/RedisSessionCache.cs new file mode 100644 index 00000000..09e977fa --- /dev/null +++ b/src/Messenger.Api/Infrastructure/RedisSessionCache.cs @@ -0,0 +1,58 @@ +using System.Text.Json; +using Messenger.Api.Contracts; +using StackExchange.Redis; + +namespace Messenger.Api.Infrastructure; + +// PostgreSQL validates the session on every request. This cache saves the user lookup +// and never grants access independently of the durable session row. +public sealed class RedisSessionCache(IConnectionMultiplexer connection, ILogger logger) +{ + private static readonly TimeSpan OperationBudget = TimeSpan.FromMilliseconds(750); + private static string Key(byte[] hash) => "messenger:session:" + Convert.ToHexString(hash).ToLowerInvariant(); + + public sealed record Entry(UserDto User, DateTime ExpiresAt); + + public async Task GetAsync(byte[] hash) + { + if (!connection.IsConnected) return null; + try + { + var value = await connection.GetDatabase().StringGetAsync(Key(hash)).WaitAsync(OperationBudget); + return value.IsNullOrEmpty ? null : JsonSerializer.Deserialize(value.ToString()); + } + catch (Exception exception) when (exception is RedisException or TimeoutException or OperationCanceledException or JsonException) + { + logger.LogWarning("Session cache read unavailable; using PostgreSQL"); + return null; + } + } + + public async Task SetAsync(byte[] hash, UserDto user, DateTime expiresAt) + { + var remaining = expiresAt - DateTime.UtcNow; + if (!connection.IsConnected || remaining <= TimeSpan.Zero) return; + try + { + await connection.GetDatabase().StringSetAsync(Key(hash), + JsonSerializer.Serialize(new Entry(user, expiresAt)), remaining).WaitAsync(OperationBudget); + } + catch (Exception exception) when (exception is RedisException or TimeoutException or OperationCanceledException) + { + logger.LogWarning("Session cache write unavailable; using PostgreSQL"); + } + } + + public async Task RemoveAsync(byte[] hash) + { + if (!connection.IsConnected) return; + try + { + await connection.GetDatabase().KeyDeleteAsync(Key(hash)).WaitAsync(OperationBudget); + } + catch (Exception exception) when (exception is RedisException or TimeoutException or OperationCanceledException) + { + logger.LogWarning("Session cache invalidation unavailable; PostgreSQL still enforces revocation"); + } + } +} diff --git a/src/Messenger.Api/Infrastructure/S3Storage.cs b/src/Messenger.Api/Infrastructure/S3Storage.cs new file mode 100644 index 00000000..719fb30b --- /dev/null +++ b/src/Messenger.Api/Infrastructure/S3Storage.cs @@ -0,0 +1,26 @@ +using Amazon.S3; +using Amazon.S3.Model; +using Amazon.Runtime; +namespace Messenger.Api.Infrastructure; +public sealed class S3Storage : IDisposable +{ + public AmazonS3Client Client { get; } + public string Bucket { get; } + public S3Storage(IConfiguration config) + { + Bucket=config["S3_BUCKET"] ?? "messenger"; + Client=new AmazonS3Client(new BasicAWSCredentials( + File.ReadAllText(config["S3_ACCESS_KEY_FILE"]!).Trim(), + File.ReadAllText(config["S3_SECRET_KEY_FILE"]!).Trim()),new AmazonS3Config { + ServiceURL=config["S3_ENDPOINT"] ?? "http://s3:9000", ForcePathStyle=true, + AuthenticationRegion="us-east-1", MaxErrorRetry=0, Timeout=TimeSpan.FromSeconds(20) + }); + } + public async Task ReadyAsync() + { + using var timeout=new CancellationTokenSource(TimeSpan.FromSeconds(1)); + try { await Client.ListObjectsV2Async(new ListObjectsV2Request {BucketName=Bucket,MaxKeys=1},timeout.Token); return true; } + catch { return false; } + } + public void Dispose() => Client.Dispose(); +} diff --git a/src/Messenger.Api/Messenger.Api.csproj b/src/Messenger.Api/Messenger.Api.csproj new file mode 100644 index 00000000..3985708c --- /dev/null +++ b/src/Messenger.Api/Messenger.Api.csproj @@ -0,0 +1,22 @@ + + + + net9.0 + enable + enable + + + + + + + + + + + + + + + + diff --git a/src/Messenger.Api/Middleware/ExceptionHandlingMiddleware.cs b/src/Messenger.Api/Middleware/ExceptionHandlingMiddleware.cs new file mode 100644 index 00000000..1047f952 --- /dev/null +++ b/src/Messenger.Api/Middleware/ExceptionHandlingMiddleware.cs @@ -0,0 +1,42 @@ +using Messenger.Api.Services; +using System.Net.Sockets; +using Npgsql; + +namespace Messenger.Api.Middleware; + +public sealed class ExceptionHandlingMiddleware(RequestDelegate next, ILogger logger) +{ + public async Task InvokeAsync(HttpContext context) + { + try + { + await next(context); + } + catch (AttachmentException exception) + { + if(!context.Response.HasStarted) + await ApiSupport.ApiError(context,exception.Status,exception.Code,exception.Message).ExecuteAsync(context); + } + catch (OperationCanceledException) when (!context.RequestAborted.IsCancellationRequested) + { + if(!context.Response.HasStarted) + await ApiSupport.ApiError(context,503,"unavailable","Время ожидания истекло").ExecuteAsync(context); + } + catch (BadHttpRequestException exception) when(exception.StatusCode==413) + { + await ApiSupport.ApiError(context,413,"payload_too_large","Слишком большой запрос").ExecuteAsync(context); + } + catch (Exception exception) when (exception is NpgsqlException or SocketException or TimeoutException or Amazon.S3.AmazonS3Exception or HttpRequestException) + { + logger.LogError(exception, "Database request failed"); + if (!context.Response.HasStarted) + await ApiSupport.ApiError(context, 503, "unavailable", "Сервис временно недоступен").ExecuteAsync(context); + } + catch (Exception exception) + { + logger.LogError(exception, "Request failed"); + if (!context.Response.HasStarted) + await ApiSupport.ApiError(context, 500, "internal_error", "Внутренняя ошибка").ExecuteAsync(context); + } + } +} diff --git a/src/Messenger.Api/Middleware/InstanceMiddleware.cs b/src/Messenger.Api/Middleware/InstanceMiddleware.cs new file mode 100644 index 00000000..c4b75741 --- /dev/null +++ b/src/Messenger.Api/Middleware/InstanceMiddleware.cs @@ -0,0 +1,18 @@ +using Messenger.Api.Infrastructure; +using Messenger.Api.Services; + +namespace Messenger.Api.Middleware; + +public sealed class InstanceMiddleware(RequestDelegate next) +{ + public async Task InvokeAsync(HttpContext context, InstanceIdentity identity, ReadinessState readiness) + { + context.Response.Headers["X-Instance-Id"] = identity.Id; + if (readiness.IsStopping && context.Request.Path != "/health/live") + { + await ApiSupport.ApiError(context, 503, "unavailable", "Экземпляр API останавливается").ExecuteAsync(context); + return; + } + await next(context); + } +} diff --git a/src/Messenger.Api/Middleware/RequestIdMiddleware.cs b/src/Messenger.Api/Middleware/RequestIdMiddleware.cs new file mode 100644 index 00000000..973b6373 --- /dev/null +++ b/src/Messenger.Api/Middleware/RequestIdMiddleware.cs @@ -0,0 +1,16 @@ +namespace Messenger.Api.Middleware; + +public sealed class RequestIdMiddleware +{ + private readonly RequestDelegate _next; + + public RequestIdMiddleware(RequestDelegate next) => _next = next; + + public async Task InvokeAsync(HttpContext context) + { + var requestId = Guid.NewGuid().ToString(); + context.Items["RequestId"] = requestId; + context.Response.Headers["X-Request-Id"] = requestId; + await _next(context); + } +} diff --git a/src/Messenger.Api/Middleware/RequestLoggingMiddleware.cs b/src/Messenger.Api/Middleware/RequestLoggingMiddleware.cs new file mode 100644 index 00000000..865f56d6 --- /dev/null +++ b/src/Messenger.Api/Middleware/RequestLoggingMiddleware.cs @@ -0,0 +1,25 @@ +namespace Messenger.Api.Middleware; + +public sealed class RequestLoggingMiddleware +{ + private readonly RequestDelegate _next; + + public RequestLoggingMiddleware(RequestDelegate next) => _next = next; + + public async Task InvokeAsync(HttpContext context) + { + var logger = context.RequestServices + .GetRequiredService() + .CreateLogger("Http"); + + await _next(context); + + logger.LogInformation( + "{Method} {Path} -> {StatusCode} request_id={RequestId}", + context.Request.Method, + context.Request.Path, + context.Response.StatusCode, + context.Items["RequestId"] + ); + } +} diff --git a/src/Messenger.Api/Program.cs b/src/Messenger.Api/Program.cs new file mode 100644 index 00000000..d6be52a3 --- /dev/null +++ b/src/Messenger.Api/Program.cs @@ -0,0 +1,110 @@ +using System.Text.Json; +using System.Text.Json.Serialization; +using Messenger.Api.Data; +using Messenger.Api.Endpoints; +using Messenger.Api.Infrastructure; +using Messenger.Api.Middleware; +using Messenger.Api.Services; +using Npgsql; +using StackExchange.Redis; + +ThreadPool.GetMinThreads(out var workerThreads, out var completionThreads); +ThreadPool.SetMinThreads(Math.Max(8, workerThreads), completionThreads); + +var builder = WebApplication.CreateBuilder(args); + +if(args.Contains("--bootstrap")) +{ + using var storage=new S3Storage(builder.Configuration); + try { await storage.Client.GetBucketLocationAsync(storage.Bucket); } + catch(Amazon.S3.AmazonS3Exception ex) when(ex.StatusCode==System.Net.HttpStatusCode.NotFound) + { await storage.Client.PutBucketAsync(storage.Bucket); } + Console.WriteLine("Private bucket ready"); + return; +} + +var host = Environment.GetEnvironmentVariable("APP_HOST") ?? "0.0.0.0"; +var port = Environment.GetEnvironmentVariable("APP_PORT") ?? "8080"; +builder.WebHost.UseUrls($"http://{host}:{port}"); + +builder.Services.ConfigureHttpJsonOptions(options => +{ + options.SerializerOptions.PropertyNamingPolicy = JsonNamingPolicy.SnakeCaseLower; + options.SerializerOptions.UnmappedMemberHandling = JsonUnmappedMemberHandling.Disallow; +}); + +var databaseUrlFile = Environment.GetEnvironmentVariable("DATABASE_URL_FILE"); +var databaseUrl = databaseUrlFile is not null + ? File.ReadAllText(databaseUrlFile).Trim() + : Environment.GetEnvironmentVariable("DATABASE_URL"); +if (string.IsNullOrWhiteSpace(databaseUrl)) + throw new InvalidOperationException("Set DATABASE_URL_FILE or DATABASE_URL before starting the API"); + +var connectionString = new NpgsqlConnectionStringBuilder(databaseUrl) +{ + MaxPoolSize = int.TryParse(builder.Configuration["DB_POOL_SIZE"], out var poolSize) && poolSize > 0 ? poolSize : 20, + Timeout = 5, + ApplicationName = "messenger-api", + CommandTimeout = 10 +}; +var dataSource = NpgsqlDataSource.Create(connectionString.ConnectionString); +if (args.Contains("--migrate", StringComparer.Ordinal)) +{ + await DatabaseMigrator.ApplyAsync(dataSource); + await dataSource.DisposeAsync(); + return; +} +builder.Services.AddSingleton(dataSource); +builder.Services.AddSingleton(); +builder.Services.AddSingleton(); +builder.Services.Configure(options => options.ShutdownTimeout = TimeSpan.FromSeconds(8)); +builder.Services.AddSingleton(); +builder.Services.AddSingleton(); +builder.Services.AddSingleton(); +builder.Services.AddSingleton(); +var redisOptions = ConfigurationOptions.Parse(builder.Configuration["REDIS_URL"] ?? "localhost:6379"); +redisOptions.AbortOnConnectFail = false; +redisOptions.ConnectTimeout = 500; +redisOptions.ConnectRetry = 0; +redisOptions.AsyncTimeout = 500; +redisOptions.SyncTimeout = 500; +redisOptions.BacklogPolicy = BacklogPolicy.FailFast; +builder.Services.AddSingleton(await ConnectionMultiplexer.ConnectAsync(redisOptions)); +builder.Services.AddSingleton(); +builder.Services.AddSingleton(); +builder.Services.AddSingleton(); +builder.Services.AddSingleton(); +builder.Services.AddSingleton(); +builder.Services.AddSingleton(); +builder.Services.AddSingleton(); +builder.Services.AddHostedService(services => services.GetRequiredService()); + +var app = builder.Build(); +if(args.Contains("--reconcile")) +{ + await app.Services.GetRequiredService().RunAsync(args.Contains("--apply")); + await app.DisposeAsync(); + return; +} +app.Lifetime.ApplicationStopping.Register(app.Services.GetRequiredService().Stop); + +app.UseMiddleware(); +app.UseMiddleware(); +app.UseMiddleware(); +app.UseMiddleware(); +app.UseDefaultFiles(); +app.UseStaticFiles(new StaticFileOptions +{ + OnPrepareResponse = context => context.Context.Response.Headers.CacheControl = "no-cache" +}); + +app.MapHealthEndpoints(); +app.MapUserEndpoints(); +app.MapAuthEndpoints(); +app.MapChatEndpoints(); +app.MapMessageEndpoints(); +app.MapAttachmentEndpoints(); +app.MapUiEndpoints(); +app.MapReactionEndpoints(); + +app.Run(); diff --git a/src/Messenger.Api/Properties/launchSettings.json b/src/Messenger.Api/Properties/launchSettings.json new file mode 100644 index 00000000..ac9df787 --- /dev/null +++ b/src/Messenger.Api/Properties/launchSettings.json @@ -0,0 +1,23 @@ +{ + "$schema": "https://json.schemastore.org/launchsettings.json", + "profiles": { + "http": { + "commandName": "Project", + "dotnetRunMessages": true, + "launchBrowser": true, + "applicationUrl": "http://localhost:5052", + "environmentVariables": { + "ASPNETCORE_ENVIRONMENT": "Development" + } + }, + "https": { + "commandName": "Project", + "dotnetRunMessages": true, + "launchBrowser": true, + "applicationUrl": "https://localhost:7253;http://localhost:5052", + "environmentVariables": { + "ASPNETCORE_ENVIRONMENT": "Development" + } + } + } +} diff --git a/src/Messenger.Api/Services/ApiSupport.cs b/src/Messenger.Api/Services/ApiSupport.cs new file mode 100644 index 00000000..7936d712 --- /dev/null +++ b/src/Messenger.Api/Services/ApiSupport.cs @@ -0,0 +1,93 @@ +using System.Globalization; +using System.Text.Json; +using Messenger.Api.Contracts; + +namespace Messenger.Api.Services; + +public static class ApiSupport +{ + public static async Task<(T? Value, IResult? Error)> ReadJsonAsync(HttpContext context) + { + if (!context.Request.HasJsonContentType()) + return (default, ApiError(context, 400, "invalid_request", "Требуется application/json")); + + try + { + var value = await context.Request.ReadFromJsonAsync(); + return value is null + ? (default, ApiError(context, 400, "invalid_request", "Тело запроса обязательно")) + : (value, null); + } + catch (Exception exception) when (exception is JsonException or NotSupportedException or BadHttpRequestException) + { + return (default, ApiError(context, 400, "invalid_request", "Некорректный JSON")); + } + } + + public static IResult Unauthorized(HttpContext context, bool basic = false) + { + context.Response.Headers["WWW-Authenticate"] = basic + ? "Basic realm=\"messenger\", charset=\"UTF-8\"" + : "Bearer realm=\"messenger\""; + return ApiError(context, 401, "unauthorized", "Требуется действительная сессия"); + } + + public static (ChatCursor? Cursor, DateTime? Time, IResult? Error) ParseCursor( + HttpContext context, string scope) + { + if (!context.Request.Query.TryGetValue("cursor", out var value)) + return (null, null, null); + + var cursor = CursorService.DecodeChatCursor(value.ToString()); + if (cursor is null || cursor.Scope != scope || cursor.Id == Guid.Empty || + !DateTime.TryParse(cursor.CreatedAt, CultureInfo.InvariantCulture, + DateTimeStyles.RoundtripKind, out var time) || time.Kind != DateTimeKind.Utc) + return (null, null, ApiError(context, 400, "invalid_request", "Некорректный cursor")); + + return (cursor, time, null); + } + + public static (int Limit, IResult? Error) ParseLimit(HttpContext context) + { + const int defaultLimit = 50; + + if (!context.Request.Query.TryGetValue("limit", out var value)) + return (defaultLimit, null); + + if (!int.TryParse(value.ToString(), out var limit) || + limit < 1 || + limit > 100) + { + return ( + 0, + ApiError(context, 400, "invalid_request", "limit должен быть от 1 до 100") + ); + } + + return (limit, null); + } + + public static IResult ApiError( + HttpContext context, + int status, + string code, + string message) + { + var requestId = + context.Items["RequestId"]?.ToString() + ?? Guid.NewGuid().ToString(); + + return Results.Json( + new + { + error = new + { + code, + message, + request_id = requestId + } + }, + statusCode: status + ); + } +} diff --git a/src/Messenger.Api/Services/AttachmentException.cs b/src/Messenger.Api/Services/AttachmentException.cs new file mode 100644 index 00000000..cb8dc39b --- /dev/null +++ b/src/Messenger.Api/Services/AttachmentException.cs @@ -0,0 +1,6 @@ +namespace Messenger.Api.Services; +public sealed class AttachmentException(int status, string code, string message) : Exception(message) +{ + public int Status { get; } = status; + public string Code { get; } = code; +} diff --git a/src/Messenger.Api/Services/AttachmentReconciler.cs b/src/Messenger.Api/Services/AttachmentReconciler.cs new file mode 100644 index 00000000..0fa53f77 --- /dev/null +++ b/src/Messenger.Api/Services/AttachmentReconciler.cs @@ -0,0 +1,97 @@ +using System.Diagnostics; +using System.Text.Json; +using Amazon.S3.Model; +using Messenger.Api.Data; +using Messenger.Api.Infrastructure; +using Npgsql; +namespace Messenger.Api.Services; +public sealed class AttachmentReconciler(NpgsqlDataSource db, S3Storage storage, IConfiguration config) +{ + public async Task RunAsync(bool apply) + { + var timer=Stopwatch.StartNew(); + var grace=int.TryParse(config["RECONCILE_GRACE_SECONDS"],out var value) ? Math.Max(120,value) : 3600; + var cutoff=DateTime.UtcNow.AddSeconds(-grace); + var actions=new List(); long objects=0,rows=0,requests=0; + using var timeout=new CancellationTokenSource(TimeSpan.FromMinutes(5)); + var ct=timeout.Token; + await using var connection=await db.OpenConnectionAsync(ct); + await using var tx=await connection.BeginTransactionAsync(ct); + await using(var gate=new NpgsqlCommand($"SELECT pg_advisory_xact_lock({AppDatabase.AttachmentGate})",connection,tx)) + { gate.CommandTimeout=120; await gate.ExecuteNonQueryAsync(ct); } + // Excluding uploads and message attachment references makes the final recheck authoritative. + string? continuation=null; + do { + var page=await storage.Client.ListObjectsV2Async(new ListObjectsV2Request { + BucketName=storage.Bucket,Prefix="originals/",MaxKeys=1000,ContinuationToken=continuation },ct);requests++; + foreach(var obj in page.S3Objects ?? []) + { + objects++; + if(obj.LastModified is null || obj.LastModified.Value.ToUniversalTime()>cutoff) continue; + await using var lookup=new NpgsqlCommand("SELECT EXISTS(SELECT 1 FROM attachments WHERE object_key=@key), EXISTS(SELECT 1 FROM messages WHERE attachment_ids @> ARRAY[@id])",connection,tx); + lookup.Parameters.AddWithValue("key",obj.Key); + Guid.TryParse(obj.Key["originals/".Length..],out var referencedId); + lookup.Parameters.AddWithValue("id",referencedId); + bool metadata, used; + await using(var found=await lookup.ExecuteReaderAsync(ct)) + { + await found.ReadAsync(ct);metadata=found.GetBoolean(0);used=found.GetBoolean(1); + } + if(!metadata && used) actions.Add(new {kind="missing_metadata",key=obj.Key,action="preserved_used_original"}); + if(!metadata && !used) + { + actions.Add(new { kind="orphan",key=obj.Key,action=apply?"deleted":"would_delete" }); + if(apply) {await storage.Client.DeleteObjectAsync(storage.Bucket,obj.Key,ct);requests++;} + } + } + continuation=page.IsTruncated==true ? page.NextContinuationToken : null; + } while(continuation is not null); + // Keyset pages bound metadata memory; SQL checks actual message references. + Guid last=Guid.Empty; + while(true) + { + var batch=new List<(Guid Id,string Key,bool Used,DateTime Created)>(); + await using(var query=new NpgsqlCommand(""" + SELECT a.id,a.object_key,EXISTS(SELECT 1 FROM messages m WHERE m.attachment_ids @> ARRAY[a.id]),a.created_at + FROM attachments a WHERE a.id>@last ORDER BY a.id LIMIT 200 + """,connection,tx)) + { + query.Parameters.AddWithValue("last",last); + await using var reader=await query.ExecuteReaderAsync(ct); + while(await reader.ReadAsync(ct)) batch.Add((reader.GetGuid(0),reader.GetString(1),reader.GetBoolean(2),reader.GetDateTime(3))); + } + if(batch.Count==0) break; + foreach(var a in batch) + { + rows++;last=a.Id; + if(a.Created>cutoff) continue; + DateTime? modified=null; bool missing=false; + try { var head=await storage.Client.GetObjectMetadataAsync(storage.Bucket,a.Key,ct);requests++;modified=head.LastModified; } + catch(Amazon.S3.AmazonS3Exception ex) when(ex.StatusCode==System.Net.HttpStatusCode.NotFound) { requests++;missing=true; } + if(!missing && modified?.ToUniversalTime()>cutoff) continue; + if(a.Used) + { + if(missing) + { + actions.Add(new { kind="missing",id=a.Id,action=apply?"marked_missing":"would_mark_missing" }); + if(apply) { + await using var update=new NpgsqlCommand("UPDATE attachments SET status='missing',updated_at=clock_timestamp() WHERE id=@id AND status<>'missing'",connection,tx); + update.Parameters.AddWithValue("id",a.Id); await update.ExecuteNonQueryAsync(ct); + } + } + continue; + } + actions.Add(new {kind="unreferenced",id=a.Id,action=apply?"deleted":"would_delete"}); + if(apply) + { + if(!missing) {await storage.Client.DeleteObjectAsync(storage.Bucket,a.Key,ct);requests++;} + await using var delete=new NpgsqlCommand("DELETE FROM attachments WHERE id=@id",connection,tx); + delete.Parameters.AddWithValue("id",a.Id);await delete.ExecuteNonQueryAsync(ct); + } + } + } + if(apply) await tx.CommitAsync(ct); else await tx.RollbackAsync(ct); + Console.WriteLine(JsonSerializer.Serialize(new {mode=apply?"apply":"dry-run",grace_seconds=grace,objects,rows,s3_requests=requests, + elapsed_ms=timer.Elapsed.TotalMilliseconds,peak_process_bytes=Process.GetCurrentProcess().PeakWorkingSet64,actions})); + } +} diff --git a/src/Messenger.Api/Services/AttachmentService.cs b/src/Messenger.Api/Services/AttachmentService.cs new file mode 100644 index 00000000..38271a3c --- /dev/null +++ b/src/Messenger.Api/Services/AttachmentService.cs @@ -0,0 +1,76 @@ +using System.Security.Cryptography; +using Amazon.S3.Model; +using Messenger.Api.Contracts; +using Messenger.Api.Data; +using Messenger.Api.Infrastructure; +using Npgsql; +using SkiaSharp; +namespace Messenger.Api.Services; +public sealed class AttachmentService(S3Storage storage, NpgsqlDataSource db) +{ + public const long MaxBytes=10*1024*1024; + private readonly SemaphoreSlim slots=new(1,1); + public async Task UploadAsync(HttpRequest request, Guid chat, Guid actor, string name) + { + using var timeout=CancellationTokenSource.CreateLinkedTokenSource(request.HttpContext.RequestAborted); + timeout.CancelAfter(TimeSpan.FromSeconds(90)); + var ct=timeout.Token; + if (request.ContentLength>MaxBytes) throw new AttachmentException(413,"payload_too_large","Файл больше 10 MiB"); + await slots.WaitAsync(ct); + var path=Path.Combine(Path.GetTempPath(),Guid.NewGuid().ToString("N")); + try + { + await using var file=new FileStream(path,FileMode.CreateNew,FileAccess.ReadWrite,FileShare.None, + 65536,FileOptions.Asynchronous|FileOptions.DeleteOnClose); + var buffer=new byte[65536]; long size=0; + using var digest=IncrementalHash.CreateHash(HashAlgorithmName.SHA256); + while(true) + { + var count=await request.Body.ReadAsync(buffer,ct); if(count==0) break; + size+=count; + if(size>MaxBytes) throw new AttachmentException(413,"payload_too_large","Файл больше 10 MiB"); + digest.AppendData(buffer,0,count); await file.WriteAsync(buffer.AsMemory(0,count),ct); + } + if(size==0) throw new AttachmentException(415,"unsupported_media_type","Пустое изображение"); + string mime; + file.Position=0; + using (var stream=new SKManagedStream(file,false)) + using (var codec=SKCodec.Create(stream)) + { + if(codec is null) throw new AttachmentException(415,"unsupported_media_type","Повреждённое изображение"); + var info=codec.Info; + if((long)info.Width*info.Height>40_000_000) + throw new AttachmentException(413,"payload_too_large","Слишком много пикселей"); + mime=codec.EncodedFormat switch {SKEncodedImageFormat.Png=>"image/png",SKEncodedImageFormat.Jpeg=>"image/jpeg",_=>""}; + if(mime=="" || request.ContentType?.Split(';')[0].Trim()!=mime) + throw new AttachmentException(415,"unsupported_media_type","Требуется PNG или JPEG с верным MIME"); + using var bitmap=new SKBitmap(new SKImageInfo(info.Width,info.Height,SKColorType.Rgba8888,SKAlphaType.Premul)); + if(codec.GetPixels(bitmap.Info,bitmap.GetPixels())!=SKCodecResult.Success) + throw new AttachmentException(415,"unsupported_media_type","Повреждённое изображение"); + } + var id=Guid.NewGuid(); var key=$"originals/{id:N}"; var now=UtcClock.Now(); + var sha=Convert.ToHexString(digest.GetHashAndReset()).ToLowerInvariant(); + await using var connection=await db.OpenConnectionAsync(ct); + await using var transaction=await connection.BeginTransactionAsync(ct); + await using(var gate=new NpgsqlCommand($"SELECT pg_advisory_xact_lock_shared({AppDatabase.AttachmentGate})",connection,transaction)) + await gate.ExecuteNonQueryAsync(ct); + file.Position=0; + await storage.Client.PutObjectAsync(new PutObjectRequest {BucketName=storage.Bucket,Key=key, + InputStream=file,ContentType=mime,AutoCloseStream=false,UseChunkEncoding=false},ct); + await using(var insert=new NpgsqlCommand(""" + INSERT INTO attachments(id,chat_id,owner_id,filename,content_type,size_bytes,sha256,object_key,status,created_at,updated_at) + VALUES (@id,@chat,@actor,@name,@mime,@size,@sha,@key,'ready',@now,@now) + """,connection,transaction)) + { + insert.Parameters.AddWithValue("id",id);insert.Parameters.AddWithValue("chat",chat); + insert.Parameters.AddWithValue("actor",actor);insert.Parameters.AddWithValue("name",name); + insert.Parameters.AddWithValue("mime",mime);insert.Parameters.AddWithValue("size",size); + insert.Parameters.AddWithValue("sha",sha);insert.Parameters.AddWithValue("key",key);insert.Parameters.AddWithValue("now",now); + await insert.ExecuteNonQueryAsync(ct); + } + await transaction.CommitAsync(ct); + return new(id,chat,actor,name,mime,size,sha,"ready",[],null,now.ToString("O"),now.ToString("O")); + } + finally { slots.Release(); File.Delete(path); } + } +} diff --git a/src/Messenger.Api/Services/ChatService.cs b/src/Messenger.Api/Services/ChatService.cs new file mode 100644 index 00000000..38979f01 --- /dev/null +++ b/src/Messenger.Api/Services/ChatService.cs @@ -0,0 +1,16 @@ +using Messenger.Api.Contracts; +using Messenger.Api.Data; + +namespace Messenger.Api.Services; + +public sealed class ChatService(AppDatabase database) +{ + public async Task CreateAsync(string title, List memberIds) => + (await database.CreateChatAsync(title, memberIds))?.ToDto(); + + public async Task FindForMemberAsync(Guid chatId, Guid userId) => + (await database.FindChatForMemberAsync(chatId, userId))?.ToDto(); + + public async Task> ListAsync(Guid userId, DateTime? cursorTime, Guid? cursorId, int count) => + (await database.ListChatsAsync(userId, cursorTime, cursorId, count)).Select(chat => chat.ToDto()).ToList(); +} diff --git a/src/Messenger.Api/Services/CursorService.cs b/src/Messenger.Api/Services/CursorService.cs new file mode 100644 index 00000000..f260e9e7 --- /dev/null +++ b/src/Messenger.Api/Services/CursorService.cs @@ -0,0 +1,49 @@ +using System.Text; +using System.Text.Json; +using Messenger.Api.Contracts; + +namespace Messenger.Api.Services; + +public static class CursorService +{ + public static string EncodeChatCursor(ChatCursor cursor) + { + var json = JsonSerializer.Serialize(cursor); + + return Convert.ToBase64String(Encoding.UTF8.GetBytes(json)) + .TrimEnd('=') + .Replace('+', '-') + .Replace('/', '_'); + } + + public static ChatCursor? DecodeChatCursor(string cursor) + { + try + { + var base64 = cursor + .Replace('-', '+') + .Replace('_', '/'); + + switch (base64.Length % 4) + { + case 2: + base64 += "=="; + break; + case 3: + base64 += "="; + break; + case 1: + return null; + } + + var bytes = Convert.FromBase64String(base64); + var json = Encoding.UTF8.GetString(bytes); + + return JsonSerializer.Deserialize(json); + } + catch + { + return null; + } + } +} diff --git a/src/Messenger.Api/Services/MessageService.cs b/src/Messenger.Api/Services/MessageService.cs new file mode 100644 index 00000000..b36b399c --- /dev/null +++ b/src/Messenger.Api/Services/MessageService.cs @@ -0,0 +1,13 @@ +using Messenger.Api.Contracts; +using Messenger.Api.Data; + +namespace Messenger.Api.Services; + +public sealed class MessageService(AppDatabase database) +{ + public async Task CreateAsync(Guid chatId, Guid senderId, string text, string key, Guid[] attachmentIds) => + (await database.CreateMessageOnceAsync(chatId, senderId, text, key, attachmentIds))?.ToDto(); + + public async Task> ListAsync(Guid chatId, DateTime? cursorTime, Guid? cursorId, int count, bool newestFirst = false) => + (await database.ListMessagesAsync(chatId, cursorTime, cursorId, count, newestFirst)).Select(message => message.ToDto()).ToList(); +} diff --git a/src/Messenger.Api/Services/PasswordService.cs b/src/Messenger.Api/Services/PasswordService.cs new file mode 100644 index 00000000..2d1d4157 --- /dev/null +++ b/src/Messenger.Api/Services/PasswordService.cs @@ -0,0 +1,28 @@ +using System.Security.Cryptography; +using System.Text; +using Isopoh.Cryptography.Argon2; + +namespace Messenger.Api.Services; + +public sealed class PasswordService +{ + public string Hash(string password) + { + var salt = RandomNumberGenerator.GetBytes(16); + var config = new Argon2Config + { + Type = Argon2Type.HybridAddressing, + Version = Argon2Version.Nineteen, + TimeCost = 3, + MemoryCost = 32768, + Lanes = 1, + Threads = 1, + Password = Encoding.UTF8.GetBytes(password), + Salt = salt, + HashLength = 32 + }; + return Argon2.Hash(config); + } + + public bool Verify(string hash, string password) => Argon2.Verify(hash, password); +} diff --git a/src/Messenger.Api/Services/SessionService.cs b/src/Messenger.Api/Services/SessionService.cs new file mode 100644 index 00000000..d9a134fb --- /dev/null +++ b/src/Messenger.Api/Services/SessionService.cs @@ -0,0 +1,65 @@ +using System.Security.Cryptography; +using System.Text; +using Messenger.Api.Contracts; +using Messenger.Api.Data; +using Messenger.Api.Infrastructure; + +namespace Messenger.Api.Services; + +public sealed class SessionService(AppDatabase database, PasswordService passwords, RedisSessionCache cache, IConfiguration configuration) +{ + private readonly int _ttlSeconds = int.TryParse(configuration["SESSION_TTL_SECONDS"], out var ttl) && ttl > 0 + ? ttl : 3600; + + public async Task LoginAsync(string username, string password) + { + var user = await database.FindUserByUsernameAsync(username); + if (user is null || !passwords.Verify(user.PasswordHash, password)) + return null; + + var token = Convert.ToBase64String(RandomNumberGenerator.GetBytes(32)) + .TrimEnd('=').Replace('+', '-').Replace('/', '_'); + var expiresAt = UtcClock.Now().AddSeconds(_ttlSeconds); + var hash = HashToken(token); + await database.CreateSessionAsync(hash, user.Id, expiresAt); + await cache.SetAsync(hash, user.ToDto(), expiresAt); + return new SessionDto(token, "Bearer", expiresAt.ToString("O"), user.ToDto()); + } + + public async Task<(UserDto? User, byte[]? TokenHash)> AuthenticateAsync(HttpContext context) + { + if (!context.Request.Headers.TryGetValue("Authorization", out var value)) + return (null, null); + + var authorization = value.ToString(); + if (!authorization.StartsWith("Bearer ", StringComparison.OrdinalIgnoreCase)) + return (null, null); + + var token = authorization[7..]; + if (token.Length != 43 || token.Any(c => !char.IsAsciiLetterOrDigit(c) && c != '-' && c != '_')) + return (null, null); + + var hash = HashToken(token); + var session = await database.FindActiveSessionAsync(hash); + if (session is null) return (null, null); + + var cached = await cache.GetAsync(hash); + if (cached is not null && cached.User.Id == session.UserId && cached.ExpiresAt == session.ExpiresAt) + return (cached.User, hash); + + var user = await database.FindUserByIdAsync(session.UserId); + if (user is null) return (null, null); + var dto = user.ToDto(); + await cache.SetAsync(hash, dto, session.ExpiresAt); + return (dto, hash); + } + + public async Task RevokeAsync(byte[] tokenHash) + { + var revoked = await database.RevokeSessionAsync(tokenHash); + if (revoked) await cache.RemoveAsync(tokenHash); + return revoked; + } + + private static byte[] HashToken(string token) => SHA256.HashData(Encoding.ASCII.GetBytes(token)); +} diff --git a/src/Messenger.Api/Services/UserService.cs b/src/Messenger.Api/Services/UserService.cs new file mode 100644 index 00000000..6dafd366 --- /dev/null +++ b/src/Messenger.Api/Services/UserService.cs @@ -0,0 +1,24 @@ +using Messenger.Api.Contracts; +using Messenger.Api.Data; +using Npgsql; + +namespace Messenger.Api.Services; + +public sealed class UserService(AppDatabase database, PasswordService passwords) +{ + public async Task> ListForChatAsync(Guid chatId) => + (await database.ListChatUsersAsync(chatId)).Select(user => user.ToDto()).ToList(); + + public async Task RegisterAsync(string username, string displayName, string password) + { + var hash = passwords.Hash(password); + try + { + return (await database.CreateUserAsync(username, displayName, hash)).ToDto(); + } + catch (PostgresException exception) when (exception.SqlState == PostgresErrorCodes.UniqueViolation) + { + return null; + } + } +} diff --git a/src/Messenger.Api/appsettings.Development.json b/src/Messenger.Api/appsettings.Development.json new file mode 100644 index 00000000..ff66ba6b --- /dev/null +++ b/src/Messenger.Api/appsettings.Development.json @@ -0,0 +1,8 @@ +{ + "Logging": { + "LogLevel": { + "Default": "Information", + "Microsoft.AspNetCore": "Warning" + } + } +} diff --git a/src/Messenger.Api/appsettings.json b/src/Messenger.Api/appsettings.json new file mode 100644 index 00000000..4d566948 --- /dev/null +++ b/src/Messenger.Api/appsettings.json @@ -0,0 +1,9 @@ +{ + "Logging": { + "LogLevel": { + "Default": "Information", + "Microsoft.AspNetCore": "Warning" + } + }, + "AllowedHosts": "*" +} diff --git a/src/Messenger.Api/wwwroot/app.css b/src/Messenger.Api/wwwroot/app.css new file mode 100644 index 00000000..7bc42308 --- /dev/null +++ b/src/Messenger.Api/wwwroot/app.css @@ -0,0 +1,438 @@ +:root { + color-scheme: dark; + --ink: #FFE135; + --muted: #b6b5aa; + --accent: #FFE135; + --accent-hover: #ffeb79; + --paper: #262626; + --surface: #303030; + --soft: #38382c; + --border: #414139; + --danger: #ffaaa0; + font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; + color: var(--ink); + background: #262626; + font-size: 15px; +} +* { box-sizing: border-box; } +body { margin: 0; } +button, input, textarea { font: inherit; } +button, a, input, textarea { -webkit-tap-highlight-color: transparent; } +button { cursor: pointer; } +button:disabled { cursor: default; opacity: .5; } +button, textarea, input { outline: none; } +button:focus-visible, a:focus-visible { outline: 2px solid var(--accent); outline-offset: 4px; } +input:focus, textarea:focus { border-color: var(--accent); box-shadow: 0 0 0 3px #ffe13515; } +a { color: inherit; text-decoration: none; } +[hidden] { display: none !important; } +svg { width: 21px; height: 21px; fill: none; stroke: currentColor; stroke-width: 1.7; stroke-linecap: round; stroke-linejoin: round; flex-shrink: 0; } +.svg-sprite { position: absolute; width: 0; height: 0; overflow: hidden; } +.visually-hidden { position: absolute; width: 1px; height: 1px; padding: 0; margin: -1px; overflow: hidden; clip: rect(0,0,0,0); white-space: nowrap; border: 0; } +::selection { color: #262626; background: var(--accent); } + +/* Brand and shared controls */ +.brand { display: inline-flex; align-items: center; font-size: 30px; font-weight: 750; letter-spacing: -1.6px; gap: 10px; line-height: 1; } +.brand-dot { color: var(--accent); margin-left: -8px; } +.brand-mark { height: 36px; width: 36px; background: var(--accent); border-radius: 12px; display: flex; flex-direction: column; justify-content: center; gap: 4px; padding: 9px; } +.brand-mark i { display: block; height: 2px; border-radius: 2px; background: #262626; } +.brand-mark i:nth-child(2) { width: 75%; } +.brand-mark i:nth-child(3) { width: 45%; } +.eyebrow { display: block; color: var(--muted); font-size: 10px; font-weight: 650; letter-spacing: 2px; text-transform: uppercase; line-height: 1.6; } +.muted { color: var(--muted); font-size: 14px; line-height: 1.7; } +label { display: grid; gap: 9px; font-size: 12px; font-weight: 550; color: var(--ink); } +input, textarea { width: 100%; color: var(--ink); background: #292929; border: 1px solid #4b4b42; border-radius: 12px; padding: 14px 15px; font-size: 14px; transition: border-color .18s, box-shadow .18s; } +input::placeholder, textarea::placeholder { color: #a6a69a; } +textarea { resize: vertical; line-height: 1.5; } +.field-note { color: var(--muted); font-size: 11px; font-weight: 400; line-height: 1.7; } +.button { display: inline-flex; align-items: center; justify-content: center; gap: 10px; border-radius: 12px; border: 1px solid transparent; padding: 14px 20px; font-weight: 650; font-size: 13px; transition: background .18s, transform .18s; } +.button.primary { background: var(--accent); color: #262626; } +.button.primary:hover { background: var(--accent-hover); transform: translateY(-1px); } +.button.secondary { background: #3a3a32; border-color: var(--border); color: var(--ink); } +.button.secondary:hover { background: #454538; } +.button.wide { width: 100%; } +.icon-button { display: inline-flex; align-items: center; justify-content: center; border: 1px solid transparent; background: transparent; color: var(--muted); width: 36px; height: 36px; border-radius: 11px; flex-shrink: 0; transition: background .18s, color .18s; } +.icon-button:hover { background: #3c3c32; color: var(--accent); } +.icon-button.filled { background: var(--accent); color: #262626; } +.icon-button.filled:hover { background: var(--accent-hover); } +.text-button { background: none; border: 0; color: var(--accent); font-size: 11px; padding: 10px 14px; border-radius: 9px; } +.text-button:hover { background: #ffe1350e; } +.form-notice { color: var(--danger); font-size: 12px; line-height: 1.6; background: #452f2d; border: 1px solid #70453e; border-radius: 10px; padding: 11px 13px; } +.form-notice.success { color: var(--ink); background: var(--soft); border-color: #686032; } + +/* Entry screen */ +.auth-layout { min-height: 100svh; display: grid; grid-template-columns: 1.1fr 1fr; max-width: 1440px; margin: auto; } +.intro { position: relative; min-height: 760px; padding: 50px 64px 40px; overflow: hidden; background: radial-gradient(ellipse at 5% 95%, #ffe13508, transparent 65%), var(--paper); } +.intro::before { content: ""; position: absolute; inset: auto auto -270px -250px; width: 760px; height: 760px; border: 1px solid #ffe13520; border-radius: 50%; pointer-events: none; } +.intro::after { content: ""; position: absolute; right: -190px; top: 90px; width: 440px; height: 440px; border: 1px solid #ffe13512; border-radius: 50%; pointer-events: none; } +.intro-copy { margin-top: 82px; position: relative; z-index: 1; } +.intro-copy .eyebrow { color: var(--accent); padding-left: 22px; position: relative; } +.intro-copy .eyebrow::before { content: ""; width: 7px; height: 7px; background: var(--accent); border-radius: 50%; position: absolute; left: 0; top: 5px; } +.intro h1 { font-size: clamp(48px, 5vw, 72px); line-height: 1.04; font-weight: 700; letter-spacing: -3.5px; margin: 22px 0 26px; } +.intro em, .welcome em { font-family: Georgia, "Times New Roman", serif; font-weight: 400; color: var(--accent); } +.intro-copy p { color: var(--muted); line-height: 1.8; font-size: 15px; } +.conversation-art { position: relative; width: 330px; height: 165px; margin: 38px 0 25px 34px; z-index: 1; } +.art-bubble { position: absolute; padding: 17px 22px 13px; border-radius: 18px; font-size: 14px; box-shadow: 0 12px 30px #00000020; } +.art-bubble span { display: block; font-size: 10px; text-align: right; margin-top: 8px; opacity: .65; } +.art-bubble b { font-weight: 500; } +.art-one { background: #353530; border: 1px solid #4a4a3c; left: 0; top: 0; transform: rotate(-4deg); border-bottom-left-radius: 5px; min-width: 195px; } +.art-two { background: var(--accent); color: #262626; right: 0; top: 67px; transform: rotate(3deg); border-bottom-right-radius: 5px; min-width: 218px; } +.art-typing { position: absolute; bottom: 0; left: 15px; display: flex; gap: 5px; border-radius: 12px; background: #353530; border: 1px solid var(--border); padding: 13px 19px; } +.art-typing i { background: var(--accent); width: 5px; height: 5px; border-radius: 50%; } +.art-orbit { position: absolute; right: -45px; top: 5px; width: 11px; height: 11px; background: var(--accent); border-radius: 50%; box-shadow: 0 0 0 9px #ffe13508; } +.intro-footer { font-size: 11px; color: var(--muted); display: flex; align-items: center; gap: 9px; margin-top: 38px; position: relative; } +.status-dot { height: 6px; width: 6px; background: var(--accent); border-radius: 50%; } +.auth-side { background: #2c2c2a; border-left: 1px solid var(--border); display: flex; flex-direction: column; justify-content: center; align-items: center; padding: 50px 64px 25px; min-height: 760px; } +.auth-card { width: 100%; max-width: 360px; } +.auth-switch { display: flex; padding: 5px; background: #222222; border: 1px solid #404037; border-radius: 14px; margin-bottom: 42px; } +.auth-switch button { width: 50%; background: transparent; border: 0; border-radius: 9px; color: var(--muted); padding: 11px; font-size: 12px; font-weight: 600; } +.auth-switch .active { background: var(--accent); color: #262626; box-shadow: 0 3px 12px #00000018; } +.auth-card h2 { font-weight: 650; font-size: 40px; letter-spacing: -1.7px; line-height: 1.15; margin: 12px 0; } +.auth-card .muted { margin: 13px 0 30px; } +.auth-card form { display: grid; gap: 20px; } +.auth-card .wide { margin-top: 5px; justify-content: space-between; } +.auth-card .wide > span { font-size: 21px; line-height: 1; } +.auth-footnote { font-size: 11px; color: var(--muted); margin: 24px 0; text-align: center; } +.auth-bottom { color: var(--muted); font-size: 10px; letter-spacing: .6px; margin-top: 40px; } + +/* Conversations */ +.app-shell { display: grid; grid-template-columns: 310px minmax(0,1fr); height: calc(100svh - 44px); max-width: 1440px; margin: 22px auto; border: 1px solid #46463c; border-radius: 24px; overflow: hidden; box-shadow: 0 20px 70px #00000025; background: var(--paper); } +.sidebar { min-height: 0; background: #222222; border-right: 1px solid var(--border); display: flex; flex-direction: column; padding: 29px 19px 0; } +.sidebar-top { display: flex; align-items: center; justify-content: space-between; padding: 0 9px; } +.sidebar .brand { font-size: 28px; } +.sidebar .brand-mark { width: 32px; height: 32px; border-radius: 10px; } +.sidebar-heading { display: flex; justify-content: space-between; align-items: center; padding: 35px 9px 22px; } +.sidebar-heading .eyebrow { font-size: 9px; letter-spacing: 1.7px; } +.sidebar-heading h2 { margin: 6px 0 0; font-size: 22px; font-weight: 650; letter-spacing: -.7px; } +.count { font-size: 11px; font-weight: 600; background: #ffe13516; border: 1px solid #ffe13525; border-radius: 7px; margin-left: 9px; padding: 3px 7px; vertical-align: middle; color: var(--accent); } +.count:empty { display: none; } +.search-field { display: flex; align-items: center; background: #2d2d2b; border: 1px solid #414139; border-radius: 12px; margin: 0 9px 22px; padding: 0 11px; gap: 8px; } +.search-field > span:not(.visually-hidden) { font-size: 25px; line-height: 1; color: var(--muted); } +.search-field input { border: 0; background: transparent; padding: 12px 0; font-size: 12px; box-shadow: none; } +.search-field:focus-within { border-color: var(--accent); } +.chat-list { flex: 1; overflow: auto; min-height: 0; scrollbar-width: thin; scrollbar-color: #646451 transparent; } +.chat-row { display: flex; align-items: center; gap: 13px; position: relative; border: 1px solid transparent; background: transparent; text-align: left; padding: 15px 11px; width: 100%; border-radius: 14px; color: var(--ink); margin-bottom: 6px; transition: background .18s, border-color .18s; } +.chat-row:hover { background: #2e2e29; } +.chat-row.active { background: #ffe1350f; border-color: #ffe13540; } +.chat-row.active::after { content: ""; position: absolute; right: 11px; height: 6px; width: 6px; border-radius: 50%; background: var(--accent); box-shadow: 0 0 0 4px #ffe1350b; } +.avatar { display: flex; align-items: center; justify-content: center; width: 43px; height: 43px; border-radius: 14px; background: #45432a; color: var(--accent); font-size: 14px; font-weight: 650; flex-shrink: 0; letter-spacing: -.5px; border: 1px solid #ffe1351a; } +.avatar.tone-1 { background: #4b3e2a; color: #ffd68a; border-color: #ffd68a20; } +.avatar.tone-2 { background: #3b4032; color: #d9df9d; border-color: #d9df9d20; } +.avatar.tone-3 { background: #493b36; color: #edc5a5; border-color: #edc5a520; } +.chat-row.active .avatar { background: var(--accent); color: #262626; border-color: transparent; } +.chat-row-text { display: grid; gap: 6px; min-width: 0; flex: 1; } +.chat-row strong { font-size: 13px; font-weight: 600; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; padding-right: 10px; } +.chat-row small { font-size: 11px; color: var(--muted); } +.list-empty { font-size: 12px; text-align: center; line-height: 1.7; color: var(--muted); padding: 20px 15px; } +.profile { border-top: 1px solid var(--border); display: flex; align-items: center; gap: 6px; margin-top: 12px; padding: 20px 7px; } +.profile-main { display: flex; align-items: center; gap: 11px; text-align: left; background: none; border: 0; padding: 0; min-width: 0; flex: 1; color: var(--ink); } +.profile .avatar { border-radius: 50%; background: #39392c; color: var(--accent); width: 37px; height: 37px; font-size: 12px; } +.profile-text { display: grid; gap: 5px; min-width: 0; } +.profile-text strong { font-size: 12px; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; font-weight: 600; } +.profile-text > span { font-size: 10px; color: var(--muted); overflow: hidden; text-overflow: ellipsis; white-space: nowrap; } +.workspace { min-width: 0; min-height: 0; position: relative; background: var(--paper); } +.welcome { height: 100%; display: flex; align-items: center; justify-content: center; flex-direction: column; text-align: center; position: relative; padding: 35px; background: radial-gradient(ellipse at center, #ffe13505, transparent 70%); } +.welcome-symbol { width: 110px; height: 110px; background: #ffe1350b; border: 1px solid #ffe13529; border-radius: 34px; position: relative; display: flex; align-items: center; justify-content: center; margin-bottom: 34px; transform: rotate(-6deg); } +.welcome-symbol svg { width: 44px; height: 44px; color: var(--accent); stroke-width: 1.4; transform: rotate(6deg); } +.tiny-dot { position: absolute; width: 17px; height: 17px; right: -4px; top: 4px; border-radius: 50%; background: var(--accent); border: 4px solid var(--paper); } +.welcome .eyebrow { font-size: 9px; letter-spacing: 1.5px; } +.welcome h1 { font-weight: 650; font-size: 43px; letter-spacing: -1.7px; line-height: 1.2; margin: 18px 0; } +.welcome p { font-size: 13px; line-height: 1.8; color: var(--muted); margin: 0 0 27px; } +.welcome .button svg { width: 17px; height: 17px; } +.welcome-bottom { position: absolute; bottom: 30px; font-size: 10px; color: var(--muted); letter-spacing: .4px; } +.conversation { height: 100%; display: flex; flex-direction: column; } +.chat-header { display: flex; align-items: center; gap: 14px; padding: 21px 30px; border-bottom: 1px solid var(--border); min-height: 90px; background: #292929; } +.chat-header .chat-avatar { height: 43px; width: 43px; } +.chat-heading { flex: 1; min-width: 0; } +.chat-heading h2 { font-size: 17px; font-weight: 650; margin: 0 0 6px; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; letter-spacing: -.3px; } +.chat-heading span { font-size: 11px; color: var(--muted); } +.message-region { position: relative; flex: 1; min-height: 0; display: flex; } +.message-scroll { flex: 1; min-height: 0; overflow: auto; padding: 12px 32px 24px; scrollbar-width: thin; scrollbar-color: #646451 transparent; scroll-behavior: auto; background: radial-gradient(ellipse at 100% 100%, #ffe13504, transparent 70%); } +.history-control { text-align: center; min-height: 18px; } +.message-list { display: flex; flex-direction: column; gap: 14px; } +.date-separator { align-self: center; background: #30302c; border: 1px solid #414139; border-radius: 20px; padding: 6px 12px; text-align: center; color: var(--muted); font-size: 10px; letter-spacing: .3px; margin: 20px 0 12px; } +.message { max-width: 76%; align-self: flex-start; display: grid; gap: 6px; } +.message.mine { align-self: flex-end; } +.message-author { font-size: 10px; color: var(--muted); padding-left: 8px; } +.message-bubble { background: #343430; border: 1px solid #46463b; border-radius: 17px 17px 17px 5px; padding: 13px 16px 10px; min-width: 90px; box-shadow: 0 4px 14px #00000008; } +.mine .message-bubble { background: var(--accent); color: #262626; border: 1px solid var(--accent); border-radius: 17px 17px 5px 17px; } +.message-text { font-size: 14px; white-space: pre-wrap; overflow-wrap: anywhere; line-height: 1.65; margin: 0; } +.message-time { font-size: 10px; display: block; text-align: right; color: var(--muted); margin-top: 7px; } +.mine .message-time { color: #5c5324; } +.empty-conversation { text-align: center; position: relative; top: 28%; font-size: 13px; color: var(--muted); line-height: 1.9; } +.composer { display: grid; grid-template-columns: minmax(0,1fr) 46px; gap: 10px; align-items: end; border-top: 1px solid var(--border); padding: 20px 29px 16px; background: #292929; } +.composer textarea { border: 1px solid #4b4b42; background: #30302d; border-radius: 13px; padding: 13px 15px; font-size: 14px; resize: none; max-height: 140px; min-height: 47px; scrollbar-width: thin; } +.send-button { display: flex; align-items: center; justify-content: center; background: var(--accent); border: 0; color: #262626; width: 46px; height: 47px; border-radius: 13px; margin-bottom: 1px; transition: background .18s; } +.send-button:hover { background: var(--accent-hover); } +.send-button:disabled { background: #444439; opacity: 1; color: #abab95; } +.send-button svg { height: 21px; width: 21px; } +.composer-note { grid-column: 1/-1; display: flex; justify-content: space-between; font-size: 9px; color: var(--muted); padding: 2px 3px; gap: 15px; } +.composer-note .over-limit { color: var(--danger); } +.mobile-only { display: none; } +.toast { position: fixed; bottom: 27px; left: 50%; transform: translateX(-50%); background: var(--accent); color: #262626; border: 1px solid #ffec7d; box-shadow: 0 8px 35px #00000030; border-radius: 13px; padding: 13px 20px; font-size: 12px; line-height: 1.5; max-width: min(90%,520px); z-index: 20; } +.toast.error { background: #452f2d; color: var(--danger); border-color: #70453e; } + +/* Dialogs */ +dialog { border: 1px solid #575744; border-radius: 22px; padding: 28px; max-width: 440px; width: calc(100% - 36px); color: var(--ink); background: #2c2c2a; box-shadow: 0 24px 100px #00000060; } +dialog::backdrop { background: #151515aa; backdrop-filter: blur(6px); } +.dialog-heading { display: flex; align-items: center; justify-content: space-between; gap: 15px; } +.dialog-heading h2 { font-size: 25px; font-weight: 650; letter-spacing: -.8px; margin: 0; } +.dialog-heading .icon-button { width: 30px; height: 30px; } +dialog .muted { font-size: 12px; margin: 14px 0 25px; } +dialog form { display: grid; gap: 20px; } +.dialog-actions { display: flex; justify-content: flex-end; gap: 10px; margin-top: 3px; } +#my-id { font-size: 12px; font-family: ui-monospace, monospace; background: #242424; } +#profile-dialog .wide { margin-top: 17px; } +.members-list { display: grid; gap: 16px; padding-top: 25px; } +.member-item { display: grid; gap: 8px; } +.member-item strong { font-size: 13px; font-weight: 550; } +.member-item code { font-size: 11px; overflow-wrap: anywhere; color: var(--muted); background: #242424; border: 1px solid var(--border); padding: 12px; border-radius: 10px; } + +/* Optional API explanation panel */ +.diagnostics-toggle { display: flex; align-items: center; justify-content: center; gap: 8px; background: transparent; border: 1px solid #515143; border-radius: 11px; padding: 11px 12px; color: var(--muted); font-size: 11px; font-weight: 550; } +.diagnostics-toggle svg { width: 15px; height: 15px; } +.diagnostics-toggle:hover, .diagnostics-toggle[aria-expanded=true] { background: #ffe1350d; border-color: #ffe13565; color: var(--accent); } +.auth-bottom .diagnostics-toggle { margin: 15px auto 0; } +.sidebar-diagnostics { margin: 10px 9px 0; flex-shrink: 0; } +.diagnostics-panel { position: fixed; z-index: 15; right: 30px; top: 108px; width: 330px; max-height: min(56svh,490px); overflow: auto; background: #2c2c2a; border: 1px solid #66603a; border-radius: 20px; box-shadow: 0 18px 55px #00000030; padding: 20px; scrollbar-width: thin; scrollbar-color: #646451 transparent; } +.diagnostics-heading { display: flex; justify-content: space-between; align-items: center; gap: 10px; margin-bottom: 18px; } +.diagnostics-heading .eyebrow { font-size: 9px; letter-spacing: 1.4px; } +.diagnostics-heading h2 { font-size: 19px; font-weight: 650; letter-spacing: -.5px; margin: 5px 0 0; } +.diagnostics-heading .icon-button { width: 30px; height: 30px; } +.diagnostics-label { display: block; font-size: 10px; color: var(--muted); margin-bottom: 6px; } +.diagnostics-summary { display: grid; grid-template-columns: minmax(0,1fr) auto; gap: 14px; background: #ffe1350c; border: 1px solid #ffe13520; border-radius: 12px; padding: 12px; } +.diagnostics-summary strong { display: block; font-size: 11px; overflow-wrap: anywhere; } +.diagnostics-history { padding: 16px 0; border-bottom: 1px solid var(--border); } +.diagnostics-history > strong { display: block; font-size: 13px; overflow-wrap: anywhere; } +.diagnostics-history > p { font-size: 11px; color: var(--muted); margin: 8px 0 0; } +.diagnostics-request { padding-top: 16px; } +.diagnostics-section-heading { display: flex; align-items: center; justify-content: space-between; gap: 10px; margin-bottom: 12px; } +.diagnostics-section-heading h3 { font-size: 12px; margin: 0; font-weight: 600; } +.diagnostics-section-heading time { font-size: 10px; color: var(--muted); } +.diagnostics-request-line { display: flex; align-items: center; gap: 8px; } +.diagnostics-method, .diagnostics-status { font: 600 11px ui-monospace, monospace; padding: 6px 8px; border-radius: 6px; background: #404036; color: var(--accent); } +.diagnostics-status { background: var(--accent); color: #262626; } +.diagnostics-status.failed { background: #56332e; color: var(--danger); } +.diagnostics-path { display: block; font: 11px/1.6 ui-monospace, monospace; overflow-wrap: anywhere; color: var(--muted); margin-top: 10px; } +.diagnostics-result { font-size: 12px; line-height: 1.6; color: var(--accent); margin: 10px 0 14px; } +.diagnostics-result.failed { color: var(--danger); } +.diagnostics-metrics { display: grid; grid-template-columns: 1fr 1fr; margin: 0 0 14px; gap: 12px; } +.diagnostics-metrics dt { font-size: 10px; color: var(--muted); margin-bottom: 6px; } +.diagnostics-metrics dd { font: 550 12px ui-monospace, monospace; margin: 0; color: var(--ink); } +.diagnostics-request-id { display: block; font: 10px/1.7 ui-monospace, monospace; overflow-wrap: anywhere; color: var(--muted); } +.diagnostics-previous { list-style: none; margin: 15px 0 0; padding: 12px 0 0; border-top: 1px solid var(--border); display: grid; gap: 10px; } +.diagnostics-previous li { display: flex; gap: 8px; align-items: center; min-width: 0; } +.diagnostics-mini-status { font: 550 10px ui-monospace, monospace; color: var(--accent); min-width: 23px; } +.diagnostics-mini-status.failed { color: var(--danger); } +.diagnostics-previous code { font: 10px ui-monospace, monospace; color: var(--muted); white-space: nowrap; overflow: hidden; text-overflow: ellipsis; } +.diagnostics-background { font-size: 10px; color: var(--muted); margin: 12px 0 0; line-height: 1.7; } +.diagnostics-note { font-size: 11px; color: var(--muted); line-height: 1.7; margin: 0; } +.diagnostics-footnote { border-top: 1px solid var(--border); padding-top: 12px; margin-top: 14px; font-size: 10px; } + +@media (min-width: 1490px) { + .app-shell { height: calc(100svh - 64px); margin: 32px auto; } +} +@media (max-width: 1100px) { + .intro { padding: 40px 38px; } + .auth-side { padding: 40px 35px; } + .app-shell { margin: 14px; height: calc(100svh - 28px); grid-template-columns: 280px minmax(0,1fr); } + .conversation-art { margin-left: 0; width: 290px; } + .intro h1 { font-size: 56px; } + .sidebar { padding-left: 14px; padding-right: 14px; } + .message-scroll { padding-left: 24px; padding-right: 24px; } +} +@media (max-width: 720px) { + .auth-layout { display: block; } + .intro { min-height: 0; padding: 28px; } + .intro-copy { margin-top: 30px; } + .intro h1 { font-size: 42px; letter-spacing: -2px; line-height: 1.08; margin: 14px 0 0; } + .intro h1 br { display: none; } + .intro-copy .eyebrow { font-size: 9px; } + .intro-copy p, .conversation-art, .intro-footer { display: none; } + .auth-side { min-height: 0; padding: 30px 28px; align-items: center; border-left: 0; border-top: 1px solid var(--border); } + .auth-card { max-width: 440px; } + .auth-switch { margin-bottom: 28px; } + .auth-card h2 { font-size: 32px; } + .auth-card h2 br { display: none; } + .auth-card .muted { margin-bottom: 22px; } + .auth-card form { gap: 17px; } + .auth-bottom { margin-top: 20px; } + .app-shell { margin: 0; border: 0; border-radius: 0; height: 100svh; display: block; } + .sidebar { height: 100%; width: 100%; padding: 25px 18px 0; border: 0; } + .sidebar-heading { padding-top: 30px; } + .workspace { display: none; height: 100%; } + .app-shell.chat-open .sidebar { display: none; } + .app-shell.chat-open .workspace { display: block; } + .welcome { display: none; } + .mobile-only { display: flex; } + .chat-header { padding: 15px; gap: 7px; min-height: 75px; } + .chat-header .avatar { width: 35px; height: 35px; border-radius: 11px; } + .chat-heading h2 { font-size: 14px; } + .chat-header .icon-button { width: 31px; height: 31px; } + .chat-header .icon-button svg { width: 19px; height: 19px; } + .message-scroll { padding: 10px 16px 20px; } + .message { max-width: 88%; } + .composer { padding: 14px 16px max(13px, env(safe-area-inset-bottom)); } + .composer-note { font-size: 9px; } + .composer-note > span:first-child { max-width: 70%; } + .profile { padding-bottom: max(18px, env(safe-area-inset-bottom)); } + .toast { bottom: 20px; } + .diagnostics-panel { top: 83px; right: 12px; width: calc(100% - 24px); max-height: 52svh; padding: 16px; } + .sidebar-diagnostics { margin-top: 9px; } +} +@media (min-width: 721px) { + body:not(.has-session) .diagnostics-panel { right: 24px; left: auto; } +} +@media (min-width: 1100px) { + .diagnostics-open.has-session .app-shell { margin-left: 22px; margin-right: 380px; } + .diagnostics-open.has-session .diagnostics-panel { top: 22px; max-height: calc(100svh - 44px); } +} +@media (prefers-reduced-motion: reduce) { + * { transition: none !important; scroll-behavior: auto !important; } +} + +/* Password controls and the animated SVG character. */ +.password-field { position: relative; display: block; } +.password-field input { padding-right: 47px; } +.password-toggle { position: absolute; right: 7px; top: 7px; width: 33px; height: 33px; border: 0; background: transparent; border-radius: 9px; color: var(--muted); display: flex; align-items: center; justify-content: center; } +.password-toggle:hover, .password-toggle[aria-pressed=true] { color: var(--accent); background: #ffe1350c; } +.password-toggle svg { width: 18px; height: 18px; } +/* One SVG mascot; CSS handles poses and the browser handles animation frames. */ +.mascot-stage { position: relative; width: 350px; max-width: 100%; height: 280px; margin: 20px 0 0 5px; pointer-events: none; isolation: isolate; --scene-surface: #262626; --gaze-x: 0px; --gaze-y: 0px; } +.spirit-svg { stroke: none; position: absolute; left: 0; bottom: 0; width: 285px; height: 285px; overflow: visible; z-index: 2; } +.spirit-motion { animation: spirit-breathe 4.5s ease-in-out infinite; } +.spirit-lean { transform-origin: 150px 268px; transition: transform .65s cubic-bezier(.22,1,.36,1); } +.spirit-eye { transform-box: fill-box; transform-origin: center; animation: spirit-blink 7s infinite; } +.spirit-eye-right { animation-delay: .1s; } +.spirit-pupil { transform: translate(var(--gaze-x), var(--gaze-y)); transition: transform .16s ease-out; } +.spirit-hand { transform-box: view-box; transition: transform .55s cubic-bezier(.22,1,.36,1); } +.spirit-gasp { opacity: 0; } +.mascot-stage[data-mood=looking] .spirit-lean { transform: translate(8px,-3px) rotate(3deg); } +.mascot-stage.is-curious .spirit-motion { animation: spirit-step .42s ease-in-out 3; } +.mascot-stage:is([data-mood=private],[data-mood=short],[data-mood=revealed]) .spirit-lean { transform: rotate(-4deg); } +.mascot-stage:is([data-mood=private],[data-mood=short],[data-mood=revealed]) .spirit-hand-left { transform: translate(28px,-37px) rotate(3deg); } +.mascot-stage:is([data-mood=private],[data-mood=short]) .spirit-hand-right { transform: translate(-28px,-25px) rotate(-3deg); } +.mascot-stage:is([data-mood=private],[data-mood=short]) .spirit-eye { animation: none; scale: 1 .08; } +.mascot-stage[data-mood=revealed] .spirit-hand-right { transform: translate(-28px,-39px) rotate(-3deg); } +.mascot-stage[data-mood=revealed] .spirit-eye { animation: none; scale: 1 .08; } +.mascot-stage[data-mood=pending] .spirit-motion { animation: spirit-breathe 1.1s ease-in-out infinite; } +.mascot-stage[data-mood=error] .spirit-motion { animation: spirit-shake .4s ease-in-out 2; } +.mascot-stage[data-mood=success] .spirit-motion { animation: spirit-hop .65s ease-in-out; } +.mascot-stage.is-sleepy .spirit-eye { animation: none; scale: 1 .2; } +.mascot-stage.is-sleepy .spirit-lean { transform: rotate(-5deg); } +.mascot-stage.is-scared .spirit-motion { animation: spirit-shake .25s ease-in-out infinite; } +.mascot-stage.is-scared :is(.spirit-smile,.kolo-tooth) { opacity: 0; } +.mascot-stage.is-scared .spirit-gasp { opacity: 1; } +.mascot-stage:not(.is-visible) * { animation-play-state: paused; } +.mascot-conversation { position: absolute; inset: 0; z-index: 0; } +.mascot-bubble { position: absolute; border-radius: 17px; animation: spirit-float 5s ease-in-out infinite; } +.mascot-bubble-filled { left: 247px; top: 20px; width: 88px; height: 50px; background: var(--accent); display: flex; align-items: center; justify-content: center; gap: 6px; rotate: -6deg; } +.mascot-bubble-filled::after { content: ""; position: absolute; bottom: -7px; left: 18px; width: 17px; height: 17px; background: var(--accent); clip-path: polygon(0 0,100% 0,0 100%); } +.mascot-bubble-filled span { width: 5px; height: 5px; border-radius: 50%; background: #262626; animation: spirit-typing 1.8s ease-in-out infinite; } +.mascot-bubble-filled span:nth-child(2) { animation-delay: .16s; } +.mascot-bubble-filled span:nth-child(3) { animation-delay: .32s; } +.mascot-bubble-outline { left: 265px; top: 107px; width: 77px; height: 55px; border: 1.5px solid #ffe13555; background: var(--scene-surface); rotate: 7deg; animation-delay: -2.5s; padding: 18px 15px; } +.mascot-bubble-outline::after { content: ""; position: absolute; bottom: -6px; right: 16px; width: 11px; height: 11px; border-right: 1.5px solid #ffe13555; border-bottom: 1.5px solid #ffe13555; background: var(--scene-surface); rotate: 45deg; } +.mascot-bubble-outline i { display: block; height: 2px; width: 100%; margin-bottom: 8px; border-radius: 2px; background: #ffe13555; } +.mascot-bubble-outline i:last-child { width: 65%; } +@keyframes spirit-breathe { 0%,100% { transform: translateY(0); } 50% { transform: translateY(-3px); } } +@keyframes spirit-step { 0%,100% { transform: translateY(0); } 50% { transform: translateY(-6px); } } +@keyframes spirit-blink { 0%,42%,46%,100% { scale: 1 1; } 44% { scale: 1 .08; } } +@keyframes spirit-peek { 0%,20%,76%,100% { scale: 1 .12; } 30%,66% { scale: 1 1; } } +@keyframes spirit-shake { 0%,100% { transform: translateX(0); } 25% { transform: translateX(-3px); } 75% { transform: translateX(3px); } } +@keyframes spirit-hop { 0%,100% { transform: translateY(0); } 25% { transform: translateY(3px); } 60% { transform: translateY(-15px); } } +@keyframes spirit-float { 0%,100% { translate: 0 0; } 50% { translate: 0 -5px; } } +@keyframes spirit-typing { 0%,55%,100% { translate: 0 0; opacity: .4; } 28% { translate: 0 -3px; opacity: 1; } } + +.scenario-section { padding: 17px 0 15px; border-bottom: 1px solid var(--border); } +.scenario-section h3 { font-size: 13px; margin: 0 0 9px; } +.scenario-description { font-size: 10px; line-height: 1.7; color: var(--muted); margin: 0 0 12px; } +.scenario-actions { display: grid; gap: 8px; } +.scenario-actions .button { padding: 11px 10px; font-size: 11px; } +.scenario-status { font-size: 11px; line-height: 1.6; margin: 12px 0 0; color: var(--ink); } +.scenario-status.failed { color: var(--danger); } +.scenario-scope { margin: 12px 0 0; } +.scenario-steps { list-style: none; padding: 0; margin: 12px 0 0; display: grid; gap: 8px; max-height: 245px; overflow: auto; scrollbar-width: thin; scrollbar-color: #646451 transparent; } +.scenario-step { border: 1px solid var(--border); border-radius: 10px; background: #262626; padding: 10px; } +.scenario-step[data-state=failed] { border-color: #9a5b51; } +.scenario-step summary { display: flex; align-items: flex-start; gap: 8px; cursor: pointer; font-size: 11px; line-height: 1.5; list-style: none; } +.scenario-step summary::before { content: "▸"; color: var(--muted); } +.scenario-step[open] summary::before { content: "▾"; } +.scenario-step summary::-webkit-details-marker { display: none; } +.scenario-step-badge { flex-shrink: 0; color: var(--accent); font: 650 10px/1.65 ui-monospace, monospace; } +.scenario-step[data-state=failed] .scenario-step-badge { color: var(--danger); } +.scenario-step[data-state=pending] .scenario-step-badge { color: var(--muted); } +.scenario-step p { color: var(--muted); font-size: 10px; line-height: 1.7; margin: 9px 0 0; } +.scenario-step code { display: block; color: var(--muted); font: 10px/1.7 ui-monospace, monospace; overflow-wrap: anywhere; margin-top: 7px; } +@media (max-width: 720px) { + .auth-card .mascot-stage { width: 100%; height: 166px; margin: -14px auto 14px; --scene-surface: #2c2c2a; } + .spirit-svg { width: 178px; height: 178px; left: calc(50% - 105px); } + .mascot-bubble { border-radius: 13px; } + .mascot-bubble-filled { left: calc(50% + 45px); top: 9px; width: 58px; height: 34px; gap: 4px; } + .mascot-bubble-filled span { width: 4px; height: 4px; } + .mascot-bubble-filled::after { width: 12px; height: 12px; bottom: -5px; left: 13px; } + .mascot-bubble-outline { left: calc(50% + 52px); top: 66px; width: 54px; height: 40px; padding: 13px 10px; } + .mascot-bubble-outline i { margin-bottom: 6px; } + .mascot-bubble-outline::after { width: 8px; height: 8px; bottom: -5px; right: 12px; } + .intro h1 { font-size: 36px; } + .intro { padding-bottom: 18px; } + .scenario-steps { max-height: 175px; } +} +.diagnostics-origin { margin-top: 10px; } + +.auth-card form { margin-top: 24px; } +.auth-card .muted + form { margin-top: 0; } +.diagnostics-help { border-top: 1px solid var(--border); margin-top: 14px; padding-top: 12px; } +.diagnostics-help summary { color: var(--muted); font-size: 10px; cursor: pointer; } +.diagnostics-help .diagnostics-note { margin-top: 10px; font-size: 10px; } +@media (prefers-reduced-motion: reduce) { + .mascot-stage *, .mascot-stage *::before { animation: none !important; transition: none !important; } +} + +/* Keep the reader's position while messages arrive below. */ +.jump-latest { position: absolute; right: 24px; bottom: 16px; border: 1px solid #ffe13555; background: #36362d; color: var(--accent); padding: 10px 15px; border-radius: 20px; font-size: 12px; box-shadow: 0 5px 20px #0004; z-index: 2; } +.jump-latest:hover { background: #424234; } +.message.grouped { margin-top: -9px; } +.message.grouped .message-bubble { border-top-left-radius: 8px; } +.message.mine.grouped .message-bubble { border-top-left-radius: 17px; border-top-right-radius: 8px; } +@media (max-width: 720px) { .jump-latest { right: 14px; bottom: 12px; } } + +.welcome-illustration { width: 260px; max-width: 75%; height: auto; margin-bottom: 12px; } +.welcome h1 { font-size: 38px; margin: 14px 0; } +.empty-conversation { top: auto; padding: 35px 16px; color: #d6d6c9; } +.empty-conversation img { width: 165px; max-width: 70%; height: auto; } +.empty-conversation p { color: var(--ink); font-size: 16px; margin: 15px 0 8px; } +.empty-conversation span { color: var(--muted); font-size: 12px; } +.message-bubble { color: #e5e5dc; } +.mine .message-bubble { color: #262626; } +.composer-note { font-size: 10px; line-height: 1.5; } +@media (max-width: 720px) { .welcome-illustration { width: 200px; } .welcome h1 { font-size: 32px; } } +.message-scroll { background-image: url('/assets/chat-pattern.svg'); background-size: 180px 160px; } + +/* Head, ears and mushrooms remain independent of the body. */ +.kolo-head { transform-origin: 151px 202px; transition: transform .65s cubic-bezier(.22,1,.36,1); } +.kolo-ear { transform-origin: 150px 135px; transition: transform .7s ease; } +.kolo-mushrooms { transform-origin: 153px 83px; animation: kolo-sway 6s ease-in-out infinite; } +.mascot-stage[data-mood=looking] .kolo-head { transform: rotate(4deg) translate(3px,-2px); } +.mascot-stage[data-mood=looking] .kolo-ear-right { transform: rotate(-3deg); } +.mascot-stage:is([data-mood=private],[data-mood=short],[data-mood=revealed]) .kolo-head { transform: translate(-5px,2px) rotate(-9deg); } +.mascot-stage:is([data-mood=private],[data-mood=short],[data-mood=revealed]) .spirit-face { opacity: .65; } +.mascot-stage[data-mood=success] .kolo-ear { transform: rotate(-3deg); } +.mascot-stage.is-sleepy .kolo-head { transform: rotate(-6deg) translateY(3px); } +.auth-error-art { float: right; width: 66px; height: 66px; object-fit: contain; margin: 10px 0 0 10px; } +.state-error { text-align: center; padding: 28px 18px; color: var(--muted); } +.state-error img { width: 160px; max-width: 65%; height: auto; } +.state-error h2, .state-error h3 { color: var(--ink); font-size: 19px; font-weight: 600; margin: 14px 0 10px; } +.state-error p { font-size: 12px; line-height: 1.7; margin: 0 0 18px; } +.state-error .button { font-size: 12px; padding: 11px 18px; } +.welcome.state-error { height: 100%; } +@keyframes kolo-sway { 0%,100% { transform: rotate(-1deg); } 50% { transform: rotate(2deg); } } +@media (max-width: 720px) { + .state-error img { width: 130px; } + .welcome-illustration { width: 200px; max-height: 24svh; object-fit: contain; } +} +@media (prefers-reduced-motion: reduce) { + .kolo-mushrooms { animation: none; } +} + +.message-scroll:has(> :is(.empty-conversation,.state-error):not([hidden])) { display: flex; flex-direction: column; } +.message-scroll > :is(.empty-conversation,.state-error) { margin: auto 0; } diff --git a/src/Messenger.Api/wwwroot/app.js b/src/Messenger.Api/wwwroot/app.js new file mode 100644 index 00000000..2d495012 --- /dev/null +++ b/src/Messenger.Api/wwwroot/app.js @@ -0,0 +1,703 @@ +import { attachmentSession } from '/attachments.js'; +import { recordRequest, updateSessionInfo, updateHistoryInfo } from "/diagnostics.js"; + +import { setMascotMood, celebrateMascots } from "/mascots.js"; +import { MessageView } from "/message-view.js"; +import { paintAvatar } from "/avatars.js"; +import { startClusterView } from '/cluster-view.js'; + +const $ = id => document.getElementById(id); +const storageKey = "n1k0der.session"; +const messageView = new MessageView($("message-list")); +const state = { session: null, chats: [], chatsStatus: "loading", chatsCursor: null, current: null, messages: new Map(), + serverIds: new Set(), members: new Map(), olderCursor: null, historyReady: false, epoch: 0, syncing: false, sending: false, drafts: new Map() }; +let toastTimer, unseenMessages = 0; +const pendingMessages = new Map(); +const attachedDrafts = new Map(); +let uploadBusy = false; +const chatRows = new Map(); +let chatsLoading = false, lastChatRefresh = 0; +const reactions = new Map(), reactionBusy = new Set(); +let reactionVersion = 0; + +class ApiError extends Error { + constructor(message, status = 0) { super(message); this.status = status; } +} + +function notice(id, message, success = false) { + const element = $(id); + element.textContent = message; + element.hidden = !message; + element.classList.toggle("success", success); +} + +function toast(message, error = false) { + clearTimeout(toastTimer); + $("toast").textContent = message; + $("toast").classList.toggle("error", error); + $("toast").hidden = false; + toastTimer = setTimeout(() => { $("toast").hidden = true; }, error ? 6500 : 3000); +} + +async function request(path, { method = "GET", body, headers = {}, auth = true, background = false, raw } = {}) { + const started = performance.now(); + let httpStatus = null, requestId = null, instanceId = null, outcome = "network"; + const controller = new AbortController(); + const timer = setTimeout(() => controller.abort(), raw ? 90000 : 12000); + // Authorization is explicit; disable the browser's implicit Basic-auth handling. + const options = { method, headers: { Accept: "application/json", ...headers }, signal: controller.signal, cache: "no-store", credentials: "omit" }; + if (auth && state.session) options.headers.Authorization = "Bearer " + state.session.token; + if (body !== undefined) { + options.body = JSON.stringify(body); + options.headers["Content-Type"] = "application/json"; + } + if (raw !== undefined) options.body = raw; + try { + const response = await fetch(path, options); + httpStatus = response.status; + requestId = response.headers.get("X-Request-Id"); + instanceId = response.headers.get("X-Instance-Id"); + outcome = "unreadable"; + const data = response.status === 204 ? null : await response.json(); + outcome = response.ok ? "success" : "http_error"; + if (!response.ok) { + if (response.status === 401 && auth) endSession("Сессия закончилась. Войдите снова."); + throw new ApiError(data?.error?.message || "Не удалось выполнить запрос.", response.status); + } + return data; + } catch (error) { + if (error instanceof ApiError) throw error; + throw new ApiError("Нет ответа от сервера. Проверьте соединение и попробуйте позже."); + } finally { + clearTimeout(timer); + recordRequest({ method, path, status: httpStatus, requestId, instanceId, outcome, background, + durationMs: Math.round(performance.now() - started), + authorization: options.headers.Authorization?.split(" ")[0] || "Без авторизации" }); + } +} + +function basic(username, password) { + const bytes = new TextEncoder().encode(username + ":" + password); + return "Basic " + btoa(Array.from(bytes, byte => String.fromCharCode(byte)).join("")); +} + +function selectAuthTab(register) { + $("register-panel").hidden = !register; + $("login-panel").hidden = register; + $("tab-register").classList.toggle("active", register); + $("tab-login").classList.toggle("active", !register); + $("tab-register").setAttribute("aria-pressed", String(register)); + $("tab-login").setAttribute("aria-pressed", String(!register)); + notice("auth-notice", ""); +} + +function setFormBusy(form, busy) { + form.querySelectorAll("input, textarea, button").forEach(element => { element.disabled = busy; }); +} + +function persistSession(session) { + try { sessionStorage.setItem(storageKey, JSON.stringify(session)); } catch { /* session still works in memory */ } +} + +async function enterSession(session) { + reactions.clear(); reactionBusy.clear(); reactionVersion++; + state.epoch++; + state.session = session; + attachmentSession(session.token); + clearAttachedDrafts(); + updateSessionInfo({ name: session.user.display_name, expiresAt: session.expires_at }); + updateHistoryInfo(null); + state.current = null; + state.messages.clear(); + state.serverIds.clear(); + state.chats = []; + chatRows.clear(); + state.chatsStatus = "loading"; + state.chatsCursor = null; + state.drafts.clear(); + state.syncing = false; + state.sending = false; + persistSession(session); + $("auth-screen").hidden = true; + $("app-screen").hidden = false; + $("app-screen").classList.remove("chat-open"); + $("welcome").hidden = false; + $("workspace-error").hidden = true; + $("conversation-error").hidden = true; + $("conversation").hidden = true; + $("profile-name").textContent = session.user.display_name; + $("profile-username").textContent = "@" + session.user.username; + paintAvatar($("profile-avatar"), session.user.id, session.user.display_name); + $("chat-search").value = ""; + renderChats(); + try { await loadChats(false, true); } catch (error) { + if (state.session?.token === session.token) { $("welcome").hidden = true; $("workspace-error").hidden = false; } + } +} + +function endSession(message = "") { + reactions.clear(); reactionBusy.clear(); reactionVersion++; + state.epoch++; + state.session = null; + attachmentSession(null); + clearAttachedDrafts(); + updateSessionInfo(null); + updateHistoryInfo(null); + state.current = null; + state.chats = []; + chatRows.clear(); + state.messages.clear(); + state.serverIds.clear(); + state.drafts.clear(); + pendingMessages.clear(); + try { sessionStorage.removeItem(storageKey); } catch { /* storage unavailable */ } + document.querySelectorAll("dialog[open]").forEach(dialog => dialog.close()); + messageView.clear(); + unseenMessages = 0; + updateJumpButton(); + $("chat-list").replaceChildren(); + $("message-input").value = ""; + $("app-screen").hidden = true; + $("auth-screen").hidden = false; + $("login-password").value = ""; + selectAuthTab(false); + notice("auth-notice", message); +} + +$("tab-login").addEventListener("click", () => selectAuthTab(false)); +$("tab-register").addEventListener("click", () => selectAuthTab(true)); + +$("login-form").addEventListener("submit", async event => { + event.preventDefault(); + const form = event.currentTarget; + const username = $("login-username").value.trim(); + const password = $("login-password").value; + setFormBusy(form, true); + setMascotMood("pending"); + notice("auth-notice", ""); + try { + const session = await request("/api/v1/auth/sessions", { method: "POST", auth: false, headers: { Authorization: basic(username, password) } }); + form.reset(); + await celebrateMascots(); + await enterSession(session); + } catch (error) { setMascotMood("error"); notice("auth-notice", error.status === 401 ? "Неверный логин или пароль." : error.message); } + finally { setFormBusy(form, false); } +}); + +$("register-form").addEventListener("submit", async event => { + event.preventDefault(); + const form = event.currentTarget; + const username = $("register-username").value.trim(); + const displayName = $("register-name").value.trim(); + const password = $("register-password").value; + if (Array.from(displayName).length > 100) return notice("auth-notice", "Имя должно содержать от 1 до 100 символов."); + if (Array.from(password).length < 12 || Array.from(password).length > 128 || !password.trim()) { + setMascotMood("short"); + return notice("auth-notice", "Пароль должен содержать от 12 до 128 символов."); + } + setFormBusy(form, true); + setMascotMood("pending"); + notice("auth-notice", ""); + let registered = false; + try { + await request("/api/v1/users", { method: "POST", auth: false, body: { username, display_name: displayName, password } }); + registered = true; + const session = await request("/api/v1/auth/sessions", { method: "POST", auth: false, headers: { Authorization: basic(username, password) } }); + form.reset(); + await celebrateMascots(); + await enterSession(session); + toast("Добро пожаловать, " + session.user.display_name + "!"); + } catch (error) { + setMascotMood("error"); + if (registered) { + form.reset(); + selectAuthTab(false); + $("login-username").value = username; + notice("auth-notice", "Аккаунт создан. Войдите, когда сервер будет доступен."); + } else notice("auth-notice", error.status === 409 ? "Это имя пользователя уже занято. Выберите другое." : error.message); + } finally { setFormBusy(form, false); } +}); + +function memberCount(count) { const n = count % 100, d = count % 10; return count + " " + (n >= 11 && n <= 14 ? "участников" : d === 1 ? "участник" : d >= 2 && d <= 4 ? "участника" : "участников"); } +function chatActivity(chat) { return chat.last_message?.created_at || chat.created_at; } +function chatTime(value) { + const date = new Date(value), now = new Date(); + return date.toDateString() === now.toDateString() + ? date.toLocaleTimeString("ru-RU", { hour: "2-digit", minute: "2-digit" }) + : date.toLocaleDateString("ru-RU", { day: "numeric", month: "short" }); +} + +async function loadChats(more = false, background = false) { + if (chatsLoading) return; + chatsLoading = true; + const token = state.session?.token; + const cursor = more ? state.chatsCursor : null; + $("chat-list").setAttribute("aria-busy", "true"); + $("refresh-chats").classList.add("is-loading"); + try { + const data = await request("/api/ui/chats?limit=100" + (cursor ? "&cursor=" + encodeURIComponent(cursor) : ""), { background }); + if (token !== state.session?.token) return; + const previous = new Map(state.chats.map(chat => [chat.id, chat])); + const incoming = data.items.map(chat => { + const existing = previous.get(chat.id)?.last_message; + return existing && (!chat.last_message || compareMessages(existing, chat.last_message) > 0) + ? { ...chat, last_message: existing } : chat; + }); + state.chats = more ? [...state.chats, ...incoming.filter(chat => !previous.has(chat.id))] : incoming; + state.chatsCursor = data.next_cursor; + state.chatsStatus = "ready"; + lastChatRefresh = Date.now(); + $("workspace-error").hidden = true; + if (!state.current) $("welcome").hidden = false; + renderChats(); + } catch (error) { + if (token === state.session?.token && !state.chats.length) { + state.chatsStatus = "error"; renderChats(); + } + throw error; + } finally { + chatsLoading = false; + $("chat-list").setAttribute("aria-busy", "false"); + $("refresh-chats").classList.remove("is-loading"); + } +} + +function renderChats() { + const query = $("chat-search").value.trim().toLocaleLowerCase("ru-RU"); + const chats = [...state.chats].sort((a, b) => chatActivity(b).localeCompare(chatActivity(a)) || b.id.localeCompare(a.id)) + .filter(chat => chat.title.toLocaleLowerCase("ru-RU").includes(query)); + $("chat-count").textContent = state.chats.length || ""; + $("more-chats").hidden = !state.chatsCursor; + const nodes = chats.map(chat => { + let row = chatRows.get(chat.id); + if (!row) { + const button = document.createElement("button"); button.className = "chat-row"; + button.dataset.chatId = chat.id; + const avatar = document.createElement("span"); avatar.className = "avatar"; + const description = document.createElement("span"); description.className = "chat-row-text"; + const heading = document.createElement("span"); heading.className = "chat-row-heading"; + const title = document.createElement("strong"), time = document.createElement("time"); + const preview = document.createElement("small"); preview.className = "chat-preview"; + heading.append(title, time); description.append(heading, preview); button.append(avatar, description); + button.addEventListener("click", () => { + const current = state.chats.find(item => item.id === chat.id); + if (current) void selectChat(current); + }); + row = { button, avatar, title, time, preview }; chatRows.set(chat.id, row); + } + row.button.classList.toggle("active", chat.id === state.current?.id); + row.button.setAttribute("aria-pressed", String(chat.id === state.current?.id)); + paintAvatar(row.avatar, chat.id, chat.title); + row.title.textContent = chat.title; + row.time.dateTime = chatActivity(chat); row.time.textContent = chatTime(chatActivity(chat)); + row.time.title = new Date(chatActivity(chat)).toLocaleString("ru-RU"); + const message = chat.last_message; + row.preview.textContent = message + ? (message.sender_id === state.session?.user.id ? "Вы: " : "") + (message.text.replace(/\s+/gu, " ").trim() || "Изображение") + : "Пока без сообщений · " + memberCount(chat.member_ids.length); + return row.button; + }); + if (!nodes.length) { + const empty = document.createElement("p"); empty.className = "list-empty"; + empty.textContent = state.chatsStatus === "loading" ? "Загружаем чаты…" : state.chatsStatus === "error" ? "Не удалось загрузить чаты." : query ? "Чаты не найдены." : "Пока нет чатов."; + nodes.push(empty); + } + const list = $("chat-list"), wanted = new Set(nodes); + for (const node of [...list.children]) if (!wanted.has(node)) node.remove(); + let next = list.firstChild; + for (const node of nodes) { + if (node === next) next = next.nextSibling; + else list.insertBefore(node, next); + } +} + +function updateChatPreview(chatId, items) { + const chat = state.chats.find(item => item.id === chatId); + const last = items.reduce((latest, message) => !latest || compareMessages(message, latest) > 0 ? message : latest, null); + if (chat && last && (!chat.last_message || compareMessages(last, chat.last_message) > 0)) { + chat.last_message = last; renderChats(); + } +} + +$("retry-chats").addEventListener("click", async () => { + const button = $("retry-chats"); button.disabled = true; + try { await loadChats(); } catch (error) { toast(error.message, true); } + finally { button.disabled = false; } +}); +$("retry-messages").addEventListener("click", async () => { + const button = $("retry-messages"); button.disabled = true; + try { await syncRecent(true); } catch (error) { toast(error.message, true); } + finally { button.disabled = false; } +}); + +$("chat-search").addEventListener("input", renderChats); +$("refresh-chats").addEventListener("click", async () => { try { await loadChats(); } catch (error) { toast(error.message, true); } }); +$("more-chats").addEventListener("click", async () => { try { await loadChats(true); } catch (error) { toast(error.message, true); } }); + +async function selectChat(chat) { + if (state.current?.id === chat.id) { $("app-screen").classList.add("chat-open"); return; } + if (state.current) state.drafts.set(state.current.id, $("message-input").value); + state.epoch++; + reactions.clear(); reactionBusy.clear(); reactionVersion++; + state.current = chat; + state.members = new Map([[state.session.user.id, state.session.user]]); + renderChats(); + state.messages = new Map(); + state.serverIds = new Set(); + state.olderCursor = null; + state.historyReady = false; + updateHistoryInfo({ title: chat.title, loaded: 0, hasOlder: false, ready: false }); + state.syncing = false; + $("current-title").textContent = chat.title; + $("current-members").textContent = memberCount(chat.member_ids.length); + paintAvatar($("current-avatar"), chat.id, chat.title); + $("welcome").hidden = true; + $("workspace-error").hidden = true; + $("conversation-error").hidden = true; + $("conversation").hidden = false; + $("app-screen").classList.add("chat-open"); + $("message-input").value = state.drafts.get(chat.id) || ""; + renderAttachedDrafts(); + updateComposer(); + messageView.clear(); + unseenMessages = 0; + updateJumpButton(); + $("empty-conversation").hidden = true; + $("older-messages").hidden = true; + $("messages-loading").hidden = false; + $("message-list").setAttribute("aria-busy", "true"); + if (!matchMedia("(prefers-reduced-motion: reduce)").matches) $("conversation").animate([{ opacity: 0, transform: "translateY(5px)" }, { opacity: 1, transform: "none" }], { duration: 180, easing: "ease-out" }); + try { await Promise.all([syncRecent(true), loadMembers(state.epoch, chat.id)]); } + catch (error) { if (state.historyReady) toast(error.message, true); } +} + +async function loadMembers(epoch, chatId) { + const data = await request(`/api/ui/chats/${chatId}/members`, { background: true }); + if (epoch !== state.epoch) return; + state.members = new Map(data.items.map(user => [user.id, user])); + if (state.historyReady) renderMessages(); +} + +function mergeMessages(items) { + let changed = false; + for (const item of items) { + const previous = state.messages.get(item.id); + if (!previous || previous.text !== item.text || previous.sender_id !== item.sender_id || previous.created_at !== item.created_at) { + state.messages.set(item.id, item); + changed = true; + } + state.serverIds.add(item.id); + } + return changed; +} + +function compareMessages(a, b) { + return a.created_at.localeCompare(b.created_at) || a.id.localeCompare(b.id); +} + +async function syncRecent(initial = false, background = false) { + if (!state.current || !state.session || state.syncing) return; + const epoch = state.epoch, chatId = state.current.id; + state.syncing = true; + try { + const page = await request(`/api/ui/chats/${chatId}/messages?limit=50`, { background }); + if (epoch !== state.epoch) return; + $("conversation-error").hidden = true; + const wasReady = state.historyReady, oldCursor = state.olderCursor; + const latest = [...state.messages.values()].reduce((last, item) => !last || compareMessages(item, last) > 0 ? item : last, null); + const incoming = initial || !latest ? 0 : page.items.filter(item => !state.messages.has(item.id) && compareMessages(item, latest) > 0).length; + const overlap = page.items.some(item => state.serverIds.has(item.id)); + state.historyReady = true; + // On a large burst, the older button pages through the newly discovered gap. + if (initial || (!overlap && page.items.length === 50)) state.olderCursor = page.next_cursor; + updateChatPreview(chatId, page.items); + const changed = mergeMessages(page.items); + if (initial || changed || !wasReady || oldCursor !== state.olderCursor) { + renderMessages(initial ? "bottom" : "preserve", incoming); + } + const visible = [...document.querySelectorAll('article.message')].filter(node => { + const rect = node.getBoundingClientRect(), region = $('message-scroll').getBoundingClientRect(); + return rect.bottom >= region.top && rect.top <= region.bottom; + }).map(node => node.dataset.messageId); + await refreshReactions([...new Set([...visible, ...page.items.map(item => item.id)])].slice(0,100)); + } catch (error) { + if (epoch === state.epoch && state.session && !state.historyReady) { + $("empty-conversation").hidden = true; + $("conversation-error").hidden = false; + } + throw error; + } finally { if (epoch === state.epoch) { + state.syncing = false; + $("messages-loading").hidden = true; + $("message-list").setAttribute("aria-busy", "false"); + } } +} + +$("older-messages").addEventListener("click", async () => { + if (!state.olderCursor || !state.current) return; + const epoch = state.epoch; + $("older-messages").disabled = true; + try { + const page = await request(`/api/ui/chats/${state.current.id}/messages?limit=50&cursor=${encodeURIComponent(state.olderCursor)}`); + if (epoch !== state.epoch) return; + mergeMessages(page.items); + state.olderCursor = page.next_cursor; + renderMessages("prepend"); + await refreshReactions(page.items.map(item => item.id)); + } catch (error) { toast(error.message, true); } + finally { $("older-messages").disabled = false; } +}); + +function renderMessages(mode = "preserve", incoming = 0) { + const scroll = $("message-scroll"), oldHeight = scroll.scrollHeight, oldTop = scroll.scrollTop; + const atBottom = oldHeight - oldTop - scroll.clientHeight < 85; + const messages = [...state.messages.values()].sort(compareMessages); + messageView.render(messages, state.session?.user.id, state.members, mode === "bottom" || incoming > 0); + messageView.renderReactions(reactions, reactionBusy); + $("empty-conversation").hidden = !state.historyReady || messages.length !== 0; + $("older-messages").hidden = !state.olderCursor; + updateHistoryInfo({ title: state.current?.title, loaded: messages.length, hasOlder: Boolean(state.olderCursor), ready: state.historyReady }); + if (mode === "bottom" || (mode === "preserve" && atBottom)) { + scroll.scrollTop = scroll.scrollHeight; + unseenMessages = 0; + } else if (mode === "prepend") scroll.scrollTop = oldTop + scroll.scrollHeight - oldHeight; + else { + scroll.scrollTop = oldTop; + unseenMessages += incoming; + } + updateJumpButton(); +} + +async function refreshReactions(ids) { + if (!ids.length || !state.current) return; + const epoch = state.epoch, version = reactionVersion, chatId = state.current.id; + try { + const data = await request(`/api/ui/chats/${chatId}/reactions?message_ids=${ids.join(',')}`, {background:true}); + if (epoch !== state.epoch || version !== reactionVersion) return; + const scroll = $('message-scroll'), oldHeight = scroll.scrollHeight, oldTop = scroll.scrollTop; + const atBottom = oldHeight - oldTop - scroll.clientHeight < 85; + for (const id of ids) reactions.set(id, data.items.filter(item => item.message_id === id)); + messageView.renderReactions(reactions, reactionBusy); + scroll.scrollTop = atBottom ? scroll.scrollHeight : oldTop; + } catch { /* Message history remains usable; reaction changes show their own error. */ } +} + +$('message-list').addEventListener('reactionchange', async event => { + const {messageId, reaction, present} = event.detail; + if (!state.current || reactionBusy.has(messageId)) return; + const epoch = state.epoch, chatId = state.current.id; + reactionVersion++; reactionBusy.add(messageId); messageView.renderReactions(reactions, reactionBusy); + try { + await request(`/api/ui/chats/${chatId}/messages/${messageId}/reactions/${reaction}`, {method:present ? 'PUT' : 'DELETE'}); + if (epoch !== state.epoch) return; + reactionVersion++; + await refreshReactions([messageId]); + } catch (error) { if (epoch === state.epoch) toast('Не удалось изменить реакцию. ' + error.message, true); } + finally { if (epoch === state.epoch) { reactionBusy.delete(messageId); messageView.renderReactions(reactions, reactionBusy); } } +}); + +function updateJumpButton() { + const scroll = $("message-scroll"), button = $("jump-latest"); + const atBottom = scroll.scrollHeight - scroll.scrollTop - scroll.clientHeight < 85; + if (atBottom) unseenMessages = 0; + button.hidden = atBottom || state.messages.size === 0; + const label = unseenMessages ? `Новые сообщения: ${unseenMessages} ↓` : "К последним ↓"; + if (button.textContent !== label) button.textContent = label; +} + +$("message-scroll").addEventListener("scroll", updateJumpButton, { passive: true }); +$("jump-latest").addEventListener("click", () => { + const scroll = $("message-scroll"); + scroll.scrollTo({ top: scroll.scrollHeight, behavior: matchMedia("(prefers-reduced-motion: reduce)").matches ? "auto" : "smooth" }); +}); + +function updateComposer() { + const text = $("message-input").value, count = Array.from(text).length; + $("message-count").textContent = `${count} / 4000`; + $("message-count").classList.toggle("over-limit", count > 4000); + $("pick-file").disabled = state.sending || uploadBusy; + $("send-message").disabled = state.sending || uploadBusy || (!text.trim() && !(attachedDrafts.get(state.current?.id)?.length)) || count > 4000; + $("message-input").style.height = "auto"; + const height = $("message-input").scrollHeight + 2; + $("message-input").style.height = Math.min(140, height) + "px"; + $("message-input").style.overflowY = height > 140 ? "auto" : "hidden"; + if (state.current) state.drafts.set(state.current.id, text); +} + +$("message-input").addEventListener("input", updateComposer); +$("message-input").addEventListener("keydown", event => { + if (event.key === "Enter" && !event.shiftKey && !event.isComposing) { + event.preventDefault(); + if (!$("send-message").disabled) $("message-form").requestSubmit(); + } +}); +$("message-form").addEventListener("submit", async event => { + event.preventDefault(); + if (state.sending || !state.current || $("send-message").disabled) return; + const epoch = state.epoch, chatId = state.current.id, text = $("message-input").value; + const attachment_ids = (attachedDrafts.get(chatId) || []).map(file => file.id); + const previous = pendingMessages.get(chatId); + const attempt = previous?.text === text && JSON.stringify(previous.attachment_ids) === JSON.stringify(attachment_ids) ? previous : { text, attachment_ids, key: crypto.randomUUID() }; + pendingMessages.set(chatId, attempt); + state.sending = true; updateComposer(); renderAttachedDrafts(); + try { + const message = await request(`/api/v1/chats/${chatId}/messages`, { + method: "POST", body: { text, attachment_ids }, headers: { "Idempotency-Key": attempt.key } + }); + pendingMessages.delete(chatId); + clearAttachedDrafts(chatId); + renderAttachedDrafts(); + if (state.drafts.get(chatId) === text) state.drafts.set(chatId, ""); + if (epoch !== state.epoch) return; + state.messages.set(message.id, message); + updateChatPreview(chatId, [message]); + if ($("message-input").value === text) $("message-input").value = ""; + renderMessages("bottom"); + await syncRecent(false, true); + } catch (error) { toast(error.status === 0 ? "Ответ не получен. Повторите отправку: сообщение не продублируется." : error.message, true); } + finally { state.sending = false; updateComposer(); renderAttachedDrafts(); } +}); + +function openNewChat() { + $("new-chat-form").reset(); notice("chat-dialog-notice", ""); + $("new-chat-dialog").showModal(); $("new-chat-title").focus(); +} +$("new-chat").addEventListener("click", openNewChat); +$("welcome-new-chat").addEventListener("click", openNewChat); +document.querySelectorAll("[data-close-dialog]").forEach(button => button.addEventListener("click", () => button.closest("dialog").close())); +$("new-chat-form").addEventListener("submit", async event => { + event.preventDefault(); + const form = event.currentTarget, token = state.session?.token; + const title = $("new-chat-title").value.trim(); + if (!title || Array.from(title).length > 100) return notice("chat-dialog-notice", "Название должно содержать от 1 до 100 символов."); + const ids = $("new-chat-members").value.split(/[\s,;]+/u).filter(Boolean); + if (ids.some(id => !/^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$/i.test(id))) + return notice("chat-dialog-notice", "Проверьте ID участников: нужен полный ID из профиля."); + const members = [...new Set([state.session.user.id, ...ids.map(id => id.toLowerCase())])]; + if (members.length > 100) return notice("chat-dialog-notice", "В чате может быть не более 100 участников."); + setFormBusy(form, true); notice("chat-dialog-notice", ""); + try { + const chat = await request("/api/v1/chats", { method: "POST", body: { title, member_ids: members } }); + if (token !== state.session?.token) return; + $("new-chat-dialog").close(); state.chats.push(chat); renderChats(); + await selectChat(chat); toast("Чат создан."); + } catch (error) { notice("chat-dialog-notice", error.message); } + finally { setFormBusy(form, false); } +}); + +$("open-profile").addEventListener("click", () => { + $("profile-details").textContent = state.session.user.display_name + " · @" + state.session.user.username; + $("my-id").value = state.session.user.id; $("profile-dialog").showModal(); +}); +$("copy-id").addEventListener("click", async () => { + try { await navigator.clipboard.writeText(state.session.user.id); toast("ID скопирован."); } + catch { $("my-id").select(); toast("Выделили ID. Скопируйте его сочетанием ⌘C или Ctrl+C."); } +}); +$("show-members").addEventListener("click", () => { + $("members-list").replaceChildren(...state.current.member_ids.map(id => { + const item = document.createElement("div"); item.className = "member-item"; + const label = document.createElement("strong"); label.textContent = (state.members.get(id)?.display_name || "Участник") + (id === state.session.user.id ? " (вы)" : ""); + const avatar = document.createElement("span"); avatar.className = "avatar"; + paintAvatar(avatar, id, state.members.get(id)?.display_name || "Участник"); + const details = document.createElement("span"); details.className = "member-details"; + const code = document.createElement("code"); code.textContent = id; details.append(label, code); item.append(avatar, details); return item; + })); + $("members-dialog").showModal(); +}); +$("logout").addEventListener("click", async () => { + $("logout").disabled = true; + try { await request("/api/v1/auth/sessions/current", { method: "DELETE" }); endSession(); } + catch (error) { if (error.status !== 401) toast(error.message, true); } + finally { $("logout").disabled = false; } +}); +$("back-to-chats").addEventListener("click", () => $("app-screen").classList.remove("chat-open")); +$("refresh-messages").addEventListener("click", async () => { + try { await syncRecent(); } catch (error) { toast(error.message, true); } +}); + +setInterval(async () => { + if (!state.session || document.hidden) return; + if (new Date(state.session.expires_at).getTime() <= Date.now()) return endSession("Сессия закончилась. Войдите снова."); + if (state.current) { try { await syncRecent(false, true); } catch { /* manual actions still show errors */ } } + if (!state.chatsCursor && state.chats.length <= 100 && Date.now() - lastChatRefresh > 12000) { + try { await loadChats(false, true); } catch { /* manual refresh shows errors */ } + } +}, 4000); + +async function resume() { + try { + const stored = sessionStorage.getItem(storageKey); + if (!stored) return; + const session = JSON.parse(stored); + if (!session?.token || !session.user || !(new Date(session.expires_at).getTime() > Date.now())) return endSession(); + state.session = session; + attachmentSession(session.token); + const user = await request("/api/v1/users/me"); + await enterSession({ ...session, user }); + } catch (error) { + state.session = null; + attachmentSession(null); + clearAttachedDrafts(); + if (error instanceof ApiError) notice("auth-notice", error.message); + else { try { sessionStorage.removeItem(storageKey); } catch { /* storage unavailable */ } } + } +} + +void resume(); +startClusterView(() => request('/api/ui/cluster', {background:true}), () => state.session?.token); + +function clearAttachedDrafts(chatId) { + for (const [id, files] of attachedDrafts) { + if (chatId && id !== chatId) continue; + for (const file of files) { + file.removed = true; + if (file.previewUrl) URL.revokeObjectURL(file.previewUrl); + } + attachedDrafts.delete(id); + } +} +function renderAttachedDrafts() { + const root = $("attached-files"); root.replaceChildren(); + for (const file of attachedDrafts.get(state.current?.id) || []) { + const item = document.createElement("div"); item.className = "draft-image"; + const image = document.createElement("img"); image.src = file.previewUrl; image.alt = file.filename; + const label = document.createElement("span"); label.className="draft-image-name"; label.textContent=file.filename;label.title=file.filename; + const remove = document.createElement("button"); remove.type="button";remove.className="draft-image-remove";remove.textContent="×"; + remove.setAttribute("aria-label","Убрать " + file.filename);remove.title="Убрать изображение";remove.disabled=state.sending; + remove.addEventListener("click",()=>{ + const chat = state.current.id; + file.removed=true;URL.revokeObjectURL(file.previewUrl); + attachedDrafts.set(chat,(attachedDrafts.get(chat)||[]).filter(item=>item!==file)); + renderAttachedDrafts();updateComposer(); + }); + item.append(image,label,remove); + if(!file.id) { + const status=document.createElement("span");status.className="draft-image-loading";status.textContent="Загрузка…";status.setAttribute("role","status");item.append(status); + } + root.append(item); + } +} +$("pick-file").addEventListener("click",()=>$("image-file").click()); +$("image-file").addEventListener("change",async()=>{ + const file=$("image-file").files[0];$("image-file").value=""; + if(!file || !state.current || uploadBusy || state.sending) return; + if(file.size>10485760) {toast("Максимум 10 MiB",true);return;} + if(!["image/png","image/jpeg"].includes(file.type)) {toast("Выберите PNG или JPEG",true);return;} + if((attachedDrafts.get(state.current.id)||[]).length>=10) {toast("Максимум 10 вложений",true);return;} + const chat=state.current.id, session=state.session.token; + const draft={filename:file.name,previewUrl:URL.createObjectURL(file),id:null,removed:false}; + attachedDrafts.set(chat,[...(attachedDrafts.get(chat)||[]),draft]);renderAttachedDrafts(); + uploadBusy=true;$("pick-file").disabled=true;updateComposer(); + try { + const attachment=await request(`/api/v1/chats/${chat}/attachments?filename=${encodeURIComponent(file.name)}`,{method:"POST",raw:file,headers:{"Content-Type":file.type}}); + if(state.session?.token!==session || draft.removed) return; + Object.assign(draft,attachment);renderAttachedDrafts(); + }catch(error){ + if(!draft.removed) { + draft.removed=true;URL.revokeObjectURL(draft.previewUrl); + attachedDrafts.set(chat,(attachedDrafts.get(chat)||[]).filter(item=>item!==draft));renderAttachedDrafts(); + } + if(state.session?.token===session) toast(error.message,true); + } + finally {uploadBusy=false;$("pick-file").disabled=state.sending;updateComposer();} +}); diff --git a/src/Messenger.Api/wwwroot/assets/chat-pattern.svg b/src/Messenger.Api/wwwroot/assets/chat-pattern.svg new file mode 100644 index 00000000..27e307c1 --- /dev/null +++ b/src/Messenger.Api/wwwroot/assets/chat-pattern.svg @@ -0,0 +1,7 @@ + + + + + + + diff --git a/src/Messenger.Api/wwwroot/assets/kolovertysh-empty-320.webp b/src/Messenger.Api/wwwroot/assets/kolovertysh-empty-320.webp new file mode 100644 index 0000000000000000000000000000000000000000..567ace88bf3f3b7e6674aa28dbe6d5a45bae142d GIT binary patch literal 26422 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 Vpa1{>000Fcso9c~IgKCy007$NWuX87 literal 0 HcmV?d00001 diff --git a/src/Messenger.Api/wwwroot/assets/kolovertysh-error-320.webp b/src/Messenger.Api/wwwroot/assets/kolovertysh-error-320.webp new file mode 100644 index 0000000000000000000000000000000000000000..b085ea9b79cd8a988200ea29ce81e48e10cd3ab6 GIT binary patch literal 31826 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 literal 0 HcmV?d00001 diff --git a/src/Messenger.Api/wwwroot/assets/kolovertysh-welcome-640.webp b/src/Messenger.Api/wwwroot/assets/kolovertysh-welcome-640.webp new file mode 100644 index 0000000000000000000000000000000000000000..3a4e596780251c85c8f34dd09048d0ae7aef0674 GIT binary patch literal 55878 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

-qK~Fm3AZZF75d+xBF=tH-RAnX(a9Zke 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 literal 0 HcmV?d00001 diff --git a/src/Messenger.Api/wwwroot/assets/kolovertysh.svg b/src/Messenger.Api/wwwroot/assets/kolovertysh.svg new file mode 100644 index 00000000..29d1871a --- /dev/null +++ b/src/Messenger.Api/wwwroot/assets/kolovertysh.svg @@ -0,0 +1,63 @@ + diff --git a/src/Messenger.Api/wwwroot/attachments.css b/src/Messenger.Api/wwwroot/attachments.css new file mode 100644 index 00000000..e1159963 --- /dev/null +++ b/src/Messenger.Api/wwwroot/attachments.css @@ -0,0 +1,61 @@ +.attachment-card { display:grid; gap:0; width:min(320px, 58vw); max-width:100%; margin:5px 0 0; } +.attachment-preview { display:grid; position:relative; width:100%; aspect-ratio:4/3; padding:0; border:0; border-radius:12px; overflow:hidden; background:#00000016; cursor:zoom-in; color:inherit; isolation:isolate; } +.attachment-preview img { width:100%; height:100%; object-fit:cover; display:block; opacity:0; transition:opacity .18s; } +.attachment-card.is-ready .attachment-preview img { opacity:1; } +.attachment-status { position:absolute; inset:0; display:grid; place-items:center; padding:24px; font-size:12px; text-align:center; line-height:1.6; } +.is-ready .attachment-status { display:none; } +.attachment-expand { position:absolute; bottom:10px; right:10px; display:grid; place-items:center; width:30px; height:30px; background:#1616169c; color:#fff; border-radius:9px; opacity:0; transition:opacity .16s; } +.attachment-preview:hover .attachment-expand, .attachment-preview:focus-visible .attachment-expand { opacity:1; } +.attachment-info { display:flex; gap:10px; align-items:center; padding:9px 0 2px; } +.attachment-label { display:grid; flex:1; gap:3px; min-width:0; } +.attachment-name { font-size:12px; overflow:hidden; white-space:nowrap; text-overflow:ellipsis; font-weight:550; } +.attachment-size { font-size:10px; opacity:.65; } +.attachment-download { display:grid; place-items:center; width:35px; height:35px; border:1px solid #ffffff22; border-radius:10px; color:inherit; background:#ffffff08; cursor:pointer; } +.mine .attachment-download { border-color:#26262625; background:#26262608; } +.attachment-download:hover { background:#ffffff20; } +.attachment-download:disabled { opacity:.3; cursor:default; } +.attachment-card svg, .image-viewer svg { width:20px; height:20px; fill:none; stroke:currentColor; stroke-width:1.7; stroke-linecap:round; stroke-linejoin:round; } +.attachment-preview:focus-visible, .attachment-download:focus-visible, .image-viewer button:focus-visible { outline:2px solid var(--accent); outline-offset:3px; } +.mine .attachment-preview:focus-visible, .mine .attachment-download:focus-visible { outline-color:#262626; } +.composer { grid-template-columns:40px minmax(0,1fr) 46px; } +#pick-file { height:47px; width:40px; margin-bottom:1px; } +.attached-files { grid-column:1/-1; order:-1; display:flex; gap:10px; overflow-x:auto; padding:4px 2px 7px; min-width:0; } +.attached-files:empty { display:none; } +.draft-image { width:84px; flex-shrink:0; position:relative; border-radius:12px; } +.draft-image > img { width:84px; height:76px; display:block; object-fit:cover; border-radius:12px; border:1px solid #ffffff20; } +.draft-image-name { display:block; overflow:hidden; white-space:nowrap; text-overflow:ellipsis; font-size:10px; color:var(--muted); padding-top:5px; } +.draft-image-remove { position:absolute; top:3px; right:3px; display:grid; place-items:center; width:25px; height:25px; font-size:21px; line-height:1; color:white; background:#171717c9; border:1px solid #ffffff30; border-radius:50%; cursor:pointer; } +.draft-image-remove:disabled { opacity:.4; cursor:default; } +.draft-image-loading { position:absolute; top:0; height:76px; inset-inline:0; display:grid; align-items:end; padding:7px 4px; background:linear-gradient(transparent,#000b); color:white; border-radius:12px; font-size:10px; text-align:center; pointer-events:none; } +.viewing-image { overflow:hidden; } +dialog.image-viewer { position:fixed; inset:0; width:100%; height:100%; width:100dvw; height:100dvh; max-width:none; max-height:none; margin:0; padding:0; border:0; border-radius:0; background:#141414f7; color:#f4f3ed; overflow:hidden; box-shadow:none; } +.image-viewer[open] { display:grid; grid-template-rows:auto minmax(0,1fr); } +.image-viewer::backdrop { background:#141414; backdrop-filter:none; } +.image-viewer-header { display:flex; gap:20px; align-items:center; justify-content:space-between; padding:18px max(20px,env(safe-area-inset-right)) 18px max(24px,env(safe-area-inset-left)); border-bottom:1px solid #ffffff10; background:#1d1d1d; z-index:2; } +.image-viewer-label { min-width:0; display:grid; gap:5px; } +.image-viewer-label strong { font-weight:550; font-size:14px; white-space:nowrap; text-overflow:ellipsis; overflow:hidden; } +.image-viewer-label > span { font-size:11px; color:#a7a79d; } +.image-viewer-actions { display:flex; gap:8px; flex-shrink:0; } +.image-viewer button { display:grid; place-items:center; color:inherit; background:#ffffff0b; border:1px solid #ffffff14; border-radius:12px; cursor:pointer; padding:0; width:42px; height:42px; transition:background .15s; } +.image-viewer button:hover { background:#ffffff20; } +.image-viewer button:disabled { opacity:.35; cursor:default; } +.image-viewer-stage { display:grid; place-items:center; position:relative; overflow:auto; padding:24px 70px max(24px,env(safe-area-inset-bottom)); min-height:0; min-width:0; } +.image-viewer-stage > img { display:block; max-width:100%; max-height:100%; min-height:0; object-fit:contain; border-radius:3px; user-select:none; -webkit-user-drag:none; } +.image-viewer-stage > img:not([src]) { display:none; } +.image-viewer-status { position:absolute; text-align:center; font-size:13px; color:#c8c8b9; max-width:300px; padding:20px; } +.image-viewer-status:empty { display:none; } +.image-viewer.is-zoomed .image-viewer-stage { display:block; padding:24px; } +.image-viewer.is-zoomed .image-viewer-stage > img { max-width:none; max-height:none; width:auto; height:auto; margin:auto; cursor:zoom-out; } +.image-viewer .image-viewer-prev, .image-viewer .image-viewer-next { position:absolute; top:calc(50% + 35px); background:#262626cc; width:44px; height:52px; z-index:1; } +.image-viewer-prev { left:16px; } .image-viewer-next { right:16px; } +@media (max-width:600px) { + .image-viewer-header { padding:12px; gap:8px; } + .image-viewer-label strong { font-size:12px; } + .image-viewer-actions { gap:5px; } + .image-viewer-actions button { width:36px; height:38px; border-radius:10px; } + .image-viewer-stage { padding:14px 12px 68px; } + .image-viewer .image-viewer-prev, .image-viewer .image-viewer-next { top:auto; bottom:max(12px,env(safe-area-inset-bottom)); height:38px; width:44px; } + .image-viewer-prev { left:calc(50% - 52px); } .image-viewer-next { right:calc(50% - 52px); } + .attachment-expand { opacity:1; } +} +@media (prefers-reduced-motion:reduce) { .attachment-preview img, .attachment-expand, .image-viewer button { transition:none; } } diff --git a/src/Messenger.Api/wwwroot/attachments.js b/src/Messenger.Api/wwwroot/attachments.js new file mode 100644 index 00000000..73cfd5e9 --- /dev/null +++ b/src/Messenger.Api/wwwroot/attachments.js @@ -0,0 +1,191 @@ +let token = null, generation = 0, activeLoads = 0; +const cards = new Set(), waiters = []; +let active = null, viewer = null, returnFocus = null; +const observer = new IntersectionObserver(entries => { + for (const entry of entries) { + const card = entry.target.attachment; + card.visible = entry.isIntersecting; + if (card.visible) void load(card).catch(() => {}); + else if (active !== card) release(card); + } +}, { rootMargin: '400px' }); + +const paths = { + download: 'M12 3v12m-5-5 5 5 5-5M5 17v4h14v-4', + close: 'm6 6 12 12M18 6 6 18', + zoom: 'M10 4a6 6 0 1 0 0 12 6 6 0 0 0 0-12m4.5 10.5L21 21M7 10h6m-3-3v6', + left: 'm15 5-7 7 7 7', right: 'm9 5 7 7-7 7' +}; +function icon(name) { + const svg = document.createElementNS('http://www.w3.org/2000/svg', 'svg'); + svg.setAttribute('viewBox', '0 0 24 24'); svg.setAttribute('aria-hidden', 'true'); + const path = document.createElementNS(svg.namespaceURI, 'path'); path.setAttribute('d', paths[name]); + svg.append(path); return svg; +} +function control(label, name, action) { + const button = document.createElement('button'); button.type = 'button'; + button.title = label; button.setAttribute('aria-label', label); button.append(icon(name)); + button.addEventListener('click', action); return button; +} +function bytes(size) { return size < 1048576 ? Math.max(1, Math.round(size / 1024)) + ' КБ' : (size / 1048576).toFixed(1) + ' МБ'; } + +export function attachmentSession(value) { + generation++; token = value; + if (viewer?.open) viewer.close(); + clearAttachmentCards(); +} +export function clearAttachmentCards() { + if (viewer?.open) viewer.close(); + for (const card of cards) { card.disposed = true; observer.unobserve(card.root); release(card); } + cards.clear(); +} +function release(card) { + card.controller?.abort(); + if (card.url) URL.revokeObjectURL(card.url); + card.download.disabled = true; + card.url = null; card.image.removeAttribute('src'); card.root.classList.remove('is-ready'); +} +async function load(card) { + if (card.url) return; + if (card.promise) return card.promise; + const session = token, version = generation; + if (!session || card.disposed) throw new Error('Сессия недоступна'); + card.promise = (async () => { + if (activeLoads >= 2) await new Promise(resolve => waiters.push(resolve)); + activeLoads++; + try { + if (card.disposed || version !== generation || (!card.visible && active !== card)) return; + card.root.classList.remove('has-error'); card.status.textContent = 'Загрузка изображения…'; + const controller = new AbortController(); card.controller = controller; + const signal = AbortSignal.any([controller.signal, AbortSignal.timeout(30000)]); + const options = {headers:{Authorization:'Bearer ' + session},credentials:'omit',cache:'no-store',signal}; + if (!card.meta) { + const response = await fetch(`/api/v1/attachments/${card.id}`, options); + if (!response.ok) throw new Error('Изображение недоступно'); + card.meta = await response.json(); + card.name.textContent = card.meta.filename; + card.size.textContent = bytes(card.meta.size_bytes); + card.open.setAttribute('aria-label', 'Открыть ' + card.meta.filename + ' на весь экран'); + } + const response = await fetch(`/api/v1/attachments/${card.id}/content`, options); + if (!response.ok) throw new Error('Изображение недоступно'); + const blob = await response.blob(); + if (card.disposed || version !== generation || controller.signal.aborted) return; + card.url = URL.createObjectURL(blob); card.image.src = card.url; + card.image.alt = card.meta.filename; card.root.classList.add('is-ready'); + card.download.disabled = false; + card.status.textContent = ''; + } catch (error) { + if (error.name !== 'AbortError' && !card.disposed && version === generation) { + card.root.classList.add('has-error'); card.status.textContent = 'Не удалось загрузить. Нажмите, чтобы повторить.'; + } + throw error; + } finally { + card.promise = null; activeLoads--; waiters.shift()?.(); + if (card.controller?.signal.aborted && !card.disposed && version === generation && (card.visible || active === card)) + queueMicrotask(() => { void load(card).catch(() => {}); }); + } + })(); + return card.promise; +} + +export function attachmentCard(id) { + const root = document.createElement('div'); root.className = 'attachment-card'; + const image = document.createElement('img'); image.alt = ''; image.decoding = 'async'; + const open = document.createElement('button'); open.type = 'button'; open.className = 'attachment-preview'; + open.setAttribute('aria-label', 'Открыть изображение на весь экран'); + const status = document.createElement('span'); status.className = 'attachment-status'; status.textContent = 'Загрузка изображения…'; + const hint = document.createElement('span'); hint.className = 'attachment-expand'; hint.append(icon('zoom')); + open.append(image, status, hint); + const info = document.createElement('div'); info.className = 'attachment-info'; + const label = document.createElement('span'); label.className = 'attachment-label'; + const name = document.createElement('span'); name.className = 'attachment-name'; name.textContent = 'Изображение'; + const size = document.createElement('span'); size.className = 'attachment-size'; label.append(name, size); + const card = {id, root, open, image, status, name, size, url:null, meta:null, visible:false, disposed:false, promise:null}; + const download = control('Скачать изображение', 'download', () => save(card)); + download.className = 'attachment-download'; download.disabled = true; card.download = download; + info.append(label, download); root.append(open, info); root.attachment = card; + open.addEventListener('click', () => { if (root.classList.contains('has-error')) { void load(card).catch(() => {}); } else openViewer(card); }); + cards.add(card); observer.observe(root); return root; +} +function save(card) { + if (!card?.url) return; + const link = document.createElement('a'); link.href = card.url; link.download = card.meta?.filename || 'image'; + document.body.append(link); link.click(); link.remove(); +} +function gallery() { + return [...cards].filter(card => !card.disposed && card.root.isConnected).sort((a,b) => + a.root.compareDocumentPosition(b.root) & Node.DOCUMENT_POSITION_FOLLOWING ? -1 : 1); +} +function move(direction) { + const items = gallery(), index = items.indexOf(active), next = items[index + direction]; + if (next) void show(next); +} +function zoom() { + if (!active?.url) return; + viewer.classList.toggle('is-zoomed'); + viewer.zoom.setAttribute('aria-pressed', String(viewer.classList.contains('is-zoomed'))); + viewer.stage.scrollTo(0, 0); +} +function createViewer() { + const dialog = document.createElement('dialog'); dialog.className = 'image-viewer'; + dialog.setAttribute('aria-label', 'Просмотр изображения'); + const header = document.createElement('header'); header.className = 'image-viewer-header'; + const label = document.createElement('div'); label.className = 'image-viewer-label'; + const name = document.createElement('strong'), detail = document.createElement('span');label.append(name, detail); + const actions = document.createElement('div');actions.className = 'image-viewer-actions'; + const zoomButton = control('Увеличить изображение', 'zoom', zoom); zoomButton.setAttribute('aria-pressed','false'); + const download = control('Скачать оригинал', 'download', () => save(active)); + const close = control('Закрыть просмотр', 'close', () => dialog.close()); + actions.append(zoomButton, download, close); header.append(label, actions); + const stage = document.createElement('div'); stage.className = 'image-viewer-stage'; + const image = document.createElement('img'); image.alt = ''; + const status = document.createElement('p');status.className = 'image-viewer-status';status.setAttribute('role','status'); + stage.append(image, status); + const previous = control('Предыдущее изображение', 'left', () => move(-1)); previous.className = 'image-viewer-prev'; + const next = control('Следующее изображение', 'right', () => move(1)); next.className = 'image-viewer-next'; + dialog.append(header, stage, previous, next); document.body.append(dialog); + Object.assign(dialog, {picture:image, nameLabel:name, detail, status, stage, download, zoom:zoomButton, previous, next}); + dialog.addEventListener('click', event => { if (event.target === stage || event.target === dialog) dialog.close(); }); + image.addEventListener('dblclick', zoom); + dialog.addEventListener('keydown', event => { + if (event.key === 'ArrowLeft' || event.key === 'ArrowRight') { event.preventDefault(); move(event.key === 'ArrowLeft' ? -1 : 1); } + }); + let touch = null; + stage.addEventListener('touchstart', e => {touch = e.touches.length === 1 ? [e.touches[0].clientX, e.touches[0].clientY] : null;},{passive:true}); + stage.addEventListener('touchend', e => { + if (!touch || dialog.classList.contains('is-zoomed')) return; + const dx=e.changedTouches[0].clientX-touch[0], dy=e.changedTouches[0].clientY-touch[1];touch=null; + if (Math.abs(dx)>65 && Math.abs(dx)>Math.abs(dy)*1.5) move(dx<0?1:-1); + },{passive:true}); + dialog.addEventListener('close', () => { + const previousCard=active;active=null;dialog.picture.removeAttribute('src'); + document.documentElement.classList.remove('viewing-image'); + if(previousCard && !previousCard.visible) release(previousCard); + if(returnFocus?.isConnected) returnFocus.focus({preventScroll:true}); + }); + return dialog; +} +function openViewer(card) { + if (!viewer) viewer=createViewer(); + if (!viewer.open) {returnFocus=document.activeElement;viewer.showModal();document.documentElement.classList.add('viewing-image');} + void show(card); +} +async function show(card) { + const previous=active;active=card; + if(previous && previous!==card && !previous.visible) release(previous); + viewer.classList.remove('is-zoomed');viewer.zoom.setAttribute('aria-pressed','false'); + viewer.stage.scrollTo(0,0);viewer.picture.removeAttribute('src');viewer.picture.alt=''; + viewer.nameLabel.textContent=card.meta?.filename || 'Изображение';viewer.detail.textContent=''; + viewer.status.textContent='Загрузка…';viewer.download.disabled=true;viewer.zoom.disabled=true; + const items=gallery(), index=items.indexOf(card); + viewer.previous.hidden=index<=0;viewer.next.hidden=index===items.length-1; + try { + await load(card); + if(active!==card || !viewer.open || !card.url) return; + viewer.picture.src=card.url;viewer.picture.alt=card.meta.filename; + viewer.nameLabel.textContent=card.meta.filename; + viewer.detail.textContent=`${index+1} из ${items.length} · ${bytes(card.meta.size_bytes)}`; + viewer.status.textContent='';viewer.download.disabled=false;viewer.zoom.disabled=false; + } catch {if(active===card) viewer.status.textContent='Изображение недоступно. Закройте просмотр и повторите загрузку.';} +} diff --git a/src/Messenger.Api/wwwroot/avatars.js b/src/Messenger.Api/wwwroot/avatars.js new file mode 100644 index 00000000..2b68db1d --- /dev/null +++ b/src/Messenger.Api/wwwroot/avatars.js @@ -0,0 +1,42 @@ +const svgNS = "http://www.w3.org/2000/svg"; +const palettes = [ + ["#394639", "#c2d39b"], ["#474033", "#e5c38b"], + ["#3c414d", "#b9c9e4"], ["#493b42", "#e4b6c5"], + ["#444333", "#e0d29a"], ["#354647", "#afd5ce"] +]; + +function element(tag, attributes = {}) { + const node = document.createElementNS(svgNS, tag); + for (const [key, value] of Object.entries(attributes)) node.setAttribute(key, value); + return node; +} + +export function initials(name) { + return (name.match(/[\p{L}\p{N}]+/gu) || []).slice(0, 2) + .map(part => Array.from(part)[0]).join("").toUpperCase(); +} + +export function paintAvatar(target, id, name) { + if (target.dataset.identity === id && target.dataset.name === name) return; + let hash = 2166136261; + for (const character of id) hash = Math.imul(hash ^ character.charCodeAt(0), 16777619) >>> 0; + const [background, foreground] = palettes[hash % palettes.length]; + const svg = element("svg", { viewBox: "0 0 64 64", class: "avatar-art", "aria-hidden": "true" }); + svg.append(element("rect", { width: 64, height: 64, rx: 20, fill: background })); + const patterns = [ + "M-7 18Q21-7 39 9T74 18M-8 49Q21 27 40 44T74 49", + "M-3 3 28 3 64 39M-3 21 21 21 64 64M-3 39 14 39 39 64", + "M7 59Q-6 24 25 8Q60-7 70 26M-2 42Q23 69 54 49Q75 31 52 8" + ]; + svg.append(element("path", { d: patterns[(hash >>> 4) % patterns.length], fill: "none", + stroke: foreground, "stroke-width": 6, opacity: .12 })); + svg.append(element("circle", { cx: 50, cy: 13, r: 3, fill: foreground, opacity: .5 })); + const label = element("text", { x: 32, y: 34, fill: foreground, + "text-anchor": "middle", "dominant-baseline": "middle", "font-size": 22, + "font-family": "system-ui, sans-serif", "font-weight": 650 }); + label.textContent = initials(name); + svg.append(label); + target.replaceChildren(svg); + target.dataset.identity = id; + target.dataset.name = name; +} diff --git a/src/Messenger.Api/wwwroot/cluster-view.js b/src/Messenger.Api/wwwroot/cluster-view.js new file mode 100644 index 00000000..ab9f1588 --- /dev/null +++ b/src/Messenger.Api/wwwroot/cluster-view.js @@ -0,0 +1,90 @@ +const $ = id => document.getElementById(id); +const observed = new Map(); +const cards = new Map(); +let signedIn = false, lastInstance = null, total = 0, pulseTimer; + +export function setClusterIdentity(active) { + signedIn = active; + observed.clear(); cards.clear(); total = 0; lastInstance = null; + $('cluster-instances').replaceChildren(); + $('cluster-status').textContent = active ? 'Получаем heartbeat…' : 'Схема доступна после входа'; + $('cluster-detail').textContent = 'Подсветка — реальный X-Instance-Id ответа.'; + $('cluster-copy').disabled = true; + for (const id of ['cluster-postgres', 'cluster-redis', 'cluster-balancer']) $(id).dataset.state = 'unknown'; +} + +export function observeClusterRequest(entry) { + if (!signedIn || !entry.instanceId) return; + total++; + lastInstance = entry.instanceId; + observed.set(lastInstance, (observed.get(lastInstance) || 0) + 1); + for (const [id, card] of cards) { + card.root.classList.toggle('just-served', id === lastInstance); + card.count.textContent = `${observed.get(id) || 0} / ${total} запросов`; + } + $('cluster-balancer').dataset.state = 'up'; + $('cluster-detail').textContent = `${entry.method} · ${entry.status ?? 'нет ответа'} · ${entry.durationMs} мс → ${lastInstance.slice(0, 8)}`; + clearTimeout(pulseTimer); + pulseTimer = setTimeout(() => { for (const card of cards.values()) card.root.classList.remove('just-served'); }, 1100); +} + +function render(snapshot) { + $('cluster-redis').dataset.state = snapshot.redis_available ? 'up' : 'down'; + $('cluster-postgres').dataset.state = snapshot.postgres_available ? 'up' : 'down'; + if (!snapshot.redis_available) { + $('cluster-status').textContent = 'Redis недоступен · состояние API неизвестно'; + for (const card of cards.values()) { card.root.dataset.state = 'unknown'; card.state.textContent = 'Нет heartbeat'; } + $('cluster-copy').disabled = true; + return; + } + // Keep outages witnessed by this tab, without presenting earlier deployments as new failures. + const visible = snapshot.instances.filter(node => node.ready || cards.has(node.id) || observed.has(node.id)); + const alive = visible.filter(node => node.ready), missing = visible.length - alive.length; + $('cluster-status').textContent = `${alive.length} API в сети${missing ? ` · ${missing} без heartbeat` : ''}`; + const wanted = new Set(visible.map(node => node.id)); + for (const [id, card] of cards) if (!wanted.has(id)) { card.root.remove(); cards.delete(id); } + for (const node of [...visible].sort((a,b) => a.id.localeCompare(b.id))) { + let card = cards.get(node.id); + if (!card) { + const root = document.createElement('div'); root.className = 'cluster-api cluster-node'; root.dataset.instanceId = node.id; + const heading = document.createElement('strong'); heading.textContent = `API · ${node.id.slice(0,8)}`; + const state = document.createElement('span'), count = document.createElement('small'); + root.append(heading, state, count); root.title = `X-Instance-Id: ${node.id}`; + card = {root, state, count}; cards.set(node.id, card); $('cluster-instances').append(root); + } + card.root.dataset.state = node.ready ? 'up' : 'down'; + card.state.textContent = node.ready ? 'В сети' : 'Heartbeat пропал'; + card.count.textContent = `${observed.get(node.id) || 0} / ${total} запросов`; + } + const target = alive.find(node => node.id === lastInstance) || alive[0]; + $('cluster-command').textContent = target ? `python3 scripts/demo-failover.py --instance ${target.id}` : 'Ожидаем работающие API…'; + $('cluster-copy').disabled = alive.length < 2; +} + +export function startClusterView(readSnapshot, getToken) { + let busy = false; + async function refresh() { + const token = getToken(); + if (!token || busy || document.hidden || $('diagnostics-panel').hidden) return; + busy = true; + try { const data = await readSnapshot(); if (token === getToken()) render(data); } + catch { + if (token === getToken()) { + $('cluster-status').textContent = 'Нет свежих данных о кластере'; + $('cluster-balancer').dataset.state = 'unknown'; + $('cluster-postgres').dataset.state = 'unknown'; + $('cluster-redis').dataset.state = 'unknown'; + for (const card of cards.values()) { card.root.dataset.state = 'unknown'; card.state.textContent = 'Нет свежих данных'; } + $('cluster-copy').disabled = true; + } + } finally { busy = false; } + } + new MutationObserver(refresh).observe($('diagnostics-panel'), { attributes: true, attributeFilter: ['hidden'] }); + setInterval(refresh, 2000); + $('cluster-probe').addEventListener('click', refresh); + $('cluster-copy').addEventListener('click', async () => { + try { await navigator.clipboard.writeText($('cluster-command').textContent); $('cluster-copy').textContent = 'Скопировано'; } + catch { $('cluster-copy').textContent = 'Выделите команду ниже'; } + setTimeout(() => { $('cluster-copy').textContent = 'Скопировать команду'; }, 2000); + }); +} diff --git a/src/Messenger.Api/wwwroot/diagnostics.js b/src/Messenger.Api/wwwroot/diagnostics.js new file mode 100644 index 00000000..3299a629 --- /dev/null +++ b/src/Messenger.Api/wwwroot/diagnostics.js @@ -0,0 +1,113 @@ +// Only explicitly selected HTTP metadata reaches this view. Never pass request +// headers, bodies, session objects or raw response JSON into the panel. +import { observeClusterRequest, setClusterIdentity } from '/cluster-view.js'; +const $ = id => document.getElementById(id); +const preferenceKey = "n1k0der.diagnostics"; +const requests = []; +let session = null, history = null, backgroundRequest = null, returnFocus = null; + +function setOpen(open) { + $("diagnostics-panel").hidden = !open; + document.body.classList.toggle("diagnostics-open", open); + document.querySelectorAll("[data-diagnostics-toggle]").forEach(button => button.setAttribute("aria-expanded", String(open))); + try { sessionStorage.setItem(preferenceKey, open ? "on" : "off"); } catch { /* optional preference */ } + if (open) { render(); $("diagnostics-close").focus(); } + else if (returnFocus?.isConnected) returnFocus.focus(); +} + +document.querySelectorAll("[data-diagnostics-toggle]").forEach(button => button.addEventListener("click", () => { + returnFocus = button; + setOpen($("diagnostics-panel").hidden); +})); +$("diagnostics-close").addEventListener("click", () => setOpen(false)); +document.addEventListener("keydown", event => { + if (event.key === "Escape" && !$("diagnostics-panel").hidden && !document.querySelector("dialog[open]")) { + event.preventDefault(); setOpen(false); + } +}); + +export function updateSessionInfo(value) { + setClusterIdentity(Boolean(value)); + session = value ? { name: value.name, expiresAt: value.expiresAt } : null; + document.body.classList.toggle("has-session", Boolean(session)); + if (!$("diagnostics-panel").hidden) renderSession(); +} + +export function updateHistoryInfo(value) { + history = value ? { title: value.title, loaded: value.loaded, hasOlder: value.hasOlder, ready: value.ready } : null; + if (!$("diagnostics-panel").hidden) renderHistory(); +} + +export function recordRequest(value) { + const entry = { + method: value.method, path: value.path.split("?")[0], status: value.status, + authorization: value.authorization, durationMs: value.durationMs, + requestId: value.requestId, instanceId: value.instanceId, outcome: value.outcome, source: value.source, at: new Date() + }; + observeClusterRequest(entry); + if (value.background) backgroundRequest = entry; + else { requests.unshift(entry); requests.length = Math.min(requests.length, 4); } + if (!$("diagnostics-panel").hidden) renderRequests(); +} + +function renderSession() { + $("diagnostics-user").textContent = session?.name || "Вход не выполнен"; + const seconds = session ? Math.max(0, Math.ceil((new Date(session.expiresAt).getTime() - Date.now()) / 1000)) : null; + $("diagnostics-session").textContent = seconds === null ? "-" : seconds === 0 ? "Срок истёк" : `${Math.floor(seconds / 60)} мин ${String(seconds % 60).padStart(2, "0")} с`; +} + +function renderHistory() { + $("diagnostics-chat").textContent = history?.title || "Выберите чат"; + $("diagnostics-messages").textContent = history + ? `Загружено: ${history.loaded} · ${!history.ready ? "страница ещё не получена" : history.hasOlder ? "есть старые сообщения ↑" : "старых страниц нет"}` + : "Сообщения ещё не загружены"; +} + +function result(entry) { + if (entry.status === null) return "Ответ не получен: соединение или таймаут. Результат записи может быть неизвестен."; + if (entry.outcome === "unreadable") return "HTTP-ответ получен, но его данные не удалось прочитать."; + if (entry.status === 204 && entry.method === "DELETE" && entry.path === "/api/v1/auth/sessions/current") return "Сессия отозвана. Ответ без тела."; + return ({200: "Запрос выполнен", 201: "Объект создан", 204: "Выполнено без тела ответа", + 400: "Некорректные данные", 401: "Нужен действующий вход", 404: "Ресурс отсутствует или недоступен", + 409: "Конфликт данных", 415: "Неподдерживаемый формат", 503: "Сервис временно недоступен", + 500: "Внутренняя ошибка сервера"})[entry.status] || `HTTP ${entry.status}`; +} + +function shortPath(path) { return path.replace(/\/[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}(?=\/|$)/gi, "/…"); } + +function renderRequests() { + const current = requests[0]; + $("diagnostics-empty").hidden = Boolean(current); + $("diagnostics-request-details").hidden = !current; + $("diagnostics-request-time").textContent = current ? current.at.toLocaleTimeString("ru-RU") : ""; + if (current) { + const failed = current.status === null || current.status >= 400 || current.outcome === "unreadable"; + $("diagnostics-method").textContent = current.method; + $("diagnostics-status").textContent = current.status ?? "Нет ответа"; + $("diagnostics-status").classList.toggle("failed", failed); + $("diagnostics-origin").textContent = current.source || "Основной интерфейс"; + $("diagnostics-path").textContent = shortPath(current.path); + $("diagnostics-path").title = current.path; + $("diagnostics-result").textContent = result(current); + $("diagnostics-result").classList.toggle("failed", failed); + $("diagnostics-auth").textContent = current.authorization; + $("diagnostics-duration").textContent = `${current.durationMs} мс`; + $("diagnostics-request-id").textContent = current.requestId || "Не получен"; + $("diagnostics-instance-id").textContent = current.instanceId || "Не получен"; + } + const previous = requests.slice(1).map(entry => { + const item = document.createElement("li"); + const status = document.createElement("span"); status.textContent = entry.status ?? "-"; + status.className = "diagnostics-mini-status" + (entry.status === null || entry.status >= 400 ? " failed" : ""); + const route = document.createElement("code"); route.textContent = `${entry.method} ${shortPath(entry.path)}`; + route.title = entry.path; item.append(status, route); return item; + }); + $("diagnostics-previous").replaceChildren(...previous); + $("diagnostics-previous").hidden = previous.length === 0; + $("diagnostics-background").hidden = !backgroundRequest; + if (backgroundRequest) $("diagnostics-background").textContent = `Фоновый запрос: ${backgroundRequest.status ?? "нет ответа"} · ${backgroundRequest.durationMs} мс · ${backgroundRequest.at.toLocaleTimeString("ru-RU")}`; +} + +function render() { renderSession(); renderHistory(); renderRequests(); } +setInterval(() => { if (!$("diagnostics-panel").hidden) renderSession(); }, 1000); +try { if (sessionStorage.getItem(preferenceKey) === "on") setOpen(true); } catch { /* optional preference */ } diff --git a/src/Messenger.Api/wwwroot/index.html b/src/Messenger.Api/wwwroot/index.html new file mode 100644 index 00000000..226ae3fe --- /dev/null +++ b/src/Messenger.Api/wwwroot/index.html @@ -0,0 +1,169 @@ + + + + + + + + n1k0der · Мессенджер + + + + + + + + + + +

+
+ n1k0der. +

Место для
ваших
разговоров.

+ +
+
+
+
+

С возвращением.

+
+
+ + + +
+
n1k0der
+
+
+ + + + + +

Собрать чат

+

Ваш профиль

Поделитесь ID для приглашения в чат.

+

Участники чата

+ + diff --git a/src/Messenger.Api/wwwroot/mascots.js b/src/Messenger.Api/wwwroot/mascots.js new file mode 100644 index 00000000..ef6f57fa --- /dev/null +++ b/src/Messenger.Api/wwwroot/mascots.js @@ -0,0 +1,143 @@ +// Animation reads field state and password length, never password text. +const stage = document.getElementById("mascot-stage"); +const auth = document.getElementById("auth-screen"); +const reduceMotion = matchMedia("(prefers-reduced-motion: reduce)"); +const mobile = matchMedia("(max-width: 720px)"); +let pending = false, feedback = false; +let feedbackTimer, sleepTimer, approachTimer, pointerFrame = null; +let pointer = { x: 0, y: 0 }, lastWake = 0; + +function wakeUp() { + stage.classList.remove("is-sleepy"); + clearTimeout(sleepTimer); + sleepTimer = setTimeout(() => { + if (stage.dataset.mood === "idle") stage.classList.add("is-sleepy"); + }, 12000); +} + +function activeField() { + const focused = document.activeElement; + return focused?.matches("[data-password-toggle]") + ? document.getElementById(focused.dataset.passwordToggle) : focused; +} + +function focusedMood() { + if (pending || feedback) return; + const field = activeField(); + let mood = "idle"; + if (field?.matches("#login-password, #register-password")) { + mood = field.type === "text" ? "revealed" : "private"; + if (field.id === "register-password" && field.value.length > 0 && Array.from(field.value).length < 12) mood = "short"; + } else if (field?.matches("#login-username, #register-name, #register-username")) mood = "looking"; + stage.dataset.mood = mood; + document.getElementById("auth-error-art").hidden = mood !== "error"; +} + +export function setMascotMood(mood) { + clearTimeout(feedbackTimer); + pending = mood === "pending"; + feedback = ["success", "error", "short"].includes(mood); + stage.dataset.mood = mood; + document.getElementById("auth-error-art").hidden = mood !== "error"; + if (pending || feedback) stage.classList.remove("is-curious"); + if (feedback) feedbackTimer = setTimeout(() => { feedback = false; focusedMood(); }, 3500); +} + +for (const form of auth.querySelectorAll("form")) { + form.addEventListener("focusin", () => { + if (!pending) { feedback = false; clearTimeout(feedbackTimer); } + wakeUp(); focusedMood(); + }); + form.addEventListener("focusout", () => requestAnimationFrame(focusedMood)); + form.addEventListener("input", () => { + feedback = false; focusedMood(); wakeUp(); + stage.classList.add("is-curious"); + clearTimeout(approachTimer); + approachTimer = setTimeout(() => stage.classList.remove("is-curious"), 1600); + }); + form.addEventListener("invalid", () => setMascotMood("error"), true); + form.addEventListener("reset", () => { + for (const button of form.querySelectorAll("[data-password-toggle]")) { + document.getElementById(button.dataset.passwordToggle).type = "password"; + button.setAttribute("aria-pressed", "false"); + button.setAttribute("aria-label", "Показать пароль"); + button.querySelector("use").setAttribute("href", "#i-eye"); + } + }); +} + +for (const button of auth.querySelectorAll("[data-password-toggle]")) { + button.addEventListener("click", () => { + const field = document.getElementById(button.dataset.passwordToggle); + const shown = field.type === "password"; + field.type = shown ? "text" : "password"; + button.setAttribute("aria-pressed", String(shown)); + button.setAttribute("aria-label", shown ? "Скрыть пароль" : "Показать пароль"); + button.querySelector("use").setAttribute("href", shown ? "#i-eye-off" : "#i-eye"); + feedback = false; wakeUp(); focusedMood(); + }); +} +for (const button of auth.querySelectorAll(".auth-switch button")) { + button.addEventListener("click", () => { + pending = feedback = false; + clearTimeout(feedbackTimer); wakeUp(); focusedMood(); + }); +} + +// Mouse events are combined into at most one update per browser frame. +auth.addEventListener("pointermove", event => { + if (event.pointerType === "touch" || reduceMotion.matches || auth.hidden || document.hidden) return; + pointer = { x: event.clientX, y: event.clientY }; + if (performance.now() - lastWake > 1000) { wakeUp(); lastWake = performance.now(); } + if (pointerFrame !== null) return; + pointerFrame = requestAnimationFrame(() => { + pointerFrame = null; + const rect = stage.getBoundingClientRect(); + const x = Math.max(-4, Math.min(4, (pointer.x - rect.left - rect.width / 2) / 55)); + const y = Math.max(-3, Math.min(3, (pointer.y - rect.top - rect.height / 2) / 65)); + stage.style.setProperty("--gaze-x", `${x}px`); + stage.style.setProperty("--gaze-y", `${y}px`); + }); +}); +auth.addEventListener("pointerleave", () => { + stage.style.setProperty("--gaze-x", "0px"); stage.style.setProperty("--gaze-y", "0px"); +}); + +const close = document.getElementById("diagnostics-close"); +let closeHovered = false; +function reactToClose() { + stage.classList.toggle("is-scared", !close.closest("[hidden]") && + (closeHovered || close.matches(":focus-visible"))); +} +close.addEventListener("pointerenter", () => { closeHovered = true; reactToClose(); }); +close.addEventListener("pointerleave", () => { closeHovered = false; reactToClose(); }); +close.addEventListener("focus", reactToClose); +close.addEventListener("blur", reactToClose); +close.addEventListener("keydown", () => requestAnimationFrame(reactToClose)); +new MutationObserver(reactToClose).observe(document.getElementById("diagnostics-panel"), { attributes: true, attributeFilter: ["hidden"] }); + +function updateVisibility() { + const visible = !auth.hidden && !document.hidden; + stage.classList.toggle("is-visible", visible); + if (!visible) { + if (pointerFrame !== null) cancelAnimationFrame(pointerFrame); + pointerFrame = null; + clearTimeout(sleepTimer); clearTimeout(approachTimer); clearTimeout(feedbackTimer); + stage.classList.remove("is-curious", "is-sleepy"); + pending = feedback = false; + } else { wakeUp(); focusedMood(); } +} +new MutationObserver(updateVisibility).observe(auth, { attributes: true, attributeFilter: ["hidden"] }); +document.addEventListener("visibilitychange", updateVisibility); +function placeStage() { + if (mobile.matches) { + const anchor = document.getElementById("login-panel"); anchor.before(stage); + } else document.querySelector(".intro").append(stage); +} +mobile.addEventListener("change", placeStage); +placeStage(); updateVisibility(); + +export async function celebrateMascots() { + setMascotMood("success"); + if (!reduceMotion.matches) await new Promise(resolve => setTimeout(resolve, 650)); +} diff --git a/src/Messenger.Api/wwwroot/message-view.js b/src/Messenger.Api/wwwroot/message-view.js new file mode 100644 index 00000000..5c2469b7 --- /dev/null +++ b/src/Messenger.Api/wwwroot/message-view.js @@ -0,0 +1,96 @@ +// Each message keeps its own DOM element, identified by the message ID. +import { attachmentCard, clearAttachmentCards } from '/attachments.js'; +import { ReactionControls } from '/reactions.js'; +export class MessageView { + constructor(list) { + this.list = list; + this.messages = new Map(); + this.days = new Map(); + } + + clear() { + clearAttachmentCards(); + this.messages.clear(); + this.days.clear(); + this.list.replaceChildren(); + } + + render(messages, userId, members, animate = false) { + const nodes = [], entering = []; + const hadMessages = this.messages.size > 0; + let previous = null, previousDay = ""; + + for (const message of messages) { + const date = new Date(message.created_at); + const day = date.toLocaleDateString("ru-RU", { day: "numeric", month: "long", year: "numeric" }); + if (day !== previousDay) { + if (!this.days.has(day)) { + const divider = document.createElement("div"); + divider.className = "date-separator"; + divider.textContent = day; + this.days.set(day, divider); + } + nodes.push(this.days.get(day)); + } + + let entry = this.messages.get(message.id); + if (!entry) { + const article = document.createElement("article"); + article.className = "message"; + article.dataset.messageId = message.id; + const author = document.createElement("span"); + author.className = "message-author"; + const bubble = document.createElement("div"); + bubble.className = "message-bubble"; + const text = document.createElement("p"); + text.className = "message-text"; + const stamp = document.createElement("time"); + stamp.className = "message-time"; + bubble.append(text, ...((message.attachment_ids || []).map(attachmentCard)), stamp); + const reactions = new ReactionControls(message.id); + article.append(author, bubble, reactions.root); + entry = { article, author, text, stamp, reactions }; + this.messages.set(message.id, entry); + if (animate && hadMessages) entering.push(article); + } + + const mine = message.sender_id === userId; + const grouped = previousDay === day && previous?.sender_id === message.sender_id && + date.getTime() - new Date(previous.created_at).getTime() <= 5 * 60 * 1000; + entry.article.classList.toggle("mine", mine); + entry.article.classList.toggle("grouped", grouped); + entry.author.hidden = mine || grouped; + entry.author.title = message.sender_id; + setText(entry.author, members.get(message.sender_id)?.display_name || "Участник " + message.sender_id.slice(0, 8)); + setText(entry.text, message.text); + entry.text.hidden = !message.text; + entry.stamp.dateTime = message.created_at; + setText(entry.stamp, date.toLocaleTimeString("ru-RU", { hour: "2-digit", minute: "2-digit" })); + nodes.push(entry.article); + previous = message; + previousDay = day; + } + + // Keep existing nodes in place. Insert only new or reordered nodes. + const wanted = new Set(nodes); + for (const node of [...this.list.children]) { + if (!wanted.has(node)) node.remove(); + } + let next = this.list.firstChild; + for (const node of nodes) { + if (node === next) next = next.nextSibling; + else this.list.insertBefore(node, next); + } + if (!matchMedia("(prefers-reduced-motion: reduce)").matches) { + for (const node of entering) node.animate([{ opacity: 0, transform: "translateY(5px)" }, { opacity: 1, transform: "none" }], { duration: 190, easing: "ease-out" }); + } + } + + renderReactions(items, busy) { + for (const [id, entry] of this.messages) entry.reactions.render(items.get(id) || [], busy.has(id)); + } +} + +function setText(element, text) { + if (element.textContent !== text) element.textContent = text; +} diff --git a/src/Messenger.Api/wwwroot/polish.css b/src/Messenger.Api/wwwroot/polish.css new file mode 100644 index 00000000..df0ae386 --- /dev/null +++ b/src/Messenger.Api/wwwroot/polish.css @@ -0,0 +1,41 @@ +/* Shared details for the chat list, generated avatars and gentle motion. */ +.avatar { overflow: hidden; background: transparent; border-color: #ffffff14; } +.avatar .avatar-art { display: block; width: 100%; height: 100%; stroke: none; } +.avatar-art text { letter-spacing: -.5px; } +.profile .avatar { background: transparent; } +.chat-row.active .avatar { background: transparent; border-color: #ffe13545; } +.chat-row { padding: 14px 11px; gap: 12px; } +.chat-row.active { background: #ffe1350b; border-color: #ffe13528; } +.chat-row.active::after { display: none; } +.chat-row-heading { display: flex; align-items: baseline; gap: 8px; min-width: 0; } +.chat-row-heading strong { flex: 1; min-width: 0; padding: 0; color: #e7e6dc; } +.chat-row-heading time { flex-shrink: 0; font-size: 10px; color: #a5a598; font-variant-numeric: tabular-nums; } +.chat-row.active .chat-row-heading strong { color: var(--accent); } +.chat-row.active .chat-row-heading time { color: #d4c878; } +.chat-preview { display: block; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; line-height: 1.5; } +.search-field > svg { width: 17px; height: 17px; color: var(--muted); } +.action-arrow { width: 20px; height: 20px; } +.member-item { grid-template-columns: 38px minmax(0, 1fr); gap: 12px; align-items: start; } +.member-item .avatar { width: 38px; height: 38px; border-radius: 12px; } +.member-details { display: grid; min-width: 0; gap: 8px; } +.member-details code { padding: 9px 10px; } +.message-scroll { background-size: 320px 280px; } +.messages-loading { display: grid; gap: 15px; padding: 22px 0; } +.messages-loading i { display: block; width: 48%; max-width: 240px; height: 53px; border-radius: 16px 16px 16px 5px; background: #ffffff06; } +.messages-loading i:nth-child(2) { justify-self: end; width: 37%; border-radius: 16px 16px 5px 16px; background: #ffe1350b; } +.messages-loading i:nth-child(3) { width: 58%; } +.send-button { transition: background .18s, transform .18s; } +.send-button:not(:disabled):active { transform: scale(.93); } +.send-button:not(:disabled):hover svg { transform: translate(1px, -1px); } +.send-button svg { transition: transform .18s; } +.icon-button.is-loading svg { animation: refresh-turn .9s linear infinite; } +.kolo-ear-left { transform-origin: 108px 135px; } +.kolo-ear-right { transform-origin: 195px 135px; } +.mascot-stage[data-mood=idle] .kolo-ear-left { animation: ear-settle 9s ease-in-out infinite; } +.spirit-svg { filter: drop-shadow(0 8px 12px #00000014); } +@keyframes refresh-turn { to { transform: rotate(360deg); } } +@keyframes ear-settle { 0%, 78%, 90%, 100% { transform: rotate(0); } 82% { transform: rotate(-3deg); } 86% { transform: rotate(2deg); } } +@media (prefers-reduced-motion: reduce) { + .mascot-stage[data-mood=idle] .kolo-ear-left, .icon-button.is-loading svg { animation: none; } + .send-button, .send-button svg { transition: none; } +} diff --git a/src/Messenger.Api/wwwroot/reactions.js b/src/Messenger.Api/wwwroot/reactions.js new file mode 100644 index 00000000..4eaa0a75 --- /dev/null +++ b/src/Messenger.Api/wwwroot/reactions.js @@ -0,0 +1,45 @@ +const choices = [['like','👍','Нравится'],['love','❤️','Сердце'],['laugh','😂','Смешно'],['mushroom','🍄','Гриб']]; + +export class ReactionControls { + constructor(messageId) { + this.root = document.createElement('div'); this.root.className = 'reaction-controls'; + this.badges = new Map(); this.items = []; + this.picker = document.createElement('button'); this.picker.type = 'button'; this.picker.className = 'reaction-picker'; + this.picker.textContent = '☺+'; this.picker.setAttribute('aria-label', 'Добавить реакцию'); this.picker.setAttribute('aria-expanded','false'); + this.menu = document.createElement('div'); this.menu.className = 'reaction-menu'; this.menu.hidden = true; + this.menu.setAttribute('role','group'); this.menu.setAttribute('aria-label','Выберите реакцию'); + this.root.append(this.picker, this.menu); + const choose = reaction => { + this.close(); + this.root.dispatchEvent(new CustomEvent('reactionchange', { bubbles: true, + detail: { messageId, reaction, present: !this.items.find(item => item.reaction === reaction)?.mine } })); + }; + for (const [reaction, emoji, label] of choices) { + const button = document.createElement('button'); button.type = 'button'; button.textContent = emoji; + button.setAttribute('aria-label',label); button.addEventListener('click',() => choose(reaction)); this.menu.append(button); + const badge = document.createElement('button'); badge.type = 'button'; badge.className = 'reaction-button'; badge.hidden = true; + badge.dataset.reaction = reaction; badge.addEventListener('click',() => choose(reaction)); + this.root.insertBefore(badge,this.picker); this.badges.set(reaction,{badge,emoji,label}); + } + this.picker.addEventListener('click',() => { + this.menu.hidden = !this.menu.hidden; this.picker.setAttribute('aria-expanded',String(!this.menu.hidden)); + if (!this.menu.hidden) this.menu.querySelector('button').focus(); + }); + this.root.addEventListener('keydown',event => { if (event.key === 'Escape') { this.close(); this.picker.focus(); event.stopPropagation(); } }); + this.root.addEventListener('focusout',event => { if (!this.root.contains(event.relatedTarget)) this.close(); }); + } + close() { this.menu.hidden = true; this.picker.setAttribute('aria-expanded','false'); } + render(items = [], busy = false) { + const signature = JSON.stringify([items,busy]); + if (signature === this.signature) return; + this.signature = signature; this.items = items; + for (const [reaction, {badge,emoji,label}] of this.badges) { + const item = items.find(item => item.reaction === reaction); + badge.hidden = !item?.count; + badge.textContent = `${emoji} ${item?.count || 0}`; + badge.setAttribute('aria-label',`${label}: ${item?.count || 0}${item?.mine ? ', ваша реакция' : ''}`); + badge.setAttribute('aria-pressed',String(Boolean(item?.mine))); + } + for (const button of this.root.querySelectorAll('button')) button.disabled = busy; + } +} diff --git a/src/Messenger.Api/wwwroot/showcase.css b/src/Messenger.Api/wwwroot/showcase.css new file mode 100644 index 00000000..f4f0e2e9 --- /dev/null +++ b/src/Messenger.Api/wwwroot/showcase.css @@ -0,0 +1,41 @@ +.cluster-section { margin-bottom: 18px; padding-bottom: 18px; border-bottom: 1px solid var(--border); } +.cluster-section h3 { margin: 0; font-size: 15px; color: #eeeadd; } +.cluster-live { display: inline-flex; align-items: center; gap: 5px; color: #b9d99f; font-size: 9px; letter-spacing: 1px; } +.cluster-live::before { content: ''; width: 5px; height: 5px; border-radius: 50%; background: currentColor; } +.cluster-status { font-size: 11px; color: var(--muted); line-height: 1.6; margin: 10px 0 14px; } +.cluster-graph { display: grid; justify-items: center; gap: 16px; position: relative; isolation: isolate; } +.cluster-graph::before { content: ''; position: absolute; top: 10px; bottom: 15px; width: 1px; background: #706b4360; z-index: -1; } +.cluster-node { background: #30312c; border: 1px solid #535447; border-radius: 11px; text-align: center; padding: 10px; transition: border-color .25s, background .25s; min-width: 0; } +.cluster-node strong { display: block; font-size: 11px; color: #ecebdc; } +.cluster-node span, .cluster-node small { display: block; font-size: 9px; margin-top: 5px; color: var(--muted); } +.cluster-browser, .cluster-balancer { width: 70%; } +.cluster-balancer[data-state=up] { border-color: #8e8552; } +.cluster-instances, .cluster-stores { display: grid; grid-template-columns: repeat(2,minmax(0,1fr)); width: 100%; gap: 8px; } +.cluster-instances, .cluster-stores { position: relative; } +.cluster-instances::before, .cluster-stores::before { content: ''; position: absolute; top: -8px; left: 25%; right: 25%; border-top: 1px solid #706b4360; } +.cluster-api, .cluster-stores .cluster-node { position: relative; } +.cluster-api::before, .cluster-stores .cluster-node::before { content: ''; position: absolute; top: -9px; left: 50%; height: 8px; border-left: 1px solid #706b4360; } +.cluster-api[data-state=up] span { color: #b9d99f; } +.cluster-node[data-state=down] { background: #3b302e; border-color: #a36154; } +.cluster-node[data-state=down] span { color: #ffb2a2; } +.cluster-node[data-state=unknown] { border-style: dashed; } +.cluster-api.just-served { border-color: var(--accent); background: #48442b; box-shadow: 0 0 0 3px #ffe1350b; } +.cluster-detail { font: 10px/1.7 ui-monospace,monospace; color: #dbd4a3; min-height: 34px; margin: 13px 0 8px; overflow-wrap: anywhere; } +.cluster-section .text-button { font-size: 11px; padding: 7px 0; } +.cluster-note { font-size: 10px; line-height: 1.65; color: var(--muted); } +.cluster-demo { border-top: 1px solid var(--border); margin-top: 10px; padding-top: 12px; } +.cluster-demo summary { color: var(--accent); font-size: 11px; cursor: pointer; } +.cluster-command { display: block; font: 10px/1.7 ui-monospace,monospace; color: #dfdabe; background: #252623; border: 1px solid var(--border); padding: 10px; border-radius: 9px; overflow-wrap: anywhere; user-select: all; margin: 10px 0; } +.reaction-controls { display: flex; gap: 4px; align-items: center; flex-wrap: wrap; min-height: 25px; } +.message.mine .reaction-controls { justify-content: flex-end; } +.reaction-button, .reaction-picker { border: 1px solid #62624b; background: #30312b; color: #e6e2cd; border-radius: 16px; font-size: 12px; min-height: 26px; min-width: 32px; padding: 3px 8px; line-height: 1.4; } +.reaction-button[aria-pressed=true] { background: #ffe1351a; border-color: #b8aa4f; color: var(--accent); } +.reaction-button:hover, .reaction-picker:hover { border-color: var(--accent); } +.reaction-picker { color: var(--muted); font-size: 15px; opacity: .35; } +.message:hover .reaction-picker, .message:focus-within .reaction-picker { opacity: 1; } +.reaction-menu { display: flex; gap: 3px; background: #292a25; border: 1px solid #62624b; border-radius: 18px; padding: 3px; } +.reaction-menu button { background: transparent; border: 0; border-radius: 12px; padding: 5px 7px; font-size: 17px; } +.reaction-menu button:hover { background: #ffe13518; } +.reaction-error { font-size: 10px; color: var(--danger); margin: 0; } +@media (hover:none) { .reaction-picker { opacity: .8; } } +@media (prefers-reduced-motion:reduce) { .cluster-node { transition:none; } } diff --git a/student-tests/attachments.py b/student-tests/attachments.py new file mode 100644 index 00000000..2d5a6061 --- /dev/null +++ b/student-tests/attachments.py @@ -0,0 +1,61 @@ +#!/usr/bin/env python3 +import sys,uuid,json,struct,zlib,concurrent.futures,time,subprocess,threading +from pathlib import Path +sys.path.insert(0,str(Path(__file__).resolve().parents[1]/'tests')) +from client import Client,arguments,check,run +ROOT=Path(__file__).resolve().parents[1] +def compose(*args,input=None): + r=subprocess.run([str(ROOT/'scripts/compose.sh'),*args],input=input,capture_output=True,cwd=ROOT) + check(r.returncode==0,'Infrastructure command failed: '+r.stderr.decode()[-600:]);return r.stdout + +def sql(text): return compose('exec','-T','postgres','psql','-U','messenger','-d','messenger','-At','-c',text).decode().strip() +def main(): + args=arguments('Attachment validation, access and parallel upload') + c=Client(args.base_url,args.ca_file,timeout=100);a,b,e,chat=c.bootstrap();path='/api/v1/chats/'+chat['id']+'/attachments?filename=' + image=(ROOT/'tests/fixtures/sample.png').read_bytes() + def upload(raw=image,name='image.png',mime='image/png',status=201,actor=a): + return c.call('POST',path+name,status,actor=actor,raw=raw,headers={'Content-Type':mime},schema='Attachment' if status==201 else None) + upload(name='../evil.png',status=400);upload(name='evil%5Cfile.png',status=400);upload(name='bad%00.png',status=400) + jpeg=(ROOT/'student-tests/fixtures/sample.jpg').read_bytes() + jpg=upload(raw=jpeg,name='photo.jpg',mime='image/jpeg')['json'] + check(c.call('GET','/api/v1/attachments/'+jpg['id']+'/content',actor=b)['bytes']==jpeg,'JPEG changed') + upload(raw=b'wrong',status=415);upload(mime='image/jpeg',status=415);upload(raw=image[:25],status=415) + upload(raw=b'x'*(10485760+1),status=413);upload(actor=e,status=404) + huge=bytearray(image);huge[16:24]=struct.pack('>II',10000,10000);huge[29:33]=struct.pack('>I',zlib.crc32(huge[12:29]));upload(raw=bytes(huge),status=413) + att=upload()['json'];content='/api/v1/attachments/'+att['id'] + c.call('GET',content,404,actor=e);c.call('GET',content+'/content',404,actor=e) + c.call('GET',content+'/content?variant=absent',404,actor=b) + other=c.call('POST','/api/v1/chats',201,actor=a,body={'title':'Other','member_ids':[a['id']]},schema='Chat')['json'] + c.call('POST','/api/v1/chats/'+other['id']+'/messages',404,actor=a,body={'text':'','attachment_ids':[att['id']]},headers={'Idempotency-Key':uuid.uuid4().hex}) + key=uuid.uuid4().hex;first=c.message(a,chat,'',attachments=[att['id']],key=key)['json'] + check(c.message(a,chat,'',attachments=[att['id']],key=key)['json']==first,'attachment replay differs') + c.call('POST','/api/v1/chats/'+chat['id']+'/messages',409,actor=a,body={'text':'changed','attachment_ids':[att['id']]},headers={'Idempotency-Key':key}) + # 10 real 1024x1024 PNG uploads, synchronized start; sample cgroup memory while running. + width=1024;raw=bytearray() + import random + rng=random.Random(104) + for _ in range(width): raw+=b'\0'+rng.randbytes(width*3) + def chunk(kind,data): return struct.pack('>I',len(data))+kind+data+struct.pack('>I',zlib.crc32(kind+data)) + medium=b'\x89PNG\r\n\x1a\n'+chunk(b'IHDR',struct.pack('>IIBBBBB',width,width,8,2,0,0,0))+chunk(b'IDAT',zlib.compress(bytes(raw),1))+chunk(b'IEND',b'') + ids=compose('ps','-q','api').decode().split();samples=[];stop=threading.Event() + def memory(): + while not stop.is_set(): + vals=[] + for cid in ids: + out=subprocess.check_output(['docker','exec',cid,'cat','/sys/fs/cgroup/memory.current']);vals.append(int(out)) + samples.append({'at':time.time(),'bytes':vals});stop.wait(.1) + barrier=threading.Barrier(10) + def parallel(i): + barrier.wait();t=time.monotonic();upload(raw=medium,name='parallel-'+str(i)+'.png');return time.monotonic()-t + poll=threading.Thread(target=memory);poll.start();started=time.monotonic() + try: + with concurrent.futures.ThreadPoolExecutor(max_workers=10) as ex: times=list(ex.map(parallel,range(10))) + finally:stop.set();poll.join() + report={'checks':['filename','size','decoded pixels','damaged image','MIME mismatch','private chat','foreign attachment','idempotency'], + 'concurrency':10,'file_bytes':len(medium),'decoded_pixels':width*width,'seconds':time.monotonic()-started, + 'successful_uploads':10,'errors':0,'p95_seconds':sorted(times)[-1], + 'peak_api_cgroup_bytes':[max(s['bytes'][i] for s in samples) for i in range(len(ids))], + 'samples':samples,'limits':'512 MiB per API; one decoder/upload per API; 64 KiB copy buffer'} + (ROOT/'evidence/attachments.json').write_text(json.dumps(report,indent=2)+'\n') + print('PASS: attachment validation, access, replay and 10 parallel uploads') +if __name__=='__main__':run(main) diff --git a/student-tests/consistency.py b/student-tests/consistency.py new file mode 100644 index 00000000..55e6fefc --- /dev/null +++ b/student-tests/consistency.py @@ -0,0 +1,105 @@ +#!/usr/bin/env python3 +import sys,time,json,uuid,hashlib,subprocess,socket +from pathlib import Path +sys.path.insert(0,str(Path(__file__).resolve().parent)) +from attachments import ROOT,compose,sql +sys.path.insert(0,str(ROOT/'tests')) +from client import Client,arguments,check,run + +def s3(method,key,data=b'',signed=True,bucket='messenger'): + command='curl -sS --max-time 20 -w "\\n%{http_code}" ' + if signed: command+='--aws-sigv4 aws:amz:us-east-1:s3 --user "$(cat /run/secrets/s3_access):$(cat /run/secrets/s3_secret)" ' + command+='-H x-amz-content-sha256:'+hashlib.sha256(data).hexdigest()+' -X '+method+' ' + if method=='PUT':command+='--data-binary @- ' + command+='http://s3:8333/'+bucket+'/'+key + raw=compose('exec','-T','api','sh','-c',command,input=data) + body,status=raw.rsplit(b'\n',1);return int(status),body + +def reconcile(apply=False): + args=['exec','-T','-e','RECONCILE_GRACE_SECONDS=120','api','dotnet','Messenger.Api.dll','--reconcile'] + if apply:args.append('--apply') + out=compose(*args).decode() + return json.loads(next(line for line in out.splitlines() if line.startswith('{'))) + +def main(): + args=arguments('S3/PostgreSQL failures and reconciliation') + c=Client(args.base_url,args.ca_file,timeout=100);a,b,e,chat=c.bootstrap();events=[] + image=(ROOT/'tests/fixtures/sample.png').read_bytes() + linked,_=c.attachment(a,chat);c.message(a,chat,'keep',attachments=[linked['id']]) + abandoned,_=c.attachment(a,chat) + missing,_=c.attachment(a,chat);c.message(a,chat,'missing',attachments=[missing['id']]) + key=lambda att:sql("SELECT object_key FROM attachments WHERE id='"+att['id']+"'") + linkedkey=key(linked);missingkey=key(missing) + check(s3('GET',linkedkey,signed=False)[0]==403,'bucket permits anonymous download') + check(s3('PUT','blocked',image,bucket='other-bucket')[0] in (403,404),'API credentials can write another bucket') + check(s3('DELETE',missingkey)[0]==204,'could not inject missing object') + events.append('Private bucket and scoped credentials; injected missing S3 object') + # Fail the DB write after successful S3 PUT. No production test switch is installed. + sql("CREATE FUNCTION test_attachment_failure() RETURNS trigger LANGUAGE plpgsql AS $$ BEGIN IF NEW.filename='injected-db-failure.png' THEN RAISE EXCEPTION 'test'; END IF; RETURN NEW; END $$; CREATE TRIGGER test_attachment_failure BEFORE INSERT ON attachments FOR EACH ROW EXECUTE FUNCTION test_attachment_failure();") + try: + c.call('POST','/api/v1/chats/'+chat['id']+'/attachments?filename=injected-db-failure.png',503,actor=a,raw=image,headers={'Content-Type':'image/png'}) + finally: + sql('DROP TRIGGER test_attachment_failure ON attachments; DROP FUNCTION test_attachment_failure();') + meta_missing,_=c.attachment(a,chat);c.message(a,chat,'metadata link',attachments=[meta_missing['id']]);meta_key=key(meta_missing) + sql("DELETE FROM attachments WHERE id='"+meta_missing['id']+"'") + orphan='originals/'+uuid.uuid4().hex + check(s3('PUT',orphan,image)[0]==200,'orphan injection failed') + # Partial HTTP upload is never published. + from urllib.parse import urlsplit + target=urlsplit(args.base_url);sock=socket.create_connection((target.hostname,target.port or 80)) + head=(f"POST /api/v1/chats/{chat['id']}/attachments?filename=partial.png HTTP/1.1\r\nHost: localhost\r\nAuthorization: Bearer {a['token']}\r\nContent-Type: image/png\r\nContent-Length: 100000\r\n\r\n").encode() + sock.sendall(head+image[:20]);sock.close();time.sleep(1) + check(sql("SELECT count(*) FROM attachments WHERE filename='partial.png'")=='0','partial upload was published') + # S3 outage: metadata remains, synchronous bytes/upload path is unavailable. + compose('stop','s3') + try: + # HAProxy can itself produce 503 if both readiness checks have already failed. + import urllib.request,urllib.error + deadline=time.monotonic()+10 + while True: + try: + urllib.request.urlopen(args.base_url+'/health/ready',timeout=5) + check(time.monotonic()deadline:raise + time.sleep(1) + events.append('Interrupted upload not published; DB failure after PUT leaves reconcilable orphan; S3 outage recovers') + fresh=reconcile();check(not any(x.get('key')==orphan or x.get('id') in [linked['id'],missing['id'],abandoned['id']] for x in fresh['actions']),'fresh attachment was selected') + print('Fresh records protected; waiting for the 120-second safety interval',flush=True) + created=time.monotonic() + # Wait for server-side LastModified as well as metadata age; timestamps are not forged. + remaining=max(0,135-(time.time()-__import__('datetime').datetime.fromisoformat(linked['created_at'].replace('Z','+00:00')).timestamp())) + while remaining>0: + time.sleep(min(20,remaining));remaining-=min(20,remaining) + dry=reconcile();check(s3('GET',orphan)[0]==200,'dry-run mutated S3') + kinds={x['kind'] for x in dry['actions']};check({'orphan','missing','unreferenced'}<=kinds,'not all inconsistencies detected') + apply=reconcile(True) + check(s3('GET',orphan)[0]==404,'orphan not deleted') + check(sql("SELECT count(*) FROM attachments WHERE id='"+abandoned['id']+"'")=='0','abandoned metadata left') + check(sql("SELECT status FROM attachments WHERE id='"+missing['id']+"'")=='missing','missing original not marked') + check(s3('GET',linkedkey)[1]==image,'used original removed or changed') + check(s3('GET',meta_key)[1]==image,'used original without metadata was removed') + new,_=c.attachment(a,chat);freshkey=key(new) + again=reconcile(True) + check(s3('GET',freshkey)[0]==200,'fresh original removed') + check(sql("SELECT count(*) FROM attachments WHERE id='"+linked['id']+"'")=='1','used metadata removed') + check(not any(x['kind'] in ('orphan','unreferenced') for x in again['actions']),'second run has remaining garbage') + scan_samples=[reconcile() for _ in range(3)] + report={'scan_samples':scan_samples,'checks':events+['dry-run is read-only','old orphan and unused data removed','referenced missing marked, link retained','fresh and referenced originals preserved, including missing metadata','repeat is idempotent'], + 'dry_run':dry,'apply':apply,'repeat':again,'safety_wait_seconds':time.monotonic()-created,'assumption':'exclusive PostgreSQL advisory gate; all app writers use shared gate; 120s minimum grace; no automatic restore without backup'} + h=hashlib.sha256() + for source in sorted((ROOT/'src/Messenger.Api').rglob('*.cs')): + if 'bin' in source.parts or 'obj' in source.parts:continue + h.update(str(source.relative_to(ROOT/'src/Messenger.Api')).encode());h.update(source.read_bytes()) + report['source_sha256']=h.hexdigest() + report['environment']=subprocess.check_output(['docker','info','--format','{{.OSType}} {{.Architecture}} {{.NCPU}} CPUs {{.MemTotal}} bytes RAM']).decode().strip() + (ROOT/'evidence/consistency.json').write_text(json.dumps(report,indent=2)+'\n') + print('PASS: storage failures, dry-run, safe repair, repeat and protected files') +if __name__=='__main__':run(main) diff --git a/student-tests/fixtures/sample.jpg b/student-tests/fixtures/sample.jpg new file mode 100644 index 0000000000000000000000000000000000000000..2b89dbf129a53fa051fa8db27d25d7dc0e138f9a GIT binary patch literal 8506 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 Date: Tue, 10 Nov 2026 10:58:00 +0300 Subject: [PATCH 2/2] =?UTF-8?q?=D0=94=D0=BE=D0=B1=D0=B0=D0=B2=D0=B8=D1=82?= =?UTF-8?q?=D1=8C=20=D1=81=D1=81=D1=8B=D0=BB=D0=BA=D1=83=20=D0=BD=D0=B0=20?= =?UTF-8?q?PR=20=D0=B2=20=D0=BE=D1=82=D1=87=D1=91=D1=82?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- REPORT.md | 1 + 1 file changed, 1 insertion(+) diff --git a/REPORT.md b/REPORT.md index e04bdefc..6c9c9f92 100644 --- a/REPORT.md +++ b/REPORT.md @@ -2,6 +2,7 @@ Автор: Каменский Никита, БВТ-2302. Цель: 5, трек 2 «Согласованность двух хранилищ». +PR: [ЛР 4 - БВТ-2302 - Каменский - на 5](https://gitea.privcloud.tech/mtusi2026/mtusi2026lab4/pulls/97). ## Запуск -- 2.54.0