@intactfile/engines 0.1.0

package/dist/sqlite/format.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Low-level SQLite file-format primitives shared by diagnosis and recovery.
+ * Pure functions, no engine dependency. Everything here is derived from the
+ * public-domain SQLite file format spec (https://sqlite.org/fileformat2.html):
+ * the 100-byte database header, the b-tree page layout, varints and the record
+ * (serial-type) format. Kept dependency-free so it runs identically in Node and
+ * the browser.
+ */
+/** The 16-byte magic that opens every SQLite database: "SQLite format 3\0". */
+export declare const SQLITE_MAGIC: Uint8Array<ArrayBuffer>;
+export declare const HEADER_SIZE = 100;
+/** B-tree page type bytes. */
+export declare const PAGE_INTERIOR_INDEX = 2;
+export declare const PAGE_INTERIOR_TABLE = 5;
+export declare const PAGE_LEAF_INDEX = 10;
+export declare const PAGE_LEAF_TABLE = 13;
+/** Storage-class values decoded from a record. INTEGERs that fit in a JS number
+ * come back as `number`; wider 64-bit integers come back as `bigint`. */
+export type SqlValue = null | number | bigint | string | Uint8Array;
+export interface SqliteHeader {
+    pageSize: number;
+    /** Reserved bytes at the end of each page (usually 0). */
+    reservedBytes: number;
+    writeVersion: number;
+    readVersion: number;
+    fileChangeCounter: number;
+    /** In-header database size in pages (offset 28). Only trustworthy when valid. */
+    pageCount: number;
+    /** True when the in-header page count is authoritative (SQLite's own rule:
+     * change counter at offset 24 equals version-valid-for at offset 92). */
+    pageCountValid: boolean;
+    freelistTrunkPage: number;
+    freelistPageCount: number;
+    schemaCookie: number;
+    schemaFormat: number;
+    /** 1 = UTF-8, 2 = UTF-16le, 3 = UTF-16be. */
+    textEncoding: number;
+    versionValidFor: number;
+    sqliteVersion: number;
+}
+export declare function readU16(b: Uint8Array, off: number): number;
+export declare function readU32(b: Uint8Array, off: number): number;
+/** Does the buffer start with the SQLite magic string? */
+export declare function hasMagic(b: Uint8Array): boolean;
+/** True for a page size SQLite accepts: a power of two in [512, 65536]. The
+ * on-disk value 1 is the spec's stand-in for 65536. */
+export declare function isValidPageSize(raw: number): boolean;
+export declare function decodePageSize(raw: number): number;
+/**
+ * Parse the 100-byte database header. Returns null when the magic is absent or
+ * the page size is structurally impossible; every other field is returned raw
+ * so the diagnosis layer can decide how damaged it is.
+ */
+export declare function parseHeader(b: Uint8Array): SqliteHeader | null;
+/** Decoded big-endian variable-length integer and how many bytes it used. */
+export interface Varint {
+    value: bigint;
+    length: number;
+}
+/**
+ * Read a SQLite varint (1-9 big-endian bytes; high bit is a continuation flag,
+ * except the 9th byte contributes all 8 bits). Returns a bigint so 64-bit
+ * rowids and integer serial types never lose precision.
+ */
+export declare function readVarint(b: Uint8Array, off: number): Varint;
+/** Narrow a bigint to a JS number when it is exactly representable. */
+export declare function toSafeInt(v: bigint): number | bigint;
+export interface BtreePageHeader {
+    type: number;
+    firstFreeblock: number;
+    cellCount: number;
+    cellContentStart: number;
+    fragmentedFreeBytes: number;
+    /** Interior pages only; -1 on leaf pages. */
+    rightMostPointer: number;
+    /** Offset within the page where the cell-pointer array begins. */
+    cellPointerArrayOffset: number;
+    /** Offset within the page where the b-tree header begins (100 on page 1). */
+    headerOffset: number;
+}
+export declare function isBtreePageType(type: number): boolean;
+export declare function isInterior(type: number): boolean;
+/**
+ * Parse a b-tree page header. `pageNo` distinguishes page 1 (whose b-tree
+ * header sits after the 100-byte database header). Returns null when the type
+ * byte is not a b-tree page type.
+ */
+export declare function parseBtreePageHeader(page: Uint8Array, pageNo: number): BtreePageHeader | null;
+/** Cell-content offsets (relative to page start) from the cell-pointer array. */
+export declare function readCellPointers(page: Uint8Array, hdr: BtreePageHeader): number[];
+export interface DecodedRecord {
+    /** One value per column, in storage order. */
+    values: SqlValue[];
+    /** Serial type codes, parallel to `values` (useful for honest reporting). */
+    serialTypes: number[];
+}
+/**
+ * Decode a record (the "payload" of a table-leaf cell) into typed values.
+ * `textEncoding` selects the decoder for TEXT columns. Returns null when the
+ * record header is self-inconsistent (a common symptom of bit-rot).
+ */
+export declare function decodeRecord(payload: Uint8Array, textEncoding: number): DecodedRecord | null;
+//# sourceMappingURL=format.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/sqlite/format.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,+EAA+E;AAC/E,eAAO,MAAM,YAAY,yBAEvB,CAAC;AAEH,eAAO,MAAM,WAAW,MAAM,CAAC;AAE/B,8BAA8B;AAC9B,eAAO,MAAM,mBAAmB,IAAO,CAAC;AACxC,eAAO,MAAM,mBAAmB,IAAO,CAAC;AACxC,eAAO,MAAM,eAAe,KAAO,CAAC;AACpC,eAAO,MAAM,eAAe,KAAO,CAAC;AAEpC;yEACyE;AACzE,MAAM,MAAM,QAAQ,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,CAAC;AAEpE,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iFAAiF;IACjF,SAAS,EAAE,MAAM,CAAC;IAClB;6EACyE;IACzE,cAAc,EAAE,OAAO,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,6CAA6C;IAC7C,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAO1D;AAED,0DAA0D;AAC1D,wBAAgB,QAAQ,CAAC,CAAC,EAAE,UAAU,GAAG,OAAO,CAI/C;AAED;uDACuD;AACvD,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAGpD;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,UAAU,GAAG,YAAY,GAAG,IAAI,CAuB9D;AAED,6EAA6E;AAC7E,MAAM,WAAW,MAAM;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAa7D;AAED,uEAAuE;AACvE,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAEpD;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,6CAA6C;IAC7C,gBAAgB,EAAE,MAAM,CAAC;IACzB,kEAAkE;IAClE,sBAAsB,EAAE,MAAM,CAAC;IAC/B,6EAA6E;IAC7E,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAOrD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEhD;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAiB7F;AAED,iFAAiF;AACjF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,eAAe,GAAG,MAAM,EAAE,CAOjF;AAED,MAAM,WAAW,aAAa;IAC5B,8CAA8C;IAC9C,MAAM,EAAE,QAAQ,EAAE,CAAC;IACnB,6EAA6E;IAC7E,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAwB5F"}

package/dist/sqlite/format.js

@@ -0,0 +1,237 @@
+/**
+ * Low-level SQLite file-format primitives shared by diagnosis and recovery.
+ * Pure functions, no engine dependency. Everything here is derived from the
+ * public-domain SQLite file format spec (https://sqlite.org/fileformat2.html):
+ * the 100-byte database header, the b-tree page layout, varints and the record
+ * (serial-type) format. Kept dependency-free so it runs identically in Node and
+ * the browser.
+ */
+/** The 16-byte magic that opens every SQLite database: "SQLite format 3\0". */
+export const SQLITE_MAGIC = new Uint8Array([
+    0x53, 0x51, 0x4c, 0x69, 0x74, 0x65, 0x20, 0x66, 0x6f, 0x72, 0x6d, 0x61, 0x74, 0x20, 0x33, 0x00,
+]);
+export const HEADER_SIZE = 100;
+/** B-tree page type bytes. */
+export const PAGE_INTERIOR_INDEX = 0x02;
+export const PAGE_INTERIOR_TABLE = 0x05;
+export const PAGE_LEAF_INDEX = 0x0a;
+export const PAGE_LEAF_TABLE = 0x0d;
+export function readU16(b, off) {
+    return ((b[off] ?? 0) << 8) | (b[off + 1] ?? 0);
+}
+export function readU32(b, off) {
+    return ((b[off] ?? 0) * 0x1000000 +
+        ((b[off + 1] ?? 0) << 16) +
+        ((b[off + 2] ?? 0) << 8) +
+        (b[off + 3] ?? 0));
+}
+/** Does the buffer start with the SQLite magic string? */
+export function hasMagic(b) {
+    if (b.length < SQLITE_MAGIC.length)
+        return false;
+    for (let i = 0; i < SQLITE_MAGIC.length; i++)
+        if (b[i] !== SQLITE_MAGIC[i])
+            return false;
+    return true;
+}
+/** True for a page size SQLite accepts: a power of two in [512, 65536]. The
+ * on-disk value 1 is the spec's stand-in for 65536. */
+export function isValidPageSize(raw) {
+    const size = raw === 1 ? 65536 : raw;
+    return size >= 512 && size <= 65536 && (size & (size - 1)) === 0;
+}
+export function decodePageSize(raw) {
+    return raw === 1 ? 65536 : raw;
+}
+/**
+ * Parse the 100-byte database header. Returns null when the magic is absent or
+ * the page size is structurally impossible; every other field is returned raw
+ * so the diagnosis layer can decide how damaged it is.
+ */
+export function parseHeader(b) {
+    if (!hasMagic(b) || b.length < HEADER_SIZE)
+        return null;
+    const rawPageSize = readU16(b, 16);
+    if (!isValidPageSize(rawPageSize))
+        return null;
+    const fileChangeCounter = readU32(b, 24);
+    const versionValidFor = readU32(b, 92);
+    const pageCount = readU32(b, 28);
+    return {
+        pageSize: decodePageSize(rawPageSize),
+        writeVersion: b[18] ?? 0,
+        readVersion: b[19] ?? 0,
+        reservedBytes: b[20] ?? 0,
+        fileChangeCounter,
+        pageCount,
+        pageCountValid: pageCount > 0 && fileChangeCounter === versionValidFor,
+        freelistTrunkPage: readU32(b, 32),
+        freelistPageCount: readU32(b, 36),
+        schemaCookie: readU32(b, 40),
+        schemaFormat: readU32(b, 44),
+        textEncoding: readU32(b, 56),
+        versionValidFor,
+        sqliteVersion: readU32(b, 96),
+    };
+}
+/**
+ * Read a SQLite varint (1-9 big-endian bytes; high bit is a continuation flag,
+ * except the 9th byte contributes all 8 bits). Returns a bigint so 64-bit
+ * rowids and integer serial types never lose precision.
+ */
+export function readVarint(b, off) {
+    let value = 0n;
+    for (let i = 0; i < 8; i++) {
+        const byte = b[off + i];
+        if (byte === undefined)
+            return { value, length: i };
+        value = (value << 7n) | BigInt(byte & 0x7f);
+        if ((byte & 0x80) === 0)
+            return { value, length: i + 1 };
+    }
+    // 9th byte: all 8 bits contribute.
+    const ninth = b[off + 8];
+    if (ninth === undefined)
+        return { value, length: 8 };
+    value = (value << 8n) | BigInt(ninth);
+    return { value, length: 9 };
+}
+/** Narrow a bigint to a JS number when it is exactly representable. */
+export function toSafeInt(v) {
+    return v >= BigInt(Number.MIN_SAFE_INTEGER) && v <= BigInt(Number.MAX_SAFE_INTEGER) ? Number(v) : v;
+}
+export function isBtreePageType(type) {
+    return (type === PAGE_INTERIOR_INDEX ||
+        type === PAGE_INTERIOR_TABLE ||
+        type === PAGE_LEAF_INDEX ||
+        type === PAGE_LEAF_TABLE);
+}
+export function isInterior(type) {
+    return type === PAGE_INTERIOR_INDEX || type === PAGE_INTERIOR_TABLE;
+}
+/**
+ * Parse a b-tree page header. `pageNo` distinguishes page 1 (whose b-tree
+ * header sits after the 100-byte database header). Returns null when the type
+ * byte is not a b-tree page type.
+ */
+export function parseBtreePageHeader(page, pageNo) {
+    const headerOffset = pageNo === 1 ? HEADER_SIZE : 0;
+    const type = page[headerOffset];
+    if (type === undefined || !isBtreePageType(type))
+        return null;
+    const interior = isInterior(type);
+    const cellCount = readU16(page, headerOffset + 3);
+    const rawContentStart = readU16(page, headerOffset + 5);
+    return {
+        type,
+        firstFreeblock: readU16(page, headerOffset + 1),
+        cellCount,
+        cellContentStart: rawContentStart === 0 ? 65536 : rawContentStart,
+        fragmentedFreeBytes: page[headerOffset + 7] ?? 0,
+        rightMostPointer: interior ? readU32(page, headerOffset + 8) : -1,
+        cellPointerArrayOffset: headerOffset + (interior ? 12 : 8),
+        headerOffset,
+    };
+}
+/** Cell-content offsets (relative to page start) from the cell-pointer array. */
+export function readCellPointers(page, hdr) {
+    const out = [];
+    for (let i = 0; i < hdr.cellCount; i++) {
+        const ptr = readU16(page, hdr.cellPointerArrayOffset + i * 2);
+        if (ptr >= hdr.headerOffset && ptr < page.length)
+            out.push(ptr);
+    }
+    return out;
+}
+/**
+ * Decode a record (the "payload" of a table-leaf cell) into typed values.
+ * `textEncoding` selects the decoder for TEXT columns. Returns null when the
+ * record header is self-inconsistent (a common symptom of bit-rot).
+ */
+export function decodeRecord(payload, textEncoding) {
+    if (payload.length === 0)
+        return null;
+    const first = readVarint(payload, 0);
+    const headerLength = Number(first.value);
+    if (headerLength <= 0 || headerLength > payload.length)
+        return null;
+    const serialTypes = [];
+    let p = first.length;
+    while (p < headerLength) {
+        const st = readVarint(payload, p);
+        if (st.length === 0)
+            return null;
+        serialTypes.push(Number(st.value));
+        p += st.length;
+    }
+    const values = [];
+    let body = headerLength;
+    for (const st of serialTypes) {
+        const [value, size] = decodeSerial(payload, body, st, textEncoding);
+        values.push(value);
+        body += size;
+        if (body > payload.length)
+            break; // Truncated body: keep what parsed.
+    }
+    return { values, serialTypes };
+}
+function decodeSerial(payload, off, st, textEncoding) {
+    switch (st) {
+        case 0:
+            return [null, 0];
+        case 1:
+            return [signedInt(payload, off, 1), 1];
+        case 2:
+            return [signedInt(payload, off, 2), 2];
+        case 3:
+            return [signedInt(payload, off, 3), 3];
+        case 4:
+            return [signedInt(payload, off, 4), 4];
+        case 5:
+            return [signedInt(payload, off, 6), 6];
+        case 6:
+            return [signedInt(payload, off, 8), 8];
+        case 7:
+            return [readFloat64(payload, off), 8];
+        case 8:
+            return [0, 0];
+        case 9:
+            return [1, 0];
+        default: {
+            if (st < 12)
+                return [null, 0]; // 10, 11 are reserved.
+            const len = Math.floor((st - (st % 2 === 0 ? 12 : 13)) / 2);
+            const slice = payload.subarray(off, off + len);
+            if (st % 2 === 0)
+                return [slice.slice(), len]; // BLOB
+            return [decodeText(slice, textEncoding), len]; // TEXT
+        }
+    }
+}
+function signedInt(b, off, bytes) {
+    let v = 0n;
+    for (let i = 0; i < bytes; i++)
+        v = (v << 8n) | BigInt(b[off + i] ?? 0);
+    // Sign-extend from the top bit.
+    const bits = BigInt(bytes * 8);
+    if (v >= 1n << (bits - 1n))
+        v -= 1n << bits;
+    return toSafeInt(v);
+}
+function readFloat64(b, off) {
+    if (off + 8 > b.length)
+        return 0;
+    const view = new DataView(b.buffer, b.byteOffset + off, 8);
+    return view.getFloat64(0, false);
+}
+const utf8 = new TextDecoder('utf-8', { fatal: false });
+const utf16le = new TextDecoder('utf-16le', { fatal: false });
+const utf16be = new TextDecoder('utf-16be', { fatal: false });
+function decodeText(bytes, textEncoding) {
+    if (textEncoding === 2)
+        return utf16le.decode(bytes);
+    if (textEncoding === 3)
+        return utf16be.decode(bytes);
+    return utf8.decode(bytes);
+}
+//# sourceMappingURL=format.js.map

package/dist/sqlite/format.js.map

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

package/dist/sqlite/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * SQLite engine subpath export (`@intactfile/engines/sqlite`). Kept out of the
+ * root export so browser bundles that never touch SQLite never pull in the
+ * writer host; even here the writer engine (node:sqlite by default, or an
+ * injected sqlite-wasm builder) is only loaded on the first recoverSqlite call.
+ *
+ * The niche this fills: SQLite's `.recover` (reconstruct a corrupt database
+ * into a fresh one) has no client-side/browser implementation in the wild. The
+ * recovery brain here is a dependency-free TypeScript b-tree/page scanner, so
+ * it runs the same in Node and the browser.
+ */
+export { diagnoseSqlite } from './diagnose.js';
+export type { SqliteDiagnosis, SqliteDamageClass, DiagnoseSqliteOptions, } from './diagnose.js';
+export { recoverSqlite, recoverSqliteBytes } from './recover.js';
+export type { SqliteRecoveryReport, SqliteRecoveryOutcome, SqliteRecoveryStrategy, RecoveredTableReport, RecoverSqliteOptions, } from './recover.js';
+export { buildFreshDatabase, setSqliteBuilderLoader, resetSqliteHost, } from './sqlite-host.js';
+export type { SqliteBuilder, SqliteBuilderLoader, SqliteBuildSpec, SqliteBuildStatement, SqliteBuildResult, } from './sqlite-host.js';
+export { parseWal } from './wal.js';
+export type { WalOverlay } from './wal.js';
+export { SQLITE_MAGIC, parseHeader, parseBtreePageHeader, decodeRecord, readVarint, hasMagic, isValidPageSize, } from './format.js';
+export type { SqliteHeader, SqlValue, DecodedRecord, BtreePageHeader } from './format.js';
+export { PageReader, parseSchema, parseCreateTableColumns, walkTableBtree, rawScanLeafPages, } from './scan.js';
+export type { MasterEntry, RecoveredRow, OrphanRecord, TableColumns, TableWalkResult, } from './scan.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sqlite/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,YAAY,EACV,eAAe,EACf,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACjE,YAAY,EACV,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EACtB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,aAAa,EACb,mBAAmB,EACnB,eAAe,EACf,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAG3C,OAAO,EACL,YAAY,EACZ,WAAW,EACX,oBAAoB,EACpB,YAAY,EACZ,UAAU,EACV,QAAQ,EACR,eAAe,GAChB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE1F,OAAO,EACL,UAAU,EACV,WAAW,EACX,uBAAuB,EACvB,cAAc,EACd,gBAAgB,GACjB,MAAM,WAAW,CAAC;AACnB,YAAY,EACV,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,eAAe,GAChB,MAAM,WAAW,CAAC"}

package/dist/sqlite/index.js

@@ -0,0 +1,19 @@
+/**
+ * SQLite engine subpath export (`@intactfile/engines/sqlite`). Kept out of the
+ * root export so browser bundles that never touch SQLite never pull in the
+ * writer host; even here the writer engine (node:sqlite by default, or an
+ * injected sqlite-wasm builder) is only loaded on the first recoverSqlite call.
+ *
+ * The niche this fills: SQLite's `.recover` (reconstruct a corrupt database
+ * into a fresh one) has no client-side/browser implementation in the wild. The
+ * recovery brain here is a dependency-free TypeScript b-tree/page scanner, so
+ * it runs the same in Node and the browser.
+ */
+export { diagnoseSqlite } from './diagnose.js';
+export { recoverSqlite, recoverSqliteBytes } from './recover.js';
+export { buildFreshDatabase, setSqliteBuilderLoader, resetSqliteHost, } from './sqlite-host.js';
+export { parseWal } from './wal.js';
+// Low-level format + scan primitives (useful for tooling and tests).
+export { SQLITE_MAGIC, parseHeader, parseBtreePageHeader, decodeRecord, readVarint, hasMagic, isValidPageSize, } from './format.js';
+export { PageReader, parseSchema, parseCreateTableColumns, walkTableBtree, rawScanLeafPages, } from './scan.js';
+//# sourceMappingURL=index.js.map

package/dist/sqlite/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sqlite/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAO/C,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AASjE,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAS1B,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAGpC,qEAAqE;AACrE,OAAO,EACL,YAAY,EACZ,WAAW,EACX,oBAAoB,EACpB,YAAY,EACZ,UAAU,EACV,QAAQ,EACR,eAAe,GAChB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,UAAU,EACV,WAAW,EACX,uBAAuB,EACvB,cAAc,EACd,gBAAgB,GACjB,MAAM,WAAW,CAAC"}

package/dist/sqlite/recover.d.ts

@@ -0,0 +1,66 @@
+/**
+ * SQLite recovery: reconstruct as much data as possible from a damaged database
+ * into a brand-new, openable one. Mirrors the strategy of SQLite's own
+ * `.recover` shell command (walk raw pages, rebuild the schema, re-insert every
+ * decodable row, route the un-attributable rows to a lost_and_found table) but
+ * implemented as a dependency-free TypeScript page scanner (scan.ts) plus an
+ * injectable writer host (sqlite-host.ts).
+ *
+ * Honesty first (see docs/03): recovered output is never presented as pristine.
+ * SQLite's own guidance is that data pulled from a corrupt file is "always
+ * suspect"; truncated data that is physically gone is reported as lost, and
+ * anything reconstructed by the pointer-free scan is flagged as such.
+ */
+import type { ByteSource } from '../byte-source.js';
+import { type SqliteDamageClass } from './diagnose.js';
+export type SqliteRecoveryOutcome = 'success' | 'partial' | 'failed';
+export type SqliteRecoveryStrategy = 'btree-walk' | 'raw-page-scan' | 'dump-fallback' | null;
+export interface RecoveredTableReport {
+    name: string;
+    columns: number;
+    rowsRecovered: number;
+    /** Some/all rows came from the pointer-free raw scan (interior pages damaged). */
+    viaRawScan: boolean;
+    /** The b-tree walk reached every page it pointed at. */
+    complete: boolean;
+    /** Cells on intact pages that were too corrupted to decode. */
+    droppedCells: number;
+}
+export interface SqliteRecoveryReport {
+    outcome: SqliteRecoveryOutcome;
+    damageClass: SqliteDamageClass;
+    strategy: SqliteRecoveryStrategy;
+    tablesRecovered: number;
+    rowsRecovered: number;
+    /** Rows placed in lost_and_found because they matched no known table. */
+    orphanCount: number;
+    /** Rows dropped by the writer (constraint violations, e.g. duplicate rowids). */
+    rowsFailedInsert: number;
+    /** Cells that were present on intact pages but too corrupted to decode. */
+    cellsDropped: number;
+    tables: RecoveredTableReport[];
+    /** Honest, user-facing caveats about what recovery can and cannot promise. */
+    caveats: string[];
+    notes: string[];
+    walApplied: boolean;
+    bytesIn: number;
+    bytesOut: number;
+}
+export interface RecoverSqliteOptions {
+    /** Sibling `-wal` file. Its committed frames are overlaid before scanning. */
+    wal?: ByteSource | Uint8Array;
+}
+/**
+ * Recover a SQLite database into a fresh one. Returns the new database bytes
+ * (omitted only when nothing could be produced) and an honest report.
+ */
+export declare function recoverSqlite(src: ByteSource, opts?: RecoverSqliteOptions): Promise<{
+    db?: Uint8Array;
+    report: SqliteRecoveryReport;
+}>;
+/** Convenience wrapper for callers holding raw bytes. */
+export declare function recoverSqliteBytes(bytes: Uint8Array, opts?: RecoverSqliteOptions): Promise<{
+    db?: Uint8Array;
+    report: SqliteRecoveryReport;
+}>;
+//# sourceMappingURL=recover.d.ts.map

package/dist/sqlite/recover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recover.d.ts","sourceRoot":"","sources":["../../src/sqlite/recover.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,EAAkB,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAevE,MAAM,MAAM,qBAAqB,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;AACrE,MAAM,MAAM,sBAAsB,GAAG,YAAY,GAAG,eAAe,GAAG,eAAe,GAAG,IAAI,CAAC;AAE7F,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,kFAAkF;IAClF,UAAU,EAAE,OAAO,CAAC;IACpB,wDAAwD;IACxD,QAAQ,EAAE,OAAO,CAAC;IAClB,+DAA+D;IAC/D,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,qBAAqB,CAAC;IAC/B,WAAW,EAAE,iBAAiB,CAAC;IAC/B,QAAQ,EAAE,sBAAsB,CAAC;IACjC,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,yEAAyE;IACzE,WAAW,EAAE,MAAM,CAAC;IACpB,iFAAiF;IACjF,gBAAgB,EAAE,MAAM,CAAC;IACzB,2EAA2E;IAC3E,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAC/B,8EAA8E;IAC9E,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,8EAA8E;IAC9E,GAAG,CAAC,EAAE,UAAU,GAAG,UAAU,CAAC;CAC/B;AAeD;;;GAGG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,UAAU,EACf,IAAI,GAAE,oBAAyB,GAC9B,OAAO,CAAC;IAAE,EAAE,CAAC,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,oBAAoB,CAAA;CAAE,CAAC,CA6O5D;AAuFD,yDAAyD;AACzD,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,UAAU,EACjB,IAAI,CAAC,EAAE,oBAAoB,GAC1B,OAAO,CAAC;IAAE,EAAE,CAAC,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,oBAAoB,CAAA;CAAE,CAAC,CAE5D"}