@adonisjs/assembler 6.1.3-9 → 7.0.0-1

package/build/src/code_transformer/main.js

@@ -0,0 +1,478 @@
+// src/code_transformer/main.ts
+import { join } from "node:path";
+import { fileURLToPath as fileURLToPath2 } from "node:url";
+import { installPackage, detectPackageManager } from "@antfu/install-pkg";
+import {
+  Node as Node2,
+  Project as Project2,
+  QuoteKind,
+  SyntaxKind as SyntaxKind2
+} from "ts-morph";
+
+// src/code_transformer/rc_file_transformer.ts
+import { fileURLToPath } from "node:url";
+import {
+  Node,
+  SyntaxKind
+} from "ts-morph";
+var RcFileTransformer = class {
+  #cwd;
+  #project;
+  /**
+   * Settings to use when persisting files
+   */
+  #editorSettings = {
+    indentSize: 2,
+    convertTabsToSpaces: true,
+    trimTrailingWhitespace: true,
+    ensureNewLineAtEndOfFile: true,
+    indentStyle: 2,
+    // @ts-expect-error SemicolonPreference doesn't seem to be re-exported from ts-morph
+    semicolons: "remove"
+  };
+  constructor(cwd, project) {
+    this.#cwd = cwd;
+    this.#project = project;
+  }
+  /**
+   * Get the `adonisrc.ts` source file
+   */
+  #getRcFileOrThrow() {
+    const kernelUrl = fileURLToPath(new URL("./adonisrc.ts", this.#cwd));
+    return this.#project.getSourceFileOrThrow(kernelUrl);
+  }
+  /**
+   * Check if environments array has a subset of available environments
+   */
+  #isInSpecificEnvironment(environments) {
+    if (!environments) {
+      return false;
+    }
+    return !!["web", "console", "test", "repl"].find(
+      (env) => !environments.includes(env)
+    );
+  }
+  /**
+   * Locate the `defineConfig` call inside the `adonisrc.ts` file
+   */
+  #locateDefineConfigCallOrThrow(file) {
+    const call = file.getDescendantsOfKind(SyntaxKind.CallExpression).find((statement) => statement.getExpression().getText() === "defineConfig");
+    if (!call) {
+      throw new Error("Could not locate the defineConfig call.");
+    }
+    return call;
+  }
+  /**
+   * Return the ObjectLiteralExpression of the defineConfig call
+   */
+  #getDefineConfigObjectOrThrow(defineConfigCall) {
+    const configObject = defineConfigCall.getArguments()[0].asKindOrThrow(SyntaxKind.ObjectLiteralExpression);
+    return configObject;
+  }
+  /**
+   * Check if the defineConfig() call has the property assignment
+   * inside it or not. If not, it will create one and return it.
+   */
+  #getPropertyAssignmentInDefineConfigCall(propertyName, initializer) {
+    const file = this.#getRcFileOrThrow();
+    const defineConfigCall = this.#locateDefineConfigCallOrThrow(file);
+    const configObject = this.#getDefineConfigObjectOrThrow(defineConfigCall);
+    let property = configObject.getProperty(propertyName);
+    if (!property) {
+      configObject.addPropertyAssignment({ name: propertyName, initializer });
+      property = configObject.getProperty(propertyName);
+    }
+    return property;
+  }
+  /**
+   * Extract list of imported modules from an ArrayLiteralExpression
+   *
+   * It assumes that the array can have two types of elements:
+   *
+   * - Simple lazy imported modules: [() => import('path/to/file')]
+   * - Or an object entry: [{ file: () => import('path/to/file'), environment: ['web', 'console'] }]
+   *   where the `file` property is a lazy imported module.
+   */
+  #extractModulesFromArray(array) {
+    const modules = array.getElements().map((element) => {
+      if (Node.isArrowFunction(element)) {
+        const importExp = element.getFirstDescendantByKindOrThrow(SyntaxKind.CallExpression);
+        const literal = importExp.getFirstDescendantByKindOrThrow(SyntaxKind.StringLiteral);
+        return literal.getLiteralValue();
+      }
+      if (Node.isObjectLiteralExpression(element)) {
+        const fileProp = element.getPropertyOrThrow("file");
+        const arrowFn = fileProp.getFirstDescendantByKindOrThrow(SyntaxKind.ArrowFunction);
+        const importExp = arrowFn.getFirstDescendantByKindOrThrow(SyntaxKind.CallExpression);
+        const literal = importExp.getFirstDescendantByKindOrThrow(SyntaxKind.StringLiteral);
+        return literal.getLiteralValue();
+      }
+    });
+    return modules.filter(Boolean);
+  }
+  /**
+   * Extract a specific property from an ArrayLiteralExpression
+   * that contains object entries.
+   *
+   * This function is mainly used for extractring the `pattern` property
+   * when adding a new meta files entry, or the `name` property when
+   * adding a new test suite.
+   */
+  #extractPropertyFromArray(array, propertyName) {
+    const property = array.getElements().map((el) => {
+      if (!Node.isObjectLiteralExpression(el))
+        return;
+      const nameProp = el.getPropertyOrThrow(propertyName);
+      if (!Node.isPropertyAssignment(nameProp))
+        return;
+      const name = nameProp.getInitializerIfKindOrThrow(SyntaxKind.StringLiteral);
+      return name.getLiteralValue();
+    });
+    return property.filter(Boolean);
+  }
+  /**
+   * Build a new module entry for the preloads and providers array
+   * based upon the environments specified
+   */
+  #buildNewModuleEntry(modulePath, environments) {
+    if (!this.#isInSpecificEnvironment(environments)) {
+      return `() => import('${modulePath}')`;
+    }
+    return `{
+      file: () => import('${modulePath}'),
+      environment: [${environments?.map((env) => `'${env}'`).join(", ")}],
+    }`;
+  }
+  /**
+   * Add a new command to the rcFile
+   */
+  addCommand(commandPath) {
+    const commandsProperty = this.#getPropertyAssignmentInDefineConfigCall("commands", "[]");
+    const commandsArray = commandsProperty.getInitializerIfKindOrThrow(
+      SyntaxKind.ArrayLiteralExpression
+    );
+    const commandString = `() => import('${commandPath}')`;
+    if (commandsArray.getElements().some((el) => el.getText() === commandString)) {
+      return this;
+    }
+    commandsArray.addElement(commandString);
+    return this;
+  }
+  /**
+   * Add a new preloaded file to the rcFile
+   */
+  addPreloadFile(modulePath, environments) {
+    const preloadsProperty = this.#getPropertyAssignmentInDefineConfigCall("preloads", "[]");
+    const preloadsArray = preloadsProperty.getInitializerIfKindOrThrow(
+      SyntaxKind.ArrayLiteralExpression
+    );
+    const existingPreloadedFiles = this.#extractModulesFromArray(preloadsArray);
+    const isDuplicate = existingPreloadedFiles.includes(modulePath);
+    if (isDuplicate) {
+      return this;
+    }
+    preloadsArray.addElement(this.#buildNewModuleEntry(modulePath, environments));
+    return this;
+  }
+  /**
+   * Add a new provider to the rcFile
+   */
+  addProvider(providerPath, environments) {
+    const property = this.#getPropertyAssignmentInDefineConfigCall("providers", "[]");
+    const providersArray = property.getInitializerIfKindOrThrow(SyntaxKind.ArrayLiteralExpression);
+    const existingProviderPaths = this.#extractModulesFromArray(providersArray);
+    const isDuplicate = existingProviderPaths.includes(providerPath);
+    if (isDuplicate) {
+      return this;
+    }
+    providersArray.addElement(this.#buildNewModuleEntry(providerPath, environments));
+    return this;
+  }
+  /**
+   * Add a new meta file to the rcFile
+   */
+  addMetaFile(globPattern, reloadServer = false) {
+    const property = this.#getPropertyAssignmentInDefineConfigCall("metaFiles", "[]");
+    const metaFilesArray = property.getInitializerIfKindOrThrow(SyntaxKind.ArrayLiteralExpression);
+    const alreadyDefinedPatterns = this.#extractPropertyFromArray(metaFilesArray, "pattern");
+    if (alreadyDefinedPatterns.includes(globPattern)) {
+      return this;
+    }
+    metaFilesArray.addElement(
+      `{
+        pattern: '${globPattern}',
+        reloadServer: ${reloadServer},
+      }`
+    );
+    return this;
+  }
+  /**
+   * Set directory name and path
+   */
+  setDirectory(key, value) {
+    const property = this.#getPropertyAssignmentInDefineConfigCall("directories", "{}");
+    const directories = property.getInitializerIfKindOrThrow(SyntaxKind.ObjectLiteralExpression);
+    directories.addPropertyAssignment({ name: key, initializer: `'${value}'` });
+    return this;
+  }
+  /**
+   * Set command alias
+   */
+  setCommandAlias(alias, command) {
+    const aliasProperty = this.#getPropertyAssignmentInDefineConfigCall("commandsAliases", "{}");
+    const aliases = aliasProperty.getInitializerIfKindOrThrow(SyntaxKind.ObjectLiteralExpression);
+    aliases.addPropertyAssignment({ name: alias, initializer: `'${command}'` });
+    return this;
+  }
+  /**
+   * Add a new test suite to the rcFile
+   */
+  addSuite(suiteName, files, timeout) {
+    const testProperty = this.#getPropertyAssignmentInDefineConfigCall(
+      "tests",
+      `{ suites: [], forceExit: true, timeout: 2000 }`
+    );
+    const property = testProperty.getInitializerIfKindOrThrow(SyntaxKind.ObjectLiteralExpression).getPropertyOrThrow("suites");
+    const suitesArray = property.getInitializerIfKindOrThrow(SyntaxKind.ArrayLiteralExpression);
+    const existingSuitesNames = this.#extractPropertyFromArray(suitesArray, "name");
+    if (existingSuitesNames.includes(suiteName)) {
+      return this;
+    }
+    const filesArray = Array.isArray(files) ? files : [files];
+    suitesArray.addElement(
+      `{
+        name: '${suiteName}',
+        files: [${filesArray.map((file) => `'${file}'`).join(", ")}],
+        timeout: ${timeout ?? 2e3},
+      }`
+    );
+    return this;
+  }
+  /**
+   * Save the adonisrc.ts file
+   */
+  save() {
+    const file = this.#getRcFileOrThrow();
+    file.formatText(this.#editorSettings);
+    return file.save();
+  }
+};
+
+// src/code_transformer/main.ts
+var CodeTransformer = class {
+  /**
+   * Exporting utilities to install package and detect
+   * the package manager
+   */
+  installPackage = installPackage;
+  detectPackageManager = detectPackageManager;
+  /**
+   * Directory of the adonisjs project
+   */
+  #cwd;
+  /**
+   * The TsMorph project
+   */
+  #project;
+  /**
+   * Settings to use when persisting files
+   */
+  #editorSettings = {
+    indentSize: 2,
+    convertTabsToSpaces: true,
+    trimTrailingWhitespace: true,
+    ensureNewLineAtEndOfFile: true,
+    indentStyle: 2,
+    // @ts-expect-error SemicolonPreference doesn't seem to be re-exported from ts-morph
+    semicolons: "remove"
+  };
+  constructor(cwd) {
+    this.#cwd = cwd;
+    this.#project = new Project2({
+      tsConfigFilePath: join(fileURLToPath2(this.#cwd), "tsconfig.json"),
+      manipulationSettings: { quoteKind: QuoteKind.Single }
+    });
+  }
+  /**
+   * Add a new middleware to the middleware array of the
+   * given file
+   */
+  #addToMiddlewareArray(file, target, middlewareEntry) {
+    const callExpressions = file.getDescendantsOfKind(SyntaxKind2.CallExpression).filter((statement) => statement.getExpression().getText() === target);
+    if (!callExpressions.length) {
+      throw new Error(`Cannot find ${target} statement in the file.`);
+    }
+    const arrayLiteralExpression = callExpressions[0].getArguments()[0];
+    if (!arrayLiteralExpression || !Node2.isArrayLiteralExpression(arrayLiteralExpression)) {
+      throw new Error(`Cannot find middleware array in ${target} statement.`);
+    }
+    const middleware = `() => import('${middlewareEntry.path}')`;
+    const existingMiddlewareIndex = arrayLiteralExpression.getElements().findIndex((element) => element.getText() === middleware);
+    if (existingMiddlewareIndex === -1) {
+      if (middlewareEntry.position === "before") {
+        arrayLiteralExpression.insertElement(0, middleware);
+      } else {
+        arrayLiteralExpression.addElement(middleware);
+      }
+    }
+  }
+  /**
+   * Add a new middleware to the named middleware of the given file
+   */
+  #addToNamedMiddleware(file, middlewareEntry) {
+    if (!middlewareEntry.name) {
+      throw new Error("Named middleware requires a name.");
+    }
+    const callArguments = file.getVariableDeclarationOrThrow("middleware").getInitializerIfKindOrThrow(SyntaxKind2.CallExpression).getArguments();
+    if (callArguments.length === 0) {
+      throw new Error("Named middleware call has no arguments.");
+    }
+    const namedMiddlewareObject = callArguments[0];
+    if (!Node2.isObjectLiteralExpression(namedMiddlewareObject)) {
+      throw new Error("The argument of the named middleware call is not an object literal.");
+    }
+    const existingProperty = namedMiddlewareObject.getProperty(middlewareEntry.name);
+    if (!existingProperty) {
+      const middleware = `${middlewareEntry.name}: () => import('${middlewareEntry.path}')`;
+      namedMiddlewareObject.insertProperty(0, middleware);
+    }
+  }
+  /**
+   * Add a policy to the list of pre-registered policy
+   */
+  #addToPoliciesList(file, policyEntry) {
+    const policiesObject = file.getVariableDeclarationOrThrow("policies").getInitializerIfKindOrThrow(SyntaxKind2.ObjectLiteralExpression);
+    const existingProperty = policiesObject.getProperty(policyEntry.name);
+    if (!existingProperty) {
+      const policy = `${policyEntry.name}: () => import('${policyEntry.path}')`;
+      policiesObject.insertProperty(0, policy);
+    }
+  }
+  /**
+   * Write a leading comment
+   */
+  #addLeadingComment(writer, comment) {
+    if (!comment) {
+      return writer.blankLine();
+    }
+    return writer.blankLine().writeLine("/*").writeLine(`|----------------------------------------------------------`).writeLine(`| ${comment}`).writeLine(`|----------------------------------------------------------`).writeLine(`*/`);
+  }
+  /**
+   * Add new env variable validation in the
+   * `env.ts` file
+   */
+  async defineEnvValidations(definition) {
+    const kernelUrl = fileURLToPath2(new URL("./start/env.ts", this.#cwd));
+    const file = this.#project.getSourceFileOrThrow(kernelUrl);
+    const callExpressions = file.getDescendantsOfKind(SyntaxKind2.CallExpression).filter((statement) => statement.getExpression().getText() === "Env.create");
+    if (!callExpressions.length) {
+      throw new Error(`Cannot find Env.create statement in the file.`);
+    }
+    const objectLiteralExpression = callExpressions[0].getArguments()[1];
+    if (!Node2.isObjectLiteralExpression(objectLiteralExpression)) {
+      throw new Error(`The second argument of Env.create is not an object literal.`);
+    }
+    let shouldAddComment = true;
+    for (const [variable, validation] of Object.entries(definition.variables)) {
+      const existingProperty = objectLiteralExpression.getProperty(variable);
+      if (existingProperty) {
+        shouldAddComment = false;
+      }
+      if (!existingProperty) {
+        objectLiteralExpression.addPropertyAssignment({
+          name: variable,
+          initializer: validation,
+          leadingTrivia: (writer) => {
+            if (!shouldAddComment) {
+              return;
+            }
+            shouldAddComment = false;
+            return this.#addLeadingComment(writer, definition.leadingComment);
+          }
+        });
+      }
+    }
+    file.formatText(this.#editorSettings);
+    await file.save();
+  }
+  /**
+   * Define new middlewares inside the `start/kernel.ts`
+   * file
+   *
+   * This function is highly based on some assumptions
+   * and will not work if you significantly tweaked
+   * your `start/kernel.ts` file.
+   */
+  async addMiddlewareToStack(stack, middleware) {
+    const kernelUrl = fileURLToPath2(new URL("./start/kernel.ts", this.#cwd));
+    const file = this.#project.getSourceFileOrThrow(kernelUrl);
+    for (const middlewareEntry of middleware) {
+      if (stack === "named") {
+        this.#addToNamedMiddleware(file, middlewareEntry);
+      } else {
+        this.#addToMiddlewareArray(file, `${stack}.use`, middlewareEntry);
+      }
+    }
+    file.formatText(this.#editorSettings);
+    await file.save();
+  }
+  /**
+   * Update the `adonisrc.ts` file
+   */
+  async updateRcFile(callback) {
+    const rcFileTransformer = new RcFileTransformer(this.#cwd, this.#project);
+    callback(rcFileTransformer);
+    await rcFileTransformer.save();
+  }
+  /**
+   * Add a new Japa plugin in the `tests/bootstrap.ts` file
+   */
+  async addJapaPlugin(pluginCall, importDeclarations) {
+    const testBootstrapUrl = fileURLToPath2(new URL("./tests/bootstrap.ts", this.#cwd));
+    const file = this.#project.getSourceFileOrThrow(testBootstrapUrl);
+    const existingImports = file.getImportDeclarations();
+    importDeclarations.forEach((importDeclaration) => {
+      const existingImport = existingImports.find(
+        (mod) => mod.getModuleSpecifierValue() === importDeclaration.module
+      );
+      if (existingImport && importDeclaration.isNamed) {
+        if (!existingImport.getNamedImports().find((namedImport) => namedImport.getName() === importDeclaration.identifier)) {
+          existingImport.addNamedImport(importDeclaration.identifier);
+        }
+        return;
+      }
+      if (existingImport) {
+        return;
+      }
+      file.addImportDeclaration({
+        ...importDeclaration.isNamed ? { namedImports: [importDeclaration.identifier] } : { defaultImport: importDeclaration.identifier },
+        moduleSpecifier: importDeclaration.module
+      });
+    });
+    const pluginsArray = file.getVariableDeclaration("plugins")?.getInitializerIfKind(SyntaxKind2.ArrayLiteralExpression);
+    if (pluginsArray) {
+      if (!pluginsArray.getElements().find((element) => element.getText() === pluginCall)) {
+        pluginsArray.addElement(pluginCall);
+      }
+    }
+    file.formatText(this.#editorSettings);
+    await file.save();
+  }
+  /**
+   * Adds a policy to the list of `policies` object configured
+   * inside the `app/policies/main.ts` file.
+   */
+  async addPolicies(policies) {
+    const kernelUrl = fileURLToPath2(new URL("./app/policies/main.ts", this.#cwd));
+    const file = this.#project.getSourceFileOrThrow(kernelUrl);
+    for (const policy of policies) {
+      this.#addToPoliciesList(file, policy);
+    }
+    file.formatText(this.#editorSettings);
+    await file.save();
+  }
+};
+export {
+  CodeTransformer
+};
+//# sourceMappingURL=main.js.map

package/build/src/code_transformer/main.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/code_transformer/main.ts","../../../src/code_transformer/rc_file_transformer.ts"],"sourcesContent":["/*\n * @adonisjs/assembler\n *\n * (c) AdonisJS\n *\n * For the full copyright and license information, please view the LICENSE\n * file that was distributed with this source code.\n */\n\nimport { join } from 'node:path'\nimport { fileURLToPath } from 'node:url'\nimport { installPackage, detectPackageManager } from '@antfu/install-pkg'\nimport {\n  Node,\n  Project,\n  QuoteKind,\n  SourceFile,\n  SyntaxKind,\n  CodeBlockWriter,\n  FormatCodeSettings,\n} from 'ts-morph'\n\nimport { RcFileTransformer } from './rc_file_transformer.js'\nimport type { MiddlewareNode, EnvValidationNode, BouncerPolicyNode } from '../types.js'\n\n/**\n * This class is responsible for updating\n */\nexport class CodeTransformer {\n  /**\n   * Exporting utilities to install package and detect\n   * the package manager\n   */\n  installPackage = installPackage\n  detectPackageManager = detectPackageManager\n\n  /**\n   * Directory of the adonisjs project\n   */\n  #cwd: URL\n\n  /**\n   * The TsMorph project\n   */\n  #project: Project\n\n  /**\n   * Settings to use when persisting files\n   */\n  #editorSettings: FormatCodeSettings = {\n    indentSize: 2,\n    convertTabsToSpaces: true,\n    trimTrailingWhitespace: true,\n    ensureNewLineAtEndOfFile: true,\n    indentStyle: 2,\n    // @ts-expect-error SemicolonPreference doesn't seem to be re-exported from ts-morph\n    semicolons: 'remove',\n  }\n\n  constructor(cwd: URL) {\n    this.#cwd = cwd\n    this.#project = new Project({\n      tsConfigFilePath: join(fileURLToPath(this.#cwd), 'tsconfig.json'),\n      manipulationSettings: { quoteKind: QuoteKind.Single },\n    })\n  }\n\n  /**\n   * Add a new middleware to the middleware array of the\n   * given file\n   */\n  #addToMiddlewareArray(file: SourceFile, target: string, middlewareEntry: MiddlewareNode) {\n    const callExpressions = file\n      .getDescendantsOfKind(SyntaxKind.CallExpression)\n      .filter((statement) => statement.getExpression().getText() === target)\n\n    if (!callExpressions.length) {\n      throw new Error(`Cannot find ${target} statement in the file.`)\n    }\n\n    const arrayLiteralExpression = callExpressions[0].getArguments()[0]\n    if (!arrayLiteralExpression || !Node.isArrayLiteralExpression(arrayLiteralExpression)) {\n      throw new Error(`Cannot find middleware array in ${target} statement.`)\n    }\n\n    const middleware = `() => import('${middlewareEntry.path}')`\n\n    /**\n     * Delete the existing middleware if it exists\n     */\n    const existingMiddlewareIndex = arrayLiteralExpression\n      .getElements()\n      .findIndex((element) => element.getText() === middleware)\n\n    if (existingMiddlewareIndex === -1) {\n      /**\n       * Add the middleware to the top or bottom of the array\n       */\n      if (middlewareEntry.position === 'before') {\n        arrayLiteralExpression.insertElement(0, middleware)\n      } else {\n        arrayLiteralExpression.addElement(middleware)\n      }\n    }\n  }\n\n  /**\n   * Add a new middleware to the named middleware of the given file\n   */\n  #addToNamedMiddleware(file: SourceFile, middlewareEntry: MiddlewareNode) {\n    if (!middlewareEntry.name) {\n      throw new Error('Named middleware requires a name.')\n    }\n\n    const callArguments = file\n      .getVariableDeclarationOrThrow('middleware')\n      .getInitializerIfKindOrThrow(SyntaxKind.CallExpression)\n      .getArguments()\n\n    if (callArguments.length === 0) {\n      throw new Error('Named middleware call has no arguments.')\n    }\n\n    const namedMiddlewareObject = callArguments[0]\n    if (!Node.isObjectLiteralExpression(namedMiddlewareObject)) {\n      throw new Error('The argument of the named middleware call is not an object literal.')\n    }\n\n    /**\n     * Check if property is already defined. If so, remove it\n     */\n    const existingProperty = namedMiddlewareObject.getProperty(middlewareEntry.name)\n    if (!existingProperty) {\n      /**\n       * Add the named middleware\n       */\n      const middleware = `${middlewareEntry.name}: () => import('${middlewareEntry.path}')`\n      namedMiddlewareObject!.insertProperty(0, middleware)\n    }\n  }\n\n  /**\n   * Add a policy to the list of pre-registered policy\n   */\n  #addToPoliciesList(file: SourceFile, policyEntry: BouncerPolicyNode) {\n    const policiesObject = file\n      .getVariableDeclarationOrThrow('policies')\n      .getInitializerIfKindOrThrow(SyntaxKind.ObjectLiteralExpression)\n\n    /**\n     * Only define policy when one with the existing name does not\n     * exist.\n     */\n    const existingProperty = policiesObject.getProperty(policyEntry.name)\n    if (!existingProperty) {\n      const policy = `${policyEntry.name}: () => import('${policyEntry.path}')`\n      policiesObject!.insertProperty(0, policy)\n    }\n  }\n\n  /**\n   * Write a leading comment\n   */\n  #addLeadingComment(writer: CodeBlockWriter, comment?: string) {\n    if (!comment) {\n      return writer.blankLine()\n    }\n\n    return writer\n      .blankLine()\n      .writeLine('/*')\n      .writeLine(`|----------------------------------------------------------`)\n      .writeLine(`| ${comment}`)\n      .writeLine(`|----------------------------------------------------------`)\n      .writeLine(`*/`)\n  }\n\n  /**\n   * Add new env variable validation in the\n   * `env.ts` file\n   */\n  async defineEnvValidations(definition: EnvValidationNode) {\n    /**\n     * Get the `start/env.ts` source file\n     */\n    const kernelUrl = fileURLToPath(new URL('./start/env.ts', this.#cwd))\n    const file = this.#project.getSourceFileOrThrow(kernelUrl)\n\n    /**\n     * Get the `Env.create` call expression\n     */\n    const callExpressions = file\n      .getDescendantsOfKind(SyntaxKind.CallExpression)\n      .filter((statement) => statement.getExpression().getText() === 'Env.create')\n\n    if (!callExpressions.length) {\n      throw new Error(`Cannot find Env.create statement in the file.`)\n    }\n\n    const objectLiteralExpression = callExpressions[0].getArguments()[1]\n    if (!Node.isObjectLiteralExpression(objectLiteralExpression)) {\n      throw new Error(`The second argument of Env.create is not an object literal.`)\n    }\n\n    let shouldAddComment = true\n\n    /**\n     * Add each variable validation\n     */\n    for (const [variable, validation] of Object.entries(definition.variables)) {\n      /**\n       * Check if the variable is already defined. If so, remove it\n       */\n      const existingProperty = objectLiteralExpression.getProperty(variable)\n\n      /**\n       * Do not add leading comment if one or more properties\n       * already exists\n       */\n      if (existingProperty) {\n        shouldAddComment = false\n      }\n\n      /**\n       * Add property only when the property does not exist\n       */\n      if (!existingProperty) {\n        objectLiteralExpression.addPropertyAssignment({\n          name: variable,\n          initializer: validation,\n          leadingTrivia: (writer) => {\n            if (!shouldAddComment) {\n              return\n            }\n\n            shouldAddComment = false\n            return this.#addLeadingComment(writer, definition.leadingComment)\n          },\n        })\n      }\n    }\n\n    file.formatText(this.#editorSettings)\n    await file.save()\n  }\n\n  /**\n   * Define new middlewares inside the `start/kernel.ts`\n   * file\n   *\n   * This function is highly based on some assumptions\n   * and will not work if you significantly tweaked\n   * your `start/kernel.ts` file.\n   */\n  async addMiddlewareToStack(stack: 'server' | 'router' | 'named', middleware: MiddlewareNode[]) {\n    /**\n     * Get the `start/kernel.ts` source file\n     */\n    const kernelUrl = fileURLToPath(new URL('./start/kernel.ts', this.#cwd))\n    const file = this.#project.getSourceFileOrThrow(kernelUrl)\n\n    /**\n     * Process each middleware entry\n     */\n    for (const middlewareEntry of middleware) {\n      if (stack === 'named') {\n        this.#addToNamedMiddleware(file, middlewareEntry)\n      } else {\n        this.#addToMiddlewareArray(file!, `${stack}.use`, middlewareEntry)\n      }\n    }\n\n    file.formatText(this.#editorSettings)\n    await file.save()\n  }\n\n  /**\n   * Update the `adonisrc.ts` file\n   */\n  async updateRcFile(callback: (transformer: RcFileTransformer) => void) {\n    const rcFileTransformer = new RcFileTransformer(this.#cwd, this.#project)\n    callback(rcFileTransformer)\n    await rcFileTransformer.save()\n  }\n\n  /**\n   * Add a new Japa plugin in the `tests/bootstrap.ts` file\n   */\n  async addJapaPlugin(\n    pluginCall: string,\n    importDeclarations: { isNamed: boolean; module: string; identifier: string }[]\n  ) {\n    /**\n     * Get the `tests/bootstrap.ts` source file\n     */\n    const testBootstrapUrl = fileURLToPath(new URL('./tests/bootstrap.ts', this.#cwd))\n    const file = this.#project.getSourceFileOrThrow(testBootstrapUrl)\n\n    /**\n     * Add the import declaration\n     */\n    const existingImports = file.getImportDeclarations()\n\n    importDeclarations.forEach((importDeclaration) => {\n      const existingImport = existingImports.find(\n        (mod) => mod.getModuleSpecifierValue() === importDeclaration.module\n      )\n\n      /**\n       * Add a new named import to existing import for the\n       * same module\n       */\n      if (existingImport && importDeclaration.isNamed) {\n        if (\n          !existingImport\n            .getNamedImports()\n            .find((namedImport) => namedImport.getName() === importDeclaration.identifier)\n        ) {\n          existingImport.addNamedImport(importDeclaration.identifier)\n        }\n        return\n      }\n\n      /**\n       * Ignore default import when the same module is already imported.\n       * The chances are the existing default import and the importDeclaration\n       * identifiers are not the same. But we should not modify existing source\n       */\n      if (existingImport) {\n        return\n      }\n\n      file.addImportDeclaration({\n        ...(importDeclaration.isNamed\n          ? { namedImports: [importDeclaration.identifier] }\n          : { defaultImport: importDeclaration.identifier }),\n        moduleSpecifier: importDeclaration.module,\n      })\n    })\n\n    /**\n     * Insert the plugin call in the `plugins` array\n     */\n    const pluginsArray = file\n      .getVariableDeclaration('plugins')\n      ?.getInitializerIfKind(SyntaxKind.ArrayLiteralExpression)\n\n    /**\n     * Add plugin call to the plugins array\n     */\n    if (pluginsArray) {\n      if (!pluginsArray.getElements().find((element) => element.getText() === pluginCall)) {\n        pluginsArray.addElement(pluginCall)\n      }\n    }\n\n    file.formatText(this.#editorSettings)\n    await file.save()\n  }\n\n  /**\n   * Adds a policy to the list of `policies` object configured\n   * inside the `app/policies/main.ts` file.\n   */\n  async addPolicies(policies: BouncerPolicyNode[]) {\n    /**\n     * Get the `app/policies/main.ts` source file\n     */\n    const kernelUrl = fileURLToPath(new URL('./app/policies/main.ts', this.#cwd))\n    const file = this.#project.getSourceFileOrThrow(kernelUrl)\n\n    /**\n     * Process each middleware entry\n     */\n    for (const policy of policies) {\n      this.#addToPoliciesList(file, policy)\n    }\n\n    file.formatText(this.#editorSettings)\n    await file.save()\n  }\n}\n","/*\n * @adonisjs/assembler\n *\n * (c) AdonisJS\n *\n * For the full copyright and license information, please view the LICENSE\n * file that was distributed with this source code.\n */\n\nimport { fileURLToPath } from 'node:url'\nimport type { AppEnvironments } from '@adonisjs/application/types'\nimport {\n  Node,\n  Project,\n  SourceFile,\n  SyntaxKind,\n  CallExpression,\n  PropertyAssignment,\n  FormatCodeSettings,\n  ArrayLiteralExpression,\n} from 'ts-morph'\n\n/**\n * RcFileTransformer is used to transform the `adonisrc.ts` file\n * for adding new commands, providers, meta files etc\n */\nexport class RcFileTransformer {\n  #cwd: URL\n  #project: Project\n\n  /**\n   * Settings to use when persisting files\n   */\n  #editorSettings: FormatCodeSettings = {\n    indentSize: 2,\n    convertTabsToSpaces: true,\n    trimTrailingWhitespace: true,\n    ensureNewLineAtEndOfFile: true,\n    indentStyle: 2,\n    // @ts-expect-error SemicolonPreference doesn't seem to be re-exported from ts-morph\n    semicolons: 'remove',\n  }\n\n  constructor(cwd: URL, project: Project) {\n    this.#cwd = cwd\n    this.#project = project\n  }\n\n  /**\n   * Get the `adonisrc.ts` source file\n   */\n  #getRcFileOrThrow() {\n    const kernelUrl = fileURLToPath(new URL('./adonisrc.ts', this.#cwd))\n    return this.#project.getSourceFileOrThrow(kernelUrl)\n  }\n\n  /**\n   * Check if environments array has a subset of available environments\n   */\n  #isInSpecificEnvironment(environments?: AppEnvironments[]): boolean {\n    if (!environments) {\n      return false\n    }\n\n    return !!(['web', 'console', 'test', 'repl'] as const).find(\n      (env) => !environments.includes(env)\n    )\n  }\n\n  /**\n   * Locate the `defineConfig` call inside the `adonisrc.ts` file\n   */\n  #locateDefineConfigCallOrThrow(file: SourceFile) {\n    const call = file\n      .getDescendantsOfKind(SyntaxKind.CallExpression)\n      .find((statement) => statement.getExpression().getText() === 'defineConfig')\n\n    if (!call) {\n      throw new Error('Could not locate the defineConfig call.')\n    }\n\n    return call\n  }\n\n  /**\n   * Return the ObjectLiteralExpression of the defineConfig call\n   */\n  #getDefineConfigObjectOrThrow(defineConfigCall: CallExpression) {\n    const configObject = defineConfigCall\n      .getArguments()[0]\n      .asKindOrThrow(SyntaxKind.ObjectLiteralExpression)\n\n    return configObject\n  }\n\n  /**\n   * Check if the defineConfig() call has the property assignment\n   * inside it or not. If not, it will create one and return it.\n   */\n  #getPropertyAssignmentInDefineConfigCall(propertyName: string, initializer: string) {\n    const file = this.#getRcFileOrThrow()\n    const defineConfigCall = this.#locateDefineConfigCallOrThrow(file)\n    const configObject = this.#getDefineConfigObjectOrThrow(defineConfigCall)\n\n    let property = configObject.getProperty(propertyName)\n\n    if (!property) {\n      configObject.addPropertyAssignment({ name: propertyName, initializer })\n      property = configObject.getProperty(propertyName)\n    }\n\n    return property as PropertyAssignment\n  }\n\n  /**\n   * Extract list of imported modules from an ArrayLiteralExpression\n   *\n   * It assumes that the array can have two types of elements:\n   *\n   * - Simple lazy imported modules: [() => import('path/to/file')]\n   * - Or an object entry: [{ file: () => import('path/to/file'), environment: ['web', 'console'] }]\n   *   where the `file` property is a lazy imported module.\n   */\n  #extractModulesFromArray(array: ArrayLiteralExpression) {\n    const modules = array.getElements().map((element) => {\n      /**\n       * Simple lazy imported module\n       */\n      if (Node.isArrowFunction(element)) {\n        const importExp = element.getFirstDescendantByKindOrThrow(SyntaxKind.CallExpression)\n        const literal = importExp.getFirstDescendantByKindOrThrow(SyntaxKind.StringLiteral)\n        return literal.getLiteralValue()\n      }\n\n      /**\n       * Object entry\n       */\n      if (Node.isObjectLiteralExpression(element)) {\n        const fileProp = element.getPropertyOrThrow('file') as PropertyAssignment\n        const arrowFn = fileProp.getFirstDescendantByKindOrThrow(SyntaxKind.ArrowFunction)\n        const importExp = arrowFn.getFirstDescendantByKindOrThrow(SyntaxKind.CallExpression)\n        const literal = importExp.getFirstDescendantByKindOrThrow(SyntaxKind.StringLiteral)\n        return literal.getLiteralValue()\n      }\n    })\n\n    return modules.filter(Boolean) as string[]\n  }\n\n  /**\n   * Extract a specific property from an ArrayLiteralExpression\n   * that contains object entries.\n   *\n   * This function is mainly used for extractring the `pattern` property\n   * when adding a new meta files entry, or the `name` property when\n   * adding a new test suite.\n   */\n  #extractPropertyFromArray(array: ArrayLiteralExpression, propertyName: string) {\n    const property = array.getElements().map((el) => {\n      if (!Node.isObjectLiteralExpression(el)) return\n\n      const nameProp = el.getPropertyOrThrow(propertyName)\n      if (!Node.isPropertyAssignment(nameProp)) return\n\n      const name = nameProp.getInitializerIfKindOrThrow(SyntaxKind.StringLiteral)\n      return name.getLiteralValue()\n    })\n\n    return property.filter(Boolean) as string[]\n  }\n\n  /**\n   * Build a new module entry for the preloads and providers array\n   * based upon the environments specified\n   */\n  #buildNewModuleEntry(modulePath: string, environments?: AppEnvironments[]) {\n    if (!this.#isInSpecificEnvironment(environments)) {\n      return `() => import('${modulePath}')`\n    }\n\n    return `{\n      file: () => import('${modulePath}'),\n      environment: [${environments?.map((env) => `'${env}'`).join(', ')}],\n    }`\n  }\n\n  /**\n   * Add a new command to the rcFile\n   */\n  addCommand(commandPath: string) {\n    const commandsProperty = this.#getPropertyAssignmentInDefineConfigCall('commands', '[]')\n    const commandsArray = commandsProperty.getInitializerIfKindOrThrow(\n      SyntaxKind.ArrayLiteralExpression\n    )\n\n    const commandString = `() => import('${commandPath}')`\n\n    /**\n     * If the command already exists, do nothing\n     */\n    if (commandsArray.getElements().some((el) => el.getText() === commandString)) {\n      return this\n    }\n\n    /**\n     * Add the command to the array\n     */\n    commandsArray.addElement(commandString)\n    return this\n  }\n\n  /**\n   * Add a new preloaded file to the rcFile\n   */\n  addPreloadFile(modulePath: string, environments?: AppEnvironments[]) {\n    const preloadsProperty = this.#getPropertyAssignmentInDefineConfigCall('preloads', '[]')\n    const preloadsArray = preloadsProperty.getInitializerIfKindOrThrow(\n      SyntaxKind.ArrayLiteralExpression\n    )\n\n    /**\n     * Check for duplicates\n     */\n    const existingPreloadedFiles = this.#extractModulesFromArray(preloadsArray)\n    const isDuplicate = existingPreloadedFiles.includes(modulePath)\n    if (isDuplicate) {\n      return this\n    }\n\n    /**\n     * Add the preloaded file to the array\n     */\n    preloadsArray.addElement(this.#buildNewModuleEntry(modulePath, environments))\n    return this\n  }\n\n  /**\n   * Add a new provider to the rcFile\n   */\n  addProvider(providerPath: string, environments?: AppEnvironments[]) {\n    const property = this.#getPropertyAssignmentInDefineConfigCall('providers', '[]')\n    const providersArray = property.getInitializerIfKindOrThrow(SyntaxKind.ArrayLiteralExpression)\n\n    /**\n     * Check for duplicates\n     */\n    const existingProviderPaths = this.#extractModulesFromArray(providersArray)\n    const isDuplicate = existingProviderPaths.includes(providerPath)\n    if (isDuplicate) {\n      return this\n    }\n\n    /**\n     * Add the provider to the array\n     */\n    providersArray.addElement(this.#buildNewModuleEntry(providerPath, environments))\n\n    return this\n  }\n\n  /**\n   * Add a new meta file to the rcFile\n   */\n  addMetaFile(globPattern: string, reloadServer = false) {\n    const property = this.#getPropertyAssignmentInDefineConfigCall('metaFiles', '[]')\n    const metaFilesArray = property.getInitializerIfKindOrThrow(SyntaxKind.ArrayLiteralExpression)\n\n    /**\n     * Check for duplicates\n     */\n    const alreadyDefinedPatterns = this.#extractPropertyFromArray(metaFilesArray, 'pattern')\n    if (alreadyDefinedPatterns.includes(globPattern)) {\n      return this\n    }\n\n    /**\n     * Add the meta file to the array\n     */\n    metaFilesArray.addElement(\n      `{\n        pattern: '${globPattern}',\n        reloadServer: ${reloadServer},\n      }`\n    )\n\n    return this\n  }\n\n  /**\n   * Set directory name and path\n   */\n  setDirectory(key: string, value: string) {\n    const property = this.#getPropertyAssignmentInDefineConfigCall('directories', '{}')\n    const directories = property.getInitializerIfKindOrThrow(SyntaxKind.ObjectLiteralExpression)\n    directories.addPropertyAssignment({ name: key, initializer: `'${value}'` })\n\n    return this\n  }\n\n  /**\n   * Set command alias\n   */\n  setCommandAlias(alias: string, command: string) {\n    const aliasProperty = this.#getPropertyAssignmentInDefineConfigCall('commandsAliases', '{}')\n    const aliases = aliasProperty.getInitializerIfKindOrThrow(SyntaxKind.ObjectLiteralExpression)\n    aliases.addPropertyAssignment({ name: alias, initializer: `'${command}'` })\n\n    return this\n  }\n\n  /**\n   * Add a new test suite to the rcFile\n   */\n  addSuite(suiteName: string, files: string | string[], timeout?: number) {\n    const testProperty = this.#getPropertyAssignmentInDefineConfigCall(\n      'tests',\n      `{ suites: [], forceExit: true, timeout: 2000 }`\n    )\n\n    const property = testProperty\n      .getInitializerIfKindOrThrow(SyntaxKind.ObjectLiteralExpression)\n      .getPropertyOrThrow('suites') as PropertyAssignment\n\n    const suitesArray = property.getInitializerIfKindOrThrow(SyntaxKind.ArrayLiteralExpression)\n\n    /**\n     * Check for duplicates\n     */\n    const existingSuitesNames = this.#extractPropertyFromArray(suitesArray, 'name')\n    if (existingSuitesNames.includes(suiteName)) {\n      return this\n    }\n\n    /**\n     * Add the suite to the array\n     */\n    const filesArray = Array.isArray(files) ? files : [files]\n    suitesArray.addElement(\n      `{\n        name: '${suiteName}',\n        files: [${filesArray.map((file) => `'${file}'`).join(', ')}],\n        timeout: ${timeout ?? 2000},\n      }`\n    )\n\n    return this\n  }\n\n  /**\n   * Save the adonisrc.ts file\n   */\n  save() {\n    const file = this.#getRcFileOrThrow()\n    file.formatText(this.#editorSettings)\n    return file.save()\n  }\n}\n"],"mappings":"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","names":["fileURLToPath","Node","Project","SyntaxKind","Project","fileURLToPath","SyntaxKind","Node"]}

package/build/src/code_transformer/rc_file_transformer.d.ts

@@ -0,0 +1,43 @@
+/// <reference types="node" resolution-mode="require"/>
+import type { AppEnvironments } from '@adonisjs/application/types';
+import { Project } from 'ts-morph';
+/**
+ * RcFileTransformer is used to transform the `adonisrc.ts` file
+ * for adding new commands, providers, meta files etc
+ */
+export declare class RcFileTransformer {
+    #private;
+    constructor(cwd: URL, project: Project);
+    /**
+     * Add a new command to the rcFile
+     */
+    addCommand(commandPath: string): this;
+    /**
+     * Add a new preloaded file to the rcFile
+     */
+    addPreloadFile(modulePath: string, environments?: AppEnvironments[]): this;
+    /**
+     * Add a new provider to the rcFile
+     */
+    addProvider(providerPath: string, environments?: AppEnvironments[]): this;
+    /**
+     * Add a new meta file to the rcFile
+     */
+    addMetaFile(globPattern: string, reloadServer?: boolean): this;
+    /**
+     * Set directory name and path
+     */
+    setDirectory(key: string, value: string): this;
+    /**
+     * Set command alias
+     */
+    setCommandAlias(alias: string, command: string): this;
+    /**
+     * Add a new test suite to the rcFile
+     */
+    addSuite(suiteName: string, files: string | string[], timeout?: number): this;
+    /**
+     * Save the adonisrc.ts file
+     */
+    save(): Promise<void>;
+}

package/build/src/debug.d.ts

@@ -0,0 +1,3 @@
+/// <reference types="node" resolution-mode="require"/>
+declare const _default: import("util").DebugLogger;
+export default _default;

package/build/src/dev_server.d.ts

@@ -8,9 +8,9 @@ import type { DevServerOptions } from './types.js';
  *
  * The Dev server performs the following actions
  *
- * - Assigns a random PORT, when PORT inside .env file is in use
+ * - Assigns a random PORT, when PORT inside .env file is in use.
  * - Uses tsconfig.json file to collect a list of files to watch.
- * - Uses metaFiles from .adonisrc.json file to collect a list of files to watch.
+ * - Uses metaFiles from adonisrc.ts file to collect a list of files to watch.
  * - Restart HTTP server on every file change.
  */
 export declare class DevServer {

package/build/src/helpers.d.ts

@@ -26,10 +26,6 @@ export declare function watch(cwd: string | URL, ts: typeof tsStatic, options: W
  * Check if file is an .env file
  */
 export declare function isDotEnvFile(filePath: string): boolean;
-/**
- * Check if file is .adonisrc.json file
- */
-export declare function isRcFile(filePath: string): boolean;
 /**
  * Returns the port to use after inspect the dot-env files inside
  * a given directory.
@@ -39,7 +35,12 @@ export declare function isRcFile(filePath: string): boolean;
  *
  * - The "process.env.PORT" value is used if exists.
  * - The dot-env files are loaded using the "EnvLoader" and the PORT
- *   value is by iterating over all the loaded files. The iteration
- *   stops after first find.
+ *   value is used by iterating over all the loaded files. The
+ *   iteration stops after first find.
  */
 export declare function getPort(cwd: URL): Promise<number>;
+/**
+ * Helper function to copy files from relative paths or glob
+ * patterns
+ */
+export declare function copyFiles(files: string[], cwd: string, outDir: string): Promise<void[]>;

package/build/src/test_runner.d.ts

@@ -3,15 +3,16 @@ import type tsStatic from 'typescript';
 import { type Logger } from '@poppinss/cliui';
 import type { TestRunnerOptions } from './types.js';
 /**
- * Exposes the API to start the development. Optionally, the watch API can be
- * used to watch for file changes and restart the development server.
+ * Exposes the API to run Japa tests and optionally watch for file
+ * changes to re-run the tests.
  *
- * The Dev server performs the following actions
+ * The watch mode functions as follows.
+ *
+ *  - If the changed file is a test file, then only tests for that file
+ *    will be re-run.
+ *  - Otherwise, all tests will re-run with respect to the initial
+ *    filters applied when running the `node ace test` command.
  *
- * - Assigns a random PORT, when PORT inside .env file is in use
- * - Uses tsconfig.json file to collect a list of files to watch.
- * - Uses metaFiles from .adonisrc.json file to collect a list of files to watch.
- * - Restart HTTP server on every file change.
  */
 export declare class TestRunner {
     #private;