@wazo/sdk 0.40.3 → 0.40.5

package/src/api/auth.ts

@@ -1,5 +1,5 @@
 import ApiRequester from '../utils/api-requester';
-import type { User, Tenant, Token, UUID, LogoutResponse, ListTenantsResponse, RequestError, ListUsersResponse, ListGroupsResponse, ListPoliciesResponse, GetTenantResponse, GetUserResponse } from '../domain/types';
+import type { User, Tenant, Token, UUID, LogoutResponse, ListTenantsResponse, ListUsersResponse, ListGroupsResponse, ListPoliciesResponse, GetTenantResponse, GetUserResponse } from '../domain/types';
 import Session, { Response } from '../domain/Session';
 
 export const DEFAULT_BACKEND_USER = 'wazo_user';
@@ -34,7 +34,7 @@ export interface AuthD {
   sendResetPasswordEmail: (params: SendResetPasswordArgs) => Promise<boolean>;
   resetPassword: (userUuid: string, password: string) => Promise<boolean>;
   removeDeviceToken: (userUuid: UUID) => Promise<void>;
-  createUser: (username: string, password: string, firstname: string, lastname: string) => Promise<User | RequestError>;
+  createUser: (username: string, password: string, firstname: string, lastname: string) => Promise<User>;
   addUserEmail: (userUuid: UUID, email: string, main?: boolean) => Promise<void>;
   addUserPolicy: (userUuid: UUID, policyUuid: UUID) => Promise<void>;
   getRestrictionPolicies: (scopes: string[]) => Promise<any>;
@@ -46,18 +46,18 @@ export interface AuthD {
   getUserSession: (userUuid: UUID) => Promise<any>; // @TODO
   deleteUserSession: (userUuid: UUID, sessionUuids: UUID) => Promise<void>;
   listUsers: () => Promise<ListUsersResponse>;
-  deleteUser: (userUuid: UUID) => Promise<boolean | RequestError>;
+  deleteUser: (userUuid: UUID) => Promise<boolean>;
   listTenants: () => Promise<ListTenantsResponse>;
   getTenant: (tenantUuid: UUID) => Promise<GetTenantResponse>;
-  createTenant: (name: string) => Promise<Tenant | RequestError>;
-  updateTenant: (uuid: UUID, name: string, contact: string, phone: string, address: Array<Record<string, any>>) => Promise<Tenant | RequestError>;
-  deleteTenant: (uuid: UUID) => Promise<boolean | RequestError>;
+  createTenant: (name: string) => Promise<Tenant>;
+  updateTenant: (uuid: UUID, name: string, contact: string, phone: string, address: Array<Record<string, any>>) => Promise<Tenant>;
+  deleteTenant: (uuid: UUID) => Promise<boolean>;
   createGroup: (name: string) => Promise<void>;
   listGroups: () => Promise<ListGroupsResponse>;
-  deleteGroup: (uuid: UUID) => Promise<boolean | RequestError>;
+  deleteGroup: (uuid: UUID) => Promise<boolean>;
   createPolicy: (name: string, description: string, aclTemplates: Array<Record<string, any>>) => Promise<void>;
   listPolicies: () => Promise<ListPoliciesResponse>;
-  deletePolicy: (policyUuid: UUID) => Promise<boolean | RequestError>;
+  deletePolicy: (policyUuid: UUID) => Promise<boolean>;
   getProviders: (userUuid: UUID) => Promise<any>; // @TODO
   getProviderToken: (userUuid: UUID, provider: string) => Promise<string>; // @TODO; validate
   getProviderAuthUrl: (userUuid: UUID, provider: string) => Promise<string>;
@@ -186,7 +186,7 @@ export default ((client: ApiRequester, baseUrl: string): AuthD => ({
     return client.post(`${baseUrl}/users/password/reset?user_uuid=${userUuid}`, body, null, ApiRequester.successResponseParser);
   },
   removeDeviceToken: (userUuid: UUID) => client.delete(`${baseUrl}/users/${userUuid}/external/mobile`),
-  createUser: (username: string, password: string, firstname: string, lastname: string): Promise<User | RequestError> => {
+  createUser: (username: string, password: string, firstname: string, lastname: string): Promise<User> => {
     const body = {
       username,
       password,
@@ -216,13 +216,13 @@ export default ((client: ApiRequester, baseUrl: string): AuthD => ({
   getUserSession: (userUuid: UUID) => client.get(`${baseUrl}/users/${userUuid}/sessions`),
   deleteUserSession: (userUuid: UUID, sessionUuids: UUID) => client.delete(`${baseUrl}/users/${userUuid}/sessions/${sessionUuids}`),
   listUsers: (): Promise<ListUsersResponse> => client.get(`${baseUrl}/users`),
-  deleteUser: (userUuid: UUID): Promise<boolean | RequestError> => client.delete(`${baseUrl}/users/${userUuid}`),
+  deleteUser: (userUuid: UUID): Promise<boolean> => client.delete(`${baseUrl}/users/${userUuid}`),
   listTenants: (): Promise<ListTenantsResponse> => client.get(`${baseUrl}/tenants`),
   getTenant: (tenantUuid: UUID): Promise<GetTenantResponse> => client.get(`${baseUrl}/tenants/${tenantUuid}`),
-  createTenant: (name: string): Promise<Tenant | RequestError> => client.post(`${baseUrl}/tenants`, {
+  createTenant: (name: string): Promise<Tenant> => client.post(`${baseUrl}/tenants`, {
     name,
   }),
-  updateTenant: (uuid: UUID, name: string, contact: string, phone: string, address: Array<Record<string, any>>): Promise<Tenant | RequestError> => {
+  updateTenant: (uuid: UUID, name: string, contact: string, phone: string, address: Array<Record<string, any>>): Promise<Tenant> => {
     const body = {
       name,
       contact,
@@ -231,12 +231,12 @@ export default ((client: ApiRequester, baseUrl: string): AuthD => ({
     };
     return client.put(`${baseUrl}/tenants/${uuid}`, body);
   },
-  deleteTenant: (uuid: UUID): Promise<boolean | RequestError> => client.delete(`${baseUrl}/tenants/${uuid}`),
+  deleteTenant: (uuid: UUID): Promise<boolean> => client.delete(`${baseUrl}/tenants/${uuid}`),
   createGroup: (name: string) => client.post(`${baseUrl}/groups`, {
     name,
   }),
   listGroups: (): Promise<ListGroupsResponse> => client.get(`${baseUrl}/groups`),
-  deleteGroup: (uuid: UUID): Promise<boolean | RequestError> => client.delete(`${baseUrl}/groups/${uuid}`),
+  deleteGroup: (uuid: UUID): Promise<boolean> => client.delete(`${baseUrl}/groups/${uuid}`),
   createPolicy: (name: string, description: string, aclTemplates: Array<Record<string, any>>) => {
     const body = {
       name,
@@ -248,7 +248,7 @@ export default ((client: ApiRequester, baseUrl: string): AuthD => ({
     return client.post(`${baseUrl}/policies`, body);
   },
   listPolicies: (): Promise<ListPoliciesResponse> => client.get(`${baseUrl}/policies`),
-  deletePolicy: (policyUuid: UUID): Promise<boolean | RequestError> => client.delete(`${baseUrl}/policies/${policyUuid}`),
+  deletePolicy: (policyUuid: UUID): Promise<boolean> => client.delete(`${baseUrl}/policies/${policyUuid}`),
   getProviders: (userUuid: UUID) => client.get(`${baseUrl}/users/${userUuid}/external`),
   getProviderToken: (userUuid: UUID, provider: string) => client.get(`${baseUrl}/users/${userUuid}/external/${provider}`),
   getProviderAuthUrl: (userUuid: UUID, provider: string) => client.post(`${baseUrl}/users/${userUuid}/external/${provider}`, {}),

package/src/api/calld.ts

@@ -1,6 +1,6 @@
 /* eslint-disable camelcase */
 import ApiRequester from '../utils/api-requester';
-import type { UUID, RequestError } from '../domain/types';
+import type { UUID } from '../domain/types';
 import Relocation, { RelocationResponse } from '../domain/Relocation';
 import ChatMessage, { ChatMessageListResponse } from '../domain/ChatMessage';
 import Voicemail from '../domain/Voicemail';
@@ -23,15 +23,15 @@ export interface CallD {
   cancelCall: (callId: string) => Promise<boolean>;
   listCalls: () => Promise<Array<Call>>;
   relocateCall: (callId: string, destination: string, lineId: number | null | undefined, contact?: string | null | undefined) => Promise<Relocation>;
-  listVoicemails: () => Promise<RequestError | Array<Voicemail>>;
-  deleteVoicemail: (voicemailId: number) => Promise<boolean>;
+  listVoicemails: () => Promise<Array<Voicemail>>;
+  deleteVoicemail: (voicemailId: string) => Promise<boolean>;
   getVoicemailUrl: (voicemail: Voicemail) => string;
   fetchSwitchboardHeldCalls: (switchboardUuid: UUID) => Promise<any>; // @TODO: replace `any`
   holdSwitchboardCall: (switchboardUuid: UUID, callId: string) => Promise<boolean>;
   answerSwitchboardHeldCall: (switchboardUuid: UUID, callId: string, lineId: string | null | undefined) => Promise<void>;
   fetchSwitchboardQueuedCalls: (switchboardUuid: UUID) => Promise<any>; // @TODO: replace `any`
   answerSwitchboardQueuedCall: (switchboardUuid: UUID, callId: string, lineId: string | null | undefined) => Promise<any>; // @TODO: replace `any`
-  sendFax: (extension: string, fax: string, callerId: string | null | undefined) => Promise<void>;
+  sendFax: (extension: string, fax: string, callerId?: string) => Promise<void>;
   getConferenceParticipantsAsUser: (conferenceId: string) => Promise<Record<string, any>>; // @TODO: replace `any`
   getMeetingParticipantsAsUser: (meetingUuid: string) => Promise<Record<string, any>>; // @TODO: replace `any`
   banMeetingParticipant: (meetingUuid: string, participantUuid: string) => Promise<boolean>;
@@ -125,8 +125,8 @@ export default ((client: ApiRequester, baseUrl: string): CallD => ({
     return client.post(`${baseUrl}/users/me/relocates`, body).then((response: RelocationResponse) => Relocation.parse(response));
   },
 
-  listVoicemails: (): Promise<RequestError | Array<Voicemail>> => client.get(`${baseUrl}/users/me/voicemails`).then((response: any) => Voicemail.parseMany(response)),
-  deleteVoicemail: (voicemailId: number): Promise<boolean> => client.delete(`${baseUrl}/users/me/voicemails/messages/${voicemailId}`),
+  listVoicemails: (): Promise<Array<Voicemail>> => client.get(`${baseUrl}/users/me/voicemails`).then((response: any) => Voicemail.parseMany(response)),
+  deleteVoicemail: (voicemailId: string): Promise<boolean> => client.delete(`${baseUrl}/users/me/voicemails/messages/${voicemailId}`),
   getVoicemailUrl: (voicemail: Voicemail): string => {
     const body = {
       token: client.token,
@@ -138,7 +138,7 @@ export default ((client: ApiRequester, baseUrl: string): CallD => ({
   answerSwitchboardHeldCall: (switchboardUuid: UUID, callId: string, lineId: string | null | undefined = null) => client.put(`${baseUrl}/switchboards/${switchboardUuid}/calls/held/${callId}/answer${lineId ? `?line_id=${lineId}` : ''}`),
   fetchSwitchboardQueuedCalls: (switchboardUuid: UUID) => client.get(`${baseUrl}/switchboards/${switchboardUuid}/calls/queued`),
   answerSwitchboardQueuedCall: (switchboardUuid: UUID, callId: string, lineId: string | null | undefined = null) => client.put(`${baseUrl}/switchboards/${switchboardUuid}/calls/queued/${callId}/answer${lineId ? `?line_id=${lineId}` : ''}`),
-  sendFax: (extension: string, fax: string, callerId: string | null | undefined = null) => {
+  sendFax: (extension: string, fax: string, callerId?: string) => {
     const headers = {
       'Content-type': 'application/pdf',
       'X-Auth-Token': client.token,

package/src/api/ctid-ng.ts

@@ -2,7 +2,7 @@
 
 /* DEPRECATED: USE CALLD INSTEAD CTID-NG */
 import ApiRequester from '../utils/api-requester';
-import type { UUID, RequestError, CTITransfer } from '../domain/types';
+import type { UUID, CTITransfer } from '../domain/types';
 import Relocation from '../domain/Relocation';
 import ChatMessage from '../domain/ChatMessage';
 import Voicemail, { Response } from '../domain/Voicemail';
@@ -30,10 +30,10 @@ export interface CtidNg {
   cancelCall: (callId: number) => Promise<boolean>;
   listCalls: () => Promise<Array<Call>>;
   relocateCall: (callId: number, destination: string, lineId: number | null | undefined, contact?: string | null | undefined) => Promise<Relocation>;
-  transferCall: (callId: number, number: string, flow: string) => Promise<RequestError | CTITransfer>;
-  cancelCallTransfer: (transferId: string) => Promise<RequestError | void>;
-  confirmCallTransfer: (transferId: string) => Promise<RequestError | void>;
-  listVoicemails: () => Promise<RequestError | Array<Voicemail>>;
+  transferCall: (callId: number, number: string, flow: string) => Promise<CTITransfer>;
+  cancelCallTransfer: (transferId: string) => Promise<void>;
+  confirmCallTransfer: (transferId: string) => Promise<void>;
+  listVoicemails: () => Promise<Array<Voicemail>>;
   deleteVoicemail: (voicemailId: number) => Promise<boolean>;
   getPresence: (contactUuid: UUID) => Promise<GetPresenceResponse>;
   getStatus: (lineUuid: UUID) => Promise<string>;
@@ -112,7 +112,7 @@ export default ((client: ApiRequester, baseUrl: string): CtidNg => ({
     return client.post(`${baseUrl}/users/me/relocates`, body).then(Relocation.parse);
   },
 
-  transferCall(callId: number, number: string, flow: string = TRANSFER_FLOW_BLIND): Promise<RequestError | CTITransfer> {
+  transferCall(callId: number, number: string, flow: string = TRANSFER_FLOW_BLIND): Promise<CTITransfer> {
     const body: Record<string, any> = {
       exten: number,
       flow,
@@ -122,10 +122,10 @@ export default ((client: ApiRequester, baseUrl: string): CtidNg => ({
   },
 
   // @TODO: fix response type
-  cancelCallTransfer: (transferId: string): Promise<RequestError | void> => client.delete(`${baseUrl}/users/me/transfers/${transferId}`),
+  cancelCallTransfer: (transferId: string): Promise<void> => client.delete(`${baseUrl}/users/me/transfers/${transferId}`),
   // @TODO: fix response type
-  confirmCallTransfer: (transferId: string): Promise<RequestError | void> => client.put(`${baseUrl}/users/me/transfers/${transferId}/complete`),
-  listVoicemails: (): Promise<RequestError | Array<Voicemail>> => client.get(`${baseUrl}/users/me/voicemails`, null).then((response: Response) => Voicemail.parseMany(response)),
+  confirmCallTransfer: (transferId: string): Promise<void> => client.put(`${baseUrl}/users/me/transfers/${transferId}/complete`),
+  listVoicemails: (): Promise<Array<Voicemail>> => client.get(`${baseUrl}/users/me/voicemails`, null).then((response: Response) => Voicemail.parseMany(response)),
   deleteVoicemail: (voicemailId: number): Promise<boolean> => client.delete(`${baseUrl}/users/me/voicemails/messages/${voicemailId}`, null),
   getPresence: (contactUuid: UUID): Promise<{
     presence: string;

package/src/api/dird.ts

@@ -1,16 +1,9 @@
 import { jsonToGraphQLQuery } from 'json-to-graphql-query/lib/jsonToGraphQLQuery';
 import ApiRequester from '../utils/api-requester';
-import type { PhonebookResponseItem, UUID } from '../domain/types';
+import type { UuidSearchableQueryParams, SearchableQueryParams, PhonebookResponseItem, QueryParams, UUID } from '../domain/types';
 import { Contact, ContactsResponse } from '../index';
 import type { NewContact, DirectorySource, DirectorySources } from '../index';
 
-type PhoneBookSearchQueryParams = {
-  order?: string;
-  direction?: 'asc' | 'desc';
-  limit?: number;
-  offset?: number;
-};
-
 const getContactPayload = (contact: NewContact | Contact) => ({
   email: contact.email,
   firstname: (contact as any).firstName ? (contact as any).firstName : '',
@@ -24,7 +17,7 @@ const getContactPayload = (contact: NewContact | Contact) => ({
 
 export interface DirD {
   search: (context: string, term: string) => Promise<Array<Contact>>;
-  listPersonalContacts: (queryParams?: ContactSearchQueryParams) => Promise<Array<Contact>>;
+  listPersonalContacts: (queryParams?: QueryParams) => Promise<Array<Contact>>;
   fetchPersonalContact: (contactUuid: string) => Promise<Contact>;
   addContact: (contact: NewContact) => Promise<Contact>;
   editContact: (contact: Contact) => Promise<Contact>;
@@ -34,35 +27,27 @@ export interface DirD {
   markAsFavorite: (source: string, sourceId: string) => Promise<boolean>;
   removeFavorite: (source: string, sourceId: string) => Promise<void>;
   fetchOffice365Source: (context: string) => Promise<DirectorySources>;
-  fetchOffice365Contacts: (source: DirectorySource, queryParams: ContactSearchQueryParams) => Promise<Contact[]> ;
+  fetchOffice365Contacts: (source: DirectorySource, queryParams: SearchableQueryParams) => Promise<Contact[]> ;
   fetchWazoSource: (context: string) => Promise<DirectorySources>;
   fetchSourcesFor: (context: string, backend: string) => Promise<DirectorySources>;
-  fetchWazoContacts: (source: DirectorySource, queryParams: ContactSearchQueryParams) => Promise<Contact[]>;
+  fetchWazoContacts: (source: DirectorySource, queryParams: UuidSearchableQueryParams) => Promise<Contact[]>;
   fetchGoogleSource: (context: string) => Promise<DirectorySources>;
-  fetchGoogleContacts: (source: DirectorySource, queryParams: ContactSearchQueryParams) => Promise<Contact[]>;
+  fetchGoogleContacts: (source: DirectorySource, queryParams: SearchableQueryParams) => Promise<Contact[]>;
   fetchConferenceSource: (context: string) => Promise<DirectorySources>;
-  fetchConferenceContacts: (source: DirectorySource) => Promise<Contact[]>;
-  fetchPhonebookContacts: (source: DirectorySource, params?: PhoneBookSearchQueryParams) => Promise<{ items: PhonebookResponseItem[], total: number }>;
+  fetchConferenceContacts: (source: DirectorySource, queryParams?: SearchableQueryParams) => Promise<Contact[]>;
+  fetchPhonebookContacts: (source: DirectorySource, queryParams?: QueryParams) => Promise<{ items: PhonebookResponseItem[], total: number }>;
   findMultipleContactsByNumber: (numbers: string[], fields?: Record<string, any>) => Promise<Contact[]>;
 }
 
-type ContactSearchQueryParams = {
-  order?: string;
-  direction?: 'asc' | 'desc';
-  limit?: number;
-  offset?: number;
-  search?: string;
-  uuid?: string;
-} | null;
 export default ((client: ApiRequester, baseUrl: string): DirD => ({
   search: (context: string, term: string, offset = 0, limit: (number | null) = null): Promise<Array<Contact>> => client.get(`${baseUrl}/directories/lookup/${context}`, {
     term,
   }).then((response: ContactsResponse) => Contact.parseMany(response, offset, limit)),
-  listPersonalContacts: (queryParams: ContactSearchQueryParams = null): Promise<Array<Contact>> => client.get(`${baseUrl}/personal`, queryParams).then((response: any) => Contact.parseManyPersonal(response.items)),
+  listPersonalContacts: (queryParams?: QueryParams): Promise<Array<Contact>> => client.get(`${baseUrl}/personal`, queryParams).then((response: any) => Contact.parseManyPersonal(response.items)),
   fetchPersonalContact: (contactUuid: string): Promise<Contact> => client.get(`${baseUrl}/personal/${contactUuid}`).then(Contact.parsePersonal),
   addContact: (contact: NewContact): Promise<Contact> => client.post(`${baseUrl}/personal`, getContactPayload(contact)).then(Contact.parsePersonal),
   editContact: (contact: Contact): Promise<Contact> => client.put(`${baseUrl}/personal/${contact.sourceId || contact.id || ''}`, getContactPayload(contact)).then(Contact.parsePersonal),
-  importContacts: (csv: string): Promise<Contact[]> => {
+  importContacts: async (csv: string): Promise<Contact[]> => {
     const headers = {
       'Content-Type': 'text/csv; charset=utf-8',
       'X-Auth-Token': client.token,
@@ -79,7 +64,7 @@ export default ((client: ApiRequester, baseUrl: string): DirD => ({
   fetchOffice365Source: (context: string): Promise<DirectorySources> => client.get(`${baseUrl}/directories/${context}/sources`, {
     backend: 'office365',
   }),
-  fetchOffice365Contacts: (source: DirectorySource, queryParams: ContactSearchQueryParams = null): Promise<Contact[]> => {
+  fetchOffice365Contacts: async (source: DirectorySource, queryParams?: SearchableQueryParams): Promise<Contact[]> => {
     if (!source) {
       return Promise.resolve([]);
     }
@@ -90,7 +75,7 @@ export default ((client: ApiRequester, baseUrl: string): DirD => ({
     backend: 'wazo',
   }),
   // Can be used with `queryParams = { uuid: uuid1, uuid2 }` to fetch multiple contacts
-  fetchWazoContacts: (source: DirectorySource, queryParams: ContactSearchQueryParams = null): Promise<Contact[]> => {
+  fetchWazoContacts: async (source: DirectorySource, queryParams?: UuidSearchableQueryParams): Promise<Contact[]> => {
     if (!source) {
       return Promise.resolve([]);
     }
@@ -100,7 +85,7 @@ export default ((client: ApiRequester, baseUrl: string): DirD => ({
   fetchGoogleSource: (context: string): Promise<DirectorySources> => client.get(`${baseUrl}/directories/${context}/sources`, {
     backend: 'google',
   }),
-  fetchGoogleContacts: (source: DirectorySource, queryParams: ContactSearchQueryParams = null): Promise<Contact[]> => {
+  fetchGoogleContacts: async (source: DirectorySource, queryParams?: SearchableQueryParams): Promise<Contact[]> => {
     if (!source) {
       return Promise.resolve([]);
     }
@@ -111,19 +96,19 @@ export default ((client: ApiRequester, baseUrl: string): DirD => ({
     backend: 'conference',
   }),
   fetchSourcesFor: (context: string, backend: string): Promise<DirectorySources> => client.get(`${baseUrl}/directories/${context}/sources`, { backend }),
-  fetchPhonebookContacts: (source: DirectorySource, params?: PhoneBookSearchQueryParams): Promise<{ items: PhonebookResponseItem[], total: number }> => {
+  fetchPhonebookContacts: async (source: DirectorySource, queryParams?: QueryParams): Promise<{ items: PhonebookResponseItem[], total: number }> => {
     if (!source) {
       return Promise.resolve({ items: [], total: 0 });
     }
 
-    return client.get(`${baseUrl}/backends/phonebook/sources/${source.uuid}/contacts`, params);
+    return client.get(`${baseUrl}/backends/phonebook/sources/${source.uuid}/contacts`, queryParams);
   },
-  fetchConferenceContacts: (source: DirectorySource): Promise<Contact[]> => {
+  fetchConferenceContacts: async (source: DirectorySource, queryParams?: SearchableQueryParams): Promise<Contact[]> => {
     if (!source) {
       return Promise.resolve([]);
     }
 
-    return client.get(`${baseUrl}/backends/conference/sources/${source.uuid}/contacts`).then((response: any) => Contact.parseManyConference(response.items, source));
+    return client.get(`${baseUrl}/backends/conference/sources/${source.uuid}/contacts`, queryParams).then((response: any) => Contact.parseManyConference(response.items, source));
   },
   // Graphql
   findMultipleContactsByNumber: (numbers: string[], fields?: Record<string, any>): Promise<Contact[]> => {

package/src/domain/ExternalApp.ts

@@ -16,7 +16,7 @@ export default class ExternalApp {
 
   type: string;
 
-  configuration: Record<string, any> | undefined;
+  configuration?: Record<string, any>;
 
   static parse(plain: Response): ExternalApp {
     return new ExternalApp({

package/src/domain/Phone/CTIPhone.ts

@@ -6,6 +6,7 @@ import type { Phone, AvailablePhoneOptions } from './Phone';
 import Emitter from '../../utils/Emitter';
 import CallApi from '../../service/CallApi';
 import IssueReporter from '../../service/IssueReporter';
+import IndirectTransfer from '../IndirectTransfer';
 
 export const TRANSFER_FLOW_ATTENDED = 'attended';
 export const TRANSFER_FLOW_BLIND = 'blind';
@@ -187,9 +188,9 @@ export default class CTIPhone extends Emitter implements Phone {
     return Promise.resolve(false);
   }
 
-  async initiateCTIIndirectTransfer(callSession: CallSession, number: string): Promise<any> {
+  async initiateCTIIndirectTransfer(callSession: CallSession, number: string): Promise<IndirectTransfer | null> {
     if (!callSession) {
-      return;
+      return Promise.resolve(null);
     }
 
     logger.info('indirect CTI transfer', {

package/src/domain/Phone/Phone.ts

@@ -3,6 +3,7 @@ import Line from '../Line';
 import CallSession from '../CallSession';
 import type WebRTCClient from '../../web-rtc-client';
 import { IEmitter } from '../../utils/Emitter';
+import IndirectTransfer from '../IndirectTransfer';
 
 export type PhoneEventCallbacks = {
   onCallIncoming?: (number: string) => void;
@@ -29,7 +30,7 @@ export type AvailablePhoneOptions = {
   transfer: boolean;
 };
 export interface Phone extends IEmitter {
-  accept(callSession: CallSession, enableVideo: boolean): Promise<string | null>;
+  accept(callSession: CallSession, enableVideo?: boolean): Promise<string | null>;
   changeAudioDevice(id: string): PhoneVoid;
   changeRingDevice(id: string): PhoneVoid;
   changeAudioVolume(volume: number): PhoneVoid;
@@ -46,11 +47,11 @@ export interface Phone extends IEmitter {
   getOptions(): AvailablePhoneOptions;
   getRemoteStreamForCall(callSession: CallSession): MediaStream | null | undefined;
   ignore(callSession: CallSession): PhoneVoid;
-  hangup(callSession: CallSession): Promise<boolean>;
+  hangup(callSession?: CallSession): Promise<boolean>;
   hasAnActiveCall(): boolean;
   hold(callSession: CallSession): Promise<any> | null | undefined;
   indirectTransfer(source: CallSession, destination: CallSession): Promise<boolean>;
-  initiateCTIIndirectTransfer(callSession: CallSession, number: string): PhoneVoid;
+  initiateCTIIndirectTransfer(callSession: CallSession, number: string): Promise<IndirectTransfer | null>;
   cancelCTIIndirectTransfer(transferId: string): PhoneVoid;
   confirmCTIIndirectTransfer(transferId: string): PhoneVoid;
   hasVideo(callSession: CallSession): boolean;

package/src/domain/Phone/WebRTCPhone.ts

@@ -68,13 +68,13 @@ export default class WebRTCPhone extends Emitter implements Phone {
 
   incomingSessions: string[];
 
-  currentSipSession: WazoSession | undefined;
+  currentSipSession?: WazoSession;
 
-  currentCallSession: CallSession | null | undefined;
+  currentCallSession?: CallSession;
 
-  audioOutputDeviceId: string | null | undefined;
+  audioOutputDeviceId?: string;
 
-  audioRingDeviceId: string | null | undefined;
+  audioRingDeviceId?: string;
 
   audioOutputVolume: number;
 
@@ -94,7 +94,7 @@ export default class WebRTCPhone extends Emitter implements Phone {
 
   shouldSendReinvite: boolean;
 
-  constructor(client: WazoWebRTCClient, audioOutputDeviceId: string | null | undefined, allowVideo = false, audioRingDeviceId?: string) {
+  constructor(client: WazoWebRTCClient, audioOutputDeviceId: string | undefined, allowVideo = false, audioRingDeviceId?: string) {
     super();
     this.client = client;
     this.allowVideo = allowVideo;
@@ -156,7 +156,7 @@ export default class WebRTCPhone extends Emitter implements Phone {
     return true;
   }
 
-  async sendReinvite(callSession: CallSession | null | undefined, constraints: Record<string, any> | null | undefined = null, conference = false, audioOnly = false, iceRestart = false): Promise<OutgoingInviteRequest | void> {
+  async sendReinvite(callSession?: CallSession, constraints: Record<string, any> | null | undefined = null, conference = false, audioOnly = false, iceRestart = false): Promise<OutgoingInviteRequest | void> {
     const sipSession = this.findSipSession(callSession);
     logger.info('WebRTC phone - send reinvite', {
       sessionId: sipSession ? sipSession.id : null,
@@ -271,7 +271,7 @@ export default class WebRTCPhone extends Emitter implements Phone {
     return this.client.onDisconnect();
   }
 
-  _downgradeToAudio(callSession: CallSession | null | undefined, withMessage = true) {
+  _downgradeToAudio(callSession?: CallSession, withMessage = true) {
     const sipSession = this.findSipSession(callSession);
 
     if (!sipSession) {
@@ -298,7 +298,7 @@ export default class WebRTCPhone extends Emitter implements Phone {
   }
 
   // Returns true if we need to send a re-INVITE request
-  async _upgradeToVideo(callSession: CallSession | null | undefined, constraints: Record<string, any>, isConference: boolean): Promise<boolean> {
+  async _upgradeToVideo(callSession: CallSession | undefined, constraints: Record<string, any>, isConference: boolean): Promise<boolean> {
     const sipSession = this.findSipSession(callSession);
 
     if (!sipSession) {
@@ -342,7 +342,7 @@ export default class WebRTCPhone extends Emitter implements Phone {
     return false;
   }
 
-  _sendReinviteMessage(callSession: CallSession | null | undefined, isUpgrade: boolean) {
+  _sendReinviteMessage(callSession: CallSession | undefined, isUpgrade: boolean) {
     const sipSession = this.findSipSession(callSession);
     logger.info('Sending reinvite message', {
       id: callSession ? callSession.getId() : null,
@@ -506,7 +506,7 @@ export default class WebRTCPhone extends Emitter implements Phone {
     return screenShareStream;
   }
 
-  async stopScreenSharing(restoreLocalStream = true, callSession?: CallSession | null | undefined): Promise<OutgoingInviteRequest | void | null> {
+  async stopScreenSharing(restoreLocalStream = true, callSession?: CallSession): Promise<OutgoingInviteRequest | void | null> {
     if (!this.currentScreenShare) {
       return;
     }
@@ -983,7 +983,7 @@ export default class WebRTCPhone extends Emitter implements Phone {
     return promise;
   }
 
-  async holdSipSession(sipSession: WazoSession, callSession: CallSession | null | undefined, withEvent = true): Promise<OutgoingInviteRequest | void> {
+  async holdSipSession(sipSession: WazoSession, callSession?: CallSession, withEvent = true): Promise<OutgoingInviteRequest | void> {
     if (!sipSession) {
       return new Promise((resolve, reject) => reject(new Error('No session to hold')));
     }
@@ -1077,7 +1077,7 @@ export default class WebRTCPhone extends Emitter implements Phone {
     });
   }
 
-  mute(callSession: CallSession | null | undefined, withEvent = true): void {
+  mute(callSession?: CallSession, withEvent = true): void {
     logger.info('WebRTC mute called', {
       id: callSession ? callSession.getId() : null,
     });
@@ -1105,7 +1105,7 @@ export default class WebRTCPhone extends Emitter implements Phone {
     }
   }
 
-  unmute(callSession: CallSession | null | undefined, withEvent = true): void {
+  unmute(callSession?: CallSession, withEvent = true): void {
     logger.info('WebRTC unmute called', {
       id: callSession ? callSession.getId() : null,
     });
@@ -1171,7 +1171,7 @@ export default class WebRTCPhone extends Emitter implements Phone {
     this.eventEmitter.emit(ON_CAMERA_DISABLED, this._createCameraDisabledCallSession(sipSession, callSession));
   }
 
-  sendKey(callSession: CallSession | null | undefined, tone: string): void {
+  sendKey(callSession: CallSession | undefined, tone: string): void {
     const sipSession = this.findSipSession(callSession);
 
     if (!sipSession) {
@@ -1248,7 +1248,7 @@ export default class WebRTCPhone extends Emitter implements Phone {
     return Promise.resolve(callSession);
   }
 
-  transfer(callSession: CallSession | null | undefined, target: string): void {
+  transfer(callSession: CallSession, target: string): void {
     const sipSession = this.findSipSession(callSession);
 
     if (!sipSession) {
@@ -1290,13 +1290,13 @@ export default class WebRTCPhone extends Emitter implements Phone {
     });
   }
 
-  initiateCTIIndirectTransfer() {}
+  initiateCTIIndirectTransfer() { return Promise.resolve(null); }
 
   cancelCTIIndirectTransfer() {}
 
   confirmCTIIndirectTransfer() {}
 
-  async hangup(callSession?: CallSession | null): Promise<boolean> {
+  async hangup(callSession?: CallSession): Promise<boolean> {
     const sipSession = this.findSipSession(callSession);
 
     if (!sipSession) {
@@ -1322,17 +1322,17 @@ export default class WebRTCPhone extends Emitter implements Phone {
     return true;
   }
 
-  async getStats(callSession: CallSession | null | undefined): Promise<RTCStatsReport | null | undefined> {
+  async getStats(callSession?: CallSession): Promise<RTCStatsReport | null | undefined> {
     const sipSession = this.findSipSession(callSession);
     return sipSession ? this.client.getStats(sipSession) : null;
   }
 
-  startNetworkMonitoring(callSession: CallSession | null | undefined, interval = 1000) {
+  startNetworkMonitoring(callSession?: CallSession, interval = 1000) {
     const sipSession = this.findSipSession(callSession);
     return sipSession ? this.client.startNetworkMonitoring(sipSession, interval) : null;
   }
 
-  stopNetworkMonitoring(callSession: CallSession | null | undefined) {
+  stopNetworkMonitoring(callSession?: CallSession) {
     const sipSession = this.findSipSession(callSession);
     return sipSession ? this.client.stopNetworkMonitoring(sipSession) : null;
   }
@@ -1360,7 +1360,7 @@ export default class WebRTCPhone extends Emitter implements Phone {
 
     if (isCurrent) {
       this.currentSipSession = undefined;
-      this.currentCallSession = null;
+      this.currentCallSession = undefined;
     }
 
     this.eventEmitter.emit(ON_TERMINATE_SOUND, callSession, 'locally ended');
@@ -1392,7 +1392,7 @@ export default class WebRTCPhone extends Emitter implements Phone {
     this.unbind();
     this.incomingSessions = [];
     this.currentSipSession = undefined;
-    this.currentCallSession = null;
+    this.currentCallSession = undefined;
     this.shouldSendReinvite = false;
     this.rejectedSessions = {};
   }
@@ -1667,7 +1667,7 @@ export default class WebRTCPhone extends Emitter implements Phone {
   }
 
   // Find a corresponding sipSession from a CallSession
-  findSipSession(callSession: CallSession | null | undefined): WazoSession | null | undefined {
+  findSipSession(callSession?: CallSession): WazoSession | null | undefined {
     const keys = this.client.getSipSessionIds();
     const keyIndex = keys.findIndex(sessionId => callSession && callSession.isId(sessionId));
 

package/src/domain/Session.ts

@@ -1,5 +1,6 @@
 /* eslint-disable no-nested-ternary */
 import { KEYUTIL, KJUR, b64utoutf8 } from 'jsrsasign';
+import moment from 'moment';
 import swarmPublicKey from '../pubkey';
 import Profile from './Profile';
 import Contact from './Contact';
@@ -126,7 +127,7 @@ export default class Session {
       authorizations,
       acl: plain.data.acls ? plain.data.acls : plain.data.acl ? plain.data.acl : [],
       tenantUuid: plain.data.metadata ? plain.data.metadata.tenant_uuid : undefined,
-      expiresAt: new Date(`${plain.data.utc_expires_at}z`),
+      expiresAt: moment.utc(plain.data.utc_expires_at).toDate(),
       stackUuid: plain.data.xivo_uuid,
       // eslint-disable-next-line
       stackHostFromHeader: plain._headers?.get?.('wazo-stack-host'),

package/src/domain/types.ts

@@ -9,15 +9,6 @@ type GenericObject = Record<string, any>;
 export type Token = string;
 export type UUID = string;
 export type DateString = string;
-export type RequestError = {
-  timestamp: number;
-  message: string;
-  resource: string;
-  error_id: string;
-  details: {
-    uuid: string;
-  };
-};
 export type LogoutResponse = {
   data: {
     message: string;
@@ -306,3 +297,18 @@ export type PresenceResponse = {
   user_uuid: string;
   last_activity?: string,
 };
+
+export type QueryParams = {
+  order?: string;
+  direction?: 'asc' | 'desc';
+  limit?: number;
+  offset?: number;
+};
+
+export type SearchableQueryParams = QueryParams & {
+  search?: string;
+};
+
+export type UuidSearchableQueryParams = SearchableQueryParams & {
+  uuid?: string;
+};

package/src/index.ts

@@ -47,6 +47,7 @@ export { default as WebSocketClient, SOCKET_EVENTS } from './websocket-client';
 export { default as WebRTCClient } from './web-rtc-client';
 export { default as WazoApiClient } from './api-client';
 export { default as Agent, AgentResponse, AgentArguments } from './domain/Agent';
+export { default as ExternalApp } from './domain/ExternalApp';
 export * from './types/WebSocketMessage';
 export * from './utils/PhoneNumberUtil';
 export * from './domain/types';

package/src/simple/Auth.ts

@@ -372,6 +372,8 @@ class Auth {
         this.checkSubscription(session, +this.minSubscriptionType);
       }
     } catch (e: any) {
+      logger.error('on authenticated error', e);
+
       // Destroy tokens when validation fails
       if (this.clientId) {
         await getApiClient().auth.deleteRefreshToken(this.clientId);

package/src/simple/Directory.ts

@@ -2,8 +2,8 @@ import type Contact from '../domain/Contact';
 import getApiClient from '../service/getApiClient';
 
 class Directory {
-  async findMultipleContactsByNumber(numbers: string[]): Promise<Contact[]> {
-    return getApiClient().dird.findMultipleContactsByNumber(numbers);
+  async findMultipleContactsByNumber(numbers: string[], fields?: Record<string, any>): Promise<Contact[]> {
+    return getApiClient().dird.findMultipleContactsByNumber(numbers, fields);
   }
 
 }

package/src/simple/Phone.ts

@@ -204,7 +204,7 @@ class Phone extends Emitter {
     if (this.phone) {
       if (this.phone.hasAnActiveCall()) {
         logger.info('hangup call on disconnect');
-        await this.phone.hangup(null);
+        await this.phone.hangup();
       }
 
       await this.phone.close();