@webex/internal-plugin-metrics 3.12.0-next.4 → 3.12.0-next.41

package/dist/privacy-and-security-permission-enricher/utils.js

@@ -0,0 +1,71 @@
+"use strict";
+
+var _Object$keys2 = 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.resolveMediaResources = exports.resolveContentShareResources = exports.projectPrivacyAndSecurityPermission = exports.getChangedPermission = void 0;
+var _keys = _interopRequireDefault(require("@babel/runtime-corejs2/core-js/object/keys"));
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime-corejs2/helpers/defineProperty"));
+var _lodash = require("lodash");
+function ownKeys(e, r) { var t = _Object$keys2(e); if (_Object$getOwnPropertySymbols) { var o = _Object$getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return _Object$getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { (0, _defineProperty2.default)(e, r, t[r]); }) : _Object$getOwnPropertyDescriptors ? _Object$defineProperties(e, _Object$getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { _Object$defineProperty(e, r, _Object$getOwnPropertyDescriptor(t, r)); }); } return e; }
+var resolveMediaResources = exports.resolveMediaResources = function resolveMediaResources(payload) {
+  switch (payload === null || payload === void 0 ? void 0 : payload.mediaType) {
+    case 'audio':
+      return ['microphone'];
+    case 'video':
+      return ['camera'];
+    case 'share':
+      return ['contentShare'];
+    default:
+      return [];
+  }
+};
+var resolveContentShareResources = exports.resolveContentShareResources = function resolveContentShareResources(payload) {
+  if ((payload === null || payload === void 0 ? void 0 : payload.mediaType) !== 'share') {
+    return [];
+  }
+  return ['contentShare'];
+};
+var copyPermissionState = function copyPermissionState(source, target, resource) {
+  switch (resource) {
+    case 'camera':
+      if (source.camera) {
+        target.camera = _objectSpread({}, source.camera);
+      }
+      break;
+    case 'microphone':
+      if (source.microphone) {
+        target.microphone = _objectSpread({}, source.microphone);
+      }
+      break;
+    case 'contentShare':
+      if (source.contentShare) {
+        target.contentShare = _objectSpread({}, source.contentShare);
+      }
+      break;
+    default:
+      break;
+  }
+};
+var projectPrivacyAndSecurityPermission = exports.projectPrivacyAndSecurityPermission = function projectPrivacyAndSecurityPermission(permission, resources) {
+  var projectedPermission = {};
+  resources.forEach(function (resource) {
+    copyPermissionState(permission, projectedPermission, resource);
+  });
+  return (0, _keys.default)(projectedPermission).length > 0 ? projectedPermission : undefined;
+};
+var getChangedPermission = exports.getChangedPermission = function getChangedPermission(current, previous) {
+  var changedResources = (0, _keys.default)(current).filter(function (resource) {
+    return !(0, _lodash.isEqual)(current[resource], previous[resource]);
+  });
+  return projectPrivacyAndSecurityPermission(current, changedResources);
+};
+//# sourceMappingURL=utils.js.map

package/dist/privacy-and-security-permission-enricher/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_lodash","require","ownKeys","e","r","t","_Object$keys2","_Object$getOwnPropertySymbols","o","filter","_Object$getOwnPropertyDescriptor","enumerable","push","apply","_objectSpread","arguments","length","Object","forEach","_defineProperty2","default","_Object$getOwnPropertyDescriptors","_Object$defineProperties","_Object$defineProperty","resolveMediaResources","exports","payload","mediaType","resolveContentShareResources","copyPermissionState","source","target","resource","camera","microphone","contentShare","projectPrivacyAndSecurityPermission","permission","resources","projectedPermission","_keys","undefined","getChangedPermission","current","previous","changedResources","isEqual"],"sources":["utils.ts"],"sourcesContent":["import {isEqual} from 'lodash';\n\nimport type {\n  ClientEventPayload,\n  PrivacyAndSecurityPermission,\n  PrivacyAndSecurityPermissionResource,\n} from '../metrics.types';\n\nexport const resolveMediaResources = (\n  payload?: ClientEventPayload\n): PrivacyAndSecurityPermissionResource[] => {\n  switch (payload?.mediaType) {\n    case 'audio':\n      return ['microphone'];\n    case 'video':\n      return ['camera'];\n    case 'share':\n      return ['contentShare'];\n    default:\n      return [];\n  }\n};\n\nexport const resolveContentShareResources = (\n  payload?: ClientEventPayload\n): PrivacyAndSecurityPermissionResource[] => {\n  if (payload?.mediaType !== 'share') {\n    return [];\n  }\n\n  return ['contentShare'];\n};\n\nconst copyPermissionState = (\n  source: PrivacyAndSecurityPermission,\n  target: PrivacyAndSecurityPermission,\n  resource: PrivacyAndSecurityPermissionResource\n): void => {\n  switch (resource) {\n    case 'camera':\n      if (source.camera) {\n        target.camera = {...source.camera};\n      }\n      break;\n    case 'microphone':\n      if (source.microphone) {\n        target.microphone = {...source.microphone};\n      }\n      break;\n    case 'contentShare':\n      if (source.contentShare) {\n        target.contentShare = {...source.contentShare};\n      }\n      break;\n    default:\n      break;\n  }\n};\n\nexport const projectPrivacyAndSecurityPermission = (\n  permission: PrivacyAndSecurityPermission,\n  resources: readonly PrivacyAndSecurityPermissionResource[]\n): PrivacyAndSecurityPermission | undefined => {\n  const projectedPermission: PrivacyAndSecurityPermission = {};\n\n  resources.forEach((resource) => {\n    copyPermissionState(permission, projectedPermission, resource);\n  });\n\n  return Object.keys(projectedPermission).length > 0 ? projectedPermission : undefined;\n};\n\nexport const getChangedPermission = (\n  current: PrivacyAndSecurityPermission,\n  previous: PrivacyAndSecurityPermission\n): PrivacyAndSecurityPermission | undefined => {\n  const changedResources = (Object.keys(current) as PrivacyAndSecurityPermissionResource[]).filter(\n    (resource) => !isEqual(current[resource], previous[resource])\n  );\n\n  return projectPrivacyAndSecurityPermission(current, changedResources);\n};\n"],"mappings":"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","ignoreList":[]}

package/dist/types/automated-user.d.ts

@@ -0,0 +1,2 @@
+export declare const isAutomatedUserAgent: (userAgent?: string | null) => boolean;
+export declare const isAutomatedUser: () => boolean;

package/dist/types/call-diagnostic/call-diagnostic-metrics-latencies.d.ts

@@ -1,5 +1,35 @@
 import { WebexPlugin } from '@webex/webex-core';
 import { MetricEventNames, PreComputedLatencies } from '../metrics.types';
+type SaveTimestampOptions = {
+    meetingId?: string;
+    dataSetName?: string;
+    trackingId?: string;
+};
+type SaveLatencyOptions = {
+    accumulate?: boolean;
+    meetingId?: string;
+    dataSetName?: string;
+};
+type LocusSyncLatencyRecord = {
+    meetingId: string;
+    dataSetName: string;
+    randomBackoffTime: number;
+    trackingId?: string;
+    syncStart?: number;
+    hashTreeRequest?: number;
+    hashTreeResponse?: number;
+    syncRequest?: number;
+    syncResponse?: number;
+    messageReceived?: number;
+};
+/**
+ * Container for the latencies tracked for a single meeting. Locus sync is currently the only
+ * meeting-specific latency we track, but this wrapper lets us add other latency records in the
+ * future without changing the shape of `meetingLatencies`.
+ */
+type MeetingLatencyRecord = {
+    locusSync: LocusSyncLatencyRecord;
+};
 /**
  * @description Helper class to store latencies timestamp and to calculate various latencies for CA.
  * @exports
@@ -8,8 +38,12 @@ import { MetricEventNames, PreComputedLatencies } from '../metrics.types';
 export default class CallDiagnosticLatencies extends WebexPlugin {
     latencyTimestamps: Map<MetricEventNames, number>;
     precomputedLatencies: Map<PreComputedLatencies, number>;
+    meetingLatencies: Map<string, MeetingLatencyRecord[]>;
     private meetingId?;
     private MAX_INTEGER;
+    private LOCUS_SYNC_SKEW_THRESHOLD_MS;
+    private LOCUS_SYNC_PENDING_RECORD_TTL_MS;
+    private LOCUS_SYNC_MAX_RECORDS_PER_DATASET;
     /**
      * @constructor
      */
@@ -18,6 +52,164 @@ export default class CallDiagnosticLatencies extends WebexPlugin {
      * Clear timestamps
      */
     clearTimestamps(): void;
+    /**
+     * Clear tracked Locus sync latency state for a dataset.
+     *
+     * When a `trackingId` is supplied only the single record matching it is dropped, mirroring the
+     * native client which discards the individual in-progress record on a sync error (by syncId).
+     * When no `trackingId` is supplied every record for the dataset is dropped (legacy behavior).
+     *
+     * @param dataSetName dataset name
+     * @param meetingId meeting id
+     * @param trackingId optional sync tracking id to drop a single record instead of the whole dataset
+     */
+    clearLocusSyncLatency(dataSetName: string, meetingId: string, trackingId?: string): void;
+    /**
+     * Calculates Locus sync latency values from stored milestone timestamps.
+     * @param meetingId meeting id
+     * @param trackingId sync tracking id used to match the record
+     * @returns sync latency metrics
+     */
+    getLocusSyncLatency(meetingId: string, trackingId: string): {
+        totalTime: number;
+        syncMessageReceiveTime?: number;
+        syncResponseTime?: number;
+        randomBackoffTime: number;
+        hashtreePrepTime: number;
+        hashtreeResponseTime: number;
+        syncPrepTime: number;
+    };
+    /**
+     * Records the time the LLM state-update message for a Locus sync arrived. This is the milestone
+     * that gates the client.locus.sync.complete metric: the metric is emitted only for flows where
+     * the update came over LLM (aligned with the agreed requirement that body/http-only syncs do not
+     * emit). The record is matched by meeting id + tracking id, regardless of which other milestones
+     * are present yet, so the real arrival time is captured even if the /sync response has not landed.
+     * @param meetingId meeting id
+     * @param trackingId sync tracking id used to match the pending record
+     * @returns void
+     */
+    recordLocusSyncMessageReceived(meetingId: string, trackingId: string): void;
+    /**
+     * Complete and remove the Locus sync latency record for a meeting + tracking id.
+     *
+     * Both milestones are required, in any arrival order: the metric is emitted only once BOTH the
+     * matching LLM broadcast (messageReceived) AND the /sync response have arrived. The LLM broadcast
+     * confirms the client that issued the /sync received the resulting state update for its tracking
+     * id (so sync cancel, or a sync storm where the final broadcast echoed another client's tracking
+     * id, never emit); the /sync response is always waited for too, since the LLM message can arrive
+     * before the HTTP response. If either milestone is missing the record is kept so the other can
+     * still arrive; it is only consumed when the metric is actually emitted.
+     * @param meetingId meeting id
+     * @param trackingId sync tracking id used to match the pending record
+     * @returns completed sync latency metric payload, or undefined when not completed
+     */
+    completeLocusSyncLatency(meetingId: string, trackingId: string): {
+        dataSet: string;
+        syncLatency: {
+            totalTime: number;
+            syncMessageReceiveTime?: number;
+            syncResponseTime?: number;
+            randomBackoffTime: number;
+            hashtreePrepTime: number;
+            hashtreeResponseTime: number;
+            syncPrepTime: number;
+        };
+    };
+    /**
+     * Helper to calculate end - start for Locus sync milestones.
+     * @param record tracked milestone timestamps
+     * @param a start milestone
+     * @param b end milestone
+     * @returns latency
+     */
+    private getDiffBetweenLocusSyncTimestamps;
+    /**
+     * Get the timestamp that starts the sync prep segment.
+     * @param record tracked milestone timestamps
+     * @returns sync prep start milestone
+     */
+    private getLocusSyncPrepStart;
+    /**
+     * Round and clamp Locus sync latency values.
+     * @param latency latency value
+     * @returns rounded latency
+     */
+    private getClampedLocusSyncLatency;
+    /**
+     * Finds a Locus sync latency record for a meeting using a predicate run against each stored
+     * locusSync record.
+     * @param meetingId meeting id
+     * @param predicate matcher run against each locusSync record
+     * @param options.searchFromLatest when true, iterate from the most recently added record first
+     * @returns matching Locus sync latency record
+     */
+    private findLocusSyncRecord;
+    /**
+     * Get the Locus sync latency record for a meeting and tracking id.
+     * @param meetingId meeting id
+     * @param trackingId /sync response tracking id
+     * @returns matching Locus sync latency record
+     */
+    private getLocusSyncLatencyRecord;
+    /**
+     * Remove the Locus sync latency record for a meeting and tracking id.
+     * @param meetingId meeting id
+     * @param trackingId sync tracking id used to match the record
+     * @returns void
+     */
+    private removeLocusSyncLatencyRecord;
+    /**
+     * Prune stale never-completed Locus sync latency records for the same dataset as the record that
+     * just changed. Records are dropped when they have been pending longer than the TTL, or to keep
+     * the number of records per dataset under the safety cap (oldest pending candidates first).
+     * @param records current records for the meeting
+     * @param changedRecord the record that was just updated, used as the reference point
+     * @returns the records to keep
+     */
+    private pruneStaleLocusSyncLatencyRecords;
+    /**
+     * Get the most recent milestone timestamp stored on a Locus sync latency record, checking
+     * milestones from latest to earliest so the newest available one is returned.
+     * @param record tracked milestone timestamps
+     * @returns latest milestone timestamp, or undefined when none are set
+     */
+    private getLatestLocusSyncTimestamp;
+    /**
+     * Persist the Locus sync latency records for a meeting, deleting the meeting entry when no
+     * records remain. When pruneOptions is provided, stale records are pruned before saving.
+     * @param meetingId meeting id
+     * @param records records to save
+     * @param pruneOptions when provided, triggers stale record pruning relative to changedRecord
+     * @returns void
+     */
+    private setMeetingLatencyRecords;
+    /**
+     * Get the latest Locus sync latency record waiting for sync.start.
+     * @param meetingId meeting id
+     * @param dataSetName dataset name
+     * @returns latest pending Locus sync latency record
+     */
+    private getLatestPendingLocusSyncLatencyRecord;
+    /**
+     * Store random backoff latency for the current or next Locus sync latency record.
+     * @param meetingId meeting id
+     * @param dataSetName dataset name
+     * @param randomBackoffTime random backoff latency value
+     * @returns void
+     */
+    private saveLocusSyncBackoffLatency;
+    /**
+     * Checks if metric event name is a Locus sync latency milestone.
+     * @param key event name
+     * @returns whether event is Locus sync latency milestone
+     */
+    private isLocusSyncLatencyEvent;
+    /**
+     * Stores a Locus sync latency milestone timestamp.
+     * @param options options
+     */
+    private saveLocusSyncLatencyTimestamp;
     /**
      * Associate current latencies with a meeting id
      * @param meetingId
@@ -39,19 +231,20 @@ export default class CallDiagnosticLatencies extends WebexPlugin {
     saveTimestamp({ key, value, options, }: {
         key: MetricEventNames;
         value?: number;
-        options?: {
-            meetingId?: string;
-        };
+        options?: SaveTimestampOptions;
     }): void;
     /**
      * Store precomputed latency value
      * @param key - key
      * @param value - value
-     * @param accumulate - when it is true, it overwrites existing value with sum of the current value and the new measurement otherwise just store the new measurement
+     * @param options - store options (a legacy boolean `accumulate` flag is also accepted)
+     * @param options.accumulate - when it is true, it overwrites existing value with sum of the current value and the new measurement otherwise just store the new measurement
+     * @param options.meetingId - meeting id, only used for Locus sync latency records
+     * @param options.dataSetName - dataset name, only used for Locus sync latency records
      * @throws
      * @returns
      */
-    saveLatency(key: PreComputedLatencies, value: number, accumulate?: boolean): void;
+    saveLatency(key: PreComputedLatencies, value: number, options?: SaveLatencyOptions): void;
     /**
      * Measure latency for a request
      * @param callback - callback for which you would like to measure latency
@@ -149,6 +342,15 @@ export default class CallDiagnosticLatencies extends WebexPlugin {
      * @returns - latency
      */
     getStayLobbyTime(): number;
+    /**
+     * Stay lobby time capped by a certain timestamp.
+     * This is to handle the case where the target end timestamp could happen before the lobby is exited,
+     * for example media-engine.ready or client.ice.end
+     * This is supposed to be called AFTER the end timestamp happens
+     * @param endTimestampKey name of the target end event
+     * @returns - latency
+     */
+    getStayLobbyTimeCappedBy(endTimestampKey: MetricEventNames): number;
     /**
      * Page JMT
      * @returns - latency
@@ -258,3 +460,4 @@ export default class CallDiagnosticLatencies extends WebexPlugin {
      */
     getOtherAppApiReqResp(): number;
 }
+export {};

package/dist/types/call-diagnostic/call-diagnostic-metrics.d.ts

@@ -27,7 +27,7 @@ type GetIdentifiersOptions = {
 export default class CallDiagnosticMetrics extends StatelessWebexPlugin {
     private callDiagnosticEventsBatcher;
     private preLoginMetricsBatcher;
-    private logger;
+    private get logger();
     private hasLoggedBrowserSerial;
     private device;
     private delayedClientEvents;
@@ -36,6 +36,8 @@ export default class CallDiagnosticMetrics extends StatelessWebexPlugin {
     private isMercuryConnected;
     private eventLimitTracker;
     private eventLimitWarningsLogged;
+    private isTelemetryOptOutManual;
+    private isTelemetryOptOutAutomatic;
     validator: (options: {
         type: 'mqe' | 'ce';
         event: Event;
@@ -53,6 +55,29 @@ export default class CallDiagnosticMetrics extends StatelessWebexPlugin {
      * @returns one of 'login-ci','unverified-guest', null
      */
     getCurLoginType(): "unverified-guest" | "login-ci";
+    /**
+     * Returns the user activation state reported from the browser's navigator.userActivation API
+     * @returns object with hasBeenActive and isActive booleans, or undefined if unavailable
+     */
+    getUserActivation(): {
+        hasBeenActive: boolean;
+        isActive: boolean;
+    } | undefined;
+    /**
+     * Returns the telemetryOptOut value of the current user
+     * @returns one of 'manual', 'automatic', undefined
+     */
+    getTelemetryOptOut(): "manual" | "automatic";
+    /**
+     * Sets the manual telemetry opt-out status for the current user
+     * @param value - boolean value indicating manual telemetry opt-out status
+     */
+    setIsTelemetryOptOutManual(value: boolean): void;
+    /**
+     * Sets the automatic telemetry opt-out status for the current user
+     * @param value - boolean value indicating automatic telemetry opt-out status
+     */
+    setIsTelemetryOptOutAutomatic(value: boolean): void;
     /**
      * Returns if the meeting has converged architecture enabled
      * @param options.meetingId
@@ -84,6 +109,7 @@ export default class CallDiagnosticMetrics extends StatelessWebexPlugin {
         userAgent: string;
         buildType?: "debug" | "test" | "prod" | "tap" | "analyzer-test";
         upgradeChannel?: string;
+        upgradeSource?: string;
         instanceId?: string;
         networkType: "wifi" | "ethernet" | "cellular" | "unknown";
         localIP?: string;
@@ -106,6 +132,8 @@ export default class CallDiagnosticMetrics extends StatelessWebexPlugin {
             urlProtocolLaunchMethod?: "manual" | "auto" | "extension-fallback";
             browser?: string;
             browserVersion?: string;
+            isSupportedBrowserFamily?: boolean;
+            isOutdatedBrowserVersion?: boolean;
             clientType?: "MEETING_CENTER" | "EVENT_CENTER" | "TRAINING_CENTER" | "TEAMS_CLIENT" | "TEAMS_DEVICE" | "TEAMS_SHARE" | "SIP" | "RECORDING" | "CLOUD_AWARE_SIP" | "TEAMS_WXC_CLIENT" | "WXC_CLIENT" | "WXC_DEVICE" | "WEBEX_JS_SDK" | "VOICEA_CLIENT" | "CISCO_SIP_GW" | "WEBEX_SDK" | "CPAAS_THIRD_PARTY_SDK" | "WXC_THIRD_PARTY" | "WXCC" | "TEAMS_PHONE" | "WEBEX_RELAY";
             subClientType?: "TEAMS_DEVICE" | "SIP" | "AUTOMOTIVE_APP" | "BROWSER_EXTENSION" | "DESKTOP_APP" | "DESKTOP_APP_VDI" | "DEVICE_CURRENT" | "DEVICE_LEGACY_2020" | "HOLOGRAM_HEADSET_APP" | "HVDI_APP" | "MIXED" | "MOBILE_APP" | "MOBILE_NETWORK" | "PAGE" | "VDI_APP" | "WEB_APP" | "PHONE_NOVUM" | "PHONE_ESPRESSO" | "PHONE_BUMBLEBEE" | "SIP_PSTN";
             schedulingClientType?: "TEAMS_CLIENT" | "GOOGLE_ADDON" | "PT" | "PUBLIC_API" | "UNIFIED_PAGE" | "WEBEX_PAGE" | "GOOGLE_NOTIFICATION_CALENDAR" | "MSFT_NOTIFICATION_ADDIN" | "MSFT_NOTIFICATION_CALENDAR" | "OUTLOOK_ADDIN";
@@ -113,6 +141,10 @@ export default class CallDiagnosticMetrics extends StatelessWebexPlugin {
             clientVersionStatus?: "CURRENT" | "LEGACY" | "UNSUPPORTED";
             localClientVersion?: string;
             launcherVersion?: string;
+            installerVersion?: string;
+            installerMajorVersion?: number;
+            installerMinorVersion?: number;
+            installerRevision?: number;
             modelNumber?: string;
             joinFirstUpdateLater?: "ep-enabled" | "sp-enabled" | "not-enabled";
             standbyUsed?: boolean;
@@ -137,11 +169,12 @@ export default class CallDiagnosticMetrics extends StatelessWebexPlugin {
                 architecture: "unknown" | "intel32" | "intel64" | "amd32" | "amd64" | "arm32" | "arm64" | "armv9" | "armv8" | "armv7" | "armv6" | "x86_64" | "x86_32";
                 staticPerformance?: string;
                 clockSpeedGigaHertz?: number;
-                additionalProperties?: false;
+                additionalProperties?: never;
             };
             shareType?: "cb-normal-share" | "ce-airplay-share" | "ce-direct-share" | "ce-gui-loopback-share" | "ce-input-source-share" | "ce-input-source-share-hdmi" | "ce-input-source-share-usbc" | "ce-jpg-share" | "ce-miracast-share" | "mcs-normal-share" | "mcs-normal-audio-share" | "mcs-hfps-share" | "mcs-hfps-audio-share";
             videoDisplayMode?: "grid-view" | "active-speaker-view";
-            videoLayoutType?: "stack" | "stackWithShare" | "sideBySide" | "sideBySideWithShare" | "grid" | "floatingActive" | "floatingThumbnail" | "floatingGrid" | "overlay" | "focus" | "prominent" | "focusWithShare" | "prominentWithShare" | "equal" | "equalWithShare" | "largeGallery";
+            videoLayoutType?: "auto" | "stack" | "stackWithShare" | "sideBySide" | "sideBySideWithShare" | "grid" | "floatingActive" | "floatingThumbnail" | "floatingGrid" | "overlay" | "focus" | "prominent" | "focusWithShare" | "prominentWithShare" | "equal" | "equalWithShare" | "largeGallery" | "autoWithShare";
+            appliedLayout?: "auto" | "stack" | "stackWithShare" | "sideBySide" | "sideBySideWithShare" | "grid" | "floatingActive" | "floatingThumbnail" | "floatingGrid" | "overlay" | "focus" | "prominent" | "focusWithShare" | "prominentWithShare" | "equal" | "equalWithShare" | "largeGallery" | "autoWithShare";
             videoRenderType?: "wme" | "client_d3d" | "client_gdi";
             vdiInfo?: {};
             is64BitsClient?: boolean;
@@ -153,13 +186,24 @@ export default class CallDiagnosticMetrics extends StatelessWebexPlugin {
             vendorId?: string;
             staticPerformanceLevel?: string;
             staticPerformanceScore?: number;
-            additionalProperties?: false;
+            preInstalledTime?: string;
+            preInstalledType?: "installer" | "launcher" | "app";
+            preInstalledVersion?: string;
+            additionalProperties?: never;
+        };
+        installerInfo?: {
+            packageSuffix?: string;
+            packageArch?: string;
+            launchId?: string;
+            packageCount?: number;
+            totalSize?: number;
+            additionalProperties?: never;
         };
         emmVendorId?: string;
         isHybridMedia?: boolean;
         originData?: {};
         serviceVersion?: string;
-        additionalProperties?: false;
+        additionalProperties?: never;
     };
     /**
      * Gather identifier details for call diagnostic payload.
@@ -172,6 +216,7 @@ export default class CallDiagnosticMetrics extends StatelessWebexPlugin {
         participantId?: string;
         breakoutGroupId?: string;
         breakoutMoveId?: string;
+        breakoutTrackingId?: string;
         breakoutSessionId?: string;
         browserId?: string;
         ciExchangeTokenUrl?: string;
@@ -183,7 +228,7 @@ export default class CallDiagnosticMetrics extends StatelessWebexPlugin {
             imiAppId: string;
             sessionId: string;
             sessionInstanceId: string;
-            additionalProperties?: false;
+            additionalProperties?: never;
         };
         csdmDeviceUrl?: string;
         destinationBreakoutSessionId?: string;
@@ -200,6 +245,7 @@ export default class CallDiagnosticMetrics extends StatelessWebexPlugin {
         callId?: string;
         pairCallId?: string;
         llmWebsocketUrl?: string;
+        locusCluster?: string;
         locusId?: string;
         locusJoinUrl?: string;
         locusSessionId?: string;
@@ -217,6 +263,7 @@ export default class CallDiagnosticMetrics extends StatelessWebexPlugin {
         msteamsTenantGuid?: string;
         msteamsConferenceId?: string;
         msteamsMeetingId?: string;
+        mtid?: string;
         oauth2ClientId?: string;
         orgId?: string;
         provisionalCorrelationId?: string;
@@ -227,7 +274,7 @@ export default class CallDiagnosticMetrics extends StatelessWebexPlugin {
         sipSessionId?: {
             local?: string;
             remote?: string;
-            additionalProperties?: false;
+            additionalProperties?: never;
         };
         sipUri?: string;
         subConfId?: string;
@@ -255,13 +302,14 @@ export default class CallDiagnosticMetrics extends StatelessWebexPlugin {
         idForEndpointAB?: string;
         customerOrgId?: string;
         correlationId: string;
-        additionalProperties?: false;
+        additionalProperties?: never;
     } | {
         aggregatedBreakoutMoveId?: string;
         attendeeId?: string;
         participantId?: string;
         breakoutGroupId?: string;
         breakoutMoveId?: string;
+        breakoutTrackingId?: string;
         breakoutSessionId?: string;
         browserId?: string;
         ciExchangeTokenUrl?: string;
@@ -273,7 +321,7 @@ export default class CallDiagnosticMetrics extends StatelessWebexPlugin {
             imiAppId: string;
             sessionId: string;
             sessionInstanceId: string;
-            additionalProperties?: false;
+            additionalProperties?: never;
         };
         csdmDeviceUrl?: string;
         destinationBreakoutSessionId?: string;
@@ -290,6 +338,7 @@ export default class CallDiagnosticMetrics extends StatelessWebexPlugin {
         callId?: string;
         pairCallId?: string;
         llmWebsocketUrl?: string;
+        locusCluster?: string;
         locusId?: string;
         locusJoinUrl?: string;
         locusSessionId?: string;
@@ -307,6 +356,7 @@ export default class CallDiagnosticMetrics extends StatelessWebexPlugin {
         msteamsTenantGuid?: string;
         msteamsConferenceId?: string;
         msteamsMeetingId?: string;
+        mtid?: string;
         oauth2ClientId?: string;
         orgId?: string;
         provisionalCorrelationId?: string;
@@ -317,7 +367,7 @@ export default class CallDiagnosticMetrics extends StatelessWebexPlugin {
         sipSessionId?: {
             local?: string;
             remote?: string;
-            additionalProperties?: false;
+            additionalProperties?: never;
         };
         sipUri?: string;
         subConfId?: string;
@@ -345,13 +395,14 @@ export default class CallDiagnosticMetrics extends StatelessWebexPlugin {
         idForEndpointAB?: string;
         customerOrgId?: string;
         correlationId: string;
-        additionalProperties?: false;
+        additionalProperties?: never;
     } | {
         aggregatedBreakoutMoveId?: string;
         attendeeId?: string;
         participantId?: string;
         breakoutGroupId?: string;
         breakoutMoveId?: string;
+        breakoutTrackingId?: string;
         breakoutSessionId?: string;
         browserId?: string;
         ciExchangeTokenUrl?: string;
@@ -363,7 +414,7 @@ export default class CallDiagnosticMetrics extends StatelessWebexPlugin {
             imiAppId: string;
             sessionId: string;
             sessionInstanceId: string;
-            additionalProperties?: false;
+            additionalProperties?: never;
         };
         csdmDeviceUrl?: string;
         destinationBreakoutSessionId?: string;
@@ -380,6 +431,7 @@ export default class CallDiagnosticMetrics extends StatelessWebexPlugin {
         callId?: string;
         pairCallId?: string;
         llmWebsocketUrl?: string;
+        locusCluster?: string;
         locusId?: string;
         locusJoinUrl?: string;
         locusSessionId?: string;
@@ -397,6 +449,7 @@ export default class CallDiagnosticMetrics extends StatelessWebexPlugin {
         msteamsTenantGuid?: string;
         msteamsConferenceId?: string;
         msteamsMeetingId?: string;
+        mtid?: string;
         oauth2ClientId?: string;
         orgId?: string;
         provisionalCorrelationId?: string;
@@ -407,7 +460,7 @@ export default class CallDiagnosticMetrics extends StatelessWebexPlugin {
         sipSessionId?: {
             local?: string;
             remote?: string;
-            additionalProperties?: false;
+            additionalProperties?: never;
         };
         sipUri?: string;
         subConfId?: string;
@@ -435,7 +488,7 @@ export default class CallDiagnosticMetrics extends StatelessWebexPlugin {
         idForEndpointAB?: string;
         customerOrgId?: string;
         correlationId: string;
-        additionalProperties?: false;
+        additionalProperties?: never;
     };
     /**
      * Create diagnostic event, which can hold client event, feature event or MQE event data.

package/dist/types/call-diagnostic/config.d.ts

@@ -102,11 +102,13 @@ export declare const ERROR_DESCRIPTIONS: {
     WEBRTC_API_NOT_AVAILABLE: string;
     WDM_RESTRICTED_REGION: string;
     USER_NOT_ALLOWED_JOIN_WEBINAR: string;
+    INVALID_MEETING_INFO: string;
 };
 export declare const SERVICE_ERROR_CODES_TO_CLIENT_ERROR_CODES_MAP: {
     58400: number;
     99002: number;
     99009: number;
+    99019: number;
     58500: number;
     400001: number;
     403004: number;
@@ -134,6 +136,7 @@ export declare const SERVICE_ERROR_CODES_TO_CLIENT_ERROR_CODES_MAP: {
     423001: number;
     423005: number;
     423006: number;
+    423008: number;
     423010: number;
     423012: number;
     423013: number;
@@ -147,6 +150,7 @@ export declare const SERVICE_ERROR_CODES_TO_CLIENT_ERROR_CODES_MAP: {
     403037: number;
     403003: number;
     403030: number;
+    403106: number;
     2403001: number;
     2403002: number;
     2403003: number;

package/dist/types/config.d.ts

@@ -12,6 +12,7 @@ declare namespace _default {
         const batcherMaxCalls: number;
         const batcherMaxWait: number;
         const batcherRetryPlateau: number;
+        const batcherRetryOnNetworkError: boolean;
         const waitForServiceTimeout: number;
     }
     export { metrics_1 as metrics };