@webex/internal-plugin-team 2.59.1 → 2.59.3-next.1

package/src/team.js

@@ -1,437 +1,437 @@
-/*!
- * Copyright (c) 2015-2020 Cisco Systems, Inc. See LICENSE file.
- */
-
-import querystring from 'querystring';
-
-import uuid from 'uuid';
-import {find, pick, uniq} from 'lodash';
-import {WebexPlugin} from '@webex/webex-core';
-
-const Team = WebexPlugin.extend({
-  namespace: 'Team',
-
-  /**
-   * Move an existing group conversation into a team.
-   * @param {TeamObject} team
-   * @param {ConversationObject} conversation
-   * @param {Object} activity Reference to the activity that will eventually be
-   * posted. Use this to (a) pass in e.g. clientTempId and (b) render a
-   * provisional activity
-   * @returns {Promise} Resolves with the add activity
-   */
-  addConversation(team, conversation, activity) {
-    return this._ensureGeneralConversation(team)
-      .then((generalConversation) =>
-        this.webex.internal.conversation.prepare(activity, {
-          verb: 'add',
-          target: this.webex.internal.conversation.prepareConversation(generalConversation),
-          object: {
-            id: conversation.id,
-            objectType: 'conversation',
-          },
-          kmsMessage: {
-            method: 'create',
-            uri: '/authorizations',
-            resourceUri: conversation.kmsResourceObjectUrl,
-            userIds: [generalConversation.kmsResourceObjectUrl],
-          },
-        })
-      )
-      .then((a) => this.webex.internal.conversation.submit(a));
-  },
-
-  /**
-   * Add a member to a team
-   * @param {TeamObject} team
-   * @param {Object} participant
-   * @param {Object} activity Reference to the activity that will eventually be
-   * posted. Use this to (a) pass in e.g. clientTempId and (b) render a
-   * provisional activity
-   * @returns {Promise} Resolves with activity that was posted
-   */
-  addMember(team, participant, activity) {
-    return this._ensureGeneralConversation(team).then((generalConversation) =>
-      this.webex.internal.conversation.add(generalConversation, participant, activity)
-    );
-  },
-
-  /**
-   * Create a team
-   * @param {NewTeamObject} params
-   * @param {string} params.displayName
-   * @param {string} params.summary
-   * @param {Array} params.participants
-   * @returns {Promise} Resolves with the created team
-   */
-  create(params) {
-    if (!params.displayName) {
-      return Promise.reject(new Error('`params.displayName` is required'));
-    }
-
-    if (!params.participants || params.participants.length === 0) {
-      return Promise.reject(new Error('`params.participants` is required'));
-    }
-
-    return Promise.all(
-      params.participants.map((participant) =>
-        this.webex.internal.user.asUUID(participant, {create: true})
-      )
-    )
-      .then((participants) => {
-        participants.unshift(this.webex.internal.device.userId);
-        params.participants = uniq(participants);
-      })
-      .then(() => this._prepareTeam(params))
-      .then((payload) =>
-        this.webex.request({
-          method: 'POST',
-          service: 'conversation',
-          resource: 'teams',
-          body: payload,
-        })
-      )
-      .then((res) => res.body);
-  },
-
-  /**
-   * Create a conversation within a team. Currently does not support
-   * activities besides add (ie no post or share activities).
-   * @param {TeamObject} team
-   * @param {NewConversationObject} params
-   * @param {string} params.displayName
-   * @param {string} params.summary
-   * @param {Array} params.participants
-   * @param {Object} options
-   * @param {boolean} options.includeAllTeamMembers
-   * @returns {Promise} Resolves with the newly created conversation
-   */
-  createConversation(team, params, options = {}) {
-    if (!team.url) {
-      return Promise.reject(new Error('`team.url` is required'));
-    }
-
-    if (!params.displayName) {
-      return Promise.reject(new Error('`params.displayName` is required'));
-    }
-
-    return this._ensureGeneralConversation(team)
-      .then((generalConversation) =>
-        Promise.all(
-          params.participants.map((participant) =>
-            this.webex.internal.user.asUUID(participant, {create: true})
-          )
-        )
-          .then((participants) => {
-            participants.unshift(this.webex.internal.device.userId);
-            params.participants = uniq(participants);
-          })
-          .then(() => this._prepareTeamConversation(generalConversation, params))
-      )
-      .then((payload) =>
-        this.webex.request({
-          method: 'POST',
-          uri: `${team.url}/conversations`,
-          qs: pick(options, 'includeAllTeamMembers'),
-          body: payload,
-        })
-      )
-      .then((res) => res.body);
-  },
-
-  /**
-   * Retrieve a single team
-   * @param {Object|Team~TeamObject} team
-   * @param {string} team.url
-   * @param {Object} options
-   * @param {boolean} options.includeTeamConversations
-   * @param {boolean} options.includeTeamMembers
-   * @returns {Promise} Resolves with the requested team
-   */
-  get({url}, options = {}) {
-    if (!url) {
-      return Promise.reject(new Error('`team.url` is required'));
-    }
-    const params = {
-      includeTeamConversations: false,
-      includeTeamMembers: false,
-      ...options,
-    };
-
-    return this.webex
-      .request({
-        uri: url,
-        qs: params,
-      })
-      .then((res) => this._recordUUIDs(res.body).then(() => res.body));
-  },
-
-  /**
-   * Get the list of conversations for a particular team
-   * @param {TeamObject} team
-   * @param {String} team.url
-   * @returns {Promise} Resolves with an array of conversations
-   */
-  listConversations({url}) {
-    if (!url) {
-      return Promise.reject(new Error('`team.url` is required'));
-    }
-
-    return this.webex
-      .request({
-        uri: `${url}/conversations`,
-      })
-      .then((res) => res.body.items);
-  },
-
-  /**
-   * Join a team conversation
-   * @param {TeamObject} team
-   * @param {ConversationObject} conversation
-   * @param {userId} userId
-   * @returns {Promise} Resolves with the conversation
-   */
-  joinConversation(team, conversation, userId) {
-    if (!userId) {
-      return Promise.reject(new Error('`userId` is required'));
-    }
-
-    const body = {
-      kmsMessage: {
-        client: {
-          clientId: this.webex.internal.device.url,
-          credential: {
-            bearer: this.webex.credentials.supertoken.access_token,
-            userId,
-          },
-        },
-        method: 'create',
-        requestId: uuid.v4(),
-        resourceUri: conversation.kmsResourceObjectUrl,
-        uri: '/authorizations',
-        userIds: [userId],
-      },
-    };
-
-    return this.webex
-      .request({
-        method: 'POST',
-        uri: `${team.url}/conversations/${conversation.id}/participants`,
-        body,
-      })
-      .then((res) => res.body);
-  },
-
-  /**
-   * Retrieve all teams
-   * @param {Object} options
-   * @param {boolean} options.includeTeamConversations
-   * @param {boolean} options.includeTeamMembers
-   * @returns {Promise} Resolves with the requested teams
-   */
-  async list(options = {}) {
-    const params = {
-      includeTeamConversations: false,
-      includeTeamMembers: false,
-      ...options,
-    };
-    const resource = 'teams';
-
-    const res = await this.webex.request({
-      api: 'conversation',
-      resource,
-      qs: params,
-    });
-
-    let list = res.body.items.slice(0);
-
-    if (res.body.additionalUrls) {
-      const results = await Promise.all(
-        res.body.additionalUrls.map((host) => {
-          const uri = `${host}/${resource}`;
-
-          return this.webex.request({
-            uri,
-            qs: params,
-          });
-        })
-      );
-
-      for (const result of results) {
-        if (result.body && result.body.items && result.body.items.length) {
-          list = list.concat(result.body.items);
-        }
-      }
-    }
-
-    await Promise.all(res.body.items.map((team) => this._recordUUIDs(team)));
-
-    return list;
-  },
-
-  /**
-   * Remove a member from a team
-   * @param {TeamObject} team
-   * @param {Object} participant
-   * @param {Object} activity Reference to the activity that will eventually be
-   * posted. Use this to (a) pass in e.g. clientTempId and (b) render a
-   * provisional activity
-   * @returns {Promise} Resolves with activity that was posted
-   */
-  removeMember(team, participant, activity) {
-    return this._ensureGeneralConversation(team).then((generalConversation) =>
-      this.webex.internal.conversation.leave(generalConversation, participant, activity)
-    );
-  },
-
-  /**
-   * Remove a team conversation from a team.
-   * @param {TeamObject} team
-   * @param {ConversationObject} conversation to be removed
-   * @param {Object} activity Reference to the activity that will eventually be
-   * posted. Use this to (a) pass in e.g. clientTempId and (b) render a
-   * provisional activity
-   * @returns {Promise} Resolves with the leave activity
-   */
-  removeConversation(team, conversation, activity) {
-    return this._ensureGeneralConversation(team)
-      .then((generalConversation) => {
-        const properties = {
-          verb: 'remove',
-          object: pick(conversation, 'id', 'url', 'objectType'),
-          target: pick(generalConversation, 'id', 'url', 'objectType'),
-          kmsMessage: {
-            method: 'delete',
-            uri: `<KRO>/authorizations?${querystring.stringify({authId: conversation.id})}`,
-          },
-        };
-
-        return this.webex.internal.conversation.prepare(activity, properties);
-      })
-      .then((a) => this.webex.internal.conversation.submit(a));
-  },
-
-  /**
-   * Update the displayName, summary, or teamColor field for a team.
-   * @param {TeamObject} team to be updated
-   * @param {Object} object with updated displayName, summary, and/or teamColor
-   * @param {Object} activity Reference to the activity that will eventually be
-   * posted. Use this to (a) pass in e.g. clientTempId and (b) render a
-   * provisional activity
-   * @returns {Promise} Resolves with posted activity
-   */
-  update(team, object, activity) {
-    return this.webex.internal.conversation.update(team, object, activity);
-  },
-
-  /* eslint-disable require-jsdoc */
-  _ensureGeneralConversation(team) {
-    if (!team.generalConversationUuid) {
-      return Promise.reject(new Error('`team.generalConversationUuid` must be present'));
-    }
-
-    if (team.conversations.items.length) {
-      const generalConversation = find(team.conversations.items, {
-        id: team.generalConversationUuid,
-      });
-
-      if (generalConversation) {
-        return Promise.resolve(generalConversation);
-      }
-    }
-
-    return this.webex.internal.conversation.get({id: team.generalConversationUuid});
-  },
-
-  _prepareTeam: function _prepareTeam(params) {
-    const payload = this.webex.internal.conversation._prepareConversationForCreation(params);
-
-    payload.objectType = 'team';
-
-    if (params.summary) {
-      payload.summary = params.summary;
-    }
-
-    return Promise.resolve(payload);
-  },
-
-  _prepareTeamConversation(teamConversation, params) {
-    if (!teamConversation.kmsResourceObjectUrl) {
-      return Promise.reject(new Error('Team general conversation must have a KRO'));
-    }
-
-    const payload = this.webex.internal.conversation._prepareConversationForCreation(params);
-
-    // Push the general conversation KRO on so that team members can
-    // decrypt the title of this open room without joining it.
-    payload.kmsMessage.userIds.push(teamConversation.kmsResourceObjectUrl);
-
-    return Promise.resolve(payload);
-  },
-
-  _recordUUIDs(team) {
-    if (!team.teamMembers || !team.teamMembers.items) {
-      return Promise.resolve(team);
-    }
-
-    return Promise.all(
-      team.teamMembers.items.map((participant) => {
-        // ROOMs or LYRA_SPACEs do not have email addresses, so there's no point attempting to
-        // record their UUIDs.
-        if (participant.type === 'ROOM' || participant.type === 'LYRA_SPACE') {
-          return Promise.resolve();
-        }
-
-        return this.webex.internal.user
-          .recordUUID(participant)
-          .catch((err) => this.logger.warn('Could not record uuid', err));
-      })
-    );
-  },
-  /* eslint-enable require-jsdoc */
-});
-
-/**
- * Assign or unassign a team member to be a moderator of a team
- * @param {TeamObject} team
- * @param {Object} participant
- * @param {Object} activity
- * @returns {Promise} Resolves with activity that was posted
- */
-['assignModerator', 'unassignModerator'].forEach((verb) => {
-  Team.prototype[verb] = function submitModerationChangeActivity(team, member, activity) {
-    return this._ensureGeneralConversation(team).then((teamConversation) =>
-      this.webex.internal.conversation[verb](teamConversation, member, activity)
-    );
-  };
-});
-
-/**
- * Archive or unarchive a team or team conversation.
- * @param {TeamObject|ConversationObject} target team or team conversation that should be archived
- * @param {Object} activity Reference to the activity that will eventually be
- * posted. Use this to (a) pass in e.g. clientTempId and (b) render a
- * provisional activity
- * @returns {Promise} Resolves with the posted activity
- */
-['archive', 'unarchive'].forEach((verb) => {
-  Team.prototype[verb] = function submitArchiveStateChangeActivity(target, activity) {
-    if (!target.objectType) {
-      return Promise.reject(new Error('`target.objectType` is required'));
-    }
-
-    const properties = {
-      verb,
-      object: pick(target, 'id', 'url', 'objectType'),
-      target: pick(target, 'id', 'url', 'objectType'),
-    };
-
-    const teamUrl = this.webex.internal.conversation.getConvoUrl(target);
-
-    return this.webex.internal.conversation
-      .prepare(activity, properties)
-      .then((a) => this.webex.internal.conversation.submit(a, teamUrl));
-  };
-});
-
-export default Team;
+/*!
+ * Copyright (c) 2015-2020 Cisco Systems, Inc. See LICENSE file.
+ */
+
+import querystring from 'querystring';
+
+import uuid from 'uuid';
+import {find, pick, uniq} from 'lodash';
+import {WebexPlugin} from '@webex/webex-core';
+
+const Team = WebexPlugin.extend({
+  namespace: 'Team',
+
+  /**
+   * Move an existing group conversation into a team.
+   * @param {TeamObject} team
+   * @param {ConversationObject} conversation
+   * @param {Object} activity Reference to the activity that will eventually be
+   * posted. Use this to (a) pass in e.g. clientTempId and (b) render a
+   * provisional activity
+   * @returns {Promise} Resolves with the add activity
+   */
+  addConversation(team, conversation, activity) {
+    return this._ensureGeneralConversation(team)
+      .then((generalConversation) =>
+        this.webex.internal.conversation.prepare(activity, {
+          verb: 'add',
+          target: this.webex.internal.conversation.prepareConversation(generalConversation),
+          object: {
+            id: conversation.id,
+            objectType: 'conversation',
+          },
+          kmsMessage: {
+            method: 'create',
+            uri: '/authorizations',
+            resourceUri: conversation.kmsResourceObjectUrl,
+            userIds: [generalConversation.kmsResourceObjectUrl],
+          },
+        })
+      )
+      .then((a) => this.webex.internal.conversation.submit(a));
+  },
+
+  /**
+   * Add a member to a team
+   * @param {TeamObject} team
+   * @param {Object} participant
+   * @param {Object} activity Reference to the activity that will eventually be
+   * posted. Use this to (a) pass in e.g. clientTempId and (b) render a
+   * provisional activity
+   * @returns {Promise} Resolves with activity that was posted
+   */
+  addMember(team, participant, activity) {
+    return this._ensureGeneralConversation(team).then((generalConversation) =>
+      this.webex.internal.conversation.add(generalConversation, participant, activity)
+    );
+  },
+
+  /**
+   * Create a team
+   * @param {NewTeamObject} params
+   * @param {string} params.displayName
+   * @param {string} params.summary
+   * @param {Array} params.participants
+   * @returns {Promise} Resolves with the created team
+   */
+  create(params) {
+    if (!params.displayName) {
+      return Promise.reject(new Error('`params.displayName` is required'));
+    }
+
+    if (!params.participants || params.participants.length === 0) {
+      return Promise.reject(new Error('`params.participants` is required'));
+    }
+
+    return Promise.all(
+      params.participants.map((participant) =>
+        this.webex.internal.user.asUUID(participant, {create: true})
+      )
+    )
+      .then((participants) => {
+        participants.unshift(this.webex.internal.device.userId);
+        params.participants = uniq(participants);
+      })
+      .then(() => this._prepareTeam(params))
+      .then((payload) =>
+        this.webex.request({
+          method: 'POST',
+          service: 'conversation',
+          resource: 'teams',
+          body: payload,
+        })
+      )
+      .then((res) => res.body);
+  },
+
+  /**
+   * Create a conversation within a team. Currently does not support
+   * activities besides add (ie no post or share activities).
+   * @param {TeamObject} team
+   * @param {NewConversationObject} params
+   * @param {string} params.displayName
+   * @param {string} params.summary
+   * @param {Array} params.participants
+   * @param {Object} options
+   * @param {boolean} options.includeAllTeamMembers
+   * @returns {Promise} Resolves with the newly created conversation
+   */
+  createConversation(team, params, options = {}) {
+    if (!team.url) {
+      return Promise.reject(new Error('`team.url` is required'));
+    }
+
+    if (!params.displayName) {
+      return Promise.reject(new Error('`params.displayName` is required'));
+    }
+
+    return this._ensureGeneralConversation(team)
+      .then((generalConversation) =>
+        Promise.all(
+          params.participants.map((participant) =>
+            this.webex.internal.user.asUUID(participant, {create: true})
+          )
+        )
+          .then((participants) => {
+            participants.unshift(this.webex.internal.device.userId);
+            params.participants = uniq(participants);
+          })
+          .then(() => this._prepareTeamConversation(generalConversation, params))
+      )
+      .then((payload) =>
+        this.webex.request({
+          method: 'POST',
+          uri: `${team.url}/conversations`,
+          qs: pick(options, 'includeAllTeamMembers'),
+          body: payload,
+        })
+      )
+      .then((res) => res.body);
+  },
+
+  /**
+   * Retrieve a single team
+   * @param {Object|Team~TeamObject} team
+   * @param {string} team.url
+   * @param {Object} options
+   * @param {boolean} options.includeTeamConversations
+   * @param {boolean} options.includeTeamMembers
+   * @returns {Promise} Resolves with the requested team
+   */
+  get({url}, options = {}) {
+    if (!url) {
+      return Promise.reject(new Error('`team.url` is required'));
+    }
+    const params = {
+      includeTeamConversations: false,
+      includeTeamMembers: false,
+      ...options,
+    };
+
+    return this.webex
+      .request({
+        uri: url,
+        qs: params,
+      })
+      .then((res) => this._recordUUIDs(res.body).then(() => res.body));
+  },
+
+  /**
+   * Get the list of conversations for a particular team
+   * @param {TeamObject} team
+   * @param {String} team.url
+   * @returns {Promise} Resolves with an array of conversations
+   */
+  listConversations({url}) {
+    if (!url) {
+      return Promise.reject(new Error('`team.url` is required'));
+    }
+
+    return this.webex
+      .request({
+        uri: `${url}/conversations`,
+      })
+      .then((res) => res.body.items);
+  },
+
+  /**
+   * Join a team conversation
+   * @param {TeamObject} team
+   * @param {ConversationObject} conversation
+   * @param {userId} userId
+   * @returns {Promise} Resolves with the conversation
+   */
+  joinConversation(team, conversation, userId) {
+    if (!userId) {
+      return Promise.reject(new Error('`userId` is required'));
+    }
+
+    const body = {
+      kmsMessage: {
+        client: {
+          clientId: this.webex.internal.device.url,
+          credential: {
+            bearer: this.webex.credentials.supertoken.access_token,
+            userId,
+          },
+        },
+        method: 'create',
+        requestId: uuid.v4(),
+        resourceUri: conversation.kmsResourceObjectUrl,
+        uri: '/authorizations',
+        userIds: [userId],
+      },
+    };
+
+    return this.webex
+      .request({
+        method: 'POST',
+        uri: `${team.url}/conversations/${conversation.id}/participants`,
+        body,
+      })
+      .then((res) => res.body);
+  },
+
+  /**
+   * Retrieve all teams
+   * @param {Object} options
+   * @param {boolean} options.includeTeamConversations
+   * @param {boolean} options.includeTeamMembers
+   * @returns {Promise} Resolves with the requested teams
+   */
+  async list(options = {}) {
+    const params = {
+      includeTeamConversations: false,
+      includeTeamMembers: false,
+      ...options,
+    };
+    const resource = 'teams';
+
+    const res = await this.webex.request({
+      api: 'conversation',
+      resource,
+      qs: params,
+    });
+
+    let list = res.body.items.slice(0);
+
+    if (res.body.additionalUrls) {
+      const results = await Promise.all(
+        res.body.additionalUrls.map((host) => {
+          const uri = `${host}/${resource}`;
+
+          return this.webex.request({
+            uri,
+            qs: params,
+          });
+        })
+      );
+
+      for (const result of results) {
+        if (result.body && result.body.items && result.body.items.length) {
+          list = list.concat(result.body.items);
+        }
+      }
+    }
+
+    await Promise.all(res.body.items.map((team) => this._recordUUIDs(team)));
+
+    return list;
+  },
+
+  /**
+   * Remove a member from a team
+   * @param {TeamObject} team
+   * @param {Object} participant
+   * @param {Object} activity Reference to the activity that will eventually be
+   * posted. Use this to (a) pass in e.g. clientTempId and (b) render a
+   * provisional activity
+   * @returns {Promise} Resolves with activity that was posted
+   */
+  removeMember(team, participant, activity) {
+    return this._ensureGeneralConversation(team).then((generalConversation) =>
+      this.webex.internal.conversation.leave(generalConversation, participant, activity)
+    );
+  },
+
+  /**
+   * Remove a team conversation from a team.
+   * @param {TeamObject} team
+   * @param {ConversationObject} conversation to be removed
+   * @param {Object} activity Reference to the activity that will eventually be
+   * posted. Use this to (a) pass in e.g. clientTempId and (b) render a
+   * provisional activity
+   * @returns {Promise} Resolves with the leave activity
+   */
+  removeConversation(team, conversation, activity) {
+    return this._ensureGeneralConversation(team)
+      .then((generalConversation) => {
+        const properties = {
+          verb: 'remove',
+          object: pick(conversation, 'id', 'url', 'objectType'),
+          target: pick(generalConversation, 'id', 'url', 'objectType'),
+          kmsMessage: {
+            method: 'delete',
+            uri: `<KRO>/authorizations?${querystring.stringify({authId: conversation.id})}`,
+          },
+        };
+
+        return this.webex.internal.conversation.prepare(activity, properties);
+      })
+      .then((a) => this.webex.internal.conversation.submit(a));
+  },
+
+  /**
+   * Update the displayName, summary, or teamColor field for a team.
+   * @param {TeamObject} team to be updated
+   * @param {Object} object with updated displayName, summary, and/or teamColor
+   * @param {Object} activity Reference to the activity that will eventually be
+   * posted. Use this to (a) pass in e.g. clientTempId and (b) render a
+   * provisional activity
+   * @returns {Promise} Resolves with posted activity
+   */
+  update(team, object, activity) {
+    return this.webex.internal.conversation.update(team, object, activity);
+  },
+
+  /* eslint-disable require-jsdoc */
+  _ensureGeneralConversation(team) {
+    if (!team.generalConversationUuid) {
+      return Promise.reject(new Error('`team.generalConversationUuid` must be present'));
+    }
+
+    if (team.conversations.items.length) {
+      const generalConversation = find(team.conversations.items, {
+        id: team.generalConversationUuid,
+      });
+
+      if (generalConversation) {
+        return Promise.resolve(generalConversation);
+      }
+    }
+
+    return this.webex.internal.conversation.get({id: team.generalConversationUuid});
+  },
+
+  _prepareTeam: function _prepareTeam(params) {
+    const payload = this.webex.internal.conversation._prepareConversationForCreation(params);
+
+    payload.objectType = 'team';
+
+    if (params.summary) {
+      payload.summary = params.summary;
+    }
+
+    return Promise.resolve(payload);
+  },
+
+  _prepareTeamConversation(teamConversation, params) {
+    if (!teamConversation.kmsResourceObjectUrl) {
+      return Promise.reject(new Error('Team general conversation must have a KRO'));
+    }
+
+    const payload = this.webex.internal.conversation._prepareConversationForCreation(params);
+
+    // Push the general conversation KRO on so that team members can
+    // decrypt the title of this open room without joining it.
+    payload.kmsMessage.userIds.push(teamConversation.kmsResourceObjectUrl);
+
+    return Promise.resolve(payload);
+  },
+
+  _recordUUIDs(team) {
+    if (!team.teamMembers || !team.teamMembers.items) {
+      return Promise.resolve(team);
+    }
+
+    return Promise.all(
+      team.teamMembers.items.map((participant) => {
+        // ROOMs or LYRA_SPACEs do not have email addresses, so there's no point attempting to
+        // record their UUIDs.
+        if (participant.type === 'ROOM' || participant.type === 'LYRA_SPACE') {
+          return Promise.resolve();
+        }
+
+        return this.webex.internal.user
+          .recordUUID(participant)
+          .catch((err) => this.logger.warn('Could not record uuid', err));
+      })
+    );
+  },
+  /* eslint-enable require-jsdoc */
+});
+
+/**
+ * Assign or unassign a team member to be a moderator of a team
+ * @param {TeamObject} team
+ * @param {Object} participant
+ * @param {Object} activity
+ * @returns {Promise} Resolves with activity that was posted
+ */
+['assignModerator', 'unassignModerator'].forEach((verb) => {
+  Team.prototype[verb] = function submitModerationChangeActivity(team, member, activity) {
+    return this._ensureGeneralConversation(team).then((teamConversation) =>
+      this.webex.internal.conversation[verb](teamConversation, member, activity)
+    );
+  };
+});
+
+/**
+ * Archive or unarchive a team or team conversation.
+ * @param {TeamObject|ConversationObject} target team or team conversation that should be archived
+ * @param {Object} activity Reference to the activity that will eventually be
+ * posted. Use this to (a) pass in e.g. clientTempId and (b) render a
+ * provisional activity
+ * @returns {Promise} Resolves with the posted activity
+ */
+['archive', 'unarchive'].forEach((verb) => {
+  Team.prototype[verb] = function submitArchiveStateChangeActivity(target, activity) {
+    if (!target.objectType) {
+      return Promise.reject(new Error('`target.objectType` is required'));
+    }
+
+    const properties = {
+      verb,
+      object: pick(target, 'id', 'url', 'objectType'),
+      target: pick(target, 'id', 'url', 'objectType'),
+    };
+
+    const teamUrl = this.webex.internal.conversation.getConvoUrl(target);
+
+    return this.webex.internal.conversation
+      .prepare(activity, properties)
+      .then((a) => this.webex.internal.conversation.submit(a, teamUrl));
+  };
+});
+
+export default Team;