@arkstack/common 0.2.4 → 0.3.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Toneflix Technologies Limited
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/app.d.ts

@@ -1,4 +1,4 @@
-import { GlobalConfig, GlobalEnv } from './system'
+import { GlobalConfig, GlobalEnv } from './'
 
 declare global {
   var env: GlobalEnv

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 /// <reference path="./app.d.ts" />
 import { DotPath } from "@h3ravel/support";
+import { ChalkInstance } from "chalk";
 
 //#region src/lifecycle.d.ts
 declare const bindGracefulShutdown: (shutdown: () => Promise<void> | void) => void;
@@ -21,16 +22,68 @@ declare const buildHtmlErrorResponse: ({
 //#region src/prototypes.d.ts
 declare const loadPrototypes: () => void;
 //#endregion
-//#region src/system.d.ts
+//#region src/Logger.d.ts
+declare class Console {
+  static log: (...args: any[]) => string | void;
+  static debug: (...args: any[]) => void;
+  static warn: (...args: any[]) => void[];
+  static info: (...args: any[]) => void[];
+  static error: (...args: any[]) => void[];
+}
+declare class Logger {
+  private static verbosity;
+  private static isQuiet;
+  private static isSilent;
+  static configure(options?: {
+    verbosity?: number;
+    quiet?: boolean;
+    silent?: boolean;
+  }): void;
+  private static shouldSuppressOutput;
+  static twoColumnDetail(name: string, value: string, log?: true, spacer?: string): void;
+  static twoColumnDetail(name: string, value: string, log?: false, spacer?: string): [string, string, string];
+  static describe(name: string, desc: string, width?: number, log?: true): void;
+  static describe(name: string, desc: string, width?: number, log?: false): [string, string, string];
+  static split(name: string, value: string, status?: 'success' | 'info' | 'error', exit?: boolean, preserveCol?: boolean, spacer?: string): void;
+  static textFormat(txt: unknown | unknown[], color: (...text: unknown[]) => string, preserveCol?: boolean): string;
+  static success(msg: any, exit?: boolean, preserveCol?: boolean): void;
+  static info(msg: any, exit?: boolean, preserveCol?: boolean): void;
+  static error(msg: any, exit?: boolean, preserveCol?: boolean): void;
+  static warn(msg: any, exit?: boolean, preserveCol?: boolean): void;
+  static debug<M = any>(msg: M | M[], exit?: boolean, preserveCol?: boolean): void;
+  static quiet(): void;
+  static chalker(styles: LoggerChalk[]): (input: any) => string;
+  static parse(config: LoggerParseSignature, joiner?: string, log?: true, sc?: LoggerChalk): void;
+  static parse(config: LoggerParseSignature, joiner?: string, log?: false, sc?: LoggerChalk): string;
+  static log: LoggerLog;
+  static console(): typeof Console;
+}
+//#endregion
+//#region src/types.d.ts
+type LoggerChalk = keyof ChalkInstance | ChalkInstance | (keyof ChalkInstance)[];
+type LoggerParseSignature = [string, LoggerChalk][];
+type DotPathValue<T, P extends string> = P extends `${infer Head}.${infer Tail}` ? Head extends keyof T ? DotPathValue<T[Head], Tail> : never : P extends keyof T ? T[P] : never;
+interface LoggerLog {
+  (): typeof Logger;
+  <L extends boolean>(config: string, joiner: LoggerChalk, log?: L, sc?: LoggerChalk): L extends true ? void : string;
+  <L extends boolean>(config: LoggerParseSignature, joiner?: string, log?: L, sc?: LoggerChalk): L extends true ? void : string;
+  <L extends boolean>(config?: LoggerParseSignature, joiner?: string, log?: L, sc?: LoggerChalk): L extends true ? void : string | Logger;
+}
 interface GlobalEnv {
-  <X = string, Y = undefined>(env: string, defaultValue?: Y): Y extends undefined ? X : Y;
+  <X = string, Y = undefined | X>(env: string, defaultValue?: Y): Y extends undefined ? X : Y;
 }
-declare const env: GlobalEnv;
-declare const appUrl: (link?: string) => string;
 interface GlobalConfig {
-  <X extends Record<string, any>, P extends DotPath<X> | undefined = undefined>(key?: P, defaultValue?: any): P extends string ? any : X;
+  <X extends Record<string, any>>(): X;
+  <X extends Record<string, any>, P extends DotPath<X>>(key: P): DotPathValue<X, P>;
+  <X extends Record<string, any>, P extends DotPath<X>, D>(key: P, defaultValue: D): DotPathValue<X, P> | D;
 }
+//#endregion
+//#region src/system.d.ts
+declare const env: GlobalEnv;
+declare const appUrl: (link?: string) => string;
 declare const config: GlobalConfig;
+declare const nodeEnv: () => "prod" | "dev";
+declare const outputDir: (cwd?: string) => string;
 //#endregion
-export { GlobalConfig, GlobalEnv, appUrl, bindGracefulShutdown, bootWithDetectedPort, buildHtmlErrorResponse, config, env, loadPrototypes };
+export { DotPathValue, GlobalConfig, GlobalEnv, Logger, LoggerChalk, LoggerLog, LoggerParseSignature, appUrl, bindGracefulShutdown, bootWithDetectedPort, buildHtmlErrorResponse, config, env, loadPrototypes, nodeEnv, outputDir };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -3,6 +3,7 @@ import { createRequire } from "module";
 import path from "node:path";
 import { readdirSync } from "fs";
 import { detect } from "detect-port";
+import chalk from "chalk";
 
 //#region src/lifecycle.ts
 const bindGracefulShutdown = (shutdown) => {
@@ -86,6 +87,30 @@ const config = (key, defaultValue) => {
 	if (key) return Obj.get(config, key, defaultValue);
 	return config;
 };
+/**
+* Gets the current Node environment (development or production).
+* 
+* @returns 
+*/
+const nodeEnv = () => {
+	let envValue = env("NODE_ENV", "development");
+	if (envValue !== "development" && envValue !== "production") envValue = "development";
+	return envValue === "production" ? "prod" : "dev";
+};
+/**
+* Gets the output directory for the application based on the current environment.
+* 
+* @param cwd  The current working directory (optional, defaults to process.cwd()).
+* @returns 
+*/
+const outputDir = (cwd = process.cwd()) => {
+	const NODE_ENV = nodeEnv();
+	const output = {
+		dev: env("OUTPUT_DIR_DEV", ".arkstack/build"),
+		prod: env("OUTPUT_DIR", "dist")
+	};
+	return path.isAbsolute(output[NODE_ENV] ?? output.dev) ? output[NODE_ENV] ?? output.dev : path.join(cwd, output[NODE_ENV] ?? output.dev);
+};
 
 //#endregion
 //#region src/network.ts
@@ -174,5 +199,209 @@ const loadPrototypes = () => {
 };
 
 //#endregion
-export { appUrl, bindGracefulShutdown, bootWithDetectedPort, buildHtmlErrorResponse, config, env, loadPrototypes };
+//#region src/Logger.ts
+var Console = class {
+	static log = (...args) => Logger.log(args.map((e) => [e, "white"]));
+	static debug = (...args) => Logger.debug(args, false, true);
+	static warn = (...args) => args.map((e) => Logger.warn(e, false, true));
+	static info = (...args) => args.map((e) => Logger.info(e, false, true));
+	static error = (...args) => args.map((e) => Logger.error(e, false), true);
+};
+var Logger = class Logger {
+	/**
+	* Global verbosity configuration
+	*/
+	static verbosity = 0;
+	static isQuiet = false;
+	static isSilent = false;
+	/**
+	* Configure global verbosity levels
+	*/
+	static configure(options = {}) {
+		this.verbosity = options.verbosity ?? 0;
+		this.isQuiet = options.quiet ?? false;
+		this.isSilent = options.silent ?? false;
+	}
+	/**
+	* Check if output should be suppressed
+	*/
+	static shouldSuppressOutput(level) {
+		if (this.isSilent) return true;
+		if (this.isQuiet && (level === "info" || level === "success")) return true;
+		if (level === "debug" && this.verbosity < 3) return true;
+		return false;
+	}
+	static twoColumnDetail(name, value, log = true, spacer = ".") {
+		const regex = /\x1b\[\d+m/g;
+		const width = Math.max(process.stdout.columns, 100);
+		const dots = Math.max(width - name.replace(regex, "").length - value.replace(regex, "").length - 10, 0);
+		if (log) return console.log(name, chalk.gray(spacer.repeat(dots)), value);
+		else return [
+			name,
+			chalk.gray(spacer.repeat(dots)),
+			value
+		];
+	}
+	static describe(name, desc, width = 50, log = true) {
+		width = Math.max(width, 30);
+		const dots = Math.max(width - name.replace(/\x1b\[\d+m/g, "").length, 0);
+		if (log) return console.log(name, " ".repeat(dots), desc);
+		else return [
+			name,
+			" ".repeat(dots),
+			desc
+		];
+	}
+	/**
+	* Logs the message in two columns but allways passing status
+	* 
+	* @param name 
+	* @param value 
+	* @param status 
+	* @param exit 
+	* @param preserveCol 
+	*/
+	static split(name, value, status, exit = false, preserveCol = false, spacer = ".") {
+		status ??= "info";
+		const color = {
+			success: chalk.bgGreen,
+			info: chalk.bgBlue,
+			error: chalk.bgRed
+		};
+		const [_name, dots, val] = this.twoColumnDetail(name, value, false, spacer);
+		console.log(this.textFormat(_name, color[status], preserveCol), dots, val);
+		if (exit) process.exit(0);
+	}
+	/**
+	* Wraps text with chalk
+	* 
+	* @param txt 
+	* @param color 
+	* @param preserveCol 
+	* @returns 
+	*/
+	static textFormat(txt, color, preserveCol = false) {
+		if (txt instanceof Error) {
+			const err = txt;
+			const code = err.code ?? err.statusCode ? ` (${err.code ?? err.statusCode})` : "";
+			const output = [];
+			if (err.message) output.push(this.textFormat(`${err.constructor.name}${code}: ${err.message}`, chalk.bgRed, preserveCol));
+			if (err.stack) output.push("    " + chalk.white(err.stack.replace(`${err.name}: ${err.message}`, "").trim()));
+			return output.join("\n");
+		}
+		if (Array.isArray(txt)) return txt.map((e) => this.textFormat(e, color, preserveCol)).join("\n");
+		if (typeof txt === "object") return this.textFormat(Object.values(txt), color, preserveCol);
+		if (typeof txt !== "string") return color(txt);
+		const str = String(txt);
+		if (preserveCol) return str;
+		const [first, ...rest] = str.split(":");
+		if (rest.length === 0) return str;
+		return color(` ${first} `) + rest.join(":");
+	}
+	/**
+	* Logs a success message
+	* 
+	* @param msg 
+	* @param exit 
+	* @param preserveCol 
+	*/
+	static success(msg, exit = false, preserveCol = false) {
+		if (!this.shouldSuppressOutput("success")) console.log(chalk.green("✓"), this.textFormat(msg, chalk.bgGreen, preserveCol));
+		if (exit) process.exit(0);
+	}
+	/**
+	* Logs an informational message
+	* 
+	* @param msg 
+	* @param exit 
+	* @param preserveCol 
+	*/
+	static info(msg, exit = false, preserveCol = false) {
+		if (!this.shouldSuppressOutput("info")) console.log(chalk.blue("ℹ"), this.textFormat(msg, chalk.bgBlue, preserveCol));
+		if (exit) process.exit(0);
+	}
+	/**
+	* Logs an error message
+	* 
+	* @param msg 
+	* @param exit 
+	* @param preserveCol 
+	*/
+	static error(msg, exit = true, preserveCol = false) {
+		if (!this.shouldSuppressOutput("error")) if (msg instanceof Error) {
+			if (msg.message) console.error(chalk.red("✖"), this.textFormat("ERROR:" + msg.message, chalk.bgRed, preserveCol));
+			console.error(chalk.red(`${msg.detail ? `${msg.detail}\n` : ""}${msg.stack}`));
+		} else console.error(chalk.red("✖"), this.textFormat(msg, chalk.bgRed, preserveCol));
+		if (exit) process.exit(1);
+	}
+	/**
+	* Logs a warning message
+	* 
+	* @param msg 
+	* @param exit 
+	* @param preserveCol 
+	*/
+	static warn(msg, exit = false, preserveCol = false) {
+		if (!this.shouldSuppressOutput("warn")) console.warn(chalk.yellow("⚠"), this.textFormat(msg, chalk.bgYellow, preserveCol));
+		if (exit) process.exit(0);
+	}
+	/**
+	* Logs a debug message (only shown with verbosity >= 3)
+	* 
+	* @param msg 
+	* @param exit 
+	* @param preserveCol 
+	*/
+	static debug(msg, exit = false, preserveCol = false) {
+		if (!this.shouldSuppressOutput("debug")) if (Array.isArray(msg)) for (let i = 0; i < msg.length; i++) console.log(chalk.gray("🐛"), chalk.bgGray(i + 1), this.textFormat(msg[i], chalk.bgGray, preserveCol));
+		else console.log(chalk.gray("🐛"), this.textFormat(msg, chalk.bgGray, preserveCol));
+		if (exit) process.exit(0);
+	}
+	/**
+	* Terminates the process
+	*/
+	static quiet() {
+		process.exit(0);
+	}
+	static chalker(styles) {
+		return (input) => styles.reduce((acc, style) => {
+			if (style in chalk) return (typeof style === "function" ? style : chalk[style])(acc);
+			return acc;
+		}, input);
+	}
+	static parse(config, joiner = " ", log = true, sc) {
+		const string = config.map(([str, opt]) => {
+			if (Array.isArray(opt)) opt = Logger.chalker(opt);
+			const output = typeof opt === "string" && typeof chalk[opt] === "function" ? chalk[opt](str) : typeof opt === "function" ? opt(str) : str;
+			if (!sc) return output;
+			return this.textFormat(output, Logger.chalker(Array.isArray(sc) ? sc : [sc]));
+		}).join(joiner);
+		if (log && !this.shouldSuppressOutput("line")) console.log(string);
+		else return string;
+	}
+	/**
+	* Ouput formater object or format the output
+	* 
+	* @returns 
+	*/
+	static log = ((config, joiner, log = true, sc) => {
+		if (typeof config === "string") {
+			const conf = [[config, joiner]];
+			return this.parse(conf, "", log, sc);
+		} else if (Array.isArray(config)) return this.parse(config, String(joiner), log, sc);
+		else if (log && !this.shouldSuppressOutput("line")) return console.log(this.textFormat(config, Logger.chalker(["blue"])));
+		return this;
+	});
+	/**
+	* A simple console like output logger
+	* 
+	* @returns 
+	*/
+	static console() {
+		return Console;
+	}
+};
+
+//#endregion
+export { Logger, appUrl, bindGracefulShutdown, bootWithDetectedPort, buildHtmlErrorResponse, config, env, loadPrototypes, nodeEnv, outputDir };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/lifecycle.ts","../src/system.ts","../src/network.ts","../src/prototypes.ts"],"sourcesContent":["export const bindGracefulShutdown = (shutdown: () => Promise<void> | void) => {\n  ['SIGINT', 'SIGTERM', 'SIGQUIT'].forEach((signal) => {\n    process.on(signal, async () => {\n      await shutdown()\n    })\n  })\n}\n","import { DotPath, Obj } from '@h3ravel/support'\n\nimport { createRequire } from 'module'\nimport path from 'node:path'\nimport { readdirSync } from 'fs'\n\nexport interface GlobalEnv {\n    <X = string, Y = undefined> (\n        env: string,\n        defaultValue?: Y,\n    ): Y extends undefined ? X : Y\n}\n\n/**\n * Read the .env file\n *\n * @param env\n * @param def\n * @returns\n */\nexport const env: GlobalEnv = <X = string, Y = undefined> (\n    env: string,\n    defaultValue?: Y,\n) => {\n    let val: string | number | boolean | undefined | null = process.env[env] ?? ''\n\n    if ([true, 'true', 'on', false, 'false', 'off'].includes(val)) {\n        val = [true, 'true', 'on'].includes(val)\n    }\n\n    if (!isNaN(Number(val)) && typeof val !== 'boolean' && typeof val !== 'undefined' && val !== '') {\n        val = Number(val)\n    }\n\n    if (val === '') {\n        val = undefined\n    }\n\n    if (val === 'null') {\n        val = null\n    }\n\n    val ??= defaultValue as typeof val\n\n    return val as Y extends undefined ? X : Y\n}\n\n/**\n * Build the app url\n *\n * @param link\n * @returns\n */\nexport const appUrl = (link?: string): string => {\n    const port = env('PORT') || '3000'\n    const defaultUrl = `http://localhost:${port}`\n    const appUrl = env('APP_URL') ?? defaultUrl\n\n    try {\n        const url = new URL(appUrl)\n        // Append port only if APP_URL has a port or is localhost\n        if (url.port || url.hostname === 'localhost') {\n            url.port = port\n        }\n        // Remove trailing slash from base URL\n        const baseUrl = url.toString().replace(/\\/$/, '')\n        // Append link with proper path separator\n        if (link) {\n            // Ensure link starts with '/' and remove duplicate slashes\n            const normalizedLink = `/${link.replace(/^\\/+/, '')}`\n\n            return `${baseUrl}${normalizedLink}`\n        }\n\n        return baseUrl\n    } catch {\n        // Return default URL with link if provided\n        return link ? `${defaultUrl}/${link.replace(/^\\/+/, '')}` : defaultUrl\n    }\n}\n\nexport interface GlobalConfig {\n    <X extends Record<string, any>, P extends DotPath<X> | undefined = undefined> (\n        key?: P,\n        defaultValue?: any\n    ): P extends string ? any : X\n}\n\n/**\n * Gets the application configuration.\n * \n * @param key             The configuration key to retrieve.\n * @param defaultValue    The default value to return if the key is not found.\n * @returns               The configuration value.\n */\nexport const config: GlobalConfig = <X extends Record<string, any>, P extends DotPath<X> | undefined = undefined> (\n    key?: P,\n    defaultValue?: any\n) => {\n    const require = createRequire(import.meta.url)\n\n    const files = readdirSync(path.join(process.cwd(), 'dist/config'), { withFileTypes: true })\n        .filter(file => {\n            if (file.name.includes('middleware') && globalThis.arkctx.runtime === 'CLI') return false\n\n            return file.isFile() && (file.name.endsWith('.js') || file.name.endsWith('.ts'))\n        })\n\n    const config = files.reduce((configs, file) => {\n        const configName = path.basename(file.name, path.extname(file.name))\n\n        configs[configName] = require(path.join(file.parentPath, file.name))\n            .default((globalThis as any).app())\n\n        return configs\n    }, {} as Record<string, any>) as X\n\n\n    if (key) {\n        return Obj.get(config, key, defaultValue)\n    }\n\n    return config\n}","import { config, env } from './system'\n\nimport { detect } from 'detect-port'\n\nexport const bootWithDetectedPort = async (\n  boot: (port: number) => Promise<void>,\n  preferredPort: number = 3000,\n  app?: any\n) => {\n  if (app && !globalThis.app)\n    globalThis.app = () => app\n  globalThis.env = env\n  globalThis.config = config\n  globalThis.arkctx = {\n    runtime: 'HTTP',\n  }\n  const port = await detect(preferredPort)\n  await boot(port)\n}\n\n\nexport const buildHtmlErrorResponse = ({\n  message = 'An unexpected error occurred.',\n  stack,\n  title,\n  code = 500,\n}: {\n  message?: string;\n  stack?: string;\n  code?: number;\n  title?: string;\n}) => {\n  const titleMap: Record<number, string> = {\n    400: 'Bad Request',\n    401: 'Unauthorized',\n    403: 'Forbidden',\n    404: 'Not Found',\n    500: 'Internal Server Error',\n    502: 'Bad Gateway',\n    503: 'Service Unavailable',\n    504: 'Gateway Timeout',\n  }\n\n  title = titleMap[code] || title || 'Error'\n\n  return `\n    <html>\n      <head>\n        <title>${code} | ${title}</title>\n        <style>\n          body {\n            font-family: Arial, sans-serif;\n            background-color: #f8f8f8;\n            color: #333;\n            padding: 20px;\n          }\n          h1 {\n            color: #e74c3c;\n          }\n          h3 {\n            color: #3498db;\n          }\n          p {\n            color: #555;\n          }\n          pre {\n            background-color: #eee;\n            padding: 10px;\n            border-radius: 5px;\n            overflow-x: auto;\n          }\n        </style>\n      </head>\n      <body>\n        <h1>${code}</h1>\n        <h3>${title}</h3>\n        <p>${message}</p>\n        ${stack ? `<h2>Stack Trace:</h2><pre>${stack}</pre>` : ''}\n      </body>\n    </html>\n  `\n}","export const loadPrototypes = () => {\n    String.prototype.titleCase = function () {\n        return this.toLowerCase()\n            .replace(/_/g, ' ')\n            .replace(/-/g, ' ')\n            .replace(/(?:^|\\s)\\w/g, function (match) {\n                return match.toUpperCase()\n            })\n    }\n\n    String.prototype.camelCase = function () {\n        return this.replace(/(?:^\\w|[A-Z]|\\b\\w|\\s+)/g, function (match, index) {\n            if (+match === 0) return '' // or if (/\\s+/.test(match)) for white spaces\n\n            return index === 0 ? match.toLowerCase() : match.toUpperCase()\n        })\n    }\n\n    String.prototype.pascalCase = function () {\n        return this.replace(/(?:^\\w|[A-Z]|\\b\\w|\\s+)/g, function (match) {\n            return match.toUpperCase()\n        })\n    }\n\n    String.prototype.truncate = function (len: number = 20, suffix: string = '...') {\n        if (this.length <= len) {\n            return this.toString()\n        }\n\n        const truncated = this.substring(0, len)\n        const lastSpaceIndex = truncated.lastIndexOf(' ')\n        if (lastSpaceIndex > 0) {\n            return truncated.substring(0, lastSpaceIndex) + suffix\n        }\n\n        return truncated + suffix\n    }\n} \n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/lifecycle.ts","../src/system.ts","../src/network.ts","../src/prototypes.ts","../src/Logger.ts"],"sourcesContent":["export const bindGracefulShutdown = (shutdown: () => Promise<void> | void) => {\n  ['SIGINT', 'SIGTERM', 'SIGQUIT'].forEach((signal) => {\n    process.on(signal, async () => {\n      await shutdown()\n    })\n  })\n}\n","import { DotPath, Obj } from '@h3ravel/support'\nimport { GlobalConfig, GlobalEnv } from './types'\n\nimport { createRequire } from 'module'\nimport path from 'node:path'\nimport { readdirSync } from 'fs'\n\n/**\n * Read the .env file\n *\n * @param env\n * @param def\n * @returns\n */\nexport const env: GlobalEnv = <X = string, Y = undefined | X> (\n    env: string,\n    defaultValue?: Y,\n) => {\n    let val: string | number | boolean | undefined | null = process.env[env] ?? ''\n\n    if ([true, 'true', 'on', false, 'false', 'off'].includes(val)) {\n        val = [true, 'true', 'on'].includes(val)\n    }\n\n    if (!isNaN(Number(val)) && typeof val !== 'boolean' && typeof val !== 'undefined' && val !== '') {\n        val = Number(val)\n    }\n\n    if (val === '') {\n        val = undefined\n    }\n\n    if (val === 'null') {\n        val = null\n    }\n\n    val ??= defaultValue as typeof val\n\n    return val as Y extends undefined ? X : Y\n}\n\n/**\n * Build the app url\n *\n * @param link\n * @returns\n */\nexport const appUrl = (link?: string): string => {\n    const port = env('PORT') || '3000'\n    const defaultUrl = `http://localhost:${port}`\n    const appUrl = env('APP_URL') ?? defaultUrl\n\n    try {\n        const url = new URL(appUrl)\n        // Append port only if APP_URL has a port or is localhost\n        if (url.port || url.hostname === 'localhost') {\n            url.port = port\n        }\n        // Remove trailing slash from base URL\n        const baseUrl = url.toString().replace(/\\/$/, '')\n        // Append link with proper path separator\n        if (link) {\n            // Ensure link starts with '/' and remove duplicate slashes\n            const normalizedLink = `/${link.replace(/^\\/+/, '')}`\n\n            return `${baseUrl}${normalizedLink}`\n        }\n\n        return baseUrl\n    } catch {\n        // Return default URL with link if provided\n        return link ? `${defaultUrl}/${link.replace(/^\\/+/, '')}` : defaultUrl\n    }\n}\n\n/**\n * Gets the application configuration.\n * \n * @param key             The configuration key to retrieve.\n * @param defaultValue    The default value to return if the key is not found.\n * @returns               The configuration value.\n */\nexport const config: GlobalConfig = <X extends Record<string, any>, P extends DotPath<X> | undefined = undefined> (\n    key?: P,\n    defaultValue?: any\n) => {\n    const require = createRequire(import.meta.url)\n\n    const files = readdirSync(path.join(process.cwd(), 'dist/config'), { withFileTypes: true })\n        .filter(file => {\n            if (file.name.includes('middleware') && globalThis.arkctx.runtime === 'CLI') return false\n\n            return file.isFile() && (file.name.endsWith('.js') || file.name.endsWith('.ts'))\n        })\n\n    const config = files.reduce((configs, file) => {\n        const configName = path.basename(file.name, path.extname(file.name))\n\n        configs[configName] = require(path.join(file.parentPath, file.name))\n            .default((globalThis as any).app())\n\n        return configs\n    }, {} as Record<string, any>) as X\n\n\n    if (key) {\n        return Obj.get(config, key, defaultValue)\n    }\n\n    return config\n}\n\n/**\n * Gets the current Node environment (development or production).\n * \n * @returns \n */\nexport const nodeEnv = () => {\n    let envValue = env<'development' | 'production'>('NODE_ENV', 'development')\n\n    if (envValue !== 'development' && envValue !== 'production') {\n        envValue = 'development'\n    }\n\n    return envValue === 'production' ? 'prod' : 'dev'\n}\n\n/**\n * Gets the output directory for the application based on the current environment.\n * \n * @param cwd  The current working directory (optional, defaults to process.cwd()).\n * @returns \n */\nexport const outputDir = (cwd = process.cwd()) => {\n    const NODE_ENV = nodeEnv()\n\n    const output = {\n        dev: env('OUTPUT_DIR_DEV', '.arkstack/build'),\n        prod: env('OUTPUT_DIR', 'dist'),\n    }\n\n    return path.isAbsolute(output[NODE_ENV] ?? output.dev)\n        ? (output[NODE_ENV] ?? output.dev)\n        : path.join(cwd, output[NODE_ENV] ?? output.dev)\n}","import { config, env } from './system'\n\nimport { detect } from 'detect-port'\n\nexport const bootWithDetectedPort = async (\n  boot: (port: number) => Promise<void>,\n  preferredPort: number = 3000,\n  app?: any\n) => {\n  if (app && !globalThis.app)\n    globalThis.app = () => app\n  globalThis.env = env\n  globalThis.config = config\n  globalThis.arkctx = {\n    runtime: 'HTTP',\n  }\n  const port = await detect(preferredPort)\n  await boot(port)\n}\n\n\nexport const buildHtmlErrorResponse = ({\n  message = 'An unexpected error occurred.',\n  stack,\n  title,\n  code = 500,\n}: {\n  message?: string;\n  stack?: string;\n  code?: number;\n  title?: string;\n}) => {\n  const titleMap: Record<number, string> = {\n    400: 'Bad Request',\n    401: 'Unauthorized',\n    403: 'Forbidden',\n    404: 'Not Found',\n    500: 'Internal Server Error',\n    502: 'Bad Gateway',\n    503: 'Service Unavailable',\n    504: 'Gateway Timeout',\n  }\n\n  title = titleMap[code] || title || 'Error'\n\n  return `\n    <html>\n      <head>\n        <title>${code} | ${title}</title>\n        <style>\n          body {\n            font-family: Arial, sans-serif;\n            background-color: #f8f8f8;\n            color: #333;\n            padding: 20px;\n          }\n          h1 {\n            color: #e74c3c;\n          }\n          h3 {\n            color: #3498db;\n          }\n          p {\n            color: #555;\n          }\n          pre {\n            background-color: #eee;\n            padding: 10px;\n            border-radius: 5px;\n            overflow-x: auto;\n          }\n        </style>\n      </head>\n      <body>\n        <h1>${code}</h1>\n        <h3>${title}</h3>\n        <p>${message}</p>\n        ${stack ? `<h2>Stack Trace:</h2><pre>${stack}</pre>` : ''}\n      </body>\n    </html>\n  `\n}","export const loadPrototypes = () => {\n    String.prototype.titleCase = function () {\n        return this.toLowerCase()\n            .replace(/_/g, ' ')\n            .replace(/-/g, ' ')\n            .replace(/(?:^|\\s)\\w/g, function (match) {\n                return match.toUpperCase()\n            })\n    }\n\n    String.prototype.camelCase = function () {\n        return this.replace(/(?:^\\w|[A-Z]|\\b\\w|\\s+)/g, function (match, index) {\n            if (+match === 0) return '' // or if (/\\s+/.test(match)) for white spaces\n\n            return index === 0 ? match.toLowerCase() : match.toUpperCase()\n        })\n    }\n\n    String.prototype.pascalCase = function () {\n        return this.replace(/(?:^\\w|[A-Z]|\\b\\w|\\s+)/g, function (match) {\n            return match.toUpperCase()\n        })\n    }\n\n    String.prototype.truncate = function (len: number = 20, suffix: string = '...') {\n        if (this.length <= len) {\n            return this.toString()\n        }\n\n        const truncated = this.substring(0, len)\n        const lastSpaceIndex = truncated.lastIndexOf(' ')\n        if (lastSpaceIndex > 0) {\n            return truncated.substring(0, lastSpaceIndex) + suffix\n        }\n\n        return truncated + suffix\n    }\n} \n","import chalk, { type ChalkInstance } from 'chalk'\nimport { LoggerChalk, LoggerLog, LoggerParseSignature } from './types'\n\nclass Console {\n    static log = (...args: any[]) => Logger.log(args.map(e => [e, 'white']))\n    static debug = (...args: any[]) => Logger.debug(args, false, true)\n    static warn = (...args: any[]) => args.map(e => Logger.warn(e, false, true))\n    static info = (...args: any[]) => args.map(e => Logger.info(e, false, true))\n    static error = (...args: any[]) => args.map(e => Logger.error(e, false), true)\n}\n\nexport class Logger {\n    /**\n     * Global verbosity configuration\n     */\n    private static verbosity: number = 0\n    private static isQuiet: boolean = false\n    private static isSilent: boolean = false\n\n    /**\n     * Configure global verbosity levels\n     */\n    static configure (options: { verbosity?: number, quiet?: boolean, silent?: boolean } = {}) {\n        this.verbosity = options.verbosity ?? 0\n        this.isQuiet = options.quiet ?? false\n        this.isSilent = options.silent ?? false\n    }\n\n    /**\n     * Check if output should be suppressed\n     */\n    private static shouldSuppressOutput (level: 'line' | 'debug' | 'info' | 'warn' | 'error' | 'success'): boolean {\n        if (this.isSilent) return true\n        if (this.isQuiet && (level === 'info' || level === 'success')) return true\n        if (level === 'debug' && this.verbosity < 3) return true\n\n        return false\n    }\n    /**\n     * Logs the message in two columns\n     * \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 twoColumnDetail (name: string, value: string, log?: true, spacer?: string): void\n    static twoColumnDetail (name: string, value: string, log?: false, spacer?: string): [string, string, string]\n    static twoColumnDetail (name: string, value: string, log = true, spacer = '.'): [string, string, string] | void {\n        // eslint-disable-next-line no-control-regex\n        const regex = /\\x1b\\[\\d+m/g\n        const width = Math.max(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(spacer.repeat(dots)), value)\n        else return [name, chalk.gray(spacer.repeat(dots)), value]\n    }\n\n    /**\n     * Logs the message in two columns\n     * \n     * @param name \n     * @param desc \n     * @param width \n     * @param log If set to false, array of [name, dots, value] output will be returned and not logged \n     * @returns \n     */\n    static describe (name: string, desc: string, width?: number, log?: true): void\n    static describe (name: string, desc: string, width?: number, log?: false): [string, string, string]\n    static describe (name: string, desc: string, width = 50, log = true): [string, string, string] | void {\n        width = Math.max(width, 30)\n        // eslint-disable-next-line no-control-regex\n        const regex = /\\x1b\\[\\d+m/g\n        const dots = Math.max(width - name.replace(regex, '').length, 0)\n\n        if (log) return console.log(name, ' '.repeat(dots), desc)\n        else return [name, ' '.repeat(dots), desc]\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, spacer = '.') {\n        status ??= 'info'\n        const color = { success: chalk.bgGreen, info: chalk.bgBlue, error: chalk.bgRed }\n\n        const [_name, dots, val] = this.twoColumnDetail(name, value, false, spacer)\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 (\n        txt: unknown | unknown[],\n        color: (...text: unknown[]) => string,\n        preserveCol = false\n    ): string {\n        if (txt instanceof Error) {\n            const err: Error & { code?: number, statusCode?: number } = txt\n            const code = err.code ?? err.statusCode ? ` (${err.code ?? err.statusCode})` : ''\n            const output: string[] = []\n\n            if (err.message) {\n                output.push(this.textFormat(`${err.constructor.name}${code}: ${err.message}`, chalk.bgRed, preserveCol))\n            }\n\n            if (err.stack) {\n                output.push('    ' + chalk.white(err.stack.replace(`${err.name}: ${err.message}`, '').trim()))\n            }\n\n            return output.join('\\n')\n        }\n\n        if (Array.isArray(txt)) {\n            return txt.map(e => this.textFormat(e, color, preserveCol)).join('\\n')\n        }\n\n        if (typeof txt === 'object') {\n            return this.textFormat(Object.values(txt!), color, preserveCol)\n        }\n\n        if (typeof txt !== 'string') {\n            return color(txt)\n        }\n\n        const str = String(txt)\n\n        if (preserveCol) return str\n\n        const [first, ...rest] = str.split(':')\n        if (rest.length === 0) return str\n\n        return color(` ${first} `) + rest.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        if (!this.shouldSuppressOutput('success')) {\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        if (!this.shouldSuppressOutput('info')) {\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: any, exit = true, preserveCol = false) {\n        if (!this.shouldSuppressOutput('error')) {\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 as any).detail ? `${(msg as any).detail}\\n` : ''}${msg.stack}`))\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     * Logs a warning message\n     * \n     * @param msg \n     * @param exit \n     * @param preserveCol \n     */\n    static warn (msg: any, exit = false, preserveCol = false) {\n        if (!this.shouldSuppressOutput('warn')) {\n            console.warn(chalk.yellow('⚠'), this.textFormat(msg, chalk.bgYellow, preserveCol))\n        }\n        if (exit) process.exit(0)\n    }\n\n    /**\n     * Logs a debug message (only shown with verbosity >= 3)\n     * \n     * @param msg \n     * @param exit \n     * @param preserveCol \n     */\n    static debug<M = any> (msg: M | M[], exit = false, preserveCol = false) {\n        if (!this.shouldSuppressOutput('debug')) {\n            if (Array.isArray(msg)) {\n                for (let i = 0; i < msg.length; i++) {\n                    console.log(chalk.gray('🐛'), chalk.bgGray(i + 1), this.textFormat(msg[i], chalk.bgGray, preserveCol))\n                }\n            } else {\n                console.log(chalk.gray('🐛'), this.textFormat(msg, chalk.bgGray, preserveCol))\n            }\n        }\n        if (exit) process.exit(0)\n    }\n\n    /**\n     * Terminates the process\n     */\n    static quiet () {\n        process.exit(0)\n    }\n\n    static chalker (styles: LoggerChalk[]) {\n        return (input: any): string =>\n            styles.reduce((acc, style) => {\n                if ((style as any) in chalk) {\n                    const fn = typeof style === 'function'\n                        ? style\n                        : chalk[style as never]\n\n                    return fn(acc)\n                }\n\n                return acc\n            }, input)\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     * @param sc color to use ue on split text if : is found \n     */\n    static parse (config: LoggerParseSignature, joiner?: string, log?: true, sc?: LoggerChalk): void\n    static parse (config: LoggerParseSignature, joiner?: string, log?: false, sc?: LoggerChalk): string\n    static parse (config: LoggerParseSignature, joiner = ' ', log = true, sc?: LoggerChalk): string | void {\n        const string = config.map(([str, opt]) => {\n            if (Array.isArray(opt)) {\n                opt = Logger.chalker(opt) as ChalkInstance\n            }\n\n            const output = typeof opt === 'string' && typeof chalk[opt] === 'function'\n                ? (chalk as any)[opt](str)\n                : typeof opt === 'function' ? opt(str) : str\n\n            if (!sc) {\n                return output\n            }\n\n            return this.textFormat(output, Logger.chalker(Array.isArray(sc) ? sc : [sc]))\n        }).join(joiner)\n\n        if (log && !this.shouldSuppressOutput('line')) 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: LoggerLog = ((config, joiner, log: boolean = true, sc) => {\n        if (typeof config === 'string') {\n            const conf = [[config, joiner]] as [string, keyof ChalkInstance][]\n\n            return this.parse(conf, '', log as false, sc)\n        } else if (Array.isArray(config)) {\n            return this.parse(config, String(joiner), log as false, sc)\n        } else if (log && !this.shouldSuppressOutput('line')) {\n            return console.log(this.textFormat(config, Logger.chalker(['blue'])))\n        }\n\n        return this\n    }) as LoggerLog\n\n    /**\n     * A simple console like output logger\n     * \n     * @returns \n     */\n    static console () {\n        return Console\n    }\n}"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arkstack/common",
-  "version": "0.2.4",
+  "version": "0.3.1",
   "type": "module",
   "description": "Common package for Arkstack providing common implementations of core Arkstack features such as routing, middleware, and database integration.",
   "homepage": "https://arkstack.toneflix.net",
@@ -30,6 +30,7 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
+    "chalk": "^5.6.2",
     "detect-port": "^2.1.0"
   },
   "peerDependencies": {