retold 4.0.1 → 4.0.3

package/examples/todo-list/cli-client/source/commands/list/TodoCLI-Command-List.js

@@ -0,0 +1,110 @@
+const libCommandLineCommand = require('pict-service-commandlineutility').ServiceCommandLineCommand;
+
+class TodoCLICommandList extends libCommandLineCommand
+{
+	constructor(pFable, pManifest, pServiceHash)
+	{
+		super(pFable, pManifest, pServiceHash);
+
+		this.options.CommandKeyword = 'list';
+		this.options.Description = 'List tasks from the todo list';
+
+		this.options.Aliases.push('ls');
+		this.options.Aliases.push('l');
+
+		this.options.CommandOptions.push({ Name: '-s, --search [text]', Description: 'Filter tasks by name or description', Default: '' });
+		this.options.CommandOptions.push({ Name: '-c, --column [column]', Description: 'Sort column (DueDate, Name, Status, LengthInHours, IDTask)', Default: 'DueDate' });
+		this.options.CommandOptions.push({ Name: '-d, --direction [direction]', Description: 'Sort direction (ASC or DESC)', Default: 'DESC' });
+		this.options.CommandOptions.push({ Name: '-n, --limit [count]', Description: 'Maximum number of tasks to show', Default: '50' });
+		this.options.CommandOptions.push({ Name: '--status [status]', Description: 'Filter by status (Pending, Complete, In Progress)', Default: '' });
+
+		this.addCommand();
+	}
+
+	onRunAsync(fCallback)
+	{
+		let tmpAPI = this.services.TodoAPI;
+		let tmpSearch = this.CommandOptions.search || '';
+		let tmpColumn = this.CommandOptions.column || 'DueDate';
+		let tmpDirection = this.CommandOptions.direction || 'DESC';
+		let tmpLimit = parseInt(this.CommandOptions.limit, 10) || 50;
+		let tmpStatusFilter = this.CommandOptions.status || '';
+
+		let tmpPath = tmpAPI.buildFilteredPath(tmpColumn, tmpDirection, tmpSearch, tmpLimit);
+
+		this.log.info(`Fetching tasks...`);
+
+		tmpAPI.request('GET', tmpPath, null,
+			(pError, pTasks) =>
+			{
+				if (pError)
+				{
+					this.log.error(`Failed to fetch tasks: ${pError.message}`);
+					return fCallback();
+				}
+
+				if (!Array.isArray(pTasks))
+				{
+					this.log.error(`Unexpected response from server.`);
+					return fCallback();
+				}
+
+				// Optional client-side status filter
+				let tmpTasks = pTasks;
+				if (tmpStatusFilter)
+				{
+					let tmpLower = tmpStatusFilter.toLowerCase();
+					tmpTasks = tmpTasks.filter(
+						(pTask) =>
+						{
+							return (pTask.Status || '').toLowerCase() === tmpLower;
+						});
+				}
+
+				if (tmpTasks.length === 0)
+				{
+					this.log.info(`No tasks found.`);
+					return fCallback();
+				}
+
+				this.log.info(`${tmpTasks.length} task(s):`);
+				this.log.info('');
+
+				// Table header
+				let tmpHeader = this._padRight('ID', 6)
+					+ this._padRight('Status', 14)
+					+ this._padRight('Due Date', 13)
+					+ this._padRight('Hours', 7)
+					+ 'Name';
+				this.log.info(tmpHeader);
+				this.log.info('-'.repeat(78));
+
+				for (let i = 0; i < tmpTasks.length; i++)
+				{
+					let tmpTask = tmpTasks[i];
+					let tmpDueDate = (tmpTask.DueDate || '-').substring(0, 10);
+					let tmpLine = this._padRight(String(tmpTask.IDTask), 6)
+						+ this._padRight(tmpTask.Status || '-', 14)
+						+ this._padRight(tmpDueDate, 13)
+						+ this._padRight(String(tmpTask.LengthInHours || 0), 7)
+						+ (tmpTask.Name || '(untitled)');
+					this.log.info(tmpLine);
+				}
+
+				this.log.info('');
+				return fCallback();
+			});
+	}
+
+	_padRight(pString, pLength)
+	{
+		let tmpStr = String(pString);
+		while (tmpStr.length < pLength)
+		{
+			tmpStr += ' ';
+		}
+		return tmpStr;
+	}
+}
+
+module.exports = TodoCLICommandList;

package/examples/todo-list/cli-client/source/commands/remove/TodoCLI-Command-Remove.js

@@ -0,0 +1,49 @@
+const libCommandLineCommand = require('pict-service-commandlineutility').ServiceCommandLineCommand;
+
+class TodoCLICommandRemove extends libCommandLineCommand
+{
+	constructor(pFable, pManifest, pServiceHash)
+	{
+		super(pFable, pManifest, pServiceHash);
+
+		this.options.CommandKeyword = 'remove';
+		this.options.Description = 'Remove a task by ID';
+
+		this.options.Aliases.push('rm');
+		this.options.Aliases.push('delete');
+		this.options.Aliases.push('del');
+
+		this.options.CommandArguments.push({ Name: '<id>', Description: 'The task ID to remove' });
+
+		this.addCommand();
+	}
+
+	onRunAsync(fCallback)
+	{
+		let tmpAPI = this.services.TodoAPI;
+		let tmpIDTask = parseInt(this.ArgumentString, 10);
+
+		if (!tmpIDTask || isNaN(tmpIDTask))
+		{
+			this.log.error(`A valid task ID is required.  Usage: todo remove 42`);
+			return fCallback();
+		}
+
+		this.log.info(`Removing task ${tmpIDTask}...`);
+
+		tmpAPI.request('DELETE', '/1.0/Task/' + tmpIDTask, null,
+			(pError, pResult) =>
+			{
+				if (pError)
+				{
+					this.log.error(`Failed to remove task: ${pError.message}`);
+					return fCallback();
+				}
+
+				this.log.info(`Task ${tmpIDTask} removed.`);
+				return fCallback();
+			});
+	}
+}
+
+module.exports = TodoCLICommandRemove;

package/examples/todo-list/cli-client/source/services/TodoCLI-Service-API.js

@@ -0,0 +1,92 @@
+const libFableServiceProviderBase = require('fable-serviceproviderbase');
+const libHttp = require('http');
+
+class TodoAPIService extends libFableServiceProviderBase
+{
+	constructor(pFable, pManifest, pServiceHash)
+	{
+		super(pFable, pManifest, pServiceHash);
+
+		this.serviceType = 'TodoAPI';
+	}
+
+	/**
+	 * Make an HTTP request to the Todo API.
+	 *
+	 * @param {string} pMethod - HTTP method (GET, POST, PUT, DELETE)
+	 * @param {string} pPath - URL path (e.g. /1.0/Tasks)
+	 * @param {Object|null} pBody - Request body (for POST/PUT)
+	 * @param {Function} fCallback - Callback(pError, pParsedResponse)
+	 */
+	request(pMethod, pPath, pBody, fCallback)
+	{
+		let tmpBaseURL = this.fable.settings.ApiBaseURL || 'http://localhost:8086';
+		let tmpURL = new URL(pPath, tmpBaseURL);
+
+		let tmpOptions =
+		{
+			method: pMethod,
+			hostname: tmpURL.hostname,
+			port: tmpURL.port,
+			path: tmpURL.pathname + tmpURL.search,
+			headers: { 'Content-Type': 'application/json' }
+		};
+
+		let tmpReq = libHttp.request(tmpOptions,
+			(pResponse) =>
+			{
+				let tmpData = '';
+				pResponse.on('data', (pChunk) => { tmpData += pChunk; });
+				pResponse.on('end', () =>
+				{
+					try
+					{
+						let tmpParsed = JSON.parse(tmpData);
+						return fCallback(null, tmpParsed);
+					}
+					catch (pParseError)
+					{
+						return fCallback(pParseError);
+					}
+				});
+			});
+
+		tmpReq.on('error', (pError) => { return fCallback(pError); });
+
+		if (pBody)
+		{
+			tmpReq.write(JSON.stringify(pBody));
+		}
+		tmpReq.end();
+	}
+
+	/**
+	 * Build a FilteredTo path with optional sort and search.
+	 *
+	 * @param {string} pSortColumn - Column to sort by (default 'DueDate')
+	 * @param {string} pSortDirection - ASC or DESC (default 'DESC')
+	 * @param {string} pSearchText - Optional LIKE search across Name and Description
+	 * @param {number} pLimit - Max records to return (default 50)
+	 * @returns {string} The URL path
+	 */
+	buildFilteredPath(pSortColumn, pSortDirection, pSearchText, pLimit)
+	{
+		let tmpSortColumn = pSortColumn || 'DueDate';
+		let tmpSortDirection = pSortDirection || 'DESC';
+		let tmpLimit = pLimit || 50;
+
+		let tmpFilter = 'FSF~' + tmpSortColumn + '~' + tmpSortDirection + '~0';
+
+		if (pSearchText)
+		{
+			let tmpSearchEncoded = encodeURIComponent('%' + pSearchText + '%');
+			tmpFilter = 'FBV~Name~LK~' + tmpSearchEncoded
+				+ '~FBVOR~Description~LK~' + tmpSearchEncoded
+				+ '~' + tmpFilter;
+		}
+
+		return '/1.0/Tasks/FilteredTo/' + tmpFilter + '/0/' + tmpLimit;
+	}
+}
+
+module.exports = TodoAPIService;