@palbase/backend 38.0.15 → 39.0.0

package/dist/bin/palbase-backend.cjs

@@ -897,6 +897,7 @@ function makeTypedSurface(raw) {
     $facets: /* @__PURE__ */ __name((table, params) => reco.facets(table, params), "$facets"),
     $claim: /* @__PURE__ */ __name((table, unique, extra) => reco.claim(table, unique, extra), "$claim"),
     $lockRows: /* @__PURE__ */ __name((table, ids) => reco.lockRows(table, ids), "$lockRows"),
+    $lockRowsWhere: /* @__PURE__ */ __name((table, where, opts) => reco.lockRowsWhere(table, where, opts), "$lockRowsWhere"),
     $advisoryXactLock: /* @__PURE__ */ __name((key2) => reco.advisoryXactLock(key2), "$advisoryXactLock"),
     $aggregate: /* @__PURE__ */ __name((table, q) => raw.aggregate(table, q), "$aggregate"),
     $insertMany: /* @__PURE__ */ __name((table, rows, opts) => raw.insertMany(table, rows, opts), "$insertMany"),
@@ -1231,7 +1232,7 @@ var DeadlockDetected = class extends Conflict {
     return typeof e === "object" && e !== null && e.name === "DeadlockDetected";
   }
   constructor(sqlstate = SQLSTATE.deadlockDetected, message, data) {
-    super(message ?? "deadlock: iki i\u015Flem birbirinin kilidini bekledi ve bu i\u015Flem iptal edildi \u2014 kilit s\u0131ras\u0131n\u0131 sabitlemek i\xE7in Database.$lockRows(tablo, id'ler) kullan\u0131n", "deadlock_detected", data);
+    super(message ?? "deadlock: iki i\u015Flem birbirinin kilidini bekledi ve bu i\u015Flem iptal edildi \u2014 kilit s\u0131ras\u0131n\u0131 sabitleyin: id'ler elinizdeyse Database.$lockRows(tablo, id'ler), elinizde bir filtre varsa Database.$lockRowsWhere(tablo, filtre) kullan\u0131n", "deadlock_detected", data);
     this.name = "DeadlockDetected";
     this.sqlstate = sqlstate;
   }
@@ -3016,6 +3017,11 @@ var WHERE_OPS = {
   lte: "<=",
   neq: "<>"
 };
+var LOCK_MODES = {
+  update: "FOR UPDATE",
+  share: "FOR SHARE",
+  noKeyUpdate: "FOR NO KEY UPDATE"
+};
 function ftsExprOf(ftsCols) {
   return [
     ...ftsCols
@@ -4009,6 +4015,45 @@ function createOps(tx, context = {}) {
       await (await at()).unsafe(`SELECT t.${quoteIdent(pk)} FROM ${quoteTable(table)} t WHERE t.${quoteIdent(pk)} IN (${list}) ORDER BY t.${quoteIdent(pk)} FOR NO KEY UPDATE`, params);
     },
     /**
+    * Bir FİLTRENİN eşleştiği satırları kilitle — sırayı yine KATMAN koyar
+    * (FR-037).
+    *
+    * `lockRows` kilitlenecek kümeyi çağıranın SAYMASINI istiyor. "Bu hesabın
+    * bekleyen bütün hareketlerini kilitle" bunu yapamaz: id listesi ancak bir
+    * sorguyla çıkar, ve SORGU İLE KİLİT ARASINDAKİ BOŞLUK tam olarak kilidin
+    * kapatması gereken yarıştır — araya giren bir INSERT o listede yoktur ve
+    * kilitlenmez. Burada küme TEK statement'ta hem seçiliyor hem kilitleniyor.
+    *
+    * `ORDER BY <pk>`: `updateMany`'nin kilit CTE'siyle AYNI sıra (FR-037b).
+    * Sırayı iki yolun da katmandan alması, aynı satır kümesine giren iki
+    * transaction'ın ters sırada kilitlemesini imkânsız kılıyor — deadlock'un
+    * bedeli ucuz değil, `deadlock_timeout` varsayılanı 1 SANİYE.
+    *
+    * KİLİT MODU EŞİTLENMEZ (FR-037b): `updateMany` işi UPDATE olduğu için
+    * `FOR NO KEY UPDATE` kullanıyor, ama burada mod ÇAĞIRANIN seçimi. Herkesi
+    * o moda zorlamak, yalnız okuma kilidi isteyeni ihtiyacından fazlasını
+    * almaya zorlardı. Deadlock'u önleyen SIRADIR, mod değil.
+    */
+    async lockRowsWhere(table, where, opts) {
+      const mode = opts?.mode ?? "update";
+      const clause = LOCK_MODES[mode];
+      if (clause === void 0) {
+        throw new Error(`lockRowsWhere(${table}): bilinmeyen mode "${String(mode)}" \u2014 "update" (FOR UPDATE), "share" (FOR SHARE) ya da "noKeyUpdate" (FOR NO KEY UPDATE).`);
+      }
+      const pk = primaryKeyOf(table);
+      if (pk === null) {
+        throw new Error(`lockRowsWhere(${table}): tek-kolon primary key bulunamad\u0131 \u2014 kilit s\u0131ras\u0131 bir anahtar ister (FR-037).`);
+      }
+      const params = [];
+      const add = /* @__PURE__ */ __name((v) => {
+        params.push(v);
+        return `$${params.length}`;
+      }, "add");
+      const whereSql = compileWhere(table, schemaColumns(table), where, add, "lockRowsWhere");
+      assertHasPredicate(whereSql, "lockRowsWhere", table);
+      await (await at()).unsafe(`SELECT t.${quoteIdent(pk)} FROM ${quoteTable(table)} t WHERE true${whereSql} ORDER BY t.${quoteIdent(pk)} ${clause}`, params);
+    },
+    /**
     * Bir idempotency anahtarını SAHİPLEN (FR-033).
     *
     * `{ inserted: true, row }` → bu çağrı yazdı.