@adonisjs/core 7.0.0 → 7.1.0

package/build/modules/encryption/drivers/legacy.js

@@ -1,16 +1,51 @@
-import { t as E_BLIND_INDEX_NOT_SUPPORTED } from "../../../errors-CrCO-k44.js";
+import "../../../chunk-Do49iUES.js";
+import "../../../exceptions-B2MzIlHY.js";
+import { t as E_BLIND_INDEX_NOT_SUPPORTED } from "../../../errors-BScZTzBu.js";
 import { BaseDriver, Hmac, base64UrlDecode, base64UrlEncode, errors } from "@boringnode/encryption";
 import { MessageBuilder } from "@poppinss/utils";
 import { createCipheriv, createDecipheriv, randomBytes } from "node:crypto";
+//#region modules/encryption/drivers/legacy.ts
+/**
+* Factory function to create a Legacy encryption configuration.
+*
+* @example
+* ```ts
+* drivers.legacy({
+*   keys: [env.get('APP_KEY')]
+* })
+* ```
+*/
 function legacy(config) {
 	return {
 		driver: (key) => new Legacy({ key }),
 		keys: config.keys
 	};
 }
+/**
+* Legacy encryption driver for AdonisJS.
+*
+* This driver maintains compatibility with the old AdonisJS v6 encryption
+* format. It uses:
+* - AES-256-CBC for encryption
+* - HMAC SHA-256 for integrity verification
+* - MessageBuilder from @poppinss/utils for encoding values
+*
+* Encrypted format: `[encrypted_base64url].[iv_base64url].[hmac]`
+*
+* @example
+* ```ts
+* const driver = new Legacy({ key: 'your-32-character-secret-key!!' })
+*
+* const encrypted = driver.encrypt('sensitive data')
+* const decrypted = driver.decrypt(encrypted)
+* ```
+*/
 var Legacy = class extends BaseDriver {
 	constructor(config) {
 		super(config);
+		/**
+		* The key length must be at least 16 characters
+		*/
 		if (this.cryptoKey.length < 16) throw new errors.E_INSECURE_ENCRYPTER_KEY();
 	}
 	encrypt(payload, expiresInOrOptions, purpose) {
@@ -30,6 +65,9 @@ var Legacy = class extends BaseDriver {
 		const hmac = new Hmac(this.cryptoKey).generate(macPayload);
 		return this.computeReturns([macPayload, hmac]);
 	}
+	/**
+	* Decrypt value and verify it against a purpose
+	*/
 	decrypt(value, purpose) {
 		if (typeof value !== "string") return null;
 		const [cipherEncoded, ivEncoded, macEncoded] = value.split(this.separator);
@@ -47,11 +85,18 @@ var Legacy = class extends BaseDriver {
 			return null;
 		}
 	}
+	/**
+	* Legacy driver does not support blind indexes.
+	*/
 	blindIndex(_payload, _purpose) {
 		throw new E_BLIND_INDEX_NOT_SUPPORTED(["legacy"]);
 	}
+	/**
+	* Legacy driver does not support blind indexes.
+	*/
 	blindIndexes(_payload, _purpose) {
 		throw new E_BLIND_INDEX_NOT_SUPPORTED(["legacy"]);
 	}
 };
+//#endregion
 export { Legacy, legacy };

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 };