@crvouga/sqlite-mem 1.1.2 → 1.3.0

package/dist/parser/index.d.ts

@@ -1,7 +1,9 @@
 import type { Statement as ParsedStatement } from "../ast/nodes.js";
+import { type ParsedUnit } from "./parser.js";
 /** Parsed SQL statement AST (`SELECT`, `INSERT`, `CREATE TABLE`, …). */
 export type { Statement as ParsedStatement } from "../ast/nodes.js";
-export { parseTokens } from "./parser.js";
+export type { ParsedUnit } from "./parser.js";
+export { parseTokens, parseTokenUnits } from "./parser.js";
 /**
  * Tokenize `sql` and parse every semicolon-separated statement.
  *
@@ -9,3 +11,7 @@ export { parseTokens } from "./parser.js";
  * @returns AST statements in source order.
  */
 export declare function parse(sql: string): ParsedStatement[];
+/**
+ * Parse SQL into AST + per-statement source slices (for `sqlite_master.sql`).
+ */
+export declare function parseUnits(sql: string): ParsedUnit[];

package/dist/parser/parser.d.ts

@@ -1,9 +1,15 @@
-import type { Expr, SelectStmt, Statement } from "../ast/nodes.js";
+import type { Expr, SelectStmt, Statement, WithClause } from "../ast/nodes.js";
 import type { Token } from "../lexer/tokenize.js";
+export interface ParsedUnit {
+    statement: Statement;
+    /** Source slice for this statement (no trailing semicolon); used for sqlite_master.sql. */
+    sql: string;
+}
 export declare class Parser {
     private readonly tokens;
+    private readonly source;
     private pos;
-    constructor(tokens: Token[]);
+    constructor(tokens: Token[], source?: string);
     private current;
     private peek;
     private at;
@@ -20,13 +26,15 @@ export declare class Parser {
     private parseDetachStmt;
     private optionalAlias;
     parseStatements(): Statement[];
+    /** Parse statements with per-statement source slices for catalog `sql` text. */
+    parseUnits(): ParsedUnit[];
     parseStatement(): Statement;
     private parseAnalyzeStmt;
     private parseReindexStmt;
     private parseVacuumStmt;
     private parseWithClause;
     private parseOptionalWith;
-    parseSelectStmt(): SelectStmt;
+    parseSelectStmt(withClause?: WithClause | null): SelectStmt;
     private parseSelectCore;
     private parseCompoundTail;
     private parseResultColumns;
@@ -101,4 +109,6 @@ export declare class Parser {
     private parseFrameSpec;
     private parseFrameBound;
 }
-export declare function parseTokens(tokens: Token[]): Statement[];
+export declare function parseTokens(tokens: Token[], source?: string): Statement[];
+/** Parse SQL into AST statements paired with source slices. */
+export declare function parseTokenUnits(tokens: Token[], source: string): ParsedUnit[];

package/dist/runtime/clock.d.ts

@@ -8,5 +8,7 @@ export type Clock = () => Date;
  * @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;
+/** Wall-clock `'now'` matching SQLite (`new Date()` each call). */
+export declare function systemClock(): Clock;
+/** Normalize a `Date`, {@link Clock}, `"system"`, or `undefined` into a {@link Clock}. */
+export declare function resolveClock(now?: Date | Clock | "system"): Clock;

package/dist/runtime/index.d.ts

@@ -1,3 +1,3 @@
-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";
+export { type Clock, DEFAULT_NOW, fixedClock, resolveClock, systemClock } from "./clock.js";
+export { type DatabaseOptions, DEFAULT_DATABASE_SEED, type RandomMode } from "./options.js";
+export { deriveSeed, OsEntropy, Prng } from "./prng.js";

package/dist/runtime/options.d.ts

@@ -1,17 +1,25 @@
 import type { Clock } from "./clock.js";
+/** Entropy source for `random()` / `randomblob()`. Default is seeded xorshift64*. */
+export type RandomMode = "deterministic" | "os";
 /** Options for {@link Database} construction. All fields are optional. */
 export interface DatabaseOptions {
     /**
      * Seed for deterministic `random()` (and any other PRNG-backed builtins).
-     * Defaults to {@link DEFAULT_DATABASE_SEED} (`1`).
+     * Defaults to {@link DEFAULT_DATABASE_SEED} (`1`). Ignored when {@link random} is `"os"`.
      */
     seed?: number | bigint;
+    /**
+     * Entropy for `random()` / `randomblob()`.
+     * `"deterministic"` (default) uses {@link seed}. `"os"` uses CSPRNG like SQLite
+     * (not rolled back with transactions; not restored from snapshots).
+     */
+    random?: RandomMode;
     /**
      * Clock for `date('now')` / `datetime('now')` / etc.
      * Defaults to a fixed instant (`2000-01-01T00:00:00.000Z`).
-     * Pass a `Date` or `() => Date` to override.
+     * Pass a `Date`, `() => Date`, or `"system"` for wall-clock `'now'` like SQLite.
      */
-    now?: Date | Clock;
+    now?: Date | Clock | "system";
 }
 /** Default {@link DatabaseOptions.seed} when constructing a {@link Database}. */
 export declare const DEFAULT_DATABASE_SEED = 1;

package/dist/runtime/prng.d.ts

@@ -27,5 +27,16 @@ export declare class Prng {
     /** Independent copy with the same engine state. */
     clone(): Prng;
 }
+/**
+ * CSPRNG-backed entropy for `random()` / `randomblob()` when {@link DatabaseOptions.random}
+ * is `"os"`. `setState` is a no-op so ROLLBACK / snapshot restore do not rewind draws.
+ */
+export declare class OsEntropy extends Prng {
+    constructor();
+    nextU64(): bigint;
+    getState(): bigint;
+    setState(_state: bigint): void;
+    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;

package/dist/schema/master-sql.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Normalize CREATE source toward SQLite's `sqlite_master.sql` conventions:
+ * strip TEMP/TEMPORARY, IF NOT EXISTS, and schema qualifiers on the object name.
+ * Body text (from after the object name) is preserved byte-for-byte from the input.
+ */
+export declare function normalizeMasterSql(sql: string): string;
+/** Append an ALTER TABLE ADD COLUMN definition into CREATE TABLE master sql (SQLite style). */
+export declare function appendAddColumnToMasterSql(originalSql: string | null, alterSql: string | null): string | null;
+/** Synthesize CTAS catalog SQL: `CREATE TABLE name(col1, col2, ...)`. */
+export declare function synthesizeCtasMasterSql(tableName: string, columnNames: string[]): string;

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

@@ -48,6 +48,8 @@ export declare class DatabaseState {
     changes: number;
     totalChanges: number;
     foreignKeysEnabled: boolean;
+    /** When true, LIKE / like() are case-sensitive (SQLite `PRAGMA case_sensitive_like`). */
+    caseSensitiveLike: boolean;
     schemaVersion: number;
     userVersion: number;
     databaseForSchema(schema: string | null, qualifiedForError?: string): DatabaseState;

package/dist/storage/table.d.ts

@@ -52,6 +52,8 @@ export declare class Table {
     private scanCache;
     /** Lazy covering hashes: column nameLower → serializeIndexKey → rowids. */
     private equalityHashes;
+    /** Cached maximum rowid. `undefined` means recompute after deleting the maximum. */
+    private maximumRowid;
     frozen: boolean;
     constructor(name: string, columns: ColumnInfo[], options?: TableOptions);
     integerPkColumn(): ColumnInfo | undefined;

package/dist/types/value.d.ts

@@ -56,6 +56,11 @@ export declare function typeofSql(value: SqlValue): string;
 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;
+/**
+ * Apply SQLite comparison affinity rules before comparing two values.
+ * A null affinity represents an expression with no affinity.
+ */
+export declare function applyComparisonAffinity(left: SqlValue, right: SqlValue, leftAffinity: Affinity | null, rightAffinity: Affinity | null): [SqlValue, 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. */

package/dist/unstable.d.ts

@@ -12,9 +12,9 @@ export type { Expr } from "./ast/nodes.js";
 export type { EvalContext } from "./expressions/context.js";
 export { evalExpr } from "./expressions/eval.js";
 export { globMatch, likeMatch } from "./expressions/like.js";
-export { tokenize, type Token, type TokenKind } from "./lexer/tokenize.js";
-export { parse, type ParsedStatement } from "./parser/index.js";
-export { type Clock, DEFAULT_DATABASE_SEED, DEFAULT_NOW, deriveSeed, fixedClock, Prng, resolveClock, } from "./runtime/index.js";
+export { type Token, type TokenKind, tokenize } from "./lexer/tokenize.js";
+export { type ParsedStatement, parse } from "./parser/index.js";
+export { type Clock, DEFAULT_DATABASE_SEED, DEFAULT_NOW, deriveSeed, fixedClock, OsEntropy, Prng, type RandomMode, resolveClock, systemClock, } from "./runtime/index.js";
 export { type DecodedSnapshot, decodeDatabaseState, encodeDatabaseState, type SnapshotRuntime, } from "./serialization/index.js";
 export type { DatabaseState } from "./storage/database-state.js";
 export { type Affinity, affinityFromTypeName, applyAffinity, asSqlJsonText, asSqlReal, canonicalizeNumber, cloneSqlValue, coerceToNumber, compareSql, isSqlJsonText, isSqlReal, isTruthySql, SqlJsonText, SqlReal, type SqlValue, type StorageClass, sqlValueEquals, storageClassOf, toInteger, typeofSql, utf8Decode, utf8Encode, } from "./types/value.js";