@valencets/cms 0.5.0 → 0.6.0

package/dist/media/image-processor.js

@@ -0,0 +1,90 @@
+import sharp from 'sharp';
+import { ok, err, ResultAsync } from 'neverthrow';
+import { CmsErrorCode } from '../schema/types.js';
+function toSharpError(e) {
+    return {
+        code: CmsErrorCode.INTERNAL,
+        message: e instanceof Error ? e.message : 'Image processing failed'
+    };
+}
+async function applyFocalPointCrop(pipeline, size, focalPoint) {
+    const metaResult = await ResultAsync.fromPromise(pipeline.metadata(), toSharpError);
+    if (metaResult.isErr())
+        return err(metaResult.error);
+    const meta = metaResult.value;
+    const srcW = meta.width ?? 0;
+    const srcH = meta.height ?? 0;
+    if (srcW === 0 || srcH === 0) {
+        return ok(pipeline.resize({ width: size.width, height: size.height, fit: 'cover' }));
+    }
+    const targetW = size.width;
+    const targetH = size.height;
+    const scale = Math.max(targetW / srcW, targetH / srcH);
+    const scaledW = Math.round(srcW * scale);
+    const scaledH = Math.round(srcH * scale);
+    const focalX = Math.round(focalPoint.x * scaledW);
+    const focalY = Math.round(focalPoint.y * scaledH);
+    const left = Math.min(Math.max(focalX - Math.round(targetW / 2), 0), scaledW - targetW);
+    const top = Math.min(Math.max(focalY - Math.round(targetH / 2), 0), scaledH - targetH);
+    return ok(pipeline
+        .resize({ width: scaledW, height: scaledH, fit: 'fill' })
+        .extract({ left, top, width: targetW, height: targetH }));
+}
+async function buildPipeline(inputBuffer, size, focalPoint) {
+    const fit = size.fit ?? 'cover';
+    if (focalPoint && fit === 'cover') {
+        return applyFocalPointCrop(sharp(inputBuffer), size, focalPoint);
+    }
+    return ok(sharp(inputBuffer).resize({
+        width: size.width,
+        height: size.height,
+        fit
+    }));
+}
+function toProcessedImage(name, outputBuffer, info) {
+    return {
+        name,
+        buffer: outputBuffer,
+        width: info.width,
+        height: info.height,
+        filesize: outputBuffer.length,
+        mimeType: `image/${info.format}`
+    };
+}
+async function processSize(inputBuffer, size, focalPoint) {
+    const pipelineResult = await buildPipeline(inputBuffer, size, focalPoint);
+    if (pipelineResult.isErr())
+        return err(pipelineResult.error);
+    const bufferResult = await ResultAsync.fromPromise(pipelineResult.value.toBuffer({ resolveWithObject: true }), toSharpError);
+    if (bufferResult.isErr())
+        return err(bufferResult.error);
+    const { data, info } = bufferResult.value;
+    return ok(toProcessedImage(size.name, data, info));
+}
+async function processWebpVariant(inputBuffer, size, focalPoint) {
+    const pipelineResult = await buildPipeline(inputBuffer, size, focalPoint);
+    if (pipelineResult.isErr())
+        return err(pipelineResult.error);
+    const webpResult = await ResultAsync.fromPromise(pipelineResult.value.webp({ quality: 80 }).toBuffer({ resolveWithObject: true }), toSharpError);
+    if (webpResult.isErr())
+        return err(webpResult.error);
+    const { data, info } = webpResult.value;
+    return ok(toProcessedImage(`${size.name}-webp`, data, info));
+}
+export async function processImageSizes(inputBuffer, sizes, formats = [], focalPoint) {
+    const results = [];
+    for (const size of sizes) {
+        const sizeResult = await processSize(inputBuffer, size, focalPoint);
+        if (sizeResult.isErr())
+            return err(sizeResult.error);
+        results.push(sizeResult.value);
+        if (formats.includes('webp')) {
+            const webpResult = await processWebpVariant(inputBuffer, size, focalPoint);
+            if (webpResult.isErr())
+                return err(webpResult.error);
+            results.push(webpResult.value);
+        }
+    }
+    return ok(results);
+}
+//# sourceMappingURL=image-processor.js.map

package/dist/media/image-processor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-processor.js","sourceRoot":"","sources":["../../src/media/image-processor.ts"],"names":[],"mappings":"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"}

package/dist/media/index.d.ts

@@ -1,5 +1,10 @@
-export { isUploadEnabled, getMediaFields, getMimeType } from './media-config.js';
-export { createServeHandler } from './serve-handler.js';
+export { isUploadEnabled, getMediaFields, getMimeType, getUploadConfig } from './media-config.js';
+export type { ImageSize, UploadConfig } from './media-config.js';
+export { createServeHandler, buildMediaUrl } from './serve-handler.js';
 export { createUploadHandler } from './upload-handler.js';
-export type { UploadResult } from './upload-handler.js';
+export type { UploadResult, SizeMetadata } from './upload-handler.js';
+export { createLocalStorage } from './storage-adapter.js';
+export type { StorageAdapter } from './storage-adapter.js';
+export { processImageSizes } from './image-processor.js';
+export type { ProcessedImage, FocalPoint } from './image-processor.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/media/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/media/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAChF,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AACzD,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/media/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACjG,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChE,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AACtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AACzD,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AACzD,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AACxD,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/media/index.js

@@ -1,4 +1,6 @@
-export { isUploadEnabled, getMediaFields, getMimeType } from './media-config.js';
-export { createServeHandler } from './serve-handler.js';
+export { isUploadEnabled, getMediaFields, getMimeType, getUploadConfig } from './media-config.js';
+export { createServeHandler, buildMediaUrl } from './serve-handler.js';
 export { createUploadHandler } from './upload-handler.js';
+export { createLocalStorage } from './storage-adapter.js';
+export { processImageSizes } from './image-processor.js';
 //# sourceMappingURL=index.js.map

package/dist/media/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/media/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAChF,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/media/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAEjG,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AACtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAEzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAEzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/media/media-config.d.ts

@@ -1,6 +1,20 @@
 import type { CollectionConfig } from '../schema/collection.js';
 import type { FieldConfig } from '../schema/field-types.js';
+export interface ImageSize {
+    readonly name: string;
+    readonly width: number;
+    readonly height: number;
+    readonly fit?: 'cover' | 'contain' | 'fill' | 'inside' | 'outside' | undefined;
+}
+export interface UploadConfig {
+    readonly mimeTypes?: readonly string[] | undefined;
+    readonly maxFileSize?: number | undefined;
+    readonly imageSizes?: readonly ImageSize[] | undefined;
+    readonly focalPoint?: boolean | undefined;
+    readonly formats?: readonly string[] | undefined;
+}
 export declare function isUploadEnabled(collection: CollectionConfig): boolean;
+export declare function getUploadConfig(collection: CollectionConfig): UploadConfig | null;
 export declare function getMediaFields(): readonly FieldConfig[];
 export declare function getMimeType(filename: string): string;
 //# sourceMappingURL=media-config.d.ts.map

package/dist/media/media-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"media-config.d.ts","sourceRoot":"","sources":["../../src/media/media-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAE3D,wBAAgB,eAAe,CAAE,UAAU,EAAE,gBAAgB,GAAG,OAAO,CAEtE;AAED,wBAAgB,cAAc,IAAK,SAAS,WAAW,EAAE,CAQxD;AAuBD,wBAAgB,WAAW,CAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGrD"}
+{"version":3,"file":"media-config.d.ts","sourceRoot":"","sources":["../../src/media/media-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAE3D,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAA;CAC/E;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAA;IAClD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACzC,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,SAAS,EAAE,GAAG,SAAS,CAAA;IACtD,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IACzC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAA;CACjD;AAED,wBAAgB,eAAe,CAAE,UAAU,EAAE,gBAAgB,GAAG,OAAO,CAEtE;AAED,wBAAgB,eAAe,CAAE,UAAU,EAAE,gBAAgB,GAAG,YAAY,GAAG,IAAI,CAIlF;AAED,wBAAgB,cAAc,IAAK,SAAS,WAAW,EAAE,CAQxD;AAuBD,wBAAgB,WAAW,CAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGrD"}

package/dist/media/media-config.js

@@ -1,5 +1,12 @@
 export function isUploadEnabled(collection) {
-    return collection.upload === true;
+    return collection.upload !== undefined && collection.upload !== false;
+}
+export function getUploadConfig(collection) {
+    if (collection.upload === true)
+        return {};
+    if (collection.upload === false || collection.upload === undefined)
+        return null;
+    return collection.upload;
 }
 export function getMediaFields() {
     return [

package/dist/media/media-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"media-config.js","sourceRoot":"","sources":["../../src/media/media-config.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,eAAe,CAAE,UAA4B;IAC3D,OAAO,UAAU,CAAC,MAAM,KAAK,IAAI,CAAA;AACnC,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO;QACL,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE;QAClD,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE;QAClD,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE;QACpD,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAE;QACpD,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE;KAClC,CAAA;AACH,CAAC;AAED,MAAM,QAAQ,GAA2B;IACvC,GAAG,EAAE,YAAY;IACjB,IAAI,EAAE,YAAY;IAClB,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,WAAW;IAChB,IAAI,EAAE,YAAY;IAClB,GAAG,EAAE,eAAe;IACpB,GAAG,EAAE,iBAAiB;IACtB,IAAI,EAAE,kBAAkB;IACxB,GAAG,EAAE,WAAW;IAChB,IAAI,EAAE,YAAY;IAClB,GAAG,EAAE,YAAY;IACjB,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,YAAY;IACjB,GAAG,EAAE,UAAU;IACf,IAAI,EAAE,WAAW;IACjB,GAAG,EAAE,UAAU;IACf,EAAE,EAAE,wBAAwB;IAC5B,GAAG,EAAE,iBAAiB;CACvB,CAAA;AAED,MAAM,UAAU,WAAW,CAAE,QAAgB;IAC3C,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,CAAA;IAC1D,OAAO,QAAQ,CAAC,GAAG,CAAC,IAAI,0BAA0B,CAAA;AACpD,CAAC"}
+{"version":3,"file":"media-config.js","sourceRoot":"","sources":["../../src/media/media-config.ts"],"names":[],"mappings":"AAkBA,MAAM,UAAU,eAAe,CAAE,UAA4B;IAC3D,OAAO,UAAU,CAAC,MAAM,KAAK,SAAS,IAAI,UAAU,CAAC,MAAM,KAAK,KAAK,CAAA;AACvE,CAAC;AAED,MAAM,UAAU,eAAe,CAAE,UAA4B;IAC3D,IAAI,UAAU,CAAC,MAAM,KAAK,IAAI;QAAE,OAAO,EAAE,CAAA;IACzC,IAAI,UAAU,CAAC,MAAM,KAAK,KAAK,IAAI,UAAU,CAAC,MAAM,KAAK,SAAS;QAAE,OAAO,IAAI,CAAA;IAC/E,OAAO,UAAU,CAAC,MAAM,CAAA;AAC1B,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO;QACL,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE;QAClD,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE;QAClD,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE;QACpD,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAE;QACpD,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE;KAClC,CAAA;AACH,CAAC;AAED,MAAM,QAAQ,GAA2B;IACvC,GAAG,EAAE,YAAY;IACjB,IAAI,EAAE,YAAY;IAClB,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,WAAW;IAChB,IAAI,EAAE,YAAY;IAClB,GAAG,EAAE,eAAe;IACpB,GAAG,EAAE,iBAAiB;IACtB,IAAI,EAAE,kBAAkB;IACxB,GAAG,EAAE,WAAW;IAChB,IAAI,EAAE,YAAY;IAClB,GAAG,EAAE,YAAY;IACjB,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,YAAY;IACjB,GAAG,EAAE,UAAU;IACf,IAAI,EAAE,WAAW;IACjB,GAAG,EAAE,UAAU;IACf,EAAE,EAAE,wBAAwB;IAC5B,GAAG,EAAE,iBAAiB;CACvB,CAAA;AAED,MAAM,UAAU,WAAW,CAAE,QAAgB;IAC3C,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,CAAA;IAC1D,OAAO,QAAQ,CAAC,GAAG,CAAC,IAAI,0BAA0B,CAAA;AACpD,CAAC"}

package/dist/media/serve-handler.d.ts

@@ -1,3 +1,5 @@
 import type { IncomingMessage, ServerResponse } from 'node:http';
-export declare function createServeHandler(uploadDir: string): (req: IncomingMessage, res: ServerResponse) => Promise<void>;
+import type { StorageAdapter } from './storage-adapter.js';
+export declare function createServeHandler(uploadDir: string, storage?: StorageAdapter): (req: IncomingMessage, res: ServerResponse) => Promise<void>;
+export declare function buildMediaUrl(filename: string, sizeName?: string): string;
 //# sourceMappingURL=serve-handler.d.ts.map

package/dist/media/serve-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serve-handler.d.ts","sourceRoot":"","sources":["../../src/media/serve-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAUhE,wBAAgB,kBAAkB,CAAE,SAAS,EAAE,MAAM,GAAG,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CAgDnH"}
+{"version":3,"file":"serve-handler.d.ts","sourceRoot":"","sources":["../../src/media/serve-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAOhE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAkB1D,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,cAAc,GACvB,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CA+C9D;AAED,wBAAgB,aAAa,CAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAW1E"}

package/dist/media/serve-handler.js

@@ -4,25 +4,43 @@ import { ResultAsync } from 'neverthrow';
 import { CmsErrorCode } from '../schema/types.js';
 import { getMimeType } from './media-config.js';
 const SAFE_FILENAME_RE = /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/;
-export function createServeHandler(uploadDir) {
+function sendFile(res, filename, data) {
+    res.writeHead(200, {
+        'Content-Type': getMimeType(filename),
+        'Content-Length': data.length,
+        'Cache-Control': 'public, max-age=31536000, immutable'
+    });
+    res.end(data);
+}
+function sendError(res, status, error) {
+    res.writeHead(status, { 'Content-Type': 'application/json' });
+    res.end(JSON.stringify({ error }));
+}
+export function createServeHandler(uploadDir, storage) {
     const resolvedUploadDir = resolve(uploadDir);
     return async (req, res) => {
         const rawFilename = req.url?.split('/').pop();
         if (!rawFilename) {
-            res.writeHead(400, { 'Content-Type': 'application/json' });
-            res.end(JSON.stringify({ error: 'Missing filename' }));
+            sendError(res, 400, 'Missing filename');
             return;
         }
         const filename = basename(rawFilename);
         if (!SAFE_FILENAME_RE.test(filename)) {
-            res.writeHead(400, { 'Content-Type': 'application/json' });
-            res.end(JSON.stringify({ error: 'Invalid filename' }));
+            sendError(res, 400, 'Invalid filename');
+            return;
+        }
+        if (storage) {
+            const result = await storage.read(filename);
+            if (result.isErr()) {
+                sendError(res, 404, 'File not found');
+                return;
+            }
+            sendFile(res, filename, result.value);
             return;
         }
         const filePath = resolve(join(resolvedUploadDir, filename));
         if (!filePath.startsWith(resolvedUploadDir)) {
-            res.writeHead(403, { 'Content-Type': 'application/json' });
-            res.end(JSON.stringify({ error: 'Forbidden' }));
+            sendError(res, 403, 'Forbidden');
             return;
         }
         const result = await ResultAsync.fromPromise(readFile(filePath), (e) => ({
@@ -30,18 +48,22 @@ export function createServeHandler(uploadDir) {
             message: e instanceof Error ? e.message : 'File read failed'
         }));
         if (result.isErr()) {
-            res.writeHead(404, { 'Content-Type': 'application/json' });
-            res.end(JSON.stringify({ error: 'File not found' }));
+            sendError(res, 404, 'File not found');
             return;
         }
-        const data = result.value;
-        const contentType = getMimeType(filename);
-        res.writeHead(200, {
-            'Content-Type': contentType,
-            'Content-Length': data.length,
-            'Cache-Control': 'public, max-age=31536000, immutable'
-        });
-        res.end(data);
+        sendFile(res, filename, result.value);
     };
 }
+export function buildMediaUrl(filename, sizeName) {
+    const base = basename(filename);
+    if (!sizeName)
+        return `/media/${encodeURIComponent(base)}`;
+    const dotIndex = base.lastIndexOf('.');
+    if (dotIndex === -1) {
+        return `/media/${encodeURIComponent(`${base}-${sizeName}`)}`;
+    }
+    const nameWithoutExt = base.slice(0, dotIndex);
+    const ext = base.slice(dotIndex + 1);
+    return `/media/${encodeURIComponent(`${nameWithoutExt}-${sizeName}.${ext}`)}`;
+}
 //# sourceMappingURL=serve-handler.js.map

package/dist/media/serve-handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"serve-handler.js","sourceRoot":"","sources":["../../src/media/serve-handler.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"serve-handler.js","sourceRoot":"","sources":["../../src/media/serve-handler.ts"],"names":[],"mappings":"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"}

package/dist/media/storage-adapter.d.ts

@@ -0,0 +1,10 @@
+import { ResultAsync } from 'neverthrow';
+import type { CmsError } from '../schema/types.js';
+export interface StorageAdapter {
+    readonly write: (filename: string, data: Buffer) => ResultAsync<string, CmsError>;
+    readonly read: (filename: string) => ResultAsync<Buffer, CmsError>;
+    readonly remove: (filename: string) => ResultAsync<void, CmsError>;
+    readonly url: (filename: string) => string;
+}
+export declare function createLocalStorage(uploadDir: string): StorageAdapter;
+//# sourceMappingURL=storage-adapter.d.ts.map

package/dist/media/storage-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-adapter.d.ts","sourceRoot":"","sources":["../../src/media/storage-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAY,MAAM,YAAY,CAAA;AAElD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAIlD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;IACjF,QAAQ,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;IAClE,QAAQ,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,WAAW,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;IAClE,QAAQ,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAA;CAC3C;AAED,wBAAgB,kBAAkB,CAAE,SAAS,EAAE,MAAM,GAAG,cAAc,CAqDrE"}

package/dist/media/storage-adapter.js

@@ -0,0 +1,46 @@
+import { ResultAsync, errAsync } from 'neverthrow';
+import { CmsErrorCode } from '../schema/types.js';
+import { writeFile, readFile, unlink } from 'node:fs/promises';
+import { join, resolve, basename } from 'node:path';
+export function createLocalStorage(uploadDir) {
+    const resolvedDir = resolve(uploadDir);
+    return {
+        write(filename, data) {
+            const safeName = basename(filename);
+            const filePath = resolve(join(resolvedDir, safeName));
+            if (!filePath.startsWith(resolvedDir)) {
+                return errAsync({ code: CmsErrorCode.FORBIDDEN, message: 'Path traversal rejected' });
+            }
+            return ResultAsync.fromPromise(writeFile(filePath, data).then(() => safeName), (e) => ({
+                code: CmsErrorCode.INTERNAL,
+                message: e instanceof Error ? e.message : 'File write failed'
+            }));
+        },
+        read(filename) {
+            const safeName = basename(filename);
+            const filePath = resolve(join(resolvedDir, safeName));
+            if (!filePath.startsWith(resolvedDir)) {
+                return errAsync({ code: CmsErrorCode.FORBIDDEN, message: 'Path traversal rejected' });
+            }
+            return ResultAsync.fromPromise(readFile(filePath), (e) => ({
+                code: CmsErrorCode.NOT_FOUND,
+                message: e instanceof Error ? e.message : 'File read failed'
+            }));
+        },
+        remove(filename) {
+            const safeName = basename(filename);
+            const filePath = resolve(join(resolvedDir, safeName));
+            if (!filePath.startsWith(resolvedDir)) {
+                return errAsync({ code: CmsErrorCode.FORBIDDEN, message: 'Path traversal rejected' });
+            }
+            return ResultAsync.fromPromise(unlink(filePath), (e) => ({
+                code: CmsErrorCode.NOT_FOUND,
+                message: e instanceof Error ? e.message : 'File delete failed'
+            }));
+        },
+        url(filename) {
+            return `/media/${encodeURIComponent(basename(filename))}`;
+        }
+    };
+}
+//# sourceMappingURL=storage-adapter.js.map

package/dist/media/storage-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-adapter.js","sourceRoot":"","sources":["../../src/media/storage-adapter.ts"],"names":[],"mappings":"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"}

package/dist/media/upload-handler.d.ts

@@ -1,9 +1,21 @@
 import type { IncomingMessage, ServerResponse } from 'node:http';
+import type { UploadConfig } from './media-config.js';
+import type { StorageAdapter } from './storage-adapter.js';
+export interface SizeMetadata {
+    readonly filename: string;
+    readonly width: number;
+    readonly height: number;
+    readonly filesize: number;
+    readonly mimeType: string;
+}
 export interface UploadResult {
     readonly filename: string;
     readonly storedPath: string;
     readonly mimeType: string;
     readonly filesize: number;
+    readonly focalX?: number | undefined;
+    readonly focalY?: number | undefined;
+    readonly sizes?: Record<string, SizeMetadata> | undefined;
 }
-export declare function createUploadHandler(uploadDir: string): (req: IncomingMessage, res: ServerResponse) => Promise<void>;
+export declare function createUploadHandler(uploadDir: string, storage?: StorageAdapter, uploadConfig?: UploadConfig): (req: IncomingMessage, res: ServerResponse) => Promise<void>;
 //# sourceMappingURL=upload-handler.d.ts.map

package/dist/media/upload-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"upload-handler.d.ts","sourceRoot":"","sources":["../../src/media/upload-handler.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAgBhE,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B;AAED,wBAAgB,mBAAmB,CAAE,SAAS,EAAE,MAAM,GAAG,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CAyDpH"}
+{"version":3,"file":"upload-handler.d.ts","sourceRoot":"","sources":["../../src/media/upload-handler.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAKhE,OAAO,KAAK,EAAa,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AA0B1D,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACpC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,GAAG,SAAS,CAAA;CAC1D;AAoID,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,cAAc,EACxB,YAAY,CAAC,EAAE,YAAY,GAC1B,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CAkE9D"}

package/dist/media/upload-handler.js

@@ -1,63 +1,173 @@
-import { ResultAsync } from 'neverthrow';
+import { ResultAsync, okAsync } from 'neverthrow';
 import { CmsErrorCode } from '../schema/types.js';
 import { writeFile } from 'node:fs/promises';
 import { join, resolve, basename } from 'node:path';
 import { randomBytes } from 'node:crypto';
 import { getMimeType } from './media-config.js';
+import { processImageSizes } from './image-processor.js';
 import { readRawBody } from '../api/read-body.js';
 const MAX_UPLOAD_BYTES = 10_485_760;
 const SAFE_FILENAME_RE = /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/;
+const IMAGE_MIMES = new Set([
+    'image/jpeg',
+    'image/png',
+    'image/webp',
+    'image/avif',
+    'image/gif'
+]);
+function isImageFile(mimeType) {
+    return IMAGE_MIMES.has(mimeType);
+}
 function generateStoredName(originalName) {
     const ext = originalName.split('.').pop() ?? '';
     const prefix = randomBytes(16).toString('hex');
     return ext ? `${prefix}.${ext}` : prefix;
 }
-export function createUploadHandler(uploadDir) {
+function parseFocalPoint(req) {
+    const rawX = req.headers['x-focal-x'];
+    const rawY = req.headers['x-focal-y'];
+    const xStr = Array.isArray(rawX) ? rawX[0] : rawX;
+    const yStr = Array.isArray(rawY) ? rawY[0] : rawY;
+    if (xStr === undefined || yStr === undefined)
+        return undefined;
+    const x = Number(xStr);
+    const y = Number(yStr);
+    if (Number.isNaN(x) || Number.isNaN(y))
+        return undefined;
+    if (x < 0 || x > 1 || y < 0 || y > 1)
+        return undefined;
+    return { x, y };
+}
+function buildSizeMetadata(processed, originalExt) {
+    const sizes = {};
+    for (const img of processed) {
+        const ext = img.mimeType.split('/').pop() ?? originalExt;
+        sizes[img.name] = {
+            filename: `${img.name}.${ext}`,
+            width: img.width,
+            height: img.height,
+            filesize: img.filesize,
+            mimeType: img.mimeType
+        };
+    }
+    return sizes;
+}
+function variantFilename(storedName, sizeName, ext) {
+    const base = storedName.split('.').slice(0, -1).join('.');
+    return `${base}-${sizeName}.${ext}`;
+}
+function writeVariants(storage, storedName, processed) {
+    let chain = okAsync(undefined);
+    for (const img of processed) {
+        const ext = img.mimeType.split('/').pop() ?? 'bin';
+        const name = variantFilename(storedName, img.name, ext);
+        chain = chain.andThen(() => storage.write(name, img.buffer).map(() => undefined));
+    }
+    return chain;
+}
+function sendJson(res, status, data) {
+    const body = JSON.stringify(data);
+    res.writeHead(status, {
+        'Content-Type': 'application/json; charset=utf-8',
+        'Content-Length': Buffer.byteLength(body)
+    });
+    res.end(body);
+}
+function sendError(res, status, message) {
+    res.writeHead(status, { 'Content-Type': 'application/json' });
+    res.end(JSON.stringify({ error: message }));
+}
+function getImageProcessingContext(storage, mimeType, uploadConfig) {
+    if (!storage || !isImageFile(mimeType))
+        return null;
+    if (!uploadConfig?.imageSizes || uploadConfig.imageSizes.length === 0)
+        return null;
+    return {
+        storage,
+        imageSizes: uploadConfig.imageSizes,
+        formats: uploadConfig.formats ?? []
+    };
+}
+async function writeMainFile(storage, resolvedDir, storedName, data) {
+    if (storage) {
+        const writeResult = await storage.write(storedName, data);
+        return writeResult.isErr() ? writeResult.error : null;
+    }
+    const storedPath = resolve(join(resolvedDir, storedName));
+    if (!storedPath.startsWith(resolvedDir)) {
+        return { code: CmsErrorCode.FORBIDDEN, message: 'Forbidden' };
+    }
+    const writeResult = await ResultAsync.fromPromise(writeFile(storedPath, data), (e) => ({
+        code: CmsErrorCode.INTERNAL,
+        message: e instanceof Error ? e.message : 'File write failed'
+    }));
+    return writeResult.isErr() ? writeResult.error : null;
+}
+function buildUploadResult(originalName, storedName, mimeType, filesize, focalX, focalY, sizes) {
+    return {
+        filename: originalName,
+        storedPath: storedName,
+        mimeType,
+        filesize,
+        ...(focalX !== undefined && focalY !== undefined ? { focalX, focalY } : {}),
+        ...(sizes ? { sizes } : {})
+    };
+}
+export function createUploadHandler(uploadDir, storage, uploadConfig) {
     const resolvedDir = resolve(uploadDir);
     return async (req, res) => {
         const filenameHeader = req.headers['x-filename'];
         const rawName = Array.isArray(filenameHeader) ? filenameHeader[0] ?? 'upload' : filenameHeader ?? 'upload';
         const originalName = basename(rawName);
         if (!SAFE_FILENAME_RE.test(originalName)) {
-            res.writeHead(400, { 'Content-Type': 'application/json' });
-            res.end(JSON.stringify({ error: 'Invalid filename' }));
+            sendError(res, 400, 'Invalid filename');
             return;
         }
         const bodyResult = await readRawBody(req, MAX_UPLOAD_BYTES);
         if (bodyResult.isErr()) {
-            res.writeHead(400, { 'Content-Type': 'application/json' });
-            res.end(JSON.stringify({ error: bodyResult.error.message }));
+            sendError(res, 400, bodyResult.error.message);
             return;
         }
         const data = bodyResult.value;
         const storedName = generateStoredName(originalName);
-        const storedPath = resolve(join(resolvedDir, storedName));
-        if (!storedPath.startsWith(resolvedDir)) {
-            res.writeHead(403, { 'Content-Type': 'application/json' });
-            res.end(JSON.stringify({ error: 'Forbidden' }));
+        const mimeType = getMimeType(originalName);
+        const writeError = await writeMainFile(storage, resolvedDir, storedName, data);
+        if (writeError) {
+            const status = writeError.code === CmsErrorCode.FORBIDDEN ? 403 : 500;
+            sendError(res, status, writeError.message);
             return;
         }
-        const writeResult = await ResultAsync.fromPromise(writeFile(storedPath, data), (e) => ({
-            code: CmsErrorCode.INTERNAL,
-            message: e instanceof Error ? e.message : 'File write failed'
-        }));
-        if (writeResult.isErr()) {
-            res.writeHead(500, { 'Content-Type': 'application/json' });
-            res.end(JSON.stringify({ error: writeResult.error.message }));
-            return;
+        let focalX;
+        let focalY;
+        let sizes;
+        if (isImageFile(mimeType) && uploadConfig?.focalPoint) {
+            const fp = parseFocalPoint(req);
+            if (fp) {
+                focalX = fp.x;
+                focalY = fp.y;
+            }
         }
-        const result = {
-            filename: originalName,
-            storedPath: storedName,
-            mimeType: getMimeType(originalName),
-            filesize: data.length
-        };
-        const body = JSON.stringify(result);
-        res.writeHead(201, {
-            'Content-Type': 'application/json; charset=utf-8',
-            'Content-Length': Buffer.byteLength(body)
-        });
-        res.end(body);
+        const imageCtx = getImageProcessingContext(storage, mimeType, uploadConfig);
+        if (imageCtx) {
+            const focalPoint = (focalX !== undefined && focalY !== undefined)
+                ? { x: focalX, y: focalY }
+                : undefined;
+            const processResult = await processImageSizes(data, imageCtx.imageSizes, imageCtx.formats, focalPoint);
+            if (processResult.isErr()) {
+                sendError(res, 500, processResult.error.message);
+                return;
+            }
+            const processed = processResult.value;
+            const originalExt = originalName.split('.').pop() ?? '';
+            sizes = buildSizeMetadata(processed, originalExt);
+            const variantResult = await writeVariants(imageCtx.storage, storedName, processed);
+            if (variantResult.isErr()) {
+                sendError(res, 500, variantResult.error.message);
+                return;
+            }
+        }
+        const result = buildUploadResult(originalName, storedName, mimeType, data.length, focalX, focalY, sizes);
+        sendJson(res, 201, result);
     };
 }
 //# sourceMappingURL=upload-handler.js.map