@gravito/core 1.1.0 → 1.2.0

package/dist/compat.d.cts

@@ -273,7 +273,7 @@ interface GravitoContext<V extends GravitoVariables = GravitoVariables> {
 /**
  * Next function for middleware chain
  */
-type GravitoNext = () => Promise<void>;
+type GravitoNext = () => Promise<Response | undefined>;
 /**
  * GravitoHandler - Standard route handler type
  *

package/dist/compat.d.ts

@@ -273,7 +273,7 @@ interface GravitoContext<V extends GravitoVariables = GravitoVariables> {
 /**
  * Next function for middleware chain
  */
-type GravitoNext = () => Promise<void>;
+type GravitoNext = () => Promise<Response | undefined>;
 /**
  * GravitoHandler - Standard route handler type
  *

package/dist/engine/index.cjs

@@ -402,7 +402,7 @@ var AOTRouter = class {
    * @param path - Matched path
    * @returns Route key or null
    */
-  findDynamicRouteKey(method, path) {
+  findDynamicRouteKey(method, _path) {
     for (const key of this.pathMiddleware.keys()) {
       if (key.startsWith(`${method}:`)) {
         return key;
@@ -533,7 +533,7 @@ var FastRequestImpl = class {
 };
 var FastContext = class {
   _req = new FastRequestImpl();
-  _statusCode = 200;
+  // private _statusCode = 200
   _headers = new Headers();
   // Reuse this object
   /**
@@ -544,7 +544,6 @@ var FastContext = class {
    */
   reset(request, params = {}) {
     this._req.reset(request, params);
-    this._statusCode = 200;
     this._headers = new Headers();
     return this;
   }
@@ -594,8 +593,7 @@ var FastContext = class {
   header(name, value) {
     this._headers.set(name, value);
   }
-  status(code) {
-    this._statusCode = code;
+  status(_code) {
   }
 };
 
@@ -925,7 +923,7 @@ var Gravito = class {
    * // Now accessible at /api/users
    * ```
    */
-  route(path, app) {
+  route(_path, _app) {
     console.warn("route() method is not yet fully implemented");
     return this;
   }
@@ -1130,21 +1128,26 @@ var Gravito = class {
     const next = async () => {
       if (index < middleware.length) {
         const mw = middleware[index++];
-        await mw(ctx, next);
+        return await mw(ctx, next);
       }
+      return void 0;
     };
-    await next();
+    const result = await next();
+    if (result instanceof Response) {
+      return result;
+    }
     return await handler(ctx);
   }
-  /**
+  /*
    * Handle 404 Not Found (Async version for dynamic/middleware paths)
+   * Note: Currently unused as we handle 404s via handleNotFoundSync or inline
    */
-  async handleNotFound(ctx) {
-    if (this.notFoundHandler) {
-      return await this.notFoundHandler(ctx);
-    }
-    return ctx.json({ error: "Not Found" }, 404);
-  }
+  // private async handleNotFound(ctx: FastContext): Promise<Response> {
+  //   if (this.notFoundHandler) {
+  //     return await this.notFoundHandler(ctx)
+  //   }
+  //   return ctx.json({ error: 'Not Found' }, 404)
+  // }
   /**
    * Handle errors (Async version for dynamic/middleware paths)
    */

package/dist/engine/index.d.cts

@@ -83,7 +83,7 @@ type Handler = (ctx: FastContext$1) => Response | Promise<Response>;
 /**
  * Middleware function
  */
-type Middleware = (ctx: FastContext$1, next: () => Promise<void>) => void | Promise<void>;
+type Middleware = (ctx: FastContext$1, next: () => Promise<Response | undefined>) => Response | undefined | Promise<Response | undefined>;
 /**
  * Error handler function
  */
@@ -232,7 +232,7 @@ declare class Gravito {
      * // Now accessible at /api/users
      * ```
      */
-    route(path: string, app: Gravito): this;
+    route(_path: string, _app: Gravito): this;
     /**
      * Set custom error handler
      *
@@ -303,10 +303,6 @@ declare class Gravito {
      * Each middleware can call next() to continue the chain.
      */
     private executeMiddleware;
-    /**
-     * Handle 404 Not Found (Async version for dynamic/middleware paths)
-     */
-    private handleNotFound;
     /**
      * Handle errors (Async version for dynamic/middleware paths)
      */
@@ -447,7 +443,6 @@ declare class AOTRouter {
  */
 declare class FastContext implements FastContext$1 {
     private _req;
-    private _statusCode;
     private _headers;
     /**
      * Reset context for pooling
@@ -463,7 +458,7 @@ declare class FastContext implements FastContext$1 {
     redirect(url: string, status?: 301 | 302 | 303 | 307 | 308): Response;
     body(data: BodyInit | null, status?: number): Response;
     header(name: string, value: string): void;
-    status(code: number): void;
+    status(_code: number): void;
 }
 
 /**

package/dist/engine/index.d.ts

@@ -83,7 +83,7 @@ type Handler = (ctx: FastContext$1) => Response | Promise<Response>;
 /**
  * Middleware function
  */
-type Middleware = (ctx: FastContext$1, next: () => Promise<void>) => void | Promise<void>;
+type Middleware = (ctx: FastContext$1, next: () => Promise<Response | undefined>) => Response | undefined | Promise<Response | undefined>;
 /**
  * Error handler function
  */
@@ -232,7 +232,7 @@ declare class Gravito {
      * // Now accessible at /api/users
      * ```
      */
-    route(path: string, app: Gravito): this;
+    route(_path: string, _app: Gravito): this;
     /**
      * Set custom error handler
      *
@@ -303,10 +303,6 @@ declare class Gravito {
      * Each middleware can call next() to continue the chain.
      */
     private executeMiddleware;
-    /**
-     * Handle 404 Not Found (Async version for dynamic/middleware paths)
-     */
-    private handleNotFound;
     /**
      * Handle errors (Async version for dynamic/middleware paths)
      */
@@ -447,7 +443,6 @@ declare class AOTRouter {
  */
 declare class FastContext implements FastContext$1 {
     private _req;
-    private _statusCode;
     private _headers;
     /**
      * Reset context for pooling
@@ -463,7 +458,7 @@ declare class FastContext implements FastContext$1 {
     redirect(url: string, status?: 301 | 302 | 303 | 307 | 308): Response;
     body(data: BodyInit | null, status?: number): Response;
     header(name: string, value: string): void;
-    status(code: number): void;
+    status(_code: number): void;
 }
 
 /**

package/dist/engine/index.js

@@ -371,7 +371,7 @@ var AOTRouter = class {
    * @param path - Matched path
    * @returns Route key or null
    */
-  findDynamicRouteKey(method, path) {
+  findDynamicRouteKey(method, _path) {
     for (const key of this.pathMiddleware.keys()) {
       if (key.startsWith(`${method}:`)) {
         return key;
@@ -502,7 +502,7 @@ var FastRequestImpl = class {
 };
 var FastContext = class {
   _req = new FastRequestImpl();
-  _statusCode = 200;
+  // private _statusCode = 200
   _headers = new Headers();
   // Reuse this object
   /**
@@ -513,7 +513,6 @@ var FastContext = class {
    */
   reset(request, params = {}) {
     this._req.reset(request, params);
-    this._statusCode = 200;
     this._headers = new Headers();
     return this;
   }
@@ -563,8 +562,7 @@ var FastContext = class {
   header(name, value) {
     this._headers.set(name, value);
   }
-  status(code) {
-    this._statusCode = code;
+  status(_code) {
   }
 };
 
@@ -894,7 +892,7 @@ var Gravito = class {
    * // Now accessible at /api/users
    * ```
    */
-  route(path, app) {
+  route(_path, _app) {
     console.warn("route() method is not yet fully implemented");
     return this;
   }
@@ -1099,21 +1097,26 @@ var Gravito = class {
     const next = async () => {
       if (index < middleware.length) {
         const mw = middleware[index++];
-        await mw(ctx, next);
+        return await mw(ctx, next);
       }
+      return void 0;
     };
-    await next();
+    const result = await next();
+    if (result instanceof Response) {
+      return result;
+    }
     return await handler(ctx);
   }
-  /**
+  /*
    * Handle 404 Not Found (Async version for dynamic/middleware paths)
+   * Note: Currently unused as we handle 404s via handleNotFoundSync or inline
    */
-  async handleNotFound(ctx) {
-    if (this.notFoundHandler) {
-      return await this.notFoundHandler(ctx);
-    }
-    return ctx.json({ error: "Not Found" }, 404);
-  }
+  // private async handleNotFound(ctx: FastContext): Promise<Response> {
+  //   if (this.notFoundHandler) {
+  //     return await this.notFoundHandler(ctx)
+  //   }
+  //   return ctx.json({ error: 'Not Found' }, 404)
+  // }
   /**
    * Handle errors (Async version for dynamic/middleware paths)
    */

package/dist/index.cjs

@@ -54,6 +54,7 @@ __export(index_exports, {
   PhotonRequestWrapper: () => PhotonRequestWrapper,
   PlanetCore: () => PlanetCore,
   Route: () => Route,
+  RouteGroup: () => RouteGroup,
   Router: () => Router,
   ServiceProvider: () => ServiceProvider,
   Str: () => Str,
@@ -113,7 +114,7 @@ module.exports = __toCommonJS(index_exports);
 // package.json
 var package_default = {
   name: "@gravito/core",
-  version: "1.1.0",
+  version: "1.2.0",
   description: "",
   module: "./dist/index.js",
   main: "./dist/index.cjs",
@@ -185,10 +186,45 @@ var package_default = {
 };
 
 // src/adapters/PhotonAdapter.ts
-var PhotonRequestWrapper = class {
+var PhotonRequestWrapper = class _PhotonRequestWrapper {
   constructor(photonCtx) {
     this.photonCtx = photonCtx;
   }
+  /**
+   * Create a proxied instance to delegate to Photon's request
+   */
+  static create(photonCtx) {
+    const instance = new _PhotonRequestWrapper(photonCtx);
+    return new Proxy(instance, {
+      get(target, prop, receiver) {
+        if (prop in target) {
+          const value2 = Reflect.get(target, prop, receiver);
+          if (typeof value2 === "function") {
+            return value2.bind(target);
+          }
+          return value2;
+        }
+        const nativeReq = target.photonCtx.req;
+        if (prop in nativeReq) {
+          const value2 = nativeReq[prop];
+          if (typeof value2 === "function") {
+            return value2.bind(nativeReq);
+          }
+          return value2;
+        }
+        return void 0;
+      },
+      // Allow setting properties (for addValidated etc.)
+      set(target, prop, value2) {
+        if (prop in target) {
+          return Reflect.set(target, prop, value2);
+        }
+        ;
+        target.photonCtx.req[prop] = value2;
+        return true;
+      }
+    });
+  }
   get url() {
     return this.photonCtx.req.url;
   }
@@ -247,7 +283,7 @@ var PhotonRequestWrapper = class {
 var PhotonContextWrapper = class _PhotonContextWrapper {
   constructor(photonCtx) {
     this.photonCtx = photonCtx;
-    this._req = new PhotonRequestWrapper(photonCtx);
+    this._req = PhotonRequestWrapper.create(photonCtx);
   }
   _req;
   /**
@@ -359,7 +395,7 @@ function toPhotonMiddleware(middleware) {
   return async (c, next) => {
     const ctx = PhotonContextWrapper.create(c);
     const gravitoNext = async () => {
-      await next();
+      return await next();
     };
     return middleware(ctx, gravitoNext);
   };
@@ -2823,20 +2859,20 @@ var RouteGroup = class _RouteGroup {
   group(callback) {
     callback(this);
   }
-  get(path2, requestOrHandler, handler) {
-    return this.router.req("get", path2, requestOrHandler, handler, this.options);
+  get(path2, requestOrHandlerOrMiddleware, handler) {
+    return this.router.req("get", path2, requestOrHandlerOrMiddleware, handler, this.options);
   }
-  post(path2, requestOrHandler, handler) {
-    return this.router.req("post", path2, requestOrHandler, handler, this.options);
+  post(path2, requestOrHandlerOrMiddleware, handler) {
+    return this.router.req("post", path2, requestOrHandlerOrMiddleware, handler, this.options);
   }
-  put(path2, requestOrHandler, handler) {
-    return this.router.req("put", path2, requestOrHandler, handler, this.options);
+  put(path2, requestOrHandlerOrMiddleware, handler) {
+    return this.router.req("put", path2, requestOrHandlerOrMiddleware, handler, this.options);
   }
-  delete(path2, requestOrHandler, handler) {
-    return this.router.req("delete", path2, requestOrHandler, handler, this.options);
+  delete(path2, requestOrHandlerOrMiddleware, handler) {
+    return this.router.req("delete", path2, requestOrHandlerOrMiddleware, handler, this.options);
   }
-  patch(path2, requestOrHandler, handler) {
-    return this.router.req("patch", path2, requestOrHandler, handler, this.options);
+  patch(path2, requestOrHandlerOrMiddleware, handler) {
+    return this.router.req("patch", path2, requestOrHandlerOrMiddleware, handler, this.options);
   }
   resource(name, controller, options = {}) {
     const actions = [
@@ -3012,20 +3048,20 @@ var Router = class {
   middleware(...handlers) {
     return new RouteGroup(this, { middleware: handlers.flat() });
   }
-  get(path2, requestOrHandler, handler) {
-    return this.req("get", path2, requestOrHandler, handler);
+  get(path2, requestOrHandlerOrMiddleware, handler) {
+    return this.req("get", path2, requestOrHandlerOrMiddleware, handler);
   }
-  post(path2, requestOrHandler, handler) {
-    return this.req("post", path2, requestOrHandler, handler);
+  post(path2, requestOrHandlerOrMiddleware, handler) {
+    return this.req("post", path2, requestOrHandlerOrMiddleware, handler);
   }
-  put(path2, requestOrHandler, handler) {
-    return this.req("put", path2, requestOrHandler, handler);
+  put(path2, requestOrHandlerOrMiddleware, handler) {
+    return this.req("put", path2, requestOrHandlerOrMiddleware, handler);
   }
-  delete(path2, requestOrHandler, handler) {
-    return this.req("delete", path2, requestOrHandler, handler);
+  delete(path2, requestOrHandlerOrMiddleware, handler) {
+    return this.req("delete", path2, requestOrHandlerOrMiddleware, handler);
   }
-  patch(path2, requestOrHandler, handler) {
-    return this.req("patch", path2, requestOrHandler, handler);
+  patch(path2, requestOrHandlerOrMiddleware, handler) {
+    return this.req("patch", path2, requestOrHandlerOrMiddleware, handler);
   }
   /**
    * Register a resource route (Laravel-style).
@@ -3071,17 +3107,25 @@ var Router = class {
   /**
    * Internal Request Registration
    */
-  req(method, path2, requestOrHandler, handler, options = {}) {
+  req(method, path2, requestOrHandlerOrMiddleware, handler, options = {}) {
     const fullPath = (options.prefix || "") + path2;
     let formRequestMiddleware = null;
+    let routeMiddleware = [];
     let finalRouteHandler;
     if (handler !== void 0) {
-      if (isFormRequestClass(requestOrHandler)) {
-        formRequestMiddleware = formRequestToMiddleware(requestOrHandler);
+      if (isFormRequestClass(requestOrHandlerOrMiddleware)) {
+        formRequestMiddleware = formRequestToMiddleware(requestOrHandlerOrMiddleware);
+      } else {
+        const middleware = requestOrHandlerOrMiddleware;
+        if (Array.isArray(middleware)) {
+          routeMiddleware = middleware;
+        } else {
+          routeMiddleware = [middleware];
+        }
       }
       finalRouteHandler = handler;
     } else {
-      finalRouteHandler = requestOrHandler;
+      finalRouteHandler = requestOrHandlerOrMiddleware;
     }
     let resolvedHandler;
     if (Array.isArray(finalRouteHandler)) {
@@ -3097,6 +3141,9 @@ var Router = class {
     if (formRequestMiddleware) {
       handlers.push(formRequestMiddleware);
     }
+    if (routeMiddleware.length > 0) {
+      handlers.push(...routeMiddleware);
+    }
     handlers.push(resolvedHandler);
     if (options.domain) {
       const domainCheck = async (c, next) => {
@@ -3371,8 +3418,7 @@ var PlanetCore = class _PlanetCore {
       const cookieJar = new CookieJar(this.encrypter);
       c.set("cookieJar", cookieJar);
       c.route = (name, params, query) => this.router.url(name, params, query);
-      await next();
-      return void 0;
+      return await next();
     });
     this.router = new Router(this);
     this.adapter.onError(async (err, c) => {
@@ -4891,7 +4937,7 @@ var AOTRouter = class {
    * @param path - Matched path
    * @returns Route key or null
    */
-  findDynamicRouteKey(method, path2) {
+  findDynamicRouteKey(method, _path) {
     for (const key of this.pathMiddleware.keys()) {
       if (key.startsWith(`${method}:`)) {
         return key;
@@ -5022,7 +5068,7 @@ var FastRequestImpl = class {
 };
 var FastContext = class {
   _req = new FastRequestImpl();
-  _statusCode = 200;
+  // private _statusCode = 200
   _headers = new Headers();
   // Reuse this object
   /**
@@ -5033,7 +5079,6 @@ var FastContext = class {
    */
   reset(request, params = {}) {
     this._req.reset(request, params);
-    this._statusCode = 200;
     this._headers = new Headers();
     return this;
   }
@@ -5083,8 +5128,7 @@ var FastContext = class {
   header(name, value2) {
     this._headers.set(name, value2);
   }
-  status(code) {
-    this._statusCode = code;
+  status(_code) {
   }
 };
 
@@ -5414,7 +5458,7 @@ var Gravito = class {
    * // Now accessible at /api/users
    * ```
    */
-  route(path2, app2) {
+  route(_path, _app) {
     console.warn("route() method is not yet fully implemented");
     return this;
   }
@@ -5619,21 +5663,26 @@ var Gravito = class {
     const next = async () => {
       if (index < middleware.length) {
         const mw = middleware[index++];
-        await mw(ctx, next);
+        return await mw(ctx, next);
       }
+      return void 0;
     };
-    await next();
+    const result = await next();
+    if (result instanceof Response) {
+      return result;
+    }
     return await handler(ctx);
   }
-  /**
+  /*
    * Handle 404 Not Found (Async version for dynamic/middleware paths)
+   * Note: Currently unused as we handle 404s via handleNotFoundSync or inline
    */
-  async handleNotFound(ctx) {
-    if (this.notFoundHandler) {
-      return await this.notFoundHandler(ctx);
-    }
-    return ctx.json({ error: "Not Found" }, 404);
-  }
+  // private async handleNotFound(ctx: FastContext): Promise<Response> {
+  //   if (this.notFoundHandler) {
+  //     return await this.notFoundHandler(ctx)
+  //   }
+  //   return ctx.json({ error: 'Not Found' }, 404)
+  // }
   /**
    * Handle errors (Async version for dynamic/middleware paths)
    */
@@ -5683,6 +5732,7 @@ function defineConfig(config2) {
   PhotonRequestWrapper,
   PlanetCore,
   Route,
+  RouteGroup,
   Router,
   ServiceProvider,
   Str,

package/dist/index.d.cts

@@ -764,14 +764,19 @@ declare class Route {
     name(name: string): this;
     static get(path: string, handler: RouteHandler): Route;
     static get(path: string, request: FormRequestClass, handler: RouteHandler): Route;
+    static get(path: string, middleware: GravitoMiddleware | GravitoMiddleware[], handler: RouteHandler): Route;
     static post(path: string, handler: RouteHandler): Route;
     static post(path: string, request: FormRequestClass, handler: RouteHandler): Route;
+    static post(path: string, middleware: GravitoMiddleware | GravitoMiddleware[], handler: RouteHandler): Route;
     static put(path: string, handler: RouteHandler): Route;
     static put(path: string, request: FormRequestClass, handler: RouteHandler): Route;
+    static put(path: string, middleware: GravitoMiddleware | GravitoMiddleware[], handler: RouteHandler): Route;
     static delete(path: string, handler: RouteHandler): Route;
     static delete(path: string, request: FormRequestClass, handler: RouteHandler): Route;
+    static delete(path: string, middleware: GravitoMiddleware | GravitoMiddleware[], handler: RouteHandler): Route;
     static patch(path: string, handler: RouteHandler): Route;
     static patch(path: string, request: FormRequestClass, handler: RouteHandler): Route;
+    static patch(path: string, middleware: GravitoMiddleware | GravitoMiddleware[], handler: RouteHandler): Route;
     static resource(name: string, controller: ControllerClass, options?: ResourceOptions): void;
     static prefix(path: string): RouteGroup;
     static middleware(...handlers: any[]): RouteGroup;
@@ -824,14 +829,19 @@ declare class RouteGroup {
     group(callback: (router: Router | RouteGroup) => void): void;
     get(path: string, handler: RouteHandler): Route;
     get(path: string, request: FormRequestClass, handler: RouteHandler): Route;
+    get(path: string, middleware: GravitoMiddleware | GravitoMiddleware[], handler: RouteHandler): Route;
     post(path: string, handler: RouteHandler): Route;
     post(path: string, request: FormRequestClass, handler: RouteHandler): Route;
+    post(path: string, middleware: GravitoMiddleware | GravitoMiddleware[], handler: RouteHandler): Route;
     put(path: string, handler: RouteHandler): Route;
     put(path: string, request: FormRequestClass, handler: RouteHandler): Route;
+    put(path: string, middleware: GravitoMiddleware | GravitoMiddleware[], handler: RouteHandler): Route;
     delete(path: string, handler: RouteHandler): Route;
     delete(path: string, request: FormRequestClass, handler: RouteHandler): Route;
+    delete(path: string, middleware: GravitoMiddleware | GravitoMiddleware[], handler: RouteHandler): Route;
     patch(path: string, handler: RouteHandler): Route;
     patch(path: string, request: FormRequestClass, handler: RouteHandler): Route;
+    patch(path: string, middleware: GravitoMiddleware | GravitoMiddleware[], handler: RouteHandler): Route;
     resource(name: string, controller: ControllerClass, options?: ResourceOptions): void;
 }
 /**
@@ -844,6 +854,7 @@ declare class RouteGroup {
  * - Domain-based routing: router.domain('api.app').group(...)
  * - Middleware chaining: router.middleware(auth).group(...)
  * - FormRequest validation: router.post('/users', StoreUserRequest, [UserController, 'store'])
+ * - Inline Middleware: router.get('/users', authMiddleware, [UserController, 'index'])
  */
 declare class Router {
     private core;
@@ -911,83 +922,34 @@ declare class Router {
     middleware(...handlers: (GravitoMiddleware | GravitoMiddleware[])[]): RouteGroup;
     /**
      * Register a GET route.
-     *
-     * @param path - The URL path for the route.
-     * @param handler - The handler function or controller method.
-     * @returns The registered Route instance for chaining.
-     *
-     * @example
-     * ```typescript
-     * router.get('/users', [UserController, 'index']);
-     * ```
      */
     get(path: string, handler: RouteHandler): Route;
-    /**
-     * Register a GET route with a FormRequest for validation.
-     *
-     * @param path - The URL path.
-     * @param request - The FormRequest class for validation.
-     * @param handler - The handler function or controller method.
-     *
-     * @example
-     * ```typescript
-     * router.get('/search', SearchRequest, [Controller, 'search']);
-     * ```
-     */
     get(path: string, request: FormRequestClass, handler: RouteHandler): Route;
+    get(path: string, middleware: GravitoMiddleware | GravitoMiddleware[], handler: RouteHandler): Route;
     /**
      * Register a POST route.
-     *
-     * @param path - The URL path.
-     * @param handler - The handler function or controller method.
-     * @returns The registered Route instance.
-     *
-     * @example
-     * ```typescript
-     * router.post('/users', [UserController, 'store']);
-     * ```
      */
     post(path: string, handler: RouteHandler): Route;
-    /**
-     * Register a POST route with validation.
-     *
-     * @param path - The URL path.
-     * @param request - The FormRequest class.
-     * @param handler - The handler.
-     *
-     * @example
-     * ```typescript
-     * router.post('/users', StoreUserRequest, [UserController, 'store']);
-     * ```
-     */
     post(path: string, request: FormRequestClass, handler: RouteHandler): Route;
+    post(path: string, middleware: GravitoMiddleware | GravitoMiddleware[], handler: RouteHandler): Route;
     /**
      * Register a PUT route.
-     *
-     * @param path - The URL path.
-     * @param handler - The handler function.
-     * @returns The registered Route instance.
      */
     put(path: string, handler: RouteHandler): Route;
     put(path: string, request: FormRequestClass, handler: RouteHandler): Route;
+    put(path: string, middleware: GravitoMiddleware | GravitoMiddleware[], handler: RouteHandler): Route;
     /**
      * Register a DELETE route.
-     *
-     * @param path - The URL path.
-     * @param handler - The handler function.
-     * @returns The registered Route instance.
      */
     delete(path: string, handler: RouteHandler): Route;
     delete(path: string, request: FormRequestClass, handler: RouteHandler): Route;
+    delete(path: string, middleware: GravitoMiddleware | GravitoMiddleware[], handler: RouteHandler): Route;
     /**
      * Register a PATCH route.
-     *
-     * @param path - The URL path.
-     * @param handler - The handler function.
-     * @returns The registered Route instance.
      */
     patch(path: string, handler: RouteHandler): Route;
     patch(path: string, request: FormRequestClass, handler: RouteHandler): Route;
+    patch(path: string, middleware: GravitoMiddleware | GravitoMiddleware[], handler: RouteHandler): Route;
     /**
      * Register a resource route (Laravel-style).
      */
@@ -995,7 +957,7 @@ declare class Router {
     /**
      * Internal Request Registration
      */
-    req(method: HttpMethod, path: string, requestOrHandler: FormRequestClass | RouteHandler, handler?: RouteHandler, options?: RouteOptions): Route;
+    req(method: HttpMethod, path: string, requestOrHandlerOrMiddleware: FormRequestClass | RouteHandler | GravitoMiddleware | GravitoMiddleware[], handler?: RouteHandler, options?: RouteOptions): Route;
     /**
      * Resolve Controller Instance and Method
      */
@@ -1273,8 +1235,12 @@ declare class PlanetCore {
  * Wraps Photon's request object to implement GravitoRequest
  */
 declare class PhotonRequestWrapper implements GravitoRequest {
-    private photonCtx;
+    readonly photonCtx: Context;
     constructor(photonCtx: Context);
+    /**
+     * Create a proxied instance to delegate to Photon's request
+     */
+    static create(photonCtx: Context): PhotonRequestWrapper;
     get url(): string;
     get method(): string;
     get path(): string;
@@ -2065,7 +2031,7 @@ type Handler = (ctx: FastContext$1) => Response | Promise<Response>;
 /**
  * Middleware function
  */
-type Middleware = (ctx: FastContext$1, next: () => Promise<void>) => void | Promise<void>;
+type Middleware = (ctx: FastContext$1, next: () => Promise<Response | undefined>) => Response | undefined | Promise<Response | undefined>;
 /**
  * Error handler function
  */
@@ -2214,7 +2180,7 @@ declare class Gravito {
      * // Now accessible at /api/users
      * ```
      */
-    route(path: string, app: Gravito): this;
+    route(_path: string, _app: Gravito): this;
     /**
      * Set custom error handler
      *
@@ -2285,10 +2251,6 @@ declare class Gravito {
      * Each middleware can call next() to continue the chain.
      */
     private executeMiddleware;
-    /**
-     * Handle 404 Not Found (Async version for dynamic/middleware paths)
-     */
-    private handleNotFound;
     /**
      * Handle errors (Async version for dynamic/middleware paths)
      */
@@ -2429,7 +2391,6 @@ declare class AOTRouter {
  */
 declare class FastContext implements FastContext$1 {
     private _req;
-    private _statusCode;
     private _headers;
     /**
      * Reset context for pooling
@@ -2445,7 +2406,7 @@ declare class FastContext implements FastContext$1 {
     redirect(url: string, status?: 301 | 302 | 303 | 307 | 308): Response;
     body(data: BodyInit | null, status?: number): Response;
     header(name: string, value: string): void;
-    status(code: number): void;
+    status(_code: number): void;
 }
 
 /**
@@ -2659,4 +2620,4 @@ declare const VERSION: string;
  */
 declare function defineConfig(config: GravitoConfig): GravitoConfig;
 
-export { type ActionCallback, type AdapterConfig, type AdapterFactory, type ApiFailure, type ApiSuccess, Application, type ApplicationConfig, Arr, AuthenticationException, AuthorizationException, type BodySizeLimitOptions, type CacheService, type Channel, ConfigManager, ConsoleLogger, Container, ContentfulStatusCode, type ControllerClass, CookieJar, type CookieOptions, type CorsOptions, type CorsOrigin, type CsrfOptions, type DataPath, DumpDieError, type DumpOptions, Encrypter, type EncrypterOptions, type ErrorBag, type ErrorHandlerContext, Event, EventManager, type ExceptionOptions, type Factory, type FilterCallback, type FormRequestClass, type FormRequestLike, type GlobalErrorHandlersMode, type GlobalProcessErrorHandlerContext, type GlobalProcessErrorKind, GravitoAdapter, type GravitoConfig, GravitoContext, GravitoErrorHandler, GravitoException, GravitoHandler, type GravitoManifest, GravitoMiddleware, GravitoNotFoundHandler, type GravitoOrbit, GravitoRequest, GravitoServer, GravitoVariables, type HeaderTokenGateOptions, HookManager, type HstsOptions, type HttpAdapter, HttpException, HttpMethod, HttpTester, type Listener, type Logger, ModelNotFoundException, type PathSegment, PhotonAdapter, PhotonContextWrapper, PhotonRequestWrapper, PlanetCore, type RegisterGlobalErrorHandlersOptions, type RequireHeaderTokenOptions, Route, type RouteDefinition, type RouteHandler, type RouteOptions, Router, type RuntimeAdapter, type RuntimeFileStat, type RuntimeKind, type RuntimePasswordAdapter, type RuntimeProcess, type RuntimeServeConfig, type RuntimeServer, type RuntimeSpawnOptions, type RuntimeSqliteDatabase, type RuntimeSqliteStatement, type SecurityHeadersOptions, ServiceProvider, type ShouldBroadcast, type ShouldQueue, StatusCode, Str, TestResponse, ThrottleRequests, VERSION, type ValidationError, ValidationException, type ViewService, abort, abortIf, abortUnless, app, blank, bodySizeLimit, config, cors, createErrorBag, createGravitoAdapter, createHeaderGate, createHttpTester, createPhotonAdapter, createSqliteDatabase, csrfProtection, dataGet, dataHas, dataSet, dd, defineConfig, dump, index as engine, env, errors, fail, filled, getCsrfToken, getPasswordAdapter, getRuntimeAdapter, getRuntimeEnv, hasApp, isHttpAdapter, jsonFail, jsonSuccess, logger, ok, old, registerGlobalErrorHandlers, requireHeaderToken, router, securityHeaders, setApp, tap, throwIf, throwUnless, value };
+export { type ActionCallback, type AdapterConfig, type AdapterFactory, type ApiFailure, type ApiSuccess, Application, type ApplicationConfig, Arr, AuthenticationException, AuthorizationException, type BodySizeLimitOptions, type CacheService, type Channel, ConfigManager, ConsoleLogger, Container, ContentfulStatusCode, type ControllerClass, CookieJar, type CookieOptions, type CorsOptions, type CorsOrigin, type CsrfOptions, type DataPath, DumpDieError, type DumpOptions, Encrypter, type EncrypterOptions, type ErrorBag, type ErrorHandlerContext, Event, EventManager, type ExceptionOptions, type Factory, type FilterCallback, type FormRequestClass, type FormRequestLike, type GlobalErrorHandlersMode, type GlobalProcessErrorHandlerContext, type GlobalProcessErrorKind, GravitoAdapter, type GravitoConfig, GravitoContext, GravitoErrorHandler, GravitoException, GravitoHandler, type GravitoManifest, GravitoMiddleware, GravitoNotFoundHandler, type GravitoOrbit, GravitoRequest, GravitoServer, GravitoVariables, type HeaderTokenGateOptions, HookManager, type HstsOptions, type HttpAdapter, HttpException, HttpMethod, HttpTester, type Listener, type Logger, ModelNotFoundException, type PathSegment, PhotonAdapter, PhotonContextWrapper, PhotonRequestWrapper, PlanetCore, type RegisterGlobalErrorHandlersOptions, type RequireHeaderTokenOptions, Route, type RouteDefinition, RouteGroup, type RouteHandler, type RouteOptions, Router, type RuntimeAdapter, type RuntimeFileStat, type RuntimeKind, type RuntimePasswordAdapter, type RuntimeProcess, type RuntimeServeConfig, type RuntimeServer, type RuntimeSpawnOptions, type RuntimeSqliteDatabase, type RuntimeSqliteStatement, type SecurityHeadersOptions, ServiceProvider, type ShouldBroadcast, type ShouldQueue, StatusCode, Str, TestResponse, ThrottleRequests, VERSION, type ValidationError, ValidationException, type ViewService, abort, abortIf, abortUnless, app, blank, bodySizeLimit, config, cors, createErrorBag, createGravitoAdapter, createHeaderGate, createHttpTester, createPhotonAdapter, createSqliteDatabase, csrfProtection, dataGet, dataHas, dataSet, dd, defineConfig, dump, index as engine, env, errors, fail, filled, getCsrfToken, getPasswordAdapter, getRuntimeAdapter, getRuntimeEnv, hasApp, isHttpAdapter, jsonFail, jsonSuccess, logger, ok, old, registerGlobalErrorHandlers, requireHeaderToken, router, securityHeaders, setApp, tap, throwIf, throwUnless, value };

package/dist/index.d.ts

@@ -764,14 +764,19 @@ declare class Route {
     name(name: string): this;
     static get(path: string, handler: RouteHandler): Route;
     static get(path: string, request: FormRequestClass, handler: RouteHandler): Route;
+    static get(path: string, middleware: GravitoMiddleware | GravitoMiddleware[], handler: RouteHandler): Route;
     static post(path: string, handler: RouteHandler): Route;
     static post(path: string, request: FormRequestClass, handler: RouteHandler): Route;
+    static post(path: string, middleware: GravitoMiddleware | GravitoMiddleware[], handler: RouteHandler): Route;
     static put(path: string, handler: RouteHandler): Route;
     static put(path: string, request: FormRequestClass, handler: RouteHandler): Route;
+    static put(path: string, middleware: GravitoMiddleware | GravitoMiddleware[], handler: RouteHandler): Route;
     static delete(path: string, handler: RouteHandler): Route;
     static delete(path: string, request: FormRequestClass, handler: RouteHandler): Route;
+    static delete(path: string, middleware: GravitoMiddleware | GravitoMiddleware[], handler: RouteHandler): Route;
     static patch(path: string, handler: RouteHandler): Route;
     static patch(path: string, request: FormRequestClass, handler: RouteHandler): Route;
+    static patch(path: string, middleware: GravitoMiddleware | GravitoMiddleware[], handler: RouteHandler): Route;
     static resource(name: string, controller: ControllerClass, options?: ResourceOptions): void;
     static prefix(path: string): RouteGroup;
     static middleware(...handlers: any[]): RouteGroup;
@@ -824,14 +829,19 @@ declare class RouteGroup {
     group(callback: (router: Router | RouteGroup) => void): void;
     get(path: string, handler: RouteHandler): Route;
     get(path: string, request: FormRequestClass, handler: RouteHandler): Route;
+    get(path: string, middleware: GravitoMiddleware | GravitoMiddleware[], handler: RouteHandler): Route;
     post(path: string, handler: RouteHandler): Route;
     post(path: string, request: FormRequestClass, handler: RouteHandler): Route;
+    post(path: string, middleware: GravitoMiddleware | GravitoMiddleware[], handler: RouteHandler): Route;
     put(path: string, handler: RouteHandler): Route;
     put(path: string, request: FormRequestClass, handler: RouteHandler): Route;
+    put(path: string, middleware: GravitoMiddleware | GravitoMiddleware[], handler: RouteHandler): Route;
     delete(path: string, handler: RouteHandler): Route;
     delete(path: string, request: FormRequestClass, handler: RouteHandler): Route;
+    delete(path: string, middleware: GravitoMiddleware | GravitoMiddleware[], handler: RouteHandler): Route;
     patch(path: string, handler: RouteHandler): Route;
     patch(path: string, request: FormRequestClass, handler: RouteHandler): Route;
+    patch(path: string, middleware: GravitoMiddleware | GravitoMiddleware[], handler: RouteHandler): Route;
     resource(name: string, controller: ControllerClass, options?: ResourceOptions): void;
 }
 /**
@@ -844,6 +854,7 @@ declare class RouteGroup {
  * - Domain-based routing: router.domain('api.app').group(...)
  * - Middleware chaining: router.middleware(auth).group(...)
  * - FormRequest validation: router.post('/users', StoreUserRequest, [UserController, 'store'])
+ * - Inline Middleware: router.get('/users', authMiddleware, [UserController, 'index'])
  */
 declare class Router {
     private core;
@@ -911,83 +922,34 @@ declare class Router {
     middleware(...handlers: (GravitoMiddleware | GravitoMiddleware[])[]): RouteGroup;
     /**
      * Register a GET route.
-     *
-     * @param path - The URL path for the route.
-     * @param handler - The handler function or controller method.
-     * @returns The registered Route instance for chaining.
-     *
-     * @example
-     * ```typescript
-     * router.get('/users', [UserController, 'index']);
-     * ```
      */
     get(path: string, handler: RouteHandler): Route;
-    /**
-     * Register a GET route with a FormRequest for validation.
-     *
-     * @param path - The URL path.
-     * @param request - The FormRequest class for validation.
-     * @param handler - The handler function or controller method.
-     *
-     * @example
-     * ```typescript
-     * router.get('/search', SearchRequest, [Controller, 'search']);
-     * ```
-     */
     get(path: string, request: FormRequestClass, handler: RouteHandler): Route;
+    get(path: string, middleware: GravitoMiddleware | GravitoMiddleware[], handler: RouteHandler): Route;
     /**
      * Register a POST route.
-     *
-     * @param path - The URL path.
-     * @param handler - The handler function or controller method.
-     * @returns The registered Route instance.
-     *
-     * @example
-     * ```typescript
-     * router.post('/users', [UserController, 'store']);
-     * ```
      */
     post(path: string, handler: RouteHandler): Route;
-    /**
-     * Register a POST route with validation.
-     *
-     * @param path - The URL path.
-     * @param request - The FormRequest class.
-     * @param handler - The handler.
-     *
-     * @example
-     * ```typescript
-     * router.post('/users', StoreUserRequest, [UserController, 'store']);
-     * ```
-     */
     post(path: string, request: FormRequestClass, handler: RouteHandler): Route;
+    post(path: string, middleware: GravitoMiddleware | GravitoMiddleware[], handler: RouteHandler): Route;
     /**
      * Register a PUT route.
-     *
-     * @param path - The URL path.
-     * @param handler - The handler function.
-     * @returns The registered Route instance.
      */
     put(path: string, handler: RouteHandler): Route;
     put(path: string, request: FormRequestClass, handler: RouteHandler): Route;
+    put(path: string, middleware: GravitoMiddleware | GravitoMiddleware[], handler: RouteHandler): Route;
     /**
      * Register a DELETE route.
-     *
-     * @param path - The URL path.
-     * @param handler - The handler function.
-     * @returns The registered Route instance.
      */
     delete(path: string, handler: RouteHandler): Route;
     delete(path: string, request: FormRequestClass, handler: RouteHandler): Route;
+    delete(path: string, middleware: GravitoMiddleware | GravitoMiddleware[], handler: RouteHandler): Route;
     /**
      * Register a PATCH route.
-     *
-     * @param path - The URL path.
-     * @param handler - The handler function.
-     * @returns The registered Route instance.
      */
     patch(path: string, handler: RouteHandler): Route;
     patch(path: string, request: FormRequestClass, handler: RouteHandler): Route;
+    patch(path: string, middleware: GravitoMiddleware | GravitoMiddleware[], handler: RouteHandler): Route;
     /**
      * Register a resource route (Laravel-style).
      */
@@ -995,7 +957,7 @@ declare class Router {
     /**
      * Internal Request Registration
      */
-    req(method: HttpMethod, path: string, requestOrHandler: FormRequestClass | RouteHandler, handler?: RouteHandler, options?: RouteOptions): Route;
+    req(method: HttpMethod, path: string, requestOrHandlerOrMiddleware: FormRequestClass | RouteHandler | GravitoMiddleware | GravitoMiddleware[], handler?: RouteHandler, options?: RouteOptions): Route;
     /**
      * Resolve Controller Instance and Method
      */
@@ -1273,8 +1235,12 @@ declare class PlanetCore {
  * Wraps Photon's request object to implement GravitoRequest
  */
 declare class PhotonRequestWrapper implements GravitoRequest {
-    private photonCtx;
+    readonly photonCtx: Context;
     constructor(photonCtx: Context);
+    /**
+     * Create a proxied instance to delegate to Photon's request
+     */
+    static create(photonCtx: Context): PhotonRequestWrapper;
     get url(): string;
     get method(): string;
     get path(): string;
@@ -2065,7 +2031,7 @@ type Handler = (ctx: FastContext$1) => Response | Promise<Response>;
 /**
  * Middleware function
  */
-type Middleware = (ctx: FastContext$1, next: () => Promise<void>) => void | Promise<void>;
+type Middleware = (ctx: FastContext$1, next: () => Promise<Response | undefined>) => Response | undefined | Promise<Response | undefined>;
 /**
  * Error handler function
  */
@@ -2214,7 +2180,7 @@ declare class Gravito {
      * // Now accessible at /api/users
      * ```
      */
-    route(path: string, app: Gravito): this;
+    route(_path: string, _app: Gravito): this;
     /**
      * Set custom error handler
      *
@@ -2285,10 +2251,6 @@ declare class Gravito {
      * Each middleware can call next() to continue the chain.
      */
     private executeMiddleware;
-    /**
-     * Handle 404 Not Found (Async version for dynamic/middleware paths)
-     */
-    private handleNotFound;
     /**
      * Handle errors (Async version for dynamic/middleware paths)
      */
@@ -2429,7 +2391,6 @@ declare class AOTRouter {
  */
 declare class FastContext implements FastContext$1 {
     private _req;
-    private _statusCode;
     private _headers;
     /**
      * Reset context for pooling
@@ -2445,7 +2406,7 @@ declare class FastContext implements FastContext$1 {
     redirect(url: string, status?: 301 | 302 | 303 | 307 | 308): Response;
     body(data: BodyInit | null, status?: number): Response;
     header(name: string, value: string): void;
-    status(code: number): void;
+    status(_code: number): void;
 }
 
 /**
@@ -2659,4 +2620,4 @@ declare const VERSION: string;
  */
 declare function defineConfig(config: GravitoConfig): GravitoConfig;
 
-export { type ActionCallback, type AdapterConfig, type AdapterFactory, type ApiFailure, type ApiSuccess, Application, type ApplicationConfig, Arr, AuthenticationException, AuthorizationException, type BodySizeLimitOptions, type CacheService, type Channel, ConfigManager, ConsoleLogger, Container, ContentfulStatusCode, type ControllerClass, CookieJar, type CookieOptions, type CorsOptions, type CorsOrigin, type CsrfOptions, type DataPath, DumpDieError, type DumpOptions, Encrypter, type EncrypterOptions, type ErrorBag, type ErrorHandlerContext, Event, EventManager, type ExceptionOptions, type Factory, type FilterCallback, type FormRequestClass, type FormRequestLike, type GlobalErrorHandlersMode, type GlobalProcessErrorHandlerContext, type GlobalProcessErrorKind, GravitoAdapter, type GravitoConfig, GravitoContext, GravitoErrorHandler, GravitoException, GravitoHandler, type GravitoManifest, GravitoMiddleware, GravitoNotFoundHandler, type GravitoOrbit, GravitoRequest, GravitoServer, GravitoVariables, type HeaderTokenGateOptions, HookManager, type HstsOptions, type HttpAdapter, HttpException, HttpMethod, HttpTester, type Listener, type Logger, ModelNotFoundException, type PathSegment, PhotonAdapter, PhotonContextWrapper, PhotonRequestWrapper, PlanetCore, type RegisterGlobalErrorHandlersOptions, type RequireHeaderTokenOptions, Route, type RouteDefinition, type RouteHandler, type RouteOptions, Router, type RuntimeAdapter, type RuntimeFileStat, type RuntimeKind, type RuntimePasswordAdapter, type RuntimeProcess, type RuntimeServeConfig, type RuntimeServer, type RuntimeSpawnOptions, type RuntimeSqliteDatabase, type RuntimeSqliteStatement, type SecurityHeadersOptions, ServiceProvider, type ShouldBroadcast, type ShouldQueue, StatusCode, Str, TestResponse, ThrottleRequests, VERSION, type ValidationError, ValidationException, type ViewService, abort, abortIf, abortUnless, app, blank, bodySizeLimit, config, cors, createErrorBag, createGravitoAdapter, createHeaderGate, createHttpTester, createPhotonAdapter, createSqliteDatabase, csrfProtection, dataGet, dataHas, dataSet, dd, defineConfig, dump, index as engine, env, errors, fail, filled, getCsrfToken, getPasswordAdapter, getRuntimeAdapter, getRuntimeEnv, hasApp, isHttpAdapter, jsonFail, jsonSuccess, logger, ok, old, registerGlobalErrorHandlers, requireHeaderToken, router, securityHeaders, setApp, tap, throwIf, throwUnless, value };
+export { type ActionCallback, type AdapterConfig, type AdapterFactory, type ApiFailure, type ApiSuccess, Application, type ApplicationConfig, Arr, AuthenticationException, AuthorizationException, type BodySizeLimitOptions, type CacheService, type Channel, ConfigManager, ConsoleLogger, Container, ContentfulStatusCode, type ControllerClass, CookieJar, type CookieOptions, type CorsOptions, type CorsOrigin, type CsrfOptions, type DataPath, DumpDieError, type DumpOptions, Encrypter, type EncrypterOptions, type ErrorBag, type ErrorHandlerContext, Event, EventManager, type ExceptionOptions, type Factory, type FilterCallback, type FormRequestClass, type FormRequestLike, type GlobalErrorHandlersMode, type GlobalProcessErrorHandlerContext, type GlobalProcessErrorKind, GravitoAdapter, type GravitoConfig, GravitoContext, GravitoErrorHandler, GravitoException, GravitoHandler, type GravitoManifest, GravitoMiddleware, GravitoNotFoundHandler, type GravitoOrbit, GravitoRequest, GravitoServer, GravitoVariables, type HeaderTokenGateOptions, HookManager, type HstsOptions, type HttpAdapter, HttpException, HttpMethod, HttpTester, type Listener, type Logger, ModelNotFoundException, type PathSegment, PhotonAdapter, PhotonContextWrapper, PhotonRequestWrapper, PlanetCore, type RegisterGlobalErrorHandlersOptions, type RequireHeaderTokenOptions, Route, type RouteDefinition, RouteGroup, type RouteHandler, type RouteOptions, Router, type RuntimeAdapter, type RuntimeFileStat, type RuntimeKind, type RuntimePasswordAdapter, type RuntimeProcess, type RuntimeServeConfig, type RuntimeServer, type RuntimeSpawnOptions, type RuntimeSqliteDatabase, type RuntimeSqliteStatement, type SecurityHeadersOptions, ServiceProvider, type ShouldBroadcast, type ShouldQueue, StatusCode, Str, TestResponse, ThrottleRequests, VERSION, type ValidationError, ValidationException, type ViewService, abort, abortIf, abortUnless, app, blank, bodySizeLimit, config, cors, createErrorBag, createGravitoAdapter, createHeaderGate, createHttpTester, createPhotonAdapter, createSqliteDatabase, csrfProtection, dataGet, dataHas, dataSet, dd, defineConfig, dump, index as engine, env, errors, fail, filled, getCsrfToken, getPasswordAdapter, getRuntimeAdapter, getRuntimeEnv, hasApp, isHttpAdapter, jsonFail, jsonSuccess, logger, ok, old, registerGlobalErrorHandlers, requireHeaderToken, router, securityHeaders, setApp, tap, throwIf, throwUnless, value };

package/dist/index.js

@@ -13,7 +13,7 @@ var __export = (target, all) => {
 // package.json
 var package_default = {
   name: "@gravito/core",
-  version: "1.1.0",
+  version: "1.2.0",
   description: "",
   module: "./dist/index.js",
   main: "./dist/index.cjs",
@@ -85,10 +85,45 @@ var package_default = {
 };
 
 // src/adapters/PhotonAdapter.ts
-var PhotonRequestWrapper = class {
+var PhotonRequestWrapper = class _PhotonRequestWrapper {
   constructor(photonCtx) {
     this.photonCtx = photonCtx;
   }
+  /**
+   * Create a proxied instance to delegate to Photon's request
+   */
+  static create(photonCtx) {
+    const instance = new _PhotonRequestWrapper(photonCtx);
+    return new Proxy(instance, {
+      get(target, prop, receiver) {
+        if (prop in target) {
+          const value2 = Reflect.get(target, prop, receiver);
+          if (typeof value2 === "function") {
+            return value2.bind(target);
+          }
+          return value2;
+        }
+        const nativeReq = target.photonCtx.req;
+        if (prop in nativeReq) {
+          const value2 = nativeReq[prop];
+          if (typeof value2 === "function") {
+            return value2.bind(nativeReq);
+          }
+          return value2;
+        }
+        return void 0;
+      },
+      // Allow setting properties (for addValidated etc.)
+      set(target, prop, value2) {
+        if (prop in target) {
+          return Reflect.set(target, prop, value2);
+        }
+        ;
+        target.photonCtx.req[prop] = value2;
+        return true;
+      }
+    });
+  }
   get url() {
     return this.photonCtx.req.url;
   }
@@ -147,7 +182,7 @@ var PhotonRequestWrapper = class {
 var PhotonContextWrapper = class _PhotonContextWrapper {
   constructor(photonCtx) {
     this.photonCtx = photonCtx;
-    this._req = new PhotonRequestWrapper(photonCtx);
+    this._req = PhotonRequestWrapper.create(photonCtx);
   }
   _req;
   /**
@@ -259,7 +294,7 @@ function toPhotonMiddleware(middleware) {
   return async (c, next) => {
     const ctx = PhotonContextWrapper.create(c);
     const gravitoNext = async () => {
-      await next();
+      return await next();
     };
     return middleware(ctx, gravitoNext);
   };
@@ -2722,20 +2757,20 @@ var RouteGroup = class _RouteGroup {
   group(callback) {
     callback(this);
   }
-  get(path2, requestOrHandler, handler) {
-    return this.router.req("get", path2, requestOrHandler, handler, this.options);
+  get(path2, requestOrHandlerOrMiddleware, handler) {
+    return this.router.req("get", path2, requestOrHandlerOrMiddleware, handler, this.options);
   }
-  post(path2, requestOrHandler, handler) {
-    return this.router.req("post", path2, requestOrHandler, handler, this.options);
+  post(path2, requestOrHandlerOrMiddleware, handler) {
+    return this.router.req("post", path2, requestOrHandlerOrMiddleware, handler, this.options);
   }
-  put(path2, requestOrHandler, handler) {
-    return this.router.req("put", path2, requestOrHandler, handler, this.options);
+  put(path2, requestOrHandlerOrMiddleware, handler) {
+    return this.router.req("put", path2, requestOrHandlerOrMiddleware, handler, this.options);
   }
-  delete(path2, requestOrHandler, handler) {
-    return this.router.req("delete", path2, requestOrHandler, handler, this.options);
+  delete(path2, requestOrHandlerOrMiddleware, handler) {
+    return this.router.req("delete", path2, requestOrHandlerOrMiddleware, handler, this.options);
   }
-  patch(path2, requestOrHandler, handler) {
-    return this.router.req("patch", path2, requestOrHandler, handler, this.options);
+  patch(path2, requestOrHandlerOrMiddleware, handler) {
+    return this.router.req("patch", path2, requestOrHandlerOrMiddleware, handler, this.options);
   }
   resource(name, controller, options = {}) {
     const actions = [
@@ -2911,20 +2946,20 @@ var Router = class {
   middleware(...handlers) {
     return new RouteGroup(this, { middleware: handlers.flat() });
   }
-  get(path2, requestOrHandler, handler) {
-    return this.req("get", path2, requestOrHandler, handler);
+  get(path2, requestOrHandlerOrMiddleware, handler) {
+    return this.req("get", path2, requestOrHandlerOrMiddleware, handler);
   }
-  post(path2, requestOrHandler, handler) {
-    return this.req("post", path2, requestOrHandler, handler);
+  post(path2, requestOrHandlerOrMiddleware, handler) {
+    return this.req("post", path2, requestOrHandlerOrMiddleware, handler);
   }
-  put(path2, requestOrHandler, handler) {
-    return this.req("put", path2, requestOrHandler, handler);
+  put(path2, requestOrHandlerOrMiddleware, handler) {
+    return this.req("put", path2, requestOrHandlerOrMiddleware, handler);
   }
-  delete(path2, requestOrHandler, handler) {
-    return this.req("delete", path2, requestOrHandler, handler);
+  delete(path2, requestOrHandlerOrMiddleware, handler) {
+    return this.req("delete", path2, requestOrHandlerOrMiddleware, handler);
   }
-  patch(path2, requestOrHandler, handler) {
-    return this.req("patch", path2, requestOrHandler, handler);
+  patch(path2, requestOrHandlerOrMiddleware, handler) {
+    return this.req("patch", path2, requestOrHandlerOrMiddleware, handler);
   }
   /**
    * Register a resource route (Laravel-style).
@@ -2970,17 +3005,25 @@ var Router = class {
   /**
    * Internal Request Registration
    */
-  req(method, path2, requestOrHandler, handler, options = {}) {
+  req(method, path2, requestOrHandlerOrMiddleware, handler, options = {}) {
     const fullPath = (options.prefix || "") + path2;
     let formRequestMiddleware = null;
+    let routeMiddleware = [];
     let finalRouteHandler;
     if (handler !== void 0) {
-      if (isFormRequestClass(requestOrHandler)) {
-        formRequestMiddleware = formRequestToMiddleware(requestOrHandler);
+      if (isFormRequestClass(requestOrHandlerOrMiddleware)) {
+        formRequestMiddleware = formRequestToMiddleware(requestOrHandlerOrMiddleware);
+      } else {
+        const middleware = requestOrHandlerOrMiddleware;
+        if (Array.isArray(middleware)) {
+          routeMiddleware = middleware;
+        } else {
+          routeMiddleware = [middleware];
+        }
       }
       finalRouteHandler = handler;
     } else {
-      finalRouteHandler = requestOrHandler;
+      finalRouteHandler = requestOrHandlerOrMiddleware;
     }
     let resolvedHandler;
     if (Array.isArray(finalRouteHandler)) {
@@ -2996,6 +3039,9 @@ var Router = class {
     if (formRequestMiddleware) {
       handlers.push(formRequestMiddleware);
     }
+    if (routeMiddleware.length > 0) {
+      handlers.push(...routeMiddleware);
+    }
     handlers.push(resolvedHandler);
     if (options.domain) {
       const domainCheck = async (c, next) => {
@@ -3270,8 +3316,7 @@ var PlanetCore = class _PlanetCore {
       const cookieJar = new CookieJar(this.encrypter);
       c.set("cookieJar", cookieJar);
       c.route = (name, params, query) => this.router.url(name, params, query);
-      await next();
-      return void 0;
+      return await next();
     });
     this.router = new Router(this);
     this.adapter.onError(async (err, c) => {
@@ -4790,7 +4835,7 @@ var AOTRouter = class {
    * @param path - Matched path
    * @returns Route key or null
    */
-  findDynamicRouteKey(method, path2) {
+  findDynamicRouteKey(method, _path) {
     for (const key of this.pathMiddleware.keys()) {
       if (key.startsWith(`${method}:`)) {
         return key;
@@ -4921,7 +4966,7 @@ var FastRequestImpl = class {
 };
 var FastContext = class {
   _req = new FastRequestImpl();
-  _statusCode = 200;
+  // private _statusCode = 200
   _headers = new Headers();
   // Reuse this object
   /**
@@ -4932,7 +4977,6 @@ var FastContext = class {
    */
   reset(request, params = {}) {
     this._req.reset(request, params);
-    this._statusCode = 200;
     this._headers = new Headers();
     return this;
   }
@@ -4982,8 +5026,7 @@ var FastContext = class {
   header(name, value2) {
     this._headers.set(name, value2);
   }
-  status(code) {
-    this._statusCode = code;
+  status(_code) {
   }
 };
 
@@ -5313,7 +5356,7 @@ var Gravito = class {
    * // Now accessible at /api/users
    * ```
    */
-  route(path2, app2) {
+  route(_path, _app) {
     console.warn("route() method is not yet fully implemented");
     return this;
   }
@@ -5518,21 +5561,26 @@ var Gravito = class {
     const next = async () => {
       if (index < middleware.length) {
         const mw = middleware[index++];
-        await mw(ctx, next);
+        return await mw(ctx, next);
       }
+      return void 0;
     };
-    await next();
+    const result = await next();
+    if (result instanceof Response) {
+      return result;
+    }
     return await handler(ctx);
   }
-  /**
+  /*
    * Handle 404 Not Found (Async version for dynamic/middleware paths)
+   * Note: Currently unused as we handle 404s via handleNotFoundSync or inline
    */
-  async handleNotFound(ctx) {
-    if (this.notFoundHandler) {
-      return await this.notFoundHandler(ctx);
-    }
-    return ctx.json({ error: "Not Found" }, 404);
-  }
+  // private async handleNotFound(ctx: FastContext): Promise<Response> {
+  //   if (this.notFoundHandler) {
+  //     return await this.notFoundHandler(ctx)
+  //   }
+  //   return ctx.json({ error: 'Not Found' }, 404)
+  // }
   /**
    * Handle errors (Async version for dynamic/middleware paths)
    */
@@ -5581,6 +5629,7 @@ export {
   PhotonRequestWrapper,
   PlanetCore,
   Route,
+  RouteGroup,
   Router,
   ServiceProvider,
   Str,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gravito/core",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "",
   "module": "./dist/index.js",
   "main": "./dist/index.cjs",