[CAE-342] Initial sentinel issues fix

package.json

@@ -21,6 +21,7 @@
     "release-it": "^17.0.3",
     "tsx": "^4.7.0",
     "typedoc": "^0.25.7",
-    "typescript": "^5.3.3"
+    "typescript": "^5.3.3",
+    "ts-node": "^10.9.2"
   }
 }

packages/client/lib/client/index.ts

@@ -299,6 +299,9 @@ export default class RedisClient<
   #monitorCallback?: MonitorCallback<TYPE_MAPPING>;
   private _self = this;
   private _commandOptions?: CommandOptions<TYPE_MAPPING>;
+  // flag used to annotate that the client 
+  // was in a watch transaction when 
+  // a topology change occured
   #dirtyWatch?: string;
   #epoch: number;
   #watchEpoch?: number; 
@@ -325,6 +328,20 @@ export default class RedisClient<
     return this._self.#watchEpoch !== undefined;
   }
 
+  /**
+   * Indicates whether the client's WATCH command has been invalidated by a topology change.
+   * When this returns true, any transaction using WATCH will fail with a WatchError.
+   * @returns true if the watched keys have been modified, false otherwise
+   */
+  get isDirtyWatch(): boolean {
+    return this._self.#dirtyWatch !== undefined
+  }
+
+  /**
+   * Marks the client's WATCH command as invalidated due to a topology change.
+   * This will cause any subsequent EXEC in a transaction to fail with a WatchError.
+   * @param msg - The error message explaining why the WATCH is dirty
+   */
   setDirtyWatch(msg: string) {
     this._self.#dirtyWatch = msg;
   }