@webex/internal-plugin-metrics 3.0.0-beta.19 → 3.0.0-beta.190

package/dist/new-metrics.js

@@ -0,0 +1,185 @@
+"use strict";
+
+var _Reflect$construct = require("@babel/runtime-corejs2/core-js/reflect/construct");
+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.default = void 0;
+var _classCallCheck2 = _interopRequireDefault(require("@babel/runtime-corejs2/helpers/classCallCheck"));
+var _createClass2 = _interopRequireDefault(require("@babel/runtime-corejs2/helpers/createClass"));
+var _assertThisInitialized2 = _interopRequireDefault(require("@babel/runtime-corejs2/helpers/assertThisInitialized"));
+var _inherits2 = _interopRequireDefault(require("@babel/runtime-corejs2/helpers/inherits"));
+var _possibleConstructorReturn2 = _interopRequireDefault(require("@babel/runtime-corejs2/helpers/possibleConstructorReturn"));
+var _getPrototypeOf2 = _interopRequireDefault(require("@babel/runtime-corejs2/helpers/getPrototypeOf"));
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime-corejs2/helpers/defineProperty"));
+var _webexCore = require("@webex/webex-core");
+var _callDiagnosticMetrics = _interopRequireDefault(require("./call-diagnostic/call-diagnostic-metrics"));
+var _callDiagnosticMetricsLatencies = _interopRequireDefault(require("./call-diagnostic/call-diagnostic-metrics-latencies"));
+function _createSuper(Derived) { var hasNativeReflectConstruct = _isNativeReflectConstruct(); return function _createSuperInternal() { var Super = (0, _getPrototypeOf2.default)(Derived), result; if (hasNativeReflectConstruct) { var NewTarget = (0, _getPrototypeOf2.default)(this).constructor; result = _Reflect$construct(Super, arguments, NewTarget); } else { result = Super.apply(this, arguments); } return (0, _possibleConstructorReturn2.default)(this, result); }; }
+function _isNativeReflectConstruct() { if (typeof Reflect === "undefined" || !_Reflect$construct) return false; if (_Reflect$construct.sham) return false; if (typeof Proxy === "function") return true; try { Boolean.prototype.valueOf.call(_Reflect$construct(Boolean, [], function () {})); return true; } catch (e) { return false; } }
+/**
+ * Metrics plugin to centralize all types of metrics.
+ * @class
+ */
+var Metrics = /*#__PURE__*/function (_WebexPlugin) {
+  (0, _inherits2.default)(Metrics, _WebexPlugin);
+  var _super = _createSuper(Metrics);
+  // eslint-disable-next-line no-use-before-define
+
+  // Call Diagnostic latencies
+
+  // Helper classes to handle the different types of metrics
+
+  /**
+   * Constructor
+   * @param args
+   * @constructor
+   * @private
+   * @returns
+   */
+  function Metrics() {
+    var _this;
+    (0, _classCallCheck2.default)(this, Metrics);
+    for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
+      args[_key] = arguments[_key];
+    }
+    _this = _super.call.apply(_super, [this].concat(args));
+    (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "callDiagnosticLatencies", void 0);
+    (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "callDiagnosticMetrics", void 0);
+    _this.onReady();
+    return _this;
+  }
+
+  /**
+   * On Ready
+   */
+  (0, _createClass2.default)(Metrics, [{
+    key: "onReady",
+    value: function onReady() {
+      var _this2 = this;
+      // @ts-ignore
+      this.webex.once('ready', function () {
+        // @ts-ignore
+        _this2.callDiagnosticMetrics = new _callDiagnosticMetrics.default({}, {
+          parent: _this2.webex
+        });
+        // @ts-ignore
+        _this2.callDiagnosticLatencies = new _callDiagnosticMetricsLatencies.default({}, {
+          parent: _this2.webex
+        });
+      });
+    }
+
+    /**
+     * Used for internal purposes only
+     * @param args
+     */
+  }, {
+    key: "submitInternalEvent",
+    value: function submitInternalEvent(_ref) {
+      var name = _ref.name,
+        payload = _ref.payload,
+        options = _ref.options;
+      if (name === 'internal.reset.join.latencies') {
+        this.callDiagnosticLatencies.clearTimestamps();
+      } else {
+        this.callDiagnosticLatencies.saveTimestamp({
+          key: name
+        });
+      }
+    }
+
+    /**
+     * Behavioral event
+     * @param args
+     */
+  }, {
+    key: "submitBehavioralEvent",
+    value: function submitBehavioralEvent(_ref2) {
+      var name = _ref2.name,
+        payload = _ref2.payload,
+        options = _ref2.options;
+      this.callDiagnosticLatencies.saveTimestamp({
+        key: name
+      });
+      throw new Error('Not implemented.');
+    }
+
+    /**
+     * Operational event
+     * @param args
+     */
+  }, {
+    key: "submitOperationalEvent",
+    value: function submitOperationalEvent(_ref3) {
+      var name = _ref3.name,
+        payload = _ref3.payload,
+        options = _ref3.options;
+      throw new Error('Not implemented.');
+    }
+
+    /**
+     * Call Analyzer: Media Quality Event
+     * @param args
+     */
+  }, {
+    key: "submitMQE",
+    value: function submitMQE(_ref4) {
+      var name = _ref4.name,
+        payload = _ref4.payload,
+        options = _ref4.options;
+      this.callDiagnosticLatencies.saveTimestamp({
+        key: name
+      });
+      this.callDiagnosticMetrics.submitMQE({
+        name: name,
+        payload: payload,
+        options: options
+      });
+    }
+
+    /**
+     * Call Analyzer: Feature Usage Event
+     * @param args
+     */
+  }, {
+    key: "submitFeatureEvent",
+    value: function submitFeatureEvent(_ref5) {
+      var name = _ref5.name,
+        payload = _ref5.payload,
+        options = _ref5.options;
+      throw new Error('Not implemented.');
+    }
+
+    /**
+     * Call Analyzer: Client Event
+     * @public
+     * @param args
+     */
+  }, {
+    key: "submitClientEvent",
+    value: function submitClientEvent(_ref6) {
+      var name = _ref6.name,
+        payload = _ref6.payload,
+        options = _ref6.options;
+      this.callDiagnosticLatencies.saveTimestamp({
+        key: name,
+        options: {
+          meetingId: options === null || options === void 0 ? void 0 : options.meetingId
+        }
+      });
+      this.callDiagnosticMetrics.submitClientEvent({
+        name: name,
+        payload: payload,
+        options: options
+      });
+    }
+  }]);
+  return Metrics;
+}(_webexCore.WebexPlugin);
+(0, _defineProperty2.default)(Metrics, "instance", void 0);
+var _default = Metrics;
+exports.default = _default;
+//# sourceMappingURL=new-metrics.js.map

package/dist/new-metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["Metrics","args","onReady","webex","once","callDiagnosticMetrics","CallDiagnosticMetrics","parent","callDiagnosticLatencies","CallDiagnosticLatencies","name","payload","options","clearTimestamps","saveTimestamp","key","Error","submitMQE","meetingId","submitClientEvent","WebexPlugin"],"sources":["new-metrics.ts"],"sourcesContent":["/* eslint-disable @typescript-eslint/no-unused-vars */\n/* eslint-disable class-methods-use-this */\n/* eslint-disable valid-jsdoc */\n\n// @ts-ignore\nimport {WebexPlugin} from '@webex/webex-core';\n\nimport CallDiagnosticMetrics from './call-diagnostic/call-diagnostic-metrics';\nimport {\n  RecursivePartial,\n  ClientEvent,\n  FeatureEvent,\n  BehavioralEvent,\n  OperationalEvent,\n  MediaQualityEvent,\n  InternalEvent,\n  SubmitClientEventOptions,\n} from './metrics.types';\nimport CallDiagnosticLatencies from './call-diagnostic/call-diagnostic-metrics-latencies';\n\n/**\n * Metrics plugin to centralize all types of metrics.\n * @class\n */\nclass Metrics extends WebexPlugin {\n  // eslint-disable-next-line no-use-before-define\n  static instance: Metrics;\n\n  // Call Diagnostic latencies\n  callDiagnosticLatencies: CallDiagnosticLatencies;\n  // Helper classes to handle the different types of metrics\n  callDiagnosticMetrics: CallDiagnosticMetrics;\n\n  /**\n   * Constructor\n   * @param args\n   * @constructor\n   * @private\n   * @returns\n   */\n  constructor(...args) {\n    super(...args);\n\n    this.onReady();\n  }\n\n  /**\n   * On Ready\n   */\n  private onReady() {\n    // @ts-ignore\n    this.webex.once('ready', () => {\n      // @ts-ignore\n      this.callDiagnosticMetrics = new CallDiagnosticMetrics({}, {parent: this.webex});\n      // @ts-ignore\n      this.callDiagnosticLatencies = new CallDiagnosticLatencies({}, {parent: this.webex});\n    });\n  }\n\n  /**\n   * Used for internal purposes only\n   * @param args\n   */\n  submitInternalEvent({\n    name,\n    payload,\n    options,\n  }: {\n    name: InternalEvent['name'];\n    payload?: RecursivePartial<InternalEvent['payload']>;\n    options?: any;\n  }) {\n    if (name === 'internal.reset.join.latencies') {\n      this.callDiagnosticLatencies.clearTimestamps();\n    } else {\n      this.callDiagnosticLatencies.saveTimestamp({key: name});\n    }\n  }\n\n  /**\n   * Behavioral event\n   * @param args\n   */\n  submitBehavioralEvent({\n    name,\n    payload,\n    options,\n  }: {\n    name: BehavioralEvent['name'];\n    payload?: RecursivePartial<BehavioralEvent['payload']>;\n    options?: any;\n  }) {\n    this.callDiagnosticLatencies.saveTimestamp({key: name});\n    throw new Error('Not implemented.');\n  }\n\n  /**\n   * Operational event\n   * @param args\n   */\n  submitOperationalEvent({\n    name,\n    payload,\n    options,\n  }: {\n    name: OperationalEvent['name'];\n    payload?: RecursivePartial<OperationalEvent['payload']>;\n    options?: any;\n  }) {\n    throw new Error('Not implemented.');\n  }\n\n  /**\n   * Call Analyzer: Media Quality Event\n   * @param args\n   */\n  submitMQE({\n    name,\n    payload,\n    options,\n  }: {\n    name: MediaQualityEvent['name'];\n    payload: RecursivePartial<MediaQualityEvent['payload']> & {\n      intervals: MediaQualityEvent['payload']['intervals'];\n    };\n    options: any;\n  }) {\n    this.callDiagnosticLatencies.saveTimestamp({key: name});\n    this.callDiagnosticMetrics.submitMQE({name, payload, options});\n  }\n\n  /**\n   * Call Analyzer: Feature Usage Event\n   * @param args\n   */\n  submitFeatureEvent({\n    name,\n    payload,\n    options,\n  }: {\n    name: FeatureEvent['name'];\n    payload?: RecursivePartial<FeatureEvent['payload']>;\n    options: any;\n  }) {\n    throw new Error('Not implemented.');\n  }\n\n  /**\n   * Call Analyzer: Client Event\n   * @public\n   * @param args\n   */\n  public submitClientEvent({\n    name,\n    payload,\n    options,\n  }: {\n    name: ClientEvent['name'];\n    payload?: RecursivePartial<ClientEvent['payload']>;\n    options: SubmitClientEventOptions;\n  }) {\n    this.callDiagnosticLatencies.saveTimestamp({\n      key: name,\n      options: {meetingId: options?.meetingId},\n    });\n    this.callDiagnosticMetrics.submitClientEvent({name, payload, options});\n  }\n}\n\nexport default Metrics;\n"],"mappings":"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"}

package/dist/types/batcher.d.ts

@@ -0,0 +1,2 @@
+export default MetricsBatcher;
+declare const MetricsBatcher: any;

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

@@ -0,0 +1,2 @@
+declare const CallDiagnosticEventsBatcher: any;
+export default CallDiagnosticEventsBatcher;

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

@@ -0,0 +1,189 @@
+import { WebexPlugin } from '@webex/webex-core';
+import { MetricEventNames } from '../metrics.types';
+/**
+ * @description Helper class to store latencies timestamp and to calculate various latencies for CA.
+ * @exports
+ * @class CallDiagnosticLatencies
+ */
+export default class CallDiagnosticLatencies extends WebexPlugin {
+    latencyTimestamps: Map<MetricEventNames, number>;
+    precomputedLatencies: Map<string, number>;
+    private meetingId?;
+    /**
+     * @constructor
+     */
+    constructor(...args: any[]);
+    /**
+     * Clear timestamps
+     */
+    clearTimestamps(): void;
+    /**
+     * Associate current latencies with a meeting id
+     * @param meetingId
+     */
+    private setMeetingId;
+    /**
+     * Returns the meeting object associated with current latencies
+     * @returns meeting object
+     */
+    private getMeeting;
+    /**
+     * Store timestamp value
+     * @param key - key
+     * @param value -value
+     * @throws
+     * @returns
+     */
+    saveTimestamp({ key, value, options, }: {
+        key: MetricEventNames;
+        value?: number;
+        options?: {
+            meetingId?: string;
+        };
+    }): void;
+    /**
+     * Store precomputed latency value
+     * @param key - key
+     * @param value -value
+     * @throws
+     * @returns
+     */
+    saveLatency(key: string, value: number): void;
+    /**
+     * Store only the first timestamp value for the given key
+     * @param key - key
+     * @param  value -value
+     * @throws
+     * @returns
+     */
+    saveFirstTimestampOnly(key: MetricEventNames, value?: number): void;
+    /**
+     * Helper to calculate end - start
+     * @param a start
+     * @param b end
+     * @returns latency
+     */
+    getDiffBetweenTimestamps(a: MetricEventNames, b: MetricEventNames): number;
+    /**
+     * Meeting Info Request
+     * @note Meeting Info request happen not just in the join phase. CA requires
+     * metrics around meeting info request that are only part of join phase.
+     * This internal.* event is used to track the real timestamps
+     * (when the actual request/response happen). This is because the actual CA event is
+     * sent inside the join method on the meeting object based on some logic, but that's not exactly when
+     * those events are actually fired. The logic only confirms that they have happened, and we send them over.
+     * @returns - latency
+     */
+    getMeetingInfoReqResp(): number;
+    /**
+     * Interstitial Time
+     * @returns - latency
+     */
+    getShowInterstitialTime(): number;
+    /**
+     * Call Init Join Request
+     * @returns - latency
+     */
+    getCallInitJoinReq(): number;
+    /**
+     * Locus Join Request
+     * @returns - latency
+     */
+    getJoinReqResp(): number;
+    /**
+     * Locus Join Response Sent Received
+     * @returns - latency
+     */
+    getJoinRespSentReceived(): any;
+    /**
+     * Local SDP Generated Remote SDP REceived
+     * @returns - latency
+     */
+    getLocalSDPGenRemoteSDPRecv(): number;
+    /**
+     * ICE Setup Time
+     * @returns - latency
+     */
+    getICESetupTime(): number;
+    /**
+     * Audio ICE time
+     * @returns - latency
+     */
+    getAudioICESetupTime(): number;
+    /**
+     * Video ICE Time
+     * @returns - latency
+     */
+    getVideoICESetupTime(): number;
+    /**
+     * Share ICE Time
+     * @returns - latency
+     */
+    getShareICESetupTime(): number;
+    /**
+     * Stay Lobby Time
+     * @returns - latency
+     */
+    getStayLobbyTime(): number;
+    /**
+     * Page JMT
+     * @returns - latency
+     */
+    getPageJMT(): number;
+    /**
+     * Click To Interstitial
+     * @returns - latency
+     */
+    getClickToInterstitial(): number;
+    /**
+     * Interstitial To Join Ok
+     * @returns - latency
+     */
+    getInterstitialToJoinOK(): number;
+    /**
+     * Call Init To MediaEngineReady
+     * @returns - latency
+     */
+    getCallInitMediaEngineReady(): number;
+    /**
+     * Interstitial To Media Ok
+     * @returns - latency
+     */
+    getInterstitialToMediaOKJMT(): number;
+    /**
+     * Total JMT
+     * @returns - latency
+     */
+    getTotalJMT(): number;
+    /**
+     * Join Conf JMT
+     * @returns - latency
+     */
+    getJoinConfJMT(): number;
+    /**
+     * Total Media JMT
+     * @returns - latency
+     */
+    getTotalMediaJMT(): number;
+    /**
+     * Client JMT
+     * @returns - latency
+     */
+    getClientJMT(): number;
+    /**
+     * Audio setup delay receive
+     */
+    getAudioJoinRespRxStart(): number;
+    /**
+     * Video setup delay receive
+     */
+    getVideoJoinRespRxStart(): number;
+    /**
+     * Audio setup delay transmit
+     */
+    getAudioJoinRespTxStart(): number;
+    /**
+     * Video setup delay transmit
+     */
+    getVideoJoinRespTxStart(): number;
+}