@webex/contact-center 3.11.0-next.16 → 3.11.0-next.18

package/dist/services/core/websocket/WebSocketManager.js

@@ -79,11 +79,23 @@ class WebSocketManager extends _events.default {
   }
   async register(connectionConfig) {
     try {
+      // X-ORGANIZATION-ID header is only required for INT environments
+      const isIntEnv = this.webex.internal?.services?.isIntegrationEnvironment() || false;
+      const orgId = this.webex.credentials.getOrgId();
+      if (isIntEnv && orgId) {
+        _loggerProxy.default.log(`[WebSocketManager] Adding X-ORGANIZATION-ID header for INT environment`, {
+          module: _constants3.WEB_SOCKET_MANAGER_FILE,
+          method: _constants2.METHODS.REGISTER
+        });
+      }
       const subscribeResponse = await this.webex.request({
         service: _constants.WCC_API_GATEWAY,
         resource: _constants.SUBSCRIBE_API,
         method: _types.HTTP_METHODS.POST,
-        body: connectionConfig
+        body: connectionConfig,
+        headers: isIntEnv && orgId ? {
+          'X-ORGANIZATION-ID': orgId
+        } : undefined
       });
       this.url = subscribeResponse.body.webSocketUrl;
     } catch (e) {

package/dist/services/core/websocket/WebSocketManager.js.map

@@ -1 +1 @@
-{"version":3,"names":["_events","_interopRequireDefault","require","_types","_constants","_types2","_loggerProxy","_keepalive","_constants2","_constants3","e","__esModule","default","WebSocketManager","EventEmitter","url","welcomePromiseResolve","constructor","options","webex","shouldReconnect","websocket","isSocketClosed","isWelcomeReceived","forceCloseWebSocketOnTimeout","isConnectionLost","workerScriptBlob","Blob","workerScript","type","keepaliveWorker","Worker","URL","createObjectURL","initWebSocket","connectionConfig","body","register","error","LoggerProxy","module","WEB_SOCKET_MANAGER_FILE","method","METHODS","INIT_WEB_SOCKET","Promise","resolve","reject","connect","catch","close","reason","postMessage","log","CLOSE","handleConnectionLost","event","subscribeResponse","request","service","WCC_API_GATEWAY","resource","SUBSCRIBE_API","HTTP_METHODS","POST","webSocketUrl","REGISTER","undefined","CONNECT","WebSocket","onopen","send","JSON","stringify","keepalive","onmessage","keepAliveEvent","data","intervalDuration","KEEPALIVE_WORKER_INTERVAL","closeSocketTimeout","CLOSE_SOCKET_TIMEOUT","onerror","onclose","webSocketOnCloseHandler","emit","eventData","parse","CC_EVENTS","WELCOME","issueReason","onlineStatus","navigator","onLine","WEB_SOCKET_ON_CLOSE_HANDLER","exports"],"sources":["WebSocketManager.ts"],"sourcesContent":["import EventEmitter from 'events';\nimport {WebexSDK, SubscribeRequest, HTTP_METHODS} from '../../../types';\nimport {SUBSCRIBE_API, WCC_API_GATEWAY} from '../../constants';\nimport {ConnectionLostDetails} from './types';\nimport {CC_EVENTS, SubscribeResponse, WelcomeResponse} from '../../config/types';\nimport LoggerProxy from '../../../logger-proxy';\nimport workerScript from './keepalive.worker';\nimport {KEEPALIVE_WORKER_INTERVAL, CLOSE_SOCKET_TIMEOUT, METHODS} from '../constants';\nimport {WEB_SOCKET_MANAGER_FILE} from '../../../constants';\n\n/**\n * WebSocketManager handles the WebSocket connection for Contact Center operations.\n * It manages the connection lifecycle, including registration, reconnection, and message handling.\n * It also utilizes a Web Worker to manage keepalive messages and socket closure.\n * @ignore\n */\nexport class WebSocketManager extends EventEmitter {\n  private websocket: WebSocket;\n  shouldReconnect: boolean;\n  isSocketClosed: boolean;\n  private isWelcomeReceived: boolean;\n  private url: string | null = null;\n  private forceCloseWebSocketOnTimeout: boolean;\n  private isConnectionLost: boolean;\n  private webex: WebexSDK;\n  private welcomePromiseResolve:\n    | ((value: WelcomeResponse | PromiseLike<WelcomeResponse>) => void)\n    | null = null;\n\n  private keepaliveWorker: Worker;\n\n  constructor(options: {webex: WebexSDK}) {\n    super();\n    const {webex} = options;\n    this.webex = webex;\n    this.shouldReconnect = true;\n    this.websocket = {} as WebSocket;\n    this.isSocketClosed = false;\n    this.isWelcomeReceived = false;\n    this.forceCloseWebSocketOnTimeout = false;\n    this.isConnectionLost = false;\n\n    const workerScriptBlob = new Blob([workerScript], {type: 'application/javascript'});\n    this.keepaliveWorker = new Worker(URL.createObjectURL(workerScriptBlob));\n  }\n\n  async initWebSocket(options: {body: SubscribeRequest}): Promise<WelcomeResponse> {\n    const connectionConfig = options.body;\n    try {\n      await this.register(connectionConfig);\n    } catch (error) {\n      LoggerProxy.error(`[WebSocketStatus] | Error in registering Websocket ${error}`, {\n        module: WEB_SOCKET_MANAGER_FILE,\n        method: METHODS.INIT_WEB_SOCKET,\n      });\n      throw error;\n    }\n\n    return new Promise((resolve, reject) => {\n      this.welcomePromiseResolve = resolve;\n      this.connect().catch((error) => {\n        LoggerProxy.error(`[WebSocketStatus] | Error in connecting Websocket ${error}`, {\n          module: WEB_SOCKET_MANAGER_FILE,\n          method: METHODS.INIT_WEB_SOCKET,\n        });\n        reject(error);\n      });\n    });\n  }\n\n  close(shouldReconnect: boolean, reason = 'Unknown') {\n    if (!this.isSocketClosed && this.shouldReconnect) {\n      this.shouldReconnect = shouldReconnect;\n      this.websocket.close();\n      this.keepaliveWorker.postMessage({type: 'terminate'});\n      LoggerProxy.log(\n        `[WebSocketStatus] | event=webSocketClose | WebSocket connection closed manually REASON: ${reason}`,\n        {module: WEB_SOCKET_MANAGER_FILE, method: METHODS.CLOSE}\n      );\n    }\n  }\n\n  handleConnectionLost(event: ConnectionLostDetails) {\n    this.isConnectionLost = event.isConnectionLost;\n  }\n\n  private async register(connectionConfig: SubscribeRequest) {\n    try {\n      const subscribeResponse: SubscribeResponse = await this.webex.request({\n        service: WCC_API_GATEWAY,\n        resource: SUBSCRIBE_API,\n        method: HTTP_METHODS.POST,\n        body: connectionConfig,\n      });\n      this.url = subscribeResponse.body.webSocketUrl;\n    } catch (e) {\n      LoggerProxy.error(\n        `Register API Failed, Request to RoutingNotifs websocket registration API failed ${e}`,\n        {module: WEB_SOCKET_MANAGER_FILE, method: METHODS.REGISTER}\n      );\n      throw e;\n    }\n  }\n\n  private async connect() {\n    if (!this.url) {\n      return undefined;\n    }\n    LoggerProxy.log(\n      `[WebSocketStatus] | event=webSocketConnecting | Connecting to WebSocket: ${this.url}`,\n      {module: WEB_SOCKET_MANAGER_FILE, method: METHODS.CONNECT}\n    );\n    this.websocket = new WebSocket(this.url);\n\n    return new Promise((resolve, reject) => {\n      this.websocket.onopen = () => {\n        this.isSocketClosed = false;\n        this.shouldReconnect = true;\n\n        this.websocket.send(JSON.stringify({keepalive: 'true'}));\n        this.keepaliveWorker.onmessage = (keepAliveEvent: {data: any}) => {\n          if (keepAliveEvent?.data?.type === 'keepalive') {\n            this.websocket.send(JSON.stringify({keepalive: 'true'}));\n          }\n\n          if (keepAliveEvent?.data?.type === 'closeSocket' && this.isConnectionLost) {\n            this.forceCloseWebSocketOnTimeout = true;\n            this.close(true, 'WebSocket did not auto close within 16 secs');\n            LoggerProxy.error(\n              '[webSocketTimeout] | event=webSocketTimeout | WebSocket connection closed forcefully',\n              {module: WEB_SOCKET_MANAGER_FILE, method: METHODS.CONNECT}\n            );\n          }\n        };\n\n        this.keepaliveWorker.postMessage({\n          type: 'start',\n          intervalDuration: KEEPALIVE_WORKER_INTERVAL, // Keepalive interval\n          isSocketClosed: this.isSocketClosed,\n          closeSocketTimeout: CLOSE_SOCKET_TIMEOUT, // Close socket timeout\n        });\n      };\n\n      this.websocket.onerror = (event: any) => {\n        LoggerProxy.error(\n          `[WebSocketStatus] | event=socketConnectionFailed | WebSocket connection failed ${event}`,\n          {module: WEB_SOCKET_MANAGER_FILE, method: METHODS.CONNECT}\n        );\n        reject();\n      };\n\n      this.websocket.onclose = async (event: any) => {\n        this.webSocketOnCloseHandler(event);\n      };\n\n      this.websocket.onmessage = (e: MessageEvent) => {\n        this.emit('message', e.data);\n        const eventData = JSON.parse(e.data);\n\n        if (eventData.type === CC_EVENTS.WELCOME) {\n          this.isWelcomeReceived = true;\n          if (this.welcomePromiseResolve) {\n            this.welcomePromiseResolve(eventData.data as WelcomeResponse);\n            this.welcomePromiseResolve = null;\n          }\n        }\n\n        if (eventData.type === 'AGENT_MULTI_LOGIN') {\n          this.close(false, 'multiLogin');\n          LoggerProxy.error(\n            '[WebSocketStatus] | event=agentMultiLogin | WebSocket connection closed by agent multiLogin',\n            {module: WEB_SOCKET_MANAGER_FILE, method: METHODS.CONNECT}\n          );\n        }\n      };\n    });\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-unused-vars\n  private async webSocketOnCloseHandler(event: any) {\n    this.isSocketClosed = true;\n    this.keepaliveWorker.postMessage({type: 'terminate'});\n    if (this.shouldReconnect) {\n      this.emit('socketClose');\n      let issueReason;\n      if (this.forceCloseWebSocketOnTimeout) {\n        issueReason = 'WebSocket auto close timed out. Forcefully closed websocket.';\n      } else {\n        const onlineStatus = navigator.onLine;\n        issueReason = !onlineStatus\n          ? 'network issue'\n          : 'missing keepalive from either desktop or notif service';\n      }\n      LoggerProxy.error(\n        `[WebSocketStatus] | event=webSocketClose | WebSocket connection closed REASON: ${issueReason}`,\n        {module: WEB_SOCKET_MANAGER_FILE, method: METHODS.WEB_SOCKET_ON_CLOSE_HANDLER}\n      );\n      this.forceCloseWebSocketOnTimeout = false;\n    }\n  }\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["_events","_interopRequireDefault","require","_types","_constants","_types2","_loggerProxy","_keepalive","_constants2","_constants3","e","__esModule","default","WebSocketManager","EventEmitter","url","welcomePromiseResolve","constructor","options","webex","shouldReconnect","websocket","isSocketClosed","isWelcomeReceived","forceCloseWebSocketOnTimeout","isConnectionLost","workerScriptBlob","Blob","workerScript","type","keepaliveWorker","Worker","URL","createObjectURL","initWebSocket","connectionConfig","body","register","error","LoggerProxy","module","WEB_SOCKET_MANAGER_FILE","method","METHODS","INIT_WEB_SOCKET","Promise","resolve","reject","connect","catch","close","reason","postMessage","log","CLOSE","handleConnectionLost","event","isIntEnv","internal","services","isIntegrationEnvironment","orgId","credentials","getOrgId","REGISTER","subscribeResponse","request","service","WCC_API_GATEWAY","resource","SUBSCRIBE_API","HTTP_METHODS","POST","headers","undefined","webSocketUrl","CONNECT","WebSocket","onopen","send","JSON","stringify","keepalive","onmessage","keepAliveEvent","data","intervalDuration","KEEPALIVE_WORKER_INTERVAL","closeSocketTimeout","CLOSE_SOCKET_TIMEOUT","onerror","onclose","webSocketOnCloseHandler","emit","eventData","parse","CC_EVENTS","WELCOME","issueReason","onlineStatus","navigator","onLine","WEB_SOCKET_ON_CLOSE_HANDLER","exports"],"sources":["WebSocketManager.ts"],"sourcesContent":["import EventEmitter from 'events';\nimport {WebexSDK, SubscribeRequest, HTTP_METHODS} from '../../../types';\nimport {SUBSCRIBE_API, WCC_API_GATEWAY} from '../../constants';\nimport {ConnectionLostDetails} from './types';\nimport {CC_EVENTS, SubscribeResponse, WelcomeResponse} from '../../config/types';\nimport LoggerProxy from '../../../logger-proxy';\nimport workerScript from './keepalive.worker';\nimport {KEEPALIVE_WORKER_INTERVAL, CLOSE_SOCKET_TIMEOUT, METHODS} from '../constants';\nimport {WEB_SOCKET_MANAGER_FILE} from '../../../constants';\n\n/**\n * WebSocketManager handles the WebSocket connection for Contact Center operations.\n * It manages the connection lifecycle, including registration, reconnection, and message handling.\n * It also utilizes a Web Worker to manage keepalive messages and socket closure.\n * @ignore\n */\nexport class WebSocketManager extends EventEmitter {\n  private websocket: WebSocket;\n  shouldReconnect: boolean;\n  isSocketClosed: boolean;\n  private isWelcomeReceived: boolean;\n  private url: string | null = null;\n  private forceCloseWebSocketOnTimeout: boolean;\n  private isConnectionLost: boolean;\n  private webex: WebexSDK;\n  private welcomePromiseResolve:\n    | ((value: WelcomeResponse | PromiseLike<WelcomeResponse>) => void)\n    | null = null;\n\n  private keepaliveWorker: Worker;\n\n  constructor(options: {webex: WebexSDK}) {\n    super();\n    const {webex} = options;\n    this.webex = webex;\n    this.shouldReconnect = true;\n    this.websocket = {} as WebSocket;\n    this.isSocketClosed = false;\n    this.isWelcomeReceived = false;\n    this.forceCloseWebSocketOnTimeout = false;\n    this.isConnectionLost = false;\n\n    const workerScriptBlob = new Blob([workerScript], {type: 'application/javascript'});\n    this.keepaliveWorker = new Worker(URL.createObjectURL(workerScriptBlob));\n  }\n\n  async initWebSocket(options: {body: SubscribeRequest}): Promise<WelcomeResponse> {\n    const connectionConfig = options.body;\n    try {\n      await this.register(connectionConfig);\n    } catch (error) {\n      LoggerProxy.error(`[WebSocketStatus] | Error in registering Websocket ${error}`, {\n        module: WEB_SOCKET_MANAGER_FILE,\n        method: METHODS.INIT_WEB_SOCKET,\n      });\n      throw error;\n    }\n\n    return new Promise((resolve, reject) => {\n      this.welcomePromiseResolve = resolve;\n      this.connect().catch((error) => {\n        LoggerProxy.error(`[WebSocketStatus] | Error in connecting Websocket ${error}`, {\n          module: WEB_SOCKET_MANAGER_FILE,\n          method: METHODS.INIT_WEB_SOCKET,\n        });\n        reject(error);\n      });\n    });\n  }\n\n  close(shouldReconnect: boolean, reason = 'Unknown') {\n    if (!this.isSocketClosed && this.shouldReconnect) {\n      this.shouldReconnect = shouldReconnect;\n      this.websocket.close();\n      this.keepaliveWorker.postMessage({type: 'terminate'});\n      LoggerProxy.log(\n        `[WebSocketStatus] | event=webSocketClose | WebSocket connection closed manually REASON: ${reason}`,\n        {module: WEB_SOCKET_MANAGER_FILE, method: METHODS.CLOSE}\n      );\n    }\n  }\n\n  handleConnectionLost(event: ConnectionLostDetails) {\n    this.isConnectionLost = event.isConnectionLost;\n  }\n\n  private async register(connectionConfig: SubscribeRequest) {\n    try {\n      // X-ORGANIZATION-ID header is only required for INT environments\n      const isIntEnv = this.webex.internal?.services?.isIntegrationEnvironment() || false;\n      const orgId = this.webex.credentials.getOrgId();\n\n      if (isIntEnv && orgId) {\n        LoggerProxy.log(`[WebSocketManager] Adding X-ORGANIZATION-ID header for INT environment`, {\n          module: WEB_SOCKET_MANAGER_FILE,\n          method: METHODS.REGISTER,\n        });\n      }\n\n      const subscribeResponse: SubscribeResponse = await this.webex.request({\n        service: WCC_API_GATEWAY,\n        resource: SUBSCRIBE_API,\n        method: HTTP_METHODS.POST,\n        body: connectionConfig,\n        headers: isIntEnv && orgId ? {'X-ORGANIZATION-ID': orgId} : undefined,\n      });\n      this.url = subscribeResponse.body.webSocketUrl;\n    } catch (e) {\n      LoggerProxy.error(\n        `Register API Failed, Request to RoutingNotifs websocket registration API failed ${e}`,\n        {module: WEB_SOCKET_MANAGER_FILE, method: METHODS.REGISTER}\n      );\n      throw e;\n    }\n  }\n\n  private async connect() {\n    if (!this.url) {\n      return undefined;\n    }\n    LoggerProxy.log(\n      `[WebSocketStatus] | event=webSocketConnecting | Connecting to WebSocket: ${this.url}`,\n      {module: WEB_SOCKET_MANAGER_FILE, method: METHODS.CONNECT}\n    );\n    this.websocket = new WebSocket(this.url);\n\n    return new Promise((resolve, reject) => {\n      this.websocket.onopen = () => {\n        this.isSocketClosed = false;\n        this.shouldReconnect = true;\n\n        this.websocket.send(JSON.stringify({keepalive: 'true'}));\n        this.keepaliveWorker.onmessage = (keepAliveEvent: {data: any}) => {\n          if (keepAliveEvent?.data?.type === 'keepalive') {\n            this.websocket.send(JSON.stringify({keepalive: 'true'}));\n          }\n\n          if (keepAliveEvent?.data?.type === 'closeSocket' && this.isConnectionLost) {\n            this.forceCloseWebSocketOnTimeout = true;\n            this.close(true, 'WebSocket did not auto close within 16 secs');\n            LoggerProxy.error(\n              '[webSocketTimeout] | event=webSocketTimeout | WebSocket connection closed forcefully',\n              {module: WEB_SOCKET_MANAGER_FILE, method: METHODS.CONNECT}\n            );\n          }\n        };\n\n        this.keepaliveWorker.postMessage({\n          type: 'start',\n          intervalDuration: KEEPALIVE_WORKER_INTERVAL, // Keepalive interval\n          isSocketClosed: this.isSocketClosed,\n          closeSocketTimeout: CLOSE_SOCKET_TIMEOUT, // Close socket timeout\n        });\n      };\n\n      this.websocket.onerror = (event: any) => {\n        LoggerProxy.error(\n          `[WebSocketStatus] | event=socketConnectionFailed | WebSocket connection failed ${event}`,\n          {module: WEB_SOCKET_MANAGER_FILE, method: METHODS.CONNECT}\n        );\n        reject();\n      };\n\n      this.websocket.onclose = async (event: any) => {\n        this.webSocketOnCloseHandler(event);\n      };\n\n      this.websocket.onmessage = (e: MessageEvent) => {\n        this.emit('message', e.data);\n        const eventData = JSON.parse(e.data);\n\n        if (eventData.type === CC_EVENTS.WELCOME) {\n          this.isWelcomeReceived = true;\n          if (this.welcomePromiseResolve) {\n            this.welcomePromiseResolve(eventData.data as WelcomeResponse);\n            this.welcomePromiseResolve = null;\n          }\n        }\n\n        if (eventData.type === 'AGENT_MULTI_LOGIN') {\n          this.close(false, 'multiLogin');\n          LoggerProxy.error(\n            '[WebSocketStatus] | event=agentMultiLogin | WebSocket connection closed by agent multiLogin',\n            {module: WEB_SOCKET_MANAGER_FILE, method: METHODS.CONNECT}\n          );\n        }\n      };\n    });\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-unused-vars\n  private async webSocketOnCloseHandler(event: any) {\n    this.isSocketClosed = true;\n    this.keepaliveWorker.postMessage({type: 'terminate'});\n    if (this.shouldReconnect) {\n      this.emit('socketClose');\n      let issueReason;\n      if (this.forceCloseWebSocketOnTimeout) {\n        issueReason = 'WebSocket auto close timed out. Forcefully closed websocket.';\n      } else {\n        const onlineStatus = navigator.onLine;\n        issueReason = !onlineStatus\n          ? 'network issue'\n          : 'missing keepalive from either desktop or notif service';\n      }\n      LoggerProxy.error(\n        `[WebSocketStatus] | event=webSocketClose | WebSocket connection closed REASON: ${issueReason}`,\n        {module: WEB_SOCKET_MANAGER_FILE, method: METHODS.WEB_SOCKET_ON_CLOSE_HANDLER}\n      );\n      this.forceCloseWebSocketOnTimeout = false;\n    }\n  }\n}\n"],"mappings":"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","ignoreList":[]}

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"names":["HTTP_METHODS","exports","GET","POST","PATCH","PUT","DELETE","LOGGING_LEVEL","LoginOption","AGENT_DN","EXTENSION","BROWSER"],"sources":["types.ts"],"sourcesContent":["import {CallingClientConfig} from '@webex/calling';\nimport {\n  SubmitBehavioralEvent,\n  SubmitOperationalEvent,\n  SubmitBusinessEvent,\n} from '@webex/internal-plugin-metrics/src/metrics.types';\nimport * as Agent from './services/agent/types';\nimport * as Contact from './services/task/types';\nimport {Profile} from './services/config/types';\nimport {PaginatedResponse, BaseSearchParams} from './utils/PageCache';\n\n/**\n * Generic type for converting a const enum object into a union type of its values.\n * @template T The enum object type\n * @internal\n * @ignore\n */\ntype Enum<T extends Record<string, unknown>> = T[keyof T];\n\n/**\n * HTTP methods supported by WebexRequest.\n * @enum {string}\n * @public\n * @example\n * const method: HTTP_METHODS = HTTP_METHODS.GET;\n * @ignore\n */\nexport const HTTP_METHODS = {\n  /** HTTP GET method for retrieving data */\n  GET: 'GET',\n  /** HTTP POST method for creating resources */\n  POST: 'POST',\n  /** HTTP PATCH method for partial updates */\n  PATCH: 'PATCH',\n  /** HTTP PUT method for complete updates */\n  PUT: 'PUT',\n  /** HTTP DELETE method for removing resources */\n  DELETE: 'DELETE',\n} as const;\n\n/**\n * Union type of HTTP methods.\n * @public\n * @example\n * function makeRequest(method: HTTP_METHODS) { ... }\n * @ignore\n */\nexport type HTTP_METHODS = Enum<typeof HTTP_METHODS>;\n\n/**\n * Payload for making requests to Webex APIs.\n * @public\n * @example\n * const payload: WebexRequestPayload = {\n *   service: 'identity',\n *   resource: '/users',\n *   method: HTTP_METHODS.GET\n * };\n * @ignore\n */\nexport type WebexRequestPayload = {\n  /** Service name to target */\n  service?: string;\n  /** Resource path within the service */\n  resource?: string;\n  /** HTTP method to use */\n  method?: HTTP_METHODS;\n  /** Full URI if not using service/resource pattern */\n  uri?: string;\n  /** Whether to add authorization header */\n  addAuthHeader?: boolean;\n  /** Custom headers to include in request */\n  headers?: {\n    [key: string]: string | null;\n  };\n  /** Request body data */\n  body?: object;\n  /** Expected response status code */\n  statusCode?: number;\n  /** Whether to parse response as JSON */\n  json?: boolean;\n};\n\n/**\n * Event listener function type.\n * @internal\n * @ignore\n */\ntype Listener = (e: string, data?: unknown) => void;\n\n/**\n * Event listener removal function type.\n * @internal\n * @ignore\n */\ntype ListenerOff = (e: string) => void;\n\n/**\n * Service host configuration.\n * @internal\n * @ignore\n */\ntype ServiceHost = {\n  /** Host URL/domain for the service */\n  host: string;\n  /** Time-to-live in seconds */\n  ttl: number;\n  /** Priority level for load balancing (lower is higher priority) */\n  priority: number;\n  /** Unique identifier for this host */\n  id: string;\n  /** Whether this is the home cluster for the user */\n  homeCluster?: boolean;\n};\n\n/**\n * Configuration options for the Contact Center Plugin.\n * @interface CCPluginConfig\n * @public\n * @example\n * const config: CCPluginConfig = {\n *   allowMultiLogin: true,\n *   allowAutomatedRelogin: false,\n *   clientType: 'browser',\n *   isKeepAliveEnabled: true,\n *   force: false,\n *   metrics: { clientName: 'myClient', clientType: 'browser' },\n *   logging: { enable: true, verboseEvents: false },\n *   callingClientConfig: { ... }\n * };\n */\nexport interface CCPluginConfig {\n  /** Whether to allow multiple logins from different devices */\n  allowMultiLogin: boolean;\n  /** Whether to automatically attempt relogin on connection loss */\n  allowAutomatedRelogin: boolean;\n  /** The type of client making the connection */\n  clientType: string;\n  /** Whether to enable keep-alive messages */\n  isKeepAliveEnabled: boolean;\n  /** Whether to force registration */\n  force: boolean;\n  /** Metrics configuration */\n  metrics: {\n    /** Name of the client for metrics */\n    clientName: string;\n    /** Type of client for metrics */\n    clientType: string;\n  };\n  /** Logging configuration */\n  logging: {\n    /** Whether to enable logging */\n    enable: boolean;\n    /** Whether to log verbose events */\n    verboseEvents: boolean;\n  };\n  /** Configuration for the calling client */\n  callingClientConfig: CallingClientConfig;\n}\n\n/**\n * Logger interface for standardized logging throughout the plugin.\n * @public\n * @example\n * logger.log('This is a log message');\n * logger.error('This is an error message');\n * @ignore\n */\nexport type Logger = {\n  /** Log general messages */\n  log: (payload: string) => void;\n  /** Log error messages */\n  error: (payload: string) => void;\n  /** Log warning messages */\n  warn: (payload: string) => void;\n  /** Log informational messages */\n  info: (payload: string) => void;\n  /** Log detailed trace messages */\n  trace: (payload: string) => void;\n  /** Log debug messages */\n  debug: (payload: string) => void;\n};\n\n/**\n * Contextual information for log entries.\n * @public\n * @ignore\n */\nexport interface LogContext {\n  /** Module name where the log originated */\n  module?: string;\n  /** Method name where the log originated */\n  method?: string;\n  interactionId?: string;\n  trackingId?: string;\n  /** Additional structured data to include in logs */\n  data?: Record<string, any>;\n  /** Error object to include in logs */\n  error?: Error | unknown;\n}\n\n/**\n * Available logging severity levels.\n * @enum {string}\n * @public\n * @example\n * const level: LOGGING_LEVEL = LOGGING_LEVEL.error;\n * @ignore\n */\nexport enum LOGGING_LEVEL {\n  /** Critical failures that require immediate attention */\n  error = 'ERROR',\n  /** Important issues that don't prevent the system from working */\n  warn = 'WARN',\n  /** General informational logs */\n  log = 'LOG',\n  /** Detailed information about system operation */\n  info = 'INFO',\n  /** Highly detailed diagnostic information */\n  trace = 'TRACE',\n}\n\n/**\n * Metadata for log uploads.\n * @public\n * @example\n * const meta: LogsMetaData = { feedbackId: 'fb123', correlationId: 'corr456' };\n * @ignore\n */\nexport type LogsMetaData = {\n  /** Optional feedback ID to associate with logs */\n  feedbackId?: string;\n  /** Optional correlation ID to track related operations */\n  correlationId?: string;\n};\n\n/**\n * Response from uploading logs to the server.\n * @public\n * @example\n * const response: UploadLogsResponse = { trackingid: 'track123', url: 'https://...', userId: 'user1' };\n */\nexport type UploadLogsResponse = {\n  /** Tracking ID for the upload request */\n  trackingid?: string;\n  /** URL where the logs can be accessed */\n  url?: string;\n  /** ID of the user who uploaded logs */\n  userId?: string;\n  /** Feedback ID associated with the logs */\n  feedbackId?: string;\n  /** Correlation ID for tracking related operations */\n  correlationId?: string;\n};\n\n/**\n * Internal Webex SDK interfaces needed for plugin integration.\n * @internal\n * @ignore\n */\ninterface IWebexInternal {\n  /** Mercury service for real-time messaging */\n  mercury: {\n    /** Register an event listener */\n    on: Listener;\n    /** Remove an event listener */\n    off: ListenerOff;\n    /** Establish a connection to the Mercury service */\n    connect: () => Promise<void>;\n    /** Disconnect from the Mercury service */\n    disconnect: () => Promise<void>;\n    /** Whether Mercury is currently connected */\n    connected: boolean;\n    /** Whether Mercury is in the process of connecting */\n    connecting: boolean;\n  };\n  /** Device information */\n  device: {\n    /** Current WDM URL */\n    url: string;\n    /** Current user's ID */\n    userId: string;\n    /** Current organization ID */\n    orgId: string;\n    /** Device version */\n    version: string;\n    /** Calling behavior configuration */\n    callingBehavior: string;\n  };\n  /** Presence service */\n  presence: unknown;\n  /** Services discovery and management */\n  services: {\n    /** Get a service URL by name */\n    get: (service: string) => string;\n    /** Wait for service catalog to be loaded */\n    waitForCatalog: (service: string) => Promise<void>;\n    /** Host catalog for service discovery */\n    _hostCatalog: Record<string, ServiceHost[]>;\n    /** Service URLs cache */\n    _serviceUrls: {\n      /** Mobius calling service */\n      mobius: string;\n      /** Identity service */\n      identity: string;\n      /** Janus media server */\n      janus: string;\n      /** WDM (WebEx Device Management) service */\n      wdm: string;\n      /** BroadWorks IDP proxy service */\n      broadworksIdpProxy: string;\n      /** Hydra API service */\n      hydra: string;\n      /** Mercury API service */\n      mercuryApi: string;\n      /** UC Management gateway service */\n      'ucmgmt-gateway': string;\n      /** Contacts service */\n      contactsService: string;\n    };\n  };\n  /** Metrics collection services */\n  newMetrics: {\n    /** Submit behavioral events (user actions) */\n    submitBehavioralEvent: SubmitBehavioralEvent;\n    /** Submit operational events (system operations) */\n    submitOperationalEvent: SubmitOperationalEvent;\n    /** Submit business events (business outcomes) */\n    submitBusinessEvent: SubmitBusinessEvent;\n  };\n  /** Support functionality */\n  support: {\n    /** Submit logs to server */\n    submitLogs: (\n      metaData: LogsMetaData,\n      logs: string,\n      options: {\n        /** Whether to submit full logs or just differences */\n        type: 'diff' | 'full';\n      }\n    ) => Promise<UploadLogsResponse>;\n  };\n}\n\n/**\n * Interface representing the WebexSDK core functionality.\n * @interface WebexSDK\n * @public\n * @example\n * const sdk: WebexSDK = ...;\n * sdk.request({ service: 'identity', resource: '/users', method: HTTP_METHODS.GET });\n * @ignore\n */\nexport interface WebexSDK {\n  /** Version of the WebexSDK */\n  version: string;\n  /** Whether the SDK can authorize requests */\n  canAuthorize: boolean;\n  /** Credentials management */\n  credentials: {\n    /** Get the user token for authentication */\n    getUserToken: () => Promise<string>;\n    /** Get the organization ID */\n    getOrgId: () => string;\n  };\n  /** Whether the SDK is ready for use */\n  ready: boolean;\n  /** Make a request to the Webex APIs */\n  request: <T>(payload: WebexRequestPayload) => Promise<T>;\n  /** Register a one-time event handler */\n  once: (event: string, callBack: () => void) => void;\n  /** Internal plugins and services */\n  internal: IWebexInternal;\n  /** Logger instance */\n  logger: Logger;\n}\n\n/**\n * An interface for the `ContactCenter` class.\n * The `ContactCenter` package is designed to provide a set of APIs to perform various operations for the Agent flow within Webex Contact Center.\n * @public\n * @example\n * const cc: IContactCenter = ...;\n * cc.register().then(profile => { ... });\n * @ignore\n */\nexport interface IContactCenter {\n  /**\n   * Initialize the CC SDK by setting up the contact center mercury connection.\n   * This establishes WebSocket connectivity for real-time communication.\n   *\n   * @returns A Promise that resolves to the agent's profile upon successful registration\n   * @public\n   * @example\n   * cc.register().then(profile => { ... });\n   */\n  register(): Promise<Profile>;\n}\n\n/**\n * Generic HTTP response structure.\n * @public\n * @example\n * const response: IHttpResponse = { body: {}, statusCode: 200, method: 'GET', headers: {}, url: '...' };\n * @ignore\n */\nexport interface IHttpResponse {\n  /** Response body content */\n  body: any;\n  /** HTTP status code */\n  statusCode: number;\n  /** HTTP method used for the request */\n  method: string;\n  /** Response headers */\n  headers: Headers;\n  /** Request URL */\n  url: string;\n}\n\n/**\n * Supported login options for agent authentication.\n * @public\n * @example\n * const option: LoginOption = LoginOption.AGENT_DN;\n * @ignore\n */\nexport const LoginOption = {\n  /** Login using agent's direct number */\n  AGENT_DN: 'AGENT_DN',\n  /** Login using an extension number */\n  EXTENSION: 'EXTENSION',\n  /** Login using browser WebRTC capabilities */\n  BROWSER: 'BROWSER',\n} as const;\n\n/**\n * Union type of login options.\n * @public\n * @example\n * function login(option: LoginOption) { ... }\n * @ignore\n */\nexport type LoginOption = Enum<typeof LoginOption>;\n\n/**\n * Request payload for subscribing to the contact center websocket.\n * @public\n * @example\n * const req: SubscribeRequest = { force: true, isKeepAliveEnabled: true, clientType: 'browser', allowMultiLogin: false };\n * @ignore\n */\nexport type SubscribeRequest = {\n  /** Whether to force connection even if another exists */\n  force: boolean;\n  /** Whether to send keepalive messages */\n  isKeepAliveEnabled: boolean;\n  /** Type of client connecting */\n  clientType: string;\n  /** Whether to allow login from multiple devices */\n  allowMultiLogin: boolean;\n};\n\n/**\n * Represents the response from getListOfTeams method.\n * Teams are groups of agents that can be managed together.\n * @public\n * @example\n * const team: Team = { id: 'team1', name: 'Support', desktopLayoutId: 'layout1' };\n * @ignore\n */\nexport type Team = {\n  /**\n   * Unique identifier of the team.\n   */\n  id: string;\n\n  /**\n   * Display name of the team.\n   */\n  name: string;\n\n  /**\n   * Associated desktop layout ID for the team.\n   * Controls how the agent desktop is displayed for team members.\n   */\n  desktopLayoutId?: string;\n};\n\n/**\n * Represents the request to perform agent login.\n * @public\n * @example\n * const login: AgentLogin = { dialNumber: '1234', teamId: 'team1', loginOption: LoginOption.AGENT_DN };\n */\nexport type AgentLogin = {\n  /**\n   * A dialNumber field contains the number to dial such as a route point or extension.\n   * Required for AGENT_DN and EXTENSION login options.\n   */\n  dialNumber?: string;\n\n  /**\n   * The unique ID representing a team of users.\n   * The agent must belong to this team.\n   */\n  teamId: string;\n\n  /**\n   * The loginOption field specifies the type of login method.\n   * Controls how calls are delivered to the agent.\n   */\n  loginOption: LoginOption;\n};\n\n/**\n * Represents the request to update agent profile settings.\n * @public\n * @example\n * const update: AgentProfileUpdate = { loginOption: LoginOption.BROWSER, dialNumber: '5678' };\n */\nexport type AgentProfileUpdate = Pick<AgentLogin, 'loginOption' | 'dialNumber' | 'teamId'>;\n\n/**\n * Union type for all possible request body types.\n * @internal\n * @ignore\n */\nexport type RequestBody =\n  | SubscribeRequest\n  | Agent.Logout\n  | Agent.UserStationLogin\n  | Agent.StateChange\n  | Agent.BuddyAgents\n  | Contact.HoldResumePayload\n  | Contact.ResumeRecordingPayload\n  | Contact.ConsultPayload\n  | Contact.ConsultEndAPIPayload // API Payload accepts only QueueId wheres SDK API allows more params\n  | Contact.TransferPayLoad\n  | Contact.ConsultTransferPayLoad\n  | Contact.cancelCtq\n  | Contact.WrapupPayLoad\n  | Contact.DialerPayload;\n\n/**\n * Represents the options to fetch buddy agents for the logged in agent.\n * Buddy agents are other agents who can be consulted or transfered to.\n * @public\n * @example\n * const opts: BuddyAgents = { mediaType: 'telephony', state: 'Available' };\n * @ignore\n */\nexport type BuddyAgents = {\n  /**\n   * The media type channel to filter buddy agents.\n   * Determines which channel capability the returned agents must have.\n   */\n  mediaType: 'telephony' | 'chat' | 'social' | 'email';\n\n  /**\n   * Optional filter for agent state.\n   * If specified, returns only agents in that state.\n   * If omitted, returns both available and idle agents.\n   */\n  state?: 'Available' | 'Idle';\n};\n\n/**\n * Generic error structure for Contact Center SDK errors.\n * Contains detailed information about the error context.\n * @public\n * @example\n * const err: GenericError = new Error('Failed');\n * err.details = { type: 'ERR', orgId: 'org1', trackingId: 'track1', data: {} };\n * @ignore\n */\nexport interface GenericError extends Error {\n  /** Structured details about the error */\n  details: {\n    /** Error type identifier */\n    type: string;\n    /** Organization ID where the error occurred */\n    orgId: string;\n    /** Unique tracking ID for the error */\n    trackingId: string;\n    /** Additional error context data */\n    data: Record<string, any>;\n  };\n}\n\n/**\n * Response type for station login operations.\n * Either a success response with agent details or an error.\n * @public\n * @example\n * function handleLogin(resp: StationLoginResponse) { ... }\n */\nexport type StationLoginResponse = Agent.StationLoginSuccessResponse | Error;\n\n/**\n * Response type for station logout operations.\n * Either a success response with logout details or an error.\n * @public\n * @example\n * function handleLogout(resp: StationLogoutResponse) { ... }\n */\nexport type StationLogoutResponse = Agent.LogoutSuccess | Error;\n\n/**\n * Response type for station relogin operations.\n * Either a success response with relogin details or an error.\n * @public\n * @example\n * function handleReLogin(resp: StationReLoginResponse) { ... }\n * @ignore\n */\nexport type StationReLoginResponse = Agent.ReloginSuccess | Error;\n\n/**\n * Response type for agent state change operations.\n * Either a success response with state change details or an error.\n * @public\n * @example\n * function handleStateChange(resp: SetStateResponse) { ... }\n * @ignore\n */\nexport type SetStateResponse = Agent.StateChangeSuccess | Error;\n\n/**\n * AddressBook types\n */\nexport interface AddressBookEntry {\n  id: string;\n  organizationId?: string;\n  version?: number;\n  name: string;\n  number: string;\n  createdTime?: number;\n  lastUpdatedTime?: number;\n}\n\nexport type AddressBookEntriesResponse = PaginatedResponse<AddressBookEntry>;\n\nexport interface AddressBookEntrySearchParams extends BaseSearchParams {\n  addressBookId?: string;\n}\n\n/**\n * EntryPointRecord types\n */\nexport interface EntryPointRecord {\n  id: string;\n  name: string;\n  description?: string;\n  type: string;\n  isActive: boolean;\n  orgId: string;\n  createdAt?: string;\n  updatedAt?: string;\n  settings?: Record<string, any>;\n}\n\nexport type EntryPointListResponse = PaginatedResponse<EntryPointRecord>;\nexport type EntryPointSearchParams = BaseSearchParams;\n\n/**\n * Queue types\n */\nexport interface QueueSkillRequirement {\n  organizationId?: string;\n  id?: string;\n  version?: number;\n  skillId: string;\n  skillName?: string;\n  skillType?: string;\n  condition: string;\n  skillValue: string;\n  createdTime?: number;\n  lastUpdatedTime?: number;\n}\n\nexport interface QueueAgent {\n  id: string;\n  ciUserId?: string;\n}\n\nexport interface AgentGroup {\n  teamId: string;\n}\n\nexport interface CallDistributionGroup {\n  agentGroups: AgentGroup[];\n  order: number;\n  duration?: number;\n}\n\nexport interface AssistantSkillMapping {\n  assistantSkillId?: string;\n  assistantSkillUpdatedTime?: number;\n}\n\n/**\n * Configuration for a contact service queue\n * @public\n */\nexport interface ContactServiceQueue {\n  /** Organization ID */\n  organizationId?: string;\n  /** Unique identifier for the queue */\n  id?: string;\n  /** Version of the queue */\n  version?: number;\n  /** Name of the Contact Service Queue */\n  name: string;\n  /** Description of the queue */\n  description?: string;\n  /** Queue type (INBOUND, OUTBOUND) */\n  queueType: 'INBOUND' | 'OUTBOUND';\n  /** Whether to check agent availability */\n  checkAgentAvailability: boolean;\n  /** Channel type (TELEPHONY, EMAIL, SOCIAL_CHANNEL, CHAT, etc.) */\n  channelType: 'TELEPHONY' | 'EMAIL' | 'FAX' | 'CHAT' | 'VIDEO' | 'OTHERS' | 'SOCIAL_CHANNEL';\n  /** Social channel type for SOCIAL_CHANNEL channelType */\n  socialChannelType?:\n    | 'MESSAGEBIRD'\n    | 'MESSENGER'\n    | 'WHATSAPP'\n    | 'APPLE_BUSINESS_CHAT'\n    | 'GOOGLE_BUSINESS_MESSAGES';\n  /** Service level threshold in seconds */\n  serviceLevelThreshold: number;\n  /** Maximum number of simultaneous contacts */\n  maxActiveContacts: number;\n  /** Maximum time in queue in seconds */\n  maxTimeInQueue: number;\n  /** Default music in queue media file ID */\n  defaultMusicInQueueMediaFileId: string;\n  /** Timezone for routing strategies */\n  timezone?: string;\n  /** Whether the queue is active */\n  active: boolean;\n  /** Whether outdial campaign is enabled */\n  outdialCampaignEnabled?: boolean;\n  /** Whether monitoring is permitted */\n  monitoringPermitted: boolean;\n  /** Whether parking is permitted */\n  parkingPermitted: boolean;\n  /** Whether recording is permitted */\n  recordingPermitted: boolean;\n  /** Whether recording all calls is permitted */\n  recordingAllCallsPermitted: boolean;\n  /** Whether pausing recording is permitted */\n  pauseRecordingPermitted: boolean;\n  /** Recording pause duration in seconds */\n  recordingPauseDuration?: number;\n  /** Control flow script URL */\n  controlFlowScriptUrl: string;\n  /** IVR requeue URL */\n  ivrRequeueUrl: string;\n  /** Overflow number for telephony */\n  overflowNumber?: string;\n  /** Vendor ID */\n  vendorId?: string;\n  /** Routing type */\n  routingType: 'LONGEST_AVAILABLE_AGENT' | 'SKILLS_BASED' | 'CIRCULAR' | 'LINEAR';\n  /** Skills-based routing type */\n  skillBasedRoutingType?: 'LONGEST_AVAILABLE_AGENT' | 'BEST_AVAILABLE_AGENT';\n  /** Queue routing type */\n  queueRoutingType: 'TEAM_BASED' | 'SKILL_BASED' | 'AGENT_BASED';\n  /** Queue skill requirements */\n  queueSkillRequirements?: QueueSkillRequirement[];\n  /** List of agents for agent-based queue */\n  agents?: QueueAgent[];\n  /** Call distribution groups */\n  callDistributionGroups: CallDistributionGroup[];\n  /** XSP version */\n  xspVersion?: string;\n  /** Subscription ID */\n  subscriptionId?: string;\n  /** Assistant skill mapping */\n  assistantSkill?: AssistantSkillMapping;\n  /** Whether this is a system default queue */\n  systemDefault?: boolean;\n  /** User who last updated agents list */\n  agentsLastUpdatedByUserName?: string;\n  /** Email of user who last updated agents list */\n  agentsLastUpdatedByUserEmailPrefix?: string;\n  /** When agents list was last updated */\n  agentsLastUpdatedTime?: number;\n  /** Creation timestamp in epoch millis */\n  createdTime?: number;\n  /** Last updated timestamp in epoch millis */\n  lastUpdatedTime?: number;\n}\n\nexport type ContactServiceQueuesResponse = PaginatedResponse<ContactServiceQueue>;\n\nexport interface ContactServiceQueueSearchParams extends BaseSearchParams {\n  desktopProfileFilter?: boolean;\n  provisioningView?: boolean;\n  singleObjectResponse?: boolean;\n}\n\n/**\n * Response type for buddy agents query operations.\n * Either a success response with list of buddy agents or an error.\n * @public\n * @example\n * function handleBuddyAgents(resp: BuddyAgentsResponse) { ... }\n */\nexport type BuddyAgentsResponse = Agent.BuddyAgentsSuccess | Error;\n\n/**\n * Response type for device type update operations.\n * Either a success response with update confirmation or an error.\n * @public\n * @example\n * function handleUpdateDeviceType(resp: UpdateDeviceTypeResponse) { ... }\n */\nexport type UpdateDeviceTypeResponse = Agent.DeviceTypeUpdateSuccess | Error;\n"],"mappings":";;;;;;AAWA;AACA;AACA;AACA;AACA;AACA;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMA,YAAY,GAAAC,OAAA,CAAAD,YAAA,GAAG;EAC1B;EACAE,GAAG,EAAE,KAAK;EACV;EACAC,IAAI,EAAE,MAAM;EACZ;EACAC,KAAK,EAAE,OAAO;EACd;EACAC,GAAG,EAAE,KAAK;EACV;EACAC,MAAM,EAAE;AACV,CAAU;;AAEV;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAwBA;AACA;AACA;AACA;AACA;;AAGA;AACA;AACA;AACA;AACA;;AAGA;AACA;AACA;AACA;AACA;;AAcA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AA8BA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAgBA;AACA;AACA;AACA;AACA;AAcA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAPA,IAQYC,aAAa,GAAAN,OAAA,CAAAM,aAAA,0BAAbA,aAAa;EACvB;EADUA,aAAa;EAGvB;EAHUA,aAAa;EAKvB;EALUA,aAAa;EAOvB;EAPUA,aAAa;EASvB;EATUA,aAAa;EAAA,OAAbA,aAAa;AAAA;AAazB;AACA;AACA;AACA;AACA;AACA;AACA;AAQA;AACA;AACA;AACA;AACA;AACA;AAcA;AACA;AACA;AACA;AACA;AAqFA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAyBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAcA;AACA;AACA;AACA;AACA;AACA;AACA;AAcA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMC,WAAW,GAAAP,OAAA,CAAAO,WAAA,GAAG;EACzB;EACAC,QAAQ,EAAE,UAAU;EACpB;EACAC,SAAS,EAAE,WAAW;EACtB;EACAC,OAAO,EAAE;AACX,CAAU;;AAEV;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;;AAYA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAmBA;AACA;AACA;AACA;AACA;AACA;;AAqBA;AACA;AACA;AACA;AACA;AACA;;AAGA;AACA;AACA;AACA;AACA;;AAiBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAgBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAeA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA;AACA;AACA;;AAiBA;AACA;AACA;;AAgBA;AACA;AACA;;AAkCA;AACA;AACA;AACA;;AAmGA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA","ignoreList":[]}
+{"version":3,"names":["HTTP_METHODS","exports","GET","POST","PATCH","PUT","DELETE","LOGGING_LEVEL","LoginOption","AGENT_DN","EXTENSION","BROWSER"],"sources":["types.ts"],"sourcesContent":["import {CallingClientConfig} from '@webex/calling';\nimport {\n  SubmitBehavioralEvent,\n  SubmitOperationalEvent,\n  SubmitBusinessEvent,\n} from '@webex/internal-plugin-metrics/src/metrics.types';\nimport * as Agent from './services/agent/types';\nimport * as Contact from './services/task/types';\nimport {Profile} from './services/config/types';\nimport {PaginatedResponse, BaseSearchParams} from './utils/PageCache';\n\n/**\n * Generic type for converting a const enum object into a union type of its values.\n * @template T The enum object type\n * @internal\n * @ignore\n */\ntype Enum<T extends Record<string, unknown>> = T[keyof T];\n\n/**\n * HTTP methods supported by WebexRequest.\n * @enum {string}\n * @public\n * @example\n * const method: HTTP_METHODS = HTTP_METHODS.GET;\n * @ignore\n */\nexport const HTTP_METHODS = {\n  /** HTTP GET method for retrieving data */\n  GET: 'GET',\n  /** HTTP POST method for creating resources */\n  POST: 'POST',\n  /** HTTP PATCH method for partial updates */\n  PATCH: 'PATCH',\n  /** HTTP PUT method for complete updates */\n  PUT: 'PUT',\n  /** HTTP DELETE method for removing resources */\n  DELETE: 'DELETE',\n} as const;\n\n/**\n * Union type of HTTP methods.\n * @public\n * @example\n * function makeRequest(method: HTTP_METHODS) { ... }\n * @ignore\n */\nexport type HTTP_METHODS = Enum<typeof HTTP_METHODS>;\n\n/**\n * Payload for making requests to Webex APIs.\n * @public\n * @example\n * const payload: WebexRequestPayload = {\n *   service: 'identity',\n *   resource: '/users',\n *   method: HTTP_METHODS.GET\n * };\n * @ignore\n */\nexport type WebexRequestPayload = {\n  /** Service name to target */\n  service?: string;\n  /** Resource path within the service */\n  resource?: string;\n  /** HTTP method to use */\n  method?: HTTP_METHODS;\n  /** Full URI if not using service/resource pattern */\n  uri?: string;\n  /** Whether to add authorization header */\n  addAuthHeader?: boolean;\n  /** Custom headers to include in request */\n  headers?: {\n    [key: string]: string | null;\n  };\n  /** Request body data */\n  body?: object;\n  /** Expected response status code */\n  statusCode?: number;\n  /** Whether to parse response as JSON */\n  json?: boolean;\n};\n\n/**\n * Event listener function type.\n * @internal\n * @ignore\n */\ntype Listener = (e: string, data?: unknown) => void;\n\n/**\n * Event listener removal function type.\n * @internal\n * @ignore\n */\ntype ListenerOff = (e: string) => void;\n\n/**\n * Service host configuration.\n * @internal\n * @ignore\n */\ntype ServiceHost = {\n  /** Host URL/domain for the service */\n  host: string;\n  /** Time-to-live in seconds */\n  ttl: number;\n  /** Priority level for load balancing (lower is higher priority) */\n  priority: number;\n  /** Unique identifier for this host */\n  id: string;\n  /** Whether this is the home cluster for the user */\n  homeCluster?: boolean;\n};\n\n/**\n * Configuration options for the Contact Center Plugin.\n * @interface CCPluginConfig\n * @public\n * @example\n * const config: CCPluginConfig = {\n *   allowMultiLogin: true,\n *   allowAutomatedRelogin: false,\n *   clientType: 'browser',\n *   isKeepAliveEnabled: true,\n *   force: false,\n *   metrics: { clientName: 'myClient', clientType: 'browser' },\n *   logging: { enable: true, verboseEvents: false },\n *   callingClientConfig: { ... }\n * };\n */\nexport interface CCPluginConfig {\n  /** Whether to allow multiple logins from different devices */\n  allowMultiLogin: boolean;\n  /** Whether to automatically attempt relogin on connection loss */\n  allowAutomatedRelogin: boolean;\n  /** The type of client making the connection */\n  clientType: string;\n  /** Whether to enable keep-alive messages */\n  isKeepAliveEnabled: boolean;\n  /** Whether to force registration */\n  force: boolean;\n  /** Metrics configuration */\n  metrics: {\n    /** Name of the client for metrics */\n    clientName: string;\n    /** Type of client for metrics */\n    clientType: string;\n  };\n  /** Logging configuration */\n  logging: {\n    /** Whether to enable logging */\n    enable: boolean;\n    /** Whether to log verbose events */\n    verboseEvents: boolean;\n  };\n  /** Configuration for the calling client */\n  callingClientConfig: CallingClientConfig;\n}\n\n/**\n * Logger interface for standardized logging throughout the plugin.\n * @public\n * @example\n * logger.log('This is a log message');\n * logger.error('This is an error message');\n * @ignore\n */\nexport type Logger = {\n  /** Log general messages */\n  log: (payload: string) => void;\n  /** Log error messages */\n  error: (payload: string) => void;\n  /** Log warning messages */\n  warn: (payload: string) => void;\n  /** Log informational messages */\n  info: (payload: string) => void;\n  /** Log detailed trace messages */\n  trace: (payload: string) => void;\n  /** Log debug messages */\n  debug: (payload: string) => void;\n};\n\n/**\n * Contextual information for log entries.\n * @public\n * @ignore\n */\nexport interface LogContext {\n  /** Module name where the log originated */\n  module?: string;\n  /** Method name where the log originated */\n  method?: string;\n  interactionId?: string;\n  trackingId?: string;\n  /** Additional structured data to include in logs */\n  data?: Record<string, any>;\n  /** Error object to include in logs */\n  error?: Error | unknown;\n}\n\n/**\n * Available logging severity levels.\n * @enum {string}\n * @public\n * @example\n * const level: LOGGING_LEVEL = LOGGING_LEVEL.error;\n * @ignore\n */\nexport enum LOGGING_LEVEL {\n  /** Critical failures that require immediate attention */\n  error = 'ERROR',\n  /** Important issues that don't prevent the system from working */\n  warn = 'WARN',\n  /** General informational logs */\n  log = 'LOG',\n  /** Detailed information about system operation */\n  info = 'INFO',\n  /** Highly detailed diagnostic information */\n  trace = 'TRACE',\n}\n\n/**\n * Metadata for log uploads.\n * @public\n * @example\n * const meta: LogsMetaData = { feedbackId: 'fb123', correlationId: 'corr456' };\n * @ignore\n */\nexport type LogsMetaData = {\n  /** Optional feedback ID to associate with logs */\n  feedbackId?: string;\n  /** Optional correlation ID to track related operations */\n  correlationId?: string;\n};\n\n/**\n * Response from uploading logs to the server.\n * @public\n * @example\n * const response: UploadLogsResponse = { trackingid: 'track123', url: 'https://...', userId: 'user1' };\n */\nexport type UploadLogsResponse = {\n  /** Tracking ID for the upload request */\n  trackingid?: string;\n  /** URL where the logs can be accessed */\n  url?: string;\n  /** ID of the user who uploaded logs */\n  userId?: string;\n  /** Feedback ID associated with the logs */\n  feedbackId?: string;\n  /** Correlation ID for tracking related operations */\n  correlationId?: string;\n};\n\n/**\n * Internal Webex SDK interfaces needed for plugin integration.\n * @internal\n * @ignore\n */\ninterface IWebexInternal {\n  /** Mercury service for real-time messaging */\n  mercury: {\n    /** Register an event listener */\n    on: Listener;\n    /** Remove an event listener */\n    off: ListenerOff;\n    /** Establish a connection to the Mercury service */\n    connect: () => Promise<void>;\n    /** Disconnect from the Mercury service */\n    disconnect: () => Promise<void>;\n    /** Whether Mercury is currently connected */\n    connected: boolean;\n    /** Whether Mercury is in the process of connecting */\n    connecting: boolean;\n  };\n  /** Device information */\n  device: {\n    /** Current WDM URL */\n    url: string;\n    /** Current user's ID */\n    userId: string;\n    /** Current organization ID */\n    orgId: string;\n    /** Device version */\n    version: string;\n    /** Calling behavior configuration */\n    callingBehavior: string;\n  };\n  /** Presence service */\n  presence: unknown;\n  /** Services discovery and management */\n  services: {\n    /** Get a service URL by name */\n    get: (service: string) => string;\n    /** Wait for service catalog to be loaded */\n    waitForCatalog: (service: string) => Promise<void>;\n    /** Check if current environment is INT (integration) */\n    isIntegrationEnvironment: () => boolean;\n    /** Host catalog for service discovery */\n    _hostCatalog: Record<string, ServiceHost[]>;\n    /** Service URLs cache */\n    _serviceUrls: {\n      /** Mobius calling service */\n      mobius: string;\n      /** Identity service */\n      identity: string;\n      /** Janus media server */\n      janus: string;\n      /** WDM (WebEx Device Management) service */\n      wdm: string;\n      /** BroadWorks IDP proxy service */\n      broadworksIdpProxy: string;\n      /** Hydra API service */\n      hydra: string;\n      /** Mercury API service */\n      mercuryApi: string;\n      /** UC Management gateway service */\n      'ucmgmt-gateway': string;\n      /** Contacts service */\n      contactsService: string;\n    };\n  };\n  /** Metrics collection services */\n  newMetrics: {\n    /** Submit behavioral events (user actions) */\n    submitBehavioralEvent: SubmitBehavioralEvent;\n    /** Submit operational events (system operations) */\n    submitOperationalEvent: SubmitOperationalEvent;\n    /** Submit business events (business outcomes) */\n    submitBusinessEvent: SubmitBusinessEvent;\n  };\n  /** Support functionality */\n  support: {\n    /** Submit logs to server */\n    submitLogs: (\n      metaData: LogsMetaData,\n      logs: string,\n      options: {\n        /** Whether to submit full logs or just differences */\n        type: 'diff' | 'full';\n      }\n    ) => Promise<UploadLogsResponse>;\n  };\n}\n\n/**\n * Interface representing the WebexSDK core functionality.\n * @interface WebexSDK\n * @public\n * @example\n * const sdk: WebexSDK = ...;\n * sdk.request({ service: 'identity', resource: '/users', method: HTTP_METHODS.GET });\n * @ignore\n */\nexport interface WebexSDK {\n  /** Version of the WebexSDK */\n  version: string;\n  /** Whether the SDK can authorize requests */\n  canAuthorize: boolean;\n  /** Credentials management */\n  credentials: {\n    /** Get the user token for authentication */\n    getUserToken: () => Promise<string>;\n    /** Get the organization ID */\n    getOrgId: () => string;\n  };\n  /** Whether the SDK is ready for use */\n  ready: boolean;\n  /** Make a request to the Webex APIs */\n  request: <T>(payload: WebexRequestPayload) => Promise<T>;\n  /** Register a one-time event handler */\n  once: (event: string, callBack: () => void) => void;\n  /** Internal plugins and services */\n  internal: IWebexInternal;\n  /** Logger instance */\n  logger: Logger;\n}\n\n/**\n * An interface for the `ContactCenter` class.\n * The `ContactCenter` package is designed to provide a set of APIs to perform various operations for the Agent flow within Webex Contact Center.\n * @public\n * @example\n * const cc: IContactCenter = ...;\n * cc.register().then(profile => { ... });\n * @ignore\n */\nexport interface IContactCenter {\n  /**\n   * Initialize the CC SDK by setting up the contact center mercury connection.\n   * This establishes WebSocket connectivity for real-time communication.\n   *\n   * @returns A Promise that resolves to the agent's profile upon successful registration\n   * @public\n   * @example\n   * cc.register().then(profile => { ... });\n   */\n  register(): Promise<Profile>;\n}\n\n/**\n * Generic HTTP response structure.\n * @public\n * @example\n * const response: IHttpResponse = { body: {}, statusCode: 200, method: 'GET', headers: {}, url: '...' };\n * @ignore\n */\nexport interface IHttpResponse {\n  /** Response body content */\n  body: any;\n  /** HTTP status code */\n  statusCode: number;\n  /** HTTP method used for the request */\n  method: string;\n  /** Response headers */\n  headers: Headers;\n  /** Request URL */\n  url: string;\n}\n\n/**\n * Supported login options for agent authentication.\n * @public\n * @example\n * const option: LoginOption = LoginOption.AGENT_DN;\n * @ignore\n */\nexport const LoginOption = {\n  /** Login using agent's direct number */\n  AGENT_DN: 'AGENT_DN',\n  /** Login using an extension number */\n  EXTENSION: 'EXTENSION',\n  /** Login using browser WebRTC capabilities */\n  BROWSER: 'BROWSER',\n} as const;\n\n/**\n * Union type of login options.\n * @public\n * @example\n * function login(option: LoginOption) { ... }\n * @ignore\n */\nexport type LoginOption = Enum<typeof LoginOption>;\n\n/**\n * Request payload for subscribing to the contact center websocket.\n * @public\n * @example\n * const req: SubscribeRequest = { force: true, isKeepAliveEnabled: true, clientType: 'browser', allowMultiLogin: false };\n * @ignore\n */\nexport type SubscribeRequest = {\n  /** Whether to force connection even if another exists */\n  force: boolean;\n  /** Whether to send keepalive messages */\n  isKeepAliveEnabled: boolean;\n  /** Type of client connecting */\n  clientType: string;\n  /** Whether to allow login from multiple devices */\n  allowMultiLogin: boolean;\n};\n\n/**\n * Represents the response from getListOfTeams method.\n * Teams are groups of agents that can be managed together.\n * @public\n * @example\n * const team: Team = { id: 'team1', name: 'Support', desktopLayoutId: 'layout1' };\n * @ignore\n */\nexport type Team = {\n  /**\n   * Unique identifier of the team.\n   */\n  id: string;\n\n  /**\n   * Display name of the team.\n   */\n  name: string;\n\n  /**\n   * Associated desktop layout ID for the team.\n   * Controls how the agent desktop is displayed for team members.\n   */\n  desktopLayoutId?: string;\n};\n\n/**\n * Represents the request to perform agent login.\n * @public\n * @example\n * const login: AgentLogin = { dialNumber: '1234', teamId: 'team1', loginOption: LoginOption.AGENT_DN };\n */\nexport type AgentLogin = {\n  /**\n   * A dialNumber field contains the number to dial such as a route point or extension.\n   * Required for AGENT_DN and EXTENSION login options.\n   */\n  dialNumber?: string;\n\n  /**\n   * The unique ID representing a team of users.\n   * The agent must belong to this team.\n   */\n  teamId: string;\n\n  /**\n   * The loginOption field specifies the type of login method.\n   * Controls how calls are delivered to the agent.\n   */\n  loginOption: LoginOption;\n};\n\n/**\n * Represents the request to update agent profile settings.\n * @public\n * @example\n * const update: AgentProfileUpdate = { loginOption: LoginOption.BROWSER, dialNumber: '5678' };\n */\nexport type AgentProfileUpdate = Pick<AgentLogin, 'loginOption' | 'dialNumber' | 'teamId'>;\n\n/**\n * Union type for all possible request body types.\n * @internal\n * @ignore\n */\nexport type RequestBody =\n  | SubscribeRequest\n  | Agent.Logout\n  | Agent.UserStationLogin\n  | Agent.StateChange\n  | Agent.BuddyAgents\n  | Contact.HoldResumePayload\n  | Contact.ResumeRecordingPayload\n  | Contact.ConsultPayload\n  | Contact.ConsultEndAPIPayload // API Payload accepts only QueueId wheres SDK API allows more params\n  | Contact.TransferPayLoad\n  | Contact.ConsultTransferPayLoad\n  | Contact.cancelCtq\n  | Contact.WrapupPayLoad\n  | Contact.DialerPayload;\n\n/**\n * Represents the options to fetch buddy agents for the logged in agent.\n * Buddy agents are other agents who can be consulted or transfered to.\n * @public\n * @example\n * const opts: BuddyAgents = { mediaType: 'telephony', state: 'Available' };\n * @ignore\n */\nexport type BuddyAgents = {\n  /**\n   * The media type channel to filter buddy agents.\n   * Determines which channel capability the returned agents must have.\n   */\n  mediaType: 'telephony' | 'chat' | 'social' | 'email';\n\n  /**\n   * Optional filter for agent state.\n   * If specified, returns only agents in that state.\n   * If omitted, returns both available and idle agents.\n   */\n  state?: 'Available' | 'Idle';\n};\n\n/**\n * Generic error structure for Contact Center SDK errors.\n * Contains detailed information about the error context.\n * @public\n * @example\n * const err: GenericError = new Error('Failed');\n * err.details = { type: 'ERR', orgId: 'org1', trackingId: 'track1', data: {} };\n * @ignore\n */\nexport interface GenericError extends Error {\n  /** Structured details about the error */\n  details: {\n    /** Error type identifier */\n    type: string;\n    /** Organization ID where the error occurred */\n    orgId: string;\n    /** Unique tracking ID for the error */\n    trackingId: string;\n    /** Additional error context data */\n    data: Record<string, any>;\n  };\n}\n\n/**\n * Response type for station login operations.\n * Either a success response with agent details or an error.\n * @public\n * @example\n * function handleLogin(resp: StationLoginResponse) { ... }\n */\nexport type StationLoginResponse = Agent.StationLoginSuccessResponse | Error;\n\n/**\n * Response type for station logout operations.\n * Either a success response with logout details or an error.\n * @public\n * @example\n * function handleLogout(resp: StationLogoutResponse) { ... }\n */\nexport type StationLogoutResponse = Agent.LogoutSuccess | Error;\n\n/**\n * Response type for station relogin operations.\n * Either a success response with relogin details or an error.\n * @public\n * @example\n * function handleReLogin(resp: StationReLoginResponse) { ... }\n * @ignore\n */\nexport type StationReLoginResponse = Agent.ReloginSuccess | Error;\n\n/**\n * Response type for agent state change operations.\n * Either a success response with state change details or an error.\n * @public\n * @example\n * function handleStateChange(resp: SetStateResponse) { ... }\n * @ignore\n */\nexport type SetStateResponse = Agent.StateChangeSuccess | Error;\n\n/**\n * AddressBook types\n */\nexport interface AddressBookEntry {\n  id: string;\n  organizationId?: string;\n  version?: number;\n  name: string;\n  number: string;\n  createdTime?: number;\n  lastUpdatedTime?: number;\n}\n\nexport type AddressBookEntriesResponse = PaginatedResponse<AddressBookEntry>;\n\nexport interface AddressBookEntrySearchParams extends BaseSearchParams {\n  addressBookId?: string;\n}\n\n/**\n * EntryPointRecord types\n */\nexport interface EntryPointRecord {\n  id: string;\n  name: string;\n  description?: string;\n  type: string;\n  isActive: boolean;\n  orgId: string;\n  createdAt?: string;\n  updatedAt?: string;\n  settings?: Record<string, any>;\n}\n\nexport type EntryPointListResponse = PaginatedResponse<EntryPointRecord>;\nexport type EntryPointSearchParams = BaseSearchParams;\n\n/**\n * Queue types\n */\nexport interface QueueSkillRequirement {\n  organizationId?: string;\n  id?: string;\n  version?: number;\n  skillId: string;\n  skillName?: string;\n  skillType?: string;\n  condition: string;\n  skillValue: string;\n  createdTime?: number;\n  lastUpdatedTime?: number;\n}\n\nexport interface QueueAgent {\n  id: string;\n  ciUserId?: string;\n}\n\nexport interface AgentGroup {\n  teamId: string;\n}\n\nexport interface CallDistributionGroup {\n  agentGroups: AgentGroup[];\n  order: number;\n  duration?: number;\n}\n\nexport interface AssistantSkillMapping {\n  assistantSkillId?: string;\n  assistantSkillUpdatedTime?: number;\n}\n\n/**\n * Configuration for a contact service queue\n * @public\n */\nexport interface ContactServiceQueue {\n  /** Organization ID */\n  organizationId?: string;\n  /** Unique identifier for the queue */\n  id?: string;\n  /** Version of the queue */\n  version?: number;\n  /** Name of the Contact Service Queue */\n  name: string;\n  /** Description of the queue */\n  description?: string;\n  /** Queue type (INBOUND, OUTBOUND) */\n  queueType: 'INBOUND' | 'OUTBOUND';\n  /** Whether to check agent availability */\n  checkAgentAvailability: boolean;\n  /** Channel type (TELEPHONY, EMAIL, SOCIAL_CHANNEL, CHAT, etc.) */\n  channelType: 'TELEPHONY' | 'EMAIL' | 'FAX' | 'CHAT' | 'VIDEO' | 'OTHERS' | 'SOCIAL_CHANNEL';\n  /** Social channel type for SOCIAL_CHANNEL channelType */\n  socialChannelType?:\n    | 'MESSAGEBIRD'\n    | 'MESSENGER'\n    | 'WHATSAPP'\n    | 'APPLE_BUSINESS_CHAT'\n    | 'GOOGLE_BUSINESS_MESSAGES';\n  /** Service level threshold in seconds */\n  serviceLevelThreshold: number;\n  /** Maximum number of simultaneous contacts */\n  maxActiveContacts: number;\n  /** Maximum time in queue in seconds */\n  maxTimeInQueue: number;\n  /** Default music in queue media file ID */\n  defaultMusicInQueueMediaFileId: string;\n  /** Timezone for routing strategies */\n  timezone?: string;\n  /** Whether the queue is active */\n  active: boolean;\n  /** Whether outdial campaign is enabled */\n  outdialCampaignEnabled?: boolean;\n  /** Whether monitoring is permitted */\n  monitoringPermitted: boolean;\n  /** Whether parking is permitted */\n  parkingPermitted: boolean;\n  /** Whether recording is permitted */\n  recordingPermitted: boolean;\n  /** Whether recording all calls is permitted */\n  recordingAllCallsPermitted: boolean;\n  /** Whether pausing recording is permitted */\n  pauseRecordingPermitted: boolean;\n  /** Recording pause duration in seconds */\n  recordingPauseDuration?: number;\n  /** Control flow script URL */\n  controlFlowScriptUrl: string;\n  /** IVR requeue URL */\n  ivrRequeueUrl: string;\n  /** Overflow number for telephony */\n  overflowNumber?: string;\n  /** Vendor ID */\n  vendorId?: string;\n  /** Routing type */\n  routingType: 'LONGEST_AVAILABLE_AGENT' | 'SKILLS_BASED' | 'CIRCULAR' | 'LINEAR';\n  /** Skills-based routing type */\n  skillBasedRoutingType?: 'LONGEST_AVAILABLE_AGENT' | 'BEST_AVAILABLE_AGENT';\n  /** Queue routing type */\n  queueRoutingType: 'TEAM_BASED' | 'SKILL_BASED' | 'AGENT_BASED';\n  /** Queue skill requirements */\n  queueSkillRequirements?: QueueSkillRequirement[];\n  /** List of agents for agent-based queue */\n  agents?: QueueAgent[];\n  /** Call distribution groups */\n  callDistributionGroups: CallDistributionGroup[];\n  /** XSP version */\n  xspVersion?: string;\n  /** Subscription ID */\n  subscriptionId?: string;\n  /** Assistant skill mapping */\n  assistantSkill?: AssistantSkillMapping;\n  /** Whether this is a system default queue */\n  systemDefault?: boolean;\n  /** User who last updated agents list */\n  agentsLastUpdatedByUserName?: string;\n  /** Email of user who last updated agents list */\n  agentsLastUpdatedByUserEmailPrefix?: string;\n  /** When agents list was last updated */\n  agentsLastUpdatedTime?: number;\n  /** Creation timestamp in epoch millis */\n  createdTime?: number;\n  /** Last updated timestamp in epoch millis */\n  lastUpdatedTime?: number;\n}\n\nexport type ContactServiceQueuesResponse = PaginatedResponse<ContactServiceQueue>;\n\nexport interface ContactServiceQueueSearchParams extends BaseSearchParams {\n  desktopProfileFilter?: boolean;\n  provisioningView?: boolean;\n  singleObjectResponse?: boolean;\n}\n\n/**\n * Response type for buddy agents query operations.\n * Either a success response with list of buddy agents or an error.\n * @public\n * @example\n * function handleBuddyAgents(resp: BuddyAgentsResponse) { ... }\n */\nexport type BuddyAgentsResponse = Agent.BuddyAgentsSuccess | Error;\n\n/**\n * Response type for device type update operations.\n * Either a success response with update confirmation or an error.\n * @public\n * @example\n * function handleUpdateDeviceType(resp: UpdateDeviceTypeResponse) { ... }\n */\nexport type UpdateDeviceTypeResponse = Agent.DeviceTypeUpdateSuccess | Error;\n"],"mappings":";;;;;;AAWA;AACA;AACA;AACA;AACA;AACA;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMA,YAAY,GAAAC,OAAA,CAAAD,YAAA,GAAG;EAC1B;EACAE,GAAG,EAAE,KAAK;EACV;EACAC,IAAI,EAAE,MAAM;EACZ;EACAC,KAAK,EAAE,OAAO;EACd;EACAC,GAAG,EAAE,KAAK;EACV;EACAC,MAAM,EAAE;AACV,CAAU;;AAEV;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAwBA;AACA;AACA;AACA;AACA;;AAGA;AACA;AACA;AACA;AACA;;AAGA;AACA;AACA;AACA;AACA;;AAcA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AA8BA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAgBA;AACA;AACA;AACA;AACA;AAcA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAPA,IAQYC,aAAa,GAAAN,OAAA,CAAAM,aAAA,0BAAbA,aAAa;EACvB;EADUA,aAAa;EAGvB;EAHUA,aAAa;EAKvB;EALUA,aAAa;EAOvB;EAPUA,aAAa;EASvB;EATUA,aAAa;EAAA,OAAbA,aAAa;AAAA;AAazB;AACA;AACA;AACA;AACA;AACA;AACA;AAQA;AACA;AACA;AACA;AACA;AACA;AAcA;AACA;AACA;AACA;AACA;AAuFA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAyBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAcA;AACA;AACA;AACA;AACA;AACA;AACA;AAcA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMC,WAAW,GAAAP,OAAA,CAAAO,WAAA,GAAG;EACzB;EACAC,QAAQ,EAAE,UAAU;EACpB;EACAC,SAAS,EAAE,WAAW;EACtB;EACAC,OAAO,EAAE;AACX,CAAU;;AAEV;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;;AAYA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAmBA;AACA;AACA;AACA;AACA;AACA;;AAqBA;AACA;AACA;AACA;AACA;AACA;;AAGA;AACA;AACA;AACA;AACA;;AAiBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAgBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAeA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA;AACA;AACA;;AAiBA;AACA;AACA;;AAgBA;AACA;AACA;;AAkCA;AACA;AACA;AACA;;AAmGA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA","ignoreList":[]}

package/dist/webex.js

@@ -29,7 +29,7 @@ if (!global.Buffer) {
  */
 const Webex = _webexCore.default.extend({
   webex: true,
-  version: `3.11.0-next.16`
+  version: `3.11.0-next.18`
 });
 
 /**

package/package.json

@@ -45,13 +45,13 @@
   },
   "dependencies": {
     "@types/platform": "1.3.4",
-    "@webex/calling": "3.11.0-next.10",
-    "@webex/internal-plugin-mercury": "3.11.0-next.6",
-    "@webex/internal-plugin-metrics": "3.11.0-next.5",
-    "@webex/internal-plugin-support": "3.11.0-next.6",
-    "@webex/plugin-authorization": "3.11.0-next.5",
-    "@webex/plugin-logger": "3.11.0-next.5",
-    "@webex/webex-core": "3.11.0-next.5",
+    "@webex/calling": "3.11.0-next.12",
+    "@webex/internal-plugin-mercury": "3.11.0-next.7",
+    "@webex/internal-plugin-metrics": "3.11.0-next.6",
+    "@webex/internal-plugin-support": "3.11.0-next.7",
+    "@webex/plugin-authorization": "3.11.0-next.6",
+    "@webex/plugin-logger": "3.11.0-next.6",
+    "@webex/webex-core": "3.11.0-next.6",
     "jest-html-reporters": "3.0.11",
     "lodash": "^4.17.21"
   },
@@ -80,5 +80,5 @@
     "typedoc": "^0.25.0",
     "typescript": "4.9.5"
   },
-  "version": "3.11.0-next.16"
+  "version": "3.11.0-next.18"
 }

package/src/services/core/websocket/WebSocketManager.ts

@@ -86,11 +86,23 @@ export class WebSocketManager extends EventEmitter {
 
   private async register(connectionConfig: SubscribeRequest) {
     try {
+      // X-ORGANIZATION-ID header is only required for INT environments
+      const isIntEnv = this.webex.internal?.services?.isIntegrationEnvironment() || false;
+      const orgId = this.webex.credentials.getOrgId();
+
+      if (isIntEnv && orgId) {
+        LoggerProxy.log(`[WebSocketManager] Adding X-ORGANIZATION-ID header for INT environment`, {
+          module: WEB_SOCKET_MANAGER_FILE,
+          method: METHODS.REGISTER,
+        });
+      }
+
       const subscribeResponse: SubscribeResponse = await this.webex.request({
         service: WCC_API_GATEWAY,
         resource: SUBSCRIBE_API,
         method: HTTP_METHODS.POST,
         body: connectionConfig,
+        headers: isIntEnv && orgId ? {'X-ORGANIZATION-ID': orgId} : undefined,
       });
       this.url = subscribeResponse.body.webSocketUrl;
     } catch (e) {

package/src/types.ts

@@ -295,6 +295,8 @@ interface IWebexInternal {
     get: (service: string) => string;
     /** Wait for service catalog to be loaded */
     waitForCatalog: (service: string) => Promise<void>;
+    /** Check if current environment is INT (integration) */
+    isIntegrationEnvironment: () => boolean;
     /** Host catalog for service discovery */
     _hostCatalog: Record<string, ServiceHost[]>;
     /** Service URLs cache */

package/test/unit/spec/services/core/websocket/WebSocketManager.ts

@@ -74,6 +74,14 @@ describe('WebSocketManager', () => {
 
     mockWebex = {
       request: jest.fn(),
+      credentials: {
+        getOrgId: jest.fn().mockReturnValue('test-org-id'),
+      },
+      internal: {
+        services: {
+          isIntegrationEnvironment: jest.fn().mockReturnValue(true), // INT environment by default
+        },
+      },
     } as unknown as WebexSDK;
 
     mockWorker = {
@@ -107,15 +115,76 @@ describe('WebSocketManager', () => {
     expect(webSocketManager).toBeDefined();
   });
 
-  it('should register and connect to WebSocket', async () => {
+  it('should register and connect to WebSocket with X-ORGANIZATION-ID header for INT environment', async () => {
+    const subscribeResponse = {
+      body: {
+        webSocketUrl: 'wss://fake-url',
+      },
+    };
+
+    // Mock INT environment (services.isIntegrationEnvironment returns true)
+    (mockWebex.internal.services.isIntegrationEnvironment as jest.Mock).mockReturnValue(true);
+    (mockWebex.request as jest.Mock).mockResolvedValueOnce(subscribeResponse);
+
+    await webSocketManager.initWebSocket({ body: fakeSubscribeRequest });
+
+    expect(mockWebex.request).toHaveBeenCalledWith({
+      service: WCC_API_GATEWAY,
+      resource: SUBSCRIBE_API,
+      method: 'POST',
+      body: fakeSubscribeRequest,
+      headers: {'X-ORGANIZATION-ID': 'test-org-id'},
+    });
+  });
+
+  it('should register and connect to WebSocket without X-ORGANIZATION-ID header for production environment', async () => {
+    const subscribeResponse = {
+      body: {
+        webSocketUrl: 'wss://fake-url',
+      },
+    };
+
+    // Mock production environment (services.isIntegrationEnvironment returns false)
+    (mockWebex.internal.services.isIntegrationEnvironment as jest.Mock).mockReturnValue(false);
+    (mockWebex.request as jest.Mock).mockResolvedValueOnce(subscribeResponse);
+
+    // Create new WebSocketManager instance with production mock
+    webSocketManager = new WebSocketManager({ webex: mockWebex });
+
+    setTimeout(() => {
+      MockWebSocket.inst.onopen();
+      MockWebSocket.inst.onmessage({ data: JSON.stringify({ type: "Welcome" }) });
+    }, 1);
+
+    await webSocketManager.initWebSocket({ body: fakeSubscribeRequest });
+
+    expect(mockWebex.request).toHaveBeenCalledWith({
+      service: WCC_API_GATEWAY,
+      resource: SUBSCRIBE_API,
+      method: 'POST',
+      body: fakeSubscribeRequest,
+      headers: undefined,
+    });
+  });
+
+  it('should not send X-ORGANIZATION-ID header when services.isIntegrationEnvironment is not available', async () => {
     const subscribeResponse = {
       body: {
         webSocketUrl: 'wss://fake-url',
       },
     };
 
+    // Mock services not available (defaults to production behavior)
+    (mockWebex as any).internal = undefined;
     (mockWebex.request as jest.Mock).mockResolvedValueOnce(subscribeResponse);
 
+    webSocketManager = new WebSocketManager({ webex: mockWebex });
+
+    setTimeout(() => {
+      MockWebSocket.inst.onopen();
+      MockWebSocket.inst.onmessage({ data: JSON.stringify({ type: "Welcome" }) });
+    }, 1);
+
     await webSocketManager.initWebSocket({ body: fakeSubscribeRequest });
 
     expect(mockWebex.request).toHaveBeenCalledWith({
@@ -123,6 +192,7 @@ describe('WebSocketManager', () => {
       resource: SUBSCRIBE_API,
       method: 'POST',
       body: fakeSubscribeRequest,
+      headers: undefined,
     });
   });