@vendure/asset-server-plugin 3.1.0-next.3 → 3.1.0

package/lib/index.d.ts

@@ -1,4 +1,8 @@
 export * from './src/plugin';
-export * from './src/s3-asset-storage-strategy';
-export * from './src/sharp-asset-preview-strategy';
+export * from './src/asset-server';
+export * from './src/config/s3-asset-storage-strategy';
+export * from './src/config/sharp-asset-preview-strategy';
+export * from './src/config/image-transform-strategy';
+export * from './src/config/preset-only-strategy';
+export * from './src/config/hashed-asset-naming-strategy';
 export * from './src/types';

package/lib/index.js

@@ -15,7 +15,11 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./src/plugin"), exports);
-__exportStar(require("./src/s3-asset-storage-strategy"), exports);
-__exportStar(require("./src/sharp-asset-preview-strategy"), exports);
+__exportStar(require("./src/asset-server"), exports);
+__exportStar(require("./src/config/s3-asset-storage-strategy"), exports);
+__exportStar(require("./src/config/sharp-asset-preview-strategy"), exports);
+__exportStar(require("./src/config/image-transform-strategy"), exports);
+__exportStar(require("./src/config/preset-only-strategy"), exports);
+__exportStar(require("./src/config/hashed-asset-naming-strategy"), exports);
 __exportStar(require("./src/types"), exports);
 //# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA6B;AAC7B,kEAAgD;AAChD,qEAAmD;AACnD,8CAA4B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA6B;AAC7B,qDAAmC;AACnC,yEAAuD;AACvD,4EAA0D;AAC1D,wEAAsD;AACtD,oEAAkD;AAClD,4EAA0D;AAC1D,8CAA4B"}

package/lib/src/asset-server.d.ts

@@ -0,0 +1,50 @@
+import { ConfigService, ProcessContext } from '@vendure/core';
+import { ImageTransformStrategy } from './config/image-transform-strategy';
+import { AssetServerOptions, ImageTransformPreset } from './types';
+/**
+ * This houses the actual Express server that handles incoming requests, performs image transformations,
+ * caches the results, and serves the transformed images.
+ */
+export declare class AssetServer {
+    private options;
+    private configService;
+    private processContext;
+    private readonly assetStorageStrategy;
+    private readonly cacheDir;
+    private cacheHeader;
+    private presets;
+    private imageTransformStrategies;
+    constructor(options: AssetServerOptions, configService: ConfigService, processContext: ProcessContext);
+    /** @internal */
+    onApplicationBootstrap(): void;
+    /**
+     * Creates the image server instance
+     */
+    createAssetServer(serverConfig: {
+        presets: ImageTransformPreset[];
+        imageTransformStrategies: ImageTransformStrategy[];
+    }): import("express-serve-static-core").Router;
+    /**
+     * Reads the file requested and send the response to the browser.
+     */
+    private sendAsset;
+    /**
+     * If an exception was thrown by the first handler, then it may be because a transformed image
+     * is being requested which does not yet exist. In this case, this handler will generate the
+     * transformed image, save it to cache, and serve the result as a response.
+     */
+    private generateTransformedImage;
+    private getImageTransformParameters;
+    private getInitialImageTransformParameters;
+    private getFileNameFromParameters;
+    /**
+     * Sanitize the file path to prevent directory traversal attacks.
+     */
+    private sanitizeFilePath;
+    private md5;
+    private addSuffix;
+    /**
+     * Attempt to get the mime type from the file name.
+     */
+    private getMimeType;
+}

package/lib/src/asset-server.js

@@ -0,0 +1,303 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AssetServer = void 0;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@vendure/core");
+const crypto_1 = require("crypto");
+const express_1 = __importDefault(require("express"));
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const path_1 = __importDefault(require("path"));
+const common_2 = require("./common");
+const s3_asset_storage_strategy_1 = require("./config/s3-asset-storage-strategy");
+const constants_1 = require("./constants");
+const transform_image_1 = require("./transform-image");
+async function getFileType(buffer) {
+    const { fileTypeFromBuffer } = await import('file-type');
+    return fileTypeFromBuffer(buffer);
+}
+/**
+ * This houses the actual Express server that handles incoming requests, performs image transformations,
+ * caches the results, and serves the transformed images.
+ */
+let AssetServer = class AssetServer {
+    constructor(options, configService, processContext) {
+        this.options = options;
+        this.configService = configService;
+        this.processContext = processContext;
+        this.cacheDir = 'cache';
+        this.assetStorageStrategy = this.configService.assetOptions.assetStorageStrategy;
+    }
+    /** @internal */
+    onApplicationBootstrap() {
+        if (this.processContext.isWorker) {
+            return;
+        }
+        // Configure Cache-Control header
+        const { cacheHeader } = this.options;
+        if (!cacheHeader) {
+            this.cacheHeader = constants_1.DEFAULT_CACHE_HEADER;
+        }
+        else {
+            if (typeof cacheHeader === 'string') {
+                this.cacheHeader = cacheHeader;
+            }
+            else {
+                this.cacheHeader = [cacheHeader.restriction, `max-age: ${cacheHeader.maxAge}`]
+                    .filter(value => !!value)
+                    .join(', ');
+            }
+        }
+        const cachePath = path_1.default.join(this.options.assetUploadDir, this.cacheDir);
+        fs_extra_1.default.ensureDirSync(cachePath);
+    }
+    /**
+     * Creates the image server instance
+     */
+    createAssetServer(serverConfig) {
+        this.presets = serverConfig.presets;
+        this.imageTransformStrategies = serverConfig.imageTransformStrategies;
+        const assetServer = express_1.default.Router();
+        assetServer.use(this.sendAsset(), this.generateTransformedImage());
+        return assetServer;
+    }
+    /**
+     * Reads the file requested and send the response to the browser.
+     */
+    sendAsset() {
+        return async (req, res, next) => {
+            var _a;
+            let params;
+            try {
+                params = await this.getImageTransformParameters(req);
+            }
+            catch (e) {
+                core_1.Logger.error(e.message, constants_1.loggerCtx);
+                res.status(400).send('Invalid parameters');
+                return;
+            }
+            const key = this.getFileNameFromParameters(req.path, params);
+            try {
+                const file = await this.assetStorageStrategy.readFileToBuffer(key);
+                let mimeType = this.getMimeType(key);
+                if (!mimeType) {
+                    mimeType = ((_a = (await getFileType(file))) === null || _a === void 0 ? void 0 : _a.mime) || 'application/octet-stream';
+                }
+                res.contentType(mimeType);
+                res.setHeader('content-security-policy', "default-src 'self'");
+                res.setHeader('Cache-Control', this.cacheHeader);
+                res.send(file);
+            }
+            catch (e) {
+                const err = new Error('File not found');
+                err.status = 404;
+                return next(err);
+            }
+        };
+    }
+    /**
+     * If an exception was thrown by the first handler, then it may be because a transformed image
+     * is being requested which does not yet exist. In this case, this handler will generate the
+     * transformed image, save it to cache, and serve the result as a response.
+     */
+    generateTransformedImage() {
+        return async (err, req, res, next) => {
+            var _a;
+            if (err && (err.status === 404 || err.statusCode === 404)) {
+                if (req.query) {
+                    const decodedReqPath = this.sanitizeFilePath(req.path);
+                    core_1.Logger.debug(`Pre-cached Asset not found: ${decodedReqPath}`, constants_1.loggerCtx);
+                    let file;
+                    try {
+                        file = await this.assetStorageStrategy.readFileToBuffer(decodedReqPath);
+                    }
+                    catch (_err) {
+                        res.status(404).send('Resource not found');
+                        return;
+                    }
+                    try {
+                        const parameters = await this.getImageTransformParameters(req);
+                        const image = await (0, transform_image_1.transformImage)(file, parameters);
+                        const imageBuffer = await image.toBuffer();
+                        const cachedFileName = this.getFileNameFromParameters(req.path, parameters);
+                        if (!req.query.cache || req.query.cache === 'true') {
+                            await this.assetStorageStrategy.writeFileFromBuffer(cachedFileName, imageBuffer);
+                            core_1.Logger.debug(`Saved cached asset: ${cachedFileName}`, constants_1.loggerCtx);
+                        }
+                        let mimeType = this.getMimeType(cachedFileName);
+                        if (!mimeType) {
+                            mimeType = ((_a = (await getFileType(imageBuffer))) === null || _a === void 0 ? void 0 : _a.mime) || 'image/jpeg';
+                        }
+                        res.set('Content-Type', mimeType);
+                        res.setHeader('content-security-policy', "default-src 'self'");
+                        res.send(imageBuffer);
+                        return;
+                    }
+                    catch (e) {
+                        core_1.Logger.error(e.message, constants_1.loggerCtx, e.stack);
+                        res.status(500).send('An error occurred when generating the image');
+                        return;
+                    }
+                }
+            }
+            next();
+        };
+    }
+    async getImageTransformParameters(req) {
+        let parameters = this.getInitialImageTransformParameters(req.query);
+        for (const strategy of this.imageTransformStrategies) {
+            try {
+                parameters = await strategy.getImageTransformParameters({
+                    req,
+                    input: Object.assign({}, parameters),
+                    availablePresets: this.presets,
+                });
+            }
+            catch (e) {
+                core_1.Logger.error(`Error applying ImageTransformStrategy: ` + e.message, constants_1.loggerCtx);
+                throw e;
+            }
+        }
+        let targetWidth = parameters.width;
+        let targetHeight = parameters.height;
+        let targetMode = parameters.mode;
+        if (parameters.preset) {
+            const matchingPreset = this.presets.find(p => p.name === parameters.preset);
+            if (matchingPreset) {
+                targetWidth = matchingPreset.width;
+                targetHeight = matchingPreset.height;
+                targetMode = matchingPreset.mode;
+            }
+        }
+        return Object.assign(Object.assign({}, parameters), { width: targetWidth, height: targetHeight, mode: targetMode });
+    }
+    getInitialImageTransformParameters(queryParams) {
+        const width = Math.round(+queryParams.w) || undefined;
+        const height = Math.round(+queryParams.h) || undefined;
+        const quality = queryParams.q != null ? Math.round(Math.max(Math.min(+queryParams.q, 100), 1)) : undefined;
+        const mode = queryParams.mode === 'resize' ? 'resize' : 'crop';
+        const fpx = +queryParams.fpx || undefined;
+        const fpy = +queryParams.fpy || undefined;
+        const format = (0, common_2.getValidFormat)(queryParams.format);
+        return {
+            width,
+            height,
+            quality,
+            format,
+            mode,
+            fpx,
+            fpy,
+            preset: queryParams.preset,
+        };
+    }
+    getFileNameFromParameters(filePath, params) {
+        const { width: w, height: h, mode, preset, fpx, fpy, format, quality: q } = params;
+        /* eslint-disable @typescript-eslint/restrict-template-expressions */
+        const focalPoint = fpx && fpy ? `_fpx${fpx}_fpy${fpy}` : '';
+        const quality = q ? `_q${q}` : '';
+        const imageFormat = (0, common_2.getValidFormat)(format);
+        let imageParamsString = '';
+        if (w || h) {
+            const width = w || '';
+            const height = h || '';
+            imageParamsString = `_transform_w${width}_h${height}_m${mode}`;
+        }
+        else if (preset) {
+            if (this.presets && !!this.presets.find(p => p.name === preset)) {
+                imageParamsString = `_transform_pre_${preset}`;
+            }
+        }
+        if (focalPoint) {
+            imageParamsString += focalPoint;
+        }
+        if (imageFormat) {
+            imageParamsString += imageFormat;
+        }
+        if (quality) {
+            imageParamsString += quality;
+        }
+        const decodedReqPath = this.sanitizeFilePath(filePath);
+        if (imageParamsString !== '') {
+            const imageParamHash = this.md5(imageParamsString);
+            return path_1.default.join(this.cacheDir, this.addSuffix(decodedReqPath, imageParamHash, imageFormat));
+        }
+        else {
+            return decodedReqPath;
+        }
+    }
+    /**
+     * Sanitize the file path to prevent directory traversal attacks.
+     */
+    sanitizeFilePath(filePath) {
+        let decodedPath;
+        try {
+            decodedPath = decodeURIComponent(filePath);
+        }
+        catch (e) {
+            core_1.Logger.error(e.message + ': ' + filePath, constants_1.loggerCtx);
+            return '';
+        }
+        if (!(this.assetStorageStrategy instanceof s3_asset_storage_strategy_1.S3AssetStorageStrategy)) {
+            // For S3 storage, we don't need to sanitize the path because
+            // directory traversal attacks are not possible, and modifying the
+            // path in this way can s3 files to be not found.
+            return path_1.default.normalize(decodedPath).replace(/(\.\.[\/\\])+/, '');
+        }
+        else {
+            return decodedPath;
+        }
+    }
+    md5(input) {
+        return (0, crypto_1.createHash)('md5').update(input).digest('hex');
+    }
+    addSuffix(fileName, suffix, ext) {
+        const originalExt = path_1.default.extname(fileName);
+        const effectiveExt = ext ? `.${ext}` : originalExt;
+        const baseName = path_1.default.basename(fileName, originalExt);
+        const dirName = path_1.default.dirname(fileName);
+        return path_1.default.join(dirName, `${baseName}${suffix}${effectiveExt}`);
+    }
+    /**
+     * Attempt to get the mime type from the file name.
+     */
+    getMimeType(fileName) {
+        const ext = path_1.default.extname(fileName);
+        switch (ext) {
+            case '.jpg':
+            case '.jpeg':
+                return 'image/jpeg';
+            case '.png':
+                return 'image/png';
+            case '.gif':
+                return 'image/gif';
+            case '.svg':
+                return 'image/svg+xml';
+            case '.tiff':
+                return 'image/tiff';
+            case '.webp':
+                return 'image/webp';
+        }
+    }
+};
+exports.AssetServer = AssetServer;
+exports.AssetServer = AssetServer = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(constants_1.ASSET_SERVER_PLUGIN_INIT_OPTIONS)),
+    __metadata("design:paramtypes", [Object, core_1.ConfigService,
+        core_1.ProcessContext])
+], AssetServer);
+//# sourceMappingURL=asset-server.js.map

package/lib/src/asset-server.js.map

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

package/lib/src/{default-asset-storage-strategy-factory.d.ts → config/default-asset-storage-strategy-factory.d.ts}

@@ -1,5 +1,5 @@
+import { AssetServerOptions } from '../types';
 import { LocalAssetStorageStrategy } from './local-asset-storage-strategy';
-import { AssetServerOptions } from './types';
 /**
  * By default the AssetServerPlugin will configure and use the LocalStorageStrategy to persist Assets.
  */

package/lib/src/{default-asset-storage-strategy-factory.js → config/default-asset-storage-strategy-factory.js}

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.defaultAssetStorageStrategyFactory = void 0;
-const common_1 = require("./common");
+const common_1 = require("../common");
 const local_asset_storage_strategy_1 = require("./local-asset-storage-strategy");
 /**
  * By default the AssetServerPlugin will configure and use the LocalStorageStrategy to persist Assets.

package/lib/src/config/default-asset-storage-strategy-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-asset-storage-strategy-factory.js","sourceRoot":"","sources":["../../../src/config/default-asset-storage-strategy-factory.ts"],"names":[],"mappings":";;;AAEA,sCAAgD;AAGhD,iFAA2E;AAE3E;;GAEG;AACH,SAAgB,kCAAkC,CAAC,OAA2B;IAC1E,MAAM,EAAE,cAAc,EAAE,cAAc,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;IAC1D,MAAM,QAAQ,GAAG,IAAA,4BAAmB,EAAC,OAAO,CAAC,CAAC;IAC9C,MAAM,eAAe,GAAG,CAAC,OAAgB,EAAE,UAAkB,EAAU,EAAE;QACrE,IAAI,CAAC,UAAU,EAAE,CAAC;YACd,OAAO,EAAE,CAAC;QACd,CAAC;QACD,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QAC7C,OAAO,UAAU,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,UAAU,EAAE,CAAC;IACjF,CAAC,CAAC;IACF,OAAO,IAAI,wDAAyB,CAAC,cAAc,EAAE,eAAe,CAAC,CAAC;AAC1E,CAAC;AAXD,gFAWC"}

package/lib/src/config/hashed-asset-naming-strategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hashed-asset-naming-strategy.js","sourceRoot":"","sources":["../../../src/config/hashed-asset-naming-strategy.ts"],"names":[],"mappings":";;;;;;AAAA,wCAA2E;AAC3E,mCAAoC;AACpC,gDAAwB;AAExB;;;;;;;;;;;;;;GAcG;AACH,MAAa,yBAA0B,SAAQ,iCAA0B;IACrE,sBAAsB,CAAC,GAAmB,EAAE,gBAAwB,EAAE,gBAAyB;QAC3F,MAAM,QAAQ,GAAG,KAAK,CAAC,sBAAsB,CAAC,GAAG,EAAE,gBAAgB,EAAE,gBAAgB,CAAC,CAAC;QACvF,OAAO,cAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,CAAC;IACtE,CAAC;IACD,uBAAuB,CACnB,GAAmB,EACnB,gBAAwB,EACxB,gBAAyB;QAEzB,MAAM,QAAQ,GAAG,KAAK,CAAC,uBAAuB,CAAC,GAAG,EAAE,gBAAgB,EAAE,gBAAgB,CAAC,CAAC;QACxF,OAAO,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,CAAC;IACvE,CAAC;IAEO,YAAY,CAAC,QAAgB;QACjC,OAAO,IAAA,mBAAU,EAAC,KAAK,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACxE,CAAC;CACJ;AAjBD,8DAiBC"}

package/lib/src/config/image-transform-strategy.d.ts

@@ -0,0 +1,58 @@
+import { InjectableStrategy } from '@vendure/core';
+import { Request } from 'express';
+import { ImageTransformFormat, ImageTransformMode, ImageTransformPreset } from '../types';
+/**
+ * @description
+ * Parameters which are used to transform the image.
+ *
+ * @docsCategory core plugins/AssetServerPlugin
+ * @since 3.1.0
+ * @docsPage ImageTransformStrategy
+ */
+export interface ImageTransformParameters {
+    width: number | undefined;
+    height: number | undefined;
+    mode: ImageTransformMode | undefined;
+    quality: number | undefined;
+    format: ImageTransformFormat | undefined;
+    fpx: number | undefined;
+    fpy: number | undefined;
+    preset: string | undefined;
+}
+/**
+ * @description
+ * The arguments passed to the `getImageTransformParameters` method of an ImageTransformStrategy.
+ *
+ * @docsCategory core plugins/AssetServerPlugin
+ * @since 3.1.0
+ * @docsPage ImageTransformStrategy
+ */
+export interface GetImageTransformParametersArgs {
+    req: Request;
+    availablePresets: ImageTransformPreset[];
+    input: ImageTransformParameters;
+}
+/**
+ * @description
+ * An injectable strategy which is used to determine the parameters for transforming an image.
+ * This can be used to implement custom image transformation logic, for example to
+ * limit transform parameters to a known set of presets.
+ *
+ * This is set via the `imageTransformStrategy` option in the AssetServerOptions. Multiple
+ * strategies can be defined and will be executed in the order in which they are defined.
+ *
+ * If a strategy throws an error, the image transformation will be aborted and the error
+ * will be logged, with an HTTP 400 response sent to the client.
+ *
+ * @docsCategory core plugins/AssetServerPlugin
+ * @docsPage ImageTransformStrategy
+ * @docsWeight 0
+ * @since 3.1.0
+ */
+export interface ImageTransformStrategy extends InjectableStrategy {
+    /**
+     * @description
+     * Given the input parameters, return the parameters which should be used to transform the image.
+     */
+    getImageTransformParameters(args: GetImageTransformParametersArgs): Promise<ImageTransformParameters> | ImageTransformParameters;
+}

package/lib/src/config/image-transform-strategy.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=image-transform-strategy.js.map

package/lib/src/config/image-transform-strategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-transform-strategy.js","sourceRoot":"","sources":["../../../src/config/image-transform-strategy.ts"],"names":[],"mappings":""}

package/lib/src/config/local-asset-storage-strategy.js.map

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

package/lib/src/config/preset-only-strategy.d.ts

@@ -0,0 +1,82 @@
+import { ImageTransformFormat } from '../types';
+import { GetImageTransformParametersArgs, ImageTransformParameters, ImageTransformStrategy } from './image-transform-strategy';
+/**
+ * @description
+ * Configuration options for the {@link PresetOnlyStrategy}.
+ *
+ * @docsCategory core plugins/AssetServerPlugin
+ * @docsPage PresetOnlyStrategy
+ */
+export interface PresetOnlyStrategyOptions {
+    /**
+     * @description
+     * The name of the default preset to use if no preset is specified in the URL.
+     */
+    defaultPreset: string;
+    /**
+     * @description
+     * The permitted quality of the transformed images. If set to 'any', then any quality is permitted.
+     * If set to an array of numbers (0-100), then only those quality values are permitted.
+     *
+     * @default [0, 50, 75, 85, 95]
+     */
+    permittedQuality?: number[];
+    /**
+     * @description
+     * The permitted formats of the transformed images. If set to 'any', then any format is permitted.
+     * If set to an array of strings e.g. `['jpg', 'webp']`, then only those formats are permitted.
+     *
+     * @default ['jpg', 'webp', 'avif']
+     */
+    permittedFormats?: ImageTransformFormat[];
+    /**
+     * @description
+     * Whether to allow the focal point to be specified in the URL.
+     *
+     * @default false
+     */
+    allowFocalPoint?: boolean;
+}
+/**
+ * @description
+ * An {@link ImageTransformStrategy} which only allows transformations to be made using
+ * presets which are defined in the available presets.
+ *
+ * With this strategy enabled, requests to the asset server must include a `preset` parameter (or use the default preset)
+ *
+ * This is valid: `http://localhost:3000/assets/some-asset.jpg?preset=medium`
+ *
+ * This is invalid: `http://localhost:3000/assets/some-asset.jpg?w=200&h=200`, and the dimensions will be ignored.
+ *
+ * The strategy can be configured to allow only certain quality values and formats, and to
+ * optionally allow the focal point to be specified in the URL.
+ *
+ * If a preset is not found in the available presets, an error will be thrown.
+ *
+ * @example
+ * ```ts
+ * import { AssetServerPlugin, PresetOnlyStrategy } from '\@vendure/core';
+ *
+ * // ...
+ *
+ * AssetServerPlugin.init({
+ *   //...
+ *   imageTransformStrategy: new PresetOnlyStrategy({
+ *     defaultPreset: 'thumbnail',
+ *     permittedQuality: [0, 50, 75, 85, 95],
+ *     permittedFormats: ['jpg', 'webp', 'avif'],
+ *     allowFocalPoint: true,
+ *   }),
+ * });
+ * ```
+ *
+ * @docsCategory core plugins/AssetServerPlugin
+ * @docsPage PresetOnlyStrategy
+ * @docsWeight 0
+ * @since 3.1.0
+ */
+export declare class PresetOnlyStrategy implements ImageTransformStrategy {
+    private options;
+    constructor(options: PresetOnlyStrategyOptions);
+    getImageTransformParameters({ input, availablePresets, }: GetImageTransformParametersArgs): Promise<ImageTransformParameters> | ImageTransformParameters;
+}

package/lib/src/config/preset-only-strategy.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PresetOnlyStrategy = void 0;
+/**
+ * @description
+ * An {@link ImageTransformStrategy} which only allows transformations to be made using
+ * presets which are defined in the available presets.
+ *
+ * With this strategy enabled, requests to the asset server must include a `preset` parameter (or use the default preset)
+ *
+ * This is valid: `http://localhost:3000/assets/some-asset.jpg?preset=medium`
+ *
+ * This is invalid: `http://localhost:3000/assets/some-asset.jpg?w=200&h=200`, and the dimensions will be ignored.
+ *
+ * The strategy can be configured to allow only certain quality values and formats, and to
+ * optionally allow the focal point to be specified in the URL.
+ *
+ * If a preset is not found in the available presets, an error will be thrown.
+ *
+ * @example
+ * ```ts
+ * import { AssetServerPlugin, PresetOnlyStrategy } from '\@vendure/core';
+ *
+ * // ...
+ *
+ * AssetServerPlugin.init({
+ *   //...
+ *   imageTransformStrategy: new PresetOnlyStrategy({
+ *     defaultPreset: 'thumbnail',
+ *     permittedQuality: [0, 50, 75, 85, 95],
+ *     permittedFormats: ['jpg', 'webp', 'avif'],
+ *     allowFocalPoint: true,
+ *   }),
+ * });
+ * ```
+ *
+ * @docsCategory core plugins/AssetServerPlugin
+ * @docsPage PresetOnlyStrategy
+ * @docsWeight 0
+ * @since 3.1.0
+ */
+class PresetOnlyStrategy {
+    constructor(options) {
+        this.options = options;
+    }
+    getImageTransformParameters({ input, availablePresets, }) {
+        var _a, _b, _c;
+        const presetName = (_a = input.preset) !== null && _a !== void 0 ? _a : this.options.defaultPreset;
+        const matchingPreset = availablePresets.find(p => p.name === presetName);
+        if (!matchingPreset) {
+            throw new Error(`Preset "${presetName}" not found`);
+        }
+        const permittedQuality = (_b = this.options.permittedQuality) !== null && _b !== void 0 ? _b : [0, 50, 75, 85, 95];
+        const permittedFormats = (_c = this.options.permittedFormats) !== null && _c !== void 0 ? _c : ['jpg', 'webp', 'avif'];
+        const quality = input.quality && permittedQuality.includes(input.quality) ? input.quality : undefined;
+        const format = input.format && permittedFormats.includes(input.format) ? input.format : undefined;
+        return {
+            width: matchingPreset.width,
+            height: matchingPreset.height,
+            mode: matchingPreset.mode,
+            quality,
+            format,
+            fpx: this.options.allowFocalPoint ? input.fpx : undefined,
+            fpy: this.options.allowFocalPoint ? input.fpy : undefined,
+            preset: input.preset,
+        };
+    }
+}
+exports.PresetOnlyStrategy = PresetOnlyStrategy;
+//# sourceMappingURL=preset-only-strategy.js.map