/* jslint node: true */ 'use strict'; // ENiGMA½ const loadMenu = require('./menu_util.js').loadMenu; const { Errors, ErrorReasons } = require('./enig_error.js'); const { getResolvedSpec } = require('./menu_util.js'); // deps const _ = require('lodash'); const assert = require('assert'); // :TODO: Stack is backwards.... top should be most recent! :) module.exports = class MenuStack { constructor(client) { this.client = client; this.stack = []; } push(moduleInfo) { return this.stack.push(moduleInfo); } pop() { return this.stack.pop(); } peekPrev() { if (this.stackSize > 1) { return this.stack[this.stack.length - 2]; } } top() { if (this.stackSize > 0) { return this.stack[this.stack.length - 1]; } } get stackSize() { return this.stack.length; } get currentModule() { const top = this.top(); assert(top, 'Empty menu stack!'); return top.instance; } next(cb) { const currentModuleInfo = this.top(); const menuConfig = currentModuleInfo.instance.menuConfig; const nextMenu = getResolvedSpec(this.client, menuConfig.next, 'next'); if (!nextMenu) { return cb( Array.isArray(menuConfig.next) ? Errors.MenuStack( 'No matching condition for "next"', ErrorReasons.NoConditionMatch ) : Errors.MenuStack( 'Invalid or missing "next" member in menu config', ErrorReasons.InvalidNextMenu ) ); } if (nextMenu === currentModuleInfo.name) { return cb( Errors.MenuStack( 'Menu config "next" specifies current menu', ErrorReasons.AlreadyThere ) ); } this.goto(nextMenu, {}, cb); } prev(cb) { const menuResult = this.top().instance.getMenuResult(); const currentModuleInfo = this.top(); // :TODO: leave() should really take a cb... this.pop().instance.leave(); // leave & remove current const previousModuleInfo = this.pop(); // get previous if (previousModuleInfo) { const opts = { extraArgs: previousModuleInfo.extraArgs, savedState: previousModuleInfo.savedState, lastMenuResult: menuResult, currentModuleInfo, }; return this.goto(previousModuleInfo.name, opts, cb); } return cb( Errors.MenuStack('No previous menu available', ErrorReasons.NoPreviousMenu) ); } goto(name, options, cb) { if (!cb && _.isFunction(options)) { cb = options; options = {}; } options = options || {}; const currentModuleInfo = options.currentModuleInfo || this.top(); const self = this; if (currentModuleInfo && name === currentModuleInfo.name) { if (cb) { cb( Errors.MenuStack( 'Already at supplied menu', ErrorReasons.AlreadyThere ) ); } return; } const loadOpts = { name: name, client: self.client, }; if (currentModuleInfo && currentModuleInfo.menuFlags.includes('forwardArgs')) { loadOpts.extraArgs = currentModuleInfo.extraArgs; } else { loadOpts.extraArgs = options.extraArgs || _.get(options, 'formData.value'); } loadOpts.lastMenuResult = options.lastMenuResult; loadMenu(loadOpts, (err, modInst) => { if (err) { // :TODO: probably should just require a cb... const errCb = cb || self.client.defaultHandlerMissingMod(); errCb(err); } else { self.client.log.debug({ menuName: name }, 'Goto menu module'); if (!this.client.acs.hasMenuModuleAccess(modInst)) { if (cb) { return cb(Errors.AccessDenied('No access to this menu')); } return; } // // Handle deprecated 'options' block by merging to config and warning user. // :TODO: Remove in 0.0.10+ // if (modInst.menuConfig.options) { self.client.log.warn( { options: modInst.menuConfig.options }, 'Use of "options" is deprecated. Move relevant members to "config" block! Support will be fully removed in future versions' ); Object.assign( modInst.menuConfig.config || {}, modInst.menuConfig.options ); delete modInst.menuConfig.options; } // // If menuFlags were supplied in menu.hjson, they should win over // anything supplied in code. // let menuFlags; if (0 === modInst.menuConfig.config.menuFlags.length) { menuFlags = Array.isArray(options.menuFlags) ? options.menuFlags : []; } else { menuFlags = modInst.menuConfig.config.menuFlags; // in code we can ask to merge in if ( Array.isArray(options.menuFlags) && options.menuFlags.includes('mergeFlags') ) { menuFlags = _.uniq(menuFlags.concat(options.menuFlags)); } } if (currentModuleInfo) { // save stack state currentModuleInfo.savedState = currentModuleInfo.instance.getSaveState(); currentModuleInfo.instance.leave(); if (currentModuleInfo.menuFlags.includes('noHistory')) { this.pop(); } if (menuFlags.includes('popParent')) { this.pop().instance.leave(); // leave & remove current } } self.push({ name: name, instance: modInst, extraArgs: loadOpts.extraArgs, menuFlags: menuFlags, }); // restore previous state if requested if (options.savedState) { modInst.restoreSavedState(options.savedState); } const stackEntries = self.stack.map(stackEntry => { let name = stackEntry.name; if (stackEntry.instance.menuConfig.config.menuFlags.length > 0) { name += ` (${stackEntry.instance.menuConfig.config.menuFlags.join( ', ' )})`; } return name; }); self.client.log.trace({ stack: stackEntries }, 'Updated menu stack'); modInst.enter(); if (cb) { cb(null); } } }); } };