feat(calling): extract getCallingBackend logic to resolveCallingBackend and export resolveCallingBackend

packages/calling/src/SDKConnector/types.ts

@@ -26,6 +26,29 @@ export type Model = {
   };
 };
 
+export type WDMDevice = {
+  url: string;
+  userId: string;
+  orgId: string;
+  version: string;
+  callingBehavior: string;
+  registered?: boolean;
+  webSocketUrl?: string;
+  register?: () => Promise<unknown>;
+  refresh?: () => Promise<unknown>;
+  /** WDM / device-registration settings (e.g. `webrtc-calling-over-ws`). */
+  settings?: Record<string, {value?: boolean} | undefined>;
+  features: {
+    developer: {
+      models: Model[];
+      get: (key: string) => {value: boolean} | undefined;
+    };
+    entitlement: {
+      models: Model[];
+    };
+  };
+};
+
 export type ServiceCatalog = {
   serviceGroups: {
     // cSpell:disable
@@ -99,28 +122,7 @@ export interface WebexSDK {
       updateFeature?: (featureToggle: unknown) => void;
     };
     calendar: unknown;
-    device: {
-      url: string;
-      userId: string;
-      orgId: string;
-      version: string;
-      callingBehavior: string;
-      registered?: boolean;
-      webSocketUrl?: string;
-      register?: () => Promise<unknown>;
-      refresh?: () => Promise<unknown>;
-      /** WDM / device-registration settings (e.g. `webrtc-calling-over-ws`). */
-      settings?: Record<string, {value?: boolean} | undefined>;
-      features: {
-        developer: {
-          models: Model[];
-          get: (key: string) => {value: boolean} | undefined;
-        };
-        entitlement: {
-          models: Model[];
-        };
-      };
-    };
+    device: WDMDevice;
     encryption: {
       decryptText: (encryptionKeyUrl: string, encryptedData?: string) => Promise<string>;
       encryptText: (encryptionKeyUrl: string, text?: string) => Promise<string>;

packages/calling/src/common/Utils.ts

@@ -129,7 +129,7 @@ import {
   WEBEX_API_BTS,
   BW_XSI_ENDPOINT_VERSION_WITH_SLASH,
 } from './constants';
-import {Model, WebexSDK} from '../SDKConnector/types';
+import {Model, WDMDevice, WebexSDK} from '../SDKConnector/types';
 import SDKConnector from '../SDKConnector';
 import {CallSettingResponse} from '../CallSettings/types';
 import {ContactResponse} from '../Contacts/types';
@@ -1216,16 +1216,16 @@ export const waitForMsecs = (msec: number) =>
   });
 
 /**
- * Register calling backend.
+ * Determine the calling backend from the device object.
  *
- * @param webex -.
+ * @param device - The device object containing callingBehavior and entitlement features.
  * @returns CallingBackEnd.
  */
-export function getCallingBackEnd(webex: WebexSDK): CALLING_BACKEND {
-  const entModels: Model[] = webex.internal.device.features.entitlement.models;
+export function resolveCallingBackend(device: WDMDevice): CALLING_BACKEND {
+  const entModels: Model[] = device.features.entitlement.models;
   let callingBackend;
 
-  if (webex.internal.device.callingBehavior === NATIVE_WEBEX_TEAMS_CALLING) {
+  if (device.callingBehavior === NATIVE_WEBEX_TEAMS_CALLING) {
     for (let i = 0; i < entModels.length; i += 1) {
       if (
         entModels[i][VALUES][KEY] === ENTITLEMENT_BASIC ||
@@ -1238,7 +1238,7 @@ export function getCallingBackEnd(webex: WebexSDK): CALLING_BACKEND {
         break;
       }
     }
-  } else if (webex.internal.device.callingBehavior === NATIVE_SIP_CALL_TO_UCM) {
+  } else if (device.callingBehavior === NATIVE_SIP_CALL_TO_UCM) {
     callingBackend = CALLING_BACKEND.UCM;
   } else {
     callingBackend = CALLING_BACKEND.INVALID;
@@ -1247,6 +1247,17 @@ export function getCallingBackEnd(webex: WebexSDK): CALLING_BACKEND {
   return callingBackend as CALLING_BACKEND;
 }
 
+/**
+ * Register calling backend.
+ *
+ * @param webex -.
+ * @returns CallingBackEnd.
+ * @deprecated Use getCallingBackend(device) instead.
+ */
+export function getCallingBackEnd(webex: WebexSDK): CALLING_BACKEND {
+  return resolveCallingBackend(webex.internal.device);
+}
+
 /**
  * Register XSI endpoint based on calling backend.
  *

packages/calling/src/index.ts

@@ -44,10 +44,13 @@ export {
   CallDetails,
   CallDirection,
   CallType,
+  CALLING_BACKEND,
   DisplayInformation,
   SORT,
   SORT_BY,
 } from './common/types';
+export {resolveCallingBackend} from './common/Utils';
+export {WDMDevice} from './SDKConnector/types';
 export {CallError, LineError} from './Errors';
 export {ICall, TransferType} from './CallingClient/calling/types';
 export {LOGGER} from './Logger/types';