@crvouga/sqlite-mem 0.1.0 → 0.2.0

package/dist/indexes/index.d.ts

@@ -1,16 +1,29 @@
-import type { Rowid } from "../storage/row.ts";
-import { type SqlValue } from "../types/value.ts";
+import type { Rowid } from "../storage/row.js";
+import { type SqlValue } from "../types/value.js";
 export declare class IndexStore {
     readonly name: string;
     private entries;
-    constructor(name?: string, entries?: ReadonlyMap<string, readonly Rowid[]>);
+    private keyValues;
+    private sortedKeys;
+    frozen: boolean;
+    constructor(name?: string, entries?: ReadonlyMap<string, readonly Rowid[]>, keyValues?: ReadonlyMap<string, readonly SqlValue[]>);
     checkUnique(values: readonly SqlValue[], rowid?: Rowid): void;
     insert(values: readonly SqlValue[], rowid: Rowid, unique?: boolean): void;
     lookup(values: readonly SqlValue[]): readonly Rowid[];
+    /** Leftmost prefix match: INDEX(a,b) used for WHERE a = ?. */
+    lookupPrefix(values: readonly SqlValue[]): readonly Rowid[];
+    /**
+     * Ordered scan of rowids for a single-column comparison.
+     * `op` applies to the first key component.
+     */
+    rangeLookup(op: ">" | ">=" | "<" | "<=" | "between", bound: SqlValue, bound2?: SqlValue): readonly Rowid[];
+    orderedRowids(desc?: boolean): readonly Rowid[];
     remove(values: readonly SqlValue[], rowid?: Rowid): boolean;
     clear(): void;
     clone(): IndexStore;
+    freeze(): void;
     get size(): number;
+    private orderedKeys;
+    private assertMutable;
 }
 export declare function serializeIndexKey(values: readonly SqlValue[]): string | null;
-//# sourceMappingURL=index.d.ts.map

package/dist/json/index.d.ts

@@ -1,8 +1,7 @@
-export { decodeJsonb, encodeJsonb, jsonbToText, looksLikeJsonb, textToJsonb, walkJsonbTree, } from "./jsonb.ts";
-export { ensureJson, extractOne, jsonArrowPath, jsonNodeToSql, mutateJson, patchJson, removeJson, sqlToJsonInput, sqlValueToJsonNode, toJsonbBlob, toJsonText, wrapJsonError, } from "./ops.ts";
-export { isValidJsonText, JsonParseError, jsonErrorPosition, parseJsonText } from "./parse.ts";
-export { parseJsonPath, pathGet } from "./path.ts";
-export { jsonQuoteString, prettyJson, stringifyJson } from "./stringify.ts";
-export { jsonEachRows, jsonTreeRows } from "./tvf.ts";
-export type { JsonNode, JsonTypeName } from "./types.ts";
-//# sourceMappingURL=index.d.ts.map
+export { decodeJsonb, encodeJsonb, jsonbToText, looksLikeJsonb, textToJsonb, walkJsonbTree, } from "./jsonb.js";
+export { arrayInsertJson, ensureJson, extractOne, jsonArrowPath, jsonNodeToSql, mutateJson, patchJson, removeJson, sqlToJsonInput, sqlValueToJsonNode, toJsonbBlob, toJsonText, wrapJsonError, } from "./ops.js";
+export { isValidJsonText, JsonParseError, jsonErrorPosition, parseJsonText } from "./parse.js";
+export { parseJsonPath, pathGet } from "./path.js";
+export { jsonQuoteString, prettyJson, stringifyJson } from "./stringify.js";
+export { jsonEachRows, jsonTreeRows } from "./tvf.js";
+export type { JsonNode, JsonTypeName } from "./types.js";

package/dist/json/jsonb.d.ts

@@ -1,4 +1,4 @@
-import type { JsonNode } from "./types.ts";
+import type { JsonNode } from "./types.js";
 /** JSONB element types (low nibble). */
 export declare const JB: {
     readonly NULL: 0;
@@ -40,4 +40,3 @@ export interface JsonbWalkEntry {
 export declare function walkJsonbTree(blob: Uint8Array): JsonbWalkEntry[];
 export declare function jsonbToText(blob: Uint8Array): string;
 export declare function textToJsonb(text: string): Uint8Array;
-//# sourceMappingURL=jsonb.d.ts.map

package/dist/json/ops.d.ts

@@ -1,5 +1,5 @@
-import { SqlJsonText, type SqlValue } from "../types/value.ts";
-import { type JsonNode } from "./types.ts";
+import { SqlJsonText, type SqlValue } from "../types/value.js";
+import { type JsonNode } from "./types.js";
 export declare function sqlToJsonInput(value: SqlValue): JsonNode;
 export declare function trySqlToJsonInput(value: SqlValue): JsonNode | null;
 /** VALUE arg for insert/set/array/object — literal unless JSON subtype / JSONB. */
@@ -8,6 +8,12 @@ export declare function jsonNodeToSql(node: JsonNode, mode: "sql" | "json" | "js
 export declare function jsonArrowPath(right: SqlValue): string;
 export declare function extractOne(root: JsonNode, path: string): JsonNode | undefined;
 export type MutateMode = "insert" | "replace" | "set";
+/**
+ * json_array_insert / jsonb_array_insert — like json_replace, but PATH must end
+ * with an array index and the value is spliced in (existing elements shift right).
+ * https://www.sqlite.org/json1.html#jarrins
+ */
+export declare function arrayInsertJson(root: JsonNode, path: string, value: JsonNode): JsonNode;
 export declare function mutateJson(root: JsonNode, path: string, value: JsonNode, mode: MutateMode): JsonNode;
 export declare function removeJson(root: JsonNode, path: string): JsonNode;
 /** RFC7396-ish JSON Merge Patch as implemented by SQLite json_patch. */
@@ -16,4 +22,3 @@ export declare function wrapJsonError(e: unknown): never;
 export declare function ensureJson(value: SqlValue): JsonNode;
 export declare function toJsonbBlob(value: SqlValue): Uint8Array;
 export declare function toJsonText(value: SqlValue): SqlJsonText;
-//# sourceMappingURL=ops.d.ts.map

package/dist/json/parse.d.ts

@@ -1,5 +1,5 @@
-import { SqliteError } from "../errors/index.ts";
-import type { JsonNode } from "./types.ts";
+import { SqliteError } from "../errors/index.js";
+import type { JsonNode } from "./types.js";
 export declare class JsonParseError extends Error {
     readonly position: number;
     constructor(message: string, position: number);
@@ -11,4 +11,3 @@ export declare function parseJsonText(input: string, options?: {
 export declare function jsonErrorPosition(input: string): number;
 export declare function isValidJsonText(input: string, flags?: number): boolean;
 export declare function malformedJsonError(position?: number): SqliteError;
-//# sourceMappingURL=parse.d.ts.map

package/dist/json/path.d.ts

@@ -1,4 +1,4 @@
-import type { JsonNode } from "./types.ts";
+import type { JsonNode } from "./types.js";
 export type PathStep = {
     kind: "root";
 } | {
@@ -24,4 +24,3 @@ export interface PathParent {
 }
 /** Locate parent container for the final path step (for mutate). */
 export declare function pathParent(root: JsonNode, steps: PathStep[]): PathParent | null;
-//# sourceMappingURL=path.d.ts.map

package/dist/json/stringify.d.ts

@@ -1,5 +1,4 @@
-import type { JsonNode } from "./types.ts";
+import type { JsonNode } from "./types.js";
 export declare function stringifyJson(node: JsonNode): string;
 export declare function jsonQuoteString(value: string): string;
 export declare function prettyJson(node: JsonNode, indent?: string): string;
-//# sourceMappingURL=stringify.d.ts.map

package/dist/json/tvf.d.ts

@@ -1,4 +1,4 @@
-import type { SqlValue } from "../types/value.ts";
+import type { SqlValue } from "../types/value.js";
 export interface JsonTvfRow {
     key: SqlValue;
     value: SqlValue;
@@ -11,4 +11,3 @@ export interface JsonTvfRow {
 }
 export declare function jsonEachRows(json: SqlValue, path?: SqlValue): JsonTvfRow[];
 export declare function jsonTreeRows(json: SqlValue, path?: SqlValue): JsonTvfRow[];
-//# sourceMappingURL=tvf.d.ts.map

package/dist/json/types.d.ts

@@ -27,4 +27,3 @@ export type JsonNode = {
 export type JsonTypeName = "null" | "true" | "false" | "integer" | "real" | "text" | "array" | "object";
 export declare function jsonTypeName(node: JsonNode): JsonTypeName;
 export declare function cloneJson(node: JsonNode): JsonNode;
-//# sourceMappingURL=types.d.ts.map

package/dist/lexer/tokenize.d.ts

@@ -1,4 +1,6 @@
+/** Lexer token kind: keywords, literals, operators, and punctuation. */
 export type TokenKind = "EOF" | "IDENT" | "STRING" | "NUMBER" | "BLOB" | "PARAM_POS" | "PARAM_NAMED" | "DOT" | "COMMA" | "SEMI" | "LPAREN" | "RPAREN" | "PLUS" | "MINUS" | "STAR" | "SLASH" | "PERCENT" | "EQ" | "EQEQ" | "NE" | "LT" | "LE" | "GT" | "GE" | "CONCAT" | "AMP" | "PIPE" | "LSHIFT" | "RSHIFT" | "JSON_ARROW" | "JSON_ARROW2" | "TILDE" | "ABORT" | "ACTION" | "ADD" | "AFTER" | "ALL" | "ALTER" | "ANALYZE" | "AND" | "AS" | "ASC" | "ATTACH" | "AUTOINCREMENT" | "BEFORE" | "BEGIN" | "BETWEEN" | "BY" | "CASCADE" | "CASE" | "CAST" | "CHECK" | "COLLATE" | "COLUMN" | "COMMIT" | "CONFLICT" | "CONSTRAINT" | "CREATE" | "CROSS" | "CURRENT" | "CURRENT_DATE" | "CURRENT_TIME" | "CURRENT_TIMESTAMP" | "DATABASE" | "DEFAULT" | "DEFERRABLE" | "DEFERRED" | "DELETE" | "DESC" | "DETACH" | "DISTINCT" | "DO" | "DROP" | "EACH" | "ELSE" | "END" | "ESCAPE" | "EXCEPT" | "EXCLUDE" | "EXCLUSIVE" | "EXISTS" | "EXPLAIN" | "FAIL" | "FILTER" | "FIRST" | "FOLLOWING" | "FOR" | "FOREIGN" | "FROM" | "FULL" | "GENERATED" | "GLOB" | "GROUP" | "GROUPS" | "HAVING" | "IF" | "IGNORE" | "IMMEDIATE" | "IN" | "INDEX" | "INDEXED" | "INITIALLY" | "INNER" | "INSERT" | "INSTEAD" | "INTERSECT" | "INTO" | "IS" | "ISNULL" | "JOIN" | "KEY" | "LAST" | "LEFT" | "LIKE" | "LIMIT" | "MATCH" | "MATERIALIZED" | "NATURAL" | "NO" | "NOT" | "NOTHING" | "NOTNULL" | "NULL" | "NULLS" | "OF" | "OFFSET" | "ON" | "OR" | "ORDER" | "OTHERS" | "OUTER" | "OVER" | "PARTITION" | "PLAN" | "PRAGMA" | "PRECEDING" | "PRIMARY" | "QUERY" | "RAISE" | "RANGE" | "RECURSIVE" | "REFERENCES" | "REGEXP" | "REINDEX" | "RELEASE" | "RENAME" | "REPLACE" | "RESTRICT" | "RETURNING" | "RIGHT" | "ROLLBACK" | "ROW" | "ROWS" | "SAVEPOINT" | "SELECT" | "SET" | "TABLE" | "TEMP" | "TEMPORARY" | "THEN" | "TIES" | "TO" | "TRANSACTION" | "TRIGGER" | "UNBOUNDED" | "UNION" | "UNIQUE" | "UPDATE" | "USING" | "VACUUM" | "VALUES" | "VIEW" | "VIRTUAL" | "WHEN" | "WHERE" | "WINDOW" | "WITH" | "WITHOUT";
+/** A single lexer token from {@link tokenize}. */
 export interface Token {
     kind: TokenKind;
     value: string;
@@ -12,6 +14,10 @@ export interface Token {
     start: number;
     end: number;
 }
+/**
+ * Lex `input` into SQLite tokens (keywords, literals, operators, parameters).
+ *
+ * @param input - SQL source text.
+ */
 export declare function tokenize(input: string): Token[];
 export declare function isKeyword(kind: TokenKind): boolean;
-//# sourceMappingURL=tokenize.d.ts.map

package/dist/parser/index.d.ts

@@ -1,5 +1,11 @@
-import type { Statement } from "../ast/nodes.ts";
-export { parseTokens } from "./parser.ts";
-/** Tokenize `sql` and parse all statements (semicolon-separated). */
-export declare function parse(sql: string): Statement[];
-//# sourceMappingURL=index.d.ts.map
+import type { Statement as ParsedStatement } from "../ast/nodes.js";
+/** Parsed SQL statement AST (`SELECT`, `INSERT`, `CREATE TABLE`, …). */
+export type { Statement as ParsedStatement } from "../ast/nodes.js";
+export { parseTokens } from "./parser.js";
+/**
+ * Tokenize `sql` and parse every semicolon-separated statement.
+ *
+ * @param sql - SQLite SQL text.
+ * @returns AST statements in source order.
+ */
+export declare function parse(sql: string): ParsedStatement[];

package/dist/parser/parser.d.ts

@@ -1,5 +1,5 @@
-import type { Expr, SelectStmt, Statement } from "../ast/nodes.ts";
-import type { Token } from "../lexer/tokenize.ts";
+import type { Expr, SelectStmt, Statement } from "../ast/nodes.js";
+import type { Token } from "../lexer/tokenize.js";
 export declare class Parser {
     private readonly tokens;
     private pos;
@@ -67,6 +67,7 @@ export declare class Parser {
     private parseConflictAction;
     private parseFkAction;
     private parseFkActions;
+    private parseDeferrable;
     private parseOrConflict;
     private parseCreateIndex;
     private parseCreateView;
@@ -101,4 +102,3 @@ export declare class Parser {
     private parseFrameBound;
 }
 export declare function parseTokens(tokens: Token[]): Statement[];
-//# sourceMappingURL=parser.d.ts.map

package/dist/planner/access.d.ts

@@ -1,8 +1,8 @@
-import type { Expr, FromItem, TableRef } from "../ast/nodes.ts";
-import type { ExecutionEnv } from "../executor/env.ts";
-import type { Row } from "../storage/row.ts";
-import type { Table } from "../storage/table.ts";
-import type { SqlValue } from "../types/value.ts";
+import type { Expr, FromItem, TableRef } from "../ast/nodes.js";
+import type { ExecutionEnv } from "../executor/env.js";
+import type { Row } from "../storage/row.js";
+import type { Table } from "../storage/table.js";
+import type { SqlValue } from "../types/value.js";
 export interface ConstEquality {
     table: string | null;
     column: string;
@@ -10,6 +10,10 @@ export interface ConstEquality {
 }
 export declare function conjunctions(expr: Expr): Expr[];
 export declare function equalityAgainstConst(expr: Expr): ConstEquality | null;
+export declare function equalityAgainstExpr(expr: Expr): {
+    expr: Expr;
+    valueExpr: Expr;
+} | null;
 export declare function whereFullyCovered(where: Expr, coveredColumns: Set<string>, alias: string, tableName: string): boolean;
 export interface TableRowLookup {
     table: Table;
@@ -21,6 +25,10 @@ export interface TableRowLookup {
 /** Look up rows for a simple `FROM table WHERE ...` using PK, a covering equality index, or an automatic hash. */
 export declare function tryIndexedTableRows(from: FromItem, where: Expr, env: ExecutionEnv): TableRowLookup | null;
 export declare function lookupTableRows(from: TableRef, where: Expr, env: ExecutionEnv): TableRowLookup | null;
+export declare function tryIndexedOrder(from: FromItem, order: {
+    expr: Expr;
+    dir: "ASC" | "DESC";
+}, env: ExecutionEnv, limit?: number): TableRowLookup | null;
 export interface JoinProbe {
     table: Table;
     alias: string;
@@ -40,4 +48,3 @@ export interface JoinEqualityKeys {
 }
 export declare function tryJoinEqualityKeys(right: FromItem, on: Expr | null, env?: ExecutionEnv): JoinEqualityKeys | null;
 export declare function tryJoinProbe(right: FromItem, on: Expr | null, env: ExecutionEnv): JoinProbe | null;
-//# sourceMappingURL=access.d.ts.map

package/dist/planner/index.d.ts

@@ -1,4 +1,3 @@
-import type { Statement } from "../ast/nodes.ts";
+import type { Statement } from "../ast/nodes.js";
 export type Plan = Statement;
 export declare function preparePlan(statement: Statement): Plan;
-//# sourceMappingURL=index.d.ts.map

package/dist/runtime/clock.d.ts

@@ -1,6 +1,12 @@
-/** Fixed reference instant used when callers do not supply a clock. */
+/** Fixed reference instant used when callers do not supply a clock (`2000-01-01T00:00:00.000Z`). */
 export declare const DEFAULT_NOW: Date;
+/** Function that returns the current instant for `date('now')` and related builtins. */
 export type Clock = () => Date;
+/**
+ * Clock that always returns a copy of `instant` (default {@link DEFAULT_NOW}).
+ *
+ * @throws {RangeError} If `instant` is an invalid `Date`.
+ */
 export declare function fixedClock(instant?: Date): Clock;
+/** Normalize a `Date`, {@link Clock}, or `undefined` into a {@link Clock}. */
 export declare function resolveClock(now?: Date | Clock): Clock;
-//# sourceMappingURL=clock.d.ts.map

package/dist/runtime/index.d.ts

@@ -1,4 +1,3 @@
-export { type Clock, DEFAULT_NOW, fixedClock, resolveClock } from "./clock.ts";
-export { type DatabaseOptions, DEFAULT_DATABASE_SEED } from "./options.ts";
-export { deriveSeed, Prng } from "./prng.ts";
-//# sourceMappingURL=index.d.ts.map
+export { type Clock, DEFAULT_NOW, fixedClock, resolveClock } from "./clock.js";
+export { type DatabaseOptions, DEFAULT_DATABASE_SEED } from "./options.js";
+export { deriveSeed, Prng } from "./prng.js";

package/dist/runtime/options.d.ts

@@ -1,9 +1,10 @@
-import type { Clock } from "./clock.ts";
-import type { Prng } from "./prng.ts";
+import type { Clock } from "./clock.js";
+import type { Prng } from "./prng.js";
+/** Options for {@link Database} construction. All fields are optional. */
 export interface DatabaseOptions {
     /**
      * Seed for deterministic `random()` (and any other PRNG-backed builtins).
-     * Defaults to `1`.
+     * Defaults to {@link DEFAULT_DATABASE_SEED} (`1`).
      */
     seed?: number | bigint;
     /**
@@ -15,5 +16,5 @@ export interface DatabaseOptions {
     /** Optional pre-built PRNG (takes precedence over `seed`). */
     prng?: Prng;
 }
+/** Default {@link DatabaseOptions.seed} when constructing a {@link Database}. */
 export declare const DEFAULT_DATABASE_SEED = 1;
-//# sourceMappingURL=options.d.ts.map

package/dist/runtime/prng.d.ts

@@ -4,17 +4,28 @@
  */
 export declare class Prng {
     private state;
+    /**
+     * @param seed - Engine seed. `0` is replaced with a non-zero constant.
+     */
     constructor(seed?: number | bigint);
     /** Next unsigned 64-bit value. */
     nextU64(): bigint;
     /** SQLite `random()` style signed 64-bit integer in [-2^63+1, 2^63-1]. */
     nextSqliteRandom(): bigint;
+    /** Next float in `[0, 1)` from 53 bits of {@link nextU64}. */
     nextFloat(): number;
+    /**
+     * Next integer in `[min, max]` (inclusive).
+     *
+     * @throws {RangeError} If `max < min`.
+     */
     nextInt(min: number, max: number): number;
     /** Current unsigned 64-bit engine state (for snapshot / transaction rollback). */
     getState(): bigint;
+    /** Restore unsigned 64-bit engine state from {@link getState}. */
     setState(state: bigint): void;
+    /** Independent copy with the same engine state. */
     clone(): Prng;
 }
+/** FNV-1a hash of `parts` as a signed 32-bit seed (for tests and custom PRNGs). */
 export declare function deriveSeed(...parts: Array<number | string | bigint>): number;
-//# sourceMappingURL=prng.d.ts.map

package/dist/schema/catalog.d.ts

@@ -1,5 +1,5 @@
-import type { DatabaseState } from "../storage/database-state.ts";
-import { Table } from "../storage/table.ts";
+import type { DatabaseState } from "../storage/database-state.js";
+import { Table } from "../storage/table.js";
 export type SchemaObjectType = "table" | "index" | "view" | "trigger";
 export interface SchemaCatalogRow {
     type: SchemaObjectType;
@@ -12,4 +12,3 @@ export declare function schemaCatalogRows(state: DatabaseState): SchemaCatalogRo
 export declare function buildSchemaCatalog(state: DatabaseState, name?: string): Table;
 export declare function buildSqliteSchema(state: DatabaseState): Table;
 export declare function buildSqliteMaster(state: DatabaseState): Table;
-//# sourceMappingURL=catalog.d.ts.map

package/dist/serialization/codec.d.ts

@@ -1,12 +1,27 @@
-import { DatabaseState } from "../storage/database-state.ts";
+import { DatabaseState } from "../storage/database-state.js";
+/** PRNG + clock captured alongside schema/rows in a v2 snapshot. */
 export interface SnapshotRuntime {
+    /** Unsigned 64-bit {@link Prng} state. */
     prngState: bigint;
+    /** Clock instant as milliseconds since Unix epoch. */
     nowMs: number;
 }
+/** Result of {@link decodeDatabaseState}. */
 export interface DecodedSnapshot {
+    /** Restored catalog and table data. */
     state: DatabaseState;
+    /** Present for v2 snapshots; `null` for v1 (schema/rows only). */
     runtime: SnapshotRuntime | null;
 }
+/**
+ * Encode catalog, rows, and runtime into a sqlite-mem snapshot blob (not a `.sqlite` file).
+ *
+ * Prefer {@link Database.snapshot} unless you are serializing engine state directly.
+ */
 export declare function encodeDatabaseState(state: DatabaseState, runtime: SnapshotRuntime): Uint8Array;
+/**
+ * Decode a blob from {@link encodeDatabaseState} / {@link Database.snapshot}.
+ *
+ * @throws {SqliteError} If the magic, version, or payload is invalid.
+ */
 export declare function decodeDatabaseState(snapshot: Uint8Array): DecodedSnapshot;
-//# sourceMappingURL=codec.d.ts.map

package/dist/serialization/index.d.ts

@@ -1,2 +1 @@
-export { type DecodedSnapshot, decodeDatabaseState, encodeDatabaseState, type SnapshotRuntime, } from "./codec.ts";
-//# sourceMappingURL=index.d.ts.map
+export { type DecodedSnapshot, decodeDatabaseState, encodeDatabaseState, type SnapshotRuntime, } from "./codec.js";

package/dist/storage/database-state.d.ts

@@ -1,9 +1,9 @@
-import type { CreateIndexStmt, CreateTableStmt, CreateViewStmt, CreateVirtualTableStmt, Expr, IndexedColumn, SelectStmt } from "../ast/nodes.ts";
-import { IndexStore } from "../indexes/index.ts";
-import { Fts5VirtualTable } from "../vtable/fts5.ts";
-import { BytecodeVirtualTable, DbStatVirtualTable, FtsVocabVirtualTable, RTreeVirtualTable, TablesUsedVirtualTable } from "../vtable/modules.ts";
-import type { Rowid } from "./row.ts";
-import { Table } from "./table.ts";
+import type { CreateIndexStmt, CreateTableStmt, CreateViewStmt, CreateVirtualTableStmt, Expr, IndexedColumn, SelectStmt } from "../ast/nodes.js";
+import { IndexStore } from "../indexes/index.js";
+import { Fts5VirtualTable } from "../vtable/fts5.js";
+import { BytecodeVirtualTable, DbStatVirtualTable, FtsVocabVirtualTable, RTreeVirtualTable, TablesUsedVirtualTable } from "../vtable/modules.js";
+import type { Rowid } from "./row.js";
+import { Table } from "./table.js";
 export type AnyVirtualTable = Fts5VirtualTable | RTreeVirtualTable | DbStatVirtualTable | BytecodeVirtualTable | TablesUsedVirtualTable | FtsVocabVirtualTable;
 export interface ViewInfo {
     name: string;
@@ -28,10 +28,11 @@ export interface TriggerInfo {
     when: Expr | null;
     forEachRow: boolean;
     /** Statements in the trigger body (already parsed). */
-    body: import("../ast/nodes.ts").Statement[];
+    body: import("../ast/nodes.js").Statement[];
     updateColumns: string[] | null;
     originalSql: string | null;
 }
+/** In-memory catalog: tables, indexes, views, triggers, and mutation counters. */
 export declare class DatabaseState {
     tables: Map<string, Table>;
     virtualTables: Map<string, AnyVirtualTable>;
@@ -74,6 +75,14 @@ export declare class DatabaseState {
     dropTriggersForTable(tableName: string): void;
     recordChange(count: number, lastInsertRowid?: Rowid): void;
     clone(): DatabaseState;
+    /** Share table/index objects with the live state. Callers must freeze first. */
+    cloneShallow(): DatabaseState;
+    freezeShared(): void;
+    thawShared(): void;
+    getWritableTable(name: string): Table;
+    ensureWritableTable(table: Table): Table;
+    getWritableIndex(name: string): IndexInfo;
+    ensureWritableIndex(index: IndexInfo): IndexInfo;
     replaceWith(state: DatabaseState, options?: {
         adopt?: boolean;
     }): void;
@@ -83,4 +92,3 @@ export declare function splitQualifiedName(name: string): {
     schema: string | null;
     bare: string;
 };
-//# sourceMappingURL=database-state.d.ts.map

package/dist/storage/index.d.ts

@@ -1,7 +1,6 @@
-export type { IndexInfo, ViewInfo } from "./database-state.ts";
-export { DatabaseState } from "./database-state.ts";
-export type { Row, Rowid, RowValues } from "./row.ts";
-export { cloneRow, normalizeColumnName, rowValues } from "./row.ts";
-export type { ColumnInfo, InsertRow, TableOptions } from "./table.ts";
-export { makeColumnInfo, Table } from "./table.ts";
-//# sourceMappingURL=index.d.ts.map
+export type { IndexInfo, ViewInfo } from "./database-state.js";
+export { DatabaseState } from "./database-state.js";
+export type { Row, Rowid, RowValues } from "./row.js";
+export { cloneRow, normalizeColumnName, rowValues } from "./row.js";
+export type { ColumnInfo, InsertRow, TableOptions } from "./table.js";
+export { makeColumnInfo, Table } from "./table.js";

package/dist/storage/row.d.ts

@@ -1,4 +1,4 @@
-import type { SqlValue } from "../types/value.ts";
+import type { SqlValue } from "../types/value.js";
 export type Rowid = number | bigint;
 export interface Row {
     rowid: Rowid;
@@ -8,4 +8,3 @@ export type RowValues = Map<string, SqlValue> | ReadonlyMap<string, SqlValue> |
 export declare function normalizeColumnName(name: string): string;
 export declare function rowValues(values: RowValues): Map<string, SqlValue>;
 export declare function cloneRow(row: Row): Row;
-//# sourceMappingURL=row.d.ts.map

package/dist/storage/table.d.ts

@@ -1,6 +1,6 @@
-import type { Expr, TableConstraint } from "../ast/nodes.ts";
-import type { Affinity, SqlValue } from "../types/value.ts";
-import type { Row, Rowid, RowValues } from "./row.ts";
+import type { Expr, TableConstraint } from "../ast/nodes.js";
+import type { Affinity, SqlValue } from "../types/value.js";
+import type { Row, Rowid, RowValues } from "./row.js";
 export interface ColumnInfo {
     name: string;
     /** Cached `name.toLowerCase()` for hot-path lookups. */
@@ -35,6 +35,7 @@ export interface TableOptions {
     indexes?: string[];
     originalSql?: string | null;
     withoutRowid?: boolean;
+    strict?: boolean;
 }
 export declare class Table {
     name: string;
@@ -45,11 +46,13 @@ export declare class Table {
     indexes: string[];
     originalSql: string | null;
     withoutRowid: boolean;
+    strict: boolean;
     /** Clustered PK key string → row for WITHOUT ROWID tables. */
     clusteredRows: Map<string, Row>;
     private scanCache;
     /** Lazy covering hashes: column nameLower → serializeIndexKey → rowids. */
     private equalityHashes;
+    frozen: boolean;
     constructor(name: string, columns: ColumnInfo[], options?: TableOptions);
     integerPkColumn(): ColumnInfo | undefined;
     get(rowid: Rowid): Row | undefined;
@@ -73,6 +76,8 @@ export declare class Table {
     delete(rowid: Rowid): boolean;
     scan(): Iterable<Row>;
     clone(): Table;
+    freeze(): void;
+    private assertMutable;
     /** Rebuild clustered storage after snapshot decode or bulk load. */
     rebuildClusteredRows(): void;
     private prepareValues;
@@ -87,4 +92,3 @@ export declare class Table {
     private advanceNextRowid;
 }
 export declare function makeColumnInfo(name: string, typeName: string | null, options?: Partial<Omit<ColumnInfo, "name" | "nameLower" | "typeName" | "affinity">>): ColumnInfo;
-//# sourceMappingURL=table.d.ts.map

package/dist/transactions/manager.d.ts

@@ -1,5 +1,5 @@
-import type { Prng } from "../runtime/prng.ts";
-import type { DatabaseState } from "../storage/database-state.ts";
+import type { Prng } from "../runtime/prng.js";
+import type { DatabaseState } from "../storage/database-state.js";
 export declare class TransactionManager {
     readonly state: DatabaseState;
     readonly prng: Prng;
@@ -17,4 +17,3 @@ export declare class TransactionManager {
     private findSavepoint;
     private requireTransaction;
 }
-//# sourceMappingURL=manager.d.ts.map

package/dist/types/collation.d.ts

@@ -1,5 +1,4 @@
-import { type SqlValue } from "./value.ts";
+import { type SqlValue } from "./value.js";
 export type BuiltinCollation = "BINARY" | "NOCASE" | "RTRIM";
 export declare function normalizeForCollation(value: SqlValue, name: string): SqlValue;
 export declare function compareWithCollation(a: SqlValue, b: SqlValue, name: string): number | null;
-//# sourceMappingURL=collation.d.ts.map

package/dist/types/strict.d.ts

@@ -0,0 +1,6 @@
+import { type SqlValue } from "./value.js";
+export declare function isStrictTypeName(typeName: string | null | undefined): boolean;
+export declare function applyStrictValue(value: SqlValue, typeName: string, table: string, column: string): SqlValue;
+export declare function unknownStrictType(table: string, column: string, typeName: string): never;
+/** SQLite reports INT for the integer storage class in STRICT errors. */
+export declare function strictStorageLabel(value: SqlValue): string;

package/dist/types/value.d.ts

@@ -1,7 +1,8 @@
-/** SQLite storage classes / SQL values used throughout the engine. */
+/** SQLite storage class of a {@link SqlValue} (`null` / `integer` / `real` / `text` / `blob`). */
 export type StorageClass = "null" | "integer" | "real" | "text" | "blob";
 /** Integer-valued REAL that must not collapse to the integer storage class. */
 export declare class SqlReal {
+    /** IEEE float payload (`-0` already canonicalized to `+0`). */
     readonly value: number;
     constructor(value: number);
     valueOf(): number;
@@ -9,6 +10,7 @@ export declare class SqlReal {
 }
 /** SQLite JSON subtype (74 / 'J') — text that nested JSON APIs treat as JSON, not a string. */
 export declare const JSON_SUBTYPE = 74;
+/** TEXT value with SQLite JSON subtype 74 — nested JSON APIs treat it as JSON, not a string. */
 export declare class SqlJsonText {
     readonly value: string;
     readonly subtype = 74;
@@ -16,37 +18,63 @@ export declare class SqlJsonText {
     valueOf(): string;
     toString(): string;
 }
+/** A SQLite value: NULL, integer/real, text, blob, or a typed REAL/JSON wrapper. */
 export type SqlValue = null | number | bigint | string | Uint8Array | SqlReal | SqlJsonText;
+/**
+ * A value as it appears in query result rows.
+ * {@link SqlReal} and {@link SqlJsonText} wrappers are unwrapped at the JS API surface.
+ */
+export type QueryValue = null | number | bigint | string | Uint8Array;
+/** A result row keyed by column name. Duplicate SELECT names keep the last value. */
+export type QueryRow = Record<string, QueryValue>;
+/**
+ * Values accepted by bind slots (`?`, `?NNN`, `:name`, `@name`, `$name`).
+ * Booleans become integer 0/1; {@link ArrayBuffer} is copied as a BLOB.
+ */
+export type BindValue = SqlValue | boolean | ArrayBuffer;
+/** Column type affinity from a declared type name (SQLite affinity rules). */
 export type Affinity = "TEXT" | "NUMERIC" | "INTEGER" | "REAL" | "BLOB";
 /** Canonicalize IEEE `-0` to `+0` for cross-runtime determinism. */
 export declare function canonicalizeNumber(value: number): number;
+/** Wrap `value` as {@link SqlReal} so it stays REAL even when it is an integer. */
 export declare function asSqlReal(value: number): SqlReal;
+/** `true` when `value` is a {@link SqlReal} wrapper. */
 export declare function isSqlReal(value: SqlValue): value is SqlReal;
+/** `true` when `value` is a {@link SqlJsonText} wrapper. */
 export declare function isSqlJsonText(value: SqlValue): value is SqlJsonText;
+/** Wrap `value` as {@link SqlJsonText} (JSON subtype 74). */
 export declare function asSqlJsonText(value: string): SqlJsonText;
 /** Strip ephemeral JSON subtype for table storage / non-JSON contexts. */
 export declare function unwrapSqlValue(value: SqlValue): SqlValue;
 export declare function subtypeOf(value: SqlValue): number;
 export declare function numberValueOf(value: number | bigint | SqlReal): number;
+/** SQLite storage class of `value` (`null` / `integer` / `real` / `text` / `blob`). */
 export declare function storageClassOf(value: SqlValue): StorageClass;
+/** SQLite `typeof()` string for `value`. */
 export declare function typeofSql(value: SqlValue): string;
 /** Determine column affinity from a declared type name (SQLite rules). */
 export declare function affinityFromTypeName(typeName: string | null | undefined): Affinity;
+/** Apply column {@link Affinity} conversion rules to `value`. */
 export declare function applyAffinity(value: SqlValue, affinity: Affinity): SqlValue;
+/** Parse `value` as a number, or `null` when it is not numeric. */
 export declare function coerceToNumber(value: SqlValue): number | null;
+/** Truncate `value` toward zero as an integer, or `null` when it is not numeric. */
 export declare function toInteger(value: SqlValue): number | bigint | null;
+/** SQLite `=` / `IS` equality for two non-NULL values (`NULL = NULL` is false here). */
 export declare function sqlValueEquals(a: SqlValue, b: SqlValue): boolean;
 /**
  * SQLite comparison for ORDER BY / inequalities.
  * Returns -1, 0, 1, or null if either side is NULL (SQL NULL).
  */
 export declare function compareSql(a: SqlValue, b: SqlValue): number | null;
+/** UTF-8 encode `s` (SQLite TEXT → BLOB). */
 export declare function utf8Encode(s: string): Uint8Array;
+/** UTF-8 decode `b` (SQLite BLOB → TEXT). */
 export declare function utf8Decode(b: Uint8Array): string;
+/** Deep-copy blobs and REAL/JSON wrappers; primitives are returned as-is. */
 export declare function cloneSqlValue(v: SqlValue): SqlValue;
 /**
  * SQLite boolean truthiness (WHERE / HAVING / CASE / AND / OR / NOT).
  * Non-NULL values are cast to numeric; non-numeric text/blob become 0 (false).
  */
 export declare function isTruthySql(v: SqlValue): boolean | null;
-//# sourceMappingURL=value.d.ts.map

package/dist/vtable/fts/options.d.ts

@@ -32,4 +32,3 @@ export interface FtsTableOptions {
     notindexed: Set<string>;
 }
 export declare function parseFtsModuleArgs(moduleArgs: string[], kind: FtsKind): FtsTableOptions;
-//# sourceMappingURL=options.d.ts.map

package/dist/vtable/fts/porter.d.ts

@@ -1,3 +1,2 @@
 /** Classic Porter stemming algorithm (English). */
 export declare function porterStem(word: string): string;
-//# sourceMappingURL=porter.d.ts.map

package/dist/vtable/fts/query.d.ts

@@ -37,4 +37,3 @@ export type FtsQueryNode = {
 export declare function parseFts5Query(input: string): FtsQueryNode;
 /** FTS3/4 query parser (ENABLE_FTS3_PARENTHESIS style). */
 export declare function parseFts3Query(input: string): FtsQueryNode;
-//# sourceMappingURL=query.d.ts.map