@adonisjs/core 5.9.0 → 6.0.1-0

package/build/src/Ignitor/Ace/App/index.d.ts

@@ -1,60 +0,0 @@
-/**
- * Exposes the API to execute app commands registered under
- * the manifest file.
- */
-export declare class App {
-    private appRoot;
-    private commandName;
-    /**
-     * Returns a boolean if mentioned command is an assembler
-     * command
-     */
-    private get isAssemblerCommand();
-    /**
-     * Reference to the app kernel
-     */
-    private kernel;
-    /**
-     * Reference to the ace kernel
-     */
-    private ace;
-    /**
-     * Source root always points to the compiled source
-     * code.
-     */
-    constructor(appRoot: string);
-    /**
-     * Print commands help
-     */
-    private printHelp;
-    /**
-     * Print framework version
-     */
-    private printVersion;
-    /**
-     * Invoked before command source will be read from the
-     * disk
-     */
-    private onFind;
-    /**
-     * Invoked before command is about to run.
-     */
-    private onRun;
-    /**
-     * Hooks into ace lifecycle events to conditionally
-     * load the app.
-     */
-    private registerAceHooks;
-    /**
-     * Adding flags
-     */
-    private registerAceFlags;
-    /**
-     * Load commands using manifest loader
-     */
-    loadCommands(): Promise<void>;
-    /**
-     * Handle application command
-     */
-    handle(argv: string[]): Promise<void>;
-}

package/build/src/Ignitor/Ace/App/index.js

@@ -1,236 +0,0 @@
-"use strict";
-/*
- * @adonisjs/core
- *
- * (c) Harminder Virk <virk@adonisjs.com>
- *
- * For the full copyright and license information, please view the LICENSE
- * file that was distributed with this source code.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.App = void 0;
-const ace_1 = require("@adonisjs/ace");
-const cliui_1 = require("@poppinss/cliui");
-const helpers_1 = require("@poppinss/utils/build/helpers");
-const Kernel_1 = require("../../Kernel");
-const utils_1 = require("../../../utils");
-const GenerateManifest_1 = require("../GenerateManifest");
-/**
- * A local list of assembler commands. We need this, so that when assembler
- * is not installed (probably in production) and someone is trying to
- * build the project by running `serve` or `build`, we should give
- * them a better descriptive error.
- *
- * Also, do note that at times this list will be stale, but we get it back
- * in sync over time.
- */
-const ASSEMBLER_COMMANDS = [
-    'build',
-    'serve',
-    'invoke',
-    'make:command',
-    'make:controller',
-    'make:exception',
-    'make:listener',
-    'make:middleware',
-    'make:prldfile',
-    'make:provider',
-    'make:validator',
-    'make:view',
-];
-/**
- * Exposes the API to execute app commands registered under
- * the manifest file.
- */
-class App {
-    /**
-     * Returns a boolean if mentioned command is an assembler
-     * command
-     */
-    get isAssemblerCommand() {
-        return ASSEMBLER_COMMANDS.includes(this.commandName);
-    }
-    /**
-     * Source root always points to the compiled source
-     * code.
-     */
-    constructor(appRoot) {
-        this.appRoot = appRoot;
-        /**
-         * Reference to the app kernel
-         */
-        this.kernel = new Kernel_1.AppKernel(this.appRoot, 'console');
-        /**
-         * Reference to the ace kernel
-         */
-        this.ace = new ace_1.Kernel(this.kernel.application);
-    }
-    /**
-     * Print commands help
-     */
-    printHelp(value, command) {
-        if (!value) {
-            return;
-        }
-        this.ace.printHelp(command, [GenerateManifest_1.GenerateManifest.getManifestJSON()]);
-        process.exit(0);
-    }
-    /**
-     * Print framework version
-     */
-    printVersion(value) {
-        if (!value) {
-            return;
-        }
-        const appVersion = this.kernel.application.version;
-        const adonisVersion = this.kernel.application.adonisVersion;
-        let assemblerVersion = 'Not Installed';
-        try {
-            assemblerVersion = require((0, helpers_1.resolveFrom)(this.appRoot, '@adonisjs/assembler/package.json')).version;
-        }
-        catch (error) { }
-        (0, cliui_1.sticker)()
-            .heading('node ace --version')
-            .add(`App version: ${cliui_1.logger.colors.cyan(appVersion ? appVersion.version : 'NA')}`)
-            .add(`Framework version: ${cliui_1.logger.colors.cyan(adonisVersion ? adonisVersion.version : 'NA')}`)
-            .add(`Assembler version: ${cliui_1.logger.colors.cyan(assemblerVersion)}`)
-            .render();
-        process.exit(0);
-    }
-    /**
-     * Invoked before command source will be read from the
-     * disk
-     */
-    async onFind(command) {
-        if (!command) {
-            return;
-        }
-        /**
-         * Register ts hook when
-         *
-         * - Haven't registered it already
-         * - Is a typescript project
-         * - Is not an assembler command
-         */
-        if (!this.isAssemblerCommand) {
-            this.kernel.registerTsCompilerHook();
-        }
-        /**
-         * Only main command can load the application or switch
-         * the environment.
-         *
-         * If a sub-command needs application, then the main command
-         * should set "loadApp" to true as well.
-         */
-        if (command.commandName === this.commandName || command.aliases.includes(this.commandName)) {
-            /**
-             * Switch environment before wiring the app
-             */
-            if (command.settings.environment) {
-                this.kernel.application.switchEnvironment(command.settings.environment);
-            }
-            if (command.settings.loadApp) {
-                /**
-                 * Set ace instance within the container, so that the underlying
-                 * commands or the app can access it from the container
-                 */
-                this.kernel.application.container.singleton('Adonis/Core/Ace', () => this.ace);
-                await this.kernel.boot();
-            }
-        }
-    }
-    /**
-     * Invoked before command is about to run.
-     */
-    async onRun() {
-        if (this.kernel.hasBooted) {
-            await this.kernel.start();
-        }
-    }
-    /**
-     * Hooks into ace lifecycle events to conditionally
-     * load the app.
-     */
-    registerAceHooks() {
-        this.ace.before('find', async (command) => this.onFind(command));
-        this.ace.before('run', async () => this.onRun());
-    }
-    /**
-     * Adding flags
-     */
-    registerAceFlags() {
-        /**
-         * Showing help including core commands
-         */
-        this.ace.flag('help', async (value, _, command) => this.printHelp(value, command), {
-            alias: 'h',
-        });
-        /**
-         * Showing app and AdonisJs version
-         */
-        this.ace.flag('version', async (value) => this.printVersion(value), { alias: 'v' });
-    }
-    /**
-     * Load commands using manifest loader
-     */
-    async loadCommands() {
-        await (0, utils_1.loadAceCommands)(this.kernel.application, this.ace);
-    }
-    /**
-     * Handle application command
-     */
-    async handle(argv) {
-        try {
-            /**
-             * Manifest files to load
-             */
-            await this.loadCommands();
-            /**
-             * Define ace hooks to wire the application (if required)
-             */
-            this.registerAceHooks();
-            /**
-             * Define global flags
-             */
-            this.registerAceFlags();
-            /**
-             * Print help when no arguments have been passed
-             */
-            if (!argv.length) {
-                this.printHelp(true);
-                return;
-            }
-            /**
-             * Hold reference to the command name. We will use this to decide whether
-             * or not to exit the process forcefully after the command has been
-             * executed
-             */
-            this.commandName = argv[0];
-            /**
-             * Listen for the exit signal on ace kernel
-             */
-            this.ace.onExit(async () => {
-                if (this.kernel.hasBooted) {
-                    await this.kernel.close();
-                }
-                if (!this.ace.error) {
-                    process.exit(this.ace.exitCode);
-                }
-                return this.kernel
-                    .handleError(this.ace.error)
-                    .finally(() => process.exit(this.ace.exitCode));
-            });
-            /**
-             * Handle command
-             */
-            await this.ace.handle(argv);
-        }
-        catch (error) {
-            if (!error) {
-                process.exit(1);
-            }
-            this.kernel.handleError(error).finally(() => process.exit(1));
-        }
-    }
-}
-exports.App = App;

package/build/src/Ignitor/Ace/Exceptions/index.d.ts

@@ -1,4 +0,0 @@
-import { Exception } from '@poppinss/utils';
-export declare class AceRuntimeException extends Exception {
-    handle(error: AceRuntimeException): void;
-}

package/build/src/Ignitor/Ace/Exceptions/index.js

@@ -1,19 +0,0 @@
-"use strict";
-/*
- * @adonisjs/core
- *
- * (c) Harminder Virk <virk@adonisjs.com>
- *
- * For the full copyright and license information, please view the LICENSE
- * file that was distributed with this source code.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AceRuntimeException = void 0;
-const cliui_1 = require("@poppinss/cliui");
-const utils_1 = require("@poppinss/utils");
-class AceRuntimeException extends utils_1.Exception {
-    handle(error) {
-        cliui_1.logger.error(error.message);
-    }
-}
-exports.AceRuntimeException = AceRuntimeException;

package/build/src/Ignitor/Ace/GenerateManifest/index.d.ts

@@ -1,28 +0,0 @@
-/**
- * Exposes the API to generate the manifest file
- */
-export declare class GenerateManifest {
-    private appRoot;
-    private kernel;
-    /**
-     * Source root always points to the compiled source
-     * code.
-     */
-    constructor(appRoot: string);
-    /**
-     * Returns manifest object for showing help
-     */
-    static getManifestJSON(): {
-        commandName: string;
-        description: string;
-        args: never[];
-        flags: never[];
-        settings: {};
-        aliases: never[];
-        commandPath: string;
-    };
-    /**
-     * Generates the manifest file for commands
-     */
-    handle(): Promise<void>;
-}

package/build/src/Ignitor/Ace/GenerateManifest/index.js

@@ -1,75 +0,0 @@
-"use strict";
-/*
- * @adonisjs/core
- *
- * (c) Harminder Virk <virk@adonisjs.com>
- *
- * For the full copyright and license information, please view the LICENSE
- * file that was distributed with this source code.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.GenerateManifest = void 0;
-const cliui_1 = require("@poppinss/cliui");
-const ace_1 = require("@adonisjs/ace");
-const Kernel_1 = require("../../Kernel");
-const Exceptions_1 = require("../Exceptions");
-/**
- * Exposes the API to generate the manifest file
- */
-class GenerateManifest {
-    /**
-     * Source root always points to the compiled source
-     * code.
-     */
-    constructor(appRoot) {
-        this.appRoot = appRoot;
-        this.kernel = new Kernel_1.AppKernel(this.appRoot, 'console');
-    }
-    /**
-     * Returns manifest object for showing help
-     */
-    static getManifestJSON() {
-        return {
-            commandName: 'generate:manifest',
-            description: 'Generate ace commands manifest file. Manifest file speeds up commands lookup',
-            args: [],
-            flags: [],
-            settings: {},
-            aliases: [],
-            commandPath: '',
-        };
-    }
-    /**
-     * Generates the manifest file for commands
-     */
-    async handle() {
-        try {
-            this.kernel.registerTsCompilerHook();
-            const commands = this.kernel.application.rcFile.commands;
-            /**
-             * Generating manifest requires us to import the command files to read their
-             * meta data defined as class static properties. However, at this stage
-             * the application is not booted and hence top level IoC container
-             * imports will break
-             */
-            this.kernel.application.container.trap((namespace) => {
-                if (namespace === 'Adonis/Core/Application') {
-                    return this.kernel.application;
-                }
-                return {
-                    __esModule: new Proxy({ namespace }, {
-                        get(target) {
-                            throw new Exceptions_1.AceRuntimeException(`Top level import for module "${target.namespace}" is not allowed in commands. Learn more https://docs.adonisjs.com/guides/ace-commandline#top-level-imports-are-not-allowed`);
-                        },
-                    }),
-                };
-            });
-            await new ace_1.ManifestGenerator(this.appRoot, commands).generate();
-            cliui_1.logger.action('create').succeeded('ace-manifest.json file');
-        }
-        catch (error) {
-            await this.kernel.handleError(error).finally(() => process.exit(1));
-        }
-    }
-}
-exports.GenerateManifest = GenerateManifest;

package/build/src/Ignitor/Ace/index.d.ts

@@ -1,11 +0,0 @@
-/**
- * Exposes the API to execute ace commands.
- */
-export declare class Ace {
-    private appRoot;
-    constructor(appRoot: string);
-    /**
-     * Handles the ace command
-     */
-    handle(argv: string[]): Promise<void>;
-}

package/build/src/Ignitor/Ace/index.js

@@ -1,36 +0,0 @@
-"use strict";
-/*
- * @adonisjs/core
- *
- * (c) Harminder Virk <virk@adonisjs.com>
- *
- * For the full copyright and license information, please view the LICENSE
- * file that was distributed with this source code.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Ace = void 0;
-const App_1 = require("./App");
-const GenerateManifest_1 = require("./GenerateManifest");
-/**
- * Exposes the API to execute ace commands.
- */
-class Ace {
-    constructor(appRoot) {
-        this.appRoot = appRoot;
-    }
-    /**
-     * Handles the ace command
-     */
-    async handle(argv) {
-        process.env.ADONIS_ACE_CWD = this.appRoot;
-        if (argv[0] === 'generate:manifest' && !argv.includes('--help')) {
-            await new GenerateManifest_1.GenerateManifest(this.appRoot).handle();
-            return;
-        }
-        /**
-         * Proxy over to application commands
-         */
-        await new App_1.App(this.appRoot).handle(argv);
-    }
-}
-exports.Ace = Ace;

package/build/src/Ignitor/HttpServer/index.d.ts

@@ -1,56 +0,0 @@
-import { CustomServerCallback } from '@ioc:Adonis/Core/TestUtils';
-import { AppKernel } from '../Kernel';
-/**
- * Exposes the API to setup the application for starting the HTTP
- * server.
- *
- * - Calling "kill" explicitly exists the process.
- * - The "error" event emitted on the server instance explicitly exists the process.
- * - SIGINT and in some case SIGTERM explicitly exists the process.
- */
-export declare class HttpServer {
-    private appRoot;
-    /**
-     * Reference to the HTTP server.
-     */
-    private server;
-    /**
-     * Reference to the app kernel
-     */
-    kernel: AppKernel;
-    application: import("@adonisjs/application").Application;
-    constructor(appRoot: string);
-    /**
-     * Closes the underlying HTTP server
-     */
-    private closeHttpServer;
-    /**
-     * Monitors the HTTP server for close and error events, so that
-     * we can perform a graceful shutdown.
-     */
-    private monitorHttpServer;
-    /**
-     * Creates the HTTP server to handle incoming requests. The server is just
-     * created but not listening on any port.
-     */
-    createServer(serverCallback?: CustomServerCallback): void;
-    /**
-     * Starts the http server a given host and port
-     */
-    listen(): Promise<void>;
-    /**
-     * Start the HTTP server by wiring up the application
-     */
-    start(serverCallback?: CustomServerCallback): Promise<void>;
-    /**
-     * Prepares the application for shutdown. This method will invoke `shutdown`
-     * lifecycle method on the providers and closes the `httpServer`.
-     */
-    close(): Promise<void>;
-    /**
-     * Kills the http server process by attempting to perform a graceful
-     * shutdown or killing the app forcefully as waiting for configured
-     * seconds.
-     */
-    kill(waitTimeout?: number): Promise<void>;
-}

package/build/src/Ignitor/HttpServer/index.js

@@ -1,127 +0,0 @@
-"use strict";
-/*
- * @adonisjs/core
- *
- * (c) Harminder Virk <virk@adonisjs.com>
- *
- * For the full copyright and license information, please view the LICENSE
- * file that was distributed with this source code.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.HttpServer = void 0;
-const Kernel_1 = require("../Kernel");
-const utils_1 = require("../../utils");
-/**
- * Exposes the API to setup the application for starting the HTTP
- * server.
- *
- * - Calling "kill" explicitly exists the process.
- * - The "error" event emitted on the server instance explicitly exists the process.
- * - SIGINT and in some case SIGTERM explicitly exists the process.
- */
-class HttpServer {
-    constructor(appRoot) {
-        this.appRoot = appRoot;
-        /**
-         * Reference to the app kernel
-         */
-        this.kernel = new Kernel_1.AppKernel(this.appRoot, 'web');
-        this.application = this.kernel.application;
-    }
-    /**
-     * Closes the underlying HTTP server
-     */
-    closeHttpServer() {
-        return new Promise((resolve) => this.server.instance.close(() => resolve()));
-    }
-    /**
-     * Monitors the HTTP server for close and error events, so that
-     * we can perform a graceful shutdown.
-     */
-    monitorHttpServer() {
-        this.server.instance.on('close', async () => {
-            this.application.logger.trace('closing http server');
-            this.server.instance.removeAllListeners();
-            this.application.isShuttingDown = true;
-        });
-        this.server.instance.on('error', async (error) => {
-            this.application.logger.error(error, error.message);
-            await this.kill(3000);
-        });
-    }
-    /**
-     * Creates the HTTP server to handle incoming requests. The server is just
-     * created but not listening on any port.
-     */
-    createServer(serverCallback) {
-        this.server = this.application.container.use('Adonis/Core/Server');
-        (0, utils_1.createHttpServer)(this.application, this.server, serverCallback);
-    }
-    /**
-     * Starts the http server a given host and port
-     */
-    listen() {
-        return new Promise(async (resolve, reject) => {
-            try {
-                await this.kernel.start(() => this.close());
-                const host = this.application.env.get('HOST', '0.0.0.0');
-                const port = Number(this.application.env.get('PORT', '3333'));
-                this.server.instance.listen(port, host, () => {
-                    this.application.logger.info('started server on %s:%s', host, port);
-                    this.kernel.ready({ port: port, host: host });
-                    resolve();
-                });
-            }
-            catch (error) {
-                reject(error);
-            }
-        });
-    }
-    /**
-     * Start the HTTP server by wiring up the application
-     */
-    async start(serverCallback) {
-        try {
-            await this.kernel.boot();
-            this.createServer(serverCallback);
-            this.monitorHttpServer();
-            await this.listen();
-        }
-        catch (error) {
-            await this.kernel.handleError(error);
-        }
-    }
-    /**
-     * Prepares the application for shutdown. This method will invoke `shutdown`
-     * lifecycle method on the providers and closes the `httpServer`.
-     */
-    async close() {
-        /**
-         * Close the HTTP server before excuting the `shutdown` hooks. This ensures that
-         * we are not accepting any new request during cool off.
-         */
-        await this.closeHttpServer();
-        await this.kernel.close();
-    }
-    /**
-     * Kills the http server process by attempting to perform a graceful
-     * shutdown or killing the app forcefully as waiting for configured
-     * seconds.
-     */
-    async kill(waitTimeout = 3000) {
-        this.application.logger.trace('forcefully killing http server');
-        try {
-            await Promise.race([
-                this.close(),
-                new Promise((resolve) => {
-                    setTimeout(resolve, waitTimeout);
-                }),
-            ]);
-            process.exit(0);
-        }
-        catch (error) {
-            await this.kernel.handleError(error).finally(() => process.exit(1));
-        }
-    }
-}
-exports.HttpServer = HttpServer;