taskninja 1.1.2 → 1.1.4

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mohamed Bakr <bakrm1921@gmail.com>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -20,6 +20,7 @@
   * [Sort Tasks](#sort-tasks)
 * [Task Fields & Allowed Values](#task-fields--allowed-values)
 * [Examples](#examples)
+* [Demo](#demo)
 
 ---
 
@@ -345,46 +346,62 @@ tn so
 
 ---
 
-## Screenshots / Demo
+## Demo
 
 **All Features:**
 
-![All Features](images/allFeatures.png "all commands")
+![All Features](src/images/allFeatures.png "all commands")
 
 **Adding a Task:**
 
-![Add Task](images/addNew.png "Adding a Task in TaskNinja CLI")
+![Add Task](src/images/addNew.png "Adding a Task in TaskNinja CLI")
 
 **Listing Tasks:**
 
-![List Tasks](images/listAll.png "Listing Tasks in TaskNinja CLI")
+![List Tasks](src/images/listAll.png "Listing Tasks in TaskNinja CLI")
 
 **Updating a Task:**
 
-![Update Task](images/updateWith.png "Updating a Task")
+![Update Task](src/images/updateWith.png "Updating a Task")
 
 **Deleting a Task:**
 
-![Delete Task](images/deleteMethod.png "Deleting a Task")
+![Delete Task](src/images/deleteMethod.png "Deleting a Task")
 
 **Restore Last-Deleted Task:**
 
-![Undo](images/undoMethod.png "Restore Last-deleted task")
+![Undo](src/images/undoMethod.png "Restore Last-deleted task")
 
 **Search / Sort Tasks:**
 
-![Search Tasks](images/searchWith.png "Searching Tasks")
-![Sort Tasks](images/sort_.png "Sorting Tasks")
-![Sort Tasks-2](images/sortBy.png "Sorting Tasks")
+![Search Tasks](src/images/searchWith.png "Searching Tasks")
+![Sort Tasks](src/images/sort_.png "Sorting Tasks")
+![Sort Tasks-2](src/images/sortBy.png "Sorting Tasks")
 
 **Mark as Done:**
 
-![Mark Task As Done](images/doneTask.png "Mark as Done In one step")
-![Mark Task As Done](images/doneTask2.png "Mark as Done In one step")
+![Mark Task As Done](src/images/doneTask.png "Mark as Done In one step")
+![Mark Task As Done](src/images/doneTask2.png "Mark as Done In one step")
 
 **Tasks in `todos.json`:**
 
-![todos.json](images/todo.json.png "shape of tasks")
+![todos.json](src/images/todo.json.png "shape of tasks")
+
+
+---
+
+## New Additions for Version `1.1.3`
+
+**ESC Button End Operation:**
+
+* If the user presses the `Esc` button, this will end the ongoing process
+* This may benefit the user by terminating the process without having to complete the process until the end
+
+### SOON
+**Auto Deleted Task:**
+
+* When you delete the task, it will remain saved in `deleted_todos.json` for one minute, after which it will be deleted automatically
+* This somewhat conserves the user's storage space while calculating that the user may undo deleting a task
+
 
 
----

package/package.json

@@ -1,18 +1,18 @@
 {
   "name": "taskninja",
-  "version": "1.1.2",
+  "version": "1.1.4",
   "description": "a simple CLI application with JS as a (To-Do Application)",
-  "main": "app.js",
+  "main": "./src/index.js",
   "type": "module",
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1",
-    "start": "node app.js",
-    "dev": "node app.js"
+    "start": "node src/index.js",
+    "dev": "node src/index.js"
   },
   "bin": {
-    "dotask": "./app.js",
-    "taskninja": "./app.js",
-    "tn": "./app.js"
+    "dotask": "./src/index.js",
+    "taskninja": "./src/index.js",
+    "tn": "./src/index.js"
   },
   "repository": {
     "type": "git",
@@ -26,7 +26,7 @@
     "node"
   ],
   "author": "Moahmed Bakr",
-  "license": "ISC",
+  "license": "MIT",
   "dependencies": {
     "chalk": "^5.6.2",
     "cli-table3": "^0.6.5",

package/src/helpers/helpers.js

@@ -0,0 +1,70 @@
+
+// supporting colors in table forms
+import Table from 'cli-table3';
+// for colored text 
+import chalk from 'chalk';
+// for reading keyboard buttons
+import readline from 'readline';
+
+// helper function to display tasks in colored table
+const displayTasks = (tasks) => {
+    if (!tasks.length) {
+        console.log(chalk.yellow("No tasks to display."));
+        cleanupAndExit(0);
+    }
+
+    const table = new Table({
+        head:  [
+        chalk.cyanBright('#'),
+        chalk.cyanBright('ID'),
+        chalk.cyanBright('Title'),
+        chalk.cyanBright('Status'),
+        chalk.cyanBright('Priority'),
+        chalk.cyanBright('DueDate'),
+        chalk.cyanBright('Description')
+    ],
+        colWidths: [4, 4, 20, 15, 10, 12, 45]
+    });
+
+    tasks.forEach((task, index) => {
+        table.push([
+            index + 1,
+            task.id,
+            task.title,
+            task.status === "done" ? chalk.green(task.status)
+            : task.status === "in-progress" ? chalk.yellow(task.status)
+            : chalk.blue(task.status),
+            task.priority === "high" ? chalk.red(task.priority)
+            : task.priority === "medium" ? chalk.yellow(task.priority)
+            : chalk.green(task.priority),
+            task.dueDate,
+            task.description || ''
+        ]);
+    });
+
+    console.log(table.toString());
+};
+
+const cleanupAndExit = (code = 0) => {
+    if (process.stdin.isTTY) {
+        process.stdin.setRawMode(false);
+    }
+    process.exit(code);
+};
+
+const enableEscExit = () => {
+    readline.emitKeypressEvents(process.stdin);
+
+    if (process.stdin.isTTY) {
+        process.stdin.setRawMode(true);
+    }
+
+    process.stdin.on('keypress', (_, key) => {
+        if (key?.name === 'escape'){
+            console.log(chalk.yellow('\nOperation Cancelled!'));
+            cleanupAndExit(0);
+        }
+    });
+};
+
+export {displayTasks, enableEscExit, cleanupAndExit};

package/{app.js → src/index.js}

@@ -1,4 +1,5 @@
 #! /usr/bin/env node
+
 /**
  * TASKNINJA -
  * Task Manager CLI Application
@@ -9,71 +10,36 @@
  * - inquirer: For interactive prompts
  * - fs: For file system operations
  * Author: Mohamed Bakr
- * Date: January 2024
- * Version: 1.1.2
+ * Date: January 2026
+ * Version: 1.1.4
+ * @license MIT
+ * Copyright (c) 2026 Mohamed Bakr
  */
 
 // for using commands in terminal
 import { Command } from "commander";
 // for interactive command line prompts
 import inquirer from "inquirer";
-// supporting colors in table forms
-import Table from 'cli-table3';
 // for colored text 
 import chalk from 'chalk';
 
+// helpers
+import {displayTasks, enableEscExit, cleanupAndExit} from './helpers/helpers.js';
+
 // assigning Commander to a variable
 const program = new Command();
 
 // importing validators and allowed values
 import { validateDueDate, ALLOWED_PRIORITIES, ALLOWED_STATUSES } from "./utils/validators.js";
 // importing task service functions
-import { loadTasks, saveTasks, getNextId, saveDeletedTask, loadDeletedTask, clearDeletedTask  } from "./utils/taskService.js";
-
-
-// helper function to display tasks in colored table
-const displayTasks = (tasks) => {
-    if (!tasks.length) {
-        console.log(chalk.yellow("No tasks to display."));
-        return;
-    }
+import { loadTasks, saveTasks, getNextId, saveDeletedTask, loadDeletedTask, clearDeletedTask, cleanupExpiredDeletedTasks } from "./utils/taskService.js";
 
-    const table = new Table({
-        head:  [
-        chalk.cyanBright('#'),
-        chalk.cyanBright('ID'),
-        chalk.cyanBright('Title'),
-        chalk.cyanBright('Status'),
-        chalk.cyanBright('Priority'),
-        chalk.cyanBright('DueDate'),
-        chalk.cyanBright('Description')
-    ],
-        colWidths: [4, 4, 30, 15, 10, 12, 60]
-    });
 
-    tasks.forEach((task, index) => {
-        table.push([
-            index + 1,
-            task.id,
-            task.title,
-            task.status === "done" ? chalk.green(task.status)
-            : task.status === "in-progress" ? chalk.yellow(task.status)
-            : chalk.blue(task.status),
-            task.priority === "high" ? chalk.red(task.priority)
-            : task.priority === "medium" ? chalk.yellow(task.priority)
-            : chalk.green(task.priority),
-            task.dueDate,
-            task.description || ''
-        ]);
-    });
-
-    console.log(table.toString());
-};
 // setting up
 program
     .name("taskninja")
     .description("A simple CLI application to manage your tasks")
-    .version("1.1.0");
+    .version("1.1.4");
 
 // use command 'add' with title + status + priority + dueDate + description and action
 program
@@ -81,6 +47,7 @@ program
     .alias('a')
     .description('Add a new task')
     .action(async () => {
+        enableEscExit();
         const answers = await inquirer.prompt([
             {
                 type: 'input',
@@ -153,12 +120,13 @@ program
         if (options.status) {
             if (!ALLOWED_STATUSES.includes(options.status)){
                 console.log(chalk.red(`Invalid status filter. Allowed statuses are: ${ALLOWED_STATUSES.join(", ")}`));
-                return;
+                cleanupAndExit(0);
             }
             tasks = tasks.filter(task => task.status === options.status);
         }
         // display all tasks in table format
         displayTasks(tasks);
+        cleanupAndExit(0);
     });
 
 
@@ -174,6 +142,7 @@ program
         let searchTerm = keyword || options.find;
 
         if (!searchTerm) {
+            enableEscExit();
             const answers = await inquirer.prompt([
                 {
                     type: 'input',
@@ -199,13 +168,13 @@ program
                     task.description.toLowerCase().includes(searchTerm.toLowerCase());
             });
 
-            if (founded.length === 0) {
+            if (!founded.length) {
                 console.log(chalk.red('No task matched your search!'));
-                return;
+                cleanupAndExit(0);
             }
 
             displayTasks(founded);
-            return;
+            cleanupAndExit(0);
         }
 
         const founded = tasks.filter(task =>
@@ -213,12 +182,13 @@ program
             task.description.toLowerCase().includes(searchTerm.toLowerCase())
         );
 
-        if (founded.length === 0) {
+        if (!founded.length) {
             console.log(chalk.red('No task matched your search!'));
-            return;
+            cleanupAndExit(0);
         }
 
         displayTasks(founded);
+        cleanupAndExit(0);
     });
 
 
@@ -236,6 +206,7 @@ program
         let criteria = options.by;
 
         if (!criteria) {
+            enableEscExit();
             const answer = await inquirer.prompt([
                 {
                     type: 'rawlist',
@@ -249,9 +220,9 @@ program
         // normailze input `case-insensitive + separators`
         criteria = criteria.toLowerCase().replace(/[-_]/g, '');
         
-        if (!['dueDate', 'priority', 'status'].includes(criteria)) {
+        if (!['duedate', 'priority', 'status'].includes(criteria)) {
             console.log(chalk.red('Invalid sort criteria. Use --by with dueDate, priority, or status.'));
-            return;
+            cleanupAndExit(0);
         }
         // sorting logic
         const sortedTasks = [...tasks];
@@ -270,10 +241,11 @@ program
                 break;
             default:
                 console.log(chalk.red('Invalid sort criteria. Use dueDate, priority, or status.'));
-                return;
+                cleanupAndExit(0);
         }
 
         displayTasks(sortedTasks);
+        cleanupAndExit(0);
     });
 
 
@@ -284,11 +256,11 @@ program
     .description('Update a task by ==> ID <==')
     .action(async () =>{
         const tasks = await loadTasks();
-        if (tasks.length === 0) {
+        if (!tasks.length) {
             console.log(chalk.red('No tasks found to update.'));
-            return;
+            cleanupAndExit(0);
         }
-
+        enableEscExit();
         const { id } = await inquirer.prompt([
             {
                 type: 'rawlist',
@@ -302,9 +274,10 @@ program
         const task = tasks.find(t => t.id === Number(id));
         if (!task) {
             console.log(chalk.red('Task not found!'));
-            return;
+            cleanupAndExit(0);
         }
 
+        enableEscExit();
         const answers = await inquirer.prompt([
       // for title
         {
@@ -415,6 +388,7 @@ program
         }
     
         displayTasks(tasks);
+        cleanupAndExit(0);
     });
 
 
@@ -424,17 +398,17 @@ program
     .description('Mark a task as done by ==> ID <==')
     .action(async () => {
         const tasks = await loadTasks();
-        if (tasks.length === 0) {
+        if (!tasks.length) {
             console.log(chalk.magenta('Congratulations! All tasks are already done.'));
-            return;
+            cleanupAndExit(0);
         }
 
         const activeTasks = tasks.filter(t => t.status !== 'done');
-        if (activeTasks.length === 0) {
+        if (!activeTasks.length) {
             console.log(chalk.magenta('Congratulations! All tasks are already done.'));
-            return;
+            cleanupAndExit(0);
         }
-
+        enableEscExit();
         const { id } = await inquirer.prompt([
             {
                 type: 'rawlist',
@@ -455,6 +429,7 @@ program
         console.log(chalk.green('Task marked as done successfully!'));
 
         displayTasks(tasks);
+        cleanupAndExit(0);
     });
 
 
@@ -466,11 +441,11 @@ program
     .description('delete a task by ==> ID <==')
     .action(async () => {
         const tasks = await loadTasks();
-        if (tasks.length === 0) {
+        if (!tasks.length) {
             console.log(chalk.yellow('No tasks found to delete.'));
-            return;
+            cleanupAndExit(0);
         }
-
+        enableEscExit();
         const { id } = await inquirer.prompt([
             {
                 type: 'rawlist',
@@ -479,7 +454,7 @@ program
                 choices: tasks.map(task => ({ name: `${task.id}: ${task.title}`, value: task.id }))
             }
         ]);
-
+        enableEscExit();
         const { confirm } = await inquirer.prompt([
             {
                 type: 'confirm',
@@ -490,7 +465,7 @@ program
         ]);
         if (!confirm) {
             console.log(chalk.yellow('Task deletion cancelled.'));
-            return;
+            cleanupAndExit(0);
         }
         const taskToDelete = tasks.find(t => t.id === Number(id));
         // save deleted task for undo functionality
@@ -503,6 +478,7 @@ program
         console.log(chalk.cyan('You can undo this action by using the `undo` command.'));
 
         displayTasks(newTasks);
+        cleanupAndExit(0);
     });
 
 // use command 'undo' to restore last deleted task
@@ -511,17 +487,21 @@ program
 .alias('un')
 .description('Undo the last deleted task')
 .action( async () => {
-    const lastDeletedTask =  await loadDeletedTask();
-    if (!lastDeletedTask) {
+    await cleanupExpiredDeletedTasks();
+
+    const deletedTasks = await loadDeletedTask();
+    if (!deletedTasks || !deletedTasks.length) {
         console.log(chalk.yellow('No deleted task to restore.'));
-        return;
+        cleanupAndExit(0);
     }
 
+    const lastDeletedTask =  deletedTasks.pop();
+
     const tasks = await loadTasks();
     tasks.push(lastDeletedTask);
     tasks.sort((a, b) => a.id - b.id); // keep tasks sorted by ID
     await saveTasks(tasks);
-    await clearDeletedTask();
+    // await clearDeletedTask();
 
     console.log(chalk.green(`Last deleted task restored successfully!, (Task name: ${lastDeletedTask.title})`));
 });