@adonisjs/core 7.0.0 → 7.1.0

package/build/factories/core/main.js

@@ -1,18 +1,26 @@
-import "../../chunk-iKc69rpz.js";
-import "../../main-kn40V-hF.js";
-import "../../debug-CGQmxzGt.js";
-import "../../main-Cxz0TyIw.js";
-import "../../config_provider-FIAUgvae.js";
-import "../../utils-rRkbAPnP.js";
-import "../../core-IpCOCkUL.js";
-import "../../main-MBAMnmJb.js";
-import "../../main-DN2qEEg5.js";
-import "../../errors-CrCO-k44.js";
-import "../../define_config-0oHaj43l.js";
-import "../../main-DkNgvceD.js";
-import { IgnitorFactory } from "./ignitor.js";
-import "../../create_kernel-B7ILNhuP.js";
-import { AceFactory } from "./ace.js";
-import "../../main--nXd7T-C.js";
-import { TestUtilsFactory } from "./test_utils.js";
+import "../../chunk-Do49iUES.js";
+import "../../main-CfTiGsiS.js";
+import "../../container-CGfEwWof.js";
+import "../../debug-DWofTfIX.js";
+import "../../main-D1MSq4Uu.js";
+import "../../app-CAuSGb2P.js";
+import "../../app-BCcG_oDd.js";
+import "../../config_provider-Do9af1ze.js";
+import "../../string-8_8He-HH.js";
+import "../../utils-CKwka7OL.js";
+import "../../core-XjMm_ipu.js";
+import "../../main-CRnMnrH7.js";
+import "../../logger-DIdZPHCe.js";
+import "../../exceptions-B2MzIlHY.js";
+import "../../main-Ck0GqLx4.js";
+import "../../errors-BScZTzBu.js";
+import "../../define_config--5euEdi8.js";
+import "../../main-CoZI4Ezs.js";
+import "../../main-B50zECAi.js";
+import "../../main-zxNP7iRl.js";
+import { t as IgnitorFactory } from "../../ignitor-Kym3gR-I.js";
+import "../../create_kernel-D38-0Zbt.js";
+import { t as AceFactory } from "../../ace-DBm6EcQ-.js";
+import "../../main-bRYXIHgD.js";
+import { t as TestUtilsFactory } from "../../test_utils-DbJS_uEu.js";
 export { AceFactory, IgnitorFactory, TestUtilsFactory };

package/build/factories/core/test_utils.js

@@ -1,20 +1,23 @@
-import "../../chunk-iKc69rpz.js";
-import "../../main-kn40V-hF.js";
-import "../../debug-CGQmxzGt.js";
-import { t as Ignitor } from "../../main-Cxz0TyIw.js";
-import "../../config_provider-FIAUgvae.js";
-import "../../utils-rRkbAPnP.js";
-import "../../core-IpCOCkUL.js";
-import "../../main-DN2qEEg5.js";
-import "../../errors-CrCO-k44.js";
-import "../../define_config-0oHaj43l.js";
-import "../../main-DkNgvceD.js";
-import { IgnitorFactory } from "./ignitor.js";
-import { t as TestUtils } from "../../main--nXd7T-C.js";
-var TestUtilsFactory = class {
-	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-Do49iUES.js";
+import "../../main-CfTiGsiS.js";
+import "../../container-CGfEwWof.js";
+import "../../debug-DWofTfIX.js";
+import "../../main-D1MSq4Uu.js";
+import "../../app-CAuSGb2P.js";
+import "../../app-BCcG_oDd.js";
+import "../../config_provider-Do9af1ze.js";
+import "../../string-8_8He-HH.js";
+import "../../utils-CKwka7OL.js";
+import "../../core-XjMm_ipu.js";
+import "../../logger-DIdZPHCe.js";
+import "../../exceptions-B2MzIlHY.js";
+import "../../main-Ck0GqLx4.js";
+import "../../errors-BScZTzBu.js";
+import "../../define_config--5euEdi8.js";
+import "../../main-CoZI4Ezs.js";
+import "../../main-B50zECAi.js";
+import "../../main-zxNP7iRl.js";
+import "../../ignitor-Kym3gR-I.js";
+import "../../main-bRYXIHgD.js";
+import { t as TestUtilsFactory } from "../../test_utils-DbJS_uEu.js";
 export { TestUtilsFactory };

package/build/factories/encryption.js

@@ -1,2 +1,3 @@
+import "../chunk-Do49iUES.js";
 export * from "@boringnode/encryption/factories";
 export {};

package/build/factories/events.js

@@ -1,2 +1,3 @@
+import "../chunk-Do49iUES.js";
 export * from "@adonisjs/events/factories";
 export {};

package/build/factories/hash.js

@@ -1,2 +1,3 @@
+import "../chunk-Do49iUES.js";
 export * from "@adonisjs/hash/factories";
 export {};

package/build/factories/http.js

@@ -1,2 +1,3 @@
+import "../chunk-Do49iUES.js";
 export * from "@adonisjs/http-server/factories";
 export {};

package/build/factories/logger.js

@@ -1,2 +1,3 @@
+import "../chunk-Do49iUES.js";
 export * from "@adonisjs/logger/factories";
 export {};

package/build/factories/stubs.js

@@ -1,24 +1,92 @@
-import "../chunk-iKc69rpz.js";
-import { t as stubsRoot } from "../main-kn40V-hF.js";
-import "../debug-CGQmxzGt.js";
-import "../main-Cxz0TyIw.js";
-import "../config_provider-FIAUgvae.js";
-import "../utils-rRkbAPnP.js";
-import "../core-IpCOCkUL.js";
+import "../chunk-Do49iUES.js";
+import { t as stubsRoot } from "../main-CfTiGsiS.js";
+import "../container-CGfEwWof.js";
+import "../debug-DWofTfIX.js";
+import "../main-D1MSq4Uu.js";
+import "../app-CAuSGb2P.js";
+import "../app-BCcG_oDd.js";
+import "../config_provider-Do9af1ze.js";
+import "../string-8_8He-HH.js";
+import "../utils-CKwka7OL.js";
+import "../core-XjMm_ipu.js";
 import { AppFactory } from "@adonisjs/application/factories";
+//#region factories/stubs.ts
+/**
+* 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)
+* ```
+*/
 var StubsFactory = class {
 	#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();
 		return (await (await app.stubs.create()).build(stubPath, { source: stubsRoot })).prepare(data);
 	}
 };
+//#endregion
 export { StubsFactory };

package/build/ignitor-Kym3gR-I.js

@@ -0,0 +1,169 @@
+import { t as Ignitor } from "./main-D1MSq4Uu.js";
+import { t as logger_exports } from "./logger-DIdZPHCe.js";
+import { t as main_exports } from "./main-Ck0GqLx4.js";
+import { n as drivers, t as defineConfig } from "./define_config--5euEdi8.js";
+import { n as defineConfig$1, r as drivers$1 } from "./main-B50zECAi.js";
+import { t as main_exports$1 } from "./main-zxNP7iRl.js";
+//#region factories/core/ignitor.ts
+/**
+* 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()
+* ```
+*/
+var IgnitorFactory = class {
+	#preloadActions = [];
+	#parameters = {};
+	/**
+	* A flag to know if we should load the core providers
+	*/
+	#loadCoreProviders = false;
+	/**
+	* 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) {
+		this.#preloadActions.push(action);
+		return this;
+	}
+	/**
+	* Merge core providers with user defined providers
+	*/
+	#mergeCoreProviders(providers) {
+		return [
+			() => import("@adonisjs/core/providers/app_provider"),
+			() => import("@adonisjs/core/providers/hash_provider"),
+			() => import("@adonisjs/core/providers/repl_provider")
+		].concat(providers || []);
+	}
+	/**
+	* 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) {
+		if (params.config) this.#parameters.config = Object.assign(this.#parameters.config || {}, params.config);
+		if (params.rcFileContents) this.#parameters.rcFileContents = Object.assign(this.#parameters.rcFileContents || {}, params.rcFileContents);
+		return this;
+	}
+	/**
+	* 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.#loadCoreProviders = true;
+		return this;
+	}
+	/**
+	* 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.merge({ config: {
+			app: {
+				appUrl: "http://localhost:3333",
+				http: (0, main_exports.defineConfig)({})
+			},
+			validator: {},
+			encryption: defineConfig({
+				default: "gcm",
+				list: { gcm: drivers.aes256gcm({
+					id: "gcm",
+					keys: ["averylongrandomsecretkey"]
+				}) }
+			}),
+			bodyparser: (0, main_exports$1.defineConfig)({}),
+			hash: defineConfig$1({
+				default: "scrypt",
+				list: { scrypt: drivers$1.scrypt({}) }
+			}),
+			logger: (0, logger_exports.defineConfig)({
+				default: "app",
+				loggers: { app: {} }
+			})
+		} });
+		return this;
+	}
+	/**
+	* 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, options) {
+		return new Ignitor(appRoot, options).tap((app) => {
+			app.booted(async () => {
+				for (let action of this.#preloadActions) await action(app);
+			});
+			if (this.#loadCoreProviders) {
+				this.#parameters.rcFileContents = this.#parameters.rcFileContents || {};
+				this.#parameters.rcFileContents.providers = this.#mergeCoreProviders(this.#parameters.rcFileContents.providers);
+			}
+			this.#parameters.rcFileContents && app.rcContents(this.#parameters.rcFileContents);
+			this.#parameters.config && app.useConfig(this.#parameters.config);
+		});
+	}
+};
+//#endregion
+export { IgnitorFactory as t };

package/build/index.js

@@ -1,10 +1,13 @@
-import "./chunk-iKc69rpz.js";
-import { t as stubsRoot } from "./main-kn40V-hF.js";
-import { t as container_exports } from "./modules/container.js";
-import "./debug-CGQmxzGt.js";
-import { t as Ignitor } from "./main-Cxz0TyIw.js";
-import { t as configProvider } from "./config_provider-FIAUgvae.js";
-import "./utils-rRkbAPnP.js";
-import { n as prettyPrintError, r as indexEntities, t as errors } from "./core-IpCOCkUL.js";
+import "./chunk-Do49iUES.js";
+import { t as stubsRoot } from "./main-CfTiGsiS.js";
+import { t as container_exports } from "./container-CGfEwWof.js";
+import "./debug-DWofTfIX.js";
+import { t as Ignitor } from "./main-D1MSq4Uu.js";
+import "./app-CAuSGb2P.js";
+import "./app-BCcG_oDd.js";
+import { t as configProvider } from "./config_provider-Do9af1ze.js";
+import "./string-8_8He-HH.js";
+import "./utils-CKwka7OL.js";
+import { n as prettyPrintError, r as indexEntities, t as errors } from "./core-XjMm_ipu.js";
 var inject = container_exports.inject;
 export { Ignitor, configProvider, errors, indexEntities, inject, prettyPrintError, stubsRoot };

package/build/logger-DIdZPHCe.js

@@ -0,0 +1,43 @@
+import { n as __reExport, t as __exportAll } from "./chunk-Do49iUES.js";
+import { destination } from "@adonisjs/logger";
+//#region modules/logger.ts
+var logger_exports = /* @__PURE__ */ __exportAll({ syncDestination: () => syncDestination });
+import * as import__adonisjs_logger from "@adonisjs/logger";
+__reExport(logger_exports, import__adonisjs_logger);
+/**
+* Creates a synchronous Pino Pretty stream for formatted log output.
+*
+* This function is specifically designed for testing and development environments
+* where synchronous log output is preferred. By default, Pino uses asynchronous
+* logging which can make it difficult to correlate logs with specific actions
+* during debugging or testing.
+*
+* @param options - Configuration options for the pretty printer
+*
+* @example
+* const loggerConfig = defineConfig({
+*   default: 'app',
+*   loggers: {
+*     app: {
+*       enabled: true,
+*       name: env.get('APP_NAME'),
+*       level: env.get('LOG_LEVEL'),
+*       desination: !app.inProduction && (await syncDestination()),
+*       transport: {
+*         targets: [targets.file({ destination: 1 })],
+*       },
+*     },
+*   }
+* })
+*
+* @returns A promise that resolves to a PrettyStream instance
+*/
+async function syncDestination(options) {
+	const { default: pinoPretty, isColorSupported } = await import("pino-pretty");
+	return isColorSupported ? pinoPretty({
+		...options,
+		sync: true
+	}) : destination(1);
+}
+//#endregion
+export { syncDestination as n, logger_exports as t };

package/build/main-B50zECAi.js

@@ -0,0 +1,121 @@
+import { n as __reExport, t as __exportAll } from "./chunk-Do49iUES.js";
+import { t as debug_default } from "./debug-DWofTfIX.js";
+import { t as configProvider } from "./config_provider-Do9af1ze.js";
+import { InvalidArgumentsException } from "@poppinss/utils/exception";
+//#region modules/hash/define_config.ts
+/**
+* Define config for the hash service. This function creates a configuration
+* provider that lazily imports and resolves hash drivers when needed.
+*
+* @param config - Configuration object containing default hasher and list of hashers
+* @param config.default - Optional default hasher name (must exist in the list)
+* @param config.list - Record of hasher configurations or config providers
+*
+* @example
+* ```ts
+* const hashConfig = defineConfig({
+*   default: 'scrypt',
+*   list: {
+*     scrypt: drivers.scrypt({
+*       cost: 16384,
+*       blockSize: 8,
+*       parallelization: 1,
+*       saltSize: 16,
+*       keyLength: 64,
+*     }),
+*     bcrypt: drivers.bcrypt({
+*       rounds: 10,
+*     })
+*   }
+* })
+* ```
+*/
+function defineConfig(config) {
+	/**
+	* Hashers list should always be provided
+	*/
+	if (!config.list) throw new InvalidArgumentsException("Missing \"list\" property in hash config");
+	/**
+	* The default hasher should be mentioned in the list
+	*/
+	if (config.default && !config.list[config.default]) throw new InvalidArgumentsException(`Missing "list.${String(config.default)}" in hash config. It is referenced by the "default" property`);
+	/**
+	* Config provider to lazily import drivers as they are used inside
+	* the user application
+	*/
+	return configProvider.create(async (app) => {
+		debug_default("resolving hash config");
+		const hashersList = Object.keys(config.list);
+		const hashers = {};
+		for (let hasherName of hashersList) {
+			const hasher = config.list[hasherName];
+			if (typeof hasher === "function") hashers[hasherName] = hasher;
+			else hashers[hasherName] = await hasher.resolver(app);
+		}
+		return {
+			default: config.default,
+			list: hashers
+		};
+	});
+}
+/**
+* Helpers to configure drivers inside the config file. These functions create
+* configuration providers that lazily import and instantiate hash drivers.
+*
+* - Import happens when you first use the hash module
+* - Construction of drivers happens when you first use a driver
+*
+* @example
+* ```ts
+* const hashConfig = defineConfig({
+*   default: 'bcrypt',
+*   list: {
+*     bcrypt: drivers.bcrypt({ rounds: 12 }),
+*     argon2: drivers.argon2({
+*       variant: 'id',
+*       memory: 65536,
+*       time: 3,
+*       parallelism: 4
+*     }),
+*     scrypt: drivers.scrypt({
+*       cost: 16384,
+*       blockSize: 8,
+*       parallelization: 1
+*     })
+*   }
+* })
+* ```
+*/
+const drivers = {
+	argon2: (config) => {
+		return configProvider.create(async () => {
+			const { Argon } = await import("./modules/hash/drivers/argon.js");
+			debug_default("configuring argon driver");
+			return () => new Argon(config);
+		});
+	},
+	bcrypt: (config) => {
+		return configProvider.create(async () => {
+			const { Bcrypt } = await import("./modules/hash/drivers/bcrypt.js");
+			debug_default("configuring bcrypt driver");
+			return () => new Bcrypt(config);
+		});
+	},
+	scrypt: (config) => {
+		return configProvider.create(async () => {
+			const { Scrypt } = await import("./modules/hash/drivers/scrypt.js");
+			debug_default("configuring scrypt driver");
+			return () => new Scrypt(config);
+		});
+	}
+};
+//#endregion
+//#region modules/hash/main.ts
+var main_exports = /* @__PURE__ */ __exportAll({
+	defineConfig: () => defineConfig,
+	drivers: () => drivers
+});
+import * as import__adonisjs_hash from "@adonisjs/hash";
+__reExport(main_exports, import__adonisjs_hash);
+//#endregion
+export { defineConfig as n, drivers as r, main_exports as t };