@ale-rainbow/web-sdk 5.1.0

package/lib/services/core/contact.service.d.ts

@@ -0,0 +1,617 @@
+import type { ConnectedUserInit, ConnectedUserMedia } from "../../models/contact.model";
+import { Contact } from "../../models/contact.model";
+import type { Subscription } from "rxjs";
+import { Observable } from "rxjs";
+import type { RbServiceEvent } from "../../services/service";
+import type { MaybeArray } from "date-fns";
+import type { UserNetworkService } from "../../services/core/userNetwork.service";
+import type { DirectoryInternalSearchResults, DirectorySearchOptions } from "./directorySearch.service";
+import type { ConnectedUser, ConnectedUserProfile, DisplayOrder, UserCustomData, UserCustomStatus, UserPresenceStatus, UsersByEmailsResult, WebCallCapabilities, User } from "../../models/user.model";
+import { ConnectedUserRB, UserExternalPresenceStatus } from "../../models/user.model";
+/** @internal */
+export declare const CONTACT_SVC = "ContactService";
+/**
+ * The data to be sent when we want to update our user; NB If fileds are not present, they wont be updated on server !
+ * A basic example:
+ * ```ts
+ * {    "firstName": "Hello",
+ *       "lastName": "World",
+ *       "title": "MR",
+ *       "nickName": "Worldwide",
+ *       "jobTitle": "Rainbow SDK guru",
+ *       "country": "EN",
+ *       "language": "en",
+ *       "emails": [
+ *           {
+ *               "email": "work@work.en",
+ *               "type": "work"
+ *           },
+ *           {
+ *               "email": "home@home.en",
+ *               "type": "home"
+ *           }
+ *       ],
+ *       "phoneNumbers": [
+ *           // corresponds to the phonePro property of contact
+ *           {
+ *               "number": "12345",
+ *               "type": "work",
+ *               "deviceType": "landline"
+ *           },
+ *
+ *           // corresponds to the mobilePro property of contact
+ *           {
+ *               "number": "12534",
+ *               "type": "work",
+ *               "deviceType": "mobile",
+ *               "isVisibleByOthers": false
+ *           },
+ *
+ *           // corresponds to the phonePerso property of contact
+ *           {
+ *               "number": "111111",
+ *               "type": "home",
+ *               "deviceType": "landline",
+ *               "isVisibleByOthers": false
+ *           },
+ *
+ *           // corresponds to the mobilePerso property of contact
+ *           {
+ *               "number": "22222",
+ *               "type": "home",
+ *               "deviceType": "mobile",
+ *               "isVisibleByOthers": false
+ *           }
+ *       ]
+ *   }
+ * ```
+ */
+/**
+ * Contact service events sent to other services via sendEvent()
+ * Can listen to it via contactService.subscribe() API
+ * @internal
+ * @eventProperty
+ */
+export declare enum ContactServiceEvents {
+    /**
+     * @eventProperty ON_CONNECTED_USER_PRESENCE_CHANGE
+     * This RB event is sent when the presence of the connected user changes.
+     * It's sent via the innerEvent system.
+     * Used by conversation service to calculate the capabilities of contact in case of presence change of user.
+     */
+    ON_CONNECTED_USER_PRESENCE_CHANGE = "ON_CONNECTED_USER_PRESENCE_CHANGE",
+    /**
+     * @eventProperty ON_USER_PRESENCE_CHANGE
+     * This RB event is sent when the presence of any user changes.
+     * It's sent via the innerEvent system.
+     * Used by conversation service to calculate the capabilities of contact in case of presence change of user.
+     */
+    ON_USER_PRESENCE_CHANGE = "ON_USER_PRESENCE_CHANGE",
+    /**
+     * @eventProperty ON_CONTACT_SERVICE_STARTED
+     * This RB event is sent when the contact service is started and ready to be used.
+     */
+    ON_CONTACT_SERVICE_STARTED = "ON_CONTACT_SERVICE_STARTED",
+    /**
+     * @eventProperty ON_CONNECTED_USER_ROSTER_CHANGE
+     * This RB event is sent when a new contact is added or removed to/from the roster of the connected user.
+     */
+    ON_CONNECTED_USER_ROSTER_CHANGE = "ON_CONNECTED_USER_ROSTER_CHANGE",
+    /**
+     * @eventProperty ON_CONNECTED_USER_CUSTOM_STATUS_CHANGE
+     * This RB event is sent when the custom status of the connected user changes.
+     * It's sent via the innerEvent system.
+     */
+    ON_CONNECTED_USER_CUSTOM_STATUS_CHANGE = "ON_CONNECTED_USER_CUSTOM_STATUS_CHANGE",
+    /**
+     * @eventProperty ON_USER_CUSTOM_STATUS_CHANGE
+     * This RB event is sent when the custom status of any user changes.
+     * It's sent via the innerEvent system.
+     */
+    ON_USER_CUSTOM_STATUS_CHANGE = "ON_USER_CUSTOM_STATUS_CHANGE",
+    /**
+     * @eventProperty ON_CONNECTED_USER__OXEPREFERREDTRUNK_CHANGE
+     * This RB event is sent when OXE  PREFERREDTRUNK of connected user changes.
+     * It's sent via the innerEvent system.
+     */
+    ON_CONNECTED_USER__OXEPREFERREDTRUNK_CHANGE = "ON_CONNECTED_USER__OXEPREFERREDTRUNK_CHANGE",
+    /**
+     * @eventProperty ON_SPLASH_SCREEN_UPDATED
+     * This RB event is sent when the splash backdrop stored for the connected user's company changes
+     * (`localStorage.splashScreen`), so that a splash already on screen can be repainted.
+     */
+    ON_SPLASH_SCREEN_UPDATED = "ON_SPLASH_SCREEN_UPDATED"
+}
+/**
+ * Contact service events sent to other services via sendEvent()
+ * Can listen to it via contactService.events().subscribe() API
+ * @internal
+ * @eventProperty
+ */
+export interface IContactServiceEvents {
+    /**
+     * @eventProperty ON_CONNECTED_USER_PRESENCE_CHANGE
+     * This RB event is sent when the presence of the connected user changes.
+     * It's sent via the innerEvent system.
+     * Used by conversation service to calculate the capabilities of contact in case of presence change of user.
+     */
+    ON_CONNECTED_USER_PRESENCE_CHANGE: Contact;
+    /**
+     * @eventProperty ON_USER_PRESENCE_CHANGE
+     * This RB event is sent when the presence of any user changes.
+     * It's sent via the innerEvent system.
+     * Used by conversation service to calculate the capabilities of contact in case of presence change of user.
+     */
+    ON_USER_PRESENCE_CHANGE: Contact;
+    /**
+     * @eventProperty ON_CONTACT_SERVICE_STARTED
+     * This RB event is sent when the contact service is started and ready to be used.
+     */
+    ON_CONTACT_SERVICE_STARTED: unknown;
+    /**
+     * @eventProperty ON_CONNECTED_USER_ROSTER_CHANGE
+     * This RB event is sent when a new contact is added or removed to/from the roster of the connected user.
+     */
+    ON_CONNECTED_USER_ROSTER_CHANGE: {
+        contact: Contact;
+        action: string;
+    };
+    /**
+     * @eventProperty ON_CONNECTED_USER_CUSTOM_STATUS_CHANGE
+     * This RB event is sent when the custom status of the connected user changes.
+     * It's sent via the innerEvent system.
+     */
+    ON_CONNECTED_USER_CUSTOM_STATUS_CHANGE: ConnectedUser;
+    /**
+     * @eventProperty ON_USER_CUSTOM_STATUS_CHANGE
+     * This RB event is sent when the custom status of any user changes.
+     * It's sent via the innerEvent system.
+     */
+    ON_USER_CUSTOM_STATUS_CHANGE: Contact;
+    /**
+     * @eventProperty ON_CONNECTED_USER__OXEPREFERREDTRUNK_CHANGE
+     * This RB event is sent when OXE  PREFERREDTRUNK of connected user changes.
+     * It's sent via the innerEvent system.
+     */
+    ON_CONNECTED_USER__OXEPREFERREDTRUNK_CHANGE: number;
+    /**
+     * @eventProperty ON_SPLASH_SCREEN_UPDATED
+     * This RB event is sent when the splash backdrop stored for the connected user's company changes
+     * (`localStorage.splashScreen`), so that a splash already on screen can be repainted.
+     */
+    ON_SPLASH_SCREEN_UPDATED: undefined;
+}
+/**
+ * @internal
+ * @eventProperty
+ * Contact service internal events sent to other sevices via sendInnerEvent()
+ * Should not be used by SDK user
+ */
+export declare enum ContactServiceInnerEvents {
+    /**
+     * @eventProperty ON_RAINBOW_ROOM_CONTACT_CREATED
+     * This RB event is sent when a contact of type 'RainbowRoom' (Rainbow TV) is created.
+     * It is sent to the rainbow TV service to link the RB Room/Tv object with the contact.
+     */
+    ON_RAINBOW_ROOM_CONTACT_CREATED = "ON_RAINBOW_ROOM_CONTACT_CREATED",
+    /**
+     * @eventProperty ON_CONNECTED_USER_SETTINGS_UPDATED
+     * This RB event is sent to detect a change on the user settings custom object.
+     * At the moment it is only used for the 'ringingOnDnd' flag.
+     */
+    ON_CONNECTED_USER_SETTINGS_UPDATED = "ON_CONNECTED_USER_SETTINGS_UPDATED",
+    /**
+     * @eventProperty ON_MOBILE_TELEPHONY_STATUS_CHANGE
+     * This RBEvent is sent when there's a change in the mobile telephony status.
+     */
+    ON_MOBILE_TELEPHONY_STATUS_CHANGE = "ON_MOBILE_TELEPHONY_STATUS_CHANGE",
+    /**
+     * @eventProperty ON_CONNECTED_USER_JID_RESOURCE_CHANGE
+     * This RB event is sent when the list of my resources has changed.
+     */
+    ON_CONNECTED_USER_JID_RESOURCE_CHANGE = "ON_CONNECTED_USER_JID_RESOURCE_CHANGE",
+    /**
+     * @eventProperty ON_CONNECTED_USER_AVATAR_CHANGE
+     * This RBEvent is sent to detect a change on the user'avatar.
+     * Used by Admin only at the moment.
+     */
+    ON_CONNECTED_USER_AVATAR_CHANGE = "ON_CONNECTED_USER_AVATAR_CHANGE",
+    /**
+     * @eventProperty ON_CONNECTED_USER__OXEPREFERREDTRUNK_CHANGE
+     * This RB event is sent when OXE  PREFERREDTRUNK of connected user changes.
+     * It's sent via the innerEvent system.
+     */
+    ON_CONNECTED_USER__OXEPREFERREDTRUNK_CHANGE = "ON_CONNECTED_USER__OXEPREFERREDTRUNK_CHANGE"
+}
+export interface IncomingCallsConfig {
+    showCallerCompany: boolean;
+    showCallerDepartment: boolean;
+    showCallerTag: boolean;
+}
+/**
+ * Notification & sound preferences of the connected user, persisted in `customData.notifications`.
+ * Any new notification/sound preference must be added here rather than at the root of `customData`.
+ */
+export interface NotificationsConfig {
+    /** Display a popup when an instant message is received (`imNotif` setting). */
+    imNotif: boolean;
+}
+declare const ContactService_base: object & (abstract new (...args: any[]) => import("../../services/service").EventsMixinTemplate<IContactServiceEvents>);
+/**
+ * @internal
+ */
+export declare class ContactService extends ContactService_base {
+    private eventService;
+    private settingsService;
+    private mainService;
+    private logger;
+    private errorHelperService;
+    private authService;
+    private i18nService;
+    private companyService;
+    private xmppService;
+    private networkService;
+    private userService;
+    private readonly innerRxSubject;
+    private subscriptions;
+    private xmppConnectionSubscription;
+    private presentationModeEventHandlerCleaner;
+    private contactConfigRef;
+    private contactNotifyRef;
+    contacts: Record<string, Contact>;
+    dbContacts: Record<string, Contact>;
+    jtelContacts: Record<string, Contact>;
+    userNetwork?: UserNetworkService;
+    userContact?: ConnectedUserRB;
+    currentLanguage: string;
+    /** Whether the Contact Service has been started or not. Same pattern as BubbleServiceRB.started. */
+    private readonly startedSubject;
+    readonly $started: Observable<boolean>;
+    get started(): boolean;
+    private _displayOrder;
+    private subscriptionPromiseQueue;
+    private getContactPromises;
+    private lastActivityDatePromises;
+    private lastUpdatePresentationMode;
+    private presentationModeTimeout;
+    private apiConfigTTL;
+    private apiConfigTTLTimeout;
+    private presentationModeActive;
+    private awayStateActive;
+    private busyState;
+    manualState: boolean;
+    dndStateActivated: boolean;
+    private getRosterTimeout;
+    static getInstance(): ContactService;
+    static build(): ContactService;
+    private constructor();
+    start(contactServiceConfig?: any): Promise<void>;
+    stop(): Promise<void>;
+    reconnect(): void;
+    private updateUserContactCompany;
+    private attachHandlers;
+    private onNotifyEvent;
+    /**
+     * Stores in localStorage the backdrop the app paints behind the splash and the authentication
+     * pages, from the user's company: its uploaded image, the neutral backdrop for a trial company
+     * without one, or the default Rainbow photo.
+     *
+     * Called at start-up and on reconnection, and by the subscription service once a purchase has
+     * changed the company (a trial stamps `freemiumTypes`).
+     *
+     * @internal
+     */
+    updateSplashScreen(): void;
+    getApiConfigurationFromServer(): Promise<void>;
+    private onConnectionStateChangeEvent;
+    /**
+     * Update my fullJid with the new after a reconnection
+     */
+    private updateUserContactFullJid;
+    private contactPresenceChangedHandler;
+    private onContactChangeEvent;
+    private rosterChangedHandlerPromise;
+    private onUserManagementEvent;
+    private contactCustomStatusChangedHandler;
+    private onPresentationModeChangedEvent;
+    private startUpdatePresentationModeRefreshTimer;
+    /**
+     * Update the user's password
+     * @param oldPassword - The old password
+     * @param newPassword - The new password
+     * @param async - [optional] if TRUE, the resolve of this API will be done once the change is taken into account also on XMPP side; Default value is FALSE
+     */
+    updateConnectedUserPassword(oldPassword: string, newPassword: string, async?: boolean): Promise<User>;
+    /**
+     * Update the current user avatar
+     * @param base64Image - Base64 image to be uploaded
+     */
+    setAvatar(base64Image: string): Promise<User>;
+    /**
+     *  Remove the current user custom avatar (reset to default avatar)
+     */
+    removeAvatar(): Promise<User>;
+    setUserSettings(params: any): Promise<void>;
+    /**
+     * Get/Set the user setting for display order of first and last names
+     */
+    getDisplayOrder(): DisplayOrder;
+    setDisplayOrder(displayOrder: DisplayOrder): void;
+    /**
+     * Checks that an email address is valid.
+     * @param emailAddress - The email address to check
+     */
+    isEmailAddressValid(emailAddress: string): boolean;
+    /**
+     * Checks that a phone number is valid.
+     * @param phoneNumber - The phone number to check
+     */
+    isPhoneNumberValid(phoneNumber: string): boolean;
+    /**
+     * Subscribe to updates from the service (all events are of RBEvent type \{name: string, data:any \});
+     * Here's a list of events received :
+     * name: 'ON_CONTACT_SERVICE_STARTED
+     * NB There might be some events that are not documented here, they're sent on updates of different properties of the contact.
+     * @param handler - The call-back function that will be subscribed to the RxJS subject
+     * @param eventNames - (optional) array of event to listen
+     */
+    subscribe(handler: (event: RbServiceEvent<IContactServiceEvents>) => any, eventNames?: MaybeArray<keyof IContactServiceEvents>): Subscription;
+    subscribeToInnerEvents(handler: any): Subscription;
+    private sendInnerEvent;
+    private sendContactUpdateEvent;
+    /**
+     * Get all contacts stored for the current user;
+     */
+    getContacts(): Contact[];
+    /**
+     * Async method which get a contact.
+     * The contact is first search in service cache then server side.
+     * @param contactRef - a contact jid or contact dbId or contact jid tel
+     */
+    getContact(contactRef: string): Promise<Contact | undefined>;
+    /**
+     * Get a contact in service cache by his dbId
+     * @param dbId - the dbID of the contact to be found
+     */
+    getContactFromCacheById(dbId: string): Contact | undefined;
+    /**
+     * Get contact in cache by his jid
+     * @param id - the jid of the contact to be found
+     */
+    getContactFromCacheByJid(jid: string): Contact;
+    /**
+     * Get a contact by his jid tel
+     * @param jidTel - the jid tel of the contact to be found
+     */
+    getContactByJidTel(jidTel: string): Contact;
+    /**
+     * Sync method which get a contact.
+     * The contact is searched in service cache
+     * @param contactRef - A contact jid or contact dbId or contact jid tel
+     */
+    getContactFromCache(contactRef: string): Contact | undefined;
+    getContactById(id: string, server?: boolean): Promise<Contact | undefined>;
+    /**
+     * Get a contact by dbId
+     * If not found, the contact will be searched on server.
+     * @param dbId - the dbId of the contact to be found
+     * @param force - [optional] if TRUE, this will force an update of the contact from the server
+     */
+    getContactByDBId(dbId: string, force?: boolean): Promise<Contact>;
+    private getContactByDbIdInner;
+    getContactByJid(jid: string, server?: boolean): Promise<Contact | undefined>;
+    getContactsByJids(jids: string[]): Promise<void>;
+    /**
+     * Get a contact by his email
+     * @param email - the email of the contact to be found
+     */
+    getContactFromCacheByEmail(email: string): Contact;
+    getContactByEmail(email: string, server?: boolean): Promise<Contact | undefined>;
+    getContactsByEmails(emails: string[]): Promise<UsersByEmailsResult>;
+    getContactInfoByEmail(email: string): Promise<any>;
+    /**
+     * Get a contact by his phonenumber
+     * @param phonenumber - the phonenumber of the contact to be found
+     */
+    getContactFromCacheByPhoneNumber(phonenumber: string): Contact;
+    /**
+     * Get a contact which contains a phoneNumber from cache
+     * @param phonenumber - the phonenumber of the contact to be found
+     */
+    getContactFromCacheContainsPhoneNumber(phonenumber: string): Contact;
+    /**
+     * Get a directory contact by his phonenumber
+     * @param phonenumber - the phonenumber of the contact to be found
+     */
+    getDirectoryContactByPhoneNumber(phonenumber: string): Contact;
+    /**
+     * Get contact by jid or by his phone number; If not found, contact will created and updated from server if possible
+     * @param jid - the jid of the contact to be found
+     * @param phoneNumber - if user has no jid, it could be found by his phone number
+     */
+    getOrCreateContact(jid: string, phoneNumber?: string): Promise<Contact>;
+    private createConnectedUser;
+    createContact(): Contact;
+    createBotContact(jid: string, name: string, id: string, botAvatarUrl: string, botCapabilities: any, isRainbowSupportBot: boolean): Contact;
+    createBasicContact(jid: string, phoneNumber?: string, append?: boolean): Contact;
+    createEmptyContact(jid: string): Contact;
+    /**
+    * Create a new directory contact instance (as Contact model).
+    * Used for contact from Business directory / Personal directory / Microsoft Azure Active directory
+    * Usually only Personal directory contacts are stored in the 'contacts' database.
+    * @param id - The id of the new created directory contact
+    * @param storeDb - Flag indicating whether the contact should be stored in the 'contacts' id-key database
+    */
+    createDirectoryContact(id: string, storeDb?: boolean): Contact;
+    createCallLogContact(phoneNumber: string): Contact;
+    createContactFromData(userData: any): Contact;
+    updateContactFromServer(contact: Contact): Promise<void>;
+    updateContactPersonalRoutines(contactJidIm: string, personalRoutineData: any): void;
+    /**
+     * Update the user's profile data (name, emails, numbers, etc)
+     * Returns the updated user if success and an update on the contact RX is received (or undefined, if the user is not allowed to update his profile)
+     * @param userProfile - The userData to be sent to the server for update
+     * @param checkProfile - when true check if userModification is allowed for this user
+     */
+    updateUserProfile(userProfile: ConnectedUserProfile & ConnectedUserInit & ConnectedUserMedia, checkProfile?: boolean): Promise<User>;
+    /**
+     * Update the user's custom data (emergencyImSound, enablePushToTalkTone, guideTourDisplayed, etc...)
+     * Returns the updated contact if success and an update on the contact RX is received (or undefined, if the user is not allowed to update his profile)
+     * @param UserCustomData - customData to be sent to the server for update
+     */
+    updateUserCustomData(customData: UserCustomData): Promise<Contact>;
+    /**
+     * Get the custom data stored by the logged in application for the logged in user.
+     * Unlike the user's `customData` ({@link updateUserCustomData}), these data are private to the application
+     * and changing them generates no user update event.
+     * @returns the stored custom data (an empty object if nothing is stored yet)
+     */
+    getApplicationCustomData(): Promise<Record<string, unknown>>;
+    /**
+     * Store custom data for the logged in application and the logged in user.
+     * ⚠️ The existing data are overwritten by the new ones: always send the whole object.
+     * @param customData - the whole custom data object to store
+     * @returns the stored custom data
+     */
+    updateApplicationCustomData(customData: Record<string, unknown>): Promise<Record<string, unknown>>;
+    /**
+     * Update the user's custom status
+     * @param status - status of type {@link UserCustomStatus} to be sent to the server for update
+     */
+    updateUserCustomStatus(status: UserCustomStatus): Promise<void>;
+    /**
+     * Delete the user's custom status
+     */
+    deleteUserCustomStatus(): Promise<void>;
+    /**
+     * Delete the account of the connected user.
+     * his API will delete the current user from the server ! BE CAREFUL !
+     */
+    deleteConnectedUserAccount(): Promise<void>;
+    /**
+    * Remove a directory contact instance from the 'contacts' cache database.
+    * Warning: The reference must be deleted by the caller, nothing done here !
+    * Mainly used for personal directory contact management.
+    * @param deletedContact - The directory contact to remove from cache.
+    */
+    removeDirectoryContactFromCache(deletedContact: Contact): void;
+    /**
+     * Get the contact associated to the connected user.
+     */
+    getConnectedUser(): User;
+    private refreshUserNetwork;
+    private getNetwork;
+    /**
+     * Returns the list of personal directory contacts defined by the connected user.
+     * The 'PERSONAL_DIRECTORY' feature must be available.
+     */
+    getPersonnalDirectoryContacts(): Contact[];
+    searchContacts(criteria: string): Contact[];
+    /**
+     * Search users in the Rainbow users network (ie 'My Network') of the connected user by using a specified pattern to filter items.
+     * Resolves with an array of contacts and the total number of users matching the criteria.
+     * @param searchPattern - Pattern to search
+     * @param options - Search options
+     */
+    searchRainbowUsersNetwork(searchPattern: string, options?: DirectorySearchOptions): DirectoryInternalSearchResults;
+    private setUserContactStatus;
+    private calculateContactStatusFromResources;
+    private updatePresence;
+    private updateContactTelephonyStatus;
+    private updateContactIMStatus;
+    private getMissedPresenceMessages;
+    private manageUserSettingsPresenceChange;
+    updateContactRichStatus(contact: Contact, isMe?: boolean): void;
+    sendPresenceFromConfiguration(sendAuthInfo?: boolean): Promise<void>;
+    /**
+     * Return a list of available status that the user can use if he want to change his presence (via changeMyPresence API).
+     * Possible values are ["online", "away", "xa", "dnd"]
+     *    Online: User goes to online (or can "exit") any manual state; In case of a call in progress, the user will go to busy state;
+     *    Away: Manual Away state
+     *    xa: "invisble" or "appear offline" manual state
+     *    dnd: Do not disturb manual state
+     */
+    getConnectedUserAvailablePresenceStatusList(): string[];
+    setConnectedUserCustomExternalPresence(presenceStatus: UserExternalPresenceStatus, customMessage?: string): Promise<void>;
+    removeConnectedUserCustomExternalPresence(): Promise<void>;
+    /**
+     * Change the current user presence status (if allowed); The status list can be get at all time via computeStatusList
+     * @param status - The presence status that the user wants to set to his user. The status list can be get via computeStatusList API
+     */
+    setConnectedUserPresence(presenceStatus: UserPresenceStatus | string): void;
+    resetBusyState(): void;
+    setBusyState(status: string, message: string, noUpdate?: boolean): void;
+    /**
+     * Retrieve from the server all the phone numbers associated with a contact.
+     * This is basically done for a USER contact and if these numbers have not already been retrieved.
+     * @param contact - the contact
+     */
+    retrieveContactPhoneNumbers(contact: Contact): Promise<Contact>;
+    private getUserSettings;
+    getUserSettingFromSettingsService(settings: string): string;
+    getContactLastActivityDate(contact: Contact): Promise<void>;
+    private updateLastActivity;
+    private updateContactLastActivityDate;
+    /**
+     * Update the user auto dnd calendar settings. If activated, and if the user is sharing with
+     * Rainbow his current calendar (Office 365 or Google Calendar), the presence will automatically go to DND
+     * in case of a meeting scheduled in the calendar.
+     * NB: The user can "exit" the current DND state by simply changing his presence (this will not
+     *      deactivate the settings, but will "disable" it for the current meeting, until the next one)
+     * NB: The change of the parameter does not affect the current meeting! It's taken into account for the next one
+     * @param activate - boolean that will activate / deactivate the settings
+     */
+    updateUserAutoDndCalendarSetting(activate: boolean): Promise<boolean>;
+    /**
+     * Get the user auto dnd calendar settings. If activated, and if the user is sharing with
+     * Rainbow his current calendar (Office 365 or Google Calendar), the presence will automatically go to DND
+     * in case of a meeting scheduled in the calendar. For more information check updateUserAutoDndCalendarSetting API
+     */
+    getUserAutoDndCalendarSetting(): boolean;
+    private manageCalendarPresencePrompt;
+    /**
+     * Update the user MS Teams presence calendar settings. If activated, and if the user is sharing with
+     * Rainbow his current calendar (Office 365), the presence from his MS Teams client is managed and the Rainbow application
+     * will go to busy or DND in case the presence in teams change;
+     * @param activate - boolean that will activate / deactivate the settings
+     */
+    updateUserMSTeamsPresenceSetting(activate: boolean): Promise<boolean>;
+    /**
+     * Get the user MS Teams presence calendar settings. If activated, and if the user is sharing with
+     * Rainbow his current calendar (Office 365), the presence from his MS Teams client is managed and the Rainbow application
+     * will go to busy or DND in case the presence in his Teams client change;
+     */
+    getUserMSTeamsPresenceSetting(): boolean;
+    /**
+     * Get the capabilities representing the medias that could be used for a WebRTC Call with the specified remote Rainbow user.
+     */
+    getConnectedUserWebRTCCallCapabilities(remoteParty: User): WebCallCapabilities;
+    createWebRTCCapabilitiesObservable(remoteParty: User): Observable<WebCallCapabilities>;
+    notifyImByEmail(contact: Contact): Promise<void>;
+    shouldShowNotification(): boolean;
+    isTelJid(jid: string): boolean;
+    isMediaPillarJid(jid: string): boolean;
+    isUserContact(contact: Contact | User): boolean;
+    isUserContactJid(jid: string): boolean;
+    getResourceFromJid(jid: string): string;
+    getImJid(jid: string): string;
+    isSingleComputerClient(): boolean;
+    myMobileAvailable(): string;
+    contactMatcher(contact: Contact, criteria: string): boolean;
+    getIncomingCallsConfig(): IncomingCallsConfig;
+    /**
+     * Read the notification preferences stored in `customData.notifications`.
+     * A preference not stored there yet falls back to the local storage value, so a user who never
+     * changed the setting since the migration keeps the behaviour of their current browser.
+     */
+    getNotificationsConfig(): NotificationsConfig;
+    /**
+     * Persist a subset of the notification preferences in `customData.notifications` and realign the
+     * local storage (and, on the desktop app, the container settings) with the new values, so the
+     * existing `settingsService.getSetting(...)` consumers stay correct.
+     */
+    updateNotificationsConfig(config: Partial<NotificationsConfig>): Promise<void>;
+    private applyNotificationsConfigToSettings;
+}
+export {};
+//# sourceMappingURL=contact.service.d.ts.map

package/lib/services/core/contact.service.d.ts.map

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