@adonisjs/assembler 6.1.3-9 → 7.0.0-0

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

package/build/src/types.d.ts

@@ -3,10 +3,25 @@
  * Options needed to run a script file
  */
 export type RunOptions = {
+    /**
+     * Script to run
+     */
     script: string;
+    /**
+     * Arguments to pass to the script
+     */
     scriptArgs: string[];
+    /**
+     * Arguments to pass to NodeJS CLI
+     */
     nodeArgs: string[];
+    /**
+     * Standard input ouput stream options
+     */
     stdio?: 'pipe' | 'inherit';
+    /**
+     * Environment variables to pass to the child process
+     */
     env?: NodeJS.ProcessEnv;
 };
 /**
@@ -16,48 +31,117 @@ export type WatchOptions = {
     poll?: boolean;
 };
 /**
- * Meta file config defined in ".adonisrc.json" file
+ * Meta file config defined in "adonisrc.ts" file
  */
 export type MetaFile = {
     pattern: string;
     reloadServer: boolean;
 };
 /**
- * Test suite defined in ".adonisrc.json" file
+ * Test suite defined in "adonisrc.ts" file
  */
 export type Suite = {
-    files: string[];
     name: string;
+    files: string | string[];
 };
 /**
  * Options accepted by assets bundler
  */
 export type AssetsBundlerOptions = {
-    serve: false;
-    args?: string[];
+    enabled: false;
     driver?: string;
     cmd?: string;
+    args?: string[];
 } | {
-    serve: true;
-    args: string[];
+    enabled: true;
     driver: string;
     cmd: string;
+    args: string[];
 };
 /**
- * Options accepted by the dev server
+ * Options accepted when starting the dev
+ * server
  */
 export type DevServerOptions = {
+    /**
+     * Arguments to pass to the "bin/server.js" file
+     * executed a child process
+     */
     scriptArgs: string[];
+    /**
+     * Arguments to pass to Node.js CLI when executing
+     * the "bin/server.js" file
+     */
     nodeArgs: string[];
+    /**
+     * Clear screen after every file change
+     */
     clearScreen?: boolean;
+    /**
+     * Environment variables to share with the "bin/server.js"
+     * file.
+     */
     env?: NodeJS.ProcessEnv;
+    /**
+     * An array of metaFiles glob patterns to watch
+     */
     metaFiles?: MetaFile[];
+    /**
+     * Assets bundler options to start its dev server
+     */
     assets?: AssetsBundlerOptions;
 };
 /**
  * Options accepted by the test runner
  */
 export type TestRunnerOptions = {
+    /**
+     * Arguments to pass to the "bin/server.js" file
+     * executed a child process
+     */
+    scriptArgs: string[];
+    /**
+     * Arguments to pass to Node.js CLI when executing
+     * the "bin/server.js" file
+     */
+    nodeArgs: string[];
+    /**
+     * Clear screen after every file change
+     */
+    clearScreen?: boolean;
+    /**
+     * Environment variables to share with the "bin/server.js"
+     * file.
+     */
+    env?: NodeJS.ProcessEnv;
+    /**
+     * An array of metaFiles glob patterns to watch
+     */
+    metaFiles?: MetaFile[];
+    /**
+     * Assets bundler options to start its dev server
+     */
+    assets?: AssetsBundlerOptions;
+    /**
+     * An array of suites for which to run tests
+     */
+    suites: Suite[];
+    /**
+     * Set the tests runner reporter via the CLI flag
+     */
+    reporters?: string[];
+    /**
+     * Set the tests global timeout via the CLI flag
+     */
+    timeout?: number;
+    /**
+     * Define retries via the CLI flag
+     */
+    retries?: number;
+    /**
+     * Run only failed tests
+     */
+    failed?: boolean;
     /**
      * Filter arguments are provided as a key-value
      * pair, so that we can mutate them (if needed)
@@ -68,24 +152,64 @@ export type TestRunnerOptions = {
         groups: string[];
         files: string[];
         tags: string[];
-        ignoreTags: string[];
     }>;
-    /**
-     * All other tags are provided as a collection of
-     * arguments
-     */
-    scriptArgs: string[];
-    nodeArgs: string[];
-    clearScreen?: boolean;
-    env?: NodeJS.ProcessEnv;
-    metaFiles?: MetaFile[];
-    assets?: AssetsBundlerOptions;
-    suites: Suite[];
 };
 /**
  * Options accepted by the project bundler
  */
 export type BundlerOptions = {
+    /**
+     * An array of metaFiles glob patterns to copy the
+     * files to the build folder
+     */
     metaFiles?: MetaFile[];
+    /**
+     * Assets bundler options to create the production build
+     * for assets
+     */
     assets?: AssetsBundlerOptions;
 };
+/**
+ * Entry to add a middleware to a given middleware stack
+ * via the CodeTransformer
+ */
+export type MiddlewareNode = {
+    /**
+     * If you are adding a named middleware, then you must
+     * define the name.
+     */
+    name?: string;
+    /**
+     * The path to the middleware file
+     *
+     * @example
+     *  `@adonisjs/static/static_middleware`
+     *  `#middlewares/silent_auth.js`
+     */
+    path: string;
+    /**
+     * The position to add the middleware. If `before`
+     * middleware will be added at the first position and
+     * therefore will be run before all others
+     *
+     * @default 'after'
+     */
+    position?: 'before' | 'after';
+};
+/**
+ * Defines the structure of an environment variable validation
+ * definition
+ */
+export type EnvValidationNode = {
+    /**
+     * Write a leading comment on top of your variables
+     */
+    leadingComment?: string;
+    /**
+     * A key-value pair of env variables and their validation
+     *
+     * @example
+     *  MY_VAR: 'Env.schema.string.optional()'
+     */
+    variables: Record<string, string>;
+};

package/package.json

@@ -1,80 +1,88 @@
 {
   "name": "@adonisjs/assembler",
-  "version": "6.1.3-9",
   "description": "Provides utilities to run AdonisJS development server and build project for production",
+  "version": "7.0.0-0",
+  "engines": {
+    "node": ">=18.16.0"
+  },
   "main": "build/index.js",
   "type": "module",
   "files": [
-    "build/src",
-    "build/index.d.ts",
-    "build/index.js"
+    "build",
+    "!build/bin",
+    "!build/tests"
   ],
   "exports": {
     ".": "./build/index.js",
+    "./code_transformer": "./build/src/code_transformer/main.js",
     "./types": "./build/src/types.js"
   },
-  "engines": {
-    "node": ">=18.16.0"
-  },
   "scripts": {
     "pretest": "npm run lint",
-    "test": "cross-env NODE_DEBUG=chokidar:ts c8 npm run quick:test",
+    "test": "c8 npm run quick:test",
     "lint": "eslint . --ext=.ts",
     "clean": "del-cli build",
     "typecheck": "tsc --noEmit",
-    "compile": "npm run lint && npm run clean && tsc",
+    "precompile": "npm run lint && npm run clean",
+    "compile": "tsup-node && tsc --emitDeclarationOnly --declaration",
     "build": "npm run compile",
     "release": "np",
     "version": "npm run build",
     "sync-labels": "github-label-sync --labels .github/labels.json adonisjs/assembler",
     "format": "prettier --write .",
     "prepublishOnly": "npm run build",
-    "quick:test": "node --loader=ts-node/esm bin/test.ts"
+    "quick:test": "cross-env NODE_DEBUG=adonisjs:assembler node --enable-source-maps --loader=ts-node/esm bin/test.ts"
   },
-  "keywords": [
-    "adonisjs",
-    "build",
-    "ts"
-  ],
-  "author": "virk,adonisjs",
-  "license": "MIT",
   "devDependencies": {
-    "@adonisjs/eslint-config": "^1.1.7",
-    "@adonisjs/prettier-config": "^1.1.7",
-    "@adonisjs/tsconfig": "^1.1.7",
-    "@commitlint/cli": "^17.6.6",
-    "@commitlint/config-conventional": "^17.6.6",
-    "@japa/assert": "^2.0.0-1",
-    "@japa/file-system": "^2.0.0-1",
-    "@japa/runner": "^3.0.0-3",
-    "@swc/core": "^1.3.67",
-    "@types/node": "^20.3.3",
-    "@types/picomatch": "^2.3.0",
-    "c8": "^8.0.0",
+    "@adonisjs/application": "^8.0.0-3",
+    "@adonisjs/eslint-config": "^1.2.0",
+    "@adonisjs/prettier-config": "^1.2.0",
+    "@adonisjs/tsconfig": "^1.2.0",
+    "@commitlint/cli": "^18.4.3",
+    "@commitlint/config-conventional": "^18.4.3",
+    "@japa/assert": "^2.1.0",
+    "@japa/file-system": "^2.1.0",
+    "@japa/runner": "^3.1.1",
+    "@japa/snapshot": "^2.0.4",
+    "@swc/core": "^1.3.101",
+    "@types/node": "^20.10.5",
+    "@types/picomatch": "^2.3.3",
+    "@types/pretty-hrtime": "^1.0.3",
+    "c8": "^8.0.1",
     "cross-env": "^7.0.3",
+    "dedent": "^1.5.1",
     "del-cli": "^5.0.0",
-    "eslint": "^8.44.0",
+    "eslint": "^8.56.0",
     "github-label-sync": "^2.3.1",
     "husky": "^8.0.3",
-    "np": "^8.0.4",
+    "np": "^9.2.0",
     "p-event": "^6.0.0",
-    "prettier": "^2.8.8",
-    "ts-node": "^10.9.1",
-    "typescript": "^5.1.6"
+    "prettier": "^3.1.1",
+    "ts-node": "^10.9.2",
+    "tsup": "^8.0.1",
+    "typescript": "^5.3.3"
   },
   "dependencies": {
-    "@adonisjs/env": "^4.2.0-3",
-    "@poppinss/chokidar-ts": "^4.1.0-4",
-    "@poppinss/cliui": "^6.1.1-3",
-    "cpy": "^8.1.2",
-    "execa": "^7.0.0",
+    "@adonisjs/env": "^4.2.0-7",
+    "@antfu/install-pkg": "^0.3.1",
+    "@poppinss/chokidar-ts": "^4.1.3",
+    "@poppinss/cliui": "^6.2.3",
+    "cpy": "^11.0.0",
+    "execa": "^8.0.1",
+    "fast-glob": "^3.3.2",
     "get-port": "^7.0.0",
-    "picomatch": "^2.3.1",
-    "slash": "^5.1.0"
+    "junk": "^4.0.1",
+    "picomatch": "^3.0.1",
+    "pretty-hrtime": "^1.0.3",
+    "slash": "^5.1.0",
+    "ts-morph": "^21.0.1"
   },
   "peerDependencies": {
     "typescript": "^4.0.0 || ^5.0.0"
   },
+  "author": "virk,adonisjs",
+  "license": "MIT",
+  "homepage": "https://github.com/adonisjs/assembler#readme",
   "repository": {
     "type": "git",
     "url": "git+ssh://git@github.com/adonisjs/assembler.git"
@@ -82,7 +90,15 @@
   "bugs": {
     "url": "https://github.com/adonisjs/assembler/issues"
   },
-  "homepage": "https://github.com/adonisjs/assembler#readme",
+  "keywords": [
+    "adonisjs",
+    "build",
+    "ts"
+  ],
+  "eslintConfig": {
+    "extends": "@adonisjs/eslint-config/package"
+  },
+  "prettier": "@adonisjs/prettier-config",
   "commitlint": {
     "extends": [
       "@commitlint/config-conventional"
@@ -106,14 +122,24 @@
     "exclude": [
       "tests/**",
       "build/**",
+      "bin/**",
+      "tmp/**",
       "examples/**",
       "src/dev_server.ts",
       "src/test_runner.ts",
       "src/assets_dev_server.ts"
     ]
   },
-  "eslintConfig": {
-    "extends": "@adonisjs/eslint-config/package"
-  },
-  "prettier": "@adonisjs/prettier-config"
+  "tsup": {
+    "entry": [
+      "./index.ts",
+      "./src/code_transformer/main.ts"
+    ],
+    "outDir": "./build",
+    "clean": true,
+    "format": "esm",
+    "dts": false,
+    "sourcemap": true,
+    "target": "esnext"
+  }
 }