Fix linting errors and add `@module` jsdoc directives

.eslintrc.json

@@ -244,6 +244,7 @@
             "error",
             "always"
         ],
+        "require-atomic-updates": "off",
         "require-await": "error",
         "require-jsdoc": "off",
         "rest-spread-spacing": "error",

src/converse-autocomplete.js

@@ -4,10 +4,12 @@
 // Copyright (c) 2013-2019, the Converse.js developers
 // Licensed under the Mozilla Public License (MPLv2)
 
-// This plugin started as a fork of Lea Verou's Awesomplete
-// https://leaverou.github.io/awesomplete/
-
-
+/**
+ * @module converse-autocomplete
+ * @description
+ * Converse.js plugin which started as a fork of Lea Verou's Awesomplete
+ * https://leaverou.github.io/awesomplete/
+ */
 import converse from "@converse/headless/converse-core";
 
 const { _, Backbone } = converse.env,

src/converse-bookmark-views.js

@@ -4,12 +4,11 @@
 // Copyright (c) 2019, Jan-Carel Brand <jc@opkode.com>
 // Licensed under the Mozilla Public License (MPLv2)
 //
-/*global define */
-
-/* This is a Converse.js plugin which add support for bookmarks specified
- * in XEP-0048.
+/**
+ * @module converse-bookmark-views
+ * @description
+ * Converse.js plugin which adds views for XEP-0048 bookmarks
  */
-
 import "backbone.nativeview";
 import BrowserStorage from "backbone.browserStorage";
 import { OrderedListView } from "backbone.overview";

src/converse-chatboxviews.js

@@ -4,6 +4,9 @@
 // Copyright (c) 2012-2019, the Converse.js developers
 // Licensed under the Mozilla Public License (MPLv2)
 
+/**
+ * @module converse-chatboxviews
+ */
 import "@converse/headless/converse-chatboxes";
 import "backbone.nativeview";
 import { Overview } from "backbone.overview";

src/converse-chatview.js

@@ -4,6 +4,9 @@
 // Copyright (c) 2013-2019, the Converse.js developers
 // Licensed under the Mozilla Public License (MPLv2)
 
+/**
+ * @module converse-chatview
+ */
 import "backbone.nativeview";
 import "converse-chatboxviews";
 import "converse-message-view";

src/converse-controlbox.js

@@ -4,8 +4,9 @@
 // Copyright (c) 2012-2017, Jan-Carel Brand <jc@opkode.com>
 // Licensed under the Mozilla Public License (MPLv2)
 //
-/*global define */
-
+/**
+ * @module converse-controlbox
+ */
 import "converse-chatview";
 import "converse-profile";
 import "converse-rosterview";

src/converse-dragresize.js

@@ -4,8 +4,9 @@
 // Copyright (c) 2012-2017, Jan-Carel Brand <jc@opkode.com>
 // Licensed under the Mozilla Public License (MPLv2)
 //
-/*global define, window, document */
-
+/**
+ * @module converse-dragresize
+ */
 import "converse-chatview";
 import "converse-controlbox";
 import converse from "@converse/headless/converse-core";

src/converse-fullscreen.js

@@ -4,7 +4,9 @@
 // Copyright (c) JC Brand <jc@opkode.com>
 // Licensed under the Mozilla Public License (MPLv2)
 //
-
+/**
+ * @module converse-fullscreen
+ */
 import "@converse/headless/converse-muc";
 import "converse-chatview";
 import "converse-controlbox";

src/converse-headline.js

@@ -3,7 +3,9 @@
 //
 // Copyright (c) 2019, Jan-Carel Brand <jc@opkode.com>
 // Licensed under the Mozilla Public License (MPLv2)
-
+/**
+ * @module converse-headline
+ */
 import "converse-chatview";
 import converse from "@converse/headless/converse-core";
 import tpl_chatbox from "templates/chatbox.html";

src/converse-mam-views.js

@@ -4,8 +4,11 @@
 // Copyright (c) 2012-2019, Jan-Carel Brand <jc@opkode.com>
 // Licensed under the Mozilla Public License (MPLv2)
 //
-// Views for XEP-0313 Message Archive Management
-
+/**
+ * @module converse-mam-views
+ * @description
+ * Views for XEP-0313 Message Archive Management
+ */
 import converse from "@converse/headless/converse-core";
 import { debounce } from 'lodash'
 

src/converse-message-view.js

@@ -3,7 +3,9 @@
 //
 // Copyright (c) 2013-2019, the Converse.js developers
 // Licensed under the Mozilla Public License (MPLv2)
-
+/**
+ * @module converse-message-view
+ */
 import URI from "urijs";
 import converse from  "@converse/headless/converse-core";
 import filesize from "filesize";

src/converse-minimize.js

@@ -3,7 +3,9 @@
 //
 // Copyright (c) 2013-2019, Jan-Carel Brand <jc@opkode.com>
 // Licensed under the Mozilla Public License (MPLv2)
-
+/**
+ * @module converse-minimize
+ */
 import "converse-chatview";
 import BrowserStorage from "backbone.browserStorage";
 import { Overview } from "backbone.overview";

src/converse-modal.js

@@ -3,7 +3,9 @@
 //
 // Copyright (c) 2013-2019, the Converse.js developers
 // Licensed under the Mozilla Public License (MPLv2)
-
+/**
+ * @module converse-modal
+ */
 import "backbone.vdomview";
 import bootstrap from "bootstrap.native";
 import converse from "@converse/headless/converse-core";

src/converse-muc-views.js

@@ -4,8 +4,11 @@
 // Copyright (c) 2013-2019, the Converse.js developers
 // Licensed under the Mozilla Public License (MPLv2)
 //
-// XEP-0045 Multi-User Chat Views
-
+/**
+ * @module converse-muc-views
+ * @description
+ * XEP-0045 Multi-User Chat Views
+ */
 import "converse-modal";
 import "backbone.vdomview";
 import BrowserStorage from "backbone.browserStorage";

src/converse-notification.js

@@ -4,8 +4,9 @@
 // Copyright (c) 2013-2019, JC Brand <jc@opkode.com>
 // Licensed under the Mozilla Public License (MPLv2)
 //
-/*global define */
-
+/**
+ * @module converse-notification
+ */
 import converse from "@converse/headless/converse-core";
 
 const { Strophe, _, sizzle } = converse.env,

src/converse-omemo.js

@@ -4,8 +4,10 @@
 // Copyright (c) 2013-2019, the Converse.js developers
 // Licensed under the Mozilla Public License (MPLv2)
 
-/* global libsignal, ArrayBuffer, parseInt, crypto */
-
+/* global libsignal, ArrayBuffer */
+/**
+ * @module converse-omemo
+ */
 import BrowserStorage from "backbone.browserStorage";
 import converse from "@converse/headless/converse-core";
 import tpl_toolbar_omemo from "templates/toolbar_omemo.html";

src/converse-profile.js

@@ -4,8 +4,9 @@
 // Copyright (c) 2013-2017, Jan-Carel Brand <jc@opkode.com>
 // Licensed under the Mozilla Public License (MPLv2)
 //
-/*global define */
-
+/**
+ * @module converse-profile
+ */
 import "@converse/headless/converse-vcard";
 import "converse-modal";
 import _FormData from "formdata-polyfill";

src/converse-push.js

@@ -3,12 +3,12 @@
 //
 // Copyright (c) 2013-2019, the Converse.js developers
 // Licensed under the Mozilla Public License (MPLv2)
-
-/* This is a Converse.js plugin which add support for registering
+/**
+ * @module converse-push
+ * @description
+ * Converse.js plugin which add support for registering
  * an "App Server" as defined in  XEP-0357
  */
-
-
 import converse from "@converse/headless/converse-core";
 
 const { Strophe, $iq, _ } = converse.env;

src/converse-register.js

@@ -4,12 +4,12 @@
 // Copyright (c) 2012-2017, Jan-Carel Brand <jc@opkode.com>
 // Licensed under the Mozilla Public License (MPLv2)
 //
-/*global define */
-
-/* This is a Converse.js plugin which add support for in-band registration
+/**
+ * @module converse-register
+ * @description
+ * This is a Converse.js plugin which add support for in-band registration
  * as specified in XEP-0077.
  */
-
 import "converse-controlbox";
 import converse from "@converse/headless/converse-core";
 import tpl_form_input from "templates/form_input.html";

src/converse-roomslist.js

@@ -3,8 +3,10 @@
 //
 // Copyright (c) 2013-2019, Jan-Carel Brand <jc@opkode.com>
 // Licensed under the Mozilla Public License (MPLv2)
-
-/* This is a non-core Converse.js plugin which shows a list of currently open
+/**
+ * @module converse-roomslist
+ * @description
+ * Converse.js plugin which shows a list of currently open
  * rooms in the "Rooms Panel" of the ControlBox.
  */
 import BrowserStorage from "backbone.browserStorage";

src/converse-rosterview.js

@@ -3,7 +3,9 @@
 //
 // Copyright (c) 2013-2019, the Converse.js developers
 // Licensed under the Mozilla Public License (MPLv2)
-
+/**
+ * @module converse-rosterview
+ */
 import "@converse/headless/converse-chatboxes";
 import "@converse/headless/converse-roster";
 import "converse-modal";

src/converse-singleton.js

@@ -3,13 +3,11 @@
 //
 // Copyright (c) 2013-2019, the Converse.js developers
 // Licensed under the Mozilla Public License (MPLv2)
-
-/* converse-singleton
- * ******************
- *
+/**
+ * @module converse-singleton
+ * @description
  * A plugin which restricts Converse to only one chat.
  */
-
 import converse from "@converse/headless/converse-core";
 
 const { _, Strophe } = converse.env;

src/converse-uniview.js

@@ -3,10 +3,9 @@
 //
 // Copyright (c) 2013-2018, the Converse.js developers
 // Licensed under the Mozilla Public License (MPLv2)
-
-/* converse-uniview
- * ****************
- *
+/**
+ * @module converse-uniview
+ * @description
  * A plugin which ensures that only one chat (private or groupchat) is
  * visible at any one time. All other ongoing chats are hidden and kept in the
  * background.
@@ -14,7 +13,6 @@
  * This plugin makes sense in mobile, embedded or fullscreen chat environments
  * (as configured by the `view_mode` setting).
  */
-
 import "converse-chatview";
 import converse from "@converse/headless/converse-core";
 

src/headless/converse-bookmarks.js

@@ -4,12 +4,11 @@
 // Copyright (c) 2019, Jan-Carel Brand <jc@opkode.com>
 // Licensed under the Mozilla Public License (MPLv2)
 //
-/*global define */
-
-/* This is a Converse.js plugin which adds views for bookmarks specified
- * in XEP-0048.
+/**
+ * @module converse-bookmarks
+ * @description
+ * Converse.js plugin which adds views for bookmarks specified in XEP-0048.
  */
-
 import BrowserStorage from "backbone.browserStorage";
 import converse from "@converse/headless/converse-core";
 import muc from "@converse/headless/converse-muc";

src/headless/converse-bosh.js

@@ -3,9 +3,11 @@
 //
 // Copyright (c) The Converse.js developers
 // Licensed under the Mozilla Public License (MPLv2)
-
-/* This is a Converse.js plugin which add support for XEP-0206: XMPP Over BOSH */
-
+/**
+ * @module converse-bosh
+ * @description
+ * Converse.js plugin which add support for XEP-0206: XMPP Over BOSH
+ */
 import BrowserStorage from "backbone.browserStorage";
 import converse from "./converse-core";
 

src/headless/converse-caps.js

@@ -3,7 +3,9 @@
 //
 // Copyright (c) 2013-2019, the Converse.js developers
 // Licensed under the Mozilla Public License (MPLv2)
-
+/**
+ * @module converse-caps
+ */
 import SHA1 from 'strophe.js/src/sha1';
 import converse from "@converse/headless/converse-core";
 

src/headless/converse-chatboxes.js

@@ -3,7 +3,9 @@
 //
 // Copyright (c) 2012-2019, the Converse.js developers
 // Licensed under the Mozilla Public License (MPLv2)
-
+/**
+ * @module converse-chatboxes
+ */
 import "./utils/emoji";
 import "./utils/form";
 import BrowserStorage from "backbone.browserStorage";

src/headless/converse-core.js

@@ -3,7 +3,9 @@
 //
 // Copyright (c) 2013-2019, the Converse.js developers
 // Licensed under the Mozilla Public License (MPLv2)
-
+/**
+ * @module converse-core
+ */
 import * as bosh from 'strophe.js/src/bosh';
 import * as strophe from 'strophe.js/src/core';
 import * as websocket from 'strophe.js/src/websocket';

src/headless/converse-disco.js

@@ -3,9 +3,11 @@
 //
 // Copyright (c) 2013-2019, the Converse developers
 // Licensed under the Mozilla Public License (MPLv2)
-
-/* This is a Converse plugin which add support for XEP-0030: Service Discovery */
-
+/**
+ * @module converse-disco
+ * @description
+ * Converse plugin which add support for XEP-0030: Service Discovery
+ */
 import BrowserStorage from "backbone.browserStorage";
 import converse from "./converse-core";
 import sizzle from "sizzle";

src/headless/converse-mam.js

@@ -4,14 +4,16 @@
 // Copyright (c) Jan-Carel Brand <jc@opkode.com>
 // Licensed under the Mozilla Public License (MPLv2)
 //
-// XEP-0313 Message Archive Management
-
+/**
+ * @module converse-mam
+ * @description
+ * XEP-0313 Message Archive Management
+ */
 import "./converse-disco";
 import "./converse-rsm";
 import converse from "./converse-core";
 import sizzle from "sizzle";
 
-
 const { Strophe, $iq, $build, _, dayjs } = converse.env;
 const u = converse.env.utils;
 

src/headless/converse-muc.js

@@ -4,8 +4,11 @@
 // Copyright (c) 2013-2019, the Converse.js developers
 // Licensed under the Mozilla Public License (MPLv2)
 //
-// XEP-0045 Multi-User Chat
-
+/**
+ * @module converse-muc
+ * @description
+ * Implements the non-view logic for XEP-0045 Multi-User Chat
+ */
 import "./converse-disco";
 import "./utils/emoji";
 import "./utils/muc";
@@ -928,7 +931,7 @@ converse.plugins.add('converse-muc', {
              * been received.
              */
             autoConfigureChatRoom () {
-                return new Promise(async (resolve, reject) => {
+                return new Promise(async (resolve, reject) => { /* eslint-disable-line no-async-promise-executor */
                     const stanza = await this.fetchRoomConfiguration();
                     const fields = sizzle('field', stanza);
                     const configArray = fields.map(f => this.addFieldValue(f))

src/headless/converse-ping.js

@@ -3,11 +3,12 @@
 //
 // Copyright (c) 2013-2019, the Converse.js developers
 // Licensed under the Mozilla Public License (MPLv2)
-
-/* This is a Converse.js plugin which add support for application-level pings
+/**
+ * @module converse-ping
+ * @description
+ * Converse.js plugin which add support for application-level pings
  * as specified in XEP-0199 XMPP Ping.
  */
-
 import converse from "./converse-core";
 
 // Strophe methods for building stanzas

src/headless/converse-pubsub.js

@@ -3,7 +3,9 @@
 //
 // Copyright (c) 2019, the Converse.js developers
 // Licensed under the Mozilla Public License (MPLv2)
-
+/**
+ * @module converse-pubsub
+ */
 import "./converse-disco";
 import converse from "./converse-core";
 

src/headless/converse-roster.js

@@ -3,7 +3,9 @@
 //
 // Copyright (c) 2013-2019, the Converse.js developers
 // Licensed under the Mozilla Public License (MPLv2)
-
+/**
+ * @module converse-roster
+ */
 import BrowserStorage from "backbone.browserStorage";
 import converse from "@converse/headless/converse-core";
 

src/headless/converse-rsm.js

@@ -7,8 +7,11 @@
 // Some code taken from the Strophe RSM plugin, licensed under the MIT License
 // Copyright 2006-2017 Strophe (https://github.com/strophe/strophejs)
 //
-// XEP-0059 Result Set Management
-
+/**
+ * @module converse-rsm
+ * @description
+ * XEP-0059 Result Set Management
+ */
 import converse from "./converse-core";
 
 const { Strophe, $build } = converse.env;

src/headless/converse-smacks.js

@@ -3,9 +3,12 @@
 //
 // Copyright (c) The Converse.js developers
 // Licensed under the Mozilla Public License (MPLv2)
-
-/* This is a Converse.js plugin which add support for XEP-0198: Stream Management */
-
+//
+/**
+ * @module converse-smacks
+ * @description
+ * Converse.js plugin which adds support for XEP-0198: Stream Management
+ */
 import converse from "./converse-core";
 
 const { Strophe, $build, _ } = converse.env;

src/headless/converse-vcard.js

@@ -3,7 +3,9 @@
 //
 // Copyright (c) 2013-2019, the Converse.js developers
 // Licensed under the Mozilla Public License (MPLv2)
-
+/**
+ * @module converse-vcard
+ */
 import BrowserStorage from "backbone.browserStorage";
 import converse from "./converse-core";
 import tpl_vcard from "./templates/vcard.html";

src/headless/i18n.js

@@ -6,8 +6,6 @@
 // Copyright (c) 2013-2017, Jan-Carel Brand <jc@opkode.com>
 // Licensed under the Mozilla Public License (MPLv2)
 //
-/*global define */
-
 import 'dayjs/locale/af';
 import 'dayjs/locale/ar';
 import 'dayjs/locale/bg';

src/headless/lodash.noconflict.js

-/*global define */
 define(['lodash'], function (_) {
     return _.noConflict();
 });

src/headless/utils/core.js

@@ -6,8 +6,6 @@
 // Copyright (c) 2013-2019, Jan-Carel Brand <jc@opkode.com>
 // Licensed under the Mozilla Public License (MPLv2)
 //
-/*global escape, Uint8Array */
-
 import * as strophe from 'strophe.js/src/core';
 import Backbone from "backbone";
 import Promise from "es6-promise/dist/es6-promise.auto";

src/headless/utils/muc.js

@@ -6,9 +6,7 @@
 // Copyright (c) 2013-2019, Jan-Carel Brand <jc@opkode.com>
 // Licensed under the Mozilla Public License (MPLv2)
 //
-/*global escape, Jed */
-
-
+/*global Jed */
 import converse from "@converse/headless/converse-core";
 import u from "./core";
 

src/jquery-stub.js

-/*global define */
 define([], function () {
     return Object;
 });

src/underscore-shim.js

-/*global define */
 define(['lodash'], function (_) {
     return _.noConflict();
 });