@h3ravel/shared 0.17.1 → 0.17.3

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

@@ -29,12 +29,14 @@ 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, {
+  EnvParser: () => EnvParser,
   HttpContext: () => HttpContext,
+  Logger: () => Logger,
   PathLoader: () => PathLoader
 });
-module.exports = __toCommonJS(src_exports);
+module.exports = __toCommonJS(index_exports);
 
 // src/Contracts/IHttp.ts
 var HttpContext = class _HttpContext {
@@ -59,6 +61,155 @@ var HttpContext = class _HttpContext {
   }
 };
 
+// src/Utils/EnvParser.ts
+var EnvParser = class {
+  static {
+    __name(this, "EnvParser");
+  }
+  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) {
+    if (value === null || value === void 0) return value;
+    if (value === "true") return true;
+    if (value === "false") return false;
+    if (!isNaN(value) && value.trim() !== "") {
+      return Number(value);
+    }
+    if (value === "null") return null;
+    if (value === "undefined") return void 0;
+    return value;
+  }
+};
+
+// src/Utils/Logger.ts
+var import_chalk = __toESM(require("chalk"), 1);
+var Logger = class {
+  static {
+    __name(this, "Logger");
+  }
+  /**
+   * Logs the message in two columns
+   * @param name 
+   * @param value 
+   * @returns 
+   */
+  static twoColumnLog(name, value) {
+    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);
+    return console.log(name, import_chalk.default.gray(".".repeat(dots)), value);
+  }
+  /**
+   * Wraps text with chalk
+   * 
+   * @param txt 
+   * @param color 
+   * @returns 
+   */
+  static textFormat(txt, color) {
+    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 
+   */
+  static success(msg, exit = false) {
+    console.log(import_chalk.default.green("\u2713"), this.textFormat(msg, import_chalk.default.bgGreen), "\n");
+    if (exit) process.exit(0);
+  }
+  /**
+   * Logs an informational message
+   * 
+   * @param msg 
+   * @param exit 
+   */
+  static info(msg, exit = false) {
+    console.log(import_chalk.default.blue("\u2139"), this.textFormat(msg, import_chalk.default.bgBlue), "\n");
+    if (exit) process.exit(0);
+  }
+  /**
+   * Logs an error message
+   * 
+   * @param msg 
+   * @param exit 
+   */
+  static error(msg, exit = true) {
+    if (msg instanceof Error) {
+      if (msg.message) {
+        console.error(import_chalk.default.red("\u2716"), this.textFormat("ERROR:" + msg.message, import_chalk.default.bgRed));
+      }
+      console.error(import_chalk.default.red(`${msg.detail ? `${msg.detail}
+` : ""}${msg.stack}`), "\n");
+    } else {
+      console.error(import_chalk.default.red("\u2716"), this.textFormat(msg, import_chalk.default.bgRed), "\n");
+    }
+    if (exit) process.exit(1);
+  }
+  /**
+   * Logs a success message
+   * 
+   * @param name 
+   * @param value 
+   * @param status 
+   * @param exit 
+   */
+  static split(name, value, status, exit = false) {
+    status ??= "info";
+    const color = {
+      success: import_chalk.default.bgGreen,
+      info: import_chalk.default.bgBlue,
+      error: import_chalk.default.bgRed
+    };
+    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);
+    console.log(this.textFormat(name, color[status]), import_chalk.default.gray(".".repeat(dots)), value);
+    if (exit) process.exit(0);
+  }
+  /**
+   * Terminates the process
+   */
+  static quiet() {
+    process.exit(0);
+  }
+  /**
+   * Parse an array formated message and logs it
+   * 
+   * @param config 
+   * @param joiner 
+   */
+  static parse(config, joiner = " ") {
+    const string = config.map(([str, opt]) => {
+      return typeof import_chalk.default[opt] === "function" ? import_chalk.default[opt](str) : str;
+    }).join(joiner);
+    console.log(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);
 var PathLoader = class {
@@ -72,24 +223,29 @@ var PathLoader = class {
     routes: "/src/routes",
     config: "/src/config",
     public: "/public",
-    storage: "/storage"
+    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 base - The base path to include to the path
+   * @param prefix - The base path to prefix to the path
    * @returns 
    */
-  getPath(name, base) {
+  getPath(name, prefix) {
     let path;
-    if (base && name !== "base") {
-      path = import_path.default.join(base, this.paths[name]);
+    if (prefix && name !== "base") {
+      path = import_path.default.join(prefix, this.paths[name]);
     } else {
       path = this.paths[name];
     }
-    return path.replace("/src/", `/${process.env.SRC_PATH ?? "src"}/`.replace(/([^:]\/)\/+/g, "$1"));
+    path = path.replace("/src/", `/${process.env.SRC_PATH ?? "src"}/`.replace(/([^:]\/)\/+/g, "$1"));
+    if (name === "database" && process.env.SRC_PATH && !"/src/".includes(process.env.SRC_PATH)) {
+      return import_path.default.resolve(path.replace(process.env.SRC_PATH, ""));
+    }
+    return path;
   }
   /**
    * Programatically set the paths.
@@ -107,7 +263,9 @@ var PathLoader = class {
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  EnvParser,
   HttpContext,
+  Logger,
   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":["/**\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"]}
+{"version":3,"sources":["../src/index.ts","../src/Contracts/IHttp.ts","../src/Utils/EnvParser.ts","../src/Utils/Logger.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/EnvParser'\nexport * from './Utils/Logger'\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 { 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     * @returns \n     */\n    static twoColumnLog (name: string, value: string) {\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        return console.log(name, chalk.gray('.'.repeat(dots)), value)\n    }\n\n    /**\n     * Wraps text with chalk\n     * \n     * @param txt \n     * @param color \n     * @returns \n     */\n    static textFormat (txt: any, color: (txt: string) => string) {\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     */\n    static success (msg: any, exit = false) {\n        console.log(chalk.green('✓'), this.textFormat(msg, chalk.bgGreen), '\\n')\n        if (exit) process.exit(0)\n    }\n\n    /**\n     * Logs an informational message\n     * \n     * @param msg \n     * @param exit \n     */\n    static info (msg: any, exit = false) {\n        console.log(chalk.blue('ℹ'), this.textFormat(msg, chalk.bgBlue), '\\n')\n        if (exit) process.exit(0)\n    }\n\n    /**\n     * Logs an error message\n     * \n     * @param msg \n     * @param exit \n     */\n    static error (msg: string | string[] | Error & { detail?: string }, exit = true) {\n        if (msg instanceof Error) {\n            if (msg.message) {\n                console.error(chalk.red('✖'), this.textFormat('ERROR:' + msg.message, chalk.bgRed))\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), '\\n')\n        }\n        if (exit) process.exit(1)\n    }\n\n    /**\n     * Logs a success message\n     * \n     * @param name \n     * @param value \n     * @param status \n     * @param exit \n     */\n    static split (name: string, value: string, status?: 'success' | 'info' | 'error', exit = false) {\n        status ??= 'info'\n        const color = { success: chalk.bgGreen, info: chalk.bgBlue, error: chalk.bgRed }\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        console.log(this.textFormat(name, color[status]), chalk.gray('.'.repeat(dots)), value)\n        if (exit) process.exit(0)\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     */\n    static parse (config: [string, keyof ChalkInstance][], joiner = ' ') {\n        const string = config.map(([str, opt]) => {\n            return typeof chalk[opt] === 'function' ? (chalk as any)[opt](str) : str\n        }).join(joiner)\n\n        console.log(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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","names":["HttpContext","app","request","response","init","ctx","EnvParser","parse","initial","parsed","key","value","parseValue","undefined","isNaN","trim","Number","Logger","twoColumnLog","name","value","regex","width","Math","min","process","stdout","columns","dots","max","replace","length","console","log","chalk","gray","repeat","textFormat","txt","color","String","split","map","e","i","a","join","success","msg","exit","green","bgGreen","info","blue","bgBlue","error","Error","message","red","bgRed","detail","stack","status","quiet","parse","config","joiner","string","str","opt","conf","PathLoader","paths","base","views","assets","routes","config","public","storage","database","getPath","name","prefix","path","nodepath","join","replace","process","env","SRC_PATH","includes","resolve","setPath"]}

package/dist/index.d.cts

@@ -1,6 +1,7 @@
 import { H3Event, Middleware, MiddlewareOptions, H3, serve } from 'h3';
 import { Edge } from 'edge.js';
 import { TypedHeaders, ResponseHeaderMap } from 'fetchdts';
+import { ChalkInstance } from 'chalk';
 
 /**
  * Adds a dot prefix to nested keys
@@ -30,6 +31,12 @@ type DotNestedKeys<T> = {
  * Retrieves type at a given dot-path
  */
 type DotNestedValue<T, Path extends string> = Path extends `${infer Key}.${infer Rest}` ? Key extends keyof T ? DotNestedValue<T[Key], Rest> : never : Path extends keyof T ? T[Path] : never;
+/**
+ * A generic object type that supports nullable string values
+ */
+interface GenericWithNullableStringValues {
+    [name: string]: string | undefined;
+}
 
 /**
  * Interface for the Container contract, defining methods for dependency injection and service resolution.
@@ -75,15 +82,15 @@ interface IServiceProvider {
      * Register bindings to the container.
      * Runs before boot().
      */
-    register(): void | Promise<void>;
+    register(...app: unknown[]): void | Promise<void>;
     /**
      * Perform post-registration booting of services.
      * Runs after all providers have been registered.
      */
-    boot?(): void | Promise<void>;
+    boot?(...app: unknown[]): void | Promise<void>;
 }
 
-type IPathName = 'views' | 'routes' | 'assets' | 'base' | 'public' | 'storage' | 'config';
+type IPathName = 'views' | 'routes' | 'assets' | 'base' | 'public' | 'storage' | 'config' | 'database';
 interface IApplication extends IContainer {
     /**
      * Registers configured service providers.
@@ -354,10 +361,10 @@ declare class PathLoader {
      * 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
+     * @param prefix - The base path to prefix to the path
      * @returns
      */
-    getPath(name: IPathName, base?: string): string;
+    getPath(name: IPathName, prefix?: string): string;
     /**
      * Programatically set the paths.
      *
@@ -395,4 +402,80 @@ 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 RouteEventHandler, type RouterEnd, type UseKey };
+declare class EnvParser {
+    static parse(initial: GenericWithNullableStringValues): {
+        [name: string]: string | undefined;
+    };
+    static parseValue(value: any): any;
+}
+
+declare class Logger {
+    /**
+     * Logs the message in two columns
+     * @param name
+     * @param value
+     * @returns
+     */
+    static twoColumnLog(name: string, value: string): void;
+    /**
+     * Wraps text with chalk
+     *
+     * @param txt
+     * @param color
+     * @returns
+     */
+    static textFormat(txt: any, color: (txt: string) => string): string;
+    /**
+     * Logs a success message
+     *
+     * @param msg
+     * @param exit
+     */
+    static success(msg: any, exit?: boolean): void;
+    /**
+     * Logs an informational message
+     *
+     * @param msg
+     * @param exit
+     */
+    static info(msg: any, exit?: boolean): void;
+    /**
+     * Logs an error message
+     *
+     * @param msg
+     * @param exit
+     */
+    static error(msg: string | string[] | Error & {
+        detail?: string;
+    }, exit?: boolean): void;
+    /**
+     * Logs a success message
+     *
+     * @param name
+     * @param value
+     * @param status
+     * @param exit
+     */
+    static split(name: string, value: string, status?: 'success' | 'info' | 'error', exit?: boolean): void;
+    /**
+     * Terminates the process
+     */
+    static quiet(): void;
+    /**
+     * Parse an array formated message and logs it
+     *
+     * @param config
+     * @param joiner
+     */
+    static parse(config: [string, keyof ChalkInstance][], joiner?: string): void;
+    /**
+     * Ouput formater object or format the output
+     *
+     * @returns
+     */
+    static log(): typeof Logger;
+    static log(config: string, joiner: keyof ChalkInstance): void;
+    static log(config: [string, keyof ChalkInstance][], joiner?: string): void;
+}
+
+export { type Bindings, type DotFlatten, type DotNestedKeys, type DotNestedValue, EnvParser, type EventHandler, type GenericWithNullableStringValues, HttpContext, type IApplication, type IContainer, type IController, type IMiddleware, type IPathName, type IRequest, type IResponse, type IRouter, type IServiceProvider, Logger, PathLoader, type RouteEventHandler, type RouterEnd, type UseKey };

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 import { H3Event, Middleware, MiddlewareOptions, H3, serve } from 'h3';
 import { Edge } from 'edge.js';
 import { TypedHeaders, ResponseHeaderMap } from 'fetchdts';
+import { ChalkInstance } from 'chalk';
 
 /**
  * Adds a dot prefix to nested keys
@@ -30,6 +31,12 @@ type DotNestedKeys<T> = {
  * Retrieves type at a given dot-path
  */
 type DotNestedValue<T, Path extends string> = Path extends `${infer Key}.${infer Rest}` ? Key extends keyof T ? DotNestedValue<T[Key], Rest> : never : Path extends keyof T ? T[Path] : never;
+/**
+ * A generic object type that supports nullable string values
+ */
+interface GenericWithNullableStringValues {
+    [name: string]: string | undefined;
+}
 
 /**
  * Interface for the Container contract, defining methods for dependency injection and service resolution.
@@ -75,15 +82,15 @@ interface IServiceProvider {
      * Register bindings to the container.
      * Runs before boot().
      */
-    register(): void | Promise<void>;
+    register(...app: unknown[]): void | Promise<void>;
     /**
      * Perform post-registration booting of services.
      * Runs after all providers have been registered.
      */
-    boot?(): void | Promise<void>;
+    boot?(...app: unknown[]): void | Promise<void>;
 }
 
-type IPathName = 'views' | 'routes' | 'assets' | 'base' | 'public' | 'storage' | 'config';
+type IPathName = 'views' | 'routes' | 'assets' | 'base' | 'public' | 'storage' | 'config' | 'database';
 interface IApplication extends IContainer {
     /**
      * Registers configured service providers.
@@ -354,10 +361,10 @@ declare class PathLoader {
      * 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
+     * @param prefix - The base path to prefix to the path
      * @returns
      */
-    getPath(name: IPathName, base?: string): string;
+    getPath(name: IPathName, prefix?: string): string;
     /**
      * Programatically set the paths.
      *
@@ -395,4 +402,80 @@ 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 RouteEventHandler, type RouterEnd, type UseKey };
+declare class EnvParser {
+    static parse(initial: GenericWithNullableStringValues): {
+        [name: string]: string | undefined;
+    };
+    static parseValue(value: any): any;
+}
+
+declare class Logger {
+    /**
+     * Logs the message in two columns
+     * @param name
+     * @param value
+     * @returns
+     */
+    static twoColumnLog(name: string, value: string): void;
+    /**
+     * Wraps text with chalk
+     *
+     * @param txt
+     * @param color
+     * @returns
+     */
+    static textFormat(txt: any, color: (txt: string) => string): string;
+    /**
+     * Logs a success message
+     *
+     * @param msg
+     * @param exit
+     */
+    static success(msg: any, exit?: boolean): void;
+    /**
+     * Logs an informational message
+     *
+     * @param msg
+     * @param exit
+     */
+    static info(msg: any, exit?: boolean): void;
+    /**
+     * Logs an error message
+     *
+     * @param msg
+     * @param exit
+     */
+    static error(msg: string | string[] | Error & {
+        detail?: string;
+    }, exit?: boolean): void;
+    /**
+     * Logs a success message
+     *
+     * @param name
+     * @param value
+     * @param status
+     * @param exit
+     */
+    static split(name: string, value: string, status?: 'success' | 'info' | 'error', exit?: boolean): void;
+    /**
+     * Terminates the process
+     */
+    static quiet(): void;
+    /**
+     * Parse an array formated message and logs it
+     *
+     * @param config
+     * @param joiner
+     */
+    static parse(config: [string, keyof ChalkInstance][], joiner?: string): void;
+    /**
+     * Ouput formater object or format the output
+     *
+     * @returns
+     */
+    static log(): typeof Logger;
+    static log(config: string, joiner: keyof ChalkInstance): void;
+    static log(config: [string, keyof ChalkInstance][], joiner?: string): void;
+}
+
+export { type Bindings, type DotFlatten, type DotNestedKeys, type DotNestedValue, EnvParser, type EventHandler, type GenericWithNullableStringValues, HttpContext, type IApplication, type IContainer, type IController, type IMiddleware, type IPathName, type IRequest, type IResponse, type IRouter, type IServiceProvider, Logger, PathLoader, type RouteEventHandler, type RouterEnd, type UseKey };

package/dist/index.js

@@ -24,6 +24,155 @@ var HttpContext = class _HttpContext {
   }
 };
 
+// src/Utils/EnvParser.ts
+var EnvParser = class {
+  static {
+    __name(this, "EnvParser");
+  }
+  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) {
+    if (value === null || value === void 0) return value;
+    if (value === "true") return true;
+    if (value === "false") return false;
+    if (!isNaN(value) && value.trim() !== "") {
+      return Number(value);
+    }
+    if (value === "null") return null;
+    if (value === "undefined") return void 0;
+    return value;
+  }
+};
+
+// src/Utils/Logger.ts
+import chalk from "chalk";
+var Logger = class {
+  static {
+    __name(this, "Logger");
+  }
+  /**
+   * Logs the message in two columns
+   * @param name 
+   * @param value 
+   * @returns 
+   */
+  static twoColumnLog(name, value) {
+    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);
+    return console.log(name, chalk.gray(".".repeat(dots)), value);
+  }
+  /**
+   * Wraps text with chalk
+   * 
+   * @param txt 
+   * @param color 
+   * @returns 
+   */
+  static textFormat(txt, color) {
+    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 
+   */
+  static success(msg, exit = false) {
+    console.log(chalk.green("\u2713"), this.textFormat(msg, chalk.bgGreen), "\n");
+    if (exit) process.exit(0);
+  }
+  /**
+   * Logs an informational message
+   * 
+   * @param msg 
+   * @param exit 
+   */
+  static info(msg, exit = false) {
+    console.log(chalk.blue("\u2139"), this.textFormat(msg, chalk.bgBlue), "\n");
+    if (exit) process.exit(0);
+  }
+  /**
+   * Logs an error message
+   * 
+   * @param msg 
+   * @param exit 
+   */
+  static error(msg, exit = true) {
+    if (msg instanceof Error) {
+      if (msg.message) {
+        console.error(chalk.red("\u2716"), this.textFormat("ERROR:" + msg.message, chalk.bgRed));
+      }
+      console.error(chalk.red(`${msg.detail ? `${msg.detail}
+` : ""}${msg.stack}`), "\n");
+    } else {
+      console.error(chalk.red("\u2716"), this.textFormat(msg, chalk.bgRed), "\n");
+    }
+    if (exit) process.exit(1);
+  }
+  /**
+   * Logs a success message
+   * 
+   * @param name 
+   * @param value 
+   * @param status 
+   * @param exit 
+   */
+  static split(name, value, status, exit = false) {
+    status ??= "info";
+    const color = {
+      success: chalk.bgGreen,
+      info: chalk.bgBlue,
+      error: chalk.bgRed
+    };
+    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);
+    console.log(this.textFormat(name, color[status]), chalk.gray(".".repeat(dots)), value);
+    if (exit) process.exit(0);
+  }
+  /**
+   * Terminates the process
+   */
+  static quiet() {
+    process.exit(0);
+  }
+  /**
+   * Parse an array formated message and logs it
+   * 
+   * @param config 
+   * @param joiner 
+   */
+  static parse(config, joiner = " ") {
+    const string = config.map(([str, opt]) => {
+      return typeof chalk[opt] === "function" ? chalk[opt](str) : str;
+    }).join(joiner);
+    console.log(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
 import nodepath from "path";
 var PathLoader = class {
@@ -37,24 +186,29 @@ var PathLoader = class {
     routes: "/src/routes",
     config: "/src/config",
     public: "/public",
-    storage: "/storage"
+    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 base - The base path to include to the path
+   * @param prefix - The base path to prefix to the path
    * @returns 
    */
-  getPath(name, base) {
+  getPath(name, prefix) {
     let path;
-    if (base && name !== "base") {
-      path = nodepath.join(base, this.paths[name]);
+    if (prefix && name !== "base") {
+      path = nodepath.join(prefix, this.paths[name]);
     } else {
       path = this.paths[name];
     }
-    return path.replace("/src/", `/${process.env.SRC_PATH ?? "src"}/`.replace(/([^:]\/)\/+/g, "$1"));
+    path = path.replace("/src/", `/${process.env.SRC_PATH ?? "src"}/`.replace(/([^:]\/)\/+/g, "$1"));
+    if (name === "database" && process.env.SRC_PATH && !"/src/".includes(process.env.SRC_PATH)) {
+      return nodepath.resolve(path.replace(process.env.SRC_PATH, ""));
+    }
+    return path;
   }
   /**
    * Programatically set the paths.
@@ -71,7 +225,9 @@ var PathLoader = class {
   }
 };
 export {
+  EnvParser,
   HttpContext,
+  Logger,
   PathLoader
 };
 //# sourceMappingURL=index.js.map

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: () => 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"]}
+{"version":3,"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     * @returns \n     */\n    static twoColumnLog (name: string, value: string) {\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        return console.log(name, chalk.gray('.'.repeat(dots)), value)\n    }\n\n    /**\n     * Wraps text with chalk\n     * \n     * @param txt \n     * @param color \n     * @returns \n     */\n    static textFormat (txt: any, color: (txt: string) => string) {\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     */\n    static success (msg: any, exit = false) {\n        console.log(chalk.green('✓'), this.textFormat(msg, chalk.bgGreen), '\\n')\n        if (exit) process.exit(0)\n    }\n\n    /**\n     * Logs an informational message\n     * \n     * @param msg \n     * @param exit \n     */\n    static info (msg: any, exit = false) {\n        console.log(chalk.blue('ℹ'), this.textFormat(msg, chalk.bgBlue), '\\n')\n        if (exit) process.exit(0)\n    }\n\n    /**\n     * Logs an error message\n     * \n     * @param msg \n     * @param exit \n     */\n    static error (msg: string | string[] | Error & { detail?: string }, exit = true) {\n        if (msg instanceof Error) {\n            if (msg.message) {\n                console.error(chalk.red('✖'), this.textFormat('ERROR:' + msg.message, chalk.bgRed))\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), '\\n')\n        }\n        if (exit) process.exit(1)\n    }\n\n    /**\n     * Logs a success message\n     * \n     * @param name \n     * @param value \n     * @param status \n     * @param exit \n     */\n    static split (name: string, value: string, status?: 'success' | 'info' | 'error', exit = false) {\n        status ??= 'info'\n        const color = { success: chalk.bgGreen, info: chalk.bgBlue, error: chalk.bgRed }\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        console.log(this.textFormat(name, color[status]), chalk.gray('.'.repeat(dots)), value)\n        if (exit) process.exit(0)\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     */\n    static parse (config: [string, keyof ChalkInstance][], joiner = ' ') {\n        const string = config.map(([str, opt]) => {\n            return typeof chalk[opt] === 'function' ? (chalk as any)[opt](str) : str\n        }).join(joiner)\n\n        console.log(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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","names":["HttpContext","app","request","response","init","ctx","EnvParser","parse","initial","parsed","key","value","parseValue","undefined","isNaN","trim","Number","chalk","Logger","twoColumnLog","name","value","regex","width","Math","min","process","stdout","columns","dots","max","replace","length","console","log","chalk","gray","repeat","textFormat","txt","color","String","split","map","e","i","a","join","success","msg","exit","green","bgGreen","info","blue","bgBlue","error","Error","message","red","bgRed","detail","stack","status","quiet","parse","config","joiner","string","str","opt","conf","nodepath","PathLoader","paths","base","views","assets","routes","config","public","storage","database","getPath","name","prefix","path","nodepath","join","replace","process","env","SRC_PATH","includes","resolve","setPath"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@h3ravel/shared",
-  "version": "0.17.1",
+  "version": "0.17.3",
   "description": "Shared Utilities.",
   "type": "module",
   "main": "./dist/index.js",
@@ -9,11 +9,17 @@
   "exports": {
     ".": {
       "import": "./dist/index.js",
-      "require": "./dist/index.cjs",
-      "types": "./dist/index.d.ts"
+      "require": "./dist/index.cjs"
     },
     "./tsconfig.json": "./tsconfig.json"
   },
+  "typesVersions": {
+    "*": {
+      "*": [
+        "dist/index.d.ts"
+      ]
+    }
+  },
   "files": [
     "dist",
     "tsconfig.json"
@@ -39,6 +45,7 @@
   ],
   "dependencies": {
     "h3": "^2.0.0-beta.1",
+    "chalk": "^5.6.0",
     "edge.js": "^6.3.0"
   },
   "devDependencies": {
@@ -52,6 +59,7 @@
     "dev": "tsx watch src/index.ts",
     "start": "node dist/index.js",
     "lint": "eslint . --ext .ts",
-    "test": "jest --passWithNoTests"
+    "test": "jest --passWithNoTests",
+    "release:patch": "pnpm build && pnpm version patch && git add . && git commit -m \"version: bump shared package and publish\" && pnpm publish --tag latest"
   }
 }

package/tsconfig.json

@@ -4,7 +4,7 @@
     "emitDecoratorMetadata": true,
     "target": "es2022",
     "module": "es2022",
-    "moduleResolution": "Node",
+    "moduleResolution": "bundler",
     "esModuleInterop": true,
     "strict": true,
     "allowJs": true,