@dbsp/adapter-pgsql 1.3.0 → 1.5.0

package/README.md

@@ -42,6 +42,10 @@ const { sql, params } = orm.select('users').where(eq('active', true)).dump();
 // sql, params — no Pool needed
 ```
 
+### Direct NQL bundles
+
+`adapter.compile(compiledNqlBundle, options)` trusts that direct `CompiledNqlQuery` bundles are well-formed and semantically validated by the NQL compiler. The adapter still enforces SQL safety for emitted binding names, including identifier validation and binding/table or binding/binding collision checks before emitting `WITH` CTEs.
+
 ## Key features
 
 - **Parameterized queries** — All user values use `$N` positional parameters; no SQL injection surface

package/dist/index.d.ts

@@ -261,6 +261,7 @@ interface CompiledResult {
 interface CompilerOptions {
     readonly naming?: NamingPlugin;
     readonly schema?: string;
+    readonly dialectCapabilities?: DialectCapabilities;
     /** Default primary key column name convention (default: 'id') */
     readonly defaultPkColumnName?: string;
     /** Convention for deriving FK column names: (tableName, pkName) => fkColumnName */
@@ -276,6 +277,7 @@ declare class PlanCompiler {
     private readonly defaultPk;
     private readonly deriveFk;
     private readonly model;
+    private readonly dialectCapabilities;
     private readonly bindingNames;
     /** Mutable state shared with extracted condition/value compilation functions */
     private state;
@@ -287,6 +289,8 @@ declare class PlanCompiler {
     private rawJoins;
     /** CTE nodes from include handlers (e.g., CTE strategy) */
     private pendingCtes;
+    /** Local aliases for binding relation-column scalar subqueries. */
+    private bindingRelationColumnSubqueryIndex;
     /**
      * Maps relation-dotted include path → JOIN alias for multi-hop FK resolution.
      * Populated as join decisions are compiled so later hops can find the
@@ -300,6 +304,7 @@ declare class PlanCompiler {
      */
     private usedJoinAliases;
     constructor(options?: CompilerOptions);
+    private childCompilerOptions;
     /** Build immutable context for handler-based WHERE compilation */
     private handlerCtx;
     private findAliasForLegacySourceTable;
@@ -343,6 +348,9 @@ declare class PlanCompiler {
     private createHandlerContext;
     /** Build a fresh HandlerCompilerState sharing the current parameter array. */
     private createHandlerState;
+    private schemaForRangeVar;
+    private isNqlBindingRoot;
+    private compileBindingRelationColumnSubquery;
     private compileExpressionSubquery;
     private compileGenericNqlFunction;
     private compileNqlFunctionArg;
@@ -1067,6 +1075,8 @@ interface CompilerContext {
     readonly naming: NamingPlugin;
     /** Schema name for table qualification (optional) */
     readonly schema?: string;
+    /** Dialect capabilities for adapter-layer SQL surface gates */
+    readonly dialectCapabilities?: DialectCapabilities;
     /** Root table name for the query */
     readonly rootTable: string;
     /** Current table alias (for JOINs) */
@@ -1669,6 +1679,11 @@ declare class PgsqlAdapter<DB = unknown> implements Adapter<DB> {
     getPoolInstance(): Pool;
     /**
      * Compile a plan to executable SQL.
+     *
+     * When passed a direct `CompiledNqlQuery`, the adapter trusts that the bundle
+     * has already been semantically validated by the NQL compiler. This method
+     * still performs adapter-owned SQL safety checks for emitted binding names
+     * before CTE emission.
      */
     compile<T = unknown>(plan: PlanReport | CompiledNqlQuery, options?: CompileOptions): CompiledQuery<T>;
     /**