/** * This file is part of Threema Web. * * Threema Web is free software: you can redistribute it and/or modify it * under the terms of the GNU Affero General Public License as published by * the Free Software Foundation, either version 3 of the License, or (at * your option) any later version. * * This program is distributed in the hope that it will be useful, but * WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero * General Public License for more details. * * You should have received a copy of the GNU Affero General Public License * along with Threema Web. If not, see . */ /// /// /// import {StateService as UiStateService} from '@uirouter/angularjs'; import * as msgpack from 'msgpack-lite'; import { arraysAreEqual, copyDeep, hasFeature, hasValue, hexToU8a, msgpackVisualizer, randomString, stringToUtf8a, u8aToHex, } from '../helpers'; import {isContactReceiver, isDistributionListReceiver, isGroupReceiver, isValidReceiverType} from '../typeguards'; import {BatteryStatusService} from './battery'; import {BrowserService} from './browser'; import {TrustedKeyStoreService} from './keystore'; import {MessageService} from './message'; import {MimeService} from './mime'; import {NotificationService} from './notification'; import {PeerConnectionHelper} from './peerconnection'; import {PushService} from './push'; import {QrCodeService} from './qrcode'; import {ReceiverService} from './receiver'; import {StateService} from './state'; import {TitleService} from './title'; import {VersionService} from './version'; import {ChunkCache} from '../protocol/cache'; import {SequenceNumber} from '../protocol/sequence_number'; // Aliases import InitializationStep = threema.InitializationStep; import ContactReceiverFeature = threema.ContactReceiverFeature; import DisconnectReason = threema.DisconnectReason; /** * Payload of a connectionInfo message. */ interface ConnectionInfo { id: ArrayBuffer; resume?: { id: ArrayBuffer; sequenceNumber: number; }; } const fakeConnectionId = Uint8Array.from([ 1, 2, 3, 4, 5, 6, 7, 8, 1, 2, 3, 4, 5, 6, 7, 8, 1, 2, 3, 4, 5, 6, 7, 8, 1, 2, 3, 4, 5, 6, 7, 8, ]); /** * This service handles everything related to the communication with the peer. */ export class WebClientService { private static CHUNK_SIZE = 64 * 1024; private static SEQUENCE_NUMBER_MIN = 0; private static SEQUENCE_NUMBER_MAX = (2 ** 32) - 1; private static CHUNK_CACHE_SIZE_MAX = 2 * 1024 * 1024; private static AVATAR_LOW_MAX_SIZE = 48; private static MAX_TEXT_LENGTH = 3500; private static MAX_FILE_SIZE_WEBRTC = 15 * 1024 * 1024; private static CONNECTION_ID_NONCE = stringToUtf8a('connectionidconnectionid'); private static TYPE_REQUEST = 'request'; private static TYPE_RESPONSE = 'response'; private static TYPE_UPDATE = 'update'; private static TYPE_CREATE = 'create'; private static TYPE_DELETE = 'delete'; private static SUB_TYPE_RECEIVER = 'receiver'; private static SUB_TYPE_RECEIVERS = 'receivers'; private static SUB_TYPE_CONVERSATIONS = 'conversations'; private static SUB_TYPE_CONVERSATION = 'conversation'; private static SUB_TYPE_MESSAGE = 'message'; private static SUB_TYPE_MESSAGES = 'messages'; private static SUB_TYPE_TEXT_MESSAGE = 'textMessage'; private static SUB_TYPE_FILE_MESSAGE = 'fileMessage'; private static SUB_TYPE_AVATAR = 'avatar'; private static SUB_TYPE_THUMBNAIL = 'thumbnail'; private static SUB_TYPE_BLOB = 'blob'; private static SUB_TYPE_TYPING = 'typing'; private static SUB_TYPE_READ = 'read'; private static SUB_TYPE_CLIENT_INFO = 'clientInfo'; private static SUB_TYPE_KEY_PERSISTED = 'keyPersisted'; private static SUB_TYPE_ACK = 'ack'; private static SUB_TYPE_CONTACT_DETAIL = 'contactDetail'; private static SUB_TYPE_CONTACT = 'contact'; private static SUB_TYPE_GROUP = 'group'; private static SUB_TYPE_DISTRIBUTION_LIST = 'distributionList'; private static SUB_TYPE_ALERT = 'alert'; private static SUB_TYPE_GROUP_SYNC = 'groupSync'; private static SUB_TYPE_BATTERY_STATUS = 'batteryStatus'; private static SUB_TYPE_CLEAN_RECEIVER_CONVERSATION = 'cleanReceiverConversation'; private static SUB_TYPE_CONFIRM = 'confirm'; private static SUB_TYPE_CONFIRM_ACTION = 'confirmAction'; // TODO: deprecated private static SUB_TYPE_PROFILE = 'profile'; private static SUB_TYPE_CONNECTION_ACK = 'connectionAck'; private static SUB_TYPE_CONNECTION_DISCONNECT = 'connectionDisconnect'; private static SUB_TYPE_CONNECTION_INFO = 'connectionInfo'; private static ARGUMENT_MODE = 'mode'; private static ARGUMENT_MODE_NEW = 'new'; private static ARGUMENT_MODE_MODIFIED = 'modified'; private static ARGUMENT_MODE_REMOVED = 'removed'; private static ARGUMENT_RECEIVER_TYPE = 'type'; private static ARGUMENT_RECEIVER_ID = 'id'; private static ARGUMENT_TEMPORARY_ID = 'temporaryId'; // TODO: deprecated private static ARGUMENT_REFERENCE_MSG_ID = 'refMsgId'; private static ARGUMENT_AVATAR = 'avatar'; private static ARGUMENT_AVATAR_HIGH_RESOLUTION = 'highResolution'; private static ARGUMENT_NICKNAME = 'publicNickname'; private static ARGUMENT_IS_TYPING = 'isTyping'; private static ARGUMENT_MESSAGE_ID = 'messageId'; private static ARGUMENT_HAS_MORE = 'more'; private static ARGUMENT_MESSAGE_ACKNOWLEDGED = 'acknowledged'; private static ARGUMENT_IDENTITY = 'identity'; private static ARGUMENT_SUCCESS = 'success'; // TODO: deprecated private static ARGUMENT_SYSTEM_CONTACT = 'systemContact'; private static ARGUMENT_NAME = 'name'; private static ARGUMENT_MEMBERS = 'members'; private static ARGUMENT_FIRST_NAME = 'firstName'; private static ARGUMENT_LAST_NAME = 'lastName'; private static ARGUMENT_DELETE_TYPE = 'deleteType'; private static ARGUMENT_ERROR = 'error'; // TODO: deprecated private static ARGUMENT_MAX_SIZE = 'maxSize'; private static ARGUMENT_USER_AGENT = 'userAgent'; private static ARGUMENT_BROWSER_NAME = 'browserName'; private static ARGUMENT_BROWSER_VERSION = 'browserVersion'; private static DELETE_GROUP_TYPE_LEAVE = 'leave'; private static DELETE_GROUP_TYPE_DELETE = 'delete'; private static DATA_FIELD_BLOB_BLOB = 'blob'; private static DATA_FIELD_BLOB_TYPE = 'type'; private static DATA_FIELD_BLOB_NAME = 'name'; private static DC_LABEL = 'THREEMA'; private logTag: string = '[WebClientService]'; // Angular services private $state: UiStateService; private $log: ng.ILogService; private $rootScope: any; private $q: ng.IQService; private $window: ng.IWindowService; private $translate: ng.translate.ITranslateService; private $filter: any; private $timeout: ng.ITimeoutService; private $mdDialog: ng.material.IDialogService; // Custom services private batteryStatusService: BatteryStatusService; private browserService: BrowserService; private messageService: MessageService; private mimeService: MimeService; private notificationService: NotificationService; private pushService: PushService; private qrCodeService: QrCodeService; private receiverService: ReceiverService; private titleService: TitleService; private versionService: VersionService; // State handling private startupPromise: ng.IDeferred<{}> = null; // TODO: deferred type public startupDone: boolean = false; private pendingInitializationStepRoutines: Set = new Set(); private initialized: Set = new Set(); private stateService: StateService; private lastPush: Date = null; // Session connection private saltyRtcHost: string = null; public salty: saltyrtc.SaltyRTC = null; private connectionInfoFuture: Future = null; private webrtcTask: saltyrtc.tasks.webrtc.WebRTCTask = null; private relayedDataTask: saltyrtc.tasks.relayed_data.RelayedDataTask = null; private secureDataChannel: saltyrtc.tasks.webrtc.SecureDataChannel = null; public chosenTask: threema.ChosenTask = threema.ChosenTask.None; private outgoingMessageSequenceNumber: SequenceNumber; private previousConnectionId: Uint8Array = null; private currentConnectionId: Uint8Array = null; private previousIncomingChunkSequenceNumber: SequenceNumber = null; private currentIncomingChunkSequenceNumber: SequenceNumber; private previousChunkCache: ChunkCache = null; private currentChunkCache: ChunkCache = null; private handshakeCompleted: boolean = false; private ackTimer: number | null = null; private pendingAckRequest: number | null = null; // Message chunking private unchunker: chunkedDc.Unchunker = null; // Messenger data public messages: threema.Container.Messages; public conversations: threema.Container.Conversations; public receivers: threema.Container.Receivers; public alerts: threema.Alert[] = []; private pushToken: string = null; private pushTokenType: threema.PushTokenType = null; // Other private config: threema.Config; private container: threema.Container.Factory; private typingInstance: threema.Container.Typing; private drafts: threema.Container.Drafts; private pcHelper: PeerConnectionHelper = null; private trustedKeyStore: TrustedKeyStoreService; public clientInfo: threema.ClientInfo = null; public version = null; private batteryStatusTimeout: ng.IPromise = null; private blobCache = new Map(); private loadingMessages = new Map(); public receiverListener: threema.ReceiverListener[] = []; // Msgpack private msgpackEncoderOptions: msgpack.EncoderOptions = { codec: msgpack.createCodec({binarraybuffer: true}), }; private msgpackDecoderOptions: msgpack.DecoderOptions = { codec: msgpack.createCodec({binarraybuffer: true}), }; // Messages that require acknowledgement private wireMessageFutures: Map> = new Map(); public static $inject = [ '$log', '$rootScope', '$q', '$state', '$window', '$translate', '$filter', '$timeout', '$mdDialog', 'Container', 'TrustedKeyStore', 'StateService', 'NotificationService', 'MessageService', 'PushService', 'BrowserService', 'TitleService', 'QrCodeService', 'MimeService', 'ReceiverService', 'VersionService', 'BatteryStatusService', 'CONFIG', ]; constructor($log: ng.ILogService, $rootScope: any, $q: ng.IQService, $state: UiStateService, $window: ng.IWindowService, $translate: ng.translate.ITranslateService, $filter: ng.IFilterService, $timeout: ng.ITimeoutService, $mdDialog: ng.material.IDialogService, container: threema.Container.Factory, trustedKeyStore: TrustedKeyStoreService, stateService: StateService, notificationService: NotificationService, messageService: MessageService, pushService: PushService, browserService: BrowserService, titleService: TitleService, qrCodeService: QrCodeService, mimeService: MimeService, receiverService: ReceiverService, versionService: VersionService, batteryStatusService: BatteryStatusService, CONFIG: threema.Config) { // Angular services this.$log = $log; this.$rootScope = $rootScope; this.$q = $q; this.$state = $state; this.$window = $window; this.$translate = $translate; this.$filter = $filter; this.$timeout = $timeout; this.$mdDialog = $mdDialog; // Own services this.batteryStatusService = batteryStatusService; this.browserService = browserService; this.messageService = messageService; this.mimeService = mimeService; this.notificationService = notificationService; this.pushService = pushService; this.qrCodeService = qrCodeService; this.receiverService = receiverService; this.titleService = titleService; this.versionService = versionService; // Configuration object this.config = CONFIG; // State this.stateService = stateService; // Other properties this.container = container; this.trustedKeyStore = trustedKeyStore; // Initialize drafts this.drafts = this.container.createDrafts(); // Setup fields this._resetFields(); // Register event handlers this.stateService.evtConnectionBuildupStateChange.attach( (stateChange: threema.ConnectionBuildupStateChange) => { if (this.startupPromise !== null) { this.startupPromise.notify(stateChange); } }, ); this.stateService.evtGlobalConnectionStateChange.attach(this.handleGlobalConnectionStateChange.bind(this)); } get me(): threema.MeReceiver { return this.receivers.me; } get contacts(): Map { return this.receivers.contacts; } get groups(): Map { return this.receivers.groups; } get distributionLists(): Map { return this.receivers.distributionLists; } get typing(): threema.Container.Typing { return this.typingInstance; } /** * Return the amount of chunks cached from a previous connection that * require immediate sending. */ get immediateChunksPending(): number { // TODO: Apply the chunk **push** blacklist instead of the chunk cache // blacklist! if (this.previousChunkCache === null) { return 0; } else { return this.previousChunkCache.chunks.length; } } /** * Return the amount of unacknowledged wire messages. */ get unacknowledgedWireMessages(): number { return this.wireMessageFutures.size; } // TODO: Deprecated - remove this attribute and update all references get requiresTemporaryIdBackwardsCompatibility(): boolean { return this.chosenTask !== threema.ChosenTask.RelayedData; } /** * Return QR code payload. */ public buildQrCodePayload(persistent: boolean): string { return this.qrCodeService.buildQrCodePayload( this.salty.permanentKeyBytes, this.salty.authTokenBytes, hexToU8a(this.config.SALTYRTC_SERVER_KEY), this.saltyRtcHost, this.config.SALTYRTC_PORT, persistent); } /** * Initialize the webclient service. * * Warning: Do not call this with `flags.resume` set to `false` in case * messages can be queued by the user. */ public init(flags: { keyStore?: saltyrtc.KeyStore, peerTrustedKey?: Uint8Array, resume: boolean, }): void { let keyStore = flags.keyStore; let resumeSession = flags.resume; this.$log.info(`Initializing (keyStore=${keyStore !== undefined ? 'yes' : 'no'}, peerTrustedKey=` + `${flags.peerTrustedKey !== undefined ? 'yes' : 'no'}, resume=${resumeSession})`); // Reset fields, blob cache & pending requests in case the session // should explicitly not be resumed if (!resumeSession) { this.clearCache(); this.wireMessageFutures.clear(); } // Only move the previous connection's instances if the previous // connection was successful (and if there was one at all). if (resumeSession) { if (this.previousConnectionId) { this.$log.debug(`Trying to resume previous session (id=${u8aToHex(this.previousConnectionId)}, ` + `sn-out=${this.previousChunkCache.sequenceNumber.get()})`); } else { resumeSession = false; this.$log.debug('Wanted to resume previous session but none exists'); } } else { // Discard session this.discardSession({ resetMessageSequenceNumber: true }); resumeSession = false; this.$log.debug('Discarded previous session'); } // Reset handshake completed flag this.handshakeCompleted = false; // Initialise connection caches this.currentConnectionId = null; this.currentIncomingChunkSequenceNumber = new SequenceNumber( 0, WebClientService.SEQUENCE_NUMBER_MIN, WebClientService.SEQUENCE_NUMBER_MAX); const outgoingChunkSequenceNumber = new SequenceNumber( 0, WebClientService.SEQUENCE_NUMBER_MIN, WebClientService.SEQUENCE_NUMBER_MAX); this.currentChunkCache = new ChunkCache(outgoingChunkSequenceNumber); // Reset pending ack request this.pendingAckRequest = null; // Create new handshake future this.connectionInfoFuture = new Future(); // Create WebRTC task instance const maxPacketSize = this.browserService.getBrowser().isFirefox(false) ? 16384 : 65536; this.webrtcTask = new saltyrtcTaskWebrtc.WebRTCTask(true, maxPacketSize, this.config.SALTYRTC_LOG_LEVEL); // Create Relayed Data task instance this.relayedDataTask = new saltyrtcTaskRelayedData.RelayedDataTask(this.config.DEBUG); // Create new keystore if necessary if (!keyStore) { keyStore = new saltyrtcClient.KeyStore(); } // Determine SaltyRTC host if (this.config.SALTYRTC_HOST !== null) { // Static URL this.saltyRtcHost = this.config.SALTYRTC_HOST; } else { // Construct URL using prefix and suffix this.saltyRtcHost = this.config.SALTYRTC_HOST_PREFIX + keyStore.publicKeyHex.substr(0, 2) + this.config.SALTYRTC_HOST_SUFFIX; } // Determine SaltyRTC tasks let tasks; if (this.browserService.supportsWebrtcTask()) { tasks = [this.webrtcTask, this.relayedDataTask]; } else { tasks = [this.relayedDataTask]; } // Create SaltyRTC client let builder = new saltyrtcClient.SaltyRTCBuilder() .connectTo(this.saltyRtcHost, this.config.SALTYRTC_PORT) .withLoggingLevel(this.config.SALTYRTC_LOG_LEVEL) .withServerKey(this.config.SALTYRTC_SERVER_KEY) .withKeyStore(keyStore) .usingTasks(tasks) .withPingInterval(30); if (flags.peerTrustedKey !== undefined) { builder = builder.withTrustedPeerKey(flags.peerTrustedKey); } this.salty = builder.asInitiator(); if (this.config.DEBUG) { this.$log.debug('Public key:', this.salty.permanentKeyHex); this.$log.debug('Auth token:', this.salty.authTokenHex); } // We want to know about new responders. this.salty.on('new-responder', () => { if (!this.startupDone) { // Peer handshake this.stateService.updateConnectionBuildupState('peer_handshake'); } }); // We want to know about state changes this.salty.on('state-change', (ev: saltyrtc.SaltyRTCEvent) => { // Wrap this in a $timeout to execute at the end of the event loop. this.$timeout(() => { const state: saltyrtc.SignalingState = ev.data; if (!this.startupDone) { switch (state) { case 'new': case 'ws-connecting': case 'server-handshake': if (this.stateService.connectionBuildupState !== 'push' && this.stateService.connectionBuildupState !== 'manual_start') { this.stateService.updateConnectionBuildupState('connecting'); } break; case 'peer-handshake': // Waiting for peer if (this.stateService.connectionBuildupState !== 'push' && this.stateService.connectionBuildupState !== 'manual_start') { this.stateService.updateConnectionBuildupState('waiting'); } break; case 'task': // Do nothing, state will be updated once SecureDataChannel is open break; case 'closing': case 'closed': this.stateService.updateConnectionBuildupState('closed'); break; default: this.$log.warn(this.logTag, 'Unknown signaling state:', state); } } this.stateService.updateSignalingConnectionState(state, this.chosenTask); }, 0); }); // Once the connection is established, if this is a WebRTC connection, // initiate the peer connection and start the handover. this.salty.once('state-change:task', () => { // Determine chosen task const task = this.salty.getTask(); if (task.getName().indexOf('webrtc.tasks.saltyrtc.org') !== -1) { this.chosenTask = threema.ChosenTask.WebRTC; } else if (task.getName().indexOf('relayed-data.tasks.saltyrtc.org') !== -1) { this.chosenTask = threema.ChosenTask.RelayedData; } else { throw new Error('Invalid or unknown task name: ' + task.getName()); } // If the WebRTC task was chosen, initialize handover. if (this.chosenTask === threema.ChosenTask.WebRTC) { const browser = this.browserService.getBrowser(); // Firefox <53 does not yet support TLS. Skip it, to save allocations. if (browser.isFirefox(true) && browser.version < 53) { this.skipIceTls(); } // Safari does not support our dual-stack TURN servers. if (browser.isSafari(false)) { this.skipIceDs(); } this.pcHelper = new PeerConnectionHelper(this.$log, this.$q, this.$timeout, this.$rootScope, this.webrtcTask, this.config.ICE_SERVERS, !this.config.ICE_DEBUGGING); // On state changes in the PeerConnectionHelper class, let state service know about it this.pcHelper.onConnectionStateChange = (state: threema.TaskConnectionState) => { this.stateService.updateTaskConnectionState(state); }; // Initiate handover this.webrtcTask.handover(this.pcHelper.peerConnection); // Otherwise, no handover is necessary. } else { this.onHandover(resumeSession); return; } }); // Handle disconnecting of a peer this.salty.on('peer-disconnected', (ev: saltyrtc.SaltyRTCEvent) => { this.$rootScope.$apply(() => { this.onPeerDisconnected(ev.data); }); }); // Wait for handover to be finished this.salty.on('handover', () => { // Ignore handovers requested by non-WebRTC tasks if (this.chosenTask === threema.ChosenTask.WebRTC) { this.$log.debug(this.logTag, 'Handover done'); this.onHandover(resumeSession); } }); // Handle SaltyRTC errors this.salty.on('connection-error', (ev) => { this.$log.error('Connection error:', ev); }); this.salty.on('connection-closed', (ev) => { this.$log.info('Connection closed:', ev); }); this.salty.on('no-shared-task', (ev) => { this.$log.warn('No shared task found:', ev.data); const offeredWebrtc = ev.data.offered.filter((t) => t.endsWith('webrtc.tasks.saltyrtc.org')).length > 0; this.$rootScope.$apply(() => { if (!this.browserService.supportsWebrtcTask() && offeredWebrtc) { this.failSession(false); this.showWebrtcAndroidWarning(); } else { this.failSession(); } }); }); } /** * Show a WebRTC on Android warning dialog. */ private showWebrtcAndroidWarning(): void { this.$translate.onReady().then(() => { const confirm = this.$mdDialog.alert() .title(this.$translate.instant('welcome.BROWSER_NOT_SUPPORTED_ANDROID')) .htmlContent(this.$translate.instant('welcome.BROWSER_NOT_SUPPORTED_DETAILS')) .ok(this.$translate.instant('welcome.ABORT')); this.$mdDialog.show(confirm).then(() => { // Redirect to Threema website window.location.replace('https://threema.ch/threema-web'); }); }); } /** * Show an alert dialog. Can be called directly after calling `.stop(...)`. */ private showAlert(alertMessage: string): void { // Note: A former stop() call above may result in a redirect, which will // in turn hide all open dialog boxes. Therefore, to avoid // immediately hiding the alert box, enqueue dialog at end of // event loop. this.$timeout(() => { this.$mdDialog.show(this.$mdDialog.alert() .title(this.$translate.instant('connection.SESSION_CLOSED_TITLE')) .textContent(this.$translate.instant(alertMessage)) .ok(this.$translate.instant('common.OK'))); }, 0); } /** * Fail the session and let the remote peer know that an error occurred. * A dialog will be displayed to let the user know a protocol error * happened. */ private failSession(showAlert = true) { // Stop session const stop = () => { this.stop({ reason: DisconnectReason.SessionError, send: true, // TODO: Use welcome.error once we have it close: 'welcome', connectionBuildupState: 'closed', }); if (showAlert) { this.showAlert('connection.SESSION_ERROR'); } }; // Note: Although this is considered an anti-pattern, we simply don't // want a digest cycle in most of the network event functionality. // Thus, it would be pointless 99% of the time to apply a digest // cycle somewhere higher in the call stack. if (!this.$rootScope.$$phase) { this.$rootScope.$apply(() => stop()); } else { stop(); } } /** * Fail the session on a rejection of a Promise associated to a message. */ private failSessionOnReject(type: string, subType: string) { return ((error) => { this.logOnReject(type, subType)(error); this.failSession(); }); } /** * Log a rejection of a Promise associated to a message. */ private logOnReject(type: string, subType: string) { return ((error) => { this.$log.error(this.logTag, `Message ${type}/${subType} has been rejected: ${error}`); }); } /** * Resume a session via the previous connection's ID and chunk cache. * * Returns whether the connection has been resumed. * * Important: Caller must invalidate the cache and connection ID after this * function returned! */ private maybeResumeSession(resumeSession: boolean, remoteInfo: ConnectionInfo): boolean { // Validate connection ID const remoteCurrentConnectionId = new Uint8Array(remoteInfo.id); if (arraysAreEqual(fakeConnectionId, remoteCurrentConnectionId)) { this.$log.debug('Cannot resume session: Remote did not implement deriving the connection ID'); // TODO: Remove this once it is implemented properly by the app! return false; } if (!arraysAreEqual(this.currentConnectionId, remoteCurrentConnectionId)) { this.$log.info(`Cannot resume session: IDs of previous connection do not match (local=` + `${u8aToHex(this.currentConnectionId)}, remote=${u8aToHex(remoteCurrentConnectionId)}`); throw new Error('Derived connection IDs do not match!'); } // Ensure both local and remote want to resume a session if (!resumeSession || remoteInfo.resume === undefined) { this.$log.info(this.logTag, `No resumption (local requested: ${resumeSession ? 'yes' : 'no'}, ` + `remote requested: ${remoteInfo.resume ? 'yes' : 'no'})`); // Both sides should detect that -> recoverable return false; } // Ensure we want to resume from the same previous connection const remotePreviousConnectionId = new Uint8Array(remoteInfo.resume.id); if (!arraysAreEqual(this.previousConnectionId, remotePreviousConnectionId)) { // Both sides should detect that -> recoverable this.$log.info(`Cannot resume session: IDs of previous connection do not match (local=` + `${u8aToHex(this.previousConnectionId)}, remote=${u8aToHex(remotePreviousConnectionId)}`); return false; } // Remove chunks that have been received by the remote side const size = this.previousChunkCache.byteLength; let result; this.$log.debug(`Pruning cache (local-sn=${this.previousChunkCache.sequenceNumber.get()}, ` + `remote-sn=${remoteInfo.resume.sequenceNumber})`); try { result = this.previousChunkCache.prune(remoteInfo.resume.sequenceNumber); } catch (error) { // Not recoverable throw new Error(`Unable to resume session: ${error}`); } this.$log.debug(`Chunk cache pruned, acknowledged: ${result.acknowledged}, left: ${result.left}, size: ` + `${size} -> ${this.previousChunkCache.byteLength}`); if (this.config.MSG_DEBUGGING) { this.$log.debug(`Chunks that require acknowledgement: ${this.immediateChunksPending}`); } // Transfer the cache (filters chunks which should not be retransmitted) const transferred = this.currentChunkCache.transfer(this.previousChunkCache.chunks); this.$log.debug(`Chunk cache transferred (${transferred} chunks)`); // Invalidate the previous connection cache & id // Note: This MUST be done immediately after the session has been // resumed to prevent re-establishing a session of a connection // where the handshake has been started but not been completed. this.previousConnectionId = null; this.previousIncomingChunkSequenceNumber = null; this.previousChunkCache = null; // Resend chunks const chunks = this.currentChunkCache.chunks; this.$log.debug(this.logTag, `Sending cached chunks: ${chunks.length}`); for (const chunk of chunks) { this.sendChunk(chunk, true, false, false); } // Resumed! return true; } /** * Discard the session of a previous connection. */ private discardSession(flags: { resetMessageSequenceNumber: boolean }): void { // Reset the outgoing message sequence number and the unchunker if (flags.resetMessageSequenceNumber) { this.outgoingMessageSequenceNumber = new SequenceNumber( 0, WebClientService.SEQUENCE_NUMBER_MIN, WebClientService.SEQUENCE_NUMBER_MAX); } this.unchunker = new chunkedDc.Unchunker(); this.unchunker.onMessage = this.handleIncomingMessageBytes.bind(this); // Discard previous connection instances this.previousConnectionId = null; this.previousIncomingChunkSequenceNumber = null; this.previousChunkCache = null; } /** * Schedule the connection ack to be sent. * * By default, a connection ack message will be sent after 10 seconds * (as defined by the protocol). */ private scheduleConnectionAck(timeout: number = 10000): void { // Don't schedule if already running if (this.ackTimer === null) { this.ackTimer = self.setTimeout(() => { this.ackTimer = null; this._sendConnectionAck(); }, timeout); } } /** * For the WebRTC task, this is called when the DataChannel is open. * For the relayed data task, this is called once the connection is established. */ private async onConnectionEstablished(resumeSession: boolean) { // Send connection info if (resumeSession) { const incomingSequenceNumber = this.previousIncomingChunkSequenceNumber.get(); this.$log.debug(this.logTag, `Sending connection info (resume=yes, sn-in=${incomingSequenceNumber})`); this._sendConnectionInfo( this.currentConnectionId.buffer, this.previousConnectionId.buffer, incomingSequenceNumber, ); } else { this.$log.debug(this.logTag, 'Sending connection info (resume=no)'); this._sendConnectionInfo(this.currentConnectionId.buffer); } // Receive connection info // Note: We can receive the connectionInfo message here or // an error which should fail the session. let remoteInfo: ConnectionInfo; try { remoteInfo = await this.connectionInfoFuture; } catch (error) { this.$log.error(this.logTag, error); this.failSession(); return; } let outgoingSequenceNumber: string | number = 'n/a'; let remoteResume = 'no'; if (remoteInfo.resume !== undefined) { outgoingSequenceNumber = remoteInfo.resume.sequenceNumber; remoteResume = 'yes'; } this.$log.debug(this.logTag, `Received connection info (resume=${remoteResume}, ` + `sn-out=${outgoingSequenceNumber})`); // Resume the session (if both requested to resume the same connection) let sessionWasResumed; try { sessionWasResumed = this.maybeResumeSession(resumeSession, remoteInfo); } catch (error) { this.$log.error(this.logTag, error); this.failSession(); return; } // Handshake complete! this.handshakeCompleted = true; // If we could not resume for whatever reason const requiredInitializationSteps = []; if (!resumeSession || !sessionWasResumed) { // Note: We cannot reset the message sequence number here any more since // it has already been used for the connectionInfo message. this.discardSession({ resetMessageSequenceNumber: false }); this.$log.debug(this.logTag, 'Session discarded'); // Reset fields, blob cache & pending requests in case the session // cannot be resumed this.clearCache(); this.wireMessageFutures.clear(); // Set required initialisation steps requiredInitializationSteps.push( InitializationStep.ClientInfo, InitializationStep.Conversations, InitializationStep.Receivers, InitializationStep.Profile, ); // Request initial data this._requestInitialData(); } else { this.$log.debug(this.logTag, 'Session resumed'); } // Schedule required initialisation steps if we have finished the // previous connection if (this.startupPromise !== null) { this.runAfterInitializationSteps(requiredInitializationSteps, () => { this.stateService.updateConnectionBuildupState('done'); this.startupPromise.resolve(); this.startupPromise = null; this.startupDone = true; this._resetInitializationSteps(); }); } // In case... // - we wanted to resume, but // - we could not resume, and // - we had a previous connection if (resumeSession && !sessionWasResumed && this.clientInfo !== null) { this.$rootScope.$apply(() => { // TODO: Remove this conditional once we have session // resumption for Android! if (this.chosenTask !== threema.ChosenTask.RelayedData) { return; } // Redirect to the conversation overview if (this.$state.includes('messenger')) { this.$state.go('messenger.home'); } }); } // Fetch current version // Delay it to prevent the dialog from being closed by the messenger constructor, // which closes all open dialogs. this.$timeout(() => this.versionService.checkForUpdate(), 7000); // Notify state service about data loading this.stateService.updateConnectionBuildupState('loading'); } /** * Handover done. * * This can either be a real handover to WebRTC (Android), or simply * when the relayed data task takes over (iOS). */ private onHandover(resumeSession: boolean) { // Initialize NotificationService this.$log.debug(this.logTag, 'Initializing NotificationService...'); this.notificationService.init(); // Derive connection ID // Note: We need to make sure this is done before any ARP messages can be received const box = this.salty.encryptForPeer(new Uint8Array(0), WebClientService.CONNECTION_ID_NONCE); // Note: We explicitly copy the data here to be able to use the underlying buffer directly this.currentConnectionId = new Uint8Array(box.data); // If the WebRTC task was chosen, initialize the data channel if (this.chosenTask === threema.ChosenTask.WebRTC) { // Create secure data channel this.$log.debug(this.logTag, 'Create SecureDataChannel "' + WebClientService.DC_LABEL + '"...'); this.secureDataChannel = this.pcHelper.createSecureDataChannel(WebClientService.DC_LABEL); this.secureDataChannel.onopen = () => { this.$log.debug(this.logTag, 'SecureDataChannel open'); this.onConnectionEstablished(resumeSession).catch((error) => { this.$log.error(this.logTag, 'Error during handshake:', error); }); }; // Handle incoming messages this.secureDataChannel.onmessage = (ev: MessageEvent) => { const bytes = new Uint8Array(ev.data); this.handleIncomingMessageBytes(bytes); }; this.secureDataChannel.onbufferedamountlow = (ev: Event) => { this.$log.debug('Secure data channel: Buffered amount low'); }; this.secureDataChannel.onerror = (e: ErrorEvent) => { this.$log.warn('Secure data channel: Error:', e.message); this.$log.debug(e); }; this.secureDataChannel.onclose = (ev: Event) => { this.$log.warn('Secure data channel: Closed'); }; } else if (this.chosenTask === threema.ChosenTask.RelayedData) { // Handle messages directly this.relayedDataTask.on('data', (ev: saltyrtc.SaltyRTCEvent) => { this.receiveChunk(new Uint8Array(ev.data)); }); // The communication channel is now open! Fetch initial data this.onConnectionEstablished(resumeSession).catch((error) => { this.$log.error(this.logTag, 'Error during handshake:', error); }); } } /** * A previously authenticated peer disconnected from the server. */ private onPeerDisconnected(peerId: number) { switch (this.chosenTask) { case threema.ChosenTask.RelayedData: // TODO: Fix "Ignoring peer-disconnected event (state is new)" if (this.stateService.taskConnectionState === threema.TaskConnectionState.Connected) { this.stateService.updateTaskConnectionState(threema.TaskConnectionState.Reconnecting); } else { this.$log.debug( this.logTag, 'Ignoring peer-disconnected event (state is ' + this.stateService.taskConnectionState + ')', ); } break; default: this.$log.debug( this.logTag, 'Ignoring peer-disconnected event (chosen task is ' + this.chosenTask + ')', ); } } /** * Send a push message to wake up the peer. * The push message will only be sent if the last push is less than 2 seconds ago. */ private sendPush(): void { // Make sure not to flood the target device with pushes const minPushInterval = 2000; const now = new Date(); if (this.lastPush !== null && (now.getTime() - this.lastPush.getTime()) < minPushInterval) { this.$log.debug(this.logTag, 'Skipping push, last push was requested less than ' + (minPushInterval / 1000) + 's ago'); return; } this.lastPush = now; // Actually send the push notification this.pushService.sendPush(this.salty.permanentKeyBytes) .catch(() => this.$log.warn(this.logTag, 'Could not notify app!')) .then(() => { this.$log.debug(this.logTag, 'Requested app wakeup via', this.pushTokenType, 'push'); this.$rootScope.$apply(() => { this.stateService.updateConnectionBuildupState('push'); }); }); } /** * Start the webclient service. * Return a promise that resolves once connected. */ public start(skipPush: boolean = false): ng.IPromise { this.$log.debug(this.logTag, 'Starting WebClientService...'); // Promise to track startup state if (this.startupPromise !== null) { this.$log.debug(this.logTag, 'Reusing startup promise (was not resolved)'); } else { this.$log.debug(this.logTag, 'Creating new startup promise'); this.startupPromise = this.$q.defer(); } this.startupDone = false; // Connect this.salty.connect(); // If push service is available, notify app if (skipPush === true) { this.$log.debug(this.logTag, 'start(): Skipping push notification'); } else if (this.pushService.isAvailable()) { this.sendPush(); } else if (this.trustedKeyStore.hasTrustedKey()) { this.$log.debug(this.logTag, 'Push service not available'); this.stateService.updateConnectionBuildupState('manual_start'); } return this.startupPromise.promise; } /** * Stop the webclient service. * * This is a forced stop, meaning that all connections are being closed. * * @reason The disconnect reason. * @send will send a disconnect message to the remote peer containing the * disconnect reason if set to `true`. * @close will close the session (meaning all cached data will be * invalidated) if set to `true`. Note that the session will always be * closed in case `reason` indicates that the session is to be deleted, * has been replaced, a protocol error occurred or in case `redirect` has * been set to `true`. * @redirect will redirect to the welcome page if set to `true`. * @connectionBuildupState: The connection buildup state the state service * will be reset to. */ public stop(args: threema.WebClientServiceStopArguments): void { if (args.close === true) { throw new Error('args.close has been set to "true" but requires a redirect state instead'); } this.$log.info(this.logTag, `Stopping (reason=${args.reason}, send=${args.send}, close=${args.close}, ` + 'connectionBuildupState=' + `${args.connectionBuildupState !== undefined ? args.connectionBuildupState : 'n/a'})`); let close = args.close !== false; let remove = false; // Session deleted: Force close and delete if (args.reason === DisconnectReason.SessionDeleted) { close = true; remove = true; } // Session replaced or error'ed: Force close if (args.reason === DisconnectReason.SessionReplaced || args.reason === DisconnectReason.SessionError) { close = true; } // Send disconnect reason to the remote peer if requested if (args.send && this.stateService.state === threema.GlobalConnectionState.Ok) { // noinspection JSIgnoredPromiseFromCall this.sendUpdateWireMessage(WebClientService.SUB_TYPE_CONNECTION_DISCONNECT, false, undefined, {reason: args.reason}); } // Stop ack timer if (this.ackTimer !== null) { self.clearTimeout(this.ackTimer); this.ackTimer = null; } // Reset states this.stateService.reset(args.connectionBuildupState); // Reset the unread count this.resetUnreadCount(); // Clear stored data (trusted key, push token, etc) if deleting the session if (remove) { this.trustedKeyStore.clearTrustedKey(); } // Invalidate and clear caches if (close) { // Clear connection ids & caches this.previousConnectionId = null; this.previousIncomingChunkSequenceNumber = null; this.previousChunkCache = null; // Reset general client information this.clientInfo = null; // Clear fetched messages and the blob cache this.clearCache(); // Remove all pending promises this.wireMessageFutures.clear(); // Reset the push service this.pushService.reset(); // Closed! this.$log.debug(this.logTag, 'Session closed (cannot be resumed)'); } else { // Only reuse a previous chunk cache if the handshake had been // completed if (this.handshakeCompleted) { // Move instances that we need to re-establish a previous session this.previousConnectionId = this.currentConnectionId; this.previousIncomingChunkSequenceNumber = this.currentIncomingChunkSequenceNumber; this.previousChunkCache = this.currentChunkCache; } this.$log.debug(this.logTag, 'Session remains open'); } // Close data channel if (this.secureDataChannel !== null) { this.$log.debug(this.logTag, 'Closing secure datachannel'); this.secureDataChannel.onopen = null; this.secureDataChannel.onmessage = null; this.secureDataChannel.onbufferedamountlow = null; this.secureDataChannel.onerror = null; this.secureDataChannel.onclose = null; this.secureDataChannel.close(); } // Close SaltyRTC connection if (this.relayedDataTask !== null) { this.relayedDataTask.off(); } if (this.salty !== null) { this.$log.debug(this.logTag, 'Closing signaling'); this.salty.off(); this.salty.disconnect(true); } // Close peer connection if (this.pcHelper !== null) { this.pcHelper.onConnectionStateChange = null; this.pcHelper.close(); this.$log.debug(this.logTag, 'Peer connection closed'); } else { this.$log.debug(this.logTag, 'Peer connection was null'); } // Done, redirect now if session closed if (close) { // Translate close flag const state = args.close !== false ? args.close : 'welcome'; this.$state.go(state); } } /** * Remove "turns:" servers from the ICE_SERVERS configuration * if at least one "turn:" server with tcp transport is in the list. */ public skipIceTls(): void { this.$log.debug(this.logTag, 'Requested to remove TURNS server from ICE configuration'); const allUrls = [].concat(...this.config.ICE_SERVERS.map((conf) => conf.urls)); if (allUrls.some((url) => url.startsWith('turn:') && url.endsWith('=tcp'))) { // There's at least one TURN server with TCP transport in the list for (const server of this.config.ICE_SERVERS) { // Remove TLS entries server.urls = server.urls.filter((url) => !url.startsWith('turns:')); } } else { this.$log.debug(this.logTag, 'No fallback TURN TCP server present, keeping TURNS server'); } } /** * Safari has issues with dual-stack TURN servers: * https://bugs.webkit.org/show_bug.cgi?id=173307#c13 * As a workaround, replace ds-turn.threema.ch servers * in the ICE_SERVERS configuration with turn.threema.ch. */ public skipIceDs(): void { this.$log.debug(this.logTag, 'Requested to replace DS servers in ICE configuration'); const allUrls = [].concat(...this.config.ICE_SERVERS.map((conf) => conf.urls)); if (allUrls.some((url) => url.includes('ds-turn.threema.ch'))) { for (const server of this.config.ICE_SERVERS) { // Replace dual stack entries server.urls = server.urls.map((url) => { return url.replace('ds-turn.threema.ch', 'turn.threema.ch'); }); } } else { this.$log.debug(this.logTag, 'No ds-turn ICE server present'); } } /** * Mark a component as initialized */ public registerInitializationStep(name: threema.InitializationStep) { if (this.initialized.has(name) ) { this.$log.warn(this.logTag, 'Initialization step "' + name + '" already registered'); return; } this.$log.debug(this.logTag, 'Initialization step "' + name + '" done'); this.initialized.add(name); // Check pending routines for (const routine of this.pendingInitializationStepRoutines) { const ready = routine.requiredSteps.every((requiredStep) => { return this.initialized.has(requiredStep); }); if (ready) { this.$log.debug(this.logTag, 'Running routine after initialization "' + name + '" completed'); // Important: Remove the routine BEFORE calling it to prevent // it from being called more than once (due to nested // calls to .registerInitializationStep). this.pendingInitializationStepRoutines.delete(routine); routine.callback.apply(this); } } } public setReceiverListener(listener: threema.ReceiverListener): void { this.receiverListener.push(listener); } /** * Send a connection info update. */ private _sendConnectionInfo(connectionId: ArrayBuffer, resumeId?: ArrayBuffer, sequenceNumber?: number): void { const data = {id: connectionId}; if (resumeId !== undefined && sequenceNumber !== undefined) { (data as any).resume = { id: resumeId, sequenceNumber: sequenceNumber, }; } // noinspection JSIgnoredPromiseFromCall this.sendUpdateWireMessage(WebClientService.SUB_TYPE_CONNECTION_INFO, false, undefined, data); } /** * Request a connection ack update. */ private _requestConnectionAck(): void { // noinspection JSIgnoredPromiseFromCall this.sendRequestWireMessage(WebClientService.SUB_TYPE_CONNECTION_ACK, false); } /** * Send a connection ack update. */ private _sendConnectionAck(): void { // Send the current incoming sequence number for chunks // noinspection JSIgnoredPromiseFromCall this.sendUpdateWireMessage(WebClientService.SUB_TYPE_CONNECTION_ACK, false, undefined, { sequenceNumber: this.currentIncomingChunkSequenceNumber.get(), }); // Clear pending ack timer (if any) if (this.ackTimer !== null) { self.clearTimeout(this.ackTimer); this.ackTimer = null; } } /** * Send a client info request. */ public requestClientInfo(): void { this.$log.debug('Sending client info request'); const browser = this.browserService.getBrowser(); const data: object = { [WebClientService.ARGUMENT_USER_AGENT]: navigator.userAgent, }; if (browser.name) { data[WebClientService.ARGUMENT_BROWSER_NAME] = browser.name; } if (browser.version) { data[WebClientService.ARGUMENT_BROWSER_VERSION] = browser.version; } const subType = WebClientService.SUB_TYPE_CLIENT_INFO; this.sendRequestWireMessage(subType, !this.requiresTemporaryIdBackwardsCompatibility, undefined, data) .catch(this.failSessionOnReject(WebClientService.TYPE_REQUEST, subType)); // critical request } /** * Send a receivers request. */ public requestReceivers(): void { this.$log.debug('Sending receivers request'); const subType = WebClientService.SUB_TYPE_RECEIVERS; this.sendRequestWireMessage(subType, !this.requiresTemporaryIdBackwardsCompatibility) .catch(this.failSessionOnReject(WebClientService.TYPE_REQUEST, subType)); // critical request } /** * Send a conversation request. */ public requestConversations(): void { this.$log.debug('Sending conversation request'); const subType = WebClientService.SUB_TYPE_CONVERSATIONS; const args = {[WebClientService.ARGUMENT_MAX_SIZE]: WebClientService.AVATAR_LOW_MAX_SIZE}; this.sendRequestWireMessage(subType, !this.requiresTemporaryIdBackwardsCompatibility, args) .catch(this.failSessionOnReject(WebClientService.TYPE_REQUEST, subType)); // critical request } /** * Send a battery status request. */ public requestBatteryStatus(): void { this.$log.debug('Sending battery status request'); const subType = WebClientService.SUB_TYPE_BATTERY_STATUS; this.sendRequestWireMessage(subType, !this.requiresTemporaryIdBackwardsCompatibility) .catch(this.failSessionOnReject(WebClientService.TYPE_REQUEST, subType)); // critical request } /** * Send a profile request. */ public requestProfile(): void { this.$log.debug('Sending profile request'); const subType = WebClientService.SUB_TYPE_PROFILE; this.sendRequestWireMessage(subType, !this.requiresTemporaryIdBackwardsCompatibility) .catch(this.failSessionOnReject(WebClientService.TYPE_REQUEST, subType)); // critical request } /** * Send a message request for the specified receiver. * * This method will only be called when initializing a conversation in the * webclient. It is used to download all existing messages. * * New messages are not requested this way, instead they are sent as a * message update. */ public requestMessages(receiver: threema.Receiver): string | null { this.$log.debug(this.logTag, 'requestMessages'); // If there are no more messages available, stop here. if (!this.messages.hasMore(receiver)) { this.messages.notify(receiver, this.$rootScope); this.$log.debug(this.logTag, 'requestMessages: No more messages available'); return null; } this.loadingMessages.set(receiver.type + receiver.id, true); // Check if messages have already been requested if (this.messages.isRequested(receiver)) { this.$log.debug(this.logTag, 'requestMessages: Already requested'); return null; } // Get the reference msg id const refMsgId = this.messages.getReferenceMsgId(receiver); // Set requested this.messages.setRequested(receiver); // Create arguments const args = { [WebClientService.ARGUMENT_RECEIVER_TYPE]: receiver.type, [WebClientService.ARGUMENT_RECEIVER_ID]: receiver.id, } as any; // If a reference msg id has been set, send it along const msgId = this.messages.getReferenceMsgId(receiver); if (msgId !== null) { args[WebClientService.ARGUMENT_REFERENCE_MSG_ID] = msgId; } // Send request this.$log.debug('Sending message request for', receiver.type, receiver.id, 'with message id', msgId); const subType = WebClientService.SUB_TYPE_MESSAGES; // TODO: Return the promise instead to unset the 'requested' flag? this.sendRequestWireMessage(subType, !this.requiresTemporaryIdBackwardsCompatibility, args) .catch(this.logOnReject(WebClientService.TYPE_REQUEST, subType)); return refMsgId; } /** * Send an avatar request for the specified receiver. */ public requestAvatar(receiver: threema.Receiver, highResolution: boolean): Promise { // Check if the receiver has an avatar or the avatar already exists const resolution = highResolution ? 'high' : 'low'; const receiverInfo = this.receivers.getData(receiver); if (receiverInfo && receiverInfo.avatar && receiverInfo.avatar[resolution]) { // Avatar already exists // TODO: Do we get avatar changes via update? return Promise.resolve(receiverInfo.avatar[resolution]); } // If we're requesting our own avatar, change type from "me" to "contact" let receiverType = receiver.type; if (receiverType === 'me') { receiverType = 'contact'; } // Create arguments and send request const args = { [WebClientService.ARGUMENT_RECEIVER_TYPE]: receiverType, [WebClientService.ARGUMENT_RECEIVER_ID]: receiver.id, [WebClientService.ARGUMENT_AVATAR_HIGH_RESOLUTION]: highResolution, } as any; if (!highResolution) { args[WebClientService.ARGUMENT_MAX_SIZE] = WebClientService.AVATAR_LOW_MAX_SIZE; } this.$log.debug('Sending', resolution, 'res avatar request for', receiver.type, receiver.id); const subType = WebClientService.SUB_TYPE_AVATAR; return this.sendRequestWireMessage(subType, true, args); } /** * Send a thumbnail request for the specified receiver. */ public requestThumbnail(receiver: threema.Receiver, message: threema.Message): Promise { // Check if the receiver has an avatar or the avatar already exists if (message.thumbnail !== undefined && message.thumbnail.img !== undefined) { return new Promise((e) => { e(message.thumbnail.img); }); } // Create arguments and send request const args = { [WebClientService.ARGUMENT_MESSAGE_ID]: message.id.toString(), [WebClientService.ARGUMENT_RECEIVER_TYPE]: receiver.type, [WebClientService.ARGUMENT_RECEIVER_ID]: receiver.id, }; this.$log.debug('Sending thumbnail request for', receiver.type, message.id); const subType = WebClientService.SUB_TYPE_THUMBNAIL; return this.sendRequestWireMessage(subType, true, args); } /** * Request a blob. */ public requestBlob(msgId: string, receiver: threema.Receiver): Promise { const cached = this.blobCache.get(msgId + receiver.type); if (cached !== undefined) { this.$log.debug(this.logTag, 'Use cached blob'); return new Promise((resolve) => { resolve(cached); }); } const args = { [WebClientService.ARGUMENT_RECEIVER_TYPE]: receiver.type, [WebClientService.ARGUMENT_RECEIVER_ID]: receiver.id, [WebClientService.ARGUMENT_MESSAGE_ID]: msgId, }; this.$log.debug('Sending blob request for message', msgId); return this.sendRequestWireMessage(WebClientService.SUB_TYPE_BLOB, true, args); } /** * Mark a message as read. */ public requestRead(receiver, newestMessage: threema.Message): void { if (newestMessage.id === undefined) { // Message that hasn't been sent yet this.$log.warn(this.logTag, 'Called requestRead on a message without id'); return; } if (newestMessage.type === 'status') { this.$log.warn(this.logTag, 'Called requestRead on a status message'); return; } // Create arguments and send request const args = { [WebClientService.ARGUMENT_RECEIVER_TYPE]: receiver.type, [WebClientService.ARGUMENT_RECEIVER_ID]: receiver.id, [WebClientService.ARGUMENT_MESSAGE_ID]: newestMessage.id.toString(), }; this.$log.debug('Sending read request for', receiver.type, receiver.id, '(msg ' + newestMessage.id + ')'); const subType = WebClientService.SUB_TYPE_READ; this.sendRequestWireMessage(subType, !this.requiresTemporaryIdBackwardsCompatibility, args) .catch(this.logOnReject(WebClientService.TYPE_REQUEST, subType)); } public requestContactDetail(contactReceiver: threema.ContactReceiver): Promise { const args = { [WebClientService.ARGUMENT_IDENTITY]: contactReceiver.id, }; return this.sendRequestWireMessage(WebClientService.SUB_TYPE_CONTACT_DETAIL, true, args); } /** * Send a message to the specified receiver. */ public sendMessage( receiver, type: threema.MessageContentType, message: threema.MessageData, ): Promise { return new Promise ( (resolve, reject) => { // Try to load receiver object const receiverObject = this.receivers.getData(receiver); // Check blocked flag if (isContactReceiver(receiverObject) && receiverObject.isBlocked) { return reject(this.$translate.instant('error.CONTACT_BLOCKED')); } // Decide on subtype let subType; switch (type) { case 'text': subType = WebClientService.SUB_TYPE_TEXT_MESSAGE; const textMessage = message as threema.TextMessageData; const msgLength = textMessage.text.length; // Ignore empty text messages if (msgLength === 0) { return reject(); } // Ignore text messages that are too long. if (msgLength > WebClientService.MAX_TEXT_LENGTH) { return reject(this.$translate.instant('error.TEXT_TOO_LONG', { max: WebClientService.MAX_TEXT_LENGTH, })); } break; case 'file': // Validate max file size if (this.chosenTask === threema.ChosenTask.WebRTC) { if ((message as threema.FileMessageData).size > WebClientService.MAX_FILE_SIZE_WEBRTC) { return reject(this.$translate.instant('error.FILE_TOO_LARGE_WEB')); } } else { if ((message as threema.FileMessageData).size > this.clientInfo.capabilities.maxFileSize) { return reject(this.$translate.instant('error.FILE_TOO_LARGE', { maxmb: Math.floor(this.clientInfo.capabilities.maxFileSize / 1024 / 1024), })); } } // Determine required feature mask let requiredFeature: ContactReceiverFeature = ContactReceiverFeature.FILE; let invalidFeatureMessage = 'error.FILE_MESSAGES_NOT_SUPPORTED'; if ((message as threema.FileMessageData).sendAsFile !== true) { // check mime type const mime = (message as threema.FileMessageData).fileType; if (this.mimeService.isAudio(mime)) { requiredFeature = ContactReceiverFeature.AUDIO; invalidFeatureMessage = 'error.AUDIO_MESSAGES_NOT_SUPPORTED'; } else if (this.mimeService.isImage(mime) || this.mimeService.isVideo(mime)) { requiredFeature = ContactReceiverFeature.AUDIO; invalidFeatureMessage = 'error.MESSAGE_NOT_SUPPORTED'; } } subType = WebClientService.SUB_TYPE_FILE_MESSAGE; // check receiver switch (receiver.type) { case 'distributionList': return reject(this.$translate.instant(invalidFeatureMessage, { receiverName: receiver.displayName})); case 'group': const unsupportedMembers = []; const group = this.groups.get(receiver.id); if (group === undefined) { return reject(); } group.members.forEach((identity: string) => { if (identity !== this.me.id) { // tslint:disable-next-line: no-shadowed-variable const contact = this.contacts.get(identity); if (contact === undefined || !hasFeature(contact, requiredFeature, this.$log)) { unsupportedMembers.push(contact.displayName); } } }); if (unsupportedMembers.length > 0) { return reject(this.$translate.instant(invalidFeatureMessage, { receiverName: unsupportedMembers.join(',')})); } break; case 'contact': const contact = this.contacts.get(receiver.id); if (contact === undefined) { this.$log.error('Cannot retrieve contact'); return reject(this.$translate.instant('error.ERROR_OCCURRED')); } else if (!hasFeature(contact, requiredFeature, this.$log)) { this.$log.debug('Cannot send message: Feature level mismatch:', contact.featureMask, 'does not include', requiredFeature); return reject(this.$translate.instant(invalidFeatureMessage, { receiverName: contact.displayName})); } break; default: return reject(); } break; default: this.$log.warn('Invalid message type:', type); return reject(); } const id = this.createRandomWireMessageId(); const temporaryMessage = this.messageService.createTemporary(id, receiver, type, message); this.messages.addNewer(receiver, [temporaryMessage]); const args = { [WebClientService.ARGUMENT_RECEIVER_TYPE]: receiver.type, [WebClientService.ARGUMENT_RECEIVER_ID]: receiver.id, }; // Send message this.sendCreateWireMessage(subType, true, args, message, id) .catch((error) => { this.$log.error('Error sending message:', error); // Remove temporary message this.messages.removeTemporary(receiver, temporaryMessage.temporaryId); // Determine error message let errorMessage; switch (error) { case 'file_too_large': // TODO: deprecated case 'fileTooLarge': errorMessage = this.$translate.instant('error.FILE_TOO_LARGE_GENERIC'); break; case 'blocked': errorMessage = this.$translate.instant('error.CONTACT_BLOCKED'); break; default: errorMessage = this.$translate.instant('error.ERROR_OCCURRED'); } // Show alert this.alerts.push({ source: 'sendMessage', type: 'alert', message: errorMessage, } as threema.Alert); }); resolve(); }); } /** * Send a message a ack/decline message */ public ackMessage(receiver, message: threema.Message, acknowledged: boolean = true): void { // Ignore empty text messages // TODO check into a util class if (message === null || message === undefined || message.isOutbox) { return; } const args = { [WebClientService.ARGUMENT_RECEIVER_TYPE]: receiver.type, [WebClientService.ARGUMENT_RECEIVER_ID]: receiver.id, [WebClientService.ARGUMENT_MESSAGE_ID]: message.id.toString(), [WebClientService.ARGUMENT_MESSAGE_ACKNOWLEDGED]: acknowledged, }; const subType = WebClientService.SUB_TYPE_ACK; this.sendRequestWireMessage(subType, !this.requiresTemporaryIdBackwardsCompatibility, args) .catch(this.logOnReject(WebClientService.TYPE_REQUEST, subType)); } /** * Delete a message. */ public deleteMessage(receiver, message: threema.Message): void { // Ignore empty text messages if (message === null || message === undefined) { return; } const args = { [WebClientService.ARGUMENT_RECEIVER_TYPE]: receiver.type, [WebClientService.ARGUMENT_RECEIVER_ID]: receiver.id, [WebClientService.ARGUMENT_MESSAGE_ID]: message.id.toString(), }; const subType = WebClientService.SUB_TYPE_MESSAGE; // TODO: ARP defines error codes but they aren't handled by the caller this.sendDeleteWireMessage(subType, true, args) .catch(this.logOnReject(WebClientService.TYPE_DELETE, subType)); } public sendMeIsTyping(receiver: threema.ContactReceiver, isTyping: boolean): void { const args = {[WebClientService.ARGUMENT_RECEIVER_ID]: receiver.id}; const data = {[WebClientService.ARGUMENT_IS_TYPING]: isTyping}; // noinspection JSIgnoredPromiseFromCall this.sendUpdateWireMessage(WebClientService.SUB_TYPE_TYPING, false, args, data); } public sendKeyPersisted(): void { const subType = WebClientService.SUB_TYPE_KEY_PERSISTED; this.sendRequestWireMessage(subType, !this.requiresTemporaryIdBackwardsCompatibility) .catch(this.logOnReject(WebClientService.TYPE_REQUEST, subType)); } /** * Add a contact receiver. */ public addContact(threemaId: string): Promise { const data = { [WebClientService.ARGUMENT_IDENTITY]: threemaId, }; const subType = WebClientService.SUB_TYPE_CONTACT; return this.sendCreateWireMessage(subType, true, undefined, data); } /** * Modify a contact name or an avatar */ public modifyContact( threemaId: string, firstName?: string, lastName?: string, avatar?: ArrayBuffer, ): Promise { // Prepare payload data const data = {}; if (firstName !== undefined) { data[WebClientService.ARGUMENT_FIRST_NAME] = firstName; } if (lastName !== undefined) { data[WebClientService.ARGUMENT_LAST_NAME] = lastName; } if (avatar !== undefined) { data[WebClientService.ARGUMENT_AVATAR] = avatar; } // Get contact const contact: threema.ContactReceiver = this.contacts.get(threemaId); // If no changes happened, resolve the promise immediately. if (Object.keys(data).length === 0) { this.$log.warn(this.logTag, 'Trying to modify contact without any changes'); return Promise.resolve(contact); } // Send update const args = { [WebClientService.ARGUMENT_IDENTITY]: threemaId, }; const subType = WebClientService.SUB_TYPE_CONTACT; const promise = this.sendUpdateWireMessage(subType, true, args, data); // If necessary, force an avatar reload if (avatar !== undefined) { this.contacts.get(threemaId).avatar = {}; // noinspection JSIgnoredPromiseFromCall this.requestAvatar(contact, false); } return promise; } /* * Modify a conversation. */ public modifyConversation(conversation: threema.Conversation, isPinned?: boolean): Promise { const DATA_STARRED = 'isStarred'; // Prepare payload data const args = { [WebClientService.ARGUMENT_RECEIVER_TYPE]: conversation.type, [WebClientService.ARGUMENT_RECEIVER_ID]: conversation.id, }; const data = {}; if (hasValue(isPinned)) { data[DATA_STARRED] = isPinned; } // If no changes happened, resolve the promise immediately. if (Object.keys(data).length === 0) { this.$log.warn(this.logTag, 'Trying to modify conversation without any changes'); return Promise.resolve(null); } // Send update const subType = WebClientService.SUB_TYPE_CONVERSATION; return this.sendUpdateWireMessage(subType, true, args, data); } /** * Create a group receiver. */ public createGroup( members: string[], name: string = null, avatar?: ArrayBuffer, ): Promise { const data = { [WebClientService.ARGUMENT_MEMBERS]: members, [WebClientService.ARGUMENT_NAME]: name, } as object; if (avatar !== undefined) { data[WebClientService.ARGUMENT_AVATAR] = avatar; } const subType = WebClientService.SUB_TYPE_GROUP; return this.sendCreateWireMessage(subType, true, undefined, data); } /** * Modify a group receiver. */ public modifyGroup( id: string, members: string[], name?: string, avatar?: ArrayBuffer, ): Promise { // Prepare payload data const data = { [WebClientService.ARGUMENT_MEMBERS]: members, } as object; if (name !== undefined) { data[WebClientService.ARGUMENT_NAME] = name; } if (avatar !== undefined) { data[WebClientService.ARGUMENT_AVATAR] = avatar; } // Send update const args = { [WebClientService.ARGUMENT_RECEIVER_ID]: id, }; const subType = WebClientService.SUB_TYPE_GROUP; const promise = this.sendUpdateWireMessage(subType, true, args, data); // If necessary, reset avatar to force a avatar reload if (avatar !== undefined) { this.groups.get(id).avatar = {}; } return promise; } public leaveGroup(group: threema.GroupReceiver): Promise { if (group === null || group === undefined || !group.access.canLeave) { // TODO: Not a valid error code (see ARP) return Promise.reject('not allowed'); } const args = { [WebClientService.ARGUMENT_RECEIVER_ID]: group.id, [WebClientService.ARGUMENT_DELETE_TYPE]: WebClientService.DELETE_GROUP_TYPE_LEAVE, }; const subType = WebClientService.SUB_TYPE_GROUP; return this.sendDeleteWireMessage(subType, true, args); } public deleteGroup(group: threema.GroupReceiver): Promise { if (group === null || group === undefined || !group.access.canDelete) { // TODO: Not a valid error code (see ARP) return Promise.reject('not allowed'); } const args = { [WebClientService.ARGUMENT_RECEIVER_ID]: group.id, [WebClientService.ARGUMENT_DELETE_TYPE]: WebClientService.DELETE_GROUP_TYPE_DELETE, }; const subType = WebClientService.SUB_TYPE_GROUP; return this.sendDeleteWireMessage(subType, true, args); } /** * Force-sync a group. */ public syncGroup(group: threema.GroupReceiver): Promise { if (group === null || group === undefined || !group.access.canSync) { // TODO: Not a valid error code (see ARP) return Promise.reject('not allowed'); } const args = { [WebClientService.ARGUMENT_RECEIVER_ID]: group.id, }; const subType = WebClientService.SUB_TYPE_GROUP_SYNC; return this.sendRequestWireMessage(subType, true, args); } /** * Create a new distribution list receiver. */ public createDistributionList( members: string[], name: string = null, ): Promise { const data = { [WebClientService.ARGUMENT_MEMBERS]: members, [WebClientService.ARGUMENT_NAME]: name, }; const subType = WebClientService.SUB_TYPE_DISTRIBUTION_LIST; return this.sendCreateWireMessage(subType, true, undefined, data); } public modifyDistributionList( id: string, members: string[], name: string = null, ): Promise { const args = { [WebClientService.ARGUMENT_RECEIVER_ID]: id, }; const data = { [WebClientService.ARGUMENT_MEMBERS]: members, [WebClientService.ARGUMENT_NAME]: name, } as any; const subType = WebClientService.SUB_TYPE_DISTRIBUTION_LIST; return this.sendUpdateWireMessage(subType, true, args, data); } public deleteDistributionList(distributionList: threema.DistributionListReceiver): Promise { if (distributionList === null || distributionList === undefined || !distributionList.access.canDelete) { // TODO: Not a valid error code (see ARP) return Promise.reject('not allowed'); } const args = { [WebClientService.ARGUMENT_RECEIVER_ID]: distributionList.id, }; const subType = WebClientService.SUB_TYPE_DISTRIBUTION_LIST; return this.sendDeleteWireMessage(subType, true, args); } /** * Remove all messages of a receiver * @param {threema.Receiver} receiver * @returns {Promise} */ public cleanReceiverConversation(receiver: threema.Receiver): Promise { if (receiver === null || receiver === undefined) { return Promise.reject('invalidIdentity'); } const args = { [WebClientService.ARGUMENT_RECEIVER_TYPE]: receiver.type, [WebClientService.ARGUMENT_RECEIVER_ID]: receiver.id, }; const subType = WebClientService.SUB_TYPE_CLEAN_RECEIVER_CONVERSATION; return this.sendDeleteWireMessage(subType, true, args); } /** * Modify own profile. */ public modifyProfile(nickname?: string, avatar?: ArrayBuffer): Promise { // Prepare payload data const data = {}; if (nickname !== undefined && nickname !== null) { data[WebClientService.ARGUMENT_NICKNAME] = nickname; } if (avatar !== undefined) { data[WebClientService.ARGUMENT_AVATAR] = avatar; } // If no changes happened, resolve the promise immediately. if (Object.keys(data).length === 0) { this.$log.warn(this.logTag, 'Trying to modify profile without any changes'); return Promise.resolve(null); } const subType = WebClientService.SUB_TYPE_PROFILE; return this.sendUpdateWireMessage(subType, true, undefined, data); } /** * Return whether the specified contact is currently typing. */ public isTyping(contact: threema.ContactReceiver): boolean { return this.typing.isTyping(contact); } /** * Return the curring quoted message model */ public getQuote(receiver: threema.Receiver): threema.Quote { return this.drafts.getQuote(receiver); } /** * Set or remove (if message is null) a quoted message model. */ public setQuote(receiver: threema.Receiver, message: threema.Message = null): void { // Remove current quote this.drafts.removeQuote(receiver); if (message !== null) { const quoteText = this.messageService.getQuoteText(message); if (quoteText !== undefined && quoteText !== null) { const quote = { identity: message.isOutbox ? this.me.id : message.partnerId, text: quoteText, } as threema.Quote; this.drafts.setQuote(receiver, quote); this.$rootScope.$broadcast('onQuoted', { receiver: receiver, quote: quote, }); } } } /** * Set or remove (if string is null) a draft message */ public setDraft(receiver: threema.Receiver, message: string = null): void { if (message === null || message.trim().length === 0) { this.drafts.removeText(receiver); } else { this.drafts.setText(receiver, message.trim()); } } /** * return draft text */ public getDraft(receiver: threema.Receiver): string { return this.drafts.getText(receiver); } /** * Reset data related to initialization. */ private _resetInitializationSteps(): void { this.$log.debug(this.logTag, 'Reset initialization steps'); this.initialized.clear(); this.pendingInitializationStepRoutines = new Set(); } /** * Reset data fields. */ private _resetFields(): void { // Reset initialization data this._resetInitializationSteps(); // Create container instances this.receivers = this.container.createReceivers(); this.conversations = this.container.createConversations(); this.messages = this.container.createMessages(); this.typingInstance = this.container.createTyping(); // Add converters (pre-processors) this.messages.converter = this.container.Converter.unicodeToEmoji; this.conversations.setConverter(this.container.Converter.addReceiverToConversation(this.receivers)); // Add filters this.conversations.setFilter(this.container.Filters.hasData(this.receivers)); } private _requestInitialData(): void { // If all conversations are reloaded, clear the message cache // to get in sync (we don't know if a message was removed, updated etc..) this.messages.clear(this.$rootScope); // Request initial data this.requestClientInfo(); this.requestProfile(); this.requestReceivers(); this.requestConversations(); this.requestBatteryStatus(); } // TODO: Deprecated, remove soon. private _receiveResponseConfirmAction(message: threema.WireMessage): void { this.$log.debug('Received confirmAction response'); const future = this.popWireMessageFuture(message); if (!message.ack.success) { future.reject(message.ack.error); } else { future.resolve(); } } private _receiveResponseReceivers(message: threema.WireMessage): void { this.$log.debug('Received receivers response'); const future = this.popWireMessageFuture(message, this.requiresTemporaryIdBackwardsCompatibility); // Handle error (if any) if ((!this.requiresTemporaryIdBackwardsCompatibility && message.ack !== undefined) && !message.ack.success) { future.reject(message.ack.error); } // Unpack and validate data const data = message.data; if (data === undefined) { this.$log.warn('Invalid receivers response, data missing'); return future.reject('invalidResponse'); } // Store receivers this.sortContacts(data.contact); this.receivers.set(data); this.registerInitializationStep(InitializationStep.Receivers); future.resolve(); } private _receiveResponseContactDetail(message: threema.WireMessage): void { this.$log.debug('Received contact detail response'); const future = this.popWireMessageFuture(message); // Handle error (if any) if (!message.ack.success) { return future.reject(message.ack.error); } // Unpack and validate data const args = message.args; const data = message.data; if (args === undefined || data === undefined) { this.$log.error('Invalid contact response, args or data missing'); return future.reject('invalidResponse'); } // Set contact detail const contactReceiver = this.receivers.contacts .get(args[WebClientService.ARGUMENT_IDENTITY]) as threema.ContactReceiver; if (hasValue(data[WebClientService.SUB_TYPE_RECEIVER])) { contactReceiver.systemContact = data[WebClientService.SUB_TYPE_RECEIVER][WebClientService.ARGUMENT_SYSTEM_CONTACT]; } future.resolve(contactReceiver); } private _receiveUpdateAlert(message: threema.WireMessage): void { this.$log.debug('Received alert'); this.alerts.push({ source: message.args.source, type: message.args.type, message: message.data.message, } as threema.Alert); } /** * A connectionAck request arrived. */ private _receiveRequestConnectionAck(message: threema.WireMessage) { this._sendConnectionAck(); } /** * A connectionAck update arrived. */ private _receiveUpdateConnectionAck(message: threema.WireMessage) { this.$log.debug('Received connection ack'); if (!hasValue(message.data)) { this.$log.warn(this.logTag, 'Invalid connectionAck message: data missing'); return; } if (!hasValue(message.data.sequenceNumber)) { this.$log.warn(this.logTag, 'Invalid connectionAck message: sequenceNumber missing'); return; } const sequenceNumber = message.data.sequenceNumber; // Remove chunks which have already been received by the remote side const size = this.currentChunkCache.byteLength; let result; this.$log.debug(`Pruning cache (local-sn=${this.currentChunkCache.sequenceNumber.get()}, ` + `remote-sn=${sequenceNumber})`); try { result = this.currentChunkCache.prune(sequenceNumber); } catch (error) { this.$log.error(this.logTag, error); this.failSession(); return; } this.$log.debug(`Chunk cache pruned, acknowledged: ${result.acknowledged}, left: ${result.left}, size: ` + `${size} -> ${this.currentChunkCache.byteLength}`); // Clear pending ack requests if (this.pendingAckRequest !== null && sequenceNumber >= this.pendingAckRequest) { this.pendingAckRequest = null; } } /** * A connectionDisconnect message arrived. */ private _receiveUpdateConnectionDisconnect(message: threema.WireMessage) { this.$log.debug(this.logTag, 'Received connectionDisconnect'); if (!hasValue(message.data) || !hasValue(message.data.reason)) { this.$log.warn(this.logTag, 'Invalid connectionDisconnect message: data or reason missing'); return; } const reason = message.data.reason; this.$log.debug(this.logTag, `Disconnecting requested (reason: ${reason})`); let alertMessage: string; switch (reason) { case DisconnectReason.SessionStopped: alertMessage = 'connection.SESSION_STOPPED'; break; case DisconnectReason.SessionDeleted: alertMessage = 'connection.SESSION_DELETED'; break; case DisconnectReason.WebclientDisabled: alertMessage = 'connection.WEBCLIENT_DISABLED'; break; case DisconnectReason.SessionReplaced: alertMessage = 'connection.SESSION_REPLACED'; break; case DisconnectReason.SessionError: alertMessage = 'connection.SESSION_ERROR'; break; default: alertMessage = 'connection.SESSION_ERROR'; this.$log.error(this.logTag, 'Unknown disconnect reason:', reason); break; } // Stop and show an alert on the welcome page const isWelcome = this.$state.includes('welcome'); this.stop({ reason: reason, send: false, // TODO: Use welcome.{reason} once we have it close: 'welcome', }); // Note: This is required to reset the mode and potentially // re-establish a connection if needed. // TODO: Remove once we have created pages for each mode on the // 'welcome' page. if (isWelcome) { this.$state.reload().catch((error) => { this.$log.error('Unable to reload state:', error); }); } this.showAlert(alertMessage); } /** * A connectionInfo message arrived. */ private _receiveConnectionInfo(message: threema.WireMessage) { this.$log.debug('Received connectionInfo from device'); if (!hasValue(message.data)) { this.connectionInfoFuture.reject('Invalid connectionInfo message: data missing'); return; } if (!hasValue(message.data.id)) { this.connectionInfoFuture.reject('Invalid connectionInfo message: data.id is missing'); return; } if (!(message.data.id instanceof ArrayBuffer)) { this.connectionInfoFuture.reject('Invalid connectionInfo message: data.id is of invalid type'); return; } const resume = message.data.resume; if (resume !== undefined) { if (!hasValue(resume.id)) { this.connectionInfoFuture.reject('Invalid connectionInfo message: data.resume.id is missing'); return; } if (!hasValue(resume.sequenceNumber)) { const error = 'Invalid connectionInfo message: data.resume.sequenceNumber is missing'; this.connectionInfoFuture.reject(error); return; } if (!(resume.id instanceof ArrayBuffer)) { this.connectionInfoFuture.reject('Invalid connectionInfo message: data.resume.id is of invalid type'); return; } if (resume.sequenceNumber < 0 || resume.sequenceNumber > WebClientService.SEQUENCE_NUMBER_MAX) { const error = 'Invalid connectionInfo message: data.resume.sequenceNumber is invalid'; this.connectionInfoFuture.reject(error); return; } } this.connectionInfoFuture.resolve(message.data); } /** * Process an incoming 'contact', 'group' or 'distributionList' message as * a reply to a previous 'create' or 'update' message of that sub-type. */ private _receiveReplyReceiver( message: threema.WireMessage, receiverType: threema.ReceiverType, future: Future, ): void { this.$log.debug(`Received ${receiverType} ${message.subType}`); // Handle error (if any) if (message.ack !== undefined && !message.ack.success) { return future.reject(message.ack.error); } // Unpack and validate args const args = message.args; const data = message.data; if (args === undefined) { this.$log.error(`Invalid ${receiverType} response, args or data missing`); return future.reject('invalidResponse'); } // Validate data if (data === undefined) { this.$log.error(`Invalid ${receiverType} response, 'data' is missing`); return future.reject('invalidResponse'); } // Get receiver instance const receiver = data[WebClientService.SUB_TYPE_RECEIVER] as T; // Update receiver type if not set if (receiver.type === undefined) { receiver.type = receiverType; } // Extend models if (isContactReceiver(receiver)) { this.receivers.extendContact(receiver); } else if (isGroupReceiver(receiver)) { this.receivers.extendGroup(receiver); } else if (isDistributionListReceiver(receiver)) { this.receivers.extendDistributionList(receiver); } future.resolve(receiver); } private _receiveCreateContact(message: threema.WireMessage): void { const future = this.popWireMessageFuture(message); this._receiveReplyReceiver(message, 'contact', future); } private _receiveCreateGroup(message: threema.WireMessage): void { const future = this.popWireMessageFuture(message); this._receiveReplyReceiver(message, 'group', future); } private _receiveCreateDistributionList(message: threema.WireMessage): void { const future = this.popWireMessageFuture(message); this._receiveReplyReceiver(message, 'distributionList', future); } private _receiveCreateMessage(message: threema.WireMessage): void { this.$log.debug('Received create message response'); const future = this.popWireMessageFuture(message); // Handle error (if any) if (!message.ack.success) { return future.reject(message.ack.error); } // Unpack data and arguments const args = message.args; const data = message.data; if (args === undefined || data === undefined) { this.$log.warn('Invalid create message received, arguments or data missing'); return future.reject('invalidResponse'); } const receiverType: threema.ReceiverType = args[WebClientService.ARGUMENT_RECEIVER_TYPE]; const receiverId: string = args[WebClientService.ARGUMENT_RECEIVER_ID]; const messageId: string = data[WebClientService.ARGUMENT_MESSAGE_ID]; if (receiverType === undefined || receiverId === undefined || messageId === undefined) { this.$log.warn("Invalid create received: 'type', 'id' or 'messageId' missing"); return future.reject('invalidResponse'); } // Map the previously used temporary id to the one chosen by the app const receiver = { type: receiverType, id: receiverId, } as threema.Receiver; this.messages.bindTemporaryToMessageId( receiver, message.ack.id, messageId, ); future.resolve(messageId); } private _receiveResponseConversations(message: threema.WireMessage) { this.$log.debug('Received conversations response'); const future = this.popWireMessageFuture(message, this.requiresTemporaryIdBackwardsCompatibility); // Handle error (if any) if ((!this.requiresTemporaryIdBackwardsCompatibility && message.ack !== undefined) && !message.ack.success) { future.reject(message.ack.error); } // Validate data const data = message.data as threema.Conversation[]; if (data === undefined) { this.$log.warn('Invalid conversation response, data missing'); return future.reject('invalidResponse'); } // Run delayed... this.runAfterInitializationSteps([ InitializationStep.Receivers, ], () => { // If a avatar was set on a conversation, convert and copy to the receiver for (const conversation of data) { if (conversation.avatar !== undefined && conversation.avatar !== null) { const receiver: threema.Receiver = this.receivers.getData({ id: conversation.id, type: conversation.type, }); if (receiver !== undefined && receiver.avatar === undefined) { receiver.avatar = { low: conversation.avatar, }; } // Remove avatar from conversation delete conversation.avatar; } } // Store conversations & done this.conversations.set(data); this.updateUnreadCount(); this.registerInitializationStep(InitializationStep.Conversations); future.resolve(); }); } private _receiveResponseMessages(message: threema.WireMessage): void { this.$log.debug('Received messages response'); const future = this.popWireMessageFuture(message, this.requiresTemporaryIdBackwardsCompatibility); // Handle error (if any) if ((!this.requiresTemporaryIdBackwardsCompatibility && message.ack !== undefined) && !message.ack.success) { future.reject(message.ack.error); } // Unpack data and arguments const args = message.args; const data = message.data as threema.Message[]; if (args === undefined || data === undefined) { this.$log.warn('Invalid messages response, data or arguments missing'); return future.reject('invalidResponse'); } // Unpack required argument fields const type: string = args[WebClientService.ARGUMENT_RECEIVER_TYPE]; const id: string = args[WebClientService.ARGUMENT_RECEIVER_ID]; let more: boolean = args[WebClientService.ARGUMENT_HAS_MORE]; if (type === undefined || id === undefined || more === undefined) { this.$log.warn('Invalid messages response, argument field missing'); return future.reject('invalidResponse'); } if (!isValidReceiverType(type)) { this.$log.warn('Invalid messages response, unknown receiver type (' + type + ')'); return future.reject('invalidResponse'); } const receiver: threema.BaseReceiver = {type: type, id: id}; // If there's no data returned, override `more` field. if (data.length === 0) { more = false; } // Set as loaded this.loadingMessages.delete(receiver.type + receiver.id); // Check if the messages have been requested // TODO: Isn't this a bogus check since we know that we have made the // request at this point? if (!this.messages.isRequested(receiver)) { this.$log.warn("Ignoring message response that hasn't been requested"); return future.reject('invalidResponse'); } // Add messages this.messages.addOlder(receiver, data); // Clear pending request this.messages.clearRequested(receiver); // Set "more" flag to indicate that more (older) messages are available. this.messages.setMore(receiver, more); // Notify listeners this.messages.notify(receiver, this.$rootScope); // Done future.resolve(); } private _receiveResponseAvatar(message: threema.WireMessage): void { this.$log.debug('Received avatar response'); const future = this.popWireMessageFuture(message); // Handle error (if any) if (!message.ack.success) { future.reject(message.ack.error); } // Unpack data and arguments const args = message.args; if (args === undefined) { this.$log.warn('Invalid message response: arguments missing'); return future.reject('invalidResponse'); } // Check for avatar data const avatar = message.data; if (avatar === undefined) { // A receiver without an avatar - fine! return future.resolve(null); } // Unpack required argument fields const type = args[WebClientService.ARGUMENT_RECEIVER_TYPE]; const id = args[WebClientService.ARGUMENT_RECEIVER_ID]; const highResolution = args[WebClientService.ARGUMENT_AVATAR_HIGH_RESOLUTION]; if (type === undefined || id === undefined || highResolution === undefined) { this.$log.warn('Invalid avatar response, argument field missing'); return future.reject('invalidResponse'); } // Set avatar for receiver according to resolution const field: string = highResolution ? 'high' : 'low'; const receiverData = this.receivers.getData(args); if (receiverData.avatar === null || receiverData.avatar === undefined) { receiverData.avatar = {}; } receiverData.avatar[field] = avatar; future.resolve(avatar); } private _receiveResponseThumbnail(message: threema.WireMessage): void { this.$log.debug('Received thumbnail response'); const future = this.popWireMessageFuture(message); // Handle error (if any) if (!message.ack.success) { future.reject(message.ack.error); } // Unpack data and arguments const args = message.args; if (args === undefined) { this.$log.warn('Invalid message response: arguments missing'); return future.reject('invalidResponse'); } // Check for thumbnail data const thumbnail = message.data; if (thumbnail === undefined) { // A message without a thumbnail - fine! return future.resolve(null); } // Unpack required argument fields const type = args[WebClientService.ARGUMENT_RECEIVER_TYPE]; const id = args[WebClientService.ARGUMENT_RECEIVER_ID]; const messageId: string = args[WebClientService.ARGUMENT_MESSAGE_ID]; if (type === undefined || id === undefined || messageId === undefined ) { this.$log.warn('Invalid thumbnail response, argument field missing'); return future.reject('invalidResponse'); } // Set thumbnail this.messages.setThumbnail( this.receivers.getData(args), messageId, thumbnail); future.resolve(thumbnail); } private _receiveResponseBlob(message: threema.WireMessage): void { this.$log.debug('Received blob response'); const future = this.popWireMessageFuture(message); // Handle error (if any) if (!message.ack.success) { return future.reject(message.ack.error); } // Unpack data and arguments const args = message.args; const data = message.data; if (args === undefined) { this.$log.warn('Invalid message response, args missing'); return future.reject('invalidResponse'); } // Unpack required argument fields const receiverType = args[WebClientService.ARGUMENT_RECEIVER_TYPE]; const receiverId = args[WebClientService.ARGUMENT_RECEIVER_ID]; const msgId: string = args[WebClientService.ARGUMENT_MESSAGE_ID]; if (receiverType === undefined || receiverId === undefined || msgId === undefined) { this.$log.warn('Invalid blob response, argument field missing'); return future.reject('invalidResponse'); } // Unpack data const blobInfo: threema.BlobInfo = { buffer: data[WebClientService.DATA_FIELD_BLOB_BLOB], mimetype: data[WebClientService.DATA_FIELD_BLOB_TYPE], filename: data[WebClientService.DATA_FIELD_BLOB_NAME], }; if (blobInfo.buffer === undefined || blobInfo.mimetype === undefined || blobInfo.filename === undefined) { this.$log.warn('Invalid blob response, data field missing'); return future.reject('invalidResponse'); } // Store blob this.blobCache.set(msgId + receiverType, blobInfo); future.resolve(blobInfo); } private _receiveUpdateConfirm(message: threema.WireMessage): void { this.$log.debug('Received wire message acknowledgement'); const future = this.popWireMessageFuture(message); if (!message.ack.success) { future.reject(message.ack.error); } else { future.resolve(); } } private _receiveUpdateMessages(message: threema.WireMessage): void { this.$log.debug('Received messages update'); const future = this.popWireMessageFuture(message, true); // Handle error (if any) if (message.ack !== undefined && !message.ack.success) { return future.reject(message.ack.error); } // Unpack data and arguments const args = message.args; const data: threema.Message[] = message.data; if (args === undefined || data === undefined) { this.$log.warn('Invalid message update, data or arguments missing'); return future.reject('invalidResponse'); } // Unpack required argument fields const type: string = args[WebClientService.ARGUMENT_RECEIVER_TYPE]; const id: string = args[WebClientService.ARGUMENT_RECEIVER_ID]; const mode: string = args[WebClientService.ARGUMENT_MODE]; if (type === undefined || id === undefined || mode === undefined) { this.$log.warn('Invalid message update, argument field missing'); return future.reject('invalidResponse'); } if (!isValidReceiverType(type)) { this.$log.warn(this.logTag, 'Invalid messages update, unknown receiver type (' + type + ')'); return future.reject('invalidResponse'); } const receiver: threema.BaseReceiver = {type: type, id: id}; // React depending on mode let notify = false; for (const msg of data) { switch (mode) { case WebClientService.ARGUMENT_MODE_NEW: // It's possible that this message already exists (placeholder message on send). // Try to update it first. If not, add it as a new msg. if (!this.messages.update(receiver, msg)) { this.messages.addNewer(receiver, [msg]); } notify = true; break; case WebClientService.ARGUMENT_MODE_MODIFIED: this.messages.update(receiver, msg); break; case WebClientService.ARGUMENT_MODE_REMOVED: this.messages.remove(receiver, msg.id); notify = true; break; default: this.$log.warn(this.logTag, 'Invalid message response, unknown mode:', mode); } } if (notify) { this.messages.notify(receiver, this.$rootScope); } future.resolve(); } private _receiveUpdateReceiver(message: threema.WireMessage): void { this.$log.debug('Received receiver update'); // Unpack data and arguments const args = message.args; const data = message.data; if (args === undefined || data === undefined) { this.$log.warn('Invalid receiver update, data or arguments missing'); return; } // Unpack required argument fields const type = args[WebClientService.ARGUMENT_RECEIVER_TYPE] as threema.ReceiverType; const id = args[WebClientService.ARGUMENT_RECEIVER_ID]; const mode: 'new' | 'modified' | 'removed' = args[WebClientService.ARGUMENT_MODE]; if (type === undefined || mode === undefined || id === undefined) { this.$log.warn('Invalid receiver update, argument field missing'); return; } // React depending on mode switch (mode) { case WebClientService.ARGUMENT_MODE_NEW: case WebClientService.ARGUMENT_MODE_MODIFIED: // Add or update a certain receiver const updatedReceiver = this.receivers.extend(type, data); // Remove all cached messages if the receiver was moved to "locked" state if (updatedReceiver !== undefined && updatedReceiver.locked) { this.messages.clearReceiverMessages(updatedReceiver); } break; case WebClientService.ARGUMENT_MODE_REMOVED: // Remove a certain receiver (this.receivers.get(type) as Map).delete(id); break; default: this.$log.warn('Invalid receiver response, unknown mode:', mode); } } private _receiveUpdateReceivers(message: threema.WireMessage): void { this.$log.debug('Received receivers update'); // Unpack data and arguments const args = message.args; const data = message.data; if (args === undefined || data === undefined) { this.$log.warn('Invalid receiver update, data or arguments missing'); return; } // Unpack required argument fields const type = args[WebClientService.ARGUMENT_RECEIVER_TYPE] as threema.ReceiverType; if (type === undefined) { this.$log.warn('Invalid receivers update, argument field missing'); return; } // Refresh lists of receivers switch (type) { case 'contact': this.sortContacts(data); this.receivers.setContacts(data); break; case 'group': this.receivers.setGroups(data); break; case 'distributionList': this.receivers.setDistributionLists(data); break; default: this.$log.warn('Unknown receiver type:', type); } } private _receiveUpdateTyping(message: threema.WireMessage): void { this.$log.debug('Received typing update'); // Unpack data and arguments const args = message.args; const data = message.data; if (args === undefined || data === undefined) { this.$log.warn('Invalid typing update, data or arguments missing'); return; } // Unpack required argument fields const identity: string = args[WebClientService.ARGUMENT_RECEIVER_ID]; if (identity === undefined) { this.$log.warn('Invalid typing update, argument field missing'); return; } // Unpack required data fields const isTyping: boolean = data[WebClientService.ARGUMENT_IS_TYPING]; if (isTyping === undefined) { this.$log.warn('Invalid typing update, data field missing'); return; } // Store or remove typing notification. // Note that we know that the receiver must be a contact, because // groups and distribution lists can't type. const receiver = {id: identity, type: 'contact'} as threema.ContactReceiver; if (isTyping === true) { this.typing.setTyping(receiver); } else { this.typing.unsetTyping(receiver); } } private _receiveUpdateConversation(message: threema.WireMessage) { this.$log.debug('Received conversation update'); // Validate data const args = message.args; const data = message.data as threema.ConversationWithPosition; if (args === undefined || data === undefined) { this.$log.warn('Invalid conversation update, data or arguments missing'); return; } // Get receiver const receiver = this.receivers.getData({type: data.type, id: data.id}); // Unpack required argument fields const type: string = args[WebClientService.ARGUMENT_MODE]; switch (type) { case WebClientService.ARGUMENT_MODE_NEW: this.conversations.add(data); break; case WebClientService.ARGUMENT_MODE_MODIFIED: // A conversation update *can* mean that a new message arrived. // To find out, we'll look at the unread count. If it has been // incremented, it must be a new message. if (data.unreadCount > 0) { const oldConversation = this.conversations.updateOrAdd(data, true); if (oldConversation === null) { this.onNewMessage(data.latestMessage, data, receiver); } else { // Check for unread count changes const unreadCountIncreased = data.unreadCount > oldConversation.unreadCount; const unreadCountDecreased = data.unreadCount < oldConversation.unreadCount; // If the unreadcount has increased, we received a new message. // Otherwise, if it has decreased, hide the notification. if (unreadCountIncreased) { this.onNewMessage(data.latestMessage, data, receiver); } else if (unreadCountDecreased) { this.notificationService.hideNotification(data.type + '-' + data.id); } } } else { // Update the conversation and hide any notifications this.conversations.updateOrAdd(data, false); this.notificationService.hideNotification(data.type + '-' + data.id); } break; case WebClientService.ARGUMENT_MODE_REMOVED: // Remove conversation this.conversations.remove(data); // Remove all cached messages for the receiver this.messages.clearReceiverMessages(receiver); // Call on-removed listener this.receiverListener.forEach((listener: threema.ReceiverListener) => { this.$log.debug(this.logTag, 'Call on removed listener'); listener.onConversationRemoved(receiver); }); break; default: this.$log.warn(this.logTag, 'Received conversation without a mode'); break; } this.updateUnreadCount(); } private _receiveUpdateAvatar(message: threema.WireMessage) { this.$log.debug('Received avatar update'); const args = message.args; const data = message.data as ArrayBuffer; if (args === undefined) { this.$log.warn('Invalid avatar update, arguments missing'); return; } // Get receiver const receiver = this.receivers.getData({type: args.type, id: args.id}); if (receiver === undefined) { this.$log.error(this.logTag, 'Received avatar update for nonexistent receiver'); return; } // Set low-res avatar receiver.avatar.low = data; // Invalidate high-res avatar receiver.avatar.high = undefined; } /** * Process an incoming battery status message. */ private _receiveUpdateBatteryStatus(message: threema.WireMessage): void { this.$log.debug('Received battery status'); const future = this.popWireMessageFuture(message, true); // Handle error (if any) if (message.ack !== undefined && !message.ack.success) { return future.reject(message.ack.error); } // Unpack data and arguments const data = message.data as threema.BatteryStatus; if (data === undefined) { this.$log.warn('Invalid battery status message, data missing'); return future.reject('invalidResponse'); } // Set battery status this.batteryStatusService.setStatus(data); this.$log.debug('[BatteryStatusService]', this.batteryStatusService.toString()); future.resolve(); } private _receiveUpdateContact(message: threema.WireMessage): void { const future = this.popWireMessageFuture(message); this._receiveReplyReceiver(message, 'contact', future); } private _receiveUpdateGroup(message: threema.WireMessage): void { const future = this.popWireMessageFuture(message); this._receiveReplyReceiver(message, 'group', future); } private _receiveUpdateDistributionList(message: threema.WireMessage): void { const future = this.popWireMessageFuture(message); this._receiveReplyReceiver(message, 'distributionList', future); } /** * Process an incoming profile update message. */ private _receiveUpdateProfile(message: threema.WireMessage): void { this.$log.debug('Received profile update'); // Unpack data and arguments const data = message.data as threema.ProfileUpdate; if (data === undefined) { this.$log.warn('Invalid profile update message, data missing'); return; } // Update public nickname if (data.publicNickname !== undefined) { this.me.publicNickname = data.publicNickname; this.me.displayName = this.me.publicNickname || this.me.id; } // Update avatar if (data.avatar !== undefined) { if (data.avatar === null) { this.me.avatar = {}; } else { this.me.avatar = { high: data.avatar }; } // Request new low-res avatar // noinspection JSIgnoredPromiseFromCall this.requestAvatar(this.me, false); } } /** * The peer sends the device information string. This can be used to * identify the active session. */ private _receiveResponseClientInfo(message: threema.WireMessage): void { this.$log.debug('Received client info response'); const future = this.popWireMessageFuture(message, this.requiresTemporaryIdBackwardsCompatibility); // Handle error (if any) if ((!this.requiresTemporaryIdBackwardsCompatibility && message.ack !== undefined) && !message.ack.success) { future.reject(message.ack.error); } // Validate data const data = message.data; if (data === undefined) { this.$log.warn('Invalid client info, data field missing'); return future.reject('invalidResponse'); } /** * Return the field if it's not undefined, otherwise return the default. */ function getOrDefault(field: T, defaultVal: T): T { if (field === undefined) { return defaultVal; } return field; } // Set clientInfo attribute this.clientInfo = { device: data.device, os: data.os, osVersion: data.osVersion, isWork: hasValue(data.isWork) ? data.isWork : false, // TODO: Backwards compat hack, remove after 08/2019 pushToken: data.pushToken, configuration: { voipEnabled: getOrDefault(data.configuration.voipEnabled, true), voipForceTurn: getOrDefault(data.configuration.voipForceTurn, false), largeSingleEmoji: getOrDefault(data.configuration.largeSingleEmoji, true), showInactiveIDs: getOrDefault(data.configuration.showInactiveIDs, true), }, capabilities: { maxGroupSize: getOrDefault(data.capabilities.maxGroupSize, 50), maxFileSize: getOrDefault(data.capabilities.maxFileSize, 50 * 1024 * 1024), distributionLists: getOrDefault(data.capabilities.distributionLists, true), imageFormat: data.capabilities.imageFormat, mdm: data.capabilities.mdm, }, }; this.$log.debug('Client device:', this.clientInfo.device); // Store push token if (this.clientInfo.pushToken) { this.pushToken = this.clientInfo.pushToken; switch (this.clientInfo.os) { case threema.OperatingSystem.Android: this.pushTokenType = threema.PushTokenType.Gcm; break; case threema.OperatingSystem.Ios: this.pushTokenType = threema.PushTokenType.Apns; break; default: this.$log.error(this.logTag, 'Invalid operating system in client info'); } } if (this.pushToken && this.pushTokenType) { this.pushService.init(this.pushToken, this.pushTokenType); } this.registerInitializationStep(InitializationStep.ClientInfo); future.resolve(); } /** * The peer sends information about the current user profile. */ private _receiveResponseProfile(message: threema.WireMessage): void { this.$log.debug('Received profile response'); const future = this.popWireMessageFuture(message, this.requiresTemporaryIdBackwardsCompatibility); // Handle error (if any) if ((!this.requiresTemporaryIdBackwardsCompatibility && message.ack !== undefined) && !message.ack.success) { future.reject(message.ack.error); } // Validate data const data = message.data as threema.Profile; if (data === undefined) { this.$log.warn('Invalid client info, data field missing'); return future.reject('invalidResponse'); } // Create 'me' receiver with profile + dummy data // TODO: Send both high-res and low-res avatars this.receivers.setMe({ type: 'me', id: data.identity, publicNickname: data.publicNickname, displayName: data.publicNickname || data.identity, publicKey: data.publicKey, avatar: { high: data.avatar, }, featureMask: 0xFF, verificationLevel: 3, state: 'ACTIVE', hidden: false, access: { canChangeAvatar: true, canChangeFirstName: true, canChangeLastName: true, }, color: '#000000', }); this.registerInitializationStep(InitializationStep.Profile); future.resolve(); } public setPassword(password: string) { // If a password has been set, store trusted key and push token if (this._maybeTrustKeys(password)) { // Saved trusted key, send information to client this.sendKeyPersisted(); } } /** * Reset all Fields and clear the blob cache */ public clearCache(): void { this._resetFields(); this.blobCache.clear(); } /** * Return the max text length */ public getMaxTextLength(): number { return WebClientService.MAX_TEXT_LENGTH; } /** * Returns the max group member size */ public getMaxGroupMemberSize(): number { return this.clientInfo.capabilities.maxGroupSize; } /** * Whether a notification should be triggered. */ private shouldNotify(settings: threema.SimplifiedNotificationSettings, message: threema.Message): boolean { if (settings.dnd.enabled) { // Do not show any notifications on muted chats if (settings.dnd.mentionOnly) { let textToSearch = ''; if (message.type === 'text') { textToSearch = message.body; } else if (message.caption) { textToSearch = message.caption; } let quotedMe = false; if (message.quote) { textToSearch += ' ' + message.quote.text; quotedMe = message.quote.identity === this.me.id; } const forMe = textToSearch.indexOf('@[' + this.me.id + ']') !== -1; const forAll = textToSearch.indexOf('@[@@@@@@@@]') !== -1; return forMe || forAll || quotedMe; } else { return false; } } else { return true; } } /** * Called when a new message arrives. */ private onNewMessage( message: threema.Message, conversation: threema.Conversation, sender: threema.Receiver, ): void { // Ignore message from active receivers (and if the browser tab is visible) if (this.browserService.isVisible() && this.receiverService.compare(conversation, this.receiverService.getActive())) { return; } // Do not show any notifications on private chats if (sender.locked === true) { return; } // Consider conversation notification settings const simplifiedNotification = this.notificationService.getAppNotificationSettings(conversation); if (!this.shouldNotify(simplifiedNotification, message)) { return; } // Determine sender and partner name (used for notification) let senderName = sender.id; if (sender.displayName) { senderName = sender.displayName; } else if (isContactReceiver(sender)) { senderName = '~' + sender.publicNickname; } const partner = this.receivers.getData({ id: message.partnerId, type: 'contact', } as threema.Receiver) as threema.ContactReceiver; const partnerName = partner.displayName || ('~' + partner.publicNickname); // Show notification this.$translate('messenger.MESSAGE_NOTIFICATION_SUBJECT', {messageCount: conversation.unreadCount}) .then((titlePrefix) => { const title = `${titlePrefix} ${senderName}`; let body = ''; const messageType = message.type; const caption = message.caption; let captionString = ''; if (caption !== undefined) { captionString = captionString + ': ' + caption; } const messageTypeString = this.$translate.instant('messageTypes.' + messageType); switch (messageType as threema.MessageType) { case 'text': body = message.body; break; case 'location': body = messageTypeString + ': ' + message.location.description; break; case 'file': if (message.file.type === 'image/gif') { body = this.$translate.instant('messageTypes.' + 'gif') + captionString; break; } // Display caption, if available otherwise use filename if (captionString.length > 0) { body = messageTypeString + captionString; } else { body = messageTypeString + ': ' + message.file.name; } break; case 'ballot': // TODO Show ballot title if ballot messages are implemented in the web version body = messageTypeString; break; case 'voipStatus': let translationKey: string; switch ((message as threema.Message).voip.status) { case 1: translationKey = 'CALL_MISSED'; break; case 2: translationKey = message.isOutbox ? 'CALL_FINISHED_IN' : 'CALL_FINISHED_OUT'; break; case 3: translationKey = 'CALL_REJECTED'; break; case 4: translationKey = 'CALL_ABORTED'; break; default: // No default } if (translationKey !== undefined) { body = this.$translate.instant('voip.' + translationKey); } break; default: // Image, video and audio body = messageTypeString + captionString; } if (conversation.type === 'group') { body = partnerName + ': ' + body; } const tag = conversation.type + '-' + conversation.id; const avatar = (sender.avatar && sender.avatar.low) ? this.$filter('bufferToUrl')(sender.avatar.low, 'image/png') : null; this.notificationService.showNotification(tag, title, body, avatar, () => { this.$state.go('messenger.home.conversation', { type: conversation.type, id: conversation.id, initParams: null, }); }, undefined, undefined, simplifiedNotification.sound.muted); }); } /** * If a password has been set, store own private permanent key and public * key of the peer in the trusted key store. */ private _maybeTrustKeys(password: string): boolean { if (password !== undefined && password !== null && password.length > 0) { this.trustedKeyStore.storeTrustedKey( this.salty.keyStore.publicKeyBytes, this.salty.keyStore.secretKeyBytes, this.salty.peerPermanentKeyBytes, this.pushToken, this.pushTokenType, password, ); this.$log.info('Stored trusted key'); return true; } return false; } public updatePushToken(token: string, tokenType: threema.PushTokenType): void { this.pushToken = token; this.pushTokenType = tokenType; } private sendRequestWireMessage( subType: string, retransmit: boolean, args?: object, data?: any, id?: string, ): Promise { return this.sendWireMessage(WebClientService.TYPE_REQUEST, subType, retransmit, args, data, id); } private sendUpdateWireMessage( subType: string, retransmit: boolean, args?: object, data?: any, id?: string, ): Promise { return this.sendWireMessage(WebClientService.TYPE_UPDATE, subType, retransmit, args, data, id); } private sendCreateWireMessage( subType: string, retransmit: boolean, args?: object, data?: any, id?: string, ): Promise { return this.sendWireMessage(WebClientService.TYPE_CREATE, subType, retransmit, args, data, id); } private sendDeleteWireMessage( subType: string, retransmit: boolean, args?: object, data?: any, id?: string, ): Promise { return this.sendWireMessage(WebClientService.TYPE_DELETE, subType, retransmit, args, data, id); } private createRandomWireMessageId() { let id; do { id = randomString(6); } while (this.wireMessageFutures.has(id)); return id; } private sendWireMessage( type: string, subType: string, retransmit: boolean, args?: object, data?: any, id?: string, ): Promise { const message: threema.WireMessage = { type: type, subType: subType, }; // Create a promise with a random ID (if retransmitting) // Note: We do this in order to keep track of which messages the app // has processed (NOT only received). A message that has not been // processed yet is an indicator to wake the app up again after a // connection loss. let promise: Promise; if (retransmit) { // Ensure ID uniqueness (if supplied) or create random ID if (id === undefined) { id = this.createRandomWireMessageId(); } else if (this.wireMessageFutures.has(id)) { throw new Error('Duplicate id for wire message detected'); } message.id = id; // TODO: Remove when removing temporaryId backwards compatibility // Set temporary ID if (args === undefined) { args = {}; } args[WebClientService.ARGUMENT_TEMPORARY_ID] = message.id; // Create & store future const future: Future = new Future(); if (this.config.MSG_DEBUGGING) { this.$log.debug(this.logTag, `Added wire message future: ${id} -> ${type}/${subType}`); } this.wireMessageFutures.set(message.id, future); promise = future; } else { promise = Promise.resolve({ id: '', success: true, }); } // Set args and data (if any) if (args !== undefined) { message.args = args; } if (data !== undefined) { message.data = data; } // Send message & return promise (or undefined) this.send(message, retransmit); return promise; } private static validateWireMessageAcknowledgement(ack: threema.WireMessageAcknowledgement): void { if (!hasValue(ack.id)) { throw new Error("Invalid wire message acknowledgement: 'id' is missing"); } if (!hasValue(ack.success)) { throw new Error("Invalid wire message acknowledgement: 'success' is missing"); } switch (ack.success) { case true: break; case false: if (!hasValue(ack.error)) { throw new Error("Invalid wire message acknowledgement: 'error' is missing"); } break; default: throw new Error("Invalid wire message acknowledgement: 'success' is not a boolean"); } } /** * Find and return the wire message future corresponding to the message. * * This will automatically validate that the 'ack' field of the message is * correct. Also, note that the future will be removed from the map of * pending wire message futures. * * @param message The message that (may) contain an acknowledgement. * @param optional If set to `true`, no error will be thrown if the message * did not contain an acknowledgement. * * Throws an exception in case the acknowledgement field is invalid. * Throws an exception in case the wire message does not contain an * acknowledgement and the acknowledgement is not optional. * Throws an exception if no future could be found. * * In any exception case, if the associated future could be found, it will * be rejected with 'invalidResponse' before the exception is being * thrown. The case of 'ack.success == false' does NOT count as an * exception case. */ private popWireMessageFuture(message: threema.WireMessage, optional = false): Future { // Transfer old temporaryId-related fields into new 'ack' field. // TODO: Remove when removing temporaryId backwards compatibility if (message.ack === undefined && message.args !== undefined && message.args[WebClientService.ARGUMENT_TEMPORARY_ID] !== undefined ) { // Not all messages with 'temporaryId' had a 'success' field, so // we need to patch it. if (message.args[WebClientService.ARGUMENT_SUCCESS] === undefined) { message.args[WebClientService.ARGUMENT_SUCCESS] = true; } message.ack = { id: message.args[WebClientService.ARGUMENT_TEMPORARY_ID], success: message.args[WebClientService.ARGUMENT_SUCCESS], error: message.args[WebClientService.ARGUMENT_ERROR], }; } // Validate message let error: Error; if (hasValue(message.ack)) { try { WebClientService.validateWireMessageAcknowledgement(message.ack); } catch (e) { error = e; } } else if (!optional) { throw new Error('Wire message did not contain an acknowledgement'); } else { // Nit: We could use a fake future here for performance return new Future(); } const id = message.ack.id; // Get associated future const future = this.wireMessageFutures.get(id); if (future !== undefined) { // Remove the future from the map this.wireMessageFutures.delete(id); if (this.config.MSG_DEBUGGING) { this.$log.debug(this.logTag, `Removed wire message future: ${id} -> ` + `${message.type}/${message.subType}`); } } else if (error === undefined) { error = new Error(`Wire message future not found for id: ${id}`); } // Handle error (reject future and throw) if (error !== undefined) { if (future !== undefined) { future.reject('invalidResponse'); } throw error; } // Done return future; } private _receiveRequest(type: string, message: threema.WireMessage): void { switch (type) { case WebClientService.SUB_TYPE_CONNECTION_ACK: this._receiveRequestConnectionAck(message); break; default: this.$log.warn(`Ignored request/${type}`); break; } } private _receiveResponse(type: string, message: threema.WireMessage): void { switch (type) { case WebClientService.SUB_TYPE_CONFIRM_ACTION: this._receiveResponseConfirmAction(message); break; case WebClientService.SUB_TYPE_RECEIVERS: this._receiveResponseReceivers(message); break; case WebClientService.SUB_TYPE_CONVERSATIONS: this._receiveResponseConversations(message); break; case WebClientService.SUB_TYPE_MESSAGES: this._receiveResponseMessages(message); break; case WebClientService.SUB_TYPE_AVATAR: this._receiveResponseAvatar(message); break; case WebClientService.SUB_TYPE_THUMBNAIL: this._receiveResponseThumbnail(message); break; case WebClientService.SUB_TYPE_BLOB: this._receiveResponseBlob(message); break; case WebClientService.SUB_TYPE_CLIENT_INFO: this._receiveResponseClientInfo(message); break; case WebClientService.SUB_TYPE_PROFILE: this._receiveResponseProfile(message); break; case WebClientService.SUB_TYPE_CONTACT_DETAIL: this._receiveResponseContactDetail(message); break; default: this.$log.warn(`Ignored response/${type}`); break; } } private _receiveUpdate(type: string, message: threema.WireMessage): void { switch (type) { case WebClientService.SUB_TYPE_CONFIRM: this._receiveUpdateConfirm(message); break; case WebClientService.SUB_TYPE_RECEIVER: this._receiveUpdateReceiver(message); break; case WebClientService.SUB_TYPE_RECEIVERS: this._receiveUpdateReceivers(message); break; case WebClientService.SUB_TYPE_MESSAGES: this._receiveUpdateMessages(message); break; case WebClientService.SUB_TYPE_TYPING: this._receiveUpdateTyping(message); break; case WebClientService.SUB_TYPE_CONVERSATION: this._receiveUpdateConversation(message); break; case WebClientService.SUB_TYPE_AVATAR: this._receiveUpdateAvatar(message); break; case WebClientService.SUB_TYPE_BATTERY_STATUS: this._receiveUpdateBatteryStatus(message); break; case WebClientService.SUB_TYPE_CONTACT: this._receiveUpdateContact(message); break; case WebClientService.SUB_TYPE_GROUP: this._receiveUpdateGroup(message); break; case WebClientService.SUB_TYPE_DISTRIBUTION_LIST: this._receiveUpdateDistributionList(message); break; case WebClientService.SUB_TYPE_PROFILE: this._receiveUpdateProfile(message); break; case WebClientService.SUB_TYPE_ALERT: this._receiveUpdateAlert(message); break; case WebClientService.SUB_TYPE_CONNECTION_ACK: this._receiveUpdateConnectionAck(message); break; case WebClientService.SUB_TYPE_CONNECTION_DISCONNECT: this._receiveUpdateConnectionDisconnect(message); break; default: this.$log.warn(`Ignored update/${type}`); break; } } private _receiveCreate(type: string, message: threema.WireMessage): void { switch (type) { case WebClientService.SUB_TYPE_CONTACT: this._receiveCreateContact(message); break; case WebClientService.SUB_TYPE_GROUP: this._receiveCreateGroup(message); break; case WebClientService.SUB_TYPE_DISTRIBUTION_LIST: this._receiveCreateDistributionList(message); break; case WebClientService.SUB_TYPE_TEXT_MESSAGE: // fallthrough case WebClientService.SUB_TYPE_FILE_MESSAGE: this._receiveCreateMessage(message); break; default: this.$log.warn(`Ignored response/${type}`); break; } } /** * Encode an object using the msgpack format. */ private msgpackEncode(data: any): Uint8Array { return msgpack.encode(data, this.msgpackEncoderOptions); } /** * Decode an object using the msgpack format. */ private msgpackDecode(bytes: Uint8Array): any { return msgpack.decode(bytes, this.msgpackDecoderOptions); } /** * Send a message via the underlying transport. */ private send(message: threema.WireMessage, retransmit: boolean): void { this.$log.debug('Sending', message.type + '/' + message.subType, 'message'); if (this.config.MSG_DEBUGGING) { this.$log.debug('[Message] Outgoing:', message.type, '/', message.subType, message); } // TODO: Fix chosenTask may be different between connections in the // future. Do not rely on it when sending while not being // connected. switch (this.chosenTask) { case threema.ChosenTask.WebRTC: { // Send bytes through WebRTC DataChannel const bytes: Uint8Array = this.msgpackEncode(message); if (this.config.MSGPACK_DEBUGGING) { this.$log.debug('Outgoing message payload: ' + msgpackVisualizer(bytes)); } this.secureDataChannel.send(bytes); } break; case threema.ChosenTask.RelayedData: { // Don't queue handshake messages // TODO: Add this as a method argument const canQueue = message.subType !== WebClientService.SUB_TYPE_CONNECTION_INFO; // Send bytes through e2e encrypted WebSocket const bytes: Uint8Array = this.msgpackEncode(message); if (this.config.MSGPACK_DEBUGGING) { this.$log.debug('Outgoing message payload: ' + msgpackVisualizer(bytes)); } // Increment the outgoing message sequence number const messageSequenceNumber = this.outgoingMessageSequenceNumber.increment(); const chunker = new chunkedDc.Chunker(messageSequenceNumber, bytes, WebClientService.CHUNK_SIZE); for (const chunk of chunker) { // Send (and cache) this.sendChunk(chunk, retransmit, canQueue, true); } // Check if we need to request an acknowledgement // Note: We only request if none is pending. if (this.pendingAckRequest === null && this.currentChunkCache.byteLength > WebClientService.CHUNK_CACHE_SIZE_MAX) { // Warning: This field MUST be set before requesting the // connection ack or you will end up with an // infinite recursion. this.pendingAckRequest = this.currentChunkCache.sequenceNumber.get(); this._requestConnectionAck(); } } break; default: this.$log.error(this.logTag, 'Trying to send message, but no chosen task set'); } } /** * Send a chunk via the underlying transport. */ private sendChunk(chunk: Uint8Array, retransmit: boolean, canQueue: boolean, cache: boolean): void { // TODO: Support for sending in chunks via data channels will be added later if (this.chosenTask !== threema.ChosenTask.RelayedData) { throw new Error(`Cannot send chunk, not supported by task: ${this.chosenTask}`); } const shouldQueue = canQueue && this.previousChunkCache !== null; let chunkCache; // Enqueue in the chunk cache that is pending to be transferred and // send a wakeup push. if (shouldQueue) { chunkCache = this.previousChunkCache; this.$log.debug(this.logTag, 'Currently not connected, queueing chunk'); if (!this.pushService.isAvailable()) { this.$log.warn(this.logTag, 'Push service not available, cannot wake up peer!'); retransmit = false; } if (retransmit) { // TODO: Apply the chunk **push** blacklist instead of the // retransmit flag! this.sendPush(); } } else { chunkCache = this.currentChunkCache; } // Add to chunk cache if (cache) { if (this.config.DEBUG && this.config.MSG_DEBUGGING) { this.$log.debug(`[Chunk] Caching chunk (retransmit/push=${retransmit}:`, chunk); } try { chunkCache.append(retransmit ? chunk : null); } catch (error) { this.$log.error(this.logTag, error); this.failSession(); return; } } // Send if ready if (!shouldQueue) { if (this.config.DEBUG && this.config.MSG_DEBUGGING) { this.$log.debug(`[Chunk] Sending chunk (retransmit/push=${retransmit}:`, chunk); } this.relayedDataTask.sendMessage(chunk.buffer); } } /** * Handle an incoming chunk from the underlying transport. */ private receiveChunk(chunk: Uint8Array): void { if (this.config.DEBUG && this.config.MSG_DEBUGGING) { this.$log.debug('[Chunk] Received chunk:', chunk); } // Update incoming sequence number try { this.currentIncomingChunkSequenceNumber.increment(); } catch (error) { this.$log.error(this.logTag, `Unable to continue session: ${error}`); this.failSession(); return; } // Schedule the periodic ack timer this.scheduleConnectionAck(); // Process chunk // Warning: Nothing should be called after the unchunker has processed // the chunk since the message event is synchronous and can // result in a call to .stop! this.unchunker.add(chunk.buffer); } /** * Handle incoming message bytes from the SecureDataChannel. */ private handleIncomingMessageBytes(bytes: Uint8Array): void { this.$log.debug('New incoming message (' + bytes.byteLength + ' bytes)'); if (this.config.MSGPACK_DEBUGGING) { this.$log.debug('Incoming message payload: ' + msgpackVisualizer(bytes)); } // Decode bytes const message: threema.WireMessage = this.msgpackDecode(bytes); return this.handleIncomingMessage(message); } /** * Handle incoming incoming from the SecureDataChannel * or from the relayed data WebSocket. */ private handleIncomingMessage(message: threema.WireMessage): void { this.$log.debug(`Received ${message.type}/${message.subType} message`); // Validate message to keep contract defined by `threema.WireMessage` type if (message.type === undefined) { this.$log.warn('Ignoring invalid message (no type attribute)'); return; } else if (message.subType === undefined) { this.$log.warn('Ignoring invalid message (no subType attribute)'); return; } // If desired, log message type / subtype if (this.config.MSG_DEBUGGING) { // Deep copy message to prevent issues with JS debugger const deepcopy = copyDeep(message); this.$log.debug('[Message] Incoming:', message.type, '/', message.subType, deepcopy); } // Process data this.$rootScope.$apply(() => { this.receive(message); }); } /** * Receive a new incoming decrypted message. * This method runs inside the digest loop. */ private receive(message: threema.WireMessage): void { // Intercept handshake message if (!this.connectionInfoFuture.done) { // Check for unexpected messages if (message.type !== WebClientService.TYPE_UPDATE || message.subType !== WebClientService.SUB_TYPE_CONNECTION_INFO) { this.$log.error(this.logTag, 'Unexpected message before handshake has been completed'); this.failSession(); return; } // Dispatch and return this._receiveConnectionInfo(message); return; } // Determine message handler let messageHandler: (type, message) => void; switch (message.type) { case WebClientService.TYPE_REQUEST: messageHandler = this._receiveRequest; break; case WebClientService.TYPE_RESPONSE: messageHandler = this._receiveResponse; break; case WebClientService.TYPE_CREATE: messageHandler = this._receiveCreate; break; case WebClientService.TYPE_UPDATE: messageHandler = this._receiveUpdate; break; default: this.$log.warn(this.logTag, `Ignored message ${message.type}/${message.subType}`); break; } // Dispatch message if (messageHandler !== undefined) { try { messageHandler.apply(this, [message.subType, message]); } catch (error) { this.$log.error(this.logTag, `Unable to handle incoming wire message: ${error}`, error.stack); return; } } // Catch unhandled wire message acknowledgements // Nit: We could cache that we have already scraped the message for a // wire message acknowledgement instead of double-parsing. let future: Future; try { future = this.popWireMessageFuture(message); } catch { // Yes, I really know what I'm doing, thanks eslint... } if (future !== undefined) { this.$log.warn(`Unhandled message acknowledgement for type ${message.type}:`, message.ack); future.reject('unhandled'); } } private runAfterInitializationSteps(requiredSteps: threema.InitializationStep[], callback: any): void { for (const requiredStep of requiredSteps) { if (!this.initialized.has(requiredStep)) { this.$log.debug(this.logTag, 'Required initialization step', requiredStep, 'not completed, add pending routine'); this.pendingInitializationStepRoutines.add({ requiredSteps: requiredSteps, callback: callback, } as threema.InitializationStepRoutine); return; } } callback.apply(this); } /** * Update the unread count in the window title. */ private updateUnreadCount(): void { const totalUnreadCount = this.conversations .get() .reduce((a: number, b: threema.Conversation) => a + b.unreadCount, 0); this.titleService.updateUnreadCount(totalUnreadCount); } /** * Reset the unread count in the window title */ private resetUnreadCount(): void { this.titleService.updateUnreadCount(0); } /** * Return the configuration object from the client info data. */ public get appConfig(): threema.AppConfig { return this.clientInfo.configuration; } /** * Return the capabilities object from the client info data. */ public get appCapabilities(): threema.AppCapabilities { return this.clientInfo.capabilities; } /** * Sort a list of contacts in-place. */ private sortContacts(contacts: threema.ContactReceiver[]): void { const getSortableName = (name: string) => name.startsWith('~') ? name.substr(1) : name; let options; if (this.browserService.supportsExtendedLocaleCompare()) { options = { usage: 'sort', sensitivity: 'variant', }; } const compareFunc = (a: threema.Receiver, b: threema.Receiver) => { if (a.id.startsWith('*') && !b.id.startsWith('*')) { return 1; } if (!a.id.startsWith('*') && b.id.startsWith('*')) { return -1; } const left = getSortableName(a.displayName); const right = getSortableName(b.displayName); return left.localeCompare(right, undefined, options); }; contacts.sort(compareFunc); } /** * Clear all "is typing" flags. */ public clearIsTypingFlags(): void { this.typing.clearAll(); } private handleGlobalConnectionStateChange(stateChange: threema.GlobalConnectionStateChange): void { const isOk = stateChange.state === threema.GlobalConnectionState.Ok; const wasOk = stateChange.prevState === threema.GlobalConnectionState.Ok; if (!isOk && wasOk && this.batteryStatusService.dataAvailable) { this.batteryStatusTimeout = this.$timeout( () => { this.batteryStatusService.clearStatus(); this.batteryStatusTimeout = null; }, 60000, ); } else if (isOk && this.batteryStatusTimeout !== null) { this.$timeout.cancel(this.batteryStatusTimeout); this.batteryStatusTimeout = null; } } }