@cibule/image-sharp 0.1.1

package/README.md

@@ -0,0 +1,96 @@
+# @cibule/image-sharp
+
+Sharp-based image transformation for Node.js with FileStorage caching.
+
+## Installation
+
+```bash
+npm install @cibule/image-sharp @cibule/image @cibule/storage
+```
+
+## Usage
+
+```typescript
+import { SharpImageTransformer } from '@cibule/image-sharp';
+import { LocalFileStorage } from '@cibule/storage';
+
+const source = new LocalFileStorage({ basePath: './uploads' });
+const cache = new LocalFileStorage({ basePath: './cache' });
+
+const transformer = new SharpImageTransformer({
+  source,
+  cache,
+  cachePrefix: 'thumbnails', // default: 'thumbnails'
+  defaultFormat: 'avif', // default: 'avif'
+});
+
+// Transform an image — resizes and converts to AVIF
+const result = await transformer.transform('photos/hero.jpg', {
+  width: 800,
+  quality: 80, // default: 80
+  format: 'webp', // overrides defaultFormat
+  fit: 'cover', // default: 'cover'
+});
+
+// result.body — ReadableStream<Uint8Array>
+// result.contentType — 'image/webp'
+// result.width — 800
+// result.height — computed by Sharp
+// result.size — byte size of transformed image
+
+// Subsequent calls with same key + options serve from cache
+const cached = await transformer.transform('photos/hero.jpg', { width: 800 });
+
+// Purge all cached thumbnails
+const purgeResult = await transformer.purgeCache();
+// purgeResult.purgedCount — number of deleted cache entries
+```
+
+## Configuration
+
+| Option          | Type          | Default        | Description                          |
+| --------------- | ------------- | -------------- | ------------------------------------ |
+| `source`        | `FileStorage` | _(required)_   | Storage driver for source images     |
+| `cache`         | `FileStorage` | _(required)_   | Storage driver for cached thumbnails |
+| `cachePrefix`   | `string`      | `'thumbnails'` | Key prefix for cached images         |
+| `defaultFormat` | `ImageFormat` | `'avif'`       | Output format when not specified     |
+
+## Supported Formats
+
+- `avif` — best compression, modern browsers
+- `webp` — good compression, wide support
+- `jpeg` — universal compatibility
+- `png` — lossless, transparency support
+
+## Caching
+
+Transformed images are stored in the `cache` FileStorage under a deterministic key:
+
+```
+{cachePrefix}/{sourceKey}/w{width}_q{quality}_{format}_{fit}
+```
+
+Cache hits skip the Sharp transformation entirely and serve directly from storage.
+
+## API
+
+### `SharpImageTransformer`
+
+Extends `ImageTransformer` from `@cibule/image`.
+
+#### `transform(key: string, options: TransformOptions): Promise<TransformResult>`
+
+Downloads the source image, resizes and converts it using Sharp, caches the result, and returns a `TransformResult` with the transformed image body and metadata.
+
+#### `purgeCache(): Promise<PurgeCacheResult>`
+
+Deletes all cached images under the configured `cachePrefix`. Returns the number of purged entries.
+
+## Requirements
+
+- Node.js (Sharp requires native binaries — not compatible with Cloudflare Workers)
+- For CF Workers, use `@cibule/image-cf` instead
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,166 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  SharpImageTransformer: () => SharpImageTransformer
+});
+module.exports = __toCommonJS(index_exports);
+
+// ../image/src/lib/constants.ts
+var DEFAULT_QUALITY = 80;
+var DEFAULT_MAX_SOURCE_SIZE = 60 * 1024 * 1024;
+
+// ../image/src/lib/content-type-map.ts
+var FORMAT_TO_CONTENT_TYPE = {
+  avif: "image/avif",
+  webp: "image/webp",
+  jpeg: "image/jpeg",
+  png: "image/png"
+};
+function getContentType(format) {
+  return FORMAT_TO_CONTENT_TYPE[format];
+}
+
+// ../image/src/lib/image-transformer.ts
+var ImageTransformer = class {
+};
+
+// ../storage/src/lib/create-readable-stream.ts
+function createReadableStream(data) {
+  return new ReadableStream({
+    start(controller) {
+      controller.enqueue(new Uint8Array(data));
+      controller.close();
+    }
+  });
+}
+
+// ../storage/src/lib/concat-uint8-arrays.ts
+function concatUint8Arrays(chunks) {
+  if (chunks.length === 0) {
+    return new Uint8Array(0);
+  }
+  if (chunks.length === 1) {
+    return chunks[0] ?? new Uint8Array(0);
+  }
+  const totalLength = chunks.reduce((sum, c) => sum + c.byteLength, 0);
+  const result = new Uint8Array(totalLength);
+  let offset = 0;
+  for (const chunk of chunks) {
+    result.set(chunk, offset);
+    offset += chunk.byteLength;
+  }
+  return result;
+}
+
+// ../storage/src/lib/to-uint8-array.ts
+async function toUint8Array(input) {
+  if (input instanceof Uint8Array) {
+    return input;
+  }
+  if (input instanceof ArrayBuffer) {
+    return new Uint8Array(input);
+  }
+  const reader = input.getReader();
+  const chunks = [];
+  for (; ; ) {
+    const { done, value } = await reader.read();
+    if (done) break;
+    chunks.push(value);
+  }
+  return concatUint8Arrays(chunks);
+}
+
+// src/lib/sharp-image-transformer.ts
+var import_sharp = __toESM(require("sharp"), 1);
+
+// src/lib/cache-key.ts
+function buildCacheKey(sourceKey, options, prefix) {
+  return `${prefix}/${sourceKey}/w${String(options.width)}_q${String(options.quality)}_${options.format}_${options.fit}`;
+}
+
+// src/lib/sharp-image-transformer.ts
+var SharpImageTransformer = class extends ImageTransformer {
+  constructor(config) {
+    super();
+    this.config = config;
+    this.cachePrefix = config.cachePrefix ?? "thumbnails";
+  }
+  cachePrefix;
+  async transform(key, options) {
+    const format = options.format ?? this.config.defaultFormat ?? "avif";
+    const quality = options.quality ?? DEFAULT_QUALITY;
+    const fit = options.fit ?? "cover";
+    const cacheKey = buildCacheKey(
+      key,
+      { width: options.width, format, quality, fit },
+      this.cachePrefix
+    );
+    const cached = await this.config.cache.head(cacheKey);
+    if (cached) {
+      return this.serveCached(cacheKey, cached.size, cached.contentType ?? getContentType(format));
+    }
+    const sourceObject = await this.config.source.download(key);
+    const sourceBytes = await toUint8Array(sourceObject.body);
+    const { data, info } = await (0, import_sharp.default)(sourceBytes).resize({ width: options.width, fit }).toFormat(format, { quality }).toBuffer({ resolveWithObject: true });
+    const contentType = getContentType(format);
+    await this.config.cache.upload(cacheKey, data, { contentType });
+    return {
+      body: createReadableStream(data),
+      contentType,
+      width: info.width,
+      height: info.height,
+      size: info.size
+    };
+  }
+  async purgeCache() {
+    const keys = await this.config.cache.listKeys(this.cachePrefix);
+    await Promise.all(keys.map((k) => this.config.cache.delete(k)));
+    return { purgedCount: keys.length };
+  }
+  async serveCached(cacheKey, size, contentType) {
+    const cached = await this.config.cache.download(cacheKey);
+    const bytes = await toUint8Array(cached.body);
+    const metadata = await (0, import_sharp.default)(bytes).metadata();
+    return {
+      body: createReadableStream(bytes),
+      contentType,
+      width: metadata.width ?? 0,
+      height: metadata.height ?? 0,
+      size
+    };
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  SharpImageTransformer
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/index.ts", "../../image/src/lib/constants.ts", "../../image/src/lib/content-type-map.ts", "../../image/src/lib/image-transformer.ts", "../../storage/src/lib/create-readable-stream.ts", "../../storage/src/lib/concat-uint8-arrays.ts", "../../storage/src/lib/to-uint8-array.ts", "../src/lib/sharp-image-transformer.ts", "../src/lib/cache-key.ts"],
+  "sourcesContent": ["export { SharpImageTransformer } from './lib/sharp-image-transformer';\nexport type { SharpImageTransformerConfig } from './lib/sharp-image-transformer-config';\n", "export const ALLOWED_WIDTHS = [384, 640, 750, 828, 1080, 1200, 1920] as const;\n\nexport const ALLOWED_PLACEHOLDER_WIDTHS = [20, 30, 50, 80] as const;\n\nexport const DEFAULT_QUALITY = 80;\n\nexport const DEFAULT_MAX_SOURCE_SIZE = 60 * 1024 * 1024;\n", "import type { ImageFormat } from './transform-options';\n\nconst FORMAT_TO_CONTENT_TYPE: Record<ImageFormat, string> = {\n  avif: 'image/avif',\n  webp: 'image/webp',\n  jpeg: 'image/jpeg',\n  png: 'image/png',\n};\n\nexport function getContentType(format: ImageFormat): string {\n  return FORMAT_TO_CONTENT_TYPE[format];\n}\n", "import type { PurgeCacheResult, TransformOptions, TransformResult } from './transform-options';\n\nexport abstract class ImageTransformer {\n  abstract transform(key: string, options: TransformOptions): Promise<TransformResult>;\n  abstract purgeCache(): Promise<PurgeCacheResult>;\n}\n", "export function createReadableStream(data: Uint8Array): ReadableStream<Uint8Array> {\n  return new ReadableStream<Uint8Array>({\n    start(controller): void {\n      controller.enqueue(new Uint8Array(data));\n      controller.close();\n    },\n  });\n}\n", "export function concatUint8Arrays(chunks: Uint8Array[]): Uint8Array {\n  if (chunks.length === 0) {\n    return new Uint8Array(0);\n  }\n\n  if (chunks.length === 1) {\n    return chunks[0] ?? new Uint8Array(0);\n  }\n\n  const totalLength = chunks.reduce((sum, c) => sum + c.byteLength, 0);\n  const result = new Uint8Array(totalLength);\n  let offset = 0;\n  for (const chunk of chunks) {\n    result.set(chunk, offset);\n    offset += chunk.byteLength;\n  }\n\n  return result;\n}\n", "import { concatUint8Arrays } from './concat-uint8-arrays';\n\nexport async function toUint8Array(\n  input: ReadableStream<Uint8Array> | ArrayBuffer | Uint8Array,\n): Promise<Uint8Array> {\n  if (input instanceof Uint8Array) {\n    return input;\n  }\n\n  if (input instanceof ArrayBuffer) {\n    return new Uint8Array(input);\n  }\n\n  const reader = input.getReader();\n  const chunks: Uint8Array[] = [];\n\n  for (;;) {\n    const { done, value } = await reader.read();\n    if (done) break;\n    chunks.push(value);\n  }\n\n  return concatUint8Arrays(chunks);\n}\n", "import type { PurgeCacheResult, TransformOptions, TransformResult } from '@cibule/image';\nimport { DEFAULT_QUALITY, getContentType, ImageTransformer } from '@cibule/image';\nimport { createReadableStream, toUint8Array } from '@cibule/storage';\nimport sharp from 'sharp';\n\nimport { buildCacheKey } from './cache-key';\nimport type { SharpImageTransformerConfig } from './sharp-image-transformer-config';\n\nexport class SharpImageTransformer extends ImageTransformer {\n  private readonly cachePrefix: string;\n\n  public constructor(private readonly config: SharpImageTransformerConfig) {\n    super();\n    this.cachePrefix = config.cachePrefix ?? 'thumbnails';\n  }\n\n  public async transform(key: string, options: TransformOptions): Promise<TransformResult> {\n    const format = options.format ?? this.config.defaultFormat ?? 'avif';\n    const quality = options.quality ?? DEFAULT_QUALITY;\n    const fit = options.fit ?? 'cover';\n    const cacheKey = buildCacheKey(\n      key,\n      { width: options.width, format, quality, fit },\n      this.cachePrefix,\n    );\n\n    const cached = await this.config.cache.head(cacheKey);\n    if (cached) {\n      return this.serveCached(cacheKey, cached.size, cached.contentType ?? getContentType(format));\n    }\n\n    const sourceObject = await this.config.source.download(key);\n    const sourceBytes = await toUint8Array(sourceObject.body);\n\n    const { data, info } = await sharp(sourceBytes)\n      .resize({ width: options.width, fit })\n      .toFormat(format, { quality })\n      .toBuffer({ resolveWithObject: true });\n\n    const contentType = getContentType(format);\n    await this.config.cache.upload(cacheKey, data, { contentType });\n\n    return {\n      body: createReadableStream(data),\n      contentType,\n      width: info.width,\n      height: info.height,\n      size: info.size,\n    };\n  }\n\n  public async purgeCache(): Promise<PurgeCacheResult> {\n    const keys = await this.config.cache.listKeys(this.cachePrefix);\n    await Promise.all(keys.map(k => this.config.cache.delete(k)));\n    return { purgedCount: keys.length };\n  }\n\n  private async serveCached(\n    cacheKey: string,\n    size: number,\n    contentType: string,\n  ): Promise<TransformResult> {\n    const cached = await this.config.cache.download(cacheKey);\n    const bytes = await toUint8Array(cached.body);\n    const metadata = await sharp(bytes).metadata();\n\n    return {\n      body: createReadableStream(bytes),\n      contentType,\n      width: metadata.width ?? 0,\n      height: metadata.height ?? 0,\n      size,\n    };\n  }\n}\n", "import type { ImageFit, ImageFormat } from '@cibule/image';\n\nexport interface ResolvedTransformOptions {\n  readonly width: number;\n  readonly format: ImageFormat;\n  readonly quality: number;\n  readonly fit: ImageFit;\n}\n\nexport function buildCacheKey(\n  sourceKey: string,\n  options: ResolvedTransformOptions,\n  prefix: string,\n): string {\n  return `${prefix}/${sourceKey}/w${String(options.width)}_q${String(options.quality)}_${options.format}_${options.fit}`;\n}\n"],
+  "mappings": "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",
+  "names": ["sharp"]
+}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { SharpImageTransformer } from './lib/sharp-image-transformer';
+export type { SharpImageTransformerConfig } from './lib/sharp-image-transformer-config';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,YAAY,EAAE,2BAA2B,EAAE,MAAM,sCAAsC,CAAC"}

package/dist/index.js

@@ -0,0 +1,129 @@
+// ../image/src/lib/constants.ts
+var DEFAULT_QUALITY = 80;
+var DEFAULT_MAX_SOURCE_SIZE = 60 * 1024 * 1024;
+
+// ../image/src/lib/content-type-map.ts
+var FORMAT_TO_CONTENT_TYPE = {
+  avif: "image/avif",
+  webp: "image/webp",
+  jpeg: "image/jpeg",
+  png: "image/png"
+};
+function getContentType(format) {
+  return FORMAT_TO_CONTENT_TYPE[format];
+}
+
+// ../image/src/lib/image-transformer.ts
+var ImageTransformer = class {
+};
+
+// ../storage/src/lib/create-readable-stream.ts
+function createReadableStream(data) {
+  return new ReadableStream({
+    start(controller) {
+      controller.enqueue(new Uint8Array(data));
+      controller.close();
+    }
+  });
+}
+
+// ../storage/src/lib/concat-uint8-arrays.ts
+function concatUint8Arrays(chunks) {
+  if (chunks.length === 0) {
+    return new Uint8Array(0);
+  }
+  if (chunks.length === 1) {
+    return chunks[0] ?? new Uint8Array(0);
+  }
+  const totalLength = chunks.reduce((sum, c) => sum + c.byteLength, 0);
+  const result = new Uint8Array(totalLength);
+  let offset = 0;
+  for (const chunk of chunks) {
+    result.set(chunk, offset);
+    offset += chunk.byteLength;
+  }
+  return result;
+}
+
+// ../storage/src/lib/to-uint8-array.ts
+async function toUint8Array(input) {
+  if (input instanceof Uint8Array) {
+    return input;
+  }
+  if (input instanceof ArrayBuffer) {
+    return new Uint8Array(input);
+  }
+  const reader = input.getReader();
+  const chunks = [];
+  for (; ; ) {
+    const { done, value } = await reader.read();
+    if (done) break;
+    chunks.push(value);
+  }
+  return concatUint8Arrays(chunks);
+}
+
+// src/lib/sharp-image-transformer.ts
+import sharp from "sharp";
+
+// src/lib/cache-key.ts
+function buildCacheKey(sourceKey, options, prefix) {
+  return `${prefix}/${sourceKey}/w${String(options.width)}_q${String(options.quality)}_${options.format}_${options.fit}`;
+}
+
+// src/lib/sharp-image-transformer.ts
+var SharpImageTransformer = class extends ImageTransformer {
+  constructor(config) {
+    super();
+    this.config = config;
+    this.cachePrefix = config.cachePrefix ?? "thumbnails";
+  }
+  cachePrefix;
+  async transform(key, options) {
+    const format = options.format ?? this.config.defaultFormat ?? "avif";
+    const quality = options.quality ?? DEFAULT_QUALITY;
+    const fit = options.fit ?? "cover";
+    const cacheKey = buildCacheKey(
+      key,
+      { width: options.width, format, quality, fit },
+      this.cachePrefix
+    );
+    const cached = await this.config.cache.head(cacheKey);
+    if (cached) {
+      return this.serveCached(cacheKey, cached.size, cached.contentType ?? getContentType(format));
+    }
+    const sourceObject = await this.config.source.download(key);
+    const sourceBytes = await toUint8Array(sourceObject.body);
+    const { data, info } = await sharp(sourceBytes).resize({ width: options.width, fit }).toFormat(format, { quality }).toBuffer({ resolveWithObject: true });
+    const contentType = getContentType(format);
+    await this.config.cache.upload(cacheKey, data, { contentType });
+    return {
+      body: createReadableStream(data),
+      contentType,
+      width: info.width,
+      height: info.height,
+      size: info.size
+    };
+  }
+  async purgeCache() {
+    const keys = await this.config.cache.listKeys(this.cachePrefix);
+    await Promise.all(keys.map((k) => this.config.cache.delete(k)));
+    return { purgedCount: keys.length };
+  }
+  async serveCached(cacheKey, size, contentType) {
+    const cached = await this.config.cache.download(cacheKey);
+    const bytes = await toUint8Array(cached.body);
+    const metadata = await sharp(bytes).metadata();
+    return {
+      body: createReadableStream(bytes),
+      contentType,
+      width: metadata.width ?? 0,
+      height: metadata.height ?? 0,
+      size
+    };
+  }
+};
+export {
+  SharpImageTransformer
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../image/src/lib/constants.ts", "../../image/src/lib/content-type-map.ts", "../../image/src/lib/image-transformer.ts", "../../storage/src/lib/create-readable-stream.ts", "../../storage/src/lib/concat-uint8-arrays.ts", "../../storage/src/lib/to-uint8-array.ts", "../src/lib/sharp-image-transformer.ts", "../src/lib/cache-key.ts"],
+  "sourcesContent": ["export const ALLOWED_WIDTHS = [384, 640, 750, 828, 1080, 1200, 1920] as const;\n\nexport const ALLOWED_PLACEHOLDER_WIDTHS = [20, 30, 50, 80] as const;\n\nexport const DEFAULT_QUALITY = 80;\n\nexport const DEFAULT_MAX_SOURCE_SIZE = 60 * 1024 * 1024;\n", "import type { ImageFormat } from './transform-options';\n\nconst FORMAT_TO_CONTENT_TYPE: Record<ImageFormat, string> = {\n  avif: 'image/avif',\n  webp: 'image/webp',\n  jpeg: 'image/jpeg',\n  png: 'image/png',\n};\n\nexport function getContentType(format: ImageFormat): string {\n  return FORMAT_TO_CONTENT_TYPE[format];\n}\n", "import type { PurgeCacheResult, TransformOptions, TransformResult } from './transform-options';\n\nexport abstract class ImageTransformer {\n  abstract transform(key: string, options: TransformOptions): Promise<TransformResult>;\n  abstract purgeCache(): Promise<PurgeCacheResult>;\n}\n", "export function createReadableStream(data: Uint8Array): ReadableStream<Uint8Array> {\n  return new ReadableStream<Uint8Array>({\n    start(controller): void {\n      controller.enqueue(new Uint8Array(data));\n      controller.close();\n    },\n  });\n}\n", "export function concatUint8Arrays(chunks: Uint8Array[]): Uint8Array {\n  if (chunks.length === 0) {\n    return new Uint8Array(0);\n  }\n\n  if (chunks.length === 1) {\n    return chunks[0] ?? new Uint8Array(0);\n  }\n\n  const totalLength = chunks.reduce((sum, c) => sum + c.byteLength, 0);\n  const result = new Uint8Array(totalLength);\n  let offset = 0;\n  for (const chunk of chunks) {\n    result.set(chunk, offset);\n    offset += chunk.byteLength;\n  }\n\n  return result;\n}\n", "import { concatUint8Arrays } from './concat-uint8-arrays';\n\nexport async function toUint8Array(\n  input: ReadableStream<Uint8Array> | ArrayBuffer | Uint8Array,\n): Promise<Uint8Array> {\n  if (input instanceof Uint8Array) {\n    return input;\n  }\n\n  if (input instanceof ArrayBuffer) {\n    return new Uint8Array(input);\n  }\n\n  const reader = input.getReader();\n  const chunks: Uint8Array[] = [];\n\n  for (;;) {\n    const { done, value } = await reader.read();\n    if (done) break;\n    chunks.push(value);\n  }\n\n  return concatUint8Arrays(chunks);\n}\n", "import type { PurgeCacheResult, TransformOptions, TransformResult } from '@cibule/image';\nimport { DEFAULT_QUALITY, getContentType, ImageTransformer } from '@cibule/image';\nimport { createReadableStream, toUint8Array } from '@cibule/storage';\nimport sharp from 'sharp';\n\nimport { buildCacheKey } from './cache-key';\nimport type { SharpImageTransformerConfig } from './sharp-image-transformer-config';\n\nexport class SharpImageTransformer extends ImageTransformer {\n  private readonly cachePrefix: string;\n\n  public constructor(private readonly config: SharpImageTransformerConfig) {\n    super();\n    this.cachePrefix = config.cachePrefix ?? 'thumbnails';\n  }\n\n  public async transform(key: string, options: TransformOptions): Promise<TransformResult> {\n    const format = options.format ?? this.config.defaultFormat ?? 'avif';\n    const quality = options.quality ?? DEFAULT_QUALITY;\n    const fit = options.fit ?? 'cover';\n    const cacheKey = buildCacheKey(\n      key,\n      { width: options.width, format, quality, fit },\n      this.cachePrefix,\n    );\n\n    const cached = await this.config.cache.head(cacheKey);\n    if (cached) {\n      return this.serveCached(cacheKey, cached.size, cached.contentType ?? getContentType(format));\n    }\n\n    const sourceObject = await this.config.source.download(key);\n    const sourceBytes = await toUint8Array(sourceObject.body);\n\n    const { data, info } = await sharp(sourceBytes)\n      .resize({ width: options.width, fit })\n      .toFormat(format, { quality })\n      .toBuffer({ resolveWithObject: true });\n\n    const contentType = getContentType(format);\n    await this.config.cache.upload(cacheKey, data, { contentType });\n\n    return {\n      body: createReadableStream(data),\n      contentType,\n      width: info.width,\n      height: info.height,\n      size: info.size,\n    };\n  }\n\n  public async purgeCache(): Promise<PurgeCacheResult> {\n    const keys = await this.config.cache.listKeys(this.cachePrefix);\n    await Promise.all(keys.map(k => this.config.cache.delete(k)));\n    return { purgedCount: keys.length };\n  }\n\n  private async serveCached(\n    cacheKey: string,\n    size: number,\n    contentType: string,\n  ): Promise<TransformResult> {\n    const cached = await this.config.cache.download(cacheKey);\n    const bytes = await toUint8Array(cached.body);\n    const metadata = await sharp(bytes).metadata();\n\n    return {\n      body: createReadableStream(bytes),\n      contentType,\n      width: metadata.width ?? 0,\n      height: metadata.height ?? 0,\n      size,\n    };\n  }\n}\n", "import type { ImageFit, ImageFormat } from '@cibule/image';\n\nexport interface ResolvedTransformOptions {\n  readonly width: number;\n  readonly format: ImageFormat;\n  readonly quality: number;\n  readonly fit: ImageFit;\n}\n\nexport function buildCacheKey(\n  sourceKey: string,\n  options: ResolvedTransformOptions,\n  prefix: string,\n): string {\n  return `${prefix}/${sourceKey}/w${String(options.width)}_q${String(options.quality)}_${options.format}_${options.fit}`;\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/lib/cache-key.d.ts

@@ -0,0 +1,9 @@
+import type { ImageFit, ImageFormat } from '@cibule/image';
+export interface ResolvedTransformOptions {
+    readonly width: number;
+    readonly format: ImageFormat;
+    readonly quality: number;
+    readonly fit: ImageFit;
+}
+export declare function buildCacheKey(sourceKey: string, options: ResolvedTransformOptions, prefix: string): string;
+//# sourceMappingURL=cache-key.d.ts.map

package/dist/lib/cache-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-key.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/cache-key.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE3D,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC;CACxB;AAED,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,wBAAwB,EACjC,MAAM,EAAE,MAAM,GACb,MAAM,CAER"}

package/dist/lib/sharp-image-transformer-config.d.ts

@@ -0,0 +1,9 @@
+import type { ImageFormat } from '@cibule/image';
+import type { FileStorage } from '@cibule/storage';
+export interface SharpImageTransformerConfig {
+    readonly source: FileStorage;
+    readonly cache: FileStorage;
+    readonly cachePrefix?: string;
+    readonly defaultFormat?: ImageFormat;
+}
+//# sourceMappingURL=sharp-image-transformer-config.d.ts.map

package/dist/lib/sharp-image-transformer-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sharp-image-transformer-config.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/sharp-image-transformer-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,WAAW,CAAC;CACtC"}

package/dist/lib/sharp-image-transformer.d.ts

@@ -0,0 +1,12 @@
+import type { PurgeCacheResult, TransformOptions, TransformResult } from '@cibule/image';
+import { ImageTransformer } from '@cibule/image';
+import type { SharpImageTransformerConfig } from './sharp-image-transformer-config';
+export declare class SharpImageTransformer extends ImageTransformer {
+    private readonly config;
+    private readonly cachePrefix;
+    constructor(config: SharpImageTransformerConfig);
+    transform(key: string, options: TransformOptions): Promise<TransformResult>;
+    purgeCache(): Promise<PurgeCacheResult>;
+    private serveCached;
+}
+//# sourceMappingURL=sharp-image-transformer.d.ts.map

package/dist/lib/sharp-image-transformer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sharp-image-transformer.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/sharp-image-transformer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACzF,OAAO,EAAmC,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAKlF,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAEpF,qBAAa,qBAAsB,SAAQ,gBAAgB;IAGtC,OAAO,CAAC,QAAQ,CAAC,MAAM;IAF1C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAED,MAAM,EAAE,2BAA2B;IAK1D,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;IAmC3E,UAAU,IAAI,OAAO,CAAC,gBAAgB,CAAC;YAMtC,WAAW;CAiB1B"}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@cibule/image-sharp",
+  "version": "0.1.1",
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/index.cjs",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "repository": {
+    "type": "git",
+    "url": "https://gitlab.com/LadaBr/cibule",
+    "directory": "packages/image-sharp"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@cibule/image": "workspace:*",
+    "@cibule/storage": "workspace:*",
+    "sharp": "^0.33.0"
+  }
+}