@h3ravel/shared 0.9.0 → 0.10.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @h3ravel/shared
 
+## 0.10.0
+
+### Minor Changes
+
+- feat: hide RouterEnd from itslelf to prevent unintentional chaining.
+
 ## 0.9.0
 
 ### Minor Changes

package/dist/index.d.cts

@@ -189,6 +189,7 @@ interface IResponse {
     getEvent<K extends DotNestedKeys<H3Event>>(key: K): DotNestedValue<H3Event, K>;
 }
 
+type RouterEnd = 'get' | 'delete' | 'put' | 'post' | 'apiResource' | 'name' | 'group' | 'route';
 /**
  * Interface for the Router contract, defining methods for HTTP routing.
  */
@@ -200,7 +201,7 @@ interface IRouter {
      * @param name - Optional route name.
      * @param middleware - Optional middleware array.
      */
-    get(path: string, definition: EventHandler | [(new (...args: any[]) => IController), methodName: string], name?: string, middleware?: IMiddleware[]): this;
+    get(path: string, definition: EventHandler | [(new (...args: any[]) => IController), methodName: string], name?: string, middleware?: IMiddleware[]): Omit<this, RouterEnd>;
     /**
      * Registers a POST route.
      * @param path - The route path.
@@ -208,7 +209,7 @@ interface IRouter {
      * @param name - Optional route name.
      * @param middleware - Optional middleware array.
      */
-    post(path: string, definition: EventHandler | [(new (...args: any[]) => IController), methodName: string], name?: string, middleware?: IMiddleware[]): this;
+    post(path: string, definition: EventHandler | [(new (...args: any[]) => IController), methodName: string], name?: string, middleware?: IMiddleware[]): Omit<this, RouterEnd>;
     /**
      * Registers a PUT route.
      * @param path - The route path.
@@ -216,7 +217,7 @@ interface IRouter {
      * @param name - Optional route name.
      * @param middleware - Optional middleware array.
      */
-    put(path: string, definition: EventHandler | [(new (...args: any[]) => IController), methodName: string], name?: string, middleware?: IMiddleware[]): this;
+    put(path: string, definition: EventHandler | [(new (...args: any[]) => IController), methodName: string], name?: string, middleware?: IMiddleware[]): Omit<this, RouterEnd>;
     /**
      * Registers a DELETE route.
      * @param path - The route path.
@@ -224,14 +225,14 @@ interface IRouter {
      * @param name - Optional route name.
      * @param middleware - Optional middleware array.
      */
-    delete(path: string, definition: EventHandler | [(new (...args: any[]) => IController), methodName: string], name?: string, middleware?: IMiddleware[]): this;
+    delete(path: string, definition: EventHandler | [(new (...args: any[]) => IController), methodName: string], name?: string, middleware?: IMiddleware[]): Omit<this, RouterEnd>;
     /**
      * 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[]): this;
+    apiResource(path: string, controller: new (app: IApplication) => IController, middleware?: IMiddleware[]): Omit<this, RouterEnd>;
     /**
      * Generates a URL for a named route.
      * @param name - The name of the route.
@@ -289,4 +290,4 @@ interface IMiddleware {
     handle(context: HttpContext, next: () => Promise<any>): Promise<any>;
 }
 
-export type { DotFlatten, DotNestedKeys, DotNestedValue, EventHandler, HttpContext, IApplication, IController, IMiddleware, IPathName, IRequest, IResponse, IRouter, IServiceProvider };
+export type { DotFlatten, DotNestedKeys, DotNestedValue, EventHandler, HttpContext, IApplication, IController, IMiddleware, IPathName, IRequest, IResponse, IRouter, IServiceProvider, RouterEnd };

package/dist/index.d.ts

@@ -189,6 +189,7 @@ interface IResponse {
     getEvent<K extends DotNestedKeys<H3Event>>(key: K): DotNestedValue<H3Event, K>;
 }
 
+type RouterEnd = 'get' | 'delete' | 'put' | 'post' | 'apiResource' | 'name' | 'group' | 'route';
 /**
  * Interface for the Router contract, defining methods for HTTP routing.
  */
@@ -200,7 +201,7 @@ interface IRouter {
      * @param name - Optional route name.
      * @param middleware - Optional middleware array.
      */
-    get(path: string, definition: EventHandler | [(new (...args: any[]) => IController), methodName: string], name?: string, middleware?: IMiddleware[]): this;
+    get(path: string, definition: EventHandler | [(new (...args: any[]) => IController), methodName: string], name?: string, middleware?: IMiddleware[]): Omit<this, RouterEnd>;
     /**
      * Registers a POST route.
      * @param path - The route path.
@@ -208,7 +209,7 @@ interface IRouter {
      * @param name - Optional route name.
      * @param middleware - Optional middleware array.
      */
-    post(path: string, definition: EventHandler | [(new (...args: any[]) => IController), methodName: string], name?: string, middleware?: IMiddleware[]): this;
+    post(path: string, definition: EventHandler | [(new (...args: any[]) => IController), methodName: string], name?: string, middleware?: IMiddleware[]): Omit<this, RouterEnd>;
     /**
      * Registers a PUT route.
      * @param path - The route path.
@@ -216,7 +217,7 @@ interface IRouter {
      * @param name - Optional route name.
      * @param middleware - Optional middleware array.
      */
-    put(path: string, definition: EventHandler | [(new (...args: any[]) => IController), methodName: string], name?: string, middleware?: IMiddleware[]): this;
+    put(path: string, definition: EventHandler | [(new (...args: any[]) => IController), methodName: string], name?: string, middleware?: IMiddleware[]): Omit<this, RouterEnd>;
     /**
      * Registers a DELETE route.
      * @param path - The route path.
@@ -224,14 +225,14 @@ interface IRouter {
      * @param name - Optional route name.
      * @param middleware - Optional middleware array.
      */
-    delete(path: string, definition: EventHandler | [(new (...args: any[]) => IController), methodName: string], name?: string, middleware?: IMiddleware[]): this;
+    delete(path: string, definition: EventHandler | [(new (...args: any[]) => IController), methodName: string], name?: string, middleware?: IMiddleware[]): Omit<this, RouterEnd>;
     /**
      * 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[]): this;
+    apiResource(path: string, controller: new (app: IApplication) => IController, middleware?: IMiddleware[]): Omit<this, RouterEnd>;
     /**
      * Generates a URL for a named route.
      * @param name - The name of the route.
@@ -289,4 +290,4 @@ interface IMiddleware {
     handle(context: HttpContext, next: () => Promise<any>): Promise<any>;
 }
 
-export type { DotFlatten, DotNestedKeys, DotNestedValue, EventHandler, HttpContext, IApplication, IController, IMiddleware, IPathName, IRequest, IResponse, IRouter, IServiceProvider };
+export type { DotFlatten, DotNestedKeys, DotNestedValue, EventHandler, HttpContext, IApplication, IController, IMiddleware, IPathName, IRequest, IResponse, IRouter, IServiceProvider, RouterEnd };

package/package.json

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

package/src/Contracts/IHttp.ts

@@ -4,6 +4,8 @@ import { IApplication } from './IApplication'
 import { IRequest } from './IRequest'
 import { IResponse } from './IResponse'
 
+export type RouterEnd = 'get' | 'delete' | 'put' | 'post' | 'apiResource' | 'name' | 'group' | 'route';
+
 /**
  * Interface for the Router contract, defining methods for HTTP routing.
  */
@@ -20,7 +22,7 @@ export interface IRouter {
         definition: EventHandler | [(new (...args: any[]) => IController), methodName: string],
         name?: string,
         middleware?: IMiddleware[]
-    ): this;
+    ): Omit<this, RouterEnd>;
 
     /**
      * Registers a POST route.
@@ -34,7 +36,7 @@ export interface IRouter {
         definition: EventHandler | [(new (...args: any[]) => IController), methodName: string],
         name?: string,
         middleware?: IMiddleware[]
-    ): this;
+    ): Omit<this, RouterEnd>;
 
     /**
      * Registers a PUT route.
@@ -48,7 +50,7 @@ export interface IRouter {
         definition: EventHandler | [(new (...args: any[]) => IController), methodName: string],
         name?: string,
         middleware?: IMiddleware[]
-    ): this;
+    ): Omit<this, RouterEnd>;
 
     /**
      * Registers a DELETE route.
@@ -62,7 +64,7 @@ export interface IRouter {
         definition: EventHandler | [(new (...args: any[]) => IController), methodName: string],
         name?: string,
         middleware?: IMiddleware[]
-    ): this;
+    ): Omit<this, RouterEnd>;
 
     /**
      * Registers an API resource with standard CRUD routes.
@@ -74,7 +76,7 @@ export interface IRouter {
         path: string,
         controller: new (app: IApplication) => IController,
         middleware?: IMiddleware[]
-    ): this;
+    ): Omit<this, RouterEnd>;
 
     /**
      * Generates a URL for a named route.