memcache 1.1.0 → 1.2.0

package/dist/index.cjs

@@ -1063,16 +1063,8 @@ var Memcache = class extends import_hookified2.Hookified {
     const command = `cas ${key} ${flags} ${exptime} ${bytes} ${casToken}\r
 ${valueStr}`;
     const nodes = await this.getNodesByKey(key);
-    const promises = nodes.map(async (node) => {
-      try {
-        const result = await node.command(command);
-        return result === "STORED";
-      } catch {
-        return false;
-      }
-    });
-    const results = await Promise.all(promises);
-    const success = results.every((result) => result === true);
+    const results = await this.execute(command, nodes);
+    const success = results.every((result) => result === "STORED");
     await this.afterHook("cas", {
       key,
       value,
@@ -1101,16 +1093,8 @@ ${valueStr}`;
     const command = `set ${key} ${flags} ${exptime} ${bytes}\r
 ${valueStr}`;
     const nodes = await this.getNodesByKey(key);
-    const promises = nodes.map(async (node) => {
-      try {
-        const result = await node.command(command);
-        return result === "STORED";
-      } catch {
-        return false;
-      }
-    });
-    const results = await Promise.all(promises);
-    const success = results.every((result) => result === true);
+    const results = await this.execute(command, nodes);
+    const success = results.every((result) => result === "STORED");
     await this.afterHook("set", { key, value, exptime, flags, success });
     return success;
   }
@@ -1132,16 +1116,8 @@ ${valueStr}`;
     const command = `add ${key} ${flags} ${exptime} ${bytes}\r
 ${valueStr}`;
     const nodes = await this.getNodesByKey(key);
-    const promises = nodes.map(async (node) => {
-      try {
-        const result = await node.command(command);
-        return result === "STORED";
-      } catch {
-        return false;
-      }
-    });
-    const results = await Promise.all(promises);
-    const success = results.every((result) => result === true);
+    const results = await this.execute(command, nodes);
+    const success = results.every((result) => result === "STORED");
     await this.afterHook("add", { key, value, exptime, flags, success });
     return success;
   }
@@ -1163,16 +1139,8 @@ ${valueStr}`;
     const command = `replace ${key} ${flags} ${exptime} ${bytes}\r
 ${valueStr}`;
     const nodes = await this.getNodesByKey(key);
-    const promises = nodes.map(async (node) => {
-      try {
-        const result = await node.command(command);
-        return result === "STORED";
-      } catch {
-        return false;
-      }
-    });
-    const results = await Promise.all(promises);
-    const success = results.every((result) => result === true);
+    const results = await this.execute(command, nodes);
+    const success = results.every((result) => result === "STORED");
     await this.afterHook("replace", { key, value, exptime, flags, success });
     return success;
   }
@@ -1192,16 +1160,8 @@ ${valueStr}`;
     const command = `append ${key} 0 0 ${bytes}\r
 ${valueStr}`;
     const nodes = await this.getNodesByKey(key);
-    const promises = nodes.map(async (node) => {
-      try {
-        const result = await node.command(command);
-        return result === "STORED";
-      } catch {
-        return false;
-      }
-    });
-    const results = await Promise.all(promises);
-    const success = results.every((result) => result === true);
+    const results = await this.execute(command, nodes);
+    const success = results.every((result) => result === "STORED");
     await this.afterHook("append", { key, value, success });
     return success;
   }
@@ -1221,16 +1181,8 @@ ${valueStr}`;
     const command = `prepend ${key} 0 0 ${bytes}\r
 ${valueStr}`;
     const nodes = await this.getNodesByKey(key);
-    const promises = nodes.map(async (node) => {
-      try {
-        const result = await node.command(command);
-        return result === "STORED";
-      } catch {
-        return false;
-      }
-    });
-    const results = await Promise.all(promises);
-    const success = results.every((result) => result === true);
+    const results = await this.execute(command, nodes);
+    const success = results.every((result) => result === "STORED");
     await this.afterHook("prepend", { key, value, success });
     return success;
   }
@@ -1245,16 +1197,8 @@ ${valueStr}`;
     await this.beforeHook("delete", { key });
     this.validateKey(key);
     const nodes = await this.getNodesByKey(key);
-    const promises = nodes.map(async (node) => {
-      try {
-        const result = await node.command(`delete ${key}`);
-        return result === "DELETED";
-      } catch {
-        return false;
-      }
-    });
-    const results = await Promise.all(promises);
-    const success = results.every((result) => result === true);
+    const results = await this.execute(`delete ${key}`, nodes);
+    const success = results.every((result) => result === "DELETED");
     await this.afterHook("delete", { key, success });
     return success;
   }
@@ -1270,16 +1214,8 @@ ${valueStr}`;
     await this.beforeHook("incr", { key, value });
     this.validateKey(key);
     const nodes = await this.getNodesByKey(key);
-    const promises = nodes.map(async (node) => {
-      try {
-        const result = await node.command(`incr ${key} ${value}`);
-        return typeof result === "number" ? result : void 0;
-      } catch {
-        return void 0;
-      }
-    });
-    const results = await Promise.all(promises);
-    const newValue = results.find((v) => v !== void 0);
+    const results = await this.execute(`incr ${key} ${value}`, nodes);
+    const newValue = results.find((v) => typeof v === "number");
     await this.afterHook("incr", { key, value, newValue });
     return newValue;
   }
@@ -1295,16 +1231,8 @@ ${valueStr}`;
     await this.beforeHook("decr", { key, value });
     this.validateKey(key);
     const nodes = await this.getNodesByKey(key);
-    const promises = nodes.map(async (node) => {
-      try {
-        const result = await node.command(`decr ${key} ${value}`);
-        return typeof result === "number" ? result : void 0;
-      } catch {
-        return void 0;
-      }
-    });
-    const results = await Promise.all(promises);
-    const newValue = results.find((v) => v !== void 0);
+    const results = await this.execute(`decr ${key} ${value}`, nodes);
+    const newValue = results.find((v) => typeof v === "number");
     await this.afterHook("decr", { key, value, newValue });
     return newValue;
   }
@@ -1320,16 +1248,8 @@ ${valueStr}`;
     await this.beforeHook("touch", { key, exptime });
     this.validateKey(key);
     const nodes = await this.getNodesByKey(key);
-    const promises = nodes.map(async (node) => {
-      try {
-        const result = await node.command(`touch ${key} ${exptime}`);
-        return result === "TOUCHED";
-      } catch {
-        return false;
-      }
-    });
-    const results = await Promise.all(promises);
-    const success = results.every((result) => result === true);
+    const results = await this.execute(`touch ${key} ${exptime}`, nodes);
+    const success = results.every((result) => result === "TOUCHED");
     await this.afterHook("touch", { key, exptime, success });
     return success;
   }
@@ -1445,6 +1365,23 @@ ${valueStr}`;
     }
     return nodes;
   }
+  /**
+   * Execute a command on the specified nodes.
+   * @param {string} command - The memcache command string to execute
+   * @param {MemcacheNode[]} nodes - Array of MemcacheNode instances to execute on
+   * @param {ExecuteOptions} options - Optional execution options
+   * @returns {Promise<unknown[]>} Promise resolving to array of results from each node
+   */
+  async execute(command, nodes, options) {
+    const promises = nodes.map(async (node) => {
+      try {
+        return await node.command(command, options?.commandOptions);
+      } catch {
+        return void 0;
+      }
+    });
+    return Promise.all(promises);
+  }
   /**
    * Validates a Memcache key according to protocol requirements.
    * @param {string} key - The key to validate

package/dist/index.d.cts

@@ -187,6 +187,10 @@ interface MemcacheOptions {
 interface MemcacheStats {
     [key: string]: string;
 }
+interface ExecuteOptions {
+    /** Command options passed to node.command() */
+    commandOptions?: CommandOptions;
+}
 declare class Memcache extends Hookified {
     private _nodes;
     private _timeout;
@@ -474,6 +478,14 @@ declare class Memcache extends Hookified {
      * @throws {Error} If no nodes are available for the key
      */
     getNodesByKey(key: string): Promise<Array<MemcacheNode>>;
+    /**
+     * Execute a command on the specified nodes.
+     * @param {string} command - The memcache command string to execute
+     * @param {MemcacheNode[]} nodes - Array of MemcacheNode instances to execute on
+     * @param {ExecuteOptions} options - Optional execution options
+     * @returns {Promise<unknown[]>} Promise resolving to array of results from each node
+     */
+    execute(command: string, nodes: MemcacheNode[], options?: ExecuteOptions): Promise<unknown[]>;
     /**
      * Validates a Memcache key according to protocol requirements.
      * @param {string} key - The key to validate
@@ -498,4 +510,4 @@ declare class Memcache extends Hookified {
     private forwardNodeEvents;
 }
 
-export { type HashProvider, Memcache, MemcacheEvents, type MemcacheOptions, type MemcacheStats, createNode, Memcache as default };
+export { type ExecuteOptions, type HashProvider, Memcache, MemcacheEvents, type MemcacheOptions, type MemcacheStats, createNode, Memcache as default };

package/dist/index.d.ts

@@ -187,6 +187,10 @@ interface MemcacheOptions {
 interface MemcacheStats {
     [key: string]: string;
 }
+interface ExecuteOptions {
+    /** Command options passed to node.command() */
+    commandOptions?: CommandOptions;
+}
 declare class Memcache extends Hookified {
     private _nodes;
     private _timeout;
@@ -474,6 +478,14 @@ declare class Memcache extends Hookified {
      * @throws {Error} If no nodes are available for the key
      */
     getNodesByKey(key: string): Promise<Array<MemcacheNode>>;
+    /**
+     * Execute a command on the specified nodes.
+     * @param {string} command - The memcache command string to execute
+     * @param {MemcacheNode[]} nodes - Array of MemcacheNode instances to execute on
+     * @param {ExecuteOptions} options - Optional execution options
+     * @returns {Promise<unknown[]>} Promise resolving to array of results from each node
+     */
+    execute(command: string, nodes: MemcacheNode[], options?: ExecuteOptions): Promise<unknown[]>;
     /**
      * Validates a Memcache key according to protocol requirements.
      * @param {string} key - The key to validate
@@ -498,4 +510,4 @@ declare class Memcache extends Hookified {
     private forwardNodeEvents;
 }
 
-export { type HashProvider, Memcache, MemcacheEvents, type MemcacheOptions, type MemcacheStats, createNode, Memcache as default };
+export { type ExecuteOptions, type HashProvider, Memcache, MemcacheEvents, type MemcacheOptions, type MemcacheStats, createNode, Memcache as default };

package/dist/index.js

@@ -1036,16 +1036,8 @@ var Memcache = class extends Hookified2 {
     const command = `cas ${key} ${flags} ${exptime} ${bytes} ${casToken}\r
 ${valueStr}`;
     const nodes = await this.getNodesByKey(key);
-    const promises = nodes.map(async (node) => {
-      try {
-        const result = await node.command(command);
-        return result === "STORED";
-      } catch {
-        return false;
-      }
-    });
-    const results = await Promise.all(promises);
-    const success = results.every((result) => result === true);
+    const results = await this.execute(command, nodes);
+    const success = results.every((result) => result === "STORED");
     await this.afterHook("cas", {
       key,
       value,
@@ -1074,16 +1066,8 @@ ${valueStr}`;
     const command = `set ${key} ${flags} ${exptime} ${bytes}\r
 ${valueStr}`;
     const nodes = await this.getNodesByKey(key);
-    const promises = nodes.map(async (node) => {
-      try {
-        const result = await node.command(command);
-        return result === "STORED";
-      } catch {
-        return false;
-      }
-    });
-    const results = await Promise.all(promises);
-    const success = results.every((result) => result === true);
+    const results = await this.execute(command, nodes);
+    const success = results.every((result) => result === "STORED");
     await this.afterHook("set", { key, value, exptime, flags, success });
     return success;
   }
@@ -1105,16 +1089,8 @@ ${valueStr}`;
     const command = `add ${key} ${flags} ${exptime} ${bytes}\r
 ${valueStr}`;
     const nodes = await this.getNodesByKey(key);
-    const promises = nodes.map(async (node) => {
-      try {
-        const result = await node.command(command);
-        return result === "STORED";
-      } catch {
-        return false;
-      }
-    });
-    const results = await Promise.all(promises);
-    const success = results.every((result) => result === true);
+    const results = await this.execute(command, nodes);
+    const success = results.every((result) => result === "STORED");
     await this.afterHook("add", { key, value, exptime, flags, success });
     return success;
   }
@@ -1136,16 +1112,8 @@ ${valueStr}`;
     const command = `replace ${key} ${flags} ${exptime} ${bytes}\r
 ${valueStr}`;
     const nodes = await this.getNodesByKey(key);
-    const promises = nodes.map(async (node) => {
-      try {
-        const result = await node.command(command);
-        return result === "STORED";
-      } catch {
-        return false;
-      }
-    });
-    const results = await Promise.all(promises);
-    const success = results.every((result) => result === true);
+    const results = await this.execute(command, nodes);
+    const success = results.every((result) => result === "STORED");
     await this.afterHook("replace", { key, value, exptime, flags, success });
     return success;
   }
@@ -1165,16 +1133,8 @@ ${valueStr}`;
     const command = `append ${key} 0 0 ${bytes}\r
 ${valueStr}`;
     const nodes = await this.getNodesByKey(key);
-    const promises = nodes.map(async (node) => {
-      try {
-        const result = await node.command(command);
-        return result === "STORED";
-      } catch {
-        return false;
-      }
-    });
-    const results = await Promise.all(promises);
-    const success = results.every((result) => result === true);
+    const results = await this.execute(command, nodes);
+    const success = results.every((result) => result === "STORED");
     await this.afterHook("append", { key, value, success });
     return success;
   }
@@ -1194,16 +1154,8 @@ ${valueStr}`;
     const command = `prepend ${key} 0 0 ${bytes}\r
 ${valueStr}`;
     const nodes = await this.getNodesByKey(key);
-    const promises = nodes.map(async (node) => {
-      try {
-        const result = await node.command(command);
-        return result === "STORED";
-      } catch {
-        return false;
-      }
-    });
-    const results = await Promise.all(promises);
-    const success = results.every((result) => result === true);
+    const results = await this.execute(command, nodes);
+    const success = results.every((result) => result === "STORED");
     await this.afterHook("prepend", { key, value, success });
     return success;
   }
@@ -1218,16 +1170,8 @@ ${valueStr}`;
     await this.beforeHook("delete", { key });
     this.validateKey(key);
     const nodes = await this.getNodesByKey(key);
-    const promises = nodes.map(async (node) => {
-      try {
-        const result = await node.command(`delete ${key}`);
-        return result === "DELETED";
-      } catch {
-        return false;
-      }
-    });
-    const results = await Promise.all(promises);
-    const success = results.every((result) => result === true);
+    const results = await this.execute(`delete ${key}`, nodes);
+    const success = results.every((result) => result === "DELETED");
     await this.afterHook("delete", { key, success });
     return success;
   }
@@ -1243,16 +1187,8 @@ ${valueStr}`;
     await this.beforeHook("incr", { key, value });
     this.validateKey(key);
     const nodes = await this.getNodesByKey(key);
-    const promises = nodes.map(async (node) => {
-      try {
-        const result = await node.command(`incr ${key} ${value}`);
-        return typeof result === "number" ? result : void 0;
-      } catch {
-        return void 0;
-      }
-    });
-    const results = await Promise.all(promises);
-    const newValue = results.find((v) => v !== void 0);
+    const results = await this.execute(`incr ${key} ${value}`, nodes);
+    const newValue = results.find((v) => typeof v === "number");
     await this.afterHook("incr", { key, value, newValue });
     return newValue;
   }
@@ -1268,16 +1204,8 @@ ${valueStr}`;
     await this.beforeHook("decr", { key, value });
     this.validateKey(key);
     const nodes = await this.getNodesByKey(key);
-    const promises = nodes.map(async (node) => {
-      try {
-        const result = await node.command(`decr ${key} ${value}`);
-        return typeof result === "number" ? result : void 0;
-      } catch {
-        return void 0;
-      }
-    });
-    const results = await Promise.all(promises);
-    const newValue = results.find((v) => v !== void 0);
+    const results = await this.execute(`decr ${key} ${value}`, nodes);
+    const newValue = results.find((v) => typeof v === "number");
     await this.afterHook("decr", { key, value, newValue });
     return newValue;
   }
@@ -1293,16 +1221,8 @@ ${valueStr}`;
     await this.beforeHook("touch", { key, exptime });
     this.validateKey(key);
     const nodes = await this.getNodesByKey(key);
-    const promises = nodes.map(async (node) => {
-      try {
-        const result = await node.command(`touch ${key} ${exptime}`);
-        return result === "TOUCHED";
-      } catch {
-        return false;
-      }
-    });
-    const results = await Promise.all(promises);
-    const success = results.every((result) => result === true);
+    const results = await this.execute(`touch ${key} ${exptime}`, nodes);
+    const success = results.every((result) => result === "TOUCHED");
     await this.afterHook("touch", { key, exptime, success });
     return success;
   }
@@ -1418,6 +1338,23 @@ ${valueStr}`;
     }
     return nodes;
   }
+  /**
+   * Execute a command on the specified nodes.
+   * @param {string} command - The memcache command string to execute
+   * @param {MemcacheNode[]} nodes - Array of MemcacheNode instances to execute on
+   * @param {ExecuteOptions} options - Optional execution options
+   * @returns {Promise<unknown[]>} Promise resolving to array of results from each node
+   */
+  async execute(command, nodes, options) {
+    const promises = nodes.map(async (node) => {
+      try {
+        return await node.command(command, options?.commandOptions);
+      } catch {
+        return void 0;
+      }
+    });
+    return Promise.all(promises);
+  }
   /**
    * Validates a Memcache key according to protocol requirements.
    * @param {string} key - The key to validate

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "memcache",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Nodejs Memcache Client",
   "main": "dist/index.js",
   "type": "module",
@@ -27,16 +27,16 @@
   "author": "Jared Wray <me@jaredwray.com>",
   "license": "MIT",
   "devDependencies": {
-    "@biomejs/biome": "^2.3.7",
-    "@types/node": "^24.10.1",
-    "@vitest/coverage-v8": "^4.0.13",
+    "@biomejs/biome": "^2.3.10",
+    "@types/node": "^25.0.3",
+    "@vitest/coverage-v8": "^4.0.16",
     "tsc": "^2.0.4",
     "tsup": "^8.5.1",
     "typescript": "^5.9.3",
-    "vitest": "^4.0.13"
+    "vitest": "^4.0.16"
   },
   "dependencies": {
-    "hookified": "^1.13.0",
+    "hookified": "^1.14.0",
     "rimraf": "^6.1.2"
   },
   "files": [