@intactfile/engines 0.2.0 → 0.3.0

package/dist/raw/format.d.ts

@@ -0,0 +1,47 @@
+export type RawContainer = "cr2" | "cr3" | "nef" | "arw" | "dng" | "raf" | "tiff";
+export type ByteOrder = "le" | "be";
+export declare const RAF_MAGIC = "FUJIFILMCCD-RAW ";
+export interface RawId {
+    container: RawContainer;
+    order?: ByteOrder;
+    /** offset of the true start of the container (0 unless a garbage prefix). */
+    offset: number;
+}
+/** Is a TIFF/RAF/CR3 magic present at exactly this offset? */
+export declare function rawIdAt(b: Uint8Array, offset?: number): RawId | null;
+/** Find the RAW magic at offset 0, or scanned within a garbage-prefix window. */
+export declare function findRawStart(b: Uint8Array, window?: number): RawId | null;
+/** Endianness-aware unsigned readers. */
+export declare function readers(order: ByteOrder): {
+    u16: (b: Uint8Array, o: number) => number;
+    u32: (b: Uint8Array, o: number) => number;
+};
+export interface TiffScan {
+    ok: boolean;
+    ifdCount: number;
+    entryTotal: number;
+    /** offsets (from offset tags / nextIFD / SubIFD) that point past EOF. */
+    dangling: number[];
+    /** largest end-of-data offset the IFDs reference (for truncation checks). */
+    maxRefEnd: number;
+    jpeg?: {
+        offset: number;
+        length: number;
+    };
+    notes: string[];
+}
+/**
+ * Walk the TIFF IFD chain from `ifd0`, following nextIFD, SubIFDs (0x014A) and
+ * the Exif IFD (0x8769). Records dangling offsets and the embedded-JPEG range
+ * (JPEGInterchangeFormat/Length). Bounded and tolerant of damage.
+ */
+export declare function walkTiff(b: Uint8Array, order: ByteOrder, ifd0: number): TiffScan;
+/**
+ * Universal preview salvage: the largest FFD8 FF … FFD9 span in the buffer.
+ * RAW previews are usually the biggest embedded JPEG (bigger than the thumbnail).
+ */
+export declare function findLargestJpeg(b: Uint8Array): {
+    offset: number;
+    length: number;
+} | null;
+//# sourceMappingURL=format.d.ts.map

package/dist/raw/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/raw/format.ts"],"names":[],"mappings":"AAWA,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;AAClF,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,IAAI,CAAC;AAEpC,eAAO,MAAM,SAAS,qBAAqB,CAAC;AAgB5C,MAAM,WAAW,KAAK;IACpB,SAAS,EAAE,YAAY,CAAC;IACxB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,6EAA6E;IAC7E,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,8DAA8D;AAC9D,wBAAgB,OAAO,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,SAAI,GAAG,KAAK,GAAG,IAAI,CAmB/D;AAED,iFAAiF;AACjF,wBAAgB,YAAY,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,SAAY,GAAG,KAAK,GAAG,IAAI,CAY5E;AAED,yCAAyC;AACzC,wBAAgB,OAAO,CAAC,KAAK,EAAE,SAAS;aAGzB,UAAU,KAAK,MAAM;aACrB,UAAU,KAAK,MAAM;EASnC;AAMD,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,OAAO,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,6EAA6E;IAC7E,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,QAAQ,CAuEhF;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,UAAU,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAoBxF"}

package/dist/raw/format.js

@@ -0,0 +1,213 @@
+/**
+ * Pure-TS format primitives for the RAW photo engine. RAW files are containers:
+ * CR2/NEF/ARW/DNG are TIFF (header + IFD chain + offset tags), CR3 is ISO-BMFF
+ * (ftyp "crx "), RAF is a Fujifilm big-endian container. All embed a full-size
+ * JPEG preview, which is our universal, deterministic recovery target.
+ *
+ * No WASM, no deps — byte arithmetic over a buffer. See docs/engineering/
+ * engine-raw-photo.md for the design.
+ */
+import { matchAscii } from "../bytes-util.js";
+export const RAF_MAGIC = "FUJIFILMCCD-RAW ";
+const TIFF_LE = [0x49, 0x49, 0x2a, 0x00]; // "II" 42
+const TIFF_BE = [0x4d, 0x4d, 0x00, 0x2a]; // "MM" 42
+const eqAt = (b, o, sig) => sig.every((x, i) => b[o + i] === x);
+const asciiWindow = (b, from, to) => {
+    let s = "";
+    for (let i = from; i < Math.min(to, b.length); i++) {
+        const c = b[i];
+        s += c >= 32 && c < 127 ? String.fromCharCode(c) : " ";
+    }
+    return s;
+};
+/** Is a TIFF/RAF/CR3 magic present at exactly this offset? */
+export function rawIdAt(b, offset = 0) {
+    const o = offset;
+    if (eqAt(b, o, TIFF_LE) || eqAt(b, o, TIFF_BE)) {
+        const order = b[o] === 0x49 ? "le" : "be";
+        let container = "tiff";
+        if (b[o + 8] === 0x43 && b[o + 9] === 0x52)
+            container = "cr2"; // "CR" Canon ext
+        else {
+            const s = asciiWindow(b, o, Math.min(b.length, o + 8192));
+            if (/NIKON/i.test(s))
+                container = "nef";
+            else if (/SONY/i.test(s))
+                container = "arw";
+            else if (/DNG|Adobe|GXR|PENTAX|Leica/i.test(s))
+                container = "dng";
+        }
+        return { container, order, offset: o };
+    }
+    if (matchAscii(b, o, RAF_MAGIC))
+        return { container: "raf", offset: o };
+    if (b.length >= o + 12 && matchAscii(b, o + 4, "ftyp") && matchAscii(b, o + 8, "crx ")) {
+        return { container: "cr3", offset: o };
+    }
+    return null;
+}
+/** Find the RAW magic at offset 0, or scanned within a garbage-prefix window. */
+export function findRawStart(b, window = 64 * 1024) {
+    const at0 = rawIdAt(b, 0);
+    if (at0)
+        return at0;
+    const limit = Math.min(b.length - 16, window);
+    for (let i = 1; i <= limit; i++) {
+        // cheap first-byte gate before the full check
+        if (b[i] === 0x49 || b[i] === 0x4d || b[i] === 0x46 || b[i + 4] === 0x66) {
+            const id = rawIdAt(b, i);
+            if (id)
+                return id;
+        }
+    }
+    return null;
+}
+/** Endianness-aware unsigned readers. */
+export function readers(order) {
+    if (order === "le") {
+        return {
+            u16: (b, o) => ((b[o] ?? 0) | ((b[o + 1] ?? 0) << 8)) >>> 0,
+            u32: (b, o) => (((b[o] ?? 0) | ((b[o + 1] ?? 0) << 8) | ((b[o + 2] ?? 0) << 16) | ((b[o + 3] ?? 0) << 24)) >>> 0),
+        };
+    }
+    return {
+        u16: (b, o) => (((b[o] ?? 0) << 8) | (b[o + 1] ?? 0)) >>> 0,
+        u32: (b, o) => ((((b[o] ?? 0) << 24) | ((b[o + 1] ?? 0) << 16) | ((b[o + 2] ?? 0) << 8) | (b[o + 3] ?? 0)) >>> 0),
+    };
+}
+// Offset-bearing TIFF tags whose value points elsewhere in the file.
+const OFFSET_TAGS = new Set([0x0111, 0x0117, 0x0144, 0x0145, 0x0201, 0x0202, 0x014a, 0x8769]);
+const TYPE_SIZE = { 1: 1, 2: 1, 3: 2, 4: 4, 5: 8, 6: 1, 7: 1, 8: 2, 9: 4, 10: 8, 11: 4, 12: 8 };
+/**
+ * Walk the TIFF IFD chain from `ifd0`, following nextIFD, SubIFDs (0x014A) and
+ * the Exif IFD (0x8769). Records dangling offsets and the embedded-JPEG range
+ * (JPEGInterchangeFormat/Length). Bounded and tolerant of damage.
+ */
+export function walkTiff(b, order, ifd0) {
+    const { u16, u32 } = readers(order);
+    const scan = { ok: false, ifdCount: 0, entryTotal: 0, dangling: [], maxRefEnd: 0, notes: [] };
+    const seen = new Set();
+    const queue = [ifd0];
+    let jpegOff = 0;
+    let jpegLen = 0;
+    // Single-strip offset/length, paired after the walk for truncation checks.
+    let stripOff = 0;
+    let stripLen = 0;
+    while (queue.length && scan.ifdCount < 32) {
+        const off = queue.shift();
+        if (off <= 0 || seen.has(off))
+            continue;
+        if (off + 2 > b.length) {
+            scan.dangling.push(off);
+            continue;
+        }
+        seen.add(off);
+        const n = u16(b, off);
+        if (n === 0 || n > 512) {
+            scan.notes.push(`implausible IFD entry count ${n} at ${off}`);
+            continue;
+        }
+        const base = off + 2;
+        if (base + n * 12 + 4 > b.length) {
+            scan.dangling.push(off);
+            continue;
+        }
+        scan.ifdCount++;
+        scan.entryTotal += n;
+        for (let e = 0; e < n; e++) {
+            const eo = base + e * 12;
+            const tag = u16(b, eo);
+            const type = u16(b, eo + 2);
+            const count = u32(b, eo + 4);
+            const size = (TYPE_SIZE[type] ?? 1) * count;
+            const valOff = size <= 4 ? eo + 8 : u32(b, eo + 8);
+            if (OFFSET_TAGS.has(tag)) {
+                if (tag === 0x014a || tag === 0x8769) {
+                    // SubIFD(s) / Exif IFD: value(s) are IFD offsets to follow
+                    if (size <= 4)
+                        queue.push(u32(b, eo + 8));
+                    else if (valOff + count * 4 <= b.length)
+                        for (let k = 0; k < Math.min(count, 16); k++)
+                            queue.push(u32(b, valOff + k * 4));
+                    else
+                        scan.dangling.push(valOff);
+                }
+                else if (tag === 0x0201) {
+                    jpegOff = size <= 4 ? u32(b, eo + 8) : valOff;
+                }
+                else if (tag === 0x0202) {
+                    jpegLen = size <= 4 ? u32(b, eo + 8) : valOff;
+                }
+                else if (tag === 0x0111 || tag === 0x0144) {
+                    // StripOffsets / TileOffsets: dangling if the value (or first elem) is past EOF
+                    const first = size <= 4 ? (type === 4 ? u32(b, eo + 8) : u16(b, eo + 8)) : valOff;
+                    if (first > b.length)
+                        scan.dangling.push(first);
+                    else {
+                        stripOff = stripOff || first;
+                        scan.maxRefEnd = Math.max(scan.maxRefEnd, first);
+                    }
+                }
+                else if (tag === 0x0117 || tag === 0x0145) {
+                    // StripByteCounts / TileByteCounts: a length, not an offset (single-value only)
+                    if (size <= 4 && count === 1)
+                        stripLen = type === 4 ? u32(b, eo + 8) : u16(b, eo + 8);
+                }
+            }
+        }
+        const next = u32(b, base + n * 12);
+        if (next)
+            queue.push(next);
+    }
+    // Pair single-strip offset+length: a strip declared past EOF means truncation.
+    if (stripOff > 0 && stripLen > 0) {
+        const end = stripOff + stripLen;
+        if (end > b.length)
+            scan.dangling.push(end);
+        else
+            scan.maxRefEnd = Math.max(scan.maxRefEnd, end);
+    }
+    if (jpegOff > 0 && jpegLen > 0 && jpegOff + jpegLen <= b.length && b[jpegOff] === 0xff && b[jpegOff + 1] === 0xd8) {
+        scan.jpeg = { offset: jpegOff, length: jpegLen };
+    }
+    else if (jpegOff > 0 && jpegOff + 2 <= b.length && b[jpegOff] === 0xff && b[jpegOff + 1] === 0xd8) {
+        scan.jpeg = { offset: jpegOff, length: Math.max(0, Math.min(jpegLen, b.length - jpegOff)) };
+        if (jpegOff + jpegLen > b.length)
+            scan.dangling.push(jpegOff + jpegLen);
+    }
+    else if (jpegOff > b.length) {
+        scan.dangling.push(jpegOff);
+    }
+    scan.ok = scan.ifdCount > 0;
+    return scan;
+}
+/**
+ * Universal preview salvage: the largest FFD8 FF … FFD9 span in the buffer.
+ * RAW previews are usually the biggest embedded JPEG (bigger than the thumbnail).
+ */
+export function findLargestJpeg(b) {
+    let best = null;
+    let i = 0;
+    const n = b.length - 3;
+    while (i < n) {
+        if (b[i] === 0xff && b[i + 1] === 0xd8 && b[i + 2] === 0xff) {
+            let end = -1;
+            for (let j = i + 2; j < b.length - 1; j++) {
+                if (b[j] === 0xff && b[j + 1] === 0xd9) {
+                    end = j + 2;
+                    break;
+                }
+            }
+            if (end > 0) {
+                const len = end - i;
+                if (!best || len > best.length)
+                    best = { offset: i, length: len };
+                i = end;
+                continue;
+            }
+        }
+        i++;
+    }
+    return best;
+}
+//# sourceMappingURL=format.js.map

package/dist/raw/format.js.map

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

package/dist/raw/index.d.ts

@@ -0,0 +1,7 @@
+export declare const repairRaw: (src: import("../byte-source.js").ByteSource) => Promise<import("./repair.js").RawRepairResult>;
+export { repairRawBytes } from "./repair.js";
+export type { RawRepairOutcome, RawRepairStrategy, RawRepairReport, RawRepairResult, } from "./repair.js";
+export { diagnoseRaw, diagnoseRawBytes } from "./diagnose.js";
+export type { RawDiagnosis, RawDamageClass, RawPreview } from "./diagnose.js";
+export type { RawContainer, ByteOrder } from "./format.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/raw/index.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,SAAS,iGAAmB,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,eAAe,GAChB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAC9D,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC9E,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC"}

package/dist/raw/index.js

@@ -0,0 +1,13 @@
+/**
+ * RAW photo engine subpath export (`@intactfile/engines/raw`). Pure-TS
+ * structural repair for TIFF-family RAW (CR2/NEF/ARW/DNG), CR3 and RAF:
+ * strip-prefix, fix-header, validate, and embedded-preview recovery. No LibRaw,
+ * no mosaic development. Kept out of the root barrel so bundles that don't
+ * repair RAW stay lean; diagnosis is pure byte-scanning and exported from root.
+ */
+import { gate } from "../license.js";
+import { repairRaw as _repairRaw } from "./repair.js";
+export const repairRaw = gate(_repairRaw);
+export { repairRawBytes } from "./repair.js";
+export { diagnoseRaw, diagnoseRawBytes } from "./diagnose.js";
+//# sourceMappingURL=index.js.map

package/dist/raw/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/raw/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,SAAS,IAAI,UAAU,EAAE,MAAM,aAAa,CAAC;AAEtD,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAQ7C,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC"}

package/dist/raw/repair.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Honest RAW *container* repair (docs/engineering/engine-raw-photo.md). Like the
+ * JPEG engine, this repairs structure — it never develops the mosaic sensor data
+ * (no LibRaw) and never invents pixels.
+ *
+ * Ladder, applied in order and re-validated:
+ *  1. strip-prefix   — drop a garbage prefix so the TIFF/RAF/CR3 magic sits at 0;
+ *  2. fix-header     — restore a corrupt TIFF "42" magic when the II/MM mark
+ *                      survived;
+ *  3. validate       — if the container now walks clean, emit it as the repair;
+ *  4. preview-recover— when the IFD index/payload is unrecoverable in v1
+ *                      (truncated / bad offsets), extract the embedded full-size
+ *                      JPEG preview as an honest partial recovery.
+ *
+ * Outcome is `success` only when a structurally valid container is produced;
+ * a preview-only salvage is reported as `partial`; otherwise `failed`.
+ */
+import type { ByteSource } from "../byte-source.js";
+import { type RawDamageClass } from "./diagnose.js";
+import { type ByteOrder, type RawContainer } from "./format.js";
+export type RawRepairOutcome = "success" | "partial" | "failed";
+export type RawRepairStrategy = "strip-prefix" | "fix-header" | "validated" | "preview-recover";
+export interface RawRepairReport {
+    outcome: RawRepairOutcome;
+    damageClass: RawDamageClass;
+    container: RawContainer | "unknown";
+    order?: ByteOrder;
+    /** Winning strategy, or null when nothing worked. */
+    strategy: RawRepairStrategy | null;
+    /** Human-readable list of what was actually recovered. */
+    salvaged: string[];
+    notes: string[];
+    bytesIn: number;
+    bytesOut: number;
+    previewSource: "tiff-tag" | "scan" | null;
+}
+export interface RawRepairResult {
+    /** A structurally valid RAW container, when one could be produced. */
+    image?: Uint8Array;
+    /** The embedded JPEG preview — the honest fallback when the RAW can't be rebuilt. */
+    preview?: Uint8Array;
+    report: RawRepairReport;
+}
+export declare function repairRawBytes(input: Uint8Array): RawRepairResult;
+export declare function repairRaw(src: ByteSource): Promise<RawRepairResult>;
+//# sourceMappingURL=repair.d.ts.map

package/dist/raw/repair.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repair.d.ts","sourceRoot":"","sources":["../../src/raw/repair.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,EAAoB,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AACtE,OAAO,EAAmB,KAAK,SAAS,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAEjF,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;AAChE,MAAM,MAAM,iBAAiB,GAAG,cAAc,GAAG,YAAY,GAAG,WAAW,GAAG,iBAAiB,CAAC;AAEhG,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,gBAAgB,CAAC;IAC1B,WAAW,EAAE,cAAc,CAAC;IAC5B,SAAS,EAAE,YAAY,GAAG,SAAS,CAAC;IACpC,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,qDAAqD;IACrD,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACnC,0DAA0D;IAC1D,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI,CAAC;CAC3C;AAED,MAAM,WAAW,eAAe;IAC9B,sEAAsE;IACtE,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,qFAAqF;IACrF,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,MAAM,EAAE,eAAe,CAAC;CACzB;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,eAAe,CA+FjE;AAED,wBAAsB,SAAS,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,eAAe,CAAC,CAEzE"}

package/dist/raw/repair.js

@@ -0,0 +1,94 @@
+import { readAll } from "../bytes-util.js";
+import { diagnoseRawBytes } from "./diagnose.js";
+import { findLargestJpeg } from "./format.js";
+export function repairRawBytes(input) {
+    const bytesIn = input.length;
+    const salvaged = [];
+    const notes = [];
+    const diag = diagnoseRawBytes(input);
+    notes.push(...diag.notes);
+    const build = (outcome, strategy, out) => ({
+        image: out.image,
+        preview: out.preview,
+        report: {
+            outcome,
+            damageClass: diag.damageClass,
+            container: diag.container,
+            order: diag.order,
+            strategy,
+            salvaged,
+            notes,
+            bytesIn,
+            bytesOut: out.image?.length ?? out.preview?.length ?? 0,
+            previewSource: out.previewSource ?? null,
+        },
+    });
+    if (diag.damageClass === "not-raw") {
+        notes.push("input is not recognizable as a RAW photo; nothing to repair");
+        return build("failed", null, {});
+    }
+    // 1 + 2: produce a working buffer with the prefix stripped and the header fixed.
+    let work = input;
+    let acted = null;
+    if (diag.prefixBytes > 0) {
+        work = input.slice(diag.prefixBytes);
+        acted = "strip-prefix";
+        salvaged.push(`stripped ${diag.prefixBytes} garbage byte(s) before the RAW header`);
+    }
+    if (diag.damageClass === "header-damage" && diag.order) {
+        work = work === input ? input.slice() : work; // ensure a mutable copy
+        if (diag.order === "le") {
+            work[2] = 0x2a;
+            work[3] = 0x00;
+        }
+        else {
+            work[2] = 0x00;
+            work[3] = 0x2a;
+        }
+        acted = "fix-header";
+        salvaged.push("restored the corrupt TIFF 42 magic in the header");
+    }
+    // 3: re-validate the working buffer.
+    const post = diagnoseRawBytes(work);
+    if (post.damageClass === "none") {
+        if (acted)
+            return build("success", acted, { image: work });
+        notes.push("container is structurally valid; nothing to repair");
+        return build("success", "validated", { image: work });
+    }
+    // 4: preview recovery. Prefer the TIFF-tag preview, fall back to the largest
+    //    embedded JPEG found by scanning.
+    let chosen = null;
+    let source = null;
+    if (post.preview &&
+        post.preview.length > 3 &&
+        post.preview.offset + post.preview.length <= work.length &&
+        work[post.preview.offset] === 0xff &&
+        work[post.preview.offset + 1] === 0xd8) {
+        chosen = { offset: post.preview.offset, length: post.preview.length };
+        source = post.preview.source;
+    }
+    const scan = findLargestJpeg(work);
+    if (scan && (!chosen || scan.length > chosen.length)) {
+        chosen = scan;
+        source = "scan";
+    }
+    if (chosen && chosen.length > 3) {
+        const preview = work.slice(chosen.offset, chosen.offset + chosen.length);
+        salvaged.push(`recovered the embedded JPEG preview (${preview.length} bytes)`);
+        notes.push("the RAW mosaic/index could not be rebuilt (v1 repairs container structure only); " +
+            "the embedded full-size JPEG preview is the honest recovery");
+        return build("partial", "preview-recover", { preview, previewSource: source ?? "scan" });
+    }
+    // Stripped a prefix but couldn't validate and found no preview: still cleaner.
+    if (acted === "strip-prefix") {
+        notes.push("removed a garbage prefix but could not validate the container or find a preview");
+        return build("partial", "strip-prefix", { image: work });
+    }
+    notes.push("no deterministic repair produced a valid container or a recoverable preview");
+    return build("failed", null, {});
+}
+export async function repairRaw(src) {
+    return repairRawBytes(await readAll(src));
+}
+//# sourceMappingURL=repair.js.map

package/dist/raw/repair.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repair.js","sourceRoot":"","sources":["../../src/raw/repair.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAuB,MAAM,eAAe,CAAC;AACtE,OAAO,EAAE,eAAe,EAAqC,MAAM,aAAa,CAAC;AA4BjF,MAAM,UAAU,cAAc,CAAC,KAAiB;IAC9C,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC;IAC7B,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,IAAI,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACrC,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;IAE1B,MAAM,KAAK,GAAG,CACZ,OAAyB,EACzB,QAAkC,EAClC,GAAsF,EACrE,EAAE,CAAC,CAAC;QACrB,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,MAAM,EAAE;YACN,OAAO;YACP,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,QAAQ;YACR,QAAQ;YACR,KAAK;YACL,OAAO;YACP,QAAQ,EAAE,GAAG,CAAC,KAAK,EAAE,MAAM,IAAI,GAAG,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;YACvD,aAAa,EAAE,GAAG,CAAC,aAAa,IAAI,IAAI;SACzC;KACF,CAAC,CAAC;IAEH,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,6DAA6D,CAAC,CAAC;QAC1E,OAAO,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;IACnC,CAAC;IAED,iFAAiF;IACjF,IAAI,IAAI,GAAG,KAAK,CAAC;IACjB,IAAI,KAAK,GAA6B,IAAI,CAAC;IAC3C,IAAI,IAAI,CAAC,WAAW,GAAG,CAAC,EAAE,CAAC;QACzB,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACrC,KAAK,GAAG,cAAc,CAAC;QACvB,QAAQ,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,WAAW,wCAAwC,CAAC,CAAC;IACtF,CAAC;IACD,IAAI,IAAI,CAAC,WAAW,KAAK,eAAe,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QACvD,IAAI,GAAG,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,wBAAwB;QACtE,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;YAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;YAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;QAAC,CAAC;aACvD,CAAC;YAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;YAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;QAAC,CAAC;QACxC,KAAK,GAAG,YAAY,CAAC;QACrB,QAAQ,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC;IACpE,CAAC;IAED,qCAAqC;IACrC,MAAM,IAAI,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,IAAI,CAAC,WAAW,KAAK,MAAM,EAAE,CAAC;QAChC,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3D,KAAK,CAAC,IAAI,CAAC,oDAAoD,CAAC,CAAC;QACjE,OAAO,KAAK,CAAC,SAAS,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,6EAA6E;IAC7E,sCAAsC;IACtC,IAAI,MAAM,GAA8C,IAAI,CAAC;IAC7D,IAAI,MAAM,GAA+B,IAAI,CAAC;IAC9C,IACE,IAAI,CAAC,OAAO;QACZ,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;QACvB,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM;QACxD,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI;QAClC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,IAAI,EACtC,CAAC;QACD,MAAM,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QACtE,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;IAC/B,CAAC;IACD,MAAM,IAAI,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACnC,IAAI,IAAI,IAAI,CAAC,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QACrD,MAAM,GAAG,IAAI,CAAC;QACd,MAAM,GAAG,MAAM,CAAC;IAClB,CAAC;IAED,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;QACzE,QAAQ,CAAC,IAAI,CAAC,wCAAwC,OAAO,CAAC,MAAM,SAAS,CAAC,CAAC;QAC/E,KAAK,CAAC,IAAI,CACR,mFAAmF;YACjF,4DAA4D,CAC/D,CAAC;QACF,OAAO,KAAK,CAAC,SAAS,EAAE,iBAAiB,EAAE,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,IAAI,MAAM,EAAE,CAAC,CAAC;IAC3F,CAAC;IAED,+EAA+E;IAC/E,IAAI,KAAK,KAAK,cAAc,EAAE,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC,iFAAiF,CAAC,CAAC;QAC9F,OAAO,KAAK,CAAC,SAAS,EAAE,cAAc,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,6EAA6E,CAAC,CAAC;IAC1F,OAAO,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,GAAe;IAC7C,OAAO,cAAc,CAAC,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;AAC5C,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@intactfile/engines",
-  "version": "0.2.0",
-  "description": "IntactFile repair engines (SDK): repair corrupted video, ZIP/Office, PDF, JPEG, PNG, SQLite and RAR/7z entirely in-process. Runs in the browser and in Node — files never leave the machine.",
+  "version": "0.3.0",
+  "description": "IntactFile repair engines (SDK): repair corrupted video, ZIP/Office, PDF, JPEG, PNG, RAW photo, PSD, audio (WAV/MP3), SQLite and RAR/7z entirely in-process. Runs in the browser and in Node — files never leave the machine.",
   "private": false,
   "type": "module",
   "license": "UNLICENSED",
@@ -42,6 +42,18 @@
     "./audio": {
       "types": "./dist/audio/index.d.ts",
       "default": "./dist/audio/index.js"
+    },
+    "./raw": {
+      "types": "./dist/raw/index.d.ts",
+      "default": "./dist/raw/index.js"
+    },
+    "./psd": {
+      "types": "./dist/psd/index.d.ts",
+      "default": "./dist/psd/index.js"
+    },
+    "./office-legacy": {
+      "types": "./dist/office-legacy/index.d.ts",
+      "default": "./dist/office-legacy/index.js"
     }
   },
   "files": [