moving terminal out to its own folder

Author: cblanquera

src/index.ts

@@ -98,7 +98,9 @@ import RouteEmitter from './emitter/RouteEmitter.js';
 import Request, { withUnknownHost } from './router/Request.js';
 import Response from './router/Response.js';
 import Router from './router/Router.js';
-import Terminal, { control } from './router/Terminal.js';
+
+import control from './terminal/control.js';
+import Terminal from './terminal/Terminal.js';
 
 import Exception from './Exception.js';
 import Reflection from './Reflection.js';

src/terminal/Terminal.ts

@@ -0,0 +1,86 @@
+
+//lib
+import type { TypeOf } from '../types.js';
+//data
+import { objectFromArgs } from '../data/Nest.js';
+//local
+import Router from '../router/Router.js';
+import control from './control.js';
+
+export default class Terminal<R = unknown, S = unknown> 
+  extends Router<R, S, Terminal<R, S>> 
+{
+  //the event command
+  public readonly command: string;
+  //input and output controls
+  protected _control: ReturnType<typeof control>;
+  //cached cli args
+  protected _args: string[];
+  //cached terminal params (parsed argv)
+  protected _data?: Record<string, any>;
+
+  /**
+   * Returns the cli arguments
+   */
+  public get args() {
+    return [ ...this._args ];
+  }
+
+  /**
+   * Returns the terminal brand
+   */
+  public get brand() {
+    return this._control.brand;
+  }
+
+  /**
+   * Returns the terminal controls
+   */
+  public get control() {
+    return Object.freeze(this._control);
+  }
+
+  /**
+   * Returns the cli parameters
+   */
+  public get data() {
+    if (!this._data) {
+      this._data = objectFromArgs(this._args.join(' '));
+    }
+    return { ...this._data };
+  }
+
+  /**
+   * Preloads the input and output settings
+   */
+  constructor(args: string[], brand = '') {
+    super();
+    //set event
+    this.command = args[0] || '';
+    //set cli args
+    this._args = args.slice(1);
+    //set controls
+    this._control = control(brand);
+  }
+
+  /**
+   * Retrieves the first value found from the given flag/s in cli
+   */
+  public expect<T>(flags: string[], defaults: TypeOf<T>) {
+    for (const flag of flags) {
+      if (this.data[flag]) {
+        return this.data[flag] as T;
+      }
+    }
+    return defaults;
+  }
+
+  /**
+   * Runs the command
+   */
+  public run<T = unknown>() {
+    const req = this.request({ data: this.data });
+    const res = this.response();
+    return this.resolve<T>(this.command, req, res);
+  }
+}

src/terminal/control.ts

@@ -0,0 +1,82 @@
+//modules
+import { input } from '@inquirer/prompts';
+
+/**
+ * Returns a list of control methods for the terminal
+ */
+export default function control(brand = '') {
+  const controls = {
+    brand,
+    
+    /**
+     * Outputs an colorful (red) log 
+     */
+    error(message: string, variables: string[] = []) {
+      controls.output(message, variables, '\x1b[31m%s\x1b[0m');
+    },
+
+    /**
+     * Outputs an colorful (blue) log 
+     */
+    info(message: string, variables: string[] = []) {
+      controls.output(message, variables, '\x1b[34m%s\x1b[0m');
+    },
+
+    /**
+     * Asks for input
+     */
+    async input(question: string, answer?: string) {
+      return await input({
+        message: question,
+        default: answer,
+        required: typeof answer !== 'string'
+      });
+    },
+
+    /**
+     * Outputs a log 
+     */
+    output(
+      message: string, 
+      variables: string[] = [],
+      color?: string
+    ) {
+      //add variables to message
+      for (const variable of variables) {
+        message = message.replace('%s', variable);
+      }
+      //add brand to message
+      message = `${controls.brand} ${message}`.trim();
+      //colorize the message
+      if (color) {
+        console.log(color, message);
+        return;
+      }
+      //or just output the message
+      console.log(message);
+    },
+
+    /**
+     * Outputs a success log 
+     */
+    success(message: string, variables: string[] = []) {
+      controls.output(message, variables, '\x1b[32m%s\x1b[0m');
+    },
+
+    /**
+     * Outputs a system log 
+     */
+    system(message: string, variables: string[] = []) {
+      controls.output(message, variables, '\x1b[35m%s\x1b[0m');
+    },
+
+    /**
+     * Outputs a warning log 
+     */
+    warning(message: string, variables: string[] = []) {
+      controls.output(message, variables, '\x1b[33m%s\x1b[0m');
+    }
+  };
+
+  return controls;
+};