@intactfile/engines 0.1.0 → 0.3.0

package/dist/archive/index.d.ts

@@ -1,18 +1,10 @@
-/**
- * Archive engine subpath export (`@intactfile/engines/archive`) — RAR/7z
- * SALVAGE extraction (recover intact entries from a damaged archive), not deep
- * repair. Kept out of the root export so browser bundles that never touch
- * archives never pull in the 7z-wasm dependency; even here, the wasm only loads
- * on the first salvageArchive call. diagnoseArchive is pure byte-sniffing and
- * loads no wasm.
- *
- * License note: extraction (including RAR via 7-Zip's unRAR-derived decoder) is
- * permitted; RAR CREATION is not and is never performed. The unRAR license text
- * ships next to this module at ./LICENSE-unrar.txt.
- */
 export { diagnoseArchive } from './diagnose.js';
 export type { ArchiveDiagnosis, ArchiveFormat, ArchiveDamageClass } from './diagnose.js';
-export { salvageArchive, parseSltListing } from './salvage.js';
+export declare const salvageArchive: (src: import("../byte-source.js").ByteSource, opts?: import("./salvage.js").SalvageOptions | undefined) => Promise<{
+    files: import("./salvage.js").SalvagedFile[];
+    report: import("./salvage.js").SalvageReport;
+}>;
+export { parseSltListing } from './salvage.js';
 export type { SalvagedFile, SalvageStatus, SalvageOutcome, SalvageReport, SalvageEntrySummary, SalvageOptions, } from './salvage.js';
 export { withSevenZip, ensureSevenZip, setSevenZipLoader, resetSevenZipHost, } from './host.js';
 export type { SevenZipLoader, SevenZipFactory, SevenZipModule, SevenZipModuleOptions, SevenZipSession, SevenZipResult, SevenZipFS, } from './host.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/archive/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAEzF,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/D,YAAY,EACV,YAAY,EACZ,aAAa,EACb,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,cAAc,GACf,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,WAAW,CAAC;AACnB,YAAY,EACV,cAAc,EACd,eAAe,EACf,cAAc,EACd,qBAAqB,EACrB,eAAe,EACf,cAAc,EACd,UAAU,GACX,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,UAAU,GACX,MAAM,aAAa,CAAC;AAErB,0EAA0E;AAC1E,eAAO,MAAM,kBAAkB,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/archive/index.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAEzF,eAAO,MAAM,cAAc;;;EAAwB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,YAAY,EACV,YAAY,EACZ,aAAa,EACb,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,cAAc,GACf,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,WAAW,CAAC;AACnB,YAAY,EACV,cAAc,EACd,eAAe,EACf,cAAc,EACd,qBAAqB,EACrB,eAAe,EACf,cAAc,EACd,UAAU,GACX,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,UAAU,GACX,MAAM,aAAa,CAAC;AAErB,0EAA0E;AAC1E,eAAO,MAAM,kBAAkB,sBAAsB,CAAC"}

package/dist/archive/index.js

@@ -10,8 +10,11 @@
  * permitted; RAR CREATION is not and is never performed. The unRAR license text
  * ships next to this module at ./LICENSE-unrar.txt.
  */
+import { gate } from '../license.js';
+import { salvageArchive as _salvageArchive } from './salvage.js';
 export { diagnoseArchive } from './diagnose.js';
-export { salvageArchive, parseSltListing } from './salvage.js';
+export const salvageArchive = gate(_salvageArchive);
+export { parseSltListing } from './salvage.js';
 export { withSevenZip, ensureSevenZip, setSevenZipLoader, resetSevenZipHost, } from './host.js';
 export { SIG_7Z, SIG_RAR4, SIG_RAR5, matchAt, indexOfSig, } from './format.js';
 /** Relative path (from this module) to the shipped unRAR license text. */

package/dist/archive/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/archive/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGhD,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAU/D,OAAO,EACL,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,WAAW,CAAC;AAWnB,OAAO,EACL,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,UAAU,GACX,MAAM,aAAa,CAAC;AAErB,0EAA0E;AAC1E,MAAM,CAAC,MAAM,kBAAkB,GAAG,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/archive/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,cAAc,IAAI,eAAe,EAAE,MAAM,cAAc,CAAC;AAEjE,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGhD,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,CAAC,eAAe,CAAC,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAU/C,OAAO,EACL,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,WAAW,CAAC;AAWnB,OAAO,EACL,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,UAAU,GACX,MAAM,aAAa,CAAC;AAErB,0EAA0E;AAC1E,MAAM,CAAC,MAAM,kBAAkB,GAAG,mBAAmB,CAAC"}

package/dist/audio/index.d.ts

@@ -0,0 +1,11 @@
+export declare const repairWav: (src: import("../byte-source.js").ByteSource) => Promise<{
+    audio: Uint8Array;
+    report: import("./wav.js").WavRepairReport;
+}>;
+export type { WavRepairReport, AudioOutcome } from "./wav.js";
+export declare const repairMp3: (src: import("../byte-source.js").ByteSource) => Promise<{
+    audio: Uint8Array;
+    report: import("./mp3.js").Mp3RepairReport;
+}>;
+export type { Mp3RepairReport } from "./mp3.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/audio/index.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,SAAS;;;EAAmB,CAAC;AAC1C,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC9D,eAAO,MAAM,SAAS;;;EAAmB,CAAC;AAC1C,YAAY,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC"}

package/dist/audio/index.js

@@ -0,0 +1,11 @@
+/**
+ * Audio engine subpath export (`@intactfile/engines/audio`). Pure-TS structural
+ * repair for WAV (RIFF) and MP3 (frame resync). Kept out of the root barrel so
+ * bundles that don't repair audio stay lean.
+ */
+import { gate } from "../license.js";
+import { repairWav as _repairWav } from "./wav.js";
+import { repairMp3 as _repairMp3 } from "./mp3.js";
+export const repairWav = gate(_repairWav);
+export const repairMp3 = gate(_repairMp3);
+//# sourceMappingURL=index.js.map

package/dist/audio/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/audio/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,SAAS,IAAI,UAAU,EAAE,MAAM,UAAU,CAAC;AACnD,OAAO,EAAE,SAAS,IAAI,UAAU,EAAE,MAAM,UAAU,CAAC;AAEnD,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC;AAE1C,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC"}

package/dist/audio/mp3.d.ts

@@ -0,0 +1,22 @@
+/**
+ * MP3 repair — pure TS, structural. Strips a broken/leading ID3 tag and any
+ * garbage, resynchronises on valid MPEG audio frames, drops corrupt frames, and
+ * concatenates the survivors into a playable stream. Honest: 0 valid frames = failed.
+ */
+import type { ByteSource } from "../byte-source.js";
+import type { AudioOutcome } from "./wav.js";
+export interface Mp3RepairReport {
+    outcome: AudioOutcome;
+    damageClass: string;
+    notes: string[];
+    bytesIn: number;
+    bytesOut: number;
+    framesFound: number;
+    framesKept: number;
+    leadingGarbageBytes: number;
+}
+export declare function repairMp3(src: ByteSource): Promise<{
+    audio: Uint8Array;
+    report: Mp3RepairReport;
+}>;
+//# sourceMappingURL=mp3.d.ts.map

package/dist/audio/mp3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mp3.d.ts","sourceRoot":"","sources":["../../src/audio/mp3.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7C,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,YAAY,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AA8DD,wBAAsB,SAAS,CAC7B,GAAG,EAAE,UAAU,GACd,OAAO,CAAC;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,eAAe,CAAA;CAAE,CAAC,CAiFzD"}

package/dist/audio/mp3.js

@@ -0,0 +1,141 @@
+import { readAll } from "../bytes-util.js";
+// [version][layer] -> bitrate table (kbps); index 0 = free, 15 = bad (both skipped).
+// version: 0=MPEG2.5, 2=MPEG2, 3=MPEG1 (1 = reserved). layer: 1=III, 2=II, 3=I.
+const BR_MPEG1_L1 = [0, 32, 64, 96, 128, 160, 192, 224, 256, 288, 320, 352, 384, 416, 448, 0];
+const BR_MPEG1_L2 = [0, 32, 48, 56, 64, 80, 96, 112, 128, 160, 192, 224, 256, 320, 384, 0];
+const BR_MPEG1_L3 = [0, 32, 40, 48, 56, 64, 80, 96, 112, 128, 160, 192, 224, 256, 320, 0];
+const BR_MPEG2_L1 = [0, 32, 48, 56, 64, 80, 96, 112, 128, 144, 160, 176, 192, 224, 256, 0];
+const BR_MPEG2_L23 = [0, 8, 16, 24, 32, 40, 48, 56, 64, 80, 96, 112, 128, 144, 160, 0];
+const SR_MPEG1 = [44100, 48000, 32000];
+const SR_MPEG2 = [22050, 24000, 16000];
+const SR_MPEG25 = [11025, 12000, 8000];
+/** Parse a 4-byte frame header at `o`; null if not a valid frame header. */
+function parseHeader(b, o) {
+    if (o + 4 > b.length)
+        return null;
+    if (b[o] !== 0xff || ((b[o + 1] & 0xe0) !== 0xe0))
+        return null;
+    const version = (b[o + 1] >> 3) & 0x03; // 0=2.5,1=res,2=2,3=1
+    const layer = (b[o + 1] >> 1) & 0x03; // 0=res,1=III,2=II,3=I
+    if (version === 1 || layer === 0)
+        return null;
+    const brIdx = (b[o + 2] >> 4) & 0x0f;
+    const srIdx = (b[o + 2] >> 2) & 0x03;
+    const padding = (b[o + 2] >> 1) & 0x01;
+    if (brIdx === 0 || brIdx === 15 || srIdx === 3)
+        return null;
+    const mpeg1 = version === 3;
+    let brTable;
+    if (layer === 3)
+        brTable = mpeg1 ? BR_MPEG1_L1 : BR_MPEG2_L1;
+    else if (layer === 2)
+        brTable = mpeg1 ? BR_MPEG1_L2 : BR_MPEG2_L23;
+    else
+        brTable = mpeg1 ? BR_MPEG1_L3 : BR_MPEG2_L23;
+    const bitrate = (brTable[brIdx] ?? 0) * 1000;
+    const srTable = version === 3 ? SR_MPEG1 : version === 2 ? SR_MPEG2 : SR_MPEG25;
+    const sampleRate = srTable[srIdx] ?? 0;
+    if (bitrate === 0 || sampleRate === 0)
+        return null;
+    let length;
+    if (layer === 3) {
+        // Layer I
+        length = Math.floor((12 * bitrate) / sampleRate + padding) * 4;
+    }
+    else {
+        // Layer II & III
+        const coef = mpeg1 ? 144 : 72;
+        length = Math.floor((coef * bitrate) / sampleRate) + padding;
+    }
+    return length >= 4 ? { length } : null;
+}
+/** Length of a leading ID3v2 tag at offset 0, or 0 if none. */
+function id3v2Length(b) {
+    if (b.length < 10 || b[0] !== 0x49 || b[1] !== 0x44 || b[2] !== 0x33)
+        return 0; // "ID3"
+    // syncsafe 28-bit size in bytes 6..9
+    const size = ((b[6] & 0x7f) << 21) | ((b[7] & 0x7f) << 14) | ((b[8] & 0x7f) << 7) | (b[9] & 0x7f);
+    const footer = (b[5] & 0x10) !== 0 ? 10 : 0;
+    return 10 + size + footer;
+}
+export async function repairMp3(src) {
+    const buf = await readAll(src);
+    const notes = [];
+    let pos = 0;
+    let leadingGarbage = 0;
+    const id3 = id3v2Length(buf);
+    if (id3 > 0 && id3 <= buf.length) {
+        pos = id3;
+        notes.push(`skipped a ${id3}-byte ID3v2 tag`);
+    }
+    const parts = [];
+    let framesFound = 0;
+    let framesKept = 0;
+    let firstFrameSeen = false;
+    while (pos < buf.length) {
+        const h = parseHeader(buf, pos);
+        if (h && pos + h.length <= buf.length) {
+            // Confirm the next boundary is EOF or another sync — rejects false positives.
+            const next = pos + h.length;
+            if (next === buf.length || (buf[next] === 0xff && (buf[next + 1] & 0xe0) === 0xe0)) {
+                parts.push(buf.subarray(pos, next));
+                framesFound++;
+                framesKept++;
+                firstFrameSeen = true;
+                pos = next;
+                continue;
+            }
+        }
+        // Not a valid frame here.
+        if (!firstFrameSeen)
+            leadingGarbage++;
+        else
+            framesFound++; // a corrupt/dropped frame region
+        pos++;
+    }
+    const bytesIn = buf.length;
+    if (framesKept === 0) {
+        return {
+            audio: new Uint8Array(0),
+            report: {
+                outcome: "failed",
+                damageClass: "no-frames",
+                notes,
+                bytesIn,
+                bytesOut: 0,
+                framesFound,
+                framesKept: 0,
+                leadingGarbageBytes: leadingGarbage,
+            },
+        };
+    }
+    let total = 0;
+    for (const p of parts)
+        total += p.length;
+    const out = new Uint8Array(total);
+    let w = 0;
+    for (const p of parts) {
+        out.set(p, w);
+        w += p.length;
+    }
+    if (leadingGarbage > 0)
+        notes.push(`dropped ${leadingGarbage} bytes of leading garbage`);
+    const dropped = framesFound - framesKept;
+    if (dropped > 0)
+        notes.push(`dropped ${dropped} corrupt frame region(s)`);
+    const outcome = leadingGarbage > 0 || dropped > 0 ? "partial" : "success";
+    return {
+        audio: out,
+        report: {
+            outcome,
+            damageClass: outcome === "success" ? "clean" : "resynced",
+            notes,
+            bytesIn,
+            bytesOut: out.length,
+            framesFound,
+            framesKept,
+            leadingGarbageBytes: leadingGarbage,
+        },
+    };
+}
+//# sourceMappingURL=mp3.js.map

package/dist/audio/mp3.js.map

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

package/dist/audio/wav.d.ts

@@ -0,0 +1,23 @@
+/**
+ * WAV repair — pure TS, structural (RIFF). Rebuilds the RIFF/fmt/data headers
+ * when sizes are wrong or truncated and the PCM is intact. Honest: no 'fmt '
+ * means we can't know the format, so we fail rather than guess.
+ */
+import type { ByteSource } from "../byte-source.js";
+export type AudioOutcome = "success" | "partial" | "failed";
+export interface WavRepairReport {
+    outcome: AudioOutcome;
+    damageClass: string;
+    notes: string[];
+    bytesIn: number;
+    bytesOut: number;
+    sampleRateHz: number;
+    channels: number;
+    bitsPerSample: number;
+    pcmBytes: number;
+}
+export declare function repairWav(src: ByteSource): Promise<{
+    audio: Uint8Array;
+    report: WavRepairReport;
+}>;
+//# sourceMappingURL=wav.d.ts.map

package/dist/audio/wav.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wav.d.ts","sourceRoot":"","sources":["../../src/audio/wav.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAWpD,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE5D,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,YAAY,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,SAAS,CAC7B,GAAG,EAAE,UAAU,GACd,OAAO,CAAC;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,eAAe,CAAA;CAAE,CAAC,CAsFzD"}

package/dist/audio/wav.js

@@ -0,0 +1,86 @@
+import { indexOfAscii, readAll, u16le, u32le, writeAscii, writeU16le, writeU32le, } from "../bytes-util.js";
+export async function repairWav(src) {
+    const buf = await readAll(src);
+    const notes = [];
+    const fail = (damageClass) => ({
+        audio: new Uint8Array(0),
+        report: {
+            outcome: "failed",
+            damageClass,
+            notes,
+            bytesIn: buf.length,
+            bytesOut: 0,
+            sampleRateHz: 0,
+            channels: 0,
+            bitsPerSample: 0,
+            pcmBytes: 0,
+        },
+    });
+    if (buf.length < 44)
+        return fail("too-small");
+    const fmtOff = indexOfAscii(buf, "fmt ", 0);
+    if (fmtOff < 0 || fmtOff + 24 > buf.length)
+        return fail("no-fmt");
+    const fmtBody = fmtOff + 8;
+    const audioFormat = u16le(buf, fmtBody) || 1;
+    const channels = u16le(buf, fmtBody + 2);
+    const sampleRate = u32le(buf, fmtBody + 4);
+    const bitsPerSample = u16le(buf, fmtBody + 14);
+    if (channels === 0 || sampleRate === 0 || bitsPerSample === 0)
+        return fail("bad-fmt-params");
+    const blockAlign = channels * (bitsPerSample >> 3) || 1;
+    const byteRate = sampleRate * blockAlign;
+    let damageClass = "header";
+    let pcm;
+    const dataOff = indexOfAscii(buf, "data", fmtOff + 8);
+    if (dataOff >= 0 && dataOff + 8 <= buf.length) {
+        const declared = u32le(buf, dataOff + 4);
+        const avail = buf.length - (dataOff + 8);
+        if (declared > avail) {
+            notes.push(`data chunk declares ${declared} bytes but only ${avail} are present — recovered what remained`);
+            damageClass = "truncated-data";
+        }
+        pcm = buf.subarray(dataOff + 8, dataOff + 8 + Math.min(declared || avail, avail));
+    }
+    else {
+        notes.push("no 'data' chunk header found — treated the bytes after fmt as PCM");
+        damageClass = "no-data-header";
+        pcm = buf.subarray(fmtBody + 16);
+    }
+    // Trim to whole sample frames.
+    pcm = pcm.subarray(0, pcm.length - (pcm.length % blockAlign));
+    if (pcm.length === 0)
+        return fail("no-pcm");
+    const out = new Uint8Array(44 + pcm.length);
+    writeAscii(out, 0, "RIFF");
+    writeU32le(out, 4, 36 + pcm.length);
+    writeAscii(out, 8, "WAVE");
+    writeAscii(out, 12, "fmt ");
+    writeU32le(out, 16, 16);
+    writeU16le(out, 20, audioFormat);
+    writeU16le(out, 22, channels);
+    writeU32le(out, 24, sampleRate);
+    writeU32le(out, 28, byteRate);
+    writeU16le(out, 32, blockAlign);
+    writeU16le(out, 34, bitsPerSample);
+    writeAscii(out, 36, "data");
+    writeU32le(out, 40, pcm.length);
+    out.set(pcm, 44);
+    notes.unshift("rebuilt RIFF/fmt/data headers");
+    const outcome = damageClass === "truncated-data" || damageClass === "no-data-header" ? "partial" : "success";
+    return {
+        audio: out,
+        report: {
+            outcome,
+            damageClass,
+            notes,
+            bytesIn: buf.length,
+            bytesOut: out.length,
+            sampleRateHz: sampleRate,
+            channels,
+            bitsPerSample,
+            pcmBytes: pcm.length,
+        },
+    };
+}
+//# sourceMappingURL=wav.js.map

package/dist/audio/wav.js.map

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

package/dist/bytes-util.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Small byte helpers shared by the pure-TS structural engines (WAV/MP3/AVI).
+ * Little-endian readers/writers + ASCII fourcc matching + a whole-source read.
+ */
+import type { ByteSource } from "./byte-source.js";
+/** Read the entire source into one buffer (chunked, tolerant of short reads). */
+export declare function readAll(src: ByteSource): Promise<Uint8Array>;
+export declare const u16le: (b: Uint8Array, o: number) => number;
+export declare const u32le: (b: Uint8Array, o: number) => number;
+export declare function writeU16le(b: Uint8Array, o: number, v: number): void;
+export declare function writeU32le(b: Uint8Array, o: number, v: number): void;
+export declare function writeAscii(b: Uint8Array, o: number, s: string): void;
+/** True if the 4+ ASCII chars of `s` sit at offset `o`. */
+export declare function matchAscii(b: Uint8Array, o: number, s: string): boolean;
+/** First index of ASCII `s` in `b` at/after `from`, or -1. */
+export declare function indexOfAscii(b: Uint8Array, s: string, from?: number): number;
+//# sourceMappingURL=bytes-util.d.ts.map

package/dist/bytes-util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bytes-util.d.ts","sourceRoot":"","sources":["../src/bytes-util.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,iFAAiF;AACjF,wBAAsB,OAAO,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAUlE;AAED,eAAO,MAAM,KAAK,GAAI,GAAG,UAAU,EAAE,GAAG,MAAM,KAAG,MAA8C,CAAC;AAEhG,eAAO,MAAM,KAAK,GAAI,GAAG,UAAU,EAAE,GAAG,MAAM,KAAG,MACmD,CAAC;AAErG,wBAAgB,UAAU,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAGpE;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAKpE;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAEpE;AAED,2DAA2D;AAC3D,wBAAgB,UAAU,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAGvE;AAED,8DAA8D;AAC9D,wBAAgB,YAAY,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,SAAI,GAAG,MAAM,CAMvE"}

package/dist/bytes-util.js

@@ -0,0 +1,46 @@
+/** Read the entire source into one buffer (chunked, tolerant of short reads). */
+export async function readAll(src) {
+    const out = new Uint8Array(src.size);
+    let off = 0;
+    while (off < src.size) {
+        const chunk = await src.read(off, Math.min(1 << 20, src.size - off));
+        if (chunk.length === 0)
+            break;
+        out.set(chunk, off);
+        off += chunk.length;
+    }
+    return off === out.length ? out : out.subarray(0, off);
+}
+export const u16le = (b, o) => (b[o] ?? 0) | ((b[o + 1] ?? 0) << 8);
+export const u32le = (b, o) => (((b[o] ?? 0) | ((b[o + 1] ?? 0) << 8) | ((b[o + 2] ?? 0) << 16) | ((b[o + 3] ?? 0) << 24)) >>> 0);
+export function writeU16le(b, o, v) {
+    b[o] = v & 0xff;
+    b[o + 1] = (v >>> 8) & 0xff;
+}
+export function writeU32le(b, o, v) {
+    b[o] = v & 0xff;
+    b[o + 1] = (v >>> 8) & 0xff;
+    b[o + 2] = (v >>> 16) & 0xff;
+    b[o + 3] = (v >>> 24) & 0xff;
+}
+export function writeAscii(b, o, s) {
+    for (let i = 0; i < s.length; i++)
+        b[o + i] = s.charCodeAt(i);
+}
+/** True if the 4+ ASCII chars of `s` sit at offset `o`. */
+export function matchAscii(b, o, s) {
+    for (let i = 0; i < s.length; i++)
+        if (b[o + i] !== s.charCodeAt(i))
+            return false;
+    return true;
+}
+/** First index of ASCII `s` in `b` at/after `from`, or -1. */
+export function indexOfAscii(b, s, from = 0) {
+    const last = b.length - s.length;
+    for (let i = Math.max(0, from); i <= last; i++) {
+        if (matchAscii(b, i, s))
+            return i;
+    }
+    return -1;
+}
+//# sourceMappingURL=bytes-util.js.map

package/dist/bytes-util.js.map

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

package/dist/detect/index.d.ts

@@ -1,6 +1,6 @@
 import type { ByteSource } from '../byte-source.js';
 import type { Confidence } from '../types.js';
-export type FileFormat = 'zip' | 'pdf' | 'mp4' | 'mov' | 'jpeg' | 'png' | 'wav' | 'avi' | 'riff' | 'mkv' | 'webm' | 'mp3' | 'unknown';
+export type FileFormat = 'zip' | 'pdf' | 'mp4' | 'mov' | 'jpeg' | 'png' | 'wav' | 'avi' | 'riff' | 'mkv' | 'webm' | 'mp3' | 'raw' | 'psd' | 'cfbf' | 'unknown';
 export interface FormatDetection {
     format: FileFormat;
     /** Sub-container when known: docx/xlsx/pptx/ooxml/zip for zips, ftyp brand for mp4/mov, riff type for riff. */

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/detect/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAW9C,MAAM,MAAM,UAAU,GAClB,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,MAAM,GACN,KAAK,GACL,KAAK,GACL,KAAK,GACL,MAAM,GACN,KAAK,GACL,MAAM,GACN,KAAK,GACL,SAAS,CAAC;AAEd,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,UAAU,CAAC;IACnB,+GAA+G;IAC/G,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,UAAU,CAAC;IACvB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAoDD;;;GAGG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,eAAe,CAAC,CA2G5E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/detect/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAa9C,MAAM,MAAM,UAAU,GAClB,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,MAAM,GACN,KAAK,GACL,KAAK,GACL,KAAK,GACL,MAAM,GACN,KAAK,GACL,MAAM,GACN,KAAK,GACL,KAAK,GACL,KAAK,GACL,MAAM,GACN,SAAS,CAAC;AAEd,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,UAAU,CAAC;IACnB,+GAA+G;IAC/G,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,UAAU,CAAC;IACvB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAoDD;;;GAGG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,eAAe,CAAC,CA4K5E"}

package/dist/detect/index.js

@@ -1,3 +1,5 @@
+import { findRawStart, rawIdAt } from '../raw/format.js';
+import { findSignature as findPsdSignature } from '../psd/format.js';
 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) {
@@ -72,6 +74,25 @@ export async function detectFormat(src) {
     if (head[0] === 0xff && head[1] === 0xd8 && head[2] === 0xff) {
         return { format: 'jpeg', confidence: 'high', notes };
     }
+    // RAW photo containers: TIFF-family (CR2/NEF/ARW/DNG/generic TIFF) + Fujifilm
+    // RAF at offset 0. CR3 (ISO-BMFF, ftyp "crx ") is handled in the ftyp branch.
+    {
+        const rawId = rawIdAt(head, 0);
+        if (rawId && rawId.container !== 'cr3') {
+            return { format: 'raw', container: rawId.container, confidence: 'high', notes };
+        }
+    }
+    // PSD / PSB (Photoshop) — "8BPS"; version (2 bytes) distinguishes psd vs psb.
+    if (head[0] === 0x38 && head[1] === 0x42 && head[2] === 0x50 && head[3] === 0x53) {
+        const version = (head[4] << 8) | head[5];
+        return { format: 'psd', container: version === 2 ? 'psb' : 'psd', confidence: 'high', notes };
+    }
+    // CFBF / OLE2 (legacy Office .doc/.xls/.ppt/.msg) — D0 CF 11 E0 A1 B1 1A E1.
+    if (head[0] === 0xd0 && head[1] === 0xcf && head[2] === 0x11 && head[3] === 0xe0 &&
+        head[4] === 0xa1 && head[5] === 0xb1 && head[6] === 0x1a && head[7] === 0xe1) {
+        const win = src.size <= head.length ? head : await src.read(0, Math.min(src.size, SCAN_WINDOW));
+        return { format: 'cfbf', container: sniffCfbfContainer(win), confidence: 'high', notes };
+    }
     // RIFF (WAV / AVI)
     if (ascii(head, 0, 4) === 'RIFF' && head.length >= 12) {
         const kind = ascii(head, 8, 12);
@@ -107,6 +128,10 @@ export async function detectFormat(src) {
     // MP4 / MOV: ftyp box at start
     if (head.length >= 12 && ascii(head, 4, 8) === 'ftyp') {
         const brand = ascii(head, 8, 12);
+        // Canon CR3 RAW is ISO-BMFF with the "crx " major brand.
+        if (brand === 'crx ') {
+            return { format: 'raw', container: 'cr3', confidence: 'high', notes };
+        }
         const boxSize = readU32be(head, 0);
         if (boxSize < 8 || boxSize > src.size)
             notes.push('implausible ftyp box size');
@@ -129,6 +154,40 @@ export async function detectFormat(src) {
         notes.push(`PDF header found at offset ${pdfAt} (garbage prefix)`);
         return { format: 'pdf', confidence: pdfAt <= 1024 ? 'high' : 'medium', notes };
     }
+    // RAW header after a garbage prefix (TIFF/RAF at any offset, or ftyp "crx ").
+    const rawStart = findRawStart(window);
+    if (rawStart && rawStart.offset > 0) {
+        notes.push(`RAW header found at offset ${rawStart.offset} (garbage prefix)`);
+        return {
+            format: 'raw',
+            container: rawStart.container,
+            confidence: rawStart.offset <= 1024 ? 'high' : 'medium',
+            notes,
+        };
+    }
+    // PSD/PSB header after a garbage prefix.
+    const psdAt = findPsdSignature(window, SCAN_WINDOW);
+    if (psdAt > 0) {
+        const version = (window[psdAt + 4] << 8) | window[psdAt + 5];
+        notes.push(`8BPS signature found at offset ${psdAt} (garbage prefix)`);
+        return {
+            format: 'psd',
+            container: version === 2 ? 'psb' : 'psd',
+            confidence: psdAt <= 1024 ? 'high' : 'medium',
+            notes,
+        };
+    }
+    // CFBF header after a garbage prefix.
+    const cfbfAt = indexOfBytes(window, [0xd0, 0xcf, 0x11, 0xe0, 0xa1, 0xb1, 0x1a, 0xe1]);
+    if (cfbfAt > 0) {
+        notes.push(`CFBF signature found at offset ${cfbfAt} (garbage prefix)`);
+        return {
+            format: 'cfbf',
+            container: sniffCfbfContainer(window),
+            confidence: cfbfAt <= 1024 ? 'high' : 'medium',
+            notes,
+        };
+    }
     const ftypAt = indexOfBytes(window, [0x66, 0x74, 0x79, 0x70]); // 'ftyp'
     if (ftypAt >= 4) {
         const brand = ascii(window, ftypAt + 4, ftypAt + 8);
@@ -156,4 +215,22 @@ export async function detectFormat(src) {
 function readU32be(b, o) {
     return ((b[o] << 24) | (b[o + 1] << 16) | (b[o + 2] << 8) | b[o + 3]) >>> 0;
 }
+/** Find an ASCII string encoded as UTF-16LE (how CFBF stores directory names). */
+function utf16leIndexOf(b, s) {
+    const needle = [];
+    for (let i = 0; i < s.length; i++) {
+        needle.push(s.charCodeAt(i) & 0xff, 0);
+    }
+    return indexOfBytes(b, needle);
+}
+/** Sniff the legacy-Office document type from the UTF-16 stream names in the bytes. */
+function sniffCfbfContainer(b) {
+    if (utf16leIndexOf(b, 'WordDocument') !== -1)
+        return 'doc';
+    if (utf16leIndexOf(b, 'Workbook') !== -1 || utf16leIndexOf(b, 'Book') !== -1)
+        return 'xls';
+    if (utf16leIndexOf(b, 'PowerPoint Document') !== -1)
+        return 'ppt';
+    return 'ole';
+}
 //# sourceMappingURL=index.js.map