@adonisjs/core 6.19.0 → 7.0.0-next.1

package/build/commands/add.d.ts

@@ -1,23 +1,54 @@
-import { CommandOptions } from '../types/ace.js';
-import { BaseCommand } from '../modules/ace/main.js';
-declare const KNOWN_PACKAGE_MANAGERS: readonly ["npm", "pnpm", "bun", "yarn", "yarn@berry", "pnpm@6"];
+import { type CommandOptions } from '../types/ace.ts';
+import { BaseCommand } from '../modules/ace/main.ts';
+import { type SupportedPackageManager } from '@adonisjs/assembler/types';
 /**
  * The install command is used to `npm install` and `node ace configure` a new package
  * in one go.
+ *
+ * @example
+ * ```
+ * ace add @adonisjs/lucid
+ * ace add @adonisjs/session --dev
+ * ace add vinejs --force
+ * ace add edge --package-manager=pnpm
+ * ```
  */
 export default class Add extends BaseCommand {
     #private;
+    /**
+     * The command name
+     */
     static commandName: string;
+    /**
+     * The command description
+     */
     static description: string;
+    /**
+     * Command options configuration
+     */
     static options: CommandOptions;
+    /**
+     * Package name to install and configure
+     */
     name: string;
+    /**
+     * Display logs in verbose mode
+     */
     verbose?: boolean;
-    packageManager?: (typeof KNOWN_PACKAGE_MANAGERS)[number];
+    /**
+     * Define the package manager you want to use
+     */
+    packageManager?: SupportedPackageManager;
+    /**
+     * Should we install the package as a dev dependency
+     */
     dev?: boolean;
+    /**
+     * Forcefully overwrite existing files
+     */
     force?: boolean;
     /**
      * Run method is invoked by ace automatically
      */
     run(): Promise<void>;
 }
-export {};

package/build/commands/add.js

@@ -12,29 +12,34 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
-import { detectPackageManager, installPackage } from '@antfu/install-pkg';
-import { args, BaseCommand, flags } from '../modules/ace/main.js';
-const KNOWN_PACKAGE_MANAGERS = ['npm', 'pnpm', 'bun', 'yarn', 'yarn@berry', 'pnpm@6'];
+import { args, BaseCommand, flags } from "../modules/ace/main.js";
 /**
  * The install command is used to `npm install` and `node ace configure` a new package
  * in one go.
+ *
+ * @example
+ * ```
+ * ace add @adonisjs/lucid
+ * ace add @adonisjs/session --dev
+ * ace add vinejs --force
+ * ace add edge --package-manager=pnpm
+ * ```
  */
 export default class Add extends BaseCommand {
+    /**
+     * The command name
+     */
     static commandName = 'add';
+    /**
+     * The command description
+     */
     static description = 'Install and configure a package';
+    /**
+     * Command options configuration
+     */
     static options = {
         allowUnknownFlags: true,
     };
-    /**
-     * Detect the package manager to use
-     */
-    async #getPackageManager() {
-        const packageManager = this.packageManager || (await detectPackageManager(this.app.makePath())) || 'npm';
-        if (KNOWN_PACKAGE_MANAGERS.some((knownPackageManager) => knownPackageManager === packageManager)) {
-            return packageManager;
-        }
-        throw new Error('Invalid package manager. Must be one of npm, pnpm, bun or yarn');
-    }
     /**
      * Configure the package by delegating the work to the `node ace configure` command
      */
@@ -53,40 +58,10 @@ export default class Add extends BaseCommand {
         ].filter(Boolean);
         return await this.kernel.exec('configure', configureArgs);
     }
-    /**
-     * Install the package using the selected package manager
-     */
-    async #installPackage(npmPackageName) {
-        const colors = this.colors;
-        const spinner = this.logger
-            .await(`installing ${colors.green(this.name)} using ${colors.grey(this.packageManager)}`)
-            .start();
-        spinner.start();
-        try {
-            await installPackage(npmPackageName, {
-                dev: this.dev,
-                silent: this.verbose === true ? false : true,
-                cwd: this.app.makePath(),
-                packageManager: this.packageManager,
-            });
-            spinner.update('package installed successfully');
-            spinner.stop();
-            return true;
-        }
-        catch (error) {
-            spinner.update('unable to install the package');
-            spinner.stop();
-            this.logger.fatal(error);
-            this.exitCode = 1;
-            return false;
-        }
-    }
     /**
      * Run method is invoked by ace automatically
      */
     async run() {
-        const colors = this.colors;
-        this.packageManager = await this.#getPackageManager();
         /**
          * Handle special packages to configure
          */
@@ -97,23 +72,12 @@ export default class Add extends BaseCommand {
         else if (this.name === 'edge') {
             npmPackageName = 'edge.js';
         }
-        /**
-         * Prompt the user to confirm the installation
-         */
-        const cmd = colors.grey(`${this.packageManager} add ${this.dev ? '-D ' : ''}${this.name}`);
-        this.logger.info(`Installing the package using the following command : ${cmd}`);
-        const shouldInstall = await this.prompt.confirm('Continue ?', {
-            name: 'install',
-            default: true,
-        });
-        if (!shouldInstall) {
-            this.logger.info('Installation cancelled');
-            return;
-        }
         /**
          * Install package
          */
-        const pkgWasInstalled = await this.#installPackage(npmPackageName);
+        const codemods = await this.createCodemods();
+        codemods.verboseInstallOutput = !!this.verbose;
+        const pkgWasInstalled = await codemods.installPackages([{ name: npmPackageName, isDevDependency: !!this.dev }], this.packageManager);
         if (!pkgWasInstalled) {
             return;
         }
@@ -123,10 +87,10 @@ export default class Add extends BaseCommand {
         const { exitCode } = await this.#configurePackage();
         this.exitCode = exitCode;
         if (exitCode === 0) {
-            this.logger.success(`Installed and configured ${colors.green(this.name)}`);
+            this.logger.success(`Installed and configured ${this.colors.green(this.name)}`);
         }
         else {
-            this.logger.fatal(`Unable to configure ${colors.green(this.name)}`);
+            this.logger.fatal(`Unable to configure ${this.colors.green(this.name)}`);
         }
     }
 }
@@ -137,7 +101,7 @@ __decorate([
     flags.boolean({ description: 'Display logs in verbose mode' })
 ], Add.prototype, "verbose", void 0);
 __decorate([
-    flags.string({ description: 'Select the package manager you want to use' })
+    flags.string({ description: 'Define the package manager you want to use' })
 ], Add.prototype, "packageManager", void 0);
 __decorate([
     flags.boolean({ description: 'Should we install the package as a dev dependency', alias: 'D' })

package/build/commands/build.d.ts

@@ -1,17 +1,37 @@
-import { BaseCommand } from '../modules/ace/main.js';
+import { BaseCommand } from '../modules/ace/main.ts';
 /**
  * Create the production build by compiling TypeScript source and the
  * frontend assets
+ *
+ * @example
+ * ```
+ * ace build
+ * ace build --ignore-ts-errors
+ * ace build --package-manager=pnpm
+ * ```
  */
 export default class Build extends BaseCommand {
     #private;
+    /**
+     * The command name
+     */
     static commandName: string;
+    /**
+     * The command description
+     */
     static description: string;
+    /**
+     * Help text for the command
+     */
     static help: string[];
+    /**
+     * Ignore TypeScript errors and continue with the build process
+     */
     ignoreTsErrors?: boolean;
+    /**
+     * Define the package manager to copy the appropriate lock file
+     */
     packageManager?: 'npm' | 'pnpm' | 'yarn' | 'yarn@berry' | 'bun';
-    assets?: boolean;
-    assetsArgs?: string[];
     /**
      * Build application
      */

package/build/commands/build.js

@@ -12,15 +12,31 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
-import { BaseCommand, flags } from '../modules/ace/main.js';
-import { detectAssetsBundler, importAssembler, importTypeScript } from '../src/internal_helpers.js';
+import { BaseCommand, flags } from "../modules/ace/main.js";
+import { importAssembler, importTypeScript } from "../src/utils.js";
 /**
  * Create the production build by compiling TypeScript source and the
  * frontend assets
+ *
+ * @example
+ * ```
+ * ace build
+ * ace build --ignore-ts-errors
+ * ace build --package-manager=pnpm
+ * ```
  */
 export default class Build extends BaseCommand {
+    /**
+     * The command name
+     */
     static commandName = 'build';
+    /**
+     * The command description
+     */
     static description = 'Build application for production by compiling frontend assets and TypeScript source to JavaScript';
+    /**
+     * Help text for the command
+     */
     static help = [
         'Create the production build using the following command.',
         '```',
@@ -35,6 +51,8 @@ export default class Build extends BaseCommand {
     ];
     /**
      * Log a development dependency is missing
+     *
+     * @param dependency - The name of the missing dependency
      */
     #logMissingDevelopmentDependency(dependency) {
         this.logger.error([
@@ -45,22 +63,6 @@ export default class Build extends BaseCommand {
             'If you are using the build command inside a CI or with a deployment platform, make sure the NODE_ENV is set to "development"',
         ].join('\n'));
     }
-    /**
-     * Returns the assets bundler config
-     */
-    async #getAssetsBundlerConfig() {
-        const assetsBundler = await detectAssetsBundler(this.app);
-        return assetsBundler
-            ? {
-                enabled: this.assets === false ? false : true,
-                driver: assetsBundler.name,
-                cmd: assetsBundler.build.command,
-                args: (assetsBundler.build.args || []).concat(this.assetsArgs || []),
-            }
-            : {
-                enabled: false,
-            };
-    }
     /**
      * Build application
      */
@@ -78,18 +80,14 @@ export default class Build extends BaseCommand {
             return;
         }
         const bundler = new assembler.Bundler(this.app.appRoot, ts, {
-            assets: await this.#getAssetsBundlerConfig(),
             metaFiles: this.app.rcFile.metaFiles,
-            hooks: {
-                onBuildStarting: this.app.rcFile.hooks?.onBuildStarting,
-                onBuildCompleted: this.app.rcFile.hooks?.onBuildCompleted,
-            },
+            hooks: this.app.rcFile.hooks,
         });
         /**
          * Share command logger with assembler, so that CLI flags like --no-ansi has
          * similar impact for assembler logs as well.
          */
-        bundler.setLogger(this.logger);
+        bundler.ui.logger = this.logger;
         /**
          * Bundle project for production
          */
@@ -108,15 +106,3 @@ __decorate([
         description: 'Define the package manager to copy the appropriate lock file',
     })
 ], Build.prototype, "packageManager", void 0);
-__decorate([
-    flags.boolean({
-        description: 'Build frontend assets',
-        showNegatedVariantInHelp: true,
-        default: true,
-    })
-], Build.prototype, "assets", void 0);
-__decorate([
-    flags.array({
-        description: 'Define CLI arguments to pass to the assets bundler',
-    })
-], Build.prototype, "assetsArgs", void 0);

package/build/commands/commands.json

@@ -1 +1 @@
-{"commands":[{"commandName":"add","description":"Install and configure a package","help":"","namespace":null,"aliases":[],"flags":[{"name":"verbose","flagName":"verbose","required":false,"type":"boolean","description":"Display logs in verbose mode"},{"name":"packageManager","flagName":"package-manager","required":false,"type":"string","description":"Select the package manager you want to use"},{"name":"dev","flagName":"dev","required":false,"type":"boolean","description":"Should we install the package as a dev dependency","alias":"D"},{"name":"force","flagName":"force","required":false,"type":"boolean","description":"Forcefully overwrite existing files"}],"args":[{"name":"name","argumentName":"name","required":true,"description":"Package name","type":"string"}],"options":{"allowUnknownFlags":true},"filePath":"add.js"},{"commandName":"build","description":"Build application for production by compiling frontend assets and TypeScript source to JavaScript","help":["Create the production build using the following command.","```","{{ binaryName }} build","```","","The assets bundler dev server runs automatically after detecting vite config or webpack config files","You may pass vite CLI args using the --assets-args command line flag.","```","{{ binaryName }} build --assets-args=\"--debug --base=/public\"","```"],"namespace":null,"aliases":[],"flags":[{"name":"ignoreTsErrors","flagName":"ignore-ts-errors","required":false,"type":"boolean","description":"Ignore TypeScript errors and continue with the build process"},{"name":"packageManager","flagName":"package-manager","required":false,"type":"string","description":"Define the package manager to copy the appropriate lock file"},{"name":"assets","flagName":"assets","required":false,"type":"boolean","description":"Build frontend assets","showNegatedVariantInHelp":true,"default":true},{"name":"assetsArgs","flagName":"assets-args","required":false,"type":"array","description":"Define CLI arguments to pass to the assets bundler"}],"args":[],"options":{},"filePath":"build.js"},{"commandName":"configure","description":"Configure a package after it has been installed","help":"","namespace":null,"aliases":[],"flags":[{"name":"verbose","flagName":"verbose","required":false,"type":"boolean","description":"Display logs in verbose mode","alias":"v"},{"name":"force","flagName":"force","required":false,"type":"boolean","description":"Forcefully overwrite existing files","alias":"f"}],"args":[{"name":"name","argumentName":"name","required":true,"description":"Package name","type":"string"}],"options":{"allowUnknownFlags":true},"filePath":"configure.js"},{"commandName":"eject","description":"Eject scaffolding stubs to your application root","help":"","namespace":null,"aliases":[],"flags":[{"name":"pkg","flagName":"pkg","required":false,"type":"string","description":"Mention package name for searching stubs","default":"@adonisjs/core"}],"args":[{"name":"stubPath","argumentName":"stub-path","required":true,"description":"Path to the stubs directory or a single stub file","type":"string"}],"options":{},"filePath":"eject.js"},{"commandName":"env:add","description":"Add a new environment variable","help":"","namespace":"env","aliases":[],"flags":[{"name":"type","flagName":"type","required":false,"type":"string","description":"Type of the variable"},{"name":"enumValues","flagName":"enum-values","required":false,"type":"array","description":"Allowed values for the enum type in a comma-separated list","default":[""]}],"args":[{"name":"name","argumentName":"name","required":false,"description":"Variable name. Will be converted to screaming snake case","type":"string"},{"name":"value","argumentName":"value","required":false,"description":"Variable value","type":"string"}],"options":{"allowUnknownFlags":true},"filePath":"env/add.js"},{"commandName":"generate:key","description":"Generate a cryptographically secure random application key","help":"","namespace":"generate","aliases":[],"flags":[{"name":"show","flagName":"show","required":false,"type":"boolean","description":"Display the key on the terminal, instead of writing it to .env file"},{"name":"force","flagName":"force","required":false,"type":"boolean","description":"Force update .env file in production environment"}],"args":[],"options":{},"filePath":"generate_key.js"},{"commandName":"inspect:rcfile","description":"Inspect the RC file with its default values","help":"","namespace":"inspect","aliases":[],"flags":[],"args":[],"options":{},"filePath":"inspect_rcfile.js"},{"commandName":"list:routes","description":"List application routes. This command will boot the application in the console environment","help":"","namespace":"list","aliases":[],"flags":[{"name":"middleware","flagName":"middleware","required":false,"type":"array","description":"View routes that includes all the mentioned middleware names. Use * to see routes that are using one or more middleware"},{"name":"ignoreMiddleware","flagName":"ignore-middleware","required":false,"type":"array","description":"View routes that does not include all the mentioned middleware names. Use * to see routes that are using zero middleware"},{"name":"json","flagName":"json","required":false,"type":"boolean","description":"Get routes list as a JSON string"},{"name":"table","flagName":"table","required":false,"type":"boolean","description":"View list of routes as a table"}],"args":[{"name":"match","argumentName":"match","required":false,"description":"Find routes matching the given keyword. Route name, pattern and controller name will be searched against the keyword","type":"string"}],"options":{"startApp":true},"filePath":"list/routes.js"},{"commandName":"make:command","description":"Create a new ace command class","help":"","namespace":"make","aliases":[],"flags":[],"args":[{"name":"name","argumentName":"name","required":true,"description":"Name of the command","type":"string"}],"options":{},"filePath":"make/command.js"},{"commandName":"make:controller","description":"Create a new HTTP controller class","help":"","namespace":"make","aliases":[],"flags":[{"name":"singular","flagName":"singular","required":false,"type":"boolean","description":"Generate controller in singular form","alias":"s"},{"name":"resource","flagName":"resource","required":false,"type":"boolean","description":"Generate resourceful controller with methods to perform CRUD actions on a resource","alias":"r"},{"name":"api","flagName":"api","required":false,"type":"boolean","description":"Generate resourceful controller without the \"edit\" and the \"create\" methods","alias":"a"}],"args":[{"name":"name","argumentName":"name","required":true,"description":"The name of the controller","type":"string"},{"name":"actions","argumentName":"actions","required":false,"description":"Create controller with custom method names","type":"spread"}],"options":{"allowUnknownFlags":true},"filePath":"make/controller.js"},{"commandName":"make:event","description":"Create a new event class","help":"","namespace":"make","aliases":[],"flags":[],"args":[{"name":"name","argumentName":"name","required":true,"description":"Name of the event","type":"string"}],"options":{"allowUnknownFlags":true},"filePath":"make/event.js"},{"commandName":"make:exception","description":"Create a new custom exception class","help":"","namespace":"make","aliases":[],"flags":[],"args":[{"name":"name","argumentName":"name","required":true,"description":"Name of the exception","type":"string"}],"options":{"allowUnknownFlags":true},"filePath":"make/exception.js"},{"commandName":"make:listener","description":"Create a new event listener class","help":"","namespace":"make","aliases":[],"flags":[{"name":"event","flagName":"event","required":false,"type":"string","description":"Generate an event class alongside the listener","alias":"e"}],"args":[{"name":"name","argumentName":"name","required":true,"description":"Name of the event listener","type":"string"}],"options":{"allowUnknownFlags":true},"filePath":"make/listener.js"},{"commandName":"make:middleware","description":"Create a new middleware class for HTTP requests","help":"","namespace":"make","aliases":[],"flags":[{"name":"stack","flagName":"stack","required":false,"type":"string","description":"The stack in which to register the middleware","alias":"s"}],"args":[{"name":"name","argumentName":"name","required":true,"description":"Name of the middleware","type":"string"}],"options":{"allowUnknownFlags":true},"filePath":"make/middleware.js"},{"commandName":"make:preload","description":"Create a new preload file inside the start directory","help":"","namespace":"make","aliases":[],"flags":[{"name":"register","flagName":"register","required":false,"type":"boolean","description":"Auto register the preload file inside the .adonisrc.ts file","showNegatedVariantInHelp":true,"alias":"r"},{"name":"environments","flagName":"environments","required":false,"type":"array","description":"Define the preload file's environment. Accepted values are \"web,console,test,repl\"","alias":"e"}],"args":[{"name":"name","argumentName":"name","required":true,"description":"Name of the preload file","type":"string"}],"options":{},"filePath":"make/preload.js"},{"commandName":"make:provider","description":"Create a new service provider class","help":"","namespace":"make","aliases":[],"flags":[{"name":"register","flagName":"register","required":false,"type":"boolean","description":"Auto register the provider inside the .adonisrc.ts file","showNegatedVariantInHelp":true,"alias":"r"},{"name":"environments","flagName":"environments","required":false,"type":"array","description":"Define the provider environment. Accepted values are \"web,console,test,repl\"","alias":"e"}],"args":[{"name":"name","argumentName":"name","required":true,"description":"Name of the provider","type":"string"}],"options":{},"filePath":"make/provider.js"},{"commandName":"make:service","description":"Create a new service class","help":"","namespace":"make","aliases":[],"flags":[],"args":[{"name":"name","argumentName":"name","required":true,"description":"Name of the service","type":"string"}],"options":{"allowUnknownFlags":true},"filePath":"make/service.js"},{"commandName":"make:test","description":"Create a new Japa test file","help":"","namespace":"make","aliases":[],"flags":[{"name":"suite","flagName":"suite","required":false,"type":"string","description":"The suite for which to create the test file","alias":"s"}],"args":[{"name":"name","argumentName":"name","required":true,"description":"Name of the test file","type":"string"}],"options":{},"filePath":"make/test.js"},{"commandName":"make:validator","description":"Create a new file to define VineJS validators","help":"","namespace":"make","aliases":[],"flags":[{"name":"resource","flagName":"resource","required":false,"type":"boolean","description":"Create a file with pre-defined validators for create and update actions"}],"args":[{"name":"name","argumentName":"name","required":true,"description":"Name of the validator file","type":"string"}],"options":{"allowUnknownFlags":true},"filePath":"make/validator.js"},{"commandName":"make:view","description":"Create a new Edge.js template file","help":"","namespace":"make","aliases":[],"flags":[],"args":[{"name":"name","argumentName":"name","required":true,"description":"Name of the template","type":"string"}],"options":{},"filePath":"make/view.js"},{"commandName":"repl","description":"Start a new REPL session","help":"","namespace":null,"aliases":[],"flags":[],"args":[],"options":{"startApp":true,"staysAlive":true},"filePath":"repl.js"},{"commandName":"serve","description":"Start the development HTTP server along with the file watcher to perform restarts on file change","help":["Start the development server with file watcher using the following command.","```","{{ binaryName }} serve --watch","```","","You can also start the server with HMR support using the following command.","```","{{ binaryName }} serve --hmr","```","","The assets bundler dev server runs automatically after detecting vite config or webpack config files","You may pass vite CLI args using the --assets-args command line flag.","```","{{ binaryName }} serve --assets-args=\"--debug --base=/public\"","```"],"namespace":null,"aliases":[],"flags":[{"name":"hmr","flagName":"hmr","required":false,"type":"boolean","description":"Start the server with HMR support"},{"name":"watch","flagName":"watch","required":false,"type":"boolean","description":"Watch filesystem and restart the HTTP server on file change","alias":"w"},{"name":"poll","flagName":"poll","required":false,"type":"boolean","description":"Use polling to detect filesystem changes","alias":"p"},{"name":"clear","flagName":"clear","required":false,"type":"boolean","description":"Clear the terminal for new logs after file change","showNegatedVariantInHelp":true,"default":true},{"name":"assets","flagName":"assets","required":false,"type":"boolean","description":"Start assets bundler dev server","showNegatedVariantInHelp":true,"default":true},{"name":"assetsArgs","flagName":"assets-args","required":false,"type":"array","description":"Define CLI arguments to pass to the assets bundler"}],"args":[],"options":{"staysAlive":true},"filePath":"serve.js"},{"commandName":"test","description":"Run tests along with the file watcher to re-run tests on file change","help":"","namespace":null,"aliases":[],"flags":[{"name":"files","flagName":"files","required":false,"type":"array","description":"Filter tests by the filename"},{"name":"tags","flagName":"tags","required":false,"type":"array","description":"Filter tests by tags"},{"name":"groups","flagName":"groups","required":false,"type":"array","description":"Filter tests by parent group title"},{"name":"tests","flagName":"tests","required":false,"type":"array","description":"Filter tests by test title"},{"name":"reporters","flagName":"reporters","required":false,"type":"array","description":"Activate one or more test reporters"},{"name":"watch","flagName":"watch","required":false,"type":"boolean","description":"Watch filesystem and re-run tests on file change"},{"name":"poll","flagName":"poll","required":false,"type":"boolean","description":"Use polling to detect filesystem changes"},{"name":"timeout","flagName":"timeout","required":false,"type":"number","description":"Define default timeout for all tests"},{"name":"retries","flagName":"retries","required":false,"type":"number","description":"Define default retries for all tests"},{"name":"failed","flagName":"failed","required":false,"type":"boolean","description":"Execute tests failed during the last run"},{"name":"clear","flagName":"clear","required":false,"type":"boolean","description":"Clear the terminal for new logs after file change","showNegatedVariantInHelp":true,"default":true},{"name":"assets","flagName":"assets","required":false,"type":"boolean","description":"Start assets bundler dev server.","showNegatedVariantInHelp":true,"default":true},{"name":"assetsArgs","flagName":"assets-args","required":false,"type":"array","description":"Define CLI arguments to pass to the assets bundler"}],"args":[{"name":"suites","argumentName":"suites","required":false,"description":"Mention suite names to run tests for selected suites","type":"spread"}],"options":{"allowUnknownFlags":true,"staysAlive":true},"filePath":"test.js"}],"version":1}
+{"commands":[{"commandName":"add","description":"Install and configure a package","help":"","namespace":null,"aliases":[],"flags":[{"name":"verbose","flagName":"verbose","required":false,"type":"boolean","description":"Display logs in verbose mode"},{"name":"packageManager","flagName":"package-manager","required":false,"type":"string","description":"Define the package manager you want to use"},{"name":"dev","flagName":"dev","required":false,"type":"boolean","description":"Should we install the package as a dev dependency","alias":"D"},{"name":"force","flagName":"force","required":false,"type":"boolean","description":"Forcefully overwrite existing files"}],"args":[{"name":"name","argumentName":"name","required":true,"description":"Package name","type":"string"}],"options":{"allowUnknownFlags":true},"filePath":"add.js"},{"commandName":"build","description":"Build application for production by compiling frontend assets and TypeScript source to JavaScript","help":["Create the production build using the following command.","```","{{ binaryName }} build","```","","The assets bundler dev server runs automatically after detecting vite config or webpack config files","You may pass vite CLI args using the --assets-args command line flag.","```","{{ binaryName }} build --assets-args=\"--debug --base=/public\"","```"],"namespace":null,"aliases":[],"flags":[{"name":"ignoreTsErrors","flagName":"ignore-ts-errors","required":false,"type":"boolean","description":"Ignore TypeScript errors and continue with the build process"},{"name":"packageManager","flagName":"package-manager","required":false,"type":"string","description":"Define the package manager to copy the appropriate lock file"}],"args":[],"options":{},"filePath":"build.js"},{"commandName":"configure","description":"Configure a package after it has been installed","help":"","namespace":null,"aliases":[],"flags":[{"name":"verbose","flagName":"verbose","required":false,"type":"boolean","description":"Display logs in verbose mode","alias":"v"},{"name":"force","flagName":"force","required":false,"type":"boolean","description":"Forcefully overwrite existing files","alias":"f"}],"args":[{"name":"name","argumentName":"name","required":true,"description":"Package name","type":"string"}],"options":{"allowUnknownFlags":true},"filePath":"configure.js"},{"commandName":"eject","description":"Eject scaffolding stubs to your application root","help":"","namespace":null,"aliases":[],"flags":[{"name":"pkg","flagName":"pkg","required":false,"type":"string","description":"Mention package name for searching stubs","default":"@adonisjs/core"}],"args":[{"name":"stubPath","argumentName":"stub-path","required":true,"description":"Path to the stubs directory or a single stub file","type":"string"}],"options":{},"filePath":"eject.js"},{"commandName":"env:add","description":"Add a new environment variable","help":"","namespace":"env","aliases":[],"flags":[{"name":"type","flagName":"type","required":false,"type":"string","description":"Type of the variable"},{"name":"enumValues","flagName":"enum-values","required":false,"type":"array","description":"Allowed values for the enum type in a comma-separated list","default":[""]}],"args":[{"name":"name","argumentName":"name","required":false,"description":"Variable name. Will be converted to screaming snake case","type":"string"},{"name":"value","argumentName":"value","required":false,"description":"Variable value","type":"string"}],"options":{"allowUnknownFlags":true},"filePath":"env/add.js"},{"commandName":"generate:key","description":"Generate a cryptographically secure random application key","help":"","namespace":"generate","aliases":[],"flags":[{"name":"show","flagName":"show","required":false,"type":"boolean","description":"Display the key on the terminal, instead of writing it to .env file"},{"name":"force","flagName":"force","required":false,"type":"boolean","description":"Force update .env file in production environment"}],"args":[],"options":{},"filePath":"generate_key.js"},{"commandName":"inspect:rcfile","description":"Inspect the RC file with its default values","help":"","namespace":"inspect","aliases":[],"flags":[],"args":[],"options":{},"filePath":"inspect_rcfile.js"},{"commandName":"list:routes","description":"List application routes. This command will boot the application in the console environment","help":"","namespace":"list","aliases":[],"flags":[{"name":"middleware","flagName":"middleware","required":false,"type":"array","description":"View routes that includes all the mentioned middleware names. Use * to see routes that are using one or more middleware"},{"name":"ignoreMiddleware","flagName":"ignore-middleware","required":false,"type":"array","description":"View routes that does not include all the mentioned middleware names. Use * to see routes that are using zero middleware"},{"name":"json","flagName":"json","required":false,"type":"boolean","description":"Get routes list as a JSON string"},{"name":"table","flagName":"table","required":false,"type":"boolean","description":"View list of routes as a table"}],"args":[{"name":"match","argumentName":"match","required":false,"description":"Find routes matching the given keyword. Route name, pattern and controller name will be searched against the keyword","type":"string"}],"options":{"startApp":true},"filePath":"list/routes.js"},{"commandName":"make:command","description":"Create a new ace command class","help":"","namespace":"make","aliases":[],"flags":[],"args":[{"name":"name","argumentName":"name","required":true,"description":"Name of the command","type":"string"}],"options":{},"filePath":"make/command.js"},{"commandName":"make:controller","description":"Create a new HTTP controller class","help":"","namespace":"make","aliases":[],"flags":[{"name":"singular","flagName":"singular","required":false,"type":"boolean","description":"Generate controller in singular form","alias":"s"},{"name":"resource","flagName":"resource","required":false,"type":"boolean","description":"Generate resourceful controller with methods to perform CRUD actions on a resource","alias":"r"},{"name":"api","flagName":"api","required":false,"type":"boolean","description":"Generate resourceful controller without the \"edit\" and the \"create\" methods","alias":"a"}],"args":[{"name":"name","argumentName":"name","required":true,"description":"The name of the controller","type":"string"},{"name":"actions","argumentName":"actions","required":false,"description":"Create controller with custom method names","type":"spread"}],"options":{"allowUnknownFlags":true},"filePath":"make/controller.js"},{"commandName":"make:event","description":"Create a new event class","help":"","namespace":"make","aliases":[],"flags":[],"args":[{"name":"name","argumentName":"name","required":true,"description":"Name of the event","type":"string"}],"options":{"allowUnknownFlags":true},"filePath":"make/event.js"},{"commandName":"make:exception","description":"Create a new custom exception class","help":"","namespace":"make","aliases":[],"flags":[],"args":[{"name":"name","argumentName":"name","required":true,"description":"Name of the exception","type":"string"}],"options":{"allowUnknownFlags":true},"filePath":"make/exception.js"},{"commandName":"make:listener","description":"Create a new event listener class","help":"","namespace":"make","aliases":[],"flags":[{"name":"event","flagName":"event","required":false,"type":"string","description":"Generate an event class alongside the listener","alias":"e"}],"args":[{"name":"name","argumentName":"name","required":true,"description":"Name of the event listener","type":"string"}],"options":{"allowUnknownFlags":true},"filePath":"make/listener.js"},{"commandName":"make:middleware","description":"Create a new middleware class for HTTP requests","help":"","namespace":"make","aliases":[],"flags":[{"name":"stack","flagName":"stack","required":false,"type":"string","description":"The stack in which to register the middleware","alias":"s"}],"args":[{"name":"name","argumentName":"name","required":true,"description":"Name of the middleware","type":"string"}],"options":{"allowUnknownFlags":true},"filePath":"make/middleware.js"},{"commandName":"make:preload","description":"Create a new preload file inside the start directory","help":"","namespace":"make","aliases":[],"flags":[{"name":"register","flagName":"register","required":false,"type":"boolean","description":"Auto register the preload file inside the .adonisrc.ts file","showNegatedVariantInHelp":true,"alias":"r"},{"name":"environments","flagName":"environments","required":false,"type":"array","description":"Define the preload file's environment. Accepted values are \"web,console,test,repl\"","alias":"e"}],"args":[{"name":"name","argumentName":"name","required":true,"description":"Name of the preload file","type":"string"}],"options":{},"filePath":"make/preload.js"},{"commandName":"make:provider","description":"Create a new service provider class","help":"","namespace":"make","aliases":[],"flags":[{"name":"register","flagName":"register","required":false,"type":"boolean","description":"Auto register the provider inside the .adonisrc.ts file","showNegatedVariantInHelp":true,"alias":"r"},{"name":"environments","flagName":"environments","required":false,"type":"array","description":"Define the provider environment. Accepted values are \"web,console,test,repl\"","alias":"e"}],"args":[{"name":"name","argumentName":"name","required":true,"description":"Name of the provider","type":"string"}],"options":{},"filePath":"make/provider.js"},{"commandName":"make:service","description":"Create a new service class","help":"","namespace":"make","aliases":[],"flags":[],"args":[{"name":"name","argumentName":"name","required":true,"description":"Name of the service","type":"string"}],"options":{"allowUnknownFlags":true},"filePath":"make/service.js"},{"commandName":"make:test","description":"Create a new Japa test file","help":"","namespace":"make","aliases":[],"flags":[{"name":"suite","flagName":"suite","required":false,"type":"string","description":"The suite for which to create the test file","alias":"s"}],"args":[{"name":"name","argumentName":"name","required":true,"description":"Name of the test file","type":"string"}],"options":{},"filePath":"make/test.js"},{"commandName":"make:transformer","description":"Create a new transformer class","help":"","namespace":"make","aliases":[],"flags":[],"args":[{"name":"name","argumentName":"name","required":true,"description":"Entity name for which to generate the transformer","type":"string"}],"options":{"allowUnknownFlags":true},"filePath":"make/transformer.js"},{"commandName":"make:validator","description":"Create a new file to define VineJS validators","help":"","namespace":"make","aliases":[],"flags":[{"name":"resource","flagName":"resource","required":false,"type":"boolean","description":"Create a file with pre-defined validators for create and update actions"}],"args":[{"name":"name","argumentName":"name","required":true,"description":"Name of the validator file","type":"string"}],"options":{"allowUnknownFlags":true},"filePath":"make/validator.js"},{"commandName":"make:view","description":"Create a new Edge.js template file","help":"","namespace":"make","aliases":[],"flags":[],"args":[{"name":"name","argumentName":"name","required":true,"description":"Name of the template","type":"string"}],"options":{},"filePath":"make/view.js"},{"commandName":"repl","description":"Start a new REPL session","help":"","namespace":null,"aliases":[],"flags":[],"args":[],"options":{"startApp":true,"staysAlive":true},"filePath":"repl.js"},{"commandName":"serve","description":"Start the development HTTP server along with the file watcher to perform restarts on file change","help":["Start the development server with file watcher using the following command.","```","{{ binaryName }} serve --watch","```","","You can also start the server with HMR support using the following command.","```","{{ binaryName }} serve --hmr","```","","The assets bundler dev server runs automatically after detecting vite config or webpack config files","You may pass vite CLI args using the --assets-args command line flag.","```","{{ binaryName }} serve --assets-args=\"--debug --base=/public\"","```"],"namespace":null,"aliases":[],"flags":[{"name":"hmr","flagName":"hmr","required":false,"type":"boolean","description":"Start the server with HMR support"},{"name":"watch","flagName":"watch","required":false,"type":"boolean","description":"Watch filesystem and restart the HTTP server on file change","alias":"w"},{"name":"poll","flagName":"poll","required":false,"type":"boolean","description":"Use polling to detect filesystem changes","alias":"p"},{"name":"clear","flagName":"clear","required":false,"type":"boolean","description":"Clear the terminal for new logs after file change","showNegatedVariantInHelp":true,"default":true}],"args":[],"options":{"staysAlive":true},"filePath":"serve.js"},{"commandName":"test","description":"Run tests along with the file watcher to re-run tests on file change","help":"","namespace":null,"aliases":[],"flags":[{"name":"files","flagName":"files","required":false,"type":"array","description":"Filter tests by the filename"},{"name":"tags","flagName":"tags","required":false,"type":"array","description":"Filter tests by tags"},{"name":"groups","flagName":"groups","required":false,"type":"array","description":"Filter tests by parent group title"},{"name":"tests","flagName":"tests","required":false,"type":"array","description":"Filter tests by test title"},{"name":"reporters","flagName":"reporters","required":false,"type":"array","description":"Activate one or more test reporters"},{"name":"watch","flagName":"watch","required":false,"type":"boolean","description":"Watch filesystem and re-run tests on file change"},{"name":"poll","flagName":"poll","required":false,"type":"boolean","description":"Use polling to detect filesystem changes"},{"name":"timeout","flagName":"timeout","required":false,"type":"number","description":"Define default timeout for all tests"},{"name":"retries","flagName":"retries","required":false,"type":"number","description":"Define default retries for all tests"},{"name":"failed","flagName":"failed","required":false,"type":"boolean","description":"Execute tests failed during the last run"},{"name":"clear","flagName":"clear","required":false,"type":"boolean","description":"Clear the terminal for new logs after file change","showNegatedVariantInHelp":true,"default":true}],"args":[{"name":"suites","argumentName":"suites","required":false,"description":"Mention suite names to run tests for selected suites","type":"spread"}],"options":{"allowUnknownFlags":true,"staysAlive":true},"filePath":"test.js"}],"version":1}

package/build/commands/configure.d.ts

@@ -1,21 +1,42 @@
-import type { CommandOptions } from '../types/ace.js';
-import { BaseCommand } from '../modules/ace/main.js';
+import type { CommandOptions } from '../types/ace.ts';
+import { BaseCommand } from '../modules/ace/main.ts';
 /**
- * The configure command is used to configure packages after installation
+ * Command to configure packages after installation by running their configuration hooks.
+ * Supports built-in configurations for VineJS, Edge, and health checks, or can execute
+ * custom configure functions exported by packages.
+ *
+ * @example
+ * ```
+ * ace configure @adonisjs/lucid
+ * ace configure vinejs
+ * ace configure edge
+ * ace configure health_checks
+ * ace configure @adonisjs/auth --force --verbose
+ * ```
  */
 export default class Configure extends BaseCommand {
     #private;
+    /**
+     * The command name
+     */
     static commandName: string;
+    /**
+     * The command description
+     */
     static description: string;
+    /**
+     * Command options configuration.
+     * Allows unknown flags to be passed to package configure functions.
+     */
     static options: CommandOptions;
     /**
-     * Exposing all flags from the protected property "parsed"
+     * Expose all flags from the protected property "parsed" for access by package configure functions
      */
     get parsedFlags(): {
         [argName: string]: any;
     };
     /**
-     * Exposing all args from the protected property "parsed"
+     * Expose all arguments from the protected property "parsed" for access by package configure functions
      */
     get parsedArgs(): (string | number)[];
     /**
@@ -23,24 +44,26 @@ export default class Configure extends BaseCommand {
      */
     name: string;
     /**
-     * Turn on verbose mode for packages installation
+     * Enable verbose logging during package installation and configuration
      */
     verbose?: boolean;
     /**
-     * Forcefully overwrite existing files.
+     * Forcefully overwrite existing files during configuration
      */
     force?: boolean;
     /**
-     * The root of the stubs directory. The value is defined after we import
-     * the package
+     * The root directory path of the package's stubs.
+     * Set automatically when the package exports a stubsRoot property.
      */
     stubsRoot: string;
     /**
-     * Creates codemods as per configure command options
+     * Create a codemods instance configured with command options.
+     * Sets overwrite and verbose flags based on command arguments.
      */
-    createCodemods(): Promise<import("../modules/ace/codemods.js").Codemods>;
+    createCodemods(): Promise<import("../modules/ace/codemods.ts").Codemods>;
     /**
-     * Run method is invoked by ace automatically
+     * Execute the configure command. Handles built-in configurations for VineJS, Edge,
+     * and health checks, or imports and executes the configure function from the specified package.
      */
     run(): Promise<void>;
 }

package/build/commands/configure.js

@@ -12,32 +12,57 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
-import { stubsRoot } from '../stubs/main.js';
-import { args, BaseCommand, flags } from '../modules/ace/main.js';
-import { RuntimeException } from '@poppinss/utils';
+import { RuntimeException } from '@poppinss/utils/exception';
+import { stubsRoot } from "../stubs/main.js";
+import { args, BaseCommand, flags } from "../modules/ace/main.js";
 /**
- * The configure command is used to configure packages after installation
+ * Command to configure packages after installation by running their configuration hooks.
+ * Supports built-in configurations for VineJS, Edge, and health checks, or can execute
+ * custom configure functions exported by packages.
+ *
+ * @example
+ * ```
+ * ace configure @adonisjs/lucid
+ * ace configure vinejs
+ * ace configure edge
+ * ace configure health_checks
+ * ace configure @adonisjs/auth --force --verbose
+ * ```
  */
 export default class Configure extends BaseCommand {
+    /**
+     * The command name
+     */
     static commandName = 'configure';
+    /**
+     * The command description
+     */
     static description = 'Configure a package after it has been installed';
+    /**
+     * Command options configuration.
+     * Allows unknown flags to be passed to package configure functions.
+     */
     static options = {
         allowUnknownFlags: true,
     };
     /**
-     * Exposing all flags from the protected property "parsed"
+     * Expose all flags from the protected property "parsed" for access by package configure functions
      */
     get parsedFlags() {
         return this.parsed.flags;
     }
     /**
-     * Exposing all args from the protected property "parsed"
+     * Expose all arguments from the protected property "parsed" for access by package configure functions
      */
     get parsedArgs() {
         return this.parsed._;
     }
     /**
-     * Returns the package main exports
+     * Import and return the main exports of a package.
+     * Returns null if the package is not found, rethrows other errors.
+     *
+     * @param packageName - The name of the package to import
+     * @returns The package exports or null if not found
      */
     async #getPackageSource(packageName) {
         try {
@@ -53,7 +78,7 @@ export default class Configure extends BaseCommand {
         }
     }
     /**
-     * Registers VineJS provider
+     * Configure VineJS validation library by registering its provider in the RC file
      */
     async #configureVineJS() {
         const codemods = await this.createCodemods();
@@ -62,7 +87,7 @@ export default class Configure extends BaseCommand {
         });
     }
     /**
-     * Registers Edge provider
+     * Configure Edge template engine by registering its provider and adding view meta files
      */
     async #configureEdge() {
         const codemods = await this.createCodemods();
@@ -72,7 +97,7 @@ export default class Configure extends BaseCommand {
         });
     }
     /**
-     * Configure health checks
+     * Configure health checks feature by generating the main health file and controller
      */
     async #configureHealthChecks() {
         const codemods = await this.createCodemods();
@@ -86,7 +111,8 @@ export default class Configure extends BaseCommand {
         });
     }
     /**
-     * Creates codemods as per configure command options
+     * Create a codemods instance configured with command options.
+     * Sets overwrite and verbose flags based on command arguments.
      */
     async createCodemods() {
         const codemods = await super.createCodemods();
@@ -95,7 +121,8 @@ export default class Configure extends BaseCommand {
         return codemods;
     }
     /**
-     * Run method is invoked by ace automatically
+     * Execute the configure command. Handles built-in configurations for VineJS, Edge,
+     * and health checks, or imports and executes the configure function from the specified package.
      */
     async run() {
         if (this.name === 'vinejs') {