@intactfile/engines 0.1.0

package/README.md

@@ -0,0 +1,68 @@
+# @intactfile/engines
+
+The repair engines behind [IntactFile](https://www.intactfile.com) — the SDK for
+the Business plan. Repair corrupted files **entirely in-process**: nothing is
+uploaded, the file never leaves the machine. Runs in the browser (via injected
+WASM loaders) and in Node (the default loaders resolve their `.wasm` from
+`node_modules` — no wiring needed).
+
+> Repairing files programmatically requires an active IntactFile **Business**
+> subscription. See the [CLI](https://www.npmjs.com/package/@intactfile/cli) and
+> the [MCP server](https://www.npmjs.com/package/@intactfile/mcp), or the docs at
+> https://www.intactfile.com/docs.
+
+## Install
+
+```sh
+npm install @intactfile/engines
+```
+
+Requires **Node ≥ 22** (the SQLite writer uses the built-in `node:sqlite`).
+
+## Usage (Node)
+
+```ts
+import { detectFormat } from "@intactfile/engines";
+import { NodeFileSource } from "@intactfile/engines/node";
+import { repairPdf } from "@intactfile/engines/pdf";
+
+const src = await NodeFileSource.open("broken.pdf");
+const { pdf, report } = await repairPdf(src);
+await src.close();
+
+console.log(report.outcome);            // "success" | "partial" | "failed"
+if (report.outcome !== "failed") {
+  await (await import("node:fs/promises")).writeFile("fixed.pdf", pdf);
+}
+```
+
+Feed engines a `ByteSource`: `NodeFileSource.open(path)` (random-access over an
+fs handle), or `new MemorySource(buffer)` for bytes you already hold.
+
+## Entry points
+
+| Import | Function | Returns |
+| --- | --- | --- |
+| `@intactfile/engines` | `detectFormat(src)` | `{ format, container?, confidence, notes }` |
+| `@intactfile/engines` | `repairZip(src)` | `{ zip, report }` (ZIP/DOCX/XLSX/PPTX) |
+| `@intactfile/engines/pdf` | `repairPdf(src)` | `{ pdf, report }` |
+| `@intactfile/engines/video` | `remuxVideo(src)`, `reconstructMoov(broken, reference)` | `{ video, report }` |
+| `@intactfile/engines/jpeg` | `repairJpeg(src, { reference? })` | `{ image?, preview?, report }` |
+| `@intactfile/engines/png` | `repairPng(src)` | `{ image?, report }` |
+| `@intactfile/engines/sqlite` | `recoverSqlite(src)` | `{ db?, report }` |
+| `@intactfile/engines/archive` | `salvageArchive(src, { password? })` | `{ files, report }` |
+
+Every `*Report` carries an honest `outcome` (`success` / `partial` / `failed`),
+a `damageClass`, `bytesIn`/`bytesOut`, and human-readable notes — the engines
+never fake a success.
+
+## Privacy
+
+The Node path is entirely filesystem + in-process WebAssembly. The only network
+code anywhere is the browser WASM loaders (`*-browser-loader.ts`), never on the
+Node path. Your files are never transmitted.
+
+## License
+
+UNLICENSED — © IntactFile. Usage is governed by the IntactFile terms; the
+Business subscription grants the right to repair programmatically at scale.

package/dist/archive/diagnose.d.ts

@@ -0,0 +1,37 @@
+/**
+ * RAR/7z archive diagnosis — a pure signature + header sniff. No wasm anywhere
+ * in this import chain, so it is safe in the browser-facing root/subpath export
+ * and runs without loading the 7-Zip wasm.
+ *
+ * What it can prove from raw bytes:
+ *   - format family (7z, RAR4, RAR5) and whether a ZIP was handed in by mistake;
+ *   - 7z: start-header CRC and end-header CRC are both standard CRC32 and are
+ *     validated here — this catches corrupt header offsets, a zeroed/flipped
+ *     end-of-archive header, and (because 7z stores its directory at the END of
+ *     the file) tail truncation that runs past EOF;
+ *   - RAR4/RAR5: whether the first block is a valid main header, and whether the
+ *     archive declares header encryption (RAR4 MHD_PASSWORD, RAR5 encryption
+ *     block type 4).
+ *
+ * Honesty rules (docs/03): 7z encryption of the *data* (or an encoded end
+ * header) cannot be told apart from a merely compressed header by raw bytes —
+ * a plain 7z also writes an encoded header — so this sniff never guesses
+ * "encrypted" for 7z; that verdict is left to salvage, which lists the archive
+ * and reads the real per-entry Encrypted flags.
+ */
+import type { ByteSource } from '../byte-source.js';
+import type { Confidence } from '../types.js';
+export type ArchiveFormat = '7z' | 'rar4' | 'rar5' | 'rar' | 'zip' | 'unknown';
+export type ArchiveDamageClass = 'none' | 'truncated' | 'header-damage' | 'not-archive' | 'encrypted' | 'unknown';
+export interface ArchiveDiagnosis {
+    format: ArchiveFormat;
+    damageClass: ArchiveDamageClass;
+    confidence: Confidence;
+    notes: string[];
+    /** Offset of the recognized signature; > 0 means a garbage prefix precedes it. */
+    signatureOffset: number | null;
+    /** 7z only: absolute offset where the end-of-archive header should begin. */
+    endHeaderOffset: number | null;
+}
+export declare function diagnoseArchive(src: ByteSource): Promise<ArchiveDiagnosis>;
+//# sourceMappingURL=diagnose.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"diagnose.d.ts","sourceRoot":"","sources":["../../src/archive/diagnose.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAwB9C,MAAM,MAAM,aAAa,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,SAAS,CAAC;AAE/E,MAAM,MAAM,kBAAkB,GAC1B,MAAM,GACN,WAAW,GACX,eAAe,GACf,aAAa,GACb,WAAW,GACX,SAAS,CAAC;AAEd,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,aAAa,CAAC;IACtB,WAAW,EAAE,kBAAkB,CAAC;IAChC,UAAU,EAAE,UAAU,CAAC;IACvB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,kFAAkF;IAClF,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,6EAA6E;IAC7E,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAOD,wBAAsB,eAAe,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA2DhF"}

package/dist/archive/diagnose.js

@@ -0,0 +1,165 @@
+import { crc32 } from '../crc32.js';
+import { KENCODED_HEADER, KHEADER, RAR4_MHD_ENCRYPTVER, RAR4_TYPE_MAIN, RAR5_TYPE_ENCRYPTION, RAR5_TYPE_MAIN, SEVENZIP_START_HEADER_SIZE, SIG_7Z, SIG_RAR4, SIG_RAR5, SIG_RAR_COMMON, SIG_ZIP_DD, SIG_ZIP_EOCD, SIG_ZIP_LFH, indexOfSig, matchAt, readU16LE, readU32LE, readU64LE, readVint, } from './format.js';
+/** Window scanned for a signature hiding behind a leading garbage prefix. */
+const PREFIX_SCAN_WINDOW = 64 * 1024;
+const hex = (n) => `0x${(n >>> 0).toString(16)}`;
+export async function diagnoseArchive(src) {
+    const notes = [];
+    const size = src.size;
+    const done = (format, damageClass, confidence, signatureOffset = null, endHeaderOffset = null) => ({ format, damageClass, confidence, notes, signatureOffset, endHeaderOffset });
+    if (size === 0) {
+        notes.push('file is empty');
+        return done('unknown', 'not-archive', 'high');
+    }
+    const head = await src.read(0, Math.min(size, 64));
+    // ZIP: recognized but explicitly deferred to the existing zip engine.
+    if (matchAt(head, SIG_ZIP_LFH) || matchAt(head, SIG_ZIP_EOCD) || matchAt(head, SIG_ZIP_DD)) {
+        notes.push('ZIP archive detected — use the ZIP engine (diagnoseZip / repairZip); the archive engine handles 7z and RAR only');
+        return done('zip', 'none', 'high', 0);
+    }
+    if (matchAt(head, SIG_7Z))
+        return diagnose7z(src, size, 0, notes, done);
+    if (matchAt(head, SIG_RAR_COMMON))
+        return diagnoseRar(head, 0, size, notes, done);
+    // Tolerant scan: a signature can hide behind leading junk (e.g. an email
+    // MIME preamble left in front of the archive).
+    const window = size <= head.length ? head : await src.read(0, Math.min(size, PREFIX_SCAN_WINDOW));
+    const at7z = indexOfSig(window, SIG_7Z, 1);
+    const atRar = indexOfSig(window, SIG_RAR_COMMON, 1);
+    const candidates = [at7z, atRar].filter((x) => x > 0).sort((a, b) => a - b);
+    const at = candidates[0];
+    if (at !== undefined) {
+        const is7z = at === at7z;
+        const format = is7z
+            ? '7z'
+            : matchAt(window, SIG_RAR5, at)
+                ? 'rar5'
+                : matchAt(window, SIG_RAR4, at)
+                    ? 'rar4'
+                    : 'rar';
+        notes.push(`${is7z ? '7z' : 'RAR'} signature found at offset ${at} behind ${at} bytes of leading data; ` +
+            'the prefix must be stripped before the archive can be opened');
+        return done(format, 'header-damage', 'medium', at);
+    }
+    const atZip = indexOfSig(window, SIG_ZIP_LFH, 1);
+    if (atZip > 0) {
+        notes.push(`ZIP local header found at offset ${atZip} (garbage prefix) — use the ZIP engine`);
+        return done('zip', 'header-damage', 'medium', atZip);
+    }
+    notes.push('no 7z or RAR signature found (ZIP is handled separately by the zip engine)');
+    return done('unknown', 'not-archive', size > PREFIX_SCAN_WINDOW ? 'medium' : 'high');
+}
+async function diagnose7z(src, size, off, notes, done) {
+    if (size - off < SEVENZIP_START_HEADER_SIZE) {
+        notes.push('7z signature present but the 32-byte start header is incomplete: file is truncated');
+        return done('7z', 'truncated', 'high', off);
+    }
+    const sh = await src.read(off, SEVENZIP_START_HEADER_SIZE);
+    const major = sh[6];
+    const minor = sh[7];
+    if (major !== 0)
+        notes.push(`unexpected 7z format version ${major}.${minor} (expected 0.x)`);
+    const startCrcStored = readU32LE(sh, 8);
+    const startCrcCalc = crc32(sh.subarray(12, 32)); // CRC of the 20-byte NextHeader info
+    if (startCrcStored !== startCrcCalc) {
+        notes.push(`start-header CRC mismatch (stored ${hex(startCrcStored)}, computed ${hex(startCrcCalc)}): ` +
+            'the header offsets are corrupt');
+        return done('7z', 'header-damage', 'high', off);
+    }
+    const nextHeaderOffset = readU64LE(sh, 12);
+    const nextHeaderSize = readU64LE(sh, 20);
+    const nextHeaderCrc = readU32LE(sh, 28);
+    const endHeaderOffset = off + SEVENZIP_START_HEADER_SIZE + nextHeaderOffset;
+    if (nextHeaderOffset === 0 && nextHeaderSize === 0) {
+        notes.push('start header is valid and the archive is empty (no packed streams)');
+        return done('7z', 'none', 'high', off, endHeaderOffset);
+    }
+    const endHeaderEnd = endHeaderOffset + nextHeaderSize;
+    if (endHeaderEnd > size) {
+        notes.push(`end-of-archive header runs to offset ${endHeaderEnd} but the file ends at ${size}: truncated. ` +
+            '7z stores its directory at the end of the file, so a tail cut takes the entry list with it');
+        return done('7z', 'truncated', 'high', off, endHeaderOffset);
+    }
+    const footer = await src.read(endHeaderOffset, nextHeaderSize);
+    if (footer.length < nextHeaderSize) {
+        notes.push('end-of-archive header could not be read in full: truncated');
+        return done('7z', 'truncated', 'high', off, endHeaderOffset);
+    }
+    const footerCrcCalc = crc32(footer);
+    if (footerCrcCalc !== nextHeaderCrc) {
+        if (footer.every((b) => b === 0)) {
+            notes.push('end-of-archive header is zeroed out: the entry directory was destroyed in place');
+        }
+        else {
+            notes.push(`end-of-archive header CRC mismatch (stored ${hex(nextHeaderCrc)}, computed ${hex(footerCrcCalc)}): ` +
+                'the entry directory is corrupt');
+        }
+        return done('7z', 'header-damage', 'high', off, endHeaderOffset);
+    }
+    const kind = footer[0];
+    if (kind === KENCODED_HEADER) {
+        notes.push('end-of-archive header is encoded (compressed and/or encrypted); per-entry integrity and any ' +
+            'encryption are confirmed only by salvage (list + extract)');
+    }
+    else if (kind === KHEADER) {
+        notes.push('end-of-archive header is a plain, intact header');
+    }
+    return done('7z', 'none', 'high', off, endHeaderOffset);
+}
+function diagnoseRar(head, off, size, notes, done) {
+    // --- RAR5 ---
+    if (matchAt(head, SIG_RAR5, off)) {
+        const blockStart = off + SIG_RAR5.length;
+        if (size - blockStart < 5) {
+            notes.push('RAR5 signature present but no block header follows: file is truncated');
+            return done('rar5', 'truncated', 'high', off);
+        }
+        let p = blockStart + 4; // skip the 4-byte header CRC32
+        const hsize = readVint(head, p);
+        if (!hsize) {
+            notes.push('RAR5 block header size is unreadable: truncated');
+            return done('rar5', 'truncated', 'medium', off);
+        }
+        p += hsize.length;
+        const htype = readVint(head, p);
+        if (!htype) {
+            notes.push('RAR5 block header type is unreadable: truncated');
+            return done('rar5', 'truncated', 'medium', off);
+        }
+        if (htype.value === RAR5_TYPE_ENCRYPTION) {
+            notes.push('RAR5 archive opens with an encryption header: the archive and its headers are password-protected');
+            return done('rar5', 'encrypted', 'high', off);
+        }
+        if (htype.value === RAR5_TYPE_MAIN) {
+            notes.push('RAR5 main archive header present; structure looks intact');
+            return done('rar5', 'none', 'high', off);
+        }
+        notes.push(`RAR5 first block has unexpected type ${htype.value} (expected main=1 or encryption=4): header damaged`);
+        return done('rar5', 'header-damage', 'medium', off);
+    }
+    // --- RAR4 ---
+    if (matchAt(head, SIG_RAR4, off)) {
+        const blockStart = off + SIG_RAR4.length;
+        if (size - blockStart < 7) {
+            notes.push('RAR4 signature present but the main header is incomplete: file is truncated');
+            return done('rar4', 'truncated', 'high', off);
+        }
+        const type = head[blockStart + 2];
+        const flags = readU16LE(head, blockStart + 3);
+        if (type !== RAR4_TYPE_MAIN) {
+            notes.push(`RAR4 first block type ${hex(type)} is not a main header (0x73): header damaged`);
+            return done('rar4', 'header-damage', 'medium', off);
+        }
+        if (flags & RAR4_MHD_ENCRYPTVER) {
+            notes.push('RAR4 main header sets the password flag: the archive headers are encrypted');
+            return done('rar4', 'encrypted', 'high', off);
+        }
+        notes.push('RAR4 main header present; structure looks intact');
+        return done('rar4', 'none', 'high', off);
+    }
+    // RAR mark present but the version discriminator byte is neither 0x00 nor 0x01.
+    const verByte = head[off + 6] ?? 0;
+    notes.push(`RAR mark header present but version byte ${hex(verByte)} is neither RAR4 (0x00) nor RAR5 (0x01): header damaged`);
+    return done('rar', 'header-damage', 'medium', off);
+}
+//# sourceMappingURL=diagnose.js.map

package/dist/archive/diagnose.js.map

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

package/dist/archive/format.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Pure byte-level constants and helpers for RAR/7z archive sniffing. No wasm in
+ * this import chain, so it is safe in the browser-facing diagnosis path.
+ *
+ * Signatures (docs/14 §RAR/7z):
+ *   7z    37 7A BC AF 27 1C
+ *   RAR4  52 61 72 21 1A 07 00           ("Rar!\x1a\x07\x00")
+ *   RAR5  52 61 72 21 1A 07 01 00        ("Rar!\x1a\x07\x01\x00")
+ *   ZIP   50 4B 03 04 / 05 06 / 07 08    (handled by the existing zip engine)
+ */
+export declare const SIG_7Z: readonly [55, 122, 188, 175, 39, 28];
+export declare const SIG_RAR4: readonly [82, 97, 114, 33, 26, 7, 0];
+export declare const SIG_RAR5: readonly [82, 97, 114, 33, 26, 7, 1, 0];
+/** RAR mark head without the version discriminator (byte 6): "Rar!\x1a\x07". */
+export declare const SIG_RAR_COMMON: readonly [82, 97, 114, 33, 26, 7];
+export declare const SIG_ZIP_LFH: readonly [80, 75, 3, 4];
+export declare const SIG_ZIP_EOCD: readonly [80, 75, 5, 6];
+export declare const SIG_ZIP_DD: readonly [80, 75, 7, 8];
+/** The 7z start header is a fixed 32-byte record before any packed data. */
+export declare const SEVENZIP_START_HEADER_SIZE = 32;
+/** 7z NextHeader property ids (first byte of the end-of-archive header). */
+export declare const KHEADER = 1;
+export declare const KENCODED_HEADER = 23;
+/** RAR5 block header types (the value of the "header type" vint). */
+export declare const RAR5_TYPE_MAIN = 1;
+export declare const RAR5_TYPE_FILE = 2;
+export declare const RAR5_TYPE_SERVICE = 3;
+export declare const RAR5_TYPE_ENCRYPTION = 4;
+export declare const RAR5_TYPE_ENDARC = 5;
+/** RAR4 block header types. */
+export declare const RAR4_TYPE_MAIN = 115;
+export declare const RAR4_TYPE_FILE = 116;
+/** RAR4 main-header flag: whole-archive headers are password-encrypted. */
+export declare const RAR4_MHD_ENCRYPTVER = 128;
+export declare function matchAt(bytes: Uint8Array, sig: readonly number[], offset?: number): boolean;
+/** First offset at or after `from` where `sig` occurs, or -1. */
+export declare function indexOfSig(bytes: Uint8Array, sig: readonly number[], from?: number): number;
+export declare function readU16LE(b: Uint8Array, o: number): number;
+export declare function readU32LE(b: Uint8Array, o: number): number;
+/** Little-endian u64 as a Number. 7z offsets never exceed 2^53 in practice. */
+export declare function readU64LE(b: Uint8Array, o: number): number;
+export interface Vint {
+    value: number;
+    /** Bytes consumed. */
+    length: number;
+}
+/**
+ * RAR5 variable-width integer: 7 bits per byte, little-endian, high bit is the
+ * continuation flag. Returns null when the buffer ends mid-vint.
+ */
+export declare function readVint(b: Uint8Array, o: number): Vint | null;
+//# sourceMappingURL=format.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/archive/format.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,eAAO,MAAM,MAAM,sCAAgD,CAAC;AACpE,eAAO,MAAM,QAAQ,sCAAsD,CAAC;AAC5E,eAAO,MAAM,QAAQ,yCAA4D,CAAC;AAClF,gFAAgF;AAChF,eAAO,MAAM,cAAc,mCAAgD,CAAC;AAE5E,eAAO,MAAM,WAAW,yBAAoC,CAAC;AAC7D,eAAO,MAAM,YAAY,yBAAoC,CAAC;AAC9D,eAAO,MAAM,UAAU,yBAAoC,CAAC;AAE5D,4EAA4E;AAC5E,eAAO,MAAM,0BAA0B,KAAK,CAAC;AAE7C,4EAA4E;AAC5E,eAAO,MAAM,OAAO,IAAO,CAAC;AAC5B,eAAO,MAAM,eAAe,KAAO,CAAC;AAEpC,qEAAqE;AACrE,eAAO,MAAM,cAAc,IAAI,CAAC;AAChC,eAAO,MAAM,cAAc,IAAI,CAAC;AAChC,eAAO,MAAM,iBAAiB,IAAI,CAAC;AACnC,eAAO,MAAM,oBAAoB,IAAI,CAAC;AACtC,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAElC,+BAA+B;AAC/B,eAAO,MAAM,cAAc,MAAO,CAAC;AACnC,eAAO,MAAM,cAAc,MAAO,CAAC;AACnC,2EAA2E;AAC3E,eAAO,MAAM,mBAAmB,MAAS,CAAC;AAE1C,wBAAgB,OAAO,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,SAAS,MAAM,EAAE,EAAE,MAAM,SAAI,GAAG,OAAO,CAMtF;AAED,iEAAiE;AACjE,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,SAAS,MAAM,EAAE,EAAE,IAAI,SAAI,GAAG,MAAM,CAQtF;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,+EAA+E;AAC/E,wBAAgB,SAAS,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAM1D;AAED,MAAM,WAAW,IAAI;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAY9D"}

package/dist/archive/format.js

@@ -0,0 +1,87 @@
+/**
+ * Pure byte-level constants and helpers for RAR/7z archive sniffing. No wasm in
+ * this import chain, so it is safe in the browser-facing diagnosis path.
+ *
+ * Signatures (docs/14 §RAR/7z):
+ *   7z    37 7A BC AF 27 1C
+ *   RAR4  52 61 72 21 1A 07 00           ("Rar!\x1a\x07\x00")
+ *   RAR5  52 61 72 21 1A 07 01 00        ("Rar!\x1a\x07\x01\x00")
+ *   ZIP   50 4B 03 04 / 05 06 / 07 08    (handled by the existing zip engine)
+ */
+export const SIG_7Z = [0x37, 0x7a, 0xbc, 0xaf, 0x27, 0x1c];
+export const SIG_RAR4 = [0x52, 0x61, 0x72, 0x21, 0x1a, 0x07, 0x00];
+export const SIG_RAR5 = [0x52, 0x61, 0x72, 0x21, 0x1a, 0x07, 0x01, 0x00];
+/** RAR mark head without the version discriminator (byte 6): "Rar!\x1a\x07". */
+export const SIG_RAR_COMMON = [0x52, 0x61, 0x72, 0x21, 0x1a, 0x07];
+export const SIG_ZIP_LFH = [0x50, 0x4b, 0x03, 0x04];
+export const SIG_ZIP_EOCD = [0x50, 0x4b, 0x05, 0x06];
+export const SIG_ZIP_DD = [0x50, 0x4b, 0x07, 0x08];
+/** The 7z start header is a fixed 32-byte record before any packed data. */
+export const SEVENZIP_START_HEADER_SIZE = 32;
+/** 7z NextHeader property ids (first byte of the end-of-archive header). */
+export const KHEADER = 0x01;
+export const KENCODED_HEADER = 0x17;
+/** RAR5 block header types (the value of the "header type" vint). */
+export const RAR5_TYPE_MAIN = 1;
+export const RAR5_TYPE_FILE = 2;
+export const RAR5_TYPE_SERVICE = 3;
+export const RAR5_TYPE_ENCRYPTION = 4;
+export const RAR5_TYPE_ENDARC = 5;
+/** RAR4 block header types. */
+export const RAR4_TYPE_MAIN = 0x73; // MAIN_HEAD ('s')
+export const RAR4_TYPE_FILE = 0x74; // FILE_HEAD ('t')
+/** RAR4 main-header flag: whole-archive headers are password-encrypted. */
+export const RAR4_MHD_ENCRYPTVER = 0x0080; // MHD_PASSWORD
+export function matchAt(bytes, sig, offset = 0) {
+    if (offset + sig.length > bytes.length)
+        return false;
+    for (let i = 0; i < sig.length; i += 1) {
+        if (bytes[offset + i] !== sig[i])
+            return false;
+    }
+    return true;
+}
+/** First offset at or after `from` where `sig` occurs, or -1. */
+export function indexOfSig(bytes, sig, from = 0) {
+    outer: for (let i = from; i + sig.length <= bytes.length; i += 1) {
+        for (let j = 0; j < sig.length; j += 1) {
+            if (bytes[i + j] !== sig[j])
+                continue outer;
+        }
+        return i;
+    }
+    return -1;
+}
+export function readU16LE(b, o) {
+    return (b[o] | (b[o + 1] << 8)) & 0xffff;
+}
+export function readU32LE(b, o) {
+    return ((b[o] | (b[o + 1] << 8) | (b[o + 2] << 16) | (b[o + 3] << 24)) >>> 0);
+}
+/** Little-endian u64 as a Number. 7z offsets never exceed 2^53 in practice. */
+export function readU64LE(b, o) {
+    let hi = 0;
+    let lo = 0;
+    lo = (b[o] | (b[o + 1] << 8) | (b[o + 2] << 16) | (b[o + 3] << 24)) >>> 0;
+    hi = (b[o + 4] | (b[o + 5] << 8) | (b[o + 6] << 16) | (b[o + 7] << 24)) >>> 0;
+    return hi * 0x1_0000_0000 + lo;
+}
+/**
+ * RAR5 variable-width integer: 7 bits per byte, little-endian, high bit is the
+ * continuation flag. Returns null when the buffer ends mid-vint.
+ */
+export function readVint(b, o) {
+    let value = 0;
+    let shift = 0;
+    let i = o;
+    while (i < b.length && shift < 64) {
+        const byte = b[i];
+        value += (byte & 0x7f) * 2 ** shift;
+        i += 1;
+        if ((byte & 0x80) === 0)
+            return { value, length: i - o };
+        shift += 7;
+    }
+    return null;
+}
+//# sourceMappingURL=format.js.map

package/dist/archive/format.js.map

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

package/dist/archive/host.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Isolated, injectable host for 7z-wasm (use-strict/7z-wasm 1.2.0 — 7-Zip 24.09
+ * compiled to WASM). License: GNU LGPL + unRAR restriction. The unRAR decoder
+ * bundled in the wasm may be used to EXTRACT RAR archives but NOT to build a
+ * RAR-compatible archiver; see ./LICENSE-unrar.txt. This host therefore never
+ * exposes (and salvage never issues) a RAR creation command.
+ *
+ * wasm size: 7zz.wasm is ~1.65 MB (uncompressed) — a single 7-Zip binary that
+ * lists and extracts 7z, RAR (via unRAR), ZIP, tar, gzip, bzip2, xz, etc.
+ *
+ * Loading mirrors pdf/qpdf-host.ts and video/libav-host.ts: Node's default
+ * loader resolves the CJS/UMD wrapper from node_modules; a browser host calls
+ * setSevenZipLoader() with the wrapper factory (and locateFile/wasmBinary
+ * pointing at R2) before any salvage. Only the *factory* is cached — each
+ * salvage run gets its own module instance because 7-Zip's `main` calls exit()
+ * (with noExitRuntime the same instance is reused across the list + per-entry
+ * extract calls of a single run, but not across runs).
+ */
+/** The slice of the Emscripten module surface this package uses. */
+export interface SevenZipFS {
+    writeFile(path: string, data: Uint8Array, opts?: {
+        flags?: string;
+    }): void;
+    readFile(path: string, opts?: {
+        encoding?: 'binary' | 'utf8';
+        flags?: string;
+    }): Uint8Array;
+    readdir(path: string): string[];
+    stat(path: string, dontFollow?: boolean): {
+        size: number;
+        mode: number;
+    };
+    isFile(mode: number): boolean;
+    isDir(mode: number): boolean;
+    mkdir(path: string, mode?: number): unknown;
+    analyzePath?(path: string): {
+        exists: boolean;
+    };
+}
+export interface SevenZipModule {
+    FS: SevenZipFS;
+    callMain(args: string[]): void;
+}
+export interface SevenZipModuleOptions {
+    noExitRuntime?: boolean;
+    stdin?: () => number | null;
+    print?: (line: string) => void;
+    printErr?: (line: string) => void;
+    locateFile?: (url: string, scriptDirectory: string) => string;
+    wasmBinary?: ArrayBuffer | Uint8Array;
+    [key: string]: unknown;
+}
+export interface SevenZipFactory {
+    (opts?: SevenZipModuleOptions): Promise<SevenZipModule>;
+}
+export interface SevenZipLoader {
+    factory: SevenZipFactory;
+    /** Extra options merged into every module instance (locateFile, wasmBinary…). */
+    factoryOpts?: SevenZipModuleOptions;
+}
+/** Inject how the 7z-wasm factory is obtained (browser hosts). */
+export declare function setSevenZipLoader(load: () => Promise<SevenZipLoader>): void;
+/** Drop the cached factory (tests, or after a wasm crash). */
+export declare function resetSevenZipHost(): void;
+/** stdout/stderr and exit code of one 7-Zip command. */
+export interface SevenZipResult {
+    code: number;
+    stdout: string;
+    stderr: string;
+}
+export interface SevenZipSession {
+    fs: SevenZipFS;
+    /** Run one 7-Zip command; captures stdout/stderr and never throws. */
+    run(args: string[]): SevenZipResult;
+}
+/**
+ * Create a fresh 7-Zip module and hand a session to `fn`. stdin returns EOF so a
+ * password prompt on an encrypted archive fails fast instead of hanging.
+ */
+export declare function withSevenZip<T>(fn: (session: SevenZipSession) => Promise<T> | T): Promise<T>;
+/** Eagerly resolve the factory (used by salvage to surface load failures honestly). */
+export declare function ensureSevenZip(): Promise<void>;
+//# sourceMappingURL=host.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../../src/archive/host.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,oEAAoE;AACpE,MAAM,WAAW,UAAU;IACzB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC3E,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,UAAU,CAAC;IAC5F,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAChC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,OAAO,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACzE,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAC9B,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7B,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC5C,WAAW,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG;QAAE,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC;CACjD;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,UAAU,CAAC;IACf,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,qBAAqB;IACpC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,KAAK,MAAM,CAAC;IAC9D,UAAU,CAAC,EAAE,WAAW,GAAG,UAAU,CAAC;IACtC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,CAAC,IAAI,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CACzD;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,eAAe,CAAC;IACzB,iFAAiF;IACjF,WAAW,CAAC,EAAE,qBAAqB,CAAC;CACrC;AAKD,kEAAkE;AAClE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI,CAG3E;AAED,8DAA8D;AAC9D,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAyBD,wDAAwD;AACxD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,UAAU,CAAC;IACf,sEAAsE;IACtE,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,cAAc,CAAC;CACrC;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CA+BlG;AAED,uFAAuF;AACvF,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAEpD"}

package/dist/archive/host.js

@@ -0,0 +1,92 @@
+/**
+ * Isolated, injectable host for 7z-wasm (use-strict/7z-wasm 1.2.0 — 7-Zip 24.09
+ * compiled to WASM). License: GNU LGPL + unRAR restriction. The unRAR decoder
+ * bundled in the wasm may be used to EXTRACT RAR archives but NOT to build a
+ * RAR-compatible archiver; see ./LICENSE-unrar.txt. This host therefore never
+ * exposes (and salvage never issues) a RAR creation command.
+ *
+ * wasm size: 7zz.wasm is ~1.65 MB (uncompressed) — a single 7-Zip binary that
+ * lists and extracts 7z, RAR (via unRAR), ZIP, tar, gzip, bzip2, xz, etc.
+ *
+ * Loading mirrors pdf/qpdf-host.ts and video/libav-host.ts: Node's default
+ * loader resolves the CJS/UMD wrapper from node_modules; a browser host calls
+ * setSevenZipLoader() with the wrapper factory (and locateFile/wasmBinary
+ * pointing at R2) before any salvage. Only the *factory* is cached — each
+ * salvage run gets its own module instance because 7-Zip's `main` calls exit()
+ * (with noExitRuntime the same instance is reused across the list + per-entry
+ * extract calls of a single run, but not across runs).
+ */
+let loaderOverride = null;
+let factoryPromise = null;
+/** Inject how the 7z-wasm factory is obtained (browser hosts). */
+export function setSevenZipLoader(load) {
+    loaderOverride = load;
+    factoryPromise = null;
+}
+/** Drop the cached factory (tests, or after a wasm crash). */
+export function resetSevenZipHost() {
+    factoryPromise = null;
+}
+async function defaultNodeLoader() {
+    const isNode = typeof process !== 'undefined' && !!process.versions?.node;
+    if (!isNode) {
+        throw new Error('archive host: no loader configured. In the browser, call setSevenZipLoader() with the ' +
+            '7z-wasm factory and a locateFile/wasmBinary for 7zz.wasm before listing or extracting.');
+    }
+    const { createRequire } = await import('node:module');
+    const require = createRequire(import.meta.url);
+    const mod = require('7z-wasm');
+    const factory = typeof mod === 'function' ? mod : mod.default;
+    return { factory };
+}
+function getLoader() {
+    factoryPromise ??= (loaderOverride ?? defaultNodeLoader)().catch((e) => {
+        factoryPromise = null;
+        throw e;
+    });
+    return factoryPromise;
+}
+/**
+ * Create a fresh 7-Zip module and hand a session to `fn`. stdin returns EOF so a
+ * password prompt on an encrypted archive fails fast instead of hanging.
+ */
+export async function withSevenZip(fn) {
+    const { factory, factoryOpts } = await getLoader();
+    const outBuf = [];
+    const errBuf = [];
+    const module = await factory({
+        noExitRuntime: true,
+        stdin: () => null,
+        print: (line) => outBuf.push(line),
+        printErr: (line) => errBuf.push(line),
+        ...factoryOpts,
+    });
+    const session = {
+        fs: module.FS,
+        run(args) {
+            outBuf.length = 0;
+            errBuf.length = 0;
+            let code = 0;
+            try {
+                module.callMain(args);
+            }
+            catch (e) {
+                // Emscripten throws the raw exit status (a number) on exit(n), or an
+                // ExitStatus-like object; either way a non-zero code is a failure.
+                if (typeof e === 'number')
+                    code = e;
+                else if (e && typeof e === 'object' && 'status' in e)
+                    code = Number(e.status) || 1;
+                else
+                    code = 1;
+            }
+            return { code, stdout: outBuf.join('\n'), stderr: errBuf.join('\n') };
+        },
+    };
+    return fn(session);
+}
+/** Eagerly resolve the factory (used by salvage to surface load failures honestly). */
+export async function ensureSevenZip() {
+    await getLoader();
+}
+//# sourceMappingURL=host.js.map

package/dist/archive/host.js.map

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