@intactfile/engines 0.1.0

package/dist/detect/index.js

@@ -0,0 +1,159 @@
+import { FLAG_DATA_DESCRIPTOR, LFH_FIXED_SIZE, SIG_EOCD, SIG_LFH, U32_MAX, parseLocalHeader, readU32, } from '../zip/format.js';
+const SCAN_WINDOW = 64 * 1024;
+function ascii(b, from, to) {
+    let s = '';
+    for (let i = from; i < Math.min(to, b.length); i++)
+        s += String.fromCharCode(b[i]);
+    return s;
+}
+function indexOfBytes(haystack, needle, from = 0) {
+    outer: for (let i = from; i + needle.length <= haystack.length; i++) {
+        for (let j = 0; j < needle.length; j++) {
+            if (haystack[i + j] !== needle[j])
+                continue outer;
+        }
+        return i;
+    }
+    return -1;
+}
+/** Quick, trusting walk over the first local headers just to collect entry names. */
+async function probeZipEntryNames(src, base) {
+    const names = [];
+    let pos = base;
+    for (let i = 0; i < 16; i++) {
+        const fixed = await src.read(pos, LFH_FIXED_SIZE);
+        if (fixed.length < LFH_FIXED_SIZE || readU32(fixed, 0) !== SIG_LFH)
+            break;
+        const h = parseLocalHeader(fixed);
+        if (!h || h.nameLength === 0 || h.nameLength > 4096)
+            break;
+        const nameBytes = await src.read(pos + LFH_FIXED_SIZE, h.nameLength);
+        names.push(new TextDecoder('utf-8').decode(nameBytes));
+        if (h.flags & FLAG_DATA_DESCRIPTOR || h.compressedSize === U32_MAX)
+            break;
+        pos += LFH_FIXED_SIZE + h.nameLength + h.extraLength + h.compressedSize;
+    }
+    return names;
+}
+function ooxmlContainer(names) {
+    if (!names.some((n) => n === '[Content_Types].xml'))
+        return 'zip';
+    if (names.some((n) => n.startsWith('word/')))
+        return 'docx';
+    if (names.some((n) => n.startsWith('xl/')))
+        return 'xlsx';
+    if (names.some((n) => n.startsWith('ppt/')))
+        return 'pptx';
+    return 'ooxml';
+}
+async function detectZipAt(src, base, confidence, notes) {
+    const names = await probeZipEntryNames(src, base);
+    const container = ooxmlContainer(names);
+    if (container !== 'zip')
+        notes.push('OOXML package detected via [Content_Types].xml');
+    return { format: 'zip', container, confidence, notes };
+}
+/**
+ * Magic-byte format sniffing with garbage-prefix tolerance. Shared diagnosis
+ * entry point for the app UI.
+ */
+export async function detectFormat(src) {
+    const notes = [];
+    const head = await src.read(0, Math.min(src.size, 4096));
+    if (head.length < 4) {
+        return { format: 'unknown', confidence: 'low', notes: ['file too small to identify'] };
+    }
+    // PNG
+    if (head[0] === 0x89 && head[1] === 0x50 && head[2] === 0x4e && head[3] === 0x47 &&
+        head[4] === 0x0d && head[5] === 0x0a && head[6] === 0x1a && head[7] === 0x0a) {
+        return { format: 'png', confidence: 'high', notes };
+    }
+    // JPEG
+    if (head[0] === 0xff && head[1] === 0xd8 && head[2] === 0xff) {
+        return { format: 'jpeg', confidence: 'high', notes };
+    }
+    // RIFF (WAV / AVI)
+    if (ascii(head, 0, 4) === 'RIFF' && head.length >= 12) {
+        const kind = ascii(head, 8, 12);
+        if (kind === 'WAVE')
+            return { format: 'wav', container: 'riff', confidence: 'high', notes };
+        if (kind === 'AVI ')
+            return { format: 'avi', container: 'riff', confidence: 'high', notes };
+        notes.push(`unrecognized RIFF type "${kind.trim()}"`);
+        return { format: 'riff', container: 'riff', confidence: 'medium', notes };
+    }
+    // EBML (MKV / WebM)
+    if (head[0] === 0x1a && head[1] === 0x45 && head[2] === 0xdf && head[3] === 0xa3) {
+        const header = ascii(head, 0, head.length);
+        if (header.includes('webm'))
+            return { format: 'webm', confidence: 'high', notes };
+        if (header.includes('matroska'))
+            return { format: 'mkv', confidence: 'high', notes };
+        notes.push('EBML header without a recognizable DocType');
+        return { format: 'mkv', confidence: 'medium', notes };
+    }
+    // ZIP at offset 0
+    if (readU32(head, 0) === SIG_LFH) {
+        return detectZipAt(src, 0, 'high', notes);
+    }
+    if (readU32(head, 0) === SIG_EOCD) {
+        notes.push('empty zip archive (EOCD only)');
+        return { format: 'zip', container: 'zip', confidence: 'high', notes };
+    }
+    // PDF at offset 0
+    if (ascii(head, 0, 5) === '%PDF-') {
+        return { format: 'pdf', confidence: 'high', notes };
+    }
+    // MP4 / MOV: ftyp box at start
+    if (head.length >= 12 && ascii(head, 4, 8) === 'ftyp') {
+        const brand = ascii(head, 8, 12);
+        const boxSize = readU32be(head, 0);
+        if (boxSize < 8 || boxSize > src.size)
+            notes.push('implausible ftyp box size');
+        const isMov = brand.startsWith('qt');
+        return {
+            format: isMov ? 'mov' : 'mp4',
+            container: brand.trim(),
+            confidence: boxSize >= 8 && boxSize <= src.size ? 'high' : 'medium',
+            notes,
+        };
+    }
+    // MP3 with ID3 tag
+    if (ascii(head, 0, 3) === 'ID3') {
+        return { format: 'mp3', confidence: 'high', notes };
+    }
+    // Tolerant scans over a larger window.
+    const window = src.size <= head.length ? head : await src.read(0, Math.min(src.size, SCAN_WINDOW));
+    const pdfAt = indexOfBytes(window, [0x25, 0x50, 0x44, 0x46, 0x2d]); // %PDF-
+    if (pdfAt > 0) {
+        notes.push(`PDF header found at offset ${pdfAt} (garbage prefix)`);
+        return { format: 'pdf', confidence: pdfAt <= 1024 ? 'high' : 'medium', notes };
+    }
+    const ftypAt = indexOfBytes(window, [0x66, 0x74, 0x79, 0x70]); // 'ftyp'
+    if (ftypAt >= 4) {
+        const brand = ascii(window, ftypAt + 4, ftypAt + 8);
+        notes.push(`ftyp box found at offset ${ftypAt - 4}`);
+        return { format: brand.startsWith('qt') ? 'mov' : 'mp4', container: brand.trim(), confidence: 'medium', notes };
+    }
+    const zipAt = indexOfBytes(window, [0x50, 0x4b, 0x03, 0x04]);
+    if (zipAt > 0) {
+        notes.push(`zip local header found at offset ${zipAt} (garbage prefix)`);
+        return detectZipAt(src, zipAt, 'medium', notes);
+    }
+    // Bare MPEG frame sync (weak signal, checked last).
+    const b1 = head[1];
+    if (head[0] === 0xff &&
+        (b1 & 0xe0) === 0xe0 &&
+        ((b1 >> 3) & 0x03) !== 1 && // MPEG version: reserved
+        ((b1 >> 1) & 0x03) !== 0 && // layer: reserved
+        head[2] >>> 4 !== 0x0f // bitrate: invalid
+    ) {
+        notes.push('bare MPEG audio frame sync (no ID3 tag)');
+        return { format: 'mp3', confidence: 'medium', notes };
+    }
+    return { format: 'unknown', confidence: 'low', notes: [...notes, 'no known magic bytes matched'] };
+}
+function readU32be(b, o) {
+    return ((b[o] << 24) | (b[o + 1] << 16) | (b[o + 2] << 8) | b[o + 3]) >>> 0;
+}
+//# sourceMappingURL=index.js.map

package/dist/detect/index.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+export type { ByteSource } from './byte-source.js';
+export { MemorySource } from './byte-source.js';
+export { BlobSource } from './bytesource/blob.js';
+export { crc32 } from './crc32.js';
+export type { Confidence } from './types.js';
+export { diagnoseZip, analyzeZip } from './zip/diagnose.js';
+export type { ZipDiagnosis, DamageClass, ZipAnalysis } from './zip/diagnose.js';
+export { repairZip } from './zip/repair.js';
+export type { RepairReport, RepairEntryReport } from './zip/repair.js';
+export { scanLocalEntries, findEocd } from './zip/scan.js';
+export type { ScanResult, ScannedEntry, EocdResult } from './zip/scan.js';
+export { validateEntry } from './zip/salvage.js';
+export type { ValidatedEntry, EntryStatus } from './zip/salvage.js';
+export { buildZip } from './zip/writer.js';
+export type { OutEntry } from './zip/writer.js';
+export { parseLocalHeader, parseZip64Extra, parseEocd, reconcileDeclaredSize, localHeaderLooksSane, } from './zip/format.js';
+export type { LocalHeader, Zip64Extra, Eocd } from './zip/format.js';
+export { detectFormat } from './detect/index.js';
+export type { FormatDetection, FileFormat } from './detect/index.js';
+export { diagnosePdf } from './pdf/diagnose.js';
+export type { PdfDiagnosis, PdfDamageClass } from './pdf/diagnose.js';
+export { diagnoseVideo } from './video/diagnose.js';
+export type { VideoDiagnosis, VideoDamageClass, VideoContainer, VideoBoxInfo } from './video/diagnose.js';
+//# 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,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC5D,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChF,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC3D,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,YAAY,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,SAAS,EACT,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAErE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAIrE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAItE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,17 @@
+export { MemorySource } from './byte-source.js';
+export { BlobSource } from './bytesource/blob.js';
+export { crc32 } from './crc32.js';
+export { diagnoseZip, analyzeZip } from './zip/diagnose.js';
+export { repairZip } from './zip/repair.js';
+export { scanLocalEntries, findEocd } from './zip/scan.js';
+export { validateEntry } from './zip/salvage.js';
+export { buildZip } from './zip/writer.js';
+export { parseLocalHeader, parseZip64Extra, parseEocd, reconcileDeclaredSize, localHeaderLooksSane, } from './zip/format.js';
+export { detectFormat } from './detect/index.js';
+// PDF diagnosis is pure byte-scanning (no qpdf wasm in its import chain), so it
+// is safe in the browser-facing root export; repairPdf stays behind './pdf'.
+export { diagnosePdf } from './pdf/diagnose.js';
+// Video diagnosis is likewise pure own parsing (no libav.js in its import
+// chain); remuxVideo stays behind './video'.
+export { diagnoseVideo } from './video/diagnose.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGnC,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE5D,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE3D,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,SAAS,EACT,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGjD,gFAAgF;AAChF,6EAA6E;AAC7E,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGhD,0EAA0E;AAC1E,6CAA6C;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/jpeg/browser-loader.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Browser-side loader for the @jsquash/jpeg codec wasm. Hand the result of
+ * `createBrowserJpegLoader()` to `setJpegLoader()` before calling
+ * `repairJpeg()` in a browser.
+ *
+ * The two .wasm files are NOT bundled: they must be served as same-origin
+ * static assets (apps/www/app copy them to /engines/jpeg/ at build time).
+ * Same-origin is a product requirement — "your file never leaves your device"
+ * stays verifiable in the Network tab only if no third-party host is involved.
+ * The @jsquash JS wrappers themselves are bundled and pulled into the './jpeg'
+ * lazy chunk; only the wasm is fetched, and only on the first repair.
+ */
+import type { JpegCodecLoader } from './mozjpeg-host.js';
+/** Where the app serves the codec wasm from. */
+export declare const DEFAULT_JPEG_BASE_URL = "/engines/jpeg/";
+/**
+ * Build a loader for `setJpegLoader()`. `baseUrl` is the same-origin directory
+ * the two wasm files are served from; trailing slash optional.
+ */
+export declare function createBrowserJpegLoader(baseUrl?: string): () => Promise<JpegCodecLoader>;
+//# sourceMappingURL=browser-loader.d.ts.map

package/dist/jpeg/browser-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-loader.d.ts","sourceRoot":"","sources":["../../src/jpeg/browser-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,gDAAgD;AAChD,eAAO,MAAM,qBAAqB,mBAAmB,CAAC;AActD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,GAAE,MAA8B,GAAG,MAAM,OAAO,CAAC,eAAe,CAAC,CAQ/G"}

package/dist/jpeg/browser-loader.js

@@ -0,0 +1,28 @@
+/** Where the app serves the codec wasm from. */
+export const DEFAULT_JPEG_BASE_URL = '/engines/jpeg/';
+async function compileFrom(url) {
+    if (typeof WebAssembly.compileStreaming === 'function') {
+        try {
+            return await WebAssembly.compileStreaming(fetch(url));
+        }
+        catch {
+            // Fall back when the server doesn't send application/wasm.
+        }
+    }
+    const res = await fetch(url);
+    return WebAssembly.compile(await res.arrayBuffer());
+}
+/**
+ * Build a loader for `setJpegLoader()`. `baseUrl` is the same-origin directory
+ * the two wasm files are served from; trailing slash optional.
+ */
+export function createBrowserJpegLoader(baseUrl = DEFAULT_JPEG_BASE_URL) {
+    const b = baseUrl.endsWith('/') ? baseUrl : `${baseUrl}/`;
+    const decUrl = `${b}mozjpeg_dec.wasm`;
+    const encUrl = `${b}mozjpeg_enc.wasm`;
+    return async () => ({
+        decodeModule: () => compileFrom(decUrl),
+        encodeModule: () => compileFrom(encUrl),
+    });
+}
+//# sourceMappingURL=browser-loader.js.map

package/dist/jpeg/browser-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-loader.js","sourceRoot":"","sources":["../../src/jpeg/browser-loader.ts"],"names":[],"mappings":"AAcA,gDAAgD;AAChD,MAAM,CAAC,MAAM,qBAAqB,GAAG,gBAAgB,CAAC;AAEtD,KAAK,UAAU,WAAW,CAAC,GAAW;IACpC,IAAI,OAAO,WAAW,CAAC,gBAAgB,KAAK,UAAU,EAAE,CAAC;QACvD,IAAI,CAAC;YACH,OAAO,MAAM,WAAW,CAAC,gBAAgB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;QACxD,CAAC;QAAC,MAAM,CAAC;YACP,2DAA2D;QAC7D,CAAC;IACH,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;IAC7B,OAAO,WAAW,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;AACtD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,UAAkB,qBAAqB;IAC7E,MAAM,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,GAAG,CAAC;IAC1D,MAAM,MAAM,GAAG,GAAG,CAAC,kBAAkB,CAAC;IACtC,MAAM,MAAM,GAAG,GAAG,CAAC,kBAAkB,CAAC;IACtC,OAAO,KAAK,IAAI,EAAE,CAAC,CAAC;QAClB,YAAY,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC;QACvC,YAAY,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC;KACxC,CAAC,CAAC;AACL,CAAC"}

package/dist/jpeg/diagnose.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Structural JPEG diagnosis via a pure marker scan — no wasm anywhere in this
+ * import chain, so it is cheap and safe to run before any repair (and in the
+ * browser without loading the codec).
+ *
+ * It reports the presence and order of the framing markers (SOI/APPn/DQT/DHT/
+ * SOF/SOS/EOI), classifies the damage, and — as a triage hint — measures the
+ * Shannon entropy of the entropy-coded scan region. High entropy means real
+ * compressed pixel data is still there (salvageable); near-zero entropy means
+ * the scan was zeroed or overwritten (no software can bring those pixels back,
+ * per docs/03 §4).
+ *
+ * Honesty: a truncated file is never called "fine"; a file whose scan was
+ * overwritten is flagged as such rather than reported as recoverable.
+ */
+import type { ByteSource } from '../byte-source.js';
+import type { Confidence } from '../types.js';
+export type JpegDamageClass = 'none' | 'header-damage' | 'truncated' | 'marker-corruption' | 'garbage-prefix' | 'not-jpeg' | 'unknown';
+export interface JpegDiagnosis {
+    damageClass: JpegDamageClass;
+    confidence: Confidence;
+    notes: string[];
+    /** Offset of SOI (0xFFD8); 0 normally, > 0 for a garbage prefix, null if absent. */
+    soiOffset: number | null;
+    hasEoi: boolean;
+    hasSof: boolean;
+    hasSos: boolean;
+    hasDqt: boolean;
+    hasDht: boolean;
+    /** Framing markers in the order the sequential walk saw them. */
+    markerOrder: string[];
+    /** Frame dimensions from SOF, when a SOF segment is readable. */
+    width: number | null;
+    height: number | null;
+    /**
+     * Shannon entropy (bits/byte) of the scan region, or null when there is no
+     * scan. A hint, not a verdict: ~7+ = live compressed data; ~0 = destroyed.
+     */
+    scanEntropy: number | null;
+}
+/** Below this, a scan region looks zeroed/overwritten rather than compressed. */
+export declare const LOW_SCAN_ENTROPY = 1.5;
+/** How far in we still look for a shifted SOI (garbage prefix). */
+export declare const SOI_SCAN_WINDOW: number;
+/**
+ * Diagnose a JPEG from raw bytes. Pure and side-effect free; never loads the
+ * codec.
+ */
+export declare function diagnoseJpeg(src: ByteSource): Promise<JpegDiagnosis>;
+//# sourceMappingURL=diagnose.d.ts.map

package/dist/jpeg/diagnose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnose.d.ts","sourceRoot":"","sources":["../../src/jpeg/diagnose.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAa9C,MAAM,MAAM,eAAe,GACvB,MAAM,GACN,eAAe,GACf,WAAW,GACX,mBAAmB,GACnB,gBAAgB,GAChB,UAAU,GACV,SAAS,CAAC;AAEd,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,eAAe,CAAC;IAC7B,UAAU,EAAE,UAAU,CAAC;IACvB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,oFAAoF;IACpF,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,iEAAiE;IACjE,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,iEAAiE;IACjE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB;;;OAGG;IACH,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,iFAAiF;AACjF,eAAO,MAAM,gBAAgB,MAAM,CAAC;AACpC,mEAAmE;AACnE,eAAO,MAAM,eAAe,QAAU,CAAC;AAEvC;;;GAGG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC,CAgI1E"}

package/dist/jpeg/diagnose.js

@@ -0,0 +1,124 @@
+import { M_DHT, M_DQT, findSoi, isSofMarker, readSofDimensions, readU16BE, scanMarkerPresence, scanMarkers, shannonEntropy, } from './format.js';
+/** Below this, a scan region looks zeroed/overwritten rather than compressed. */
+export const LOW_SCAN_ENTROPY = 1.5;
+/** How far in we still look for a shifted SOI (garbage prefix). */
+export const SOI_SCAN_WINDOW = 1 << 16;
+/**
+ * Diagnose a JPEG from raw bytes. Pure and side-effect free; never loads the
+ * codec.
+ */
+export async function diagnoseJpeg(src) {
+    const notes = [];
+    const base = {
+        notes,
+        soiOffset: null,
+        hasEoi: false,
+        hasSof: false,
+        hasSos: false,
+        hasDqt: false,
+        hasDht: false,
+        markerOrder: [],
+        width: null,
+        height: null,
+        scanEntropy: null,
+    };
+    const done = (damageClass, confidence) => ({
+        damageClass,
+        confidence,
+        ...base,
+    });
+    if (src.size === 0) {
+        notes.push('file is empty');
+        return done('not-jpeg', 'high');
+    }
+    const bytes = await src.read(0, src.size);
+    const soi = findSoi(bytes, SOI_SCAN_WINDOW);
+    if (soi === -1) {
+        notes.push(`no SOI (0xFFD8) marker in the first ${Math.min(bytes.length, SOI_SCAN_WINDOW)} bytes`);
+        return done('not-jpeg', bytes.length <= SOI_SCAN_WINDOW ? 'high' : 'medium');
+    }
+    base.soiOffset = soi;
+    // The strict sequential walk is the source of truth: it skips every segment
+    // by its declared length, so nested markers inside an intact APP1/EXIF
+    // thumbnail never leak into presence detection. Only when the walk breaks
+    // before resolving SOS (a destroyed/garbled header) do we fall back to a
+    // robust byte-level marker scan to find whatever survived past the break.
+    const seq = scanMarkers(bytes, soi);
+    const firstSof = seq.segments.find((s) => isSofMarker(s.marker));
+    base.hasDqt = seq.segments.some((s) => s.marker === M_DQT);
+    base.hasDht = seq.segments.some((s) => s.marker === M_DHT);
+    base.hasSof = firstSof !== undefined;
+    base.hasSos = seq.sosOffset !== -1;
+    base.hasEoi = seq.hasEoi;
+    let sosOffset = seq.sosOffset;
+    let eoiOffset = seq.eoiOffset;
+    let sofOffset = firstSof?.offset ?? -1;
+    const framingBroken = seq.badMarker || seq.overflow || seq.truncatedHeader;
+    if (!base.hasSos && framingBroken) {
+        const pres = scanMarkerPresence(bytes, soi + 2);
+        base.hasDqt = pres.hasDqt;
+        base.hasDht = pres.hasDht;
+        base.hasSof = pres.hasSof;
+        base.hasSos = pres.hasSos;
+        base.hasEoi = pres.hasEoi;
+        sosOffset = pres.sosOffset;
+        eoiOffset = pres.eoiOffset;
+        sofOffset = pres.sofOffset;
+    }
+    base.markerOrder = ['SOI', ...seq.segments.map((s) => s.name), ...(seq.hasEoi ? ['EOI'] : [])];
+    if (sofOffset !== -1) {
+        const dims = readSofDimensions(bytes, sofOffset);
+        if (dims) {
+            base.width = dims.width;
+            base.height = dims.height;
+        }
+    }
+    // Entropy of the scan region, when a SOS was resolved.
+    if (sosOffset !== -1) {
+        const sosLen = readU16BE(bytes, sosOffset + 2);
+        const scanStart = sosOffset + 2 + sosLen;
+        const scanEnd = base.hasEoi && eoiOffset !== -1 ? eoiOffset : bytes.length;
+        base.scanEntropy = shannonEntropy(bytes, scanStart, scanEnd);
+    }
+    // --- Classification ------------------------------------------------------
+    if (soi > 0) {
+        notes.push(`SOI found at offset ${soi} (garbage prefix of ${soi} bytes)`);
+        if (!base.hasSos)
+            notes.push('no scan segment after the prefix; there may be little to recover');
+        return done('garbage-prefix', base.hasSos && base.hasEoi ? 'high' : 'medium');
+    }
+    const liveScan = base.scanEntropy !== null && base.scanEntropy >= LOW_SCAN_ENTROPY;
+    if (!base.hasSos) {
+        if (framingBroken) {
+            notes.push('file ends inside the JPEG header, before the scan (SOS) — truncated early');
+            return done('truncated', 'medium');
+        }
+        notes.push('no SOS marker: no image scan data present');
+        return done(base.hasSof || base.hasDqt || base.hasDht ? 'truncated' : 'unknown', 'low');
+    }
+    if (!base.hasEoi) {
+        notes.push('SOS present but no trailing EOI: the scan was cut off (truncated)');
+        if (base.scanEntropy !== null)
+            notes.push(`scan entropy ${base.scanEntropy.toFixed(2)} bits/byte`);
+        return done('truncated', liveScan ? 'high' : 'medium');
+    }
+    if (!base.hasSof || !base.hasDqt || !base.hasDht) {
+        const missing = [!base.hasSof && 'SOF', !base.hasDqt && 'DQT', !base.hasDht && 'DHT']
+            .filter(Boolean)
+            .join(', ');
+        notes.push(`scan and EOI survived but header tables are gone (missing ${missing})`);
+        notes.push('a healthy same-camera reference photo can donate the missing header');
+        return done('header-damage', liveScan ? 'high' : 'medium');
+    }
+    if (seq.badMarker || seq.overflow) {
+        notes.push('all key markers exist but the segment framing is broken mid-header (marker corruption)');
+        return done('marker-corruption', 'medium');
+    }
+    if (base.scanEntropy !== null && base.scanEntropy < LOW_SCAN_ENTROPY) {
+        notes.push(`structure is intact but the scan region entropy is only ${base.scanEntropy.toFixed(2)} bits/byte — ` +
+            'the pixel data looks zeroed or overwritten, which no repair can undo');
+        return done('marker-corruption', 'medium');
+    }
+    return done('none', 'high');
+}
+//# sourceMappingURL=diagnose.js.map

package/dist/jpeg/diagnose.js.map

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

package/dist/jpeg/exif.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Return the embedded EXIF thumbnail JPEG as bytes, or null when there is
+ * none / it cannot be read. Never throws.
+ */
+export declare function extractExifThumbnail(bytes: Uint8Array): Promise<Uint8Array | null>;
+/**
+ * Read the EXIF orientation tag (1..8), or null when absent/unreadable. Handy
+ * for a correctly-rotated preview; never throws.
+ */
+export declare function extractExifOrientation(bytes: Uint8Array): Promise<number | null>;
+//# sourceMappingURL=exif.d.ts.map

package/dist/jpeg/exif.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exif.d.ts","sourceRoot":"","sources":["../../src/jpeg/exif.ts"],"names":[],"mappings":"AAYA;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAYxF;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAWtF"}

package/dist/jpeg/exif.js

@@ -0,0 +1,50 @@
+/**
+ * EXIF thumbnail extraction via exifr 7.1.3 (MIT). Pure JS (no wasm), but kept
+ * off the diagnosis path and imported only by the repair flow.
+ *
+ * Most camera/phone JPEGs embed a small JPEG thumbnail in the APP1/EXIF IFD1.
+ * When the main image is unsalvageable (scan overwritten, header destroyed
+ * with no donor), that thumbnail is often the only real pixels left — a
+ * guaranteed, honest preview fallback ("we could only recover the embedded
+ * thumbnail", never presented as the repaired full-resolution image).
+ */
+import exifr from 'exifr';
+/**
+ * Return the embedded EXIF thumbnail JPEG as bytes, or null when there is
+ * none / it cannot be read. Never throws.
+ */
+export async function extractExifThumbnail(bytes) {
+    try {
+        // exifr accepts a Uint8Array/Buffer directly and returns the raw thumbnail
+        // JPEG (Uint8Array in Node, ArrayBuffer in browsers).
+        const thumb = await exifr.thumbnail(bytes);
+        if (!thumb)
+            return null;
+        if (thumb instanceof Uint8Array)
+            return thumb.length > 0 ? thumb : null;
+        if (thumb instanceof ArrayBuffer)
+            return thumb.byteLength > 0 ? new Uint8Array(thumb) : null;
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Read the EXIF orientation tag (1..8), or null when absent/unreadable. Handy
+ * for a correctly-rotated preview; never throws.
+ */
+export async function extractExifOrientation(bytes) {
+    try {
+        const meta = await exifr.parse(bytes, { pick: ['Orientation'], translateValues: false });
+        if (meta && typeof meta === 'object' && 'Orientation' in meta) {
+            const o = meta.Orientation;
+            return typeof o === 'number' ? o : null;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=exif.js.map

package/dist/jpeg/exif.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exif.js","sourceRoot":"","sources":["../../src/jpeg/exif.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,KAAiB;IAC1D,IAAI,CAAC;QACH,2EAA2E;QAC3E,sDAAsD;QACtD,MAAM,KAAK,GAAY,MAAM,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACpD,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QACxB,IAAI,KAAK,YAAY,UAAU;YAAE,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;QACxE,IAAI,KAAK,YAAY,WAAW;YAAE,OAAO,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC7F,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,KAAiB;IAC5D,IAAI,CAAC;QACH,MAAM,IAAI,GAAY,MAAM,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,aAAa,CAAC,EAAE,eAAe,EAAE,KAAK,EAAE,CAAC,CAAC;QAClG,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,aAAa,IAAI,IAAI,EAAE,CAAC;YAC9D,MAAM,CAAC,GAAI,IAAkC,CAAC,WAAW,CAAC;YAC1D,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC1C,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}