@h3ravel/shared 0.17.0 → 0.17.2

package/dist/index.cjs

@@ -29,12 +29,12 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/index.ts
-var src_exports = {};
-__export(src_exports, {
+var index_exports = {};
+__export(index_exports, {
   HttpContext: () => HttpContext,
   PathLoader: () => PathLoader
 });
-module.exports = __toCommonJS(src_exports);
+module.exports = __toCommonJS(index_exports);
 
 // src/Contracts/IHttp.ts
 var HttpContext = class _HttpContext {

package/dist/index.cjs.map

@@ -1 +1 @@
-{"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"]}
+{"version":3,"sources":["../src/index.ts","../src/Contracts/IHttp.ts","../src/Utils/PathLoader.ts"],"sourcesContent":["export * 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: () => this): 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\nexport type RouteEventHandler = (...args: any[]) => 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

@@ -294,7 +294,7 @@ interface IRouter {
     group(options: {
         prefix?: string;
         middleware?: EventHandler[];
-    }, callback: () => void): this;
+    }, callback: () => this): this;
     /**
      * Registers middleware for a specific path.
      * @param path - The path to apply the middleware.
@@ -327,6 +327,7 @@ declare class HttpContext {
  * Type for EventHandler, representing a function that handles an H3 event.
  */
 type EventHandler = (ctx: HttpContext) => any;
+type RouteEventHandler = (...args: any[]) => any;
 /**
  * Defines the contract for all controllers.
  * Any controller implementing this must define these methods.
@@ -394,4 +395,4 @@ type Bindings = {
 };
 type UseKey = keyof RemoveIndexSignature<Bindings>;
 
-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 };
+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 RouteEventHandler, type RouterEnd, type UseKey };

package/dist/index.d.ts

@@ -294,7 +294,7 @@ interface IRouter {
     group(options: {
         prefix?: string;
         middleware?: EventHandler[];
-    }, callback: () => void): this;
+    }, callback: () => this): this;
     /**
      * Registers middleware for a specific path.
      * @param path - The path to apply the middleware.
@@ -327,6 +327,7 @@ declare class HttpContext {
  * Type for EventHandler, representing a function that handles an H3 event.
  */
 type EventHandler = (ctx: HttpContext) => any;
+type RouteEventHandler = (...args: any[]) => any;
 /**
  * Defines the contract for all controllers.
  * Any controller implementing this must define these methods.
@@ -394,4 +395,4 @@ type Bindings = {
 };
 type UseKey = keyof RemoveIndexSignature<Bindings>;
 
-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 };
+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 RouteEventHandler, type RouterEnd, type UseKey };

package/dist/index.js.map

@@ -1 +1 @@
-{"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"]}
+{"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: () => this): 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\nexport type RouteEventHandler = (...args: any[]) => 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.17.0",
+  "version": "0.17.2",
   "description": "Shared Utilities.",
   "type": "module",
   "main": "./dist/index.js",
@@ -8,9 +8,9 @@
   "module": "./dist/index.js",
   "exports": {
     ".": {
+      "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
-      "require": "./dist/index.cjs",
-      "types": "./dist/index.d.ts"
+      "require": "./dist/index.cjs"
     },
     "./tsconfig.json": "./tsconfig.json"
   },