/* Copyright 2015, 2016 OpenMarket Ltd Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. */ 'use strict'; var React = require('react'); var q = require("q"); var sdk = require('matrix-react-sdk'); var MatrixClientPeg = require('matrix-react-sdk/lib/MatrixClientPeg'); var UserSettingsStore = require('matrix-react-sdk/lib/UserSettingsStore'); var Modal = require('matrix-react-sdk/lib/Modal'); /** * Enum for state of a push rule as defined by the Vector UI. * @readonly * @enum {string} */ var PushRuleVectorState = { /** The user will receive push notification for this rule */ ON: "on", /** The user will receive push notification for this rule with sound and highlight if this is legitimate */ LOUD: "loud", /** The push rule is disabled */ OFF: "off" }; module.exports = React.createClass({ displayName: 'Notififications', phases: { LOADING: "LOADING", // The component is loading or sending data to the hs DISPLAY: "DISPLAY", // The component is ready and display data ERROR: "ERROR" // There was an error }, getInitialState: function() { return { phase: this.phases.LOADING, masterPushRule: undefined, // The master rule ('.m.rule.master') vectorPushRules: [], // HS default push rules displayed in Vector UI vectorContentRules: { // Keyword push rules displayed in Vector UI vectorState: PushRuleVectorState.ON, rules: [] }, externalPushRules: [], // Push rules (except content rule) that have been defined outside Vector UI externalContentRules: [] // Keyword push rules that have been defined outside Vector UI }; }, componentWillMount: function() { this._refreshFromServer(); }, onEnableNotificationsChange: function(event) { var self = this; this.setState({ phase: this.phases.LOADING }); MatrixClientPeg.get().setPushRuleEnabled('global', self.state.masterPushRule.kind, self.state.masterPushRule.rule_id, !event.target.checked).done(function() { self._refreshFromServer(); }); }, onEnableDesktopNotificationsChange: function(event) { UserSettingsStore.setEnableNotifications(event.target.checked); }, onNotifStateButtonClicked: function(event) { var vectorRuleId = event.target.className.split("-")[0]; var newPushRuleVectorState = event.target.className.split("-")[1]; if ("keywords" === vectorRuleId) { this._setKeywordsPushRuleVectorState(newPushRuleVectorState) } else { var rule = this.getRule(vectorRuleId); if (rule) { this._setPushRuleVectorState(rule, newPushRuleVectorState); } } }, onKeywordsClicked: function(event) { var self = this; // Compute the keywords list to display var keywords = []; for (var i in this.state.vectorContentRules.rules) { var rule = this.state.vectorContentRules.rules[i]; keywords.push(rule.pattern); } if (keywords.length) { // As keeping the order of per-word push rules hs side is a bit tricky to code, // display the keywords in alphabetical order to the user keywords.sort(); keywords = keywords.join(", "); } else { keywords = ""; } var TextInputDialog = sdk.getComponent("dialogs.TextInputDialog"); Modal.createDialog(TextInputDialog, { title: "Keywords", description: "Enter keywords separated by a comma:", value: keywords, onFinished: function onFinished(should_leave, newValue) { if (should_leave && newValue !== keywords) { var newKeywords = newValue.split(','); for (var i in newKeywords) { newKeywords[i] = newKeywords[i].trim(); } // Remove duplicates and empty newKeywords = newKeywords.reduce(function(array, keyword){ if (keyword !== "" && array.indexOf(keyword) < 0) { array.push(keyword); } return array; },[]); self._setKeywords(newKeywords); } } }); }, getRule: function(vectorRuleId) { for (var i in this.state.vectorPushRules) { var rule = this.state.vectorPushRules[i]; if (rule.vectorRuleId === vectorRuleId) { return rule; } } }, _actionsFor: function(pushRuleVectorState) { if (pushRuleVectorState === PushRuleVectorState.ON) { return ['notify']; } else if (pushRuleVectorState === PushRuleVectorState.LOUD) { return ['notify', {'set_tweak': 'sound', 'value': 'default'}, {'set_tweak': 'highlight', 'value': 'true'} ];; } }, // Determine whether a rule is in the PushRuleVectorState.ON category or in PushRuleVectorState.LOUD // regardless of its enabled state. _pushRuleVectorStateKind: function(rule) { var stateKind; // Count tweaks to determine if it is a ON or LOUD rule var tweaks = 0; for (var j in rule.actions) { var action = rule.actions[j]; if (action.set_tweak === 'sound' || (action.set_tweak === 'highlight' && action.value)) { tweaks++; } } switch (tweaks) { case 0: stateKind = PushRuleVectorState.ON; break; case 2: stateKind = PushRuleVectorState.LOUD; break; } return stateKind; }, _setPushRuleVectorState: function(rule, newPushRuleVectorState) { // For now, we support only enabled/disabled for hs default rules // Translate ON, LOUD, OFF to one of the 2. if (rule && rule.vectorState !== newPushRuleVectorState) { this.setState({ phase: this.phases.LOADING }); var self = this; MatrixClientPeg.get().setPushRuleEnabled('global', rule.rule.kind, rule.rule.rule_id, (newPushRuleVectorState !== PushRuleVectorState.OFF)).done(function() { self._refreshFromServer(); }); } }, _setKeywordsPushRuleVectorState: function(newPushRuleVectorState) { // Is there really a change? if (this.state.vectorContentRules.vectorState === newPushRuleVectorState || this.state.vectorContentRules.rules.length === 0) { return; } var self = this; var cli = MatrixClientPeg.get(); this.setState({ phase: this.phases.LOADING }); // Update all rules in self.state.vectorContentRules var deferreds = []; for (var i in this.state.vectorContentRules.rules) { var rule = this.state.vectorContentRules.rules[i]; var enabled, actions; switch (newPushRuleVectorState) { case PushRuleVectorState.ON: if (rule.actions.length !== 1) { actions = this._actionsFor(PushRuleVectorState.ON); } if (this.state.vectorContentRules.vectorState === PushRuleVectorState.OFF) { enabled = true; } break; case PushRuleVectorState.LOUD: if (rule.actions.length !== 3) { actions = this._actionsFor(PushRuleVectorState.LOUD); } if (this.state.vectorContentRules.vectorState === PushRuleVectorState.OFF) { enabled = true; } break; case PushRuleVectorState.OFF: enabled = false; break; } if (actions) { // Note that the workaround in _updatePushRuleActions will automatically // enable the rule deferreds.push(this._updatePushRuleActions(rule, actions, enabled)); } else if (enabled != undefined) { deferreds.push(cli.setPushRuleEnabled('global', rule.kind, rule.rule_id, enabled)); } } q.all(deferreds).done(function(resps) { self._refreshFromServer(); }, function(error) { var ErrorDialog = sdk.getComponent("dialogs.ErrorDialog"); Modal.createDialog(ErrorDialog, { title: "Can't update user notification settings", description: error.toString(), onFinished: self._refreshFromServer }); }); }, _setKeywords: function(newKeywords) { this.setState({ phase: this.phases.LOADING }); var self = this; var cli = MatrixClientPeg.get(); var removeDeferreds = []; // Remove per-word push rules of keywords that are no more in the list var vectorContentRulesPatterns = []; for (var i in self.state.vectorContentRules.rules) { var rule = self.state.vectorContentRules.rules[i]; vectorContentRulesPatterns.push(rule.pattern); if (newKeywords.indexOf(rule.pattern) < 0) { removeDeferreds.push(cli.deletePushRule('global', rule.kind, rule.rule_id)); } } // If the keyword is part of `externalContentRules`, remove the rule // before recreating it in the right Vector path for (var i in self.state.externalContentRules) { var rule = self.state.externalContentRules[i]; if (newKeywords.indexOf(rule.pattern) >= 0) { removeDeferreds.push(cli.deletePushRule('global', rule.kind, rule.rule_id)); } } var onError = function(error) { var ErrorDialog = sdk.getComponent("dialogs.ErrorDialog"); Modal.createDialog(ErrorDialog, { title: "Can't update keywords", description: error.toString(), onFinished: self._refreshFromServer }); } // Then, add the new ones q.all(removeDeferreds).done(function(resps) { var deferreds = []; var pushRuleVectorStateKind = self.state.vectorContentRules.vectorState; if (pushRuleVectorStateKind === PushRuleVectorState.OFF) { // When the current global keywords rule is OFF, we need to look at // the flavor of rules in 'vectorContentRules' to apply the same actions // when creating the new rule. // Thus, this new rule will join the 'vectorContentRules' set. if (self.state.vectorContentRules.rules.length) { pushRuleVectorStateKind = self._pushRuleVectorStateKind(self.state.vectorContentRules.rules[0]); } else { // ON is default pushRuleVectorStateKind = PushRuleVectorState.ON; } } for (var i in newKeywords) { var keyword = newKeywords[i]; if (vectorContentRulesPatterns.indexOf(keyword) < 0) { if (self.state.vectorContentRules.vectorState !== PushRuleVectorState.OFF) { deferreds.push(cli.addPushRule ('global', 'content', keyword, { actions: self._actionsFor(pushRuleVectorStateKind), pattern: keyword })); } else { deferreds.push(self._addDisabledPushRule('global', 'content', keyword, { actions: self._actionsFor(pushRuleVectorStateKind), pattern: keyword })); } } } q.all(deferreds).done(function(resps) { self._refreshFromServer(); }, onError); }, onError); }, // Create a push rule but disabled _addDisabledPushRule: function(scope, kind, ruleId, body) { var cli = MatrixClientPeg.get(); var deferred = q.defer(); cli.addPushRule(scope, kind, ruleId, body).done(function() { cli.setPushRuleEnabled(scope, kind, ruleId, false).done(function() { deferred.resolve(); }, function(err) { deferred.reject(err); }); }, function(err) { deferred.reject(err); }); return deferred.promise; }, _refreshFromServer: function() { var self = this; MatrixClientPeg.get().getPushRules().done(function(rulesets) { MatrixClientPeg.get().pushRules = rulesets; // Get homeserver default rules and triage them by categories var rule_categories = { // The master rule (all notifications disabling) '.m.rule.master': 'master', // The rules displayed by Vector UI // XXX: .m.rule.contains_user_name is not managed (not a fancy rule for Vector?) '.m.rule.contains_display_name': 'vector', '.m.rule.room_one_to_one': 'vector', '.m.rule.invite_for_me': 'vector', '.m.rule.member_event': 'vector', '.m.rule.call': 'vector' // Others go to others }; // HS default rules var defaultRules = {master: [], vector: {}, others: []}; // Content/keyword rules var contentRules = {on: [], on_but_disabled:[], loud: [], loud_but_disabled: [], other: []}; for (var kind in rulesets.global) { for (var i = 0; i < Object.keys(rulesets.global[kind]).length; ++i) { var r = rulesets.global[kind][i]; var cat = rule_categories[r.rule_id]; r.kind = kind; if (r.rule_id[0] === '.') { if (cat) { if (cat === 'vector') { defaultRules.vector[r.rule_id] = r; } else { defaultRules[cat].push(r); } } else { defaultRules['others'].push(r); } } else if (kind === 'content') { switch (self._pushRuleVectorStateKind(r)) { case PushRuleVectorState.ON: if (r.enabled) { contentRules.on.push(r); } else { contentRules.on_but_disabled.push(r); } break; case PushRuleVectorState.LOUD: if (r.enabled) { contentRules.loud.push(r); } else { contentRules.loud_but_disabled.push(r); } break; default: contentRules.other.push(r); break; } } } } // Decide which content rules to display in Vector UI. // Vector displays a single global rule for a list of keywords // whereas Matrix has a push rule per keyword. // Vector can set the unique rule in ON, LOUD or OFF state. // Matrix has enabled/disabled plus a combination of (highlight, sound) tweaks. // The code below determines which set of user's content push rules can be // displayed by the vector UI. // Push rules that does not fit, ie defined by another Matrix client, ends // in self.state.externalContentRules. // There is priority in the determination of which set will be the displayed one. // The set with rules that have LOUD tweaks is the first choice. Then, the ones // with ON tweaks (no tweaks). if (contentRules.loud.length) { self.state.vectorContentRules = { vectorState: PushRuleVectorState.LOUD, rules: contentRules.loud } self.state.externalContentRules = [].concat(contentRules.loud_but_disabled, contentRules.on, contentRules.on_but_disabled, contentRules.other); } else if (contentRules.loud_but_disabled.length) { self.state.vectorContentRules = { vectorState: PushRuleVectorState.OFF, rules: contentRules.loud_but_disabled } self.state.externalContentRules = [].concat(contentRules.on, contentRules.on_but_disabled, contentRules.other); } else if (contentRules.on.length) { self.state.vectorContentRules = { vectorState: PushRuleVectorState.ON, rules: contentRules.on } self.state.externalContentRules = [].concat(contentRules.on_but_disabled, contentRules.other); } else if (contentRules.on_but_disabled.length) { self.state.vectorContentRules = { vectorState: PushRuleVectorState.OFF, rules: contentRules.on_but_disabled } self.state.externalContentRules = contentRules.other; } else { self.state.externalContentRules = contentRules.other; } // Get the master rule if any defined by the hs if (defaultRules.master.length > 0) { self.state.masterPushRule = defaultRules.master[0]; } // Build the rules displayed in Vector UI matrix table self.state.vectorPushRules = []; var rule, vectorState; // Messages containing user's display name // (skip contains_user_name which is too geeky) rule = defaultRules.vector['.m.rule.contains_display_name']; vectorState = (rule && rule.enabled) ? PushRuleVectorState.LOUD : PushRuleVectorState.OFF; self.state.vectorPushRules.push({ "vectorRuleId": "contains_display_name", "description" : "Messages containing my name", "rule": rule, "vectorState": vectorState, "disabled": PushRuleVectorState.ON }); // Messages containing keywords // For Vector UI, this is a single global push rule but translated in Matrix, // it corresponds to all content push rules (stored in self.state.vectorContentRule) self.state.vectorPushRules.push({ "vectorRuleId": "keywords", "description" : (Messages containing keywords), "vectorState": self.state.vectorContentRules.vectorState }); // Messages just sent to the user rule = defaultRules.vector['.m.rule.room_one_to_one']; vectorState = (rule && rule.enabled) ? PushRuleVectorState.LOUD : PushRuleVectorState.OFF; self.state.vectorPushRules.push({ "vectorRuleId": "room_one_to_one", "description" : "Messages just sent to me", "rule": rule, "vectorState": vectorState, "disabled": PushRuleVectorState.ON }); // Invitation for the user rule = defaultRules.vector['.m.rule.invite_for_me']; vectorState = (rule && rule.enabled) ? PushRuleVectorState.LOUD : PushRuleVectorState.OFF; self.state.vectorPushRules.push({ "vectorRuleId": "invite_for_me", "description" : "When I'm invited to a room", "rule": rule, "vectorState": vectorState, "disabled": PushRuleVectorState.ON }); // When people join or leave a room rule = defaultRules.vector['.m.rule.member_event']; vectorState = (rule && rule.enabled) ? PushRuleVectorState.ON : PushRuleVectorState.OFF; self.state.vectorPushRules.push({ "vectorRuleId": "member_event", "description" : "When people join or leave a room", "rule": rule, "vectorState": vectorState, "disabled": PushRuleVectorState.LOUD }); // Incoming call rule = defaultRules.vector['.m.rule.call']; vectorState = (rule && rule.enabled) ? PushRuleVectorState.LOUD : PushRuleVectorState.OFF; self.state.vectorPushRules.push({ "vectorRuleId": "call", "description" : "Call invitation", "rule": rule, "vectorState": vectorState, "disabled": PushRuleVectorState.ON }); // Build the rules not managed by Vector UI var otherRulesDescriptions = { '.m.rule.suppress_notices': "Suppress notifications from bots", '.m.rule.message': "Notify for all other messages/rooms", '.m.rule.fallback': "Notify me for anything else" }; self.state.externalPushRules = []; for (var i in defaultRules.others) { var rule = defaultRules.others[i]; var ruleDescription = otherRulesDescriptions[rule.rule_id]; // Show enabled default rules that was modified by the user if (ruleDescription && rule.enabled && !rule.default) { rule.description = ruleDescription; self.state.externalPushRules.push(rule); } } self.setState({ phase: self.phases.DISPLAY }); }); }, _updatePushRuleActions: function(rule, actions, enabled) { // Workaround for SYN-590 : Push rule update fails // Remove the rule and recreate it with the new actions var cli = MatrixClientPeg.get(); var deferred = q.defer(); cli.deletePushRule('global', rule.kind, rule.rule_id).done(function() { cli.addPushRule('global', rule.kind, rule.rule_id, { actions: actions, pattern: rule.pattern }).done(function() { // Then, if requested, enabled or disabled the rule if (undefined != enabled) { cli.setPushRuleEnabled('global', rule.kind, rule.rule_id, enabled).done(function() { deferred.resolve(); }, function(err) { deferred.reject(err); }); } else { deferred.resolve(); } }, function(err) { deferred.reject(err); }); }, function(err) { deferred.reject(err); }); return deferred.promise; }, renderNotifRulesTableRow: function(title, className, pushRuleVectorState, disabled) { return ( {title} ); }, renderNotifRulesTableRows: function() { var rows = []; for (var i in this.state.vectorPushRules) { var rule = this.state.vectorPushRules[i]; rows.push(this.renderNotifRulesTableRow(rule.description, rule.vectorRuleId, rule.vectorState, rule.disabled)); } return rows; }, render: function() { var self = this; if (this.state.phase === this.phases.LOADING) { var Loader = sdk.getComponent("elements.Spinner"); return (
); } if (this.state.masterPushRule) { var masterPushRuleDiv = (
); } // When enabled, the master rule inhibits all existing rules // So do not show all notification settings if (this.state.masterPushRule.enabled) { return (
{masterPushRuleDiv}
All notifications are currently disabled for all devices.
); } // Build external push rules var externalRules = []; for (var i in this.state.externalPushRules) { var rule = this.state.externalPushRules[i]; externalRules.push(
  • { rule.description }
  • ); } // Show keywords not displayed by the vector UI as a single external push rule var externalKeyWords = []; for (var i in this.state.externalContentRules) { var rule = this.state.externalContentRules[i]; externalKeyWords.push(rule.pattern); } if (externalKeyWords.length) { externalKeyWords = externalKeyWords.join(", "); externalRules.push(
  • Notifications on the following keywords follow rules which can’t be displayed here: { externalKeyWords }
  • ); } var advancedSettings; if (externalRules.length) { advancedSettings = (

    Advanced notifications settings

    There are advanced rules which are not shown here. You might have configured them in another client than Vector. You cannot tune them in Vector but they still apply.
    ); } return (
    {masterPushRuleDiv}

    General use

    { this.renderNotifRulesTableRows() }
    On Loud Off
    { advancedSettings }
    ); } });