enigma-bbs/mods/msg_list.js

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

//	ENiGMA½
const MenuModule		= require('../core/menu_module.js').MenuModule;
const ViewController	= require('../core/view_controller.js').ViewController;
const messageArea		= require('../core/message_area.js');

//	deps
const async				= require('async');
const _					= require('lodash');
const moment			= require('moment');

/*
	Available listFormat/focusListFormat members (VM1):

	msgNum			: Message number
	to				: To username/handle
	from			: From username/handle
	subj			: Subject
	ts				: Message mod timestamp (format with config.dateTimeFormat)
	newIndicator	: New mark/indicator (config.newIndicator)

	MCI codes:

	VM1			: Message list
	TL2			: Message area description
	TL4			: Message selected #
	TL5			: Total messages in area
*/

//	:TODO: We need a way to update |initialFocusIndex| after next/prev in actual message viewing -- e.g. from child menu!!

exports.getModule		= MessageListModule;

exports.moduleInfo = {
	name	: 'Message List',
	desc	: 'Module for listing/browsing available messages',
	author	: 'NuSkooler',
};

var MciCodesIds = {
	MsgList			: 1,
	MsgAreaDesc		: 2,
	
	MsgSelNum		: 4,
	MsgTotal		: 5,
};

function MessageListModule(options) {
	MenuModule.call(this, options);

	const self		= this;
	const config	= this.menuConfig.config;

	this.messageAreaTag = config.messageAreaTag;

	if(options.extraArgs) {
		//
		//	|extraArgs| can override |messageAreaTag| provided by config
		//	as well as supply a pre-defined message list
		//
		if(options.extraArgs.messageAreaTag) {
			this.messageAreaTag = options.extraArgs.messageAreaTag;
		}

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

	this.menuMethods = {
		selectMessage : function(formData) {
			if(1 === formData.submitId) {
				self.initialFocusIndex = formData.value.message;

				const modOpts = {
					extraArgs 	: {
						messageAreaTag		: self.messageAreaTag,
						messageList			: self.messageList,
						messageIndex		: formData.value.message,
					}
				};

				self.gotoMenu(config.menuViewPost || 'messageAreaViewPost', modOpts);
			}
		}
	};

	this.setViewText = function(id, text) {
		const v = self.viewControllers.allViews.getView(id);
		if(v) {
			v.setText(text);
		}
	};
}

require('util').inherits(MessageListModule, MenuModule);

MessageListModule.prototype.enter = function() {
	MessageListModule.super_.prototype.enter.call(this);

	//
	//	Config can specify |messageAreaTag| else it comes from
	//	the user's current area
	//
	if(!this.messageAreaTag) {
		this.messageAreaTag = this.client.user.properties.message_area_tag;
	}
};

MessageListModule.prototype.mciReady = function(mciData, cb) {
	const self	= this;
	const vc	= self.viewControllers.allViews = new ViewController( { client : self.client } );

	async.series(
		[
			function callParentMciReady(callback) {
				MessageListModule.super_.prototype.mciReady.call(self, mciData, callback);
			},
			function loadFromConfig(callback) {
				var loadOpts = {
					callingMenu		: self,
					mciMap			: mciData.menu
				};

				vc.loadFromMenuConfig(loadOpts, callback);
			},
			function fetchMessagesInArea(callback) {
				//
				//	Config can supply messages else we'll need to populate the list now
				//
				if(_.isArray(self.messageList)) {
					callback(0 === self.messageList.length ? new Error('No messages in area') : null);
				} else {
					messageArea.getMessageListForArea( { client : self.client }, self.messageAreaTag, function msgs(err, msgList) {
						if(!msgList || 0 === msgList.length) {
							callback(new Error('No messages in area'));
						} else {
							self.messageList = msgList;
							callback(err);
						}
					});
				}
			},
			function getLastReadMesageId(callback) {
				messageArea.getMessageAreaLastReadId(self.client.user.userId, self.messageAreaTag, function lastRead(err, lastReadId) {
					self.lastReadId = lastReadId || 0;
					callback(null);	//	ignore any errors, e.g. missing value
				});
			},
			function updateMessageListObjects(callback) {
				const dateTimeFormat	= self.menuConfig.config.dateTimeFormat || 'ddd MMM Do';
				const newIndicator		= self.menuConfig.config.newIndicator || '*';
				const regIndicator		= new Array(newIndicator.length + 1).join(' ');	//	fill with space to avoid draw issues

				let msgNum = 1;
				self.messageList.forEach( (listItem, index) => {
					listItem.msgNum			= msgNum++;
					listItem.ts				= moment(listItem.modTimestamp).format(dateTimeFormat);
					listItem.newIndicator	= listItem.messageId > self.lastReadId ? newIndicator : regIndicator;

					if(_.isUndefined(self.initialFocusIndex) && listItem.messageId > self.lastReadId) {
						self.initialFocusIndex = index;
					}					
				});
				return callback(null);
			},
			function populateList(callback) {
				const msgListView		= vc.getView(MciCodesIds.MsgList);	
				const listFormat		= self.menuConfig.config.listFormat || '{msgNum} - {subject} - {toUserName}';				
				const focusListFormat	= self.menuConfig.config.focusListFormat || listFormat;	//	:TODO: default change color here

				//	:TODO: This can take a very long time to load large lists. What we need is to implement the "owner draw" concept in
				//	which items are requested (e.g. their format at least) *as-needed* vs trying to get the format for all of them at once

				msgListView.setItems(_.map(self.messageList, listEntry => {
					return listFormat.format(listEntry);
				}));

				msgListView.setFocusItems(_.map(self.messageList, listEntry => {
					return focusListFormat.format(listEntry);
				}));

				msgListView.on('index update', function indexUpdated(idx) {
					self.setViewText(MciCodesIds.MsgSelNum, (idx + 1).toString());
				});
				
				if(self.initialFocusIndex > 0) {
					//	note: causes redraw()
					msgListView.setFocusItemIndex(self.initialFocusIndex);
				} else {
					msgListView.redraw();
				}

				callback(null);
			},
			function populateOtherMciViews(callback) {
				self.setViewText(MciCodesIds.MsgAreaDesc, messageArea.getMessageAreaByTag(self.messageAreaTag).name);
				self.setViewText(MciCodesIds.MsgSelNum, (vc.getView(MciCodesIds.MsgList).getData() + 1).toString());
				self.setViewText(MciCodesIds.MsgTotal, self.messageList.length.toString());

				callback(null);
			},
		],
		function complete(err) {
			if(err) {
				self.client.log.error( { error : err.message }, 'Error loading message list');				
			}
			cb(err);
		}
	);
};

MessageListModule.prototype.getSaveState = function() {
	return { initialFocusIndex : this.initialFocusIndex };
};

MessageListModule.prototype.restoreSavedState = function(savedState) {
	if(savedState) {
		this.initialFocusIndex = savedState.initialFocusIndex;
	}
};