feat: implement legacy imgproxy compatibility and URL mapping

packages/image-processor/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mintel/image-processor",
-  "version": "1.8.16",
+  "version": "1.8.19",
   "private": true,
   "type": "module",
   "main": "./dist/index.js",

packages/image-processor/src/processor.ts

@@ -8,6 +8,54 @@ export interface ProcessImageOptions {
   openRouterApiKey?: string;
 }
 
+/**
+ * Maps a URL based on the IMGPROXY_URL_MAPPING environment variable.
+ * Format: "match1:replace1,match2:replace2"
+ */
+export function mapUrl(url: string, mappingString?: string): string {
+  if (!mappingString) return url;
+
+  const mappings = mappingString.split(",").map((m) => m.split(":"));
+  let mappedUrl = url;
+
+  for (const [match, replace] of mappings) {
+    if (match && replace && url.includes(match)) {
+      mappedUrl = url.replace(match, replace);
+    }
+  }
+
+  return mappedUrl;
+}
+
+/**
+ * Parses legacy imgproxy options string.
+ * Example: rs:fill:300:400/q:80
+ */
+export function parseImgproxyOptions(
+  optionsStr: string,
+): Partial<ProcessImageOptions> {
+  const parts = optionsStr.split("/");
+  const options: Partial<ProcessImageOptions> = {};
+
+  for (const part of parts) {
+    if (part.startsWith("rs:")) {
+      const [, , w, h] = part.split(":");
+      if (w) options.width = parseInt(w, 10);
+      if (h) options.height = parseInt(h, 10);
+    } else if (part.startsWith("q:")) {
+      const q = part.split(":")[1];
+      if (q) options.quality = parseInt(q, 10);
+    } else if (part.startsWith("ext:")) {
+      const ext = part.split(":")[1] as any;
+      if (["webp", "jpeg", "png", "avif"].includes(ext)) {
+        options.format = ext;
+      }
+    }
+  }
+
+  return options;
+}
+
 interface FaceDetection {
   x: number;
   y: number;