Compare commits

...
16 Commits
Author SHA1 Message Date
yiling f2b0415580 Release v0.4.9 2026-09-28 20:17:50 +08:00
Yiling-J c9d0b476cd feat(transcode): fallback to software encoding when hardware transcode fails (#433) 2026-09-28 16:45:28 +08:00
yiling bf5ac566b6 refactor(notification): simplify email wording and remove redundant team references 2026-09-28 13:37:16 +08:00
Yiling-J af8f24aa95 docs(settings): add email notifications documentation to team settings (#432)
* docs(settings): add email notification documentation to team settings

* fix(notification): use correct webui route URLs for project and asset links in emails
2026-09-28 11:27:59 +08:00
Yiling-J d98f486c9d feat(notification): add email notification infrastructure, smtp configuration, and periodic background delivery job (#431)
* feat(notification): add email notification support and dedicated workflow

* feat(webui): add team email notification settings and test email dialog

* refactor(webui): remove redundant card header from email notification settings

* fix(notification): prevent sending notification emails to AI agents

* feat(notification): display project, avatar, upload time and resolve mention names in notification emails

* refactor(notification): remove uploadDebounceSeconds and naive workflow sleep

* refactor(notification): remove temporal notification workflow and keep email infrastructure

* fix(team): prevent leaking email notification settings and credentials in team settings

* feat(notification): add periodic background job for batched email notification delivery

* fix(notification): embed avatars and thumbnails as inline cid attachments
2026-09-28 09:58:59 +08:00
Yiling-J 94ea4c917a feat(transcode): add VA-API hardware acceleration support (#430)
* feat(transcode): add VA-API hardware acceleration support

* fix(docker): switch to jellyfin-ffmpeg 8.1.2-5 for VA-API support

* fix(transcode): probe hardware encoder usability to skip uninitialized drivers

* ci(release): add workflow_dispatch trigger with custom tag input

* fix(transcode): use 256x256 frame dimension for encoder usability probe

* feat(docker): add hwaccel transcoding compose presets matching immich

* docs: add hardware transcoding documentation and quickstart references

* feat(transcode): prioritize h264_vaapi before h264_qsv on Linux

* fix(docker): extend device permission loop to rkmpp and wsl accelerator nodes
2026-09-26 20:55:57 +08:00
Yiling-J 941bf0fd1b feat(transcode): smart poster frame selection and decoupled generation (#428)
* feat(transcode): smart poster frame selection and decoupled generation

* fix(transcode): detect MPEG-TS extension from URL pathname for signed remote sources
2026-09-25 16:37:16 +08:00
Yiling-J 59742dde78 feat(transcode): optimize video sprite generation with seek pool and compositing (#427)
* feat(transcode): optimize video sprite generation with seek pool and compositing

* fix(transcode): handle abort signal during and after sharp compositing
2026-09-25 15:06:15 +08:00
yiling 29cd5d807c test(scripts): find release by version in changelog integration test 2026-09-24 20:34:53 +08:00
yiling f6e27095a5 Release v0.4.8 2026-09-24 20:26:23 +08:00
Yiling-J 55637bc9a8 feat(transcode): optimize video proxy quality and fix videotoolbox first-frame blocking (#426)
- Fix first-frame macroblocking on VideoToolbox hardware acceleration by avoiding -maxrate/-bufsize which triggers Apple's DataRateLimits initial rate controller starvation, applying target -b:v instead.
- Optimize software encoding (libx264) quality by adjusting CRF from 26 to 23.
- Disable B-frames (-bf 0) for libx264 proxies to ensure zero-latency frame stepping (JKL) and scrubbing, matching Frame.io review proxy standards.
- Update unit tests to verify the new encoder configurations and bitrate calculation logic.
2026-09-24 17:16:02 +08:00
Yiling-J 0d6671c3e1 fix(webui): show play button and darken tint only before initial playback (#425)
* fix(webui): remove paused play button overlay and darken cover from video players

* fix(webui): show play button and darken tint only before initial playback
2026-09-24 15:19:46 +08:00
Yiling-J c3375ee935 feat(transcode): add HDR video proxy support and playback (#424)
* feat(transcode): add HDR output proxy support

* fix(transcode): auto-detect MoltenVK Vulkan ICD on macOS for libplacebo filters

* fix(transcode): split filter in generateSprite to ensure poster uses tone-mapped stream

* docs(changelog): update docs/changelog.mdx and ignore in prettier

* fix(transcode): respect video rotation metadata to preserve display aspect ratio

* fix(webui): render native video with hardware EDR acceleration instead of 2D canvas

* fix(webui): show HDR label on mobile video control bar

* fix(share): preserve hdr flag on watermarked video transcodes

* fix(webui): differentiate HDR download options in video player

* fix(transcode): handle Dolby Vision Profile 5 via standard HDR pipeline without libplacebo

* fix(transcode): prepend setparams filter to prevent zscale colorspace path error for DV P5

* refactor(transcode): simplify HDR proxies to always produce HDR without SDR setting
2026-09-24 14:32:47 +08:00
Yiling-J f579947770 feat(docs): add changelog section to mintlify documentation (#422) 2026-09-22 21:02:27 +08:00
Yiling-J 53c9485f10 fix(core): only manage PID files in daemon mode (#421) 2026-09-22 20:31:38 +08:00
Yiling-J 75bf9b3b88 fix(docker): stop publishing postgres port in compose files (#420)
The bundled PostgreSQL service published port 5432 on the host, which caused
docker compose up to fail when that port was already in use. A failed start
leaves the container without a network endpoint, so subsequent runs reuse the
broken container and the app cannot reach the database (Prisma P1001).

The app only needs the database inside the compose network, so the host port
mapping is unnecessary. Remove it from all local and temporal compose files.
2026-09-20 11:46:13 +08:00
102 changed files with 9545 additions and 395 deletions
+7
View File
@@ -4,6 +4,12 @@ on:
push:
branches: ['main']
tags: ['v*']
workflow_dispatch:
inputs:
tag:
description: 'Docker image tag (e.g. feature-vaapi)'
required: false
type: string
jobs:
build-and-push:
@@ -46,6 +52,7 @@ jobs:
tags: |
type=semver,pattern={{version}}
type=ref,event=branch
type=raw,value=${{ inputs.tag }},enable=${{ github.event_name == 'workflow_dispatch' && inputs.tag != '' }}
# Build and push Docker image
- name: Build and push Docker image
+2 -1
View File
@@ -7,4 +7,5 @@ packages/core/src/generated
src/ui/components/ui
packages/webui/paraglide
*.md
**/*.md
**/*.md
docs/changelog.mdx
+34
View File
@@ -12,6 +12,40 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
### Changed
## [0.4.9] - 2026-09-28
### Added
- **notification**: You can now receive notifications via email, with batched digest emails and configurable team-level SMTP settings
- **transcode**: Add VA-API hardware acceleration support for Linux hosts and Docker environments with Intel and AMD GPUs, featuring automatic DRI render node discovery, variable bitrate control, and structured transcoding observability logs
- **transcode**: Add automatic fallback to software transcoding (libx264) when hardware-accelerated video encoding encounters GPU resolution constraints or runtime driver errors
- **docker**: Add modular hardware-accelerated transcoding presets matching Immich's compose configuration via `hwaccel.transcoding.yaml` with support for NVENC, QuickSync, RKMPP, and VA-API
### Fixed
### Changed
- **transcode**: Improve video poster selection using intelligent scene detection and color variance filtering to automatically skip black frames, fade-ins, and blank intros in favor of representative video content
- **transcode**: Optimize video sprite generation for large and long videos using a concurrent fast-seek pool and image compositing, avoiding full-video decoding while preserving instant single-pass generation for short clips
## [0.4.8] - 2026-09-24
### Added
- **transcode**: Add HDR video proxy support: HDR videos automatically generate HDR video proxies and preview videos preserving HDR color characteristics, tone-mapped SDR thumbnails and posters, and automatic HDR player playback on supported displays with hardware EDR acceleration
- **docs**: Add a Changelog section to the documentation site so users can explore release notes and updates directly in Mintlify
### Fixed
- **webui**: Only show the center play button and darkened tint on initial video open before playback starts; once played, pausing or scrubbing back to start keeps the video canvas clean and unobstructed for review
- **transcode**: Fix an issue where videos with orientation or rotation metadata (such as smartphone vertical videos) were incorrectly displayed with stretched aspect ratios in the video player
- **cli**: Only manage and check PID files in daemon mode, preventing stale PID files, crash-loop conflicts, or spurious process checks during normal foreground and Docker execution
### Changed
- **transcode**: Improve video proxy visual quality and disable B-frames for smoother frame-by-frame seeking and scrubbing
## [0.4.7] - 2026-09-19
### Added
+16 -7
View File
@@ -30,11 +30,7 @@ RUN bun run scripts/extract-runtime-deps.ts
# Stage 2: Runner
FROM oven/bun:1.4.2 AS runner
# Install ffmpeg/ffprobe
COPY --from=mwader/static-ffmpeg:8.1 /ffmpeg /usr/local/bin/
COPY --from=mwader/static-ffmpeg:8.1 /ffprobe /usr/local/bin/
# Install system dependencies for sandbox runtime and agent
# Install system dependencies and Jellyfin-FFmpeg (with VA-API support)
RUN apt-get update && apt-get install -y --no-install-recommends \
python3 \
make \
@@ -56,11 +52,24 @@ RUN apt-get update && apt-get install -y --no-install-recommends \
poppler-utils \
imagemagick \
fonts-noto-cjk \
&& . /etc/os-release \
&& TARGETARCH=$(dpkg --print-architecture) \
&& FFMPEG_VERSION="8.1.2-5" \
&& curl -fsSL -o /tmp/jellyfin-ffmpeg.deb "https://github.com/jellyfin/jellyfin-ffmpeg/releases/download/v${FFMPEG_VERSION}/jellyfin-ffmpeg8_${FFMPEG_VERSION}-${VERSION_CODENAME}_${TARGETARCH}.deb" \
&& apt-get install -y --no-install-recommends /tmp/jellyfin-ffmpeg.deb \
&& rm -f /tmp/jellyfin-ffmpeg.deb \
&& ldconfig /usr/lib/jellyfin-ffmpeg/lib \
&& ln -sf /usr/lib/jellyfin-ffmpeg/ffmpeg /usr/local/bin/ffmpeg \
&& ln -sf /usr/lib/jellyfin-ffmpeg/ffprobe /usr/local/bin/ffprobe \
&& ln -sf /usr/lib/jellyfin-ffmpeg/ffmpeg /usr/bin/ffmpeg \
&& ln -sf /usr/lib/jellyfin-ffmpeg/ffprobe /usr/bin/ffprobe \
&& apt-get clean \
&& rm -rf /var/lib/apt/lists/*
# Set up working directory and make it owned by the bun user
RUN mkdir -p /app/data && chown -R bun:bun /app
# Set up working directory and make it owned by the bun user, ensure video/render group access
RUN usermod -a -G video,render bun 2>/dev/null || true \
&& mkdir -p /app/data \
&& chown -R bun:bun /app
# Switch to the non-root bun user
USER bun
+3
View File
@@ -86,6 +86,9 @@ Docker Compose is the fastest way to get Shumai running. You do not need to clon
```bash
curl -o docker-compose.yaml https://raw.githubusercontent.com/shumaiOne/shumai/main/docker-compose/local/docker-compose.yaml
```
> [!NOTE]
> By default, the standard `docker-compose.yaml` uses CPU software transcoding. If your server has a GPU (NVIDIA NVENC, Intel QuickSync, AMD/Intel VA-API, or Rockchip RKMPP) and you want to enable GPU hardware acceleration, check the [Hardware Transcoding Guide](https://docs.shumai.one/configuration/hardware-transcoding).
3. Configure environment variables (optional):
* `SHUMAI_SERVER_PORT` controls the port the Shumai server listens on. The default is `3000`.
+3 -1
View File
@@ -101,9 +101,11 @@ https://gh-proxy.com/https://raw.githubusercontent.com/shumaiOne/shumai/main/REA
2. 下载 `docker-compose.yaml` 配置文件:
```bash
curl -o docker-compose.yaml https://raw.githubusercontent.com/shumaiOne/shumai/main/docker-compose/local/docker-compose-aliyun.yaml
```
> [!NOTE]
> 默认的 Docker Compose 配置使用基于 CPU 的软件转码。如果您的服务器配备了支持的显卡(NVIDIA NVENC、Intel QuickSync、AMD/Intel VA-API 或 Rockchip RKMPP)并需要开启 GPU 硬件加速转码,请参考 [硬件加速转码配置文档](https://docs.shumai.one/configuration/hardware-transcoding)。
3. 配置环境变量(可选):
* `SHUMAI_SERVER_PORT` 用于控制 Shumai 服务监听的端口,默认值为 `3000`。
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@shumai/agent-app",
"version": "0.4.7",
"version": "0.4.9",
"private": true,
"type": "module",
"bin": {
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@shumai/cli",
"version": "0.4.7",
"version": "0.4.9",
"private": true,
"type": "module",
"bin": {
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@shumai/premiere-uxp",
"version": "0.4.7",
"version": "0.4.9",
"private": true,
"type": "commonjs",
"scripts": {
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@shumai/transcode-app",
"version": "0.4.7",
"version": "0.4.9",
"private": true,
"type": "module",
"bin": {
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@shumai/web-app",
"version": "0.4.7",
"version": "0.4.9",
"private": true,
"type": "module",
"dependencies": {
+2
View File
@@ -16,6 +16,7 @@ import { migrateLegacyAgentAvatars } from '@shumai/core/src/agent/migration'
import { handleDaemonCommands } from '@shumai/core/src/utils/daemon'
import { authService } from '@shumai/core/src/auth/auth'
import { sandboxService } from '@shumai/core'
import { notificationJobService } from '@shumai/core/src/notification/notification-job'
if (process.argv.includes('--check')) {
console.log('✅ Web app evaluated successfully!')
@@ -58,6 +59,7 @@ async function run() {
await metadataService.syncSystemFields().catch(console.error)
await migrateLegacyAgentAvatars().catch(console.error)
assetService.startCleanupJob()
notificationJobService.start()
workflowService.start()
if (process.env.WORKFLOW_EXECUTOR === 'temporal') {
const args = process.argv.slice(2)
+51 -15
View File
@@ -33,7 +33,7 @@
},
"apps/agent": {
"name": "@shumai/agent-app",
"version": "0.4.7",
"version": "0.4.9",
"bin": {
"shumai-agent": "./src/index.ts",
},
@@ -45,7 +45,7 @@
},
"apps/cli": {
"name": "@shumai/cli",
"version": "0.4.7",
"version": "0.4.9",
"bin": {
"shumai-cli": "./src/index.ts",
},
@@ -60,7 +60,7 @@
},
"apps/premiere-uxp": {
"name": "@shumai/premiere-uxp",
"version": "0.4.7",
"version": "0.4.9",
"dependencies": {
"@shumai/api": "workspace:*",
"@shumai/dtos": "workspace:*",
@@ -114,7 +114,7 @@
},
"apps/transcode": {
"name": "@shumai/transcode-app",
"version": "0.4.7",
"version": "0.4.9",
"bin": {
"shumai-transcode": "./src/index.ts",
},
@@ -126,7 +126,7 @@
},
"apps/web": {
"name": "@shumai/web-app",
"version": "0.4.7",
"version": "0.4.9",
"dependencies": {
"@shumai/agent": "workspace:*",
"@shumai/api": "workspace:*",
@@ -146,7 +146,7 @@
},
"packages/agent": {
"name": "@shumai/agent",
"version": "0.4.7",
"version": "0.4.9",
"dependencies": {
"@anthropic-ai/sandbox-runtime": "0.0.74",
"@earendil-works/pi-agent-core": "0.82.1",
@@ -171,7 +171,7 @@
},
"packages/api": {
"name": "@shumai/api",
"version": "0.4.7",
"version": "0.4.9",
"dependencies": {
"@hono/zod-validator": "0.7.6",
"@shumai/core": "workspace:*",
@@ -185,7 +185,7 @@
},
"packages/core": {
"name": "@shumai/core",
"version": "0.4.7",
"version": "0.4.9",
"dependencies": {
"@ai-sdk/alibaba": "2.0.38",
"@ai-sdk/amazon-bedrock": "5.0.67",
@@ -214,6 +214,8 @@
"@shumai/db": "workspace:*",
"@shumai/dtos": "workspace:*",
"@sinclair/typebox": "0.34.52",
"@temporalio/activity": "1.24.0",
"@temporalio/workflow": "1.24.0",
"adm-zip": "0.6.0",
"ai": "7.0.84",
"better-auth": "1.6.11",
@@ -224,6 +226,7 @@
"extract-zip": "2.0.1",
"hono": "4.13.5",
"jittered-fractional-indexing": "1.0.1",
"nodemailer": "10.0.10",
"pdfkit": "0.20.1",
"pino": "10.3.1",
"sharp": "0.35.4",
@@ -237,12 +240,13 @@
"@modelcontextprotocol/server": "2.0.0",
"@types/adm-zip": "0.5.8",
"@types/extract-zip": "2.0.3",
"@types/nodemailer": "8.0.2",
"@types/pdfkit": "0.17.6",
},
},
"packages/db": {
"name": "@shumai/db",
"version": "0.4.7",
"version": "0.4.9",
"dependencies": {
"@earendil-works/pi-agent-core": "0.82.1",
"@prisma/adapter-pg": "7.10.0",
@@ -258,7 +262,7 @@
},
"packages/dtos": {
"name": "@shumai/dtos",
"version": "0.4.7",
"version": "0.4.9",
"dependencies": {
"@earendil-works/pi-agent-core": "0.82.1",
"zod": "4.5.4",
@@ -266,7 +270,7 @@
},
"packages/e2e": {
"name": "@shumai/e2e",
"version": "0.4.7",
"version": "0.4.9",
"dependencies": {
"@earendil-works/pi-agent-core": "0.82.1",
"@google/genai": "2.19.0",
@@ -281,11 +285,11 @@
},
"packages/tableprinter": {
"name": "@shumai/tableprinter",
"version": "0.4.7",
"version": "0.4.9",
},
"packages/transcode": {
"name": "@shumai/transcode",
"version": "0.4.7",
"version": "0.4.9",
"dependencies": {
"@shumai/core": "workspace:*",
"@shumai/db": "workspace:*",
@@ -299,7 +303,7 @@
},
"packages/webui": {
"name": "@shumai/webui",
"version": "0.4.7",
"version": "0.4.9",
"dependencies": {
"@base-ui/react": "1.7.0",
"@dnd-kit/abstract": "0.5.0",
@@ -401,7 +405,7 @@
},
"packages/workflow-core": {
"name": "@shumai/workflow-core",
"version": "0.4.7",
"version": "0.4.9",
"dependencies": {
"@shumai/core": "workspace:*",
"@shumai/db": "workspace:*",
@@ -1563,6 +1567,8 @@
"@types/node": ["@types/node@25.9.1", "", { "dependencies": { "undici-types": ">=7.24.0 <7.24.7" } }, "sha512-xfrlY7UD5rMJk3ZVJP8BNzS28J36YJg+xp+LPXV1TdWxr8uMH5A860QNxYDGQe/ylDSgjxE52Q9VnO7p75tJxg=="],
"@types/nodemailer": ["@types/nodemailer@8.0.2", "", { "dependencies": { "@types/node": "*" } }, "sha512-c7M5ox8p0nEOfbJ2E9Qcmt8/QCu/VzsiAhzBiZbvky2PhKZDHpKB3sQHBM5MEZNkCfBOaS6S9//AGPRTNB7IaA=="],
"@types/pdfkit": ["@types/pdfkit@0.17.6", "", { "dependencies": { "@types/node": "*" } }, "sha512-tIwzxk2uWKp0Cq9JIluQXJid77lYhF52EsIOwhsMF4iWLA6YneoBR1xVKYYdAysHuepUB0OX4tdwMiUDdGKmig=="],
"@types/pg": ["@types/pg@8.23.1", "", { "dependencies": { "@types/node": "*", "pg-protocol": "*", "pg-types": "^2.2.0" } }, "sha512-fKVHpikPdg4GKks3JuLEhvwSyvwzF23hnabPy6DD8ljVbC7+6J5dQzdv4arV6jqq57djnMgs1HKBxX4P8aBI3A=="],
@@ -2591,6 +2597,8 @@
"node-releases": ["node-releases@2.0.54", "", {}, "sha512-YHs7BmmcsdAI5Ozuf8JZo6PT0mv2GIWC9vMfvUC3dp65M8hn7Ux8CPL+2oBI7juNuj9d0ndhTcznq2ODBps9cQ=="],
"nodemailer": ["nodemailer@10.0.10", "", {}, "sha512-He9XskOFms62SyAKkLu8CcGcYHAo+BSHSsORI8s4PJH8qZgZY4L4lDfvyN0twvmbpyG+eGrxpyBlskj9d9rJ8A=="],
"normalize-path": ["normalize-path@3.0.0", "", {}, "sha512-6eZs5Ls3WtCisHWp9S2GUy8dqkpGi4BVSz3GaqiE6ezub0512ESztXUwUB6C6IKbQkY2Pnb/mD4WYojCRwcwLA=="],
"object-assign": ["object-assign@4.1.1", "", {}, "sha512-rJgTQnkUnH1sFw8yT6VSU3zD3sWmu6sZhIseY8VX+GRu3P6F7Fu+JNDoXfklElbLJSnc3FUQHVe4cU5hj+BcUg=="],
@@ -3239,6 +3247,10 @@
"@reduxjs/toolkit/reselect": ["reselect@5.3.0", "", {}, "sha512-XGoLeRAVzUTcJ1qkxPQhDJyIZ5d6zzZD9nT7AEZOaaU9UbWclhycElmhO+VD5bFeLuzhPBaOV2oXC8uG35ZSpg=="],
"@shumai/core/@temporalio/activity": ["@temporalio/activity@1.24.0", "", { "dependencies": { "@temporalio/client": "1.24.0", "@temporalio/common": "1.24.0" } }, "sha512-eBBho/r9XHe2KczYGzmaSp6e9+6c9ta/GGOBldIBr00D/cV34kJ76iAY3Ue1pQTaP7YaX3phMuOz07uUg/IKyA=="],
"@shumai/core/@temporalio/workflow": ["@temporalio/workflow@1.24.0", "", { "dependencies": { "@temporalio/common": "1.24.0", "@temporalio/proto": "1.24.0", "nexus-rpc": "^0.0.3" } }, "sha512-pIA9nxkDCCbBnNuMSffQ44HWHYe3zXFfrDpDLwzh/FUSx8uLbsBM8jwf5oUMf+5eV/qVW9PknZhOu9IFO4XnPA=="],
"@shumai/webui/@types/react-dom": ["@types/react-dom@19.2.5", "", { "peerDependencies": { "@types/react": "^19.2.0" } }, "sha512-fMPwH9v7r/pp43yUd2/Mbiex5KouJwwR3dzHkhLREUC6764VyDsqxhAxv6OFEYR1RhjOyD1naqba8ECDBe7ZQg=="],
"@spectrum-web-components/action-button/@spectrum-web-components/icon": ["@spectrum-web-components/icon@0.37.0", "", { "dependencies": { "@spectrum-web-components/base": "^0.37.0", "@spectrum-web-components/iconset": "^0.37.0" } }, "sha512-DZ1yOKHxNQygzIJ7u9akYComDnMmxuTzfmYxxt9sHdUXmc1NbMkCJqEaAG/LYsdb+hc4xWaDTT9SzArLKZ/btA=="],
@@ -3489,6 +3501,14 @@
"@prisma/studio-core/@radix-ui/react-toggle/@radix-ui/react-use-controllable-state": ["@radix-ui/react-use-controllable-state@1.2.2", "", { "dependencies": { "@radix-ui/react-use-effect-event": "0.0.2", "@radix-ui/react-use-layout-effect": "1.1.1" }, "peerDependencies": { "@types/react": "*", "react": "^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc" }, "optionalPeers": ["@types/react"] }, "sha512-BjasUjixPFdS+NKkypcyyN5Pmg83Olst0+c6vGov0diwTEo6mgdqVR6hxcEgFuh4QrAs7Rc+9KuGJ9TVCj0Zzg=="],
"@shumai/core/@temporalio/activity/@temporalio/client": ["@temporalio/client@1.24.0", "", { "dependencies": { "@grpc/grpc-js": "^1.12.4", "@temporalio/common": "1.24.0", "@temporalio/proto": "1.24.0", "abort-controller": "^3.0.0", "long": "^5.3.2", "nexus-rpc": "^0.0.3", "uuid": "^11.1.0" } }, "sha512-/GGg6ZYl+pN/bQEvq414CyjDvyM+MM1WsMzi/7SCYb3UlivVXx9nOmH/6BGx8OfYFayp11fkmfSh6rt7vW/ePQ=="],
"@shumai/core/@temporalio/activity/@temporalio/common": ["@temporalio/common@1.24.0", "", { "dependencies": { "@temporalio/proto": "1.24.0", "long": "^5.3.2", "ms": "3.0.0-canary.1", "nexus-rpc": "^0.0.3", "protobufjs": "^8.7.1" } }, "sha512-jXp77fXwynBcVNc/CaGMT33TVYnhcN26S959HDv7Q71oc0rN6d8RHWR5z0nRCDAu5CQwZQRRhVK0TRdyAiEg7Q=="],
"@shumai/core/@temporalio/workflow/@temporalio/common": ["@temporalio/common@1.24.0", "", { "dependencies": { "@temporalio/proto": "1.24.0", "long": "^5.3.2", "ms": "3.0.0-canary.1", "nexus-rpc": "^0.0.3", "protobufjs": "^8.7.1" } }, "sha512-jXp77fXwynBcVNc/CaGMT33TVYnhcN26S959HDv7Q71oc0rN6d8RHWR5z0nRCDAu5CQwZQRRhVK0TRdyAiEg7Q=="],
"@shumai/core/@temporalio/workflow/@temporalio/proto": ["@temporalio/proto@1.24.0", "", { "dependencies": { "long": "^5.3.2", "protobufjs": "^8.7.1" } }, "sha512-vhlhB9GpoyJx+78r3lDahHywpdri6LKx7kt7djLIw6XzHyb8FQTIi4lX8DSJBqKp3+HVfL1CLwiqO26KFRzg/g=="],
"@spectrum-web-components/action-button/@spectrum-web-components/icon/@spectrum-web-components/iconset": ["@spectrum-web-components/iconset@0.37.0", "", { "dependencies": { "@spectrum-web-components/base": "^0.37.0" } }, "sha512-s1TBjWeQtGdGf6n+r+aG2glv77IgR0pNs0HLusGyYt6jzWFkP276fE7Neqq/2XvG9a9zvAwngffnWS3td/Gtmg=="],
"@spectrum-web-components/action-group/@spectrum-web-components/icons-workflow/@spectrum-web-components/icon": ["@spectrum-web-components/icon@0.37.0", "", { "dependencies": { "@spectrum-web-components/base": "^0.37.0", "@spectrum-web-components/iconset": "^0.37.0" } }, "sha512-DZ1yOKHxNQygzIJ7u9akYComDnMmxuTzfmYxxt9sHdUXmc1NbMkCJqEaAG/LYsdb+hc4xWaDTT9SzArLKZ/btA=="],
@@ -3599,6 +3619,20 @@
"@prisma/studio-core/@radix-ui/react-toggle/@radix-ui/react-use-controllable-state/@radix-ui/react-use-layout-effect": ["@radix-ui/react-use-layout-effect@1.1.1", "", { "peerDependencies": { "@types/react": "*", "react": "^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc" }, "optionalPeers": ["@types/react"] }, "sha512-RbJRS4UWQFkzHTTwVymMTUv8EqYhOp8dOOviLj2ugtTiXRaRQS7GLGxZTLL1jWhMeoSCf5zmcZkqTl9IiYfXcQ=="],
"@shumai/core/@temporalio/activity/@temporalio/client/@temporalio/proto": ["@temporalio/proto@1.24.0", "", { "dependencies": { "long": "^5.3.2", "protobufjs": "^8.7.1" } }, "sha512-vhlhB9GpoyJx+78r3lDahHywpdri6LKx7kt7djLIw6XzHyb8FQTIi4lX8DSJBqKp3+HVfL1CLwiqO26KFRzg/g=="],
"@shumai/core/@temporalio/activity/@temporalio/common/@temporalio/proto": ["@temporalio/proto@1.24.0", "", { "dependencies": { "long": "^5.3.2", "protobufjs": "^8.7.1" } }, "sha512-vhlhB9GpoyJx+78r3lDahHywpdri6LKx7kt7djLIw6XzHyb8FQTIi4lX8DSJBqKp3+HVfL1CLwiqO26KFRzg/g=="],
"@shumai/core/@temporalio/activity/@temporalio/common/ms": ["ms@3.0.0-canary.1", "", {}, "sha512-kh8ARjh8rMN7Du2igDRO9QJnqCb2xYTJxyQYK7vJJS4TvLLmsbyhiKpSW+t+y26gyOyMd0riphX0GeWKU3ky5g=="],
"@shumai/core/@temporalio/activity/@temporalio/common/protobufjs": ["protobufjs@8.8.0", "", { "dependencies": { "long": "^5.3.2" } }, "sha512-N3xhQ5yyBx3vQq4gubBfASzYhJGNzeDbjqBpu61g7UVylsN/qyffU96TKWD3GbbLOKF82VGNRNvv1+BFgE31Eg=="],
"@shumai/core/@temporalio/workflow/@temporalio/common/ms": ["ms@3.0.0-canary.1", "", {}, "sha512-kh8ARjh8rMN7Du2igDRO9QJnqCb2xYTJxyQYK7vJJS4TvLLmsbyhiKpSW+t+y26gyOyMd0riphX0GeWKU3ky5g=="],
"@shumai/core/@temporalio/workflow/@temporalio/common/protobufjs": ["protobufjs@8.8.0", "", { "dependencies": { "long": "^5.3.2" } }, "sha512-N3xhQ5yyBx3vQq4gubBfASzYhJGNzeDbjqBpu61g7UVylsN/qyffU96TKWD3GbbLOKF82VGNRNvv1+BFgE31Eg=="],
"@shumai/core/@temporalio/workflow/@temporalio/proto/protobufjs": ["protobufjs@8.8.0", "", { "dependencies": { "long": "^5.3.2" } }, "sha512-N3xhQ5yyBx3vQq4gubBfASzYhJGNzeDbjqBpu61g7UVylsN/qyffU96TKWD3GbbLOKF82VGNRNvv1+BFgE31Eg=="],
"@spectrum-web-components/action-group/@spectrum-web-components/icons-workflow/@spectrum-web-components/icon/@spectrum-web-components/iconset": ["@spectrum-web-components/iconset@0.37.0", "", { "dependencies": { "@spectrum-web-components/base": "^0.37.0" } }, "sha512-s1TBjWeQtGdGf6n+r+aG2glv77IgR0pNs0HLusGyYt6jzWFkP276fE7Neqq/2XvG9a9zvAwngffnWS3td/Gtmg=="],
"@spectrum-web-components/card/@spectrum-web-components/icons-workflow/@spectrum-web-components/icon/@spectrum-web-components/iconset": ["@spectrum-web-components/iconset@0.37.0", "", { "dependencies": { "@spectrum-web-components/base": "^0.37.0" } }, "sha512-s1TBjWeQtGdGf6n+r+aG2glv77IgR0pNs0HLusGyYt6jzWFkP276fE7Neqq/2XvG9a9zvAwngffnWS3td/Gtmg=="],
@@ -3620,5 +3654,7 @@
"readdir-glob/minimatch/brace-expansion/balanced-match": ["balanced-match@1.0.2", "", {}, "sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw=="],
"@prisma/studio-core/@radix-ui/react-toggle/@radix-ui/react-primitive/@radix-ui/react-slot/@radix-ui/react-compose-refs": ["@radix-ui/react-compose-refs@1.1.2", "", { "peerDependencies": { "@types/react": "*", "react": "^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc" }, "optionalPeers": ["@types/react"] }, "sha512-z4eqJvfiNnFMHIIvXP3CY57y2WJs5g2v3X0zm9mEJkrkNv4rDxu+sg9Jh8EkXyeqBkB7SOcboo9dMVqhyrACIg=="],
"@shumai/core/@temporalio/activity/@temporalio/client/@temporalio/proto/protobufjs": ["protobufjs@8.8.0", "", { "dependencies": { "long": "^5.3.2" } }, "sha512-N3xhQ5yyBx3vQq4gubBfASzYhJGNzeDbjqBpu61g7UVylsN/qyffU96TKWD3GbbLOKF82VGNRNvv1+BFgE31Eg=="],
}
}
@@ -6,8 +6,6 @@ services:
POSTGRES_USER: shumai
POSTGRES_PASSWORD: shumai_password
POSTGRES_DB: shumai_db
ports:
- '5432:5432'
volumes:
- postgres_data:/var/lib/postgresql/18/docker
healthcheck:
@@ -28,6 +26,11 @@ services:
- '3000:3000'
volumes:
- ./data:/app/data
# Hardware Acceleration (NVENC / QuickSync / VA-API / RKMPP)
# Uncomment the extends section below for hardware acceleration:
# extends:
# file: hwaccel.transcoding.yaml
# service: cpu # set to one of [nvenc, quicksync, rkmpp, vaapi, vaapi-wsl] for accelerated transcoding
environment:
# Database Configuration
DATABASE_URL: postgres://shumai:shumai_password@shumai_postgres:5432/shumai_db?search_path=public&sslmode=disable
+5 -2
View File
@@ -6,8 +6,6 @@ services:
POSTGRES_USER: shumai
POSTGRES_PASSWORD: shumai_password
POSTGRES_DB: shumai_db
ports:
- '5432:5432'
volumes:
- postgres_data:/var/lib/postgresql/18/docker
healthcheck:
@@ -28,6 +26,11 @@ services:
- '3000:3000'
volumes:
- ./data:/app/data
# Hardware Acceleration (NVENC / QuickSync / VA-API / RKMPP)
# Uncomment the extends section below for hardware acceleration:
# extends:
# file: hwaccel.transcoding.yaml
# service: cpu # set to one of [nvenc, quicksync, rkmpp, vaapi, vaapi-wsl] for accelerated transcoding
environment:
# Database Configuration
DATABASE_URL: postgres://shumai:shumai_password@shumai_postgres:5432/shumai_db?search_path=public&sslmode=disable
@@ -0,0 +1,44 @@
# Configurations for hardware-accelerated transcoding
services:
cpu: {}
nvenc:
deploy:
resources:
reservations:
devices:
- driver: nvidia
count: 1
capabilities:
- gpu
- compute
- video
quicksync:
devices:
- /dev/dri:/dev/dri
rkmpp:
security_opt: # enables full access to /sys and /proc, still far better than privileged: true
- systempaths=unconfined
- apparmor=unconfined
group_add:
- video
devices:
- /dev/rga:/dev/rga
- /dev/dri:/dev/dri
- /dev/dma_heap:/dev/dma_heap
- /dev/mpp_service:/dev/mpp_service
vaapi:
devices:
- /dev/dri:/dev/dri
vaapi-wsl: # use this for VAAPI if running in WSL2
devices:
- /dev/dri:/dev/dri
- /dev/dxg:/dev/dxg
volumes:
- /usr/lib/wsl:/usr/lib/wsl
environment:
- LIBVA_DRIVER_NAME=d3d12
@@ -7,8 +7,6 @@ services:
POSTGRES_USER: shumai
POSTGRES_PASSWORD: shumai_password
POSTGRES_DB: shumai_db
ports:
- '5432:5432'
volumes:
- postgres_data:/var/lib/postgresql
healthcheck:
+835
View File
@@ -0,0 +1,835 @@
---
title: "Changelog"
description: "Recent updates, new features, and improvements in Shumai"
---
<Update label="v0.4.9" description="September 28, 2026">
### Added
- **notification**: You can now receive notifications via email, with batched digest emails and configurable team-level SMTP settings
- **transcode**: Add VA-API hardware acceleration support for Linux hosts and Docker environments with Intel and AMD GPUs, featuring automatic DRI render node discovery, variable bitrate control, and structured transcoding observability logs
- **transcode**: Add automatic fallback to software transcoding (libx264) when hardware-accelerated video encoding encounters GPU resolution constraints or runtime driver errors
- **docker**: Add modular hardware-accelerated transcoding presets matching Immich's compose configuration via `hwaccel.transcoding.yaml` with support for NVENC, QuickSync, RKMPP, and VA-API
### Fixed
### Changed
- **transcode**: Improve video poster selection using intelligent scene detection and color variance filtering to automatically skip black frames, fade-ins, and blank intros in favor of representative video content
- **transcode**: Optimize video sprite generation for large and long videos using a concurrent fast-seek pool and image compositing, avoiding full-video decoding while preserving instant single-pass generation for short clips
</Update>
<Update label="v0.4.8" description="September 24, 2026">
### Added
- **transcode**: Add HDR video proxy support: HDR videos automatically generate HDR video proxies and preview videos preserving HDR color characteristics, tone-mapped SDR thumbnails and posters, and automatic HDR player playback on supported displays with hardware EDR acceleration
- **docs**: Add a Changelog section to the documentation site so users can explore release notes and updates directly in Mintlify
### Fixed
- **webui**: Only show the center play button and darkened tint on initial video open before playback starts; once played, pausing or scrubbing back to start keeps the video canvas clean and unobstructed for review
- **transcode**: Fix an issue where videos with orientation or rotation metadata (such as smartphone vertical videos) were incorrectly displayed with stretched aspect ratios in the video player
- **cli**: Only manage and check PID files in daemon mode, preventing stale PID files, crash-loop conflicts, or spurious process checks during normal foreground and Docker execution
### Changed
- **transcode**: Improve video proxy visual quality and disable B-frames for smoother frame-by-frame seeking and scrubbing
</Update>
<Update label="v0.4.7" description="September 19, 2026">
### Added
- **changelog**: Introduce Keep a Changelog support, historical release summaries, and automated release notes extraction
- **release**: Automatically populate GitHub release bodies from CHANGELOG.md and promote unreleased notes during version bumps
- **settings**: Add FFmpeg threads slider to team media processing settings
- **asset**: Show previews of a folder's contents and a "days left" countdown for each item in Recently Deleted
- **asset**: Show the poster and hover preview for a video in the file list while it is still transcoding, with a gently pulsing cover (or an animated waiting circle before the poster is ready), "Uploading..."/"Preparing..." labels, and the duration hidden until it is ready
### Fixed
- **asset**: Fix an issue where moving a video to trash while it was still transcoding could cause it to lose its trashed status
- **transcode**: Immediately stop background video processing and transcoding when a file is permanently deleted from the trash
- **asset**: Fix proxy download filename using original file extension instead of proxy extension
- **asset**: Fix an issue where deleting or restoring a version stack from the file list did nothing
- **webui**: Center breadcrumb file action popup menu on the chevron icon
</Update>
<Update label="v0.4.6" description="September 17, 2026">
### Added
- **comment**: Add emoji reaction support for comments ([#405](https://github.com/shumaiOne/shumai/pull/405))
- **premiere-uxp**: Introduce Adobe Premiere Pro UXP plugin for Shumai ([#407](https://github.com/shumaiOne/shumai/pull/407))
- **settings**: Add team appearance setting to hide agent features ([#411](https://github.com/shumaiOne/shumai/pull/411))
### Fixed
- **premiere-uxp**: Preserve remote cloud storage presigned URLs in asset resolution ([#408](https://github.com/shumaiOne/shumai/pull/408))
- **premiere-uxp**: Scope sequence links by server endpoint and surface sync errors ([#409](https://github.com/shumaiOne/shumai/pull/409))
- **api**: Enforce SHUMAI_DEMO_MODE for API token and CLI requests ([#413](https://github.com/shumaiOne/shumai/pull/413))
### Documentation
- Add NLE export and Premiere Pro UXP plugin documentation ([#412](https://github.com/shumaiOne/shumai/pull/412))
</Update>
<Update label="v0.4.5" description="September 13, 2026">
### Added
- **core**: Export comments to FCP, Premiere, Media Composer, and Resolve ([#400](https://github.com/shumaiOne/shumai/pull/400))
- **webui**: Add NLE comments export and migrate export API to POST ([#401](https://github.com/shumaiOne/shumai/pull/401))
- **webui**: Add space key quick preview for files and folders ([#402](https://github.com/shumaiOne/shumai/pull/402))
- **webui**: Show comments count badge in file card preview area ([#403](https://github.com/shumaiOne/shumai/pull/403))
- **agent**: Use deterministic storage keys for preset avatars ([#404](https://github.com/shumaiOne/shumai/pull/404))
</Update>
<Update label="v0.4.4" description="September 9, 2026">
### Added
- **upload**: S3 multipart upload with offline resume and wake lock ([#391](https://github.com/shumaiOne/shumai/pull/391))
- **transcode**: Optimize video operations using ffmpeg http range requests ([#393](https://github.com/shumaiOne/shumai/pull/393))
- **agent**: Enable read_asset tool for autofill agent ([#396](https://github.com/shumaiOne/shumai/pull/396))
- **sandbox**: Abstract SandboxService and hot-reload allowed domains ([#398](https://github.com/shumaiOne/shumai/pull/398))
### Fixed
- **s3**: Stream downloadToFile and putObject to prevent OOM on large files ([#392](https://github.com/shumaiOne/shumai/pull/392))
- **agent**: Pass agent thinkingLevel to session name generation ([#395](https://github.com/shumaiOne/shumai/pull/395))
- **agent**: Restrict pageCount and duration recommendations to matching media types ([#397](https://github.com/shumaiOne/shumai/pull/397))
- **transcode**: Co-locate screenshots and derived artifacts in asset storage directory ([#399](https://github.com/shumaiOne/shumai/pull/399))
</Update>
<Update label="v0.4.3" description="September 6, 2026">
### Added
- **asset**: Record and display agent provenance on assets and audit logs ([#380](https://github.com/shumaiOne/shumai/pull/380))
- **agent**: Store preset avatars as real files in s3 storage ([#381](https://github.com/shumaiOne/shumai/pull/381))
- **agent**: Add built-in image and video generation tools and settings ([#382](https://github.com/shumaiOne/shumai/pull/382))
- **media-generation**: Add gemini-omni-1.1-flash video model and redesign settings UI ([#383](https://github.com/shumaiOne/shumai/pull/383))
- **settings**: Redesign image/video settings to provider dialog with model toggles ([#385](https://github.com/shumaiOne/shumai/pull/385))
- **agent**: Add asset management tools and CLI commands ([#387](https://github.com/shumaiOne/shumai/pull/387))
- **cli**: Control asset deletion via SHUMAI_ALLOW_DELETE env var ([#388](https://github.com/shumaiOne/shumai/pull/388))
### Fixed
- **webui**: Clamp file card creation info to 2 lines and show tooltip on hover ([#390](https://github.com/shumaiOne/shumai/pull/390))
### Documentation
- **agents**: Add documentation for image and video generation settings ([#389](https://github.com/shumaiOne/shumai/pull/389))
### Maintenance
- **deps**: Upgrade bun to 1.4.2 and update packages ([#384](https://github.com/shumaiOne/shumai/pull/384))
- **i18n**: Update paraglide-js to 2.25.0 and stop checking in generated code ([#386](https://github.com/shumaiOne/shumai/pull/386))
</Update>
<Update label="v0.4.2" description="September 3, 2026">
### Added
- **chat**: Support markups, attachments, and timestamps in agent 1-to-1 chat ([#368](https://github.com/shumaiOne/shumai/pull/368))
- **agent**: Move thread metadata to structured context XML ([#373](https://github.com/shumaiOne/shumai/pull/373))
- **agent**: Improve timestamp precision and proxy selection for video screenshots ([#374](https://github.com/shumaiOne/shumai/pull/374))
- **agent**: Support dynamic annotationId resolution across chat and comments ([#375](https://github.com/shumaiOne/shumai/pull/375))
- **agent**: Consolidate media tools into read_asset and add S3 key support to download_asset ([#376](https://github.com/shumaiOne/shumai/pull/376))
- **provider**: Optimize provider and model configuration management ([#377](https://github.com/shumaiOne/shumai/pull/377))
- **provider**: Add provider and model sync feature with vendored generator ([#378](https://github.com/shumaiOne/shumai/pull/378))
### Fixed
- **agent**: Set empty details in asset tool results to avoid data duplication ([#370](https://github.com/shumaiOne/shumai/pull/370))
- **webui**: Strip styles and preserve multiline text on paste in chat input ([#371](https://github.com/shumaiOne/shumai/pull/371))
- **agent**: Hide main comment sessions in dashboard sessions list ([#372](https://github.com/shumaiOne/shumai/pull/372))
### Changed
- **webui**: Use semantic system colors in notification settings ([#379](https://github.com/shumaiOne/shumai/pull/379))
</Update>
<Update label="v0.4.1" description="August 30, 2026">
### Added
- **webui**: Add manage versions option to file card context menu ([#364](https://github.com/shumaiOne/shumai/pull/364))
- **agent**: Refactor message context into unified shumai_message ([#365](https://github.com/shumaiOne/shumai/pull/365))
- **webui**: Redesign comment attachment display into compact rows ([#366](https://github.com/shumaiOne/shumai/pull/366))
### Fixed
- **asset,webui**: Disallow dropping version stacks onto files and version stacks ([#363](https://github.com/shumaiOne/shumai/pull/363))
- **webui**: Prevent empty folder flash during initial loading ([#367](https://github.com/shumaiOne/shumai/pull/367))
### Changed
- **agent**: Remove executeAgentToolWorkflow and invoke core services directly ([#362](https://github.com/shumaiOne/shumai/pull/362))
</Update>
<Update label="v0.4.0" description="August 28, 2026">
### Added
- **transcode**: Add hardware-accelerated video transcoding support ([#352](https://github.com/shumaiOne/shumai/pull/352))
- **webui**: Truncate long file names with 100ms hover tooltip ([#355](https://github.com/shumaiOne/shumai/pull/355))
- **webui**: Add simplified mobile-friendly layout for file and share lists ([#356](https://github.com/shumaiOne/shumai/pull/356))
- **webui**: Add mobile friendly file detail and public share view ([#359](https://github.com/shumaiOne/shumai/pull/359))
### Fixed
- **transcode**: Apply team hardware acceleration and source bitrate capping to watermark transcoding ([#353](https://github.com/shumaiOne/shumai/pull/353))
- **share**: Hide and soft-delete symlinks when target assets are trashed ([#354](https://github.com/shumaiOne/shumai/pull/354))
- **webui**: Fix breadcrumb file dropdown trigger stretching and alignment ([#360](https://github.com/shumaiOne/shumai/pull/360))
- **webui**: Align mobile comment cards and thread vertical indicator ([#361](https://github.com/shumaiOne/shumai/pull/361))
### Documentation
- Add SECURITY.md with a private disclosure path ([#357](https://github.com/shumaiOne/shumai/pull/357))
</Update>
<Update label="v0.3.11" description="August 25, 2026">
### Added
- **auth**: Add admin password reset CLI command and reset password web UI ([#347](https://github.com/shumaiOne/shumai/pull/347))
- **project**: Add recent viewed files section to project folder tree ([#348](https://github.com/shumaiOne/shumai/pull/348))
### Fixed
- **webui**: Prevent left carousel remounting and scroll jump on file selection ([#351](https://github.com/shumaiOne/shumai/pull/351))
</Update>
<Update label="v0.3.10" description="August 23, 2026">
### Added
- **agentic kanban**: Phase 1 not-agentic kanban board ([#330](https://github.com/shumaiOne/shumai/pull/330))
- **kanban**: Resolve latest version for linked version stack assets and update demo login text ([#342](https://github.com/shumaiOne/shumai/pull/342))
- **kanban**: Update task status permissions, reporter defaults, and participant access ([#345](https://github.com/shumaiOne/shumai/pull/345))
### Fixed
- **kanban**: Use true thumbnail and poster for task asset previews ([#343](https://github.com/shumaiOne/shumai/pull/343))
- **webui**: Sidebar selection styling, kanban active state, pointer cursors, and owner dashboard ([#344](https://github.com/shumaiOne/shumai/pull/344))
- **kanban**: Improve drag-drop to column bottom, remove empty drop line, and fix timeline alignment ([#346](https://github.com/shumaiOne/shumai/pull/346))
</Update>
<Update label="v0.3.9" description="August 18, 2026">
### Added
- **agent**: Add permission controls for chat agents ([#313](https://github.com/shumaiOne/shumai/pull/313))
- **authz**: Enforce project-aware roles for agent/skill/mcp permissions ([#314](https://github.com/shumaiOne/shumai/pull/314))
- **webui**: Use project members for asset comment mentions ([#315](https://github.com/shumaiOne/shumai/pull/315))
- **quota**: Add 2-level database-backed resource quota system ([#318](https://github.com/shumaiOne/shumai/pull/318))
- **settings**: Reorganize settings into personal, team, and AI sections ([#324](https://github.com/shumaiOne/shumai/pull/324))
- **quota**: Move usage monitoring to team dashboard ([#327](https://github.com/shumaiOne/shumai/pull/327))
### Fixed
- **webui**: Preserve selected chatbot agent preference on reload ([#323](https://github.com/shumaiOne/shumai/pull/323))
- **quota**: Exclude agents from quota rules and usage records ([#325](https://github.com/shumaiOne/shumai/pull/325))
### Documentation
- **team-settings**: Add resource quotas documentation and update readme features ([#326](https://github.com/shumaiOne/shumai/pull/326))
</Update>
<Update label="v0.3.8" description="August 15, 2026">
### Added
- **webui**: Replace legacy markdown editor with new lexical wysiwyg editor ([#308](https://github.com/shumaiOne/shumai/pull/308))
- **agent**: Add nested agents.md support across backend and webui ([#309](https://github.com/shumaiOne/shumai/pull/309))
- **webui**: Improve AGENTS.md editor placeholder and read-only notice ([#310](https://github.com/shumaiOne/shumai/pull/310))
- **version-stack**: Add manage versions dialog and version removal ([#311](https://github.com/shumaiOne/shumai/pull/311))
### Fixed
- **core**: Rename latest version child record on version stack rename ([#312](https://github.com/shumaiOne/shumai/pull/312))
</Update>
<Update label="v0.3.7" description="August 14, 2026">
### Added
- **metadata**: Replace aiAutofill boolean with autofillSource enum ([#302](https://github.com/shumaiOne/shumai/pull/302))
- **agent**: Type-safe CREATION_CONTEXT metadata on create_file/create_version ([#303](https://github.com/shumaiOne/shumai/pull/303))
- **sandbox**: Default Network Sandbox to off and add settings toggle switch ([#304](https://github.com/shumaiOne/shumai/pull/304))
- **webui**: Redesign select metadata fields and improve long text field widget ([#305](https://github.com/shumaiOne/shumai/pull/305))
- **agent**: Support dynamic newOption in select and selectMulti metadata fields ([#306](https://github.com/shumaiOne/shumai/pull/306))
### Fixed
- **webui**: Fix select field height and multi-select overflow/interaction issues ([#307](https://github.com/shumaiOne/shumai/pull/307))
</Update>
<Update label="v0.3.6" description="August 12, 2026">
### Added
- **mcp**: Add MCP server support with proxy tool and OAuth flow ([#289](https://github.com/shumaiOne/shumai/pull/289))
- **mcp**: Support tool-level directTools array and 3-state UI configuration ([#297](https://github.com/shumaiOne/shumai/pull/297))
- **webui**: Direct canvas PDF rendering with selectable text ([#299](https://github.com/shumaiOne/shumai/pull/299))
### Fixed
- **agent**: Prevent agents from accessing disabled skills ([#292](https://github.com/shumaiOne/shumai/pull/292))
- **agent**: Resolve version stack name and size in list_assets ([#296](https://github.com/shumaiOne/shumai/pull/296))
- **webui**: Content-only pinch-zoom and two-finger pan in media viewers ([#298](https://github.com/shumaiOne/shumai/pull/298))
- **i18n**: Update Chinese translation for dashboard to 仪表板 ([#301](https://github.com/shumaiOne/shumai/pull/301))
### Documentation
- **mcp**: Add MCP support documentation to README and docs ([#300](https://github.com/shumaiOne/shumai/pull/300))
</Update>
<Update label="v0.3.5" description="August 9, 2026">
### Added
- **transcode**: Add Gotenberg support for Office, HTML, CSV, and Markdown PDF proxies ([#283](https://github.com/shumaiOne/shumai/pull/283))
### Fixed
- **webui**: Resolve upload card freeze for unsupported files ([#284](https://github.com/shumaiOne/shumai/pull/284))
- **webui**: Exclude file extension when selecting file name during inline rename ([#285](https://github.com/shumaiOne/shumai/pull/285))
- Use renamed asset name in download Content-Disposition ([#286](https://github.com/shumaiOne/shumai/pull/286))
- **webui**: Batch download no longer flashes a tab per file ([#287](https://github.com/shumaiOne/shumai/pull/287))
- **webui**: Enable rename and delete actions in file detail top bar breadcrumb ([#288](https://github.com/shumaiOne/shumai/pull/288))
</Update>
<Update label="v0.3.4" description="August 8, 2026">
### Added
- **sharelink**: Add sharelink watermark support ([#270](https://github.com/shumaiOne/shumai/pull/270))
- **webui**: Remove original-file display fallbacks, use proxies only ([#273](https://github.com/shumaiOne/shumai/pull/273))
- **share**: Add allow download config to share links ([#275](https://github.com/shumaiOne/shumai/pull/275))
- **transcode**: Update preview thumbnail resolution to 300p with max length constraint ([#281](https://github.com/shumaiOne/shumai/pull/281))
### Fixed
- **share**: Resolve symlink asset downloads in public share pages ([#274](https://github.com/shumaiOne/shumai/pull/274))
- **webui**: Persist project sorting and prevent full page flash ([#276](https://github.com/shumaiOne/shumai/pull/276))
### Documentation
- **share-links**: Document allow download and lazy watermark settings ([#278](https://github.com/shumaiOne/shumai/pull/278))
- **agent**: Clarify create_file/create_version context param guidance ([#282](https://github.com/shumaiOne/shumai/pull/282))
### Maintenance
- **e2e**: Watermarked download-disabled share link coverage (image + video) ([#277](https://github.com/shumaiOne/shumai/pull/277))
- **e2e**: Stabilize watermark share spec on Firefox ([#279](https://github.com/shumaiOne/shumai/pull/279))
- Split e2e scripts into app and webui targets ([#280](https://github.com/shumaiOne/shumai/pull/280))
</Update>
<Update label="v0.3.3" description="August 5, 2026">
### Added
- **agent**: Enable LLM API call retries in AgentHarness ([#250](https://github.com/shumaiOne/shumai/pull/250))
- **audit**: Add audit log support for APIs and WebUI dashboard ([#251](https://github.com/shumaiOne/shumai/pull/251))
- **webui**: Persist agent preference in localStorage ([#254](https://github.com/shumaiOne/shumai/pull/254))
- **e2e**: Add file domain comment and draw tests ([#260](https://github.com/shumaiOne/shumai/pull/260))
- **agent**: Restrict bash access for non-owner users ([#262](https://github.com/shumaiOne/shumai/pull/262))
- **agent**: Allow create_file tool to create files directly from content ([#263](https://github.com/shumaiOne/shumai/pull/263))
- **agent**: Propagate autofill context from chat to autofill workflow ([#264](https://github.com/shumaiOne/shumai/pull/264))
- **webui**: Render select options in field creation mode and pick random option color ([#265](https://github.com/shumaiOne/shumai/pull/265))
- **project**: Include team-scoped members in project member list and add 3-section dialog layout ([#267](https://github.com/shumaiOne/shumai/pull/267))
- **webui**: Disable role dropdown for project-scoped members in team view ([#269](https://github.com/shumaiOne/shumai/pull/269))
### Fixed
- **webui**: Mention popup avatars, keyboard auto-scroll, and non-sticky section headers ([#256](https://github.com/shumaiOne/shumai/pull/256))
- **webui**: Persist field order on drag and drop ([#266](https://github.com/shumaiOne/shumai/pull/266))
### Changed
- **agent**: Load models directly from database without pi fallback ([#253](https://github.com/shumaiOne/shumai/pull/253))
- **core**: Replace generated provider files with pi-ai dynamic methods ([#255](https://github.com/shumaiOne/shumai/pull/255))
### Maintenance
- **core**: Add missing tests for methods introduced in 97069042 ([#252](https://github.com/shumaiOne/shumai/pull/252))
- **e2e**: Add domain-based auth and project web app e2e tests ([#257](https://github.com/shumaiOne/shumai/pull/257))
- **e2e**: Add file, share, and collection web app e2e tests ([#258](https://github.com/shumaiOne/shumai/pull/258))
- **e2e**: Add project-level invite and file-move e2e tests ([#259](https://github.com/shumaiOne/shumai/pull/259))
- **e2e**: Add search in file list and save-search-as-collection cases ([#261](https://github.com/shumaiOne/shumai/pull/261))
- **e2e**: Add member permission change tests ([#268](https://github.com/shumaiOne/shumai/pull/268))
</Update>
<Update label="v0.3.2" description="July 30, 2026">
### Added
- **agent**: Add output truncation and streaming limits to sandboxed bash tool ([#248](https://github.com/shumaiOne/shumai/pull/248))
### Fixed
- **agent**: Download original document asset instead of pdf proxy ([#247](https://github.com/shumaiOne/shumai/pull/247))
- **webui**: Persist chatbot sidebar input text across route navigation ([#249](https://github.com/shumaiOne/shumai/pull/249))
</Update>
<Update label="v0.3.1" description="July 30, 2026">
### Added
- **transcode**: Trigger ai metadata autofill post transcode ([#234](https://github.com/shumaiOne/shumai/pull/234))
- **dashboard**: Add agent sessions view for team owners ([#237](https://github.com/shumaiOne/shumai/pull/237))
- **db**: Preserve agent sessions on asset deletion by setting onDelete to SetNull ([#240](https://github.com/shumaiOne/shumai/pull/240))
- **agent**: Add download_asset tool and prompt instructions ([#242](https://github.com/shumaiOne/shumai/pull/242))
- **db**: Update Asset.sizeByte and AiUsage token fields to BigInt ([#244](https://github.com/shumaiOne/shumai/pull/244))
### Fixed
- **agent**: Include select option labels and field name in autofill schema ([#235](https://github.com/shumaiOne/shumai/pull/235))
- **agent**: Scope agent comment sessions to thread sessions anchored at root comments ([#239](https://github.com/shumaiOne/shumai/pull/239))
- **agent**: Disable tools for session naming and make naming non-blocking ([#241](https://github.com/shumaiOne/shumai/pull/241))
- **webui**: Update file size formatting to SI decimal standard ([#245](https://github.com/shumaiOne/shumai/pull/245))
- **s3**: Enforce property syntax in S3Service interface and fix ReadableStream handling in S3StorageService ([#246](https://github.com/shumaiOne/shumai/pull/246))
</Update>
<Update label="v0.3.0" description="July 28, 2026">
### Added
- **file-browser**: Add copy name and path option to context menu ([#225](https://github.com/shumaiOne/shumai/pull/225))
- **agent**: Inject user name and role into chat context ([#226](https://github.com/shumaiOne/shumai/pull/226))
- **agent**: Refactor database session storage to normalized DAG entries and lazy thread sync ([#229](https://github.com/shumaiOne/shumai/pull/229))
- **agent**: Support ENABLE_WEAKER_NESTED_SANDBOX environment variable ([#233](https://github.com/shumaiOne/shumai/pull/233))
### Fixed
- **agent**: Ensure atomic appendEntry and persist leaf entries in DatabaseSessionStorage ([#224](https://github.com/shumaiOne/shumai/pull/224))
- Sharp version mismatch bug ([#230](https://github.com/shumaiOne/shumai/pull/230))
- **agent**: Resolve S3 MIME type detection and prompt parameter in image analysis ([#232](https://github.com/shumaiOne/shumai/pull/232))
### Changed
- **agent**: Remove implicit agent mention trigger in comment threads ([#227](https://github.com/shumaiOne/shumai/pull/227))
### Maintenance
- **workflow**: Add docker compose deployment verification job ([#231](https://github.com/shumaiOne/shumai/pull/231))
</Update>
<Update label="v0.2.3" description="July 25, 2026">
### Fixed
- **webui**: Show right sidebar by default on file detail page ([#219](https://github.com/shumaiOne/shumai/pull/219))
- **webui**: Refresh file list and detail when agent executes asset creation tools ([#220](https://github.com/shumaiOne/shumai/pull/220))
- **webui**: Fix space key drag overlay and shift range selection for version stacks ([#221](https://github.com/shumaiOne/shumai/pull/221))
- **transcode**: Handle timestamp rounding tolerance for screenshot annotations ([#223](https://github.com/shumaiOne/shumai/pull/223))
### Changed
- **e2e**: Split transcode workflow E2E tests into per-workflow test files ([#222](https://github.com/shumaiOne/shumai/pull/222))
</Update>
<Update label="v0.2.2" description="July 23, 2026">
### Added
- **webui**: Integrate AI usage API into dashboard page ([#216](https://github.com/shumaiOne/shumai/pull/216))
- **ai-usage**: Add team and member token usage tracking and APIs ([#215](https://github.com/shumaiOne/shumai/pull/215))
- **transcode**: Add PSD support via ImageMagick and enforce sRGB conversion ([#217](https://github.com/shumaiOne/shumai/pull/217))
### Fixed
- **search**: Fix buildSqlCondition date range, numeric metadata, and string parsing bugs ([#213](https://github.com/shumaiOne/shumai/pull/213))
- **webui**: Prevent horizontal overflow in search dialog result rows ([#214](https://github.com/shumaiOne/shumai/pull/214))
- **webui**: Invalidate upload tasks query when upload task starts and completes ([#218](https://github.com/shumaiOne/shumai/pull/218))
</Update>
<Update label="v0.2.1" description="July 22, 2026">
### Added
- **skill**: Add team owner skill permission control ([#209](https://github.com/shumaiOne/shumai/pull/209))
### Fixed
- **agent**: Handle non-builtin models in getModelFromDb and upgrade pi-ai ([#211](https://github.com/shumaiOne/shumai/pull/211))
- **provider**: Preserve model ids on provider update ([#212](https://github.com/shumaiOne/shumai/pull/212))
### Changed
- **core**: Split generated providers into per-provider files ([#210](https://github.com/shumaiOne/shumai/pull/210))
</Update>
<Update label="v0.2.0" description="July 21, 2026">
### Added
- **transcode**: Add PDF preview, sprite generation, and annotation support ([#193](https://github.com/shumaiOne/shumai/pull/193))
- **web**: Register pdf.worker route in production ([#195](https://github.com/shumaiOne/shumai/pull/195))
- **agent**: Add read_pdf_pages tool and PDF page context support ([#196](https://github.com/shumaiOne/shumai/pull/196))
- **transcode**: Split monolithic transcodeMedia into focused workflows ([#197](https://github.com/shumaiOne/shumai/pull/197))
- **transcode**: Add PDF proxy support for TXT and CSV files ([#199](https://github.com/shumaiOne/shumai/pull/199))
- **asset**: Replace mediaType/mimeType logic with proxyType ([#200](https://github.com/shumaiOne/shumai/pull/200))
- **docker**: Install fonts-noto-cjk in runner stage ([#202](https://github.com/shumaiOne/shumai/pull/202))
- **transcode**: Add markdown file to pdf proxy support ([#203](https://github.com/shumaiOne/shumai/pull/203))
- **chat**: Track context asset changes and update agent context ([#204](https://github.com/shumaiOne/shumai/pull/204))
- **agent**: Refactor media tools to static injection with mandatory assetId and authz ([#208](https://github.com/shumaiOne/shumai/pull/208))
### Fixed
- **transcode**: Mark pdfkit as external and extract for docker runtime ([#201](https://github.com/shumaiOne/shumai/pull/201))
- **agent**: Include skill id in formatSkillsForPrompt ([#205](https://github.com/shumaiOne/shumai/pull/205))
- **asset**: Exclude soft-deleted children from latestChildren preview ([#206](https://github.com/shumaiOne/shumai/pull/206))
- **agent**: Pass latest version asset from version stack to prompt builder ([#207](https://github.com/shumaiOne/shumai/pull/207))
</Update>
<Update label="v0.1.10" description="July 16, 2026">
### Added
- **workflow-e2e**: Add E2E tests for agentAutofillMedia workflow ([#188](https://github.com/shumaiOne/shumai/pull/188))
- **comments**: Support comment deletion and video player shortcuts ([#191](https://github.com/shumaiOne/shumai/pull/191))
- **agent**: Support disabling specific tools for agents ([#192](https://github.com/shumaiOne/shumai/pull/192))
### Maintenance
- **e2e**: Add E2E workflow tests for remaining agent and transcode services ([#189](https://github.com/shumaiOne/shumai/pull/189))
</Update>
<Update label="v0.1.9" description="July 14, 2026">
### Added
- **e2e**: Set up fullstack app-level e2e test framework and signup test case ([#184](https://github.com/shumaiOne/shumai/pull/184))
- **chat**: Chatbot UI ([#185](https://github.com/shumaiOne/shumai/pull/185))
- **agent**: Support aborting agent execution ([#186](https://github.com/shumaiOne/shumai/pull/186))
### Changed
- **api/chat**: Remove direct Prisma query from API layer ([#187](https://github.com/shumaiOne/shumai/pull/187))
</Update>
<Update label="v0.1.8" description="July 10, 2026">
### Added
- **chatbot**: Implement type-safe Chat APIs with compaction support ([#180](https://github.com/shumaiOne/shumai/pull/180))
### Fixed
- **webui**: Enable build splitting and code-split all page routes ([#183](https://github.com/shumaiOne/shumai/pull/183))
### Documentation
- **readme**: Clarify displayed file size represents original file size ([#182](https://github.com/shumaiOne/shumai/pull/182))
</Update>
<Update label="v0.1.7" description="July 6, 2026">
### Added
- **audio**: Support frame-accurate audio playback, comments, and AI safeguards ([#175](https://github.com/shumaiOne/shumai/pull/175))
- **i18n**: Localize members dialog, notifications, uploads, user menus, dates, and players ([#178](https://github.com/shumaiOne/shumai/pull/178))
- **comments**: Allow marking comments as complete or incomplete ([#179](https://github.com/shumaiOne/shumai/pull/179))
### Fixed
- **upload**: Resolve empty and generic MIME types in confirmFileUpload ([#176](https://github.com/shumaiOne/shumai/pull/176))
### Changed
- **webui**: Modularize file viewer components into registry-driven architecture ([#174](https://github.com/shumaiOne/shumai/pull/174))
### Documentation
- Improve documentation and examples for S3 compatible storage ([#177](https://github.com/shumaiOne/shumai/pull/177))
</Update>
<Update label="v0.1.6" description="July 4, 2026">
### Added
- **file-browser**: Show video duration on file card preview ([#170](https://github.com/shumaiOne/shumai/pull/170))
- **webui**: Compare versions view for version stacks ([#171](https://github.com/shumaiOne/shumai/pull/171))
### Fixed
- **webui**: Resolve conditional hooks and setState-in-render errors ([#167](https://github.com/shumaiOne/shumai/pull/167))
- **webui**: Resolve video player total frames mismatch ([#172](https://github.com/shumaiOne/shumai/pull/172))
- **version-stack**: Resolve correct latest version ID of version stack ([#173](https://github.com/shumaiOne/shumai/pull/173))
### Maintenance
- **webui**: Video player e2e framework + Safari playhead fix ([#166](https://github.com/shumaiOne/shumai/pull/166))
- **webui**: Add frame-accurate comment seek roundtrip e2e ([#168](https://github.com/shumaiOne/shumai/pull/168))
- **webui**: Verify video player restarts playback after end ([#169](https://github.com/shumaiOne/shumai/pull/169))
</Update>
<Update label="v0.1.5" description="July 2, 2026">
### Changed
- **storage**: Use original filenames for stored files ([#165](https://github.com/shumaiOne/shumai/pull/165))
### Maintenance
- **release**: Add Aliyun ACR push to release workflow ([#164](https://github.com/shumaiOne/shumai/pull/164))
</Update>
<Update label="v0.1.4" description="July 1, 2026">
### Added
- **transcode**: Change video poster resolution to 480p ([#161](https://github.com/shumaiOne/shumai/pull/161))
- **auth**: Allow setting user locale on signup ([#163](https://github.com/shumaiOne/shumai/pull/163))
### Fixed
- **webui**: Preserve video ended state by skipping playhead snap on ended ([#162](https://github.com/shumaiOne/shumai/pull/162))
</Update>
<Update label="v0.1.3" description="June 30, 2026">
### Added
- **webui**: Add i18n support using paraglide-js ([#156](https://github.com/shumaiOne/shumai/pull/156))
- **video**: Add frame-accurate video player, SMPTE timecodes, and format switcher ([#157](https://github.com/shumaiOne/shumai/pull/157))
### Fixed
- **webui**: Align video timeline duration and formatting with frameio ([#158](https://github.com/shumaiOne/shumai/pull/158))
- **webui**: Fix missing left sidebar for nested folders ([#159](https://github.com/shumaiOne/shumai/pull/159))
- **api**: Fix update team settings and make request schema type-safe ([#160](https://github.com/shumaiOne/shumai/pull/160))
</Update>
<Update label="v0.1.2" description="June 25, 2026">
### Changed
- **s3**: Remove automatic port appending to AWS_ENDPOINT_URL_S3 ([#155](https://github.com/shumaiOne/shumai/pull/155))
</Update>
<Update label="v0.1.1" description="June 23, 2026">
### Added
- **docker**: Add root entrypoint with privilege dropping for data volumes ([#151](https://github.com/shumaiOne/shumai/pull/151))
</Update>
<Update label="v0.1.0" description="June 22, 2026">
### Added
- **share**: Secure share info API and fix wrong password feedback ([#150](https://github.com/shumaiOne/shumai/pull/150))
### Fixed
- **webui**: Truncate long folder, collection, and share link names in sidebar ([#149](https://github.com/shumaiOne/shumai/pull/149))
</Update>
<Update label="v0.0.11" description="June 22, 2026">
### Added
- **cli**: Add shumai-cli and token authentication ([#144](https://github.com/shumaiOne/shumai/pull/144))
- **settings**: Use singular headers and remove collapse/counters for single agent types ([#145](https://github.com/shumaiOne/shumai/pull/145))
- **folders**: Auto expand folder tree in left sidebar on navigation ([#146](https://github.com/shumaiOne/shumai/pull/146))
- **metadata**: Add single user and multiple user custom fields ([#147](https://github.com/shumaiOne/shumai/pull/147))
### Maintenance
- **cli**: Rename npm package to @shumai-one/shumai-cli ([#148](https://github.com/shumaiOne/shumai/pull/148))
</Update>
<Update label="v0.0.10" description="June 21, 2026">
### Changed
- **web**: Dynamically register production HTML bundle routes ([#142](https://github.com/shumaiOne/shumai/pull/142))
### Documentation
- **readme**: Polish structure, correct grammar, and add dependencies table ([#143](https://github.com/shumaiOne/shumai/pull/143))
</Update>
<Update label="v0.0.9" description="June 20, 2026">
### Added
- **webui**: Show app version in avatar menu ([#139](https://github.com/shumaiOne/shumai/pull/139))
- **cli**: Add background daemonization and subcommands ([#141](https://github.com/shumaiOne/shumai/pull/141))
### Maintenance
- **release**: Add smoke tests to local release stage ([#140](https://github.com/shumaiOne/shumai/pull/140))
</Update>
<Update label="v0.0.8" description="June 19, 2026">
### Added
- **api**: Implement read-only mode for reviewers ([#122](https://github.com/shumaiOne/shumai/pull/122))
- **server**: Allow customizing server port via SHUMAI_SERVER_PORT ([#124](https://github.com/shumaiOne/shumai/pull/124))
- **embedding**: Defer embedding workflow, use transcoded assets, and execute chunks in separate activities ([#125](https://github.com/shumaiOne/shumai/pull/125))
- **webui**: Add external drag-and-drop file and folder upload support ([#126](https://github.com/shumaiOne/shumai/pull/126))
- **agent**: Implement overlapping video chunks for semantic search ([#127](https://github.com/shumaiOne/shumai/pull/127))
- **webui**: Support jumping to video timestamp from search results ([#128](https://github.com/shumaiOne/shumai/pull/128))
- **auth**: Add demo mode support ([#131](https://github.com/shumaiOne/shumai/pull/131))
- **auth**: Refine demo mode support ([#132](https://github.com/shumaiOne/shumai/pull/132))
- **webui**: Default right sidebar to collapsed for new users ([#133](https://github.com/shumaiOne/shumai/pull/133))
- **webui**: Use Shadcn Switch in toggle field and Rating component in search filter panel ([#137](https://github.com/shumaiOne/shumai/pull/137))
- **upload**: Track byte-level progress with XMLHttpRequest ([#138](https://github.com/shumaiOne/shumai/pull/138))
### Fixed
- **transcode**: Handle high-precision FPS using rational fractions ([#123](https://github.com/shumaiOne/shumai/pull/123))
- **db**: Automatically update project updatedAt on asset modification ([#129](https://github.com/shumaiOne/shumai/pull/129))
- **webui**: Use system colors for fields and improve search filter select options ([#130](https://github.com/shumaiOne/shumai/pull/130))
- **search**: Fix hasAny and hasNone operators on metadata filter ([#134](https://github.com/shumaiOne/shumai/pull/134))
- **webui**: Resolve folder tree sync, search dialog reset, and sidebar actions issues ([#136](https://github.com/shumaiOne/shumai/pull/136))
### Changed
- **webui**: Fix search dialog layout height, scroll areas, and restrict filter toggle click ([#135](https://github.com/shumaiOne/shumai/pull/135))
</Update>
<Update label="v0.0.7" description="June 17, 2026">
### Added
- **workflow**: Configure transcode and agent concurrency via environment variables ([#116](https://github.com/shumaiOne/shumai/pull/116))
- **webui**: Replace hardcoded colors with system tokens ([#119](https://github.com/shumaiOne/shumai/pull/119))
- **webui**: Replace native overflow with shadcn ScrollArea in settings ([#120](https://github.com/shumaiOne/shumai/pull/120))
- **api**: Use enum for API protocol in provider config ([#121](https://github.com/shumaiOne/shumai/pull/121))
### Fixed
- **webui**: Reload video player and reset state when switching assets ([#114](https://github.com/shumaiOne/shumai/pull/114))
### Changed
- **transcode**: Relocate TranscodeService to core and flatten API package ([#115](https://github.com/shumaiOne/shumai/pull/115))
### Documentation
- Improve and restructure shumai documentation ([#118](https://github.com/shumaiOne/shumai/pull/118))
</Update>
<Update label="v0.0.6" description="June 15, 2026">
### Added
- **sandbox**: Add pending domains support for network sandbox ([#109](https://github.com/shumaiOne/shumai/pull/109))
- **webui**: Always show right sidebar and implement left vertical carousel ([#111](https://github.com/shumaiOne/shumai/pull/111))
### Fixed
- **build**: Propagate termination signals to active child process in wrappers ([#102](https://github.com/shumaiOne/shumai/pull/102))
- **transcode**: Make deterministic transcode activity failures non-retryable in Temporal ([#104](https://github.com/shumaiOne/shumai/pull/104))
- **player**: Implement seekbar dragging and match hover highlight color ([#108](https://github.com/shumaiOne/shumai/pull/108))
- **webui**: Avoid refetching all pages on file/folder reorder ([#112](https://github.com/shumaiOne/shumai/pull/112))
- **webui**: Force video-player mime type to video/mp4 ([#113](https://github.com/shumaiOne/shumai/pull/113))
### Changed
- **webui**: Use system color design tokens in video player components ([#106](https://github.com/shumaiOne/shumai/pull/106))
- **webui**: Use requestAnimationFrame for smooth video progress bar updates ([#107](https://github.com/shumaiOne/shumai/pull/107))
- **webui**: Fetch agents in mention input list dynamically ([#110](https://github.com/shumaiOne/shumai/pull/110))
### Documentation
- **readme**: Add comprehensive README.md ([#103](https://github.com/shumaiOne/shumai/pull/103))
- **readme**: Improve remote deployment and temporal execution instructions ([#105](https://github.com/shumaiOne/shumai/pull/105))
</Update>
<Update label="v0.0.5" description="June 13, 2026">
### Added
- **npm**: Auto deploy database migrations on package start ([#101](https://github.com/shumaiOne/shumai/pull/101))
</Update>
<Update label="v0.0.4" description="June 12, 2026">
### Fixed
- **cli/docker**: Resolve global CLI external dependencies and fix Docker 404 error ([#100](https://github.com/shumaiOne/shumai/pull/100))
</Update>
<Update label="v0.0.3" description="June 12, 2026">
### Fixed
- **cli**: Resolve platform binary path resolution under nested node_modules ([#99](https://github.com/shumaiOne/shumai/pull/99))
</Update>
<Update label="v0.0.2" description="June 12, 2026">
### Fixed
- **npm**: Add repository metadata to package.json for provenance verification ([#98](https://github.com/shumaiOne/shumai/pull/98))
### Maintenance
- Add release-npm.yaml workflow ([#97](https://github.com/shumaiOne/shumai/pull/97))
</Update>
<Update label="v0.0.1" description="June 12, 2026">
### Added
- Initial release of Shumai
</Update>
+6 -5
View File
@@ -24,12 +24,13 @@ Shumai is configured via environment variables. You can define these variables i
---
## Authentication Config
## Authentication & Application Config
| Variable | Description | Example / Default |
| :------------------- | :--------------------------------------------------------------------- | :--------------------------------------------------------------- |
| `BETTER_AUTH_SECRET` | A secure, random 32-byte secret used to sign session cookies and JWTs. | Generate with `openssl rand -base64 32` |
| `BETTER_AUTH_URL` | The public URL of your Hono backend API. Used for redirect flows. | `http://localhost:3000` (respects `SHUMAI_SERVER_PORT` fallback) |
| Variable | Description | Example / Default |
| :------------------- | :--------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------- |
| `BETTER_AUTH_SECRET` | A secure, random 32-byte secret used to sign session cookies and JWTs. | Generate with `openssl rand -base64 32` |
| `BETTER_AUTH_URL` | The public URL of your Hono backend API. Used for redirect flows and notification email links fallback. | `http://localhost:3000` (respects `SHUMAI_SERVER_PORT` fallback) |
| `APP_URL` | The public URL of the web application. Used for notification email deep links (falls back to `BETTER_AUTH_URL`). | `https://shumai.example.com` |
---
+219
View File
@@ -0,0 +1,219 @@
---
title: Hardware Transcoding
description: Accelerate video transcoding and reduce CPU load with GPU hardware acceleration.
---
High-resolution camera recordings, phone videos, and animation media files require proxy transcoding to play smoothly in web browsers. Shumai transcodes these assets in the background, generating a universal `180p` proxy for instant scrubbing alongside full-resolution preview streams.
Hardware-accelerated transcoding allows you to offload video encoding to a dedicated or integrated GPU, dramatically speeding up processing and freeing host CPU cores for other services.
Shumai includes a built-in usability probe that tests hardware encoders at startup, alongside automatic runtime fallback during video processing. If GPU drivers or device nodes are unavailable, or if a hardware encoder encounters hardware limits (such as resolution or dimension constraints on certain GPUs) or runtime driver errors, Shumai seamlessly falls back to software encoding (`libx264`) without failing user tasks.
---
## Supported Backends
| Backend | Hardware Platform | Container Driver / Devices |
| :-------------- | :--------------------------------- | :----------------------------------------------- |
| **`nvenc`** | NVIDIA GPUs | NVIDIA Container Toolkit (`gpu, compute, video`) |
| **`quicksync`** | Intel Integrated & Arc GPUs | `/dev/dri` render nodes |
| **`vaapi`** | AMD & Intel GPUs | `/dev/dri` render nodes |
| **`rkmpp`** | Rockchip ARM SoCs (e.g. RK3588) | `/dev/rga`, `/dev/dri`, `/dev/mpp_service` |
| **`vaapi-wsl`** | Windows Subsystem for Linux (WSL2) | `/dev/dri`, `/dev/dxg`, `/usr/lib/wsl` |
---
## Limitations
- The instructions on this page focus on **Docker Compose**. Other container orchestrators (such as Kubernetes or Podman) require equivalent device passthrough configurations.
- **Docker Desktop on macOS** runs inside a Linux virtual machine and does not support Apple Silicon VideoToolbox passthrough. (VideoToolbox hardware acceleration is supported when running Shumai natively via NPM or from source).
- Hardware transcoding produces slightly different bitrate characteristics compared to software encoding. Shumai uses adaptive variable bitrate (VBR) rate control tailored to web streaming to maintain visual fidelity.
---
## Prerequisites
### NVENC (NVIDIA)
1. Ensure the official NVIDIA graphics driver is installed on the host:
```bash
nvidia-smi
```
2. Install the [NVIDIA Container Toolkit](https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/latest/install-guide.html) on the host and restart Docker:
```bash
sudo apt-get install -y nvidia-container-toolkit
sudo nvidia-ctk runtime configure --runtime=docker
sudo systemctl restart docker
```
### QuickSync & VA-API (Intel / AMD)
1. Verify that the Linux kernel has initialized the Direct Rendering Infrastructure (DRI) render node:
```bash
ls -la /dev/dri
```
You should see `card0` and `renderD128` (or similar).
2. Shumai's Docker image automatically adjusts group permissions on container startup so the non-root application user can access host `/dev/dri` devices without permission errors.
### WSL2 (Windows)
- Ensure you are running Windows 11 with WSL2 and have installed the appropriate GPU drivers on the Windows host.
- Use the `vaapi-wsl` preset which maps `/dev/dxg` and `/usr/lib/wsl` into the container.
---
## Setup with Docker Compose
Shumai uses a modular `hwaccel.transcoding.yaml` companion file to configure hardware devices.
### Step 1: Download Configuration Files
In your Shumai deployment directory, download the companion `hwaccel.transcoding.yaml` alongside `docker-compose.yaml`:
```bash
# Global / Official
curl -o hwaccel.transcoding.yaml https://raw.githubusercontent.com/shumaiOne/shumai/main/docker-compose/local/hwaccel.transcoding.yaml
# Accelerated Mirror (Mainland China)
curl -o hwaccel.transcoding.yaml https://gh-proxy.com/https://raw.githubusercontent.com/shumaiOne/shumai/main/docker-compose/local/hwaccel.transcoding.yaml
```
### Step 2: Enable Hardware Acceleration in Docker Compose
Open `docker-compose.yaml` (or `docker-compose-aliyun.yaml`), find the commented `extends` block under the `shumai` service, and uncomment it:
```yaml
services:
shumai:
# ...
# Hardware Acceleration (NVENC / QuickSync / VA-API / RKMPP)
extends:
file: hwaccel.transcoding.yaml
service: nvenc # set to one of [nvenc, quicksync, rkmpp, vaapi, vaapi-wsl]
```
Replace `nvenc` with your target backend:
- `nvenc` for NVIDIA GPUs
- `quicksync` for Intel Quick Sync
- `vaapi` for AMD or Intel VA-API
- `rkmpp` for Rockchip SoCs
- `vaapi-wsl` for WSL2 on Windows
### Step 3: Start the Stack
Restart or recreate the Shumai container:
```bash
docker compose up -d
```
---
## Single Compose File Setup (Unraid / Portainer)
If your environment or container manager does not support multi-file `extends`, you can inline the hardware configuration directly into the `shumai` service in `docker-compose.yaml`:
<AccordionGroup>
<Accordion title="NVIDIA NVENC">
```yaml
services:
shumai:
# ...
deploy:
resources:
reservations:
devices:
- driver: nvidia
count: 1
capabilities:
- gpu
- compute
- video
```
</Accordion>
<Accordion title="Intel QuickSync / AMD VA-API">
```yaml services: shumai: # ... devices: - /dev/dri:/dev/dri ```
</Accordion>
<Accordion title="WSL2 (Windows)">
```yaml services: shumai: # ... devices: - /dev/dri:/dev/dri - /dev/dxg:/dev/dxg volumes: -
/usr/lib/wsl:/usr/lib/wsl environment: - LIBVA_DRIVER_NAME=d3d12 ```
</Accordion>
<Accordion title="Rockchip RKMPP">
```yaml
services:
shumai:
# ...
security_opt:
- systempaths=unconfined
- apparmor=unconfined
group_add:
- video
devices:
- /dev/rga:/dev/rga
- /dev/dri:/dev/dri
- /dev/dma_heap:/dev/dma_heap
- /dev/mpp_service:/dev/mpp_service
```
</Accordion>
</AccordionGroup>
---
## Web UI Settings
In the Shumai Web UI, navigate to **Team Settings** > **Transcoding Settings**.
- **Auto (Recommended)**: Shumai automatically probes candidate hardware encoders in optimal order (`h264_nvenc` &rarr; `h264_vaapi` &rarr; `h264_qsv` &rarr; `h264_amf` &rarr; `libx264`). If hardware acceleration is unavailable, it gracefully uses software encoding.
- **Explicit Encoder**: You can pin the transcode pipeline to a specific encoder (e.g. `NVENC`, `Quick Sync`, `VA-API`).
- **Off**: Forces CPU software encoding (`libx264`) for all video jobs.
---
## Verification & Monitoring
### Check Transcode Logs
When video transcoding begins on an uploaded asset, Shumai writes a structured log indicating the chosen encoder:
```bash
docker compose logs -f shumai
```
Look for the `Starting video transcoding` log entry:
```json
{
"level": 30,
"time": 1790414665096,
"encoder": "h264_nvenc",
"hardwareAcceleration": "auto",
"inputFile": "/tmp/transcode-.../video.mp4",
"outputFile": "/tmp/transcode-.../video-180p.mp4",
"msg": "Starting video transcoding"
}
```
If hardware acceleration was successfully initialized, `encoder` will show `h264_nvenc`, `h264_vaapi`, or `h264_qsv`.
### Monitor GPU Utilization
While transcoding a video, you can observe hardware utilization on the host:
- **NVIDIA**:
```bash
nvidia-smi
# or
nvtop
```
- **Intel**:
```bash
sudo intel_gpu_top
```
- **AMD**:
```bash
sudo radeontop
```
+14 -1
View File
@@ -12,6 +12,14 @@
"light": "#F5B895",
"dark": "#A8384D"
},
"navbar": {
"links": [
{
"label": "Changelog",
"href": "/changelog"
}
]
},
"navigation": {
"groups": [
{
@@ -57,16 +65,21 @@
"pages": [
"using-shumai/transcode-settings",
"using-shumai/quotas-settings",
"using-shumai/email-notifications",
"using-shumai/password-reset"
]
},
{
"group": "Configuration",
"pages": ["configuration/env-variables"]
"pages": ["configuration/env-variables", "configuration/hardware-transcoding"]
},
{
"group": "Temporal Deployment",
"pages": ["configuration/temporal"]
},
{
"group": "Releases",
"pages": ["changelog"]
}
]
}
+5
View File
@@ -12,9 +12,14 @@ We support three installation options. For most administrators, **Docker Compose
Docker Compose automatically configures and spins up all required services (the web application, a database, and local storage).
1. **Download the Configuration**:
```bash
curl -o docker-compose.yaml https://raw.githubusercontent.com/shumaiOne/shumai/main/docker-compose/local/docker-compose.yaml
```
> [!TIP]
> **Hardware Acceleration:** By default, the standard Compose stack uses CPU-based software transcoding. If your server has a dedicated or integrated GPU (NVIDIA, Intel, AMD, or Rockchip), see the [Hardware Transcoding Guide](/configuration/hardware-transcoding) to enable GPU acceleration via the companion `hwaccel.transcoding.yaml`.
2. **Start the Services**:
```bash
docker compose up -d
+127
View File
@@ -0,0 +1,127 @@
---
title: Email Notifications
description: Configure team SMTP settings, deliver batched activity digest emails, and send test emails.
---
Shumai includes a built-in email notification system that delivers updates on team activities—such as comments, mentions, new asset uploads, status changes, and Kanban tasks—directly to team members' inboxes.
To prevent inbox clutter and notification fatigue, Shumai does not send emails for every single action individually. Instead, a background delivery service aggregates pending notifications and sends periodic, batched digest emails with inline thumbnails and deep links.
---
## Configuring SMTP Settings
Email notification settings are managed at the team level by **Team Owners**.
To configure outgoing mail:
1. Click on **Team Settings** in the sidebar.
2. Select the **Email Notifications** tab.
3. Turn on the **Enable Email Notifications** switch.
4. Fill in your SMTP server credentials and sender information.
5. Click **Save** or **Save and Send Test Email**.
### SMTP Server Settings
| Field | Description | Example / Default |
| :---------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------- |
| **SMTP Host** | The hostname or IP address of your outgoing SMTP server. | `smtp.example.com` or `smtp.sendgrid.net` |
| **SMTP Port** | The port used to connect to your SMTP server. | `587` (default, STARTTLS), `465` (SSL/TLS), or `25` |
| **Username** | The username or API key required to authenticate with the SMTP server. | `user@example.com` or `apikey` |
| **Password** | The authentication password or API secret. | `••••••••` |
| **SSL / TLS (SMTPS)** | Connect directly using SSL/TLS encryption. Typically required when connecting over port `465`. | `Disabled` (default) |
| **Ignore Certificate Errors** | Allows connections with self-signed, invalid, or unverified TLS certificates. Useful for local testing (e.g. Mailpit, MailHog) or private corporate relays. | `Disabled` (default) |
> [!TIP]
> **Password Retention**: When updating existing email settings, you can leave the password input blank to keep the currently stored password. For security, stored passwords are never returned in cleartext to the client.
### Sender Information
| Field | Description | Example / Default |
| :----------- | :-------------------------------------------------------------------------------------------------------------------------------------------------- | :----------------------------- |
| **From** | The sender name and email address that will appear in the `From` header. Ensure your SMTP provider is authorized to send on behalf of this address. | `Shumai <noreply@example.com>` |
| **Reply-To** | _(Optional)_ An email address to receive replies if members respond directly to a notification email. | `support@example.com` |
---
## Testing SMTP Delivery
Before relying on email delivery, you can verify your configuration and credentials directly from the settings page:
1. Click **Save and Send Test Email**.
2. In the **Send Test Email** modal, verify or adjust the sender `From` address.
3. Click **Send Test Email**.
Shumai will perform an active handshake verification (`transport.verify()`) against your SMTP server and dispatch a styled test message to the email address of the currently logged-in administrator.
If the handshake or delivery fails (for example, due to an invalid password, blocked outbound port, or rejected sender address), an error toast is displayed with the exact message returned by the SMTP server.
---
## Delivery Architecture & Digest Batching
Shumai uses an asynchronous, batched architecture for email delivery:
```
[ Team Activity ]
(Comments, Uploads, Mentions, Kanban)
│
▼
[ Database Queue ] (status: pending)
│
▼ (Every 3 minutes)
[ Notification Background Job ]
│
├─ Filter recipients (check user preferences & project scope)
├─ Exclude self-actions and AI agents
├─ Group & collapse items (clusters > 3 summarized)
├─ Fetch avatars & thumbnails as inline CID attachments
│
▼
[ Nodemailer Transport ] ──> SMTP Server ──> [ Member Inboxes ]
```
### 1. Periodic Background Delivery
Notifications are queued in PostgreSQL with a `pending` status. A background job runs periodically every **3 minutes**, acquiring pending notifications using atomic queue locking (`FOR UPDATE SKIP LOCKED`). This ensures safe delivery without duplicate emails even when multiple server instances run concurrently.
### 2. Digest Bundling
Rather than sending an email immediately for each action, all notifications collected for a recipient during the 3-minute window are combined into a single digest email. This keeps team communication organized and eliminates inbox spam during heavy collaboration sessions.
### 3. Smart Activity Collapsing
When an event cluster contains a high volume of items (for example, when an editor uploads dozens of video clips at once), Shumai automatically groups and collapses the items:
- If **3 or fewer** items are in a group, each item is displayed with its individual thumbnail and details.
- If **more than 3** items are uploaded together, Shumai summarizes them into a single concise notification (e.g., _"Alice uploaded 12 new files to Project Alpha"_) with a preview of the first three file names.
### 4. Inline CID Attachments
Avatars and video/image asset thumbnails are retrieved from storage and embedded directly into the email as inline MIME attachments (`cid:...`).
Unlike external image links, inline CID attachments:
- Display immediately in desktop and mobile email clients (such as Apple Mail, Gmail, and Outlook) without being blocked by "show remote content" security warnings.
- Do not require publicly accessible S3 URLs or reverse-proxy authentication to render.
### 5. Deep Linking
Every notification card in the email includes deep-linking action buttons (such as **View Asset**, **View Project**, or **View Task**) that navigate members straight to the corresponding resource in Shumai.
To ensure links point to your public domain instead of `localhost`, configure the `APP_URL` or `BETTER_AUTH_URL` environment variable on your Shumai server:
```bash
APP_URL=https://shumai.example.com
```
---
## Member Preferences & Filtering
Email delivery respects team permissions and member choices:
- **Personal Preferences**: Team members can independently choose which types of activities they receive by opening **Team Settings > Notifications**. If a user disables notifications for a category (e.g. general comments or status updates), Shumai will not include those items in their email digests.
- **Self-Action Suppression**: Members never receive notification emails for their own comments, uploads, or task updates (unless they explicitly enable the **Your Uploads** preference to be notified when their own media transcoding completes).
- **Project Scope**: Members whose access is restricted to specific projects only receive email digests for activities within those assigned projects, unless they are explicitly `@mentioned`.
- **AI Agents**: Automated AI agent accounts are automatically excluded from receiving email notifications.
+8
View File
@@ -44,3 +44,11 @@ If you want to mute a specific project entirely (except for direct `@mentions` w
- The **Bell** icon in the navigation bar displays a red badge when you have unread notifications.
- Click the bell to open your notification feed panel.
- Click any notification card to mark it as read and jump directly to the relevant file and comment thread.
---
## Email Notifications
In addition to in-app notifications, Team Owners can configure outgoing SMTP settings to deliver batched activity digest emails to team members. The email delivery engine honors each member's individual notification preferences configured above.
See the [Email Notifications Guide](/using-shumai/email-notifications) for full SMTP setup instructions, test email workflows, and delivery architecture details.
+6
View File
@@ -34,3 +34,9 @@ Team Owners can select how the transcoding engine handles uploaded files. Shumai
Transcoding is resource-intensive. Depending on your scaling needs, your administrator can run the transcode engine on the main server (Single-Server mode) or delegate tasks to specialized transcoding worker machines (Temporal Worker mode).
Note: In all modes, the processing machine must have the standard system media utilities (`ffmpeg` and `ffprobe`) installed.
---
## Hardware Acceleration
To offload encoding workloads to GPUs (NVIDIA NVENC, Intel QuickSync, AMD/Intel VA-API, or Rockchip RKMPP), Shumai supports hardware-accelerated transcoding. See the [Hardware Transcoding Guide](/configuration/hardware-transcoding) for Docker Compose configuration, GPU passthrough, and driver prerequisites.
+4 -2
View File
@@ -1,6 +1,6 @@
{
"name": "shumai",
"version": "0.4.7",
"version": "0.4.9",
"private": true,
"type": "module",
"repository": {
@@ -39,7 +39,9 @@
"release:patch": "bun run scripts/release.ts patch",
"release:minor": "bun run scripts/release.ts minor",
"release:major": "bun run scripts/release.ts major",
"changelog:extract": "bun run scripts/extract-changelog.ts"
"changelog:extract": "bun run scripts/extract-changelog.ts",
"docs:changelog": "bun run scripts/generate-docs-changelog.ts",
"docs:changelog:check": "bun run scripts/generate-docs-changelog.ts --check"
},
"devDependencies": {
"@eslint/js": "10.0.1",
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@shumai/agent",
"version": "0.4.7",
"version": "0.4.9",
"private": true,
"type": "module",
"main": "./src/index.ts",
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@shumai/api",
"version": "0.4.7",
"version": "0.4.9",
"private": true,
"type": "module",
"main": "./src/index.ts",
+110 -7
View File
@@ -2,27 +2,34 @@ import { describe, expect, it, vi, beforeEach } from 'vitest'
import { Hono, type Context, type Next } from 'hono'
import notificationRoute from './notification'
import { notificationService } from '@shumai/core/src/notification/notification'
import { emailService } from '@shumai/core/src/notification/email'
import { authzService, Permission, ResourceType } from '@shumai/core/src/authz/authz'
import { userMetadataService } from '@shumai/core/src/user-metadata/user-metadata'
const mockUser = { id: 'user1', name: 'Test User', email: 'test@example.com' }
vi.mock('./middleware/auth', () => ({
authMiddleware: async (
c: Context<{ Variables: { user: { id: string; name: string } } }>,
next: Next,
) => {
c.set('user', { id: 'user1', name: 'Test User' })
authMiddleware: async (c: Context<{ Variables: { user: typeof mockUser } }>, next: Next) => {
c.set('user', mockUser)
await next()
},
}))
vi.mock('@shumai/core/src/authz/authz')
vi.mock('@shumai/core/src/notification/notification')
vi.mock('@shumai/core/src/notification/email', () => ({
emailService: {
getEmailSettings: vi.fn(),
updateEmailSettings: vi.fn(),
sendTestEmail: vi.fn(),
},
}))
vi.mock('@shumai/core/src/user-metadata/user-metadata')
describe('notification api', () => {
const app = new Hono<{ Variables: { user: { id: string; name: string } } }>()
const app = new Hono<{ Variables: { user: typeof mockUser } }>()
.use('*', async (c, next) => {
c.set('user', { id: 'user1', name: 'Test User' })
c.set('user', mockUser)
await next()
})
.route('/', notificationRoute)
@@ -155,4 +162,100 @@ describe('notification api', () => {
},
)
})
it('GET /teams/:teamId/notifications/email - requires admin and returns settings', async () => {
const mockSettings = {
enabled: true,
host: 'smtp.example.com',
port: 587,
username: 'user',
password: 'secret-password',
smtps: true,
ignoreCert: false,
from: 'noreply@example.com',
replyTo: '',
}
vi.mocked(emailService.getEmailSettings).mockResolvedValue(mockSettings)
const res = await app.request('/teams/t1/notifications/email')
expect(res.status).toBe(200)
const json = await res.json()
expect(json).toEqual(mockSettings)
expect(authzService.hasPermission).toHaveBeenCalledWith({
user: expect.objectContaining({ id: 'user1' }),
permission: Permission.Admin,
type: ResourceType.Team,
id: 't1',
})
expect(emailService.getEmailSettings).toHaveBeenCalledWith('t1')
})
it('PUT /teams/:teamId/notifications/email - requires admin and updates settings', async () => {
const updateInput = {
enabled: true,
host: 'mail.example.com',
port: 465,
username: 'user',
password: 'new-password',
smtps: true,
ignoreCert: false,
from: 'shumai@example.com',
replyTo: 'support@example.com',
}
vi.mocked(emailService.updateEmailSettings).mockResolvedValue(updateInput)
const res = await app.request('/teams/t1/notifications/email', {
method: 'PUT',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify(updateInput),
})
expect(res.status).toBe(200)
const json = await res.json()
expect(json).toEqual(updateInput)
expect(authzService.hasPermission).toHaveBeenCalledWith({
user: expect.objectContaining({ id: 'user1' }),
permission: Permission.Admin,
type: ResourceType.Team,
id: 't1',
})
expect(emailService.updateEmailSettings).toHaveBeenCalledWith('t1', updateInput)
})
it('POST /teams/:teamId/notifications/email/test - requires admin and sends test email', async () => {
const testReq = {
host: 'smtp.example.com',
port: 587,
from: 'noreply@example.com',
}
vi.mocked(emailService.sendTestEmail).mockResolvedValue({
success: true,
messageId: '<test-msg-id@example.com>',
})
const res = await app.request('/teams/t1/notifications/email/test', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify(testReq),
})
expect(res.status).toBe(200)
const json = await res.json()
expect(json).toEqual({
success: true,
messageId: '<test-msg-id@example.com>',
})
expect(authzService.hasPermission).toHaveBeenCalledWith({
user: expect.objectContaining({ id: 'user1' }),
permission: Permission.Admin,
type: ResourceType.Team,
id: 't1',
})
expect(emailService.sendTestEmail).toHaveBeenCalledWith(
't1',
expect.objectContaining({ id: 'user1', email: 'test@example.com' }),
testReq,
)
})
})
+55
View File
@@ -1,11 +1,14 @@
import { zValidator } from '@hono/zod-validator'
import { Hono } from 'hono'
import { notificationService } from '@shumai/core/src/notification/notification'
import { emailService } from '@shumai/core/src/notification/email'
import { authzService, Permission, ResourceType } from '@shumai/core/src/authz/authz'
import {
listNotificationsRequestSchema,
markNotificationReadRequestSchema,
notificationSettingsSchema,
updateEmailNotificationSettingsSchema,
testEmailRequestSchema,
} from '@shumai/dtos'
import { userMetadataService } from '@shumai/core/src/user-metadata/user-metadata'
import type { Prisma } from '@shumai/db'
@@ -109,5 +112,57 @@ const route = new Hono<{ Variables: { user: User } }>()
return c.json({ success: true })
},
)
.get('/teams/:teamId/notifications/email', async (c) => {
const teamId = c.req.param('teamId')
const user = c.get('user')
await authzService.hasPermission({
user,
permission: Permission.Admin,
type: ResourceType.Team,
id: teamId,
})
const settings = await emailService.getEmailSettings(teamId)
return c.json(settings)
})
.put(
'/teams/:teamId/notifications/email',
zValidator('json', updateEmailNotificationSettingsSchema),
async (c) => {
const teamId = c.req.param('teamId')
const user = c.get('user')
const req = c.req.valid('json')
await authzService.hasPermission({
user,
permission: Permission.Admin,
type: ResourceType.Team,
id: teamId,
})
const settings = await emailService.updateEmailSettings(teamId, req)
return c.json(settings)
},
)
.post(
'/teams/:teamId/notifications/email/test',
zValidator('json', testEmailRequestSchema),
async (c) => {
const teamId = c.req.param('teamId')
const user = c.get('user')
const req = c.req.valid('json')
await authzService.hasPermission({
user,
permission: Permission.Admin,
type: ResourceType.Team,
id: teamId,
})
const result = await emailService.sendTestEmail(teamId, user, req)
return c.json(result)
},
)
export default route
+1
View File
@@ -55,6 +55,7 @@ async function applyWatermarkToAssetMedia(
width: vt.width ?? 0,
height: vt.height ?? 0,
size: 0,
hdr: vt.hdr,
})),
)
: []
+45
View File
@@ -418,6 +418,51 @@ describe('Share API', () => {
expect(body.media.imageTranscodes).toEqual([])
})
test('serves watermarked transcodes with hdr flags preserved when watermark enabled and completed', async () => {
vi.spyOn(shareService, 'verifyPublicAccess').mockResolvedValue(shareLinkWithWatermark)
vi.spyOn(watermarkService, 'getCompletedWatermarkMediaMap').mockResolvedValue(
new Map([
[
'file1',
watermarkMediaInfo({
videoTranscodes: [
{ key: 'files/watermarked-1080p.mp4', width: 1920, height: 1080, hdr: false },
{ key: 'files/watermarked-1080p-hdr.mp4', width: 1920, height: 1080, hdr: true },
],
}),
],
]),
)
const res = await app.request('/shares/share1/files/file1', {
method: 'GET',
headers: { 'x-share-password': 'pass' },
})
expect(res.status).toBe(200)
const body = await res.json()
expect(body.media.videoTranscodes).toEqual([
{
id: 'files/watermarked-1080p.mp4',
url: 'http://s3/presigned',
key: 'files/watermarked-1080p.mp4',
width: 1920,
height: 1080,
size: 0,
hdr: false,
},
{
id: 'files/watermarked-1080p-hdr.mp4',
url: 'http://s3/presigned',
key: 'files/watermarked-1080p-hdr.mp4',
width: 1920,
height: 1080,
size: 0,
hdr: true,
},
])
})
test('serves empty transcode arrays while watermark transcoding is in flight', async () => {
vi.spyOn(shareService, 'verifyPublicAccess').mockResolvedValue(shareLinkWithWatermark)
vi.spyOn(watermarkService, 'getCompletedWatermarkMediaMap').mockResolvedValue(new Map())
+21
View File
@@ -223,6 +223,27 @@ describe('team api', () => {
expect(mockGetSettings).toHaveBeenCalledWith('t1')
})
it('GET /teams/:teamId/settings does not return emailNotification to readers', async () => {
mockGetSettings.mockResolvedValue({
semanticSearchEnabled: false,
transcode: { videoStrategy: 'best_match', hardwareAcceleration: 'off', threads: 0 },
appearance: { hideAgent: false },
})
const res = await app.request('/teams/t1/settings')
expect(res.status).toBe(200)
const data = await res.json()
expect(data.emailNotification).toBeUndefined()
expect(authzService.hasPermission).toHaveBeenCalledWith(
expect.objectContaining({
type: ResourceType.Team,
id: 't1',
permission: Permission.Read,
}),
)
})
it('PATCH /teams/:teamId/settings updates settings', async () => {
mockUpdateSettings.mockResolvedValue({ transcode: { videoStrategy: 'all' } })
+3 -1
View File
@@ -105,15 +105,17 @@ const route = new Hono<{ Variables: { user: User } }>()
await uploadService.confirmFileUpload(user.id, taskId, req)
if (!req.errorMessage) {
const context = await assetService.getAssetContext(req.fileId)
await notificationService.create({
type: NotificationType.successful_file_uploaded,
teamId: teamId,
projectId: context.projectId,
creatorId: user.id,
assetId: req.fileId,
taskId: taskId,
})
const context = await assetService.getAssetContext(req.fileId)
await auditLogService.logAction({
action: AuditAction.file_create,
teamId: teamId,
+5 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@shumai/core",
"version": "0.4.7",
"version": "0.4.9",
"private": true,
"type": "module",
"main": "./src/index.ts",
@@ -33,6 +33,8 @@
"@shumai/db": "workspace:*",
"@shumai/dtos": "workspace:*",
"@sinclair/typebox": "0.34.52",
"@temporalio/activity": "1.24.0",
"@temporalio/workflow": "1.24.0",
"adm-zip": "0.6.0",
"ai": "7.0.84",
"better-auth": "1.6.11",
@@ -43,6 +45,7 @@
"extract-zip": "2.0.1",
"hono": "4.13.5",
"jittered-fractional-indexing": "1.0.1",
"nodemailer": "10.0.10",
"pdfkit": "0.20.1",
"pino": "10.3.1",
"sharp": "0.35.4",
@@ -56,6 +59,7 @@
"@modelcontextprotocol/server": "2.0.0",
"@types/adm-zip": "0.5.8",
"@types/extract-zip": "2.0.3",
"@types/nodemailer": "8.0.2",
"@types/pdfkit": "0.17.6"
}
}
+1 -1
View File
@@ -5,7 +5,7 @@ export * from './authz/authz'
export * from './collection/collection'
export * from './invite/invite'
export * from './metadata/metadata'
export * from './notification/notification'
export * from './notification/index'
export * from './project/project'
export * from './provider/provider'
export * from './s3/s3'
@@ -0,0 +1,700 @@
import { describe, expect, it, vi, beforeEach } from 'vitest'
import nodemailer from 'nodemailer'
import { prisma } from '@shumai/db'
import { setupTestDbHooks } from '@shumai/db/test'
import { NotificationType } from '@shumai/db'
import { emailService, DEFAULT_EMAIL_SETTINGS } from './email'
const mockSendMail = vi.fn().mockResolvedValue({ messageId: '<mock-msg-id@shumai.test>' })
const mockVerify = vi.fn().mockResolvedValue(true)
const mockClose = vi.fn()
vi.mock('nodemailer', () => ({
default: {
createTransport: vi.fn(() => ({
sendMail: mockSendMail,
verify: mockVerify,
close: mockClose,
})),
},
}))
describe('EmailService', () => {
setupTestDbHooks()
beforeEach(() => {
vi.clearAllMocks()
mockSendMail.mockResolvedValue({ messageId: '<mock-msg-id@shumai.test>' })
mockVerify.mockResolvedValue(true)
})
describe('getEmailSettings', () => {
it('returns default settings when team settings are not set', async () => {
const team = await prisma.team.create({ data: { name: 'Team Alpha' } })
const settings = await emailService.getEmailSettings(team.id)
expect(settings).toEqual(DEFAULT_EMAIL_SETTINGS)
expect(settings.enabled).toBe(false)
expect(settings.port).toBe(587)
})
it('returns saved email settings when configured', async () => {
const team = await prisma.team.create({
data: {
name: 'Team Beta',
settings: {
emailNotification: {
enabled: true,
host: 'smtp.beta.test',
port: 465,
username: 'beta_user',
password: 'secret_password',
smtps: true,
ignoreCert: false,
from: 'beta@shumai.test',
replyTo: 'reply@shumai.test',
},
},
},
})
const settings = await emailService.getEmailSettings(team.id)
expect(settings.enabled).toBe(true)
expect(settings.host).toBe('smtp.beta.test')
expect(settings.port).toBe(465)
expect(settings.password).toBe('secret_password')
})
it('throws 404 if team does not exist', async () => {
await expect(emailService.getEmailSettings('non-existent-team-id')).rejects.toThrow()
})
})
describe('updateEmailSettings', () => {
it('updates email settings and saves to team.settings', async () => {
const team = await prisma.team.create({ data: { name: 'Team Gamma' } })
const updated = await emailService.updateEmailSettings(team.id, {
enabled: true,
host: 'smtp.gamma.test',
port: 587,
username: 'gamma',
password: 'gamma_password',
smtps: false,
ignoreCert: true,
from: 'gamma@shumai.test',
replyTo: '',
})
expect(updated.enabled).toBe(true)
expect(updated.host).toBe('smtp.gamma.test')
expect(updated.password).toBe('gamma_password')
expect(updated.ignoreCert).toBe(true)
const reloaded = await prisma.team.findUnique({ where: { id: team.id } })
expect(reloaded?.settings?.emailNotification?.host).toBe('smtp.gamma.test')
})
it('preserves existing password if empty string or undefined is provided in update', async () => {
const team = await prisma.team.create({
data: {
name: 'Team Delta',
settings: {
emailNotification: {
enabled: true,
host: 'smtp.delta.test',
port: 587,
username: 'delta',
password: 'original_super_secret',
smtps: false,
ignoreCert: false,
from: 'delta@shumai.test',
replyTo: '',
},
},
},
})
const updated = await emailService.updateEmailSettings(team.id, {
enabled: true,
host: 'smtp.delta-updated.test',
port: 587,
username: 'delta_new',
password: '', // Empty password should retain existing
smtps: true,
ignoreCert: false,
from: 'delta@shumai.test',
})
expect(updated.host).toBe('smtp.delta-updated.test')
expect(updated.password).toBe('original_super_secret')
const reloaded = await prisma.team.findUnique({ where: { id: team.id } })
expect(reloaded?.settings?.emailNotification?.password).toBe('original_super_secret')
})
})
describe('sendMail and verifySmtp', () => {
it('verifySmtp calls transport.verify and closes transport', async () => {
const config = { ...DEFAULT_EMAIL_SETTINGS, host: 'smtp.test' }
const ok = await emailService.verifySmtp(config)
expect(ok).toBe(true)
expect(mockVerify).toHaveBeenCalled()
expect(mockClose).toHaveBeenCalled()
})
it('sendMail sends email using nodemailer transport', async () => {
const config = { ...DEFAULT_EMAIL_SETTINGS, host: 'smtp.test', from: 'shumai@test.com' }
const res = await emailService.sendMail(config, {
to: 'user@test.com',
subject: 'Hello',
html: '<p>Hello World</p>',
text: 'Hello World',
})
expect(res.messageId).toBe('<mock-msg-id@shumai.test>')
expect(mockSendMail).toHaveBeenCalledWith(
expect.objectContaining({
from: 'shumai@test.com',
to: 'user@test.com',
subject: 'Hello',
}),
)
expect(mockClose).toHaveBeenCalled()
})
it('sendMail forwards attachments to nodemailer transport', async () => {
const config = { ...DEFAULT_EMAIL_SETTINGS, host: 'smtp.test', from: 'shumai@test.com' }
const attachments = [
{
filename: 'avatar.png',
content: Buffer.from('image-data'),
cid: 'avatar-123@shumai.internal',
contentType: 'image/png',
},
]
await emailService.sendMail(config, {
to: 'user@test.com',
subject: 'Hello',
html: '<img src="cid:avatar-123@shumai.internal" />',
text: 'Hello',
attachments,
})
expect(mockSendMail).toHaveBeenCalledWith(
expect.objectContaining({
attachments,
}),
)
})
})
describe('sendTestEmail', () => {
it('sends test email to the current admin user', async () => {
const team = await prisma.team.create({
data: {
name: 'Test Team',
settings: {
emailNotification: {
enabled: true,
host: 'smtp.test.com',
port: 587,
username: 'user',
password: 'pw',
smtps: false,
ignoreCert: false,
from: 'sender@test.com',
replyTo: '',
},
},
},
})
const currentUser = { id: 'admin1', email: 'admin@shumai.test', name: 'Admin' }
const result = await emailService.sendTestEmail(team.id, currentUser)
expect(result.success).toBe(true)
expect(result.messageId).toBe('<mock-msg-id@shumai.test>')
expect(mockVerify).toHaveBeenCalled()
expect(mockSendMail).toHaveBeenCalledWith(
expect.objectContaining({
to: 'admin@shumai.test',
subject: 'Test email from Shumai',
}),
)
})
it('allows overriding settings with input draft', async () => {
const team = await prisma.team.create({ data: { name: 'Test Team 2' } })
const currentUser = { id: 'admin2', email: 'admin2@shumai.test', name: 'Admin 2' }
const result = await emailService.sendTestEmail(team.id, currentUser, {
host: 'smtp.draft.com',
from: 'draft@test.com',
password: 'draft-password',
})
expect(result.success).toBe(true)
expect(nodemailer.createTransport).toHaveBeenCalledWith(
expect.objectContaining({
host: 'smtp.draft.com',
}),
)
expect(mockSendMail).toHaveBeenCalledWith(
expect.objectContaining({
from: 'draft@test.com',
to: 'admin2@shumai.test',
}),
)
})
it('throws error when host is missing', async () => {
const team = await prisma.team.create({ data: { name: 'Empty Host Team' } })
const currentUser = { id: 'admin3', email: 'admin3@shumai.test', name: 'Admin 3' }
await expect(
emailService.sendTestEmail(team.id, currentUser, { host: '', from: 'a@b.com' }),
).rejects.toThrow('SMTP host is required')
})
it('throws error when from address is missing', async () => {
const team = await prisma.team.create({ data: { name: 'Empty From Team' } })
const currentUser = { id: 'admin4', email: 'admin4@shumai.test', name: 'Admin 4' }
await expect(
emailService.sendTestEmail(team.id, currentUser, { host: 'smtp.test', from: '' }),
).rejects.toThrow('From address is required')
})
it('throws 400 when verify fails', async () => {
const team = await prisma.team.create({ data: { name: 'Failing Team' } })
const currentUser = { id: 'admin5', email: 'admin5@shumai.test', name: 'Admin 5' }
mockVerify.mockRejectedValueOnce(new Error('Connection refused'))
await expect(
emailService.sendTestEmail(team.id, currentUser, {
host: 'smtp.down.com',
from: 'admin@down.com',
}),
).rejects.toThrow('SMTP verification failed: Connection refused')
})
})
describe('renderNotificationEmail', () => {
it('renders comment notification', () => {
const rendered = emailService.renderNotificationEmail({
type: NotificationType.comment_created,
creatorName: 'Alice',
teamName: 'Designers',
teamId: 'team-1',
projectId: 'proj-1',
assetId: 'asset-1',
assetName: 'logo.png',
commentMessage: 'Please make it bigger',
})
expect(rendered.subject).toContain('Alice commented on "logo.png"')
expect(rendered.html).toContain('Please make it bigger')
expect(rendered.html).toContain('logo.png')
expect(rendered.text).toContain('Alice commented on "logo.png"')
})
it('renders mention notification', () => {
const rendered = emailService.renderNotificationEmail({
type: NotificationType.mention,
creatorName: 'Bob',
teamName: 'Developers',
teamId: 'team-2',
projectId: 'proj-2',
assetId: 'asset-2',
assetName: 'architecture.pdf',
commentMessage: 'Take a look at this',
})
expect(rendered.subject).toContain('Bob mentioned you')
expect(rendered.html).toContain('Bob mentioned you')
expect(rendered.html).toContain('Take a look at this')
})
it('replaces user mentions with user names instead of user ID in comment emails', () => {
const rendered = emailService.renderNotificationEmail({
type: NotificationType.comment_created,
creatorName: 'Bob',
teamName: 'Designers',
teamId: 'team-1',
projectId: 'proj-1',
assetId: 'asset-1',
assetName: 'logo.png',
commentMessage: '<@kUFrm1W4fKLCaLpw2XQP1OPe0gKACJpy> nice',
mentionedUserNames: {
// eslint-disable-next-line @typescript-eslint/naming-convention
kUFrm1W4fKLCaLpw2XQP1OPe0gKACJpy: 'Alice',
},
})
expect(rendered.html).toContain('@Alice nice')
expect(rendered.html).not.toContain('<@kUFrm1W4fKLCaLpw2XQP1OPe0gKACJpy>')
expect(rendered.text).toContain('@Alice nice')
expect(rendered.text).not.toContain('<@kUFrm1W4fKLCaLpw2XQP1OPe0gKACJpy>')
})
it('renders asset upload notification with project name, creator profile image, and upload time', () => {
const rendered = emailService.renderNotificationEmail({
type: NotificationType.successful_file_uploaded,
creatorName: 'Charlie',
creatorAvatarUrl: 'https://example.com/avatar.jpg',
teamName: 'Media',
teamId: 'team-3',
projectName: 'Marketing Campaign',
projectId: 'proj-3',
assetId: 'asset-3',
assetName: 'video.mp4',
fileCount: 1,
uploadTime: new Date('2026-09-27T15:20:00Z'),
})
expect(rendered.subject).toContain('Charlie uploaded "video.mp4" to Marketing Campaign')
expect(rendered.html).toContain('Marketing Campaign')
expect(rendered.html).toContain('https://example.com/avatar.jpg')
expect(rendered.html).toContain('Sep 27, 2026')
expect(rendered.text).toContain('Marketing Campaign')
expect(rendered.text).toContain('Sep 27, 2026')
})
it('renders single file uploaded notification', () => {
const rendered = emailService.renderNotificationEmail({
type: NotificationType.successful_file_uploaded,
creatorName: 'Charlie',
teamName: 'Media',
teamId: 'team-3',
projectId: 'proj-3',
assetId: 'asset-3',
assetName: 'video.mp4',
fileCount: 1,
})
expect(rendered.subject).toContain('Charlie uploaded "video.mp4"')
expect(rendered.html).toContain('video.mp4')
})
it('renders consolidated batch file upload notification', () => {
const rendered = emailService.renderNotificationEmail({
type: NotificationType.successful_file_uploaded,
creatorName: 'Charlie',
teamName: 'Media',
teamId: 'team-3',
projectName: 'Videos',
projectId: 'proj-3',
fileCount: 5,
fileNames: ['img1.png', 'img2.png', 'img3.png', 'img4.png', 'img5.png'],
})
expect(rendered.subject).toContain('Charlie uploaded 5 files to Videos')
expect(rendered.html).toContain('img1.png')
expect(rendered.html).toContain('and 2 more')
})
it('renders user joined team notification', () => {
const rendered = emailService.renderNotificationEmail({
type: NotificationType.new_user_join_team,
creatorName: 'Dave',
teamName: 'Acme Corp',
teamId: 'team-4',
})
expect(rendered.subject).toContain('Dave joined Acme Corp')
expect(rendered.html).toContain('Dave is now a member of Acme Corp')
})
it('renders kanban task notifications', () => {
const created = emailService.renderNotificationEmail({
type: NotificationType.kanban_task_created,
creatorName: 'Eva',
teamName: 'Engineering',
teamId: 'team-5',
kanbanTaskId: 'kt-1',
kanbanTaskTitle: 'Fix login bug',
})
expect(created.subject).toContain('Eva created task "Fix login bug"')
const assigned = emailService.renderNotificationEmail({
type: NotificationType.kanban_task_assigned,
creatorName: 'Frank',
teamName: 'Engineering',
teamId: 'team-5',
kanbanTaskId: 'kt-2',
kanbanTaskTitle: 'Design DB schema',
})
expect(assigned.subject).toContain('Frank assigned you to task "Design DB schema"')
const status = emailService.renderNotificationEmail({
type: NotificationType.kanban_task_status_updated,
creatorName: 'Grace',
teamName: 'Engineering',
teamId: 'team-5',
kanbanTaskId: 'kt-3',
kanbanTaskTitle: 'Refactor auth',
commentMessage: 'Moved to In Progress',
})
expect(status.subject).toContain('Grace updated status of task "Refactor auth"')
expect(status.html).toContain('Moved to In Progress')
})
it('generates correct action links without team id for project and asset URLs', () => {
const baseUrl = emailService.getBaseUrl()
// Project link
const projectEmail = emailService.renderNotificationEmail({
type: NotificationType.new_user_join_project,
creatorName: 'Alice',
teamName: 'Designers',
teamId: '01KY2A7DRK2N0MECBDHTGAVV84',
projectName: 'Project Alpha',
projectId: '01KY2ANCA1SXGSPR63NVVD07EJ',
})
expect(projectEmail.html).toContain(`href="${baseUrl}/projects/01KY2ANCA1SXGSPR63NVVD07EJ"`)
expect(projectEmail.html).not.toContain(
'/teams/01KY2A7DRK2N0MECBDHTGAVV84/projects/01KY2ANCA1SXGSPR63NVVD07EJ',
)
// Asset link
const assetEmail = emailService.renderNotificationEmail({
type: NotificationType.comment_created,
creatorName: 'Alice',
teamName: 'Designers',
teamId: '01KY2A7DRK2N0MECBDHTGAVV84',
projectName: 'Project Alpha',
projectId: '01KY2ANCA1SXGSPR63NVVD07EJ',
assetId: '01KY2ASSET1234567890ABCDEF',
assetName: 'logo.png',
commentMessage: 'Looks good',
})
expect(assetEmail.html).toContain(
`href="${baseUrl}/projects/01KY2ANCA1SXGSPR63NVVD07EJ/files/01KY2ASSET1234567890ABCDEF"`,
)
expect(assetEmail.html).not.toContain('/teams/')
})
})
describe('renderBatchedNotificationEmail', () => {
it('renders single notification with specific subject and detailed row', () => {
const rendered = emailService.renderBatchedNotificationEmail({
teamId: 'team-1',
teamName: 'Designers',
recipientName: 'Bob',
items: [
{
id: 'n-1',
type: NotificationType.successful_file_uploaded,
creatorName: 'Alice',
creatorAvatarUrl: 'https://example.com/alice.png',
teamId: 'team-1',
teamName: 'Designers',
projectId: 'p-1',
projectName: 'Website Redesign',
assetId: 'a-1',
assetName: 'hero.png',
assetThumbnailUrl: 'https://example.com/hero-thumb.png',
createdAt: new Date('2026-09-27T10:00:00Z'),
},
],
})
expect(rendered.subject).toBe('[Shumai] Alice uploaded "hero.png" to Website Redesign')
expect(rendered.html).toContain('Alice')
expect(rendered.html).toContain('Uploaded &quot;hero.png&quot; to Website Redesign')
expect(rendered.html).toContain('https://example.com/hero-thumb.png')
expect(rendered.html).toContain('https://example.com/alice.png')
expect(rendered.text).toContain('Alice: Uploaded "hero.png" to Website Redesign')
})
it('renders detailed rows with thumbnail when event count <= 3', () => {
const rendered = emailService.renderBatchedNotificationEmail({
teamId: 'team-1',
teamName: 'Designers',
recipientName: 'Bob',
items: [
{
id: 'n-1',
type: NotificationType.successful_file_uploaded,
creatorName: 'Alice',
teamId: 'team-1',
teamName: 'Designers',
projectId: 'p-1',
projectName: 'Website Redesign',
assetId: 'a-1',
assetName: 'img1.png',
assetThumbnailUrl: 'https://example.com/img1.png',
createdAt: new Date('2026-09-27T10:00:00Z'),
},
{
id: 'n-2',
type: NotificationType.successful_file_uploaded,
creatorName: 'Alice',
teamId: 'team-1',
teamName: 'Designers',
projectId: 'p-1',
projectName: 'Website Redesign',
assetId: 'a-2',
assetName: 'img2.png',
createdAt: new Date('2026-09-27T10:01:00Z'),
},
],
})
expect(rendered.subject).toBe('[Shumai] 2 new notifications')
expect(rendered.html).toContain('You have 2 new updates:')
expect(rendered.html).not.toContain('in <strong>Designers</strong>')
expect(rendered.html).toContain('Open Shumai')
expect(rendered.html).not.toContain('Open Designers')
expect(rendered.html).not.toContain('Team: Designers')
expect(rendered.text).toContain('You have 2 new update(s):')
expect(rendered.text).toContain('Open Shumai:')
expect(rendered.text).not.toContain('Team: Designers')
expect(rendered.html).toContain('img1.png')
expect(rendered.html).toContain('img2.png')
// img1 has thumbnail, img2 does not
expect(rendered.html).toContain('https://example.com/img1.png')
expect(rendered.text).toContain('img1.png')
expect(rendered.text).toContain('img2.png')
})
it('collapses events into one summary row and omits thumbnails when count > 3', () => {
const items = Array.from({ length: 5 }, (_, i) => ({
id: `n-${i}`,
type: NotificationType.successful_file_uploaded,
creatorName: 'Alice',
creatorAvatarUrl: 'https://example.com/alice.png',
teamId: 'team-1',
teamName: 'Designers',
projectId: 'p-1',
projectName: 'Website Redesign',
assetId: `a-${i}`,
assetName: `photo_${i}.png`,
assetThumbnailUrl: `https://example.com/thumb_${i}.png`,
createdAt: new Date(`2026-09-27T10:0${i}:00Z`),
}))
const rendered = emailService.renderBatchedNotificationEmail({
teamId: 'team-1',
teamName: 'Designers',
recipientName: 'Bob',
items,
})
expect(rendered.subject).toBe('[Shumai] 5 new notifications')
expect(rendered.html).toContain('Alice uploaded 5 assets to Website Redesign')
// Thumbnails must be omitted for collapsed groups (> 3)
expect(rendered.html).not.toContain('https://example.com/thumb_')
expect(rendered.text).toContain('Alice uploaded 5 assets to Website Redesign')
})
it('batches mixed events in 1 email, collapsing groups > 3 while showing <= 3 in detail', () => {
// 4 comments by UserB in Project Alpha (> 3)
const commentItems = Array.from({ length: 4 }, (_, i) => ({
id: `c-${i}`,
type: NotificationType.comment_created,
creatorName: 'UserB',
teamId: 'team-1',
teamName: 'Designers',
projectId: 'p-1',
projectName: 'Project Alpha',
assetId: `a-${i}`,
assetName: `asset_${i}`,
commentMessage: `Comment number ${i}`,
createdAt: new Date(`2026-09-27T11:0${i}:00Z`),
}))
// 1 upload by UserC in Project Alpha (<= 3)
const uploadItem = {
id: 'u-1',
type: NotificationType.successful_file_uploaded,
creatorName: 'UserC',
teamId: 'team-1',
teamName: 'Designers',
projectId: 'p-1',
projectName: 'Project Alpha',
assetId: 'a-upload',
assetName: 'diagram.png',
assetThumbnailUrl: 'https://example.com/diagram.png',
createdAt: new Date('2026-09-27T11:05:00Z'),
}
const rendered = emailService.renderBatchedNotificationEmail({
teamId: 'team-1',
teamName: 'Designers',
recipientName: 'Alice',
items: [...commentItems, uploadItem],
})
expect(rendered.subject).toBe('[Shumai] 5 new notifications')
// Collapsed comment group
expect(rendered.html).toContain('UserB left 4 comments in Project Alpha')
// Detailed upload item with thumbnail
expect(rendered.html).toContain('UserC')
expect(rendered.html).toContain('diagram.png')
expect(rendered.html).toContain('https://example.com/diagram.png')
})
it('generates correct project action links in batched notification emails', () => {
const baseUrl = emailService.getBaseUrl()
const rendered = emailService.renderBatchedNotificationEmail({
teamId: '01KY2A7DRK2N0MECBDHTGAVV84',
teamName: 'Designers',
recipientName: 'Bob',
items: [
{
id: 'n-1',
type: NotificationType.successful_file_uploaded,
creatorName: 'Alice',
teamId: '01KY2A7DRK2N0MECBDHTGAVV84',
teamName: 'Designers',
projectId: '01KY2ANCA1SXGSPR63NVVD07EJ',
projectName: 'Project Alpha',
assetId: '01KY2ASSET1234567890ABCDEF',
assetName: 'hero.png',
createdAt: new Date('2026-09-27T10:00:00Z'),
},
],
})
expect(rendered.html).toContain(
`href="${baseUrl}/projects/01KY2ANCA1SXGSPR63NVVD07EJ/files/01KY2ASSET1234567890ABCDEF"`,
)
expect(rendered.html).not.toContain(
'/teams/01KY2A7DRK2N0MECBDHTGAVV84/projects/01KY2ANCA1SXGSPR63NVVD07EJ',
)
// Test collapsed group (>3 items)
const collapsedItems = Array.from({ length: 4 }, (_, i) => ({
id: `n-${i}`,
type: NotificationType.successful_file_uploaded,
creatorName: 'Alice',
teamId: '01KY2A7DRK2N0MECBDHTGAVV84',
teamName: 'Designers',
projectId: '01KY2ANCA1SXGSPR63NVVD07EJ',
projectName: 'Project Alpha',
assetId: `asset-${i}`,
assetName: `file_${i}.png`,
createdAt: new Date('2026-09-27T10:00:00Z'),
}))
const renderedCollapsed = emailService.renderBatchedNotificationEmail({
teamId: '01KY2A7DRK2N0MECBDHTGAVV84',
teamName: 'Designers',
recipientName: 'Bob',
items: collapsedItems,
})
expect(renderedCollapsed.html).toContain(
`href="${baseUrl}/projects/01KY2ANCA1SXGSPR63NVVD07EJ"`,
)
expect(renderedCollapsed.html).not.toContain(
'/teams/01KY2A7DRK2N0MECBDHTGAVV84/projects/01KY2ANCA1SXGSPR63NVVD07EJ',
)
})
})
})
+912
View File
@@ -0,0 +1,912 @@
import nodemailer, { type Transporter } from 'nodemailer'
import { HTTPException } from 'hono/http-exception'
import { prisma, NotificationType } from '@shumai/db'
import type { EmailNotificationSettings, UpdateEmailNotificationSettings } from '@shumai/dtos'
import { logger } from '@shumai/core/src/logger'
export interface EmailAttachment {
filename: string
content?: Buffer | string
path?: string
cid?: string
contentType?: string
}
export interface SendMailOptions {
to: string
subject: string
html: string
text: string
attachments?: EmailAttachment[]
}
export interface NotificationEmailContext {
type: NotificationType
creatorName: string
creatorAvatarUrl?: string
teamName: string
teamId: string
projectName?: string
projectId?: string
assetName?: string
assetId?: string
kanbanTaskTitle?: string
kanbanTaskId?: string
commentMessage?: string
mentionedUserNames?: Record<string, string>
fileCount?: number
fileNames?: string[]
uploadTime?: string | Date
}
export interface BatchedNotificationItem {
id: string
type: NotificationType
creatorName: string
creatorAvatarUrl?: string
teamId: string
teamName: string
projectId?: string
projectName?: string
assetId?: string
assetName?: string
assetThumbnailUrl?: string
kanbanTaskId?: string
kanbanTaskTitle?: string
commentMessage?: string
mentionedUserNames?: Record<string, string>
uploadTime?: string | Date
createdAt: Date
}
export interface BatchedEmailContext {
teamId: string
teamName: string
recipientName: string
items: BatchedNotificationItem[]
}
export function getNotificationBatchGroupKey(item: BatchedNotificationItem): string {
return `${item.type}_${item.creatorName || ''}_${item.projectId || ''}_${item.teamId}`
}
export const DEFAULT_EMAIL_SETTINGS: EmailNotificationSettings = {
enabled: false,
host: '',
port: 587,
username: '',
password: '',
smtps: false,
ignoreCert: false,
from: '',
replyTo: '',
}
export class EmailService {
getBaseUrl(): string {
const raw =
process.env.APP_URL ||
process.env.BETTER_AUTH_URL ||
`http://localhost:${process.env.SHUMAI_SERVER_PORT || '3000'}`
return raw.replace(/\/+$/, '')
}
createTransport(config: EmailNotificationSettings): Transporter {
return nodemailer.createTransport({
host: config.host,
port: config.port,
secure: config.smtps,
tls: {
rejectUnauthorized: !config.ignoreCert,
},
auth:
config.username || config.password
? {
user: config.username,
pass: config.password,
}
: undefined,
connectionTimeout: 10000,
})
}
async verifySmtp(config: EmailNotificationSettings): Promise<boolean> {
const transport = this.createTransport(config)
try {
await transport.verify()
return true
} finally {
transport.close()
}
}
async sendMail(
config: EmailNotificationSettings,
options: SendMailOptions,
): Promise<{ messageId: string }> {
const transport = this.createTransport(config)
try {
logger.debug(
{ to: options.to, from: config.from, subject: options.subject },
'Sending email via nodemailer',
)
const info = await transport.sendMail({
from: config.from,
replyTo: config.replyTo || config.from,
to: options.to,
subject: options.subject,
html: options.html,
text: options.text,
attachments: options.attachments,
})
logger.info({ messageId: info.messageId, to: options.to }, 'Email sent successfully')
return { messageId: info.messageId }
} finally {
transport.close()
}
}
async getEmailSettings(teamId: string): Promise<EmailNotificationSettings> {
const team = await prisma.team.findUnique({
where: { id: teamId },
select: { settings: true },
})
if (!team) {
throw new HTTPException(404, { message: 'Team not found' })
}
const saved = team.settings?.emailNotification
return {
enabled: saved?.enabled ?? DEFAULT_EMAIL_SETTINGS.enabled,
host: saved?.host ?? DEFAULT_EMAIL_SETTINGS.host,
port: saved?.port ?? DEFAULT_EMAIL_SETTINGS.port,
username: saved?.username ?? DEFAULT_EMAIL_SETTINGS.username,
password: saved?.password ?? DEFAULT_EMAIL_SETTINGS.password,
smtps: saved?.smtps ?? DEFAULT_EMAIL_SETTINGS.smtps,
ignoreCert: saved?.ignoreCert ?? DEFAULT_EMAIL_SETTINGS.ignoreCert,
from: saved?.from ?? DEFAULT_EMAIL_SETTINGS.from,
replyTo: saved?.replyTo ?? DEFAULT_EMAIL_SETTINGS.replyTo,
}
}
async updateEmailSettings(
teamId: string,
input: UpdateEmailNotificationSettings,
): Promise<EmailNotificationSettings> {
const team = await prisma.team.findUnique({
where: { id: teamId },
select: { settings: true },
})
if (!team) {
throw new HTTPException(404, { message: 'Team not found' })
}
const currentSettings = (team.settings || {}) as PrismaJson.Settings
const existingEmailConfig = currentSettings.emailNotification
// If password is not provided or empty, retain existing password
const password =
input.password !== undefined && input.password !== ''
? input.password
: existingEmailConfig?.password || ''
const updatedEmailConfig: PrismaJson.EmailNotificationSettings = {
enabled: input.enabled,
host: input.host,
port: input.port,
username: input.username || '',
password,
smtps: input.smtps,
ignoreCert: input.ignoreCert,
from: input.from,
replyTo: input.replyTo || '',
}
currentSettings.emailNotification = updatedEmailConfig
const updatedTeam = await prisma.team.update({
where: { id: teamId },
data: { settings: currentSettings as PrismaJson.Settings },
select: { settings: true },
})
return updatedTeam.settings?.emailNotification as EmailNotificationSettings
}
async sendTestEmail(
teamId: string,
currentUser: { id: string; email: string; name: string },
overrides?: Partial<EmailNotificationSettings>,
): Promise<{ success: boolean; messageId: string }> {
const saved = await this.getEmailSettings(teamId)
const effectiveConfig: EmailNotificationSettings = {
...saved,
...overrides,
// If override password is empty, fall back to saved
password:
overrides?.password !== undefined && overrides.password !== ''
? overrides.password
: saved.password,
}
if (!effectiveConfig.host) {
throw new HTTPException(400, { message: 'SMTP host is required' })
}
if (!effectiveConfig.from) {
throw new HTTPException(400, { message: 'From address is required' })
}
try {
await this.verifySmtp(effectiveConfig)
} catch (err) {
const errMsg = err instanceof Error ? err.message : String(err)
logger.warn({ teamId, err: errMsg }, 'SMTP verification failed during test email')
throw new HTTPException(400, { message: `SMTP verification failed: ${errMsg}` })
}
const baseUrl = this.getBaseUrl()
const subject = 'Test email from Shumai'
const html = `
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Test Email from Shumai</title>
<style>
body { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif; background-color: #f9fafb; margin: 0; padding: 24px; color: #111827; }
.container { max-width: 600px; margin: 0 auto; background: #ffffff; border-radius: 8px; border: 1px solid #e5e7eb; padding: 32px; }
.header { font-size: 20px; font-weight: 700; margin-bottom: 16px; color: #111827; }
.content { font-size: 14px; line-height: 1.6; color: #4b5563; margin-bottom: 24px; }
.badge { display: inline-block; background-color: #ecfdf5; color: #065f46; font-size: 12px; font-weight: 600; padding: 4px 10px; border-radius: 9999px; margin-bottom: 16px; }
.footer { font-size: 12px; color: #9ca3af; border-top: 1px solid #f3f4f6; padding-top: 16px; margin-top: 24px; }
</style>
</head>
<body>
<div class="container">
<div class="header">Shumai Notification System</div>
<div class="badge">SMTP Verified</div>
<div class="content">
<p>Hello ${escapeHtml(currentUser.name || 'Admin')},</p>
<p>This is a test email confirming that your SMTP server settings are correctly configured for team notifications in Shumai.</p>
<p>Notifications for new comments, mentions, uploads, and Kanban tasks will now be delivered via this email service.</p>
</div>
<div class="footer">
Sent from Shumai at <a href="${baseUrl}" style="color: #6366f1; text-decoration: none;">${baseUrl}</a>
</div>
</div>
</body>
</html>
`.trim()
const text = `
Shumai Notification System - Test Email
Hello ${currentUser.name || 'Admin'},
This is a test email confirming that your SMTP server settings are correctly configured for team notifications in Shumai.
Sent from Shumai at ${baseUrl}
`.trim()
try {
const res = await this.sendMail(effectiveConfig, {
to: currentUser.email,
subject,
html,
text,
})
return { success: true, messageId: res.messageId }
} catch (err) {
const errMsg = err instanceof Error ? err.message : String(err)
logger.error({ teamId, err: errMsg }, 'Failed to send test email')
throw new HTTPException(400, { message: `Failed to send test email: ${errMsg}` })
}
}
renderNotificationEmail(ctx: NotificationEmailContext): {
subject: string
html: string
text: string
} {
const baseUrl = this.getBaseUrl()
let actionUrl = baseUrl
let actionText = 'View in Shumai'
if (ctx.projectId && ctx.assetId) {
actionUrl = `${baseUrl}/projects/${ctx.projectId}/files/${ctx.assetId}`
actionText = 'View Asset'
} else if (ctx.projectId) {
actionUrl = `${baseUrl}/projects/${ctx.projectId}`
actionText = 'View Project'
} else if (ctx.teamId && ctx.kanbanTaskId) {
actionUrl = `${baseUrl}/teams/${ctx.teamId}/kanban?taskId=${ctx.kanbanTaskId}`
actionText = 'View Task'
} else if (ctx.teamId) {
actionUrl = `${baseUrl}/teams/${ctx.teamId}`
actionText = 'Open Shumai'
}
let subject = '[Shumai] Notification'
let headline = 'You have a new notification'
let detail = ''
const actor = ctx.creatorName || 'Someone'
const actorInitial = (actor.trim()[0] || 'U').toUpperCase()
const formattedUploadTime = formatUploadTime(ctx.uploadTime)
let commentMessage = ctx.commentMessage
if (commentMessage) {
commentMessage = commentMessage.replace(/<@([^>]+)>/g, (match, uid) => {
const name = ctx.mentionedUserNames?.[uid]
return name ? `@${name}` : `@${uid}`
})
}
switch (ctx.type) {
case NotificationType.comment_created: {
const target = ctx.assetName ? `"${ctx.assetName}"` : 'an asset'
subject = `[Shumai] ${actor} commented on ${target}`
headline = `${actor} left a comment`
detail = commentMessage ? `"${commentMessage}"` : `New comment on ${target}`
break
}
case NotificationType.reply_created: {
const target = ctx.assetName ? `"${ctx.assetName}"` : 'an asset'
subject = `[Shumai] ${actor} replied to your comment on ${target}`
headline = `${actor} replied to your comment`
detail = commentMessage ? `"${commentMessage}"` : `Reply on ${target}`
break
}
case NotificationType.mention: {
subject = `[Shumai] ${actor} mentioned you`
headline = `${actor} mentioned you`
detail = commentMessage ? `"${commentMessage}"` : 'You were mentioned in a comment'
break
}
case NotificationType.successful_file_uploaded: {
const target = ctx.assetName ? `"${ctx.assetName}"` : 'a file'
const projectInfo = ctx.projectName ? ` to ${ctx.projectName}` : ''
if (ctx.fileCount && ctx.fileCount > 1) {
subject = `[Shumai] ${actor} uploaded ${ctx.fileCount} files${projectInfo}`
headline = `${actor} uploaded ${ctx.fileCount} new files${projectInfo}`
let filesSummary: string
if (ctx.fileNames && ctx.fileNames.length > 0) {
const previewList = ctx.fileNames.slice(0, 3).join(', ')
const remaining = ctx.fileNames.length - 3
filesSummary = remaining > 0 ? `${previewList}, and ${remaining} more` : previewList
} else {
filesSummary = `${ctx.fileCount} new files were uploaded`
}
const details: string[] = []
if (ctx.projectName) details.push(`Project: ${ctx.projectName}`)
if (formattedUploadTime) details.push(`Uploaded at: ${formattedUploadTime}`)
details.push(`Files: ${filesSummary}`)
detail = details.join('\n')
} else {
subject = `[Shumai] ${actor} uploaded ${target}${projectInfo}`
headline = `${actor} uploaded ${target}${projectInfo}`
const details: string[] = []
if (ctx.assetName) details.push(`Asset: ${ctx.assetName}`)
if (ctx.projectName) details.push(`Project: ${ctx.projectName}`)
if (formattedUploadTime) details.push(`Uploaded at: ${formattedUploadTime}`)
detail = details.join('\n')
}
break
}
case NotificationType.metadata_field_updated_status: {
const target = ctx.assetName ? `"${ctx.assetName}"` : 'an asset'
subject = `[Shumai] ${actor} updated status of ${target}`
headline = `${actor} updated status of ${target}`
detail = `Status update on ${target}`
break
}
case NotificationType.new_user_join_team: {
subject = `[Shumai] ${actor} joined ${ctx.teamName}`
headline = `${actor} joined the team`
detail = `${actor} is now a member of ${ctx.teamName}`
break
}
case NotificationType.new_user_join_project: {
const project = ctx.projectName || 'a project'
subject = `[Shumai] ${actor} joined project ${project}`
headline = `${actor} joined project ${project}`
detail = `${actor} is now a member of ${project}`
break
}
case NotificationType.kanban_task_created: {
const task = ctx.kanbanTaskTitle ? `"${ctx.kanbanTaskTitle}"` : 'a task'
subject = `[Shumai] ${actor} created task ${task}`
headline = `${actor} created task ${task}`
detail = commentMessage || `Task ${task} was created`
break
}
case NotificationType.kanban_task_assigned: {
const task = ctx.kanbanTaskTitle ? `"${ctx.kanbanTaskTitle}"` : 'a task'
subject = `[Shumai] ${actor} assigned you to task ${task}`
headline = `${actor} assigned you to task ${task}`
detail = `You have been assigned to ${task}`
break
}
case NotificationType.kanban_task_status_updated: {
const task = ctx.kanbanTaskTitle ? `"${ctx.kanbanTaskTitle}"` : 'a task'
subject = `[Shumai] ${actor} updated status of task ${task}`
headline = `${actor} updated status of ${task}`
detail = commentMessage || `Status changed for ${task}`
break
}
case NotificationType.kanban_task_updated: {
const task = ctx.kanbanTaskTitle ? `"${ctx.kanbanTaskTitle}"` : 'a task'
subject = `[Shumai] ${actor} updated task ${task}`
headline = `${actor} updated task ${task}`
detail = commentMessage || `Task ${task} was updated`
break
}
case NotificationType.kanban_task_deleted: {
const task = ctx.kanbanTaskTitle ? `"${ctx.kanbanTaskTitle}"` : 'a task'
subject = `[Shumai] ${actor} deleted task ${task}`
headline = `${actor} deleted task ${task}`
detail = `Task ${task} was deleted`
break
}
case NotificationType.kanban_task_comment_created: {
const task = ctx.kanbanTaskTitle ? `"${ctx.kanbanTaskTitle}"` : 'a task'
subject = `[Shumai] ${actor} commented on task ${task}`
headline = `${actor} commented on task ${task}`
detail = commentMessage ? `"${commentMessage}"` : `New comment on ${task}`
break
}
}
const avatarHtml = ctx.creatorAvatarUrl
? `<img src="${escapeHtml(ctx.creatorAvatarUrl)}" alt="${escapeHtml(actor)}" width="36" height="36" style="width: 36px; height: 36px; border-radius: 50%; object-fit: cover; display: block; border: 1px solid #e5e7eb;" />`
: `<table cellpadding="0" cellspacing="0" border="0" style="width: 36px; height: 36px; border-radius: 50%; background-color: #4f46e5; text-align: center;"><tr><td style="color: #ffffff; font-weight: 600; font-size: 14px; text-align: center; vertical-align: middle;">${escapeHtml(actorInitial)}</td></tr></table>`
const html = `
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>${escapeHtml(subject)}</title>
<style>
body { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif; background-color: #f9fafb; margin: 0; padding: 24px; color: #111827; }
.container { max-width: 600px; margin: 0 auto; background: #ffffff; border-radius: 8px; border: 1px solid #e5e7eb; padding: 32px; }
.header { font-size: 18px; font-weight: 700; margin-bottom: 8px; color: #111827; }
.content { font-size: 14px; line-height: 1.6; color: #374151; margin-bottom: 24px; }
.detail-box { background-color: #f3f4f6; border-left: 4px solid #4f46e5; padding: 12px 16px; border-radius: 4px; margin: 16px 0; font-size: 14px; color: #1f2937; white-space: pre-wrap; }
.btn { display: inline-block; background-color: #4f46e5; color: #ffffff !important; padding: 10px 20px; border-radius: 6px; text-decoration: none; font-size: 14px; font-weight: 500; margin-top: 12px; }
.footer { font-size: 12px; color: #9ca3af; border-top: 1px solid #f3f4f6; padding-top: 16px; margin-top: 24px; }
</style>
</head>
<body>
<div class="container">
<table cellpadding="0" cellspacing="0" border="0" style="margin-bottom: 16px;">
<tr>
<td style="vertical-align: middle; padding-right: 12px; width: 36px;">
${avatarHtml}
</td>
<td style="vertical-align: middle;">
<div style="font-weight: 600; font-size: 15px; color: #111827; line-height: 1.2;">${escapeHtml(actor)}</div>
${formattedUploadTime ? `<div style="font-size: 12px; color: #6b7280; margin-top: 2px;">Uploaded at ${escapeHtml(formattedUploadTime)}</div>` : ''}
</td>
</tr>
</table>
<div class="header">${escapeHtml(headline)}</div>
<div class="content">
${detail ? `<div class="detail-box">${escapeHtml(detail)}</div>` : ''}
<a href="${actionUrl}" class="btn">${escapeHtml(actionText)}</a>
</div>
<div class="footer">
Sent from <a href="${baseUrl}" style="color: #6366f1; text-decoration: none;">Shumai</a>
</div>
</div>
</body>
</html>
`.trim()
const text = `
${subject}
${headline}
${formattedUploadTime ? `Uploaded at: ${formattedUploadTime}\n` : ''}${detail ? `\n${detail}\n` : ''}
${actionText}: ${actionUrl}
Sent from Shumai at ${baseUrl}
`.trim()
return { subject, html, text }
}
renderBatchedNotificationEmail(ctx: BatchedEmailContext): {
subject: string
html: string
text: string
} {
const baseUrl = this.getBaseUrl()
const teamUrl = `${baseUrl}/teams/${ctx.teamId}`
if (ctx.items.length === 0) {
return {
subject: `[Shumai] Notifications`,
html: `<p>No new notifications.</p>`,
text: `No new notifications.`,
}
}
// Determine subject
let subject = `[Shumai] ${ctx.items.length} new notifications`
if (ctx.items.length === 1) {
const single = ctx.items[0]
const actor = single.creatorName || 'Someone'
const target = single.assetName ? `"${single.assetName}"` : 'a file'
const projectInfo = single.projectName ? ` to ${single.projectName}` : ''
switch (single.type) {
case NotificationType.successful_file_uploaded:
subject = `[Shumai] ${actor} uploaded ${target}${projectInfo}`
break
case NotificationType.comment_created:
subject = `[Shumai] ${actor} commented on ${target}`
break
case NotificationType.reply_created:
subject = `[Shumai] ${actor} replied to your comment on ${target}`
break
case NotificationType.mention:
subject = `[Shumai] ${actor} mentioned you`
break
case NotificationType.kanban_task_assigned: {
const task = single.kanbanTaskTitle ? `"${single.kanbanTaskTitle}"` : 'a task'
subject = `[Shumai] ${actor} assigned you to task ${task}`
break
}
case NotificationType.kanban_task_created: {
const task = single.kanbanTaskTitle ? `"${single.kanbanTaskTitle}"` : 'a task'
subject = `[Shumai] ${actor} created task ${task}`
break
}
default:
subject = `[Shumai] 1 new notification`
break
}
}
// Group items: same type + actor + project
const groups = new Map<string, BatchedNotificationItem[]>()
for (const item of ctx.items) {
const key = getNotificationBatchGroupKey(item)
const list = groups.get(key)
if (list) {
list.push(item)
} else {
groups.set(key, [item])
}
}
const htmlRows: string[] = []
const textRows: string[] = []
for (const [, cluster] of groups) {
const first = cluster[0]
const actor = first.creatorName || 'Someone'
const avatarHtml = renderAvatarHtml(actor, first.creatorAvatarUrl)
if (cluster.length <= 3) {
// Render detailed individual rows
for (const item of cluster) {
const action = getItemAction(baseUrl, item)
const timeStr = formatUploadTime(item.uploadTime || item.createdAt)
const detail = getNotificationItemDetail(item)
const thumbHtml = item.assetThumbnailUrl
? `<div style="margin-top: 8px;"><img src="${escapeHtml(item.assetThumbnailUrl)}" alt="${escapeHtml(item.assetName || 'Thumbnail')}" width="140" style="max-width: 140px; max-height: 90px; border-radius: 6px; border: 1px solid #e5e7eb; object-fit: cover; display: block;" /></div>`
: ''
htmlRows.push(
`
<div style="padding: 16px 0; border-bottom: 1px solid #f3f4f6;">
<table cellpadding="0" cellspacing="0" border="0" style="width: 100%;">
<tr>
<td style="vertical-align: top; width: 44px; padding-right: 12px;">
${avatarHtml}
</td>
<td style="vertical-align: top;">
<div style="font-weight: 600; font-size: 14px; color: #111827;">${escapeHtml(actor)}</div>
<div style="font-size: 13px; color: #374151; margin-top: 2px;">${escapeHtml(detail.headline)}</div>
${timeStr ? `<div style="font-size: 12px; color: #6b7280; margin-top: 2px;">${escapeHtml(timeStr)}</div>` : ''}
${detail.message ? `<div style="background-color: #f9fafb; border-left: 3px solid #6366f1; padding: 8px 12px; border-radius: 4px; font-size: 13px; color: #4b5563; margin-top: 6px; white-space: pre-wrap;">${escapeHtml(detail.message)}</div>` : ''}
${thumbHtml}
<div style="margin-top: 8px;">
<a href="${action.url}" style="display: inline-block; font-size: 12px; font-weight: 500; color: #4f46e5; text-decoration: none;">${escapeHtml(action.text)} &rarr;</a>
</div>
</td>
</tr>
</table>
</div>
`.trim(),
)
textRows.push(
`- ${actor}: ${detail.headline}${timeStr ? ` (${timeStr})` : ''}${detail.message ? `\n "${detail.message}"` : ''}\n Link: ${action.url}`,
)
}
} else {
// Grouped summary row (count > 3, NO thumbnails)
const count = cluster.length
let summaryHeadline = `${actor} triggered ${count} updates`
const projectName = first.projectName
switch (first.type) {
case NotificationType.successful_file_uploaded:
summaryHeadline = `${actor} uploaded ${count} assets${projectName ? ` to ${projectName}` : ''}`
break
case NotificationType.comment_created:
summaryHeadline = `${actor} left ${count} comments${projectName ? ` in ${projectName}` : ''}`
break
case NotificationType.reply_created:
summaryHeadline = `${actor} replied ${count} times to your comments`
break
case NotificationType.mention:
summaryHeadline = `${actor} mentioned you ${count} times`
break
case NotificationType.metadata_field_updated_status:
summaryHeadline = `${actor} updated status of ${count} assets`
break
case NotificationType.kanban_task_created:
summaryHeadline = `${actor} created ${count} tasks${projectName ? ` in ${projectName}` : ''}`
break
case NotificationType.kanban_task_assigned:
summaryHeadline = `${actor} assigned you to ${count} tasks`
break
case NotificationType.kanban_task_status_updated:
summaryHeadline = `${actor} updated status of ${count} tasks`
break
case NotificationType.kanban_task_updated:
summaryHeadline = `${actor} updated ${count} tasks`
break
case NotificationType.kanban_task_comment_created:
summaryHeadline = `${actor} commented on ${count} tasks`
break
}
const latestTime = cluster.reduce((latest, it) => {
const t = new Date(it.uploadTime || it.createdAt).getTime()
return t > latest ? t : latest
}, 0)
const timeStr = latestTime > 0 ? formatUploadTime(new Date(latestTime)) : undefined
const targetUrl = first.projectId ? `${baseUrl}/projects/${first.projectId}` : teamUrl
htmlRows.push(
`
<div style="padding: 16px 0; border-bottom: 1px solid #f3f4f6;">
<table cellpadding="0" cellspacing="0" border="0" style="width: 100%;">
<tr>
<td style="vertical-align: top; width: 44px; padding-right: 12px;">
${avatarHtml}
</td>
<td style="vertical-align: top;">
<div style="font-weight: 600; font-size: 14px; color: #111827;">${escapeHtml(summaryHeadline)}</div>
${timeStr ? `<div style="font-size: 12px; color: #6b7280; margin-top: 2px;">Latest activity: ${escapeHtml(timeStr)}</div>` : ''}
<div style="margin-top: 8px;">
<a href="${targetUrl}" style="display: inline-block; font-size: 12px; font-weight: 500; color: #4f46e5; text-decoration: none;">View Project &rarr;</a>
</div>
</td>
</tr>
</table>
</div>
`.trim(),
)
textRows.push(
`- ${summaryHeadline}${timeStr ? ` (Latest: ${timeStr})` : ''}\n Link: ${targetUrl}`,
)
}
}
const html = `
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>${escapeHtml(subject)}</title>
<style>
body { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif; background-color: #f9fafb; margin: 0; padding: 24px; color: #111827; }
.container { max-width: 600px; margin: 0 auto; background: #ffffff; border-radius: 8px; border: 1px solid #e5e7eb; padding: 32px; }
.header { font-size: 18px; font-weight: 700; color: #111827; }
.subtitle { font-size: 14px; color: #6b7280; margin-top: 4px; margin-bottom: 20px; }
.btn { display: inline-block; background-color: #4f46e5; color: #ffffff !important; padding: 10px 20px; border-radius: 6px; text-decoration: none; font-size: 14px; font-weight: 500; margin-top: 20px; }
.footer { font-size: 12px; color: #9ca3af; border-top: 1px solid #f3f4f6; padding-top: 16px; margin-top: 24px; }
</style>
</head>
<body>
<div class="container">
<div class="header">Shumai Notifications</div>
<div class="subtitle">You have ${ctx.items.length} new update${ctx.items.length > 1 ? 's' : ''}:</div>
<div>
${htmlRows.join('\n')}
</div>
<div style="text-align: center; margin-top: 20px;">
<a href="${teamUrl}" class="btn">Open Shumai</a>
</div>
<div class="footer">
Sent from <a href="${baseUrl}" style="color: #6366f1; text-decoration: none;">Shumai</a>
</div>
</div>
</body>
</html>
`.trim()
const text = `
Shumai Notifications
You have ${ctx.items.length} new update(s):
${textRows.join('\n\n')}
Open Shumai: ${teamUrl}
Sent from Shumai at ${baseUrl}
`.trim()
return { subject, html, text }
}
}
function getNotificationItemDetail(item: BatchedNotificationItem): {
headline: string
message?: string
} {
const actor = item.creatorName || 'Someone'
const asset = item.assetName ? `"${item.assetName}"` : 'an asset'
const task = item.kanbanTaskTitle ? `"${item.kanbanTaskTitle}"` : 'a task'
const project = item.projectName ? ` in ${item.projectName}` : ''
let commentMessage = item.commentMessage
if (commentMessage && item.mentionedUserNames) {
commentMessage = commentMessage.replace(/<@([^>]+)>/g, (match, uid) => {
const name = item.mentionedUserNames?.[uid]
return name ? `@${name}` : `@${uid}`
})
}
switch (item.type) {
case NotificationType.successful_file_uploaded:
return {
headline: `Uploaded ${asset}${item.projectName ? ` to ${item.projectName}` : ''}`,
}
case NotificationType.comment_created:
return {
headline: `Commented on ${asset}${project}`,
message: commentMessage,
}
case NotificationType.reply_created:
return {
headline: `Replied to your comment on ${asset}${project}`,
message: commentMessage,
}
case NotificationType.mention:
return {
headline: `Mentioned you on ${item.kanbanTaskTitle ? `task ${task}` : asset}${project}`,
message: commentMessage,
}
case NotificationType.metadata_field_updated_status:
return {
headline: `Updated status of ${asset}${project}`,
}
case NotificationType.kanban_task_created:
return {
headline: `Created task ${task}${project}`,
message: commentMessage,
}
case NotificationType.kanban_task_assigned:
return {
headline: `Assigned you to task ${task}${project}`,
}
case NotificationType.kanban_task_status_updated:
return {
headline: `Updated status of task ${task}${project}`,
message: commentMessage,
}
case NotificationType.kanban_task_updated:
return {
headline: `Updated task ${task}${project}`,
message: commentMessage,
}
case NotificationType.kanban_task_deleted:
return {
headline: `Deleted task ${task}${project}`,
}
case NotificationType.kanban_task_comment_created:
return {
headline: `Commented on task ${task}${project}`,
message: commentMessage,
}
case NotificationType.new_user_join_team:
return {
headline: `Joined the team ${item.teamName}`,
}
case NotificationType.new_user_join_project:
return {
headline: `Joined project ${item.projectName || 'a project'}`,
}
default:
return {
headline: `New activity from ${actor}`,
}
}
}
function getItemAction(
baseUrl: string,
item: BatchedNotificationItem,
): { url: string; text: string } {
if (item.projectId && item.assetId) {
return {
url: `${baseUrl}/projects/${item.projectId}/files/${item.assetId}`,
text: 'View Asset',
}
} else if (item.projectId) {
return {
url: `${baseUrl}/projects/${item.projectId}`,
text: 'View Project',
}
} else if (item.teamId && item.kanbanTaskId) {
return {
url: `${baseUrl}/teams/${item.teamId}/kanban?taskId=${item.kanbanTaskId}`,
text: 'View Task',
}
} else if (item.teamId) {
return {
url: `${baseUrl}/teams/${item.teamId}`,
text: 'Open Shumai',
}
}
return { url: baseUrl, text: 'Open Shumai' }
}
function renderAvatarHtml(actor: string, avatarUrl?: string): string {
const actorInitial = (actor.trim()[0] || 'U').toUpperCase()
if (avatarUrl) {
return `<img src="${escapeHtml(avatarUrl)}" alt="${escapeHtml(actor)}" width="36" height="36" style="width: 36px; height: 36px; border-radius: 50%; object-fit: cover; display: block; border: 1px solid #e5e7eb;" />`
}
return `<table cellpadding="0" cellspacing="0" border="0" style="width: 36px; height: 36px; border-radius: 50%; background-color: #4f46e5; text-align: center;"><tr><td style="color: #ffffff; font-weight: 600; font-size: 14px; text-align: center; vertical-align: middle;">${escapeHtml(actorInitial)}</td></tr></table>`
}
function formatUploadTime(time: string | Date | undefined): string | undefined {
if (!time) return undefined
if (time instanceof Date) {
if (isNaN(time.getTime())) return undefined
return (
new Intl.DateTimeFormat('en-US', {
month: 'short',
day: 'numeric',
year: 'numeric',
hour: 'numeric',
minute: '2-digit',
hour12: true,
timeZone: 'UTC',
}).format(time) + ' UTC'
)
}
const parsed = new Date(time)
if (!isNaN(parsed.getTime())) {
return (
new Intl.DateTimeFormat('en-US', {
month: 'short',
day: 'numeric',
year: 'numeric',
hour: 'numeric',
minute: '2-digit',
hour12: true,
timeZone: 'UTC',
}).format(parsed) + ' UTC'
)
}
return time
}
function escapeHtml(str: string): string {
return str
.replace(/&/g, '&amp;')
.replace(/</g, '&lt;')
.replace(/>/g, '&gt;')
.replace(/"/g, '&quot;')
.replace(/'/g, '&#039;')
}
export const emailService = new EmailService()
+3
View File
@@ -0,0 +1,3 @@
export * from './notification'
export * from './email'
export * from './notification-job'
@@ -0,0 +1,576 @@
import { describe, expect, it, vi, beforeEach, afterEach } from 'vitest'
import { prisma, NotificationType, NotificationEmailStatus } from '@shumai/db'
import { setupTestDbHooks } from '@shumai/db/test'
import { emailService, type EmailAttachment } from './email'
import { notificationJobService } from './notification-job'
import { userMetadataService } from '@shumai/core/src/user-metadata/user-metadata'
import { s3Service } from '@shumai/core/src/s3/s3'
import '@shumai/db/src/prisma-json-types'
describe('NotificationJobService', () => {
setupTestDbHooks()
let sendMailSpy: ReturnType<typeof vi.spyOn>
beforeEach(() => {
sendMailSpy = vi
.spyOn(emailService, 'sendMail')
.mockResolvedValue({ messageId: '<mock-id@shumai.test>' })
})
afterEach(() => {
sendMailSpy.mockRestore()
notificationJobService.stop()
})
async function createTeamWithEmail(name = 'Email Team') {
return prisma.team.create({
data: {
name,
settings: {
emailNotification: {
enabled: true,
host: 'smtp.test.com',
port: 587,
username: 'user',
password: 'pw',
smtps: false,
ignoreCert: false,
from: 'noreply@test.com',
},
},
},
})
}
it('picks up pending notifications, sends batched email, and marks them processed', async () => {
const team = await createTeamWithEmail()
const sender = await prisma.user.create({
data: { name: 'Alice', email: 'alice@test.com', password: 'p' },
})
const recipient = await prisma.user.create({
data: { name: 'Bob', email: 'bob@test.com', password: 'p' },
})
await prisma.teamMember.create({
data: { teamId: team.id, userId: recipient.id, role: 'editor' },
})
const project = await prisma.project.create({
data: { name: 'Alpha Project', teamId: team.id },
})
const asset = await prisma.asset.create({
data: {
name: 'design.png',
type: 'file',
status: 'uploaded',
project: { connect: { id: project.id } },
},
})
// Create 2 pending notifications
const n1 = await prisma.notification.create({
data: {
type: NotificationType.successful_file_uploaded,
teamId: team.id,
projectId: project.id,
assetId: asset.id,
creatorId: sender.id,
emailStatus: NotificationEmailStatus.pending,
},
})
const n2 = await prisma.notification.create({
data: {
type: NotificationType.comment_created,
teamId: team.id,
projectId: project.id,
assetId: asset.id,
creatorId: sender.id,
emailStatus: NotificationEmailStatus.pending,
},
})
const processedCount = await notificationJobService.processPendingNotifications(500)
expect(processedCount).toBe(2)
// Verify Bob received exactly 1 batched email containing both items
expect(sendMailSpy).toHaveBeenCalledTimes(1)
expect(sendMailSpy).toHaveBeenCalledWith(
expect.objectContaining({ host: 'smtp.test.com' }),
expect.objectContaining({
to: 'bob@test.com',
subject: '[Shumai] 2 new notifications',
}),
)
// Verify notifications are marked processed in DB
const updated1 = await prisma.notification.findUnique({ where: { id: n1.id } })
const updated2 = await prisma.notification.findUnique({ where: { id: n2.id } })
expect(updated1?.emailStatus).toBe(NotificationEmailStatus.processed)
expect(updated2?.emailStatus).toBe(NotificationEmailStatus.processed)
})
it('skips already processed notifications', async () => {
const team = await createTeamWithEmail()
const sender = await prisma.user.create({
data: { name: 'Alice', email: 'alice2@test.com', password: 'p' },
})
await prisma.notification.create({
data: {
type: NotificationType.comment_created,
teamId: team.id,
creatorId: sender.id,
emailStatus: NotificationEmailStatus.processed,
},
})
const processedCount = await notificationJobService.processPendingNotifications(500)
expect(processedCount).toBe(0)
expect(sendMailSpy).not.toHaveBeenCalled()
})
it('marks notifications processed without sending email if team SMTP is disabled', async () => {
// Team without emailNotification configured
const team = await prisma.team.create({
data: { name: 'No Email Team' },
})
const sender = await prisma.user.create({
data: { name: 'Alice', email: 'alice3@test.com', password: 'p' },
})
const notif = await prisma.notification.create({
data: {
type: NotificationType.new_user_join_team,
teamId: team.id,
creatorId: sender.id,
emailStatus: NotificationEmailStatus.pending,
},
})
const processedCount = await notificationJobService.processPendingNotifications(500)
expect(processedCount).toBe(1)
expect(sendMailSpy).not.toHaveBeenCalled()
const updated = await prisma.notification.findUnique({ where: { id: notif.id } })
expect(updated?.emailStatus).toBe(NotificationEmailStatus.processed)
})
it('excludes the actor from receiving notification about their own action', async () => {
const team = await createTeamWithEmail()
const alice = await prisma.user.create({
data: { name: 'Alice', email: 'alice-self@test.com', password: 'p' },
})
await prisma.teamMember.create({
data: { teamId: team.id, userId: alice.id, role: 'editor' },
})
// Alice is the creator and only member
await prisma.notification.create({
data: {
type: NotificationType.comment_created,
teamId: team.id,
creatorId: alice.id,
emailStatus: NotificationEmailStatus.pending,
},
})
await notificationJobService.processPendingNotifications(500)
// Alice should not receive an email for her own comment
expect(sendMailSpy).not.toHaveBeenCalled()
})
it('excludes AI agent users from receiving email notifications', async () => {
const team = await createTeamWithEmail()
const sender = await prisma.user.create({
data: { name: 'Alice', email: 'alice-agent-test@test.com', password: 'p' },
})
const agentUser = await prisma.user.create({
data: {
name: 'AutoAgent',
email: 'agent-bot@shumai.ai',
password: 'p',
type: 'agent',
},
})
await prisma.teamMember.create({
data: { teamId: team.id, userId: agentUser.id, role: 'editor' },
})
await prisma.notification.create({
data: {
type: NotificationType.new_user_join_team,
teamId: team.id,
creatorId: sender.id,
emailStatus: NotificationEmailStatus.pending,
},
})
await notificationJobService.processPendingNotifications(500)
expect(sendMailSpy).not.toHaveBeenCalled()
})
it('respects user notification preferences', async () => {
const team = await createTeamWithEmail()
const sender = await prisma.user.create({
data: { name: 'Alice', email: 'alice-pref@test.com', password: 'p' },
})
const bob = await prisma.user.create({
data: { name: 'Bob', email: 'bob-pref@test.com', password: 'p' },
})
await prisma.teamMember.create({
data: { teamId: team.id, userId: bob.id, role: 'editor' },
})
// Bob disabled comments in his notification settings
await userMetadataService.upsertMetadata(bob.id, team.id, 'notification_settings', {
comments: false,
replies: true,
mentions: true,
yourUploads: false,
otherUploads: true,
statusUpdates: true,
kanbanTasks: true,
kanbanComments: true,
})
await prisma.notification.create({
data: {
type: NotificationType.comment_created,
teamId: team.id,
creatorId: sender.id,
emailStatus: NotificationEmailStatus.pending,
},
})
await notificationJobService.processPendingNotifications(500)
expect(sendMailSpy).not.toHaveBeenCalled()
})
it('filters notifications by project scope for project-scoped members', async () => {
const team = await createTeamWithEmail()
const sender = await prisma.user.create({
data: { name: 'Alice', email: 'alice-scope@test.com', password: 'p' },
})
const project1 = await prisma.project.create({
data: { name: 'Project 1', teamId: team.id },
})
const project2 = await prisma.project.create({
data: { name: 'Project 2', teamId: team.id },
})
const bob = await prisma.user.create({
data: { name: 'Bob', email: 'bob-scope@test.com', password: 'p' },
})
const bobMember = await prisma.teamMember.create({
data: { teamId: team.id, userId: bob.id, role: 'editor', scope: 'project' },
})
// Bob only belongs to Project 1
await prisma.projectMember.create({
data: { projectId: project1.id, teamMemberId: bobMember.id, role: 'editor' },
})
// Notification in Project 2
await prisma.notification.create({
data: {
type: NotificationType.successful_file_uploaded,
teamId: team.id,
projectId: project2.id,
creatorId: sender.id,
emailStatus: NotificationEmailStatus.pending,
},
})
await notificationJobService.processPendingNotifications(500)
// Bob should not receive notification for Project 2
expect(sendMailSpy).not.toHaveBeenCalled()
})
it('batches 5 uploads and 1 comment into 1 email with collapsed upload summary', async () => {
const team = await createTeamWithEmail()
const sender = await prisma.user.create({
data: { name: 'UserB', email: 'userb@test.com', password: 'p' },
})
const recipient = await prisma.user.create({
data: { name: 'Recipient', email: 'recip@test.com', password: 'p' },
})
await prisma.teamMember.create({
data: { teamId: team.id, userId: recipient.id, role: 'editor' },
})
const project = await prisma.project.create({
data: { name: 'Project Alpha', teamId: team.id },
})
// 5 uploads by UserB in Project Alpha
for (let i = 0; i < 5; i++) {
const asset = await prisma.asset.create({
data: {
name: `img_${i}.png`,
type: 'file',
status: 'uploaded',
project: { connect: { id: project.id } },
},
})
await prisma.notification.create({
data: {
type: NotificationType.successful_file_uploaded,
teamId: team.id,
projectId: project.id,
assetId: asset.id,
creatorId: sender.id,
emailStatus: NotificationEmailStatus.pending,
},
})
}
// 1 comment by UserB
await prisma.notification.create({
data: {
type: NotificationType.comment_created,
teamId: team.id,
projectId: project.id,
creatorId: sender.id,
emailStatus: NotificationEmailStatus.pending,
},
})
const count = await notificationJobService.processPendingNotifications(500)
expect(count).toBe(6)
// Recipient receives exactly 1 email containing all 6 events
expect(sendMailSpy).toHaveBeenCalledTimes(1)
const call = sendMailSpy.mock.calls[0]
expect(call[1].to).toBe('recip@test.com')
expect(call[1].subject).toBe('[Shumai] 6 new notifications')
// Uploads collapsed into 1 row because count > 3
expect(call[1].html).toContain('UserB uploaded 5 assets to Project Alpha')
// Comment rendered as individual row
expect(call[1].html).toContain('Commented on')
})
it('embeds creator avatar and asset thumbnail as inline cid attachments', async () => {
const team = await createTeamWithEmail()
const sender = await prisma.user.create({
data: {
name: 'Alice Artist',
email: 'alice.artist@test.com',
password: 'p',
image: 'avatars/alice.png',
},
})
const recipient = await prisma.user.create({
data: { name: 'Bob Reviewer', email: 'bob.reviewer@test.com', password: 'p' },
})
await prisma.teamMember.create({
data: { teamId: team.id, userId: recipient.id, role: 'editor' },
})
const project = await prisma.project.create({
data: { name: 'Artwork Project', teamId: team.id },
})
const asset = await prisma.asset.create({
data: {
name: 'poster.png',
type: 'file',
status: 'uploaded',
project: { connect: { id: project.id } },
media: {
thumbnail: { key: 'thumbnails/poster.jpg' },
} as unknown as PrismaJson.MediaInfo,
},
})
await prisma.notification.create({
data: {
type: NotificationType.successful_file_uploaded,
teamId: team.id,
projectId: project.id,
assetId: asset.id,
creatorId: sender.id,
emailStatus: NotificationEmailStatus.pending,
},
})
const getObjectSpy = vi
.spyOn(s3Service, 'getObject')
.mockImplementation(async (_bucket, key) => {
if (key === 'avatars/alice.png') {
return { buffer: Buffer.from('alice-avatar-bytes'), contentType: 'image/png' }
}
if (key === 'thumbnails/poster.jpg') {
return { buffer: Buffer.from('poster-thumb-bytes'), contentType: 'image/jpeg' }
}
throw new Error('Not found')
})
try {
const count = await notificationJobService.processPendingNotifications(500)
expect(count).toBe(1)
expect(sendMailSpy).toHaveBeenCalledTimes(1)
const call = sendMailSpy.mock.calls[0]
const options = call[1]
expect(options.to).toBe('bob.reviewer@test.com')
// Check attachments
expect(options.attachments).toHaveLength(2)
const avatarAtt = options.attachments.find((a: EmailAttachment) =>
a.cid?.startsWith('avatar-'),
)
const thumbAtt = options.attachments.find((a: EmailAttachment) => a.cid?.startsWith('thumb-'))
expect(avatarAtt).toBeDefined()
expect(avatarAtt.content).toEqual(Buffer.from('alice-avatar-bytes'))
expect(avatarAtt.cid).toBe(`avatar-${sender.id}@shumai.internal`)
expect(thumbAtt).toBeDefined()
expect(thumbAtt.content).toEqual(Buffer.from('poster-thumb-bytes'))
expect(thumbAtt.cid).toBe(`thumb-${asset.id}@shumai.internal`)
// Check HTML references the exact cid
expect(options.html).toContain(`src="cid:${avatarAtt.cid}"`)
expect(options.html).toContain(`src="cid:${thumbAtt.cid}"`)
} finally {
getObjectSpy.mockRestore()
}
})
it('omits thumbnail attachments when cluster has count > 3', async () => {
const team = await createTeamWithEmail()
const sender = await prisma.user.create({
data: {
name: 'Bulk Uploader',
email: 'bulk@test.com',
password: 'p',
image: 'avatars/bulk.png',
},
})
const recipient = await prisma.user.create({
data: { name: 'Recipient', email: 'bulk-recip@test.com', password: 'p' },
})
await prisma.teamMember.create({
data: { teamId: team.id, userId: recipient.id, role: 'editor' },
})
const project = await prisma.project.create({
data: { name: 'Bulk Project', teamId: team.id },
})
for (let i = 0; i < 4; i++) {
const asset = await prisma.asset.create({
data: {
name: `bulk_${i}.png`,
type: 'file',
status: 'uploaded',
project: { connect: { id: project.id } },
media: {
thumbnail: { key: `thumbnails/bulk_${i}.jpg` },
} as unknown as PrismaJson.MediaInfo,
},
})
await prisma.notification.create({
data: {
type: NotificationType.successful_file_uploaded,
teamId: team.id,
projectId: project.id,
assetId: asset.id,
creatorId: sender.id,
emailStatus: NotificationEmailStatus.pending,
},
})
}
const getObjectSpy = vi
.spyOn(s3Service, 'getObject')
.mockImplementation(async (_bucket, key) => {
if (key === 'avatars/bulk.png') {
return { buffer: Buffer.from('bulk-avatar-bytes'), contentType: 'image/png' }
}
return { buffer: Buffer.from('thumb-bytes'), contentType: 'image/jpeg' }
})
try {
const count = await notificationJobService.processPendingNotifications(500)
expect(count).toBe(4)
expect(sendMailSpy).toHaveBeenCalledTimes(1)
const options = sendMailSpy.mock.calls[0][1]
// Count > 3, so only avatar attachment is included, NO thumbnail attachments!
expect(options.attachments).toHaveLength(1)
expect(options.attachments[0].cid).toBe(`avatar-${sender.id}@shumai.internal`)
expect(options.html).toContain(`src="cid:avatar-${sender.id}@shumai.internal"`)
expect(options.html).not.toContain('src="cid:thumb-')
} finally {
getObjectSpy.mockRestore()
}
})
it('gracefully handles missing images or S3 failure with fallback badge', async () => {
const team = await createTeamWithEmail()
const sender = await prisma.user.create({
data: {
name: 'Broken Image User',
email: 'broken@test.com',
password: 'p',
image: 'avatars/non-existent.png',
},
})
const recipient = await prisma.user.create({
data: { name: 'Recipient', email: 'broken-recip@test.com', password: 'p' },
})
await prisma.teamMember.create({
data: { teamId: team.id, userId: recipient.id, role: 'editor' },
})
const project = await prisma.project.create({
data: { name: 'Project', teamId: team.id },
})
const asset = await prisma.asset.create({
data: {
name: 'broken.png',
type: 'file',
status: 'uploaded',
project: { connect: { id: project.id } },
media: {
thumbnail: { key: 'thumbnails/missing.jpg' },
} as unknown as PrismaJson.MediaInfo,
},
})
await prisma.notification.create({
data: {
type: NotificationType.successful_file_uploaded,
teamId: team.id,
projectId: project.id,
assetId: asset.id,
creatorId: sender.id,
emailStatus: NotificationEmailStatus.pending,
},
})
const getObjectSpy = vi.spyOn(s3Service, 'getObject').mockRejectedValue(new Error('S3 error'))
try {
const count = await notificationJobService.processPendingNotifications(500)
expect(count).toBe(1)
expect(sendMailSpy).toHaveBeenCalledTimes(1)
const options = sendMailSpy.mock.calls[0][1]
// No attachments because both avatar and thumb failed to load
expect(options.attachments).toBeUndefined()
// HTML falls back to letter badge "B" for "Broken Image User"
expect(options.html).toContain('>B</td>')
expect(options.html).not.toContain('<img')
} finally {
getObjectSpy.mockRestore()
}
})
it('starts and stops gracefully', () => {
expect(() => {
notificationJobService.start(100000, 100000)
notificationJobService.stop()
}).not.toThrow()
})
})
@@ -0,0 +1,496 @@
import { prisma, NotificationType, NotificationEmailStatus } from '@shumai/db'
import { emailService, getNotificationBatchGroupKey } from '@shumai/core/src/notification/email'
import type { BatchedNotificationItem, EmailAttachment } from '@shumai/core/src/notification/email'
import { userMetadataService } from '@shumai/core/src/user-metadata/user-metadata'
import { s3Service } from '@shumai/core/src/s3/s3'
import { logger } from '@shumai/core/src/logger'
import type { NotificationSettings } from '@shumai/dtos'
import '@shumai/db/src/prisma-json-types'
function getExtensionFromMime(mime?: string): string {
if (!mime) return 'jpg'
if (mime.includes('png')) return 'png'
if (mime.includes('webp')) return 'webp'
if (mime.includes('gif')) return 'gif'
if (mime.includes('svg')) return 'svg'
return 'jpg'
}
export class NotificationJobService {
private isRunning = false
private timer: NodeJS.Timeout | null = null
private isProcessing = false
start(initialDelayMs = 5000, intervalMs = 3 * 60 * 1000): void {
if (this.isRunning) return
this.isRunning = true
logger.info('Starting notification email background job')
const run = async () => {
if (!this.isRunning) return
try {
await this.processPendingNotifications()
} catch (err) {
logger.error(
{ err: err instanceof Error ? err.message : String(err) },
'Error in notification email background job',
)
}
if (this.isRunning) {
this.timer = setTimeout(run, intervalMs)
}
}
this.timer = setTimeout(run, initialDelayMs)
}
stop(): void {
this.isRunning = false
if (this.timer) {
clearTimeout(this.timer)
this.timer = null
}
logger.info('Stopped notification email background job')
}
async processPendingNotifications(limit = 500): Promise<number> {
if (this.isProcessing) {
logger.debug('Notification job turn already in progress, skipping')
return 0
}
this.isProcessing = true
let batchIds: string[] = []
try {
// 1. Concurrency control: atomically lock up to limit pending notifications
const locked = await prisma.$queryRaw<{ id: string }[]>`
WITH candidates AS (
SELECT id
FROM notifications
WHERE email_status = 'pending'::"NotificationEmailStatus"
ORDER BY id ASC
LIMIT ${limit}
FOR UPDATE SKIP LOCKED
)
UPDATE notifications
SET email_status = 'processing'::"NotificationEmailStatus", updated_at = NOW()
FROM candidates
WHERE notifications.id = candidates.id
RETURNING notifications.id;
`
if (!locked || locked.length === 0) {
return 0
}
batchIds = locked.map((r) => r.id)
logger.info({ count: batchIds.length }, 'Picked up pending notifications for processing')
// 2. Fetch full records with relations
const notifications = await prisma.notification.findMany({
where: { id: { in: batchIds } },
include: {
creator: { select: { id: true, name: true, image: true, type: true } },
team: { select: { id: true, name: true } },
project: { select: { id: true, name: true } },
asset: {
select: {
id: true,
name: true,
media: true,
projectId: true,
createdAt: true,
project: { select: { id: true, name: true } },
},
},
user: { select: { id: true, name: true, email: true, type: true } },
kanbanTask: { select: { id: true, title: true, projectId: true } },
},
orderBy: { id: 'asc' },
})
// 3. Group notifications by teamId
const byTeam = new Map<string, typeof notifications>()
for (const n of notifications) {
const list = byTeam.get(n.teamId)
if (list) {
list.push(n)
} else {
byTeam.set(n.teamId, [n])
}
}
// 4. Process each team
for (const [teamId, teamNotifs] of byTeam) {
const emailSettings = await emailService.getEmailSettings(teamId)
if (!emailSettings.enabled || !emailSettings.host || !emailSettings.from) {
logger.debug(
{ teamId },
'Team email notifications disabled or unconfigured, skipping delivery',
)
continue
}
// Fetch team members excluding AI agents
const members = await prisma.teamMember.findMany({
where: {
teamId,
user: {
type: { not: 'agent' },
agent: null,
},
},
include: {
user: { select: { id: true, name: true, email: true, type: true } },
projectMembers: { select: { projectId: true } },
},
})
const avatarCache = new Map<
string,
{ cidUrl: string; attachment: EmailAttachment } | null
>()
const thumbCache = new Map<string, { cidUrl: string; attachment: EmailAttachment } | null>()
const cidAttachmentMap = new Map<string, EmailAttachment>()
const resolveAvatar = async (
creatorId?: string | null,
image?: string | null,
): Promise<string | undefined> => {
if (!image) return undefined
if (creatorId && avatarCache.has(creatorId)) {
const cached = avatarCache.get(creatorId)
return cached ? cached.cidUrl : undefined
}
const cid = `avatar-${creatorId || Math.random().toString(36).slice(2)}@shumai.internal`
const cidUrl = `cid:${cid}`
try {
if (image.startsWith('http://') || image.startsWith('https://')) {
const res = await fetch(image, { signal: AbortSignal.timeout(5000) })
if (res.ok) {
const arrayBuffer = await res.arrayBuffer()
const buffer = Buffer.from(arrayBuffer)
const contentType = res.headers.get('content-type') || 'image/jpeg'
const ext = getExtensionFromMime(contentType)
const resolved = {
cidUrl,
attachment: {
filename: `avatar-${creatorId || 'user'}.${ext}`,
content: buffer,
cid,
contentType,
},
}
if (creatorId) avatarCache.set(creatorId, resolved)
cidAttachmentMap.set(cidUrl, resolved.attachment)
return cidUrl
}
} else {
const bucket = process.env.S3_BUCKET || 'shumai'
const obj = await s3Service.getObject(bucket, image)
if (obj && obj.buffer && obj.buffer.length > 0) {
const contentType = obj.contentType || 'image/jpeg'
const ext = getExtensionFromMime(contentType)
const resolved = {
cidUrl,
attachment: {
filename: `avatar-${creatorId || 'user'}.${ext}`,
content: obj.buffer,
cid,
contentType,
},
}
if (creatorId) avatarCache.set(creatorId, resolved)
cidAttachmentMap.set(cidUrl, resolved.attachment)
return cidUrl
}
}
} catch (err) {
logger.debug(
{ err: err instanceof Error ? err.message : String(err), image, creatorId },
'Failed to resolve avatar image for inline email attachment',
)
}
if (creatorId) avatarCache.set(creatorId, null)
return undefined
}
const resolveThumbnail = async (
assetId?: string | null,
media?: unknown,
): Promise<string | undefined> => {
if (!assetId || !media) return undefined
if (thumbCache.has(assetId)) {
const cached = thumbCache.get(assetId)
return cached ? cached.cidUrl : undefined
}
const m = media as PrismaJson.MediaInfo | null
const key = m?.thumbnail?.key || m?.poster?.key
if (!key) return undefined
const cid = `thumb-${assetId}@shumai.internal`
const cidUrl = `cid:${cid}`
try {
const bucket = process.env.S3_BUCKET || 'shumai'
const obj = await s3Service.getObject(bucket, key)
if (obj && obj.buffer && obj.buffer.length > 0) {
const contentType = obj.contentType || 'image/jpeg'
const ext = getExtensionFromMime(contentType)
const resolved = {
cidUrl,
attachment: {
filename: `thumb-${assetId}.${ext}`,
content: obj.buffer,
cid,
contentType,
},
}
thumbCache.set(assetId, resolved)
cidAttachmentMap.set(cidUrl, resolved.attachment)
return cidUrl
}
} catch (err) {
logger.debug(
{ err: err instanceof Error ? err.message : String(err), assetId, key },
'Failed to resolve thumbnail image for inline email attachment',
)
}
thumbCache.set(assetId, null)
return undefined
}
const userItemsMap = new Map<
string,
{ user: (typeof members)[0]['user']; items: BatchedNotificationItem[] }
>()
for (const member of members) {
if (!member.user.email) continue
if (
member.user.type === 'agent' ||
member.user.email.endsWith('@shumai.ai') ||
member.user.email.startsWith('agent-')
) {
continue
}
const settingsMeta = await userMetadataService.getMetadata(
member.userId,
teamId,
'notification_settings',
)
const settings: NotificationSettings = settingsMeta
? (settingsMeta.value as NotificationSettings)
: {
comments: true,
replies: true,
mentions: true,
yourUploads: false,
otherUploads: true,
statusUpdates: true,
kanbanTasks: true,
kanbanComments: true,
}
for (const n of teamNotifs) {
// Actor check (do not notify self unless it's their upload and yourUploads is enabled)
if (n.creatorId === member.userId) {
if (n.type !== NotificationType.successful_file_uploaded || !settings.yourUploads) {
continue
}
}
// Targeted notification check
if (n.userId && n.userId !== member.userId) {
continue
}
// Project scope check
if (member.scope === 'project' && n.projectId) {
if (n.type !== NotificationType.mention && n.userId !== member.userId) {
const inProject = member.projectMembers.some((pm) => pm.projectId === n.projectId)
if (!inProject) continue
}
}
// Settings preference check
let allowed = false
switch (n.type) {
case NotificationType.comment_created:
allowed = settings.comments ?? true
break
case NotificationType.reply_created:
allowed = settings.replies ?? true
break
case NotificationType.mention:
allowed = settings.mentions ?? true
break
case NotificationType.successful_file_uploaded:
allowed =
member.userId === n.creatorId
? (settings.yourUploads ?? false)
: (settings.otherUploads ?? true)
break
case NotificationType.metadata_field_updated_status:
allowed = settings.statusUpdates ?? true
break
case NotificationType.kanban_task_created:
case NotificationType.kanban_task_assigned:
case NotificationType.kanban_task_status_updated:
case NotificationType.kanban_task_updated:
case NotificationType.kanban_task_deleted:
allowed = settings.kanbanTasks ?? true
break
case NotificationType.kanban_task_comment_created:
allowed = settings.kanbanComments ?? true
break
case NotificationType.new_user_join_team:
case NotificationType.new_user_join_project:
allowed = true
break
default:
allowed = true
break
}
if (!allowed) continue
const creatorAvatarUrl = await resolveAvatar(n.creatorId, n.creator?.image)
const assetThumbnailUrl = await resolveThumbnail(n.assetId, n.asset?.media)
const item: BatchedNotificationItem = {
id: n.id,
type: n.type || NotificationType.successful_file_uploaded,
creatorName: n.creator?.name || 'Someone',
creatorAvatarUrl,
teamId: n.teamId,
teamName: n.team?.name || 'Team',
projectId: n.projectId || n.asset?.projectId || undefined,
projectName: n.project?.name || n.asset?.project?.name || undefined,
assetId: n.assetId || undefined,
assetName: n.asset?.name || undefined,
assetThumbnailUrl,
kanbanTaskId: n.kanbanTaskId || undefined,
kanbanTaskTitle: n.kanbanTask?.title || undefined,
uploadTime: n.asset?.createdAt || n.createdAt,
createdAt: n.createdAt,
}
let entry = userItemsMap.get(member.userId)
if (!entry) {
entry = { user: member.user, items: [] }
userItemsMap.set(member.userId, entry)
}
entry.items.push(item)
}
}
// Deliver batched email to each user with pending items
for (const [userId, { user, items }] of userItemsMap) {
if (items.length === 0 || !user.email) continue
try {
const rendered = emailService.renderBatchedNotificationEmail({
teamId,
teamName: teamNotifs[0].team?.name || 'Team',
recipientName: user.name || 'Member',
items,
})
// Collect attachments for this email based on rendered items
const attachmentsMap = new Map<string, EmailAttachment>()
// Group items exactly as renderBatchedNotificationEmail does
const groups = new Map<string, BatchedNotificationItem[]>()
for (const item of items) {
const key = getNotificationBatchGroupKey(item)
const list = groups.get(key)
if (list) {
list.push(item)
} else {
groups.set(key, [item])
}
}
for (const [, cluster] of groups) {
const first = cluster[0]
if (first.creatorAvatarUrl) {
const att = cidAttachmentMap.get(first.creatorAvatarUrl)
if (att?.cid) attachmentsMap.set(att.cid, att)
}
if (cluster.length <= 3) {
// Detailed rows: individual avatars and thumbnails are rendered
for (const item of cluster) {
if (item.creatorAvatarUrl) {
const att = cidAttachmentMap.get(item.creatorAvatarUrl)
if (att?.cid) attachmentsMap.set(att.cid, att)
}
if (item.assetThumbnailUrl) {
const att = cidAttachmentMap.get(item.assetThumbnailUrl)
if (att?.cid) attachmentsMap.set(att.cid, att)
}
}
}
// If cluster.length > 3, thumbnails are not rendered, so we do not attach them
}
const attachments = Array.from(attachmentsMap.values())
await emailService.sendMail(emailSettings, {
to: user.email,
subject: rendered.subject,
html: rendered.html,
text: rendered.text,
attachments: attachments.length > 0 ? attachments : undefined,
})
} catch (err) {
logger.error(
{
userId,
email: user.email,
err: err instanceof Error ? err.message : String(err),
},
'Failed to deliver batched notification email to user',
)
}
}
}
// 5. Update batch status to processed
await prisma.notification.updateMany({
where: { id: { in: batchIds } },
data: { emailStatus: NotificationEmailStatus.processed },
})
return batchIds.length
} catch (err) {
logger.error(
{ err: err instanceof Error ? err.message : String(err), batchCount: batchIds.length },
'Unexpected failure in processPendingNotifications',
)
if (batchIds.length > 0) {
// Mark as processed so subsequent turns aren't permanently blocked
await prisma.notification
.updateMany({
where: { id: { in: batchIds } },
data: { emailStatus: NotificationEmailStatus.processed },
})
.catch((cleanErr) =>
logger.error({ cleanErr }, 'Failed to mark notifications processed on error'),
)
}
throw err
} finally {
this.isProcessing = false
}
}
}
export const notificationJobService = new NotificationJobService()
+51 -2
View File
@@ -365,7 +365,15 @@ describe('TeamService', () => {
})
const settings = await teamService.getSettings(team.id)
expect(settings).toEqual({ semanticSearchEnabled: false, appearance: { hideAgent: false } })
expect(settings).toEqual({
semanticSearchEnabled: false,
transcode: {
videoStrategy: 'best_match',
hardwareAcceleration: 'off',
threads: 0,
},
appearance: { hideAgent: false },
})
await teamService.updateSettings(team.id, 'theme', 'dark')
@@ -373,6 +381,11 @@ describe('TeamService', () => {
expect(newSettings).toEqual({
theme: 'dark',
semanticSearchEnabled: false,
transcode: {
videoStrategy: 'best_match',
hardwareAcceleration: 'off',
threads: 0,
},
appearance: { hideAgent: false },
})
@@ -384,7 +397,11 @@ describe('TeamService', () => {
const finalSettings = await teamService.getSettings(team.id)
expect(finalSettings).toEqual({
theme: 'dark',
transcode: { videoStrategy: 'all', hardwareAcceleration: 'auto', threads: 4 },
transcode: {
videoStrategy: 'all',
hardwareAcceleration: 'auto',
threads: 4,
},
appearance: { hideAgent: true },
semanticSearchEnabled: false,
})
@@ -504,4 +521,36 @@ describe('TeamService', () => {
expect(result).toBe(false)
})
})
it('should not leak emailNotification or credentials in getSettings', async () => {
const team = await prisma.team.create({
data: {
name: 'Team With Credentials',
settings: {
transcode: {
videoStrategy: 'best_match',
hardwareAcceleration: 'off',
threads: 4,
},
appearance: {
hideAgent: true,
},
emailNotification: {
enabled: true,
host: 'smtp.secret.com',
port: 587,
password: 'super-secret-smtp-password',
from: 'noreply@secret.com',
},
},
},
})
const settings = await teamService.getSettings(team.id)
expect(settings).toBeDefined()
expect(settings.transcode?.threads).toBe(4)
expect(settings.appearance?.hideAgent).toBe(true)
expect((settings as Record<string, unknown>).emailNotification).toBeUndefined()
})
})
+20 -4
View File
@@ -33,7 +33,11 @@ export class TeamService {
data: {
name: 'Default Team',
settings: {
transcode: { videoStrategy: 'best_match', hardwareAcceleration: 'off', threads: 0 },
transcode: {
videoStrategy: 'best_match',
hardwareAcceleration: 'off',
threads: 0,
},
},
sandbox: { create: {} },
},
@@ -294,13 +298,25 @@ export class TeamService {
where: { id: teamId },
})
if (!team) throw new HTTPException(404, { message: 'team not found' })
const settings = (team.settings || {}) as TeamSettingsResponse
const rawSettings = { ...(team.settings || {}) } as PrismaJson.Settings & {
[key: string]: unknown
}
delete rawSettings.emailNotification
const settings = rawSettings as TeamSettingsResponse
const embeddingAgent = await prisma.agent.findFirst({
where: { teamId, type: 'embedding', enabled: true },
})
settings.semanticSearchEnabled = !!embeddingAgent
if (!settings.transcode) {
settings.transcode = {
videoStrategy: 'best_match',
hardwareAcceleration: 'off',
threads: 0,
}
}
if (!settings.appearance) {
settings.appearance = { hideAgent: false }
} else if (settings.appearance.hideAgent === undefined) {
@@ -348,12 +364,12 @@ export class TeamService {
settings[key] = value
}
const updated = await prisma.team.update({
await prisma.team.update({
where: { id: teamId },
data: { settings: settings as unknown as PrismaJson.Settings },
})
return (updated.settings || {}) as TeamSettingsResponse
return this.getSettings(teamId)
}
async getSandboxSettings(teamId: string): Promise<SandboxSettings> {
File diff suppressed because it is too large Load Diff
+733 -34
View File
@@ -13,6 +13,7 @@ import { ulid } from 'ulid'
import { promisify } from 'util'
import { mapConcurrent } from '../utils/async'
import { dataFormatNames } from './dataFormatNames'
import { logger } from '@shumai/core/src/logger'
const execFileAsync = promisify(execFile)
@@ -87,6 +88,15 @@ export function parseCsvContent(content: string): string[][] {
}
}
export type HdrType = 'pq' | 'hlg' | 'dovi_p5' | 'dovi_p8' | 'sdr'
export interface GeneratePosterOptions {
isHdr?: boolean
hdrType?: HdrType
colorTransfer?: string
signal?: AbortSignal
}
export interface MediaMetadata {
originalWidth: number
originalHeight: number
@@ -103,6 +113,14 @@ export interface MediaMetadata {
audioSampleRate?: number
audioBitDepth?: number
mimeType: string
colorTransfer?: string
colorPrimaries?: string
colorSpace?: string
isHdr?: boolean
hdrType?: HdrType
dvProfile?: number
dvCompatibilityId?: number
rotation?: number
}
export interface TranscodeVideoParams {
@@ -118,6 +136,12 @@ export interface TranscodeVideoParams {
sourceVideoBitrate?: number
threads?: number
signal?: AbortSignal
hdr?: boolean
sourceIsHdr?: boolean
sourceHdrType?: HdrType
sourceColorTransfer?: string
sourceColorPrimaries?: string
sourceColorSpace?: string
}
export interface EncoderConfig {
@@ -134,17 +158,21 @@ export const H264_ENCODER_CONFIGS: Record<string, EncoderConfig> = {
name: 'h264_qsv',
presetArgs: ['-preset', 'fast', '-global_quality', '26'],
},
h264_vaapi: {
name: 'h264_vaapi',
presetArgs: ['-compression_level', '4'],
},
h264_amf: {
name: 'h264_amf',
presetArgs: ['-quality', 'balanced', '-rc', 'qvbr', '-qvbr_quality_level', '26'],
},
h264_videotoolbox: {
name: 'h264_videotoolbox',
presetArgs: ['-q:v', '74'],
presetArgs: [],
},
libx264: {
name: 'libx264',
presetArgs: ['-preset', 'fast', '-crf', '26'],
presetArgs: ['-preset', 'fast', '-crf', '23', '-bf', '0'],
},
}
@@ -158,10 +186,53 @@ export function getPlatformEncoderCandidates(
return ['h264_nvenc', 'h264_qsv', 'h264_amf']
case 'linux':
default:
return ['h264_nvenc', 'h264_qsv', 'h264_amf']
return ['h264_nvenc', 'h264_vaapi', 'h264_qsv', 'h264_amf']
}
}
export function getVaapiDevice(driDir = '/dev/dri'): string | null {
const envDevice = process.env.SHUMAI_VAAPI_DEVICE || process.env.VAAPI_DEVICE
if (envDevice) {
return envDevice
}
try {
if (!fs.existsSync(driDir)) {
return null
}
const entries = fs.readdirSync(driDir)
const renderNodes = entries
.filter((entry) => entry.startsWith('renderD') || entry.startsWith('card'))
.sort((a, b) => b.localeCompare(a, undefined, { numeric: true }))
if (renderNodes.length > 0) {
return path.join(driDir, renderNodes[0])
}
} catch {
return null
}
return null
}
export function parseBitrateKbps(bitrate: string | number): number {
if (typeof bitrate === 'number') {
return Math.round(bitrate / 1000)
}
const clean = bitrate.trim().toLowerCase()
if (clean.endsWith('m') || clean.endsWith('mbps')) {
return Math.round(parseFloat(clean) * 1000)
}
if (clean.endsWith('k') || clean.endsWith('kbps')) {
return Math.round(parseFloat(clean))
}
const num = parseFloat(clean)
if (Number.isFinite(num)) {
return num > 100_000 ? Math.round(num / 1000) : Math.round(num)
}
return 2500
}
export function getDefaultBitrateBps(height: number, width?: number): number {
const longSide = Math.max(width || 0, height)
const shortSide = Math.min(width || height, height)
@@ -180,12 +251,12 @@ export function getDefaultBitrate(height: number, width?: number): string {
return `${Math.round(bps / 1000)}k`
}
export function calculateMaxBitrate(
export function calculateEffectiveBitrateBps(
targetHeight: number,
targetWidth?: number,
sourceVideoBitrate?: number,
targetFps?: number | string,
): { maxrate: string; bufsize: string } {
): number {
let configuredMaxBps = getDefaultBitrateBps(targetHeight, targetWidth)
// If frame rate is downsampled (e.g. 180p preview with < 24 fps), scale the bitrate ceiling proportionally
@@ -207,13 +278,27 @@ export function calculateMaxBitrate(
}
}
let effectiveMaxBps =
const effectiveMaxBps =
sourceVideoBitrate && sourceVideoBitrate > 0
? Math.min(configuredMaxBps, Math.round(sourceVideoBitrate * 1.2))
: configuredMaxBps
const minFloor = targetFps ? 50_000 : 100_000
effectiveMaxBps = Math.max(minFloor, effectiveMaxBps)
return Math.max(minFloor, effectiveMaxBps)
}
export function calculateMaxBitrate(
targetHeight: number,
targetWidth?: number,
sourceVideoBitrate?: number,
targetFps?: number | string,
): { maxrate: string; bufsize: string } {
const effectiveMaxBps = calculateEffectiveBitrateBps(
targetHeight,
targetWidth,
sourceVideoBitrate,
targetFps,
)
const maxrateKbps = Math.max(50, Math.round(effectiveMaxBps / 1000))
const bufsizeKbps = maxrateKbps * 2
@@ -224,6 +309,24 @@ export function calculateMaxBitrate(
}
}
export function buildSdrToneMapFilterChain(options: {
hdrType?: HdrType
availableFilters?: Set<string>
colorTransfer?: string
}): string {
if (options.availableFilters) {
if (!options.availableFilters.has('zscale') || !options.availableFilters.has('tonemap')) {
throw new Error('zscale and tonemap filters are required for HDR tone mapping')
}
}
const tin =
options.hdrType === 'hlg' || options.colorTransfer === 'arib-std-b67'
? 'arib-std-b67'
: 'smpte2084'
return `setparams=color_primaries=bt2020:color_trc=${tin}:colorspace=bt2020nc,zscale=tin=${tin}:pin=bt2020:min=bt2020nc:t=linear:npl=100,format=gbrpf32le,zscale=p=bt709,tonemap=tonemap=hable:desat=0:peak=100,zscale=t=bt709:m=bt709:out_range=full,format=yuv420p`
}
export interface ExtractVideoFramesParams {
inputFile: string
outputDir: string
@@ -432,9 +535,101 @@ export class TranscodeService {
}
}
const colorTransfer =
typeof videoStream.color_transfer === 'string'
? videoStream.color_transfer.toLowerCase()
: undefined
const colorPrimaries =
typeof videoStream.color_primaries === 'string'
? videoStream.color_primaries.toLowerCase()
: undefined
const colorSpace =
typeof videoStream.color_space === 'string'
? videoStream.color_space.toLowerCase()
: undefined
let dvProfile: number | undefined
let dvCompatibilityId: number | undefined
if (Array.isArray(videoStream.side_data_list)) {
const dovi = videoStream.side_data_list.find(
(sd: unknown): sd is Record<string, unknown> =>
typeof (sd as Record<string, unknown>)?.side_data_type === 'string' &&
String((sd as Record<string, unknown>).side_data_type)
.toLowerCase()
.includes('dovi'),
)
if (dovi) {
dvProfile = this.safeParseInt(dovi.dv_profile)
dvCompatibilityId = this.safeParseInt(dovi.dv_bl_signal_compatibility_id)
}
}
let isHdr: boolean
let hdrType: HdrType
if (dvProfile === 5) {
isHdr = true
hdrType = 'dovi_p5'
} else if (dvProfile !== undefined) {
if (colorTransfer === 'smpte2084') {
isHdr = true
hdrType = 'pq'
} else if (colorTransfer === 'arib-std-b67') {
isHdr = true
hdrType = 'hlg'
} else {
isHdr = false
hdrType = 'sdr'
}
} else {
if (colorTransfer === 'smpte2084') {
isHdr = true
hdrType = 'pq'
} else if (colorTransfer === 'arib-std-b67') {
isHdr = true
hdrType = 'hlg'
} else {
isHdr = false
hdrType = 'sdr'
}
}
let rotation = 0
if (Array.isArray(videoStream.side_data_list)) {
const displayMatrix = videoStream.side_data_list.find(
(sd: unknown): sd is Record<string, unknown> =>
typeof (sd as Record<string, unknown>)?.side_data_type === 'string' &&
String((sd as Record<string, unknown>).side_data_type).toLowerCase() === 'display matrix',
)
if (displayMatrix && typeof displayMatrix.rotation === 'number') {
rotation = displayMatrix.rotation
}
}
if (!rotation) {
const rotateTag = videoStream.tags?.rotate || info.format?.tags?.rotate
if (rotateTag) {
const parsed = parseFloat(rotateTag)
if (Number.isFinite(parsed)) {
rotation = parsed
}
}
}
const normalizedRotation = ((Math.round(rotation) % 360) + 360) % 360
const isRotatedVertical = normalizedRotation === 90 || normalizedRotation === 270
const rawWidth = typeof videoStream.width === 'number' ? videoStream.width : 0
const rawHeight = typeof videoStream.height === 'number' ? videoStream.height : 0
const originalWidth = isRotatedVertical ? rawHeight : rawWidth
const originalHeight = isRotatedVertical ? rawWidth : rawHeight
return {
originalWidth: videoStream.width,
originalHeight: videoStream.height,
originalWidth,
originalHeight,
rotation: rotation || undefined,
duration,
bitRate: parseFloat(info.format.bit_rate),
videoBitRate,
@@ -450,6 +645,13 @@ export class TranscodeService {
this.safeParseInt(audioStream?.bits_per_raw_sample) ??
this.safeParseInt(audioStream?.bits_per_sample),
mimeType: '',
colorTransfer,
colorPrimaries,
colorSpace,
isHdr,
hdrType,
dvProfile,
dvCompatibilityId,
}
}
@@ -512,9 +714,11 @@ export class TranscodeService {
}
private availableEncodersCache: Set<string> | null = null
private usableEncodersCache: Map<string, boolean> = new Map()
clearEncodersCache(): void {
this.availableEncodersCache = null
this.usableEncodersCache.clear()
}
async getAvailableEncoders(): Promise<Set<string>> {
@@ -539,6 +743,106 @@ export class TranscodeService {
}
}
private availableFiltersCache: Set<string> | null = null
clearFiltersCache(): void {
this.availableFiltersCache = null
}
async getAvailableFilters(): Promise<Set<string>> {
if (this.availableFiltersCache) {
return this.availableFiltersCache
}
try {
const { stdout } = await execFileAsync('ffmpeg', ['-filters'])
const filters = new Set<string>()
const lines = stdout.split('\n')
for (const line of lines) {
const match = line.match(/^\s*[A-Z.]{2,4}\s+([a-zA-Z0-9_-]+)/)
if (match) {
filters.add(match[1])
}
}
this.availableFiltersCache = filters
return filters
} catch (err) {
console.warn('Failed to probe ffmpeg filters:', err)
return new Set<string>()
}
}
getVaapiDevice(driDir = '/dev/dri'): string | null {
return getVaapiDevice(driDir)
}
async isEncoderUsable(encoder: string): Promise<boolean> {
const cached = this.usableEncodersCache.get(encoder)
if (cached !== undefined) {
return cached
}
if (encoder === 'h264_vaapi') {
const vaapiDevice = this.getVaapiDevice()
if (!vaapiDevice) {
this.usableEncodersCache.set(encoder, false)
return false
}
try {
await execFileAsync('ffmpeg', [
'-loglevel',
'error',
'-init_hw_device',
`vaapi=accel:${vaapiDevice}`,
'-filter_hw_device',
'accel',
'-f',
'lavfi',
'-i',
'color=c=black:s=256x256:d=0.04',
'-vf',
'format=nv12,hwupload',
'-frames:v',
'1',
'-c:v',
'h264_vaapi',
'-f',
'null',
'-',
])
this.usableEncodersCache.set(encoder, true)
return true
} catch (err) {
logger.debug({ encoder, err }, 'Encoder failed usability probe')
this.usableEncodersCache.set(encoder, false)
return false
}
}
try {
await execFileAsync('ffmpeg', [
'-loglevel',
'error',
'-f',
'lavfi',
'-i',
'color=c=black:s=256x256:d=0.04',
'-frames:v',
'1',
'-c:v',
encoder,
'-f',
'null',
'-',
])
this.usableEncodersCache.set(encoder, true)
return true
} catch (err) {
logger.debug({ encoder, err }, 'Encoder failed usability probe')
this.usableEncodersCache.set(encoder, false)
return false
}
}
async selectH264Encoder(
hardwareAcceleration?: 'off' | 'auto',
platform: NodeJS.Platform = process.platform,
@@ -551,6 +855,10 @@ export class TranscodeService {
const candidates = getPlatformEncoderCandidates(platform)
for (const enc of candidates) {
if (available.has(enc) && H264_ENCODER_CONFIGS[enc]) {
const usable = await this.isEncoderUsable(enc)
if (!usable) {
continue
}
return H264_ENCODER_CONFIGS[enc]
}
}
@@ -558,20 +866,105 @@ export class TranscodeService {
return H264_ENCODER_CONFIGS.libx264
}
private isAbortError(err: unknown, signal?: AbortSignal): boolean {
if (signal?.aborted) return true
if (err && typeof err === 'object') {
const r = err as Record<string, unknown>
if (r.name === 'AbortError' || r.code === 'ABORT_ERR') return true
const msg = typeof r.message === 'string' ? r.message.toLowerCase() : ''
if (msg.includes('abort')) return true
}
return false
}
async transcodeVideo(params: TranscodeVideoParams): Promise<void> {
const encoder = await this.selectH264Encoder(params.hardwareAcceleration)
if (encoder.name !== 'libx264') {
try {
await this.executeFfmpegVideoTranscode(params, encoder)
return
} catch (err) {
if (this.isAbortError(err, params.signal)) {
throw err
}
logger.warn(
{
err,
encoder: encoder.name,
inputFile: params.inputFile,
outputFile: params.outputFile,
width: params.width,
height: params.height,
},
'Hardware video transcoding failed; falling back to software transcode (libx264)',
)
if (fs.existsSync(params.outputFile)) {
try {
fs.unlinkSync(params.outputFile)
} catch {
// ignore unlink errors
}
}
await this.executeFfmpegVideoTranscode(params, H264_ENCODER_CONFIGS.libx264)
return
}
}
await this.executeFfmpegVideoTranscode(params, encoder)
}
private async executeFfmpegVideoTranscode(
params: TranscodeVideoParams,
encoder: EncoderConfig,
): Promise<void> {
const isSourceHdr =
params.sourceIsHdr ||
params.sourceHdrType === 'pq' ||
params.sourceHdrType === 'hlg' ||
params.sourceHdrType === 'dovi_p5'
const isHdrOutput = Boolean(params.hdr)
const isVaapi = encoder.name === 'h264_vaapi'
const vaapiDevice = isVaapi ? (this.getVaapiDevice() ?? '/dev/dri/renderD128') : undefined
logger.info(
{
encoder: encoder.name,
hardwareAcceleration: params.hardwareAcceleration ?? 'off',
inputFile: params.inputFile,
outputFile: params.outputFile,
vaapiDevice,
},
'Starting video transcoding',
)
let filterComplex: string
const args: string[] = ['-i', params.inputFile]
const args: string[] = []
if (isVaapi && vaapiDevice) {
args.push('-init_hw_device', `vaapi=accel:${vaapiDevice}`, '-filter_hw_device', 'accel')
}
args.push('-i', params.inputFile)
const baseScale = `scale=w=${params.width}:h=${params.height}:force_original_aspect_ratio=decrease,scale=w='trunc(iw/2)*2':h='trunc(ih/2)*2'`
if (params.overlayFile) {
args.push('-i', params.overlayFile)
filterComplex = `[0:v]scale=${params.width}:${params.height}[vscaled];[vscaled][1:v]overlay=0:0`
} else {
filterComplex = `[0:v]scale=w=${params.width}:h=${params.height}:force_original_aspect_ratio=decrease,scale=w='trunc(iw/2)*2':h='trunc(ih/2)*2'`
filterComplex = `[0:v]${baseScale}`
}
if (params.frameRate) {
filterComplex += `,fps=${params.frameRate}`
}
if (isVaapi) {
filterComplex += ',format=nv12,hwupload=extra_hw_frames=64'
}
filterComplex += '[vout]'
args.push('-filter_complex', filterComplex, '-map', '[vout]')
@@ -605,25 +998,75 @@ export class TranscodeService {
args.push('-map', '0:a?')
}
const encoder = await this.selectH264Encoder(params.hardwareAcceleration)
args.push('-c:v', encoder.name)
if (encoder.presetArgs.length > 0) {
args.push(...encoder.presetArgs)
}
if (params.videoBitrate) {
args.push('-b:v', params.videoBitrate)
} else {
const { maxrate, bufsize } = calculateMaxBitrate(
params.height,
params.width,
params.sourceVideoBitrate,
params.frameRate,
if (encoder.name === 'h264_videotoolbox') {
if (params.videoBitrate) {
args.push('-b:v', params.videoBitrate)
} else {
const targetBps = calculateEffectiveBitrateBps(
params.height,
params.width,
params.sourceVideoBitrate,
params.frameRate,
)
const targetKbps = Math.max(50, Math.round(targetBps / 1000))
args.push('-b:v', `${targetKbps}k`)
}
} else if (isVaapi) {
let maxKbps: number
if (params.videoBitrate) {
maxKbps = parseBitrateKbps(params.videoBitrate)
} else {
const { maxrate } = calculateMaxBitrate(
params.height,
params.width,
params.sourceVideoBitrate,
params.frameRate,
)
maxKbps = parseInt(maxrate, 10)
}
const targetKbps = Math.max(25, Math.ceil(maxKbps / 1.45))
const minKbps = Math.max(10, Math.round(targetKbps / 2))
args.push(
'-rc_mode',
'3',
'-b:v',
`${targetKbps}k`,
'-maxrate',
`${maxKbps}k`,
'-minrate',
`${minKbps}k`,
)
args.push('-maxrate', maxrate, '-bufsize', bufsize)
} else {
if (params.videoBitrate) {
args.push('-b:v', params.videoBitrate)
} else {
const { maxrate, bufsize } = calculateMaxBitrate(
params.height,
params.width,
params.sourceVideoBitrate,
params.frameRate,
)
args.push('-maxrate', maxrate, '-bufsize', bufsize)
}
}
args.push('-pix_fmt', 'yuv420p')
if (!isVaapi) {
args.push('-pix_fmt', 'yuv420p')
}
if (isSourceHdr && isHdrOutput) {
const isHlg = params.sourceHdrType === 'hlg' || params.sourceColorTransfer === 'arib-std-b67'
const trc = isHlg ? 'arib-std-b67' : 'smpte2084'
args.push('-color_primaries', 'bt2020', '-color_trc', trc, '-colorspace', 'bt2020nc')
if (encoder.name === 'libx264') {
args.push('-x264-params', `colorprim=bt2020:transfer=${trc}:colormatrix=bt2020nc`)
}
}
if (!params.disableAudio) {
args.push('-c:a', 'aac', '-b:a', '128k')
@@ -743,15 +1186,130 @@ export class TranscodeService {
await sharpInstance.webp({ quality }).toFile(outputFile)
}
async generatePoster(
inputFile: string,
outputPoster: string,
options: GeneratePosterOptions = {},
): Promise<void> {
const { isHdr, hdrType, colorTransfer, signal } = options
if (signal?.aborted) {
throw new Error('Poster generation cancelled')
}
const isRemote = inputFile.startsWith('http://') || inputFile.startsWith('https://')
let pathname = inputFile
if (isRemote) {
try {
pathname = new URL(inputFile).pathname
} catch {
pathname = inputFile.split('?')[0].split('#')[0]
}
}
const ext = path.extname(pathname).toLowerCase()
const isMpegTs = ext === '.ts' || ext === '.m2ts' || ext === '.mts'
const filters: string[] = [
'fps=12:start_time=0:eof_action=pass:round=down',
'thumbnail=12',
String.raw`select=gt(scene\,0.1)-eq(prev_selected_n\,n)+isnan(prev_selected_n)+gt(n\,20)`,
'trim=end_frame=2',
'reverse',
]
if (isHdr) {
const availableFilters = await this.getAvailableFilters()
const tonemap = buildSdrToneMapFilterChain({
hdrType,
colorTransfer,
availableFilters,
})
filters.push(tonemap)
}
filters.push('scale=-2:300:force_original_aspect_ratio=decrease')
const args = [
...(isRemote
? ['-reconnect', '1', '-reconnect_streamed', '1', '-reconnect_delay_max', '5']
: []),
...(isMpegTs ? [] : ['-skip_frame', 'nointra']),
'-i',
inputFile,
'-vf',
filters.join(','),
'-fps_mode',
'vfr',
'-frames:v',
'1',
'-update',
'1',
'-c:v',
'libwebp',
'-q:v',
'75',
outputPoster,
]
if (signal) {
await execFileAsync('ffmpeg', ['-y', '-loglevel', 'warning', ...args], { signal })
} else {
await execFileAsync('ffmpeg', ['-y', '-loglevel', 'warning', ...args])
}
}
async generateSprite(
inputFile: string,
outputSprite: string,
outputPoster: string,
duration: number,
signal?: AbortSignal,
hdrOptions?: { isHdr?: boolean; hdrType?: HdrType; colorTransfer?: string },
): Promise<void> {
if (signal?.aborted) {
throw new Error('Sprite generation cancelled')
}
// 1. Generate poster first (fast, smart frame selection)
await this.generatePoster(inputFile, outputPoster, { ...hdrOptions, signal })
// 2. Generate sprite
let fileSize = Infinity
try {
const stats = await fs.promises.stat(inputFile)
fileSize = stats.size
} catch {
// If stat fails (e.g. mocked in unit tests), fileSize remains Infinity
}
const isSmallAndShort = fileSize <= 50 * 1024 * 1024 && duration <= 30
if (isSmallAndShort) {
await this.generateSpriteSinglePass(inputFile, outputSprite, duration, signal, hdrOptions)
} else {
await this.generateSpriteSeekPool(inputFile, outputSprite, duration, signal, hdrOptions)
}
}
private async generateSpriteSinglePass(
inputFile: string,
outputSprite: string,
duration: number,
signal?: AbortSignal,
hdrOptions?: { isHdr?: boolean; hdrType?: HdrType; colorTransfer?: string },
): Promise<void> {
const spriteFps = 100 / duration
const filterComplex = `[0:v]fps=${spriteFps},scale=w=300:h=-2,tile=10x10[sprite_out];[0:v]scale=-2:300:force_original_aspect_ratio=decrease,select='eq(n\\,0)'[thumb_out]`
let filterComplex: string
if (hdrOptions?.isHdr) {
const availableFilters = await this.getAvailableFilters()
const tonemap = buildSdrToneMapFilterChain({
hdrType: hdrOptions.hdrType,
colorTransfer: hdrOptions.colorTransfer,
availableFilters,
})
filterComplex = `[0:v]${tonemap},fps=${spriteFps},scale=w=300:h=-2,tile=10x10[sprite_out]`
} else {
filterComplex = `[0:v]fps=${spriteFps},scale=w=300:h=-2,tile=10x10[sprite_out]`
}
const args = [
'-i',
@@ -767,17 +1325,6 @@ export class TranscodeService {
'-q:v',
'75',
outputSprite,
'-map',
'[thumb_out]',
'-c:v',
'libwebp',
'-q:v',
'75',
'-frames:v',
'1',
'-max_muxing_queue_size',
'1024',
outputPoster,
]
if (signal) {
await execFileAsync('ffmpeg', ['-y', '-loglevel', 'warning', ...args], { signal })
@@ -786,6 +1333,158 @@ export class TranscodeService {
}
}
private async generateSpriteSeekPool(
inputFile: string,
outputSprite: string,
duration: number,
signal?: AbortSignal,
hdrOptions?: { isHdr?: boolean; hdrType?: HdrType; colorTransfer?: string },
): Promise<void> {
if (signal?.aborted) {
throw new Error('Sprite generation cancelled')
}
let tonemapFilterChain = ''
if (hdrOptions?.isHdr) {
const availableFilters = await this.getAvailableFilters()
tonemapFilterChain = buildSdrToneMapFilterChain({
hdrType: hdrOptions.hdrType,
colorTransfer: hdrOptions.colorTransfer,
availableFilters,
})
}
// Extract 100 frames across duration using 4-worker concurrency pool
const tmpDir = this.createTempDir('sprite-pool-')
try {
const numFrames = 100
const tileX = 10
const tileY = 10
const timestamps = Array.from({ length: numFrames }, (_, i) => {
const rawTs = (i / (numFrames - 1)) * duration
return Math.min(rawTs, Math.max(0, duration - 0.1))
})
// For sprite tiles: scale to width 300 first, then apply HDR tonemapping if needed
const vfSprite = tonemapFilterChain ? `scale=300:-2,${tonemapFilterChain}` : 'scale=300:-2'
const concurrency = 4
const frameFiles: string[] = new Array(numFrames).fill('')
let nextIdx = 0
const worker = async () => {
while (true) {
if (signal?.aborted) {
throw new Error('Sprite generation cancelled')
}
const idx = nextIdx++
if (idx >= timestamps.length) break
const ts = timestamps[idx]
const framePath = path.join(tmpDir, `frame_${idx.toString().padStart(3, '0')}.webp`)
const args = [
'-ss',
ts.toFixed(3),
'-i',
inputFile,
'-vframes',
'1',
'-vf',
vfSprite,
'-c:v',
'libwebp',
'-q:v',
'75',
framePath,
]
try {
if (signal) {
await execFileAsync('ffmpeg', ['-y', '-loglevel', 'warning', ...args], { signal })
} else {
await execFileAsync('ffmpeg', ['-y', '-loglevel', 'warning', ...args])
}
if (fs.existsSync(framePath) && fs.statSync(framePath).size > 0) {
frameFiles[idx] = framePath
}
} catch (err) {
if (signal?.aborted) throw err
// If frame extraction fails, keep empty for resilient fallback
}
}
}
await Promise.all(Array.from({ length: concurrency }, () => worker()))
// Resilient fallback: ensure all 100 frames exist by filling any failed frame with adjacent frame
let lastValid = frameFiles.find((f) => f && fs.existsSync(f))
if (!lastValid) {
throw new Error(`Failed to extract any frames from ${inputFile}`)
}
for (let i = 0; i < numFrames; i++) {
if (!frameFiles[i] || !fs.existsSync(frameFiles[i])) {
const fallbackFile = path.join(tmpDir, `frame_${i.toString().padStart(3, '0')}.webp`)
fs.copyFileSync(lastValid, fallbackFile)
frameFiles[i] = fallbackFile
} else {
lastValid = frameFiles[i]
}
}
// 3. Composite 100 tiles into 10x10 sprite sheet with Sharp
if (signal?.aborted) {
throw new Error('Sprite generation cancelled')
}
const firstMeta = await sharp(frameFiles[0]).metadata()
const frameW = firstMeta.width || 300
const frameH = firstMeta.height || 168
const composites = frameFiles.map((file, i) => ({
input: file,
left: (i % tileX) * frameW,
top: Math.floor(i / tileX) * frameH,
}))
const toFilePromise = sharp({
create: {
width: frameW * tileX,
height: frameH * tileY,
channels: 4,
background: { r: 0, g: 0, b: 0, alpha: 1 },
},
})
.composite(composites)
.webp({ quality: 75 })
.toFile(outputSprite)
if (signal) {
await Promise.race([
toFilePromise,
new Promise<never>((_, reject) => {
if (signal.aborted) {
reject(new Error('Sprite generation cancelled'))
return
}
signal.addEventListener(
'abort',
() => reject(new Error('Sprite generation cancelled')),
{ once: true },
)
}),
])
} else {
await toFilePromise
}
if (signal?.aborted) {
throw new Error('Sprite generation cancelled')
}
} finally {
this.removeDir(tmpDir)
}
}
async generatePdfSprite(
inputFile: string,
outputSprite: string,
+36 -3
View File
@@ -67,15 +67,26 @@ describe('handleDaemonCommands', () => {
}
})
it('runs the runFn on normal startup', async () => {
it('runs the runFn on normal foreground startup without creating a PID file', async () => {
process.argv = ['node', 'script.js']
const runFn = vi.fn().mockResolvedValue(undefined)
await handleDaemonCommands(appName, runFn)
expect(runFn).toHaveBeenCalled()
expect(existsSync(pidFile)).toBe(true)
expect(readFileSync(pidFile, 'utf8').trim()).toBe(process.pid.toString())
expect(existsSync(pidFile)).toBe(false)
})
it('runs foreground startup even if a stale or conflicting PID file exists', async () => {
process.argv = ['node', 'script.js']
const runFn = vi.fn().mockResolvedValue(undefined)
mkdirSync(join(mockTempDir, '.shumai', 'pids'), { recursive: true })
writeFileSync(pidFile, '12345')
await handleDaemonCommands(appName, runFn)
expect(runFn).toHaveBeenCalled()
})
it('stops the process if stop command is passed', async () => {
@@ -122,4 +133,26 @@ describe('handleDaemonCommands', () => {
expect(spawn).toHaveBeenCalled()
expect(mockExit).toHaveBeenCalledWith(0)
})
it('runs and manages PID file when running as a daemonized child', async () => {
process.argv = ['node', 'script.js']
const originalEnv = process.env.SHUMAI_DAEMONIZED
process.env.SHUMAI_DAEMONIZED = 'true'
try {
const runFn = vi.fn().mockResolvedValue(undefined)
await handleDaemonCommands(appName, runFn)
expect(runFn).toHaveBeenCalled()
expect(existsSync(pidFile)).toBe(true)
expect(readFileSync(pidFile, 'utf8').trim()).toBe(process.pid.toString())
} finally {
if (originalEnv !== undefined) {
process.env.SHUMAI_DAEMONIZED = originalEnv
} else {
delete process.env.SHUMAI_DAEMONIZED
}
}
})
})
+19 -29
View File
@@ -17,6 +17,9 @@ const PID_DIR = join(SHUMAI_DIR, 'pids')
const LOG_DIR = join(SHUMAI_DIR, 'logs')
function isProcessRunning(pid: number): boolean {
if (pid <= 1) {
return false
}
try {
process.kill(pid, 0)
return true
@@ -35,7 +38,7 @@ async function stopProcess(appName: string, pidFile: string): Promise<boolean> {
}
const pid = parseInt(readFileSync(pidFile, 'utf8').trim(), 10)
if (isNaN(pid)) {
if (isNaN(pid) || pid <= 1) {
console.log(`Invalid PID found in ${pidFile}. Cleaning up file.`)
try {
unlinkSync(pidFile)
@@ -180,18 +183,25 @@ export async function handleDaemonCommands(
appName: string,
runFn: () => Promise<void>,
): Promise<void> {
const pidFile = join(PID_DIR, `${appName}.pid`)
const logFile = join(LOG_DIR, `${appName}.log`)
// Ensure directories exist
mkdirSync(PID_DIR, { recursive: true })
mkdirSync(LOG_DIR, { recursive: true })
const args = process.argv.slice(2)
const isStop = args.includes('stop')
const isRestart = args.includes('restart')
const isLogs = args.includes('logs')
const isDaemon = args.includes('-d') && process.env.SHUMAI_DAEMONIZED !== 'true'
const isDaemonizedChild = process.env.SHUMAI_DAEMONIZED === 'true'
// Normal foreground startup: do not create, check, or track PID files
if (!isStop && !isRestart && !isLogs && !isDaemon && !isDaemonizedChild) {
await runFn()
return
}
const pidFile = join(PID_DIR, `${appName}.pid`)
const logFile = join(LOG_DIR, `${appName}.log`)
// Ensure directories exist for daemon commands
mkdirSync(PID_DIR, { recursive: true })
mkdirSync(LOG_DIR, { recursive: true })
if (isStop) {
await stopProcess(appName, pidFile)
@@ -216,27 +226,7 @@ export async function handleDaemonCommands(
process.exit(0)
}
// Normal Startup logic: check if already running
if (existsSync(pidFile)) {
const pid = parseInt(readFileSync(pidFile, 'utf8').trim(), 10)
if (!isNaN(pid) && pid !== process.pid) {
if (isProcessRunning(pid)) {
console.error(
`${appName} is already running (PID: ${pid}). Use '${appName} stop' or '${appName} restart'.`,
)
process.exit(1)
} else {
// Process is dead, clean up PID file
try {
unlinkSync(pidFile)
} catch {
// Ignore
}
}
}
}
// Write the PID file
// Daemonized child startup (SHUMAI_DAEMONIZED === 'true')
writeFileSync(pidFile, process.pid.toString(), 'utf8')
const cleanPidFile = () => {
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@shumai/db",
"version": "0.4.7",
"version": "0.4.9",
"private": true,
"type": "module",
"main": "./src/index.ts",
@@ -0,0 +1,11 @@
-- CreateEnum
CREATE TYPE "NotificationEmailStatus" AS ENUM ('pending', 'processing', 'processed', 'failed');
-- AlterTable
ALTER TABLE "notifications" ADD COLUMN "email_status" "NotificationEmailStatus" NOT NULL DEFAULT 'pending';
-- Update legacy rows to processed
UPDATE "notifications" SET "email_status" = 'processed';
-- CreateIndex
CREATE INDEX "notifications_email_status_created_at_idx" ON "notifications"("email_status", "created_at");
+10
View File
@@ -76,6 +76,13 @@ enum NotificationType {
kanban_task_comment_created
}
enum NotificationEmailStatus {
pending
processing
processed
failed
}
enum ProjectMemberRole {
owner
editor
@@ -776,9 +783,12 @@ model Notification {
userId String? @map("user_id")
user User? @relation("UserToNotification", fields: [userId], references: [id])
emailStatus NotificationEmailStatus @default(pending) @map("email_status")
readByMembers TeamMember? @relation("TeamMemberToLastReadNotification")
@@index([kanbanTaskId])
@@index([emailStatus, createdAt])
@@map("notifications")
}
+34
View File
@@ -538,6 +538,13 @@ export type EnumNotificationTypeNullableFilter<$PrismaModel = never> = {
not?: Prisma.NestedEnumNotificationTypeNullableFilter<$PrismaModel> | $Enums.NotificationType | null
}
export type EnumNotificationEmailStatusFilter<$PrismaModel = never> = {
equals?: $Enums.NotificationEmailStatus | Prisma.EnumNotificationEmailStatusFieldRefInput<$PrismaModel>
in?: $Enums.NotificationEmailStatus[] | Prisma.ListEnumNotificationEmailStatusFieldRefInput<$PrismaModel>
notIn?: $Enums.NotificationEmailStatus[] | Prisma.ListEnumNotificationEmailStatusFieldRefInput<$PrismaModel>
not?: Prisma.NestedEnumNotificationEmailStatusFilter<$PrismaModel> | $Enums.NotificationEmailStatus
}
export type EnumNotificationTypeNullableWithAggregatesFilter<$PrismaModel = never> = {
equals?: $Enums.NotificationType | Prisma.EnumNotificationTypeFieldRefInput<$PrismaModel> | null
in?: $Enums.NotificationType[] | Prisma.ListEnumNotificationTypeFieldRefInput<$PrismaModel> | null
@@ -548,6 +555,16 @@ export type EnumNotificationTypeNullableWithAggregatesFilter<$PrismaModel = neve
_max?: Prisma.NestedEnumNotificationTypeNullableFilter<$PrismaModel>
}
export type EnumNotificationEmailStatusWithAggregatesFilter<$PrismaModel = never> = {
equals?: $Enums.NotificationEmailStatus | Prisma.EnumNotificationEmailStatusFieldRefInput<$PrismaModel>
in?: $Enums.NotificationEmailStatus[] | Prisma.ListEnumNotificationEmailStatusFieldRefInput<$PrismaModel>
notIn?: $Enums.NotificationEmailStatus[] | Prisma.ListEnumNotificationEmailStatusFieldRefInput<$PrismaModel>
not?: Prisma.NestedEnumNotificationEmailStatusWithAggregatesFilter<$PrismaModel> | $Enums.NotificationEmailStatus
_count?: Prisma.NestedIntFilter<$PrismaModel>
_min?: Prisma.NestedEnumNotificationEmailStatusFilter<$PrismaModel>
_max?: Prisma.NestedEnumNotificationEmailStatusFilter<$PrismaModel>
}
export type EnumTaskTypeNullableFilter<$PrismaModel = never> = {
equals?: $Enums.TaskType | Prisma.EnumTaskTypeFieldRefInput<$PrismaModel> | null
in?: $Enums.TaskType[] | Prisma.ListEnumTaskTypeFieldRefInput<$PrismaModel> | null
@@ -1367,6 +1384,13 @@ export type NestedEnumNotificationTypeNullableFilter<$PrismaModel = never> = {
not?: Prisma.NestedEnumNotificationTypeNullableFilter<$PrismaModel> | $Enums.NotificationType | null
}
export type NestedEnumNotificationEmailStatusFilter<$PrismaModel = never> = {
equals?: $Enums.NotificationEmailStatus | Prisma.EnumNotificationEmailStatusFieldRefInput<$PrismaModel>
in?: $Enums.NotificationEmailStatus[] | Prisma.ListEnumNotificationEmailStatusFieldRefInput<$PrismaModel>
notIn?: $Enums.NotificationEmailStatus[] | Prisma.ListEnumNotificationEmailStatusFieldRefInput<$PrismaModel>
not?: Prisma.NestedEnumNotificationEmailStatusFilter<$PrismaModel> | $Enums.NotificationEmailStatus
}
export type NestedEnumNotificationTypeNullableWithAggregatesFilter<$PrismaModel = never> = {
equals?: $Enums.NotificationType | Prisma.EnumNotificationTypeFieldRefInput<$PrismaModel> | null
in?: $Enums.NotificationType[] | Prisma.ListEnumNotificationTypeFieldRefInput<$PrismaModel> | null
@@ -1377,6 +1401,16 @@ export type NestedEnumNotificationTypeNullableWithAggregatesFilter<$PrismaModel
_max?: Prisma.NestedEnumNotificationTypeNullableFilter<$PrismaModel>
}
export type NestedEnumNotificationEmailStatusWithAggregatesFilter<$PrismaModel = never> = {
equals?: $Enums.NotificationEmailStatus | Prisma.EnumNotificationEmailStatusFieldRefInput<$PrismaModel>
in?: $Enums.NotificationEmailStatus[] | Prisma.ListEnumNotificationEmailStatusFieldRefInput<$PrismaModel>
notIn?: $Enums.NotificationEmailStatus[] | Prisma.ListEnumNotificationEmailStatusFieldRefInput<$PrismaModel>
not?: Prisma.NestedEnumNotificationEmailStatusWithAggregatesFilter<$PrismaModel> | $Enums.NotificationEmailStatus
_count?: Prisma.NestedIntFilter<$PrismaModel>
_min?: Prisma.NestedEnumNotificationEmailStatusFilter<$PrismaModel>
_max?: Prisma.NestedEnumNotificationEmailStatusFilter<$PrismaModel>
}
export type NestedEnumTaskTypeNullableFilter<$PrismaModel = never> = {
equals?: $Enums.TaskType | Prisma.EnumTaskTypeFieldRefInput<$PrismaModel> | null
in?: $Enums.TaskType[] | Prisma.ListEnumTaskTypeFieldRefInput<$PrismaModel> | null
+10
View File
@@ -87,6 +87,16 @@ export const NotificationType = {
export type NotificationType = (typeof NotificationType)[keyof typeof NotificationType]
export const NotificationEmailStatus = {
pending: 'pending',
processing: 'processing',
processed: 'processed',
failed: 'failed'
} as const
export type NotificationEmailStatus = (typeof NotificationEmailStatus)[keyof typeof NotificationEmailStatus]
export const ProjectMemberRole = {
owner: 'owner',
editor: 'editor',
File diff suppressed because one or more lines are too long
+16 -1
View File
@@ -4724,7 +4724,8 @@ export const NotificationScalarFieldEnum = {
assetId: 'assetId',
taskId: 'taskId',
kanbanTaskId: 'kanbanTaskId',
userId: 'userId'
userId: 'userId',
emailStatus: 'emailStatus'
} as const
export type NotificationScalarFieldEnum = (typeof NotificationScalarFieldEnum)[keyof typeof NotificationScalarFieldEnum]
@@ -5421,6 +5422,20 @@ export type ListEnumNotificationTypeFieldRefInput<$PrismaModel> = FieldRefInputT
/**
* Reference to a field of type 'NotificationEmailStatus'
*/
export type EnumNotificationEmailStatusFieldRefInput<$PrismaModel> = FieldRefInputType<$PrismaModel, 'NotificationEmailStatus'>
/**
* Reference to a field of type 'NotificationEmailStatus[]'
*/
export type ListEnumNotificationEmailStatusFieldRefInput<$PrismaModel> = FieldRefInputType<$PrismaModel, 'NotificationEmailStatus[]'>
/**
* Reference to a field of type 'TaskType'
*/
@@ -490,7 +490,8 @@ export const NotificationScalarFieldEnum = {
assetId: 'assetId',
taskId: 'taskId',
kanbanTaskId: 'kanbanTaskId',
userId: 'userId'
userId: 'userId',
emailStatus: 'emailStatus'
} as const
export type NotificationScalarFieldEnum = (typeof NotificationScalarFieldEnum)[keyof typeof NotificationScalarFieldEnum]
+80 -1
View File
@@ -38,6 +38,7 @@ export type NotificationMinAggregateOutputType = {
taskId: string | null
kanbanTaskId: string | null
userId: string | null
emailStatus: $Enums.NotificationEmailStatus | null
}
export type NotificationMaxAggregateOutputType = {
@@ -52,6 +53,7 @@ export type NotificationMaxAggregateOutputType = {
taskId: string | null
kanbanTaskId: string | null
userId: string | null
emailStatus: $Enums.NotificationEmailStatus | null
}
export type NotificationCountAggregateOutputType = {
@@ -66,6 +68,7 @@ export type NotificationCountAggregateOutputType = {
taskId: number
kanbanTaskId: number
userId: number
emailStatus: number
_all: number
}
@@ -82,6 +85,7 @@ export type NotificationMinAggregateInputType = {
taskId?: true
kanbanTaskId?: true
userId?: true
emailStatus?: true
}
export type NotificationMaxAggregateInputType = {
@@ -96,6 +100,7 @@ export type NotificationMaxAggregateInputType = {
taskId?: true
kanbanTaskId?: true
userId?: true
emailStatus?: true
}
export type NotificationCountAggregateInputType = {
@@ -110,6 +115,7 @@ export type NotificationCountAggregateInputType = {
taskId?: true
kanbanTaskId?: true
userId?: true
emailStatus?: true
_all?: true
}
@@ -197,6 +203,7 @@ export type NotificationGroupByOutputType = {
taskId: string | null
kanbanTaskId: string | null
userId: string | null
emailStatus: $Enums.NotificationEmailStatus
_count: NotificationCountAggregateOutputType | null
_min: NotificationMinAggregateOutputType | null
_max: NotificationMaxAggregateOutputType | null
@@ -232,6 +239,7 @@ export type NotificationWhereInput = {
taskId?: Prisma.StringNullableFilter<"Notification"> | string | null
kanbanTaskId?: Prisma.StringNullableFilter<"Notification"> | string | null
userId?: Prisma.StringNullableFilter<"Notification"> | string | null
emailStatus?: Prisma.EnumNotificationEmailStatusFilter<"Notification"> | $Enums.NotificationEmailStatus
team?: Prisma.XOR<Prisma.TeamScalarRelationFilter, Prisma.TeamWhereInput>
project?: Prisma.XOR<Prisma.ProjectNullableScalarRelationFilter, Prisma.ProjectWhereInput> | null
creator?: Prisma.XOR<Prisma.UserNullableScalarRelationFilter, Prisma.UserWhereInput> | null
@@ -254,6 +262,7 @@ export type NotificationOrderByWithRelationInput = {
taskId?: Prisma.SortOrderInput | Prisma.SortOrder
kanbanTaskId?: Prisma.SortOrderInput | Prisma.SortOrder
userId?: Prisma.SortOrderInput | Prisma.SortOrder
emailStatus?: Prisma.SortOrder
team?: Prisma.TeamOrderByWithRelationInput
project?: Prisma.ProjectOrderByWithRelationInput
creator?: Prisma.UserOrderByWithRelationInput
@@ -279,6 +288,7 @@ export type NotificationWhereUniqueInput = Prisma.AtLeast<{
taskId?: Prisma.StringNullableFilter<"Notification"> | string | null
kanbanTaskId?: Prisma.StringNullableFilter<"Notification"> | string | null
userId?: Prisma.StringNullableFilter<"Notification"> | string | null
emailStatus?: Prisma.EnumNotificationEmailStatusFilter<"Notification"> | $Enums.NotificationEmailStatus
team?: Prisma.XOR<Prisma.TeamScalarRelationFilter, Prisma.TeamWhereInput>
project?: Prisma.XOR<Prisma.ProjectNullableScalarRelationFilter, Prisma.ProjectWhereInput> | null
creator?: Prisma.XOR<Prisma.UserNullableScalarRelationFilter, Prisma.UserWhereInput> | null
@@ -301,6 +311,7 @@ export type NotificationOrderByWithAggregationInput = {
taskId?: Prisma.SortOrderInput | Prisma.SortOrder
kanbanTaskId?: Prisma.SortOrderInput | Prisma.SortOrder
userId?: Prisma.SortOrderInput | Prisma.SortOrder
emailStatus?: Prisma.SortOrder
_count?: Prisma.NotificationCountOrderByAggregateInput
_max?: Prisma.NotificationMaxOrderByAggregateInput
_min?: Prisma.NotificationMinOrderByAggregateInput
@@ -321,6 +332,7 @@ export type NotificationScalarWhereWithAggregatesInput = {
taskId?: Prisma.StringNullableWithAggregatesFilter<"Notification"> | string | null
kanbanTaskId?: Prisma.StringNullableWithAggregatesFilter<"Notification"> | string | null
userId?: Prisma.StringNullableWithAggregatesFilter<"Notification"> | string | null
emailStatus?: Prisma.EnumNotificationEmailStatusWithAggregatesFilter<"Notification"> | $Enums.NotificationEmailStatus
}
export type NotificationCreateInput = {
@@ -328,6 +340,7 @@ export type NotificationCreateInput = {
type?: $Enums.NotificationType | null
createdAt?: Date | string
updatedAt?: Date | string
emailStatus?: $Enums.NotificationEmailStatus
team: Prisma.TeamCreateNestedOneWithoutNotificationsInput
project?: Prisma.ProjectCreateNestedOneWithoutNotificationsInput
creator?: Prisma.UserCreateNestedOneWithoutCreatedNotificationsInput
@@ -350,6 +363,7 @@ export type NotificationUncheckedCreateInput = {
taskId?: string | null
kanbanTaskId?: string | null
userId?: string | null
emailStatus?: $Enums.NotificationEmailStatus
readByMembers?: Prisma.TeamMemberUncheckedCreateNestedOneWithoutLastReadNotificationInput
}
@@ -358,6 +372,7 @@ export type NotificationUpdateInput = {
type?: Prisma.NullableEnumNotificationTypeFieldUpdateOperationsInput | $Enums.NotificationType | null
createdAt?: Prisma.DateTimeFieldUpdateOperationsInput | Date | string
updatedAt?: Prisma.DateTimeFieldUpdateOperationsInput | Date | string
emailStatus?: Prisma.EnumNotificationEmailStatusFieldUpdateOperationsInput | $Enums.NotificationEmailStatus
team?: Prisma.TeamUpdateOneRequiredWithoutNotificationsNestedInput
project?: Prisma.ProjectUpdateOneWithoutNotificationsNestedInput
creator?: Prisma.UserUpdateOneWithoutCreatedNotificationsNestedInput
@@ -380,6 +395,7 @@ export type NotificationUncheckedUpdateInput = {
taskId?: Prisma.NullableStringFieldUpdateOperationsInput | string | null
kanbanTaskId?: Prisma.NullableStringFieldUpdateOperationsInput | string | null
userId?: Prisma.NullableStringFieldUpdateOperationsInput | string | null
emailStatus?: Prisma.EnumNotificationEmailStatusFieldUpdateOperationsInput | $Enums.NotificationEmailStatus
readByMembers?: Prisma.TeamMemberUncheckedUpdateOneWithoutLastReadNotificationNestedInput
}
@@ -395,6 +411,7 @@ export type NotificationCreateManyInput = {
taskId?: string | null
kanbanTaskId?: string | null
userId?: string | null
emailStatus?: $Enums.NotificationEmailStatus
}
export type NotificationUpdateManyMutationInput = {
@@ -402,6 +419,7 @@ export type NotificationUpdateManyMutationInput = {
type?: Prisma.NullableEnumNotificationTypeFieldUpdateOperationsInput | $Enums.NotificationType | null
createdAt?: Prisma.DateTimeFieldUpdateOperationsInput | Date | string
updatedAt?: Prisma.DateTimeFieldUpdateOperationsInput | Date | string
emailStatus?: Prisma.EnumNotificationEmailStatusFieldUpdateOperationsInput | $Enums.NotificationEmailStatus
}
export type NotificationUncheckedUpdateManyInput = {
@@ -416,6 +434,7 @@ export type NotificationUncheckedUpdateManyInput = {
taskId?: Prisma.NullableStringFieldUpdateOperationsInput | string | null
kanbanTaskId?: Prisma.NullableStringFieldUpdateOperationsInput | string | null
userId?: Prisma.NullableStringFieldUpdateOperationsInput | string | null
emailStatus?: Prisma.EnumNotificationEmailStatusFieldUpdateOperationsInput | $Enums.NotificationEmailStatus
}
export type NotificationListRelationFilter = {
@@ -445,6 +464,7 @@ export type NotificationCountOrderByAggregateInput = {
taskId?: Prisma.SortOrder
kanbanTaskId?: Prisma.SortOrder
userId?: Prisma.SortOrder
emailStatus?: Prisma.SortOrder
}
export type NotificationMaxOrderByAggregateInput = {
@@ -459,6 +479,7 @@ export type NotificationMaxOrderByAggregateInput = {
taskId?: Prisma.SortOrder
kanbanTaskId?: Prisma.SortOrder
userId?: Prisma.SortOrder
emailStatus?: Prisma.SortOrder
}
export type NotificationMinOrderByAggregateInput = {
@@ -473,6 +494,7 @@ export type NotificationMinOrderByAggregateInput = {
taskId?: Prisma.SortOrder
kanbanTaskId?: Prisma.SortOrder
userId?: Prisma.SortOrder
emailStatus?: Prisma.SortOrder
}
export type NotificationCreateNestedManyWithoutCreatorInput = {
@@ -705,6 +727,10 @@ export type NullableEnumNotificationTypeFieldUpdateOperationsInput = {
set?: $Enums.NotificationType | null
}
export type EnumNotificationEmailStatusFieldUpdateOperationsInput = {
set?: $Enums.NotificationEmailStatus
}
export type NotificationCreateNestedManyWithoutTaskInput = {
create?: Prisma.XOR<Prisma.NotificationCreateWithoutTaskInput, Prisma.NotificationUncheckedCreateWithoutTaskInput> | Prisma.NotificationCreateWithoutTaskInput[] | Prisma.NotificationUncheckedCreateWithoutTaskInput[]
connectOrCreate?: Prisma.NotificationCreateOrConnectWithoutTaskInput | Prisma.NotificationCreateOrConnectWithoutTaskInput[]
@@ -794,6 +820,7 @@ export type NotificationCreateWithoutCreatorInput = {
type?: $Enums.NotificationType | null
createdAt?: Date | string
updatedAt?: Date | string
emailStatus?: $Enums.NotificationEmailStatus
team: Prisma.TeamCreateNestedOneWithoutNotificationsInput
project?: Prisma.ProjectCreateNestedOneWithoutNotificationsInput
asset?: Prisma.AssetCreateNestedOneWithoutNotificationsInput
@@ -814,6 +841,7 @@ export type NotificationUncheckedCreateWithoutCreatorInput = {
taskId?: string | null
kanbanTaskId?: string | null
userId?: string | null
emailStatus?: $Enums.NotificationEmailStatus
readByMembers?: Prisma.TeamMemberUncheckedCreateNestedOneWithoutLastReadNotificationInput
}
@@ -832,6 +860,7 @@ export type NotificationCreateWithoutUserInput = {
type?: $Enums.NotificationType | null
createdAt?: Date | string
updatedAt?: Date | string
emailStatus?: $Enums.NotificationEmailStatus
team: Prisma.TeamCreateNestedOneWithoutNotificationsInput
project?: Prisma.ProjectCreateNestedOneWithoutNotificationsInput
creator?: Prisma.UserCreateNestedOneWithoutCreatedNotificationsInput
@@ -852,6 +881,7 @@ export type NotificationUncheckedCreateWithoutUserInput = {
assetId?: string | null
taskId?: string | null
kanbanTaskId?: string | null
emailStatus?: $Enums.NotificationEmailStatus
readByMembers?: Prisma.TeamMemberUncheckedCreateNestedOneWithoutLastReadNotificationInput
}
@@ -896,6 +926,7 @@ export type NotificationScalarWhereInput = {
taskId?: Prisma.StringNullableFilter<"Notification"> | string | null
kanbanTaskId?: Prisma.StringNullableFilter<"Notification"> | string | null
userId?: Prisma.StringNullableFilter<"Notification"> | string | null
emailStatus?: Prisma.EnumNotificationEmailStatusFilter<"Notification"> | $Enums.NotificationEmailStatus
}
export type NotificationUpsertWithWhereUniqueWithoutUserInput = {
@@ -919,6 +950,7 @@ export type NotificationCreateWithoutTeamInput = {
type?: $Enums.NotificationType | null
createdAt?: Date | string
updatedAt?: Date | string
emailStatus?: $Enums.NotificationEmailStatus
project?: Prisma.ProjectCreateNestedOneWithoutNotificationsInput
creator?: Prisma.UserCreateNestedOneWithoutCreatedNotificationsInput
asset?: Prisma.AssetCreateNestedOneWithoutNotificationsInput
@@ -939,6 +971,7 @@ export type NotificationUncheckedCreateWithoutTeamInput = {
taskId?: string | null
kanbanTaskId?: string | null
userId?: string | null
emailStatus?: $Enums.NotificationEmailStatus
readByMembers?: Prisma.TeamMemberUncheckedCreateNestedOneWithoutLastReadNotificationInput
}
@@ -973,6 +1006,7 @@ export type NotificationCreateWithoutReadByMembersInput = {
type?: $Enums.NotificationType | null
createdAt?: Date | string
updatedAt?: Date | string
emailStatus?: $Enums.NotificationEmailStatus
team: Prisma.TeamCreateNestedOneWithoutNotificationsInput
project?: Prisma.ProjectCreateNestedOneWithoutNotificationsInput
creator?: Prisma.UserCreateNestedOneWithoutCreatedNotificationsInput
@@ -994,6 +1028,7 @@ export type NotificationUncheckedCreateWithoutReadByMembersInput = {
taskId?: string | null
kanbanTaskId?: string | null
userId?: string | null
emailStatus?: $Enums.NotificationEmailStatus
}
export type NotificationCreateOrConnectWithoutReadByMembersInput = {
@@ -1017,6 +1052,7 @@ export type NotificationUpdateWithoutReadByMembersInput = {
type?: Prisma.NullableEnumNotificationTypeFieldUpdateOperationsInput | $Enums.NotificationType | null
createdAt?: Prisma.DateTimeFieldUpdateOperationsInput | Date | string
updatedAt?: Prisma.DateTimeFieldUpdateOperationsInput | Date | string
emailStatus?: Prisma.EnumNotificationEmailStatusFieldUpdateOperationsInput | $Enums.NotificationEmailStatus
team?: Prisma.TeamUpdateOneRequiredWithoutNotificationsNestedInput
project?: Prisma.ProjectUpdateOneWithoutNotificationsNestedInput
creator?: Prisma.UserUpdateOneWithoutCreatedNotificationsNestedInput
@@ -1038,6 +1074,7 @@ export type NotificationUncheckedUpdateWithoutReadByMembersInput = {
taskId?: Prisma.NullableStringFieldUpdateOperationsInput | string | null
kanbanTaskId?: Prisma.NullableStringFieldUpdateOperationsInput | string | null
userId?: Prisma.NullableStringFieldUpdateOperationsInput | string | null
emailStatus?: Prisma.EnumNotificationEmailStatusFieldUpdateOperationsInput | $Enums.NotificationEmailStatus
}
export type NotificationCreateWithoutProjectInput = {
@@ -1045,6 +1082,7 @@ export type NotificationCreateWithoutProjectInput = {
type?: $Enums.NotificationType | null
createdAt?: Date | string
updatedAt?: Date | string
emailStatus?: $Enums.NotificationEmailStatus
team: Prisma.TeamCreateNestedOneWithoutNotificationsInput
creator?: Prisma.UserCreateNestedOneWithoutCreatedNotificationsInput
asset?: Prisma.AssetCreateNestedOneWithoutNotificationsInput
@@ -1065,6 +1103,7 @@ export type NotificationUncheckedCreateWithoutProjectInput = {
taskId?: string | null
kanbanTaskId?: string | null
userId?: string | null
emailStatus?: $Enums.NotificationEmailStatus
readByMembers?: Prisma.TeamMemberUncheckedCreateNestedOneWithoutLastReadNotificationInput
}
@@ -1099,6 +1138,7 @@ export type NotificationCreateWithoutAssetInput = {
type?: $Enums.NotificationType | null
createdAt?: Date | string
updatedAt?: Date | string
emailStatus?: $Enums.NotificationEmailStatus
team: Prisma.TeamCreateNestedOneWithoutNotificationsInput
project?: Prisma.ProjectCreateNestedOneWithoutNotificationsInput
creator?: Prisma.UserCreateNestedOneWithoutCreatedNotificationsInput
@@ -1119,6 +1159,7 @@ export type NotificationUncheckedCreateWithoutAssetInput = {
taskId?: string | null
kanbanTaskId?: string | null
userId?: string | null
emailStatus?: $Enums.NotificationEmailStatus
readByMembers?: Prisma.TeamMemberUncheckedCreateNestedOneWithoutLastReadNotificationInput
}
@@ -1153,6 +1194,7 @@ export type NotificationCreateWithoutTaskInput = {
type?: $Enums.NotificationType | null
createdAt?: Date | string
updatedAt?: Date | string
emailStatus?: $Enums.NotificationEmailStatus
team: Prisma.TeamCreateNestedOneWithoutNotificationsInput
project?: Prisma.ProjectCreateNestedOneWithoutNotificationsInput
creator?: Prisma.UserCreateNestedOneWithoutCreatedNotificationsInput
@@ -1173,6 +1215,7 @@ export type NotificationUncheckedCreateWithoutTaskInput = {
assetId?: string | null
kanbanTaskId?: string | null
userId?: string | null
emailStatus?: $Enums.NotificationEmailStatus
readByMembers?: Prisma.TeamMemberUncheckedCreateNestedOneWithoutLastReadNotificationInput
}
@@ -1207,6 +1250,7 @@ export type NotificationCreateWithoutKanbanTaskInput = {
type?: $Enums.NotificationType | null
createdAt?: Date | string
updatedAt?: Date | string
emailStatus?: $Enums.NotificationEmailStatus
team: Prisma.TeamCreateNestedOneWithoutNotificationsInput
project?: Prisma.ProjectCreateNestedOneWithoutNotificationsInput
creator?: Prisma.UserCreateNestedOneWithoutCreatedNotificationsInput
@@ -1227,6 +1271,7 @@ export type NotificationUncheckedCreateWithoutKanbanTaskInput = {
assetId?: string | null
taskId?: string | null
userId?: string | null
emailStatus?: $Enums.NotificationEmailStatus
readByMembers?: Prisma.TeamMemberUncheckedCreateNestedOneWithoutLastReadNotificationInput
}
@@ -1267,6 +1312,7 @@ export type NotificationCreateManyCreatorInput = {
taskId?: string | null
kanbanTaskId?: string | null
userId?: string | null
emailStatus?: $Enums.NotificationEmailStatus
}
export type NotificationCreateManyUserInput = {
@@ -1280,6 +1326,7 @@ export type NotificationCreateManyUserInput = {
assetId?: string | null
taskId?: string | null
kanbanTaskId?: string | null
emailStatus?: $Enums.NotificationEmailStatus
}
export type NotificationUpdateWithoutCreatorInput = {
@@ -1287,6 +1334,7 @@ export type NotificationUpdateWithoutCreatorInput = {
type?: Prisma.NullableEnumNotificationTypeFieldUpdateOperationsInput | $Enums.NotificationType | null
createdAt?: Prisma.DateTimeFieldUpdateOperationsInput | Date | string
updatedAt?: Prisma.DateTimeFieldUpdateOperationsInput | Date | string
emailStatus?: Prisma.EnumNotificationEmailStatusFieldUpdateOperationsInput | $Enums.NotificationEmailStatus
team?: Prisma.TeamUpdateOneRequiredWithoutNotificationsNestedInput
project?: Prisma.ProjectUpdateOneWithoutNotificationsNestedInput
asset?: Prisma.AssetUpdateOneWithoutNotificationsNestedInput
@@ -1307,6 +1355,7 @@ export type NotificationUncheckedUpdateWithoutCreatorInput = {
taskId?: Prisma.NullableStringFieldUpdateOperationsInput | string | null
kanbanTaskId?: Prisma.NullableStringFieldUpdateOperationsInput | string | null
userId?: Prisma.NullableStringFieldUpdateOperationsInput | string | null
emailStatus?: Prisma.EnumNotificationEmailStatusFieldUpdateOperationsInput | $Enums.NotificationEmailStatus
readByMembers?: Prisma.TeamMemberUncheckedUpdateOneWithoutLastReadNotificationNestedInput
}
@@ -1321,6 +1370,7 @@ export type NotificationUncheckedUpdateManyWithoutCreatorInput = {
taskId?: Prisma.NullableStringFieldUpdateOperationsInput | string | null
kanbanTaskId?: Prisma.NullableStringFieldUpdateOperationsInput | string | null
userId?: Prisma.NullableStringFieldUpdateOperationsInput | string | null
emailStatus?: Prisma.EnumNotificationEmailStatusFieldUpdateOperationsInput | $Enums.NotificationEmailStatus
}
export type NotificationUpdateWithoutUserInput = {
@@ -1328,6 +1378,7 @@ export type NotificationUpdateWithoutUserInput = {
type?: Prisma.NullableEnumNotificationTypeFieldUpdateOperationsInput | $Enums.NotificationType | null
createdAt?: Prisma.DateTimeFieldUpdateOperationsInput | Date | string
updatedAt?: Prisma.DateTimeFieldUpdateOperationsInput | Date | string
emailStatus?: Prisma.EnumNotificationEmailStatusFieldUpdateOperationsInput | $Enums.NotificationEmailStatus
team?: Prisma.TeamUpdateOneRequiredWithoutNotificationsNestedInput
project?: Prisma.ProjectUpdateOneWithoutNotificationsNestedInput
creator?: Prisma.UserUpdateOneWithoutCreatedNotificationsNestedInput
@@ -1348,6 +1399,7 @@ export type NotificationUncheckedUpdateWithoutUserInput = {
assetId?: Prisma.NullableStringFieldUpdateOperationsInput | string | null
taskId?: Prisma.NullableStringFieldUpdateOperationsInput | string | null
kanbanTaskId?: Prisma.NullableStringFieldUpdateOperationsInput | string | null
emailStatus?: Prisma.EnumNotificationEmailStatusFieldUpdateOperationsInput | $Enums.NotificationEmailStatus
readByMembers?: Prisma.TeamMemberUncheckedUpdateOneWithoutLastReadNotificationNestedInput
}
@@ -1362,6 +1414,7 @@ export type NotificationUncheckedUpdateManyWithoutUserInput = {
assetId?: Prisma.NullableStringFieldUpdateOperationsInput | string | null
taskId?: Prisma.NullableStringFieldUpdateOperationsInput | string | null
kanbanTaskId?: Prisma.NullableStringFieldUpdateOperationsInput | string | null
emailStatus?: Prisma.EnumNotificationEmailStatusFieldUpdateOperationsInput | $Enums.NotificationEmailStatus
}
export type NotificationCreateManyTeamInput = {
@@ -1375,6 +1428,7 @@ export type NotificationCreateManyTeamInput = {
taskId?: string | null
kanbanTaskId?: string | null
userId?: string | null
emailStatus?: $Enums.NotificationEmailStatus
}
export type NotificationUpdateWithoutTeamInput = {
@@ -1382,6 +1436,7 @@ export type NotificationUpdateWithoutTeamInput = {
type?: Prisma.NullableEnumNotificationTypeFieldUpdateOperationsInput | $Enums.NotificationType | null
createdAt?: Prisma.DateTimeFieldUpdateOperationsInput | Date | string
updatedAt?: Prisma.DateTimeFieldUpdateOperationsInput | Date | string
emailStatus?: Prisma.EnumNotificationEmailStatusFieldUpdateOperationsInput | $Enums.NotificationEmailStatus
project?: Prisma.ProjectUpdateOneWithoutNotificationsNestedInput
creator?: Prisma.UserUpdateOneWithoutCreatedNotificationsNestedInput
asset?: Prisma.AssetUpdateOneWithoutNotificationsNestedInput
@@ -1402,6 +1457,7 @@ export type NotificationUncheckedUpdateWithoutTeamInput = {
taskId?: Prisma.NullableStringFieldUpdateOperationsInput | string | null
kanbanTaskId?: Prisma.NullableStringFieldUpdateOperationsInput | string | null
userId?: Prisma.NullableStringFieldUpdateOperationsInput | string | null
emailStatus?: Prisma.EnumNotificationEmailStatusFieldUpdateOperationsInput | $Enums.NotificationEmailStatus
readByMembers?: Prisma.TeamMemberUncheckedUpdateOneWithoutLastReadNotificationNestedInput
}
@@ -1416,6 +1472,7 @@ export type NotificationUncheckedUpdateManyWithoutTeamInput = {
taskId?: Prisma.NullableStringFieldUpdateOperationsInput | string | null
kanbanTaskId?: Prisma.NullableStringFieldUpdateOperationsInput | string | null
userId?: Prisma.NullableStringFieldUpdateOperationsInput | string | null
emailStatus?: Prisma.EnumNotificationEmailStatusFieldUpdateOperationsInput | $Enums.NotificationEmailStatus
}
export type NotificationCreateManyProjectInput = {
@@ -1429,6 +1486,7 @@ export type NotificationCreateManyProjectInput = {
taskId?: string | null
kanbanTaskId?: string | null
userId?: string | null
emailStatus?: $Enums.NotificationEmailStatus
}
export type NotificationUpdateWithoutProjectInput = {
@@ -1436,6 +1494,7 @@ export type NotificationUpdateWithoutProjectInput = {
type?: Prisma.NullableEnumNotificationTypeFieldUpdateOperationsInput | $Enums.NotificationType | null
createdAt?: Prisma.DateTimeFieldUpdateOperationsInput | Date | string
updatedAt?: Prisma.DateTimeFieldUpdateOperationsInput | Date | string
emailStatus?: Prisma.EnumNotificationEmailStatusFieldUpdateOperationsInput | $Enums.NotificationEmailStatus
team?: Prisma.TeamUpdateOneRequiredWithoutNotificationsNestedInput
creator?: Prisma.UserUpdateOneWithoutCreatedNotificationsNestedInput
asset?: Prisma.AssetUpdateOneWithoutNotificationsNestedInput
@@ -1456,6 +1515,7 @@ export type NotificationUncheckedUpdateWithoutProjectInput = {
taskId?: Prisma.NullableStringFieldUpdateOperationsInput | string | null
kanbanTaskId?: Prisma.NullableStringFieldUpdateOperationsInput | string | null
userId?: Prisma.NullableStringFieldUpdateOperationsInput | string | null
emailStatus?: Prisma.EnumNotificationEmailStatusFieldUpdateOperationsInput | $Enums.NotificationEmailStatus
readByMembers?: Prisma.TeamMemberUncheckedUpdateOneWithoutLastReadNotificationNestedInput
}
@@ -1470,6 +1530,7 @@ export type NotificationUncheckedUpdateManyWithoutProjectInput = {
taskId?: Prisma.NullableStringFieldUpdateOperationsInput | string | null
kanbanTaskId?: Prisma.NullableStringFieldUpdateOperationsInput | string | null
userId?: Prisma.NullableStringFieldUpdateOperationsInput | string | null
emailStatus?: Prisma.EnumNotificationEmailStatusFieldUpdateOperationsInput | $Enums.NotificationEmailStatus
}
export type NotificationCreateManyAssetInput = {
@@ -1483,6 +1544,7 @@ export type NotificationCreateManyAssetInput = {
taskId?: string | null
kanbanTaskId?: string | null
userId?: string | null
emailStatus?: $Enums.NotificationEmailStatus
}
export type NotificationUpdateWithoutAssetInput = {
@@ -1490,6 +1552,7 @@ export type NotificationUpdateWithoutAssetInput = {
type?: Prisma.NullableEnumNotificationTypeFieldUpdateOperationsInput | $Enums.NotificationType | null
createdAt?: Prisma.DateTimeFieldUpdateOperationsInput | Date | string
updatedAt?: Prisma.DateTimeFieldUpdateOperationsInput | Date | string
emailStatus?: Prisma.EnumNotificationEmailStatusFieldUpdateOperationsInput | $Enums.NotificationEmailStatus
team?: Prisma.TeamUpdateOneRequiredWithoutNotificationsNestedInput
project?: Prisma.ProjectUpdateOneWithoutNotificationsNestedInput
creator?: Prisma.UserUpdateOneWithoutCreatedNotificationsNestedInput
@@ -1510,6 +1573,7 @@ export type NotificationUncheckedUpdateWithoutAssetInput = {
taskId?: Prisma.NullableStringFieldUpdateOperationsInput | string | null
kanbanTaskId?: Prisma.NullableStringFieldUpdateOperationsInput | string | null
userId?: Prisma.NullableStringFieldUpdateOperationsInput | string | null
emailStatus?: Prisma.EnumNotificationEmailStatusFieldUpdateOperationsInput | $Enums.NotificationEmailStatus
readByMembers?: Prisma.TeamMemberUncheckedUpdateOneWithoutLastReadNotificationNestedInput
}
@@ -1524,6 +1588,7 @@ export type NotificationUncheckedUpdateManyWithoutAssetInput = {
taskId?: Prisma.NullableStringFieldUpdateOperationsInput | string | null
kanbanTaskId?: Prisma.NullableStringFieldUpdateOperationsInput | string | null
userId?: Prisma.NullableStringFieldUpdateOperationsInput | string | null
emailStatus?: Prisma.EnumNotificationEmailStatusFieldUpdateOperationsInput | $Enums.NotificationEmailStatus
}
export type NotificationCreateManyTaskInput = {
@@ -1537,6 +1602,7 @@ export type NotificationCreateManyTaskInput = {
assetId?: string | null
kanbanTaskId?: string | null
userId?: string | null
emailStatus?: $Enums.NotificationEmailStatus
}
export type NotificationUpdateWithoutTaskInput = {
@@ -1544,6 +1610,7 @@ export type NotificationUpdateWithoutTaskInput = {
type?: Prisma.NullableEnumNotificationTypeFieldUpdateOperationsInput | $Enums.NotificationType | null
createdAt?: Prisma.DateTimeFieldUpdateOperationsInput | Date | string
updatedAt?: Prisma.DateTimeFieldUpdateOperationsInput | Date | string
emailStatus?: Prisma.EnumNotificationEmailStatusFieldUpdateOperationsInput | $Enums.NotificationEmailStatus
team?: Prisma.TeamUpdateOneRequiredWithoutNotificationsNestedInput
project?: Prisma.ProjectUpdateOneWithoutNotificationsNestedInput
creator?: Prisma.UserUpdateOneWithoutCreatedNotificationsNestedInput
@@ -1564,6 +1631,7 @@ export type NotificationUncheckedUpdateWithoutTaskInput = {
assetId?: Prisma.NullableStringFieldUpdateOperationsInput | string | null
kanbanTaskId?: Prisma.NullableStringFieldUpdateOperationsInput | string | null
userId?: Prisma.NullableStringFieldUpdateOperationsInput | string | null
emailStatus?: Prisma.EnumNotificationEmailStatusFieldUpdateOperationsInput | $Enums.NotificationEmailStatus
readByMembers?: Prisma.TeamMemberUncheckedUpdateOneWithoutLastReadNotificationNestedInput
}
@@ -1578,6 +1646,7 @@ export type NotificationUncheckedUpdateManyWithoutTaskInput = {
assetId?: Prisma.NullableStringFieldUpdateOperationsInput | string | null
kanbanTaskId?: Prisma.NullableStringFieldUpdateOperationsInput | string | null
userId?: Prisma.NullableStringFieldUpdateOperationsInput | string | null
emailStatus?: Prisma.EnumNotificationEmailStatusFieldUpdateOperationsInput | $Enums.NotificationEmailStatus
}
export type NotificationCreateManyKanbanTaskInput = {
@@ -1591,6 +1660,7 @@ export type NotificationCreateManyKanbanTaskInput = {
assetId?: string | null
taskId?: string | null
userId?: string | null
emailStatus?: $Enums.NotificationEmailStatus
}
export type NotificationUpdateWithoutKanbanTaskInput = {
@@ -1598,6 +1668,7 @@ export type NotificationUpdateWithoutKanbanTaskInput = {
type?: Prisma.NullableEnumNotificationTypeFieldUpdateOperationsInput | $Enums.NotificationType | null
createdAt?: Prisma.DateTimeFieldUpdateOperationsInput | Date | string
updatedAt?: Prisma.DateTimeFieldUpdateOperationsInput | Date | string
emailStatus?: Prisma.EnumNotificationEmailStatusFieldUpdateOperationsInput | $Enums.NotificationEmailStatus
team?: Prisma.TeamUpdateOneRequiredWithoutNotificationsNestedInput
project?: Prisma.ProjectUpdateOneWithoutNotificationsNestedInput
creator?: Prisma.UserUpdateOneWithoutCreatedNotificationsNestedInput
@@ -1618,6 +1689,7 @@ export type NotificationUncheckedUpdateWithoutKanbanTaskInput = {
assetId?: Prisma.NullableStringFieldUpdateOperationsInput | string | null
taskId?: Prisma.NullableStringFieldUpdateOperationsInput | string | null
userId?: Prisma.NullableStringFieldUpdateOperationsInput | string | null
emailStatus?: Prisma.EnumNotificationEmailStatusFieldUpdateOperationsInput | $Enums.NotificationEmailStatus
readByMembers?: Prisma.TeamMemberUncheckedUpdateOneWithoutLastReadNotificationNestedInput
}
@@ -1632,6 +1704,7 @@ export type NotificationUncheckedUpdateManyWithoutKanbanTaskInput = {
assetId?: Prisma.NullableStringFieldUpdateOperationsInput | string | null
taskId?: Prisma.NullableStringFieldUpdateOperationsInput | string | null
userId?: Prisma.NullableStringFieldUpdateOperationsInput | string | null
emailStatus?: Prisma.EnumNotificationEmailStatusFieldUpdateOperationsInput | $Enums.NotificationEmailStatus
}
@@ -1648,6 +1721,7 @@ export type NotificationSelect<ExtArgs extends runtime.Types.Extensions.Internal
taskId?: boolean
kanbanTaskId?: boolean
userId?: boolean
emailStatus?: boolean
team?: boolean | Prisma.TeamDefaultArgs<ExtArgs>
project?: boolean | Prisma.Notification$projectArgs<ExtArgs>
creator?: boolean | Prisma.Notification$creatorArgs<ExtArgs>
@@ -1670,6 +1744,7 @@ export type NotificationSelectCreateManyAndReturn<ExtArgs extends runtime.Types.
taskId?: boolean
kanbanTaskId?: boolean
userId?: boolean
emailStatus?: boolean
team?: boolean | Prisma.TeamDefaultArgs<ExtArgs>
project?: boolean | Prisma.Notification$projectArgs<ExtArgs>
creator?: boolean | Prisma.Notification$creatorArgs<ExtArgs>
@@ -1691,6 +1766,7 @@ export type NotificationSelectUpdateManyAndReturn<ExtArgs extends runtime.Types.
taskId?: boolean
kanbanTaskId?: boolean
userId?: boolean
emailStatus?: boolean
team?: boolean | Prisma.TeamDefaultArgs<ExtArgs>
project?: boolean | Prisma.Notification$projectArgs<ExtArgs>
creator?: boolean | Prisma.Notification$creatorArgs<ExtArgs>
@@ -1712,9 +1788,10 @@ export type NotificationSelectScalar = {
taskId?: boolean
kanbanTaskId?: boolean
userId?: boolean
emailStatus?: boolean
}
export type NotificationOmit<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = runtime.Types.Extensions.GetOmit<"id" | "type" | "createdAt" | "updatedAt" | "teamId" | "projectId" | "creatorId" | "assetId" | "taskId" | "kanbanTaskId" | "userId", ExtArgs["result"]["notification"]>
export type NotificationOmit<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = runtime.Types.Extensions.GetOmit<"id" | "type" | "createdAt" | "updatedAt" | "teamId" | "projectId" | "creatorId" | "assetId" | "taskId" | "kanbanTaskId" | "userId" | "emailStatus", ExtArgs["result"]["notification"]>
export type NotificationInclude<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = {
team?: boolean | Prisma.TeamDefaultArgs<ExtArgs>
project?: boolean | Prisma.Notification$projectArgs<ExtArgs>
@@ -1768,6 +1845,7 @@ export type $NotificationPayload<ExtArgs extends runtime.Types.Extensions.Intern
taskId: string | null
kanbanTaskId: string | null
userId: string | null
emailStatus: $Enums.NotificationEmailStatus
}, ExtArgs["result"]["notification"]>
composites: {}
}
@@ -2210,6 +2288,7 @@ export interface NotificationFieldRefs {
readonly taskId: Prisma.FieldRef<"Notification", 'String'>
readonly kanbanTaskId: Prisma.FieldRef<"Notification", 'String'>
readonly userId: Prisma.FieldRef<"Notification", 'String'>
readonly emailStatus: Prisma.FieldRef<"Notification", 'NotificationEmailStatus'>
}
+23 -1
View File
@@ -50,6 +50,7 @@ declare global {
// ----------------------------------------------------------------------
export type VideoTranscodeStrategy = 'best_match' | 'all'
export type HardwareAcceleration = 'off' | 'auto'
export type HdrType = 'pq' | 'hlg' | 'dovi_p5' | 'dovi_p8' | 'sdr'
// ----------------------------------------------------------------------
// Collection Filter
@@ -84,10 +85,23 @@ declare global {
hideAgent?: boolean
}
export interface EmailNotificationSettings {
enabled: boolean
host?: string
port?: number
username?: string
password?: string
smtps?: boolean
ignoreCert?: boolean
from?: string
replyTo?: string
}
export interface Settings {
transcode: TranscodeSettings
transcode?: TranscodeSettings
mediaGeneration?: MediaGenerationSettings
appearance?: AppearanceSettings
emailNotification?: EmailNotificationSettings
}
// ----------------------------------------------------------------------
@@ -104,6 +118,7 @@ declare global {
width: number
height: number
resolution?: string
hdr?: boolean
}
export interface ImageTranscode {
@@ -130,6 +145,7 @@ declare global {
export interface Metadata {
originalHeight: number
originalWidth: number
rotation?: number
hasAudio: boolean
duration: number
bitRate: number
@@ -142,6 +158,12 @@ declare global {
audioChannels?: number
audioSampleRate?: number
audioBitDepth?: number
colorTransfer?: string
colorPrimaries?: string
colorSpace?: string
isHdr?: boolean
hdrType?: HdrType
dvProfile?: number
format: unknown
}
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@shumai/dtos",
"version": "0.4.7",
"version": "0.4.9",
"private": true,
"type": "module",
"main": "./src/index.ts",
+4
View File
@@ -18,6 +18,7 @@ export const previewInfoSchema = z.object({
thumbnailUrl: z.string().optional(),
originalHeight: z.number().optional(),
originalWidth: z.number().optional(),
rotation: z.number().optional(),
spriteUrl: z.string().optional(),
duration: z.number().optional(),
pageCount: z.number().optional(),
@@ -60,6 +61,7 @@ export const mediaMetadataSchema = z.object({
duration: z.number().optional(),
originalWidth: z.number().optional(),
originalHeight: z.number().optional(),
rotation: z.number().optional(),
frameRate: z.number().optional(),
totalFrames: z.number().optional(),
startTimecode: z.string().optional(),
@@ -103,6 +105,7 @@ export const assetInfoSchema = z.object({
width: z.number(),
height: z.number(),
size: z.number(),
hdr: z.boolean().optional(),
}),
)
.optional(),
@@ -335,6 +338,7 @@ export interface VideoTranscode {
width: number
height: number
size: number
hdr?: boolean
}
export const postAttachmentRequestSchema = z.object({
+48
View File
@@ -99,3 +99,51 @@ export const notificationSettingsSchema = z.object({
})
export type NotificationSettings = z.infer<typeof notificationSettingsSchema>
export const emailNotificationSettingsSchema = z.object({
enabled: z.boolean(),
host: z.string().default(''),
port: z.number().int().min(1).max(65535).default(587),
username: z.string().optional(),
password: z.string().optional(),
smtps: z.boolean().default(false),
ignoreCert: z.boolean().default(false),
from: z.string().default(''),
replyTo: z.string().optional(),
})
export type EmailNotificationSettings = z.infer<typeof emailNotificationSettingsSchema>
export const updateEmailNotificationSettingsSchema = z.object({
enabled: z.boolean(),
host: z.string().default(''),
port: z.number().int().min(1).max(65535).default(587),
username: z.string().optional(),
password: z.string().optional(),
smtps: z.boolean().default(false),
ignoreCert: z.boolean().default(false),
from: z.string().default(''),
replyTo: z.string().optional(),
})
export type UpdateEmailNotificationSettings = z.input<typeof updateEmailNotificationSettingsSchema>
export const testEmailRequestSchema = z.object({
host: z.string().optional(),
port: z.number().int().min(1).max(65535).optional(),
username: z.string().optional(),
password: z.string().optional(),
smtps: z.boolean().optional(),
ignoreCert: z.boolean().optional(),
from: z.string().optional(),
replyTo: z.string().optional(),
})
export type TestEmailRequest = z.infer<typeof testEmailRequestSchema>
export const testEmailResponseSchema = z.object({
success: z.boolean(),
messageId: z.string(),
})
export type TestEmailResponse = z.infer<typeof testEmailResponseSchema>
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@shumai/e2e",
"version": "0.4.7",
"version": "0.4.9",
"private": true,
"type": "module",
"dependencies": {
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@shumai/tableprinter",
"version": "0.4.7",
"version": "0.4.9",
"private": true,
"type": "module",
"main": "./src/index.ts",
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@shumai/transcode",
"version": "0.4.7",
"version": "0.4.9",
"private": true,
"type": "module",
"main": "./src/index.ts",
@@ -63,6 +63,7 @@ vi.mock('@shumai/core/src/transcode/transcode', async (importOriginal) => {
transcodeAudio: vi.fn(),
transcodeImage: vi.fn(),
generateSprite: vi.fn(),
generatePoster: vi.fn(),
generatePdfSprite: vi.fn().mockResolvedValue({
pageCount: 10,
originalWidth: 800,
@@ -75,6 +76,7 @@ vi.mock('@shumai/core/src/transcode/transcode', async (importOriginal) => {
takeScreenshots: vi.fn(),
overlayAnnotations: vi.fn(),
renderPdfPages: vi.fn(),
getAvailableFilters: vi.fn().mockResolvedValue(new Set(['zscale', 'tonemap'])),
},
}
})
@@ -184,6 +186,7 @@ describe('Transcode Activities', () => {
audioChannels: 2,
audioSampleRate: 48000,
audioBitDepth: 16,
rotation: -90,
mimeType: 'video/mp4',
})
@@ -197,6 +200,7 @@ describe('Transcode Activities', () => {
expect(transcodeService.getVideoInfo).toHaveBeenCalledWith('/tmp/v.mp4')
expect(result.duration).toBe(10)
expect(result.metadata?.originalWidth).toBe(1920)
expect(result.metadata?.rotation).toBe(-90)
expect(result.metadata?.videoBitRate).toBe(850000)
expect(result.metadata?.videoCodec).toBe('Advanced Video Coding')
expect(result.metadata?.audioCodec).toBe('MPEG-4 Audio')
@@ -205,7 +209,10 @@ describe('Transcode Activities', () => {
expect(result.metadata?.audioBitDepth).toBe(16)
expect(metadataService.updateAssetMetadata).toHaveBeenCalledWith(
asset.id,
expect.arrayContaining([{ key: 'file_type', value: 'video' }]),
expect.arrayContaining([
{ key: 'file_type', value: 'video' },
{ key: 'rotation', value: -90 },
]),
true,
)
})
@@ -696,6 +703,37 @@ describe('Transcode Activities', () => {
)
})
it('transcodeVideoActivity appends -hdr.mp4 suffix and forwards HDR metadata', async () => {
vi.mocked(s3Service.headObject).mockRejectedValue(new Error('Not found'))
const result = await transcodeVideoActivity({
assetKey: 'files/asset-1/video.mp4',
filePath: '/tmp/video.mp4',
videoSpec: { resolution: '1080p', width: 1920, height: 1080, hdr: true },
duration: 10,
originalFps: 30,
sourceIsHdr: true,
sourceHdrType: 'pq',
sourceColorTransfer: 'smpte2084',
sourceColorPrimaries: 'bt2020',
sourceColorSpace: 'bt2020nc',
})
expect(result.key).toBe('files/asset-1/video-1080p-hdr.mp4')
expect(result.hdr).toBe(true)
expect(transcodeService.transcodeVideo).toHaveBeenCalledWith(
expect.objectContaining({
inputFile: '/tmp/video.mp4',
hdr: true,
sourceIsHdr: true,
sourceHdrType: 'pq',
sourceColorTransfer: 'smpte2084',
sourceColorPrimaries: 'bt2020',
sourceColorSpace: 'bt2020nc',
}),
)
})
it('should call transcodeService.takeScreenshots', async () => {
vi.mocked(transcodeService.takeScreenshots).mockResolvedValue([
{ key: 'screenshots/shot1.webp', timestamp: 1.0 },
@@ -873,6 +911,44 @@ describe('Transcode Activities', () => {
).rejects.toThrowError(/Sprite\/Poster generation failed/)
})
it('generateSpriteActivity forwards HDR options to transcodeService.generateSprite', async () => {
vi.mocked(s3Service.headObject).mockRejectedValue(new Error('Not found'))
vi.mocked(transcodeService.generateSprite).mockImplementation(
async (_in, spriteOut, posterOut) => {
fs.writeFileSync(spriteOut, Buffer.from('fake-sprite'))
fs.writeFileSync(posterOut, Buffer.from('fake-poster'))
},
)
await generateSpriteActivity({
assetKey: 'files/asset-1/video.mp4',
filePath: '/tmp/video.mp4',
mediaInfo: {
duration: 10,
metadata: {
isHdr: true,
hdrType: 'pq',
colorTransfer: 'smpte2084',
},
} as unknown as PrismaJson.MediaInfo,
spriteSpec: { key: 'files/asset-1/sprite.webp', frames: 100, tileX: 10, tileY: 10 },
posterSpec: { key: 'files/asset-1/poster.webp' },
})
expect(transcodeService.generateSprite).toHaveBeenCalledWith(
'/tmp/video.mp4',
expect.any(String),
expect.any(String),
10,
undefined,
{
isHdr: true,
hdrType: 'pq',
colorTransfer: 'smpte2084',
},
)
})
it('should throw non-retryable ApplicationFailure when takeScreenshotsActivity fails with error', async () => {
vi.mocked(transcodeService.takeScreenshots).mockRejectedValue(new Error('FFmpeg failed'))
@@ -1052,22 +1128,12 @@ describe('Transcode Activities', () => {
expect(child_process.execFile).not.toHaveBeenCalled()
})
it('should extract poster upfront at t=0 and upload to S3', async () => {
it('should extract poster upfront and upload to S3', async () => {
vi.mocked(s3Service.headObject).mockRejectedValue(new Error('Not found'))
vi.mocked(s3Service.resolveInput).mockResolvedValue('https://mock-r2.com/video.mp4')
// eslint-disable-next-line @typescript-eslint/no-explicit-any
;(child_process.execFile as any).mockImplementation(
(file: string, args: string[], optionsOrCb: unknown, maybeCb?: unknown) => {
const cb = typeof optionsOrCb === 'function' ? optionsOrCb : maybeCb
if (file === 'ffmpeg') {
const outPath = args[args.length - 1]
fs.writeFileSync(outPath, 'fake-poster-bytes')
}
if (typeof cb === 'function') {
cb(null, { stdout: '', stderr: '' })
}
},
)
vi.mocked(transcodeService.generatePoster).mockImplementation(async (_in, posterOut) => {
fs.writeFileSync(posterOut, Buffer.from('fake-poster-bytes'))
})
const res = await extractPosterActivity({
assetKey: 'video.mp4',
@@ -1076,20 +1142,15 @@ describe('Transcode Activities', () => {
expect(res.poster.key).toBe('files/asset-1/poster.webp')
expect(s3Service.resolveInput).toHaveBeenCalledWith('shumai', 'video.mp4')
expect(child_process.execFile).toHaveBeenCalledWith(
'ffmpeg',
expect.arrayContaining([
'-ss',
'0',
'-i',
'https://mock-r2.com/video.mp4',
'-vframes',
'1',
'-c:v',
'libwebp',
]),
expect.objectContaining({ signal: undefined }),
expect.any(Function),
expect(transcodeService.generatePoster).toHaveBeenCalledWith(
'https://mock-r2.com/video.mp4',
expect.stringContaining('poster.webp'),
{
isHdr: undefined,
hdrType: undefined,
colorTransfer: undefined,
signal: undefined,
},
)
expect(s3Service.putObject).toHaveBeenCalledWith(
'shumai',
@@ -1100,6 +1161,33 @@ describe('Transcode Activities', () => {
)
})
it('extractPosterActivity applies tone mapping filter when isHdr is true', async () => {
vi.mocked(s3Service.headObject).mockRejectedValue(new Error('Not found'))
vi.mocked(s3Service.resolveInput).mockResolvedValue('https://mock-r2.com/video.mp4')
vi.mocked(transcodeService.generatePoster).mockImplementation(async (_in, posterOut) => {
fs.writeFileSync(posterOut, Buffer.from('fake-poster-bytes'))
})
await extractPosterActivity({
assetKey: 'video.mp4',
posterSpec: { key: 'files/asset-1/poster.webp' },
isHdr: true,
hdrType: 'pq',
colorTransfer: 'smpte2084',
})
expect(transcodeService.generatePoster).toHaveBeenCalledWith(
'https://mock-r2.com/video.mp4',
expect.stringContaining('poster.webp'),
{
isHdr: true,
hdrType: 'pq',
colorTransfer: 'smpte2084',
signal: undefined,
},
)
})
it('should throw non-retryable ApplicationFailure when poster extraction is cancelled with aborted signal', async () => {
vi.mocked(s3Service.headObject).mockRejectedValue(new Error('Not found'))
const controller = new AbortController()
@@ -1122,19 +1210,10 @@ describe('Transcode Activities', () => {
vi.mocked(s3Service.resolveInput).mockResolvedValue('https://mock-r2.com/video.mp4')
const controller = new AbortController()
const abortErr = new Error('The operation was aborted')
// eslint-disable-next-line @typescript-eslint/no-explicit-any
;(child_process.execFile as any).mockImplementation(
(_file: string, _args: string[], optionsOrCb: unknown, maybeCb?: unknown) => {
const cb = typeof optionsOrCb === 'function' ? optionsOrCb : maybeCb
controller.abort()
const abortErr = new Error('The operation was aborted')
// eslint-disable-next-line @typescript-eslint/no-explicit-any
;(abortErr as any).code = 'ABORT_ERR'
if (typeof cb === 'function') {
cb(abortErr, { stdout: '', stderr: '' })
}
},
)
;(abortErr as any).code = 'ABORT_ERR'
vi.mocked(transcodeService.generatePoster).mockRejectedValue(abortErr)
await expect(
extractPosterActivity({
@@ -1163,19 +1242,9 @@ describe('Transcode Activities', () => {
},
})
// eslint-disable-next-line @typescript-eslint/no-explicit-any
;(child_process.execFile as any).mockImplementation(
(file: string, args: string[], optionsOrCb: unknown, maybeCb?: unknown) => {
const cb = typeof optionsOrCb === 'function' ? optionsOrCb : maybeCb
if (file === 'ffmpeg') {
const outPath = args[args.length - 1]
fs.writeFileSync(outPath, 'fake-poster-bytes')
}
if (typeof cb === 'function') {
cb(null, { stdout: '', stderr: '' })
}
},
)
vi.mocked(transcodeService.generatePoster).mockImplementation(async (_in, posterOut) => {
fs.writeFileSync(posterOut, Buffer.from('fake-poster-bytes'))
})
await expect(
extractPosterActivity({
+51 -27
View File
@@ -1,6 +1,6 @@
import { AssetStatus, prisma, WorkflowTaskType, WorkflowTaskStatus } from '@shumai/db'
import { s3Service } from '@shumai/core/src/s3/s3'
import { transcodeService } from '@shumai/core/src/transcode/transcode'
import { transcodeService, type HdrType } from '@shumai/core/src/transcode/transcode'
import { metadataService } from '@shumai/core/src/metadata/metadata'
import { getDerivedArtifactDirectory, stemFromKey } from '@shumai/core/src/utils/filename'
import { gotenbergService } from '@shumai/core/src/gotenberg/gotenberg'
@@ -142,6 +142,13 @@ export async function getMediaInfoActivity(params: {
audioChannels: info.audioChannels,
audioSampleRate: info.audioSampleRate,
audioBitDepth: info.audioBitDepth,
colorTransfer: info.colorTransfer,
colorPrimaries: info.colorPrimaries,
colorSpace: info.colorSpace,
isHdr: info.isHdr,
hdrType: info.hdrType,
dvProfile: info.dvProfile,
rotation: info.rotation,
format: {},
}
metadataUpdates.push(
@@ -151,6 +158,12 @@ export async function getMediaInfoActivity(params: {
{ key: 'bitRate', value: info.bitRate / 1000 },
{ key: 'frame_rate', value: info.frameRate },
)
if (info.rotation !== undefined)
metadataUpdates.push({ key: 'rotation', value: info.rotation })
if (info.isHdr !== undefined)
metadataUpdates.push({ key: 'is_hdr', value: info.isHdr ? 1 : 0 })
if (info.colorTransfer)
metadataUpdates.push({ key: 'color_transfer', value: info.colorTransfer })
if (info.videoCodec) metadataUpdates.push({ key: 'video_codec', value: info.videoCodec })
if (info.audioCodec) metadataUpdates.push({ key: 'audio_codec', value: info.audioCodec })
if (info.audioChannels !== undefined)
@@ -253,6 +266,11 @@ export interface VideoActivityParams {
hardwareAcceleration?: PrismaJson.HardwareAcceleration
sourceVideoBitrate?: number
threads?: number
sourceIsHdr?: boolean
sourceHdrType?: HdrType
sourceColorTransfer?: string
sourceColorPrimaries?: string
sourceColorSpace?: string
}
export async function transcodeVideoActivity(
@@ -261,7 +279,8 @@ export async function transcodeVideoActivity(
const bucket = process.env.S3_BUCKET || 'shumai'
const stem = stemFromKey(params.assetKey)
const res = params.videoSpec.resolution || `${params.videoSpec.height}p`
const key = path.posix.join(path.posix.dirname(params.assetKey), `${stem}-${res}.mp4`)
const suffix = params.videoSpec.hdr ? `${res}-hdr` : res
const key = path.posix.join(path.posix.dirname(params.assetKey), `${stem}-${suffix}.mp4`)
const signal = getActivityCancellationSignal(params.taskId)
if (signal?.aborted) {
@@ -279,7 +298,7 @@ export async function transcodeVideoActivity(
}
const tmpDir = path.dirname(params.filePath)
const outputFile = path.join(tmpDir, `${stem}-${res}.mp4`)
const outputFile = path.join(tmpDir, `${stem}-${suffix}.mp4`)
try {
let targetFps: number | string = params.originalFps || 30
@@ -307,6 +326,12 @@ export async function transcodeVideoActivity(
sourceVideoBitrate: params.sourceVideoBitrate,
threads: params.threads,
signal,
hdr: params.videoSpec.hdr,
sourceIsHdr: params.sourceIsHdr,
sourceHdrType: params.sourceHdrType,
sourceColorTransfer: params.sourceColorTransfer,
sourceColorPrimaries: params.sourceColorPrimaries,
sourceColorSpace: params.sourceColorSpace,
})
const stat = fs.statSync(outputFile)
@@ -339,7 +364,9 @@ export async function transcodeVideoActivity(
lowerMsg.includes('ffprobe') ||
lowerMsg.includes('spawn') ||
lowerMsg.includes('format') ||
lowerMsg.includes('no video stream found')
lowerMsg.includes('no video stream found') ||
lowerMsg.includes('zscale') ||
lowerMsg.includes('tonemap')
) {
throw ApplicationFailure.create({
message: `Video transcoding failed: ${message}`,
@@ -558,6 +585,11 @@ export async function generateSpriteActivity(params: GenerateSpriteActivityParam
posterFile,
params.mediaInfo.duration,
signal,
{
isHdr: params.mediaInfo.metadata?.isHdr,
hdrType: params.mediaInfo.metadata?.hdrType,
colorTransfer: params.mediaInfo.metadata?.colorTransfer,
},
)
}
@@ -604,7 +636,9 @@ export async function generateSpriteActivity(params: GenerateSpriteActivityParam
lowerMsg.includes('ffmpeg') ||
lowerMsg.includes('ffprobe') ||
lowerMsg.includes('spawn') ||
lowerMsg.includes('format')
lowerMsg.includes('format') ||
lowerMsg.includes('zscale') ||
lowerMsg.includes('tonemap')
) {
throw ApplicationFailure.create({
message: `Sprite/Poster generation failed: ${message}`,
@@ -857,6 +891,9 @@ export interface ExtractPosterActivityParams {
posterSpec: PrismaJson.PosterInfo
taskId?: string
signal?: AbortSignal
isHdr?: boolean
hdrType?: HdrType
colorTransfer?: string
}
export async function extractPosterActivity(
@@ -883,27 +920,12 @@ export async function extractPosterActivity(
try {
const inputSource = await s3Service.resolveInput(bucket, params.assetKey)
const isRemote = inputSource.startsWith('http://') || inputSource.startsWith('https://')
const args = [
...(isRemote
? ['-reconnect', '1', '-reconnect_streamed', '1', '-reconnect_delay_max', '5']
: []),
'-ss',
'0',
'-i',
inputSource,
'-vframes',
'1',
'-vf',
'scale=-2:300:force_original_aspect_ratio=decrease',
'-c:v',
'libwebp',
'-q:v',
'75',
posterFile,
]
await execFileAsync('ffmpeg', ['-y', '-loglevel', 'warning', ...args], { signal })
await transcodeService.generatePoster(inputSource, posterFile, {
isHdr: params.isHdr,
hdrType: params.hdrType,
colorTransfer: params.colorTransfer,
signal,
})
const posterBuffer = fs.readFileSync(posterFile)
await ensureAssetNotPurging(params.assetKey)
@@ -938,7 +960,9 @@ export async function extractPosterActivity(
lowerMsg.includes('enoent') ||
lowerMsg.includes('nosuchkey') ||
lowerMsg.includes('ffmpeg') ||
lowerMsg.includes('sharp')
lowerMsg.includes('sharp') ||
lowerMsg.includes('zscale') ||
lowerMsg.includes('tonemap')
) {
throw ApplicationFailure.create({
message: `Poster extraction failed: ${message}`,
@@ -405,6 +405,125 @@ describe('Watermark Activities', () => {
fs.rmSync(outFilePath, { force: true })
})
it('mirrors both SDR and HDR videoTranscodes preserving HDR flags and -hdr suffix', async () => {
const assetKey = 'files/hdr-wm/video.mp4'
const storageKey = await prisma.storageKey.create({ data: { key: assetKey } })
const asset = await prisma.asset.create({
data: {
name: 'video.mp4',
type: 'file',
status: 'processed',
storageKeyId: storageKey.id,
mediaType: 'video/mp4',
media: {
duration: 10,
filesize: 0,
frames: 300,
proxyType: 'video',
imageTranscodes: [],
videoPreview: { width: 1920, height: 1080 },
finishedAt: new Date().toISOString(),
original: {
key: assetKey,
filesizeInBytes: 0,
codec: '',
},
metadata: {
originalWidth: 1920,
originalHeight: 1080,
duration: 10,
bitRate: 1000,
frameRate: 30,
totalFrames: 300,
startTimecode: '00:00:00:00',
hasAudio: true,
format: {},
isHdr: true,
hdrType: 'pq',
colorTransfer: 'smpte2084',
},
videoTranscodes: [
{
key: 'files/hdr-wm/video-1080p.mp4',
resolution: '1080p',
width: 1920,
height: 1080,
hdr: false,
},
{
key: 'files/hdr-wm/video-1080p-hdr.mp4',
resolution: '1080p',
width: 1920,
height: 1080,
hdr: true,
},
],
} as PrismaJson.MediaInfo,
},
})
const config = await seedConfig()
vi.mocked(transcodeService.getVideoInfo).mockResolvedValue({
originalWidth: 1920,
originalHeight: 1080,
duration: 10,
bitRate: 1000,
frameRate: 30,
totalFrames: 300,
startTimecode: '00:00:00:00',
hasAudio: true,
mimeType: 'video/mp4',
isHdr: true,
hdrType: 'pq',
colorTransfer: 'smpte2084',
})
vi.mocked(s3Service.putObject).mockResolvedValue(undefined as never)
const sdrOut = path.join('/tmp', `video-watermark-${config.id}-1080p.mp4`)
const hdrOut = path.join('/tmp', `video-watermark-${config.id}-1080p-hdr.mp4`)
fs.writeFileSync(sdrOut, Buffer.from('fake sdr'))
fs.writeFileSync(hdrOut, Buffer.from('fake hdr'))
const media = await transcodeWatermarkMediaActivity({
assetId: asset.id,
watermarkConfigId: config.id,
})
expect(media.videoTranscodes).toHaveLength(2)
expect(media.videoTranscodes?.[0]).toEqual(
expect.objectContaining({
resolution: '1080p',
hdr: false,
key: expect.stringContaining(`video-watermark-${config.id}-1080p.mp4`),
}),
)
expect(media.videoTranscodes?.[1]).toEqual(
expect.objectContaining({
resolution: '1080p',
hdr: true,
key: expect.stringContaining(`video-watermark-${config.id}-1080p-hdr.mp4`),
}),
)
expect(transcodeService.transcodeVideo).toHaveBeenCalledWith(
expect.objectContaining({
outputFile: sdrOut,
hdr: false,
sourceIsHdr: true,
}),
)
expect(transcodeService.transcodeVideo).toHaveBeenCalledWith(
expect.objectContaining({
outputFile: hdrOut,
hdr: true,
sourceIsHdr: true,
}),
)
fs.rmSync(sdrOut, { force: true })
fs.rmSync(hdrOut, { force: true })
})
})
describe('completeWatermarkFileActivity', () => {
+28 -1
View File
@@ -181,6 +181,12 @@ export async function transcodeWatermarkMediaActivity(
let startTimecode = '00:00:00:00'
let hasAudio = false
let sourceVideoBitrate: number | undefined
let colorTransfer: string | undefined
let colorPrimaries: string | undefined
let colorSpace: string | undefined
let isHdr: boolean | undefined
let hdrType: PrismaJson.HdrType | undefined
let dvProfile: number | undefined
if (isVideo) {
const info = await transcodeService.getVideoInfo(rawFilePath)
@@ -194,6 +200,12 @@ export async function transcodeWatermarkMediaActivity(
startTimecode = info.startTimecode || '00:00:00:00'
hasAudio = info.hasAudio
sourceVideoBitrate = info.videoBitRate || info.bitRate
colorTransfer = info.colorTransfer
colorPrimaries = info.colorPrimaries
colorSpace = info.colorSpace
isHdr = info.isHdr
hdrType = info.hdrType
dvProfile = info.dvProfile
} else if (isImage) {
const info = await transcodeService.getImageInfo(rawFilePath)
originalWidth = info.originalWidth
@@ -258,6 +270,12 @@ export async function transcodeWatermarkMediaActivity(
totalFrames,
startTimecode,
hasAudio,
colorTransfer: colorTransfer ?? originalMedia?.metadata?.colorTransfer,
colorPrimaries: colorPrimaries ?? originalMedia?.metadata?.colorPrimaries,
colorSpace: colorSpace ?? originalMedia?.metadata?.colorSpace,
isHdr: isHdr ?? originalMedia?.metadata?.isHdr,
hdrType: hdrType ?? originalMedia?.metadata?.hdrType,
dvProfile: dvProfile ?? originalMedia?.metadata?.dvProfile,
format: {},
},
original: {
@@ -320,6 +338,8 @@ export async function transcodeWatermarkMediaActivity(
const targetWidth = vt.width || originalWidth
const targetHeight = vt.height || originalHeight
const resolution = vt.resolution || `${targetHeight}p`
const isVtHdr = Boolean(vt.hdr)
const suffix = isVtHdr ? `${resolution}-hdr` : resolution
const svgString = generateWatermarkSvg(config, targetWidth, targetHeight, blockImagesMap)
const overlayPngBuffer = await transcodeService.renderSvgToPng(svgString)
@@ -327,7 +347,7 @@ export async function transcodeWatermarkMediaActivity(
const overlayPngPath = path.join(tmpDir, `watermarkOverlay-${i}.png`)
fs.writeFileSync(overlayPngPath, overlayPngBuffer)
const outFileName = `${stem}-watermark-${params.watermarkConfigId}-${resolution}.mp4`
const outFileName = `${stem}-watermark-${params.watermarkConfigId}-${suffix}.mp4`
const outFilePath = path.join(tmpDir, outFileName)
await transcodeService.transcodeVideo({
@@ -340,6 +360,12 @@ export async function transcodeWatermarkMediaActivity(
hardwareAcceleration,
sourceVideoBitrate,
threads,
hdr: isVtHdr,
sourceIsHdr: isHdr ?? originalMedia?.metadata?.isHdr,
sourceHdrType: hdrType ?? originalMedia?.metadata?.hdrType,
sourceColorTransfer: colorTransfer ?? originalMedia?.metadata?.colorTransfer,
sourceColorPrimaries: colorPrimaries ?? originalMedia?.metadata?.colorPrimaries,
sourceColorSpace: colorSpace ?? originalMedia?.metadata?.colorSpace,
})
const stat = fs.statSync(outFilePath)
@@ -359,6 +385,7 @@ export async function transcodeWatermarkMediaActivity(
width: targetWidth,
height: targetHeight,
resolution,
hdr: isVtHdr,
})
}
mediaInfo.filesize = totalSize
@@ -168,4 +168,58 @@ describe('takeVideoScreenshotsWorkflow', () => {
annotations: [],
})
})
it('should prioritize SDR proxy over higher-resolution HDR proxy to avoid washed-out annotations', async () => {
const task: WorkflowTask = {
id: 'task-screenshot-sdr-prioritized',
assetId: 'asset-video-hdr',
type: WorkflowTaskType.transcode_screenshot,
status: WorkflowTaskStatus.pending,
sessionId: null,
output: null,
payload: {
projectId: 'proj-1',
screenshot: {
start: 2.0,
end: 2.0,
count: 1,
commentTimestamp: 2.0,
annotations: [],
},
},
createdAt: new Date(),
updatedAt: new Date(),
heartbeat: null,
teamId: 'team-1',
projectId: 'proj-1',
uid: 'task-uid',
model: null,
inputTokens: 0,
outputTokens: 0,
}
mockActivities.getAssetActivity.mockResolvedValue({
id: 'asset-video-hdr',
storageKey: { key: 'raw-hdr.mp4' },
mediaType: 'video/mp4',
media: {
videoTranscodes: [
{ key: 'proxy-1080p-hdr.mp4', height: 1080, width: 1920, hdr: true },
{ key: 'proxy-720p.mp4', height: 720, width: 1280, hdr: false },
],
},
})
mockActivities.takeScreenshotsActivity.mockResolvedValue([
{ key: 'files/asset-video-hdr/screenshots/shot1.webp', timestamp: 2.0 },
])
await takeVideoScreenshotsWorkflow(task)
expect(mockActivities.takeScreenshotsActivity).toHaveBeenCalledWith(
expect.objectContaining({
assetKey: 'proxy-720p.mp4',
}),
)
})
})
@@ -23,7 +23,12 @@ export async function takeVideoScreenshotsWorkflow(task: WorkflowTask): Promise<
if (mediaInfo.videoTranscodes && mediaInfo.videoTranscodes.length > 0) {
const sorted = [...mediaInfo.videoTranscodes]
.filter((t) => t.key)
.sort((a, b) => (b.height || 0) - (a.height || 0))
.sort((a, b) => {
// Prioritize SDR over HDR to avoid washed out screenshots
if (!a.hdr && b.hdr) return -1
if (a.hdr && !b.hdr) return 1
return (b.height || 0) - (a.height || 0)
})
if (sorted.length > 0 && sorted[0].key) {
targetKey = sorted[0].key
}
@@ -497,4 +497,209 @@ describe('transcodeVideoWorkflow', () => {
mockActivities.updateAssetMediaActivity.mock.invocationCallOrder[spriteCommitIndex],
).toBeLessThan(firstProxyOrder)
})
it('should transcode only HDR proxies and HDR 180p preview when source is HDR', async () => {
const task: WorkflowTask = {
id: 'task-hdr',
assetId: 'asset-hdr',
type: WorkflowTaskType.transcode_video,
status: WorkflowTaskStatus.pending,
sessionId: null,
output: null,
payload: {
projectId: 'proj-1',
transcode: {
videoStrategy: 'best_match',
poster: true,
},
},
createdAt: new Date(),
updatedAt: new Date(),
heartbeat: null,
teamId: 'team-1',
projectId: 'proj-1',
uid: 'task-uid-hdr',
model: null,
inputTokens: 0,
outputTokens: 0,
}
mockActivities.getAssetActivity.mockResolvedValue({
id: 'asset-hdr',
storageKey: { key: 'hdr-video.mp4' },
mediaType: 'video/mp4',
})
mockActivities.getMediaInfoActivity.mockResolvedValue({
proxyType: 'video',
metadata: {
originalWidth: 1920,
originalHeight: 1080,
duration: 10,
frameRate: 30,
totalFrames: 300,
startTimecode: '00:00:00:00',
bitRate: 1000,
videoBitRate: 850000,
hasAudio: false,
format: {},
isHdr: true,
hdrType: 'pq',
colorTransfer: 'smpte2084',
colorPrimaries: 'bt2020',
colorSpace: 'bt2020nc',
},
videoTranscodes: [],
imageTranscodes: [],
})
mockActivities.transcodeVideoActivity.mockImplementation(async (params) => {
return {
key: `files/asset-hdr/video-${params.videoSpec.resolution}${params.videoSpec.hdr ? '-hdr' : ''}.mp4`,
width: params.videoSpec.width,
height: params.videoSpec.height,
resolution: params.videoSpec.resolution,
hdr: params.videoSpec.hdr,
}
})
await transcodeVideoWorkflow(task)
// Poster extraction must use SDR tone mapping
expect(mockActivities.extractPosterActivity).toHaveBeenCalledWith(
expect.objectContaining({
isHdr: true,
hdrType: 'pq',
colorTransfer: 'smpte2084',
}),
)
// 180p preview must be generated as HDR (hdr: true)
expect(mockActivities.transcodeVideoActivity).toHaveBeenCalledWith(
expect.objectContaining({
videoSpec: expect.objectContaining({
resolution: '180p',
hdr: true,
}),
}),
)
// Main resolution (1080p) must be called as HDR (hdr: true)
expect(mockActivities.transcodeVideoActivity).toHaveBeenCalledWith(
expect.objectContaining({
videoSpec: expect.objectContaining({
resolution: '1080p',
hdr: true,
}),
}),
)
// No calls should have been made with hdr: false for HDR source
const calls = mockActivities.transcodeVideoActivity.mock.calls
const sdrCalls = calls.filter(
(c: unknown[]) => (c[0] as { videoSpec: { hdr?: boolean } }).videoSpec.hdr === false,
)
expect(sdrCalls).toHaveLength(0)
expect(mockActivities.updateTaskStatusActivity).toHaveBeenCalledWith({
taskId: 'task-hdr',
status: WorkflowTaskStatus.completed,
})
})
it('should transcode only SDR proxy and SDR 180p preview when source is SDR', async () => {
const task: WorkflowTask = {
id: 'task-sdr-source',
assetId: 'asset-sdr-source',
type: WorkflowTaskType.transcode_video,
status: WorkflowTaskStatus.pending,
sessionId: null,
output: null,
payload: {
projectId: 'proj-1',
transcode: {
videoStrategy: 'best_match',
poster: true,
},
},
createdAt: new Date(),
updatedAt: new Date(),
heartbeat: null,
teamId: 'team-1',
projectId: 'proj-1',
uid: 'task-uid-sdr-source',
model: null,
inputTokens: 0,
outputTokens: 0,
}
mockActivities.getAssetActivity.mockResolvedValue({
id: 'asset-sdr-source',
storageKey: { key: 'sdr-video.mp4' },
mediaType: 'video/mp4',
})
mockActivities.getMediaInfoActivity.mockResolvedValue({
proxyType: 'video',
metadata: {
originalWidth: 1920,
originalHeight: 1080,
duration: 10,
frameRate: 30,
totalFrames: 300,
startTimecode: '00:00:00:00',
bitRate: 1000,
videoBitRate: 850000,
hasAudio: false,
format: {},
isHdr: false,
},
videoTranscodes: [],
imageTranscodes: [],
})
mockActivities.transcodeVideoActivity.mockImplementation(async (params) => {
return {
key: `files/asset-sdr-source/video-${params.videoSpec.resolution}.mp4`,
width: params.videoSpec.width,
height: params.videoSpec.height,
resolution: params.videoSpec.resolution,
hdr: params.videoSpec.hdr,
}
})
await transcodeVideoWorkflow(task)
// 180p preview must be generated as SDR (hdr: false)
expect(mockActivities.transcodeVideoActivity).toHaveBeenCalledWith(
expect.objectContaining({
videoSpec: expect.objectContaining({
resolution: '180p',
hdr: false,
}),
}),
)
// Main resolution (1080p) must be generated as SDR (hdr: false)
expect(mockActivities.transcodeVideoActivity).toHaveBeenCalledWith(
expect.objectContaining({
videoSpec: expect.objectContaining({
resolution: '1080p',
hdr: false,
}),
}),
)
// No calls should have been made with hdr: true for SDR source
const calls = mockActivities.transcodeVideoActivity.mock.calls
const hdrCalls = calls.filter(
(c: unknown[]) => (c[0] as { videoSpec: { hdr?: boolean } }).videoSpec.hdr === true,
)
expect(hdrCalls).toHaveLength(0)
expect(mockActivities.updateTaskStatusActivity).toHaveBeenCalledWith({
taskId: 'task-sdr-source',
status: WorkflowTaskStatus.completed,
})
})
})
@@ -69,6 +69,9 @@ export async function transcodeVideoWorkflow(task: WorkflowTask): Promise<void>
assetKey: key,
posterSpec,
taskId: task.id,
isHdr: mediaInfo.metadata?.isHdr,
hdrType: mediaInfo.metadata?.hdrType,
colorTransfer: mediaInfo.metadata?.colorTransfer,
})
mediaInfo.poster = posterResult.poster
await executeActivity(workerQueue, updateAssetMediaActivity, {
@@ -129,10 +132,42 @@ export async function transcodeVideoWorkflow(task: WorkflowTask): Promise<void>
metadata.originalHeight,
)
const isHdr = Boolean(metadata.isHdr)
if (res === '180p') {
const videoSpec: PrismaJson.VideoTranscode = {
resolution: res,
width,
height,
hdr: isHdr,
}
const videoTranscode = await executeActivity(workerQueue, transcodeVideoActivity, {
taskId: task.id,
assetKey: key,
filePath,
videoSpec,
duration: metadata.duration,
originalFps: metadata.frameRate,
hardwareAcceleration: spec.hardwareAcceleration,
sourceVideoBitrate: metadata.videoBitRate || metadata.bitRate,
threads: spec.threads,
sourceIsHdr: metadata.isHdr,
sourceHdrType: metadata.hdrType,
sourceColorTransfer: metadata.colorTransfer,
sourceColorPrimaries: metadata.colorPrimaries,
sourceColorSpace: metadata.colorSpace,
})
mediaInfo.videoPreview = videoTranscode
continue
}
const videoSpec: PrismaJson.VideoTranscode = {
resolution: res,
width,
height,
hdr: isHdr,
}
const videoTranscode = await executeActivity(workerQueue, transcodeVideoActivity, {
@@ -145,13 +180,14 @@ export async function transcodeVideoWorkflow(task: WorkflowTask): Promise<void>
hardwareAcceleration: spec.hardwareAcceleration,
sourceVideoBitrate: metadata.videoBitRate || metadata.bitRate,
threads: spec.threads,
sourceIsHdr: metadata.isHdr,
sourceHdrType: metadata.hdrType,
sourceColorTransfer: metadata.colorTransfer,
sourceColorPrimaries: metadata.colorPrimaries,
sourceColorSpace: metadata.colorSpace,
})
if (res === '180p') {
mediaInfo.videoPreview = videoTranscode
} else {
mediaInfo.videoTranscodes.push(videoTranscode)
}
mediaInfo.videoTranscodes.push(videoTranscode)
}
}
+4 -2
View File
@@ -84,6 +84,7 @@ interface BreadcrumbNavProps {
key: string
width: number
height: number
hdr?: boolean
}>
}
versions?: Array<{
@@ -294,13 +295,14 @@ export function BreadcrumbNav({
else if (longSide >= 960) resolution = '540p'
else if (longSide >= 640) resolution = '360p'
else if (longSide >= 320) resolution = '180p'
const label = t.hdr ? `${resolution} (HDR)` : resolution
return (
<DropdownMenuItem
key={resolution}
key={t.key || `${resolution}-${t.hdr ? 'hdr' : 'sdr'}`}
onClick={() => handleDownload(t.key)}
className="flex items-center justify-between"
>
<span>{resolution}</span>
<span>{label}</span>
<span className="text-xs text-muted-foreground">MP4</span>
</DropdownMenuItem>
)
@@ -19,7 +19,7 @@ interface CompareControlBarProps {
onVolumeChange: (volume: number) => void
onToggleMute: () => void
onChangePlaybackRate: (rate: number) => void
onChangeResolution: (resolution: string) => void
onChangeResolution: (resolution: string, hdr?: boolean) => void
onZoomIn: () => void
onZoomOut: () => void
onFit: () => void
@@ -65,6 +65,7 @@ export function CompareControlBar({
isFullScreen,
showFrames: false,
currentResolution: v.currentResolution,
isCurrentHdr: v.isCurrentHdr,
}
// The active-side asset carries the metadata used for timecode display and
@@ -88,7 +89,7 @@ export function CompareControlBar({
toggleMute={onToggleMute}
handleVolumeChange={onVolumeChange}
changePlaybackRate={onChangePlaybackRate}
changeResolution={(res: DisplayTranscode) => onChangeResolution(res.resolution)}
changeResolution={(res: DisplayTranscode) => onChangeResolution(res.resolution, res.hdr)}
handleDownload={(key?: string) => onDownload(key)}
toggleFullScreen={onToggleFullScreen}
onZoomChange={(nz: number) => (nz >= activeState.zoom ? onZoomIn() : onZoomOut())}
@@ -213,7 +213,7 @@ export function CompareViewer({
)
const handleChangeResolution = useCallback(
(resolution: string) => getActive()?.changeResolution(resolution),
(resolution: string, hdr?: boolean) => getActive()?.changeResolution(resolution, hdr),
[getActive],
)
+2 -1
View File
@@ -23,6 +23,7 @@ export interface PaneReportedState {
playbackRate: number
isLooping: boolean
currentResolution: string
isCurrentHdr?: boolean
resolutions: DisplayTranscode[]
buffered: number
}
@@ -45,7 +46,7 @@ export interface ComparePaneHandle {
setVolume: (volume: number) => void
setPlaybackRate: (rate: number) => void
toggleLoop: () => void
changeResolution: (resolution: string) => void
changeResolution: (resolution: string, hdr?: boolean) => void
// Zoom / pan (image + video)
zoomBy: (factor: number) => void
fit: () => void
+37 -52
View File
@@ -19,7 +19,6 @@ interface DrawingCanvasProps {
imageUrl?: string
/** A live canvas to draw instead of an image URL (e.g. a PDF.js page render). */
canvasElement?: HTMLCanvasElement | null
videoElement?: HTMLVideoElement
annotations: Annotation[]
scale: number
offset: { x: number; y: number }
@@ -40,7 +39,6 @@ const DrawingCanvas = ({
mediaDimensions,
imageUrl,
canvasElement,
videoElement,
annotations,
scale,
offset,
@@ -53,7 +51,7 @@ const DrawingCanvas = ({
onAddAnnotation,
}: DrawingCanvasProps) => {
const [loadedImage] = useImage(imageUrl || '', 'anonymous')
const imageRef = useRef<Konva.Image>(null)
const mediaGroupRef = useRef<Konva.Group>(null)
const isDragging = useRef(false)
const lastPos = useRef({ x: 0, y: 0 })
const startPointRef = useRef<{ x: number; y: number } | null>(null)
@@ -66,27 +64,11 @@ const DrawingCanvas = ({
// Force a redraw whenever the live canvas source is swapped, so the layer
// picks up the new page raster (Konva redraws the source each batchDraw).
useEffect(() => {
if (canvasElement && imageRef.current) {
imageRef.current.getLayer()?.batchDraw()
if (canvasElement && mediaGroupRef.current) {
mediaGroupRef.current.getLayer()?.batchDraw()
}
}, [canvasElement])
// Handle Video Redraw
useEffect(() => {
if (videoElement && imageRef.current) {
const layer = imageRef.current.getLayer()
if (!layer) return
const anim = new Konva.Animation(() => {
// Force redraw to update video frame
}, layer)
anim.start()
return () => {
anim.stop()
}
}
}, [videoElement])
// -- Helpers --
const getRelativePointerPosition = (
node: Konva.Node,
@@ -217,7 +199,7 @@ const DrawingCanvas = ({
const handleGlobalMove = (e: MouseEvent | TouchEvent) => {
if (!isDragging.current) return
const stage = imageRef.current?.getStage()
const stage = mediaGroupRef.current?.getStage()
if (!stage) return
const container = stage.container()
const rect = container.getBoundingClientRect()
@@ -255,11 +237,11 @@ const DrawingCanvas = ({
if (activeDrawing) {
if (tool === 'select') return
const pos = getRelativePointerPosition(imageRef.current!, true, stagePos)
const pos = getRelativePointerPosition(mediaGroupRef.current!, true, stagePos)
if (!pos || !startPointRef.current) return
const start = startPointRef.current
const layer = imageRef.current?.getLayer()
const layer = mediaGroupRef.current?.getLayer()
if (tool === 'freehand' && currentLineRef.current) {
const newPoints = currentLineRef.current.points().concat([pos.x, pos.y])
@@ -317,8 +299,8 @@ const DrawingCanvas = ({
const stage = e.target.getStage()
if (!stage) return
// Use imageRef to get coordinates relative to the image (handling zoom/pan)
const pos = getRelativePointerPosition(imageRef.current!)
// Use mediaGroupRef to get coordinates relative to the media (handling zoom/pan)
const pos = getRelativePointerPosition(mediaGroupRef.current!)
if (!pos) return
// Only start drawing if within media bounds
@@ -334,7 +316,7 @@ const DrawingCanvas = ({
isDragging.current = true
startPointRef.current = pos
const layer = imageRef.current?.getLayer()
const layer = mediaGroupRef.current?.getLayer()
if (!layer) return
if (currentTool === 'freehand' && currentLineRef.current) {
@@ -474,32 +456,35 @@ const DrawingCanvas = ({
onTouchStart={handleMouseDown}
>
<Layer>
<KonvaImage
ref={imageRef}
image={videoElement || canvasElement || loadedImage}
width={mediaDimensions.width}
height={mediaDimensions.height}
/>
{annotations.map(renderAnnotation)}
<Group ref={mediaGroupRef} width={mediaDimensions.width} height={mediaDimensions.height}>
{(canvasElement || loadedImage) && (
<KonvaImage
image={canvasElement || loadedImage}
width={mediaDimensions.width}
height={mediaDimensions.height}
/>
)}
{annotations.map(renderAnnotation)}
{/* Draft Shapes */}
<Group listening={false}>
<Line
ref={currentLineRef}
strokeWidth={2.6 / scale}
lineCap="round"
lineJoin="round"
visible={false}
/>
<Rect ref={currentRectRef} strokeWidth={2.6 / scale} visible={false} />
<Arrow
ref={currentArrowRef}
points={[]}
strokeWidth={2.6 / scale}
pointerLength={10 / scale}
pointerWidth={10 / scale}
visible={false}
/>
{/* Draft Shapes */}
<Group listening={false}>
<Line
ref={currentLineRef}
strokeWidth={2.6 / scale}
lineCap="round"
lineJoin="round"
visible={false}
/>
<Rect ref={currentRectRef} strokeWidth={2.6 / scale} visible={false} />
<Arrow
ref={currentArrowRef}
points={[]}
strokeWidth={2.6 / scale}
pointerLength={10 / scale}
pointerWidth={10 / scale}
visible={false}
/>
</Group>
</Group>
</Layer>
</Stage>
@@ -145,6 +145,7 @@ export function MobileFileDetail({
key: t.key,
width: t.width,
height: t.height,
hdr: t.hdr,
})),
}
}, [file.media])
@@ -46,6 +46,7 @@ export interface MobileFileHeaderProps {
key: string
width: number
height: number
hdr?: boolean
}>
}
canEdit?: boolean
@@ -245,13 +246,14 @@ export function MobileFileHeader({
else if (longSide >= 960) resolution = '540p'
else if (longSide >= 640) resolution = '360p'
else if (longSide >= 320) resolution = '180p'
const label = t.hdr ? `${resolution} (HDR)` : resolution
return (
<DropdownMenuItem
key={resolution}
key={t.key || `${resolution}-${t.hdr ? 'hdr' : 'sdr'}`}
onClick={() => handleDownload(t.key)}
className="flex items-center justify-between text-xs cursor-pointer"
>
<span>{resolution}</span>
<span>{label}</span>
<span className="text-[10px] text-muted-foreground">MP4</span>
</DropdownMenuItem>
)
@@ -440,6 +440,7 @@ export function PublicShareManager({
key: t.key,
width: t.width,
height: t.height,
hdr: t.hdr,
})),
}
: undefined,
@@ -0,0 +1,239 @@
// @vitest-environment happy-dom
import { cleanup, render, screen, fireEvent, waitFor } from '@testing-library/react'
import React from 'react'
import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
import { QueryClient, QueryClientProvider } from '@tanstack/react-query'
import { EmailNotificationSettings } from './EmailNotificationSettings'
import type { EmailNotificationSettings as Settings } from '@shumai/dtos'
import { toast } from 'sonner'
const mockGetSettings = vi.fn()
const mockPutSettings = vi.fn()
vi.mock('@/ui/api/client', () => ({
client: {
api: {
teams: {
':teamId': {
notifications: {
email: {
$get: () => mockGetSettings(),
$put: (args: unknown) => mockPutSettings(args),
},
},
},
},
},
},
}))
vi.mock('./TestEmailDialog', () => ({
TestEmailDialog: ({
isOpen,
defaultFrom,
}: {
isOpen: boolean
onClose: () => void
teamId: string
defaultFrom?: string
}) =>
isOpen ? (
<div data-testid="mock-test-email-dialog" data-from={defaultFrom}>
Test Email Dialog Content
</div>
) : null,
}))
vi.mock('sonner', () => ({
toast: {
success: vi.fn(),
error: vi.fn(),
},
}))
describe('EmailNotificationSettings', () => {
const initialSettings: Settings = {
enabled: false,
host: 'smtp.example.com',
port: 587,
username: 'smtpuser',
password: '••••••••',
smtps: false,
ignoreCert: false,
from: 'Shumai <noreply@example.com>',
replyTo: 'support@example.com',
}
beforeEach(() => {
vi.clearAllMocks()
mockGetSettings.mockResolvedValue({
ok: true,
json: async () => initialSettings,
})
mockPutSettings.mockResolvedValue({
ok: true,
json: async () => ({ ...initialSettings, enabled: true }),
})
})
afterEach(() => {
cleanup()
})
function renderComponent() {
const queryClient = new QueryClient({
defaultOptions: {
queries: { retry: false },
},
})
return render(
<QueryClientProvider client={queryClient}>
<EmailNotificationSettings teamId="team-1" />
</QueryClientProvider>,
)
}
it('renders initial settings properly', async () => {
renderComponent()
await waitFor(() => {
expect(screen.getByText(/enable email notifications/i)).toBeDefined()
})
expect(screen.getByText(/smtp server settings/i)).toBeDefined()
expect(screen.getByText(/sender information/i)).toBeDefined()
// Host input should have the value from initial settings
const hostInput = screen.getByLabelText(/smtp host/i) as HTMLInputElement
expect(hostInput.value).toBe('smtp.example.com')
expect(hostInput.disabled).toBe(true) // Disabled because enabled is false
// Buttons
expect(screen.getByRole('button', { name: /^save$/i })).toBeDefined()
expect(screen.getByRole('button', { name: /save & send test email/i })).toBeDefined()
})
it('enables form inputs when enable switch is toggled', async () => {
renderComponent()
await waitFor(() => {
expect(screen.getByLabelText(/smtp host/i)).toBeDefined()
})
const hostInput = screen.getByLabelText(/smtp host/i) as HTMLInputElement
expect(hostInput.disabled).toBe(true)
// Toggle the enable switch
const enableSwitch = screen.getByRole('switch', { name: /enable email notifications/i })
fireEvent.click(enableSwitch)
await waitFor(() => {
expect(hostInput.disabled).toBe(false)
})
})
it('saves settings successfully when Save button is clicked', async () => {
renderComponent()
await waitFor(() => {
expect(screen.getByLabelText(/smtp host/i)).toBeDefined()
})
// Enable first
const enableSwitch = screen.getByRole('switch', { name: /enable email notifications/i })
fireEvent.click(enableSwitch)
// Edit host
const hostInput = screen.getByLabelText(/smtp host/i)
fireEvent.change(hostInput, { target: { value: 'mail.mycompany.com' } })
// Click Save
const saveButton = screen.getByRole('button', { name: /^save$/i })
fireEvent.click(saveButton)
await waitFor(() => {
expect(mockPutSettings).toHaveBeenCalledWith({
param: { teamId: 'team-1' },
json: expect.objectContaining({
enabled: true,
host: 'mail.mycompany.com',
port: 587,
}),
})
expect(toast.success).toHaveBeenCalled()
})
})
it('shows error toast when save fails', async () => {
mockPutSettings.mockResolvedValueOnce({
ok: false,
json: async () => ({ message: 'Invalid SMTP configuration' }),
})
renderComponent()
await waitFor(() => {
expect(screen.getByLabelText(/smtp host/i)).toBeDefined()
})
const saveButton = screen.getByRole('button', { name: /^save$/i })
fireEvent.click(saveButton)
await waitFor(() => {
expect(toast.error).toHaveBeenCalledWith('Invalid SMTP configuration')
})
})
it('saves settings first and opens TestEmailDialog on "Save & Send Test Email"', async () => {
renderComponent()
await waitFor(() => {
expect(screen.getByLabelText(/smtp host/i)).toBeDefined()
})
// Enable switch so button is active
const enableSwitch = screen.getByRole('switch', { name: /enable email notifications/i })
fireEvent.click(enableSwitch)
const saveAndTestButton = screen.getByRole('button', { name: /save & send test email/i })
fireEvent.click(saveAndTestButton)
// Should call save first
await waitFor(() => {
expect(mockPutSettings).toHaveBeenCalled()
expect(toast.success).toHaveBeenCalled()
})
// Mock dialog should be opened with defaultFrom
await waitFor(() => {
const dialog = screen.getByTestId('mock-test-email-dialog')
expect(dialog).toBeDefined()
expect(dialog.getAttribute('data-from')).toBe('Shumai <noreply@example.com>')
})
})
it('validates required host when clicking "Save & Send Test Email"', async () => {
mockGetSettings.mockResolvedValueOnce({
ok: true,
json: async () => ({ ...initialSettings, host: '' }),
})
renderComponent()
await waitFor(() => {
expect(screen.getByLabelText(/smtp host/i)).toBeDefined()
})
const enableSwitch = screen.getByRole('switch', { name: /enable email notifications/i })
fireEvent.click(enableSwitch)
const saveAndTestButton = screen.getByRole('button', { name: /save & send test email/i })
fireEvent.click(saveAndTestButton)
await waitFor(() => {
expect(toast.error).toHaveBeenCalledWith(expect.stringMatching(/host is required/i))
expect(mockPutSettings).not.toHaveBeenCalled()
})
})
})
@@ -0,0 +1,348 @@
import { useState, useEffect } from 'react'
import { useQuery, useMutation, useQueryClient } from '@tanstack/react-query'
import { client } from '@/ui/api/client'
import { ScrollArea } from '@/ui/components/ui/scroll-area'
import { Card, CardContent, CardFooter } from '@/ui/components/ui/card'
import { Switch } from '@/ui/components/ui/switch'
import { Input } from '@/ui/components/ui/input'
import { Button } from '@/ui/components/ui/button'
import { Loader2 } from 'lucide-react'
import { toast } from 'sonner'
import type { EmailNotificationSettings as Settings } from '@shumai/dtos'
import { m } from '@/ui/paraglide/messages.js'
import { TestEmailDialog } from '@/ui/components/settings/TestEmailDialog'
interface EmailNotificationSettingsProps {
teamId: string
}
export function EmailNotificationSettings({ teamId }: EmailNotificationSettingsProps) {
const queryClient = useQueryClient()
const [formData, setFormData] = useState<Settings>({
enabled: false,
host: '',
port: 587,
username: '',
password: '',
smtps: false,
ignoreCert: false,
from: '',
replyTo: '',
})
const [isTestDialogOpen, setIsTestDialogOpen] = useState(false)
const {
data: settings,
isLoading,
error,
} = useQuery<Settings>({
queryKey: ['teams', teamId, 'email-settings'],
queryFn: async () => {
const res = await client.api.teams[':teamId'].notifications.email.$get({
param: { teamId },
})
if (!res.ok) throw new Error(m.failed_to_load_email_settings())
return (await res.json()) as Settings
},
enabled: !!teamId,
})
useEffect(() => {
if (settings) {
setFormData({
enabled: settings.enabled ?? false,
host: settings.host ?? '',
port: settings.port ?? 587,
username: settings.username ?? '',
password: '',
smtps: settings.smtps ?? false,
ignoreCert: settings.ignoreCert ?? false,
from: settings.from ?? '',
replyTo: settings.replyTo ?? '',
})
}
}, [settings])
const { mutateAsync: saveSettings, isPending: isSaving } = useMutation({
mutationFn: async (dataToSave: Settings) => {
const res = await client.api.teams[':teamId'].notifications.email.$put({
param: { teamId },
json: {
enabled: dataToSave.enabled,
host: dataToSave.host,
port: dataToSave.port,
username: dataToSave.username || '',
password: dataToSave.password || '',
smtps: dataToSave.smtps,
ignoreCert: dataToSave.ignoreCert,
from: dataToSave.from,
replyTo: dataToSave.replyTo || '',
},
})
if (!res.ok) {
const err = (await res.json().catch(() => null)) as { message?: string } | null
throw new Error(err?.message || m.failed_to_save_email_settings())
}
return (await res.json()) as Settings
},
onSuccess: () => {
queryClient.invalidateQueries({ queryKey: ['teams', teamId, 'email-settings'] })
queryClient.invalidateQueries({ queryKey: ['teams', teamId, 'settings'] })
},
})
const handleSave = async () => {
try {
await saveSettings(formData)
toast.success(m.email_settings_saved())
} catch (err) {
toast.error(err instanceof Error ? err.message : m.failed_to_save_email_settings())
}
}
const handleSaveAndTest = async () => {
if (!formData.host.trim()) {
toast.error(m.smtp_host_required())
return
}
try {
await saveSettings(formData)
toast.success(m.email_settings_saved())
setIsTestDialogOpen(true)
} catch (err) {
toast.error(err instanceof Error ? err.message : m.failed_to_save_email_settings())
}
}
if (isLoading) {
return (
<div className="flex items-center justify-center p-8">
<Loader2 className="h-6 w-6 animate-spin text-muted-foreground" />
</div>
)
}
if (error) {
return (
<div className="p-8 text-center text-destructive">
{error instanceof Error ? error.message : m.failed_to_load_email_settings()}
</div>
)
}
return (
<>
<ScrollArea className="h-full">
<div className="space-y-6 pr-4 pb-8">
<Card>
<CardContent className="space-y-6 pt-6">
{/* Enable Switch */}
<div className="flex items-center justify-between space-x-4 rounded-lg border border-border p-4">
<div className="space-y-1">
<label
htmlFor="enable-email-switch"
className="text-sm font-medium leading-none cursor-pointer"
>
{m.enable_email_notifications()}
</label>
<p className="text-xs text-muted-foreground">
{m.enable_email_notifications_description()}
</p>
</div>
<Switch
id="enable-email-switch"
checked={formData.enabled}
onCheckedChange={(checked) => setFormData({ ...formData, enabled: checked })}
/>
</div>
{/* SMTP Server Settings */}
<div className="space-y-4 pt-2">
<h4 className="text-sm font-semibold text-foreground">{m.smtp_settings()}</h4>
<div className="grid grid-cols-1 md:grid-cols-3 gap-4">
<div className="space-y-2 md:col-span-2">
<label
htmlFor="smtp-host-input"
className="text-sm font-medium text-foreground"
>
{m.smtp_host()}
</label>
<Input
id="smtp-host-input"
value={formData.host}
onChange={(e) => setFormData({ ...formData, host: e.target.value })}
placeholder={m.smtp_host_placeholder()}
disabled={!formData.enabled}
/>
</div>
<div className="space-y-2">
<label
htmlFor="smtp-port-input"
className="text-sm font-medium text-foreground"
>
{m.smtp_port()}
</label>
<Input
id="smtp-port-input"
type="number"
value={formData.port}
onChange={(e) =>
setFormData({
...formData,
port: parseInt(e.target.value, 10) || 587,
})
}
disabled={!formData.enabled}
/>
</div>
</div>
<div className="grid grid-cols-1 md:grid-cols-2 gap-4">
<div className="space-y-2">
<label
htmlFor="smtp-username-input"
className="text-sm font-medium text-foreground"
>
{m.smtp_username()}
</label>
<Input
id="smtp-username-input"
value={formData.username || ''}
onChange={(e) => setFormData({ ...formData, username: e.target.value })}
placeholder={m.smtp_username_placeholder()}
disabled={!formData.enabled}
autoComplete="off"
/>
</div>
<div className="space-y-2">
<label
htmlFor="smtp-password-input"
className="text-sm font-medium text-foreground"
>
{m.smtp_password()}
</label>
<Input
id="smtp-password-input"
type="password"
value={formData.password || ''}
onChange={(e) => setFormData({ ...formData, password: e.target.value })}
placeholder={
settings?.password
? m.smtp_password_keep_placeholder()
: m.smtp_password_placeholder()
}
disabled={!formData.enabled}
autoComplete="new-password"
/>
</div>
</div>
<div className="grid grid-cols-1 md:grid-cols-2 gap-4 pt-2">
<div className="flex items-center justify-between space-x-4 rounded-lg border border-border p-4">
<div className="space-y-1">
<label
htmlFor="smtps-switch"
className="text-sm font-medium leading-none cursor-pointer"
>
{m.smtp_secure()}
</label>
<p className="text-xs text-muted-foreground">{m.smtp_secure_description()}</p>
</div>
<Switch
id="smtps-switch"
checked={formData.smtps}
onCheckedChange={(checked) => setFormData({ ...formData, smtps: checked })}
disabled={!formData.enabled}
/>
</div>
<div className="flex items-center justify-between space-x-4 rounded-lg border border-border p-4">
<div className="space-y-1">
<label
htmlFor="ignore-cert-switch"
className="text-sm font-medium leading-none cursor-pointer"
>
{m.smtp_ignore_cert()}
</label>
<p className="text-xs text-muted-foreground">
{m.smtp_ignore_cert_description()}
</p>
</div>
<Switch
id="ignore-cert-switch"
checked={formData.ignoreCert}
onCheckedChange={(checked) =>
setFormData({ ...formData, ignoreCert: checked })
}
disabled={!formData.enabled}
/>
</div>
</div>
</div>
{/* Sender Information */}
<div className="space-y-4 pt-4 border-t border-border">
<h4 className="text-sm font-semibold text-foreground">{m.sender_settings()}</h4>
<div className="space-y-2">
<label
htmlFor="sender-from-input"
className="text-sm font-medium text-foreground"
>
{m.sender_from()}
</label>
<Input
id="sender-from-input"
value={formData.from}
onChange={(e) => setFormData({ ...formData, from: e.target.value })}
placeholder="Shumai <noreply@example.com>"
disabled={!formData.enabled}
/>
<p className="text-xs text-muted-foreground">{m.sender_from_description()}</p>
</div>
<div className="space-y-2">
<label
htmlFor="sender-reply-to-input"
className="text-sm font-medium text-foreground"
>
{m.sender_reply_to()}
</label>
<Input
id="sender-reply-to-input"
value={formData.replyTo || ''}
onChange={(e) => setFormData({ ...formData, replyTo: e.target.value })}
placeholder="noreply@example.com"
disabled={!formData.enabled}
/>
<p className="text-xs text-muted-foreground">{m.sender_reply_to_description()}</p>
</div>
</div>
</CardContent>
<CardFooter className="flex flex-col sm:flex-row items-center justify-end gap-3 border-t border-border p-6 bg-muted/20">
<Button variant="outline" onClick={handleSave} disabled={isSaving}>
{isSaving && <Loader2 className="w-4 h-4 animate-spin mr-2" />}
{m.save()}
</Button>
<Button onClick={handleSaveAndTest} disabled={isSaving || !formData.enabled}>
{isSaving && <Loader2 className="w-4 h-4 animate-spin mr-2" />}
{m.save_and_send_test_email()}
</Button>
</CardFooter>
</Card>
</div>
</ScrollArea>
<TestEmailDialog
isOpen={isTestDialogOpen}
onClose={() => setIsTestDialogOpen(false)}
teamId={teamId}
defaultFrom={formData.from}
/>
</>
)
}
@@ -0,0 +1,139 @@
// @vitest-environment happy-dom
import { cleanup, render, screen, fireEvent, waitFor } from '@testing-library/react'
import React from 'react'
import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
import { QueryClient, QueryClientProvider } from '@tanstack/react-query'
import { TestEmailDialog } from './TestEmailDialog'
import { toast } from 'sonner'
const mockPostTestEmail = vi.fn()
vi.mock('@/ui/api/client', () => ({
client: {
api: {
teams: {
':teamId': {
notifications: {
email: {
test: {
$post: (args: unknown) => mockPostTestEmail(args),
},
},
},
},
},
},
},
}))
vi.mock('sonner', () => ({
toast: {
success: vi.fn(),
error: vi.fn(),
},
}))
describe('TestEmailDialog', () => {
const mockOnClose = vi.fn()
beforeEach(() => {
vi.clearAllMocks()
mockPostTestEmail.mockResolvedValue({
ok: true,
json: async () => ({ success: true, messageId: '<msg-123@example.com>' }),
})
})
afterEach(() => {
cleanup()
})
function renderDialog(props?: Partial<React.ComponentProps<typeof TestEmailDialog>>) {
const queryClient = new QueryClient({
defaultOptions: { queries: { retry: false }, mutations: { retry: false } },
})
return render(
<QueryClientProvider client={queryClient}>
<TestEmailDialog
isOpen={true}
onClose={mockOnClose}
teamId="team-1"
defaultFrom="Shumai <noreply@example.com>"
{...props}
/>
</QueryClientProvider>,
)
}
it('renders dialog title, description and pre-filled from address', () => {
renderDialog()
expect(screen.getByRole('heading', { name: /send test email/i })).toBeDefined()
expect(
screen.getByText(
/Sender email address, for example: "Shumai <noreply@example\.com>"\. Make sure to use an address you're allowed to send emails from\./i,
),
).toBeDefined()
const input = screen.getByLabelText(/from address/i) as HTMLInputElement
expect(input.value).toBe('Shumai <noreply@example.com>')
})
it('validates from address when empty', async () => {
renderDialog({ defaultFrom: '' })
const sendBtn = screen.getByRole('button', { name: /send test email/i })
fireEvent.click(sendBtn)
await waitFor(() => {
expect(toast.error).toHaveBeenCalledWith(expect.stringMatching(/from address is required/i))
expect(mockPostTestEmail).not.toHaveBeenCalled()
})
})
it('sends test email successfully and calls onClose', async () => {
renderDialog()
const input = screen.getByLabelText(/from address/i)
fireEvent.change(input, { target: { value: 'Admin <admin@test.com>' } })
const sendBtn = screen.getByRole('button', { name: /send test email/i })
fireEvent.click(sendBtn)
await waitFor(() => {
expect(mockPostTestEmail).toHaveBeenCalledWith({
param: { teamId: 'team-1' },
json: { from: 'Admin <admin@test.com>' },
})
expect(toast.success).toHaveBeenCalledWith(expect.stringMatching(/test email sent/i))
expect(mockOnClose).toHaveBeenCalled()
})
})
it('handles send test email API error', async () => {
mockPostTestEmail.mockResolvedValueOnce({
ok: false,
json: async () => ({ message: 'SMTP verification failed: Connection refused' }),
})
renderDialog()
const sendBtn = screen.getByRole('button', { name: /send test email/i })
fireEvent.click(sendBtn)
await waitFor(() => {
expect(toast.error).toHaveBeenCalledWith('SMTP verification failed: Connection refused')
expect(mockOnClose).not.toHaveBeenCalled()
})
})
it('calls onClose when Cancel button is clicked', () => {
renderDialog()
const cancelBtn = screen.getByRole('button', { name: /cancel/i })
fireEvent.click(cancelBtn)
expect(mockOnClose).toHaveBeenCalled()
})
})
@@ -0,0 +1,106 @@
import { useState, useEffect } from 'react'
import { useMutation } from '@tanstack/react-query'
import { client } from '@/ui/api/client'
import {
Dialog,
DialogContent,
DialogDescription,
DialogFooter,
DialogHeader,
DialogTitle,
} from '@/ui/components/ui/dialog'
import { Input } from '@/ui/components/ui/input'
import { Button } from '@/ui/components/ui/button'
import { Loader2, Send } from 'lucide-react'
import { toast } from 'sonner'
import { m } from '@/ui/paraglide/messages.js'
export interface TestEmailDialogProps {
isOpen: boolean
onClose: () => void
teamId: string
defaultFrom?: string
}
export function TestEmailDialog({
isOpen,
onClose,
teamId,
defaultFrom = '',
}: TestEmailDialogProps) {
const [fromAddress, setFromAddress] = useState(defaultFrom)
useEffect(() => {
if (isOpen) {
setFromAddress(defaultFrom)
}
}, [defaultFrom, isOpen])
const { mutateAsync: sendTestEmail, isPending: isSending } = useMutation({
mutationFn: async (from: string) => {
const res = await client.api.teams[':teamId'].notifications.email.test.$post({
param: { teamId },
json: { from },
})
if (!res.ok) {
const err = (await res.json().catch(() => null)) as { message?: string } | null
throw new Error(err?.message || m.failed_to_send_test_email())
}
return await res.json()
},
})
const handleSend = async () => {
if (!fromAddress.trim()) {
toast.error(m.from_address_required())
return
}
try {
await sendTestEmail(fromAddress.trim())
toast.success(m.test_email_sent_successfully())
onClose()
} catch (err) {
toast.error(err instanceof Error ? err.message : m.failed_to_send_test_email())
}
}
return (
<Dialog open={isOpen} onOpenChange={(open) => !open && onClose()}>
<DialogContent className="sm:max-w-md">
<DialogHeader>
<div className="flex items-center gap-2">
<Send className="w-5 h-5 text-primary" />
<DialogTitle>{m.send_test_email()}</DialogTitle>
</div>
<DialogDescription>{m.send_test_email_dialog_description()}</DialogDescription>
</DialogHeader>
<div className="space-y-4 py-2">
<div className="space-y-2">
<label htmlFor="test-dialog-from-input" className="text-sm font-medium text-foreground">
{m.sender_from()}
</label>
<Input
id="test-dialog-from-input"
value={fromAddress}
onChange={(e) => setFromAddress(e.target.value)}
placeholder="Shumai <noreply@example.com>"
disabled={isSending}
autoFocus
/>
</div>
</div>
<DialogFooter className="gap-2 sm:gap-0">
<Button variant="outline" onClick={onClose} disabled={isSending}>
{m.cancel()}
</Button>
<Button onClick={handleSend} disabled={isSending}>
{isSending && <Loader2 className="w-4 h-4 animate-spin mr-2" />}
{m.send_test_email()}
</Button>
</DialogFooter>
</DialogContent>
</Dialog>
)
}
@@ -45,6 +45,28 @@ function computeResolutions(file: AssetInfo): DisplayTranscode[] {
})
}
function getInitialResolution(resolutions: DisplayTranscode[]): DisplayTranscode | null {
if (resolutions.length === 0) return null
if (typeof window === 'undefined') return resolutions[0]
const prefersHdr =
typeof window.matchMedia === 'function' && window.matchMedia('(dynamic-range: high)').matches
const hasHdr = resolutions.some((r) => r.hdr)
const hasSdr = resolutions.some((r) => !r.hdr)
let candidates = resolutions
if (prefersHdr && hasHdr) {
candidates = resolutions.filter((r) => r.hdr)
} else if (!prefersHdr && hasSdr) {
candidates = resolutions.filter((r) => !r.hdr)
}
const screenWidth = window.innerWidth * (window.devicePixelRatio || 1)
const sorted = [...candidates].sort((a, b) => (a.width ?? 0) - (b.width ?? 0))
const bestFit = sorted.find((r) => (r.width ?? 0) >= screenWidth)
return bestFit || sorted[sorted.length - 1]
}
export const CompareVideoPane = forwardRef<ComparePaneHandle, CompareVideoPaneProps>(
function CompareVideoPane(
{
@@ -66,7 +88,6 @@ export const CompareVideoPane = forwardRef<ComparePaneHandle, CompareVideoPanePr
const videoContainerRef = useRef<HTMLDivElement>(null)
const containerRef = useRef<HTMLDivElement>(null)
const videoRef = useRef<HTMLVideoElement | null>(null)
const [videoHtmlEl, setVideoHtmlEl] = useState<HTMLVideoElement | undefined>(undefined)
const {
isDrawing,
@@ -82,6 +103,7 @@ export const CompareVideoPane = forwardRef<ComparePaneHandle, CompareVideoPanePr
const [pan, setPan] = useState<{ x: number; y: number } | null>(null)
const [isPlaying, setIsPlaying] = useState(false)
const [hasStartedPlaying, setHasStartedPlaying] = useState(false)
const [isLooping, setIsLooping] = useState(false)
const [playbackRate, setPlaybackRate] = useState(1)
const [buffered, setBuffered] = useState(0)
@@ -96,8 +118,9 @@ export const CompareVideoPane = forwardRef<ComparePaneHandle, CompareVideoPanePr
const totalFrames = resolveTotalFrames({ dbTotalFrames, containerDuration, frameRate })
const resolutions = computeResolutions(file)
const initialRes = resolutions[0]
const initialRes = getInitialResolution(resolutions)
const [currentResolution, setCurrentResolution] = useState(initialRes?.resolution ?? '')
const [isCurrentHdr, setIsCurrentHdr] = useState(initialRes?.hdr)
const currentSrcRef = useRef(initialRes?.url)
const isAudio = file.proxyType === 'audio'
@@ -137,8 +160,11 @@ export const CompareVideoPane = forwardRef<ComparePaneHandle, CompareVideoPanePr
// if the parent renders this pane without a per-asset `key`. Runs before the
// video.js init effect below (declaration order) so the ref is fresh.
useEffect(() => {
setCurrentResolution(initialRes?.resolution ?? '')
currentSrcRef.current = initialRes?.url
const res = getInitialResolution(resolutions)
setCurrentResolution(res?.resolution ?? '')
setIsCurrentHdr(res?.hdr)
currentSrcRef.current = res?.url
setHasStartedPlaying(false)
}, [file.id])
// Initialize video.js
@@ -146,7 +172,6 @@ export const CompareVideoPane = forwardRef<ComparePaneHandle, CompareVideoPanePr
if (!videoContainerRef.current) return
const videoElement = document.createElement('video-js')
videoElement.classList.add('vjs-big-play-centered', '!h-full', '!w-full')
videoElement.style.opacity = '0'
videoElement.style.pointerEvents = 'none'
videoContainerRef.current.appendChild(videoElement)
@@ -160,13 +185,11 @@ export const CompareVideoPane = forwardRef<ComparePaneHandle, CompareVideoPanePr
const htmlVid = videoElement.querySelector('video')
if (htmlVid) {
setVideoHtmlEl(htmlVid)
videoRef.current = htmlVid
} else {
player.ready(() => {
const techEl = player.tech({ iWillNotUseThisInPlugins: true })?.el() as HTMLVideoElement
if (techEl) {
setVideoHtmlEl(techEl)
videoRef.current = techEl
}
})
@@ -174,17 +197,20 @@ export const CompareVideoPane = forwardRef<ComparePaneHandle, CompareVideoPanePr
player.on('play', () => {
setIsPlaying(true)
setHasStartedPlaying(true)
onPlay?.()
})
player.on('pause', () => setIsPlaying(false))
player.on('ended', () => setIsPlaying(false))
player.on('loadedmetadata', () => setIsPlayerReady(true))
player.on('loadstart', () => setIsPlayerReady(false))
player.on('timeupdate', () => {
const playerDuration = player.duration() || containerDuration || 0
const bufferedEnd = player.bufferedEnd()
if (playerDuration > 0) setBuffered((bufferedEnd / playerDuration) * 100)
setBuffered(player.bufferedPercent())
})
player.on('loadedmetadata', () => {
setIsPlayerReady(true)
})
player.on('loadstart', () => setIsPlayerReady(false))
player.on('volumechange', () => {
setPlayerVolume(player.volume() || 0)
setPlayerMuted(player.muted() || false)
@@ -223,6 +249,7 @@ export const CompareVideoPane = forwardRef<ComparePaneHandle, CompareVideoPanePr
playbackRate,
isLooping,
currentResolution,
isCurrentHdr,
resolutions,
buffered,
},
@@ -239,6 +266,7 @@ export const CompareVideoPane = forwardRef<ComparePaneHandle, CompareVideoPanePr
playbackRate,
isLooping,
currentResolution,
isCurrentHdr,
buffered,
])
@@ -294,14 +322,20 @@ export const CompareVideoPane = forwardRef<ComparePaneHandle, CompareVideoPanePr
)
const changeResolution = useCallback(
(resolution: string) => {
(resolution: string, hdr?: boolean) => {
const player = playerRef.current
if (!player) return
const target = resolutions.find((r) => r.resolution === resolution)
const target =
hdr !== undefined
? resolutions.find(
(r) => r.resolution === resolution && Boolean(r.hdr) === Boolean(hdr),
)
: resolutions.find((r) => r.resolution === resolution)
if (!target) return
const wasPlaying = !player.paused()
const currentT = player.currentTime()
setCurrentResolution(resolution)
setIsCurrentHdr(target.hdr)
currentSrcRef.current = target.url
player.src({ type: 'video/mp4', src: target.url })
player.one('loadedmetadata', () => {
@@ -334,12 +368,19 @@ export const CompareVideoPane = forwardRef<ComparePaneHandle, CompareVideoPanePr
player.pause()
}
},
seekToFrame: (frame) => seekToFrame(clampFrame(frame)),
seekToFrame: (frame) => {
setHasStartedPlaying(true)
return seekToFrame(clampFrame(frame))
},
seekToSecond: (second) => {
setHasStartedPlaying(true)
const frame = Math.floor(second * frameRate + 0.45)
seekToFrame(clampFrame(frame))
},
stepFrame: (delta) => seekToFrame(clampFrame(currentFrameRef.current + delta)),
stepFrame: (delta) => {
setHasStartedPlaying(true)
return seekToFrame(clampFrame(currentFrameRef.current + delta))
},
setMuted: (m) => playerRef.current?.muted(m),
setVolume: (v) => {
const player = playerRef.current
@@ -420,7 +461,28 @@ export const CompareVideoPane = forwardRef<ComparePaneHandle, CompareVideoPanePr
onClick={handleAreaClick}
data-testid="compare-video-area"
>
<div ref={videoContainerRef} className="absolute inset-0 z-[-1]" />
{/* Native Video Layer (Hardware-accelerated, full HDR EDR) */}
{!isAudio && (
<div
className="absolute pointer-events-none"
style={{
left: 0,
top: 0,
width: vidW,
height: vidH,
transform: `translate(${panX}px, ${panY}px) scale(${scale})`,
transformOrigin: '0 0',
}}
>
<div
ref={videoContainerRef}
className="w-full h-full [&_.video-js]:!w-full [&_.video-js]:!h-full [&_video]:!w-full [&_video]:!h-full [&_video]:!block [&_video]:!object-contain"
/>
</div>
)}
{isAudio && (
<div ref={videoContainerRef} className="absolute inset-0 pointer-events-none opacity-0" />
)}
{isAudio ? (
<div className="flex flex-col items-center justify-center text-muted-foreground w-full h-full pointer-events-none select-none">
@@ -432,13 +494,11 @@ export const CompareVideoPane = forwardRef<ComparePaneHandle, CompareVideoPanePr
/>
</div>
) : (
videoHtmlEl &&
containerSize.width > 0 && (
<DrawingCanvas
width={containerSize.width}
height={containerSize.height}
mediaDimensions={{ width: vidW, height: vidH }}
videoElement={videoHtmlEl}
annotations={displayAnnotations}
scale={scale}
offset={{ x: panX, y: panY }}
@@ -452,8 +512,8 @@ export const CompareVideoPane = forwardRef<ComparePaneHandle, CompareVideoPanePr
)
)}
{!isPlaying && !isDrawing && (
<div className="pointer-events-none absolute inset-0 z-10 flex items-center justify-center bg-black/20">
{!hasStartedPlaying && !isDrawing && (
<div className="pointer-events-none absolute inset-0 z-10 flex items-center justify-center bg-black/20 transition-opacity duration-200">
<div className="flex h-16 w-16 items-center justify-center rounded-full border-2 border-white/30 bg-white/10 backdrop-blur-sm">
<Play className="ml-1 h-8 w-8 fill-white text-white" />
</div>
@@ -93,4 +93,92 @@ describe('MobileVideoControlBar', () => {
fireEvent.click(fsBtn)
expect(toggleFullScreen).toHaveBeenCalledTimes(1)
})
it('renders HDR label on settings button when playing HDR video', () => {
render(
<MobileVideoControlBar
state={{
...defaultState,
currentResolution: '1080p',
isCurrentHdr: true,
}}
zoom={1}
isControlsVisible={true}
buffered={50}
data={mockData}
resolutions={[
{
key: '1080-hdr.mp4',
width: 1920,
height: 1080,
resolution: '1080p',
hdr: true,
} as unknown as DisplayTranscode,
]}
togglePlay={vi.fn()}
toggleLoop={vi.fn()}
toggleMute={vi.fn()}
handleVolumeChange={vi.fn()}
changePlaybackRate={vi.fn()}
changeResolution={vi.fn()}
handleDownload={vi.fn()}
toggleFullScreen={vi.fn()}
onZoomChange={vi.fn()}
onZoomReset={vi.fn()}
frameRate={25}
totalFrames={2500}
currentFrame={250}
seekToFrame={vi.fn()}
/>,
)
const settingsBtn = screen.getByLabelText(/Settings/i)
expect(settingsBtn).toBeDefined()
expect(settingsBtn.textContent).toContain('1080p')
expect(settingsBtn.textContent).toContain('HDR')
})
it('does not render HDR label on settings button when playing SDR video', () => {
render(
<MobileVideoControlBar
state={{
...defaultState,
currentResolution: '1080p',
isCurrentHdr: false,
}}
zoom={1}
isControlsVisible={true}
buffered={50}
data={mockData}
resolutions={[
{
key: '1080.mp4',
width: 1920,
height: 1080,
resolution: '1080p',
hdr: false,
} as unknown as DisplayTranscode,
]}
togglePlay={vi.fn()}
toggleLoop={vi.fn()}
toggleMute={vi.fn()}
handleVolumeChange={vi.fn()}
changePlaybackRate={vi.fn()}
changeResolution={vi.fn()}
handleDownload={vi.fn()}
toggleFullScreen={vi.fn()}
onZoomChange={vi.fn()}
onZoomReset={vi.fn()}
frameRate={25}
totalFrames={2500}
currentFrame={250}
seekToFrame={vi.fn()}
/>,
)
const settingsBtn = screen.getByLabelText(/Settings/i)
expect(settingsBtn).toBeDefined()
expect(settingsBtn.textContent).toContain('1080p')
expect(settingsBtn.textContent).not.toContain('HDR')
})
})
@@ -186,10 +186,19 @@ export const MobileVideoControlBar: React.FC<ControlBarProps> = ({
aria-label={m.settings()}
>
<Settings className="h-3.5 w-3.5" />
<span className="text-[11px]">
{!isAudio && state.currentResolution
? state.currentResolution
: `${state.playbackRate}x`}
<span className="flex items-center gap-1 text-[11px]">
<span>
{!isAudio && state.currentResolution
? state.currentResolution === 'Original'
? m.original()
: state.currentResolution
: `${state.playbackRate}x`}
</span>
{!isAudio && state.isCurrentHdr && (
<span className="px-1 py-0.2 rounded text-[9px] font-bold bg-amber-500/20 text-amber-500 border border-amber-500/30">
{m.hdr()}
</span>
)}
</span>
</button>
</DropdownMenuTrigger>
@@ -199,23 +208,36 @@ export const MobileVideoControlBar: React.FC<ControlBarProps> = ({
<DropdownMenuLabel className="text-[10px] font-bold text-muted-foreground uppercase tracking-wider">
{m.quality()}
</DropdownMenuLabel>
{resolutions.map((res) => (
<DropdownMenuItem
key={res.resolution}
onClick={() => changeResolution(res)}
className={cn(
'flex w-full items-center justify-between text-xs cursor-pointer',
state.currentResolution === res.resolution
? 'text-primary font-medium'
: 'text-foreground',
)}
>
<span>{res.resolution === 'Original' ? m.original() : res.resolution}</span>
<span className="text-[10px] text-muted-foreground">
{res.width}x{res.height}
</span>
</DropdownMenuItem>
))}
{resolutions.map((res) => {
const itemKey = `${res.resolution}-${res.hdr ? 'hdr' : 'sdr'}`
const isSelected =
state.currentResolution === res.resolution &&
Boolean(state.isCurrentHdr) === Boolean(res.hdr)
return (
<DropdownMenuItem
key={itemKey}
onClick={() => changeResolution(res)}
className={cn(
'flex w-full items-center justify-between text-xs cursor-pointer',
isSelected ? 'text-primary font-medium' : 'text-foreground',
)}
>
<div className="flex items-center gap-1.5">
<span>
{res.resolution === 'Original' ? m.original() : res.resolution}
</span>
{res.hdr && (
<span className="px-1 py-0.2 rounded text-[9px] font-bold bg-amber-500/20 text-amber-500 border border-amber-500/30">
{m.hdr()}
</span>
)}
</div>
<span className="text-[10px] text-muted-foreground">
{res.width}x{res.height}
</span>
</DropdownMenuItem>
)
})}
<DropdownMenuSeparator />
</>
)}
@@ -0,0 +1,110 @@
// @vitest-environment happy-dom
import { cleanup, fireEvent, render, screen } from '@testing-library/react'
import React from 'react'
import { afterEach, describe, expect, it, vi } from 'vitest'
import { VideoControlBar } from './video-control-bar'
import type { AssetInfo } from '@shumai/dtos'
import type { DisplayTranscode, PlayerState } from './video-control-bar'
describe('VideoControlBar', () => {
afterEach(() => {
cleanup()
})
const mockData: AssetInfo = {
id: 'video-1',
name: 'sample.mp4',
proxyType: 'video',
media: {
original: { key: 'files/sample.mp4' },
metadata: {
duration: 100,
frameRate: 25,
},
},
} as AssetInfo
const defaultState: PlayerState = {
isPlaying: false,
progress: 10,
currentTime: 10,
duration: 100,
volume: 1,
isMuted: false,
isLooping: false,
playbackRate: 1,
isFullScreen: false,
showFrames: false,
currentResolution: '1080p',
isCurrentHdr: false,
}
const resolutions: DisplayTranscode[] = [
{
key: '1080.mp4',
width: 1920,
height: 1080,
resolution: '1080p',
hdr: false,
} as unknown as DisplayTranscode,
{
key: '1080-hdr.mp4',
width: 1920,
height: 1080,
resolution: '1080p',
hdr: true,
} as unknown as DisplayTranscode,
]
it('renders download menu with HDR badge on HDR download items', async () => {
const handleDownload = vi.fn()
render(
<VideoControlBar
state={defaultState}
zoom={1}
isControlsVisible={true}
buffered={50}
data={mockData}
resolutions={resolutions}
togglePlay={vi.fn()}
toggleLoop={vi.fn()}
toggleMute={vi.fn()}
handleVolumeChange={vi.fn()}
changePlaybackRate={vi.fn()}
changeResolution={vi.fn()}
handleDownload={handleDownload}
toggleFullScreen={vi.fn()}
onZoomChange={vi.fn()}
onZoomReset={vi.fn()}
frameRate={25}
totalFrames={2500}
currentFrame={250}
seekToFrame={vi.fn()}
allowDownload={true}
/>,
)
const downloadTrigger = screen.getByTitle(/Download/i)
expect(downloadTrigger).toBeDefined()
fireEvent.pointerDown(downloadTrigger, { button: 0, ctrlKey: false })
const menuItems = await screen.findAllByRole('menuitem')
// We expect: 1080p SDR, 1080p HDR, and Original
expect(menuItems.length).toBe(3)
const sdrItem = menuItems.find(
(item) => item.textContent?.includes('1080p') && !item.textContent?.includes('HDR'),
)
const hdrItem = menuItems.find(
(item) => item.textContent?.includes('1080p') && item.textContent?.includes('HDR'),
)
expect(sdrItem).toBeDefined()
expect(hdrItem).toBeDefined()
// Clicking HDR item triggers download with HDR key
fireEvent.click(hdrItem!)
expect(handleDownload).toHaveBeenCalledWith('1080-hdr.mp4')
})
})
@@ -43,6 +43,7 @@ export interface PlayerState {
showFrames: boolean // Toggle between time (02:30) and frames (1234)
currentResolution: string // 'Original' or '720p', '480p' etc.
currentSrc?: string
isCurrentHdr?: boolean
}
export type DisplayTranscode = VideoTranscode & { resolution: string }
@@ -317,35 +318,53 @@ export const VideoControlBar: React.FC<ControlBarProps> = ({
{!isAudio && resolutions.length > 0 && (
<DropdownMenu>
<DropdownMenuTrigger asChild>
<button className="flex items-center gap-1 rounded border border-border px-2 py-0.5 text-sm font-semibold hover:bg-muted transition-colors">
<button className="flex items-center gap-1.5 rounded border border-border px-2 py-0.5 text-sm font-semibold hover:bg-muted transition-colors">
<Settings className="h-3.5 w-3.5" />
<span>
{state.currentResolution === 'Original'
? m.original()
: state.currentResolution}
<span className="flex items-center gap-1">
<span>
{state.currentResolution === 'Original'
? m.original()
: state.currentResolution}
</span>
{state.isCurrentHdr && (
<span className="px-1 py-0.2 rounded text-[10px] font-bold bg-amber-500/20 text-amber-500 border border-amber-500/30">
{m.hdr()}
</span>
)}
</span>
</button>
</DropdownMenuTrigger>
<DropdownMenuContent>
<DropdownMenuLabel>{m.quality()}</DropdownMenuLabel>
{resolutions.map((res) => (
<DropdownMenuItem
key={res.resolution}
onClick={() => changeResolution(res)}
className={cn(
'flex w-full items-center justify-between',
state.currentResolution === res.resolution
? 'text-primary font-medium'
: 'text-foreground',
)}
>
<span>{res.resolution === 'Original' ? m.original() : res.resolution}</span>
<span className="pl-5 text-xs text-muted-foreground">
{res.width}x{res.height}
</span>
</DropdownMenuItem>
))}
{resolutions.map((res) => {
const itemKey = `${res.resolution}-${res.hdr ? 'hdr' : 'sdr'}`
const isSelected =
state.currentResolution === res.resolution &&
Boolean(state.isCurrentHdr) === Boolean(res.hdr)
return (
<DropdownMenuItem
key={itemKey}
onClick={() => changeResolution(res)}
className={cn(
'flex w-full items-center justify-between',
isSelected ? 'text-primary font-medium' : 'text-foreground',
)}
>
<div className="flex items-center gap-1.5">
<span>{res.resolution === 'Original' ? m.original() : res.resolution}</span>
{res.hdr && (
<span className="px-1 py-0.2 rounded text-[10px] font-bold bg-amber-500/20 text-amber-500 border border-amber-500/30">
{m.hdr()}
</span>
)}
</div>
<span className="pl-5 text-xs text-muted-foreground">
{res.width}x{res.height}
</span>
</DropdownMenuItem>
)
})}
</DropdownMenuContent>
</DropdownMenu>
)}
@@ -370,16 +389,26 @@ export const VideoControlBar: React.FC<ControlBarProps> = ({
</DropdownMenuTrigger>
<DropdownMenuContent>
<DropdownMenuLabel>{m.download()}</DropdownMenuLabel>
{resolutions.map((res) => (
<DropdownMenuItem
key={res.resolution}
onClick={() => handleDownload(res.key ?? '')}
className="flex w-full items-center justify-between px-3 py-2 text-left text-sm text-foreground"
>
<span>{res.resolution}</span>
<span className="text-xs text-muted-foreground">MP4</span>
</DropdownMenuItem>
))}
{resolutions.map((res) => {
const itemKey = res.key || `${res.resolution}-${res.hdr ? 'hdr' : 'sdr'}`
return (
<DropdownMenuItem
key={itemKey}
onClick={() => handleDownload(res.key ?? '')}
className="flex w-full items-center justify-between px-3 py-2 text-left text-sm text-foreground cursor-pointer"
>
<div className="flex items-center gap-1.5">
<span>{res.resolution}</span>
{res.hdr && (
<span className="px-1 py-0.2 rounded text-[10px] font-bold bg-amber-500/20 text-amber-500 border border-amber-500/30">
{m.hdr()}
</span>
)}
</div>
<span className="text-xs text-muted-foreground">MP4</span>
</DropdownMenuItem>
)
})}
{data.media?.original?.key && (
<>
<DropdownMenuSeparator />
@@ -1,5 +1,5 @@
// @vitest-environment happy-dom
import { cleanup, render } from '@testing-library/react'
import { act, cleanup, render } from '@testing-library/react'
import React from 'react'
import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
import VideoViewer from './video-viewer'
@@ -182,4 +182,191 @@ describe('VideoViewer', () => {
}),
)
})
it('auto-selects HDR proxy when display supports HDR (dynamic-range: high)', () => {
const originalMatchMedia = window.matchMedia
window.matchMedia = vi.fn().mockImplementation((query: string) => ({
matches: query === '(dynamic-range: high)',
media: query,
onchange: null,
addListener: vi.fn(),
removeListener: vi.fn(),
addEventListener: vi.fn(),
removeEventListener: vi.fn(),
dispatchEvent: vi.fn(),
}))
const hdrVideo: AssetInfo = {
id: 'video-hdr',
name: 'video-hdr.mp4',
proxyType: 'video',
media: {
metadata: {
originalWidth: 1920,
originalHeight: 1080,
duration: 10,
frameRate: 30,
totalFrames: 300,
},
videoTranscodes: [
{
resolution: '1080p',
url: 'https://cdn.example.com/video-1080p.mp4',
width: 1920,
height: 1080,
hdr: false,
},
{
resolution: '1080p',
url: 'https://cdn.example.com/video-1080p-hdr.mp4',
width: 1920,
height: 1080,
hdr: true,
},
],
},
} as unknown as AssetInfo
render(<VideoViewer file={hdrVideo} />)
expect(videojsMock).toHaveBeenCalledWith(
expect.anything(),
expect.objectContaining({
sources: [
{
src: 'https://cdn.example.com/video-1080p-hdr.mp4',
type: 'video/mp4',
},
],
}),
)
window.matchMedia = originalMatchMedia
})
it('auto-selects SDR proxy when display does not support HDR', () => {
const originalMatchMedia = window.matchMedia
window.matchMedia = vi.fn().mockImplementation((query: string) => ({
matches: false,
media: query,
onchange: null,
addListener: vi.fn(),
removeListener: vi.fn(),
addEventListener: vi.fn(),
removeEventListener: vi.fn(),
dispatchEvent: vi.fn(),
}))
const hdrVideo: AssetInfo = {
id: 'video-sdr-fallback',
name: 'video-sdr-fallback.mp4',
proxyType: 'video',
media: {
metadata: {
originalWidth: 1920,
originalHeight: 1080,
duration: 10,
frameRate: 30,
totalFrames: 300,
},
videoTranscodes: [
{
resolution: '1080p',
url: 'https://cdn.example.com/video-1080p.mp4',
width: 1920,
height: 1080,
hdr: false,
},
{
resolution: '1080p',
url: 'https://cdn.example.com/video-1080p-hdr.mp4',
width: 1920,
height: 1080,
hdr: true,
},
],
},
} as unknown as AssetInfo
render(<VideoViewer file={hdrVideo} />)
expect(videojsMock).toHaveBeenCalledWith(
expect.anything(),
expect.objectContaining({
sources: [
{
src: 'https://cdn.example.com/video-1080p.mp4',
type: 'video/mp4',
},
],
}),
)
window.matchMedia = originalMatchMedia
})
it('shows play button and darkened overlay initially, but never again after playing (even when paused or scrubbed back to start)', () => {
const listeners: Record<string, () => void> = {}
videojsMock.mockImplementation(() => ({
on: vi.fn((event: string, cb: () => void) => {
listeners[event] = cb
}),
volume: vi.fn(),
duration: vi.fn(() => 10),
currentTime: vi.fn(() => 0),
bufferedEnd: vi.fn(() => 0),
playbackRate: vi.fn(() => 1),
ready: vi.fn(),
dispose: vi.fn(),
isDisposed: vi.fn(() => false),
}))
const testVideo: AssetInfo = {
id: 'test-video-lifecycle',
name: 'test.mp4',
proxyType: 'video',
media: {
metadata: {
originalWidth: 1920,
originalHeight: 1080,
duration: 10,
frameRate: 30,
totalFrames: 300,
},
videoTranscodes: [
{
resolution: '1080p',
url: 'https://cdn.example.com/test-1080p.mp4',
width: 1920,
height: 1080,
},
],
},
} as unknown as AssetInfo
const { container } = render(<VideoViewer file={testVideo} />)
const videoArea = container.querySelector('[data-testid="video-area"]')
expect(videoArea).toBeTruthy()
// 1. Initially (before playing): play button & 20% black tint are present
expect(videoArea?.querySelector('.bg-black\\/20')).not.toBeNull()
// 2. Start playback
act(() => {
listeners['play']?.()
})
expect(videoArea?.querySelector('.bg-black\\/20')).toBeNull()
// 3. Pause video: overlay must NOT show again
act(() => {
listeners['pause']?.()
})
expect(videoArea?.querySelector('.bg-black\\/20')).toBeNull()
// 4. Drag seekbar / time back to 0: overlay must STILL NOT show
act(() => {
listeners['timeupdate']?.()
})
expect(videoArea?.querySelector('.bg-black\\/20')).toBeNull()
})
})
@@ -54,17 +54,30 @@ const VideoViewer = React.forwardRef<MediaController, FileViewerProps>(
// We use a container ref to manually append the video element
const videoContainerRef = useRef<HTMLDivElement>(null)
// Logic to select best resolution based on screen size
// Logic to select best resolution based on screen size and dynamic range
const getInitialResolution = (): DisplayTranscode | null => {
if (resolutions.length === 0) return null
if (typeof window === 'undefined') return resolutions[0]
const prefersHdr =
typeof window.matchMedia === 'function' &&
window.matchMedia('(dynamic-range: high)').matches
const hasHdr = resolutions.some((r) => r.hdr)
const hasSdr = resolutions.some((r) => !r.hdr)
let candidateResolutions = resolutions
if (prefersHdr && hasHdr) {
candidateResolutions = resolutions.filter((r) => r.hdr)
} else if (!prefersHdr && hasSdr) {
candidateResolutions = resolutions.filter((r) => !r.hdr)
}
// Use device pixel ratio for high DPI screens
const screenWidth = window.innerWidth * (window.devicePixelRatio || 1)
// 1. Sort by width ascending
const sortedResolutions = [...resolutions].sort((a, b) => {
const sortedResolutions = [...candidateResolutions].sort((a, b) => {
const wA = a.width ?? 0
const wB = b.width ?? 0
return wA - wB
@@ -93,7 +106,9 @@ const VideoViewer = React.forwardRef<MediaController, FileViewerProps>(
showFrames: false,
currentResolution: initialRes?.resolution ?? '',
currentSrc: initialRes?.url ?? '',
isCurrentHdr: initialRes?.hdr ?? false,
})
const [hasStartedPlaying, setHasStartedPlaying] = useState(false)
const containerRef = useRef<HTMLDivElement>(null)
const rootRef = useRef<HTMLDivElement>(null)
const controlsTimeoutRef = useRef<ReturnType<typeof setTimeout> | null>(null)
@@ -110,6 +125,7 @@ const VideoViewer = React.forwardRef<MediaController, FileViewerProps>(
}
},
seekTo: (second: number) => {
setHasStartedPlaying(true)
if (localPlayerRef.current) {
localPlayerRef.current.currentTime(second)
}
@@ -140,11 +156,13 @@ const VideoViewer = React.forwardRef<MediaController, FileViewerProps>(
duration: data.media?.metadata?.duration || 0,
currentResolution: res?.resolution ?? '',
currentSrc: res?.url ?? '',
isCurrentHdr: res?.hdr ?? false,
}))
setHasManuallyZoomed(false)
setIsPlayerReady(false)
setBuffered(0)
lastProcessedStartTimeRef.current = null
setHasStartedPlaying(false)
}, [data.id, Boolean(initialRes?.url)])
const vidW = data.media?.metadata?.originalWidth || 1920
@@ -246,6 +264,14 @@ const VideoViewer = React.forwardRef<MediaController, FileViewerProps>(
const totalFrames = resolveTotalFrames({ dbTotalFrames, containerDuration, frameRate })
const { currentFrame, seekToFrame } = useFramePlayer(videoRef, frameRate, totalFrames, isAudio)
const handleSeekToFrame = useCallback(
(frame: number) => {
setHasStartedPlaying(true)
return seekToFrame(frame)
},
[seekToFrame],
)
const currentTime = currentFrame / frameRate
const duration = totalFrames / frameRate
const progress = duration > 0 ? (currentTime / duration) * 100 : 0
@@ -284,8 +310,7 @@ const VideoViewer = React.forwardRef<MediaController, FileViewerProps>(
const videoElement = document.createElement('video-js')
videoElement.classList.add('vjs-big-play-centered', '!h-full', '!w-full')
// Hide it, but keep it in DOM
videoElement.style.opacity = '0'
// Keep it in DOM, enable visible rendering
videoElement.style.pointerEvents = 'none'
// Append to our container
@@ -348,6 +373,7 @@ const VideoViewer = React.forwardRef<MediaController, FileViewerProps>(
player.on('play', () => {
setState((p) => ({ ...p, isPlaying: true }))
setHasStartedPlaying(true)
onPlay?.()
})
player.on('pause', () => {
@@ -413,6 +439,7 @@ const VideoViewer = React.forwardRef<MediaController, FileViewerProps>(
if (startTime !== lastProcessedStartTimeRef.current) {
lastProcessedStartTimeRef.current = startTime
const targetFrame = Math.floor(startTime * frameRate + 0.45)
setHasStartedPlaying(true)
seekToFrame(targetFrame)
}
}
@@ -600,6 +627,7 @@ const VideoViewer = React.forwardRef<MediaController, FileViewerProps>(
...prev,
currentResolution: res.resolution,
currentSrc: res.url,
isCurrentHdr: res.hdr ?? false,
}))
player.src({ type: 'video/mp4', src: res.url })
@@ -758,8 +786,31 @@ const VideoViewer = React.forwardRef<MediaController, FileViewerProps>(
data-vjs-player
data-testid="video-area"
>
{/* Hidden VideoJS container */}
<div ref={videoContainerRef} className="absolute inset-0 z-[-1]" />
{/* Native Video Layer (Hardware-accelerated, full HDR EDR) */}
{!isAudio && (
<div
className="absolute pointer-events-none"
style={{
left: 0,
top: 0,
width: vidW,
height: vidH,
transform: `translate(${pan.x}px, ${pan.y}px) scale(${scale})`,
transformOrigin: '0 0',
}}
>
<div
ref={videoContainerRef}
className="w-full h-full [&_.video-js]:!w-full [&_.video-js]:!h-full [&_video]:!w-full [&_video]:!h-full [&_video]:!block [&_video]:!object-contain"
/>
</div>
)}
{isAudio && (
<div
ref={videoContainerRef}
className="absolute inset-0 pointer-events-none opacity-0"
/>
)}
{isAudio ? (
<div className="flex flex-col items-center justify-center text-muted-foreground w-full h-full pointer-events-none select-none">
@@ -771,8 +822,7 @@ const VideoViewer = React.forwardRef<MediaController, FileViewerProps>(
/>
</div>
) : (
/* Drawing Canvas (Visible) */
videoHtmlEl &&
/* Drawing Canvas (Transparent Overlay for annotations) */
containerSize.width > 0 && (
<DrawingCanvas
width={containerSize.width}
@@ -781,7 +831,6 @@ const VideoViewer = React.forwardRef<MediaController, FileViewerProps>(
width: vidW,
height: vidH,
}}
videoElement={videoHtmlEl}
annotations={displayAnnotations}
scale={scale}
offset={pan}
@@ -798,10 +847,10 @@ const VideoViewer = React.forwardRef<MediaController, FileViewerProps>(
)
)}
{/* Big Play Button Overlay (when paused) */}
{!state.isPlaying && !isDrawing && (
<div className="absolute inset-0 flex items-center justify-center bg-black/20 pointer-events-none z-10">
<div className="w-20 h-20 bg-white/10 backdrop-blur-sm rounded-full flex items-center justify-center border-2 border-white/30 animate-pulse">
{/* Initial Big Play Button Overlay (shown only before playback starts) */}
{!hasStartedPlaying && !isDrawing && (
<div className="absolute inset-0 flex items-center justify-center bg-black/20 pointer-events-none z-10 transition-opacity duration-200">
<div className="w-20 h-20 bg-white/10 backdrop-blur-sm rounded-full flex items-center justify-center border-2 border-white/30">
<Play className="w-10 h-10 text-white ml-1 fill-white" />
</div>
</div>
@@ -830,7 +879,7 @@ const VideoViewer = React.forwardRef<MediaController, FileViewerProps>(
frameRate={frameRate}
totalFrames={totalFrames}
currentFrame={currentFrame}
seekToFrame={seekToFrame}
seekToFrame={handleSeekToFrame}
onMouseEnter={handleControlsMouseEnter}
onMouseLeave={handleControlsMouseLeave}
allowDownload={allowDownload}
@@ -856,7 +905,7 @@ const VideoViewer = React.forwardRef<MediaController, FileViewerProps>(
frameRate={frameRate}
totalFrames={totalFrames}
currentFrame={currentFrame}
seekToFrame={seekToFrame}
seekToFrame={handleSeekToFrame}
onMouseEnter={handleControlsMouseEnter}
onMouseLeave={handleControlsMouseLeave}
allowDownload={allowDownload}
+36 -1
View File
@@ -260,11 +260,13 @@
"hardware_acceleration_off": "Disabled (Software)",
"hardware_acceleration_off_description": "Uses software libx264 encoder with constant rate factor (CRF).",
"hardware_acceleration_auto": "Auto Detect",
"hardware_acceleration_auto_description": "Automatically probes and uses GPU/Hardware acceleration (NVENC, QSV, AMF, VideoToolbox). If hardware acceleration is unsupported on the host, video transcoding may fail.",
"hardware_acceleration_auto_description": "Automatically probes and uses GPU/Hardware acceleration (NVENC, QSV, VA-API, AMF, VideoToolbox). If hardware acceleration is unsupported on the host, video transcoding may fail.",
"ffmpeg_threads": "FFmpeg Threads",
"ffmpeg_threads_description": "Maximum number of CPU threads used by FFmpeg during transcoding. Set to 0 for Auto.",
"threads_auto": "Auto",
"threads_count": "{count} threads",
"hdr": "HDR",
"sdr": "SDR",
"notification_settings": "Notification Settings",
"notifications_description": "Configure your personal notification preferences for this team.",
@@ -293,6 +295,39 @@
"kanban_comments": "Kanban Comments",
"when_kanban_task_commented": "When someone comments on a task",
"email_notifications": "Email Notifications",
"email_notifications_description": "Configure SMTP settings for sending email notifications to team members.",
"enable_email_notifications": "Enable Email Notifications",
"enable_email_notifications_description": "Send email notifications for comments, mentions, uploads, and other team activity.",
"smtp_settings": "SMTP Server Settings",
"smtp_host": "SMTP Host",
"smtp_host_placeholder": "e.g. smtp.example.com",
"smtp_port": "SMTP Port",
"smtp_username": "Username",
"smtp_username_placeholder": "e.g. user@example.com",
"smtp_password": "Password",
"smtp_password_placeholder": "Enter SMTP password",
"smtp_password_keep_placeholder": "•••••••• (Leave blank to keep current)",
"smtp_secure": "SSL / TLS (SMTPS)",
"smtp_secure_description": "Connect directly over SSL/TLS (commonly used with port 465).",
"smtp_ignore_cert": "Ignore Certificate Errors",
"smtp_ignore_cert_description": "Allow self-signed or unverified SSL/TLS certificates.",
"sender_settings": "Sender Information",
"sender_from": "From Address",
"sender_from_description": "Sender email address, for example: \"Shumai <noreply@example.com>\". Make sure to use an address you're allowed to send emails from.",
"sender_reply_to": "Reply-To Address",
"sender_reply_to_description": "Optional address where replies to notifications should be directed.",
"save_and_send_test_email": "Save & Send Test Email",
"send_test_email": "Send Test Email",
"send_test_email_dialog_description": "Sender email address, for example: \"Shumai <noreply@example.com>\". Make sure to use an address you're allowed to send emails from.",
"test_email_sent_successfully": "Test email sent successfully",
"failed_to_send_test_email": "Failed to send test email",
"email_settings_saved": "Email settings saved successfully",
"failed_to_save_email_settings": "Failed to save email settings",
"failed_to_load_email_settings": "Failed to load email settings",
"smtp_host_required": "SMTP Host is required",
"from_address_required": "From address is required",
"api_tokens": "API Tokens",
"api_tokens_description": "Generate and manage API tokens. These tokens allow you or your agents to run terminal commands via shumai-cli.",
"developer_settings": "Developer Settings",
+36 -1
View File
@@ -260,11 +260,13 @@
"hardware_acceleration_off": "已禁用 (软件编码)",
"hardware_acceleration_off_description": "使用 CPU 的 libx264 软件编码器及 CRF 恒定画质模式。",
"hardware_acceleration_auto": "自动检测",
"hardware_acceleration_auto_description": "自动检测并使用 GPU/硬件加速(NVENC、QSV、AMF、VideoToolbox)。若宿主硬件不支持加速,视频转码可能会失败。",
"hardware_acceleration_auto_description": "自动检测并使用 GPU/硬件加速(NVENC、QSV、VA-API、AMF、VideoToolbox)。若宿主硬件不支持加速,视频转码可能会失败。",
"ffmpeg_threads": "FFmpeg 线程数",
"ffmpeg_threads_description": "FFmpeg 转码时使用的最大 CPU 线程数。设置为 0 表示自动。",
"threads_auto": "自动",
"threads_count": "{count} 线程",
"hdr": "HDR",
"sdr": "SDR",
"notification_settings": "通知设置",
"notifications_description": "配置您在此团队的个人通知偏好。",
@@ -293,6 +295,39 @@
"kanban_comments": "看板评论",
"when_kanban_task_commented": "当有人在任务中发表评论时",
"email_notifications": "邮件通知",
"email_notifications_description": "配置用于向团队成员发送邮件通知的 SMTP 设置。",
"enable_email_notifications": "启用邮件通知",
"enable_email_notifications_description": "当有评论、提及、上传及其他团队活动时发送邮件通知。",
"smtp_settings": "SMTP 服务器设置",
"smtp_host": "SMTP 主机",
"smtp_host_placeholder": "例如 smtp.example.com",
"smtp_port": "SMTP 端口",
"smtp_username": "用户名",
"smtp_username_placeholder": "例如 user@example.com",
"smtp_password": "密码",
"smtp_password_placeholder": "输入 SMTP 密码",
"smtp_password_keep_placeholder": "••••••••(留空以保持当前密码)",
"smtp_secure": "SSL / TLS (SMTPS)",
"smtp_secure_description": "直接使用 SSL/TLS 连接(通常用于 465 端口)。",
"smtp_ignore_cert": "忽略证书错误",
"smtp_ignore_cert_description": "允许自签名或未验证的 SSL/TLS 证书。",
"sender_settings": "发件人信息",
"sender_from": "发件人地址",
"sender_from_description": "发件人邮箱地址,例如:“Shumai <noreply@example.com>”。请确保使用您有权使用的邮箱地址进行发送。",
"sender_reply_to": "回复地址",
"sender_reply_to_description": "通知邮件回复时指向的可选邮箱地址。",
"save_and_send_test_email": "保存并发送测试邮件",
"send_test_email": "发送测试邮件",
"send_test_email_dialog_description": "发件人邮箱地址,例如:“Shumai <noreply@example.com>”。请确保使用您有权使用的邮箱地址进行发送。",
"test_email_sent_successfully": "测试邮件发送成功",
"failed_to_send_test_email": "发送测试邮件失败",
"email_settings_saved": "邮件设置已保存",
"failed_to_save_email_settings": "保存邮件设置失败",
"failed_to_load_email_settings": "加载邮件设置失败",
"smtp_host_required": "必须提供 SMTP 主机",
"from_address_required": "必须提供发件人地址",
"api_tokens": "API 令牌",
"api_tokens_description": "生成和管理 API 令牌。这些令牌允许您或您的智能体通过 shumai-cli 运行终端命令。",
"developer_settings": "开发者设置",
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@shumai/webui",
"version": "0.4.7",
"version": "0.4.9",
"private": true,
"type": "module",
"main": "./index.html",
@@ -300,6 +300,7 @@ function FileViewPage() {
key: t.key,
width: t.width,
height: t.height,
hdr: t.hdr,
})),
},
versions: versionsDataList,
@@ -15,6 +15,7 @@ import { NotificationSettings } from '@/ui/components/settings/NotificationSetti
import { DeveloperSettings } from '@/ui/components/settings/DeveloperSettings'
import { QuotasSettings } from '@/ui/components/settings/QuotasSettings'
import { AppearanceSettings } from '@/ui/components/settings/AppearanceSettings'
import { EmailNotificationSettings } from '@/ui/components/settings/EmailNotificationSettings'
import { ImageVideoGenerationSettings } from '@/ui/components/settings/ImageVideoGenerationSettings'
import { Card, CardContent, CardDescription, CardHeader, CardTitle } from '@/ui/components/ui/card'
import { Slider } from '@/ui/components/ui/slider'
@@ -25,6 +26,7 @@ import {
Cpu,
Film,
Loader2,
Mail,
Puzzle,
Server,
Shield,
@@ -57,6 +59,7 @@ type SettingsTab =
| 'transcode'
| 'quotas'
| 'appearance'
| 'email'
| 'skills'
| 'mcp'
| 'providers'
@@ -71,6 +74,7 @@ const VALID_SETTINGS_TABS: readonly SettingsTab[] = [
'transcode',
'quotas',
'appearance',
'email',
'skills',
'mcp',
'providers',
@@ -173,6 +177,7 @@ function TeamSettingsPage() {
'transcode',
'quotas',
'appearance',
'email',
'providers',
'image-video',
'skills',
@@ -468,6 +473,22 @@ function TeamSettingsPage() {
<div className="ml-auto w-1.5 h-1.5 rounded-full bg-sidebar-primary" />
)}
</button>
<button
onClick={() => handleTabChange('email')}
className={cn(
'w-full flex items-center gap-3 px-4 py-3 text-sm font-medium rounded-lg transition-all',
activeTab === 'email'
? 'bg-sidebar-accent text-sidebar-accent-foreground ring-1 ring-sidebar-border'
: 'text-sidebar-foreground/75 hover:bg-sidebar-accent hover:text-sidebar-accent-foreground',
)}
>
<Mail className="w-5 h-5" />
{m.email_notifications()}
{activeTab === 'email' && (
<div className="ml-auto w-1.5 h-1.5 rounded-full bg-sidebar-primary" />
)}
</button>
</>
)}
@@ -588,6 +609,7 @@ function TeamSettingsPage() {
{activeTab === 'transcode' && m.media_processing()}
{activeTab === 'quotas' && m.resource_quotas()}
{activeTab === 'appearance' && m.appearance_settings()}
{activeTab === 'email' && m.email_notifications()}
{activeTab === 'skills' && m.skills_management()}
{activeTab === 'mcp' && m.mcp_servers()}
{activeTab === 'providers' && m.ai_providers()}
@@ -602,6 +624,7 @@ function TeamSettingsPage() {
{activeTab === 'transcode' && m.transcode_description()}
{activeTab === 'quotas' && m.resource_quotas_description()}
{activeTab === 'appearance' && m.appearance_settings_description()}
{activeTab === 'email' && m.email_notifications_description()}
{activeTab === 'skills' && m.skills_description()}
{activeTab === 'mcp' && m.mcp_servers_description()}
{activeTab === 'providers' && m.providers_description()}
@@ -908,6 +931,8 @@ function TeamSettingsPage() {
{activeTab === 'quotas' && <QuotasSettings teamId={teamId} />}
{activeTab === 'appearance' && <AppearanceSettings teamId={teamId} />}
{activeTab === 'email' && <EmailNotificationSettings teamId={teamId} />}
</div>
</div>
</main>
+1
View File
@@ -23,6 +23,7 @@ export interface TopNavProjectState {
key: string
width: number
height: number
hdr?: boolean
}>
}
versions?: Array<{
+1 -1
View File
@@ -1 +1 @@
export const APP_VERSION = '0.4.7'
export const APP_VERSION = '0.4.9'
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@shumai/workflow-core",
"version": "0.4.7",
"version": "0.4.9",
"private": true,
"type": "module",
"main": "./src/index.ts",
+14
View File
@@ -2,6 +2,20 @@
set -e
if [ "$(id -u)" = "0" ]; then
# Ensure the bun user has permissions to access mounted GPU and accelerator devices
# (/dev/dri/* for VA-API/QSV, /dev/rga, /dev/mpp_service, /dev/dma_heap/* for RKMPP, /dev/dxg for WSL2)
for dev in /dev/dri/* /dev/rga /dev/mpp_service /dev/dma_heap/* /dev/dxg; do
if [ -e "$dev" ]; then
gid=$(stat -c '%g' "$dev" 2>/dev/null || true)
if [ -n "$gid" ] && [ "$gid" != "0" ]; then
if ! getent group "$gid" >/dev/null 2>&1; then
groupadd -g "$gid" "hwaccel_group_$gid" 2>/dev/null || true
fi
usermod -a -G "$gid" bun 2>/dev/null || true
fi
fi
done
# Check if /app/data exists and is not owned by the bun user (UID 1000)
if [ -d "/app/data" ]; then
if [ "$(stat -c '%u' /app/data)" != "1000" ]; then
+163
View File
@@ -0,0 +1,163 @@
import { describe, expect, it } from 'vitest'
import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs'
import { join, resolve } from 'node:path'
import { tmpdir } from 'node:os'
import {
formatChangelogDate,
generateMdxChangelog,
parseChangelogReleases,
syncDocsChangelog,
} from './generate-docs-changelog'
describe('generate-docs-changelog', () => {
describe('formatChangelogDate', () => {
it('formats YYYY-MM-DD into Month D, YYYY', () => {
expect(formatChangelogDate('2026-09-19')).toBe('September 19, 2026')
expect(formatChangelogDate('2026-01-05')).toBe('January 5, 2026')
expect(formatChangelogDate('2025-12-31')).toBe('December 31, 2025')
})
it('returns empty string for undefined or empty date', () => {
expect(formatChangelogDate(undefined)).toBe('')
expect(formatChangelogDate('')).toBe('')
})
it('returns original string if format is not YYYY-MM-DD', () => {
expect(formatChangelogDate('September 2026')).toBe('September 2026')
})
})
describe('parseChangelogReleases', () => {
const sampleChangelog = `# Changelog
All notable changes documented here.
## [Unreleased]
### Added
- In progress feature
## [0.4.7] - 2026-09-19
### Added
- Feature 1
- Feature 2
### Fixed
- Bug 1
## [0.4.6] - 2026-09-17
### Added
- Feature 3
## [0.0.1]
### Added
- Initial release
`
it('parses releases and skips [Unreleased]', () => {
const releases = parseChangelogReleases(sampleChangelog)
expect(releases).toHaveLength(3)
expect(releases[0]).toEqual({
version: '0.4.7',
date: '2026-09-19',
content: '### Added\n- Feature 1\n- Feature 2\n\n### Fixed\n- Bug 1',
})
expect(releases[1]).toEqual({
version: '0.4.6',
date: '2026-09-17',
content: '### Added\n- Feature 3',
})
expect(releases[2]).toEqual({
version: '0.0.1',
date: undefined,
content: '### Added\n- Initial release',
})
})
it('returns empty array for empty changelog', () => {
expect(parseChangelogReleases('')).toEqual([])
})
})
describe('generateMdxChangelog', () => {
it('generates valid Mintlify MDX with <Update> tags', () => {
const releases = [
{
version: '0.4.7',
date: '2026-09-19',
content: '### Added\n- Feature A',
},
{
version: '0.4.6',
content: '### Fixed\n- Bug B',
},
]
const mdx = generateMdxChangelog(releases)
expect(mdx).toContain('title: "Changelog"')
expect(mdx).toContain(
'description: "Recent updates, new features, and improvements in Shumai"',
)
expect(mdx).toContain('<Update label="v0.4.7" description="September 19, 2026">')
expect(mdx).toContain('### Added\n- Feature A')
expect(mdx).toContain('<Update label="v0.4.6">')
expect(mdx).toContain('### Fixed\n- Bug B')
expect(mdx).toContain('</Update>')
})
})
describe('syncDocsChangelog', () => {
const tempDir = join(tmpdir(), `test-sync-docs-changelog-${Date.now()}`)
const changelogPath = join(tempDir, 'CHANGELOG.md')
const outputPath = join(tempDir, 'changelog.mdx')
it('generates MDX and supports check mode', () => {
const sample = `## [0.1.0] - 2026-01-01\n\n- First version`
// Create temp dir
mkdirSync(tempDir, { recursive: true })
writeFileSync(changelogPath, sample, 'utf-8')
// Check before generating should return false
expect(syncDocsChangelog({ changelogPath, outputPath, check: true })).toBe(false)
// Sync should generate output
syncDocsChangelog({ changelogPath, outputPath })
expect(existsSync(outputPath)).toBe(true)
const content = readFileSync(outputPath, 'utf-8')
expect(content).toContain('<Update label="v0.1.0" description="January 1, 2026">')
// Check after generating should return true
expect(syncDocsChangelog({ changelogPath, outputPath, check: true })).toBe(true)
// Clean up
rmSync(tempDir, { recursive: true, force: true })
})
})
describe('Integration with repository CHANGELOG.md', () => {
it('successfully parses the actual repository CHANGELOG.md', () => {
const changelogPath = resolve(__dirname, '../CHANGELOG.md')
const content = readFileSync(changelogPath, 'utf-8')
const releases = parseChangelogReleases(content)
expect(releases.length).toBeGreaterThan(40)
const release047 = releases.find((r) => r.version === '0.4.7')
expect(release047).toBeDefined()
expect(release047?.date).toBe('2026-09-19')
expect(release047?.content).toContain('Introduce Keep a Changelog support')
const mdx = generateMdxChangelog(releases)
expect(mdx).toContain('<Update label="v0.4.7" description="September 19, 2026">')
expect(mdx).toContain('<Update label="v0.0.1" description="June 12, 2026">')
})
})
})

Some files were not shown because too many files have changed in this diff Show More