@webex/internal-plugin-metrics 3.0.0-beta.389 → 3.0.0-beta.390

package/dist/call-diagnostic/call-diagnostic-metrics-latencies.js

@@ -112,14 +112,35 @@ var CallDiagnosticLatencies = /*#__PURE__*/function (_WebexPlugin) {
     /**
      * Store precomputed latency value
      * @param key - key
-     * @param value -value
+     * @param value - value
+     * @param overwrite - overwrite existing value or add it
      * @throws
      * @returns
      */
   }, {
     key: "saveLatency",
     value: function saveLatency(key, value) {
-      this.precomputedLatencies.set(key, value);
+      var overwrite = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : true;
+      var existingValue = overwrite ? 0 : this.precomputedLatencies.get(key) || 0;
+      this.precomputedLatencies.set(key, value + existingValue);
+    }
+
+    /**
+     * Measure latency for a request
+     * @param key - key
+     * @param callback - callback for which you would like to measure latency
+     * @param overwrite - overwite existing value or add to it
+     * @returns
+     */
+  }, {
+    key: "measureLatency",
+    value: function measureLatency(callback, key) {
+      var _this2 = this;
+      var overwrite = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : false;
+      var start = performance.now();
+      return callback().finally(function () {
+        _this2.saveLatency(key, performance.now() - start, overwrite);
+      });
     }
 
     /**

package/dist/call-diagnostic/call-diagnostic-metrics-latencies.js.map

@@ -1 +1 @@
-{"version":3,"names":["CallDiagnosticLatencies","args","latencyTimestamps","precomputedLatencies","clear","meetingId","webex","meetings","meetingCollection","get","undefined","key","value","Date","getTime","options","setMeetingId","saveFirstTimestampOnly","set","has","a","b","start","end","getDiffBetweenTimestamps","interstitialJoinClickTimestamp","connectedMedia","lobbyTime","getStayLobbyTime","clickToInterstitial","getClickToInterstitial","interstitialToJoinOk","getInterstitialToJoinOK","joinReqResp","getJoinReqResp","ICESetupTime","getICESetupTime","joinConfJMT","getJoinConfJMT","totalMediaJMT","getMeeting","allowMediaInLobby","WebexPlugin"],"sources":["call-diagnostic-metrics-latencies.ts"],"sourcesContent":["/* eslint-disable class-methods-use-this */\n/* eslint-disable valid-jsdoc */\nimport {WebexPlugin} from '@webex/webex-core';\n\nimport {MetricEventNames, PreComputedLatencies} from '../metrics.types';\n\n// we only care about client event and feature event for now\n\n/**\n * @description Helper class to store latencies timestamp and to calculate various latencies for CA.\n * @exports\n * @class CallDiagnosticLatencies\n */\nexport default class CallDiagnosticLatencies extends WebexPlugin {\n  latencyTimestamps: Map<MetricEventNames, number>;\n  precomputedLatencies: Map<PreComputedLatencies, number>;\n  // meetingId that the current latencies are for\n  private meetingId?: string;\n\n  /**\n   * @constructor\n   */\n  constructor(...args) {\n    super(...args);\n    this.latencyTimestamps = new Map();\n    this.precomputedLatencies = new Map();\n  }\n\n  /**\n   * Clear timestamps\n   */\n  public clearTimestamps() {\n    this.latencyTimestamps.clear();\n  }\n\n  /**\n   * Associate current latencies with a meeting id\n   * @param meetingId\n   */\n  private setMeetingId(meetingId: string) {\n    this.meetingId = meetingId;\n  }\n\n  /**\n   * Returns the meeting object associated with current latencies\n   * @returns meeting object\n   */\n  private getMeeting() {\n    if (this.meetingId) {\n      // @ts-ignore\n      return this.webex.meetings.meetingCollection.get(this.meetingId);\n    }\n\n    return undefined;\n  }\n\n  /**\n   * Store timestamp value\n   * @param key - key\n   * @param value -value\n   * @throws\n   * @returns\n   */\n  public saveTimestamp({\n    key,\n    value = new Date().getTime(),\n    options = {},\n  }: {\n    key: MetricEventNames;\n    value?: number;\n    options?: {meetingId?: string};\n  }) {\n    // save the meetingId so we can use the meeting object in latency calculations if needed\n    const {meetingId} = options;\n    if (meetingId) {\n      this.setMeetingId(meetingId);\n    }\n    // for some events we're only interested in the first timestamp not last\n    // as these events can happen multiple times\n    if (\n      key === 'client.media.rx.start' ||\n      key === 'client.media.tx.start' ||\n      key === 'internal.client.meetinginfo.request' ||\n      key === 'internal.client.meetinginfo.response'\n    ) {\n      this.saveFirstTimestampOnly(key, value);\n    } else {\n      this.latencyTimestamps.set(key, value);\n    }\n  }\n\n  /**\n   * Store precomputed latency value\n   * @param key - key\n   * @param value -value\n   * @throws\n   * @returns\n   */\n  public saveLatency(key: PreComputedLatencies, value: number) {\n    this.precomputedLatencies.set(key, value);\n  }\n\n  /**\n   * Store only the first timestamp value for the given key\n   * @param key - key\n   * @param  value -value\n   * @throws\n   * @returns\n   */\n  saveFirstTimestampOnly(key: MetricEventNames, value: number = new Date().getTime()) {\n    if (this.latencyTimestamps.has(key)) {\n      return;\n    }\n    this.latencyTimestamps.set(key, value);\n  }\n\n  /**\n   * Helper to calculate end - start\n   * @param a start\n   * @param b end\n   * @returns latency\n   */\n  public getDiffBetweenTimestamps(a: MetricEventNames, b: MetricEventNames) {\n    const start = this.latencyTimestamps.get(a);\n    const end = this.latencyTimestamps.get(b);\n    if (start && end) {\n      return end - start;\n    }\n\n    return undefined;\n  }\n\n  /**\n   * Meeting Info Request\n   * @note Meeting Info request happen not just in the join phase. CA requires\n   * metrics around meeting info request that are only part of join phase.\n   * This internal.* event is used to track the real timestamps\n   * (when the actual request/response happen). This is because the actual CA event is\n   * sent inside the join method on the meeting object based on some logic, but that's not exactly when\n   * those events are actually fired. The logic only confirms that they have happened, and we send them over.\n   * @returns - latency\n   */\n  public getMeetingInfoReqResp() {\n    return this.getDiffBetweenTimestamps(\n      'internal.client.meetinginfo.request',\n      'internal.client.meetinginfo.response'\n    );\n  }\n\n  /**\n   * Interstitial Time\n   * @returns - latency\n   */\n  public getShowInterstitialTime() {\n    return this.getDiffBetweenTimestamps(\n      'client.interstitial-window.start-launch',\n      'internal.client.interstitial-window.click.joinbutton'\n    );\n  }\n\n  /**\n   * Device Register Time\n   * @returns - latency\n   */\n  public getRegisterWDMDeviceJMT() {\n    return this.getDiffBetweenTimestamps(\n      'internal.register.device.request',\n      'internal.register.device.response'\n    );\n  }\n\n  /**\n   * Call Init Join Request\n   * @returns - latency\n   */\n  public getCallInitJoinReq() {\n    return this.getDiffBetweenTimestamps(\n      'internal.client.interstitial-window.click.joinbutton',\n      'client.locus.join.request'\n    );\n  }\n\n  /**\n   * Locus Join Request\n   * @returns - latency\n   */\n  public getJoinReqResp() {\n    return this.getDiffBetweenTimestamps('client.locus.join.request', 'client.locus.join.response');\n  }\n\n  /**\n   * Locus Join Response Sent Received\n   * @returns - latency\n   */\n  public getJoinRespSentReceived() {\n    // TODO: not clear SPARK-440554\n    return undefined;\n  }\n\n  /**\n   * Time taken to do turn discovery\n   * @returns - latency\n   */\n  public getTurnDiscoveryTime() {\n    return this.getDiffBetweenTimestamps(\n      'internal.client.add-media.turn-discovery.start',\n      'internal.client.add-media.turn-discovery.end'\n    );\n  }\n\n  /**\n   * Local SDP Generated Remote SDP REceived\n   * @returns - latency\n   */\n  public getLocalSDPGenRemoteSDPRecv() {\n    return this.getDiffBetweenTimestamps(\n      'client.media-engine.local-sdp-generated',\n      'client.media-engine.remote-sdp-received'\n    );\n  }\n\n  /**\n   * ICE Setup Time\n   * @returns - latency\n   */\n  public getICESetupTime() {\n    return this.getDiffBetweenTimestamps('client.ice.start', 'client.ice.end');\n  }\n\n  /**\n   * Audio ICE time\n   * @returns - latency\n   */\n  public getAudioICESetupTime() {\n    return this.getDiffBetweenTimestamps('client.ice.start', 'client.ice.end');\n  }\n\n  /**\n   * Video ICE Time\n   * @returns - latency\n   */\n  public getVideoICESetupTime() {\n    return this.getDiffBetweenTimestamps('client.ice.start', 'client.ice.end');\n  }\n\n  /**\n   * Share ICE Time\n   * @returns - latency\n   */\n  public getShareICESetupTime() {\n    return this.getDiffBetweenTimestamps('client.ice.start', 'client.ice.end');\n  }\n\n  /**\n   * Stay Lobby Time\n   * @returns - latency\n   */\n  public getStayLobbyTime() {\n    return this.getDiffBetweenTimestamps(\n      'client.locus.join.response',\n      'internal.host.meeting.participant.admitted'\n    );\n  }\n\n  /**\n   * Page JMT\n   * @returns - latency\n   */\n  public getPageJMT() {\n    return this.precomputedLatencies.get('internal.client.pageJMT') || undefined;\n  }\n\n  /**\n   * Download Time JMT\n   * @returns - latency\n   */\n  public getDownloadTimeJMT() {\n    return this.precomputedLatencies.get('internal.download.time') || undefined;\n  }\n\n  /**\n   * Click To Interstitial\n   * @returns - latency\n   */\n  public getClickToInterstitial() {\n    // for normal join (where green join button exists before interstitial, i.e reminder, space list etc)\n    if (this.latencyTimestamps.get('internal.client.meeting.click.joinbutton')) {\n      return this.getDiffBetweenTimestamps(\n        'internal.client.meeting.click.joinbutton',\n        'internal.client.meeting.interstitial-window.showed'\n      );\n    }\n\n    // for cross launch and guest flows\n    return this.precomputedLatencies.get('internal.click.to.interstitial') || undefined;\n  }\n\n  /**\n   * Interstitial To Join Ok\n   * @returns - latency\n   */\n  public getInterstitialToJoinOK() {\n    return this.getDiffBetweenTimestamps(\n      'internal.client.interstitial-window.click.joinbutton',\n      'client.locus.join.response'\n    );\n  }\n\n  /**\n   * Call Init To MediaEngineReady\n   * @returns - latency\n   */\n  public getCallInitMediaEngineReady() {\n    return this.getDiffBetweenTimestamps(\n      'internal.client.interstitial-window.click.joinbutton',\n      'client.media-engine.ready'\n    );\n  }\n\n  /**\n   * Interstitial To Media Ok\n   * @returns - latency\n   */\n  public getInterstitialToMediaOKJMT() {\n    const interstitialJoinClickTimestamp = this.latencyTimestamps.get(\n      'internal.client.interstitial-window.click.joinbutton'\n    );\n\n    // get the first timestamp\n    const connectedMedia = this.latencyTimestamps.get('client.ice.end');\n\n    const lobbyTime = this.getStayLobbyTime() || 0;\n\n    if (interstitialJoinClickTimestamp && connectedMedia) {\n      return connectedMedia - interstitialJoinClickTimestamp - lobbyTime;\n    }\n\n    return undefined;\n  }\n\n  /**\n   * Total JMT\n   * @returns - latency\n   */\n  public getTotalJMT() {\n    const clickToInterstitial = this.getClickToInterstitial();\n    const interstitialToJoinOk = this.getInterstitialToJoinOK();\n\n    if (clickToInterstitial && interstitialToJoinOk) {\n      return clickToInterstitial + interstitialToJoinOk;\n    }\n\n    return undefined;\n  }\n\n  /**\n   * Join Conf JMT\n   * @returns - latency\n   */\n  public getJoinConfJMT() {\n    const joinReqResp = this.getJoinReqResp();\n    const ICESetupTime = this.getICESetupTime();\n\n    if (joinReqResp && ICESetupTime) {\n      return joinReqResp + ICESetupTime;\n    }\n\n    return undefined;\n  }\n\n  /**\n   * Total Media JMT\n   * @returns - latency\n   */\n  public getTotalMediaJMT() {\n    const clickToInterstitial = this.getClickToInterstitial();\n    const interstitialToJoinOk = this.getInterstitialToJoinOK();\n    const joinConfJMT = this.getJoinConfJMT();\n    const lobbyTime = this.getStayLobbyTime();\n\n    if (clickToInterstitial && interstitialToJoinOk && joinConfJMT) {\n      const totalMediaJMT = clickToInterstitial + interstitialToJoinOk + joinConfJMT;\n      if (this.getMeeting()?.allowMediaInLobby) {\n        return totalMediaJMT;\n      }\n\n      return totalMediaJMT - lobbyTime;\n    }\n\n    return undefined;\n  }\n\n  /**\n   * Client JMT\n   * @returns - latency\n   */\n  public getClientJMT() {\n    const interstitialToJoinOk = this.getInterstitialToJoinOK();\n    const joinConfJMT = this.getJoinConfJMT();\n\n    if (interstitialToJoinOk && joinConfJMT) {\n      return interstitialToJoinOk - joinConfJMT;\n    }\n\n    return undefined;\n  }\n\n  /**\n   * Audio setup delay receive\n   */\n  public getAudioJoinRespRxStart() {\n    return this.getDiffBetweenTimestamps('client.locus.join.response', 'client.media.rx.start');\n  }\n\n  /**\n   * Video setup delay receive\n   */\n  public getVideoJoinRespRxStart() {\n    return this.getDiffBetweenTimestamps('client.locus.join.response', 'client.media.rx.start');\n  }\n\n  /**\n   * Audio setup delay transmit\n   */\n  public getAudioJoinRespTxStart() {\n    return this.getDiffBetweenTimestamps('client.locus.join.response', 'client.media.tx.start');\n  }\n\n  /**\n   * Video setup delay transmit\n   */\n  public getVideoJoinRespTxStart() {\n    return this.getDiffBetweenTimestamps('client.locus.join.response', 'client.media.tx.start');\n  }\n}\n"],"mappings":"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"}
+{"version":3,"names":["CallDiagnosticLatencies","args","latencyTimestamps","precomputedLatencies","clear","meetingId","webex","meetings","meetingCollection","get","undefined","key","value","Date","getTime","options","setMeetingId","saveFirstTimestampOnly","set","overwrite","existingValue","callback","start","performance","now","finally","saveLatency","has","a","b","end","getDiffBetweenTimestamps","interstitialJoinClickTimestamp","connectedMedia","lobbyTime","getStayLobbyTime","clickToInterstitial","getClickToInterstitial","interstitialToJoinOk","getInterstitialToJoinOK","joinReqResp","getJoinReqResp","ICESetupTime","getICESetupTime","joinConfJMT","getJoinConfJMT","totalMediaJMT","getMeeting","allowMediaInLobby","WebexPlugin"],"sources":["call-diagnostic-metrics-latencies.ts"],"sourcesContent":["/* eslint-disable class-methods-use-this */\n/* eslint-disable valid-jsdoc */\nimport {WebexPlugin} from '@webex/webex-core';\n\nimport {MetricEventNames, PreComputedLatencies} from '../metrics.types';\n\n// we only care about client event and feature event for now\n\n/**\n * @description Helper class to store latencies timestamp and to calculate various latencies for CA.\n * @exports\n * @class CallDiagnosticLatencies\n */\nexport default class CallDiagnosticLatencies extends WebexPlugin {\n  latencyTimestamps: Map<MetricEventNames, number>;\n  precomputedLatencies: Map<PreComputedLatencies, number>;\n  // meetingId that the current latencies are for\n  private meetingId?: string;\n\n  /**\n   * @constructor\n   */\n  constructor(...args) {\n    super(...args);\n    this.latencyTimestamps = new Map();\n    this.precomputedLatencies = new Map();\n  }\n\n  /**\n   * Clear timestamps\n   */\n  public clearTimestamps() {\n    this.latencyTimestamps.clear();\n  }\n\n  /**\n   * Associate current latencies with a meeting id\n   * @param meetingId\n   */\n  private setMeetingId(meetingId: string) {\n    this.meetingId = meetingId;\n  }\n\n  /**\n   * Returns the meeting object associated with current latencies\n   * @returns meeting object\n   */\n  private getMeeting() {\n    if (this.meetingId) {\n      // @ts-ignore\n      return this.webex.meetings.meetingCollection.get(this.meetingId);\n    }\n\n    return undefined;\n  }\n\n  /**\n   * Store timestamp value\n   * @param key - key\n   * @param value -value\n   * @throws\n   * @returns\n   */\n  public saveTimestamp({\n    key,\n    value = new Date().getTime(),\n    options = {},\n  }: {\n    key: MetricEventNames;\n    value?: number;\n    options?: {meetingId?: string};\n  }) {\n    // save the meetingId so we can use the meeting object in latency calculations if needed\n    const {meetingId} = options;\n    if (meetingId) {\n      this.setMeetingId(meetingId);\n    }\n    // for some events we're only interested in the first timestamp not last\n    // as these events can happen multiple times\n    if (\n      key === 'client.media.rx.start' ||\n      key === 'client.media.tx.start' ||\n      key === 'internal.client.meetinginfo.request' ||\n      key === 'internal.client.meetinginfo.response'\n    ) {\n      this.saveFirstTimestampOnly(key, value);\n    } else {\n      this.latencyTimestamps.set(key, value);\n    }\n  }\n\n  /**\n   * Store precomputed latency value\n   * @param key - key\n   * @param value - value\n   * @param overwrite - overwrite existing value or add it\n   * @throws\n   * @returns\n   */\n  public saveLatency(key: PreComputedLatencies, value: number, overwrite = true) {\n    const existingValue = overwrite ? 0 : this.precomputedLatencies.get(key) || 0;\n    this.precomputedLatencies.set(key, value + existingValue);\n  }\n\n  /**\n   * Measure latency for a request\n   * @param key - key\n   * @param callback - callback for which you would like to measure latency\n   * @param overwrite - overwite existing value or add to it\n   * @returns\n   */\n  public measureLatency(\n    callback: () => Promise<any>,\n    key: PreComputedLatencies,\n    overwrite = false\n  ) {\n    const start = performance.now();\n\n    return callback().finally(() => {\n      this.saveLatency(key, performance.now() - start, overwrite);\n    });\n  }\n\n  /**\n   * Store only the first timestamp value for the given key\n   * @param key - key\n   * @param  value -value\n   * @throws\n   * @returns\n   */\n  saveFirstTimestampOnly(key: MetricEventNames, value: number = new Date().getTime()) {\n    if (this.latencyTimestamps.has(key)) {\n      return;\n    }\n    this.latencyTimestamps.set(key, value);\n  }\n\n  /**\n   * Helper to calculate end - start\n   * @param a start\n   * @param b end\n   * @returns latency\n   */\n  public getDiffBetweenTimestamps(a: MetricEventNames, b: MetricEventNames) {\n    const start = this.latencyTimestamps.get(a);\n    const end = this.latencyTimestamps.get(b);\n    if (start && end) {\n      return end - start;\n    }\n\n    return undefined;\n  }\n\n  /**\n   * Meeting Info Request\n   * @note Meeting Info request happen not just in the join phase. CA requires\n   * metrics around meeting info request that are only part of join phase.\n   * This internal.* event is used to track the real timestamps\n   * (when the actual request/response happen). This is because the actual CA event is\n   * sent inside the join method on the meeting object based on some logic, but that's not exactly when\n   * those events are actually fired. The logic only confirms that they have happened, and we send them over.\n   * @returns - latency\n   */\n  public getMeetingInfoReqResp() {\n    return this.getDiffBetweenTimestamps(\n      'internal.client.meetinginfo.request',\n      'internal.client.meetinginfo.response'\n    );\n  }\n\n  /**\n   * Interstitial Time\n   * @returns - latency\n   */\n  public getShowInterstitialTime() {\n    return this.getDiffBetweenTimestamps(\n      'client.interstitial-window.start-launch',\n      'internal.client.interstitial-window.click.joinbutton'\n    );\n  }\n\n  /**\n   * Device Register Time\n   * @returns - latency\n   */\n  public getRegisterWDMDeviceJMT() {\n    return this.getDiffBetweenTimestamps(\n      'internal.register.device.request',\n      'internal.register.device.response'\n    );\n  }\n\n  /**\n   * Call Init Join Request\n   * @returns - latency\n   */\n  public getCallInitJoinReq() {\n    return this.getDiffBetweenTimestamps(\n      'internal.client.interstitial-window.click.joinbutton',\n      'client.locus.join.request'\n    );\n  }\n\n  /**\n   * Locus Join Request\n   * @returns - latency\n   */\n  public getJoinReqResp() {\n    return this.getDiffBetweenTimestamps('client.locus.join.request', 'client.locus.join.response');\n  }\n\n  /**\n   * Locus Join Response Sent Received\n   * @returns - latency\n   */\n  public getJoinRespSentReceived() {\n    // TODO: not clear SPARK-440554\n    return undefined;\n  }\n\n  /**\n   * Time taken to do turn discovery\n   * @returns - latency\n   */\n  public getTurnDiscoveryTime() {\n    return this.getDiffBetweenTimestamps(\n      'internal.client.add-media.turn-discovery.start',\n      'internal.client.add-media.turn-discovery.end'\n    );\n  }\n\n  /**\n   * Local SDP Generated Remote SDP REceived\n   * @returns - latency\n   */\n  public getLocalSDPGenRemoteSDPRecv() {\n    return this.getDiffBetweenTimestamps(\n      'client.media-engine.local-sdp-generated',\n      'client.media-engine.remote-sdp-received'\n    );\n  }\n\n  /**\n   * ICE Setup Time\n   * @returns - latency\n   */\n  public getICESetupTime() {\n    return this.getDiffBetweenTimestamps('client.ice.start', 'client.ice.end');\n  }\n\n  /**\n   * Audio ICE time\n   * @returns - latency\n   */\n  public getAudioICESetupTime() {\n    return this.getDiffBetweenTimestamps('client.ice.start', 'client.ice.end');\n  }\n\n  /**\n   * Video ICE Time\n   * @returns - latency\n   */\n  public getVideoICESetupTime() {\n    return this.getDiffBetweenTimestamps('client.ice.start', 'client.ice.end');\n  }\n\n  /**\n   * Share ICE Time\n   * @returns - latency\n   */\n  public getShareICESetupTime() {\n    return this.getDiffBetweenTimestamps('client.ice.start', 'client.ice.end');\n  }\n\n  /**\n   * Stay Lobby Time\n   * @returns - latency\n   */\n  public getStayLobbyTime() {\n    return this.getDiffBetweenTimestamps(\n      'client.locus.join.response',\n      'internal.host.meeting.participant.admitted'\n    );\n  }\n\n  /**\n   * Page JMT\n   * @returns - latency\n   */\n  public getPageJMT() {\n    return this.precomputedLatencies.get('internal.client.pageJMT') || undefined;\n  }\n\n  /**\n   * Download Time JMT\n   * @returns - latency\n   */\n  public getDownloadTimeJMT() {\n    return this.precomputedLatencies.get('internal.download.time') || undefined;\n  }\n\n  /**\n   * Click To Interstitial\n   * @returns - latency\n   */\n  public getClickToInterstitial() {\n    // for normal join (where green join button exists before interstitial, i.e reminder, space list etc)\n    if (this.latencyTimestamps.get('internal.client.meeting.click.joinbutton')) {\n      return this.getDiffBetweenTimestamps(\n        'internal.client.meeting.click.joinbutton',\n        'internal.client.meeting.interstitial-window.showed'\n      );\n    }\n\n    // for cross launch and guest flows\n    return this.precomputedLatencies.get('internal.click.to.interstitial') || undefined;\n  }\n\n  /**\n   * Interstitial To Join Ok\n   * @returns - latency\n   */\n  public getInterstitialToJoinOK() {\n    return this.getDiffBetweenTimestamps(\n      'internal.client.interstitial-window.click.joinbutton',\n      'client.locus.join.response'\n    );\n  }\n\n  /**\n   * Call Init To MediaEngineReady\n   * @returns - latency\n   */\n  public getCallInitMediaEngineReady() {\n    return this.getDiffBetweenTimestamps(\n      'internal.client.interstitial-window.click.joinbutton',\n      'client.media-engine.ready'\n    );\n  }\n\n  /**\n   * Interstitial To Media Ok\n   * @returns - latency\n   */\n  public getInterstitialToMediaOKJMT() {\n    const interstitialJoinClickTimestamp = this.latencyTimestamps.get(\n      'internal.client.interstitial-window.click.joinbutton'\n    );\n\n    // get the first timestamp\n    const connectedMedia = this.latencyTimestamps.get('client.ice.end');\n\n    const lobbyTime = this.getStayLobbyTime() || 0;\n\n    if (interstitialJoinClickTimestamp && connectedMedia) {\n      return connectedMedia - interstitialJoinClickTimestamp - lobbyTime;\n    }\n\n    return undefined;\n  }\n\n  /**\n   * Total JMT\n   * @returns - latency\n   */\n  public getTotalJMT() {\n    const clickToInterstitial = this.getClickToInterstitial();\n    const interstitialToJoinOk = this.getInterstitialToJoinOK();\n\n    if (clickToInterstitial && interstitialToJoinOk) {\n      return clickToInterstitial + interstitialToJoinOk;\n    }\n\n    return undefined;\n  }\n\n  /**\n   * Join Conf JMT\n   * @returns - latency\n   */\n  public getJoinConfJMT() {\n    const joinReqResp = this.getJoinReqResp();\n    const ICESetupTime = this.getICESetupTime();\n\n    if (joinReqResp && ICESetupTime) {\n      return joinReqResp + ICESetupTime;\n    }\n\n    return undefined;\n  }\n\n  /**\n   * Total Media JMT\n   * @returns - latency\n   */\n  public getTotalMediaJMT() {\n    const clickToInterstitial = this.getClickToInterstitial();\n    const interstitialToJoinOk = this.getInterstitialToJoinOK();\n    const joinConfJMT = this.getJoinConfJMT();\n    const lobbyTime = this.getStayLobbyTime();\n\n    if (clickToInterstitial && interstitialToJoinOk && joinConfJMT) {\n      const totalMediaJMT = clickToInterstitial + interstitialToJoinOk + joinConfJMT;\n      if (this.getMeeting()?.allowMediaInLobby) {\n        return totalMediaJMT;\n      }\n\n      return totalMediaJMT - lobbyTime;\n    }\n\n    return undefined;\n  }\n\n  /**\n   * Client JMT\n   * @returns - latency\n   */\n  public getClientJMT() {\n    const interstitialToJoinOk = this.getInterstitialToJoinOK();\n    const joinConfJMT = this.getJoinConfJMT();\n\n    if (interstitialToJoinOk && joinConfJMT) {\n      return interstitialToJoinOk - joinConfJMT;\n    }\n\n    return undefined;\n  }\n\n  /**\n   * Audio setup delay receive\n   */\n  public getAudioJoinRespRxStart() {\n    return this.getDiffBetweenTimestamps('client.locus.join.response', 'client.media.rx.start');\n  }\n\n  /**\n   * Video setup delay receive\n   */\n  public getVideoJoinRespRxStart() {\n    return this.getDiffBetweenTimestamps('client.locus.join.response', 'client.media.rx.start');\n  }\n\n  /**\n   * Audio setup delay transmit\n   */\n  public getAudioJoinRespTxStart() {\n    return this.getDiffBetweenTimestamps('client.locus.join.response', 'client.media.tx.start');\n  }\n\n  /**\n   * Video setup delay transmit\n   */\n  public getVideoJoinRespTxStart() {\n    return this.getDiffBetweenTimestamps('client.locus.join.response', 'client.media.tx.start');\n  }\n}\n"],"mappings":"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"}

package/dist/metrics.js

@@ -165,7 +165,7 @@ var Metrics = _webexCore.WebexPlugin.extend({
       });
     });
   },
-  version: "3.0.0-beta.389"
+  version: "3.0.0-beta.390"
 });
 var _default = Metrics;
 exports.default = _default;

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

@@ -44,11 +44,20 @@ export default class CallDiagnosticLatencies extends WebexPlugin {
     /**
      * Store precomputed latency value
      * @param key - key
-     * @param value -value
+     * @param value - value
+     * @param overwrite - overwrite existing value or add it
      * @throws
      * @returns
      */
-    saveLatency(key: PreComputedLatencies, value: number): void;
+    saveLatency(key: PreComputedLatencies, value: number, overwrite?: boolean): void;
+    /**
+     * Measure latency for a request
+     * @param key - key
+     * @param callback - callback for which you would like to measure latency
+     * @param overwrite - overwite existing value or add to it
+     * @returns
+     */
+    measureLatency(callback: () => Promise<any>, key: PreComputedLatencies, overwrite?: boolean): Promise<any>;
     /**
      * Store only the first timestamp value for the given key
      * @param key - key

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webex/internal-plugin-metrics",
-  "version": "3.0.0-beta.389",
+  "version": "3.0.0-beta.390",
   "description": "",
   "license": "MIT",
   "main": "dist/index.js",
@@ -28,14 +28,14 @@
     "build": "yarn run -T tsc --declaration true --declarationDir ./dist/types"
   },
   "dependencies": {
-    "@webex/common": "3.0.0-beta.389",
-    "@webex/common-timers": "3.0.0-beta.389",
+    "@webex/common": "3.0.0-beta.390",
+    "@webex/common-timers": "3.0.0-beta.390",
     "@webex/event-dictionary-ts": "^1.0.1329",
-    "@webex/internal-plugin-device": "3.0.0-beta.389",
-    "@webex/internal-plugin-metrics": "3.0.0-beta.389",
-    "@webex/test-helper-chai": "3.0.0-beta.389",
-    "@webex/test-helper-mock-webex": "3.0.0-beta.389",
-    "@webex/webex-core": "3.0.0-beta.389",
+    "@webex/internal-plugin-device": "3.0.0-beta.390",
+    "@webex/internal-plugin-metrics": "3.0.0-beta.390",
+    "@webex/test-helper-chai": "3.0.0-beta.390",
+    "@webex/test-helper-mock-webex": "3.0.0-beta.390",
+    "@webex/webex-core": "3.0.0-beta.390",
     "ip-anonymize": "^0.1.0",
     "lodash": "^4.17.21",
     "uuid": "^3.3.2"

package/src/call-diagnostic/call-diagnostic-metrics-latencies.ts

@@ -92,12 +92,33 @@ export default class CallDiagnosticLatencies extends WebexPlugin {
   /**
    * Store precomputed latency value
    * @param key - key
-   * @param value -value
+   * @param value - value
+   * @param overwrite - overwrite existing value or add it
    * @throws
    * @returns
    */
-  public saveLatency(key: PreComputedLatencies, value: number) {
-    this.precomputedLatencies.set(key, value);
+  public saveLatency(key: PreComputedLatencies, value: number, overwrite = true) {
+    const existingValue = overwrite ? 0 : this.precomputedLatencies.get(key) || 0;
+    this.precomputedLatencies.set(key, value + existingValue);
+  }
+
+  /**
+   * Measure latency for a request
+   * @param key - key
+   * @param callback - callback for which you would like to measure latency
+   * @param overwrite - overwite existing value or add to it
+   * @returns
+   */
+  public measureLatency(
+    callback: () => Promise<any>,
+    key: PreComputedLatencies,
+    overwrite = false
+  ) {
+    const start = performance.now();
+
+    return callback().finally(() => {
+      this.saveLatency(key, performance.now() - start, overwrite);
+    });
   }
 
   /**

package/test/unit/spec/call-diagnostic/call-diagnostic-metrics-latencies.ts

@@ -41,11 +41,41 @@ describe('internal-plugin-metrics', () => {
       assert.deepEqual(cdl.latencyTimestamps.get('client.alert.displayed'), now.getTime());
     });
 
-    it('should save latency correctly', () => {
+    it('should save latency correctly by default and overwrites', () => {
       assert.deepEqual(cdl.precomputedLatencies.size, 0);
       cdl.saveLatency('internal.client.pageJMT', 10);
       assert.deepEqual(cdl.precomputedLatencies.size, 1);
       assert.deepEqual(cdl.precomputedLatencies.get('internal.client.pageJMT'), 10);
+      cdl.saveLatency('internal.client.pageJMT', 20);
+      assert.deepEqual(cdl.precomputedLatencies.size, 1);
+      assert.deepEqual(cdl.precomputedLatencies.get('internal.client.pageJMT'), 20);
+    });
+
+    it('should overwrite latency when overwrite is true', () => {
+      assert.deepEqual(cdl.precomputedLatencies.size, 0);
+      cdl.saveLatency('internal.client.pageJMT', 10, true);
+      assert.deepEqual(cdl.precomputedLatencies.size, 1);
+      assert.deepEqual(cdl.precomputedLatencies.get('internal.client.pageJMT'), 10);
+      cdl.saveLatency('internal.client.pageJMT', 20, true);
+      assert.deepEqual(cdl.precomputedLatencies.size, 1);
+      assert.deepEqual(cdl.precomputedLatencies.get('internal.client.pageJMT'), 20);
+    });
+
+    it('should save latency correctly when overwrite is false', () => {
+      assert.deepEqual(cdl.precomputedLatencies.size, 0);
+      cdl.saveLatency('internal.client.pageJMT', 10, false);
+      assert.deepEqual(cdl.precomputedLatencies.size, 1);
+      assert.deepEqual(cdl.precomputedLatencies.get('internal.client.pageJMT'), 10);
+    });
+
+    it('should save latency correctly when overwrite is false and there is existing value', () => {
+      assert.deepEqual(cdl.precomputedLatencies.size, 0);
+      cdl.saveLatency('internal.client.pageJMT', 10);
+      assert.deepEqual(cdl.precomputedLatencies.size, 1);
+      assert.deepEqual(cdl.precomputedLatencies.get('internal.client.pageJMT'), 10);
+      cdl.saveLatency('internal.client.pageJMT', 10, false);
+      assert.deepEqual(cdl.precomputedLatencies.size, 1);
+      assert.deepEqual(cdl.precomputedLatencies.get('internal.client.pageJMT'), 20);
     });
 
     it('should save only first timestamp correctly', () => {
@@ -111,6 +141,71 @@ describe('internal-plugin-metrics', () => {
       assert.deepEqual(cdl.getMeetingInfoReqResp(), 10);
     });
 
+    describe('measureLatency', () => {
+      let clock;
+      let saveLatencySpy;
+
+      beforeEach(() => {       
+        clock = sinon.useFakeTimers(); 
+        
+        saveLatencySpy = sinon.stub(cdl, 'saveLatency');
+      });
+
+      afterEach(() => {
+        clock.restore();
+        sinon.restore();
+      });
+      
+      it('checks measureLatency with overwrite false', async () => {
+        const key = 'internal.client.pageJMT';
+        const overwrite = false;
+        const callbackStub = sinon.stub().callsFake(() => {
+          clock.tick(50);
+          return Promise.resolve('test');
+        });
+
+        const promise = cdl.measureLatency(callbackStub, 'internal.client.pageJMT', overwrite);
+
+        const resolvedValue = await promise;
+        assert.deepEqual(resolvedValue, 'test');
+        assert.calledOnceWithExactly(callbackStub);
+        assert.calledOnceWithExactly(saveLatencySpy, key, 50, overwrite)       
+      });
+
+      it('checks measureLatency with overwrite true', async () => {
+        const key = 'internal.download.time';
+        const overwrite = true;
+        const callbackStub = sinon.stub().callsFake(() => {
+          clock.tick(20);
+          return Promise.resolve('test123');
+        });
+
+        const promise = cdl.measureLatency(callbackStub, 'internal.download.time', overwrite);
+
+        const resolvedValue = await promise;
+        assert.deepEqual(resolvedValue, 'test123');
+        assert.calledOnceWithExactly(callbackStub);
+        assert.calledOnceWithExactly(saveLatencySpy, key, 20, overwrite)       
+      });
+
+      it('checks measureLatency when callBack rejects', async () => {
+        const key = 'internal.client.pageJMT';
+        const overwrite = true;
+        const error = new Error('some error');
+        const callbackStub = sinon.stub().callsFake(() => {
+          clock.tick(50);
+          return Promise.reject(error);
+        });
+
+        const promise = cdl.measureLatency(callbackStub, 'internal.client.pageJMT', overwrite);
+
+        const rejectedValue = await assert.isRejected(promise);
+        assert.deepEqual(rejectedValue, error);
+        assert.calledOnceWithExactly(callbackStub);
+        assert.calledOnceWithExactly(saveLatencySpy, key, 50, overwrite)       
+      });
+    });
+
     describe('saveTimestamp', () => {
       afterEach(() => {
         sinon.restore();