@wazo/sdk 1.0.0-alpha.1 → 1.0.0-alpha.3

package/esm/types/voice/softphone.d.ts

@@ -1,19 +1,23 @@
 /// <reference types="node" />
 import { EventEmitter } from 'events';
-import type { Message } from 'sip.js/lib/api/message';
 import type Session from '../domain/Session';
 import type SipLine from '../domain/SipLine';
-import { type SoftphoneActorRef, type StateTypes, ActionTypes } from '../state-machine/softphone-state-machine';
-import { WebRtcConfig, SipCall } from '../domain/types';
+import { type SoftphoneActorRef, type StateTypes } from '../state-machine/softphone-state-machine';
+import { WebRtcConfig } from '../domain/types';
 import WazoWebRTCClient from '../web-rtc-client';
 import Call from './call';
 export declare const EVENT_INCOMING = "incoming";
+export declare const EVENT_OUTGOING = "outgoing";
 export declare const EVENT_HEARTBEAT = "heartbeat";
 export declare const EVENT_HEARTBEAT_TIMEOUT = "heartbeatTimeout";
 export declare const EVENT_REGISTERED = "registered";
 export declare const EVENT_UNREGISTERED = "unregistered";
 export declare const EVENT_DISCONNECTED = "disconnected";
 export declare const EVENT_VIDEO_INPUT_CHANGE = "videoInputChange";
+export declare const EVENT_TERMINATE_SOUND = "terminateSound";
+export declare const EVENT_PLAY_HANGUP_SOUND = "playHangupSound";
+export declare const EVENT_PLAY_RING_SOUND = "playRingSound";
+export declare const EVENT_PLAY_INBOUND_CALL_SOUND = "playInboundCallSound";
 export declare const EVENT_ON_MESSAGE = "message";
 export declare const EVENT_ON_CHAT = "phone/ON_CHAT";
 export declare const EVENT_ON_SIGNAL = "phone/ON_SIGNAL";
@@ -26,13 +30,13 @@ export type CallOptions = {
     withCamera?: boolean;
     audioOnly?: boolean;
     conference?: boolean;
+    extraHeaders?: Record<string, any>;
 };
 export declare class Softphone extends EventEmitter {
     audioOutputDeviceId?: string;
     audioRingDeviceId?: string;
     audioOutputVolume: number;
     audioRingVolume: number;
-    eventEmitter: EventEmitter;
     calls: Call[];
     client: WazoWebRTCClient;
     session: Session;
@@ -40,14 +44,19 @@ export declare class Softphone extends EventEmitter {
     softphoneActor: SoftphoneActorRef;
     options: Partial<WebRtcConfig>;
     shouldSendReinvite: boolean;
+    ringingEnabled: boolean;
     constructor();
     connect(options?: Partial<WebRtcConfig>): Promise<void>;
+    hangupAllCalls(): Promise<boolean[]>;
     disconnect(): Promise<void | null>;
     getPrimaryWebRtcLine(): SipLine | null;
     connectWithCredentials(server: string, sipLine: SipLine, displayName: string, rawOptions?: Partial<WebRtcConfig>): Promise<void>;
     reconnect(): void;
     call(options: CallOptions): Promise<Call | null>;
     removeCall(callToRemove: Call): void;
+    onCallTerminated(call: Call): void;
+    enableRinging(): Promise<void> | void;
+    disableRinging(): Promise<void> | void;
     holdAllCalls(exceptCall?: Call | null): void;
     startHeartbeat(): void;
     stopHeartbeat(): void;
@@ -59,18 +68,18 @@ export declare class Softphone extends EventEmitter {
     hasSfu(): boolean;
     changeAudioVolume(volume: number): void;
     changeRingVolume(volume: number): void;
-    getCalls(): Call[];
     getCurrentCall(): Call | undefined;
-    getState(): StateTypes;
+    getActiveCalls(): Call[];
+    getIncomingCalls(): Call[];
+    get state(): StateTypes;
+    get user(): string | undefined;
     getUserAgent(): string;
+    isRegistered(): boolean;
     _bindEvents(): void;
-    _sendAction(action: ActionTypes): void;
-    _getCall(sipCall: SipCall): Call | undefined;
-    _onCallEvent(sipCall: SipCall, eventName: string, ...args: any[]): void;
-    _onMessage(message: Message & {
-        method?: string;
-        body?: string;
-    }): void;
+    private _sendAction;
+    private _getCall;
+    private _onCallEvent;
+    private _onMessage;
 }
 declare const _default: Softphone;
 export default _default;

package/esm/types/voice/softphone.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"softphone.d.ts","sourceRoot":"","sources":["../../../src/voice/softphone.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"softphone.d.ts","sourceRoot":"","sources":["../../../src/voice/softphone.ts"],"names":[],"mappings":"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"}

package/esm/utils/sdp.js

@@ -1,3 +1,4 @@
+/* eslint-disable no-underscore-dangle */
 import sdpParser from 'sdp-transform';
 import { UserAgent } from 'sip.js/lib/api/user-agent';
 import { Inviter } from 'sip.js/lib/api';
@@ -128,3 +129,15 @@ export const replaceLocalIpModifier = (description) => Promise.resolve({
     sdp: description.sdp.replace('c=IN IP4 0.0.0.0', 'c=IN IP4 127.0.0.1'),
 });
 export const makeURI = (target, host) => UserAgent.makeURI(`sip:${target}@${host}`);
+export const getCallNumber = (sipCall) => {
+    // eslint-disable-next-line
+    const identity = sipCall ? sipCall.remoteIdentity || sipCall.assertedIdentity : null;
+    // @ts-ignore: private
+    return identity ? identity.uri._normal.user : null;
+};
+export const getCallDisplayName = (sipCall) => {
+    // eslint-disable-next-line
+    const identity = sipCall ? sipCall.remoteIdentity || sipCall.assertedIdentity : null;
+    const number = getCallNumber(sipCall);
+    return identity ? identity.displayName || number : number;
+};

package/esm/utils/webrtc.js

@@ -173,6 +173,26 @@ export const toggleVideo = (sipCall, muteCamera) => {
         });
     }
 };
+export const isVideoMuted = (sipCall) => {
+    const sdh = sipCall.sessionDescriptionHandler;
+    const pc = sdh?.peerConnection;
+    if (pc?.getSenders) {
+        for (const sender of pc.getSenders()) {
+            if (sender && sender.track && sender.track.kind === 'video') {
+                return !sender.track.enabled;
+            }
+        }
+    }
+    else {
+        for (const stream of pc.getLocalStreams()) {
+            // eslint-disable-next-line no-unreachable-loop
+            for (const track of stream.getVideoTracks()) {
+                return !track.enabled;
+            }
+        }
+    }
+    return true;
+};
 export const cleanupStream = (stream) => {
     stream.getTracks().filter(track => track.enabled).forEach(track => track.stop());
 };

package/esm/voice/call.js

@@ -4,13 +4,17 @@ import { createActor } from 'xstate';
 import { Invitation } from 'sip.js/lib/api/invitation';
 import { SessionState } from 'sip.js/lib/api/session-state';
 import callStateMachine, { Actions, EstablishedActions, States, EstablishedStates } from '../state-machine/call-state-machine';
+import newFrom from '../utils/new-from';
+import updateFrom from '../utils/update-from';
 import IssueReporter from '../service/IssueReporter';
-import { getSipSessionId } from '../utils/sdp';
+import softphone, { EVENT_TERMINATE_SOUND } from './softphone';
+import { getCallDisplayName, getCallNumber, getSipSessionId } from '../utils/sdp';
 import { assertCan, assertState, getState } from '../state-machine/utils';
-import { downgradeToAudio, getLocalStream, getLocalVideoStream, getPeerConnection, getRemoteStream, getRemoteVideoStream, getStreamFromConstraints, getWebRtcStats, hasALocalVideoTrack, hasLocalVideo, hasRemoteVideo, isVideoRemotelyHeld, setLocalMediaStream, toggleVideo, upgradeToVideo } from '../utils/webrtc';
+import { downgradeToAudio, getLocalStream, getLocalVideoStream, getPeerConnection, getRemoteStream, getRemoteVideoStream, getStreamFromConstraints, getWebRtcStats, hasALocalVideoTrack, hasLocalVideo, hasRemoteVideo, isVideoMuted, isVideoRemotelyHeld, setLocalMediaStream, toggleVideo, upgradeToVideo } from '../utils/webrtc';
 const logger = IssueReporter.loggerFor('call');
 // Events
-export const EVENT_CALL_ACCEPTED = 'accepted';
+export const EVENT_CALL_REMOTLY_ACCEPTED = 'remotelyAccepted';
+export const EVENT_CALL_LOCALLY_ACCEPTED = 'locallyAccepted';
 export const EVENT_CALL_CANCELED = 'canceled';
 export const EVENT_PROGRESS = 'progress';
 export const EVENT_EARLY_MEDIA = 'earlyMedia';
@@ -33,12 +37,10 @@ export const EVENT_SHARE_SCREEN_ENDED = 'onScreenShareEnded';
 export const EVENT_WEB_RTC_STATS = 'webRtcStats';
 export const EVENT_CAMERA_RESUMED = 'onCameraResumed';
 export const EVENT_CAMERA_DISABLED = 'onCameraDisabled';
-export const EVENT_TERMINATE_SOUND = 'terminateSound';
 export const MESSAGE_TYPE_CHAT = 'message/TYPE_CHAT';
 export const MESSAGE_TYPE_SIGNAL = 'message/TYPE_SIGNAL';
 export const MESSAGE_TRACK_UPDATED = 'onTrackUpdated';
 class Call extends EventEmitter {
-    eventEmitter;
     callActor;
     // Wazo call id, used in Wazo Websocket and API
     apiId;
@@ -49,7 +51,55 @@ class Call extends EventEmitter {
     endTime;
     phone;
     shouldSendReinvite = false;
+    recording = false;
+    displayName;
+    number;
     currentScreenShare;
+    static newFrom(call) {
+        return newFrom(call, Call);
+    }
+    static parseCall(apiCall) {
+        const sipCall = {
+            id: apiCall.sipCallId,
+            stateChange: {
+                addListener: () => { },
+            },
+            remoteIdentity: {
+                uri: {
+                    _normal: {
+                        user: apiCall.calleeNumber,
+                    },
+                },
+            },
+            // Mock sdk so `hasLocalVideo` will return true.
+            sessionDescriptionHandler: {
+                localMediaStream: {
+                    getTracks: () => (apiCall.isVideo ? [{ kind: 'video', readyState: 'live' }] : []),
+                },
+            },
+        };
+        const call = new Call(sipCall, softphone);
+        // call._sendAction(Actions.ES);
+        call.apiId = apiCall.id;
+        call.answerTime = new Date(+apiCall.startingTime);
+        // Update call state
+        const snapshot = call.callActor.getSnapshot();
+        if (apiCall.isUp()) {
+            snapshot.value = { [States.ESTABLISHED]: EstablishedStates.ONGOING };
+        }
+        if (apiCall.muted) {
+            snapshot.value = { [States.ESTABLISHED]: EstablishedStates.MUTED };
+        }
+        if (apiCall.isRinging()) {
+            snapshot.value = States.RINGING;
+        }
+        if (apiCall.isRecording()) {
+            call.recording = true;
+        }
+        // @ts-ignore
+        call.callActor.update(snapshot);
+        return call;
+    }
     constructor(sipCall, phone) {
         super();
         this.callActor = createActor(callStateMachine);
@@ -57,6 +107,8 @@ class Call extends EventEmitter {
         this.creationTime = new Date();
         this.phone = phone;
         this.sipCall = sipCall;
+        this.number = getCallNumber(sipCall);
+        this.displayName = getCallDisplayName(sipCall);
         this._bindEvents();
     }
     async accept(options = {}) {
@@ -68,6 +120,7 @@ class Call extends EventEmitter {
         this.answerTime = new Date();
         return this.phone.client.answer(this.sipCall, options.withCamera).then(() => {
             logger.info('call - accepted', { id: this.id, ...options });
+            this.emit(EVENT_CALL_LOCALLY_ACCEPTED, this);
             return this.id;
         }).catch(e => {
             logger.error(e);
@@ -78,7 +131,7 @@ class Call extends EventEmitter {
     async reject() {
         assertCan(this.callActor, Actions.REJECT);
         logger.info('call - reject', { id: this.id });
-        this.eventEmitter.emit(EVENT_TERMINATE_SOUND, 'call rejected locally');
+        this.phone.emit(EVENT_TERMINATE_SOUND, 'call rejected locally');
         this.shouldSendReinvite = false;
         return this.hangup();
     }
@@ -87,7 +140,7 @@ class Call extends EventEmitter {
         logger.info('call - hangup', { id: this.id });
         await this.phone.client.hangup(this.sipCall);
         // Remove this call from softphone's calls
-        this.phone.removeCall(this);
+        this.phone.onCallTerminated(this);
         return true;
     }
     forceCancel() {
@@ -99,7 +152,7 @@ class Call extends EventEmitter {
             logger.info('call - force cancel, error', e);
         }
     }
-    startConference(withCalls) {
+    startConference( /* withCalls: Call[] */) {
         // @TODO
         // const participants = [this, ...withCalls].reduce((acc: Record<string, any>, call: Call) => {
         //   acc[call.talkingToIds[0]] = call;
@@ -117,14 +170,14 @@ class Call extends EventEmitter {
         logger.info('call - mute', { id: this.id });
         this._sendAction(EstablishedActions.MUTE);
         this.phone.client.mute(this.sipCall);
-        this.eventEmitter.emit(EVENT_CALL_MUTED);
+        this.emit(EVENT_CALL_MUTED);
     }
     unMute() {
         assertCan(this.callActor, EstablishedActions.UN_MUTE);
         logger.info('call - un-mute', { id: this.id });
         this._sendAction(EstablishedActions.UN_MUTE);
         this.phone.client.unmute(this.sipCall);
-        this.eventEmitter.emit(EVENT_CALL_UN_MUTED);
+        this.emit(EVENT_CALL_UN_MUTED);
     }
     async hold() {
         assertCan(this.callActor, EstablishedActions.HOLD);
@@ -140,7 +193,7 @@ class Call extends EventEmitter {
             await downgradeToAudio(this.sipCall);
         }
         const promise = this.phone.client.hold(this.sipCall, this.isConference(), hasVideo);
-        this.eventEmitter.emit(EVENT_CALL_HELD);
+        this.emit(EVENT_CALL_HELD);
         return promise;
     }
     async resume() {
@@ -167,7 +220,7 @@ class Call extends EventEmitter {
                 this._onScreenSharing(stream, hadVideo, wasDesktop);
             }
         };
-        this.eventEmitter.emit(EVENT_CALL_RESUMED);
+        this.emit(EVENT_CALL_RESUMED);
         return promise.then(() => {
             const stream = this.getLocalVideoStream();
             if (wasScreensharing) {
@@ -180,19 +233,37 @@ class Call extends EventEmitter {
         assertState(this.callActor, States.ESTABLISHED);
         logger.info('call - turn camera on', { id: this.id });
         toggleVideo(this.sipCall, true);
-        this.eventEmitter.emit(EVENT_CAMERA_RESUMED);
+        this.emit(EVENT_CAMERA_RESUMED);
     }
     turnCameraOff() {
         assertState(this.callActor, States.ESTABLISHED);
         logger.info('call -  turn camera off', { id: this.id });
         toggleVideo(this.sipCall, false);
-        this.eventEmitter.emit(EVENT_CAMERA_DISABLED);
+        this.emit(EVENT_CAMERA_DISABLED);
+    }
+    isMuted() {
+        return this._hasEstablishedState(EstablishedStates.MUTED);
+    }
+    isCameraMuted() {
+        return isVideoMuted(this.sipCall);
     }
     isHeld() {
-        return getState(this.callActor) === EstablishedStates.HELD;
+        return this._hasEstablishedState(EstablishedStates.HELD);
+    }
+    isEstablishing() {
+        return this.sipCall.state === SessionState.Establishing;
     }
     isEstablished() {
-        return getState(this.callActor) === States.ESTABLISHED;
+        return States.ESTABLISHED in this.state;
+    }
+    isRinging() {
+        return this.state === States.RINGING;
+    }
+    isOutgoing() {
+        return this.sipCall instanceof Invitation;
+    }
+    isIncoming() {
+        return !this.isOutgoing();
     }
     isConference() {
         return getPeerConnection(this.sipCall)?.sfu;
@@ -200,7 +271,7 @@ class Call extends EventEmitter {
     transfer(target) {
         assertState(this.callActor, States.ESTABLISHED);
         logger.info('call - transfer', { id: this.id, target });
-        this.phone.client.transfer(this.sipCall, target);
+        return this.phone.client.transfer(this.sipCall, target);
     }
     atxfer() {
         assertState(this.callActor, States.ESTABLISHED);
@@ -320,7 +391,7 @@ class Call extends EventEmitter {
         catch (e) {
             console.warn(e);
         }
-        this.eventEmitter.emit(EVENT_SHARE_SCREEN_ENDED);
+        this.emit(EVENT_SHARE_SCREEN_ENDED);
         this.currentScreenShare = null;
         return reinvited;
     }
@@ -331,7 +402,7 @@ class Call extends EventEmitter {
     }
     onAccepted() {
         this._sendAction(Actions.REMOTLY_ACCEPTED);
-        this.emit(EVENT_CALL_ACCEPTED);
+        this.emit(EVENT_CALL_REMOTLY_ACCEPTED);
     }
     onProgress() {
         this.emit(EVENT_PROGRESS);
@@ -345,10 +416,13 @@ class Call extends EventEmitter {
     onError(error) {
         this.emit(EVENT_CALL_ERROR, error);
     }
+    onCallIncoming() {
+        this._sendAction(Actions.INCOMING_CALL);
+    }
     onRejected() {
         this.endTime = new Date();
         this.emit(EVENT_CALL_REJECTED);
-        this.phone.removeCall(this);
+        this.phone.onCallTerminated(this);
     }
     onNetworkStats(stats, previousStats) {
         this.emit(EVENT_WEB_RTC_STATS, stats, previousStats);
@@ -380,13 +454,21 @@ class Call extends EventEmitter {
     onReinvite(request, updatedCalleeName, updatedNumber, hadRemoteVideo) {
         this.emit(EVENT_REINVITE, request, updatedCalleeName, updatedNumber, hadRemoteVideo);
     }
+    updateFrom(call) {
+        updateFrom(this, call);
+    }
+    is(otherCall) {
+        return otherCall && this.id && this.id === otherCall.id;
+    }
     get id() {
         return getSipSessionId(this.sipCall);
     }
-    get number() {
-        const identity = this.sipCall.remoteIdentity || this.sipCall.assertedIdentity;
-        // @ts-ignore: private
-        return identity ? identity.uri._normal.user : null;
+    get state() {
+        return getState(this.callActor);
+    }
+    _hasEstablishedState(establishedState) {
+        const state = this.state;
+        return States.ESTABLISHED in state && state[States.ESTABLISHED] === establishedState;
     }
     _bindEvents() {
         if (this.sipCall instanceof Invitation) {
@@ -396,21 +478,22 @@ class Call extends EventEmitter {
                 logger.trace('call - on sip session canceled', { callId: message.callId, id: this.id });
                 onCancel(message);
                 const elsewhere = message.data.indexOf('cause=26') !== -1 && message.data.indexOf('completed elsewhere') !== -1;
-                this.eventEmitter.emit(EVENT_CALL_CANCELED, elsewhere);
+                this.emit(EVENT_CALL_CANCELED, elsewhere);
             };
         }
         this.sipCall.stateChange.addListener((newState) => {
             switch (newState) {
                 case SessionState.Terminating:
                     logger.info('call - terminating', { id: this.id });
-                    this.eventEmitter.emit(EVENT_CALL_TERMINATING);
+                    this.emit(EVENT_CALL_TERMINATING);
                     break;
                 case SessionState.Terminated:
                     {
                         logger.info('call - terminated', { id: this.id });
                         // Should be called before `_onCallTerminated` or the callCount will not decrement...
                         this.endTime = new Date();
-                        return this.eventEmitter.emit(EVENT_CALL_ENDED);
+                        this.emit(EVENT_CALL_ENDED);
+                        return this.phone.onCallTerminated(this);
                     }
                 default:
                     break;
@@ -437,18 +520,17 @@ class Call extends EventEmitter {
                 kind,
             });
             if (kind === 'audio') {
-                return this.eventEmitter.emit(EVENT_AUDIO_STREAM, stream);
+                return this.emit(EVENT_AUDIO_STREAM, stream);
             }
-            return this.eventEmitter.emit(EVENT_VIDEO_STREAM, stream, event.track.id, event);
+            return this.emit(EVENT_VIDEO_STREAM, stream, event.track.id, event);
         };
         peerConnection.onremovestream = (event) => {
             logger.info('call - on remove stream called on the peer connection', {
                 id: event.stream.id,
                 tracks: event.stream.getTracks(),
             });
-            this.eventEmitter.emit(EVENT_REMOVE_STREAM, event.stream);
+            this.emit(EVENT_REMOVE_STREAM, event.stream);
         };
-        // Client events
     }
     _downgradeToAudio(withMessage = true) {
         assertState(this.callActor, States.ESTABLISHED);
@@ -508,7 +590,7 @@ class Call extends EventEmitter {
         if (screenTrack) {
             screenTrack.onended = () => {
                 logger.info('call - on screenshare ended', { hadVideo, id: this.id, screenTrack });
-                this.eventEmitter.emit(EVENT_SHARE_SCREEN_ENDING);
+                this.emit(EVENT_SHARE_SCREEN_ENDING);
             };
         }
         this.currentScreenShare = {
@@ -518,7 +600,7 @@ class Call extends EventEmitter {
             desktop,
         };
         setLocalMediaStream(this.sipCall, screenStream);
-        this.eventEmitter.emit(EVENT_SHARE_SCREEN_STARTED, screenStream);
+        this.emit(EVENT_SHARE_SCREEN_STARTED, screenStream);
     }
     _sendAction(action) {
         this.callActor.send({ type: action });