@webiny/api-file-manager 0.0.0-unstable.b14eaecf38 → 0.0.0-unstable.b6d7105cee

package/features/assetDelivery/assetTypes/image/WidthCollection.d.ts

@@ -0,0 +1,8 @@
+export declare class WidthCollection {
+    private readonly values;
+    static create(values: number[]): WidthCollection;
+    private constructor();
+    max(): number;
+    min(): number;
+    getClosestOrMax(value: number | undefined): number;
+}

package/features/assetDelivery/assetTypes/image/WidthCollection.js

@@ -0,0 +1,22 @@
+class WidthCollection {
+    static create(values) {
+        return new WidthCollection(values);
+    }
+    constructor(values){
+        this.values = values.sort((a, b)=>a - b);
+    }
+    max() {
+        return Math.max(...this.values);
+    }
+    min() {
+        return Math.min(...this.values);
+    }
+    getClosestOrMax(value) {
+        if (!value) return this.max();
+        const gteGivenValue = this.values.filter((w)=>w >= value);
+        return gteGivenValue.length > 0 ? gteGivenValue[0] : this.max();
+    }
+}
+export { WidthCollection };
+
+//# sourceMappingURL=WidthCollection.js.map

package/features/assetDelivery/assetTypes/image/WidthCollection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features/assetDelivery/assetTypes/image/WidthCollection.js","sources":["../../../../../src/features/assetDelivery/assetTypes/image/WidthCollection.ts"],"sourcesContent":["export class WidthCollection {\n    private readonly values: number[];\n\n    public static create(values: number[]) {\n        return new WidthCollection(values);\n    }\n\n    private constructor(values: number[]) {\n        this.values = values.sort((a, b) => a - b);\n    }\n\n    public max() {\n        return Math.max(...this.values);\n    }\n\n    public min() {\n        return Math.min(...this.values);\n    }\n\n    public getClosestOrMax(value: number | undefined): number {\n        if (!value) {\n            return this.max();\n        }\n        const gteGivenValue = this.values.filter(w => w >= value);\n        return gteGivenValue.length > 0 ? gteGivenValue[0] : this.max();\n    }\n}\n"],"names":["WidthCollection","values","a","b","Math","value","gteGivenValue","w"],"mappings":"AAAO,MAAMA;IAGT,OAAc,OAAOC,MAAgB,EAAE;QACnC,OAAO,IAAID,gBAAgBC;IAC/B;IAEA,YAAoBA,MAAgB,CAAE;QAClC,IAAI,CAAC,MAAM,GAAGA,OAAO,IAAI,CAAC,CAACC,GAAGC,IAAMD,IAAIC;IAC5C;IAEO,MAAM;QACT,OAAOC,KAAK,GAAG,IAAI,IAAI,CAAC,MAAM;IAClC;IAEO,MAAM;QACT,OAAOA,KAAK,GAAG,IAAI,IAAI,CAAC,MAAM;IAClC;IAEO,gBAAgBC,KAAyB,EAAU;QACtD,IAAI,CAACA,OACD,OAAO,IAAI,CAAC,GAAG;QAEnB,MAAMC,gBAAgB,IAAI,CAAC,MAAM,CAAC,MAAM,CAACC,CAAAA,IAAKA,KAAKF;QACnD,OAAOC,cAAc,MAAM,GAAG,IAAIA,aAAa,CAAC,EAAE,GAAG,IAAI,CAAC,GAAG;IACjE;AACJ"}

package/features/assetDelivery/assetTypes/image/imageFormat.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Pure image-format helpers. IMPORTANT: this module must NOT import `sharp` (a
+ * native module). It is reachable from the GraphQL API handler via the asset
+ * request resolvers, and loading `sharp` there would crash that Lambda. The
+ * actual sharp pipeline lives in `transformImage.ts`, which only the transform
+ * strategies (the image Lambda) import.
+ */
+export type ImageFormat = "jpeg" | "png" | "webp" | "avif";
+export declare const SUPPORTED_OUTPUT_FORMATS: ImageFormat[];
+/**
+ * Default encoder quality per output format. AVIF reaches a comparable visual
+ * quality at a lower number than JPEG/WebP, hence the lower default.
+ */
+export declare const DEFAULT_IMAGE_QUALITY: Record<ImageFormat, number>;
+export declare const contentTypeForFormat: (format: ImageFormat) => string;
+export declare const formatFromContentType: (contentType: string) => ImageFormat | undefined;
+/**
+ * Resolve a requested format string into a concrete output format.
+ *
+ * `"auto"` negotiates from the `Accept` header (AVIF ▸ WebP ▸ keep original), which
+ * is how we approach `next/image`'s automatic modern-format delivery. Returns
+ * `undefined` when the original format should be kept.
+ */
+export declare const resolveRequestedFormat: (requested: string | undefined, acceptHeader: string | undefined) => ImageFormat | undefined;
+/** Clamp a requested quality into the valid 1–100 range; `undefined` when absent/invalid. */
+export declare const clampQuality: (value: number | undefined) => number | undefined;

package/features/assetDelivery/assetTypes/image/imageFormat.js

@@ -0,0 +1,51 @@
+const SUPPORTED_OUTPUT_FORMATS = [
+    "jpeg",
+    "png",
+    "webp",
+    "avif"
+];
+const DEFAULT_IMAGE_QUALITY = {
+    jpeg: 75,
+    png: 80,
+    webp: 75,
+    avif: 55
+};
+const CONTENT_TYPE_BY_FORMAT = {
+    jpeg: "image/jpeg",
+    png: "image/png",
+    webp: "image/webp",
+    avif: "image/avif"
+};
+const contentTypeForFormat = (format)=>CONTENT_TYPE_BY_FORMAT[format];
+const formatFromContentType = (contentType)=>{
+    switch(contentType){
+        case "image/jpeg":
+        case "image/jpg":
+            return "jpeg";
+        case "image/png":
+            return "png";
+        case "image/webp":
+            return "webp";
+        case "image/avif":
+            return "avif";
+        default:
+            return;
+    }
+};
+const resolveRequestedFormat = (requested, acceptHeader)=>{
+    if (!requested) return;
+    if ("auto" === requested) {
+        const accept = acceptHeader ?? "";
+        if (accept.includes("image/avif")) return "avif";
+        if (accept.includes("image/webp")) return "webp";
+        return;
+    }
+    return SUPPORTED_OUTPUT_FORMATS.includes(requested) ? requested : void 0;
+};
+const clampQuality = (value)=>{
+    if (void 0 === value || Number.isNaN(value)) return;
+    return Math.min(100, Math.max(1, Math.round(value)));
+};
+export { DEFAULT_IMAGE_QUALITY, SUPPORTED_OUTPUT_FORMATS, clampQuality, contentTypeForFormat, formatFromContentType, resolveRequestedFormat };
+
+//# sourceMappingURL=imageFormat.js.map

package/features/assetDelivery/assetTypes/image/imageFormat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features/assetDelivery/assetTypes/image/imageFormat.js","sources":["../../../../../src/features/assetDelivery/assetTypes/image/imageFormat.ts"],"sourcesContent":["/**\n * Pure image-format helpers. IMPORTANT: this module must NOT import `sharp` (a\n * native module). It is reachable from the GraphQL API handler via the asset\n * request resolvers, and loading `sharp` there would crash that Lambda. The\n * actual sharp pipeline lives in `transformImage.ts`, which only the transform\n * strategies (the image Lambda) import.\n */\n\nexport type ImageFormat = \"jpeg\" | \"png\" | \"webp\" | \"avif\";\n\nexport const SUPPORTED_OUTPUT_FORMATS: ImageFormat[] = [\"jpeg\", \"png\", \"webp\", \"avif\"];\n\n/**\n * Default encoder quality per output format. AVIF reaches a comparable visual\n * quality at a lower number than JPEG/WebP, hence the lower default.\n */\nexport const DEFAULT_IMAGE_QUALITY: Record<ImageFormat, number> = {\n    jpeg: 75,\n    png: 80,\n    webp: 75,\n    avif: 55\n};\n\nconst CONTENT_TYPE_BY_FORMAT: Record<ImageFormat, string> = {\n    jpeg: \"image/jpeg\",\n    png: \"image/png\",\n    webp: \"image/webp\",\n    avif: \"image/avif\"\n};\n\nexport const contentTypeForFormat = (format: ImageFormat): string => CONTENT_TYPE_BY_FORMAT[format];\n\nexport const formatFromContentType = (contentType: string): ImageFormat | undefined => {\n    switch (contentType) {\n        case \"image/jpeg\":\n        case \"image/jpg\":\n            return \"jpeg\";\n        case \"image/png\":\n            return \"png\";\n        case \"image/webp\":\n            return \"webp\";\n        case \"image/avif\":\n            return \"avif\";\n        default:\n            return undefined;\n    }\n};\n\n/**\n * Resolve a requested format string into a concrete output format.\n *\n * `\"auto\"` negotiates from the `Accept` header (AVIF ▸ WebP ▸ keep original), which\n * is how we approach `next/image`'s automatic modern-format delivery. Returns\n * `undefined` when the original format should be kept.\n */\nexport const resolveRequestedFormat = (\n    requested: string | undefined,\n    acceptHeader: string | undefined\n): ImageFormat | undefined => {\n    if (!requested) {\n        return undefined;\n    }\n\n    if (requested === \"auto\") {\n        const accept = acceptHeader ?? \"\";\n        if (accept.includes(\"image/avif\")) {\n            return \"avif\";\n        }\n        if (accept.includes(\"image/webp\")) {\n            return \"webp\";\n        }\n        return undefined;\n    }\n\n    return SUPPORTED_OUTPUT_FORMATS.includes(requested as ImageFormat)\n        ? (requested as ImageFormat)\n        : undefined;\n};\n\n/** Clamp a requested quality into the valid 1–100 range; `undefined` when absent/invalid. */\nexport const clampQuality = (value: number | undefined): number | undefined => {\n    if (value === undefined || Number.isNaN(value)) {\n        return undefined;\n    }\n    return Math.min(100, Math.max(1, Math.round(value)));\n};\n"],"names":["SUPPORTED_OUTPUT_FORMATS","DEFAULT_IMAGE_QUALITY","CONTENT_TYPE_BY_FORMAT","contentTypeForFormat","format","formatFromContentType","contentType","resolveRequestedFormat","requested","acceptHeader","accept","undefined","clampQuality","value","Number","Math"],"mappings":"AAUO,MAAMA,2BAA0C;IAAC;IAAQ;IAAO;IAAQ;CAAO;AAM/E,MAAMC,wBAAqD;IAC9D,MAAM;IACN,KAAK;IACL,MAAM;IACN,MAAM;AACV;AAEA,MAAMC,yBAAsD;IACxD,MAAM;IACN,KAAK;IACL,MAAM;IACN,MAAM;AACV;AAEO,MAAMC,uBAAuB,CAACC,SAAgCF,sBAAsB,CAACE,OAAO;AAE5F,MAAMC,wBAAwB,CAACC;IAClC,OAAQA;QACJ,KAAK;QACL,KAAK;YACD,OAAO;QACX,KAAK;YACD,OAAO;QACX,KAAK;YACD,OAAO;QACX,KAAK;YACD,OAAO;QACX;YACI;IACR;AACJ;AASO,MAAMC,yBAAyB,CAClCC,WACAC;IAEA,IAAI,CAACD,WACD;IAGJ,IAAIA,AAAc,WAAdA,WAAsB;QACtB,MAAME,SAASD,gBAAgB;QAC/B,IAAIC,OAAO,QAAQ,CAAC,eAChB,OAAO;QAEX,IAAIA,OAAO,QAAQ,CAAC,eAChB,OAAO;QAEX;IACJ;IAEA,OAAOV,yBAAyB,QAAQ,CAACQ,aAClCA,YACDG;AACV;AAGO,MAAMC,eAAe,CAACC;IACzB,IAAIA,AAAUF,WAAVE,SAAuBC,OAAO,KAAK,CAACD,QACpC;IAEJ,OAAOE,KAAK,GAAG,CAAC,KAAKA,KAAK,GAAG,CAAC,GAAGA,KAAK,KAAK,CAACF;AAChD"}

package/features/assetDelivery/assetTypes/image/imageTypes.d.ts

@@ -0,0 +1,39 @@
+import type { ImageFormat } from "./imageFormat.js";
+/** Crop expressed as the fraction (0..1) cut off from each edge of the original. */
+export interface AssetCrop {
+    top: number;
+    left: number;
+    bottom: number;
+    right: number;
+}
+/** Asset-level, non-destructive image edit applied at delivery time. */
+export interface AssetImageEdit {
+    crop?: AssetCrop;
+}
+/** Image-specific request options parsed from query parameters. */
+export interface ImageRequestOptions {
+    original?: boolean;
+    width?: number;
+    /** Encoder quality (1–100). */
+    quality?: number;
+    /** Concrete output format (already resolved from any "auto" request). */
+    format?: ImageFormat;
+    /** Per-request crop (normalized 0–1 edge insets). Supersedes asset-level crop. */
+    crop?: AssetCrop;
+    /** Target aspect ratio (width / height). */
+    aspectRatio?: number;
+    /** Normalized 0–1 focal point kept in frame when aspectRatio forces extra cutting. */
+    focal?: {
+        x: number;
+        y: number;
+    };
+}
+/** Combined crop + focal + aspect ratio for cache key generation and pixel extraction. */
+export interface Framing {
+    crop?: AssetCrop;
+    focal?: {
+        x: number;
+        y: number;
+    };
+    aspectRatio?: number;
+}

package/features/assetDelivery/assetTypes/image/index.d.ts

@@ -0,0 +1,5 @@
+export { ImageAssetType } from "./ImageAssetType.js";
+export { ImageAssetTypeHandler } from "./ImageAssetTypeHandler.js";
+export { AssetKeyGenerator } from "./AssetKeyGenerator.js";
+export { SUPPORTED_TRANSFORMABLE_IMAGES, getImageKey, getCropSignature, getFramingSignature, getOptimizedImageKeyPrefix, getOptimizedTransformedImageKeyPrefix } from "./utils.js";
+export type { AssetCrop, AssetImageEdit, ImageRequestOptions, Framing } from "./imageTypes.js";

package/features/assetDelivery/assetTypes/image/index.js

@@ -0,0 +1,4 @@
+export { ImageAssetType } from "./ImageAssetType.js";
+export { ImageAssetTypeHandler } from "./ImageAssetTypeHandler.js";
+export { AssetKeyGenerator } from "./AssetKeyGenerator.js";
+export { SUPPORTED_TRANSFORMABLE_IMAGES, getCropSignature, getFramingSignature, getImageKey, getOptimizedImageKeyPrefix, getOptimizedTransformedImageKeyPrefix } from "./utils.js";

package/features/assetDelivery/assetTypes/image/normalizeImageOptions.d.ts

@@ -0,0 +1,6 @@
+import type { ImageRequestOptions } from "./imageTypes.js";
+/**
+ * Parse raw query params into typed image request options.
+ * Returns a new `ImageRequestOptions` object; does not mutate the input.
+ */
+export declare const normalizeImageOptions: (query: Record<string, any>, acceptHeader: string | undefined) => ImageRequestOptions;

package/features/assetDelivery/assetTypes/image/normalizeImageOptions.js

@@ -0,0 +1,56 @@
+import { clampQuality, resolveRequestedFormat } from "./imageFormat.js";
+const normalizeImageOptions = (query, acceptHeader)=>{
+    const result = {
+        original: "original" in query
+    };
+    const width = query.width ? parseInt(query.width, 10) : NaN;
+    if (!Number.isNaN(width) && width > 0) result.width = width;
+    const quality = void 0 !== query.quality ? clampQuality(parseInt(query.quality, 10)) : void 0;
+    if (void 0 !== quality) result.quality = quality;
+    const format = resolveRequestedFormat(query.format, acceptHeader);
+    if (format) result.format = format;
+    const crop = parseCrop(query.crop);
+    if (crop) result.crop = crop;
+    const aspectRatio = parseAspectRatio(query.aspectRatio);
+    if (aspectRatio) result.aspectRatio = aspectRatio;
+    const focal = parseFocal(query.focal);
+    if (focal) result.focal = focal;
+    return result;
+};
+const parseAspectRatio = (raw)=>{
+    if ("string" != typeof raw) return;
+    if (raw.includes(":")) {
+        const [w, h] = raw.split(":").map((v)=>parseFloat(v));
+        return w > 0 && h > 0 ? w / h : void 0;
+    }
+    const value = parseFloat(raw);
+    return !Number.isNaN(value) && value > 0 ? value : void 0;
+};
+const parseFocal = (raw)=>{
+    if ("string" != typeof raw) return;
+    const parts = raw.split(",").map((v)=>parseFloat(v));
+    if (2 !== parts.length || parts.some((n)=>Number.isNaN(n))) return;
+    const clamp01 = (n)=>Math.min(1, Math.max(0, n));
+    return {
+        x: clamp01(parts[0]),
+        y: clamp01(parts[1])
+    };
+};
+const parseCrop = (raw)=>{
+    if ("string" != typeof raw) return;
+    const parts = raw.split(",").map((v)=>parseFloat(v));
+    if (4 !== parts.length || parts.some((n)=>Number.isNaN(n))) return;
+    const clamp01 = (n)=>Math.min(1, Math.max(0, n));
+    const [top, left, bottom, right] = parts.map(clamp01);
+    if (0 === top && 0 === left && 0 === bottom && 0 === right) return;
+    if (top + bottom >= 1 || left + right >= 1) return;
+    return {
+        top,
+        left,
+        bottom,
+        right
+    };
+};
+export { normalizeImageOptions };
+
+//# sourceMappingURL=normalizeImageOptions.js.map

package/features/assetDelivery/assetTypes/image/normalizeImageOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features/assetDelivery/assetTypes/image/normalizeImageOptions.js","sources":["../../../../../src/features/assetDelivery/assetTypes/image/normalizeImageOptions.ts"],"sourcesContent":["import type { ImageRequestOptions } from \"./imageTypes.js\";\nimport { clampQuality, resolveRequestedFormat } from \"./imageFormat.js\";\n\n/**\n * Parse raw query params into typed image request options.\n * Returns a new `ImageRequestOptions` object; does not mutate the input.\n */\nexport const normalizeImageOptions = (\n    query: Record<string, any>,\n    acceptHeader: string | undefined\n): ImageRequestOptions => {\n    const result: ImageRequestOptions = {\n        original: \"original\" in query\n    };\n\n    const width = query.width ? parseInt(query.width, 10) : NaN;\n    if (!Number.isNaN(width) && width > 0) {\n        result.width = width;\n    }\n\n    const quality =\n        query.quality !== undefined ? clampQuality(parseInt(query.quality, 10)) : undefined;\n    if (quality !== undefined) {\n        result.quality = quality;\n    }\n\n    const format = resolveRequestedFormat(query.format, acceptHeader);\n    if (format) {\n        result.format = format;\n    }\n\n    const crop = parseCrop(query.crop);\n    if (crop) {\n        result.crop = crop;\n    }\n\n    const aspectRatio = parseAspectRatio(query.aspectRatio);\n    if (aspectRatio) {\n        result.aspectRatio = aspectRatio;\n    }\n\n    const focal = parseFocal(query.focal);\n    if (focal) {\n        result.focal = focal;\n    }\n\n    return result;\n};\n\nconst parseAspectRatio = (raw: unknown): number | undefined => {\n    if (typeof raw !== \"string\") {\n        return undefined;\n    }\n    if (raw.includes(\":\")) {\n        const [w, h] = raw.split(\":\").map(v => parseFloat(v));\n        return w > 0 && h > 0 ? w / h : undefined;\n    }\n    const value = parseFloat(raw);\n    return !Number.isNaN(value) && value > 0 ? value : undefined;\n};\n\nconst parseFocal = (raw: unknown): { x: number; y: number } | undefined => {\n    if (typeof raw !== \"string\") {\n        return undefined;\n    }\n    const parts = raw.split(\",\").map(v => parseFloat(v));\n    if (parts.length !== 2 || parts.some(n => Number.isNaN(n))) {\n        return undefined;\n    }\n    const clamp01 = (n: number) => Math.min(1, Math.max(0, n));\n    return { x: clamp01(parts[0]), y: clamp01(parts[1]) };\n};\n\nconst parseCrop = (\n    raw: unknown\n): { top: number; left: number; bottom: number; right: number } | undefined => {\n    if (typeof raw !== \"string\") {\n        return undefined;\n    }\n    const parts = raw.split(\",\").map(v => parseFloat(v));\n    if (parts.length !== 4 || parts.some(n => Number.isNaN(n))) {\n        return undefined;\n    }\n    const clamp01 = (n: number) => Math.min(1, Math.max(0, n));\n    const [top, left, bottom, right] = parts.map(clamp01);\n    if (top === 0 && left === 0 && bottom === 0 && right === 0) {\n        return undefined;\n    }\n    if (top + bottom >= 1 || left + right >= 1) {\n        return undefined;\n    }\n    return { top, left, bottom, right };\n};\n"],"names":["normalizeImageOptions","query","acceptHeader","result","width","parseInt","NaN","Number","quality","undefined","clampQuality","format","resolveRequestedFormat","crop","parseCrop","aspectRatio","parseAspectRatio","focal","parseFocal","raw","w","h","v","parseFloat","value","parts","n","clamp01","Math","top","left","bottom","right"],"mappings":";AAOO,MAAMA,wBAAwB,CACjCC,OACAC;IAEA,MAAMC,SAA8B;QAChC,UAAU,cAAcF;IAC5B;IAEA,MAAMG,QAAQH,MAAM,KAAK,GAAGI,SAASJ,MAAM,KAAK,EAAE,MAAMK;IACxD,IAAI,CAACC,OAAO,KAAK,CAACH,UAAUA,QAAQ,GAChCD,OAAO,KAAK,GAAGC;IAGnB,MAAMI,UACFP,AAAkBQ,WAAlBR,MAAM,OAAO,GAAiBS,aAAaL,SAASJ,MAAM,OAAO,EAAE,OAAOQ;IAC9E,IAAID,AAAYC,WAAZD,SACAL,OAAO,OAAO,GAAGK;IAGrB,MAAMG,SAASC,uBAAuBX,MAAM,MAAM,EAAEC;IACpD,IAAIS,QACAR,OAAO,MAAM,GAAGQ;IAGpB,MAAME,OAAOC,UAAUb,MAAM,IAAI;IACjC,IAAIY,MACAV,OAAO,IAAI,GAAGU;IAGlB,MAAME,cAAcC,iBAAiBf,MAAM,WAAW;IACtD,IAAIc,aACAZ,OAAO,WAAW,GAAGY;IAGzB,MAAME,QAAQC,WAAWjB,MAAM,KAAK;IACpC,IAAIgB,OACAd,OAAO,KAAK,GAAGc;IAGnB,OAAOd;AACX;AAEA,MAAMa,mBAAmB,CAACG;IACtB,IAAI,AAAe,YAAf,OAAOA,KACP;IAEJ,IAAIA,IAAI,QAAQ,CAAC,MAAM;QACnB,MAAM,CAACC,GAAGC,EAAE,GAAGF,IAAI,KAAK,CAAC,KAAK,GAAG,CAACG,CAAAA,IAAKC,WAAWD;QAClD,OAAOF,IAAI,KAAKC,IAAI,IAAID,IAAIC,IAAIZ;IACpC;IACA,MAAMe,QAAQD,WAAWJ;IACzB,OAAO,CAACZ,OAAO,KAAK,CAACiB,UAAUA,QAAQ,IAAIA,QAAQf;AACvD;AAEA,MAAMS,aAAa,CAACC;IAChB,IAAI,AAAe,YAAf,OAAOA,KACP;IAEJ,MAAMM,QAAQN,IAAI,KAAK,CAAC,KAAK,GAAG,CAACG,CAAAA,IAAKC,WAAWD;IACjD,IAAIG,AAAiB,MAAjBA,MAAM,MAAM,IAAUA,MAAM,IAAI,CAACC,CAAAA,IAAKnB,OAAO,KAAK,CAACmB,KACnD;IAEJ,MAAMC,UAAU,CAACD,IAAcE,KAAK,GAAG,CAAC,GAAGA,KAAK,GAAG,CAAC,GAAGF;IACvD,OAAO;QAAE,GAAGC,QAAQF,KAAK,CAAC,EAAE;QAAG,GAAGE,QAAQF,KAAK,CAAC,EAAE;IAAE;AACxD;AAEA,MAAMX,YAAY,CACdK;IAEA,IAAI,AAAe,YAAf,OAAOA,KACP;IAEJ,MAAMM,QAAQN,IAAI,KAAK,CAAC,KAAK,GAAG,CAACG,CAAAA,IAAKC,WAAWD;IACjD,IAAIG,AAAiB,MAAjBA,MAAM,MAAM,IAAUA,MAAM,IAAI,CAACC,CAAAA,IAAKnB,OAAO,KAAK,CAACmB,KACnD;IAEJ,MAAMC,UAAU,CAACD,IAAcE,KAAK,GAAG,CAAC,GAAGA,KAAK,GAAG,CAAC,GAAGF;IACvD,MAAM,CAACG,KAAKC,MAAMC,QAAQC,MAAM,GAAGP,MAAM,GAAG,CAACE;IAC7C,IAAIE,AAAQ,MAARA,OAAaC,AAAS,MAATA,QAAcC,AAAW,MAAXA,UAAgBC,AAAU,MAAVA,OAC3C;IAEJ,IAAIH,MAAME,UAAU,KAAKD,OAAOE,SAAS,GACrC;IAEJ,OAAO;QAAEH;QAAKC;QAAMC;QAAQC;IAAM;AACtC"}

package/features/assetDelivery/assetTypes/image/transformImage.d.ts

@@ -0,0 +1,59 @@
+import { type ImageFormat } from "./imageFormat.js";
+export interface TransformImageParams {
+    buffer: Buffer;
+    animated: boolean;
+    sourceContentType: string;
+    widths: number[];
+    options: {
+        width?: number;
+        format?: ImageFormat;
+        quality?: number;
+    };
+    qualityDefaults?: Record<ImageFormat, number>;
+}
+export interface TransformImageResult {
+    buffer: Buffer;
+    contentType: string;
+}
+/**
+ * Single sharp pipeline shared by the S3 and local transform strategies: optional
+ * resize (snapped to the configured width ladder) → optional format conversion +
+ * quality. Returns the resulting buffer and its content type.
+ */
+interface CropInsets {
+    top: number;
+    left: number;
+    bottom: number;
+    right: number;
+}
+/**
+ * Extract the crop region (edge insets, 0..1) from an image buffer. Returns the
+ * original buffer unchanged if the crop is empty/full or the dimensions are unknown.
+ */
+export declare const cropImageBuffer: (buffer: Buffer, crop: CropInsets) => Promise<Buffer>;
+interface NormalizedRect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/**
+ * The visible region (normalized 0–1) for the given framing. The largest rectangle
+ * of `aspectRatio` that fits inside the crop, centered on the focal point.
+ */
+export declare const getVisibleRect: (imageWidth: number, imageHeight: number, crop?: CropInsets, focal?: {
+    x: number;
+    y: number;
+}, aspectRatio?: number) => NormalizedRect;
+export interface Framing {
+    crop?: CropInsets;
+    focal?: {
+        x: number;
+        y: number;
+    };
+    aspectRatio?: number;
+}
+export declare const hasFraming: (framing: Framing) => boolean;
+export declare const extractFramedRegion: (buffer: Buffer, framing: Framing) => Promise<Buffer>;
+export declare const transformImageBuffer: (params: TransformImageParams) => Promise<TransformImageResult>;
+export {};

package/features/assetDelivery/assetTypes/image/transformImage.js

@@ -0,0 +1,146 @@
+import sharp from "sharp";
+import { WidthCollection } from "./WidthCollection.js";
+import { DEFAULT_IMAGE_QUALITY, contentTypeForFormat, formatFromContentType } from "./imageFormat.js";
+const applyOutputFormat = (pipeline, sourceContentType, options, qualityDefaults)=>{
+    const targetFormat = options.format ?? formatFromContentType(sourceContentType);
+    if (!targetFormat || !options.format && void 0 === options.quality) return {
+        pipeline,
+        contentType: sourceContentType
+    };
+    const quality = options.quality ?? qualityDefaults[targetFormat];
+    switch(targetFormat){
+        case "jpeg":
+            return {
+                pipeline: pipeline.jpeg({
+                    quality
+                }),
+                contentType: contentTypeForFormat("jpeg")
+            };
+        case "webp":
+            return {
+                pipeline: pipeline.webp({
+                    quality
+                }),
+                contentType: contentTypeForFormat("webp")
+            };
+        case "avif":
+            return {
+                pipeline: pipeline.avif({
+                    quality
+                }),
+                contentType: contentTypeForFormat("avif")
+            };
+        case "png":
+            return {
+                pipeline: pipeline.png({
+                    quality,
+                    compressionLevel: 9,
+                    adaptiveFiltering: true
+                }),
+                contentType: contentTypeForFormat("png")
+            };
+    }
+};
+const clamp01 = (n)=>Math.min(1, Math.max(0, n));
+const cropImageBuffer = async (buffer, crop)=>{
+    const image = sharp(buffer);
+    const meta = await image.metadata();
+    const w = meta.width ?? 0;
+    const h = meta.height ?? 0;
+    if (!w || !h) return buffer;
+    const left = Math.max(0, Math.min(w - 1, Math.round(clamp01(crop.left) * w)));
+    const top = Math.max(0, Math.min(h - 1, Math.round(clamp01(crop.top) * h)));
+    const width = Math.max(1, Math.min(w - left, Math.round((1 - clamp01(crop.left) - clamp01(crop.right)) * w)));
+    const height = Math.max(1, Math.min(h - top, Math.round((1 - clamp01(crop.top) - clamp01(crop.bottom)) * h)));
+    if (0 === left && 0 === top && width === w && height === h) return buffer;
+    return image.extract({
+        left,
+        top,
+        width,
+        height
+    }).toBuffer();
+};
+const cropToRect = (crop)=>{
+    const left = clamp01(crop?.left ?? 0);
+    const top = clamp01(crop?.top ?? 0);
+    return {
+        x: left,
+        y: top,
+        width: Math.max(0, 1 - left - clamp01(crop?.right ?? 0)),
+        height: Math.max(0, 1 - top - clamp01(crop?.bottom ?? 0))
+    };
+};
+const getVisibleRect = (imageWidth, imageHeight, crop, focal, aspectRatio)=>{
+    const cr = cropToRect(crop);
+    if (void 0 === aspectRatio || aspectRatio <= 0 || cr.width <= 0 || cr.height <= 0) return cr;
+    const iw = imageWidth > 0 ? imageWidth : 1;
+    const ih = imageHeight > 0 ? imageHeight : 1;
+    const cropAR = cr.width * iw / (cr.height * ih);
+    let w;
+    let h;
+    if (aspectRatio > cropAR) {
+        w = cr.width;
+        h = cr.width * iw / aspectRatio / ih;
+    } else {
+        h = cr.height;
+        w = cr.height * ih * aspectRatio / iw;
+    }
+    const fx = clamp01(focal?.x ?? 0.5);
+    const fy = clamp01(focal?.y ?? 0.5);
+    const maxX = cr.x + cr.width - w;
+    const maxY = cr.y + cr.height - h;
+    const x = Math.min(Math.max(fx - w / 2, cr.x), Math.max(cr.x, maxX));
+    const y = Math.min(Math.max(fy - h / 2, cr.y), Math.max(cr.y, maxY));
+    return {
+        x,
+        y,
+        width: w,
+        height: h
+    };
+};
+const hasFraming = (framing)=>{
+    const c = framing.crop;
+    const cropped = !!c && !(0 === c.top && 0 === c.left && 0 === c.bottom && 0 === c.right);
+    return cropped || void 0 !== framing.aspectRatio;
+};
+const extractFramedRegion = async (buffer, framing)=>{
+    if (!hasFraming(framing)) return buffer;
+    const image = sharp(buffer);
+    const meta = await image.metadata();
+    const w = meta.width ?? 0;
+    const h = meta.height ?? 0;
+    if (!w || !h) return buffer;
+    const rect = getVisibleRect(w, h, framing.crop, framing.focal, framing.aspectRatio);
+    const left = Math.max(0, Math.min(w - 1, Math.round(rect.x * w)));
+    const top = Math.max(0, Math.min(h - 1, Math.round(rect.y * h)));
+    const width = Math.max(1, Math.min(w - left, Math.round(rect.width * w)));
+    const height = Math.max(1, Math.min(h - top, Math.round(rect.height * h)));
+    if (0 === left && 0 === top && width === w && height === h) return buffer;
+    return image.extract({
+        left,
+        top,
+        width,
+        height
+    }).toBuffer();
+};
+const transformImageBuffer = async (params)=>{
+    let pipeline = sharp(params.buffer, {
+        animated: params.animated
+    }).withMetadata();
+    if (params.options.width) {
+        const width = WidthCollection.create(params.widths).getClosestOrMax(params.options.width);
+        pipeline = pipeline.resize({
+            width,
+            withoutEnlargement: true
+        });
+    }
+    const { pipeline: encoded, contentType } = applyOutputFormat(pipeline, params.sourceContentType, params.options, params.qualityDefaults ?? DEFAULT_IMAGE_QUALITY);
+    const buffer = await encoded.toBuffer();
+    return {
+        buffer,
+        contentType
+    };
+};
+export { cropImageBuffer, extractFramedRegion, getVisibleRect, hasFraming, transformImageBuffer };
+
+//# sourceMappingURL=transformImage.js.map

package/features/assetDelivery/assetTypes/image/transformImage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features/assetDelivery/assetTypes/image/transformImage.js","sources":["../../../../../src/features/assetDelivery/assetTypes/image/transformImage.ts"],"sourcesContent":["/**\n * The sharp-backed image pipeline. This module imports `sharp` (a native module),\n * so it must ONLY be imported by the transform strategies (the image Lambda) —\n * never from the barrel (`index.ts`) or from anything the GraphQL API handler\n * loads. See `imageFormat.ts` for the reasoning.\n */\nimport sharp from \"sharp\";\nimport type { Sharp } from \"sharp\";\nimport { WidthCollection } from \"./WidthCollection.js\";\nimport {\n    contentTypeForFormat,\n    DEFAULT_IMAGE_QUALITY,\n    formatFromContentType,\n    type ImageFormat\n} from \"./imageFormat.js\";\n\ninterface ApplyOutputFormatResult {\n    pipeline: Sharp;\n    contentType: string;\n}\n\n/**\n * Apply the target format + quality to a sharp pipeline. When no `format` is given,\n * re-encodes in the source format only if a `quality` was requested; otherwise the\n * pipeline is left untouched.\n */\nconst applyOutputFormat = (\n    pipeline: Sharp,\n    sourceContentType: string,\n    options: { format?: ImageFormat; quality?: number },\n    qualityDefaults: Record<ImageFormat, number>\n): ApplyOutputFormatResult => {\n    const targetFormat = options.format ?? formatFromContentType(sourceContentType);\n\n    // Nothing to change: unknown source format, or neither a conversion nor a quality.\n    if (!targetFormat || (!options.format && options.quality === undefined)) {\n        return { pipeline, contentType: sourceContentType };\n    }\n\n    const quality = options.quality ?? qualityDefaults[targetFormat];\n\n    switch (targetFormat) {\n        case \"jpeg\":\n            return {\n                pipeline: pipeline.jpeg({ quality }),\n                contentType: contentTypeForFormat(\"jpeg\")\n            };\n        case \"webp\":\n            return {\n                pipeline: pipeline.webp({ quality }),\n                contentType: contentTypeForFormat(\"webp\")\n            };\n        case \"avif\":\n            return {\n                pipeline: pipeline.avif({ quality }),\n                contentType: contentTypeForFormat(\"avif\")\n            };\n        case \"png\":\n            return {\n                pipeline: pipeline.png({ quality, compressionLevel: 9, adaptiveFiltering: true }),\n                contentType: contentTypeForFormat(\"png\")\n            };\n    }\n};\n\nexport interface TransformImageParams {\n    buffer: Buffer;\n    animated: boolean;\n    sourceContentType: string;\n    widths: number[];\n    options: { width?: number; format?: ImageFormat; quality?: number };\n    qualityDefaults?: Record<ImageFormat, number>;\n}\n\nexport interface TransformImageResult {\n    buffer: Buffer;\n    contentType: string;\n}\n\n/**\n * Single sharp pipeline shared by the S3 and local transform strategies: optional\n * resize (snapped to the configured width ladder) → optional format conversion +\n * quality. Returns the resulting buffer and its content type.\n */\ninterface CropInsets {\n    top: number;\n    left: number;\n    bottom: number;\n    right: number;\n}\n\nconst clamp01 = (n: number) => Math.min(1, Math.max(0, n));\n\n/**\n * Extract the crop region (edge insets, 0..1) from an image buffer. Returns the\n * original buffer unchanged if the crop is empty/full or the dimensions are unknown.\n */\nexport const cropImageBuffer = async (buffer: Buffer, crop: CropInsets): Promise<Buffer> => {\n    const image = sharp(buffer);\n    const meta = await image.metadata();\n    const w = meta.width ?? 0;\n    const h = meta.height ?? 0;\n    if (!w || !h) {\n        return buffer;\n    }\n\n    const left = Math.max(0, Math.min(w - 1, Math.round(clamp01(crop.left) * w)));\n    const top = Math.max(0, Math.min(h - 1, Math.round(clamp01(crop.top) * h)));\n    const width = Math.max(\n        1,\n        Math.min(w - left, Math.round((1 - clamp01(crop.left) - clamp01(crop.right)) * w))\n    );\n    const height = Math.max(\n        1,\n        Math.min(h - top, Math.round((1 - clamp01(crop.top) - clamp01(crop.bottom)) * h))\n    );\n\n    if (left === 0 && top === 0 && width === w && height === h) {\n        return buffer;\n    }\n\n    return image.extract({ left, top, width, height }).toBuffer();\n};\n\ninterface NormalizedRect {\n    x: number;\n    y: number;\n    width: number;\n    height: number;\n}\n\nconst cropToRect = (crop?: CropInsets): NormalizedRect => {\n    const left = clamp01(crop?.left ?? 0);\n    const top = clamp01(crop?.top ?? 0);\n    return {\n        x: left,\n        y: top,\n        width: Math.max(0, 1 - left - clamp01(crop?.right ?? 0)),\n        height: Math.max(0, 1 - top - clamp01(crop?.bottom ?? 0))\n    };\n};\n\n/**\n * The visible region (normalized 0–1) for the given framing. The largest rectangle\n * of `aspectRatio` that fits inside the crop, centered on the focal point.\n */\nexport const getVisibleRect = (\n    imageWidth: number,\n    imageHeight: number,\n    crop?: CropInsets,\n    focal?: { x: number; y: number },\n    aspectRatio?: number\n): NormalizedRect => {\n    const cr = cropToRect(crop);\n    if (aspectRatio === undefined || aspectRatio <= 0 || cr.width <= 0 || cr.height <= 0) {\n        return cr;\n    }\n    const iw = imageWidth > 0 ? imageWidth : 1;\n    const ih = imageHeight > 0 ? imageHeight : 1;\n    const cropAR = (cr.width * iw) / (cr.height * ih);\n\n    let w: number;\n    let h: number;\n    if (aspectRatio > cropAR) {\n        w = cr.width;\n        h = (cr.width * iw) / aspectRatio / ih;\n    } else {\n        h = cr.height;\n        w = (cr.height * ih * aspectRatio) / iw;\n    }\n\n    const fx = clamp01(focal?.x ?? 0.5);\n    const fy = clamp01(focal?.y ?? 0.5);\n    const maxX = cr.x + cr.width - w;\n    const maxY = cr.y + cr.height - h;\n    const x = Math.min(Math.max(fx - w / 2, cr.x), Math.max(cr.x, maxX));\n    const y = Math.min(Math.max(fy - h / 2, cr.y), Math.max(cr.y, maxY));\n    return { x, y, width: w, height: h };\n};\n\nexport interface Framing {\n    crop?: CropInsets;\n    focal?: { x: number; y: number };\n    aspectRatio?: number;\n}\n\nexport const hasFraming = (framing: Framing): boolean => {\n    const c = framing.crop;\n    const cropped = !!c && !(c.top === 0 && c.left === 0 && c.bottom === 0 && c.right === 0);\n    return cropped || framing.aspectRatio !== undefined;\n};\n\nexport const extractFramedRegion = async (buffer: Buffer, framing: Framing): Promise<Buffer> => {\n    if (!hasFraming(framing)) {\n        return buffer;\n    }\n    const image = sharp(buffer);\n    const meta = await image.metadata();\n    const w = meta.width ?? 0;\n    const h = meta.height ?? 0;\n    if (!w || !h) {\n        return buffer;\n    }\n\n    const rect = getVisibleRect(w, h, framing.crop, framing.focal, framing.aspectRatio);\n    const left = Math.max(0, Math.min(w - 1, Math.round(rect.x * w)));\n    const top = Math.max(0, Math.min(h - 1, Math.round(rect.y * h)));\n    const width = Math.max(1, Math.min(w - left, Math.round(rect.width * w)));\n    const height = Math.max(1, Math.min(h - top, Math.round(rect.height * h)));\n\n    if (left === 0 && top === 0 && width === w && height === h) {\n        return buffer;\n    }\n    return image.extract({ left, top, width, height }).toBuffer();\n};\n\nexport const transformImageBuffer = async (\n    params: TransformImageParams\n): Promise<TransformImageResult> => {\n    let pipeline = sharp(params.buffer, { animated: params.animated }).withMetadata();\n\n    if (params.options.width) {\n        const width = WidthCollection.create(params.widths).getClosestOrMax(params.options.width);\n        pipeline = pipeline.resize({ width, withoutEnlargement: true });\n    }\n\n    const { pipeline: encoded, contentType } = applyOutputFormat(\n        pipeline,\n        params.sourceContentType,\n        params.options,\n        params.qualityDefaults ?? DEFAULT_IMAGE_QUALITY\n    );\n\n    const buffer = await encoded.toBuffer();\n\n    return { buffer, contentType };\n};\n"],"names":["applyOutputFormat","pipeline","sourceContentType","options","qualityDefaults","targetFormat","formatFromContentType","undefined","quality","contentTypeForFormat","clamp01","n","Math","cropImageBuffer","buffer","crop","image","sharp","meta","w","h","left","top","width","height","cropToRect","getVisibleRect","imageWidth","imageHeight","focal","aspectRatio","cr","iw","ih","cropAR","fx","fy","maxX","maxY","x","y","hasFraming","framing","c","cropped","extractFramedRegion","rect","transformImageBuffer","params","WidthCollection","encoded","contentType","DEFAULT_IMAGE_QUALITY"],"mappings":"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"}

package/features/assetDelivery/assetTypes/image/utils.d.ts

@@ -0,0 +1,26 @@
+import type { Framing } from "./imageTypes.js";
+declare const SUPPORTED_TRANSFORMABLE_IMAGES: string[];
+declare const getOptimizedImageKeyPrefix: (key: string, cropSignature?: string) => string;
+declare const getOptimizedTransformedImageKeyPrefix: (key: string, transformationsHash: string, cropSignature?: string) => string;
+interface Crop {
+    top: number;
+    left: number;
+    bottom: number;
+    right: number;
+}
+/** Short, stable signature of a crop; `undefined` for no/empty crop (so keys are unchanged). */
+declare const getCropSignature: (crop?: Crop) => string | undefined;
+interface GetImageKeyParams {
+    key: string;
+    transformations?: any;
+    cropSignature?: string;
+}
+declare const getImageKey: ({ key, transformations, cropSignature }: GetImageKeyParams) => string;
+/**
+ * Signature for a full framing (crop + focal + aspect ratio) used to namespace
+ * cached derivatives. `undefined` when the framing is a no-op. A crop-only framing
+ * intentionally hashes to the same value as `getCropSignature`, so existing
+ * asset-level-crop derivatives keep their cache keys (backward compatible).
+ */
+declare const getFramingSignature: (framing: Framing) => string | undefined;
+export { SUPPORTED_TRANSFORMABLE_IMAGES, getImageKey, getCropSignature, getFramingSignature, getOptimizedImageKeyPrefix, getOptimizedTransformedImageKeyPrefix };

package/features/assetDelivery/assetTypes/image/utils.js

@@ -0,0 +1,47 @@
+import object_hash from "object-hash";
+import node_path from "node:path";
+const SUPPORTED_TRANSFORMABLE_IMAGES = [
+    "jpg",
+    "jpeg",
+    "png",
+    "webp"
+];
+const parseKey = (key)=>{
+    const filename = node_path.basename(key);
+    const dirname = node_path.dirname(key);
+    return {
+        filename,
+        dirname
+    };
+};
+const cropSegment = (cropSignature)=>cropSignature ? `${cropSignature}/` : "";
+const getOptimizedImageKeyPrefix = (key, cropSignature)=>{
+    const { filename, dirname } = parseKey(key);
+    return `${dirname}/optimized/${cropSegment(cropSignature)}${filename}`;
+};
+const getOptimizedTransformedImageKeyPrefix = (key, transformationsHash, cropSignature)=>{
+    const { filename, dirname } = parseKey(key);
+    return `${dirname}/optimized/${cropSegment(cropSignature)}${transformationsHash}-${filename}`;
+};
+const getCropSignature = (crop)=>{
+    if (!crop || 0 === crop.top && 0 === crop.left && 0 === crop.bottom && 0 === crop.right) return;
+    return object_hash(crop).slice(0, 16);
+};
+const getImageKey = ({ key, transformations, cropSignature })=>{
+    if (!transformations) return getOptimizedImageKeyPrefix(key, cropSignature);
+    return getOptimizedTransformedImageKeyPrefix(key, object_hash(transformations), cropSignature);
+};
+const getFramingSignature = (framing)=>{
+    const { crop, focal, aspectRatio } = framing;
+    const cropped = !!crop && !(0 === crop.top && 0 === crop.left && 0 === crop.bottom && 0 === crop.right);
+    if (!cropped && void 0 === aspectRatio) return;
+    if (cropped && void 0 === focal && void 0 === aspectRatio) return object_hash(crop).slice(0, 16);
+    return object_hash({
+        crop: cropped ? crop : void 0,
+        focal,
+        aspectRatio
+    }).slice(0, 16);
+};
+export { SUPPORTED_TRANSFORMABLE_IMAGES, getCropSignature, getFramingSignature, getImageKey, getOptimizedImageKeyPrefix, getOptimizedTransformedImageKeyPrefix };
+
+//# sourceMappingURL=utils.js.map

package/features/assetDelivery/assetTypes/image/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features/assetDelivery/assetTypes/image/utils.js","sources":["../../../../../src/features/assetDelivery/assetTypes/image/utils.ts"],"sourcesContent":["import objectHash from \"object-hash\";\nimport path from \"node:path\";\nimport type { Framing } from \"./imageTypes.js\";\n\nconst SUPPORTED_TRANSFORMABLE_IMAGES = [\"jpg\", \"jpeg\", \"png\", \"webp\"];\n\nconst parseKey = (key: string) => {\n    const filename = path.basename(key);\n    const dirname = path.dirname(key);\n\n    return { filename, dirname };\n};\n\n// An optional per-file crop signature segment. Keeps un-cropped keys unchanged\n// (backward compatible) while giving cropped files their own cache namespace, so\n// changing a file's crop invalidates its derivatives.\nconst cropSegment = (cropSignature?: string): string => {\n    return cropSignature ? `${cropSignature}/` : \"\";\n};\n\nconst getOptimizedImageKeyPrefix = (key: string, cropSignature?: string): string => {\n    const { filename, dirname } = parseKey(key);\n\n    return `${dirname}/optimized/${cropSegment(cropSignature)}${filename}`;\n};\n\nconst getOptimizedTransformedImageKeyPrefix = (\n    key: string,\n    transformationsHash: string,\n    cropSignature?: string\n): string => {\n    const { filename, dirname } = parseKey(key);\n\n    return `${dirname}/optimized/${cropSegment(cropSignature)}${transformationsHash}-${filename}`;\n};\n\ninterface Crop {\n    top: number;\n    left: number;\n    bottom: number;\n    right: number;\n}\n\n/** Short, stable signature of a crop; `undefined` for no/empty crop (so keys are unchanged). */\nconst getCropSignature = (crop?: Crop): string | undefined => {\n    if (!crop || (crop.top === 0 && crop.left === 0 && crop.bottom === 0 && crop.right === 0)) {\n        return undefined;\n    }\n    return objectHash(crop).slice(0, 16);\n};\n\ninterface GetImageKeyParams {\n    key: string;\n    transformations?: any;\n    cropSignature?: string;\n}\n\nconst getImageKey = ({ key, transformations, cropSignature }: GetImageKeyParams): string => {\n    if (!transformations) {\n        return getOptimizedImageKeyPrefix(key, cropSignature);\n    }\n\n    return getOptimizedTransformedImageKeyPrefix(key, objectHash(transformations), cropSignature);\n};\n\n/**\n * Signature for a full framing (crop + focal + aspect ratio) used to namespace\n * cached derivatives. `undefined` when the framing is a no-op. A crop-only framing\n * intentionally hashes to the same value as `getCropSignature`, so existing\n * asset-level-crop derivatives keep their cache keys (backward compatible).\n */\nconst getFramingSignature = (framing: Framing): string | undefined => {\n    const { crop, focal, aspectRatio } = framing;\n    const cropped =\n        !!crop && !(crop.top === 0 && crop.left === 0 && crop.bottom === 0 && crop.right === 0);\n\n    if (!cropped && aspectRatio === undefined) {\n        return undefined;\n    }\n    if (cropped && focal === undefined && aspectRatio === undefined) {\n        return objectHash(crop).slice(0, 16);\n    }\n    return objectHash({ crop: cropped ? crop : undefined, focal, aspectRatio }).slice(0, 16);\n};\n\nexport {\n    SUPPORTED_TRANSFORMABLE_IMAGES,\n    getImageKey,\n    getCropSignature,\n    getFramingSignature,\n    getOptimizedImageKeyPrefix,\n    getOptimizedTransformedImageKeyPrefix\n};\n"],"names":["SUPPORTED_TRANSFORMABLE_IMAGES","parseKey","key","filename","path","dirname","cropSegment","cropSignature","getOptimizedImageKeyPrefix","getOptimizedTransformedImageKeyPrefix","transformationsHash","getCropSignature","crop","objectHash","getImageKey","transformations","getFramingSignature","framing","focal","aspectRatio","cropped","undefined"],"mappings":";;AAIA,MAAMA,iCAAiC;IAAC;IAAO;IAAQ;IAAO;CAAO;AAErE,MAAMC,WAAW,CAACC;IACd,MAAMC,WAAWC,UAAAA,QAAa,CAACF;IAC/B,MAAMG,UAAUD,UAAAA,OAAY,CAACF;IAE7B,OAAO;QAAEC;QAAUE;IAAQ;AAC/B;AAKA,MAAMC,cAAc,CAACC,gBACVA,gBAAgB,GAAGA,cAAc,CAAC,CAAC,GAAG;AAGjD,MAAMC,6BAA6B,CAACN,KAAaK;IAC7C,MAAM,EAAEJ,QAAQ,EAAEE,OAAO,EAAE,GAAGJ,SAASC;IAEvC,OAAO,GAAGG,QAAQ,WAAW,EAAEC,YAAYC,iBAAiBJ,UAAU;AAC1E;AAEA,MAAMM,wCAAwC,CAC1CP,KACAQ,qBACAH;IAEA,MAAM,EAAEJ,QAAQ,EAAEE,OAAO,EAAE,GAAGJ,SAASC;IAEvC,OAAO,GAAGG,QAAQ,WAAW,EAAEC,YAAYC,iBAAiBG,oBAAoB,CAAC,EAAEP,UAAU;AACjG;AAUA,MAAMQ,mBAAmB,CAACC;IACtB,IAAI,CAACA,QAASA,AAAa,MAAbA,KAAK,GAAG,IAAUA,AAAc,MAAdA,KAAK,IAAI,IAAUA,AAAgB,MAAhBA,KAAK,MAAM,IAAUA,AAAe,MAAfA,KAAK,KAAK,EAC9E;IAEJ,OAAOC,YAAWD,MAAM,KAAK,CAAC,GAAG;AACrC;AAQA,MAAME,cAAc,CAAC,EAAEZ,GAAG,EAAEa,eAAe,EAAER,aAAa,EAAqB;IAC3E,IAAI,CAACQ,iBACD,OAAOP,2BAA2BN,KAAKK;IAG3C,OAAOE,sCAAsCP,KAAKW,YAAWE,kBAAkBR;AACnF;AAQA,MAAMS,sBAAsB,CAACC;IACzB,MAAM,EAAEL,IAAI,EAAEM,KAAK,EAAEC,WAAW,EAAE,GAAGF;IACrC,MAAMG,UACF,CAAC,CAACR,QAAQ,CAAEA,CAAAA,AAAa,MAAbA,KAAK,GAAG,IAAUA,AAAc,MAAdA,KAAK,IAAI,IAAUA,AAAgB,MAAhBA,KAAK,MAAM,IAAUA,AAAe,MAAfA,KAAK,KAAK,AAAK;IAEzF,IAAI,CAACQ,WAAWD,AAAgBE,WAAhBF,aACZ;IAEJ,IAAIC,WAAWF,AAAUG,WAAVH,SAAuBC,AAAgBE,WAAhBF,aAClC,OAAON,YAAWD,MAAM,KAAK,CAAC,GAAG;IAErC,OAAOC,YAAW;QAAE,MAAMO,UAAUR,OAAOS;QAAWH;QAAOC;IAAY,GAAG,KAAK,CAAC,GAAG;AACzF"}

package/features/assetDelivery/feature.d.ts

@@ -0,0 +1,4 @@
+export declare const AssetDeliveryFeature: {
+    name: string;
+    register(container: import("@webiny/di").Container): void;
+};

package/features/assetDelivery/feature.js

@@ -0,0 +1,38 @@
+import { createFeature } from "@webiny/feature/api";
+import { WcpContext } from "@webiny/api-core/features/wcp/WcpContext/index.js";
+import { AssetFactory } from "./Asset/Asset.js";
+import { AssetRequestFactory } from "./AssetRequest/AssetRequest.js";
+import { FilesAssetRequestResolver } from "./FilesAssetRequestResolver.js";
+import { NullAssetResolver } from "./NullAssetResolver.js";
+import { NullAssetOutputStrategy } from "./NullAssetOutputStrategy.js";
+import { StreamAssetReply } from "./StreamAssetReply/StreamAssetReply.js";
+import { ObjectKey } from "./ObjectKey/ObjectKey.js";
+import { AssetProcessor } from "./abstractions/AssetProcessor.js";
+import { TransformationAssetProcessor } from "./transformation/TransformationAssetProcessor.js";
+import { ImageAssetType } from "./assetTypes/image/ImageAssetType.js";
+import { PrivateFileAssetRequestResolver } from "./privateFiles/PrivateFileAssetRequestResolver.js";
+import { PrivateAuthenticatedAuthorizer } from "./privateFiles/PrivateAuthenticatedAuthorizer.js";
+import { PrivateFilesAssetProcessor } from "./privateFiles/PrivateFilesAssetProcessor.js";
+const AssetDeliveryFeature = createFeature({
+    name: "AssetDelivery",
+    register (container) {
+        container.register(AssetFactory).inSingletonScope();
+        container.register(AssetRequestFactory).inSingletonScope();
+        container.register(FilesAssetRequestResolver).inSingletonScope();
+        container.register(NullAssetResolver).inSingletonScope();
+        container.register(NullAssetOutputStrategy).inSingletonScope();
+        container.register(StreamAssetReply).inSingletonScope();
+        container.register(ObjectKey).inSingletonScope();
+        container.register(ImageAssetType);
+        container.registerInstance(AssetProcessor, new TransformationAssetProcessor(container));
+        container.registerDecorator(PrivateFileAssetRequestResolver);
+        const wcp = container.resolve(WcpContext);
+        if (wcp.canUsePrivateFiles()) {
+            container.register(PrivateAuthenticatedAuthorizer);
+            container.registerDecorator(PrivateFilesAssetProcessor);
+        }
+    }
+});
+export { AssetDeliveryFeature };
+
+//# sourceMappingURL=feature.js.map