docs: adding auto archive documentation (#305)

* docs: adding auto archive documentation

* Docs edits

---------

Co-authored-by: Jeff Swartz <jeff.swartz@vonage.com>

Author: manchuck

lib/opentok.js

@@ -75,10 +75,10 @@ OpenTok = function (apiKey, apiSecret, env) {
 
   // validate arguments: apiKey := Number|String, apiSecret := String
   if (!(_.isNumber(apiKey) || _.isString(apiKey)) || !_.isString(apiSecret)) {
-    throw new Error('Invalid arguments when initializing OpenTok: apiKey=' +
-        apiKey +
-        ', apiSecret=' +
-        apiSecret);
+    throw new Error('Invalid arguments when initializing OpenTok: apiKey='
+        + apiKey
+        + ', apiSecret='
+        + apiSecret);
   }
 
   // apiKey argument can be a Number, but we will internally store it as a String
@@ -488,7 +488,7 @@ OpenTok = function (apiKey, apiSecret, env) {
     );
   };
 
-/**
+  /**
    * Retrieves a List of {@link Render} objects, representing any renders in the starting,
    * started, stopped or failed state, for your API key.
    *
@@ -1048,7 +1048,6 @@ OpenTok = function (apiKey, apiSecret, env) {
     );
   };
 
-
   /**
    * Sets (or updates) the layout of the broadcast. See
    * <a href="https://tokbox.com/developer/guides/broadcast/live-streaming/#configuring-video-layout-for-opentok-live-streaming-broadcasts">
@@ -1286,17 +1285,17 @@ OpenTok = function (apiKey, apiSecret, env) {
     for (i = 0; i < classListArray.length; i += 1) {
       layoutObj = classListArray[i];
       if (typeof layoutObj.id !== 'string') {
-        return callback(new Error('Invalid arguments -- each element in the streamClassArray ' +
-              'must have an id string.'));
+        return callback(new Error('Invalid arguments -- each element in the streamClassArray '
+              + 'must have an id string.'));
       }
       if (!Array.isArray(layoutObj.layoutClassList)) {
-        return callback(new Error('Invalid arguments -- each element in the streamClassArray ' +
-              'must have a layoutClassList array.'));
+        return callback(new Error('Invalid arguments -- each element in the streamClassArray '
+              + 'must have a layoutClassList array.'));
       }
       for (j = 0; j < layoutObj.layoutClassList.length; j += 1) {
         if (typeof layoutObj.layoutClassList[j] !== 'string') {
-          return callback(new Error('Invalid arguments -- each element in the layoutClassList ' +
-                'array must be a string (defining class names).'));
+          return callback(new Error('Invalid arguments -- each element in the layoutClassList '
+                + 'array must be a string (defining class names).'));
         }
       }
     }
@@ -1853,6 +1852,15 @@ for the OpenTok session. Set to <code>"true"</code> or <code>"false"</code>.
  * session (either automatically or not), you must set the <code>mediaMode</code> parameter to
  * <code>"routed"</code>.
  *
+ *     <li><code>archiveName</code> (String) &mdash; The name of the archives to be used in
+ *     auto-archived sessions. The length of the archive name can be up to 80 chars.
+ *     Due to encoding limitations the following special characters are translated to
+ *     a colon (:) character: ~, -, _.</li>
+ *
+ *     <li><code>archiveResolution</code> (Enum) &mdash; The resolution of archives in an auto-archived session.
+ *     Valid values are "480x640", "640x480", "720x1280", "1280x720", "1080x1920", and "1920x1080".
+ *     </li>
+ *
  * <ul>
  *   <li>The OpenTok Media Router can decrease bandwidth usage in multiparty sessions.
  *       (When the <code>mediaMode</code> parameter is set to <code>"relayed"</code>,
@@ -1922,8 +1930,8 @@ OpenTok.prototype.createSession = function (opts, callback) {
   }
   if ('location' in opts && !net.isIPv4(opts.location)) {
     return process.nextTick(function () {
-      callback(new Error('Invalid arguments when calling createSession, location must be an ' +
-            'IPv4 address'));
+      callback(new Error('Invalid arguments when calling createSession, location must be an '
+            + 'IPv4 address'));
     });
   }
 
@@ -2067,24 +2075,24 @@ OpenTok.prototype.generateToken = function (sessionId, opts) {
     throw new Error('Invalid expireTime for token generation: ' + tokenData.expire_time);
   }
   if (tokenData.expire_time < now) {
-    throw new Error('Invalid expireTime for token generation, time cannot be in the past: ' +
-        tokenData.expire_time +
-        ' < ' +
-        now);
+    throw new Error('Invalid expireTime for token generation, time cannot be in the past: '
+        + tokenData.expire_time
+        + ' < '
+        + now);
   }
   if (
-    tokenData.connection_data &&
-    (tokenData.connection_data.length > 1024 ||
-      !_.isString(tokenData.connection_data))
+    tokenData.connection_data
+    && (tokenData.connection_data.length > 1024
+      || !_.isString(tokenData.connection_data))
   ) {
     throw new Error('Invalid data for token generation, must be a string with maximum length 1024');
   }
   if (
-    tokenData.initial_layout_class_list &&
-    tokenData.initial_layout_class_list.length > 1024
+    tokenData.initial_layout_class_list
+    && tokenData.initial_layout_class_list.length > 1024
   ) {
-    throw new Error('Invalid initial layout class list for token generation, must have ' +
-        'concatenated length of less than 1024');
+    throw new Error('Invalid initial layout class list for token generation, must have '
+        + 'concatenated length of less than 1024');
   }
 
   return encodeToken(tokenData, this.apiKey, this.apiSecret);