New options for launching local doors via the abracadabra module

WHATSNEW.md

@@ -14,7 +14,8 @@ This document attempts to track **major** changes and additions in ENiGMA½. For
 * Many additional backward-compatible bug fixes since the first release of 0.0.12-beta. See the [project repository](https://github.com/NuSkooler/enigma-bbs) for more information.
 * Deprecated Gopher's `messageConferences` configuration key in favor of a easier to deal with `exposedConfAreas` allowing wildcards and exclusions. See [Gopher](./docs/servers/contentservers/gopher.md).
 * NNTP write (aka POST) access support for authenticated users over TLS.
-* [Advanced MCI formatting](./docs/art/mci.md#mci-formatting)
+* [Advanced MCI formatting](./docs/art/mci.md#mci-formatting)!
+* Additional options in the `abracadabra` module for launching doors. See [Local Doors](./docs/modding/local-doors.md)
 
 ## 0.0.12-beta
 * The `master` branch has become mainline. What this means to users is `git pull` will always give you the latest and greatest. Make sure to read [Updating](./docs/admin/updating.md) and keep an eye on `WHATSNEW.md` (this file) and [UPGRADE](UPGRADE.md)! See also [ticket #276](https://github.com/NuSkooler/enigma-bbs/issues/276).

core/abracadabra.js

@@ -9,6 +9,7 @@ const ansi = require('./ansi_term.js');
 const { Errors } = require('./enig_error.js');
 const { trackDoorRunBegin, trackDoorRunEnd } = require('./door_util.js');
 const Log = require('./logger').log;
+const Config = require('./config.js').get;
 
 //  deps
 const async = require('async');
@@ -181,6 +182,8 @@ exports.getModule = class AbracadabraModule extends MenuModule {
         const exeInfo = {
             name: this.config.name,
             cmd: this.config.cmd,
+            preCmd: this.config.preCmd,
+            preCmdArgs: this.config.preCmdArgs,
             cwd: this.config.cwd || paths.dirname(this.config.cmd),
             args: this.config.args,
             io: this.config.io || 'stdio',
@@ -189,11 +192,28 @@ exports.getModule = class AbracadabraModule extends MenuModule {
             env: this.config.env,
         };
 
+        exeInfo.dropFileDir = DropFile.dropFileDirectory(
+            Config().paths.dropFiles,
+            this.client
+        );
+        exeInfo.userAreaDir = paths.join(
+            exeInfo.dropFileDir,
+            this.client.user.getSanitizedName(),
+            this.config.name.toLowerCase()
+        );
+
         if (this.dropFile) {
             exeInfo.dropFile = this.dropFile.fileName;
             exeInfo.dropFilePath = this.dropFile.fullPath;
         }
 
+        this._makeDropDirs([exeInfo.dropFileDir, exeInfo.userAreaDir], err => {
+            if (err) {
+                Log.warn(
+                    `Failed creating directory ${exeInfo.dropFilePath}: ${err.message}`
+                );
+            }
+
             const doorTracking = trackDoorRunBegin(this.client, this.config.name);
 
             this.doorInstance.run(exeInfo, err => {
@@ -228,7 +248,10 @@ exports.getModule = class AbracadabraModule extends MenuModule {
                 //
                 this.client.term.rawWrite(
                     ansi.normal() +
-                    ansi.goto(this.client.term.termHeight, this.client.term.termWidth) +
+                        ansi.goto(
+                            this.client.term.termHeight,
+                            this.client.term.termWidth
+                        ) +
                         ansi.setScrollRegion() +
                         ansi.goto(this.client.term.termHeight, 0) +
                         '\r\n\r\n'
@@ -236,6 +259,17 @@ exports.getModule = class AbracadabraModule extends MenuModule {
 
                 this.autoNextMenu();
             });
+        });
+    }
+
+    _makeDropDirs(dirs, cb) {
+        async.forEach(
+            dirs,
+            (dir, nextDir) => {
+                fs.mkdir(dir, { recursive: true }, nextDir);
+            },
+            cb
+        );
     }
 
     leave() {

core/door.js

@@ -11,6 +11,7 @@ const decode = require('iconv-lite').decode;
 const createServer = require('net').createServer;
 const paths = require('path');
 const _ = require('lodash');
+const async = require('async');
 
 module.exports = class Door {
     constructor(client) {
@@ -67,29 +68,70 @@ module.exports = class Door {
         const formatObj = {
             dropFile: exeInfo.dropFile,
             dropFilePath: exeInfo.dropFilePath,
+            dropFileDir: exeInfo.dropFileDir,
+            userAreaDir: exeInfo.userAreaDir,
             node: exeInfo.node.toString(),
             srvPort: this.sockServer ? this.sockServer.address().port.toString() : '-1',
             userId: this.client.user.userId.toString(),
             userName: this.client.user.getSanitizedName(),
             userNameRaw: this.client.user.username,
+            termWidth: this.client.term.termWidth,
+            termHeight: this.client.term.termHeight,
             cwd: cwd,
         };
 
         const args = exeInfo.args.map(arg => stringFormat(arg, formatObj));
 
+        const spawnOptions = {
+            cols: this.client.term.termWidth,
+            rows: this.client.term.termHeight,
+            cwd: cwd,
+            env: exeInfo.env,
+            encoding: null, //  we want to handle all encoding ourself
+        };
+
+        async.series(
+            [
+                callback => {
+                    if (!_.isString(exeInfo.preCmd)) {
+                        return callback(null);
+                    }
+
+                    const preCmdArgs = (exeInfo.preCmdArgs || []).map(arg =>
+                        stringFormat(arg, formatObj)
+                    );
+
+                    this.client.log.info(
+                        { cmd: exeInfo.preCmd, args: preCmdArgs },
+                        `Executing external door pre-command (${exeInfo.name})`
+                    );
+
+                    try {
+                        const prePty = pty.spawn(
+                            exeInfo.preCmd,
+                            preCmdArgs,
+                            spawnOptions
+                        );
+
+                        prePty.once('exit', exitCode => {
+                            this.client.log.info(
+                                { exitCode: exitCode },
+                                'Door pre-command exited'
+                            );
+                            return callback(null);
+                        });
+                    } catch (e) {
+                        return callback(e);
+                    }
+                },
+                callback => {
                     this.client.log.info(
                         { cmd: exeInfo.cmd, args, io: this.io },
                         `Executing external door (${exeInfo.name})`
                     );
 
                     try {
-            this.doorPty = pty.spawn(exeInfo.cmd, args, {
+                        this.doorPty = pty.spawn(exeInfo.cmd, args, spawnOptions);
-                cols: this.client.term.termWidth,
-                rows: this.client.term.termHeight,
-                cwd: cwd,
-                env: exeInfo.env,
-                encoding: null, //  we want to handle all encoding ourself
-            });
                     } catch (e) {
                         return cb(e);
                     }
@@ -100,7 +142,8 @@ module.exports = class Door {
                     Events.once(Events.getSystemEvents().ClientDisconnected, evt => {
                         if (
                             this.doorPty &&
-                this.client.session.uniqueId === _.get(evt, 'client.session.uniqueId')
+                            this.client.session.uniqueId ===
+                                _.get(evt, 'client.session.uniqueId')
                         ) {
                             this.client.log.info(
                                 { pid: this.doorPty.pid },
@@ -150,8 +193,14 @@ module.exports = class Door {
                         this.doorPty.removeAllListeners();
                         delete this.doorPty;
 
-            return cb(null);
+                        return callback(null);
                     });
+                },
+            ],
+            () => {
+                return cb(null);
+            }
+        );
     }
 
     doorDataHandler(data) {

core/dropfile.js

@@ -34,8 +34,15 @@ module.exports = class DropFile {
         this.baseDir = baseDir;
     }
 
+    static dropFileDirectory(baseDir, client) {
+        return paths.join(baseDir, 'node' + client.node);
+    }
+
     get fullPath() {
-        return paths.join(this.baseDir, 'node' + this.client.node, this.fileName);
+        return paths.join(
+            DropFile.dropFileDirectory(this.baseDir, this.client),
+            this.fileName
+        );
     }
 
     get fileName() {

docs/_docs/modding/local-doors.md

@@ -16,14 +16,16 @@ The `abracadabra` `config` block can contain the following members:
 | Item | Required | Description |
 |------|----------|-------------|
 | `name` | :+1: | Used as a key for tracking number of clients using a particular door. |
-| `dropFileType` | :-1: | Specifies the type of dropfile to generate (See **Dropfile Types** below). Can be omitted or set to `none`. |
+| `dropFileType` | :-1: | Specifies the type of dropfile to generate (See [Dropfile Types](#dropfile-types) below). Can be omitted or set to `none`. |
 | `cmd` | :+1: | Path to executable to launch. |
-| `args` | :-1: | Array of argument(s) to pass to `cmd`. See **Argument Variables** below for information on variables that can be used here.
+| `args` | :-1: | Array of argument(s) to pass to `cmd`. See [Argument Variables](#argument-variables) below for information on variables that can be utilized here. |
+| `preCmd` | :-1: | Path to a pre-command executable or script to launch. Executes before `cmd`. |
+| `preCmdArgs` | :-1: | Array of argument(s) to pass to `preCmd`. See [Argument Variables](#argument-variables) below for information on variables that can be utilized here. |
 | `cwd` | :-1: | Sets the Current Working Directory (CWD) for `cmd`. Defaults to the directory of `cmd`. |
 | `env` | :-1: | Sets the environment. Supplied in the form of an map: `{ SOME_VAR: "value" }`
 | `nodeMax` | :-1: | Max number of nodes that can access this door at once. Uses `name` as a tracking key. |
 | `tooManyArt` | :-1: | Art spec to display if too many instances are already in use. |
-| `io` | :-1: | How to process input/output (I/O). Can be `stdio` or `socket`. When using `stdio`, I/O is handled via standard stdin/stdout. When using `socket` a temporary socket server is spawned that can be connected back to. The server listens on localhost on `{srvPort}` (See **Argument Variables** below for more information). Default value is `stdio`. |
+| `io` | :-1: | How to process input/output (I/O). Can be `stdio` or `socket`. When using `stdio`, I/O is handled via standard stdin/stdout. When using `socket` a temporary socket server is spawned that can be connected back to. The server listens on localhost on `{srvPort}` (See [Argument Variables](#argument-variables) below for more information). Default value is `stdio`. |
 | `encoding` | :-1: | Sets the **door's** encoding. Defaults to `cp437`. Linux binaries often produce `utf8`. |
 
 #### Dropfile Types
@@ -31,23 +33,28 @@ Dropfile types specified by `dropFileType`:
 
 | Value | Description |
 |-------|-------------|
+| `none` | No door file is needed |
 | `DOOR` | [DOOR.SYS](https://web.archive.org/web/20160325192739/http://goldfndr.home.mindspring.com/dropfile/doorsys.htm)
 | `DOOR32` | [DOOR32.SYS](https://raw.githubusercontent.com/NuSkooler/ansi-bbs/master/docs/dropfile_formats/door32_sys.txt)
 | `DORINFO` | [DORINFOx.DEF](https://web.archive.org/web/20160321190038/http://goldfndr.home.mindspring.com/dropfile/dorinfo.htm)
 
 #### Argument Variables
-The following variables may be used in `args` entries:
+The following variables may be used in `args` and `preCmdArgs` entries:
 
 | Variable | Description | Example |
 |----------|-------------|---------|
 | `{node}` | Current node number. | `1` |
 | `{dropFile}` | Dropfile _filename_ only. | `DOOR.SYS` |
 | `{dropFilePath}` | Full path to generated dropfile. The system places dropfiles in the path set by `paths.dropFiles` in `config.hjson`. | `C:\enigma-bbs\drop\node1\DOOR.SYS` |
+| `{dropFileDir}` | Full path to **directory** containing the generated dropfile. | `/home/enigma-bbs/drop/node1/` |
+| `{userAreaDir}` | Full path to a **directory** safe for user-specific save files/etc. | `/home/enigma-bbs/drop/node1/NuSkooler/lord/` |
 | `{userId}` | Current user ID. | `420` |
 | `{userName}` | [Sanitized](https://www.npmjs.com/package/sanitize-filename) username. Safe for filenames, etc. If the full username is sanitized away, this will resolve to something like "user_1234". | `izard` |
 | `{userNameRaw}` | _Raw_ username. May not be safe for filenames! | `\/\/izard` |
 | `{srvPort}` | Temporary server port when `io` is set to `socket`. | `1234` |
 | `{cwd}` | Current Working Directory. | `/home/enigma-bbs/doors/foo/` |
+| `{termHeight}` | Current client term height | `25` |
+| `{termWidth}` | Current client term width | `80` |
 
 Example `args` member using some variables described above:
 ```hjson