@webex/plugin-meetings 3.0.0-beta.13 → 3.0.0-beta.15

package/src/meeting/request.ts

@@ -23,9 +23,10 @@ import {
   PROVISIONAL_TYPE_DIAL_IN,
   PROVISIONAL_TYPE_DIAL_OUT,
   SEND_DTMF_ENDPOINT,
-  _SLIDES_
+  _SLIDES_,
 } from '../constants';
 import {Reaction} from '../reactions/reactions.type';
+import {SendReactionOptions, ToggleReactionsOptions} from './request.type';
 
 /**
  * @class MeetingRequest
@@ -35,7 +36,10 @@ export default class MeetingRequest extends StatelessWebexPlugin {
 
   constructor(attrs: any, options: any) {
     super(attrs, options);
-    this.changeVideoLayoutDebounced = debounce(this.changeVideoLayout, 2000, {leading: true, trailing: true});
+    this.changeVideoLayoutDebounced = debounce(this.changeVideoLayout, 2000, {
+      leading: true,
+      trailing: true,
+    });
   }
 
   /**
@@ -84,13 +88,10 @@ export default class MeetingRequest extends StatelessWebexPlugin {
       pin,
       moveToResource,
       roapMessage,
-      preferTranscoding
+      preferTranscoding,
     } = options;
 
-    LoggerProxy.logger.info(
-      'Meeting:request#joinMeeting --> Joining a meeting',
-      correlationId
-    );
+    LoggerProxy.logger.info('Meeting:request#joinMeeting --> Joining a meeting', correlationId);
 
     let url = '';
 
@@ -99,18 +100,18 @@ export default class MeetingRequest extends StatelessWebexPlugin {
       device: {
         url: deviceUrl,
         // @ts-ignore - config comes from registerPlugin
-        deviceType: this.config.meetings.deviceType
+        deviceType: this.config.meetings.deviceType,
       },
       usingResource: resourceId || null,
-      moveMediaToResource: resourceId && moveToResource || false,
+      moveMediaToResource: (resourceId && moveToResource) || false,
       correlationId,
       respOnlySdp: true,
       allowMultiDevice: true,
       ensureConversation: ensureConversation || false,
       supportsNativeLobby: 1,
       clientMediaPreferences: {
-        preferTranscoding: preferTranscoding ?? true
-      }
+        preferTranscoding: preferTranscoding ?? true,
+      },
     };
 
     // @ts-ignore
@@ -135,30 +136,29 @@ export default class MeetingRequest extends StatelessWebexPlugin {
 
     if (locusUrl) {
       url = `${locusUrl}/${PARTICIPANT}`;
-    }
-    else if (inviteeAddress || meetingNumber) {
+    } else if (inviteeAddress || meetingNumber) {
       try {
         // @ts-ignore
         await this.webex.internal.services.waitForCatalog('postauth');
         // @ts-ignore
         url = `${this.webex.internal.services.get('locus')}/${LOCI}/${CALL}`;
         body.invitee = {
-          address: inviteeAddress || `wbxmn:${meetingNumber}`
+          address: inviteeAddress || `wbxmn:${meetingNumber}`,
         };
-      }
-      catch (e) {
-        LoggerProxy.logger.error(`Meeting:request#joinMeeting Error Joining ${inviteeAddress || meetingNumber} --> ${e}`);
-        throw (e);
+      } catch (e) {
+        LoggerProxy.logger.error(
+          `Meeting:request#joinMeeting Error Joining ${inviteeAddress || meetingNumber} --> ${e}`
+        );
+        throw e;
       }
     }
 
-
     // TODO: -- this will be resolved in SDK request
     url = url.concat(`?${ALTERNATE_REDIRECT_TRUE}`);
 
     if (resourceId === inviteeAddress) {
       body.callPreferences = {
-        requestedMedia: [_SLIDES_]
+        requestedMedia: [_SLIDES_],
       };
     }
 
@@ -170,7 +170,7 @@ export default class MeetingRequest extends StatelessWebexPlugin {
     return this.request({
       method: HTTP_VERBS.POST,
       uri: url,
-      body
+      body,
     });
   }
 
@@ -182,16 +182,22 @@ export default class MeetingRequest extends StatelessWebexPlugin {
    * @returns {Promise}
    * @private
    */
-  private refreshCaptcha({ captchaRefreshUrl, captchaId }: { captchaRefreshUrl: string; captchaId: string }) {
+  private refreshCaptcha({
+    captchaRefreshUrl,
+    captchaId,
+  }: {
+    captchaRefreshUrl: string;
+    captchaId: string;
+  }) {
     const body = {
-      captchaId
+      captchaId,
     };
 
     // @ts-ignore
     return this.request({
       method: HTTP_VERBS.POST,
       uri: captchaRefreshUrl,
-      body
+      body,
     }).catch((err) => {
       LoggerProxy.logger.error(`Meeting:request#refreshCaptcha --> Error: ${err}`);
 
@@ -231,18 +237,20 @@ export default class MeetingRequest extends StatelessWebexPlugin {
         deviceType: deviceType.PROVISIONAL,
         provisionalType: PROVISIONAL_TYPE_DIAL_IN,
         url: dialInUrl,
-        clientUrl
+        clientUrl,
       },
-      correlationId
+      correlationId,
     };
 
     // @ts-ignore
     return this.request({
       method: HTTP_VERBS.POST,
       uri,
-      body
+      body,
     }).catch((err) => {
-      LoggerProxy.logger.error(`Meeting:request#dialIn --> Error provisioning a dial in device, error ${err}`);
+      LoggerProxy.logger.error(
+        `Meeting:request#dialIn --> Error provisioning a dial in device, error ${err}`
+      );
 
       throw err;
     });
@@ -284,18 +292,20 @@ export default class MeetingRequest extends StatelessWebexPlugin {
         provisionalType: PROVISIONAL_TYPE_DIAL_OUT,
         url: dialOutUrl,
         dialoutAddress: phoneNumber,
-        clientUrl
+        clientUrl,
       },
-      correlationId
+      correlationId,
     };
 
     // @ts-ignore
     return this.request({
       method: HTTP_VERBS.POST,
       uri,
-      body
+      body,
     }).catch((err) => {
-      LoggerProxy.logger.error(`Meeting:request#dialOut --> Error provisioning a dial out device, error ${err}`);
+      LoggerProxy.logger.error(
+        `Meeting:request#dialOut --> Error provisioning a dial out device, error ${err}`
+      );
 
       throw err;
     });
@@ -308,7 +318,7 @@ export default class MeetingRequest extends StatelessWebexPlugin {
    * @param {String} options.syncUrl sync url to get ht elatest locus delta
    * @returns {Promise}
    */
-  syncMeeting(options: { desync: boolean; syncUrl: string }) {
+  syncMeeting(options: {desync: boolean; syncUrl: string}) {
     /* eslint-disable no-else-return */
     const {desync} = options;
     let {syncUrl} = options;
@@ -316,16 +326,20 @@ export default class MeetingRequest extends StatelessWebexPlugin {
     /* istanbul ignore else */
     if (desync) {
       // check for existing URL parameters
-      syncUrl = syncUrl.concat(syncUrl.split('?')[1] ? '&' : '?').concat(`${LOCUS.SYNCDEBUG}=${desync}`);
+      syncUrl = syncUrl
+        .concat(syncUrl.split('?')[1] ? '&' : '?')
+        .concat(`${LOCUS.SYNCDEBUG}=${desync}`);
     }
 
     // @ts-ignore
     return this.request({
       method: HTTP_VERBS.GET,
-      uri: syncUrl
+      uri: syncUrl,
     }) // TODO: Handle if delta sync failed . Get the full locus object
       .catch((err) => {
-        LoggerProxy.logger.error(`Meeting:request#syncMeeting --> Error syncing meeting, error ${err}`);
+        LoggerProxy.logger.error(
+          `Meeting:request#syncMeeting --> Error syncing meeting, error ${err}`
+        );
 
         return err;
       });
@@ -338,7 +352,7 @@ export default class MeetingRequest extends StatelessWebexPlugin {
    * @param {String} options.locusUrl sync url to get ht elatest locus delta
    * @returns {Promise}
    */
-  getFullLocus(options: { desync: boolean; locusUrl: string }) {
+  getFullLocus(options: {desync: boolean; locusUrl: string}) {
     let {locusUrl} = options;
     const {desync} = options;
 
@@ -350,9 +364,11 @@ export default class MeetingRequest extends StatelessWebexPlugin {
       // @ts-ignore
       return this.request({
         method: HTTP_VERBS.GET,
-        uri: locusUrl
+        uri: locusUrl,
       }).catch((err) => {
-        LoggerProxy.logger.error(`Meeting:request#getFullLocus --> Error getting full locus, error ${err}`);
+        LoggerProxy.logger.error(
+          `Meeting:request#getFullLocus --> Error getting full locus, error ${err}`
+        );
 
         return err;
       });
@@ -391,16 +407,16 @@ export default class MeetingRequest extends StatelessWebexPlugin {
     const body = {
       device: {
         deviceType: deviceType.PROVISIONAL,
-        url: phoneUrl
+        url: phoneUrl,
       },
-      correlationId
+      correlationId,
     };
 
     // @ts-ignore
     return this.request({
       method: HTTP_VERBS.PUT,
       uri,
-      body
+      body,
     }).catch((err) => {
       LoggerProxy.logger.error(
         `Meeting:request#disconnectPhoneAudio --> Error when requesting phone ${phoneUrl} to leave, error ${err}`
@@ -433,27 +449,24 @@ export default class MeetingRequest extends StatelessWebexPlugin {
     resourceId: string;
     correlationId: string;
   }) {
-    LoggerProxy.logger.info(
-      'Meeting:request#leaveMeeting --> Leaving a meeting',
-      correlationId
-    );
+    LoggerProxy.logger.info('Meeting:request#leaveMeeting --> Leaving a meeting', correlationId);
 
     const uri = `${locusUrl}/${PARTICIPANT}/${selfId}/${LEAVE}`;
     const body = {
       device: {
         // @ts-ignore
         deviceType: this.config.meetings.deviceType,
-        url
+        url,
       },
       usingResource: resourceId || null,
-      correlationId
+      correlationId,
     };
 
     // @ts-ignore
     return this.request({
       method: HTTP_VERBS.PUT,
       uri,
-      body
+      body,
     });
   }
 
@@ -465,22 +478,22 @@ export default class MeetingRequest extends StatelessWebexPlugin {
    * @param {String} options.correlationId
    * @returns {Promise}
    */
-  acknowledgeMeeting(options: { locusUrl: string; deviceUrl: string; correlationId: string }) {
+  acknowledgeMeeting(options: {locusUrl: string; deviceUrl: string; correlationId: string}) {
     const uri = `${options.locusUrl}/${PARTICIPANT}/${ALERT}`;
     const body = {
       device: {
         // @ts-ignore
         deviceType: this.config.meetings.deviceType,
-        url: options.deviceUrl
+        url: options.deviceUrl,
       },
-      correlationId: options.correlationId
+      correlationId: options.correlationId,
     };
 
     // @ts-ignore
     return this.request({
       method: HTTP_VERBS.PUT,
       uri,
-      body
+      body,
     });
   }
 
@@ -492,20 +505,26 @@ export default class MeetingRequest extends StatelessWebexPlugin {
    * @param {String} options.id
    * @returns {Promise}
    */
-  recordMeeting(options: { locusUrl: string; deviceUrl: string; id: string, recording: any, paused: any }) {
+  recordMeeting(options: {
+    locusUrl: string;
+    deviceUrl: string;
+    id: string;
+    recording: any;
+    paused: any;
+  }) {
     const uri = `${options.locusUrl}/${CONTROLS}`;
     const body = {
       record: {
         recording: options.recording,
-        paused: options.paused
-      }
+        paused: options.paused,
+      },
     };
 
     // @ts-ignore
     return this.request({
       method: HTTP_VERBS.PATCH,
       uri,
-      body
+      body,
     });
   }
 
@@ -513,15 +532,15 @@ export default class MeetingRequest extends StatelessWebexPlugin {
     const uri = `${options.locusUrl}/${CONTROLS}`;
     const body = {
       lock: {
-        locked: options.lock
-      }
+        locked: options.lock,
+      },
     };
 
     // @ts-ignore
     return this.request({
       method: HTTP_VERBS.PATCH,
       uri,
-      body
+      body,
     });
   }
 
@@ -533,13 +552,13 @@ export default class MeetingRequest extends StatelessWebexPlugin {
    * @param {String} options.reason
    * @returns {Promise}
    */
-  declineMeeting(options: { locusUrl: string; deviceUrl: string; reason: string }) {
+  declineMeeting(options: {locusUrl: string; deviceUrl: string; reason: string}) {
     const uri = `${options.locusUrl}/${PARTICIPANT}/${DECLINE}`;
     const body = {
       device: {
         // @ts-ignore
         deviceType: this.config.meetings.deviceType,
-        url: options.deviceUrl
+        url: options.deviceUrl,
       },
       ...(options.reason && {reason: options.reason}),
     };
@@ -548,7 +567,7 @@ export default class MeetingRequest extends StatelessWebexPlugin {
     return this.request({
       method: HTTP_VERBS.PUT,
       uri,
-      body
+      body,
     });
   }
 
@@ -563,34 +582,38 @@ export default class MeetingRequest extends StatelessWebexPlugin {
    * @param {Boolean} options.preferTranscoding false for multistream (Homer), true for transcoded media (Edonus)
    * @returns {Promise}
    */
-  remoteAudioVideoToggle(options: {
-    selfId: string;
-    locusUrl: string;
-    deviceUrl: string;
-    resourceId: string;
-    localMedias: string;
-  } | any) {
+  remoteAudioVideoToggle(
+    options:
+      | {
+          selfId: string;
+          locusUrl: string;
+          deviceUrl: string;
+          resourceId: string;
+          localMedias: string;
+        }
+      | any
+  ) {
     const uri = `${options.locusUrl}/${PARTICIPANT}/${options.selfId}/${MEDIA}`;
     const body = {
       device: {
         // @ts-ignore
         deviceType: this.config.meetings.deviceType,
-        url: options.deviceUrl
+        url: options.deviceUrl,
       },
       usingResource: options.resourceId || null,
       correlationId: options.correlationId,
       respOnlySdp: true,
       localMedias: options.localMedias,
       clientMediaPreferences: {
-        preferTranscoding: options.preferTranscoding ?? true
-      }
+        preferTranscoding: options.preferTranscoding ?? true,
+      },
     };
 
     // @ts-ignore
     return this.request({
       method: HTTP_VERBS.PUT,
       uri,
-      body
+      body,
     });
   }
 
@@ -604,13 +627,17 @@ export default class MeetingRequest extends StatelessWebexPlugin {
    * @param {String} options.uri floor grant uri
    * @returns {Promise}
    */
-  changeMeetingFloor(options: {
-    disposition: string;
-    personUrl: string;
-    deviceUrl: string;
-    resourceId: string;
-    uri: string;
-  } | any) {
+  changeMeetingFloor(
+    options:
+      | {
+          disposition: string;
+          personUrl: string;
+          deviceUrl: string;
+          resourceId: string;
+          uri: string;
+        }
+      | any
+  ) {
     let floorReq: any = {disposition: options.disposition};
 
     /* istanbul ignore else */
@@ -622,20 +649,20 @@ export default class MeetingRequest extends StatelessWebexPlugin {
             {
               // @ts-ignore
               deviceType: this.config.meetings.deviceType,
-              url: options.deviceUrl
-            }
-          ]
+              url: options.deviceUrl,
+            },
+          ],
         },
         disposition: options.disposition,
         requester: {
-          url: options.personUrl
-        }
+          url: options.personUrl,
+        },
       };
     }
 
     const body: any = {
       floor: floorReq,
-      resourceUrl: options.resourceUrl
+      resourceUrl: options.resourceUrl,
     };
 
     if (options?.resourceToken) {
@@ -646,7 +673,7 @@ export default class MeetingRequest extends StatelessWebexPlugin {
     return this.request({
       uri: options.uri,
       method: HTTP_VERBS.PUT,
-      body
+      body,
     });
   }
 
@@ -658,7 +685,7 @@ export default class MeetingRequest extends StatelessWebexPlugin {
    * @param {String} options.tones a string of one or more DTMF tones to send
    * @returns {Promise}
    */
-  sendDTMF({ locusUrl, deviceUrl, tones }: { locusUrl: string; deviceUrl: string; tones: string }) {
+  sendDTMF({locusUrl, deviceUrl, tones}: {locusUrl: string; deviceUrl: string; tones: string}) {
     // @ts-ignore
     return this.request({
       method: HTTP_VERBS.POST,
@@ -667,9 +694,9 @@ export default class MeetingRequest extends StatelessWebexPlugin {
         deviceUrl,
         dtmf: {
           correlationId: uuid.v4(),
-          tones
-        }
-      }
+          tones,
+        },
+      },
     });
   }
 
@@ -708,24 +735,37 @@ export default class MeetingRequest extends StatelessWebexPlugin {
   }) {
     // send main/content renderInfo only if both width and height are specified
     if (main && (!main.width || !main.height)) {
-      return Promise.reject(new Error(`Both width and height must be specified. One of them is missing for main: ${JSON.stringify(main)}`));
+      return Promise.reject(
+        new Error(
+          `Both width and height must be specified. One of them is missing for main: ${JSON.stringify(
+            main
+          )}`
+        )
+      );
     }
 
     if (content && (!content.width || !content.height)) {
-      return Promise.reject(new Error(`Both width and height must be specified. One of them is missing for content: ${JSON.stringify(content)}`));
+      return Promise.reject(
+        new Error(
+          `Both width and height must be specified. One of them is missing for content: ${JSON.stringify(
+            content
+          )}`
+        )
+      );
     }
 
-    const renderInfoMain = (main) ? {width: main.width, height: main.height} : undefined;
-    const renderInfoContent = (content) ? {width: content.width, height: content.height} : undefined;
+    const renderInfoMain = main ? {width: main.width, height: main.height} : undefined;
+    const renderInfoContent = content ? {width: content.width, height: content.height} : undefined;
 
-    const layoutParams = (renderInfoMain || renderInfoContent) ?
-      {
-        renderInfo:
-        {
-          main: renderInfoMain,
-          content: renderInfoContent
-        }
-      } : undefined;
+    const layoutParams =
+      renderInfoMain || renderInfoContent
+        ? {
+            renderInfo: {
+              main: renderInfoMain,
+              content: renderInfoContent,
+            },
+          }
+        : undefined;
 
     // @ts-ignore
     return this.request({
@@ -735,9 +775,9 @@ export default class MeetingRequest extends StatelessWebexPlugin {
         layout: {
           deviceUrl,
           type: layoutType,
-          layoutParams
-        }
-      }
+          layoutParams,
+        },
+      },
     });
   }
 
@@ -747,13 +787,13 @@ export default class MeetingRequest extends StatelessWebexPlugin {
    * @param {Url} options.locusUrl
    * @returns {Promise}
    */
-  endMeetingForAll({ locusUrl }: { locusUrl: string }) {
+  endMeetingForAll({locusUrl}: {locusUrl: string}) {
     const uri = `${locusUrl}/${END}`;
 
     // @ts-ignore
     return this.request({
       method: HTTP_VERBS.POST,
-      uri
+      uri,
     });
   }
 
@@ -763,11 +803,11 @@ export default class MeetingRequest extends StatelessWebexPlugin {
    * @param {Url} options.keepAliveUrl
    * @returns {Promise}
    */
-  keepAlive({ keepAliveUrl }: { keepAliveUrl: string }) {
+  keepAlive({keepAliveUrl}: {keepAliveUrl: string}) {
     // @ts-ignore
     return this.request({
       method: HTTP_VERBS.GET,
-      uri: keepAliveUrl
+      uri: keepAliveUrl,
     });
   }
 
@@ -779,7 +819,7 @@ export default class MeetingRequest extends StatelessWebexPlugin {
    * @param {string} options.senderID
    * @returns {Promise}
    */
-  sendReaction({ reactionChannelUrl, reaction, participantId }: { reactionChannelUrl: string, reaction: Reaction, participantId: string }) {
+  sendReaction({reactionChannelUrl, reaction, participantId}: SendReactionOptions) {
     const uri = reactionChannelUrl;
 
     // @ts-ignore
@@ -789,7 +829,28 @@ export default class MeetingRequest extends StatelessWebexPlugin {
       body: {
         sender: {participantId},
         reaction,
-      }
+      },
+    });
+  }
+
+  /**
+   * Make a network request to enable or disable reactions.
+   * @param {boolean} options.enable - determines if we need to enable or disable.
+   * @param {locusUrl} options.locusUrl
+   * @returns {Promise}
+   */
+  toggleReactions({enable, locusUrl, requestingParticipantId}: ToggleReactionsOptions) {
+    const uri = `${locusUrl}/${CONTROLS}`;
+
+    return this.request({
+      method: HTTP_VERBS.PUT,
+      uri,
+      body: {
+        reactions: {
+          enabled: enable,
+        },
+        requestingParticipantId,
+      },
     });
   }
 }

package/src/meeting/request.type.ts

@@ -0,0 +1,11 @@
+export type SendReactionOptions = {
+  reactionChannelUrl: string;
+  reaction: Reaction;
+  participantId: string;
+};
+
+export type ToggleReactionsOptions = {
+  enable: boolean;
+  locusUrl: string;
+  requestingParticipantId: string;
+};