@h3ravel/shared 0.16.7 → 0.17.0

package/dist/index.cjs

@@ -31,10 +31,34 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var src_exports = {};
 __export(src_exports, {
+  HttpContext: () => HttpContext,
   PathLoader: () => PathLoader
 });
 module.exports = __toCommonJS(src_exports);
 
+// src/Contracts/IHttp.ts
+var HttpContext = class _HttpContext {
+  static {
+    __name(this, "HttpContext");
+  }
+  app;
+  request;
+  response;
+  constructor(app, request, response) {
+    this.app = app;
+    this.request = request;
+    this.response = response;
+  }
+  /**
+   * Factory method to create a new HttpContext instance from a context object.
+   * @param ctx - Object containing app, request, and response
+   * @returns A new HttpContext instance
+   */
+  static init(ctx) {
+    return new _HttpContext(ctx.app, ctx.request, ctx.response);
+  }
+};
+
 // src/Utils/PathLoader.ts
 var import_path = __toESM(require("path"), 1);
 var PathLoader = class {
@@ -83,6 +107,7 @@ var PathLoader = class {
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  HttpContext,
   PathLoader
 });
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/Utils/PathLoader.ts"],"sourcesContent":["/**\n * @file Automatically generated by barrelsby.\n */\n\nexport * from './Contracts/BindingsContract';\nexport * from './Contracts/IApplication';\nexport * from './Contracts/IContainer';\nexport * from './Contracts/IHttp';\nexport * from './Contracts/IRequest';\nexport * from './Contracts/IResponse';\nexport * from './Contracts/IServiceProvider';\nexport * from './Contracts/ObjContract';\nexport * from './Utils/PathLoader';\n","import { IPathName } from '../Contracts/IApplication'\nimport nodepath from 'path'\n\nexport class PathLoader {\n    private paths = {\n        base: '',\n        views: '/src/resources/views',\n        assets: '/public/assets',\n        routes: '/src/routes',\n        config: '/src/config',\n        public: '/public',\n        storage: '/storage',\n    }\n\n    /**\n     * Dynamically retrieves a path property from the class.\n     * Any property ending with \"Path\" is accessible automatically.\n     *\n     * @param name - The base name of the path property\n     * @param base - The base path to include to the path\n     * @returns \n     */\n    getPath (name: IPathName, base?: string): string {\n        let path: string;\n\n        if (base && name !== 'base') {\n            path = nodepath.join(base, this.paths[name])\n        } else {\n            path = this.paths[name]\n        }\n        return path.replace('/src/', `/${process.env.SRC_PATH ?? 'src'}/`.replace(/([^:]\\/)\\/+/g, \"$1\"))\n    }\n\n    /**\n     * Programatically set the paths.\n     *\n     * @param name - The base name of the path property\n     * @param path - The new path\n     * @param base - The base path to include to the path\n     */\n    setPath (name: IPathName, path: string, base?: string) {\n        if (base && name !== 'base') {\n            this.paths[name] = nodepath.join(base, path)\n        }\n\n        this.paths[name] = path\n    }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;;;;;;;ACCA,kBAAqB;AAEd,IAAMA,aAAN,MAAMA;EAFb,OAEaA;;;EACDC,QAAQ;IACZC,MAAM;IACNC,OAAO;IACPC,QAAQ;IACRC,QAAQ;IACRC,QAAQ;IACRC,QAAQ;IACRC,SAAS;EACb;;;;;;;;;EAUAC,QAASC,MAAiBR,MAAuB;AAC7C,QAAIS;AAEJ,QAAIT,QAAQQ,SAAS,QAAQ;AACzBC,aAAOC,YAAAA,QAASC,KAAKX,MAAM,KAAKD,MAAMS,IAAAA,CAAK;IAC/C,OAAO;AACHC,aAAO,KAAKV,MAAMS,IAAAA;IACtB;AACA,WAAOC,KAAKG,QAAQ,SAAS,IAAIC,QAAQC,IAAIC,YAAY,KAAA,IAASH,QAAQ,gBAAgB,IAAA,CAAA;EAC9F;;;;;;;;EASAI,QAASR,MAAiBC,MAAcT,MAAe;AACnD,QAAIA,QAAQQ,SAAS,QAAQ;AACzB,WAAKT,MAAMS,IAAAA,IAAQE,YAAAA,QAASC,KAAKX,MAAMS,IAAAA;IAC3C;AAEA,SAAKV,MAAMS,IAAAA,IAAQC;EACvB;AACJ;","names":["PathLoader","paths","base","views","assets","routes","config","public","storage","getPath","name","path","nodepath","join","replace","process","env","SRC_PATH","setPath"]}
+{"version":3,"sources":["../src/index.ts","../src/Contracts/IHttp.ts","../src/Utils/PathLoader.ts"],"sourcesContent":["/**\n * @file Automatically generated by barrelsby.\n */\n\nexport * from './Contracts/BindingsContract';\nexport * from './Contracts/IApplication';\nexport * from './Contracts/IContainer';\nexport * from './Contracts/IHttp';\nexport * from './Contracts/IRequest';\nexport * from './Contracts/IResponse';\nexport * from './Contracts/IServiceProvider';\nexport * from './Contracts/ObjContract';\nexport * from './Utils/PathLoader';\n","import type { Middleware, MiddlewareOptions } from 'h3'\n\nimport { IApplication } from './IApplication'\nimport { IRequest } from './IRequest'\nimport { IResponse } from './IResponse'\n\nexport type RouterEnd = 'get' | 'delete' | 'put' | 'post' | 'patch' | 'apiResource' | 'group' | 'route';\n\n/**\n * Interface for the Router contract, defining methods for HTTP routing.\n */\nexport interface IRouter {\n    /**\n     * Registers a GET route.\n     * @param path - The route path.\n     * @param definition - The handler function or [controller class, method] array.\n     * @param name - Optional route name.\n     * @param middleware - Optional middleware array.\n     */\n    get (\n        path: string,\n        definition: EventHandler | [(new (...args: any[]) => IController), methodName: string],\n        name?: string,\n        middleware?: IMiddleware[]\n    ): Omit<this, RouterEnd>;\n\n    /**\n     * Registers a POST route.\n     * @param path - The route path.\n     * @param definition - The handler function or [controller class, method] array.\n     * @param name - Optional route name.\n     * @param middleware - Optional middleware array.\n     */\n    post (\n        path: string,\n        definition: EventHandler | [(new (...args: any[]) => IController), methodName: string],\n        name?: string,\n        middleware?: IMiddleware[]\n    ): Omit<this, RouterEnd>;\n\n    /**\n     * Registers a PUT route.\n     * @param path - The route path.\n     * @param definition - The handler function or [controller class, method] array.\n     * @param name - Optional route name.\n     * @param middleware - Optional middleware array.\n     */\n    put (\n        path: string,\n        definition: EventHandler | [(new (...args: any[]) => IController), methodName: string],\n        name?: string,\n        middleware?: IMiddleware[]\n    ): Omit<this, RouterEnd>;\n\n    /**\n     * Registers a DELETE route.\n     * @param path - The route path.\n     * @param definition - The handler function or [controller class, method] array.\n     * @param name - Optional route name.\n     * @param middleware - Optional middleware array.\n     */\n    delete (\n        path: string,\n        definition: EventHandler | [(new (...args: any[]) => IController), methodName: string],\n        name?: string,\n        middleware?: IMiddleware[]\n    ): Omit<this, RouterEnd>;\n\n    /**\n     * Registers an API resource with standard CRUD routes.\n     * @param path - The base path for the resource.\n     * @param controller - The controller class handling the resource.\n     * @param middleware - Optional middleware array.\n     */\n    apiResource (\n        path: string,\n        controller: new (app: IApplication) => IController,\n        middleware?: IMiddleware[]\n    ): Omit<this, RouterEnd | 'name'>;\n\n    /**\n     * Generates a URL for a named route.\n     * @param name - The name of the route.\n     * @param params - Optional parameters to replace in the route path.\n     * @returns The generated URL or undefined if the route is not found.\n     */\n    route (name: string, params?: Record<string, string>): string | undefined;\n\n\n    /**\n     * Set the name of the current route\n     * \n     * @param name \n     */\n    name (name: string): this\n\n    /**\n     * Groups routes with shared prefix or middleware.\n     * @param options - Configuration for prefix or middleware.\n     * @param callback - Callback function defining grouped routes.\n     */\n    group (options: { prefix?: string; middleware?: EventHandler[] }, callback: () => void): this;\n\n    /**\n     * Registers middleware for a specific path.\n     * @param path - The path to apply the middleware.\n     * @param handler - The middleware handler.\n     * @param opts - Optional middleware options.\n     */\n    middleware (path: string | IMiddleware[], handler: Middleware, opts?: MiddlewareOptions): this;\n}\n\n/**\n * Represents the HTTP context for a single request lifecycle.\n * Encapsulates the application instance, request, and response objects.\n */\nexport class HttpContext {\n    constructor(\n        public app: IApplication,\n        public request: IRequest,\n        public response: IResponse\n    ) { }\n\n    /**\n     * Factory method to create a new HttpContext instance from a context object.\n     * @param ctx - Object containing app, request, and response\n     * @returns A new HttpContext instance\n     */\n    static init (ctx: { app: IApplication; request: IRequest; response: IResponse }): HttpContext {\n        /**\n         * Return a new instance\n         */\n        return new HttpContext(ctx.app, ctx.request, ctx.response);\n    }\n}\n\n\n/**\n * Type for EventHandler, representing a function that handles an H3 event.\n */\nexport type EventHandler = (ctx: HttpContext) => any\n\n/**\n * Defines the contract for all controllers.\n * Any controller implementing this must define these methods.\n */\nexport interface IController {\n    show (...ctx: any[]): any\n    index (...ctx: any[]): any\n    store (...ctx: any[]): any\n    update (...ctx: any[]): any\n    destroy (...ctx: any[]): any\n}\n\n/**\n * Defines the contract for all middlewares.\n * Any middleware implementing this must define these methods.\n */\nexport interface IMiddleware {\n    handle (context: HttpContext, next: () => Promise<any>): Promise<any>\n} \n","import { IPathName } from '../Contracts/IApplication'\nimport nodepath from 'path'\n\nexport class PathLoader {\n    private paths = {\n        base: '',\n        views: '/src/resources/views',\n        assets: '/public/assets',\n        routes: '/src/routes',\n        config: '/src/config',\n        public: '/public',\n        storage: '/storage',\n    }\n\n    /**\n     * Dynamically retrieves a path property from the class.\n     * Any property ending with \"Path\" is accessible automatically.\n     *\n     * @param name - The base name of the path property\n     * @param base - The base path to include to the path\n     * @returns \n     */\n    getPath (name: IPathName, base?: string): string {\n        let path: string;\n\n        if (base && name !== 'base') {\n            path = nodepath.join(base, this.paths[name])\n        } else {\n            path = this.paths[name]\n        }\n        return path.replace('/src/', `/${process.env.SRC_PATH ?? 'src'}/`.replace(/([^:]\\/)\\/+/g, \"$1\"))\n    }\n\n    /**\n     * Programatically set the paths.\n     *\n     * @param name - The base name of the path property\n     * @param path - The new path\n     * @param base - The base path to include to the path\n     */\n    setPath (name: IPathName, path: string, base?: string) {\n        if (base && name !== 'base') {\n            this.paths[name] = nodepath.join(base, path)\n        }\n\n        this.paths[name] = path\n    }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;;;;;;;;ACoHO,IAAMA,cAAN,MAAMA,aAAAA;EAJb,OAIaA;;;;;;EACT,YACWC,KACAC,SACAC,UACT;SAHSF,MAAAA;SACAC,UAAAA;SACAC,WAAAA;EACP;;;;;;EAOJ,OAAOC,KAAMC,KAAiF;AAI1F,WAAO,IAAIL,aAAYK,IAAIJ,KAAKI,IAAIH,SAASG,IAAIF,QAAQ;EAC7D;AACJ;;;ACrIA,kBAAqB;AAEd,IAAMG,aAAN,MAAMA;EAFb,OAEaA;;;EACDC,QAAQ;IACZC,MAAM;IACNC,OAAO;IACPC,QAAQ;IACRC,QAAQ;IACRC,QAAQ;IACRC,QAAQ;IACRC,SAAS;EACb;;;;;;;;;EAUAC,QAASC,MAAiBR,MAAuB;AAC7C,QAAIS;AAEJ,QAAIT,QAAQQ,SAAS,QAAQ;AACzBC,aAAOC,YAAAA,QAASC,KAAKX,MAAM,KAAKD,MAAMS,IAAAA,CAAK;IAC/C,OAAO;AACHC,aAAO,KAAKV,MAAMS,IAAAA;IACtB;AACA,WAAOC,KAAKG,QAAQ,SAAS,IAAIC,QAAQC,IAAIC,YAAY,KAAA,IAASH,QAAQ,gBAAgB,IAAA,CAAA;EAC9F;;;;;;;;EASAI,QAASR,MAAiBC,MAAcT,MAAe;AACnD,QAAIA,QAAQQ,SAAS,QAAQ;AACzB,WAAKT,MAAMS,IAAAA,IAAQE,YAAAA,QAASC,KAAKX,MAAMS,IAAAA;IAC3C;AAEA,SAAKV,MAAMS,IAAAA,IAAQC;EACvB;AACJ;","names":["HttpContext","app","request","response","init","ctx","PathLoader","paths","base","views","assets","routes","config","public","storage","getPath","name","path","nodepath","join","replace","process","env","SRC_PATH","setPath"]}

package/dist/index.d.cts

@@ -229,7 +229,7 @@ interface IResponse {
     getEvent<K extends DotNestedKeys<H3Event>>(key: K): DotNestedValue<H3Event, K>;
 }
 
-type RouterEnd = 'get' | 'delete' | 'put' | 'post' | 'apiResource' | 'group' | 'route';
+type RouterEnd = 'get' | 'delete' | 'put' | 'post' | 'patch' | 'apiResource' | 'group' | 'route';
 /**
  * Interface for the Router contract, defining methods for HTTP routing.
  */
@@ -303,10 +303,25 @@ interface IRouter {
      */
     middleware(path: string | IMiddleware[], handler: Middleware, opts?: MiddlewareOptions): this;
 }
-interface HttpContext {
+/**
+ * Represents the HTTP context for a single request lifecycle.
+ * Encapsulates the application instance, request, and response objects.
+ */
+declare class HttpContext {
     app: IApplication;
     request: IRequest;
     response: IResponse;
+    constructor(app: IApplication, request: IRequest, response: IResponse);
+    /**
+     * Factory method to create a new HttpContext instance from a context object.
+     * @param ctx - Object containing app, request, and response
+     * @returns A new HttpContext instance
+     */
+    static init(ctx: {
+        app: IApplication;
+        request: IRequest;
+        response: IResponse;
+    }): HttpContext;
 }
 /**
  * Type for EventHandler, representing a function that handles an H3 event.
@@ -317,11 +332,11 @@ type EventHandler = (ctx: HttpContext) => any;
  * Any controller implementing this must define these methods.
  */
 interface IController {
-    show(ctx: HttpContext): any;
-    index(ctx: HttpContext): any;
-    store(ctx: HttpContext): any;
-    update(ctx: HttpContext): any;
-    destroy(ctx: HttpContext): any;
+    show(...ctx: any[]): any;
+    index(...ctx: any[]): any;
+    store(...ctx: any[]): any;
+    update(...ctx: any[]): any;
+    destroy(...ctx: any[]): any;
 }
 /**
  * Defines the contract for all middlewares.
@@ -379,4 +394,4 @@ type Bindings = {
 };
 type UseKey = keyof RemoveIndexSignature<Bindings>;
 
-export { type Bindings, type DotFlatten, type DotNestedKeys, type DotNestedValue, type EventHandler, type HttpContext, type IApplication, type IContainer, type IController, type IMiddleware, type IPathName, type IRequest, type IResponse, type IRouter, type IServiceProvider, PathLoader, type RouterEnd, type UseKey };
+export { type Bindings, type DotFlatten, type DotNestedKeys, type DotNestedValue, type EventHandler, HttpContext, type IApplication, type IContainer, type IController, type IMiddleware, type IPathName, type IRequest, type IResponse, type IRouter, type IServiceProvider, PathLoader, type RouterEnd, type UseKey };

package/dist/index.d.ts

@@ -229,7 +229,7 @@ interface IResponse {
     getEvent<K extends DotNestedKeys<H3Event>>(key: K): DotNestedValue<H3Event, K>;
 }
 
-type RouterEnd = 'get' | 'delete' | 'put' | 'post' | 'apiResource' | 'group' | 'route';
+type RouterEnd = 'get' | 'delete' | 'put' | 'post' | 'patch' | 'apiResource' | 'group' | 'route';
 /**
  * Interface for the Router contract, defining methods for HTTP routing.
  */
@@ -303,10 +303,25 @@ interface IRouter {
      */
     middleware(path: string | IMiddleware[], handler: Middleware, opts?: MiddlewareOptions): this;
 }
-interface HttpContext {
+/**
+ * Represents the HTTP context for a single request lifecycle.
+ * Encapsulates the application instance, request, and response objects.
+ */
+declare class HttpContext {
     app: IApplication;
     request: IRequest;
     response: IResponse;
+    constructor(app: IApplication, request: IRequest, response: IResponse);
+    /**
+     * Factory method to create a new HttpContext instance from a context object.
+     * @param ctx - Object containing app, request, and response
+     * @returns A new HttpContext instance
+     */
+    static init(ctx: {
+        app: IApplication;
+        request: IRequest;
+        response: IResponse;
+    }): HttpContext;
 }
 /**
  * Type for EventHandler, representing a function that handles an H3 event.
@@ -317,11 +332,11 @@ type EventHandler = (ctx: HttpContext) => any;
  * Any controller implementing this must define these methods.
  */
 interface IController {
-    show(ctx: HttpContext): any;
-    index(ctx: HttpContext): any;
-    store(ctx: HttpContext): any;
-    update(ctx: HttpContext): any;
-    destroy(ctx: HttpContext): any;
+    show(...ctx: any[]): any;
+    index(...ctx: any[]): any;
+    store(...ctx: any[]): any;
+    update(...ctx: any[]): any;
+    destroy(...ctx: any[]): any;
 }
 /**
  * Defines the contract for all middlewares.
@@ -379,4 +394,4 @@ type Bindings = {
 };
 type UseKey = keyof RemoveIndexSignature<Bindings>;
 
-export { type Bindings, type DotFlatten, type DotNestedKeys, type DotNestedValue, type EventHandler, type HttpContext, type IApplication, type IContainer, type IController, type IMiddleware, type IPathName, type IRequest, type IResponse, type IRouter, type IServiceProvider, PathLoader, type RouterEnd, type UseKey };
+export { type Bindings, type DotFlatten, type DotNestedKeys, type DotNestedValue, type EventHandler, HttpContext, type IApplication, type IContainer, type IController, type IMiddleware, type IPathName, type IRequest, type IResponse, type IRouter, type IServiceProvider, PathLoader, type RouterEnd, type UseKey };

package/dist/index.js

@@ -1,6 +1,29 @@
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 
+// src/Contracts/IHttp.ts
+var HttpContext = class _HttpContext {
+  static {
+    __name(this, "HttpContext");
+  }
+  app;
+  request;
+  response;
+  constructor(app, request, response) {
+    this.app = app;
+    this.request = request;
+    this.response = response;
+  }
+  /**
+   * Factory method to create a new HttpContext instance from a context object.
+   * @param ctx - Object containing app, request, and response
+   * @returns A new HttpContext instance
+   */
+  static init(ctx) {
+    return new _HttpContext(ctx.app, ctx.request, ctx.response);
+  }
+};
+
 // src/Utils/PathLoader.ts
 import nodepath from "path";
 var PathLoader = class {
@@ -48,6 +71,7 @@ var PathLoader = class {
   }
 };
 export {
+  HttpContext,
   PathLoader
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/Utils/PathLoader.ts"],"sourcesContent":["import { IPathName } from '../Contracts/IApplication'\nimport nodepath from 'path'\n\nexport class PathLoader {\n    private paths = {\n        base: '',\n        views: '/src/resources/views',\n        assets: '/public/assets',\n        routes: '/src/routes',\n        config: '/src/config',\n        public: '/public',\n        storage: '/storage',\n    }\n\n    /**\n     * Dynamically retrieves a path property from the class.\n     * Any property ending with \"Path\" is accessible automatically.\n     *\n     * @param name - The base name of the path property\n     * @param base - The base path to include to the path\n     * @returns \n     */\n    getPath (name: IPathName, base?: string): string {\n        let path: string;\n\n        if (base && name !== 'base') {\n            path = nodepath.join(base, this.paths[name])\n        } else {\n            path = this.paths[name]\n        }\n        return path.replace('/src/', `/${process.env.SRC_PATH ?? 'src'}/`.replace(/([^:]\\/)\\/+/g, \"$1\"))\n    }\n\n    /**\n     * Programatically set the paths.\n     *\n     * @param name - The base name of the path property\n     * @param path - The new path\n     * @param base - The base path to include to the path\n     */\n    setPath (name: IPathName, path: string, base?: string) {\n        if (base && name !== 'base') {\n            this.paths[name] = nodepath.join(base, path)\n        }\n\n        this.paths[name] = path\n    }\n}\n"],"mappings":";;;;AACA,OAAOA,cAAc;AAEd,IAAMC,aAAN,MAAMA;EAFb,OAEaA;;;EACDC,QAAQ;IACZC,MAAM;IACNC,OAAO;IACPC,QAAQ;IACRC,QAAQ;IACRC,QAAQ;IACRC,QAAQ;IACRC,SAAS;EACb;;;;;;;;;EAUAC,QAASC,MAAiBR,MAAuB;AAC7C,QAAIS;AAEJ,QAAIT,QAAQQ,SAAS,QAAQ;AACzBC,aAAOC,SAASC,KAAKX,MAAM,KAAKD,MAAMS,IAAAA,CAAK;IAC/C,OAAO;AACHC,aAAO,KAAKV,MAAMS,IAAAA;IACtB;AACA,WAAOC,KAAKG,QAAQ,SAAS,IAAIC,QAAQC,IAAIC,YAAY,KAAA,IAASH,QAAQ,gBAAgB,IAAA,CAAA;EAC9F;;;;;;;;EASAI,QAASR,MAAiBC,MAAcT,MAAe;AACnD,QAAIA,QAAQQ,SAAS,QAAQ;AACzB,WAAKT,MAAMS,IAAAA,IAAQE,SAASC,KAAKX,MAAMS,IAAAA;IAC3C;AAEA,SAAKV,MAAMS,IAAAA,IAAQC;EACvB;AACJ;","names":["nodepath","PathLoader","paths","base","views","assets","routes","config","public","storage","getPath","name","path","nodepath","join","replace","process","env","SRC_PATH","setPath"]}
+{"version":3,"sources":["../src/Contracts/IHttp.ts","../src/Utils/PathLoader.ts"],"sourcesContent":["import type { Middleware, MiddlewareOptions } from 'h3'\n\nimport { IApplication } from './IApplication'\nimport { IRequest } from './IRequest'\nimport { IResponse } from './IResponse'\n\nexport type RouterEnd = 'get' | 'delete' | 'put' | 'post' | 'patch' | 'apiResource' | 'group' | 'route';\n\n/**\n * Interface for the Router contract, defining methods for HTTP routing.\n */\nexport interface IRouter {\n    /**\n     * Registers a GET route.\n     * @param path - The route path.\n     * @param definition - The handler function or [controller class, method] array.\n     * @param name - Optional route name.\n     * @param middleware - Optional middleware array.\n     */\n    get (\n        path: string,\n        definition: EventHandler | [(new (...args: any[]) => IController), methodName: string],\n        name?: string,\n        middleware?: IMiddleware[]\n    ): Omit<this, RouterEnd>;\n\n    /**\n     * Registers a POST route.\n     * @param path - The route path.\n     * @param definition - The handler function or [controller class, method] array.\n     * @param name - Optional route name.\n     * @param middleware - Optional middleware array.\n     */\n    post (\n        path: string,\n        definition: EventHandler | [(new (...args: any[]) => IController), methodName: string],\n        name?: string,\n        middleware?: IMiddleware[]\n    ): Omit<this, RouterEnd>;\n\n    /**\n     * Registers a PUT route.\n     * @param path - The route path.\n     * @param definition - The handler function or [controller class, method] array.\n     * @param name - Optional route name.\n     * @param middleware - Optional middleware array.\n     */\n    put (\n        path: string,\n        definition: EventHandler | [(new (...args: any[]) => IController), methodName: string],\n        name?: string,\n        middleware?: IMiddleware[]\n    ): Omit<this, RouterEnd>;\n\n    /**\n     * Registers a DELETE route.\n     * @param path - The route path.\n     * @param definition - The handler function or [controller class, method] array.\n     * @param name - Optional route name.\n     * @param middleware - Optional middleware array.\n     */\n    delete (\n        path: string,\n        definition: EventHandler | [(new (...args: any[]) => IController), methodName: string],\n        name?: string,\n        middleware?: IMiddleware[]\n    ): Omit<this, RouterEnd>;\n\n    /**\n     * Registers an API resource with standard CRUD routes.\n     * @param path - The base path for the resource.\n     * @param controller - The controller class handling the resource.\n     * @param middleware - Optional middleware array.\n     */\n    apiResource (\n        path: string,\n        controller: new (app: IApplication) => IController,\n        middleware?: IMiddleware[]\n    ): Omit<this, RouterEnd | 'name'>;\n\n    /**\n     * Generates a URL for a named route.\n     * @param name - The name of the route.\n     * @param params - Optional parameters to replace in the route path.\n     * @returns The generated URL or undefined if the route is not found.\n     */\n    route (name: string, params?: Record<string, string>): string | undefined;\n\n\n    /**\n     * Set the name of the current route\n     * \n     * @param name \n     */\n    name (name: string): this\n\n    /**\n     * Groups routes with shared prefix or middleware.\n     * @param options - Configuration for prefix or middleware.\n     * @param callback - Callback function defining grouped routes.\n     */\n    group (options: { prefix?: string; middleware?: EventHandler[] }, callback: () => void): this;\n\n    /**\n     * Registers middleware for a specific path.\n     * @param path - The path to apply the middleware.\n     * @param handler - The middleware handler.\n     * @param opts - Optional middleware options.\n     */\n    middleware (path: string | IMiddleware[], handler: Middleware, opts?: MiddlewareOptions): this;\n}\n\n/**\n * Represents the HTTP context for a single request lifecycle.\n * Encapsulates the application instance, request, and response objects.\n */\nexport class HttpContext {\n    constructor(\n        public app: IApplication,\n        public request: IRequest,\n        public response: IResponse\n    ) { }\n\n    /**\n     * Factory method to create a new HttpContext instance from a context object.\n     * @param ctx - Object containing app, request, and response\n     * @returns A new HttpContext instance\n     */\n    static init (ctx: { app: IApplication; request: IRequest; response: IResponse }): HttpContext {\n        /**\n         * Return a new instance\n         */\n        return new HttpContext(ctx.app, ctx.request, ctx.response);\n    }\n}\n\n\n/**\n * Type for EventHandler, representing a function that handles an H3 event.\n */\nexport type EventHandler = (ctx: HttpContext) => any\n\n/**\n * Defines the contract for all controllers.\n * Any controller implementing this must define these methods.\n */\nexport interface IController {\n    show (...ctx: any[]): any\n    index (...ctx: any[]): any\n    store (...ctx: any[]): any\n    update (...ctx: any[]): any\n    destroy (...ctx: any[]): any\n}\n\n/**\n * Defines the contract for all middlewares.\n * Any middleware implementing this must define these methods.\n */\nexport interface IMiddleware {\n    handle (context: HttpContext, next: () => Promise<any>): Promise<any>\n} \n","import { IPathName } from '../Contracts/IApplication'\nimport nodepath from 'path'\n\nexport class PathLoader {\n    private paths = {\n        base: '',\n        views: '/src/resources/views',\n        assets: '/public/assets',\n        routes: '/src/routes',\n        config: '/src/config',\n        public: '/public',\n        storage: '/storage',\n    }\n\n    /**\n     * Dynamically retrieves a path property from the class.\n     * Any property ending with \"Path\" is accessible automatically.\n     *\n     * @param name - The base name of the path property\n     * @param base - The base path to include to the path\n     * @returns \n     */\n    getPath (name: IPathName, base?: string): string {\n        let path: string;\n\n        if (base && name !== 'base') {\n            path = nodepath.join(base, this.paths[name])\n        } else {\n            path = this.paths[name]\n        }\n        return path.replace('/src/', `/${process.env.SRC_PATH ?? 'src'}/`.replace(/([^:]\\/)\\/+/g, \"$1\"))\n    }\n\n    /**\n     * Programatically set the paths.\n     *\n     * @param name - The base name of the path property\n     * @param path - The new path\n     * @param base - The base path to include to the path\n     */\n    setPath (name: IPathName, path: string, base?: string) {\n        if (base && name !== 'base') {\n            this.paths[name] = nodepath.join(base, path)\n        }\n\n        this.paths[name] = path\n    }\n}\n"],"mappings":";;;;AAoHO,IAAMA,cAAN,MAAMA,aAAAA;EAJb,OAIaA;;;;;;EACT,YACWC,KACAC,SACAC,UACT;SAHSF,MAAAA;SACAC,UAAAA;SACAC,WAAAA;EACP;;;;;;EAOJ,OAAOC,KAAMC,KAAiF;AAI1F,WAAO,IAAIL,aAAYK,IAAIJ,KAAKI,IAAIH,SAASG,IAAIF,QAAQ;EAC7D;AACJ;;;ACrIA,OAAOG,cAAc;AAEd,IAAMC,aAAN,MAAMA;EAFb,OAEaA;;;EACDC,QAAQ;IACZC,MAAM;IACNC,OAAO;IACPC,QAAQ;IACRC,QAAQ;IACRC,QAAQ;IACRC,QAAQ;IACRC,SAAS;EACb;;;;;;;;;EAUAC,QAASC,MAAiBR,MAAuB;AAC7C,QAAIS;AAEJ,QAAIT,QAAQQ,SAAS,QAAQ;AACzBC,aAAOC,SAASC,KAAKX,MAAM,KAAKD,MAAMS,IAAAA,CAAK;IAC/C,OAAO;AACHC,aAAO,KAAKV,MAAMS,IAAAA;IACtB;AACA,WAAOC,KAAKG,QAAQ,SAAS,IAAIC,QAAQC,IAAIC,YAAY,KAAA,IAASH,QAAQ,gBAAgB,IAAA,CAAA;EAC9F;;;;;;;;EASAI,QAASR,MAAiBC,MAAcT,MAAe;AACnD,QAAIA,QAAQQ,SAAS,QAAQ;AACzB,WAAKT,MAAMS,IAAAA,IAAQE,SAASC,KAAKX,MAAMS,IAAAA;IAC3C;AAEA,SAAKV,MAAMS,IAAAA,IAAQC;EACvB;AACJ;","names":["HttpContext","app","request","response","init","ctx","nodepath","PathLoader","paths","base","views","assets","routes","config","public","storage","getPath","name","path","nodepath","join","replace","process","env","SRC_PATH","setPath"]}

package/package.json

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