@webiny/api-file-manager 0.0.0-unstable.e6f0dc8ca7 → 0.0.0-unstable.eb81deee7e

package/features/assetDelivery/abstractions.d.ts

@@ -0,0 +1,65 @@
+import type { Request as IRequest } from "@webiny/handler/types.js";
+import type { AssetRequest as IAssetRequest } from "../../delivery/AssetDelivery/AssetRequest.js";
+import type { Asset as IAsset } from "../../delivery/AssetDelivery/Asset.js";
+import type { AssetReply as IAssetReply } from "../../delivery/AssetDelivery/abstractions/AssetReply.js";
+import type { File as IFile } from "../../domain/file/types.js";
+export interface IAssetRequestResolver {
+    resolve(request: IRequest): Promise<IAssetRequest | undefined>;
+}
+export interface IAssetResolver {
+    resolve(request: IAssetRequest): Promise<IAsset | undefined>;
+}
+export interface IAssetProcessor {
+    process(assetRequest: IAssetRequest, asset: IAsset): Promise<IAsset>;
+}
+export interface IAssetOutputStrategy {
+    output(asset: IAsset): Promise<IAssetReply>;
+}
+export interface IAssetTransformationStrategy {
+    transform(assetRequest: IAssetRequest, asset: IAsset): Promise<IAsset>;
+}
+export interface IAssetContentsReader {
+    read(asset: IAsset): Promise<Buffer>;
+}
+export interface IAssetAuthorizer {
+    authorize(file: IFile): Promise<void>;
+}
+export declare const AssetRequestResolver: import("@webiny/di").Abstraction<IAssetRequestResolver>;
+export declare const AssetResolver: import("@webiny/di").Abstraction<IAssetResolver>;
+export declare const AssetProcessor: import("@webiny/di").Abstraction<IAssetProcessor>;
+export declare const AssetOutputStrategy: import("@webiny/di").Abstraction<IAssetOutputStrategy>;
+export declare const AssetTransformationStrategy: import("@webiny/di").Abstraction<IAssetTransformationStrategy>;
+export declare const AssetContentsReader: import("@webiny/di").Abstraction<IAssetContentsReader>;
+export declare const AssetAuthorizer: import("@webiny/di").Abstraction<IAssetAuthorizer>;
+export declare namespace AssetRequestResolver {
+    type Interface = IAssetRequestResolver;
+    type AssetRequest = IAssetRequest;
+    type Request = IRequest;
+}
+export declare namespace AssetResolver {
+    type Interface = IAssetResolver;
+    type Asset = IAsset;
+    type Request = IAssetRequest;
+}
+export declare namespace AssetProcessor {
+    type Interface = IAssetProcessor;
+    type AssetRequest = IAssetRequest;
+    type Asset = IAsset;
+}
+export declare namespace AssetOutputStrategy {
+    type Interface = IAssetOutputStrategy;
+    type Asset = IAsset;
+    type AssetReply = IAssetReply;
+}
+export declare namespace AssetTransformationStrategy {
+    type Interface = IAssetTransformationStrategy;
+    type AssetRequest = IAssetRequest;
+    type Asset = IAsset;
+}
+export declare namespace AssetContentsReader {
+    type Interface = IAssetContentsReader;
+    type Asset = IAsset;
+}
+export declare namespace AssetAuthorizer {
+    type Interface = IAssetAuthorizer;
+}

package/features/assetDelivery/abstractions.js

@@ -0,0 +1,11 @@
+import { createAbstraction } from "@webiny/feature/api";
+const AssetRequestResolver = createAbstraction("AssetDelivery/AssetRequestResolver");
+const AssetResolver = createAbstraction("AssetDelivery/AssetResolver");
+const AssetProcessor = createAbstraction("AssetDelivery/AssetProcessor");
+const AssetOutputStrategy = createAbstraction("AssetDelivery/AssetOutputStrategy");
+const AssetTransformationStrategy = createAbstraction("AssetDelivery/AssetTransformationStrategy");
+const AssetContentsReader = createAbstraction("AssetDelivery/AssetContentsReader");
+const AssetAuthorizer = createAbstraction("AssetDelivery/AssetAuthorizer");
+export { AssetAuthorizer, AssetContentsReader, AssetOutputStrategy, AssetProcessor, AssetRequestResolver, AssetResolver, AssetTransformationStrategy };
+
+//# sourceMappingURL=abstractions.js.map

package/features/assetDelivery/abstractions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features/assetDelivery/abstractions.js","sources":["../../../src/features/assetDelivery/abstractions.ts"],"sourcesContent":["import { createAbstraction } from \"@webiny/feature/api\";\nimport type { Request as IRequest } from \"@webiny/handler/types.js\";\nimport type { AssetRequest as IAssetRequest } from \"~/delivery/AssetDelivery/AssetRequest.js\";\nimport type { Asset as IAsset } from \"~/delivery/AssetDelivery/Asset.js\";\nimport type { AssetReply as IAssetReply } from \"~/delivery/AssetDelivery/abstractions/AssetReply.js\";\nimport type { File as IFile } from \"~/domain/file/types.js\";\n\nexport interface IAssetRequestResolver {\n    resolve(request: IRequest): Promise<IAssetRequest | undefined>;\n}\n\nexport interface IAssetResolver {\n    resolve(request: IAssetRequest): Promise<IAsset | undefined>;\n}\n\nexport interface IAssetProcessor {\n    process(assetRequest: IAssetRequest, asset: IAsset): Promise<IAsset>;\n}\n\nexport interface IAssetOutputStrategy {\n    output(asset: IAsset): Promise<IAssetReply>;\n}\n\nexport interface IAssetTransformationStrategy {\n    transform(assetRequest: IAssetRequest, asset: IAsset): Promise<IAsset>;\n}\n\nexport interface IAssetContentsReader {\n    read(asset: IAsset): Promise<Buffer>;\n}\n\nexport interface IAssetAuthorizer {\n    authorize(file: IFile): Promise<void>;\n}\n\nexport const AssetRequestResolver = createAbstraction<IAssetRequestResolver>(\n    \"AssetDelivery/AssetRequestResolver\"\n);\n\nexport const AssetResolver = createAbstraction<IAssetResolver>(\"AssetDelivery/AssetResolver\");\n\nexport const AssetProcessor = createAbstraction<IAssetProcessor>(\"AssetDelivery/AssetProcessor\");\n\nexport const AssetOutputStrategy = createAbstraction<IAssetOutputStrategy>(\n    \"AssetDelivery/AssetOutputStrategy\"\n);\n\nexport const AssetTransformationStrategy = createAbstraction<IAssetTransformationStrategy>(\n    \"AssetDelivery/AssetTransformationStrategy\"\n);\n\nexport const AssetContentsReader = createAbstraction<IAssetContentsReader>(\n    \"AssetDelivery/AssetContentsReader\"\n);\n\nexport const AssetAuthorizer = createAbstraction<IAssetAuthorizer>(\"AssetDelivery/AssetAuthorizer\");\n\nexport namespace AssetRequestResolver {\n    export type Interface = IAssetRequestResolver;\n    export type AssetRequest = IAssetRequest;\n    export type Request = IRequest;\n}\n\nexport namespace AssetResolver {\n    export type Interface = IAssetResolver;\n    export type Asset = IAsset;\n    export type Request = IAssetRequest;\n}\n\nexport namespace AssetProcessor {\n    export type Interface = IAssetProcessor;\n    export type AssetRequest = IAssetRequest;\n    export type Asset = IAsset;\n}\n\nexport namespace AssetOutputStrategy {\n    export type Interface = IAssetOutputStrategy;\n    export type Asset = IAsset;\n    export type AssetReply = IAssetReply;\n}\n\nexport namespace AssetTransformationStrategy {\n    export type Interface = IAssetTransformationStrategy;\n    export type AssetRequest = IAssetRequest;\n    export type Asset = IAsset;\n}\n\nexport namespace AssetContentsReader {\n    export type Interface = IAssetContentsReader;\n    export type Asset = IAsset;\n}\n\nexport namespace AssetAuthorizer {\n    export type Interface = IAssetAuthorizer;\n}\n"],"names":["AssetRequestResolver","createAbstraction","AssetResolver","AssetProcessor","AssetOutputStrategy","AssetTransformationStrategy","AssetContentsReader","AssetAuthorizer"],"mappings":";AAmCO,MAAMA,uBAAuBC,kBAChC;AAGG,MAAMC,gBAAgBD,kBAAkC;AAExD,MAAME,iBAAiBF,kBAAmC;AAE1D,MAAMG,sBAAsBH,kBAC/B;AAGG,MAAMI,8BAA8BJ,kBACvC;AAGG,MAAMK,sBAAsBL,kBAC/B;AAGG,MAAMM,kBAAkBN,kBAAoC"}

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

@@ -0,0 +1,12 @@
+import type { Asset } from "../../../../delivery/index.js";
+import type { Framing } from "./imageTypes.js";
+export declare class AssetKeyGenerator {
+    private readonly utils;
+    private readonly asset;
+    private readonly framing?;
+    static create(asset: Asset, framing?: Framing): AssetKeyGenerator;
+    private constructor();
+    private signature;
+    getOptimizedImageKey(): string;
+    getTransformedImageKey(transformations: Record<string, any>): string;
+}

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

@@ -0,0 +1,30 @@
+import * as __rspack_external__utils_js_a9c81ddd from "./utils.js";
+class AssetKeyGenerator {
+    static create(asset, framing) {
+        return new AssetKeyGenerator(asset, framing);
+    }
+    constructor(asset, framing){
+        this.asset = asset;
+        this.utils = __rspack_external__utils_js_a9c81ddd;
+        this.framing = framing;
+    }
+    signature() {
+        if (this.framing) return this.utils.getFramingSignature(this.framing);
+    }
+    getOptimizedImageKey() {
+        return this.utils.getImageKey({
+            key: this.asset.getKey(),
+            cropSignature: this.signature()
+        });
+    }
+    getTransformedImageKey(transformations) {
+        return this.utils.getImageKey({
+            key: this.asset.getKey(),
+            transformations,
+            cropSignature: this.signature()
+        });
+    }
+}
+export { AssetKeyGenerator };
+
+//# sourceMappingURL=AssetKeyGenerator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"features/assetDelivery/assetTypes/image/AssetKeyGenerator.js","sources":["../../../../../src/features/assetDelivery/assetTypes/image/AssetKeyGenerator.ts"],"sourcesContent":["import type { Asset } from \"../../../../delivery/index.js\";\nimport type { Framing } from \"./imageTypes.js\";\nimport * as newUtils from \"./utils.js\";\n\nexport class AssetKeyGenerator {\n    private readonly utils: typeof newUtils;\n    private readonly asset: Asset;\n    private readonly framing?: Framing;\n\n    public static create(asset: Asset, framing?: Framing) {\n        return new AssetKeyGenerator(asset, framing);\n    }\n\n    private constructor(asset: Asset, framing?: Framing) {\n        this.asset = asset;\n        this.utils = newUtils;\n        this.framing = framing;\n    }\n\n    private signature() {\n        if (this.framing) {\n            return this.utils.getFramingSignature(this.framing);\n        }\n        return undefined;\n    }\n\n    public getOptimizedImageKey() {\n        return this.utils.getImageKey({\n            key: this.asset.getKey(),\n            cropSignature: this.signature()\n        });\n    }\n\n    public getTransformedImageKey(transformations: Record<string, any>) {\n        return this.utils.getImageKey({\n            key: this.asset.getKey(),\n            transformations,\n            cropSignature: this.signature()\n        });\n    }\n}\n"],"names":["AssetKeyGenerator","asset","framing","newUtils","transformations"],"mappings":";AAIO,MAAMA;IAKT,OAAc,OAAOC,KAAY,EAAEC,OAAiB,EAAE;QAClD,OAAO,IAAIF,kBAAkBC,OAAOC;IACxC;IAEA,YAAoBD,KAAY,EAAEC,OAAiB,CAAE;QACjD,IAAI,CAAC,KAAK,GAAGD;QACb,IAAI,CAAC,KAAK,GAAGE;QACb,IAAI,CAAC,OAAO,GAAGD;IACnB;IAEQ,YAAY;QAChB,IAAI,IAAI,CAAC,OAAO,EACZ,OAAO,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,IAAI,CAAC,OAAO;IAG1D;IAEO,uBAAuB;QAC1B,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC;YAC1B,KAAK,IAAI,CAAC,KAAK,CAAC,MAAM;YACtB,eAAe,IAAI,CAAC,SAAS;QACjC;IACJ;IAEO,uBAAuBE,eAAoC,EAAE;QAChE,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC;YAC1B,KAAK,IAAI,CAAC,KAAK,CAAC,MAAM;YACtBA;YACA,eAAe,IAAI,CAAC,SAAS;QACjC;IACJ;AACJ"}

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

@@ -0,0 +1,9 @@
+import { AssetType } from "../../abstractions/AssetType.js";
+declare class ImageAssetTypeImpl implements AssetType.Interface {
+    canHandle(asset: AssetType.Asset): boolean;
+    getHandlerAbstraction(): import("@webiny/di").Abstraction<import("../../abstractions/AssetType.js").IAssetTypeHandler>;
+}
+export declare const ImageAssetType: typeof ImageAssetTypeImpl & {
+    __abstraction: import("@webiny/di").Abstraction<import("../../abstractions/AssetType.js").IAssetType>;
+};
+export {};

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

@@ -0,0 +1,18 @@
+import { AssetType } from "../../abstractions/AssetType.js";
+import { SUPPORTED_TRANSFORMABLE_IMAGES } from "./utils.js";
+import { ImageAssetTypeHandler } from "./ImageAssetTypeHandler.js";
+class ImageAssetTypeImpl {
+    canHandle(asset) {
+        return SUPPORTED_TRANSFORMABLE_IMAGES.includes(asset.getExtension());
+    }
+    getHandlerAbstraction() {
+        return ImageAssetTypeHandler;
+    }
+}
+const ImageAssetType = AssetType.createImplementation({
+    implementation: ImageAssetTypeImpl,
+    dependencies: []
+});
+export { ImageAssetType };
+
+//# sourceMappingURL=ImageAssetType.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"features/assetDelivery/assetTypes/image/ImageAssetType.js","sources":["../../../../../src/features/assetDelivery/assetTypes/image/ImageAssetType.ts"],"sourcesContent":["import { AssetType } from \"../../abstractions/AssetType.js\";\nimport { SUPPORTED_TRANSFORMABLE_IMAGES } from \"./utils.js\";\nimport { ImageAssetTypeHandler } from \"./ImageAssetTypeHandler.js\";\n\nclass ImageAssetTypeImpl implements AssetType.Interface {\n    canHandle(asset: AssetType.Asset): boolean {\n        return SUPPORTED_TRANSFORMABLE_IMAGES.includes(asset.getExtension());\n    }\n\n    getHandlerAbstraction() {\n        return ImageAssetTypeHandler;\n    }\n}\n\nexport const ImageAssetType = AssetType.createImplementation({\n    implementation: ImageAssetTypeImpl,\n    dependencies: []\n});\n"],"names":["ImageAssetTypeImpl","asset","SUPPORTED_TRANSFORMABLE_IMAGES","ImageAssetTypeHandler","ImageAssetType","AssetType"],"mappings":";;;AAIA,MAAMA;IACF,UAAUC,KAAsB,EAAW;QACvC,OAAOC,+BAA+B,QAAQ,CAACD,MAAM,YAAY;IACrE;IAEA,wBAAwB;QACpB,OAAOE;IACX;AACJ;AAEO,MAAMC,iBAAiBC,UAAU,oBAAoB,CAAC;IACzD,gBAAgBL;IAChB,cAAc,EAAE;AACpB"}

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

@@ -0,0 +1,5 @@
+import type { IAssetTypeHandler } from "../../abstractions/AssetType.js";
+export declare const ImageAssetTypeHandler: import("@webiny/di").Abstraction<IAssetTypeHandler>;
+export declare namespace ImageAssetTypeHandler {
+    type Interface = IAssetTypeHandler;
+}

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

@@ -0,0 +1,5 @@
+import { createAbstraction } from "@webiny/feature/api";
+const ImageAssetTypeHandler = createAbstraction("AssetDelivery/ImageAssetTypeHandler");
+export { ImageAssetTypeHandler };
+
+//# sourceMappingURL=ImageAssetTypeHandler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"features/assetDelivery/assetTypes/image/ImageAssetTypeHandler.js","sources":["../../../../../src/features/assetDelivery/assetTypes/image/ImageAssetTypeHandler.ts"],"sourcesContent":["import { createAbstraction } from \"@webiny/feature/api\";\nimport type { IAssetTypeHandler } from \"../../abstractions/AssetType.js\";\n\nexport const ImageAssetTypeHandler = createAbstraction<IAssetTypeHandler>(\n    \"AssetDelivery/ImageAssetTypeHandler\"\n);\n\nexport namespace ImageAssetTypeHandler {\n    export type Interface = IAssetTypeHandler;\n}\n"],"names":["ImageAssetTypeHandler","createAbstraction"],"mappings":";AAGO,MAAMA,wBAAwBC,kBACjC"}

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

@@ -0,0 +1,18 @@
+import type { TransformImageParams, TransformImageResult } from "./transformImage.js";
+import type { Framing } from "./imageTypes.js";
+export declare class SharpTransformer {
+    private module?;
+    private sharp?;
+    private load;
+    private getSharp;
+    transformBuffer(params: TransformImageParams): Promise<TransformImageResult>;
+    extractFramedRegion(buffer: Buffer, framing: Framing): Promise<Buffer>;
+    cropBuffer(buffer: Buffer, crop: {
+        top: number;
+        left: number;
+        bottom: number;
+        right: number;
+    }): Promise<Buffer>;
+    optimizePng(buffer: Buffer): Promise<import("sharp").Sharp>;
+    optimizeJpeg(buffer: Buffer): Promise<import("sharp").Sharp>;
+}

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

@@ -0,0 +1,47 @@
+class SharpTransformer {
+    async load() {
+        if (!this.module) this.module = await import("./transformImage.js");
+        return this.module;
+    }
+    async getSharp() {
+        if (!this.sharp) this.sharp = (await import("sharp")).default;
+        return this.sharp;
+    }
+    async transformBuffer(params) {
+        const m = await this.load();
+        return m.transformImageBuffer(params);
+    }
+    async extractFramedRegion(buffer, framing) {
+        const m = await this.load();
+        return m.extractFramedRegion(buffer, framing);
+    }
+    async cropBuffer(buffer, crop) {
+        const m = await this.load();
+        return m.cropImageBuffer(buffer, crop);
+    }
+    async optimizePng(buffer) {
+        const s = await this.getSharp();
+        return s(buffer).resize({
+            width: 2560,
+            withoutEnlargement: true,
+            fit: "inside"
+        }).png({
+            compressionLevel: 9,
+            adaptiveFiltering: true,
+            force: true
+        }).withMetadata();
+    }
+    async optimizeJpeg(buffer) {
+        const s = await this.getSharp();
+        return s(buffer).resize({
+            width: 2560,
+            withoutEnlargement: true,
+            fit: "inside"
+        }).withMetadata().toFormat("jpeg", {
+            quality: 90
+        });
+    }
+}
+export { SharpTransformer };
+
+//# sourceMappingURL=SharpTransformer.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"features/assetDelivery/assetTypes/image/SharpTransformer.js","sources":["../../../../../src/features/assetDelivery/assetTypes/image/SharpTransformer.ts"],"sourcesContent":["import type { TransformImageParams, TransformImageResult } from \"./transformImage.js\";\nimport type { Framing } from \"./imageTypes.js\";\n\nexport class SharpTransformer {\n    private module?: typeof import(\"./transformImage.js\");\n    private sharp?: typeof import(\"sharp\").default;\n\n    private async load() {\n        if (!this.module) {\n            this.module = await import(\"./transformImage.js\");\n        }\n        return this.module;\n    }\n\n    private async getSharp() {\n        if (!this.sharp) {\n            this.sharp = (await import(\"sharp\")).default;\n        }\n        return this.sharp;\n    }\n\n    async transformBuffer(params: TransformImageParams): Promise<TransformImageResult> {\n        const m = await this.load();\n        return m.transformImageBuffer(params);\n    }\n\n    async extractFramedRegion(buffer: Buffer, framing: Framing): Promise<Buffer> {\n        const m = await this.load();\n        return m.extractFramedRegion(buffer, framing);\n    }\n\n    async cropBuffer(\n        buffer: Buffer,\n        crop: { top: number; left: number; bottom: number; right: number }\n    ): Promise<Buffer> {\n        const m = await this.load();\n        return m.cropImageBuffer(buffer, crop);\n    }\n\n    async optimizePng(buffer: Buffer) {\n        const s = await this.getSharp();\n        return s(buffer)\n            .resize({ width: 2560, withoutEnlargement: true, fit: \"inside\" })\n            .png({ compressionLevel: 9, adaptiveFiltering: true, force: true })\n            .withMetadata();\n    }\n\n    async optimizeJpeg(buffer: Buffer) {\n        const s = await this.getSharp();\n        return s(buffer)\n            .resize({ width: 2560, withoutEnlargement: true, fit: \"inside\" })\n            .withMetadata()\n            .toFormat(\"jpeg\", { quality: 90 });\n    }\n}\n"],"names":["SharpTransformer","params","m","buffer","framing","crop","s"],"mappings":"AAGO,MAAMA;IAIT,MAAc,OAAO;QACjB,IAAI,CAAC,IAAI,CAAC,MAAM,EACZ,IAAI,CAAC,MAAM,GAAG,MAAM,MAAM,CAAC;QAE/B,OAAO,IAAI,CAAC,MAAM;IACtB;IAEA,MAAc,WAAW;QACrB,IAAI,CAAC,IAAI,CAAC,KAAK,EACX,IAAI,CAAC,KAAK,GAAI,OAAM,MAAM,CAAC,QAAO,EAAG,OAAO;QAEhD,OAAO,IAAI,CAAC,KAAK;IACrB;IAEA,MAAM,gBAAgBC,MAA4B,EAAiC;QAC/E,MAAMC,IAAI,MAAM,IAAI,CAAC,IAAI;QACzB,OAAOA,EAAE,oBAAoB,CAACD;IAClC;IAEA,MAAM,oBAAoBE,MAAc,EAAEC,OAAgB,EAAmB;QACzE,MAAMF,IAAI,MAAM,IAAI,CAAC,IAAI;QACzB,OAAOA,EAAE,mBAAmB,CAACC,QAAQC;IACzC;IAEA,MAAM,WACFD,MAAc,EACdE,IAAkE,EACnD;QACf,MAAMH,IAAI,MAAM,IAAI,CAAC,IAAI;QACzB,OAAOA,EAAE,eAAe,CAACC,QAAQE;IACrC;IAEA,MAAM,YAAYF,MAAc,EAAE;QAC9B,MAAMG,IAAI,MAAM,IAAI,CAAC,QAAQ;QAC7B,OAAOA,EAAEH,QACJ,MAAM,CAAC;YAAE,OAAO;YAAM,oBAAoB;YAAM,KAAK;QAAS,GAC9D,GAAG,CAAC;YAAE,kBAAkB;YAAG,mBAAmB;YAAM,OAAO;QAAK,GAChE,YAAY;IACrB;IAEA,MAAM,aAAaA,MAAc,EAAE;QAC/B,MAAMG,IAAI,MAAM,IAAI,CAAC,QAAQ;QAC7B,OAAOA,EAAEH,QACJ,MAAM,CAAC;YAAE,OAAO;YAAM,oBAAoB;YAAM,KAAK;QAAS,GAC9D,YAAY,GACZ,QAAQ,CAAC,QAAQ;YAAE,SAAS;QAAG;IACxC;AACJ"}

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) : 0 / 0;
+    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,KAAG;IAC3D,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 {};