Add onlyPresets setting

Author: 11bit

src/methods/generateImageInfoUrl.test.ts

@@ -86,4 +86,16 @@ describe("generateImageInfoUrl", () => {
       "/avg:t:f/do:t/dc:t:t/exp:1729409825/iptc:t/p:6/pr:test:test2/s:t/plain/https://example.com/host/pic.png"
     );
   });
+
+  it("should work with `onlyPresets` setting", () => {
+    expect(
+      generateUrl(
+        { value: "https://example.com/host/pic.png", type: "plain" },
+        {
+          preset: ["test", "test2"],
+        },
+        { onlyPresets: true }
+      )
+    ).toEqual("/test:test2/plain/https://example.com/host/pic.png");
+  });
 });

src/methods/generateImageInfoUrl.ts

@@ -1,6 +1,7 @@
 import { OptionsImageInfo } from "../typesImageInfo";
 import * as optionModules from "../optionsImageInfo";
 import { guardIsUndef, guardIsValidVal } from "../utils";
+import { Settings } from "../settings";
 
 const correctUrlTypes = {
   plain: true,
@@ -15,7 +16,8 @@ export type URLImageInfo = {
 
 const generateImageInfoUrl = (
   url: URLImageInfo,
-  options?: OptionsImageInfo
+  options?: OptionsImageInfo,
+  settings?: Settings
 ): string => {
   guardIsUndef(url.value, "url.value", "Must be a string");
   guardIsUndef(
@@ -30,7 +32,7 @@ const generateImageInfoUrl = (
     for (const [, optionModule] of Object.entries(optionModules)) {
       if (optionModule.test(options)) {
         optsPart += "/";
-        optsPart += optionModule.build(options);
+        optsPart += optionModule.build(options, settings);
       }
     }
   }

src/methods/generateUrl.ts

@@ -2,14 +2,19 @@ import { Options } from "../types";
 import * as optionModules from "../options";
 import { guardIsUndef, guardIsValidVal } from "../utils";
 import type { URLImageInfo } from "./generateImageInfoUrl";
+import { Settings } from "../settings";
 
 const correctUrlTypes = {
   plain: true,
   base64: true,
   encrypted: true,
 };
 
-const generateUrl = (url: URLImageInfo, options?: Options): string => {
+const generateUrl = (
+  url: URLImageInfo,
+  options?: Options,
+  settings?: Settings
+): string => {
   guardIsUndef(url.value, "url.value", "Must be a string");
   guardIsUndef(
     url.type,
@@ -23,7 +28,7 @@ const generateUrl = (url: URLImageInfo, options?: Options): string => {
     for (const [, optionModule] of Object.entries(optionModules)) {
       if (optionModule.test(options)) {
         optsPart += "/";
-        optsPart += optionModule.build(options);
+        optsPart += optionModule.build(options, settings);
       }
     }
   }

src/optionsShared/preset.ts

@@ -1,3 +1,4 @@
+import { Settings } from "../settings";
 import { Preset, PresetOptionsPartial } from "../typesShared/preset";
 import { guardIsUndef, guardIsNotArray } from "../utils";
 
@@ -7,8 +8,8 @@ const getOpt = (options: PresetOptionsPartial): Preset | undefined =>
 const test = (options: PresetOptionsPartial): boolean =>
   Boolean(getOpt(options));
 
-const build = (options: PresetOptionsPartial): string => {
-  const preset = getOpt(options);
+const build = (options: PresetOptionsPartial, settings?: Settings): string => {
+  let preset = getOpt(options);
 
   guardIsUndef(preset, "preset");
   guardIsNotArray(preset, "preset");
@@ -17,7 +18,11 @@ const build = (options: PresetOptionsPartial): string => {
     throw new Error("preset option should contain only strings");
   }
 
-  return `pr:${preset.join(":")}`;
+  if (!settings?.onlyPresets) {
+    preset = ["pr", ...preset];
+  }
+
+  return `${preset.join(":")}`;
 };
 
 export { test, build };

src/settings.ts

@@ -0,0 +1,7 @@
+export type Settings = {
+  /**
+   * Setting `onlyPresets` to true switches imgproxy into presets-only mode. In this mode, imgproxy accepts a presets list as processing options.
+   * @see https://docs.imgproxy.net/usage/presets#only-presets
+   */
+  onlyPresets?: boolean;
+};

tests/optionsShared/preset.test.ts

@@ -46,5 +46,11 @@ describe("preset", () => {
     it("should return 'pr:paddings:jpg' if pr option is ['paddings', 'jpg']", () => {
       expect(build({ pr: ["paddings", "jpg"] })).toEqual("pr:paddings:jpg");
     });
+
+    it("should work with `onlyPresets` setting ", () => {
+      expect(build({ pr: ["paddings", "jpg"] }, { onlyPresets: true })).toEqual(
+        "paddings:jpg"
+      );
+    });
   });
 });