@campxdev/campx-web-utils 2.0.13 → 2.0.14

package/dist/cjs/types/src/services/exotel/ExotelService.d.ts

@@ -0,0 +1,47 @@
+import { CallEventData } from '@exotel-npm-dev/exotel-ip-calling-crm-websdk';
+export type PermissionStatus = 'granted' | 'denied' | 'prompt' | 'unknown';
+declare class ExotelService {
+    private static instance;
+    private exotelSDK;
+    private webPhone;
+    private callListeners;
+    private registerListeners;
+    private sessionListeners;
+    private permissionStatus;
+    static getInstance(): ExotelService;
+    /**
+     * Initialize the Exotel SDK
+     * @param accessToken - The access token for authentication
+     * @param agentUserId - The user ID of the agent
+     * @param autoConnectVOIP - Whether to automatically connect VOIP (default: true)
+     * @returns boolean indicating success
+     */
+    initialize(accessToken: string, agentUserId: string, autoConnectVOIP?: boolean): Promise<boolean>;
+    checkAudioPermissions(): Promise<boolean>;
+    requestMicrophoneAccess(): Promise<boolean>;
+    makeCall(phoneNumber: string): Promise<any>;
+    acceptCall(): Promise<void>;
+    hangupCall(): void;
+    /**
+     * Reject an incoming call before accepting it.
+     * Note: Exotel SDK only has HangupCall - no separate RejectCall method.
+     * HangupCall internally calls webrtcSIPPhone.rejectCall() -> phone.sipHangUp()
+     */
+    rejectCall(): void;
+    toggleHold(): void;
+    toggleMute(): void;
+    sendDTMF(digit: string): void;
+    registerDevice(): Promise<void>;
+    unregisterDevice(): void;
+    getPermissionStatus(): PermissionStatus;
+    private handleCallEvent;
+    private handleRegisterEvent;
+    private handleSessionEvent;
+    addCallListener(listener: (event: string, data: CallEventData) => void): void;
+    removeCallListener(listener: (event: string, data: CallEventData) => void): void;
+    addRegisterListener(listener: (state: string) => void): void;
+    removeRegisterListener(listener: (state: string) => void): void;
+    addSessionListener(listener: (state: string, data: any) => void): void;
+    removeSessionListener(listener: (state: string, data: any) => void): void;
+}
+export default ExotelService;

package/dist/cjs/types/src/services/exotel/api.d.ts

@@ -0,0 +1,158 @@
+/**
+ * Voice config from notification-configs API
+ */
+export interface VoiceConfig {
+    id: string;
+    isEnabled: boolean;
+    name: string;
+    channelType: string;
+    EXOTEL?: {
+        appId: string;
+        appSecret: string;
+        token?: string;
+        tokenExpiresAt?: string;
+    };
+}
+/**
+ * Notification config response structure
+ */
+export interface NotificationConfigResponse {
+    config: {
+        id: string;
+        tenantId: string;
+        institutionUniqueId: number;
+        enableVoice?: boolean;
+        voiceConfigs?: VoiceConfig[];
+    };
+    options: {
+        voiceChannels?: string[];
+    };
+}
+/**
+ * Check if VoIP is enabled for the current tenant by fetching notification config.
+ * Returns true only if:
+ * - enableVoice is true
+ * - voiceConfigs has at least one enabled config
+ */
+export declare const checkVoIPEnabled: () => Promise<{
+    enabled: boolean;
+    hasValidToken: boolean;
+}>;
+/**
+ * Get the active Exotel voice token from the backend.
+ * The backend manages credentials securely and auto-refreshes tokens.
+ */
+export declare const getActiveVoiceToken: () => Promise<{
+    token: string;
+    expiresAt: string;
+} | null>;
+/**
+ * @deprecated Use getActiveVoiceToken instead.
+ * This function is kept for backwards compatibility but will be removed.
+ */
+export declare const createExotelAppToken: () => Promise<{
+    Data: string;
+}>;
+export interface CallActivity {
+    id: string;
+    callSid: string;
+    prospectId: string;
+    direction: 'inbound' | 'outbound';
+    status: string;
+    durationSeconds?: number;
+    createdAt: string;
+    startTime?: string;
+    endTime?: string;
+    fromNumber?: string;
+    toNumber?: string;
+    userId?: number;
+    dispositionCategory?: string;
+    dispositionReason?: string;
+    dispositionNotes?: string;
+    callStatusDisposition?: 'connected' | 'not_connected';
+    recordingUrl?: string;
+}
+export interface InitiateCallInput {
+    prospectId: string;
+    toNumber: string;
+    fromNumber?: string;
+    userId?: number;
+    callSid?: string;
+}
+export interface SaveDispositionInput {
+    callId: string;
+    prospectId?: string;
+    callStatusDisposition?: 'connected' | 'not_connected';
+    dispositionCategory: string;
+    dispositionReason?: string;
+    dispositionNotes?: string;
+    callbackScheduledAt?: string;
+}
+export interface CancelCallInput {
+    callSid: string;
+    reason?: string;
+}
+export interface CallActivityResponse {
+    success: boolean;
+    message: string;
+    data: CallActivity;
+}
+export interface RegisterIncomingCallInput {
+    callSid: string;
+    fromNumber: string;
+    toNumber?: string;
+    prospectId?: string;
+    userId?: number;
+}
+export interface RegisterIncomingCallResponse {
+    success: boolean;
+    message: string;
+    data: CallActivity;
+    prospect?: {
+        id: string;
+        uniqueId?: number;
+        prospectId?: string;
+        name: string;
+        mobile: string;
+    };
+}
+/**
+ * Initiate an outbound call - creates call activity record
+ */
+export declare const initiateCallActivity: (input: InitiateCallInput) => Promise<{
+    success: boolean;
+    message: string;
+    data: CallActivity;
+}>;
+/**
+ * Register an incoming call - creates call activity record
+ */
+export declare const registerIncomingCall: (input: RegisterIncomingCallInput) => Promise<RegisterIncomingCallResponse>;
+/**
+ * Fetch call history for a prospect
+ */
+export declare const fetchCallHistory: (prospectId: string) => Promise<CallActivity[]>;
+/**
+ * Get call activity by ID
+ */
+export declare const getCallActivityById: (id: string) => Promise<CallActivity>;
+/**
+ * Get call activity by CallSid
+ */
+export declare const getCallActivityByCallSid: (callSid: string) => Promise<CallActivity>;
+/**
+ * Get call count for a prospect
+ */
+export declare const getCallCountByProspect: (prospectId: string) => Promise<number>;
+/**
+ * Save call disposition
+ */
+export declare const saveCallDisposition: (input: SaveDispositionInput) => Promise<CallActivity>;
+/**
+ * Cancel/decline a call before it was connected
+ * Updates the call activity status to CANCELED
+ */
+export declare const cancelCall: (input: CancelCallInput) => Promise<{
+    success: boolean;
+    message: string;
+}>;

package/dist/cjs/types/src/services/exotel/index.d.ts

@@ -0,0 +1,2 @@
+export * from './ExotelService';
+export * from './api';

package/dist/cjs/types/src/utils/exotel/formatters.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Format duration in MM:SS format (e.g., "02:30")
+ */
+export declare const formatDurationTimer: (seconds: number) => string;
+/**
+ * Format duration in verbose format (e.g., "2m 30s")
+ */
+export declare const formatDurationVerbose: (seconds: number) => string;

package/dist/cjs/types/src/utils/exotel/index.d.ts

@@ -0,0 +1 @@
+export * from './formatters';