@twilio/conversations 2.5.0-rc.0 → 2.5.0

package/builds/browser.js

@@ -302,11 +302,13 @@ var Logger = /*#__PURE__*/function () {
   }, {
     key: "trace",
     value: function trace() {
-      for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
-        args[_key] = arguments[_key];
-      }
+      if (log$7.getLevel() == log$7.levels.TRACE) {
+        for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
+          args[_key] = arguments[_key];
+        }
 
-      log$7.trace.apply(null, prepareLine(this.prefix + "T", args));
+        log$7.debug.apply(null, prepareLine(this.prefix + "T", args));
+      }
     }
   }, {
     key: "debug",
@@ -357,11 +359,13 @@ var Logger = /*#__PURE__*/function () {
   }, {
     key: "trace",
     value: function trace() {
-      for (var _len6 = arguments.length, args = new Array(_len6), _key6 = 0; _key6 < _len6; _key6++) {
-        args[_key6] = arguments[_key6];
-      }
+      if (log$7.getLevel() == log$7.levels.TRACE) {
+        for (var _len6 = arguments.length, args = new Array(_len6), _key6 = 0; _key6 < _len6; _key6++) {
+          args[_key6] = arguments[_key6];
+        }
 
-      log$7.trace.apply(null, prepareLine("T", args));
+        log$7.debug.apply(null, prepareLine("T", args));
+      }
     }
   }, {
     key: "debug",
@@ -1449,8 +1453,9 @@ var Participant = /*#__PURE__*/function (_ReplayEventEmitter) {
       }
 
       this.state.isTyping = true;
-      this.emit("typingStarted", this);
-      this.conversation.emit("typingStarted", this);
+      this.emit(Participant.typingStarted, this);
+      this.conversation.emit(Conversation.typingStarted, this); // @fixme layering violation
+
       this.state.typingTimeout = Number(setTimeout(function () {
         return _this2._endTyping();
       }, timeout));
@@ -1469,8 +1474,8 @@ var Participant = /*#__PURE__*/function (_ReplayEventEmitter) {
       }
 
       this.state.isTyping = false;
-      this.emit("typingEnded", this);
-      this.conversation.emit("typingEnded", this);
+      this.emit(Participant.typingEnded, this);
+      this.conversation.emit(Conversation.typingEnded, this);
       clearInterval(this.state.typingTimeout);
       this.state.typingTimeout = null;
     }
@@ -1529,7 +1534,7 @@ var Participant = /*#__PURE__*/function (_ReplayEventEmitter) {
       }
 
       if (updateReasons.length > 0) {
-        this.emit("updated", {
+        this.emit(Participant.updated, {
           participant: this,
           updateReasons: updateReasons
         });
@@ -1665,7 +1670,8 @@ var Participants = /*#__PURE__*/function (_ReplayEventEmitter) {
 
   var _super = _createSuper$7(Participants);
 
-  function Participants(conversation, participants, links, configuration, services) {
+  // passed in from Conversation
+  function Participants(conversation, participants, links, services) {
     var _this;
 
     _classCallCheck__default["default"](this, Participants);
@@ -1677,7 +1683,6 @@ var Participants = /*#__PURE__*/function (_ReplayEventEmitter) {
     _this.conversation = conversation;
     _this.participants = participants;
     _this.links = links;
-    _this.configuration = configuration;
     _this.services = services;
     return _this;
   }
@@ -1728,14 +1733,14 @@ var Participants = /*#__PURE__*/function (_ReplayEventEmitter) {
         mode: "open_existing"
       }) : Promise.resolve(arg);
       return this.rosterEntityPromise = this.rosterEntityPromise || participantsMapPromise.then(function (rosterMap) {
-        rosterMap.on("itemAdded", function (args) {
+        rosterMap.on(twilioSync.SyncMap.itemAdded, function (args) {
           log$4.debug(_this2.conversation.sid + " itemAdded: " + args.item.key);
 
           _this2.upsertParticipant(args.item.key, args.item.data).then(function (participant) {
-            _this2.emit("participantJoined", participant);
+            _this2.emit(Conversation.participantJoined, participant);
           });
         });
-        rosterMap.on("itemRemoved", function (args) {
+        rosterMap.on(twilioSync.SyncMap.itemRemoved, function (args) {
           log$4.debug(_this2.conversation.sid + " itemRemoved: " + args.key);
           var participantSid = args.key;
 
@@ -1751,12 +1756,14 @@ var Participants = /*#__PURE__*/function (_ReplayEventEmitter) {
             return;
           }
 
-          _this2.emit("participantLeft", leftParticipant);
+          _this2.emit(Conversation.participantLeft, leftParticipant);
         });
-        rosterMap.on("itemUpdated", function (args) {
+        rosterMap.on(twilioSync.SyncMap.itemUpdated, function (args) {
           log$4.debug(_this2.conversation.sid + " itemUpdated: " + args.item.key);
 
-          _this2.upsertParticipant(args.item.key, args.item.data);
+          _this2.upsertParticipant(args.item.key, args.item.data).catch(function (e) {
+            return log$4.error(e);
+          });
         });
         var participantsPromises = [];
 
@@ -1850,8 +1857,8 @@ var Participants = /*#__PURE__*/function (_ReplayEventEmitter) {
                 };
                 participant = new Participant(data, participantSid, this.conversation, links, this.services);
                 this.participants.set(participantSid, participant);
-                participant.on("updated", function (args) {
-                  return _this3.emit("participantUpdated", args);
+                participant.on(Participant.updated, function (args) {
+                  return _this3.emit(Conversation.participantUpdated, args);
                 });
                 return _context3.abrupt("return", participant);
 
@@ -3207,7 +3214,7 @@ var Message = /*#__PURE__*/function (_ReplayEventEmitter) {
       var _getParticipant = _asyncToGenerator__default["default"]( /*#__PURE__*/_regeneratorRuntime__default["default"].mark(function _callee() {
         var _this3 = this;
 
-        var participant, errorMesage;
+        var participant, errorMessage;
         return _regeneratorRuntime__default["default"].wrap(function _callee$(_context) {
           while (1) {
             switch (_context.prev = _context.next) {
@@ -3252,26 +3259,26 @@ var Message = /*#__PURE__*/function (_ReplayEventEmitter) {
                 return _context.abrupt("return", participant);
 
               case 11:
-                errorMesage = "Participant with ";
+                errorMessage = "Participant with ";
 
                 if (this.state.participantSid) {
-                  errorMesage += "SID '" + this.state.participantSid + "' ";
+                  errorMessage += "SID '" + this.state.participantSid + "' ";
                 }
 
                 if (this.state.author) {
                   if (this.state.participantSid) {
-                    errorMesage += "or ";
+                    errorMessage += "or ";
                   }
 
-                  errorMesage += "identity '" + this.state.author + "' ";
+                  errorMessage += "identity '" + this.state.author + "' ";
                 }
 
-                if (errorMesage === "Participant with ") {
-                  errorMesage = "Participant ";
+                if (errorMessage === "Participant with ") {
+                  errorMessage = "Participant ";
                 }
 
-                errorMesage += "was not found";
-                throw new Error(errorMesage);
+                errorMessage += "was not found";
+                throw new Error(errorMessage);
 
               case 17:
               case "end":
@@ -4934,32 +4941,39 @@ var Conversation = /*#__PURE__*/function (_ReplayEventEmitter) {
       participants: _this._links.participants
     };
     _this._participants = new Map();
-    _this._participantsEntity = new Participants(_assertThisInitialized__default["default"](_this), _this._participants, participantsLinks, _this._configuration, _this._services);
+    _this._participantsEntity = new Participants(_assertThisInitialized__default["default"](_this), _this._participants, // state leak
+    participantsLinks, _this._services);
 
-    _this._participantsEntity.on("participantJoined", function (participant) {
-      return _this.emit("participantJoined", participant);
+    _this._participantsEntity.on(Conversation.participantJoined, function (participant) {
+      return (// @todo update participants map here??
+        _this.emit(Conversation.participantJoined, participant)
+      );
     });
 
-    _this._participantsEntity.on("participantLeft", function (participant) {
-      return _this.emit("participantLeft", participant);
+    _this._participantsEntity.on(Conversation.participantLeft, function (participant) {
+      return (// @todo update participants map here??
+        _this.emit(Conversation.participantLeft, participant)
+      );
     });
 
-    _this._participantsEntity.on("participantUpdated", function (args) {
-      return _this.emit("participantUpdated", args);
+    _this._participantsEntity.on(Conversation.participantUpdated, function (args) {
+      return (// @todo update participants map here??
+        _this.emit(Conversation.participantUpdated, args)
+      );
     });
 
     _this._messagesEntity = new Messages(_assertThisInitialized__default["default"](_this), configuration, services);
 
-    _this._messagesEntity.on("messageAdded", function (message) {
+    _this._messagesEntity.on(Conversation.messageAdded, function (message) {
       return _this._onMessageAdded(message);
     });
 
-    _this._messagesEntity.on("messageUpdated", function (args) {
-      return _this.emit("messageUpdated", args);
+    _this._messagesEntity.on(Conversation.messageUpdated, function (args) {
+      return _this.emit(Conversation.messageUpdated, args);
     });
 
-    _this._messagesEntity.on("messageRemoved", function (message) {
-      return _this.emit("messageRemoved", message);
+    _this._messagesEntity.on(Conversation.messageRemoved, function (message) {
+      return _this.emit(Conversation.messageRemoved, message);
     });
 
     return _this;
@@ -5062,7 +5076,7 @@ var Conversation = /*#__PURE__*/function (_ReplayEventEmitter) {
       return (_this$_internalState$3 = this._internalState.notificationLevel) !== null && _this$_internalState$3 !== void 0 ? _this$_internalState$3 : "default";
     }
     /**
-     * Conversation bindings. Undocumented feature (for now).
+     * Conversation bindings. An undocumented feature (for now).
      * @internal
      */
 
@@ -6044,18 +6058,19 @@ var Conversation = /*#__PURE__*/function (_ReplayEventEmitter) {
     }()
     /**
      * Get recipients of all messages in the conversation.
+     * @param options Optional configuration, set pageSize to request a specific pagination page size. Page size specifies a number of messages to include in a single batch. Each message may include multiple recipients.
      */
 
   }, {
     key: "getMessageRecipients",
     value: function () {
-      var _getMessageRecipients = _asyncToGenerator__default["default"]( /*#__PURE__*/_regeneratorRuntime__default["default"].mark(function _callee24() {
+      var _getMessageRecipients = _asyncToGenerator__default["default"]( /*#__PURE__*/_regeneratorRuntime__default["default"].mark(function _callee24(options) {
         return _regeneratorRuntime__default["default"].wrap(function _callee24$(_context24) {
           while (1) {
             switch (_context24.prev = _context24.next) {
               case 0:
                 _context24.next = 2;
-                return this._services.messageRecipientsClient.getRecipientsFromConversation(this.sid);
+                return this._services.messageRecipientsClient.getRecipientsFromConversation(this.sid, options);
 
               case 2:
                 return _context24.abrupt("return", _context24.sent);
@@ -6068,7 +6083,7 @@ var Conversation = /*#__PURE__*/function (_ReplayEventEmitter) {
         }, _callee24, this);
       }));
 
-      function getMessageRecipients() {
+      function getMessageRecipients(_x19) {
         return _getMessageRecipients.apply(this, arguments);
       }
 
@@ -6077,7 +6092,7 @@ var Conversation = /*#__PURE__*/function (_ReplayEventEmitter) {
     /**
      * Load and subscribe to this conversation and do not subscribe to its
      * participants and messages. This or _subscribeStreams will need to be called
-     * before any events on conversation will fire.
+     * before any events in the conversation will fire.
      * @internal
      */
 
@@ -6110,12 +6125,12 @@ var Conversation = /*#__PURE__*/function (_ReplayEventEmitter) {
               case 6:
                 this._entity = _context25.sent;
 
-                this._entity.on("updated", function (args) {
+                this._entity.on(twilioSync.SyncDocument.updated, function (args) {
                   return _this2._update(args.data);
                 });
 
-                this._entity.on("removed", function () {
-                  return _this2.emit("removed", _this2);
+                this._entity.on(twilioSync.SyncDocument.removed, function () {
+                  return _this2.emit(Conversation.removed, _this2);
                 });
 
                 this._update(this._entity.data);
@@ -6283,22 +6298,16 @@ var Conversation = /*#__PURE__*/function (_ReplayEventEmitter) {
           while (1) {
             switch (_context28.prev = _context28.next) {
               case 0:
-                if (!this._entity) {
-                  _context28.next = 5;
-                  break;
-                }
-
-                _context28.next = 3;
-                return this._entity.close();
+                if (this._entity) {
+                  this._entity.close();
 
-              case 3:
-                this._entity = null;
-                this._entityPromise = null;
+                  this._entity = null;
+                  this._entityPromise = null;
+                }
 
-              case 5:
                 return _context28.abrupt("return", Promise.all([this._participantsEntity.unsubscribe(), this._messagesEntity.unsubscribe()]));
 
-              case 6:
+              case 2:
               case "end":
                 return _context28.stop();
             }
@@ -6467,7 +6476,7 @@ var Conversation = /*#__PURE__*/function (_ReplayEventEmitter) {
       }
 
       if (updateReasons.size > 0) {
-        this.emit("updated", {
+        this.emit(Conversation.updated, {
           conversation: this,
           updateReasons: _toConsumableArray__default["default"](updateReasons)
         });
@@ -6499,7 +6508,7 @@ var Conversation = /*#__PURE__*/function (_ReplayEventEmitter) {
         _iterator.f();
       }
 
-      this.emit("messageAdded", message);
+      this.emit(Conversation.messageAdded, message);
     }
     /**
      * Set last read message index.
@@ -6532,7 +6541,7 @@ var Conversation = /*#__PURE__*/function (_ReplayEventEmitter) {
         }, _callee29, this);
       }));
 
-      function _setLastReadMessageIndex(_x19) {
+      function _setLastReadMessageIndex(_x20) {
         return _setLastReadMessageIndex2.apply(this, arguments);
       }
 
@@ -6612,7 +6621,7 @@ _defineProperty__default["default"](Conversation, "_logger", Logger.scope("Conve
 
 __decorate([declarativeTypeValidator.validateTypesAsync(declarativeTypeValidator.nonEmptyString, optionalJson), __metadata("design:type", Function), __metadata("design:paramtypes", [String, Object]), __metadata("design:returntype", Promise)], Conversation.prototype, "add", null);
 
-__decorate([declarativeTypeValidator.validateTypesAsync(declarativeTypeValidator.nonEmptyString, declarativeTypeValidator.nonEmptyString, optionalJson), __metadata("design:type", Function), __metadata("design:paramtypes", [String, String, Object, Object]), __metadata("design:returntype", Promise)], Conversation.prototype, "addNonChatParticipant", null);
+__decorate([declarativeTypeValidator.validateTypesAsync(declarativeTypeValidator.nonEmptyString, declarativeTypeValidator.nonEmptyString, optionalJson, optionalJson), __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);
 
@@ -6809,7 +6818,7 @@ var Conversations = /*#__PURE__*/function (_ReplayEventEmitter) {
       return addConversation;
     }()
     /**
-     * Fetch conversations list and instantiate all necessary objects
+     * Fetch conversations' list and instantiate all necessary objects
      */
 
   }, {
@@ -6830,12 +6839,12 @@ var Conversations = /*#__PURE__*/function (_ReplayEventEmitter) {
 
               case 3:
                 map = _context2.sent;
-                map.on("itemAdded", function (args) {
+                map.on(twilioSync.SyncMap.itemAdded, function (args) {
                   log$1.debug("itemAdded: ".concat(args.item.key));
 
                   _this2._upsertConversation("sync", args.item.key, args.item.data);
                 });
-                map.on("itemRemoved", function (args) {
+                map.on(twilioSync.SyncMap.itemRemoved, function (args) {
                   log$1.debug("itemRemoved: ".concat(args.key));
                   var sid = args.key;
 
@@ -6861,7 +6870,7 @@ var Conversations = /*#__PURE__*/function (_ReplayEventEmitter) {
 
                   conversation.emit("removed", conversation);
                 });
-                map.on("itemUpdated", function (args) {
+                map.on(twilioSync.SyncMap.itemUpdated, function (args) {
                   log$1.debug("itemUpdated: ".concat(args.item.key));
 
                   _this2._upsertConversation("sync", args.item.key, args.item.data);
@@ -7954,7 +7963,7 @@ function PushNotification(data) {
   this.data = data.data || {};
 });
 
-var version = "2.5.0-rc.0";
+var version = "2.5.0";
 
 function ownKeys$1(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); enumerableOnly && (symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; }
 
@@ -8949,7 +8958,7 @@ var MessageRecipientsClient = /*#__PURE__*/function () {
           while (1) {
             switch (_context2.prev = _context2.next) {
               case 0:
-                url = new UriBuilder(this._configuration.links.conversations).path(conversationSid).path("MessageRecipients").arg("PageToken", (_paginatorOptions$pag = paginatorOptions === null || paginatorOptions === void 0 ? void 0 : paginatorOptions.pageToken) !== null && _paginatorOptions$pag !== void 0 ? _paginatorOptions$pag : "").arg("PageSize", (_paginatorOptions$pag2 = paginatorOptions === null || paginatorOptions === void 0 ? void 0 : paginatorOptions.pageSize) !== null && _paginatorOptions$pag2 !== void 0 ? _paginatorOptions$pag2 : "").build();
+                url = new UriBuilder(this._configuration.links.conversations).path(conversationSid).path("MessageRecipients").arg("PageToken", (_paginatorOptions$pag = paginatorOptions === null || paginatorOptions === void 0 ? void 0 : paginatorOptions.pageToken) !== null && _paginatorOptions$pag !== void 0 ? _paginatorOptions$pag : undefined).arg("PageSize", (_paginatorOptions$pag2 = paginatorOptions === null || paginatorOptions === void 0 ? void 0 : paginatorOptions.pageSize) !== null && _paginatorOptions$pag2 !== void 0 ? _paginatorOptions$pag2 : undefined).build();
                 _context2.next = 3;
                 return this._services.commandExecutor.fetchResource(url);
 
@@ -9281,7 +9290,7 @@ exports.Client = Client_1 = (_class = /*#__PURE__*/function (_ReplayEventEmitter
    */
 
   /**
-   * Returned Conversations instance is not yet fully initialized. Calling any
+   * Returned Conversations Client instance is not yet fully initialized. Calling any
    * operations will block until it is. Use connection events to monitor when
    * client becomes fully available (connectionStateChanged with state
    * 'connected') or not available (connectionStateChange with state 'denied',
@@ -9371,16 +9380,16 @@ exports.Client = Client_1 = (_class = /*#__PURE__*/function (_ReplayEventEmitter
 
     _this._services.twilsockClient = _this._options.twilsockClient = (_this$_options$twilso = _this._options.twilsockClient) !== null && _this$_options$twilso !== void 0 ? _this$_options$twilso : new twilsock.TwilsockClient(fpaToken, productId, _this._options);
 
-    _this._services.twilsockClient.on("tokenAboutToExpire", function () {
-      return _this.emit("tokenAboutToExpire");
+    _this._services.twilsockClient.on(Client_1.tokenAboutToExpire, function () {
+      return _this.emit(Client_1.tokenAboutToExpire);
     });
 
-    _this._services.twilsockClient.on("tokenExpired", function () {
-      return _this.emit("tokenExpired");
+    _this._services.twilsockClient.on(Client_1.tokenExpired, function () {
+      return _this.emit(Client_1.tokenExpired);
     });
 
-    _this._services.twilsockClient.on("connectionError", function (error) {
-      return _this.emit("connectionError", error);
+    _this._services.twilsockClient.on(Client_1.connectionError, function (error) {
+      return _this.emit(Client_1.connectionError, error);
     });
 
     _this._services.twilsockClient.on("stateChanged", function (state) {
@@ -9389,7 +9398,7 @@ exports.Client = Client_1 = (_class = /*#__PURE__*/function (_ReplayEventEmitter
       if (state !== _this.connectionState) {
         _this.connectionState = state;
 
-        _this.emit("connectionStateChanged", _this.connectionState);
+        _this.emit(Client_1.connectionStateChanged, _this.connectionState);
       }
     });
 
@@ -9407,9 +9416,9 @@ exports.Client = Client_1 = (_class = /*#__PURE__*/function (_ReplayEventEmitter
     var emitFailed = function emitFailed(error) {
       _this._rejectEnsureReady(error);
 
-      _this.emit("stateChanged", "failed");
+      _this.emit(Client_1.stateChanged, "failed");
 
-      _this.emit("initFailed", {
+      _this.emit(Client_1.initFailed, {
         error: error
       });
     };
@@ -9462,9 +9471,9 @@ exports.Client = Client_1 = (_class = /*#__PURE__*/function (_ReplayEventEmitter
 
               _this._rejectEnsureReady(connectionError);
 
-              _this.emit("stateChanged", "failed");
+              _this.emit(Client_1.stateChanged, "failed");
 
-              _this.emit("initFailed", {
+              _this.emit(Client_1.initFailed, {
                 error: connectionError
               });
 
@@ -9992,7 +10001,7 @@ exports.Client = Client_1 = (_class = /*#__PURE__*/function (_ReplayEventEmitter
       return removePushRegistrations;
     }()
     /**
-     * Current version of the Conversations client.
+     * Parse a push notification payload.
      */
 
   }, {
@@ -10329,8 +10338,8 @@ exports.Client = Client_1 = (_class = /*#__PURE__*/function (_ReplayEventEmitter
 
                 this._resolveEnsureReady();
 
-                this.emit("stateChanged", "initialized");
-                this.emit("initialized");
+                this.emit(Client_1.stateChanged, "initialized");
+                this.emit(Client_1.initialized);
 
               case 36:
               case "end":