@h3ravel/shared 0.17.2 → 0.17.4

package/README.md

@@ -1,8 +1,16 @@
-<p align="center"><a href="https://h3ravel.toneflix.net" target="_blank"><img src="https://raw.githubusercontent.com/h3ravel/assets/refs/heads/main/logo-full.svg" width="400" alt="H3ravel Logo"></a></p>
+<div align="center">
+  <a href="https://h3ravel.toneflix.net"  target="_blank">
+    <img src="https://raw.githubusercontent.com/h3ravel/assets/refs/heads/main/logo-full.svg" width="200" alt="H3ravel Logo">
+  </a>
+  <h1 align="center"><a href="https://h3ravel.toneflix.net/arquebus">H3ravel Shared</a></h1>
 
 [![Framework][ix]][lx]
 [![Shared Package Version][i1]][l1]
 [![Downloads][d1]][d1]
+[![Tests][tei]][tel]
+[![License][lini]][linl]
+
+</div>
 
 # About H3ravel/shared
 
@@ -29,3 +37,7 @@ The H3ravel framework is open-sourced software licensed under the [MIT license](
 [i1]: https://img.shields.io/npm/v/%40h3ravel%2Fshared?style=flat-square&label=@h3ravel/shared&color=%230970ce
 [l1]: https://www.npmjs.com/package/@h3ravel/shared
 [d1]: https://img.shields.io/npm/dt/%40h3ravel%2Fshared?style=flat-square&label=Downloads&link=https%3A%2F%2Fwww.npmjs.com%2Fpackage%2F%40h3ravel%2Fshared
+[linl]: https://github.com/h3ravel/framework/blob/main/LICENSE
+[lini]: https://img.shields.io/github/license/h3ravel/framework
+[tel]: https://github.com/h3ravel/framework/actions/workflows/test.yml
+[tei]: https://github.com/h3ravel/framework/actions/workflows/test.yml/badge.svg

package/dist/index.cjs

@@ -1,113 +1,241 @@
-"use strict";
+//#region rolldown:runtime
 var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
 var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+let chalk = require("chalk");
+chalk = __toESM(chalk);
+let path = require("path");
+path = __toESM(path);
+
+//#region src/Contracts/IHttp.ts
+/**
+* Represents the HTTP context for a single request lifecycle.
+* Encapsulates the application instance, request, and response objects.
+*/
+var HttpContext = class HttpContext {
+	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 a new instance
+		*/
+		return new HttpContext(ctx.app, ctx.request, ctx.response);
+	}
 };
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// src/index.ts
-var index_exports = {};
-__export(index_exports, {
-  HttpContext: () => HttpContext,
-  PathLoader: () => PathLoader
-});
-module.exports = __toCommonJS(index_exports);
+//#endregion
+//#region src/Utils/EnvParser.ts
+var EnvParser = class {
+	static parse(initial) {
+		const parsed = { ...initial };
+		for (const key in parsed) {
+			let value = parsed[key];
+			parsed[key] = this.parseValue(value);
+		}
+		return parsed;
+	}
+	static parseValue(value) {
+		/**
+		* Null/undefined stay untouched 
+		*/
+		if (value === null || value === void 0) return value;
+		/**
+		* Convert string "true"/"false" to boolean 
+		*/
+		if (value === "true") return true;
+		if (value === "false") return false;
+		/**
+		*  Convert string numbers to number 
+		*/
+		if (!isNaN(value) && value.trim() !== "") return Number(value);
+		/**
+		* Convert string "null" and "undefined"
+		*/
+		if (value === "null") return null;
+		if (value === "undefined") return void 0;
+		/**
+		* Otherwise return as-is (string)
+		*/
+		return value;
+	}
+};
 
-// 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);
-  }
+//#endregion
+//#region src/Utils/Logger.ts
+var Logger = class {
+	static twoColumnLog(name, value, log = true) {
+		const regex = /\x1b\[\d+m/g;
+		const width = Math.min(process.stdout.columns, 100);
+		const dots = Math.max(width - name.replace(regex, "").length - value.replace(regex, "").length - 10, 0);
+		if (log) return console.log(name, chalk.default.gray(".".repeat(dots)), value);
+		else return [
+			name,
+			chalk.default.gray(".".repeat(dots)),
+			value
+		];
+	}
+	/**
+	* Logs the message in two columns but allways passing status
+	* 
+	* @param name 
+	* @param value 
+	* @param status 
+	* @param exit 
+	* @param preserveCol 
+	*/
+	static split(name, value, status, exit = false, preserveCol = false) {
+		status ??= "info";
+		const color = {
+			success: chalk.default.bgGreen,
+			info: chalk.default.bgBlue,
+			error: chalk.default.bgRed
+		};
+		const [_name, dots, val] = this.twoColumnLog(name, value, false);
+		console.log(this.textFormat(_name, color[status], preserveCol), dots, val);
+		if (exit) process.exit(0);
+	}
+	/**
+	* Wraps text with chalk
+	* 
+	* @param txt 
+	* @param color 
+	* @param preserveCol 
+	* @returns 
+	*/
+	static textFormat(txt, color, preserveCol = false) {
+		if (preserveCol) return String(txt);
+		return String(txt).split(":").map((e, i, a) => i == 0 && a.length > 1 ? color(" " + e + ": ") : e).join("");
+	}
+	/**
+	* Logs a success message
+	* 
+	* @param msg 
+	* @param exit 
+	* @param preserveCol 
+	*/
+	static success(msg, exit = false, preserveCol = false) {
+		console.log(chalk.default.green("✓"), this.textFormat(msg, chalk.default.bgGreen, preserveCol), "\n");
+		if (exit) process.exit(0);
+	}
+	/**
+	* Logs an informational message
+	* 
+	* @param msg 
+	* @param exit 
+	* @param preserveCol 
+	*/
+	static info(msg, exit = false, preserveCol = false) {
+		console.log(chalk.default.blue("ℹ"), this.textFormat(msg, chalk.default.bgBlue, preserveCol), "\n");
+		if (exit) process.exit(0);
+	}
+	/**
+	* Logs an error message
+	* 
+	* @param msg 
+	* @param exit 
+	* @param preserveCol 
+	*/
+	static error(msg, exit = true, preserveCol = false) {
+		if (msg instanceof Error) {
+			if (msg.message) console.error(chalk.default.red("✖"), this.textFormat("ERROR:" + msg.message, chalk.default.bgRed, preserveCol));
+			console.error(chalk.default.red(`${msg.detail ? `${msg.detail}\n` : ""}${msg.stack}`), "\n");
+		} else console.error(chalk.default.red("✖"), this.textFormat(msg, chalk.default.bgRed, preserveCol), "\n");
+		if (exit) process.exit(1);
+	}
+	/**
+	* Terminates the process
+	*/
+	static quiet() {
+		process.exit(0);
+	}
+	static parse(config, joiner = " ", log = true) {
+		const string = config.map(([str, opt]) => {
+			return typeof chalk.default[opt] === "function" ? chalk.default[opt](str) : str;
+		}).join(joiner);
+		if (log) console.log(string);
+		else return string;
+	}
+	static log(config, joiner) {
+		if (typeof config === "string") {
+			const conf = [[config, joiner]];
+			return this.parse(conf);
+		} else if (config) return this.parse(config, joiner);
+		return this;
+	}
 };
 
-// src/Utils/PathLoader.ts
-var import_path = __toESM(require("path"), 1);
+//#endregion
+//#region src/Utils/PathLoader.ts
 var PathLoader = class {
-  static {
-    __name(this, "PathLoader");
-  }
-  paths = {
-    base: "",
-    views: "/src/resources/views",
-    assets: "/public/assets",
-    routes: "/src/routes",
-    config: "/src/config",
-    public: "/public",
-    storage: "/storage"
-  };
-  /**
-   * Dynamically retrieves a path property from the class.
-   * Any property ending with "Path" is accessible automatically.
-   *
-   * @param name - The base name of the path property
-   * @param base - The base path to include to the path
-   * @returns 
-   */
-  getPath(name, base) {
-    let path;
-    if (base && name !== "base") {
-      path = import_path.default.join(base, this.paths[name]);
-    } else {
-      path = this.paths[name];
-    }
-    return path.replace("/src/", `/${process.env.SRC_PATH ?? "src"}/`.replace(/([^:]\/)\/+/g, "$1"));
-  }
-  /**
-   * Programatically set the paths.
-   *
-   * @param name - The base name of the path property
-   * @param path - The new path
-   * @param base - The base path to include to the path
-   */
-  setPath(name, path, base) {
-    if (base && name !== "base") {
-      this.paths[name] = import_path.default.join(base, path);
-    }
-    this.paths[name] = path;
-  }
+	paths = {
+		base: "",
+		views: "/src/resources/views",
+		assets: "/public/assets",
+		routes: "/src/routes",
+		config: "/src/config",
+		public: "/public",
+		storage: "/storage",
+		database: "/src/database"
+	};
+	/**
+	* Dynamically retrieves a path property from the class.
+	* Any property ending with "Path" is accessible automatically.
+	*
+	* @param name - The base name of the path property
+	* @param prefix - The base path to prefix to the path
+	* @returns 
+	*/
+	getPath(name, prefix) {
+		let path$1;
+		if (prefix && name !== "base") path$1 = path.default.join(prefix, this.paths[name]);
+		else path$1 = this.paths[name];
+		path$1 = path$1.replace("/src/", `/${process.env.SRC_PATH ?? "src"}/`.replace(/([^:]\/)\/+/g, "$1"));
+		if (name === "database" && process.env.SRC_PATH && !"/src/".includes(process.env.SRC_PATH)) return path.default.resolve(path$1.replace(process.env.SRC_PATH, ""));
+		return path$1;
+	}
+	/**
+	* Programatically set the paths.
+	*
+	* @param name - The base name of the path property
+	* @param path - The new path
+	* @param base - The base path to include to the path
+	*/
+	setPath(name, path$1, base) {
+		if (base && name !== "base") this.paths[name] = path.default.join(base, path$1);
+		this.paths[name] = path$1;
+	}
 };
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  HttpContext,
-  PathLoader
-});
+
+//#endregion
+exports.EnvParser = EnvParser;
+exports.HttpContext = HttpContext;
+exports.Logger = Logger;
+exports.PathLoader = PathLoader;
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"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"]}
+{"version":3,"file":"index.cjs","names":["app: IApplication","request: IRequest","response: IResponse","value: any","path: string","nodepath","path"],"sources":["../src/Contracts/IHttp.ts","../src/Utils/EnvParser.ts","../src/Utils/Logger.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 { GenericWithNullableStringValues } from '../Contracts/ObjContract';\n\nexport class EnvParser {\n\n    static parse (initial: GenericWithNullableStringValues) {\n        const parsed = { ...initial }\n\n        for (const key in parsed) {\n            let value: any = parsed[key]\n            parsed[key] = this.parseValue(value)\n        }\n\n        return parsed\n    }\n\n    static parseValue (value: any) {\n        /**\n         * Null/undefined stay untouched \n         */\n        if (value === null || value === undefined) return value;\n\n        /**\n         * Convert string \"true\"/\"false\" to boolean \n         */\n        if (value === 'true') return true;\n        if (value === 'false') return false;\n\n        /**\n         *  Convert string numbers to number \n         */\n        if (!isNaN(value) && value.trim() !== '') {\n            return Number(value);\n        }\n\n        /**\n         * Convert string \"null\" and \"undefined\"\n         */\n        if (value === 'null') return null;\n        if (value === 'undefined') return undefined;\n\n        /**\n         * Otherwise return as-is (string)\n         */\n        return value;\n    }\n}\n","import chalk, { type ChalkInstance } from 'chalk'\n\nexport class Logger {\n    /**\n     * Logs the message in two columns\n     * @param name \n     * @param value \n     * @param log If set to false, array of [name, dots, value] output will be returned and not logged \n     * @returns \n     */\n    static twoColumnLog (name: string, value: string, log?: true): void\n    static twoColumnLog (name: string, value: string, log?: false): [string, string, string]\n    static twoColumnLog (name: string, value: string, log = true): [string, string, string] | void {\n        // eslint-disable-next-line no-control-regex\n        const regex = /\\x1b\\[\\d+m/g\n        const width = Math.min(process.stdout.columns, 100)\n        const dots = Math.max(width - name.replace(regex, '').length - value.replace(regex, '').length - 10, 0)\n\n        if (log) return console.log(name, chalk.gray('.'.repeat(dots)), value)\n        else return [name, chalk.gray('.'.repeat(dots)), value]\n    }\n\n    /**\n     * Logs the message in two columns but allways passing status\n     * \n     * @param name \n     * @param value \n     * @param status \n     * @param exit \n     * @param preserveCol \n     */\n    static split (name: string, value: string, status?: 'success' | 'info' | 'error', exit = false, preserveCol = false) {\n        status ??= 'info'\n        const color = { success: chalk.bgGreen, info: chalk.bgBlue, error: chalk.bgRed }\n\n        const [_name, dots, val] = this.twoColumnLog(name, value, false)\n\n        console.log(this.textFormat(_name, color[status], preserveCol), dots, val)\n\n        if (exit) process.exit(0)\n    }\n\n    /**\n     * Wraps text with chalk\n     * \n     * @param txt \n     * @param color \n     * @param preserveCol \n     * @returns \n     */\n    static textFormat (txt: any, color: (txt: string) => string, preserveCol = false) {\n        if (preserveCol) return String(txt)\n        return String(txt).split(':').map((e, i, a) => i == 0 && a.length > 1 ? color(' ' + e + ': ') : e).join('')\n    }\n\n    /**\n     * Logs a success message\n     * \n     * @param msg \n     * @param exit \n     * @param preserveCol \n     */\n    static success (msg: any, exit = false, preserveCol = false) {\n        console.log(chalk.green('✓'), this.textFormat(msg, chalk.bgGreen, preserveCol), '\\n')\n        if (exit) process.exit(0)\n    }\n\n    /**\n     * Logs an informational message\n     * \n     * @param msg \n     * @param exit \n     * @param preserveCol \n     */\n    static info (msg: any, exit = false, preserveCol = false) {\n        console.log(chalk.blue('ℹ'), this.textFormat(msg, chalk.bgBlue, preserveCol), '\\n')\n        if (exit) process.exit(0)\n    }\n\n    /**\n     * Logs an error message\n     * \n     * @param msg \n     * @param exit \n     * @param preserveCol \n     */\n    static error (msg: string | string[] | Error & { detail?: string }, exit = true, preserveCol = false) {\n        if (msg instanceof Error) {\n            if (msg.message) {\n                console.error(chalk.red('✖'), this.textFormat('ERROR:' + msg.message, chalk.bgRed, preserveCol))\n            }\n            console.error(chalk.red(`${msg.detail ? `${msg.detail}\\n` : ''}${msg.stack}`), '\\n')\n        }\n        else {\n            console.error(chalk.red('✖'), this.textFormat(msg, chalk.bgRed, preserveCol), '\\n')\n        }\n        if (exit) process.exit(1)\n    }\n\n    /**\n     * Terminates the process\n     */\n    static quiet () {\n        process.exit(0)\n    }\n\n    /**\n     * Parse an array formated message and logs it\n     * \n     * @param config \n     * @param joiner \n     * @param log If set to false, string output will be returned and not logged \n     */\n    static parse (config: [string, keyof ChalkInstance][], joiner?: string, log?: true): void\n    static parse (config: [string, keyof ChalkInstance][], joiner?: string, log?: false): string\n    static parse (config: [string, keyof ChalkInstance][], joiner = ' ', log = true): string | void {\n        const string = config.map(([str, opt]) => {\n            return typeof chalk[opt] === 'function' ? (chalk as any)[opt](str) : str\n        }).join(joiner)\n\n        if (log) console.log(string)\n        else return string\n    }\n\n    /**\n     * Ouput formater object or format the output\n     * \n     * @returns \n     */\n    static log (): typeof Logger\n    static log (config: string, joiner: keyof ChalkInstance): void\n    static log (config: [string, keyof ChalkInstance][], joiner?: string): void\n    static log (config?: string | [string, keyof ChalkInstance][], joiner?: string): void | Logger {\n        if (typeof config === 'string') {\n            const conf = [[config, joiner]] as [string, keyof ChalkInstance][]\n            return this.parse(conf)\n        } else if (config) {\n            return this.parse(config, joiner)\n        }\n        return this\n    }\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        database: '/src/database',\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 prefix - The base path to prefix to the path\n     * @returns \n     */\n    getPath (name: IPathName, prefix?: string): string {\n        let path: string;\n\n        if (prefix && name !== 'base') {\n            path = nodepath.join(prefix, this.paths[name])\n        } else {\n            path = this.paths[name]\n        }\n\n        path = path.replace('/src/', `/${process.env.SRC_PATH ?? 'src'}/`.replace(/([^:]\\/)\\/+/g, \"$1\"))\n\n        if (name === 'database' && process.env.SRC_PATH && !'/src/'.includes(process.env.SRC_PATH)) {\n            return nodepath.resolve(path.replace(process.env.SRC_PATH, ''))\n        }\n\n        return path\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":"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"}