@webex/plugin-messages 3.0.0-beta.8 → 3.0.0-bnr.0

package/README.md

@@ -29,15 +29,12 @@ npm install --save @webex/plugin-messages
 ## Usage
 
 ```js
-
 const Webex = require('webex');
 
 const webex = Webex.init();
-webex.messages.get(id)
-  .then((message) => {
-    console.log(message);
-  })
-
+webex.messages.get(id).then((message) => {
+  console.log(message);
+});
 ```
 
 ## Maintainers

package/dist/index.js

@@ -1,27 +1,21 @@
 "use strict";
 
 var _Object$defineProperty = require("@babel/runtime-corejs2/core-js/object/define-property");
-
 var _interopRequireDefault = require("@babel/runtime-corejs2/helpers/interopRequireDefault");
-
 _Object$defineProperty(exports, "__esModule", {
   value: true
 });
-
 exports.default = void 0;
-
 require("@webex/internal-plugin-conversation");
-
 require("@webex/internal-plugin-mercury");
-
 var _webexCore = require("@webex/webex-core");
-
 var _messages = _interopRequireDefault(require("./messages"));
-
 /*!
  * Copyright (c) 2015-2020 Cisco Systems, Inc. See LICENSE file.
  */
+
 // decrypt mercury activities
+
 (0, _webexCore.registerPlugin)('messages', _messages.default);
 var _default = _messages.default;
 exports.default = _default;

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["registerPlugin","Messages"],"sources":["index.js"],"sourcesContent":["/*!\n * Copyright (c) 2015-2020 Cisco Systems, Inc. See LICENSE file.\n */\n\nimport '@webex/internal-plugin-conversation'; // decrypt mercury activities\nimport '@webex/internal-plugin-mercury';\n\nimport {registerPlugin} from '@webex/webex-core';\n\nimport Messages from './messages';\n\nregisterPlugin('messages', Messages);\n\nexport default Messages;\n"],"mappings":";;;;;;;;;;;;AAIA;;AACA;;AAEA;;AAEA;;AATA;AACA;AACA;AAE8C;AAO9C,IAAAA,yBAAA,EAAe,UAAf,EAA2BC,iBAA3B;eAEeA,iB"}
+{"version":3,"names":["registerPlugin","Messages"],"sources":["index.js"],"sourcesContent":["/*!\n * Copyright (c) 2015-2020 Cisco Systems, Inc. See LICENSE file.\n */\n\nimport '@webex/internal-plugin-conversation'; // decrypt mercury activities\nimport '@webex/internal-plugin-mercury';\n\nimport {registerPlugin} from '@webex/webex-core';\n\nimport Messages from './messages';\n\nregisterPlugin('messages', Messages);\n\nexport default Messages;\n"],"mappings":";;;;;;;;AAIA;AACA;AAEA;AAEA;AATA;AACA;AACA;;AAE8C;;AAO9C,IAAAA,yBAAc,EAAC,UAAU,EAAEC,iBAAQ,CAAC;AAAC,eAEtBA,iBAAQ;AAAA"}

package/dist/messages.js

@@ -1,52 +1,32 @@
 "use strict";
 
 var _Object$keys = require("@babel/runtime-corejs2/core-js/object/keys");
-
 var _Object$getOwnPropertySymbols = require("@babel/runtime-corejs2/core-js/object/get-own-property-symbols");
-
 var _Object$getOwnPropertyDescriptor = require("@babel/runtime-corejs2/core-js/object/get-own-property-descriptor");
-
 var _Object$getOwnPropertyDescriptors = require("@babel/runtime-corejs2/core-js/object/get-own-property-descriptors");
-
 var _Object$defineProperties = require("@babel/runtime-corejs2/core-js/object/define-properties");
-
 var _Object$defineProperty = require("@babel/runtime-corejs2/core-js/object/define-property");
-
 var _interopRequireDefault = require("@babel/runtime-corejs2/helpers/interopRequireDefault");
-
 _Object$defineProperty(exports, "__esModule", {
   value: true
 });
-
 exports.default = void 0;
-
 var _apply = _interopRequireDefault(require("@babel/runtime-corejs2/core-js/reflect/apply"));
-
 var _deleteProperty = _interopRequireDefault(require("@babel/runtime-corejs2/core-js/reflect/delete-property"));
-
 var _promise = _interopRequireDefault(require("@babel/runtime-corejs2/core-js/promise"));
-
 var _defineProperty2 = _interopRequireDefault(require("@babel/runtime-corejs2/helpers/defineProperty"));
-
 var _isArray2 = _interopRequireDefault(require("lodash/isArray"));
-
 var _cloneDeep2 = _interopRequireDefault(require("lodash/cloneDeep"));
-
 var _common = require("@webex/common");
-
 var _webexCore = require("@webex/webex-core");
-
 var _verbToType;
-
 function ownKeys(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; }
-
 function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? ownKeys(Object(source), !0).forEach(function (key) { (0, _defineProperty2.default)(target, key, source[key]); }) : _Object$getOwnPropertyDescriptors ? _Object$defineProperties(target, _Object$getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function (key) { _Object$defineProperty(target, key, _Object$getOwnPropertyDescriptor(source, key)); }); } return target; }
-
 var verbToType = (_verbToType = {}, (0, _defineProperty2.default)(_verbToType, _common.SDK_EVENT.INTERNAL.ACTIVITY_VERB.SHARE, _common.SDK_EVENT.EXTERNAL.EVENT_TYPE.CREATED), (0, _defineProperty2.default)(_verbToType, _common.SDK_EVENT.INTERNAL.ACTIVITY_VERB.POST, _common.SDK_EVENT.EXTERNAL.EVENT_TYPE.CREATED), (0, _defineProperty2.default)(_verbToType, _common.SDK_EVENT.INTERNAL.ACTIVITY_VERB.DELETE, _common.SDK_EVENT.EXTERNAL.EVENT_TYPE.DELETED), _verbToType);
-
 var getRoomType = function getRoomType(roomTags) {
   return roomTags.includes(_common.SDK_EVENT.INTERNAL.ACTIVITY_TAG.ONE_ON_ONE) ? _common.SDK_EVENT.EXTERNAL.SPACE_TYPE.DIRECT : _common.SDK_EVENT.EXTERNAL.SPACE_TYPE.GROUP;
 };
+
 /**
  * @typedef {Object} MessageObject
  * @property {string} id - (server generated) Unique identifier for the message
@@ -69,8 +49,6 @@ var getRoomType = function getRoomType(roomTags) {
  * for a list of supported media types.
  * @class
  */
-
-
 var Messages = _webexCore.WebexPlugin.extend({
   /**
    * Initializer used to generate Messages
@@ -84,10 +62,8 @@ var Messages = _webexCore.WebexPlugin.extend({
     for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
       args[_key] = arguments[_key];
     }
-
     (0, _apply.default)(_webexCore.WebexPlugin.prototype.initialize, this, args);
   },
-
   /**
    * Register to listen for incoming messages events
    * This is an alternate approach to registering for messages webhooks.
@@ -123,11 +99,11 @@ var Messages = _webexCore.WebexPlugin.extend({
    */
   listen: function listen() {
     var _this = this;
-
     // Create a common envelope that we will wrap all events in
     return (0, _common.createEventEnvelope)(this.webex, _common.SDK_EVENT.EXTERNAL.RESOURCE.MESSAGES).then(function (envelope) {
-      _this.eventEnvelope = envelope; // Register to listen to events
+      _this.eventEnvelope = envelope;
 
+      // Register to listen to events
       return _this.webex.internal.mercury.connect().then(function () {
         _this.listenTo(_this.webex.internal.mercury, _common.SDK_EVENT.INTERNAL.WEBEX_ACTIVITY, function (event) {
           return _this.onWebexApiEvent(event);
@@ -135,7 +111,6 @@ var Messages = _webexCore.WebexPlugin.extend({
       });
     });
   },
-
   /**
    * Post a new message and/or media content into a room.
    * @instance
@@ -163,19 +138,16 @@ var Messages = _webexCore.WebexPlugin.extend({
    */
   create: function create(message) {
     var key = 'body';
-
     if (message.file) {
       this.logger.warn('Supplying a single `file` property is deprecated; please supply a `files` array');
       message.files = [message.file];
       (0, _deleteProperty.default)(message, 'file');
     }
-
     if ((0, _isArray2.default)(message.files) && message.files.reduce(function (type, file) {
       return type || typeof file !== 'string';
     }, false)) {
       key = 'formData';
     }
-
     var options = (0, _defineProperty2.default)({
       method: 'POST',
       service: 'hydra',
@@ -185,7 +157,6 @@ var Messages = _webexCore.WebexPlugin.extend({
       return res.body;
     });
   },
-
   /**
    * Returns a single message.
    * @instance
@@ -221,7 +192,6 @@ var Messages = _webexCore.WebexPlugin.extend({
       return res.body.items || res.body;
     });
   },
-
   /**
    * Returns a list of messages. In most cases the results will only contain
    * messages posted in rooms that the authenticated user is a member of.
@@ -263,7 +233,6 @@ var Messages = _webexCore.WebexPlugin.extend({
    */
   list: function list(options) {
     var _this2 = this;
-
     return this.request({
       service: 'hydra',
       resource: 'messages',
@@ -272,7 +241,6 @@ var Messages = _webexCore.WebexPlugin.extend({
       return new _webexCore.Page(res, _this2.webex);
     });
   },
-
   /**
    * Deletes a single message. Deleting a message will notify all members of the
    * room that the authenticated user deleted the message. Generally, users can
@@ -325,11 +293,9 @@ var Messages = _webexCore.WebexPlugin.extend({
       if (res.statusCode === 204) {
         return undefined;
       }
-
       return res.body;
     });
   },
-
   /**
    * Curry the 'trigger' method
    * @private
@@ -339,12 +305,10 @@ var Messages = _webexCore.WebexPlugin.extend({
    */
   fire: function fire(type) {
     var _this3 = this;
-
     return function (event) {
       return _this3.trigger(type, event);
     };
   },
-
   /**
    * This function is called when an internal membership events fires,
    * if the user registered for these events with the listen() function.
@@ -359,14 +323,11 @@ var Messages = _webexCore.WebexPlugin.extend({
   onWebexApiEvent: function onWebexApiEvent(_ref) {
     var activity = _ref.data.activity;
     var type = verbToType[activity.verb];
-
     if (!type) {
       return;
     }
-
     this.getMessageEvent(activity, type).then(this.fire(type));
   },
-
   /**
    * Constructs the data object for an event on the messages resource,
    * adhering to Hydra's Webhook data structure messages.
@@ -379,18 +340,17 @@ var Messages = _webexCore.WebexPlugin.extend({
    */
   getMessageEvent: function getMessageEvent(activity, type) {
     var id = activity.id,
-        _activity$actor = activity.actor,
-        actorId = _activity$actor.entryUUID,
-        emailAddress = _activity$actor.emailAddress,
-        objectId = activity.object.id,
-        _activity$target = activity.target,
-        roomId = _activity$target.id,
-        roomUrl = _activity$target.url,
-        roomTags = _activity$target.tags;
+      _activity$actor = activity.actor,
+      actorId = _activity$actor.entryUUID,
+      emailAddress = _activity$actor.emailAddress,
+      objectId = activity.object.id,
+      _activity$target = activity.target,
+      roomId = _activity$target.id,
+      roomUrl = _activity$target.url,
+      roomTags = _activity$target.tags;
     var cluster = (0, _common.getHydraClusterString)(this.webex, roomUrl);
     var combinedEvent = (0, _cloneDeep2.default)(this.eventEnvelope);
     combinedEvent.event = type;
-
     if (type === _common.SDK_EVENT.EXTERNAL.EVENT_TYPE.DELETED) {
       // Cannot fetch since the message is deleted
       // Convert the Mercury event to a Hydra event
@@ -406,7 +366,6 @@ var Messages = _webexCore.WebexPlugin.extend({
         }
       }));
     }
-
     return this.get((0, _common.buildHydraMessageId)(id, cluster)).then(function (data) {
       return _objectSpread(_objectSpread({}, combinedEvent), {}, {
         actorId: data.personId,
@@ -414,9 +373,8 @@ var Messages = _webexCore.WebexPlugin.extend({
       });
     });
   },
-  version: "3.0.0-beta.8"
+  version: "3.0.0-bnr.0"
 });
-
 var _default = Messages;
 exports.default = _default;
 //# sourceMappingURL=messages.js.map

package/dist/messages.js.map

@@ -1 +1 @@
-{"version":3,"names":["verbToType","SDK_EVENT","INTERNAL","ACTIVITY_VERB","SHARE","EXTERNAL","EVENT_TYPE","CREATED","POST","DELETE","DELETED","getRoomType","roomTags","includes","ACTIVITY_TAG","ONE_ON_ONE","SPACE_TYPE","DIRECT","GROUP","Messages","WebexPlugin","extend","initialize","args","prototype","listen","createEventEnvelope","webex","RESOURCE","MESSAGES","then","envelope","eventEnvelope","internal","mercury","connect","listenTo","WEBEX_ACTIVITY","event","onWebexApiEvent","create","message","key","file","logger","warn","files","reduce","type","options","method","service","resource","request","res","body","get","id","items","list","qs","Page","remove","statusCode","undefined","fire","trigger","activity","data","verb","getMessageEvent","actor","actorId","entryUUID","emailAddress","objectId","object","target","roomId","roomUrl","url","tags","cluster","getHydraClusterString","combinedEvent","personId","buildHydraPersonId","resolve","buildHydraMessageId","personEmail","buildHydraRoomId","roomType"],"sources":["messages.js"],"sourcesContent":["/*!\n * Copyright (c) 2015-2020 Cisco Systems, Inc. See LICENSE file.\n */\n\nimport {\n  SDK_EVENT,\n  buildHydraMessageId,\n  buildHydraPersonId,\n  buildHydraRoomId,\n  createEventEnvelope,\n  getHydraClusterString\n} from '@webex/common';\nimport {\n  Page,\n  WebexPlugin\n} from '@webex/webex-core';\nimport {cloneDeep, isArray} from 'lodash';\n\nconst verbToType = {\n  [SDK_EVENT.INTERNAL.ACTIVITY_VERB.SHARE]:\n    SDK_EVENT.EXTERNAL.EVENT_TYPE.CREATED,\n  [SDK_EVENT.INTERNAL.ACTIVITY_VERB.POST]:\n    SDK_EVENT.EXTERNAL.EVENT_TYPE.CREATED,\n  [SDK_EVENT.INTERNAL.ACTIVITY_VERB.DELETE]:\n    SDK_EVENT.EXTERNAL.EVENT_TYPE.DELETED\n};\n\nconst getRoomType = (roomTags) =>\n  (roomTags.includes(SDK_EVENT.INTERNAL.ACTIVITY_TAG.ONE_ON_ONE) ?\n    SDK_EVENT.EXTERNAL.SPACE_TYPE.DIRECT :\n    SDK_EVENT.EXTERNAL.SPACE_TYPE.GROUP);\n\n/**\n * @typedef {Object} MessageObject\n * @property {string} id - (server generated) Unique identifier for the message\n * @property {string} personId - The ID for the author of the message\n * @property {email} personEmail - The email for the author of the message\n * @property {string} roomId - The ID for the room of the message\n * @property {string} text - The message posted to the room in plain text\n * @property {string} markdown - The message posted to the room in markdown\n * @property {Array<string>} files - The source URL(s) for the message attachment(s).\n * See the {@link https://developer.webex.com/docs/api/basics#message-attachments|Message Attachments}\n * Guide for a list of supported media types.\n * @property {isoDate} created - (server generated) The date and time that the message was created\n */\n\n/**\n * Messages are how people communicate in rooms. Each message timestamped and\n * represented in Webex as a distinct block of content. Messages can contain\n * plain text and a single file attachment. See the\n * {@link https://developer.webex.com/docs/api/basics#message-attachments|Message Attachments} Guide\n * for a list of supported media types.\n * @class\n */\nconst Messages = WebexPlugin.extend({\n  /**\n   * Initializer used to generate Messages\n   * as a plugin wrapped around the provided arguments.\n   * @private\n   * @see WebexPlugin.initialize\n   * @param  {...any} args\n   * @returns {undefined}\n   */\n  initialize(...args) {\n    Reflect.apply(WebexPlugin.prototype.initialize, this, args);\n  },\n\n  /**\n   * Register to listen for incoming messages events\n   * This is an alternate approach to registering for messages webhooks.\n   * The events passed to any registered handlers will be similar to the webhook JSON,\n   * but will omit webhook specific fields such as name, secret, url, etc.\n   * The messages.listen() event objects can also include additional fields not\n   * available in the webhook's JSON payload: `text`, `markdown`, and `files`.\n   * These fields are available when their details are included in the web socket's\n   * `activity` object. Retrieving other fields, such as the `html` field,\n   * will require a manual request to get the corresponding message object.\n   * To utilize the `listen()` method, the authorization token used\n   * will need to have `spark:all` and `spark:kms` scopes enabled.\n   * Note that by configuring your application to enable or disable `spark:all`\n   * via its configuration page will also enable or disable `spark:kms`.\n   * See the <a href=\"https://webex.github.io/webex-js-sdk/samples/browser-socket/\">Sample App</a>\n   * for more details.\n   * @instance\n   * @memberof Messages\n   * @returns {Promise}\n   * @example\n   * webex.messages.listen()\n   *   .then(() => {\n   *     console.log('listening to message events');\n   *     webex.messages.on('created', (event) => console.log(`Got a message:created event:\\n${event}`));\n   *     webex.messages.on('deleted', (event) => console.log(`Got a message:deleted event:\\n${event}`));\n   *   })\n   *   .catch((e) => console.error(`Unable to register for message events: ${e}`));\n   * // Some app logic...\n   * // When it is time to cleanup\n   * webex.messages.stopListening();\n   * webex.messages.off('created');\n   * webex.messages.off('deleted');\n   */\n  listen() {\n    // Create a common envelope that we will wrap all events in\n    return createEventEnvelope(this.webex,\n      SDK_EVENT.EXTERNAL.RESOURCE.MESSAGES)\n      .then((envelope) => {\n        this.eventEnvelope = envelope;\n\n        // Register to listen to events\n        return this.webex.internal.mercury.connect().then(() => {\n          this.listenTo(this.webex.internal.mercury,\n            SDK_EVENT.INTERNAL.WEBEX_ACTIVITY,\n            (event) => this.onWebexApiEvent(event));\n        });\n      });\n  },\n\n  /**\n   * Post a new message and/or media content into a room.\n   * @instance\n   * @memberof Messages\n   * @param {MessageObject} message\n   * @returns {Promise<MessageObject>}\n   * @example\n   * webex.rooms.create({title: 'Create Message Example'})\n   *   .then(function(room) {\n   *     return webex.messages.create({\n   *       text: 'Howdy!',\n   *       roomId: room.id\n   *     });\n   *   })\n   *   .then(function(message) {\n   *     var assert = require('assert');\n   *     assert(message.id);\n   *     assert(message.personId);\n   *     assert(message.personEmail);\n   *     assert(message.roomId);\n   *     assert(message.created);\n   *     return 'success';\n   *   });\n   *   // => success\n   */\n  create(message) {\n    let key = 'body';\n\n    if (message.file) {\n      this.logger.warn('Supplying a single `file` property is deprecated; please supply a `files` array');\n      message.files = [message.file];\n      Reflect.deleteProperty(message, 'file');\n    }\n\n    if (isArray(message.files) && message.files.reduce((type, file) => type || typeof file !== 'string', false)) {\n      key = 'formData';\n    }\n\n    const options = {\n      method: 'POST',\n      service: 'hydra',\n      resource: 'messages',\n      [key]: message\n    };\n\n    return this.request(options)\n      .then((res) => res.body);\n  },\n\n  /**\n   * Returns a single message.\n   * @instance\n   * @memberof Messages\n   * @param {RoomObject|string} message\n   * @returns {Promise<MessageObject>}\n   * @example\n   * var message;\n   * webex.rooms.create({title: 'Get Message Example'})\n   *   .then(function(room) {\n   *     return webex.messages.create({\n   *       text: 'Howdy!',\n   *       roomId: room.id\n   *     });\n   *   })\n   *   .then(function(m) {\n   *     message = m;\n   *     return webex.messages.get(message.id);\n   *   })\n   *   .then(function(message2) {\n   *     var assert = require('assert');\n   *     assert.deepEqual(message2, message);\n   *     return 'success';\n   *   });\n   *   // => success\n   */\n  get(message) {\n    const id = message.id || message;\n\n    return this.request({\n      service: 'hydra',\n      resource: `messages/${id}`\n    })\n      .then((res) => res.body.items || res.body);\n  },\n\n  /**\n   * Returns a list of messages. In most cases the results will only contain\n   * messages posted in rooms that the authenticated user is a member of.\n   * @instance\n   * @memberof Messages\n   * @param {Object} options\n   * @param {string} options.roomId\n   * @param {number} options.max\n   * @returns {Promise<Page<MessageObject>>}\n   * @example\n   * var message1, message2, room;\n   * webex.rooms.create({title: 'List Messages Example'})\n   *   .then(function(r) {\n   *     room = r;\n   *     return webex.messages.create({\n   *       text: 'Howdy!',\n   *       roomId: room.id\n   *     });\n   *   })\n   *   .then(function(m) {\n   *     message1 = m;\n   *     return webex.messages.create({\n   *       text: 'How are you?',\n   *       roomId: room.id\n   *     });\n   *   })\n   *   .then(function(m) {\n   *     message2 = m;\n   *     return webex.messages.list({roomId: room.id});\n   *   })\n   *   .then(function(messages) {\n   *     var assert = require('assert');\n   *     assert.equal(messages.length, 2);\n   *     assert.equal(messages.items[0].id, message2.id);\n   *     assert.equal(messages.items[1].id, message1.id);\n   *     return 'success';\n   *   });\n   *   // => success\n   */\n  list(options) {\n    return this.request({\n      service: 'hydra',\n      resource: 'messages',\n      qs: options\n    })\n      .then((res) => new Page(res, this.webex));\n  },\n\n  /**\n   * Deletes a single message. Deleting a message will notify all members of the\n   * room that the authenticated user deleted the message. Generally, users can\n   * only delete their own messages except for the case of Moderated Rooms and\n   * Org Administrators.\n   * @instance\n   * @memberof Messages\n   * @param {MessageObject|uuid} message\n   * @returns {Promise}}\n   * @example\n   * var message1, room;\n   * webex.rooms.create({title: 'Messages Example'})\n   *   .then(function(r) {\n   *     room = r;\n   *     return webex.messages.create({\n   *       text: 'Howdy!',\n   *       roomId: room.id\n   *     });\n   *   })\n   *   .then(function(m) {\n   *     message1 = m;\n   *     return webex.messages.create({\n   *       text: 'How are you?',\n   *       roomId: room.id\n   *     });\n   *   })\n   *   .then(function() {\n   *     return webex.messages.remove(message1);\n   *   })\n   *   .then(function() {\n   *     return webex.messages.list({roomId: room.id});\n   *   })\n   *   .then(function(messages) {\n   *     var assert = require('assert');\n   *     assert.equal(messages.items.length, 1);\n   *     assert(messages.items[0].id !== message1.id);\n   *     return 'success';\n   *   });\n   *   // => success\n   */\n  remove(message) {\n    const id = message.id || message;\n\n    return this.request({\n      method: 'DELETE',\n      service: 'hydra',\n      resource: `messages/${id}`\n    })\n      .then((res) => {\n        // Firefox has some issues with 204s and/or DELETE. This should move to\n        // http-core\n        if (res.statusCode === 204) {\n          return undefined;\n        }\n\n        return res.body;\n      });\n  },\n\n  /**\n   * Curry the 'trigger' method\n   * @private\n   * @memberof Messages\n   * @param {string} type the type of event to fire\n   * @returns {function} takes event and triggers it\n   */\n  fire(type) {\n    return (event) => this.trigger(type, event);\n  },\n\n  /**\n   * This function is called when an internal membership events fires,\n   * if the user registered for these events with the listen() function.\n   * External users of the SDK should not call this function\n   * @private\n   * @memberof Messages\n   * @param {Object} event\n   * @param {Object} event.data contains the data of the event\n   * @param {Object} event.data.activity the activity that triggered the event\n   * @returns {void}\n   */\n  onWebexApiEvent({data: {activity}}) {\n    const type = verbToType[activity.verb];\n\n    if (!type) {\n      return;\n    }\n\n    this.getMessageEvent(activity, type)\n      .then(this.fire(type));\n  },\n\n  /**\n   * Constructs the data object for an event on the messages resource,\n   * adhering to Hydra's Webhook data structure messages.\n   * External users of the SDK should not call this function\n   * @private\n   * @memberof Messages\n   * @param {Object} activity from mercury\n   * @param {String} type the type of event\n   * @returns {Object} constructed event\n   */\n  getMessageEvent(activity, type) {\n    const {\n      id,\n      actor: {entryUUID: actorId, emailAddress},\n      object: {id: objectId},\n      target: {id: roomId, url: roomUrl, tags: roomTags}\n    } = activity;\n\n    const cluster = getHydraClusterString(this.webex, roomUrl);\n    const combinedEvent = cloneDeep(this.eventEnvelope);\n\n    combinedEvent.event = type;\n    if (type === SDK_EVENT.EXTERNAL.EVENT_TYPE.DELETED) {\n      // Cannot fetch since the message is deleted\n      // Convert the Mercury event to a Hydra event\n      const personId = buildHydraPersonId(actorId, cluster);\n\n      return Promise.resolve({\n        ...combinedEvent,\n        actorId: personId,\n        data: {\n          id: buildHydraMessageId(objectId, cluster),\n          personEmail: emailAddress || actorId,\n          personId,\n          roomId: buildHydraRoomId(roomId, cluster),\n          roomType: getRoomType(roomTags)\n        }\n      });\n    }\n\n    return this.get(buildHydraMessageId(id, cluster))\n      .then((data) => ({\n        ...combinedEvent,\n        actorId: data.personId,\n        data\n      }));\n  }\n});\n\nexport default Messages;\n"],"mappings":"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A;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACEC,GAzIkC,eAyI9Bf,OAzI8B,EAyIrB;IACX,IAAMgB,EAAE,GAAGhB,OAAO,CAACgB,EAAR,IAAchB,OAAzB;IAEA,OAAO,KAAKY,OAAL,CAAa;MAClBF,OAAO,EAAE,OADS;MAElBC,QAAQ,qBAAcK,EAAd;IAFU,CAAb,EAIJ3B,IAJI,CAIC,UAACwB,GAAD;MAAA,OAASA,GAAG,CAACC,IAAJ,CAASG,KAAT,IAAkBJ,GAAG,CAACC,IAA/B;IAAA,CAJD,CAAP;EAKD,CAjJiC;;EAmJlC;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACEI,IA1LkC,gBA0L7BV,OA1L6B,EA0LpB;IAAA;;IACZ,OAAO,KAAKI,OAAL,CAAa;MAClBF,OAAO,EAAE,OADS;MAElBC,QAAQ,EAAE,UAFQ;MAGlBQ,EAAE,EAAEX;IAHc,CAAb,EAKJnB,IALI,CAKC,UAACwB,GAAD;MAAA,OAAS,IAAIO,eAAJ,CAASP,GAAT,EAAc,MAAI,CAAC3B,KAAnB,CAAT;IAAA,CALD,CAAP;EAMD,CAjMiC;;EAmMlC;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACEmC,MA3OkC,kBA2O3BrB,OA3O2B,EA2OlB;IACd,IAAMgB,EAAE,GAAGhB,OAAO,CAACgB,EAAR,IAAchB,OAAzB;IAEA,OAAO,KAAKY,OAAL,CAAa;MAClBH,MAAM,EAAE,QADU;MAElBC,OAAO,EAAE,OAFS;MAGlBC,QAAQ,qBAAcK,EAAd;IAHU,CAAb,EAKJ3B,IALI,CAKC,UAACwB,GAAD,EAAS;MACb;MACA;MACA,IAAIA,GAAG,CAACS,UAAJ,KAAmB,GAAvB,EAA4B;QAC1B,OAAOC,SAAP;MACD;;MAED,OAAOV,GAAG,CAACC,IAAX;IACD,CAbI,CAAP;EAcD,CA5PiC;;EA8PlC;AACF;AACA;AACA;AACA;AACA;AACA;EACEU,IArQkC,gBAqQ7BjB,IArQ6B,EAqQvB;IAAA;;IACT,OAAO,UAACV,KAAD;MAAA,OAAW,MAAI,CAAC4B,OAAL,CAAalB,IAAb,EAAmBV,KAAnB,CAAX;IAAA,CAAP;EACD,CAvQiC;;EAyQlC;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACEC,eApRkC,iCAoRE;IAAA,IAAZ4B,QAAY,QAAnBC,IAAmB,CAAZD,QAAY;IAClC,IAAMnB,IAAI,GAAGhD,UAAU,CAACmE,QAAQ,CAACE,IAAV,CAAvB;;IAEA,IAAI,CAACrB,IAAL,EAAW;MACT;IACD;;IAED,KAAKsB,eAAL,CAAqBH,QAArB,EAA+BnB,IAA/B,EACGlB,IADH,CACQ,KAAKmC,IAAL,CAAUjB,IAAV,CADR;EAED,CA7RiC;;EA+RlC;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACEsB,eAzSkC,2BAySlBH,QAzSkB,EAySRnB,IAzSQ,EAySF;IAC9B,IACES,EADF,GAKIU,QALJ,CACEV,EADF;IAAA,sBAKIU,QALJ,CAEEI,KAFF;IAAA,IAEqBC,OAFrB,mBAEUC,SAFV;IAAA,IAE8BC,YAF9B,mBAE8BA,YAF9B;IAAA,IAGeC,QAHf,GAKIR,QALJ,CAGES,MAHF,CAGWnB,EAHX;IAAA,uBAKIU,QALJ,CAIEU,MAJF;IAAA,IAIeC,MAJf,oBAIWrB,EAJX;IAAA,IAI4BsB,OAJ5B,oBAIuBC,GAJvB;IAAA,IAI2CpE,QAJ3C,oBAIqCqE,IAJrC;IAOA,IAAMC,OAAO,GAAG,IAAAC,6BAAA,EAAsB,KAAKxD,KAA3B,EAAkCoD,OAAlC,CAAhB;IACA,IAAMK,aAAa,GAAG,yBAAU,KAAKpD,aAAf,CAAtB;IAEAoD,aAAa,CAAC9C,KAAd,GAAsBU,IAAtB;;IACA,IAAIA,IAAI,KAAK/C,iBAAA,CAAUI,QAAV,CAAmBC,UAAnB,CAA8BI,OAA3C,EAAoD;MAClD;MACA;MACA,IAAM2E,QAAQ,GAAG,IAAAC,0BAAA,EAAmBd,OAAnB,EAA4BU,OAA5B,CAAjB;MAEA,OAAO,iBAAQK,OAAR,iCACFH,aADE;QAELZ,OAAO,EAAEa,QAFJ;QAGLjB,IAAI,EAAE;UACJX,EAAE,EAAE,IAAA+B,2BAAA,EAAoBb,QAApB,EAA8BO,OAA9B,CADA;UAEJO,WAAW,EAAEf,YAAY,IAAIF,OAFzB;UAGJa,QAAQ,EAARA,QAHI;UAIJP,MAAM,EAAE,IAAAY,wBAAA,EAAiBZ,MAAjB,EAAyBI,OAAzB,CAJJ;UAKJS,QAAQ,EAAEhF,WAAW,CAACC,QAAD;QALjB;MAHD,GAAP;IAWD;;IAED,OAAO,KAAK4C,GAAL,CAAS,IAAAgC,2BAAA,EAAoB/B,EAApB,EAAwByB,OAAxB,CAAT,EACJpD,IADI,CACC,UAACsC,IAAD;MAAA,uCACDgB,aADC;QAEJZ,OAAO,EAAEJ,IAAI,CAACiB,QAFV;QAGJjB,IAAI,EAAJA;MAHI;IAAA,CADD,CAAP;EAMD,CA7UiC;EAAA;AAAA,CAAnB,CAAjB;;eAgVejD,Q"}
+{"version":3,"names":["verbToType","SDK_EVENT","INTERNAL","ACTIVITY_VERB","SHARE","EXTERNAL","EVENT_TYPE","CREATED","POST","DELETE","DELETED","getRoomType","roomTags","includes","ACTIVITY_TAG","ONE_ON_ONE","SPACE_TYPE","DIRECT","GROUP","Messages","WebexPlugin","extend","initialize","args","prototype","listen","createEventEnvelope","webex","RESOURCE","MESSAGES","then","envelope","eventEnvelope","internal","mercury","connect","listenTo","WEBEX_ACTIVITY","event","onWebexApiEvent","create","message","key","file","logger","warn","files","reduce","type","options","method","service","resource","request","res","body","get","id","items","list","qs","Page","remove","statusCode","undefined","fire","trigger","activity","data","verb","getMessageEvent","actor","actorId","entryUUID","emailAddress","objectId","object","target","roomId","roomUrl","url","tags","cluster","getHydraClusterString","combinedEvent","personId","buildHydraPersonId","resolve","buildHydraMessageId","personEmail","buildHydraRoomId","roomType"],"sources":["messages.js"],"sourcesContent":["/*!\n * Copyright (c) 2015-2020 Cisco Systems, Inc. See LICENSE file.\n */\n\nimport {\n  SDK_EVENT,\n  buildHydraMessageId,\n  buildHydraPersonId,\n  buildHydraRoomId,\n  createEventEnvelope,\n  getHydraClusterString,\n} from '@webex/common';\nimport {Page, WebexPlugin} from '@webex/webex-core';\nimport {cloneDeep, isArray} from 'lodash';\n\nconst verbToType = {\n  [SDK_EVENT.INTERNAL.ACTIVITY_VERB.SHARE]: SDK_EVENT.EXTERNAL.EVENT_TYPE.CREATED,\n  [SDK_EVENT.INTERNAL.ACTIVITY_VERB.POST]: SDK_EVENT.EXTERNAL.EVENT_TYPE.CREATED,\n  [SDK_EVENT.INTERNAL.ACTIVITY_VERB.DELETE]: SDK_EVENT.EXTERNAL.EVENT_TYPE.DELETED,\n};\n\nconst getRoomType = (roomTags) =>\n  roomTags.includes(SDK_EVENT.INTERNAL.ACTIVITY_TAG.ONE_ON_ONE)\n    ? SDK_EVENT.EXTERNAL.SPACE_TYPE.DIRECT\n    : SDK_EVENT.EXTERNAL.SPACE_TYPE.GROUP;\n\n/**\n * @typedef {Object} MessageObject\n * @property {string} id - (server generated) Unique identifier for the message\n * @property {string} personId - The ID for the author of the message\n * @property {email} personEmail - The email for the author of the message\n * @property {string} roomId - The ID for the room of the message\n * @property {string} text - The message posted to the room in plain text\n * @property {string} markdown - The message posted to the room in markdown\n * @property {Array<string>} files - The source URL(s) for the message attachment(s).\n * See the {@link https://developer.webex.com/docs/api/basics#message-attachments|Message Attachments}\n * Guide for a list of supported media types.\n * @property {isoDate} created - (server generated) The date and time that the message was created\n */\n\n/**\n * Messages are how people communicate in rooms. Each message timestamped and\n * represented in Webex as a distinct block of content. Messages can contain\n * plain text and a single file attachment. See the\n * {@link https://developer.webex.com/docs/api/basics#message-attachments|Message Attachments} Guide\n * for a list of supported media types.\n * @class\n */\nconst Messages = WebexPlugin.extend({\n  /**\n   * Initializer used to generate Messages\n   * as a plugin wrapped around the provided arguments.\n   * @private\n   * @see WebexPlugin.initialize\n   * @param  {...any} args\n   * @returns {undefined}\n   */\n  initialize(...args) {\n    Reflect.apply(WebexPlugin.prototype.initialize, this, args);\n  },\n\n  /**\n   * Register to listen for incoming messages events\n   * This is an alternate approach to registering for messages webhooks.\n   * The events passed to any registered handlers will be similar to the webhook JSON,\n   * but will omit webhook specific fields such as name, secret, url, etc.\n   * The messages.listen() event objects can also include additional fields not\n   * available in the webhook's JSON payload: `text`, `markdown`, and `files`.\n   * These fields are available when their details are included in the web socket's\n   * `activity` object. Retrieving other fields, such as the `html` field,\n   * will require a manual request to get the corresponding message object.\n   * To utilize the `listen()` method, the authorization token used\n   * will need to have `spark:all` and `spark:kms` scopes enabled.\n   * Note that by configuring your application to enable or disable `spark:all`\n   * via its configuration page will also enable or disable `spark:kms`.\n   * See the <a href=\"https://webex.github.io/webex-js-sdk/samples/browser-socket/\">Sample App</a>\n   * for more details.\n   * @instance\n   * @memberof Messages\n   * @returns {Promise}\n   * @example\n   * webex.messages.listen()\n   *   .then(() => {\n   *     console.log('listening to message events');\n   *     webex.messages.on('created', (event) => console.log(`Got a message:created event:\\n${event}`));\n   *     webex.messages.on('deleted', (event) => console.log(`Got a message:deleted event:\\n${event}`));\n   *   })\n   *   .catch((e) => console.error(`Unable to register for message events: ${e}`));\n   * // Some app logic...\n   * // When it is time to cleanup\n   * webex.messages.stopListening();\n   * webex.messages.off('created');\n   * webex.messages.off('deleted');\n   */\n  listen() {\n    // Create a common envelope that we will wrap all events in\n    return createEventEnvelope(this.webex, SDK_EVENT.EXTERNAL.RESOURCE.MESSAGES).then(\n      (envelope) => {\n        this.eventEnvelope = envelope;\n\n        // Register to listen to events\n        return this.webex.internal.mercury.connect().then(() => {\n          this.listenTo(this.webex.internal.mercury, SDK_EVENT.INTERNAL.WEBEX_ACTIVITY, (event) =>\n            this.onWebexApiEvent(event)\n          );\n        });\n      }\n    );\n  },\n\n  /**\n   * Post a new message and/or media content into a room.\n   * @instance\n   * @memberof Messages\n   * @param {MessageObject} message\n   * @returns {Promise<MessageObject>}\n   * @example\n   * webex.rooms.create({title: 'Create Message Example'})\n   *   .then(function(room) {\n   *     return webex.messages.create({\n   *       text: 'Howdy!',\n   *       roomId: room.id\n   *     });\n   *   })\n   *   .then(function(message) {\n   *     var assert = require('assert');\n   *     assert(message.id);\n   *     assert(message.personId);\n   *     assert(message.personEmail);\n   *     assert(message.roomId);\n   *     assert(message.created);\n   *     return 'success';\n   *   });\n   *   // => success\n   */\n  create(message) {\n    let key = 'body';\n\n    if (message.file) {\n      this.logger.warn(\n        'Supplying a single `file` property is deprecated; please supply a `files` array'\n      );\n      message.files = [message.file];\n      Reflect.deleteProperty(message, 'file');\n    }\n\n    if (\n      isArray(message.files) &&\n      message.files.reduce((type, file) => type || typeof file !== 'string', false)\n    ) {\n      key = 'formData';\n    }\n\n    const options = {\n      method: 'POST',\n      service: 'hydra',\n      resource: 'messages',\n      [key]: message,\n    };\n\n    return this.request(options).then((res) => res.body);\n  },\n\n  /**\n   * Returns a single message.\n   * @instance\n   * @memberof Messages\n   * @param {RoomObject|string} message\n   * @returns {Promise<MessageObject>}\n   * @example\n   * var message;\n   * webex.rooms.create({title: 'Get Message Example'})\n   *   .then(function(room) {\n   *     return webex.messages.create({\n   *       text: 'Howdy!',\n   *       roomId: room.id\n   *     });\n   *   })\n   *   .then(function(m) {\n   *     message = m;\n   *     return webex.messages.get(message.id);\n   *   })\n   *   .then(function(message2) {\n   *     var assert = require('assert');\n   *     assert.deepEqual(message2, message);\n   *     return 'success';\n   *   });\n   *   // => success\n   */\n  get(message) {\n    const id = message.id || message;\n\n    return this.request({\n      service: 'hydra',\n      resource: `messages/${id}`,\n    }).then((res) => res.body.items || res.body);\n  },\n\n  /**\n   * Returns a list of messages. In most cases the results will only contain\n   * messages posted in rooms that the authenticated user is a member of.\n   * @instance\n   * @memberof Messages\n   * @param {Object} options\n   * @param {string} options.roomId\n   * @param {number} options.max\n   * @returns {Promise<Page<MessageObject>>}\n   * @example\n   * var message1, message2, room;\n   * webex.rooms.create({title: 'List Messages Example'})\n   *   .then(function(r) {\n   *     room = r;\n   *     return webex.messages.create({\n   *       text: 'Howdy!',\n   *       roomId: room.id\n   *     });\n   *   })\n   *   .then(function(m) {\n   *     message1 = m;\n   *     return webex.messages.create({\n   *       text: 'How are you?',\n   *       roomId: room.id\n   *     });\n   *   })\n   *   .then(function(m) {\n   *     message2 = m;\n   *     return webex.messages.list({roomId: room.id});\n   *   })\n   *   .then(function(messages) {\n   *     var assert = require('assert');\n   *     assert.equal(messages.length, 2);\n   *     assert.equal(messages.items[0].id, message2.id);\n   *     assert.equal(messages.items[1].id, message1.id);\n   *     return 'success';\n   *   });\n   *   // => success\n   */\n  list(options) {\n    return this.request({\n      service: 'hydra',\n      resource: 'messages',\n      qs: options,\n    }).then((res) => new Page(res, this.webex));\n  },\n\n  /**\n   * Deletes a single message. Deleting a message will notify all members of the\n   * room that the authenticated user deleted the message. Generally, users can\n   * only delete their own messages except for the case of Moderated Rooms and\n   * Org Administrators.\n   * @instance\n   * @memberof Messages\n   * @param {MessageObject|uuid} message\n   * @returns {Promise}}\n   * @example\n   * var message1, room;\n   * webex.rooms.create({title: 'Messages Example'})\n   *   .then(function(r) {\n   *     room = r;\n   *     return webex.messages.create({\n   *       text: 'Howdy!',\n   *       roomId: room.id\n   *     });\n   *   })\n   *   .then(function(m) {\n   *     message1 = m;\n   *     return webex.messages.create({\n   *       text: 'How are you?',\n   *       roomId: room.id\n   *     });\n   *   })\n   *   .then(function() {\n   *     return webex.messages.remove(message1);\n   *   })\n   *   .then(function() {\n   *     return webex.messages.list({roomId: room.id});\n   *   })\n   *   .then(function(messages) {\n   *     var assert = require('assert');\n   *     assert.equal(messages.items.length, 1);\n   *     assert(messages.items[0].id !== message1.id);\n   *     return 'success';\n   *   });\n   *   // => success\n   */\n  remove(message) {\n    const id = message.id || message;\n\n    return this.request({\n      method: 'DELETE',\n      service: 'hydra',\n      resource: `messages/${id}`,\n    }).then((res) => {\n      // Firefox has some issues with 204s and/or DELETE. This should move to\n      // http-core\n      if (res.statusCode === 204) {\n        return undefined;\n      }\n\n      return res.body;\n    });\n  },\n\n  /**\n   * Curry the 'trigger' method\n   * @private\n   * @memberof Messages\n   * @param {string} type the type of event to fire\n   * @returns {function} takes event and triggers it\n   */\n  fire(type) {\n    return (event) => this.trigger(type, event);\n  },\n\n  /**\n   * This function is called when an internal membership events fires,\n   * if the user registered for these events with the listen() function.\n   * External users of the SDK should not call this function\n   * @private\n   * @memberof Messages\n   * @param {Object} event\n   * @param {Object} event.data contains the data of the event\n   * @param {Object} event.data.activity the activity that triggered the event\n   * @returns {void}\n   */\n  onWebexApiEvent({data: {activity}}) {\n    const type = verbToType[activity.verb];\n\n    if (!type) {\n      return;\n    }\n\n    this.getMessageEvent(activity, type).then(this.fire(type));\n  },\n\n  /**\n   * Constructs the data object for an event on the messages resource,\n   * adhering to Hydra's Webhook data structure messages.\n   * External users of the SDK should not call this function\n   * @private\n   * @memberof Messages\n   * @param {Object} activity from mercury\n   * @param {String} type the type of event\n   * @returns {Object} constructed event\n   */\n  getMessageEvent(activity, type) {\n    const {\n      id,\n      actor: {entryUUID: actorId, emailAddress},\n      object: {id: objectId},\n      target: {id: roomId, url: roomUrl, tags: roomTags},\n    } = activity;\n\n    const cluster = getHydraClusterString(this.webex, roomUrl);\n    const combinedEvent = cloneDeep(this.eventEnvelope);\n\n    combinedEvent.event = type;\n    if (type === SDK_EVENT.EXTERNAL.EVENT_TYPE.DELETED) {\n      // Cannot fetch since the message is deleted\n      // Convert the Mercury event to a Hydra event\n      const personId = buildHydraPersonId(actorId, cluster);\n\n      return Promise.resolve({\n        ...combinedEvent,\n        actorId: personId,\n        data: {\n          id: buildHydraMessageId(objectId, cluster),\n          personEmail: emailAddress || actorId,\n          personId,\n          roomId: buildHydraRoomId(roomId, cluster),\n          roomType: getRoomType(roomTags),\n        },\n      });\n    }\n\n    return this.get(buildHydraMessageId(id, cluster)).then((data) => ({\n      ...combinedEvent,\n      actorId: data.personId,\n      data,\n    }));\n  },\n});\n\nexport default Messages;\n"],"mappings":"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A;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACEC,GAAG,eAACf,OAAO,EAAE;IACX,IAAMgB,EAAE,GAAGhB,OAAO,CAACgB,EAAE,IAAIhB,OAAO;IAEhC,OAAO,IAAI,CAACY,OAAO,CAAC;MAClBF,OAAO,EAAE,OAAO;MAChBC,QAAQ,qBAAcK,EAAE;IAC1B,CAAC,CAAC,CAAC3B,IAAI,CAAC,UAACwB,GAAG;MAAA,OAAKA,GAAG,CAACC,IAAI,CAACG,KAAK,IAAIJ,GAAG,CAACC,IAAI;IAAA,EAAC;EAC9C,CAAC;EAED;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACEI,IAAI,gBAACV,OAAO,EAAE;IAAA;IACZ,OAAO,IAAI,CAACI,OAAO,CAAC;MAClBF,OAAO,EAAE,OAAO;MAChBC,QAAQ,EAAE,UAAU;MACpBQ,EAAE,EAAEX;IACN,CAAC,CAAC,CAACnB,IAAI,CAAC,UAACwB,GAAG;MAAA,OAAK,IAAIO,eAAI,CAACP,GAAG,EAAE,MAAI,CAAC3B,KAAK,CAAC;IAAA,EAAC;EAC7C,CAAC;EAED;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACEmC,MAAM,kBAACrB,OAAO,EAAE;IACd,IAAMgB,EAAE,GAAGhB,OAAO,CAACgB,EAAE,IAAIhB,OAAO;IAEhC,OAAO,IAAI,CAACY,OAAO,CAAC;MAClBH,MAAM,EAAE,QAAQ;MAChBC,OAAO,EAAE,OAAO;MAChBC,QAAQ,qBAAcK,EAAE;IAC1B,CAAC,CAAC,CAAC3B,IAAI,CAAC,UAACwB,GAAG,EAAK;MACf;MACA;MACA,IAAIA,GAAG,CAACS,UAAU,KAAK,GAAG,EAAE;QAC1B,OAAOC,SAAS;MAClB;MAEA,OAAOV,GAAG,CAACC,IAAI;IACjB,CAAC,CAAC;EACJ,CAAC;EAED;AACF;AACA;AACA;AACA;AACA;AACA;EACEU,IAAI,gBAACjB,IAAI,EAAE;IAAA;IACT,OAAO,UAACV,KAAK;MAAA,OAAK,MAAI,CAAC4B,OAAO,CAAClB,IAAI,EAAEV,KAAK,CAAC;IAAA;EAC7C,CAAC;EAED;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACEC,eAAe,iCAAqB;IAAA,IAAZ4B,QAAQ,QAAfC,IAAI,CAAGD,QAAQ;IAC9B,IAAMnB,IAAI,GAAGhD,UAAU,CAACmE,QAAQ,CAACE,IAAI,CAAC;IAEtC,IAAI,CAACrB,IAAI,EAAE;MACT;IACF;IAEA,IAAI,CAACsB,eAAe,CAACH,QAAQ,EAAEnB,IAAI,CAAC,CAAClB,IAAI,CAAC,IAAI,CAACmC,IAAI,CAACjB,IAAI,CAAC,CAAC;EAC5D,CAAC;EAED;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACEsB,eAAe,2BAACH,QAAQ,EAAEnB,IAAI,EAAE;IAC9B,IACES,EAAE,GAIAU,QAAQ,CAJVV,EAAE;MAAA,kBAIAU,QAAQ,CAHVI,KAAK;MAAcC,OAAO,mBAAlBC,SAAS;MAAWC,YAAY,mBAAZA,YAAY;MAC3BC,QAAQ,GAEnBR,QAAQ,CAFVS,MAAM,CAAGnB,EAAE;MAAA,mBAETU,QAAQ,CADVU,MAAM;MAAOC,MAAM,oBAAVrB,EAAE;MAAesB,OAAO,oBAAZC,GAAG;MAAiBpE,QAAQ,oBAAdqE,IAAI;IAGzC,IAAMC,OAAO,GAAG,IAAAC,6BAAqB,EAAC,IAAI,CAACxD,KAAK,EAAEoD,OAAO,CAAC;IAC1D,IAAMK,aAAa,GAAG,yBAAU,IAAI,CAACpD,aAAa,CAAC;IAEnDoD,aAAa,CAAC9C,KAAK,GAAGU,IAAI;IAC1B,IAAIA,IAAI,KAAK/C,iBAAS,CAACI,QAAQ,CAACC,UAAU,CAACI,OAAO,EAAE;MAClD;MACA;MACA,IAAM2E,QAAQ,GAAG,IAAAC,0BAAkB,EAACd,OAAO,EAAEU,OAAO,CAAC;MAErD,OAAO,iBAAQK,OAAO,iCACjBH,aAAa;QAChBZ,OAAO,EAAEa,QAAQ;QACjBjB,IAAI,EAAE;UACJX,EAAE,EAAE,IAAA+B,2BAAmB,EAACb,QAAQ,EAAEO,OAAO,CAAC;UAC1CO,WAAW,EAAEf,YAAY,IAAIF,OAAO;UACpCa,QAAQ,EAARA,QAAQ;UACRP,MAAM,EAAE,IAAAY,wBAAgB,EAACZ,MAAM,EAAEI,OAAO,CAAC;UACzCS,QAAQ,EAAEhF,WAAW,CAACC,QAAQ;QAChC;MAAC,GACD;IACJ;IAEA,OAAO,IAAI,CAAC4C,GAAG,CAAC,IAAAgC,2BAAmB,EAAC/B,EAAE,EAAEyB,OAAO,CAAC,CAAC,CAACpD,IAAI,CAAC,UAACsC,IAAI;MAAA,uCACvDgB,aAAa;QAChBZ,OAAO,EAAEJ,IAAI,CAACiB,QAAQ;QACtBjB,IAAI,EAAJA;MAAI;IAAA,CACJ,CAAC;EACL,CAAC;EAAA;AACH,CAAC,CAAC;AAAC,eAEYjD,QAAQ;AAAA"}

package/dist/plugin-messages.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Messages are how people communicate in rooms. Each message timestamped and
+ * represented in Webex as a distinct block of content. Messages can contain
+ * plain text and a single file attachment. See the
+ * {@link https://developer.webex.com/docs/api/basics#message-attachments|Message Attachments} Guide
+ * for a list of supported media types.
+ * @class
+ */
+declare const Messages: any;
+export default Messages;
+
+export { }

package/dist/tsdoc-metadata.json

@@ -0,0 +1,11 @@
+// This file is read by tools that parse documentation comments conforming to the TSDoc standard.
+// It should be published with your NPM package.  It should not be tracked by Git.
+{
+  "tsdocVersion": "0.12",
+  "toolPackages": [
+    {
+      "packageName": "@microsoft/api-extractor",
+      "packageVersion": "7.34.4"
+    }
+  ]
+}

package/dist/types/index.d.ts

@@ -0,0 +1,2 @@
+export default Messages;
+import Messages from "./messages";

package/dist/types/messages.d.ts

@@ -0,0 +1,58 @@
+export default Messages;
+export type MessageObject = {
+    /**
+     * - (server generated) Unique identifier for the message
+     */
+    id: string;
+    /**
+     * - The ID for the author of the message
+     */
+    personId: string;
+    /**
+     * - The email for the author of the message
+     */
+    personEmail: email;
+    /**
+     * - The ID for the room of the message
+     */
+    roomId: string;
+    /**
+     * - The message posted to the room in plain text
+     */
+    text: string;
+    /**
+     * - The message posted to the room in markdown
+     */
+    markdown: string;
+    /**
+     * - The source URL(s) for the message attachment(s).
+     * See the {@link https://developer.webex.com/docs/api/basics#message-attachments|Message Attachments}Guide for a list of supported media types.
+     */
+    files: Array<string>;
+    /**
+     * - (server generated) The date and time that the message was created
+     */
+    created: isoDate;
+};
+/**
+ * @typedef {Object} MessageObject
+ * @property {string} id - (server generated) Unique identifier for the message
+ * @property {string} personId - The ID for the author of the message
+ * @property {email} personEmail - The email for the author of the message
+ * @property {string} roomId - The ID for the room of the message
+ * @property {string} text - The message posted to the room in plain text
+ * @property {string} markdown - The message posted to the room in markdown
+ * @property {Array<string>} files - The source URL(s) for the message attachment(s).
+ * See the {@link https://developer.webex.com/docs/api/basics#message-attachments|Message Attachments}
+ * Guide for a list of supported media types.
+ * @property {isoDate} created - (server generated) The date and time that the message was created
+ */
+/**
+ * Messages are how people communicate in rooms. Each message timestamped and
+ * represented in Webex as a distinct block of content. Messages can contain
+ * plain text and a single file attachment. See the
+ * {@link https://developer.webex.com/docs/api/basics#message-attachments|Message Attachments} Guide
+ * for a list of supported media types.
+ * @class
+ */
+declare const Messages: any;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webex/plugin-messages",
-  "version": "3.0.0-beta.8",
+  "version": "3.0.0-bnr.0",
   "description": "",
   "license": "MIT",
   "main": "dist/index.js",
@@ -20,22 +20,22 @@
     ]
   },
   "devDependencies": {
-    "@webex/test-helper-chai": "3.0.0-beta.8",
-    "@webex/test-helper-file": "3.0.0-beta.8",
-    "@webex/test-helper-mocha": "3.0.0-beta.8",
-    "@webex/test-helper-test-users": "3.0.0-beta.8",
+    "@webex/test-helper-chai": "3.0.0-bnr.0",
+    "@webex/test-helper-file": "3.0.0-bnr.0",
+    "@webex/test-helper-mocha": "3.0.0-bnr.0",
+    "@webex/test-helper-test-users": "3.0.0-bnr.0",
     "sinon": "^9.2.4"
   },
   "dependencies": {
-    "@webex/common": "3.0.0-beta.8",
-    "@webex/internal-plugin-conversation": "3.0.0-beta.8",
-    "@webex/internal-plugin-device": "3.0.0-beta.8",
-    "@webex/internal-plugin-mercury": "3.0.0-beta.8",
-    "@webex/plugin-logger": "3.0.0-beta.8",
-    "@webex/plugin-messages": "3.0.0-beta.8",
-    "@webex/plugin-people": "3.0.0-beta.8",
-    "@webex/plugin-rooms": "3.0.0-beta.8",
-    "@webex/webex-core": "3.0.0-beta.8",
+    "@webex/common": "3.0.0-bnr.0",
+    "@webex/internal-plugin-conversation": "3.0.0-bnr.0",
+    "@webex/internal-plugin-device": "3.0.0-bnr.0",
+    "@webex/internal-plugin-mercury": "3.0.0-bnr.0",
+    "@webex/plugin-logger": "3.0.0-bnr.0",
+    "@webex/plugin-messages": "3.0.0-bnr.0",
+    "@webex/plugin-people": "3.0.0-bnr.0",
+    "@webex/plugin-rooms": "3.0.0-bnr.0",
+    "@webex/webex-core": "3.0.0-bnr.0",
     "debug": "^4.3.4",
     "lodash": "^4.17.21"
   }