@adonisjs/core 7.0.1 → 7.1.1

package/build/commands/make/transformer.js

@@ -1,11 +1,43 @@
-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";
+//#region commands/make/transformer.ts
+/**
+* Command to create a new transformer class.
+* Transformers are used to serialize data objects (like models) into specific
+* formats for API responses, allowing you to control which fields are exposed
+* and how data is structured for clients.
+*
+* @example
+* ```
+* ace make:transformer User
+* ace make:transformer Post
+* ace make:transformer ProductTransformer
+* ```
+*/
 var MakeTransformer = class extends BaseCommand {
+	/**
+	* The command name
+	*/
 	static commandName = "make:transformer";
-	static description = "Create a new transformer class";
+	/**
+	* The command description
+	*/
+	static description = "Create a new transformer class in app/transformers for serializing data in API responses";
+	/**
+	* Command options configuration.
+	* Allows unknown flags to be passed through.
+	*/
 	static options = { allowUnknownFlags: true };
+	/**
+	* The stub template file to use for generating the transformer class
+	*/
 	stubPath = "make/transformer/main.stub";
+	/**
+	* Execute the command to create a new transformer class.
+	* Generates the transformer file with proper data serialization structure.
+	*/
 	async run() {
 		await (await this.createCodemods()).makeUsingStub(stubsRoot, this.stubPath, {
 			flags: this.parsed.flags,
@@ -16,4 +48,5 @@ var MakeTransformer = class extends BaseCommand {
 };
 __decorate([args.string({ description: "Entity name for which to generate the transformer" })], MakeTransformer.prototype, "name", void 0);
 __decorate([flags.string({ description: "Use the contents of the given file as the generated output" })], MakeTransformer.prototype, "contentsFrom", void 0);
+//#endregion
 export { MakeTransformer as default };

package/build/commands/make/validator.js

@@ -1,14 +1,53 @@
-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";
+//#region commands/make/validator.ts
+/**
+* Command to create a new VineJS validator file.
+* Validators define reusable validation schemas for request validation,
+* and can be generated as simple validators or resource-based validators
+* with create and update schemas.
+*
+* @example
+* ```
+* ace make:validator UserValidator
+* ace make:validator PostValidator --resource
+* ace make:validator ContactValidator
+* ```
+*/
 var MakeValidator = class extends BaseCommand {
+	/**
+	* The command name
+	*/
 	static commandName = "make:validator";
-	static description = "Create a new file to define VineJS validators";
+	/**
+	* The command description
+	*/
+	static description = "Create a new VineJS validator file in app/validators. Use --resource to generate both create and update validation schemas";
+	/**
+	* Command options configuration.
+	* Allows unknown flags to be passed through.
+	*/
 	static options = { allowUnknownFlags: true };
+	/**
+	* The stub template file to use for generating the validator
+	*/
 	stubPath = "make/validator/main.stub";
+	/**
+	* Prepare the command by selecting the appropriate stub based on options.
+	* Uses a resource stub when generating validators for CRUD operations.
+	*/
 	async prepare() {
+		/**
+		* Use resource stub
+		*/
 		if (this.resource) this.stubPath = "make/validator/resource.stub";
 	}
+	/**
+	* Execute the command to create a new VineJS validator file.
+	* Generates the validator with the appropriate stub template.
+	*/
 	async run() {
 		await (await this.createCodemods()).makeUsingStub(stubsRoot, this.stubPath, {
 			flags: this.parsed.flags,
@@ -19,4 +58,5 @@ var MakeValidator = class extends BaseCommand {
 __decorate([args.string({ description: "Name of the validator file" })], MakeValidator.prototype, "name", void 0);
 __decorate([flags.boolean({ description: "Create a file with pre-defined validators for create and update actions" })], MakeValidator.prototype, "resource", void 0);
 __decorate([flags.string({ description: "Use the contents of the given file as the generated output" })], MakeValidator.prototype, "contentsFrom", void 0);
+//#endregion
 export { MakeValidator as default };

package/build/commands/make/view.js

@@ -1,10 +1,38 @@
-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";
+//#region commands/make/view.ts
+/**
+* Command to create a new Edge.js template file.
+* Edge templates are used for rendering HTML views in your web application,
+* supporting layouts, partials, components, and template inheritance.
+*
+* @example
+* ```
+* ace make:view home
+* ace make:view users/profile
+* ace make:view components/navbar
+* ace make:view layouts/app
+* ```
+*/
 var MakeView = class extends BaseCommand {
+	/**
+	* The command name
+	*/
 	static commandName = "make:view";
-	static description = "Create a new Edge.js template file";
+	/**
+	* The command description
+	*/
+	static description = "Create a new Edge.js template file in resources/views";
+	/**
+	* The stub template file to use for generating the Edge template
+	*/
 	stubPath = "make/view/main.stub";
+	/**
+	* Execute the command to create a new Edge.js template file.
+	* Generates the template file in the views directory.
+	*/
 	async run() {
 		await (await this.createCodemods()).makeUsingStub(stubsRoot, this.stubPath, {
 			flags: this.parsed.flags,
@@ -14,4 +42,5 @@ var MakeView = class extends BaseCommand {
 };
 __decorate([args.string({ description: "Name of the template" })], MakeView.prototype, "name", void 0);
 __decorate([flags.string({ description: "Use the contents of the given file as the generated output" })], MakeView.prototype, "contentsFrom", void 0);
+//#endregion
 export { MakeView as default };

package/build/commands/repl.js

@@ -1,11 +1,39 @@
-import { f as BaseCommand } from "../main-MBAMnmJb.js";
+import "../chunk-Do49iUES.js";
+import { f as BaseCommand } from "../main-CRnMnrH7.js";
+//#region commands/repl.ts
+/**
+* Command to start an interactive REPL (Read-Eval-Print Loop) session for AdonisJS.
+* The REPL provides a command-line interface where you can execute JavaScript code
+* in the context of your AdonisJS application, allowing you to interact with models,
+* services, and other application components in real-time.
+*
+* @example
+* ```
+* ace repl
+* ```
+*/
 var ReplCommand = class extends BaseCommand {
+	/**
+	* The command name
+	*/
 	static commandName = "repl";
-	static description = "Start a new REPL session";
+	/**
+	* The command description
+	*/
+	static description = "Start an interactive REPL session with the application booted and IoC container available";
+	/**
+	* Command options configuration.
+	* Requires the application to be started and keeps the process alive.
+	*/
 	static options = {
 		startApp: true,
 		staysAlive: true
 	};
+	/**
+	* Execute the command to start the REPL server.
+	* Creates a REPL instance from the container and sets up an exit handler
+	* that properly terminates the application when the REPL session ends.
+	*/
 	async run() {
 		const repl = await this.app.container.make("repl");
 		repl.start();
@@ -14,4 +42,5 @@ var ReplCommand = class extends BaseCommand {
 		});
 	}
 };
+//#endregion
 export { ReplCommand as default };

package/build/commands/serve.js

@@ -1,9 +1,34 @@
-import { 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 { 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/serve.ts
+/**
+* Serve command is used to run the AdonisJS HTTP server during development. The
+* command under the hood runs the "bin/server.ts" file and watches for file
+* system changes
+*
+* @example
+* ```
+* ace serve
+* ace serve --watch
+* ace serve --hmr
+* ace serve --poll
+* ace serve --no-clear
+* ```
+*/
 var Serve = class extends BaseCommand {
+	/**
+	* The command name
+	*/
 	static commandName = "serve";
-	static description = "Start the development HTTP server along with the file watcher to perform restarts on file change";
+	/**
+	* The command description
+	*/
+	static description = "Start the development HTTP server. Use --watch for auto-restart on file change or --hmr for hot module replacement";
+	/**
+	* Help text for the command
+	*/
 	static help = [
 		"Start the development server with file watcher using the following command.",
 		"```",
@@ -21,7 +46,15 @@ var Serve = class extends BaseCommand {
 		"{{ binaryName }} serve --assets-args=\"--debug --base=/public\"",
 		"```"
 	];
+	/**
+	* Command options configuration
+	*/
 	static options = { staysAlive: true };
+	/**
+	* Log a development dependency is missing
+	*
+	* @param dependency - The name of the missing dependency
+	*/
 	#logMissingDevelopmentDependency(dependency) {
 		this.logger.error([
 			`Cannot find package "${dependency}"`,
@@ -31,6 +64,9 @@ var Serve = class extends BaseCommand {
 			"If you are running your application in production, then use \"node bin/server.js\" command to start the HTTP server"
 		].join("\n"));
 	}
+	/**
+	* Runs the HTTP server
+	*/
 	async run() {
 		const assembler = await importAssembler(this.app);
 		if (!assembler) {
@@ -51,15 +87,28 @@ var Serve = 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.
+		*/
 		this.devServer.ui.logger = this.logger;
+		/**
+		* Exit command when the dev server is closed
+		*/
 		this.devServer.onClose((exitCode) => {
 			this.exitCode = exitCode;
 			this.terminate();
 		});
+		/**
+		* Exit command when the dev server crashes
+		*/
 		this.devServer.onError(() => {
 			this.exitCode = 1;
 			this.terminate();
 		});
+		/**
+		* Start the development server
+		*/
 		if (this.watch) await this.devServer.startAndWatch({ poll: this.poll || false });
 		else await this.devServer.start();
 	}
@@ -78,4 +127,5 @@ __decorate([flags.boolean({
 	showNegatedVariantInHelp: true,
 	default: true
 })], Serve.prototype, "clear", void 0);
+//#endregion
 export { Serve as default };

package/build/commands/test.js

@@ -1,13 +1,47 @@
-import { t as importAssembler } from "../utils-rRkbAPnP.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 importAssembler } from "../utils-CKwka7OL.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/test.ts
+/**
+* Command to run application tests using the Japa test runner.
+* Supports filtering tests by suites, files, tags, groups, and individual tests.
+* Can run in watch mode to automatically re-run tests when files change.
+*
+* @example
+* ```
+* ace test
+* ace test unit integration
+* ace test --watch
+* ace test --files=user.spec.ts
+* ace test --tags=slow --groups="User tests"
+* ace test --reporters=spec,dot
+* ace test --timeout=5000 --retries=2
+* ```
+*/
 var Test = class extends BaseCommand {
+	/**
+	* The command name
+	*/
 	static commandName = "test";
-	static description = "Run tests along with the file watcher to re-run tests on file change";
+	/**
+	* The command description
+	*/
+	static description = "Run tests using Japa test runner. Supports filtering by suite, file, tag, and group. Use --watch for re-runs on file change";
+	/**
+	* Command options configuration.
+	* Allows unknown flags to be passed to Japa and keeps the process alive.
+	*/
 	static options = {
 		allowUnknownFlags: true,
 		staysAlive: true
 	};
+	/**
+	* Log an error message when a required development dependency is missing.
+	* Provides helpful instructions for resolving the issue.
+	*
+	* @param dependency - The name of the missing dependency package
+	*/
 	#logMissingDevelopmentDependency(dependency) {
 		this.logger.error([
 			`Cannot find package "${dependency}"`,
@@ -17,14 +51,31 @@ var Test = class extends BaseCommand {
 			"If you are run tests inside a CI, make sure the NODE_ENV is set to \"development\""
 		].join("\n"));
 	}
+	/**
+	* Collect unknown flags and format them to pass to the Japa test runner.
+	* Handles boolean flags, arrays, and single values appropriately.
+	*
+	* @returns Array of formatted command-line arguments for Japa
+	*/
 	#getPassthroughFlags() {
 		return this.parsed.unknownFlags.map((flag) => {
 			const value = this.parsed.flags[flag];
+			/**
+			* Not mentioning value when value is "true"
+			*/
 			if (value === true) return [`--${flag}`];
+			/**
+			* Repeating flag multiple times when value is an array
+			*/
 			if (Array.isArray(value)) return value.map((v) => [`--${flag}`, v]);
 			return [`--${flag}`, value];
 		}).flat(2);
 	}
+	/**
+	* Execute the test command. Sets up the test runner with all configured options
+	* and filters, then runs tests either once or in watch mode. Handles missing
+	* dependencies and properly configures the test environment.
+	*/
 	async run() {
 		process.env.NODE_ENV = "test";
 		const assembler = await importAssembler(this.app);
@@ -58,15 +109,28 @@ var Test = class extends BaseCommand {
 			hooks: this.app.rcFile.hooks,
 			metaFiles: this.app.rcFile.metaFiles
 		});
+		/**
+		* Share command logger with assembler, so that CLI flags like --no-ansi has
+		* similar impact for assembler logs as well.
+		*/
 		this.testsRunner.ui.logger = this.logger;
+		/**
+		* Exit command when the test runner is closed
+		*/
 		this.testsRunner.onClose((exitCode) => {
 			this.exitCode = exitCode;
 			this.terminate();
 		});
+		/**
+		* Exit command when the dev server crashes
+		*/
 		this.testsRunner.onError(() => {
 			this.exitCode = 1;
 			this.terminate();
 		});
+		/**
+		* Start the test runner in watch mode
+		*/
 		if (this.watch) await this.testsRunner.runAndWatch({ poll: this.poll || false });
 		else await this.testsRunner.run();
 	}
@@ -90,4 +154,5 @@ __decorate([flags.boolean({
 	showNegatedVariantInHelp: true,
 	default: true
 })], Test.prototype, "clear", void 0);
+//#endregion
 export { Test as default };

package/build/config-Coti2q6R.js

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

package/build/config_provider-Do9af1ze.js

@@ -0,0 +1,35 @@
+//#region src/config_provider.ts
+/**
+* Helper utilities to create and resolve config providers. Config providers
+* are used to defer configuration resolution until the application is booted,
+* allowing access to environment variables and other application services.
+*
+* @example
+* // Creating a database config provider
+* const databaseConfig = configProvider.create(async (app) => ({
+*   connection: app.env.get('DB_CONNECTION', 'sqlite'),
+*   host: app.env.get('DB_HOST', 'localhost'),
+*   port: app.env.get('DB_PORT', 5432)
+* }))
+*
+* @example
+* // Resolving a config provider
+* const config = await configProvider.resolve(app, databaseConfig)
+* if (config) {
+*   console.log(`Database connection: ${config.connection}`)
+* }
+*/
+const configProvider = {
+	create(resolver) {
+		return {
+			type: "provider",
+			resolver
+		};
+	},
+	async resolve(app, provider) {
+		if (provider && typeof provider === "object" && "type" in provider) return provider.resolver(app);
+		return null;
+	}
+};
+//#endregion
+export { configProvider as t };

package/build/container-CGfEwWof.js

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

package/build/{core-IpCOCkUL.js → core-aRg0soJX.js}

@@ -1,10 +1,49 @@
-import stringHelpers from "./src/helpers/string.js";
-import { r as outputTransformerDataObjects } from "./utils-rRkbAPnP.js";
+import { t as stringHelpers } from "./string-8_8He-HH.js";
+import { r as outputTransformerDataObjects } from "./utils-CKwka7OL.js";
 import { errors } from "@adonisjs/ace";
 import { errors as errors$1 } from "@adonisjs/env";
 import { errors as errors$2 } from "@adonisjs/application";
 import { errors as errors$3 } from "@boringnode/encryption";
 import { errors as errors$4 } from "@adonisjs/http-server";
+//#region src/assembler_hooks/index_entities.ts
+/**
+* Configures the IndexGenerator to create barrel files for "controllers", "events",
+* and "listeners". This function is used as an assembler hook to automatically generate
+* index files that export all modules from specified directories.
+*
+* @param {IndexEntitiesConfig} entities - Configuration object for entities indexing
+*
+* @example
+* // Basic usage with default configuration
+* indexEntities({})
+*
+* @example
+* // Custom configuration for specific entities
+* indexEntities({
+*   events: {
+*     enabled: true,
+*     source: 'app/custom-events',
+*     importAlias: '#custom-events'
+*   },
+*   transformers: {
+*     enabled: true,
+*     withSharedProps: true,
+*     inertiaMiddlewareImportPath: '#middleware/inertia_middleware'
+*   },
+*   controllers: {
+*     enabled: false
+*   }
+* })
+*
+* @example
+* // Using custom glob patterns
+* indexEntities({
+*   listeners: {
+*     source: 'app/handlers',
+*     glob: '**\/*_handler.ts'
+*   }
+* })
+*/
 function indexEntities(entities = {}) {
 	const events = Object.assign({
 		enabled: true,
@@ -37,7 +76,7 @@ function indexEntities(entities = {}) {
 		output: ".adonisjs/client/data.d.ts"
 	}, entities.transformers);
 	const manifest = {
-		enabled: entities.manifest?.enabled === false ? false : transformers.enabled,
+		enabled: entities.manifest?.enabled ?? transformers.enabled,
 		source: "config",
 		output: ".adonisjs/client/manifest.d.ts",
 		exclude: entities.manifest?.exclude ?? [
@@ -123,6 +162,11 @@ function indexEntities(entities = {}) {
 		});
 	} };
 }
+//#endregion
+//#region index.ts
+/**
+* Aggregated errors from all modules.
+*/
 const errors$5 = {
 	...errors$3,
 	...errors$4,
@@ -130,6 +174,10 @@ const errors$5 = {
 	...errors,
 	...errors$1
 };
+/**
+* Pretty prints an error with colorful output using
+* Youch terminal
+*/
 async function prettyPrintError(error) {
 	if (error && typeof error === "object" && error.code === "E_DUMP_DIE_EXCEPTION") {
 		console.error(error);
@@ -143,4 +191,5 @@ async function prettyPrintError(error) {
 		console.error(error);
 	}
 }
+//#endregion
 export { prettyPrintError as n, indexEntities as r, errors$5 as t };

package/build/create_kernel-BV3swyCg.js

@@ -0,0 +1,4 @@
+import "./chunk-Do49iUES.js";
+import "./main-CRnMnrH7.js";
+import { t as createAceKernel } from "./create_kernel-D38-0Zbt.js";
+export { createAceKernel };

package/build/{create_kernel-B7ILNhuP.js → create_kernel-D38-0Zbt.js}

@@ -1,10 +1,40 @@
-import { d as Kernel, n as HelpCommand, t as FsLoader } from "./main-MBAMnmJb.js";
+import { d as Kernel, n as HelpCommand, t as FsLoader } from "./main-CRnMnrH7.js";
+//#region modules/ace/create_kernel.ts
+/**
+* Create and configure an Ace command kernel for AdonisJS applications.
+* This function abstracts the kernel setup logic and can be used in different
+* environments with appropriate configurations.
+*
+* - In console environment, Ace manages the lifecycle of the process
+* - In other environments, Ace can be pulled from the container to run commands
+*
+* @param app - The AdonisJS application service instance
+* @param commandName - Optional specific command name for optimized loading
+*
+* @example
+* ```ts
+* const app = new Application(new URL('../', import.meta.url))
+* const kernel = createAceKernel(app)
+*
+* // Run a specific command
+* await kernel.handle(['make:controller', 'UserController'])
+* ```
+*/
 function createAceKernel(app, commandName) {
 	const kernel = new Kernel(app);
 	kernel.info.set("binary", "node ace");
+	/**
+	* Lazy import commands mentioned in the "commands" array
+	* of rcFile
+	*/
 	app.rcFile.commands.forEach((commandModule) => {
 		kernel.addLoader(() => typeof commandModule === "function" ? commandModule() : app.import(commandModule));
 	});
+	/**
+	* When we know the command we are running ahead of time, then we
+	* defer loading the application commands if the command has
+	* already been registered by other loaders.
+	*/
 	const fsLoader = new FsLoader(app.commandsPath());
 	kernel.addLoader({
 		async getMetaData() {
@@ -15,6 +45,9 @@ function createAceKernel(app, commandName) {
 			return fsLoader.getCommand(command);
 		}
 	});
+	/**
+	* Custom global flags
+	*/
 	kernel.defineFlag("ansi", {
 		type: "boolean",
 		showNegatedVariantInHelp: true,
@@ -24,10 +57,16 @@ function createAceKernel(app, commandName) {
 		type: "boolean",
 		description: HelpCommand.description
 	});
+	/**
+	* Flag listener to turn colors on/off
+	*/
 	kernel.on("ansi", (_, $kernel, parsed) => {
 		if (parsed.flags.ansi === false) $kernel.ui.switchMode("silent");
 		if (parsed.flags.ansi === true) $kernel.ui.switchMode("normal");
 	});
+	/**
+	* Flag listener to display the help
+	*/
 	kernel.on("help", async (command, $kernel, parsed) => {
 		parsed.args.unshift(command.commandName);
 		await new HelpCommand($kernel, parsed, kernel.ui, kernel.prompt).exec();
@@ -35,4 +74,5 @@ function createAceKernel(app, commandName) {
 	});
 	return kernel;
 }
+//#endregion
 export { createAceKernel as t };

package/build/debug-DWofTfIX.js

@@ -0,0 +1,20 @@
+import { debuglog } from "node:util";
+//#region src/debug.ts
+/**
+* Debug utility for AdonisJS core. This uses Node.js built-in debuglog
+* utility to provide debugging information when the NODE_DEBUG environment
+* variable includes 'adonisjs:core'.
+*
+* @example
+* // Enable debugging by setting environment variable
+* // NODE_DEBUG=adonisjs:core node app.js
+*
+* @example
+* // Usage in code
+* import debug from '@adonisjs/core/debug'
+* debug('Application started')
+* debug('Processing request: %s', req.url)
+*/
+var debug_default = debuglog("adonisjs:core");
+//#endregion
+export { debug_default as t };