Эх сурвалжийг харах

Update Node gh-pages docs to 1.2

murgatroid99 8 жил өмнө
parent
commit
023bc0729e

+ 1 - 1
node/global.html

@@ -1589,7 +1589,7 @@ of the grpc.logVerbosity map.
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.4.0</a> on Thu Aug 18 2016 12:19:14 GMT-0700 (PDT)
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.4.3</a> on Tue Mar 21 2017 11:29:55 GMT-0700 (PDT)
 </footer>
 
 <script> prettyPrint(); </script>

+ 5 - 6
node/index.html

@@ -26,7 +26,7 @@
     
 
 
-    <h3>grpc 1.0.0</h3>
+    <h3>grpc 1.2.0</h3>
 
 
 
@@ -44,8 +44,7 @@
 
     <section>
         <article><p><a href="https://www.npmjs.com/package/grpc"><img src="https://img.shields.io/npm/v/grpc.svg" alt="npm"></a></p>
-<h1>Node.js gRPC Library</h1><h2>Status</h2><p>Beta</p>
-<h2>PREREQUISITES</h2><ul>
+<h1>Node.js gRPC Library</h1><h2>PREREQUISITES</h2><ul>
 <li><p><code>node</code>: This requires <code>node</code> to be installed, version <code>0.12</code> or above. If you instead have the <code>nodejs</code> executable on Debian, you should install the <a href="https://packages.debian.org/sid/nodejs-legacy"><code>nodejs-legacy</code></a> package.</p>
 </li>
 <li><p><strong>Note:</strong> If you installed <code>node</code> via a package manager and the version is still less than <code>0.12</code>, try directly installing it from <a href="https://nodejs.org">nodejs.org</a>.</p>
@@ -66,7 +65,7 @@
 </li>
 </ol>
 <h2>TESTING</h2><p>To run the test suite, simply run <code>npm test</code> in the install location.</p>
-<h2>API</h2><p>This library internally uses <a href="https://github.com/dcodeIO/ProtoBuf.js">ProtoBuf.js</a>, and some structures it exports match those exported by that library</p>
+<h2>API</h2><p>This library internally uses <a href="https://github.com/dcodeIO/ProtoBuf.js">ProtoBuf.js</a>, and some structures it exports match those exported by that library.</p>
 <p>If you require this module, you will get an object with the following members</p>
 <pre class="prettyprint source lang-javascript"><code>function load(filename)</code></pre><p>Takes a filename of a <a href="https://developers.google.com/protocol-buffers/">Protocol Buffer</a> file, and returns an object representing the structure of the protocol buffer in the following way:</p>
 <ul>
@@ -77,7 +76,7 @@
 <li>Anything else becomes the relevant reflection object that ProtoBuf.js would create</li>
 </ul>
 <pre class="prettyprint source lang-javascript"><code>function loadObject(reflectionObject)</code></pre><p>Returns the same structure that <code>load</code> returns, but takes a reflection object from <code>ProtoBuf.js</code> instead of a file name.</p>
-<pre class="prettyprint source lang-javascript"><code>function Server([serverOpions])</code></pre><p>Constructs a server to which service/implementation pairs can be added.</p>
+<pre class="prettyprint source lang-javascript"><code>function Server([serverOptions])</code></pre><p>Constructs a server to which service/implementation pairs can be added.</p>
 <pre class="prettyprint source lang-javascript"><code>status</code></pre><p>An object mapping status names to status code numbers.</p>
 <pre class="prettyprint source lang-javascript"><code>callError</code></pre><p>An object mapping call error names to codes. This is primarily useful for tracking down certain kinds of internal errors.</p>
 <pre class="prettyprint source lang-javascript"><code>Credentials</code></pre><p>An object with factory methods for creating credential objects for clients.</p>
@@ -98,7 +97,7 @@
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.4.0</a> on Thu Aug 18 2016 12:19:14 GMT-0700 (PDT)
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.4.3</a> on Tue Mar 21 2017 11:29:55 GMT-0700 (PDT)
 </footer>
 
 <script> prettyPrint(); </script>

+ 5 - 1
node/index.js.html

@@ -247,6 +247,10 @@ exports.getClientChannel = client.getClientChannel;
  * @see module:src/client.waitForClientReady
  */
 exports.waitForClientReady = client.waitForClientReady;
+
+exports.closeClient = function closeClient(client_obj) {
+  client.getClientChannel(client_obj).close();
+};
 </code></pre>
         </article>
     </section>
@@ -263,7 +267,7 @@ exports.waitForClientReady = client.waitForClientReady;
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.4.0</a> on Thu Aug 18 2016 12:19:14 GMT-0700 (PDT)
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.4.3</a> on Tue Mar 21 2017 11:29:55 GMT-0700 (PDT)
 </footer>
 
 <script> prettyPrint(); </script>

+ 2 - 2
node/module-src_client-ClientDuplexStream.html

@@ -189,7 +189,7 @@ duplex streaming.
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="src_client.js.html">src/client.js</a>, <a href="src_client.js.html#line264">line 264</a>
+        <a href="src_client.js.html">src/client.js</a>, <a href="src_client.js.html#line278">line 278</a>
     </li></ul></dd>
     
 
@@ -251,7 +251,7 @@ duplex streaming.
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.4.0</a> on Thu Aug 18 2016 12:19:14 GMT-0700 (PDT)
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.4.3</a> on Tue Mar 21 2017 11:29:55 GMT-0700 (PDT)
 </footer>
 
 <script> prettyPrint(); </script>

+ 2 - 2
node/module-src_client-ClientReadableStream.html

@@ -165,7 +165,7 @@ from the server side.
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="src_client.js.html">src/client.js</a>, <a href="src_client.js.html#line129">line 129</a>
+        <a href="src_client.js.html">src/client.js</a>, <a href="src_client.js.html#line140">line 140</a>
     </li></ul></dd>
     
 
@@ -227,7 +227,7 @@ from the server side.
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.4.0</a> on Thu Aug 18 2016 12:19:14 GMT-0700 (PDT)
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.4.3</a> on Tue Mar 21 2017 11:29:55 GMT-0700 (PDT)
 </footer>
 
 <script> prettyPrint(); </script>

+ 1 - 1
node/module-src_client-ClientWritableStream.html

@@ -227,7 +227,7 @@ the client side.
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.4.0</a> on Thu Aug 18 2016 12:19:14 GMT-0700 (PDT)
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.4.3</a> on Tue Mar 21 2017 11:29:55 GMT-0700 (PDT)
 </footer>
 
 <script> prettyPrint(); </script>

+ 19 - 19
node/module-src_client.html

@@ -199,7 +199,7 @@ var call = client.unaryMethod(arguments, callback);</div>
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="src_client.js.html">src/client.js</a>, <a href="src_client.js.html#line839">line 839</a>
+        <a href="src_client.js.html">src/client.js</a>, <a href="src_client.js.html#line853">line 853</a>
     </li></ul></dd>
     
 
@@ -261,7 +261,7 @@ var call = client.unaryMethod(arguments, callback);</div>
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="src_client.js.html">src/client.js</a>, <a href="src_client.js.html#line834">line 834</a>
+        <a href="src_client.js.html">src/client.js</a>, <a href="src_client.js.html#line848">line 848</a>
     </li></ul></dd>
     
 
@@ -324,7 +324,7 @@ argument order with optional arguments after the callback.
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="src_client.js.html">src/client.js</a>, <a href="src_client.js.html#line664">line 664</a>
+        <a href="src_client.js.html">src/client.js</a>, <a href="src_client.js.html#line679">line 679</a>
     </li></ul></dd>
     
 
@@ -387,7 +387,7 @@ makeClientConstructor
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="src_client.js.html">src/client.js</a>, <a href="src_client.js.html#line646">line 646</a>
+        <a href="src_client.js.html">src/client.js</a>, <a href="src_client.js.html#line661">line 661</a>
     </li></ul></dd>
     
 
@@ -514,7 +514,7 @@ makeClientConstructor
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="src_client.js.html">src/client.js</a>, <a href="src_client.js.html#line776">line 776</a>
+        <a href="src_client.js.html">src/client.js</a>, <a href="src_client.js.html#line791">line 791</a>
     </li></ul></dd>
     
 
@@ -725,7 +725,7 @@ responseDeserialize: function to deserialize response objects
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="src_client.js.html">src/client.js</a>, <a href="src_client.js.html#line706">line 706</a>
+        <a href="src_client.js.html">src/client.js</a>, <a href="src_client.js.html#line721">line 721</a>
     </li></ul></dd>
     
 
@@ -922,7 +922,7 @@ responseDeserialize: function to deserialize response objects
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="src_client.js.html">src/client.js</a>, <a href="src_client.js.html#line817">line 817</a>
+        <a href="src_client.js.html">src/client.js</a>, <a href="src_client.js.html#line832">line 832</a>
     </li></ul></dd>
     
 
@@ -1130,7 +1130,7 @@ start connecting if it has not already done so.
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="src_client.js.html">src/client.js</a>, <a href="src_client.js.html#line792">line 792</a>
+        <a href="src_client.js.html">src/client.js</a>, <a href="src_client.js.html#line807">line 807</a>
     </li></ul></dd>
     
 
@@ -1213,7 +1213,7 @@ the server, emit the status. Otherwise, do nothing.
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="src_client.js.html">src/client.js</a>, <a href="src_client.js.html#line178">line 178</a>
+        <a href="src_client.js.html">src/client.js</a>, <a href="src_client.js.html#line189">line 189</a>
     </li></ul></dd>
     
 
@@ -1346,7 +1346,7 @@ defaults to OK if not provided.
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="src_client.js.html">src/client.js</a>, <a href="src_client.js.html#line148">line 148</a>
+        <a href="src_client.js.html">src/client.js</a>, <a href="src_client.js.html#line159">line 159</a>
     </li></ul></dd>
     
 
@@ -1428,7 +1428,7 @@ defaults to OK if not provided.
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="src_client.js.html">src/client.js</a>, <a href="src_client.js.html#line166">line 166</a>
+        <a href="src_client.js.html">src/client.js</a>, <a href="src_client.js.html#line177">line 177</a>
     </li></ul></dd>
     
 
@@ -1510,7 +1510,7 @@ defaults to OK if not provided.
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="src_client.js.html">src/client.js</a>, <a href="src_client.js.html#line290">line 290</a>
+        <a href="src_client.js.html">src/client.js</a>, <a href="src_client.js.html#line304">line 304</a>
     </li></ul></dd>
     
 
@@ -1643,7 +1643,7 @@ and overrides the hostname to connect to.
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="src_client.js.html">src/client.js</a>, <a href="src_client.js.html#line318">line 318</a>
+        <a href="src_client.js.html">src/client.js</a>, <a href="src_client.js.html#line332">line 332</a>
     </li></ul></dd>
     
 
@@ -1725,7 +1725,7 @@ and overrides the hostname to connect to.
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="src_client.js.html">src/client.js</a>, <a href="src_client.js.html#line303">line 303</a>
+        <a href="src_client.js.html">src/client.js</a>, <a href="src_client.js.html#line317">line 317</a>
     </li></ul></dd>
     
 
@@ -1926,7 +1926,7 @@ method.
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="src_client.js.html">src/client.js</a>, <a href="src_client.js.html#line593">line 593</a>
+        <a href="src_client.js.html">src/client.js</a>, <a href="src_client.js.html#line608">line 608</a>
     </li></ul></dd>
     
 
@@ -2126,7 +2126,7 @@ method.
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="src_client.js.html">src/client.js</a>, <a href="src_client.js.html#line441">line 441</a>
+        <a href="src_client.js.html">src/client.js</a>, <a href="src_client.js.html#line456">line 456</a>
     </li></ul></dd>
     
 
@@ -2326,7 +2326,7 @@ method.
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="src_client.js.html">src/client.js</a>, <a href="src_client.js.html#line527">line 527</a>
+        <a href="src_client.js.html">src/client.js</a>, <a href="src_client.js.html#line542">line 542</a>
     </li></ul></dd>
     
 
@@ -2526,7 +2526,7 @@ method.
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="src_client.js.html">src/client.js</a>, <a href="src_client.js.html#line350">line 350</a>
+        <a href="src_client.js.html">src/client.js</a>, <a href="src_client.js.html#line364">line 364</a>
     </li></ul></dd>
     
 
@@ -2596,7 +2596,7 @@ method.
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.4.0</a> on Thu Aug 18 2016 12:19:14 GMT-0700 (PDT)
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.4.3</a> on Tue Mar 21 2017 11:29:55 GMT-0700 (PDT)
 </footer>
 
 <script> prettyPrint(); </script>

+ 2 - 2
node/module-src_client.makeClientConstructor-Client.html

@@ -188,7 +188,7 @@
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="src_client.js.html">src/client.js</a>, <a href="src_client.js.html#line719">line 719</a>
+        <a href="src_client.js.html">src/client.js</a>, <a href="src_client.js.html#line734">line 734</a>
     </li></ul></dd>
     
 
@@ -250,7 +250,7 @@
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.4.0</a> on Thu Aug 18 2016 12:19:14 GMT-0700 (PDT)
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.4.3</a> on Tue Mar 21 2017 11:29:55 GMT-0700 (PDT)
 </footer>
 
 <script> prettyPrint(); </script>

+ 4 - 4
node/module-src_common.html

@@ -177,7 +177,7 @@ code. None of them should be used directly by gRPC users.</div>
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="src_common.js.html">src/common.js</a>, <a href="src_common.js.html#line164">line 164</a>
+        <a href="src_common.js.html">src/common.js</a>, <a href="src_common.js.html#line171">line 171</a>
     </li></ul></dd>
     
 
@@ -239,7 +239,7 @@ code. None of them should be used directly by gRPC users.</div>
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="src_common.js.html">src/common.js</a>, <a href="src_common.js.html#line169">line 169</a>
+        <a href="src_common.js.html">src/common.js</a>, <a href="src_common.js.html#line176">line 176</a>
     </li></ul></dd>
     
 
@@ -969,7 +969,7 @@ code. None of them should be used directly by gRPC users.</div>
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="src_common.js.html">src/common.js</a>, <a href="src_common.js.html#line176">line 176</a>
+        <a href="src_common.js.html">src/common.js</a>, <a href="src_common.js.html#line183">line 183</a>
     </li></ul></dd>
     
 
@@ -1336,7 +1336,7 @@ function is given, just uses the identity;
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.4.0</a> on Thu Aug 18 2016 12:19:14 GMT-0700 (PDT)
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.4.3</a> on Tue Mar 21 2017 11:29:55 GMT-0700 (PDT)
 </footer>
 
 <script> prettyPrint(); </script>

+ 1 - 1
node/module-src_credentials.html

@@ -957,7 +957,7 @@ which corresponds to a status code that this library uses.
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.4.0</a> on Thu Aug 18 2016 12:19:14 GMT-0700 (PDT)
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.4.3</a> on Tue Mar 21 2017 11:29:55 GMT-0700 (PDT)
 </footer>
 
 <script> prettyPrint(); </script>

+ 1 - 1
node/module-src_metadata-Metadata.html

@@ -968,7 +968,7 @@ with that key. Normalizes the key.
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.4.0</a> on Thu Aug 18 2016 12:19:14 GMT-0700 (PDT)
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.4.3</a> on Tue Mar 21 2017 11:29:55 GMT-0700 (PDT)
 </footer>
 
 <script> prettyPrint(); </script>

+ 1 - 1
node/module-src_metadata.html

@@ -165,7 +165,7 @@ metadata.get('key1') // returns ['value1', 'value2']</div>
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.4.0</a> on Thu Aug 18 2016 12:19:14 GMT-0700 (PDT)
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.4.3</a> on Tue Mar 21 2017 11:29:55 GMT-0700 (PDT)
 </footer>
 
 <script> prettyPrint(); </script>

+ 9 - 9
node/module-src_server-Server.html

@@ -155,7 +155,7 @@ incoming requests to those handlers
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="src_server.js.html">src/server.js</a>, <a href="src_server.js.html#line583">line 583</a>
+        <a href="src_server.js.html">src/server.js</a>, <a href="src_server.js.html#line597">line 597</a>
     </li></ul></dd>
     
 
@@ -328,7 +328,7 @@ incoming requests to those handlers
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="src_server.js.html">src/server.js</a>, <a href="src_server.js.html#line761">line 761</a>
+        <a href="src_server.js.html">src/server.js</a>, <a href="src_server.js.html#line788">line 788</a>
     </li></ul></dd>
     
 
@@ -486,7 +486,7 @@ addProtoService.
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="src_server.js.html">src/server.js</a>, <a href="src_server.js.html#line716">line 716</a>
+        <a href="src_server.js.html">src/server.js</a>, <a href="src_server.js.html#line730">line 730</a>
     </li></ul></dd>
     
 
@@ -662,7 +662,7 @@ addProtoService.
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="src_server.js.html">src/server.js</a>, <a href="src_server.js.html#line777">line 777</a>
+        <a href="src_server.js.html">src/server.js</a>, <a href="src_server.js.html#line804">line 804</a>
     </li></ul></dd>
     
 
@@ -747,7 +747,7 @@ any outstanding tryShutdown callbacks.
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="src_server.js.html">src/server.js</a>, <a href="src_server.js.html#line655">line 655</a>
+        <a href="src_server.js.html">src/server.js</a>, <a href="src_server.js.html#line669">line 669</a>
     </li></ul></dd>
     
 
@@ -973,7 +973,7 @@ a handler for the given method. Returns true on success
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="src_server.js.html">src/server.js</a>, <a href="src_server.js.html#line673">line 673</a>
+        <a href="src_server.js.html">src/server.js</a>, <a href="src_server.js.html#line687">line 687</a>
     </li></ul></dd>
     
 
@@ -1081,7 +1081,7 @@ a handler for the given method. Returns true on success
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="src_server.js.html">src/server.js</a>, <a href="src_server.js.html#line593">line 593</a>
+        <a href="src_server.js.html">src/server.js</a>, <a href="src_server.js.html#line607">line 607</a>
     </li></ul></dd>
     
 
@@ -1215,7 +1215,7 @@ is idempotent with itself and forceShutdown.
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="src_server.js.html">src/server.js</a>, <a href="src_server.js.html#line645">line 645</a>
+        <a href="src_server.js.html">src/server.js</a>, <a href="src_server.js.html#line659">line 659</a>
     </li></ul></dd>
     
 
@@ -1263,7 +1263,7 @@ is idempotent with itself and forceShutdown.
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.4.0</a> on Thu Aug 18 2016 12:19:14 GMT-0700 (PDT)
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.4.3</a> on Tue Mar 21 2017 11:29:55 GMT-0700 (PDT)
 </footer>
 
 <script> prettyPrint(); </script>

+ 2 - 2
node/module-src_server-ServerDuplexStream.html

@@ -189,7 +189,7 @@ duplex streaming.
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="src_server.js.html">src/server.js</a>, <a href="src_server.js.html#line379">line 379</a>
+        <a href="src_server.js.html">src/server.js</a>, <a href="src_server.js.html#line393">line 393</a>
     </li></ul></dd>
     
 
@@ -251,7 +251,7 @@ duplex streaming.
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.4.0</a> on Thu Aug 18 2016 12:19:14 GMT-0700 (PDT)
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.4.3</a> on Tue Mar 21 2017 11:29:55 GMT-0700 (PDT)
 </footer>
 
 <script> prettyPrint(); </script>

+ 2 - 2
node/module-src_server-ServerReadableStream.html

@@ -165,7 +165,7 @@ from the client side.
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="src_server.js.html">src/server.js</a>, <a href="src_server.js.html#line308">line 308</a>
+        <a href="src_server.js.html">src/server.js</a>, <a href="src_server.js.html#line322">line 322</a>
     </li></ul></dd>
     
 
@@ -227,7 +227,7 @@ from the client side.
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.4.0</a> on Thu Aug 18 2016 12:19:14 GMT-0700 (PDT)
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.4.3</a> on Tue Mar 21 2017 11:29:55 GMT-0700 (PDT)
 </footer>
 
 <script> prettyPrint(); </script>

+ 2 - 2
node/module-src_server-ServerWritableStream.html

@@ -165,7 +165,7 @@ the server side.
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="src_server.js.html">src/server.js</a>, <a href="src_server.js.html#line255">line 255</a>
+        <a href="src_server.js.html">src/server.js</a>, <a href="src_server.js.html#line262">line 262</a>
     </li></ul></dd>
     
 
@@ -227,7 +227,7 @@ the server side.
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.4.0</a> on Thu Aug 18 2016 12:19:14 GMT-0700 (PDT)
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.4.3</a> on Tue Mar 21 2017 11:29:55 GMT-0700 (PDT)
 </footer>
 
 <script> prettyPrint(); </script>

+ 5 - 5
node/module-src_server.html

@@ -198,7 +198,7 @@ server.start();</div>
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="src_server.js.html">src/server.js</a>, <a href="src_server.js.html#line787">line 787</a>
+        <a href="src_server.js.html">src/server.js</a>, <a href="src_server.js.html#line814">line 814</a>
     </li></ul></dd>
     
 
@@ -283,7 +283,7 @@ server.start();</div>
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="src_server.js.html">src/server.js</a>, <a href="src_server.js.html#line419">line 419</a>
+        <a href="src_server.js.html">src/server.js</a>, <a href="src_server.js.html#line433">line 433</a>
     </li></ul></dd>
     
 
@@ -436,7 +436,7 @@ server.start();</div>
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="src_server.js.html">src/server.js</a>, <a href="src_server.js.html#line393">line 393</a>
+        <a href="src_server.js.html">src/server.js</a>, <a href="src_server.js.html#line407">line 407</a>
     </li></ul></dd>
     
 
@@ -519,7 +519,7 @@ cancelled.
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="src_server.js.html">src/server.js</a>, <a href="src_server.js.html#line433">line 433</a>
+        <a href="src_server.js.html">src/server.js</a>, <a href="src_server.js.html#line447">line 447</a>
     </li></ul></dd>
     
 
@@ -567,7 +567,7 @@ cancelled.
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.4.0</a> on Thu Aug 18 2016 12:19:14 GMT-0700 (PDT)
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.4.3</a> on Tue Mar 21 2017 11:29:55 GMT-0700 (PDT)
 </footer>
 
 <script> prettyPrint(); </script>

+ 25 - 11
node/src_client.js.html

@@ -127,7 +127,18 @@ function ClientWritableStream(call, serialize) {
 function _write(chunk, encoding, callback) {
   /* jshint validthis: true */
   var batch = {};
-  var message = this.serialize(chunk);
+  var message;
+  try {
+    message = this.serialize(chunk);
+  } catch (e) {
+    /* Sending this error to the server and emitting it immediately on the
+       client may put the call in a slightly weird state on the client side,
+       but passing an object that causes a serialization failure is a misuse
+       of the API anyway, so that's OK. The primary purpose here is to give the
+       programmer a useful error and to stop the stream properly */
+    this.call.cancelWithStatus(grpc.status.INTERNAL, 'Serialization failure');
+    callback(e);
+  }
   if (_.isFinite(encoding)) {
     /* Attach the encoding if it is a finite number. This is the closest we
      * can get to checking that it is valid flags */
@@ -212,14 +223,15 @@ function _emitStatusIfDone() {
     } else {
       status = this.received_status;
     }
-    this.emit('status', status);
-    if (status.code !== grpc.status.OK) {
+    if (status.code === grpc.status.OK) {
+      this.push(null);
+    } else {
       var error = new Error(status.details);
       error.code = status.code;
       error.metadata = status.metadata;
       this.emit('error', error);
-      return;
     }
+    this.emit('status', status);
   }
 }
 
@@ -252,9 +264,11 @@ function _read(size) {
     } catch (e) {
       self._readsDone({code: grpc.status.INTERNAL,
                        details: 'Failed to parse server response'});
+      return;
     }
     if (data === null) {
       self._readsDone();
+      return;
     }
     if (self.push(deserialized) &amp;&amp; data !== null) {
       var read_batch = {};
@@ -410,6 +424,7 @@ function makeUnaryRequestFunction(method, serialize, deserialize) {
     if (args.options) {
       message.grpcWriteFlags = args.options.flags;
     }
+
     client_batch[grpc.opType.SEND_INITIAL_METADATA] =
         metadata._getCoreRepresentation();
     client_batch[grpc.opType.SEND_MESSAGE] = message;
@@ -423,6 +438,8 @@ function makeUnaryRequestFunction(method, serialize, deserialize) {
       var status = response.status;
       var error;
       var deserialized;
+      emitter.emit('metadata', Metadata._fromCoreRepresentation(
+          response.metadata));
       if (status.code === grpc.status.OK) {
         if (err) {
           // Got a batch error, but OK status. Something went wrong
@@ -450,8 +467,6 @@ function makeUnaryRequestFunction(method, serialize, deserialize) {
         args.callback(null, deserialized);
       }
       emitter.emit('status', status);
-      emitter.emit('metadata', Metadata._fromCoreRepresentation(
-          response.metadata));
     });
     return emitter;
   }
@@ -844,13 +859,12 @@ exports.waitForClientReady = function(client, deadline, callback) {
  */
 exports.makeProtobufClientConstructor =  function(service, options) {
   var method_attrs = common.getProtobufServiceAttrs(service, options);
-  var deprecatedArgumentOrder = false;
-  if (options) {
-    deprecatedArgumentOrder = options.deprecatedArgumentOrder;
+  if (!options) {
+    options = {deprecatedArgumentOrder: false};
   }
   var Client = exports.makeClientConstructor(
       method_attrs, common.fullyQualifiedName(service),
-      deprecatedArgumentOrder);
+      options);
   Client.service = service;
   Client.service.grpc_options = options;
   return Client;
@@ -881,7 +895,7 @@ exports.callError = grpc.callError;
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.4.0</a> on Thu Aug 18 2016 12:19:14 GMT-0700 (PDT)
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.4.3</a> on Tue Mar 21 2017 11:29:55 GMT-0700 (PDT)
 </footer>
 
 <script> prettyPrint(); </script>

+ 13 - 6
node/src_common.js.html

@@ -169,8 +169,15 @@ exports.getProtobufServiceAttrs = function getProtobufServiceAttrs(service,
     binaryAsBase64 = options.binaryAsBase64;
     longsAsStrings = options.longsAsStrings;
   }
-  return _.object(_.map(service.children, function(method) {
-    return [_.camelCase(method.name), {
+  /* This slightly awkward construction is used to make sure we only use
+     lodash@3.10.1-compatible functions. A previous version used
+     _.fromPairs, which would be cleaner, but was introduced in lodash
+     version 4 */
+  return _.zipObject(_.map(service.children, function(method) {
+    return _.camelCase(method.name);
+  }), _.map(service.children, function(method) {
+    return {
+      originalName: method.name,
       path: prefix + method.name,
       requestStream: method.requestStream,
       responseStream: method.responseStream,
@@ -178,11 +185,11 @@ exports.getProtobufServiceAttrs = function getProtobufServiceAttrs(service,
       responseType: method.resolvedResponseType,
       requestSerialize: serializeCls(method.resolvedRequestType.build()),
       requestDeserialize: deserializeCls(method.resolvedRequestType.build(),
-                                     binaryAsBase64, longsAsStrings),
+                                         binaryAsBase64, longsAsStrings),
       responseSerialize: serializeCls(method.resolvedResponseType.build()),
       responseDeserialize: deserializeCls(method.resolvedResponseType.build(),
-                                     binaryAsBase64, longsAsStrings)
-    }];
+                                          binaryAsBase64, longsAsStrings)
+    };
   }));
 };
 
@@ -222,7 +229,7 @@ exports.log = function log(severity, message) {
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.4.0</a> on Thu Aug 18 2016 12:19:14 GMT-0700 (PDT)
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.4.3</a> on Tue Mar 21 2017 11:29:55 GMT-0700 (PDT)
 </footer>
 
 <script> prettyPrint(); </script>

+ 1 - 1
node/src_credentials.js.html

@@ -217,7 +217,7 @@ exports.createInsecure = ChannelCredentials.createInsecure;
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.4.0</a> on Thu Aug 18 2016 12:19:14 GMT-0700 (PDT)
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.4.3</a> on Tue Mar 21 2017 11:29:55 GMT-0700 (PDT)
 </footer>
 
 <script> prettyPrint(); </script>

+ 1 - 1
node/src_metadata.js.html

@@ -237,7 +237,7 @@ module.exports = Metadata;
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.4.0</a> on Thu Aug 18 2016 12:19:14 GMT-0700 (PDT)
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.4.3</a> on Tue Mar 21 2017 11:29:55 GMT-0700 (PDT)
 </footer>
 
 <script> prettyPrint(); </script>

+ 34 - 7
node/src_server.js.html

@@ -149,13 +149,20 @@ function sendUnaryResponse(call, value, serialize, metadata, flags) {
   if (metadata) {
     statusMetadata = metadata;
   }
+  var message;
+  try {
+    message = serialize(value);
+  } catch (e) {
+    e.code = grpc.status.INTERNAL;
+    handleError(call, e);
+    return;
+  }
   status.metadata = statusMetadata._getCoreRepresentation();
   if (!call.metadataSent) {
     end_batch[grpc.opType.SEND_INITIAL_METADATA] =
         (new Metadata())._getCoreRepresentation();
     call.metadataSent = true;
   }
-  var message = serialize(value);
   message.grpcWriteFlags = flags;
   end_batch[grpc.opType.SEND_MESSAGE] = message;
   end_batch[grpc.opType.SEND_STATUS_FROM_SERVER] = status;
@@ -301,12 +308,19 @@ function _write(chunk, encoding, callback) {
   /* jshint validthis: true */
   var batch = {};
   var self = this;
+  var message;
+  try {
+    message = this.serialize(chunk);
+  } catch (e) {
+    e.code = grpc.status.INTERNAL;
+    callback(e);
+    return;
+  }
   if (!this.call.metadataSent) {
     batch[grpc.opType.SEND_INITIAL_METADATA] =
         (new Metadata())._getCoreRepresentation();
     this.call.metadataSent = true;
   }
-  var message = this.serialize(chunk);
   if (_.isFinite(encoding)) {
     /* Attach the encoding if it is a finite number. This is the closest we
      * can get to checking that it is valid flags */
@@ -742,11 +756,17 @@ var defaultHandler = {
  *     method implementation for the provided service.
  */
 Server.prototype.addService = function(service, implementation) {
+  if (!_.isObject(service) || !_.isObject(implementation)) {
+    throw new Error('addService requires two objects as arguments');
+  }
+  if (_.keys(service).length === 0) {
+    throw new Error('Cannot add an empty service to a server');
+  }
   if (this.started) {
     throw new Error('Can\'t add a service to a started server.');
   }
   var self = this;
-  _.each(service, function(attrs, name) {
+  _.forOwn(service, function(attrs, name) {
     var method_type;
     if (attrs.requestStream) {
       if (attrs.responseStream) {
@@ -763,9 +783,16 @@ Server.prototype.addService = function(service, implementation) {
     }
     var impl;
     if (implementation[name] === undefined) {
-      common.log(grpc.logVerbosity.ERROR, 'Method handler for ' +
-          attrs.path + ' expected but not provided');
-      impl = defaultHandler[method_type];
+      /* Handle the case where the method is passed with the name exactly as
+         written in the proto file, instead of using JavaScript function
+         naming style */
+      if (implementation[attrs.originalName] === undefined) {
+        common.log(grpc.logVerbosity.ERROR, 'Method handler ' + name + ' for ' +
+            attrs.path + ' expected but not provided');
+        impl = defaultHandler[method_type];
+      } else {
+        impl = _.bind(implementation[attrs.originalName], implementation);
+      }
     } else {
       impl = _.bind(implementation[name], implementation);
     }
@@ -829,7 +856,7 @@ exports.Server = Server;
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.4.0</a> on Thu Aug 18 2016 12:19:14 GMT-0700 (PDT)
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.4.3</a> on Tue Mar 21 2017 11:29:55 GMT-0700 (PDT)
 </footer>
 
 <script> prettyPrint(); </script>

+ 34 - 33
node/styles/jsdoc-default.css

@@ -153,7 +153,7 @@ h1
     margin: 12px 24px 20px;
 }
 
-h2, h3
+h2, h3.subsection-title
 {
     font-size: 30px;
     font-weight: 700;
@@ -161,6 +161,13 @@ h2, h3
     margin-bottom: 12px;
 }
 
+h3
+{
+    font-size: 24px;
+    letter-spacing: -0.5px;
+    margin-bottom: 12px;
+}
+
 h4
 {
     font-size: 18px;
@@ -185,6 +192,32 @@ h6
     font-style: italic;
 }
 
+table
+{
+    border-spacing: 0;
+    border: 0;
+    border-collapse: collapse;
+}
+
+td, th
+{
+    border: 1px solid #ddd;
+    margin: 0px;
+    text-align: left;
+    vertical-align: top;
+    padding: 4px 6px;
+    display: table-cell;
+}
+
+thead tr
+{
+    background-color: #ddd;
+    font-weight: bold;
+}
+
+th { border-right: 1px solid #aaa; }
+tr > th:last-child { border-right: 1px solid #ddd; }
+
 .ancestors { color: #999; }
 .ancestors a
 {
@@ -296,44 +329,12 @@ h6
   user-select: text;
 }
 
-.params, .props
-{
-    border-spacing: 0;
-    border: 0;
-    border-collapse: collapse;
-}
-
 .params .name, .props .name, .name code {
     color: #4D4E53;
     font-family: Consolas, Monaco, 'Andale Mono', monospace;
     font-size: 100%;
 }
 
-.params td, .params th, .props td, .props th
-{
-    border: 1px solid #ddd;
-    margin: 0px;
-    text-align: left;
-    vertical-align: top;
-    padding: 4px 6px;
-    display: table-cell;
-}
-
-.params thead tr, .props thead tr
-{
-    background-color: #ddd;
-    font-weight: bold;
-}
-
-.params .params thead tr, .props .props thead tr
-{
-    background-color: #fff;
-    font-weight: bold;
-}
-
-.params th, .props th { border-right: 1px solid #aaa; }
-.params thead .last, .props thead .last { border-right: 1px solid #ddd; }
-
 .params td.description > p:first-child,
 .props td.description > p:first-child
 {