@crvouga/sqlite-mem 1.0.0 → 1.1.1

package/README.md

@@ -216,7 +216,7 @@ Goal: drop-in SQL behavior vs SQLite **3.51.0**. Full matrix: [COMPATIBILITY.md]
 - FTS3/4/5 — largely implemented; shadow-table change counters intentionally diverge; some edges partial
 - `EXPLAIN` / `EXPLAIN QUERY PLAN` — stub shapes, not real bytecode
 - `INDEXED BY` / `NOT INDEXED` — parsed and discarded
-- Unknown `PRAGMA` succeeds with an empty result (SQLite-like); storage/journal/WAL pragmas N/A or no-op
+- Unknown statement `PRAGMA` succeeds with an empty result (SQLite-like). All oracle-exposed `pragma_*` eponymous TVFs are supported (`SELECT * FROM pragma_table_info('t')`, bare `FROM pragma_database_list`, …), including **correlated** args such as `FROM table_list AS tl, pragma_table_info(tl.name) AS p` (Kysely SQLite introspector). Storage/journal getters return bun `:memory:`-compatible defaults.
 
 ## Common pitfalls
 

package/dist/executor/pragma-engine.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Shared PRAGMA query engine used by statement-form `PRAGMA …` and `pragma_*` TVFs.
+ */
+import type { Expr } from "../ast/nodes.js";
+import { type SqlValue } from "../types/value.js";
+import type { ExecutionEnv } from "./env.js";
+export interface PragmaQueryResult {
+    columns: string[];
+    rows: SqlValue[][];
+}
+/** Oracle-exposed pragma_* TVF base names (without the `pragma_` prefix). */
+export declare const PRAGMA_TVF_NAMES: readonly ["analysis_limit", "application_id", "auto_vacuum", "automatic_index", "busy_timeout", "cache_size", "cache_spill", "cell_size_check", "checkpoint_fullfsync", "collation_list", "compile_options", "count_changes", "data_version", "database_list", "default_cache_size", "defer_foreign_keys", "empty_result_callbacks", "encoding", "foreign_key_check", "foreign_key_list", "foreign_keys", "freelist_count", "full_column_names", "fullfsync", "function_list", "hard_heap_limit", "ignore_check_constraints", "index_info", "index_list", "index_xinfo", "integrity_check", "journal_mode", "journal_size_limit", "legacy_alter_table", "locking_mode", "max_page_count", "module_list", "optimize", "page_count", "page_size", "pragma_list", "query_only", "quick_check", "read_uncommitted", "recursive_triggers", "reverse_unordered_selects", "schema_version", "secure_delete", "short_column_names", "soft_heap_limit", "synchronous", "table_info", "table_list", "table_xinfo", "temp_store", "threads", "trusted_schema", "user_version", "writable_schema"];
+/** Full pragma name list for `pragma_pragma_list` (includes names without TVFs). */
+export declare const PRAGMA_LIST_NAMES: string[];
+export declare function isPragmaTvfName(name: string): boolean;
+/**
+ * Column names for a pragma_* TVF without evaluating arguments.
+ * Used by SELECT shape analysis so correlated args (e.g. `tl.name`) are not
+ * resolved before the outer row is bound.
+ */
+export declare function pragmaTvfColumns(name: string): string[] | null;
+/**
+ * Query a pragma by name with optional SQL values (TVF args or evaluated statement args).
+ * Read-only — writers stay in {@link executePragma}.
+ */
+export declare function queryPragma(name: string, args: readonly SqlValue[], env: ExecutionEnv): PragmaQueryResult;
+/** Evaluate a statement-form pragma argument expression to a SQL value list. */
+export declare function evalPragmaArgs(expr: Expr | null, env: ExecutionEnv): SqlValue[];
+export declare function evalPragmaSetValue(expr: Expr, env: ExecutionEnv): SqlValue;
+export declare function coercePragmaInt(value: SqlValue): number;
+export declare function coercePragmaTruthy(value: SqlValue): boolean;

package/dist/functions/pragma-tvf.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Register all oracle-exposed `pragma_*` eponymous table-valued functions.
+ * Imported for side effects from table-valued / select.
+ */
+import { isPragmaTvfName } from "../executor/pragma-engine.js";
+/** Idempotent registration of every oracle `pragma_*` TVF. */
+export declare function ensurePragmaTvfsRegistered(): void;
+export { isPragmaTvfName };

package/dist/functions/table-valued-registry.d.ts

@@ -0,0 +1,11 @@
+import type { ExecutionEnv, ScopeRow } from "../executor/env.js";
+import type { SqlValue } from "../types/value.js";
+export interface TableValuedResult {
+    columns: string[];
+    rows: ScopeRow[];
+}
+export type TableValuedFn = (args: SqlValue[], alias: string | null, env: ExecutionEnv) => TableValuedResult;
+export declare function registerTableValuedFunction(name: string, fn: TableValuedFn): void;
+export declare function getTableValuedFunction(name: string): TableValuedFn | undefined;
+export declare function listRegisteredTableValuedFunctions(): string[];
+export declare function hasRegisteredTableValuedFunction(name: string): boolean;

package/dist/functions/table-valued.d.ts

@@ -1,8 +1,13 @@
 import type { Expr } from "../ast/nodes.js";
 import type { ExecutionEnv, ScopeRow } from "../executor/env.js";
-export interface TableValuedResult {
-    columns: string[];
-    rows: ScopeRow[];
-}
+import { registerTableValuedFunction, type TableValuedResult } from "./table-valued-registry.js";
+export type { TableValuedResult };
+export { registerTableValuedFunction };
+/**
+ * Known output columns for a TVF without evaluating arguments.
+ * Prefer this for FROM-item shape analysis when args may be correlated.
+ */
+export declare function tableValuedColumns(name: string): string[] | null;
 export declare function evaluateTableFunction(name: string, args: Expr[], alias: string | null, env: ExecutionEnv, scope?: ScopeRow | null, parent?: import("../expressions/context.js").EvalContext): TableValuedResult;
 export declare function listTableValuedFunctions(): string[];
+export declare function hasTableValuedFunction(name: string): boolean;