@webex/internal-plugin-metrics 3.0.0-beta.22 → 3.0.0-beta.220

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

@@ -0,0 +1,645 @@
+"use strict";
+
+var _Reflect$construct = require("@babel/runtime-corejs2/core-js/reflect/construct");
+var _Object$keys = 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.default = void 0;
+var _regenerator = _interopRequireDefault(require("@babel/runtime-corejs2/regenerator"));
+var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime-corejs2/helpers/asyncToGenerator"));
+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 _merge2 = _interopRequireDefault(require("lodash/merge"));
+var _internalPluginMetrics = require("@webex/internal-plugin-metrics");
+var _common = require("@webex/common");
+var _uuid = _interopRequireDefault(require("uuid"));
+var _webexCore = require("@webex/webex-core");
+var _callDiagnosticMetrics = require("./call-diagnostic-metrics.util");
+var _config = require("../config");
+var _callDiagnosticMetricsBatcher = _interopRequireDefault(require("./call-diagnostic-metrics-batcher"));
+var _config2 = require("./config");
+function ownKeys(object, enumerableOnly) { var keys = _Object$keys(object); if (_Object$getOwnPropertySymbols) { var symbols = _Object$getOwnPropertySymbols(object); enumerableOnly && (symbols = symbols.filter(function (sym) { return _Object$getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; }
+function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? ownKeys(Object(source), !0).forEach(function (key) { (0, _defineProperty2.default)(target, key, source[key]); }) : _Object$getOwnPropertyDescriptors ? _Object$defineProperties(target, _Object$getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function (key) { _Object$defineProperty(target, key, _Object$getOwnPropertyDescriptor(source, key)); }); } return target; }
+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; } }
+var _BrowserDetection = (0, _common.BrowserDetection)(),
+  getOSVersion = _BrowserDetection.getOSVersion,
+  getBrowserName = _BrowserDetection.getBrowserName,
+  getBrowserVersion = _BrowserDetection.getBrowserVersion;
+/**
+ * @description Util class to handle Call Analyzer Metrics
+ * @export
+ * @class CallDiagnosticMetrics
+ */
+var CallDiagnosticMetrics = /*#__PURE__*/function (_StatelessWebexPlugin) {
+  (0, _inherits2.default)(CallDiagnosticMetrics, _StatelessWebexPlugin);
+  var _super = _createSuper(CallDiagnosticMetrics);
+  // @ts-ignore
+
+  /**
+   * Constructor
+   * @param args
+   */
+  function CallDiagnosticMetrics() {
+    var _this;
+    (0, _classCallCheck2.default)(this, CallDiagnosticMetrics);
+    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));
+    // @ts-ignore
+    (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "callDiagnosticEventsBatcher", void 0);
+    _this.callDiagnosticEventsBatcher = new _callDiagnosticMetricsBatcher.default({}, {
+      parent: _this.webex
+    });
+    return _this;
+  }
+
+  /**
+   * Returns the login type of the current user
+   * @returns one of 'login-ci','unverified-guest', null
+   */
+  (0, _createClass2.default)(CallDiagnosticMetrics, [{
+    key: "getCurLoginType",
+    value: function getCurLoginType() {
+      // @ts-ignore
+      if (this.webex.canAuthorize) {
+        // @ts-ignore
+        return this.webex.credentials.isUnverifiedGuest ? 'unverified-guest' : 'login-ci';
+      }
+      return null;
+    }
+
+    /**
+     * Returns if the meeting has converged architecture enabled
+     * @param options.meetingId
+     */
+  }, {
+    key: "getIsConvergedArchitectureEnabled",
+    value: function getIsConvergedArchitectureEnabled(_ref) {
+      var meetingId = _ref.meetingId;
+      if (meetingId) {
+        var _meeting$meetingInfo;
+        // @ts-ignore
+        var meeting = this.webex.meetings.meetingCollection.get(meetingId);
+        return meeting === null || meeting === void 0 ? void 0 : (_meeting$meetingInfo = meeting.meetingInfo) === null || _meeting$meetingInfo === void 0 ? void 0 : _meeting$meetingInfo.enableConvergedArchitecture;
+      }
+      return undefined;
+    }
+
+    /**
+     * Get origin object for Call Diagnostic Event payload.
+     * @param options
+     * @param meetingId
+     * @returns
+     */
+  }, {
+    key: "getOrigin",
+    value: function getOrigin(options, meetingId) {
+      var _this$webex$meetings$, _this$webex$meetings$2, _this$webex$meetings$3, _this$webex$meetings$4, _this$webex$meetings$5, _this$webex$meetings$6;
+      var defaultClientType = // @ts-ignore
+      (_this$webex$meetings$ = this.webex.meetings.config) === null || _this$webex$meetings$ === void 0 ? void 0 : (_this$webex$meetings$2 = _this$webex$meetings$.metrics) === null || _this$webex$meetings$2 === void 0 ? void 0 : _this$webex$meetings$2.clientType;
+      var defaultSubClientType = // @ts-ignore
+      (_this$webex$meetings$3 = this.webex.meetings.config) === null || _this$webex$meetings$3 === void 0 ? void 0 : (_this$webex$meetings$4 = _this$webex$meetings$3.metrics) === null || _this$webex$meetings$4 === void 0 ? void 0 : _this$webex$meetings$4.subClientType;
+      // @ts-ignore
+      var providedClientVersion = (_this$webex$meetings$5 = this.webex.meetings.config) === null || _this$webex$meetings$5 === void 0 ? void 0 : (_this$webex$meetings$6 = _this$webex$meetings$5.metrics) === null || _this$webex$meetings$6 === void 0 ? void 0 : _this$webex$meetings$6.clientVersion;
+      // @ts-ignore
+      var defaultSDKClientVersion = "".concat(_config.CLIENT_NAME, "/").concat(this.webex.version);
+      var versionMetadata = {};
+
+      // sdk version split doesn't really make sense for now...
+      if (providedClientVersion) {
+        versionMetadata = (0, _callDiagnosticMetrics.extractVersionMetadata)(providedClientVersion);
+      }
+      if (defaultClientType && defaultSubClientType || options.clientType && options.subClientType) {
+        var _this$webex$meetings, _this$webex$meetings$7, _this$webex$meetings$8;
+        var origin = {
+          name: 'endpoint',
+          networkType: (options === null || options === void 0 ? void 0 : options.networkType) || 'unknown',
+          userAgent: (0, _callDiagnosticMetrics.userAgentToString)({
+            // @ts-ignore
+            clientName: (_this$webex$meetings = this.webex.meetings) === null || _this$webex$meetings === void 0 ? void 0 : (_this$webex$meetings$7 = _this$webex$meetings.metrics) === null || _this$webex$meetings$7 === void 0 ? void 0 : _this$webex$meetings$7.clientName,
+            // @ts-ignore
+            webexVersion: this.webex.version
+          }),
+          clientInfo: _objectSpread(_objectSpread({
+            clientType: (options === null || options === void 0 ? void 0 : options.clientType) || defaultClientType,
+            clientVersion: providedClientVersion || defaultSDKClientVersion
+          }, versionMetadata), {}, {
+            localNetworkPrefix:
+            // @ts-ignore
+            (0, _callDiagnosticMetrics.anonymizeIPAddress)((_this$webex$meetings$8 = this.webex.meetings.geoHintInfo) === null || _this$webex$meetings$8 === void 0 ? void 0 : _this$webex$meetings$8.clientAddress) || undefined,
+            osVersion: getOSVersion() || 'unknown',
+            subClientType: (options === null || options === void 0 ? void 0 : options.subClientType) || defaultSubClientType,
+            os: (0, _internalPluginMetrics.getOSNameInternal)(),
+            browser: getBrowserName(),
+            browserVersion: getBrowserVersion()
+          })
+        };
+        if (meetingId) {
+          // @ts-ignore
+          var meeting = this.webex.meetings.meetingCollection.get(meetingId);
+          if (meeting !== null && meeting !== void 0 && meeting.environment) {
+            origin.environment = meeting.environment;
+          }
+        }
+        return origin;
+      }
+      throw new Error("ClientType and SubClientType can't be undefined");
+    }
+
+    /**
+     * Gather identifier details for call diagnostic payload.
+     * @throws Error if initialization fails.
+     * @param options
+     */
+  }, {
+    key: "getIdentifiers",
+    value: function getIdentifiers(options) {
+      var _meeting$locusInfo;
+      var meeting = options.meeting,
+        mediaConnections = options.mediaConnections,
+        correlationId = options.correlationId;
+      var identifiers = {
+        correlationId: 'unknown'
+      };
+      if (meeting) {
+        identifiers.correlationId = meeting.correlationId;
+      }
+      if (correlationId) {
+        identifiers.correlationId = correlationId;
+      }
+      // @ts-ignore
+      if (this.webex.internal) {
+        // @ts-ignore
+        var device = this.webex.internal.device;
+        identifiers.userId = device.userId;
+        identifiers.deviceId = device.url;
+        identifiers.orgId = device.orgId;
+        // @ts-ignore
+        identifiers.locusUrl = this.webex.internal.services.get('locus');
+      }
+      if (meeting !== null && meeting !== void 0 && (_meeting$locusInfo = meeting.locusInfo) !== null && _meeting$locusInfo !== void 0 && _meeting$locusInfo.fullState) {
+        identifiers.locusUrl = meeting.locusUrl;
+        identifiers.locusId = meeting.locusUrl && meeting.locusUrl.split('/').pop();
+        identifiers.locusStartTime = meeting.locusInfo.fullState && meeting.locusInfo.fullState.lastActive;
+      }
+      if (mediaConnections) {
+        var _mediaConnections$, _mediaConnections$2;
+        identifiers.mediaAgentAlias = mediaConnections === null || mediaConnections === void 0 ? void 0 : (_mediaConnections$ = mediaConnections[0]) === null || _mediaConnections$ === void 0 ? void 0 : _mediaConnections$.mediaAgentAlias;
+        identifiers.mediaAgentGroupId = mediaConnections === null || mediaConnections === void 0 ? void 0 : (_mediaConnections$2 = mediaConnections[0]) === null || _mediaConnections$2 === void 0 ? void 0 : _mediaConnections$2.mediaAgentGroupId;
+      }
+      if (identifiers.correlationId === undefined) {
+        throw new Error('Identifiers initialization failed.');
+      }
+      return identifiers;
+    }
+
+    /**
+     * Create diagnostic event, which can hold client event, feature event or MQE event data.
+     * This just initiates the shared properties that are required for all the 3 event categories.
+     * @param eventData
+     * @param options
+     * @returns
+     */
+  }, {
+    key: "prepareDiagnosticEvent",
+    value: function prepareDiagnosticEvent(eventData, options) {
+      var _this$webex$meetings$9;
+      var meetingId = options.meetingId;
+      var origin = this.getOrigin(options, meetingId);
+      var event = {
+        eventId: _uuid.default.v4(),
+        version: 1,
+        origin: origin,
+        originTime: {
+          triggered: new Date().toISOString(),
+          // is overridden in prepareRequest batcher
+          sent: 'not_defined_yet'
+        },
+        // @ts-ignore
+        senderCountryCode: (_this$webex$meetings$9 = this.webex.meetings.geoHintInfo) === null || _this$webex$meetings$9 === void 0 ? void 0 : _this$webex$meetings$9.countryCode,
+        event: eventData
+      };
+
+      // sanitize (remove empty properties, CA requires it)
+      // but we don't want to sanitize MQE as most of the times
+      // values will be 0, [] etc, and they are required.
+      if (eventData.name !== 'client.mediaquality.event') {
+        (0, _callDiagnosticMetrics.clearEmptyKeysRecursively)(event);
+      }
+      return event;
+    }
+
+    /**
+     * TODO: NOT IMPLEMENTED
+     * Submit Feature Event
+     * @returns
+     */
+  }, {
+    key: "submitFeatureEvent",
+    value: function submitFeatureEvent() {
+      throw Error('Not implemented');
+    }
+
+    /**
+     * Submit Media Quality Event
+     * @param args - submit params
+     * @param arg.name - event key
+     * @param arg.payload - additional payload to be merge with the default payload
+     * @param arg.options - options
+     */
+  }, {
+    key: "submitMQE",
+    value: function submitMQE(_ref2) {
+      var name = _ref2.name,
+        payload = _ref2.payload,
+        options = _ref2.options;
+      var meetingId = options.meetingId,
+        mediaConnections = options.mediaConnections;
+
+      // events that will most likely happen in join phase
+      if (meetingId) {
+        // @ts-ignore
+        var meeting = this.webex.meetings.meetingCollection.get(meetingId);
+        if (!meeting) {
+          console.warn('Attempt to send MQE but no meeting was found...', "event: ".concat(name, ", meetingId: ").concat(meetingId));
+          // @ts-ignore
+          this.webex.internal.metrics.submitClientMetrics(_config2.CALL_DIAGNOSTIC_EVENT_FAILED_TO_SEND, {
+            fields: {
+              meetingId: meetingId,
+              name: name
+            }
+          });
+          return;
+        }
+
+        // merge identifiers
+        var identifiers = this.getIdentifiers({
+          meeting: meeting,
+          mediaConnections: meeting.mediaConnections || mediaConnections
+        });
+
+        // create media quality event object
+        var clientEventObject = {
+          name: name,
+          canProceed: true,
+          identifiers: identifiers,
+          eventData: {
+            webClientDomain: window.location.hostname
+          },
+          intervals: payload.intervals,
+          sourceMetadata: {
+            applicationSoftwareType: _config.CLIENT_NAME,
+            // @ts-ignore
+            applicationSoftwareVersion: this.webex.version,
+            mediaEngineSoftwareType: getBrowserName() || 'browser',
+            mediaEngineSoftwareVersion: getOSVersion() || 'unknown',
+            startTime: new Date().toISOString()
+          }
+        };
+
+        // merge any new properties, or override existing ones
+        clientEventObject = (0, _merge2.default)(clientEventObject, payload);
+
+        // append media quality event data to the call diagnostic event
+        var diagnosticEvent = this.prepareDiagnosticEvent(clientEventObject, options);
+        this.submitToCallDiagnostics(diagnosticEvent);
+      } else {
+        throw new Error('Media quality events cant be sent outside the context of a meeting. Meeting id is required.');
+      }
+    }
+
+    /**
+     * Return Client Event payload by client error code
+     * @param arg - get error arg
+     * @param arg.clientErrorCode
+     * @param arg.serviceErrorCode
+     * @returns
+     */
+  }, {
+    key: "getErrorPayloadForClientErrorCode",
+    value: function getErrorPayloadForClientErrorCode(_ref3) {
+      var clientErrorCode = _ref3.clientErrorCode,
+        serviceErrorCode = _ref3.serviceErrorCode,
+        serviceErrorName = _ref3.serviceErrorName;
+      var error;
+      if (clientErrorCode) {
+        var partialParsedError = _config2.CLIENT_ERROR_CODE_TO_ERROR_PAYLOAD[clientErrorCode];
+        if (partialParsedError) {
+          error = (0, _merge2.default)({
+            fatal: true,
+            shownToUser: false,
+            name: 'other',
+            category: 'other'
+          },
+          // default values
+          {
+            errorCode: clientErrorCode
+          }, serviceErrorName ? {
+            errorData: {
+              errorName: serviceErrorName
+            }
+          } : {}, {
+            serviceErrorCode: serviceErrorCode
+          }, partialParsedError);
+          return error;
+        }
+      }
+      return undefined;
+    }
+
+    /**
+     * Generate error payload for Client Event
+     * @param rawError
+     */
+  }, {
+    key: "generateClientEventErrorPayload",
+    value: function generateClientEventErrorPayload(rawError) {
+      var _rawError$error, _rawError$error$body, _rawError$body, _rawError$body2, _rawError$body3, _rawError$body3$reaso;
+      if (rawError.name) {
+        if ((0, _callDiagnosticMetrics.isBrowserMediaErrorName)(rawError.name)) {
+          return this.getErrorPayloadForClientErrorCode({
+            serviceErrorCode: undefined,
+            clientErrorCode: _config2.BROWSER_MEDIA_ERROR_NAME_TO_CLIENT_ERROR_CODES_MAP[rawError.name],
+            serviceErrorName: rawError.name
+          });
+        }
+      }
+      var serviceErrorCode = (rawError === null || rawError === void 0 ? void 0 : (_rawError$error = rawError.error) === null || _rawError$error === void 0 ? void 0 : (_rawError$error$body = _rawError$error.body) === null || _rawError$error$body === void 0 ? void 0 : _rawError$error$body.errorCode) || (rawError === null || rawError === void 0 ? void 0 : (_rawError$body = rawError.body) === null || _rawError$body === void 0 ? void 0 : _rawError$body.errorCode) || (rawError === null || rawError === void 0 ? void 0 : (_rawError$body2 = rawError.body) === null || _rawError$body2 === void 0 ? void 0 : _rawError$body2.code) || (rawError === null || rawError === void 0 ? void 0 : (_rawError$body3 = rawError.body) === null || _rawError$body3 === void 0 ? void 0 : (_rawError$body3$reaso = _rawError$body3.reason) === null || _rawError$body3$reaso === void 0 ? void 0 : _rawError$body3$reaso.reasonCode);
+      if (serviceErrorCode) {
+        var clientErrorCode = _config2.SERVICE_ERROR_CODES_TO_CLIENT_ERROR_CODES_MAP[serviceErrorCode];
+        if (clientErrorCode) {
+          return this.getErrorPayloadForClientErrorCode({
+            clientErrorCode: clientErrorCode,
+            serviceErrorCode: serviceErrorCode
+          });
+        }
+
+        // by default, if it is locus error, return new locus err
+        if ((0, _callDiagnosticMetrics.isLocusServiceErrorCode)(serviceErrorCode)) {
+          return this.getErrorPayloadForClientErrorCode({
+            clientErrorCode: _config2.NEW_LOCUS_ERROR_CLIENT_CODE,
+            serviceErrorCode: serviceErrorCode
+          });
+        }
+      }
+      if ((0, _callDiagnosticMetrics.isMeetingInfoServiceError)(rawError)) {
+        return this.getErrorPayloadForClientErrorCode({
+          clientErrorCode: _config2.MEETING_INFO_LOOKUP_ERROR_CLIENT_CODE,
+          serviceErrorCode: serviceErrorCode
+        });
+      }
+
+      // otherwise return unkown error
+      return this.getErrorPayloadForClientErrorCode({
+        clientErrorCode: _config2.UNKNOWN_ERROR,
+        serviceErrorCode: _config2.UNKNOWN_ERROR
+      });
+    }
+
+    /**
+     * Create client event object for in meeting events
+     * @param arg - create args
+     * @param arg.event - event key
+     * @param arg.options - options
+     * @returns object
+     */
+  }, {
+    key: "createClientEventObjectInMeeting",
+    value: function createClientEventObjectInMeeting(_ref4) {
+      var name = _ref4.name,
+        options = _ref4.options,
+        errors = _ref4.errors;
+      var meetingId = options.meetingId,
+        mediaConnections = options.mediaConnections;
+
+      // @ts-ignore
+      var meeting = this.webex.meetings.meetingCollection.get(meetingId);
+      if (!meeting) {
+        console.warn('Attempt to send client event but no meeting was found...', "event: ".concat(name, ", meetingId: ").concat(meetingId));
+        // @ts-ignore
+        this.webex.internal.metrics.submitClientMetrics(_config2.CALL_DIAGNOSTIC_EVENT_FAILED_TO_SEND, {
+          fields: {
+            meetingId: meetingId,
+            name: name
+          }
+        });
+        return undefined;
+      }
+
+      // grab identifiers
+      var identifiers = this.getIdentifiers({
+        meeting: meeting,
+        mediaConnections: (meeting === null || meeting === void 0 ? void 0 : meeting.mediaConnections) || mediaConnections
+      });
+
+      // create client event object
+      var clientEventObject = {
+        name: name,
+        canProceed: true,
+        identifiers: identifiers,
+        errors: errors,
+        eventData: {
+          webClientDomain: window.location.hostname
+        },
+        userType: meeting.getCurUserType(),
+        loginType: this.getCurLoginType(),
+        isConvergedArchitectureEnabled: this.getIsConvergedArchitectureEnabled({
+          meetingId: meetingId
+        })
+      };
+      return clientEventObject;
+    }
+
+    /**
+     * Create client event object for pre meeting events
+     * @param arg - create args
+     * @param arg.event - event key
+     * @param arg.options - payload
+     * @returns object
+     */
+  }, {
+    key: "createClientEventObjectPreMeeting",
+    value: function createClientEventObjectPreMeeting(_ref5) {
+      var name = _ref5.name,
+        options = _ref5.options,
+        errors = _ref5.errors;
+      var correlationId = options.correlationId;
+
+      // grab identifiers
+      var identifiers = this.getIdentifiers({
+        correlationId: correlationId
+      });
+
+      // create client event object
+      var clientEventObject = {
+        name: name,
+        errors: errors,
+        canProceed: true,
+        identifiers: identifiers,
+        eventData: {
+          webClientDomain: window.location.hostname
+        },
+        loginType: this.getCurLoginType()
+      };
+      return clientEventObject;
+    }
+
+    /**
+     * Prepare Client Event CA event.
+     * @param arg - submit params
+     * @param arg.event - event key
+     * @param arg.payload - additional payload to be merged with default payload
+     * @param arg.options - payload
+     * @returns {any} options to be with fetch
+     * @throws
+     */
+  }, {
+    key: "prepareClientEvent",
+    value: function prepareClientEvent(_ref6) {
+      var name = _ref6.name,
+        payload = _ref6.payload,
+        options = _ref6.options;
+      var meetingId = options.meetingId,
+        correlationId = options.correlationId,
+        rawError = options.rawError;
+      var clientEventObject;
+
+      // check if we need to generate errors
+      var errors = [];
+      if (rawError) {
+        var generatedError = this.generateClientEventErrorPayload(rawError);
+        if (generatedError) {
+          errors.push(generatedError);
+        }
+      }
+
+      // events that will most likely happen in join phase
+      if (meetingId) {
+        clientEventObject = this.createClientEventObjectInMeeting({
+          name: name,
+          options: options,
+          errors: errors
+        });
+      } else if (correlationId) {
+        // any pre join events or events that are outside the meeting.
+        clientEventObject = this.createClientEventObjectPreMeeting({
+          name: name,
+          options: options,
+          errors: errors
+        });
+      } else {
+        throw new Error('Not implemented');
+      }
+
+      // merge any new properties, or override existing ones
+      clientEventObject = (0, _merge2.default)(clientEventObject, payload);
+
+      // append client event data to the call diagnostic event
+      var diagnosticEvent = this.prepareDiagnosticEvent(clientEventObject, options);
+      return diagnosticEvent;
+    }
+
+    /**
+     * Submit Client Event CA event.
+     * @param arg - submit params
+     * @param arg.event - event key
+     * @param arg.payload - additional payload to be merged with default payload
+     * @param arg.options - payload
+     * @throws
+     */
+  }, {
+    key: "submitClientEvent",
+    value: function submitClientEvent(_ref7) {
+      var name = _ref7.name,
+        payload = _ref7.payload,
+        options = _ref7.options;
+      var diagnosticEvent = this.prepareClientEvent({
+        name: name,
+        payload: payload,
+        options: options
+      });
+      return this.submitToCallDiagnostics(diagnosticEvent);
+    }
+
+    /**
+     * Prepare the event and send the request to metrics-a service.
+     * @param event
+     * @returns promise
+     */
+  }, {
+    key: "submitToCallDiagnostics",
+    value: function submitToCallDiagnostics(event) {
+      // build metrics-a event type
+      var finalEvent = {
+        eventPayload: event,
+        type: ['diagnostic-event']
+      };
+      return this.callDiagnosticEventsBatcher.request(finalEvent);
+    }
+
+    /**
+     * Builds a request options object to later be passed to fetch().
+     * @param arg - submit params
+     * @param arg.event - event key
+     * @param arg.payload - additional payload to be merged with default payload
+     * @param arg.options - client event options
+     * @returns {Promise<any>}
+     * @throws
+     */
+  }, {
+    key: "buildClientEventFetchRequestOptions",
+    value: function () {
+      var _buildClientEventFetchRequestOptions = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee(_ref8) {
+        var name, payload, options, clientEvent, diagnosticEvent;
+        return _regenerator.default.wrap(function _callee$(_context) {
+          while (1) switch (_context.prev = _context.next) {
+            case 0:
+              name = _ref8.name, payload = _ref8.payload, options = _ref8.options;
+              clientEvent = this.prepareClientEvent({
+                name: name,
+                payload: payload,
+                options: options
+              }); // build metrics-a event type
+              // @ts-ignore
+              diagnosticEvent = (0, _callDiagnosticMetrics.prepareDiagnosticMetricItem)(this.webex, {
+                eventPayload: clientEvent,
+                type: ['diagnostic-event']
+              }); // @ts-ignore
+              return _context.abrupt("return", this.webex.prepareFetchOptions({
+                method: 'POST',
+                service: 'metrics',
+                resource: 'clientmetrics',
+                body: {
+                  metrics: [diagnosticEvent]
+                }
+              }));
+            case 4:
+            case "end":
+              return _context.stop();
+          }
+        }, _callee, this);
+      }));
+      function buildClientEventFetchRequestOptions(_x) {
+        return _buildClientEventFetchRequestOptions.apply(this, arguments);
+      }
+      return buildClientEventFetchRequestOptions;
+    }()
+  }]);
+  return CallDiagnosticMetrics;
+}(_webexCore.StatelessWebexPlugin);
+exports.default = CallDiagnosticMetrics;
+//# sourceMappingURL=call-diagnostic-metrics.js.map