@dbsp/adapter-pgsql 3.1.0 → 3.2.0

package/dist/index.d.ts

@@ -2,7 +2,7 @@ import * as _dbsp_core from '@dbsp/core';
 import { IndexInfo, TruncateOptions, VacuumOptions, AlterColumnOptions, CreateIndexOptions, DropIndexOptions, ExpressionRef, ModelIR as ModelIR$1, ExecutionCoordinator, CapabilityDescriptor } from '@dbsp/core';
 export { normalizeSQL } from '@dbsp/core';
 import * as _dbsp_types from '@dbsp/types';
-import { DialectCapabilities, ModelIR, ColumnListInput, ParamIntent, JsonAggOrderByEntry, IndexIR, HierarchyIR, Adapter, DbCasing, AdapterLogger, AdapterCapabilities, PlanReport, CompiledNqlQuery, CompileOptions, CompiledQuery, CompileResultWithIncludes, SubqueryIncludeInfo, ExpressionIntent, InsertIntent, InsertFromIntent, UpdateIntent, BatchUpdateIntent, DeleteIntent, UpsertIntent, UpsertFromIntent, RecursivePlanReport, CteQueryIntent, SetOperationIntent, DumpMeta, Dump, AdapterStreamOptions, CompileOnlyAdapter, ColumnIR, MutationReturningItem, WhereIntent, OutputDescriptor, QueryIntent, OperationKindRef, SemanticArtifactRef, TransitionRunJournal, ObservationIssuer, ObservationContext, TypeRef, ExpressionValue, CollationRef, LogicalIdentity, PhysicalOperation, OperationEffectAssessment, EvidenceObservation, FingerprintManifest, DurableIntentRecord, IssuedObservation, ApplyGuard, AdvisoryObservation, TransactionalCompletionRecord, StepJournal, UnsafeNativeFragment, ResourceAddress, ExecutableAssertion, Assumption, TransitionRule, TransitionCompositionFact, TrustRoot, RequiredEnumLabelIR } from '@dbsp/types';
+import { DialectCapabilities, ModelIR, ColumnListInput, ParamIntent, JsonAggOrderByEntry, IndexIR, HierarchyIR, Adapter, DbCasing, AdapterLogger, AdapterCapabilities, PlanReport, CompiledNqlQuery, CompileOptions, CompiledQuery, CompileResultWithIncludes, SubqueryIncludeInfo, ExpressionIntent, InsertIntent, InsertFromIntent, UpdateIntent, BatchUpdateIntent, DeleteIntent, UpsertIntent, UpsertFromIntent, RecursivePlanReport, CteQueryIntent, SetOperationIntent, DumpMeta, Dump, AdapterStreamOptions, PinnedConnectionOptions, TransactionOptions, CompileOnlyAdapter, ColumnIR, MutationReturningItem, WhereIntent, OutputDescriptor, QueryIntent, OperationKindRef, SemanticArtifactRef, TransitionRunJournal, ObservationIssuer, ObservationContext, TypeRef, ExpressionValue, CollationRef, LogicalIdentity, PhysicalOperation, OperationEffectAssessment, EvidenceObservation, FingerprintManifest, DurableIntentRecord, IssuedObservation, ApplyGuard, AdvisoryObservation, TransactionalCompletionRecord, StepJournal, UnsafeNativeFragment, ResourceAddress, ExecutableAssertion, Assumption, TransitionRule, TransitionCompositionFact, TrustRoot, RequiredEnumLabelIR } from '@dbsp/types';
 import * as _pgsql_types from '@pgsql/types';
 import { Node, OnConflictClause, ParamRef } from '@pgsql/types';
 import { Pool, PoolClient } from 'pg';
@@ -877,6 +877,8 @@ interface IntrospectedModelIR extends ModelIR {
  */
 declare function introspect(pool: Pool, options?: IntrospectionOptions): Promise<IntrospectedModelIR>;
 
+type PgsqlTransactionTimeoutParameter = 'lock_timeout' | 'statement_timeout';
+
 /**
  * PgsqlAdapter - Implements the Adapter interface for PostgreSQL using native pg driver.
  *
@@ -886,6 +888,16 @@ declare function introspect(pool: Pool, options?: IntrospectionOptions): Promise
  * @module pgsql-adapter
  */
 
+type PgAdvisoryLockKey = bigint | {
+    readonly classId: number;
+    readonly objId: number;
+};
+type PgAdvisoryLockResult<T> = {
+    readonly acquired: true;
+    readonly value: T;
+} | {
+    readonly acquired: false;
+};
 declare class PgsqlRawSqlTransactionControlError extends Error {
     readonly dbspRawSqlTransactionControl = true;
     constructor(cause: unknown);
@@ -898,6 +910,48 @@ declare class PgsqlTransactionAbortedError extends Error {
     readonly dbspTransactionAborted = true;
     constructor(cause: unknown);
 }
+/**
+ * Raised when a pool-owned top-level transaction is aborted through
+ * `TransactionOptions.signal`. If the signal aborts while `pool.connect()` is
+ * still pending, dbsp honors it only after a client is acquired.
+ */
+declare class PgsqlTransactionAbortSignalError extends Error {
+    readonly dbspTransactionAbortSignal = true;
+    constructor();
+}
+declare class PgsqlPinnedConnectionAbortSignalError extends Error {
+    readonly dbspPinnedConnectionAbortSignal = true;
+    constructor();
+}
+declare class PgsqlTransactionOptionsError extends Error {
+    readonly dbspTransactionOptions = true;
+    constructor(message: string);
+}
+declare class PgsqlAdvisoryLockOptionsError extends Error {
+    readonly dbspAdvisoryLockOptions = true;
+    constructor(message: string);
+}
+/**
+ * Raised when a statement inside a dbsp-managed transaction fails with a SQLSTATE
+ * that matches a timeout the caller configured for that transaction: `55P03`
+ * (`lock_not_available`) when `lockTimeoutMs` was set, or `57014` (`query_canceled`)
+ * when `statementTimeoutMs` was set. The original PostgreSQL error is preserved as
+ * `cause`.
+ *
+ * Classification is by SQLSTATE only. PostgreSQL assigns these codes to the OUTCOME,
+ * not the cause: `55P03` is also raised by `FOR UPDATE NOWAIT`, and `57014` is also
+ * raised by an external cancel (e.g. `pg_cancel_backend`). There is no locale-stable
+ * structured field that separates the timeout from the other cause, so the message
+ * text is deliberately NOT parsed. dbsp never emits `NOWAIT` itself, so a `55P03`
+ * here is the configured `lock_timeout` unless the caller's own raw SQL used
+ * `NOWAIT`; a `57014` is the configured `statement_timeout` unless the backend was
+ * cancelled from outside. Inspect `cause` when that distinction matters.
+ */
+declare class PgsqlTransactionTimeoutError extends Error {
+    readonly timeout: PgsqlTransactionTimeoutParameter;
+    readonly dbspTransactionTimeout = true;
+    constructor(cause: unknown, timeout: PgsqlTransactionTimeoutParameter);
+}
 /**
  * Options for PgsqlAdapter.
  */
@@ -974,6 +1028,7 @@ declare class PgsqlAdapter<DB = unknown> implements Adapter<DB> {
     private readonly borrowedClient;
     private readonly managedTransactions;
     private readonly adapterManagedTransaction;
+    private readonly adapterManagedPinnedConnection;
     private readonly scopeToken;
     private readonly scopeState;
     private readonly schemaName;
@@ -1132,6 +1187,15 @@ declare class PgsqlAdapter<DB = unknown> implements Adapter<DB> {
      * Results are transformed to use model naming convention (e.g., snake_case → camelCase)
      */
     execute<T>(query: CompiledQuery<T>): Promise<T[]>;
+    /**
+     * Execute a query and return rows plus PostgreSQL result metadata.
+     * Results are transformed to use model naming convention (e.g., snake_case → camelCase)
+     */
+    executeWithMeta<T = unknown>(query: CompiledQuery<T>): Promise<{
+        readonly rows: T[];
+        readonly rowCount: number;
+        readonly command?: string;
+    }>;
     /**
      * Transform result rows from database naming to model naming convention.
      * For CamelCaseNamingPlugin: price_cents → priceCents
@@ -1181,6 +1245,31 @@ declare class PgsqlAdapter<DB = unknown> implements Adapter<DB> {
      * ```
      */
     introspect(options?: IntrospectionOptions): Promise<IntrospectedModelIR>;
+    /**
+     * Acquire an exclusive session-level PostgreSQL advisory lock for the callback.
+     *
+     * The lock, callback, and unlock run on one `withPinnedConnection()` adapter.
+     * dbsp performs one PostgreSQL acquire and one matching unlock per call. It
+     * does not track reentrant depth in v1; PostgreSQL's session-level stacking
+     * still applies when callers deliberately nest on the same pinned adapter.
+     */
+    withAdvisoryLock<T>(key: PgAdvisoryLockKey, fn: (locked: Adapter<DB>) => Promise<T>): Promise<T>;
+    withAdvisoryLock<T>(key: PgAdvisoryLockKey, fn: (locked: Adapter<DB>) => Promise<T>, options: {
+        readonly wait?: 'block';
+        readonly signal?: AbortSignal;
+    }): Promise<T>;
+    withAdvisoryLock<T>(key: PgAdvisoryLockKey, fn: (locked: Adapter<DB>) => Promise<T>, options: {
+        readonly wait: 'try';
+        readonly signal?: AbortSignal;
+    }): Promise<PgAdvisoryLockResult<T>>;
+    withAdvisoryLock<T>(key: PgAdvisoryLockKey, fn: (locked: Adapter<DB>) => Promise<T>, options?: {
+        readonly wait?: 'block' | 'try';
+        readonly signal?: AbortSignal;
+    }): Promise<T | PgAdvisoryLockResult<T>>;
+    private unlockAdvisoryLock;
+    withPinnedConnection<T>(fn: (adapter: Adapter<DB>) => Promise<T>, options?: PinnedConnectionOptions): Promise<T>;
+    private pinnedConnectionReleaseReason;
+    private pinnedConnectionWithClient;
     /**
      * Execute a callback within a database transaction.
      *
@@ -1210,7 +1299,7 @@ declare class PgsqlAdapter<DB = unknown> implements Adapter<DB> {
      * and hand dbsp a `borrowedClient` **without** `managedTransactions`. dbsp will then
      * contain its own statements inside *your* transaction instead of the other way round.
      */
-    transaction<T>(fn: (adapter: Adapter<DB>) => Promise<T>): Promise<T>;
+    transaction<T>(fn: (adapter: Adapter<DB>) => Promise<T>, options?: TransactionOptions): Promise<T>;
     /**
      * Execute scratch PostgreSQL work in a scope that always rolls back on success.
      *
@@ -1222,12 +1311,16 @@ declare class PgsqlAdapter<DB = unknown> implements Adapter<DB> {
      */
     withScratchScope<T>(fn: (adapter: PgsqlAdapter<DB>) => Promise<T>): Promise<T>;
     private createManagedClientAdapter;
+    private createPinnedConnectionAdapter;
     private createChildTransactionObserver;
     private observeChildTransaction;
     private markChildTransactionObserved;
     private refreshScopeChildrenFailure;
     private transactionWithManagedClient;
     private transactionWithManagedClientSavepointScope;
+    private applyTransactionTimeouts;
+    private captureAndApplySavepointTimeouts;
+    private restoreSavepointTimeouts;
     private transactionWithClientTransaction;
     private releaseClient;
     private rollbackAndReleaseSavepoint;
@@ -1239,9 +1332,11 @@ declare class PgsqlAdapter<DB = unknown> implements Adapter<DB> {
     private classifySavepointReleaseFailure;
     private rollbackSavepointAfterReleaseFailure;
     private enterTransactionScope;
+    private enterPinnedConnectionScope;
     private enterSavepointScope;
     private pushClientScope;
     private currentClientScope;
+    private managedScopeEndedMessage;
     private assertCanUseClient;
     private assertUsableScopeAncestors;
     private findClientScope;
@@ -1306,6 +1401,7 @@ declare class PgsqlAdapter<DB = unknown> implements Adapter<DB> {
      */
     get inTransaction(): boolean;
     private adapterManagedScopeIsLive;
+    private shouldProtectBorrowedClientTransaction;
     private executeQueryProtectingOpenTransaction;
     private executeConnectionStatement;
     private executeConnectionStatementUnlocked;
@@ -1355,27 +1451,27 @@ declare class PgsqlAdapter<DB = unknown> implements Adapter<DB> {
      * Generate SQL for TRUNCATE TABLE.
      * Implements TableDDLGeneratorAdapter.generateTruncate.
      */
-    generateTruncate(table: string, schema?: string, options?: TruncateOptions): string;
+    generateTruncate(table: string, schemaName: string, options?: TruncateOptions): string;
     /**
      * Generate SQL for VACUUM.
      * Implements TableDDLGeneratorAdapter.generateVacuum.
      */
-    generateVacuum(table: string, schema?: string, options?: VacuumOptions): string;
+    generateVacuum(table: string, schemaName: string, options?: VacuumOptions): string;
     /**
      * Generate SQL for ALTER TABLE ... ALTER COLUMN.
      * Implements TableDDLGeneratorAdapter.generateAlterColumn.
      */
-    generateAlterColumn(table: string, column: string, options: AlterColumnOptions, schema?: string): string;
+    generateAlterColumn(table: string, schemaName: string, column: string, options: AlterColumnOptions): string;
     /**
      * Generate SQL for CREATE INDEX.
      * Implements TableDDLGeneratorAdapter.generateCreateIndex.
      */
-    generateCreateIndex(table: string, options: CreateIndexOptions, schema?: string): string;
+    generateCreateIndex(table: string, schemaName: string, options: CreateIndexOptions): string;
     /**
      * Generate SQL for DROP INDEX.
      * Implements TableDDLGeneratorAdapter.generateDropIndex.
      */
-    generateDropIndex(name: string, options?: DropIndexOptions): string;
+    generateDropIndex(name: string, schemaName: string, options?: DropIndexOptions): string;
     /**
      * Validate an identifier (table name, column name, schema name).
      */
@@ -1694,9 +1790,12 @@ interface MigrationRecord {
     readonly destructive: boolean;
 }
 /**
- * Execute a callback under an advisory lock using a dedicated client.
+ * Execute a callback under the migration advisory lock using a pinned client.
  * The lock is held for the duration of the callback.
- * The client is released (and lock freed) after the callback completes.
+ *
+ * Intentional latent-bug fix: session-level advisory locks are not freed by
+ * returning a PoolClient to pg's pool. If unlock fails, PgsqlAdapter destroys the
+ * session instead of returning a possibly lock-holding connection to the pool.
  */
 declare function withMigrationLock<T>(pool: Pool, fn: (client: PoolClient) => Promise<T>): Promise<T>;
 /**
@@ -3260,4 +3359,4 @@ declare function sanitizeForDisplay(value: string): string;
  */
 declare function validateSqlExpression(sql: string, context: string): void;
 
-export { ADD_CHECK_RULE_ID, ALTER_AUTHORITY_OBSERVATION, ALTER_COLUMN_SET_NOT_NULL_OPERATION_KIND, ALTER_TYPE_ADD_VALUE_OPERATION_KIND, ATTACH_LOGICAL_IDENTITY_OPERATION_KIND, type AddedEnumValue, type AlterColumnSetNotNullPayload, type AlterTypeAddValuePayload, type AttachLogicalIdentityPayload, type BatchValuesJoinDecision, COLUMN_EXISTS_OBSERVATION, CamelCaseNamingPlugin, type CanonicalizeCheckConstraintsOptions, type ChangeKind, CheckConstraintCanonicalizationError, type CheckConstraintCanonicalizationWarning, CheckConstraintNewEnumValueError, type ComparePgsqlDatabaseSchemaOptions, type CompareSchemataOptions, type CompiledResult, type CompilerContext, type CompilerOptions, type CompilerState, type ConflictAction, type ConflictTarget, type CursorHoldOption, type CursorOptions, type CursorScrollOption, DBSP_LOGICAL_IDENTITY_TABLE, DBSP_META_SCHEMA, DBSP_TRANSITION_JOURNAL_TABLE, DBSP_TRANSITION_RUN_TABLE, DEFAULT_PK_COLUMN, DEFAULT_REDACTION_PATTERNS, type Decision, type DeleteConfig, type DetectedHierarchy, type DiffSummary, ENGINE_VERSION_OBSERVATION, ENUM_ADD_VALUE_RULE_ID, ENUM_LABEL_VISIBLE_OBSERVATION, ENUM_TYPE_EXISTS_OBSERVATION, type EnumAddValueMatch, type EnumAddValueRuleOptions, type ExplainFormat, type ExplainOptions, type ExplainPlan, ExpressionCanonicalizationUnavailableError, type ExpressionHandler, type FetchDirection, type FetchOptions, type FkColumnDerivation, type GenerateDDLOptions, type IdentityAdoptionAsserter, IdentityNamingPlugin, type IncludeHandler, type IncludeResult, type IndexCapabilityContext, IndexFeatureUnsupportedError, type IndexRenderSpec, type InsertConfig, type IntrospectedModelIR, type IntrospectionOptions, InvalidIdentifierError, type JoinDecision, LOGICAL_IDENTITY_ADOPTION_RULE_ID, LOGICAL_IDENTITY_CARRIER_OBSERVATION, type LeafCompileFn, type LogicalIdentityAdoptionMatch, type LogicalIdentityAdoptionRuleOptions, MANUAL_SQL_OPERATION_KIND, type ManualSqlPayload, type MigrationRecord, type MigrationSQLOptions, NO_NULLS_GUARD, type NamingPlugin, NonConvergentSchemaDiffError, PG_INTROSPECTION_ARTIFACT, PG_OPERATION_PACK_ARTIFACT, PG_RULE_PACK_ARTIFACT, type ParamRefValidationResult, type ParsedMigrationFile, type PgTransitionPackOptions, PgsqlAdapter, type PgsqlAdapterOptions, type PgsqlBorrowedClientAdapterOptions, type PgsqlPoolAdapterOptions, PgsqlRawSqlTransactionControlError, PgsqlTransactionAbortedCommitError, PgsqlTransactionAbortedError, PlanCompiler, type PlanDecision, type PrecompiledJoinDecision, type RedactionConfig, type RedactionPattern, SET_NOT_NULL_RULE_ID, type SchemaChange, type SchemaDiff, type SchemaScopeOptions, type SetNotNullMatch, type SetNotNullRuleOptions, type SetOperationResult, type SimplifiedPlanReport, type StreamConfig, type UpdateConfig, type UpsertConfig, type WhereDispatcher, type WhereHandler, assertCreateIndexSupported, assertCreateIndexesSupported, assertNoRepeatedExpressionSurfaceDrift, bm25Search, booleanSearch, boost, buildCloseCursor, buildDeclareCursor, buildExplain, buildExplainAnalyzeJson, buildExplainPlan, buildExplainVerbose, buildFetch, buildFetchAll, buildFetchFirst, buildFetchForward, buildFetchNext, buildOnConflictClause, buildStreamingStatements, camelCaseNaming, canGenerateCreateIndex, canonicalizeCheckConstraints, collectAndValidateParamRefs, comparePgsqlDatabaseSchema, compareSchemata, compileDelete, compileInsert, compileMutation, compilePlan, compileSetOperation, compileUpdate, compileUpsert, conditionalUpdate, cosineDistance, createAlterColumnSetNotNullOperationRuntime, createAlterTypeAddValueOperationRuntime, createAnyExpr, createAttachLogicalIdentityOperationRuntime, createEnumAddValueRule, createEqualityExpr, createLeafCompileFn, createLogicalIdentityAdoptionRule, createManualSqlOperationRuntime, createParamRef, createPgObservationIssuer, createPgTransitionPack, createPgsqlAdapter, createPgsqlCompileOnlyAdapter, createSetNotNullRule, createTypeCastParamRef, defaultFkDerivation, derivePostgresqlCapabilitiesForVersion, ensureMigrationsTable, ensureTransitionJournal, excludedRef, generateCreateIndex, generateCursorName, generateDDL, generateDownSQL, generateMigrationFile, generateMigrationSQL, generateSeries, getAppliedMigrations, getNamingPluginForDbCasing, getNextSchemaVersion, getRowEstimates, getTotalExecutionTime, identityNaming, innerProduct, introspect, isBatchValuesJoinDecision, isDestructiveDown, isJoinDecision, isMigrationApplied, isPrecompiledJoinDecision, isReservedKeyword, l2Distance, mapColumnType, mapOnDeleteAction, nextval, normalizeManualSqlPayload, parse, parseExplainJson, parseMigrationFile, rawDistance, readPgObservationContext, readTransitionJournal, recordMigration, redactParams, removeMigrationRecord, renderAlterColumnSetNotNullSql, renderAlterTypeAddValueSql, renderAttachLogicalIdentityLockSql, renderCreateDbspMetaSchemaSql, renderCreateIndex, renderCreateLogicalIdentityIndexesSql, renderCreateLogicalIdentitySideTableSql, renderCreateTransitionJournalTableSql, renderCreateTransitionRunTableSql, renderInsertLogicalIdentitySql, renderNoNullsCheckSql, renderSetNotNullLockSql, resolveLogicalName, sanitizeForDisplay, score, validateIdentifier, validateIdentifiers, validateParamRef, validateQualifiedIdentifier, validateSqlExpression, vectorDims, withMigrationLock };
+export { ADD_CHECK_RULE_ID, ALTER_AUTHORITY_OBSERVATION, ALTER_COLUMN_SET_NOT_NULL_OPERATION_KIND, ALTER_TYPE_ADD_VALUE_OPERATION_KIND, ATTACH_LOGICAL_IDENTITY_OPERATION_KIND, type AddedEnumValue, type AlterColumnSetNotNullPayload, type AlterTypeAddValuePayload, type AttachLogicalIdentityPayload, type BatchValuesJoinDecision, COLUMN_EXISTS_OBSERVATION, CamelCaseNamingPlugin, type CanonicalizeCheckConstraintsOptions, type ChangeKind, CheckConstraintCanonicalizationError, type CheckConstraintCanonicalizationWarning, CheckConstraintNewEnumValueError, type ComparePgsqlDatabaseSchemaOptions, type CompareSchemataOptions, type CompiledResult, type CompilerContext, type CompilerOptions, type CompilerState, type ConflictAction, type ConflictTarget, type CursorHoldOption, type CursorOptions, type CursorScrollOption, DBSP_LOGICAL_IDENTITY_TABLE, DBSP_META_SCHEMA, DBSP_TRANSITION_JOURNAL_TABLE, DBSP_TRANSITION_RUN_TABLE, DEFAULT_PK_COLUMN, DEFAULT_REDACTION_PATTERNS, type Decision, type DeleteConfig, type DetectedHierarchy, type DiffSummary, ENGINE_VERSION_OBSERVATION, ENUM_ADD_VALUE_RULE_ID, ENUM_LABEL_VISIBLE_OBSERVATION, ENUM_TYPE_EXISTS_OBSERVATION, type EnumAddValueMatch, type EnumAddValueRuleOptions, type ExplainFormat, type ExplainOptions, type ExplainPlan, ExpressionCanonicalizationUnavailableError, type ExpressionHandler, type FetchDirection, type FetchOptions, type FkColumnDerivation, type GenerateDDLOptions, type IdentityAdoptionAsserter, IdentityNamingPlugin, type IncludeHandler, type IncludeResult, type IndexCapabilityContext, IndexFeatureUnsupportedError, type IndexRenderSpec, type InsertConfig, type IntrospectedModelIR, type IntrospectionOptions, InvalidIdentifierError, type JoinDecision, LOGICAL_IDENTITY_ADOPTION_RULE_ID, LOGICAL_IDENTITY_CARRIER_OBSERVATION, type LeafCompileFn, type LogicalIdentityAdoptionMatch, type LogicalIdentityAdoptionRuleOptions, MANUAL_SQL_OPERATION_KIND, type ManualSqlPayload, type MigrationRecord, type MigrationSQLOptions, NO_NULLS_GUARD, type NamingPlugin, NonConvergentSchemaDiffError, PG_INTROSPECTION_ARTIFACT, PG_OPERATION_PACK_ARTIFACT, PG_RULE_PACK_ARTIFACT, type ParamRefValidationResult, type ParsedMigrationFile, type PgAdvisoryLockKey, type PgAdvisoryLockResult, type PgTransitionPackOptions, PgsqlAdapter, type PgsqlAdapterOptions, PgsqlAdvisoryLockOptionsError, type PgsqlBorrowedClientAdapterOptions, PgsqlPinnedConnectionAbortSignalError, type PgsqlPoolAdapterOptions, PgsqlRawSqlTransactionControlError, PgsqlTransactionAbortSignalError, PgsqlTransactionAbortedCommitError, PgsqlTransactionAbortedError, PgsqlTransactionOptionsError, PgsqlTransactionTimeoutError, PlanCompiler, type PlanDecision, type PrecompiledJoinDecision, type RedactionConfig, type RedactionPattern, SET_NOT_NULL_RULE_ID, type SchemaChange, type SchemaDiff, type SchemaScopeOptions, type SetNotNullMatch, type SetNotNullRuleOptions, type SetOperationResult, type SimplifiedPlanReport, type StreamConfig, type UpdateConfig, type UpsertConfig, type WhereDispatcher, type WhereHandler, assertCreateIndexSupported, assertCreateIndexesSupported, assertNoRepeatedExpressionSurfaceDrift, bm25Search, booleanSearch, boost, buildCloseCursor, buildDeclareCursor, buildExplain, buildExplainAnalyzeJson, buildExplainPlan, buildExplainVerbose, buildFetch, buildFetchAll, buildFetchFirst, buildFetchForward, buildFetchNext, buildOnConflictClause, buildStreamingStatements, camelCaseNaming, canGenerateCreateIndex, canonicalizeCheckConstraints, collectAndValidateParamRefs, comparePgsqlDatabaseSchema, compareSchemata, compileDelete, compileInsert, compileMutation, compilePlan, compileSetOperation, compileUpdate, compileUpsert, conditionalUpdate, cosineDistance, createAlterColumnSetNotNullOperationRuntime, createAlterTypeAddValueOperationRuntime, createAnyExpr, createAttachLogicalIdentityOperationRuntime, createEnumAddValueRule, createEqualityExpr, createLeafCompileFn, createLogicalIdentityAdoptionRule, createManualSqlOperationRuntime, createParamRef, createPgObservationIssuer, createPgTransitionPack, createPgsqlAdapter, createPgsqlCompileOnlyAdapter, createSetNotNullRule, createTypeCastParamRef, defaultFkDerivation, derivePostgresqlCapabilitiesForVersion, ensureMigrationsTable, ensureTransitionJournal, excludedRef, generateCreateIndex, generateCursorName, generateDDL, generateDownSQL, generateMigrationFile, generateMigrationSQL, generateSeries, getAppliedMigrations, getNamingPluginForDbCasing, getNextSchemaVersion, getRowEstimates, getTotalExecutionTime, identityNaming, innerProduct, introspect, isBatchValuesJoinDecision, isDestructiveDown, isJoinDecision, isMigrationApplied, isPrecompiledJoinDecision, isReservedKeyword, l2Distance, mapColumnType, mapOnDeleteAction, nextval, normalizeManualSqlPayload, parse, parseExplainJson, parseMigrationFile, rawDistance, readPgObservationContext, readTransitionJournal, recordMigration, redactParams, removeMigrationRecord, renderAlterColumnSetNotNullSql, renderAlterTypeAddValueSql, renderAttachLogicalIdentityLockSql, renderCreateDbspMetaSchemaSql, renderCreateIndex, renderCreateLogicalIdentityIndexesSql, renderCreateLogicalIdentitySideTableSql, renderCreateTransitionJournalTableSql, renderCreateTransitionRunTableSql, renderInsertLogicalIdentitySql, renderNoNullsCheckSql, renderSetNotNullLockSql, resolveLogicalName, sanitizeForDisplay, score, validateIdentifier, validateIdentifiers, validateParamRef, validateQualifiedIdentifier, validateSqlExpression, vectorDims, withMigrationLock };