includio-cms 0.36.7 → 0.36.9

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/0.36.9/index.d.ts

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

package/dist/updates/0.36.9/index.js

@@ -0,0 +1,12 @@
+export const update = {
+    version: '0.36.9',
+    date: '2026-07-02',
+    description: 'Duplikacja wpisu z tabeli kolekcji + serwerowa normalizacja pól slug przy zapisie. Menu wiersza zyskuje „Duplikuj" — tworzy nieopublikowany szkic z tą samą treścią (wszystkie języki), z prefiksem tytułu „Kopia — " i unikalnym slugiem („-kopia"), i przenosi do edytora duplikatu. Media i relacje są współdzielone przez referencje (bez głębokiego klonu). Niezależnie od duplikacji: każde pole typu slug (SlugField oraz slug w polu SEO) jest przy zapisie normalizowane przez slugify — „Singapur"/„Hello World" zapisują się jako „singapur"/„hello-world", transparentnie dla użytkownika. Spec: `docs/superpowers/specs/2026-07-02-duplicate-entry-and-slug-normalization-design.md`, plan: `docs/superpowers/plans/2026-07-02-duplicate-entry-and-slug-normalization.md`.',
+    features: [
+        'Duplikacja wpisu (`duplicateEntry` + remote `duplicateEntryCommand`, akcja „Duplikuj" w menu wiersza tabeli kolekcji `/admin/collections/[collection]`): kopiuje najświeższą treść per język (draft ?? published ?? scheduled) na nowy wpis jako wersje nieopublikowane (`publishedAt: null`), prefiksuje `entryAdminTitle` przez „Kopia — " i nadaje każdemu polu slug unikalny sufiks („-kopia", „-kopia-2", …) sprawdzany wobec published-or-scheduled slugów kolekcji, po czym przenosi do edytora duplikatu. Media/relacje = współdzielone referencje. Akcja ukryta dla wpisów archiwalnych.'
+    ],
+    fixes: [
+        'Normalizacja slug przy zapisie (`normalizeSlugFields` wpięte w `updateEntryVersionCommand`, ścieżka draft i publish): wartości pól typu slug (SlugField oraz slug w polu SEO) są normalizowane przez `slugify({ lower, strict, trim })` przed zapisem i przed kontrolą unikalności. Nietechniczny użytkownik wpisujący np. „Singapur" czy „Hello World" dostaje poprawny „singapur"/„hello-world" bez ręcznej korekty. Puste/nie-string i pola nie-slug pozostają nietknięte.'
+    ],
+    breakingChanges: []
+};

package/dist/updates/index.js

@@ -73,6 +73,8 @@ 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';
+import { update as update0369 } from './0.36.9/index.js';
 export const updates = [
     update0065,
     update0066,
@@ -148,7 +150,9 @@ export const updates = [
     update0363,
     update0364,
     update0365,
-    update0367
+    update0367,
+    update0368,
+    update0369
 ];
 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.9",
 	"scripts": {
 		"dev": "vite dev",
 		"build": "vite build && npm run prepack",