azurajs 2.3.0 → 2.4.0

package/dist/{LoggingMiddleware-CYNvypha.d.cts → LoggingMiddleware-DTrY3W4i.d.cts}

@@ -1,5 +1,5 @@
 import { ConfigTypes } from './config.cjs';
-import { R as RequestHandler } from './common.type-Ct06XeYQ.cjs';
+import { R as RequestHandler } from './common.type-oXALN7XJ.cjs';
 
 declare function createLoggingMiddleware(config: ConfigTypes): RequestHandler;
 

package/dist/{LoggingMiddleware-BQKJUBqT.d.ts → LoggingMiddleware-rWrLslKl.d.ts}

@@ -1,5 +1,5 @@
 import { ConfigTypes } from './config.js';
-import { R as RequestHandler } from './common.type-BoV71o_C.js';
+import { R as RequestHandler } from './common.type-DEa1osVV.js';
 
 declare function createLoggingMiddleware(config: ConfigTypes): RequestHandler;
 

package/dist/{ProxyPlugin-DN5yAhkX.d.cts → ProxyPlugin-C8N2AtaT.d.cts}

@@ -1,6 +1,6 @@
-import { R as RequestServer } from './request.type-CJ-EGGcM.cjs';
+import { a as RequestServer } from './common.type-oXALN7XJ.cjs';
 import { R as ResponseServer } from './response.type-d6e6eU9D.cjs';
-import { P as ProxyOptions } from './proxy.type-CtbSNjKM.cjs';
+import { P as ProxyOptions } from './proxy.type-DSnJz20D.cjs';
 
 declare function createProxyMiddleware(options: ProxyOptions): (req: RequestServer, res: ResponseServer, next?: Function) => Promise<void>;
 /**

package/dist/{ProxyPlugin-DzKHKl5x.d.ts → ProxyPlugin-CzDTnllH.d.ts}

@@ -1,6 +1,6 @@
-import { R as RequestServer } from './request.type-CJ-EGGcM.js';
+import { a as RequestServer } from './common.type-DEa1osVV.js';
 import { R as ResponseServer } from './response.type-d6e6eU9D.js';
-import { P as ProxyOptions } from './proxy.type-CSaviouz.js';
+import { P as ProxyOptions } from './proxy.type-W2HTcyty.js';
 
 declare function createProxyMiddleware(options: ProxyOptions): (req: RequestServer, res: ResponseServer, next?: Function) => Promise<void>;
 /**

package/dist/{Server-CBibslLs.d.cts → Server-2cG_Fz3U.d.cts}

@@ -1,8 +1,8 @@
 import { ConfigTypes } from './config.cjs';
 import http from 'node:http';
 import { Router } from './router.cjs';
-import { R as RequestHandler } from './common.type-Ct06XeYQ.cjs';
-import { P as ProxyOptions } from './proxy.type-CtbSNjKM.cjs';
+import { R as RequestHandler } from './common.type-oXALN7XJ.cjs';
+import { P as ProxyOptions } from './proxy.type-DSnJz20D.cjs';
 
 declare class AzuraClient {
     private opts;

package/dist/{Server-JgWGBIJb.d.ts → Server-47kmx_eB.d.ts}

@@ -1,8 +1,8 @@
 import { ConfigTypes } from './config.js';
 import http from 'node:http';
 import { Router } from './router.js';
-import { R as RequestHandler } from './common.type-BoV71o_C.js';
-import { P as ProxyOptions } from './proxy.type-CSaviouz.js';
+import { R as RequestHandler } from './common.type-DEa1osVV.js';
+import { P as ProxyOptions } from './proxy.type-W2HTcyty.js';
 
 declare class AzuraClient {
     private opts;

package/dist/colors.type-CgmoA5kW.d.cts

@@ -0,0 +1,86 @@
+/**
+ * Logger configuration interface
+ * Allows customization of logger appearance and behavior
+ */
+interface LoggerConfig {
+    /** Custom color mapping for log levels (supports hex, rgb, or predefined color names) */
+    colors?: Record<string, string>;
+    /** Custom icon mapping for log levels */
+    icons?: Record<string, string>;
+    /** Whether to display timestamps in log messages */
+    showTimestamp?: boolean;
+    /** Whether to display icons in log messages */
+    showIcon?: boolean;
+    /** Format for timestamp display: 'time' (HH:MM:SS), 'datetime' (full date and time), or 'iso' (ISO 8601) */
+    timestampFormat?: "time" | "datetime" | "iso";
+    /** Custom prefix for log messages (default: 'Azura') */
+    prefix?: string;
+    /** Whether to display log level in uppercase */
+    uppercase?: boolean;
+    /** Apply bold styling to log level label */
+    bold?: boolean;
+    /** Apply dim/faded styling to log level label */
+    dim?: boolean;
+    /** Background color for log level label (supports hex, rgb, or predefined bg color names) */
+    backgroundColor?: string;
+}
+
+/**
+ * ANSI escape codes for text styling
+ * These codes control text formatting in terminal output
+ */
+declare const RESET = "\u001B[0m";
+declare const BOLD = "\u001B[1m";
+declare const DIM = "\u001B[2m";
+/**
+ * Predefined ANSI foreground colors
+ * Includes standard and bright color variants
+ */
+declare const ANSI_COLORS: {
+    black: string;
+    red: string;
+    green: string;
+    yellow: string;
+    blue: string;
+    magenta: string;
+    cyan: string;
+    white: string;
+    gray: string;
+    brightRed: string;
+    brightGreen: string;
+    brightYellow: string;
+    brightBlue: string;
+    brightMagenta: string;
+    brightCyan: string;
+    brightWhite: string;
+};
+/**
+ * ANSI background color codes
+ * Used for highlighting text with colored backgrounds
+ */
+declare const BG_COLORS: {
+    bgBlack: string;
+    bgRed: string;
+    bgGreen: string;
+    bgYellow: string;
+    bgBlue: string;
+    bgMagenta: string;
+    bgCyan: string;
+    bgWhite: string;
+};
+/**
+ * Default color mapping for each log level
+ * Provides semantic color coding for different message types
+ */
+declare const DEFAULT_COLORS: {
+    debug: string;
+    info: string;
+    success: string;
+    warn: string;
+    error: string;
+    fatal: string;
+    trace: string;
+    log: string;
+};
+
+export { ANSI_COLORS as A, BOLD as B, DIM as D, type LoggerConfig as L, RESET as R, BG_COLORS as a, DEFAULT_COLORS as b };

package/dist/colors.type-CgmoA5kW.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Logger configuration interface
+ * Allows customization of logger appearance and behavior
+ */
+interface LoggerConfig {
+    /** Custom color mapping for log levels (supports hex, rgb, or predefined color names) */
+    colors?: Record<string, string>;
+    /** Custom icon mapping for log levels */
+    icons?: Record<string, string>;
+    /** Whether to display timestamps in log messages */
+    showTimestamp?: boolean;
+    /** Whether to display icons in log messages */
+    showIcon?: boolean;
+    /** Format for timestamp display: 'time' (HH:MM:SS), 'datetime' (full date and time), or 'iso' (ISO 8601) */
+    timestampFormat?: "time" | "datetime" | "iso";
+    /** Custom prefix for log messages (default: 'Azura') */
+    prefix?: string;
+    /** Whether to display log level in uppercase */
+    uppercase?: boolean;
+    /** Apply bold styling to log level label */
+    bold?: boolean;
+    /** Apply dim/faded styling to log level label */
+    dim?: boolean;
+    /** Background color for log level label (supports hex, rgb, or predefined bg color names) */
+    backgroundColor?: string;
+}
+
+/**
+ * ANSI escape codes for text styling
+ * These codes control text formatting in terminal output
+ */
+declare const RESET = "\u001B[0m";
+declare const BOLD = "\u001B[1m";
+declare const DIM = "\u001B[2m";
+/**
+ * Predefined ANSI foreground colors
+ * Includes standard and bright color variants
+ */
+declare const ANSI_COLORS: {
+    black: string;
+    red: string;
+    green: string;
+    yellow: string;
+    blue: string;
+    magenta: string;
+    cyan: string;
+    white: string;
+    gray: string;
+    brightRed: string;
+    brightGreen: string;
+    brightYellow: string;
+    brightBlue: string;
+    brightMagenta: string;
+    brightCyan: string;
+    brightWhite: string;
+};
+/**
+ * ANSI background color codes
+ * Used for highlighting text with colored backgrounds
+ */
+declare const BG_COLORS: {
+    bgBlack: string;
+    bgRed: string;
+    bgGreen: string;
+    bgYellow: string;
+    bgBlue: string;
+    bgMagenta: string;
+    bgCyan: string;
+    bgWhite: string;
+};
+/**
+ * Default color mapping for each log level
+ * Provides semantic color coding for different message types
+ */
+declare const DEFAULT_COLORS: {
+    debug: string;
+    info: string;
+    success: string;
+    warn: string;
+    error: string;
+    fatal: string;
+    trace: string;
+    log: string;
+};
+
+export { ANSI_COLORS as A, BOLD as B, DIM as D, type LoggerConfig as L, RESET as R, BG_COLORS as a, DEFAULT_COLORS as b };

package/dist/{request.type-CJ-EGGcM.d.ts → common.type-DEa1osVV.d.ts}

@@ -1,4 +1,5 @@
 import { IncomingMessage, IncomingHttpHeaders } from 'node:http';
+import { R as ResponseServer } from './response.type-d6e6eU9D.js';
 
 interface RequestServer extends IncomingMessage {
     path: string;
@@ -19,4 +20,11 @@ interface RequestServer extends IncomingMessage {
     header(name: string): string | undefined;
 }
 
-export type { RequestServer as R };
+type RequestHandler = (req: RequestServer, res: ResponseServer, next: (err?: Error | any) => void) => void;
+interface HttpContext {
+    request: RequestServer;
+    response: ResponseServer;
+    body?: Buffer | string;
+}
+
+export type { HttpContext as H, RequestHandler as R, RequestServer as a };

package/dist/{request.type-CJ-EGGcM.d.cts → common.type-oXALN7XJ.d.cts}

@@ -1,4 +1,5 @@
 import { IncomingMessage, IncomingHttpHeaders } from 'node:http';
+import { R as ResponseServer } from './response.type-d6e6eU9D.cjs';
 
 interface RequestServer extends IncomingMessage {
     path: string;
@@ -19,4 +20,11 @@ interface RequestServer extends IncomingMessage {
     header(name: string): string | undefined;
 }
 
-export type { RequestServer as R };
+type RequestHandler = (req: RequestServer, res: ResponseServer, next: (err?: Error | any) => void) => void;
+interface HttpContext {
+    request: RequestServer;
+    response: ResponseServer;
+    body?: Buffer | string;
+}
+
+export type { HttpContext as H, RequestHandler as R, RequestServer as a };

package/dist/config.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/shared/config/ConfigModule.ts"],"names":["path","existsSync","readFileSync"],"mappings":";;;;;;;;;;;;;;;AAsCO,IAAM,eAAN,MAAmB;AAAA,EAAnB,WAAA,GAAA;AACL,IAAA,IAAA,CAAQ,SAAsB,EAAC;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQ/B,QAAA,GAAiB;AACf,IAAA,MAAM,GAAA,GAAM,QAAQ,GAAA,EAAI;AACxB,IAAA,MAAM,WAAA,GAAc;AAAA,MAClB,iBAAA;AAAA,MACA,mBAAA;AAAA,MACA,mBAAA;AAAA,MACA;AAAA,KACF;AAEA,IAAA,IAAI,MAAA,GAAS,KAAA;AACb,IAAA,KAAA,MAAW,YAAY,WAAA,EAAa;AAClC,MAAA,MAAM,QAAA,GAAWA,qBAAA,CAAK,IAAA,CAAK,GAAA,EAAK,QAAQ,CAAA;AACxC,MAAA,IAAI,CAACC,aAAA,CAAW,QAAQ,CAAA,EAAG;AAE3B,MAAA,MAAM,SAAA,GAAYD,qBAAA,CAAK,OAAA,CAAQ,QAAQ,CAAA;AACvC,MAAA,MAAM,GAAA,GAAME,eAAA,CAAa,QAAA,EAAU,MAAM,CAAA;AAEzC,MAAA,IAAI;AACF,QAAA,IAAI,MAAA;AACJ,QAAA,QAAQ,SAAA;AAAW,UACjB,KAAK,KAAA;AAAA,UACL,KAAK,KAAA;AACH,YAAA,MAAM,GAAA,GAAM,UAAQ,QAAQ,CAAA;AAC5B,YAAA,MAAA,GAAS,IAAI,OAAA,IAAW,GAAA;AACxB,YAAA;AAAA,UACF,KAAK,OAAA;AACH,YAAA,MAAA,GAAS,IAAA,CAAK,MAAM,GAAG,CAAA;AACvB,YAAA;AAAA,UACF,KAAK,OAAA;AAAA,UACL,KAAK,MAAA;AACH,YAAA,MAAA,GAAS,SAAA,CAAQ,SAAS,CAAA,CAAE,IAAA,CAAK,GAAG,CAAA;AACpC,YAAA;AAAA,UACF;AACE,YAAA,MAAM,IAAI,KAAA,CAAM,CAAA,+BAAA,EAAkC,SAAS,CAAA,CAAE,CAAA;AAAA;AAGjE,QAAA,IAAA,CAAK,SAAS,EAAE,GAAG,IAAA,CAAK,MAAA,EAAQ,GAAG,MAAA,EAAO;AAC1C,QAAA,MAAA,GAAS,IAAA;AACT,QAAA;AAAA,MACF,SAAS,KAAA,EAAoB;AAC3B,QAAA,MAAM,IAAI,KAAA,CAAM,CAAA,2BAAA,EAA8B,QAAQ;AAAA,EAAK,KAAA,CAAM,OAAO,CAAA,CAAE,CAAA;AAAA,MAC5E;AAAA,IACF;AAEA,IAAA,IAAI,CAAC,MAAA,EAAQ;AACX,MAAA,MAAM,IAAI,MAAM,qDAAqD,CAAA;AAAA,IACvE;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAA,GAAsB;AACpB,IAAA,OAAO,IAAA,CAAK,MAAA;AAAA,EACd;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,IAAiC,GAAA,EAAwB;AACvD,IAAA,OAAO,IAAA,CAAK,OAAO,GAAG,CAAA;AAAA,EACxB;AACF","file":"config.cjs","sourcesContent":["import { existsSync, readFileSync } from \"node:fs\";\nimport path from \"node:path\";\n\n/**\n * Config Files Extensions Supported\n * ex: azura.config.*extension\n */\n\ntype SupportedConfigFile = \".js\" | \".ts\" | \".json\" | \".yaml\" | \".yml\";\n\nexport type ConfigTypes = {\n  environment?: \"development\" | \"production\";\n  debug?: boolean;\n  server?: {\n    port?: number;\n    cluster?: boolean;\n    ipHost?: boolean;\n    https?: boolean;\n  };\n  plugins?: {\n    rateLimit?: {\n      enabled: boolean;\n      limit: number;\n      timeframe: number;\n    };\n    cors?: {\n      enabled: boolean;\n      origins: string | string[];\n      methods: string | string[];\n      allowedHeaders: string | string[];\n    };\n  };\n  logging?: {\n    enabled?: boolean;\n    showDetails?: boolean;\n  };\n};\n\nexport class ConfigModule {\n  private config: ConfigTypes = {};\n\n  /**\n   * Load config files first (azura.config.*)\n   * Recivied error if config file not found or invalid format\n   * @param configFiles\n   */\n\n  initSync(): void {\n    const cdw = process.cwd();\n    const configFiles = [\n      \"azura.config.ts\",\n      \"azura.config.json\",\n      \"azura.config.yaml\",\n      \"azura.config.yml\",\n    ];\n\n    let loaded = false;\n    for (const fileName of configFiles) {\n      const filePath = path.join(cdw, fileName);\n      if (!existsSync(filePath)) continue;\n\n      const extension = path.extname(fileName) as SupportedConfigFile;\n      const raw = readFileSync(filePath, \"utf8\");\n\n      try {\n        let parsed: ConfigTypes;\n        switch (extension) {\n          case \".ts\":\n          case \".js\":\n            const mod = require(filePath);\n            parsed = mod.default || mod;\n            break;\n          case \".json\":\n            parsed = JSON.parse(raw);\n            break;\n          case \".yaml\":\n          case \".yml\":\n            parsed = require(\"js-yaml\").load(raw);\n            break;\n          default:\n            throw new Error(`Invalid config file extension: ${extension}`);\n        }\n\n        this.config = { ...this.config, ...parsed };\n        loaded = true;\n        break;\n      } catch (error: Error | any) {\n        throw new Error(`Error loading config file: ${filePath}\\n${error.message}`);\n      }\n    }\n\n    if (!loaded) {\n      throw new Error(\"Nothing config file found in the current directory.\");\n    }\n  }\n\n  /**\n   * Get all configs from loaded config file\n   * @returns ConfigTypes\n   */\n\n  getAll(): ConfigTypes {\n    return this.config;\n  }\n\n  /**\n   * Return a specific config from loaded config file\n   *\n   * @template T\n   * @param {T} key - key of the config to retrieve\n   * @returns {ConfigTypes[T]}\n   */\n\n  get<T extends keyof ConfigTypes>(key: T): ConfigTypes[T] {\n    return this.config[key];\n  }\n}\n"]}
+{"version":3,"sources":["../src/shared/config/ConfigModule.ts"],"names":["path","existsSync","readFileSync"],"mappings":";;;;;;;;;;;;;;;AAoDO,IAAM,eAAN,MAAmB;AAAA,EAAnB,WAAA,GAAA;AACL,IAAA,IAAA,CAAQ,SAAsB,EAAC;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQ/B,QAAA,GAAiB;AACf,IAAA,MAAM,GAAA,GAAM,QAAQ,GAAA,EAAI;AACxB,IAAA,MAAM,WAAA,GAAc;AAAA,MAClB,iBAAA;AAAA,MACA,mBAAA;AAAA,MACA,mBAAA;AAAA,MACA;AAAA,KACF;AAEA,IAAA,IAAI,MAAA,GAAS,KAAA;AACb,IAAA,KAAA,MAAW,YAAY,WAAA,EAAa;AAClC,MAAA,MAAM,QAAA,GAAWA,qBAAA,CAAK,IAAA,CAAK,GAAA,EAAK,QAAQ,CAAA;AACxC,MAAA,IAAI,CAACC,aAAA,CAAW,QAAQ,CAAA,EAAG;AAE3B,MAAA,MAAM,SAAA,GAAYD,qBAAA,CAAK,OAAA,CAAQ,QAAQ,CAAA;AACvC,MAAA,MAAM,GAAA,GAAME,eAAA,CAAa,QAAA,EAAU,MAAM,CAAA;AAEzC,MAAA,IAAI;AACF,QAAA,IAAI,MAAA;AACJ,QAAA,QAAQ,SAAA;AAAW,UACjB,KAAK,KAAA;AAAA,UACL,KAAK,KAAA;AACH,YAAA,MAAM,GAAA,GAAM,UAAQ,QAAQ,CAAA;AAC5B,YAAA,MAAA,GAAS,IAAI,OAAA,IAAW,GAAA;AACxB,YAAA;AAAA,UACF,KAAK,OAAA;AACH,YAAA,MAAA,GAAS,IAAA,CAAK,MAAM,GAAG,CAAA;AACvB,YAAA;AAAA,UACF,KAAK,OAAA;AAAA,UACL,KAAK,MAAA;AACH,YAAA,MAAA,GAAS,SAAA,CAAQ,SAAS,CAAA,CAAE,IAAA,CAAK,GAAG,CAAA;AACpC,YAAA;AAAA,UACF;AACE,YAAA,MAAM,IAAI,KAAA,CAAM,CAAA,+BAAA,EAAkC,SAAS,CAAA,CAAE,CAAA;AAAA;AAGjE,QAAA,IAAA,CAAK,SAAS,EAAE,GAAG,IAAA,CAAK,MAAA,EAAQ,GAAG,MAAA,EAAO;AAC1C,QAAA,MAAA,GAAS,IAAA;AACT,QAAA;AAAA,MACF,SAAS,KAAA,EAAoB;AAC3B,QAAA,MAAM,IAAI,KAAA,CAAM,CAAA,2BAAA,EAA8B,QAAQ;AAAA,EAAK,KAAA,CAAM,OAAO,CAAA,CAAE,CAAA;AAAA,MAC5E;AAAA,IACF;AAEA,IAAA,IAAI,CAAC,MAAA,EAAQ;AACX,MAAA,MAAM,IAAI,MAAM,qDAAqD,CAAA;AAAA,IACvE;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAA,GAAsB;AACpB,IAAA,OAAO,IAAA,CAAK,MAAA;AAAA,EACd;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,IAAiC,GAAA,EAAwB;AACvD,IAAA,OAAO,IAAA,CAAK,OAAO,GAAG,CAAA;AAAA,EACxB;AACF","file":"config.cjs","sourcesContent":["import { existsSync, readFileSync } from \"node:fs\";\nimport path from \"node:path\";\n\n/**\n * Config Files Extensions Supported\n * ex: azura.config.*extension\n */\n\ntype SupportedConfigFile = \".js\" | \".ts\" | \".json\" | \".yaml\" | \".yml\";\n\nexport type ConfigTypes = {\n  environment?: \"development\" | \"production\";\n  debug?: boolean;\n  server?: {\n    port?: number;\n    cluster?: boolean;\n    ipHost?: boolean;\n    https?: boolean;\n    /**\n     * Configure trust proxy behavior for IP resolution\n     * - true: trust all proxies\n     * - false: don't trust any proxies (default)\n     * - number: trust the nth hop from the front-facing proxy\n     * - string: trust specific IP address or CIDR range\n     * - string[]: trust multiple IPs or CIDR ranges\n     */\n    trustProxy?: boolean | number | string | string[];\n    /**\n     * Custom header name to read IP from\n     * @default 'x-forwarded-for'\n     */\n    ipHeader?: string;\n  };\n  plugins?: {\n    rateLimit?: {\n      enabled: boolean;\n      limit: number;\n      timeframe: number;\n    };\n    cors?: {\n      enabled: boolean;\n      origins: string | string[];\n      methods: string | string[];\n      allowedHeaders: string | string[];\n    };\n  };\n  logging?: {\n    enabled?: boolean;\n    showDetails?: boolean;\n  };\n};\n\nexport class ConfigModule {\n  private config: ConfigTypes = {};\n\n  /**\n   * Load config files first (azura.config.*)\n   * Recivied error if config file not found or invalid format\n   * @param configFiles\n   */\n\n  initSync(): void {\n    const cdw = process.cwd();\n    const configFiles = [\n      \"azura.config.ts\",\n      \"azura.config.json\",\n      \"azura.config.yaml\",\n      \"azura.config.yml\",\n    ];\n\n    let loaded = false;\n    for (const fileName of configFiles) {\n      const filePath = path.join(cdw, fileName);\n      if (!existsSync(filePath)) continue;\n\n      const extension = path.extname(fileName) as SupportedConfigFile;\n      const raw = readFileSync(filePath, \"utf8\");\n\n      try {\n        let parsed: ConfigTypes;\n        switch (extension) {\n          case \".ts\":\n          case \".js\":\n            const mod = require(filePath);\n            parsed = mod.default || mod;\n            break;\n          case \".json\":\n            parsed = JSON.parse(raw);\n            break;\n          case \".yaml\":\n          case \".yml\":\n            parsed = require(\"js-yaml\").load(raw);\n            break;\n          default:\n            throw new Error(`Invalid config file extension: ${extension}`);\n        }\n\n        this.config = { ...this.config, ...parsed };\n        loaded = true;\n        break;\n      } catch (error: Error | any) {\n        throw new Error(`Error loading config file: ${filePath}\\n${error.message}`);\n      }\n    }\n\n    if (!loaded) {\n      throw new Error(\"Nothing config file found in the current directory.\");\n    }\n  }\n\n  /**\n   * Get all configs from loaded config file\n   * @returns ConfigTypes\n   */\n\n  getAll(): ConfigTypes {\n    return this.config;\n  }\n\n  /**\n   * Return a specific config from loaded config file\n   *\n   * @template T\n   * @param {T} key - key of the config to retrieve\n   * @returns {ConfigTypes[T]}\n   */\n\n  get<T extends keyof ConfigTypes>(key: T): ConfigTypes[T] {\n    return this.config[key];\n  }\n}\n"]}

package/dist/config.d.cts

@@ -6,6 +6,20 @@ type ConfigTypes = {
         cluster?: boolean;
         ipHost?: boolean;
         https?: boolean;
+        /**
+         * Configure trust proxy behavior for IP resolution
+         * - true: trust all proxies
+         * - false: don't trust any proxies (default)
+         * - number: trust the nth hop from the front-facing proxy
+         * - string: trust specific IP address or CIDR range
+         * - string[]: trust multiple IPs or CIDR ranges
+         */
+        trustProxy?: boolean | number | string | string[];
+        /**
+         * Custom header name to read IP from
+         * @default 'x-forwarded-for'
+         */
+        ipHeader?: string;
     };
     plugins?: {
         rateLimit?: {

package/dist/config.d.ts

@@ -6,6 +6,20 @@ type ConfigTypes = {
         cluster?: boolean;
         ipHost?: boolean;
         https?: boolean;
+        /**
+         * Configure trust proxy behavior for IP resolution
+         * - true: trust all proxies
+         * - false: don't trust any proxies (default)
+         * - number: trust the nth hop from the front-facing proxy
+         * - string: trust specific IP address or CIDR range
+         * - string[]: trust multiple IPs or CIDR ranges
+         */
+        trustProxy?: boolean | number | string | string[];
+        /**
+         * Custom header name to read IP from
+         * @default 'x-forwarded-for'
+         */
+        ipHeader?: string;
     };
     plugins?: {
         rateLimit?: {

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/shared/config/ConfigModule.ts"],"names":[],"mappings":";;;;;;;;;AAsCO,IAAM,eAAN,MAAmB;AAAA,EAAnB,WAAA,GAAA;AACL,IAAA,IAAA,CAAQ,SAAsB,EAAC;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQ/B,QAAA,GAAiB;AACf,IAAA,MAAM,GAAA,GAAM,QAAQ,GAAA,EAAI;AACxB,IAAA,MAAM,WAAA,GAAc;AAAA,MAClB,iBAAA;AAAA,MACA,mBAAA;AAAA,MACA,mBAAA;AAAA,MACA;AAAA,KACF;AAEA,IAAA,IAAI,MAAA,GAAS,KAAA;AACb,IAAA,KAAA,MAAW,YAAY,WAAA,EAAa;AAClC,MAAA,MAAM,QAAA,GAAW,IAAA,CAAK,IAAA,CAAK,GAAA,EAAK,QAAQ,CAAA;AACxC,MAAA,IAAI,CAAC,UAAA,CAAW,QAAQ,CAAA,EAAG;AAE3B,MAAA,MAAM,SAAA,GAAY,IAAA,CAAK,OAAA,CAAQ,QAAQ,CAAA;AACvC,MAAA,MAAM,GAAA,GAAM,YAAA,CAAa,QAAA,EAAU,MAAM,CAAA;AAEzC,MAAA,IAAI;AACF,QAAA,IAAI,MAAA;AACJ,QAAA,QAAQ,SAAA;AAAW,UACjB,KAAK,KAAA;AAAA,UACL,KAAK,KAAA;AACH,YAAA,MAAM,GAAA,GAAM,UAAQ,QAAQ,CAAA;AAC5B,YAAA,MAAA,GAAS,IAAI,OAAA,IAAW,GAAA;AACxB,YAAA;AAAA,UACF,KAAK,OAAA;AACH,YAAA,MAAA,GAAS,IAAA,CAAK,MAAM,GAAG,CAAA;AACvB,YAAA;AAAA,UACF,KAAK,OAAA;AAAA,UACL,KAAK,MAAA;AACH,YAAA,MAAA,GAAS,SAAA,CAAQ,SAAS,CAAA,CAAE,IAAA,CAAK,GAAG,CAAA;AACpC,YAAA;AAAA,UACF;AACE,YAAA,MAAM,IAAI,KAAA,CAAM,CAAA,+BAAA,EAAkC,SAAS,CAAA,CAAE,CAAA;AAAA;AAGjE,QAAA,IAAA,CAAK,SAAS,EAAE,GAAG,IAAA,CAAK,MAAA,EAAQ,GAAG,MAAA,EAAO;AAC1C,QAAA,MAAA,GAAS,IAAA;AACT,QAAA;AAAA,MACF,SAAS,KAAA,EAAoB;AAC3B,QAAA,MAAM,IAAI,KAAA,CAAM,CAAA,2BAAA,EAA8B,QAAQ;AAAA,EAAK,KAAA,CAAM,OAAO,CAAA,CAAE,CAAA;AAAA,MAC5E;AAAA,IACF;AAEA,IAAA,IAAI,CAAC,MAAA,EAAQ;AACX,MAAA,MAAM,IAAI,MAAM,qDAAqD,CAAA;AAAA,IACvE;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAA,GAAsB;AACpB,IAAA,OAAO,IAAA,CAAK,MAAA;AAAA,EACd;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,IAAiC,GAAA,EAAwB;AACvD,IAAA,OAAO,IAAA,CAAK,OAAO,GAAG,CAAA;AAAA,EACxB;AACF","file":"config.js","sourcesContent":["import { existsSync, readFileSync } from \"node:fs\";\nimport path from \"node:path\";\n\n/**\n * Config Files Extensions Supported\n * ex: azura.config.*extension\n */\n\ntype SupportedConfigFile = \".js\" | \".ts\" | \".json\" | \".yaml\" | \".yml\";\n\nexport type ConfigTypes = {\n  environment?: \"development\" | \"production\";\n  debug?: boolean;\n  server?: {\n    port?: number;\n    cluster?: boolean;\n    ipHost?: boolean;\n    https?: boolean;\n  };\n  plugins?: {\n    rateLimit?: {\n      enabled: boolean;\n      limit: number;\n      timeframe: number;\n    };\n    cors?: {\n      enabled: boolean;\n      origins: string | string[];\n      methods: string | string[];\n      allowedHeaders: string | string[];\n    };\n  };\n  logging?: {\n    enabled?: boolean;\n    showDetails?: boolean;\n  };\n};\n\nexport class ConfigModule {\n  private config: ConfigTypes = {};\n\n  /**\n   * Load config files first (azura.config.*)\n   * Recivied error if config file not found or invalid format\n   * @param configFiles\n   */\n\n  initSync(): void {\n    const cdw = process.cwd();\n    const configFiles = [\n      \"azura.config.ts\",\n      \"azura.config.json\",\n      \"azura.config.yaml\",\n      \"azura.config.yml\",\n    ];\n\n    let loaded = false;\n    for (const fileName of configFiles) {\n      const filePath = path.join(cdw, fileName);\n      if (!existsSync(filePath)) continue;\n\n      const extension = path.extname(fileName) as SupportedConfigFile;\n      const raw = readFileSync(filePath, \"utf8\");\n\n      try {\n        let parsed: ConfigTypes;\n        switch (extension) {\n          case \".ts\":\n          case \".js\":\n            const mod = require(filePath);\n            parsed = mod.default || mod;\n            break;\n          case \".json\":\n            parsed = JSON.parse(raw);\n            break;\n          case \".yaml\":\n          case \".yml\":\n            parsed = require(\"js-yaml\").load(raw);\n            break;\n          default:\n            throw new Error(`Invalid config file extension: ${extension}`);\n        }\n\n        this.config = { ...this.config, ...parsed };\n        loaded = true;\n        break;\n      } catch (error: Error | any) {\n        throw new Error(`Error loading config file: ${filePath}\\n${error.message}`);\n      }\n    }\n\n    if (!loaded) {\n      throw new Error(\"Nothing config file found in the current directory.\");\n    }\n  }\n\n  /**\n   * Get all configs from loaded config file\n   * @returns ConfigTypes\n   */\n\n  getAll(): ConfigTypes {\n    return this.config;\n  }\n\n  /**\n   * Return a specific config from loaded config file\n   *\n   * @template T\n   * @param {T} key - key of the config to retrieve\n   * @returns {ConfigTypes[T]}\n   */\n\n  get<T extends keyof ConfigTypes>(key: T): ConfigTypes[T] {\n    return this.config[key];\n  }\n}\n"]}
+{"version":3,"sources":["../src/shared/config/ConfigModule.ts"],"names":[],"mappings":";;;;;;;;;AAoDO,IAAM,eAAN,MAAmB;AAAA,EAAnB,WAAA,GAAA;AACL,IAAA,IAAA,CAAQ,SAAsB,EAAC;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQ/B,QAAA,GAAiB;AACf,IAAA,MAAM,GAAA,GAAM,QAAQ,GAAA,EAAI;AACxB,IAAA,MAAM,WAAA,GAAc;AAAA,MAClB,iBAAA;AAAA,MACA,mBAAA;AAAA,MACA,mBAAA;AAAA,MACA;AAAA,KACF;AAEA,IAAA,IAAI,MAAA,GAAS,KAAA;AACb,IAAA,KAAA,MAAW,YAAY,WAAA,EAAa;AAClC,MAAA,MAAM,QAAA,GAAW,IAAA,CAAK,IAAA,CAAK,GAAA,EAAK,QAAQ,CAAA;AACxC,MAAA,IAAI,CAAC,UAAA,CAAW,QAAQ,CAAA,EAAG;AAE3B,MAAA,MAAM,SAAA,GAAY,IAAA,CAAK,OAAA,CAAQ,QAAQ,CAAA;AACvC,MAAA,MAAM,GAAA,GAAM,YAAA,CAAa,QAAA,EAAU,MAAM,CAAA;AAEzC,MAAA,IAAI;AACF,QAAA,IAAI,MAAA;AACJ,QAAA,QAAQ,SAAA;AAAW,UACjB,KAAK,KAAA;AAAA,UACL,KAAK,KAAA;AACH,YAAA,MAAM,GAAA,GAAM,UAAQ,QAAQ,CAAA;AAC5B,YAAA,MAAA,GAAS,IAAI,OAAA,IAAW,GAAA;AACxB,YAAA;AAAA,UACF,KAAK,OAAA;AACH,YAAA,MAAA,GAAS,IAAA,CAAK,MAAM,GAAG,CAAA;AACvB,YAAA;AAAA,UACF,KAAK,OAAA;AAAA,UACL,KAAK,MAAA;AACH,YAAA,MAAA,GAAS,SAAA,CAAQ,SAAS,CAAA,CAAE,IAAA,CAAK,GAAG,CAAA;AACpC,YAAA;AAAA,UACF;AACE,YAAA,MAAM,IAAI,KAAA,CAAM,CAAA,+BAAA,EAAkC,SAAS,CAAA,CAAE,CAAA;AAAA;AAGjE,QAAA,IAAA,CAAK,SAAS,EAAE,GAAG,IAAA,CAAK,MAAA,EAAQ,GAAG,MAAA,EAAO;AAC1C,QAAA,MAAA,GAAS,IAAA;AACT,QAAA;AAAA,MACF,SAAS,KAAA,EAAoB;AAC3B,QAAA,MAAM,IAAI,KAAA,CAAM,CAAA,2BAAA,EAA8B,QAAQ;AAAA,EAAK,KAAA,CAAM,OAAO,CAAA,CAAE,CAAA;AAAA,MAC5E;AAAA,IACF;AAEA,IAAA,IAAI,CAAC,MAAA,EAAQ;AACX,MAAA,MAAM,IAAI,MAAM,qDAAqD,CAAA;AAAA,IACvE;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAA,GAAsB;AACpB,IAAA,OAAO,IAAA,CAAK,MAAA;AAAA,EACd;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,IAAiC,GAAA,EAAwB;AACvD,IAAA,OAAO,IAAA,CAAK,OAAO,GAAG,CAAA;AAAA,EACxB;AACF","file":"config.js","sourcesContent":["import { existsSync, readFileSync } from \"node:fs\";\nimport path from \"node:path\";\n\n/**\n * Config Files Extensions Supported\n * ex: azura.config.*extension\n */\n\ntype SupportedConfigFile = \".js\" | \".ts\" | \".json\" | \".yaml\" | \".yml\";\n\nexport type ConfigTypes = {\n  environment?: \"development\" | \"production\";\n  debug?: boolean;\n  server?: {\n    port?: number;\n    cluster?: boolean;\n    ipHost?: boolean;\n    https?: boolean;\n    /**\n     * Configure trust proxy behavior for IP resolution\n     * - true: trust all proxies\n     * - false: don't trust any proxies (default)\n     * - number: trust the nth hop from the front-facing proxy\n     * - string: trust specific IP address or CIDR range\n     * - string[]: trust multiple IPs or CIDR ranges\n     */\n    trustProxy?: boolean | number | string | string[];\n    /**\n     * Custom header name to read IP from\n     * @default 'x-forwarded-for'\n     */\n    ipHeader?: string;\n  };\n  plugins?: {\n    rateLimit?: {\n      enabled: boolean;\n      limit: number;\n      timeframe: number;\n    };\n    cors?: {\n      enabled: boolean;\n      origins: string | string[];\n      methods: string | string[];\n      allowedHeaders: string | string[];\n    };\n  };\n  logging?: {\n    enabled?: boolean;\n    showDetails?: boolean;\n  };\n};\n\nexport class ConfigModule {\n  private config: ConfigTypes = {};\n\n  /**\n   * Load config files first (azura.config.*)\n   * Recivied error if config file not found or invalid format\n   * @param configFiles\n   */\n\n  initSync(): void {\n    const cdw = process.cwd();\n    const configFiles = [\n      \"azura.config.ts\",\n      \"azura.config.json\",\n      \"azura.config.yaml\",\n      \"azura.config.yml\",\n    ];\n\n    let loaded = false;\n    for (const fileName of configFiles) {\n      const filePath = path.join(cdw, fileName);\n      if (!existsSync(filePath)) continue;\n\n      const extension = path.extname(fileName) as SupportedConfigFile;\n      const raw = readFileSync(filePath, \"utf8\");\n\n      try {\n        let parsed: ConfigTypes;\n        switch (extension) {\n          case \".ts\":\n          case \".js\":\n            const mod = require(filePath);\n            parsed = mod.default || mod;\n            break;\n          case \".json\":\n            parsed = JSON.parse(raw);\n            break;\n          case \".yaml\":\n          case \".yml\":\n            parsed = require(\"js-yaml\").load(raw);\n            break;\n          default:\n            throw new Error(`Invalid config file extension: ${extension}`);\n        }\n\n        this.config = { ...this.config, ...parsed };\n        loaded = true;\n        break;\n      } catch (error: Error | any) {\n        throw new Error(`Error loading config file: ${filePath}\\n${error.message}`);\n      }\n    }\n\n    if (!loaded) {\n      throw new Error(\"Nothing config file found in the current directory.\");\n    }\n  }\n\n  /**\n   * Get all configs from loaded config file\n   * @returns ConfigTypes\n   */\n\n  getAll(): ConfigTypes {\n    return this.config;\n  }\n\n  /**\n   * Return a specific config from loaded config file\n   *\n   * @template T\n   * @param {T} key - key of the config to retrieve\n   * @returns {ConfigTypes[T]}\n   */\n\n  get<T extends keyof ConfigTypes>(key: T): ConfigTypes[T] {\n    return this.config[key];\n  }\n}\n"]}