Move various funcitons related to MUC member lists to utils

and out of the MUC views plugin.

Refs #1032

src/config.js

@@ -29,7 +29,7 @@ require.config({
         "emojione":                 "node_modules/emojione/lib/js/emojione",
         "es6-promise":              "node_modules/es6-promise/dist/es6-promise.auto",
         "eventemitter":             "node_modules/otr/build/dep/eventemitter",
-        "form-utils":               "src/form-utils",
+        "form-utils":               "src/utils/form",
         "i18n":                     "src/i18n",
         "jed":                      "node_modules/jed/jed",
         "jquery":                   "src/jquery-stub",
@@ -37,27 +37,28 @@ require.config({
         "lodash.converter":         "3rdparty/lodash.fp",
         "lodash.fp":                "src/lodash.fp",
         "lodash.noconflict":        "src/lodash.noconflict",
+        "muc-utils":                "src/utils/muc",
         "pluggable":                "node_modules/pluggable.js/dist/pluggable",
         "polyfill":                 "src/polyfill",
         "sizzle":                   "node_modules/sizzle/dist/sizzle",
+        "snabbdom":                 "node_modules/snabbdom/dist/snabbdom",
+        "snabbdom-attributes":      "node_modules/snabbdom/dist/snabbdom-attributes",
+        "snabbdom-class":           "node_modules/snabbdom/dist/snabbdom-class",
+        "snabbdom-dataset":         "node_modules/snabbdom/dist/snabbdom-dataset",
+        "snabbdom-eventlisteners":  "node_modules/snabbdom/dist/snabbdom-eventlisteners",
+        "snabbdom-props":           "node_modules/snabbdom/dist/snabbdom-props",
+        "snabbdom-style":           "node_modules/snabbdom/dist/snabbdom-style",
         "strophe":                  "node_modules/strophe.js/strophe",
         "strophe.disco":            "node_modules/strophejs-plugin-disco/strophe.disco",
         "strophe.ping":             "node_modules/strophejs-plugin-ping/strophe.ping",
         "strophe.rsm":              "node_modules/strophejs-plugin-rsm/strophe.rsm",
         "strophe.vcard":            "node_modules/strophejs-plugin-vcard/strophe.vcard",
         "text":                     "node_modules/text/text",
+        "tovnode":                  "node_modules/snabbdom/dist/tovnode",
         "tpl":                      "node_modules/lodash-template-loader/loader",
         "underscore":               "src/underscore-shim",
-        "utils":                    "src/utils",
+        "utils":                    "src/utils/core",
         "vdom-parser":              "node_modules/vdom-parser/dist",
-        "snabbdom":                 "node_modules/snabbdom/dist/snabbdom",
-        "snabbdom-attributes":      "node_modules/snabbdom/dist/snabbdom-attributes",
-        "snabbdom-class":           "node_modules/snabbdom/dist/snabbdom-class",
-        "snabbdom-dataset":         "node_modules/snabbdom/dist/snabbdom-dataset",
-        "snabbdom-eventlisteners":  "node_modules/snabbdom/dist/snabbdom-eventlisteners",
-        "snabbdom-props":           "node_modules/snabbdom/dist/snabbdom-props",
-        "snabbdom-style":           "node_modules/snabbdom/dist/snabbdom-style",
-        "tovnode":                  "node_modules/snabbdom/dist/tovnode",
         "xss":                      "node_modules/xss/dist/xss",
         "xss.noconflict":           "src/xss.noconflict",
 

src/utils/muc.js

+// Converse.js (A browser based XMPP chat client)
+// http://conversejs.org
+//
+// This is the utilities module.
+//
+// Copyright (c) 2012-2017, Jan-Carel Brand <jc@opkode.com>
+// Licensed under the Mozilla Public License (MPLv2)
+//
+/*global define, escape, Jed */
+(function (root, factory) {
+    define(["converse-core", "utils"], factory);
+}(this, function (converse, u) {
+    "use strict";
+
+    const { Strophe, sizzle, _ } = converse.env;
+
+    u.computeAffiliationsDelta = function computeAffiliationsDelta (exclude_existing, remove_absentees, new_list, old_list) {
+        /* Given two lists of objects with 'jid', 'affiliation' and
+         * 'reason' properties, return a new list containing
+         * those objects that are new, changed or removed
+         * (depending on the 'remove_absentees' boolean).
+         *
+         * The affiliations for new and changed members stay the
+         * same, for removed members, the affiliation is set to 'none'.
+         *
+         * The 'reason' property is not taken into account when
+         * comparing whether affiliations have been changed.
+         *
+         * Parameters:
+         *  (Boolean) exclude_existing: Indicates whether JIDs from
+         *      the new list which are also in the old list
+         *      (regardless of affiliation) should be excluded
+         *      from the delta. One reason to do this
+         *      would be when you want to add a JID only if it
+         *      doesn't have *any* existing affiliation at all.
+         *  (Boolean) remove_absentees: Indicates whether JIDs
+         *      from the old list which are not in the new list
+         *      should be considered removed and therefore be
+         *      included in the delta with affiliation set
+         *      to 'none'.
+         *  (Array) new_list: Array containing the new affiliations
+         *  (Array) old_list: Array containing the old affiliations
+         */
+        const new_jids = _.map(new_list, 'jid');
+        const old_jids = _.map(old_list, 'jid');
+
+        // Get the new affiliations
+        let delta = _.map(
+            _.difference(new_jids, old_jids),
+            (jid) => new_list[_.indexOf(new_jids, jid)]
+        );
+        if (!exclude_existing) {
+            // Get the changed affiliations
+            delta = delta.concat(_.filter(new_list, function (item) {
+                const idx = _.indexOf(old_jids, item.jid);
+                if (idx >= 0) {
+                    return item.affiliation !== old_list[idx].affiliation;
+                }
+                return false;
+            }));
+        }
+        if (remove_absentees) {
+            // Get the removed affiliations
+            delta = delta.concat(
+                _.map(
+                    _.difference(old_jids, new_jids),
+                    (jid) => ({'jid': jid, 'affiliation': 'none'})
+                )
+            );
+        }
+        return delta;
+    };
+
+    u.parseMemberListIQ = function parseMemberListIQ (iq) {
+        /* Given an IQ stanza with a member list, create an array of member
+            * objects.
+            */
+        return _.map(
+            sizzle(`query[xmlns="${Strophe.NS.MUC_ADMIN}"] item`, iq),
+            (item) => ({
+                'jid': item.getAttribute('jid'),
+                'affiliation': item.getAttribute('affiliation'),
+            })
+        );
+    };
+
+    u.marshallAffiliationIQs = function marshallAffiliationIQs () {
+        /* Marshall a list of IQ stanzas into a map of JIDs and
+            * affiliations.
+            *
+            * Parameters:
+            *  Any amount of XMLElement objects, representing the IQ
+            *  stanzas.
+            */
+        return _.flatMap(arguments[0], u.parseMemberListIQ);
+    }
+
+}));