@adonisjs/core 7.0.0-next.1 → 7.0.0-next.11

package/build/factories/core/test_utils.js

@@ -1,43 +1,19 @@
-/*
- * @adonisjs/core
- *
- * (c) AdonisJS
- *
- * For the full copyright and license information, please view the LICENSE
- * file that was distributed with this source code.
- */
-import { Ignitor } from "../../index.js";
-import { IgnitorFactory } from "./ignitor.js";
-import { TestUtils } from "../../src/test_utils/main.js";
-/**
- * Factory for creating TestUtils instances used in AdonisJS testing scenarios.
- * This factory provides convenient methods to set up test utilities either from
- * an existing Ignitor instance or by creating a new configured one.
- *
- * @example
- * ```ts
- * // Create from URL for testing
- * const factory = new TestUtilsFactory()
- * const testUtils = factory.create(new URL('../', import.meta.url))
- *
- * // Use in tests
- * const app = testUtils.app()
- * await app.boot()
- *
- * // Create HTTP client
- * const client = testUtils.httpClient()
- * const response = await client.get('/users')
- * ```
- */
-export class TestUtilsFactory {
-    create(ignitorOrAppRoot, options) {
-        if (ignitorOrAppRoot instanceof Ignitor) {
-            return new TestUtils(ignitorOrAppRoot.createApp('test'));
-        }
-        return new TestUtils(new IgnitorFactory()
-            .withCoreConfig()
-            .withCoreProviders()
-            .create(ignitorOrAppRoot, options)
-            .createApp('console'));
-    }
-}
+import "../../chunk-MjwdjG2f.js";
+import "../../main-kn40V-hF.js";
+import "../../container-ClFvcykQ.js";
+import "../../debug-DURPi9xn.js";
+import "../../main-B_vbYVm1.js";
+import "../../app-B6oge7b3.js";
+import "../../app-BK0PN3li.js";
+import "../../config_provider-CY-xuo2R.js";
+import "../../string-CJ7ewUFq.js";
+import "../../utils-CNQ4tlGM.js";
+import "../../core-CNNCwlhc.js";
+import "../../logger-Dha-0hp1.js";
+import "../../main-CFmDHDls.js";
+import "../../main-BrJQ1VAM.js";
+import "../../main-q9TMzWUj.js";
+import "../../ignitor-BWGmb0oD.js";
+import "../../main-2-nm3TiB.js";
+import { t as TestUtilsFactory } from "../../test_utils-CWLOHq7S.js";
+export { TestUtilsFactory };

package/build/factories/encryption.js

@@ -1,9 +1,2 @@
-/*
- * @adonisjs/core
- *
- * (c) AdonisJS
- *
- * For the full copyright and license information, please view the LICENSE
- * file that was distributed with this source code.
- */
-export * from '@adonisjs/encryption/factories';
+export * from "@adonisjs/encryption/factories";
+export {};

package/build/factories/events.js

@@ -1,9 +1,2 @@
-/*
- * @adonisjs/core
- *
- * (c) AdonisJS
- *
- * For the full copyright and license information, please view the LICENSE
- * file that was distributed with this source code.
- */
-export * from '@adonisjs/events/factories';
+export * from "@adonisjs/events/factories";
+export {};

package/build/factories/hash.js

@@ -1,9 +1,2 @@
-/*
- * @adonisjs/core
- *
- * (c) AdonisJS
- *
- * For the full copyright and license information, please view the LICENSE
- * file that was distributed with this source code.
- */
-export * from '@adonisjs/hash/factories';
+export * from "@adonisjs/hash/factories";
+export {};

package/build/factories/http.js

@@ -1,9 +1,2 @@
-/*
- * @adonisjs/core
- *
- * (c) AdonisJS
- *
- * For the full copyright and license information, please view the LICENSE
- * file that was distributed with this source code.
- */
-export * from '@adonisjs/http-server/factories';
+export * from "@adonisjs/http-server/factories";
+export {};

package/build/factories/logger.js

@@ -1,9 +1,2 @@
-/*
- * @adonisjs/core
- *
- * (c) AdonisJS
- *
- * For the full copyright and license information, please view the LICENSE
- * file that was distributed with this source code.
- */
-export * from '@adonisjs/logger/factories';
+export * from "@adonisjs/logger/factories";
+export {};

package/build/factories/stubs.js

@@ -1,91 +1,28 @@
-/*
- * @adonisjs/core
- *
- * (c) AdonisJS
- *
- * For the full copyright and license information, please view the LICENSE
- * file that was distributed with this source code.
- */
-import { AppFactory } from '@adonisjs/application/factories';
-import { stubsRoot } from "../index.js";
-/**
- * Factory for preparing and processing stub templates from the "@adonisjs/core" package.
- * This factory is designed for internal testing and development purposes, utilizing
- * the core package's stub root directory.
- *
- * Note: This class is not published as it's intended for internal testing only.
- *
- * @example
- * ```ts
- * const stubsFactory = new StubsFactory()
- *
- * // Prepare a controller stub
- * const preparedStub = await stubsFactory.prepare('controller.stub', {
- *   filename: 'UserController',
- *   entity: { name: 'User' },
- *   resourceful: true
- * })
- *
- * console.log(preparedStub.contents)
- * ```
- */
-export class StubsFactory {
-    #parameters = {};
-    /**
-     * Returns an instance of application, either from parameters or creates a default one
-     */
-    #getApp() {
-        return this.#parameters.app || new AppFactory().create(new URL('./', import.meta.url));
-    }
-    /**
-     * Merge custom factory parameters to override defaults.
-     * This allows you to provide a custom application instance.
-     *
-     * @param params - Parameters to merge
-     * @param params.app - Custom application service instance
-     *
-     * @example
-     * ```ts
-     * const customApp = new AppFactory().create(appRoot)
-     * const stubsFactory = new StubsFactory().merge({ app: customApp })
-     * ```
-     */
-    merge(params) {
-        this.#parameters = Object.assign(this.#parameters, params);
-        return this;
-    }
-    /**
-     * Prepare a stub template with the provided data and return the processed content.
-     * This method initializes the application, loads the stub, and processes it with
-     * the given template variables.
-     *
-     * @param stubPath - Path to the stub file relative to the stubs root
-     * @param data - Template data to populate the stub placeholders
-     *
-     * @example
-     * ```ts
-     * const stubsFactory = new StubsFactory()
-     * const preparedStub = await stubsFactory.prepare('controller.stub', {
-     *   filename: 'UserController',
-     *   entity: {
-     *     name: 'User',
-     *     modelName: 'User',
-     *     pluralName: 'users'
-     *   },
-     *   resourceful: true
-     * })
-     *
-     * // Access the processed stub content
-     * console.log(preparedStub.contents)
-     * ```
-     */
-    async prepare(stubPath, data) {
-        const app = this.#getApp();
-        await app.init();
-        const stubs = await app.stubs.create();
-        const stub = await stubs.build(stubPath, {
-            source: stubsRoot,
-        });
-        return stub.prepare(data);
-    }
-}
+import "../chunk-MjwdjG2f.js";
+import { t as stubsRoot } from "../main-kn40V-hF.js";
+import "../container-ClFvcykQ.js";
+import "../debug-DURPi9xn.js";
+import "../main-B_vbYVm1.js";
+import "../app-B6oge7b3.js";
+import "../app-BK0PN3li.js";
+import "../config_provider-CY-xuo2R.js";
+import "../string-CJ7ewUFq.js";
+import "../utils-CNQ4tlGM.js";
+import "../core-CNNCwlhc.js";
+import { AppFactory } from "@adonisjs/application/factories";
+var StubsFactory = class {
+	#parameters = {};
+	#getApp() {
+		return this.#parameters.app || new AppFactory().create(new URL("./", import.meta.url));
+	}
+	merge(params) {
+		this.#parameters = Object.assign(this.#parameters, params);
+		return this;
+	}
+	async prepare(stubPath, data) {
+		const app = this.#getApp();
+		await app.init();
+		return (await (await app.stubs.create()).build(stubPath, { source: stubsRoot })).prepare(data);
+	}
+};
+export { StubsFactory };

package/build/index.js

@@ -1,46 +1,13 @@
-/*
- * @adonisjs/core
- *
- * (c) AdonisJS
- *
- * For the full copyright and license information, please view the LICENSE
- * file that was distributed with this source code.
- */
-import { errors as aceErrors } from '@adonisjs/ace';
-import { errors as envErrors } from '@adonisjs/env';
-import { errors as appErrors } from '@adonisjs/application';
-import { errors as encryptionErrors } from '@adonisjs/encryption';
-import { errors as httpServerErrors } from '@adonisjs/http-server';
-export { stubsRoot } from "./stubs/main.js";
-export { inject } from "./modules/container.js";
-export { Ignitor } from "./src/ignitor/main.js";
-export { configProvider } from "./src/config_provider.js";
-export { indexEntities } from "./src/assembler_hooks/index_entities.js";
-/**
- * Aggregated errors from all modules.
- */
-export const errors = {
-    ...encryptionErrors,
-    ...httpServerErrors,
-    ...appErrors,
-    ...aceErrors,
-    ...envErrors,
-};
-/**
- * Pretty prints an error with colorful output using
- * Youch terminal
- */
-export async function prettyPrintError(error) {
-    if (error && typeof error === 'object' && error.code === 'E_DUMP_DIE_EXCEPTION') {
-        console.error(error);
-        return;
-    }
-    try {
-        const { Youch } = await import('youch');
-        const youch = new Youch();
-        console.error(await youch.toANSI(error));
-    }
-    catch {
-        console.error(error);
-    }
-}
+import "./chunk-MjwdjG2f.js";
+import { t as stubsRoot } from "./main-kn40V-hF.js";
+import { t as container_exports } from "./container-ClFvcykQ.js";
+import "./debug-DURPi9xn.js";
+import { t as Ignitor } from "./main-B_vbYVm1.js";
+import "./app-B6oge7b3.js";
+import "./app-BK0PN3li.js";
+import { t as configProvider } from "./config_provider-CY-xuo2R.js";
+import "./string-CJ7ewUFq.js";
+import "./utils-CNQ4tlGM.js";
+import { n as prettyPrintError, r as indexEntities, t as errors } from "./core-CNNCwlhc.js";
+var inject = container_exports.inject;
+export { Ignitor, configProvider, errors, indexEntities, inject, prettyPrintError, stubsRoot };

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

@@ -75,29 +75,101 @@ export declare class Codemods extends EventEmitter {
      */
     getTsMorphProject(): Promise<CodeTransformer['project'] | undefined>;
     /**
-     * Define validations for the environment variables
+     * Define validations for the environment variables in the start/env.ts file.
+     * This method updates the environment validation schema using the assembler.
+     *
+     * @param validations - Validation schema node for environment variables
+     *
+     * @example
+     * ```ts
+     * await codemods.defineEnvValidations({
+     *   NODE_ENV: 'Env.schema.enum(["development", "production", "test"] as const)',
+     *   PORT: 'Env.schema.number()',
+     *   HOST: 'Env.schema.string({ format: "host" })'
+     * })
+     * ```
      */
     defineEnvValidations(validations: EnvValidationNode): Promise<void>;
     /**
-     * Define validations for the environment variables
+     * Register middleware in the start/kernel.ts file.
+     * This method adds middleware to the specified stack (server, router, or named).
+     *
+     * @param stack - The middleware stack to register to ('server' | 'router' | 'named')
+     * @param middleware - Array of middleware nodes to register
+     *
+     * @example
+     * ```ts
+     * await codemods.registerMiddleware('server', [
+     *   {
+     *     name: 'cors',
+     *     path: '@adonisjs/cors/cors_middleware'
+     *   }
+     * ])
+     * ```
      */
     registerMiddleware(stack: 'server' | 'router' | 'named', middleware: MiddlewareNode[]): Promise<void>;
     /**
-     * Register bouncer policies to the list of policies
-     * collection exported from the "app/policies/main.ts"
-     * file.
+     * Register bouncer policies to the list of policies collection exported from
+     * the "app/policies/main.ts" file. This method adds new policy definitions
+     * to the policies export.
+     *
+     * @param policies - Array of policy nodes to register
+     *
+     * @example
+     * ```ts
+     * await codemods.registerPolicies([
+     *   {
+     *     name: 'UserPolicy',
+     *     path: '#policies/user_policy'
+     *   }
+     * ])
+     * ```
      */
     registerPolicies(policies: BouncerPolicyNode[]): Promise<void>;
     /**
-     * Update RCFile
+     * Update the adonisrc.ts file with new configuration settings.
+     * This method allows modification of the AdonisJS runtime configuration.
+     *
+     * @param params - Parameters for updating the RC file (varies based on update type)
+     *
+     * @example
+     * ```ts
+     * await codemods.updateRcFile((rcFile) => {
+     *   rcFile.addCommand('make:custom')
+     *   rcFile.addPreloadFile('#app/events/main')
+     * })
+     * ```
      */
     updateRcFile(...params: Parameters<CodeTransformer['updateRcFile']>): Promise<void>;
     /**
-     * Register a new Vite plugin in the `vite.config.ts` file
+     * Register a new Vite plugin in the vite.config.ts file.
+     * This method adds plugin configuration to the Vite build configuration.
+     *
+     * @param params - Parameters for adding the Vite plugin (varies based on plugin type)
+     *
+     * @example
+     * ```ts
+     * await codemods.registerVitePlugin({
+     *   name: 'vue',
+     *   import: 'import vue from "@vitejs/plugin-vue"',
+     *   options: '()'
+     * })
+     * ```
      */
     registerVitePlugin(...params: Parameters<CodeTransformer['addVitePlugin']>): Promise<void>;
     /**
-     * Register a new Japa plugin in the `tests/bootstrap.ts` file
+     * Register a new Japa plugin in the tests/bootstrap.ts file.
+     * This method adds plugin configuration to the test runner setup.
+     *
+     * @param params - Parameters for adding the Japa plugin (varies based on plugin type)
+     *
+     * @example
+     * ```ts
+     * await codemods.registerJapaPlugin({
+     *   name: 'expect',
+     *   import: 'import { expect } from "@japa/expect"'
+     * })
+     * ```
      */
     registerJapaPlugin(...params: Parameters<CodeTransformer['addJapaPlugin']>): Promise<void>;
     /**
@@ -143,12 +215,19 @@ export declare class Codemods extends EventEmitter {
         skipReason: string;
     }>;
     /**
-     * Install packages using the correct package manager
-     * You can specify version of each package by setting it in the
-     * name like :
+     * Install packages using the detected or specified package manager.
+     * Automatically detects npm, yarn, or pnpm and installs dependencies accordingly.
+     * You can specify version of each package by setting it in the name like '@adonisjs/lucid@next'.
      *
-     * ```
-     * this.installPackages([{ name: '@adonisjs/lucid@next', isDevDependency: false }])
+     * @param packages - Array of packages with their dependency type
+     * @param packageManager - Optional package manager to use (auto-detected if not provided)
+     *
+     * @example
+     * ```ts
+     * const success = await codemods.installPackages([
+     *   { name: '@adonisjs/lucid', isDevDependency: false },
+     *   { name: '@types/node', isDevDependency: true }
+     * ])
      * ```
      */
     installPackages(packages: {
@@ -156,7 +235,23 @@ export declare class Codemods extends EventEmitter {
         isDevDependency: boolean;
     }[], packageManager?: SupportedPackageManager | 'pnpm@6' | 'deno'): Promise<boolean>;
     /**
-     * List the packages one should install before using the packages
+     * List the packages that should be installed manually.
+     * This method displays installation commands for different package managers
+     * when automatic installation is not available or desired.
+     *
+     * @param packages - Array of packages with their dependency type
+     *
+     * @example
+     * ```ts
+     * await codemods.listPackagesToInstall([
+     *   { name: '@adonisjs/lucid', isDevDependency: false },
+     *   { name: '@types/node', isDevDependency: true }
+     * ])
+     * // Output:
+     * // Please install following packages
+     * // npm i -D @types/node
+     * // npm i @adonisjs/lucid
+     * ```
      */
     listPackagesToInstall(packages: {
         name: string;