@dbsp/adapter-pgsql 1.5.0 → 1.7.0

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { ExpressionRef, IndexInfo, TruncateOptions, VacuumOptions, AlterColumnOptions, CreateIndexOptions, DropIndexOptions, ModelIR as ModelIR$1 } from '@dbsp/core';
 export { normalizeSQL } from '@dbsp/core';
 import * as _dbsp_types from '@dbsp/types';
-import { ParamIntent, DialectCapabilities, ModelIR, DbCasing, ColumnIR, HierarchyIR, WhereIntent, Adapter, AdapterLogger, AdapterCapabilities, PlanReport, CompiledNqlQuery, CompileOptions, CompiledQuery, CompileResultWithIncludes, SubqueryIncludeInfo, ExpressionIntent, InsertIntent, InsertFromIntent, UpdateIntent, BatchUpdateIntent, DeleteIntent, UpsertIntent, UpsertFromIntent, RecursivePlanReport, CteQueryIntent, SetOperationIntent, DumpMeta, Dump, AdapterStreamOptions, CompileOnlyAdapter, QueryIntent } from '@dbsp/types';
+import { ColumnListInput, ParamIntent, JsonAggOrderByEntry, DialectCapabilities, ModelIR, DbCasing, ColumnIR, HierarchyIR, WhereIntent, Adapter, AdapterLogger, AdapterCapabilities, PlanReport, CompiledNqlQuery, CompileOptions, CompiledQuery, CompileResultWithIncludes, SubqueryIncludeInfo, ExpressionIntent, InsertIntent, InsertFromIntent, UpdateIntent, BatchUpdateIntent, DeleteIntent, UpsertIntent, UpsertFromIntent, RecursivePlanReport, CteQueryIntent, SetOperationIntent, DumpMeta, Dump, AdapterStreamOptions, CompileOnlyAdapter, QueryIntent } from '@dbsp/types';
 import * as _pgsql_types from '@pgsql/types';
 import { Node, OnConflictClause, ParamRef } from '@pgsql/types';
 import { Pool, PoolClient } from 'pg';
@@ -99,6 +99,10 @@ declare function getNamingPluginForDbCasing(casing: 'snake_case' | 'camelCase' |
 
 type BindingNameRegistry = ReadonlySet<string>;
 
+type PlanExpressionOrderBy = readonly {
+    field: string;
+    direction?: 'asc' | 'desc';
+}[];
 /**
  * Simplified PlanDecision for the spike
  * (In production, import from @dbsp/core)
@@ -115,8 +119,8 @@ interface PlanDecision {
     readonly direction?: 'ASC' | 'DESC';
     readonly nulls?: 'FIRST' | 'LAST';
     readonly joinType?: 'inner' | 'left';
-    readonly sourceColumn?: string;
-    readonly targetColumn?: string;
+    readonly sourceColumn?: ColumnListInput;
+    readonly targetColumn?: ColumnListInput;
     readonly targetTable?: string;
     readonly function?: string;
     readonly args?: readonly unknown[];
@@ -134,18 +138,16 @@ interface PlanDecision {
         paramIndex: number;
     };
     readonly partitionBy?: readonly string[];
-    readonly orderBy?: readonly {
-        field: string;
-        direction?: 'asc' | 'desc';
-    }[];
+    readonly orderBy?: PlanExpressionOrderBy | readonly JsonAggOrderByEntry[];
     readonly dataType?: string;
     readonly sourceTable?: string;
     readonly relationName?: string;
     readonly relationPath?: string;
     readonly hydrationPrefix?: string;
     readonly relationType?: 'belongsTo' | 'hasMany' | 'hasOne';
-    readonly foreignKey?: string;
-    readonly parentKey?: string;
+    readonly foreignKey?: ColumnListInput;
+    readonly parentKey?: ColumnListInput;
+    readonly orderByFallback?: boolean;
     readonly children?: readonly PlanDecision[];
     readonly intentPath?: string;
     readonly choice?: string;
@@ -350,6 +352,12 @@ declare class PlanCompiler {
     private createHandlerState;
     private schemaForRangeVar;
     private isNqlBindingRoot;
+    private allocateBindingRelationAlias;
+    private buildCorrelatedRelationRefs;
+    private bindingRelationHasCompleteManyToManyProof;
+    private bindingRelationName;
+    private bindingRelationNameLooksRecursive;
+    private compileBindingRecursiveRelationColumnSubquery;
     private compileBindingRelationColumnSubquery;
     private compileExpressionSubquery;
     private compileGenericNqlFunction;
@@ -625,6 +633,7 @@ declare function generateDownSQL(diff: SchemaDiff, options?: MigrationSQLOptions
  * Migration File Format v2 — UP + DOWN sections.
  *
  * File format:
+ *   -- dbsp:destructive: true|false
  *   <UP statements>;
  *   -- DOWN
  *   <DOWN statements>;
@@ -641,6 +650,7 @@ interface ParsedMigrationFile {
     readonly upStatements: readonly string[];
     readonly downStatements: readonly string[];
     readonly hasDown: boolean;
+    readonly destructive?: boolean | undefined;
 }
 /**
  * Generate a migration file content with UP and DOWN sections.
@@ -1151,8 +1161,8 @@ interface Decision {
     readonly direction?: 'ASC' | 'DESC';
     readonly nulls?: 'FIRST' | 'LAST';
     readonly joinType?: 'inner' | 'left';
-    readonly sourceColumn?: string;
-    readonly targetColumn?: string;
+    readonly sourceColumn?: ColumnListInput;
+    readonly targetColumn?: ColumnListInput;
     readonly targetTable?: string;
     readonly function?: string;
     readonly args?: readonly unknown[];
@@ -1176,14 +1186,15 @@ interface Decision {
     readonly hydrationPrefix?: string;
     readonly include?: readonly Decision[];
     readonly relationType?: 'belongsTo' | 'hasMany' | 'hasOne';
-    readonly foreignKey?: string;
-    readonly parentKey?: string;
+    readonly foreignKey?: ColumnListInput;
+    readonly parentKey?: ColumnListInput;
+    readonly orderByFallback?: boolean;
     readonly children?: readonly Decision[];
     readonly partition?: readonly string[];
     readonly orderBy?: readonly {
         column: string;
         direction?: 'ASC' | 'DESC';
-    }[];
+    }[] | readonly JsonAggOrderByEntry[];
     readonly frame?: string;
     readonly maxDepth?: number;
     readonly pathColumn?: string;