clear-router 2.8.1 → 2.8.2

package/dist/core/helpers.cjs

@@ -1,9 +1,32 @@
+let node_path = require("node:path");
+let jiti = require("jiti");
+let node_url = require("node:url");
 
 //#region src/core/helpers.ts
 const wrap = (value) => {
 	if (value === null || value === void 0) return [];
 	return Array.isArray(value) ? value : [value];
 };
+/**
+* 
+* Dynamically imports a file at the given path with full TypeScript support,
+* including `tsconfig.json` path aliases. 
+*
+* @param filePath - The path to the file to import. 
+* @returns The imported module typed as `T`.
+*
+* @example
+* const config = await importFile<AppConfig>('./config/app.ts')
+*/
+const importFile = async (filePath, userOptions, resolveOptions) => {
+	const resolvedPath = (0, node_path.resolve)(filePath);
+	return await (0, jiti.createJiti)((0, node_url.pathToFileURL)(resolvedPath).href, {
+		...userOptions,
+		interopDefault: false,
+		tsconfigPaths: true
+	}).import(resolvedPath, resolveOptions);
+};
 
 //#endregion
+exports.importFile = importFile;
 exports.wrap = wrap;

package/dist/core/helpers.d.cts

@@ -1,4 +1,18 @@
+import { FileImporter } from "../types/basic.cjs";
+
 //#region src/core/helpers.d.ts
 declare const wrap: <T>(value: T | T[] | null | undefined) => T[];
+/**
+*
+* Dynamically imports a file at the given path with full TypeScript support,
+* including `tsconfig.json` path aliases.
+*
+* @param filePath - The path to the file to import.
+* @returns The imported module typed as `T`.
+*
+* @example
+* const config = await importFile<AppConfig>('./config/app.ts')
+*/
+declare const importFile: FileImporter;
 //#endregion
-export { wrap };
+export { importFile, wrap };

package/dist/core/helpers.d.mts

@@ -1,4 +1,17 @@
+import { FileImporter } from "../types/basic.mjs";
 //#region src/core/helpers.d.ts
 declare const wrap: <T>(value: T | T[] | null | undefined) => T[];
+/**
+*
+* Dynamically imports a file at the given path with full TypeScript support,
+* including `tsconfig.json` path aliases.
+*
+* @param filePath - The path to the file to import.
+* @returns The imported module typed as `T`.
+*
+* @example
+* const config = await importFile<AppConfig>('./config/app.ts')
+*/
+declare const importFile: FileImporter;
 //#endregion
-export { wrap };
+export { importFile, wrap };

package/dist/core/helpers.mjs

@@ -1,8 +1,31 @@
+import { resolve } from "node:path";
+import { createJiti } from "jiti";
+import { pathToFileURL } from "node:url";
+
 //#region src/core/helpers.ts
 const wrap = (value) => {
 	if (value === null || value === void 0) return [];
 	return Array.isArray(value) ? value : [value];
 };
+/**
+* 
+* Dynamically imports a file at the given path with full TypeScript support,
+* including `tsconfig.json` path aliases. 
+*
+* @param filePath - The path to the file to import. 
+* @returns The imported module typed as `T`.
+*
+* @example
+* const config = await importFile<AppConfig>('./config/app.ts')
+*/
+const importFile = async (filePath, userOptions, resolveOptions) => {
+	const resolvedPath = resolve(filePath);
+	return await createJiti(pathToFileURL(resolvedPath).href, {
+		...userOptions,
+		interopDefault: false,
+		tsconfigPaths: true
+	}).import(resolvedPath, resolveOptions);
+};
 
 //#endregion
-export { wrap };
+export { importFile, wrap };

package/dist/core/index.cjs

@@ -1,12 +1,5 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_Request = require('./Request.cjs');
 const require_Response = require('./Response.cjs');
 const require_plugins = require('./plugins.cjs');
-const require_router = require('./router.cjs');
 const require_helpers = require('./helpers.cjs');
-
-exports.CoreRouter = require_router.CoreRouter;
-exports.Request = require_Request.Request;
-exports.Response = require_Response.Response;
-exports.definePlugin = require_plugins.definePlugin;
-exports.wrap = require_helpers.wrap;
+const require_router = require('./router.cjs');

package/dist/core/index.d.cts

@@ -2,5 +2,5 @@ import { Response } from "./Response.cjs";
 import { Request } from "./Request.cjs";
 import { ClearRouterPlugin, ClearRouterPluginArgumentsContext, ClearRouterPluginContext, ClearRouterPluginInput, ClearRouterPluginRequestContext, PluginArgumentsResolver, PluginBind, PluginBindFactory, PluginBindValue, PluginSetupResult, definePlugin } from "./plugins.cjs";
 import { CoreRouter } from "./router.cjs";
-import { wrap } from "./helpers.cjs";
-export { ClearRouterPlugin, ClearRouterPluginArgumentsContext, ClearRouterPluginContext, ClearRouterPluginInput, ClearRouterPluginRequestContext, CoreRouter, PluginArgumentsResolver, PluginBind, PluginBindFactory, PluginBindValue, PluginSetupResult, Request, Response, definePlugin, wrap };
+import { importFile, wrap } from "./helpers.cjs";
+export { ClearRouterPlugin, ClearRouterPluginArgumentsContext, ClearRouterPluginContext, ClearRouterPluginInput, ClearRouterPluginRequestContext, CoreRouter, PluginArgumentsResolver, PluginBind, PluginBindFactory, PluginBindValue, PluginSetupResult, Request, Response, definePlugin, importFile, wrap };

package/dist/core/index.d.mts

@@ -2,5 +2,5 @@ import { Response } from "./Response.mjs";
 import { Request } from "./Request.mjs";
 import { ClearRouterPlugin, ClearRouterPluginArgumentsContext, ClearRouterPluginContext, ClearRouterPluginInput, ClearRouterPluginRequestContext, PluginArgumentsResolver, PluginBind, PluginBindFactory, PluginBindValue, PluginSetupResult, definePlugin } from "./plugins.mjs";
 import { CoreRouter } from "./router.mjs";
-import { wrap } from "./helpers.mjs";
-export { ClearRouterPlugin, ClearRouterPluginArgumentsContext, ClearRouterPluginContext, ClearRouterPluginInput, ClearRouterPluginRequestContext, CoreRouter, PluginArgumentsResolver, PluginBind, PluginBindFactory, PluginBindValue, PluginSetupResult, Request, Response, definePlugin, wrap };
+import { importFile, wrap } from "./helpers.mjs";
+export { ClearRouterPlugin, ClearRouterPluginArgumentsContext, ClearRouterPluginContext, ClearRouterPluginInput, ClearRouterPluginRequestContext, CoreRouter, PluginArgumentsResolver, PluginBind, PluginBindFactory, PluginBindValue, PluginSetupResult, Request, Response, definePlugin, importFile, wrap };

package/dist/core/index.mjs

@@ -1,7 +1,7 @@
 import { Request } from "./Request.mjs";
 import { Response } from "./Response.mjs";
 import { definePlugin } from "./plugins.mjs";
+import { importFile, wrap } from "./helpers.mjs";
 import { CoreRouter } from "./router.mjs";
-import { wrap } from "./helpers.mjs";
 
-export { CoreRouter, Request, Response, definePlugin, wrap };
+export { CoreRouter, Request, Response, definePlugin, importFile, wrap };

package/dist/core/router.cjs

@@ -3,6 +3,9 @@ const require_Response = require('./Response.cjs');
 const require_bindings = require('./bindings.cjs');
 const require_ResourceRoutes = require('../ResourceRoutes.cjs');
 const require_Route = require('../Route.cjs');
+const require_helpers = require('./helpers.cjs');
+let node_path = require("node:path");
+let node_fs_promises = require("node:fs/promises");
 let node_async_hooks = require("node:async_hooks");
 let node_module = require("node:module");
 
@@ -640,7 +643,7 @@ var CoreRouter = class {
 	* @param callback 
 	* @param middlewares 
 	*/
-	static async group(prefix, callback, middlewares) {
+	static async group(prefix, source, middlewares) {
 		this.ensureState();
 		const context = this.groupContext.getStore();
 		const previousPrefix = context?.prefix ?? this.prefix;
@@ -651,9 +654,35 @@ var CoreRouter = class {
 			groupMiddlewares: [...previousMiddlewares, ...middlewares || []]
 		};
 		await this.groupContext.run(nextContext, async () => {
-			await Promise.resolve(callback());
+			if (typeof source === "function") {
+				await Promise.resolve(source());
+				return;
+			}
+			for (const file of await this.resolveGroupFiles(source)) await require_helpers.importFile(file);
 		});
 	}
+	static async resolveGroupFiles(source) {
+		const resolved = (0, node_path.isAbsolute)(source) ? source : (0, node_path.resolve)(process.cwd(), source);
+		let sourceStat;
+		try {
+			sourceStat = await (0, node_fs_promises.stat)(resolved);
+		} catch {
+			throw new Error(`Route group source not found: ${source}`);
+		}
+		if (sourceStat.isFile()) return [resolved];
+		if (!sourceStat.isDirectory()) throw new Error(`Route group source must be a file or directory: ${source}`);
+		return this.readGroupDirectory(resolved);
+	}
+	static async readGroupDirectory(directory) {
+		const entries = await (0, node_fs_promises.readdir)(directory, { withFileTypes: true });
+		const files = [];
+		for (const entry of entries.sort((left, right) => left.name.localeCompare(right.name))) {
+			const path = (0, node_path.join)(directory, entry.name);
+			if (entry.isDirectory()) files.push(...await this.readGroupDirectory(path));
+			else if (entry.isFile() && /\.(?:[cm]?ts)$/.test(entry.name) && !entry.name.endsWith(".d.ts")) files.push(path);
+		}
+		return files;
+	}
 	/**
 	* Adds global middlewares to the router, which will be applied to all routes.
 	* 

package/dist/core/router.d.cts

@@ -1,4 +1,4 @@
-import { ApiResourceMiddleware, HttpMethod, ResourceAction, RouterConfig } from "../types/basic.cjs";
+import { ApiResourceMiddleware, HttpMethod, ResourceAction, RouteGroupSource, RouterConfig } from "../types/basic.cjs";
 import { Response } from "./Response.cjs";
 import { Route } from "../Route.cjs";
 import { Request } from "./Request.cjs";
@@ -219,7 +219,9 @@ declare abstract class CoreRouter {
    * @param callback
    * @param middlewares
    */
-  static group(prefix: string, callback: () => void | Promise<void>, middlewares?: any[]): Promise<void>;
+  static group(prefix: string, source: RouteGroupSource, middlewares?: any[]): Promise<void>;
+  protected static resolveGroupFiles(source: string): Promise<string[]>;
+  protected static readGroupDirectory(directory: string): Promise<string[]>;
   /**
    * Adds global middlewares to the router, which will be applied to all routes.
    *

package/dist/core/router.d.mts

@@ -1,4 +1,4 @@
-import { ApiResourceMiddleware, HttpMethod, ResourceAction, RouterConfig } from "../types/basic.mjs";
+import { ApiResourceMiddleware, HttpMethod, ResourceAction, RouteGroupSource, RouterConfig } from "../types/basic.mjs";
 import { Response } from "./Response.mjs";
 import { Route } from "../Route.mjs";
 import { Request } from "./Request.mjs";
@@ -219,7 +219,9 @@ declare abstract class CoreRouter {
    * @param callback
    * @param middlewares
    */
-  static group(prefix: string, callback: () => void | Promise<void>, middlewares?: any[]): Promise<void>;
+  static group(prefix: string, source: RouteGroupSource, middlewares?: any[]): Promise<void>;
+  protected static resolveGroupFiles(source: string): Promise<string[]>;
+  protected static readGroupDirectory(directory: string): Promise<string[]>;
   /**
    * Adds global middlewares to the router, which will be applied to all routes.
    *

package/dist/core/router.mjs

@@ -3,7 +3,10 @@ import { Response } from "./Response.mjs";
 import { Container, getBindingMetadataFromTargets, getDesignParamTypes, getStandardMetadata, isClass } from "./bindings.mjs";
 import { ResourceRoutes } from "../ResourceRoutes.mjs";
 import { Route } from "../Route.mjs";
+import { importFile } from "./helpers.mjs";
 import { createRequire } from "node:module";
+import { isAbsolute, join, resolve } from "node:path";
+import { readdir, stat } from "node:fs/promises";
 import { AsyncLocalStorage } from "node:async_hooks";
 
 //#region src/core/router.ts
@@ -640,7 +643,7 @@ var CoreRouter = class {
 	* @param callback 
 	* @param middlewares 
 	*/
-	static async group(prefix, callback, middlewares) {
+	static async group(prefix, source, middlewares) {
 		this.ensureState();
 		const context = this.groupContext.getStore();
 		const previousPrefix = context?.prefix ?? this.prefix;
@@ -651,9 +654,35 @@ var CoreRouter = class {
 			groupMiddlewares: [...previousMiddlewares, ...middlewares || []]
 		};
 		await this.groupContext.run(nextContext, async () => {
-			await Promise.resolve(callback());
+			if (typeof source === "function") {
+				await Promise.resolve(source());
+				return;
+			}
+			for (const file of await this.resolveGroupFiles(source)) await importFile(file);
 		});
 	}
+	static async resolveGroupFiles(source) {
+		const resolved = isAbsolute(source) ? source : resolve(process.cwd(), source);
+		let sourceStat;
+		try {
+			sourceStat = await stat(resolved);
+		} catch {
+			throw new Error(`Route group source not found: ${source}`);
+		}
+		if (sourceStat.isFile()) return [resolved];
+		if (!sourceStat.isDirectory()) throw new Error(`Route group source must be a file or directory: ${source}`);
+		return this.readGroupDirectory(resolved);
+	}
+	static async readGroupDirectory(directory) {
+		const entries = await readdir(directory, { withFileTypes: true });
+		const files = [];
+		for (const entry of entries.sort((left, right) => left.name.localeCompare(right.name))) {
+			const path = join(directory, entry.name);
+			if (entry.isDirectory()) files.push(...await this.readGroupDirectory(path));
+			else if (entry.isFile() && /\.(?:[cm]?ts)$/.test(entry.name) && !entry.name.endsWith(".d.ts")) files.push(path);
+		}
+		return files;
+	}
 	/**
 	* Adds global middlewares to the router, which will be applied to all routes.
 	* 

package/dist/express/router.cjs

@@ -141,8 +141,8 @@ var Router = class Router extends require_router.CoreRouter {
 	* @param callback 
 	* @param middlewares 
 	*/
-	static async group(prefix, callback, middlewares) {
-		await super.group(prefix, callback, middlewares);
+	static async group(prefix, source, middlewares) {
+		await super.group(prefix, source, middlewares);
 	}
 	/**
 	* Adds global middlewares to the router, which will be applied to all routes.

package/dist/express/router.d.cts

@@ -1,4 +1,4 @@
-import { ApiResourceMiddleware, HttpMethod, ResourceAction } from "../types/basic.cjs";
+import { ApiResourceMiddleware, HttpMethod, ResourceAction, RouteGroupSource } from "../types/basic.cjs";
 import { Handler, HttpContext, Middleware } from "../types/express.cjs";
 import { Route } from "../Route.cjs";
 import { ResourceRoutes } from "../ResourceRoutes.cjs";
@@ -101,7 +101,7 @@ declare class Router$1 extends CoreRouter {
    * @param callback
    * @param middlewares
    */
-  static group(prefix: string, callback: () => void | Promise<void>, middlewares?: Middleware[]): Promise<void>;
+  static group(prefix: string, source: RouteGroupSource, middlewares?: Middleware[]): Promise<void>;
   /**
    * Adds global middlewares to the router, which will be applied to all routes.
    *

package/dist/express/router.d.mts

@@ -1,4 +1,4 @@
-import { ApiResourceMiddleware, HttpMethod, ResourceAction } from "../types/basic.mjs";
+import { ApiResourceMiddleware, HttpMethod, ResourceAction, RouteGroupSource } from "../types/basic.mjs";
 import { Handler, HttpContext, Middleware } from "../types/express.mjs";
 import { Route } from "../Route.mjs";
 import { ResourceRoutes } from "../ResourceRoutes.mjs";
@@ -101,7 +101,7 @@ declare class Router$1 extends CoreRouter {
    * @param callback
    * @param middlewares
    */
-  static group(prefix: string, callback: () => void | Promise<void>, middlewares?: Middleware[]): Promise<void>;
+  static group(prefix: string, source: RouteGroupSource, middlewares?: Middleware[]): Promise<void>;
   /**
    * Adds global middlewares to the router, which will be applied to all routes.
    *

package/dist/express/router.mjs

@@ -141,8 +141,8 @@ var Router = class Router extends CoreRouter {
 	* @param callback 
 	* @param middlewares 
 	*/
-	static async group(prefix, callback, middlewares) {
-		await super.group(prefix, callback, middlewares);
+	static async group(prefix, source, middlewares) {
+		await super.group(prefix, source, middlewares);
 	}
 	/**
 	* Adds global middlewares to the router, which will be applied to all routes.

package/dist/fastify/router.cjs

@@ -134,8 +134,8 @@ var Router = class Router extends require_router.CoreRouter {
 	* @param callback 
 	* @param middlewares 
 	*/
-	static async group(prefix, callback, middlewares) {
-		await super.group(prefix, callback, middlewares);
+	static async group(prefix, source, middlewares) {
+		await super.group(prefix, source, middlewares);
 	}
 	/**
 	* Apply middlewares to a group of routes defined within the callback

package/dist/fastify/router.d.cts

@@ -1,4 +1,4 @@
-import { ApiResourceMiddleware, HttpMethod, ResourceAction } from "../types/basic.cjs";
+import { ApiResourceMiddleware, HttpMethod, ResourceAction, RouteGroupSource } from "../types/basic.cjs";
 import { FastifyApp, Handler, HttpContext, Middleware } from "../types/fastify.cjs";
 import { Route } from "../Route.cjs";
 import { ResourceRoutes } from "../ResourceRoutes.cjs";
@@ -99,7 +99,7 @@ declare class Router extends CoreRouter {
    * @param callback
    * @param middlewares
    */
-  static group(prefix: string, callback: () => void | Promise<void>, middlewares?: Middleware[]): Promise<void>;
+  static group(prefix: string, source: RouteGroupSource, middlewares?: Middleware[]): Promise<void>;
   /**
    * Apply middlewares to a group of routes defined within the callback
    *

package/dist/fastify/router.d.mts

@@ -1,4 +1,4 @@
-import { ApiResourceMiddleware, HttpMethod, ResourceAction } from "../types/basic.mjs";
+import { ApiResourceMiddleware, HttpMethod, ResourceAction, RouteGroupSource } from "../types/basic.mjs";
 import { FastifyApp, Handler, HttpContext, Middleware } from "../types/fastify.mjs";
 import { Route } from "../Route.mjs";
 import { ResourceRoutes } from "../ResourceRoutes.mjs";
@@ -99,7 +99,7 @@ declare class Router extends CoreRouter {
    * @param callback
    * @param middlewares
    */
-  static group(prefix: string, callback: () => void | Promise<void>, middlewares?: Middleware[]): Promise<void>;
+  static group(prefix: string, source: RouteGroupSource, middlewares?: Middleware[]): Promise<void>;
   /**
    * Apply middlewares to a group of routes defined within the callback
    *

package/dist/fastify/router.mjs

@@ -134,8 +134,8 @@ var Router = class Router extends CoreRouter {
 	* @param callback 
 	* @param middlewares 
 	*/
-	static async group(prefix, callback, middlewares) {
-		await super.group(prefix, callback, middlewares);
+	static async group(prefix, source, middlewares) {
+		await super.group(prefix, source, middlewares);
 	}
 	/**
 	* Apply middlewares to a group of routes defined within the callback

package/dist/h3/router.cjs

@@ -143,8 +143,8 @@ var Router = class Router extends require_router.CoreRouter {
 	* @param callback 
 	* @param middlewares 
 	*/
-	static async group(prefix, callback, middlewares) {
-		await super.group(prefix, callback, middlewares);
+	static async group(prefix, source, middlewares) {
+		await super.group(prefix, source, middlewares);
 	}
 	/**
 	* Adds global middlewares to the router, which will be applied to all routes.

package/dist/h3/router.d.cts

@@ -1,4 +1,4 @@
-import { ApiResourceMiddleware, HttpMethod, ResourceAction } from "../types/basic.cjs";
+import { ApiResourceMiddleware, HttpMethod, ResourceAction, RouteGroupSource } from "../types/basic.cjs";
 import { H3App, Handler, HttpContext, Middleware as Middleware$1 } from "../types/h3.cjs";
 import { Route } from "../Route.cjs";
 import { ResourceRoutes } from "../ResourceRoutes.cjs";
@@ -101,7 +101,7 @@ declare class Router extends CoreRouter {
    * @param callback
    * @param middlewares
    */
-  static group(prefix: string, callback: () => void | Promise<void>, middlewares?: Middleware$1[]): Promise<void>;
+  static group(prefix: string, source: RouteGroupSource, middlewares?: Middleware$1[]): Promise<void>;
   /**
    * Adds global middlewares to the router, which will be applied to all routes.
    *

package/dist/h3/router.d.mts

@@ -1,4 +1,4 @@
-import { ApiResourceMiddleware, HttpMethod, ResourceAction } from "../types/basic.mjs";
+import { ApiResourceMiddleware, HttpMethod, ResourceAction, RouteGroupSource } from "../types/basic.mjs";
 import { H3App, Handler, HttpContext, Middleware as Middleware$1 } from "../types/h3.mjs";
 import { Route } from "../Route.mjs";
 import { ResourceRoutes } from "../ResourceRoutes.mjs";
@@ -101,7 +101,7 @@ declare class Router extends CoreRouter {
    * @param callback
    * @param middlewares
    */
-  static group(prefix: string, callback: () => void | Promise<void>, middlewares?: Middleware$1[]): Promise<void>;
+  static group(prefix: string, source: RouteGroupSource, middlewares?: Middleware$1[]): Promise<void>;
   /**
    * Adds global middlewares to the router, which will be applied to all routes.
    *

package/dist/h3/router.mjs

@@ -143,8 +143,8 @@ var Router = class Router extends CoreRouter {
 	* @param callback 
 	* @param middlewares 
 	*/
-	static async group(prefix, callback, middlewares) {
-		await super.group(prefix, callback, middlewares);
+	static async group(prefix, source, middlewares) {
+		await super.group(prefix, source, middlewares);
 	}
 	/**
 	* Adds global middlewares to the router, which will be applied to all routes.

package/dist/hono/router.cjs

@@ -147,8 +147,8 @@ var Router = class Router extends require_router.CoreRouter {
 	* @param callback 
 	* @param middlewares 
 	*/
-	static async group(prefix, callback, middlewares) {
-		await super.group(prefix, callback, middlewares);
+	static async group(prefix, source, middlewares) {
+		await super.group(prefix, source, middlewares);
 	}
 	/**
 	* Apply middlewares to a group of routes defined within the callback

package/dist/hono/router.d.cts

@@ -1,4 +1,4 @@
-import { ApiResourceMiddleware, HttpMethod, ResourceAction } from "../types/basic.cjs";
+import { ApiResourceMiddleware, HttpMethod, ResourceAction, RouteGroupSource } from "../types/basic.cjs";
 import { Handler, HonoApp, HttpContext, Middleware } from "../types/hono.cjs";
 import { Route } from "../Route.cjs";
 import { ResourceRoutes } from "../ResourceRoutes.cjs";
@@ -101,7 +101,7 @@ declare class Router extends CoreRouter {
    * @param callback
    * @param middlewares
    */
-  static group(prefix: string, callback: () => void | Promise<void>, middlewares?: Middleware[]): Promise<void>;
+  static group(prefix: string, source: RouteGroupSource, middlewares?: Middleware[]): Promise<void>;
   /**
    * Apply middlewares to a group of routes defined within the callback
    *

package/dist/hono/router.d.mts

@@ -1,4 +1,4 @@
-import { ApiResourceMiddleware, HttpMethod, ResourceAction } from "../types/basic.mjs";
+import { ApiResourceMiddleware, HttpMethod, ResourceAction, RouteGroupSource } from "../types/basic.mjs";
 import { Handler, HonoApp, HttpContext, Middleware } from "../types/hono.mjs";
 import { Route } from "../Route.mjs";
 import { ResourceRoutes } from "../ResourceRoutes.mjs";
@@ -101,7 +101,7 @@ declare class Router extends CoreRouter {
    * @param callback
    * @param middlewares
    */
-  static group(prefix: string, callback: () => void | Promise<void>, middlewares?: Middleware[]): Promise<void>;
+  static group(prefix: string, source: RouteGroupSource, middlewares?: Middleware[]): Promise<void>;
   /**
    * Apply middlewares to a group of routes defined within the callback
    *

package/dist/hono/router.mjs

@@ -147,8 +147,8 @@ var Router = class Router extends CoreRouter {
 	* @param callback 
 	* @param middlewares 
 	*/
-	static async group(prefix, callback, middlewares) {
-		await super.group(prefix, callback, middlewares);
+	static async group(prefix, source, middlewares) {
+		await super.group(prefix, source, middlewares);
 	}
 	/**
 	* Apply middlewares to a group of routes defined within the callback

package/dist/index.cjs

@@ -5,8 +5,8 @@ const require_Route = require('./Route.cjs');
 const require_Request = require('./core/Request.cjs');
 const require_Response = require('./core/Response.cjs');
 const require_plugins = require('./core/plugins.cjs');
-const require_router = require('./core/router.cjs');
 const require_helpers = require('./core/helpers.cjs');
+const require_router = require('./core/router.cjs');
 require('./core/index.cjs');
 
 exports.ClearRequest = require_ClearRequest.ClearRequest;
@@ -16,4 +16,5 @@ exports.Request = require_Request.Request;
 exports.Response = require_Response.Response;
 exports.Route = require_Route.Route;
 exports.definePlugin = require_plugins.definePlugin;
+exports.importFile = require_helpers.importFile;
 exports.wrap = require_helpers.wrap;

package/dist/index.d.cts

@@ -6,5 +6,5 @@ import { ClearRequest } from "./ClearRequest.cjs";
 import { Controller } from "./Controller.cjs";
 import { ClearRouterPlugin, ClearRouterPluginArgumentsContext, ClearRouterPluginContext, ClearRouterPluginInput, ClearRouterPluginRequestContext, PluginArgumentsResolver, PluginBind, PluginBindFactory, PluginBindValue, PluginSetupResult, definePlugin } from "./core/plugins.cjs";
 import { CoreRouter } from "./core/router.cjs";
-import { wrap } from "./core/helpers.cjs";
-export { ClearHttpContext, ClearRequest, ClearRouterPlugin, ClearRouterPluginArgumentsContext, ClearRouterPluginContext, ClearRouterPluginInput, ClearRouterPluginRequestContext, Controller, CoreRouter, PluginArgumentsResolver, PluginBind, PluginBindFactory, PluginBindValue, PluginSetupResult, Request, Response, Route, RouteParameter, definePlugin, wrap };
+import { importFile, wrap } from "./core/helpers.cjs";
+export { ClearHttpContext, ClearRequest, ClearRouterPlugin, ClearRouterPluginArgumentsContext, ClearRouterPluginContext, ClearRouterPluginInput, ClearRouterPluginRequestContext, Controller, CoreRouter, PluginArgumentsResolver, PluginBind, PluginBindFactory, PluginBindValue, PluginSetupResult, Request, Response, Route, RouteParameter, definePlugin, importFile, wrap };

package/dist/index.d.mts

@@ -6,5 +6,5 @@ import { ClearRequest } from "./ClearRequest.mjs";
 import { Controller } from "./Controller.mjs";
 import { ClearRouterPlugin, ClearRouterPluginArgumentsContext, ClearRouterPluginContext, ClearRouterPluginInput, ClearRouterPluginRequestContext, PluginArgumentsResolver, PluginBind, PluginBindFactory, PluginBindValue, PluginSetupResult, definePlugin } from "./core/plugins.mjs";
 import { CoreRouter } from "./core/router.mjs";
-import { wrap } from "./core/helpers.mjs";
-export { ClearHttpContext, ClearRequest, ClearRouterPlugin, ClearRouterPluginArgumentsContext, ClearRouterPluginContext, ClearRouterPluginInput, ClearRouterPluginRequestContext, Controller, CoreRouter, PluginArgumentsResolver, PluginBind, PluginBindFactory, PluginBindValue, PluginSetupResult, Request, Response, Route, RouteParameter, definePlugin, wrap };
+import { importFile, wrap } from "./core/helpers.mjs";
+export { ClearHttpContext, ClearRequest, ClearRouterPlugin, ClearRouterPluginArgumentsContext, ClearRouterPluginContext, ClearRouterPluginInput, ClearRouterPluginRequestContext, Controller, CoreRouter, PluginArgumentsResolver, PluginBind, PluginBindFactory, PluginBindValue, PluginSetupResult, Request, Response, Route, RouteParameter, definePlugin, importFile, wrap };

package/dist/index.mjs

@@ -4,8 +4,8 @@ import { Route } from "./Route.mjs";
 import { Request } from "./core/Request.mjs";
 import { Response } from "./core/Response.mjs";
 import { definePlugin } from "./core/plugins.mjs";
+import { importFile, wrap } from "./core/helpers.mjs";
 import { CoreRouter } from "./core/router.mjs";
-import { wrap } from "./core/helpers.mjs";
 import "./core/index.mjs";
 
-export { ClearRequest, Controller, CoreRouter, Request, Response, Route, definePlugin, wrap };
+export { ClearRequest, Controller, CoreRouter, Request, Response, Route, definePlugin, importFile, wrap };

package/dist/koa/router.cjs

@@ -157,8 +157,8 @@ var Router = class Router extends require_router.CoreRouter {
 	* @param callback
 	* @param middlewares
 	*/
-	static async group(prefix, callback, middlewares) {
-		await super.group(prefix, callback, middlewares);
+	static async group(prefix, source, middlewares) {
+		await super.group(prefix, source, middlewares);
 	}
 	/**
 	* Apply middlewares to a group of routes defined within the callback

package/dist/koa/router.d.cts

@@ -1,4 +1,4 @@
-import { ApiResourceMiddleware, HttpMethod, ResourceAction } from "../types/basic.cjs";
+import { ApiResourceMiddleware, HttpMethod, ResourceAction, RouteGroupSource } from "../types/basic.cjs";
 import { Handler, HttpContext, KoaRouterApp, Middleware } from "../types/koa.cjs";
 import { Route } from "../Route.cjs";
 import { ResourceRoutes } from "../ResourceRoutes.cjs";
@@ -102,7 +102,7 @@ declare class Router extends CoreRouter {
    * @param callback
    * @param middlewares
    */
-  static group(prefix: string, callback: () => void | Promise<void>, middlewares?: Middleware[]): Promise<void>;
+  static group(prefix: string, source: RouteGroupSource, middlewares?: Middleware[]): Promise<void>;
   /**
    * Apply middlewares to a group of routes defined within the callback
    *

package/dist/koa/router.d.mts

@@ -1,4 +1,4 @@
-import { ApiResourceMiddleware, HttpMethod, ResourceAction } from "../types/basic.mjs";
+import { ApiResourceMiddleware, HttpMethod, ResourceAction, RouteGroupSource } from "../types/basic.mjs";
 import { Handler, HttpContext, KoaRouterApp, Middleware } from "../types/koa.mjs";
 import { Route } from "../Route.mjs";
 import { ResourceRoutes } from "../ResourceRoutes.mjs";
@@ -102,7 +102,7 @@ declare class Router extends CoreRouter {
    * @param callback
    * @param middlewares
    */
-  static group(prefix: string, callback: () => void | Promise<void>, middlewares?: Middleware[]): Promise<void>;
+  static group(prefix: string, source: RouteGroupSource, middlewares?: Middleware[]): Promise<void>;
   /**
    * Apply middlewares to a group of routes defined within the callback
    *

package/dist/koa/router.mjs

@@ -157,8 +157,8 @@ var Router = class Router extends CoreRouter {
 	* @param callback
 	* @param middlewares
 	*/
-	static async group(prefix, callback, middlewares) {
-		await super.group(prefix, callback, middlewares);
+	static async group(prefix, source, middlewares) {
+		await super.group(prefix, source, middlewares);
 	}
 	/**
 	* Apply middlewares to a group of routes defined within the callback

package/dist/types/basic.d.cts

@@ -1,9 +1,13 @@
+import { JitiOptions, JitiResolveOptions } from "jiti";
+
 //#region src/types/basic.d.ts
 /**
  * Controller method reference
  */
 type ControllerHandler = [any, string];
 type MaybePromise<T = any> = T | Promise<T>;
+type RouteGroupCallback = () => MaybePromise<void>;
+type RouteGroupSource = RouteGroupCallback | string;
 type MiddlewareHandle<Args extends any[] = any[], Return = any> = (...args: Args) => MaybePromise<Return>;
 type MiddlewareClass<M extends MiddlewareHandle = MiddlewareHandle> = new () => {
   handle: M;
@@ -48,5 +52,12 @@ interface RouterConfig {
     autoDiscover?: boolean;
   };
 }
+interface FileImporter {
+  <T = unknown>(filePath: string): Promise<T>;
+  <T = unknown>(filePath: string, userOptions?: JitiOptions | undefined): Promise<T>;
+  <T = unknown>(filePath: string, userOptions?: JitiOptions | undefined, resolveOptions?: (JitiResolveOptions & {
+    default?: true;
+  })): Promise<T>;
+}
 //#endregion
-export { ApiResourceMiddleware, ClassMiddleware, ControllerHandler, HttpMethod, MiddlewareHandle, RequestData, ResourceAction, RouterConfig };
+export { ApiResourceMiddleware, ClassMiddleware, ControllerHandler, FileImporter, HttpMethod, MiddlewareHandle, RequestData, ResourceAction, RouteGroupSource, RouterConfig };

package/dist/types/basic.d.mts

@@ -1,9 +1,13 @@
+import { JitiOptions, JitiResolveOptions } from "jiti";
+
 //#region src/types/basic.d.ts
 /**
  * Controller method reference
  */
 type ControllerHandler = [any, string];
 type MaybePromise<T = any> = T | Promise<T>;
+type RouteGroupCallback = () => MaybePromise<void>;
+type RouteGroupSource = RouteGroupCallback | string;
 type MiddlewareHandle<Args extends any[] = any[], Return = any> = (...args: Args) => MaybePromise<Return>;
 type MiddlewareClass<M extends MiddlewareHandle = MiddlewareHandle> = new () => {
   handle: M;
@@ -48,5 +52,12 @@ interface RouterConfig {
     autoDiscover?: boolean;
   };
 }
+interface FileImporter {
+  <T = unknown>(filePath: string): Promise<T>;
+  <T = unknown>(filePath: string, userOptions?: JitiOptions | undefined): Promise<T>;
+  <T = unknown>(filePath: string, userOptions?: JitiOptions | undefined, resolveOptions?: (JitiResolveOptions & {
+    default?: true;
+  })): Promise<T>;
+}
 //#endregion
-export { ApiResourceMiddleware, ClassMiddleware, ControllerHandler, HttpMethod, MiddlewareHandle, RequestData, ResourceAction, RouterConfig };
+export { ApiResourceMiddleware, ClassMiddleware, ControllerHandler, FileImporter, HttpMethod, MaybePromise, MiddlewareClass, MiddlewareHandle, MiddlewareInstance, RequestData, ResourceAction, RouteGroupCallback, RouteGroupSource, RouterConfig };

package/dist/types/index.d.mts

@@ -0,0 +1 @@
+import { ApiResourceMiddleware, ClassMiddleware, ControllerHandler, FileImporter, HttpMethod, MaybePromise, MiddlewareClass, MiddlewareHandle, MiddlewareInstance, RequestData, ResourceAction, RouteGroupCallback, RouteGroupSource, RouterConfig } from "./basic.mjs";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clear-router",
-  "version": "2.8.1",
+  "version": "2.8.2",
   "description": "Laravel-style routing for Node.js with support for Express, H3, Fastify, Hono, and Koa, including CommonJS, ESM, and TypeScript support.",
   "keywords": [
     "h3",
@@ -82,13 +82,13 @@
     "LICENSE"
   ],
   "peerDependencies": {
+    "@h3ravel/support": "^0.15.11",
     "@koa/router": "^15.0.0",
     "express": "^5.1.0",
     "fastify": "^5.0.0",
     "h3": "^2.0.1-rc.16",
     "hono": "^4.0.0",
     "koa": "^3.0.0",
-    "@h3ravel/support": "^0.15.11",
     "reflect-metadata": "^0.2.2"
   },
   "peerDependenciesMeta": {
@@ -144,6 +144,9 @@
   "engines": {
     "node": ">=20.0.0"
   },
+  "dependencies": {
+    "jiti": "^2.7.0"
+  },
   "scripts": {
     "test": "vitest run",
     "test:watch": "vitest --watch",