mythix 3.0.0 → 4.0.2

package/src/cli/generators/generate-command.js

@@ -1,149 +0,0 @@
-'use strict';
-
-const Path        = require('path');
-const Nife        = require('nife');
-const { Logger }  = require('../../logger');
-
-const {
-  defineCommand,
-  getCommandFiles,
-  getInternalCommandsPath,
-} = require('../cli-utils');
-
-function loadGeneratorCommands(application, operationName) {
-  const generatorFilterFunc = (fullFileName, fileName, stats) => {
-    if (stats.isDirectory())
-      return true;
-
-    if ((/[^_][\w-]+-generator\.\w+$/).test(fileName))
-      return true;
-
-    return false;
-  };
-
-  let applicationOptions = application.getOptions();
-  let generatorFiles = [].concat(
-    getCommandFiles(
-      getInternalCommandsPath(),
-      generatorFilterFunc,
-    ),
-    (Nife.isEmpty(applicationOptions.commandsPath)) ? getCommandFiles(
-      getInternalCommandsPath(),
-      generatorFilterFunc,
-    ) : null,
-  ).filter(Boolean);
-
-  generatorFiles = Nife.uniq(generatorFiles);
-
-  let commands = {};
-
-  for (let i = 0, il = generatorFiles.length; i < il; i++) {
-    let fullFileName  = generatorFiles[i];
-    let fileName      = Path.basename(fullFileName);
-    let commandName   = fileName.replace(/^([\w-]+)-generator\.\w+$/, '$1');
-    let commandArgs   = {};
-    let Klass;
-
-    try {
-      Klass = require(fullFileName);
-      if (Klass.__esModule)
-        Klass = Klass['default'];
-
-      if (typeof Klass.commandArguments === 'function') {
-        commandArgs = Klass.commandArguments(application, operationName);
-
-        if (commandArgs && commandArgs.help)
-          commandArgs.help['@see'] = `See: 'mythix-cli generate ${commandName} --help' for more help`;
-      }
-    } catch (error) {
-      if (operationName === 'help')
-        console.error(`Error while attempting to load generator "${fullFileName}": `, error);
-
-      continue;
-    }
-
-    commands[commandName.toLocaleLowerCase()] = {
-      CommandKlass: Klass,
-      ...commandArgs,
-    };
-  }
-
-  return commands;
-}
-
-module.exports = defineCommand('generate', ({ Parent }) => {
-  return class GenerateCommand extends Parent {
-    static applicationConfig = () => {
-      return {
-        httpServer: false,
-        autoReload: false,
-        runTasks:   false,
-        logger:     {
-          level: Logger.LEVEL_ERROR,
-        },
-      };
-    };
-
-    static commandArguments(application, operationName) {
-      let generatorCommands = loadGeneratorCommands(application, operationName);
-
-      let help = {
-        '@usage': 'mythix-cli generate {generator}',
-        '@title': 'Generate new content using the specified generator',
-      };
-
-      Nife.iterate(generatorCommands, ({ value, key }) => {
-        if (value.help)
-          help[key] = value.help;
-      });
-
-      return {
-        help:   help,
-        runner: ({ $, fetch, showHelp, scope, store }) => {
-          let subCommandResult = $(
-            /[\w-]+/,
-            ({ store }, parsedResult) => {
-              store({ generateSubCommand: parsedResult.value.toLowerCase() });
-              return true;
-            },
-            { formatParsedResult: (result) => ({ value: result[0] }) },
-          );
-
-          if (!subCommandResult)
-            return false;
-
-          let subCommandName  = fetch('generateSubCommand');
-          let command         = generatorCommands[subCommandName];
-
-          if (!command) {
-            console.error(`Error: unknown generator "${subCommandName}"\n`);
-            return false;
-          }
-
-          let subCommandRunnerResult = true;
-          if (command.runner)
-            subCommandRunnerResult = scope(subCommandName, command.runner);
-
-          if (!subCommandRunnerResult || fetch('help', false)) {
-            showHelp(null, help[subCommandName] || help);
-            return false;
-          }
-
-          store('generatorCommands', generatorCommands);
-
-          return true;
-        },
-      };
-    }
-
-    async execute(args, fullArgs) {
-      let application       = this.getApplication();
-      let subCommandName    = args.generateSubCommand;
-      let generatorCommands = args.generatorCommands;
-      let command           = generatorCommands[subCommandName];
-
-      let commandInstance = new command.CommandKlass(application, this.getOptions());
-      return await commandInstance.execute.call(commandInstance, args[subCommandName], fullArgs);
-    }
-  };
-});

package/src/cli/index.js

@@ -1,5 +0,0 @@
-'use strict';
-
-const CLIUtils = require('./cli-utils');
-
-module.exports = CLIUtils;

package/src/cli/migrate-command.js

@@ -1,181 +0,0 @@
-'use strict';
-
-const Path              = require('path');
-const Nife              = require('nife');
-const { defineCommand } = require('./cli-utils');
-const { walkDir }       = require('../utils/file-utils');
-
-const TIMESTAMP_LENGTH        = 14;
-const MILLISECONDS_PER_SECOND = 1000.0;
-
-module.exports = defineCommand('migrate', ({ Parent }) => {
-  return class MigrateCommand extends Parent {
-    static commandArguments() {
-      return {
-        help: {
-          /* eslint-disable key-spacing */
-          '@usage': 'mythix-cli migrate [options]',
-          '@title': 'Run or rollback migrations',
-          '-r={revision number} | -r {revision number} | --revision={revision number} | --revision {revision number}': 'Start operation at revision specified. For rollbacks, this specifies the revision to stop at (inclusive).',
-          '--rollback': 'Rollback migrations to the revision number specified, or rollback the last migration if no revision number is specified.',
-        },
-        runner: ({ $, Types }) => {
-          $('-r', Types.STRING(), { name: 'revision' });
-          $('--revision', Types.STRING(), { name: 'revision' });
-
-          $('--rollback', Types.STRING());
-
-          return true;
-        },
-      };
-    }
-
-    getMigrationFiles(migrationsPath) {
-      try {
-        let files = walkDir(migrationsPath, {
-          filter: (fullFileName, fileName, stats) => {
-            if (fileName.match(/^_/) && stats.isDirectory())
-              return false;
-
-            if (stats.isFile() && !fileName.match(/^\d{14}.*\.js$/))
-              return false;
-
-            return true;
-          },
-        });
-
-        return files.sort();
-      } catch (error) {
-        if (error.code === 'ENOENT') {
-          console.log(`No migrations found at ${migrationsPath}. Aborting...`);
-          return [];
-        }
-
-        throw error;
-      }
-    }
-
-    getMigrationFilesFromRevision(migrationFiles, _revision, isRollback) {
-      let revision = BigInt('' + _revision);
-
-      let index = migrationFiles.findIndex((fullFileName) => {
-        let fileName        = Path.basename(fullFileName);
-        let migrationFileTS = fileName.substring(0, TIMESTAMP_LENGTH);
-
-        if (BigInt(migrationFileTS) > revision)
-          return true;
-
-        return false;
-      });
-
-      if (index < 0)
-        return [];
-
-      return migrationFiles.slice((isRollback) ? index - 1 : index);
-    }
-
-    async executeMigration(application, dbConnection, migrationFileName, useTransaction, rollback) {
-      let migration = require(migrationFileName);
-      let startTime = Nife.now();
-
-      if (rollback) {
-        await migration.down(dbConnection, application);
-        await this.removeMigrationFromDB(migration.MIGRATION_ID);
-
-        let seconds = ((Nife.now() - startTime) / MILLISECONDS_PER_SECOND).toFixed(2);
-        console.log(`Rolled back migration ${migrationFileName} successfully in ${seconds} seconds`);
-      } else {
-        await migration.up(dbConnection, application);
-        await this.storeSuccessfulMigrationToDB(migration.MIGRATION_ID);
-
-        let seconds = ((Nife.now() - startTime) / MILLISECONDS_PER_SECOND).toFixed(2);
-        console.log(`Migration ${migrationFileName} completed successfully in ${seconds} seconds`);
-      }
-    }
-
-    async storeSuccessfulMigrationToDB(migrationID) {
-      let MigrationModel = this.getApplication().getModel('Migration');
-
-      await MigrationModel.create({ id: ('' + migrationID) });
-    }
-
-    async removeMigrationFromDB(migrationID) {
-      try {
-        let MigrationModel = this.getApplication().getModel('Migration');
-
-        await MigrationModel.where.id.EQ(('' + migrationID)).LIMIT(1).destroy();
-      } catch (error) {
-        return;
-      }
-    }
-
-    async fetchLastMigrationIDFromDB() {
-      try {
-        let MigrationModel = this.getApplication().getModel('Migration');
-
-        let lastMigrationModel = await MigrationModel.where.id.NEQ(null).ORDER.DESC('Migration:id').first();
-        if (lastMigrationModel == null)
-          return null;
-
-        return lastMigrationModel.id;
-      } catch (error) {
-        return null;
-      }
-    }
-
-    async execute(args) {
-      const nextMigration = (doneCallback, _index) => {
-        let index = _index || 0;
-        if (index >= migrationFiles.length)
-          return doneCallback();
-
-        let migrationFileName = migrationFiles[index];
-
-        if (rollback)
-          console.log(`Undoing migration ${migrationFileName}...`);
-        else
-          console.log(`Running migration ${migrationFileName}...`);
-
-        this.executeMigration(application, dbConnection, migrationFileName, useTransaction, rollback).then(
-          () => nextMigration(doneCallback, index + 1),
-          (error) => {
-            console.error(`Error while running migration ${migrationFileName}: `, error);
-            doneCallback(error);
-          },
-        );
-      };
-
-      let application         = this.getApplication();
-      let applicationOptions  = application.getOptions();
-      let dbConnection        = application.getConnection();
-      let migrationsPath      = applicationOptions.migrationsPath;
-      let migrationFiles      = this.getMigrationFiles(migrationsPath);
-      let useTransaction      = args.transaction;
-      let rollback            = args.rollback;
-      let migrationID         = args.revision;
-
-      if (!migrationID)
-        migrationID = await this.fetchLastMigrationIDFromDB(dbConnection);
-
-      if (migrationID)
-        migrationFiles = this.getMigrationFilesFromRevision(migrationFiles, migrationID, rollback);
-
-      if (args.rollback)
-        migrationFiles = migrationFiles.reverse();
-
-      if (migrationFiles.length === 0) {
-        console.log('Nothing to migrate');
-        return;
-      }
-
-      return new Promise((resolve, reject) => {
-        nextMigration((error) => {
-          if (error)
-            return reject(error);
-
-          resolve();
-        });
-      });
-    }
-  };
-});

package/src/cli/routes-command.js

@@ -1,40 +0,0 @@
-'use strict';
-
-const { defineCommand } = require('./cli-utils');
-const { Logger }        = require('../logger');
-
-module.exports = defineCommand('routes', ({ Parent }) => {
-  return class RoutesCommand extends Parent {
-    static applicationConfig = { database: false, logger: { level: Logger.LEVEL_ERROR } };
-
-    static commandArguments() {
-      return {
-        help: {
-          '@usage': 'mythix-cli routes',
-          '@title': 'List application routes',
-        },
-      };
-    }
-
-    execute() {
-      let application = this.getApplication();
-      let routes      = application._getRoutes();
-      let whitespace  = '        ';
-
-      console.log(`${application.getApplicationName()} routes:`);
-
-      routes.walkRoutes(({ endpoint }) => {
-        let methods = endpoint.methods;
-        let flags   = [
-          (endpoint.isDynamic) ? 'dynamic' : '',
-          (endpoint.cors) ? 'COR' : '',
-        ].filter(Boolean).join(', ');
-
-        for (let i = 0, il = methods.length; i < il; i++) {
-          let method = methods[i];
-          console.log(`  ${method}${whitespace.substring(0, whitespace.length - method.length)}/${endpoint.path} -> [${endpoint.controller}]${(flags) ? ` (${flags})` : ''}`);
-        }
-      });
-    }
-  };
-});

package/src/cli/serve-command.js

@@ -1,63 +0,0 @@
-'use strict';
-
-const Nife              = require('nife');
-const { defineCommand } = require('./cli-utils');
-
-module.exports = defineCommand('serve', ({ Parent }) => {
-  return class ServeCommand extends Parent {
-    static applicationConfig = () => ({ autoStart: false, exitOnShutdown: 0 });
-
-    static commandArguments() {
-      return {
-        help: {
-          /* eslint-disable key-spacing */
-          '@usage': 'mythix-cli serve [options]',
-          '@title': 'Start application and HTTP server',
-          '--host={hostname or IP} | --host {hostname or IP}': 'Specify hostname or IP to listen on.',
-          '--port={port number} | --port {port number}': 'Specify port to listen on.',
-        },
-        runner: ({ $, Types }) => {
-          $('--host', Types.STRING());
-          $('--port', Types.INTEGER({
-            validate: (value) => {
-              // eslint-disable-next-line no-magic-numbers
-              if (value < 0 || value > 65535) {
-                console.error('Invalid "--port" specified... must be in the range 0-65535');
-                return false;
-              }
-
-              return true;
-            },
-          }));
-
-          return true;
-        },
-      };
-    }
-
-    execute(args) {
-      // eslint-disable-next-line no-async-promise-executor
-      return new Promise(async (resolve, reject) => {
-        try {
-          let application = this.getApplication();
-          let config = {};
-
-          if (Nife.isNotEmpty(args.host))
-            config.host = args.host;
-
-          if (Nife.isNotEmpty(args.port))
-            config.port = args.port;
-
-          if (Nife.isNotEmpty(config))
-            application.setConfig({ httpServer: config });
-
-          application.on('exit', resolve);
-
-          await application.start();
-        } catch (error) {
-          reject(error);
-        }
-      });
-    }
-  };
-});

package/src/cli/shell-command.js

@@ -1,96 +0,0 @@
-'use strict';
-
-const Nife              = require('nife');
-const OS                = require('os');
-const Path              = require('path');
-const REPL              = require('repl');
-const UUIDV4            = require('uuid').v4;
-const { defineCommand } = require('./cli-utils');
-const {
-  HTTPInterface,
-  HTTPUtils,
-} = require('../utils');
-
-module.exports = defineCommand('shell', ({ Parent }) => {
-  return class ShellCommand extends Parent {
-    static runtimeArguments = {
-      'node': [ '--experimental-repl-await', '--experimental-top-level-await' ],
-    };
-
-    static commandArguments() {
-      return {
-        help: {
-          '@usage': 'mythix-cli shell',
-          '@title': 'Drop into an server shell to execute commands directly',
-        },
-      };
-    }
-
-    constructor(...args) {
-      super(...args);
-
-      Object.defineProperties(this, {
-        'defaultHeaders': {
-          writable:     true,
-          enumerable:   false,
-          configurable: true,
-          value:        {},
-        },
-        'defaultURL': {
-          writable:     true,
-          enumerable:   false,
-          configurable: true,
-          value:        null,
-        },
-      });
-    }
-
-    execute() {
-      return new Promise((resolve) => {
-        let application   = this.getApplication();
-        let environment   = application.getConfigValue('environment', 'development');
-        let appName       = application.getApplicationName();
-        let httpInterface = new HTTPInterface();
-
-        const interactiveShell = REPL.start({
-          prompt: `${appName} (${environment}) > `,
-        });
-
-        interactiveShell.on('exit', () => {
-          resolve(0);
-        });
-
-        interactiveShell.setupHistory(Path.join(OS.homedir(), `.${appName}-${environment}-history`), () => {});
-
-        interactiveShell.context.UUIDV4 = UUIDV4;
-        interactiveShell.context.connection = (typeof application.getConnection === 'function') ? application.getConnection() : null;
-        interactiveShell.context.application = application;
-        interactiveShell.context.Nife = Nife;
-
-        interactiveShell.context.HTTP = {
-          'getDefaultURL':      httpInterface.getDefaultURL.bind(httpInterface),
-          'setDefaultURL':      httpInterface.setDefaultURL.bind(httpInterface),
-          'getDefaultHeader':   httpInterface.getDefaultHeader.bind(httpInterface),
-          'getDefaultHeaders':  httpInterface.getDefaultHeaders.bind(httpInterface),
-          'setDefaultHeader':   httpInterface.setDefaultHeader.bind(httpInterface),
-          'setDefaultHeaders':  httpInterface.setDefaultHeaders.bind(httpInterface),
-          'request':            httpInterface.request.bind(httpInterface),
-          'get':                httpInterface.getRequest.bind(httpInterface),
-          'post':               httpInterface.postRequest.bind(httpInterface),
-          'put':                httpInterface.putRequest.bind(httpInterface),
-          'delete':             httpInterface.deleteRequest.bind(httpInterface),
-          'head':               httpInterface.headRequest.bind(httpInterface),
-          'options':            httpInterface.optionsRequest.bind(httpInterface),
-          'dataToQueryString':  HTTPUtils.dataToQueryString,
-        };
-
-        if (typeof application.getModels === 'function')
-          Object.assign(interactiveShell.context, application.getModels());
-
-        this.onStart(interactiveShell);
-      });
-    }
-
-    onStart() {}
-  };
-});

package/src/controllers/controller-module.js

@@ -1,126 +0,0 @@
-'use strict';
-
-const Nife            = require('nife');
-const { BaseModule }  = require('../modules/base-module');
-const {
-  fileNameWithoutExtension,
-  walkDir,
-} = require('../utils');
-
-class ControllerModule extends BaseModule {
-  static fileWatcherQueueName = 'controllers';
-
-  static shouldUse(application, options) {
-    if (options.httpServer === false)
-      return false;
-
-    return true;
-  }
-
-  static getModuleName() {
-    return 'ControllerModule';
-  }
-
-  constructor(application) {
-    super(application);
-
-    Object.defineProperties(this, {
-      'controllers': {
-        writable:     true,
-        enumerable:   false,
-        configurable: true,
-        value:        {},
-      },
-    });
-
-    // Inject methods into the application
-    Object.defineProperties(application, {
-      'getController': {
-        writable:     true,
-        enumerable:   false,
-        configurable: true,
-        value:        this.getController.bind(this),
-      },
-    });
-  }
-
-  fileWatcherGetMonitorPaths(options) {
-    return [ options.controllersPath ];
-  }
-
-  async fileWatcherHandler(options) {
-    let controllers = await this.loadControllers(options.controllersPath);
-    this.controllers = controllers;
-  }
-
-  getControllerFilePaths(controllersPath) {
-    return walkDir(controllersPath, {
-      filter: (fullFileName, fileName, stats) => {
-        if (fileName.match(/^_/))
-          return false;
-
-        if (stats.isFile() && !fileNameWithoutExtension(fileName).match(/-controller$/))
-          return false;
-
-        return true;
-      },
-    });
-  }
-
-  loadControllers(controllersPath) {
-    let application     = this.getApplication();
-    let httpServer      = (typeof application.getHTTPServer() === 'function') ? application.getHTTPServer() : null;
-    let controllerFiles = this.getControllerFilePaths(controllersPath);
-    let controllers     = {};
-    let args            = { application, httpServer };
-
-    for (let i = 0, il = controllerFiles.length; i < il; i++) {
-      let controllerFile = controllerFiles[i];
-
-      try {
-        let controllerGenerator = require(controllerFile);
-        if (controllerGenerator.__esModule)
-          controllerGenerator = controllerGenerator['default'];
-
-        Object.assign(controllers, controllerGenerator(args));
-      } catch (error) {
-        this.getLogger().error(`Error while loading model ${controllerFile}: `, error);
-        throw error;
-      }
-    }
-
-    return controllers;
-  }
-
-  getController(name) {
-    let controllers     = this.controllers;
-    let controllerName  = name.replace(/(.*?)\b\w+$/, '$1');
-    let methodName      = name.substring(controllerName.length);
-    if (!methodName)
-      methodName = undefined;
-
-    controllerName = controllerName.replace(/\W+$/g, '');
-
-    return {
-      controller:       Nife.get(controllers, controllerName),
-      controllerMethod: methodName,
-    };
-  }
-
-  async start(options) {
-    let application = this.getApplication();
-    let httpServer  = (typeof application.getHTTPServer === 'function') ? application.getHTTPServer() : null;
-    let controllers = await this.loadControllers(options.controllersPath);
-
-    this.controllers = controllers;
-
-    httpServer.setRoutes(application._getRoutes());
-  }
-
-  async stop() {
-  }
-}
-
-module.exports = {
-  ControllerModule,
-};

package/src/controllers/controller-utils.d.ts

@@ -1,19 +0,0 @@
-import { Application } from '../application';
-import { HTTPServer } from '../http-server';
-import { ControllerClass } from './controller-base';
-
-export declare interface DefineControllerContext<T = ControllerClass> {
-  Parent: T;
-  application: Application;
-  server: HTTPServer;
-  controllerName: string;
-}
-
-export declare function defineController<T = ControllerClass>(
-  controllerName: string,
-  definer: (context: DefineControllerContext<T>) => ControllerClass,
-  parent?: T
-): (context: {
-  application: Application,
-  server: HTTPServer,
-}) => ControllerClass;