@adonisjs/assembler 8.0.0-next.24 → 8.0.0-next.26

package/build/index.js

@@ -1,6 +1,6 @@
 import { a as loadHooks, c as readTsConfig, d as runNode, f as throttle, m as debug_default, n as copyFiles, o as memoize, p as watch, r as getPort, s as parseConfig, t as VirtualFileSystem, u as run } from "./virtual_file_system-bGeoWsK-.js";
 import { n as FileBuffer, t as IndexGenerator } from "./main-XUXlmlEy.js";
-import { t as RoutesScanner } from "./main-DcPeMQQd.js";
+import { t as RoutesScanner } from "./main-BSWlOK0F.js";
 import "./helpers-DDurYRsZ.js";
 import dedent from "dedent";
 import fs, { readFile, unlink } from "node:fs/promises";
@@ -108,7 +108,7 @@ var Bundler = class {
 			"buildFinished"
 		]);
 		this.#indexGenerator = new IndexGenerator(this.cwdPath, this.ui.logger);
-		await this.#hooks.runner("init").run(this, this.#indexGenerator);
+		await this.#hooks.runner("init").run(this, this.#hooks, this.#indexGenerator);
 		this.#hooks.clear("init");
 		this.ui.logger.info("generating indexes...");
 		await this.#indexGenerator.generate();
@@ -568,7 +568,7 @@ var DevServer = class DevServer {
 		]);
 		this.#registerServerRestartHooks();
 		this.#setupKeyboardShortcuts();
-		await this.#hooks.runner("init").run(this, this.#indexGenerator);
+		await this.#hooks.runner("init").run(this, this.#hooks, this.#indexGenerator);
 		this.#hooks.clear("init");
 		this.ui.logger.info("generating indexes...");
 		await this.#indexGenerator.generate();
@@ -855,7 +855,7 @@ var TestRunner = class {
 			"testsStarting",
 			"testsFinished"
 		]);
-		await this.#hooks.runner("init").run(this, this.#indexGenerator);
+		await this.#hooks.runner("init").run(this, this.#hooks, this.#indexGenerator);
 		this.#hooks.clear("init");
 		this.ui.logger.info("generating indexes...");
 		await this.#indexGenerator.generate();
@@ -888,7 +888,7 @@ var TestRunner = class {
 			"fileRemoved"
 		]);
 		this.#registerServerRestartHooks();
-		await this.#hooks.runner("init").run(this, this.#indexGenerator);
+		await this.#hooks.runner("init").run(this, this.#hooks, this.#indexGenerator);
 		this.#hooks.clear("init");
 		this.ui.logger.info("generating indexes...");
 		await this.#indexGenerator.generate();

package/build/{main-DcPeMQQd.js → main-BSWlOK0F.js}

@@ -79,6 +79,7 @@ async function extractValidators(appRoot, vfs, controller) {
 	}))).filter((value) => !!value);
 }
 var RoutesScanner = class {
+	#filter;
 	#appRoot;
 	#controllerRoutes = {};
 	#scannedRoutes = [];
@@ -88,7 +89,6 @@ var RoutesScanner = class {
 	ui = cliui();
 	pathsResolver;
 	rules = {
-		skip: [],
 		request: {},
 		response: {}
 	};
@@ -96,11 +96,13 @@ var RoutesScanner = class {
 		this.#appRoot = appRoot;
 		this.pathsResolver = new PathsResolver(appRoot);
 		rulesCollection.forEach((rules) => {
-			this.rules.skip = this.rules.skip.concat(rules.skip);
 			Object.assign(this.rules.request, rules.request);
 			Object.assign(this.rules.response, rules.response);
 		});
-		this.rules.skip = Array.from(new Set([...this.rules.skip]));
+	}
+	#shouldSkipRoute(route) {
+		if (this.#filter) return !this.#filter(route);
+		return false;
 	}
 	#prepareRequestTypes(route) {
 		if (!route.validators) return;
@@ -166,16 +168,16 @@ var RoutesScanner = class {
 		const controller = await this.#inspectControllerSpecifier(route.handler.importExpression, route.handler.method);
 		if (!controller) return this.#processRouteWithoutController(route);
 		debug_default("processing route \"%s\" with inspected controller %O", route.name, controller);
-		const routeName = route.name ?? new StringBuilder(controller.name).removeSuffix("Controller").snakeCase().suffix(`.${string.snakeCase(controller.method)}`).toString();
-		if (this.rules.skip.includes(routeName)) return;
+		route.name = route.name ?? new StringBuilder(controller.name).removeSuffix("Controller").snakeCase().suffix(`.${string.snakeCase(controller.method)}`).toString();
+		if (this.#shouldSkipRoute(route)) return;
 		const scannedRoute = {
-			name: routeName,
+			name: route.name,
 			domain: route.domain,
 			methods: route.methods,
 			pattern: route.pattern,
 			tokens: route.tokens,
-			request: this.rules.request[routeName],
-			response: this.rules.response[routeName],
+			request: this.rules.request[route.name],
+			response: this.rules.response[route.name],
 			controller
 		};
 		debug_default("scanned route %O", scannedRoute);
@@ -189,7 +191,7 @@ var RoutesScanner = class {
 		}
 	}
 	async #processRoute(route, vfs) {
-		if (route.name && this.rules.skip.includes(route.name)) {
+		if (route.name && this.#shouldSkipRoute(route)) {
 			debug_default("route skipped route: %O, rules: %O", route, this.rules);
 			return;
 		}
@@ -231,6 +233,10 @@ var RoutesScanner = class {
 		}
 		return true;
 	}
+	filter(filterFn) {
+		this.#filter = filterFn;
+		return this;
+	}
 	async scan(routes) {
 		const vfs = new VirtualFileSystem(this.#appRoot);
 		for (const route of routes) await this.#processRoute(route, vfs);

package/build/src/code_scanners/routes_scanner/main.d.ts

@@ -1,6 +1,6 @@
 import { type AsyncOrSync } from '@poppinss/utils/types';
 import { PathsResolver } from '../../paths_resolver.ts';
-import { type ScannedRoute, type RoutesListItem, type ScannedController, type RoutesScannerRules } from '../../types/code_scanners.ts';
+import { type ScannedRoute, type RoutesListItem, type ScannedController, type RoutesScannerRules, type RoutesScannerFilterFn } from '../../types/code_scanners.ts';
 /**
  * RoutesScanner is responsible for scanning application routes,
  * extracting their controllers, validators, request and response types.
@@ -106,6 +106,18 @@ export declare class RoutesScanner {
      * @param controllerPath - Path to the controller file to invalidate
      */
     invalidate(controllerPath: string): Promise<boolean>;
+    /**
+     * Sets a filter function to selectively include routes during scanning.
+     *
+     * @param filterFn - Function that returns true for routes to include
+     * @returns This RoutesScanner instance for method chaining
+     *
+     * @example
+     * scanner.filter((route) => {
+     *   return route.pattern.startsWith('/api')
+     * })
+     */
+    filter(filterFn: RoutesScannerFilterFn): this;
     /**
      * Scans an array of Route list items and fetches their validators,
      * controllers, and request/response types.

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

@@ -1,4 +1,4 @@
 import "../../../virtual_file_system-bGeoWsK-.js";
-import { t as RoutesScanner } from "../../../main-DcPeMQQd.js";
+import { t as RoutesScanner } from "../../../main-BSWlOK0F.js";
 import "../../../helpers-DDurYRsZ.js";
 export { RoutesScanner };

package/build/src/types/code_scanners.d.ts

@@ -174,8 +174,11 @@ export type RoutesListItem = {
     domain: string;
     /** HTTP methods accepted by this route */
     methods: string[];
+    /** Handler information for controller-based routes */
     handler?: {
+        /** The method name to be called on the controller */
         method: string;
+        /** Dynamic import expression that loads the controller module */
         importExpression: string | null;
     };
     /** Parsed route tokens for URI construction */
@@ -186,6 +189,27 @@ export type RoutesListItem = {
         end: string;
     }[];
 };
+/**
+ * A filter function to exclude routes from being processed by the routes scanner.
+ * Return false to filter out (exclude) the route, or true to include it.
+ *
+ * @example
+ * const filterFn: RoutesScannerFilterFn = (route) => {
+ *   // Exclude all admin routes
+ *   if (route.pattern.startsWith('/admin')) {
+ *     return false
+ *   }
+ *
+ *   // Exclude health check routes
+ *   if (route.name === 'health.check') {
+ *     return false
+ *   }
+ *
+ *   // Include all other routes
+ *   return true
+ * }
+ */
+export type RoutesScannerFilterFn = (route: RoutesListItem) => boolean;
 /**
  * Configuration rules accepted by the routes scanner to customize
  * the scanning behavior and override type inference.
@@ -208,11 +232,6 @@ export type RoutesListItem = {
  * }
  */
 export type RoutesScannerRules = {
-    /**
-     * An array of route names or controller+method paths to skip from processing.
-     * Useful for excluding routes that don't need type generation.
-     */
-    skip: string[];
     /**
      * Define custom response types for specific routes by their name
      * or controller+method path. Overrides automatic type inference.

package/build/src/types/hooks.d.ts

@@ -6,6 +6,7 @@ import { type TestRunner } from '../test_runner.ts';
 import { type RoutesListItem } from './code_scanners.ts';
 import { type IndexGenerator } from '../index_generator/main.ts';
 import { type RoutesScanner } from '../code_scanners/routes_scanner/main.ts';
+import type Hooks from '@poppinss/hooks';
 /**
  * Defines a hook that can be either a lazy import or an object with a run method.
  * This type provides flexibility in how hooks are defined and imported, supporting
@@ -45,7 +46,9 @@ export type CommonHooks = {
      *
      * @param parent - The parent instance (DevServer, TestRunner, or Bundler)
      */
-    init: DefineHook<(parent: DevServer | TestRunner | Bundler, indexGenerator: IndexGenerator) => AsyncOrSync<void>>[];
+    init: DefineHook<(parent: DevServer | TestRunner | Bundler, hooks: Hooks<{
+        [P in keyof AllHooks]: [HookParams<P>, HookParams<P>];
+    }>, indexGenerator: IndexGenerator) => AsyncOrSync<void>>[];
 };
 /**
  * Hooks executed by the dev server around the router.

package/build/src/utils.d.ts

@@ -148,7 +148,9 @@ export declare function isRelative(pathValue: string): boolean;
  * @param names - Array of hook names to load
  * @returns Promise resolving to configured Hooks instance
  */
-export declare function loadHooks<K extends keyof AllHooks>(rcFileHooks: Partial<AllHooks> | undefined, names: K[]): Promise<Hooks<{ [P in K]: [HookParams<P>, HookParams<P>]; }>>;
+export declare function loadHooks<K extends keyof AllHooks>(rcFileHooks: Partial<AllHooks> | undefined, names: K[]): Promise<Hooks<{
+    [P in K]: [HookParams<P>, HookParams<P>];
+}>>;
 /**
  * Wraps a function inside another function that throttles the concurrent
  * executions of a function. If the function is called too quickly, then

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@adonisjs/assembler",
   "description": "Provides utilities to run AdonisJS development server and build project for production",
-  "version": "8.0.0-next.24",
+  "version": "8.0.0-next.26",
   "engines": {
     "node": ">=24.0.0"
   },