@crvouga/sqlite-mem 1.1.1 → 1.2.0

package/dist/lexer/tokenize.d.ts

@@ -1,5 +1,5 @@
 /** 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";
+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" | "FALSE" | "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" | "TRUE" | "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;

package/dist/parser/parser.d.ts

@@ -1,4 +1,4 @@
-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 declare class Parser {
     private readonly tokens;
@@ -26,7 +26,7 @@ export declare class Parser {
     private parseVacuumStmt;
     private parseWithClause;
     private parseOptionalWith;
-    parseSelectStmt(): SelectStmt;
+    parseSelectStmt(withClause?: WithClause | null): SelectStmt;
     private parseSelectCore;
     private parseCompoundTail;
     private parseResultColumns;

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/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";