@dbsp/adapter-pgsql 3.2.1 → 3.3.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, 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 { 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, TransitionLessor, ObservationIssuer, ObservationRequest, ObservationContext, EvidenceObservation, TypeRef, ExpressionValue, CollationRef, LogicalIdentity, PhysicalOperation, OperationEffectAssessment, FingerprintManifest, TransitionSessionClient, 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';
@@ -2781,6 +2781,27 @@ declare function renderCreateTransitionJournalTableSql(): string;
 declare function ensureTransitionJournal(executor: TransitionJournalQueryable): Promise<void>;
 declare function readTransitionJournal(executor: TransitionJournalQueryable, runId: string): Promise<TransitionRunJournal>;
 
+/**
+ * Declare a pg Pool as a source of transition leases.
+ *
+ * The typed Pool argument and this explicit factory call are the declaration.
+ * Neither check below infers ownership; each rejects a declaration that
+ * contradicts itself.
+ *
+ * A pg Pool and a pg Client are structurally identical — both expose connect(),
+ * query() and end(), and neither exposes release() — so the argument cannot be
+ * classified on sight. What connect() returns can be: a Pool leases a
+ * PoolClient, which carries release(); a Client resolves to itself, which does
+ * not. The lease is therefore checked at the first acquisition, which costs one
+ * connection to learn and is why the constructor cannot report it.
+ *
+ * This deliberately avoids `instanceof Client`, which would be sound but
+ * requires importing pg at runtime. Nothing else in this package does, so the
+ * compiler and the SQL renderer work without a driver, and one guard is not
+ * worth spending that.
+ */
+declare function createPgTransitionLessor(pool: Pool): TransitionLessor;
+
 type ObservationTarget = {
     readonly table: string;
     readonly column?: string;
@@ -2793,8 +2814,11 @@ type EnumObservationTarget = {
     readonly label?: string;
     readonly schema?: string;
 };
+/** Acquire one lease, issue the observation, then release that lease. */
+declare function executePgObservationFromLessor(lessor: TransitionLessor, request: ObservationRequest, context: ObservationContext): Promise<EvidenceObservation>;
+/** Acquire one lease, read context, then release that lease. */
+declare function readPgObservationContextFromLessor(lessor: TransitionLessor, schema?: string, observationTarget?: ObservationTarget | EnumObservationTarget): Promise<ObservationContext>;
 declare function createPgObservationIssuer(): ObservationIssuer;
-declare function readPgObservationContext(target: unknown, schema?: string, observationTarget?: ObservationTarget | EnumObservationTarget): Promise<ObservationContext>;
 
 interface SetNotNullColumnShapeExpectation {
     readonly kind: 'postgresql.set-not-null.column-shape.v1';
@@ -2829,7 +2853,7 @@ type AlterColumnSetNotNullPayload = {
     readonly expectedColumnShape?: SetNotNullColumnShapeExpectation;
 };
 type TransitionExecutionClient$3 = {
-    readonly opaqueClient: unknown;
+    readonly opaqueClient: TransitionSessionClient;
 };
 declare function renderAlterColumnSetNotNullSql(payload: AlterColumnSetNotNullPayload, context: ObservationContext): string;
 declare function renderSetNotNullLockSql(payload: AlterColumnSetNotNullPayload, context: ObservationContext): string;
@@ -2843,8 +2867,6 @@ declare function createAlterColumnSetNotNullOperationRuntime(): {
     supportsOperation(operation: PhysicalOperation): boolean;
     effectsOf(operation: PhysicalOperation, context: ObservationContext): OperationEffectAssessment;
     buildFingerprints: typeof beforeAfterFingerprints$3;
-    checkout(target: unknown): Promise<TransitionExecutionClient$3>;
-    release(client: TransitionExecutionClient$3, error?: unknown): void;
     writeIntentJournal(client: TransitionExecutionClient$3, record: DurableIntentRecord): Promise<void>;
     begin(client: TransitionExecutionClient$3): Promise<void>;
     setLockTimeout(client: TransitionExecutionClient$3, maxWaitMs: number): Promise<void>;
@@ -2878,7 +2900,7 @@ type AlterTypeAddValuePayload = {
     readonly expectedAfter: readonly string[];
 };
 type TransitionExecutionClient$2 = {
-    readonly opaqueClient: unknown;
+    readonly opaqueClient: TransitionSessionClient;
 };
 declare function renderAlterTypeAddValueSql(payload: AlterTypeAddValuePayload, context: ObservationContext): string;
 declare function beforeAfterFingerprints$2(operation: PhysicalOperation, evidence: readonly EvidenceObservation[], context: ObservationContext): {
@@ -2891,8 +2913,6 @@ declare function createAlterTypeAddValueOperationRuntime(): {
     supportsOperation(operation: PhysicalOperation): boolean;
     effectsOf(operation: PhysicalOperation, context: ObservationContext): OperationEffectAssessment;
     buildFingerprints: typeof beforeAfterFingerprints$2;
-    checkout(target: unknown): Promise<TransitionExecutionClient$2>;
-    release(client: TransitionExecutionClient$2, error?: unknown): void;
     writeIntentJournal(client: TransitionExecutionClient$2, record: DurableIntentRecord): Promise<void>;
     begin(client: TransitionExecutionClient$2): Promise<void>;
     setLockTimeout(client: TransitionExecutionClient$2, maxWaitMs: number): Promise<void>;
@@ -2926,7 +2946,7 @@ type AttachLogicalIdentityPayload = {
     readonly authenticated: false;
 };
 type TransitionExecutionClient$1 = {
-    readonly opaqueClient: unknown;
+    readonly opaqueClient: TransitionSessionClient;
 };
 declare function renderAttachLogicalIdentityLockSql(payload: AttachLogicalIdentityPayload): string;
 declare function renderCreateLogicalIdentitySideTableSql(_schema: string): string;
@@ -2941,8 +2961,6 @@ declare function createAttachLogicalIdentityOperationRuntime(): {
     supportsOperation(operation: PhysicalOperation): boolean;
     effectsOf(operation: PhysicalOperation, context: ObservationContext): OperationEffectAssessment;
     buildFingerprints: typeof beforeAfterFingerprints$1;
-    checkout(target: unknown): Promise<TransitionExecutionClient$1>;
-    release(client: TransitionExecutionClient$1, error?: unknown): void;
     writeIntentJournal(client: TransitionExecutionClient$1, record: DurableIntentRecord): Promise<void>;
     begin(client: TransitionExecutionClient$1): Promise<void>;
     setLockTimeout(client: TransitionExecutionClient$1, maxWaitMs: number): Promise<void>;
@@ -2974,7 +2992,7 @@ type ManualSqlPayload = {
     readonly postconditions: readonly ExecutableAssertion[];
 };
 type TransitionExecutionClient = {
-    readonly opaqueClient: unknown;
+    readonly opaqueClient: TransitionSessionClient;
 };
 declare function normalizeManualSqlPayload(payload: ManualSqlPayload, context: ObservationContext): ManualSqlPayload;
 declare function beforeAfterFingerprints(operation: PhysicalOperation, _evidence: readonly EvidenceObservation[], context: ObservationContext): {
@@ -2987,8 +3005,6 @@ declare function createManualSqlOperationRuntime(): {
     supportsOperation(operation: PhysicalOperation): boolean;
     effectsOf(operation: PhysicalOperation, context: ObservationContext): OperationEffectAssessment;
     buildFingerprints: typeof beforeAfterFingerprints;
-    checkout(target: unknown): Promise<TransitionExecutionClient>;
-    release(client: TransitionExecutionClient, error?: unknown): void;
     writeIntentJournal(client: TransitionExecutionClient, record: DurableIntentRecord): Promise<void>;
     begin(client: TransitionExecutionClient): Promise<void>;
     setLockTimeout(_client: TransitionExecutionClient, _maxWaitMs: number): Promise<void>;
@@ -3097,56 +3113,50 @@ declare function createPgTransitionPack(options?: PgTransitionPackOptions): {
             expectedBefore: _dbsp_types.FingerprintManifest;
             expectedAfter: _dbsp_types.FingerprintManifest;
         };
-        checkout(target: unknown): Promise<{
-            readonly opaqueClient: unknown;
-        }>;
-        release(client: {
-            readonly opaqueClient: unknown;
-        }, error?: unknown): void;
         writeIntentJournal(client: {
-            readonly opaqueClient: unknown;
+            readonly opaqueClient: _dbsp_types.TransitionSessionClient;
         }, record: _dbsp_types.DurableIntentRecord): Promise<void>;
         begin(client: {
-            readonly opaqueClient: unknown;
+            readonly opaqueClient: _dbsp_types.TransitionSessionClient;
         }): Promise<void>;
         setLockTimeout(client: {
-            readonly opaqueClient: unknown;
+            readonly opaqueClient: _dbsp_types.TransitionSessionClient;
         }, maxWaitMs: number): Promise<void>;
         acquireLocks(client: {
-            readonly opaqueClient: unknown;
+            readonly opaqueClient: _dbsp_types.TransitionSessionClient;
         }, operation: _dbsp_types.PhysicalOperation, _effects: _dbsp_types.OperationEffectAssessment, context: _dbsp_types.ObservationContext): Promise<void>;
         observeContext(client: {
-            readonly opaqueClient: unknown;
+            readonly opaqueClient: _dbsp_types.TransitionSessionClient;
         }, operation: _dbsp_types.PhysicalOperation, _proofContext: _dbsp_types.ObservationContext): Promise<_dbsp_types.ObservationContext>;
         observeOperation(client: {
-            readonly opaqueClient: unknown;
+            readonly opaqueClient: _dbsp_types.TransitionSessionClient;
         }, operation: _dbsp_types.PhysicalOperation, context: _dbsp_types.ObservationContext, _phase: "before" | "after", issuer: _dbsp_types.ObservationIssuer): Promise<{
             observations: _dbsp_types.IssuedObservation[];
             fingerprint: _dbsp_types.FingerprintManifest;
         }>;
         checkGuard(client: {
-            readonly opaqueClient: unknown;
+            readonly opaqueClient: _dbsp_types.TransitionSessionClient;
         }, operation: _dbsp_types.PhysicalOperation, guard: _dbsp_types.ApplyGuard, context: _dbsp_types.ObservationContext): Promise<{
             passed: boolean;
             observations: _dbsp_types.AdvisoryObservation[];
             recovery: readonly _dbsp_types.RecoveryArtefact[];
         }>;
         executeOperation(client: {
-            readonly opaqueClient: unknown;
+            readonly opaqueClient: _dbsp_types.TransitionSessionClient;
         }, operation: _dbsp_types.PhysicalOperation, context: _dbsp_types.ObservationContext, duringGuards?: readonly _dbsp_types.ApplyGuard[]): Promise<{
             kind: string;
         }>;
         writeCompletionJournal(client: {
-            readonly opaqueClient: unknown;
+            readonly opaqueClient: _dbsp_types.TransitionSessionClient;
         }, operation: _dbsp_types.PhysicalOperation, record: _dbsp_types.TransactionalCompletionRecord): Promise<void>;
         commit(client: {
-            readonly opaqueClient: unknown;
+            readonly opaqueClient: _dbsp_types.TransitionSessionClient;
         }): Promise<void>;
         rollback(client: {
-            readonly opaqueClient: unknown;
+            readonly opaqueClient: _dbsp_types.TransitionSessionClient;
         }): Promise<void>;
         writeObservedJournal(client: {
-            readonly opaqueClient: unknown;
+            readonly opaqueClient: _dbsp_types.TransitionSessionClient;
         }, journal: _dbsp_types.StepJournal): Promise<void>;
         isLockTimeout(error: unknown): boolean;
     } | {
@@ -3158,56 +3168,50 @@ declare function createPgTransitionPack(options?: PgTransitionPackOptions): {
             expectedBefore: _dbsp_types.FingerprintManifest;
             expectedAfter: _dbsp_types.FingerprintManifest;
         };
-        checkout(target: unknown): Promise<{
-            readonly opaqueClient: unknown;
-        }>;
-        release(client: {
-            readonly opaqueClient: unknown;
-        }, error?: unknown): void;
         writeIntentJournal(client: {
-            readonly opaqueClient: unknown;
+            readonly opaqueClient: _dbsp_types.TransitionSessionClient;
         }, record: _dbsp_types.DurableIntentRecord): Promise<void>;
         begin(client: {
-            readonly opaqueClient: unknown;
+            readonly opaqueClient: _dbsp_types.TransitionSessionClient;
         }): Promise<void>;
         setLockTimeout(client: {
-            readonly opaqueClient: unknown;
+            readonly opaqueClient: _dbsp_types.TransitionSessionClient;
         }, maxWaitMs: number): Promise<void>;
         acquireLocks(client: {
-            readonly opaqueClient: unknown;
+            readonly opaqueClient: _dbsp_types.TransitionSessionClient;
         }, operation: _dbsp_types.PhysicalOperation): Promise<void>;
         observeContext(client: {
-            readonly opaqueClient: unknown;
+            readonly opaqueClient: _dbsp_types.TransitionSessionClient;
         }, operation: _dbsp_types.PhysicalOperation, _proofContext: _dbsp_types.ObservationContext): Promise<_dbsp_types.ObservationContext>;
         observeOperation(client: {
-            readonly opaqueClient: unknown;
+            readonly opaqueClient: _dbsp_types.TransitionSessionClient;
         }, operation: _dbsp_types.PhysicalOperation, context: _dbsp_types.ObservationContext, _phase: "before" | "after", issuer: _dbsp_types.ObservationIssuer): Promise<{
             observations: _dbsp_types.IssuedObservation[];
             fingerprint: _dbsp_types.FingerprintManifest;
         }>;
         checkGuard(client: {
-            readonly opaqueClient: unknown;
+            readonly opaqueClient: _dbsp_types.TransitionSessionClient;
         }, operation: _dbsp_types.PhysicalOperation, guard: _dbsp_types.ApplyGuard, context: _dbsp_types.ObservationContext): Promise<{
             passed: boolean;
             observations: _dbsp_types.EvidenceObservation[];
             recovery: readonly _dbsp_types.RecoveryArtefact[];
         }>;
         executeOperation(client: {
-            readonly opaqueClient: unknown;
+            readonly opaqueClient: _dbsp_types.TransitionSessionClient;
         }, operation: _dbsp_types.PhysicalOperation, context: _dbsp_types.ObservationContext, duringGuards?: readonly _dbsp_types.ApplyGuard[]): Promise<{
             kind: string;
         }>;
         writeCompletionJournal(client: {
-            readonly opaqueClient: unknown;
+            readonly opaqueClient: _dbsp_types.TransitionSessionClient;
         }, operation: _dbsp_types.PhysicalOperation, record: _dbsp_types.TransactionalCompletionRecord): Promise<void>;
         commit(client: {
-            readonly opaqueClient: unknown;
+            readonly opaqueClient: _dbsp_types.TransitionSessionClient;
         }): Promise<void>;
         rollback(client: {
-            readonly opaqueClient: unknown;
+            readonly opaqueClient: _dbsp_types.TransitionSessionClient;
         }): Promise<void>;
         writeObservedJournal(client: {
-            readonly opaqueClient: unknown;
+            readonly opaqueClient: _dbsp_types.TransitionSessionClient;
         }, journal: _dbsp_types.StepJournal): Promise<void>;
         isLockTimeout(error: unknown): boolean;
     } | {
@@ -3219,36 +3223,30 @@ declare function createPgTransitionPack(options?: PgTransitionPackOptions): {
             expectedBefore: _dbsp_types.FingerprintManifest;
             expectedAfter: _dbsp_types.FingerprintManifest;
         };
-        checkout(target: unknown): Promise<{
-            readonly opaqueClient: unknown;
-        }>;
-        release(client: {
-            readonly opaqueClient: unknown;
-        }, error?: unknown): void;
         writeIntentJournal(client: {
-            readonly opaqueClient: unknown;
+            readonly opaqueClient: _dbsp_types.TransitionSessionClient;
         }, record: _dbsp_types.DurableIntentRecord): Promise<void>;
         begin(_client: {
-            readonly opaqueClient: unknown;
+            readonly opaqueClient: _dbsp_types.TransitionSessionClient;
         }): Promise<never>;
         setLockTimeout(_client: {
-            readonly opaqueClient: unknown;
+            readonly opaqueClient: _dbsp_types.TransitionSessionClient;
         }, _maxWaitMs: number): Promise<void>;
         acquireLocks(): Promise<void>;
         observeContext(client: {
-            readonly opaqueClient: unknown;
+            readonly opaqueClient: _dbsp_types.TransitionSessionClient;
         }, operation: _dbsp_types.PhysicalOperation, _proofContext: _dbsp_types.ObservationContext): Promise<_dbsp_types.ObservationContext>;
         observeOperation(client: {
-            readonly opaqueClient: unknown;
+            readonly opaqueClient: _dbsp_types.TransitionSessionClient;
         }, operation: _dbsp_types.PhysicalOperation, context: _dbsp_types.ObservationContext, phase: "before" | "after", issuer: _dbsp_types.ObservationIssuer): Promise<{
             observations: _dbsp_types.IssuedObservation[];
             fingerprint: _dbsp_types.FingerprintManifest;
         }>;
         checkGuard(_client: {
-            readonly opaqueClient: unknown;
+            readonly opaqueClient: _dbsp_types.TransitionSessionClient;
         }, _operation: _dbsp_types.PhysicalOperation, guard: _dbsp_types.ApplyGuard): Promise<never>;
         executeOperation(client: {
-            readonly opaqueClient: unknown;
+            readonly opaqueClient: _dbsp_types.TransitionSessionClient;
         }, operation: _dbsp_types.PhysicalOperation, context: _dbsp_types.ObservationContext, duringGuards?: readonly _dbsp_types.ApplyGuard[], executionTracker?: _dbsp_core.NonRollbackableExecutionTracker): Promise<{
             kind: "partially-applied";
             recovery: _dbsp_types.RecoveryArtefact[];
@@ -3265,16 +3263,16 @@ declare function createPgTransitionPack(options?: PgTransitionPackOptions): {
             nonRollbackableFootprint: string;
         }>;
         writeCompletionJournal(client: {
-            readonly opaqueClient: unknown;
+            readonly opaqueClient: _dbsp_types.TransitionSessionClient;
         }, operation: _dbsp_types.PhysicalOperation, record: _dbsp_types.TransactionalCompletionRecord): Promise<void>;
         commit(_client: {
-            readonly opaqueClient: unknown;
+            readonly opaqueClient: _dbsp_types.TransitionSessionClient;
         }): Promise<never>;
         rollback(_client: {
-            readonly opaqueClient: unknown;
+            readonly opaqueClient: _dbsp_types.TransitionSessionClient;
         }): Promise<never>;
         writeObservedJournal(client: {
-            readonly opaqueClient: unknown;
+            readonly opaqueClient: _dbsp_types.TransitionSessionClient;
         }, journal: _dbsp_types.StepJournal): Promise<void>;
         isLockTimeout(error: unknown): boolean;
     })[];
@@ -3359,4 +3357,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 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 };
+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, createPgTransitionLessor, createPgTransitionPack, createPgsqlAdapter, createPgsqlCompileOnlyAdapter, createSetNotNullRule, createTypeCastParamRef, defaultFkDerivation, derivePostgresqlCapabilitiesForVersion, ensureMigrationsTable, ensureTransitionJournal, excludedRef, executePgObservationFromLessor, 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, readPgObservationContextFromLessor, 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 };