imapkit 4.0.3 → 4.1.0

package/dist/cjs/plugins/multisearch.js

@@ -0,0 +1,263 @@
+"use strict";
+/**
+ * @help Adds MULTISEARCH [RFC7377] capability, loads ESEARCH as well
+ * @help ESEARCH IN (mailboxes "a" subtree "b" personal ...) RETURN (...) searches several mailboxes, also in the authenticated state
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = multisearchPlugin;
+const esearch_js_1 = __importDefault(require("./esearch.js"));
+const esearch_js_2 = require("../esearch.js");
+const search_js_1 = __importDefault(require("../commands/handlers/search.js"));
+const search_js_2 = require("../commands/handlers/search.js");
+const command_states_js_1 = require("../command-states.js");
+const arguments_js_1 = require("../arguments.js");
+// RFC 5465 section 6 filter-mailboxes, as changed by RFC 7377 section 2.2. The value tells if a mailbox name
+// or a list of names follows (one-or-more-mailbox)
+const FILTERS = {
+    SELECTED: false,
+    INBOXES: false,
+    PERSONAL: false,
+    SUBSCRIBED: false,
+    SUBTREE: true,
+    'SUBTREE-ONE': true,
+    MAILBOXES: true
+};
+/**
+ * Parses the source options (RFC 7377 section 4): esearch-source-opts = "IN" SP "(" source-mbox [SP "(" scope-options ")"] ")",
+ * source-mbox = filter-mailboxes *(SP filter-mailboxes)
+ *
+ * @param {Object} connection IMAP connection, converts the mailbox names to storage names
+ * @param {Array} list Parsed list after IN
+ * @return {Array} list of `{ filter, names }`
+ */
+function parseSources(connection, list) {
+    if (!Array.isArray(list) || !list.length) {
+        throw (0, search_js_2.badError)('IN expects a parenthesized list of mailbox specifiers');
+    }
+    const sources = [];
+    for (let i = 0; i < list.length; i++) {
+        const item = list[i];
+        if (Array.isArray(item)) {
+            // scope-options, RFC 7377 defines none
+            throw (0, search_js_2.badError)('Unknown ESEARCH scope option');
+        }
+        const filter = item && item.type === 'ATOM' ? String(item.value).toUpperCase() : '';
+        if (!Object.hasOwn(FILTERS, filter)) {
+            // "selected-delayed" is not valid here (RFC 7377 section 2.2)
+            throw (0, search_js_2.badError)('Invalid mailbox specifier' + (filter ? ' ' + item.value : ''));
+        }
+        const source = { filter, names: [] };
+        if (FILTERS[filter]) {
+            const value = list[++i];
+            const names = Array.isArray(value) ? value : [value];
+            // RFC 5465 section 8: one-or-more-mailbox = mailbox / many-mailboxes, many-mailboxes = "(" mailbox *(SP mailbox) ")"
+            if (!names.length || !names.every(arguments_js_1.isAstring)) {
+                throw (0, search_js_2.badError)(filter.toLowerCase() + ' expects a mailbox name or a list of mailbox names');
+            }
+            names.forEach(name => source.names.push(connection.importMailboxName(name.value)));
+        }
+        sources.push(source);
+    }
+    return sources;
+}
+/**
+ * Parses the arguments of ESEARCH (RFC 7377 section 4): esearch = "ESEARCH" [SP esearch-source-opts] [SP search-return-opts] SP search-program
+ *
+ * @return {Object} `{ sources, attributes }`, sources is null when IN was not used, attributes hold the result options and the search program
+ */
+function splitArguments(connection, attributes) {
+    const args = attributes || [];
+    if ((0, arguments_js_1.isAtom)(args[0], 'IN')) {
+        return { sources: parseSources(connection, args[1]), attributes: args.slice(2) };
+    }
+    return { sources: null, attributes: args };
+}
+function multisearchPlugin(server) {
+    // RFC 7377 section 2.1: the ESEARCH command answers with ESEARCH responses (RFC 4731)
+    (0, esearch_js_1.default)(server);
+    server.registerCapability('MULTISEARCH');
+    const isSelectable = (mailbox) => !!mailbox && mailbox.flags.indexOf('\\Noselect') < 0;
+    // every mailbox, INBOX first
+    const allMailboxes = () => {
+        const list = Object.keys(server.folderCache).map(path => server.folderCache[path]);
+        return list.sort((a, b) => (a.path === 'INBOX' ? -1 : b.path === 'INBOX' ? 1 : 0));
+    };
+    // a mailbox and the mailboxes below it, `depth` levels down (RFC 7377 section 2.2). Visited
+    // mailboxes are not walked again, which also defends against loops in the hierarchy
+    const walkSubtree = (mailbox, depth, visit) => {
+        if (!visit(mailbox) || !depth || !mailbox.folders) {
+            return;
+        }
+        const folders = mailbox.folders;
+        Object.keys(folders).forEach(name => walkSubtree(folders[name], depth - 1, visit));
+    };
+    /**
+     * Resolves the source options to the mailboxes to search, in the order they were given. Mailboxes
+     * that do not exist, are not selectable or that the user may not search (server.searchAccessChecks, ACL)
+     * are ignored (RFC 7377 section 2.2)
+     */
+    const resolveMailboxes = (connection, sources) => {
+        const result = [];
+        const seen = new Set();
+        // `named` is true for a mailbox that the client gave the name of
+        const add = (mailbox, named) => {
+            // the client SHOULD NOT name a mailbox twice, the duplicates are removed (RFC 7377 section 2.2)
+            if (!mailbox || seen.has(mailbox) || !isSelectable(mailbox)) {
+                return;
+            }
+            if (server.searchAccessChecks.every(check => check(connection, mailbox, !!named))) {
+                seen.add(mailbox);
+                result.push(mailbox);
+            }
+        };
+        sources.forEach(source => {
+            switch (source.filter) {
+                case 'SELECTED':
+                    add(connection.selectedMailbox, true);
+                    break;
+                case 'INBOXES':
+                    // RFC 5465 section 6.3: messages are only delivered to INBOX
+                    add(server.getMailbox('INBOX'), false);
+                    break;
+                case 'PERSONAL':
+                    allMailboxes()
+                        .filter(mailbox => server.isPersonal(mailbox))
+                        .forEach(mailbox => add(mailbox, false));
+                    break;
+                case 'SUBSCRIBED':
+                    // RFC 5465 section 6.4
+                    allMailboxes()
+                        .filter(mailbox => mailbox.subscribed)
+                        .forEach(mailbox => add(mailbox, false));
+                    break;
+                case 'MAILBOXES':
+                    source.names.forEach((name) => add(server.getMailbox(name), true));
+                    break;
+                default: {
+                    const depth = source.filter === 'SUBTREE' ? Infinity : 1;
+                    const visited = new Set();
+                    source.names.forEach((name) => {
+                        const mailbox = server.getMailbox(name);
+                        if (mailbox) {
+                            walkSubtree(mailbox, depth, child => {
+                                if (visited.has(child)) {
+                                    return false;
+                                }
+                                visited.add(child);
+                                // the named mailbox itself, not the ones below it
+                                add(child, child === mailbox);
+                                return true;
+                            });
+                        }
+                    });
+                }
+            }
+        });
+        return result;
+    };
+    const handler = (connection, parsed, data, callback) => {
+        const fail = (status, text) => {
+            connection.sendStatus(parsed, data, status, text, false, 'ESEARCH FAILED');
+            return callback();
+        };
+        let sources;
+        let options = new Map();
+        let params;
+        try {
+            const split = splitArguments(connection, parsed.attributes);
+            sources = split.sources || [{ filter: 'SELECTED', names: [] }];
+            let attributes = split.attributes;
+            if ((0, arguments_js_1.isAtom)(attributes[0], 'RETURN')) {
+                options = parsed.searchReturn = server.parseSearchReturn(attributes[1], connection, parsed);
+                attributes = attributes.slice(2);
+            }
+            if (!attributes.length) {
+                throw (0, search_js_2.badError)('ESEARCH expects search criteria');
+            }
+            params = (0, search_js_2.criteriaValues)(attributes);
+        }
+        catch (E) {
+            return fail('BAD', E.message);
+        }
+        const onlySelected = sources.every(source => source.filter === 'SELECTED');
+        // RFC 7377 section 2.2: "selected" needs the selected state
+        if (sources.some(source => source.filter === 'SELECTED') && !connection.selectedMailbox) {
+            return fail('BAD', 'No mailbox is selected');
+        }
+        // RFC 7377 section 2.2: SAVE is valid only if "selected" is the sole mailbox to search
+        if (options.has('SAVE') && !onlySelected) {
+            return fail('BAD', 'SAVE can only be used when searching the selected mailbox');
+        }
+        // RFC 7377 section 2.2: UPDATE applies to the selected mailbox only, and needs one
+        if (options.has('UPDATE') && !connection.selectedMailbox) {
+            return fail('BAD', 'UPDATE needs a selected mailbox');
+        }
+        const mailboxes = resolveMailboxes(connection, sources);
+        const results = [];
+        try {
+            // the criteria are checked even when no mailbox is searched
+            const searchMailbox = (mailbox) => {
+                if (mailbox && mailbox === connection.selectedMailbox) {
+                    return (0, search_js_1.default)(connection, connection.getSessionMessages(), params);
+                }
+                const messages = mailbox ? mailbox.messages : [];
+                return (0, search_js_1.default)(connection, messages, params, (range, isUid) => server.getMessageRange(messages, range, isUid));
+            };
+            if (!mailboxes.length) {
+                searchMailbox(connection.selectedMailbox || null);
+            }
+            mailboxes.forEach(mailbox => results.push({ mailbox, result: searchMailbox(mailbox) }));
+        }
+        catch (E) {
+            (0, search_js_2.sendSearchError)(connection, parsed, data, E, 'ESEARCH FAILED');
+            return callback();
+        }
+        const silent = server.isSilentReturn(options);
+        results.forEach(({ mailbox, result }) => {
+            // RFC 7377 section 2.1: one ESEARCH response per mailbox with matches, always with UIDs and the
+            // MAILBOX, TAG and UIDVALIDITY correlators, none for a mailbox without matches
+            if (!result.list.length || silent) {
+                return;
+            }
+            connection.send((0, esearch_js_2.buildEsearchResponse)(parsed.tag, true, result, options, mailbox), 'ESEARCH', parsed, data, Object.assign({}, result, { list: (0, esearch_js_2.selectReturned)(result.list, options) }));
+        });
+        const selected = results.find(entry => entry.mailbox === connection.selectedMailbox);
+        if (options.has('SAVE')) {
+            // SEARCHRES stores it once the tagged response tells if the command succeeded
+            parsed.searchresFound = selected ? (0, esearch_js_2.selectReturned)(selected.result.list, options) : [];
+        }
+        if (options.has('UPDATE') && selected) {
+            server.addSearchContext(connection, parsed, data, selected.result, true, selected.mailbox);
+        }
+        connection.sendStatus(parsed, data, 'OK', 'ESEARCH completed', false, 'ESEARCH');
+        return callback();
+    };
+    // RFC 7377 section 4: command-auth =/ esearch, command-select =/ esearch
+    server.setCommandHandler('ESEARCH', handler, { states: command_states_js_1.states.AUTHENTICATED, searchCriteria: 0 });
+    // RFC 3501 section 5.5: sequence numbers can only be in the search program
+    server.connectionHandlers.push((connection) => {
+        // the source options are taken off here, the ESEARCH plugin takes off the result options
+        const usesSequenceNumbers = connection.usesSequenceNumbers;
+        connection.usesSequenceNumbers = function (parsed) {
+            if ((parsed.command || '').toUpperCase() === 'ESEARCH' && (0, arguments_js_1.isAtom)((parsed.attributes || [])[0], 'IN')) {
+                parsed = Object.assign({}, parsed, { attributes: parsed.attributes.slice(2) });
+            }
+            return usesSequenceNumbers.call(this, parsed);
+        };
+    });
+}
+{
+    const defaultExport = exports.default;
+    if (defaultExport && (typeof defaultExport === 'function' || typeof defaultExport === 'object')) {
+        for (const key of Object.keys(exports)) {
+            if (key !== 'default' && !(key in defaultExport)) {
+                defaultExport[key] = exports[key];
+            }
+        }
+        Object.defineProperty(defaultExport, 'default', { value: defaultExport, enumerable: false, writable: true, configurable: true });
+        module.exports = defaultExport;
+    }
+}

package/dist/cjs/plugins/namespace.d.ts

@@ -0,0 +1,5 @@
+import type { IMAPServer } from '../types.js';
+/**
+ * @help Adds NAMESPACE [RFC2342] capability
+ */
+export default function namespacePlugin(server: IMAPServer): void;

package/dist/cjs/plugins/namespace.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = namespacePlugin;
+const command_states_js_1 = require("../command-states.js");
+/**
+ * @help Adds NAMESPACE [RFC2342] capability
+ */
+function namespacePlugin(server) {
+    // Register capability, always usable
+    server.registerCapability('NAMESPACE');
+    // Add NAMESPACE command
+    server.setCommandHandler('NAMESPACE', (connection, parsed, data, callback) => {
+        const list = {
+            personal: [],
+            user: [],
+            shared: []
+        };
+        Object.keys(server.storage).forEach(key => {
+            const ns = server.storage[key];
+            // INBOX is a mailbox, not a namespace
+            if (key === 'INBOX' || !ns) {
+                return;
+            }
+            if (Object.hasOwn(list, ns.type)) {
+                list[ns.type].push([connection.exportMailboxName(key), ns.separator]);
+            }
+        });
+        connection.send({
+            tag: '*',
+            command: 'NAMESPACE',
+            attributes: [list.personal.length ? list.personal : null, list.user.length ? list.user : null, list.shared.length ? list.shared : null]
+        }, 'NAMESPACE', parsed, data, list);
+        connection.send({
+            tag: parsed.tag,
+            command: 'OK',
+            attributes: [
+                {
+                    type: 'TEXT',
+                    value: 'Completed'
+                }
+            ]
+        }, 'NAMESPACE', parsed, data, list);
+        return callback();
+    }, { states: command_states_js_1.states.AUTHENTICATED, noArguments: true });
+}
+{
+    const defaultExport = exports.default;
+    if (defaultExport && (typeof defaultExport === 'function' || typeof defaultExport === 'object')) {
+        for (const key of Object.keys(exports)) {
+            if (key !== 'default' && !(key in defaultExport)) {
+                defaultExport[key] = exports[key];
+            }
+        }
+        Object.defineProperty(defaultExport, 'default', { value: defaultExport, enumerable: false, writable: true, configurable: true });
+        module.exports = defaultExport;
+    }
+}

package/dist/cjs/plugins/notify.d.ts

@@ -0,0 +1,2 @@
+import type { IMAPServer } from '../types.js';
+export default function notifyPlugin(server: IMAPServer): void;