@webex/plugin-meetings 3.8.0-next.8 → 3.8.0-next.81

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (171) hide show
  1. package/dist/breakouts/breakout.js +1 -1
  2. package/dist/breakouts/index.js +70 -6
  3. package/dist/breakouts/index.js.map +1 -1
  4. package/dist/common/errors/webex-errors.js +12 -2
  5. package/dist/common/errors/webex-errors.js.map +1 -1
  6. package/dist/config.js +5 -1
  7. package/dist/config.js.map +1 -1
  8. package/dist/constants.js +20 -123
  9. package/dist/constants.js.map +1 -1
  10. package/dist/controls-options-manager/enums.js +2 -0
  11. package/dist/controls-options-manager/enums.js.map +1 -1
  12. package/dist/controls-options-manager/types.js.map +1 -1
  13. package/dist/controls-options-manager/util.js +52 -0
  14. package/dist/controls-options-manager/util.js.map +1 -1
  15. package/dist/interpretation/index.js +1 -1
  16. package/dist/interpretation/siLanguage.js +1 -1
  17. package/dist/locus-info/controlsUtils.js +28 -10
  18. package/dist/locus-info/controlsUtils.js.map +1 -1
  19. package/dist/locus-info/index.js +62 -12
  20. package/dist/locus-info/index.js.map +1 -1
  21. package/dist/locus-info/selfUtils.js +432 -418
  22. package/dist/locus-info/selfUtils.js.map +1 -1
  23. package/dist/media/index.js +17 -17
  24. package/dist/media/index.js.map +1 -1
  25. package/dist/media/properties.js +94 -6
  26. package/dist/media/properties.js.map +1 -1
  27. package/dist/meeting/brbState.js +6 -0
  28. package/dist/meeting/brbState.js.map +1 -1
  29. package/dist/meeting/in-meeting-actions.js +17 -1
  30. package/dist/meeting/in-meeting-actions.js.map +1 -1
  31. package/dist/meeting/index.js +570 -302
  32. package/dist/meeting/index.js.map +1 -1
  33. package/dist/meeting/locusMediaRequest.js +0 -17
  34. package/dist/meeting/locusMediaRequest.js.map +1 -1
  35. package/dist/meeting/muteState.js +0 -2
  36. package/dist/meeting/muteState.js.map +1 -1
  37. package/dist/meeting/request.js +30 -0
  38. package/dist/meeting/request.js.map +1 -1
  39. package/dist/meeting/request.type.js.map +1 -1
  40. package/dist/meeting/util.js +13 -2
  41. package/dist/meeting/util.js.map +1 -1
  42. package/dist/meeting-info/meeting-info-v2.js +373 -68
  43. package/dist/meeting-info/meeting-info-v2.js.map +1 -1
  44. package/dist/meeting-info/utilv2.js +5 -1
  45. package/dist/meeting-info/utilv2.js.map +1 -1
  46. package/dist/meetings/index.js +136 -1
  47. package/dist/meetings/index.js.map +1 -1
  48. package/dist/meetings/util.js +14 -0
  49. package/dist/meetings/util.js.map +1 -1
  50. package/dist/member/index.js +10 -0
  51. package/dist/member/index.js.map +1 -1
  52. package/dist/member/util.js +330 -353
  53. package/dist/member/util.js.map +1 -1
  54. package/dist/members/index.js +42 -0
  55. package/dist/members/index.js.map +1 -1
  56. package/dist/members/request.js +38 -0
  57. package/dist/members/request.js.map +1 -1
  58. package/dist/members/util.js +36 -1
  59. package/dist/members/util.js.map +1 -1
  60. package/dist/metrics/constants.js +9 -0
  61. package/dist/metrics/constants.js.map +1 -1
  62. package/dist/reachability/clusterReachability.js +63 -27
  63. package/dist/reachability/clusterReachability.js.map +1 -1
  64. package/dist/reachability/index.js +112 -47
  65. package/dist/reachability/index.js.map +1 -1
  66. package/dist/reachability/reachability.types.js +14 -0
  67. package/dist/reachability/reachability.types.js.map +1 -1
  68. package/dist/reachability/request.js +19 -3
  69. package/dist/reachability/request.js.map +1 -1
  70. package/dist/reconnection-manager/index.js +2 -2
  71. package/dist/reconnection-manager/index.js.map +1 -1
  72. package/dist/roap/index.js.map +1 -1
  73. package/dist/roap/turnDiscovery.js +45 -27
  74. package/dist/roap/turnDiscovery.js.map +1 -1
  75. package/dist/roap/types.js +17 -0
  76. package/dist/roap/types.js.map +1 -0
  77. package/dist/types/common/errors/webex-errors.d.ts +7 -1
  78. package/dist/types/config.d.ts +3 -0
  79. package/dist/types/constants.d.ts +13 -85
  80. package/dist/types/controls-options-manager/enums.d.ts +3 -1
  81. package/dist/types/controls-options-manager/types.d.ts +7 -1
  82. package/dist/types/locus-info/index.d.ts +3 -3
  83. package/dist/types/locus-info/selfUtils.d.ts +216 -1
  84. package/dist/types/media/properties.d.ts +15 -0
  85. package/dist/types/meeting/in-meeting-actions.d.ts +16 -0
  86. package/dist/types/meeting/index.d.ts +43 -1
  87. package/dist/types/meeting/muteState.d.ts +0 -1
  88. package/dist/types/meeting/request.d.ts +12 -1
  89. package/dist/types/meeting/request.type.d.ts +6 -0
  90. package/dist/types/meeting/util.d.ts +3 -1
  91. package/dist/types/meeting-info/meeting-info-v2.d.ts +82 -1
  92. package/dist/types/meetings/index.d.ts +57 -0
  93. package/dist/types/member/index.d.ts +1 -0
  94. package/dist/types/member/util.d.ts +159 -1
  95. package/dist/types/members/index.d.ts +15 -0
  96. package/dist/types/members/request.d.ts +26 -0
  97. package/dist/types/members/util.d.ts +27 -0
  98. package/dist/types/metrics/constants.d.ts +9 -0
  99. package/dist/types/reachability/clusterReachability.d.ts +15 -7
  100. package/dist/types/reachability/index.d.ts +10 -1
  101. package/dist/types/reachability/reachability.types.d.ts +5 -0
  102. package/dist/types/roap/index.d.ts +3 -2
  103. package/dist/types/roap/turnDiscovery.d.ts +5 -17
  104. package/dist/types/roap/types.d.ts +16 -0
  105. package/dist/webinar/index.js +1 -1
  106. package/package.json +24 -23
  107. package/src/breakouts/index.ts +69 -0
  108. package/src/common/errors/webex-errors.ts +8 -1
  109. package/src/config.ts +3 -0
  110. package/src/constants.ts +20 -90
  111. package/src/controls-options-manager/enums.ts +2 -0
  112. package/src/controls-options-manager/types.ts +11 -1
  113. package/src/controls-options-manager/util.ts +62 -0
  114. package/src/locus-info/controlsUtils.ts +44 -14
  115. package/src/locus-info/index.ts +56 -13
  116. package/src/locus-info/selfUtils.ts +496 -442
  117. package/src/media/index.ts +23 -21
  118. package/src/media/properties.ts +96 -0
  119. package/src/meeting/brbState.ts +7 -0
  120. package/src/meeting/in-meeting-actions.ts +32 -0
  121. package/src/meeting/index.ts +382 -93
  122. package/src/meeting/locusMediaRequest.ts +0 -18
  123. package/src/meeting/muteState.ts +0 -2
  124. package/src/meeting/request.ts +36 -1
  125. package/src/meeting/request.type.ts +7 -0
  126. package/src/meeting/util.ts +11 -2
  127. package/src/meeting-info/meeting-info-v2.ts +254 -8
  128. package/src/meeting-info/utilv2.ts +5 -0
  129. package/src/meetings/index.ts +148 -1
  130. package/src/meetings/util.ts +18 -0
  131. package/src/member/index.ts +13 -2
  132. package/src/member/util.ts +351 -348
  133. package/src/members/index.ts +47 -0
  134. package/src/members/request.ts +44 -0
  135. package/src/members/util.ts +43 -1
  136. package/src/metrics/constants.ts +9 -0
  137. package/src/reachability/clusterReachability.ts +73 -26
  138. package/src/reachability/index.ts +70 -1
  139. package/src/reachability/reachability.types.ts +6 -0
  140. package/src/reachability/request.ts +7 -0
  141. package/src/reconnection-manager/index.ts +2 -2
  142. package/src/roap/index.ts +3 -7
  143. package/src/roap/turnDiscovery.ts +34 -39
  144. package/src/roap/types.ts +23 -0
  145. package/test/unit/spec/breakouts/index.ts +167 -95
  146. package/test/unit/spec/controls-options-manager/util.js +120 -0
  147. package/test/unit/spec/locus-info/controlsUtils.js +103 -9
  148. package/test/unit/spec/locus-info/index.js +167 -73
  149. package/test/unit/spec/locus-info/selfUtils.js +98 -24
  150. package/test/unit/spec/media/index.ts +150 -18
  151. package/test/unit/spec/media/properties.ts +130 -0
  152. package/test/unit/spec/meeting/brbState.ts +19 -0
  153. package/test/unit/spec/meeting/in-meeting-actions.ts +19 -4
  154. package/test/unit/spec/meeting/index.js +557 -35
  155. package/test/unit/spec/meeting/locusMediaRequest.ts +0 -30
  156. package/test/unit/spec/meeting/muteState.js +0 -2
  157. package/test/unit/spec/meeting/request.js +32 -1
  158. package/test/unit/spec/meeting/utils.js +119 -18
  159. package/test/unit/spec/meeting-info/meetinginfov2.js +484 -114
  160. package/test/unit/spec/meeting-info/utilv2.js +19 -0
  161. package/test/unit/spec/meetings/index.js +146 -2
  162. package/test/unit/spec/member/index.js +7 -0
  163. package/test/unit/spec/member/util.js +24 -0
  164. package/test/unit/spec/members/index.js +140 -26
  165. package/test/unit/spec/members/request.js +68 -22
  166. package/test/unit/spec/members/utils.js +75 -0
  167. package/test/unit/spec/reachability/clusterReachability.ts +88 -56
  168. package/test/unit/spec/reachability/index.ts +101 -0
  169. package/test/unit/spec/reachability/request.js +47 -2
  170. package/test/unit/spec/reconnection-manager/index.js +4 -4
  171. package/test/unit/spec/roap/turnDiscovery.ts +110 -28
@@ -221,14 +221,6 @@ export class LocusMediaRequest extends WebexPlugin {
221
221
  localMedias.roapMessage = request.roapMessage;
222
222
  localMedias.reachability = request.reachability;
223
223
  body.clientMediaPreferences = request.clientMediaPreferences;
224
-
225
- // @ts-ignore
226
- this.webex.internal.newMetrics.submitClientEvent({
227
- name: 'client.locus.media.request',
228
- options: {
229
- meetingId: this.config.meetingId,
230
- },
231
- });
232
224
  break;
233
225
  }
234
226
 
@@ -269,16 +261,6 @@ export class LocusMediaRequest extends WebexPlugin {
269
261
  this.confluenceState = 'created';
270
262
  }
271
263
 
272
- if (request.type === 'RoapMessage') {
273
- // @ts-ignore
274
- this.webex.internal.newMetrics.submitClientEvent({
275
- name: 'client.locus.media.response',
276
- options: {
277
- meetingId: this.config.meetingId,
278
- },
279
- });
280
- }
281
-
282
264
  return result;
283
265
  })
284
266
  .catch((e) => {
@@ -147,7 +147,6 @@ export class MuteState {
147
147
  * @public
148
148
  * @memberof MuteState
149
149
  * @param {Object} [meeting] the meeting object
150
- * @param {Boolean} [mute] true for muting, false for unmuting request
151
150
  * @returns {void}
152
151
  */
153
152
  public handleLocalStreamMuteStateChange(meeting?: any) {
@@ -350,7 +349,6 @@ export class MuteState {
350
349
  * @param {Meeting} meeting
351
350
  * @returns {void}
352
351
  */
353
- // eslint-disable-next-line @typescript-eslint/no-unused-vars
354
352
  private applyUnmuteAllowedToStream(meeting: any) {
355
353
  if (this.type === AUDIO) {
356
354
  meeting.mediaProperties.audioStream?.setUnmuteAllowed(this.state.server.unmuteAllowed);
@@ -27,7 +27,12 @@ import {
27
27
  _SLIDES_,
28
28
  ANNOTATION,
29
29
  } from '../constants';
30
- import {SendReactionOptions, BrbOptions, ToggleReactionsOptions} from './request.type';
30
+ import {
31
+ SendReactionOptions,
32
+ BrbOptions,
33
+ ToggleReactionsOptions,
34
+ PostMeetingDataConsentOptions,
35
+ } from './request.type';
31
36
  import MeetingUtil from './util';
32
37
  import {AnnotationInfo} from '../annotation/annotation.types';
33
38
  import {ClientMediaPreferences} from '../reachability/reachability.types';
@@ -934,4 +939,34 @@ export default class MeetingRequest extends StatelessWebexPlugin {
934
939
  },
935
940
  });
936
941
  }
942
+
943
+ /**
944
+ * Sends a request to set post meeting data consent.
945
+ *
946
+ * @param {Object} options - The options for post meeting data consent request.
947
+ * @param {boolean} options.consent - Whether accepted or declined.
948
+ * @param {string} options.locusUrl - The URL of the locus.
949
+ * @param {string} options.deviceUrl - The URL of the device.
950
+ * @param {string} options.selfId - The ID of the participant.
951
+ * @returns {Promise}
952
+ */
953
+ setPostMeetingDataConsent({
954
+ postMeetingDataConsent,
955
+ locusUrl,
956
+ deviceUrl,
957
+ selfId,
958
+ }: PostMeetingDataConsentOptions) {
959
+ const uri = `${locusUrl}/${PARTICIPANT}/${selfId}/${CONTROLS}`;
960
+
961
+ return this.locusDeltaRequest({
962
+ method: HTTP_VERBS.PATCH,
963
+ uri,
964
+ body: {
965
+ consent: {
966
+ postMeetingDataConsent,
967
+ deviceUrl,
968
+ },
969
+ },
970
+ });
971
+ }
937
972
  }
@@ -18,3 +18,10 @@ export type BrbOptions = {
18
18
  deviceUrl: string;
19
19
  selfId: string;
20
20
  };
21
+
22
+ export type PostMeetingDataConsentOptions = {
23
+ postMeetingDataConsent: boolean;
24
+ locusUrl: string;
25
+ deviceUrl: string;
26
+ selfId: string;
27
+ };
@@ -176,11 +176,12 @@ const MeetingUtil = {
176
176
  deviceCapabilities: options.deviceCapabilities,
177
177
  liveAnnotationSupported: options.liveAnnotationSupported,
178
178
  clientMediaPreferences,
179
+ alias: options.alias,
179
180
  })
180
181
  .then((res) => {
181
182
  const parsed = MeetingUtil.parseLocusJoin(res);
182
183
  meeting.setLocus(parsed);
183
-
184
+ meeting.isoLocalClientMeetingJoinTime = res?.headers?.date; // read from header if exist, else fall back to system clock : https://jira-eng-gpk2.cisco.com/jira/browse/SPARK-555657
184
185
  webex.internal.newMetrics.submitClientEvent({
185
186
  name: 'client.locus.join.response',
186
187
  payload: {
@@ -572,9 +573,17 @@ const MeetingUtil = {
572
573
  canUserRenameSelfAndObserved: (displayHints) =>
573
574
  displayHints.includes(DISPLAY_HINTS.CAN_RENAME_SELF_AND_OBSERVED),
574
575
 
576
+ requiresPostMeetingDataConsentPrompt: (displayHints) =>
577
+ displayHints.includes(DISPLAY_HINTS.SHOW_POST_MEETING_DATA_CONSENT_PROMPT),
578
+
575
579
  canUserRenameOthers: (displayHints) => displayHints.includes(DISPLAY_HINTS.CAN_RENAME_OTHERS),
576
580
 
577
- canShareWhiteBoard: (displayHints) => displayHints.includes(DISPLAY_HINTS.SHARE_WHITEBOARD),
581
+ // Default empty value for policies if we get an undefined value (ie permissionToken is not available)
582
+ canShareWhiteBoard: (displayHints, policies = {}) =>
583
+ displayHints.includes(DISPLAY_HINTS.SHARE_WHITEBOARD) &&
584
+ !!policies[SELF_POLICY.SUPPORT_WHITEBOARD],
585
+
586
+ canMoveToLobby: (displayHints) => displayHints.includes(DISPLAY_HINTS.MOVE_TO_LOBBY),
578
587
 
579
588
  /**
580
589
  * Adds the current locus sequence information to a request body
@@ -16,6 +16,9 @@ const CAPTCHA_ERROR_DEFAULT_MESSAGE =
16
16
  'Captcha required. Call fetchMeetingInfo() with captchaInfo argument';
17
17
  const ADHOC_MEETING_DEFAULT_ERROR =
18
18
  'Failed starting the adhoc meeting, Please contact support team ';
19
+ const MEETING_IS_IN_PROGRESS_MESSAGE = 'Meeting is in progress';
20
+ const STATIC_MEETING_LINK_ALREADY_EXISTS_MESSAGE = 'Static meeting link already exists';
21
+ const FETCH_STATIC_MEETING_LINK = 'Meeting link does not exists for conversation';
19
22
  const CAPTCHA_ERROR_REQUIRES_PASSWORD_CODES = [423005, 423006];
20
23
  const CAPTCHA_ERROR_REQUIRES_REGISTRATION_ID_CODES = [423007];
21
24
 
@@ -193,6 +196,77 @@ export class MeetingInfoV2JoinForbiddenError extends Error {
193
196
  }
194
197
  }
195
198
 
199
+ /**
200
+ * Error fetching static link for a conversation when it does not exist
201
+ */
202
+ export class MeetingInfoV2StaticLinkDoesNotExistError extends Error {
203
+ sdkMessage: any;
204
+ wbxAppApiCode: any;
205
+ body: any;
206
+ /**
207
+ *
208
+ * @constructor
209
+ * @param {Number} [wbxAppApiErrorCode]
210
+ * @param {String} [message]
211
+ */
212
+ constructor(wbxAppApiErrorCode?: number, message: string = FETCH_STATIC_MEETING_LINK) {
213
+ super(`${message}, code=${wbxAppApiErrorCode}`);
214
+ this.name = 'MeetingInfoV2StaticLinkDoesNotExistError';
215
+ this.sdkMessage = message;
216
+ this.stack = new Error().stack;
217
+ this.wbxAppApiCode = wbxAppApiErrorCode;
218
+ }
219
+ }
220
+
221
+ /**
222
+ * Error enabling/disabling static meeting link
223
+ */
224
+ export class MeetingInfoV2MeetingIsInProgressError extends Error {
225
+ sdkMessage: any;
226
+ wbxAppApiCode: any;
227
+ body: any;
228
+ /**
229
+ *
230
+ * @constructor
231
+ * @param {Number} [wbxAppApiErrorCode]
232
+ * @param {String} [message]
233
+ * @param {Boolean} [enable]
234
+ */
235
+ constructor(
236
+ wbxAppApiErrorCode?: number,
237
+ message = MEETING_IS_IN_PROGRESS_MESSAGE,
238
+ enable = false
239
+ ) {
240
+ super(`${message}, code=${wbxAppApiErrorCode}, enable=${enable}`);
241
+ this.name = 'MeetingInfoV2MeetingIsInProgressError';
242
+ this.sdkMessage = message;
243
+ this.stack = new Error().stack;
244
+ this.wbxAppApiCode = wbxAppApiErrorCode;
245
+ }
246
+ }
247
+
248
+ /**
249
+ * Error enabling/disabling static meeting link
250
+ */
251
+ export class MeetingInfoV2StaticMeetingLinkAlreadyExists extends Error {
252
+ sdkMessage: any;
253
+ wbxAppApiCode: any;
254
+ body: any;
255
+ /**
256
+ *
257
+ * @constructor
258
+ * @param {Number} [wbxAppApiErrorCode]
259
+ * @param {String} [message]
260
+ */
261
+ constructor(wbxAppApiErrorCode?: number, message = STATIC_MEETING_LINK_ALREADY_EXISTS_MESSAGE) {
262
+ super(`${message}, code=${wbxAppApiErrorCode}`);
263
+ this.name = 'MeetingInfoV2StaticMeetingLinkAlreadyExists';
264
+ this.sdkMessage = message;
265
+ this.stack = new Error().stack;
266
+ this.wbxAppApiCode = wbxAppApiErrorCode;
267
+ }
268
+ }
269
+
196
270
  /**
197
271
  * @class MeetingInfo
198
272
  */
@@ -293,17 +367,20 @@ export default class MeetingInfoV2 {
293
367
  };
294
368
 
295
369
  /**
296
- * Creates adhoc space meetings for a space by fetching the conversation infomation
370
+ * helper function to either create an adhoc space meeting or enable static meeting link
297
371
  * @param {String} conversationUrl conversationUrl to start adhoc meeting on
298
372
  * @param {String} installedOrgID org ID of user's machine
373
+ * @param {Boolean} enableStaticMeetingLink whether or not to enable static meeting link
299
374
  * @returns {Promise} returns a meeting info object
300
375
  * @public
301
376
  * @memberof MeetingInfo
302
377
  */
303
- async createAdhocSpaceMeeting(conversationUrl: string, installedOrgID?: string) {
304
- if (!this.webex.meetings.preferredWebexSite) {
305
- throw Error('No preferred webex site found');
306
- }
378
+ async createAdhocSpaceMeetingOrEnableStaticMeetingLink(
379
+ conversationUrl: string,
380
+ installedOrgID?: string,
381
+ // setting this to true enables static meeting link
382
+ enableStaticMeetingLink = false
383
+ ) {
307
384
  const getInvitees = (particpants = []) => {
308
385
  const invitees = [];
309
386
 
@@ -329,6 +406,7 @@ export default class MeetingInfoV2 {
329
406
  kroUrl: conversation.kmsResourceObjectUrl,
330
407
  invitees: getInvitees(conversation.participants?.items),
331
408
  installedOrgID,
409
+ schedule: enableStaticMeetingLink,
332
410
  };
333
411
 
334
412
  if (installedOrgID) {
@@ -344,7 +422,23 @@ export default class MeetingInfoV2 {
344
422
  uri,
345
423
  body,
346
424
  });
347
- })
425
+ });
426
+ }
427
+
428
+ /**
429
+ * Creates adhoc space meetings for a space by fetching the conversation infomation
430
+ * @param {String} conversationUrl conversationUrl to start adhoc meeting on
431
+ * @param {String} installedOrgID org ID of user's machine
432
+ * @returns {Promise} returns a meeting info object
433
+ * @public
434
+ * @memberof MeetingInfo
435
+ */
436
+ async createAdhocSpaceMeeting(conversationUrl: string, installedOrgID?: string) {
437
+ if (!this.webex.meetings.preferredWebexSite) {
438
+ throw Error('No preferred webex site found');
439
+ }
440
+
441
+ return this.createAdhocSpaceMeetingOrEnableStaticMeetingLink(conversationUrl, installedOrgID)
348
442
  .then((requestResult) => {
349
443
  Metrics.sendBehavioralMetric(BEHAVIORAL_METRICS.ADHOC_MEETING_SUCCESS);
350
444
 
@@ -363,6 +457,153 @@ export default class MeetingInfoV2 {
363
457
  });
364
458
  }
365
459
 
460
+ /**
461
+ * Fetches details for static meeting link
462
+ * @param {String} conversationUrl conversationUrl that's required to find static meeting link if it exists
463
+ * @returns {Promise} returns a Promise
464
+ * @public
465
+ * @memberof MeetingInfo
466
+ */
467
+ async fetchStaticMeetingLink(conversationUrl: string) {
468
+ if (!this.webex.meetings.preferredWebexSite) {
469
+ throw Error('No preferred webex site found');
470
+ }
471
+
472
+ const body = {
473
+ spaceUrl: conversationUrl,
474
+ };
475
+
476
+ const uri = this.webex.meetings.preferredWebexSite
477
+ ? `https://${this.webex.meetings.preferredWebexSite}/wbxappapi/v2/meetings/spaceInstant/query`
478
+ : '';
479
+
480
+ return this.webex
481
+ .request({
482
+ method: HTTP_VERBS.POST,
483
+ uri,
484
+ body,
485
+ })
486
+ .then((requestResult) => {
487
+ Metrics.sendBehavioralMetric(BEHAVIORAL_METRICS.FETCH_STATIC_MEETING_LINK_SUCCESS);
488
+
489
+ return requestResult;
490
+ })
491
+ .catch((err) => {
492
+ if (err?.statusCode === 403) {
493
+ Metrics.sendBehavioralMetric(BEHAVIORAL_METRICS.MEETING_LINK_DOES_NOT_EXIST_ERROR, {
494
+ reason: err.message,
495
+ stack: err.stack,
496
+ });
497
+
498
+ throw new MeetingInfoV2StaticLinkDoesNotExistError(err.body?.code, err.body?.message);
499
+ }
500
+ Metrics.sendBehavioralMetric(BEHAVIORAL_METRICS.FETCH_STATIC_MEETING_LINK_FAILURE, {
501
+ reason: err.message,
502
+ stack: err.stack,
503
+ });
504
+
505
+ throw err;
506
+ });
507
+ }
508
+
509
+ /**
510
+ * Enables static meeting link
511
+ * @param {String} conversationUrl conversationUrl that's required to enable static meeting link
512
+ * @returns {Promise} returns a Promise
513
+ * @public
514
+ * @memberof MeetingInfo
515
+ */
516
+ async enableStaticMeetingLink(conversationUrl: string) {
517
+ if (!this.webex.meetings.preferredWebexSite) {
518
+ throw Error('No preferred webex site found');
519
+ }
520
+
521
+ return this.createAdhocSpaceMeetingOrEnableStaticMeetingLink(conversationUrl, undefined, true)
522
+ .then((requestResult) => {
523
+ Metrics.sendBehavioralMetric(BEHAVIORAL_METRICS.ENABLE_STATIC_METTING_LINK_SUCCESS);
524
+
525
+ return requestResult;
526
+ })
527
+ .catch((err) => {
528
+ if (err?.statusCode === 403) {
529
+ Metrics.sendBehavioralMetric(BEHAVIORAL_METRICS.MEETING_IS_IN_PROGRESS_ERROR, {
530
+ reason: err.message,
531
+ stack: err.stack,
532
+ });
533
+
534
+ throw new MeetingInfoV2MeetingIsInProgressError(err.body?.code, err.body?.message, true);
535
+ }
536
+
537
+ if (err?.statusCode === 409) {
538
+ Metrics.sendBehavioralMetric(
539
+ BEHAVIORAL_METRICS.STATIC_MEETING_LINK_ALREADY_EXISTS_ERROR,
540
+ {
541
+ reason: err.message,
542
+ stack: err.stack,
543
+ }
544
+ );
545
+
546
+ throw new MeetingInfoV2StaticMeetingLinkAlreadyExists(err.body?.code, err.body?.message);
547
+ }
548
+
549
+ Metrics.sendBehavioralMetric(BEHAVIORAL_METRICS.ENABLE_STATIC_METTING_LINK_FAILURE, {
550
+ reason: err.message,
551
+ stack: err.stack,
552
+ });
553
+
554
+ throw err;
555
+ });
556
+ }
557
+
558
+ /**
559
+ * Disables static meeting link for given conversation url
560
+ * @param {String} conversationUrl conversationUrl that's required to disable static meeting link if it exists
561
+ * @returns {Promise} returns a Promise
562
+ * @public
563
+ * @memberof MeetingInfo
564
+ */
565
+ async disableStaticMeetingLink(conversationUrl: string) {
566
+ if (!this.webex.meetings.preferredWebexSite) {
567
+ throw Error('No preferred webex site found');
568
+ }
569
+
570
+ const body = {
571
+ spaceUrl: conversationUrl,
572
+ };
573
+
574
+ const uri = this.webex.meetings.preferredWebexSite
575
+ ? `https://${this.webex.meetings.preferredWebexSite}/wbxappapi/v2/meetings/spaceInstant/deletePersistentMeeting`
576
+ : '';
577
+
578
+ return this.webex
579
+ .request({
580
+ method: HTTP_VERBS.POST,
581
+ uri,
582
+ body,
583
+ })
584
+ .then((requestResult) => {
585
+ Metrics.sendBehavioralMetric(BEHAVIORAL_METRICS.DISABLE_STATIC_MEETING_LINK_SUCCESS);
586
+
587
+ return requestResult;
588
+ })
589
+ .catch((err) => {
590
+ if (err?.statusCode === 403) {
591
+ Metrics.sendBehavioralMetric(BEHAVIORAL_METRICS.MEETING_IS_IN_PROGRESS_ERROR, {
592
+ reason: err.message,
593
+ stack: err.stack,
594
+ });
595
+
596
+ throw new MeetingInfoV2MeetingIsInProgressError(err.body?.code, err.body?.message);
597
+ }
598
+ Metrics.sendBehavioralMetric(BEHAVIORAL_METRICS.DISABLE_STATIC_MEETING_LINK_FAILURE, {
599
+ reason: err.message,
600
+ stack: err.stack,
601
+ });
602
+
603
+ throw err;
604
+ });
605
+ }
606
+
366
607
  /**
367
608
  * Fetches meeting info from the server
368
609
  * @param {String} destination one of many different types of destinations to look up info for
@@ -376,6 +617,7 @@ export default class MeetingInfoV2 {
376
617
  * @param {Object} extraParams
377
618
  * @param {Object} options
378
619
  * @param {String} registrationId
620
+ * @param {String} fullSiteUrl
379
621
  * @returns {Promise} returns a meeting info object
380
622
  * @public
381
623
  * @memberof MeetingInfo
@@ -392,7 +634,8 @@ export default class MeetingInfoV2 {
392
634
  locusId = null,
393
635
  extraParams: object = {},
394
636
  options: {meetingId?: string; sendCAevents?: boolean} = {},
395
- registrationId: string = null
637
+ registrationId: string = null,
638
+ fullSiteUrl: string = null
396
639
  ) {
397
640
  const {meetingId, sendCAevents} = options;
398
641
 
@@ -418,6 +661,7 @@ export default class MeetingInfoV2 {
418
661
  locusId,
419
662
  extraParams,
420
663
  registrationId,
664
+ disableWebRedirect: true,
421
665
  });
422
666
 
423
667
  // If the body only contains the default properties, we don't have enough to
@@ -443,7 +687,9 @@ export default class MeetingInfoV2 {
443
687
 
444
688
  const directURI = await MeetingInfoUtil.getDirectMeetingInfoURI(destinationType);
445
689
 
446
- if (directURI) {
690
+ if (fullSiteUrl) {
691
+ requestOptions.uri = `https://${fullSiteUrl}/wbxappapi/v1/meetingInfo`;
692
+ } else if (directURI) {
447
693
  requestOptions.uri = directURI;
448
694
  } else {
449
695
  requestOptions.service = WBXAPPAPI_SERVICE;
@@ -237,6 +237,7 @@ export default class MeetingInfoUtil {
237
237
  locusId,
238
238
  extraParams,
239
239
  registrationId,
240
+ disableWebRedirect,
240
241
  } = options;
241
242
  const body: any = {
242
243
  ...DEFAULT_MEETING_INFO_REQUEST_BODY,
@@ -296,6 +297,10 @@ export default class MeetingInfoUtil {
296
297
  body.locusId = locusId;
297
298
  }
298
299
 
300
+ if (disableWebRedirect) {
301
+ body.disableWebRedirect = disableWebRedirect;
302
+ }
303
+
299
304
  return body;
300
305
  }
301
306
 
@@ -807,6 +807,67 @@ export default class Meetings extends WebexPlugin {
807
807
  }
808
808
  }
809
809
 
810
+ /**
811
+ * API to toggle usage of audio main DTX, needs to be called before webex.meetings.register()
812
+ *
813
+ * @param {Boolean} newValue
814
+ * @private
815
+ * @memberof Meetings
816
+ * @returns {undefined}
817
+ */
818
+ private _toggleDisableAudioMainDtx(newValue: boolean) {
819
+ if (typeof newValue !== 'boolean') {
820
+ return;
821
+ }
822
+
823
+ // @ts-ignore
824
+ if (this.config.experimental.disableAudioMainDtx !== newValue) {
825
+ // @ts-ignore
826
+ this.config.experimental.disableAudioMainDtx = newValue;
827
+ }
828
+ }
829
+
830
+ /**
831
+ * API to toggle usage of audio twcc support
832
+ *
833
+ * @param {Boolean} newValue
834
+ * @private
835
+ * @memberof Meetings
836
+ * @returns {undefined}
837
+ */
838
+ private _toggleEnableAudioTwccForMultistream(newValue: boolean) {
839
+ if (typeof newValue !== 'boolean') {
840
+ return;
841
+ }
842
+
843
+ // @ts-ignore
844
+ if (this.config.enableAudioTwccForMultistream !== newValue) {
845
+ // @ts-ignore
846
+ this.config.enableAudioTwccForMultistream = newValue;
847
+ }
848
+ }
849
+
850
+ /**
851
+ * API to toggle stopping ICE Candidates Gathering after first relay candidate,
852
+ * needs to be called before webex.meetings.joinWithMedia()
853
+ *
854
+ * @param {Boolean} newValue
855
+ * @private
856
+ * @memberof Meetings
857
+ * @returns {undefined}
858
+ */
859
+ private _toggleStopIceGatheringAfterFirstRelayCandidate(newValue: boolean) {
860
+ if (typeof newValue !== 'boolean') {
861
+ return;
862
+ }
863
+
864
+ // @ts-ignore
865
+ if (this.config.stopIceGatheringAfterFirstRelayCandidate !== newValue) {
866
+ // @ts-ignore
867
+ this.config.stopIceGatheringAfterFirstRelayCandidate = newValue;
868
+ }
869
+ }
870
+
810
871
  /**
811
872
  * Executes a registration step and updates the registration status.
812
873
  * @param {Function} step - The registration step to execute.
@@ -854,7 +915,7 @@ export default class Meetings extends WebexPlugin {
854
915
  this.executeRegistrationStep(
855
916
  () =>
856
917
  this.startReachability('registration').catch((error) => {
857
- LoggerProxy.logger.error(`Meetings:index#register --> GDM error, ${error.message}`);
918
+ LoggerProxy.logger.warn(`Meetings:index#register --> startReachability failed:`, error);
858
919
  }),
859
920
  'startReachability'
860
921
  ),
@@ -935,6 +996,21 @@ export default class Meetings extends WebexPlugin {
935
996
  .disconnect()
936
997
  // @ts-ignore
937
998
  .then(() => this.webex.internal.device.unregister())
999
+ .catch((error) => {
1000
+ // If error status code is 404, continue the chain
1001
+ if (error.statusCode === 404) {
1002
+ LoggerProxy.logger.info(
1003
+ 'Meetings:index#unregister --> 404 error during device unregister, proceeding normally'
1004
+ );
1005
+
1006
+ return; // returning undefined allows the chain to continue
1007
+ }
1008
+ // For any other status code, break the chain by rethrowing
1009
+ LoggerProxy.logger.error(
1010
+ `Meetings:index#unregister --> Failed to unregister device: ${error.message}`
1011
+ );
1012
+ throw error; // rethrow to break the promise chain
1013
+ })
938
1014
  .then(() => {
939
1015
  Trigger.trigger(
940
1016
  this,
@@ -1217,6 +1293,29 @@ export default class Meetings extends WebexPlugin {
1217
1293
  );
1218
1294
  }
1219
1295
 
1296
+ /**
1297
+ * Fetch static meeting link for given conversation url.
1298
+ *
1299
+ * @param {string} conversationUrl - url for conversation
1300
+ * @returns {Promise}
1301
+ * @public
1302
+ * @memberof Meetings
1303
+ */
1304
+ public fetchStaticMeetingLink(conversationUrl: string): Promise<any> {
1305
+ return (
1306
+ this.meetingInfo
1307
+ .fetchStaticMeetingLink(conversationUrl)
1308
+ // Catch a failure to fetch static meeting link.
1309
+ .catch((error) => {
1310
+ LoggerProxy.logger.error(
1311
+ `Meetings:index#fetchStaticMeetingLink --> ERROR, unable to fetch persistent meeting link: ${error.message}`
1312
+ );
1313
+
1314
+ return Promise.reject(error);
1315
+ })
1316
+ );
1317
+ }
1318
+
1220
1319
  /**
1221
1320
  * Create a meeting or return an existing meeting.
1222
1321
  *
@@ -1369,6 +1468,54 @@ export default class Meetings extends WebexPlugin {
1369
1468
  );
1370
1469
  }
1371
1470
 
1471
+ /**
1472
+ * Enable static meeting links for given conversation url.
1473
+ *
1474
+ *
1475
+ * @param {string} conversationUrl - url for conversation
1476
+ * @returns {Promise}
1477
+ * @public
1478
+ * @memberof Meetings
1479
+ */
1480
+ public enableStaticMeetingLink(conversationUrl: string): Promise<any> {
1481
+ return (
1482
+ this.meetingInfo
1483
+ .enableStaticMeetingLink(conversationUrl)
1484
+ // Catch a failure to enable static meeting link.
1485
+ .catch((error) => {
1486
+ LoggerProxy.logger.error(
1487
+ `Meetings:index#enableStaticMeetingLink --> ERROR, unable to enable static meeting link: ${error.message}`
1488
+ );
1489
+
1490
+ return Promise.reject(error);
1491
+ })
1492
+ );
1493
+ }
1494
+
1495
+ /**
1496
+ * Disable static meeting links for given conversation url.
1497
+ *
1498
+ *
1499
+ * @param {string} conversationUrl - url for conversation
1500
+ * @returns {Promise}
1501
+ * @public
1502
+ * @memberof Meetings
1503
+ */
1504
+ public disableStaticMeetingLink(conversationUrl: string): Promise<any> {
1505
+ return (
1506
+ this.meetingInfo
1507
+ .disableStaticMeetingLink(conversationUrl)
1508
+ // Catch a failure to disable static meeting link.
1509
+ .catch((error) => {
1510
+ LoggerProxy.logger.error(
1511
+ `Meetings:index#disableStaticMeetingLink --> ERROR, unable to disable static meeting link: ${error.message}`
1512
+ );
1513
+
1514
+ return Promise.reject(error);
1515
+ })
1516
+ );
1517
+ }
1518
+
1372
1519
  /**
1373
1520
  * Create meeting
1374
1521
  *
@@ -99,6 +99,24 @@ MeetingsUtil.getMediaServer = (sdp) => {
99
99
  return mediaServer;
100
100
  };
101
101
 
102
+ MeetingsUtil.getMediaServerIp = (sdp) => {
103
+ let mediaServerIp;
104
+
105
+ // Attempt to collect the media server from the roap message.
106
+ try {
107
+ mediaServerIp = sdp
108
+ .split('\r\n')
109
+ .find((line) => line.startsWith('o='))
110
+ .match(/o=\S+ \d+ \d+ IN IP4 ([\d.]+)/)?.[1]
111
+ .toLowerCase()
112
+ .trim();
113
+ } catch {
114
+ mediaServerIp = undefined;
115
+ }
116
+
117
+ return mediaServerIp;
118
+ };
119
+
102
120
  MeetingsUtil.checkForCorrelationId = (deviceUrl, locus) => {
103
121
  let devices = [];
104
122