@adonisjs/core 7.5.2 → 7.6.0

package/build/modules/ace/codemods.d.ts

@@ -9,8 +9,9 @@ import { type GeneratedStub } from '../../types/app.ts';
  * This class provides APIs to modify configuration files, register middleware,
  * generate stubs, and install packages.
  *
- * The codemod APIs rely on the "@adonisjs/assembler" package, which must be
- * installed as a dependency in the user application.
+ * Some codemods, including installPackages, rely on the optional
+ * "@adonisjs/assembler" package. defineEnvVariables, makeUsingStub,
+ * addImportAlias, and createDirectory work without it.
  *
  * @example
  * ```ts
@@ -67,6 +68,26 @@ export declare class Codemods extends EventEmitter {
     defineEnvVariables<T extends Record<string, number | string | boolean>>(environmentVariables: T, options?: {
         omitFromExample?: Array<keyof T>;
     }): Promise<void>;
+    /**
+     * Add a subpath import to the application's package.json. Existing aliases
+     * are left unchanged, even when their target differs.
+     *
+     * @example
+     * ```ts
+     * await codemods.addImportAlias('#channels/*', './app/channels/*.js')
+     * ```
+     */
+    addImportAlias(alias: string, target: string): Promise<void>;
+    /**
+     * Create a directory relative to the application root, including missing parents.
+     * Leave an existing directory unchanged.
+     *
+     * @example
+     * ```ts
+     * await codemods.createDirectory('app/channels')
+     * ```
+     */
+    createDirectory(directory: string): Promise<void>;
     /**
      * Returns the TsMorph project instance for advanced AST manipulations.
      * See https://ts-morph.com/ for documentation.

package/build/modules/ace/codemods.js

@@ -1,7 +1,7 @@
 import { t as debug_default } from "../../debug-DrrWgeSu.js";
 import { t as stringHelpers } from "../../string-DUpLZV_t.js";
 import { isAbsolute } from "node:path";
-import { readFile } from "node:fs/promises";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
 import { EnvEditor } from "@adonisjs/env/editor";
 import { EventEmitter } from "node:events";
 //#region modules/ace/codemods.ts
@@ -10,8 +10,9 @@ import { EventEmitter } from "node:events";
 * This class provides APIs to modify configuration files, register middleware,
 * generate stubs, and install packages.
 *
-* The codemod APIs rely on the "@adonisjs/assembler" package, which must be
-* installed as a dependency in the user application.
+* Some codemods, including installPackages, rely on the optional
+* "@adonisjs/assembler" package. defineEnvVariables, makeUsingStub,
+* addImportAlias, and createDirectory work without it.
 *
 * @example
 * ```ts
@@ -124,6 +125,57 @@ var Codemods = class extends EventEmitter {
 		this.#cliLogger.action("update .env file").succeeded();
 	}
 	/**
+	* Add a subpath import to the application's package.json. Existing aliases
+	* are left unchanged, even when their target differs.
+	*
+	* @example
+	* ```ts
+	* await codemods.addImportAlias('#channels/*', './app/channels/*.js')
+	* ```
+	*/
+	async addImportAlias(alias, target) {
+		const action = this.#cliLogger.action("update package.json file");
+		try {
+			const path = this.#app.makePath("package.json");
+			const contents = await readFile(path, "utf-8");
+			const bom = contents.startsWith("") ? "" : "";
+			const packageJson = JSON.parse(contents.slice(bom.length));
+			packageJson.imports ??= {};
+			if (Object.hasOwn(packageJson.imports, alias)) {
+				action.skipped(`import alias "${alias}" already exists`);
+				return;
+			}
+			packageJson.imports[alias] = target;
+			const indent = contents.match(/^([ \t]+)"[^"\n]+"\s*:/m)?.[1] ?? (contents.includes("\n") ? "  " : "");
+			const newline = contents.includes("\r\n") ? "\r\n" : "\n";
+			const updated = JSON.stringify(packageJson, null, indent).replaceAll("\n", newline);
+			await writeFile(path, bom + updated + (contents.endsWith("\n") ? newline : ""));
+			action.succeeded();
+		} catch (error) {
+			this.emit("error", error);
+			action.failed(error.message);
+		}
+	}
+	/**
+	* Create a directory relative to the application root, including missing parents.
+	* Leave an existing directory unchanged.
+	*
+	* @example
+	* ```ts
+	* await codemods.createDirectory('app/channels')
+	* ```
+	*/
+	async createDirectory(directory) {
+		const action = this.#cliLogger.action(`create ${directory} directory`);
+		try {
+			if (await mkdir(this.#app.makePath(directory), { recursive: true })) action.succeeded();
+			else action.skipped("directory already exists");
+		} catch (error) {
+			this.emit("error", error);
+			action.failed(error.message);
+		}
+	}
+	/**
 	* Returns the TsMorph project instance for advanced AST manipulations.
 	* See https://ts-morph.com/ for documentation.
 	*

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@adonisjs/core",
   "description": "Core of AdonisJS",
-  "version": "7.5.2",
+  "version": "7.6.0",
   "engines": {
     "node": ">=24.0.0"
   },