includio-cms 0.36.6 → 0.36.8

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

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

package/dist/updates/0.36.7/index.js

@@ -0,0 +1,13 @@
+export const update = {
+    version: '0.36.7',
+    date: '2026-06-24',
+    description: '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.',
+    features: [
+        '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%).'
+    ],
+    fixes: [
+        'Faktury z kuponem nie pomijają już rabatu — wartość faktury zgadza się z kwotą zapłaconą przez klienta.'
+    ],
+    breakingChanges: []
+};

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

@@ -72,6 +72,8 @@ import { update as update0362 } from './0.36.2/index.js';
 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,
@@ -146,7 +148,9 @@ export const updates = [
     update0362,
     update0363,
     update0364,
-    update0365
+    update0365,
+    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.6",
+	"version": "0.36.8",
 	"scripts": {
 		"dev": "vite dev",
 		"build": "vite build && npm run prepack",

package/dist/paraglide/messages/hello_world.d.ts

@@ -1,5 +0,0 @@
-export function hello_world(inputs: {
-    name: NonNullable<unknown>;
-}, options?: {
-    locale?: "en" | "pl";
-}): string;

package/dist/paraglide/messages/hello_world.js

@@ -1,33 +0,0 @@
-/* eslint-disable */
-import { getLocale, trackMessageCall, experimentalMiddlewareLocaleSplitting, isServer } from '../runtime.js';
-
-const en_hello_world = /** @type {(inputs: { name: NonNullable<unknown> }) => string} */ (i) => {
-	return `Hello, ${i.name} from en!`
-};
-
-const pl_hello_world = /** @type {(inputs: { name: NonNullable<unknown> }) => string} */ (i) => {
-	return `Hello, ${i.name} from pl!`
-};
-
-/**
-* This function has been compiled by [Paraglide JS](https://inlang.com/m/gerre34r).
-*
-* - Changing this function will be over-written by the next build.
-*
-* - If you want to change the translations, you can either edit the source files e.g. `en.json`, or
-* use another inlang app like [Fink](https://inlang.com/m/tdozzpar) or the [VSCode extension Sherlock](https://inlang.com/m/r7kp499g).
-* 
-* @param {{ name: NonNullable<unknown> }} inputs
-* @param {{ locale?: "en" | "pl" }} options
-* @returns {string}
-*/
-/* @__NO_SIDE_EFFECTS__ */
-export const hello_world = (inputs, options = {}) => {
-	if (experimentalMiddlewareLocaleSplitting && isServer === false) {
-		return /** @type {any} */ (globalThis).__paraglide_ssr.hello_world(inputs) 
-	}
-	const locale = options.locale ?? getLocale()
-	trackMessageCall("hello_world", locale)
-	if (locale === "en") return en_hello_world(inputs)
-	return pl_hello_world(inputs)
-};

package/dist/paraglide/messages/login_hello.d.ts

@@ -1,16 +0,0 @@
-export { login_hello as login.hello };
-/**
-* This function has been compiled by [Paraglide JS](https://inlang.com/m/gerre34r).
-*
-* - Changing this function will be over-written by the next build.
-*
-* - If you want to change the translations, you can either edit the source files e.g. `en.json`, or
-* use another inlang app like [Fink](https://inlang.com/m/tdozzpar) or the [VSCode extension Sherlock](https://inlang.com/m/r7kp499g).
-*
-* @param {{}} inputs
-* @param {{ locale?: "en" | "pl" }} options
-* @returns {string}
-*/
-declare function login_hello(inputs?: {}, options?: {
-    locale?: "en" | "pl";
-}): string;

package/dist/paraglide/messages/login_hello.js

@@ -1,34 +0,0 @@
-/* eslint-disable */
-import { getLocale, trackMessageCall, experimentalMiddlewareLocaleSplitting, isServer } from '../runtime.js';
-
-const en_login_hello = /** @type {(inputs: {}) => string} */ () => {
-	return `Welcome back`
-};
-
-const pl_login_hello = /** @type {(inputs: {}) => string} */ () => {
-	return `Witaj ponownie`
-};
-
-/**
-* This function has been compiled by [Paraglide JS](https://inlang.com/m/gerre34r).
-*
-* - Changing this function will be over-written by the next build.
-*
-* - If you want to change the translations, you can either edit the source files e.g. `en.json`, or
-* use another inlang app like [Fink](https://inlang.com/m/tdozzpar) or the [VSCode extension Sherlock](https://inlang.com/m/r7kp499g).
-* 
-* @param {{}} inputs
-* @param {{ locale?: "en" | "pl" }} options
-* @returns {string}
-*/
-/* @__NO_SIDE_EFFECTS__ */
-const login_hello = (inputs = {}, options = {}) => {
-	if (experimentalMiddlewareLocaleSplitting && isServer === false) {
-		return /** @type {any} */ (globalThis).__paraglide_ssr.login_hello(inputs) 
-	}
-	const locale = options.locale ?? getLocale()
-	trackMessageCall("login_hello", locale)
-	if (locale === "en") return en_login_hello(inputs)
-	return pl_login_hello(inputs)
-};
-export { login_hello as "login.hello" }

package/dist/paraglide/messages/login_please_login.d.ts

@@ -1,16 +0,0 @@
-export { login_please_login as login.please_login };
-/**
-* This function has been compiled by [Paraglide JS](https://inlang.com/m/gerre34r).
-*
-* - Changing this function will be over-written by the next build.
-*
-* - If you want to change the translations, you can either edit the source files e.g. `en.json`, or
-* use another inlang app like [Fink](https://inlang.com/m/tdozzpar) or the [VSCode extension Sherlock](https://inlang.com/m/r7kp499g).
-*
-* @param {{}} inputs
-* @param {{ locale?: "en" | "pl" }} options
-* @returns {string}
-*/
-declare function login_please_login(inputs?: {}, options?: {
-    locale?: "en" | "pl";
-}): string;

package/dist/paraglide/messages/login_please_login.js

@@ -1,34 +0,0 @@
-/* eslint-disable */
-import { getLocale, trackMessageCall, experimentalMiddlewareLocaleSplitting, isServer } from '../runtime.js';
-
-const en_login_please_login = /** @type {(inputs: {}) => string} */ () => {
-	return `Login to your account`
-};
-
-const pl_login_please_login = /** @type {(inputs: {}) => string} */ () => {
-	return `Zaloguj się na swoje konto`
-};
-
-/**
-* This function has been compiled by [Paraglide JS](https://inlang.com/m/gerre34r).
-*
-* - Changing this function will be over-written by the next build.
-*
-* - If you want to change the translations, you can either edit the source files e.g. `en.json`, or
-* use another inlang app like [Fink](https://inlang.com/m/tdozzpar) or the [VSCode extension Sherlock](https://inlang.com/m/r7kp499g).
-* 
-* @param {{}} inputs
-* @param {{ locale?: "en" | "pl" }} options
-* @returns {string}
-*/
-/* @__NO_SIDE_EFFECTS__ */
-const login_please_login = (inputs = {}, options = {}) => {
-	if (experimentalMiddlewareLocaleSplitting && isServer === false) {
-		return /** @type {any} */ (globalThis).__paraglide_ssr.login_please_login(inputs) 
-	}
-	const locale = options.locale ?? getLocale()
-	trackMessageCall("login_please_login", locale)
-	if (locale === "en") return en_login_please_login(inputs)
-	return pl_login_please_login(inputs)
-};
-export { login_please_login as "login.please_login" }