@adonisjs/core 7.0.1 → 7.1.0

package/build/ace-DBm6EcQ-.js

@@ -0,0 +1,37 @@
+import { t as Ignitor } from "./main-D1MSq4Uu.js";
+import { t as IgnitorFactory } from "./ignitor-Kym3gR-I.js";
+import { t as createAceKernel } from "./create_kernel-D38-0Zbt.js";
+//#region factories/core/ace.ts
+/**
+* Factory for creating and configuring Ace command kernel instances.
+* This factory provides a convenient way to create Ace kernels either from
+* an existing Ignitor instance or by creating a new one from scratch.
+*
+* @example
+* ```ts
+* // Create from URL
+* const aceFactory = new AceFactory()
+* const kernel = await aceFactory.make(new URL('../', import.meta.url))
+*
+* // Create from existing ignitor
+* const ignitor = new Ignitor(appRoot)
+* const kernel = await aceFactory.make(ignitor)
+*
+* // Run commands
+* await kernel.handle(['make:controller', 'UserController'])
+* ```
+*/
+var AceFactory = class {
+	async make(ignitorOrAppRoot, options) {
+		if (ignitorOrAppRoot instanceof Ignitor) {
+			const app = ignitorOrAppRoot.createApp("console");
+			await app.init();
+			return createAceKernel(app);
+		}
+		const app = new IgnitorFactory().withCoreConfig().withCoreProviders().create(ignitorOrAppRoot, options).createApp("console");
+		await app.init();
+		return createAceKernel(app);
+	}
+};
+//#endregion
+export { AceFactory as t };

package/build/app-BCcG_oDd.js

@@ -0,0 +1,7 @@
+import { n as __reExport, t as __exportAll } from "./chunk-Do49iUES.js";
+//#region modules/app.ts
+var app_exports = /* @__PURE__ */ __exportAll({});
+import * as import__adonisjs_application from "@adonisjs/application";
+__reExport(app_exports, import__adonisjs_application);
+//#endregion
+export { app_exports as t };

package/build/app-CAuSGb2P.js

@@ -0,0 +1,15 @@
+//#region services/app.ts
+let app;
+/**
+* Set the application instance the app service should
+* be using. Other services relies on the same app
+* instance as well.
+*
+* app service is an instance of the "Application" exported from
+* the "modules/app.ts" file.
+*/
+function setApp(appService) {
+	app = appService;
+}
+//#endregion
+export { setApp as n, app as t };

package/build/bodyparser_middleware-H5FArWkI.js

@@ -0,0 +1,9 @@
+import { BodyParserMiddleware } from "@adonisjs/bodyparser/bodyparser_middleware";
+//#region modules/bodyparser/bodyparser_middleware.ts
+/**
+* Default export allows lazy importing middleware with
+* destructuring the named exports
+*/
+var bodyparser_middleware_default = BodyParserMiddleware;
+//#endregion
+export { bodyparser_middleware_default as t };

package/build/{chunk-iKc69rpz.js → chunk-Do49iUES.js}

@@ -1,7 +1,9 @@
 import "node:module";
+Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __exportAll = (all, no_symbols) => {
 	let target = {};
@@ -23,4 +25,5 @@ var __copyProps = (to, from, except, desc) => {
 	return to;
 };
 var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+//#endregion
 export { __reExport as n, __exportAll as t };

package/build/commands/add.d.ts

@@ -24,6 +24,7 @@ export default class Add extends BaseCommand {
      * The command description
      */
     static description: string;
+    static help: string[];
     /**
      * Command options configuration
      */

package/build/commands/add.js

@@ -1,21 +1,62 @@
-import "../chunk-iKc69rpz.js";
-import "../main-kn40V-hF.js";
-import "../debug-CGQmxzGt.js";
-import "../main-Cxz0TyIw.js";
-import "../config_provider-FIAUgvae.js";
-import "../utils-rRkbAPnP.js";
-import { n as prettyPrintError } from "../core-IpCOCkUL.js";
-import { f as BaseCommand, l as flags, o as args } from "../main-MBAMnmJb.js";
-import { t as __decorate } from "../decorate-DmrZA614.js";
+import "../chunk-Do49iUES.js";
+import "../main-CfTiGsiS.js";
+import "../container-CGfEwWof.js";
+import "../debug-DWofTfIX.js";
+import "../main-D1MSq4Uu.js";
+import "../app-CAuSGb2P.js";
+import "../app-BCcG_oDd.js";
+import "../config_provider-Do9af1ze.js";
+import "../string-8_8He-HH.js";
+import "../utils-CKwka7OL.js";
+import { n as prettyPrintError } from "../core-XjMm_ipu.js";
+import { f as BaseCommand, l as flags, o as args } from "../main-CRnMnrH7.js";
+import { t as __decorate } from "../decorate-B9Uz0anB.js";
+//#region commands/add.ts
+/**
+* The install command is used to `npm install` and `node ace configure` one or more packages
+* in one go.
+*
+* @example
+* ```
+* ace add @adonisjs/lucid
+* ace add @adonisjs/lucid @adonisjs/auth @adonisjs/session
+* ace add @adonisjs/session --dev
+* ace add vinejs --force
+* ace add edge --package-manager=pnpm
+* ```
+*/
 var Add = class extends BaseCommand {
+	/**
+	* The command name
+	*/
 	static commandName = "add";
-	static description = "Install and configure one or more packages";
+	/**
+	* The command description
+	*/
+	static description = "Install and configure one or more AdonisJS packages. Runs npm install followed by the package configure hook";
+	static help = [
+		"Use this command instead of manually running npm install + configure separately.",
+		"Accepts shorthand names: \"vinejs\" for @vinejs/vine, \"edge\" for edge.js.",
+		"```",
+		"{{ binaryName }} add @adonisjs/lucid",
+		"{{ binaryName }} add @adonisjs/auth @adonisjs/session",
+		"```"
+	];
+	/**
+	* Command options configuration
+	*/
 	static options = { allowUnknownFlags: true };
+	/**
+	* Resolve the npm package name from the user-provided name
+	*/
 	#resolveNpmPackageName(name) {
 		if (name === "vinejs") return "@vinejs/vine";
 		if (name === "edge") return "edge.js";
 		return name;
 	}
+	/**
+	* Configure the package by delegating the work to the `node ace configure` command
+	*/
 	async #configurePackage(packageName) {
 		const flagValueArray = this.parsed.unknownFlags.filter((flag) => !!this.parsed.flags[flag]).map((flag) => [`--${flag}`, this.parsed.flags[flag].toString()]);
 		const configureArgs = [
@@ -26,17 +67,26 @@ var Add = class extends BaseCommand {
 		].filter(Boolean);
 		return await this.kernel.exec("configure", configureArgs);
 	}
+	/**
+	* Run method is invoked by ace automatically
+	*/
 	async run() {
 		const packages = this.names.map((name) => ({
 			name,
 			npmName: this.#resolveNpmPackageName(name)
 		}));
+		/**
+		* Install all packages
+		*/
 		const codemods = await this.createCodemods();
 		codemods.verboseInstallOutput = !!this.verbose;
 		if (!await codemods.installPackages(packages.map((pkg) => ({
 			name: pkg.npmName,
 			isDevDependency: !!this.dev
 		})), this.packageManager)) return;
+		/**
+		* Configure each package sequentially
+		*/
 		const succeeded = [];
 		const failed = [];
 		for (const pkg of packages) {
@@ -47,6 +97,9 @@ var Add = class extends BaseCommand {
 				error
 			});
 		}
+		/**
+		* Report results
+		*/
 		if (succeeded.length > 0) {
 			const names = succeeded.map((name) => this.colors.green(name)).join(", ");
 			this.logger.success(`Installed and configured ${names}`);
@@ -71,4 +124,5 @@ __decorate([flags.boolean({
 	alias: "D"
 })], Add.prototype, "dev", void 0);
 __decorate([flags.boolean({ description: "Forcefully overwrite existing files" })], Add.prototype, "force", void 0);
+//#endregion
 export { Add as default };

package/build/commands/build.js

@@ -1,9 +1,31 @@
-import { n as importTypeScript, t as importAssembler } from "../utils-rRkbAPnP.js";
-import { f as BaseCommand, l as flags } from "../main-MBAMnmJb.js";
-import { t as __decorate } from "../decorate-DmrZA614.js";
+import "../chunk-Do49iUES.js";
+import { n as importTypeScript, t as importAssembler } from "../utils-CKwka7OL.js";
+import { f as BaseCommand, l as flags } from "../main-CRnMnrH7.js";
+import { t as __decorate } from "../decorate-B9Uz0anB.js";
+//#region commands/build.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
+* ```
+*/
 var Build = class 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.",
 		"```",
@@ -16,6 +38,11 @@ var Build = class extends BaseCommand {
 		"{{ binaryName }} build --assets-args=\"--debug --base=/public\"",
 		"```"
 	];
+	/**
+	* Log a development dependency is missing
+	*
+	* @param dependency - The name of the missing dependency
+	*/
 	#logMissingDevelopmentDependency(dependency) {
 		this.logger.error([
 			`Cannot find package "${dependency}"`,
@@ -25,6 +52,9 @@ var Build = class 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"));
 	}
+	/**
+	* Build application
+	*/
 	async run() {
 		const assembler = await importAssembler(this.app);
 		if (!assembler) {
@@ -42,11 +72,19 @@ var Build = class extends BaseCommand {
 			metaFiles: this.app.rcFile.metaFiles,
 			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.ui.logger = this.logger;
+		/**
+		* Bundle project for production
+		*/
 		const stopOnError = this.ignoreTsErrors === true ? false : true;
 		if (!await bundler.bundle(stopOnError, this.packageManager)) this.exitCode = 1;
 	}
 };
 __decorate([flags.boolean({ description: "Ignore TypeScript errors and continue with the build process" })], Build.prototype, "ignoreTsErrors", void 0);
 __decorate([flags.string({ description: "Define the package manager to copy the appropriate lock file" })], Build.prototype, "packageManager", void 0);
+//#endregion
 export { Build as default };

package/build/commands/commands.json

@@ -1 +1 @@
-{"commands":[{"commandName":"add","description":"Install and configure one or more packages","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":"names","argumentName":"names","required":true,"description":"Package names to install and configure","type":"spread"}],"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":[{"name":"contentsFrom","flagName":"contents-from","required":false,"type":"string","description":"Use the contents of the given file as the generated output"}],"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"},{"name":"contentsFrom","flagName":"contents-from","required":false,"type":"string","description":"Use the contents of the given file as the generated output"}],"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":[{"name":"contentsFrom","flagName":"contents-from","required":false,"type":"string","description":"Use the contents of the given file as the generated output"}],"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":[{"name":"contentsFrom","flagName":"contents-from","required":false,"type":"string","description":"Use the contents of the given file as the generated output"}],"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"},{"name":"contentsFrom","flagName":"contents-from","required":false,"type":"string","description":"Use the contents of the given file as the generated output"}],"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"},{"name":"contentsFrom","flagName":"contents-from","required":false,"type":"string","description":"Use the contents of the given file as the generated output"}],"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"},{"name":"contentsFrom","flagName":"contents-from","required":false,"type":"string","description":"Use the contents of the given file as the generated output"}],"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"},{"name":"contentsFrom","flagName":"contents-from","required":false,"type":"string","description":"Use the contents of the given file as the generated output"}],"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":[{"name":"contentsFrom","flagName":"contents-from","required":false,"type":"string","description":"Use the contents of the given file as the generated output"}],"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"},{"name":"contentsFrom","flagName":"contents-from","required":false,"type":"string","description":"Use the contents of the given file as the generated output"}],"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":[{"name":"contentsFrom","flagName":"contents-from","required":false,"type":"string","description":"Use the contents of the given file as the generated output"}],"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"},{"name":"contentsFrom","flagName":"contents-from","required":false,"type":"string","description":"Use the contents of the given file as the generated output"}],"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":[{"name":"contentsFrom","flagName":"contents-from","required":false,"type":"string","description":"Use the contents of the given file as the generated output"}],"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}
+{"commands":[{"commandName":"add","description":"Install and configure one or more AdonisJS packages. Runs npm install followed by the package configure hook","help":["Use this command instead of manually running npm install + configure separately.","Accepts shorthand names: \"vinejs\" for @vinejs/vine, \"edge\" for edge.js.","```","{{ binaryName }} add @adonisjs/lucid","{{ binaryName }} add @adonisjs/auth @adonisjs/session","```"],"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":"names","argumentName":"names","required":true,"description":"Package names to install and configure","type":"spread"}],"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":"Run the configure hook of an already-installed package. Use \"add\" command instead to both install and configure in one step","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":"Copy scaffolding stubs from a package to your application for customization. Stubs are templates used by make:* commands","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 to .env, .env.example, and its validation rule to start/env.ts","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 APP_KEY and write it to the .env file. Use --show to print without writing","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":"Display the resolved adonisrc.ts configuration as JSON, including providers, preloads, commands, and meta files","help":"","namespace":"inspect","aliases":[],"flags":[],"args":[],"options":{},"filePath":"inspect_rcfile.js"},{"commandName":"list:routes","description":"List all registered routes with their HTTP methods, URL patterns, handlers, and middleware","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"},{"name":"jsonl","flagName":"jsonl","required":false,"type":"boolean","description":"Get routes as JSONL, one JSON object per line (optimized for AI agents)"}],"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 CLI command class in commands/","help":"","namespace":"make","aliases":[],"flags":[{"name":"contentsFrom","flagName":"contents-from","required":false,"type":"string","description":"Use the contents of the given file as the generated output"}],"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 in app/controllers. Use --resource for CRUD methods or --api for API-only CRUD (no create/edit)","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"},{"name":"contentsFrom","flagName":"contents-from","required":false,"type":"string","description":"Use the contents of the given file as the generated output"}],"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 in app/events. Events are dispatched via emitter and handled by listeners","help":"","namespace":"make","aliases":[],"flags":[{"name":"contentsFrom","flagName":"contents-from","required":false,"type":"string","description":"Use the contents of the given file as the generated output"}],"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 in app/exceptions with handle and report methods","help":"","namespace":"make","aliases":[],"flags":[{"name":"contentsFrom","flagName":"contents-from","required":false,"type":"string","description":"Use the contents of the given file as the generated output"}],"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 in app/listeners. Use --event to also generate the event class and bind them together","help":"","namespace":"make","aliases":[],"flags":[{"name":"event","flagName":"event","required":false,"type":"string","description":"Generate an event class alongside the listener","alias":"e"},{"name":"contentsFrom","flagName":"contents-from","required":false,"type":"string","description":"Use the contents of the given file as the generated output"}],"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 in app/middleware and register it in start/kernel.ts under the chosen stack (server, router, or named)","help":"","namespace":"make","aliases":[],"flags":[{"name":"stack","flagName":"stack","required":false,"type":"string","description":"The stack in which to register the middleware","alias":"s"},{"name":"contentsFrom","flagName":"contents-from","required":false,"type":"string","description":"Use the contents of the given file as the generated output"}],"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 in start/ and optionally register it in adonisrc.ts. Preload files run during app boot","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"},{"name":"contentsFrom","flagName":"contents-from","required":false,"type":"string","description":"Use the contents of the given file as the generated output"}],"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 in providers/ and optionally register it in adonisrc.ts. Providers register IoC container bindings","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"},{"name":"contentsFrom","flagName":"contents-from","required":false,"type":"string","description":"Use the contents of the given file as the generated output"}],"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 in app/services. Services encapsulate reusable business logic outside of controllers","help":"","namespace":"make","aliases":[],"flags":[{"name":"contentsFrom","flagName":"contents-from","required":false,"type":"string","description":"Use the contents of the given file as the generated output"}],"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 in tests/. Use --suite to specify the test suite (unit, functional, etc.)","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"},{"name":"contentsFrom","flagName":"contents-from","required":false,"type":"string","description":"Use the contents of the given file as the generated output"}],"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 in app/transformers for serializing data in API responses","help":"","namespace":"make","aliases":[],"flags":[{"name":"contentsFrom","flagName":"contents-from","required":false,"type":"string","description":"Use the contents of the given file as the generated output"}],"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 VineJS validator file in app/validators. Use --resource to generate both create and update validation schemas","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"},{"name":"contentsFrom","flagName":"contents-from","required":false,"type":"string","description":"Use the contents of the given file as the generated output"}],"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 in resources/views","help":"","namespace":"make","aliases":[],"flags":[{"name":"contentsFrom","flagName":"contents-from","required":false,"type":"string","description":"Use the contents of the given file as the generated output"}],"args":[{"name":"name","argumentName":"name","required":true,"description":"Name of the template","type":"string"}],"options":{},"filePath":"make/view.js"},{"commandName":"repl","description":"Start an interactive REPL session with the application booted and IoC container available","help":"","namespace":null,"aliases":[],"flags":[],"args":[],"options":{"startApp":true,"staysAlive":true},"filePath":"repl.js"},{"commandName":"serve","description":"Start the development HTTP server. Use --watch for auto-restart on file change or --hmr for hot module replacement","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 using Japa test runner. Supports filtering by suite, file, tag, and group. Use --watch for re-runs 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.js

@@ -1,17 +1,56 @@
-import { t as stubsRoot } from "../main-kn40V-hF.js";
-import { f as BaseCommand, l as flags, o as args } from "../main-MBAMnmJb.js";
-import { t as __decorate } from "../decorate-DmrZA614.js";
+import "../chunk-Do49iUES.js";
+import { t as stubsRoot } from "../main-CfTiGsiS.js";
+import { f as BaseCommand, l as flags, o as args } from "../main-CRnMnrH7.js";
+import { t as __decorate } from "../decorate-B9Uz0anB.js";
 import { RuntimeException } from "@poppinss/utils/exception";
+//#region commands/configure.ts
+/**
+* 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
+* ```
+*/
 var Configure = class extends BaseCommand {
+	/**
+	* The command name
+	*/
 	static commandName = "configure";
-	static description = "Configure a package after it has been installed";
+	/**
+	* The command description
+	*/
+	static description = "Run the configure hook of an already-installed package. Use \"add\" command instead to both install and configure in one step";
+	/**
+	* Command options configuration.
+	* Allows unknown flags to be passed to package configure functions.
+	*/
 	static options = { allowUnknownFlags: true };
+	/**
+	* Expose all flags from the protected property "parsed" for access by package configure functions
+	*/
 	get parsedFlags() {
 		return this.parsed.flags;
 	}
+	/**
+	* Expose all arguments from the protected property "parsed" for access by package configure functions
+	*/
 	get parsedArgs() {
 		return this.parsed._;
 	}
+	/**
+	* 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 {
 			return await this.app.import(packageName);
@@ -20,17 +59,26 @@ var Configure = class extends BaseCommand {
 			throw error;
 		}
 	}
+	/**
+	* Configure VineJS validation library by registering its provider in the RC file
+	*/
 	async #configureVineJS() {
 		await (await this.createCodemods()).updateRcFile((rcFile) => {
 			rcFile.addProvider("@adonisjs/core/providers/vinejs_provider");
 		});
 	}
+	/**
+	* Configure Edge template engine by registering its provider and adding view meta files
+	*/
 	async #configureEdge() {
 		await (await this.createCodemods()).updateRcFile((rcFile) => {
 			rcFile.addProvider("@adonisjs/core/providers/edge_provider");
 			rcFile.addMetaFile("resources/views/**/*.edge", false);
 		});
 	}
+	/**
+	* Configure health checks feature by generating the main health file and controller
+	*/
 	async #configureHealthChecks() {
 		const codemods = await this.createCodemods();
 		await codemods.makeUsingStub(stubsRoot, "make/health/main.stub", {
@@ -42,12 +90,20 @@ var Configure = class extends BaseCommand {
 			entity: this.app.generators.createEntity("health_checks")
 		});
 	}
+	/**
+	* Create a codemods instance configured with command options.
+	* Sets overwrite and verbose flags based on command arguments.
+	*/
 	async createCodemods() {
 		const codemods = await super.createCodemods();
 		codemods.overwriteExisting = this.force === true;
 		codemods.verboseInstallOutput = this.verbose === true;
 		return codemods;
 	}
+	/**
+	* 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") return this.#configureVineJS();
 		if (this.name === "edge") return this.#configureEdge();
@@ -58,11 +114,20 @@ var Configure = class extends BaseCommand {
 			this.exitCode = 1;
 			return;
 		}
+		/**
+		* Warn, there are not instructions to run
+		*/
 		if (!packageExports.configure) {
 			this.logger.warning(`Cannot configure module "${this.name}". The module does not export the configure hook`);
 			return;
 		}
+		/**
+		* Set stubsRoot property when package exports it
+		*/
 		if (packageExports.stubsRoot) this.stubsRoot = packageExports.stubsRoot;
+		/**
+		* Run instructions
+		*/
 		try {
 			await packageExports.configure(this);
 		} catch (error) {
@@ -79,4 +144,5 @@ __decorate([flags.boolean({
 	description: "Forcefully overwrite existing files",
 	alias: "f"
 })], Configure.prototype, "force", void 0);
+//#endregion
 export { Configure as default };

package/build/commands/eject.js

@@ -1,9 +1,34 @@
-import stringHelpers from "../src/helpers/string.js";
-import { f as BaseCommand, l as flags, o as args } from "../main-MBAMnmJb.js";
-import { t as __decorate } from "../decorate-DmrZA614.js";
+import "../chunk-Do49iUES.js";
+import { t as stringHelpers } from "../string-8_8He-HH.js";
+import { f as BaseCommand, l as flags, o as args } from "../main-CRnMnrH7.js";
+import { t as __decorate } from "../decorate-B9Uz0anB.js";
+//#region commands/eject.ts
+/**
+* Command to eject scaffolding stubs from packages to your application root.
+* This allows you to customize templates used by make commands and other
+* code generation features by copying them to your local application.
+*
+* @example
+* ```
+* ace eject make/controller
+* ace eject make/controller --pkg=@adonisjs/lucid
+* ace eject stubs/
+* ```
+*/
 var Eject = class extends BaseCommand {
+	/**
+	* The command name
+	*/
 	static commandName = "eject";
-	static description = "Eject scaffolding stubs to your application root";
+	/**
+	* The command description
+	*/
+	static description = "Copy scaffolding stubs from a package to your application for customization. Stubs are templates used by make:* commands";
+	/**
+	* Execute the command to eject stubs from the specified package.
+	* Copies the stubs to the application root and logs success messages
+	* for each ejected file.
+	*/
 	async run() {
 		(await (await this.app.stubs.create()).copy(this.stubPath, { pkg: this.pkg })).forEach((stubPath) => {
 			this.logger.success(`eject ${stringHelpers.toUnixSlash(this.app.relativePath(stubPath))}`);
@@ -15,4 +40,5 @@ __decorate([flags.string({
 	description: "Mention package name for searching stubs",
 	default: "@adonisjs/core"
 })], Eject.prototype, "pkg", void 0);
+//#endregion
 export { Eject as default };