@minnowdb/core 0.0.1 → 0.1.0

package/dist/storage/fixture-shape.d.ts

@@ -0,0 +1,42 @@
+/**
+ * The database every compatibility fixture holds, and the questions asked of it.
+ *
+ * Shared by the generator (scripts/write-format-fixture.mts) and the test that reads the
+ * fixtures back, so the two cannot drift: a fixture written today and a fixture written in two
+ * years describe the same database, and any difference in the answers is a difference in the
+ * engine rather than in what was asked.
+ *
+ * The shape is chosen to touch every part of the persisted format that a change could break,
+ * because a fixture only protects what it happens to contain:
+ *
+ *   - every column type, and a nullable column of each that actually holds nulls
+ *   - a low-cardinality string column, which encodes through the dictionary, alongside a
+ *     high-cardinality one that cannot
+ *   - a column of near-identical text, which compresses, beside random text that does not, so
+ *     both codec paths appear in the blocks
+ *   - enough rows to span several blocks per column, so multi-block columns and their zone maps
+ *     are covered rather than a single degenerate block
+ *   - a mutation history: updates and deletes leave delta segments, which are a different
+ *     segment kind with a different block layout from a plain append
+ *   - both a string and a numeric unique key, since key encoding differs between them
+ *   - a table with no unique key at all, which stores no key column
+ *
+ * Adding to this shape is safe and welcome. Removing from it silently narrows what every future
+ * fixture proves, so treat a deletion here as a decision to stop protecting that surface.
+ */
+import type { MinnowDatabase } from "../engine/database.js";
+/**
+ * Builds the fixture database. The caller supplies the database so the generator and the test
+ * can each choose their own store; nothing here depends on which.
+ */
+export declare function buildFixtureDatabase(database: MinnowDatabase): Promise<void>;
+/**
+ * What every fixture is asked. Ordered so the answers are stable, and chosen to read each part
+ * of the shape above back out: every type, both codecs, the dictionary, the deltas, both key
+ * kinds, and the keyless table.
+ *
+ * Only ever append here. Changing an existing query changes the question every historical
+ * fixture is answering, and the recorded answer no longer means what it meant.
+ */
+export declare const FIXTURE_QUERIES: readonly string[];
+//# sourceMappingURL=fixture-shape.d.ts.map

package/dist/storage/fixture-shape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixture-shape.d.ts","sourceRoot":"","sources":["../../src/storage/fixture-shape.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAkC5D;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAgFlF;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,EAAE,SAAS,MAAM,EAoC5C,CAAC"}

package/dist/storage/fixture-shape.js

@@ -0,0 +1,146 @@
+/** Deterministic pseudo-randomness, so a regenerated fixture differs only when the format does. */
+function mulberry32(seed) {
+    let state = seed >>> 0;
+    return () => {
+        state = (state + 0x6d2b79f5) >>> 0;
+        let mixed = state;
+        mixed = Math.imul(mixed ^ (mixed >>> 15), mixed | 1);
+        mixed ^= mixed + Math.imul(mixed ^ (mixed >>> 7), mixed | 61);
+        return ((mixed ^ (mixed >>> 14)) >>> 0) / 4294967296;
+    };
+}
+const REGIONS = ["west", "east", "north", "south"];
+const LETTERS = "abcdefghijklmnopqrstuvwxyz";
+/** Text with almost no entropy, which the compressing codec will take. */
+function compressible(index) {
+    return `the quick brown fox jumps over the lazy dog ${String(index % 3)}`;
+}
+/** Text with high entropy, which it will not. */
+function incompressible(random) {
+    let out = "";
+    for (let index = 0; index < 24; index += 1) {
+        out += LETTERS[Math.floor(random() * LETTERS.length)] ?? "a";
+    }
+    return out;
+}
+/** Rows enough to span several blocks at the small block size the generator uses. */
+const ROWS = 400;
+/**
+ * Builds the fixture database. The caller supplies the database so the generator and the test
+ * can each choose their own store; nothing here depends on which.
+ */
+export async function buildFixtureDatabase(database) {
+    const random = mulberry32(0x0f1a7);
+    await database.createTable({
+        name: "records",
+        uniqueKey: "id",
+        columns: [
+            { name: "id", type: "number" },
+            { name: "region", type: "string" },
+            { name: "note", type: "string" },
+            { name: "noise", type: "string" },
+            { name: "amount", type: "number" },
+            { name: "active", type: "boolean" },
+            { name: "seen_at", type: "datetime" },
+            { name: "maybe_text", type: "string", nullable: true },
+            { name: "maybe_number", type: "number", nullable: true },
+            { name: "maybe_flag", type: "boolean", nullable: true },
+            { name: "maybe_time", type: "datetime", nullable: true },
+        ],
+    });
+    await database.insertBatch("records", Array.from({ length: ROWS }, (_, index) => ({
+        id: index + 1,
+        region: REGIONS[index % REGIONS.length] ?? "west",
+        note: compressible(index),
+        noise: incompressible(random),
+        // Quarters stay exact in doubles, so a rounding change shows up as a difference rather
+        // than as noise nobody can attribute.
+        amount: Math.floor(random() * 400) / 4,
+        active: index % 3 === 0,
+        seen_at: new Date(Date.UTC(2026, 0, 1 + (index % 28), index % 24, 0, 0)),
+        maybe_text: index % 5 === 0 ? null : `t${String(index)}`,
+        maybe_number: index % 7 === 0 ? null : index * 2,
+        maybe_flag: index % 11 === 0 ? null : index % 2 === 0,
+        maybe_time: index % 13 === 0 ? null : new Date(Date.UTC(2025, 5, 1 + (index % 27))),
+    })));
+    // A string unique key, which encodes differently from a numeric one.
+    await database.createTable({
+        name: "keyed_by_name",
+        uniqueKey: "name",
+        columns: [
+            { name: "name", type: "string" },
+            { name: "score", type: "number" },
+        ],
+    });
+    await database.insertBatch("keyed_by_name", Array.from({ length: 120 }, (_, index) => ({
+        name: `name-${String(index).padStart(4, "0")}`,
+        score: index % 50,
+    })));
+    // No unique key at all: this table stores no key column, which is its own layout.
+    await database.createTable({
+        name: "keyless",
+        columns: [
+            { name: "label", type: "string" },
+            { name: "value", type: "number" },
+        ],
+    });
+    await database.insertBatch("keyless", Array.from({ length: 90 }, (_, index) => ({
+        label: REGIONS[index % REGIONS.length] ?? "west",
+        value: index,
+    })));
+    // The mutation history. Updates and deletes write delta segments, whose layout differs from an
+    // append -- and a fixture with only appends would prove nothing about reading them back.
+    await database.execute("UPDATE records SET amount = ? WHERE id = ?", [1234.5, 3]);
+    await database.execute("UPDATE records SET maybe_text = ? WHERE id = ?", [null, 4]);
+    await database.execute("UPDATE records SET region = ? WHERE id = ?", ["central", 5]);
+    await database.execute("DELETE FROM records WHERE id = ?", [6]);
+    await database.execute("DELETE FROM records WHERE id > ?", [396]);
+    await database.execute("UPDATE keyed_by_name SET score = ? WHERE name = ?", [999, "name-0007"]);
+    await database.execute("DELETE FROM keyed_by_name WHERE name = ?", ["name-0008"]);
+}
+/**
+ * What every fixture is asked. Ordered so the answers are stable, and chosen to read each part
+ * of the shape above back out: every type, both codecs, the dictionary, the deltas, both key
+ * kinds, and the keyless table.
+ *
+ * Only ever append here. Changing an existing query changes the question every historical
+ * fixture is answering, and the recorded answer no longer means what it meant.
+ */
+export const FIXTURE_QUERIES = [
+    "SELECT COUNT(*) AS n FROM records",
+    "SELECT COUNT(*) AS n FROM keyed_by_name",
+    "SELECT COUNT(*) AS n FROM keyless",
+    // Every column of one row, after the updates that touched its neighbours.
+    "SELECT * FROM records WHERE id = 1",
+    // The updated rows, which live in delta segments rather than the base.
+    "SELECT id, amount FROM records WHERE id = 3",
+    "SELECT id, maybe_text FROM records WHERE id = 4",
+    "SELECT id, region FROM records WHERE id = 5",
+    // The deleted rows must be gone, both the single and the ranged delete.
+    "SELECT id FROM records WHERE id IN (6, 397, 398, 399, 400) ORDER BY id",
+    // Nullability across every type, counted rather than listed so the answer stays small.
+    "SELECT COUNT(*) AS n FROM records WHERE maybe_text IS NULL",
+    "SELECT COUNT(*) AS n FROM records WHERE maybe_number IS NULL",
+    "SELECT COUNT(*) AS n FROM records WHERE maybe_flag IS NULL",
+    "SELECT COUNT(*) AS n FROM records WHERE maybe_time IS NULL",
+    // The dictionary-coded column, and an aggregate that has to decode every value of it.
+    "SELECT region, COUNT(*) AS n FROM records GROUP BY region ORDER BY region",
+    // Both text columns, which took different codecs.
+    "SELECT note FROM records WHERE id = 42",
+    "SELECT noise FROM records WHERE id = 42",
+    // Numeric and datetime round-trips, including the boundary rows of the range.
+    "SELECT SUM(amount) AS total, MIN(amount) AS low, MAX(amount) AS high FROM records",
+    "SELECT MIN(seen_at) AS first, MAX(seen_at) AS last FROM records",
+    "SELECT COUNT(*) AS n FROM records WHERE active",
+    // A scan that spans blocks rather than resolving inside one.
+    "SELECT id FROM records WHERE amount > 90 ORDER BY id LIMIT 10",
+    // The string key, updated and deleted through.
+    "SELECT name, score FROM keyed_by_name WHERE name = 'name-0007'",
+    "SELECT name FROM keyed_by_name WHERE name = 'name-0008'",
+    "SELECT name, score FROM keyed_by_name ORDER BY name LIMIT 3",
+    // The keyless table, which stores no key column.
+    "SELECT label, SUM(value) AS total FROM keyless GROUP BY label ORDER BY label",
+    // A join, which reads two layouts at once.
+    "SELECT r.region, COUNT(*) AS n FROM records r JOIN keyless k ON r.region = k.label GROUP BY r.region ORDER BY r.region",
+];
+//# sourceMappingURL=fixture-shape.js.map

package/dist/storage/fixture-shape.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixture-shape.js","sourceRoot":"","sources":["../../src/storage/fixture-shape.ts"],"names":[],"mappings":"AA4BA,mGAAmG;AACnG,SAAS,UAAU,CAAC,IAAY;IAC9B,IAAI,KAAK,GAAG,IAAI,KAAK,CAAC,CAAC;IACvB,OAAO,GAAG,EAAE;QACV,KAAK,GAAG,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;QACnC,IAAI,KAAK,GAAG,KAAK,CAAC;QAClB,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,KAAK,KAAK,EAAE,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QACrD,KAAK,IAAI,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,KAAK,KAAK,CAAC,CAAC,EAAE,KAAK,GAAG,EAAE,CAAC,CAAC;QAC9D,OAAO,CAAC,CAAC,KAAK,GAAG,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,UAAU,CAAC;IACvD,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,OAAO,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAU,CAAC;AAC5D,MAAM,OAAO,GAAG,4BAA4B,CAAC;AAE7C,0EAA0E;AAC1E,SAAS,YAAY,CAAC,KAAa;IACjC,OAAO,+CAA+C,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,EAAE,CAAC;AAC5E,CAAC;AAED,iDAAiD;AACjD,SAAS,cAAc,CAAC,MAAoB;IAC1C,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,EAAE,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC3C,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,GAAG,CAAC;IAC/D,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,qFAAqF;AACrF,MAAM,IAAI,GAAG,GAAG,CAAC;AAEjB;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,QAAwB;IACjE,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IACnC,MAAM,QAAQ,CAAC,WAAW,CAAC;QACzB,IAAI,EAAE,SAAS;QACf,SAAS,EAAE,IAAI;QACf,OAAO,EAAE;YACP,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC9B,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE;YAClC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE;YAChC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE;YACjC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE;YAClC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE;YACnC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE;YACrC,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;YACtD,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;YACxD,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE;YACvD,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE;SACzD;KACF,CAAC,CAAC;IACH,MAAM,QAAQ,CAAC,WAAW,CACxB,SAAS,EACT,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QAC1C,EAAE,EAAE,KAAK,GAAG,CAAC;QACb,MAAM,EAAE,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,MAAM;QACjD,IAAI,EAAE,YAAY,CAAC,KAAK,CAAC;QACzB,KAAK,EAAE,cAAc,CAAC,MAAM,CAAC;QAC7B,uFAAuF;QACvF,sCAAsC;QACtC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,GAAG,CAAC;QACtC,MAAM,EAAE,KAAK,GAAG,CAAC,KAAK,CAAC;QACvB,OAAO,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,KAAK,GAAG,EAAE,CAAC,EAAE,KAAK,GAAG,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QACxE,UAAU,EAAE,KAAK,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE;QACxD,YAAY,EAAE,KAAK,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC;QAChD,UAAU,EAAE,KAAK,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,KAAK,CAAC;QACrD,UAAU,EAAE,KAAK,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC,CAAC;KACpF,CAAC,CAAC,CACJ,CAAC;IAEF,qEAAqE;IACrE,MAAM,QAAQ,CAAC,WAAW,CAAC;QACzB,IAAI,EAAE,eAAe;QACrB,SAAS,EAAE,MAAM;QACjB,OAAO,EAAE;YACP,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE;YAChC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE;SAClC;KACF,CAAC,CAAC;IACH,MAAM,QAAQ,CAAC,WAAW,CACxB,eAAe,EACf,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QACzC,IAAI,EAAE,QAAQ,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE;QAC9C,KAAK,EAAE,KAAK,GAAG,EAAE;KAClB,CAAC,CAAC,CACJ,CAAC;IAEF,kFAAkF;IAClF,MAAM,QAAQ,CAAC,WAAW,CAAC;QACzB,IAAI,EAAE,SAAS;QACf,OAAO,EAAE;YACP,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE;YACjC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE;SAClC;KACF,CAAC,CAAC;IACH,MAAM,QAAQ,CAAC,WAAW,CACxB,SAAS,EACT,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QACxC,KAAK,EAAE,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,MAAM;QAChD,KAAK,EAAE,KAAK;KACb,CAAC,CAAC,CACJ,CAAC;IAEF,+FAA+F;IAC/F,yFAAyF;IACzF,MAAM,QAAQ,CAAC,OAAO,CAAC,4CAA4C,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;IAClF,MAAM,QAAQ,CAAC,OAAO,CAAC,gDAAgD,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACpF,MAAM,QAAQ,CAAC,OAAO,CAAC,4CAA4C,EAAE,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC;IACrF,MAAM,QAAQ,CAAC,OAAO,CAAC,kCAAkC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAChE,MAAM,QAAQ,CAAC,OAAO,CAAC,kCAAkC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAClE,MAAM,QAAQ,CAAC,OAAO,CAAC,mDAAmD,EAAE,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC;IAChG,MAAM,QAAQ,CAAC,OAAO,CAAC,0CAA0C,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC;AACpF,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,eAAe,GAAsB;IAChD,mCAAmC;IACnC,yCAAyC;IACzC,mCAAmC;IACnC,0EAA0E;IAC1E,oCAAoC;IACpC,uEAAuE;IACvE,6CAA6C;IAC7C,iDAAiD;IACjD,6CAA6C;IAC7C,wEAAwE;IACxE,wEAAwE;IACxE,uFAAuF;IACvF,4DAA4D;IAC5D,8DAA8D;IAC9D,4DAA4D;IAC5D,4DAA4D;IAC5D,sFAAsF;IACtF,2EAA2E;IAC3E,kDAAkD;IAClD,wCAAwC;IACxC,yCAAyC;IACzC,8EAA8E;IAC9E,mFAAmF;IACnF,iEAAiE;IACjE,gDAAgD;IAChD,6DAA6D;IAC7D,+DAA+D;IAC/D,+CAA+C;IAC/C,gEAAgE;IAChE,yDAAyD;IACzD,6DAA6D;IAC7D,iDAAiD;IACjD,8EAA8E;IAC9E,2CAA2C;IAC3C,wHAAwH;CACzH,CAAC"}

package/dist/storage/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./indexeddb.js";
+export * from "./memory.js";
+export * from "./snapshot.js";
+export * from "./types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC"}

package/dist/storage/index.js

@@ -0,0 +1,5 @@
+export * from "./indexeddb.js";
+export * from "./memory.js";
+export * from "./snapshot.js";
+export * from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/storage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC"}

package/dist/storage/indexeddb.d.ts

@@ -0,0 +1,139 @@
+import { type BeginTransactionInput, type BeginTransactionResult, type CommitTransactionInput, type CompactionJobRecord, type CompactionJobRecordUpdate, type CreateGarbageCollectionJobInput, type BlockStore, type BlockWrite, type CatalogProbe, type TriggerRecord, type FtsCandidates, type FtsColumnIndexRecord, type FtsPosting, type GarbageCollectionJobRecord, type GarbageCollectionStepResult, type LeaseRecord, type Manifest, type ManifestSummary, type PublishManifestInput, type QueryCatalogState, type RowIdRange, type RunGarbageCollectionStepInput, type SegmentRecord, type StageTransactionArtifactsInput, type StoragePage, type TableColumnRecord, type TableRecord, type TempOwnerRecord, type TempRunPage, type TransactionRecord, type TransactionRecordUpdate } from "./types.js";
+import { type DatabaseSnapshot, type SnapshotLoadProgress } from "./snapshot.js";
+export interface IndexedDbBlockStoreOptions {
+    name: string;
+    durability?: IDBTransactionDurability;
+    indexedDB?: IDBFactory;
+}
+export declare class IndexedDbBlockStore implements BlockStore {
+    #private;
+    private constructor();
+    static open(options: IndexedDbBlockStoreOptions): Promise<IndexedDbBlockStore>;
+    addBlock(id: string, bytes: Uint8Array): Promise<void>;
+    addBlocks(blocks: readonly BlockWrite[]): Promise<void>;
+    getBlock(id: string): Promise<Uint8Array | undefined>;
+    getBlocks(ids: readonly string[]): Promise<Array<Uint8Array | undefined>>;
+    removeBlock(id: string): Promise<void>;
+    listBlockIds(): Promise<string[]>;
+    putTempRunPage(page: TempRunPage): Promise<void>;
+    getTempRunPage(ownerId: string, runId: string, pageIndex: number): Promise<Uint8Array | undefined>;
+    removeTempRun(ownerId: string, runId: string): Promise<void>;
+    removeTempOwner(ownerId: string): Promise<void>;
+    createTempOwner(record: TempOwnerRecord): Promise<void>;
+    getTempOwner(ownerId: string): Promise<TempOwnerRecord | undefined>;
+    renewTempOwner(ownerId: string, expectedRevision: number, expiresAt: string): Promise<TempOwnerRecord>;
+    removeTempOwnerIfExpired(ownerId: string, expiresAtCutoff: string): Promise<boolean>;
+    listTempOwnerIdsPage(afterOwnerId: string | null, limit: number): Promise<StoragePage<string, string>>;
+    addTable(record: TableRecord): Promise<void>;
+    getTable(id: string): Promise<TableRecord | undefined>;
+    updateTable(id: string, expectedRevision: number, update: {
+        columns?: TableColumnRecord[];
+        ftsColumns?: Record<string, FtsColumnIndexRecord> | null;
+        triggers?: TriggerRecord[] | null;
+    }): Promise<TableRecord>;
+    removeTable(id: string, expectedRevision: number): Promise<void>;
+    writeFtsBase(tableId: string, columnId: string, input: {
+        coversVersion: number;
+        chunks: FtsPosting[][];
+        totalTokens: number;
+    }): Promise<void>;
+    readFtsCandidates(tableId: string, columnId: string, terms: ReadonlyArray<{
+        term: string;
+        prefix: boolean;
+    }>, upToVersion: number): Promise<FtsCandidates & {
+        deltaChunkCount: number;
+        totalTokens: number;
+        coversVersion: number;
+    }>;
+    /**
+     * Resolving a name means two reads — name to id, then id to record — and the second cannot
+     * start until the first lands, so the write path pays two serialized round trips for one
+     * lookup. A remembered id collapses that to one read, and needs no invalidation: the record
+     * carries its own name, so a mapping that has gone stale fails the check below and falls
+     * back to the full resolution. Table ids are unique per creation, so a dropped and recreated
+     * table cannot be mistaken for its predecessor.
+     */
+    getTableByName(name: string): Promise<TableRecord | undefined>;
+    listTables(): Promise<TableRecord[]>;
+    addSegment(record: SegmentRecord): Promise<void>;
+    getSegment(id: string): Promise<SegmentRecord | undefined>;
+    listSegments(tableId?: string): Promise<SegmentRecord[]>;
+    removeSegment(id: string): Promise<void>;
+    reserveRowIds(tableId: string, count: number): Promise<RowIdRange>;
+    reserveAutoIncrement(tableId: string, columnId: string, count: number, atLeast?: bigint): Promise<RowIdRange>;
+    getExistingUniqueKeys(tableId: string, keyTokens: readonly string[]): Promise<string[]>;
+    getCurrentManifestVersion(): Promise<number | null>;
+    /**
+     * The freshness probe runs once per query, so its latency is a floor under every read the
+     * database serves. Both values are final the moment their reads land: a read-only
+     * transaction has nothing left to commit, and waiting for its `complete` event only costs
+     * another turn of the event loop — measured at roughly 40% of the probe in Chromium — while
+     * changing nothing about what was read. The reads still race the transaction's failure
+     * events, so an abort surfaces as a rejection here instead of hanging.
+     */
+    getCatalogProbe(): Promise<CatalogProbe>;
+    getQueryCatalogState(tableNames: readonly string[]): Promise<QueryCatalogState>;
+    getCurrentManifest(): Promise<Manifest | undefined>;
+    getManifest(version: number): Promise<Manifest | undefined>;
+    listManifests(): Promise<Manifest[]>;
+    listManifestPage(afterVersion: number | null, limit: number): Promise<{
+        records: Manifest[];
+        nextCursor: number | null;
+    }>;
+    publishManifest(input: PublishManifestInput): Promise<Manifest>;
+    beginTransaction(input: BeginTransactionInput): Promise<BeginTransactionResult>;
+    createTransaction(record: TransactionRecord): Promise<void>;
+    getTransaction(id: string): Promise<TransactionRecord | undefined>;
+    getTransactions(ids: readonly string[]): Promise<Array<TransactionRecord | undefined>>;
+    listTransactions(): Promise<TransactionRecord[]>;
+    listTransactionPage(afterId: string | null, limit: number): Promise<{
+        records: TransactionRecord[];
+        nextCursor: string | null;
+    }>;
+    updateTransaction(id: string, expectedRevision: number, update: TransactionRecordUpdate): Promise<TransactionRecord>;
+    stageTransactionArtifacts(input: StageTransactionArtifactsInput): Promise<TransactionRecord>;
+    commitTransaction(input: CommitTransactionInput): Promise<ManifestSummary>;
+    createLease(record: LeaseRecord): Promise<void>;
+    getLease(id: string): Promise<LeaseRecord | undefined>;
+    listLeases(): Promise<LeaseRecord[]>;
+    renewLease(id: string, expectedRevision: number, expiresAt: string): Promise<LeaseRecord>;
+    removeLeaseIfExpired(id: string, expectedRevision: number, expiresAtCutoff: string): Promise<boolean>;
+    removeLease(id: string): Promise<void>;
+    createCompactionJob(record: CompactionJobRecord): Promise<void>;
+    getCompactionJob(id: string): Promise<CompactionJobRecord | undefined>;
+    listCompactionJobs(tableId?: string): Promise<CompactionJobRecord[]>;
+    listCompactionJobPage(afterId: string | null, limit: number): Promise<{
+        records: CompactionJobRecord[];
+        nextCursor: string | null;
+    }>;
+    updateCompactionJob(id: string, expectedRevision: number, update: CompactionJobRecordUpdate): Promise<CompactionJobRecord>;
+    cancelCompactionJob(id: string, expectedRevision: number, cancelledAt: string): Promise<CompactionJobRecord>;
+    removeCompactionJob(id: string): Promise<void>;
+    createGarbageCollectionJob(input: CreateGarbageCollectionJobInput): Promise<GarbageCollectionJobRecord>;
+    getGarbageCollectionJob(id: string): Promise<GarbageCollectionJobRecord | undefined>;
+    listGarbageCollectionJobs(): Promise<GarbageCollectionJobRecord[]>;
+    runGarbageCollectionStep(input: RunGarbageCollectionStepInput): Promise<GarbageCollectionStepResult>;
+    removeGarbageCollectionJob(id: string): Promise<void>;
+    getLogicalStorageBytes(): Promise<number>;
+    /**
+     * Copies the current version out as a portable snapshot. See `./snapshot.ts` for what a
+     * snapshot carries and what it deliberately leaves behind.
+     *
+     * This reads across several transactions rather than one, so a concurrent commit could move
+     * the version underneath it. Hold a `backup` lease (see `../transactions/index.ts`) around
+     * the call when that is possible; the offline generators that produce published datasets are
+     * the only writer in their process and do not need one.
+     */
+    exportSnapshot(): Promise<DatabaseSnapshot>;
+    /**
+     * Loads a snapshot into this store, which must be empty. Block payloads go in batched
+     * transactions so a large dataset does not build one enormous write, and the current-version
+     * pointer is written last: until it lands, an interrupted load leaves a store that still reads
+     * as empty rather than as half a database.
+     */
+    importSnapshot(snapshot: DatabaseSnapshot, options?: {
+        onProgress?: (progress: SnapshotLoadProgress) => void;
+    }): Promise<void>;
+    close(): void;
+}
+//# sourceMappingURL=indexeddb.d.ts.map

package/dist/storage/indexeddb.d.ts.map

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