@orkestrel/database 0.0.11 → 0.0.13

package/README.md

@@ -23,10 +23,10 @@ npm install @orkestrel/database
 
 ## Status
 
-Pre-release (`0.0.7`): the core engine and the memory, JSON file, SQLite,
+Pre-release: the core engine and the memory, JSON file, SQLite,
 and IndexedDB drivers are all implemented and tested, but the public API is
 still unstable and may change without notice. See
-[guides/src/database.md](./guides/src/database.md) for the full documented
+[guides/database.md](./guides/database.md) for the full documented
 surface.
 
 ## Package

package/dist/src/browser/index.d.ts

@@ -16,9 +16,9 @@ import { TableSchema } from '@orkestrel/database';
 import { TableSchema as TableSchema_2 } from '@orkestrel/database';
 
 /**
- * The `IDBKeyRange` a single {@link Condition} maps to, when its operator is one
- * of the six exact key comparisons over scalar operands; otherwise
- * `undefined`.
+ * Translates one {@link Condition} to the `IDBKeyRange` it maps to, when its
+ * operator is one of the exact key comparisons over scalar operands; otherwise
+ * returns `undefined`.
  *
  * @remarks
  * Only the comparison operators (`equals`/`above`/`below`/`from`/`to`/`between`)
@@ -29,7 +29,7 @@ import { TableSchema as TableSchema_2 } from '@orkestrel/database';
  * one). `starts` is excluded — its prefix range can miss strings past U+FFFF;
  * the membership / negation / pattern / existence operators (`not`/`like`/`glob`/
  * `ends`/`any`/`none`/`absent`/`present`) have no single exact range. The operand
- * guard (`typeof` string/number) rejects a non-scalar value (e.g. an array, a
+ * guard (`typeof` string/number) rejects a non-scalar value (for example an array, a
  * boolean) that is not a usable key. `between` additionally guards against a
  * REVERSED pair (`first > second`): native `IDBKeyRange.bound` throws a raw
  * `DataError` `DOMException` for a lower bound above the upper bound, so a
@@ -47,7 +47,7 @@ import { TableSchema as TableSchema_2 } from '@orkestrel/database';
 export declare function conditionToRange(condition: Condition): IDBKeyRange | undefined;
 
 /**
- * Create a persistent IndexedDB {@link DriverInterface} for the core database layer.
+ * Creates a persistent IndexedDB {@link DriverInterface} for the core database layer.
  *
  * @remarks
  * Pass it to `createDatabase` from `@orkestrel/database` to run the typed database
@@ -77,7 +77,7 @@ export declare function conditionToRange(condition: Condition): IDBKeyRange | un
 export declare function createIndexedDBDriver(name: string): DriverInterface_2;
 
 /**
- * Derive an IndexedDB index name for a declared column group — a bare column
+ * Derives an IndexedDB index name for a declared column group — a bare column
  * name for a single-column index, a deterministic collision-free encoding for a
  * compound one.
  *
@@ -106,11 +106,23 @@ export declare function createIndexedDBDriver(name: string): DriverInterface_2;
  */
 export declare function deriveIndexedDBIndexName(columns: readonly string[]): string;
 
-export declare const INDEXABLE_STORAGE: ReadonlySet<ColumnStorage>;
+/**
+ * Lists the declared {@link ColumnStorage}s that are valid, orderable IndexedDB keys.
+ *
+ * @remarks
+ * `text` / `integer` / `real` occupy IndexedDB's string / number key space, so a
+ * column declared with one of them can back a store or index range read.
+ * `boolean` / `json` / `blob` are not valid `IDBValidKey`s and a range over one
+ * would silently miss rows, so `selectPlan` never pushes a condition down on
+ * them and the core engine answers the read instead. A frozen array, matching
+ * `EXACT_COLUMN_STORAGE` in `src/server`: a consumer holding it reads the
+ * membership with `includes` and cannot change the driver's pushdown behavior.
+ */
+export declare const INDEXABLE_STORAGE: readonly ColumnStorage[];
 
 /**
- * The IndexedDB {@link DriverInterface} — the persistent browser backend, built on
- * the published `@orkestrel/indexeddb` wrapper.
+ * Implements the {@link DriverInterface} over IndexedDB — the persistent browser backend,
+ * built on the published `@orkestrel/indexeddb` wrapper.
  *
  * @remarks
  * A thin adapter: it implements the storage primitives the core database layer
@@ -126,12 +138,12 @@ export declare const INDEXABLE_STORAGE: ReadonlySet<ColumnStorage>;
  * wrapper's native `getAll` / `getAllKeys`, and `snapshot` rolls back through one
  * atomic wrapper transaction.
  *
- * It also implements the optional native `records` / `stream` hooks
- * (AGENTS §21): `selectPlan` ({@link selectPlan}) turns the {@link QueryInput} into a
+ * It also implements the optional native `records` / `stream` hooks:
+ * `selectPlan` ({@link selectPlan}) turns the {@link QueryInput} into a
  * key-range pushdown over the primary key or a single-column secondary index,
  * fetching a candidate **superset** that the core engine (`applyQuery` /
  * `matchesQuery`) then refines — so a native read is byte-identical to a full
- * scan, just cheaper. Pushdown is conservative: only the exact-comparison
+ * scan, only cheaper. Pushdown is conservative: only the exact-comparison
  * operators over orderable columns narrow to a range; everything else falls back
  * to a full scan + the engine.
  *
@@ -145,7 +157,7 @@ export declare const INDEXABLE_STORAGE: ReadonlySet<ColumnStorage>;
  * transaction (`onupgradeneeded`), so `migrate` closes the current connection
  * and opens a FRESH one at `version + 1` with an `upgrade` hook that walks the
  * plan's steps — dropping stores, adding/removing indexes on the raw
- * `IDBTransaction`, and rewriting rows for `column.remove` via a cursor walk
+ * `IDBTransaction`, and rewriting rows for `column.remove` through a cursor walk
  * (the one step needing to touch existing data; `column.add` is a no-op — this
  * driver stores whatever a row carries, so there is nothing to backfill). A
  * step referencing an unknown table is validated BEFORE the reconnect, so a
@@ -154,11 +166,12 @@ export declare const INDEXABLE_STORAGE: ReadonlySet<ColumnStorage>;
  * @remarks
  * This unit deliberately OMITS `aggregate` / `transaction`. There is no native
  * `aggregate` (IndexedDB has no native SUM/AVG); the engine over the narrowed
- * `records` covers it. `transaction` is impossible here: the wrapper auto-commits
- * an `IDBTransaction` when control yields outside its request chain, so arbitrary
- * callback awaits cannot remain inside one native transaction. Every atomic
- * multi-operation sequence in this driver
- * (`snapshot`'s rollback) instead runs entirely inside ONE `db.write(...)` scope.
+ * `records` covers it. `transaction` is impossible here: the wrapper
+ * auto-commits an `IDBTransaction` when control yields outside its request
+ * chain, so arbitrary callback awaits cannot remain inside one native
+ * transaction. Every atomic multi-operation sequence in this driver
+ * (`snapshot`'s rollback) instead runs entirely inside ONE `db.write(...)`
+ * scope.
  */
 export declare class IndexedDBDriver implements DriverInterface {
     #private;
@@ -176,7 +189,7 @@ export declare class IndexedDBDriver implements DriverInterface {
     stream(table: string, input: QueryInput_2): AsyncIterable<Row>;
     snapshot(tables?: readonly string[]): Promise<() => Promise<void>>;
     /**
-     * Return the persisted {@link DriverMetadata}, or `undefined` when the store has
+     * Returns the persisted {@link DriverMetadata}, or `undefined` when the store has
      * never been stamped.
      *
      * @remarks
@@ -189,13 +202,13 @@ export declare class IndexedDBDriver implements DriverInterface {
      */
     metadata(): Promise<DriverMetadata | undefined>;
     /**
-     * Persist an owned metadata snapshot for a later `metadata()` to return.
+     * Persists an owned metadata snapshot for a later `metadata()` to return.
      *
      * @param metadata - The {@link DriverMetadata} to persist
      */
     stamp(metadata: DriverMetadata): Promise<void>;
     /**
-     * Apply a {@link Migration} plan by reconnecting at a bumped version and
+     * Applies a {@link Migration} plan by reconnecting at a bumped version and
      * running the plan's steps inside the wrapper's `upgrade` hook.
      *
      * @remarks
@@ -220,7 +233,7 @@ export declare class IndexedDBDriver implements DriverInterface {
 }
 
 /**
- * Map a backend {@link IndexedDBError} to the portable `DatabaseError` taxonomy
+ * Maps a backend {@link IndexedDBError} to the portable `DatabaseError` taxonomy
  * — the default mapping used everywhere except inside `migrate()`.
  *
  * @remarks
@@ -246,7 +259,7 @@ export declare class IndexedDBDriver implements DriverInterface {
 export declare function mapIndexedDBError(error: IndexedDBError): DatabaseError;
 
 /**
- * Map a backend {@link IndexedDBError} to the portable `DatabaseError` taxonomy
+ * Maps a backend {@link IndexedDBError} to the portable `DatabaseError` taxonomy
  * for use INSIDE `migrate()` — the one context where `UPGRADE` means the
  * migration itself failed, not a generic driver fault.
  *
@@ -263,10 +276,19 @@ export declare function mapIndexedDBError(error: IndexedDBError): DatabaseError;
  */
 export declare function mapMigrationError(error: IndexedDBError): DatabaseError;
 
+/**
+ * Names the reserved out-of-line store the {@link IndexedDBDriver} stamps its
+ * {@link DriverMetadata} into.
+ *
+ * @remarks
+ * Backs the driver's `metadata` / `stamp` hooks. A user table declared with this
+ * exact name collides with the driver's own bookkeeping, so a caller must avoid
+ * it; the collision is caught at `open`.
+ */
 export declare const METADATA_STORE = "__metadata__";
 
 /**
- * A pushdown plan — an optional index and optional `IDBKeyRange` used to narrow
+ * Represents a pushdown plan — an optional index and optional `IDBKeyRange` used to narrow
  * a read. An omitted `index` selects the primary store; an omitted `range`
  * performs a full scan. The plan is always a superset of the matching rows;
  * the core engine refines it to the exact result. An empty plan (`{}`) is a
@@ -278,7 +300,7 @@ export declare interface QueryPlan {
 }
 
 /**
- * Project a table schema into the IndexedDB wrapper's store definition.
+ * Projects a table schema into the IndexedDB wrapper's store definition.
  *
  * @param schema - Portable table schema
  * @returns Store definition with declared indexes
@@ -286,7 +308,7 @@ export declare interface QueryPlan {
 export declare function schemaToStore(schema: TableSchema): StoreDefinition;
 
 /**
- * Plan an IndexedDB read for a {@link QueryInput} — pick the index (or the primary
+ * Plans an IndexedDB read for a {@link QueryInput} — picks the index (or the primary
  * store) and {@link IDBKeyRange} to narrow by, falling back to a full scan.
  *
  * @remarks

package/dist/src/browser/index.js

@@ -1,18 +1,39 @@
-import { DatabaseError, applyQuery, bindRowKey, checkAbort, cloneDriverMetadata, cloneMigrationInput, compareValues, equalsValue, extractKey, isDatabaseError, isKey, matchesQuery, migrateRows, normalizeDriverSchema, planMigration, projectMigrationSchema, validatePage } from "../core/index.js";
-import { createIndexedDBDatabase, isIndexedDBError, rangeAboveKey, rangeBelowKey, rangeBetweenKeys, rangeExactKey, rangeFromKey, rangeToKey } from "@orkestrel/indexeddb";
+import { DatabaseError, applyQuery, bindRowKey, checkAbort, cloneDriverMetadata, cloneMigrationInput, compareValues, equalsValue, extractKey, findColumn, isDatabaseError, isKey, matchesQuery, migrateRows, normalizeDriverSchema, planMigration, projectMigrationSchema, validatePage } from "../core/index.js";
+import { createIndexedDBDatabase, isIndexedDBError, rangeAboveKey, rangeBelowKey, rangeFromKey, rangeToKey } from "@orkestrel/indexeddb";
 //#region src/browser/constants.ts
-var INDEXABLE_STORAGE = /* @__PURE__ */ new Set([
+/**
+* Lists the declared {@link ColumnStorage}s that are valid, orderable IndexedDB keys.
+*
+* @remarks
+* `text` / `integer` / `real` occupy IndexedDB's string / number key space, so a
+* column declared with one of them can back a store or index range read.
+* `boolean` / `json` / `blob` are not valid `IDBValidKey`s and a range over one
+* would silently miss rows, so `selectPlan` never pushes a condition down on
+* them and the core engine answers the read instead. A frozen array, matching
+* `EXACT_COLUMN_STORAGE` in `src/server`: a consumer holding it reads the
+* membership with `includes` and cannot change the driver's pushdown behavior.
+*/
+var INDEXABLE_STORAGE = Object.freeze([
 	"text",
 	"integer",
 	"real"
 ]);
+/**
+* Names the reserved out-of-line store the {@link IndexedDBDriver} stamps its
+* {@link DriverMetadata} into.
+*
+* @remarks
+* Backs the driver's `metadata` / `stamp` hooks. A user table declared with this
+* exact name collides with the driver's own bookkeeping, so a caller must avoid
+* it; the collision is caught at `open`.
+*/
 var METADATA_STORE = "__metadata__";
 //#endregion
 //#region src/browser/helpers.ts
 /**
-* The `IDBKeyRange` a single {@link Condition} maps to, when its operator is one
-* of the six exact key comparisons over scalar operands; otherwise
-* `undefined`.
+* Translates one {@link Condition} to the `IDBKeyRange` it maps to, when its
+* operator is one of the exact key comparisons over scalar operands; otherwise
+* returns `undefined`.
 *
 * @remarks
 * Only the comparison operators (`equals`/`above`/`below`/`from`/`to`/`between`)
@@ -23,7 +44,7 @@ var METADATA_STORE = "__metadata__";
 * one). `starts` is excluded — its prefix range can miss strings past U+FFFF;
 * the membership / negation / pattern / existence operators (`not`/`like`/`glob`/
 * `ends`/`any`/`none`/`absent`/`present`) have no single exact range. The operand
-* guard (`typeof` string/number) rejects a non-scalar value (e.g. an array, a
+* guard (`typeof` string/number) rejects a non-scalar value (for example an array, a
 * boolean) that is not a usable key. `between` additionally guards against a
 * REVERSED pair (`first > second`): native `IDBKeyRange.bound` throws a raw
 * `DataError` `DOMException` for a lower bound above the upper bound, so a
@@ -42,12 +63,12 @@ function conditionToRange(condition) {
 	const first = condition.values[0];
 	const second = condition.values[1];
 	switch (condition.operator) {
-		case "equals": return isKey(first) ? rangeExactKey(first) : void 0;
+		case "equals": return isKey(first) ? IDBKeyRange.only(first) : void 0;
 		case "above": return isKey(first) ? rangeAboveKey(first) : void 0;
 		case "below": return isKey(first) ? rangeBelowKey(first) : void 0;
 		case "from": return isKey(first) ? rangeFromKey(first) : void 0;
 		case "to": return isKey(first) ? rangeToKey(first) : void 0;
-		case "between": return isKey(first) && isKey(second) && compareValues(first, second) <= 0 ? rangeBetweenKeys(first, second) : void 0;
+		case "between": return isKey(first) && isKey(second) && compareValues(first, second) <= 0 ? IDBKeyRange.bound(first, second) : void 0;
 		case "not":
 		case "like":
 		case "glob":
@@ -60,7 +81,7 @@ function conditionToRange(condition) {
 	}
 }
 /**
-* Plan an IndexedDB read for a {@link QueryInput} — pick the index (or the primary
+* Plans an IndexedDB read for a {@link QueryInput} — picks the index (or the primary
 * store) and {@link IDBKeyRange} to narrow by, falling back to a full scan.
 *
 * @remarks
@@ -129,8 +150,8 @@ function selectPlan(input, schema, available) {
 	if (conditions.slice(1).some((condition) => condition.connector === "or")) return {};
 	for (const condition of conditions) {
 		if (typeof condition.column !== "string") continue;
-		const column = schema.columns.find((candidate) => candidate.name === condition.column);
-		if (column === void 0 || !INDEXABLE_STORAGE.has(column.storage)) continue;
+		const column = findColumn(condition.column, schema);
+		if (column === void 0 || !INDEXABLE_STORAGE.includes(column.storage)) continue;
 		const range = conditionToRange(condition);
 		if (range === void 0) continue;
 		if (condition.column === schema.primary) return { range };
@@ -143,7 +164,7 @@ function selectPlan(input, schema, available) {
 	return {};
 }
 /**
-* Map a backend {@link IndexedDBError} to the portable `DatabaseError` taxonomy
+* Maps a backend {@link IndexedDBError} to the portable `DatabaseError` taxonomy
 * — the default mapping used everywhere except inside `migrate()`.
 *
 * @remarks
@@ -187,7 +208,7 @@ function mapIndexedDBError(error) {
 	}
 }
 /**
-* Map a backend {@link IndexedDBError} to the portable `DatabaseError` taxonomy
+* Maps a backend {@link IndexedDBError} to the portable `DatabaseError` taxonomy
 * for use INSIDE `migrate()` — the one context where `UPGRADE` means the
 * migration itself failed, not a generic driver fault.
 *
@@ -207,7 +228,7 @@ function mapMigrationError(error) {
 	return mapIndexedDBError(error);
 }
 /**
-* Derive an IndexedDB index name for a declared column group — a bare column
+* Derives an IndexedDB index name for a declared column group — a bare column
 * name for a single-column index, a deterministic collision-free encoding for a
 * compound one.
 *
@@ -240,7 +261,7 @@ function deriveIndexedDBIndexName(columns) {
 	return `${columns.length}#${columns.map((part) => `${part.length}:${part}`).join("")}`;
 }
 /**
-* Project a table schema into the IndexedDB wrapper's store definition.
+* Projects a table schema into the IndexedDB wrapper's store definition.
 *
 * @param schema - Portable table schema
 * @returns Store definition with declared indexes
@@ -257,8 +278,8 @@ function schemaToStore(schema) {
 //#endregion
 //#region src/browser/drivers/IndexedDBDriver.ts
 /**
-* The IndexedDB {@link DriverInterface} — the persistent browser backend, built on
-* the published `@orkestrel/indexeddb` wrapper.
+* Implements the {@link DriverInterface} over IndexedDB — the persistent browser backend,
+* built on the published `@orkestrel/indexeddb` wrapper.
 *
 * @remarks
 * A thin adapter: it implements the storage primitives the core database layer
@@ -274,12 +295,12 @@ function schemaToStore(schema) {
 * wrapper's native `getAll` / `getAllKeys`, and `snapshot` rolls back through one
 * atomic wrapper transaction.
 *
-* It also implements the optional native `records` / `stream` hooks
-* (AGENTS §21): `selectPlan` ({@link selectPlan}) turns the {@link QueryInput} into a
+* It also implements the optional native `records` / `stream` hooks:
+* `selectPlan` ({@link selectPlan}) turns the {@link QueryInput} into a
 * key-range pushdown over the primary key or a single-column secondary index,
 * fetching a candidate **superset** that the core engine (`applyQuery` /
 * `matchesQuery`) then refines — so a native read is byte-identical to a full
-* scan, just cheaper. Pushdown is conservative: only the exact-comparison
+* scan, only cheaper. Pushdown is conservative: only the exact-comparison
 * operators over orderable columns narrow to a range; everything else falls back
 * to a full scan + the engine.
 *
@@ -293,7 +314,7 @@ function schemaToStore(schema) {
 * transaction (`onupgradeneeded`), so `migrate` closes the current connection
 * and opens a FRESH one at `version + 1` with an `upgrade` hook that walks the
 * plan's steps — dropping stores, adding/removing indexes on the raw
-* `IDBTransaction`, and rewriting rows for `column.remove` via a cursor walk
+* `IDBTransaction`, and rewriting rows for `column.remove` through a cursor walk
 * (the one step needing to touch existing data; `column.add` is a no-op — this
 * driver stores whatever a row carries, so there is nothing to backfill). A
 * step referencing an unknown table is validated BEFORE the reconnect, so a
@@ -302,11 +323,12 @@ function schemaToStore(schema) {
 * @remarks
 * This unit deliberately OMITS `aggregate` / `transaction`. There is no native
 * `aggregate` (IndexedDB has no native SUM/AVG); the engine over the narrowed
-* `records` covers it. `transaction` is impossible here: the wrapper auto-commits
-* an `IDBTransaction` when control yields outside its request chain, so arbitrary
-* callback awaits cannot remain inside one native transaction. Every atomic
-* multi-operation sequence in this driver
-* (`snapshot`'s rollback) instead runs entirely inside ONE `db.write(...)` scope.
+* `records` covers it. `transaction` is impossible here: the wrapper
+* auto-commits an `IDBTransaction` when control yields outside its request
+* chain, so arbitrary callback awaits cannot remain inside one native
+* transaction. Every atomic multi-operation sequence in this driver
+* (`snapshot`'s rollback) instead runs entirely inside ONE `db.write(...)`
+* scope.
 */
 var IndexedDBDriver = class {
 	#name;
@@ -434,30 +456,6 @@ var IndexedDBDriver = class {
 		validatePage(input);
 		return this.#stream(table, input);
 	}
-	async *#stream(table, input) {
-		try {
-			const schema = this.#table(table);
-			const store = this.#store(table);
-			const plan = selectPlan(input, schema, store.indexes);
-			const conditions = input.conditions ?? [];
-			const offset = input.offset ?? 0;
-			const limit = input.limit;
-			let skipped = 0;
-			let yielded = 0;
-			for (const row of await this.#candidates(store, schema, plan)) {
-				if (limit !== void 0 && yielded >= limit) break;
-				if (!matchesQuery(row, conditions)) continue;
-				if (skipped < offset) {
-					skipped += 1;
-					continue;
-				}
-				yielded += 1;
-				yield row;
-			}
-		} catch (error) {
-			throw this.#wrap(error);
-		}
-	}
 	async snapshot(tables) {
 		try {
 			const database = this.#require();
@@ -529,7 +527,7 @@ var IndexedDBDriver = class {
 		}
 	}
 	/**
-	* Return the persisted {@link DriverMetadata}, or `undefined` when the store has
+	* Returns the persisted {@link DriverMetadata}, or `undefined` when the store has
 	* never been stamped.
 	*
 	* @remarks
@@ -548,7 +546,7 @@ var IndexedDBDriver = class {
 		}
 	}
 	/**
-	* Persist an owned metadata snapshot for a later `metadata()` to return.
+	* Persists an owned metadata snapshot for a later `metadata()` to return.
 	*
 	* @param metadata - The {@link DriverMetadata} to persist
 	*/
@@ -565,7 +563,7 @@ var IndexedDBDriver = class {
 		}
 	}
 	/**
-	* Apply a {@link Migration} plan by reconnecting at a bumped version and
+	* Applies a {@link Migration} plan by reconnecting at a bumped version and
 	* running the plan's steps inside the wrapper's `upgrade` hook.
 	*
 	* @remarks
@@ -647,6 +645,30 @@ var IndexedDBDriver = class {
 			throw cause;
 		}
 	}
+	async *#stream(table, input) {
+		try {
+			const schema = this.#table(table);
+			const store = this.#store(table);
+			const plan = selectPlan(input, schema, store.indexes);
+			const conditions = input.conditions ?? [];
+			const offset = input.offset ?? 0;
+			const limit = input.limit;
+			let skipped = 0;
+			let yielded = 0;
+			for (const row of await this.#candidates(store, schema, plan)) {
+				if (limit !== void 0 && yielded >= limit) break;
+				if (!matchesQuery(row, conditions)) continue;
+				if (skipped < offset) {
+					skipped += 1;
+					continue;
+				}
+				yielded += 1;
+				yield row;
+			}
+		} catch (error) {
+			throw this.#wrap(error);
+		}
+	}
 	async #mutate(table, options, scope) {
 		const signal = options?.signal;
 		checkAbort(signal);
@@ -759,31 +781,33 @@ var IndexedDBDriver = class {
 		return schema;
 	}
 	async #upgrade(input, added, context) {
-		for (const name of added) if (name !== "__metadata__" && context.stores.includes(name)) context.drop(name);
+		for (const name of added) if (name !== "__metadata__" && context.stores.names.includes(name)) context.stores.drop(name);
 		for (const step of input.plan.steps) switch (step.operation) {
 			case "table.add":
-				context.create(step.table.name, schemaToStore(step.table));
+				context.stores.create(step.table.name, schemaToStore(step.table));
 				break;
 			case "table.remove":
-				context.drop(step.table);
+				context.stores.drop(step.table);
 				break;
 			case "index.add": {
 				const name = deriveIndexedDBIndexName(step.index);
 				const [column] = step.index;
 				const path = step.index.length === 1 && column !== void 0 ? column : [...step.index];
-				context.index(step.table, {
+				context.indexes.create(step.table, {
 					name,
 					path
 				});
 				break;
 			}
 			case "index.remove":
-				context.deindex(step.table, deriveIndexedDBIndexName(step.index));
+				context.indexes.drop(step.table, deriveIndexedDBIndexName(step.index));
 				break;
 			case "column.remove": {
-				let cursor = await context.store(step.table).cursor();
+				let cursor = await context.stores.store(step.table).cursor();
 				while (cursor !== null) {
-					const [migrated] = migrateRows([cursor.value], [step]);
+					const row = cursor.value;
+					if (row === void 0) throw new DatabaseError("MIGRATION", "migrate: stored value is not a record", { table: step.table });
+					const [migrated] = migrateRows([row], [step]);
 					if (migrated === void 0) throw new DatabaseError("MIGRATION", "migrate: transformed row is missing", { table: step.table });
 					await cursor.update(migrated);
 					cursor = await cursor.continue();
@@ -791,7 +815,7 @@ var IndexedDBDriver = class {
 				break;
 			}
 		}
-		if (input.metadata !== void 0) await context.store(METADATA_STORE).set({
+		if (input.metadata !== void 0) await context.stores.store(METADATA_STORE).set({
 			version: input.metadata.version,
 			schema: input.metadata.schema
 		}, "metadata");
@@ -800,7 +824,7 @@ var IndexedDBDriver = class {
 //#endregion
 //#region src/browser/factories.ts
 /**
-* Create a persistent IndexedDB {@link DriverInterface} for the core database layer.
+* Creates a persistent IndexedDB {@link DriverInterface} for the core database layer.
 *
 * @remarks
 * Pass it to `createDatabase` from `@orkestrel/database` to run the typed database