includio-cms 0.14.2 → 0.14.3

package/dist/admin/remote/media.remote.js

@@ -116,11 +116,11 @@ export const setFocalPoint = command(z.object({
             await cms.filesAdapter.deleteFile(fileName).catch((e) => console.warn('Style file cleanup failed:', e));
         }
     }
-    // Re-generate styles with new focal point (awaited so client gets fresh URLs)
+    // Re-generate styles with new focal point in background (lazy fallback via getImageStyle)
     const file = await cms.databaseAdapter.getMediaFile({ data: { id: fileId } });
     if (file) {
-        const { generateDefaultStyles } = await import('../../core/server/media/styles/operations/generateDefaultStyles.js');
-        await generateDefaultStyles(file);
+        const { generateDefaultStylesInBackground } = await import('../../core/server/media/styles/operations/generateDefaultStyles.js');
+        generateDefaultStylesInBackground(file);
     }
 });
 export const renameMediaFile = command(z.object({

package/dist/core/cms.js

@@ -147,6 +147,10 @@ export class CMS {
 let cms;
 export function initCMS(config) {
     cms = new CMS(config);
+    // Start background maintenance (delayed, non-blocking)
+    import('./server/media/operations/backgroundMaintenance.js')
+        .then((m) => m.startBackgroundMaintenance())
+        .catch((e) => console.warn('[cms] Failed to start background maintenance:', e));
     return cms;
 }
 export function getCMS() {

package/dist/core/server/media/operations/backgroundMaintenance.d.ts

@@ -0,0 +1,15 @@
+export interface MaintenanceResult {
+    stylesCreated: number;
+    postersCreated: number;
+    transcodesCreated: number;
+    orphansDeleted: number;
+    ranAt: Date;
+}
+export declare function getMaintenanceStatus(): {
+    running: boolean;
+    lastRun: Date | null;
+    nextRun: Date | null;
+    lastResult: MaintenanceResult | null;
+};
+export declare function startBackgroundMaintenance(): void;
+export declare function stopBackgroundMaintenance(): void;

package/dist/core/server/media/operations/backgroundMaintenance.js

@@ -0,0 +1,105 @@
+import { getCMS } from '../../../cms.js';
+let running = false;
+let timer = null;
+let lastResult = null;
+let nextRunAt = null;
+export function getMaintenanceStatus() {
+    return {
+        running,
+        lastRun: lastResult?.ranAt ?? null,
+        nextRun: nextRunAt,
+        lastResult
+    };
+}
+async function runMaintenance() {
+    if (running) {
+        console.info('[maintenance] Skipping — previous run still active');
+        return;
+    }
+    running = true;
+    console.info('[maintenance] Starting background maintenance...');
+    const result = {
+        stylesCreated: 0,
+        postersCreated: 0,
+        transcodesCreated: 0,
+        orphansDeleted: 0,
+        ranAt: new Date()
+    };
+    try {
+        // 1. Generate missing image styles
+        const { batchGenerateAllStyles } = await import('../styles/operations/batchGenerateStyles.js');
+        for await (const event of batchGenerateAllStyles()) {
+            if (event.type === 'done') {
+                result.stylesCreated = event.created;
+            }
+        }
+        // 2. Generate missing video posters
+        const { batchRegenerateVideoPosters } = await import('./batchRegenerateVideoPosters.js');
+        for await (const event of batchRegenerateVideoPosters()) {
+            if (event.type === 'done') {
+                result.postersCreated = event.created;
+            }
+        }
+        // 3. Transcode missing videos
+        const { checkFfmpegAvailable } = await import('../../../../files-local/video.js');
+        if (await checkFfmpegAvailable()) {
+            const { batchTranscodeVideos } = await import('./batchTranscodeVideos.js');
+            for await (const event of batchTranscodeVideos()) {
+                if (event.type === 'done') {
+                    result.transcodesCreated = event.created;
+                }
+            }
+        }
+        // 4. Clean up orphaned files
+        const { deleteOrphanedDiskFiles } = await import('./reconcileMedia.js');
+        const orphanResult = await deleteOrphanedDiskFiles();
+        result.orphansDeleted = orphanResult.deletedCount;
+    }
+    catch (err) {
+        console.warn('[maintenance] Error during background maintenance:', err);
+    }
+    finally {
+        running = false;
+        lastResult = result;
+        const parts = [];
+        if (result.stylesCreated > 0)
+            parts.push(`${result.stylesCreated} styles`);
+        if (result.postersCreated > 0)
+            parts.push(`${result.postersCreated} posters`);
+        if (result.transcodesCreated > 0)
+            parts.push(`${result.transcodesCreated} transcodes`);
+        if (result.orphansDeleted > 0)
+            parts.push(`${result.orphansDeleted} orphans cleaned`);
+        if (parts.length > 0) {
+            console.info(`[maintenance] Done: ${parts.join(', ')}`);
+        }
+        else {
+            console.info('[maintenance] Done — nothing to process');
+        }
+    }
+}
+export function startBackgroundMaintenance() {
+    const config = getCMS().mediaConfig?.maintenance;
+    if (config?.autoRun === false)
+        return;
+    const intervalHours = config?.intervalHours ?? 6;
+    const intervalMs = intervalHours * 60 * 60 * 1000;
+    // First run after 30s delay
+    setTimeout(() => {
+        runMaintenance();
+        // Then repeat on interval
+        nextRunAt = new Date(Date.now() + intervalMs);
+        timer = setInterval(() => {
+            nextRunAt = new Date(Date.now() + intervalMs);
+            runMaintenance();
+        }, intervalMs);
+    }, 30_000);
+    console.info(`[maintenance] Scheduled: first run in 30s, then every ${intervalHours}h`);
+}
+export function stopBackgroundMaintenance() {
+    if (timer) {
+        clearInterval(timer);
+        timer = null;
+        nextRunAt = null;
+    }
+}

package/dist/core/server/media/operations/batchTranscodeVideos.js

@@ -2,6 +2,7 @@ import { getCMS } from '../../../cms.js';
 import { generateVideoStyle } from '../styles/ffmpeg/generateVideoStyle.js';
 import { defaultVideoStyles } from '../styles/operations/generateDefaultVideoStyles.js';
 import { checkFfmpegAvailable } from '../../../../files-local/video.js';
+import { shouldTranscode, MAX_AUTO_TRANSCODE_SIZE } from '../../../../files-local/transcode.js';
 const VIDEO_MIME_TYPES = [
     'video/mp4',
     'video/quicktime',
@@ -70,11 +71,25 @@ export async function getVideoTranscodeStatus() {
         data: { mimeTypes: VIDEO_MIME_TYPES }
     });
     const allStyles = await cms.databaseAdapter.getAllVideoStyles();
-    const expectedPerVideo = defaultVideoStyles.length;
+    const config = getCMS().mediaConfig?.video;
+    const formats = config?.formats ?? ['mp4', 'webm'];
+    // Count expected styles per-file respecting filters
+    let videoStylesExpected = 0;
+    for (const file of allFiles) {
+        if (file.size > MAX_AUTO_TRANSCODE_SIZE)
+            continue;
+        for (const style of defaultVideoStyles) {
+            if (!formats.includes(style.format))
+                continue;
+            if (!shouldTranscode(file.mimeType, file.width, file.height, file.size, file.duration, style.format))
+                continue;
+            videoStylesExpected++;
+        }
+    }
     return {
         videosCount: allFiles.length,
         videoStylesCount: allStyles.length,
-        videoStylesExpected: allFiles.length * expectedPerVideo,
+        videoStylesExpected,
         videoStylesDone: allStyles.filter((s) => s.status === 'done').length,
         videoStylesPending: allStyles.filter((s) => s.status === 'pending' || s.status === 'processing').length,
         videoStylesFailed: allStyles.filter((s) => s.status === 'failed').length

package/dist/core/server/media/operations/reconcileMedia.js

@@ -4,7 +4,10 @@ export async function getReconciliationReport() {
     const diskFiles = await cms.filesAdapter.listFiles();
     // Collect all known URLs from DB
     const mediaFiles = await cms.databaseAdapter.getMediaFiles({ data: {} });
-    const imageStyles = await cms.databaseAdapter.getAllImageStyles();
+    const [imageStyles, videoStyles] = await Promise.all([
+        cms.databaseAdapter.getAllImageStyles(),
+        cms.databaseAdapter.getAllVideoStyles()
+    ]);
     const dbFilenames = new Set();
     for (const mf of mediaFiles) {
         const fn = mf.url.split('/').pop();
@@ -26,6 +29,13 @@ export async function getReconciliationReport() {
         if (fn)
             dbFilenames.add(fn);
     }
+    for (const vs of videoStyles) {
+        if (vs.url) {
+            const fn = vs.url.split('/').pop();
+            if (fn)
+                dbFilenames.add(fn);
+        }
+    }
     // Orphaned: on disk but not in DB
     const orphanedDisk = diskFiles.filter((f) => !dbFilenames.has(f));
     // Missing: in DB but not on disk
@@ -43,6 +53,14 @@ export async function getReconciliationReport() {
             missingDisk.push({ table: 'image_styles', id: is.id, url: is.url });
         }
     }
+    for (const vs of videoStyles) {
+        if (vs.url) {
+            const fn = vs.url.split('/').pop();
+            if (fn && !diskSet.has(fn)) {
+                missingDisk.push({ table: 'video_styles', id: vs.id, url: vs.url });
+            }
+        }
+    }
     return { orphanedDisk, missingDisk };
 }
 export async function deleteOrphanedDiskFiles() {

package/dist/core/server/media/styles/operations/batchGenerateStyles.js

@@ -117,20 +117,25 @@ export async function getStylesStatus() {
         // We only have id/url/mediaFileId from getAllImageStyles, not name.
         // So we count per-file total instead
     }
-    // Count expected per-file and compare with existing count per-file
+    // Count expected and existing per-file
     let expectedStyles = 0;
+    let existingStyles = 0;
     let missingStyles = 0;
-    // Count existing per mediaFileId
+    const processableFileIds = new Set(files.map((f) => f.id));
+    // Count existing per mediaFileId (only for current processable files)
     const existingCountByFile = new Map();
     for (const s of allStyles) {
         const fileId = s.mediaFileId;
-        existingCountByFile.set(fileId, (existingCountByFile.get(fileId) ?? 0) + 1);
+        if (processableFileIds.has(fileId)) {
+            existingCountByFile.set(fileId, (existingCountByFile.get(fileId) ?? 0) + 1);
+        }
     }
     for (const file of files) {
         const expectedNames = getExpectedStyleNames(file);
         const expected = expectedNames.length;
         const existing = existingCountByFile.get(file.id) ?? 0;
         expectedStyles += expected;
+        existingStyles += existing;
         if (existing < expected) {
             missingStyles += expected - existing;
         }
@@ -138,7 +143,7 @@ export async function getStylesStatus() {
     return {
         processableImages: files.length,
         expectedStyles,
-        existingStyles: allStyles.length,
+        existingStyles,
         missingStyles
     };
 }

package/dist/types/cms.d.ts

@@ -22,10 +22,17 @@ export interface VideoTranscodeConfig {
     /** Concurrent transcode jobs (default: 1) */
     concurrency?: number;
 }
+export interface MaintenanceConfig {
+    /** Enable automatic background maintenance (default: true) */
+    autoRun?: boolean;
+    /** Interval in hours between maintenance runs (default: 6) */
+    intervalHours?: number;
+}
 export interface MediaConfig {
     maxOriginalWidth?: number;
     maxOriginalHeight?: number;
     video?: VideoTranscodeConfig;
+    maintenance?: MaintenanceConfig;
 }
 export interface AuthAdapter {
     api: {

package/dist/updates/0.14.3/index.d.ts

@@ -0,0 +1,2 @@
+import type { CmsUpdate } from '../index.js';
+export declare const update: CmsUpdate;

package/dist/updates/0.14.3/index.js

@@ -0,0 +1,15 @@
+export const update = {
+    version: '0.14.3',
+    date: '2026-03-27',
+    description: 'Background maintenance system — automatic style generation, poster regeneration, video transcoding, orphan cleanup on configurable schedule',
+    features: [
+        'Background maintenance scheduler — runs style generation, poster regeneration, video transcoding, and orphan cleanup automatically',
+        'Maintenance status API endpoint (`/admin/api/maintenance-status`) — real-time status of background tasks',
+        'Configurable maintenance interval via `media.maintenance` config (`autoRun`, `intervalHours`)',
+        'Maintenance page UI redesign — auto-status banner, organized sections, compact progress indicators'
+    ],
+    fixes: [
+        'Maintenance page SSE handler deduplication — single reusable `handleSSE()` replaces 3 duplicated implementations'
+    ],
+    breakingChanges: []
+};

package/dist/updates/index.js

@@ -40,7 +40,8 @@ import { update as update0134 } from './0.13.4/index.js';
 import { update as update0140 } from './0.14.0/index.js';
 import { update as update0141 } from './0.14.1/index.js';
 import { update as update0142 } from './0.14.2/index.js';
-export const updates = [update0065, update0066, update0067, update0068, update0069, update010, update011, update012, update013, update014, update015, update020, update022, update050, update051, update052, update053, update054, update055, update056, update057, update058, update060, update061, update062, update070, update071, update072, update073, update080, update090, update0100, update0110, update0120, update0130, update0131, update0132, update0133, update0134, update0140, update0141, update0142];
+import { update as update0143 } from './0.14.3/index.js';
+export const updates = [update0065, update0066, update0067, update0068, update0069, update010, update011, update012, update013, update014, update015, update020, update022, update050, update051, update052, update053, update054, update055, update056, update057, update058, update060, update061, update062, update070, update071, update072, update073, update080, update090, update0100, update0110, update0120, update0130, update0131, update0132, update0133, update0134, update0140, update0141, update0142, update0143];
 export const getUpdatesFrom = (fromVersion) => {
     const fromParts = fromVersion.split('.').map(Number);
     return updates.filter((update) => {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "includio-cms",
-	"version": "0.14.2",
+	"version": "0.14.3",
 	"scripts": {
 		"dev": "vite dev",
 		"build": "vite build && npm run prepack",