@adonisjs/core 7.5.1 → 7.6.0

package/build/commands/add.js

@@ -1,6 +1,6 @@
 import { n as prettyPrintError } from "../main-B2rXbPKm.js";
 import { o as args, p as BaseCommand, u as flags } from "../main-DvUje0hm.js";
-import { t as __decorate } from "../decorate-COk3IovQ.js";
+import { t as __decorate } from "../decorate-JJf0EFHX.js";
 //#region commands/add.ts
 /**
 * The install command is used to `npm install` and `node ace configure` one or more packages

package/build/commands/build.js

@@ -1,6 +1,6 @@
 import { n as importAssembler, r as importTypeScript } from "../utils-CeWrQT0f.js";
 import { p as BaseCommand, u as flags } from "../main-DvUje0hm.js";
-import { t as __decorate } from "../decorate-COk3IovQ.js";
+import { t as __decorate } from "../decorate-JJf0EFHX.js";
 //#region commands/build.ts
 /**
 * Create the production build by compiling TypeScript source and the

package/build/commands/commands.json

@@ -0,0 +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"},{"name":"tsconfig","flagName":"tsconfig","required":false,"type":"string","description":"Define the tsconfig path"}],"args":[],"options":{},"filePath":"build.js"},{"commandName":"codegen","description":"Generate TypeScript type definitions and index files for the application","help":["Regenerate the codegen files without starting the HTTP server.","```","{{ binaryName }} codegen","```","","Use it inside a CI pipeline to keep the generated types up-to-date before","typechecking or building the application, without committing them to git.","```","npm ci && {{ binaryName }} codegen && npm run typecheck","```"],"namespace":null,"aliases":[],"flags":[],"args":[],"options":{},"filePath":"codegen.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"},{"name":"force","flagName":"force","required":false,"type":"boolean","description":"Forcefully overwrite existing files","alias":"f"}],"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"},{"name":"force","flagName":"force","required":false,"type":"boolean","description":"Forcefully overwrite existing files","alias":"f"}],"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"},{"name":"force","flagName":"force","required":false,"type":"boolean","description":"Forcefully overwrite existing files","alias":"f"}],"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"},{"name":"force","flagName":"force","required":false,"type":"boolean","description":"Forcefully overwrite existing files","alias":"f"}],"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"},{"name":"force","flagName":"force","required":false,"type":"boolean","description":"Forcefully overwrite existing files","alias":"f"}],"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"},{"name":"force","flagName":"force","required":false,"type":"boolean","description":"Forcefully overwrite existing files","alias":"f"}],"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"},{"name":"force","flagName":"force","required":false,"type":"boolean","description":"Forcefully overwrite existing files","alias":"f"}],"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"},{"name":"force","flagName":"force","required":false,"type":"boolean","description":"Forcefully overwrite existing files","alias":"f"}],"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"},{"name":"force","flagName":"force","required":false,"type":"boolean","description":"Forcefully overwrite existing files","alias":"f"}],"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"},{"name":"force","flagName":"force","required":false,"type":"boolean","description":"Forcefully overwrite existing files","alias":"f"}],"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"},{"name":"force","flagName":"force","required":false,"type":"boolean","description":"Forcefully overwrite existing files","alias":"f"}],"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"},{"name":"force","flagName":"force","required":false,"type":"boolean","description":"Forcefully overwrite existing files","alias":"f"}],"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"},{"name":"force","flagName":"force","required":false,"type":"boolean","description":"Forcefully overwrite existing files","alias":"f"}],"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,6 +1,6 @@
 import { t as stubsRoot } from "../main-DbL06a4f.js";
 import { o as args, p as BaseCommand, u as flags } from "../main-DvUje0hm.js";
-import { t as __decorate } from "../decorate-COk3IovQ.js";
+import { t as __decorate } from "../decorate-JJf0EFHX.js";
 import { RuntimeException } from "@poppinss/utils/exception";
 //#region commands/configure.ts
 /**

package/build/commands/eject.js

@@ -1,6 +1,6 @@
 import { t as stringHelpers } from "../string-DUpLZV_t.js";
 import { o as args, p as BaseCommand, u as flags } from "../main-DvUje0hm.js";
-import { t as __decorate } from "../decorate-COk3IovQ.js";
+import { t as __decorate } from "../decorate-JJf0EFHX.js";
 //#region commands/eject.ts
 /**
 * Command to eject scaffolding stubs from packages to your application root.

package/build/commands/env/add.js

@@ -1,6 +1,6 @@
 import { t as stringHelpers } from "../../string-DUpLZV_t.js";
 import { o as args, p as BaseCommand, u as flags } from "../../main-DvUje0hm.js";
-import { t as __decorate } from "../../decorate-COk3IovQ.js";
+import { t as __decorate } from "../../decorate-JJf0EFHX.js";
 //#region commands/env/add.ts
 const ALLOWED_TYPES = [
 	"string",

package/build/commands/generate_key.js

@@ -1,5 +1,5 @@
 import { p as BaseCommand, u as flags } from "../main-DvUje0hm.js";
-import { t as __decorate } from "../decorate-COk3IovQ.js";
+import { t as __decorate } from "../decorate-JJf0EFHX.js";
 import string from "@poppinss/utils/string";
 import { EnvEditor } from "@adonisjs/env/editor";
 //#region commands/generate_key.ts

package/build/commands/list/routes.js

@@ -1,5 +1,5 @@
 import { o as args, p as BaseCommand, s as cliHelpers, u as flags } from "../../main-DvUje0hm.js";
-import { t as __decorate } from "../../decorate-COk3IovQ.js";
+import { t as __decorate } from "../../decorate-JJf0EFHX.js";
 import stringWidth from "string-width";
 import { middlewareInfo, routeInfo } from "@adonisjs/http-server/helpers";
 //#region src/cli_formatters/routes_list.ts

package/build/commands/main.d.ts

@@ -0,0 +1,4 @@
+import { CommandMetaData, Command } from '@adonisjs/ace/types';
+
+export function getMetaData(): Promise<CommandMetaData[]>
+export function getCommand(metaData: CommandMetaData): Promise<Command | null>

package/build/commands/main.js

@@ -0,0 +1,36 @@
+import { readFile } from 'node:fs/promises'
+
+/**
+ * In-memory cache of commands after they have been loaded
+ */
+let commandsMetaData
+
+/**
+ * Reads the commands from the "./commands.json" file. Since, the commands.json
+ * file is generated automatically, we do not have to validate its contents
+ */
+export async function getMetaData() {
+  if (commandsMetaData) {
+    return commandsMetaData
+  }
+
+  const commandsIndex = await readFile(new URL('./commands.json', import.meta.url), 'utf-8')
+  commandsMetaData = JSON.parse(commandsIndex).commands
+
+  return commandsMetaData
+}
+
+/**
+ * Imports the command by lookingup its path from the commands
+ * metadata
+ */
+export async function getCommand(metaData) {
+  const commands = await getMetaData()
+  const command = commands.find(({ commandName }) => metaData.commandName === commandName)
+  if (!command) {
+    return null
+  }
+
+  const { default: commandConstructor } = await import(new URL(command.filePath, import.meta.url).href)
+  return commandConstructor
+}

package/build/commands/make/command.js

@@ -1,6 +1,6 @@
 import { t as stubsRoot } from "../../main-DbL06a4f.js";
 import { o as args, p as BaseCommand, u as flags } from "../../main-DvUje0hm.js";
-import { t as __decorate } from "../../decorate-COk3IovQ.js";
+import { t as __decorate } from "../../decorate-JJf0EFHX.js";
 //#region commands/make/command.ts
 /**
 * Command to create a new Ace command class.

package/build/commands/make/controller.js

@@ -1,6 +1,6 @@
 import { t as stubsRoot } from "../../main-DbL06a4f.js";
 import { o as args, p as BaseCommand, u as flags } from "../../main-DvUje0hm.js";
-import { t as __decorate } from "../../decorate-COk3IovQ.js";
+import { t as __decorate } from "../../decorate-JJf0EFHX.js";
 import string from "@poppinss/utils/string";
 //#region commands/make/controller.ts
 /**

package/build/commands/make/event.js

@@ -1,6 +1,6 @@
 import { t as stubsRoot } from "../../main-DbL06a4f.js";
 import { o as args, p as BaseCommand, u as flags } from "../../main-DvUje0hm.js";
-import { t as __decorate } from "../../decorate-COk3IovQ.js";
+import { t as __decorate } from "../../decorate-JJf0EFHX.js";
 //#region commands/make/event.ts
 /**
 * Command to create a new event class.

package/build/commands/make/exception.js

@@ -1,6 +1,6 @@
 import { t as stubsRoot } from "../../main-DbL06a4f.js";
 import { o as args, p as BaseCommand, u as flags } from "../../main-DvUje0hm.js";
-import { t as __decorate } from "../../decorate-COk3IovQ.js";
+import { t as __decorate } from "../../decorate-JJf0EFHX.js";
 //#region commands/make/exception.ts
 /**
 * Command to create a new custom exception class.

package/build/commands/make/listener.js

@@ -1,6 +1,6 @@
 import { t as stubsRoot } from "../../main-DbL06a4f.js";
 import { o as args, p as BaseCommand, u as flags } from "../../main-DvUje0hm.js";
-import { t as __decorate } from "../../decorate-COk3IovQ.js";
+import { t as __decorate } from "../../decorate-JJf0EFHX.js";
 //#region commands/make/listener.ts
 /**
 * Command to create a new event listener class.

package/build/commands/make/middleware.js

@@ -1,7 +1,7 @@
 import { t as stubsRoot } from "../../main-DbL06a4f.js";
 import { t as stringHelpers } from "../../string-DUpLZV_t.js";
 import { o as args, p as BaseCommand, u as flags } from "../../main-DvUje0hm.js";
-import { t as __decorate } from "../../decorate-COk3IovQ.js";
+import { t as __decorate } from "../../decorate-JJf0EFHX.js";
 import string from "@poppinss/utils/string";
 import { basename, extname, relative } from "node:path";
 //#region commands/make/middleware.ts

package/build/commands/make/preload.js

@@ -1,7 +1,7 @@
 import { t as stubsRoot } from "../../main-DbL06a4f.js";
 import { t as stringHelpers } from "../../string-DUpLZV_t.js";
 import { o as args, p as BaseCommand, u as flags } from "../../main-DvUje0hm.js";
-import { t as __decorate } from "../../decorate-COk3IovQ.js";
+import { t as __decorate } from "../../decorate-JJf0EFHX.js";
 import { extname, relative } from "node:path";
 //#region commands/make/preload.ts
 const ALLOWED_ENVIRONMENTS = [

package/build/commands/make/provider.js

@@ -1,7 +1,7 @@
 import { t as stubsRoot } from "../../main-DbL06a4f.js";
 import { t as stringHelpers } from "../../string-DUpLZV_t.js";
 import { o as args, p as BaseCommand, u as flags } from "../../main-DvUje0hm.js";
-import { t as __decorate } from "../../decorate-COk3IovQ.js";
+import { t as __decorate } from "../../decorate-JJf0EFHX.js";
 import { extname, relative } from "node:path";
 //#region commands/make/provider.ts
 const ALLOWED_ENVIRONMENTS = [

package/build/commands/make/service.js

@@ -1,6 +1,6 @@
 import { t as stubsRoot } from "../../main-DbL06a4f.js";
 import { o as args, p as BaseCommand, u as flags } from "../../main-DvUje0hm.js";
-import { t as __decorate } from "../../decorate-COk3IovQ.js";
+import { t as __decorate } from "../../decorate-JJf0EFHX.js";
 //#region commands/make/service.ts
 /**
 * Make a new service class

package/build/commands/make/test.js

@@ -1,6 +1,6 @@
 import { t as stubsRoot } from "../../main-DbL06a4f.js";
 import { o as args, p as BaseCommand, u as flags } from "../../main-DvUje0hm.js";
-import { t as __decorate } from "../../decorate-COk3IovQ.js";
+import { t as __decorate } from "../../decorate-JJf0EFHX.js";
 //#region commands/make/test.ts
 /**
 * Command to create a new Japa test file.

package/build/commands/make/transformer.js

@@ -1,6 +1,6 @@
 import { t as stubsRoot } from "../../main-DbL06a4f.js";
 import { o as args, p as BaseCommand, u as flags } from "../../main-DvUje0hm.js";
-import { t as __decorate } from "../../decorate-COk3IovQ.js";
+import { t as __decorate } from "../../decorate-JJf0EFHX.js";
 //#region commands/make/transformer.ts
 /**
 * Command to create a new transformer class.

package/build/commands/make/validator.js

@@ -1,6 +1,6 @@
 import { t as stubsRoot } from "../../main-DbL06a4f.js";
 import { o as args, p as BaseCommand, u as flags } from "../../main-DvUje0hm.js";
-import { t as __decorate } from "../../decorate-COk3IovQ.js";
+import { t as __decorate } from "../../decorate-JJf0EFHX.js";
 //#region commands/make/validator.ts
 /**
 * Command to create a new VineJS validator file.

package/build/commands/make/view.js

@@ -1,6 +1,6 @@
 import { t as stubsRoot } from "../../main-DbL06a4f.js";
 import { o as args, p as BaseCommand, u as flags } from "../../main-DvUje0hm.js";
-import { t as __decorate } from "../../decorate-COk3IovQ.js";
+import { t as __decorate } from "../../decorate-JJf0EFHX.js";
 //#region commands/make/view.ts
 /**
 * Command to create a new Edge.js template file.

package/build/commands/serve.js

@@ -1,6 +1,6 @@
 import { n as importAssembler } from "../utils-CeWrQT0f.js";
 import { p as BaseCommand, u as flags } from "../main-DvUje0hm.js";
-import { t as __decorate } from "../decorate-COk3IovQ.js";
+import { t as __decorate } from "../decorate-JJf0EFHX.js";
 //#region commands/serve.ts
 /**
 * Serve command is used to run the AdonisJS HTTP server during development. The

package/build/commands/test.js

@@ -1,6 +1,6 @@
 import { n as importAssembler } from "../utils-CeWrQT0f.js";
 import { o as args, p as BaseCommand, u as flags } from "../main-DvUje0hm.js";
-import { t as __decorate } from "../decorate-COk3IovQ.js";
+import { t as __decorate } from "../decorate-JJf0EFHX.js";
 //#region commands/test.ts
 /**
 * Command to run application tests using the Japa test runner.

package/build/{decorate-COk3IovQ.js → decorate-JJf0EFHX.js}

@@ -1,4 +1,4 @@
-//#region \0@oxc-project+runtime@0.146.0/helpers/esm/decorate.js
+//#region \0@oxc-project+runtime@0.151.0/helpers/esm/decorate.js
 function __decorate(decorators, target, key, desc) {
 	var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
 	if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);

package/build/modules/ace/codemods.d.ts

@@ -9,8 +9,9 @@ import { type GeneratedStub } from '../../types/app.ts';
  * This class provides APIs to modify configuration files, register middleware,
  * generate stubs, and install packages.
  *
- * The codemod APIs rely on the "@adonisjs/assembler" package, which must be
- * installed as a dependency in the user application.
+ * Some codemods, including installPackages, rely on the optional
+ * "@adonisjs/assembler" package. defineEnvVariables, makeUsingStub,
+ * addImportAlias, and createDirectory work without it.
  *
  * @example
  * ```ts
@@ -67,6 +68,26 @@ export declare class Codemods extends EventEmitter {
     defineEnvVariables<T extends Record<string, number | string | boolean>>(environmentVariables: T, options?: {
         omitFromExample?: Array<keyof T>;
     }): Promise<void>;
+    /**
+     * Add a subpath import to the application's package.json. Existing aliases
+     * are left unchanged, even when their target differs.
+     *
+     * @example
+     * ```ts
+     * await codemods.addImportAlias('#channels/*', './app/channels/*.js')
+     * ```
+     */
+    addImportAlias(alias: string, target: string): Promise<void>;
+    /**
+     * Create a directory relative to the application root, including missing parents.
+     * Leave an existing directory unchanged.
+     *
+     * @example
+     * ```ts
+     * await codemods.createDirectory('app/channels')
+     * ```
+     */
+    createDirectory(directory: string): Promise<void>;
     /**
      * Returns the TsMorph project instance for advanced AST manipulations.
      * See https://ts-morph.com/ for documentation.

package/build/modules/ace/codemods.js

@@ -1,7 +1,7 @@
 import { t as debug_default } from "../../debug-DrrWgeSu.js";
 import { t as stringHelpers } from "../../string-DUpLZV_t.js";
 import { isAbsolute } from "node:path";
-import { readFile } from "node:fs/promises";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
 import { EnvEditor } from "@adonisjs/env/editor";
 import { EventEmitter } from "node:events";
 //#region modules/ace/codemods.ts
@@ -10,8 +10,9 @@ import { EventEmitter } from "node:events";
 * This class provides APIs to modify configuration files, register middleware,
 * generate stubs, and install packages.
 *
-* The codemod APIs rely on the "@adonisjs/assembler" package, which must be
-* installed as a dependency in the user application.
+* Some codemods, including installPackages, rely on the optional
+* "@adonisjs/assembler" package. defineEnvVariables, makeUsingStub,
+* addImportAlias, and createDirectory work without it.
 *
 * @example
 * ```ts
@@ -124,6 +125,57 @@ var Codemods = class extends EventEmitter {
 		this.#cliLogger.action("update .env file").succeeded();
 	}
 	/**
+	* Add a subpath import to the application's package.json. Existing aliases
+	* are left unchanged, even when their target differs.
+	*
+	* @example
+	* ```ts
+	* await codemods.addImportAlias('#channels/*', './app/channels/*.js')
+	* ```
+	*/
+	async addImportAlias(alias, target) {
+		const action = this.#cliLogger.action("update package.json file");
+		try {
+			const path = this.#app.makePath("package.json");
+			const contents = await readFile(path, "utf-8");
+			const bom = contents.startsWith("") ? "" : "";
+			const packageJson = JSON.parse(contents.slice(bom.length));
+			packageJson.imports ??= {};
+			if (Object.hasOwn(packageJson.imports, alias)) {
+				action.skipped(`import alias "${alias}" already exists`);
+				return;
+			}
+			packageJson.imports[alias] = target;
+			const indent = contents.match(/^([ \t]+)"[^"\n]+"\s*:/m)?.[1] ?? (contents.includes("\n") ? "  " : "");
+			const newline = contents.includes("\r\n") ? "\r\n" : "\n";
+			const updated = JSON.stringify(packageJson, null, indent).replaceAll("\n", newline);
+			await writeFile(path, bom + updated + (contents.endsWith("\n") ? newline : ""));
+			action.succeeded();
+		} catch (error) {
+			this.emit("error", error);
+			action.failed(error.message);
+		}
+	}
+	/**
+	* Create a directory relative to the application root, including missing parents.
+	* Leave an existing directory unchanged.
+	*
+	* @example
+	* ```ts
+	* await codemods.createDirectory('app/channels')
+	* ```
+	*/
+	async createDirectory(directory) {
+		const action = this.#cliLogger.action(`create ${directory} directory`);
+		try {
+			if (await mkdir(this.#app.makePath(directory), { recursive: true })) action.succeeded();
+			else action.skipped("directory already exists");
+		} catch (error) {
+			this.emit("error", error);
+			action.failed(error.message);
+		}
+	}
+	/**
 	* Returns the TsMorph project instance for advanced AST manipulations.
 	* See https://ts-morph.com/ for documentation.
 	*

package/build/toolkit/main.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { t as __decorate } from "../decorate-COk3IovQ.js";
+import { t as __decorate } from "../decorate-JJf0EFHX.js";
 import { BaseCommand, HelpCommand, IndexGenerator, Kernel, ListLoader, args } from "@adonisjs/ace";
 import { join } from "node:path";
 //#region toolkit/commands/index_commands.ts
@@ -32,5 +32,6 @@ kernel.on("help", async (command, $kernel, parsed) => {
 	return $kernel.shortcircuit();
 });
 await kernel.handle(process.argv.splice(2));
+process.exitCode = kernel.exitCode;
 //#endregion
 export {};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@adonisjs/core",
   "description": "Core of AdonisJS",
-  "version": "7.5.1",
+  "version": "7.6.0",
   "engines": {
     "node": ">=24.0.0"
   },
@@ -84,7 +84,7 @@
     "index:commands": "node --import=@poppinss/ts-exec toolkit/main.js index build/commands"
   },
   "devDependencies": {
-    "@adonisjs/assembler": "^8.5.0",
+    "@adonisjs/assembler": "^8.5.2",
     "@adonisjs/encryption": "^6.0.2",
     "@adonisjs/eslint-config": "^3.1.0",
     "@adonisjs/prettier-config": "^1.5.0",
@@ -95,8 +95,8 @@
     "@japa/runner": "^5.3.0",
     "@japa/snapshot": "^2.0.10",
     "@poppinss/ts-exec": "^1.4.4",
-    "@release-it/conventional-changelog": "^12.0.0",
-    "@types/node": "~26.2.0",
+    "@release-it/conventional-changelog": "^12.0.2",
+    "@types/node": "~26.6.2",
     "@types/pretty-hrtime": "^1.0.3",
     "@types/sinon": "^22.0.0",
     "@types/supertest": "^7.2.1",
@@ -109,32 +109,32 @@
     "cross-env": "^10.1.0",
     "del-cli": "^7.0.0",
     "edge.js": "^6.5.1",
-    "eslint": "^10.8.1",
+    "eslint": "^10.11.0",
     "execa": "^10.0.1",
     "get-port": "^7.2.0",
     "pino-pretty": "^13.1.3",
-    "prettier": "^3.9.6",
-    "release-it": "^21.0.2",
+    "prettier": "^3.9.9",
+    "release-it": "^21.1.0",
     "sinon": "^22.1.0",
-    "supertest": "^7.2.2",
+    "supertest": "^7.3.0",
     "test-console": "^2.0.0",
     "timekeeper": "^2.3.1",
-    "tsdown": "^0.22.14",
+    "tsdown": "^0.23.0",
     "typedoc": "^0.28.20",
     "typescript": "^6.0.3",
     "youch": "^4.1.1"
   },
   "dependencies": {
-    "@adonisjs/ace": "^14.1.0",
+    "@adonisjs/ace": "^14.1.1",
     "@adonisjs/application": "^9.1.0",
     "@adonisjs/bodyparser": "^11.0.4",
     "@adonisjs/config": "^6.1.0",
-    "@adonisjs/env": "^7.0.0",
+    "@adonisjs/env": "^7.1.0",
     "@adonisjs/events": "^10.2.0",
-    "@adonisjs/fold": "^11.0.0",
+    "@adonisjs/fold": "^11.1.0",
     "@adonisjs/hash": "^10.1.1",
     "@adonisjs/health": "^3.1.0",
-    "@adonisjs/http-server": "^9.2.0",
+    "@adonisjs/http-server": "^9.3.1",
     "@adonisjs/http-transformers": "^2.3.1",
     "@adonisjs/logger": "^7.1.1",
     "@adonisjs/repl": "^5.0.0",
@@ -142,7 +142,7 @@
     "@poppinss/colors": "^4.1.6",
     "@poppinss/dumper": "^0.7.0",
     "@poppinss/macroable": "^1.1.2",
-    "@poppinss/utils": "^7.0.1",
+    "@poppinss/utils": "^7.1.1",
     "@sindresorhus/is": "^8.1.0",
     "@types/he": "^1.2.3",
     "error-stack-parser-es": "^2.0.1",