@ttt-productions/media-processing-core 0.8.16 → 0.8.18

package/dist/image/formats.js

@@ -1,53 +1,43 @@
-/**
- * Map a requested format string (case-insensitive) to its sharp format id and
- * file extension. Unknown or missing formats fall back to jpeg.
- */
 export function pickFormat(fmt) {
-    switch ((fmt ?? "jpeg").toLowerCase()) {
-        case "png":
-            return { ext: "png", format: "png" };
-        case "webp":
-            return { ext: "webp", format: "webp" };
-        case "avif":
-            return { ext: "avif", format: "avif" };
-        case "jpg":
-        case "jpeg":
+    switch ((fmt ?? 'jpeg').toLowerCase()) {
+        case 'png':
+            return { ext: 'png', format: 'png' };
+        case 'webp':
+            return { ext: 'webp', format: 'webp' };
+        case 'avif':
+            return { ext: 'avif', format: 'avif' };
+        case 'jpg':
+        case 'jpeg':
         default:
-            return { ext: "jpg", format: "jpeg" };
+            return { ext: 'jpg', format: 'jpeg' };
     }
 }
-/** Map an image format string to its MIME type. */
 export function mimeForImageFormat(fmt) {
     if (!fmt)
         return undefined;
     const f = fmt.toLowerCase();
-    if (f === "jpg")
-        return "image/jpeg";
-    if (f === "jpeg")
-        return "image/jpeg";
-    if (f === "png")
-        return "image/png";
-    if (f === "webp")
-        return "image/webp";
-    if (f === "avif")
-        return "image/avif";
+    if (f === 'jpg')
+        return 'image/jpeg';
+    if (f === 'jpeg')
+        return 'image/jpeg';
+    if (f === 'png')
+        return 'image/png';
+    if (f === 'webp')
+        return 'image/webp';
+    if (f === 'avif')
+        return 'image/avif';
     return `image/${f}`;
 }
-/**
- * Apply the chosen output format (and optional quality) to a sharp pipeline.
- * png is lossless so quality is ignored; jpeg/webp/avif honor quality when set,
- * otherwise sharp's per-format defaults apply.
- */
 export function applyImageFormat(pipeline, format, quality) {
-    const q = typeof quality === "number" ? quality : undefined;
+    const q = typeof quality === 'number' ? quality : undefined;
     switch (format) {
-        case "png":
+        case 'png':
             return pipeline.png();
-        case "webp":
+        case 'webp':
             return pipeline.webp(q ? { quality: q } : undefined);
-        case "avif":
+        case 'avif':
             return pipeline.avif(q ? { quality: q } : undefined);
-        case "jpeg":
+        case 'jpeg':
         default:
             return pipeline.jpeg(q ? { quality: q } : undefined);
     }

package/dist/image/formats.js.map

@@ -1 +1 @@
-{"version":3,"file":"formats.js","sourceRoot":"","sources":["../../src/image/formats.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,GAAY;IACrC,QAAQ,CAAC,GAAG,IAAI,MAAM,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;QACtC,KAAK,KAAK;YACR,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QACvC,KAAK,MAAM;YACT,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;QACzC,KAAK,MAAM;YACT,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;QACzC,KAAK,KAAK,CAAC;QACX,KAAK,MAAM,CAAC;QACZ;YACE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAC1C,CAAC;AACH,CAAC;AAED,mDAAmD;AACnD,MAAM,UAAU,kBAAkB,CAAC,GAAY;IAC7C,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAC;IAC3B,MAAM,CAAC,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;IAC5B,IAAI,CAAC,KAAK,KAAK;QAAE,OAAO,YAAY,CAAC;IACrC,IAAI,CAAC,KAAK,MAAM;QAAE,OAAO,YAAY,CAAC;IACtC,IAAI,CAAC,KAAK,KAAK;QAAE,OAAO,WAAW,CAAC;IACpC,IAAI,CAAC,KAAK,MAAM;QAAE,OAAO,YAAY,CAAC;IACtC,IAAI,CAAC,KAAK,MAAM;QAAE,OAAO,YAAY,CAAC;IACtC,OAAO,SAAS,CAAC,EAAE,CAAC;AACtB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAC9B,QAAe,EACf,MAAyB,EACzB,OAAgB;IAEhB,MAAM,CAAC,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5D,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,KAAK;YACR,OAAO,QAAQ,CAAC,GAAG,EAAE,CAAC;QACxB,KAAK,MAAM;YACT,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QACvD,KAAK,MAAM;YACT,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QACvD,KAAK,MAAM,CAAC;QACZ;YACE,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACzD,CAAC;AACH,CAAC","sourcesContent":["// shared image format / quality presets\nimport type { Sharp } from \"sharp\";\n\n/** Output image formats the processor can emit. */\nexport type ImageOutputFormat = \"jpeg\" | \"png\" | \"webp\" | \"avif\";\n\n/**\n * Map a requested format string (case-insensitive) to its sharp format id and\n * file extension. Unknown or missing formats fall back to jpeg.\n */\nexport function pickFormat(fmt?: string): { ext: string; format: ImageOutputFormat } {\n  switch ((fmt ?? \"jpeg\").toLowerCase()) {\n    case \"png\":\n      return { ext: \"png\", format: \"png\" };\n    case \"webp\":\n      return { ext: \"webp\", format: \"webp\" };\n    case \"avif\":\n      return { ext: \"avif\", format: \"avif\" };\n    case \"jpg\":\n    case \"jpeg\":\n    default:\n      return { ext: \"jpg\", format: \"jpeg\" };\n  }\n}\n\n/** Map an image format string to its MIME type. */\nexport function mimeForImageFormat(fmt?: string): string | undefined {\n  if (!fmt) return undefined;\n  const f = fmt.toLowerCase();\n  if (f === \"jpg\") return \"image/jpeg\";\n  if (f === \"jpeg\") return \"image/jpeg\";\n  if (f === \"png\") return \"image/png\";\n  if (f === \"webp\") return \"image/webp\";\n  if (f === \"avif\") return \"image/avif\";\n  return `image/${f}`;\n}\n\n/**\n * Apply the chosen output format (and optional quality) to a sharp pipeline.\n * png is lossless so quality is ignored; jpeg/webp/avif honor quality when set,\n * otherwise sharp's per-format defaults apply.\n */\nexport function applyImageFormat(\n  pipeline: Sharp,\n  format: ImageOutputFormat,\n  quality?: number\n): Sharp {\n  const q = typeof quality === \"number\" ? quality : undefined;\n  switch (format) {\n    case \"png\":\n      return pipeline.png();\n    case \"webp\":\n      return pipeline.webp(q ? { quality: q } : undefined);\n    case \"avif\":\n      return pipeline.avif(q ? { quality: q } : undefined);\n    case \"jpeg\":\n    default:\n      return pipeline.jpeg(q ? { quality: q } : undefined);\n  }\n}\n"]}
+{"version":3,"file":"formats.js","sourceRoot":"","sources":["../../src/image/formats.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,UAAU,CAAC,GAAY;IACrC,QAAQ,CAAC,GAAG,IAAI,MAAM,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;QACtC,KAAK,KAAK;YACR,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QACvC,KAAK,MAAM;YACT,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;QACzC,KAAK,MAAM;YACT,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;QACzC,KAAK,KAAK,CAAC;QACX,KAAK,MAAM,CAAC;QACZ;YACE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAC1C,CAAC;AACH,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,GAAY;IAC7C,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAC;IAC3B,MAAM,CAAC,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;IAC5B,IAAI,CAAC,KAAK,KAAK;QAAE,OAAO,YAAY,CAAC;IACrC,IAAI,CAAC,KAAK,MAAM;QAAE,OAAO,YAAY,CAAC;IACtC,IAAI,CAAC,KAAK,KAAK;QAAE,OAAO,WAAW,CAAC;IACpC,IAAI,CAAC,KAAK,MAAM;QAAE,OAAO,YAAY,CAAC;IACtC,IAAI,CAAC,KAAK,MAAM;QAAE,OAAO,YAAY,CAAC;IACtC,OAAO,SAAS,CAAC,EAAE,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,QAAe,EACf,MAAyB,EACzB,OAAgB;IAEhB,MAAM,CAAC,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5D,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,KAAK;YACR,OAAO,QAAQ,CAAC,GAAG,EAAE,CAAC;QACxB,KAAK,MAAM;YACT,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QACvD,KAAK,MAAM;YACT,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QACvD,KAAK,MAAM,CAAC;QACZ;YACE,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACzD,CAAC;AACH,CAAC","sourcesContent":["import type { Sharp } from 'sharp';\n\nexport type ImageOutputFormat = 'jpeg' | 'png' | 'webp' | 'avif';\n\nexport function pickFormat(fmt?: string): { ext: string; format: ImageOutputFormat } {\n  switch ((fmt ?? 'jpeg').toLowerCase()) {\n    case 'png':\n      return { ext: 'png', format: 'png' };\n    case 'webp':\n      return { ext: 'webp', format: 'webp' };\n    case 'avif':\n      return { ext: 'avif', format: 'avif' };\n    case 'jpg':\n    case 'jpeg':\n    default:\n      return { ext: 'jpg', format: 'jpeg' };\n  }\n}\n\nexport function mimeForImageFormat(fmt?: string): string | undefined {\n  if (!fmt) return undefined;\n  const f = fmt.toLowerCase();\n  if (f === 'jpg') return 'image/jpeg';\n  if (f === 'jpeg') return 'image/jpeg';\n  if (f === 'png') return 'image/png';\n  if (f === 'webp') return 'image/webp';\n  if (f === 'avif') return 'image/avif';\n  return `image/${f}`;\n}\n\nexport function applyImageFormat(\n  pipeline: Sharp,\n  format: ImageOutputFormat,\n  quality?: number,\n): Sharp {\n  const q = typeof quality === 'number' ? quality : undefined;\n  switch (format) {\n    case 'png':\n      return pipeline.png();\n    case 'webp':\n      return pipeline.webp(q ? { quality: q } : undefined);\n    case 'avif':\n      return pipeline.avif(q ? { quality: q } : undefined);\n    case 'jpeg':\n    default:\n      return pipeline.jpeg(q ? { quality: q } : undefined);\n  }\n}\n"]}

package/dist/image/image-processor.d.ts

@@ -1,5 +1,5 @@
-import type { MediaProcessingResult, MediaProcessingSpec } from "@ttt-productions/media-schemas";
-import type { ProcessMediaOptions } from "../types.js";
+import type { MediaProcessingResult, MediaProcessingSpec } from '@ttt-productions/media-schemas';
+import type { ProcessMediaOptions } from '../types.js';
 export declare function processImage(spec: MediaProcessingSpec, ctx: {
     inputPath: string;
     outputBasePath: string;

package/dist/image/image-processor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"image-processor.d.ts","sourceRoot":"","sources":["../../src/image/image-processor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAqC,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAMpI,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AA+LvD,wBAAsB,YAAY,CAChC,IAAI,EAAE,mBAAmB,EACzB,GAAG,EAAE;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;CACxB,EACD,IAAI,CAAC,EAAE,mBAAmB,GACzB,OAAO,CAAC,qBAAqB,CAAC,CA6FhC"}
+{"version":3,"file":"image-processor.d.ts","sourceRoot":"","sources":["../../src/image/image-processor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,qBAAqB,EACrB,mBAAmB,EACpB,MAAM,gCAAgC,CAAC;AAMxC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AA4KvD,wBAAsB,YAAY,CAChC,IAAI,EAAE,mBAAmB,EACzB,GAAG,EAAE;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;CACxB,EACD,IAAI,CAAC,EAAE,mBAAmB,GACzB,OAAO,CAAC,qBAAqB,CAAC,CA2GhC"}

package/dist/image/image-processor.js

@@ -1,29 +1,29 @@
-import sharp from "sharp";
-import { mkdir } from "node:fs/promises";
-import path from "node:path";
-import { safeOutputPathFor } from "../utils/safe-path.js";
-import { applyImageFormat, mimeForImageFormat, pickFormat } from "./formats.js";
-import { computeAspectCropBox, resizeCover, resizeInside, toSharpPosition, } from "./resize.js";
-import { IMAGE_DEFAULT_OUTPUT_KEY } from "@ttt-productions/media-schemas";
+import sharp from 'sharp';
+import { mkdir } from 'node:fs/promises';
+import path from 'node:path';
+import { safeOutputPathFor } from '../utils/safe-path.js';
+import { applyImageFormat, mimeForImageFormat, pickFormat } from './formats.js';
+import { computeAspectCropBox, resizeCover, resizeInside, toSharpPosition, } from './resize.js';
+import { IMAGE_DEFAULT_OUTPUT_KEY } from '@ttt-productions/media-schemas';
 function matchMime(accepted, actual) {
     const a = accepted.trim().toLowerCase();
     const m = actual.trim().toLowerCase();
     if (!a)
         return true;
-    if (a === "*/*")
+    if (a === '*/*')
         return true;
-    if (a.endsWith("/*"))
+    if (a.endsWith('/*'))
         return m.startsWith(a.slice(0, -1));
     return a === m;
 }
 function acceptAllowsImage(spec) {
     const kinds = spec.accept?.kinds?.filter(Boolean) ?? [];
-    return kinds.length === 0 ? true : kinds.includes("image");
+    return kinds.length === 0 ? true : kinds.includes('image');
 }
 function acceptAllowsMime(spec, actualMime) {
     const mimes = spec.accept?.mimes?.filter(Boolean) ?? [];
     if (mimes.length === 0)
-        return true; // empty => accept anything
+        return true;
     if (!actualMime)
         return false;
     return mimes.some((a) => matchMime(a, actualMime));
@@ -39,23 +39,15 @@ function aspect(width, height) {
 function aspectClose(a, b, tolerance) {
     return Math.abs(a - b) <= tolerance;
 }
-/**
- * Build a "normalized base" pipeline that enforces spec-level uniformity:
- * - if imageCrop exists -> always crop to outputWidth/outputHeight
- * - else if requiredWidth/requiredHeight exist -> crop/resize to those
- * - else if requiredAspectRatio exists -> center-crop to that aspect (no scaling unless needed later)
- *
- * If the source violates constraints and we cannot/should not auto-fix, returns a rejection error.
- */
 async function buildBase(spec, inputPath) {
-    const input = sharp(inputPath, { failOn: "none" });
+    const input = sharp(inputPath, { failOn: 'none' });
     const meta = await input.metadata();
     if (!meta.width || !meta.height || meta.width <= 0 || meta.height <= 0) {
         return {
             ok: false,
             error: {
-                code: "processing_failed",
-                message: "Unable to read valid image dimensions. File may be corrupt.",
+                code: 'processing_failed',
+                message: 'Unable to read valid image dimensions. File may be corrupt.',
                 details: { width: meta.width, height: meta.height, format: meta.format, path: inputPath },
             },
         };
@@ -64,8 +56,8 @@ async function buildBase(spec, inputPath) {
         return {
             ok: false,
             error: {
-                code: "unsupported_format",
-                message: "Unable to determine image format. File may be corrupt.",
+                code: 'unsupported_format',
+                message: 'Unable to determine image format. File may be corrupt.',
                 details: { path: inputPath },
             },
         };
@@ -74,8 +66,8 @@ async function buildBase(spec, inputPath) {
         return {
             ok: false,
             error: {
-                code: "invalid_mime",
-                message: "Spec does not allow image uploads.",
+                code: 'invalid_mime',
+                message: 'Spec does not allow image uploads.',
                 details: { accept: spec.accept },
             },
         };
@@ -85,8 +77,8 @@ async function buildBase(spec, inputPath) {
         return {
             ok: false,
             error: {
-                code: "invalid_mime",
-                message: "Image mime type is not allowed.",
+                code: 'invalid_mime',
+                message: 'Image mime type is not allowed.',
                 details: { detectedMime, accept: spec.accept },
             },
         };
@@ -94,54 +86,45 @@ async function buildBase(spec, inputPath) {
     const w = meta.width ?? undefined;
     const h = meta.height ?? undefined;
     if (!w || !h) {
-        // Can't validate/crop reliably without dimensions.
-        // We'll still proceed unless strict dims/aspect are required without crop/auto.
         if (spec.requiredWidth || spec.requiredHeight || spec.requiredAspectRatio) {
             if (!spec.allowAutoFormat && !spec.imageCrop) {
                 return {
                     ok: false,
                     error: {
-                        code: "dimensions_mismatch",
-                        message: "Unable to read image dimensions for validation.",
+                        code: 'dimensions_mismatch',
+                        message: 'Unable to read image dimensions for validation.',
                         details: { width: w, height: h },
                     },
                 };
             }
         }
     }
-    // Start from raw input each time; callers can clone as needed.
     let base = sharp(inputPath);
-    // Keep metadata only if explicitly requested.
     if (spec.image?.stripMetadata === false) {
         base = base.withMetadata({ orientation: meta.orientation });
     }
-    // 1) Explicit crop spec (most strict)
     const crop = spec.imageCrop;
     if (crop) {
         base = resizeCover(base, crop.outputWidth, crop.outputHeight);
         return { ok: true, base, inputMeta: meta };
     }
-    // 2) Exact required size -> auto crop/resize only if allowAutoFormat OR the request is inherently "uniform"
     const reqW = spec.requiredWidth;
     const reqH = spec.requiredHeight;
     if (reqW && reqH) {
         const canFix = spec.allowAutoFormat === true;
-        // If not allowed to auto-fix, require exact match
         if (!canFix && w && h && (w !== reqW || h !== reqH)) {
             return {
                 ok: false,
                 error: {
-                    code: "dimensions_mismatch",
-                    message: "Image dimensions do not match the required format.",
+                    code: 'dimensions_mismatch',
+                    message: 'Image dimensions do not match the required format.',
                     details: { requiredWidth: reqW, requiredHeight: reqH, width: w, height: h },
                 },
             };
         }
-        // Auto-fix path (or exact already): enforce normalized base
         base = resizeCover(base, reqW, reqH);
         return { ok: true, base, inputMeta: meta };
     }
-    // 3) Aspect ratio requirement (no exact size)
     const reqAspect = spec.requiredAspectRatio;
     if (reqAspect && w && h) {
         const a = aspect(w, h);
@@ -151,13 +134,12 @@ async function buildBase(spec, inputPath) {
                 return {
                     ok: false,
                     error: {
-                        code: "aspect_ratio_mismatch",
-                        message: "Image aspect ratio does not match the required format.",
+                        code: 'aspect_ratio_mismatch',
+                        message: 'Image aspect ratio does not match the required format.',
                         details: { requiredAspectRatio: reqAspect, aspectRatio: a, width: w, height: h },
                     },
                 };
             }
-            // Auto center-crop to required aspect ratio (no forced scale yet).
             base = base.extract(computeAspectCropBox(w, h, reqAspect));
         }
     }
@@ -167,14 +149,20 @@ export async function processImage(spec, ctx, opts) {
     const tempFiles = [];
     try {
         if (opts?.signal?.aborted) {
-            return { ok: false, mediaType: "image", error: { code: "processing_canceled", message: "Processing canceled." } };
+            return {
+                ok: false,
+                mediaType: 'image',
+                error: { code: 'processing_canceled', message: 'Processing canceled.' },
+            };
         }
-        const variants = spec.image?.variants?.length ? spec.image.variants : [{ key: IMAGE_DEFAULT_OUTPUT_KEY }];
+        const variants = spec.image?.variants?.length
+            ? spec.image.variants
+            : [{ key: IMAGE_DEFAULT_OUTPUT_KEY }];
         const outDir = path.dirname(ctx.outputBasePath);
         await mkdir(outDir, { recursive: true });
         const baseRes = await buildBase(spec, ctx.inputPath);
         if (!baseRes.ok) {
-            return { ok: false, mediaType: "image", error: baseRes.error };
+            return { ok: false, mediaType: 'image', error: baseRes.error };
         }
         const { base, inputMeta } = baseRes;
         const outputs = [];
@@ -183,19 +171,23 @@ export async function processImage(spec, ctx, opts) {
         for (const v of variants) {
             idx += 1;
             if (opts?.signal?.aborted) {
-                return { ok: false, mediaType: "image", error: { code: "processing_canceled", message: "Processing canceled." } };
+                return {
+                    ok: false,
+                    mediaType: 'image',
+                    error: { code: 'processing_canceled', message: 'Processing canceled.' },
+                };
             }
             opts?.onProgress?.({
-                phase: "process",
+                phase: 'process',
                 percent: (idx - 1) / totalVariants,
-                detail: { step: "image_variant", key: v.key },
+                detail: { step: 'image_variant', key: v.key },
             });
             const { ext, format } = pickFormat(v.format);
             const outPath = outputPathFor(ctx.outputBasePath, v.key, ext);
             tempFiles.push(outPath);
             let p = base.clone();
             if (v.crop) {
-                p = resizeCover(p, v.crop.width, v.crop.height, toSharpPosition(v.crop.gravity ?? "center"));
+                p = resizeCover(p, v.crop.width, v.crop.height, toSharpPosition(v.crop.gravity ?? 'center'));
             }
             else if (v.maxWidth || v.maxHeight) {
                 p = resizeInside(p, v.maxWidth, v.maxHeight);
@@ -212,11 +204,10 @@ export async function processImage(spec, ctx, opts) {
                 height: info.height,
             });
         }
-        // success: keep outputs
         tempFiles.length = 0;
         return {
             ok: true,
-            mediaType: "image",
+            mediaType: 'image',
             outputs,
             meta: {
                 mime: mimeForImageFormat(inputMeta.format),
@@ -228,17 +219,17 @@ export async function processImage(spec, ctx, opts) {
     catch (e) {
         return {
             ok: false,
-            mediaType: "image",
+            mediaType: 'image',
             error: {
-                code: "processing_failed",
-                message: e?.message ? String(e.message) : "Image processing failed",
+                code: 'processing_failed',
+                message: e?.message ? String(e.message) : 'Image processing failed',
                 details: { name: e?.name },
             },
         };
     }
     finally {
         if (tempFiles.length) {
-            const { rm } = await import("node:fs/promises");
+            const { rm } = await import('node:fs/promises');
             await Promise.all(tempFiles.map((f) => rm(f, { force: true }).catch(() => { })));
         }
     }

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

@@ -1 +1 @@
-{"version":3,"file":"image-processor.js","sourceRoot":"","sources":["../../src/image/image-processor.ts"],"names":[],"mappings":"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","sourcesContent":["import type { MediaOutput, MediaProcessingError, MediaProcessingResult, MediaProcessingSpec } from \"@ttt-productions/media-schemas\";\nimport sharp from \"sharp\";\nimport type { Sharp, Metadata } from \"sharp\";\nimport { mkdir } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { safeOutputPathFor } from \"../utils/safe-path.js\";\nimport type { ProcessMediaOptions } from \"../types.js\";\nimport { applyImageFormat, mimeForImageFormat, pickFormat } from \"./formats.js\";\nimport {\n  computeAspectCropBox,\n  resizeCover,\n  resizeInside,\n  toSharpPosition,\n  type Gravity,\n} from \"./resize.js\";\nimport { IMAGE_DEFAULT_OUTPUT_KEY } from \"@ttt-productions/media-schemas\";\n\nfunction matchMime(accepted: string, actual: string): boolean {\n  const a = accepted.trim().toLowerCase();\n  const m = actual.trim().toLowerCase();\n  if (!a) return true;\n  if (a === \"*/*\") return true;\n  if (a.endsWith(\"/*\")) return m.startsWith(a.slice(0, -1));\n  return a === m;\n}\n\nfunction acceptAllowsImage(spec: MediaProcessingSpec): boolean {\n  const kinds = spec.accept?.kinds?.filter(Boolean) ?? [];\n  return kinds.length === 0 ? true : kinds.includes(\"image\");\n}\n\nfunction acceptAllowsMime(spec: MediaProcessingSpec, actualMime?: string): boolean {\n  const mimes = spec.accept?.mimes?.filter(Boolean) ?? [];\n  if (mimes.length === 0) return true; // empty => accept anything\n  if (!actualMime) return false;\n  return mimes.some((a) => matchMime(a, actualMime));\n}\n\nfunction outputPathFor(base: string, key: string, ext: string): string {\n  return safeOutputPathFor(base, key, ext);\n}\n\nfunction aspect(width?: number, height?: number): number | undefined {\n  if (!width || !height) return undefined;\n  return width / height;\n}\n\nfunction aspectClose(a: number, b: number, tolerance: number): boolean {\n  return Math.abs(a - b) <= tolerance;\n}\n\n/**\n * Build a \"normalized base\" pipeline that enforces spec-level uniformity:\n * - if imageCrop exists -> always crop to outputWidth/outputHeight\n * - else if requiredWidth/requiredHeight exist -> crop/resize to those\n * - else if requiredAspectRatio exists -> center-crop to that aspect (no scaling unless needed later)\n *\n * If the source violates constraints and we cannot/should not auto-fix, returns a rejection error.\n */\nasync function buildBase(\n  spec: MediaProcessingSpec,\n  inputPath: string\n): Promise<\n  | { ok: true; base: Sharp; inputMeta: Metadata }\n  | { ok: false; error: MediaProcessingError }\n> {\n  const input = sharp(inputPath, { failOn: \"none\" });\n  const meta = await input.metadata();\n\n  if (!meta.width || !meta.height || meta.width <= 0 || meta.height <= 0) {\n    return {\n      ok: false,\n      error: {\n        code: \"processing_failed\",\n        message: \"Unable to read valid image dimensions. File may be corrupt.\",\n        details: { width: meta.width, height: meta.height, format: meta.format, path: inputPath },\n      },\n    };\n  }\n  \n  if (!meta.format) {\n    return {\n      ok: false,\n      error: {\n        code: \"unsupported_format\",\n        message: \"Unable to determine image format. File may be corrupt.\",\n        details: { path: inputPath },\n      },\n    };\n  }\n\n  if (!acceptAllowsImage(spec)) {\n    return {\n      ok: false,\n      error: {\n        code: \"invalid_mime\",\n        message: \"Spec does not allow image uploads.\",\n        details: { accept: spec.accept },\n      },\n    };\n  }\n  \n  const detectedMime = mimeForImageFormat(meta.format);\n  if (!acceptAllowsMime(spec, detectedMime)) {\n    return {\n      ok: false,\n      error: {\n        code: \"invalid_mime\",\n        message: \"Image mime type is not allowed.\",\n        details: { detectedMime, accept: spec.accept },\n      },\n    };\n  }\n\n  const w = meta.width ?? undefined;\n  const h = meta.height ?? undefined;\n\n  if (!w || !h) {\n    // Can't validate/crop reliably without dimensions.\n    // We'll still proceed unless strict dims/aspect are required without crop/auto.\n    if (spec.requiredWidth || spec.requiredHeight || spec.requiredAspectRatio) {\n      if (!spec.allowAutoFormat && !spec.imageCrop) {\n        return {\n          ok: false,\n          error: {\n            code: \"dimensions_mismatch\",\n            message: \"Unable to read image dimensions for validation.\",\n            details: { width: w, height: h },\n          },\n        };\n      }\n    }\n  }\n\n  // Start from raw input each time; callers can clone as needed.\n  let base = sharp(inputPath);\n\n  // Keep metadata only if explicitly requested.\n  if (spec.image?.stripMetadata === false) {\n    base = base.withMetadata({ orientation: meta.orientation });\n  }\n\n  // 1) Explicit crop spec (most strict)\n  const crop = spec.imageCrop;\n  if (crop) {\n    base = resizeCover(base, crop.outputWidth, crop.outputHeight);\n    return { ok: true, base, inputMeta: meta };\n  }\n\n  // 2) Exact required size -> auto crop/resize only if allowAutoFormat OR the request is inherently \"uniform\"\n  const reqW = spec.requiredWidth;\n  const reqH = spec.requiredHeight;\n  if (reqW && reqH) {\n    const canFix = spec.allowAutoFormat === true;\n    // If not allowed to auto-fix, require exact match\n    if (!canFix && w && h && (w !== reqW || h !== reqH)) {\n      return {\n        ok: false,\n        error: {\n          code: \"dimensions_mismatch\",\n          message: \"Image dimensions do not match the required format.\",\n          details: { requiredWidth: reqW, requiredHeight: reqH, width: w, height: h },\n        },\n      };\n    }\n\n    // Auto-fix path (or exact already): enforce normalized base\n    base = resizeCover(base, reqW, reqH);\n\n    return { ok: true, base, inputMeta: meta };\n  }\n\n  // 3) Aspect ratio requirement (no exact size)\n  const reqAspect = spec.requiredAspectRatio;\n  if (reqAspect && w && h) {\n    const a = aspect(w, h);\n    const tol = spec.aspectRatioTolerance ?? 0.02;\n    if (a && !aspectClose(a, reqAspect, tol)) {\n      if (!spec.allowAutoFormat) {\n        return {\n          ok: false,\n          error: {\n            code: \"aspect_ratio_mismatch\",\n            message: \"Image aspect ratio does not match the required format.\",\n            details: { requiredAspectRatio: reqAspect, aspectRatio: a, width: w, height: h },\n          },\n        };\n      }\n\n      // Auto center-crop to required aspect ratio (no forced scale yet).\n      base = base.extract(computeAspectCropBox(w, h, reqAspect));\n    }\n  }\n\n  return { ok: true, base, inputMeta: meta };\n}\n\nexport async function processImage(\n  spec: MediaProcessingSpec,\n  ctx: {\n    inputPath: string;\n    outputBasePath: string;\n  },\n  opts?: ProcessMediaOptions\n): Promise<MediaProcessingResult> {\n  const tempFiles: string[] = [];\n\n  try {\n    if (opts?.signal?.aborted) {\n      return { ok: false, mediaType: \"image\", error: { code: \"processing_canceled\", message: \"Processing canceled.\" } };\n    }\n\n    const variants = spec.image?.variants?.length ? spec.image.variants : [{ key: IMAGE_DEFAULT_OUTPUT_KEY }];\n\n    const outDir = path.dirname(ctx.outputBasePath);\n    await mkdir(outDir, { recursive: true });\n\n    const baseRes = await buildBase(spec, ctx.inputPath);\n    if (!baseRes.ok) {\n      return { ok: false, mediaType: \"image\", error: baseRes.error };\n    }\n\n    const { base, inputMeta } = baseRes;\n\n    const outputs: MediaOutput[] = [];\n    const totalVariants = variants.length || 1;\n    let idx = 0;\n\n    for (const v of variants) {\n      idx += 1;\n\n      if (opts?.signal?.aborted) {\n        return { ok: false, mediaType: \"image\", error: { code: \"processing_canceled\", message: \"Processing canceled.\" } };\n      }\n\n      opts?.onProgress?.({\n        phase: \"process\",\n        percent: (idx - 1) / totalVariants,\n        detail: { step: \"image_variant\", key: v.key },\n      });\n\n      const { ext, format } = pickFormat(v.format);\n      const outPath = outputPathFor(ctx.outputBasePath, v.key, ext);\n      tempFiles.push(outPath);\n\n      let p = base.clone();\n\n      if (v.crop) {\n        p = resizeCover(p, v.crop.width, v.crop.height, toSharpPosition((v.crop.gravity as Gravity) ?? \"center\"));\n      } else if (v.maxWidth || v.maxHeight) {\n        p = resizeInside(p, v.maxWidth, v.maxHeight);\n      }\n\n      p = applyImageFormat(p, format, v.quality);\n\n      const info = await p.toFile(outPath);\n\n      outputs.push({\n        key: v.key,\n        url: `file://${outPath}`,\n        path: outPath,\n        mime: mimeForImageFormat(info.format),\n        sizeBytes: info.size,\n        width: info.width,\n        height: info.height,\n      });\n    }\n\n    // success: keep outputs\n    tempFiles.length = 0;\n\n    return {\n      ok: true,\n      mediaType: \"image\",\n      outputs,\n      meta: {\n        mime: mimeForImageFormat(inputMeta.format),\n        width: inputMeta.width,\n        height: inputMeta.height,\n      },\n    };\n  } catch (e: any) {\n    return {\n      ok: false,\n      mediaType: \"image\",\n      error: {\n        code: \"processing_failed\",\n        message: e?.message ? String(e.message) : \"Image processing failed\",\n        details: { name: e?.name },\n      },\n    };\n  } finally {\n    if (tempFiles.length) {\n      const { rm } = await import(\"node:fs/promises\");\n      await Promise.all(tempFiles.map((f) => rm(f, { force: true }).catch(() => {})));\n    }\n  }\n}\n"]}
+{"version":3,"file":"image-processor.js","sourceRoot":"","sources":["../../src/image/image-processor.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  MediaOutput,\n  MediaProcessingError,\n  MediaProcessingResult,\n  MediaProcessingSpec,\n} from '@ttt-productions/media-schemas';\nimport sharp from 'sharp';\nimport type { Sharp, Metadata } from 'sharp';\nimport { mkdir } from 'node:fs/promises';\nimport path from 'node:path';\nimport { safeOutputPathFor } from '../utils/safe-path.js';\nimport type { ProcessMediaOptions } from '../types.js';\nimport { applyImageFormat, mimeForImageFormat, pickFormat } from './formats.js';\nimport {\n  computeAspectCropBox,\n  resizeCover,\n  resizeInside,\n  toSharpPosition,\n  type Gravity,\n} from './resize.js';\nimport { IMAGE_DEFAULT_OUTPUT_KEY } from '@ttt-productions/media-schemas';\n\nfunction matchMime(accepted: string, actual: string): boolean {\n  const a = accepted.trim().toLowerCase();\n  const m = actual.trim().toLowerCase();\n  if (!a) return true;\n  if (a === '*/*') return true;\n  if (a.endsWith('/*')) return m.startsWith(a.slice(0, -1));\n  return a === m;\n}\n\nfunction acceptAllowsImage(spec: MediaProcessingSpec): boolean {\n  const kinds = spec.accept?.kinds?.filter(Boolean) ?? [];\n  return kinds.length === 0 ? true : kinds.includes('image');\n}\n\nfunction acceptAllowsMime(spec: MediaProcessingSpec, actualMime?: string): boolean {\n  const mimes = spec.accept?.mimes?.filter(Boolean) ?? [];\n  if (mimes.length === 0) return true;\n  if (!actualMime) return false;\n  return mimes.some((a) => matchMime(a, actualMime));\n}\n\nfunction outputPathFor(base: string, key: string, ext: string): string {\n  return safeOutputPathFor(base, key, ext);\n}\n\nfunction aspect(width?: number, height?: number): number | undefined {\n  if (!width || !height) return undefined;\n  return width / height;\n}\n\nfunction aspectClose(a: number, b: number, tolerance: number): boolean {\n  return Math.abs(a - b) <= tolerance;\n}\n\nasync function buildBase(\n  spec: MediaProcessingSpec,\n  inputPath: string,\n): Promise<\n  { ok: true; base: Sharp; inputMeta: Metadata } | { ok: false; error: MediaProcessingError }\n> {\n  const input = sharp(inputPath, { failOn: 'none' });\n  const meta = await input.metadata();\n\n  if (!meta.width || !meta.height || meta.width <= 0 || meta.height <= 0) {\n    return {\n      ok: false,\n      error: {\n        code: 'processing_failed',\n        message: 'Unable to read valid image dimensions. File may be corrupt.',\n        details: { width: meta.width, height: meta.height, format: meta.format, path: inputPath },\n      },\n    };\n  }\n\n  if (!meta.format) {\n    return {\n      ok: false,\n      error: {\n        code: 'unsupported_format',\n        message: 'Unable to determine image format. File may be corrupt.',\n        details: { path: inputPath },\n      },\n    };\n  }\n\n  if (!acceptAllowsImage(spec)) {\n    return {\n      ok: false,\n      error: {\n        code: 'invalid_mime',\n        message: 'Spec does not allow image uploads.',\n        details: { accept: spec.accept },\n      },\n    };\n  }\n\n  const detectedMime = mimeForImageFormat(meta.format);\n  if (!acceptAllowsMime(spec, detectedMime)) {\n    return {\n      ok: false,\n      error: {\n        code: 'invalid_mime',\n        message: 'Image mime type is not allowed.',\n        details: { detectedMime, accept: spec.accept },\n      },\n    };\n  }\n\n  const w = meta.width ?? undefined;\n  const h = meta.height ?? undefined;\n\n  if (!w || !h) {\n    if (spec.requiredWidth || spec.requiredHeight || spec.requiredAspectRatio) {\n      if (!spec.allowAutoFormat && !spec.imageCrop) {\n        return {\n          ok: false,\n          error: {\n            code: 'dimensions_mismatch',\n            message: 'Unable to read image dimensions for validation.',\n            details: { width: w, height: h },\n          },\n        };\n      }\n    }\n  }\n\n  let base = sharp(inputPath);\n\n  if (spec.image?.stripMetadata === false) {\n    base = base.withMetadata({ orientation: meta.orientation });\n  }\n\n  const crop = spec.imageCrop;\n  if (crop) {\n    base = resizeCover(base, crop.outputWidth, crop.outputHeight);\n    return { ok: true, base, inputMeta: meta };\n  }\n\n  const reqW = spec.requiredWidth;\n  const reqH = spec.requiredHeight;\n  if (reqW && reqH) {\n    const canFix = spec.allowAutoFormat === true;\n    if (!canFix && w && h && (w !== reqW || h !== reqH)) {\n      return {\n        ok: false,\n        error: {\n          code: 'dimensions_mismatch',\n          message: 'Image dimensions do not match the required format.',\n          details: { requiredWidth: reqW, requiredHeight: reqH, width: w, height: h },\n        },\n      };\n    }\n\n    base = resizeCover(base, reqW, reqH);\n\n    return { ok: true, base, inputMeta: meta };\n  }\n\n  const reqAspect = spec.requiredAspectRatio;\n  if (reqAspect && w && h) {\n    const a = aspect(w, h);\n    const tol = spec.aspectRatioTolerance ?? 0.02;\n    if (a && !aspectClose(a, reqAspect, tol)) {\n      if (!spec.allowAutoFormat) {\n        return {\n          ok: false,\n          error: {\n            code: 'aspect_ratio_mismatch',\n            message: 'Image aspect ratio does not match the required format.',\n            details: { requiredAspectRatio: reqAspect, aspectRatio: a, width: w, height: h },\n          },\n        };\n      }\n\n      base = base.extract(computeAspectCropBox(w, h, reqAspect));\n    }\n  }\n\n  return { ok: true, base, inputMeta: meta };\n}\n\nexport async function processImage(\n  spec: MediaProcessingSpec,\n  ctx: {\n    inputPath: string;\n    outputBasePath: string;\n  },\n  opts?: ProcessMediaOptions,\n): Promise<MediaProcessingResult> {\n  const tempFiles: string[] = [];\n\n  try {\n    if (opts?.signal?.aborted) {\n      return {\n        ok: false,\n        mediaType: 'image',\n        error: { code: 'processing_canceled', message: 'Processing canceled.' },\n      };\n    }\n\n    const variants = spec.image?.variants?.length\n      ? spec.image.variants\n      : [{ key: IMAGE_DEFAULT_OUTPUT_KEY }];\n\n    const outDir = path.dirname(ctx.outputBasePath);\n    await mkdir(outDir, { recursive: true });\n\n    const baseRes = await buildBase(spec, ctx.inputPath);\n    if (!baseRes.ok) {\n      return { ok: false, mediaType: 'image', error: baseRes.error };\n    }\n\n    const { base, inputMeta } = baseRes;\n\n    const outputs: MediaOutput[] = [];\n    const totalVariants = variants.length || 1;\n    let idx = 0;\n\n    for (const v of variants) {\n      idx += 1;\n\n      if (opts?.signal?.aborted) {\n        return {\n          ok: false,\n          mediaType: 'image',\n          error: { code: 'processing_canceled', message: 'Processing canceled.' },\n        };\n      }\n\n      opts?.onProgress?.({\n        phase: 'process',\n        percent: (idx - 1) / totalVariants,\n        detail: { step: 'image_variant', key: v.key },\n      });\n\n      const { ext, format } = pickFormat(v.format);\n      const outPath = outputPathFor(ctx.outputBasePath, v.key, ext);\n      tempFiles.push(outPath);\n\n      let p = base.clone();\n\n      if (v.crop) {\n        p = resizeCover(\n          p,\n          v.crop.width,\n          v.crop.height,\n          toSharpPosition((v.crop.gravity as Gravity) ?? 'center'),\n        );\n      } else if (v.maxWidth || v.maxHeight) {\n        p = resizeInside(p, v.maxWidth, v.maxHeight);\n      }\n\n      p = applyImageFormat(p, format, v.quality);\n\n      const info = await p.toFile(outPath);\n\n      outputs.push({\n        key: v.key,\n        url: `file://${outPath}`,\n        path: outPath,\n        mime: mimeForImageFormat(info.format),\n        sizeBytes: info.size,\n        width: info.width,\n        height: info.height,\n      });\n    }\n\n    tempFiles.length = 0;\n\n    return {\n      ok: true,\n      mediaType: 'image',\n      outputs,\n      meta: {\n        mime: mimeForImageFormat(inputMeta.format),\n        width: inputMeta.width,\n        height: inputMeta.height,\n      },\n    };\n  } catch (e: any) {\n    return {\n      ok: false,\n      mediaType: 'image',\n      error: {\n        code: 'processing_failed',\n        message: e?.message ? String(e.message) : 'Image processing failed',\n        details: { name: e?.name },\n      },\n    };\n  } finally {\n    if (tempFiles.length) {\n      const { rm } = await import('node:fs/promises');\n      await Promise.all(tempFiles.map((f) => rm(f, { force: true }).catch(() => {})));\n    }\n  }\n}\n"]}

package/dist/image/resize.d.ts

@@ -1,22 +1,8 @@
-import type { Sharp, Gravity as SharpGravity } from "sharp";
-/** Logical crop/resize gravity, mapped to sharp positions by toSharpPosition. */
-export type Gravity = "center" | "top" | "bottom" | "left" | "right";
-/** Map a logical gravity to a sharp position string. Defaults to centre. */
+import type { Sharp, Gravity as SharpGravity } from 'sharp';
+export type Gravity = 'center' | 'top' | 'bottom' | 'left' | 'right';
 export declare function toSharpPosition(g?: Gravity): SharpGravity;
-/**
- * Cover-resize to an exact width/height (crop to fill), never enlarging beyond
- * the source. Used for explicit crops and required-size normalization.
- */
 export declare function resizeCover(pipeline: Sharp, width: number, height: number, position?: SharpGravity): Sharp;
-/**
- * Fit-inside resize bounded by maxWidth/maxHeight (preserves aspect ratio),
- * never enlarging beyond the source. Either bound may be omitted.
- */
 export declare function resizeInside(pipeline: Sharp, maxWidth?: number, maxHeight?: number): Sharp;
-/**
- * Compute a centered crop box that brings (width x height) to targetAspect,
- * shrinking only the longer dimension. Returns sharp .extract() coordinates.
- */
 export declare function computeAspectCropBox(width: number, height: number, targetAspect: number): {
     left: number;
     top: number;

package/dist/image/resize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resize.d.ts","sourceRoot":"","sources":["../../src/image/resize.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,OAAO,CAAC;AAE5D,iFAAiF;AACjF,MAAM,MAAM,OAAO,GAAG,QAAQ,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;AAErE,4EAA4E;AAC5E,wBAAgB,eAAe,CAAC,CAAC,CAAC,EAAE,OAAO,GAAG,YAAY,CAczD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,QAAQ,EAAE,KAAK,EACf,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,QAAQ,GAAE,YAAuB,GAChC,KAAK,CAMP;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,KAAK,EACf,QAAQ,CAAC,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,GACjB,KAAK,CAKP;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,GACnB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAiB9D"}
+{"version":3,"file":"resize.d.ts","sourceRoot":"","sources":["../../src/image/resize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,OAAO,CAAC;AAE5D,MAAM,MAAM,OAAO,GAAG,QAAQ,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;AAErE,wBAAgB,eAAe,CAAC,CAAC,CAAC,EAAE,OAAO,GAAG,YAAY,CAczD;AAED,wBAAgB,WAAW,CACzB,QAAQ,EAAE,KAAK,EACf,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,QAAQ,GAAE,YAAuB,GAChC,KAAK,CAMP;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,KAAK,CAK1F;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,GACnB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAe9D"}

package/dist/image/resize.js

@@ -1,54 +1,39 @@
-/** Map a logical gravity to a sharp position string. Defaults to centre. */
 export function toSharpPosition(g) {
     switch (g) {
-        case "top":
-            return "north";
-        case "bottom":
-            return "south";
-        case "left":
-            return "west";
-        case "right":
-            return "east";
-        case "center":
+        case 'top':
+            return 'north';
+        case 'bottom':
+            return 'south';
+        case 'left':
+            return 'west';
+        case 'right':
+            return 'east';
+        case 'center':
         default:
-            return "centre";
+            return 'centre';
     }
 }
-/**
- * Cover-resize to an exact width/height (crop to fill), never enlarging beyond
- * the source. Used for explicit crops and required-size normalization.
- */
-export function resizeCover(pipeline, width, height, position = "centre") {
+export function resizeCover(pipeline, width, height, position = 'centre') {
     return pipeline.resize(width, height, {
-        fit: "cover",
+        fit: 'cover',
         position,
         withoutEnlargement: true,
     });
 }
-/**
- * Fit-inside resize bounded by maxWidth/maxHeight (preserves aspect ratio),
- * never enlarging beyond the source. Either bound may be omitted.
- */
 export function resizeInside(pipeline, maxWidth, maxHeight) {
     return pipeline.resize(maxWidth ?? null, maxHeight ?? null, {
-        fit: "inside",
+        fit: 'inside',
         withoutEnlargement: true,
     });
 }
-/**
- * Compute a centered crop box that brings (width x height) to targetAspect,
- * shrinking only the longer dimension. Returns sharp .extract() coordinates.
- */
 export function computeAspectCropBox(width, height, targetAspect) {
     const a = width / height;
     let cropW = width;
     let cropH = height;
     if (a > targetAspect) {
-        // too wide -> reduce width
         cropW = Math.max(1, Math.floor(height * targetAspect));
     }
     else {
-        // too tall -> reduce height
         cropH = Math.max(1, Math.floor(width / targetAspect));
     }
     const left = Math.max(0, Math.floor((width - cropW) / 2));

package/dist/image/resize.js.map

@@ -1 +1 @@
-{"version":3,"file":"resize.js","sourceRoot":"","sources":["../../src/image/resize.ts"],"names":[],"mappings":"AAMA,4EAA4E;AAC5E,MAAM,UAAU,eAAe,CAAC,CAAW;IACzC,QAAQ,CAAC,EAAE,CAAC;QACV,KAAK,KAAK;YACR,OAAO,OAAO,CAAC;QACjB,KAAK,QAAQ;YACX,OAAO,OAAO,CAAC;QACjB,KAAK,MAAM;YACT,OAAO,MAAM,CAAC;QAChB,KAAK,OAAO;YACV,OAAO,MAAM,CAAC;QAChB,KAAK,QAAQ,CAAC;QACd;YACE,OAAO,QAAQ,CAAC;IACpB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CACzB,QAAe,EACf,KAAa,EACb,MAAc,EACd,WAAyB,QAAQ;IAEjC,OAAO,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE;QACpC,GAAG,EAAE,OAAO;QACZ,QAAQ;QACR,kBAAkB,EAAE,IAAI;KACzB,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAC1B,QAAe,EACf,QAAiB,EACjB,SAAkB;IAElB,OAAO,QAAQ,CAAC,MAAM,CAAC,QAAQ,IAAI,IAAI,EAAE,SAAS,IAAI,IAAI,EAAE;QAC1D,GAAG,EAAE,QAAQ;QACb,kBAAkB,EAAE,IAAI;KACzB,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAAa,EACb,MAAc,EACd,YAAoB;IAEpB,MAAM,CAAC,GAAG,KAAK,GAAG,MAAM,CAAC;IACzB,IAAI,KAAK,GAAG,KAAK,CAAC;IAClB,IAAI,KAAK,GAAG,MAAM,CAAC;IAEnB,IAAI,CAAC,GAAG,YAAY,EAAE,CAAC;QACrB,2BAA2B;QAC3B,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC;IACzD,CAAC;SAAM,CAAC;QACN,4BAA4B;QAC5B,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,YAAY,CAAC,CAAC,CAAC;IACxD,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAE1D,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AACpD,CAAC","sourcesContent":["// sharp resize helpers extracted from the image-processor\nimport type { Sharp, Gravity as SharpGravity } from \"sharp\";\n\n/** Logical crop/resize gravity, mapped to sharp positions by toSharpPosition. */\nexport type Gravity = \"center\" | \"top\" | \"bottom\" | \"left\" | \"right\";\n\n/** Map a logical gravity to a sharp position string. Defaults to centre. */\nexport function toSharpPosition(g?: Gravity): SharpGravity {\n  switch (g) {\n    case \"top\":\n      return \"north\";\n    case \"bottom\":\n      return \"south\";\n    case \"left\":\n      return \"west\";\n    case \"right\":\n      return \"east\";\n    case \"center\":\n    default:\n      return \"centre\";\n  }\n}\n\n/**\n * Cover-resize to an exact width/height (crop to fill), never enlarging beyond\n * the source. Used for explicit crops and required-size normalization.\n */\nexport function resizeCover(\n  pipeline: Sharp,\n  width: number,\n  height: number,\n  position: SharpGravity = \"centre\"\n): Sharp {\n  return pipeline.resize(width, height, {\n    fit: \"cover\",\n    position,\n    withoutEnlargement: true,\n  });\n}\n\n/**\n * Fit-inside resize bounded by maxWidth/maxHeight (preserves aspect ratio),\n * never enlarging beyond the source. Either bound may be omitted.\n */\nexport function resizeInside(\n  pipeline: Sharp,\n  maxWidth?: number,\n  maxHeight?: number\n): Sharp {\n  return pipeline.resize(maxWidth ?? null, maxHeight ?? null, {\n    fit: \"inside\",\n    withoutEnlargement: true,\n  });\n}\n\n/**\n * Compute a centered crop box that brings (width x height) to targetAspect,\n * shrinking only the longer dimension. Returns sharp .extract() coordinates.\n */\nexport function computeAspectCropBox(\n  width: number,\n  height: number,\n  targetAspect: number\n): { left: number; top: number; width: number; height: number } {\n  const a = width / height;\n  let cropW = width;\n  let cropH = height;\n\n  if (a > targetAspect) {\n    // too wide -> reduce width\n    cropW = Math.max(1, Math.floor(height * targetAspect));\n  } else {\n    // too tall -> reduce height\n    cropH = Math.max(1, Math.floor(width / targetAspect));\n  }\n\n  const left = Math.max(0, Math.floor((width - cropW) / 2));\n  const top = Math.max(0, Math.floor((height - cropH) / 2));\n\n  return { left, top, width: cropW, height: cropH };\n}\n"]}
+{"version":3,"file":"resize.js","sourceRoot":"","sources":["../../src/image/resize.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,eAAe,CAAC,CAAW;IACzC,QAAQ,CAAC,EAAE,CAAC;QACV,KAAK,KAAK;YACR,OAAO,OAAO,CAAC;QACjB,KAAK,QAAQ;YACX,OAAO,OAAO,CAAC;QACjB,KAAK,MAAM;YACT,OAAO,MAAM,CAAC;QAChB,KAAK,OAAO;YACV,OAAO,MAAM,CAAC;QAChB,KAAK,QAAQ,CAAC;QACd;YACE,OAAO,QAAQ,CAAC;IACpB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,QAAe,EACf,KAAa,EACb,MAAc,EACd,WAAyB,QAAQ;IAEjC,OAAO,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE;QACpC,GAAG,EAAE,OAAO;QACZ,QAAQ;QACR,kBAAkB,EAAE,IAAI;KACzB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,QAAe,EAAE,QAAiB,EAAE,SAAkB;IACjF,OAAO,QAAQ,CAAC,MAAM,CAAC,QAAQ,IAAI,IAAI,EAAE,SAAS,IAAI,IAAI,EAAE;QAC1D,GAAG,EAAE,QAAQ;QACb,kBAAkB,EAAE,IAAI;KACzB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,KAAa,EACb,MAAc,EACd,YAAoB;IAEpB,MAAM,CAAC,GAAG,KAAK,GAAG,MAAM,CAAC;IACzB,IAAI,KAAK,GAAG,KAAK,CAAC;IAClB,IAAI,KAAK,GAAG,MAAM,CAAC;IAEnB,IAAI,CAAC,GAAG,YAAY,EAAE,CAAC;QACrB,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC;IACzD,CAAC;SAAM,CAAC;QACN,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,YAAY,CAAC,CAAC,CAAC;IACxD,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAE1D,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AACpD,CAAC","sourcesContent":["import type { Sharp, Gravity as SharpGravity } from 'sharp';\n\nexport type Gravity = 'center' | 'top' | 'bottom' | 'left' | 'right';\n\nexport function toSharpPosition(g?: Gravity): SharpGravity {\n  switch (g) {\n    case 'top':\n      return 'north';\n    case 'bottom':\n      return 'south';\n    case 'left':\n      return 'west';\n    case 'right':\n      return 'east';\n    case 'center':\n    default:\n      return 'centre';\n  }\n}\n\nexport function resizeCover(\n  pipeline: Sharp,\n  width: number,\n  height: number,\n  position: SharpGravity = 'centre',\n): Sharp {\n  return pipeline.resize(width, height, {\n    fit: 'cover',\n    position,\n    withoutEnlargement: true,\n  });\n}\n\nexport function resizeInside(pipeline: Sharp, maxWidth?: number, maxHeight?: number): Sharp {\n  return pipeline.resize(maxWidth ?? null, maxHeight ?? null, {\n    fit: 'inside',\n    withoutEnlargement: true,\n  });\n}\n\nexport function computeAspectCropBox(\n  width: number,\n  height: number,\n  targetAspect: number,\n): { left: number; top: number; width: number; height: number } {\n  const a = width / height;\n  let cropW = width;\n  let cropH = height;\n\n  if (a > targetAspect) {\n    cropW = Math.max(1, Math.floor(height * targetAspect));\n  } else {\n    cropH = Math.max(1, Math.floor(width / targetAspect));\n  }\n\n  const left = Math.max(0, Math.floor((width - cropW) / 2));\n  const top = Math.max(0, Math.floor((height - cropH) / 2));\n\n  return { left, top, width: cropW, height: cropH };\n}\n"]}

package/dist/index.d.ts

@@ -1,17 +1,20 @@
-export * from "./image/index.js";
-export * from "./image/image-processor.js";
-export * from "./video/index.js";
-export * from "./video/video-processor.js";
-export * from "./process-media.js";
-export * from "./workspace/temp.js";
-export * from "./audio/index.js";
-export * from "./audio/audio-processor.js";
-export * from "./io/types.js";
-export * from "./run-pipeline.js";
-export * from "./inspection/inspect-media.js";
-export * from "./duration/media-duration.js";
-export * from "./io/fs.js";
-export * from "./io/local-input.js";
-export * from "./moderation/types.js";
-export * from "./moderation/merge.js";
+export * from './image/image-processor.js';
+export * from './image/formats.js';
+export * from './image/resize.js';
+export * from './video/video-processor.js';
+export * from './video/probe.js';
+export * from './video/ffmpeg.js';
+export * from './process-media.js';
+export type { MediaPipelineProgress, MediaProcessors, ProcessMediaContext, ProcessMediaOptions, } from './types.js';
+export * from './workspace/temp.js';
+export * from './audio/audio-processor.js';
+export * from './audio/probe.js';
+export * from './io/types.js';
+export * from './run-pipeline.js';
+export * from './inspection/inspect-media.js';
+export * from './duration/media-duration.js';
+export * from './io/fs.js';
+export * from './io/local-input.js';
+export * from './moderation/types.js';
+export * from './moderation/merge.js';
 //# sourceMappingURL=index.d.ts.map