@crvouga/sqlite-mem 1.1.2 → 1.3.0

package/compat/smoke-baseline.json

@@ -0,0 +1,15 @@
+{
+  "ids": [
+    "CON-fk-09",
+    "DDL-auto-03",
+    "FTS-series-01",
+    "LIM-vals-01",
+    "PRG-beh-01",
+    "PRG-beh-02",
+    "PRG-beh-03",
+    "PRG-beh-04",
+    "PRG-beh-05",
+    "PRG-beh-06",
+    "PRG-beh-07"
+  ]
+}

package/dist/api/database.d.ts

@@ -1,4 +1,4 @@
-import { type DatabaseOptions } from "../runtime/index.js";
+import { type DatabaseOptions, type RandomMode } from "../runtime/index.js";
 import type { BindValue, QueryRow } from "../types/value.js";
 import { Statement } from "./statement.js";
 /**
@@ -6,7 +6,8 @@ import { Statement } from "./statement.js";
  *
  * Deterministic by default: `random()` / `randomblob()` use a seeded PRNG
  * (`seed` defaults to `1`) and `date('now')` / friends use a fixed clock
- * (`2000-01-01T00:00:00.000Z`). There is no filesystem or WASM.
+ * (`2000-01-01T00:00:00.000Z`). Pass `{ random: "os" }` and `{ now: "system" }`
+ * for SQLite-like CSPRNG and wall-clock `'now'`. There is no filesystem or WASM.
  *
  * @example
  * ```ts
@@ -19,8 +20,10 @@ import { Statement } from "./statement.js";
  * ```
  */
 export declare class Database {
-    /** Seed used to construct the PRNG. */
+    /** Seed used to construct the PRNG. Ignored when {@link randomMode} is `"os"`. */
     readonly seed: number | bigint;
+    /** Entropy mode for `random()` / `randomblob()`. */
+    readonly randomMode: RandomMode;
     private closed;
     private transactionSequence;
     /** Depth of active {@link transaction} callbacks (not SQL BEGIN). */
@@ -106,6 +109,12 @@ export declare class Database {
      * @throws {SqliteError} If the database is closed.
      */
     get lastInsertRowid(): number | bigint;
+    /**
+     * Cumulative rows changed by INSERT / UPDATE / DELETE (SQLite `total_changes()`).
+     *
+     * @throws {SqliteError} If the database is closed.
+     */
+    get totalChanges(): number;
     private prepareSingle;
 }
 export type { DatabaseOptions };

package/dist/api/statement.d.ts

@@ -1,4 +1,4 @@
-import type { ResultSet } from "../executor/result.js";
+import { type ResultSet } from "../executor/result.js";
 import type { BindValue, QueryRow } from "../types/value.js";
 /** Mutation counters returned by {@link Statement.run}. */
 export interface RunResult {
@@ -31,6 +31,7 @@ export declare class Statement {
     private namedPlan;
     private env;
     private statements;
+    private statementSqls;
     private schemaVersion;
     private constructor();
     /**

package/dist/ast/nodes.d.ts

@@ -62,6 +62,7 @@ export interface FunctionExpr {
     name: string;
     distinct: boolean;
     args: Expr[] | "*";
+    orderBy: OrderByItem[];
     filter: Expr | null;
 }
 export interface AggregateExpr {
@@ -69,6 +70,7 @@ export interface AggregateExpr {
     name: string;
     distinct: boolean;
     args: Expr[] | "*";
+    orderBy: OrderByItem[];
     filter: Expr | null;
 }
 export interface WindowExpr {
@@ -192,6 +194,7 @@ export interface WithClause {
 export interface Cte {
     name: string;
     columns: string[] | null;
+    materialized: "materialized" | "not_materialized" | null;
     select: SelectStmt;
 }
 export type ResultColumn = {

package/dist/executor/env.d.ts

@@ -4,8 +4,8 @@ import { type FunctionRegistry } from "../functions/registry.js";
 import type { DatabaseState } from "../storage/database-state.js";
 import type { Rowid } from "../storage/row.js";
 import type { TransactionManager } from "../transactions/manager.js";
-import type { ResultSet } from "./result.js";
 import { type Affinity, type SqlValue } from "../types/value.js";
+import type { ResultSet } from "./result.js";
 export interface Cell {
     table: string | null;
     tableLower?: string | null;
@@ -51,6 +51,8 @@ export declare class ExecutionEnv {
     maxRows: number;
     includeNamedRows: boolean;
     includeValues: boolean;
+    /** Source text of the statement currently executing (for sqlite_master.sql). */
+    statementSql: string | null;
     constructor(state: DatabaseState, transactions: TransactionManager, params?: readonly unknown[], functions?: FunctionRegistry, hooks?: ExecutionHooks);
     reset(params: readonly unknown[]): void;
     getBoundParameter(name: string | number): SqlValue;

package/dist/executor/select.d.ts

@@ -1,6 +1,7 @@
-import type { FromItem, SelectStmt } from "../ast/nodes.js";
+import type { FromItem, SelectStmt, WithClause } from "../ast/nodes.js";
 import type { EvalContext } from "../expressions/context.js";
 import type { ExecutionEnv, ScopeRow } from "./env.js";
 import { type ResultSet } from "./result.js";
 export declare function executeSelect(stmt: SelectStmt, env: ExecutionEnv, parent?: EvalContext): ResultSet;
+export declare function executeWith(withClause: WithClause, env: ExecutionEnv, parent?: EvalContext): void;
 export declare function scanFrom(item: FromItem, env: ExecutionEnv, parent?: EvalContext): ScopeRow[];

package/dist/executor/triggers.d.ts

@@ -7,5 +7,5 @@ import { type ResultSet } from "./result.js";
 export declare function executeCreateTrigger(stmt: CreateTriggerStmt, env: ExecutionEnv): ResultSet;
 export declare function executeDropTrigger(stmt: DropTriggerStmt, env: ExecutionEnv): ResultSet;
 export declare function fireInsertTriggers(timing: "BEFORE" | "AFTER" | "INSTEAD", table: Table, values: Map<string, SqlValue>, oldRow: Row | null, env: ExecutionEnv): "ok" | "ignore";
-export declare function fireUpdateTriggers(timing: "BEFORE" | "AFTER", table: Table, oldRow: Row, newValues: Map<string, SqlValue>, updatedColumns: Set<string>, env: ExecutionEnv): "ok" | "ignore";
-export declare function fireDeleteTriggers(timing: "BEFORE" | "AFTER", table: Table, oldRow: Row, env: ExecutionEnv): "ok" | "ignore";
+export declare function fireUpdateTriggers(timing: "BEFORE" | "AFTER" | "INSTEAD", table: Table, oldRow: Row, newValues: Map<string, SqlValue>, updatedColumns: Set<string>, env: ExecutionEnv): "ok" | "ignore";
+export declare function fireDeleteTriggers(timing: "BEFORE" | "AFTER" | "INSTEAD", table: Table, oldRow: Row, env: ExecutionEnv): "ok" | "ignore";

package/dist/expressions/context.d.ts

@@ -1,11 +1,13 @@
 import type { SelectStmt } from "../ast/nodes.js";
 import type { FunctionContext, FunctionRegistry } from "../functions/registry.js";
-import type { SqlValue, StorageClass } from "../types/value.js";
+import type { Affinity, SqlValue, StorageClass } from "../types/value.js";
 import type { FtsMatchCursor } from "../vtable/fts5.js";
 /** Column / parameter / function resolution used by {@link evalExpr}. */
 export interface EvalContext {
     resolveColumn(table: string | null, name: string): SqlValue;
     resolveStorageClass?(table: string | null, name: string): StorageClass;
+    /** Declared column affinity when available (for comparisons). */
+    resolveAffinity?(table: string | null, name: string): Affinity | null;
     /** Declared column collation when available (for inheritance). */
     resolveCollation?(table: string | null, name: string): string | null;
     getParameter(name: string | number): SqlValue;

package/dist/expressions/like.d.ts

@@ -1,11 +1,12 @@
 /**
- * SQLite LIKE matching. ASCII letters are case-insensitive.
+ * SQLite LIKE matching. ASCII letters are case-insensitive unless `caseSensitive`.
  *
  * @param text - Value to test.
  * @param pattern - Pattern with `%` / `_` wildcards.
  * @param escape - Optional single-character ESCAPE (or `null`).
+ * @param caseSensitive - When true, match like GLOB (SQLite `PRAGMA case_sensitive_like=ON`).
  */
-export declare function likeMatch(text: string, pattern: string, escape?: string | null): boolean;
+export declare function likeMatch(text: string, pattern: string, escape?: string | null, caseSensitive?: boolean): boolean;
 /**
  * SQLite GLOB matching. GLOB is case-sensitive and uses Unix `*` / `?` wildcards.
  *

package/dist/functions/registry.d.ts

@@ -12,6 +12,8 @@ export interface FunctionContext {
     randomU64?: () => bigint;
     /** Active FTS MATCH cursor when evaluating projections with MATCH in WHERE. */
     ftsMatch?: import("../vtable/fts5.js").FtsMatchCursor | null;
+    /** SQLite `PRAGMA case_sensitive_like` for LIKE / like(). */
+    caseSensitiveLike?: boolean;
     /** Current rowid for FTS aux defaults when MATCH is absent. */
     ftsRowid?: import("../storage/row.js").Rowid;
     /** Source FTS table name for the current scan row. */

package/dist/index.d.ts

@@ -3,6 +3,7 @@
  * Pure TypeScript in-memory SQLite. Import {@link Database} to get started.
  *
  * Deterministic by default (`random()` seed `1`, `'now'` = `2000-01-01T00:00:00.000Z`).
+ * Pass `{ random: "os" }` / `{ now: "system" }` for SQLite-like entropy and wall clock.
  * Zero WASM, native bindings, or filesystem.
  *
  * Advanced / internal helpers live under `@crvouga/sqlite-mem/unstable` and are
@@ -21,7 +22,7 @@
  * @module
  */
 export { Database, type DatabaseOptions } from "./api/database.js";
-export { Statement, type RunResult } from "./api/statement.js";
-export { SqliteError, type ErrorCategory } from "./errors/index.js";
+export { type RunResult, Statement } from "./api/statement.js";
+export { type ErrorCategory, SqliteError } from "./errors/index.js";
 export type { ResultSet } from "./executor/result.js";
 export type { BindValue, QueryRow, QueryValue } from "./types/value.js";