@intactfile/engines 0.1.0

package/dist/sqlite/scan.js

@@ -0,0 +1,356 @@
+/**
+ * Raw b-tree / page scanner: the recovery brain. It reads a (possibly corrupt)
+ * database at the byte level and extracts rows two ways:
+ *
+ *  1. `walkTableBtree` follows a table's b-tree from its root page, the way a
+ *     healthy reader would — fast and exact when the pointers are intact.
+ *  2. `rawScanLeafPages` ignores all pointers and treats every table-leaf page
+ *     in the file as a bag of records. This is what SQLite's own `.recover`
+ *     does via the dbdata/dbptr virtual tables: it survives zeroed interior
+ *     pages, freelisted pages and dropped tables, at the cost of not knowing
+ *     which table a stray page belonged to.
+ *
+ * Pure and dependency-free: works identically in Node and the browser.
+ */
+import { PAGE_LEAF_TABLE, decodeRecord, parseBtreePageHeader, readCellPointers, readU32, readVarint, toSafeInt, } from './format.js';
+/** Random access to database pages, with an optional `-wal` overlay layered on top. */
+export class PageReader {
+    bytes;
+    overlay;
+    pageSize;
+    usableSize;
+    filePageCount;
+    constructor(bytes, pageSize, reservedBytes, overlay) {
+        this.bytes = bytes;
+        this.overlay = overlay;
+        this.pageSize = pageSize;
+        this.usableSize = pageSize - reservedBytes;
+        this.filePageCount = Math.floor(bytes.length / pageSize);
+    }
+    /** Highest page number reachable from the file or the WAL overlay. */
+    get maxPage() {
+        let m = this.filePageCount;
+        if (this.overlay)
+            for (const p of this.overlay.keys())
+                if (p > m)
+                    m = p;
+        return m;
+    }
+    /** Bytes of a page (1-based). The last page may be short after a truncation. */
+    page(pageNo) {
+        if (pageNo < 1)
+            return null;
+        const ov = this.overlay?.get(pageNo);
+        if (ov)
+            return ov;
+        const start = (pageNo - 1) * this.pageSize;
+        if (start >= this.bytes.length)
+            return null;
+        return this.bytes.subarray(start, Math.min(start + this.pageSize, this.bytes.length));
+    }
+}
+/**
+ * Walk a table b-tree from `rootpage`, collecting every decodable leaf row.
+ * Robust to loops (visited set), missing pages and bad subtrees: any failure
+ * degrades the walk to `complete: false` rather than throwing.
+ */
+export function walkTableBtree(reader, rootpage, textEncoding) {
+    const rows = [];
+    const visitedPages = new Set();
+    let complete = true;
+    let droppedCells = 0;
+    const visit = (pageNo) => {
+        if (pageNo < 1 || pageNo > reader.maxPage || visitedPages.has(pageNo)) {
+            if (pageNo >= 1)
+                complete = false;
+            return;
+        }
+        visitedPages.add(pageNo);
+        const page = reader.page(pageNo);
+        if (!page) {
+            complete = false;
+            return;
+        }
+        const hdr = parseBtreePageHeader(page, pageNo);
+        if (!hdr) {
+            complete = false;
+            return;
+        }
+        if (hdr.type === PAGE_LEAF_TABLE) {
+            const before = rows.length;
+            for (const row of readTableLeafCells(reader, page, hdr, textEncoding))
+                rows.push(row);
+            droppedCells += Math.max(0, hdr.cellCount - (rows.length - before));
+            return;
+        }
+        if (hdr.type === 0x05) {
+            // Interior table page: descend into every child then the rightmost.
+            const ptrs = readCellPointers(page, hdr);
+            for (const ptr of ptrs) {
+                const child = readU32(page, ptr);
+                visit(child);
+            }
+            if (hdr.rightMostPointer > 0)
+                visit(hdr.rightMostPointer);
+            return;
+        }
+        // Index pages carry no table rows; ignore for row recovery.
+    };
+    visit(rootpage);
+    return { rows, visitedPages, complete, droppedCells };
+}
+/** Decode every table-leaf cell on a page (following overflow chains). */
+function readTableLeafCells(reader, page, hdr, textEncoding) {
+    const rows = [];
+    for (const ptr of readCellPointers(page, hdr)) {
+        const cell = readTableLeafCell(reader, page, ptr, textEncoding);
+        if (cell)
+            rows.push(cell);
+    }
+    return rows;
+}
+/**
+ * Read a single table-leaf cell at `ptr`: varint payload length, varint rowid,
+ * then the record payload (local bytes plus any overflow-page chain). Returns
+ * null on any structural inconsistency so a single bad cell never aborts a page.
+ */
+function readTableLeafCell(reader, page, ptr, textEncoding) {
+    const payloadLenV = readVarint(page, ptr);
+    if (payloadLenV.length === 0)
+        return null;
+    const payloadLength = Number(payloadLenV.value);
+    if (payloadLength <= 0 || payloadLength > 1 << 30)
+        return null;
+    const rowidV = readVarint(page, ptr + payloadLenV.length);
+    if (rowidV.length === 0)
+        return null;
+    const rowid = toSafeInt(rowidV.value);
+    const headerBytes = payloadLenV.length + rowidV.length;
+    const U = reader.usableSize;
+    const X = U - 35; // Max local payload for a table leaf.
+    const dataStart = ptr + headerBytes;
+    let payload;
+    if (payloadLength <= X) {
+        payload = page.subarray(dataStart, dataStart + payloadLength);
+    }
+    else {
+        // Spilled record: local portion + 4-byte first-overflow pointer.
+        const M = Math.floor(((U - 12) * 32) / 255) - 23;
+        let localSize = M + ((payloadLength - M) % (U - 4));
+        if (localSize > X)
+            localSize = M;
+        const local = page.subarray(dataStart, dataStart + localSize);
+        const firstOverflow = readU32(page, dataStart + localSize);
+        payload = assembleOverflow(reader, local, firstOverflow, payloadLength);
+    }
+    const record = decodeRecord(payload, textEncoding);
+    if (!record)
+        return null;
+    return { rowid, values: record.values };
+}
+/** Follow an overflow-page chain, appending each page's payload after `local`. */
+function assembleOverflow(reader, local, firstOverflow, payloadLength) {
+    const parts = [local.slice()];
+    let total = local.length;
+    let next = firstOverflow;
+    const seen = new Set();
+    while (next > 0 && total < payloadLength && !seen.has(next)) {
+        seen.add(next);
+        const page = reader.page(next);
+        if (!page || page.length < 4)
+            break;
+        next = readU32(page, 0);
+        const chunk = page.subarray(4, Math.min(page.length, 4 + (payloadLength - total)));
+        parts.push(chunk.slice());
+        total += chunk.length;
+    }
+    const out = new Uint8Array(total);
+    let o = 0;
+    for (const part of parts) {
+        out.set(part, o);
+        o += part.length;
+    }
+    return out;
+}
+/**
+ * Pointer-free sweep: every table-leaf page in the file (except `skip`) is read
+ * as an independent bag of records. This is how rows survive a zeroed interior
+ * page or a dropped table. Records here are un-attributed — the caller decides
+ * whether a shape matches a known table or must land in lost_and_found.
+ */
+export function rawScanLeafPages(reader, textEncoding, skip) {
+    const out = [];
+    const maxPage = reader.maxPage;
+    for (let pageNo = 1; pageNo <= maxPage; pageNo++) {
+        if (skip.has(pageNo))
+            continue;
+        const page = reader.page(pageNo);
+        if (!page)
+            continue;
+        const hdr = parseBtreePageHeader(page, pageNo);
+        if (!hdr || hdr.type !== PAGE_LEAF_TABLE)
+            continue;
+        const ptrs = readCellPointers(page, hdr);
+        ptrs.forEach((ptr, cellIndex) => {
+            const cell = readOrphanCell(reader, page, ptr, textEncoding);
+            if (cell)
+                out.push({ pageNo, cellIndex, ...cell });
+        });
+    }
+    return out;
+}
+function readOrphanCell(reader, page, ptr, textEncoding) {
+    const payloadLenV = readVarint(page, ptr);
+    if (payloadLenV.length === 0)
+        return null;
+    const payloadLength = Number(payloadLenV.value);
+    if (payloadLength <= 0 || payloadLength > 1 << 30)
+        return null;
+    const rowidV = readVarint(page, ptr + payloadLenV.length);
+    if (rowidV.length === 0)
+        return null;
+    const U = reader.usableSize;
+    const X = U - 35;
+    const dataStart = ptr + payloadLenV.length + rowidV.length;
+    let payload;
+    if (payloadLength <= X) {
+        payload = page.subarray(dataStart, dataStart + payloadLength);
+    }
+    else {
+        const M = Math.floor(((U - 12) * 32) / 255) - 23;
+        let localSize = M + ((payloadLength - M) % (U - 4));
+        if (localSize > X)
+            localSize = M;
+        const local = page.subarray(dataStart, dataStart + localSize);
+        payload = assembleOverflow(reader, local, readU32(page, dataStart + localSize), payloadLength);
+    }
+    const record = decodeRecord(payload, textEncoding);
+    if (!record || record.values.length === 0)
+        return null;
+    return { rowid: toSafeInt(rowidV.value), values: record.values, serialTypes: record.serialTypes };
+}
+/**
+ * Read the schema table (`sqlite_master`, rooted at page 1). Each row is
+ * (type, name, tbl_name, rootpage, sql). Failure to walk page 1 yields ok:false
+ * so the caller can fall back to a pure raw scan.
+ */
+export function parseSchema(reader, textEncoding) {
+    const notes = [];
+    const walk = walkTableBtree(reader, 1, textEncoding);
+    if (walk.rows.length === 0 && !walk.complete) {
+        notes.push('schema page (page 1) could not be walked; falling back to a raw page scan');
+        return { entries: [], ok: false, schemaPages: walk.visitedPages, notes };
+    }
+    const entries = [];
+    for (const row of walk.rows) {
+        const [type, name, tblName, rootpage, sql] = row.values;
+        if (typeof type !== 'string' || typeof name !== 'string')
+            continue;
+        entries.push({
+            type,
+            name,
+            tblName: typeof tblName === 'string' ? tblName : name,
+            rootpage: typeof rootpage === 'number' ? rootpage : Number(rootpage ?? 0),
+            sql: typeof sql === 'string' ? sql : '',
+        });
+    }
+    if (entries.length === 0)
+        notes.push('schema table parsed but held no usable entries');
+    return { entries, ok: entries.length > 0, schemaPages: walk.visitedPages, notes };
+}
+/**
+ * Light CREATE TABLE column parser for the common case: pulls column names from
+ * the top-level column list and flags an INTEGER PRIMARY KEY rowid alias.
+ * Exotic DDL (generated columns, unusual quoting) may not parse — recovery
+ * degrades to lost_and_found rather than guessing, and says so.
+ */
+export function parseCreateTableColumns(sql) {
+    const open = sql.indexOf('(');
+    if (open === -1)
+        return null;
+    // Find the matching close paren for the top-level column list.
+    let depth = 0;
+    let close = -1;
+    let inStr = null;
+    for (let i = open; i < sql.length; i++) {
+        const ch = sql[i];
+        if (inStr) {
+            if (ch === inStr)
+                inStr = null;
+            continue;
+        }
+        if (ch === '"' || ch === "'" || ch === '`')
+            inStr = ch;
+        else if (ch === '(')
+            depth++;
+        else if (ch === ')') {
+            depth--;
+            if (depth === 0) {
+                close = i;
+                break;
+            }
+        }
+    }
+    if (close === -1)
+        return null;
+    const inner = sql.slice(open + 1, close);
+    const parts = splitTopLevel(inner);
+    const columns = [];
+    let ipkColumn = null;
+    const constraintKeywords = /^(PRIMARY|UNIQUE|CHECK|FOREIGN|CONSTRAINT)\b/i;
+    for (const raw of parts) {
+        const part = raw.trim();
+        if (part === '' || constraintKeywords.test(part))
+            continue;
+        const name = firstIdentifier(part);
+        if (name === null)
+            continue;
+        if (/\bINTEGER\s+PRIMARY\s+KEY\b/i.test(part))
+            ipkColumn = columns.length;
+        columns.push(name);
+    }
+    if (columns.length === 0)
+        return null;
+    return { columns, ipkColumn };
+}
+function splitTopLevel(s) {
+    const out = [];
+    let depth = 0;
+    let inStr = null;
+    let start = 0;
+    for (let i = 0; i < s.length; i++) {
+        const ch = s[i];
+        if (inStr) {
+            if (ch === inStr)
+                inStr = null;
+            continue;
+        }
+        if (ch === '"' || ch === "'" || ch === '`')
+            inStr = ch;
+        else if (ch === '(')
+            depth++;
+        else if (ch === ')')
+            depth--;
+        else if (ch === ',' && depth === 0) {
+            out.push(s.slice(start, i));
+            start = i + 1;
+        }
+    }
+    out.push(s.slice(start));
+    return out;
+}
+function firstIdentifier(part) {
+    const s = part.trimStart();
+    const quote = s[0];
+    if (quote === '"' || quote === '`') {
+        const end = s.indexOf(quote, 1);
+        return end === -1 ? null : s.slice(1, end);
+    }
+    if (quote === '[') {
+        const end = s.indexOf(']', 1);
+        return end === -1 ? null : s.slice(1, end);
+    }
+    const m = /^[A-Za-z_][A-Za-z0-9_$]*/.exec(s);
+    return m ? m[0] : null;
+}
+//# sourceMappingURL=scan.js.map

package/dist/sqlite/scan.js.map

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

package/dist/sqlite/sqlite-host.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Isolated, injectable host for building the *fresh* output database. Recovery
+ * itself is pure TypeScript (see scan.ts); this host is only the writer that
+ * serializes recovered rows into a real, openable SQLite file.
+ *
+ * Loading is injectable, exactly like the qpdf host: in Node the default loader
+ * uses the built-in `node:sqlite` module (real SQLite, byte-faithful output);
+ * a browser host calls setSqliteBuilderLoader() with a sqlite-wasm-backed
+ * builder before recovering. Nothing else in the package imports node:sqlite,
+ * and it is only loaded on first use, so browser bundles stay clean.
+ */
+import type { SqlValue } from './format.js';
+export interface SqliteBuildStatement {
+    /** A single SQL statement. With `rows`, it is a parameterized INSERT run once per row. */
+    sql: string;
+    /** Positional parameter rows for a prepared statement. */
+    rows?: SqlValue[][];
+}
+export interface SqliteBuildSpec {
+    statements: SqliteBuildStatement[];
+}
+export interface SqliteBuildResult {
+    bytes: Uint8Array;
+    rowsInserted: number;
+    rowsFailed: number;
+}
+export interface SqliteBuilder {
+    build(spec: SqliteBuildSpec): Promise<SqliteBuildResult>;
+}
+export type SqliteBuilderLoader = () => Promise<SqliteBuilder>;
+/** Inject how the fresh-database builder is obtained (browser hosts / tests). */
+export declare function setSqliteBuilderLoader(load: SqliteBuilderLoader): void;
+/** Drop the cached builder (tests). */
+export declare function resetSqliteHost(): void;
+/** Build a fresh database from DDL + row inserts, returning its serialized bytes. */
+export declare function buildFreshDatabase(spec: SqliteBuildSpec): Promise<SqliteBuildResult>;
+//# sourceMappingURL=sqlite-host.d.ts.map

package/dist/sqlite/sqlite-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-host.d.ts","sourceRoot":"","sources":["../../src/sqlite/sqlite-host.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,WAAW,oBAAoB;IACnC,0FAA0F;IAC1F,GAAG,EAAE,MAAM,CAAC;IACZ,0DAA0D;IAC1D,IAAI,CAAC,EAAE,QAAQ,EAAE,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,oBAAoB,EAAE,CAAC;CACpC;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,UAAU,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC1D;AAED,MAAM,MAAM,mBAAmB,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC,CAAC;AAK/D,iFAAiF;AACjF,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,mBAAmB,GAAG,IAAI,CAGtE;AAED,uCAAuC;AACvC,wBAAgB,eAAe,IAAI,IAAI,CAEtC;AAED,qFAAqF;AACrF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAMpF"}

package/dist/sqlite/sqlite-host.js

@@ -0,0 +1,80 @@
+let loaderOverride = null;
+let loaderPromise = null;
+/** Inject how the fresh-database builder is obtained (browser hosts / tests). */
+export function setSqliteBuilderLoader(load) {
+    loaderOverride = load;
+    loaderPromise = null;
+}
+/** Drop the cached builder (tests). */
+export function resetSqliteHost() {
+    loaderPromise = null;
+}
+/** Build a fresh database from DDL + row inserts, returning its serialized bytes. */
+export function buildFreshDatabase(spec) {
+    loaderPromise ??= (loaderOverride ?? defaultNodeLoader)().catch((e) => {
+        loaderPromise = null;
+        throw e;
+    });
+    return loaderPromise.then((builder) => builder.build(spec));
+}
+let tmpCounter = 0;
+async function defaultNodeLoader() {
+    const isNode = typeof process !== 'undefined' && !!process.versions?.node;
+    if (!isNode) {
+        throw new Error('sqlite host: no builder configured. In the browser, call setSqliteBuilderLoader() with a sqlite-wasm builder before recovering databases.');
+    }
+    const [{ DatabaseSync }, { tmpdir }, { join }, fs] = await Promise.all([
+        import('node:sqlite'),
+        import('node:os'),
+        import('node:path'),
+        import('node:fs'),
+    ]);
+    return {
+        async build(spec) {
+            const path = join(tmpdir(), `intactfile-recover-${process.pid}-${Date.now()}-${tmpCounter++}.db`);
+            cleanup(fs, path);
+            const db = new DatabaseSync(path);
+            let rowsInserted = 0;
+            let rowsFailed = 0;
+            try {
+                db.exec('PRAGMA journal_mode = MEMORY');
+                db.exec('BEGIN');
+                for (const stmt of spec.statements) {
+                    if (stmt.rows === undefined) {
+                        db.exec(stmt.sql);
+                        continue;
+                    }
+                    const prepared = db.prepare(stmt.sql);
+                    const run = prepared.run.bind(prepared);
+                    for (const row of stmt.rows) {
+                        try {
+                            run(...row);
+                            rowsInserted++;
+                        }
+                        catch {
+                            rowsFailed++;
+                        }
+                    }
+                }
+                db.exec('COMMIT');
+            }
+            finally {
+                db.close();
+            }
+            const bytes = new Uint8Array(fs.readFileSync(path));
+            cleanup(fs, path);
+            return { bytes, rowsInserted, rowsFailed };
+        },
+    };
+}
+function cleanup(fs, path) {
+    for (const suffix of ['', '-wal', '-journal', '-shm']) {
+        try {
+            fs.unlinkSync(path + suffix);
+        }
+        catch {
+            // Not present; nothing to remove.
+        }
+    }
+}
+//# sourceMappingURL=sqlite-host.js.map

package/dist/sqlite/sqlite-host.js.map

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

package/dist/sqlite/wal.d.ts

@@ -0,0 +1,14 @@
+export interface WalOverlay {
+    valid: boolean;
+    pageSize: number;
+    /** Page number -> latest committed page image. */
+    pages: Map<number, Uint8Array>;
+    /** db size in pages recorded by the last commit frame, or 0. */
+    committedPageCount: number;
+    /** Count of committed frames applied. */
+    framesApplied: number;
+    notes: string[];
+}
+/** Parse a `-wal` sidecar into an overlay of committed page images. */
+export declare function parseWal(wal: Uint8Array): WalOverlay;
+//# sourceMappingURL=wal.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"wal.d.ts","sourceRoot":"","sources":["../../src/sqlite/wal.ts"],"names":[],"mappings":"AAmBA,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC/B,gEAAgE;IAChE,kBAAkB,EAAE,MAAM,CAAC;IAC3B,yCAAyC;IACzC,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,uEAAuE;AACvE,wBAAgB,QAAQ,CAAC,GAAG,EAAE,UAAU,GAAG,UAAU,CAkEpD"}

package/dist/sqlite/wal.js

@@ -0,0 +1,79 @@
+/**
+ * Minimal write-ahead log (`-wal`) overlay. When a database is copied while a
+ * checkpoint was pending, the newest committed page images live in the sidecar
+ * `-wal` file, not the main database. Recovery reads better when those frames
+ * are layered on top of the base pages first.
+ *
+ * Format reference: https://sqlite.org/fileformat2.html#the_write_ahead_log
+ * Frames whose salts do not match the WAL header are stale (from an earlier
+ * checkpoint generation) and ignored. Only frames up to and including the last
+ * commit frame are applied. Frame checksums are not verified — recovery is
+ * deliberately permissive and records that in its notes.
+ */
+import { readU32 } from './format.js';
+const WAL_MAGIC_LE = 0x377f0682;
+const WAL_MAGIC_BE = 0x377f0683;
+const WAL_HEADER_SIZE = 32;
+const FRAME_HEADER_SIZE = 24;
+/** Parse a `-wal` sidecar into an overlay of committed page images. */
+export function parseWal(wal) {
+    const notes = [];
+    const empty = {
+        valid: false,
+        pageSize: 0,
+        pages: new Map(),
+        committedPageCount: 0,
+        framesApplied: 0,
+        notes,
+    };
+    if (wal.length < WAL_HEADER_SIZE) {
+        notes.push('-wal sidecar is too small to contain a header');
+        return empty;
+    }
+    const magic = readU32(wal, 0);
+    if (magic !== WAL_MAGIC_LE && magic !== WAL_MAGIC_BE) {
+        notes.push('-wal sidecar has an unrecognized magic; ignored');
+        return empty;
+    }
+    const pageSize = readU32(wal, 8);
+    if (pageSize < 512 || (pageSize & (pageSize - 1)) !== 0) {
+        notes.push('-wal sidecar declares an implausible page size; ignored');
+        return empty;
+    }
+    const salt1 = readU32(wal, 16);
+    const salt2 = readU32(wal, 20);
+    const frameStride = FRAME_HEADER_SIZE + pageSize;
+    const frames = [];
+    let lastCommit = -1;
+    let committedPageCount = 0;
+    for (let off = WAL_HEADER_SIZE; off + frameStride <= wal.length; off += frameStride) {
+        const fSalt1 = readU32(wal, off + 8);
+        const fSalt2 = readU32(wal, off + 12);
+        if (fSalt1 !== salt1 || fSalt2 !== salt2)
+            continue; // Stale generation.
+        const pageNo = readU32(wal, off + 0);
+        const dbSize = readU32(wal, off + 4);
+        const data = wal.subarray(off + FRAME_HEADER_SIZE, off + frameStride).slice();
+        frames.push({ pageNo, data, isCommit: dbSize !== 0 });
+        if (dbSize !== 0) {
+            lastCommit = frames.length - 1;
+            committedPageCount = dbSize;
+        }
+    }
+    const pages = new Map();
+    let framesApplied = 0;
+    for (let i = 0; i <= lastCommit; i++) {
+        const f = frames[i];
+        if (!f)
+            continue;
+        pages.set(f.pageNo, f.data);
+        framesApplied++;
+    }
+    if (lastCommit === -1) {
+        notes.push('-wal sidecar has no committed frames; nothing to overlay');
+        return { ...empty, pageSize, valid: true };
+    }
+    notes.push(`-wal overlay applied: ${pages.size} page(s) from ${framesApplied} committed frame(s)`);
+    return { valid: true, pageSize, pages, committedPageCount, framesApplied, notes };
+}
+//# sourceMappingURL=wal.js.map

package/dist/sqlite/wal.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,2 @@
+export type Confidence = 'high' | 'medium' | 'low';
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}