@vibeorm/sql 5.3.0 → 5.4.0

package/dist/ast.d.ts

@@ -868,10 +868,21 @@ export type SelectStatement = {
  * The lock a locking read takes: one strength, one wait policy. Both members
  * are REQUIRED here — defaulting happens once, in the query builder, so the
  * rendered SQL is a function of the AST alone.
+ *
+ * `of` narrows the lock to named FROM items (`FOR UPDATE OF "Parent"`). The
+ * join relation strategy needs it: its statement also reads child rows through
+ * `LEFT JOIN LATERAL` subqueries, and an unnarrowed clause is refused by
+ * postgres ("FOR UPDATE is not allowed with aggregate functions", from the
+ * children's `json_agg`). With `of` naming the statement's own table only the
+ * parent rows are locked. Each name must be the statement's table alias, or its
+ * unqualified table name when it has no alias — the only FROM item the AST
+ * names; the renderer refuses anything else. Dialects without a locking-read
+ * clause render nothing, as for a lock without `of`.
  */
 export type RowLock = {
     readonly strength: RowLockStrength;
     readonly wait: RowLockWaitPolicy;
+    readonly of?: readonly string[];
 };
 /**
  * Sentinel VALUES cell: render the `DEFAULT` keyword instead of a placeholder

package/dist/index.js

@@ -2960,6 +2960,12 @@ function renderRowLockClause(params) {
       hint: `${dialect.name} can express: ${Object.keys(syntax.wait).join(", ")}`
     });
   }
+  if (lock.of !== undefined) {
+    if (lock.of.length === 0)
+      throw internalError({ message: "a row lock's `of` list cannot be empty" });
+    const tables = lock.of.map((name) => dialect.quoteIdent({ name })).join(", ");
+    return `${strengthText} OF ${tables}${waitText}`;
+  }
   return `${strengthText}${waitText}`;
 }
 var ADVISORY_KEY_BOUNDS = Object.freeze({
@@ -5136,6 +5142,13 @@ function renderSelect(params) {
     text += ` OFFSET ${statement.offset}`;
   }
   if (statement.rowLock !== undefined) {
+    const target = statement.table.alias ?? statement.table.name;
+    if (statement.rowLock.of !== undefined && statement.rowLock.of.some((name) => name !== target)) {
+      throw internalError4({ message: `a row lock's \`of\` list may name only the statement's own table "${target}"` });
+    }
+    if (statement.rowLock.of !== undefined && (statement.fromSelect !== undefined || statement.keyPage !== undefined)) {
+      throw internalError4({ message: "a row lock's `of` list cannot name a derived table" });
+    }
     const clause = renderRowLockClause({ dialect, lock: statement.rowLock });
     if (clause !== null)
       text += ` ${clause}`;
@@ -6445,4 +6458,4 @@ export {
   toPgArrayLiteral
 };
 
-//# debugId=A6FF0AC9CFF5903864756E2164756E21
+//# debugId=11C29D1889ACA76B64756E2164756E21