includio-cms 0.13.3 → 0.14.0

package/CHANGELOG.md

@@ -3,6 +3,59 @@
 All notable changes to includio-cms are documented here.
 Generated from `src/lib/updates/` — do not edit manually.
 
+## 0.14.0 — 2026-03-24
+
+Video transcoding & optimization
+
+### Added
+- Auto-transcode uploaded videos to mp4 (h264) and webm (vp9) in background
+- Video styles system with status tracking (pending/processing/done/failed)
+- Admin maintenance: video transcoding card with batch transcode, purge & retranscode, SSE progress
+- Configurable video transcoding: formats, max resolution, CRF quality, concurrency
+- Skip logic: skip already-optimized mp4 h264 at 1080p or below, skip files over 500MB
+- Frontend video serves multiple source elements (webm, mp4, original fallback)
+- System info endpoint: CMS version, Node, PostgreSQL, ffmpeg (codec checks), sharp, OS diagnostics
+- Disk usage endpoint: breakdown per category (originals by type, image styles, video styles, posters)
+
+### Migration
+
+```sql
+CREATE TABLE IF NOT EXISTS video_styles (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  media_file_id UUID NOT NULL REFERENCES media_file(id) ON DELETE CASCADE,
+  name TEXT NOT NULL,
+  url TEXT NOT NULL,
+  width INTEGER,
+  height INTEGER,
+  format TEXT NOT NULL,
+  codec TEXT,
+  file_size INTEGER,
+  mime_type TEXT NOT NULL,
+  status TEXT NOT NULL DEFAULT 'pending',
+  error TEXT,
+  created_at TIMESTAMP DEFAULT NOW()
+);
+
+CREATE UNIQUE INDEX IF NOT EXISTS video_styles_unique_key
+ON video_styles (media_file_id, name);
+```
+
+### Notes
+
+Video transcoding requires ffmpeg with libx264 and libvpx-vp9 codecs. Graceful degradation if ffmpeg is unavailable.
+
+## 0.13.4 — 2026-03-24
+
+Video poster regeneration, filename sanitization
+
+### Added
+- Batch regenerate video posters & thumbnails from admin maintenance page with SSE progress
+- Video poster status reporting in media GC endpoint
+- Extracted video processing to reusable module
+
+### Fixed
+- Filename sanitization normalizes Unicode to NFC (prevents NFD/NFC mismatch)
+
 ## 0.13.3 — 2026-03-23
 
 Security hardening, per-language content fixes

package/ROADMAP.md

@@ -239,14 +239,31 @@
 - [x] `[fix]` `[P1]` CMS constructor validates non-empty languages array <!-- files: src/lib/core/cms.ts -->
 - [x] `[fix]` `[P2]` Unhandled promise rejection handlers in admin components
 
-## 0.14.0 — SEO module
+## 0.13.4 — Video poster regeneration
+
+- [x] `[feature]` `[P1]` Batch video poster regeneration — admin maintenance page with SSE progress <!-- files: src/lib/admin/api/regenerate-posters.ts, src/lib/core/server/media/operations/batchRegenerateVideoPosters.ts, src/lib/admin/client/maintenance/maintenance-page.svelte -->
+- [x] `[feature]` `[P1]` Video poster status reporting in media GC endpoint <!-- files: src/lib/admin/api/media-gc.ts -->
+- [x] `[chore]` `[P1]` Extracted video processing to reusable module <!-- files: src/lib/files-local/video.ts, src/lib/files-local/index.ts -->
+- [x] `[fix]` `[P1]` Filename sanitization normalizes Unicode to NFC <!-- files: src/lib/files-local/sanitizeFilename.ts -->
+
+## 0.14.0 — Video transcoding
+
+- [x] `[feature]` `[P1]` Video styles system — auto-transcode to mp4 h264 + webm vp9 <!-- files: src/lib/db-postgres/schema/videoStyle.ts, src/lib/files-local/transcode.ts -->
+- [x] `[feature]` `[P1]` Background transcoding pipeline on upload with skip logic <!-- files: src/lib/core/server/media/styles/operations/generateDefaultVideoStyles.ts -->
+- [x] `[feature]` `[P1]` Admin maintenance: video transcoding card (batch, purge, SSE progress) <!-- files: src/lib/admin/client/maintenance/maintenance-page.svelte -->
+- [x] `[feature]` `[P2]` Frontend multi-source video delivery (webm, mp4, original) <!-- files: src/lib/sveltekit/components/video.svelte -->
+- [x] `[feature]` `[P2]` Configurable video transcoding in MediaConfig <!-- files: src/lib/types/cms.ts -->
+- [x] `[feature]` `[P2]` System info endpoint — CMS version, Node, PostgreSQL, ffmpeg, sharp, OS <!-- files: src/lib/admin/api/system-info.ts, src/lib/core/server/media/operations/getSystemInfo.ts -->
+- [x] `[feature]` `[P2]` Disk usage endpoint — breakdown per category (originals, image styles, video styles, posters) <!-- files: src/lib/admin/api/system-info.ts, src/lib/core/server/media/operations/getDiskUsage.ts -->
+
+## 0.15.0 — SEO module
 
 - [ ] `[feature]` `[P1]` SERP preview + character limits for title/description <!-- files: src/lib/admin/components/fields/seo-field.svelte -->
 - [ ] `[feature]` `[P1]` Global SEO settings
 - [ ] `[feature]` `[P1]` Dedicated frontend SEO components <!-- files: src/lib/sveltekit/components/seo.svelte -->
 - [ ] `[feature]` `[P2]` Sitemap generation
 
-## 0.15.0 — WCAG/ATAG compliance
+## 0.16.0 — WCAG/ATAG compliance
 
 - [ ] `[chore]` `[P0]` Full WCAG/ATAG audit
 - [ ] `[feature]` `[P0]` Accessibility rework based on audit findings

package/dist/admin/api/handler.js

@@ -6,7 +6,10 @@ import * as inviteHandlers from './invite.js';
 import * as acceptInviteHandlers from './accept-invite.js';
 import * as mediaGcHandlers from './media-gc.js';
 import * as generateStylesHandlers from './generate-styles.js';
+import * as regeneratePostersHandlers from './regenerate-posters.js';
+import * as transcodeVideosHandlers from './transcode-videos.js';
 import * as uploadLimitHandlers from './upload-limit.js';
+import * as systemInfoHandlers from './system-info.js';
 import { requireAuth } from '../remote/middleware/auth.js';
 import { getCMS } from '../../core/cms.js';
 import { lookup } from 'mrmime';
@@ -19,7 +22,10 @@ export function createAdminApiHandler(options) {
         'accept-invite': acceptInviteHandlers,
         'media-gc': mediaGcHandlers,
         'generate-styles': generateStylesHandlers,
+        'regenerate-posters': regeneratePostersHandlers,
+        'transcode-videos': transcodeVideosHandlers,
         'upload-limit': uploadLimitHandlers,
+        'system-info': systemInfoHandlers,
         ...options?.extraRoutes
     };
     const privateMediaGet = async (event) => {

package/dist/admin/api/media-gc.js

@@ -2,12 +2,16 @@ import { requireRole } from '../remote/middleware/auth.js';
 import { purgeAllImageStyles } from '../../core/server/media/operations/purgeImageStyles.js';
 import { getReconciliationReport, deleteOrphanedDiskFiles } from '../../core/server/media/operations/reconcileMedia.js';
 import { getStylesStatus } from '../../core/server/media/styles/operations/batchGenerateStyles.js';
+import { getVideoPosterStatus } from '../../core/server/media/operations/batchRegenerateVideoPosters.js';
+import { getVideoTranscodeStatus, purgeVideoStyles } from '../../core/server/media/operations/batchTranscodeVideos.js';
 import { json } from '@sveltejs/kit';
 export const GET = async ({ url }) => {
     requireRole('admin');
-    const [stylesStatus, report] = await Promise.all([
+    const [stylesStatus, report, videoPosterStatus, videoTranscodeStatus] = await Promise.all([
         getStylesStatus(),
-        getReconciliationReport()
+        getReconciliationReport(),
+        getVideoPosterStatus(),
+        getVideoTranscodeStatus()
     ]);
     return json({
         imageStylesCount: stylesStatus.existingStyles,
@@ -15,7 +19,15 @@ export const GET = async ({ url }) => {
         expectedStylesCount: stylesStatus.expectedStyles,
         missingStylesCount: stylesStatus.missingStyles,
         orphanedDiskFiles: report.orphanedDisk,
-        missingDiskRecords: report.missingDisk
+        missingDiskRecords: report.missingDisk,
+        videosCount: videoPosterStatus.videosCount,
+        videosWithPosters: videoPosterStatus.videosWithPosters,
+        videosMissingPosters: videoPosterStatus.videosMissingPosters,
+        videoStylesCount: videoTranscodeStatus.videoStylesCount,
+        videoStylesExpected: videoTranscodeStatus.videoStylesExpected,
+        videoStylesDone: videoTranscodeStatus.videoStylesDone,
+        videoStylesPending: videoTranscodeStatus.videoStylesPending,
+        videoStylesFailed: videoTranscodeStatus.videoStylesFailed
     });
 };
 export const DELETE = async ({ url }) => {
@@ -29,5 +41,9 @@ export const DELETE = async ({ url }) => {
         const result = await deleteOrphanedDiskFiles();
         return json(result);
     }
+    if (action === 'purge-video-styles') {
+        const result = await purgeVideoStyles();
+        return json(result);
+    }
     return json({ error: 'Unknown action' }, { status: 400 });
 };

package/dist/admin/api/regenerate-posters.d.ts

@@ -0,0 +1,2 @@
+import type { RequestHandler } from '@sveltejs/kit';
+export declare const POST: RequestHandler;

package/dist/admin/api/regenerate-posters.js

@@ -0,0 +1,32 @@
+import { requireRole } from '../remote/middleware/auth.js';
+import { batchRegenerateVideoPosters } from '../../core/server/media/operations/batchRegenerateVideoPosters.js';
+export const POST = async () => {
+    requireRole('admin');
+    const abort = new AbortController();
+    const encoder = new TextEncoder();
+    const stream = new ReadableStream({
+        async start(controller) {
+            try {
+                for await (const event of batchRegenerateVideoPosters(abort.signal)) {
+                    controller.enqueue(encoder.encode(`data: ${JSON.stringify(event)}\n\n`));
+                }
+            }
+            catch (e) {
+                controller.enqueue(encoder.encode(`data: ${JSON.stringify({ type: 'error', error: e instanceof Error ? e.message : String(e) })}\n\n`));
+            }
+            finally {
+                controller.close();
+            }
+        },
+        cancel() {
+            abort.abort();
+        }
+    });
+    return new Response(stream, {
+        headers: {
+            'Content-Type': 'text/event-stream',
+            'Cache-Control': 'no-cache',
+            Connection: 'keep-alive'
+        }
+    });
+};

package/dist/admin/api/system-info.d.ts

@@ -0,0 +1,2 @@
+import { type RequestHandler } from '@sveltejs/kit';
+export declare const GET: RequestHandler;

package/dist/admin/api/system-info.js

@@ -0,0 +1,9 @@
+import { requireRole } from '../remote/middleware/auth.js';
+import { getDiskUsage } from '../../core/server/media/operations/getDiskUsage.js';
+import { getSystemInfo } from '../../core/server/media/operations/getSystemInfo.js';
+import { json } from '@sveltejs/kit';
+export const GET = async () => {
+    requireRole('admin');
+    const [diskUsage, systemInfo] = await Promise.all([getDiskUsage(), getSystemInfo()]);
+    return json({ diskUsage, systemInfo });
+};

package/dist/admin/api/transcode-videos.d.ts

@@ -0,0 +1,2 @@
+import type { RequestHandler } from '@sveltejs/kit';
+export declare const POST: RequestHandler;

package/dist/admin/api/transcode-videos.js

@@ -0,0 +1,32 @@
+import { requireRole } from '../remote/middleware/auth.js';
+import { batchTranscodeVideos } from '../../core/server/media/operations/batchTranscodeVideos.js';
+export const POST = async () => {
+    requireRole('admin');
+    const abort = new AbortController();
+    const encoder = new TextEncoder();
+    const stream = new ReadableStream({
+        async start(controller) {
+            try {
+                for await (const event of batchTranscodeVideos(abort.signal)) {
+                    controller.enqueue(encoder.encode(`data: ${JSON.stringify(event)}\n\n`));
+                }
+            }
+            catch (e) {
+                controller.enqueue(encoder.encode(`data: ${JSON.stringify({ type: 'error', error: e instanceof Error ? e.message : String(e) })}\n\n`));
+            }
+            finally {
+                controller.close();
+            }
+        },
+        cancel() {
+            abort.abort();
+        }
+    });
+    return new Response(stream, {
+        headers: {
+            'Content-Type': 'text/event-stream',
+            'Cache-Control': 'no-cache',
+            Connection: 'keep-alive'
+        }
+    });
+};