includio-cms 0.36.7 → 0.36.8

package/dist/db-postgres/schema/mediaJob.d.ts

@@ -0,0 +1,279 @@
+export declare const mediaJobTable: import("drizzle-orm/pg-core/table", { with: { "resolution-mode": "require" } }).PgTableWithColumns<{
+    name: "media_job";
+    schema: undefined;
+    columns: {
+        id: import("drizzle-orm/pg-core", { with: { "resolution-mode": "require" } }).PgColumn<{
+            name: "id";
+            tableName: "media_job";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        type: import("drizzle-orm/pg-core", { with: { "resolution-mode": "require" } }).PgColumn<{
+            name: "type";
+            tableName: "media_job";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        mediaFileId: import("drizzle-orm/pg-core", { with: { "resolution-mode": "require" } }).PgColumn<{
+            name: "media_file_id";
+            tableName: "media_job";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        payload: import("drizzle-orm/pg-core", { with: { "resolution-mode": "require" } }).PgColumn<{
+            name: "payload";
+            tableName: "media_job";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        dedupeKey: import("drizzle-orm/pg-core", { with: { "resolution-mode": "require" } }).PgColumn<{
+            name: "dedupe_key";
+            tableName: "media_job";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        status: import("drizzle-orm/pg-core", { with: { "resolution-mode": "require" } }).PgColumn<{
+            name: "status";
+            tableName: "media_job";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        priority: import("drizzle-orm/pg-core", { with: { "resolution-mode": "require" } }).PgColumn<{
+            name: "priority";
+            tableName: "media_job";
+            dataType: "number";
+            columnType: "PgInteger";
+            data: number;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        attempts: import("drizzle-orm/pg-core", { with: { "resolution-mode": "require" } }).PgColumn<{
+            name: "attempts";
+            tableName: "media_job";
+            dataType: "number";
+            columnType: "PgInteger";
+            data: number;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        maxAttempts: import("drizzle-orm/pg-core", { with: { "resolution-mode": "require" } }).PgColumn<{
+            name: "max_attempts";
+            tableName: "media_job";
+            dataType: "number";
+            columnType: "PgInteger";
+            data: number;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        lastError: import("drizzle-orm/pg-core", { with: { "resolution-mode": "require" } }).PgColumn<{
+            name: "last_error";
+            tableName: "media_job";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        runAfter: import("drizzle-orm/pg-core", { with: { "resolution-mode": "require" } }).PgColumn<{
+            name: "run_after";
+            tableName: "media_job";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        lockedAt: import("drizzle-orm/pg-core", { with: { "resolution-mode": "require" } }).PgColumn<{
+            name: "locked_at";
+            tableName: "media_job";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        lockedBy: import("drizzle-orm/pg-core", { with: { "resolution-mode": "require" } }).PgColumn<{
+            name: "locked_by";
+            tableName: "media_job";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        createdAt: import("drizzle-orm/pg-core", { with: { "resolution-mode": "require" } }).PgColumn<{
+            name: "created_at";
+            tableName: "media_job";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        updatedAt: import("drizzle-orm/pg-core", { with: { "resolution-mode": "require" } }).PgColumn<{
+            name: "updated_at";
+            tableName: "media_job";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        completedAt: import("drizzle-orm/pg-core", { with: { "resolution-mode": "require" } }).PgColumn<{
+            name: "completed_at";
+            tableName: "media_job";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: "pg";
+}>;

package/dist/db-postgres/schema/mediaJob.js

@@ -0,0 +1,23 @@
+import { integer, pgTable, text, timestamp, uniqueIndex, index, uuid } from 'drizzle-orm/pg-core';
+export const mediaJobTable = pgTable('media_job', {
+    id: uuid('id').primaryKey().defaultRandom(),
+    type: text('type').notNull(), // 'image_style' (na start; rozszerzalne: video_poster, video_transcode)
+    mediaFileId: uuid('media_file_id').notNull(),
+    payload: text('payload').notNull(), // JSON.stringify(ImageFieldStyle)
+    dedupeKey: text('dedupe_key').notNull(),
+    status: text('status').notNull().default('pending'), // pending|processing|done|failed|skipped
+    priority: integer('priority').notNull().default(0), // wyżej = pilniejsze
+    attempts: integer('attempts').notNull().default(0),
+    maxAttempts: integer('max_attempts').notNull().default(3),
+    lastError: text('last_error'),
+    runAfter: timestamp('run_after').notNull().defaultNow(),
+    lockedAt: timestamp('locked_at'),
+    lockedBy: text('locked_by'),
+    createdAt: timestamp('created_at').notNull().defaultNow(),
+    updatedAt: timestamp('updated_at').notNull().defaultNow(),
+    completedAt: timestamp('completed_at')
+}, (t) => [
+    uniqueIndex('media_job_dedupe_key').on(t.dedupeKey),
+    index('media_job_claim_idx').on(t.status, t.runAfter, t.priority),
+    index('media_job_media_idx').on(t.mediaFileId)
+]);

package/dist/sveltekit/components/image.svelte

@@ -59,7 +59,7 @@
 				{/each}
 
 				<img
-					src={data.data.url}
+					src={data.data.fallbackUrl ?? data.data.url}
 					alt={data.data.alt}
 					width={data.data.width}
 					height={data.data.height}

package/dist/types/adapters/db.d.ts

@@ -46,6 +46,14 @@ export interface DatabaseAdapter {
     getImageStyle: GetImageStyle;
     getImageStylesBatch: GetImageStylesBatch;
     createImageStyle: CreateImageStyle;
+    enqueueMediaJob: EnqueueMediaJob;
+    claimNextMediaJob: ClaimNextMediaJob;
+    completeMediaJob: CompleteMediaJob;
+    failMediaJob: FailMediaJob;
+    resetStaleMediaJobs: ResetStaleMediaJobs;
+    listMediaJobs: ListMediaJobs;
+    countMediaJobs: CountMediaJobs;
+    retryMediaJob: RetryMediaJob;
     deleteImageStylesByMediaFileId: DeleteImageStylesByMediaFileId;
     getAllImageStyles: GetAllImageStyles;
     deleteAllImageStyles: DeleteAllImageStyles;
@@ -139,6 +147,49 @@ export type DeleteMediaTag = (id: string) => Promise<void>;
 export type SetMediaFileTags = (fileId: string, tagIds: string[]) => Promise<void>;
 export type BulkSetMediaFileTags = (fileIds: string[], tagIds: string[]) => Promise<void>;
 export type BulkDeleteMediaFiles = (ids: string[]) => Promise<void>;
+export type MediaJobStatus = 'pending' | 'processing' | 'done' | 'failed' | 'skipped';
+export interface MediaJob {
+    id: string;
+    type: string;
+    mediaFileId: string;
+    payload: string;
+    dedupeKey: string;
+    status: MediaJobStatus;
+    priority: number;
+    attempts: number;
+    maxAttempts: number;
+    lastError: string | null;
+    runAfter: Date;
+    lockedAt: Date | null;
+    lockedBy: string | null;
+    createdAt: Date;
+    updatedAt: Date;
+    completedAt: Date | null;
+}
+export interface EnqueueMediaJobInput {
+    type: string;
+    mediaFileId: string;
+    payload: string;
+    dedupeKey: string;
+    priority?: number;
+    maxAttempts?: number;
+}
+export type EnqueueMediaJob = (input: EnqueueMediaJobInput) => Promise<void>;
+export type ClaimNextMediaJob = (lockedBy: string) => Promise<MediaJob | null>;
+export type CompleteMediaJob = (id: string) => Promise<void>;
+export type FailMediaJob = (id: string, error: string, opts: {
+    retry: boolean;
+    runAfter?: Date;
+}) => Promise<void>;
+export type ResetStaleMediaJobs = (olderThan: Date) => Promise<number>;
+export type ListMediaJobs = (opts: {
+    status?: MediaJobStatus;
+    type?: string;
+    limit: number;
+    offset?: number;
+}) => Promise<MediaJob[]>;
+export type CountMediaJobs = () => Promise<Record<MediaJobStatus, number>>;
+export type RetryMediaJob = (id: string) => Promise<void>;
 export type UpdateMediaFile = (data: {
     id: string;
     data: Partial<MediaFile>;

package/dist/types/cms.d.ts

@@ -30,11 +30,57 @@ export interface MaintenanceConfig {
     /** Interval in hours between maintenance runs (default: 6) */
     intervalHours?: number;
 }
+export interface ImagesConfig {
+    /** Formaty wariantów (default: ['avif','webp']). Oryginał zostaje jako plik/fallback. */
+    formats: ('avif' | 'webp' | 'jpeg' | 'png')[];
+    /** Szerokości srcset (default: [640,1024,1536,2560]). Bez wariantu bazowego pełno-res. */
+    widths: number[];
+    /** Jakość per format (default: avif 52 / webp 78 / jpeg 80) */
+    quality: {
+        avif: number;
+        webp: number;
+        jpeg: number;
+    };
+    /** Twardy cap wymiaru wariantu (default: 2560) */
+    maxDimension: number;
+    /** Lekki fallback generowany synchronicznie przy uploadzie (default: 1280 jpeg) */
+    fallback: {
+        width: number;
+        format: 'jpeg' | 'webp';
+    };
+}
+export interface ImagesConfigInput {
+    formats?: ('avif' | 'webp' | 'jpeg' | 'png')[];
+    widths?: number[];
+    quality?: Partial<ImagesConfig['quality']>;
+    maxDimension?: number;
+    fallback?: Partial<ImagesConfig['fallback']>;
+}
+export interface OptimizationConfig {
+    /** In-process worker generujący warianty w tle (default: true) */
+    worker?: boolean;
+    /** Ile jobów sharp naraz (default: 1) */
+    concurrency?: number;
+    /** Prób przed oznaczeniem failed (default: 3) */
+    maxAttempts?: number;
+    /** Baza backoffu wykładniczego w ms (default: 30000) */
+    backoffBaseMs?: number;
+    /** Po jakim czasie processing uznać za martwe i wrócić do pending (default: 300000) */
+    staleLockMs?: number;
+    /** Interwał pollingu kolejki gdy pusta (default: 2000) */
+    pollIntervalMs?: number;
+    /** Limit pikseli źródła — poison-guard „image bomb" (default: 100_000_000) */
+    limitPixels?: number;
+    /** sharp.cache memory MB (default: 50) */
+    cacheMemoryMB?: number;
+}
 export interface MediaConfig {
     maxOriginalWidth?: number;
     maxOriginalHeight?: number;
     video?: VideoTranscodeConfig;
     maintenance?: MaintenanceConfig;
+    images?: ImagesConfigInput;
+    optimization?: OptimizationConfig;
 }
 export interface AuthAdapter {
     api: {

package/dist/types/media.d.ts

@@ -37,6 +37,7 @@ export interface MediaFile {
     posterUrl: string | null;
     mimeType: string | null;
     blurDataUrl: string | null;
+    fallbackUrl?: string | null;
     focalX: number | null;
     focalY: number | null;
     transcriptFileId: string | null;

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

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

package/dist/updates/0.36.8/index.js

@@ -0,0 +1,20 @@
+export const update = {
+    version: '0.36.8',
+    date: '2026-07-02',
+    description: 'Optymalizacja obrazów przeniesiona do tła: render nigdy nie odpala sharpa. Warianty generuje in-process worker zasilany trwałą kolejką media_job (concurrency=1, twarde limity sharp, retry/backoff, circuit-breaker). Lżejsza, konfigurowalna matryca (avif+webp, bez pełno-res bazy, cap 2560) tnie ~połowę plików/jobów i eliminuje bombę CPU pełno-res AVIF, która OOM-owała VPS.',
+    features: [
+        'Kolejka `media_job` + in-process worker: claim `FOR UPDATE SKIP LOCKED`, backoff wykładniczy, circuit-breaker po N próbach, poison-guard `limitInputPixels`, reset stale-locków. Start w `initCMS`, wyłączalny `media.optimization.worker=false`.',
+        'Render kolejkuje brakujące style zamiast generować synchronicznie — odpowiedź HTTP nigdy nie czeka na sharpa; frontend serwuje lekki fallback + blur do czasu gotowości wariantów.',
+        'Konfigurowalna matryca `mediaConfig.images`: `formats` (domyślnie avif+webp), `widths` [640,1024,1536,2560], `quality`, `maxDimension` (2560), `fallback` (jpeg ~1280). Bez wariantu bazowego pełno-res i bez martwej drabiny w formacie oryginalnym (~15 → ~8 wariantów/obraz).',
+        'Upload generuje synchronicznie lekki fallback (`media_file.fallback_url`) i kolejkuje warianty; sweep oraz `replaceFile` też kolejkują (nie generują inline).',
+        'Admin `/admin/maintenance`: sekcja „Kolejka mediów / Logi" — liczniki pending/processing/failed, lista failed z akcjami Ponów/Pomiń.',
+        'Globalne limity sharp (`sharp.concurrency`/`cache`) ustawiane raz przy init. Deduplikacja zadań po efektywnej specyfikacji (format+wymiary+crop+quality).',
+        'Public API: `enqueueStyleSpecs`, `startMediaWorker`, `stopMediaWorker`, typy `MediaJob`/`MediaJobStatus`.'
+    ],
+    fixes: [
+        '`image_styles`: dodany `crop` do klucza unikalnego (koniec cichego nadpisywania wariantów różniących się tylko cropem) + spójny `ON CONFLICT`.'
+    ],
+    breakingChanges: [
+        'Nowa tabela `media_job` i kolumna `media_file.fallback_url` — wymagana migracja (`drizzle-kit push`). Render nie generuje styli synchronicznie (dogeneruje worker w tle). Konsumenci, którzy wyłączyli auto-maintenance z powodu OOM, mogą usunąć `media.maintenance.autoRun=false` — nowy worker jest bezpieczny by-design.'
+    ]
+};

package/dist/updates/index.js

@@ -73,6 +73,7 @@ import { update as update0363 } from './0.36.3/index.js';
 import { update as update0364 } from './0.36.4/index.js';
 import { update as update0365 } from './0.36.5/index.js';
 import { update as update0367 } from './0.36.7/index.js';
+import { update as update0368 } from './0.36.8/index.js';
 export const updates = [
     update0065,
     update0066,
@@ -148,7 +149,8 @@ export const updates = [
     update0363,
     update0364,
     update0365,
-    update0367
+    update0367,
+    update0368
 ];
 export const getUpdatesFrom = (fromVersion) => {
     const fromParts = fromVersion.split('.').map(Number);

package/package.json

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