photo-gallery 0.3.2: cache-bust regenerated thumbnails

New media_version column appended as &v= to asset URLs; bumped on
rotate and HEIF repair so immutable-cached derivatives refresh.

Backported from elite-hub commit 945266b.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Author: tjelite1986

CHANGELOG.md

@@ -12,6 +12,7 @@ All notable changes to the modules library are tracked here. Format loosely foll
 - `bookshelf` (0.1.0 → **0.2.0**) — reader and listing pages build cover/file URLs with `mediaToken()` instead of embedding the session JWT. Requires `authentication >= 0.3.0`.
 - `photo-gallery` (0.1.0 → **0.2.0**) — all client components (timeline, albums, smart albums, map, trips, tags, year-in-review, bulk download) build thumb/preview/file URLs with `mediaToken()` instead of embedding the session JWT. Requires `authentication >= 0.3.0`.
 - `photo-gallery` (0.2.0 → **0.2.1**) — lightbox info rows (filename, type, size, storage key, EXIF fields) gained copy-to-clipboard buttons with check-mark feedback, falling back to `execCommand` outside secure contexts. Backported from [elite-hub commit `efc9f30`](https://github.com/tjelite1986/elite-hub/commit/efc9f30).
+- `photo-gallery` (0.3.1 → **0.3.2**) — thumb/preview/file URLs now carry a `&v=<media_version>` cache-buster. The asset routes serve `Cache-Control: immutable` for a year, so regenerated derivatives (rotate, HEIF repair) kept showing stale in browsers; the new `media_version` column is bumped on every regeneration. Backported from [elite-hub commit `945266b`](https://github.com/tjelite1986/elite-hub/commit/945266b).
 - `photo-gallery` (0.3.0 → **0.3.1**) — fixed HEIC/HEIF photos decoding as a single zoomed-in 512px tile: ffmpeg/ffprobe can't handle tiled HEIF, so ingest and `makeImageThumb` now convert via libheif (`heif-convert`) first; thumbs, previews and stored dimensions all derive from the converted JPEG. New `POST /api/gallery/repair-heif` + "Repair HEIF previews" maintenance action regenerate already-ingested items. `libheif-tools` + `ffmpeg` added as documented system deps. Backported from [elite-hub commit `58bf32e`](https://github.com/tjelite1986/elite-hub/commit/58bf32e).
 - `photo-gallery` (0.2.1 → **0.3.0**) — capture dates are now parsed from filenames (WhatsApp `IMG-yyyymmdd-WA####`, Samsung/Android `yyyymmdd_hhmmss`, Pixel `PXL_…`, screenshots, Telegram/Signal, Dropbox, epoch-named files) via new `lib/filenameDate.ts` with strict validation. Ingest falls back EXIF → filename → mtime → now. New `POST /api/gallery/backfill-filename-dates` + "Fix dates from filenames" maintenance action re-date existing items; anything still carrying an EXIF date is left untouched. Backported from [elite-hub commit `aaac1b1`](https://github.com/tjelite1986/elite-hub/commit/aaac1b1).
 

photo-gallery/components/GalleryClient.tsx

@@ -56,16 +56,22 @@ function authHeaders() {
   return { Authorization: `Bearer ${authToken()}` };
 }
 
+// The v param busts the browser's immutable cache when derived media is
+// regenerated (rotate, HEIF repair) — the storage key stays the same.
+function mediaVersion(item: GalleryItem) {
+  return item.media_version ? `&v=${item.media_version}` : "";
+}
+
 export function thumbUrl(item: GalleryItem) {
-  return `/api/gallery/thumb/${item.storage_key}?t=${encodeURIComponent(mediaToken())}`;
+  return `/api/gallery/thumb/${item.storage_key}?t=${encodeURIComponent(mediaToken())}${mediaVersion(item)}`;
 }
 
 export function previewUrl(item: GalleryItem) {
-  return `/api/gallery/preview/${item.storage_key}?t=${encodeURIComponent(mediaToken())}`;
+  return `/api/gallery/preview/${item.storage_key}?t=${encodeURIComponent(mediaToken())}${mediaVersion(item)}`;
 }
 
 export function originalUrl(item: GalleryItem) {
-  return `/api/gallery/file/${item.storage_key}?t=${encodeURIComponent(mediaToken())}`;
+  return `/api/gallery/file/${item.storage_key}?t=${encodeURIComponent(mediaToken())}${mediaVersion(item)}`;
 }
 
 function fileUrlForLightbox(item: GalleryItem, variant: "preview" | "file") {

photo-gallery/db/schema.sql

@@ -82,6 +82,9 @@ ALTER TABLE gallery_items ADD COLUMN description TEXT;
 ALTER TABLE gallery_items ADD COLUMN latitude REAL;
 ALTER TABLE gallery_items ADD COLUMN longitude REAL;
 ALTER TABLE gallery_items ADD COLUMN location_name TEXT;
+-- Cache-busting version for derived media (thumb/preview); bumped on rotate
+-- and HEIF repair so immutable-cached URLs change.
+ALTER TABLE gallery_items ADD COLUMN media_version INTEGER NOT NULL DEFAULT 0;
 CREATE INDEX IF NOT EXISTS idx_gallery_items_geo ON gallery_items(latitude, longitude);
 CREATE TABLE IF NOT EXISTS gallery_trips (
   id INTEGER PRIMARY KEY AUTOINCREMENT,

photo-gallery/lib/gallery-types.ts

@@ -24,6 +24,7 @@ export interface GalleryItem {
   longitude: number | null;
   location_name: string | null;
   rating: number;
+  media_version?: number;
   tag_count?: number;
 }
 

photo-gallery/lib/gallery.ts

@@ -50,6 +50,7 @@ export interface GalleryItem {
   longitude: number | null;
   location_name: string | null;
   rating: number;
+  media_version?: number;
   tag_count?: number;
 }
 
@@ -689,7 +690,8 @@ export async function rotateItem(
   const stat = fs.statSync(orig);
   const db = getDb();
   db.prepare(
-    "UPDATE gallery_items SET width = ?, height = ?, size_bytes = ? WHERE id = ? AND user_id = ?",
+    `UPDATE gallery_items SET width = ?, height = ?, size_bytes = ?,
+       media_version = media_version + 1 WHERE id = ? AND user_id = ?`,
   ).run(result.width ?? null, result.height ?? null, stat.size, id, userId);
   return getItem(userId, id);
 }
@@ -742,7 +744,8 @@ export async function repairHeifMedia(userId: number): Promise<{
       );
       db.prepare(
         `UPDATE gallery_items SET width = ?, height = ?,
-           thumbnail_ready = ?, preview_ready = ? WHERE id = ? AND user_id = ?`,
+           thumbnail_ready = ?, preview_ready = ?,
+           media_version = media_version + 1 WHERE id = ? AND user_id = ?`,
       ).run(
         probed.width ?? null,
         probed.height ?? null,

photo-gallery/module.json

@@ -1,6 +1,6 @@
 {
   "name": "photo-gallery",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "Google-Photos-style library: timeline, albums, smart albums, map view, auto-trip detection, year-in-review, tag browser, share links, EXIF + geotag, content-hash dedup",
   "category": "media",
   "framework": {

registry.json

@@ -384,7 +384,7 @@
       "description": "Google-Photos-style library: timeline, albums, smart albums, map view, auto-trip detection, year-in-review, tag browser, share links, EXIF + geotag, content-hash dedup",
       "category": "media",
       "tags": ["gallery", "photos", "albums", "exif", "geotag", "leaflet", "smart-albums"],
-      "version": "0.3.1",
+      "version": "0.3.2",
       "status": "stable"
     },
     {