@lens-image/core 0.1.0

package/dist/esm/sniff.js

@@ -0,0 +1,435 @@
+/**
+ * Container sniffing: format and dimensions straight from the file header.
+ *
+ * This is deliberately dependency-free and decode-free. It exists so Lens can
+ * reject a 40,000 x 40,000 PNG *before* handing 1.6 gigapixels to a codec -
+ * the classic decompression-bomb footgun. It also means validation works
+ * identically whether or not sharp is installed.
+ *
+ * Supported: JPEG, PNG, GIF, WebP, AVIF/HEIC, TIFF, BMP, ICO, SVG.
+ */
+/** Bytes we need before a decision can be made for any supported format. */
+export const SNIFF_HEADER_BYTES = 4096;
+const ascii = (bytes, start, length) => {
+    let out = '';
+    for (let i = start; i < start + length && i < bytes.length; i++) {
+        out += String.fromCharCode(bytes[i]);
+    }
+    return out;
+};
+const u16be = (b, i) => (b[i] << 8) | b[i + 1];
+const u16le = (b, i) => b[i] | (b[i + 1] << 8);
+const u32be = (b, i) => ((b[i] << 24) >>> 0) +
+    ((b[i + 1] << 16) | (b[i + 2] << 8) | b[i + 3]);
+const u32le = (b, i) => (b[i] |
+    (b[i + 1] << 8) |
+    (b[i + 2] << 16) |
+    (b[i + 3] << 24)) >>>
+    0;
+const u24le = (b, i) => b[i] | (b[i + 1] << 8) | (b[i + 2] << 16);
+const startsWith = (b, sig, offset = 0) => {
+    if (b.length < offset + sig.length)
+        return false;
+    for (let i = 0; i < sig.length; i++)
+        if (b[offset + i] !== sig[i])
+            return false;
+    return true;
+};
+/**
+ * Identifies an image and reads its intrinsic size from the header alone.
+ *
+ * Never throws: an unrecognised buffer comes back as
+ * `{ format: 'unknown', width: 0, height: 0 }` and the caller decides whether
+ * that is fatal.
+ *
+ * @param bytes - The full file, or at least the first {@link SNIFF_HEADER_BYTES}.
+ * @param totalSize - Real byte length, when `bytes` is only a prefix.
+ *
+ * @example
+ * ```ts
+ * const meta = sniff(await readFile('photo.jpg'));
+ * // { format: 'jpeg', width: 4032, height: 3024, size: 2118431, orientation: 6 }
+ * ```
+ */
+export function sniff(bytes, totalSize = bytes.byteLength) {
+    const base = { size: totalSize };
+    if (isPng(bytes))
+        return { ...base, ...readPng(bytes) };
+    if (isJpeg(bytes))
+        return { ...base, ...readJpeg(bytes) };
+    if (isGif(bytes))
+        return { ...base, ...readGif(bytes) };
+    if (isWebp(bytes))
+        return { ...base, ...readWebp(bytes) };
+    if (isIsoBmff(bytes))
+        return { ...base, ...readIsoBmff(bytes) };
+    if (isTiff(bytes))
+        return { ...base, ...readTiff(bytes) };
+    if (isBmp(bytes))
+        return { ...base, ...readBmp(bytes) };
+    if (isIco(bytes))
+        return { ...base, ...readIco(bytes) };
+    if (isSvg(bytes))
+        return { ...base, ...readSvg(bytes) };
+    return { ...base, format: 'unknown', width: 0, height: 0 };
+}
+/** Just the format, when dimensions are not needed. */
+export function sniffFormat(bytes) {
+    return sniff(bytes, bytes.byteLength).format;
+}
+/** Canonical MIME type for a detected format. */
+export function mimeTypeFor(format) {
+    switch (format) {
+        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 'tiff':
+            return 'image/tiff';
+        case 'svg':
+            return 'image/svg+xml';
+        case 'bmp':
+            return 'image/bmp';
+        case 'ico':
+            return 'image/x-icon';
+        case 'heic':
+            return 'image/heic';
+        default:
+            return 'application/octet-stream';
+    }
+}
+/** File extension (no dot) for a format. `jpeg` becomes `jpg`, as it should. */
+export function extensionFor(format) {
+    switch (format) {
+        case 'jpeg':
+            return 'jpg';
+        case 'tiff':
+            return 'tif';
+        case 'ico':
+            return 'ico';
+        default:
+            return format;
+    }
+}
+// ---------------------------------------------------------------------------
+// PNG
+// ---------------------------------------------------------------------------
+const PNG_SIG = [0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a];
+const isPng = (b) => startsWith(b, PNG_SIG);
+function readPng(b) {
+    // IHDR is mandated to be the first chunk: 8 sig + 4 length + 4 type.
+    const width = b.length >= 24 ? u32be(b, 16) : 0;
+    const height = b.length >= 24 ? u32be(b, 20) : 0;
+    const colorType = b[25];
+    // Colour types 4 (grey+alpha) and 6 (truecolour+alpha) carry an alpha channel;
+    // type 3 (palette) can too, via a tRNS chunk.
+    const hasAlpha = colorType === 4 || colorType === 6 || hasChunk(b, 'tRNS');
+    // "acTL" before the first IDAT means APNG.
+    const isAnimated = hasChunk(b, 'acTL');
+    return { format: 'png', width, height, hasAlpha, isAnimated };
+}
+function hasChunk(b, type) {
+    let offset = 8;
+    while (offset + 8 <= b.length) {
+        const length = u32be(b, offset);
+        const name = ascii(b, offset + 4, 4);
+        if (name === type)
+            return true;
+        if (name === 'IDAT' || name === 'IEND')
+            return false;
+        // Guard against a corrupt length walking us off the end or backwards.
+        if (length > b.length)
+            return false;
+        offset += 12 + length;
+    }
+    return false;
+}
+// ---------------------------------------------------------------------------
+// JPEG
+// ---------------------------------------------------------------------------
+const isJpeg = (b) => startsWith(b, [0xff, 0xd8, 0xff]);
+/** Start-of-frame markers that carry dimensions. Excludes DHT/DAC/RST/SOS. */
+const SOF_MARKERS = new Set([
+    0xc0, 0xc1, 0xc2, 0xc3, 0xc5, 0xc6, 0xc7, 0xc9, 0xca, 0xcb, 0xcd, 0xce, 0xcf,
+]);
+function readJpeg(b) {
+    let offset = 2;
+    let orientation;
+    let width = 0;
+    let height = 0;
+    let progressive = false;
+    while (offset + 4 <= b.length) {
+        if (b[offset] !== 0xff) {
+            offset++; // Resynchronise across padding bytes.
+            continue;
+        }
+        const marker = b[offset + 1];
+        // Standalone markers carry no length payload.
+        if (marker === 0xd8 || marker === 0x01 || (marker >= 0xd0 && marker <= 0xd7)) {
+            offset += 2;
+            continue;
+        }
+        if (marker === 0xd9 || marker === 0xda)
+            break; // EOI or start of scan.
+        const length = u16be(b, offset + 2);
+        if (length < 2)
+            break;
+        if (SOF_MARKERS.has(marker) && offset + 9 <= b.length) {
+            height = u16be(b, offset + 5);
+            width = u16be(b, offset + 7);
+            progressive = marker === 0xc2 || marker === 0xc6 || marker === 0xca;
+            if (orientation !== undefined)
+                break;
+        }
+        else if (marker === 0xe1 && ascii(b, offset + 4, 4) === 'Exif') {
+            orientation = readExifOrientation(b, offset + 10, length - 8);
+            if (width !== 0)
+                break;
+        }
+        offset += 2 + length;
+    }
+    return {
+        format: 'jpeg',
+        width,
+        height,
+        hasAlpha: false,
+        isAnimated: false,
+        ...(orientation !== undefined ? { orientation } : {}),
+        ...(progressive ? { space: 'progressive' } : {}),
+    };
+}
+/**
+ * Pulls tag 0x0112 (Orientation) out of an EXIF TIFF header.
+ * Returns undefined rather than throwing on anything malformed.
+ */
+function readExifOrientation(b, start, length) {
+    if (start + 8 > b.length)
+        return undefined;
+    const byteOrder = ascii(b, start, 2);
+    const little = byteOrder === 'II';
+    if (!little && byteOrder !== 'MM')
+        return undefined;
+    const u16 = (i) => (little ? u16le(b, i) : u16be(b, i));
+    const u32 = (i) => (little ? u32le(b, i) : u32be(b, i));
+    const ifdOffset = u32(start + 4);
+    const ifd = start + ifdOffset;
+    if (ifd + 2 > b.length || ifdOffset > length)
+        return undefined;
+    const entries = u16(ifd);
+    for (let i = 0; i < entries; i++) {
+        const entry = ifd + 2 + i * 12;
+        if (entry + 12 > b.length)
+            return undefined;
+        if (u16(entry) === 0x0112) {
+            const value = u16(entry + 8);
+            return value >= 1 && value <= 8 ? value : undefined;
+        }
+    }
+    return undefined;
+}
+// ---------------------------------------------------------------------------
+// GIF
+// ---------------------------------------------------------------------------
+const isGif = (b) => ascii(b, 0, 6) === 'GIF87a' || ascii(b, 0, 6) === 'GIF89a';
+function readGif(b) {
+    return {
+        format: 'gif',
+        width: b.length >= 10 ? u16le(b, 6) : 0,
+        height: b.length >= 10 ? u16le(b, 8) : 0,
+        hasAlpha: true,
+        // More than one Graphic Control Extension means more than one frame. A
+        // single-frame GIF with a GCE exists, so this counts occurrences.
+        isAnimated: countGifFrames(b) > 1,
+    };
+}
+function countGifFrames(b) {
+    let count = 0;
+    for (let i = 0; i + 2 < b.length && count < 2; i++) {
+        if (b[i] === 0x00 && b[i + 1] === 0x21 && b[i + 2] === 0xf9)
+            count++;
+    }
+    return count;
+}
+// ---------------------------------------------------------------------------
+// WebP
+// ---------------------------------------------------------------------------
+const isWebp = (b) => ascii(b, 0, 4) === 'RIFF' && ascii(b, 8, 4) === 'WEBP';
+function readWebp(b) {
+    const chunk = ascii(b, 12, 4);
+    const base = { format: 'webp', hasAlpha: false, isAnimated: false };
+    if (chunk === 'VP8X' && b.length >= 30) {
+        const flags = b[20];
+        return {
+            ...base,
+            // VP8X stores canvas dimensions minus one, as 24-bit little-endian.
+            width: u24le(b, 24) + 1,
+            height: u24le(b, 27) + 1,
+            hasAlpha: (flags & 0x10) !== 0,
+            isAnimated: (flags & 0x02) !== 0,
+        };
+    }
+    if (chunk === 'VP8 ' && b.length >= 30) {
+        // Lossy: 3-byte frame tag, then the 0x9d012a start code.
+        if (b[23] === 0x9d && b[24] === 0x01 && b[25] === 0x2a) {
+            return { ...base, width: u16le(b, 26) & 0x3fff, height: u16le(b, 28) & 0x3fff };
+        }
+    }
+    if (chunk === 'VP8L' && b.length >= 25 && b[20] === 0x2f) {
+        // Lossless: 14 bits width-1 then 14 bits height-1, packed little-endian.
+        const bits = u32le(b, 21);
+        return {
+            ...base,
+            width: (bits & 0x3fff) + 1,
+            height: ((bits >> 14) & 0x3fff) + 1,
+            hasAlpha: ((bits >> 28) & 0x01) !== 0,
+        };
+    }
+    return { ...base, width: 0, height: 0 };
+}
+// ---------------------------------------------------------------------------
+// AVIF / HEIC (ISO base media file format)
+// ---------------------------------------------------------------------------
+const isIsoBmff = (b) => b.length >= 12 && ascii(b, 4, 4) === 'ftyp';
+const AVIF_BRANDS = new Set(['avif', 'avis']);
+const HEIC_BRANDS = new Set(['heic', 'heix', 'hevc', 'hevx', 'mif1', 'msf1', 'heim', 'heis']);
+function readIsoBmff(b) {
+    const major = ascii(b, 8, 4);
+    const brands = new Set([major]);
+    const ftypSize = u32be(b, 0);
+    for (let i = 16; i + 4 <= Math.min(ftypSize, b.length); i += 4)
+        brands.add(ascii(b, i, 4));
+    let format = 'unknown';
+    for (const brand of brands) {
+        if (AVIF_BRANDS.has(brand)) {
+            format = 'avif';
+            break;
+        }
+        if (HEIC_BRANDS.has(brand))
+            format = 'heic';
+    }
+    if (format === 'unknown')
+        return { format, width: 0, height: 0 };
+    const ispe = findBox(b, ['meta', 'iprp', 'ipco', 'ispe'], 0, b.length);
+    const dims = ispe ? { width: u32be(b, ispe + 4), height: u32be(b, ispe + 8) } : { width: 0, height: 0 };
+    return {
+        format,
+        ...dims,
+        hasAlpha: findBox(b, ['meta', 'iprp', 'ipco', 'auxC'], 0, b.length) !== undefined,
+        isAnimated: brands.has('avis') || brands.has('msf1'),
+    };
+}
+/** Container boxes whose payload starts with a 4-byte version/flags field. */
+const FULL_BOXES = new Set(['meta']);
+/**
+ * Walks an ISO-BMFF box path and returns the payload offset of the final box.
+ * Returns undefined when any segment of the path is missing or malformed.
+ */
+function findBox(b, path, start, end) {
+    const [target, ...rest] = path;
+    if (target === undefined)
+        return start;
+    let offset = start;
+    while (offset + 8 <= end) {
+        let size = u32be(b, offset);
+        const type = ascii(b, offset + 4, 4);
+        let headerSize = 8;
+        if (size === 1) {
+            // 64-bit extended size. We only care about the low word; images this
+            // large are rejected by validation long before we get here.
+            if (offset + 16 > end)
+                return undefined;
+            size = u32be(b, offset + 12);
+            headerSize = 16;
+        }
+        else if (size === 0) {
+            size = end - offset; // Box runs to the end of the container.
+        }
+        if (size < headerSize || offset + size > end)
+            return undefined;
+        if (type === target) {
+            const payload = offset + headerSize + (FULL_BOXES.has(type) ? 4 : 0);
+            return rest.length === 0 ? payload : findBox(b, rest, payload, offset + size);
+        }
+        offset += size;
+    }
+    return undefined;
+}
+// ---------------------------------------------------------------------------
+// TIFF
+// ---------------------------------------------------------------------------
+const isTiff = (b) => (startsWith(b, [0x49, 0x49, 0x2a, 0x00]) || startsWith(b, [0x4d, 0x4d, 0x00, 0x2a])) &&
+    b.length >= 8;
+function readTiff(b) {
+    const little = b[0] === 0x49;
+    const u16 = (i) => (little ? u16le(b, i) : u16be(b, i));
+    const u32 = (i) => (little ? u32le(b, i) : u32be(b, i));
+    const ifd = u32(4);
+    let width = 0;
+    let height = 0;
+    if (ifd + 2 <= b.length) {
+        const entries = u16(ifd);
+        for (let i = 0; i < entries; i++) {
+            const entry = ifd + 2 + i * 12;
+            if (entry + 12 > b.length)
+                break;
+            const tag = u16(entry);
+            const type = u16(entry + 2);
+            // Tag values are SHORT (3) or LONG (4); both fit inline in the value field.
+            const value = type === 3 ? u16(entry + 8) : u32(entry + 8);
+            if (tag === 0x0100)
+                width = value;
+            else if (tag === 0x0101)
+                height = value;
+            if (width && height)
+                break;
+        }
+    }
+    return { format: 'tiff', width, height };
+}
+// ---------------------------------------------------------------------------
+// BMP / ICO / SVG
+// ---------------------------------------------------------------------------
+const isBmp = (b) => startsWith(b, [0x42, 0x4d]);
+function readBmp(b) {
+    return {
+        format: 'bmp',
+        width: b.length >= 26 ? u32le(b, 18) : 0,
+        height: b.length >= 26 ? Math.abs(u32le(b, 22) | 0) : 0,
+    };
+}
+const isIco = (b) => startsWith(b, [0x00, 0x00, 0x01, 0x00]);
+function readIco(b) {
+    // A zero in the width/height byte means 256.
+    const w = b[6] ?? 0;
+    const h = b[7] ?? 0;
+    return { format: 'ico', width: w === 0 ? 256 : w, height: h === 0 ? 256 : h };
+}
+function isSvg(b) {
+    const head = ascii(b, 0, Math.min(1024, b.length)).trimStart().toLowerCase();
+    return head.startsWith('<svg') || (head.startsWith('<?xml') && head.includes('<svg'));
+}
+function readSvg(b) {
+    const head = ascii(b, 0, Math.min(2048, b.length));
+    const width = parseSvgLength(head, 'width');
+    const height = parseSvgLength(head, 'height');
+    if (width && height)
+        return { format: 'svg', width, height, hasAlpha: true };
+    const viewBox = /viewBox\s*=\s*["']\s*[-\d.eE]+[\s,]+[-\d.eE]+[\s,]+([\d.eE]+)[\s,]+([\d.eE]+)/.exec(head);
+    return {
+        format: 'svg',
+        width: viewBox ? Math.round(Number(viewBox[1])) || 0 : 0,
+        height: viewBox ? Math.round(Number(viewBox[2])) || 0 : 0,
+        hasAlpha: true,
+    };
+}
+function parseSvgLength(head, attr) {
+    const match = new RegExp(`\\b${attr}\\s*=\\s*["']\\s*([\\d.]+)\\s*(px)?\\s*["']`).exec(head);
+    return match ? Math.round(Number(match[1])) || 0 : 0;
+}
+//# sourceMappingURL=sniff.js.map

package/dist/esm/sniff.js.map

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

package/dist/esm/source.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Turning the many shapes of "an image" into bytes plus a filename.
+ *
+ * Node builtins only - `node:fs/promises` for paths, global `fetch` for remote
+ * URLs (Node 18+), and manual concatenation for async iterables.
+ */
+import { formatBytes } from './bytes.js';
+import type { ImageSource } from './types.js';
+/** Bytes plus whatever we learned about where they came from. */
+export interface ResolvedSource {
+    readonly data: Uint8Array;
+    /** Basename including extension, or `'image'` when nothing better is known. */
+    readonly filename: string;
+    /** MIME type declared by the transport, if any. Never trusted for validation. */
+    readonly contentType?: string;
+    /** Where the bytes came from, for error messages. */
+    readonly origin: 'path' | 'buffer' | 'stream' | 'url';
+}
+export interface ResolveOptions {
+    /** Overrides any filename derived from the source. */
+    readonly filename?: string;
+    /** Permit `http:` / `https:` sources. Off by default. */
+    readonly allowRemote?: boolean;
+    /** Hard ceiling applied while reading, so a huge stream cannot exhaust memory. */
+    readonly maxBytes?: number;
+    readonly signal?: AbortSignal;
+}
+/**
+ * Normalises any {@link ImageSource} into a buffer.
+ *
+ * @throws {LensError} `INVALID_SOURCE` for an unrecognised shape,
+ *   `SOURCE_UNREADABLE` when the read itself fails,
+ *   `VALIDATION_FAILED` when `maxBytes` is exceeded mid-read.
+ *
+ * @example
+ * ```ts
+ * await resolveSource('./photo.jpg');
+ * await resolveSource(request.body, { filename: 'upload.png', maxBytes: 5_000_000 });
+ * ```
+ */
+export declare function resolveSource(source: ImageSource, options?: ResolveOptions): Promise<ResolvedSource>;
+/** Filename without its extension. */
+export declare function stem(filename: string): string;
+export { formatBytes };
+//# sourceMappingURL=source.d.ts.map

package/dist/esm/source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../src/source.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,iEAAiE;AACjE,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,+EAA+E;IAC/E,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,iFAAiF;IACjF,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,qDAAqD;IACrD,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,KAAK,CAAC;CACvD;AAED,MAAM,WAAW,cAAc;IAC7B,sDAAsD;IACtD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,yDAAyD;IACzD,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,kFAAkF;IAClF,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAKD;;;;;;;;;;;;GAYG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,WAAW,EACnB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,cAAc,CAAC,CAsDzB;AAwID,sCAAsC;AACtC,wBAAgB,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG7C;AAQD,OAAO,EAAE,WAAW,EAAE,CAAC"}