Merge commit '198125c37962b10462e311440d46767a7c41d782'

Author: vsivsi

README.markdown

@@ -66,7 +66,29 @@ ddpclient.connect(function(error) {
     }, 3000);
 
     /*
-     * Subscribe to a Meteor Xollection
+     * Call a Meteor Method while passing in a random seed. 
+     * Added in DDP pre2, the random seed will be used on the server to generate
+     * repeatable IDs. This allows the same id to be generated on the client and server
+     */
+    var Random = require("ddp-random"),
+        random = Random.createWithSeeds("randomSeed");  // seed an id generator
+
+    ddpclient.callWithRandomSeed(
+      'createPost',              // name of Meteor Method being called
+      [{ _id : random.id(),      // generate the id on the client 
+        body : "asdf" }],            
+      "randomSeed",              // pass the same seed to the server
+      function (err, result) {   // callback which returns the method call results
+        console.log('called function, result: ' + result);
+      },
+      function () {              // callback which fires when server has finished 
+        console.log('updated');  // sending any updated documents as a result of
+        console.log(ddpclient.collections.posts);  // calling this method 
+      }                          
+    );
+
+    /*
+     * Subscribe to a Meteor Collection
      */
     ddpclient.subscribe(
       'posts',                  // name of Meteor Publish function to subscribe to

examples/example.js

@@ -46,7 +46,29 @@ ddpclient.connect(function(error) {
     }, 3000);
 
     /*
-     * Subscribe to a Meteor Xollection
+     * Call a Meteor Method while passing in a random seed. 
+     * Added in DDP pre2, the random seed will be used on the server to generate
+     * repeatable IDs. This allows the same id to be generated on the client and server
+     */
+    var Random = require("ddp-random"),
+        random = Random.createWithSeeds("randomSeed");  // seed an id generator
+
+    ddpclient.callWithRandomSeed(
+      'createPost',              // name of Meteor Method being called
+      [{ _id : random.id(),      // generate the id on the client 
+        body : "asdf" }],            
+      "randomSeed",              // pass the same seed to the server
+      function (err, result) {   // callback which returns the method call results
+        console.log('called function, result: ' + result);
+      },
+      function () {              // callback which fires when server has finished 
+        console.log('updated');  // sending any updated documents as a result of
+        console.log(ddpclient.collections.posts);  // calling this method 
+      }                          
+    );
+
+    /*
+     * Subscribe to a Meteor Collection
      */
     ddpclient.subscribe(
       'posts',                  // name of Meteor Publish function to subscribe to

lib/ddp-client.js

@@ -337,6 +337,19 @@ DDPClient.prototype.call = function(name, params, callback, updatedCallback) {
   self._send({msg: 'method', id: id, method: name, params: params});
 };
 
+DDPClient.prototype.callWithRandomSeed = function(name, params, randomSeed, callback, updatedCallback) {
+  var self = this;
+  var id = self._nextId();
+
+  if (callback)
+    self._callbacks[id] = callback;
+
+  if (updatedCallback)
+    self._updatedCallbacks[id] = updatedCallback;    
+
+  self._send({msg: 'method', id: id, method: name, randomSeed: randomSeed, params: params});
+};
+
 // open a subscription on the server, callback should handle on ready and nosub
 DDPClient.prototype.subscribe = function(name, params, callback) {
   var self = this;