monsqlize 2.0.5 → 3.0.0

package/dist/cjs/transaction/Transaction.cjs

@@ -3,6 +3,52 @@
 // src/capabilities/transaction/index.ts
 var import_node_crypto = require("node:crypto");
 
+// src/core/cache-invalidation-barrier.ts
+var READ_CACHE_PATTERN_PREFIXES = /* @__PURE__ */ new Set([
+  "find",
+  "findOne",
+  "count",
+  "findOneById",
+  "findByIds",
+  "findPage",
+  "findPageTotals",
+  "aggregate",
+  "distinct"
+]);
+function buildCacheInvalidationBarrierKey(namespace) {
+  return `cacheDirty:${namespace}`;
+}
+function extractCacheInvalidationBarrierNamespaces(values) {
+  const namespaces = /* @__PURE__ */ new Set();
+  for (const value of values) {
+    if (!value) {
+      continue;
+    }
+    if (!value.includes("*")) {
+      namespaces.add(value);
+      continue;
+    }
+    const match = /^([^:]+):(.+):\*$/.exec(value);
+    if (match && READ_CACHE_PATTERN_PREFIXES.has(match[1])) {
+      namespaces.add(match[2]);
+    }
+  }
+  return [...namespaces];
+}
+async function clearCacheInvalidationBarrier(cache, namespacesOrPatterns) {
+  if (!cache) {
+    return;
+  }
+  const remove = cache.del ?? cache.delete;
+  if (!remove) {
+    return;
+  }
+  const namespaces = extractCacheInvalidationBarrierNamespaces(namespacesOrPatterns);
+  for (const namespace of namespaces) {
+    await Promise.resolve(remove.call(cache, buildCacheInvalidationBarrierKey(namespace)));
+  }
+}
+
 // src/core/errors/index.ts
 var ErrorCodes = {
   INVALID_ARGUMENT: "INVALID_ARGUMENT",
@@ -99,6 +145,9 @@ var Transaction = class {
     this.startedAt = null;
     this.timeoutTimer = null;
     this.pendingInvalidations = /* @__PURE__ */ new Set();
+    this.pendingInvalidationIntents = /* @__PURE__ */ new Map();
+    this.recordedWriteOperationCount = 0;
+    this.recordedInvalidationCount = 0;
     this.session.__monSQLizeTransaction = this;
   }
   /**
@@ -117,7 +166,9 @@ var Transaction = class {
       this.timeoutTimer = setTimeout(() => {
         if (this.state === "active") {
           this.options.logger?.warn?.(`[Transaction] auto-abort on timeout: ${this.id}`);
-          void this.abort();
+          void this.abort().catch((error) => {
+            this.options.logger?.warn?.("[Transaction] auto-abort failed.", error);
+          });
         }
       }, timeout);
       this.timeoutTimer.unref?.();
@@ -132,12 +183,24 @@ var Transaction = class {
       throw createError(ErrorCodes.INVALID_OPERATION, `Cannot commit transaction in state: ${this.state}`);
     }
     if (typeof this.session.commitTransaction === "function") {
-      await this.session.commitTransaction();
+      await commitTransactionWithRetry(this.session, this.options.logger);
     }
     this.state = "committed";
-    this.options.lockManager?.releaseLocks(this.id);
-    this.pendingInvalidations.clear();
-    this.clearTimeout();
+    try {
+      try {
+        await this.flushPendingInvalidations();
+      } catch (error) {
+        this.options.logger?.warn?.("[Transaction] post-commit cache invalidation failed.", error);
+      }
+    } finally {
+      await this.clearPendingInvalidationBarriers().catch((error) => {
+        this.options.logger?.warn?.("[Transaction] failed to clear cache invalidation barrier.", error);
+      });
+      this.options.lockManager?.releaseLocks(this.id);
+      this.pendingInvalidations.clear();
+      this.pendingInvalidationIntents.clear();
+      this.clearTimeout();
+    }
   }
   /**
    * Roll back the transaction.
@@ -147,15 +210,21 @@ var Transaction = class {
     if (this.state !== "pending" && this.state !== "active") {
       return;
     }
-    if (this.state === "active") {
-      if (typeof this.session.abortTransaction === "function") {
-        await this.session.abortTransaction();
+    try {
+      if (this.state === "active") {
+        if (typeof this.session.abortTransaction === "function") {
+          await this.session.abortTransaction();
+        }
       }
+    } catch (error) {
+      this.options.logger?.warn?.("[Transaction] abortTransaction failed.", error);
+    } finally {
+      this.state = "aborted";
+      this.options.lockManager?.releaseLocks(this.id);
+      this.pendingInvalidations.clear();
+      this.pendingInvalidationIntents.clear();
+      this.clearTimeout();
     }
-    this.state = "aborted";
-    this.options.lockManager?.releaseLocks(this.id);
-    this.pendingInvalidations.clear();
-    this.clearTimeout();
   }
   /**
    * End the transaction session.
@@ -171,10 +240,45 @@ var Transaction = class {
    * @since v1.4.0
    */
   async recordInvalidation(pattern) {
-    this.pendingInvalidations.add(pattern);
-    this.options.lockManager?.addLock(pattern, this.id);
-    if (this.options.cache?.delPattern) {
-      await this.options.cache.delPattern(pattern);
+    await this.recordCacheInvalidation({ type: "pattern", value: pattern });
+  }
+  async recordCacheInvalidation(intent) {
+    if (!intent.value) {
+      return;
+    }
+    const id = `${intent.type}:${intent.value}`;
+    if (!this.pendingInvalidationIntents.has(id)) {
+      this.recordedInvalidationCount += 1;
+    }
+    this.pendingInvalidationIntents.set(id, intent);
+    this.pendingInvalidations.add(intent.value);
+    this.options.lockManager?.addLock(intent.value, this.id);
+  }
+  recordWriteOperation() {
+    this.recordedWriteOperationCount += 1;
+  }
+  async flushPendingInvalidations() {
+    if (!this.options.cache) {
+      return;
+    }
+    const cacheWithDelete = this.options.cache;
+    for (const intent of this.pendingInvalidationIntents.values()) {
+      if (intent.type === "pattern") {
+        await this.options.cache.delPattern?.(intent.value);
+      } else if (typeof cacheWithDelete.del === "function") {
+        await cacheWithDelete.del(intent.value);
+      } else if (typeof cacheWithDelete.delete === "function") {
+        await cacheWithDelete.delete(intent.value);
+      }
+    }
+  }
+  async clearPendingInvalidationBarriers() {
+    if (!this.options.cache || this.pendingInvalidationIntents.size === 0) {
+      return;
+    }
+    const patterns = [...this.pendingInvalidationIntents.values()].filter((intent) => intent.type === "pattern").map((intent) => intent.value);
+    if (patterns.length > 0) {
+      await clearCacheInvalidationBarrier(this.options.cache, patterns);
     }
   }
   /**
@@ -208,11 +312,14 @@ var Transaction = class {
       id: this.id,
       state: this.state,
       duration: this.getDuration(),
-      hasWriteOperation: this.pendingInvalidations.size > 0,
-      operationCount: this.pendingInvalidations.size,
-      lockedKeysCount: this.pendingInvalidations.size
+      hasWriteOperation: this.hasWriteOperation(),
+      operationCount: this.recordedWriteOperationCount || this.recordedInvalidationCount,
+      lockedKeysCount: this.recordedInvalidationCount
     };
   }
+  hasWriteOperation() {
+    return this.recordedWriteOperationCount > 0 || this.recordedInvalidationCount > 0;
+  }
   clearTimeout() {
     if (this.timeoutTimer) {
       clearTimeout(this.timeoutTimer);
@@ -238,6 +345,31 @@ function stringifySessionId(id) {
   }
   return String(id);
 }
+function isUnknownTransactionCommitResult(error) {
+  if (!error || typeof error !== "object") {
+    return false;
+  }
+  const candidate = error;
+  return typeof candidate.hasErrorLabel === "function" && candidate.hasErrorLabel("UnknownTransactionCommitResult");
+}
+async function commitTransactionWithRetry(session, logger) {
+  const maxAttempts = 3;
+  for (let attempt = 0; attempt < maxAttempts; attempt += 1) {
+    try {
+      await session.commitTransaction();
+      return;
+    } catch (error) {
+      if (!isUnknownTransactionCommitResult(error) || attempt === maxAttempts - 1) {
+        throw error;
+      }
+      logger?.warn?.(`[Transaction] retrying commit after UnknownTransactionCommitResult (attempt ${attempt + 2}/${maxAttempts})`);
+      await sleep(100 * (attempt + 1));
+    }
+  }
+}
+async function sleep(ms) {
+  await new Promise((resolve) => setTimeout(resolve, ms));
+}
 
 // src/entry/compat/transaction/Transaction.ts
 module.exports = Transaction;

package/dist/cjs/transaction/TransactionManager.cjs

@@ -3,6 +3,52 @@
 // src/capabilities/transaction/index.ts
 var import_node_crypto = require("node:crypto");
 
+// src/core/cache-invalidation-barrier.ts
+var READ_CACHE_PATTERN_PREFIXES = /* @__PURE__ */ new Set([
+  "find",
+  "findOne",
+  "count",
+  "findOneById",
+  "findByIds",
+  "findPage",
+  "findPageTotals",
+  "aggregate",
+  "distinct"
+]);
+function buildCacheInvalidationBarrierKey(namespace) {
+  return `cacheDirty:${namespace}`;
+}
+function extractCacheInvalidationBarrierNamespaces(values) {
+  const namespaces = /* @__PURE__ */ new Set();
+  for (const value of values) {
+    if (!value) {
+      continue;
+    }
+    if (!value.includes("*")) {
+      namespaces.add(value);
+      continue;
+    }
+    const match = /^([^:]+):(.+):\*$/.exec(value);
+    if (match && READ_CACHE_PATTERN_PREFIXES.has(match[1])) {
+      namespaces.add(match[2]);
+    }
+  }
+  return [...namespaces];
+}
+async function clearCacheInvalidationBarrier(cache, namespacesOrPatterns) {
+  if (!cache) {
+    return;
+  }
+  const remove = cache.del ?? cache.delete;
+  if (!remove) {
+    return;
+  }
+  const namespaces = extractCacheInvalidationBarrierNamespaces(namespacesOrPatterns);
+  for (const namespace of namespaces) {
+    await Promise.resolve(remove.call(cache, buildCacheInvalidationBarrierKey(namespace)));
+  }
+}
+
 // src/core/errors/index.ts
 var ErrorCodes = {
   INVALID_ARGUMENT: "INVALID_ARGUMENT",
@@ -99,6 +145,9 @@ var Transaction = class {
     this.startedAt = null;
     this.timeoutTimer = null;
     this.pendingInvalidations = /* @__PURE__ */ new Set();
+    this.pendingInvalidationIntents = /* @__PURE__ */ new Map();
+    this.recordedWriteOperationCount = 0;
+    this.recordedInvalidationCount = 0;
     this.session.__monSQLizeTransaction = this;
   }
   /**
@@ -117,7 +166,9 @@ var Transaction = class {
       this.timeoutTimer = setTimeout(() => {
         if (this.state === "active") {
           this.options.logger?.warn?.(`[Transaction] auto-abort on timeout: ${this.id}`);
-          void this.abort();
+          void this.abort().catch((error) => {
+            this.options.logger?.warn?.("[Transaction] auto-abort failed.", error);
+          });
         }
       }, timeout);
       this.timeoutTimer.unref?.();
@@ -132,12 +183,24 @@ var Transaction = class {
       throw createError(ErrorCodes.INVALID_OPERATION, `Cannot commit transaction in state: ${this.state}`);
     }
     if (typeof this.session.commitTransaction === "function") {
-      await this.session.commitTransaction();
+      await commitTransactionWithRetry(this.session, this.options.logger);
     }
     this.state = "committed";
-    this.options.lockManager?.releaseLocks(this.id);
-    this.pendingInvalidations.clear();
-    this.clearTimeout();
+    try {
+      try {
+        await this.flushPendingInvalidations();
+      } catch (error) {
+        this.options.logger?.warn?.("[Transaction] post-commit cache invalidation failed.", error);
+      }
+    } finally {
+      await this.clearPendingInvalidationBarriers().catch((error) => {
+        this.options.logger?.warn?.("[Transaction] failed to clear cache invalidation barrier.", error);
+      });
+      this.options.lockManager?.releaseLocks(this.id);
+      this.pendingInvalidations.clear();
+      this.pendingInvalidationIntents.clear();
+      this.clearTimeout();
+    }
   }
   /**
    * Roll back the transaction.
@@ -147,15 +210,21 @@ var Transaction = class {
     if (this.state !== "pending" && this.state !== "active") {
       return;
     }
-    if (this.state === "active") {
-      if (typeof this.session.abortTransaction === "function") {
-        await this.session.abortTransaction();
+    try {
+      if (this.state === "active") {
+        if (typeof this.session.abortTransaction === "function") {
+          await this.session.abortTransaction();
+        }
       }
+    } catch (error) {
+      this.options.logger?.warn?.("[Transaction] abortTransaction failed.", error);
+    } finally {
+      this.state = "aborted";
+      this.options.lockManager?.releaseLocks(this.id);
+      this.pendingInvalidations.clear();
+      this.pendingInvalidationIntents.clear();
+      this.clearTimeout();
     }
-    this.state = "aborted";
-    this.options.lockManager?.releaseLocks(this.id);
-    this.pendingInvalidations.clear();
-    this.clearTimeout();
   }
   /**
    * End the transaction session.
@@ -171,10 +240,45 @@ var Transaction = class {
    * @since v1.4.0
    */
   async recordInvalidation(pattern) {
-    this.pendingInvalidations.add(pattern);
-    this.options.lockManager?.addLock(pattern, this.id);
-    if (this.options.cache?.delPattern) {
-      await this.options.cache.delPattern(pattern);
+    await this.recordCacheInvalidation({ type: "pattern", value: pattern });
+  }
+  async recordCacheInvalidation(intent) {
+    if (!intent.value) {
+      return;
+    }
+    const id = `${intent.type}:${intent.value}`;
+    if (!this.pendingInvalidationIntents.has(id)) {
+      this.recordedInvalidationCount += 1;
+    }
+    this.pendingInvalidationIntents.set(id, intent);
+    this.pendingInvalidations.add(intent.value);
+    this.options.lockManager?.addLock(intent.value, this.id);
+  }
+  recordWriteOperation() {
+    this.recordedWriteOperationCount += 1;
+  }
+  async flushPendingInvalidations() {
+    if (!this.options.cache) {
+      return;
+    }
+    const cacheWithDelete = this.options.cache;
+    for (const intent of this.pendingInvalidationIntents.values()) {
+      if (intent.type === "pattern") {
+        await this.options.cache.delPattern?.(intent.value);
+      } else if (typeof cacheWithDelete.del === "function") {
+        await cacheWithDelete.del(intent.value);
+      } else if (typeof cacheWithDelete.delete === "function") {
+        await cacheWithDelete.delete(intent.value);
+      }
+    }
+  }
+  async clearPendingInvalidationBarriers() {
+    if (!this.options.cache || this.pendingInvalidationIntents.size === 0) {
+      return;
+    }
+    const patterns = [...this.pendingInvalidationIntents.values()].filter((intent) => intent.type === "pattern").map((intent) => intent.value);
+    if (patterns.length > 0) {
+      await clearCacheInvalidationBarrier(this.options.cache, patterns);
     }
   }
   /**
@@ -208,11 +312,14 @@ var Transaction = class {
       id: this.id,
       state: this.state,
       duration: this.getDuration(),
-      hasWriteOperation: this.pendingInvalidations.size > 0,
-      operationCount: this.pendingInvalidations.size,
-      lockedKeysCount: this.pendingInvalidations.size
+      hasWriteOperation: this.hasWriteOperation(),
+      operationCount: this.recordedWriteOperationCount || this.recordedInvalidationCount,
+      lockedKeysCount: this.recordedInvalidationCount
     };
   }
+  hasWriteOperation() {
+    return this.recordedWriteOperationCount > 0 || this.recordedInvalidationCount > 0;
+  }
   clearTimeout() {
     if (this.timeoutTimer) {
       clearTimeout(this.timeoutTimer);
@@ -303,6 +410,9 @@ var TransactionManager = class {
         lastError = error;
         await transaction.abort();
         this.recordStats(transaction, Date.now() - startedAt, false);
+        if (transaction.state === "committed") {
+          throw error;
+        }
         if (!enableRetry || attempt === maxRetries || !isTransientTransactionError(error)) {
           throw error;
         }
@@ -364,7 +474,7 @@ var TransactionManager = class {
     } else {
       this.stats.failedTransactions += 1;
     }
-    if (transaction.pendingInvalidations.size > 0) {
+    if (transaction.hasWriteOperation()) {
       this.stats.writeTransactions += 1;
     } else {
       this.stats.readOnlyTransactions += 1;
@@ -414,6 +524,28 @@ function isTransientTransactionError(error) {
   }
   return candidate.code === 112 || candidate.code === 117;
 }
+function isUnknownTransactionCommitResult(error) {
+  if (!error || typeof error !== "object") {
+    return false;
+  }
+  const candidate = error;
+  return typeof candidate.hasErrorLabel === "function" && candidate.hasErrorLabel("UnknownTransactionCommitResult");
+}
+async function commitTransactionWithRetry(session, logger) {
+  const maxAttempts = 3;
+  for (let attempt = 0; attempt < maxAttempts; attempt += 1) {
+    try {
+      await session.commitTransaction();
+      return;
+    } catch (error) {
+      if (!isUnknownTransactionCommitResult(error) || attempt === maxAttempts - 1) {
+        throw error;
+      }
+      logger?.warn?.(`[Transaction] retrying commit after UnknownTransactionCommitResult (attempt ${attempt + 2}/${maxAttempts})`);
+      await sleep(100 * (attempt + 1));
+    }
+  }
+}
 async function sleep(ms) {
   await new Promise((resolve) => setTimeout(resolve, ms));
 }