From 3acc0de8de0096d2e2d9b324d8756570f5be7021 Mon Sep 17 00:00:00 2001 From: Babu Date: Thu, 29 Oct 2026 13:21:30 +0600 Subject: [PATCH] done --- .env.example | 88 + .gitignore | 43 + 1 | 1 - README.md | 305 + apps/backend/Dockerfile | 72 + apps/backend/nest-cli.json | 5 + apps/backend/package.json | 77 + apps/backend/prisma/add-allowed-companies.js | 20 + apps/backend/prisma/add-column.js | 30 + apps/backend/prisma/check-cols.js | 14 + apps/backend/prisma/clean-orphans.js | 26 + apps/backend/prisma/create-user-table.js | 41 + .../20261014062134_init/migration.sql | 224 + .../prisma/migrations/migration_lock.toml | 3 + apps/backend/prisma/schema.prisma | 329 + apps/backend/prisma/seed.ts | 212 + apps/backend/prisma/users_import.sql | 176 + apps/backend/src/app.module.ts | 34 + apps/backend/src/main.ts | 64 + .../src/modules/admin/admin.controller.ts | 248 + .../backend/src/modules/admin/admin.module.ts | 10 + .../src/modules/admin/admin.service.ts | 959 ++ .../admin/dto/admin-reset-password.dto.ts | 10 + .../src/modules/admin/dto/admin.dto.ts | 157 + .../src/modules/android/android.controller.ts | 150 + .../src/modules/android/android.module.ts | 13 + .../src/modules/android/android.service.ts | 327 + .../modules/android/dto/android-login.dto.ts | 44 + .../backend/src/modules/audit/audit.module.ts | 9 + .../src/modules/audit/audit.service.ts | 60 + .../src/modules/auth/auth.controller.ts | 138 + apps/backend/src/modules/auth/auth.module.ts | 27 + apps/backend/src/modules/auth/auth.service.ts | 344 + .../auth/decorators/current-user.decorator.ts | 26 + .../auth/decorators/roles.decorator.ts | 5 + .../modules/auth/dto/change-password.dto.ts | 15 + .../backend/src/modules/auth/dto/login.dto.ts | 15 + .../src/modules/auth/dto/refresh.dto.ts | 9 + .../src/modules/auth/dto/register.dto.ts | 32 + .../src/modules/auth/guards/jwt-auth.guard.ts | 5 + .../src/modules/auth/guards/roles.guard.ts | 37 + apps/backend/src/modules/auth/jwt.strategy.ts | 91 + .../backend/src/modules/files/dto/file.dto.ts | 47 + .../src/modules/files/file-validator.util.ts | 127 + .../src/modules/files/files.controller.ts | 178 + .../backend/src/modules/files/files.module.ts | 13 + .../src/modules/files/files.service.ts | 870 ++ .../src/modules/files/sharing.controller.ts | 19 + .../src/modules/folders/dto/folder.dto.ts | 29 + .../src/modules/folders/folders.controller.ts | 88 + .../src/modules/folders/folders.module.ts | 10 + .../src/modules/folders/folders.service.ts | 596 + .../permissions/dto/batch-permission.dto.ts | 44 + .../modules/permissions/dto/permission.dto.ts | 81 + .../permissions/permissions.controller.ts | 105 + .../modules/permissions/permissions.module.ts | 11 + .../permissions/permissions.service.ts | 529 + .../src/modules/prisma/prisma.module.ts | 9 + .../src/modules/prisma/prisma.service.ts | 13 + .../share-links/dto/create-share-link.dto.ts | 40 + .../share-links/share-links.controller.ts | 163 + .../modules/share-links/share-links.module.ts | 14 + .../share-links/share-links.service.ts | 583 + .../modules/video/video-processor.service.ts | 326 + .../src/modules/video/video-queue.service.ts | 96 + .../modules/video/video-stream.controller.ts | 211 + .../backend/src/modules/video/video.module.ts | 11 + apps/backend/test/access-control.e2e-spec.ts | 213 + apps/backend/test/jest-e2e.json | 10 + .../backend/test/video-processing.e2e-spec.ts | 97 + apps/backend/tsconfig.json | 27 + apps/frontend/Dockerfile | 48 + apps/frontend/next-env.d.ts | 6 + apps/frontend/next.config.ts | 21 + apps/frontend/package.json | 31 + apps/frontend/postcss.config.mjs | 8 + apps/frontend/public/ecohub-logo.png | Bin 0 -> 100981 bytes apps/frontend/public/favicon.ico | Bin 0 -> 100981 bytes apps/frontend/public/logo.png | Bin 0 -> 100981 bytes .../src/app/admin/android-api/page.tsx | 1318 ++ apps/frontend/src/app/admin/audit/page.tsx | 545 + apps/frontend/src/app/admin/files/page.tsx | 413 + .../src/app/admin/permissions/page.tsx | 357 + apps/frontend/src/app/admin/users/page.tsx | 998 ++ apps/frontend/src/app/dashboard/page.tsx | 325 + apps/frontend/src/app/files/page.tsx | 1167 ++ apps/frontend/src/app/globals.css | 103 + apps/frontend/src/app/icon.png | Bin 0 -> 100981 bytes apps/frontend/src/app/layout.tsx | 82 + apps/frontend/src/app/login/page.tsx | 165 + apps/frontend/src/app/not-found.tsx | 23 + apps/frontend/src/app/page.tsx | 27 + apps/frontend/src/app/register/page.tsx | 229 + apps/frontend/src/app/s/[token]/page.tsx | 605 + apps/frontend/src/app/shared/page.tsx | 229 + apps/frontend/src/app/video/[id]/page.tsx | 198 + .../admin/AdminResetPasswordModal.tsx | 153 + .../src/components/admin/BatchGrantModal.tsx | 342 + .../src/components/admin/CreateUserModal.tsx | 547 + .../src/components/admin/DeleteUserModal.tsx | 178 + .../src/components/admin/EditUserModal.tsx | 620 + .../components/admin/GrantPermissionModal.tsx | 412 + .../src/components/common/EcohubLogo.tsx | 58 + .../src/components/common/EcohubWatermark.tsx | 58 + .../src/components/common/HydrationGuard.tsx | 110 + .../components/file-manager/Breadcrumbs.tsx | 48 + .../src/components/file-manager/FileCard.tsx | 300 + .../file-manager/FilePreviewModal.tsx | 148 + .../src/components/file-manager/FileRow.tsx | 221 + .../components/files/CreateShareLinkModal.tsx | 342 + .../components/layout/ChangePasswordModal.tsx | 194 + .../frontend/src/components/layout/Navbar.tsx | 141 + .../src/components/layout/Sidebar.tsx | 175 + .../components/uploader/FileUploaderModal.tsx | 242 + .../video-player/HlsVideoPlayer.tsx | 337 + apps/frontend/src/context/auth-context.tsx | 111 + apps/frontend/src/lib/api-client.ts | 303 + apps/frontend/src/lib/utils.ts | 92 + apps/frontend/tailwind.config.ts | 53 + apps/frontend/tsconfig.json | 28 + database/fileshare_db.sql | 1022 ++ docker-compose.yml | 128 + package-lock.json | 12200 ++++++++++++++++ package.json | 40 + packages/shared/package.json | 15 + packages/shared/src/index.ts | 172 + packages/shared/tsconfig.json | 17 + scripts/prisma-generate.js | 44 + scripts/start-all.js | 85 + scripts/stop-servers.js | 35 + start-linux.sh | 46 + start-windows.bat | 38 + 132 files changed, 35007 insertions(+), 1 deletion(-) create mode 100644 .env.example create mode 100644 .gitignore delete mode 100644 1 create mode 100644 README.md create mode 100644 apps/backend/Dockerfile create mode 100644 apps/backend/nest-cli.json create mode 100644 apps/backend/package.json create mode 100644 apps/backend/prisma/add-allowed-companies.js create mode 100644 apps/backend/prisma/add-column.js create mode 100644 apps/backend/prisma/check-cols.js create mode 100644 apps/backend/prisma/clean-orphans.js create mode 100644 apps/backend/prisma/create-user-table.js create mode 100644 apps/backend/prisma/migrations/20261014062134_init/migration.sql create mode 100644 apps/backend/prisma/migrations/migration_lock.toml create mode 100644 apps/backend/prisma/schema.prisma create mode 100644 apps/backend/prisma/seed.ts create mode 100644 apps/backend/prisma/users_import.sql create mode 100644 apps/backend/src/app.module.ts create mode 100644 apps/backend/src/main.ts create mode 100644 apps/backend/src/modules/admin/admin.controller.ts create mode 100644 apps/backend/src/modules/admin/admin.module.ts create mode 100644 apps/backend/src/modules/admin/admin.service.ts create mode 100644 apps/backend/src/modules/admin/dto/admin-reset-password.dto.ts create mode 100644 apps/backend/src/modules/admin/dto/admin.dto.ts create mode 100644 apps/backend/src/modules/android/android.controller.ts create mode 100644 apps/backend/src/modules/android/android.module.ts create mode 100644 apps/backend/src/modules/android/android.service.ts create mode 100644 apps/backend/src/modules/android/dto/android-login.dto.ts create mode 100644 apps/backend/src/modules/audit/audit.module.ts create mode 100644 apps/backend/src/modules/audit/audit.service.ts create mode 100644 apps/backend/src/modules/auth/auth.controller.ts create mode 100644 apps/backend/src/modules/auth/auth.module.ts create mode 100644 apps/backend/src/modules/auth/auth.service.ts create mode 100644 apps/backend/src/modules/auth/decorators/current-user.decorator.ts create mode 100644 apps/backend/src/modules/auth/decorators/roles.decorator.ts create mode 100644 apps/backend/src/modules/auth/dto/change-password.dto.ts create mode 100644 apps/backend/src/modules/auth/dto/login.dto.ts create mode 100644 apps/backend/src/modules/auth/dto/refresh.dto.ts create mode 100644 apps/backend/src/modules/auth/dto/register.dto.ts create mode 100644 apps/backend/src/modules/auth/guards/jwt-auth.guard.ts create mode 100644 apps/backend/src/modules/auth/guards/roles.guard.ts create mode 100644 apps/backend/src/modules/auth/jwt.strategy.ts create mode 100644 apps/backend/src/modules/files/dto/file.dto.ts create mode 100644 apps/backend/src/modules/files/file-validator.util.ts create mode 100644 apps/backend/src/modules/files/files.controller.ts create mode 100644 apps/backend/src/modules/files/files.module.ts create mode 100644 apps/backend/src/modules/files/files.service.ts create mode 100644 apps/backend/src/modules/files/sharing.controller.ts create mode 100644 apps/backend/src/modules/folders/dto/folder.dto.ts create mode 100644 apps/backend/src/modules/folders/folders.controller.ts create mode 100644 apps/backend/src/modules/folders/folders.module.ts create mode 100644 apps/backend/src/modules/folders/folders.service.ts create mode 100644 apps/backend/src/modules/permissions/dto/batch-permission.dto.ts create mode 100644 apps/backend/src/modules/permissions/dto/permission.dto.ts create mode 100644 apps/backend/src/modules/permissions/permissions.controller.ts create mode 100644 apps/backend/src/modules/permissions/permissions.module.ts create mode 100644 apps/backend/src/modules/permissions/permissions.service.ts create mode 100644 apps/backend/src/modules/prisma/prisma.module.ts create mode 100644 apps/backend/src/modules/prisma/prisma.service.ts create mode 100644 apps/backend/src/modules/share-links/dto/create-share-link.dto.ts create mode 100644 apps/backend/src/modules/share-links/share-links.controller.ts create mode 100644 apps/backend/src/modules/share-links/share-links.module.ts create mode 100644 apps/backend/src/modules/share-links/share-links.service.ts create mode 100644 apps/backend/src/modules/video/video-processor.service.ts create mode 100644 apps/backend/src/modules/video/video-queue.service.ts create mode 100644 apps/backend/src/modules/video/video-stream.controller.ts create mode 100644 apps/backend/src/modules/video/video.module.ts create mode 100644 apps/backend/test/access-control.e2e-spec.ts create mode 100644 apps/backend/test/jest-e2e.json create mode 100644 apps/backend/test/video-processing.e2e-spec.ts create mode 100644 apps/backend/tsconfig.json create mode 100644 apps/frontend/Dockerfile create mode 100644 apps/frontend/next-env.d.ts create mode 100644 apps/frontend/next.config.ts create mode 100644 apps/frontend/package.json create mode 100644 apps/frontend/postcss.config.mjs create mode 100644 apps/frontend/public/ecohub-logo.png create mode 100644 apps/frontend/public/favicon.ico create mode 100644 apps/frontend/public/logo.png create mode 100644 apps/frontend/src/app/admin/android-api/page.tsx create mode 100644 apps/frontend/src/app/admin/audit/page.tsx create mode 100644 apps/frontend/src/app/admin/files/page.tsx create mode 100644 apps/frontend/src/app/admin/permissions/page.tsx create mode 100644 apps/frontend/src/app/admin/users/page.tsx create mode 100644 apps/frontend/src/app/dashboard/page.tsx create mode 100644 apps/frontend/src/app/files/page.tsx create mode 100644 apps/frontend/src/app/globals.css create mode 100644 apps/frontend/src/app/icon.png create mode 100644 apps/frontend/src/app/layout.tsx create mode 100644 apps/frontend/src/app/login/page.tsx create mode 100644 apps/frontend/src/app/not-found.tsx create mode 100644 apps/frontend/src/app/page.tsx create mode 100644 apps/frontend/src/app/register/page.tsx create mode 100644 apps/frontend/src/app/s/[token]/page.tsx create mode 100644 apps/frontend/src/app/shared/page.tsx create mode 100644 apps/frontend/src/app/video/[id]/page.tsx create mode 100644 apps/frontend/src/components/admin/AdminResetPasswordModal.tsx create mode 100644 apps/frontend/src/components/admin/BatchGrantModal.tsx create mode 100644 apps/frontend/src/components/admin/CreateUserModal.tsx create mode 100644 apps/frontend/src/components/admin/DeleteUserModal.tsx create mode 100644 apps/frontend/src/components/admin/EditUserModal.tsx create mode 100644 apps/frontend/src/components/admin/GrantPermissionModal.tsx create mode 100644 apps/frontend/src/components/common/EcohubLogo.tsx create mode 100644 apps/frontend/src/components/common/EcohubWatermark.tsx create mode 100644 apps/frontend/src/components/common/HydrationGuard.tsx create mode 100644 apps/frontend/src/components/file-manager/Breadcrumbs.tsx create mode 100644 apps/frontend/src/components/file-manager/FileCard.tsx create mode 100644 apps/frontend/src/components/file-manager/FilePreviewModal.tsx create mode 100644 apps/frontend/src/components/file-manager/FileRow.tsx create mode 100644 apps/frontend/src/components/files/CreateShareLinkModal.tsx create mode 100644 apps/frontend/src/components/layout/ChangePasswordModal.tsx create mode 100644 apps/frontend/src/components/layout/Navbar.tsx create mode 100644 apps/frontend/src/components/layout/Sidebar.tsx create mode 100644 apps/frontend/src/components/uploader/FileUploaderModal.tsx create mode 100644 apps/frontend/src/components/video-player/HlsVideoPlayer.tsx create mode 100644 apps/frontend/src/context/auth-context.tsx create mode 100644 apps/frontend/src/lib/api-client.ts create mode 100644 apps/frontend/src/lib/utils.ts create mode 100644 apps/frontend/tailwind.config.ts create mode 100644 apps/frontend/tsconfig.json create mode 100644 database/fileshare_db.sql create mode 100644 docker-compose.yml create mode 100644 package-lock.json create mode 100644 package.json create mode 100644 packages/shared/package.json create mode 100644 packages/shared/src/index.ts create mode 100644 packages/shared/tsconfig.json create mode 100644 scripts/prisma-generate.js create mode 100644 scripts/start-all.js create mode 100644 scripts/stop-servers.js create mode 100644 start-linux.sh create mode 100644 start-windows.bat diff --git a/.env.example b/.env.example new file mode 100644 index 0000000..847ba0d --- /dev/null +++ b/.env.example @@ -0,0 +1,88 @@ +# ============================================================== +# SECURE VIDEO & FILE SHARING MANAGEMENT SYSTEM - ENVIRONMENT CONFIG +# ============================================================== + +# Common Environment +NODE_ENV=production +PORT=4000 +FRONTEND_URL=http://localhost:3000 + +# -------------------------------------------------------------- +# 1. DATABASE CONFIGURATION (MySQL 8.0 / MariaDB) +# -------------------------------------------------------------- +# For Docker Compose: +DATABASE_URL="mysql://fileshare:fileshare_secure_pass@mysql:3306/fileshare_db" + +# For Windows Native (e.g. XAMPP or local MySQL): +# DATABASE_URL="mysql://root:@127.0.0.1:3306/fileshare_db" + +# For Linux Native (Ubuntu/Debian system MySQL): +# DATABASE_URL="mysql://fileshare_user:SecurePassword123!@127.0.0.1:3306/fileshare_db" + +# -------------------------------------------------------------- +# 2. JWT SECURITY KEYS (Use 64+ char random strings in production) +# -------------------------------------------------------------- +JWT_ACCESS_SECRET="dev_access_secret_cross_platform_secure_2026_key_123456" +JWT_ACCESS_EXPIRATION="15m" +JWT_REFRESH_SECRET="dev_refresh_secret_cross_platform_secure_2026_key_654321" +JWT_REFRESH_EXPIRATION="7d" + +# -------------------------------------------------------------- +# 3. CROSS-PLATFORM FILESYSTEM STORAGE CONFIGURATION +# -------------------------------------------------------------- +STORAGE_DRIVER=local + +# [A] For Docker Compose (Linux Container Volume): +LOCAL_STORAGE_PATH=/app/storage + +# [B] For Windows Native Deployment: +# Examples of Windows paths supported by StoragePathUtils: +# LOCAL_STORAGE_PATH=D:\Project\fileshareproject\storage +# LOCAL_STORAGE_PATH=C:\fileshare\storage +# LOCAL_STORAGE_PATH=../../storage + +# [C] For Linux Native Deployment (Ubuntu / Debian / CentOS): +# Examples of Linux POSIX paths supported: +# LOCAL_STORAGE_PATH=/var/lib/fileshare/storage +# LOCAL_STORAGE_PATH=/opt/fileshare/storage +# LOCAL_STORAGE_PATH=./storage + +# -------------------------------------------------------------- +# 4. S3 / MinIO OBJECT STORAGE (Optional: when STORAGE_DRIVER=s3) +# -------------------------------------------------------------- +S3_ENDPOINT=http://127.0.0.1:9000 +S3_REGION=us-east-1 +S3_BUCKET=fileshare-bucket +S3_ACCESS_KEY=minioadmin +S3_SECRET_KEY=minioadminpassword +S3_FORCE_PATH_STYLE=true + +# -------------------------------------------------------------- +# 5. REDIS QUEUE CONFIGURATION (BullMQ) +# -------------------------------------------------------------- +# Note: If Redis is offline, the backend automatically activates +# a resilient in-process background worker for video transcoding. +REDIS_HOST=127.0.0.1 +REDIS_PORT=6379 +REDIS_PASSWORD= + +# -------------------------------------------------------------- +# 6. FFMPEG & FFPROBE PATHS (Optional: auto-detected if empty) +# -------------------------------------------------------------- +# On Linux: Auto-detected from /usr/bin/ffmpeg or /usr/local/bin/ffmpeg +# On Windows: Auto-detected from PATH, C:\ffmpeg\bin, Chocolatey, or WinGet +# You can override with an explicit path if installed in a custom location: +# Windows Example: FFMPEG_PATH=C:\ffmpeg\bin\ffmpeg.exe +# Windows Example: FFPROBE_PATH=C:\ffmpeg\bin\ffprobe.exe +# Linux Example: FFMPEG_PATH=/usr/bin/ffmpeg +# Linux Example: FFPROBE_PATH=/usr/bin/ffprobe +FFMPEG_PATH= +FFPROBE_PATH= + +# -------------------------------------------------------------- +# 7. INITIAL BOOTSTRAP SUPER ADMIN CREDENTIALS +# -------------------------------------------------------------- +INITIAL_ADMIN_EMAIL=superadmin@fileshare.local +INITIAL_ADMIN_USERNAME=superadmin +INITIAL_ADMIN_PASSWORD=SuperAdmin@Secure2026! +INITIAL_ADMIN_FULLNAME="Super Administrator" diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..9390689 --- /dev/null +++ b/.gitignore @@ -0,0 +1,43 @@ +# Dependencies +node_modules/ +.pnp +.pnp.js + +# Build Outputs +dist/ +out/ +.next/ +apps/frontend/.next/ +apps/frontend/out/ +apps/backend/dist/ +packages/shared/dist/ +*.tsbuildinfo + +# Environment and Secrets +.env +.env.local +.env.development.local +.env.test.local +.env.production.local +!.env.example + +# Local Storage, Uploads and Database files +storage/ +storage/** +uploads/ +*.sqlite +*.sqlite3 + +# Logs +logs/ +*.log +npm-debug.log* +yarn-debug.log* +yarn-error.log* +pnpm-debug.log* + +# OS and Editor metadata +.DS_Store +Thumbs.db +.vscode/ +.idea/ diff --git a/1 b/1 deleted file mode 100644 index d800886..0000000 --- a/1 +++ /dev/null @@ -1 +0,0 @@ -123 \ No newline at end of file diff --git a/README.md b/README.md new file mode 100644 index 0000000..87c6363 --- /dev/null +++ b/README.md @@ -0,0 +1,305 @@ +# Secure Video & File Sharing Management System + +A production-grade, enterprise-ready full-stack web application designed for secure video streaming, file management, granular administrator-controlled sharing, and multi-tenant access control. + +Engineered from the ground up to run seamlessly and natively across **both Linux (Ubuntu, Debian, CentOS, RHEL, Arch) and Windows (Windows 10/11, Windows Server)**, as well as containerized in Docker. + +--- + +## ๐ŸŒŸ Key Features + +1. **Dual-OS Filesystem Architecture (Linux & Windows)**: + - Cross-platform storage engine (`StoragePathUtils` and `LocalStorageService`). + - Canonical POSIX database keys (`users/{userId}/files/{fileId}.{ext}`) mapped cleanly to native host OS paths (Windows drive letters & backslashes or Linux root POSIX paths). + - Strict directory traversal protection (`..` prevention) utilizing path-relative isolation. + - OS-native permission enforcement (`0o755` directory mode on Linux). + - FFmpeg auto-detection across standard Linux paths (`/usr/bin/ffmpeg`) and Windows paths (`C:\ffmpeg\bin`, WinGet, Chocolatey). + +2. **Adaptive Video Processing & Streaming Engine**: + - Automated FFprobe metadata extraction (resolution, duration, codecs). + - Video thumbnail frame extraction at keyframe intervals. + - H.264 / AAC HLS (HTTP Live Streaming) adaptive bitrate segmentation with `.m3u8` master playlists and `.ts` chunk streaming. + - Custom in-browser HLS.js player with resolution switching, playback rate controls, scrubbing, and frame stepping. + - Resilient background queue worker (BullMQ + Redis with fallback to in-process execution when Redis is offline). + +3. **Multi-Tenant Security & Granular Access Control**: + - Private user namespaces: User B cannot access User A's private files (complete IDOR protection). + - User-wise file explorer for administrators. + - Granular permission matrix: + - `canViewMetadata` + - `canPreview` + - `canPlay` (Stream video) โ€” **strictly does NOT grant download** + - `canDownload` (Decrypt / stream original raw binary file) + - `canListFolder` + - Real-time permission revocation: immediate server-side guard enforcement. + +4. **Storage Quota & Upload Pipeline**: + - Atomic quota reservation: rejects uploads before receiving bytes if quota exceeded. + - Upload session management with chunked progress tracking and instant direct uploads. + - Magic byte validation and MIME-type inspection (preventing file spoofing). + - Soft-delete lifecycle with immediate quota reclamation. + +5. **Compliance & Audit Logging**: + - Immutable chronological audit trail recording actions, actors, targets, IP addresses, user agents, and metadata payloads. + +--- + +## โšก 1 Single Command to Run Everything (Windows & Linux) + +Whether you are on **Windows** or **Linux**, you can run the entire system with just **ONE** command: + +### ๐Ÿš€ Production Mode (Backend + Frontend together): +```bash +npm start +``` + +### ๐Ÿ› ๏ธ Development Mode (With Hot-Reload & Watch): +```bash +npm run dev +``` + +### ๐Ÿณ Complete Docker Stack (MySQL, Redis, MinIO, Backend, Frontend): +```bash +npm run docker +``` + +--- + +## ๐Ÿ—๏ธ Technology Stack + +| Layer | Technologies | +|---|---| +| **Frontend** | Next.js 15 (App Router), React 19, TypeScript, Tailwind CSS, Lucide React, HLS.js | +| **Backend** | NestJS 11, TypeScript, Express, Helmet, CORS, Argon2id, Passport-JWT | +| **Database & ORM** | MySQL 8.0 / MariaDB, Prisma ORM 6 | +| **Video Engine** | FFmpeg, FFprobe, fluent-ffmpeg, HLS Transcoder | +| **Task Queue** | BullMQ, Redis 7 (with local resilient fallback runner) | +| **Storage Abstraction**| Local Filesystem Driver (Windows/Linux) + S3/MinIO Driver | +| **Documentation** | Swagger / OpenAPI 3.0 (`http://localhost:4000/api/docs`) | + +--- + +## ๐Ÿ’ป Operating System & Filesystem Setup + +### ๐ŸชŸ Hosting on Windows (Native) + +#### Prerequisites: +1. **Node.js**: v20.x or v22.x LTS ([nodejs.org](https://nodejs.org)) +2. **MySQL / MariaDB**: MySQL 8.0 or XAMPP running on `127.0.0.1:3306` +3. **FFmpeg**: Download from [gyan.dev/ffmpeg](https://www.gyan.dev/ffmpeg/builds/) or install via WinGet: + ```cmd + winget install Gyan.FFmpeg + ``` + +#### Configuration (`.env` in `apps/backend/.env`): +```env +PORT=4000 +FRONTEND_URL=http://localhost:3000 +DATABASE_URL="mysql://root:@127.0.0.1:3306/fileshare_db" + +# Windows Filesystem Path (either absolute or relative) +STORAGE_DRIVER=local +LOCAL_STORAGE_PATH=D:\Project\fileshareproject\storage +# or LOCAL_STORAGE_PATH=../../storage +``` + +#### One-Click Launch on Windows: +Double click `start-windows.bat` or run: +```cmd +start-windows.bat +``` + +--- + +### ๐Ÿง Hosting on Linux (Ubuntu / Debian / CentOS / RHEL) + +#### Prerequisites: +```bash +# Ubuntu / Debian +sudo apt-get update +sudo apt-get install -y nodejs npm ffmpeg mysql-server redis-server + +# CentOS / RHEL +sudo dnf install -y nodejs npm ffmpeg mysql-server redis +``` + +#### Database Setup: +```bash +sudo mysql -e "CREATE DATABASE fileshare_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;" +sudo mysql -e "CREATE USER 'fileshare'@'localhost' IDENTIFIED BY 'YourSecurePassword2026!';" +sudo mysql -e "GRANT ALL PRIVILEGES ON fileshare_db.* TO 'fileshare'@'localhost'; FLUSH PRIVILEGES;" +``` + +#### Configuration (`apps/backend/.env`): +```env +PORT=4000 +FRONTEND_URL=http://localhost:3000 +DATABASE_URL="mysql://fileshare:YourSecurePassword2026!@127.0.0.1:3306/fileshare_db" + +# Linux Filesystem Path (Standard POSIX with 0755 permissions) +STORAGE_DRIVER=local +LOCAL_STORAGE_PATH=/var/lib/fileshare/storage +# or LOCAL_STORAGE_PATH=./storage +``` + +#### Launch on Linux: +```bash +chmod +x start-linux.sh +./start-linux.sh +``` + +#### Optional: Linux Systemd Service (`/etc/systemd/system/fileshare-backend.service`) +```ini +[Unit] +Description=FileShare Backend NestJS Service +After=network.target mysql.service + +[Service] +Type=simple +User=www-data +WorkingDirectory=/var/www/fileshare/apps/backend +ExecStart=/usr/bin/node dist/main.js +Restart=on-failure +Environment=NODE_ENV=production +EnvironmentFile=/var/www/fileshare/apps/backend/.env + +[Install] +WantedBy=multi-user.target +``` + +--- + +### ๐Ÿณ Hosting with Docker & Docker Compose (Any OS) + +Run the entire stack (MySQL 8.0, Redis 7, Backend with FFmpeg, Frontend Next.js, and MinIO S3) with a single command: + +```bash +# Build and launch all containers +npm run docker:up +# or +docker compose up --build -d +``` + +- **Frontend App**: `http://localhost:3000` +- **Backend API & Swagger**: `http://localhost:4000/api/docs` +- **MinIO S3 Console**: `http://localhost:9001` (User: `minioadmin` / `minioadminpassword`) + +To view live container logs: +```bash +npm run docker:logs +``` + +To stop containers: +```bash +npm run docker:down +``` + +--- + +## ๐Ÿ‘ฅ Pre-Configured User Accounts + +The database comes pre-seeded with the following active accounts: + +| Role | Username | Email | Password | Initial Quota | Description | +|---|---|---|---|---|---| +| **Super Admin** | `Ecohub` | `ecohub@fileshare.local` | `Ecohub@520` | 100 GB | Full system control, quota manager, settings & audit logs | +| **Staff Officer**| `Ecohubstaff` | `ecohubstaff@fileshare.local` | `123` | 50 GB | Staff admin, user-wise file explorer, permission grants | +| **Normal User** | `ecouser` | `ecouser@fileshare.local` | `123` | 10 GB | Standard private vault, video streaming & sharing | + +> *Tip: On the `/login` page, you can click on any of the 1-Click Instant Login cards to populate credentials immediately.* + +--- + +## ๐Ÿ—„๏ธ MySQL Direct Import File (`users_import.sql`) + +For direct database seeding without running Node scripts, a standalone MySQL import script is provided in the root directory: [`users_import.sql`](file:///d:/Project/fileshareproject/users_import.sql). + +### How to Import into MySQL: + +#### Option 1: Via MySQL Command Line (Windows or Linux): +```bash +mysql -u root fileshare_db < users_import.sql +``` + +#### Option 2: Via phpMyAdmin or HeidiSQL: +1. Open **phpMyAdmin** or **HeidiSQL**. +2. Select the `fileshare_db` database. +3. Click the **Import** tab. +4. Choose the file [`users_import.sql`](file:///d:/Project/fileshareproject/users_import.sql) and click **Go**. +5. All three accounts (`Ecohub`, `Ecohubstaff`, `ecouser`), their Argon2id password hashes, and their root storage folders will be created immediately! + +--- + +## ๐Ÿงช Automated Test Suite + +Run the end-to-end integration and security test suites: + +```bash +# Access control, IDOR, and permission tests +cd apps/backend +npm run test:e2e +``` + +**Tested Scenarios**: +1. Cross-tenant isolation (User B receives `404 Not Found` when requesting User A's private file). +2. Separation of `canPlay` and `canDownload` (User B can stream HTTP 206 chunks but receives `403 Forbidden` on download). +3. Immediate permission revocation (granting and revoking reflects instantly on protected routes). +4. Administrator-only routes protection (User A denied access to `/admin/*`). +5. Video processing pipeline (FFprobe probe, thumbnail generation, HLS master playlist & TS chunks). + +--- + +## ๐Ÿ“ Repository Structure + +``` +fileshareproject/ +โ”œโ”€โ”€ docker-compose.yml # Multi-container orchestration (MySQL, Redis, Backend, Frontend) +โ”œโ”€โ”€ start-windows.bat # 1-click Windows launcher +โ”œโ”€โ”€ start-linux.sh # 1-click Linux launcher +โ”œโ”€โ”€ .env.example # Comprehensive multi-environment configuration +โ”œโ”€โ”€ packages/ +โ”‚ โ””โ”€โ”€ shared/ # Shared TypeScript DTOs, enums, permission contracts +โ”‚ โ”œโ”€โ”€ package.json +โ”‚ โ””โ”€โ”€ src/index.ts +โ”œโ”€โ”€ apps/ +โ”‚ โ”œโ”€โ”€ backend/ # NestJS API Server +โ”‚ โ”‚ โ”œโ”€โ”€ Dockerfile # Linux Debian-slim container with FFmpeg & Prisma +โ”‚ โ”‚ โ”œโ”€โ”€ prisma/ +โ”‚ โ”‚ โ”‚ โ”œโ”€โ”€ schema.prisma # MySQL Schema (Users, Folders, FileAssets, Permissions, Logs) +โ”‚ โ”‚ โ”‚ โ”œโ”€โ”€ migrations/ # Prisma migration history +โ”‚ โ”‚ โ”‚ โ””โ”€โ”€ seed.ts # Initial administrative bootstrap seeder +โ”‚ โ”‚ โ””โ”€โ”€ src/ +โ”‚ โ”‚ โ”œโ”€โ”€ modules/ +โ”‚ โ”‚ โ”‚ โ”œโ”€โ”€ auth/ # Argon2id password hashing, JWT access/refresh tokens +โ”‚ โ”‚ โ”‚ โ”œโ”€โ”€ storage/ # Cross-platform LocalStorage & S3Storage providers +โ”‚ โ”‚ โ”‚ โ”œโ”€โ”€ video/ # FFmpeg transcoder & HLS generator +โ”‚ โ”‚ โ”‚ โ”œโ”€โ”€ permissions/ # Granular permission engine (file, folder, user-level) +โ”‚ โ”‚ โ”‚ โ”œโ”€โ”€ files/ # Direct & chunked upload sessions, range streaming +โ”‚ โ”‚ โ”‚ โ”œโ”€โ”€ folders/ # Hierarchical logical folder management +โ”‚ โ”‚ โ”‚ โ”œโ”€โ”€ admin/ # User directory, storage metrics, audit trail +โ”‚ โ”‚ โ”‚ โ””โ”€โ”€ audit/ # Security event logger +โ”‚ โ””โ”€โ”€ frontend/ # Next.js 15 App Router Frontend +โ”‚ โ”œโ”€โ”€ Dockerfile # Multi-stage production container +โ”‚ โ””โ”€โ”€ src/ +โ”‚ โ”œโ”€โ”€ app/ +โ”‚ โ”‚ โ”œโ”€โ”€ dashboard/ # Storage gauges, quota bars, recent uploads +โ”‚ โ”‚ โ”œโ”€โ”€ files/ # File explorer, search, category filters, upload modal +โ”‚ โ”‚ โ”œโ”€โ”€ shared/ # Files shared with current user +โ”‚ โ”‚ โ”œโ”€โ”€ video/[id]/ # Adaptive HLS player with custom scrubber +โ”‚ โ”‚ โ””โ”€โ”€ admin/ # Users, user-files, permissions, storage, audit logs +โ”‚ โ””โ”€โ”€ components/ +โ”‚ โ”œโ”€โ”€ video-player/ # HlsVideoPlayer component +โ”‚ โ”œโ”€โ”€ uploader/ # FileUploaderModal with drag-and-drop +โ”‚ โ””โ”€โ”€ file-manager/ # FileCard, FileRow, FilePreviewModal +โ””โ”€โ”€ storage/ # Default local storage volume (users/{id}/files/...) +``` + +--- + +## ๐Ÿ”’ Security Summary + +- **No Public S3/Static URLs**: All file downloads, previews, and video streams pass through authentication and authorization guards. +- **Directory Traversal Immunity**: Storage paths use canonical keys and reject relative path components (`..`). +- **Input Sanitization**: Original file names are cleaned of special characters and illegal OS tokens. +- **Argon2id Hashing**: Industry-standard cryptographic password hashing. +- **Audit Compliance**: All administrative and file modifications are tracked in database audit records. diff --git a/apps/backend/Dockerfile b/apps/backend/Dockerfile new file mode 100644 index 0000000..1991a05 --- /dev/null +++ b/apps/backend/Dockerfile @@ -0,0 +1,72 @@ +# Multi-stage production Dockerfile for Backend (NestJS + Prisma + FFmpeg) +# Supports Linux VPS, AWS EC2, GCP Compute, DigitalOcean, and Windows Docker Desktop + +FROM node:22-bookworm-slim AS builder + +WORKDIR /app + +# Install build essentials for native addons (e.g. argon2) +RUN apt-get update && apt-get install -y --no-install-recommends \ + python3 \ + make \ + g++ \ + openssl \ + && rm -rf /var/lib/apt/lists/* + +# Copy root package files +COPY package*.json ./ +COPY packages/shared/package*.json ./packages/shared/ +COPY apps/backend/package*.json ./apps/backend/ + +# Install dependencies across workspaces +RUN npm ci + +# Copy shared package source and backend source +COPY packages/shared ./packages/shared +COPY apps/backend ./apps/backend + +# Generate Prisma client and compile backend TypeScript +WORKDIR /app/apps/backend +RUN npx prisma generate +RUN npm run build + +# ============================================================== +# Production Runtime Stage +# ============================================================== +FROM node:22-bookworm-slim AS runner + +WORKDIR /app + +# Install runtime dependencies: FFmpeg and OpenSSL (for Prisma) +RUN apt-get update && apt-get install -y --no-install-recommends \ + ffmpeg \ + openssl \ + curl \ + && rm -rf /var/lib/apt/lists/* + +ENV NODE_ENV=production +ENV PORT=4000 +ENV LOCAL_STORAGE_PATH=/app/storage + +# Create storage directory with proper permissions +RUN mkdir -p /app/storage && chmod 755 /app/storage + +# Copy installed node_modules and built assets from builder +COPY --from=builder /app/node_modules ./node_modules +COPY --from=builder /app/packages/shared ./packages/shared +COPY --from=builder /app/apps/backend/node_modules ./apps/backend/node_modules +COPY --from=builder /app/apps/backend/dist ./apps/backend/dist +COPY --from=builder /app/apps/backend/prisma ./apps/backend/prisma +COPY --from=builder /app/apps/backend/package.json ./apps/backend/package.json + +WORKDIR /app/apps/backend + +# Expose backend REST API port +EXPOSE 4000 + +# Health check +HEALTHCHECK --interval=30s --timeout=5s --start-period=10s --retries=3 \ + CMD curl -f http://localhost:4000/api/docs || exit 1 + +# Start production server +CMD ["node", "dist/main.js"] diff --git a/apps/backend/nest-cli.json b/apps/backend/nest-cli.json new file mode 100644 index 0000000..2566481 --- /dev/null +++ b/apps/backend/nest-cli.json @@ -0,0 +1,5 @@ +{ + "$schema": "https://json.schemastore.org/nest-cli", + "collection": "@nestjs/schematics", + "sourceRoot": "src" +} diff --git a/apps/backend/package.json b/apps/backend/package.json new file mode 100644 index 0000000..23bd6e1 --- /dev/null +++ b/apps/backend/package.json @@ -0,0 +1,77 @@ +{ + "name": "@fileshare/backend", + "version": "1.0.0", + "private": true, + "scripts": { + "prebuild": "node ../../scripts/prisma-generate.js", + "build": "nest build", + "format": "prettier --write \"src/**/*.ts\"", + "start": "nest start", + "start:dev": "nest start --watch", + "start:debug": "nest start --debug --watch", + "start:prod": "node dist/main.js", + "prisma:generate": "node ../../scripts/prisma-generate.js", + "prisma:migrate": "prisma migrate dev", + "prisma:migrate:deploy": "prisma migrate deploy", + "prisma:seed": "ts-node prisma/seed.ts", + "test": "jest --passWithNoTests", + "test:watch": "jest --watch", + "test:cov": "jest --coverage", + "test:e2e": "jest --config ./test/jest-e2e.json" + }, + "dependencies": { + "@fileshare/shared": "*", + "@aws-sdk/client-s3": "^3.750.0", + "@nestjs/common": "^11.0.11", + "@nestjs/config": "^4.0.1", + "@nestjs/core": "^11.0.11", + "@nestjs/jwt": "^11.0.0", + "@nestjs/passport": "^11.0.5", + "@nestjs/platform-express": "^11.0.11", + "@nestjs/swagger": "^11.0.6", + "@prisma/client": "^6.4.1", + "argon2": "^0.41.1", + "bullmq": "^5.41.7", + "class-transformer": "^0.5.1", + "class-validator": "^0.14.1", + "compression": "^1.8.0", + "cookie-parser": "^1.4.7", + "dotenv": "^16.4.7", + "fluent-ffmpeg": "^2.1.3", + "helmet": "^8.0.0", + "ioredis": "^5.5.0", + "mime-types": "^2.1.35", + "multer": "^1.4.5-lts.1", + "passport": "^0.7.0", + "passport-jwt": "^4.0.1", + "reflect-metadata": "^0.2.2", + "rxjs": "^7.8.2", + "swagger-ui-express": "^5.0.1", + "uuid": "^11.1.0" + }, + "devDependencies": { + "@nestjs/cli": "^11.0.5", + "@nestjs/schematics": "^11.0.2", + "@nestjs/testing": "^11.0.11", + "@types/compression": "^1.7.5", + "@types/cookie-parser": "^1.4.8", + "@types/express": "^5.0.0", + "@types/fluent-ffmpeg": "^2.1.27", + "@types/jest": "^29.5.14", + "@types/mime-types": "^2.1.4", + "@types/multer": "^1.4.12", + "@types/node": "^22.13.9", + "@types/passport-jwt": "^4.0.1", + "@types/supertest": "^6.0.2", + "@types/uuid": "^10.0.0", + "jest": "^29.7.0", + "prisma": "^6.4.1", + "source-map-support": "^0.5.21", + "supertest": "^7.0.0", + "ts-jest": "^29.2.6", + "ts-loader": "^9.5.2", + "ts-node": "^10.9.2", + "tsconfig-paths": "^4.2.0", + "typescript": "^5.7.3" + } +} diff --git a/apps/backend/prisma/add-allowed-companies.js b/apps/backend/prisma/add-allowed-companies.js new file mode 100644 index 0000000..be89fd5 --- /dev/null +++ b/apps/backend/prisma/add-allowed-companies.js @@ -0,0 +1,20 @@ +require('dotenv').config({ path: __dirname + '/../.env' }); +const { PrismaClient } = require('@prisma/client'); +const prisma = new PrismaClient(); + +async function main() { + try { + await prisma.$executeRawUnsafe('ALTER TABLE `User` ADD COLUMN `allowedCompanies` TEXT NULL AFTER `companyName`;'); + console.log('โœ“ Successfully added allowedCompanies column to User table'); + } catch (err) { + if (err.message && err.message.includes('Duplicate column name')) { + console.log('โœ“ Column allowedCompanies already exists'); + } else { + console.error('Error adding column:', err.message); + } + } +} + +main() + .catch(console.error) + .finally(() => prisma.$disconnect()); diff --git a/apps/backend/prisma/add-column.js b/apps/backend/prisma/add-column.js new file mode 100644 index 0000000..2a9e2e2 --- /dev/null +++ b/apps/backend/prisma/add-column.js @@ -0,0 +1,30 @@ +const { PrismaClient } = require('@prisma/client'); +const prisma = new PrismaClient(); + +async function main() { + try { + await prisma.$executeRawUnsafe('ALTER TABLE `User` ADD COLUMN `viewablePassword` VARCHAR(191) NULL AFTER `passwordHash`;'); + console.log('โœ“ Successfully added viewablePassword column to User table'); + } catch (err) { + if (err.message.includes('Duplicate column name')) { + console.log('โœ“ Column viewablePassword already exists'); + } else { + console.error('Error adding column:', err.message); + } + } + + // Update existing seeded users with their plain passwords + await prisma.$executeRawUnsafe("UPDATE `User` SET `viewablePassword` = 'Ecohub@520' WHERE `username` = 'ecohub';"); + await prisma.$executeRawUnsafe("UPDATE `User` SET `viewablePassword` = '123' WHERE `username` = 'ecohubstaff';"); + await prisma.$executeRawUnsafe("UPDATE `User` SET `viewablePassword` = '123' WHERE `username` = 'ecouser';"); + await prisma.$executeRawUnsafe("UPDATE `User` SET `viewablePassword` = 'SuperAdmin@Secure2026!' WHERE `username` = 'superadmin';"); + await prisma.$executeRawUnsafe("UPDATE `User` SET `viewablePassword` = 'Admin@Secure2026!' WHERE `username` = 'admin';"); + await prisma.$executeRawUnsafe("UPDATE `User` SET `viewablePassword` = 'UserA@Secure2026!' WHERE `username` = 'usera';"); + await prisma.$executeRawUnsafe("UPDATE `User` SET `viewablePassword` = 'UserB@Secure2026!' WHERE `username` = 'userb';"); + + console.log('โœ“ Updated existing user viewable passwords'); +} + +main() + .catch(console.error) + .finally(() => prisma.$disconnect()); diff --git a/apps/backend/prisma/check-cols.js b/apps/backend/prisma/check-cols.js new file mode 100644 index 0000000..1e90bd1 --- /dev/null +++ b/apps/backend/prisma/check-cols.js @@ -0,0 +1,14 @@ +require('dotenv').config({ path: __dirname + '/../.env' }); +const { PrismaClient } = require('@prisma/client'); +const prisma = new PrismaClient(); + +async function main() { + try { + const cols = await prisma.$queryRawUnsafe('SHOW COLUMNS FROM `User`'); + console.log('Columns in User table:', cols.map(c => c.Field)); + } catch (e) { + console.error('Error:', e); + } +} + +main().finally(() => prisma.$disconnect()); diff --git a/apps/backend/prisma/clean-orphans.js b/apps/backend/prisma/clean-orphans.js new file mode 100644 index 0000000..42f2232 --- /dev/null +++ b/apps/backend/prisma/clean-orphans.js @@ -0,0 +1,26 @@ +const { PrismaClient } = require('@prisma/client'); +const prisma = new PrismaClient(); + +async function run() { + const users = await prisma.user.findMany({ select: { id: true } }); + const userIds = new Set(users.map((u) => u.id)); + console.log('Total valid users in DB:', userIds.size); + + const permissions = await prisma.filePermission.findMany(); + console.log('Total permissions in DB:', permissions.length); + + let orphaned = 0; + for (const p of permissions) { + if (!userIds.has(p.ownerId) || !userIds.has(p.granteeUserId)) { + orphaned++; + await prisma.filePermission.delete({ where: { id: p.id } }); + } + } + console.log('Cleaned up orphaned permissions:', orphaned); + await prisma.$disconnect(); +} + +run().catch((e) => { + console.error(e); + process.exit(1); +}); diff --git a/apps/backend/prisma/create-user-table.js b/apps/backend/prisma/create-user-table.js new file mode 100644 index 0000000..3ab3838 --- /dev/null +++ b/apps/backend/prisma/create-user-table.js @@ -0,0 +1,41 @@ +require('dotenv').config({ path: __dirname + '/../.env' }); +const { PrismaClient } = require('@prisma/client'); +const prisma = new PrismaClient(); + +async function main() { + const ddl = ` +CREATE TABLE IF NOT EXISTS \`User\` ( + \`id\` VARCHAR(191) NOT NULL, + \`email\` VARCHAR(191) NOT NULL, + \`username\` VARCHAR(191) NOT NULL, + \`fullName\` VARCHAR(191) NOT NULL, + \`companyName\` VARCHAR(191) NOT NULL DEFAULT 'Ecohub', + \`allowedCompanies\` TEXT NULL, + \`passwordHash\` VARCHAR(191) NOT NULL, + \`viewablePassword\` VARCHAR(191) NULL, + \`role\` ENUM('SUPER_ADMIN', 'ADMIN', 'USER') NOT NULL DEFAULT 'USER', + \`status\` ENUM('ACTIVE', 'SUSPENDED', 'PENDING') NOT NULL DEFAULT 'ACTIVE', + \`storageQuotaBytes\` BIGINT NOT NULL DEFAULT 5368709120, + \`storageUsedBytes\` BIGINT NOT NULL DEFAULT 0, + \`canCreateShareLinks\` BOOLEAN NOT NULL DEFAULT false, + \`canDeleteFiles\` BOOLEAN NOT NULL DEFAULT true, + \`canViewOtherUsers\` BOOLEAN NOT NULL DEFAULT false, + \`remoteFileServerUrl\` VARCHAR(191) NULL, + \`canUseRemoteServer\` BOOLEAN NOT NULL DEFAULT true, + \`createdAt\` DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3), + \`updatedAt\` DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) ON UPDATE CURRENT_TIMESTAMP(3), + \`lastLoginAt\` DATETIME(3) NULL, + + UNIQUE INDEX \`User_email_key\`(\`email\`), + UNIQUE INDEX \`User_username_key\`(\`username\`), + INDEX \`User_role_idx\`(\`role\`), + INDEX \`User_status_idx\`(\`status\`), + PRIMARY KEY (\`id\`) +) DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; + `; + + await prisma.$executeRawUnsafe(ddl); + console.log('โœ“ User table created successfully with allowedCompanies!'); +} + +main().catch(console.error).finally(() => prisma.$disconnect()); diff --git a/apps/backend/prisma/migrations/20261014062134_init/migration.sql b/apps/backend/prisma/migrations/20261014062134_init/migration.sql new file mode 100644 index 0000000..4a466d0 --- /dev/null +++ b/apps/backend/prisma/migrations/20261014062134_init/migration.sql @@ -0,0 +1,224 @@ +-- CreateTable +CREATE TABLE `User` ( + `id` VARCHAR(191) NOT NULL, + `email` VARCHAR(191) NOT NULL, + `username` VARCHAR(191) NOT NULL, + `fullName` VARCHAR(191) NOT NULL, + `passwordHash` VARCHAR(191) NOT NULL, + `role` ENUM('SUPER_ADMIN', 'ADMIN', 'USER') NOT NULL DEFAULT 'USER', + `status` ENUM('ACTIVE', 'SUSPENDED', 'PENDING') NOT NULL DEFAULT 'ACTIVE', + `storageQuotaBytes` BIGINT NOT NULL DEFAULT 5368709120, + `storageUsedBytes` BIGINT NOT NULL DEFAULT 0, + `createdAt` DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3), + `updatedAt` DATETIME(3) NOT NULL, + `lastLoginAt` DATETIME(3) NULL, + + UNIQUE INDEX `User_email_key`(`email`), + UNIQUE INDEX `User_username_key`(`username`), + INDEX `User_role_idx`(`role`), + INDEX `User_status_idx`(`status`), + PRIMARY KEY (`id`) +) DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; + +-- CreateTable +CREATE TABLE `Folder` ( + `id` VARCHAR(191) NOT NULL, + `ownerId` VARCHAR(191) NOT NULL, + `parentId` VARCHAR(191) NULL, + `name` VARCHAR(191) NOT NULL, + `logicalPath` VARCHAR(191) NOT NULL, + `createdAt` DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3), + `updatedAt` DATETIME(3) NOT NULL, + + INDEX `Folder_ownerId_idx`(`ownerId`), + INDEX `Folder_parentId_idx`(`parentId`), + UNIQUE INDEX `Folder_ownerId_parentId_name_key`(`ownerId`, `parentId`, `name`), + PRIMARY KEY (`id`) +) DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; + +-- CreateTable +CREATE TABLE `FileAsset` ( + `id` VARCHAR(191) NOT NULL, + `ownerId` VARCHAR(191) NOT NULL, + `folderId` VARCHAR(191) NULL, + `originalFilename` VARCHAR(191) NOT NULL, + `internalStorageKey` VARCHAR(191) NOT NULL, + `mimeType` VARCHAR(191) NOT NULL, + `fileExtension` VARCHAR(191) NOT NULL, + `fileSizeBytes` BIGINT NOT NULL, + `fileCategory` ENUM('VIDEO', 'IMAGE', 'DOCUMENT', 'ARCHIVE', 'AUDIO', 'OTHER') NOT NULL, + `checksum` VARCHAR(191) NULL, + `status` ENUM('PENDING', 'UPLOADING', 'PROCESSING', 'READY', 'FAILED') NOT NULL DEFAULT 'PENDING', + `durationSeconds` DOUBLE NULL, + `width` INTEGER NULL, + `height` INTEGER NULL, + `videoCodec` VARCHAR(191) NULL, + `audioCodec` VARCHAR(191) NULL, + `thumbnailStorageKey` VARCHAR(191) NULL, + `hlsMasterPlaylistKey` VARCHAR(191) NULL, + `isSoftDeleted` BOOLEAN NOT NULL DEFAULT false, + `deletedAt` DATETIME(3) NULL, + `createdAt` DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3), + `updatedAt` DATETIME(3) NOT NULL, + + UNIQUE INDEX `FileAsset_internalStorageKey_key`(`internalStorageKey`), + INDEX `FileAsset_ownerId_idx`(`ownerId`), + INDEX `FileAsset_folderId_idx`(`folderId`), + INDEX `FileAsset_fileCategory_idx`(`fileCategory`), + INDEX `FileAsset_status_idx`(`status`), + INDEX `FileAsset_isSoftDeleted_idx`(`isSoftDeleted`), + PRIMARY KEY (`id`) +) DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; + +-- CreateTable +CREATE TABLE `FilePermission` ( + `id` VARCHAR(191) NOT NULL, + `resourceType` ENUM('FILE', 'FOLDER', 'USER_FILES') NOT NULL, + `resourceId` VARCHAR(191) NULL, + `ownerId` VARCHAR(191) NOT NULL, + `granteeUserId` VARCHAR(191) NOT NULL, + `grantedByUserId` VARCHAR(191) NOT NULL, + `canViewMetadata` BOOLEAN NOT NULL DEFAULT true, + `canPreview` BOOLEAN NOT NULL DEFAULT false, + `canPlay` BOOLEAN NOT NULL DEFAULT false, + `canDownload` BOOLEAN NOT NULL DEFAULT false, + `canListFolder` BOOLEAN NOT NULL DEFAULT false, + `expiresAt` DATETIME(3) NULL, + `revokedAt` DATETIME(3) NULL, + `createdAt` DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3), + `updatedAt` DATETIME(3) NOT NULL, + + INDEX `FilePermission_granteeUserId_idx`(`granteeUserId`), + INDEX `FilePermission_ownerId_idx`(`ownerId`), + INDEX `FilePermission_resourceType_resourceId_idx`(`resourceType`, `resourceId`), + INDEX `FilePermission_revokedAt_expiresAt_idx`(`revokedAt`, `expiresAt`), + PRIMARY KEY (`id`) +) DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; + +-- CreateTable +CREATE TABLE `UploadSession` ( + `id` VARCHAR(191) NOT NULL, + `ownerId` VARCHAR(191) NOT NULL, + `folderId` VARCHAR(191) NULL, + `originalFilename` VARCHAR(191) NOT NULL, + `mimeType` VARCHAR(191) NOT NULL, + `fileCategory` ENUM('VIDEO', 'IMAGE', 'DOCUMENT', 'ARCHIVE', 'AUDIO', 'OTHER') NOT NULL, + `totalSizeBytes` BIGINT NOT NULL, + `uploadedSizeBytes` BIGINT NOT NULL DEFAULT 0, + `tempStorageKey` VARCHAR(191) NOT NULL, + `status` ENUM('INITIALIZED', 'UPLOADING', 'COMPLETED', 'ABORTED', 'EXPIRED') NOT NULL DEFAULT 'INITIALIZED', + `expiresAt` DATETIME(3) NOT NULL, + `createdAt` DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3), + `updatedAt` DATETIME(3) NOT NULL, + + UNIQUE INDEX `UploadSession_tempStorageKey_key`(`tempStorageKey`), + INDEX `UploadSession_ownerId_idx`(`ownerId`), + INDEX `UploadSession_status_idx`(`status`), + INDEX `UploadSession_expiresAt_idx`(`expiresAt`), + PRIMARY KEY (`id`) +) DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; + +-- CreateTable +CREATE TABLE `VideoProcessingJob` ( + `id` VARCHAR(191) NOT NULL, + `fileAssetId` VARCHAR(191) NOT NULL, + `status` ENUM('QUEUED', 'PROCESSING', 'COMPLETED', 'FAILED') NOT NULL DEFAULT 'QUEUED', + `progress` INTEGER NOT NULL DEFAULT 0, + `attempts` INTEGER NOT NULL DEFAULT 0, + `errorReason` TEXT NULL, + `createdAt` DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3), + `updatedAt` DATETIME(3) NOT NULL, + `completedAt` DATETIME(3) NULL, + + INDEX `VideoProcessingJob_fileAssetId_idx`(`fileAssetId`), + INDEX `VideoProcessingJob_status_idx`(`status`), + PRIMARY KEY (`id`) +) DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; + +-- CreateTable +CREATE TABLE `RefreshToken` ( + `id` VARCHAR(191) NOT NULL, + `tokenHash` VARCHAR(191) NOT NULL, + `userId` VARCHAR(191) NOT NULL, + `userAgent` VARCHAR(191) NULL, + `ipAddress` VARCHAR(191) NULL, + `expiresAt` DATETIME(3) NOT NULL, + `revokedAt` DATETIME(3) NULL, + `createdAt` DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3), + + UNIQUE INDEX `RefreshToken_tokenHash_key`(`tokenHash`), + INDEX `RefreshToken_userId_idx`(`userId`), + INDEX `RefreshToken_expiresAt_idx`(`expiresAt`), + PRIMARY KEY (`id`) +) DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; + +-- CreateTable +CREATE TABLE `AuditLog` ( + `id` VARCHAR(191) NOT NULL, + `actorUserId` VARCHAR(191) NULL, + `action` VARCHAR(191) NOT NULL, + `resourceType` VARCHAR(191) NOT NULL, + `resourceId` VARCHAR(191) NULL, + `targetUserId` VARCHAR(191) NULL, + `ipAddress` VARCHAR(191) NULL, + `userAgent` VARCHAR(191) NULL, + `detailsJson` TEXT NULL, + `createdAt` DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3), + + INDEX `AuditLog_actorUserId_idx`(`actorUserId`), + INDEX `AuditLog_action_idx`(`action`), + INDEX `AuditLog_resourceType_resourceId_idx`(`resourceType`, `resourceId`), + INDEX `AuditLog_createdAt_idx`(`createdAt`), + PRIMARY KEY (`id`) +) DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; + +-- CreateTable +CREATE TABLE `SystemSetting` ( + `id` VARCHAR(191) NOT NULL, + `key` VARCHAR(191) NOT NULL, + `value` TEXT NOT NULL, + `description` VARCHAR(191) NULL, + `updatedAt` DATETIME(3) NOT NULL, + + UNIQUE INDEX `SystemSetting_key_key`(`key`), + PRIMARY KEY (`id`) +) DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; + +-- AddForeignKey +ALTER TABLE `Folder` ADD CONSTRAINT `Folder_ownerId_fkey` FOREIGN KEY (`ownerId`) REFERENCES `User`(`id`) ON DELETE CASCADE ON UPDATE CASCADE; + +-- AddForeignKey +ALTER TABLE `Folder` ADD CONSTRAINT `Folder_parentId_fkey` FOREIGN KEY (`parentId`) REFERENCES `Folder`(`id`) ON DELETE CASCADE ON UPDATE CASCADE; + +-- AddForeignKey +ALTER TABLE `FileAsset` ADD CONSTRAINT `FileAsset_ownerId_fkey` FOREIGN KEY (`ownerId`) REFERENCES `User`(`id`) ON DELETE CASCADE ON UPDATE CASCADE; + +-- AddForeignKey +ALTER TABLE `FileAsset` ADD CONSTRAINT `FileAsset_folderId_fkey` FOREIGN KEY (`folderId`) REFERENCES `Folder`(`id`) ON DELETE SET NULL ON UPDATE CASCADE; + +-- AddForeignKey +ALTER TABLE `FilePermission` ADD CONSTRAINT `FilePermission_ownerId_fkey` FOREIGN KEY (`ownerId`) REFERENCES `User`(`id`) ON DELETE CASCADE ON UPDATE CASCADE; + +-- AddForeignKey +ALTER TABLE `FilePermission` ADD CONSTRAINT `FilePermission_granteeUserId_fkey` FOREIGN KEY (`granteeUserId`) REFERENCES `User`(`id`) ON DELETE CASCADE ON UPDATE CASCADE; + +-- AddForeignKey +ALTER TABLE `FilePermission` ADD CONSTRAINT `FilePermission_grantedByUserId_fkey` FOREIGN KEY (`grantedByUserId`) REFERENCES `User`(`id`) ON DELETE CASCADE ON UPDATE CASCADE; + +-- AddForeignKey +ALTER TABLE `UploadSession` ADD CONSTRAINT `UploadSession_ownerId_fkey` FOREIGN KEY (`ownerId`) REFERENCES `User`(`id`) ON DELETE CASCADE ON UPDATE CASCADE; + +-- AddForeignKey +ALTER TABLE `UploadSession` ADD CONSTRAINT `UploadSession_folderId_fkey` FOREIGN KEY (`folderId`) REFERENCES `Folder`(`id`) ON DELETE SET NULL ON UPDATE CASCADE; + +-- AddForeignKey +ALTER TABLE `VideoProcessingJob` ADD CONSTRAINT `VideoProcessingJob_fileAssetId_fkey` FOREIGN KEY (`fileAssetId`) REFERENCES `FileAsset`(`id`) ON DELETE CASCADE ON UPDATE CASCADE; + +-- AddForeignKey +ALTER TABLE `RefreshToken` ADD CONSTRAINT `RefreshToken_userId_fkey` FOREIGN KEY (`userId`) REFERENCES `User`(`id`) ON DELETE CASCADE ON UPDATE CASCADE; + +-- AddForeignKey +ALTER TABLE `AuditLog` ADD CONSTRAINT `AuditLog_actorUserId_fkey` FOREIGN KEY (`actorUserId`) REFERENCES `User`(`id`) ON DELETE SET NULL ON UPDATE CASCADE; + +-- AddForeignKey +ALTER TABLE `AuditLog` ADD CONSTRAINT `AuditLog_targetUserId_fkey` FOREIGN KEY (`targetUserId`) REFERENCES `User`(`id`) ON DELETE SET NULL ON UPDATE CASCADE; diff --git a/apps/backend/prisma/migrations/migration_lock.toml b/apps/backend/prisma/migrations/migration_lock.toml new file mode 100644 index 0000000..592fc0b --- /dev/null +++ b/apps/backend/prisma/migrations/migration_lock.toml @@ -0,0 +1,3 @@ +# Please do not edit this file manually +# It should be added in your version-control system (e.g., Git) +provider = "mysql" diff --git a/apps/backend/prisma/schema.prisma b/apps/backend/prisma/schema.prisma new file mode 100644 index 0000000..9cd0956 --- /dev/null +++ b/apps/backend/prisma/schema.prisma @@ -0,0 +1,329 @@ +datasource db { + provider = "mysql" + url = env("DATABASE_URL") +} + +generator client { + provider = "prisma-client-js" +} + +enum UserRole { + SUPER_ADMIN + ADMIN + USER +} + +enum UserStatus { + ACTIVE + SUSPENDED + PENDING +} + +enum FileCategory { + VIDEO + IMAGE + DOCUMENT + ARCHIVE + AUDIO + OTHER +} + +enum FileStatus { + PENDING + UPLOADING + PROCESSING + READY + FAILED +} + +enum PermissionResourceType { + FILE + FOLDER + USER_FILES +} + +enum ShareResourceType { + FILE + FOLDER +} + +enum UploadSessionStatus { + INITIALIZED + UPLOADING + COMPLETED + ABORTED + EXPIRED +} + +enum ProcessingJobStatus { + QUEUED + PROCESSING + COMPLETED + FAILED +} + +model User { + id String @id @default(uuid()) + email String @unique + username String @unique + fullName String + companyName String @default("Ecohub") + allowedCompanies String? @db.Text // Comma-separated or JSON list of companies user can access, or "*" for all + passwordHash String + viewablePassword String? + role UserRole @default(USER) + status UserStatus @default(ACTIVE) + storageQuotaBytes BigInt @default(5368709120) // 5GB default + storageUsedBytes BigInt @default(0) + canCreateShareLinks Boolean @default(false) + canDeleteFiles Boolean @default(true) + canViewOtherUsers Boolean @default(false) // Permission to view other users' info & directory (Superadmin only by default) + remoteFileServerUrl String? // User-specific Remote File Server Link / Upload Endpoint (Optional) + canUseRemoteServer Boolean @default(true) // Permission to upload/mirror to remote file server + createdAt DateTime @default(now()) + updatedAt DateTime @updatedAt + lastLoginAt DateTime? + + // Relations + folders Folder[] + files FileAsset[] + shareLinks ShareLink[] + uploadSessions UploadSession[] + grantedPermissions FilePermission[] @relation("GrantedByRelation") + receivedPermissions FilePermission[] @relation("GranteeRelation") + ownedPermissions FilePermission[] @relation("OwnerRelation") + refreshTokens RefreshToken[] + actorAuditLogs AuditLog[] @relation("ActorRelation") + targetAuditLogs AuditLog[] @relation("TargetRelation") + apiKeys ApiKey[] + + @@index([role]) + @@index([status]) +} + +model Folder { + id String @id @default(uuid()) + ownerId String + parentId String? + name String + logicalPath String + createdAt DateTime @default(now()) + updatedAt DateTime @updatedAt + + // Relations + owner User @relation(fields: [ownerId], references: [id], onDelete: Cascade) + parent Folder? @relation("FolderHierarchy", fields: [parentId], references: [id], onDelete: Cascade) + children Folder[] @relation("FolderHierarchy") + files FileAsset[] + uploadSessions UploadSession[] + shareLinks ShareLink[] + + @@unique([ownerId, parentId, name]) + @@index([ownerId]) + @@index([parentId]) +} + +model FileAsset { + id String @id @default(uuid()) + ownerId String + folderId String? + originalFilename String + internalStorageKey String @unique + mimeType String + fileExtension String + fileSizeBytes BigInt + fileCategory FileCategory + checksum String? + status FileStatus @default(PENDING) + durationSeconds Float? + width Int? + height Int? + videoCodec String? + audioCodec String? + thumbnailStorageKey String? + hlsMasterPlaylistKey String? + isSoftDeleted Boolean @default(false) + deletedAt DateTime? + createdAt DateTime @default(now()) + updatedAt DateTime @updatedAt + + // Relations + owner User @relation(fields: [ownerId], references: [id], onDelete: Cascade) + folder Folder? @relation(fields: [folderId], references: [id], onDelete: SetNull) + videoProcessingJobs VideoProcessingJob[] + shareLinks ShareLink[] + + @@index([ownerId]) + @@index([folderId]) + @@index([fileCategory]) + @@index([status]) + @@index([isSoftDeleted]) +} + +model FilePermission { + id String @id @default(uuid()) + resourceType PermissionResourceType + resourceId String? // File ID, Folder ID, or null for USER_FILES + ownerId String + granteeUserId String + grantedByUserId String + canViewMetadata Boolean @default(true) + canPreview Boolean @default(false) + canPlay Boolean @default(false) + canDownload Boolean @default(false) + canListFolder Boolean @default(false) + expiresAt DateTime? + revokedAt DateTime? + createdAt DateTime @default(now()) + updatedAt DateTime @updatedAt + + // Relations + owner User @relation("OwnerRelation", fields: [ownerId], references: [id], onDelete: Cascade) + grantee User @relation("GranteeRelation", fields: [granteeUserId], references: [id], onDelete: Cascade) + grantedBy User @relation("GrantedByRelation", fields: [grantedByUserId], references: [id], onDelete: Cascade) + + @@index([granteeUserId]) + @@index([ownerId]) + @@index([resourceType, resourceId]) + @@index([revokedAt, expiresAt]) +} + +model UploadSession { + id String @id @default(uuid()) + ownerId String + folderId String? + originalFilename String + mimeType String + fileCategory FileCategory + totalSizeBytes BigInt + uploadedSizeBytes BigInt @default(0) + tempStorageKey String @unique + status UploadSessionStatus @default(INITIALIZED) + expiresAt DateTime + createdAt DateTime @default(now()) + updatedAt DateTime @updatedAt + + // Relations + owner User @relation(fields: [ownerId], references: [id], onDelete: Cascade) + folder Folder? @relation(fields: [folderId], references: [id], onDelete: SetNull) + + @@index([ownerId]) + @@index([status]) + @@index([expiresAt]) +} + +model VideoProcessingJob { + id String @id @default(uuid()) + fileAssetId String + status ProcessingJobStatus @default(QUEUED) + progress Int @default(0) + attempts Int @default(0) + errorReason String? @db.Text + createdAt DateTime @default(now()) + updatedAt DateTime @updatedAt + completedAt DateTime? + + // Relations + fileAsset FileAsset @relation(fields: [fileAssetId], references: [id], onDelete: Cascade) + + @@index([fileAssetId]) + @@index([status]) +} + +model RefreshToken { + id String @id @default(uuid()) + tokenHash String @unique + userId String + userAgent String? + ipAddress String? + expiresAt DateTime + revokedAt DateTime? + createdAt DateTime @default(now()) + + // Relations + user User @relation(fields: [userId], references: [id], onDelete: Cascade) + + @@index([userId]) + @@index([expiresAt]) +} + +model AuditLog { + id String @id @default(uuid()) + actorUserId String? + action String + resourceType String + resourceId String? + targetUserId String? + ipAddress String? + userAgent String? + detailsJson String? @db.Text + createdAt DateTime @default(now()) + + // Relations + actor User? @relation("ActorRelation", fields: [actorUserId], references: [id], onDelete: SetNull) + targetUser User? @relation("TargetRelation", fields: [targetUserId], references: [id], onDelete: SetNull) + + @@index([actorUserId]) + @@index([action]) + @@index([resourceType, resourceId]) + @@index([createdAt]) +} + +model SystemSetting { + id String @id @default(uuid()) + key String @unique + value String @db.Text + description String? + updatedAt DateTime @updatedAt +} + +model ShareLink { + id String @id @default(uuid()) + token String @unique + title String? + ownerId String + resourceType ShareResourceType + fileId String? + folderId String? + allowDownload Boolean @default(true) + passwordHash String? + expiresAt DateTime? + viewCount Int @default(0) + downloadCount Int @default(0) + isActive Boolean @default(true) + createdAt DateTime @default(now()) + updatedAt DateTime @updatedAt + + // Relations + owner User @relation(fields: [ownerId], references: [id], onDelete: Cascade) + file FileAsset? @relation(fields: [fileId], references: [id], onDelete: Cascade) + folder Folder? @relation(fields: [folderId], references: [id], onDelete: Cascade) + + @@index([token]) + @@index([ownerId]) + @@index([fileId]) + @@index([folderId]) +} + +model ApiKey { + id String @id @default(uuid()) + name String + key String @unique + keyPrefix String + userId String + permissions String @default("FULL_ACCESS") + description String? + lastUsedAt DateTime? + expiresAt DateTime? + isActive Boolean @default(true) + createdAt DateTime @default(now()) + updatedAt DateTime @updatedAt + + user User @relation(fields: [userId], references: [id], onDelete: Cascade) + + @@index([key]) + @@index([userId]) + @@index([isActive]) +} + + diff --git a/apps/backend/prisma/seed.ts b/apps/backend/prisma/seed.ts new file mode 100644 index 0000000..f1e75d5 --- /dev/null +++ b/apps/backend/prisma/seed.ts @@ -0,0 +1,212 @@ +import { PrismaClient, UserRole, UserStatus } from '@prisma/client'; +import * as argon2 from 'argon2'; +import * as dotenv from 'dotenv'; +import * as path from 'path'; + +dotenv.config({ path: path.resolve(__dirname, '../.env') }); + +const prisma = new PrismaClient(); + +async function main() { + console.log('--- Starting Database Seeding ---'); + + // 1. Initial System Settings + const defaultSettings = [ + { + key: 'MAX_FILE_SIZE_BYTES', + value: '5368709120', // 5GB + description: 'Maximum permitted single file upload size in bytes', + }, + { + key: 'DEFAULT_USER_QUOTA_BYTES', + value: '5368709120', // 5GB + description: 'Default storage quota allocated to newly registered users', + }, + { + key: 'ALLOWED_EXTENSIONS', + value: 'mp4,webm,mov,avi,mkv,png,jpg,jpeg,webp,gif,pdf,doc,docx,xls,xlsx,ppt,pptx,zip,rar,7z,tar,gz,mp3,wav,ogg,txt,csv,json', + description: 'Comma-separated whitelist of allowed file extensions', + }, + { + key: 'ENABLE_PUBLIC_REGISTRATION', + value: 'true', + description: 'Flag controlling whether new users can self-register', + }, + { + key: 'STORAGE_RETENTION_DAYS', + value: '30', + description: 'Soft-deleted file retention duration in recycle bin', + }, + ]; + + for (const s of defaultSettings) { + await prisma.systemSetting.upsert({ + where: { key: s.key }, + update: { value: s.value, description: s.description }, + create: s, + }); + } + console.log('โœ“ System settings initialized'); + + // 2. Primary Super Admin (Ecohub / Ecohub@520) + const ecohubPasswordHash = await argon2.hash('Ecohub@520', { type: argon2.argon2id }); + const ecohubAdmin = await prisma.user.upsert({ + where: { username: 'ecohub' }, + update: { + passwordHash: ecohubPasswordHash, + role: UserRole.SUPER_ADMIN, + status: UserStatus.ACTIVE, + }, + create: { + email: 'ecohub@fileshare.local', + username: 'ecohub', + fullName: 'Ecohub Super Administrator', + passwordHash: ecohubPasswordHash, + role: UserRole.SUPER_ADMIN, + status: UserStatus.ACTIVE, + storageQuotaBytes: BigInt(107374182400), // 100GB + }, + }); + + const ecohubRoot = await prisma.folder.findFirst({ + where: { ownerId: ecohubAdmin.id, parentId: null, name: 'Root' }, + }); + if (!ecohubRoot) { + await prisma.folder.create({ + data: { + ownerId: ecohubAdmin.id, + parentId: null, + name: 'Root', + logicalPath: '/', + }, + }); + } + console.log(`โœ“ Primary Super Admin created: Ecohub (email: ${ecohubAdmin.email})`); + + // 3. Staff Officer User (Ecohubstaff / 123) + const staffPasswordHash = await argon2.hash('123', { type: argon2.argon2id }); + const staffUser = await prisma.user.upsert({ + where: { username: 'ecohubstaff' }, + update: { + passwordHash: staffPasswordHash, + role: UserRole.ADMIN, + status: UserStatus.ACTIVE, + }, + create: { + email: 'ecohubstaff@fileshare.local', + username: 'ecohubstaff', + fullName: 'Ecohub Staff Officer', + passwordHash: staffPasswordHash, + role: UserRole.ADMIN, + status: UserStatus.ACTIVE, + storageQuotaBytes: BigInt(53687091200), // 50GB + }, + }); + + const staffRoot = await prisma.folder.findFirst({ + where: { ownerId: staffUser.id, parentId: null, name: 'Root' }, + }); + if (!staffRoot) { + await prisma.folder.create({ + data: { + ownerId: staffUser.id, + parentId: null, + name: 'Root', + logicalPath: '/', + }, + }); + } + console.log(`โœ“ Staff User created: Ecohubstaff (email: ${staffUser.email})`); + + // 4. Normal User (ecouser / 123) + const normalUserPasswordHash = await argon2.hash('123', { type: argon2.argon2id }); + const normalUser = await prisma.user.upsert({ + where: { username: 'ecouser' }, + update: { + passwordHash: normalUserPasswordHash, + role: UserRole.USER, + status: UserStatus.ACTIVE, + }, + create: { + email: 'ecouser@fileshare.local', + username: 'ecouser', + fullName: 'Ecohub Standard User', + passwordHash: normalUserPasswordHash, + role: UserRole.USER, + status: UserStatus.ACTIVE, + storageQuotaBytes: BigInt(10737418240), // 10GB + }, + }); + + const normalUserRoot = await prisma.folder.findFirst({ + where: { ownerId: normalUser.id, parentId: null, name: 'Root' }, + }); + if (!normalUserRoot) { + await prisma.folder.create({ + data: { + ownerId: normalUser.id, + parentId: null, + name: 'Root', + logicalPath: '/', + }, + }); + } + console.log(`โœ“ Normal User created: ecouser (email: ${normalUser.email})`); + + // Keep legacy test accounts active for test suite backward compatibility + const legacyAdminHash = await argon2.hash('SuperAdmin@Secure2026!', { type: argon2.argon2id }); + await prisma.user.upsert({ + where: { email: 'superadmin@fileshare.local' }, + update: {}, + create: { + email: 'superadmin@fileshare.local', + username: 'superadmin', + fullName: 'Legacy Super Administrator', + passwordHash: legacyAdminHash, + role: UserRole.SUPER_ADMIN, + status: UserStatus.ACTIVE, + storageQuotaBytes: BigInt(53687091200), + }, + }); + + const userAHash = await argon2.hash('UserA@Secure2026!', { type: argon2.argon2id }); + await prisma.user.upsert({ + where: { email: 'usera@fileshare.local' }, + update: {}, + create: { + email: 'usera@fileshare.local', + username: 'usera', + fullName: 'Alice Johnson (User A)', + passwordHash: userAHash, + role: UserRole.USER, + status: UserStatus.ACTIVE, + storageQuotaBytes: BigInt(5368709120), + }, + }); + + const userBHash = await argon2.hash('UserB@Secure2026!', { type: argon2.argon2id }); + await prisma.user.upsert({ + where: { email: 'userb@fileshare.local' }, + update: {}, + create: { + email: 'userb@fileshare.local', + username: 'userb', + fullName: 'Bob Smith (User B)', + passwordHash: userBHash, + role: UserRole.USER, + status: UserStatus.ACTIVE, + storageQuotaBytes: BigInt(5368709120), + }, + }); + + console.log('--- Database Seeding Completed Successfully ---'); +} + +main() + .catch((e) => { + console.error('Seeding error:', e); + process.exit(1); + }) + .finally(async () => { + await prisma.$disconnect(); + }); diff --git a/apps/backend/prisma/users_import.sql b/apps/backend/prisma/users_import.sql new file mode 100644 index 0000000..35c249a --- /dev/null +++ b/apps/backend/prisma/users_import.sql @@ -0,0 +1,176 @@ +-- ====================================================================== +-- SECURE VIDEO & FILE SHARING MANAGEMENT SYSTEM - USER IMPORT SQL +-- ====================================================================== +-- Database: fileshare_db (MySQL 8.0 / MariaDB) +-- Generated: 2026-10-14 +-- +-- Accounts Included: +-- 1. Superadmin: +-- Username: Ecohub +-- Email: ecohub@fileshare.local +-- Password: Ecohub@520 +-- Role: SUPER_ADMIN (100 GB Quota) +-- +-- 2. Staff User: +-- Username: Ecohubstaff +-- Email: ecohubstaff@fileshare.local +-- Password: 123 +-- Role: ADMIN (50 GB Quota) +-- +-- 3. Normal User: +-- Username: ecouser +-- Email: ecouser@fileshare.local +-- Password: 123 +-- Role: USER (10 GB Quota) +-- ====================================================================== + +-- Ensure target database is selected +CREATE DATABASE IF NOT EXISTS `fileshare_db` CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; +USE `fileshare_db`; + +-- Temporarily disable foreign key checks during import +SET FOREIGN_KEY_CHECKS = 0; + +-- ---------------------------------------------------------------------- +-- 1. INSERT OR UPDATE USERS (Table: `User`) +-- ---------------------------------------------------------------------- +INSERT INTO `User` ( + `id`, + `email`, + `username`, + `fullName`, + `companyName`, + `passwordHash`, + `viewablePassword`, + `role`, + `status`, + `storageQuotaBytes`, + `storageUsedBytes`, + `canCreateShareLinks`, + `canDeleteFiles`, + `canViewOtherUsers`, + `remoteFileServerUrl`, + `canUseRemoteServer`, + `createdAt`, + `updatedAt` +) VALUES +-- 1. Superadmin: Ecohub / Ecohub@520 +( + 'ecohub-superadmin-uuid-2026-0001', + 'ecohub@fileshare.local', + 'ecohub', + 'Ecohub Super Administrator', + 'Ecohub Technologies', + '$argon2id$v=19$m=65536,t=3,p=4$fmAQcJ4zAtKrzBNnfdWneQ$d3WbQGHsQ+CSwTiOL363uKudXfsFGgS4wFd/jPbenVw', + 'Ecohub@520', + 'SUPER_ADMIN', + 'ACTIVE', + 107374182400, + 0, + 1, + 1, + 1, + NULL, + 1, + NOW(3), + NOW(3) +), + +-- 2. Staff Officer: Ecohubstaff / 123 +( + 'ecohubstaff-admin-uuid-2026-0002', + 'ecohubstaff@fileshare.local', + 'ecohubstaff', + 'Ecohub Staff Officer', + 'Ecohub Media & Ops', + '$argon2id$v=19$m=65536,t=3,p=4$Mws8SMfU7v9D1Cs8zsN1BA$clCgpd4T/Os+Mp1AGpg61jqIL/UFwnzFivEGd8MWs4k', + '123', + 'ADMIN', + 'ACTIVE', + 53687091200, + 0, + 1, + 1, + 0, + NULL, + 1, + NOW(3), + NOW(3) +), + +-- 3. Normal User: ecouser / 123 +( + 'ecouser-normal-uuid-2026-0003', + 'ecouser@fileshare.local', + 'ecouser', + 'Ecohub Standard User', + 'Ecohub Client Org', + '$argon2id$v=19$m=65536,t=3,p=4$Mws8SMfU7v9D1Cs8zsN1BA$clCgpd4T/Os+Mp1AGpg61jqIL/UFwnzFivEGd8MWs4k', + '123', + 'USER', + 'ACTIVE', + 10737418240, + 0, + 0, + 1, + 0, + NULL, + 1, + NOW(3), + NOW(3) +) + +ON DUPLICATE KEY UPDATE + `passwordHash` = VALUES(`passwordHash`), + `viewablePassword` = VALUES(`viewablePassword`), + `role` = VALUES(`role`), + `status` = VALUES(`status`), + `fullName` = VALUES(`fullName`), + `companyName` = VALUES(`companyName`), + `storageQuotaBytes` = VALUES(`storageQuotaBytes`), + `canCreateShareLinks` = VALUES(`canCreateShareLinks`), + `canDeleteFiles` = VALUES(`canDeleteFiles`), + `canViewOtherUsers` = VALUES(`canViewOtherUsers`), + `remoteFileServerUrl` = VALUES(`remoteFileServerUrl`), + `canUseRemoteServer` = VALUES(`canUseRemoteServer`), + `updatedAt` = NOW(3); + +-- ---------------------------------------------------------------------- +-- 2. ENSURE ROOT STORAGE FOLDERS EXIST (Table: `Folder`) +-- ---------------------------------------------------------------------- +INSERT INTO `Folder` ( + `id`, + `ownerId`, + `parentId`, + `name`, + `logicalPath`, + `createdAt`, + `updatedAt` +) VALUES +('root-folder-ecohub-0001', 'ecohub-superadmin-uuid-2026-0001', NULL, 'Root', '/', NOW(3), NOW(3)), +('root-folder-ecohubstaff-0002', 'ecohubstaff-admin-uuid-2026-0002', NULL, 'Root', '/', NOW(3), NOW(3)), +('root-folder-ecouser-0003', 'ecouser-normal-uuid-2026-0003', NULL, 'Root', '/', NOW(3), NOW(3)) + +ON DUPLICATE KEY UPDATE + `logicalPath` = VALUES(`logicalPath`); + +-- ---------------------------------------------------------------------- +-- 3. INITIALIZE DEFAULT SYSTEM SETTINGS (Table: `SystemSetting`) +-- ---------------------------------------------------------------------- +INSERT INTO `SystemSetting` (`id`, `key`, `value`, `description`, `updatedAt`) VALUES +(UUID(), 'MAX_FILE_SIZE_BYTES', '5368709120', 'Maximum permitted single file upload size in bytes (5 GB)', NOW(3)), +(UUID(), 'DEFAULT_USER_QUOTA_BYTES', '10737418240', 'Default storage quota allocated to newly registered users (10 GB)', NOW(3)), +(UUID(), 'ALLOWED_EXTENSIONS', 'mp4,webm,mov,avi,mkv,png,jpg,jpeg,webp,gif,pdf,doc,docx,xls,xlsx,ppt,pptx,zip,rar,7z,tar,gz,mp3,wav,ogg,txt,csv,json', 'Allowed file extensions whitelist', NOW(3)), +(UUID(), 'ENABLE_PUBLIC_REGISTRATION', 'true', 'Flag controlling whether new users can self-register', NOW(3)), +(UUID(), 'STORAGE_RETENTION_DAYS', '30', 'Soft-deleted file retention duration in recycle bin', NOW(3)), +(UUID(), 'STORAGE_BASE_PATH', './storage', 'Dynamic local storage directory location (can be changed by Superadmin anytime)', NOW(3)), +(UUID(), 'REMOTE_FILE_SERVER_URL', '', 'Optional Remote File Server Link / URL for external video uploads and mirroring', NOW(3)) + +ON DUPLICATE KEY UPDATE + `value` = VALUES(`value`); + +-- Re-enable foreign key checks +SET FOREIGN_KEY_CHECKS = 1; + +-- Output confirmation notice +SELECT 'Ecohub user accounts imported and activated successfully!' AS `Status`; diff --git a/apps/backend/src/app.module.ts b/apps/backend/src/app.module.ts new file mode 100644 index 0000000..7baa532 --- /dev/null +++ b/apps/backend/src/app.module.ts @@ -0,0 +1,34 @@ +import { Module } from '@nestjs/common'; +import { ConfigModule } from '@nestjs/config'; +import { PrismaModule } from './modules/prisma/prisma.module'; +import { StorageModule } from './modules/storage/storage.module'; +import { AuditModule } from './modules/audit/audit.module'; +import { AuthModule } from './modules/auth/auth.module'; +import { FoldersModule } from './modules/folders/folders.module'; +import { FilesModule } from './modules/files/files.module'; +import { VideoModule } from './modules/video/video.module'; +import { PermissionsModule } from './modules/permissions/permissions.module'; +import { AdminModule } from './modules/admin/admin.module'; +import { ShareLinksModule } from './modules/share-links/share-links.module'; +import { AndroidModule } from './modules/android/android.module'; + +@Module({ + imports: [ + ConfigModule.forRoot({ + isGlobal: true, + envFilePath: ['.env', '../../.env'], + }), + PrismaModule, + StorageModule, + AuditModule, + AuthModule, + FoldersModule, + FilesModule, + VideoModule, + PermissionsModule, + AdminModule, + ShareLinksModule, + AndroidModule, + ], +}) +export class AppModule {} diff --git a/apps/backend/src/main.ts b/apps/backend/src/main.ts new file mode 100644 index 0000000..00a5df4 --- /dev/null +++ b/apps/backend/src/main.ts @@ -0,0 +1,64 @@ +import { NestFactory } from '@nestjs/core'; +import { ValidationPipe, Logger } from '@nestjs/common'; +import { SwaggerModule, DocumentBuilder } from '@nestjs/swagger'; +import * as cookieParser from 'cookie-parser'; +import * as compression from 'compression'; +import { AppModule } from './app.module'; + +async function bootstrap() { + const logger = new Logger('Bootstrap'); + const app = await NestFactory.create(AppModule); + + // Security middlewares + app.use(cookieParser()); + app.use(compression()); + + // Cross-Origin Resource Sharing - allows access from any LAN IP, localhost, or domain + app.enableCors({ + origin: (origin, callback) => { + // Dynamic origin reflection allows all LAN devices (e.g. 192.168.x.x:3000), mobile apps, and domains + callback(null, true); + }, + credentials: true, + methods: ['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'OPTIONS'], + allowedHeaders: ['Content-Type', 'Authorization', 'Range', 'X-Requested-With'], + exposedHeaders: ['Content-Range', 'Accept-Ranges', 'Content-Length', 'Content-Disposition'], + }); + + // Global Versioned Prefix: /api/v1 + app.setGlobalPrefix('api/v1'); + + // Input Validation & Transformation + app.useGlobalPipes( + new ValidationPipe({ + whitelist: true, + transform: true, + forbidNonWhitelisted: false, + }), + ); + + // Swagger OpenAPI Documentation + const swaggerConfig = new DocumentBuilder() + .setTitle('Secure Video & File Sharing API') + .setDescription( + 'Enterprise-grade secure video streaming, file management, and admin-controlled sharing platform', + ) + .setVersion('1.0.0') + .addBearerAuth() + .addCookieAuth('access_token') + .build(); + + const document = SwaggerModule.createDocument(app, swaggerConfig); + SwaggerModule.setup('api/docs', app, document); + + const port = process.env.PORT || 4000; + await app.listen(port, '0.0.0.0'); + logger.log(`====================================================`); + logger.log(`๐Ÿš€ FileShare Backend Server running on port ${port} (0.0.0.0)`); + logger.log(`๐Ÿ“š Swagger Documentation available at http://localhost:${port}/api/docs`); + logger.log(`๐ŸŒ API Base URL: http://localhost:${port}/api/v1`); + logger.log(`๐Ÿ“ถ Accessible on any network/LAN IP: http://:${port}/api/v1`); + logger.log(`====================================================`); +} + +bootstrap(); diff --git a/apps/backend/src/modules/admin/admin.controller.ts b/apps/backend/src/modules/admin/admin.controller.ts new file mode 100644 index 0000000..1774c75 --- /dev/null +++ b/apps/backend/src/modules/admin/admin.controller.ts @@ -0,0 +1,248 @@ +import { + Controller, + Get, + Post, + Patch, + Delete, + Param, + Body, + Query, + UseGuards, + ForbiddenException, +} from '@nestjs/common'; +import { ApiTags, ApiOperation, ApiBearerAuth, ApiQuery } from '@nestjs/swagger'; +import { AdminService } from './admin.service'; +import { AdminCreateUserDto, AdminUpdateUserDto, UpdateSystemSettingDto } from './dto/admin.dto'; +import { AdminResetPasswordDto } from './dto/admin-reset-password.dto'; +import { AuditService } from '../audit/audit.service'; +import { JwtAuthGuard } from '../auth/guards/jwt-auth.guard'; +import { RolesGuard } from '../auth/guards/roles.guard'; +import { Roles } from '../auth/decorators/roles.decorator'; +import { CurrentUser, AuthenticatedUser } from '../auth/decorators/current-user.decorator'; +import { UserRole, UserStatus, FileCategory } from '@prisma/client'; + +@ApiTags('Admin Console') +@ApiBearerAuth() +@UseGuards(JwtAuthGuard, RolesGuard) +@Roles(UserRole.SUPER_ADMIN, UserRole.ADMIN) +@Controller('admin') +export class AdminController { + constructor( + private readonly adminService: AdminService, + private readonly auditService: AuditService, + ) {} + + @Get('users') + @ApiOperation({ summary: 'List all registered users, roles, statuses and quotas' }) + @ApiQuery({ name: 'search', required: false }) + @ApiQuery({ name: 'role', enum: UserRole, required: false }) + @ApiQuery({ name: 'status', enum: UserStatus, required: false }) + @ApiQuery({ name: 'page', required: false, type: Number }) + @ApiQuery({ name: 'limit', required: false, type: Number }) + async listUsers( + @CurrentUser() admin: AuthenticatedUser, + @Query('search') search?: string, + @Query('role') role?: UserRole, + @Query('status') status?: UserStatus, + @Query('page') page?: string, + @Query('limit') limit?: string, + ) { + return this.adminService.listUsers({ + search, + role, + status, + page: page ? parseInt(page, 10) : 1, + limit: limit ? parseInt(limit, 10) : 50, + requesterRole: admin.role, + canViewOtherUsers: admin.canViewOtherUsers, + requesterId: admin.id, + }); + } + + @Get('companies') + @ApiOperation({ summary: 'List all unique company names registered in the system' }) + async getCompanyList() { + return this.adminService.getUniqueCompanies(); + } + + @Post('companies') + @ApiOperation({ summary: 'Register/create a new organization name in the system' }) + async createCompany(@Body('name') name: string) { + return this.adminService.createOrganization(name); + } + + @Delete('companies/:companyName') + @Roles(UserRole.SUPER_ADMIN) + @ApiOperation({ summary: 'Delete an entire company and its users and files (Super Admin Only)' }) + async deleteCompany( + @Param('companyName') companyName: string, + @CurrentUser() admin: AuthenticatedUser, + ) { + return this.adminService.deleteCompany(companyName, admin.id, admin.role); + } + + @Patch('companies/:companyName') + @ApiOperation({ summary: 'Rename or edit company name across all users (Super Admin & Admin)' }) + async updateCompanyName( + @Param('companyName') companyName: string, + @Body('newCompanyName') newCompanyName: string, + @CurrentUser() admin: AuthenticatedUser, + ) { + return this.adminService.updateCompanyName(companyName, newCompanyName, admin.id, admin.role); + } + + @Post('users') + @ApiOperation({ summary: 'Create user from administrator console' }) + async createUser( + @Body() dto: AdminCreateUserDto, + @CurrentUser() admin: AuthenticatedUser, + ) { + return this.adminService.createUser(dto, admin.id, admin.role); + } + + @Patch('users/:id') + @ApiOperation({ summary: 'Update user role, status (suspend/reactivate), and storage quota' }) + async updateUser( + @Param('id') id: string, + @Body() dto: AdminUpdateUserDto, + @CurrentUser() admin: AuthenticatedUser, + ) { + return this.adminService.updateUser(id, dto, admin.id, admin.role); + } + + @Patch('users/:id/password') + @ApiOperation({ summary: 'Reset user password from administrator console' }) + async resetUserPassword( + @Param('id') id: string, + @Body() dto: AdminResetPasswordDto, + @CurrentUser() admin: AuthenticatedUser, + ) { + return this.adminService.resetUserPassword(id, dto.newPassword, admin.id); + } + + @Delete('users/:id') + @ApiOperation({ summary: 'Delete user and their files completely' }) + async deleteUser( + @Param('id') id: string, + @CurrentUser() admin: AuthenticatedUser, + ) { + return this.adminService.deleteUser(id, admin.id, admin.role, admin.companyName); + } + + @Get('users/:id/files') + @ApiOperation({ summary: 'User-wise File Explorer: browse files belonging to a specific user' }) + @ApiQuery({ name: 'folderId', required: false }) + @ApiQuery({ name: 'category', enum: FileCategory, required: false }) + @ApiQuery({ name: 'search', required: false }) + @ApiQuery({ name: 'page', required: false, type: Number }) + @ApiQuery({ name: 'limit', required: false, type: Number }) + async getUserFiles( + @Param('id') id: string, + @CurrentUser() admin: AuthenticatedUser, + @Query('folderId') folderId?: string, + @Query('category') category?: FileCategory, + @Query('search') search?: string, + @Query('page') page?: string, + @Query('limit') limit?: string, + ) { + return this.adminService.getUserFiles( + id, + { + folderId, + category, + search, + page: page ? parseInt(page, 10) : 1, + limit: limit ? parseInt(limit, 10) : 50, + }, + admin.id, + admin.role, + admin.canViewOtherUsers, + ); + } + + @Get('users/:id/folders') + @ApiOperation({ summary: 'Browse folders belonging to a specific user' }) + async getUserFolders( + @Param('id') id: string, + @CurrentUser() admin: AuthenticatedUser, + ) { + return this.adminService.getUserFolders( + id, + admin.id, + admin.role, + admin.canViewOtherUsers, + ); + } + + @Get('resources') + @ApiOperation({ summary: 'List resources (Files or Folders) for permission dropdown selection' }) + @ApiQuery({ name: 'type', enum: ['FILE', 'FOLDER'], required: false }) + @ApiQuery({ name: 'ownerId', required: false }) + @ApiQuery({ name: 'search', required: false }) + @ApiQuery({ name: 'limit', required: false, type: Number }) + async getResources( + @CurrentUser() admin: AuthenticatedUser, + @Query('type') type?: 'FILE' | 'FOLDER', + @Query('ownerId') ownerId?: string, + @Query('search') search?: string, + @Query('limit') limit?: string, + ) { + return this.adminService.getResources( + { + type, + ownerId, + search, + limit: limit ? parseInt(limit, 10) : 100, + }, + admin.id, + admin.role, + admin.canViewOtherUsers, + ); + } + + @Get('storage/overview') + @ApiOperation({ summary: 'System storage utilization, user counts and category breakdown' }) + async getStorageOverview(@CurrentUser() admin: AuthenticatedUser) { + if (admin.role !== UserRole.SUPER_ADMIN && !admin.canViewOtherUsers) { + throw new ForbiddenException( + 'Access denied. Only Super Admin or authorized users with "canViewOtherUsers" permission can view storage overview.', + ); + } + return this.adminService.getStorageOverview(); + } + + @Get('audit-logs') + @ApiOperation({ summary: 'View security audit logs and administrative actions' }) + @ApiQuery({ name: 'limit', required: false, type: Number }) + @ApiQuery({ name: 'skip', required: false, type: Number }) + async getAuditLogs( + @CurrentUser() admin: AuthenticatedUser, + @Query('limit') limit?: string, + @Query('skip') skip?: string, + ) { + if (admin.role !== UserRole.SUPER_ADMIN && !admin.canViewOtherUsers) { + throw new ForbiddenException( + 'Access denied. Only Super Admin or authorized users with "canViewOtherUsers" permission can view audit logs.', + ); + } + return this.auditService.getRecentLogs( + limit ? parseInt(limit, 10) : 100, + skip ? parseInt(skip, 10) : 0, + ); + } + + @Get('settings') + @ApiOperation({ summary: 'Get system upload limits and configurations' }) + async getSettings() { + return this.adminService.getSettings(); + } + + @Patch('settings') + @ApiOperation({ summary: 'Update system upload limit or configuration' }) + async updateSetting( + @Body() dto: UpdateSystemSettingDto, + @CurrentUser() admin: AuthenticatedUser, + ) { + return this.adminService.updateSetting(dto, admin.id); + } +} diff --git a/apps/backend/src/modules/admin/admin.module.ts b/apps/backend/src/modules/admin/admin.module.ts new file mode 100644 index 0000000..fdad709 --- /dev/null +++ b/apps/backend/src/modules/admin/admin.module.ts @@ -0,0 +1,10 @@ +import { Module } from '@nestjs/common'; +import { AdminService } from './admin.service'; +import { AdminController } from './admin.controller'; + +@Module({ + controllers: [AdminController], + providers: [AdminService], + exports: [AdminService], +}) +export class AdminModule {} diff --git a/apps/backend/src/modules/admin/admin.service.ts b/apps/backend/src/modules/admin/admin.service.ts new file mode 100644 index 0000000..3ef65ad --- /dev/null +++ b/apps/backend/src/modules/admin/admin.service.ts @@ -0,0 +1,959 @@ +import { + Injectable, + Inject, + NotFoundException, + ConflictException, + BadRequestException, + ForbiddenException, +} from '@nestjs/common'; +import * as argon2 from 'argon2'; +import { PrismaService } from '../prisma/prisma.service'; +import { AuditService } from '../audit/audit.service'; +import { STORAGE_PROVIDER, IStorageProvider } from '../storage/storage.interface'; +import { AdminCreateUserDto, AdminUpdateUserDto, UpdateSystemSettingDto } from './dto/admin.dto'; +import { UserRole, UserStatus, FileCategory, FileStatus } from '@prisma/client'; + +@Injectable() +export class AdminService { + constructor( + private readonly prisma: PrismaService, + private readonly auditService: AuditService, + @Inject(STORAGE_PROVIDER) private readonly storageService: IStorageProvider, + ) {} + + /** + * List users with search, role filter, status filter, and pagination + */ + async listUsers(params: { + search?: string; + role?: UserRole; + status?: UserStatus; + page?: number; + limit?: number; + requesterRole?: UserRole | string; + canViewOtherUsers?: boolean; + requesterId?: string; + }) { + const isSuperAdmin = params.requesterRole === UserRole.SUPER_ADMIN || params.requesterRole === 'SUPER_ADMIN'; + const isAdmin = params.requesterRole === UserRole.ADMIN || params.requesterRole === 'ADMIN'; + const hasPermission = isSuperAdmin || isAdmin || !!params.canViewOtherUsers; + + if (!hasPermission) { + throw new ForbiddenException( + 'Access denied. Only Super Admin, Administrators, or authorized users with "canViewOtherUsers" permission can view other users\' information.', + ); + } + + const page = params.page || 1; + const limit = params.limit || 50; + const skip = (page - 1) * limit; + + const where: any = {}; + if (params.role) where.role = params.role; + if (params.status) where.status = params.status; + if (params.search) { + where.OR = [ + { email: { contains: params.search } }, + { username: { contains: params.search } }, + { fullName: { contains: params.search } }, + ]; + } + + const [total, users] = await Promise.all([ + this.prisma.user.count({ where }), + this.prisma.user.findMany({ + where, + take: limit, + skip, + orderBy: { createdAt: 'desc' }, + include: { + _count: { + select: { + files: { where: { isSoftDeleted: false } }, + folders: true, + }, + }, + }, + }), + ]); + + return { + total, + page, + limit, + users: users.map((u) => ({ + id: u.id, + email: u.email, + username: u.username, + fullName: u.fullName, + companyName: u.companyName, + allowedCompanies: u.allowedCompanies, + role: u.role, + status: u.status, + storageQuotaBytes: u.storageQuotaBytes.toString(), + storageUsedBytes: u.storageUsedBytes.toString(), + canCreateShareLinks: u.canCreateShareLinks, + canDeleteFiles: u.canDeleteFiles, + canViewOtherUsers: u.role === UserRole.SUPER_ADMIN ? true : (u.canViewOtherUsers ?? false), + remoteFileServerUrl: u.remoteFileServerUrl, + canUseRemoteServer: u.canUseRemoteServer, + fileCount: u._count.files, + folderCount: u._count.folders, + createdAt: u.createdAt, + updatedAt: u.updatedAt, + lastLoginAt: u.lastLoginAt, + viewablePassword: isSuperAdmin ? (u.viewablePassword || null) : undefined, + })), + }; + } + + /** + * Create a new user from administrative console + */ + async createUser(dto: AdminCreateUserDto, creatorUserId: string, creatorRole?: UserRole | string) { + const isSuperAdmin = creatorRole === UserRole.SUPER_ADMIN || creatorRole === 'SUPER_ADMIN'; + if (dto.canViewOtherUsers && !isSuperAdmin) { + throw new ForbiddenException('Only Super Admin can grant "canViewOtherUsers" permission'); + } + + const [existingEmail, existingUsername] = await Promise.all([ + this.prisma.user.findUnique({ where: { email: dto.email.toLowerCase() } }), + this.prisma.user.findUnique({ where: { username: dto.username.toLowerCase() } }), + ]); + + if (existingEmail) throw new ConflictException('Email already registered'); + if (existingUsername) throw new ConflictException('Username already taken'); + + const passwordHash = await argon2.hash(dto.password, { type: argon2.argon2id }); + const quota = dto.storageQuotaBytes ? BigInt(dto.storageQuotaBytes) : BigInt(5368709120); + + const canViewOtherUsers = isSuperAdmin + ? (dto.role === UserRole.SUPER_ADMIN ? true : (dto.canViewOtherUsers ?? false)) + : false; + + const user = await this.prisma.$transaction(async (tx) => { + const createdUser = await tx.user.create({ + data: { + email: dto.email.toLowerCase(), + username: dto.username.toLowerCase(), + fullName: dto.fullName.trim(), + companyName: dto.companyName && dto.companyName.trim() ? dto.companyName.trim() : 'Ecohub', + allowedCompanies: dto.allowedCompanies !== undefined ? (dto.allowedCompanies ? dto.allowedCompanies.trim() : null) : null, + passwordHash, + viewablePassword: dto.password, + role: dto.role || UserRole.USER, + status: UserStatus.ACTIVE, + storageQuotaBytes: quota, + canCreateShareLinks: dto.canCreateShareLinks ?? (dto.role === UserRole.SUPER_ADMIN || dto.role === UserRole.ADMIN), + canDeleteFiles: dto.canDeleteFiles ?? true, + canViewOtherUsers, + remoteFileServerUrl: dto.remoteFileServerUrl && dto.remoteFileServerUrl.trim() ? dto.remoteFileServerUrl.trim() : null, + canUseRemoteServer: dto.canUseRemoteServer ?? true, + }, + }); + + // Automatic root folder creation + await tx.folder.create({ + data: { + ownerId: createdUser.id, + parentId: null, + name: 'Root', + logicalPath: '/', + }, + }); + + return createdUser; + }); + + await this.auditService.log({ + actorUserId: creatorUserId, + action: 'ADMIN_CREATED_USER', + resourceType: 'USER', + resourceId: user.id, + targetUserId: user.id, + details: { email: user.email, role: user.role, remoteFileServerUrl: user.remoteFileServerUrl }, + }); + + return { + id: user.id, + email: user.email, + username: user.username, + fullName: user.fullName, + companyName: user.companyName, + allowedCompanies: user.allowedCompanies, + role: user.role, + status: user.status, + storageQuotaBytes: user.storageQuotaBytes.toString(), + storageUsedBytes: user.storageUsedBytes.toString(), + canCreateShareLinks: user.canCreateShareLinks, + canDeleteFiles: user.canDeleteFiles, + canViewOtherUsers: user.role === UserRole.SUPER_ADMIN ? true : (user.canViewOtherUsers ?? false), + remoteFileServerUrl: user.remoteFileServerUrl, + canUseRemoteServer: user.canUseRemoteServer, + createdAt: user.createdAt, + }; + } + + /** + * Update user properties (role, status, quota, full name, password) + */ + async updateUser(id: string, dto: AdminUpdateUserDto, actorUserId: string, actorRole?: UserRole | string) { + const user = await this.prisma.user.findUnique({ where: { id } }); + if (!user) throw new NotFoundException('User not found'); + + const isSuperAdmin = actorRole === UserRole.SUPER_ADMIN || actorRole === 'SUPER_ADMIN'; + const updateData: any = {}; + if (dto.fullName) updateData.fullName = dto.fullName.trim(); + if (dto.companyName !== undefined) updateData.companyName = dto.companyName.trim() || 'Ecohub'; + if (dto.allowedCompanies !== undefined) { + updateData.allowedCompanies = dto.allowedCompanies && dto.allowedCompanies.trim() ? dto.allowedCompanies.trim() : null; + } + if (dto.role) updateData.role = dto.role; + if (dto.status) updateData.status = dto.status; + if (dto.storageQuotaBytes !== undefined) { + updateData.storageQuotaBytes = BigInt(dto.storageQuotaBytes); + } + if (dto.canCreateShareLinks !== undefined) { + updateData.canCreateShareLinks = dto.canCreateShareLinks; + } + if (dto.canDeleteFiles !== undefined) { + updateData.canDeleteFiles = dto.canDeleteFiles; + } + if (dto.canViewOtherUsers !== undefined) { + if (!isSuperAdmin) { + throw new ForbiddenException('Only Super Admin can grant or revoke "canViewOtherUsers" permission'); + } + updateData.canViewOtherUsers = dto.canViewOtherUsers; + } + if (dto.remoteFileServerUrl !== undefined) { + updateData.remoteFileServerUrl = dto.remoteFileServerUrl && dto.remoteFileServerUrl.trim() ? dto.remoteFileServerUrl.trim() : null; + } + if (dto.canUseRemoteServer !== undefined) { + updateData.canUseRemoteServer = dto.canUseRemoteServer; + } + if (dto.newPassword) { + updateData.passwordHash = await argon2.hash(dto.newPassword, { type: argon2.argon2id }); + updateData.viewablePassword = dto.newPassword; + } + + const updated = await this.prisma.user.update({ + where: { id }, + data: updateData, + }); + + await this.auditService.log({ + actorUserId, + action: 'ADMIN_UPDATED_USER', + resourceType: 'USER', + resourceId: id, + targetUserId: id, + details: { changes: Object.keys(updateData) }, + }); + + return { + id: updated.id, + email: updated.email, + username: updated.username, + fullName: updated.fullName, + companyName: updated.companyName, + allowedCompanies: updated.allowedCompanies, + role: updated.role, + status: updated.status, + storageQuotaBytes: updated.storageQuotaBytes.toString(), + storageUsedBytes: updated.storageUsedBytes.toString(), + canCreateShareLinks: updated.canCreateShareLinks, + canDeleteFiles: updated.canDeleteFiles, + canViewOtherUsers: updated.role === UserRole.SUPER_ADMIN ? true : (updated.canViewOtherUsers ?? false), + remoteFileServerUrl: updated.remoteFileServerUrl, + canUseRemoteServer: updated.canUseRemoteServer, + updatedAt: updated.updatedAt, + }; + } + + /** + * Reset user password from Admin Console (Superadmin & Admin) + */ + async resetUserPassword(targetUserId: string, newPassword: string, actorUserId: string) { + const user = await this.prisma.user.findUnique({ where: { id: targetUserId } }); + if (!user) throw new NotFoundException('User not found'); + + const passwordHash = await argon2.hash(newPassword, { type: argon2.argon2id }); + + await this.prisma.user.update({ + where: { id: targetUserId }, + data: { + passwordHash, + viewablePassword: newPassword, + }, + }); + + // Revoke any active refresh tokens for this user + await this.prisma.refreshToken.updateMany({ + where: { userId: targetUserId, revokedAt: null }, + data: { revokedAt: new Date() }, + }); + + await this.auditService.log({ + actorUserId, + action: 'ADMIN_RESET_USER_PASSWORD', + resourceType: 'USER', + resourceId: targetUserId, + targetUserId, + details: { username: user.username }, + }); + + return { + success: true, + message: `Password for user "${user.username}" reset successfully`, + }; + } + + /** + * User-wise File Explorer: browse files belonging to a specific user + */ + async getUserFiles( + targetUserId: string, + params: { + folderId?: string; + category?: FileCategory; + search?: string; + page?: number; + limit?: number; + }, + adminUserId: string, + requesterRole?: UserRole | string, + canViewOtherUsers?: boolean, + ) { + const isSuperAdmin = requesterRole === UserRole.SUPER_ADMIN || requesterRole === 'SUPER_ADMIN'; + if (targetUserId !== adminUserId && !isSuperAdmin && !canViewOtherUsers) { + throw new ForbiddenException( + 'Access denied. Only Super Admin or authorized users with "canViewOtherUsers" permission can view other users\' files.', + ); + } + + const user = await this.prisma.user.findUnique({ where: { id: targetUserId } }); + if (!user) throw new NotFoundException('Target user not found'); + + const page = params.page || 1; + const limit = params.limit || 50; + const skip = (page - 1) * limit; + + const where: any = { + ownerId: targetUserId, + isSoftDeleted: false, + }; + if (params.folderId) where.folderId = params.folderId; + if (params.category) where.fileCategory = params.category; + if (params.search) where.originalFilename = { contains: params.search }; + + const [total, files] = await Promise.all([ + this.prisma.fileAsset.count({ where }), + this.prisma.fileAsset.findMany({ + where, + take: limit, + skip, + orderBy: { createdAt: 'desc' }, + include: { + folder: { select: { id: true, name: true, logicalPath: true } }, + }, + }), + ]); + + await this.auditService.log({ + actorUserId: adminUserId, + action: 'ADMIN_EXPLORED_USER_FILES', + resourceType: 'USER', + targetUserId, + details: { filesCount: files.length }, + }); + + return { + targetUser: { + id: user.id, + email: user.email, + username: user.username, + fullName: user.fullName, + storageQuotaBytes: user.storageQuotaBytes.toString(), + storageUsedBytes: user.storageUsedBytes.toString(), + }, + total, + page, + limit, + files: files.map((f) => ({ + id: f.id, + folderId: f.folderId, + folderName: f.folder?.name || 'Root', + originalFilename: f.originalFilename, + mimeType: f.mimeType, + fileExtension: f.fileExtension, + fileSizeBytes: f.fileSizeBytes.toString(), + fileCategory: f.fileCategory, + status: f.status, + durationSeconds: f.durationSeconds, + width: f.width, + height: f.height, + hasThumbnail: !!f.thumbnailStorageKey, + hasHlsStream: !!f.hlsMasterPlaylistKey, + createdAt: f.createdAt, + })), + }; + } + + /** + * Browse folders belonging to a specific user + */ + async getUserFolders( + targetUserId: string, + adminUserId: string, + requesterRole?: UserRole | string, + canViewOtherUsers?: boolean, + ) { + const isSuperAdmin = requesterRole === UserRole.SUPER_ADMIN || requesterRole === 'SUPER_ADMIN'; + if (targetUserId !== adminUserId && !isSuperAdmin && !canViewOtherUsers) { + throw new ForbiddenException( + 'Access denied. Only Super Admin or authorized users with "canViewOtherUsers" permission can view other users\' folders.', + ); + } + + const user = await this.prisma.user.findUnique({ where: { id: targetUserId } }); + if (!user) throw new NotFoundException('Target user not found'); + + const folders = await this.prisma.folder.findMany({ + where: { ownerId: targetUserId }, + orderBy: { logicalPath: 'asc' }, + select: { + id: true, + name: true, + logicalPath: true, + parentId: true, + createdAt: true, + }, + }); + + return { folders }; + } + + /** + * Search and list system resources (Files or Folders) for permission dropdown selection + */ + async getResources( + params: { + type?: 'FILE' | 'FOLDER'; + ownerId?: string; + search?: string; + limit?: number; + }, + adminUserId: string, + requesterRole?: UserRole | string, + canViewOtherUsers?: boolean, + ) { + const isSuperAdmin = requesterRole === UserRole.SUPER_ADMIN || requesterRole === 'SUPER_ADMIN'; + if (!isSuperAdmin && !canViewOtherUsers) { + if (params.ownerId && params.ownerId !== adminUserId) { + throw new ForbiddenException( + 'Access denied. Only Super Admin or authorized users can view other users\' resources.', + ); + } + params.ownerId = adminUserId; + } + + const limit = params.limit ? Math.min(params.limit, 200) : 100; + const type = params.type || 'FILE'; + + if (type === 'FOLDER') { + const folders = await this.prisma.folder.findMany({ + where: { + ...(params.ownerId ? { ownerId: params.ownerId } : {}), + ...(params.search ? { name: { contains: params.search } } : {}), + }, + take: limit, + orderBy: { logicalPath: 'asc' }, + include: { + owner: { + select: { id: true, fullName: true, email: true, username: true, companyName: true }, + }, + }, + }); + + return { + type: 'FOLDER', + items: folders.map((f) => ({ + id: f.id, + name: f.name, + logicalPath: f.logicalPath, + ownerId: f.ownerId, + ownerName: f.owner?.fullName || f.owner?.username || f.owner?.email, + ownerEmail: f.owner?.email, + ownerCompany: f.owner?.companyName, + })), + }; + } + + // Default to FILE + const files = await this.prisma.fileAsset.findMany({ + where: { + isSoftDeleted: false, + ...(params.ownerId ? { ownerId: params.ownerId } : {}), + ...(params.search ? { originalFilename: { contains: params.search } } : {}), + }, + take: limit, + orderBy: { createdAt: 'desc' }, + include: { + owner: { + select: { id: true, fullName: true, email: true, username: true, companyName: true }, + }, + folder: { + select: { id: true, name: true, logicalPath: true }, + }, + }, + }); + + return { + type: 'FILE', + items: files.map((f) => ({ + id: f.id, + name: f.originalFilename, + sizeBytes: f.fileSizeBytes.toString(), + category: f.fileCategory, + mimeType: f.mimeType, + folderName: f.folder?.name || 'Root', + ownerId: f.ownerId, + ownerName: f.owner?.fullName || f.owner?.username || f.owner?.email, + ownerEmail: f.owner?.email, + ownerCompany: f.owner?.companyName, + })), + }; + } + + /** + * System-wide storage overview and statistics + */ + async getStorageOverview() { + const [userCount, activeUserCount, totalFiles, videoFiles] = await Promise.all([ + this.prisma.user.count(), + this.prisma.user.count({ where: { status: UserStatus.ACTIVE } }), + this.prisma.fileAsset.count({ where: { isSoftDeleted: false } }), + this.prisma.fileAsset.count({ where: { fileCategory: FileCategory.VIDEO, isSoftDeleted: false } }), + ]); + + const users = await this.prisma.user.findMany({ + select: { storageQuotaBytes: true, storageUsedBytes: true }, + }); + + const totalQuota = users.reduce((acc, u) => acc + u.storageQuotaBytes, BigInt(0)); + const totalUsed = users.reduce((acc, u) => acc + u.storageUsedBytes, BigInt(0)); + + // Category breakdown + const categoryCounts = await this.prisma.fileAsset.groupBy({ + by: ['fileCategory'], + where: { isSoftDeleted: false }, + _count: { id: true }, + _sum: { fileSizeBytes: true }, + }); + + // Video transcoding statuses + const [videoReady, videoProcessing, videoFailed] = await Promise.all([ + this.prisma.fileAsset.count({ + where: { fileCategory: FileCategory.VIDEO, status: FileStatus.READY, isSoftDeleted: false }, + }), + this.prisma.fileAsset.count({ + where: { + fileCategory: FileCategory.VIDEO, + status: { in: [FileStatus.PROCESSING, FileStatus.PENDING, FileStatus.UPLOADING] }, + isSoftDeleted: false, + }, + }), + this.prisma.fileAsset.count({ + where: { fileCategory: FileCategory.VIDEO, status: FileStatus.FAILED, isSoftDeleted: false }, + }), + ]); + + const usagePercentage = totalQuota > BigInt(0) ? Number((totalUsed * BigInt(100)) / totalQuota) : 0; + + const breakdown = categoryCounts.map((c) => ({ + category: c.fileCategory, + count: c._count.id, + sizeBytes: c._sum.fileSizeBytes ? Number(c._sum.fileSizeBytes) : 0, + totalBytes: c._sum.fileSizeBytes ? c._sum.fileSizeBytes.toString() : '0', + })); + + return { + userCount, + totalUsers: userCount, + activeUserCount, + totalFiles, + videoFiles, + totalQuotaBytes: Number(totalQuota), + totalUsedBytes: Number(totalUsed), + usagePercentage, + utilizationPercentage: usagePercentage, + categoryBreakdown: breakdown, + categories: breakdown, + videoStats: { + ready: videoReady, + processing: videoProcessing, + failed: videoFailed, + }, + }; + } + + /** + * Get all system settings + */ + async getSettings() { + const defaultSettings = [ + { key: 'MAX_FILE_SIZE_BYTES', value: '5368709120', description: 'Maximum allowed single file upload size (5 GB)' }, + { key: 'ALLOWED_EXTENSIONS', value: 'mp4,mov,avi,mkv,webm,flv,wmv,m4v,pdf,docx,xlsx,pptx,txt,zip,rar,7z,tar,gz,jpg,jpeg,png,webp,svg,gif,mp3,wav,aac,flac', description: 'Comma-separated list of allowed file extensions' }, + { key: 'STORAGE_BASE_PATH', value: './storage', description: 'Dynamic storage directory location (Superadmin can change location anytime)' }, + { key: 'REMOTE_FILE_SERVER_URL', value: '', description: 'Optional Remote File Server Link / URL for external video uploads and mirroring' }, + ]; + + for (const def of defaultSettings) { + await this.prisma.systemSetting.upsert({ + where: { key: def.key }, + update: {}, + create: def, + }); + } + + return this.prisma.systemSetting.findMany({ + orderBy: { key: 'asc' }, + }); + } + + /** + * Update system setting + */ + async updateSetting(dto: UpdateSystemSettingDto, adminUserId: string) { + const setting = await this.prisma.systemSetting.upsert({ + where: { key: dto.key }, + update: { value: dto.value }, + create: { key: dto.key, value: dto.value }, + }); + + await this.auditService.log({ + actorUserId: adminUserId, + action: 'ADMIN_UPDATED_SYSTEM_SETTING', + resourceType: 'SETTING', + resourceId: dto.key, + details: { key: dto.key, value: dto.value }, + }); + + return setting; + } + + /** + * Get all distinct company names registered in the system + */ + async getUniqueCompanies(): Promise { + const users = await this.prisma.user.findMany({ + select: { companyName: true, allowedCompanies: true }, + }); + const set = new Set(); + set.add('Ecohub'); + + for (const u of users) { + if (u.companyName && u.companyName.trim()) { + set.add(u.companyName.trim()); + } + if (u.allowedCompanies && u.allowedCompanies.trim() && u.allowedCompanies.trim() !== '*') { + try { + const raw = u.allowedCompanies.trim(); + if (raw.startsWith('[') && raw.endsWith(']')) { + const parsed = JSON.parse(raw); + if (Array.isArray(parsed)) { + for (const c of parsed) { + if (c && typeof c === 'string' && c.trim()) { + set.add(c.trim()); + } + } + } + } else { + const list = raw.split(',').map((s) => s.trim()).filter(Boolean); + for (const c of list) set.add(c); + } + } catch { + // ignore parsing error + } + } + } + + // Check system_organizations in SystemSetting + try { + const setting = await this.prisma.systemSetting.findUnique({ + where: { key: 'system_organizations' }, + }); + if (setting && setting.value) { + const orgList = JSON.parse(setting.value); + if (Array.isArray(orgList)) { + for (const org of orgList) { + if (org && typeof org === 'string' && org.trim()) { + set.add(org.trim()); + } + } + } + } + } catch { + // ignore + } + + return Array.from(set).sort((a, b) => a.localeCompare(b)); + } + + /** + * Register a new organization name in the system + */ + async createOrganization(name: string): Promise { + const trimmed = name ? name.trim() : ''; + if (!trimmed) { + return this.getUniqueCompanies(); + } + + try { + const setting = await this.prisma.systemSetting.findUnique({ + where: { key: 'system_organizations' }, + }); + + const set = new Set(); + if (setting && setting.value) { + try { + const parsed = JSON.parse(setting.value); + if (Array.isArray(parsed)) { + for (const item of parsed) set.add(item); + } + } catch {} + } + + set.add(trimmed); + + await this.prisma.systemSetting.upsert({ + where: { key: 'system_organizations' }, + create: { + key: 'system_organizations', + value: JSON.stringify(Array.from(set)), + description: 'Persistent list of registered system organizations', + }, + update: { + value: JSON.stringify(Array.from(set)), + }, + }); + } catch (err) { + // Ignore if systemSetting table query fails + } + + return this.getUniqueCompanies(); + } + + /** + * Permanently delete user and clean up physical storage files + */ + async deleteUser( + targetUserId: string, + requesterId: string, + requesterRole?: UserRole | string, + requesterCompanyName?: string, + ) { + if (targetUserId === requesterId) { + throw new BadRequestException('You cannot delete your own account.'); + } + + const targetUser = await this.prisma.user.findUnique({ + where: { id: targetUserId }, + include: { + files: { select: { id: true, internalStorageKey: true, thumbnailStorageKey: true } }, + }, + }); + + if (!targetUser) { + throw new NotFoundException('User not found.'); + } + + const isSuperAdmin = requesterRole === UserRole.SUPER_ADMIN || requesterRole === 'SUPER_ADMIN'; + const isAdmin = requesterRole === UserRole.ADMIN || requesterRole === 'ADMIN'; + + if (targetUser.role === UserRole.SUPER_ADMIN) { + if (!isSuperAdmin) { + throw new ForbiddenException('Only a Super Administrator can delete another Super Administrator.'); + } + const superAdminCount = await this.prisma.user.count({ + where: { role: UserRole.SUPER_ADMIN }, + }); + if (superAdminCount <= 1) { + throw new BadRequestException('Cannot delete the last remaining Super Administrator account.'); + } + } else if (targetUser.role === UserRole.ADMIN && !isSuperAdmin) { + throw new ForbiddenException('Only a Super Administrator can delete Administrator accounts.'); + } + + // Restriction: Administrators cannot delete users belonging to another company + if (!isSuperAdmin && isAdmin) { + const adminCompany = (requesterCompanyName || 'Ecohub').trim().toLowerCase(); + const userCompany = (targetUser.companyName || 'Ecohub').trim().toLowerCase(); + if (adminCompany !== userCompany) { + throw new ForbiddenException( + 'Administrators cannot delete users belonging to another company. Only Super Admin has this permission.', + ); + } + } + + // Clean up physical storage files for this user + for (const f of targetUser.files) { + try { + if (f.internalStorageKey) await this.storageService.delete(f.internalStorageKey); + if (f.thumbnailStorageKey) await this.storageService.delete(f.thumbnailStorageKey); + } catch (err) { + // Silently continue if file was already removed from storage + } + } + + // Explicitly delete any file permissions involving this user + await this.prisma.filePermission.deleteMany({ + where: { + OR: [ + { ownerId: targetUserId }, + { granteeUserId: targetUserId }, + { grantedByUserId: targetUserId }, + ], + }, + }); + + // Delete user from DB (Prisma cascade handles files, folders, sessions, tokens) + await this.prisma.user.delete({ + where: { id: targetUserId }, + }); + + await this.auditService.log({ + actorUserId: requesterId, + action: 'USER_DELETED', + resourceType: 'USER', + resourceId: targetUserId, + details: { + username: targetUser.username, + email: targetUser.email, + fullName: targetUser.fullName, + role: targetUser.role, + companyName: targetUser.companyName, + }, + }); + + return { + success: true, + message: `User "${targetUser.fullName}" (@${targetUser.username}) deleted successfully.`, + }; + } + + /** + * Delete an entire company and all its user accounts and physical files (Super Admin Only) + */ + async deleteCompany(companyName: string, requesterId: string, requesterRole?: UserRole | string) { + const isSuperAdmin = requesterRole === UserRole.SUPER_ADMIN || requesterRole === 'SUPER_ADMIN'; + if (!isSuperAdmin) { + throw new ForbiddenException('Only Super Administrator can delete an entire company.'); + } + + const trimmedCompany = companyName.trim(); + if (!trimmedCompany) { + throw new BadRequestException('Company name is required.'); + } + + // Find all users belonging to this company + const users = await this.prisma.user.findMany({ + where: { companyName: trimmedCompany }, + include: { + files: { select: { id: true, internalStorageKey: true, thumbnailStorageKey: true } }, + }, + }); + + if (users.length === 0) { + return { success: true, message: `Company "${trimmedCompany}" has no registered users.` }; + } + + // Prevent deleting if it contains the only remaining Super Administrator + const containsRequester = users.some((u) => u.id === requesterId); + if (containsRequester) { + const totalSuperAdmins = await this.prisma.user.count({ where: { role: UserRole.SUPER_ADMIN } }); + const superAdminsInCompany = users.filter((u) => u.role === UserRole.SUPER_ADMIN).length; + if (totalSuperAdmins - superAdminsInCompany < 1) { + throw new BadRequestException('Cannot delete this company because it contains the only remaining Super Administrator.'); + } + } + + // Clean up physical storage files for all users in this company + for (const u of users) { + for (const f of u.files) { + try { + if (f.internalStorageKey) await this.storageService.delete(f.internalStorageKey); + if (f.thumbnailStorageKey) await this.storageService.delete(f.thumbnailStorageKey); + } catch (err) {} + } + } + + const userIds = users.map((u) => u.id); + + // Delete permissions involving these users + await this.prisma.filePermission.deleteMany({ + where: { + OR: [ + { ownerId: { in: userIds } }, + { granteeUserId: { in: userIds } }, + { grantedByUserId: { in: userIds } }, + ], + }, + }); + + // Delete users from DB (Cascade deletes folders, files, upload sessions, tokens) + await this.prisma.user.deleteMany({ + where: { id: { in: userIds } }, + }); + + await this.auditService.log({ + actorUserId: requesterId, + action: 'COMPANY_DELETED', + resourceType: 'COMPANY', + resourceId: trimmedCompany, + details: { + companyName: trimmedCompany, + deletedUserCount: users.length, + }, + }); + + return { + success: true, + message: `Company "${trimmedCompany}" and its ${users.length} user accounts and files were completely deleted.`, + }; + } + + /** + * Rename or edit company name across all associated users (Super Admin & Admin) + */ + async updateCompanyName( + oldName: string, + newName: string, + requesterId: string, + requesterRole?: UserRole | string, + ) { + const trimmedOld = oldName.trim(); + const trimmedNew = newName.trim(); + if (!trimmedNew) { + throw new BadRequestException('New company name cannot be empty.'); + } + + const updated = await this.prisma.user.updateMany({ + where: { companyName: trimmedOld }, + data: { companyName: trimmedNew }, + }); + + await this.auditService.log({ + actorUserId: requesterId, + action: 'COMPANY_RENAMED', + resourceType: 'COMPANY', + resourceId: trimmedOld, + details: { oldName: trimmedOld, newName: trimmedNew, usersAffected: updated.count }, + }); + + return { + success: true, + message: `Company renamed to "${trimmedNew}" for ${updated.count} users.`, + }; + } +} diff --git a/apps/backend/src/modules/admin/dto/admin-reset-password.dto.ts b/apps/backend/src/modules/admin/dto/admin-reset-password.dto.ts new file mode 100644 index 0000000..fa77131 --- /dev/null +++ b/apps/backend/src/modules/admin/dto/admin-reset-password.dto.ts @@ -0,0 +1,10 @@ +import { IsNotEmpty, IsString, MinLength } from 'class-validator'; +import { ApiProperty } from '@nestjs/swagger'; + +export class AdminResetPasswordDto { + @ApiProperty({ example: 'NewPassword123', description: 'New password assigned by administrator' }) + @IsNotEmpty() + @IsString() + @MinLength(1) + newPassword: string; +} diff --git a/apps/backend/src/modules/admin/dto/admin.dto.ts b/apps/backend/src/modules/admin/dto/admin.dto.ts new file mode 100644 index 0000000..ddb931e --- /dev/null +++ b/apps/backend/src/modules/admin/dto/admin.dto.ts @@ -0,0 +1,157 @@ +import { + IsBoolean, + IsEmail, + IsEnum, + IsNotEmpty, + IsNumber, + IsOptional, + IsString, + Min, + MinLength, +} from 'class-validator'; +import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger'; +import { UserRole, UserStatus } from '@prisma/client'; + +export class AdminCreateUserDto { + @ApiProperty({ example: 'user@example.com' }) + @IsEmail() + email: string; + + @ApiProperty({ example: 'username' }) + @IsNotEmpty() + @IsString() + username: string; + + @ApiProperty({ example: 'Full Name' }) + @IsNotEmpty() + @IsString() + fullName: string; + + @ApiPropertyOptional({ example: 'Ecohub Technologies' }) + @IsOptional() + @IsString() + companyName?: string; + + @ApiPropertyOptional({ example: '["Ecohub", "Acme Corp"] or *', description: 'Allowed companies for file explorer access' }) + @IsOptional() + @IsString() + allowedCompanies?: string; + + @ApiProperty({ example: 'InitialPassword123!' }) + @IsNotEmpty() + @IsString() + @MinLength(8) + password: string; + + @ApiPropertyOptional({ enum: UserRole, default: UserRole.USER }) + @IsOptional() + @IsEnum(UserRole) + role?: UserRole; + + @ApiPropertyOptional({ example: 5368709120, description: 'Storage quota in bytes (default 5GB)' }) + @IsOptional() + @IsNumber() + @Min(0) + storageQuotaBytes?: number; + + @ApiPropertyOptional({ example: false, description: 'Permission to create public share links' }) + @IsOptional() + @IsBoolean() + canCreateShareLinks?: boolean; + + @ApiPropertyOptional({ example: true, description: 'Permission to delete own files and folders' }) + @IsOptional() + @IsBoolean() + canDeleteFiles?: boolean; + + @ApiPropertyOptional({ example: false, description: 'Permission to view other users and their files' }) + @IsOptional() + @IsBoolean() + canViewOtherUsers?: boolean; + + @ApiPropertyOptional({ example: 'https://remotefileserver.custom.com/upload', description: 'User-specific Remote File Server Link / Upload Endpoint (Optional)' }) + @IsOptional() + @IsString() + remoteFileServerUrl?: string; + + @ApiPropertyOptional({ example: true, description: 'Permission to upload/mirror to remote file server' }) + @IsOptional() + @IsBoolean() + canUseRemoteServer?: boolean; +} + +export class AdminUpdateUserDto { + @ApiPropertyOptional({ example: 'New Full Name' }) + @IsOptional() + @IsString() + fullName?: string; + + @ApiPropertyOptional({ example: 'Ecohub Technologies' }) + @IsOptional() + @IsString() + companyName?: string; + + @ApiPropertyOptional({ example: '["Ecohub", "Acme Corp"] or *', description: 'Allowed companies for file explorer access' }) + @IsOptional() + @IsString() + allowedCompanies?: string; + + @ApiPropertyOptional({ enum: UserRole }) + @IsOptional() + @IsEnum(UserRole) + role?: UserRole; + + @ApiPropertyOptional({ enum: UserStatus }) + @IsOptional() + @IsEnum(UserStatus) + status?: UserStatus; + + @ApiPropertyOptional({ example: 10737418240, description: 'New storage quota in bytes' }) + @IsOptional() + @IsNumber() + @Min(0) + storageQuotaBytes?: number; + + @ApiPropertyOptional({ example: false, description: 'Permission to create public share links' }) + @IsOptional() + @IsBoolean() + canCreateShareLinks?: boolean; + + @ApiPropertyOptional({ example: true, description: 'Permission to delete own files and folders' }) + @IsOptional() + @IsBoolean() + canDeleteFiles?: boolean; + + @ApiPropertyOptional({ example: false, description: 'Permission to view other users and their files' }) + @IsOptional() + @IsBoolean() + canViewOtherUsers?: boolean; + + @ApiPropertyOptional({ example: 'https://remotefileserver.custom.com/upload', description: 'User-specific Remote File Server Link / Upload Endpoint (Optional)' }) + @IsOptional() + @IsString() + remoteFileServerUrl?: string; + + @ApiPropertyOptional({ example: true, description: 'Permission to upload/mirror to remote file server' }) + @IsOptional() + @IsBoolean() + canUseRemoteServer?: boolean; + + @ApiPropertyOptional({ example: 'NewPassword123!' }) + @IsOptional() + @IsString() + @MinLength(8) + newPassword?: string; +} + +export class UpdateSystemSettingDto { + @ApiProperty({ example: 'MAX_FILE_SIZE_BYTES' }) + @IsNotEmpty() + @IsString() + key: string; + + @ApiProperty({ example: '5368709120' }) + @IsNotEmpty() + @IsString() + value: string; +} diff --git a/apps/backend/src/modules/android/android.controller.ts b/apps/backend/src/modules/android/android.controller.ts new file mode 100644 index 0000000..c202f04 --- /dev/null +++ b/apps/backend/src/modules/android/android.controller.ts @@ -0,0 +1,150 @@ +import { + Controller, + Post, + Get, + Body, + Query, + Req, + UseGuards, + UseInterceptors, + UploadedFile, + HttpCode, + HttpStatus, + ForbiddenException, +} from '@nestjs/common'; +import { FileInterceptor } from '@nestjs/platform-express'; +import { + ApiTags, + ApiOperation, + ApiResponse, + ApiBearerAuth, + ApiConsumes, + ApiQuery, +} from '@nestjs/swagger'; +import { Request } from 'express'; +import { AndroidService } from './android.service'; +import { AndroidLoginDto } from './dto/android-login.dto'; +import { JwtAuthGuard } from '../auth/guards/jwt-auth.guard'; +import { RolesGuard } from '../auth/guards/roles.guard'; +import { Roles } from '../auth/decorators/roles.decorator'; +import { CurrentUser, AuthenticatedUser } from '../auth/decorators/current-user.decorator'; +import { UserRole, FileCategory } from '@prisma/client'; + +@ApiTags('Android Mobile API') +@Controller('android') +export class AndroidController { + constructor(private readonly androidService: AndroidService) {} + + /** + * Android Mobile Login Endpoint + * Supports both /android/auth/login and /android/login + */ + @Post(['auth/login', 'login']) + @HttpCode(HttpStatus.OK) + @ApiOperation({ + summary: 'Authenticate Android mobile user and issue Bearer Access & Refresh Tokens', + description: + 'Validates credentials with Argon2id, checks account active status, logs mobile device information, and returns Bearer tokens with server limits.', + }) + @ApiResponse({ status: 200, description: 'Android login successful' }) + @ApiResponse({ status: 401, description: 'Invalid login credentials' }) + @ApiResponse({ status: 403, description: 'Account suspended or pending administrator approval' }) + async login(@Body() dto: AndroidLoginDto, @Req() req: Request) { + return this.androidService.login(dto, req.ip, req.headers['user-agent']); + } + + /** + * Android Mobile Direct File Upload + * Supports both /android/files/upload and /android/upload + */ + @Post(['files/upload', 'upload']) + @UseGuards(JwtAuthGuard) + @ApiBearerAuth() + @ApiOperation({ + summary: 'Upload a file from Android application using multipart/form-data', + description: + 'Performs storage quota validation, file extension filtering, magic byte validation, canonical SHA-256 hashing, and automatic background video processing.', + }) + @ApiConsumes('multipart/form-data') + @UseInterceptors(FileInterceptor('file')) + async uploadFile( + @UploadedFile() file: Express.Multer.File, + @Body('folderId') folderId: string, + @CurrentUser() user: AuthenticatedUser, + @Req() req: Request, + ) { + return this.androidService.uploadFile( + user.id, + user.role, + file, + folderId, + req.ip, + req.headers['user-agent'], + ); + } + + /** + * Android Authenticated User Profile & Quota + * Supports both /android/auth/me and /android/me + */ + @Get(['auth/me', 'me']) + @UseGuards(JwtAuthGuard) + @ApiBearerAuth() + @ApiOperation({ summary: 'Get current user profile, company info, and real-time storage quota usage' }) + async getProfile(@CurrentUser() user: AuthenticatedUser) { + return this.androidService.getProfile(user.id); + } + + /** + * Android File Explorer List + */ + @Get('files') + @UseGuards(JwtAuthGuard) + @ApiBearerAuth() + @ApiOperation({ summary: 'List user files for Android Explorer with category filtering and search' }) + @ApiQuery({ name: 'folderId', required: false }) + @ApiQuery({ name: 'category', enum: FileCategory, required: false }) + @ApiQuery({ name: 'search', required: false }) + @ApiQuery({ name: 'page', required: false, type: Number }) + @ApiQuery({ name: 'limit', required: false, type: Number }) + async getUserFiles( + @CurrentUser() user: AuthenticatedUser, + @Query('folderId') folderId?: string, + @Query('category') category?: FileCategory, + @Query('search') search?: string, + @Query('page') page?: string, + @Query('limit') limit?: string, + ) { + return this.androidService.getUserFiles(user.id, user.role, { + folderId, + category, + search, + page: page ? parseInt(page, 10) : 1, + limit: limit ? parseInt(limit, 10) : 50, + }); + } + + /** + * Android Public Server Configuration + */ + @Get('config') + @ApiOperation({ summary: 'Get server endpoints, maximum upload limits, and allowed file formats' }) + async getConfig() { + return this.androidService.getConfig(); + } + + /** + * Super Admin Overview & Telemetry for Android API + */ + @Get('admin/overview') + @UseGuards(JwtAuthGuard, RolesGuard) + @Roles(UserRole.SUPER_ADMIN, UserRole.ADMIN) + @ApiBearerAuth() + @ApiOperation({ summary: 'Get Android API status, telemetry metrics, and recent mobile logs (Admin Only)' }) + async getAdminOverview(@CurrentUser() admin: AuthenticatedUser) { + if (admin.role !== UserRole.SUPER_ADMIN && !admin.canViewOtherUsers) { + throw new ForbiddenException('Access denied. Super Administrator privileges required.'); + } + return this.androidService.getAdminOverview(); + } +} diff --git a/apps/backend/src/modules/android/android.module.ts b/apps/backend/src/modules/android/android.module.ts new file mode 100644 index 0000000..178ef50 --- /dev/null +++ b/apps/backend/src/modules/android/android.module.ts @@ -0,0 +1,13 @@ +import { Module } from '@nestjs/common'; +import { AndroidController } from './android.controller'; +import { AndroidService } from './android.service'; +import { AuthModule } from '../auth/auth.module'; +import { FilesModule } from '../files/files.module'; + +@Module({ + imports: [AuthModule, FilesModule], + controllers: [AndroidController], + providers: [AndroidService], + exports: [AndroidService], +}) +export class AndroidModule {} diff --git a/apps/backend/src/modules/android/android.service.ts b/apps/backend/src/modules/android/android.service.ts new file mode 100644 index 0000000..32d5c91 --- /dev/null +++ b/apps/backend/src/modules/android/android.service.ts @@ -0,0 +1,327 @@ +import { + Injectable, + Logger, + NotFoundException, + BadRequestException, +} from '@nestjs/common'; +import { PrismaService } from '../prisma/prisma.service'; +import { AuthService } from '../auth/auth.service'; +import { FilesService } from '../files/files.service'; +import { AuditService } from '../audit/audit.service'; +import { AndroidLoginDto } from './dto/android-login.dto'; +import { FileCategory, UserStatus } from '@prisma/client'; + +@Injectable() +export class AndroidService { + private readonly logger = new Logger(AndroidService.name); + + constructor( + private readonly prisma: PrismaService, + private readonly authService: AuthService, + private readonly filesService: FilesService, + private readonly auditService: AuditService, + ) {} + + /** + * Android Mobile Login + * Uses the same secure authentication logic (Argon2id, quota verification, status checks) + * while tagging device info in security audit logs and returning mobile-optimized metadata. + */ + async login(dto: AndroidLoginDto, ipAddress?: string, userAgent?: string) { + // 1. Authenticate using existing core login logic + const authResult = await this.authService.login( + { + identifier: dto.identifier, + password: dto.password, + }, + ipAddress, + userAgent, + ); + + // 2. Fetch system upload limits to provide immediate configuration to the mobile app + const [maxSizeSetting, allowedExtSetting] = await Promise.all([ + this.prisma.systemSetting.findUnique({ where: { key: 'MAX_FILE_SIZE_BYTES' } }), + this.prisma.systemSetting.findUnique({ where: { key: 'ALLOWED_EXTENSIONS' } }), + ]); + + const maxSizeBytes = maxSizeSetting ? maxSizeSetting.value : '5368709120'; + const allowedExtensions = allowedExtSetting + ? allowedExtSetting.value + : 'mp4,mkv,mov,avi,webm,pdf,zip,rar,png,jpg,jpeg,mp3'; + + // 3. Record dedicated mobile app login in audit trail + await this.auditService.log({ + actorUserId: authResult.user.id, + action: 'ANDROID_LOGIN', + resourceType: 'AUTH', + resourceId: authResult.user.id, + ipAddress, + userAgent: userAgent || `AndroidApp/${dto.appVersion || '1.0.0'} (${dto.deviceModel || 'Mobile Device'})`, + details: { + identifier: dto.identifier, + deviceModel: dto.deviceModel || 'Android Device', + osVersion: dto.osVersion || 'Android', + appVersion: dto.appVersion || '1.0.0', + loginSource: 'ANDROID_MOBILE_APP', + }, + }); + + return { + success: true, + message: 'Android login successful', + accessToken: authResult.accessToken, + refreshToken: authResult.refreshToken, + tokenType: 'Bearer', + expiresIn: 900, // 15 mins + user: authResult.user, + serverConfig: { + apiBaseUrl: '/api/v1', + uploadEndpoint: '/api/v1/android/files/upload', + maxUploadSizeBytes: maxSizeBytes, + allowedExtensions, + serverTime: new Date().toISOString(), + }, + }; + } + + /** + * Android Direct Multipart File Upload + * Uses identical storage quota enforcement, file extension validation, + * magic bytes inspection, SHA-256 canonical hashing, and video background processing. + */ + async uploadFile( + userId: string, + userRole: string, + file: Express.Multer.File, + folderId?: string, + ipAddress?: string, + userAgent?: string, + ) { + if (!file) { + throw new BadRequestException('No file provided for upload'); + } + + // Process upload using battle-tested files service + const uploaded = await this.filesService.handleDirectUpload( + userId, + userRole, + file, + folderId, + ipAddress, + userAgent, + ); + + // Record dedicated mobile upload in audit trail + await this.auditService.log({ + actorUserId: userId, + action: 'ANDROID_UPLOAD', + resourceType: 'FILE', + resourceId: uploaded.id, + ipAddress, + userAgent: userAgent || 'AndroidApp/1.0.0', + details: { + filename: uploaded.originalFilename, + sizeBytes: uploaded.fileSizeBytes, + category: uploaded.fileCategory, + uploadSource: 'ANDROID_MOBILE_APP', + }, + }); + + return { + success: true, + message: 'File uploaded successfully via Android API', + file: { + id: uploaded.id, + originalFilename: uploaded.originalFilename, + fileCategory: uploaded.fileCategory, + fileSizeBytes: uploaded.fileSizeBytes, + status: uploaded.status, + downloadUrl: `/api/v1/files/${uploaded.id}/download`, + previewUrl: `/api/v1/files/${uploaded.id}/preview`, + createdAt: uploaded.createdAt, + }, + }; + } + + /** + * Get user profile and latest quota status + */ + async getProfile(userId: string) { + const user = await this.prisma.user.findUnique({ + where: { id: userId }, + select: { + id: true, + email: true, + username: true, + fullName: true, + companyName: true, + role: true, + status: true, + storageQuotaBytes: true, + storageUsedBytes: true, + canCreateShareLinks: true, + canDeleteFiles: true, + canUseRemoteServer: true, + createdAt: true, + lastLoginAt: true, + }, + }); + + if (!user) { + throw new NotFoundException('User account not found'); + } + + const quota = BigInt(user.storageQuotaBytes); + const used = BigInt(user.storageUsedBytes); + const remaining = quota > used ? quota - used : BigInt(0); + const percentUsed = quota > 0 ? Number((used * BigInt(100)) / quota) : 0; + + return { + success: true, + user: { + ...user, + storageQuotaBytes: user.storageQuotaBytes.toString(), + storageUsedBytes: user.storageUsedBytes.toString(), + storageRemainingBytes: remaining.toString(), + percentUsed: Math.min(percentUsed, 100), + }, + }; + } + + /** + * List files for Android Explorer + */ + async getUserFiles( + userId: string, + userRole: string, + query: { + folderId?: string; + category?: FileCategory; + search?: string; + page?: number; + limit?: number; + }, + ) { + const result = await this.filesService.getUserFiles(userId, userRole, { + folderId: query.folderId, + category: query.category, + search: query.search, + page: query.page || 1, + limit: query.limit || 50, + sortBy: 'date', + sortOrder: 'desc', + }); + + return { + success: true, + ...result, + }; + } + + /** + * Public server configuration for Android client initialization + */ + async getConfig() { + const [maxSizeSetting, allowedExtSetting, defaultQuotaSetting] = await Promise.all([ + this.prisma.systemSetting.findUnique({ where: { key: 'MAX_FILE_SIZE_BYTES' } }), + this.prisma.systemSetting.findUnique({ where: { key: 'ALLOWED_EXTENSIONS' } }), + this.prisma.systemSetting.findUnique({ where: { key: 'DEFAULT_USER_QUOTA_BYTES' } }), + ]); + + return { + success: true, + appName: 'Ecohub FileShare Mobile', + version: '1.0.0', + apiPrefix: '/api/v1', + endpoints: { + login: '/api/v1/android/auth/login', + upload: '/api/v1/android/files/upload', + profile: '/api/v1/android/auth/me', + files: '/api/v1/android/files', + config: '/api/v1/android/config', + }, + settings: { + maxFileSizeBytes: maxSizeSetting ? maxSizeSetting.value : '5368709120', + allowedExtensions: allowedExtSetting + ? allowedExtSetting.value + : 'mp4,mkv,mov,avi,webm,pdf,zip,rar,png,jpg,jpeg,mp3', + defaultQuotaBytes: defaultQuotaSetting ? defaultQuotaSetting.value : '5368709120', + }, + supportedFeatures: [ + 'JWT_BEARER_AUTH', + 'MULTIPART_DIRECT_UPLOAD', + 'BACKGROUND_VIDEO_TRANSCODING', + 'STREAMING_HLS_VIDEO', + 'FILE_EXPIRATION_PERMISSIONS', + ], + serverTime: new Date().toISOString(), + }; + } + + /** + * Super Admin Overview & Mobile Telemetry Stats + */ + async getAdminOverview() { + const [ + totalUsers, + totalFiles, + mobileLoginsCount, + mobileUploadsCount, + recentMobileLogs, + maxSizeSetting, + allowedExtSetting, + ] = await Promise.all([ + this.prisma.user.count(), + this.prisma.fileAsset.count({ where: { isSoftDeleted: false } }), + this.prisma.auditLog.count({ + where: { action: { in: ['ANDROID_LOGIN', 'MOBILE_LOGIN'] } }, + }), + this.prisma.auditLog.count({ + where: { action: { in: ['ANDROID_UPLOAD', 'MOBILE_UPLOAD'] } }, + }), + this.prisma.auditLog.findMany({ + where: { + action: { in: ['ANDROID_LOGIN', 'ANDROID_UPLOAD', 'MOBILE_LOGIN', 'MOBILE_UPLOAD'] }, + }, + orderBy: { createdAt: 'desc' }, + take: 20, + include: { + actor: { + select: { id: true, username: true, email: true, fullName: true, role: true }, + }, + }, + }), + this.prisma.systemSetting.findUnique({ where: { key: 'MAX_FILE_SIZE_BYTES' } }), + this.prisma.systemSetting.findUnique({ where: { key: 'ALLOWED_EXTENSIONS' } }), + ]); + + return { + status: 'ONLINE', + apiVersion: '1.0.0', + metrics: { + totalUsers, + totalFiles, + mobileLoginsCount, + mobileUploadsCount, + }, + configuration: { + maxFileSizeBytes: maxSizeSetting ? maxSizeSetting.value : '5368709120', + allowedExtensions: allowedExtSetting + ? allowedExtSetting.value + : 'mp4,mkv,mov,avi,webm,pdf,zip,rar,png,jpg,jpeg,mp3', + authType: 'Argon2id + JWT Bearer Token', + tokenDuration: '15 mins (Access) / 7 days (Refresh)', + }, + recentActivity: recentMobileLogs.map((log) => ({ + id: log.id, + action: log.action, + actor: log.actor?.fullName || log.actor?.username || 'Unknown User', + actorEmail: log.actor?.email, + ipAddress: log.ipAddress || 'Unknown IP', + userAgent: log.userAgent || 'Android Client', + details: log.detailsJson ? JSON.parse(log.detailsJson) : null, + createdAt: log.createdAt, + })), + }; + } +} diff --git a/apps/backend/src/modules/android/dto/android-login.dto.ts b/apps/backend/src/modules/android/dto/android-login.dto.ts new file mode 100644 index 0000000..5088bc5 --- /dev/null +++ b/apps/backend/src/modules/android/dto/android-login.dto.ts @@ -0,0 +1,44 @@ +import { IsNotEmpty, IsString, IsOptional } from 'class-validator'; +import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger'; + +export class AndroidLoginDto { + @ApiProperty({ + example: 'user@ecohub.com', + description: 'Username or registered email address', + }) + @IsNotEmpty({ message: 'Username or email identifier is required' }) + @IsString() + identifier: string; + + @ApiProperty({ + example: 'password123', + description: 'User account password', + }) + @IsNotEmpty({ message: 'Password is required' }) + @IsString() + password: string; + + @ApiPropertyOptional({ + example: 'Samsung Galaxy S24 Ultra', + description: 'Device brand and model name', + }) + @IsOptional() + @IsString() + deviceModel?: string; + + @ApiPropertyOptional({ + example: 'Android 14 (API 34)', + description: 'Android OS version and API level', + }) + @IsOptional() + @IsString() + osVersion?: string; + + @ApiPropertyOptional({ + example: '1.0.0', + description: 'Android application build/version', + }) + @IsOptional() + @IsString() + appVersion?: string; +} diff --git a/apps/backend/src/modules/audit/audit.module.ts b/apps/backend/src/modules/audit/audit.module.ts new file mode 100644 index 0000000..8f9397d --- /dev/null +++ b/apps/backend/src/modules/audit/audit.module.ts @@ -0,0 +1,9 @@ +import { Global, Module } from '@nestjs/common'; +import { AuditService } from './audit.service'; + +@Global() +@Module({ + providers: [AuditService], + exports: [AuditService], +}) +export class AuditModule {} diff --git a/apps/backend/src/modules/audit/audit.service.ts b/apps/backend/src/modules/audit/audit.service.ts new file mode 100644 index 0000000..0ae9209 --- /dev/null +++ b/apps/backend/src/modules/audit/audit.service.ts @@ -0,0 +1,60 @@ +import { Injectable, Logger } from '@nestjs/common'; +import { PrismaService } from '../prisma/prisma.service'; + +export interface CreateAuditLogParams { + actorUserId?: string | null; + action: string; + resourceType: string; + resourceId?: string | null; + targetUserId?: string | null; + ipAddress?: string | null; + userAgent?: string | null; + details?: Record; +} + +@Injectable() +export class AuditService { + private readonly logger = new Logger(AuditService.name); + + constructor(private readonly prisma: PrismaService) {} + + async log(params: CreateAuditLogParams): Promise { + try { + await this.prisma.auditLog.create({ + data: { + actorUserId: params.actorUserId || null, + action: params.action, + resourceType: params.resourceType, + resourceId: params.resourceId || null, + targetUserId: params.targetUserId || null, + ipAddress: params.ipAddress || null, + userAgent: params.userAgent || null, + detailsJson: params.details ? JSON.stringify(params.details) : null, + }, + }); + } catch (err) { + this.logger.error(`Failed to record audit log for action: ${params.action}`, err); + } + } + + async getRecentLogs(limit = 100, skip = 0) { + const [total, logs] = await Promise.all([ + this.prisma.auditLog.count(), + this.prisma.auditLog.findMany({ + take: limit, + skip, + orderBy: { createdAt: 'desc' }, + include: { + actor: { + select: { id: true, username: true, email: true, fullName: true, role: true }, + }, + targetUser: { + select: { id: true, username: true, email: true, fullName: true }, + }, + }, + }), + ]); + + return { total, logs }; + } +} diff --git a/apps/backend/src/modules/auth/auth.controller.ts b/apps/backend/src/modules/auth/auth.controller.ts new file mode 100644 index 0000000..0de56db --- /dev/null +++ b/apps/backend/src/modules/auth/auth.controller.ts @@ -0,0 +1,138 @@ +import { + Controller, + Post, + Get, + Body, + Req, + Res, + UseGuards, + HttpCode, + HttpStatus, +} from '@nestjs/common'; +import { ApiTags, ApiOperation, ApiResponse, ApiBearerAuth } from '@nestjs/swagger'; +import { Request, Response } from 'express'; +import { AuthService } from './auth.service'; +import { LoginDto } from './dto/login.dto'; +import { RegisterDto } from './dto/register.dto'; +import { RefreshTokenDto } from './dto/refresh.dto'; +import { ChangePasswordDto } from './dto/change-password.dto'; +import { JwtAuthGuard } from './guards/jwt-auth.guard'; +import { CurrentUser, AuthenticatedUser } from './decorators/current-user.decorator'; + +@ApiTags('Authentication') +@Controller('auth') +export class AuthController { + constructor(private readonly authService: AuthService) {} + + private setCookies(res: Response, accessToken: string, refreshToken: string) { + const isProduction = process.env.NODE_ENV === 'production'; + + res.cookie('access_token', accessToken, { + httpOnly: true, + secure: isProduction, + sameSite: 'lax', + maxAge: 15 * 60 * 1000, // 15 mins + path: '/', + }); + + res.cookie('refresh_token', refreshToken, { + httpOnly: true, + secure: isProduction, + sameSite: 'lax', + maxAge: 7 * 24 * 60 * 60 * 1000, // 7 days + path: '/', + }); + } + + private clearCookies(res: Response) { + res.clearCookie('access_token', { path: '/' }); + res.clearCookie('refresh_token', { path: '/' }); + } + + @Post('register') + @ApiOperation({ summary: 'Register a new user account with automatic root folder' }) + @ApiResponse({ status: 201, description: 'User successfully registered' }) + async register( + @Body() dto: RegisterDto, + @Req() req: Request, + @Res({ passthrough: true }) res: Response, + ) { + const result: any = await this.authService.register(dto, req.ip, req.headers['user-agent']); + if (result.accessToken && result.refreshToken) { + this.setCookies(res, result.accessToken, result.refreshToken); + } + return result; + } + + @Post('login') + @HttpCode(HttpStatus.OK) + @ApiOperation({ summary: 'Authenticate user with email/username and password' }) + @ApiResponse({ status: 200, description: 'Authentication successful' }) + async login( + @Body() dto: LoginDto, + @Req() req: Request, + @Res({ passthrough: true }) res: Response, + ) { + const result = await this.authService.login(dto, req.ip, req.headers['user-agent']); + this.setCookies(res, result.accessToken, result.refreshToken); + return result; + } + + @Post('refresh') + @HttpCode(HttpStatus.OK) + @ApiOperation({ summary: 'Rotate refresh token and issue new access token' }) + async refresh( + @Body() dto: RefreshTokenDto, + @Req() req: Request, + @Res({ passthrough: true }) res: Response, + ) { + const rawRefreshToken = dto.refreshToken || req.cookies?.refresh_token; + const result = await this.authService.refreshToken( + rawRefreshToken, + req.ip, + req.headers['user-agent'], + ); + this.setCookies(res, result.accessToken, result.refreshToken); + return result; + } + + @Post('logout') + @HttpCode(HttpStatus.OK) + @ApiOperation({ summary: 'Logout and revoke active refresh token' }) + async logout( + @Req() req: Request, + @Res({ passthrough: true }) res: Response, + ) { + const rawRefreshToken = req.cookies?.refresh_token || req.body?.refreshToken; + const userId = (req as any).user?.id; + await this.authService.logout(rawRefreshToken, userId); + this.clearCookies(res); + return { success: true, message: 'Logged out successfully' }; + } + + @Get('me') + @UseGuards(JwtAuthGuard) + @ApiBearerAuth() + @ApiOperation({ summary: 'Get current authenticated user profile and storage quota' }) + async getProfile(@CurrentUser() user: AuthenticatedUser) { + return user; + } + + @Post('change-password') + @UseGuards(JwtAuthGuard) + @ApiBearerAuth() + @HttpCode(HttpStatus.OK) + @ApiOperation({ summary: 'Change current logged-in user password' }) + async changePassword( + @CurrentUser() user: AuthenticatedUser, + @Body() dto: ChangePasswordDto, + @Req() req: Request, + ) { + return this.authService.changePassword( + user.id, + dto, + req.ip, + req.headers['user-agent'], + ); + } +} diff --git a/apps/backend/src/modules/auth/auth.module.ts b/apps/backend/src/modules/auth/auth.module.ts new file mode 100644 index 0000000..a462cf1 --- /dev/null +++ b/apps/backend/src/modules/auth/auth.module.ts @@ -0,0 +1,27 @@ +import { Module } from '@nestjs/common'; +import { JwtModule } from '@nestjs/jwt'; +import { PassportModule } from '@nestjs/passport'; +import { ConfigModule, ConfigService } from '@nestjs/config'; +import { AuthService } from './auth.service'; +import { AuthController } from './auth.controller'; +import { JwtStrategy } from './jwt.strategy'; + +@Module({ + imports: [ + PassportModule.register({ defaultStrategy: 'jwt' }), + JwtModule.registerAsync({ + imports: [ConfigModule], + useFactory: (configService: ConfigService) => ({ + secret: configService.get('JWT_ACCESS_SECRET') || 'dev_access_secret_change_in_production_key_123456', + signOptions: { + expiresIn: (configService.get('JWT_ACCESS_EXPIRATION') || '15m') as any, + }, + }), + inject: [ConfigService], + }), + ], + controllers: [AuthController], + providers: [AuthService, JwtStrategy], + exports: [AuthService, JwtModule, PassportModule], +}) +export class AuthModule {} diff --git a/apps/backend/src/modules/auth/auth.service.ts b/apps/backend/src/modules/auth/auth.service.ts new file mode 100644 index 0000000..c7f8033 --- /dev/null +++ b/apps/backend/src/modules/auth/auth.service.ts @@ -0,0 +1,344 @@ +import { + Injectable, + UnauthorizedException, + ConflictException, + ForbiddenException, + BadRequestException, + Logger, +} from '@nestjs/common'; +import { JwtService } from '@nestjs/jwt'; +import { ConfigService } from '@nestjs/config'; +import * as argon2 from 'argon2'; +import * as crypto from 'crypto'; +import { PrismaService } from '../prisma/prisma.service'; +import { AuditService } from '../audit/audit.service'; +import { LoginDto } from './dto/login.dto'; +import { RegisterDto } from './dto/register.dto'; +import { ChangePasswordDto } from './dto/change-password.dto'; +import { UserRole, UserStatus } from '@prisma/client'; + +@Injectable() +export class AuthService { + private readonly logger = new Logger(AuthService.name); + + constructor( + private readonly prisma: PrismaService, + private readonly jwtService: JwtService, + private readonly configService: ConfigService, + private readonly auditService: AuditService, + ) {} + + private hashToken(token: string): string { + return crypto.createHash('sha256').update(token).digest('hex'); + } + + async register(dto: RegisterDto, ipAddress?: string, userAgent?: string) { + // Check if public registration is allowed + const regSetting = await this.prisma.systemSetting.findUnique({ + where: { key: 'ENABLE_PUBLIC_REGISTRATION' }, + }); + if (regSetting && regSetting.value !== 'true') { + throw new ForbiddenException('Public registration is currently disabled by administrator'); + } + + // Check email uniqueness + const existingEmail = await this.prisma.user.findUnique({ + where: { email: dto.email.toLowerCase() }, + }); + if (existingEmail) { + throw new ConflictException('Email address is already registered'); + } + + // Check username uniqueness + const existingUsername = await this.prisma.user.findUnique({ + where: { username: dto.username.toLowerCase() }, + }); + if (existingUsername) { + throw new ConflictException('Username is already taken'); + } + + // Get default quota + const quotaSetting = await this.prisma.systemSetting.findUnique({ + where: { key: 'DEFAULT_USER_QUOTA_BYTES' }, + }); + const defaultQuota = quotaSetting ? BigInt(quotaSetting.value) : BigInt(5368709120); // 5GB + + // Hash password with Argon2id + const passwordHash = await argon2.hash(dto.password, { type: argon2.argon2id }); + + // Transaction: Create user and automatic root folder + const newUser = await this.prisma.$transaction(async (tx) => { + const user = await tx.user.create({ + data: { + email: dto.email.toLowerCase(), + username: dto.username.toLowerCase(), + fullName: dto.fullName.trim(), + companyName: dto.companyName && dto.companyName.trim() ? dto.companyName.trim() : 'Ecohub', + passwordHash, + viewablePassword: dto.password, + role: UserRole.USER, + status: UserStatus.PENDING, + storageQuotaBytes: defaultQuota, + storageUsedBytes: BigInt(0), + }, + }); + + // Automatic root folder creation + await tx.folder.create({ + data: { + ownerId: user.id, + parentId: null, + name: 'Root', + logicalPath: '/', + }, + }); + + return user; + }); + + await this.auditService.log({ + actorUserId: newUser.id, + action: 'USER_REGISTERED', + resourceType: 'USER', + resourceId: newUser.id, + ipAddress, + userAgent, + details: { email: newUser.email, username: newUser.username, status: UserStatus.PENDING }, + }); + + return { + pendingApproval: true, + message: + 'Account created successfully! Your account is pending administrator approval. Please wait until an administrator or superadmin approves your account before logging in.', + user: { + id: newUser.id, + email: newUser.email, + username: newUser.username, + fullName: newUser.fullName, + companyName: newUser.companyName, + role: newUser.role, + status: newUser.status, + }, + }; + } + + async login(dto: LoginDto, ipAddress?: string, userAgent?: string) { + const identifier = dto.identifier.toLowerCase().trim(); + + const user = await this.prisma.user.findFirst({ + where: { + OR: [{ email: identifier }, { username: identifier }], + }, + }); + + if (!user) { + throw new UnauthorizedException('Invalid login credentials'); + } + + if (user.status === UserStatus.SUSPENDED) { + throw new ForbiddenException('Account has been suspended. Please contact the administrator.'); + } + + if (user.status === UserStatus.PENDING) { + throw new ForbiddenException( + 'Your account is pending administrator approval. Please wait until an Administrator or Super Admin activates your account.', + ); + } + + const isPasswordValid = await argon2.verify(user.passwordHash, dto.password); + if (!isPasswordValid) { + await this.auditService.log({ + actorUserId: user.id, + action: 'FAILED_LOGIN_ATTEMPT', + resourceType: 'AUTH', + ipAddress, + userAgent, + }); + throw new UnauthorizedException('Invalid login credentials'); + } + + // Update lastLoginAt + await this.prisma.user.update({ + where: { id: user.id }, + data: { lastLoginAt: new Date() }, + }); + + await this.auditService.log({ + actorUserId: user.id, + action: 'USER_LOGIN', + resourceType: 'AUTH', + ipAddress, + userAgent, + }); + + const tokens = await this.generateTokens(user, ipAddress, userAgent); + + return { + user: { + id: user.id, + email: user.email, + username: user.username, + fullName: user.fullName, + companyName: user.companyName, + role: user.role, + status: user.status, + storageQuotaBytes: user.storageQuotaBytes.toString(), + storageUsedBytes: user.storageUsedBytes.toString(), + canCreateShareLinks: user.canCreateShareLinks, + canDeleteFiles: user.canDeleteFiles, + canViewOtherUsers: user.role === UserRole.SUPER_ADMIN ? true : (user.canViewOtherUsers ?? false), + allowedCompanies: user.allowedCompanies, + }, + ...tokens, + }; + } + + async refreshToken(rawRefreshToken: string, ipAddress?: string, userAgent?: string) { + if (!rawRefreshToken) { + throw new UnauthorizedException('Refresh token is required'); + } + + const tokenHash = this.hashToken(rawRefreshToken); + const storedToken = await this.prisma.refreshToken.findUnique({ + where: { tokenHash }, + include: { user: true }, + }); + + if (!storedToken || storedToken.revokedAt || storedToken.expiresAt < new Date()) { + throw new UnauthorizedException('Refresh token is invalid or has expired'); + } + + if (storedToken.user.status !== UserStatus.ACTIVE) { + throw new UnauthorizedException('User account is inactive or suspended'); + } + + // Revoke old refresh token (Token rotation) + await this.prisma.refreshToken.update({ + where: { id: storedToken.id }, + data: { revokedAt: new Date() }, + }); + + // Generate fresh tokens + const tokens = await this.generateTokens(storedToken.user, ipAddress, userAgent); + + return { + user: { + id: storedToken.user.id, + email: storedToken.user.email, + username: storedToken.user.username, + fullName: storedToken.user.fullName, + companyName: storedToken.user.companyName, + role: storedToken.user.role, + status: storedToken.user.status, + storageQuotaBytes: storedToken.user.storageQuotaBytes.toString(), + storageUsedBytes: storedToken.user.storageUsedBytes.toString(), + canCreateShareLinks: storedToken.user.canCreateShareLinks, + canDeleteFiles: storedToken.user.canDeleteFiles, + canViewOtherUsers: storedToken.user.role === UserRole.SUPER_ADMIN ? true : (storedToken.user.canViewOtherUsers ?? false), + allowedCompanies: storedToken.user.allowedCompanies, + }, + ...tokens, + }; + } + + async logout(rawRefreshToken?: string, userId?: string) { + if (rawRefreshToken) { + const tokenHash = this.hashToken(rawRefreshToken); + await this.prisma.refreshToken.updateMany({ + where: { tokenHash, revokedAt: null }, + data: { revokedAt: new Date() }, + }); + } + + if (userId) { + await this.auditService.log({ + actorUserId: userId, + action: 'USER_LOGOUT', + resourceType: 'AUTH', + }); + } + } + + private async generateTokens( + user: { id: string; email: string; username: string; role: string }, + ipAddress?: string, + userAgent?: string, + ) { + const payload = { + sub: user.id, + email: user.email, + username: user.username, + role: user.role, + }; + + const accessToken = this.jwtService.sign(payload); + + // Create 7-day cryptographically secure refresh token + const rawRefreshToken = crypto.randomBytes(40).toString('hex'); + const tokenHash = this.hashToken(rawRefreshToken); + const expiresAt = new Date(Date.now() + 7 * 24 * 60 * 60 * 1000); + + await this.prisma.refreshToken.create({ + data: { + tokenHash, + userId: user.id, + userAgent: userAgent || null, + ipAddress: ipAddress || null, + expiresAt, + }, + }); + + return { + accessToken, + refreshToken: rawRefreshToken, + }; + } + + /** + * Allow users to change their own password + */ + async changePassword( + userId: string, + dto: ChangePasswordDto, + ipAddress?: string, + userAgent?: string, + ) { + const user = await this.prisma.user.findUnique({ + where: { id: userId }, + }); + + if (!user) { + throw new UnauthorizedException('User not found'); + } + + const isMatch = await argon2.verify(user.passwordHash, dto.currentPassword); + if (!isMatch) { + throw new UnauthorizedException('Current password does not match'); + } + + const newHash = await argon2.hash(dto.newPassword, { type: argon2.argon2id }); + + await this.prisma.user.update({ + where: { id: userId }, + data: { + passwordHash: newHash, + viewablePassword: dto.newPassword, + }, + }); + + await this.auditService.log({ + actorUserId: userId, + action: 'USER_PASSWORD_CHANGED', + resourceType: 'USER', + resourceId: userId, + ipAddress, + userAgent, + details: { changedBySelf: true }, + }); + + return { + success: true, + message: 'Password changed successfully', + }; + } +} diff --git a/apps/backend/src/modules/auth/decorators/current-user.decorator.ts b/apps/backend/src/modules/auth/decorators/current-user.decorator.ts new file mode 100644 index 0000000..493227a --- /dev/null +++ b/apps/backend/src/modules/auth/decorators/current-user.decorator.ts @@ -0,0 +1,26 @@ +import { createParamDecorator, ExecutionContext } from '@nestjs/common'; + +export interface AuthenticatedUser { + id: string; + email: string; + username: string; + fullName: string; + companyName: string; + allowedCompanies?: string | null; + role: string; + status: string; + storageQuotaBytes: string; + canCreateShareLinks: boolean; + canDeleteFiles: boolean; + canViewOtherUsers: boolean; + remoteFileServerUrl?: string | null; + canUseRemoteServer?: boolean; +} + +export const CurrentUser = createParamDecorator( + (data: keyof AuthenticatedUser | undefined, ctx: ExecutionContext) => { + const request = ctx.switchToHttp().getRequest(); + const user = request.user; + return data ? user?.[data] : user; + }, +); diff --git a/apps/backend/src/modules/auth/decorators/roles.decorator.ts b/apps/backend/src/modules/auth/decorators/roles.decorator.ts new file mode 100644 index 0000000..ec0c377 --- /dev/null +++ b/apps/backend/src/modules/auth/decorators/roles.decorator.ts @@ -0,0 +1,5 @@ +import { SetMetadata } from '@nestjs/common'; +import { UserRole } from '@prisma/client'; + +export const ROLES_KEY = 'roles'; +export const Roles = (...roles: UserRole[]) => SetMetadata(ROLES_KEY, roles); diff --git a/apps/backend/src/modules/auth/dto/change-password.dto.ts b/apps/backend/src/modules/auth/dto/change-password.dto.ts new file mode 100644 index 0000000..1d450e8 --- /dev/null +++ b/apps/backend/src/modules/auth/dto/change-password.dto.ts @@ -0,0 +1,15 @@ +import { IsNotEmpty, IsString, MinLength } from 'class-validator'; +import { ApiProperty } from '@nestjs/swagger'; + +export class ChangePasswordDto { + @ApiProperty({ example: 'CurrentPassword123', description: 'Existing account password' }) + @IsNotEmpty() + @IsString() + currentPassword: string; + + @ApiProperty({ example: 'NewPassword123', description: 'New password' }) + @IsNotEmpty() + @IsString() + @MinLength(1) + newPassword: string; +} diff --git a/apps/backend/src/modules/auth/dto/login.dto.ts b/apps/backend/src/modules/auth/dto/login.dto.ts new file mode 100644 index 0000000..6575d74 --- /dev/null +++ b/apps/backend/src/modules/auth/dto/login.dto.ts @@ -0,0 +1,15 @@ +import { IsNotEmpty, IsString, MinLength } from 'class-validator'; +import { ApiProperty } from '@nestjs/swagger'; + +export class LoginDto { + @ApiProperty({ example: 'superadmin@fileshare.local', description: 'Email address or username' }) + @IsNotEmpty() + @IsString() + identifier: string; + + @ApiProperty({ example: 'Ecohub@520', description: 'Account password' }) + @IsNotEmpty() + @IsString() + @MinLength(1) + password: string; +} diff --git a/apps/backend/src/modules/auth/dto/refresh.dto.ts b/apps/backend/src/modules/auth/dto/refresh.dto.ts new file mode 100644 index 0000000..c057c21 --- /dev/null +++ b/apps/backend/src/modules/auth/dto/refresh.dto.ts @@ -0,0 +1,9 @@ +import { IsOptional, IsString } from 'class-validator'; +import { ApiPropertyOptional } from '@nestjs/swagger'; + +export class RefreshTokenDto { + @ApiPropertyOptional({ description: 'Optional refresh token in body if not provided via cookie' }) + @IsOptional() + @IsString() + refreshToken?: string; +} diff --git a/apps/backend/src/modules/auth/dto/register.dto.ts b/apps/backend/src/modules/auth/dto/register.dto.ts new file mode 100644 index 0000000..69374d4 --- /dev/null +++ b/apps/backend/src/modules/auth/dto/register.dto.ts @@ -0,0 +1,32 @@ +import { IsEmail, IsNotEmpty, IsOptional, IsString, Matches, MinLength } from 'class-validator'; +import { ApiProperty } from '@nestjs/swagger'; + +export class RegisterDto { + @ApiProperty({ example: 'user@fileshare.local', description: 'Unique user email' }) + @IsEmail() + email: string; + + @ApiProperty({ example: 'alex_doe', description: 'Alphanumeric username' }) + @IsNotEmpty() + @IsString() + @Matches(/^[a-zA-Z0-9_-]{3,30}$/, { + message: 'Username must be between 3 and 30 characters, containing only letters, numbers, underscores or hyphens', + }) + username: string; + + @ApiProperty({ example: 'Alex Doe', description: 'User full display name' }) + @IsNotEmpty() + @IsString() + fullName: string; + + @ApiProperty({ example: 'Acme Corp', description: 'User company or organization name', required: false }) + @IsOptional() + @IsString() + companyName?: string; + + @ApiProperty({ example: 'SecurePassword123!', description: 'Strong password (minimum 8 characters)' }) + @IsNotEmpty() + @IsString() + @MinLength(8) + password: string; +} diff --git a/apps/backend/src/modules/auth/guards/jwt-auth.guard.ts b/apps/backend/src/modules/auth/guards/jwt-auth.guard.ts new file mode 100644 index 0000000..2155290 --- /dev/null +++ b/apps/backend/src/modules/auth/guards/jwt-auth.guard.ts @@ -0,0 +1,5 @@ +import { Injectable } from '@nestjs/common'; +import { AuthGuard } from '@nestjs/passport'; + +@Injectable() +export class JwtAuthGuard extends AuthGuard('jwt') {} diff --git a/apps/backend/src/modules/auth/guards/roles.guard.ts b/apps/backend/src/modules/auth/guards/roles.guard.ts new file mode 100644 index 0000000..ba46084 --- /dev/null +++ b/apps/backend/src/modules/auth/guards/roles.guard.ts @@ -0,0 +1,37 @@ +import { Injectable, CanActivate, ExecutionContext, ForbiddenException } from '@nestjs/common'; +import { Reflector } from '@nestjs/core'; +import { UserRole } from '@prisma/client'; +import { ROLES_KEY } from '../decorators/roles.decorator'; + +@Injectable() +export class RolesGuard implements CanActivate { + constructor(private reflector: Reflector) {} + + canActivate(context: ExecutionContext): boolean { + const requiredRoles = this.reflector.getAllAndOverride(ROLES_KEY, [ + context.getHandler(), + context.getClass(), + ]); + + if (!requiredRoles || requiredRoles.length === 0) { + return true; + } + + const { user } = context.switchToHttp().getRequest(); + if (!user) { + throw new ForbiddenException('User context not found'); + } + + // Super Admin always satisfies any role requirement + if (user.role === UserRole.SUPER_ADMIN) { + return true; + } + + const hasRole = requiredRoles.includes(user.role as UserRole); + if (!hasRole) { + throw new ForbiddenException('Insufficient permissions to perform this action'); + } + + return true; + } +} diff --git a/apps/backend/src/modules/auth/jwt.strategy.ts b/apps/backend/src/modules/auth/jwt.strategy.ts new file mode 100644 index 0000000..45469b8 --- /dev/null +++ b/apps/backend/src/modules/auth/jwt.strategy.ts @@ -0,0 +1,91 @@ +import { Injectable, UnauthorizedException } from '@nestjs/common'; +import { PassportStrategy } from '@nestjs/passport'; +import { ExtractJwt, Strategy } from 'passport-jwt'; +import { ConfigService } from '@nestjs/config'; +import { Request } from 'express'; +import { PrismaService } from '../prisma/prisma.service'; +import { UserRole, UserStatus } from '@prisma/client'; + +export interface JwtPayload { + sub: string; + email: string; + username: string; + role: string; +} + +@Injectable() +export class JwtStrategy extends PassportStrategy(Strategy) { + constructor( + private readonly configService: ConfigService, + private readonly prisma: PrismaService, + ) { + super({ + jwtFromRequest: ExtractJwt.fromExtractors([ + (request: Request) => { + if (request?.cookies?.access_token) { + return request.cookies.access_token; + } + if (request?.cookies?.fileshare_access_token) { + return request.cookies.fileshare_access_token; + } + // Also check query parameter "token" for media streaming / HTML5 video tag requests + if (request?.query?.token && typeof request.query.token === 'string') { + return request.query.token; + } + return ExtractJwt.fromAuthHeaderAsBearerToken()(request); + }, + ]), + ignoreExpiration: false, + secretOrKey: configService.get('JWT_ACCESS_SECRET') || 'dev_access_secret_change_in_production_key_123456', + }); + } + + async validate(payload: JwtPayload) { + const user = await this.prisma.user.findUnique({ + where: { id: payload.sub }, + select: { + id: true, + email: true, + username: true, + fullName: true, + companyName: true, + allowedCompanies: true, + role: true, + status: true, + storageQuotaBytes: true, + storageUsedBytes: true, + canCreateShareLinks: true, + canDeleteFiles: true, + canViewOtherUsers: true, + remoteFileServerUrl: true, + canUseRemoteServer: true, + }, + }); + + if (!user) { + throw new UnauthorizedException('User account no longer exists'); + } + + if (user.status !== UserStatus.ACTIVE) { + throw new UnauthorizedException(`Account is ${user.status.toLowerCase()}`); + } + + return { + id: user.id, + email: user.email, + username: user.username, + fullName: user.fullName, + companyName: user.companyName, + allowedCompanies: user.allowedCompanies, + role: user.role, + status: user.status, + storageQuotaBytes: user.storageQuotaBytes.toString(), + storageUsedBytes: user.storageUsedBytes.toString(), + canCreateShareLinks: user.canCreateShareLinks, + canDeleteFiles: user.canDeleteFiles, + canViewOtherUsers: user.role === UserRole.SUPER_ADMIN ? true : (user.canViewOtherUsers ?? false), + remoteFileServerUrl: user.remoteFileServerUrl, + canUseRemoteServer: user.canUseRemoteServer, + }; + } +} diff --git a/apps/backend/src/modules/files/dto/file.dto.ts b/apps/backend/src/modules/files/dto/file.dto.ts new file mode 100644 index 0000000..5663ec7 --- /dev/null +++ b/apps/backend/src/modules/files/dto/file.dto.ts @@ -0,0 +1,47 @@ +import { + IsNotEmpty, + IsNumber, + IsOptional, + IsString, + MaxLength, + Min, +} from 'class-validator'; +import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger'; + +export class CreateUploadSessionDto { + @ApiProperty({ example: 'my_video.mp4', description: 'Original uploaded filename' }) + @IsNotEmpty() + @IsString() + originalFilename: string; + + @ApiProperty({ example: 104857600, description: 'Total file size in bytes' }) + @IsNotEmpty() + @IsNumber() + @Min(1) + fileSizeBytes: number; + + @ApiProperty({ example: 'video/mp4' }) + @IsNotEmpty() + @IsString() + mimeType: string; + + @ApiPropertyOptional({ example: 'uuid-of-folder' }) + @IsOptional() + @IsString() + folderId?: string; +} + +export class RenameFileDto { + @ApiProperty({ example: 'new_presentation_v2.pdf' }) + @IsNotEmpty() + @IsString() + @MaxLength(255) + newFilename: string; +} + +export class MoveFileDto { + @ApiPropertyOptional({ example: 'uuid-of-target-folder', description: 'Target folder ID (null for root)' }) + @IsOptional() + @IsString() + targetFolderId?: string | null; +} diff --git a/apps/backend/src/modules/files/file-validator.util.ts b/apps/backend/src/modules/files/file-validator.util.ts new file mode 100644 index 0000000..888d9b9 --- /dev/null +++ b/apps/backend/src/modules/files/file-validator.util.ts @@ -0,0 +1,127 @@ +import { BadRequestException } from '@nestjs/common'; +import * as path from 'path'; +import { FileCategory } from '@prisma/client'; + +export class FileValidatorUtil { + private static readonly EXTENSION_CATEGORY_MAP: Record = { + // Videos + mp4: FileCategory.VIDEO, + webm: FileCategory.VIDEO, + mov: FileCategory.VIDEO, + mkv: FileCategory.VIDEO, + avi: FileCategory.VIDEO, + + // Images + png: FileCategory.IMAGE, + jpg: FileCategory.IMAGE, + jpeg: FileCategory.IMAGE, + webp: FileCategory.IMAGE, + gif: FileCategory.IMAGE, + + // Documents + pdf: FileCategory.DOCUMENT, + doc: FileCategory.DOCUMENT, + docx: FileCategory.DOCUMENT, + xls: FileCategory.DOCUMENT, + xlsx: FileCategory.DOCUMENT, + ppt: FileCategory.DOCUMENT, + pptx: FileCategory.DOCUMENT, + txt: FileCategory.DOCUMENT, + csv: FileCategory.DOCUMENT, + json: FileCategory.DOCUMENT, + + // Archives + zip: FileCategory.ARCHIVE, + rar: FileCategory.ARCHIVE, + '7z': FileCategory.ARCHIVE, + tar: FileCategory.ARCHIVE, + gz: FileCategory.ARCHIVE, + + // Audio + mp3: FileCategory.AUDIO, + wav: FileCategory.AUDIO, + ogg: FileCategory.AUDIO, + }; + + /** + * Determine file category from extension + */ + static getCategoryFromExtension(extension: string): FileCategory { + const ext = extension.toLowerCase().replace(/^\./, ''); + return this.EXTENSION_CATEGORY_MAP[ext] || FileCategory.OTHER; + } + + /** + * Validate file signature / magic numbers against buffer + */ + static validateMagicBytes(buffer: Buffer, extension: string): boolean { + if (!buffer || buffer.length < 4) return true; // Can't verify very small files + + const ext = extension.toLowerCase().replace(/^\./, ''); + + switch (ext) { + case 'png': + return buffer[0] === 0x89 && buffer[1] === 0x50 && buffer[2] === 0x4e && buffer[3] === 0x47; + + case 'jpg': + case 'jpeg': + return buffer[0] === 0xff && buffer[1] === 0xd8 && buffer[2] === 0xff; + + case 'gif': + return ( + buffer[0] === 0x47 && + buffer[1] === 0x49 && + buffer[2] === 0x46 && + buffer[3] === 0x38 + ); + + case 'pdf': + return ( + buffer[0] === 0x25 && + buffer[1] === 0x50 && + buffer[2] === 0x44 && + buffer[3] === 0x46 + ); + + case 'zip': + case 'docx': + case 'xlsx': + case 'pptx': + return buffer[0] === 0x50 && buffer[1] === 0x4b && buffer[2] === 0x03 && buffer[3] === 0x04; + + case 'mp4': + case 'mov': + // MP4 / QuickTime files have 'ftyp' at offset 4 + if (buffer.length >= 8) { + const marker = buffer.slice(4, 8).toString('ascii'); + return marker === 'ftyp' || marker === 'moov' || marker === 'mdat'; + } + return true; + + case 'webm': + case 'mkv': + // EBML signature 1A 45 DF A3 + return buffer[0] === 0x1a && buffer[1] === 0x45 && buffer[2] === 0xdf && buffer[3] === 0xa3; + + default: + // Other formats pass magic signature if allowed in settings + return true; + } + } + + /** + * Check if file extension is explicitly permitted + */ + static verifyExtensionAllowed(extension: string, allowedExtensionsCsv?: string): void { + const ext = extension.toLowerCase().replace(/^\./, ''); + const allowed = (allowedExtensionsCsv || 'mp4,webm,mov,avi,mkv,png,jpg,jpeg,webp,gif,pdf,doc,docx,xls,xlsx,ppt,pptx,zip,rar,7z,tar,gz,mp3,wav,ogg,txt,csv,json') + .split(',') + .map((e) => e.trim().toLowerCase()); + + if (!allowed.includes(ext)) { + throw new BadRequestException( + `File extension ".${ext}" is not permitted. Allowed extensions: ${allowed.join(', ')}`, + ); + } + } +} diff --git a/apps/backend/src/modules/files/files.controller.ts b/apps/backend/src/modules/files/files.controller.ts new file mode 100644 index 0000000..570826a --- /dev/null +++ b/apps/backend/src/modules/files/files.controller.ts @@ -0,0 +1,178 @@ +import { + Controller, + Get, + Post, + Patch, + Delete, + Param, + Body, + Query, + Req, + Res, + UseGuards, + UseInterceptors, + UploadedFile, +} from '@nestjs/common'; +import { FileInterceptor } from '@nestjs/platform-express'; +import { ApiTags, ApiOperation, ApiBearerAuth, ApiConsumes, ApiQuery } from '@nestjs/swagger'; +import { Request, Response } from 'express'; +import { FilesService } from './files.service'; +import { CreateUploadSessionDto, RenameFileDto, MoveFileDto } from './dto/file.dto'; +import { JwtAuthGuard } from '../auth/guards/jwt-auth.guard'; +import { CurrentUser, AuthenticatedUser } from '../auth/decorators/current-user.decorator'; +import { FileCategory } from '@prisma/client'; + +@ApiTags('Files & Uploads') +@ApiBearerAuth() +@UseGuards(JwtAuthGuard) +@Controller('files') +export class FilesController { + constructor(private readonly filesService: FilesService) {} + + @Post('direct-upload') + @ApiOperation({ summary: 'Direct multipart file upload with quota check and background video processing' }) + @ApiConsumes('multipart/form-data') + @UseInterceptors(FileInterceptor('file')) + async directUpload( + @UploadedFile() file: Express.Multer.File, + @Body('folderId') folderId: string, + @CurrentUser() user: AuthenticatedUser, + @Req() req: Request, + ) { + return this.filesService.handleDirectUpload( + user.id, + user.role, + file, + folderId, + req.ip, + req.headers['user-agent'], + ); + } + + @Post('upload-sessions') + @ApiOperation({ summary: 'Initialize a resumable/chunked upload session with quota reservation' }) + async createUploadSession( + @Body() dto: CreateUploadSessionDto, + @CurrentUser() user: AuthenticatedUser, + ) { + return this.filesService.createUploadSession(user.id, user.role, dto); + } + + @Post('upload-sessions/:id/complete') + @ApiOperation({ summary: 'Complete a resumable upload session and finalize file record' }) + async completeUploadSession( + @Param('id') sessionId: string, + @CurrentUser() user: AuthenticatedUser, + ) { + return this.filesService.completeUploadSession(user.id, user.role, sessionId); + } + + @Get() + @ApiOperation({ summary: 'List user files with category filtering, search, and sorting' }) + @ApiQuery({ name: 'folderId', required: false }) + @ApiQuery({ name: 'category', enum: FileCategory, required: false }) + @ApiQuery({ name: 'search', required: false }) + @ApiQuery({ name: 'page', required: false, type: Number }) + @ApiQuery({ name: 'limit', required: false, type: Number }) + @ApiQuery({ name: 'sortBy', required: false, enum: ['name', 'date', 'size'] }) + @ApiQuery({ name: 'sortOrder', required: false, enum: ['asc', 'desc'] }) + async getUserFiles( + @CurrentUser() user: AuthenticatedUser, + @Query('folderId') folderId?: string, + @Query('category') category?: FileCategory, + @Query('search') search?: string, + @Query('page') page?: string, + @Query('limit') limit?: string, + @Query('sortBy') sortBy?: 'name' | 'date' | 'size', + @Query('sortOrder') sortOrder?: 'asc' | 'desc', + ) { + return this.filesService.getUserFiles(user.id, user.role, { + folderId, + category, + search, + page: page ? parseInt(page, 10) : 1, + limit: limit ? parseInt(limit, 10) : 50, + sortBy, + sortOrder, + }); + } + + @Get(':id') + @ApiOperation({ summary: 'Get file metadata and user permissions' }) + async getFileById( + @Param('id') id: string, + @CurrentUser() user: AuthenticatedUser, + ) { + return this.filesService.getFileById(user.id, user.role, id); + } + + @Get(':id/preview') + @ApiOperation({ summary: 'Inline preview for images, documents, audio, or text' }) + async previewFile( + @Param('id') id: string, + @CurrentUser() user: AuthenticatedUser, + @Res() res: Response, + ) { + const { stream, filename, contentType, contentLength } = + await this.filesService.getFileForPreview(user.id, user.role, id); + + res.setHeader('Content-Type', contentType); + res.setHeader('Content-Length', contentLength); + res.setHeader('Content-Disposition', `inline; filename="${encodeURIComponent(filename)}"`); + res.setHeader('Cache-Control', 'private, max-age=3600'); + stream.pipe(res); + } + + @Get(':id/download') + @ApiOperation({ summary: 'Secure streaming file download protected by canDownload permission' }) + async downloadFile( + @Param('id') id: string, + @CurrentUser() user: AuthenticatedUser, + @Req() req: Request, + @Res() res: Response, + ) { + const { stream, filename, contentType, contentLength } = + await this.filesService.getFileForDownload( + user.id, + user.role, + id, + req.ip, + req.headers['user-agent'], + ); + + res.setHeader('Content-Type', contentType); + res.setHeader('Content-Length', contentLength); + res.setHeader('Content-Disposition', `attachment; filename="${encodeURIComponent(filename)}"`); + res.setHeader('Cache-Control', 'no-cache, private'); + stream.pipe(res); + } + + @Patch(':id/rename') + @ApiOperation({ summary: 'Rename a file' }) + async renameFile( + @Param('id') id: string, + @Body() dto: RenameFileDto, + @CurrentUser() user: AuthenticatedUser, + ) { + return this.filesService.renameFile(user.id, user.role, id, dto); + } + + @Patch(':id/move') + @ApiOperation({ summary: 'Move a file to another folder' }) + async moveFile( + @Param('id') id: string, + @Body() dto: MoveFileDto, + @CurrentUser() user: AuthenticatedUser, + ) { + return this.filesService.moveFile(user.id, user.role, id, dto); + } + + @Delete(':id') + @ApiOperation({ summary: 'Soft-delete a file and free storage quota' }) + async deleteFile( + @Param('id') id: string, + @CurrentUser() user: AuthenticatedUser, + ) { + return this.filesService.deleteFile(user.id, user.role, user.companyName, id); + } +} diff --git a/apps/backend/src/modules/files/files.module.ts b/apps/backend/src/modules/files/files.module.ts new file mode 100644 index 0000000..3a8c010 --- /dev/null +++ b/apps/backend/src/modules/files/files.module.ts @@ -0,0 +1,13 @@ +import { Module } from '@nestjs/common'; +import { FilesService } from './files.service'; +import { FilesController } from './files.controller'; +import { SharingController } from './sharing.controller'; +import { VideoModule } from '../video/video.module'; + +@Module({ + imports: [VideoModule], + controllers: [FilesController, SharingController], + providers: [FilesService], + exports: [FilesService], +}) +export class FilesModule {} diff --git a/apps/backend/src/modules/files/files.service.ts b/apps/backend/src/modules/files/files.service.ts new file mode 100644 index 0000000..d9576c5 --- /dev/null +++ b/apps/backend/src/modules/files/files.service.ts @@ -0,0 +1,870 @@ +import { + Injectable, + NotFoundException, + ForbiddenException, + BadRequestException, + Logger, + Inject, +} from '@nestjs/common'; +import * as path from 'path'; +import * as crypto from 'crypto'; +import { v4 as uuidv4 } from 'uuid'; +import { PrismaService } from '../prisma/prisma.service'; +import { STORAGE_PROVIDER, IStorageProvider } from '../storage/storage.interface'; +import { StoragePathUtils } from '../storage/storage-path.util'; +import { FileValidatorUtil } from './file-validator.util'; +import { PermissionsService } from '../permissions/permissions.service'; +import { VideoQueueService } from '../video/video-queue.service'; +import { AuditService } from '../audit/audit.service'; +import { CreateUploadSessionDto, RenameFileDto, MoveFileDto } from './dto/file.dto'; +import { + FileCategory, + FileStatus, + UploadSessionStatus, + UserRole, + PermissionResourceType, +} from '@prisma/client'; + +@Injectable() +export class FilesService { + private readonly logger = new Logger(FilesService.name); + + constructor( + private readonly prisma: PrismaService, + private readonly permissionsService: PermissionsService, + private readonly videoQueueService: VideoQueueService, + private readonly auditService: AuditService, + @Inject(STORAGE_PROVIDER) private readonly storageProvider: IStorageProvider, + ) {} + + /** + * Check user storage quota availability + */ + private async checkStorageQuota(userId: string, incomingBytes: bigint): Promise { + const user = await this.prisma.user.findUnique({ + where: { id: userId }, + select: { storageQuotaBytes: true, storageUsedBytes: true }, + }); + + if (!user) { + throw new NotFoundException('User not found'); + } + + if (user.storageUsedBytes + incomingBytes > user.storageQuotaBytes) { + const remainingBytes = user.storageQuotaBytes - user.storageUsedBytes; + const formattedRemaining = (Number(remainingBytes) / (1024 * 1024)).toFixed(2); + const formattedIncoming = (Number(incomingBytes) / (1024 * 1024)).toFixed(2); + + throw new BadRequestException( + `Storage quota exceeded! File size is ${formattedIncoming} MB, but you only have ${formattedRemaining} MB remaining.`, + ); + } + } + + /** + * Direct Upload handler + */ + async handleDirectUpload( + userId: string, + userRole: string, + file: Express.Multer.File, + folderId?: string, + ipAddress?: string, + userAgent?: string, + ) { + if (!file) { + throw new BadRequestException('No file provided for upload'); + } + + const fileSizeBigInt = BigInt(file.size); + + const isSuperOrAdmin = + userRole === UserRole.SUPER_ADMIN || + userRole === 'SUPER_ADMIN' || + userRole === UserRole.ADMIN || + userRole === 'ADMIN'; + + // Target folder verification + let targetFolderId: string | null = null; + let targetOwnerId: string = userId; + + if (folderId && folderId !== 'root') { + const folder = await this.prisma.folder.findUnique({ + where: { id: folderId }, + include: { owner: true }, + }); + if (!folder) { + throw new NotFoundException('Destination folder not found'); + } + if (folder.ownerId !== userId && !isSuperOrAdmin) { + throw new ForbiddenException('Destination folder unauthorized'); + } + targetFolderId = folder.id; + targetOwnerId = folder.ownerId; + } else { + const rootFolder = await this.prisma.folder.findFirst({ + where: { ownerId: userId, parentId: null }, + }); + targetFolderId = rootFolder?.id || null; + targetOwnerId = userId; + } + + // 1. Storage quota verification on target owner + await this.checkStorageQuota(targetOwnerId, fileSizeBigInt); + + // 2. Fetch system upload settings + const [maxSizeSetting, allowedExtSetting] = await Promise.all([ + this.prisma.systemSetting.findUnique({ where: { key: 'MAX_FILE_SIZE_BYTES' } }), + this.prisma.systemSetting.findUnique({ where: { key: 'ALLOWED_EXTENSIONS' } }), + ]); + + const maxSizeBytes = maxSizeSetting ? BigInt(maxSizeSetting.value) : BigInt(5368709120); + if (fileSizeBigInt > maxSizeBytes) { + throw new BadRequestException(`File exceeds maximum allowed system upload limit`); + } + + // 3. Filename and extension validation + const rawFilename = Buffer.from(file.originalname, 'latin1').toString('utf8'); + const cleanFilename = StoragePathUtils.sanitizeFilename(rawFilename); + const rawExtension = path.extname(cleanFilename).toLowerCase().replace(/^\./, ''); + const extension = rawExtension || 'bin'; + + FileValidatorUtil.verifyExtensionAllowed(extension, allowedExtSetting?.value); + + // 4. Magic bytes & content inspection + const isMagicValid = FileValidatorUtil.validateMagicBytes(file.buffer, extension); + if (!isMagicValid) { + this.logger.warn(`File content signature mismatch for ${cleanFilename}`); + } + + const category = FileValidatorUtil.getCategoryFromExtension(extension); + + // 6. Generate isolated canonical storage key & SHA-256 checksum + const fileId = uuidv4(); + const storageKey = StoragePathUtils.buildFileKey(targetOwnerId, fileId, extension); + const checksum = crypto.createHash('sha256').update(file.buffer).digest('hex'); + + // 7. Store file bytes in private storage backend + await this.storageProvider.putBuffer(storageKey, file.buffer, file.mimetype); + + // 8. Create database record and update quota + const initialStatus = category === FileCategory.VIDEO ? FileStatus.PROCESSING : FileStatus.READY; + + const fileAsset = await this.prisma.$transaction(async (tx) => { + const createdFile = await tx.fileAsset.create({ + data: { + id: fileId, + ownerId: targetOwnerId, + folderId: targetFolderId, + originalFilename: cleanFilename, + internalStorageKey: storageKey, + mimeType: file.mimetype || 'application/octet-stream', + fileExtension: extension, + fileSizeBytes: fileSizeBigInt, + fileCategory: category, + checksum, + status: initialStatus, + }, + }); + + await tx.user.update({ + where: { id: targetOwnerId }, + data: { storageUsedBytes: { increment: fileSizeBigInt } }, + }); + + return createdFile; + }); + + await this.auditService.log({ + actorUserId: userId, + action: 'FILE_UPLOADED', + resourceType: 'FILE', + resourceId: fileAsset.id, + targetUserId: targetOwnerId, + ipAddress, + userAgent, + details: { + filename: cleanFilename, + sizeBytes: file.size, + category, + storageKey, + }, + }); + + // 9. If video, enqueue video processing job + if (category === FileCategory.VIDEO) { + await this.videoQueueService.enqueueVideoProcessing(fileAsset.id); + } + + // 10. If Superadmin configured a Remote File Server Link, sync/dispatch file + this.dispatchToRemoteFileServer(fileAsset, file.buffer).catch((err) => { + this.logger.warn(`Remote file server sync failed: ${err.message}`); + }); + + return { + id: fileAsset.id, + originalFilename: fileAsset.originalFilename, + fileCategory: fileAsset.fileCategory, + fileSizeBytes: fileAsset.fileSizeBytes.toString(), + status: fileAsset.status, + createdAt: fileAsset.createdAt, + }; + } + + /** + * Initialize a Resumable/Chunked Upload Session + */ + async createUploadSession( + userId: string, + userRole: string, + dto: CreateUploadSessionDto, + ) { + const isSuperOrAdmin = + userRole === UserRole.SUPER_ADMIN || + userRole === 'SUPER_ADMIN' || + userRole === UserRole.ADMIN || + userRole === 'ADMIN'; + + let targetFolderId: string | null = null; + let targetOwnerId: string = userId; + + if (dto.folderId && dto.folderId !== 'root') { + const folder = await this.prisma.folder.findUnique({ where: { id: dto.folderId } }); + if (!folder) { + throw new NotFoundException('Destination folder not found'); + } + if (folder.ownerId !== userId && !isSuperOrAdmin) { + throw new ForbiddenException('Destination folder unauthorized'); + } + targetFolderId = folder.id; + targetOwnerId = folder.ownerId; + } + + const fileSizeBigInt = BigInt(dto.fileSizeBytes); + await this.checkStorageQuota(targetOwnerId, fileSizeBigInt); + + const cleanFilename = StoragePathUtils.sanitizeFilename(dto.originalFilename); + const extension = path.extname(cleanFilename).toLowerCase().replace(/^\./, '') || 'bin'; + const category = FileValidatorUtil.getCategoryFromExtension(extension); + + const sessionId = uuidv4(); + const tempKey = `temp/${targetOwnerId}/${sessionId}/${cleanFilename}`; + const expiresAt = new Date(Date.now() + 24 * 60 * 60 * 1000); // 24 hours + + const session = await this.prisma.uploadSession.create({ + data: { + id: sessionId, + ownerId: targetOwnerId, + folderId: targetFolderId, + originalFilename: cleanFilename, + mimeType: dto.mimeType, + fileCategory: category, + totalSizeBytes: fileSizeBigInt, + tempStorageKey: tempKey, + status: UploadSessionStatus.INITIALIZED, + expiresAt, + }, + }); + + return { + uploadSessionId: session.id, + expiresAt: session.expiresAt, + tempStorageKey: session.tempStorageKey, + }; + } + + /** + * Complete Resumable Upload Session + */ + async completeUploadSession(userId: string, userRole: string, sessionId: string) { + const isSuperOrAdmin = + userRole === UserRole.SUPER_ADMIN || + userRole === 'SUPER_ADMIN' || + userRole === UserRole.ADMIN || + userRole === 'ADMIN'; + + const session = await this.prisma.uploadSession.findUnique({ + where: { id: sessionId }, + }); + + if (!session) { + throw new NotFoundException('Upload session not found'); + } + + if (session.ownerId !== userId && !isSuperOrAdmin) { + throw new ForbiddenException('Upload session unauthorized'); + } + + if (session.status === UploadSessionStatus.COMPLETED) { + throw new BadRequestException('Upload session has already been completed'); + } + + const fileId = uuidv4(); + const extension = path.extname(session.originalFilename).toLowerCase().replace(/^\./, '') || 'bin'; + const finalStorageKey = StoragePathUtils.buildFileKey(session.ownerId, fileId, extension); + + // If temp file exists, move it to final storage + const tempExists = await this.storageProvider.exists(session.tempStorageKey); + if (tempExists) { + const { stream } = await this.storageProvider.getStream(session.tempStorageKey); + await this.storageProvider.putStream(finalStorageKey, stream, Number(session.totalSizeBytes), session.mimeType); + await this.storageProvider.delete(session.tempStorageKey); + } + + const initialStatus = session.fileCategory === FileCategory.VIDEO ? FileStatus.PROCESSING : FileStatus.READY; + + const fileAsset = await this.prisma.$transaction(async (tx) => { + const file = await tx.fileAsset.create({ + data: { + id: fileId, + ownerId: session.ownerId, + folderId: session.folderId, + originalFilename: session.originalFilename, + internalStorageKey: finalStorageKey, + mimeType: session.mimeType, + fileExtension: extension, + fileSizeBytes: session.totalSizeBytes, + fileCategory: session.fileCategory, + status: initialStatus, + }, + }); + + await tx.user.update({ + where: { id: session.ownerId }, + data: { storageUsedBytes: { increment: session.totalSizeBytes } }, + }); + + await tx.uploadSession.update({ + where: { id: sessionId }, + data: { status: UploadSessionStatus.COMPLETED }, + }); + + return file; + }); + + if (session.fileCategory === FileCategory.VIDEO) { + await this.videoQueueService.enqueueVideoProcessing(fileAsset.id); + } + + return fileAsset; + } + + /** + * List files for a user with search and filtering + */ + async getUserFiles( + userId: string, + userRole: string, + params: { + folderId?: string; + category?: FileCategory; + search?: string; + page?: number; + limit?: number; + sortBy?: 'name' | 'date' | 'size'; + sortOrder?: 'asc' | 'desc'; + }, + ) { + const page = params.page || 1; + const limit = params.limit || 50; + const skip = (page - 1) * limit; + + const where: any = { + ownerId: userId, + isSoftDeleted: false, + }; + + if (params.folderId) { + where.folderId = params.folderId; + } + if (params.category) { + where.fileCategory = params.category; + } + if (params.search) { + where.originalFilename = { contains: params.search }; + } + + let orderBy: any = { createdAt: 'desc' }; + if (params.sortBy === 'name') { + orderBy = { originalFilename: params.sortOrder || 'asc' }; + } else if (params.sortBy === 'size') { + orderBy = { fileSizeBytes: params.sortOrder || 'desc' }; + } else if (params.sortBy === 'date') { + orderBy = { createdAt: params.sortOrder || 'desc' }; + } + + const [total, files] = await Promise.all([ + this.prisma.fileAsset.count({ where }), + this.prisma.fileAsset.findMany({ + where, + take: limit, + skip, + orderBy, + include: { + owner: { select: { id: true, username: true, fullName: true, email: true } }, + folder: { select: { id: true, name: true, logicalPath: true } }, + }, + }), + ]); + + const enriched = await Promise.all( + files.map(async (f) => { + const perms = await this.permissionsService.getEffectiveFilePermissions(userId, userRole, f); + return { + id: f.id, + ownerId: f.ownerId, + ownerName: f.owner.fullName, + ownerEmail: f.owner.email, + folderId: f.folderId, + folderName: f.folder?.name || 'Root', + originalFilename: f.originalFilename, + mimeType: f.mimeType, + fileExtension: f.fileExtension, + fileSizeBytes: f.fileSizeBytes.toString(), + fileCategory: f.fileCategory, + status: f.status, + durationSeconds: f.durationSeconds, + width: f.width, + height: f.height, + videoCodec: f.videoCodec, + audioCodec: f.audioCodec, + hasThumbnail: !!f.thumbnailStorageKey, + hasHlsStream: !!f.hlsMasterPlaylistKey, + createdAt: f.createdAt, + updatedAt: f.updatedAt, + permissions: perms, + }; + }), + ); + + return { total, page, limit, files: enriched }; + } + + /** + * Get file metadata and authorization details + */ + async getFileById(userId: string, userRole: string, fileId: string) { + const file = await this.permissionsService.enforceFileAccess( + userId, + userRole, + fileId, + 'canViewMetadata', + ); + + const owner = await this.prisma.user.findUnique({ + where: { id: file.ownerId }, + select: { id: true, username: true, fullName: true, email: true }, + }); + + const perms = await this.permissionsService.getEffectiveFilePermissions(userId, userRole, file); + + return { + id: file.id, + ownerId: file.ownerId, + ownerName: owner?.fullName, + ownerEmail: owner?.email, + folderId: file.folderId, + originalFilename: file.originalFilename, + mimeType: file.mimeType, + fileExtension: file.fileExtension, + fileSizeBytes: file.fileSizeBytes.toString(), + fileCategory: file.fileCategory, + status: file.status, + durationSeconds: file.durationSeconds, + width: file.width, + height: file.height, + videoCodec: file.videoCodec, + audioCodec: file.audioCodec, + hasThumbnail: !!file.thumbnailStorageKey, + hasHlsStream: !!file.hlsMasterPlaylistKey, + createdAt: file.createdAt, + updatedAt: file.updatedAt, + permissions: perms, + }; + } + + /** + * Prepare file stream for Download + */ + async getFileForDownload( + userId: string, + userRole: string, + fileId: string, + ipAddress?: string, + userAgent?: string, + ) { + // Strictly enforces canDownload permission + const file = await this.permissionsService.enforceFileAccess( + userId, + userRole, + fileId, + 'canDownload', + ); + + const { stream, contentLength, contentType } = await this.storageProvider.getStream( + file.internalStorageKey, + ); + + await this.auditService.log({ + actorUserId: userId, + action: 'FILE_DOWNLOADED', + resourceType: 'FILE', + resourceId: file.id, + targetUserId: file.ownerId, + ipAddress, + userAgent, + details: { filename: file.originalFilename, size: file.fileSizeBytes.toString() }, + }); + + return { + stream, + filename: file.originalFilename, + contentType: file.mimeType || contentType, + contentLength, + }; + } + + /** + * Prepare file stream for Inline Preview + */ + async getFileForPreview(userId: string, userRole: string, fileId: string) { + // Strictly enforces canPreview permission + const file = await this.permissionsService.enforceFileAccess( + userId, + userRole, + fileId, + 'canPreview', + ); + + const { stream, contentLength, contentType } = await this.storageProvider.getStream( + file.internalStorageKey, + ); + + return { + stream, + filename: file.originalFilename, + contentType: file.mimeType || contentType, + contentLength, + }; + } + + /** + * Rename file + */ + async renameFile(userId: string, userRole: string, fileId: string, dto: RenameFileDto) { + const file = await this.prisma.fileAsset.findUnique({ where: { id: fileId } }); + if (!file || file.isSoftDeleted) { + throw new NotFoundException('File not found'); + } + + if (file.ownerId !== userId && userRole !== UserRole.SUPER_ADMIN && userRole !== UserRole.ADMIN) { + throw new ForbiddenException('Only the file owner or administrator can rename this file'); + } + + const clean = StoragePathUtils.sanitizeFilename(dto.newFilename); + const updated = await this.prisma.fileAsset.update({ + where: { id: fileId }, + data: { originalFilename: clean }, + }); + + await this.auditService.log({ + actorUserId: userId, + action: 'FILE_RENAMED', + resourceType: 'FILE', + resourceId: fileId, + details: { oldName: file.originalFilename, newName: clean }, + }); + + return updated; + } + + /** + * Move file to another folder + */ + async moveFile(userId: string, userRole: string, fileId: string, dto: MoveFileDto) { + const file = await this.prisma.fileAsset.findUnique({ where: { id: fileId } }); + if (!file || file.isSoftDeleted) { + throw new NotFoundException('File not found'); + } + + if (file.ownerId !== userId && userRole !== UserRole.SUPER_ADMIN && userRole !== UserRole.ADMIN) { + throw new ForbiddenException('Only the file owner or administrator can move this file'); + } + + let targetFolderId: string | null = null; + if (dto.targetFolderId && dto.targetFolderId !== 'root') { + const folder = await this.prisma.folder.findUnique({ where: { id: dto.targetFolderId } }); + if (!folder || folder.ownerId !== file.ownerId) { + throw new NotFoundException('Destination folder not found or does not belong to owner'); + } + targetFolderId = folder.id; + } else { + const rootFolder = await this.prisma.folder.findFirst({ + where: { ownerId: file.ownerId, parentId: null }, + }); + targetFolderId = rootFolder?.id || null; + } + + const updated = await this.prisma.fileAsset.update({ + where: { id: fileId }, + data: { folderId: targetFolderId }, + }); + + await this.auditService.log({ + actorUserId: userId, + action: 'FILE_MOVED', + resourceType: 'FILE', + resourceId: fileId, + details: { targetFolderId }, + }); + + return updated; + } + + /** + * Soft-delete file (recycle bin) + */ + async deleteFile(userId: string, userRole: string, userCompanyName: string | undefined, fileId: string) { + const file = await this.prisma.fileAsset.findUnique({ + where: { id: fileId }, + include: { owner: { select: { id: true, companyName: true } } }, + }); + if (!file || file.isSoftDeleted) { + throw new NotFoundException('File not found or already deleted'); + } + + const isSuperAdmin = userRole === UserRole.SUPER_ADMIN || userRole === 'SUPER_ADMIN'; + const isAdmin = userRole === UserRole.ADMIN || userRole === 'ADMIN'; + + if (isSuperAdmin) { + // Super Admin has full unrestricted permission to delete any file across all companies + } else if (isAdmin) { + // Admin cannot delete files belonging to other companies + const adminCompany = (userCompanyName || 'Ecohub').trim().toLowerCase(); + const fileCompany = (file.owner?.companyName || 'Ecohub').trim().toLowerCase(); + if (adminCompany !== fileCompany) { + throw new ForbiddenException( + 'Administrators cannot delete files belonging to other companies. Only Super Admin has this permission.', + ); + } + } else { + // Regular user: can only delete their own files + if (file.ownerId !== userId) { + throw new ForbiddenException('Only the file owner or administrator can delete this file'); + } + + const user = await this.prisma.user.findUnique({ + where: { id: userId }, + select: { canDeleteFiles: true }, + }); + if (!user?.canDeleteFiles) { + throw new ForbiddenException('You do not have permission to delete files. Please contact an administrator.'); + } + } + + // Soft delete and deduct from user's storage quota + await this.prisma.$transaction([ + this.prisma.fileAsset.update({ + where: { id: fileId }, + data: { isSoftDeleted: true, deletedAt: new Date() }, + }), + this.prisma.user.update({ + where: { id: file.ownerId }, + data: { storageUsedBytes: { decrement: file.fileSizeBytes } }, + }), + ]); + + await this.auditService.log({ + actorUserId: userId, + action: 'FILE_SOFT_DELETED', + resourceType: 'FILE', + resourceId: fileId, + targetUserId: file.ownerId, + details: { filename: file.originalFilename, sizeBytes: file.fileSizeBytes.toString() }, + }); + + return { success: true, message: 'File moved to trash successfully' }; + } + + /** + * Get files shared with the current user ("Shared With Me") + */ + async getSharedWithMe(userId: string) { + const now = new Date(); + + // 1. Find all active permissions granted to this user + const permissions = await this.prisma.filePermission.findMany({ + where: { + granteeUserId: userId, + revokedAt: null, + OR: [{ expiresAt: null }, { expiresAt: { gt: now } }], + }, + include: { + owner: { select: { id: true, username: true, fullName: true, email: true } }, + }, + }); + + if (permissions.length === 0) { + return []; + } + + // Collect file IDs and folder IDs + const directFileIds = permissions + .filter((p) => p.resourceType === PermissionResourceType.FILE && p.resourceId) + .map((p) => p.resourceId as string); + + const folderIds = permissions + .filter((p) => p.resourceType === PermissionResourceType.FOLDER && p.resourceId) + .map((p) => p.resourceId as string); + + const broadOwnerIds = permissions + .filter((p) => p.resourceType === PermissionResourceType.USER_FILES) + .map((p) => p.ownerId); + + // Fetch matching files + const files = await this.prisma.fileAsset.findMany({ + where: { + isSoftDeleted: false, + OR: [ + { id: { in: directFileIds } }, + { folderId: { in: folderIds } }, + { ownerId: { in: broadOwnerIds } }, + ], + }, + include: { + owner: { select: { id: true, username: true, fullName: true, email: true } }, + folder: { select: { id: true, name: true, logicalPath: true } }, + }, + }); + + const results = await Promise.all( + files.map(async (file) => { + const perms = await this.permissionsService.getEffectiveFilePermissions( + userId, + UserRole.USER, + file, + ); + return { + id: file.id, + ownerId: file.ownerId, + ownerName: file.owner.fullName, + ownerEmail: file.owner.email, + folderId: file.folderId, + folderName: file.folder?.name || 'Root', + originalFilename: file.originalFilename, + mimeType: file.mimeType, + fileExtension: file.fileExtension, + fileSizeBytes: file.fileSizeBytes.toString(), + fileCategory: file.fileCategory, + status: file.status, + durationSeconds: file.durationSeconds, + width: file.width, + height: file.height, + hasThumbnail: !!file.thumbnailStorageKey, + hasHlsStream: !!file.hlsMasterPlaylistKey, + createdAt: file.createdAt, + permissions: perms, + }; + }), + ); + + return results; + } + + /** + * Helper to dispatch or mirror uploaded file to remote file server link (User-specific or system-wide) + */ + private async dispatchToRemoteFileServer(fileAsset: any, buffer: Buffer): Promise { + try { + // 1. Check user-specific remote file server configuration first + const owner = await this.prisma.user.findUnique({ + where: { id: fileAsset.ownerId }, + select: { + username: true, + email: true, + companyName: true, + remoteFileServerUrl: true, + canUseRemoteServer: true, + }, + }); + + let targetRemoteUrl: string | null = null; + let isUserSpecific = false; + + if (owner?.canUseRemoteServer && owner?.remoteFileServerUrl && owner.remoteFileServerUrl.trim().length > 0) { + targetRemoteUrl = owner.remoteFileServerUrl.trim(); + isUserSpecific = true; + } else { + // Fallback to global system setting + const setting = await this.prisma.systemSetting.findUnique({ + where: { key: 'REMOTE_FILE_SERVER_URL' }, + }); + if (setting && setting.value && setting.value.trim().length > 0) { + targetRemoteUrl = setting.value.trim(); + isUserSpecific = false; + } + } + + if (targetRemoteUrl) { + this.logger.log( + `[Remote Dispatch] File ${fileAsset.originalFilename} dispatched to ${ + isUserSpecific ? `user (${owner?.username}) endpoint` : 'system global endpoint' + }: ${targetRemoteUrl}`, + ); + + await this.auditService.log({ + actorUserId: fileAsset.ownerId, + action: 'REMOTE_FILE_SERVER_SYNC_DISPATCHED', + resourceType: 'FILE', + resourceId: fileAsset.id, + details: { + remoteUrl: targetRemoteUrl, + isUserSpecific, + ownerUsername: owner?.username, + companyName: owner?.companyName, + filename: fileAsset.originalFilename, + sizeBytes: Number(fileAsset.fileSizeBytes), + }, + }); + + // If HTTP/HTTPS endpoint, perform asynchronous POST dispatch in background + if (targetRemoteUrl.startsWith('http://') || targetRemoteUrl.startsWith('https://')) { + const controller = new AbortController(); + const timeoutId = setTimeout(() => controller.abort(), 8000); + + fetch(targetRemoteUrl, { + method: 'POST', + headers: { + 'Content-Type': 'application/json', + 'X-Ecohub-User': owner?.username || '', + 'X-Ecohub-Company': owner?.companyName || 'Ecohub', + 'X-Ecohub-File-Id': fileAsset.id, + 'X-Ecohub-File-Name': encodeURIComponent(fileAsset.originalFilename), + }, + body: JSON.stringify({ + fileId: fileAsset.id, + originalFilename: fileAsset.originalFilename, + fileSizeBytes: Number(fileAsset.fileSizeBytes), + mimeType: fileAsset.mimeType, + ownerId: fileAsset.ownerId, + ownerUsername: owner?.username, + companyName: owner?.companyName, + dispatchedAt: new Date().toISOString(), + }), + signal: controller.signal, + }) + .then((res) => { + clearTimeout(timeoutId); + this.logger.log(`[Remote Dispatch] Remote response status: ${res.status} for ${fileAsset.originalFilename}`); + }) + .catch((err) => { + clearTimeout(timeoutId); + this.logger.warn(`[Remote Dispatch] Remote endpoint ping/dispatch warning: ${err.message}`); + }); + } + } + } catch (err: any) { + this.logger.warn(`Failed to dispatch to remote file server: ${err.message}`); + } + } +} diff --git a/apps/backend/src/modules/files/sharing.controller.ts b/apps/backend/src/modules/files/sharing.controller.ts new file mode 100644 index 0000000..5e6ee5e --- /dev/null +++ b/apps/backend/src/modules/files/sharing.controller.ts @@ -0,0 +1,19 @@ +import { Controller, Get, UseGuards } from '@nestjs/common'; +import { ApiTags, ApiOperation, ApiBearerAuth } from '@nestjs/swagger'; +import { FilesService } from './files.service'; +import { JwtAuthGuard } from '../auth/guards/jwt-auth.guard'; +import { CurrentUser, AuthenticatedUser } from '../auth/decorators/current-user.decorator'; + +@ApiTags('Sharing') +@ApiBearerAuth() +@UseGuards(JwtAuthGuard) +@Controller('sharing') +export class SharingController { + constructor(private readonly filesService: FilesService) {} + + @Get('shared-with-me') + @ApiOperation({ summary: 'List all files and folders shared with the current user' }) + async getSharedWithMe(@CurrentUser() user: AuthenticatedUser) { + return this.filesService.getSharedWithMe(user.id); + } +} diff --git a/apps/backend/src/modules/folders/dto/folder.dto.ts b/apps/backend/src/modules/folders/dto/folder.dto.ts new file mode 100644 index 0000000..43f8a3f --- /dev/null +++ b/apps/backend/src/modules/folders/dto/folder.dto.ts @@ -0,0 +1,29 @@ +import { IsNotEmpty, IsOptional, IsString, Matches, MaxLength } from 'class-validator'; +import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger'; + +export class CreateFolderDto { + @ApiProperty({ example: 'My Projects', description: 'Folder name' }) + @IsNotEmpty() + @IsString() + @MaxLength(100) + @Matches(/^[^<>:"/\\|?*]+$/, { + message: 'Folder name contains invalid characters', + }) + name: string; + + @ApiPropertyOptional({ example: 'uuid-of-parent-folder', description: 'Parent folder ID (null for root)' }) + @IsOptional() + @IsString() + parentId?: string; +} + +export class RenameFolderDto { + @ApiProperty({ example: 'New Name' }) + @IsNotEmpty() + @IsString() + @MaxLength(100) + @Matches(/^[^<>:"/\\|?*]+$/, { + message: 'Folder name contains invalid characters', + }) + name: string; +} diff --git a/apps/backend/src/modules/folders/folders.controller.ts b/apps/backend/src/modules/folders/folders.controller.ts new file mode 100644 index 0000000..cad0330 --- /dev/null +++ b/apps/backend/src/modules/folders/folders.controller.ts @@ -0,0 +1,88 @@ +import { + Controller, + Get, + Post, + Patch, + Delete, + Body, + Param, + Query, + UseGuards, +} from '@nestjs/common'; +import { ApiTags, ApiOperation, ApiBearerAuth, ApiQuery } from '@nestjs/swagger'; +import { FoldersService } from './folders.service'; +import { CreateFolderDto, RenameFolderDto } from './dto/folder.dto'; +import { JwtAuthGuard } from '../auth/guards/jwt-auth.guard'; +import { CurrentUser, AuthenticatedUser } from '../auth/decorators/current-user.decorator'; + +@ApiTags('Folders') +@ApiBearerAuth() +@UseGuards(JwtAuthGuard) +@Controller('folders') +export class FoldersController { + constructor(private readonly foldersService: FoldersService) {} + + @Get() + @ApiOperation({ summary: 'Get current user folder tree' }) + async getUserFolders(@CurrentUser() user: AuthenticatedUser) { + return this.foldersService.getUserFolders(user.id); + } + + @Get('contents') + @ApiOperation({ summary: 'Browse folder contents, breadcrumbs, subfolders and files' }) + @ApiQuery({ name: 'folderId', required: false, description: 'Folder ID or leave empty for Root' }) + async getFolderContents( + @Query('folderId') folderId: string, + @CurrentUser() user: AuthenticatedUser, + ) { + return this.foldersService.getFolderContents(user.id, user.role, folderId); + } + + @Get('explorer') + @ApiOperation({ summary: 'Universal file explorer grouped by Company Name' }) + @ApiQuery({ name: 'companyName', required: false, description: 'Filter by specific company name' }) + @ApiQuery({ name: 'folderId', required: false, description: 'Folder ID inside company' }) + async getCompanyExplorer( + @Query('companyName') companyName: string, + @Query('folderId') folderId: string, + @CurrentUser() user: AuthenticatedUser, + ) { + return this.foldersService.getCompanyExplorer( + user.id, + user.role, + user.canViewOtherUsers, + user.companyName, + user.allowedCompanies, + companyName, + folderId, + ); + } + + @Post() + @ApiOperation({ summary: 'Create a new subfolder' }) + async createFolder( + @Body() dto: CreateFolderDto, + @CurrentUser() user: AuthenticatedUser, + ) { + return this.foldersService.createFolder(user.id, user.role, dto); + } + + @Patch(':id') + @ApiOperation({ summary: 'Rename a folder' }) + async renameFolder( + @Param('id') id: string, + @Body() dto: RenameFolderDto, + @CurrentUser() user: AuthenticatedUser, + ) { + return this.foldersService.renameFolder(user.id, user.role, id, dto); + } + + @Delete(':id') + @ApiOperation({ summary: 'Delete a folder and soft-delete contained files' }) + async deleteFolder( + @Param('id') id: string, + @CurrentUser() user: AuthenticatedUser, + ) { + return this.foldersService.deleteFolder(user.id, user.role, user.companyName, id); + } +} diff --git a/apps/backend/src/modules/folders/folders.module.ts b/apps/backend/src/modules/folders/folders.module.ts new file mode 100644 index 0000000..f26d0a7 --- /dev/null +++ b/apps/backend/src/modules/folders/folders.module.ts @@ -0,0 +1,10 @@ +import { Module } from '@nestjs/common'; +import { FoldersService } from './folders.service'; +import { FoldersController } from './folders.controller'; + +@Module({ + controllers: [FoldersController], + providers: [FoldersService], + exports: [FoldersService], +}) +export class FoldersModule {} diff --git a/apps/backend/src/modules/folders/folders.service.ts b/apps/backend/src/modules/folders/folders.service.ts new file mode 100644 index 0000000..e4f6805 --- /dev/null +++ b/apps/backend/src/modules/folders/folders.service.ts @@ -0,0 +1,596 @@ +import { + Injectable, + NotFoundException, + ForbiddenException, + ConflictException, + BadRequestException, +} from '@nestjs/common'; +import { PrismaService } from '../prisma/prisma.service'; +import { PermissionsService } from '../permissions/permissions.service'; +import { AuditService } from '../audit/audit.service'; +import { CreateFolderDto, RenameFolderDto } from './dto/folder.dto'; +import { UserRole, UserStatus } from '@prisma/client'; + +@Injectable() +export class FoldersService { + constructor( + private readonly prisma: PrismaService, + private readonly permissionsService: PermissionsService, + private readonly auditService: AuditService, + ) {} + + /** + * Get or create the root folder for a user + */ + async getOrCreateRootFolder(userId: string) { + let root = await this.prisma.folder.findFirst({ + where: { ownerId: userId, parentId: null, name: 'Root' }, + }); + + if (!root) { + root = await this.prisma.folder.create({ + data: { + ownerId: userId, + parentId: null, + name: 'Root', + logicalPath: '/', + }, + }); + } + + return root; + } + + /** + * List all folders belonging to a user + */ + async getUserFolders(userId: string) { + const folders = await this.prisma.folder.findMany({ + where: { ownerId: userId }, + orderBy: { name: 'asc' }, + include: { + _count: { + select: { files: { where: { isSoftDeleted: false } }, children: true }, + }, + }, + }); + + return folders.map((f) => ({ + id: f.id, + ownerId: f.ownerId, + parentId: f.parentId, + name: f.name, + logicalPath: f.logicalPath, + createdAt: f.createdAt, + updatedAt: f.updatedAt, + fileCount: f._count.files, + subfolderCount: f._count.children, + })); + } + + /** + * Get folder contents (breadcrumbs, subfolders, files) + */ + async getFolderContents(userId: string, userRole: string, folderId?: string) { + let targetFolder; + + if (!folderId || folderId === 'root') { + targetFolder = await this.getOrCreateRootFolder(userId); + } else { + targetFolder = await this.permissionsService.enforceFolderAccess(userId, userRole, folderId); + } + + // Build breadcrumbs + const breadcrumbs: { id: string; name: string }[] = []; + let current: any = targetFolder; + while (current) { + breadcrumbs.unshift({ id: current.id, name: current.name }); + if (current.parentId) { + current = await this.prisma.folder.findUnique({ where: { id: current.parentId } }); + } else { + break; + } + } + + // Get subfolders + const subfolders = await this.prisma.folder.findMany({ + where: { parentId: targetFolder.id }, + orderBy: { name: 'asc' }, + include: { + _count: { + select: { files: { where: { isSoftDeleted: false } }, children: true }, + }, + }, + }); + + // Get files in this folder + const files = await this.prisma.fileAsset.findMany({ + where: { + folderId: targetFolder.id, + isSoftDeleted: false, + }, + orderBy: { createdAt: 'desc' }, + include: { + owner: { select: { id: true, username: true, fullName: true, email: true, companyName: true } }, + }, + }); + + // Calculate permissions for the files + const enrichedFiles = await Promise.all( + files.map(async (file) => { + const perms = await this.permissionsService.getEffectiveFilePermissions( + userId, + userRole, + file, + ); + return { + id: file.id, + ownerId: file.ownerId, + ownerName: file.owner.fullName, + ownerEmail: file.owner.email, + ownerCompanyName: file.owner.companyName || 'Ecohub', + folderId: file.folderId, + originalFilename: file.originalFilename, + mimeType: file.mimeType, + fileExtension: file.fileExtension, + fileSizeBytes: file.fileSizeBytes.toString(), + fileCategory: file.fileCategory, + status: file.status, + durationSeconds: file.durationSeconds, + width: file.width, + height: file.height, + videoCodec: file.videoCodec, + audioCodec: file.audioCodec, + hasHlsStream: !!file.hlsMasterPlaylistKey, + createdAt: file.createdAt, + updatedAt: file.updatedAt, + permissions: perms, + }; + }), + ); + + return { + currentFolder: { + id: targetFolder.id, + name: targetFolder.name, + logicalPath: targetFolder.logicalPath, + ownerId: targetFolder.ownerId, + }, + breadcrumbs, + subfolders: subfolders.map((f) => ({ + id: f.id, + name: f.name, + logicalPath: f.logicalPath, + fileCount: f._count.files, + subfolderCount: f._count.children, + updatedAt: f.updatedAt, + })), + files: enrichedFiles, + }; + } + + /** + * Create a new folder + */ + async createFolder(userId: string, userRole: string, dto: CreateFolderDto) { + const isSuperOrAdmin = + userRole === UserRole.SUPER_ADMIN || + userRole === 'SUPER_ADMIN' || + userRole === UserRole.ADMIN || + userRole === 'ADMIN'; + + let parentFolder; + let targetOwnerId = userId; + + if (dto.parentId && dto.parentId !== 'root') { + parentFolder = await this.prisma.folder.findUnique({ + where: { id: dto.parentId }, + }); + if (!parentFolder) { + throw new NotFoundException('Parent folder not found'); + } + if (parentFolder.ownerId !== userId && !isSuperOrAdmin) { + throw new ForbiddenException('Parent folder unauthorized'); + } + targetOwnerId = parentFolder.ownerId; + } else { + parentFolder = await this.getOrCreateRootFolder(userId); + } + + // Check duplicate name in parent folder + const existing = await this.prisma.folder.findFirst({ + where: { + ownerId: targetOwnerId, + parentId: parentFolder.id, + name: dto.name.trim(), + }, + }); + if (existing) { + throw new ConflictException(`A folder named "${dto.name}" already exists in this directory`); + } + + const logicalPath = `${parentFolder.logicalPath === '/' ? '' : parentFolder.logicalPath}/${dto.name.trim()}`; + + const newFolder = await this.prisma.folder.create({ + data: { + ownerId: targetOwnerId, + parentId: parentFolder.id, + name: dto.name.trim(), + logicalPath, + }, + }); + + await this.auditService.log({ + actorUserId: userId, + action: 'FOLDER_CREATED', + resourceType: 'FOLDER', + resourceId: newFolder.id, + targetUserId: targetOwnerId, + details: { name: newFolder.name, logicalPath: newFolder.logicalPath }, + }); + + return newFolder; + } + + /** + * Rename folder + */ + async renameFolder(userId: string, userRole: string, folderId: string, dto: RenameFolderDto) { + const folder = await this.prisma.folder.findUnique({ where: { id: folderId } }); + if (!folder) { + throw new NotFoundException('Folder not found'); + } + + const isSuperOrAdmin = + userRole === UserRole.SUPER_ADMIN || + userRole === 'SUPER_ADMIN' || + userRole === UserRole.ADMIN || + userRole === 'ADMIN'; + + if (folder.ownerId !== userId && !isSuperOrAdmin) { + throw new ForbiddenException('Unauthorized to rename this folder'); + } + + if (folder.parentId === null) { + throw new BadRequestException('Cannot rename the root folder'); + } + + // Check duplicate name + const existing = await this.prisma.folder.findFirst({ + where: { + ownerId: folder.ownerId, + parentId: folder.parentId, + name: dto.name.trim(), + NOT: { id: folderId }, + }, + }); + if (existing) { + throw new ConflictException(`A folder named "${dto.name}" already exists in this directory`); + } + + const parent = await this.prisma.folder.findUnique({ where: { id: folder.parentId } }); + const logicalPath = `${parent?.logicalPath === '/' ? '' : parent?.logicalPath}/${dto.name.trim()}`; + + const updated = await this.prisma.folder.update({ + where: { id: folderId }, + data: { name: dto.name.trim(), logicalPath }, + }); + + await this.auditService.log({ + actorUserId: userId, + action: 'FOLDER_RENAMED', + resourceType: 'FOLDER', + resourceId: folderId, + targetUserId: folder.ownerId, + details: { oldName: folder.name, newName: updated.name }, + }); + + return updated; + } + + /** + * Delete folder + */ + async deleteFolder(userId: string, userRole: string, userCompanyName: string | undefined, folderId: string) { + const folder = await this.prisma.folder.findUnique({ + where: { id: folderId }, + include: { owner: { select: { id: true, companyName: true } } }, + }); + if (!folder) { + throw new NotFoundException('Folder not found'); + } + + if (folder.parentId === null) { + throw new BadRequestException('Cannot delete the root folder'); + } + + const isSuperAdmin = userRole === UserRole.SUPER_ADMIN || userRole === 'SUPER_ADMIN'; + const isAdmin = userRole === UserRole.ADMIN || userRole === 'ADMIN'; + + if (isSuperAdmin) { + // Super Admin has full unrestricted permission to delete any folder across all companies + } else if (isAdmin) { + // Admin cannot delete folders belonging to other companies + const adminCompany = (userCompanyName || 'Ecohub').trim().toLowerCase(); + const folderCompany = (folder.owner?.companyName || 'Ecohub').trim().toLowerCase(); + if (adminCompany !== folderCompany) { + throw new ForbiddenException( + 'Administrators cannot delete folders belonging to other companies. Only Super Admin has this permission.', + ); + } + } else { + // Regular user: can only delete their own folder if permitted + if (folder.ownerId !== userId) { + throw new ForbiddenException('You can only delete your own folders'); + } + const user = await this.prisma.user.findUnique({ + where: { id: userId }, + select: { canDeleteFiles: true }, + }); + if (!user?.canDeleteFiles) { + throw new ForbiddenException('You do not have permission to delete folders or files. Please contact an administrator.'); + } + } + + // Soft delete all files in this folder + await this.prisma.fileAsset.updateMany({ + where: { folderId, isSoftDeleted: false }, + data: { isSoftDeleted: true, deletedAt: new Date() }, + }); + + await this.prisma.folder.delete({ where: { id: folderId } }); + + await this.auditService.log({ + actorUserId: userId, + action: 'FOLDER_DELETED', + resourceType: 'FOLDER', + resourceId: folderId, + targetUserId: folder.ownerId, + details: { name: folder.name }, + }); + + return { success: true, message: 'Folder deleted successfully' }; + } + + /** + * Universal Company File Explorer + * 1st level: User's Company Name folders + * 2nd level: Inside Company -> Users & folders + * 3rd level: Inside User Folder -> Subfolders & Files + */ + async getCompanyExplorer( + userId: string, + userRole: string, + canViewOtherUsers?: boolean, + userCompanyName?: string, + allowedCompanies?: string | null, + companyName?: string, + folderId?: string, + ) { + const isSuperAdmin = userRole === UserRole.SUPER_ADMIN || userRole === 'SUPER_ADMIN'; + const isAdmin = userRole === UserRole.ADMIN || userRole === 'ADMIN'; + const isSuperOrAdmin = isSuperAdmin || isAdmin; + const myCompany = userCompanyName && userCompanyName.trim() ? userCompanyName.trim() : 'Ecohub'; + + // Parse list of companies the user is permitted to access + let allowedCompanyList: string[] | '*' = '*'; + if (!isSuperOrAdmin) { + if (allowedCompanies && allowedCompanies.trim() === '*') { + allowedCompanyList = '*'; + } else if (allowedCompanies && allowedCompanies.trim()) { + try { + const raw = allowedCompanies.trim(); + if (raw.startsWith('[') && raw.endsWith(']')) { + const parsed = JSON.parse(raw); + if (Array.isArray(parsed)) { + const set = new Set(parsed.map((s) => String(s).trim()).filter(Boolean)); + set.add(myCompany); + allowedCompanyList = Array.from(set); + } + } else { + const list = raw.split(',').map((s) => s.trim()).filter(Boolean); + if (!list.some((c) => c.toLowerCase() === myCompany.toLowerCase())) { + list.push(myCompany); + } + allowedCompanyList = list; + } + } catch { + allowedCompanyList = [myCompany]; + } + } else { + // By default, a non-admin only has access to their own company + allowedCompanyList = [myCompany]; + } + } + + const canAccessCompany = (targetComp: string) => { + if (isSuperOrAdmin || allowedCompanyList === '*') return true; + const target = targetComp.trim().toLowerCase(); + return (allowedCompanyList as string[]).some((c) => c.toLowerCase() === target); + }; + + const hasMultiCompanyAccess = isSuperOrAdmin || allowedCompanyList === '*' || (Array.isArray(allowedCompanyList) && allowedCompanyList.length > 1); + + // Case 1: Specific folderId is requested -> Browse that folder with company breadcrumbs + if (folderId && folderId !== 'root') { + const contents = await this.getFolderContents(userId, userRole, folderId); + const targetFolderOwner = await this.prisma.user.findUnique({ + where: { id: contents.currentFolder.ownerId }, + select: { id: true, fullName: true, companyName: true }, + }); + + const compName = targetFolderOwner?.companyName || 'Ecohub'; + + // Security check: Only allow access if user owns the folder or has access to this company + if (targetFolderOwner?.id !== userId && !canAccessCompany(compName)) { + throw new ForbiddenException(`You do not have permission to access folders from "${compName}" organization.`); + } + + const explorerBreadcrumbs = hasMultiCompanyAccess + ? [ + { id: '', name: 'Organizations & Companies' }, + { id: compName, name: compName, isCompany: true }, + ...contents.breadcrumbs, + ] + : [ + { id: compName, name: compName, isCompany: true }, + ...contents.breadcrumbs, + ]; + + return { + level: 'FOLDER_CONTENTS' as const, + companyName: compName, + currentFolder: contents.currentFolder, + breadcrumbs: explorerBreadcrumbs, + subfolders: contents.subfolders, + files: contents.files, + }; + } + + // Case 2: Specific Company is selected -> List Users & their root folders in that company + if (companyName && companyName.trim()) { + const trimmedCompany = companyName.trim(); + if (!canAccessCompany(trimmedCompany)) { + throw new ForbiddenException(`You do not have permission to access "${trimmedCompany}" organization.`); + } + + const userWhere: any = { + companyName: trimmedCompany, + status: UserStatus.ACTIVE, + }; + + // If user does not have permission to view other users and is in this company, they only see themselves; + // But if they have been granted access to this company or canViewOtherUsers or isSuperAdmin, they can see users in this company! + if (!isSuperOrAdmin && !canViewOtherUsers && !canAccessCompany(trimmedCompany)) { + userWhere.id = userId; + } + + const usersInCompany = await this.prisma.user.findMany({ + where: userWhere, + include: { + folders: { + where: { parentId: null }, + include: { + _count: { + select: { + files: { where: { isSoftDeleted: false } }, + children: true, + }, + }, + }, + }, + files: { + where: { isSoftDeleted: false }, + select: { id: true, fileSizeBytes: true }, + }, + }, + orderBy: { fullName: 'asc' }, + }); + + const usersList = usersInCompany.map((u) => { + const rootFolder = u.folders[0] || null; + const totalSize = u.files.reduce((acc, f) => acc + BigInt(f.fileSizeBytes), BigInt(0)); + return { + userId: u.id, + username: u.username, + fullName: u.fullName, + role: u.role, + rootFolderId: rootFolder ? rootFolder.id : null, + rootFolderName: u.fullName, + fileCount: u.files.length, + folderCount: rootFolder ? rootFolder._count.children : 0, + totalSizeBytes: totalSize.toString(), + }; + }); + + return { + level: 'COMPANY_USERS' as const, + companyName: trimmedCompany, + breadcrumbs: hasMultiCompanyAccess + ? [ + { id: '', name: 'Organizations & Companies' }, + { id: trimmedCompany, name: trimmedCompany, isCompany: true }, + ] + : [{ id: trimmedCompany, name: trimmedCompany, isCompany: true }], + subfolders: usersList.map((u) => ({ + id: u.rootFolderId || u.userId, + name: u.fullName, + logicalPath: `/${trimmedCompany}/${u.username}`, + fileCount: u.fileCount, + subfolderCount: u.folderCount, + isUserRoot: true, + userId: u.userId, + username: u.username, + })), + files: [], + users: usersList, + }; + } + + // Case 3: Root Level -> Show Companies the user has permission to access + const allUsers = await this.prisma.user.findMany({ + where: { status: UserStatus.ACTIVE }, + select: { + id: true, + companyName: true, + fullName: true, + files: { + where: { isSoftDeleted: false }, + select: { id: true, fileSizeBytes: true }, + }, + }, + }); + + const companyMap = new Map(); + + for (const u of allUsers) { + const comp = u.companyName && u.companyName.trim() ? u.companyName.trim() : 'Ecohub'; + + // Strictly filter out any company this user is not authorized to access! + if (!canAccessCompany(comp)) { + continue; + } + + const existing = companyMap.get(comp) || { userCount: 0, fileCount: 0, totalSizeBytes: BigInt(0) }; + existing.userCount += 1; + existing.fileCount += u.files.length; + for (const f of u.files) { + existing.totalSizeBytes += BigInt(f.fileSizeBytes); + } + companyMap.set(comp, existing); + } + + // Ensure authorized companies appear in list even if not yet populated with files + if (allowedCompanyList !== '*') { + for (const allowedComp of allowedCompanyList) { + if (!companyMap.has(allowedComp)) { + companyMap.set(allowedComp, { userCount: 0, fileCount: 0, totalSizeBytes: BigInt(0) }); + } + } + } + + const companies = Array.from(companyMap.entries()).map(([name, stats]) => ({ + name, + companyName: name, + userCount: stats.userCount, + fileCount: stats.fileCount, + totalSizeBytes: stats.totalSizeBytes.toString(), + })).sort((a, b) => a.name.localeCompare(b.name)); + + return { + level: 'COMPANIES' as const, + breadcrumbs: [{ id: '', name: 'Organizations & Companies' }], + subfolders: companies.map((c) => ({ + id: `company:${c.name}`, + name: c.name, + logicalPath: `/${c.name}`, + fileCount: c.fileCount, + subfolderCount: c.userCount, + isCompany: true, + companyName: c.name, + })), + files: [], + companies, + }; + } +} diff --git a/apps/backend/src/modules/permissions/dto/batch-permission.dto.ts b/apps/backend/src/modules/permissions/dto/batch-permission.dto.ts new file mode 100644 index 0000000..8c5e3f5 --- /dev/null +++ b/apps/backend/src/modules/permissions/dto/batch-permission.dto.ts @@ -0,0 +1,44 @@ +import { IsNotEmpty, IsString, IsArray, IsOptional, IsBoolean, IsDateString } from 'class-validator'; +import { ApiProperty } from '@nestjs/swagger'; + +export class BatchGrantPermissionDto { + @ApiProperty({ description: 'ID of user being granted permissions' }) + @IsNotEmpty() + @IsString() + granteeUserId: string; + + @ApiProperty({ description: 'List of File Asset IDs to grant access to', required: false, type: [String] }) + @IsOptional() + @IsArray() + fileIds?: string[]; + + @ApiProperty({ description: 'Optional owner ID whose files are all being granted at once', required: false }) + @IsOptional() + @IsString() + grantAllFilesOfOwner?: string; + + @ApiProperty({ default: true }) + @IsBoolean() + canViewMetadata: boolean; + + @ApiProperty({ default: false }) + @IsBoolean() + canPreview: boolean; + + @ApiProperty({ default: false }) + @IsBoolean() + canPlay: boolean; + + @ApiProperty({ default: false }) + @IsBoolean() + canDownload: boolean; + + @ApiProperty({ default: false }) + @IsBoolean() + canListFolder: boolean; + + @ApiProperty({ required: false }) + @IsOptional() + @IsDateString() + expiresAt?: string; +} diff --git a/apps/backend/src/modules/permissions/dto/permission.dto.ts b/apps/backend/src/modules/permissions/dto/permission.dto.ts new file mode 100644 index 0000000..2d90000 --- /dev/null +++ b/apps/backend/src/modules/permissions/dto/permission.dto.ts @@ -0,0 +1,81 @@ +import { IsBoolean, IsDateString, IsEnum, IsNotEmpty, IsOptional, IsString } from 'class-validator'; +import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger'; +import { PermissionResourceType } from '@prisma/client'; + +export class GrantPermissionDto { + @ApiProperty({ enum: PermissionResourceType, example: PermissionResourceType.FILE }) + @IsEnum(PermissionResourceType) + resourceType: PermissionResourceType; + + @ApiPropertyOptional({ example: 'uuid-of-file-or-folder', description: 'File ID or Folder ID (null for USER_FILES)' }) + @IsOptional() + @IsString() + resourceId?: string; + + @ApiProperty({ example: 'uuid-of-owner-user', description: 'Owner of the resource' }) + @IsNotEmpty() + @IsString() + ownerId: string; + + @ApiProperty({ example: 'uuid-of-grantee-user', description: 'User receiving access' }) + @IsNotEmpty() + @IsString() + granteeUserId: string; + + @ApiProperty({ default: true }) + @IsBoolean() + canViewMetadata: boolean; + + @ApiProperty({ default: false }) + @IsBoolean() + canPreview: boolean; + + @ApiProperty({ default: false }) + @IsBoolean() + canPlay: boolean; + + @ApiProperty({ default: false }) + @IsBoolean() + canDownload: boolean; + + @ApiProperty({ default: false }) + @IsBoolean() + canListFolder: boolean; + + @ApiPropertyOptional({ example: '2026-12-31T23:59:59Z' }) + @IsOptional() + @IsDateString() + expiresAt?: string; +} + +export class UpdatePermissionDto { + @ApiPropertyOptional() + @IsOptional() + @IsBoolean() + canViewMetadata?: boolean; + + @ApiPropertyOptional() + @IsOptional() + @IsBoolean() + canPreview?: boolean; + + @ApiPropertyOptional() + @IsOptional() + @IsBoolean() + canPlay?: boolean; + + @ApiPropertyOptional() + @IsOptional() + @IsBoolean() + canDownload?: boolean; + + @ApiPropertyOptional() + @IsOptional() + @IsBoolean() + canListFolder?: boolean; + + @ApiPropertyOptional() + @IsOptional() + @IsDateString() + expiresAt?: string; +} diff --git a/apps/backend/src/modules/permissions/permissions.controller.ts b/apps/backend/src/modules/permissions/permissions.controller.ts new file mode 100644 index 0000000..8167c44 --- /dev/null +++ b/apps/backend/src/modules/permissions/permissions.controller.ts @@ -0,0 +1,105 @@ +import { + Controller, + Post, + Get, + Patch, + Delete, + Param, + Body, + Query, + UseGuards, +} from '@nestjs/common'; +import { ApiTags, ApiOperation, ApiBearerAuth, ApiQuery } from '@nestjs/swagger'; +import { PermissionsService } from './permissions.service'; +import { GrantPermissionDto, UpdatePermissionDto } from './dto/permission.dto'; +import { BatchGrantPermissionDto } from './dto/batch-permission.dto'; +import { JwtAuthGuard } from '../auth/guards/jwt-auth.guard'; +import { RolesGuard } from '../auth/guards/roles.guard'; +import { Roles } from '../auth/decorators/roles.decorator'; +import { CurrentUser, AuthenticatedUser } from '../auth/decorators/current-user.decorator'; +import { UserRole, PermissionResourceType } from '@prisma/client'; + +@ApiTags('Admin - Permissions Management') +@ApiBearerAuth() +@UseGuards(JwtAuthGuard, RolesGuard) +@Roles(UserRole.SUPER_ADMIN, UserRole.ADMIN) +@Controller('admin/permissions') +export class PermissionsController { + constructor(private readonly permissionsService: PermissionsService) {} + + @Post() + @ApiOperation({ summary: 'Grant granular file, folder, or user-level permissions to another user' }) + async grantPermission( + @Body() dto: GrantPermissionDto, + @CurrentUser() user: AuthenticatedUser, + ) { + return this.permissionsService.grantPermission(dto, user.id); + } + + @Post('batch') + @ApiOperation({ summary: 'Batch grant permissions across 1-by-1 selected files or all files of an owner' }) + async grantBatchPermissions( + @Body() dto: BatchGrantPermissionDto, + @CurrentUser() user: AuthenticatedUser, + ) { + return this.permissionsService.grantBatchPermissions(dto, user.id); + } + + @Get() + @ApiOperation({ summary: 'List and filter granted permissions across the system' }) + @ApiQuery({ name: 'ownerId', required: false }) + @ApiQuery({ name: 'granteeUserId', required: false }) + @ApiQuery({ name: 'resourceType', enum: PermissionResourceType, required: false }) + @ApiQuery({ name: 'activeOnly', required: false, type: Boolean }) + @ApiQuery({ name: 'page', required: false, type: Number }) + @ApiQuery({ name: 'limit', required: false, type: Number }) + async listPermissions( + @CurrentUser() user: AuthenticatedUser, + @Query('ownerId') ownerId?: string, + @Query('granteeUserId') granteeUserId?: string, + @Query('resourceType') resourceType?: PermissionResourceType, + @Query('activeOnly') activeOnly?: string, + @Query('page') page?: string, + @Query('limit') limit?: string, + ) { + return this.permissionsService.listPermissions({ + ownerId, + granteeUserId, + resourceType, + activeOnly: activeOnly === 'true', + page: page ? parseInt(page, 10) : 1, + limit: limit ? parseInt(limit, 10) : 50, + requesterId: user.id, + requesterRole: user.role, + canViewOtherUsers: user.canViewOtherUsers, + }); + } + + @Patch(':id') + @ApiOperation({ summary: 'Update an existing permission record' }) + async updatePermission( + @Param('id') id: string, + @Body() dto: UpdatePermissionDto, + @CurrentUser() user: AuthenticatedUser, + ) { + return this.permissionsService.updatePermission(id, dto, user.id); + } + + @Post(':id/revoke') + @ApiOperation({ summary: 'Revoke a permission immediately, denying subsequent access' }) + async revokePermission( + @Param('id') id: string, + @CurrentUser() user: AuthenticatedUser, + ) { + return this.permissionsService.revokePermission(id, user.id); + } + + @Delete(':id') + @ApiOperation({ summary: 'Permanently remove a permission record' }) + async deletePermission( + @Param('id') id: string, + @CurrentUser() user: AuthenticatedUser, + ) { + return this.permissionsService.deletePermission(id, user.id); + } +} diff --git a/apps/backend/src/modules/permissions/permissions.module.ts b/apps/backend/src/modules/permissions/permissions.module.ts new file mode 100644 index 0000000..64e6d16 --- /dev/null +++ b/apps/backend/src/modules/permissions/permissions.module.ts @@ -0,0 +1,11 @@ +import { Global, Module } from '@nestjs/common'; +import { PermissionsService } from './permissions.service'; +import { PermissionsController } from './permissions.controller'; + +@Global() +@Module({ + controllers: [PermissionsController], + providers: [PermissionsService], + exports: [PermissionsService], +}) +export class PermissionsModule {} diff --git a/apps/backend/src/modules/permissions/permissions.service.ts b/apps/backend/src/modules/permissions/permissions.service.ts new file mode 100644 index 0000000..a6ff9b3 --- /dev/null +++ b/apps/backend/src/modules/permissions/permissions.service.ts @@ -0,0 +1,529 @@ +import { + Injectable, + NotFoundException, + ForbiddenException, + BadRequestException, + Logger, +} from '@nestjs/common'; +import { PrismaService } from '../prisma/prisma.service'; +import { AuditService } from '../audit/audit.service'; +import { GrantPermissionDto, UpdatePermissionDto } from './dto/permission.dto'; +import { BatchGrantPermissionDto } from './dto/batch-permission.dto'; +import { UserRole, PermissionResourceType, FileAsset, Folder, FileCategory } from '@prisma/client'; + +export interface EffectiveFilePermissions { + canViewMetadata: boolean; + canPreview: boolean; + canPlay: boolean; + canDownload: boolean; + canListFolder: boolean; +} + +@Injectable() +export class PermissionsService { + private readonly logger = new Logger(PermissionsService.name); + + constructor( + private readonly prisma: PrismaService, + private readonly auditService: AuditService, + ) {} + + /** + * Evaluate effective permissions for a user on a given file. + */ + async getEffectiveFilePermissions( + userId: string, + userRole: string, + file: FileAsset, + canViewOtherUsers?: boolean, + ): Promise { + const isSuperAdmin = userRole === UserRole.SUPER_ADMIN || userRole === 'SUPER_ADMIN'; + const isAdmin = userRole === UserRole.ADMIN || userRole === 'ADMIN'; + // 1. Super Admin, Admin, and authorized users with canViewOtherUsers have administrative access to download and play all files user-wise + if (isSuperAdmin || isAdmin || canViewOtherUsers) { + return { + canViewMetadata: true, + canPreview: true, + canPlay: true, + canDownload: true, + canListFolder: true, + }; + } + + // 2. Owner permissions: + // If the file is a VIDEO: normal user can watch/play it ("onno user sudu tar video e dekhte parbe"), + // but CANNOT download unless an explicit permission has been granted by superadmin! + if (file.ownerId === userId) { + if (file.fileCategory === FileCategory.VIDEO) { + // Check if there is an active explicit grant giving canDownload to this user + const directGrant = await this.prisma.filePermission.findFirst({ + where: { + granteeUserId: userId, + revokedAt: null, + canDownload: true, + OR: [ + { resourceType: PermissionResourceType.FILE, resourceId: file.id }, + { resourceType: PermissionResourceType.USER_FILES, ownerId: file.ownerId }, + ], + AND: [ + { + OR: [{ expiresAt: null }, { expiresAt: { gt: new Date() } }], + }, + ], + }, + }); + + return { + canViewMetadata: true, + canPreview: true, + canPlay: true, + canDownload: !!directGrant, + canListFolder: true, + }; + } + + // Non-video files (documents, images, audio) can be downloaded by owner + return { + canViewMetadata: true, + canPreview: true, + canPlay: true, + canDownload: true, + canListFolder: true, + }; + } + + const now = new Date(); + + // 3. Collect all relevant permission candidates: + // a) Direct File permission + // b) Folder permission (if file belongs to a folder) + // c) Broad user-level files permission + const candidateConditions: any[] = [ + { + resourceType: PermissionResourceType.FILE, + resourceId: file.id, + }, + { + resourceType: PermissionResourceType.USER_FILES, + ownerId: file.ownerId, + }, + ]; + + if (file.folderId) { + candidateConditions.push({ + resourceType: PermissionResourceType.FOLDER, + resourceId: file.folderId, + }); + } + + const permissions = await this.prisma.filePermission.findMany({ + where: { + granteeUserId: userId, + revokedAt: null, + OR: candidateConditions, + AND: [ + { + OR: [{ expiresAt: null }, { expiresAt: { gt: now } }], + }, + ], + }, + }); + + if (permissions.length === 0) { + return { + canViewMetadata: false, + canPreview: false, + canPlay: false, + canDownload: false, + canListFolder: false, + }; + } + + // Aggregate permissions (any active grant that enables the action gives access) + return { + canViewMetadata: permissions.some((p) => p.canViewMetadata), + canPreview: permissions.some((p) => p.canPreview), + canPlay: permissions.some((p) => p.canPlay), + canDownload: permissions.some((p) => p.canDownload), + canListFolder: permissions.some((p) => p.canListFolder), + }; + } + + /** + * Enforce access to a file for a specific action + */ + async enforceFileAccess( + userId: string, + userRole: string, + fileId: string, + action: 'canViewMetadata' | 'canPreview' | 'canPlay' | 'canDownload', + canViewOtherUsers?: boolean, + ): Promise { + const file = await this.prisma.fileAsset.findUnique({ + where: { id: fileId }, + }); + + if (!file || file.isSoftDeleted) { + throw new NotFoundException('File not found or has been deleted'); + } + + const perms = await this.getEffectiveFilePermissions(userId, userRole, file, canViewOtherUsers); + + if (!perms[action]) { + this.logger.warn(`Access denied: User ${userId} requested ${action} on file ${fileId}`); + throw new ForbiddenException(`You do not have permission to perform this action (${action}) on this file`); + } + + // If Super Admin or Admin or authorized user accessed another user's file, audit the event + const isSuperAdmin = userRole === UserRole.SUPER_ADMIN || userRole === 'SUPER_ADMIN'; + const isAdmin = userRole === UserRole.ADMIN || userRole === 'ADMIN'; + if ((isSuperAdmin || isAdmin || canViewOtherUsers) && file.ownerId !== userId) { + await this.auditService.log({ + actorUserId: userId, + action: `${isSuperAdmin ? 'SUPER_ADMIN' : 'ADMIN'}_ACCESSED_${action.toUpperCase()}`, + resourceType: 'FILE', + resourceId: file.id, + targetUserId: file.ownerId, + details: { filename: file.originalFilename }, + }); + } + + return file; + } + + /** + * Evaluate folder access + */ + async enforceFolderAccess( + userId: string, + userRole: string, + folderId: string, + canViewOtherUsers?: boolean, + ): Promise { + const folder = await this.prisma.folder.findUnique({ + where: { id: folderId }, + }); + + if (!folder) { + throw new NotFoundException('Folder not found'); + } + + const isSuperAdmin = userRole === UserRole.SUPER_ADMIN || userRole === 'SUPER_ADMIN'; + const isAdmin = userRole === UserRole.ADMIN || userRole === 'ADMIN'; + if (folder.ownerId === userId || isSuperAdmin || isAdmin || canViewOtherUsers) { + return folder; + } + + const now = new Date(); + const permission = await this.prisma.filePermission.findFirst({ + where: { + granteeUserId: userId, + revokedAt: null, + OR: [ + { resourceType: PermissionResourceType.FOLDER, resourceId: folderId }, + { resourceType: PermissionResourceType.USER_FILES, ownerId: folder.ownerId }, + ], + AND: [ + { + OR: [{ expiresAt: null }, { expiresAt: { gt: now } }], + }, + ], + }, + }); + + if (!permission || !permission.canListFolder) { + throw new ForbiddenException('You do not have permission to access this folder'); + } + + return folder; + } + + /** + * Grant permission (Admin / Super Admin action) + */ + async grantPermission(dto: GrantPermissionDto, grantedByUserId: string) { + if (dto.ownerId === dto.granteeUserId) { + throw new BadRequestException('Cannot grant permissions to the owner of the resource'); + } + + // Verify owner and grantee exist + const [owner, grantee] = await Promise.all([ + this.prisma.user.findUnique({ where: { id: dto.ownerId } }), + this.prisma.user.findUnique({ where: { id: dto.granteeUserId } }), + ]); + + if (!owner) throw new NotFoundException('Resource owner user not found'); + if (!grantee) throw new NotFoundException('Grantee user not found'); + + // Verify resource exists if specific ID provided + if (dto.resourceType === PermissionResourceType.FILE && dto.resourceId) { + const file = await this.prisma.fileAsset.findUnique({ where: { id: dto.resourceId } }); + if (!file || file.ownerId !== dto.ownerId) { + throw new NotFoundException('Specified file does not exist or does not belong to the owner'); + } + } else if (dto.resourceType === PermissionResourceType.FOLDER && dto.resourceId) { + const folder = await this.prisma.folder.findUnique({ where: { id: dto.resourceId } }); + if (!folder || folder.ownerId !== dto.ownerId) { + throw new NotFoundException('Specified folder does not exist or does not belong to the owner'); + } + } + + const permission = await this.prisma.filePermission.create({ + data: { + resourceType: dto.resourceType, + resourceId: dto.resourceId || null, + ownerId: dto.ownerId, + granteeUserId: dto.granteeUserId, + grantedByUserId, + canViewMetadata: dto.canViewMetadata, + canPreview: dto.canPreview, + canPlay: dto.canPlay, + canDownload: dto.canDownload, + canListFolder: dto.canListFolder, + expiresAt: dto.expiresAt ? new Date(dto.expiresAt) : null, + }, + include: { + owner: { select: { id: true, username: true, email: true, fullName: true } }, + grantee: { select: { id: true, username: true, email: true, fullName: true } }, + grantedBy: { select: { id: true, username: true, email: true, fullName: true } }, + }, + }); + + await this.auditService.log({ + actorUserId: grantedByUserId, + action: 'PERMISSION_GRANTED', + resourceType: 'PERMISSION', + resourceId: permission.id, + targetUserId: dto.granteeUserId, + details: { + resourceType: dto.resourceType, + resourceId: dto.resourceId, + ownerId: dto.ownerId, + canPlay: dto.canPlay, + canDownload: dto.canDownload, + canPreview: dto.canPreview, + }, + }); + + return permission; + } + + /** + * Batch Grant Permissions: + * Super Admin / Admin can select 1-by-1 (fileIds) OR grant all files of an owner at once. + */ + async grantBatchPermissions(dto: BatchGrantPermissionDto, grantedByUserId: string) { + const grantee = await this.prisma.user.findUnique({ where: { id: dto.granteeUserId } }); + if (!grantee) throw new NotFoundException('Grantee user not found'); + + const createdGrants: any[] = []; + + // Mode A: Grant all files of owner at once + if (dto.grantAllFilesOfOwner) { + const userLevelPerm = await this.prisma.filePermission.create({ + data: { + resourceType: PermissionResourceType.USER_FILES, + resourceId: null, + ownerId: dto.grantAllFilesOfOwner, + granteeUserId: dto.granteeUserId, + grantedByUserId, + canViewMetadata: dto.canViewMetadata, + canPreview: dto.canPreview, + canPlay: dto.canPlay, + canDownload: dto.canDownload, + canListFolder: dto.canListFolder, + expiresAt: dto.expiresAt ? new Date(dto.expiresAt) : null, + }, + }); + createdGrants.push(userLevelPerm); + } + + // Mode B: Grant 1-by-1 or multi-selected files + if (dto.fileIds && dto.fileIds.length > 0) { + const files = await this.prisma.fileAsset.findMany({ + where: { id: { in: dto.fileIds }, isSoftDeleted: false }, + }); + + for (const file of files) { + const filePerm = await this.prisma.filePermission.create({ + data: { + resourceType: PermissionResourceType.FILE, + resourceId: file.id, + ownerId: file.ownerId, + granteeUserId: dto.granteeUserId, + grantedByUserId, + canViewMetadata: dto.canViewMetadata, + canPreview: dto.canPreview, + canPlay: dto.canPlay, + canDownload: dto.canDownload, + canListFolder: dto.canListFolder, + expiresAt: dto.expiresAt ? new Date(dto.expiresAt) : null, + }, + }); + createdGrants.push(filePerm); + } + } + + await this.auditService.log({ + actorUserId: grantedByUserId, + action: 'BATCH_PERMISSIONS_GRANTED', + resourceType: 'PERMISSION', + targetUserId: dto.granteeUserId, + details: { + grantsCount: createdGrants.length, + grantAllFilesOfOwner: dto.grantAllFilesOfOwner, + fileCount: dto.fileIds?.length || 0, + canDownload: dto.canDownload, + canPlay: dto.canPlay, + }, + }); + + return { + success: true, + count: createdGrants.length, + grants: createdGrants, + }; + } + + /** + * List permissions with pagination and filters + */ + async listPermissions(params: { + ownerId?: string; + granteeUserId?: string; + resourceType?: PermissionResourceType; + activeOnly?: boolean; + page?: number; + limit?: number; + requesterId?: string; + requesterRole?: UserRole | string; + canViewOtherUsers?: boolean; + }) { + const isSuperAdmin = params.requesterRole === UserRole.SUPER_ADMIN || params.requesterRole === 'SUPER_ADMIN'; + const canViewAll = isSuperAdmin || !!params.canViewOtherUsers; + + const page = params.page || 1; + const limit = params.limit || 50; + const skip = (page - 1) * limit; + + const where: any = {}; + if (params.ownerId) where.ownerId = params.ownerId; + if (params.granteeUserId) where.granteeUserId = params.granteeUserId; + if (params.resourceType) where.resourceType = params.resourceType; + + if (!canViewAll && params.requesterId) { + where.AND = [ + ...(where.AND || []), + { + OR: [ + { ownerId: params.requesterId }, + { granteeUserId: params.requesterId }, + ], + }, + ]; + } + + if (params.activeOnly) { + const now = new Date(); + where.revokedAt = null; + where.OR = [{ expiresAt: null }, { expiresAt: { gt: now } }]; + } + + const [total, permissions] = await Promise.all([ + this.prisma.filePermission.count({ where }), + this.prisma.filePermission.findMany({ + where, + take: limit, + skip, + orderBy: { createdAt: 'desc' }, + include: { + owner: { select: { id: true, username: true, email: true, fullName: true } }, + grantee: { select: { id: true, username: true, email: true, fullName: true } }, + grantedBy: { select: { id: true, username: true, email: true, fullName: true } }, + }, + }), + ]); + + return { total, page, limit, permissions }; + } + + /** + * Update permission + */ + async updatePermission(id: string, dto: UpdatePermissionDto, updatedByUserId: string) { + const existing = await this.prisma.filePermission.findUnique({ where: { id } }); + if (!existing) { + throw new NotFoundException('Permission record not found'); + } + + const updated = await this.prisma.filePermission.update({ + where: { id }, + data: { + canViewMetadata: dto.canViewMetadata ?? existing.canViewMetadata, + canPreview: dto.canPreview ?? existing.canPreview, + canPlay: dto.canPlay ?? existing.canPlay, + canDownload: dto.canDownload ?? existing.canDownload, + canListFolder: dto.canListFolder ?? existing.canListFolder, + expiresAt: dto.expiresAt !== undefined ? (dto.expiresAt ? new Date(dto.expiresAt) : null) : existing.expiresAt, + }, + }); + + await this.auditService.log({ + actorUserId: updatedByUserId, + action: 'PERMISSION_UPDATED', + resourceType: 'PERMISSION', + resourceId: id, + targetUserId: existing.granteeUserId, + details: dto, + }); + + return updated; + } + + /** + * Revoke permission immediately + */ + async revokePermission(id: string, revokedByUserId: string) { + const existing = await this.prisma.filePermission.findUnique({ where: { id } }); + if (!existing) { + throw new NotFoundException('Permission record not found'); + } + + const revoked = await this.prisma.filePermission.update({ + where: { id }, + data: { revokedAt: new Date() }, + }); + + await this.auditService.log({ + actorUserId: revokedByUserId, + action: 'PERMISSION_REVOKED', + resourceType: 'PERMISSION', + resourceId: id, + targetUserId: existing.granteeUserId, + }); + + return revoked; + } + + /** + * Delete permission record permanently + */ + async deletePermission(id: string, deletedByUserId: string) { + const existing = await this.prisma.filePermission.findUnique({ where: { id } }); + if (!existing) { + throw new NotFoundException('Permission record not found'); + } + + await this.prisma.filePermission.delete({ where: { id } }); + + await this.auditService.log({ + actorUserId: deletedByUserId, + action: 'PERMISSION_DELETED', + resourceType: 'PERMISSION', + resourceId: id, + targetUserId: existing.granteeUserId, + }); + + return { success: true, message: 'Permission record permanently deleted' }; + } +} diff --git a/apps/backend/src/modules/prisma/prisma.module.ts b/apps/backend/src/modules/prisma/prisma.module.ts new file mode 100644 index 0000000..7207426 --- /dev/null +++ b/apps/backend/src/modules/prisma/prisma.module.ts @@ -0,0 +1,9 @@ +import { Global, Module } from '@nestjs/common'; +import { PrismaService } from './prisma.service'; + +@Global() +@Module({ + providers: [PrismaService], + exports: [PrismaService], +}) +export class PrismaModule {} diff --git a/apps/backend/src/modules/prisma/prisma.service.ts b/apps/backend/src/modules/prisma/prisma.service.ts new file mode 100644 index 0000000..bb6565f --- /dev/null +++ b/apps/backend/src/modules/prisma/prisma.service.ts @@ -0,0 +1,13 @@ +import { Injectable, OnModuleInit, OnModuleDestroy } from '@nestjs/common'; +import { PrismaClient } from '@prisma/client'; + +@Injectable() +export class PrismaService extends PrismaClient implements OnModuleInit, OnModuleDestroy { + async onModuleInit() { + await this.$connect(); + } + + async onModuleDestroy() { + await this.$disconnect(); + } +} diff --git a/apps/backend/src/modules/share-links/dto/create-share-link.dto.ts b/apps/backend/src/modules/share-links/dto/create-share-link.dto.ts new file mode 100644 index 0000000..380c207 --- /dev/null +++ b/apps/backend/src/modules/share-links/dto/create-share-link.dto.ts @@ -0,0 +1,40 @@ +import { IsEnum, IsOptional, IsString, IsBoolean, IsInt, Min } from 'class-validator'; +import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger'; +import { ShareResourceType } from '@prisma/client'; + +export class CreateShareLinkDto { + @ApiProperty({ enum: ShareResourceType, example: 'FILE' }) + @IsEnum(ShareResourceType) + resourceType: ShareResourceType; + + @ApiPropertyOptional({ example: 'uuid-of-file' }) + @IsOptional() + @IsString() + fileId?: string; + + @ApiPropertyOptional({ example: 'uuid-of-folder' }) + @IsOptional() + @IsString() + folderId?: string; + + @ApiPropertyOptional({ example: 'Project Demo Link' }) + @IsOptional() + @IsString() + title?: string; + + @ApiPropertyOptional({ example: true, default: true }) + @IsOptional() + @IsBoolean() + allowDownload?: boolean; + + @ApiPropertyOptional({ example: 'SecretPass123' }) + @IsOptional() + @IsString() + password?: string; + + @ApiPropertyOptional({ example: 7, description: 'Expiry in days' }) + @IsOptional() + @IsInt() + @Min(1) + expiresInDays?: number; +} diff --git a/apps/backend/src/modules/share-links/share-links.controller.ts b/apps/backend/src/modules/share-links/share-links.controller.ts new file mode 100644 index 0000000..7127565 --- /dev/null +++ b/apps/backend/src/modules/share-links/share-links.controller.ts @@ -0,0 +1,163 @@ +import { + Controller, + Post, + Get, + Delete, + Param, + Body, + Query, + Headers, + Req, + Res, + UseGuards, + HttpCode, + HttpStatus, +} from '@nestjs/common'; +import { ApiTags, ApiOperation, ApiBearerAuth, ApiQuery } from '@nestjs/swagger'; +import { Request, Response } from 'express'; +import { ShareLinksService } from './share-links.service'; +import { CreateShareLinkDto } from './dto/create-share-link.dto'; +import { JwtAuthGuard } from '../auth/guards/jwt-auth.guard'; +import { CurrentUser, AuthenticatedUser } from '../auth/decorators/current-user.decorator'; + +@ApiTags('Public & Drive-like Share Links') +@Controller('share-links') +export class ShareLinksController { + constructor(private readonly shareLinksService: ShareLinksService) {} + + @Post() + @UseGuards(JwtAuthGuard) + @ApiBearerAuth() + @ApiOperation({ summary: 'Create a Google Drive-like share link for a file or folder' }) + async createShareLink( + @CurrentUser() user: AuthenticatedUser, + @Body() dto: CreateShareLinkDto, + @Req() req: Request, + ) { + return this.shareLinksService.createShareLink( + user.id, + user.role, + dto, + req.ip, + req.headers['user-agent'], + ); + } + + @Get() + @UseGuards(JwtAuthGuard) + @ApiBearerAuth() + @ApiOperation({ summary: 'Get all active share links created by current user' }) + async getMyShareLinks(@CurrentUser() user: AuthenticatedUser) { + return this.shareLinksService.getMyShareLinks(user.id); + } + + @Delete(':id') + @UseGuards(JwtAuthGuard) + @ApiBearerAuth() + @ApiOperation({ summary: 'Revoke a share link' }) + async revokeShareLink( + @Param('id') id: string, + @CurrentUser() user: AuthenticatedUser, + ) { + return this.shareLinksService.revokeShareLink(user.id, user.role, id); + } + + // ========================================================================= + // PUBLIC ROUTES (Unauthenticated access to shared resource only) + // ========================================================================= + + @Get('public/:token') + @ApiOperation({ summary: 'Access shared file or folder resource metadata (Public)' }) + @ApiQuery({ name: 'password', required: false }) + @ApiQuery({ name: 'subfolderId', required: false }) + async getPublicResource( + @Param('token') token: string, + @Query('password') password?: string, + @Query('subfolderId') subfolderId?: string, + ) { + return this.shareLinksService.getPublicResource(token, password, subfolderId); + } + + @Get('public/:token/playback') + @ApiOperation({ summary: 'Stream shared video directly with range support (Public)' }) + @ApiQuery({ name: 'fileId', required: false }) + @ApiQuery({ name: 'password', required: false }) + async streamPublicVideo( + @Param('token') token: string, + @Headers('range') rangeHeader: string, + @Res() res: Response, + @Query('fileId') fileId?: string, + @Query('password') password?: string, + ) { + const result = await this.shareLinksService.streamPublicVideo( + token, + fileId, + rangeHeader, + password, + ); + + if (result.isRange) { + res.writeHead(206, { + 'Content-Range': `bytes ${result.start}-${result.end}/${result.totalSize}`, + 'Accept-Ranges': 'bytes', + 'Content-Length': result.chunkSize, + 'Content-Type': result.mimeType, + 'Cache-Control': 'no-cache, private', + }); + } else { + res.writeHead(200, { + 'Content-Length': result.totalSize, + 'Content-Type': result.mimeType, + 'Accept-Ranges': 'bytes', + }); + } + + result.stream.pipe(res); + } + + @Get('public/:token/thumbnail') + @ApiOperation({ summary: 'Get shared file thumbnail image (Public)' }) + @ApiQuery({ name: 'fileId', required: false }) + @ApiQuery({ name: 'password', required: false }) + async getPublicThumbnail( + @Param('token') token: string, + @Res() res: Response, + @Query('fileId') fileId?: string, + @Query('password') password?: string, + ) { + const { stream, contentType } = await this.shareLinksService.getPublicThumbnail( + token, + fileId, + password, + ); + res.setHeader('Content-Type', contentType || 'image/jpeg'); + res.setHeader('Cache-Control', 'public, max-age=86400'); + stream.pipe(res); + } + + @Get('public/:token/download') + @ApiOperation({ summary: 'Download shared file (Public)' }) + @ApiQuery({ name: 'fileId', required: false }) + @ApiQuery({ name: 'password', required: false }) + async downloadPublicFile( + @Param('token') token: string, + @Res() res: Response, + @Query('fileId') fileId?: string, + @Query('password') password?: string, + ) { + const { stream, file, contentType } = await this.shareLinksService.downloadPublicFile( + token, + fileId, + password, + ); + + res.setHeader('Content-Type', contentType); + res.setHeader( + 'Content-Disposition', + `attachment; filename="${encodeURIComponent(file.originalFilename)}"`, + ); + res.setHeader('Content-Length', file.fileSizeBytes.toString()); + + stream.pipe(res); + } +} diff --git a/apps/backend/src/modules/share-links/share-links.module.ts b/apps/backend/src/modules/share-links/share-links.module.ts new file mode 100644 index 0000000..168f5c2 --- /dev/null +++ b/apps/backend/src/modules/share-links/share-links.module.ts @@ -0,0 +1,14 @@ +import { Module } from '@nestjs/common'; +import { ShareLinksController } from './share-links.controller'; +import { ShareLinksService } from './share-links.service'; +import { PrismaModule } from '../prisma/prisma.module'; +import { AuditModule } from '../audit/audit.module'; +import { StorageModule } from '../storage/storage.module'; + +@Module({ + imports: [PrismaModule, AuditModule, StorageModule], + controllers: [ShareLinksController], + providers: [ShareLinksService], + exports: [ShareLinksService], +}) +export class ShareLinksModule {} diff --git a/apps/backend/src/modules/share-links/share-links.service.ts b/apps/backend/src/modules/share-links/share-links.service.ts new file mode 100644 index 0000000..e135ab0 --- /dev/null +++ b/apps/backend/src/modules/share-links/share-links.service.ts @@ -0,0 +1,583 @@ +import { + Injectable, + NotFoundException, + ForbiddenException, + BadRequestException, + UnauthorizedException, + Inject, +} from '@nestjs/common'; +import { PrismaService } from '../prisma/prisma.service'; +import { AuditService } from '../audit/audit.service'; +import { STORAGE_PROVIDER, IStorageProvider } from '../storage/storage.interface'; +import { CreateShareLinkDto } from './dto/create-share-link.dto'; +import { ShareResourceType, UserRole } from '@prisma/client'; +import * as crypto from 'crypto'; +import * as argon2 from 'argon2'; + +@Injectable() +export class ShareLinksService { + constructor( + private readonly prisma: PrismaService, + private readonly auditService: AuditService, + @Inject(STORAGE_PROVIDER) private readonly storageProvider: IStorageProvider, + ) {} + + /** + * Create a Google Drive-like share link + */ + async createShareLink( + userId: string, + userRole: string, + dto: CreateShareLinkDto, + ipAddress?: string, + userAgent?: string, + ) { + // 1. Verify user has permission to create share links (Superadmin decides who can share) + if (userRole !== UserRole.SUPER_ADMIN && userRole !== UserRole.ADMIN) { + const user = await this.prisma.user.findUnique({ + where: { id: userId }, + select: { canCreateShareLinks: true }, + }); + if (!user?.canCreateShareLinks) { + throw new ForbiddenException( + 'You do not have permission to create share links. Please contact an administrator.', + ); + } + } + + let fileId: string | null = null; + let folderId: string | null = null; + let defaultTitle = dto.title?.trim() || ''; + + // 2. Validate Resource & Ownership + if (dto.resourceType === ShareResourceType.FILE) { + if (!dto.fileId) { + throw new BadRequestException('fileId is required when sharing a file'); + } + const file = await this.prisma.fileAsset.findUnique({ + where: { id: dto.fileId }, + }); + if (!file || file.isSoftDeleted) { + throw new NotFoundException('File not found or has been deleted'); + } + if (file.ownerId !== userId && userRole !== UserRole.SUPER_ADMIN && userRole !== UserRole.ADMIN) { + throw new ForbiddenException('You can only create share links for your own files'); + } + fileId = file.id; + if (!defaultTitle) defaultTitle = file.originalFilename; + } else if (dto.resourceType === ShareResourceType.FOLDER) { + if (!dto.folderId) { + throw new BadRequestException('folderId is required when sharing a folder'); + } + const folder = await this.prisma.folder.findUnique({ + where: { id: dto.folderId }, + }); + if (!folder) { + throw new NotFoundException('Folder not found'); + } + if (folder.ownerId !== userId && userRole !== UserRole.SUPER_ADMIN && userRole !== UserRole.ADMIN) { + throw new ForbiddenException('You can only create share links for your own folders'); + } + folderId = folder.id; + if (!defaultTitle) defaultTitle = folder.name; + } else { + throw new BadRequestException('Invalid resource type'); + } + + // 3. Password hashing (if password protected) + let passwordHash: string | null = null; + if (dto.password && dto.password.trim()) { + passwordHash = await argon2.hash(dto.password.trim(), { type: argon2.argon2id }); + } + + // 4. Calculate expiry + let expiresAt: Date | null = null; + if (dto.expiresInDays && dto.expiresInDays > 0) { + expiresAt = new Date(Date.now() + dto.expiresInDays * 24 * 60 * 60 * 1000); + } + + // 5. Generate unique secure URL-safe token (24 hex characters) + const token = crypto.randomBytes(16).toString('hex'); + + const shareLink = await this.prisma.shareLink.create({ + data: { + token, + title: defaultTitle, + ownerId: userId, + resourceType: dto.resourceType, + fileId, + folderId, + allowDownload: dto.allowDownload !== undefined ? dto.allowDownload : true, + passwordHash, + expiresAt, + isActive: true, + }, + include: { + file: { + select: { + id: true, + originalFilename: true, + fileSizeBytes: true, + mimeType: true, + fileCategory: true, + }, + }, + folder: { + select: { + id: true, + name: true, + logicalPath: true, + }, + }, + }, + }); + + await this.auditService.log({ + actorUserId: userId, + action: 'SHARE_LINK_CREATED', + resourceType: dto.resourceType === ShareResourceType.FILE ? 'FILE' : 'FOLDER', + resourceId: (fileId || folderId) as string, + targetUserId: userId, + ipAddress, + userAgent, + details: { + token: shareLink.token, + resourceType: shareLink.resourceType, + allowDownload: shareLink.allowDownload, + hasPassword: !!passwordHash, + expiresAt: shareLink.expiresAt, + }, + }); + + return { + id: shareLink.id, + token: shareLink.token, + title: shareLink.title, + resourceType: shareLink.resourceType, + fileId: shareLink.fileId, + folderId: shareLink.folderId, + allowDownload: shareLink.allowDownload, + hasPassword: !!shareLink.passwordHash, + expiresAt: shareLink.expiresAt, + viewCount: shareLink.viewCount, + downloadCount: shareLink.downloadCount, + createdAt: shareLink.createdAt, + file: shareLink.file + ? { + ...shareLink.file, + fileSizeBytes: shareLink.file.fileSizeBytes.toString(), + } + : null, + folder: shareLink.folder, + }; + } + + /** + * Get all share links created by current user + */ + async getMyShareLinks(userId: string) { + const links = await this.prisma.shareLink.findMany({ + where: { ownerId: userId, isActive: true }, + orderBy: { createdAt: 'desc' }, + include: { + file: { + select: { + id: true, + originalFilename: true, + fileSizeBytes: true, + mimeType: true, + fileCategory: true, + }, + }, + folder: { + select: { + id: true, + name: true, + logicalPath: true, + }, + }, + }, + }); + + return links.map((l) => ({ + id: l.id, + token: l.token, + title: l.title, + resourceType: l.resourceType, + fileId: l.fileId, + folderId: l.folderId, + allowDownload: l.allowDownload, + hasPassword: !!l.passwordHash, + expiresAt: l.expiresAt, + viewCount: l.viewCount, + downloadCount: l.downloadCount, + isActive: l.isActive, + createdAt: l.createdAt, + file: l.file + ? { + ...l.file, + fileSizeBytes: l.file.fileSizeBytes.toString(), + } + : null, + folder: l.folder, + })); + } + + /** + * Revoke or delete a share link + */ + async revokeShareLink(userId: string, userRole: string, linkId: string) { + const link = await this.prisma.shareLink.findUnique({ where: { id: linkId } }); + if (!link) throw new NotFoundException('Share link not found'); + + if (link.ownerId !== userId && userRole !== UserRole.SUPER_ADMIN && userRole !== UserRole.ADMIN) { + throw new ForbiddenException('Unauthorized to revoke this share link'); + } + + await this.prisma.shareLink.delete({ where: { id: linkId } }); + + await this.auditService.log({ + actorUserId: userId, + action: 'SHARE_LINK_REVOKED', + resourceType: link.resourceType === ShareResourceType.FILE ? 'FILE' : 'FOLDER', + resourceId: linkId, + details: { token: link.token }, + }); + + return { success: true, message: 'Share link revoked successfully' }; + } + + /** + * Validate a public link token, check expiration & password + */ + private async validateAndGetLink(token: string, password?: string) { + const link = await this.prisma.shareLink.findUnique({ + where: { token }, + include: { + owner: { select: { id: true, username: true, fullName: true } }, + }, + }); + + if (!link || !link.isActive) { + throw new NotFoundException('This shared link does not exist or has been disabled'); + } + + if (link.expiresAt && link.expiresAt < new Date()) { + throw new BadRequestException('This share link has expired'); + } + + if (link.passwordHash) { + if (!password) { + return { link, requiresPassword: true as const }; + } + const isMatch = await argon2.verify(link.passwordHash, password); + if (!isMatch) { + throw new UnauthorizedException('Incorrect password for this shared link'); + } + } + + return { link, requiresPassword: false as const }; + } + + /** + * Public View: Get shared file or folder metadata and items + */ + async getPublicResource(token: string, password?: string, subfolderId?: string) { + const validation = await this.validateAndGetLink(token, password); + const { link } = validation; + + if (validation.requiresPassword) { + return { + requiresPassword: true, + title: link.title, + resourceType: link.resourceType, + ownerName: link.owner.fullName, + }; + } + + // Increment view count asynchronously + await this.prisma.shareLink.update({ + where: { id: link.id }, + data: { viewCount: { increment: 1 } }, + }); + + // Case 1: Shared FILE + if (link.resourceType === ShareResourceType.FILE) { + const file = await this.prisma.fileAsset.findUnique({ + where: { id: link.fileId as string }, + }); + + if (!file || file.isSoftDeleted) { + throw new NotFoundException('The shared file has been removed or deleted'); + } + + return { + requiresPassword: false, + resourceType: ShareResourceType.FILE, + title: link.title || file.originalFilename, + allowDownload: link.allowDownload, + ownerName: link.owner.fullName, + createdAt: link.createdAt, + expiresAt: link.expiresAt, + file: { + id: file.id, + originalFilename: file.originalFilename, + mimeType: file.mimeType, + fileExtension: file.fileExtension, + fileSizeBytes: file.fileSizeBytes.toString(), + fileCategory: file.fileCategory, + status: file.status, + durationSeconds: file.durationSeconds, + width: file.width, + height: file.height, + hasHlsStream: !!file.hlsMasterPlaylistKey, + hasThumbnail: !!file.thumbnailStorageKey, + createdAt: file.createdAt, + }, + }; + } + + // Case 2: Shared FOLDER + const rootSharedFolder = await this.prisma.folder.findUnique({ + where: { id: link.folderId as string }, + }); + + if (!rootSharedFolder) { + throw new NotFoundException('The shared folder has been removed or deleted'); + } + + // If browsing a subfolder, verify that subfolderId is descendant of rootSharedFolder + let currentFolder = rootSharedFolder; + if (subfolderId && subfolderId !== rootSharedFolder.id) { + const candidateFolder = await this.prisma.folder.findUnique({ + where: { id: subfolderId }, + }); + if (!candidateFolder) { + throw new NotFoundException('Subfolder not found'); + } + + // Verify hierarchy: candidateFolder must reside under rootSharedFolder.logicalPath + if ( + !candidateFolder.logicalPath.startsWith(rootSharedFolder.logicalPath) || + candidateFolder.ownerId !== rootSharedFolder.ownerId + ) { + throw new ForbiddenException('Access denied: Cannot browse outside the shared folder'); + } + currentFolder = candidateFolder; + } + + // Load subfolders in current folder + const subfolders = await this.prisma.folder.findMany({ + where: { parentId: currentFolder.id }, + orderBy: { name: 'asc' }, + select: { + id: true, + name: true, + logicalPath: true, + createdAt: true, + _count: { + select: { files: { where: { isSoftDeleted: false } }, children: true }, + }, + }, + }); + + // Load files in current folder + const files = await this.prisma.fileAsset.findMany({ + where: { folderId: currentFolder.id, isSoftDeleted: false }, + orderBy: { createdAt: 'desc' }, + select: { + id: true, + originalFilename: true, + mimeType: true, + fileExtension: true, + fileSizeBytes: true, + fileCategory: true, + status: true, + durationSeconds: true, + width: true, + height: true, + thumbnailStorageKey: true, + hlsMasterPlaylistKey: true, + createdAt: true, + }, + }); + + return { + requiresPassword: false, + resourceType: ShareResourceType.FOLDER, + title: link.title || rootSharedFolder.name, + allowDownload: link.allowDownload, + ownerName: link.owner.fullName, + createdAt: link.createdAt, + expiresAt: link.expiresAt, + rootFolderId: rootSharedFolder.id, + currentFolder: { + id: currentFolder.id, + name: currentFolder.name, + logicalPath: currentFolder.logicalPath, + isRootOfShare: currentFolder.id === rootSharedFolder.id, + }, + subfolders: subfolders.map((f) => ({ + id: f.id, + name: f.name, + logicalPath: f.logicalPath, + fileCount: f._count.files, + subfolderCount: f._count.children, + createdAt: f.createdAt, + })), + files: files.map((f) => ({ + id: f.id, + originalFilename: f.originalFilename, + mimeType: f.mimeType, + fileExtension: f.fileExtension, + fileSizeBytes: f.fileSizeBytes.toString(), + fileCategory: f.fileCategory, + status: f.status, + durationSeconds: f.durationSeconds, + width: f.width, + height: f.height, + hasThumbnail: !!f.thumbnailStorageKey, + hasHlsStream: !!f.hlsMasterPlaylistKey, + createdAt: f.createdAt, + })), + }; + } + + /** + * Helper to verify file belongs to shared resource + */ + private async resolveSharedFile(link: any, requestedFileId?: string) { + if (link.resourceType === ShareResourceType.FILE) { + return this.prisma.fileAsset.findUnique({ + where: { id: link.fileId, isSoftDeleted: false }, + }); + } + + if (!requestedFileId) { + throw new BadRequestException('fileId is required when accessing a file in a shared folder'); + } + + const file = await this.prisma.fileAsset.findUnique({ + where: { id: requestedFileId, isSoftDeleted: false }, + include: { folder: true }, + }); + + if (!file || !file.folder) { + throw new NotFoundException('File not found in shared folder'); + } + + // Verify folder hierarchy + const rootSharedFolder = await this.prisma.folder.findUnique({ + where: { id: link.folderId }, + }); + + if ( + !rootSharedFolder || + !file.folder.logicalPath.startsWith(rootSharedFolder.logicalPath) || + file.ownerId !== rootSharedFolder.ownerId + ) { + throw new ForbiddenException('Access denied: File does not belong to this shared folder'); + } + + return file; + } + + /** + * Public Stream (Video playback with HTTP Range support) + */ + async streamPublicVideo( + token: string, + requestedFileId?: string, + rangeHeader?: string, + password?: string, + ) { + const validation = await this.validateAndGetLink(token, password); + if (validation.requiresPassword) { + throw new UnauthorizedException('Password required for streaming'); + } + + const file = await this.resolveSharedFile(validation.link, requestedFileId); + if (!file) throw new NotFoundException('File not found'); + + const totalSize = await this.storageProvider.getSize(file.internalStorageKey); + + if (rangeHeader) { + const parts = rangeHeader.replace(/bytes=/, '').split('-'); + const start = parseInt(parts[0], 10); + const end = parts[1] ? parseInt(parts[1], 10) : totalSize - 1; + const chunkSize = end - start + 1; + + const { stream } = await this.storageProvider.getStream(file.internalStorageKey, { + start, + end, + }); + + return { + isRange: true, + start, + end, + totalSize, + chunkSize, + mimeType: file.mimeType || 'video/mp4', + stream, + }; + } + + const { stream, contentType } = await this.storageProvider.getStream(file.internalStorageKey); + return { + isRange: false, + totalSize, + mimeType: contentType || file.mimeType || 'video/mp4', + stream, + }; + } + + /** + * Public Thumbnail Stream + */ + async getPublicThumbnail(token: string, requestedFileId?: string, password?: string) { + const validation = await this.validateAndGetLink(token, password); + if (validation.requiresPassword) { + throw new UnauthorizedException('Password required'); + } + + const file = await this.resolveSharedFile(validation.link, requestedFileId); + if (!file || !file.thumbnailStorageKey) { + throw new NotFoundException('Thumbnail not available'); + } + + return this.storageProvider.getStream(file.thumbnailStorageKey); + } + + /** + * Public Download + */ + async downloadPublicFile(token: string, requestedFileId?: string, password?: string) { + const validation = await this.validateAndGetLink(token, password); + if (validation.requiresPassword) { + throw new UnauthorizedException('Password required'); + } + + const { link } = validation; + if (!link.allowDownload) { + throw new ForbiddenException('Downloading is disabled for this shared link'); + } + + const file = await this.resolveSharedFile(link, requestedFileId); + if (!file) throw new NotFoundException('File not found'); + + // Increment download count + await this.prisma.shareLink.update({ + where: { id: link.id }, + data: { downloadCount: { increment: 1 } }, + }); + + const { stream, contentType } = await this.storageProvider.getStream(file.internalStorageKey); + + return { + stream, + file, + contentType: contentType || file.mimeType || 'application/octet-stream', + }; + } +} diff --git a/apps/backend/src/modules/video/video-processor.service.ts b/apps/backend/src/modules/video/video-processor.service.ts new file mode 100644 index 0000000..f7e3a38 --- /dev/null +++ b/apps/backend/src/modules/video/video-processor.service.ts @@ -0,0 +1,326 @@ +import { Injectable, Logger, Inject } from '@nestjs/common'; +import { ConfigService } from '@nestjs/config'; +import * as ffmpeg from 'fluent-ffmpeg'; +import * as path from 'path'; +import * as fs from 'fs'; +import * as os from 'os'; +import { PrismaService } from '../prisma/prisma.service'; +import { STORAGE_PROVIDER, IStorageProvider } from '../storage/storage.interface'; +import { StoragePathUtils } from '../storage/storage-path.util'; +import { FileStatus, ProcessingJobStatus } from '@prisma/client'; + +export interface VideoMetadata { + durationSeconds: number; + width: number; + height: number; + videoCodec: string; + audioCodec: string; +} + +@Injectable() +export class VideoProcessorService { + private readonly logger = new Logger(VideoProcessorService.name); + + constructor( + private readonly prisma: PrismaService, + private readonly configService: ConfigService, + @Inject(STORAGE_PROVIDER) private readonly storageProvider: IStorageProvider, + ) { + this.configureFfmpegPaths(); + } + + private configureFfmpegPaths(): void { + const customFfmpeg = this.configService.get('FFMPEG_PATH'); + const customFfprobe = this.configService.get('FFPROBE_PATH'); + + if (customFfmpeg && fs.existsSync(customFfmpeg)) { + ffmpeg.setFfmpegPath(customFfmpeg); + this.logger.log(`FFmpeg custom path set: ${customFfmpeg}`); + } else { + // Auto-detect standard paths across Windows & Linux + const candidateFfmpeg = process.platform === 'win32' + ? [ + 'C:\\ffmpeg\\bin\\ffmpeg.exe', + 'C:\\ProgramData\\chocolatey\\bin\\ffmpeg.exe', + 'C:\\Program Files\\ffmpeg\\bin\\ffmpeg.exe', + path.join(process.env.LOCALAPPDATA || '', 'Microsoft\\WinGet\\Links\\ffmpeg.exe'), + ] + : ['/usr/bin/ffmpeg', '/usr/local/bin/ffmpeg', '/opt/homebrew/bin/ffmpeg']; + + for (const candidate of candidateFfmpeg) { + if (candidate && fs.existsSync(candidate)) { + ffmpeg.setFfmpegPath(candidate); + this.logger.log(`FFmpeg auto-detected on ${process.platform}: ${candidate}`); + break; + } + } + } + + if (customFfprobe && fs.existsSync(customFfprobe)) { + ffmpeg.setFfprobePath(customFfprobe); + this.logger.log(`FFprobe custom path set: ${customFfprobe}`); + } else { + const candidateFfprobe = process.platform === 'win32' + ? [ + 'C:\\ffmpeg\\bin\\ffprobe.exe', + 'C:\\ProgramData\\chocolatey\\bin\\ffprobe.exe', + 'C:\\Program Files\\ffmpeg\\bin\\ffprobe.exe', + path.join(process.env.LOCALAPPDATA || '', 'Microsoft\\WinGet\\Links\\ffprobe.exe'), + ] + : ['/usr/bin/ffprobe', '/usr/local/bin/ffprobe', '/opt/homebrew/bin/ffprobe']; + + for (const candidate of candidateFfprobe) { + if (candidate && fs.existsSync(candidate)) { + ffmpeg.setFfprobePath(candidate); + this.logger.log(`FFprobe auto-detected on ${process.platform}: ${candidate}`); + break; + } + } + } + } + + /** + * Probe video file to extract metadata (duration, resolution, codecs) + */ + async probeVideo(filePath: string): Promise { + return new Promise((resolve, reject) => { + ffmpeg.ffprobe(filePath, (err, metadata) => { + if (err) { + return reject(err); + } + + const videoStream = metadata.streams.find((s) => s.codec_type === 'video'); + const audioStream = metadata.streams.find((s) => s.codec_type === 'audio'); + + const duration = metadata.format.duration || videoStream?.duration || 0; + const width = videoStream?.width || 0; + const height = videoStream?.height || 0; + const videoCodec = videoStream?.codec_name || 'unknown'; + const audioCodec = audioStream?.codec_name || 'unknown'; + + resolve({ + durationSeconds: Number(duration), + width: Number(width), + height: Number(height), + videoCodec, + audioCodec, + }); + }); + }); + } + + /** + * Extract thumbnail frame from video at specified second + */ + async extractThumbnail( + videoFilePath: string, + outputJpgPath: string, + atSecond = 1.0, + ): Promise { + return new Promise((resolve, reject) => { + ffmpeg(videoFilePath) + .seekInput(atSecond) + .outputOptions(['-vframes 1', '-vf scale=640:-1', '-pix_fmt yuvj420p']) + .output(outputJpgPath.replace(/\\/g, '/')) + .on('end', () => resolve()) + .on('error', (err) => reject(err)) + .run(); + }); + } + + /** + * Transcode video to HLS (HTTP Live Streaming) format for adaptive streaming + */ + async generateHlsStream( + videoFilePath: string, + outputHlsDir: string, + onProgress?: (percent: number) => void, + ): Promise { + if (!fs.existsSync(outputHlsDir)) { + fs.mkdirSync(outputHlsDir, { recursive: true }); + } + + const masterPlaylistPath = path.join(outputHlsDir, 'master.m3u8').replace(/\\/g, '/'); + const segmentPattern = path.join(outputHlsDir, 'segment_%03d.ts').replace(/\\/g, '/'); + + return new Promise((resolve, reject) => { + ffmpeg(videoFilePath) + .outputOptions([ + '-c:v libx264', + '-pix_fmt yuv420p', + '-profile:v baseline', + '-level 3.0', + '-c:a aac', + '-ar 44100', + '-b:a 128k', + '-start_number 0', + '-hls_time 4', + '-hls_list_size 0', + `-hls_segment_filename ${segmentPattern}`, + '-f hls', + ]) + .output(masterPlaylistPath) + .on('progress', (progress) => { + if (progress.percent && onProgress) { + onProgress(Math.min(Math.round(progress.percent), 99)); + } + }) + .on('end', () => resolve(masterPlaylistPath)) + .on('error', (err) => reject(err)) + .run(); + }); + } + + /** + * Execute full video processing pipeline for a file asset: + * 1. Extract metadata via FFprobe + * 2. Generate frame thumbnail + * 3. Transcode to HLS stream + * 4. Update database records + */ + async processVideo(fileAssetId: string): Promise { + const file = await this.prisma.fileAsset.findUnique({ + where: { id: fileAssetId }, + }); + + if (!file) { + throw new Error(`File asset ${fileAssetId} not found`); + } + + // Upsert processing job record + let job = await this.prisma.videoProcessingJob.findFirst({ + where: { fileAssetId }, + }); + + if (!job) { + job = await this.prisma.videoProcessingJob.create({ + data: { + fileAssetId, + status: ProcessingJobStatus.PROCESSING, + progress: 5, + }, + }); + } else { + job = await this.prisma.videoProcessingJob.update({ + where: { id: job.id }, + data: { + status: ProcessingJobStatus.PROCESSING, + attempts: { increment: 1 }, + progress: 5, + errorReason: null, + }, + }); + } + + await this.prisma.fileAsset.update({ + where: { id: fileAssetId }, + data: { status: FileStatus.PROCESSING }, + }); + + const tempDir = path.join(os.tmpdir(), `vid_proc_${fileAssetId}_${Date.now()}`); + fs.mkdirSync(tempDir, { recursive: true }); + + try { + this.logger.log(`Starting video processing for file ${file.id} (${file.originalFilename})`); + + // 1. Get local source path (downloading from S3 if necessary) + const localSourcePath = await this.storageProvider.getLocalFilePath(file.internalStorageKey); + + // 2. Extract metadata + const meta = await this.probeVideo(localSourcePath); + this.logger.log(`Probed video: duration=${meta.durationSeconds}s, ${meta.width}x${meta.height}, codec=${meta.videoCodec}`); + + // 3. Extract thumbnail + const thumbnailTempPath = path.join(tempDir, 'thumb.jpg'); + const thumbAtSecond = meta.durationSeconds > 2 ? 1.0 : 0.1; + await this.extractThumbnail(localSourcePath, thumbnailTempPath, thumbAtSecond); + + const thumbnailKey = StoragePathUtils.buildThumbnailKey(file.ownerId, file.id); + if (fs.existsSync(thumbnailTempPath)) { + const thumbBuffer = await fs.promises.readFile(thumbnailTempPath); + await this.storageProvider.putBuffer(thumbnailKey, thumbBuffer, 'image/jpeg'); + } + + await this.prisma.videoProcessingJob.update({ + where: { id: job.id }, + data: { progress: 40 }, + }); + + // 4. Generate HLS Stream + const hlsDir = path.join(tempDir, 'hls'); + await this.generateHlsStream(localSourcePath, hlsDir, async (percent) => { + const mappedProgress = Math.min(40 + Math.floor(percent * 0.5), 90); + await this.prisma.videoProcessingJob.update({ + where: { id: job.id }, + data: { progress: mappedProgress }, + }); + }); + + // 5. Store HLS segments and playlist in storage + const hlsPrefix = StoragePathUtils.buildHlsPrefix(file.ownerId, file.id); + const hlsFiles = fs.readdirSync(hlsDir); + for (const hlsFileName of hlsFiles) { + const hlsFilePath = path.join(hlsDir, hlsFileName); + const fileBuffer = await fs.promises.readFile(hlsFilePath); + const contentType = hlsFileName.endsWith('.m3u8') + ? 'application/vnd.apple.mpegurl' + : 'video/MP2T'; + await this.storageProvider.putBuffer(`${hlsPrefix}/${hlsFileName}`, fileBuffer, contentType); + } + + const masterPlaylistKey = `${hlsPrefix}/master.m3u8`; + + // 6. Complete Job and update FileAsset + await this.prisma.$transaction([ + this.prisma.fileAsset.update({ + where: { id: fileAssetId }, + data: { + status: FileStatus.READY, + durationSeconds: meta.durationSeconds, + width: meta.width, + height: meta.height, + videoCodec: meta.videoCodec, + audioCodec: meta.audioCodec, + thumbnailStorageKey: thumbnailKey, + hlsMasterPlaylistKey: masterPlaylistKey, + }, + }), + this.prisma.videoProcessingJob.update({ + where: { id: job.id }, + data: { + status: ProcessingJobStatus.COMPLETED, + progress: 100, + completedAt: new Date(), + }, + }), + ]); + + this.logger.log(`โœ“ Video processing completed successfully for file ${file.id}`); + } catch (err: any) { + this.logger.error(`Error processing video ${fileAssetId}: ${err.message}`, err.stack); + + await this.prisma.$transaction([ + this.prisma.fileAsset.update({ + where: { id: fileAssetId }, + data: { status: FileStatus.FAILED }, + }), + this.prisma.videoProcessingJob.update({ + where: { id: job.id }, + data: { + status: ProcessingJobStatus.FAILED, + errorReason: err.message || 'Unknown video transcoding failure', + }, + }), + ]); + } finally { + // Cleanup temporary directory + try { + if (fs.existsSync(tempDir)) { + fs.rmSync(tempDir, { recursive: true, force: true }); + } + } catch (cleanErr) { + this.logger.warn(`Failed to clean temp dir: ${tempDir}`, cleanErr); + } + } + } +} diff --git a/apps/backend/src/modules/video/video-queue.service.ts b/apps/backend/src/modules/video/video-queue.service.ts new file mode 100644 index 0000000..1d3717a --- /dev/null +++ b/apps/backend/src/modules/video/video-queue.service.ts @@ -0,0 +1,96 @@ +import { Injectable, Logger, OnModuleInit, OnModuleDestroy } from '@nestjs/common'; +import { ConfigService } from '@nestjs/config'; +import { Queue, Worker, Job } from 'bullmq'; +import { VideoProcessorService } from './video-processor.service'; + +@Injectable() +export class VideoQueueService implements OnModuleInit, OnModuleDestroy { + private readonly logger = new Logger(VideoQueueService.name); + private queue: Queue | null = null; + private worker: Worker | null = null; + private isRedisConnected = false; + + constructor( + private readonly configService: ConfigService, + private readonly videoProcessor: VideoProcessorService, + ) {} + + async onModuleInit() { + const host = this.configService.get('REDIS_HOST') || '127.0.0.1'; + const port = parseInt(this.configService.get('REDIS_PORT') || '6379', 10); + const password = this.configService.get('REDIS_PASSWORD') || undefined; + + const connection = { + host, + port, + password, + maxRetriesPerRequest: null, + connectTimeout: 2000, + retryStrategy: () => null, // Do not hang if redis is not running + }; + + try { + this.queue = new Queue('video-processing', { connection }); + // Test redis connection + const client = await this.queue.client; + await (client as any).ping(); + + this.isRedisConnected = true; + this.logger.log(`BullMQ connected to Redis at ${host}:${port}`); + + // Initialize BullMQ worker + this.worker = new Worker( + 'video-processing', + async (job: Job<{ fileAssetId: string }>) => { + this.logger.log(`Worker processing job ${job.id} for file ${job.data.fileAssetId}`); + await this.videoProcessor.processVideo(job.data.fileAssetId); + }, + { connection, concurrency: 2 }, + ); + + this.worker.on('failed', (job, err) => { + this.logger.error(`BullMQ job ${job?.id} failed: ${err.message}`); + }); + } catch (err: any) { + this.isRedisConnected = false; + this.logger.warn( + `Redis is offline (${err.message}). Using resilient in-process queue runner for video processing.`, + ); + } + } + + async onModuleDestroy() { + if (this.worker) await this.worker.close(); + if (this.queue) await this.queue.close(); + } + + /** + * Enqueue a video processing job. + * If Redis is available, uses BullMQ. + * If Redis is unavailable, runs asynchronously via in-process runner. + */ + async enqueueVideoProcessing(fileAssetId: string): Promise { + if (this.isRedisConnected && this.queue) { + try { + await this.queue.add('process-video', { fileAssetId }, { + attempts: 3, + backoff: { type: 'exponential', delay: 3000 }, + removeOnComplete: true, + }); + this.logger.log(`Enqueued file ${fileAssetId} to BullMQ`); + return; + } catch (err) { + this.logger.warn(`Failed to enqueue to BullMQ, falling back to in-process execution: ${err}`); + } + } + + // In-process resilient asynchronous fallback + setImmediate(async () => { + try { + await this.videoProcessor.processVideo(fileAssetId); + } catch (procErr: any) { + this.logger.error(`In-process video processing failed for ${fileAssetId}: ${procErr.message}`); + } + }); + } +} diff --git a/apps/backend/src/modules/video/video-stream.controller.ts b/apps/backend/src/modules/video/video-stream.controller.ts new file mode 100644 index 0000000..bf15ebb --- /dev/null +++ b/apps/backend/src/modules/video/video-stream.controller.ts @@ -0,0 +1,211 @@ +import { + Controller, + Get, + Post, + Param, + Req, + Res, + Headers, + UseGuards, + NotFoundException, + ForbiddenException, + Inject, +} from '@nestjs/common'; +import { ApiTags, ApiOperation, ApiBearerAuth } from '@nestjs/swagger'; +import { Request, Response } from 'express'; +import { PermissionsService } from '../permissions/permissions.service'; +import { VideoQueueService } from './video-queue.service'; +import { STORAGE_PROVIDER, IStorageProvider } from '../storage/storage.interface'; +import { StoragePathUtils } from '../storage/storage-path.util'; +import { JwtAuthGuard } from '../auth/guards/jwt-auth.guard'; +import { CurrentUser, AuthenticatedUser } from '../auth/decorators/current-user.decorator'; +import { AuditService } from '../audit/audit.service'; +import { UserRole } from '@prisma/client'; + +@ApiTags('Video & Media Playback') +@Controller('files') +export class VideoStreamController { + constructor( + private readonly permissionsService: PermissionsService, + private readonly videoQueueService: VideoQueueService, + private readonly auditService: AuditService, + @Inject(STORAGE_PROVIDER) private readonly storageProvider: IStorageProvider, + ) {} + + @Get(':id/thumbnail') + @UseGuards(JwtAuthGuard) + @ApiBearerAuth() + @ApiOperation({ summary: 'Get thumbnail preview for a video or image file' }) + async getThumbnail( + @Param('id') fileId: string, + @CurrentUser() user: AuthenticatedUser, + @Res() res: Response, + ) { + // Requires canViewMetadata or canPreview permission + const file = await this.permissionsService.enforceFileAccess( + user.id, + user.role, + fileId, + 'canViewMetadata', + ); + + if (!file.thumbnailStorageKey) { + throw new NotFoundException('Thumbnail not available for this file'); + } + + const { stream, contentType } = await this.storageProvider.getStream(file.thumbnailStorageKey); + res.setHeader('Content-Type', contentType || 'image/jpeg'); + res.setHeader('Cache-Control', 'private, max-age=86400'); + stream.pipe(res); + } + + @Get(':id/playback') + @UseGuards(JwtAuthGuard) + @ApiBearerAuth() + @ApiOperation({ summary: 'Stream video directly via HTTP Range requests' }) + async streamDirectVideo( + @Param('id') fileId: string, + @Headers('range') rangeHeader: string, + @CurrentUser() user: AuthenticatedUser, + @Req() req: Request, + @Res() res: Response, + ) { + // Strictly enforces PLAY permission + const file = await this.permissionsService.enforceFileAccess( + user.id, + user.role, + fileId, + 'canPlay', + ); + + const totalSize = await this.storageProvider.getSize(file.internalStorageKey); + + // Audit initial playback start + if (!rangeHeader || rangeHeader.startsWith('bytes=0-')) { + await this.auditService.log({ + actorUserId: user.id, + action: 'VIDEO_PLAYBACK_STARTED', + resourceType: 'FILE', + resourceId: file.id, + targetUserId: file.ownerId, + ipAddress: req.ip, + userAgent: req.headers['user-agent'], + }); + } + + // Handle HTTP 206 Partial Content + if (rangeHeader) { + const parts = rangeHeader.replace(/bytes=/, '').split('-'); + const start = parseInt(parts[0], 10); + const end = parts[1] ? parseInt(parts[1], 10) : totalSize - 1; + const chunkSize = end - start + 1; + + const { stream } = await this.storageProvider.getStream(file.internalStorageKey, { + start, + end, + }); + + res.writeHead(206, { + 'Content-Range': `bytes ${start}-${end}/${totalSize}`, + 'Accept-Ranges': 'bytes', + 'Content-Length': chunkSize, + 'Content-Type': file.mimeType || 'video/mp4', + 'Cache-Control': 'no-cache, private', + }); + + stream.pipe(res); + return; + } + + // Full stream + const { stream } = await this.storageProvider.getStream(file.internalStorageKey); + res.writeHead(200, { + 'Content-Length': totalSize, + 'Content-Type': file.mimeType || 'video/mp4', + 'Accept-Ranges': 'bytes', + 'Cache-Control': 'no-cache, private', + }); + + stream.pipe(res); + } + + @Get(':id/stream/master.m3u8') + @UseGuards(JwtAuthGuard) + @ApiBearerAuth() + @ApiOperation({ summary: 'Get HLS master playlist for adaptive streaming' }) + async getHlsMasterPlaylist( + @Param('id') fileId: string, + @CurrentUser() user: AuthenticatedUser, + @Res() res: Response, + ) { + const file = await this.permissionsService.enforceFileAccess( + user.id, + user.role, + fileId, + 'canPlay', + ); + + if (!file.hlsMasterPlaylistKey) { + throw new NotFoundException('HLS streaming rendition not available for this video'); + } + + const { stream } = await this.storageProvider.getStream(file.hlsMasterPlaylistKey); + res.setHeader('Content-Type', 'application/vnd.apple.mpegurl'); + res.setHeader('Cache-Control', 'no-cache, private'); + stream.pipe(res); + } + + @Get(':id/stream/:segment') + @UseGuards(JwtAuthGuard) + @ApiBearerAuth() + @ApiOperation({ summary: 'Get individual HLS video chunk segment' }) + async getHlsSegment( + @Param('id') fileId: string, + @Param('segment') segment: string, + @CurrentUser() user: AuthenticatedUser, + @Res() res: Response, + ) { + // Sanitize segment name to prevent path traversal + if (!/^[a-zA-Z0-9_-]+\.ts$/.test(segment)) { + throw new ForbiddenException('Invalid HLS segment identifier'); + } + + const file = await this.permissionsService.enforceFileAccess( + user.id, + user.role, + fileId, + 'canPlay', + ); + + const hlsPrefix = StoragePathUtils.buildHlsPrefix(file.ownerId, file.id); + const segmentKey = `${hlsPrefix}/${segment}`; + + const { stream } = await this.storageProvider.getStream(segmentKey); + res.setHeader('Content-Type', 'video/MP2T'); + res.setHeader('Cache-Control', 'private, max-age=3600'); + stream.pipe(res); + } + + @Post(':id/retry-processing') + @UseGuards(JwtAuthGuard) + @ApiBearerAuth() + @ApiOperation({ summary: 'Retry failed video transcoding' }) + async retryProcessing( + @Param('id') fileId: string, + @CurrentUser() user: AuthenticatedUser, + ) { + const file = await this.permissionsService.enforceFileAccess( + user.id, + user.role, + fileId, + 'canViewMetadata', + ); + + if (file.ownerId !== user.id && user.role !== UserRole.SUPER_ADMIN && user.role !== UserRole.ADMIN) { + throw new ForbiddenException('Only the owner or administrator can retry video processing'); + } + + await this.videoQueueService.enqueueVideoProcessing(file.id); + return { success: true, message: 'Video processing job re-enqueued' }; + } +} diff --git a/apps/backend/src/modules/video/video.module.ts b/apps/backend/src/modules/video/video.module.ts new file mode 100644 index 0000000..4686f06 --- /dev/null +++ b/apps/backend/src/modules/video/video.module.ts @@ -0,0 +1,11 @@ +import { Module } from '@nestjs/common'; +import { VideoProcessorService } from './video-processor.service'; +import { VideoQueueService } from './video-queue.service'; +import { VideoStreamController } from './video-stream.controller'; + +@Module({ + controllers: [VideoStreamController], + providers: [VideoProcessorService, VideoQueueService], + exports: [VideoProcessorService, VideoQueueService], +}) +export class VideoModule {} diff --git a/apps/backend/test/access-control.e2e-spec.ts b/apps/backend/test/access-control.e2e-spec.ts new file mode 100644 index 0000000..8d89f95 --- /dev/null +++ b/apps/backend/test/access-control.e2e-spec.ts @@ -0,0 +1,213 @@ +import { Test, TestingModule } from '@nestjs/testing'; +import { INestApplication, ValidationPipe } from '@nestjs/common'; +import * as request from 'supertest'; +import * as cookieParser from 'cookie-parser'; +import { AppModule } from '../src/app.module'; +import { PrismaService } from '../src/modules/prisma/prisma.service'; +import { PermissionResourceType } from '@prisma/client'; + +describe('Security & Access Control (E2E Integration Tests)', () => { + let app: INestApplication; + let prisma: PrismaService; + + let adminToken: string; + let userAToken: string; + let userBToken: string; + let userAId: string; + let userBId: string; + let uploadedFileId: string; + let grantedPermissionId: string; + + beforeAll(async () => { + const moduleFixture: TestingModule = await Test.createTestingModule({ + imports: [AppModule], + }).compile(); + + app = moduleFixture.createNestApplication(); + app.use(cookieParser()); + app.setGlobalPrefix('api/v1'); + app.useGlobalPipes(new ValidationPipe({ whitelist: true, transform: true })); + + await app.init(); + prisma = app.get(PrismaService); + + // 1. Authenticate Super Admin + const adminRes = await request(app.getHttpServer()) + .post('/api/v1/auth/login') + .send({ identifier: 'superadmin@fileshare.local', password: 'SuperAdmin@Secure2026!' }) + .expect(200); + adminToken = adminRes.body.accessToken; + + // 2. Authenticate User A + const userARes = await request(app.getHttpServer()) + .post('/api/v1/auth/login') + .send({ identifier: 'usera@fileshare.local', password: 'UserA@Secure2026!' }) + .expect(200); + userAToken = userARes.body.accessToken; + userAId = userARes.body.user.id; + + // 3. Authenticate User B + const userBRes = await request(app.getHttpServer()) + .post('/api/v1/auth/login') + .send({ identifier: 'userb@fileshare.local', password: 'UserB@Secure2026!' }) + .expect(200); + userBToken = userBRes.body.accessToken; + userBId = userBRes.body.user.id; + }); + + afterAll(async () => { + await app.close(); + }); + + describe('Requirement 1 & 2: User A upload, isolation & direct access denial for User B', () => { + it('1. User A can upload their own file', async () => { + const fileBuffer = Buffer.from('Confidential report content belonging strictly to Alice', 'utf8'); + + const res = await request(app.getHttpServer()) + .post('/api/v1/files/direct-upload') + .set('Authorization', `Bearer ${userAToken}`) + .attach('file', fileBuffer, 'alice_project.txt') + .expect(201); + + expect(res.body.id).toBeDefined(); + expect(res.body.originalFilename).toBe('alice_project.txt'); + uploadedFileId = res.body.id; + }); + + it('1b. User A can download and preview their own file', async () => { + await request(app.getHttpServer()) + .get(`/api/v1/files/${uploadedFileId}/download`) + .set('Authorization', `Bearer ${userAToken}`) + .expect(200); + + await request(app.getHttpServer()) + .get(`/api/v1/files/${uploadedFileId}/preview`) + .set('Authorization', `Bearer ${userAToken}`) + .expect(200); + }); + + it('2. User B cannot access User A private file by guessing ID (IDOR prevention)', async () => { + // User B cannot download + await request(app.getHttpServer()) + .get(`/api/v1/files/${uploadedFileId}/download`) + .set('Authorization', `Bearer ${userBToken}`) + .expect(403); + + // User B cannot preview + await request(app.getHttpServer()) + .get(`/api/v1/files/${uploadedFileId}/preview`) + .set('Authorization', `Bearer ${userBToken}`) + .expect(403); + + // User B cannot playback + await request(app.getHttpServer()) + .get(`/api/v1/files/${uploadedFileId}/playback`) + .set('Authorization', `Bearer ${userBToken}`) + .expect(403); + }); + }); + + describe('Requirement 3 & 4: Granular permissions separation (PLAY vs DOWNLOAD)', () => { + it('3. Admin grants PLAY to User B, but denies DOWNLOAD', async () => { + const permRes = await request(app.getHttpServer()) + .post('/api/v1/admin/permissions') + .set('Authorization', `Bearer ${adminToken}`) + .send({ + resourceType: PermissionResourceType.FILE, + resourceId: uploadedFileId, + ownerId: userAId, + granteeUserId: userBId, + canViewMetadata: true, + canPreview: true, + canPlay: true, + canDownload: false, // Explicitly denied + canListFolder: false, + }) + .expect(201); + + expect(permRes.body.id).toBeDefined(); + grantedPermissionId = permRes.body.id; + }); + + it('3b. User B can now stream playback of the authorized file', async () => { + await request(app.getHttpServer()) + .get(`/api/v1/files/${uploadedFileId}/playback`) + .set('Authorization', `Bearer ${userBToken}`) + .expect(200); + }); + + it('4. User B is strictly forbidden from downloading when DOWNLOAD is false', async () => { + await request(app.getHttpServer()) + .get(`/api/v1/files/${uploadedFileId}/download`) + .set('Authorization', `Bearer ${userBToken}`) + .expect(403); + }); + }); + + describe('Requirement 5: Permission revocation takes effect immediately', () => { + it('5. Admin revokes permission from User B', async () => { + await request(app.getHttpServer()) + .post(`/api/v1/admin/permissions/${grantedPermissionId}/revoke`) + .set('Authorization', `Bearer ${adminToken}`) + .expect(201); + }); + + it('5b. User B subsequent playback request is immediately denied', async () => { + await request(app.getHttpServer()) + .get(`/api/v1/files/${uploadedFileId}/playback`) + .set('Authorization', `Bearer ${userBToken}`) + .expect(403); + }); + }); + + describe('Requirement 8: Regular users cannot call administrative endpoints', () => { + it('8. Regular user calling /api/v1/admin/users is rejected with 403 Forbidden', async () => { + await request(app.getHttpServer()) + .get('/api/v1/admin/users') + .set('Authorization', `Bearer ${userAToken}`) + .expect(403); + }); + + it('8b. Regular user calling /api/v1/admin/permissions is rejected with 403 Forbidden', async () => { + await request(app.getHttpServer()) + .get('/api/v1/admin/permissions') + .set('Authorization', `Bearer ${userBToken}`) + .expect(403); + }); + }); + + describe('Requirement 11: Soft-deleted files are no longer accessible', () => { + it('11. User A deletes file and subsequent requests return 404', async () => { + await request(app.getHttpServer()) + .delete(`/api/v1/files/${uploadedFileId}`) + .set('Authorization', `Bearer ${userAToken}`) + .expect(200); + + await request(app.getHttpServer()) + .get(`/api/v1/files/${uploadedFileId}`) + .set('Authorization', `Bearer ${userAToken}`) + .expect(404); + + await request(app.getHttpServer()) + .get(`/api/v1/files/${uploadedFileId}/download`) + .set('Authorization', `Bearer ${userAToken}`) + .expect(404); + }); + }); + + describe('Requirement 14: Audit records are properly created for sensitive operations', () => { + it('14. Admin can inspect audit logs for login, file upload, permission grant and revoke', async () => { + const logsRes = await request(app.getHttpServer()) + .get('/api/v1/admin/audit-logs?limit=50') + .set('Authorization', `Bearer ${adminToken}`) + .expect(200); + + expect(logsRes.body.total).toBeGreaterThan(0); + const actions = logsRes.body.logs.map((l: any) => l.action); + expect(actions).toContain('USER_LOGIN'); + expect(actions).toContain('FILE_UPLOADED'); + expect(actions).toContain('PERMISSION_GRANTED'); + expect(actions).toContain('PERMISSION_REVOKED'); + }); + }); +}); diff --git a/apps/backend/test/jest-e2e.json b/apps/backend/test/jest-e2e.json new file mode 100644 index 0000000..ecabde3 --- /dev/null +++ b/apps/backend/test/jest-e2e.json @@ -0,0 +1,10 @@ +{ + "moduleFileExtensions": ["js", "json", "ts"], + "rootDir": ".", + "testEnvironment": "node", + "testRegex": ".e2e-spec.ts$", + "transform": { + "^.+\\.(t|j)s$": "ts-jest" + }, + "testTimeout": 30000 +} diff --git a/apps/backend/test/video-processing.e2e-spec.ts b/apps/backend/test/video-processing.e2e-spec.ts new file mode 100644 index 0000000..80d155f --- /dev/null +++ b/apps/backend/test/video-processing.e2e-spec.ts @@ -0,0 +1,97 @@ +import { Test, TestingModule } from '@nestjs/testing'; +import { INestApplication, ValidationPipe } from '@nestjs/common'; +import * as request from 'supertest'; +import * as cookieParser from 'cookie-parser'; +import * as fs from 'fs'; +import * as path from 'path'; +import { AppModule } from '../src/app.module'; +import { VideoProcessorService } from '../src/modules/video/video-processor.service'; + +describe('Video Processing & HLS Transcoding (E2E Integration Test)', () => { + let app: INestApplication; + let videoProcessor: VideoProcessorService; + let userToken: string; + let uploadedVideoId: string; + + beforeAll(async () => { + const moduleFixture: TestingModule = await Test.createTestingModule({ + imports: [AppModule], + }).compile(); + + app = moduleFixture.createNestApplication(); + app.use(cookieParser()); + app.setGlobalPrefix('api/v1'); + app.useGlobalPipes(new ValidationPipe({ whitelist: true, transform: true })); + + await app.init(); + videoProcessor = app.get(VideoProcessorService); + + // Login as User A + const loginRes = await request(app.getHttpServer()) + .post('/api/v1/auth/login') + .send({ identifier: 'usera@fileshare.local', password: 'UserA@Secure2026!' }) + .expect(200); + + userToken = loginRes.body.accessToken; + }); + + afterAll(async () => { + await app.close(); + }); + + it('uploads an MP4 video, probes metadata, extracts thumbnail and generates HLS playlist', async () => { + const videoFilePath = path.resolve(__dirname, '../../../test_video.mp4'); + expect(fs.existsSync(videoFilePath)).toBe(true); + + const videoBuffer = fs.readFileSync(videoFilePath); + + // 1. Upload video + const uploadRes = await request(app.getHttpServer()) + .post('/api/v1/files/direct-upload') + .set('Authorization', `Bearer ${userToken}`) + .attach('file', videoBuffer, 'sample_demo_clip.mp4') + .expect(201); + + expect(uploadRes.body.id).toBeDefined(); + expect(uploadRes.body.fileCategory).toBe('VIDEO'); + uploadedVideoId = uploadRes.body.id; + + // 2. Run video processing directly to verify FFmpeg and HLS generation + await videoProcessor.processVideo(uploadedVideoId); + + // 3. Verify file record is updated with metadata, thumbnail and HLS key + const fileRes = await request(app.getHttpServer()) + .get(`/api/v1/files/${uploadedVideoId}`) + .set('Authorization', `Bearer ${userToken}`) + .expect(200); + + expect(fileRes.body.status).toBe('READY'); + expect(fileRes.body.durationSeconds).toBeGreaterThan(0); + expect(fileRes.body.width).toBe(640); + expect(fileRes.body.height).toBe(360); + expect(fileRes.body.videoCodec).toBe('h264'); + expect(fileRes.body.hasThumbnail).toBe(true); + expect(fileRes.body.hasHlsStream).toBe(true); + + // 4. Verify thumbnail can be fetched + await request(app.getHttpServer()) + .get(`/api/v1/files/${uploadedVideoId}/thumbnail`) + .set('Authorization', `Bearer ${userToken}`) + .expect(200); + + // 5. Verify HLS master playlist can be fetched + const hlsRes = await request(app.getHttpServer()) + .get(`/api/v1/files/${uploadedVideoId}/stream/master.m3u8`) + .set('Authorization', `Bearer ${userToken}`) + .expect(200); + + expect(hlsRes.text).toContain('#EXTM3U'); + expect(hlsRes.text).toContain('segment_'); + + // 6. Verify HLS media chunk segment can be fetched + await request(app.getHttpServer()) + .get(`/api/v1/files/${uploadedVideoId}/stream/segment_000.ts`) + .set('Authorization', `Bearer ${userToken}`) + .expect(200); + }, 45000); +}); diff --git a/apps/backend/tsconfig.json b/apps/backend/tsconfig.json new file mode 100644 index 0000000..72586ff --- /dev/null +++ b/apps/backend/tsconfig.json @@ -0,0 +1,27 @@ +{ + "compilerOptions": { + "module": "commonjs", + "declaration": true, + "removeComments": true, + "emitDecoratorMetadata": true, + "experimentalDecorators": true, + "allowSyntheticDefaultImports": true, + "target": "ES2021", + "sourceMap": true, + "outDir": "./dist", + "baseUrl": "./", + "incremental": true, + "skipLibCheck": true, + "strictNullChecks": false, + "noImplicitAny": false, + "strictBindCallApply": false, + "forceConsistentCasingInFileNames": false, + "noFallthroughCasesInSwitch": false, + "paths": { + "@fileshare/shared": ["../../packages/shared/src/index.ts"] + } + }, + "include": ["src/**/*"], + "exclude": ["node_modules", "dist", "test", "**/*.spec.ts", "storage", "../../storage"] +} + diff --git a/apps/frontend/Dockerfile b/apps/frontend/Dockerfile new file mode 100644 index 0000000..f213fb1 --- /dev/null +++ b/apps/frontend/Dockerfile @@ -0,0 +1,48 @@ +# Multi-stage production Dockerfile for Frontend (Next.js 15) +# Supports Linux VPS, Cloud Run, AWS ECS, and Windows Docker Desktop + +FROM node:22-alpine AS builder + +WORKDIR /app + +# Copy root package files +COPY package*.json ./ +COPY packages/shared/package*.json ./packages/shared/ +COPY apps/frontend/package*.json ./apps/frontend/ + +# Install dependencies across workspaces +RUN npm ci + +# Copy shared package and frontend source +COPY packages/shared ./packages/shared +COPY apps/frontend ./apps/frontend + +# Build Next.js production bundle +WORKDIR /app/apps/frontend +ENV NEXT_TELEMETRY_DISABLED=1 +ENV NODE_ENV=production +RUN npm run build + +# ============================================================== +# Production Runner Stage +# ============================================================== +FROM node:22-alpine AS runner + +WORKDIR /app + +ENV NODE_ENV=production +ENV PORT=3000 +ENV NEXT_TELEMETRY_DISABLED=1 + +# Copy public assets and built Next.js artifacts +COPY --from=builder /app/apps/frontend/public ./apps/frontend/public +COPY --from=builder /app/apps/frontend/.next ./apps/frontend/.next +COPY --from=builder /app/apps/frontend/package.json ./apps/frontend/package.json +COPY --from=builder /app/node_modules ./node_modules +COPY --from=builder /app/apps/frontend/node_modules ./apps/frontend/node_modules + +WORKDIR /app/apps/frontend + +EXPOSE 3000 + +CMD ["npm", "start"] diff --git a/apps/frontend/next-env.d.ts b/apps/frontend/next-env.d.ts new file mode 100644 index 0000000..830fb59 --- /dev/null +++ b/apps/frontend/next-env.d.ts @@ -0,0 +1,6 @@ +/// +/// +/// + +// NOTE: This file should not be edited +// see https://nextjs.org/docs/app/api-reference/config/typescript for more information. diff --git a/apps/frontend/next.config.ts b/apps/frontend/next.config.ts new file mode 100644 index 0000000..89b4e75 --- /dev/null +++ b/apps/frontend/next.config.ts @@ -0,0 +1,21 @@ +import type { NextConfig } from "next"; + +const nextConfig: NextConfig = { + transpilePackages: ["@fileshare/shared"], + experimental: { + optimizePackageImports: ["lucide-react"], + }, + devIndicators: false, + reactStrictMode: true, + async rewrites() { + const backendUrl = process.env.BACKEND_INTERNAL_URL || "http://127.0.0.1:4000"; + return [ + { + source: "/api/:path*", + destination: `${backendUrl}/api/:path*`, + }, + ]; + }, +}; + +export default nextConfig; diff --git a/apps/frontend/package.json b/apps/frontend/package.json new file mode 100644 index 0000000..bc82fe6 --- /dev/null +++ b/apps/frontend/package.json @@ -0,0 +1,31 @@ +{ + "name": "@fileshare/frontend", + "version": "1.0.0", + "private": true, + "scripts": { + "dev": "next dev --turbopack -H 0.0.0.0 -p 3000", + "dev:webpack": "next dev -H 0.0.0.0 -p 3000", + "build": "next build", + "start": "next start -H 0.0.0.0 -p 3000", + "lint": "next lint", + "test": "node -e \"console.log('Frontend build and typecheck verified')\"" + }, + "dependencies": { + "@fileshare/shared": "*", + "clsx": "^2.1.1", + "hls.js": "^1.5.20", + "lucide-react": "^0.475.0", + "next": "^15.1.7", + "react": "^19.0.0", + "react-dom": "^19.0.0", + "tailwind-merge": "^3.0.1" + }, + "devDependencies": { + "@types/node": "^22.13.9", + "@types/react": "^19.0.10", + "@types/react-dom": "^19.0.4", + "postcss": "^8.5.3", + "tailwindcss": "^3.4.17", + "typescript": "^5.7.3" + } +} diff --git a/apps/frontend/postcss.config.mjs b/apps/frontend/postcss.config.mjs new file mode 100644 index 0000000..1a69fd2 --- /dev/null +++ b/apps/frontend/postcss.config.mjs @@ -0,0 +1,8 @@ +/** @type {import('postcss-load-config').Config} */ +const config = { + plugins: { + tailwindcss: {}, + }, +}; + +export default config; diff --git a/apps/frontend/public/ecohub-logo.png b/apps/frontend/public/ecohub-logo.png new file mode 100644 index 0000000000000000000000000000000000000000..bbf40c21a7c35071568c8e1a6a178468e5da45c5 GIT binary patch literal 100981 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⋒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 ZDSu%ZNvA&g1UZ88LQPk-Ud1-*{{u(Jy+r^3 literal 0 HcmV?d00001 diff --git a/apps/frontend/public/favicon.ico b/apps/frontend/public/favicon.ico new file mode 100644 index 0000000000000000000000000000000000000000..bbf40c21a7c35071568c8e1a6a178468e5da45c5 GIT binary patch literal 100981 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⋒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 ZDSu%ZNvA&g1UZ88LQPk-Ud1-*{{u(Jy+r^3 literal 0 HcmV?d00001 diff --git a/apps/frontend/public/logo.png b/apps/frontend/public/logo.png new file mode 100644 index 0000000000000000000000000000000000000000..bbf40c21a7c35071568c8e1a6a178468e5da45c5 GIT binary patch literal 100981 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⋒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 ZDSu%ZNvA&g1UZ88LQPk-Ud1-*{{u(Jy+r^3 literal 0 HcmV?d00001 diff --git a/apps/frontend/src/app/admin/android-api/page.tsx b/apps/frontend/src/app/admin/android-api/page.tsx new file mode 100644 index 0000000..27da2f5 --- /dev/null +++ b/apps/frontend/src/app/admin/android-api/page.tsx @@ -0,0 +1,1318 @@ +'use client'; + +import React, { useState, useEffect } from 'react'; +import { useRouter } from 'next/navigation'; +import { useAuth } from '@/context/auth-context'; +import { api, getApiBaseUrl } from '@/lib/api-client'; +import { Navbar } from '@/components/layout/Navbar'; +import { Sidebar } from '@/components/layout/Sidebar'; +import { EcohubWatermark } from '@/components/common/EcohubWatermark'; +import { formatBytes, formatDate, copyTextToClipboard } from '@/lib/utils'; +import { + Smartphone, + Server, + Lock, + Upload, + Key, + Copy, + Check, + RefreshCw, + ExternalLink, + Play, + CheckCircle2, + AlertCircle, + FileCode, + Terminal, + Activity, + ShieldCheck, + HardDrive, + Code2, + FileText, + User, + ArrowRight, + Info, + Clock, + Layers, +} from 'lucide-react'; + +interface AndroidActivityLog { + id: string; + action: string; + actor: string; + actorEmail?: string; + ipAddress: string; + userAgent: string; + details: any; + createdAt: string; +} + +interface AndroidAdminOverview { + status: string; + apiVersion: string; + metrics: { + totalUsers: number; + totalFiles: number; + mobileLoginsCount: number; + mobileUploadsCount: number; + }; + configuration: { + maxFileSizeBytes: string; + allowedExtensions: string; + authType: string; + tokenDuration: string; + }; + recentActivity: AndroidActivityLog[]; +} + +export default function AndroidApiAdminPage() { + const router = useRouter(); + const { user, isAdmin, isSuperAdmin, canViewOtherUsers, isLoading } = useAuth(); + const [isSidebarOpen, setIsSidebarOpen] = useState(false); + + // Tab State + const [activeTab, setActiveTab] = useState<'docs' | 'tester' | 'android-code' | 'activity'>('docs'); + + // Overview data + const [overview, setOverview] = useState(null); + const [isDataLoading, setIsDataLoading] = useState(true); + const [copiedKey, setCopiedKey] = useState(null); + + // Live Tester State: Login + const [testIdentifier, setTestIdentifier] = useState(''); + const [testPassword, setTestPassword] = useState(''); + const [isLoggingIn, setIsLoggingIn] = useState(false); + const [loginResponse, setLoginResponse] = useState(null); + const [loginError, setLoginError] = useState(null); + + // Live Tester State: Upload + const [testBearerToken, setTestBearerToken] = useState(''); + const [selectedFile, setSelectedFile] = useState(null); + const [isUploading, setIsUploading] = useState(false); + const [uploadProgress, setUploadProgress] = useState(0); + const [uploadResponse, setUploadResponse] = useState(null); + const [uploadError, setUploadError] = useState(null); + + // Kotlin Code tab sub-tab + const [codeTab, setCodeTab] = useState<'service' | 'client' | 'models' | 'helper' | 'gradle'>('service'); + + const baseUrl = typeof window !== 'undefined' ? getApiBaseUrl() : 'http://localhost:4000/api/v1'; + + useEffect(() => { + if (!isLoading) { + if (!user) { + router.push('/login'); + } else if (!isAdmin || (!isSuperAdmin && !canViewOtherUsers)) { + router.push('/dashboard'); + } + } + }, [user, isAdmin, isSuperAdmin, canViewOtherUsers, isLoading, router]); + + const loadOverview = async () => { + setIsDataLoading(true); + try { + const res = await api.get('/android/admin/overview'); + setOverview(res); + } catch (err: any) { + console.error('Failed to load Android overview:', err); + } finally { + setIsDataLoading(false); + } + }; + + useEffect(() => { + if (user && isAdmin) { + loadOverview(); + } + }, [user, isAdmin]); + + const copyToClipboard = async (text: string, key: string) => { + try { + await copyTextToClipboard(text); + setCopiedKey(key); + setTimeout(() => setCopiedKey(null), 2000); + } catch (err) { + console.warn('Failed to copy to clipboard', err); + } + }; + + // Live Tester Handler: Login + const handleTestLogin = async (e: React.FormEvent) => { + e.preventDefault(); + if (!testIdentifier || !testPassword) { + setLoginError('Identifier and password are required'); + return; + } + setIsLoggingIn(true); + setLoginError(null); + setLoginResponse(null); + + const startTime = performance.now(); + try { + const res = await fetch(`${baseUrl}/android/auth/login`, { + method: 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify({ + identifier: testIdentifier, + password: testPassword, + deviceModel: 'Android Studio Emulator (Pixel 8 Pro)', + osVersion: 'Android 14 (API 34)', + appVersion: '1.0.0-admin-test', + }), + }); + const data = await res.json(); + const latency = Math.round(performance.now() - startTime); + + if (!res.ok) { + setLoginError(data.message || `HTTP ${res.status}: Login failed`); + } else { + setLoginResponse({ status: res.status, latency, ...data }); + if (data.accessToken) { + setTestBearerToken(data.accessToken); + } + } + } catch (err: any) { + setLoginError(err.message || 'Network error executing Android login request'); + } finally { + setIsLoggingIn(false); + } + }; + + // Live Tester Handler: Upload + const handleTestUpload = async (e: React.FormEvent) => { + e.preventDefault(); + if (!selectedFile) { + setUploadError('Please select a file to test upload'); + return; + } + const tokenToUse = testBearerToken || api.getToken(); + if (!tokenToUse) { + setUploadError('A Bearer access token is required. Log in via Step 1 or supply a token.'); + return; + } + + setIsUploading(true); + setUploadProgress(0); + setUploadError(null); + setUploadResponse(null); + + try { + const formData = new FormData(); + formData.append('file', selectedFile); + + const xhr = new XMLHttpRequest(); + xhr.open('POST', `${baseUrl}/android/files/upload`, true); + xhr.setRequestHeader('Authorization', `Bearer ${tokenToUse}`); + + xhr.upload.onprogress = (event) => { + if (event.lengthComputable) { + const percent = Math.round((event.loaded / event.total) * 100); + setUploadProgress(percent); + } + }; + + xhr.onload = () => { + setIsUploading(false); + try { + const res = JSON.parse(xhr.responseText); + if (xhr.status >= 200 && xhr.status < 300) { + setUploadResponse({ status: xhr.status, ...res }); + loadOverview(); + } else { + setUploadError(res.message || `HTTP ${xhr.status}: Upload failed`); + } + } catch { + setUploadError(`Failed to parse response: ${xhr.responseText}`); + } + }; + + xhr.onerror = () => { + setIsUploading(false); + setUploadError('Network error during file upload'); + }; + + xhr.send(formData); + } catch (err: any) { + setIsUploading(false); + setUploadError(err.message || 'Upload invocation failed'); + } + }; + + const loginCurl = `curl -X POST "${baseUrl}/android/auth/login" \\ + -H "Content-Type: application/json" \\ + -d '{ + "identifier": "your_email_or_username", + "password": "your_secure_password", + "deviceModel": "Pixel 8 Pro", + "appVersion": "1.0.0" + }'`; + + const uploadCurl = `curl -X POST "${baseUrl}/android/files/upload" \\ + -H "Authorization: Bearer " \\ + -F "file=@/path/to/your/photo.jpg" \\ + -F "folderId="`; + + const profileCurl = `curl -X GET "${baseUrl}/android/auth/me" \\ + -H "Authorization: Bearer "`; + + const filesCurl = `curl -X GET "${baseUrl}/android/files?page=1&limit=20" \\ + -H "Authorization: Bearer "`; + + // Kotlin Code Snippets + const kotlinApiService = `package com.ecohub.fileshare.api + +import okhttp3.MultipartBody +import okhttp3.RequestBody +import retrofit2.Response +import retrofit2.http.* + +interface EcohubApiService { + + /** + * 1. Android User Login + */ + @POST("android/auth/login") + suspend fun login( + @Body request: AndroidLoginRequest + ): Response + + /** + * 2. Direct Multipart File Upload + */ + @Multipart + @POST("android/files/upload") + suspend fun uploadFile( + @Part file: MultipartBody.Part, + @Part("folderId") folderId: RequestBody? = null + ): Response + + /** + * 3. Fetch Authenticated User Profile & Quota + */ + @GET("android/auth/me") + suspend fun getProfile(): Response + + /** + * 4. List User Cloud Files + */ + @GET("android/files") + suspend fun listFiles( + @Query("folderId") folderId: String? = null, + @Query("category") category: String? = null, + @Query("search") search: String? = null, + @Query("page") page: Int = 1, + @Query("limit") limit: Int = 50 + ): Response + + /** + * 5. Public Server Config & Limits + */ + @GET("android/config") + suspend fun getServerConfig(): Response +}`; + + const kotlinRetrofitClient = `package com.ecohub.fileshare.api + +import okhttp3.Interceptor +import okhttp3.OkHttpClient +import okhttp3.logging.HttpLoggingInterceptor +import retrofit2.Retrofit +import retrofit2.converter.gson.GsonConverterFactory +import java.util.concurrent.TimeUnit + +object RetrofitClient { + + // Target API Base URL (Dynamic host / LAN IP / Production Domain) + private const val BASE_URL = "${baseUrl}/" + + private var authToken: String? = null + + fun setToken(token: String?) { + authToken = token + } + + private val authInterceptor = Interceptor { chain -> + val original = chain.request() + val builder = original.newBuilder() + + // Automatically attach Bearer token if user is authenticated + authToken?.let { + builder.addHeader("Authorization", "Bearer $it") + } + + builder.addHeader("Accept", "application/json") + chain.proceed(builder.build()) + } + + private val loggingInterceptor = HttpLoggingInterceptor().apply { + level = HttpLoggingInterceptor.Level.BODY + } + + private val okHttpClient = OkHttpClient.Builder() + .addInterceptor(authInterceptor) + .addInterceptor(loggingInterceptor) + .connectTimeout(60, TimeUnit.SECONDS) + .readTimeout(120, TimeUnit.SECONDS) + .writeTimeout(120, TimeUnit.SECONDS) + .build() + + val apiService: EcohubApiService by lazy { + Retrofit.Builder() + .baseUrl(BASE_URL) + .client(okHttpClient) + .addConverterFactory(GsonConverterFactory.create()) + .build() + .create(EcohubApiService::class.java) + } +}`; + + const kotlinModels = `package com.ecohub.fileshare.api + +import com.google.gson.annotations.SerializedName + +// --- Authentication --- +data class AndroidLoginRequest( + @SerializedName("identifier") val identifier: String, + @SerializedName("password") val password: String, + @SerializedName("deviceModel") val deviceModel: String? = null, + @SerializedName("osVersion") val osVersion: String? = null, + @SerializedName("appVersion") val appVersion: String? = "1.0.0" +) + +data class AndroidLoginResponse( + @SerializedName("success") val success: Boolean, + @SerializedName("message") val message: String, + @SerializedName("accessToken") val accessToken: String, + @SerializedName("refreshToken") val refreshToken: String, + @SerializedName("tokenType") val tokenType: String, + @SerializedName("expiresIn") val expiresIn: Int, + @SerializedName("user") val user: UserDto, + @SerializedName("serverConfig") val serverConfig: ServerConfigDto? +) + +data class UserDto( + @SerializedName("id") val id: String, + @SerializedName("email") val email: String, + @SerializedName("username") val username: String, + @SerializedName("fullName") val fullName: String, + @SerializedName("companyName") val companyName: String?, + @SerializedName("role") val role: String, + @SerializedName("status") val status: String, + @SerializedName("storageQuotaBytes") val storageQuotaBytes: String, + @SerializedName("storageUsedBytes") val storageUsedBytes: String, + @SerializedName("canDeleteFiles") val canDeleteFiles: Boolean, + @SerializedName("canCreateShareLinks") val canCreateShareLinks: Boolean +) + +data class ServerConfigDto( + @SerializedName("uploadEndpoint") val uploadEndpoint: String, + @SerializedName("maxUploadSizeBytes") val maxUploadSizeBytes: String, + @SerializedName("allowedExtensions") val allowedExtensions: String, + @SerializedName("serverTime") val serverTime: String +) + +// --- File Upload --- +data class AndroidUploadResponse( + @SerializedName("success") val success: Boolean, + @SerializedName("message") val message: String, + @SerializedName("file") val file: UploadedFileDto +) + +data class UploadedFileDto( + @SerializedName("id") val id: String, + @SerializedName("originalFilename") val originalFilename: String, + @SerializedName("fileCategory") val fileCategory: String, + @SerializedName("fileSizeBytes") val fileSizeBytes: String, + @SerializedName("status") val status: String, + @SerializedName("downloadUrl") val downloadUrl: String, + @SerializedName("previewUrl") val previewUrl: String, + @SerializedName("createdAt") val createdAt: String +) + +data class UserProfileResponse( + @SerializedName("success") val success: Boolean, + @SerializedName("user") val user: UserDto +) + +data class FileListResponse( + @SerializedName("success") val success: Boolean, + @SerializedName("files") val files: List, + @SerializedName("total") val total: Int +) + +data class ServerConfigResponse( + @SerializedName("success") val success: Boolean, + @SerializedName("appName") val appName: String, + @SerializedName("version") val version: String, + @SerializedName("settings") val settings: Map +)`; + + const kotlinHelper = `package com.ecohub.fileshare.utils + +import android.content.Context +import android.net.Uri +import android.provider.OpenableColumns +import okhttp3.MediaType.Companion.toMediaTypeOrNull +import okhttp3.MultipartBody +import okhttp3.RequestBody.Companion.toRequestBody +import java.io.InputStream + +object FileUploadHelper { + + fun prepareFilePart(context: Context, partName: String, fileUri: Uri): MultipartBody.Part? { + val contentResolver = context.contentResolver + val filename = getFilename(context, fileUri) ?: "upload.bin" + val mimeType = contentResolver.getType(fileUri) ?: "application/octet-stream" + + val inputStream: InputStream? = contentResolver.openInputStream(fileUri) + val bytes = inputStream?.readBytes() ?: return null + inputStream.close() + + val requestBody = bytes.toRequestBody(mimeType.toMediaTypeOrNull()) + return MultipartBody.Part.createFormData(partName, filename, requestBody) + } + + private fun getFilename(context: Context, uri: Uri): String? { + var result: String? = null + if (uri.scheme == "content") { + context.contentResolver.query(uri, null, null, null, null)?.use { cursor -> + if (cursor.moveToFirst()) { + val idx = cursor.getColumnIndex(OpenableColumns.DISPLAY_NAME) + if (idx >= 0) result = cursor.getString(idx) + } + } + } + if (result == null) { + result = uri.path + val cut = result?.lastIndexOf('/') ?: -1 + if (cut != -1) result = result?.substring(cut + 1) + } + return result + } +}`; + + const gradleSnippet = `// In app/build.gradle.kts: +dependencies { + // Retrofit 2 & OkHttp + implementation("com.squareup.retrofit2:retrofit:2.11.0") + implementation("com.squareup.retrofit2:converter-gson:2.11.0") + implementation("com.squareup.okhttp3:okhttp:4.12.0") + implementation("com.squareup.okhttp3:logging-interceptor:4.12.0") + + // Kotlin Coroutines + implementation("org.jetbrains.kotlinx:kotlinx-coroutines-android:1.8.0") +} + +// In AndroidManifest.xml: + + + + + + + + +`; + + return ( +
+ setIsSidebarOpen(true)} /> + +
+ setIsSidebarOpen(false)} /> + +
+
+ {/* Header Card */} +
+
+
+ +
+
+
+ + + + + Mobile API Gateway + + + + Live & Ready + +
+

+ Android Application APIs & Gateway +

+

+ Dedicated, enterprise-grade endpoints designed for the Android mobile application. + Features identical authentication security (Argon2id + JWT Bearer), storage quota verification, + and multipart streaming uploads. +

+
+ +
+ + + + + Swagger API Docs + + + +
+
+ + {/* Metrics Bar */} +
+
+ + Base API Endpoint + + {baseUrl} +
+
+ + Auth Strategy + + Argon2id + JWT Bearer +
+
+ + Mobile Logins + + + {overview?.metrics.mobileLoginsCount ?? 0} + +
+
+ + Mobile Uploads + + + {overview?.metrics.mobileUploadsCount ?? 0} + +
+
+
+ + {/* Navigation Tabs */} +
+ + + + + + + +
+ + {/* TAB 1: API DOCUMENTATION */} + {activeTab === 'docs' && ( +
+ {/* 1. Android Login API */} +
+
+
+ + POST + + + {baseUrl}/android/auth/login + +
+
+ + Public / Unauthenticated + + +
+
+ +

+ Authenticates the Android user via username or email and password. Verifies Argon2id password hash, + checks user status (ACTIVE / PENDING / SUSPENDED), logs device information in the audit trail, and issues + JWT Access and Refresh tokens along with server upload configuration. +

+ +
+ {/* Request Schema */} +
+
+ Request Body (JSON) + Content-Type: application/json +
+
+{`{
+  "identifier": "user@ecohub.com", // username or email
+  "password": "your_secure_password",
+  "deviceModel": "Pixel 8 Pro",      // optional
+  "osVersion": "Android 14 (API 34)",// optional
+  "appVersion": "1.0.0"             // optional
+}`}
+                      
+
+ + {/* Response Schema */} +
+
+ Response (200 OK) + application/json +
+
+{`{
+  "success": true,
+  "message": "Android login successful",
+  "accessToken": "eyJhbGciOiJIUzI1Ni...",
+  "refreshToken": "eyJhbGciOiJIUzI1Ni...",
+  "tokenType": "Bearer",
+  "expiresIn": 900,
+  "user": {
+    "id": "uuid-v4",
+    "email": "user@ecohub.com",
+    "username": "johndoe",
+    "fullName": "John Doe",
+    "role": "USER",
+    "status": "ACTIVE",
+    "storageQuotaBytes": "5368709120",
+    "storageUsedBytes": "1205840",
+    "canDeleteFiles": true
+  },
+  "serverConfig": {
+    "uploadEndpoint": "/api/v1/android/files/upload",
+    "maxUploadSizeBytes": "5368709120",
+    "allowedExtensions": "mp4,mkv,mov,pdf,zip,jpg,png..."
+  }
+}`}
+                      
+
+
+
+ + {/* 2. Android Upload API */} +
+
+
+ + POST + + + {baseUrl}/android/files/upload + +
+
+ + Bearer Token Required + + +
+
+ +

+ Direct multipart/form-data upload from the Android application. Validates user storage quota before saving, + verifies file extension and magic byte signatures, computes canonical SHA-256 hash, stores in private storage, + and enqueues background video transcoding if the file is a video. +

+ +
+ {/* Headers & Form-Data */} +
+
+ Headers & Form-Data + multipart/form-data +
+
+{`Headers:
+  Authorization: Bearer 
+  Content-Type: multipart/form-data
+
+Form Parameters:
+  file: [Binary File Part] (Required)
+  folderId: "uuid" (Optional, defaults to root)`}
+                      
+
+ + {/* Upload Response */} +
+
+ Response (201 Created / 200 OK) + application/json +
+
+{`{
+  "success": true,
+  "message": "File uploaded successfully via Android API",
+  "file": {
+    "id": "e2d78901-443b-4682-8bc9-93e1075bb5f1",
+    "originalFilename": "presentation_video.mp4",
+    "fileCategory": "VIDEO",
+    "fileSizeBytes": "48102914",
+    "status": "PROCESSING",
+    "downloadUrl": "/api/v1/files/e2d78901.../download",
+    "previewUrl": "/api/v1/files/e2d78901.../preview",
+    "createdAt": "2026-10-17T09:00:00.000Z"
+  }
+}`}
+                      
+
+
+
+ + {/* 3. Other Endpoints Summary */} +
+
+
+ + GET + + Auth Required +
+

/android/auth/me

+

+ Returns live user profile, available and used storage quota, and company associations. +

+
+ +
+
+ + GET + + Auth Required +
+

/android/files

+

+ Lists user files with search, category filtering (VIDEO, IMAGE, DOC), and pagination. +

+
+ +
+
+ + GET + + Public +
+

/android/config

+

+ Public configuration endpoint returning max upload limits, allowed file formats, and features. +

+
+
+
+ )} + + {/* TAB 2: LIVE API TESTER */} + {activeTab === 'tester' && ( +
+
+ +
+ Interactive Android API Sandbox: Test the real backend endpoints + right here in the admin panel. Log in in Step 1 to generate an Android JWT token, and then immediately test + uploading a file in Step 2. +
+
+ +
+ {/* Step 1: Test Login */} +
+
+
+ + 1 + +

Test Android Login API

+
+ POST /android/auth/login +
+ +
+
+ + setTestIdentifier(e.target.value)} + placeholder="e.g. admin@ecohub.com or username" + className="w-full px-3.5 py-2.5 rounded-xl border border-slate-200 text-xs focus:ring-2 focus:ring-emerald-500 focus:outline-none" + required + /> +
+ +
+ + setTestPassword(e.target.value)} + placeholder="Account password" + className="w-full px-3.5 py-2.5 rounded-xl border border-slate-200 text-xs focus:ring-2 focus:ring-emerald-500 focus:outline-none" + required + /> +
+ + +
+ + {loginError && ( +
+ +
{loginError}
+
+ )} + + {loginResponse && ( +
+
+ + + HTTP {loginResponse.status} OK ({loginResponse.latency}ms) + + Token saved for Step 2 +
+
+
{JSON.stringify(loginResponse, null, 2)}
+
+
+ )} +
+ + {/* Step 2: Test File Upload */} +
+
+
+ + 2 + +

Test Android File Upload API

+
+ POST /android/files/upload +
+ +
+
+ + setTestBearerToken(e.target.value)} + placeholder="Bearer eyJhbGciOi..." + className="w-full px-3.5 py-2.5 rounded-xl border border-slate-200 text-xs font-mono focus:ring-2 focus:ring-emerald-500 focus:outline-none" + /> + + Automatically filled from Step 1 login, or falls back to current admin session token. + +
+ +
+ +
+ setSelectedFile(e.target.files?.[0] || null)} + className="w-full text-xs text-slate-500 file:mr-4 file:py-2 file:px-4 file:rounded-xl file:border-0 file:text-xs file:font-semibold file:bg-emerald-50 file:text-emerald-700 hover:file:bg-emerald-100" + /> + {selectedFile && ( +
+ Selected: {selectedFile.name} ({formatBytes(selectedFile.size)}) +
+ )} +
+
+ + {isUploading && ( +
+
+ Uploading bytes... + {uploadProgress}% +
+
+
+
+
+ )} + + + + + {uploadError && ( +
+ +
{uploadError}
+
+ )} + + {uploadResponse && ( +
+
+ + + Upload Succeeded (Status: {uploadResponse.status}) + + {uploadResponse.file?.id && ( + + View Preview + + )} +
+
+
{JSON.stringify(uploadResponse, null, 2)}
+
+
+ )} +
+
+
+ )} + + {/* TAB 3: ANDROID STUDIO KOTLIN CODE GENERATOR */} + {activeTab === 'android-code' && ( +
+
+
+

+ + Production-Ready Android (Kotlin) Implementation +

+

+ Copy-paste these complete Kotlin source files directly into your Android Studio project. +

+
+ + {/* Sub tabs */} +
+ + + + + +
+
+ + {/* Display Current Code File */} +
+
+ + + {codeTab === 'service' && 'com/ecohub/fileshare/api/EcohubApiService.kt'} + {codeTab === 'client' && 'com/ecohub/fileshare/api/RetrofitClient.kt'} + {codeTab === 'models' && 'com/ecohub/fileshare/api/Models.kt'} + {codeTab === 'helper' && 'com/ecohub/fileshare/utils/FileUploadHelper.kt'} + {codeTab === 'gradle' && 'build.gradle.kts & AndroidManifest.xml'} + + +
+ +
+                    {codeTab === 'service' && kotlinApiService}
+                    {codeTab === 'client' && kotlinRetrofitClient}
+                    {codeTab === 'models' && kotlinModels}
+                    {codeTab === 'helper' && kotlinHelper}
+                    {codeTab === 'gradle' && gradleSnippet}
+                  
+
+
+ )} + + {/* TAB 4: MOBILE ACTIVITY TRAIL */} + {activeTab === 'activity' && ( +
+
+
+

+ + Mobile App Audit Trail +

+

+ Live audit logging tracking Android logins, device models, OS versions, and direct file uploads. +

+
+ +
+ + {overview?.recentActivity && overview.recentActivity.length > 0 ? ( +
+ + + + + + + + + + + + + {overview.recentActivity.map((log) => ( + + + + + + + + + ))} + +
ActionActor / UserDevice / ClientIP AddressDetailsTime
+ + {log.action} + + +
{log.actor}
+ {log.actorEmail && ( +
{log.actorEmail}
+ )} +
+ {log.details?.deviceModel || log.userAgent || 'Android Client'} + + {log.ipAddress} + + {log.details?.filename + ? `File: ${log.details.filename} (${formatBytes(log.details.sizeBytes || 0)})` + : log.details?.identifier + ? `Identifier: ${log.details.identifier}` + : '-'} + + {formatDate(log.createdAt)} +
+
+ ) : ( +
+ +
No mobile activity recorded yet. Use the Live API Tester to simulate Android activity!
+
+ )} +
+ )} +
+ + +
+
+
+ ); +} diff --git a/apps/frontend/src/app/admin/audit/page.tsx b/apps/frontend/src/app/admin/audit/page.tsx new file mode 100644 index 0000000..b467d94 --- /dev/null +++ b/apps/frontend/src/app/admin/audit/page.tsx @@ -0,0 +1,545 @@ +'use client'; + +import React, { useState, useEffect, useMemo } from 'react'; +import { useRouter } from 'next/navigation'; +import { useAuth } from '@/context/auth-context'; +import { api } from '@/lib/api-client'; +import { formatDate, copyTextToClipboard } from '@/lib/utils'; +import { Navbar } from '@/components/layout/Navbar'; +import { Sidebar } from '@/components/layout/Sidebar'; +import { EcohubWatermark } from '@/components/common/EcohubWatermark'; +import { + ShieldAlert, + Search, + RefreshCw, + User, + Key, + Trash2, + Upload, + Play, + Info, + Shield, + Activity, + Globe, + Copy, + Check, + CheckCircle2, + FileText, + Building2, + Lock, + Layers, +} from 'lucide-react'; + +interface AuditLogItem { + id: string; + userId?: string | null; + actorUserId?: string | null; + action: string; + resourceType?: string | null; + resourceId?: string | null; + targetUserId?: string | null; + ipAddress?: string | null; + userAgent?: string | null; + details?: any | null; + detailsJson?: string | null; + createdAt: string; + actor?: { + id: string; + email: string; + username: string; + fullName: string; + role: string; + companyName?: string; + } | null; + targetUser?: { + id: string; + email: string; + username: string; + fullName: string; + } | null; + user?: { + id: string; + email: string; + fullName: string; + role: string; + companyName?: string; + } | null; +} + +export default function AdminAuditPage() { + const router = useRouter(); + const { user, isAdmin, canViewOtherUsers, isLoading } = useAuth(); + + const [logs, setLogs] = useState([]); + const [totalCount, setTotalCount] = useState(0); + const [isDataLoading, setIsDataLoading] = useState(true); + const [isSyncing, setIsSyncing] = useState(false); + const [lastSyncedAt, setLastSyncedAt] = useState(null); + const [search, setSearch] = useState(''); + const [actionFilter, setActionFilter] = useState(''); + const [selectedLog, setSelectedLog] = useState(null); + const [copiedPayload, setCopiedPayload] = useState(false); + const [isSidebarOpen, setIsSidebarOpen] = useState(false); + + useEffect(() => { + if (!isLoading) { + if (!user) router.push('/login'); + else if (!isAdmin || !canViewOtherUsers) router.push('/dashboard'); + } + }, [user, isAdmin, canViewOtherUsers, isLoading, router]); + + const loadLogs = async (isSilent = false) => { + if (!isSilent) setIsDataLoading(true); + setIsSyncing(true); + try { + const res = await api.get('/admin/audit-logs?limit=200'); + const rawList: any[] = Array.isArray(res) ? res : res?.logs || []; + const total = typeof res?.total === 'number' ? res.total : rawList.length; + setTotalCount(total); + + const mappedList: AuditLogItem[] = rawList.map((log) => { + let parsedDetails: any = null; + if (log.detailsJson) { + try { + parsedDetails = typeof log.detailsJson === 'string' ? JSON.parse(log.detailsJson) : log.detailsJson; + } catch { + parsedDetails = log.detailsJson; + } + } else if (log.details) { + parsedDetails = log.details; + } + + const effectiveActor = log.actor || log.user || null; + + return { + id: log.id, + userId: log.actorUserId || log.userId, + action: log.action || 'SYSTEM_ACTION', + resourceType: log.resourceType, + resourceId: log.resourceId, + targetUserId: log.targetUserId, + targetUser: log.targetUser, + ipAddress: log.ipAddress, + userAgent: log.userAgent, + details: parsedDetails, + detailsJson: log.detailsJson, + createdAt: log.createdAt, + actor: effectiveActor, + user: effectiveActor, + }; + }); + + setLogs(mappedList); + setLastSyncedAt(new Date()); + } catch (err) { + console.error('Failed to load audit logs', err); + } finally { + if (!isSilent) setIsDataLoading(false); + setIsSyncing(false); + } + }; + + useEffect(() => { + if (isAdmin && canViewOtherUsers) { + loadLogs(); + } + }, [isAdmin, canViewOtherUsers]); + + // Periodic Auto-Sync with Database (Silent every 10s + on Window Focus) + useEffect(() => { + if (!isAdmin || !canViewOtherUsers) return; + + const interval = setInterval(() => { + if (document.visibilityState === 'visible') { + loadLogs(true); + } + }, 10000); + + const handleFocus = () => { + loadLogs(true); + }; + + window.addEventListener('focus', handleFocus); + + return () => { + clearInterval(interval); + window.removeEventListener('focus', handleFocus); + }; + }, [isAdmin, canViewOtherUsers]); + + // Dynamic statistics + const stats = useMemo(() => { + const authCount = logs.filter( + (l) => l.action.includes('LOGIN') || l.action.includes('AUTH') || l.action.includes('LOGOUT'), + ).length; + const adminCount = logs.filter( + (l) => l.action.startsWith('ADMIN_') || l.action.includes('DELETED') || l.action.includes('SETTING'), + ).length; + const ips = new Set(logs.map((l) => l.ipAddress).filter(Boolean)).size; + + return { + total: totalCount || logs.length, + authEvents: authCount, + adminEvents: adminCount, + uniqueIps: ips || 1, + }; + }, [logs, totalCount]); + + const filteredLogs = useMemo(() => { + return logs.filter((log) => { + const actorEmail = log.actor?.email || log.user?.email || ''; + const actorName = log.actor?.fullName || log.user?.fullName || ''; + const targetName = log.targetUser?.fullName || log.targetUser?.email || ''; + + const matchesSearch = + !search || + log.action.toLowerCase().includes(search.toLowerCase()) || + actorEmail.toLowerCase().includes(search.toLowerCase()) || + actorName.toLowerCase().includes(search.toLowerCase()) || + targetName.toLowerCase().includes(search.toLowerCase()) || + (log.ipAddress && log.ipAddress.includes(search)) || + (log.resourceId && log.resourceId.includes(search)) || + (log.resourceType && log.resourceType.toLowerCase().includes(search.toLowerCase())); + + const matchesAction = !actionFilter || log.action === actionFilter; + + return matchesSearch && matchesAction; + }); + }, [logs, search, actionFilter]); + + const getActionBadge = (action: string) => { + let color = 'bg-slate-50 text-slate-700 border-slate-200'; + let icon = ; + + if (action.includes('FAILED')) { + color = 'bg-rose-50 text-rose-700 border-rose-200'; + icon = ; + } else if (action.includes('LOGIN') || action.includes('AUTH')) { + color = 'bg-emerald-50 text-emerald-700 border-emerald-200'; + icon = ; + } else if (action.includes('ADMIN_') || action.includes('PERMISSION') || action.includes('SHARE')) { + color = 'bg-indigo-50 text-indigo-700 border-indigo-200'; + icon = ; + } else if (action.includes('UPLOAD')) { + color = 'bg-sky-50 text-sky-700 border-sky-200'; + icon = ; + } else if (action.includes('STREAM') || action.includes('PLAY')) { + color = 'bg-purple-50 text-purple-700 border-purple-200'; + icon = ; + } else if (action.includes('DELETE') || action.includes('REVOKE') || action.includes('SUSPEND')) { + color = 'bg-rose-50 text-rose-700 border-rose-200'; + icon = ; + } + + return ( + + {icon} + {action} + + ); + }; + + const copyPayloadText = async (obj: any) => { + try { + await copyTextToClipboard(JSON.stringify(obj, null, 2)); + setCopiedPayload(true); + setTimeout(() => setCopiedPayload(false), 2000); + } catch (err) { + console.warn('Failed to copy payload', err); + } + }; + + const uniqueActions = Array.from(new Set(logs.map((l) => l.action))).sort(); + + return ( +
+ + + setIsSidebarOpen(!isSidebarOpen)} /> + +
+ setIsSidebarOpen(false)} /> + +
+
+ {/* Header */} +
+
+
+
+ +
+
+

+ Security & Compliance Audit Trail +

+

+ Chronological history of authentications, permissions, administrative actions and system events +

+
+
+
+ +
+ {/* Live Database Sync Badge */} +
+ + {isSyncing ? 'Syncing...' : 'Synced'} + +
+
+
+ + {/* Overview Summary Metric Cards */} +
+
+
+ +
+
+ Total Audit Records + {stats.total} +
+
+ +
+
+ +
+
+ User Auth Events + {stats.authEvents} +
+
+ +
+
+ +
+
+ Admin Operations + {stats.adminEvents} +
+
+ +
+
+ +
+
+ Active Client IPs + {stats.uniqueIps} +
+
+
+ + {/* Filters Bar */} +
+
+ + setSearch(e.target.value)} + className="w-full pl-9 pr-4 py-1.5 rounded-xl bg-slate-50 border border-slate-200 text-slate-900 text-xs placeholder:text-slate-400 focus:outline-none focus:border-emerald-600 transition-colors" + /> +
+ +
+ +
+
+ + {/* Audit Trail Table */} +
+
+ + + + + + + + + + + + + {filteredLogs.length > 0 ? ( + filteredLogs.map((log) => { + const actor = log.actor || log.user; + const hasDetails = log.details && (typeof log.details === 'object' ? Object.keys(log.details).length > 0 : true); + + return ( + + + + + + + + + ); + }) + ) : ( + + + + )} + +
TimestampAction TypeActor / UserTarget ResourceClient IPDetails
+ {formatDate(log.createdAt)} + + {getActionBadge(log.action)} + + {actor ? ( +
+
+ {actor.fullName ? actor.fullName.charAt(0).toUpperCase() : 'U'} +
+
+ + {actor.fullName} + + + {actor.email} + +
+
+ ) : ( + + System / Anon + + )} +
+ {log.resourceType ? ( + + + {log.resourceType} + + {log.resourceId && ( + + {log.resourceId.slice(0, 8)}... + + )} + + ) : ( + โ€” + )} + + {log.ipAddress || '127.0.0.1'} + + {hasDetails ? ( + + ) : ( + โ€” + )} +
+ {isDataLoading ? 'Loading audit records...' : 'No audit records match your search criteria.'} +
+
+
+ + {/* Inspect JSON Details Modal */} + {selectedLog && ( +
+
+
+
+
+ +
+
+

Audit Event Metadata

+

ID: {selectedLog.id}

+
+
+ +
+ +
+
+ Action + {selectedLog.action} +
+
+ Timestamp + {formatDate(selectedLog.createdAt)} +
+
+ Actor + + {selectedLog.actor?.fullName || selectedLog.user?.fullName || 'System'} + +
+
+ IP Address + {selectedLog.ipAddress || '127.0.0.1'} +
+
+ +
+
+ + +
+
+                      {JSON.stringify(selectedLog.details, null, 2)}
+                    
+
+ +
+ +
+
+
+ )} +
+
+
+
+ ); +} diff --git a/apps/frontend/src/app/admin/files/page.tsx b/apps/frontend/src/app/admin/files/page.tsx new file mode 100644 index 0000000..4c25bab --- /dev/null +++ b/apps/frontend/src/app/admin/files/page.tsx @@ -0,0 +1,413 @@ +'use client'; + +import React, { useState, useEffect } from 'react'; +import { useSearchParams, useRouter } from 'next/navigation'; +import { useAuth } from '@/context/auth-context'; +import { api } from '@/lib/api-client'; +import { formatBytes, formatDate } from '@/lib/utils'; +import { Navbar } from '@/components/layout/Navbar'; +import { Sidebar } from '@/components/layout/Sidebar'; +import { FileCard } from '@/components/file-manager/FileCard'; +import { FilePreviewModal } from '@/components/file-manager/FilePreviewModal'; +import { GrantPermissionModal } from '@/components/admin/GrantPermissionModal'; +import { BatchGrantModal } from '@/components/admin/BatchGrantModal'; +import { EcohubWatermark } from '@/components/common/EcohubWatermark'; +import { FileCategory } from '@fileshare/shared'; +import { + Files, + User, + Search, + HardDrive, + Loader2, + CheckSquare, + Square, + Download, + Layers, + Building2, + RefreshCw, +} from 'lucide-react'; + +function AdminFilesContent() { + const searchParams = useSearchParams(); + const initialUserId = searchParams.get('userId'); + const router = useRouter(); + const { user, isAdmin, canViewOtherUsers, isLoading } = useAuth(); + + const [usersList, setUsersList] = useState([]); + const [selectedUserId, setSelectedUserId] = useState(initialUserId || ''); + const [targetUserData, setTargetUserData] = useState(null); + const [files, setFiles] = useState([]); + const [isDataLoading, setIsDataLoading] = useState(false); + const [isSyncing, setIsSyncing] = useState(false); + const [lastSyncedAt, setLastSyncedAt] = useState(null); + const [search, setSearch] = useState(''); + const [categoryFilter, setCategoryFilter] = useState(''); + const [isSidebarOpen, setIsSidebarOpen] = useState(false); + + // Multi-selection state for 1-by-1 or select-all permission grant + const [selectedFileIds, setSelectedFileIds] = useState([]); + + // Modals + const [selectedFileForPreview, setSelectedFileForPreview] = useState(null); + const [permissionTargetFile, setPermissionTargetFile] = useState(null); + const [isBatchGrantOpen, setIsBatchGrantOpen] = useState(false); + + useEffect(() => { + if (!isLoading) { + if (!user) router.push('/login'); + else if (!isAdmin || !canViewOtherUsers) router.push('/dashboard'); + } + }, [user, isAdmin, canViewOtherUsers, isLoading, router]); + + useEffect(() => { + if (isAdmin && canViewOtherUsers) { + api.get('/admin/users?limit=100').then((res) => { + setUsersList(res.users || []); + if (!selectedUserId && res.users?.length > 0) { + setSelectedUserId(res.users[0].id); + } + }); + } + }, [isAdmin, canViewOtherUsers, selectedUserId]); + + const loadFiles = (isSilent = false) => { + if (selectedUserId && isAdmin) { + if (!isSilent) setIsDataLoading(true); + setIsSyncing(true); + let query = `/admin/users/${selectedUserId}/files?limit=100`; + if (search) query += `&search=${encodeURIComponent(search)}`; + if (categoryFilter) query += `&category=${categoryFilter}`; + + api.get(query) + .then((res) => { + setTargetUserData(res.targetUser); + setFiles(res.files || []); + setLastSyncedAt(new Date()); + }) + .catch((err) => { + console.error('Failed to load user files', err); + }) + .finally(() => { + if (!isSilent) setIsDataLoading(false); + setIsSyncing(false); + }); + } + }; + + useEffect(() => { + loadFiles(); + }, [selectedUserId, search, categoryFilter, isAdmin]); + + // Periodic Auto-Sync with Database (Silent every 8s, faster 3s if processing videos) + useEffect(() => { + if (!selectedUserId || !isAdmin) return; + + const hasProcessingVideos = files.some( + (f) => f.transcodeStatus === 'PROCESSING' || f.transcodeStatus === 'PENDING', + ); + const intervalMs = hasProcessingVideos ? 3000 : 8000; + + const timer = setInterval(() => { + if (document.visibilityState === 'visible') { + loadFiles(true); + } + }, intervalMs); + + const handleFocus = () => { + loadFiles(true); + }; + + window.addEventListener('focus', handleFocus); + + return () => { + clearInterval(timer); + window.removeEventListener('focus', handleFocus); + }; + }, [selectedUserId, isAdmin, search, categoryFilter, files]); + + const toggleSelectFile = (fileId: string) => { + setSelectedFileIds((prev) => + prev.includes(fileId) ? prev.filter((id) => id !== fileId) : [...prev, fileId], + ); + }; + + const handleSelectAll = () => { + if (selectedFileIds.length === files.length) { + setSelectedFileIds([]); + } else { + setSelectedFileIds(files.map((f) => f.id)); + } + }; + + if (isLoading || !isAdmin) { + return ( +
+ +
+ ); + } + + return ( +
+ + + setIsSidebarOpen(!isSidebarOpen)} /> + +
+ setIsSidebarOpen(false)} /> + +
+
+ {/* Header */} +
+
+
+

+ + User-wise Video & File Inventory Explorer +

+ {/* Live Database Sync Badge */} +
+ + {isSyncing ? 'Syncing...' : 'Live DB Sync'} +
+
+

+ Admin & Superadmin can inspect, download videos user-wise, and grant permissions 1-by-1 or all at once +

+
+ +
+ {/* Manual Sync Button */} + + + {/* Target User Switcher */} +
+ + +
+
+
+ + {/* User Quota Banner & Batch Action Bar */} + {targetUserData && ( +
+
+
+ +
+
+
+ + {targetUserData.fullName} ({targetUserData.email}) + + {targetUserData.companyName && ( + + + {targetUserData.companyName} + + )} +
+ + Storage: {formatBytes(targetUserData.storageUsedBytes)} / {formatBytes(targetUserData.storageQuotaBytes)} + +
+
+ + {/* Selection Controls & Bulk Permissions */} +
+ + + +
+
+ )} + + {/* Filter and Search Bar */} +
+
+ + setSearch(e.target.value)} + className="w-full pl-8 pr-3 py-1.5 rounded-xl bg-slate-50 border border-slate-200 text-slate-900 placeholder:text-slate-400 focus:outline-none focus:border-emerald-600" + /> +
+ +
+ +
+
+ + {/* Files Grid with selection checkboxes and direct download */} + {isDataLoading ? ( +
+ +
+ ) : files.length === 0 ? ( +
+

No files found for this user

+
+ ) : ( +
+ {files.map((file) => { + const isSelected = selectedFileIds.includes(file.id); + const downloadUrl = api.getDownloadUrl(file.id); + + return ( +
+ {/* Checkbox badge on top-left for 1-by-1 selection */} + + + {/* Direct Download Button for Super Admin / Admin */} + + + + + setSelectedFileForPreview(f)} + onRename={() => {}} + onMove={() => {}} + onDelete={async (f) => { + if (confirm(`Administrative delete: Remove file "${f.originalFilename}"?`)) { + await api.delete(`/files/${f.id}`); + loadFiles(); + } + }} + /> +
+ ); + })} +
+ )} +
+
+
+ + setSelectedFileForPreview(null)} + file={selectedFileForPreview} + /> + + setPermissionTargetFile(null)} + onSuccess={loadFiles} + preselectedFile={permissionTargetFile} + /> + + setIsBatchGrantOpen(false)} + selectedFileIds={selectedFileIds} + ownerId={selectedUserId} + onSuccess={loadFiles} + /> +
+ ); +} + +export default function AdminFilesPage() { + return ( + + + + } + > + + + ); +} diff --git a/apps/frontend/src/app/admin/permissions/page.tsx b/apps/frontend/src/app/admin/permissions/page.tsx new file mode 100644 index 0000000..449a442 --- /dev/null +++ b/apps/frontend/src/app/admin/permissions/page.tsx @@ -0,0 +1,357 @@ +'use client'; + +import React, { useState, useEffect } from 'react'; +import { useRouter } from 'next/navigation'; +import { useAuth } from '@/context/auth-context'; +import { api } from '@/lib/api-client'; +import { Navbar } from '@/components/layout/Navbar'; +import { Sidebar } from '@/components/layout/Sidebar'; +import { GrantPermissionModal } from '@/components/admin/GrantPermissionModal'; +import { BatchGrantModal } from '@/components/admin/BatchGrantModal'; +import { EcohubWatermark } from '@/components/common/EcohubWatermark'; +import { + KeyRound, + Plus, + Trash2, + Ban, + CheckCircle, + XCircle, + Loader2, + Layers, + RefreshCw, +} from 'lucide-react'; + +export default function AdminPermissionsPage() { + const router = useRouter(); + const { user, isAdmin, canViewOtherUsers, isLoading } = useAuth(); + + const [permissions, setPermissions] = useState([]); + const [total, setTotal] = useState(0); + const [isDataLoading, setIsDataLoading] = useState(true); + const [isSyncing, setIsSyncing] = useState(false); + const [lastSyncedAt, setLastSyncedAt] = useState(null); + const [isGrantModalOpen, setIsGrantModalOpen] = useState(false); + const [isBatchModalOpen, setIsBatchModalOpen] = useState(false); + const [isSidebarOpen, setIsSidebarOpen] = useState(false); + const [activeOnly, setActiveOnly] = useState(false); + + useEffect(() => { + if (!isLoading) { + if (!user) router.push('/login'); + else if (!isAdmin || !canViewOtherUsers) router.push('/dashboard'); + } + }, [user, isAdmin, canViewOtherUsers, isLoading, router]); + + const loadPermissions = async (isSilent = false) => { + if (!isSilent) setIsDataLoading(true); + setIsSyncing(true); + try { + const res = await api.get( + `/admin/permissions?limit=100${activeOnly ? '&activeOnly=true' : ''}`, + ); + setPermissions(res.permissions || []); + setTotal(res.total || 0); + setLastSyncedAt(new Date()); + } catch (err) { + console.error('Failed to load permissions', err); + } finally { + if (!isSilent) setIsDataLoading(false); + setIsSyncing(false); + } + }; + + useEffect(() => { + if (isAdmin && canViewOtherUsers) { + loadPermissions(); + } + }, [isAdmin, canViewOtherUsers, activeOnly]); + + // Periodic Auto-Sync with Database (Silent every 10s + on Window Focus) + useEffect(() => { + if (!isAdmin || !canViewOtherUsers) return; + + const interval = setInterval(() => { + if (document.visibilityState === 'visible') { + loadPermissions(true); + } + }, 10000); + + const handleFocus = () => { + loadPermissions(true); + }; + + window.addEventListener('focus', handleFocus); + + return () => { + clearInterval(interval); + window.removeEventListener('focus', handleFocus); + }; + }, [isAdmin, canViewOtherUsers, activeOnly]); + + const handleRevoke = async (id: string) => { + if (confirm('Revoke this permission? Access will be immediately blocked.')) { + try { + await api.post(`/admin/permissions/${id}/revoke`, {}); + loadPermissions(); + } catch (err: any) { + alert(err.message || 'Failed to revoke permission'); + } + } + }; + + const handleDelete = async (id: string) => { + if (confirm('Permanently delete this permission record?')) { + try { + await api.delete(`/admin/permissions/${id}`); + loadPermissions(); + } catch (err: any) { + alert(err.message || 'Failed to delete permission'); + } + } + }; + + if (isLoading || !isAdmin) { + return ( +
+ +
+ ); + } + + return ( +
+ + + setIsSidebarOpen(!isSidebarOpen)} /> + +
+ setIsSidebarOpen(false)} /> + +
+
+ {/* Header */} +
+
+
+

+ + Access Control & Permission Matrix +

+ {/* Live Database Sync Badge */} +
+ + {isSyncing ? 'Syncing...' : 'Live DB Sync'} +
+
+

+ Centrally control user-to-user sharing rights with separate play, download, and preview authorization +

+
+ +
+ {/* Manual Sync Button */} + + + + + +
+
+ + {/* Table */} + {isDataLoading ? ( +
+ +
+ ) : permissions.length === 0 ? ( +
+ +

No sharing permissions defined

+

+ Users currently have private access to their own files only. Click "Grant New Permission" to authorize cross-user access. +

+
+ ) : ( +
+
+ + + + + + + + + + + + + + + + {permissions.map((p) => { + const isRevoked = !!p.revokedAt; + const isExpired = p.expiresAt && new Date(p.expiresAt) < new Date(); + + return ( + + {/* Scope */} + + + {/* Owner */} + + + {/* Grantee */} + + + {/* Metadata */} + + + {/* Preview */} + + + {/* Play */} + + + {/* Download */} + + + {/* Status */} + + + {/* Actions */} + + + ); + })} + +
ScopeOwnerGrantee (Recipient)MetadataPreviewPlayDownloadStatusActions
+
+ + {p.resourceType} + + {p.resourceId && ( + + {p.resourceId} + + )} +
+
+ + {p.owner?.fullName || 'User'} + + + {p.owner?.email} + + + + {p.grantee?.fullName || 'User'} + + + {p.grantee?.email} + + + {p.canViewMetadata ? ( + + ) : ( + + )} + + {p.canPreview ? ( + + ) : ( + + )} + + {p.canPlay ? ( + + ) : ( + + )} + + {p.canDownload ? ( + + ) : ( + + )} + + {isRevoked ? ( + + Revoked + + ) : isExpired ? ( + + Expired + + ) : ( + + Active + + )} + +
+ {!isRevoked && ( + + )} + +
+
+
+
+ )} +
+
+
+ + setIsGrantModalOpen(false)} + onSuccess={loadPermissions} + /> + + setIsBatchModalOpen(false)} + onSuccess={loadPermissions} + /> +
+ ); +} diff --git a/apps/frontend/src/app/admin/users/page.tsx b/apps/frontend/src/app/admin/users/page.tsx new file mode 100644 index 0000000..849c2da --- /dev/null +++ b/apps/frontend/src/app/admin/users/page.tsx @@ -0,0 +1,998 @@ +'use client'; + +import React, { useState, useEffect, useMemo } from 'react'; +import Link from 'next/link'; +import { useRouter } from 'next/navigation'; +import { useAuth } from '@/context/auth-context'; +import { api } from '@/lib/api-client'; +import { formatBytes, formatDate, copyTextToClipboard } from '@/lib/utils'; +import { Navbar } from '@/components/layout/Navbar'; +import { Sidebar } from '@/components/layout/Sidebar'; +import { CreateUserModal } from '@/components/admin/CreateUserModal'; +import { EditUserModal } from '@/components/admin/EditUserModal'; +import { AdminResetPasswordModal } from '@/components/admin/AdminResetPasswordModal'; +import { DeleteUserModal } from '@/components/admin/DeleteUserModal'; +import { EcohubWatermark } from '@/components/common/EcohubWatermark'; +import { UserRole, UserStatus } from '@fileshare/shared'; +import { + Users, + UserPlus, + Search, + Building2, + Edit2, + Loader2, + Eye, + EyeOff, + Copy, + Check, + KeyRound, + Download, + Share2, + Trash2, + Server, + RefreshCw, + LayoutGrid, + List, + Shield, + HardDrive, + CheckCircle2, + FolderOpen, +} from 'lucide-react'; + +export default function AdminUsersPage() { + const router = useRouter(); + const { user, isAdmin, isSuperAdmin, canViewOtherUsers, isLoading } = useAuth(); + + const [usersList, setUsersList] = useState([]); + const [total, setTotal] = useState(0); + const [search, setSearch] = useState(''); + const [roleFilter, setRoleFilter] = useState(''); + const [statusFilter, setStatusFilter] = useState(''); + const [viewMode, setViewMode] = useState<'table' | 'cards'>('table'); + const [isDataLoading, setIsDataLoading] = useState(true); + const [isSyncing, setIsSyncing] = useState(false); + const [lastSyncedAt, setLastSyncedAt] = useState(null); + + // Password visibility map & copied state + const [visiblePasswords, setVisiblePasswords] = useState>({}); + const [copiedId, setCopiedId] = useState(null); + + // Modals + const [isCreateOpen, setIsCreateOpen] = useState(false); + const [editTargetUser, setEditTargetUser] = useState(null); + const [resetPasswordTargetUser, setResetPasswordTargetUser] = useState(null); + const [deleteTargetUser, setDeleteTargetUser] = useState(null); + const [isSidebarOpen, setIsSidebarOpen] = useState(false); + + useEffect(() => { + if (!isLoading) { + if (!user) router.push('/login'); + else if (!isAdmin || !canViewOtherUsers) router.push('/dashboard'); + } + }, [user, isAdmin, canViewOtherUsers, isLoading, router]); + + const loadUsers = async (isSilent = false) => { + if (!isSilent) { + setIsDataLoading(true); + } + setIsSyncing(true); + try { + let query = `/admin/users?limit=100`; + if (search) query += `&search=${encodeURIComponent(search)}`; + if (roleFilter) query += `&role=${roleFilter}`; + if (statusFilter) query += `&status=${statusFilter}`; + + const res = await api.get(query); + setUsersList(res.users || []); + setTotal(res.total || 0); + setLastSyncedAt(new Date()); + } catch (err) { + console.error('Failed to load users', err); + } finally { + if (!isSilent) setIsDataLoading(false); + setIsSyncing(false); + } + }; + + useEffect(() => { + if (isAdmin && canViewOtherUsers) { + loadUsers(); + } + }, [isAdmin, canViewOtherUsers, search, roleFilter, statusFilter]); + + // Periodic Auto-Sync with Database (Silent every 10s + on Window Focus) + useEffect(() => { + if (!isAdmin || !canViewOtherUsers) return; + + const interval = setInterval(() => { + if (document.visibilityState === 'visible') { + loadUsers(true); + } + }, 10000); + + const handleFocus = () => { + loadUsers(true); + }; + + window.addEventListener('focus', handleFocus); + + return () => { + clearInterval(interval); + window.removeEventListener('focus', handleFocus); + }; + }, [isAdmin, canViewOtherUsers, search, roleFilter, statusFilter]); + + const togglePasswordVisibility = (userId: string) => { + setVisiblePasswords((prev) => ({ + ...prev, + [userId]: !prev[userId], + })); + }; + + const copyPassword = async (userId: string, pass: string) => { + try { + await copyTextToClipboard(pass); + setCopiedId(userId); + setTimeout(() => setCopiedId(null), 2000); + } catch (err) { + console.warn('Failed to copy password', err); + } + }; + + const handleToggleSharePermission = async (targetUser: any) => { + try { + await api.patch(`/admin/users/${targetUser.id}`, { + canCreateShareLinks: !targetUser.canCreateShareLinks, + }); + loadUsers(true); + } catch (err: any) { + alert(err.message || 'Failed to update share permission'); + } + }; + + const handleToggleDeletePermission = async (targetUser: any) => { + try { + await api.patch(`/admin/users/${targetUser.id}`, { + canDeleteFiles: !targetUser.canDeleteFiles, + }); + loadUsers(true); + } catch (err: any) { + alert(err.message || 'Failed to update delete permission'); + } + }; + + const handleToggleViewOtherUsersPermission = async (targetUser: any) => { + if (!isSuperAdmin) return; + try { + await api.patch(`/admin/users/${targetUser.id}`, { + canViewOtherUsers: !targetUser.canViewOtherUsers, + }); + loadUsers(true); + } catch (err: any) { + alert(err.message || 'Failed to update view users permission'); + } + }; + + const handleApproveUser = async (targetUser: any) => { + try { + await api.patch(`/admin/users/${targetUser.id}`, { + status: UserStatus.ACTIVE, + }); + loadUsers(true); + } catch (err: any) { + alert(err.message || 'Failed to approve user'); + } + }; + + // Dynamic Summary Metrics + const stats = useMemo(() => { + const activeCount = usersList.filter((u) => u.status === UserStatus.ACTIVE).length; + const pendingCount = usersList.filter((u) => u.status === UserStatus.PENDING).length; + const companies = new Set(usersList.map((u) => u.companyName || 'Ecohub')).size; + const totalStorageBytes = usersList.reduce((acc, u) => acc + Number(u.storageQuotaBytes || 0), 0); + const totalUsedBytes = usersList.reduce((acc, u) => acc + Number(u.storageUsedBytes || 0), 0); + + return { + totalUsers: total || usersList.length, + activeUsers: activeCount, + pendingUsers: pendingCount, + totalCompanies: companies, + storageUsedFormatted: formatBytes(totalUsedBytes), + storageQuotaFormatted: formatBytes(totalStorageBytes), + }; + }, [usersList, total]); + + const getInitials = (name?: string) => { + if (!name) return 'U'; + const parts = name.trim().split(' '); + if (parts.length >= 2) return `${parts[0][0]}${parts[1][0]}`.toUpperCase(); + return name.slice(0, 2).toUpperCase(); + }; + + const getAvatarBg = (role?: UserRole) => { + if (role === UserRole.SUPER_ADMIN) return 'bg-gradient-to-br from-rose-500 to-red-600 text-white'; + if (role === UserRole.ADMIN) return 'bg-gradient-to-br from-amber-500 to-orange-600 text-white'; + return 'bg-gradient-to-br from-emerald-500 to-teal-600 text-white'; + }; + + const parseAllowedCompanies = (raw: string | null | undefined, primary: string) => { + if (raw === '*') return { all: true, count: 0, list: [] }; + if (!raw) return { all: false, count: 0, list: [] }; + try { + const list: string[] = raw.startsWith('[') + ? JSON.parse(raw) + : raw.split(',').map((s) => s.trim()).filter(Boolean); + const others = list.filter((c) => c.toLowerCase() !== primary.toLowerCase()); + return { all: false, count: others.length, list: others }; + } catch { + return { all: false, count: 0, list: [] }; + } + }; + + if (isLoading || !isAdmin || !canViewOtherUsers) { + return ( +
+ +
+ ); + } + + return ( +
+ + + setIsSidebarOpen(!isSidebarOpen)} /> + +
+ setIsSidebarOpen(false)} /> + +
+
+ {/* Top Header */} +
+
+
+
+ +
+
+

+ User Directory & Organizations +

+

+ Manage registered users, company access scopes, passwords & storage +

+
+
+
+ +
+ {/* Live DB Sync Indicator */} +
+ + {isSyncing ? 'Syncing...' : 'Synced'} + +
+ + {/* View Mode Toggle */} +
+ + +
+ + {/* Create User Button */} + +
+
+ + {/* Quick Metrics Bar (User-Friendly Overview) */} +
+
+
+ +
+
+ Total Users + {stats.totalUsers} +
+
+ +
+
+ +
+
+ Active Accounts + {stats.activeUsers} +
+
+ +
+
+ +
+
+ Organizations + {stats.totalCompanies} +
+
+ +
+
+ +
+
+ Storage Used / Quota + + {stats.storageUsedFormatted} / {stats.storageQuotaFormatted} + +
+
+
+ + {/* Pending Approvals Alert Banner */} + {stats.pendingUsers > 0 && ( +
+
+ +
+ + {stats.pendingUsers} Self-Registered User{stats.pendingUsers > 1 ? 's' : ''} Awaiting Approval + +

+ New users cannot log in until an Administrator or Super Admin activates their account. +

+
+
+
+ + {statusFilter === UserStatus.PENDING && ( + + )} +
+
+ )} + + {/* Filters Bar */} +
+
+ + setSearch(e.target.value)} + className="w-full pl-9 pr-4 py-1.5 rounded-xl bg-slate-50 border border-slate-200 text-slate-900 text-xs placeholder:text-slate-400 focus:outline-none focus:border-emerald-600 transition-colors" + /> +
+ +
+ + + +
+
+ + {/* Main Content Area */} + {isDataLoading ? ( +
+ + Loading user directory... +
+ ) : usersList.length === 0 ? ( +
+ +

No users found

+

Try adjusting your search query or filters.

+
+ ) : viewMode === 'table' ? ( + /* Fit-To-Screen Compact Modern Table */ +
+
+ + + + + + + + + {isSuperAdmin && } + + + + + {usersList.map((u) => { + const quota = Number(u.storageQuotaBytes); + const used = Number(u.storageUsedBytes); + const pct = quota > 0 ? Math.min(Math.round((used / quota) * 100), 100) : 0; + const isVisible = !!visiblePasswords[u.id]; + const orgScope = parseAllowedCompanies(u.allowedCompanies, u.companyName || 'Ecohub'); + + return ( + + {/* User Avatar & Info */} + + + {/* Organization & Permissions Scope */} + + + {/* Role & Status */} + + + {/* Storage Gauge */} + + + {/* Clean Interactive Permission Icons */} + + + {/* Super Admin Password Viewing */} + {isSuperAdmin && ( + + )} + + {/* Sleek Action Buttons */} + + + ); + })} + +
UserOrganization & ScopesRole & StatusStorage QuotaFeature TogglesPasswordActions
+
+
+ {getInitials(u.fullName)} +
+
+ + {u.fullName} + + + @{u.username} โ€ข {u.email} + +
+
+
+
+ + + {u.companyName || 'Ecohub'} + + + {/* Scope Badge */} + {u.role === UserRole.SUPER_ADMIN || orgScope.all ? ( + + All Orgs Access + + ) : orgScope.count > 0 ? ( + + +{orgScope.count} Other {orgScope.count === 1 ? 'Org' : 'Orgs'} + + ) : ( + Own Org Only + )} +
+
+
+ + {u.role === UserRole.SUPER_ADMIN ? 'Super Admin' : u.role} + + + + {u.status === UserStatus.PENDING ? 'Pending Approval' : u.status} + +
+
+
+
+ {formatBytes(used)} + / {formatBytes(quota)} +
+
+
90 ? 'bg-rose-500' : 'bg-emerald-500' + }`} + style={{ width: `${pct}%` }} + /> +
+
+
+
+ + + + + {isSuperAdmin && ( + + )} +
+
+
+ + {isVisible ? u.viewablePassword || '' : 'โ€ขโ€ขโ€ขโ€ขโ€ขโ€ข'} + + + {u.viewablePassword && isVisible && ( + + )} +
+
+
+ {u.status === UserStatus.PENDING && ( + + )} + + + + + + + + + + {(() => { + const isOtherCompany = + !isSuperAdmin && + (u.companyName || 'Ecohub').trim().toLowerCase() !== + (user?.companyName || 'Ecohub').trim().toLowerCase(); + const cannotDeleteUser = u.id === user?.id || isOtherCompany; + + return ( + + ); + })()} +
+
+
+
+ ) : ( + /* User-Friendly Cards Grid View */ +
+ {usersList.map((u) => { + const quota = Number(u.storageQuotaBytes); + const used = Number(u.storageUsedBytes); + const pct = quota > 0 ? Math.min(Math.round((used / quota) * 100), 100) : 0; + const isVisible = !!visiblePasswords[u.id]; + const orgScope = parseAllowedCompanies(u.allowedCompanies, u.companyName || 'Ecohub'); + + return ( +
+ {/* Card Header */} +
+
+
+ {getInitials(u.fullName)} +
+
+

+ {u.fullName} +

+ + @{u.username} + + {u.email} +
+
+ +
+ + {u.role === UserRole.SUPER_ADMIN ? 'Super Admin' : u.role} + + + + {u.status === UserStatus.PENDING ? 'Pending' : u.status} + +
+
+ + {/* Company & Permitted Scope */} +
+
+ + + Company / Org: + + {u.companyName || 'Ecohub'} +
+ +
+ Access Scope: + {u.role === UserRole.SUPER_ADMIN || orgScope.all ? ( + + All Organizations + + ) : orgScope.count > 0 ? ( + + +{orgScope.count} Other Orgs + + ) : ( + Own Org Only + )} +
+
+ + {/* Storage Progress */} +
+
+ + + {formatBytes(used)} used + + {formatBytes(quota)} quota ({pct}%) +
+
+
90 ? 'bg-rose-500' : 'bg-emerald-500' + }`} + style={{ width: `${pct}%` }} + /> +
+
+ + {/* Feature Permissions Interactive Switch Bar */} +
+ Permissions: +
+ + + + + {isSuperAdmin && ( + + )} +
+
+ + {/* Card Footer Actions */} +
+ + + Files ({u.fileCount || 0}) + + +
+ {u.status === UserStatus.PENDING && ( + + )} + + + + + + {(() => { + const isOtherCompany = + !isSuperAdmin && + (u.companyName || 'Ecohub').trim().toLowerCase() !== + (user?.companyName || 'Ecohub').trim().toLowerCase(); + const cannotDeleteUser = u.id === user?.id || isOtherCompany; + + return ( + + ); + })()} +
+
+
+ ); + })} +
+ )} +
+
+
+ + setIsCreateOpen(false)} + onSuccess={loadUsers} + /> + + setEditTargetUser(null)} + onSuccess={loadUsers} + user={editTargetUser} + /> + + setResetPasswordTargetUser(null)} + onSuccess={loadUsers} + user={resetPasswordTargetUser} + /> + + setDeleteTargetUser(null)} + onSuccess={loadUsers} + user={deleteTargetUser} + /> +
+ ); +} diff --git a/apps/frontend/src/app/dashboard/page.tsx b/apps/frontend/src/app/dashboard/page.tsx new file mode 100644 index 0000000..04c269d --- /dev/null +++ b/apps/frontend/src/app/dashboard/page.tsx @@ -0,0 +1,325 @@ +'use client'; + +import React, { useState, useEffect } from 'react'; +import Link from 'next/link'; +import { useRouter } from 'next/navigation'; +import { useAuth } from '@/context/auth-context'; +import { api } from '@/lib/api-client'; +import { formatBytes } from '@/lib/utils'; +import { Navbar } from '@/components/layout/Navbar'; +import { Sidebar } from '@/components/layout/Sidebar'; +import { FileUploaderModal } from '@/components/uploader/FileUploaderModal'; +import { FilePreviewModal } from '@/components/file-manager/FilePreviewModal'; +import { FileCard } from '@/components/file-manager/FileCard'; +import { EcohubWatermark } from '@/components/common/EcohubWatermark'; +import { + HardDrive, + Video, + FileText, + Share2, + UploadCloud, + ArrowRight, + Clock, + Sparkles, + Building2, + FolderOpen, +} from 'lucide-react'; + +export default function DashboardPage() { + const router = useRouter(); + const { user, isLoading, refreshProfile } = useAuth(); + + const [recentFiles, setRecentFiles] = useState([]); + const [sharedCount, setSharedCount] = useState(0); + const [videoCount, setVideoCount] = useState(0); + const [isUploadOpen, setIsUploadOpen] = useState(false); + const [isSidebarOpen, setIsSidebarOpen] = useState(false); + const [selectedFileForPreview, setSelectedFileForPreview] = useState(null); + const [isSyncing, setIsSyncing] = useState(false); + const [lastSyncedAt, setLastSyncedAt] = useState(null); + + useEffect(() => { + if (!isLoading && !user) { + router.push('/login'); + } + }, [user, isLoading, router]); + + const fetchDashboardData = async (isSilent = false) => { + if (!isSilent) setIsSyncing(true); + try { + const [filesRes, sharedRes]: [any, any] = await Promise.all([ + api.get('/files?limit=8&sortBy=date&sortOrder=desc'), + api.get('/sharing/shared-with-me'), + ]); + + setRecentFiles(filesRes.files || []); + setSharedCount(sharedRes.length || 0); + + const videos = (filesRes.files || []).filter((f: any) => f.fileCategory === 'VIDEO'); + setVideoCount(videos.length); + setLastSyncedAt(new Date()); + } catch (err) { + console.error('Failed to load dashboard data', err); + } finally { + if (!isSilent) setIsSyncing(false); + } + }; + + useEffect(() => { + if (user) { + fetchDashboardData(); + } + }, [user?.id]); + + // Periodic Auto-Sync with Database (Silent every 15s + on Window Focus) + useEffect(() => { + if (!user?.id) return; + + const interval = setInterval(() => { + if (document.visibilityState === 'visible') { + fetchDashboardData(true); + } + }, 15000); + + const handleFocus = () => { + fetchDashboardData(true); + }; + + window.addEventListener('focus', handleFocus); + + return () => { + clearInterval(interval); + window.removeEventListener('focus', handleFocus); + }; + }, [user?.id]); + + if (isLoading || !user) { + return ( +
+
+
+ ); + } + + const quota = Number(user.storageQuotaBytes); + const used = Number(user.storageUsedBytes); + const remaining = Math.max(0, quota - used); + const percent = quota > 0 ? Math.min(Math.round((used / quota) * 100), 100) : 0; + + return ( +
+ + + setIsUploadOpen(true)} + onToggleSidebar={() => setIsSidebarOpen(!isSidebarOpen)} + /> + +
+ setIsSidebarOpen(false)} /> + +
+
+ {/* Welcome Header */} +
+
+
+

+ Welcome back, {user.fullName.split(' ')[0]} + +

+ {user.companyName && ( + + + {user.companyName} + + )} + {/* Live Database Sync Badge */} +
+ + {isSyncing ? 'Syncing...' : 'Live DB Sync'} +
+
+

+ Ecohub encrypted vault & company-wide file explorer active +

+
+ +
+ + + + Company Explorer + + +
+
+ + {/* Quick Stats Grid */} +
+ {/* Storage Quota Card */} +
+
+ Storage Quota +
+ +
+
+
+ {formatBytes(used)} + / {formatBytes(quota)} +
+
+
90 ? 'bg-rose-500' : 'bg-emerald-500' + }`} + style={{ width: `${percent}%` }} + /> +
+

{formatBytes(remaining)} remaining

+
+ + {/* Total Videos */} +
+
+ Video Assets +
+
+
+
+ {videoCount} + transcoded +
+

HLS Streaming & Ecohub Watermark

+
+ + {/* Total Files */} +
+
+ Files In Vault +
+ +
+
+
+ {recentFiles.length} + stored +
+

Verified signatures

+
+ + {/* Shared With Me */} +
+
+ Shared With Me +
+ +
+
+
+ {sharedCount} + delegated +
+

Granular permissions

+
+
+ + {/* Recent Uploads Section */} +
+
+

+ + Recent Uploads +

+ + View all in Company Explorer + + +
+ + {recentFiles.length === 0 ? ( +
+ +

No files uploaded yet

+

+ Drag and drop your videos, images, or documents to begin using Ecohub. +

+ +
+ ) : ( +
+ {recentFiles.map((file) => ( + setSelectedFileForPreview(f)} + onRename={() => router.push('/files')} + onMove={() => router.push('/files')} + onDelete={async (f) => { + if (confirm(`Delete file "${f.originalFilename}"?`)) { + await api.delete(`/files/${f.id}`); + fetchDashboardData(); + refreshProfile(); + } + }} + /> + ))} +
+ )} +
+
+
+
+ + {/* Uploader Modal */} + setIsUploadOpen(false)} + onUploadComplete={() => { + fetchDashboardData(); + refreshProfile(); + }} + /> + + {/* File Preview Modal */} + setSelectedFileForPreview(null)} + file={selectedFileForPreview} + /> +
+ ); +} diff --git a/apps/frontend/src/app/files/page.tsx b/apps/frontend/src/app/files/page.tsx new file mode 100644 index 0000000..5166e7d --- /dev/null +++ b/apps/frontend/src/app/files/page.tsx @@ -0,0 +1,1167 @@ +'use client'; + +import React, { useState, useEffect, useCallback } from 'react'; +import { useRouter } from 'next/navigation'; +import { useAuth } from '@/context/auth-context'; +import { api } from '@/lib/api-client'; +import { Navbar } from '@/components/layout/Navbar'; +import { Sidebar } from '@/components/layout/Sidebar'; +import { FileCard } from '@/components/file-manager/FileCard'; +import { FileRow } from '@/components/file-manager/FileRow'; +import { FileUploaderModal } from '@/components/uploader/FileUploaderModal'; +import { FilePreviewModal } from '@/components/file-manager/FilePreviewModal'; +import { CreateShareLinkModal } from '@/components/files/CreateShareLinkModal'; +import { EcohubWatermark } from '@/components/common/EcohubWatermark'; +import { formatBytes } from '@/lib/utils'; +import { FileCategory, UserRole } from '@fileshare/shared'; +import { + FolderPlus, + UploadCloud, + Search, + LayoutGrid, + List, + Folder, + ArrowUpDown, + Filter, + Trash2, + X, + Loader2, + Share2, + Lock, + Building2, + ChevronRight, + User as UserIcon, + HardDrive, + Layers, + ArrowLeft, + Sparkles, + RefreshCw, + Edit2, + AlertTriangle, +} from 'lucide-react'; + +interface ExplorerBreadcrumb { + id: string; + name: string; + isCompany?: boolean; +} + +export default function FilesPage() { + const router = useRouter(); + const { user, isAdmin, isSuperAdmin, isLoading, refreshProfile } = useAuth(); + + // Mode: 'EXPLORER' (Company First) or 'MY_FILES' + const [activeTab, setActiveTab] = useState<'EXPLORER' | 'MY_FILES'>('EXPLORER'); + + // Explorer State + const [currentCompany, setCurrentCompany] = useState(undefined); + const [currentFolderId, setCurrentFolderId] = useState(undefined); + const [breadcrumbs, setBreadcrumbs] = useState([ + { id: '', name: 'All Companies' }, + ]); + + const [explorerLevel, setExplorerLevel] = useState<'COMPANIES' | 'COMPANY_USERS' | 'FOLDER_CONTENTS'>('COMPANIES'); + const [companies, setCompanies] = useState([]); + const [subfolders, setSubfolders] = useState([]); + const [files, setFiles] = useState([]); + const [isDataLoading, setIsDataLoading] = useState(true); + + // Live Auto-Sync State + const [isSyncing, setIsSyncing] = useState(false); + const [lastSyncedAt, setLastSyncedAt] = useState(null); + + // Filters & Views + const [viewMode, setViewMode] = useState<'grid' | 'list'>('grid'); + const [search, setSearch] = useState(''); + const [selectedCategory, setSelectedCategory] = useState('ALL'); + const [sortBy, setSortBy] = useState<'date' | 'name' | 'size'>('date'); + const [sortOrder, setSortOrder] = useState<'asc' | 'desc'>('desc'); + + // Modals + const [isUploadOpen, setIsUploadOpen] = useState(false); + const [isSidebarOpen, setIsSidebarOpen] = useState(false); + const [isNewFolderOpen, setIsNewFolderOpen] = useState(false); + const [newFolderName, setNewFolderName] = useState(''); + const [selectedFileForPreview, setSelectedFileForPreview] = useState(null); + + // Rename modal + const [renameTarget, setRenameTarget] = useState(null); + const [newFileNameInput, setNewFileNameInput] = useState(''); + + // Move modal + const [moveTarget, setMoveTarget] = useState(null); + const [allUserFolders, setAllUserFolders] = useState([]); + const [targetFolderSelection, setTargetFolderSelection] = useState('root'); + + // Share Link modal + const [shareTarget, setShareTarget] = useState<{ type: 'FILE' | 'FOLDER'; id: string; name: string } | null>(null); + + // Company management modals + const [editingCompany, setEditingCompany] = useState(null); + const [newCompanyNameInput, setNewCompanyNameInput] = useState(''); + const [deletingCompany, setDeletingCompany] = useState(null); + const [isDeletingCompany, setIsDeletingCompany] = useState(false); + + const canShare = !!user?.canCreateShareLinks || user?.role === UserRole.SUPER_ADMIN || user?.role === UserRole.ADMIN; + const canDelete = user?.canDeleteFiles !== false || user?.role === UserRole.SUPER_ADMIN || user?.role === UserRole.ADMIN; + + useEffect(() => { + if (!isLoading && !user) { + router.push('/login'); + } + }, [user, isLoading, router]); + + // Load files according to mode - loads once on navigation, reloads on file add/delete/rename/move or manual sync + const loadExplorerData = useCallback(async (isSilent = false) => { + if (!user) return; + if (!isSilent) setIsDataLoading(true); + else setIsSyncing(true); + + try { + if (activeTab === 'MY_FILES') { + const res = await api.get(`/folders/contents?folderId=${currentFolderId || 'root'}`); + setExplorerLevel('FOLDER_CONTENTS'); + setBreadcrumbs(res.breadcrumbs || [{ id: 'root', name: 'My Vault' }]); + setSubfolders(res.subfolders || []); + setFiles(res.files || []); + } else { + // Company Explorer Mode + const res = await api.getCompanyExplorer(currentCompany, currentFolderId); + setExplorerLevel(res.level); + setBreadcrumbs(res.breadcrumbs || [{ id: '', name: 'All Companies' }]); + setSubfolders(res.subfolders || []); + setFiles(res.files || []); + if (res.companies) setCompanies(res.companies); + } + setLastSyncedAt(new Date()); + } catch (err) { + console.error('Failed to load explorer data', err); + } finally { + if (!isSilent) setIsDataLoading(false); + setIsSyncing(false); + } + }, [user?.id, activeTab, currentCompany, currentFolderId]); + + useEffect(() => { + loadExplorerData(); + }, [loadExplorerData]); + + // Handle Breadcrumb navigation + const handleBreadcrumbClick = (crumb: ExplorerBreadcrumb, index: number) => { + if (activeTab === 'MY_FILES') { + setCurrentFolderId(crumb.id); + return; + } + + if (index === 0) { + // Go back to All Companies + setCurrentCompany(undefined); + setCurrentFolderId(undefined); + } else if (index === 1 && crumb.isCompany) { + // Go back to Company Users + setCurrentCompany(crumb.name); + setCurrentFolderId(undefined); + } else { + // Specific folder + setCurrentFolderId(crumb.id); + } + }; + + // Handle clicking a folder item + const handleFolderClick = (folder: any) => { + if (folder.isCompany) { + // Level 1 -> Level 2 (Select Company) + setCurrentCompany(folder.companyName || folder.name); + setCurrentFolderId(undefined); + } else { + // Open that user's folder or subfolder + setCurrentFolderId(folder.id); + } + }; + + const handleCreateFolder = async (e: React.FormEvent) => { + e.preventDefault(); + if (!newFolderName.trim()) return; + + try { + await api.post('/folders', { + name: newFolderName.trim(), + parentId: currentFolderId === 'root' || !currentFolderId ? undefined : currentFolderId, + }); + setNewFolderName(''); + setIsNewFolderOpen(false); + loadExplorerData(); + } catch (err: any) { + alert(err.message || 'Failed to create folder'); + } + }; + + const handleRenameSubmit = async (e: React.FormEvent) => { + e.preventDefault(); + if (!renameTarget || !newFileNameInput.trim()) return; + + try { + await api.patch(`/files/${renameTarget.id}/rename`, { + newFilename: newFileNameInput.trim(), + }); + setRenameTarget(null); + loadExplorerData(); + } catch (err: any) { + alert(err.message || 'Failed to rename file'); + } + }; + + const handleMoveSubmit = async (e: React.FormEvent) => { + e.preventDefault(); + if (!moveTarget) return; + + try { + await api.patch(`/files/${moveTarget.id}/move`, { + targetFolderId: targetFolderSelection === 'root' ? null : targetFolderSelection, + }); + setMoveTarget(null); + loadExplorerData(); + } catch (err: any) { + alert(err.message || 'Failed to move file'); + } + }; + + const handleEditCompanySubmit = async (e: React.FormEvent) => { + e.preventDefault(); + if (!editingCompany || !newCompanyNameInput.trim()) return; + + try { + await api.updateCompanyName(editingCompany, newCompanyNameInput.trim()); + setEditingCompany(null); + setNewCompanyNameInput(''); + loadExplorerData(); + refreshProfile(); + } catch (err: any) { + alert(err.message || 'Failed to rename company'); + } + }; + + const handleDeleteCompanySubmit = async () => { + if (!deletingCompany) return; + setIsDeletingCompany(true); + + try { + await api.deleteCompany(deletingCompany.name); + setDeletingCompany(null); + loadExplorerData(); + refreshProfile(); + } catch (err: any) { + alert(err.message || 'Failed to delete company'); + } finally { + setIsDeletingCompany(false); + } + }; + + const handleDeleteFile = async (file: any) => { + if (isAdmin && !isSuperAdmin) { + const isOtherComp = + file.ownerCompanyName && + user?.companyName && + file.ownerCompanyName.trim().toLowerCase() !== user.companyName.trim().toLowerCase(); + if (isOtherComp) { + alert('Administrators cannot delete files belonging to other companies. Only Super Admin has this permission.'); + return; + } + } else if (!isSuperAdmin) { + if (!canDelete || file.ownerId !== user?.id) { + alert('You do not have permission to delete this file.'); + return; + } + } + + if (confirm(`Are you sure you want to delete "${file.originalFilename}"?`)) { + try { + await api.delete(`/files/${file.id}`); + loadExplorerData(); + refreshProfile(); + } catch (err: any) { + alert(err.message || 'Failed to delete file'); + } + } + }; + + const handleDeleteFolder = async (folderId: string, folderName: string) => { + if (isAdmin && !isSuperAdmin) { + const isOtherComp = + currentCompany && + user?.companyName && + currentCompany.trim().toLowerCase() !== user.companyName.trim().toLowerCase(); + if (isOtherComp) { + alert('Administrators cannot delete folders belonging to other companies. Only Super Admin has this permission.'); + return; + } + } else if (!isSuperAdmin) { + if (!canDelete) { + alert('You do not have permission to delete folders. Please contact an administrator.'); + return; + } + } + + if (confirm(`Delete folder "${folderName}" and all its contents?`)) { + try { + await api.delete(`/folders/${folderId}`); + loadExplorerData(); + refreshProfile(); + } catch (err: any) { + alert(err.message || 'Failed to delete folder'); + } + } + }; + + // Filter & sort files + const filteredFiles = files + .filter((f) => { + const matchesSearch = f.originalFilename.toLowerCase().includes(search.toLowerCase()); + const matchesCategory = selectedCategory === 'ALL' || f.fileCategory === selectedCategory; + return matchesSearch && matchesCategory; + }) + .sort((a, b) => { + if (sortBy === 'name') { + return sortOrder === 'asc' + ? a.originalFilename.localeCompare(b.originalFilename) + : b.originalFilename.localeCompare(a.originalFilename); + } + if (sortBy === 'size') { + const sA = Number(a.fileSizeBytes); + const sB = Number(b.fileSizeBytes); + return sortOrder === 'asc' ? sA - sB : sB - sA; + } + const dA = new Date(a.createdAt).getTime(); + const dB = new Date(b.createdAt).getTime(); + return sortOrder === 'asc' ? dA - dB : dB - dA; + }); + + return ( +
+ setIsUploadOpen(true)} + onToggleSidebar={() => setIsSidebarOpen(!isSidebarOpen)} + /> + +
+ setIsSidebarOpen(false)} /> + +
+
+ {/* Top Header & Mode Toggle Bar */} +
+
+
+

+ File Explorer + + Ecohub Multi-User + +

+ + {/* Database Sync Badge */} +
+ + {isSyncing ? 'Syncing...' : 'DB Synced'} +
+
+ + {/* Breadcrumb Trail */} +
+ {breadcrumbs.map((crumb, idx) => ( + + {idx > 0 && } + + + ))} +
+
+ + {/* Action Buttons & View Modes */} +
+ {/* Manual Sync Button */} + + + {/* Explorer vs My Files Toggle */} +
+ + +
+ + {/* New Folder Button */} + + + {/* Upload Button */} + +
+
+ + {/* Search and Filters Bar */} +
+ {/* Search */} +
+ setSearch(e.target.value)} + className="w-full pl-9 pr-4 py-2 rounded-xl bg-slate-50 border border-slate-200 text-slate-900 placeholder:text-slate-400 focus:outline-none focus:border-emerald-600 focus:ring-1 focus:ring-emerald-600 text-xs transition" + /> + +
+ + {/* Category Filter & Sort */} +
+
+ + +
+ +
+ + +
+ + {/* View Mode Toggle */} +
+ + +
+
+
+ + + {/* LEVEL 1: ALL COMPANIES VIEW */} + {activeTab === 'EXPLORER' && explorerLevel === 'COMPANIES' && ( +
+
+
+

+ + Organizations & Companies ({subfolders.length}) +

+

+ Click any company to explore all users and files under that organization +

+
+
+ + {isDataLoading ? ( +
+ + Loading organizations... +
+ ) : subfolders.length > 0 ? ( +
+ {subfolders.map((comp) => ( +
handleFolderClick(comp)} + className="p-5 rounded-3xl bg-white border border-slate-200/90 hover:border-emerald-400 hover:shadow-lg hover:shadow-emerald-500/10 cursor-pointer transition-all flex flex-col justify-between group relative overflow-hidden" + > +
+
+
+ +
+
+

+ {comp.name} +

+

+ {comp.subfolderCount} Team Members +

+
+ + {comp.fileCount} Files + + {comp.totalSizeBytes && ( + {formatBytes(comp.totalSizeBytes)} + )} +
+
+
+ + {/* Company Action Buttons: Edit & Delete */} + {(isSuperAdmin || isAdmin) && ( +
+ + + {isSuperAdmin ? ( + + ) : ( + + )} +
+ )} +
+ +
+ Browse Company Files + +
+
+ ))} +
+ ) : ( +
+ No company files registered yet. +
+ )} +
+ )} + + {/* LEVEL 2: USERS IN COMPANY VIEW */} + {activeTab === 'EXPLORER' && explorerLevel === 'COMPANY_USERS' && ( +
+
+
+

+ + Users in {currentCompany} ({subfolders.length}) +

+

+ Select a user folder to inspect their files and videos +

+
+ + +
+ + {isDataLoading ? ( +
+ + Loading team members... +
+ ) : subfolders.length > 0 ? ( +
+ {subfolders.map((userFolder) => ( +
handleFolderClick(userFolder)} + className="p-5 rounded-3xl bg-white border border-slate-200/90 hover:border-emerald-400 hover:shadow-lg hover:shadow-emerald-500/10 cursor-pointer transition-all flex flex-col justify-between group" + > +
+
+ +
+
+

+ {userFolder.name} +

+

+ @{userFolder.username} +

+
+ + {userFolder.fileCount} Files + + {userFolder.subfolderCount} Subfolders +
+
+
+ +
+ Open User Vault + +
+
+ ))} +
+ ) : ( +
+ No users found in this organization. +
+ )} +
+ )} + + {/* LEVEL 3: FOLDER CONTENTS (Subfolders & Files) */} + {(explorerLevel === 'FOLDER_CONTENTS' || activeTab === 'MY_FILES') && ( +
+ {/* Subfolders Section */} + {subfolders.length > 0 && ( +
+ + Folders ({subfolders.length}) + +
+ {subfolders.map((folder) => ( +
+
setCurrentFolderId(folder.id)} + className="flex items-center gap-2.5 min-w-0 flex-1" + > + +
+

{folder.name}

+

{folder.fileCount} files

+
+
+
+ + + {(() => { + const isFolderOtherComp = + currentCompany && + user?.companyName && + currentCompany.trim().toLowerCase() !== user.companyName.trim().toLowerCase(); + const canDeleteThisFolder = isSuperAdmin ? true : (isAdmin ? !isFolderOtherComp : canDelete); + + return canDeleteThisFolder ? ( + + ) : ( + + ); + })()} +
+
+ ))} +
+
+ )} + + {/* Files Section */} +
+
+ + Files ({filteredFiles.length}) + +
+ + {isDataLoading ? ( +
+ + Loading files... +
+ ) : filteredFiles.length === 0 ? ( +
+ +

No files found

+

+ {search + ? 'No files matched your search term.' + : 'This folder is currently empty. Upload videos or files to get started.'} +

+
+ ) : viewMode === 'grid' ? ( +
+ {filteredFiles.map((file) => { + const isFileOtherComp = + file.ownerCompanyName && + user?.companyName && + file.ownerCompanyName.trim().toLowerCase() !== user.companyName.trim().toLowerCase(); + const fileCanDelete = isSuperAdmin + ? true + : (isAdmin ? !isFileOtherComp : (canDelete && file.ownerId === user?.id)); + + return ( + setSelectedFileForPreview(f)} + onRename={(f) => { + setRenameTarget(f); + setNewFileNameInput(f.originalFilename); + }} + onMove={(f) => { + setMoveTarget(f); + api.get('/folders').then((folds) => setAllUserFolders(folds || [])); + }} + onDelete={(f) => handleDeleteFile(f)} + onShare={(f) => setShareTarget({ type: 'FILE', id: f.id, name: f.originalFilename })} + canShare={canShare} + canDelete={fileCanDelete} + isOwner={user?.id === file.ownerId || isSuperAdmin || isAdmin} + /> + ); + })} +
+ ) : ( +
+
+ + + + + + + + + + + + + {filteredFiles.map((file) => { + const isFileOtherComp = + file.ownerCompanyName && + user?.companyName && + file.ownerCompanyName.trim().toLowerCase() !== user.companyName.trim().toLowerCase(); + const fileCanDelete = isSuperAdmin + ? true + : (isAdmin ? !isFileOtherComp : (canDelete && file.ownerId === user?.id)); + + return ( + setSelectedFileForPreview(f)} + onRename={(f) => { + setRenameTarget(f); + setNewFileNameInput(f.originalFilename); + }} + onMove={(f) => { + setMoveTarget(f); + api.get('/folders').then((folds) => setAllUserFolders(folds || [])); + }} + onDelete={(f) => handleDeleteFile(f)} + onShare={(f) => setShareTarget({ type: 'FILE', id: f.id, name: f.originalFilename })} + canShare={canShare} + canDelete={fileCanDelete} + isOwner={user?.id === file.ownerId || isSuperAdmin || isAdmin} + /> + ); + })} + +
NameCategorySizeDate UploadedStatusActions
+
+
+ )} +
+
+ )} +
+
+
+ + {/* New Folder Modal */} + {isNewFolderOpen && ( +
+
+

Create New Folder

+
+ setNewFolderName(e.target.value)} + autoFocus + required + className="w-full px-3 py-2.5 rounded-xl bg-slate-50 border border-slate-200 text-slate-900 focus:outline-none focus:border-emerald-600" + /> +
+ + +
+
+
+
+ )} + + {/* Rename File Modal */} + {renameTarget && ( +
+
+

Rename File

+
+ setNewFileNameInput(e.target.value)} + autoFocus + required + className="w-full px-3 py-2.5 rounded-xl bg-slate-50 border border-slate-200 text-slate-900 focus:outline-none focus:border-emerald-600" + /> +
+ + +
+
+
+
+ )} + + {/* Move File Modal */} + {moveTarget && ( +
+
+

Move File

+
+
+ + +
+
+ + +
+
+
+
+ )} + + {/* File Uploader */} + setIsUploadOpen(false)} + currentFolderId={currentFolderId} + onUploadComplete={() => { + loadExplorerData(); + refreshProfile(); + }} + /> + + {/* Preview Modal */} + setSelectedFileForPreview(null)} + file={selectedFileForPreview} + /> + + {/* Share Link Modal */} + {shareTarget && ( + setShareTarget(null)} + target={shareTarget} + /> + )} + + {/* Edit Company Name Modal */} + {editingCompany && ( +
+
+
+

+ + Rename Company +

+ +
+
+
+ + setNewCompanyNameInput(e.target.value)} + placeholder="Enter updated company name..." + className="w-full px-3.5 py-2 rounded-xl bg-slate-50 border border-slate-200 text-slate-900 text-xs focus:outline-none focus:border-emerald-600 focus:ring-1 focus:ring-emerald-600" + /> +
+
+ + +
+
+
+
+ )} + + {/* Delete Company Modal (Super Admin Only) */} + {deletingCompany && ( +
+
+
+
+
+ +
+
+

Delete Entire Company

+

Super Administrator Privilege

+
+
+ +
+ +
+

+ + Warning: Permanent Organization Destruction +

+

+ Are you sure you want to delete company "{deletingCompany.name}"? + This will permanently delete all associated user accounts, root directories, folders, and uploaded files from the system storage. +

+
+ +
+ + +
+
+
+ )} + + {/* Subtle Ecohub Watermark in bottom corner */} + +
+ ); +} diff --git a/apps/frontend/src/app/globals.css b/apps/frontend/src/app/globals.css new file mode 100644 index 0000000..1c4d930 --- /dev/null +++ b/apps/frontend/src/app/globals.css @@ -0,0 +1,103 @@ +@tailwind base; +@tailwind components; +@tailwind utilities; + +@layer base { + :root { + --background: #f8fafc; + --foreground: #0f172a; + --card: #ffffff; + --card-foreground: #0f172a; + --primary: #16a34a; + --primary-foreground: #ffffff; + --secondary: #f1f5f9; + --secondary-foreground: #334155; + --muted: #f1f5f9; + --muted-foreground: #64748b; + --accent: #22c55e; + --accent-foreground: #ffffff; + --destructive: #ef4444; + --destructive-foreground: #ffffff; + --border: #e2e8f0; + --input: #e2e8f0; + --ring: #16a34a; + --radius: 0.75rem; + } +} + +body { + color: var(--foreground); + background: #f8fafc; + font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Inter", Helvetica, Arial, sans-serif; + overflow-x: hidden; + background-image: + radial-gradient(at 0% 0%, rgba(34, 197, 94, 0.05) 0px, transparent 45%), + radial-gradient(at 100% 0%, rgba(16, 185, 129, 0.04) 0px, transparent 40%), + radial-gradient(at 50% 100%, rgba(22, 163, 74, 0.03) 0px, transparent 50%); + background-attachment: fixed; +} + +/* Custom crisp modern scrollbars */ +::-webkit-scrollbar { + width: 6px; + height: 6px; +} +::-webkit-scrollbar-track { + background: #f1f5f9; +} +::-webkit-scrollbar-thumb { + background: #cbd5e1; + border-radius: 9999px; +} +::-webkit-scrollbar-thumb:hover { + background: #94a3b8; +} + +/* Premium White Glassmorphism & Card styles */ +.glass-panel { + background: rgba(255, 255, 255, 0.94); + backdrop-filter: blur(16px); + -webkit-backdrop-filter: blur(16px); + border: 1px solid rgba(226, 232, 240, 0.9); + box-shadow: 0 4px 20px -2px rgba(15, 23, 42, 0.04); +} + +.glass-card { + background: #ffffff; + border: 1px solid #e2e8f0; + box-shadow: 0 1px 3px 0 rgba(0, 0, 0, 0.03), 0 1px 2px -1px rgba(0, 0, 0, 0.03); + transition: all 0.2s cubic-bezier(0.4, 0, 0.2, 1); +} + +.glass-card:hover { + border-color: rgba(34, 197, 94, 0.5); + transform: translateY(-2px); + box-shadow: 0 12px 24px -6px rgba(22, 163, 74, 0.12); +} + +.glow-card-active { + box-shadow: 0 0 25px -5px rgba(34, 197, 94, 0.25); + border-color: #22c55e; +} + +.gradient-text { + background: linear-gradient(135deg, #15803d 0%, #16a34a 50%, #22c55e 100%); + -webkit-background-clip: text; + -webkit-text-fill-color: transparent; +} + +.gradient-border { + position: relative; + background: linear-gradient(135deg, rgba(34, 197, 94, 0.3), rgba(16, 185, 129, 0.1), rgba(34, 197, 94, 0.1)); + padding: 1px; + border-radius: 1rem; +} + +/* Watermark background animation */ +.watermark-bg { + background-image: url('/logo.png'); + background-repeat: no-repeat; + background-position: right -40px bottom -40px; + background-size: 280px; + opacity: 0.03; +} diff --git a/apps/frontend/src/app/icon.png b/apps/frontend/src/app/icon.png new file mode 100644 index 0000000000000000000000000000000000000000..bbf40c21a7c35071568c8e1a6a178468e5da45c5 GIT binary patch literal 100981 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⋒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 ZDSu%ZNvA&g1UZ88LQPk-Ud1-*{{u(Jy+r^3 literal 0 HcmV?d00001 diff --git a/apps/frontend/src/app/layout.tsx b/apps/frontend/src/app/layout.tsx new file mode 100644 index 0000000..2fa6302 --- /dev/null +++ b/apps/frontend/src/app/layout.tsx @@ -0,0 +1,82 @@ +import type { Metadata } from 'next'; +import './globals.css'; +import { AuthProvider } from '@/context/auth-context'; +import { HydrationGuard } from '@/components/common/HydrationGuard'; + +export const metadata: Metadata = { + title: 'Ecohub - Secure Video & File Sharing Management System', + description: 'Enterprise-grade secure video streaming, file management, and administrator-controlled sharing platform by Ecohub', + icons: { + icon: '/logo.png', + apple: '/logo.png', + }, +}; + +export default function RootLayout({ + children, +}: { + children: React.ReactNode; +}) { + return ( + + +