@adonisjs/assembler 8.0.0-next.6 → 8.0.0-next.8

package/build/index.js

@@ -1,6 +1,6 @@
 import {
   IndexGenerator
-} from "./chunk-MC3FJR62.js";
+} from "./chunk-N6H4XTTC.js";
 import {
   copyFiles,
   debug_default,
@@ -12,15 +12,240 @@ import {
   runNode,
   throttle,
   watch
-} from "./chunk-F4RAGKQN.js";
+} from "./chunk-PORDZS62.js";
+
+// src/hooks.ts
+var hooks = {
+  /**
+   * Hook called during application initialization. This is the first hook
+   * that gets executed when the assembler starts up.
+   *
+   * @param callback - Function to execute when the init event occurs
+   *
+   * @example
+   * ```js
+   * hooks.init((app) => {
+   *   console.log('Application is initializing')
+   *   // Setup global configurations
+   * })
+   * ```
+   */
+  init(callback) {
+    return callback;
+  },
+  /**
+   * Hook called after routes have been committed to the router.
+   * This occurs after all route definitions have been processed.
+   *
+   * @param callback - Function to execute when routes are committed
+   *
+   * @example
+   * ```js
+   * hooks.routesCommitted((router) => {
+   *   console.log('All routes have been committed to the router')
+   *   // Perform route-based setup
+   * })
+   * ```
+   */
+  routesCommitted(callback) {
+    return callback;
+  },
+  /**
+   * Hook called when the assembler starts scanning for route files.
+   * This happens before any route files are actually processed.
+   *
+   * @param callback - Function to execute when route scanning begins
+   *
+   * @example
+   * ```js
+   * hooks.routesScanning(() => {
+   *   console.log('Starting to scan for route files')
+   *   // Setup route scanning configurations
+   * })
+   * ```
+   */
+  routesScanning(callback) {
+    return callback;
+  },
+  /**
+   * Hook called after all route files have been scanned and processed.
+   * This occurs once the route scanning phase is complete.
+   *
+   * @param callback - Function to execute when route scanning is finished
+   *
+   * @example
+   * ```js
+   * hooks.routesScanned((scannedRoutes) => {
+   *   console.log('Route scanning completed')
+   *   // Process scanned route information
+   * })
+   * ```
+   */
+  routesScanned(callback) {
+    return callback;
+  },
+  /**
+   * Hook called when a file is modified during development.
+   * This is triggered by the file watcher when changes are detected.
+   *
+   * @param callback - Function to execute when a file changes
+   *
+   * @example
+   * ```js
+   * hooks.fileChanged((filePath, stats) => {
+   *   console.log(`File changed: ${filePath}`)
+   *   // Handle file change logic
+   * })
+   * ```
+   */
+  fileChanged(callback) {
+    return callback;
+  },
+  /**
+   * Hook called when a new file is added during development.
+   * This is triggered by the file watcher when new files are created.
+   *
+   * @param callback - Function to execute when a file is added
+   *
+   * @example
+   * ```js
+   * hooks.fileAdded((filePath, stats) => {
+   *   console.log(`New file added: ${filePath}`)
+   *   // Handle new file logic
+   * })
+   * ```
+   */
+  fileAdded(callback) {
+    return callback;
+  },
+  /**
+   * Hook called when a file is removed during development.
+   * This is triggered by the file watcher when files are deleted.
+   *
+   * @param callback - Function to execute when a file is removed
+   *
+   * @example
+   * ```js
+   * hooks.fileRemoved((filePath) => {
+   *   console.log(`File removed: ${filePath}`)
+   *   // Handle file removal logic
+   * })
+   * ```
+   */
+  fileRemoved(callback) {
+    return callback;
+  },
+  /**
+   * Hook called when the development server is about to start.
+   * This occurs before the server begins listening for connections.
+   *
+   * @param callback - Function to execute when dev server is starting
+   *
+   * @example
+   * ```js
+   * hooks.devServerStarting((server) => {
+   *   console.log('Development server is starting')
+   *   // Setup server configurations
+   * })
+   * ```
+   */
+  devServerStarting(callback) {
+    return callback;
+  },
+  /**
+   * Hook called after the development server has successfully started.
+   * This occurs once the server is listening and ready to accept requests.
+   *
+   * @param callback - Function to execute when dev server has started
+   *
+   * @example
+   * ```js
+   * hooks.devServerStarted((server) => {
+   *   console.log(`Development server started on port ${server.port}`)
+   *   // Notify external services or open browser
+   * })
+   * ```
+   */
+  devServerStarted(callback) {
+    return callback;
+  },
+  /**
+   * Hook called when the build process is about to start.
+   * This occurs before any build tasks are executed.
+   *
+   * @param callback - Function to execute when build is starting
+   *
+   * @example
+   * ```js
+   * hooks.buildStarting((buildConfig) => {
+   *   console.log('Build process is starting')
+   *   // Setup build configurations or clean directories
+   * })
+   * ```
+   */
+  buildStarting(callback) {
+    return callback;
+  },
+  /**
+   * Hook called after the build process has completed.
+   * This occurs once all build tasks have finished executing.
+   *
+   * @param callback - Function to execute when build is finished
+   *
+   * @example
+   * ```js
+   * hooks.buildFinished((buildResult) => {
+   *   console.log('Build process completed')
+   *   // Deploy artifacts or notify build completion
+   * })
+   * ```
+   */
+  buildFinished(callback) {
+    return callback;
+  },
+  /**
+   * Hook called when the test suite is about to start.
+   * This occurs before any test files are executed.
+   *
+   * @param callback - Function to execute when tests are starting
+   *
+   * @example
+   * ```js
+   * hooks.testsStarting((testConfig) => {
+   *   console.log('Test suite is starting')
+   *   // Setup test database or mock services
+   * })
+   * ```
+   */
+  testsStarting(callback) {
+    return callback;
+  },
+  /**
+   * Hook called after the test suite has completed.
+   * This occurs once all test files have finished executing.
+   *
+   * @param callback - Function to execute when tests are finished
+   *
+   * @example
+   * ```js
+   * hooks.testsFinished((testResults) => {
+   *   console.log('Test suite completed')
+   *   // Generate test reports or cleanup test resources
+   * })
+   * ```
+   */
+  testsFinished(callback) {
+    return callback;
+  }
+};
 
 // src/bundler.ts
 import dedent from "dedent";
 import fs from "fs/promises";
 import { cliui } from "@poppinss/cliui";
 import { fileURLToPath } from "url";
-import { join, relative } from "path";
 import string from "@poppinss/utils/string";
+import { join, relative } from "path/posix";
 import { detectPackageManager } from "@antfu/install-pkg";
 var SUPPORTED_PACKAGE_MANAGERS = {
   "npm": {
@@ -45,10 +270,6 @@ var SUPPORTED_PACKAGE_MANAGERS = {
   }
 };
 var Bundler = class {
-  /**
-   * The current working project directory path as string
-   */
-  #cwdPath;
   /**
    * Reference to the TypeScript module
    */
@@ -57,6 +278,10 @@ var Bundler = class {
    * Hooks to execute custom actions during the build process
    */
   #hooks;
+  /**
+   * Index generator for managing auto-generated index files
+   */
+  #indexGenerator;
   /**
    * CLI UI instance for displaying colorful messages and progress information
    */
@@ -65,6 +290,10 @@ var Bundler = class {
    * The current working directory URL
    */
   cwd;
+  /**
+   * The current working project directory path as string
+   */
+  cwdPath;
   /**
    * Bundler configuration options including hooks and meta files
    */
@@ -79,7 +308,7 @@ var Bundler = class {
   constructor(cwd, ts, options) {
     this.cwd = cwd;
     this.options = options;
-    this.#cwdPath = fileURLToPath(this.cwd);
+    this.cwdPath = string.toUnixSlash(fileURLToPath(this.cwd));
     this.#ts = ts;
   }
   /**
@@ -87,7 +316,7 @@ var Bundler = class {
    * file path
    */
   #getRelativeName(filePath) {
-    return string.toUnixSlash(relative(this.#cwdPath, filePath));
+    return string.toUnixSlash(relative(this.cwdPath, filePath));
   }
   /**
    * Cleans up the build directory
@@ -115,13 +344,13 @@ var Bundler = class {
    */
   async #copyMetaFiles(outDir, additionalFilesToCopy) {
     const metaFiles = (this.options.metaFiles || []).map((file) => file.pattern).concat(additionalFilesToCopy);
-    await copyFiles(metaFiles, this.#cwdPath, outDir);
+    await copyFiles(metaFiles, this.cwdPath, outDir);
   }
   /**
    * Detect the package manager used by the project
    */
   async #detectPackageManager() {
-    const pkgManager = await detectPackageManager(this.#cwdPath);
+    const pkgManager = await detectPackageManager(this.cwdPath);
     if (pkgManager === "deno") {
       return "npm";
     }
@@ -163,12 +392,18 @@ var Bundler = class {
    * const success = await bundler.bundle(true, 'npm')
    */
   async bundle(stopOnError = true, client) {
-    this.#hooks = await loadHooks(this.options.hooks, ["buildStarting", "buildFinished"]);
     this.packageManager = client ?? await this.#detectPackageManager() ?? "npm";
     const config = parseConfig(this.cwd, this.#ts);
     if (!config) {
       return false;
     }
+    this.ui.logger.info("loading hooks...");
+    this.#hooks = await loadHooks(this.options.hooks, ["init", "buildStarting", "buildFinished"]);
+    this.#indexGenerator = new IndexGenerator(this.cwdPath, this.ui.logger);
+    await this.#hooks.runner("init").run(this, this.#indexGenerator);
+    this.#hooks.clear("init");
+    this.ui.logger.info("generating indexes...");
+    await this.#indexGenerator.generate();
     const outDir = config.options.outDir || fileURLToPath(new URL("build/", this.cwd));
     this.ui.logger.info("cleaning up output directory", { suffix: this.#getRelativeName(outDir) });
     await this.#cleanupBuildDirectory(outDir);
@@ -649,10 +884,6 @@ var DevServer = class _DevServer {
     fullReload: true,
     hotReloaded: false
   };
-  /**
-   * File path computed from the cwd
-   */
-  #cwdPath;
   /**
    * External listeners that are invoked when child process
    * gets an error or closes
@@ -696,7 +927,7 @@ var DevServer = class _DevServer {
   /**
    * CLI UI instance for displaying colorful messages and progress information
    */
-  #ui = cliui2();
+  ui = cliui2();
   /**
    * Restarts the HTTP server and throttle concurrent calls to
    * ensure we do not end up with a long loop of restarts
@@ -734,19 +965,6 @@ var DevServer = class _DevServer {
   #cleanupKeyboardShortcuts() {
     this.#shortcutsManager?.cleanup();
   }
-  /**
-   * CLI UI instance to log colorful messages and progress information
-   */
-  get ui() {
-    return this.#ui;
-  }
-  /**
-   * CLI UI instance to log colorful messages and progress information
-   */
-  set ui(ui) {
-    this.#ui = ui;
-    this.#indexGenerator.setLogger(ui.logger);
-  }
   /**
    * The mode in which the DevServer is running.
    */
@@ -761,6 +979,10 @@ var DevServer = class _DevServer {
    * The current working directory URL
    */
   cwd;
+  /**
+   * File path computed from the cwd
+   */
+  cwdPath;
   /**
    * Development server configuration options including hooks and environment variables
    */
@@ -774,8 +996,7 @@ var DevServer = class _DevServer {
   constructor(cwd, options) {
     this.cwd = cwd;
     this.options = options;
-    this.#cwdPath = string3.toUnixSlash(fileURLToPath2(this.cwd));
-    this.#indexGenerator = new IndexGenerator(this.#cwdPath, this.ui.logger);
+    this.cwdPath = string3.toUnixSlash(fileURLToPath2(this.cwd));
   }
   /**
    * Type guard to check if child process message is from AdonisJS HTTP server
@@ -922,8 +1143,9 @@ var DevServer = class _DevServer {
     this.#mode = mode;
     this.#clearScreen();
     this.ui.logger.info(`starting server in ${this.#mode} mode...`);
+    this.#indexGenerator = new IndexGenerator(this.cwdPath, this.ui.logger);
     this.#stickyPort = String(await getPort(this.cwd));
-    this.#fileSystem = new FileSystem(this.#cwdPath, tsConfig, this.options);
+    this.#fileSystem = new FileSystem(this.cwdPath, tsConfig, this.options);
     this.ui.logger.info("loading hooks...");
     this.#hooks = await loadHooks(this.options.hooks, [
       "init",
@@ -972,7 +1194,7 @@ var DevServer = class _DevServer {
         } else if (this.#mode === "hmr" && this.#isHotHookMessage(message)) {
           debug_default("received hot-hook message %O", message);
           const absolutePath = message.path ? string3.toUnixSlash(message.path) : "";
-          const relativePath = relative3(this.#cwdPath, absolutePath);
+          const relativePath = relative3(this.cwdPath, absolutePath);
           if (message.type === "hot-hook:file-changed") {
             const { action } = message;
             if (action === "add") {
@@ -1074,7 +1296,7 @@ var DevServer = class _DevServer {
     await this.#startHTTPServer(this.#stickyPort);
     this.#watcher = watch({
       usePolling: options?.poll ?? false,
-      cwd: this.#cwdPath,
+      cwd: this.cwdPath,
       ignoreInitial: true,
       ignored: (file, stats) => {
         if (!stats) {
@@ -1097,17 +1319,17 @@ var DevServer = class _DevServer {
     });
     this.#watcher.on("add", (filePath) => {
       const relativePath = string3.toUnixSlash(filePath);
-      const absolutePath = join2(this.#cwdPath, relativePath);
+      const absolutePath = join2(this.cwdPath, relativePath);
       this.#hooks.runner("fileAdded").run(relativePath, absolutePath, this);
     });
     this.#watcher.on("change", (filePath) => {
       const relativePath = string3.toUnixSlash(filePath);
-      const absolutePath = join2(this.#cwdPath, relativePath);
+      const absolutePath = join2(this.cwdPath, relativePath);
       this.#hooks.runner("fileChanged").run(relativePath, absolutePath, _DevServer.#WATCHER_INFO, this);
     });
     this.#watcher.on("unlink", (filePath) => {
       const relativePath = string3.toUnixSlash(filePath);
-      const absolutePath = join2(this.#cwdPath, relativePath);
+      const absolutePath = join2(this.cwdPath, relativePath);
       this.#hooks.runner("fileRemoved").run(relativePath, absolutePath, this);
     });
   }
@@ -1148,10 +1370,6 @@ var TestRunner = class {
    * Hooks to execute custom actions during the tests runner lifecycle
    */
   #hooks;
-  /**
-   * The current working directory path as a string
-   */
-  #cwdPath;
   /**
    * Index generator for managing auto-generated index files
    */
@@ -1159,7 +1377,7 @@ var TestRunner = class {
   /**
    * CLI UI instance for displaying colorful messages and progress information
    */
-  #ui = cliui3();
+  ui = cliui3();
   /**
    * Re-runs the test child process and throttle concurrent calls to
    * ensure we do not end up with a long loop of restarts
@@ -1171,19 +1389,6 @@ var TestRunner = class {
     }
     await this.#runTests(this.#stickyPort, filters);
   }, "reRunTests");
-  /**
-   * CLI UI instance to log colorful messages and progress information
-   */
-  get ui() {
-    return this.#ui;
-  }
-  /**
-   * CLI UI instance to log colorful messages and progress information
-   */
-  set ui(ui) {
-    this.#ui = ui;
-    this.#indexGenerator.setLogger(ui.logger);
-  }
   /**
    * The script file to run as a child process
    */
@@ -1192,6 +1397,10 @@ var TestRunner = class {
    * The current working directory URL
    */
   cwd;
+  /**
+   * The current working directory path as a string
+   */
+  cwdPath;
   /**
    * Test runner configuration options including filters, reporters, and hooks
    */
@@ -1205,8 +1414,7 @@ var TestRunner = class {
   constructor(cwd, options) {
     this.cwd = cwd;
     this.options = options;
-    this.#cwdPath = string4.toUnixSlash(fileURLToPath3(this.cwd));
-    this.#indexGenerator = new IndexGenerator(this.#cwdPath, this.ui.logger);
+    this.cwdPath = string4.toUnixSlash(fileURLToPath3(this.cwd));
   }
   /**
    * Convert test runner options to the CLI args
@@ -1419,16 +1627,10 @@ var TestRunner = class {
    */
   async run() {
     this.#stickyPort = String(await getPort(this.cwd));
+    this.#indexGenerator = new IndexGenerator(this.cwdPath, this.ui.logger);
     this.#clearScreen();
     this.ui.logger.info("loading hooks...");
-    this.#hooks = await loadHooks(this.options.hooks, [
-      "init",
-      "testsStarting",
-      "testsFinished",
-      "fileAdded",
-      "fileChanged",
-      "fileRemoved"
-    ]);
+    this.#hooks = await loadHooks(this.options.hooks, ["init", "testsStarting", "testsFinished"]);
     await this.#hooks.runner("init").run(this, this.#indexGenerator);
     this.#hooks.clear("init");
     this.ui.logger.info("generating indexes...");
@@ -1454,7 +1656,8 @@ var TestRunner = class {
       return;
     }
     this.#stickyPort = String(await getPort(this.cwd));
-    this.#fileSystem = new FileSystem(this.#cwdPath, tsConfig, {
+    this.#indexGenerator = new IndexGenerator(this.cwdPath, this.ui.logger);
+    this.#fileSystem = new FileSystem(this.cwdPath, tsConfig, {
       ...this.options,
       suites: this.options.suites?.filter((suite) => {
         if (this.options.filters.suites) {
@@ -1482,7 +1685,7 @@ var TestRunner = class {
     await this.#runTests(this.#stickyPort);
     this.#watcher = watch({
       usePolling: options?.poll ?? false,
-      cwd: this.#cwdPath,
+      cwd: this.cwdPath,
       ignoreInitial: true,
       ignored: (file, stats) => {
         if (!stats) {
@@ -1505,12 +1708,12 @@ var TestRunner = class {
     });
     this.#watcher.on("add", (filePath) => {
       const relativePath = string4.toUnixSlash(filePath);
-      const absolutePath = join3(this.#cwdPath, filePath);
+      const absolutePath = join3(this.cwdPath, filePath);
       this.#hooks.runner("fileAdded").run(relativePath, absolutePath, this);
     });
     this.#watcher.on("change", (filePath) => {
       const relativePath = string4.toUnixSlash(filePath);
-      const absolutePath = join3(this.#cwdPath, filePath);
+      const absolutePath = join3(this.cwdPath, filePath);
       this.#hooks.runner("fileChanged").run(
         relativePath,
         absolutePath,
@@ -1524,7 +1727,7 @@ var TestRunner = class {
     });
     this.#watcher.on("unlink", (filePath) => {
       const relativePath = string4.toUnixSlash(filePath);
-      const absolutePath = join3(this.#cwdPath, filePath);
+      const absolutePath = join3(this.cwdPath, filePath);
       this.#hooks.runner("fileRemoved").run(relativePath, absolutePath, this);
     });
   }
@@ -1533,5 +1736,6 @@ export {
   Bundler,
   DevServer,
   SUPPORTED_PACKAGE_MANAGERS,
-  TestRunner
+  TestRunner,
+  hooks
 };

package/build/src/bundler.d.ts

@@ -52,6 +52,10 @@ export declare class Bundler {
      * The current working directory URL
      */
     cwd: URL;
+    /**
+     * The current working project directory path as string
+     */
+    cwdPath: string;
     /**
      * Bundler configuration options including hooks and meta files
      */

package/build/src/code_scanners/routes_scanner/main.js

@@ -10,7 +10,7 @@ import {
   VirtualFileSystem,
   debug_default,
   isRelative
-} from "../../../chunk-F4RAGKQN.js";
+} from "../../../chunk-PORDZS62.js";
 
 // src/code_scanners/routes_scanner/main.ts
 import { cliui } from "@poppinss/cliui";

package/build/src/dev_server.d.ts

@@ -1,5 +1,4 @@
 import type tsStatic from 'typescript';
-import { cliui } from '@poppinss/cliui';
 import type { DevServerOptions } from './types/common.ts';
 /**
  * Exposes the API to start the development server in HMR, watch or static mode.
@@ -18,13 +17,29 @@ import type { DevServerOptions } from './types/common.ts';
 export declare class DevServer {
     #private;
     /**
-     * CLI UI instance to log colorful messages and progress information
+     * CLI UI instance for displaying colorful messages and progress information
      */
-    get ui(): ReturnType<typeof cliui>;
-    /**
-     * CLI UI instance to log colorful messages and progress information
-     */
-    set ui(ui: ReturnType<typeof cliui>);
+    ui: {
+        colors: import("@poppinss/colors/types").Colors;
+        logger: import("@poppinss/cliui").Logger;
+        table: (tableOptions?: Partial<import("@poppinss/cliui/types").TableOptions>) => import("@poppinss/cliui").Table;
+        tasks: (tasksOptions?: Partial<import("@poppinss/cliui/types").TaskManagerOptions>) => import("@poppinss/cliui").TaskManager;
+        icons: {
+            tick: string;
+            cross: string;
+            bullet: string;
+            nodejs: string;
+            pointer: string;
+            info: string;
+            warning: string;
+            squareSmallFilled: string;
+        };
+        sticker: () => import("@poppinss/cliui").Instructions;
+        instructions: () => import("@poppinss/cliui").Instructions;
+        switchMode(modeToUse: "raw" | "silent" | "normal"): void;
+        useRenderer(rendererToUse: import("@poppinss/cliui/types").RendererContract): void;
+        useColors(colorsToUse: import("@poppinss/colors/types").Colors): void;
+    };
     /**
      * The mode in which the DevServer is running.
      */
@@ -37,6 +52,10 @@ export declare class DevServer {
      * The current working directory URL
      */
     cwd: URL;
+    /**
+     * File path computed from the cwd
+     */
+    cwdPath: string;
     /**
      * Development server configuration options including hooks and environment variables
      */