@adonisjs/core 7.0.0-next.0 → 7.0.0-next.10

package/build/src/types.d.ts

@@ -372,4 +372,11 @@ export type IndexEntitiesConfig = {
         /** Glob patterns for matching event files */
         glob?: string[];
     };
+    transformers?: {
+        enabled?: boolean;
+        withSharedProps?: boolean;
+        source?: string;
+        importAlias?: string;
+        glob?: string[];
+    };
 };

package/build/src/utils.d.ts

@@ -1,5 +1,6 @@
 import type typescript from 'typescript';
 import type * as Assembler from '@adonisjs/assembler';
+import { type RecursiveFileTree } from '@adonisjs/assembler/types';
 import { type ApplicationService } from './types.ts';
 /**
  * Imports the AdonisJS assembler package optionally. This function attempts
@@ -32,3 +33,28 @@ export declare function importAssembler(app: ApplicationService): Promise<typeof
  * }
  */
 export declare function importTypeScript(app: ApplicationService): Promise<typeof typescript | undefined>;
+/**
+ * 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>
+ * //   }
+ * // }
+ */
+export declare function outputTransformerDataObjects(transformersList: RecursiveFileTree, buffer: Assembler.FileBuffer, withSharedProps: boolean): Promise<void>;

package/build/src/utils.js

@@ -47,3 +47,68 @@ export async function importTypeScript(app) {
     }
     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>
+ * //   }
+ * // }
+ */
+export async function outputTransformerDataObjects(transformersList, buffer, withSharedProps) {
+    const importsBuffer = buffer.create();
+    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 '#middleware/inertia_middleware'`);
+        buffer.write('export type SharedProps = InferSharedProps<InertiaMiddleware>');
+    }
+    buffer.dedent().write('}');
+}

package/build/src/vine.js

@@ -9,15 +9,21 @@
 import vine, { symbols, BaseLiteralType } from '@vinejs/vine';
 const MULTIPART_FILE = symbols.SUBTYPE ?? Symbol.for('subtype');
 /**
- * Checks if the value is an instance of multipart file
- * from bodyparser.
+ * 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.
+ * 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) => {
     /**
@@ -26,7 +32,7 @@ const isMultipartFile = vine.createRule((file, options, field) => {
      */
     if (!isBodyParserFile(file)) {
         field.report('The {{ field }} must be a file', 'file', field);
-        return;
+        return false;
     }
     const validationOptions = typeof options === 'function' ? options(field) : options;
     /**
@@ -53,6 +59,7 @@ const isMultipartFile = vine.createRule((file, options, field) => {
     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
@@ -84,8 +91,9 @@ export class VineMultipartFile extends BaseLiteralType {
      * @param validations - Array of validation functions to apply
      */
     constructor(validationOptions, options, validations) {
-        super(options, validations || [isMultipartFile(validationOptions || {})]);
+        super(options, validations || []);
         this.#validationOptions = validationOptions;
+        this.dataTypeValidator = isMultipartFile(validationOptions || {});
     }
     /**
      * Creates a clone of the current VineMultipartFile instance

package/build/stubs/make/transformer/main.stub

@@ -0,0 +1,18 @@
+{{#var transformerName = generators.transformerName(entity.name)}}
+{{#var transformerFileName = generators.transformerFileName(entity.name)}}
+{{#var modelName = generators.modelName(model.name)}}
+{{#var modelFileName = generators.modelFileName(model.name)}}
+{{#var modelImportPath = generators.importPath('#models', model.path, modelFileName.replace(/\.ts$/, ''))}}
+{{{
+  exports({
+    to: app.transformersPath(entity.path, transformerFileName)
+  })
+}}}
+import { BaseTransformer } from '@adonisjs/core/transformers'
+import {{ modelName }} from '{{ modelImportPath }}'
+
+export default class {{ transformerName }} extends BaseTransformer<{{modelName}}> {
+  toObject() {
+    return this.pick(this.resource, ['id'])
+  }
+}

package/build/types/common.d.ts

@@ -0,0 +1 @@
+export * from '@poppinss/utils/types';

package/build/types/common.js

@@ -0,0 +1,9 @@
+/*
+ * @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 '@poppinss/utils/types';

package/build/types/helpers.d.ts

@@ -1,2 +1,22 @@
+/**
+ * Helper types and utilities for AdonisJS applications.
+ * Re-exports commonly used type utilities and file system operation types.
+ *
+ * @example
+ * // Use Opaque type for branded primitives
+ * import type { Opaque } from '@adonisjs/core/types/helpers'
+ *
+ * type UserId = Opaque<'UserId', number>
+ * const userId: UserId = 123 as UserId
+ *
+ * @example
+ * // Use file system option types
+ * import type { ImportAllFilesOptions } from '@adonisjs/core/types/helpers'
+ *
+ * const options: ImportAllFilesOptions = {
+ *   ignoreMissingExports: true,
+ *   transformKeys: (key) => key.toLowerCase()
+ * }
+ */
 export type { Opaque, NormalizeConstructor } from '@poppinss/utils/types';
 export type { ImportAllFilesOptions, ReadAllFilesOptions } from '@poppinss/utils/fs';

package/build/types/http.d.ts

@@ -1,5 +1,6 @@
 export * from '@adonisjs/http-server/types';
 import type { ValidationOptions } from '@vinejs/vine/types';
+export type { InferRouteParams } from '@poppinss/utils/types';
 /**
  * Validation options accepted by the "request.validateUsing" method
  */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@adonisjs/core",
   "description": "Core of AdonisJS",
-  "version": "7.0.0-next.0",
+  "version": "7.0.0-next.10",
   "engines": {
     "node": ">=24.0.0"
   },
@@ -54,6 +54,7 @@
     "./env/editor": "./build/modules/env/editor.js",
     "./events": "./build/modules/events.js",
     "./http": "./build/modules/http/main.js",
+    "./http/url_builder_client": "./build/modules/http/url_builder_client.js",
     "./logger": "./build/modules/logger.js",
     "./repl": "./build/modules/repl.js",
     "./transformers": "./build/modules/transformers/main.js",
@@ -72,6 +73,7 @@
     "compile": "npm run clean && tsc",
     "postcompile": "npm run copy:templates && npm run index:commands",
     "build": "npm run compile",
+    "docs": "typedoc",
     "release": "npx release-it",
     "version": "npm run build",
     "prepublishOnly": "npm run build",
@@ -83,10 +85,10 @@
     "index:commands": "node --import=@poppinss/ts-exec toolkit/main.js index build/commands"
   },
   "devDependencies": {
-    "@adonisjs/assembler": "^8.0.0-next.7",
-    "@adonisjs/eslint-config": "^3.0.0-next.1",
+    "@adonisjs/assembler": "^8.0.0-next.16",
+    "@adonisjs/eslint-config": "^3.0.0-next.4",
     "@adonisjs/prettier-config": "^1.4.5",
-    "@adonisjs/tsconfig": "^2.0.0-next.0",
+    "@adonisjs/tsconfig": "^2.0.0-next.2",
     "@japa/assert": "^4.1.1",
     "@japa/expect-type": "^2.0.3",
     "@japa/file-system": "^2.3.2",
@@ -94,51 +96,52 @@
     "@japa/snapshot": "^2.0.9",
     "@poppinss/ts-exec": "^1.4.1",
     "@release-it/conventional-changelog": "^10.0.1",
-    "@types/node": "^24.3.1",
+    "@types/node": "^24.10.0",
     "@types/pretty-hrtime": "^1.0.3",
     "@types/sinon": "^17.0.4",
     "@types/supertest": "^6.0.3",
     "@types/test-console": "^2.0.3",
-    "@vinejs/vine": "^3.0.1",
+    "@vinejs/vine": "^4.1.0",
     "argon2": "^0.44.0",
     "bcrypt": "^6.0.0",
     "c8": "^10.1.3",
     "copyfiles": "^2.4.1",
-    "cross-env": "^10.0.0",
-    "del-cli": "^6.0.0",
+    "cross-env": "^10.1.0",
+    "del-cli": "^7.0.0",
     "edge.js": "^6.3.0",
-    "eslint": "^9.34.0",
+    "eslint": "^9.39.1",
     "execa": "^9.6.0",
     "get-port": "^7.1.0",
     "prettier": "^3.6.2",
-    "release-it": "^19.0.4",
+    "release-it": "^19.0.5",
     "sinon": "^21.0.0",
     "supertest": "^7.1.4",
     "test-console": "^2.0.0",
     "timekeeper": "^2.3.1",
-    "typescript": "^5.9.2",
+    "typedoc": "^0.28.14",
+    "typescript": "^5.9.3",
     "youch": "^4.1.0-beta.11"
   },
   "dependencies": {
-    "@adonisjs/ace": "^14.0.1-next.1",
-    "@adonisjs/application": "^9.0.0-next.5",
-    "@adonisjs/bodyparser": "^11.0.0-next.1",
+    "@adonisjs/ace": "^14.0.1-next.2",
+    "@adonisjs/application": "^9.0.0-next.10",
+    "@adonisjs/bodyparser": "^11.0.0-next.2",
     "@adonisjs/config": "^6.0.0-next.1",
     "@adonisjs/encryption": "^7.0.0-next.1",
     "@adonisjs/env": "^7.0.0-next.1",
     "@adonisjs/events": "^10.1.0-next.2",
-    "@adonisjs/fold": "^11.0.0-next.2",
+    "@adonisjs/fold": "^11.0.0-next.3",
     "@adonisjs/hash": "^10.0.0-next.1",
     "@adonisjs/health": "^3.0.0-next.0",
-    "@adonisjs/http-server": "^8.0.0-next.6",
-    "@adonisjs/http-transformers": "^1.1.0",
-    "@adonisjs/logger": "^7.1.0-next.0",
+    "@adonisjs/http-server": "^8.0.0-next.12",
+    "@adonisjs/http-transformers": "^1.5.0",
+    "@adonisjs/logger": "^7.1.0-next.2",
     "@adonisjs/repl": "^5.0.0-next.0",
     "@poppinss/colors": "^4.1.5",
-    "@poppinss/dumper": "^0.6.4",
-    "@poppinss/macroable": "^1.0.5",
+    "@poppinss/dumper": "^0.6.5",
+    "@poppinss/macroable": "^1.1.0",
     "@poppinss/utils": "^7.0.0-next.3",
-    "@sindresorhus/is": "^7.0.2",
+    "@sindresorhus/is": "^7.1.1",
     "@types/he": "^1.2.3",
     "error-stack-parser-es": "^1.0.5",
     "he": "^1.2.0",
@@ -146,8 +149,8 @@
     "string-width": "^8.1.0"
   },
   "peerDependencies": {
-    "@adonisjs/assembler": "^8.0.0-next.6",
-    "@vinejs/vine": "^3.0.0",
+    "@adonisjs/assembler": "^8.0.0-next.10",
+    "@vinejs/vine": "^4.0.0-next.0",
     "argon2": "^0.43.0",
     "bcrypt": "^6.0.0",
     "edge.js": "^6.2.0",