@adonisjs/core 7.0.1 → 7.1.1

package/build/src/vine.js

@@ -1,33 +1,3 @@
-import vine, { BaseLiteralType, symbols } from "@vinejs/vine";
-const MULTIPART_FILE = symbols.SUBTYPE ?? Symbol.for("subtype");
-function isBodyParserFile(file) {
-	return !!(file && typeof file === "object" && "isMultipartFile" in file);
-}
-const isMultipartFile = vine.createRule((file, options, field) => {
-	if (!field.isDefined) return false;
-	if (!isBodyParserFile(file)) {
-		field.report("The {{ field }} must be a file", "file", field);
-		return false;
-	}
-	const validationOptions = typeof options === "function" ? options(field) : options;
-	if (file.sizeLimit === void 0 && validationOptions.size) file.sizeLimit = validationOptions.size;
-	if (file.allowedExtensions === void 0 && validationOptions.extnames) file.allowedExtensions = validationOptions.extnames;
-	file.validate();
-	file.errors.forEach((error) => {
-		field.report(error.message, `file.${error.type}`, field, validationOptions);
-	});
-	return file.isValid;
-});
-var VineMultipartFile = class VineMultipartFile extends BaseLiteralType {
-	#validationOptions;
-	[MULTIPART_FILE] = "multipartFile";
-	constructor(validationOptions, options, validations) {
-		super(options, validations || []);
-		this.#validationOptions = validationOptions;
-		this.dataTypeValidator = isMultipartFile(validationOptions || {});
-	}
-	clone() {
-		return new VineMultipartFile(this.#validationOptions, this.cloneOptions(), this.cloneValidations());
-	}
-};
+import "../chunk-Do49iUES.js";
+import { t as VineMultipartFile } from "../vine-DkIupA3Z.js";
 export { VineMultipartFile };

package/build/string-8_8He-HH.js

@@ -0,0 +1,46 @@
+import prettyHrTime from "pretty-hrtime";
+import string from "@poppinss/utils/string";
+import he from "he";
+import StringBuilder from "@poppinss/utils/string_builder";
+//#region src/helpers/string.ts
+/**
+* Collection of string helpers to transform a string value. This object extends
+* the base string utilities from @poppinss/utils with additional AdonisJS-specific
+* string manipulation methods.
+*
+* @example
+* // Basic string transformations
+* stringHelpers.camelCase('hello_world') // 'helloWorld'
+* stringHelpers.snakeCase('HelloWorld')   // 'hello_world'
+* stringHelpers.pascalCase('hello world') // 'HelloWorld'
+*
+* @example
+* // HTML escaping and encoding
+* stringHelpers.escapeHTML('<script>alert("xss")<\/script>')
+* stringHelpers.encodeSymbols('© 2023 AdonisJS')
+*/
+const stringHelpers = {
+	...string,
+	toSentence: string.sentence,
+	ordinalize: string.ordinal,
+	generateRandom: string.random,
+	create(value) {
+		return new StringBuilder(value);
+	},
+	prettyHrTime(time, options) {
+		return prettyHrTime(time, options);
+	},
+	isEmpty(value) {
+		return value.trim().length === 0;
+	},
+	escapeHTML(value, options) {
+		value = he.escape(value);
+		if (options && options.encodeSymbols) value = this.encodeSymbols(value, { allowUnsafeSymbols: true });
+		return value;
+	},
+	encodeSymbols(value, options) {
+		return he.encode(value, options);
+	}
+};
+//#endregion
+export { stringHelpers as t };

package/build/test_utils-DbJS_uEu.js

@@ -0,0 +1,32 @@
+import { t as Ignitor } from "./main-D1MSq4Uu.js";
+import { t as IgnitorFactory } from "./ignitor-Kym3gR-I.js";
+import { t as TestUtils } from "./main-bRYXIHgD.js";
+//#region factories/core/test_utils.ts
+/**
+* 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')
+* ```
+*/
+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"));
+	}
+};
+//#endregion
+export { TestUtilsFactory as t };

package/build/toolkit/main.js

@@ -1,7 +1,13 @@
 #!/usr/bin/env node
-import { t as __decorate } from "../decorate-DmrZA614.js";
+import "../chunk-Do49iUES.js";
+import { t as __decorate } from "../decorate-B9Uz0anB.js";
 import { BaseCommand, HelpCommand, IndexGenerator, Kernel, ListLoader, args } from "@adonisjs/ace";
 import { join } from "node:path";
+//#region toolkit/commands/index_commands.ts
+/**
+* Generates index of commands with a loader. Must be called against
+* the TypeScript compiled output.
+*/
 var IndexCommand = class extends BaseCommand {
 	static commandName = "index";
 	static description = "Create an index of commands along with a lazy loader";
@@ -10,16 +16,22 @@ var IndexCommand = class extends BaseCommand {
 	}
 };
 __decorate([args.string({ description: "Relative path from cwd to the commands directory" })], IndexCommand.prototype, "commandsDir", void 0);
+//#endregion
+//#region toolkit/main.ts
 const kernel = Kernel.create();
 kernel.addLoader(new ListLoader([IndexCommand]));
 kernel.defineFlag("help", {
 	type: "boolean",
 	description: HelpCommand.description
 });
+/**
+* Flag listener to display the help
+*/
 kernel.on("help", async (command, $kernel, parsed) => {
 	parsed.args.unshift(command.commandName);
 	await new HelpCommand($kernel, parsed, kernel.ui, kernel.prompt).exec();
 	return $kernel.shortcircuit();
 });
 await kernel.handle(process.argv.splice(2));
+//#endregion
 export {};

package/build/types/ace.js

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

package/build/types/app.js

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

package/build/types/bodyparser.js

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

package/build/types/common.js

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

package/build/types/container.js

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

package/build/types/encryption.js

@@ -1 +1,2 @@
+import "../chunk-Do49iUES.js";
 export {};

package/build/types/events.js

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

package/build/types/hash.js

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

package/build/types/health.js

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

package/build/types/helpers.js

@@ -1 +1,2 @@
+import "../chunk-Do49iUES.js";
 export {};

package/build/types/http.js

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

package/build/types/logger.js

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

package/build/types/repl.js

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

package/build/types/transformers.js

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

package/build/utils-CKwka7OL.js

@@ -0,0 +1,105 @@
+//#region src/utils.ts
+/**
+* Imports the AdonisJS assembler package optionally. This function attempts
+* to import the assembler and returns undefined if it's not available,
+* making it safe to use in environments where the assembler might not be installed.
+*
+* @param app - The application service instance used for importing the assembler
+*
+* @example
+* const assembler = await importAssembler(app)
+* if (assembler) {
+*   // Use assembler functionality
+*   const generator = new assembler.IndexGenerator()
+* }
+*/
+async function importAssembler(app) {
+	try {
+		return await app.import("@adonisjs/assembler");
+	} catch {}
+}
+/**
+* Imports the TypeScript compiler package optionally. This function attempts
+* to import TypeScript and returns undefined if it's not available,
+* making it safe to use in environments where TypeScript might not be installed.
+*
+* @param app - The application service instance used for importing TypeScript
+*
+* @example
+* const ts = await importTypeScript(app)
+* if (ts) {
+*   // Use TypeScript compiler API
+*   const program = ts.createProgram(['file.ts'], {})
+*   const sourceFile = program.getSourceFile('file.ts')
+* }
+*/
+async function importTypeScript(app) {
+	try {
+		return await app.importDefault("typescript");
+	} catch {}
+}
+/**
+* Outputs transformer data objects by generating TypeScript type definitions
+* for all transformers in the provided file tree. This function creates
+* InferData types for each transformer and organizes them in namespaces.
+*
+* @param transformersList - A recursive file tree containing transformer file paths
+* @param buffer - The file buffer to write the generated types to
+*
+* @example
+* const transformersList = {
+*   User: '#app/transformers/user_transformer',
+*   Auth: {
+*     Login: '#app/transformers/auth/login_transformer'
+*   }
+* }
+* await outputTransformerDataObjects(transformersList, buffer)
+* // Generates:
+* // export namespace Data {
+* //   export type User = InferData<UserTransformer>
+* //   export namespace Auth {
+* //     export type Login = InferData<AuthLoginTransformer>
+* //   }
+* // }
+*/
+async function outputTransformerDataObjects(transformersList, buffer, withSharedProps, inertiaMiddlewareImportPath = "#middleware/inertia_middleware") {
+	const importsBuffer = buffer.create();
+	importsBuffer.write(`/// <reference path="./manifest.d.ts" />`);
+	importsBuffer.write(`import type { InferData, InferVariants } from '@adonisjs/core/types/transformers'`);
+	if (withSharedProps) importsBuffer.write(`import type { InferSharedProps } from '@adonisjs/inertia/types'`);
+	buffer.writeLine(importsBuffer);
+	buffer.write("export namespace Data {").indent();
+	/**
+	* Recursively generates namespace tree structure for transformers.
+	* Creates nested namespaces for directory structures and type exports
+	* for individual transformer files.
+	*
+	* @param input - The current level of the file tree to process
+	* @param parents - Array of parent namespace names for import naming
+	*/
+	function generateNamespaceTree(input, parents) {
+		Object.keys(input).forEach((key) => {
+			const value = input[key];
+			if (typeof value === "string") {
+				const importName = `${parents.join("")}${key}Transformer`;
+				importsBuffer.write(`import type ${importName} from '${value}'`);
+				buffer.write(`export type ${key} = InferData<${importName}>`);
+				buffer.write(`export namespace ${key} {`).indent();
+				buffer.write(`export type Variants = InferVariants<${importName}>`);
+				buffer.dedent().write("}");
+			} else {
+				buffer.write(`export namespace ${key} {`).indent();
+				generateNamespaceTree(value, [...parents, key]);
+				buffer.dedent().write(`}`);
+			}
+		});
+	}
+	generateNamespaceTree(transformersList, []);
+	if (withSharedProps) {
+		importsBuffer.write(`import type InertiaMiddleware from '${inertiaMiddlewareImportPath}'`);
+		buffer.write("export type SharedProps = InferSharedProps<InertiaMiddleware>");
+	}
+	buffer.dedent().write("}");
+}
+//#endregion
+export { importTypeScript as n, outputTransformerDataObjects as r, importAssembler as t };

package/build/verification_token-WCrZtUgZ.js

@@ -0,0 +1,108 @@
+import string from "@poppinss/utils/string";
+import base64 from "@poppinss/utils/base64";
+import { Secret, safeEqual } from "@poppinss/utils";
+import { createHash } from "node:crypto";
+//#region src/helpers/verification_token.ts
+/**
+* Verification token class can be used to create tokens publicly
+* shareable tokens while storing the token hash within the database.
+*
+* This class is used by the Auth and the Persona packages to manage
+* tokens for authentication and authorization purposes.
+*
+* @example
+* class UserToken extends VerificationToken {
+*   constructor(user: User, secret: Secret<string>) {
+*     super()
+*     this.tokenableId = user.id
+*     this.computeValue(secret)
+*   }
+* }
+*/
+var VerificationToken = class {
+	/**
+	* Decodes a publicly shared token and return the series
+	* and the token value from it.
+	*
+	* Returns null when unable to decode the token because of
+	* invalid format or encoding.
+	*
+	* @param value - The token string to decode
+	*/
+	static decode(value) {
+		/**
+		* Ensure value is a string and starts with the prefix.
+		*/
+		if (typeof value !== "string") return null;
+		/**
+		* Remove prefix from the rest of the token.
+		*/
+		if (!value) return null;
+		const [identifier, ...tokenValue] = value.split(".");
+		if (!identifier || tokenValue.length === 0) return null;
+		const decodedIdentifier = base64.urlDecode(identifier);
+		const decodedSecret = base64.urlDecode(tokenValue.join("."));
+		if (!decodedIdentifier || !decodedSecret) return null;
+		return {
+			identifier: decodedIdentifier,
+			secret: new Secret(decodedSecret)
+		};
+	}
+	/**
+	* Creates a transient token that can be shared with the persistence
+	* layer.
+	*
+	* @param userId - The user ID for whom the token is being created
+	* @param size - The size of the random token seed
+	* @param expiresIn - Token expiration time (string like '2h' or number in seconds)
+	*/
+	static createTransientToken(userId, size, expiresIn) {
+		const expiresAt = /* @__PURE__ */ new Date();
+		expiresAt.setSeconds(expiresAt.getSeconds() + string.seconds.parse(expiresIn));
+		return {
+			userId,
+			expiresAt,
+			...this.seed(size)
+		};
+	}
+	/**
+	* Creates a secret opaque token and its hash.
+	*
+	* @param size - The length of the random token to generate
+	*/
+	static seed(size) {
+		const secret = new Secret(string.random(size));
+		return {
+			secret,
+			hash: createHash("sha256").update(secret.release()).digest("hex")
+		};
+	}
+	/**
+	* Compute the value property using the given secret. You can
+	* get secret via the static "createTransientToken" method.
+	*
+	* @param secret - The secret value to compute the public token value from
+	*/
+	computeValue(secret) {
+		this.value = new Secret(`${base64.urlEncode(String(this.identifier))}.${base64.urlEncode(secret.release())}`);
+	}
+	/**
+	* Check if the token has been expired. Verifies
+	* the "expiresAt" timestamp with the current
+	* date.
+	*/
+	isExpired() {
+		return this.expiresAt < /* @__PURE__ */ new Date();
+	}
+	/**
+	* Verifies the value of a token against the pre-defined hash
+	*
+	* @param secret - The secret to verify against the stored hash
+	*/
+	verify(secret) {
+		const newHash = createHash("sha256").update(secret.release()).digest("hex");
+		return safeEqual(this.hash, newHash);
+	}
+};
+//#endregion
+export { VerificationToken as t };

package/build/vine-DkIupA3Z.js

@@ -0,0 +1,97 @@
+import vine, { BaseLiteralType, symbols } from "@vinejs/vine";
+//#region src/vine.ts
+const MULTIPART_FILE = symbols.SUBTYPE ?? Symbol.for("subtype");
+/**
+* Checks if the value is an instance of multipart file from bodyparser.
+* Used internally for type guarding in file validation.
+*
+* @param file - The value to check for MultipartFile instance
+*/
+function isBodyParserFile(file) {
+	return !!(file && typeof file === "object" && "isMultipartFile" in file);
+}
+/**
+* VineJS validation rule that validates the file to be an instance of BodyParser
+* MultipartFile class and applies size/extension validation if configured.
+*
+* @param file - The file value to validate
+* @param options - Validation options for file size and extensions
+* @param field - The field context from VineJS validation
+*/
+const isMultipartFile = vine.createRule((file, options, field) => {
+	if (!field.isDefined) return false;
+	/**
+	* Report error when value is not a field multipart
+	* file object
+	*/
+	if (!isBodyParserFile(file)) {
+		field.report("The {{ field }} must be a file", "file", field);
+		return false;
+	}
+	const validationOptions = typeof options === "function" ? options(field) : options;
+	/**
+	* Set size when it's defined in the options and missing
+	* on the file instance
+	*/
+	if (file.sizeLimit === void 0 && validationOptions.size) file.sizeLimit = validationOptions.size;
+	/**
+	* Set extensions when it's defined in the options and missing
+	* on the file instance
+	*/
+	if (file.allowedExtensions === void 0 && validationOptions.extnames) file.allowedExtensions = validationOptions.extnames;
+	/**
+	* Validate file
+	*/
+	file.validate();
+	/**
+	* Report errors
+	*/
+	file.errors.forEach((error) => {
+		field.report(error.message, `file.${error.type}`, field, validationOptions);
+	});
+	return file.isValid;
+});
+/**
+* Represents a multipart file uploaded via multipart/form-data HTTP
+* request. This class extends VineJS's BaseLiteralType to provide
+* specialized validation for uploaded files.
+*
+* @example
+* const fileSchema = vine.object({
+*   avatar: vine.file({
+*     size: '2mb',
+*     extnames: ['jpg', 'png']
+*   })
+* })
+*/
+var VineMultipartFile = class VineMultipartFile extends BaseLiteralType {
+	/**
+	* Private validation options for file validation
+	*/
+	#validationOptions;
+	/**
+	* Symbol identifier for multipart file subtype
+	*/
+	[MULTIPART_FILE] = "multipartFile";
+	/**
+	* Creates a new VineMultipartFile instance
+	*
+	* @param validationOptions - File validation options like size limits and allowed extensions
+	* @param options - Field options from VineJS
+	* @param validations - Array of validation functions to apply
+	*/
+	constructor(validationOptions, options, validations) {
+		super(options, validations || []);
+		this.#validationOptions = validationOptions;
+		this.dataTypeValidator = isMultipartFile(validationOptions || {});
+	}
+	/**
+	* Creates a clone of the current VineMultipartFile instance
+	* with the same validation options and configurations
+	*/
+	clone() {
+		return new VineMultipartFile(this.#validationOptions, this.cloneOptions(), this.cloneValidations());
+	}
+};
+//#endregion
+export { VineMultipartFile as t };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@adonisjs/core",
   "description": "Core of AdonisJS",
-  "version": "7.0.1",
+  "version": "7.1.1",
   "engines": {
     "node": ">=24.0.0"
   },
@@ -82,7 +82,7 @@
     "index:commands": "node --import=@poppinss/ts-exec toolkit/main.js index build/commands"
   },
   "devDependencies": {
-    "@adonisjs/assembler": "^8.0.0",
+    "@adonisjs/assembler": "^8.0.1",
     "@adonisjs/eslint-config": "^3.0.0",
     "@adonisjs/prettier-config": "^1.4.5",
     "@adonisjs/tsconfig": "^2.0.0",
@@ -92,11 +92,11 @@
     "@japa/runner": "^5.3.0",
     "@japa/snapshot": "^2.0.10",
     "@poppinss/ts-exec": "^1.4.4",
-    "@release-it/conventional-changelog": "^10.0.5",
-    "@types/node": "~25.3.0",
+    "@release-it/conventional-changelog": "^10.0.6",
+    "@types/node": "~25.5.0",
     "@types/pretty-hrtime": "^1.0.3",
     "@types/sinon": "^21.0.0",
-    "@types/supertest": "^6.0.3",
+    "@types/supertest": "^7.2.0",
     "@types/test-console": "^2.0.3",
     "@vinejs/vine": "^4.3.0",
     "argon2": "^0.44.0",
@@ -106,17 +106,17 @@
     "cross-env": "^10.1.0",
     "del-cli": "^7.0.0",
     "edge.js": "^6.5.0",
-    "eslint": "^10.0.2",
+    "eslint": "^10.0.3",
     "execa": "^9.6.1",
     "get-port": "^7.1.0",
     "pino-pretty": "^13.1.3",
     "prettier": "^3.8.1",
     "release-it": "^19.2.4",
-    "sinon": "^21.0.1",
+    "sinon": "^21.0.3",
     "supertest": "^7.2.2",
     "test-console": "^2.0.0",
     "timekeeper": "^2.3.1",
-    "tsdown": "^0.20.3",
+    "tsdown": "^0.21.4",
     "typedoc": "^0.28.17",
     "typescript": "^5.9.3",
     "youch": "^4.1.0"
@@ -132,14 +132,14 @@
     "@adonisjs/hash": "^10.0.0",
     "@adonisjs/health": "^3.1.0",
     "@adonisjs/http-server": "^8.0.0",
-    "@adonisjs/http-transformers": "^2.3.0",
-    "@adonisjs/logger": "^7.1.0",
+    "@adonisjs/http-transformers": "^2.3.1",
+    "@adonisjs/logger": "^7.1.1",
     "@adonisjs/repl": "^5.0.0",
     "@boringnode/encryption": "^1.0.0",
     "@poppinss/colors": "^4.1.6",
     "@poppinss/dumper": "^0.7.0",
-    "@poppinss/macroable": "^1.1.0",
-    "@poppinss/utils": "^7.0.0",
+    "@poppinss/macroable": "^1.1.1",
+    "@poppinss/utils": "^7.0.1",
     "@sindresorhus/is": "^7.2.0",
     "@types/he": "^1.2.3",
     "error-stack-parser-es": "^1.0.5",

package/build/config_provider-FIAUgvae.js

@@ -1,13 +0,0 @@
-const configProvider = {
-	create(resolver) {
-		return {
-			type: "provider",
-			resolver
-		};
-	},
-	async resolve(app, provider) {
-		if (provider && typeof provider === "object" && "type" in provider) return provider.resolver(app);
-		return null;
-	}
-};
-export { configProvider as t };

package/build/create_kernel-BD0Iqi8e.js

@@ -1,3 +0,0 @@
-import "./main-MBAMnmJb.js";
-import { t as createAceKernel } from "./create_kernel-B7ILNhuP.js";
-export { createAceKernel };

package/build/debug-CGQmxzGt.js

@@ -1,3 +0,0 @@
-import { debuglog } from "node:util";
-var debug_default = debuglog("adonisjs:core");
-export { debug_default as t };