@flightdev/image 0.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-2026 Flight Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,219 @@
+# @flight-framework/image
+
+Image optimization package for Flight Framework with Sharp, Squoosh, and CDN adapters.
+
+## Installation
+
+```bash
+npm install @flight-framework/image
+
+# Install your preferred processor:
+npm install sharp           # For Node.js (fastest)
+# OR use CDN adapters (no additional install needed)
+```
+
+## Quick Start
+
+```typescript
+import { createImage } from '@flight-framework/image';
+import { sharp } from '@flight-framework/image/sharp';
+
+const image = createImage(sharp());
+
+// Optimize an image
+const result = await image.optimize('./hero.jpg', {
+  width: 800,
+  format: 'webp',
+  quality: 80,
+});
+
+// Generate blur placeholder
+const blur = await image.blur('./hero.jpg');
+
+// Generate responsive variants
+const responsive = await image.responsive('./hero.jpg', {
+  widths: [640, 768, 1024, 1280],
+  formats: ['webp', 'avif'],
+});
+```
+
+## Adapters
+
+### Sharp (Node.js)
+
+Fastest option for Node.js environments.
+
+```typescript
+import { sharp } from '@flight-framework/image/sharp';
+
+const adapter = sharp({
+  cache: true,        // Enable internal cache
+  concurrency: 4,     // Parallel processing
+  simd: true,         // SIMD optimization
+});
+```
+
+### Squoosh (Edge/WASM)
+
+Works on Edge runtimes (Cloudflare Workers, Vercel Edge).
+
+```typescript
+import { squoosh } from '@flight-framework/image/squoosh';
+
+const adapter = squoosh();
+```
+
+### Cloudinary (CDN)
+
+CDN-based optimization, no local processing.
+
+```typescript
+import { cloudinary } from '@flight-framework/image/cloudinary';
+
+const adapter = cloudinary({
+  cloudName: 'my-cloud',
+  apiKey: process.env.CLOUDINARY_API_KEY,
+  apiSecret: process.env.CLOUDINARY_API_SECRET,
+});
+```
+
+### Imgix (CDN)
+
+```typescript
+import { imgix } from '@flight-framework/image/imgix';
+
+const adapter = imgix({
+  domain: 'my-source.imgix.net',
+  secureUrlToken: process.env.IMGIX_TOKEN,
+});
+```
+
+## UI Components
+
+### React
+
+```tsx
+import { Image } from '@flight-framework/image/react';
+
+<Image
+  src="/hero.jpg"
+  alt="Hero image"
+  width={800}
+  height={600}
+  priority           // Preload for LCP
+  placeholder="blur" // Show blur while loading
+  blurDataUrl={blur} // From image.blur()
+/>
+```
+
+### Vue
+
+```vue
+<script setup>
+import { FlightImage } from '@flight-framework/image/vue';
+</script>
+
+<template>
+  <FlightImage
+    src="/hero.jpg"
+    alt="Hero"
+    :width="800"
+    :height="600"
+    priority
+    placeholder="blur"
+  />
+</template>
+```
+
+### Svelte
+
+```svelte
+<script>
+  import { createImageProps, lazyImage } from '@flight-framework/image/svelte';
+  
+  const props = createImageProps({
+    src: '/hero.jpg',
+    alt: 'Hero',
+    width: 800,
+    height: 600,
+  });
+</script>
+
+<img {...props} use:lazyImage={blurDataUrl} />
+```
+
+### Solid
+
+```tsx
+import { Image } from '@flight-framework/image/solid';
+
+<Image
+  src="/hero.jpg"
+  alt="Hero"
+  width={800}
+  height={600}
+  priority
+  placeholder="blur"
+/>
+```
+
+## API Reference
+
+### ImageOptimizeOptions
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `width` | number | - | Target width |
+| `height` | number | - | Target height |
+| `format` | ImageFormat | 'auto' | Output format |
+| `quality` | number | 80 | Quality (1-100) |
+| `fit` | ImageFit | 'cover' | Resize fit mode |
+| `blur` | boolean | false | Generate blur placeholder |
+| `withoutEnlargement` | boolean | false | Prevent upscaling |
+| `preserveMetadata` | boolean | false | Keep EXIF data |
+
+### ImageFormat
+
+`'jpeg' | 'png' | 'webp' | 'avif' | 'gif' | 'tiff' | 'auto'`
+
+### ImageFit
+
+`'cover' | 'contain' | 'fill' | 'inside' | 'outside'`
+
+## Creating Custom Adapters
+
+Implement the `ImageAdapter` interface:
+
+```typescript
+import type { ImageAdapter } from '@flight-framework/image';
+
+export function myAdapter(config: MyConfig): ImageAdapter {
+  return {
+    name: 'my-adapter',
+    
+    supportsFormat(format) {
+      return ['webp', 'jpeg', 'png'].includes(format);
+    },
+    
+    async getMetadata(input) {
+      // Return image dimensions, format, etc.
+    },
+    
+    async optimize(input, options) {
+      // Process and return optimized image
+    },
+    
+    async generateBlurPlaceholder(input, size) {
+      // Return base64 blur placeholder
+    },
+    
+    async generateResponsive(input, config) {
+      // Generate multiple sizes
+    },
+  };
+}
+```
+
+## License
+
+MIT

package/dist/adapters/cloudinary.d.ts

@@ -0,0 +1,46 @@
+import { ImageAdapterFactory } from '../index.js';
+import 'node:buffer';
+
+/**
+ * Cloudinary Adapter for @flightdev/image
+ *
+ * CDN-based image optimization using Cloudinary's transformation API.
+ * No local processing required - images are transformed at the CDN edge.
+ *
+ * @example
+ * ```typescript
+ * import { createImage } from '@flightdev/image';
+ * import { cloudinary } from '@flightdev/image/cloudinary';
+ *
+ * const image = createImage(cloudinary({
+ *   cloudName: 'my-cloud',
+ *   apiKey: process.env.CLOUDINARY_API_KEY,
+ *   apiSecret: process.env.CLOUDINARY_API_SECRET,
+ * }));
+ * ```
+ */
+
+interface CloudinaryConfig {
+    /** Cloudinary cloud name */
+    cloudName: string;
+    /** API key (optional for URL generation, required for uploads) */
+    apiKey?: string;
+    /** API secret (optional for URL generation, required for uploads) */
+    apiSecret?: string;
+    /** Use secure URLs (https) */
+    secure?: boolean;
+    /** Default folder for assets */
+    folder?: string;
+}
+/**
+ * Create a Cloudinary-based image adapter
+ *
+ * Cloudinary is a CDN-based image optimization service.
+ * Images are transformed at the edge, requiring no local processing.
+ *
+ * @param config - Cloudinary configuration
+ * @returns ImageAdapter instance
+ */
+declare const cloudinary: ImageAdapterFactory<CloudinaryConfig>;
+
+export { type CloudinaryConfig, cloudinary, cloudinary as default };

package/dist/adapters/cloudinary.js

@@ -0,0 +1,160 @@
+// src/adapters/cloudinary.ts
+function buildCloudinaryUrl(cloudName, publicId, transformations, secure = true) {
+  const protocol = secure ? "https" : "http";
+  const transform = transformations.length > 0 ? transformations.join(",") + "/" : "";
+  return `${protocol}://res.cloudinary.com/${cloudName}/image/upload/${transform}${publicId}`;
+}
+function formatToCloudinary(format) {
+  if (format === "auto") return "f_auto";
+  return `f_${format}`;
+}
+function fitToCloudinary(fit) {
+  switch (fit) {
+    case "cover":
+      return "c_fill";
+    case "contain":
+      return "c_fit";
+    case "fill":
+      return "c_scale";
+    case "inside":
+      return "c_limit";
+    case "outside":
+      return "c_mfit";
+    default:
+      return "c_fill";
+  }
+}
+var cloudinary = (config) => {
+  if (!config?.cloudName) {
+    throw new Error("@flightdev/image: Cloudinary requires a cloudName configuration");
+  }
+  const { cloudName, secure = true, folder = "" } = config;
+  const adapter = {
+    name: "cloudinary",
+    supportsFormat(format) {
+      return ["jpeg", "png", "webp", "avif", "gif", "tiff", "auto"].includes(format);
+    },
+    async getMetadata(input) {
+      if (typeof input !== "string") {
+        throw new Error("Cloudinary getMetadata requires a URL or public ID");
+      }
+      return {
+        width: 0,
+        height: 0,
+        format: "unknown"
+      };
+    },
+    async optimize(input, options) {
+      if (typeof input !== "string") {
+        throw new Error(
+          "Cloudinary adapter works with URLs/public IDs.\nFor buffer processing, use Sharp or Squoosh adapter."
+        );
+      }
+      const transformations = [];
+      if (options.quality) {
+        transformations.push(`q_${options.quality}`);
+      } else {
+        transformations.push("q_auto");
+      }
+      if (options.format) {
+        transformations.push(formatToCloudinary(options.format));
+      } else {
+        transformations.push("f_auto");
+      }
+      if (options.width) {
+        transformations.push(`w_${options.width}`);
+      }
+      if (options.height) {
+        transformations.push(`h_${options.height}`);
+      }
+      if (options.fit) {
+        transformations.push(fitToCloudinary(options.fit));
+      }
+      if (options.withoutEnlargement) {
+        transformations.push("c_limit");
+      }
+      const publicId = folder ? `${folder}/${input}` : input;
+      const url = buildCloudinaryUrl(cloudName, publicId, transformations, secure);
+      const response = await fetch(url);
+      if (!response.ok) {
+        throw new Error(`Cloudinary request failed: ${response.status}`);
+      }
+      const buffer = Buffer.from(await response.arrayBuffer());
+      const contentType = response.headers.get("content-type") ?? "image/webp";
+      const format = contentType.replace("image/", "");
+      let blurDataUrl;
+      if (options.blur) {
+        blurDataUrl = await adapter.generateBlurPlaceholder(input);
+      }
+      return {
+        buffer,
+        format,
+        width: options.width ?? 0,
+        height: options.height ?? 0,
+        size: buffer.length,
+        blurDataUrl
+      };
+    },
+    async generateBlurPlaceholder(input, size = 10) {
+      if (typeof input !== "string") {
+        throw new Error("Cloudinary generateBlurPlaceholder requires a URL/public ID");
+      }
+      const transformations = [
+        `w_${size}`,
+        `h_${size}`,
+        "c_fill",
+        "e_blur:1000",
+        "q_20",
+        "f_webp"
+      ];
+      const publicId = folder ? `${folder}/${input}` : input;
+      const url = buildCloudinaryUrl(cloudName, publicId, transformations, secure);
+      const response = await fetch(url);
+      if (!response.ok) {
+        throw new Error(`Cloudinary blur request failed: ${response.status}`);
+      }
+      const buffer = Buffer.from(await response.arrayBuffer());
+      return `data:image/webp;base64,${buffer.toString("base64")}`;
+    },
+    async generateResponsive(input, config2) {
+      if (typeof input !== "string") {
+        throw new Error("Cloudinary generateResponsive requires a URL/public ID");
+      }
+      const formats = config2.formats ?? [config2.format ?? "webp"];
+      const variants = [];
+      for (const width of config2.widths) {
+        for (const format of formats) {
+          const transformations = [
+            `w_${width}`,
+            formatToCloudinary(format),
+            "q_auto"
+          ];
+          const publicId = folder ? `${folder}/${input}` : input;
+          const url = buildCloudinaryUrl(cloudName, publicId, transformations, secure);
+          variants.push({
+            width,
+            format,
+            url,
+            buffer: Buffer.alloc(0)
+            // CDN - no local buffer
+          });
+        }
+      }
+      const srcset = variants.filter((v) => v.format === formats[0]).map((v) => `${v.url} ${v.width}w`).join(", ");
+      const sizes = config2.sizes ?? "100vw";
+      const blurDataUrl = await adapter.generateBlurPlaceholder(input);
+      return {
+        srcset,
+        sizes,
+        variants,
+        blurDataUrl
+      };
+    }
+  };
+  return adapter;
+};
+var cloudinary_default = cloudinary;
+
+export { cloudinary, cloudinary_default as default };
+//# sourceMappingURL=cloudinary.js.map
+//# sourceMappingURL=cloudinary.js.map

package/dist/adapters/cloudinary.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapters/cloudinary.ts"],"names":["config"],"mappings":"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","file":"cloudinary.js","sourcesContent":["/**\r\n * Cloudinary Adapter for @flightdev/image\r\n * \r\n * CDN-based image optimization using Cloudinary's transformation API.\r\n * No local processing required - images are transformed at the CDN edge.\r\n * \r\n * @example\r\n * ```typescript\r\n * import { createImage } from '@flightdev/image';\r\n * import { cloudinary } from '@flightdev/image/cloudinary';\r\n * \r\n * const image = createImage(cloudinary({\r\n *   cloudName: 'my-cloud',\r\n *   apiKey: process.env.CLOUDINARY_API_KEY,\r\n *   apiSecret: process.env.CLOUDINARY_API_SECRET,\r\n * }));\r\n * ```\r\n */\r\n\r\nimport type {\r\n    ImageAdapter,\r\n    ImageAdapterFactory,\r\n    ImageFormat,\r\n    ImageMetadata,\r\n    ImageOptimizeOptions,\r\n    ImageOptimizeResult,\r\n    ResponsiveConfig,\r\n    ResponsiveResult,\r\n} from '../index.js';\r\n\r\n// ============================================================================\r\n// Types\r\n// ============================================================================\r\n\r\nexport interface CloudinaryConfig {\r\n    /** Cloudinary cloud name */\r\n    cloudName: string;\r\n    /** API key (optional for URL generation, required for uploads) */\r\n    apiKey?: string;\r\n    /** API secret (optional for URL generation, required for uploads) */\r\n    apiSecret?: string;\r\n    /** Use secure URLs (https) */\r\n    secure?: boolean;\r\n    /** Default folder for assets */\r\n    folder?: string;\r\n}\r\n\r\n// ============================================================================\r\n// Cloudinary URL Builder\r\n// ============================================================================\r\n\r\nfunction buildCloudinaryUrl(\r\n    cloudName: string,\r\n    publicId: string,\r\n    transformations: string[],\r\n    secure = true\r\n): string {\r\n    const protocol = secure ? 'https' : 'http';\r\n    const transform = transformations.length > 0 ? transformations.join(',') + '/' : '';\r\n    return `${protocol}://res.cloudinary.com/${cloudName}/image/upload/${transform}${publicId}`;\r\n}\r\n\r\nfunction formatToCloudinary(format: ImageFormat): string {\r\n    if (format === 'auto') return 'f_auto';\r\n    return `f_${format}`;\r\n}\r\n\r\nfunction fitToCloudinary(fit: string | undefined): string {\r\n    switch (fit) {\r\n        case 'cover': return 'c_fill';\r\n        case 'contain': return 'c_fit';\r\n        case 'fill': return 'c_scale';\r\n        case 'inside': return 'c_limit';\r\n        case 'outside': return 'c_mfit';\r\n        default: return 'c_fill';\r\n    }\r\n}\r\n\r\n// ============================================================================\r\n// Cloudinary Adapter Implementation\r\n// ============================================================================\r\n\r\n/**\r\n * Create a Cloudinary-based image adapter\r\n * \r\n * Cloudinary is a CDN-based image optimization service.\r\n * Images are transformed at the edge, requiring no local processing.\r\n * \r\n * @param config - Cloudinary configuration\r\n * @returns ImageAdapter instance\r\n */\r\nexport const cloudinary: ImageAdapterFactory<CloudinaryConfig> = (config) => {\r\n    if (!config?.cloudName) {\r\n        throw new Error('@flightdev/image: Cloudinary requires a cloudName configuration');\r\n    }\r\n\r\n    const { cloudName, secure = true, folder = '' } = config;\r\n\r\n    const adapter: ImageAdapter = {\r\n        name: 'cloudinary',\r\n\r\n        supportsFormat(format: ImageFormat): boolean {\r\n            // Cloudinary supports all common formats\r\n            return ['jpeg', 'png', 'webp', 'avif', 'gif', 'tiff', 'auto'].includes(format);\r\n        },\r\n\r\n        async getMetadata(input: Buffer | string): Promise<ImageMetadata> {\r\n            // For CDN adapters, metadata requires an API call\r\n            // For now, return placeholder - in production you'd call Cloudinary API\r\n            if (typeof input !== 'string') {\r\n                throw new Error('Cloudinary getMetadata requires a URL or public ID');\r\n            }\r\n\r\n            // Extract from fl_getinfo would require API call\r\n            return {\r\n                width: 0,\r\n                height: 0,\r\n                format: 'unknown',\r\n            };\r\n        },\r\n\r\n        async optimize(input: Buffer | string, options: ImageOptimizeOptions): Promise<ImageOptimizeResult> {\r\n            if (typeof input !== 'string') {\r\n                throw new Error(\r\n                    'Cloudinary adapter works with URLs/public IDs.\\n' +\r\n                    'For buffer processing, use Sharp or Squoosh adapter.'\r\n                );\r\n            }\r\n\r\n            const transformations: string[] = [];\r\n\r\n            // Quality\r\n            if (options.quality) {\r\n                transformations.push(`q_${options.quality}`);\r\n            } else {\r\n                transformations.push('q_auto');\r\n            }\r\n\r\n            // Format\r\n            if (options.format) {\r\n                transformations.push(formatToCloudinary(options.format));\r\n            } else {\r\n                transformations.push('f_auto');\r\n            }\r\n\r\n            // Resize\r\n            if (options.width) {\r\n                transformations.push(`w_${options.width}`);\r\n            }\r\n            if (options.height) {\r\n                transformations.push(`h_${options.height}`);\r\n            }\r\n\r\n            // Fit\r\n            if (options.fit) {\r\n                transformations.push(fitToCloudinary(options.fit));\r\n            }\r\n\r\n            // Prevent enlargement\r\n            if (options.withoutEnlargement) {\r\n                transformations.push('c_limit');\r\n            }\r\n\r\n            const publicId = folder ? `${folder}/${input}` : input;\r\n            const url = buildCloudinaryUrl(cloudName, publicId, transformations, secure);\r\n\r\n            // Fetch the optimized image\r\n            const response = await fetch(url);\r\n            if (!response.ok) {\r\n                throw new Error(`Cloudinary request failed: ${response.status}`);\r\n            }\r\n\r\n            const buffer = Buffer.from(await response.arrayBuffer());\r\n            const contentType = response.headers.get('content-type') ?? 'image/webp';\r\n            const format = contentType.replace('image/', '') as ImageFormat;\r\n\r\n            // Generate blur if requested\r\n            let blurDataUrl: string | undefined;\r\n            if (options.blur) {\r\n                blurDataUrl = await adapter.generateBlurPlaceholder(input);\r\n            }\r\n\r\n            return {\r\n                buffer,\r\n                format,\r\n                width: options.width ?? 0,\r\n                height: options.height ?? 0,\r\n                size: buffer.length,\r\n                blurDataUrl,\r\n            };\r\n        },\r\n\r\n        async generateBlurPlaceholder(input: Buffer | string, size = 10): Promise<string> {\r\n            if (typeof input !== 'string') {\r\n                throw new Error('Cloudinary generateBlurPlaceholder requires a URL/public ID');\r\n            }\r\n\r\n            const transformations = [\r\n                `w_${size}`,\r\n                `h_${size}`,\r\n                'c_fill',\r\n                'e_blur:1000',\r\n                'q_20',\r\n                'f_webp',\r\n            ];\r\n\r\n            const publicId = folder ? `${folder}/${input}` : input;\r\n            const url = buildCloudinaryUrl(cloudName, publicId, transformations, secure);\r\n\r\n            const response = await fetch(url);\r\n            if (!response.ok) {\r\n                throw new Error(`Cloudinary blur request failed: ${response.status}`);\r\n            }\r\n\r\n            const buffer = Buffer.from(await response.arrayBuffer());\r\n            return `data:image/webp;base64,${buffer.toString('base64')}`;\r\n        },\r\n\r\n        async generateResponsive(input: Buffer | string, config: ResponsiveConfig): Promise<ResponsiveResult> {\r\n            if (typeof input !== 'string') {\r\n                throw new Error('Cloudinary generateResponsive requires a URL/public ID');\r\n            }\r\n\r\n            const formats = config.formats ?? [config.format ?? 'webp'];\r\n            const variants: ResponsiveResult['variants'] = [];\r\n\r\n            for (const width of config.widths) {\r\n                for (const format of formats) {\r\n                    const transformations = [\r\n                        `w_${width}`,\r\n                        formatToCloudinary(format),\r\n                        'q_auto',\r\n                    ];\r\n\r\n                    const publicId = folder ? `${folder}/${input}` : input;\r\n                    const url = buildCloudinaryUrl(cloudName, publicId, transformations, secure);\r\n\r\n                    variants.push({\r\n                        width,\r\n                        format,\r\n                        url,\r\n                        buffer: Buffer.alloc(0), // CDN - no local buffer\r\n                    });\r\n                }\r\n            }\r\n\r\n            const srcset = variants\r\n                .filter(v => v.format === formats[0])\r\n                .map(v => `${v.url} ${v.width}w`)\r\n                .join(', ');\r\n\r\n            const sizes = config.sizes ?? '100vw';\r\n            const blurDataUrl = await adapter.generateBlurPlaceholder(input);\r\n\r\n            return {\r\n                srcset,\r\n                sizes,\r\n                variants,\r\n                blurDataUrl,\r\n            };\r\n        },\r\n    };\r\n\r\n    return adapter;\r\n};\r\n\r\nexport default cloudinary;\r\n"]}

package/dist/adapters/imgix.d.ts

@@ -0,0 +1,39 @@
+import { ImageAdapterFactory } from '../index.js';
+import 'node:buffer';
+
+/**
+ * Imgix Adapter for @flightdev/image
+ *
+ * CDN-based image optimization using Imgix's transformation API.
+ *
+ * @example
+ * ```typescript
+ * import { createImage } from '@flightdev/image';
+ * import { imgix } from '@flightdev/image/imgix';
+ *
+ * const image = createImage(imgix({
+ *   domain: 'my-source.imgix.net',
+ *   secureUrlToken: process.env.IMGIX_TOKEN, // optional
+ * }));
+ * ```
+ */
+
+interface ImgixConfig {
+    /** Imgix source domain (e.g., 'my-source.imgix.net') */
+    domain: string;
+    /** Secure URL token for signed URLs (optional) */
+    secureUrlToken?: string;
+    /** Use HTTPS */
+    useHttps?: boolean;
+}
+/**
+ * Create an Imgix-based image adapter
+ *
+ * Imgix is a CDN-based image optimization service.
+ *
+ * @param config - Imgix configuration
+ * @returns ImageAdapter instance
+ */
+declare const imgix: ImageAdapterFactory<ImgixConfig>;
+
+export { type ImgixConfig, imgix as default, imgix };

package/dist/adapters/imgix.js

@@ -0,0 +1,152 @@
+// src/adapters/imgix.ts
+function buildImgixUrl(domain, path, params, useHttps = true) {
+  const protocol = useHttps ? "https" : "http";
+  const query = new URLSearchParams();
+  for (const [key, value] of Object.entries(params)) {
+    query.set(key, String(value));
+  }
+  const queryString = query.toString();
+  return `${protocol}://${domain}${path}${queryString ? "?" + queryString : ""}`;
+}
+function formatToImgix(format) {
+  return format === "auto" ? "auto" : format;
+}
+function fitToImgix(fit) {
+  switch (fit) {
+    case "cover":
+      return "crop";
+    case "contain":
+      return "fit";
+    case "fill":
+      return "scale";
+    case "inside":
+      return "max";
+    case "outside":
+      return "min";
+    default:
+      return "crop";
+  }
+}
+var imgix = (config) => {
+  if (!config?.domain) {
+    throw new Error("@flightdev/image: Imgix requires a domain configuration");
+  }
+  const { domain, useHttps = true } = config;
+  const adapter = {
+    name: "imgix",
+    supportsFormat(format) {
+      return ["jpeg", "png", "webp", "avif", "gif", "auto"].includes(format);
+    },
+    async getMetadata(input) {
+      if (typeof input !== "string") {
+        throw new Error("Imgix getMetadata requires a path");
+      }
+      const url = buildImgixUrl(domain, input, { fm: "json" }, useHttps);
+      try {
+        const response = await fetch(url);
+        if (!response.ok) {
+          throw new Error(`Imgix metadata request failed: ${response.status}`);
+        }
+        const data = await response.json();
+        return {
+          width: data.PixelWidth ?? 0,
+          height: data.PixelHeight ?? 0,
+          format: data["Content-Type"]?.replace("image/", "") ?? "unknown",
+          size: parseInt(data["Content-Length"] ?? "0", 10)
+        };
+      } catch {
+        return { width: 0, height: 0, format: "unknown" };
+      }
+    },
+    async optimize(input, options) {
+      if (typeof input !== "string") {
+        throw new Error("Imgix adapter works with paths/URLs only");
+      }
+      const params = {
+        auto: "format,compress"
+      };
+      if (options.width) params.w = options.width;
+      if (options.height) params.h = options.height;
+      if (options.quality) params.q = options.quality;
+      if (options.format && options.format !== "auto") params.fm = formatToImgix(options.format);
+      if (options.fit) params.fit = fitToImgix(options.fit);
+      const url = buildImgixUrl(domain, input, params, useHttps);
+      const response = await fetch(url);
+      if (!response.ok) {
+        throw new Error(`Imgix request failed: ${response.status}`);
+      }
+      const buffer = Buffer.from(await response.arrayBuffer());
+      const contentType = response.headers.get("content-type") ?? "image/webp";
+      const format = contentType.replace("image/", "");
+      let blurDataUrl;
+      if (options.blur) {
+        blurDataUrl = await adapter.generateBlurPlaceholder(input);
+      }
+      return {
+        buffer,
+        format,
+        width: options.width ?? 0,
+        height: options.height ?? 0,
+        size: buffer.length,
+        blurDataUrl
+      };
+    },
+    async generateBlurPlaceholder(input, size = 10) {
+      if (typeof input !== "string") {
+        throw new Error("Imgix generateBlurPlaceholder requires a path");
+      }
+      const params = {
+        w: size,
+        h: size,
+        blur: 200,
+        q: 20,
+        fm: "webp"
+      };
+      const url = buildImgixUrl(domain, input, params, useHttps);
+      const response = await fetch(url);
+      if (!response.ok) {
+        throw new Error(`Imgix blur request failed: ${response.status}`);
+      }
+      const buffer = Buffer.from(await response.arrayBuffer());
+      return `data:image/webp;base64,${buffer.toString("base64")}`;
+    },
+    async generateResponsive(input, config2) {
+      if (typeof input !== "string") {
+        throw new Error("Imgix generateResponsive requires a path");
+      }
+      const formats = config2.formats ?? [config2.format ?? "webp"];
+      const variants = [];
+      for (const width of config2.widths) {
+        for (const format of formats) {
+          const params = {
+            w: width,
+            auto: "compress"
+          };
+          if (format !== "auto") params.fm = format;
+          const url = buildImgixUrl(domain, input, params, useHttps);
+          variants.push({
+            width,
+            format,
+            url,
+            buffer: Buffer.alloc(0)
+          });
+        }
+      }
+      const srcset = variants.filter((v) => v.format === formats[0]).map((v) => `${v.url} ${v.width}w`).join(", ");
+      const sizes = config2.sizes ?? "100vw";
+      const blurDataUrl = await adapter.generateBlurPlaceholder(input);
+      return {
+        srcset,
+        sizes,
+        variants,
+        blurDataUrl
+      };
+    }
+  };
+  return adapter;
+};
+var imgix_default = imgix;
+
+export { imgix_default as default, imgix };
+//# sourceMappingURL=imgix.js.map
+//# sourceMappingURL=imgix.js.map