@twilio/conversations 2.0.1-rc.7 → 2.1.0-rc.1

package/builds/lib.js

@@ -130,6 +130,7 @@ This software includes platform.js under the following license.
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
+require('isomorphic-form-data');
 require('core-js/modules/es.reflect.construct.js');
 require('core-js/modules/es.object.keys.js');
 require('core-js/modules/es.symbol.js');
@@ -162,6 +163,7 @@ require('core-js/modules/es.regexp.exec.js');
 require('core-js/modules/es.string.replace.js');
 require('core-js/modules/es.array.join.js');
 var declarativeTypeValidator = require('@twilio/declarative-type-validator');
+require('core-js/modules/es.array.includes.js');
 var replayEventEmitter = require('@twilio/replay-event-emitter');
 var isEqual = require('lodash.isequal');
 require('core-js/modules/es.array.slice.js');
@@ -177,7 +179,6 @@ var twilioSync = require('twilio-sync');
 var mcsClient = require('@twilio/mcs-client');
 var _toConsumableArray = require('@babel/runtime/helpers/toConsumableArray');
 require('core-js/modules/es.set.js');
-require('core-js/modules/es.array.includes.js');
 require('core-js/modules/es.number.is-integer.js');
 require('core-js/modules/es.typed-array.uint8-array.js');
 require('core-js/modules/es.typed-array.copy-within.js');
@@ -549,6 +550,13 @@ var UriBuilder = /*#__PURE__*/function () {
   return UriBuilder;
 }();
 
+var attributesValidator = declarativeTypeValidator.custom(function (value) {
+  return [['string', 'number', 'boolean', 'object'].includes(_typeof__default['default'](value)), 'a JSON type'];
+});
+var optionalAttributesValidator = declarativeTypeValidator.custom(function (value) {
+  return [['undefined', 'string', 'number', 'boolean', 'object'].includes(_typeof__default['default'](value)), 'an optional JSON type'];
+});
+
 function _createSuper$8(Derived) { var hasNativeReflectConstruct = _isNativeReflectConstruct$8(); return function _createSuperInternal() { var Super = _getPrototypeOf__default['default'](Derived), result; if (hasNativeReflectConstruct) { var NewTarget = _getPrototypeOf__default['default'](this).constructor; result = Reflect.construct(Super, arguments, NewTarget); } else { result = Super.apply(this, arguments); } return _possibleConstructorReturn__default['default'](this, result); }; }
 
 function _isNativeReflectConstruct$8() { if (typeof Reflect === "undefined" || !Reflect.construct) return false; if (Reflect.construct.sham) return false; if (typeof Proxy === "function") return true; try { Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {})); return true; } catch (e) { return false; } }
@@ -1054,7 +1062,7 @@ var User = /*#__PURE__*/function (_ReplayEventEmitter) {
   return User;
 }(replayEventEmitter.ReplayEventEmitter);
 
-__decorate([declarativeTypeValidator.validateTypesAsync(['string', 'number', 'boolean', 'object', declarativeTypeValidator.literal(null)]), __metadata("design:type", Function), __metadata("design:paramtypes", [Object]), __metadata("design:returntype", Promise)], User.prototype, "updateAttributes", null);
+__decorate([declarativeTypeValidator.validateTypesAsync(attributesValidator), __metadata("design:type", Function), __metadata("design:paramtypes", [Object]), __metadata("design:returntype", Promise)], User.prototype, "updateAttributes", null);
 
 __decorate([declarativeTypeValidator.validateTypesAsync(['string']), __metadata("design:type", Function), __metadata("design:paramtypes", [String]), __metadata("design:returntype", Promise)], User.prototype, "updateFriendlyName", null);
 
@@ -1244,6 +1252,8 @@ var Participant = /*#__PURE__*/function (_ReplayEventEmitter) {
    * @internal
    */
   function Participant(data, sid, conversation, links, services) {
+    var _data$bindings;
+
     var _this;
 
     _classCallCheck__default['default'](this, Participant);
@@ -1264,7 +1274,8 @@ var Participant = /*#__PURE__*/function (_ReplayEventEmitter) {
       lastReadMessageIndex: Number.isInteger(data.lastConsumedMessageIndex) ? data.lastConsumedMessageIndex : null,
       lastReadTimestamp: data.lastConsumptionTimestamp ? parseTime$1(data.lastConsumptionTimestamp) : null,
       type: data.type || 'chat',
-      userInfo: data.userInfo
+      userInfo: data.userInfo,
+      bindings: (_data$bindings = data.bindings) !== null && _data$bindings !== void 0 ? _data$bindings : {}
     };
 
     if (!data.identity && !data.type) {
@@ -1367,7 +1378,7 @@ var Participant = /*#__PURE__*/function (_ReplayEventEmitter) {
       return this.state.roleSid;
     }
     /**
-     * Message type of the participant.
+     * Type of the participant.
      */
 
   }, {
@@ -1375,6 +1386,21 @@ var Participant = /*#__PURE__*/function (_ReplayEventEmitter) {
     get: function get() {
       return this.state.type;
     }
+    /**
+     * Get the bindings mapping for the current participant.
+     * Available binding depends on the participant type.
+     * You could access it as `participant.bindings.sms?.address` or
+     * using the type dynamically `participant.bindings[participant.type]`
+     * just be aware that the binding information has different structure for
+     * each participant type.
+     * See also {ParticipantEmailBinding}, the only available currently binding descriptor.
+     */
+
+  }, {
+    key: "bindings",
+    get: function get() {
+      return this.state.bindings;
+    }
   }, {
     key: "_startTyping",
     value:
@@ -1461,6 +1487,11 @@ var Participant = /*#__PURE__*/function (_ReplayEventEmitter) {
         }
       }
 
+      if (data.bindings && !isEqual__default['default'](this.state.bindings, data.bindings)) {
+        this.state.bindings = data.bindings;
+        updateReasons.push('bindings');
+      }
+
       if (updateReasons.length > 0) {
         this.emit('updated', {
           participant: this,
@@ -1580,7 +1611,7 @@ _defineProperty__default['default'](Participant, "typingEnded", 'typingEnded');
 
 _defineProperty__default['default'](Participant, "updated", 'updated');
 
-__decorate([declarativeTypeValidator.validateTypesAsync(['string', 'number', 'boolean', 'object', declarativeTypeValidator.literal(null)]), __metadata("design:type", Function), __metadata("design:paramtypes", [Object]), __metadata("design:returntype", Promise)], Participant.prototype, "updateAttributes", null);
+__decorate([declarativeTypeValidator.validateTypesAsync(attributesValidator), __metadata("design:type", Function), __metadata("design:paramtypes", [Object]), __metadata("design:returntype", Promise)], Participant.prototype, "updateAttributes", null);
 
 function _createSuper$6(Derived) { var hasNativeReflectConstruct = _isNativeReflectConstruct$6(); return function _createSuperInternal() { var Super = _getPrototypeOf__default['default'](Derived), result; if (hasNativeReflectConstruct) { var NewTarget = _getPrototypeOf__default['default'](this).constructor; result = Reflect.construct(Super, arguments, NewTarget); } else { result = Super.apply(this, arguments); } return _possibleConstructorReturn__default['default'](this, result); }; }
 
@@ -1760,19 +1791,38 @@ var Participants = /*#__PURE__*/function (_ReplayEventEmitter) {
 
   }, {
     key: "getParticipants",
-    value: function getParticipants() {
-      var _this4 = this;
+    value: function () {
+      var _getParticipants = _asyncToGenerator__default['default']( /*#__PURE__*/_regeneratorRuntime__default['default'].mark(function _callee3() {
+        var _this4 = this;
 
-      return this.rosterEntityPromise.then(function () {
-        var participants = [];
+        return _regeneratorRuntime__default['default'].wrap(function _callee3$(_context3) {
+          while (1) {
+            switch (_context3.prev = _context3.next) {
+              case 0:
+                return _context3.abrupt("return", this.rosterEntityPromise.then(function () {
+                  var participants = [];
 
-        _this4.participants.forEach(function (participant) {
-          return participants.push(participant);
-        });
+                  _this4.participants.forEach(function (participant) {
+                    return participants.push(participant);
+                  });
 
-        return participants;
-      });
-    }
+                  return participants;
+                }));
+
+              case 1:
+              case "end":
+                return _context3.stop();
+            }
+          }
+        }, _callee3, this);
+      }));
+
+      function getParticipants() {
+        return _getParticipants.apply(this, arguments);
+      }
+
+      return getParticipants;
+    }()
     /**
      * Get participant by SID from conversation
      * @returns {Promise<Participant>}
@@ -1781,14 +1831,14 @@ var Participants = /*#__PURE__*/function (_ReplayEventEmitter) {
   }, {
     key: "getParticipantBySid",
     value: function () {
-      var _getParticipantBySid = _asyncToGenerator__default['default']( /*#__PURE__*/_regeneratorRuntime__default['default'].mark(function _callee3(participantSid) {
+      var _getParticipantBySid = _asyncToGenerator__default['default']( /*#__PURE__*/_regeneratorRuntime__default['default'].mark(function _callee4(participantSid) {
         var _this5 = this;
 
-        return _regeneratorRuntime__default['default'].wrap(function _callee3$(_context3) {
+        return _regeneratorRuntime__default['default'].wrap(function _callee4$(_context4) {
           while (1) {
-            switch (_context3.prev = _context3.next) {
+            switch (_context4.prev = _context4.next) {
               case 0:
-                return _context3.abrupt("return", this.rosterEntityPromise.then(function () {
+                return _context4.abrupt("return", this.rosterEntityPromise.then(function () {
                   var participant = _this5.participants.get(participantSid);
 
                   if (!participant) {
@@ -1800,10 +1850,10 @@ var Participants = /*#__PURE__*/function (_ReplayEventEmitter) {
 
               case 1:
               case "end":
-                return _context3.stop();
+                return _context4.stop();
             }
           }
-        }, _callee3, this);
+        }, _callee4, this);
       }));
 
       function getParticipantBySid(_x3) {
@@ -1820,16 +1870,16 @@ var Participants = /*#__PURE__*/function (_ReplayEventEmitter) {
   }, {
     key: "getParticipantByIdentity",
     value: function () {
-      var _getParticipantByIdentity = _asyncToGenerator__default['default']( /*#__PURE__*/_regeneratorRuntime__default['default'].mark(function _callee4(identity) {
+      var _getParticipantByIdentity = _asyncToGenerator__default['default']( /*#__PURE__*/_regeneratorRuntime__default['default'].mark(function _callee5(identity) {
         var _this6 = this;
 
         var foundParticipant;
-        return _regeneratorRuntime__default['default'].wrap(function _callee4$(_context4) {
+        return _regeneratorRuntime__default['default'].wrap(function _callee5$(_context5) {
           while (1) {
-            switch (_context4.prev = _context4.next) {
+            switch (_context5.prev = _context5.next) {
               case 0:
                 foundParticipant = null;
-                return _context4.abrupt("return", this.rosterEntityPromise.then(function () {
+                return _context5.abrupt("return", this.rosterEntityPromise.then(function () {
                   _this6.participants.forEach(function (participant) {
                     if (participant.identity === identity) {
                       foundParticipant = participant;
@@ -1845,10 +1895,10 @@ var Participants = /*#__PURE__*/function (_ReplayEventEmitter) {
 
               case 2:
               case "end":
-                return _context4.stop();
+                return _context5.stop();
             }
           }
-        }, _callee4, this);
+        }, _callee5, this);
       }));
 
       function getParticipantByIdentity(_x4) {
@@ -1865,26 +1915,26 @@ var Participants = /*#__PURE__*/function (_ReplayEventEmitter) {
   }, {
     key: "add",
     value: function () {
-      var _add = _asyncToGenerator__default['default']( /*#__PURE__*/_regeneratorRuntime__default['default'].mark(function _callee5(identity, attributes) {
-        return _regeneratorRuntime__default['default'].wrap(function _callee5$(_context5) {
+      var _add = _asyncToGenerator__default['default']( /*#__PURE__*/_regeneratorRuntime__default['default'].mark(function _callee6(identity, attributes) {
+        return _regeneratorRuntime__default['default'].wrap(function _callee6$(_context6) {
           while (1) {
-            switch (_context5.prev = _context5.next) {
+            switch (_context6.prev = _context6.next) {
               case 0:
-                _context5.next = 2;
+                _context6.next = 2;
                 return this.services.commandExecutor.mutateResource('post', this.links.participants, {
                   identity: identity,
                   attributes: typeof attributes !== 'undefined' ? JSON.stringify(attributes) : undefined
                 });
 
               case 2:
-                return _context5.abrupt("return", _context5.sent);
+                return _context6.abrupt("return", _context6.sent);
 
               case 3:
               case "end":
-                return _context5.stop();
+                return _context6.stop();
             }
           }
-        }, _callee5, this);
+        }, _callee6, this);
       }));
 
       function add(_x5, _x6) {
@@ -1899,17 +1949,24 @@ var Participants = /*#__PURE__*/function (_ReplayEventEmitter) {
      * @param proxyAddress
      * @param address
      * @param attributes
+     * @param bindingOptions
      * @returns {Promise<any>}
      */
 
   }, {
     key: "addNonChatParticipant",
-    value: function addNonChatParticipant(proxyAddress, address, attributes) {
+    value: function addNonChatParticipant(proxyAddress, address) {
+      var _bindingOptions$email, _bindingOptions$email2;
+
+      var attributes = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};
+      var bindingOptions = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : {};
       return this.services.commandExecutor.mutateResource('post', this.links.participants, {
         attributes: typeof attributes !== 'undefined' ? JSON.stringify(attributes) : undefined,
         messaging_binding: {
           address: address,
-          proxy_address: proxyAddress
+          proxy_address: proxyAddress,
+          name: bindingOptions === null || bindingOptions === void 0 ? void 0 : (_bindingOptions$email = bindingOptions.email) === null || _bindingOptions$email === void 0 ? void 0 : _bindingOptions$email.name,
+          level: bindingOptions === null || bindingOptions === void 0 ? void 0 : (_bindingOptions$email2 = bindingOptions.email) === null || _bindingOptions$email2 === void 0 ? void 0 : _bindingOptions$email2.level
         }
       });
     }
@@ -2540,7 +2597,7 @@ var Message = /*#__PURE__*/function (_ReplayEventEmitter) {
       return this.state.attributes;
     }
     /**
-     * Push notification type of the message.
+     * Type of the message.
      */
 
   }, {
@@ -2549,7 +2606,7 @@ var Message = /*#__PURE__*/function (_ReplayEventEmitter) {
       return this.state.type;
     }
     /**
-     * One of the attached media.
+     * One of the attached media (if present).
      * @deprecated Use attachedMedia instead. Note that the latter is now an array.
      */
 
@@ -2601,6 +2658,38 @@ var Message = /*#__PURE__*/function (_ReplayEventEmitter) {
         return categories.includes(m.category);
       });
     }
+    /**
+     * Get a media descriptor for an email body attachment of a provided type.
+     * Allowed body types are returned in the Conversation.limits().emailBodiesAllowedMimeTypes array.
+     * @param type Type of email body to request, defaults to `text/plain`.
+     */
+
+  }, {
+    key: "getEmailBody",
+    value: function getEmailBody() {
+      var _this$getMediaByCateg, _this$getMediaByCateg2;
+
+      var type = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 'text/plain';
+      return (_this$getMediaByCateg = (_this$getMediaByCateg2 = this.getMediaByCategory(['body'])) === null || _this$getMediaByCateg2 === void 0 ? void 0 : _this$getMediaByCateg2.filter(function (m) {
+        return m.contentType == type;
+      }).shift()) !== null && _this$getMediaByCateg !== void 0 ? _this$getMediaByCateg : null;
+    }
+    /**
+     * Get a media descriptor for an email history attachment of a provided type.
+     * Allowed body types are returned in the Conversation.limits().emailHistoriesAllowedMimeTypes array.
+     * @param type Type of email history to request, defaults to `text/plain`.
+     */
+
+  }, {
+    key: "getEmailHistory",
+    value: function getEmailHistory() {
+      var _this$getMediaByCateg3, _this$getMediaByCateg4;
+
+      var type = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 'text/plain';
+      return (_this$getMediaByCateg3 = (_this$getMediaByCateg4 = this.getMediaByCategory(['history'])) === null || _this$getMediaByCateg4 === void 0 ? void 0 : _this$getMediaByCateg4.filter(function (m) {
+        return m.contentType == type;
+      }).shift()) !== null && _this$getMediaByCateg3 !== void 0 ? _this$getMediaByCateg3 : null;
+    }
   }, {
     key: "_update",
     value: function _update(data) {
@@ -3014,14 +3103,18 @@ var Message = /*#__PURE__*/function (_ReplayEventEmitter) {
 
 _defineProperty__default['default'](Message, "updated", 'updated');
 
+__decorate([declarativeTypeValidator.validateTypes(declarativeTypeValidator.nonEmptyString), __metadata("design:type", Function), __metadata("design:paramtypes", [String]), __metadata("design:returntype", Media)], Message.prototype, "getEmailBody", null);
+
+__decorate([declarativeTypeValidator.validateTypes(declarativeTypeValidator.nonEmptyString), __metadata("design:type", Function), __metadata("design:paramtypes", [String]), __metadata("design:returntype", Media)], Message.prototype, "getEmailHistory", null);
+
 __decorate([declarativeTypeValidator.validateTypesAsync('string'), __metadata("design:type", Function), __metadata("design:paramtypes", [String]), __metadata("design:returntype", Promise)], Message.prototype, "updateBody", null);
 
-__decorate([declarativeTypeValidator.validateTypesAsync(['string', 'number', 'boolean', 'object', declarativeTypeValidator.literal(null)]), __metadata("design:type", Function), __metadata("design:paramtypes", [Object]), __metadata("design:returntype", Promise)], Message.prototype, "updateAttributes", null);
+__decorate([declarativeTypeValidator.validateTypesAsync(attributesValidator), __metadata("design:type", Function), __metadata("design:paramtypes", [Object]), __metadata("design:returntype", Promise)], Message.prototype, "updateAttributes", null);
 
 __decorate([declarativeTypeValidator.validateTypesAsync(declarativeTypeValidator.custom(function (value) {
   return [value instanceof Array && value.length > 0 && value.reduce(function (a, c) {
     return a && c instanceof Media;
-  }), 'a non-empty array of Media'];
+  }, true), 'a non-empty array of Media'];
 })), __metadata("design:type", Function), __metadata("design:paramtypes", [Array]), __metadata("design:returntype", Promise)], Message.prototype, "attachTemporaryUrlsFor", null);
 
 function _createForOfIteratorHelper$2(o, allowArrayLike) { var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"]; if (!it) { if (Array.isArray(o) || (it = _unsupportedIterableToArray$2(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = true, didErr = false, err; return { s: function s() { it = it.call(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it.return != null) it.return(); } finally { if (didErr) throw err; } } }; }
@@ -3206,7 +3299,7 @@ var Messages = /*#__PURE__*/function (_ReplayEventEmitter) {
     /**
      * Send Message to the conversation, message could include both text and multiple media attachments.
      * @param message Message to post
-     * @returns Returns promise which can fail
+     * @returns Returns a promise which can fail
      */
 
   }, {
@@ -3679,6 +3772,8 @@ var MessageBuilder = /*#__PURE__*/function () {
 
     this.limits = limits;
     this.message = new UnsentMessage(messagesEntity);
+    this.emailBodies = new Map();
+    this.emailHistories = new Map();
   }
   /**
    * Sets the message body.
@@ -3714,6 +3809,30 @@ var MessageBuilder = /*#__PURE__*/function () {
       this.message.attributes = attributes;
       return this;
     }
+    /**
+     * Set email body with given MIME-type.
+     * @param mimeType Format of the body to set (text/plain or text/html).
+     * @param body Body payload in selected format.
+     */
+
+  }, {
+    key: "setEmailBody",
+    value: function setEmailBody(mimeType, body) {
+      this.emailBodies.set(mimeType, body);
+      return this;
+    }
+    /**
+     * Set email history with given MIME-type.
+     * @param mimeType Format of the history to set (text/plain or text/html).
+     * @param history History payload in selected format.
+     */
+
+  }, {
+    key: "setEmailHistory",
+    value: function setEmailHistory(mimeType, history) {
+      this.emailHistories.set(mimeType, history);
+      return this;
+    }
     /**
      * Adds media to the message.
      * @param payload Media to add.
@@ -3722,6 +3841,18 @@ var MessageBuilder = /*#__PURE__*/function () {
   }, {
     key: "addMedia",
     value: function addMedia(payload) {
+      if (typeof FormData === 'undefined' && payload instanceof FormData) {
+        throw new Error('Could not add FormData content whilst not in a browser');
+      }
+
+      if (!(payload instanceof FormData)) {
+        var mediaOptions = payload;
+
+        if (!mediaOptions.contentType || !mediaOptions.media) {
+          throw new Error('Media content in SendMediaOptions must contain non-empty contentType and media');
+        }
+      }
+
       this.message.mediaContent.push(['media', payload]);
       return this;
     }
@@ -3732,11 +3863,39 @@ var MessageBuilder = /*#__PURE__*/function () {
   }, {
     key: "build",
     value: function build() {
+      var _this = this;
+
+      this.emailBodies.forEach(function (_, key) {
+        if (!_this.limits.emailBodiesAllowedMimeTypes.includes(key)) {
+          throw new Error("Unsupported email body MIME type ".concat(key));
+        }
+      });
+      this.emailHistories.forEach(function (_, key) {
+        if (!_this.limits.emailHistoriesAllowedMimeTypes.includes(key)) {
+          throw new Error("Unsupported email history MIME type ".concat(key));
+        }
+      });
+
+      if (this.emailBodies.size > this.limits.emailBodiesAllowedMimeTypes.length) {
+        throw new Error("Too many email bodies attached to the message (".concat(this.emailBodies.size, " > ").concat(this.limits.emailBodiesAllowedMimeTypes.length, ")"));
+      }
+
+      if (this.emailHistories.size > this.limits.emailHistoriesAllowedMimeTypes.length) {
+        throw new Error("Too many email histories attached to the message (".concat(this.emailHistories.size, " > ").concat(this.limits.emailHistoriesAllowedMimeTypes.length, ")"));
+      }
+
       if (this.message.mediaContent.length > this.limits.mediaAttachmentsCountLimit) {
         throw new Error("Too many media attachments in the message (".concat(this.message.mediaContent.length, " > ").concat(this.limits.mediaAttachmentsCountLimit, ")"));
       } // @todo we don't know the sizes of the attachments in FormData
+      // @todo insertion below makes build() method non-repeatable - probably move to UnsentMessage.send() or even sendV2()?
 
 
+      this.emailBodies.forEach(function (body) {
+        _this.message.mediaContent.push(['body', body]);
+      });
+      this.emailHistories.forEach(function (history) {
+        _this.message.mediaContent.push(['history', history]);
+      });
       return this.message;
     }
   }, {
@@ -3775,7 +3934,8 @@ var fieldMappings = {
   sid: 'sid',
   status: 'status',
   uniqueName: 'uniqueName',
-  state: 'state'
+  state: 'state',
+  bindings: 'bindings'
 };
 
 function parseTime(timeString) {
@@ -3803,6 +3963,8 @@ var Conversation = /*#__PURE__*/function (_ReplayEventEmitter) {
    * @internal
    */
   function Conversation(descriptor, sid, links, configuration, services) {
+    var _descriptor$bindings;
+
     var _this;
 
     _classCallCheck__default['default'](this, Conversation);
@@ -3835,7 +3997,8 @@ var Conversation = /*#__PURE__*/function (_ReplayEventEmitter) {
       dateCreated: dateCreated,
       dateUpdated: dateUpdated,
       friendlyName: friendlyName,
-      lastReadMessageIndex: lastReadMessageIndex
+      lastReadMessageIndex: lastReadMessageIndex,
+      bindings: (_descriptor$bindings = descriptor.bindings) !== null && _descriptor$bindings !== void 0 ? _descriptor$bindings : {}
     };
 
     if (descriptor.notificationLevel) {
@@ -3969,6 +4132,11 @@ var Conversation = /*#__PURE__*/function (_ReplayEventEmitter) {
     get: function get() {
       return this.channelState.notificationLevel;
     }
+  }, {
+    key: "bindings",
+    get: function get() {
+      return this.channelState.bindings;
+    }
   }, {
     key: "limits",
     get: function get() {
@@ -4258,6 +4426,15 @@ var Conversation = /*#__PURE__*/function (_ReplayEventEmitter) {
             updateReasons.add(localKey);
             break;
 
+          case fieldMappings.bindings:
+            if (isEqual__default['default'](this.channelState.bindings, update.bindings)) {
+              break;
+            }
+
+            this.channelState.bindings = update.bindings;
+            updateReasons.add(localKey);
+            break;
+
           default:
             var isDate = update[key] instanceof Date;
             var keysMatchAsDates = isDate && ((_this$channelState$lo = this.channelState[localKey]) === null || _this$channelState$lo === void 0 ? void 0 : _this$channelState$lo.getTime()) === update[key].getTime();
@@ -4353,7 +4530,7 @@ var Conversation = /*#__PURE__*/function (_ReplayEventEmitter) {
           while (1) {
             switch (_context4.prev = _context4.next) {
               case 0:
-                return _context4.abrupt("return", this.participantsEntity.add(identity, attributes));
+                return _context4.abrupt("return", this.participantsEntity.add(identity, attributes !== null && attributes !== void 0 ? attributes : {}));
 
               case 1:
               case "end":
@@ -4374,19 +4551,25 @@ var Conversation = /*#__PURE__*/function (_ReplayEventEmitter) {
      * @param proxyAddress Proxy (Twilio) address of the participant.
      * @param address User address of the participant.
      * @param attributes Attributes to be attached to the participant.
+     * @param bindingOptions Options for adding email participants - name and CC/To level.
      */
 
   }, {
     key: "addNonChatParticipant",
     value: function () {
-      var _addNonChatParticipant = _asyncToGenerator__default['default']( /*#__PURE__*/_regeneratorRuntime__default['default'].mark(function _callee5(proxyAddress, address, attributes) {
+      var _addNonChatParticipant = _asyncToGenerator__default['default']( /*#__PURE__*/_regeneratorRuntime__default['default'].mark(function _callee5(proxyAddress, address) {
+        var attributes,
+            bindingOptions,
+            _args5 = arguments;
         return _regeneratorRuntime__default['default'].wrap(function _callee5$(_context5) {
           while (1) {
             switch (_context5.prev = _context5.next) {
               case 0:
-                return _context5.abrupt("return", this.participantsEntity.addNonChatParticipant(proxyAddress, address, attributes));
+                attributes = _args5.length > 2 && _args5[2] !== undefined ? _args5[2] : {};
+                bindingOptions = _args5.length > 3 && _args5[3] !== undefined ? _args5[3] : {};
+                return _context5.abrupt("return", this.participantsEntity.addNonChatParticipant(proxyAddress, address, attributes !== null && attributes !== void 0 ? attributes : {}, bindingOptions !== null && bindingOptions !== void 0 ? bindingOptions : {}));
 
-              case 1:
+              case 3:
               case "end":
                 return _context5.stop();
             }
@@ -4394,7 +4577,7 @@ var Conversation = /*#__PURE__*/function (_ReplayEventEmitter) {
         }, _callee5, this);
       }));
 
-      function addNonChatParticipant(_x4, _x5, _x6) {
+      function addNonChatParticipant(_x4, _x5) {
         return _addNonChatParticipant.apply(this, arguments);
       }
 
@@ -4446,7 +4629,7 @@ var Conversation = /*#__PURE__*/function (_ReplayEventEmitter) {
         }, _callee6, this);
       }));
 
-      function advanceLastReadMessageIndex(_x7) {
+      function advanceLastReadMessageIndex(_x6) {
         return _advanceLastReadMessageIndex.apply(this, arguments);
       }
 
@@ -4547,7 +4730,7 @@ var Conversation = /*#__PURE__*/function (_ReplayEventEmitter) {
         }, _callee9, this);
       }));
 
-      function getMessages(_x8, _x9, _x10) {
+      function getMessages(_x7, _x8, _x9) {
         return _getMessages.apply(this, arguments);
       }
 
@@ -4650,7 +4833,7 @@ var Conversation = /*#__PURE__*/function (_ReplayEventEmitter) {
         }, _callee12, this);
       }));
 
-      function getParticipantBySid(_x11) {
+      function getParticipantBySid(_x10) {
         return _getParticipantBySid.apply(this, arguments);
       }
 
@@ -4679,7 +4862,7 @@ var Conversation = /*#__PURE__*/function (_ReplayEventEmitter) {
         }, _callee13, this);
       }));
 
-      function getParticipantByIdentity(_x12) {
+      function getParticipantByIdentity(_x11) {
         return _getParticipantByIdentity.apply(this, arguments);
       }
 
@@ -4889,7 +5072,7 @@ var Conversation = /*#__PURE__*/function (_ReplayEventEmitter) {
         }, _callee18, this);
       }));
 
-      function removeParticipant(_x13) {
+      function removeParticipant(_x12) {
         return _removeParticipant.apply(this, arguments);
       }
 
@@ -4942,7 +5125,7 @@ var Conversation = /*#__PURE__*/function (_ReplayEventEmitter) {
         }, _callee19, this);
       }));
 
-      function sendMessage(_x14, _x15, _x16) {
+      function sendMessage(_x13, _x14, _x15) {
         return _sendMessage.apply(this, arguments);
       }
 
@@ -4951,6 +5134,7 @@ var Conversation = /*#__PURE__*/function (_ReplayEventEmitter) {
     /**
      * New interface to prepare for sending a message.
      * Use instead of `sendMessage`.
+     * @return A MessageBuilder to help set all message sending options.
      */
 
   }, {
@@ -5069,7 +5253,7 @@ var Conversation = /*#__PURE__*/function (_ReplayEventEmitter) {
         }, _callee22, this);
       }));
 
-      function setUserNotificationLevel(_x17) {
+      function setUserNotificationLevel(_x16) {
         return _setUserNotificationLevel.apply(this, arguments);
       }
 
@@ -5114,7 +5298,7 @@ var Conversation = /*#__PURE__*/function (_ReplayEventEmitter) {
         }, _callee23, this);
       }));
 
-      function updateAttributes(_x18) {
+      function updateAttributes(_x17) {
         return _updateAttributes.apply(this, arguments);
       }
 
@@ -5154,7 +5338,7 @@ var Conversation = /*#__PURE__*/function (_ReplayEventEmitter) {
         }, _callee24, this);
       }));
 
-      function updateFriendlyName(_x19) {
+      function updateFriendlyName(_x18) {
         return _updateFriendlyName.apply(this, arguments);
       }
 
@@ -5189,7 +5373,7 @@ var Conversation = /*#__PURE__*/function (_ReplayEventEmitter) {
         }, _callee25, this);
       }));
 
-      function updateLastReadMessageIndex(_x20) {
+      function updateLastReadMessageIndex(_x19) {
         return _updateLastReadMessageIndex.apply(this, arguments);
       }
 
@@ -5233,7 +5417,7 @@ var Conversation = /*#__PURE__*/function (_ReplayEventEmitter) {
         }, _callee26, this);
       }));
 
-      function updateUniqueName(_x21) {
+      function updateUniqueName(_x20) {
         return _updateUniqueName.apply(this, arguments);
       }
 
@@ -5305,9 +5489,9 @@ _defineProperty__default['default'](Conversation, "updated", 'updated');
 
 _defineProperty__default['default'](Conversation, "removed", 'removed');
 
-__decorate([declarativeTypeValidator.validateTypesAsync(declarativeTypeValidator.nonEmptyString, ['undefined', 'string', 'number', 'boolean', 'object', declarativeTypeValidator.literal(null)]), __metadata("design:type", Function), __metadata("design:paramtypes", [String, Object]), __metadata("design:returntype", Promise)], Conversation.prototype, "add", null);
+__decorate([declarativeTypeValidator.validateTypesAsync(declarativeTypeValidator.nonEmptyString, optionalAttributesValidator), __metadata("design:type", Function), __metadata("design:paramtypes", [String, Object]), __metadata("design:returntype", Promise)], Conversation.prototype, "add", null);
 
-__decorate([declarativeTypeValidator.validateTypesAsync(declarativeTypeValidator.nonEmptyString, declarativeTypeValidator.nonEmptyString, ['undefined', 'string', 'number', 'boolean', 'object', declarativeTypeValidator.literal(null)]), __metadata("design:type", Function), __metadata("design:paramtypes", [String, String, Object]), __metadata("design:returntype", Promise)], Conversation.prototype, "addNonChatParticipant", null);
+__decorate([declarativeTypeValidator.validateTypesAsync(declarativeTypeValidator.nonEmptyString, declarativeTypeValidator.nonEmptyString, optionalAttributesValidator), __metadata("design:type", Function), __metadata("design:paramtypes", [String, String, Object, Object]), __metadata("design:returntype", Promise)], Conversation.prototype, "addNonChatParticipant", null);
 
 __decorate([declarativeTypeValidator.validateTypesAsync(declarativeTypeValidator.nonNegativeInteger), __metadata("design:type", Function), __metadata("design:paramtypes", [Number]), __metadata("design:returntype", Promise)], Conversation.prototype, "advanceLastReadMessageIndex", null);
 
@@ -5333,13 +5517,13 @@ declarativeTypeValidator.custom(function (value) {
 
     return [isValid, 'a non-empty string, an instance of Buffer or an instance of Blob'];
   })
-})], ['undefined', 'string', 'number', 'boolean', 'object', declarativeTypeValidator.literal(null)], ['undefined', declarativeTypeValidator.literal(null), declarativeTypeValidator.objectSchema('email attributes', {
+})], optionalAttributesValidator, ['undefined', declarativeTypeValidator.literal(null), declarativeTypeValidator.objectSchema('email attributes', {
   subject: [declarativeTypeValidator.nonEmptyString, 'undefined']
 })]), __metadata("design:type", Function), __metadata("design:paramtypes", [Object, Object, Object]), __metadata("design:returntype", Promise)], Conversation.prototype, "sendMessage", null);
 
 __decorate([declarativeTypeValidator.validateTypesAsync(declarativeTypeValidator.literal('default', 'muted')), __metadata("design:type", Function), __metadata("design:paramtypes", [String]), __metadata("design:returntype", Promise)], Conversation.prototype, "setUserNotificationLevel", null);
 
-__decorate([declarativeTypeValidator.validateTypesAsync(['string', 'number', 'boolean', 'object', declarativeTypeValidator.literal(null)]), __metadata("design:type", Function), __metadata("design:paramtypes", [Object]), __metadata("design:returntype", Promise)], Conversation.prototype, "updateAttributes", null);
+__decorate([declarativeTypeValidator.validateTypesAsync(attributesValidator), __metadata("design:type", Function), __metadata("design:paramtypes", [Object]), __metadata("design:returntype", Promise)], Conversation.prototype, "updateAttributes", null);
 
 __decorate([declarativeTypeValidator.validateTypesAsync(['string']), __metadata("design:type", Function), __metadata("design:paramtypes", [String]), __metadata("design:returntype", Promise)], Conversation.prototype, "updateFriendlyName", null);
 
@@ -6082,7 +6266,7 @@ var Conversations = /*#__PURE__*/function (_ReplayEventEmitter) {
                     channel: conversationDescriptor.sync_objects.conversation,
                     messages: conversationDescriptor.sync_objects.messages,
                     roster: "".concat(conversationDescriptor.conversation_sid, ".roster"),
-                    lastConsumedMessageIndex: conversationDescriptor.last_consumed_message_index,
+                    lastConsumedMessageIndex: conversationDescriptor.last_read_message_index,
                     notificationLevel: conversationDescriptor.notification_level
                   };
                 });
@@ -6599,7 +6783,7 @@ function PushNotification(data) {
   this.data = data.data || {};
 };
 
-var version = "2.0.1-rc.7";
+var version = "2.1.0-rc.1";
 
 function ownKeys$1(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); if (enumerableOnly) { symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; }); } keys.push.apply(keys, symbols); } return keys; }