@crvouga/mockingbird-service-postgres 1.3.1 → 1.5.0

package/dist/api/database.d.ts

@@ -2,10 +2,27 @@ import { type DatabaseOptions, type Int8Mode, type RandomMode } from "../runtime
 import type { BindValue, JsValue, QueryRow } from "./bind.js";
 import { type Snapshot } from "./snapshot.js";
 import { Statement } from "./statement.js";
+/** A timeline checkpoint without its retained snapshot value. */
+export interface HistoryCheckpoint {
+    id: string;
+    branch: string;
+    parent: string | null;
+    at: number;
+}
+/** Branch heads and checkpoints owned by the shared Timeline. */
+export interface DatabaseHistory {
+    readonly size: number;
+    head(branch?: string): HistoryCheckpoint | undefined;
+    branches(): Readonly<Record<string, string>>;
+    checkpoints(): readonly HistoryCheckpoint[];
+}
 /** Additive time-travel controls for read APIs. */
 export interface QueryOptions {
-    /** Execute against this immutable checkpoint instead of the live database. */
-    at?: Snapshot;
+    /**
+     * Execute against this immutable snapshot, or a timeline checkpoint id,
+     * instead of the live database.
+     */
+    at?: Snapshot | string;
 }
 /**
  * Pure TypeScript in-memory PostgreSQL database.
@@ -35,6 +52,8 @@ export declare class Database {
     private closed;
     private transactionSequence;
     private apiTransactionDepth;
+    private historyBranch;
+    private originId;
     constructor(options?: DatabaseOptions);
     /**
      * Execute SQL for its side effects. Multiple semicolon-separated statements
@@ -65,6 +84,19 @@ export declare class Database {
     snapshot(): Snapshot;
     /** Alias for {@link snapshot}, naming the value as a timeline checkpoint. */
     checkpoint(): Snapshot;
+    /**
+     * Commit the live state onto `branch` (default: the branch this database follows).
+     * Does not switch the live database. Illegal inside a transaction.
+     */
+    record(branch?: string): HistoryCheckpoint;
+    /** Point `name` at a checkpoint without copying rows or switching the live database. */
+    fork(name: string, at?: string): HistoryCheckpoint;
+    /** Move `branch` to `id` and install that checkpoint as the live database. */
+    checkout(id: string, branch?: string): HistoryCheckpoint;
+    /** Return the live database to the origin checkpoint on `main`. */
+    reset(): HistoryCheckpoint;
+    /** Checkpoint ids and branch heads. Values stay inside the timeline. */
+    get history(): DatabaseHistory;
     /** Open a copy-on-write branch from `at`, or from the current state when omitted. */
     branch(at?: Snapshot): Database;
     /** Close the database. Further SQL throws. Idempotent. */
@@ -82,6 +114,9 @@ export declare class Database {
     copyFrom(sql: string, data: string): number;
     /** Rows affected by the most recent INSERT / UPDATE / DELETE. */
     get changes(): number;
+    private historyError;
+    private captureLive;
+    private install;
     private prepareSingle;
 }
 export { Snapshot } from "./snapshot.js";

package/dist/ast/nodes.d.ts

@@ -501,7 +501,8 @@ export interface CreateIndexStmt {
         expr: Expr;
         dir: "asc" | "desc" | null;
         nulls: "first" | "last" | null;
-        opclass: string | null;
+        /** Operator class name, possibly schema-qualified (`public.gin_trgm_ops`). */
+        opclass: string[] | null;
     }>;
     readonly include: string[];
     readonly where: Expr | null;
@@ -547,6 +548,14 @@ export interface CreateSchemaStmt {
     readonly name: string;
     readonly ifNotExists: boolean;
 }
+export interface CreateExtensionStmt {
+    readonly type: "create_extension";
+    readonly name: string;
+    readonly ifNotExists: boolean;
+    readonly schema: string | null;
+    readonly version: string | null;
+    readonly cascade: boolean;
+}
 export interface CreateEnumStmt {
     readonly type: "create_enum";
     readonly name: string[];
@@ -809,4 +818,4 @@ export interface DoStmt {
     readonly language: string;
     readonly body: string;
 }
-export type Statement = SelectStmt | InsertStmt | UpdateStmt | DeleteStmt | CreateTableStmt | CreateTableAsStmt | CreateIndexStmt | CreateViewStmt | CreateSequenceStmt | AlterSequenceStmt | CreateSchemaStmt | CreateEnumStmt | AlterEnumStmt | CreateDomainStmt | CreateFunctionStmt | CreateTriggerStmt | AlterTableStmt | AlterViewStmt | AlterIndexStmt | AlterSchemaStmt | DropStmt | TruncateStmt | RefreshMaterializedViewStmt | TransactionStmt | SetStmt | ShowStmt | ResetStmt | PrepareStmt | ExecuteStmt | DeallocateStmt | ExplainStmt | CopyStmt | CommentStmt | NoOpStmt | DoStmt;
+export type Statement = SelectStmt | InsertStmt | UpdateStmt | DeleteStmt | CreateTableStmt | CreateTableAsStmt | CreateIndexStmt | CreateViewStmt | CreateSequenceStmt | AlterSequenceStmt | CreateSchemaStmt | CreateExtensionStmt | CreateEnumStmt | AlterEnumStmt | CreateDomainStmt | CreateFunctionStmt | CreateTriggerStmt | AlterTableStmt | AlterViewStmt | AlterIndexStmt | AlterSchemaStmt | DropStmt | TruncateStmt | RefreshMaterializedViewStmt | TransactionStmt | SetStmt | ShowStmt | ResetStmt | PrepareStmt | ExecuteStmt | DeallocateStmt | ExplainStmt | CopyStmt | CommentStmt | NoOpStmt | DoStmt;

package/dist/executor/ddl.d.ts

@@ -1,4 +1,4 @@
-import type { AlterEnumStmt, AlterIndexStmt, AlterSchemaStmt, AlterSequenceStmt, AlterTableStmt, AlterViewStmt, CreateDomainStmt, CreateEnumStmt, CreateFunctionStmt, CreateIndexStmt, CreateSchemaStmt, CreateSequenceStmt, CreateTableAsStmt, CreateTableStmt, CreateTriggerStmt, CreateViewStmt, DropStmt, RefreshMaterializedViewStmt, SequenceOptions, TruncateStmt } from "../ast/nodes.js";
+import type { AlterEnumStmt, AlterIndexStmt, AlterSchemaStmt, AlterSequenceStmt, AlterTableStmt, AlterViewStmt, CreateDomainStmt, CreateEnumStmt, CreateExtensionStmt, CreateFunctionStmt, CreateIndexStmt, CreateSchemaStmt, CreateSequenceStmt, CreateTableAsStmt, CreateTableStmt, CreateTriggerStmt, CreateViewStmt, DropStmt, RefreshMaterializedViewStmt, SequenceOptions, TruncateStmt } from "../ast/nodes.js";
 import { SchemaData, type SequenceData } from "../storage/database-state.js";
 import { type ExecEnv, type ExecResult } from "./relation.js";
 export declare function buildSequence(env: ExecEnv, schema: SchemaData, name: string, options: SequenceOptions, temp: boolean): SequenceData;
@@ -9,6 +9,7 @@ export declare function executeCreateTableAs(env: ExecEnv, stmt: CreateTableAsSt
 export declare function executeCreateIndex(env: ExecEnv, stmt: CreateIndexStmt): ExecResult;
 export declare function executeCreateView(env: ExecEnv, stmt: CreateViewStmt): ExecResult;
 export declare function executeRefreshMatView(env: ExecEnv, stmt: RefreshMaterializedViewStmt): ExecResult;
+export declare function executeCreateExtension(env: ExecEnv, stmt: CreateExtensionStmt): ExecResult;
 export declare function executeCreateSchema(env: ExecEnv, stmt: CreateSchemaStmt): ExecResult;
 export declare function executeCreateEnum(env: ExecEnv, stmt: CreateEnumStmt): ExecResult;
 export declare function executeAlterEnum(env: ExecEnv, stmt: AlterEnumStmt): ExecResult;

package/dist/executor/relation.d.ts

@@ -40,6 +40,11 @@ export interface ExecEnv {
     /** CTE results by name (WITH clause); shadowed inner-to-outer */
     ctes: Map<string, Relation>;
     outer: RowScope | null;
+    /**
+     * CREATE/REFRESH MATERIALIZED VIEW … WITH NO DATA. An unpopulated matview
+     * contributes its column shape and no rows, matching PostgreSQL planning.
+     */
+    allowUnpopulatedMatviews?: boolean;
 }
 export declare function childEnv(env: ExecEnv, outer: RowScope | null): ExecEnv;
 export declare function withCtes(env: ExecEnv, ctes: Map<string, Relation>): ExecEnv;

package/dist/functions/pgcrypto.d.ts

@@ -0,0 +1,9 @@
+import type { EngineCtx } from "../expressions/context.js";
+import type { DatabaseState, FunctionData } from "../storage/database-state.js";
+import type { TypedValue } from "../types/value.js";
+/** pgcrypto `digest(data, type)` for the algorithms PostgreSQL documents as standard. */
+export declare function digestBytes(data: Uint8Array, algorithm: string): Uint8Array;
+export declare function pgcryptoInstalled(state: DatabaseState): boolean;
+export declare function installPgcrypto(state: DatabaseState, schemaName: string): void;
+export declare function uninstallPgcrypto(state: DatabaseState): boolean;
+export declare function evalPgcryptoFunction(ctx: EngineCtx, fn: FunctionData, args: TypedValue[]): TypedValue;

package/dist/functions/pgtrgm.d.ts

@@ -0,0 +1,24 @@
+import type { CreateIndexStmt } from "../ast/nodes.js";
+import type { EngineCtx } from "../expressions/context.js";
+import type { DatabaseState, FunctionData, TableData } from "../storage/database-state.js";
+import { type TypedValue } from "../types/value.js";
+export declare function pgTrgmSchema(state: DatabaseState): string | null;
+export declare function pgTrgmInstalled(state: DatabaseState): boolean;
+export declare function installPgTrgm(state: DatabaseState, schemaName: string): void;
+export declare function uninstallPgTrgm(state: DatabaseState): boolean;
+export declare function evalPgTrgmFunction(ctx: EngineCtx, fn: FunctionData, args: TypedValue[]): TypedValue;
+/** `text <% text` — word similarity at the default threshold. Absent until pg_trgm is installed. */
+export declare function evalTrgmWordSimilar(ctx: EngineCtx, left: TypedValue, right: TypedValue): TypedValue;
+/**
+ * Reject `gin_trgm_ops` unless pg_trgm is installed for access method gin.
+ * A single text/varchar column is stored as an ordinary non-unique index:
+ * lookup speed is not modelled.
+ */
+export declare function assertGinTrgmIndex(state: DatabaseState, table: TableData, stmt: CreateIndexStmt): void;
+/** `|intersection| / |union|` as float4. Either empty trigram set yields 0. */
+export declare function trigramSimilarity(left: string, right: string): number;
+/**
+ * Greatest similarity between the trigram set of `pattern` and any continuous
+ * extent of the ordered trigrams of `haystack` (PostgreSQL `word_similarity`).
+ */
+export declare function wordSimilarity(pattern: string, haystack: string): number;

package/dist/index.d.ts

@@ -23,6 +23,6 @@
  */
 import "./serialization/codec.js";
 export type { BindValue, JsValue, QueryRow } from "./api/bind.js";
-export { Database, type DatabaseOptions, type QueryOptions, type RegisterFunctionOptions, Snapshot, } from "./api/database.js";
+export { Database, type DatabaseHistory, type DatabaseOptions, type HistoryCheckpoint, type QueryOptions, type RegisterFunctionOptions, Snapshot, } from "./api/database.js";
 export { type ResultSet, type RunResult, Statement } from "./api/statement.js";
 export { type ErrorCategory, PostgresError } from "./errors/error.js";