@h3ravel/shared/dist/index.cjs.map

Shared Utilities.

{"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: () => 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"]}