@h3ravel/shared 0.8.0 → 0.9.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @h3ravel/shared
 
+## 0.9.0
+
+### Minor Changes
+
+- refactor!: make route definition more similar to the way it is handled in laravel.
+
 ## 0.8.0
 
 ### Minor Changes

package/dist/index.d.cts

@@ -196,46 +196,42 @@ interface IRouter {
     /**
      * Registers a GET route.
      * @param path - The route path.
-     * @param handler - The handler function or controller class.
-     * @param methodName - Optional controller method name.
+     * @param definition - The handler function or [controller class, method] array.
      * @param name - Optional route name.
      * @param middleware - Optional middleware array.
      */
-    get(path: string, handler: EventHandler | (new (...args: any[]) => IController), methodName?: string, name?: string, middleware?: IMiddleware[]): void;
+    get(path: string, definition: EventHandler | [(new (...args: any[]) => IController), methodName: string], name?: string, middleware?: IMiddleware[]): this;
     /**
      * Registers a POST route.
      * @param path - The route path.
-     * @param handler - The handler function or controller class.
-     * @param methodName - Optional controller method name.
+     * @param definition - The handler function or [controller class, method] array.
      * @param name - Optional route name.
      * @param middleware - Optional middleware array.
      */
-    post(path: string, handler: EventHandler | (new (...args: any[]) => IController), methodName?: string, name?: string, middleware?: IMiddleware[]): void;
+    post(path: string, definition: EventHandler | [(new (...args: any[]) => IController), methodName: string], name?: string, middleware?: IMiddleware[]): this;
     /**
      * Registers a PUT route.
      * @param path - The route path.
-     * @param handler - The handler function or controller class.
-     * @param methodName - Optional controller method name.
+     * @param definition - The handler function or [controller class, method] array.
      * @param name - Optional route name.
      * @param middleware - Optional middleware array.
      */
-    put(path: string, handler: EventHandler | (new (...args: any[]) => IController), methodName?: string, name?: string, middleware?: IMiddleware[]): void;
+    put(path: string, definition: EventHandler | [(new (...args: any[]) => IController), methodName: string], name?: string, middleware?: IMiddleware[]): this;
     /**
      * Registers a DELETE route.
      * @param path - The route path.
-     * @param handler - The handler function or controller class.
-     * @param methodName - Optional controller method name.
+     * @param definition - The handler function or [controller class, method] array.
      * @param name - Optional route name.
      * @param middleware - Optional middleware array.
      */
-    delete(path: string, handler: EventHandler | (new (...args: any[]) => IController), methodName?: string, name?: string, middleware?: IMiddleware[]): void;
+    delete(path: string, definition: EventHandler | [(new (...args: any[]) => IController), methodName: string], name?: string, middleware?: IMiddleware[]): this;
     /**
      * Registers an API resource with standard CRUD routes.
      * @param path - The base path for the resource.
      * @param controller - The controller class handling the resource.
      * @param middleware - Optional middleware array.
      */
-    apiResource(path: string, controller: new (app: IApplication) => IController, middleware?: IMiddleware[]): void;
+    apiResource(path: string, controller: new (app: IApplication) => IController, middleware?: IMiddleware[]): this;
     /**
      * Generates a URL for a named route.
      * @param name - The name of the route.
@@ -243,6 +239,12 @@ interface IRouter {
      * @returns The generated URL or undefined if the route is not found.
      */
     route(name: string, params?: Record<string, string>): string | undefined;
+    /**
+     * Set the name of the current route
+     *
+     * @param name
+     */
+    name(name: string): this;
     /**
      * Groups routes with shared prefix or middleware.
      * @param options - Configuration for prefix or middleware.
@@ -251,14 +253,14 @@ interface IRouter {
     group(options: {
         prefix?: string;
         middleware?: EventHandler[];
-    }, callback: () => void): void;
+    }, callback: () => void): this;
     /**
      * Registers middleware for a specific path.
      * @param path - The path to apply the middleware.
      * @param handler - The middleware handler.
      * @param opts - Optional middleware options.
      */
-    middleware(path: string, handler: Middleware, opts?: MiddlewareOptions): void;
+    middleware(path: string | IMiddleware[], handler: Middleware, opts?: MiddlewareOptions): this;
 }
 interface HttpContext {
     request: IRequest;

package/dist/index.d.ts

@@ -196,46 +196,42 @@ interface IRouter {
     /**
      * Registers a GET route.
      * @param path - The route path.
-     * @param handler - The handler function or controller class.
-     * @param methodName - Optional controller method name.
+     * @param definition - The handler function or [controller class, method] array.
      * @param name - Optional route name.
      * @param middleware - Optional middleware array.
      */
-    get(path: string, handler: EventHandler | (new (...args: any[]) => IController), methodName?: string, name?: string, middleware?: IMiddleware[]): void;
+    get(path: string, definition: EventHandler | [(new (...args: any[]) => IController), methodName: string], name?: string, middleware?: IMiddleware[]): this;
     /**
      * Registers a POST route.
      * @param path - The route path.
-     * @param handler - The handler function or controller class.
-     * @param methodName - Optional controller method name.
+     * @param definition - The handler function or [controller class, method] array.
      * @param name - Optional route name.
      * @param middleware - Optional middleware array.
      */
-    post(path: string, handler: EventHandler | (new (...args: any[]) => IController), methodName?: string, name?: string, middleware?: IMiddleware[]): void;
+    post(path: string, definition: EventHandler | [(new (...args: any[]) => IController), methodName: string], name?: string, middleware?: IMiddleware[]): this;
     /**
      * Registers a PUT route.
      * @param path - The route path.
-     * @param handler - The handler function or controller class.
-     * @param methodName - Optional controller method name.
+     * @param definition - The handler function or [controller class, method] array.
      * @param name - Optional route name.
      * @param middleware - Optional middleware array.
      */
-    put(path: string, handler: EventHandler | (new (...args: any[]) => IController), methodName?: string, name?: string, middleware?: IMiddleware[]): void;
+    put(path: string, definition: EventHandler | [(new (...args: any[]) => IController), methodName: string], name?: string, middleware?: IMiddleware[]): this;
     /**
      * Registers a DELETE route.
      * @param path - The route path.
-     * @param handler - The handler function or controller class.
-     * @param methodName - Optional controller method name.
+     * @param definition - The handler function or [controller class, method] array.
      * @param name - Optional route name.
      * @param middleware - Optional middleware array.
      */
-    delete(path: string, handler: EventHandler | (new (...args: any[]) => IController), methodName?: string, name?: string, middleware?: IMiddleware[]): void;
+    delete(path: string, definition: EventHandler | [(new (...args: any[]) => IController), methodName: string], name?: string, middleware?: IMiddleware[]): this;
     /**
      * Registers an API resource with standard CRUD routes.
      * @param path - The base path for the resource.
      * @param controller - The controller class handling the resource.
      * @param middleware - Optional middleware array.
      */
-    apiResource(path: string, controller: new (app: IApplication) => IController, middleware?: IMiddleware[]): void;
+    apiResource(path: string, controller: new (app: IApplication) => IController, middleware?: IMiddleware[]): this;
     /**
      * Generates a URL for a named route.
      * @param name - The name of the route.
@@ -243,6 +239,12 @@ interface IRouter {
      * @returns The generated URL or undefined if the route is not found.
      */
     route(name: string, params?: Record<string, string>): string | undefined;
+    /**
+     * Set the name of the current route
+     *
+     * @param name
+     */
+    name(name: string): this;
     /**
      * Groups routes with shared prefix or middleware.
      * @param options - Configuration for prefix or middleware.
@@ -251,14 +253,14 @@ interface IRouter {
     group(options: {
         prefix?: string;
         middleware?: EventHandler[];
-    }, callback: () => void): void;
+    }, callback: () => void): this;
     /**
      * Registers middleware for a specific path.
      * @param path - The path to apply the middleware.
      * @param handler - The middleware handler.
      * @param opts - Optional middleware options.
      */
-    middleware(path: string, handler: Middleware, opts?: MiddlewareOptions): void;
+    middleware(path: string | IMiddleware[], handler: Middleware, opts?: MiddlewareOptions): this;
 }
 interface HttpContext {
     request: IRequest;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@h3ravel/shared",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "Shared Utilities.",
   "type": "module",
   "main": "dist/index.js",

package/src/Contracts/IHttp.ts

@@ -11,66 +11,58 @@ export interface IRouter {
     /**
      * Registers a GET route.
      * @param path - The route path.
-     * @param handler - The handler function or controller class.
-     * @param methodName - Optional controller method name.
+     * @param definition - The handler function or [controller class, method] array.
      * @param name - Optional route name.
      * @param middleware - Optional middleware array.
      */
     get (
         path: string,
-        handler: EventHandler | (new (...args: any[]) => IController),
-        methodName?: string,
+        definition: EventHandler | [(new (...args: any[]) => IController), methodName: string],
         name?: string,
         middleware?: IMiddleware[]
-    ): void;
+    ): this;
 
     /**
      * Registers a POST route.
      * @param path - The route path.
-     * @param handler - The handler function or controller class.
-     * @param methodName - Optional controller method name.
+     * @param definition - The handler function or [controller class, method] array.
      * @param name - Optional route name.
      * @param middleware - Optional middleware array.
      */
     post (
         path: string,
-        handler: EventHandler | (new (...args: any[]) => IController),
-        methodName?: string,
+        definition: EventHandler | [(new (...args: any[]) => IController), methodName: string],
         name?: string,
         middleware?: IMiddleware[]
-    ): void;
+    ): this;
 
     /**
      * Registers a PUT route.
      * @param path - The route path.
-     * @param handler - The handler function or controller class.
-     * @param methodName - Optional controller method name.
+     * @param definition - The handler function or [controller class, method] array.
      * @param name - Optional route name.
      * @param middleware - Optional middleware array.
      */
     put (
         path: string,
-        handler: EventHandler | (new (...args: any[]) => IController),
-        methodName?: string,
+        definition: EventHandler | [(new (...args: any[]) => IController), methodName: string],
         name?: string,
         middleware?: IMiddleware[]
-    ): void;
+    ): this;
 
     /**
      * Registers a DELETE route.
      * @param path - The route path.
-     * @param handler - The handler function or controller class.
-     * @param methodName - Optional controller method name.
+     * @param definition - The handler function or [controller class, method] array.
      * @param name - Optional route name.
      * @param middleware - Optional middleware array.
      */
     delete (
         path: string,
-        handler: EventHandler | (new (...args: any[]) => IController),
-        methodName?: string,
+        definition: EventHandler | [(new (...args: any[]) => IController), methodName: string],
         name?: string,
         middleware?: IMiddleware[]
-    ): void;
+    ): this;
 
     /**
      * Registers an API resource with standard CRUD routes.
@@ -82,7 +74,7 @@ export interface IRouter {
         path: string,
         controller: new (app: IApplication) => IController,
         middleware?: IMiddleware[]
-    ): void;
+    ): this;
 
     /**
      * Generates a URL for a named route.
@@ -92,12 +84,20 @@ export interface IRouter {
      */
     route (name: string, params?: Record<string, string>): string | undefined;
 
+
+    /**
+     * Set the name of the current route
+     * 
+     * @param name 
+     */
+    name (name: string): this
+
     /**
      * Groups routes with shared prefix or middleware.
      * @param options - Configuration for prefix or middleware.
      * @param callback - Callback function defining grouped routes.
      */
-    group (options: { prefix?: string; middleware?: EventHandler[] }, callback: () => void): void;
+    group (options: { prefix?: string; middleware?: EventHandler[] }, callback: () => void): this;
 
     /**
      * Registers middleware for a specific path.
@@ -105,7 +105,7 @@ export interface IRouter {
      * @param handler - The middleware handler.
      * @param opts - Optional middleware options.
      */
-    middleware (path: string, handler: Middleware, opts?: MiddlewareOptions): void;
+    middleware (path: string | IMiddleware[], handler: Middleware, opts?: MiddlewareOptions): this;
 }
 
 export interface HttpContext {