@webex/plugin-meetings 3.10.0 → 3.11.0

package/src/hashTree/types.ts

@@ -0,0 +1,39 @@
+import {Enum} from '../constants';
+
+// todo: Locus docs have now more types like EMBEDDED_APP - need to add support for them once Locus implements them
+export const ObjectType = {
+  participant: 'participant',
+  self: 'self',
+  locus: 'locus',
+  mediaShare: 'mediashare',
+  info: 'info',
+  fullState: 'fullstate',
+  links: 'links',
+  control: 'controlentry',
+} as const;
+
+export type ObjectType = Enum<typeof ObjectType>;
+
+// mapping from ObjectType to top level LocusDTO keys
+export const ObjectTypeToLocusKeyMap = {
+  [ObjectType.links]: 'links',
+  [ObjectType.info]: 'info',
+  [ObjectType.fullState]: 'fullState',
+  [ObjectType.self]: 'self',
+  [ObjectType.participant]: 'participants', // note: each object is a single participant in participants array
+  [ObjectType.mediaShare]: 'mediaShares', // note: each object is a single mediaShare in mediaShares array
+  [ObjectType.control]: 'controls', // note: each object is a single control entry in controls object
+};
+export interface HtMeta {
+  elementId: {
+    type: ObjectType;
+    id: number;
+    version: number;
+  };
+  dataSetNames: string[];
+}
+
+export interface HashTreeObject {
+  htMeta: HtMeta;
+  data: Record<string, any>;
+}

package/src/hashTree/utils.ts

@@ -0,0 +1,53 @@
+/* eslint-disable import/prefer-default-export */
+
+import {ObjectType, HashTreeObject} from './types';
+
+/**
+ * Checks if the given hash tree object is of type "self"
+ * @param {HashTreeObject} object object to check
+ * @returns {boolean} True if the object is of type "self", false otherwise
+ */
+export function isSelf(object: HashTreeObject) {
+  return object.htMeta.elementId.type.toLowerCase() === ObjectType.self;
+}
+
+/**
+ * Analyzes given part of Locus DTO recursively and delete any nested objects that have their own htMeta
+ *
+ * @param {Object} currentLocusPart part of locus DTO to analyze
+ * @param {Object} parent parent object
+ * @param {string|number} currentKey key of the parent object that currentLocusPart is
+ * @returns {void}
+ */
+export const deleteNestedObjectsWithHtMeta = (
+  currentLocusPart: any,
+  parent?: any,
+  currentKey?: string | number
+) => {
+  if (typeof currentLocusPart !== 'object' || currentLocusPart === null) {
+    return;
+  }
+
+  if (parent && currentKey !== undefined && currentLocusPart.htMeta) {
+    if (Array.isArray(parent)) {
+      parent.splice(Number(currentKey), 1);
+    } else {
+      delete parent[currentKey];
+    }
+
+    return;
+  }
+
+  if (Array.isArray(currentLocusPart)) {
+    // iterate array in reverse, so that indexes remain valid when deleting elements
+    for (let i = currentLocusPart.length - 1; i >= 0; i -= 1) {
+      deleteNestedObjectsWithHtMeta(currentLocusPart[i], currentLocusPart, i);
+    }
+  } else {
+    for (const key of Object.keys(currentLocusPart)) {
+      if (Object.prototype.hasOwnProperty.call(currentLocusPart, key)) {
+        deleteNestedObjectsWithHtMeta(currentLocusPart[key], currentLocusPart, key);
+      }
+    }
+  }
+};

package/src/index.ts

@@ -18,6 +18,7 @@ import {
 import Meeting from './meeting';
 import MeetingInfoUtil from './meeting-info/utilv2';
 import JoinMeetingError from './common/errors/join-meeting';
+import {SdpResponseTimeoutError} from './common/errors/webex-errors';
 
 registerPlugin('meetings', Meetings, {
   config,
@@ -73,6 +74,7 @@ export {
   Meeting,
   MeetingInfoUtil,
   JoinWebinarError,
+  SdpResponseTimeoutError,
 };
 
 export {RemoteMedia} from './multistream/remoteMedia';

package/src/interceptors/locusRouteToken.ts

@@ -3,7 +3,6 @@
  */
 
 import {Interceptor} from '@webex/http-core';
-import {has} from 'lodash';
 
 const LOCUS_ID_REGEX = /\/locus\/api\/v1\/loci\/([a-f0-9-]{36})/i;
 const X_CISCO_PART_ROUTE_TOKEN = 'X-Cisco-Part-Route-Token';
@@ -25,16 +24,30 @@ export default class LocusRouteTokenInterceptor extends Interceptor {
     return url?.match(LOCUS_ID_REGEX)?.[1];
   }
 
+  getLocusIdByResponseBody(body: any) {
+    return body?.locus?.url?.match(LOCUS_ID_REGEX)?.[1];
+  }
+
+  // Helper function to get header value case insensitively
+  getHeader(headers: Record<string, string>, name: string) {
+    const key = Object.keys(headers).find((k) => k.toLowerCase() === name.toLowerCase());
+
+    return key ? headers[key] : undefined;
+  }
+
   /**
    * @param {Object} options
    * @param {HttpResponse} response
    * @returns {Promise<HttpResponse>}
    */
   onResponse(options, response) {
-    const locusId = this.getLocusIdByRequestUrl(options.uri);
+    const locusId =
+      this.getLocusIdByResponseBody(response.body) || this.getLocusIdByRequestUrl(options.uri);
     if (locusId) {
-      const hasRouteToken = has(response.headers, X_CISCO_PART_ROUTE_TOKEN);
-      const token = response.headers[X_CISCO_PART_ROUTE_TOKEN];
+      const hasRouteToken = Object.keys(response.headers).some(
+        (key) => key.toLowerCase() === X_CISCO_PART_ROUTE_TOKEN.toLowerCase()
+      );
+      const token = this.getHeader(response.headers, X_CISCO_PART_ROUTE_TOKEN);
       if (hasRouteToken) {
         this.updateToken(locusId, token);
       }
@@ -66,7 +79,11 @@ export default class LocusRouteTokenInterceptor extends Interceptor {
    * @returns {void}
    */
   updateToken(locusId, token) {
-    ROUTE_TOKEN[locusId] = token;
+    if (token === 'null' || token === null) {
+      delete ROUTE_TOKEN[locusId];
+    } else {
+      ROUTE_TOKEN[locusId] = token;
+    }
   }
 
   /**

package/src/locus-info/controlsUtils.ts

@@ -41,6 +41,7 @@ ControlsUtils.parse = (controls: any) => {
       transcribing: controls.transcribe.transcribing,
       caption: controls.transcribe.caption,
       spokenLanguage: controls.transcribe.spokenLanguage,
+      hesiodLlmId: controls.transcribe.hesiodLlmId,
     };
   }
 
@@ -202,6 +203,11 @@ ControlsUtils.getControls = (oldControls: any, newControls: any) => {
         !isEqual(previous?.transcribe?.transcribing, current?.transcribe?.transcribing) && // upon first join, previous?.record?.recording = undefined; thus, never going to be equal and will always return true
         (previous?.transcribe?.transcribing || current?.transcribe?.transcribing), // therefore, condition added to prevent false firings of #meeting:recording:stopped upon first joining a meeting
 
+      hasHesiodLLMIdChanged:
+        current?.transcribe &&
+        !isEqual(previous?.transcribe?.hesiodLlmId, current?.transcribe?.hesiodLlmId) &&
+        !!(previous?.transcribe?.hesiodLlmId || current?.transcribe?.hesiodLlmId),
+
       hasTranscribeSpokenLanguageChanged:
         current?.transcribe &&
         !isEqual(previous?.transcribe?.spokenLanguage, current?.transcribe?.spokenLanguage) &&