@webex/internal-plugin-metrics 3.8.0-next.2 → 3.8.0-next.21

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

@@ -1,5 +1,5 @@
 import { StatelessWebexPlugin } from '@webex/webex-core';
-import { Event, ClientType, SubClientType, NetworkType, EnvironmentType, NewEnvironmentType, ClientEvent, SubmitClientEventOptions, MediaQualityEvent, SubmitMQEOptions, SubmitMQEPayload, ClientLaunchMethodType, ClientEventError, ClientEventPayload, ClientSubServiceType, BrowserLaunchMethodType } from '../metrics.types';
+import { Event, ClientType, SubClientType, NetworkType, EnvironmentType, NewEnvironmentType, ClientEvent, SubmitClientEventOptions, MediaQualityEvent, SubmitMQEOptions, SubmitMQEPayload, ClientLaunchMethodType, ClientEventError, ClientEventPayload, ClientSubServiceType, BrowserLaunchMethodType, DelayedClientEvent } from '../metrics.types';
 type GetOriginOptions = {
     clientType: ClientType;
     subClientType: SubClientType;
@@ -30,6 +30,7 @@ export default class CallDiagnosticMetrics extends StatelessWebexPlugin {
     private hasLoggedBrowserSerial;
     private device;
     private delayedClientEvents;
+    private eventErrorCache;
     validator: (options: {
         type: 'mqe' | 'ce';
         event: Event;
@@ -67,7 +68,7 @@ export default class CallDiagnosticMetrics extends StatelessWebexPlugin {
      * @returns
      */
     getOrigin(options: GetOriginOptions, meetingId?: string): {
-        name: "endpoint" | "addin" | "antares" | "appapi" | "beech" | "breakout" | "calendar" | "cb" | "cca" | "ccc" | "cloudproxy" | "crc" | "edonus" | "givr" | "hecate" | "hedge" | "hesiod" | "homer" | "superhomer" | "l2sip" | "linus" | "locus" | "mbs" | "mcc" | "mcs" | "mercury" | "mes" | "mjs" | "mmp" | "mygdon" | "ngservice" | "orpheus" | "page" | "poros" | "publicapi" | "rhesos" | "terminus" | "tpgw" | "ucc" | "wdm" | "webexivr" | "meetingcontainer";
+        name: "endpoint" | "addin" | "antares" | "appapi" | "beech" | "breakout" | "calendar" | "cb" | "cca" | "ccc" | "cloudproxy" | "crc" | "edonus" | "givr" | "hecate" | "hedge" | "hesiod" | "homer" | "idbroker" | "superhomer" | "l2sip" | "linus" | "locus" | "mbs" | "mcc" | "mcs" | "mercury" | "mes" | "mjs" | "mmp" | "mygdon" | "ngservice" | "orpheus" | "page" | "poros" | "publicapi" | "rhesos" | "terminus" | "tpgw" | "ucc" | "wdm" | "webexivr" | "meetingcontainer";
         userAgent: string;
         buildType?: "debug" | "test" | "prod" | "tap" | "analyzer-test";
         upgradeChannel?: string;
@@ -87,11 +88,14 @@ export default class CallDiagnosticMetrics extends StatelessWebexPlugin {
             localNetworkPrefix?: string;
             publicNetworkPrefix?: string;
             browserLaunchMethod?: "url-handler" | "activex" | "npapi" | "extension" | "cwsapi" | "java" | "tfs" | "webacd" | "thinclient" | "switch-to-web" | "switch-to-native";
-            clientLaunchMethod?: "url-handler" | "universal-link" | "voice-command" | "notification" | "manual" | "teams-cross-launch" | "mc-cross-launch";
+            clientLaunchMethod?: "url-handler" | "universal-link" | "voice-command" | "notification" | "manual" | "teams-cross-launch" | "mc-cross-launch" | "cws" | "launcher" | "cws-launcher";
             browser?: string;
             browserVersion?: string;
-            clientType?: "MEETING_CENTER" | "EVENT_CENTER" | "TRAINING_CENTER" | "TEAMS_CLIENT" | "TEAMS_DEVICE" | "TEAMS_SHARE" | "SIP" | "RECORDING" | "CLOUD_AWARE_SIP" | "TEAMS_WXC_CLIENT" | "WXC_CLIENT" | "WXC_DEVICE" | "WEBEX_JS_SDK" | "VOICEA_CLIENT" | "CISCO_SIP_GW" | "WEBEX_SDK" | "CPAAS_THIRD_PARTY_SDK" | "WXC_THIRD_PARTY" | "WXCC";
-            subClientType?: "TEAMS_DEVICE" | "AUTOMOTIVE_APP" | "DESKTOP_APP" | "DESKTOP_APP_VDI" | "DEVICE_CURRENT" | "DEVICE_LEGACY_2020" | "HOLOGRAM_HEADSET_APP" | "HVDI_APP" | "MIXED" | "MOBILE_APP" | "MOBILE_NETWORK" | "PAGE" | "VDI_APP" | "WEB_APP";
+            clientType?: "MEETING_CENTER" | "EVENT_CENTER" | "TRAINING_CENTER" | "TEAMS_CLIENT" | "TEAMS_DEVICE" | "TEAMS_SHARE" | "SIP" | "RECORDING" | "CLOUD_AWARE_SIP" | "TEAMS_WXC_CLIENT" | "WXC_CLIENT" | "WXC_DEVICE" | "WEBEX_JS_SDK" | "VOICEA_CLIENT" | "CISCO_SIP_GW" | "WEBEX_SDK" | "CPAAS_THIRD_PARTY_SDK" | "WXC_THIRD_PARTY" | "WXCC" | "TEAMS_PHONE"; /**
+             * Constructor
+             * @param args
+             */
+            subClientType?: "TEAMS_DEVICE" | "AUTOMOTIVE_APP" | "DESKTOP_APP" | "DESKTOP_APP_VDI" | "DEVICE_CURRENT" | "DEVICE_LEGACY_2020" | "HOLOGRAM_HEADSET_APP" | "HVDI_APP" | "MIXED" | "MOBILE_APP" | "MOBILE_NETWORK" | "PAGE" | "VDI_APP" | "WEB_APP" | "PHONE_NOVUM" | "PHONE_ESPRESSO" | "PHONE_BUMBLEBEE";
             schedulingClientType?: "TEAMS_CLIENT" | "GOOGLE_ADDON" | "PT" | "PUBLIC_API" | "UNIFIED_PAGE" | "WEBEX_PAGE" | "GOOGLE_NOTIFICATION_CALENDAR" | "MSFT_NOTIFICATION_ADDIN" | "MSFT_NOTIFICATION_CALENDAR" | "OUTLOOK_ADDIN";
             clientVersion?: string;
             clientVersionStatus?: "CURRENT" | "LEGACY" | "UNSUPPORTED";
@@ -147,6 +151,7 @@ export default class CallDiagnosticMetrics extends StatelessWebexPlugin {
      * @param options
      */
     getIdentifiers(options: GetIdentifiersOptions): {
+        aggregatedBreakoutMoveId?: string;
         attendeeId?: string;
         participantId?: string;
         breakoutGroupId?: string;
@@ -230,6 +235,7 @@ export default class CallDiagnosticMetrics extends StatelessWebexPlugin {
         correlationId: string;
         additionalProperties?: false;
     } | {
+        aggregatedBreakoutMoveId?: string;
         attendeeId?: string;
         participantId?: string;
         breakoutGroupId?: string;
@@ -356,26 +362,15 @@ export default class CallDiagnosticMetrics extends StatelessWebexPlugin {
         payloadOverrides?: any;
         httpStatusCode?: number;
     }): ClientEventError;
+    /**
+     * Clear the error cache
+     */
+    clearErrorCache(): void;
     /**
      * Generate error payload for Client Event
      * @param rawError
      */
-    generateClientEventErrorPayload(rawError: any): {
-        fatal: boolean;
-        category: "other" | "signaling" | "media" | "network" | "expected";
-        errorDescription?: string;
-        errorCode?: number;
-        errorCodeStr?: string;
-        httpCode?: number;
-        errorCodeExt1?: number;
-        errorData?: {};
-        rawErrorMessage?: string;
-        mediaDeviceErrors?: string;
-        shownToUser: boolean;
-        serviceErrorCode?: number;
-        name: "other" | "locus.response" | "media-engine" | "ice.failed" | "locus.leave" | "client.leave" | "media-device" | "media-sca" | "wxc";
-        additionalProperties?: false;
-    };
+    generateClientEventErrorPayload(rawError: any): any[];
     /**
      * Create client event object for in meeting events
      * @param arg - create args
@@ -420,7 +415,7 @@ export default class CallDiagnosticMetrics extends StatelessWebexPlugin {
     /**
      * Submit Delayed Client Event CA events. Clears delayedClientEvents array after submission.
      */
-    submitDelayedClientEvents(): Promise<any[]> | Promise<void>;
+    submitDelayedClientEvents(overrides?: Partial<DelayedClientEvent['options']>): Promise<any[]> | Promise<void>;
     /**
      * Prepare the event and send the request to metrics-a service.
      * @param event

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

@@ -99,6 +99,7 @@ export declare const ERROR_DESCRIPTIONS: {
     SDP_OFFER_CREATION_ERROR: string;
     SDP_OFFER_CREATION_ERROR_MISSING_CODEC: string;
     WDM_RESTRICTED_REGION: string;
+    USER_NOT_ALLOWED_JOIN_WEBINAR: string;
 };
 export declare const SERVICE_ERROR_CODES_TO_CLIENT_ERROR_CODES_MAP: {
     58400: number;
@@ -108,6 +109,8 @@ export declare const SERVICE_ERROR_CODES_TO_CLIENT_ERROR_CODES_MAP: {
     400001: number;
     403004: number;
     403028: number;
+    403025: number;
+    403125: number;
     403032: number;
     403034: number;
     403036: number;
@@ -133,6 +136,14 @@ export declare const SERVICE_ERROR_CODES_TO_CLIENT_ERROR_CODES_MAP: {
     423012: number;
     423013: number;
     429005: number;
+    403021: number;
+    403022: number;
+    403024: number;
+    403137: number;
+    423007: number;
+    403026: number;
+    403037: number;
+    403003: number;
     2403001: number;
     2403002: number;
     2403003: number;

package/dist/types/index.d.ts

@@ -4,7 +4,7 @@
 import config from './config';
 import NewMetrics from './new-metrics';
 import * as Utils from './utils';
-import { ClientEvent, ClientEventLeaveReason, SubmitBehavioralEvent, SubmitClientEvent, SubmitInternalEvent, SubmitOperationalEvent, SubmitMQE, PreComputedLatencies } from './metrics.types';
+import { ClientEvent, ClientEventLeaveReason, SubmitBehavioralEvent, SubmitClientEvent, SubmitInternalEvent, SubmitOperationalEvent, SubmitBusinessEvent, SubmitMQE, PreComputedLatencies } from './metrics.types';
 import * as CALL_DIAGNOSTIC_CONFIG from './call-diagnostic/config';
 import * as CallDiagnosticUtils from './call-diagnostic/call-diagnostic-metrics.util';
 import CallDiagnosticMetrics from './call-diagnostic/call-diagnostic-metrics';
@@ -15,4 +15,4 @@ import BusinessMetrics from './business-metrics';
 import RtcMetrics from './rtcMetrics';
 export { default, getOSNameInternal } from './metrics';
 export { config, CALL_DIAGNOSTIC_CONFIG, NewMetrics, Utils, CallDiagnosticUtils, CallDiagnosticLatencies, CallDiagnosticMetrics, BehavioralMetrics, OperationalMetrics, BusinessMetrics, RtcMetrics, };
-export type { ClientEvent, ClientEventLeaveReason, SubmitBehavioralEvent, SubmitClientEvent, SubmitInternalEvent, SubmitMQE, SubmitOperationalEvent, PreComputedLatencies, };
+export type { ClientEvent, ClientEventLeaveReason, SubmitBehavioralEvent, SubmitClientEvent, SubmitInternalEvent, SubmitMQE, SubmitOperationalEvent, SubmitBusinessEvent, PreComputedLatencies, };

package/dist/types/metrics.types.d.ts

@@ -9,7 +9,7 @@ export type ClientLaunchMethodType = NonNullable<RawEvent['origin']['clientInfo'
 export type ClientUserNameInput = NonNullable<RawClientEvent['userNameInput']>;
 export type ClientEmailInput = NonNullable<RawClientEvent['emailInput']>;
 export type BrowserLaunchMethodType = NonNullable<RawEvent['origin']['clientInfo']>['browserLaunchMethod'];
-export type MetricEventProduct = 'webex' | 'wxcc_desktop' | 'wxcc_crm';
+export type MetricEventProduct = 'webex' | 'wxcc_desktop' | 'wxcc_crm' | 'wxcc_sdk';
 export type MetricEventAgent = 'user' | 'browser' | 'system' | 'sdk' | 'redux' | 'service' | 'api';
 export type MetricEventVerb = 'abort' | 'accept' | 'activate' | 'apply' | 'answer' | 'authorize' | 'build' | 'cancel' | 'change' | 'click' | 'close' | 'complete' | 'connect' | 'create' | 'deactivate' | 'decrypt' | 'delete' | 'deliver' | 'destroy' | 'disable' | 'disconnect' | 'dismiss' | 'display' | 'download' | 'edit' | 'enable' | 'encrypt' | 'end' | 'expire' | 'fail' | 'fetch' | 'fire' | 'generate' | 'get' | 'hide' | 'hover' | 'ignore' | 'initialize' | 'initiate' | 'invalidate' | 'join' | 'list' | 'load' | 'login' | 'logout' | 'notify' | 'offer' | 'open' | 'press' | 'receive' | 'refer' | 'refresh' | 'register' | 'release' | 'reload' | 'reject' | 'request' | 'reset' | 'resize' | 'respond' | 'retry' | 'revoke' | 'save' | 'search' | 'select' | 'send' | 'set' | 'sign' | 'start' | 'submit' | 'switch' | 'sync' | 'toggle' | 'transfer' | 'unregister' | 'update' | 'upload' | 'use' | 'validate' | 'view' | 'visit' | 'wait' | 'warn' | 'exit';
 export type MetricEventJoinFlowVersion = 'Other' | 'NewFTE';
@@ -136,6 +136,12 @@ export type SubmitOperationalEvent = (args: {
     name: OperationalEvent['metricName'];
     payload: EventPayload;
 }) => void;
+export type SubmitBusinessEvent = (args: {
+    name: OperationalEvent['metricName'];
+    payload: EventPayload;
+    metadata?: EventPayload;
+    table?: Table;
+}) => void;
 export type SubmitMQE = (args: {
     name: MediaQualityEvent['name'];
     payload: SubmitMQEPayload;

package/dist/types/new-metrics.d.ts

@@ -3,7 +3,7 @@ import CallDiagnosticMetrics from './call-diagnostic/call-diagnostic-metrics';
 import BehavioralMetrics from './behavioral-metrics';
 import OperationalMetrics from './operational-metrics';
 import BusinessMetrics from './business-metrics';
-import { RecursivePartial, MetricEventProduct, MetricEventAgent, MetricEventVerb, ClientEvent, FeatureEvent, EventPayload, MediaQualityEvent, InternalEvent, SubmitClientEventOptions, Table } from './metrics.types';
+import { RecursivePartial, MetricEventProduct, MetricEventAgent, MetricEventVerb, ClientEvent, FeatureEvent, EventPayload, MediaQualityEvent, InternalEvent, SubmitClientEventOptions, Table, DelayedClientEvent } from './metrics.types';
 import CallDiagnosticLatencies from './call-diagnostic/call-diagnostic-metrics-latencies';
 /**
  * Metrics plugin to centralize all types of metrics.
@@ -22,6 +22,10 @@ declare class Metrics extends WebexPlugin {
      * Whether or not to delay the submission of client events.
      */
     delaySubmitClientEvents: boolean;
+    /**
+     * Overrides for delayed client events. E.g. if you want to override the correlationId for all delayed client events, you can set this to { correlationId: 'newCorrelationId' }
+     */
+    delayedClientEventsOverrides: Partial<DelayedClientEvent['options']>;
     /**
      * Constructor
      * @param args
@@ -178,8 +182,11 @@ declare class Metrics extends WebexPlugin {
      * Sets the value of delaySubmitClientEvents. If set to true, client events will be delayed until submitDelayedClientEvents is called. If
      * set to false, delayed client events will be submitted.
      *
-     * @param {boolean} shouldDelay - A boolean value indicating whether to delay the submission of client events.
+     * @param {object} options - {shouldDelay: A boolean value indicating whether to delay the submission of client events, overrides: An object containing overrides for the client events}
      */
-    setDelaySubmitClientEvents(shouldDelay: boolean): Promise<any[]> | Promise<void>;
+    setDelaySubmitClientEvents({ shouldDelay, overrides, }: {
+        shouldDelay: boolean;
+        overrides?: Partial<DelayedClientEvent['options']>;
+    }): Promise<any[]> | Promise<void>;
 }
 export default Metrics;

package/package.json

@@ -26,22 +26,22 @@
     "@webex/eslint-config-legacy": "0.0.0",
     "@webex/jest-config-legacy": "0.0.0",
     "@webex/legacy-tools": "0.0.0",
-    "@webex/test-helper-chai": "3.8.0-next.2",
-    "@webex/test-helper-mocha": "3.8.0-next.2",
-    "@webex/test-helper-mock-webex": "3.8.0-next.2",
-    "@webex/test-helper-test-users": "3.8.0-next.2",
+    "@webex/test-helper-chai": "3.8.0-next.21",
+    "@webex/test-helper-mocha": "3.8.0-next.21",
+    "@webex/test-helper-mock-webex": "3.8.0-next.21",
+    "@webex/test-helper-test-users": "3.8.0-next.21",
     "eslint": "^8.24.0",
     "prettier": "^2.7.1",
     "sinon": "^9.2.4"
   },
   "dependencies": {
-    "@webex/common": "3.8.0-next.2",
-    "@webex/common-timers": "3.8.0-next.2",
-    "@webex/event-dictionary-ts": "^1.0.1688",
-    "@webex/internal-plugin-metrics": "3.8.0-next.2",
-    "@webex/test-helper-chai": "3.8.0-next.2",
-    "@webex/test-helper-mock-webex": "3.8.0-next.2",
-    "@webex/webex-core": "3.8.0-next.2",
+    "@webex/common": "3.8.0-next.21",
+    "@webex/common-timers": "3.8.0-next.21",
+    "@webex/event-dictionary-ts": "^1.0.1753",
+    "@webex/internal-plugin-metrics": "3.8.0-next.21",
+    "@webex/test-helper-chai": "3.8.0-next.21",
+    "@webex/test-helper-mock-webex": "3.8.0-next.21",
+    "@webex/webex-core": "3.8.0-next.21",
     "ip-anonymize": "^0.1.0",
     "lodash": "^4.17.21",
     "uuid": "^3.3.2"
@@ -54,5 +54,5 @@
     "test:style": "eslint ./src/**/*.*",
     "test:unit": "webex-legacy-tools test --unit --runner mocha"
   },
-  "version": "3.8.0-next.2"
+  "version": "3.8.0-next.21"
 }

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

@@ -97,6 +97,7 @@ export default class CallDiagnosticMetrics extends StatelessWebexPlugin {
   private hasLoggedBrowserSerial: boolean;
   private device: any;
   private delayedClientEvents: DelayedClientEvent[] = [];
+  private eventErrorCache: WeakMap<any, any> = new WeakMap();
 
   // the default validator before piping an event to the batcher
   // this function can be overridden by the user
@@ -166,23 +167,17 @@ export default class CallDiagnosticMetrics extends StatelessWebexPlugin {
       if (meetingInfo?.webexScheduled && !meetingInfo?.enableEvent && !meetingInfo?.pmr) {
         return WEBEX_SUB_SERVICE_TYPES.SCHEDULED_MEETING;
       }
-      // if Scheduled, Webinar, not pmr - then Webinar
-      if (
-        meetingInfo?.webexScheduled &&
-        meetingInfo?.enableEvent &&
-        !meetingInfo?.pmr &&
-        meetingInfo?.isConvergedWebinar
-      ) {
-        return WEBEX_SUB_SERVICE_TYPES.WEBINAR;
+
+      // if ConvergedArchitecture enable and isConvergedWebinarWebcast -- then webcast
+      if (meetingInfo?.enableConvergedArchitecture && meetingInfo?.enableEvent) {
+        return meetingInfo?.isConvergedWebinarWebcast
+          ? WEBEX_SUB_SERVICE_TYPES.WEBCAST
+          : WEBEX_SUB_SERVICE_TYPES.WEBINAR;
       }
-      // if Scheduled, Webinar enable webcast - then webcast
-      if (
-        meetingInfo?.webexScheduled &&
-        meetingInfo?.enableEvent &&
-        !meetingInfo?.pmr &&
-        meetingInfo?.isConvergedWebinarWebcast
-      ) {
-        return WEBEX_SUB_SERVICE_TYPES.WEBCAST;
+
+      // if Scheduled, enable event, not pmr - then Webinar
+      if (meetingInfo?.webexScheduled && meetingInfo?.enableEvent && !meetingInfo?.pmr) {
+        return WEBEX_SUB_SERVICE_TYPES.WEBINAR;
       }
     }
 
@@ -561,16 +556,31 @@ export default class CallDiagnosticMetrics extends StatelessWebexPlugin {
     return undefined;
   }
 
+  /**
+   * Clear the error cache
+   */
+  clearErrorCache() {
+    this.eventErrorCache = new WeakMap();
+  }
+
   /**
    * Generate error payload for Client Event
    * @param rawError
    */
   generateClientEventErrorPayload(rawError: any) {
+    const cachedError = this.eventErrorCache.get(rawError);
+
+    if (cachedError) {
+      return [cachedError, true];
+    }
+
     const rawErrorMessage = rawError.message;
     const httpStatusCode = rawError.statusCode;
+    let payload;
+
     if (rawError.name) {
       if (isBrowserMediaErrorName(rawError.name)) {
-        return this.getErrorPayloadForClientErrorCode({
+        payload = this.getErrorPayloadForClientErrorCode({
           serviceErrorCode: undefined,
           clientErrorCode: BROWSER_MEDIA_ERROR_NAME_TO_CLIENT_ERROR_CODES_MAP[rawError.name],
           serviceErrorName: rawError.name,
@@ -580,11 +590,11 @@ export default class CallDiagnosticMetrics extends StatelessWebexPlugin {
       }
     }
 
-    if (isSdpOfferCreationError(rawError)) {
+    if (isSdpOfferCreationError(rawError) && !payload) {
       // error code is 30005, but that's not specific enough. we also need to check error.cause.type
       const causeType = rawError.cause?.type;
 
-      return this.getErrorPayloadForClientErrorCode({
+      payload = this.getErrorPayloadForClientErrorCode({
         serviceErrorCode: undefined,
         clientErrorCode:
           SDP_OFFER_CREATION_ERROR_MAP[causeType] || SDP_OFFER_CREATION_ERROR_MAP.GENERAL,
@@ -602,8 +612,8 @@ export default class CallDiagnosticMetrics extends StatelessWebexPlugin {
 
     if (serviceErrorCode) {
       const clientErrorCode = SERVICE_ERROR_CODES_TO_CLIENT_ERROR_CODES_MAP[serviceErrorCode];
-      if (clientErrorCode) {
-        return this.getErrorPayloadForClientErrorCode({
+      if (clientErrorCode && !payload) {
+        payload = this.getErrorPayloadForClientErrorCode({
           clientErrorCode,
           serviceErrorCode,
           rawErrorMessage,
@@ -612,8 +622,8 @@ export default class CallDiagnosticMetrics extends StatelessWebexPlugin {
       }
 
       // by default, if it is locus error, return new locus err
-      if (isLocusServiceErrorCode(serviceErrorCode)) {
-        return this.getErrorPayloadForClientErrorCode({
+      if (isLocusServiceErrorCode(serviceErrorCode) && !payload) {
+        payload = this.getErrorPayloadForClientErrorCode({
           clientErrorCode: NEW_LOCUS_ERROR_CLIENT_CODE,
           serviceErrorCode,
           rawErrorMessage,
@@ -622,8 +632,8 @@ export default class CallDiagnosticMetrics extends StatelessWebexPlugin {
       }
     }
 
-    if (isMeetingInfoServiceError(rawError)) {
-      return this.getErrorPayloadForClientErrorCode({
+    if (isMeetingInfoServiceError(rawError) && !payload) {
+      payload = this.getErrorPayloadForClientErrorCode({
         clientErrorCode: MEETING_INFO_LOOKUP_ERROR_CLIENT_CODE,
         serviceErrorCode,
         rawErrorMessage,
@@ -631,8 +641,8 @@ export default class CallDiagnosticMetrics extends StatelessWebexPlugin {
       });
     }
 
-    if (isNetworkError(rawError)) {
-      return this.getErrorPayloadForClientErrorCode({
+    if (isNetworkError(rawError) && !payload) {
+      payload = this.getErrorPayloadForClientErrorCode({
         clientErrorCode: NETWORK_ERROR,
         serviceErrorCode,
         payloadOverrides: rawError.payloadOverrides,
@@ -641,8 +651,8 @@ export default class CallDiagnosticMetrics extends StatelessWebexPlugin {
       });
     }
 
-    if (isUnauthorizedError(rawError)) {
-      return this.getErrorPayloadForClientErrorCode({
+    if (isUnauthorizedError(rawError) && !payload) {
+      payload = this.getErrorPayloadForClientErrorCode({
         clientErrorCode: AUTHENTICATION_FAILED_CODE,
         serviceErrorCode,
         payloadOverrides: rawError.payloadOverrides,
@@ -651,15 +661,22 @@ export default class CallDiagnosticMetrics extends StatelessWebexPlugin {
       });
     }
 
-    // otherwise return unkown error but passing serviceErrorCode and serviceErrorName so that we know the issue
-    return this.getErrorPayloadForClientErrorCode({
-      clientErrorCode: UNKNOWN_ERROR,
-      serviceErrorCode: serviceErrorCode || UNKNOWN_ERROR,
-      serviceErrorName: rawError?.name,
-      payloadOverrides: rawError.payloadOverrides,
-      rawErrorMessage,
-      httpStatusCode,
-    });
+    if (!payload) {
+      // otherwise return unkown error but passing serviceErrorCode and serviceErrorName so that we know the issue
+      payload = this.getErrorPayloadForClientErrorCode({
+        clientErrorCode: UNKNOWN_ERROR,
+        serviceErrorCode: serviceErrorCode || UNKNOWN_ERROR,
+        serviceErrorName: rawError?.name,
+        payloadOverrides: rawError.payloadOverrides,
+        rawErrorMessage,
+        httpStatusCode,
+      });
+    }
+
+    // cache the payload for future use
+    this.eventErrorCache.set(rawError, payload);
+
+    return [payload, false];
   }
 
   /**
@@ -742,6 +759,10 @@ export default class CallDiagnosticMetrics extends StatelessWebexPlugin {
     if (joinFlowVersion) {
       clientEventObject.joinFlowVersion = joinFlowVersion;
     }
+    const meetingJoinedTime = meeting.isoLocalClientMeetingJoinTime;
+    if (meetingJoinedTime) {
+      clientEventObject.meetingJoinedTime = meetingJoinedTime;
+    }
 
     if (options.meetingJoinPhase) {
       clientEventObject.meetingJoinPhase = options.meetingJoinPhase;
@@ -836,14 +857,14 @@ export default class CallDiagnosticMetrics extends StatelessWebexPlugin {
     const errors: ClientEventPayloadError = [];
 
     if (rawError) {
-      const generatedError = this.generateClientEventErrorPayload(rawError);
+      const [generatedError, cached] = this.generateClientEventErrorPayload(rawError);
       if (generatedError) {
         errors.push(generatedError);
       }
       this.logger.log(
         CALL_DIAGNOSTIC_LOG_IDENTIFIER,
         'CallDiagnosticMetrics: @prepareClientEvent. Generated errors:',
-        `generatedError: ${JSON.stringify(generatedError)}`
+        `generatedError (cached: ${cached}): ${JSON.stringify(generatedError)}`
       );
     }
 
@@ -921,7 +942,7 @@ export default class CallDiagnosticMetrics extends StatelessWebexPlugin {
   /**
    * Submit Delayed Client Event CA events. Clears delayedClientEvents array after submission.
    */
-  public submitDelayedClientEvents() {
+  public submitDelayedClientEvents(overrides?: Partial<DelayedClientEvent['options']>) {
     this.logger.log(
       CALL_DIAGNOSTIC_LOG_IDENTIFIER,
       'CallDiagnosticMetrics: @submitDelayedClientEvents. Submitting delayed client events.'
@@ -932,7 +953,10 @@ export default class CallDiagnosticMetrics extends StatelessWebexPlugin {
     }
 
     const promises = this.delayedClientEvents.map((delayedSubmitClientEventParams) => {
-      return this.submitClientEvent(delayedSubmitClientEventParams);
+      const {name, payload, options} = delayedSubmitClientEventParams;
+      const optionsWithOverrides: DelayedClientEvent['options'] = {...options, ...overrides};
+
+      return this.submitClientEvent({name, payload, options: optionsWithOverrides});
     });
 
     this.delayedClientEvents = [];

package/src/call-diagnostic/config.ts

@@ -133,6 +133,7 @@ export const ERROR_DESCRIPTIONS = {
   SDP_OFFER_CREATION_ERROR: 'SdpOfferCreationError',
   SDP_OFFER_CREATION_ERROR_MISSING_CODEC: 'SdpOfferCreationErrorMissingCodec',
   WDM_RESTRICTED_REGION: 'WdmRestrictedRegion',
+  USER_NOT_ALLOWED_JOIN_WEBINAR: 'UserNotAllowedJoinWebinar',
 };
 
 export const SERVICE_ERROR_CODES_TO_CLIENT_ERROR_CODES_MAP = {
@@ -151,6 +152,10 @@ export const SERVICE_ERROR_CODES_TO_CLIENT_ERROR_CODES_MAP = {
   403004: 4005,
   // Wrong password. Meeting is not allow to access since password error
   403028: 4005,
+  // meeting is not allow to access since require panelist password
+  403025: 4005,
+  // wrong password. Meeting is not allow to access since panelist password error
+  403125: 4005,
   // Wrong or expired permission. Meeting is not allow to access since permissionToken error or expire
   403032: 4005,
   // Meeting is required login for current user
@@ -202,6 +207,22 @@ export const SERVICE_ERROR_CODES_TO_CLIENT_ERROR_CODES_MAP = {
   423013: 4005,
   // Too many requests access
   429005: 4100,
+  // Webinar: Meeting registration is required
+  403021: 4104,
+  // Webinar: Meeting registration is still pending
+  403022: 4104,
+  // Webinar: Meeting registration have been rejected
+  403024: 4104,
+  // Webinar: Registration ID verified failure
+  403137: 4104,
+  // Webinar: Registration ID input too many time,please input captcha code
+  423007: 4104,
+  // Webinar: Need to join meeting via webcast
+  403026: 4104,
+  // Webinar: Meeting join required registration ID
+  403037: 4104,
+  // Not reach JBH, can't join meeting
+  403003: 4101,
 
   // ---- Locus ------
   // FREE_USER_MAX_PARTICIPANTS_EXCEEDED
@@ -666,6 +687,11 @@ export const CLIENT_ERROR_CODE_TO_ERROR_PAYLOAD: Record<number, Partial<ClientEv
     category: 'expected',
     fatal: true,
   },
+  4104: {
+    errorDescription: ERROR_DESCRIPTIONS.USER_NOT_ALLOWED_JOIN_WEBINAR,
+    category: 'expected',
+    fatal: true,
+  },
   2729: {
     errorDescription: ERROR_DESCRIPTIONS.NO_MEDIA_FOUND,
     category: 'expected',

package/src/index.ts

@@ -15,6 +15,7 @@ import {
   SubmitClientEvent,
   SubmitInternalEvent,
   SubmitOperationalEvent,
+  SubmitBusinessEvent,
   SubmitMQE,
   PreComputedLatencies,
 } from './metrics.types';
@@ -58,5 +59,6 @@ export type {
   SubmitInternalEvent,
   SubmitMQE,
   SubmitOperationalEvent,
+  SubmitBusinessEvent,
   PreComputedLatencies,
 };

package/src/metrics.types.ts

@@ -24,7 +24,7 @@ export type BrowserLaunchMethodType = NonNullable<
   RawEvent['origin']['clientInfo']
 >['browserLaunchMethod'];
 
-export type MetricEventProduct = 'webex' | 'wxcc_desktop' | 'wxcc_crm';
+export type MetricEventProduct = 'webex' | 'wxcc_desktop' | 'wxcc_crm' | 'wxcc_sdk';
 
 export type MetricEventAgent = 'user' | 'browser' | 'system' | 'sdk' | 'redux' | 'service' | 'api';
 
@@ -287,6 +287,13 @@ export type SubmitOperationalEvent = (args: {
   payload: EventPayload;
 }) => void;
 
+export type SubmitBusinessEvent = (args: {
+  name: OperationalEvent['metricName'];
+  payload: EventPayload;
+  metadata?: EventPayload;
+  table?: Table;
+}) => void;
+
 export type SubmitMQE = (args: {
   name: MediaQualityEvent['name'];
   payload: SubmitMQEPayload;

package/src/new-metrics.ts

@@ -22,6 +22,7 @@ import {
   InternalEvent,
   SubmitClientEventOptions,
   Table,
+  DelayedClientEvent,
 } from './metrics.types';
 import CallDiagnosticLatencies from './call-diagnostic/call-diagnostic-metrics-latencies';
 import {setMetricTimings} from './call-diagnostic/call-diagnostic-metrics.util';
@@ -50,6 +51,11 @@ class Metrics extends WebexPlugin {
    */
   delaySubmitClientEvents = false;
 
+  /**
+   * Overrides for delayed client events. E.g. if you want to override the correlationId for all delayed client events, you can set this to { correlationId: 'newCorrelationId' }
+   */
+  delayedClientEventsOverrides: Partial<DelayedClientEvent['options']> = {};
+
   /**
    * Constructor
    * @param args
@@ -74,6 +80,10 @@ class Metrics extends WebexPlugin {
       // @ts-ignore
       this.callDiagnosticMetrics = new CallDiagnosticMetrics({}, {parent: this.webex});
       this.isReady = true;
+      this.setDelaySubmitClientEvents({
+        shouldDelay: this.delaySubmitClientEvents,
+        overrides: this.delayedClientEventsOverrides,
+      });
     });
   }
 
@@ -404,13 +414,20 @@ class Metrics extends WebexPlugin {
    * Sets the value of delaySubmitClientEvents. If set to true, client events will be delayed until submitDelayedClientEvents is called. If
    * set to false, delayed client events will be submitted.
    *
-   * @param {boolean} shouldDelay - A boolean value indicating whether to delay the submission of client events.
+   * @param {object} options - {shouldDelay: A boolean value indicating whether to delay the submission of client events, overrides: An object containing overrides for the client events}
    */
-  public setDelaySubmitClientEvents(shouldDelay: boolean) {
+  public setDelaySubmitClientEvents({
+    shouldDelay,
+    overrides,
+  }: {
+    shouldDelay: boolean;
+    overrides?: Partial<DelayedClientEvent['options']>;
+  }) {
     this.delaySubmitClientEvents = shouldDelay;
+    this.delayedClientEventsOverrides = overrides || {};
 
-    if (!shouldDelay) {
-      return this.callDiagnosticMetrics.submitDelayedClientEvents();
+    if (this.isReady && !shouldDelay) {
+      return this.callDiagnosticMetrics.submitDelayedClientEvents(overrides);
     }
 
     return Promise.resolve();