@adonisjs/core 7.0.1 → 7.1.0

package/build/modules/encryption/main.js

@@ -1,6 +1,8 @@
-import "../../debug-CGQmxzGt.js";
-import "../../config_provider-FIAUgvae.js";
-import { n as errors } from "../../errors-CrCO-k44.js";
-import { n as drivers, t as defineConfig } from "../../define_config-0oHaj43l.js";
-import { BaseDriver, Encryption, EncryptionManager, Hmac } from "@boringnode/encryption";
+import "../../chunk-Do49iUES.js";
+import "../../debug-DWofTfIX.js";
+import "../../config_provider-Do9af1ze.js";
+import "../../exceptions-B2MzIlHY.js";
+import { n as errors } from "../../errors-BScZTzBu.js";
+import { n as drivers, t as defineConfig } from "../../define_config--5euEdi8.js";
+import { i as Hmac, n as Encryption, r as EncryptionManager, t as BaseDriver } from "../../main-CoZI4Ezs.js";
 export { BaseDriver, Encryption, EncryptionManager, Hmac, defineConfig, drivers, errors };

package/build/modules/env/editor.js

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

package/build/modules/env/main.js

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

package/build/modules/events.js

@@ -1,6 +1,4 @@
-import { n as __reExport, t as __exportAll } from "../chunk-iKc69rpz.js";
+import "../chunk-Do49iUES.js";
+import "../events-DlKX1ZdL.js";
 export * from "@adonisjs/events";
-var events_exports = /* @__PURE__ */ __exportAll({});
-import * as import__adonisjs_events from "@adonisjs/events";
-__reExport(events_exports, import__adonisjs_events);
-export { events_exports as t };
+export {};

package/build/modules/hash/drivers/argon.js

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

package/build/modules/hash/drivers/bcrypt.js

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

package/build/modules/hash/drivers/scrypt.js

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

package/build/modules/hash/main.js

@@ -1,6 +1,6 @@
-import "../../chunk-iKc69rpz.js";
-import "../../debug-CGQmxzGt.js";
-import "../../config_provider-FIAUgvae.js";
-import { n as defineConfig, r as drivers } from "../../main-DkNgvceD.js";
+import "../../chunk-Do49iUES.js";
+import "../../debug-DWofTfIX.js";
+import "../../config_provider-Do9af1ze.js";
+import { n as defineConfig, r as drivers } from "../../main-B50zECAi.js";
 export * from "@adonisjs/hash";
 export { defineConfig, drivers };

package/build/modules/hash/phc_formatter.js

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

package/build/modules/health.js

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

package/build/modules/http/helpers.js

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

package/build/modules/http/main.js

@@ -1,4 +1,4 @@
-import "../../chunk-iKc69rpz.js";
-import { n as RequestValidator } from "../../main-DN2qEEg5.js";
+import "../../chunk-Do49iUES.js";
+import { n as RequestValidator } from "../../main-Ck0GqLx4.js";
 export * from "@adonisjs/http-server";
 export { RequestValidator };

package/build/modules/http/url_builder_client.js

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

package/build/modules/logger.js

@@ -1,14 +1,4 @@
-import { n as __reExport, t as __exportAll } from "../chunk-iKc69rpz.js";
-import { destination } from "@adonisjs/logger";
+import "../chunk-Do49iUES.js";
+import { n as syncDestination } from "../logger-DIdZPHCe.js";
 export * from "@adonisjs/logger";
-var logger_exports = /* @__PURE__ */ __exportAll({ syncDestination: () => syncDestination });
-import * as import__adonisjs_logger from "@adonisjs/logger";
-__reExport(logger_exports, import__adonisjs_logger);
-async function syncDestination(options) {
-	const { default: pinoPretty, isColorSupported } = await import("pino-pretty");
-	return isColorSupported ? pinoPretty({
-		...options,
-		sync: true
-	}) : destination(1);
-}
-export { syncDestination, logger_exports as t };
+export { syncDestination };

package/build/modules/repl.js

@@ -1,6 +1,4 @@
-import { n as __reExport, t as __exportAll } from "../chunk-iKc69rpz.js";
+import "../chunk-Do49iUES.js";
+import "../repl-C02Re0Yd.js";
 export * from "@adonisjs/repl";
-var repl_exports = /* @__PURE__ */ __exportAll({});
-import * as import__adonisjs_repl from "@adonisjs/repl";
-__reExport(repl_exports, import__adonisjs_repl);
-export { repl_exports as t };
+export {};

package/build/modules/transformers/main.js

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

package/build/providers/app_provider.js

@@ -1,63 +1,174 @@
-import "../chunk-iKc69rpz.js";
-import "../debug-CGQmxzGt.js";
-import { t as app_exports } from "../modules/app.js";
-import { t as configProvider } from "../config_provider-FIAUgvae.js";
-import { t as config_exports } from "../modules/config.js";
-import { t as events_exports } from "../modules/events.js";
-import { t as logger_exports } from "../modules/logger.js";
-import { t as Dumper } from "../dumper-BBgqFX5a.js";
-import { RuntimeException } from "../src/exceptions.js";
-import { t as main_exports } from "../main-DN2qEEg5.js";
-import "../errors-CrCO-k44.js";
-import "../define_config-0oHaj43l.js";
-import { Encryption } from "../modules/encryption/main.js";
-import bodyparser_middleware_default from "../modules/bodyparser/bodyparser_middleware.js";
+import "../chunk-Do49iUES.js";
+import "../debug-DWofTfIX.js";
+import { t as app_exports } from "../app-BCcG_oDd.js";
+import { t as configProvider } from "../config_provider-Do9af1ze.js";
+import { t as config_exports } from "../config-Coti2q6R.js";
+import { t as events_exports } from "../events-DlKX1ZdL.js";
+import { t as logger_exports } from "../logger-DIdZPHCe.js";
+import { t as Dumper } from "../dumper-3R77st8F.js";
+import { r as RuntimeException } from "../exceptions-B2MzIlHY.js";
+import { t as main_exports } from "../main-Ck0GqLx4.js";
+import "../errors-BScZTzBu.js";
+import "../define_config--5euEdi8.js";
+import { n as Encryption } from "../main-CoZI4Ezs.js";
+import { t as bodyparser_middleware_default } from "../bodyparser_middleware-H5FArWkI.js";
 import { dirname } from "node:path";
 import { mkdir, writeFile } from "node:fs/promises";
+//#region providers/app_provider.ts
+/**
+* The Application Service provider registers all the baseline
+* features required to run the framework.
+*
+* This provider handles the registration of core services including:
+* - Application instance
+* - Logger and logger manager
+* - Configuration
+* - Event emitter
+* - Encryption service
+* - HTTP server and router
+* - Body parser middleware
+* - Dumper for debugging
+* - Test utilities and ACE kernel
+*
+* @example
+* const provider = new AppServiceProvider(app)
+* provider.register()
+* await provider.boot()
+* await provider.ready()
+*/
 var AppServiceProvider = class {
+	/**
+	* Application service provider constructor
+	*
+	* @param app - The application service instance
+	*/
 	constructor(app) {
 		this.app = app;
 	}
+	/**
+	* Registers test utils with the container
+	*
+	* Creates a singleton binding for 'testUtils' that lazily imports
+	* and instantiates the TestUtils class when first accessed.
+	*
+	* @example
+	* const testUtils = await app.container.make('testUtils')
+	* testUtils.createHttpContext()
+	*/
 	registerTestUtils() {
 		this.app.container.singleton("testUtils", async () => {
 			const { TestUtils } = await import("../src/test_utils/main.js");
 			return new TestUtils(this.app);
 		});
 	}
+	/**
+	* Registers ace with the container
+	*
+	* Creates a singleton binding for 'ace' that lazily creates
+	* the ACE kernel for command-line interface functionality.
+	*
+	* @example
+	* const ace = await app.container.make('ace')
+	* await ace.exec('make:controller', ['UserController'])
+	*/
 	registerAce() {
 		this.app.container.singleton("ace", async () => {
-			const { createAceKernel } = await import("../create_kernel-BD0Iqi8e.js");
+			const { createAceKernel } = await import("../create_kernel-BV3swyCg.js");
 			return createAceKernel(this.app);
 		});
 	}
+	/**
+	* Registers the application to the container
+	*
+	* Binds the application instance as both a class binding and an alias.
+	* This allows access to the app instance throughout the container.
+	*
+	* @example
+	* const app = await container.make('app')
+	* const appPath = app.makePath('tmp')
+	*/
 	registerApp() {
 		this.app.container.singleton(app_exports.Application, () => this.app);
 		this.app.container.alias("app", app_exports.Application);
 	}
+	/**
+	* Registers the logger class to resolve the default logger
+	*
+	* Creates a singleton binding for the Logger class that resolves
+	* the default logger instance from the logger manager.
+	*
+	* @example
+	* const logger = await container.make(Logger)
+	* logger.info('Application started')
+	*/
 	registerLogger() {
 		this.app.container.singleton(logger_exports.Logger, async (resolver) => {
 			return (await resolver.make("logger")).use();
 		});
 	}
+	/**
+	* Registers the logger manager to the container
+	*
+	* Creates a singleton binding for 'logger' that instantiates
+	* the LoggerManager with configuration from config/logger.ts
+	*
+	* @example
+	* const loggerManager = await container.make('logger')
+	* const fileLogger = loggerManager.use('file')
+	*/
 	registerLoggerManager() {
 		this.app.container.singleton("logger", async () => {
 			const { LoggerManager } = await import("../modules/logger.js");
 			return new LoggerManager(this.app.config.get("logger"));
 		});
 	}
+	/**
+	* Registers the config to the container
+	*
+	* Binds the application's config instance as both a class binding
+	* and an alias, allowing access to configuration values.
+	*
+	* @example
+	* const config = await container.make('config')
+	* const appKey = config.get('app.appKey')
+	*/
 	registerConfig() {
 		this.app.container.singleton(config_exports.Config, () => this.app.config);
 		this.app.container.alias("config", config_exports.Config);
 	}
+	/**
+	* Registers emitter service to the container
+	*
+	* Creates a singleton binding for the event emitter that handles
+	* application-wide event dispatching and listening.
+	*
+	* @example
+	* const emitter = await container.make('emitter')
+	* emitter.emit('user:created', { userId: 123 })
+	*/
 	registerEmitter() {
 		this.app.container.singleton(events_exports.Emitter, async () => {
 			return new events_exports.Emitter(this.app);
 		});
 		this.app.container.alias("emitter", events_exports.Emitter);
 	}
+	/**
+	* Registers the encryption service with the container
+	*
+	* Creates singleton bindings for both the encryption manager and
+	* the default encryption instance. Resolves configuration from
+	* config/encryption.ts file.
+	*
+	* @example
+	* const encryption = await container.make('encryption')
+	* const encrypted = encryption.encrypt('secret-data')
+	*/
 	registerEncryption() {
 		this.app.container.singleton("encryption", async () => {
 			const encryptionConfigProvider = this.app.config.get("encryption");
+			/**
+			* Resolve config from the provider
+			*/
 			const config = await configProvider.resolve(this.app, encryptionConfigProvider);
 			if (!config) throw new RuntimeException("Invalid \"config/encryption.ts\" file. Make sure you are using the \"defineConfig\" method");
 			const { EncryptionManager } = await import("../modules/encryption/main.js");
@@ -67,6 +178,17 @@ var AppServiceProvider = class {
 			return (await resolver.make("encryption")).use();
 		});
 	}
+	/**
+	* Registers the HTTP server with the container as a singleton
+	*
+	* Creates a singleton binding for the HTTP server that handles
+	* incoming requests, with dependencies on encryption, emitter,
+	* logger, and HTTP configuration.
+	*
+	* @example
+	* const server = await container.make('server')
+	* server.start()
+	*/
 	registerServer() {
 		this.app.container.singleton(main_exports.Server, async (resolver) => {
 			const encryption = await resolver.make(Encryption);
@@ -77,17 +199,49 @@ var AppServiceProvider = class {
 		});
 		this.app.container.alias("server", main_exports.Server);
 	}
+	/**
+	* Registers router with the container as a singleton
+	*
+	* Creates a singleton binding for the router by getting it from
+	* the HTTP server instance. The router handles URL routing.
+	*
+	* @example
+	* const router = await container.make('router')
+	* router.get('/', ({ response }) => response.send('Hello'))
+	*/
 	registerRouter() {
 		this.app.container.singleton(main_exports.Router, async (resolver) => {
 			return (await resolver.make("server")).getRouter();
 		});
 		this.app.container.alias("router", main_exports.Router);
 	}
+	/**
+	* Self construct bodyparser middleware class, since it needs
+	* config that cannot be resolved by the container
+	*
+	* Binds the BodyParserMiddleware with bodyparser configuration
+	* and experimental flags for parsing request bodies.
+	*
+	* @example
+	* const middleware = await container.make(BodyParserMiddleware)
+	* await middleware.handle(ctx, next)
+	*/
 	registerBodyParserMiddleware() {
 		this.app.container.singleton(bodyparser_middleware_default, () => {
 			return new bodyparser_middleware_default(this.app.config.get("bodyparser"), this.app.experimentalFlags);
 		});
 	}
+	/**
+	* Registeres singleton instance of the "Dumper" module configured
+	* via the "config/app.ts" file.
+	*
+	* The dumper is used for debugging and variable inspection with
+	* configurable HTML and console output formats.
+	*
+	* @example
+	* const dumper = await container.make('dumper')
+	* dumper.dump({ user: { name: 'John' } })
+	*/
 	registerDumper() {
 		this.app.container.singleton(Dumper, async () => {
 			const config = this.app.config.get("app.dumper", {});
@@ -98,6 +252,20 @@ var AppServiceProvider = class {
 		});
 		this.app.container.alias("dumper", Dumper);
 	}
+	/**
+	* Generates TypeScript type definitions and JSON representation of routes
+	*
+	* Creates route type definitions for better IDE support and a JSON file
+	* containing all registered routes. This is used in development mode for
+	* tooling integration and type-safety.
+	*
+	* @param router - The router instance containing registered routes
+	*
+	* @example
+	* const router = await container.make('router')
+	* await this.emitRoutes(router)
+	* // Generates .adonisjs/server/routes.d.ts and routes.json
+	*/
 	async emitRoutes(router) {
 		try {
 			const { routes, imports, types } = router.generateTypes(2);
@@ -126,6 +294,16 @@ var AppServiceProvider = class {
 			console.error(error);
 		}
 	}
+	/**
+	* Registers bindings
+	*
+	* Called during the application bootstrap phase to register
+	* all core service bindings with the IoC container.
+	*
+	* @example
+	* const provider = new AppServiceProvider(app)
+	* provider.register() // Registers all core services
+	*/
 	register() {
 		this.registerApp();
 		this.registerAce();
@@ -140,9 +318,29 @@ var AppServiceProvider = class {
 		this.registerRouter();
 		this.registerBodyParserMiddleware();
 	}
+	/**
+	* Boot the service provider
+	*
+	* Called after all providers have been registered. Sets up
+	* event emitter for BaseEvent and adds transform macro to HttpContext.
+	*
+	* @example
+	* await provider.boot()
+	* // Now HttpContext has transform method available
+	*/
 	async boot() {
 		events_exports.BaseEvent.useEmitter(await this.app.container.make("emitter"));
 	}
+	/**
+	* Called when the application is ready
+	*
+	* In non-production environments, generates route types and
+	* JSON files for development tooling when router is committed.
+	*
+	* @example
+	* await provider.ready()
+	* // Route types and JSON generated in development
+	*/
 	async ready() {
 		if (!this.app.inProduction) {
 			const router = await this.app.container.make("router");
@@ -150,4 +348,5 @@ var AppServiceProvider = class {
 		}
 	}
 };
+//#endregion
 export { AppServiceProvider as default };

package/build/providers/edge_provider.js

@@ -1,23 +1,76 @@
-import "../chunk-iKc69rpz.js";
-import { t as main_exports } from "../main-DN2qEEg5.js";
-import { pluginEdgeDumper } from "../modules/dumper/plugins/edge.js";
+import "../chunk-Do49iUES.js";
+import { t as main_exports } from "../main-Ck0GqLx4.js";
+import { t as pluginEdgeDumper } from "../edge-BG5ZYp6Z.js";
 import edge from "edge.js";
+//#region providers/edge_provider.ts
+/**
+* The Edge service provider configures Edge to work within
+* an AdonisJS application environment
+*
+* This provider integrates EdgeJS template engine with AdonisJS by:
+* - Mounting the views directory
+* - Configuring template caching for production
+* - Adding global helpers for route generation
+* - Creating isolated renderer instances for HTTP contexts
+* - Adding render macro to BriskRoute for template rendering
+*
+* @example
+* const provider = new EdgeServiceProvider(app)
+* await provider.boot()
+*/
 var EdgeServiceProvider = class {
+	/**
+	* Edge service provider constructor
+	*
+	* Sets the usingEdgeJS flag to true to indicate EdgeJS is being used.
+	*
+	* @param app - The application service instance
+	*/
 	constructor(app) {
 		this.app = app;
 		this.app.usingEdgeJS = true;
 	}
+	/**
+	* Bridge AdonisJS and Edge
+	*
+	* Configures EdgeJS integration by:
+	* - Setting up template mounting and caching
+	* - Defining global helpers (route, signedRoute, app, config)
+	* - Adding view getter to HttpContext for isolated rendering
+	* - Adding render macro to BriskRoute
+	* - Registering dumper plugin
+	*
+	* @example
+	* await provider.boot()
+	* // Now edge templates can use {{ route('home') }} helper
+	*/
 	async boot() {
 		const app = this.app;
 		const qs = new main_exports.Qs(app.config.get("app.http.qs", {}));
 		const router = await this.app.container.make("router");
 		const dumper = await this.app.container.make("dumper");
+		/**
+		* Resolves configuration values for Edge templates
+		*
+		* Provides access to application configuration within templates.
+		* Includes a 'has' method to check for config key existence.
+		*
+		* @param key - The configuration key to retrieve
+		* @param defaultValue - Optional default value if key doesn't exist
+		*/
 		function edgeConfigResolver(key, defaultValue) {
 			return app.config.get(key, defaultValue);
 		}
 		edgeConfigResolver.has = function(key) {
 			return app.config.has(key);
 		};
+		/**
+		* Generates client-side route definitions for frontend use
+		*
+		* Transforms router definitions into a serializable format that
+		* can be used in client-side JavaScript for route generation.
+		* Only includes named routes.
+		*/
 		function clientRoutes() {
 			const routes = router.toJSON();
 			return Object.keys(routes).reduce((result, domain) => {
@@ -35,8 +88,18 @@ var EdgeServiceProvider = class {
 				return result;
 			}, {});
 		}
+		/**
+		* Mount the default disk
+		*/
 		edge.mount(app.viewsPath());
+		/**
+		* Cache templates in production
+		*/
 		edge.configure({ cache: app.inProduction });
+		/**
+		* Define Edge global helpers
+		* @deprecated
+		*/
 		edge.global("route", function(...args) {
 			return router.makeUrl(...args);
 		});
@@ -51,19 +114,35 @@ var EdgeServiceProvider = class {
 		edge.global("routesJSON", function() {
 			return JSON.stringify(clientRoutes());
 		});
+		/**
+		* Route helpers
+		*/
 		edge.global("urlFor", function(...args) {
 			return router.urlBuilder.urlFor(...args);
 		});
 		edge.global("signedUrlFor", function(...args) {
 			return router.urlBuilder.signedUrlFor(...args);
 		});
+		/**
+		* Sharing qs parser with templates
+		*/
 		edge.global("qs", qs);
 		edge.global("formAttributes", function(route, params, options) {
 			const matchingRoute = router.findOrFail(route);
+			/**
+			* Normalize method and keep a reference to the original method
+			*/
 			options = options ?? {};
 			let method = matchingRoute.methods[0].toUpperCase();
 			const original = method;
+			/**
+			* In case of HEAD, we must use the GET method
+			*/
 			if (method === "HEAD") method = "GET";
+			/**
+			* If method if not GET and POST, then use the querystring _method
+			* to and force update the method to "POST"
+			*/
 			if (method !== "GET" && method !== "POST") {
 				method = "POST";
 				options = {
@@ -80,9 +159,16 @@ var EdgeServiceProvider = class {
 				method
 			};
 		});
+		/**
+		* Creating a isolated instance of edge renderer
+		*/
 		main_exports.HttpContext.getter("view", function() {
 			return edge.createRenderer().share({ request: this.request });
 		}, true);
+		/**
+		* Adding brisk route to render templates without an
+		* explicit handler
+		*/
 		main_exports.BriskRoute.macro("render", function(template, data) {
 			function rendersTemplate({ view }) {
 				return view.render(template, data);
@@ -96,4 +182,5 @@ var EdgeServiceProvider = class {
 		edge.use(pluginEdgeDumper(dumper));
 	}
 };
+//#endregion
 export { EdgeServiceProvider as default };