pixl-server-storage 3.1.13 → 3.1.14

package/docs/API.md

@@ -17,6 +17,7 @@ var storage = server.Storage;
 	* [putStream](#putstream)
 	* [get](#get)
 	* [getMulti](#getmulti)
+	* [getBuffer](#getbuffer)
 	* [getStream](#getstream)
 	* [getStreamRange](#getstreamrange)
 	* [head](#head)
@@ -60,6 +61,8 @@ var storage = server.Storage;
 	* [hashPutMulti](#hashputmulti)
 	* [hashGet](#hashget)
 	* [hashGetMulti](#hashgetmulti)
+	* [hashUpdate](#hashupdate)
+	* [hashUpdateMulti](#hashupdatemulti)
 	* [hashEach](#hasheach)
 	* [hashEachSync](#hasheachsync)
 	* [hashEachPage](#hasheachpage)
@@ -1012,6 +1015,28 @@ storage.hashUpdate( 'users', 'bsanders', { age: 81 }, function(err) {
 
 This would update Bernie's age to 81 without affecting any of the other properties in his user record.
 
+## hashUpdateMulti
+
+```javascript
+storage.hashUpdateMulti( PATH, RECORDS, CALLBACK );
+```
+
+The `hashUpdateMulti()` method updates multiple key/value pairs in a hash.  The `PATH` specifies the main storage path of the hash, and `RECORDS` should be an object containing all the keys and values you want to update.  See [hashUpdate()](#hashupdate) for details on the update format.
+
+```js
+var updates = {
+	"bsanders": { age: 81 },
+	"hclinton": { age: 75 },
+	"dtrump": { age: 77 }
+};
+
+storage.hashUpdateMulti( 'users', records, function(err) {
+	if (err) throw err;
+} );
+```
+
+This would update the `age` properties in each record, without affecting the other data.
+
 ## hashEach
 
 ```javascript

package/docs/Transactions.md

@@ -199,8 +199,9 @@ When transactions are enabled, many compound storage methods (those that execute
 - **Hash Methods**
 	- [hashCreate()](API.md#hashcreate)
 	- [hashPut()](API.md#hashput)
-	- [hashUpdate()](API.md#hashupdate)
 	- [hashPutMulti()](API.md#hashputmulti)
+	- [hashUpdate()](API.md#hashupdate)
+	- [hashUpdateMulti()](API.md#hashupdatemulti)
 	- [hashCopy()](API.md#hashcopy)
 	- [hashRename()](API.md#hashrename)
 	- [hashDeleteMulti()](API.md#hashdeletemulti)

package/hash.js

@@ -426,6 +426,25 @@ module.exports = Class.create({
 		}); // get
 	},
 	
+	hashUpdateMulti: function(path, records, callback) {
+		// update multiple hash records at once, given object of keys and values
+		// need concurrency limit of 1 because hashUpdate locks
+		var self = this;
+		
+		async.eachLimit(Object.keys(records), 1, 
+			function(hkey, callback) {
+				// iterator for each key
+				self.hashUpdate(path, hkey, records[hkey], function(err) {
+					callback(err);
+				} );
+			}, 
+			function(err) {
+				// all keys updated
+				callback(err);
+			}
+		);
+	},
+	
 	hashEachPage: function(path, iterator, callback) {
 		// call user iterator for each populated hash page, data only
 		// iterator will be passed page items hash object

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pixl-server-storage",
-	"version": "3.1.13",
+	"version": "3.1.14",
 	"description": "A key/value/list storage component for the pixl-server framework.",
 	"author": "Joseph Huckaby <jhuckaby@gmail.com>",
 	"homepage": "https://github.com/jhuckaby/pixl-server-storage",

package/transaction.js

@@ -454,8 +454,9 @@ module.exports = Class.create({
 			'listEachPageUpdate',
 			'hashCreate', 
 			'hashPut', 
+			'hashPutMulti',
 			'hashUpdate',
-			'hashPutMulti', 
+			'hashUpdateMulti', 
 			'hashCopy', 
 			'hashRename', 
 			'hashDeleteMulti',