@dbsp/core 1.6.0 → 1.7.0

package/dist/index.d.ts

@@ -3097,10 +3097,6 @@ declare class IntentBuilder<TResult = unknown> {
      * Apply relation hints to includes that don't have explicit `via`.
      */
     applyRelationHints(intent: QueryIntent): QueryIntent;
-    /**
-     * Apply relation hint to a single include (recursively).
-     */
-    private applyHintToInclude;
     /**
      * Clone the current state for immutable builder pattern.
      */
@@ -4444,10 +4440,6 @@ declare class QueryBuilderImpl<TResult = unknown> implements QueryBuilder<TResul
      */
     /** @internal — called by stream-impl */
     applyRelationHints(intent: QueryIntent): QueryIntent;
-    /**
-     * Apply relation hint to a single include (recursively).
-     */
-    private applyHintToInclude;
     /**
      * Build the QueryIntent from current state.
      * Handles exactOptionalPropertyTypes by only including defined properties.
@@ -6670,6 +6662,19 @@ declare class AmbiguousRelationError extends Error {
  * ```
  */
 declare function findClosestMatch(target: string, candidates: readonly string[]): string | undefined;
+type TableScopedErrorOptions = {
+    table: string;
+    requested: string;
+    available: readonly string[];
+};
+declare abstract class TableScopedError extends Error {
+    readonly table: string;
+    readonly requested: string;
+    readonly available: readonly string[];
+    readonly suggestion?: string;
+    readonly publicMessage: string;
+    protected constructor(opts: TableScopedErrorOptions, genericMessage: string);
+}
 /**
  * Error thrown when a requested relation does not exist.
  *
@@ -6688,7 +6693,7 @@ declare function findClosestMatch(target: string, candidates: readonly string[])
  * // err.suggestion === 'comments'
  * ```
  */
-declare class RelationNotFoundError extends Error {
+declare class RelationNotFoundError extends TableScopedError {
     readonly name: "RelationNotFoundError";
     /**
      * The table where the relation was requested.
@@ -6807,7 +6812,7 @@ declare class TableNotFoundError extends Error {
  * // err.suggestion === 'email'
  * ```
  */
-declare class ColumnNotFoundError extends Error {
+declare class ColumnNotFoundError extends TableScopedError {
     readonly name: "ColumnNotFoundError";
     /**
      * The table where the column was requested.

package/dist/index.js

@@ -1803,31 +1803,14 @@ function levenshteinDistance(a, b) {
   const lastRow = matrix[b.length];
   return lastRow ? lastRow[a.length] ?? 0 : 0;
 }
-var RelationNotFoundError = class _RelationNotFoundError extends Error {
-  name = "RelationNotFoundError";
-  /**
-   * The table where the relation was requested.
-   */
+var TableScopedError = class extends Error {
   table;
-  /**
-   * The relation name that was requested but not found.
-   */
   requested;
-  /**
-   * Available relations on this table.
-   */
   available;
-  /**
-   * Suggested relation name (fuzzy match), if any.
-   */
   suggestion;
-  /**
-   * Public-safe message (no schema enumeration).
-   */
   publicMessage;
-  constructor(opts) {
+  constructor(opts, genericMessage) {
     const suggestion = findClosestMatch(opts.requested, opts.available);
-    const genericMessage = "Relation not found";
     super(genericMessage);
     this.table = opts.table;
     this.requested = opts.requested;
@@ -1836,6 +1819,12 @@ var RelationNotFoundError = class _RelationNotFoundError extends Error {
     if (suggestion !== void 0) {
       this.suggestion = suggestion;
     }
+  }
+};
+var RelationNotFoundError = class _RelationNotFoundError extends TableScopedError {
+  name = "RelationNotFoundError";
+  constructor(opts) {
+    super(opts, "Relation not found");
     Object.setPrototypeOf(this, _RelationNotFoundError.prototype);
   }
 };
@@ -1923,39 +1912,10 @@ var TableNotFoundError = class _TableNotFoundError extends Error {
     Object.setPrototypeOf(this, _TableNotFoundError.prototype);
   }
 };
-var ColumnNotFoundError = class _ColumnNotFoundError extends Error {
+var ColumnNotFoundError = class _ColumnNotFoundError extends TableScopedError {
   name = "ColumnNotFoundError";
-  /**
-   * The table where the column was requested.
-   */
-  table;
-  /**
-   * The column name that was requested but not found.
-   */
-  requested;
-  /**
-   * Available columns on this table.
-   */
-  available;
-  /**
-   * Suggested column name (fuzzy match), if any.
-   */
-  suggestion;
-  /**
-   * Public-safe message (no schema enumeration).
-   */
-  publicMessage;
   constructor(opts) {
-    const suggestion = findClosestMatch(opts.requested, opts.available);
-    const genericMessage = "Column not found";
-    super(genericMessage);
-    this.table = opts.table;
-    this.requested = opts.requested;
-    this.available = opts.available;
-    this.publicMessage = genericMessage;
-    if (suggestion !== void 0) {
-      this.suggestion = suggestion;
-    }
+    super(opts, "Column not found");
     Object.setPrototypeOf(this, _ColumnNotFoundError.prototype);
   }
 };
@@ -4611,6 +4571,32 @@ function createHookManager() {
   return new HookManagerImpl();
 }
 
+// src/dx/include-hints.ts
+function applyHintToIncludeRecursive(inc, relationHints) {
+  if (inc.via !== void 0) {
+    if (inc.include && inc.include.length > 0) {
+      return {
+        ...inc,
+        include: inc.include.map(
+          (nested) => applyHintToIncludeRecursive(nested, relationHints)
+        )
+      };
+    }
+    return inc;
+  }
+  const hint = relationHints[inc.relation];
+  const result = hint ? { ...inc, via: hint } : inc;
+  if (result.include && result.include.length > 0) {
+    return {
+      ...result,
+      include: result.include.map(
+        (nested) => applyHintToIncludeRecursive(nested, relationHints)
+      )
+    };
+  }
+  return result;
+}
+
 // src/dx/subquery-builder.ts
 var SubqueryBuilder = class _SubqueryBuilder {
   _from;
@@ -5258,38 +5244,13 @@ var IntentBuilder = class _IntentBuilder {
       return intent;
     }
     const updatedIncludes = intent.include.map(
-      (inc) => this.applyHintToInclude(inc)
+      (inc) => applyHintToIncludeRecursive(inc, this.relationHints)
     );
     return {
       ...intent,
       include: updatedIncludes
     };
   }
-  /**
-   * Apply relation hint to a single include (recursively).
-   */
-  applyHintToInclude(inc) {
-    if (inc.via !== void 0) {
-      if (inc.include && inc.include.length > 0) {
-        return {
-          ...inc,
-          include: inc.include.map((nested) => this.applyHintToInclude(nested))
-        };
-      }
-      return inc;
-    }
-    const hint = this.relationHints[inc.relation];
-    const result = hint ? { ...inc, via: hint } : inc;
-    if (result.include && result.include.length > 0) {
-      return {
-        ...result,
-        include: result.include.map(
-          (nested) => this.applyHintToInclude(nested)
-        )
-      };
-    }
-    return result;
-  }
   /**
    * Clone the current state for immutable builder pattern.
    */
@@ -6901,11 +6862,13 @@ function toRuntimeBindingRow(bindName, row, columns, dbCasing) {
 }
 function createRuntimeBinding(bundle, bindName, rows, dbCasing) {
   const columns = requireMutationBindingColumns(bundle, bindName);
+  const columnTypes = bundle.bindingOutputSchemas?.get(bindName)?.columnTypes;
   return {
     columns,
     rows: rows.map(
       (row) => toRuntimeBindingRow(bindName, row, columns, dbCasing)
-    )
+    ),
+    ...columnTypes !== void 0 && { columnTypes }
   };
 }
 function bindingEntryIsFinal(compiledIntent, bindName, boundQuery, sourceBundle) {
@@ -7536,6 +7499,14 @@ var NqlBuilderImpl = class {
     const runtimeBindings = /* @__PURE__ */ new Map();
     const sequence = [];
     const steps = createNqlProgramSteps(compiledIntent);
+    const dumpRuntimeBindingPreview = (bindName) => {
+      const columnTypes = sourceBundle.bindingOutputSchemas?.get(bindName)?.columnTypes;
+      return {
+        columns: requireMutationBindingColumns(sourceBundle, bindName),
+        rows: [],
+        ...columnTypes !== void 0 && { columnTypes }
+      };
+    };
     for (const step of steps) {
       if (step.kind === "mutation") {
         const statementBundle = this.createNqlStatementBundle(
@@ -7556,10 +7527,10 @@ var NqlBuilderImpl = class {
           params: compiled.parameters
         });
         if (step.bindName !== void 0) {
-          runtimeBindings.set(step.bindName, {
-            columns: requireMutationBindingColumns(sourceBundle, step.bindName),
-            rows: []
-          });
+          runtimeBindings.set(
+            step.bindName,
+            dumpRuntimeBindingPreview(step.bindName)
+          );
         }
       } else {
         const planReport = step.final && isBindingFinalQuery(compiledIntent.bundle) && compiledIntent.kind === "query" ? createBindingFinalPlan(
@@ -7587,10 +7558,10 @@ var NqlBuilderImpl = class {
           params: compiled.parameters
         });
         if (step.snapshot === true && step.bindName !== void 0) {
-          runtimeBindings.set(step.bindName, {
-            columns: requireMutationBindingColumns(sourceBundle, step.bindName),
-            rows: []
-          });
+          runtimeBindings.set(
+            step.bindName,
+            dumpRuntimeBindingPreview(step.bindName)
+          );
         }
       }
       if (step.bindName !== void 0) {
@@ -9542,38 +9513,13 @@ var QueryBuilderImpl = class _QueryBuilderImpl {
       return intent;
     }
     const updatedIncludes = intent.include.map(
-      (inc) => this.applyHintToInclude(inc)
+      (inc) => applyHintToIncludeRecursive(inc, this.relationHints)
     );
     return {
       ...intent,
       include: updatedIncludes
     };
   }
-  /**
-   * Apply relation hint to a single include (recursively).
-   */
-  applyHintToInclude(inc) {
-    if (inc.via !== void 0) {
-      if (inc.include && inc.include.length > 0) {
-        return {
-          ...inc,
-          include: inc.include.map((nested) => this.applyHintToInclude(nested))
-        };
-      }
-      return inc;
-    }
-    const hint = this.relationHints[inc.relation];
-    const result = hint ? { ...inc, via: hint } : inc;
-    if (result.include && result.include.length > 0) {
-      return {
-        ...result,
-        include: result.include.map(
-          (nested) => this.applyHintToInclude(nested)
-        )
-      };
-    }
-    return result;
-  }
   /**
    * Build the QueryIntent from current state.
    * Handles exactOptionalPropertyTypes by only including defined properties.