/* Copyright 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" }; /** * The descriptions of rules managed by the Vector UI. * Each rule is described so that if the server does not have it in its default * rules or if the user wants to use actions ('PushRuleVectorState') that are * different from the hs one, the code will create a new rule that will override * the hs one. */ var VectorPushRulesDefinitions = { // Messages containing user's display name // (skip contains_user_name which is too geeky) "im.vector.rule.contains_display_name": { hsDefaultRuleId: ".m.rule.contains_display_name", description: "Messages containing my name", conditions: [{ "kind": "contains_display_name" }], hsDefaultRuleVectorState: PushRuleVectorState.LOUD, vectorStateToActions: { on: [ "notify" ], loud: [ "notify", { "set_tweak": "sound", "value": "default" }, { "set_tweak":"highlight" } ] } }, // Messages just sent to the user in a 1:1 room "im.vector.rule.room_one_to_one": { hsDefaultRuleId: ".m.rule.room_one_to_one", description: "Messages just sent to me", conditions: [{ "is": "2", "kind": "room_member_count" }], hsDefaultRuleVectorState: PushRuleVectorState.LOUD, vectorStateToActions: { on: [ "notify" ], loud: [ "notify", { "set_tweak": "sound", "value": "default" } ] } }, // Messages just sent to a group chat room "im.vector.rule.room_group": { description: "Messages sent to group", conditions: [{ "is": ">2", "kind": "room_member_count" }], hsDefaultRuleId: undefined, // Matrix does not define a default hs push rule for group hsDefaultRuleVectorState: PushRuleVectorState.on, vectorStateToActions: { on: [ "notify" ], loud: [ "notify", { "set_tweak": "sound", "value": "default" } ] } }, // Invitation for the user "im.vector.rule.invite_for_me": { hsDefaultRuleId: ".m.rule.invite_for_me", description: "When I'm invited to a room", conditions: [ { "key": "type", "kind": "event_match", "pattern": "m.room.member" }, { "key": "content.membership", "kind": "event_match", "pattern": "invite" }, { "key": "state_key", "kind": "event_match", "pattern": "" // It is updated at runtime the user id } ], hsDefaultRuleVectorState: PushRuleVectorState.LOUD, vectorStateToActions: { on: [ "notify" ], loud: [ "notify", { "set_tweak": "sound", "value": "default" } ] } }, // When people join or leave a room "im.vector.rule.member_event": { hsDefaultRuleId: ".m.rule.member_event", description: "When people join or leave a room", conditions: [{ "pattern": "m.room.member", "kind": "event_match", "key": "type" }], hsDefaultRuleVectorState: PushRuleVectorState.ON, vectorStateToActions: { on: [ "notify" ], loud: [ "notify", { "set_tweak": "sound", "value": "default" } ] } }, // Incoming call "im.vector.rule.call": { hsDefaultRuleId: ".m.rule.call", description: "Call invitation", conditions: [{ "pattern": "m.room.member", "kind": "event_match", "key": "type" }], hsDefaultRuleVectorState: PushRuleVectorState.LOUD, vectorStateToActions: { on: [ "notify" ], loud: [ "notify", { "set_tweak": "ring", "value": "default" } ] } }, }; 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() { // Finalise the vector definitions VectorPushRulesDefinitions["im.vector.rule.invite_for_me"].conditions[2].pattern = MatrixClientPeg.get().credentials.userId; 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 content rule is in the PushRuleVectorState.ON category or in PushRuleVectorState.LOUD // regardless of its enabled state. Returns undefined if it does not match these categories. _contentRuleVectorStateKind: 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) { if (rule && rule.vectorState !== newPushRuleVectorState) { this.setState({ phase: this.phases.LOADING }); var self = this; var cli = MatrixClientPeg.get(); var deferreds = []; var ruleDefinition = VectorPushRulesDefinitions[rule.vectorRuleId]; if (rule.rule) { if (newPushRuleVectorState === PushRuleVectorState.OFF) { // Remove the vector rule if any if (!rule.isHSDefaultRule) { deferreds.push(cli.deletePushRule('global', rule.rule.kind, rule.rule.rule_id)) } // And disable the hs default rule deferreds.push(cli.setPushRuleEnabled('global', 'underride', ruleDefinition.hsDefaultRuleId, false)); } else { if (rule.isHSDefaultRule) { // If the new state corresponds to the hs default rule actions, enable it // Else create a new rule that will override it if (newPushRuleVectorState === ruleDefinition.hsDefaultRuleVectorState) { deferreds.push(cli.setPushRuleEnabled('global', rule.rule.kind, rule.rule.rule_id, true)); } else { deferreds.push(this._addOverridingVectorPushRule(rule.vectorRuleId, newPushRuleVectorState)); } } else { // Change the actions of the overriding Vector rule deferreds.push(this._updatePushRuleActions(rule.rule, ruleDefinition.vectorStateToActions[newPushRuleVectorState])); } } } else { // This is a Vector rule which does not exist yet server side // Create it deferreds.push(this._addOverridingVectorPushRule(rule.vectorRuleId, newPushRuleVectorState)); } q.all(deferreds).done(function() { self._refreshFromServer(); }, function(error) { var ErrorDialog = sdk.getComponent("dialogs.ErrorDialog"); Modal.createDialog(ErrorDialog, { title: "Can't change settings", description: error.toString(), onFinished: 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._contentRuleVectorStateKind(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; }, // Add a push rule server side according to the 'VectorPushRulesDefinitions' spec _addOverridingVectorPushRule: function(vectorRuleId, vectorState) { var self = this; // Create the rule as predefined var ruleDefinition = VectorPushRulesDefinitions[vectorRuleId]; var body = { conditions: ruleDefinition.conditions, actions: ruleDefinition.vectorStateToActions[vectorState] } return MatrixClientPeg.get().addPushRule('global', "override", vectorRuleId, body); }, _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 default push 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: []}; // Push rules defined py Vector to override hs default rules var vectorOverridingRules = {}; // 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') { // Remove disabled, useless actions r.actions = r.actions.reduce(function(array, action){ if (action.value !== false) { array.push(action); } return array; },[]); defaultRules.vector[r.rule_id] = r; } else { defaultRules[cat].push(r); } } else { defaultRules['others'].push(r); } } else if (r.rule_id.startsWith('im.vector')) { vectorOverridingRules[r.rule_id] = r; } else if (kind === 'content') { switch (self._contentRuleVectorStateKind(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 the Vector UI matrix table self.state.vectorPushRules = []; var vectorRuleIds = [ 'im.vector.rule.contains_display_name', '_keywords', 'im.vector.rule.room_one_to_one', 'im.vector.rule.room_group', 'im.vector.rule.invite_for_me', 'im.vector.rule.member_event', 'im.vector.rule.call' ]; for (var i in vectorRuleIds) { var vectorRuleId = vectorRuleIds[i]; var ruleDefinition = VectorPushRulesDefinitions[vectorRuleId]; if (vectorRuleId === '_keywords') { // keywords needs a special handling // 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 }); } else { var rule = vectorOverridingRules[vectorRuleId]; var isHSDefaultRule = false; if (!rule) { // If the rule is not defined, look at the hs default one rule = defaultRules.vector[ruleDefinition.hsDefaultRuleId]; isHSDefaultRule = true; } // Translate the rule actions into vector state var vectorState = PushRuleVectorState.OFF; if (rule && rule.enabled) { if (JSON.stringify(rule.actions) === JSON.stringify(ruleDefinition.vectorStateToActions[PushRuleVectorState.ON])) { vectorState = PushRuleVectorState.ON; } else if (JSON.stringify(rule.actions) === JSON.stringify(ruleDefinition.vectorStateToActions[PushRuleVectorState.LOUD])) { vectorState = PushRuleVectorState.LOUD; } else { console.error("Cannot translate rule actionsinto Vector rule state"); } } self.state.vectorPushRules.push({ "vectorRuleId": vectorRuleId, "description" : ruleDefinition.description, "rule": rule, "vectorState": vectorState, "isHSDefaultRule": isHSDefaultRule, "hsDefaultRule": defaultRules.vector[ruleDefinition.hsDefaultRuleId] }); } } // 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, { conditions: rule.conditions, 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) { 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)); } 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 notifications 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 }
    ); } });