includio-cms 0.36.6 → 0.36.8

package/API.md

@@ -1,8 +1,8 @@
-# includio-cms — Public API v0.36.6
+# includio-cms — Public API v0.36.8
 
 > Auto-generated by `scripts/generate-api-md.ts`. Do not edit by hand.
 
-Entry points: **19** · Stable: **495** · Experimental: **4**
+Entry points: **19** · Stable: **501** · Experimental: **4**
 
 Tags:
 - `@public` — frozen for v1.0; semver-protected.
@@ -28,10 +28,15 @@ Tags:
 ### `includio-cms/core/server`
 
 - `createEntityAPI(cms: CMS, opts?: EntityAPIOptions): <inferred>` — Creates a high-level Entity API (CRUD + publish/archive) bound to a CMS
+- `enqueueStyleSpecs(mediaFile: Pick<MediaFile, 'id' | 'width' | 'height'>, fieldStyles: ImageFieldStyle[] | undefined, opts: { priority?:...): Promise<void>` — Kolejkuje generację wszystkich wariantów dla media (upload / render-miss / sweep). Idempotentne po dedupeKey.
 - `getAuth(): <inferred>` — Returns the underlying `better-auth` instance from the initialized CMS.
 - `getCMS(): CMS` — Returns the singleton CMS instance. Must be called after `includioCMS()`
+- `interface MediaJob`
+- `type MediaJobStatus = 'pending' | 'processing' | 'done' | 'failed' | 'skipped'`
 - `interface ResolvedMedia` — Resolved media file plus its image styles + blur placeholder. Returned by
 - `resolveMediaWithStyles(mediaIds: string[], styles?: ImageFieldStyle[]): Promise<Record<string, ResolvedMedia>>` — Resolve media files by IDs and generate image styles. Useful for plugins or
+- `startMediaWorker(cfg: WorkerConfig, deps: RunOnceDeps): void` — Startuje ciągłą pętlę workera (idempotentne). Concurrency=1: jeden job naraz.
+- `stopMediaWorker(): void`
 
 ### `includio-cms/types`
 
@@ -356,6 +361,7 @@ Tags:
 - `const invitation: <inferred>`
 - `const mediaFilesTable: <inferred>`
 - `const mediaFileTagsTable: <inferred>`
+- `const mediaJobTable: <inferred>`
 - `const mediaTagsTable: <inferred>`
 - `pg(config: Config): DatabaseAdapterWithDrizzle` — Postgres database adapter (drizzle + `postgres`).
 - `const session: <inferred>`

package/CHANGELOG.md

@@ -3,6 +3,36 @@
 All notable changes to includio-cms are documented here.
 Generated from `src/lib/updates/` — do not edit manually.
 
+## 0.36.8 — 2026-07-02
+
+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.
+
+### Added
+- 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`.
+
+### Fixed
+- `image_styles`: dodany `crop` do klucza unikalnego (koniec cichego nadpisywania wariantów różniących się tylko cropem) + spójny `ON CONFLICT`.
+
+### Breaking
+- 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.
+
+## 0.36.7 — 2026-06-24
+
+Faktura uwzględnia rabat z kuponu i koszt wysyłki. Pozycje są wystawiane w cenach po rabacie (finalna kwota = kwota zapłacona), a użyty kod rabatowy trafia do uwag faktury. Wcześniej faktura zawierała pełne ceny katalogowe i pomijała rabat.
+
+### Added
+- Rabat z kuponu na fakturze: ceny pozycji obniżone proporcjonalnie do udziału brutto (reszta zaokrąglenia do ostatniej pozycji), suma = `order.totalGross`. Kod rabatowy dopisywany do uwag faktury (Fakturownia: pole `description`), zlokalizowany PL/EN wg języka zamówienia.
+- Koszt wysyłki dodawany jako pozycja „Wysyłka" gdy > 0 (VAT rekonstruowany z net/gross, fallback 23%).
+
+### Fixed
+- Faktury z kuponem nie pomijają już rabatu — wartość faktury zgadza się z kwotą zapłaconą przez klienta.
+
 ## 0.36.5 — 2026-06-11
 
 Zależności tiptap przypięte do exact `3.26.1` (wcześniej `^3.17.1`). Rozjazd zakresów powodował, że konsument mógł rozwiązać rdzeń `@tiptap/core` na inną wersję niż rozszerzenia (np. core 3.22.3 vs extension-highlight 3.26.1), co wywalało produkcyjny build („getStyleProperty is not exported by @tiptap/core"). Bez potrzeby override po stronie projektu.

package/DOCS.md

@@ -1,4 +1,4 @@
-# Includio CMS Documentation (v0.36.6)
+# Includio CMS Documentation (v0.36.8)
 
 > This file is auto-generated from the docs site. For the latest version, update the package.
 

package/dist/admin/api/handler.js

@@ -11,6 +11,7 @@ import * as transcodeVideosHandlers from './transcode-videos.js';
 import * as uploadLimitHandlers from './upload-limit.js';
 import * as systemInfoHandlers from './system-info.js';
 import * as maintenanceStatusHandlers from './maintenance-status.js';
+import * as mediaJobsHandlers from './media-jobs.js';
 import * as integrationsHandlers from './integrations.js';
 import * as testEmailHandlers from './test-email.js';
 import { requireAuth } from '../remote/middleware/auth.js';
@@ -30,6 +31,7 @@ export function createAdminApiHandler(options) {
         'upload-limit': uploadLimitHandlers,
         'system-info': systemInfoHandlers,
         'maintenance-status': maintenanceStatusHandlers,
+        'media-jobs': mediaJobsHandlers,
         integrations: integrationsHandlers,
         'test-email': testEmailHandlers,
         ...options?.extraRoutes

package/dist/admin/api/media-jobs.d.ts

@@ -0,0 +1,5 @@
+import { type RequestHandler } from '@sveltejs/kit';
+/** GET /admin/api/media-jobs?status=&type=&limit=&offset= → { counts, jobs } */
+export declare const GET: RequestHandler;
+/** POST /admin/api/media-jobs { id, action: 'retry' | 'skip' } */
+export declare const POST: RequestHandler;

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

@@ -0,0 +1,33 @@
+import { requireRole } from '../remote/middleware/auth.js';
+import { getCMS } from '../../core/cms.js';
+import { json } from '@sveltejs/kit';
+/** GET /admin/api/media-jobs?status=&type=&limit=&offset= → { counts, jobs } */
+export const GET = async ({ url }) => {
+    requireRole('admin');
+    const status = url.searchParams.get('status') ?? undefined;
+    const type = url.searchParams.get('type') ?? undefined;
+    const limit = Number(url.searchParams.get('limit') ?? 50);
+    const offset = Number(url.searchParams.get('offset') ?? 0);
+    const db = getCMS().databaseAdapter;
+    const [counts, jobs] = await Promise.all([
+        db.countMediaJobs(),
+        db.listMediaJobs({ status, type, limit, offset })
+    ]);
+    return json({ counts, jobs });
+};
+/** POST /admin/api/media-jobs { id, action: 'retry' | 'skip' } */
+export const POST = async ({ request }) => {
+    requireRole('admin');
+    const body = (await request.json());
+    if (!body.id || (body.action !== 'retry' && body.action !== 'skip')) {
+        return json({ error: 'Invalid request' }, { status: 400 });
+    }
+    const db = getCMS().databaseAdapter;
+    if (body.action === 'retry') {
+        await db.retryMediaJob(body.id);
+    }
+    else {
+        await db.failMediaJob(body.id, 'skipped by admin', { retry: false });
+    }
+    return json({ ok: true });
+};

package/dist/admin/client/maintenance/maintenance-page.svelte

@@ -26,6 +26,7 @@
 	import { useInterfaceLanguage } from '../../state/interface-language.svelte.js';
 	import { sidebarLang } from '../../components/layout/lang.js';
 	import PageHeader from '../../components/layout/page-header.svelte';
+	import MediaJobsPanel from './media-jobs-panel.svelte';
 
 	const breadcrumbs = getBreadcrumbs();
 	const interfaceLanguage = useInterfaceLanguage();
@@ -695,6 +696,14 @@
 			</div>
 		</div>
 
+		<!-- Section: Media jobs / Logs -->
+		<div class="mb-8">
+			<h2 class="mb-3 text-sm font-semibold uppercase tracking-wider" style="color: var(--muted-foreground);">
+				Kolejka mediów / Logi
+			</h2>
+			<MediaJobsPanel />
+		</div>
+
 		<!-- Section: File Integrity -->
 		<div class="mb-8">
 			<h2 class="mb-3 text-sm font-semibold uppercase tracking-wider" style="color: var(--muted-foreground);">

package/dist/admin/client/maintenance/media-jobs-panel.svelte

@@ -0,0 +1,310 @@
+<script lang="ts">
+	import { onMount } from 'svelte';
+	import Loader2 from '@tabler/icons-svelte/icons/loader-2';
+	import Refresh from '@tabler/icons-svelte/icons/refresh';
+	import PlayerSkipForward from '@tabler/icons-svelte/icons/player-skip-forward';
+	import ListDetails from '@tabler/icons-svelte/icons/list-details';
+	import AlertTriangle from '@tabler/icons-svelte/icons/alert-triangle';
+	import Button from '../../../components/ui/button/button.svelte';
+	import * as Card from '../../../components/ui/card/index.js';
+	import { toast } from 'svelte-sonner';
+
+	type JobStatus = 'pending' | 'processing' | 'done' | 'failed' | 'skipped';
+	type StatusFilter = 'all' | 'failed' | 'pending' | 'processing';
+
+	interface JobCounts {
+		pending: number;
+		processing: number;
+		done: number;
+		failed: number;
+		skipped: number;
+	}
+
+	interface MediaJob {
+		id: string;
+		type: string;
+		mediaFileId: string;
+		payload: string;
+		status: JobStatus;
+		priority: number;
+		attempts: number;
+		maxAttempts: number;
+		lastError: string | null;
+		runAfter: string;
+		updatedAt: string;
+		completedAt: string | null;
+	}
+
+	interface MediaJobsResponse {
+		counts: JobCounts;
+		jobs: MediaJob[];
+	}
+
+	const filters: { value: StatusFilter; label: string }[] = [
+		{ value: 'all', label: 'Wszystkie' },
+		{ value: 'failed', label: 'Błędy' },
+		{ value: 'pending', label: 'Oczekujące' },
+		{ value: 'processing', label: 'W trakcie' }
+	];
+
+	const statusLabels: Record<JobStatus, string> = {
+		pending: 'Oczekuje',
+		processing: 'W trakcie',
+		done: 'Gotowe',
+		failed: 'Błąd',
+		skipped: 'Pominięte'
+	};
+
+	function statusColor(status: JobStatus): string {
+		switch (status) {
+			case 'done':
+				return 'var(--success, #3A8A5C)';
+			case 'failed':
+				return 'var(--error, #C44B4B)';
+			case 'processing':
+				return 'var(--primary)';
+			case 'pending':
+				return 'var(--warning, #C4893A)';
+			default:
+				return 'var(--muted-foreground)';
+		}
+	}
+
+	function styleLabel(payload: string): string {
+		try {
+			const p = JSON.parse(payload) as { name?: string; format?: string; width?: number };
+			if (p.name) return p.name;
+			if (p.format && p.width) return `${p.format} · ${p.width}w`;
+			if (p.format) return p.format;
+		} catch {
+			// fall through to raw payload
+		}
+		return payload;
+	}
+
+	function truncate(text: string, max = 60): string {
+		return text.length > max ? `${text.slice(0, max)}…` : text;
+	}
+
+	function timeAgo(dateStr: string): string {
+		const diff = Date.now() - new Date(dateStr).getTime();
+		const mins = Math.floor(diff / 60000);
+		if (mins < 1) return 'przed chwilą';
+		if (mins < 60) return `${mins} min temu`;
+		const hours = Math.floor(mins / 60);
+		if (hours < 24) return `${hours}h temu`;
+		return `${Math.floor(hours / 24)}d temu`;
+	}
+
+	let counts = $state<JobCounts>({ pending: 0, processing: 0, done: 0, failed: 0, skipped: 0 });
+	let jobs = $state<MediaJob[]>([]);
+	let statusFilter = $state<StatusFilter>('all');
+	let loading = $state(true);
+	let error = $state<string | null>(null);
+	let actioningId = $state<string | null>(null);
+
+	let counterItems = $derived([
+		{ label: 'Oczekujące', value: counts.pending, color: 'var(--warning, #C4893A)' },
+		{ label: 'W trakcie', value: counts.processing, color: 'var(--primary)' },
+		{ label: 'Gotowe', value: counts.done, color: 'var(--success, #3A8A5C)' },
+		{ label: 'Błędy', value: counts.failed, color: 'var(--error, #C44B4B)' },
+		{ label: 'Pominięte', value: counts.skipped, color: 'var(--muted-foreground)' }
+	]);
+
+	async function loadJobs(filter: StatusFilter, showLoading = false) {
+		if (showLoading) loading = true;
+		try {
+			const params = new URLSearchParams({ limit: '50' });
+			if (filter !== 'all') params.set('status', filter);
+			const res = await fetch(`/admin/api/media-jobs?${params.toString()}`);
+			if (!res.ok) throw new Error(`HTTP ${res.status}`);
+			const data = (await res.json()) as MediaJobsResponse;
+			counts = data.counts;
+			jobs = data.jobs;
+			error = null;
+		} catch {
+			error = 'Nie udało się załadować kolejki mediów';
+		} finally {
+			loading = false;
+		}
+	}
+
+	async function doAction(id: string, action: 'retry' | 'skip') {
+		actioningId = id;
+		try {
+			const res = await fetch('/admin/api/media-jobs', {
+				method: 'POST',
+				headers: { 'Content-Type': 'application/json' },
+				body: JSON.stringify({ id, action })
+			});
+			if (!res.ok) throw new Error(`HTTP ${res.status}`);
+			toast.success(action === 'retry' ? 'Zadanie ponowione' : 'Zadanie pominięte');
+			await loadJobs(statusFilter);
+		} catch {
+			toast.error('Nie udało się wykonać akcji');
+		} finally {
+			actioningId = null;
+		}
+	}
+
+	// Refetch on mount and whenever the status filter changes.
+	$effect(() => {
+		loadJobs(statusFilter, true);
+	});
+
+	// Poll every 5s; interval cleaned up on unmount.
+	onMount(() => {
+		const id = setInterval(() => loadJobs(statusFilter), 5000);
+		return () => clearInterval(id);
+	});
+</script>
+
+<Card.Root>
+	<Card.Header class="pb-3">
+		<div class="flex flex-wrap items-center justify-between gap-3">
+			<div class="flex items-center gap-2">
+				<ListDetails class="size-5" style="color: var(--primary);" />
+				<Card.Title class="text-base">Kolejka zadań</Card.Title>
+			</div>
+			<div class="flex flex-wrap gap-1.5">
+				{#each filters as f (f.value)}
+					<Button
+						variant={statusFilter === f.value ? 'default' : 'outline'}
+						size="sm"
+						onclick={() => (statusFilter = f.value)}
+					>
+						{f.label}
+					</Button>
+				{/each}
+			</div>
+		</div>
+
+		<div class="mt-3 flex flex-wrap gap-2">
+			{#each counterItems as c (c.label)}
+				<div
+					class="flex items-center gap-1.5 rounded-md px-2.5 py-1 text-xs"
+					style="background: color-mix(in srgb, {c.color} 12%, transparent);"
+				>
+					<span class="font-semibold" style="color: {c.color};">{c.value}</span>
+					<span style="color: var(--muted-foreground);">{c.label}</span>
+				</div>
+			{/each}
+		</div>
+	</Card.Header>
+
+	<Card.Content>
+		{#if loading && jobs.length === 0}
+			<div class="flex items-center justify-center py-12">
+				<Loader2 class="size-6 animate-spin" style="color: var(--muted-foreground);" />
+			</div>
+		{:else if error && jobs.length === 0}
+			<div
+				class="flex items-center gap-2 rounded-md px-3 py-3 text-sm"
+				style="background: color-mix(in srgb, var(--error, #C44B4B) 12%, transparent); color: var(--error, #C44B4B);"
+			>
+				<AlertTriangle class="size-4 shrink-0" />
+				{error}
+			</div>
+		{:else if jobs.length === 0}
+			<p class="py-8 text-center text-sm" style="color: var(--muted-foreground);">Brak zadań</p>
+		{:else}
+			{#if error}
+				<p class="mb-3 flex items-center gap-1.5 text-xs" style="color: var(--error, #C44B4B);">
+					<AlertTriangle class="size-3.5 shrink-0" />
+					{error} — pokazano ostatnie dane
+				</p>
+			{/if}
+			<div class="overflow-x-auto">
+				<table class="w-full text-sm">
+					<thead>
+						<tr class="border-b text-left" style="border-color: var(--border);">
+							<th class="px-3 py-2 font-medium" style="color: var(--muted-foreground);">Media</th>
+							<th class="px-3 py-2 font-medium" style="color: var(--muted-foreground);">Styl</th>
+							<th class="px-3 py-2 font-medium" style="color: var(--muted-foreground);">Status</th>
+							<th class="px-3 py-2 font-medium" style="color: var(--muted-foreground);">Prób</th>
+							<th class="px-3 py-2 font-medium" style="color: var(--muted-foreground);">Błąd</th>
+							<th class="px-3 py-2 font-medium" style="color: var(--muted-foreground);">Zaktualizowano</th>
+							<th class="px-3 py-2"></th>
+						</tr>
+					</thead>
+					<tbody>
+						{#each jobs as job (job.id)}
+							<tr class="border-b" style="border-color: var(--border);">
+								<td class="px-3 py-2">
+									<span class="font-mono text-xs" title={job.mediaFileId}
+										>{job.mediaFileId.slice(0, 8)}</span
+									>
+								</td>
+								<td class="px-3 py-2">
+									<span title={job.payload}>{styleLabel(job.payload)}</span>
+								</td>
+								<td class="px-3 py-2">
+									<span
+										class="inline-flex items-center gap-1 rounded-full px-2 py-0.5 text-xs font-medium"
+										style="background: color-mix(in srgb, {statusColor(
+											job.status
+										)} 15%, transparent); color: {statusColor(job.status)};"
+									>
+										{#if job.status === 'processing'}
+											<Loader2 class="size-3 animate-spin" />
+										{/if}
+										{statusLabels[job.status]}
+									</span>
+								</td>
+								<td class="px-3 py-2 whitespace-nowrap" style="color: var(--muted-foreground);">
+									{job.attempts}/{job.maxAttempts}
+								</td>
+								<td class="px-3 py-2">
+									{#if job.lastError}
+										<span
+											class="text-xs"
+											style="color: var(--error, #C44B4B);"
+											title={job.lastError}>{truncate(job.lastError)}</span
+										>
+									{:else}
+										<span style="color: var(--muted-foreground);">—</span>
+									{/if}
+								</td>
+								<td
+									class="px-3 py-2 whitespace-nowrap"
+									style="color: var(--muted-foreground);"
+									title={new Date(job.updatedAt).toLocaleString('pl-PL')}
+								>
+									{timeAgo(job.updatedAt)}
+								</td>
+								<td class="px-3 py-2">
+									{#if job.status === 'failed'}
+										<div class="flex justify-end gap-1.5">
+											<Button
+												variant="outline"
+												size="sm"
+												onclick={() => doAction(job.id, 'retry')}
+												disabled={actioningId === job.id}
+											>
+												{#if actioningId === job.id}
+													<Loader2 class="size-3.5 animate-spin" />
+												{:else}
+													<Refresh class="size-3.5" />
+												{/if}
+												Ponów
+											</Button>
+											<Button
+												variant="ghost"
+												size="sm"
+												onclick={() => doAction(job.id, 'skip')}
+												disabled={actioningId === job.id}
+											>
+												<PlayerSkipForward class="size-3.5" />
+												Pomiń
+											</Button>
+										</div>
+									{/if}
+								</td>
+							</tr>
+						{/each}
+					</tbody>
+				</table>
+			</div>
+		{/if}
+	</Card.Content>
+</Card.Root>

package/dist/admin/client/maintenance/media-jobs-panel.svelte.d.ts

@@ -0,0 +1,3 @@
+declare const MediaJobsPanel: import("svelte").Component<Record<string, never>, {}, "">;
+type MediaJobsPanel = ReturnType<typeof MediaJobsPanel>;
+export default MediaJobsPanel;

package/dist/core/cms.js

@@ -178,6 +178,13 @@ export function initCMS(config) {
     import('./server/media/operations/backgroundMaintenance.js')
         .then((m) => m.startBackgroundMaintenance())
         .catch((e) => console.warn('[cms] Failed to start background maintenance:', e));
+    // Start in-process media optimization worker (generuje warianty poza ścieżką renderu).
+    // Wyłączalny przez media.optimization.worker = false.
+    if (cms.mediaConfig.optimization?.worker !== false) {
+        import('./server/media/jobs/startWorker.js')
+            .then((m) => m.startMediaOptimizationWorker())
+            .catch((e) => console.warn('[cms] Failed to start media worker:', e));
+    }
     // Apply shop variantAttribute GIN indexes (idempotent CREATE INDEX IF NOT EXISTS).
     // Pass shop + drizzle explicitly so the dynamic import doesn't depend on a
     // shared CMS singleton (vitest can give the dynamic module a fresh instance).

package/dist/core/server/fields/utils/imageStyles.js

@@ -2,6 +2,8 @@ import { getImageStylesBatch } from '../../media/styles/operations/getImageStyle
 import { imageStyleKey } from '../../../../types/adapters/db.js';
 import { getCMS } from '../../../cms.js';
 import { generateBlurDataUrl } from '../../media/utils/generateBlurDataUrl.js';
+import { buildStyleSpecs } from '../../media/styles/buildStyleSpecs.js';
+import { resolveImagesConfig } from '../../media/styles/imagesConfig.js';
 export const defaultStyles = [
     { name: 'default', srcset: [640, 1024, 1920, 2560] }
 ];
@@ -72,10 +74,45 @@ function variantStyleFor(style, w) {
 }
 export async function getImageStyles(field, val) {
     const hasCustomStyles = field.styles && field.styles.length > 0;
-    const rawStyles = [...(isProcessableImage(val) && !hasCustomStyles ? defaultStyles : []), ...(field.styles || [])];
-    const originalFormat = getOriginalFormat(val);
-    const stylesArr = expandStyleFormats(rawStyles, originalFormat);
-    // Collect every (mediaFileId, style) request — base styles + srcset variants — into one batch.
+    // Custom field.styles: zachowaj dotychczasową semantykę (expand formatów + baza pełno-res + srcset).
+    if (hasCustomStyles) {
+        return resolveLegacyStyles(expandStyleFormats(field.styles, getOriginalFormat(val)), val);
+    }
+    // Domyślnie: nowa lekka matryca z configu (avif+webp × szerokości, BEZ bazy pełno-res).
+    // Grupujemy warianty po formacie → jeden <source> per format ze srcset (bez bramki bazy).
+    const specs = isProcessableImage(val)
+        ? buildStyleSpecs(val, undefined, resolveImagesConfig(getCMS().mediaConfig.images))
+        : [];
+    const requests = specs.map((style) => ({ mediaFileId: val.id, style }));
+    const [styleMap, blurDataUrl] = await Promise.all([
+        getImageStylesBatch(requests),
+        ensureBlurDataUrl(val)
+    ]);
+    const byFormat = new Map();
+    for (const style of specs) {
+        const data = styleMap.get(imageStyleKey(val.id, style));
+        if (!data || typeof style.width !== 'number')
+            continue;
+        const fmt = style.format ?? 'orig';
+        const group = byFormat.get(fmt) ?? { media: data.media, mimeType: data.mimeType, variants: [] };
+        group.variants.push({ url: data.url, w: style.width });
+        byFormat.set(fmt, group);
+    }
+    const styles = {};
+    for (const [fmt, group] of byFormat) {
+        group.variants.sort((a, b) => a.w - b.w);
+        const largest = group.variants[group.variants.length - 1];
+        styles[`default_${fmt}`] = {
+            url: largest.url,
+            media: group.media,
+            mimeType: group.mimeType,
+            srcset: group.variants.map((v) => `${v.url} ${v.w}w`).join(', ')
+        };
+    }
+    return { styles, blurDataUrl };
+}
+/** Stara ścieżka dla custom field.styles: styl bazowy pełno-res (bramka istnienia) + srcset wariantów. */
+async function resolveLegacyStyles(stylesArr, val) {
     const requests = [];
     for (const style of stylesArr) {
         requests.push({ mediaFileId: val.id, style });

package/dist/core/server/index.d.ts

@@ -2,3 +2,6 @@ export { getCMS } from '../cms.js';
 export { resolveMediaWithStyles, type ResolvedMedia } from './fields/utils/resolveMedia.js';
 export { createEntityAPI } from '../../entity/index.js';
 export { getAuth } from '../../server/auth.js';
+export { enqueueStyleSpecs } from './media/jobs/enqueue.js';
+export { startMediaWorker, stopMediaWorker } from './media/jobs/worker.js';
+export type { MediaJob, MediaJobStatus } from '../../types/adapters/db.js';

package/dist/core/server/index.js

@@ -2,3 +2,6 @@ export { getCMS } from '../cms.js';
 export { resolveMediaWithStyles } from './fields/utils/resolveMedia.js';
 export { createEntityAPI } from '../../entity/index.js';
 export { getAuth } from '../../server/auth.js';
+// Optymalizacja obrazów w tle (media_job)
+export { enqueueStyleSpecs } from './media/jobs/enqueue.js';
+export { startMediaWorker, stopMediaWorker } from './media/jobs/worker.js';

package/dist/core/server/media/jobs/enqueue.d.ts

@@ -0,0 +1,6 @@
+import type { ImageFieldStyle } from '../../../../types/fields.js';
+import type { MediaFile } from '../../../../types/media.js';
+/** Kolejkuje generację wszystkich wariantów dla media (upload / render-miss / sweep). Idempotentne po dedupeKey. */
+export declare function enqueueStyleSpecs(mediaFile: Pick<MediaFile, 'id' | 'width' | 'height'>, fieldStyles: ImageFieldStyle[] | undefined, opts?: {
+    priority?: number;
+}): Promise<void>;

package/dist/core/server/media/jobs/enqueue.js

@@ -0,0 +1,20 @@
+import { getCMS } from '../../../cms.js';
+import { resolveImagesConfig } from '../styles/imagesConfig.js';
+import { buildStyleSpecs, styleDedupeKey } from '../styles/buildStyleSpecs.js';
+/** Kolejkuje generację wszystkich wariantów dla media (upload / render-miss / sweep). Idempotentne po dedupeKey. */
+export async function enqueueStyleSpecs(mediaFile, fieldStyles, opts = {}) {
+    const cms = getCMS();
+    const cfg = resolveImagesConfig(cms.mediaConfig.images);
+    const specs = buildStyleSpecs(mediaFile, fieldStyles, cfg);
+    for (const style of specs) {
+        await cms.databaseAdapter
+            .enqueueMediaJob({
+            type: 'image_style',
+            mediaFileId: mediaFile.id,
+            payload: JSON.stringify(style),
+            dedupeKey: styleDedupeKey(mediaFile.id, style),
+            priority: opts.priority ?? 0
+        })
+            .catch((e) => console.warn('[media] enqueue failed:', e));
+    }
+}

package/dist/core/server/media/jobs/processImageStyleJob.d.ts

@@ -0,0 +1,19 @@
+import type { MediaJob } from '../../../../types/adapters/db.js';
+import type { MediaFile, ImageStyle } from '../../../../types/media.js';
+import type { ImageFieldStyle } from '../../../../types/fields.js';
+export type JobResult = {
+    ok: true;
+} | {
+    ok: false;
+    retry: boolean;
+    error: string;
+};
+type CreateImageStyleFn = (mediaFileId: string, style: ImageFieldStyle) => Promise<ImageStyle>;
+export interface ProcessImageStyleDeps {
+    createImageStyle: CreateImageStyleFn;
+    getMediaFile: (id: string) => Promise<MediaFile | null>;
+    limitPixels: number;
+}
+/** Przetwarza pojedynczy job typu image_style. Klasyfikuje błędy: poison/not-found → retry:false. */
+export declare function processImageStyleJob(job: MediaJob, deps: ProcessImageStyleDeps): Promise<JobResult>;
+export {};

package/dist/core/server/media/jobs/processImageStyleJob.js

@@ -0,0 +1,23 @@
+import { assertWithinPixelLimit } from '../styles/sharp/sharpConfig.js';
+/** Przetwarza pojedynczy job typu image_style. Klasyfikuje błędy: poison/not-found → retry:false. */
+export async function processImageStyleJob(job, deps) {
+    const style = JSON.parse(job.payload);
+    const media = await deps.getMediaFile(job.mediaFileId);
+    if (!media)
+        return { ok: false, retry: false, error: 'media file not found' };
+    try {
+        if (media.width && media.height) {
+            assertWithinPixelLimit(media.width, media.height, deps.limitPixels);
+        }
+    }
+    catch (e) {
+        return { ok: false, retry: false, error: e.message };
+    }
+    try {
+        await deps.createImageStyle(job.mediaFileId, style);
+        return { ok: true };
+    }
+    catch (e) {
+        return { ok: false, retry: true, error: e.message };
+    }
+}

package/dist/core/server/media/jobs/startWorker.d.ts

@@ -0,0 +1,2 @@
+/** Składa zależności i startuje in-process worker generacji wariantów. */
+export declare function startMediaOptimizationWorker(): void;