From a5ad5ef77c81315415d05dfdb0b0c6145696ced5 Mon Sep 17 00:00:00 2001
From: donutinit <64450412+donutinit@users.noreply.github.com>
Date: Wed, 30 Sep 2026 11:08:31 -0600
Subject: [PATCH] Photo-only delivery and a gallery page for photo share links
---
docs/wiki/Admin-Settings.md | 1 +
docs/wiki/Client-Guide.md | 9 +
docs/wiki/Features.md | 1 +
docs/wiki/Usage-Guide.md | 2 +
.../migration.sql | 1 +
prisma/schema.prisma | 1 +
src/app/admin/projects/[id]/settings/page.tsx | 21 +
src/app/admin/projects/[id]/share/page.tsx | 36 +-
src/app/api/comments/route.ts | 13 +-
src/app/api/content/[token]/route.ts | 5 +
src/app/api/content/zip/[token]/route.ts | 5 +
src/app/api/projects/[id]/approve/route.ts | 8 +-
src/app/api/projects/[id]/notify/route.ts | 18 +-
src/app/api/projects/[id]/route.ts | 4 +
src/app/api/share/[token]/comments/route.ts | 6 +-
.../share/[token]/download-all-token/route.ts | 9 +
src/app/api/share/[token]/route.ts | 7 +-
.../api/share/[token]/video-token/route.ts | 7 +-
.../assets/[assetId]/download-token/route.ts | 5 +
.../api/videos/[id]/assets/[assetId]/route.ts | 5 +
.../[id]/assets/download-zip-token/route.ts | 5 +
.../videos/[id]/assets/download-zip/route.ts | 5 +
src/app/api/videos/[id]/assets/route.ts | 5 +
.../api/videos/[id]/client-assets/route.ts | 15 +
.../api/videos/[id]/download-token/route.ts | 5 +
src/app/api/videos/[id]/download/route.ts | 5 +
src/app/share/[token]/SharePageClient.tsx | 43 +-
src/components/LanguageToggle.tsx | 13 +-
src/components/PhotoDeliveryGallery.tsx | 516 ++++++++++++++++++
src/components/PhotoLightbox.tsx | 140 ++++-
src/components/ProjectActions.tsx | 52 +-
src/components/SharePhotoSection.tsx | 165 +-----
src/components/ThemeToggle.tsx | 18 +-
src/hooks/useAlbumGallery.ts | 211 +++++++
src/lib/comment-helpers.ts | 11 +-
src/lib/email.ts | 10 +-
src/lib/notifications.ts | 18 +-
src/lib/s3-upload-auth.ts | 4 +-
src/lib/validation.ts | 3 +
src/locales/de.json | 6 +
src/locales/en.json | 6 +
src/locales/nl.json | 6 +
src/pages/api/uploads/[[...path]].ts | 4 +-
src/worker/client-notifications.ts | 11 +
44 files changed, 1226 insertions(+), 215 deletions(-)
create mode 100644 prisma/migrations/20260930120000_add_photo_only_share/migration.sql
create mode 100644 src/components/PhotoDeliveryGallery.tsx
create mode 100644 src/hooks/useAlbumGallery.ts
diff --git a/docs/wiki/Admin-Settings.md b/docs/wiki/Admin-Settings.md
index 240703b2..ecf6d5e4 100644
--- a/docs/wiki/Admin-Settings.md
+++ b/docs/wiki/Admin-Settings.md
@@ -179,6 +179,7 @@ Subscribe to project deadlines from any calendar app (Google Calendar, Apple Cal
- Guest mode: view-only access without credentials.
- Guest latest only: restrict guests to the latest version of each video (default: true).
- Show photo albums to guests: guests can view photo albums; downloads stay disabled for guests (default: false).
+- Photo-only delivery: the share link becomes a photo gallery and never exposes the project's videos. Recipients cannot see, stream, comment on, approve or download them, and video links handed out before the switch was turned on stop working. Admins keep full access (default: false).
**Workflow**
- Revision limit (enable/disable with max revisions count).
diff --git a/docs/wiki/Client-Guide.md b/docs/wiki/Client-Guide.md
index c621de8e..302b4c68 100644
--- a/docs/wiki/Client-Guide.md
+++ b/docs/wiki/Client-Guide.md
@@ -182,6 +182,15 @@ If the project contains photos, albums appear below the videos (for guests only
- Select multiple photos (checkbox on each thumbnail) to download just those.
- If the admin has enabled photo downloads, you can download your selection, the whole album, or all project photos as a ZIP. Photo downloads are never available in guest mode.
+### Photo galleries
+
+When a share link delivers photos only (the project has no videos, or the admin turned on photo-only delivery), it opens straight into a gallery instead of the overview:
+
+- A full-screen cover with the project title; **View Gallery** scrolls down to the photos.
+- The first album is already open. With several albums, they appear as tabs under the title; click one to switch. The address bar keeps the open album, so a copied link opens the same one.
+- Photos sit in a masonry grid that keeps their original proportions. Click one to open the lightbox; use the arrow keys, or swipe on touch screens.
+- With photo downloads enabled, the **Download** button in the top bar saves the open album or every album as a ZIP. With a mouse, hovering a photo shows a single-photo download and a circle that adds it to a selection you can download from the bar at the bottom. On touch screens, download single photos from the lightbox.
+
## Downloading
Download options appear after a video has been approved (not available in guest mode):
diff --git a/docs/wiki/Features.md b/docs/wiki/Features.md
index 647378f3..b4237c8d 100644
--- a/docs/wiki/Features.md
+++ b/docs/wiki/Features.md
@@ -15,6 +15,7 @@
- Video version comparison: side-by-side and slider overlay modes with synced playback.
- Photo galleries: per-project albums with automatic webp thumbnails, admin-selectable covers, and a full-page client album view with lightbox and multi-select. Dropping folders onto the Photos section creates an album per folder.
- Photo zip downloads on the share page (selected photos, one album, or the whole project), gated by a per-project toggle.
+- Photo delivery gallery: share links with photos and no videos open on a full-screen cover with the albums as tabs and a masonry grid. A per-project photo-only switch keeps a project's videos off the share link entirely.
- Recipient portal at `/portal`: recipients sign in with a magic link and see all active projects they are assigned to in one place.
- Loop playback toggle in the video player.
- Grid/list view toggle on the share page, applying to both videos and photo albums.
diff --git a/docs/wiki/Usage-Guide.md b/docs/wiki/Usage-Guide.md
index 8c8dd484..2ff8df58 100644
--- a/docs/wiki/Usage-Guide.md
+++ b/docs/wiki/Usage-Guide.md
@@ -124,6 +124,8 @@ Projects can hold photo albums alongside videos — useful for stills, BTS shots
**Client side:** albums appear on the share page below the videos, with a full-page album view, lightbox, and multi-select. To let clients download photos (selection, album, or all project photos as a ZIP), enable **Allow photo downloads** in the project settings.
+**Photo deliveries:** a share link that carries photos but no videos opens as a gallery: a full-screen cover, the albums as tabs, and a masonry grid with the first album already open. To deliver only photos from a project that also holds videos, enable **Photo-only delivery** in the project settings (Client Share Page). The link then exposes no video at all (page, streams, downloads, comments or approval), while you keep working on the videos in the admin area. Notifications sent for a photo-only project always announce the whole gallery.
+
## Recipient portal
Recipients added to projects can use the portal at `/portal` to see all their active projects in one place:
diff --git a/prisma/migrations/20260930120000_add_photo_only_share/migration.sql b/prisma/migrations/20260930120000_add_photo_only_share/migration.sql
new file mode 100644
index 00000000..218d5572
--- /dev/null
+++ b/prisma/migrations/20260930120000_add_photo_only_share/migration.sql
@@ -0,0 +1 @@
+ALTER TABLE "Project" ADD COLUMN "photoOnlyShare" BOOLEAN NOT NULL DEFAULT false;
diff --git a/prisma/schema.prisma b/prisma/schema.prisma
index 52f30109..535f4d6b 100644
--- a/prisma/schema.prisma
+++ b/prisma/schema.prisma
@@ -92,6 +92,7 @@ model Project {
allowClientAssetUpload Boolean @default(false) // Allow clients to upload file attachments on comments
clientCanApprove Boolean @default(true) // Allow clients to approve videos (false = admin only)
allowReverseShare Boolean @default(false) // Allow clients to upload files directly to the project (reverse share)
+ photoOnlyShare Boolean @default(false) // Photo-only delivery: the share link serves photo albums only; videos stay admin-side
// Approved playback settings
usePreviewForApprovedPlayback Boolean @default(false) // Use browser-compatible preview instead of original after approval
diff --git a/src/app/admin/projects/[id]/settings/page.tsx b/src/app/admin/projects/[id]/settings/page.tsx
index caefd0a8..d3d9005c 100644
--- a/src/app/admin/projects/[id]/settings/page.tsx
+++ b/src/app/admin/projects/[id]/settings/page.tsx
@@ -54,6 +54,7 @@ interface Project {
allowPhotoDownload: boolean
allowClientAssetUpload: boolean
allowReverseShare: boolean
+ photoOnlyShare: boolean
clientCanApprove: boolean
usePreviewForApprovedPlayback: boolean
showClientTutorial: boolean
@@ -107,6 +108,7 @@ export default function ProjectSettingsPage() {
const [allowPhotoDownload, setAllowPhotoDownload] = useState(true)
const [allowClientAssetUpload, setAllowClientAssetUpload] = useState(false)
const [allowReverseShare, setAllowReverseShare] = useState(false)
+ const [photoOnlyShare, setPhotoOnlyShare] = useState(false)
const [clientCanApprove, setClientCanApprove] = useState(true)
const [usePreviewForApprovedPlayback, setUsePreviewForApprovedPlayback] = useState(false)
const [showClientTutorial, setShowClientTutorial] = useState(true)
@@ -193,6 +195,7 @@ export default function ProjectSettingsPage() {
setAllowPhotoDownload(data.allowPhotoDownload ?? true)
setAllowClientAssetUpload(data.allowClientAssetUpload ?? false)
setAllowReverseShare(data.allowReverseShare ?? false)
+ setPhotoOnlyShare(data.photoOnlyShare ?? false)
setClientCanApprove(data.clientCanApprove ?? true)
setUsePreviewForApprovedPlayback(data.usePreviewForApprovedPlayback ?? false)
setShowClientTutorial(data.showClientTutorial ?? true)
@@ -307,6 +310,7 @@ export default function ProjectSettingsPage() {
allowPhotoDownload,
allowClientAssetUpload,
allowReverseShare,
+ photoOnlyShare,
clientCanApprove,
usePreviewForApprovedPlayback,
showClientTutorial,
@@ -727,6 +731,23 @@ export default function ProjectSettingsPage() {
// Client Share Page content
const clientShareContent = (
<>
+ {/* ── Delivery ─────────────────────────────────────────────── */}
+
+ {/* Trailing letter-spacing pushes centered caps left; pad it back */}
+
+ {title}
+
+ {description && (
+
+ {description}
+
+ )}
+
+
+
+
+
+
+ {/* Gallery bar */}
+
+
+ {leadingActions}
+
+
+
{title}
+ {photoTotal > 0 && (
+
+ {t('photoCount', { count: photoTotal })}
+
+ )}
+
+
+
+ {trailingActions}
+ {canDownload && (
+
{
+ // Tabbing out closes the menu; clicks outside are handled by the mousedown listener
+ if (e.relatedTarget && !e.currentTarget.contains(e.relatedTarget as Node)) setDownloadMenuOpen(false)
+ }}
+ >
+
+ {downloadMenuOpen && (
+
+ {selectedAlbum && (
+
+ )}
+
+
+ )}
+
+ )}
+ {showLanguageToggle && }
+
+
+
+
+ {visibleAlbums.length > 1 && (
+
+ )}
+
+
+ {/* Grid: at least a viewport tall so switching to a shorter album never drags the cover back into view */}
+
+
+ {/* Without album access (guests on a link that hides photos from them) nothing will show up later */}
+ {projectId ? t('galleryEmpty') : t('noPhotosFound')}
+
- {/* Send Notification Button - only show if there are ready videos */}
- {readyVideos.length > 0 && (
+ {/* Send Notification Button - only show if there are ready videos (photo-only links announce the gallery) */}
+ {(readyVideos.length > 0 || project.photoOnlyShare) && (
-
+
{photosLoading ? (
@@ -491,6 +372,8 @@ export default function SharePhotoSection({ projectId, shareToken, allowPhotoDow
onClose={() => setLightboxIndex(null)}
onNavigate={setLightboxIndex}
canDownload={allowPhotoDownload}
+ total={totalPhotos}
+ onNearEnd={loadMore}
/>
)}
diff --git a/src/components/ThemeToggle.tsx b/src/components/ThemeToggle.tsx
index 8ce7622d..cf4bafcb 100644
--- a/src/components/ThemeToggle.tsx
+++ b/src/components/ThemeToggle.tsx
@@ -5,7 +5,8 @@ import { useEffect, useState, useCallback } from 'react'
import { useTranslations } from 'next-intl'
type ThemeToggleProps = {
- variant?: 'button' | 'sidebar'
+ /** 'ghost' drops the border and fill, for minimal bars like the photo gallery */
+ variant?: 'button' | 'sidebar' | 'ghost'
collapsed?: boolean
}
@@ -151,14 +152,19 @@ export default function ThemeToggle({ variant = 'button', collapsed = false }: T
)
}
+ const buttonClass = variant === 'ghost'
+ ? 'p-2 rounded-md text-muted-foreground hover:text-foreground transition-colors'
+ : 'p-2 rounded-lg border border-border bg-background hover:bg-accent transition-colors shadow-sm'
+ const iconClass = variant === 'ghost' ? 'h-4 w-4' : 'h-5 w-5 text-foreground'
+
// Avoid hydration mismatch
if (!mounted) {
return (
)
}
@@ -166,14 +172,14 @@ export default function ThemeToggle({ variant = 'button', collapsed = false }: T
return (
)
diff --git a/src/hooks/useAlbumGallery.ts b/src/hooks/useAlbumGallery.ts
new file mode 100644
index 00000000..2baa56a5
--- /dev/null
+++ b/src/hooks/useAlbumGallery.ts
@@ -0,0 +1,211 @@
+'use client'
+
+import { useState, useEffect, useCallback, useRef, type RefObject } from 'react'
+import type { GalleryPhoto } from '@/components/PhotoGrid'
+import { apiFetch } from '@/lib/api-client'
+import { logError } from '@/lib/logging'
+
+/** Matches the server page size — one request per grid page. */
+const PHOTO_PAGE_SIZE = 200
+
+interface GalleryAlbum {
+ id: string
+ name: string
+ photoCount: number
+ coverPhotoId: string | null
+ contentToken: string | null
+}
+
+export type PhotoZipScope = 'selection' | 'album' | 'project'
+
+interface UseAlbumGalleryOptions {
+ /** Omit when the viewer has no album access; the gallery then stays empty */
+ projectId?: string
+ /** Share bearer token; omit for admin sessions (uses apiFetch instead) */
+ shareToken?: string
+ /** Reports the album count once albums load */
+ onAlbumCount?: (count: number) => void
+ /** Scroll container of the photo grid, so pages are prefetched before they come into view */
+ scrollRootRef?: RefObject
+}
+
+/** Hands a URL to the browser as a download without navigating away. */
+function triggerDownload(url: string) {
+ const a = document.createElement('a')
+ a.href = url
+ a.download = ''
+ a.rel = 'noopener'
+ a.style.display = 'none'
+ document.body.appendChild(a)
+ a.click()
+ document.body.removeChild(a)
+}
+
+/**
+ * Client-facing album data: album list, the paged photo grid of the open
+ * album, photo URLs and zip downloads. Shared by the share page photo section
+ * and the photo delivery gallery (and their admin previews).
+ */
+export function useAlbumGallery({ projectId, shareToken, onAlbumCount, scrollRootRef }: UseAlbumGalleryOptions) {
+ const [albums, setAlbums] = useState([])
+ const [albumsLoading, setAlbumsLoading] = useState(true)
+ const [selectedAlbum, setSelectedAlbum] = useState(null)
+
+ const [photos, setPhotos] = useState([])
+ const [contentToken, setContentToken] = useState(null)
+ const [photosLoading, setPhotosLoading] = useState(false)
+ const [totalPhotos, setTotalPhotos] = useState(0)
+ const [downloading, setDownloading] = useState(false)
+ const loadingPageRef = useRef(false)
+ // Bumped on every album change: requests from an earlier album neither land
+ // nor release the loading lock the new album's first page now holds
+ const generationRef = useRef(0)
+ const sentinelRef = useRef(null)
+
+ // Share sessions authenticate with the share bearer token; admin preview
+ // sessions fall back to apiFetch (admin access token + refresh handling)
+ const doFetch = useCallback((url: string, init?: RequestInit): Promise => {
+ if (shareToken) {
+ return fetch(url, {
+ ...init,
+ headers: { ...(init?.headers as Record | undefined), Authorization: `Bearer ${shareToken}` },
+ })
+ }
+ return apiFetch(url, init)
+ }, [shareToken])
+
+ const fetchAlbums = useCallback(async () => {
+ if (!projectId) {
+ setAlbums([])
+ setAlbumsLoading(false)
+ return
+ }
+ try {
+ const res = await doFetch(`/api/projects/${projectId}/photo-albums`)
+ if (res.ok) {
+ const data = await res.json()
+ setAlbums(data.albums || [])
+ onAlbumCount?.((data.albums || []).length)
+ }
+ } catch (error) {
+ logError('Error fetching photo albums:', error)
+ } finally {
+ setAlbumsLoading(false)
+ }
+ }, [projectId, doFetch, onAlbumCount])
+
+ const fetchPhotoPage = useCallback(async (albumId: string, offset: number) => {
+ if (loadingPageRef.current) return
+ loadingPageRef.current = true
+ const generation = generationRef.current
+ if (offset === 0) setPhotosLoading(true)
+ try {
+ const res = await doFetch(
+ `/api/projects/${projectId}/photo-albums/${albumId}/photos?offset=${offset}&limit=${PHOTO_PAGE_SIZE}`
+ )
+ if (!res.ok) return
+ const data = await res.json()
+ // Drop a page that landed after the viewer moved to another album
+ if (generation !== generationRef.current) return
+ setContentToken(data.contentToken || null)
+ setTotalPhotos(data.total || 0)
+ setPhotos(prev => (offset === 0 ? data.photos || [] : [...prev, ...(data.photos || [])]))
+ } catch (error) {
+ logError('Error fetching photos:', error)
+ } finally {
+ if (generation === generationRef.current) {
+ loadingPageRef.current = false
+ if (offset === 0) setPhotosLoading(false)
+ }
+ }
+ }, [projectId, doFetch])
+
+ useEffect(() => {
+ fetchAlbums()
+ }, [fetchAlbums])
+
+ useEffect(() => {
+ generationRef.current += 1
+ loadingPageRef.current = false
+ setPhotos([])
+ setTotalPhotos(0)
+ if (selectedAlbum) {
+ fetchPhotoPage(selectedAlbum.id, 0)
+ } else {
+ setContentToken(null)
+ setPhotosLoading(false)
+ }
+ }, [selectedAlbum, fetchPhotoPage])
+
+ // Pull the next page as the sentinel nears the viewport. Re-running on
+ // photos.length re-observes an already-visible sentinel, so a page that was
+ // skipped while another was in flight is picked straight back up.
+ useEffect(() => {
+ const node = sentinelRef.current
+ if (!node || !selectedAlbum || photos.length >= totalPhotos) return
+ const observer = new IntersectionObserver(
+ entries => {
+ if (entries[0]?.isIntersecting) fetchPhotoPage(selectedAlbum.id, photos.length)
+ },
+ // The grid scrolls inside its own container, which clips the sentinel
+ // for a viewport root: observe against that container instead
+ { root: scrollRootRef?.current ?? null, rootMargin: '600px' }
+ )
+ observer.observe(node)
+ return () => observer.disconnect()
+ }, [selectedAlbum, photos.length, totalPhotos, fetchPhotoPage, scrollRootRef])
+
+ /** Fetch the next page ahead of time (the lightbox pages past the loaded grid) */
+ const loadMore = useCallback(() => {
+ if (selectedAlbum && photos.length < totalPhotos) fetchPhotoPage(selectedAlbum.id, photos.length)
+ }, [selectedAlbum, photos.length, totalPhotos, fetchPhotoPage])
+
+ const buildPhotoUrl = useCallback((photoId: string, variant: 'thumb' | 'full') => {
+ return `/api/content/photo/${contentToken}?photoId=${photoId}&variant=${variant}`
+ }, [contentToken])
+
+ const downloadPhoto = useCallback((photoId: string) => {
+ triggerDownload(`${buildPhotoUrl(photoId, 'full')}&download=true`)
+ }, [buildPhotoUrl])
+
+ const downloadZip = useCallback(async (scope: PhotoZipScope, photoIds: string[] = []) => {
+ setDownloading(true)
+ try {
+ const body =
+ scope === 'selection' && selectedAlbum
+ ? { scope, albumId: selectedAlbum.id, photoIds }
+ : scope === 'album' && selectedAlbum
+ ? { scope, albumId: selectedAlbum.id }
+ : { scope: 'project' as const }
+
+ const res = await doFetch(`/api/projects/${projectId}/photos/download-zip-token`, {
+ method: 'POST',
+ headers: { 'Content-Type': 'application/json' },
+ body: JSON.stringify(body),
+ })
+ if (!res.ok) return
+ const { url } = await res.json()
+ triggerDownload(url)
+ } catch (error) {
+ logError('Error downloading photos:', error)
+ } finally {
+ setDownloading(false)
+ }
+ }, [projectId, doFetch, selectedAlbum])
+
+ return {
+ albums,
+ albumsLoading,
+ selectedAlbum,
+ setSelectedAlbum,
+ photos,
+ totalPhotos,
+ photosLoading,
+ sentinelRef,
+ loadMore,
+ buildPhotoUrl,
+ downloadPhoto,
+ downloadZip,
+ downloading,
+ }
+}
diff --git a/src/lib/comment-helpers.ts b/src/lib/comment-helpers.ts
index c0b31757..18244293 100644
--- a/src/lib/comment-helpers.ts
+++ b/src/lib/comment-helpers.ts
@@ -175,6 +175,7 @@ export async function handleCommentNotifications(params: {
title: true,
slug: true,
clientNotificationSchedule: true,
+ photoOnlyShare: true,
}
})
@@ -296,7 +297,11 @@ export async function handleCommentNotifications(params: {
// A single queue entry has both sentToAdmins/sentToClients flags,
// so we only queue once when either (or both) sides are non-IMMEDIATE.
- const clientImmediate = clientSchedule === 'IMMEDIATE'
+ // Photo-only links never show videos, so recipients get no video feedback emails:
+ // the client side counts as handled from the start
+ const clientsMuted = project.photoOnlyShare
+ const clientImmediate = clientSchedule === 'IMMEDIATE' && !clientsMuted
+ const clientHandled = clientImmediate || clientsMuted
const adminImmediate = adminSchedule === 'IMMEDIATE'
if (clientImmediate) {
@@ -310,11 +315,11 @@ export async function handleCommentNotifications(params: {
// Queue once if either side needs batched delivery.
// Pre-mark sides that were already sent immediately so workers don't re-process them.
- if (!clientImmediate || !adminImmediate) {
+ if (!clientHandled || !adminImmediate) {
logMessage(`[COMMENT-NOTIFICATION] Queuing for batched delivery (admin: ${adminSchedule}, client: ${clientSchedule})...`)
await queueNotification(context, {
admins: adminImmediate,
- clients: clientImmediate,
+ clients: clientHandled,
})
}
} catch (emailError) {
diff --git a/src/lib/email.ts b/src/lib/email.ts
index 4897389c..00f5e161 100644
--- a/src/lib/email.ts
+++ b/src/lib/email.ts
@@ -1217,6 +1217,7 @@ export async function sendProjectGeneralNotificationEmail({
projectDescription,
shareUrl,
readyVideos = [],
+ photoAlbums = [],
isPasswordProtected = false,
unsubscribeUrl,
locale: localeOverride,
@@ -1227,6 +1228,8 @@ export async function sendProjectGeneralNotificationEmail({
projectDescription: string
shareUrl: string
readyVideos?: Array<{ name: string; versionLabel: string }>
+ /** Album names listed as deliverables when the link delivers photos only */
+ photoAlbums?: string[]
isPasswordProtected?: boolean
unsubscribeUrl?: string
locale?: string
@@ -1242,7 +1245,7 @@ export async function sendProjectGeneralNotificationEmail({
const template = await getEmailTemplate('PROJECT_GENERAL', locale)
const readyToViewLabel = emailMessages.common?.readyToView || 'Ready to view'
- const videoListHtml = readyVideos.length > 0 ? `
+ const videoListHtml = readyVideos.length > 0 || photoAlbums.length > 0 ? `
` : ''
diff --git a/src/lib/notifications.ts b/src/lib/notifications.ts
index dfa9c990..6ebe0ac8 100644
--- a/src/lib/notifications.ts
+++ b/src/lib/notifications.ts
@@ -19,7 +19,7 @@ interface NotificationContext {
}
interface ApprovalNotificationContext {
- project: { id: string; title: string; slug: string; clientNotificationSchedule: string; watermarkEnabled?: boolean }
+ project: { id: string; title: string; slug: string; clientNotificationSchedule: string; watermarkEnabled?: boolean; photoOnlyShare?: boolean }
video?: { id: string; name: string; versionLabel?: string | null }
approvedVideos?: Array<{ id: string; name: string }>
approved: boolean // true = approved, false = unapproved
@@ -260,8 +260,9 @@ async function sendApprovalImmediately(context: ApprovalNotificationContext) {
})
// Send to clients ONLY if complete project approval (all videos approved)
- // Don't send for partial approvals - client knows they just clicked approve
- if (recipients.length > 0 && isComplete && approved) {
+ // Don't send for partial approvals - client knows they just clicked approve.
+ // Photo-only links keep videos off the client side, approval emails included.
+ if (recipients.length > 0 && isComplete && approved && !project.photoOnlyShare) {
logMessage(`[IMMEDIATE→CLIENT] Sending complete project approval to ${recipients.length} recipient(s)`)
const emailPromises = recipients.map(async (recipient) => {
@@ -490,6 +491,7 @@ export async function flushPendingClientNotifications(projectId: string): Promis
id: true,
title: true,
slug: true,
+ photoOnlyShare: true,
notificationQueue: {
where: {
sentToClients: false,
@@ -505,6 +507,16 @@ export async function flushPendingClientNotifications(projectId: string): Promis
return
}
+ // Photo-only links never show videos: drop queued video feedback instead of flushing it
+ if (project.photoOnlyShare) {
+ await prisma.notificationQueue.updateMany({
+ where: { id: { in: project.notificationQueue.map(n => n.id) } },
+ data: { sentToClients: true, clientSentAt: new Date() },
+ })
+ logMessage(`[FLUSH-CLIENT] Photo-only delivery, dropped ${project.notificationQueue.length} pending notification(s) for project ${projectId}`)
+ return
+ }
+
const redis = getRedis()
const validNotifications = []
const cancelledIds: string[] = []
diff --git a/src/lib/s3-upload-auth.ts b/src/lib/s3-upload-auth.ts
index cfc344d8..5d038cfe 100644
--- a/src/lib/s3-upload-auth.ts
+++ b/src/lib/s3-upload-auth.ts
@@ -142,9 +142,9 @@ export async function verifyS3UploadAccess(
if (requireUploadPermission) {
const project = await prisma.project.findUnique({
where: { id: sharePayload.projectId },
- select: { allowClientAssetUpload: true },
+ select: { allowClientAssetUpload: true, photoOnlyShare: true },
})
- if (!project?.allowClientAssetUpload) {
+ if (!project?.allowClientAssetUpload || project.photoOnlyShare) {
return { errorResponse: NextResponse.json({ error: 'File attachments are not enabled for this project' }, { status: 403 }) }
}
}
diff --git a/src/lib/validation.ts b/src/lib/validation.ts
index e2f5b24c..24141243 100644
--- a/src/lib/validation.ts
+++ b/src/lib/validation.ts
@@ -300,6 +300,9 @@ export const updateProjectSchema = z.object({
// Reverse share
allowReverseShare: z.boolean().optional(),
+ // Photo-only delivery
+ photoOnlyShare: z.boolean().optional(),
+
// Approval settings
clientCanApprove: z.boolean().optional(),
diff --git a/src/locales/de.json b/src/locales/de.json
index 8914f118..78351557 100644
--- a/src/locales/de.json
+++ b/src/locales/de.json
@@ -393,6 +393,7 @@
"sendingNotification": "Wird gesendet...",
"notifyAllVideos": "Dies sendet eine E-Mail an den Kunden mit Zugang zu allen fertigen Videos in diesem Projekt.",
"notifySpecificVideo": "Dies sendet eine E-Mail an den Kunden mit einem Link zur ausgewählten Videoversion.",
+ "notifyPhotoGallery": "Dies sendet eine E-Mail an den Kunden mit einem Link zur Fotogalerie.",
"selectVideoAndVersion": "Bitte ein Video und eine Version auswählen",
"sendingNotificationProgress": "Benachrichtigung wird gesendet...",
"notificationSentSuccessfully": "Benachrichtigung erfolgreich gesendet!",
@@ -518,6 +519,8 @@
"allowClientFileAttachmentsDescription": "Kunden erlauben, Dateien (Bilder, Dokumente, Audio) an ihre Kommentare anzuhängen",
"allowReverseShare": "Datei-Einreichungen erlauben",
"allowReverseShareDescription": "Kunden erlauben, Dateien direkt in dieses Projekt hochzuladen, ohne sie an einen Kommentar anzuhängen",
+ "photoOnlyShare": "Nur Fotos ausliefern",
+ "photoOnlyShareDescription": "Der Share-Link wird zur Fotogalerie. Videos bleiben im Adminbereich: Kunden können sie weder ansehen, kommentieren, freigeben noch herunterladen.",
"clientUploads": "Kunden-Uploads",
"noClientUploads": "Es wurden noch keine Dateien von Kunden hochgeladen.",
"confirmDeleteUpload": "Diesen Upload löschen? Dies kann nicht rückgängig gemacht werden.",
@@ -629,6 +632,9 @@
"downloadSelected": "Herunterladen ({count})",
"downloadAlbum": "Album herunterladen",
"downloadAllAlbums": "Alle Alben herunterladen ({count})",
+ "viewGallery": "Galerie ansehen",
+ "selectedCount": "{count, plural, =1 {1 ausgewählt} other {# ausgewählt}}",
+ "galleryEmpty": "Die Fotos erscheinen hier, sobald sie bereit sind.",
"photoAlbums": "Fotoalben",
"confirmDeleteAlbum": "Dieses Album und alle Fotos löschen? Dies kann nicht rückgängig gemacht werden.",
"confirmDeletePhoto": "Dieses Foto löschen? Dies kann nicht rückgängig gemacht werden.",
diff --git a/src/locales/en.json b/src/locales/en.json
index c6f5d235..6f553c23 100644
--- a/src/locales/en.json
+++ b/src/locales/en.json
@@ -393,6 +393,7 @@
"sendingNotification": "Sending...",
"notifyAllVideos": "This will send an email to the client with access to all ready videos in this project.",
"notifySpecificVideo": "This will send an email to the client with a link to view the selected video version.",
+ "notifyPhotoGallery": "This will send an email to the client with a link to the photo gallery.",
"selectVideoAndVersion": "Please select a video and version",
"sendingNotificationProgress": "Sending notification...",
"notificationSentSuccessfully": "Notification sent successfully!",
@@ -518,6 +519,8 @@
"allowClientFileAttachmentsDescription": "Allow clients to attach files (images, documents, audio) to their comments",
"allowReverseShare": "Allow File Submissions",
"allowReverseShareDescription": "Allow clients to upload files directly to this project without attaching them to a comment",
+ "photoOnlyShare": "Photo-Only Delivery",
+ "photoOnlyShareDescription": "Turn the share link into a photo gallery. Videos stay in the admin area: recipients can't view, comment on, approve or download them.",
"clientUploads": "Client Uploads",
"noClientUploads": "No files have been uploaded by clients yet.",
"confirmDeleteUpload": "Delete this upload? This cannot be undone.",
@@ -629,6 +632,9 @@
"downloadSelected": "Download ({count})",
"downloadAlbum": "Download Album",
"downloadAllAlbums": "Download All Albums ({count})",
+ "viewGallery": "View Gallery",
+ "selectedCount": "{count, plural, =1 {1 selected} other {# selected}}",
+ "galleryEmpty": "Photos will appear here once they're ready.",
"photoAlbums": "Photo Albums",
"confirmDeleteAlbum": "Delete this album and all its photos? This cannot be undone.",
"confirmDeletePhoto": "Delete this photo? This cannot be undone.",
diff --git a/src/locales/nl.json b/src/locales/nl.json
index 7a2ea52c..5ef58a01 100644
--- a/src/locales/nl.json
+++ b/src/locales/nl.json
@@ -374,6 +374,7 @@
"sendingNotification": "Versturen...",
"notifyAllVideos": "Dit verstuurt een e-mail naar de klant met toegang tot alle gereedstaande video's in dit project.",
"notifySpecificVideo": "Dit verstuurt een e-mail naar de klant met een link naar de geselecteerde videoversie.",
+ "notifyPhotoGallery": "Dit verstuurt een e-mail naar de klant met een link naar de fotogalerij.",
"selectVideoAndVersion": "Selecteer een video en versie",
"sendingNotificationProgress": "Notificatie wordt verzonden...",
"notificationSentSuccessfully": "Notificatie succesvol verzonden!",
@@ -491,6 +492,8 @@
"allowClientFileAttachmentsDescription": "Sta klanten toe bestanden (afbeeldingen, documenten, audio) aan hun reacties toe te voegen",
"allowReverseShare": "Bestanden Indienen Toestaan",
"allowReverseShareDescription": "Sta klanten toe bestanden rechtstreeks naar dit project te uploaden zonder ze aan een reactie te koppelen",
+ "photoOnlyShare": "Alleen Foto's Leveren",
+ "photoOnlyShareDescription": "De deellink wordt een fotogalerij. Video's blijven in de beheeromgeving: klanten kunnen ze niet bekijken, becommentariëren, goedkeuren of downloaden.",
"clientUploads": "Klant Uploads",
"noClientUploads": "Er zijn nog geen bestanden door klanten geüpload.",
"confirmDeleteUpload": "Deze upload verwijderen? Dit kan niet ongedaan worden gemaakt.",
@@ -601,6 +604,9 @@
"downloadSelected": "Downloaden ({count})",
"downloadAlbum": "Album Downloaden",
"downloadAllAlbums": "Alle albums downloaden ({count})",
+ "viewGallery": "Galerij Bekijken",
+ "selectedCount": "{count, plural, =1 {1 geselecteerd} other {# geselecteerd}}",
+ "galleryEmpty": "De foto's verschijnen hier zodra ze klaar zijn.",
"photoAlbums": "Fotoalbums",
"confirmDeleteAlbum": "Dit album en alle foto's verwijderen? Dit kan niet ongedaan worden gemaakt.",
"confirmDeletePhoto": "Deze foto verwijderen? Dit kan niet ongedaan worden gemaakt.",
diff --git a/src/pages/api/uploads/[[...path]].ts b/src/pages/api/uploads/[[...path]].ts
index d9088d07..42310fe5 100644
--- a/src/pages/api/uploads/[[...path]].ts
+++ b/src/pages/api/uploads/[[...path]].ts
@@ -137,10 +137,10 @@ const tusServer: Server = new Server({
const project = await prisma.project.findUnique({
where: { id: sharePayload.projectId },
- select: { allowClientAssetUpload: true },
+ select: { allowClientAssetUpload: true, photoOnlyShare: true },
})
- if (!project?.allowClientAssetUpload) {
+ if (!project?.allowClientAssetUpload || project.photoOnlyShare) {
throw { status_code: 403, body: 'File attachments are not enabled for this project' }
}
}
diff --git a/src/worker/client-notifications.ts b/src/worker/client-notifications.ts
index 2fb1183f..7f9ffd8e 100644
--- a/src/worker/client-notifications.ts
+++ b/src/worker/client-notifications.ts
@@ -40,6 +40,7 @@ export async function processClientNotifications() {
clientNotificationTime: true,
clientNotificationDay: true,
lastClientNotificationSent: true,
+ photoOnlyShare: true,
notificationQueue: {
where: {
sentToClients: false,
@@ -62,6 +63,16 @@ export async function processClientNotifications() {
const pending = project.notificationQueue.length
logMessage(`[CLIENT] "${project.title}": ${project.clientNotificationSchedule} at ${project.clientNotificationTime || 'N/A'} (${pending} pending)`)
+ // Photo-only links never show videos: drop video feedback queued before the switch
+ if (project.photoOnlyShare) {
+ await prisma.notificationQueue.updateMany({
+ where: { id: { in: project.notificationQueue.map(n => n.id) } },
+ data: { sentToClients: true, clientSentAt: now },
+ })
+ logMessage('[CLIENT] Skip - photo-only delivery, pending video notifications dropped')
+ continue
+ }
+
if (project.clientNotificationSchedule === 'IMMEDIATE') {
logMessage('[CLIENT] Skip - IMMEDIATE notifications sent instantly')
continue
setCoverLoaded(true)}
+ className={cn(
+ 'absolute inset-0 -z-10 h-full w-full object-cover object-[50%_30%] motion-safe:transition-opacity motion-safe:duration-700 motion-safe:ease-out',
+ coverLoaded ? 'opacity-100' : 'opacity-0'
+ )}
+ />
+ )}
+
+ {leadingActions && 
{ e.stopPropagation(); goPrev() }}
- className="absolute left-2 top-1/2 -translate-y-1/2 p-2 rounded-full bg-background/70 backdrop-blur-sm border border-border text-muted-foreground hover:text-foreground transition-colors"
+ className={cn(arrowClass, 'left-2')}
aria-label={t('previousPhoto')}
>
-