@h3ravel/shared 0.18.0 → 0.18.1

package/dist/index.cjs

@@ -233,9 +233,26 @@ var PathLoader = class {
 	}
 };
 
+//#endregion
+//#region src/Utils/TaskManager.ts
+var TaskManager = class {
+	static async taskRunner(description, task) {
+		const startTime = process.hrtime();
+		let result = false;
+		try {
+			result = await Promise.all([(task || (() => true))()].flat());
+		} finally {
+			const endTime = process.hrtime(startTime);
+			const duration = (endTime[0] * 1e9 + endTime[1]) / 1e6;
+			Logger.twoColumnLog(Logger.parse([[description, "green"]], "", false), [Logger.parse([[`${Math.floor(duration)}ms`, "gray"]], "", false), Logger.parse([[result !== false ? "✔" : "✘", result !== false ? "green" : "red"]], "", false)].join(" "));
+		}
+	}
+};
+
 //#endregion
 exports.EnvParser = EnvParser;
 exports.HttpContext = HttpContext;
 exports.Logger = Logger;
 exports.PathLoader = PathLoader;
+exports.TaskManager = TaskManager;
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"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 | ChalkInstance][], joiner?: string, log?: true): void\n    static parse (config: [string, keyof ChalkInstance | ChalkInstance][], joiner?: string, log?: false): string\n    static parse (config: [string, keyof ChalkInstance | ChalkInstance][], joiner = ' ', log = true): string | void {\n        const string = config.map(([str, opt]) => {\n            return typeof opt === 'string' && typeof chalk[opt] === 'function'\n                ? (chalk as any)[opt](str)\n                : typeof opt === 'function' ? 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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"}
+{"version":3,"file":"index.cjs","names":["app: IApplication","request: IRequest","response: IResponse","value: any","path: string","nodepath","path","result: any"],"sources":["../src/Contracts/IHttp.ts","../src/Utils/EnvParser.ts","../src/Utils/Logger.ts","../src/Utils/PathLoader.ts","../src/Utils/TaskManager.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 | ChalkInstance][], joiner?: string, log?: true): void\n    static parse (config: [string, keyof ChalkInstance | ChalkInstance][], joiner?: string, log?: false): string\n    static parse (config: [string, keyof ChalkInstance | ChalkInstance][], joiner = ' ', log = true): string | void {\n        const string = config.map(([str, opt]) => {\n            return typeof opt === 'string' && typeof chalk[opt] === 'function'\n                ? (chalk as any)[opt](str)\n                : typeof opt === 'function' ? 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","import { Logger } from \"./Logger\"\n\nexport class TaskManager {\n    public static async taskRunner (\n        description: string,\n        task: (() => Promise<any>) | (() => any)\n    ): Promise<void> {\n        const startTime = process.hrtime()\n        let result: any = false\n\n        try {\n            result = await Promise.all([(task || (() => true))()].flat())\n        } finally {\n            const endTime = process.hrtime(startTime)\n            const duration = (endTime[0] * 1e9 + endTime[1]) / 1e6\n            Logger.twoColumnLog(\n                Logger.parse([[description, 'green']], '', false),\n                [\n                    Logger.parse([[`${Math.floor(duration)}ms`, 'gray']], '', false),\n                    Logger.parse([[result !== false ? '✔' : '✘', result !== false ? 'green' : 'red']], '', false),\n                ].join(' ')\n            )\n        }\n    }\n}\n"],"mappings":"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"}

package/dist/index.d.cts

@@ -513,5 +513,10 @@ declare class Logger {
   static log(config: [string, keyof ChalkInstance][], joiner?: string): void;
 }
 //#endregion
-export { Bindings, DotFlatten, DotNestedKeys, DotNestedValue, EnvParser, EventHandler, GenericWithNullableStringValues, HttpContext, IApplication, IContainer, IController, IMiddleware, IPathName, IRequest, IResponse, IRouter, IServiceProvider, Logger, PathLoader, RouteEventHandler, RouterEnd, UseKey };
+//#region src/Utils/TaskManager.d.ts
+declare class TaskManager {
+  static taskRunner(description: string, task: (() => Promise<any>) | (() => any)): Promise<void>;
+}
+//#endregion
+export { Bindings, DotFlatten, DotNestedKeys, DotNestedValue, EnvParser, EventHandler, GenericWithNullableStringValues, HttpContext, IApplication, IContainer, IController, IMiddleware, IPathName, IRequest, IResponse, IRouter, IServiceProvider, Logger, PathLoader, RouteEventHandler, RouterEnd, TaskManager, UseKey };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.ts

@@ -501,5 +501,10 @@ declare class Logger {
   static log(config: [string, keyof ChalkInstance][], joiner?: string): void;
 }
 //#endregion
-export { Bindings, DotFlatten, DotNestedKeys, DotNestedValue, EnvParser, EventHandler, GenericWithNullableStringValues, HttpContext, IApplication, IContainer, IController, IMiddleware, IPathName, IRequest, IResponse, IRouter, IServiceProvider, Logger, PathLoader, RouteEventHandler, RouterEnd, UseKey };
+//#region src/Utils/TaskManager.d.ts
+declare class TaskManager {
+  static taskRunner(description: string, task: (() => Promise<any>) | (() => any)): Promise<void>;
+}
+//#endregion
+export { Bindings, DotFlatten, DotNestedKeys, DotNestedValue, EnvParser, EventHandler, GenericWithNullableStringValues, HttpContext, IApplication, IContainer, IController, IMiddleware, IPathName, IRequest, IResponse, IRouter, IServiceProvider, Logger, PathLoader, RouteEventHandler, RouterEnd, TaskManager, UseKey };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -209,5 +209,21 @@ var PathLoader = class {
 };
 
 //#endregion
-export { EnvParser, HttpContext, Logger, PathLoader };
+//#region src/Utils/TaskManager.ts
+var TaskManager = class {
+	static async taskRunner(description, task) {
+		const startTime = process.hrtime();
+		let result = false;
+		try {
+			result = await Promise.all([(task || (() => true))()].flat());
+		} finally {
+			const endTime = process.hrtime(startTime);
+			const duration = (endTime[0] * 1e9 + endTime[1]) / 1e6;
+			Logger.twoColumnLog(Logger.parse([[description, "green"]], "", false), [Logger.parse([[`${Math.floor(duration)}ms`, "gray"]], "", false), Logger.parse([[result !== false ? "✔" : "✘", result !== false ? "green" : "red"]], "", false)].join(" "));
+		}
+	}
+};
+
+//#endregion
+export { EnvParser, HttpContext, Logger, PathLoader, TaskManager };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["app: IApplication","request: IRequest","response: IResponse","value: any","path: string"],"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 | ChalkInstance][], joiner?: string, log?: true): void\n    static parse (config: [string, keyof ChalkInstance | ChalkInstance][], joiner?: string, log?: false): string\n    static parse (config: [string, keyof ChalkInstance | ChalkInstance][], joiner = ' ', log = true): string | void {\n        const string = config.map(([str, opt]) => {\n            return typeof opt === 'string' && typeof chalk[opt] === 'function'\n                ? (chalk as any)[opt](str)\n                : typeof opt === 'function' ? 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":";;;;;;;;AAoHA,IAAa,cAAb,MAAa,YAAY;CACrB,YACI,AAAOA,KACP,AAAOC,SACP,AAAOC,UACT;EAHS;EACA;EACA;;;;;;;CAQX,OAAO,KAAM,KAAiF;;;;AAI1F,SAAO,IAAI,YAAY,IAAI,KAAK,IAAI,SAAS,IAAI,SAAS;;;;;;AClIlE,IAAa,YAAb,MAAuB;CAEnB,OAAO,MAAO,SAA0C;EACpD,MAAM,SAAS,EAAE,GAAG,SAAS;AAE7B,OAAK,MAAM,OAAO,QAAQ;GACtB,IAAIC,QAAa,OAAO;AACxB,UAAO,OAAO,KAAK,WAAW,MAAM;;AAGxC,SAAO;;CAGX,OAAO,WAAY,OAAY;;;;AAI3B,MAAI,UAAU,QAAQ,UAAU,OAAW,QAAO;;;;AAKlD,MAAI,UAAU,OAAQ,QAAO;AAC7B,MAAI,UAAU,QAAS,QAAO;;;;AAK9B,MAAI,CAAC,MAAM,MAAM,IAAI,MAAM,MAAM,KAAK,GAClC,QAAO,OAAO,MAAM;;;;AAMxB,MAAI,UAAU,OAAQ,QAAO;AAC7B,MAAI,UAAU,YAAa,QAAO;;;;AAKlC,SAAO;;;;;;ACzCf,IAAa,SAAb,MAAoB;CAUhB,OAAO,aAAc,MAAc,OAAe,MAAM,MAAuC;EAE3F,MAAM,QAAQ;EACd,MAAM,QAAQ,KAAK,IAAI,QAAQ,OAAO,SAAS,IAAI;EACnD,MAAM,OAAO,KAAK,IAAI,QAAQ,KAAK,QAAQ,OAAO,GAAG,CAAC,SAAS,MAAM,QAAQ,OAAO,GAAG,CAAC,SAAS,IAAI,EAAE;AAEvG,MAAI,IAAK,QAAO,QAAQ,IAAI,MAAM,MAAM,KAAK,IAAI,OAAO,KAAK,CAAC,EAAE,MAAM;MACjE,QAAO;GAAC;GAAM,MAAM,KAAK,IAAI,OAAO,KAAK,CAAC;GAAE;GAAM;;;;;;;;;;;CAY3D,OAAO,MAAO,MAAc,OAAe,QAAuC,OAAO,OAAO,cAAc,OAAO;AACjH,aAAW;EACX,MAAM,QAAQ;GAAE,SAAS,MAAM;GAAS,MAAM,MAAM;GAAQ,OAAO,MAAM;GAAO;EAEhF,MAAM,CAAC,OAAO,MAAM,OAAO,KAAK,aAAa,MAAM,OAAO,MAAM;AAEhE,UAAQ,IAAI,KAAK,WAAW,OAAO,MAAM,SAAS,YAAY,EAAE,MAAM,IAAI;AAE1E,MAAI,KAAM,SAAQ,KAAK,EAAE;;;;;;;;;;CAW7B,OAAO,WAAY,KAAU,OAAgC,cAAc,OAAO;AAC9E,MAAI,YAAa,QAAO,OAAO,IAAI;AACnC,SAAO,OAAO,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK,GAAG,GAAG,MAAM,KAAK,KAAK,EAAE,SAAS,IAAI,MAAM,MAAM,IAAI,KAAK,GAAG,EAAE,CAAC,KAAK,GAAG;;;;;;;;;CAU/G,OAAO,QAAS,KAAU,OAAO,OAAO,cAAc,OAAO;AACzD,UAAQ,IAAI,MAAM,MAAM,IAAI,EAAE,KAAK,WAAW,KAAK,MAAM,SAAS,YAAY,EAAE,KAAK;AACrF,MAAI,KAAM,SAAQ,KAAK,EAAE;;;;;;;;;CAU7B,OAAO,KAAM,KAAU,OAAO,OAAO,cAAc,OAAO;AACtD,UAAQ,IAAI,MAAM,KAAK,IAAI,EAAE,KAAK,WAAW,KAAK,MAAM,QAAQ,YAAY,EAAE,KAAK;AACnF,MAAI,KAAM,SAAQ,KAAK,EAAE;;;;;;;;;CAU7B,OAAO,MAAO,KAAsD,OAAO,MAAM,cAAc,OAAO;AAClG,MAAI,eAAe,OAAO;AACtB,OAAI,IAAI,QACJ,SAAQ,MAAM,MAAM,IAAI,IAAI,EAAE,KAAK,WAAW,WAAW,IAAI,SAAS,MAAM,OAAO,YAAY,CAAC;AAEpG,WAAQ,MAAM,MAAM,IAAI,GAAG,IAAI,SAAS,GAAG,IAAI,OAAO,MAAM,KAAK,IAAI,QAAQ,EAAE,KAAK;QAGpF,SAAQ,MAAM,MAAM,IAAI,IAAI,EAAE,KAAK,WAAW,KAAK,MAAM,OAAO,YAAY,EAAE,KAAK;AAEvF,MAAI,KAAM,SAAQ,KAAK,EAAE;;;;;CAM7B,OAAO,QAAS;AACZ,UAAQ,KAAK,EAAE;;CAYnB,OAAO,MAAO,QAAyD,SAAS,KAAK,MAAM,MAAqB;EAC5G,MAAM,SAAS,OAAO,KAAK,CAAC,KAAK,SAAS;AACtC,UAAO,OAAO,QAAQ,YAAY,OAAO,MAAM,SAAS,aACjD,MAAc,KAAK,IAAI,GACxB,OAAO,QAAQ,aAAa,IAAI,IAAI,GAAG;IAC/C,CAAC,KAAK,OAAO;AAEf,MAAI,IAAK,SAAQ,IAAI,OAAO;MACvB,QAAO;;CAWhB,OAAO,IAAK,QAAmD,QAAgC;AAC3F,MAAI,OAAO,WAAW,UAAU;GAC5B,MAAM,OAAO,CAAC,CAAC,QAAQ,OAAO,CAAC;AAC/B,UAAO,KAAK,MAAM,KAAK;aAChB,OACP,QAAO,KAAK,MAAM,QAAQ,OAAO;AAErC,SAAO;;;;;;AC1If,IAAa,aAAb,MAAwB;CACpB,AAAQ,QAAQ;EACZ,MAAM;EACN,OAAO;EACP,QAAQ;EACR,QAAQ;EACR,QAAQ;EACR,QAAQ;EACR,SAAS;EACT,UAAU;EACb;;;;;;;;;CAUD,QAAS,MAAiB,QAAyB;EAC/C,IAAIC;AAEJ,MAAI,UAAU,SAAS,OACnB,QAAO,SAAS,KAAK,QAAQ,KAAK,MAAM,MAAM;MAE9C,QAAO,KAAK,MAAM;AAGtB,SAAO,KAAK,QAAQ,SAAS,IAAI,QAAQ,IAAI,YAAY,MAAM,GAAG,QAAQ,gBAAgB,KAAK,CAAC;AAEhG,MAAI,SAAS,cAAc,QAAQ,IAAI,YAAY,CAAC,QAAQ,SAAS,QAAQ,IAAI,SAAS,CACtF,QAAO,SAAS,QAAQ,KAAK,QAAQ,QAAQ,IAAI,UAAU,GAAG,CAAC;AAGnE,SAAO;;;;;;;;;CAUX,QAAS,MAAiB,MAAc,MAAe;AACnD,MAAI,QAAQ,SAAS,OACjB,MAAK,MAAM,QAAQ,SAAS,KAAK,MAAM,KAAK;AAGhD,OAAK,MAAM,QAAQ"}
+{"version":3,"file":"index.js","names":["app: IApplication","request: IRequest","response: IResponse","value: any","path: string","result: any"],"sources":["../src/Contracts/IHttp.ts","../src/Utils/EnvParser.ts","../src/Utils/Logger.ts","../src/Utils/PathLoader.ts","../src/Utils/TaskManager.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 | ChalkInstance][], joiner?: string, log?: true): void\n    static parse (config: [string, keyof ChalkInstance | ChalkInstance][], joiner?: string, log?: false): string\n    static parse (config: [string, keyof ChalkInstance | ChalkInstance][], joiner = ' ', log = true): string | void {\n        const string = config.map(([str, opt]) => {\n            return typeof opt === 'string' && typeof chalk[opt] === 'function'\n                ? (chalk as any)[opt](str)\n                : typeof opt === 'function' ? 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","import { Logger } from \"./Logger\"\n\nexport class TaskManager {\n    public static async taskRunner (\n        description: string,\n        task: (() => Promise<any>) | (() => any)\n    ): Promise<void> {\n        const startTime = process.hrtime()\n        let result: any = false\n\n        try {\n            result = await Promise.all([(task || (() => true))()].flat())\n        } finally {\n            const endTime = process.hrtime(startTime)\n            const duration = (endTime[0] * 1e9 + endTime[1]) / 1e6\n            Logger.twoColumnLog(\n                Logger.parse([[description, 'green']], '', false),\n                [\n                    Logger.parse([[`${Math.floor(duration)}ms`, 'gray']], '', false),\n                    Logger.parse([[result !== false ? '✔' : '✘', result !== false ? 'green' : 'red']], '', false),\n                ].join(' ')\n            )\n        }\n    }\n}\n"],"mappings":"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"}

package/package.json

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