@adonisjs/core 6.19.0 → 7.0.0-next.0

package/build/commands/make/preload.d.ts

@@ -1,4 +1,4 @@
-import { BaseCommand } from '../../modules/ace/main.js';
+import { BaseCommand } from '../../modules/ace/main.ts';
 declare const ALLOWED_ENVIRONMENTS: ("web" | "console" | "test" | "repl")[];
 type AllowedAppEnvironments = typeof ALLOWED_ENVIRONMENTS;
 /**

package/build/commands/make/preload.js

@@ -12,10 +12,10 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
-import { slash } from '@poppinss/utils';
 import { extname, relative } from 'node:path';
-import { stubsRoot } from '../../stubs/main.js';
-import { args, flags, BaseCommand } from '../../modules/ace/main.js';
+import { stubsRoot } from "../../stubs/main.js";
+import stringHelpers from "../../src/helpers/string.js";
+import { args, flags, BaseCommand } from "../../modules/ace/main.js";
 const ALLOWED_ENVIRONMENTS = ['web', 'console', 'test', 'repl'];
 /**
  * Make a new preload file
@@ -70,7 +70,7 @@ export default class MakePreload extends BaseCommand {
          * Creative relative path for the preload file from
          * the "./start" directory
          */
-        const preloadFileRelativePath = slash(relative(this.app.startPath(), destination).replace(extname(destination), ''));
+        const preloadFileRelativePath = stringHelpers.toUnixSlash(relative(this.app.startPath(), destination).replace(extname(destination), ''));
         await codemods.updateRcFile((rcFile) => {
             rcFile.addPreloadFile(`#start/${preloadFileRelativePath}`, this.environments);
         });

package/build/commands/make/provider.d.ts

@@ -1,4 +1,4 @@
-import { BaseCommand } from '../../modules/ace/main.js';
+import { BaseCommand } from '../../modules/ace/main.ts';
 declare const ALLOWED_ENVIRONMENTS: ("web" | "console" | "test" | "repl")[];
 type AllowedAppEnvironments = typeof ALLOWED_ENVIRONMENTS;
 /**

package/build/commands/make/provider.js

@@ -12,10 +12,10 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
-import { slash } from '@poppinss/utils';
 import { extname, relative } from 'node:path';
-import { stubsRoot } from '../../stubs/main.js';
-import { args, BaseCommand, flags } from '../../modules/ace/main.js';
+import { stubsRoot } from "../../stubs/main.js";
+import stringHelpers from "../../src/helpers/string.js";
+import { args, BaseCommand, flags } from "../../modules/ace/main.js";
 const ALLOWED_ENVIRONMENTS = ['web', 'console', 'test', 'repl'];
 /**
  * Make a new provider class
@@ -67,7 +67,7 @@ export default class MakeProvider extends BaseCommand {
          * Creative relative path for the provider file from
          * the "./start" directory
          */
-        const providerRelativePath = slash(relative(this.app.providersPath(), destination).replace(extname(destination), ''));
+        const providerRelativePath = stringHelpers.toUnixSlash(relative(this.app.providersPath(), destination).replace(extname(destination), ''));
         await codemods.updateRcFile((rcFile) => {
             rcFile.addProvider(`#providers/${providerRelativePath}`, this.environments);
         });

package/build/commands/make/service.d.ts

@@ -1,5 +1,5 @@
-import { BaseCommand } from '../../modules/ace/main.js';
-import { CommandOptions } from '../../types/ace.js';
+import { BaseCommand } from '../../modules/ace/main.ts';
+import { type CommandOptions } from '../../types/ace.ts';
 /**
  * Make a new service class
  */

package/build/commands/make/service.js

@@ -12,8 +12,8 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
-import { stubsRoot } from '../../stubs/main.js';
-import { args, BaseCommand } from '../../modules/ace/main.js';
+import { stubsRoot } from "../../stubs/main.js";
+import { args, BaseCommand } from "../../modules/ace/main.js";
 /**
  * Make a new service class
  */

package/build/commands/make/test.d.ts

@@ -1,4 +1,4 @@
-import { BaseCommand } from '../../modules/ace/main.js';
+import { BaseCommand } from '../../modules/ace/main.ts';
 /**
  * Make a new test file
  */

package/build/commands/make/test.js

@@ -12,8 +12,8 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
-import { stubsRoot } from '../../stubs/main.js';
-import { args, flags, BaseCommand } from '../../modules/ace/main.js';
+import { stubsRoot } from "../../stubs/main.js";
+import { args, flags, BaseCommand } from "../../modules/ace/main.js";
 /**
  * Make a new test file
  */

package/build/commands/make/validator.d.ts

@@ -1,5 +1,5 @@
-import { BaseCommand } from '../../modules/ace/main.js';
-import { CommandOptions } from '../../types/ace.js';
+import { BaseCommand } from '../../modules/ace/main.ts';
+import { type CommandOptions } from '../../types/ace.ts';
 /**
  * Make a new VineJS validator
  */

package/build/commands/make/validator.js

@@ -12,8 +12,8 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
-import { stubsRoot } from '../../stubs/main.js';
-import { args, flags, BaseCommand } from '../../modules/ace/main.js';
+import { stubsRoot } from "../../stubs/main.js";
+import { args, flags, BaseCommand } from "../../modules/ace/main.js";
 /**
  * Make a new VineJS validator
  */

package/build/commands/make/view.d.ts

@@ -1,4 +1,4 @@
-import { BaseCommand } from '../../modules/ace/main.js';
+import { BaseCommand } from '../../modules/ace/main.ts';
 /**
  * Make a new EdgeJS template file
  */

package/build/commands/make/view.js

@@ -12,8 +12,8 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
-import { stubsRoot } from '../../stubs/main.js';
-import { args, BaseCommand } from '../../modules/ace/main.js';
+import { stubsRoot } from "../../stubs/main.js";
+import { args, BaseCommand } from "../../modules/ace/main.js";
 /**
  * Make a new EdgeJS template file
  */

package/build/commands/repl.d.ts

@@ -1,5 +1,5 @@
-import { BaseCommand } from '../modules/ace/main.js';
-import { CommandOptions } from '../types/ace.js';
+import { BaseCommand } from '../modules/ace/main.ts';
+import { type CommandOptions } from '../types/ace.ts';
 /**
  * The ReplCommand class is used to start the Repl server
  */

package/build/commands/repl.js

@@ -6,7 +6,7 @@
  * For the full copyright and license information, please view the LICENSE
  * file that was distributed with this source code.
  */
-import { BaseCommand } from '../modules/ace/main.js';
+import { BaseCommand } from "../modules/ace/main.js";
 /**
  * The ReplCommand class is used to start the Repl server
  */

package/build/commands/serve.d.ts

@@ -1,6 +1,6 @@
 import type { DevServer } from '@adonisjs/assembler';
-import type { CommandOptions } from '../types/ace.js';
-import { BaseCommand } from '../modules/ace/main.js';
+import type { CommandOptions } from '../types/ace.ts';
+import { BaseCommand } from '../modules/ace/main.ts';
 /**
  * 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
@@ -17,8 +17,6 @@ export default class Serve extends BaseCommand {
     watch?: boolean;
     poll?: boolean;
     clear?: boolean;
-    assets?: boolean;
-    assetsArgs?: string[];
     /**
      * Runs the HTTP server
      */

package/build/commands/serve.js

@@ -12,8 +12,8 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
-import { BaseCommand, flags } from '../modules/ace/main.js';
-import { detectAssetsBundler, importAssembler, importTypeScript } from '../src/internal_helpers.js';
+import { BaseCommand, flags } from "../modules/ace/main.js";
+import { importAssembler, importTypeScript } from "../src/utils.js";
 /**
  * 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
@@ -54,22 +54,6 @@ export default class Serve extends BaseCommand {
             'If you are running your application in production, then use "node bin/server.js" command to start the HTTP server',
         ].join('\n'));
     }
-    /**
-     * Returns the assets bundler config
-     */
-    async #getAssetsBundlerConfig() {
-        const assetsBundler = await detectAssetsBundler(this.app);
-        return assetsBundler
-            ? {
-                enabled: this.assets === false ? false : true,
-                driver: assetsBundler.name,
-                cmd: assetsBundler.devServer.command,
-                args: (assetsBundler.devServer.args || []).concat(this.assetsArgs || []),
-            }
-            : {
-                enabled: false,
-            };
-    }
     /**
      * Runs the HTTP server
      */
@@ -90,18 +74,14 @@ export default class Serve extends BaseCommand {
             clearScreen: this.clear === false ? false : true,
             nodeArgs: this.parsed.nodeArgs,
             scriptArgs: [],
-            assets: await this.#getAssetsBundlerConfig(),
             metaFiles: this.app.rcFile.metaFiles,
-            hooks: {
-                onDevServerStarted: this.app.rcFile.hooks?.onDevServerStarted,
-                onSourceFileChanged: this.app.rcFile.hooks?.onSourceFileChanged,
-            },
+            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.setLogger(this.logger);
+        this.devServer.ui.logger = this.logger;
         /**
          * Exit command when the dev server is closed
          */
@@ -116,20 +96,20 @@ export default class Serve extends BaseCommand {
             this.exitCode = 1;
             this.terminate();
         });
+        const ts = await importTypeScript(this.app);
+        if (!ts) {
+            this.#logMissingDevelopmentDependency('typescript');
+            this.exitCode = 1;
+            return;
+        }
         /**
          * Start the development server
          */
         if (this.watch) {
-            const ts = await importTypeScript(this.app);
-            if (!ts) {
-                this.#logMissingDevelopmentDependency('typescript');
-                this.exitCode = 1;
-                return;
-            }
             await this.devServer.startAndWatch(ts, { poll: this.poll || false });
         }
         else {
-            await this.devServer.start();
+            await this.devServer.start(ts);
         }
     }
 }
@@ -152,15 +132,3 @@ __decorate([
         default: true,
     })
 ], Serve.prototype, "clear", void 0);
-__decorate([
-    flags.boolean({
-        description: 'Start assets bundler dev server',
-        showNegatedVariantInHelp: true,
-        default: true,
-    })
-], Serve.prototype, "assets", void 0);
-__decorate([
-    flags.array({
-        description: 'Define CLI arguments to pass to the assets bundler',
-    })
-], Serve.prototype, "assetsArgs", void 0);

package/build/commands/test.d.ts

@@ -1,6 +1,6 @@
 import type { TestRunner } from '@adonisjs/assembler';
-import type { CommandOptions } from '../types/ace.js';
-import { BaseCommand } from '../modules/ace/main.js';
+import type { CommandOptions } from '../types/ace.ts';
+import { BaseCommand } from '../modules/ace/main.ts';
 /**
  * Test command is used to run tests with optional file watcher. Under the
  * hood, we run "bin/test.js" file.
@@ -23,8 +23,6 @@ export default class Test extends BaseCommand {
     retries?: number;
     failed?: boolean;
     clear?: boolean;
-    assets?: boolean;
-    assetsArgs?: string[];
     /**
      * Runs tests
      */

package/build/commands/test.js

@@ -12,8 +12,8 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
-import { BaseCommand, flags, args } from '../modules/ace/main.js';
-import { detectAssetsBundler, importAssembler, importTypeScript } from '../src/internal_helpers.js';
+import { BaseCommand, flags, args } from "../modules/ace/main.js";
+import { importAssembler, importTypeScript } from "../src/utils.js";
 /**
  * Test command is used to run tests with optional file watcher. Under the
  * hood, we run "bin/test.js" file.
@@ -60,22 +60,6 @@ export default class Test extends BaseCommand {
         })
             .flat(2);
     }
-    /**
-     * Returns the assets bundler config
-     */
-    async #getAssetsBundlerConfig() {
-        const assetsBundler = await detectAssetsBundler(this.app);
-        return assetsBundler
-            ? {
-                enabled: this.assets === false ? false : true,
-                driver: assetsBundler.name,
-                cmd: assetsBundler.devServer.command,
-                args: (assetsBundler.devServer.args || []).concat(this.assetsArgs || []),
-            }
-            : {
-                enabled: false,
-            };
-    }
     /**
      * Runs tests
      */
@@ -91,7 +75,6 @@ export default class Test extends BaseCommand {
             clearScreen: this.clear === false ? false : true,
             nodeArgs: this.parsed.nodeArgs,
             scriptArgs: this.#getPassthroughFlags(),
-            assets: await this.#getAssetsBundlerConfig(),
             filters: {
                 suites: this.suites,
                 files: this.files,
@@ -112,13 +95,14 @@ export default class Test extends BaseCommand {
             env: {
                 NODE_ENV: 'test',
             },
+            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.setLogger(this.logger);
+        this.testsRunner.ui.logger = this.logger;
         /**
          * Exit command when the test runner is closed
          */
@@ -193,15 +177,3 @@ __decorate([
         default: true,
     })
 ], Test.prototype, "clear", void 0);
-__decorate([
-    flags.boolean({
-        description: 'Start assets bundler dev server.',
-        showNegatedVariantInHelp: true,
-        default: true,
-    })
-], Test.prototype, "assets", void 0);
-__decorate([
-    flags.array({
-        description: 'Define CLI arguments to pass to the assets bundler',
-    })
-], Test.prototype, "assetsArgs", void 0);

package/build/factories/core/ace.d.ts

@@ -1,10 +1,37 @@
-import { Ignitor } from '../../src/ignitor/main.js';
-import type { IgnitorOptions } from '../../src/types.js';
-import type { Kernel } from '../../modules/ace/kernel.js';
+import { Ignitor } from '../../src/ignitor/main.ts';
+import type { IgnitorOptions } from '../../src/types.ts';
+import type { Kernel } from '../../modules/ace/kernel.ts';
 /**
- * Creates an instance of Ace kernel
+ * 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'])
+ * ```
  */
 export declare class AceFactory {
+    /**
+     * Create an Ace kernel from an existing Ignitor instance
+     *
+     * @param ignitor - Existing Ignitor instance
+     */
     make(ignitor: Ignitor): Promise<Kernel>;
+    /**
+     * Create an Ace kernel from application root URL
+     *
+     * @param appRoot - Application root directory URL
+     * @param options - Optional Ignitor configuration options
+     */
     make(appRoot: URL, options?: IgnitorOptions): Promise<Kernel>;
 }

package/build/factories/core/ace.js

@@ -6,11 +6,27 @@
  * For the full copyright and license information, please view the LICENSE
  * file that was distributed with this source code.
  */
-import { IgnitorFactory } from './ignitor.js';
-import { Ignitor } from '../../src/ignitor/main.js';
-import { createAceKernel } from '../../modules/ace/create_kernel.js';
+import { IgnitorFactory } from "./ignitor.js";
+import { Ignitor } from "../../src/ignitor/main.js";
+import { createAceKernel } from "../../modules/ace/create_kernel.js";
 /**
- * Creates an instance of Ace kernel
+ * 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'])
+ * ```
  */
 export class AceFactory {
     async make(ignitorOrAppRoot, options) {

package/build/factories/core/ignitor.d.ts

@@ -1,33 +1,104 @@
-import { Ignitor } from '../../src/ignitor/main.js';
-import type { ApplicationService, IgnitorOptions } from '../../src/types.js';
+import { Ignitor } from '../../src/ignitor/main.ts';
+import type { ApplicationService, IgnitorOptions } from '../../src/types.ts';
 type FactoryParameters = {
     rcFileContents: Record<string, any>;
     config: Record<string, any>;
 };
 /**
- * Ignitor factory creates an instance of the AdonisJS ignitor
+ * Factory for creating and configuring AdonisJS Ignitor instances.
+ * This factory provides a fluent API to set up applications with core providers,
+ * configurations, and preload actions for testing and development scenarios.
+ *
+ * @example
+ * ```ts
+ * const ignitor = new IgnitorFactory()
+ *   .withCoreProviders()
+ *   .withCoreConfig()
+ *   .preload((app) => {
+ *     // Custom initialization logic
+ *   })
+ *   .create(new URL('../', import.meta.url))
+ *
+ * const app = ignitor.createApp('web')
+ * await app.boot()
+ * ```
  */
 export declare class IgnitorFactory {
     #private;
     /**
-     * Define preload actions to run.
+     * Define preload actions to run during application initialization.
+     * These actions are executed after the application is booted.
+     *
+     * @param action - Function to execute during preload phase
+     *
+     * @example
+     * ```ts
+     * factory.preload((app) => {
+     *   // Register custom bindings
+     *   app.container.bind('customService', () => new CustomService())
+     * })
+     * ```
      */
     preload(action: (app: ApplicationService) => void | Promise<void>): this;
     /**
-     * Merge custom factory parameters
+     * Merge custom factory parameters with existing ones.
+     * This allows you to customize RC file contents and application configuration.
+     *
+     * @param params - Parameters to merge
+     * @param params.config - Application configuration to merge
+     * @param params.rcFileContents - RC file contents to merge
+     *
+     * @example
+     * ```ts
+     * factory.merge({
+     *   config: {
+     *     database: { connection: 'mysql' }
+     *   },
+     *   rcFileContents: {
+     *     commands: ['./commands/CustomCommand']
+     *   }
+     * })
+     * ```
      */
     merge(params: Partial<FactoryParameters>): this;
     /**
-     * Load core provider when booting the app
+     * Include core AdonisJS providers when booting the application.
+     * This adds essential providers like app, hash, and REPL providers.
+     *
+     * @example
+     * ```ts
+     * const ignitor = new IgnitorFactory()
+     *   .withCoreProviders()
+     *   .create(appRoot)
+     * ```
      */
     withCoreProviders(): this;
     /**
-     * Merge default config for the core features. A shallow merge
-     * is performed.
+     * Merge default configuration for core AdonisJS features.
+     * This includes configurations for HTTP, hash, logger, and bodyparser.
+     * A shallow merge is performed with existing config.
+     *
+     * @example
+     * ```ts
+     * const ignitor = new IgnitorFactory()
+     *   .withCoreConfig()
+     *   .create(appRoot)
+     * ```
      */
     withCoreConfig(): this;
     /**
-     * Create ignitor instance
+     * Create a configured Ignitor instance with all specified parameters.
+     *
+     * @param appRoot - Application root directory URL
+     * @param options - Optional Ignitor configuration options
+     *
+     * @example
+     * ```ts
+     * const ignitor = new IgnitorFactory()
+     *   .withCoreConfig()
+     *   .withCoreProviders()
+     *   .create(new URL('../', import.meta.url))
+     * ```
      */
     create(appRoot: URL, options?: IgnitorOptions): Ignitor;
 }