@lens-image/core 0.1.0

package/dist/cjs/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../../src/hash.ts"],"names":[],"mappings":";AAAA,oFAAoF;;AAKpF,wBAEC;AASD,8BAGC;AAQD,kCAEC;AA3BD,6CAAyC;AAEzC,gDAAgD;AAChD,SAAgB,MAAM,CAAC,IAAgB;IACrC,OAAO,IAAA,wBAAU,EAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACzD,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,SAAS,CAAC,IAAyB,EAAE,MAAM,GAAG,EAAE;IAC9D,MAAM,IAAI,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAA,wBAAU,EAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACvG,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;AAC/B,CAAC;AAED;;;;;GAKG;AACH,SAAgB,WAAW,CAAC,KAAc;IACxC,OAAO,IAAA,wBAAU,EAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACxF,CAAC;AAED,SAAS,eAAe,CAAC,KAAc;IACrC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC;IACxF,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IAC7E,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC;SAC7D,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC;SAClC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;SAChD,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACjE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;AAClC,CAAC"}

package/dist/cjs/index.d.ts

@@ -0,0 +1,56 @@
+/**
+ * `@lens-image/core` - composable image optimization for Node.js.
+ *
+ * Zero runtime dependencies. The codec (sharp) and the storage backend are both
+ * injected interfaces, so the core is testable, swappable and installs nothing
+ * you did not ask for.
+ *
+ * @example
+ * ```ts
+ * import { ImageOptimizer } from '@lens-image/core';
+ * import { LocalAdapter } from '@lens-image/adapter-local';
+ *
+ * const optimizer = new ImageOptimizer({
+ *   adapter: new LocalAdapter({ root: './public/images', baseUrl: '/images' }),
+ *   quality: 80,
+ * });
+ *
+ * const result = await optimizer.optimize({
+ *   source: './photo.jpg',
+ *   formats: ['webp', 'jpg'],
+ *   sizes: [{ width: 1200 }, { width: 600 }, { width: 300 }],
+ * });
+ *
+ * console.log(result.formats.webp.srcset);
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { ImageOptimizer, DEFAULT_CACHE_CONTROL } from './optimizer.js';
+export { LensError, throwIfAborted, wrapError } from './errors.js';
+export type { LensErrorCode, LensErrorDetails } from './errors.js';
+export { createSharpEngine, createPassthroughEngine, detectEngine, resetEngineDetection, resetSharpCache, } from './engines/index.js';
+export type { SharpEngineOptions, PassthroughEngineOptions } from './engines/index.js';
+export { MemoryAdapter } from './adapters/memory.js';
+export type { MemoryAdapterOptions, MemoryEntry } from './adapters/memory.js';
+export { MemoryCacheStore, nullCacheStore } from './cache.js';
+export { createUploadHandler, serializeResult } from './server/handler.js';
+export type { UploadHandlerOptions } from './server/handler.js';
+export { buildSrcset, toPicture, pickVariant } from './srcset.js';
+export type { PictureData, PictureSource } from './srcset.js';
+export { sniff, sniffFormat, mimeTypeFor, extensionFor, SNIFF_HEADER_BYTES } from './sniff.js';
+export { resolveSource, stem, formatBytes } from './source.js';
+export type { ResolvedSource, ResolveOptions } from './source.js';
+export { normalizeFormat, normalizeFormats, supportsAlpha, isLossy, defaultQuality, defaultEffort, ENCODABLE_FORMATS, } from './format.js';
+export { buildKey, joinKey, slugify, defaultLabel, DEFAULT_KEY_TEMPLATE } from './naming.js';
+export { validateImage, resolveValidation, DEFAULT_MAX_BYTES, DEFAULT_MAX_PIXELS, DEFAULT_ALLOWED_FORMATS, } from './validation.js';
+export type { ResolvedValidation } from './validation.js';
+export { withRetry, resolveRetry, backoffDelay, isRetryableError } from './retry.js';
+export type { ResolvedRetry } from './retry.js';
+export { mapLimit, delay } from './concurrency.js';
+export type { Settled } from './concurrency.js';
+export { sha256, shortHash, hashOptions } from './hash.js';
+export type { CacheStore, DetectedFormat, EncodedImage, FitMode, FormatResult, ImageEngine, ImageFormat, ImageFormatInput, ImageMetadata, ImageOptimizerOptions, ImageSource, KeyContext, LensWarning, OptimizeOptions, OptimizeResult, Position, ResizeSpec, RetryOptions, SizeSpec, StorageAdapter, StorageContext, StorageFile, StorageObject, ThumbnailSpec, TransformOp, ValidationOptions, Variant, } from './types.js';
+/** The version of `@lens-image/core`, useful in `User-Agent` strings and bug reports. */
+export declare const VERSION = "0.1.0";
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAGH,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAGvE,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACnE,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAGnE,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,YAAY,EACZ,oBAAoB,EACpB,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAGvF,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,YAAY,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAG9E,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAG9D,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3E,YAAY,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAGhE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAClE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG9D,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAC/F,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/D,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,OAAO,EACP,cAAc,EACd,aAAa,EACb,iBAAiB,GAClB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAC7F,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACrF,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACnD,YAAY,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAG3D,YAAY,EACV,UAAU,EACV,cAAc,EACd,YAAY,EACZ,OAAO,EACP,YAAY,EACZ,WAAW,EACX,WAAW,EACX,gBAAgB,EAChB,aAAa,EACb,qBAAqB,EACrB,WAAW,EACX,UAAU,EACV,WAAW,EACX,eAAe,EACf,cAAc,EACd,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,cAAc,EACd,cAAc,EACd,WAAW,EACX,aAAa,EACb,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,OAAO,GACR,MAAM,YAAY,CAAC;AAEpB,yFAAyF;AACzF,eAAO,MAAM,OAAO,UAAU,CAAC"}

package/dist/cjs/index.js

@@ -0,0 +1,110 @@
+"use strict";
+/**
+ * `@lens-image/core` - composable image optimization for Node.js.
+ *
+ * Zero runtime dependencies. The codec (sharp) and the storage backend are both
+ * injected interfaces, so the core is testable, swappable and installs nothing
+ * you did not ask for.
+ *
+ * @example
+ * ```ts
+ * import { ImageOptimizer } from '@lens-image/core';
+ * import { LocalAdapter } from '@lens-image/adapter-local';
+ *
+ * const optimizer = new ImageOptimizer({
+ *   adapter: new LocalAdapter({ root: './public/images', baseUrl: '/images' }),
+ *   quality: 80,
+ * });
+ *
+ * const result = await optimizer.optimize({
+ *   source: './photo.jpg',
+ *   formats: ['webp', 'jpg'],
+ *   sizes: [{ width: 1200 }, { width: 600 }, { width: 300 }],
+ * });
+ *
+ * console.log(result.formats.webp.srcset);
+ * ```
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sha256 = exports.delay = exports.mapLimit = exports.isRetryableError = exports.backoffDelay = exports.resolveRetry = exports.withRetry = exports.DEFAULT_ALLOWED_FORMATS = exports.DEFAULT_MAX_PIXELS = exports.DEFAULT_MAX_BYTES = exports.resolveValidation = exports.validateImage = exports.DEFAULT_KEY_TEMPLATE = exports.defaultLabel = exports.slugify = exports.joinKey = exports.buildKey = exports.ENCODABLE_FORMATS = exports.defaultEffort = exports.defaultQuality = exports.isLossy = exports.supportsAlpha = exports.normalizeFormats = exports.normalizeFormat = exports.formatBytes = exports.stem = exports.resolveSource = exports.SNIFF_HEADER_BYTES = exports.extensionFor = exports.mimeTypeFor = exports.sniffFormat = exports.sniff = exports.pickVariant = exports.toPicture = exports.buildSrcset = exports.serializeResult = exports.createUploadHandler = exports.nullCacheStore = exports.MemoryCacheStore = exports.MemoryAdapter = exports.resetSharpCache = exports.resetEngineDetection = exports.detectEngine = exports.createPassthroughEngine = exports.createSharpEngine = exports.wrapError = exports.throwIfAborted = exports.LensError = exports.DEFAULT_CACHE_CONTROL = exports.ImageOptimizer = void 0;
+exports.VERSION = exports.hashOptions = exports.shortHash = void 0;
+// --- The main entry point ---------------------------------------------------
+var optimizer_js_1 = require("./optimizer.js");
+Object.defineProperty(exports, "ImageOptimizer", { enumerable: true, get: function () { return optimizer_js_1.ImageOptimizer; } });
+Object.defineProperty(exports, "DEFAULT_CACHE_CONTROL", { enumerable: true, get: function () { return optimizer_js_1.DEFAULT_CACHE_CONTROL; } });
+// --- Errors -----------------------------------------------------------------
+var errors_js_1 = require("./errors.js");
+Object.defineProperty(exports, "LensError", { enumerable: true, get: function () { return errors_js_1.LensError; } });
+Object.defineProperty(exports, "throwIfAborted", { enumerable: true, get: function () { return errors_js_1.throwIfAborted; } });
+Object.defineProperty(exports, "wrapError", { enumerable: true, get: function () { return errors_js_1.wrapError; } });
+// --- Engines ----------------------------------------------------------------
+var index_js_1 = require("./engines/index.js");
+Object.defineProperty(exports, "createSharpEngine", { enumerable: true, get: function () { return index_js_1.createSharpEngine; } });
+Object.defineProperty(exports, "createPassthroughEngine", { enumerable: true, get: function () { return index_js_1.createPassthroughEngine; } });
+Object.defineProperty(exports, "detectEngine", { enumerable: true, get: function () { return index_js_1.detectEngine; } });
+Object.defineProperty(exports, "resetEngineDetection", { enumerable: true, get: function () { return index_js_1.resetEngineDetection; } });
+Object.defineProperty(exports, "resetSharpCache", { enumerable: true, get: function () { return index_js_1.resetSharpCache; } });
+// --- Built-in adapters ------------------------------------------------------
+var memory_js_1 = require("./adapters/memory.js");
+Object.defineProperty(exports, "MemoryAdapter", { enumerable: true, get: function () { return memory_js_1.MemoryAdapter; } });
+// --- Caching ----------------------------------------------------------------
+var cache_js_1 = require("./cache.js");
+Object.defineProperty(exports, "MemoryCacheStore", { enumerable: true, get: function () { return cache_js_1.MemoryCacheStore; } });
+Object.defineProperty(exports, "nullCacheStore", { enumerable: true, get: function () { return cache_js_1.nullCacheStore; } });
+// --- Server helpers ---------------------------------------------------------
+var handler_js_1 = require("./server/handler.js");
+Object.defineProperty(exports, "createUploadHandler", { enumerable: true, get: function () { return handler_js_1.createUploadHandler; } });
+Object.defineProperty(exports, "serializeResult", { enumerable: true, get: function () { return handler_js_1.serializeResult; } });
+// --- HTML helpers -----------------------------------------------------------
+var srcset_js_1 = require("./srcset.js");
+Object.defineProperty(exports, "buildSrcset", { enumerable: true, get: function () { return srcset_js_1.buildSrcset; } });
+Object.defineProperty(exports, "toPicture", { enumerable: true, get: function () { return srcset_js_1.toPicture; } });
+Object.defineProperty(exports, "pickVariant", { enumerable: true, get: function () { return srcset_js_1.pickVariant; } });
+// --- Utilities, exported because adapter authors need them ------------------
+var sniff_js_1 = require("./sniff.js");
+Object.defineProperty(exports, "sniff", { enumerable: true, get: function () { return sniff_js_1.sniff; } });
+Object.defineProperty(exports, "sniffFormat", { enumerable: true, get: function () { return sniff_js_1.sniffFormat; } });
+Object.defineProperty(exports, "mimeTypeFor", { enumerable: true, get: function () { return sniff_js_1.mimeTypeFor; } });
+Object.defineProperty(exports, "extensionFor", { enumerable: true, get: function () { return sniff_js_1.extensionFor; } });
+Object.defineProperty(exports, "SNIFF_HEADER_BYTES", { enumerable: true, get: function () { return sniff_js_1.SNIFF_HEADER_BYTES; } });
+var source_js_1 = require("./source.js");
+Object.defineProperty(exports, "resolveSource", { enumerable: true, get: function () { return source_js_1.resolveSource; } });
+Object.defineProperty(exports, "stem", { enumerable: true, get: function () { return source_js_1.stem; } });
+Object.defineProperty(exports, "formatBytes", { enumerable: true, get: function () { return source_js_1.formatBytes; } });
+var format_js_1 = require("./format.js");
+Object.defineProperty(exports, "normalizeFormat", { enumerable: true, get: function () { return format_js_1.normalizeFormat; } });
+Object.defineProperty(exports, "normalizeFormats", { enumerable: true, get: function () { return format_js_1.normalizeFormats; } });
+Object.defineProperty(exports, "supportsAlpha", { enumerable: true, get: function () { return format_js_1.supportsAlpha; } });
+Object.defineProperty(exports, "isLossy", { enumerable: true, get: function () { return format_js_1.isLossy; } });
+Object.defineProperty(exports, "defaultQuality", { enumerable: true, get: function () { return format_js_1.defaultQuality; } });
+Object.defineProperty(exports, "defaultEffort", { enumerable: true, get: function () { return format_js_1.defaultEffort; } });
+Object.defineProperty(exports, "ENCODABLE_FORMATS", { enumerable: true, get: function () { return format_js_1.ENCODABLE_FORMATS; } });
+var naming_js_1 = require("./naming.js");
+Object.defineProperty(exports, "buildKey", { enumerable: true, get: function () { return naming_js_1.buildKey; } });
+Object.defineProperty(exports, "joinKey", { enumerable: true, get: function () { return naming_js_1.joinKey; } });
+Object.defineProperty(exports, "slugify", { enumerable: true, get: function () { return naming_js_1.slugify; } });
+Object.defineProperty(exports, "defaultLabel", { enumerable: true, get: function () { return naming_js_1.defaultLabel; } });
+Object.defineProperty(exports, "DEFAULT_KEY_TEMPLATE", { enumerable: true, get: function () { return naming_js_1.DEFAULT_KEY_TEMPLATE; } });
+var validation_js_1 = require("./validation.js");
+Object.defineProperty(exports, "validateImage", { enumerable: true, get: function () { return validation_js_1.validateImage; } });
+Object.defineProperty(exports, "resolveValidation", { enumerable: true, get: function () { return validation_js_1.resolveValidation; } });
+Object.defineProperty(exports, "DEFAULT_MAX_BYTES", { enumerable: true, get: function () { return validation_js_1.DEFAULT_MAX_BYTES; } });
+Object.defineProperty(exports, "DEFAULT_MAX_PIXELS", { enumerable: true, get: function () { return validation_js_1.DEFAULT_MAX_PIXELS; } });
+Object.defineProperty(exports, "DEFAULT_ALLOWED_FORMATS", { enumerable: true, get: function () { return validation_js_1.DEFAULT_ALLOWED_FORMATS; } });
+var retry_js_1 = require("./retry.js");
+Object.defineProperty(exports, "withRetry", { enumerable: true, get: function () { return retry_js_1.withRetry; } });
+Object.defineProperty(exports, "resolveRetry", { enumerable: true, get: function () { return retry_js_1.resolveRetry; } });
+Object.defineProperty(exports, "backoffDelay", { enumerable: true, get: function () { return retry_js_1.backoffDelay; } });
+Object.defineProperty(exports, "isRetryableError", { enumerable: true, get: function () { return retry_js_1.isRetryableError; } });
+var concurrency_js_1 = require("./concurrency.js");
+Object.defineProperty(exports, "mapLimit", { enumerable: true, get: function () { return concurrency_js_1.mapLimit; } });
+Object.defineProperty(exports, "delay", { enumerable: true, get: function () { return concurrency_js_1.delay; } });
+var hash_js_1 = require("./hash.js");
+Object.defineProperty(exports, "sha256", { enumerable: true, get: function () { return hash_js_1.sha256; } });
+Object.defineProperty(exports, "shortHash", { enumerable: true, get: function () { return hash_js_1.shortHash; } });
+Object.defineProperty(exports, "hashOptions", { enumerable: true, get: function () { return hash_js_1.hashOptions; } });
+/** The version of `@lens-image/core`, useful in `User-Agent` strings and bug reports. */
+exports.VERSION = '0.1.0';
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;;;;AAEH,+EAA+E;AAC/E,+CAAuE;AAA9D,8GAAA,cAAc,OAAA;AAAE,qHAAA,qBAAqB,OAAA;AAE9C,+EAA+E;AAC/E,yCAAmE;AAA1D,sGAAA,SAAS,OAAA;AAAE,2GAAA,cAAc,OAAA;AAAE,sGAAA,SAAS,OAAA;AAG7C,+EAA+E;AAC/E,+CAM4B;AAL1B,6GAAA,iBAAiB,OAAA;AACjB,mHAAA,uBAAuB,OAAA;AACvB,wGAAA,YAAY,OAAA;AACZ,gHAAA,oBAAoB,OAAA;AACpB,2GAAA,eAAe,OAAA;AAIjB,+EAA+E;AAC/E,kDAAqD;AAA5C,0GAAA,aAAa,OAAA;AAGtB,+EAA+E;AAC/E,uCAA8D;AAArD,4GAAA,gBAAgB,OAAA;AAAE,0GAAA,cAAc,OAAA;AAEzC,+EAA+E;AAC/E,kDAA2E;AAAlE,iHAAA,mBAAmB,OAAA;AAAE,6GAAA,eAAe,OAAA;AAG7C,+EAA+E;AAC/E,yCAAkE;AAAzD,wGAAA,WAAW,OAAA;AAAE,sGAAA,SAAS,OAAA;AAAE,wGAAA,WAAW,OAAA;AAG5C,+EAA+E;AAC/E,uCAA+F;AAAtF,iGAAA,KAAK,OAAA;AAAE,uGAAA,WAAW,OAAA;AAAE,uGAAA,WAAW,OAAA;AAAE,wGAAA,YAAY,OAAA;AAAE,8GAAA,kBAAkB,OAAA;AAC1E,yCAA+D;AAAtD,0GAAA,aAAa,OAAA;AAAE,iGAAA,IAAI,OAAA;AAAE,wGAAA,WAAW,OAAA;AAEzC,yCAQqB;AAPnB,4GAAA,eAAe,OAAA;AACf,6GAAA,gBAAgB,OAAA;AAChB,0GAAA,aAAa,OAAA;AACb,oGAAA,OAAO,OAAA;AACP,2GAAA,cAAc,OAAA;AACd,0GAAA,aAAa,OAAA;AACb,8GAAA,iBAAiB,OAAA;AAEnB,yCAA6F;AAApF,qGAAA,QAAQ,OAAA;AAAE,oGAAA,OAAO,OAAA;AAAE,oGAAA,OAAO,OAAA;AAAE,yGAAA,YAAY,OAAA;AAAE,iHAAA,oBAAoB,OAAA;AACvE,iDAMyB;AALvB,8GAAA,aAAa,OAAA;AACb,kHAAA,iBAAiB,OAAA;AACjB,kHAAA,iBAAiB,OAAA;AACjB,mHAAA,kBAAkB,OAAA;AAClB,wHAAA,uBAAuB,OAAA;AAGzB,uCAAqF;AAA5E,qGAAA,SAAS,OAAA;AAAE,wGAAA,YAAY,OAAA;AAAE,wGAAA,YAAY,OAAA;AAAE,4GAAA,gBAAgB,OAAA;AAEhE,mDAAmD;AAA1C,0GAAA,QAAQ,OAAA;AAAE,uGAAA,KAAK,OAAA;AAExB,qCAA2D;AAAlD,iGAAA,MAAM,OAAA;AAAE,oGAAA,SAAS,OAAA;AAAE,sGAAA,WAAW,OAAA;AAiCvC,yFAAyF;AAC5E,QAAA,OAAO,GAAG,OAAO,CAAC"}

package/dist/cjs/naming.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Output key templating.
+ *
+ * Keys are how everything downstream addresses a variant - the S3 object key,
+ * the path under a local root, the public URL. They must be deterministic
+ * (so caching works), URL-safe (so nobody has to think about encoding), and
+ * predictable enough that a developer can eyeball a bucket listing.
+ */
+import type { KeyContext } from './types.js';
+/** `{hash}/{name}-{label}.{ext}` - content-addressed and cacheable forever. */
+export declare const DEFAULT_KEY_TEMPLATE = "{hash}/{name}-{label}.{ext}";
+/**
+ * Makes a string safe for a URL path segment.
+ *
+ * Lowercases, strips diacritics, collapses anything non-alphanumeric to a
+ * single dash. Empty input becomes `'image'` so a key is never malformed.
+ *
+ * @example
+ * ```ts
+ * slugify('Café Photo (2).JPG'); // 'cafe-photo-2-jpg'
+ * ```
+ */
+export declare function slugify(input: string): string;
+/**
+ * Renders a key template, or calls a key function.
+ *
+ * Tokens: `{name} {hash} {fullHash} {format} {ext} {width} {height}
+ * {quality} {label}`.
+ *
+ * @throws {LensError} `INVALID_OPTIONS` when the template references an unknown
+ *   token, or a key function returns something unusable. Failing loudly here
+ *   beats silently uploading a file called `undefined.webp`.
+ *
+ * @example
+ * ```ts
+ * buildKey('{name}/{width}x{height}.{ext}', ctx);  // 'hero/1200x800.webp'
+ * buildKey((c) => `${c.format}/${c.hash}.${c.ext}`, ctx);
+ * ```
+ */
+export declare function buildKey(template: string | ((ctx: KeyContext) => string), ctx: KeyContext, prefix?: string): string;
+/** Joins a prefix and a key, normalising slashes and stripping `..` segments. */
+export declare function joinKey(prefix: string, key: string): string;
+/**
+ * Default label for a size spec: `1200w`, `800h`, or `1200x800` when both
+ * dimensions are pinned.
+ */
+export declare function defaultLabel(width?: number, height?: number): string;
+//# sourceMappingURL=naming.d.ts.map

package/dist/cjs/naming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming.d.ts","sourceRoot":"","sources":["../../src/naming.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,+EAA+E;AAC/E,eAAO,MAAM,oBAAoB,gCAAgC,CAAC;AAIlE;;;;;;;;;;GAUG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAS7C;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,QAAQ,CACtB,QAAQ,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,UAAU,KAAK,MAAM,CAAC,EAChD,GAAG,EAAE,UAAU,EACf,MAAM,SAAK,GACV,MAAM,CAWR;AAeD,iFAAiF;AACjF,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAM3D;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAKpE"}

package/dist/cjs/naming.js

@@ -0,0 +1,95 @@
+"use strict";
+/**
+ * Output key templating.
+ *
+ * Keys are how everything downstream addresses a variant - the S3 object key,
+ * the path under a local root, the public URL. They must be deterministic
+ * (so caching works), URL-safe (so nobody has to think about encoding), and
+ * predictable enough that a developer can eyeball a bucket listing.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_KEY_TEMPLATE = void 0;
+exports.slugify = slugify;
+exports.buildKey = buildKey;
+exports.joinKey = joinKey;
+exports.defaultLabel = defaultLabel;
+const errors_js_1 = require("./errors.js");
+/** `{hash}/{name}-{label}.{ext}` - content-addressed and cacheable forever. */
+exports.DEFAULT_KEY_TEMPLATE = '{hash}/{name}-{label}.{ext}';
+const TOKEN = /\{(\w+)\}/g;
+/**
+ * Makes a string safe for a URL path segment.
+ *
+ * Lowercases, strips diacritics, collapses anything non-alphanumeric to a
+ * single dash. Empty input becomes `'image'` so a key is never malformed.
+ *
+ * @example
+ * ```ts
+ * slugify('Café Photo (2).JPG'); // 'cafe-photo-2-jpg'
+ * ```
+ */
+function slugify(input) {
+    const slug = input
+        .normalize('NFKD')
+        .replace(/[̀-ͯ]/g, '')
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .slice(0, 100);
+    return slug.length > 0 ? slug : 'image';
+}
+/**
+ * Renders a key template, or calls a key function.
+ *
+ * Tokens: `{name} {hash} {fullHash} {format} {ext} {width} {height}
+ * {quality} {label}`.
+ *
+ * @throws {LensError} `INVALID_OPTIONS` when the template references an unknown
+ *   token, or a key function returns something unusable. Failing loudly here
+ *   beats silently uploading a file called `undefined.webp`.
+ *
+ * @example
+ * ```ts
+ * buildKey('{name}/{width}x{height}.{ext}', ctx);  // 'hero/1200x800.webp'
+ * buildKey((c) => `${c.format}/${c.hash}.${c.ext}`, ctx);
+ * ```
+ */
+function buildKey(template, ctx, prefix = '') {
+    const raw = typeof template === 'function' ? template(ctx) : renderTemplate(template, ctx);
+    if (typeof raw !== 'string' || raw.trim().length === 0) {
+        throw new errors_js_1.LensError('INVALID_OPTIONS', 'The key function must return a non-empty string. ' +
+            `Received ${raw === undefined ? 'undefined' : JSON.stringify(raw)}.`);
+    }
+    return joinKey(prefix, raw);
+}
+function renderTemplate(template, ctx) {
+    return template.replace(TOKEN, (_match, token) => {
+        if (!(token in ctx)) {
+            throw new errors_js_1.LensError('INVALID_OPTIONS', `Unknown token "{${token}}" in key template "${template}". ` +
+                `Available: ${Object.keys(ctx).map((k) => `{${k}}`).join(' ')}.`);
+        }
+        return String(ctx[token]);
+    });
+}
+/** Joins a prefix and a key, normalising slashes and stripping `..` segments. */
+function joinKey(prefix, key) {
+    const parts = `${prefix}/${key}`
+        .split('/')
+        .map((segment) => segment.trim())
+        .filter((segment) => segment.length > 0 && segment !== '.' && segment !== '..');
+    return parts.join('/');
+}
+/**
+ * Default label for a size spec: `1200w`, `800h`, or `1200x800` when both
+ * dimensions are pinned.
+ */
+function defaultLabel(width, height) {
+    if (width && height)
+        return `${width}x${height}`;
+    if (width)
+        return `${width}w`;
+    if (height)
+        return `${height}h`;
+    return 'original';
+}
+//# sourceMappingURL=naming.js.map

package/dist/cjs/naming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming.js","sourceRoot":"","sources":["../../src/naming.ts"],"names":[],"mappings":"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"}

package/dist/cjs/optimizer.d.ts

@@ -0,0 +1,89 @@
+/**
+ * The orchestrator: validate, plan, encode, upload, assemble.
+ *
+ * Deliberately the only stateful class in the library. Everything it calls -
+ * sniffing, validation, key building, retry, the engine, the adapter - is a
+ * pure function or an injected interface, which is what makes the whole thing
+ * testable without a codec or a network.
+ */
+import type { ImageEngine, ImageMetadata, ImageOptimizerOptions, OptimizeOptions, OptimizeResult, StorageAdapter } from './types.js';
+/** `public, max-age=31536000, immutable` - safe because keys are content-addressed. */
+export declare const DEFAULT_CACHE_CONTROL = "public, max-age=31536000, immutable";
+/**
+ * Optimizes images and hands them to a storage backend.
+ *
+ * Construct one per configuration and reuse it - it memoises engine detection
+ * and owns the result cache, so a fresh instance per request throws both away.
+ *
+ * @example Upload responsive WebP + JPEG to S3
+ * ```ts
+ * import { ImageOptimizer } from '@lens-image/core';
+ * import { S3Adapter } from '@lens-image/adapter-s3';
+ *
+ * const optimizer = new ImageOptimizer({
+ *   adapter: new S3Adapter({ bucket: 'my-images', region: 'us-east-1' }),
+ *   quality: 80,
+ * });
+ *
+ * const result = await optimizer.optimize({
+ *   source: '/path/to/image.jpg',
+ *   formats: ['webp', 'jpg'],
+ *   sizes: [{ width: 1200 }, { width: 600 }, { width: 300 }],
+ * });
+ *
+ * result.formats.webp.urls['600w'];  // 'https://my-images.s3.amazonaws.com/…-600w.webp'
+ * result.formats.webp.srcset;        // ready for <source srcset={…}>
+ * ```
+ *
+ * @example Process without storing
+ * ```ts
+ * const optimizer = new ImageOptimizer();          // no adapter
+ * const { variants } = await optimizer.optimize({ source: bytes, formats: ['webp'] });
+ * await writeFile('out.webp', variants[0].data!);  // bytes come back on the variant
+ * ```
+ */
+export declare class ImageOptimizer {
+    #private;
+    constructor(options?: ImageOptimizerOptions);
+    /** The storage backend, or `null` in process-only mode. */
+    get adapter(): StorageAdapter | null;
+    /** Resolves the codec backend, running detection on first use. */
+    engine(): Promise<ImageEngine>;
+    /**
+     * Processes one image into every requested format and size.
+     *
+     * Formats are independent: if AVIF encoding fails, the WebP and JPEG outputs
+     * still resolve and the failure is reported on `result.warnings` rather than
+     * thrown. Only a total failure - nothing at all was produced - rejects.
+     *
+     * @throws {LensError} `VALIDATION_FAILED`, `UNSUPPORTED_INPUT`,
+     *   `ALL_FORMATS_FAILED`, `UPLOAD_FAILED`, `ABORTED`.
+     */
+    optimize(options: OptimizeOptions): Promise<OptimizeResult>;
+    /**
+     * Optimizes several images with the same options.
+     *
+     * Runs sequentially by design. Each `optimize` call already parallelises its
+     * own variants, so overlapping whole images multiplies peak memory by the
+     * number of images - and decoded bitmaps, not encoded files, are what fills
+     * the heap. Wrap in your own queue if you have the headroom.
+     */
+    optimizeMany(sources: readonly OptimizeOptions['source'][], options?: Omit<OptimizeOptions, 'source'>): Promise<OptimizeResult[]>;
+    /**
+     * Reads an image's metadata without producing anything.
+     *
+     * Uses the engine when one is available and falls back to header sniffing,
+     * so it works with or without sharp installed.
+     */
+    inspect(source: OptimizeOptions['source']): Promise<ImageMetadata>;
+    /**
+     * Deletes every variant of a previous result from storage.
+     *
+     * @throws {LensError} `ADAPTER_REQUIRED` with no adapter configured,
+     *   `ADAPTER_UNSUPPORTED` when the adapter cannot delete.
+     */
+    delete(result: OptimizeResult): Promise<void>;
+    /** Releases adapter resources. Safe to call more than once. */
+    dispose(): Promise<void>;
+}
+//# sourceMappingURL=optimizer.d.ts.map

package/dist/cjs/optimizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"optimizer.d.ts","sourceRoot":"","sources":["../../src/optimizer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAeH,OAAO,KAAK,EAGV,WAAW,EAEX,aAAa,EACb,qBAAqB,EAGrB,eAAe,EACf,cAAc,EAGd,cAAc,EAKf,MAAM,YAAY,CAAC;AAEpB,uFAAuF;AACvF,eAAO,MAAM,qBAAqB,wCAAwC,CAAC;AAW3E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,qBAAa,cAAc;;gBAMb,OAAO,GAAE,qBAA0B;IAkB/C,2DAA2D;IAC3D,IAAI,OAAO,IAAI,cAAc,GAAG,IAAI,CAEnC;IAED,kEAAkE;IAC5D,MAAM,IAAI,OAAO,CAAC,WAAW,CAAC;IAKpC;;;;;;;;;OASG;IACG,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;IAmJjE;;;;;;;OAOG;IACG,YAAY,CAChB,OAAO,EAAE,SAAS,eAAe,CAAC,QAAQ,CAAC,EAAE,EAC7C,OAAO,GAAE,IAAI,CAAC,eAAe,EAAE,QAAQ,CAAM,GAC5C,OAAO,CAAC,cAAc,EAAE,CAAC;IAQ5B;;;;;OAKG;IACG,OAAO,CAAC,MAAM,EAAE,eAAe,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC;IAOxE;;;;;OAKG;IACG,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBnD,+DAA+D;IACzD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAqa/B"}