@webex/internal-plugin-metrics 3.12.0 → 3.13.0-next.2

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

@@ -0,0 +1 @@
+{"version":3,"names":["_constants","require","_utils","ownKeys","e","r","t","_Object$keys","_Object$getOwnPropertySymbols","o","filter","_Object$getOwnPropertyDescriptor","enumerable","push","apply","_objectSpread","arguments","length","Object","forEach","_defineProperty2","default","_Object$getOwnPropertyDescriptors","_Object$defineProperties","_Object$defineProperty","PERMISSION_ENRICHMENT_RULES","exports","events","CAMERA_AND_MICROPHONE_PERMISSION_EVENTS","resolve","resources","terminal","MEDIA_TX_PERMISSION_EVENTS","payload","resolveMediaResources","CONTENT_SHARE_PERMISSION_EVENTS","resolveContentShareResources","FINAL_PERMISSION_EVENTS","resolvePermissionEnrichmentPolicy","name","_PERMISSION_ENRICHMEN","_PERMISSION_ENRICHMEN2","find","_ref","has","NO_PERMISSION_ENRICHMENT","PrivacyAndSecurityPermissionEnricher","onEnrichmentError","_classCallCheck2","_map","_createClass2","key","value","setPermission","permission","projectPrivacyAndSecurityPermission","enrich","_ref2","scope","policy","_this$lastReported$ge","privacyAndSecurityPermission","undefined","lastReported","set","get","projectedPermission","changedPermission","getChangedPermission","error","delete"],"sources":["index.ts"],"sourcesContent":["import type {ClientEventPayload, PrivacyAndSecurityPermission} from '../metrics.types';\nimport {\n  CAMERA_AND_MICROPHONE_PERMISSION_EVENTS,\n  CONTENT_SHARE_PERMISSION_EVENTS,\n  FINAL_PERMISSION_EVENTS,\n  MEDIA_TX_PERMISSION_EVENTS,\n  NO_PERMISSION_ENRICHMENT,\n} from './constants';\nimport type {\n  PermissionEnrichmentContext,\n  PermissionEnrichmentPolicy,\n  PermissionEnrichmentRule,\n} from './types';\nimport {\n  getChangedPermission,\n  projectPrivacyAndSecurityPermission,\n  resolveContentShareResources,\n  resolveMediaResources,\n} from './utils';\n\nexport const PERMISSION_ENRICHMENT_RULES = [\n  {\n    events: CAMERA_AND_MICROPHONE_PERMISSION_EVENTS,\n    resolve: () => ({resources: ['camera', 'microphone'], terminal: false}),\n  },\n  {\n    events: MEDIA_TX_PERMISSION_EVENTS,\n    resolve: (payload) => ({resources: resolveMediaResources(payload), terminal: false}),\n  },\n  {\n    events: CONTENT_SHARE_PERMISSION_EVENTS,\n    resolve: (payload) => ({\n      resources: resolveContentShareResources(payload),\n      terminal: false,\n    }),\n  },\n  {\n    events: FINAL_PERMISSION_EVENTS,\n    resolve: () => ({resources: ['camera', 'microphone', 'contentShare'], terminal: true}),\n  },\n] satisfies readonly PermissionEnrichmentRule[];\n\nconst resolvePermissionEnrichmentPolicy = (\n  name: PermissionEnrichmentContext['name'],\n  payload?: ClientEventPayload\n): PermissionEnrichmentPolicy =>\n  PERMISSION_ENRICHMENT_RULES.find(({events}) => events.has(name))?.resolve(payload) ??\n  NO_PERMISSION_ENRICHMENT;\n\n/**\n * Enriches eligible client events with relevant browser permission changes.\n */\nexport default class PrivacyAndSecurityPermissionEnricher {\n  private permission?: PrivacyAndSecurityPermission;\n\n  private lastReported = new Map<string, PrivacyAndSecurityPermission>();\n\n  private readonly onEnrichmentError: (error: unknown) => void;\n\n  /**\n   * Creates a permission enricher.\n   * @param {Function} onEnrichmentError permission enrichment error handler\n   */\n  constructor(onEnrichmentError: (error: unknown) => void) {\n    this.onEnrichmentError = onEnrichmentError;\n  }\n\n  /**\n   * Stores the latest normalized browser permission state.\n   * @param {PrivacyAndSecurityPermission} permission permission snapshot\n   * @returns {void}\n   */\n  public setPermission(permission: PrivacyAndSecurityPermission): void {\n    this.permission = projectPrivacyAndSecurityPermission(permission, [\n      'camera',\n      'microphone',\n      'contentShare',\n    ]);\n  }\n\n  /**\n   * Returns the original payload or a copy enriched with relevant permission changes.\n   * @param {PermissionEnrichmentContext} context event context and permission history scope\n   * @returns {ClientEventPayload | undefined}\n   */\n  public enrich({\n    name,\n    payload,\n    scope,\n  }: PermissionEnrichmentContext): ClientEventPayload | undefined {\n    const policy = resolvePermissionEnrichmentPolicy(name, payload);\n\n    try {\n      if (payload?.privacyAndSecurityPermission !== undefined) {\n        // An explicitly supplied permission payload is authoritative for this event.\n        if (!policy.terminal) {\n          this.lastReported.set(scope, {\n            ...this.lastReported.get(scope),\n            ...(payload.privacyAndSecurityPermission as PrivacyAndSecurityPermission),\n          });\n        }\n\n        return payload;\n      }\n\n      if (policy.resources.length === 0) {\n        return payload;\n      }\n\n      const projectedPermission = this.permission\n        ? projectPrivacyAndSecurityPermission(this.permission, policy.resources)\n        : undefined;\n\n      if (!projectedPermission) {\n        return payload;\n      }\n\n      if (policy.terminal) {\n        return {...payload, privacyAndSecurityPermission: projectedPermission};\n      }\n\n      const lastReported = this.lastReported.get(scope) ?? {};\n      const changedPermission = getChangedPermission(projectedPermission, lastReported);\n\n      if (!changedPermission) {\n        return payload;\n      }\n\n      this.lastReported.set(scope, {...lastReported, ...changedPermission});\n\n      return {...payload, privacyAndSecurityPermission: changedPermission};\n    } catch (error) {\n      this.onEnrichmentError(error);\n\n      return payload;\n    } finally {\n      if (policy.terminal) {\n        this.lastReported.delete(scope);\n      }\n    }\n  }\n}\n"],"mappings":"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","ignoreList":[]}

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

@@ -0,0 +1,7 @@
+"use strict";
+
+var _Object$defineProperty = require("@babel/runtime-corejs2/core-js/object/define-property");
+_Object$defineProperty(exports, "__esModule", {
+  value: true
+});
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":[],"sources":["types.ts"],"sourcesContent":["import type {\n  ClientEvent,\n  ClientEventPayload,\n  PrivacyAndSecurityPermissionResource,\n} from '../metrics.types';\n\nexport type PermissionEnrichmentPolicy = {\n  resources: readonly PrivacyAndSecurityPermissionResource[];\n  terminal: boolean;\n};\n\nexport type PermissionEnrichmentRule = {\n  events: ReadonlySet<ClientEvent['name']>;\n  resolve: (payload?: ClientEventPayload) => PermissionEnrichmentPolicy;\n};\n\nexport type PermissionEnrichmentContext = {\n  name: ClientEvent['name'];\n  payload?: ClientEventPayload;\n  scope: string;\n};\n"],"mappings":"","ignoreList":[]}

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 {};