enigma-bbs/core/file_transfer.js

/* jslint node: true */
'use strict';

//  enigma-bbs
const MenuModule        = require('./menu_module.js').MenuModule;
const Config            = require('./config.js').get;
const stringFormat      = require('./string_format.js');
const Errors            = require('./enig_error.js').Errors;
const DownloadQueue     = require('./download_queue.js');
const StatLog           = require('./stat_log.js');
const FileEntry         = require('./file_entry.js');
const Log               = require('./logger.js').log;
const Events            = require('./events.js');
const UserProps         = require('./user_property.js');
const SysProps          = require('./system_property.js');

//  deps
const async         = require('async');
const _             = require('lodash');
const pty           = require('node-pty');
const temptmp       = require('temptmp').createTrackedSession('transfer_file');
const paths         = require('path');
const fs            = require('graceful-fs');
const fse           = require('fs-extra');

//  some consts
const SYSTEM_EOL    = require('os').EOL;
const TEMP_SUFFIX   = 'enigtf-';    //  temp CWD/etc.

/*
    Notes
    -----------------------------------------------------------------------------

    See core/config.js for external protocol configuration


    Resources
    -----------------------------------------------------------------------------

    ZModem
        * http://gallium.inria.fr/~doligez/zmodem/zmodem.txt
        * https://github.com/protomouse/synchronet/blob/master/src/sbbs3/zmodem.c

*/

exports.moduleInfo = {
    name    : 'Transfer file',
    desc    : 'Sends or receives a file(s)',
    author  : 'NuSkooler',
};

exports.getModule = class TransferFileModule extends MenuModule {
    constructor(options) {
        super(options);

        this.config = this.menuConfig.config || {};

        //
        //  Most options can be set via extraArgs or config block
        //
        const config = Config();
        if(options.extraArgs) {
            if(options.extraArgs.protocol) {
                this.protocolConfig = config.fileTransferProtocols[options.extraArgs.protocol];
            }

            if(options.extraArgs.direction) {
                this.direction = options.extraArgs.direction;
            }

            if(options.extraArgs.sendQueue) {
                this.sendQueue = options.extraArgs.sendQueue;
            }

            if(options.extraArgs.recvFileName) {
                this.recvFileName = options.extraArgs.recvFileName;
            }

            if(options.extraArgs.recvDirectory) {
                this.recvDirectory = options.extraArgs.recvDirectory;
            }
        } else {
            if(this.config.protocol) {
                this.protocolConfig = config.fileTransferProtocols[this.config.protocol];
            }

            if(this.config.direction) {
                this.direction = this.config.direction;
            }

            if(this.config.sendQueue) {
                this.sendQueue = this.config.sendQueue;
            }

            if(this.config.recvFileName) {
                this.recvFileName = this.config.recvFileName;
            }

            if(this.config.recvDirectory) {
                this.recvDirectory = this.config.recvDirectory;
            }
        }

        this.protocolConfig = this.protocolConfig || config.fileTransferProtocols.zmodem8kSz;   //  try for *something*
        this.direction      = this.direction || 'send';
        this.sendQueue      = this.sendQueue || [];

        //  Ensure sendQueue is an array of objects that contain at least a 'path' member
        this.sendQueue = this.sendQueue.map(item => {
            if(_.isString(item)) {
                return { path : item };
            } else {
                return item;
            }
        });

        this.sentFileIds = [];
    }

    isSending() {
        return ('send' === this.direction);
    }

    restorePipeAfterExternalProc() {
        if(!this.pipeRestored) {
            this.pipeRestored = true;

            this.client.restoreDataHandler();
        }
    }

    sendFiles(cb) {
        //  assume *sending* can always batch
        //  :TODO: Look into this further
        const allFiles = this.sendQueue.map(f => f.path);
        this.executeExternalProtocolHandlerForSend(allFiles, err => {
            if(err) {
                this.client.log.warn( { files : allFiles, error : err.message }, 'Error sending file(s)' );
            } else {
                const sentFiles = [];
                this.sendQueue.forEach(f => {
                    f.sent = true;
                    sentFiles.push(f.path);

                });

                this.client.log.info( { sentFiles : sentFiles }, `Successfully sent ${sentFiles.length} file(s)` );
            }
            return cb(err);
        });
    }

    /*
    sendFiles(cb) {
        //  :TODO: built in/native protocol support

        if(this.protocolConfig.external.supportsBatch) {
            const allFiles = this.sendQueue.map(f => f.path);
            this.executeExternalProtocolHandlerForSend(allFiles, err => {
                if(err) {
                    this.client.log.warn( { files : allFiles, error : err.message }, 'Error sending file(s)' );
                } else {
                    const sentFiles = [];
                    this.sendQueue.forEach(f => {
                        f.sent = true;
                        sentFiles.push(f.path);

                    });

                    this.client.log.info( { sentFiles : sentFiles }, `Successfully sent ${sentFiles.length} file(s)` );
                }
                return cb(err);
            });
        } else {
            //  :TODO: we need to prompt between entries such that users can prepare their clients
            async.eachSeries(this.sendQueue, (queueItem, next) => {
                this.executeExternalProtocolHandlerForSend(queueItem.path, err => {
                    if(err) {
                        this.client.log.warn( { file : queueItem.path, error : err.message }, 'Error sending file' );
                    } else {
                        queueItem.sent = true;

                        this.client.log.info( { sentFile : queueItem.path }, 'Successfully sent file' );
                    }
                    return next(err);
                });
            }, err => {
                return cb(err);
            });
        }
    }
    */

    moveFileWithCollisionHandling(src, dst, cb) {
        //
        //  Move |src| -> |dst| renaming to file(1).ext, file(2).ext, etc.
        //  in the case of collisions.
        //
        const dstPath       = paths.dirname(dst);
        const dstFileExt    = paths.extname(dst);
        const dstFileSuffix = paths.basename(dst, dstFileExt);

        let renameIndex     = 0;
        let movedOk         = false;
        let tryDstPath;

        async.until(
            (callback) => callback(null, movedOk),  //  until moved OK
            (cb) => {
                if(0 === renameIndex) {
                    //  try originally supplied path first
                    tryDstPath = dst;
                } else {
                    tryDstPath = paths.join(dstPath, `${dstFileSuffix}(${renameIndex})${dstFileExt}`);
                }

                fse.move(src, tryDstPath, err => {
                    if(err) {
                        if('EEXIST' === err.code) {
                            renameIndex += 1;
                            return cb(null);    //  keep trying
                        }

                        return cb(err);
                    }

                    movedOk = true;
                    return cb(null, tryDstPath);
                });
            },
            (err, finalPath) => {
                return cb(err, finalPath);
            }
        );
    }

    recvFiles(cb) {
        this.executeExternalProtocolHandlerForRecv(err => {
            if(err) {
                return cb(err);
            }

            this.recvFilePaths = [];

            if(this.recvFileName) {
                //
                //  file name specified - we expect a single file in |this.recvDirectory|
                //  by the name of |this.recvFileName|
                //
                const recvFullPath = paths.join(this.recvDirectory, this.recvFileName);
                fs.stat(recvFullPath, (err, stats) => {
                    if(err) {
                        return cb(err);
                    }

                    if(!stats.isFile()) {
                        return cb(Errors.Invalid('Expected file entry in recv directory'));
                    }

                    this.recvFilePaths.push(recvFullPath);
                    return cb(null);
                });
            } else {
                //
                //  Blind Upload (recv): files in |this.recvDirectory| should be named appropriately already
                //
                fs.readdir(this.recvDirectory, (err, files) => {
                    if(err) {
                        return cb(err);
                    }

                    //  stat each to grab files only
                    async.each(files, (fileName, nextFile) => {
                        const recvFullPath = paths.join(this.recvDirectory, fileName);

                        fs.stat(recvFullPath, (err, stats) => {
                            if(err) {
                                this.client.log.warn('Failed to stat file', { path : recvFullPath } );
                                return nextFile(null);  //  just try the next one
                            }

                            if(stats.isFile()) {
                                this.recvFilePaths.push(recvFullPath);
                            }

                            return nextFile(null);
                        });
                    }, () => {
                        return cb(null);
                    });
                });
            }
        });
    }

    pathWithTerminatingSeparator(path) {
        if(path && paths.sep !== path.charAt(path.length - 1)) {
            path = path + paths.sep;
        }
        return path;
    }

    prepAndBuildSendArgs(filePaths, cb) {
        const externalArgs  = this.protocolConfig.external['sendArgs'];

        async.waterfall(
            [
                function getTempFileListPath(callback) {
                    const hasFileList = externalArgs.find(ea => (ea.indexOf('{fileListPath}') > -1) );
                    if(!hasFileList) {
                        return callback(null, null);
                    }

                    temptmp.open( { prefix : TEMP_SUFFIX, suffix : '.txt' }, (err, tempFileInfo) => {
                        if(err) {
                            return callback(err);   //  failed to create it
                        }

                        fs.write(tempFileInfo.fd, filePaths.join(SYSTEM_EOL), err => {
                            if(err) {
                                return callback(err);
                            }
                            fs.close(tempFileInfo.fd, err => {
                                return callback(err, tempFileInfo.path);
                            });
                        });
                    });
                },
                function createArgs(tempFileListPath, callback) {
                    //  initial args: ignore {filePaths} as we must break that into it's own sep array items
                    const args = externalArgs.map(arg => {
                        return '{filePaths}' === arg ? arg : stringFormat(arg, {
                            fileListPath    : tempFileListPath || '',
                        });
                    });

                    const filePathsPos = args.indexOf('{filePaths}');
                    if(filePathsPos > -1) {
                        //  replace {filePaths} with 0:n individual entries in |args|
                        args.splice.apply( args, [ filePathsPos, 1 ].concat(filePaths) );
                    }

                    return callback(null, args);
                }
            ],
            (err, args) => {
                return cb(err, args);
            }
        );
    }

    prepAndBuildRecvArgs(cb) {
        const argsKey       = this.recvFileName ? 'recvArgsNonBatch' : 'recvArgs';
        const externalArgs  = this.protocolConfig.external[argsKey];
        const args          = externalArgs.map(arg => stringFormat(arg, {
            uploadDir       : this.recvDirectory,
            fileName        : this.recvFileName || '',
        }));

        return cb(null, args);
    }

    executeExternalProtocolHandler(args, cb) {
        const external  = this.protocolConfig.external;
        const cmd       = external[`${this.direction}Cmd`];

        //  support for handlers that need IACs taken care of over Telnet/etc.
        const processIACs =
            external.processIACs ||
            external.escapeTelnet;   //  deprecated name

        //  :TODO: we should only do this when over Telnet (or derived, such as WebSockets)?

        const IAC           = Buffer.from([255]);
        const EscapedIAC    = Buffer.from([255, 255]);

        this.client.log.debug(
            { cmd : cmd, args : args, tempDir : this.recvDirectory, direction : this.direction },
            'Executing external protocol'
        );

        const spawnOpts = {
            cols        : this.client.term.termWidth,
            rows        : this.client.term.termHeight,
            cwd         : this.recvDirectory,
            encoding    : null, //  don't bork our data!
        };

        const externalProc = pty.spawn(cmd, args, spawnOpts);

        let dataHits = 0;
        const updateActivity = () => {
            if (0 === (dataHits++ % 4)) {
                this.client.explicitActivityTimeUpdate();
            }
        };

        this.client.setTemporaryDirectDataHandler(data => {
            updateActivity();

            //  needed for things like sz/rz
            if(processIACs) {
                let iacPos = data.indexOf(EscapedIAC);
                if (-1 === iacPos) {
                    return externalProc.write(data);
                }

                //  at least one double (escaped) IAC
                let lastPos = 0;
                while (iacPos > -1) {
                    let rem = iacPos - lastPos;
                    if (rem >= 0) {
                        externalProc.write(data.slice(lastPos, iacPos + 1));
                    }
                    lastPos = iacPos + 2;
                    iacPos = data.indexOf(EscapedIAC, lastPos);
                }

                if (lastPos < data.length) {
                    externalProc.write(data.slice(lastPos));
                }
                // const tmp = data.toString('binary').replace(/\xff{2}/g, '\xff');    //  de-escape
                // externalProc.write(Buffer.from(tmp, 'binary'));
            } else {
                externalProc.write(data);
            }
        });

        externalProc.onData(data => {
            updateActivity();

            //  needed for things like sz/rz
            if(processIACs) {
                let iacPos = data.indexOf(IAC);
                if (-1 === iacPos) {
                    return this.client.term.rawWrite(data);
                }

                //  Has at least a single IAC
                let lastPos = 0;
                while (iacPos !== -1) {
                    if (iacPos - lastPos > 0) {
                        this.client.term.rawWrite(data.slice(lastPos, iacPos));
                    }
                    this.client.term.rawWrite(EscapedIAC);
                    lastPos = iacPos + 1;
                    iacPos = data.indexOf(IAC, lastPos);
                }

                if (lastPos < data.length) {
                    this.client.term.rawWrite(data.slice(lastPos));
                }
            } else {
                this.client.term.rawWrite(data);
            }
        });

        externalProc.once('close', () => {
            return this.restorePipeAfterExternalProc();
        });

        externalProc.once('exit', (exitCode) => {
            this.client.log.debug( { cmd : cmd, args : args, exitCode : exitCode }, 'Process exited' );

            this.restorePipeAfterExternalProc();
            externalProc.removeAllListeners();

            return cb(exitCode ? Errors.ExternalProcess(`Process exited with exit code ${exitCode}`, 'EBADEXIT') : null);
        });
    }

    executeExternalProtocolHandlerForSend(filePaths, cb) {
        if(!Array.isArray(filePaths)) {
            filePaths = [ filePaths ];
        }

        this.prepAndBuildSendArgs(filePaths, (err, args) => {
            if(err) {
                return cb(err);
            }

            this.executeExternalProtocolHandler(args, err => {
                return cb(err);
            });
        });
    }

    executeExternalProtocolHandlerForRecv(cb) {
        this.prepAndBuildRecvArgs( (err, args) => {
            if(err) {
                return cb(err);
            }

            this.executeExternalProtocolHandler(args, err => {
                return cb(err);
            });
        });
    }

    getMenuResult() {
        if(this.isSending()) {
            return { sentFileIds : this.sentFileIds };
        } else {
            return { recvFilePaths : this.recvFilePaths };
        }
    }

    updateSendStats(cb) {
        let downloadBytes   = 0;
        let downloadCount   = 0;
        let fileIds         = [];

        async.each(this.sendQueue, (queueItem, next) => {
            if(!queueItem.sent) {
                return next(null);
            }

            if(queueItem.fileId) {
                fileIds.push(queueItem.fileId);
            }

            if(_.isNumber(queueItem.byteSize)) {
                downloadCount += 1;
                downloadBytes += queueItem.byteSize;
                return next(null);
            }

            //  we just have a path - figure it out
            fs.stat(queueItem.path, (err, stats) => {
                if(err) {
                    this.client.log.warn( { error : err.message, path : queueItem.path }, 'File stat failed' );
                } else {
                    downloadCount += 1;
                    downloadBytes += stats.size;
                }

                return next(null);
            });
        }, () => {
            //  All stats/meta currently updated via fire & forget - if this is ever a issue, we can wait for callbacks
            StatLog.incrementUserStat(this.client.user, UserProps.FileDlTotalCount, downloadCount);
            StatLog.incrementUserStat(this.client.user, UserProps.FileDlTotalBytes, downloadBytes);

            StatLog.incrementSystemStat(SysProps.FileDlTotalCount, downloadCount);
            StatLog.incrementSystemStat(SysProps.FileDlTotalBytes, downloadBytes);

            StatLog.incrementNonPersistentSystemStat(SysProps.FileDlTodayCount, downloadCount);
            StatLog.incrementNonPersistentSystemStat(SysProps.FileDlTodayBytes, downloadBytes);

            fileIds.forEach(fileId => {
                FileEntry.incrementAndPersistMetaValue(fileId, 'dl_count', 1);
            });

            return cb(null);
        });
    }

    updateRecvStats(cb) {
        let uploadBytes = 0;
        let uploadCount = 0;

        async.each(this.recvFilePaths, (filePath, next) => {
            //  we just have a path - figure it out
            fs.stat(filePath, (err, stats) => {
                if(err) {
                    this.client.log.warn( { error : err.message, path : filePath }, 'File stat failed' );
                } else {
                    uploadCount += 1;
                    uploadBytes += stats.size;
                }

                return next(null);
            });
        }, () => {
            StatLog.incrementUserStat(this.client.user, UserProps.FileUlTotalCount, uploadCount);
            StatLog.incrementUserStat(this.client.user, UserProps.FileUlTotalBytes, uploadBytes);

            StatLog.incrementSystemStat(SysProps.FileUlTotalCount, uploadCount);
            StatLog.incrementSystemStat(SysProps.FileUlTotalBytes, uploadBytes);

            StatLog.incrementNonPersistentSystemStat(SysProps.FileUlTodayCount, uploadCount);
            StatLog.incrementNonPersistentSystemStat(SysProps.FileUlTodayBytes, uploadBytes);

            return cb(null);
        });
    }

    initSequence() {
        const self = this;

        //  :TODO: break this up to send|recv

        async.series(
            [
                function validateConfig(callback) {
                    if(self.isSending()) {
                        if(!Array.isArray(self.sendQueue)) {
                            self.sendQueue = [ self.sendQueue ];
                        }
                    }

                    return callback(null);
                },
                function transferFiles(callback) {
                    if(self.isSending()) {
                        self.sendFiles( err => {
                            if(err) {
                                return callback(err);
                            }

                            const sentFileIds = [];
                            self.sendQueue.forEach(queueItem => {
                                if(queueItem.sent && queueItem.fileId) {
                                    sentFileIds.push(queueItem.fileId);
                                }
                            });

                            if(sentFileIds.length > 0) {
                                //  remove items we sent from the D/L queue
                                const dlQueue = new DownloadQueue(self.client);
                                const dlFileEntries = dlQueue.removeItems(sentFileIds);

                                //  fire event for downloaded entries
                                Events.emit(
                                    Events.getSystemEvents().UserDownload,
                                    {
                                        user    : self.client.user,
                                        files   : dlFileEntries
                                    }
                                );

                                self.sentFileIds = sentFileIds;
                            }

                            return callback(null);
                        });
                    } else {
                        self.recvFiles( err => {
                            return callback(err);
                        });
                    }
                },
                function cleanupTempFiles(callback) {
                    temptmp.cleanup( paths => {
                        Log.debug( { paths : paths, sessionId : temptmp.sessionId }, 'Temporary files cleaned up' );
                    });

                    return callback(null);
                },
                function updateUserAndSystemStats(callback) {
                    if(self.isSending()) {
                        return self.updateSendStats(callback);
                    } else {
                        return self.updateRecvStats(callback);
                    }
                }
            ],
            err => {
                if(err) {
                    self.client.log.warn( { error : err.message }, 'File transfer error');
                }

                return self.prevMenu();
            }
        );
    }
};