@mr-aftab-ahmad-khan/imago 0.1.0

package/dist/index.cjs

@@ -0,0 +1,436 @@
+"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 src_exports = {};
+__export(src_exports, {
+  DimensionLimitError: () => DimensionLimitError,
+  DiskCache: () => DiskCache,
+  FileSystemSource: () => FileSystemSource,
+  ImagoError: () => ImagoError,
+  LruCache: () => LruCache,
+  SourceNotFoundError: () => SourceNotFoundError,
+  TransformOptionsSchema: () => TransformOptionsSchema,
+  UnsupportedFormatError: () => UnsupportedFormatError,
+  handle: () => handle,
+  imago: () => imago,
+  imagoFastify: () => imagoFastify,
+  imagoHono: () => imagoHono,
+  makeCacheKey: () => makeCacheKey,
+  pickFormat: () => pickFormat,
+  transform: () => transform
+});
+module.exports = __toCommonJS(src_exports);
+
+// src/middleware.ts
+var import_node_fs3 = require("fs");
+
+// src/types.ts
+var import_zod = require("zod");
+var FORMATS = ["jpeg", "png", "webp", "avif", "auto"];
+var FITS = ["cover", "contain", "fill", "inside", "outside"];
+var GRAVITIES = ["center", "north", "south", "east", "west", "smart"];
+var TransformOptionsSchema = import_zod.z.object({
+  w: import_zod.z.coerce.number().int().min(1).max(4e3).optional(),
+  h: import_zod.z.coerce.number().int().min(1).max(4e3).optional(),
+  fit: import_zod.z.enum(FITS).default("cover"),
+  format: import_zod.z.enum(FORMATS).default("auto"),
+  q: import_zod.z.coerce.number().int().min(1).max(100).optional(),
+  blur: import_zod.z.coerce.number().min(0.3).max(1e3).optional(),
+  gravity: import_zod.z.enum(GRAVITIES).default("center"),
+  strip: import_zod.z.coerce.boolean().default(false),
+  sharpen: import_zod.z.coerce.boolean().default(false),
+  placeholder: import_zod.z.enum(["blur"]).optional()
+});
+
+// src/source.ts
+var import_node_fs = require("fs");
+var import_node_path = require("path");
+
+// src/errors.ts
+var ImagoError = class _ImagoError extends Error {
+  status;
+  constructor(message, status) {
+    super(message);
+    this.name = "ImagoError";
+    this.status = status;
+    Object.setPrototypeOf(this, _ImagoError.prototype);
+  }
+};
+var DimensionLimitError = class _DimensionLimitError extends ImagoError {
+  constructor(requested, max) {
+    super(`Requested dimension ${requested} exceeds maximum ${max}`, 413);
+    this.requested = requested;
+    this.max = max;
+    this.name = "DimensionLimitError";
+    Object.setPrototypeOf(this, _DimensionLimitError.prototype);
+  }
+  requested;
+  max;
+};
+var UnsupportedFormatError = class _UnsupportedFormatError extends ImagoError {
+  constructor(format) {
+    super(`Unsupported image format: ${format}`, 400);
+    this.format = format;
+    this.name = "UnsupportedFormatError";
+    Object.setPrototypeOf(this, _UnsupportedFormatError.prototype);
+  }
+  format;
+};
+var SourceNotFoundError = class _SourceNotFoundError extends ImagoError {
+  constructor(key) {
+    super(`Source image not found: ${key}`, 404);
+    this.key = key;
+    this.name = "SourceNotFoundError";
+    Object.setPrototypeOf(this, _SourceNotFoundError.prototype);
+  }
+  key;
+};
+
+// src/source.ts
+var FileSystemSource = class {
+  root;
+  constructor(root) {
+    this.root = (0, import_node_path.resolve)(root);
+  }
+  async fetch(key) {
+    const abs = (0, import_node_path.resolve)(this.root, key);
+    if (!abs.startsWith(this.root + import_node_path.sep) && abs !== this.root) {
+      throw new SourceNotFoundError(key);
+    }
+    if (!(0, import_node_fs.existsSync)(abs)) return void 0;
+    const buffer = (0, import_node_fs.readFileSync)(abs);
+    return { buffer, mimeType: mimeFromExtension(abs) };
+  }
+};
+function mimeFromExtension(path) {
+  const ext = path.toLowerCase().slice(path.lastIndexOf(".") + 1);
+  switch (ext) {
+    case "jpg":
+    case "jpeg":
+      return "image/jpeg";
+    case "png":
+      return "image/png";
+    case "webp":
+      return "image/webp";
+    case "avif":
+      return "image/avif";
+    case "gif":
+      return "image/gif";
+    case "bmp":
+      return "image/bmp";
+    default:
+      return "application/octet-stream";
+  }
+}
+
+// src/transform.ts
+var import_node_crypto = require("crypto");
+var _sharp;
+async function loadSharp() {
+  if (!_sharp) {
+    try {
+      const mod = await import(
+        /* @vite-ignore */
+        "sharp"
+      );
+      _sharp = mod.default;
+    } catch (err) {
+      throw new Error(
+        "imago requires `sharp >= 0.33.0` as a peer dependency. Install it with `npm install sharp`."
+      );
+    }
+  }
+  return _sharp;
+}
+var QUALITY_DEFAULTS = {
+  jpeg: 82,
+  webp: 80,
+  avif: 65,
+  png: 90
+};
+function pickFormat(requested, accept, sourceFormat) {
+  if (requested !== "auto") return requested;
+  const a = (accept ?? "").toLowerCase();
+  if (a.includes("image/avif")) return "avif";
+  if (a.includes("image/webp")) return "webp";
+  if (sourceFormat === "png") return "png";
+  return "jpeg";
+}
+async function transform(input) {
+  const opts = TransformOptionsSchema.parse(input.options);
+  const maxDim = input.maxDimension ?? 4e3;
+  if (opts.w && opts.w > maxDim) throw new DimensionLimitError(opts.w, maxDim);
+  if (opts.h && opts.h > maxDim) throw new DimensionLimitError(opts.h, maxDim);
+  const sharp = await loadSharp();
+  let pipeline = sharp(input.source).rotate();
+  const meta = await pipeline.metadata();
+  const finalFormat = pickFormat(opts.format, input.accept, meta.format);
+  if (!["jpeg", "png", "webp", "avif"].includes(finalFormat)) {
+    throw new UnsupportedFormatError(finalFormat);
+  }
+  if (opts.placeholder === "blur") {
+    const buf = await sharp(input.source).resize({ width: 8, height: 8, fit: "cover" }).blur(2).toFormat("webp", { quality: 50 }).toBuffer();
+    return {
+      buffer: buf,
+      mimeType: "image/webp",
+      etag: hashEtag(buf)
+    };
+  }
+  if (opts.w || opts.h) {
+    pipeline = pipeline.resize({
+      ...opts.w !== void 0 ? { width: opts.w } : {},
+      ...opts.h !== void 0 ? { height: opts.h } : {},
+      fit: opts.fit,
+      ...opts.gravity === "smart" ? { position: "attention" } : { position: opts.gravity }
+    });
+  }
+  if (opts.blur !== void 0) pipeline = pipeline.blur(opts.blur);
+  if (opts.sharpen) pipeline = pipeline.sharpen();
+  if (!opts.strip) pipeline = pipeline.withMetadata();
+  const quality = opts.q ?? QUALITY_DEFAULTS[finalFormat] ?? 80;
+  pipeline = pipeline.toFormat(finalFormat, { quality });
+  const buffer = await pipeline.toBuffer();
+  return {
+    buffer,
+    mimeType: `image/${finalFormat}`,
+    etag: hashEtag(buffer)
+  };
+}
+function hashEtag(buf) {
+  return `"${(0, import_node_crypto.createHash)("md5").update(buf).digest("hex")}"`;
+}
+
+// src/cache.ts
+var import_node_crypto2 = require("crypto");
+var import_node_fs2 = require("fs");
+var import_node_path2 = require("path");
+function makeCacheKey(sourceKey, opts, mtime) {
+  const json = JSON.stringify({ sourceKey, opts, mtime });
+  return (0, import_node_crypto2.createHash)("sha1").update(json).digest("hex");
+}
+var LruCache = class {
+  constructor(maxItems = 256) {
+    this.maxItems = maxItems;
+  }
+  maxItems;
+  map = /* @__PURE__ */ new Map();
+  get(key) {
+    const v = this.map.get(key);
+    if (!v) return void 0;
+    this.map.delete(key);
+    this.map.set(key, v);
+    return v;
+  }
+  set(key, entry) {
+    if (this.map.has(key)) this.map.delete(key);
+    this.map.set(key, entry);
+    while (this.map.size > this.maxItems) {
+      const firstKey = this.map.keys().next().value;
+      if (firstKey === void 0) break;
+      this.map.delete(firstKey);
+    }
+  }
+};
+var DiskCache = class {
+  constructor(dir) {
+    this.dir = dir;
+    if (!(0, import_node_fs2.existsSync)(dir)) (0, import_node_fs2.mkdirSync)(dir, { recursive: true });
+  }
+  dir;
+  file(key) {
+    return (0, import_node_path2.join)(this.dir, key);
+  }
+  meta(key) {
+    return (0, import_node_path2.join)(this.dir, `${key}.json`);
+  }
+  get(key) {
+    if (!(0, import_node_fs2.existsSync)(this.file(key))) return void 0;
+    try {
+      const meta = JSON.parse((0, import_node_fs2.readFileSync)(this.meta(key), "utf8"));
+      const stat = (0, import_node_fs2.statSync)(this.file(key));
+      return {
+        buffer: (0, import_node_fs2.readFileSync)(this.file(key)),
+        mimeType: meta.mimeType,
+        etag: meta.etag,
+        lastModified: stat.mtime
+      };
+    } catch {
+      return void 0;
+    }
+  }
+  set(key, entry) {
+    (0, import_node_fs2.writeFileSync)(this.file(key), entry.buffer);
+    (0, import_node_fs2.writeFileSync)(this.meta(key), JSON.stringify({ mimeType: entry.mimeType, etag: entry.etag }), "utf8");
+  }
+};
+
+// src/middleware.ts
+function resolveSource(opts) {
+  if (typeof opts.source === "string") return new FileSystemSource(opts.source);
+  return opts.source;
+}
+function resolveCache(opts) {
+  if (!opts.cache) return new LruCache();
+  if (typeof opts.cache === "string") return new DiskCache(opts.cache);
+  if (opts.cache.dir) return new DiskCache(opts.cache.dir);
+  return new LruCache(opts.cache.maxItems ?? 256);
+}
+async function handle(opts, key, rawQuery, reqHeaders) {
+  const source = resolveSource(opts);
+  const cache = resolveCache(opts);
+  const maxAge = opts.maxAge ?? 86400;
+  const parsed = TransformOptionsSchema.safeParse(rawQuery);
+  if (!parsed.success) {
+    return jsonError(400, parsed.error.message);
+  }
+  const tOpts = parsed.data;
+  const fetched = await source.fetch(key);
+  if (!fetched) {
+    return jsonError(404, "Source not found", key);
+  }
+  let mtime = 0;
+  if (typeof opts.source === "string") {
+    try {
+      mtime = (0, import_node_fs3.statSync)(`${opts.source}/${key}`).mtimeMs;
+    } catch {
+    }
+  }
+  const cacheKey = makeCacheKey(key, tOpts, mtime);
+  const cached = cache.get(cacheKey);
+  const accept = reqHeaders["accept"];
+  let result;
+  if (cached) {
+    result = cached;
+  } else {
+    try {
+      const transformed = await transform({
+        source: fetched.buffer,
+        options: tOpts,
+        ...accept !== void 0 ? { accept } : {},
+        ...opts.maxDimension !== void 0 ? { maxDimension: opts.maxDimension } : {}
+      });
+      result = { ...transformed, lastModified: /* @__PURE__ */ new Date() };
+      cache.set(cacheKey, result);
+    } catch (err) {
+      if (err instanceof ImagoError) return jsonError(err.status, err.message);
+      throw err;
+    }
+  }
+  const ifNoneMatch = reqHeaders["if-none-match"];
+  if (ifNoneMatch && ifNoneMatch === result.etag) {
+    return { status: 304, headers: { ETag: result.etag }, body: Buffer.alloc(0) };
+  }
+  return {
+    status: 200,
+    headers: {
+      "content-type": result.mimeType,
+      "cache-control": `public, max-age=${maxAge}, immutable`,
+      etag: result.etag,
+      "last-modified": result.lastModified.toUTCString(),
+      "content-length": String(result.buffer.length)
+    },
+    body: result.buffer
+  };
+}
+function jsonError(status, message, extra) {
+  const body = Buffer.from(JSON.stringify({ error: message, key: extra }));
+  return {
+    status,
+    headers: { "content-type": "application/json", "content-length": String(body.length) },
+    body
+  };
+}
+function imago(opts) {
+  return async (req, res, next) => {
+    try {
+      const url = new URL(req.url ?? "/", "http://localhost");
+      const key = decodeURIComponent(url.pathname.replace(/^\//, ""));
+      const query = {};
+      url.searchParams.forEach((v, k) => {
+        query[k] = v;
+      });
+      const result = await handle(opts, key, query, req.headers ?? {});
+      res.status(result.status);
+      for (const [k, v] of Object.entries(result.headers)) res.setHeader(k, v);
+      res.end(result.body);
+    } catch (err) {
+      next(err);
+    }
+  };
+}
+function imagoHono(opts) {
+  return async (c) => {
+    const url = new URL(c.req.url);
+    const key = decodeURIComponent(url.pathname.replace(/^\//, ""));
+    const query = {};
+    url.searchParams.forEach((v, k) => {
+      query[k] = v;
+    });
+    const reqHeaders = {};
+    c.req.headers.forEach((v, k) => {
+      reqHeaders[k.toLowerCase()] = v;
+    });
+    const result = await handle(opts, key, query, reqHeaders);
+    return new Response(result.body, { status: result.status, headers: result.headers });
+  };
+}
+function imagoFastify(opts) {
+  return async (req, reply) => {
+    const url = new URL(req.url, "http://localhost");
+    const key = decodeURIComponent(url.pathname.replace(/^\//, ""));
+    const query = {};
+    url.searchParams.forEach((v, k) => {
+      query[k] = v;
+    });
+    const result = await handle(opts, key, query, req.headers ?? {});
+    reply.code(result.status);
+    for (const [k, v] of Object.entries(result.headers)) reply.header(k, v);
+    reply.send(result.body);
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DimensionLimitError,
+  DiskCache,
+  FileSystemSource,
+  ImagoError,
+  LruCache,
+  SourceNotFoundError,
+  TransformOptionsSchema,
+  UnsupportedFormatError,
+  handle,
+  imago,
+  imagoFastify,
+  imagoHono,
+  makeCacheKey,
+  pickFormat,
+  transform
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/middleware.ts","../src/types.ts","../src/source.ts","../src/errors.ts","../src/transform.ts","../src/cache.ts"],"sourcesContent":["export { imago, imagoHono, imagoFastify, handle } from \"./middleware.js\";\nexport { transform, pickFormat } from \"./transform.js\";\nexport { FileSystemSource } from \"./source.js\";\nexport { LruCache, DiskCache, makeCacheKey } from \"./cache.js\";\nexport {\n  ImagoError,\n  DimensionLimitError,\n  UnsupportedFormatError,\n  SourceNotFoundError,\n} from \"./errors.js\";\nexport type {\n  ImagoOptions,\n  TransformOptions,\n  CacheOptions,\n  SourceAdapter,\n  Format,\n  Fit,\n  Gravity,\n} from \"./types.js\";\nexport { TransformOptionsSchema } from \"./types.js\";\n","import { statSync } from \"node:fs\";\nimport { TransformOptionsSchema, type ImagoOptions, type SourceAdapter, type TransformOptions } from \"./types.js\";\nimport { FileSystemSource } from \"./source.js\";\nimport { transform } from \"./transform.js\";\nimport { DiskCache, LruCache, makeCacheKey, type Cache } from \"./cache.js\";\nimport { ImagoError, SourceNotFoundError } from \"./errors.js\";\n\nfunction resolveSource(opts: ImagoOptions): SourceAdapter {\n  if (typeof opts.source === \"string\") return new FileSystemSource(opts.source);\n  return opts.source;\n}\n\nfunction resolveCache(opts: ImagoOptions): Cache {\n  if (!opts.cache) return new LruCache();\n  if (typeof opts.cache === \"string\") return new DiskCache(opts.cache);\n  if (opts.cache.dir) return new DiskCache(opts.cache.dir);\n  return new LruCache(opts.cache.maxItems ?? 256);\n}\n\nexport interface HandleResult {\n  status: number;\n  headers: Record<string, string>;\n  body: Buffer;\n}\n\nexport async function handle(\n  opts: ImagoOptions,\n  key: string,\n  rawQuery: Record<string, string>,\n  reqHeaders: Record<string, string | undefined>,\n): Promise<HandleResult> {\n  const source = resolveSource(opts);\n  const cache = resolveCache(opts);\n  const maxAge = opts.maxAge ?? 86400;\n\n  const parsed = TransformOptionsSchema.safeParse(rawQuery);\n  if (!parsed.success) {\n    return jsonError(400, parsed.error.message);\n  }\n  const tOpts: TransformOptions = parsed.data;\n\n  const fetched = await source.fetch(key);\n  if (!fetched) {\n    return jsonError(404, \"Source not found\", key);\n  }\n\n  let mtime = 0;\n  if (typeof opts.source === \"string\") {\n    try { mtime = statSync(`${opts.source}/${key}`).mtimeMs; } catch { /* ignore */ }\n  }\n  const cacheKey = makeCacheKey(key, tOpts, mtime);\n\n  const cached = cache.get(cacheKey);\n  const accept = reqHeaders[\"accept\"];\n  let result;\n  if (cached) {\n    result = cached;\n  } else {\n    try {\n      const transformed = await transform({\n        source: fetched.buffer,\n        options: tOpts,\n        ...(accept !== undefined ? { accept } : {}),\n        ...(opts.maxDimension !== undefined ? { maxDimension: opts.maxDimension } : {}),\n      });\n      result = { ...transformed, lastModified: new Date() };\n      cache.set(cacheKey, result);\n    } catch (err) {\n      if (err instanceof ImagoError) return jsonError(err.status, err.message);\n      throw err;\n    }\n  }\n\n  const ifNoneMatch = reqHeaders[\"if-none-match\"];\n  if (ifNoneMatch && ifNoneMatch === result.etag) {\n    return { status: 304, headers: { ETag: result.etag }, body: Buffer.alloc(0) };\n  }\n\n  return {\n    status: 200,\n    headers: {\n      \"content-type\": result.mimeType,\n      \"cache-control\": `public, max-age=${maxAge}, immutable`,\n      etag: result.etag,\n      \"last-modified\": result.lastModified.toUTCString(),\n      \"content-length\": String(result.buffer.length),\n    },\n    body: result.buffer,\n  };\n}\n\nfunction jsonError(status: number, message: string, extra?: string): HandleResult {\n  const body = Buffer.from(JSON.stringify({ error: message, key: extra }));\n  return {\n    status,\n    headers: { \"content-type\": \"application/json\", \"content-length\": String(body.length) },\n    body,\n  };\n}\n\n// -------------------- Express --------------------\nexport function imago(opts: ImagoOptions) {\n  return async (req: any, res: any, next: (err?: unknown) => void) => {\n    try {\n      const url = new URL(req.url ?? \"/\", \"http://localhost\");\n      const key = decodeURIComponent(url.pathname.replace(/^\\//, \"\"));\n      const query: Record<string, string> = {};\n      url.searchParams.forEach((v, k) => { query[k] = v; });\n      const result = await handle(opts, key, query, req.headers ?? {});\n      res.status(result.status);\n      for (const [k, v] of Object.entries(result.headers)) res.setHeader(k, v);\n      res.end(result.body);\n    } catch (err) {\n      next(err);\n    }\n  };\n}\n\n// -------------------- Hono --------------------\nexport function imagoHono(opts: ImagoOptions) {\n  return async (c: any) => {\n    const url = new URL(c.req.url);\n    const key = decodeURIComponent(url.pathname.replace(/^\\//, \"\"));\n    const query: Record<string, string> = {};\n    url.searchParams.forEach((v, k) => { query[k] = v; });\n    const reqHeaders: Record<string, string> = {};\n    c.req.headers.forEach((v: string, k: string) => { reqHeaders[k.toLowerCase()] = v; });\n    const result = await handle(opts, key, query, reqHeaders);\n    return new Response(result.body, { status: result.status, headers: result.headers });\n  };\n}\n\n// -------------------- Fastify --------------------\nexport function imagoFastify(opts: ImagoOptions) {\n  return async (req: any, reply: any) => {\n    const url = new URL(req.url, \"http://localhost\");\n    const key = decodeURIComponent(url.pathname.replace(/^\\//, \"\"));\n    const query: Record<string, string> = {};\n    url.searchParams.forEach((v, k) => { query[k] = v; });\n    const result = await handle(opts, key, query, req.headers ?? {});\n    reply.code(result.status);\n    for (const [k, v] of Object.entries(result.headers)) reply.header(k, v);\n    reply.send(result.body);\n  };\n}\n","import { z } from \"zod\";\n\nexport const FORMATS = [\"jpeg\", \"png\", \"webp\", \"avif\", \"auto\"] as const;\nexport type Format = (typeof FORMATS)[number];\n\nexport const FITS = [\"cover\", \"contain\", \"fill\", \"inside\", \"outside\"] as const;\nexport type Fit = (typeof FITS)[number];\n\nexport const GRAVITIES = [\"center\", \"north\", \"south\", \"east\", \"west\", \"smart\"] as const;\nexport type Gravity = (typeof GRAVITIES)[number];\n\nexport const TransformOptionsSchema = z.object({\n  w: z.coerce.number().int().min(1).max(4000).optional(),\n  h: z.coerce.number().int().min(1).max(4000).optional(),\n  fit: z.enum(FITS).default(\"cover\"),\n  format: z.enum(FORMATS).default(\"auto\"),\n  q: z.coerce.number().int().min(1).max(100).optional(),\n  blur: z.coerce.number().min(0.3).max(1000).optional(),\n  gravity: z.enum(GRAVITIES).default(\"center\"),\n  strip: z.coerce.boolean().default(false),\n  sharpen: z.coerce.boolean().default(false),\n  placeholder: z.enum([\"blur\"]).optional(),\n});\nexport type TransformOptions = z.infer<typeof TransformOptionsSchema>;\n\nexport interface SourceAdapter {\n  fetch(key: string): Promise<{ buffer: Buffer; mimeType: string } | undefined>;\n}\n\nexport interface CacheOptions {\n  dir?: string;\n  maxItems?: number;\n}\n\nexport interface ImagoOptions {\n  source: string | SourceAdapter;\n  cache?: string | CacheOptions;\n  maxAge?: number;\n  /** Maximum returned width or height. */\n  maxDimension?: number;\n}\n","import { existsSync, readFileSync } from \"node:fs\";\nimport { resolve, sep } from \"node:path\";\nimport { SourceNotFoundError } from \"./errors.js\";\nimport type { SourceAdapter } from \"./types.js\";\n\nexport class FileSystemSource implements SourceAdapter {\n  readonly root: string;\n\n  constructor(root: string) {\n    this.root = resolve(root);\n  }\n\n  async fetch(key: string) {\n    const abs = resolve(this.root, key);\n    if (!abs.startsWith(this.root + sep) && abs !== this.root) {\n      throw new SourceNotFoundError(key);\n    }\n    if (!existsSync(abs)) return undefined;\n    const buffer = readFileSync(abs);\n    return { buffer, mimeType: mimeFromExtension(abs) };\n  }\n}\n\nfunction mimeFromExtension(path: string): string {\n  const ext = path.toLowerCase().slice(path.lastIndexOf(\".\") + 1);\n  switch (ext) {\n    case \"jpg\":\n    case \"jpeg\": return \"image/jpeg\";\n    case \"png\": return \"image/png\";\n    case \"webp\": return \"image/webp\";\n    case \"avif\": return \"image/avif\";\n    case \"gif\": return \"image/gif\";\n    case \"bmp\": return \"image/bmp\";\n    default: return \"application/octet-stream\";\n  }\n}\n","export class ImagoError extends Error {\n  readonly status: number;\n  constructor(message: string, status: number) {\n    super(message);\n    this.name = \"ImagoError\";\n    this.status = status;\n    Object.setPrototypeOf(this, ImagoError.prototype);\n  }\n}\n\nexport class DimensionLimitError extends ImagoError {\n  constructor(public readonly requested: number, public readonly max: number) {\n    super(`Requested dimension ${requested} exceeds maximum ${max}`, 413);\n    this.name = \"DimensionLimitError\";\n    Object.setPrototypeOf(this, DimensionLimitError.prototype);\n  }\n}\n\nexport class UnsupportedFormatError extends ImagoError {\n  constructor(public readonly format: string) {\n    super(`Unsupported image format: ${format}`, 400);\n    this.name = \"UnsupportedFormatError\";\n    Object.setPrototypeOf(this, UnsupportedFormatError.prototype);\n  }\n}\n\nexport class SourceNotFoundError extends ImagoError {\n  constructor(public readonly key: string) {\n    super(`Source image not found: ${key}`, 404);\n    this.name = \"SourceNotFoundError\";\n    Object.setPrototypeOf(this, SourceNotFoundError.prototype);\n  }\n}\n","import { createHash } from \"node:crypto\";\nimport { DimensionLimitError, UnsupportedFormatError } from \"./errors.js\";\nimport {\n  type Format,\n  type TransformOptions,\n  TransformOptionsSchema,\n} from \"./types.js\";\n\ntype SharpInstance = {\n  metadata(): Promise<{ width?: number; height?: number; format?: string }>;\n  resize(opts: Record<string, unknown>): SharpInstance;\n  rotate(): SharpInstance;\n  blur(sigma: number): SharpInstance;\n  sharpen(): SharpInstance;\n  withMetadata(): SharpInstance;\n  toFormat(fmt: string, opts: Record<string, unknown>): SharpInstance;\n  toBuffer(): Promise<Buffer>;\n};\n\nlet _sharp: ((buffer: Buffer | Uint8Array) => SharpInstance) | undefined;\n\nasync function loadSharp() {\n  if (!_sharp) {\n    try {\n      const mod = (await import(/* @vite-ignore */ \"sharp\")) as unknown as {\n        default: (buffer: Buffer | Uint8Array) => SharpInstance;\n      };\n      _sharp = mod.default;\n    } catch (err) {\n      throw new Error(\n        \"imago requires `sharp >= 0.33.0` as a peer dependency. Install it with `npm install sharp`.\",\n      );\n    }\n  }\n  return _sharp!;\n}\n\nconst QUALITY_DEFAULTS: Record<string, number> = {\n  jpeg: 82,\n  webp: 80,\n  avif: 65,\n  png: 90,\n};\n\nexport function pickFormat(requested: Format, accept: string | undefined, sourceFormat: string | undefined): Exclude<Format, \"auto\"> {\n  if (requested !== \"auto\") return requested;\n  const a = (accept ?? \"\").toLowerCase();\n  if (a.includes(\"image/avif\")) return \"avif\";\n  if (a.includes(\"image/webp\")) return \"webp\";\n  if (sourceFormat === \"png\") return \"png\";\n  return \"jpeg\";\n}\n\nexport interface TransformResult {\n  buffer: Buffer;\n  mimeType: string;\n  etag: string;\n}\n\nexport interface TransformInput {\n  source: Buffer;\n  options: Partial<TransformOptions>;\n  accept?: string;\n  maxDimension?: number;\n}\n\nexport async function transform(input: TransformInput): Promise<TransformResult> {\n  const opts = TransformOptionsSchema.parse(input.options);\n  const maxDim = input.maxDimension ?? 4000;\n  if (opts.w && opts.w > maxDim) throw new DimensionLimitError(opts.w, maxDim);\n  if (opts.h && opts.h > maxDim) throw new DimensionLimitError(opts.h, maxDim);\n\n  const sharp = await loadSharp();\n  let pipeline = sharp(input.source).rotate();\n\n  const meta = await pipeline.metadata();\n  const finalFormat = pickFormat(opts.format, input.accept, meta.format);\n\n  if (![\"jpeg\", \"png\", \"webp\", \"avif\"].includes(finalFormat)) {\n    throw new UnsupportedFormatError(finalFormat);\n  }\n\n  if (opts.placeholder === \"blur\") {\n    const buf = await sharp(input.source)\n      .resize({ width: 8, height: 8, fit: \"cover\" })\n      .blur(2)\n      .toFormat(\"webp\", { quality: 50 })\n      .toBuffer();\n    return {\n      buffer: buf,\n      mimeType: \"image/webp\",\n      etag: hashEtag(buf),\n    };\n  }\n\n  if (opts.w || opts.h) {\n    pipeline = pipeline.resize({\n      ...(opts.w !== undefined ? { width: opts.w } : {}),\n      ...(opts.h !== undefined ? { height: opts.h } : {}),\n      fit: opts.fit,\n      ...(opts.gravity === \"smart\" ? { position: \"attention\" } : { position: opts.gravity }),\n    });\n  }\n\n  if (opts.blur !== undefined) pipeline = pipeline.blur(opts.blur);\n  if (opts.sharpen) pipeline = pipeline.sharpen();\n  if (!opts.strip) pipeline = pipeline.withMetadata();\n\n  const quality = opts.q ?? QUALITY_DEFAULTS[finalFormat] ?? 80;\n  pipeline = pipeline.toFormat(finalFormat, { quality });\n\n  const buffer = await pipeline.toBuffer();\n\n  return {\n    buffer,\n    mimeType: `image/${finalFormat}`,\n    etag: hashEtag(buffer),\n  };\n}\n\nfunction hashEtag(buf: Buffer): string {\n  return `\"${createHash(\"md5\").update(buf).digest(\"hex\")}\"`;\n}\n","import { createHash } from \"node:crypto\";\nimport { existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport type { TransformOptions } from \"./types.js\";\n\nexport interface CacheEntry {\n  buffer: Buffer;\n  mimeType: string;\n  etag: string;\n  lastModified: Date;\n}\n\nexport interface Cache {\n  get(key: string): CacheEntry | undefined;\n  set(key: string, entry: CacheEntry): void;\n}\n\nexport function makeCacheKey(sourceKey: string, opts: TransformOptions, mtime: number): string {\n  const json = JSON.stringify({ sourceKey, opts, mtime });\n  return createHash(\"sha1\").update(json).digest(\"hex\");\n}\n\nexport class LruCache implements Cache {\n  private map = new Map<string, CacheEntry>();\n  constructor(private readonly maxItems = 256) {}\n  get(key: string) {\n    const v = this.map.get(key);\n    if (!v) return undefined;\n    this.map.delete(key);\n    this.map.set(key, v);\n    return v;\n  }\n  set(key: string, entry: CacheEntry) {\n    if (this.map.has(key)) this.map.delete(key);\n    this.map.set(key, entry);\n    while (this.map.size > this.maxItems) {\n      const firstKey = this.map.keys().next().value as string | undefined;\n      if (firstKey === undefined) break;\n      this.map.delete(firstKey);\n    }\n  }\n}\n\nexport class DiskCache implements Cache {\n  constructor(public readonly dir: string) {\n    if (!existsSync(dir)) mkdirSync(dir, { recursive: true });\n  }\n  private file(key: string) {\n    return join(this.dir, key);\n  }\n  private meta(key: string) {\n    return join(this.dir, `${key}.json`);\n  }\n  get(key: string): CacheEntry | undefined {\n    if (!existsSync(this.file(key))) return undefined;\n    try {\n      const meta = JSON.parse(readFileSync(this.meta(key), \"utf8\")) as { mimeType: string; etag: string };\n      const stat = statSync(this.file(key));\n      return {\n        buffer: readFileSync(this.file(key)),\n        mimeType: meta.mimeType,\n        etag: meta.etag,\n        lastModified: stat.mtime,\n      };\n    } catch {\n      return undefined;\n    }\n  }\n  set(key: string, entry: CacheEntry) {\n    writeFileSync(this.file(key), entry.buffer);\n    writeFileSync(this.meta(key), JSON.stringify({ mimeType: entry.mimeType, etag: entry.etag }), \"utf8\");\n  }\n}\n"],"mappings":"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","names":["import_node_fs","import_node_crypto","import_node_fs","import_node_path"]}

package/dist/index.d.cts

@@ -0,0 +1,141 @@
+import * as undici_types from 'undici-types';
+import { z } from 'zod';
+
+declare const FORMATS: readonly ["jpeg", "png", "webp", "avif", "auto"];
+type Format = (typeof FORMATS)[number];
+declare const FITS: readonly ["cover", "contain", "fill", "inside", "outside"];
+type Fit = (typeof FITS)[number];
+declare const GRAVITIES: readonly ["center", "north", "south", "east", "west", "smart"];
+type Gravity = (typeof GRAVITIES)[number];
+declare const TransformOptionsSchema: z.ZodObject<{
+    w: z.ZodOptional<z.ZodNumber>;
+    h: z.ZodOptional<z.ZodNumber>;
+    fit: z.ZodDefault<z.ZodEnum<["cover", "contain", "fill", "inside", "outside"]>>;
+    format: z.ZodDefault<z.ZodEnum<["jpeg", "png", "webp", "avif", "auto"]>>;
+    q: z.ZodOptional<z.ZodNumber>;
+    blur: z.ZodOptional<z.ZodNumber>;
+    gravity: z.ZodDefault<z.ZodEnum<["center", "north", "south", "east", "west", "smart"]>>;
+    strip: z.ZodDefault<z.ZodBoolean>;
+    sharpen: z.ZodDefault<z.ZodBoolean>;
+    placeholder: z.ZodOptional<z.ZodEnum<["blur"]>>;
+}, "strip", z.ZodTypeAny, {
+    fit: "cover" | "contain" | "fill" | "inside" | "outside";
+    format: "jpeg" | "png" | "webp" | "avif" | "auto";
+    gravity: "center" | "north" | "south" | "east" | "west" | "smart";
+    strip: boolean;
+    sharpen: boolean;
+    w?: number | undefined;
+    h?: number | undefined;
+    q?: number | undefined;
+    blur?: number | undefined;
+    placeholder?: "blur" | undefined;
+}, {
+    w?: number | undefined;
+    h?: number | undefined;
+    fit?: "cover" | "contain" | "fill" | "inside" | "outside" | undefined;
+    format?: "jpeg" | "png" | "webp" | "avif" | "auto" | undefined;
+    q?: number | undefined;
+    blur?: number | undefined;
+    gravity?: "center" | "north" | "south" | "east" | "west" | "smart" | undefined;
+    strip?: boolean | undefined;
+    sharpen?: boolean | undefined;
+    placeholder?: "blur" | undefined;
+}>;
+type TransformOptions = z.infer<typeof TransformOptionsSchema>;
+interface SourceAdapter {
+    fetch(key: string): Promise<{
+        buffer: Buffer;
+        mimeType: string;
+    } | undefined>;
+}
+interface CacheOptions {
+    dir?: string;
+    maxItems?: number;
+}
+interface ImagoOptions {
+    source: string | SourceAdapter;
+    cache?: string | CacheOptions;
+    maxAge?: number;
+    /** Maximum returned width or height. */
+    maxDimension?: number;
+}
+
+interface HandleResult {
+    status: number;
+    headers: Record<string, string>;
+    body: Buffer;
+}
+declare function handle(opts: ImagoOptions, key: string, rawQuery: Record<string, string>, reqHeaders: Record<string, string | undefined>): Promise<HandleResult>;
+declare function imago(opts: ImagoOptions): (req: any, res: any, next: (err?: unknown) => void) => Promise<void>;
+declare function imagoHono(opts: ImagoOptions): (c: any) => Promise<undici_types.Response>;
+declare function imagoFastify(opts: ImagoOptions): (req: any, reply: any) => Promise<void>;
+
+declare function pickFormat(requested: Format, accept: string | undefined, sourceFormat: string | undefined): Exclude<Format, "auto">;
+interface TransformResult {
+    buffer: Buffer;
+    mimeType: string;
+    etag: string;
+}
+interface TransformInput {
+    source: Buffer;
+    options: Partial<TransformOptions>;
+    accept?: string;
+    maxDimension?: number;
+}
+declare function transform(input: TransformInput): Promise<TransformResult>;
+
+declare class FileSystemSource implements SourceAdapter {
+    readonly root: string;
+    constructor(root: string);
+    fetch(key: string): Promise<{
+        buffer: NonSharedBuffer;
+        mimeType: string;
+    } | undefined>;
+}
+
+interface CacheEntry {
+    buffer: Buffer;
+    mimeType: string;
+    etag: string;
+    lastModified: Date;
+}
+interface Cache {
+    get(key: string): CacheEntry | undefined;
+    set(key: string, entry: CacheEntry): void;
+}
+declare function makeCacheKey(sourceKey: string, opts: TransformOptions, mtime: number): string;
+declare class LruCache implements Cache {
+    private readonly maxItems;
+    private map;
+    constructor(maxItems?: number);
+    get(key: string): CacheEntry | undefined;
+    set(key: string, entry: CacheEntry): void;
+}
+declare class DiskCache implements Cache {
+    readonly dir: string;
+    constructor(dir: string);
+    private file;
+    private meta;
+    get(key: string): CacheEntry | undefined;
+    set(key: string, entry: CacheEntry): void;
+}
+
+declare class ImagoError extends Error {
+    readonly status: number;
+    constructor(message: string, status: number);
+}
+declare class DimensionLimitError extends ImagoError {
+    readonly requested: number;
+    readonly max: number;
+    constructor(requested: number, max: number);
+}
+declare class UnsupportedFormatError extends ImagoError {
+    readonly format: string;
+    constructor(format: string);
+}
+declare class SourceNotFoundError extends ImagoError {
+    readonly key: string;
+    constructor(key: string);
+}
+
+export { type CacheOptions, DimensionLimitError, DiskCache, FileSystemSource, type Fit, type Format, type Gravity, ImagoError, type ImagoOptions, LruCache, type SourceAdapter, SourceNotFoundError, type TransformOptions, TransformOptionsSchema, UnsupportedFormatError, handle, imago, imagoFastify, imagoHono, makeCacheKey, pickFormat, transform };