@catbee/utils 0.0.6 → 0.0.7

package/build/esm/config.d.ts

@@ -1,4 +1,4 @@
-import { LoggerLevels } from './utils/logger.utils';
+import { Logger, LoggerLevels } from './utils/logger.utils';
 /**
  * Extends Express Request interface to add request ID tracking.
  * Added by requestId middleware during request processing.
@@ -8,6 +8,10 @@ declare global {
         interface Request {
             /** Unique request identifier (set by middleware) */
             id?: string;
+            /** Logger instance for the request (set by middleware) */
+            logger?: Logger;
+            /** User information (set by authentication middleware) */
+            user?: any;
         }
     }
 }
@@ -34,12 +38,6 @@ export declare let config: {
          */
         singleLine: boolean;
     };
-    http: {
-        /**
-         * Timeout for HTTP requests in milliseconds
-         */
-        timeout: number;
-    };
     cache: {
         /**
          * Default TTL (time to live) for cache entries in seconds
@@ -100,12 +98,6 @@ export declare const defaultServerConfig: {
         exposeHeader: true;
         generator: () => string;
     };
-    logger: {
-        name: string;
-        level: LoggerLevels;
-        prettyPrint: false;
-        singleLine: false;
-    };
     metrics: {
         enable: false;
         path: string;

package/build/esm/config.js

@@ -47,12 +47,6 @@ export var config = {
          */
         singleLine: Env.getBoolean('LOGGER_PRETTY_SINGLE_LINE', false)
     },
-    http: {
-        /**
-         * Timeout for HTTP requests in milliseconds
-         */
-        timeout: Env.getNumber('HTTP_TIMEOUT', 30000)
-    },
     cache: {
         /**
          * Default TTL (time to live) for cache entries in seconds
@@ -111,12 +105,6 @@ export var defaultServerConfig = {
         exposeHeader: true,
         generator: function () { return uuid(); }
     },
-    logger: {
-        name: 'express_app',
-        level: 'info',
-        prettyPrint: false,
-        singleLine: false
-    },
     metrics: {
         enable: false,
         path: '/metrics',

package/build/esm/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * The MIT License\n *\n * Copyright (c) 2025 Catbee Technologies\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { ServerConfig } from './types/server';\nimport { Env } from './utils/env.utils';\nimport { uuid } from './utils/id.utils';\nimport { LoggerLevels } from './utils/logger.utils';\nimport { deepObjMerge } from './utils/obj.utils';\n\n/**\n * Extends Express Request interface to add request ID tracking.\n * Added by requestId middleware during request processing.\n */\ndeclare global {\n  namespace Express {\n    interface Request {\n      /** Unique request identifier (set by middleware) */\n      id?: string;\n    }\n  }\n}\n\n/**\n * Application runtime configuration loaded from environment variables.\n */\nexport let config = {\n  logger: {\n    /**\n     * Logging level (e.g., 'info', 'debug', 'warn', 'error').\n     */\n    level: Env.get('LOGGER_LEVEL', 'info') as LoggerLevels,\n\n    /**\n     * Name of the logger instance (defaults to npm package name).\n     */\n    name: Env.get('LOGGER_NAME', Env.get('npm_package_name', '@catbee/utils')),\n\n    /**\n     * Enables pretty-print logging in development.\n     * Has no effect in production.\n     */\n    pretty: Env.getBoolean('LOGGER_PRETTY', true),\n    /**\n     * Single line output for pretty-print (default: false)\n     */\n    singleLine: Env.getBoolean('LOGGER_PRETTY_SINGLE_LINE', false)\n  },\n\n  http: {\n    /**\n     * Timeout for HTTP requests in milliseconds\n     */\n    timeout: Env.getNumber('HTTP_TIMEOUT', 30000)\n  },\n\n  cache: {\n    /**\n     * Default TTL (time to live) for cache entries in seconds\n     */\n    defaultTtl: Env.getNumber('CACHE_DEFAULT_TTL_SECONDS', 3600) * 1000\n  }\n};\n\nexport const defaultServerConfig = {\n  port: 3000,\n  host: '0.0.0.0',\n  cors: false,\n  helmet: false,\n  compression: false,\n  bodyParser: {\n    json: { limit: '1mb' },\n    urlencoded: { extended: true, limit: '1mb' }\n  },\n  cookieParser: false,\n  isMicroservice: false,\n  appName: 'express_app',\n  globalHeaders: {},\n  rateLimit: {\n    enable: false,\n    windowMs: 15 * 60 * 1000,\n    max: 100,\n    message: 'Too many requests',\n    standardHeaders: true,\n    legacyHeaders: false\n  },\n  requestLogging: {\n    enable: Env.isDev(),\n    ignorePaths: (req, _res) => {\n      const skipPaths = ['/healthz', '/favicon.ico', '/metrics', '/docs', '/.well-known'];\n      return skipPaths.some(path => req.path.startsWith(path));\n    },\n    skipNotFoundRoutes: false\n  },\n  openApi: {\n    enable: false,\n    mountPath: '/docs',\n    verbose: false,\n    withGlobalPrefix: false\n  },\n  healthCheck: {\n    path: '/healthz',\n    detailed: true\n  },\n  requestTimeout: 30000,\n  responseTime: {\n    enable: false,\n    addHeader: true,\n    logOnComplete: false\n  },\n  requestId: {\n    headerName: 'x-request-id',\n    exposeHeader: true,\n    generator: () => uuid()\n  },\n  logger: {\n    name: 'express_app',\n    level: 'info' as LoggerLevels,\n    prettyPrint: false,\n    singleLine: false\n  },\n  metrics: {\n    enable: false,\n    path: '/metrics',\n    withGlobalPrefix: false\n  },\n  serviceVersion: {\n    enable: false,\n    headerName: 'x-service-version',\n    version: '0.0.0'\n  }\n} satisfies ServerConfig;\n\n/**\n * Update the @catbee/utils configuration.\n * @param value Partial configuration object.\n */\nexport function setConfig(value: Partial<typeof config>): void {\n  deepObjMerge(config, value);\n}\n\n/**\n * Get the current @catbee/utils configuration.\n * @returns The current configuration object.\n */\nexport function getConfig(): typeof config {\n  return config;\n}\n"]}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAExC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAmBjD;;GAEG;AACH,MAAM,CAAC,IAAI,MAAM,GAAG;IAClB,MAAM,EAAE;QACN;;WAEG;QACH,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC,cAAc,EAAE,MAAM,CAAiB;QAEtD;;WAEG;QACH,IAAI,EAAE,GAAG,CAAC,GAAG,CAAC,aAAa,EAAE,GAAG,CAAC,GAAG,CAAC,kBAAkB,EAAE,eAAe,CAAC,CAAC;QAE1E;;;WAGG;QACH,MAAM,EAAE,GAAG,CAAC,UAAU,CAAC,eAAe,EAAE,IAAI,CAAC;QAC7C;;WAEG;QACH,UAAU,EAAE,GAAG,CAAC,UAAU,CAAC,2BAA2B,EAAE,KAAK,CAAC;KAC/D;IAED,KAAK,EAAE;QACL;;WAEG;QACH,UAAU,EAAE,GAAG,CAAC,SAAS,CAAC,2BAA2B,EAAE,IAAI,CAAC,GAAG,IAAI;KACpE;CACF,CAAC;AAEF,MAAM,CAAC,IAAM,mBAAmB,GAAG;IACjC,IAAI,EAAE,IAAI;IACV,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,KAAK;IACX,MAAM,EAAE,KAAK;IACb,WAAW,EAAE,KAAK;IAClB,UAAU,EAAE;QACV,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE;QACtB,UAAU,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE;KAC7C;IACD,YAAY,EAAE,KAAK;IACnB,cAAc,EAAE,KAAK;IACrB,OAAO,EAAE,aAAa;IACtB,aAAa,EAAE,EAAE;IACjB,SAAS,EAAE;QACT,MAAM,EAAE,KAAK;QACb,QAAQ,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI;QACxB,GAAG,EAAE,GAAG;QACR,OAAO,EAAE,mBAAmB;QAC5B,eAAe,EAAE,IAAI;QACrB,aAAa,EAAE,KAAK;KACrB;IACD,cAAc,EAAE;QACd,MAAM,EAAE,GAAG,CAAC,KAAK,EAAE;QACnB,WAAW,EAAE,UAAC,GAAG,EAAE,IAAI;YACrB,IAAM,SAAS,GAAG,CAAC,UAAU,EAAE,cAAc,EAAE,UAAU,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC;YACpF,OAAO,SAAS,CAAC,IAAI,CAAC,UAAA,IAAI,IAAI,OAAA,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAzB,CAAyB,CAAC,CAAC;QAC3D,CAAC;QACD,kBAAkB,EAAE,KAAK;KAC1B;IACD,OAAO,EAAE;QACP,MAAM,EAAE,KAAK;QACb,SAAS,EAAE,OAAO;QAClB,OAAO,EAAE,KAAK;QACd,gBAAgB,EAAE,KAAK;KACxB;IACD,WAAW,EAAE;QACX,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE,IAAI;KACf;IACD,cAAc,EAAE,KAAK;IACrB,YAAY,EAAE;QACZ,MAAM,EAAE,KAAK;QACb,SAAS,EAAE,IAAI;QACf,aAAa,EAAE,KAAK;KACrB;IACD,SAAS,EAAE;QACT,UAAU,EAAE,cAAc;QAC1B,YAAY,EAAE,IAAI;QAClB,SAAS,EAAE,cAAM,OAAA,IAAI,EAAE,EAAN,CAAM;KACxB;IACD,OAAO,EAAE;QACP,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,UAAU;QAChB,gBAAgB,EAAE,KAAK;KACxB;IACD,cAAc,EAAE;QACd,MAAM,EAAE,KAAK;QACb,UAAU,EAAE,mBAAmB;QAC/B,OAAO,EAAE,OAAO;KACjB;CACqB,CAAC;AAEzB;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,KAA6B;IACrD,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAC9B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS;IACvB,OAAO,MAAM,CAAC;AAChB,CAAC","sourcesContent":["/*\n * The MIT License\n *\n * Copyright (c) 2025 Catbee Technologies\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { ServerConfig } from './types/server';\nimport { Env } from './utils/env.utils';\nimport { uuid } from './utils/id.utils';\nimport { Logger, LoggerLevels } from './utils/logger.utils';\nimport { deepObjMerge } from './utils/obj.utils';\n\n/**\n * Extends Express Request interface to add request ID tracking.\n * Added by requestId middleware during request processing.\n */\ndeclare global {\n  namespace Express {\n    interface Request {\n      /** Unique request identifier (set by middleware) */\n      id?: string;\n      /** Logger instance for the request (set by middleware) */\n      logger?: Logger;\n      /** User information (set by authentication middleware) */\n      user?: any;\n    }\n  }\n}\n\n/**\n * Application runtime configuration loaded from environment variables.\n */\nexport let config = {\n  logger: {\n    /**\n     * Logging level (e.g., 'info', 'debug', 'warn', 'error').\n     */\n    level: Env.get('LOGGER_LEVEL', 'info') as LoggerLevels,\n\n    /**\n     * Name of the logger instance (defaults to npm package name).\n     */\n    name: Env.get('LOGGER_NAME', Env.get('npm_package_name', '@catbee/utils')),\n\n    /**\n     * Enables pretty-print logging in development.\n     * Has no effect in production.\n     */\n    pretty: Env.getBoolean('LOGGER_PRETTY', true),\n    /**\n     * Single line output for pretty-print (default: false)\n     */\n    singleLine: Env.getBoolean('LOGGER_PRETTY_SINGLE_LINE', false)\n  },\n\n  cache: {\n    /**\n     * Default TTL (time to live) for cache entries in seconds\n     */\n    defaultTtl: Env.getNumber('CACHE_DEFAULT_TTL_SECONDS', 3600) * 1000\n  }\n};\n\nexport const defaultServerConfig = {\n  port: 3000,\n  host: '0.0.0.0',\n  cors: false,\n  helmet: false,\n  compression: false,\n  bodyParser: {\n    json: { limit: '1mb' },\n    urlencoded: { extended: true, limit: '1mb' }\n  },\n  cookieParser: false,\n  isMicroservice: false,\n  appName: 'express_app',\n  globalHeaders: {},\n  rateLimit: {\n    enable: false,\n    windowMs: 15 * 60 * 1000,\n    max: 100,\n    message: 'Too many requests',\n    standardHeaders: true,\n    legacyHeaders: false\n  },\n  requestLogging: {\n    enable: Env.isDev(),\n    ignorePaths: (req, _res) => {\n      const skipPaths = ['/healthz', '/favicon.ico', '/metrics', '/docs', '/.well-known'];\n      return skipPaths.some(path => req.path.startsWith(path));\n    },\n    skipNotFoundRoutes: false\n  },\n  openApi: {\n    enable: false,\n    mountPath: '/docs',\n    verbose: false,\n    withGlobalPrefix: false\n  },\n  healthCheck: {\n    path: '/healthz',\n    detailed: true\n  },\n  requestTimeout: 30000,\n  responseTime: {\n    enable: false,\n    addHeader: true,\n    logOnComplete: false\n  },\n  requestId: {\n    headerName: 'x-request-id',\n    exposeHeader: true,\n    generator: () => uuid()\n  },\n  metrics: {\n    enable: false,\n    path: '/metrics',\n    withGlobalPrefix: false\n  },\n  serviceVersion: {\n    enable: false,\n    headerName: 'x-service-version',\n    version: '0.0.0'\n  }\n} satisfies ServerConfig;\n\n/**\n * Update the @catbee/utils configuration.\n * @param value Partial configuration object.\n */\nexport function setConfig(value: Partial<typeof config>): void {\n  deepObjMerge(config, value);\n}\n\n/**\n * Get the current @catbee/utils configuration.\n * @returns The current configuration object.\n */\nexport function getConfig(): typeof config {\n  return config;\n}\n"]}

package/build/esm/servers/server.builder.d.ts

@@ -408,23 +408,6 @@ export declare class ServerConfigBuilder {
      * ```
      */
     withCookies(opts: ServerConfig['cookieParser']): this;
-    /**
-     * Configures the logger used by the server.
-     *
-     * @param opts - Logger configuration options
-     * @returns The builder instance for chaining
-     * @default { name: 'express_app', level: 'info', prettyPrint: true in dev, singleLine: false }
-     *
-     * @example
-     * ```typescript
-     * builder.withLogger({
-     *   level: 'info',
-     *   prettyPrint: true,
-     *   singleLine: false
-     * })
-     * ```
-     */
-    withLogger(opts: Partial<NonNullable<ServerConfig['logger']>>): this;
     /**
      * Adds a static folder to serve files from.
      *
@@ -518,107 +501,7 @@ export declare class ServerConfigBuilder {
      *   .build();
      * ```
      */
-    build(): Readonly<{
-        [BUILD_MARKER]: boolean;
-        port: number;
-        host?: string;
-        cors?: import("..").ToggleConfig<import("cors").CorsOptions>;
-        helmet?: import("..").ToggleConfig<import("helmet").HelmetOptions>;
-        compression?: import("..").ToggleConfig<import("compression").CompressionOptions>;
-        bodyParser?: {
-            json? /**
-             * Sets the hostname the server will bind to.
-             *
-             * @param host - The hostname (e.g., 'localhost', '0.0.0.0', '127.0.0.1')
-             * @returns The builder instance for chaining
-             * @default '0.0.0.0' (can be overridden via HOST env variable)
-             *
-             * @example
-             * ```typescript
-             * builder.withHost('0.0.0.0') // Listen on all interfaces
-             * ```
-             */: Parameters<typeof import("express").json>[0];
-            urlencoded?: Parameters<typeof import("express").urlencoded>[0];
-        };
-        cookieParser?: import("..").ToggleConfig<import("cookie-parser").CookieParseOptions>;
-        trustProxy?: boolean;
-        staticFolders?: Array<{
-            path?: string;
-            directory: string;
-            maxAge?: string;
-            etag?: boolean;
-            immutable?: boolean;
-            lastModified?: boolean;
-            cacheControl?: boolean;
-        }>;
-        isMicroservice?: boolean;
-        appName?: string;
-        globalHeaders?: Record<string, string | (() => string)>;
-        rateLimit?: {
-            enable: boolean;
-            windowMs?: number;
-            max?: number;
-            message?: string;
-            standardHeaders?: boolean;
-            legacyHeaders?: boolean;
-        };
-        requestLogging?: {
-            enable: boolean;
-            ignorePaths?: string[] | ((req: import("express").Request, res: import("express").Response) => boolean);
-            skipNotFoundRoutes?: boolean;
-        };
-        healthCheck?: {
-            path?: string;
-            checks?: Array<{
-                name: string;
-                check: () => Promise<boolean> | boolean;
-            }>;
-            detailed?: boolean;
-            withGlobalPrefix?: boolean;
-        };
-        requestTimeout?: number;
-        responseTime?: {
-            enable: boolean;
-            addHeader?: boolean;
-            logOnComplete?: boolean;
-        };
-        requestId?: {
-            headerName?: string;
-            exposeHeader?: boolean;
-            generator?: () => string;
-        };
-        globalPrefix?: string;
-        openApi?: {
-            enable: boolean;
-            mountPath?: string;
-            filePath?: string;
-            verbose?: boolean;
-            withGlobalPrefix?: boolean;
-        };
-        logger?: {
-            name?: string;
-            level?: import("..").LoggerLevels;
-            prettyPrint?: boolean;
-            singleLine?: boolean;
-        };
-        metrics?: {
-            enable: boolean;
-            path?: string;
-            withGlobalPrefix?: boolean;
-        };
-        serviceVersion?: {
-            enable: boolean;
-            headerName?: string;
-            version?: string | (() => string);
-        };
-        https?: {
-            key: string;
-            cert: string;
-            ca?: string;
-            passphrase?: string;
-            [key: string]: any;
-        };
-    }>;
+    build(): Readonly<ServerConfig>;
     private mergeConfig;
     private setEnabled;
 }

package/build/esm/servers/server.builder.js

@@ -563,26 +563,6 @@ var ServerConfigBuilder = /** @class */ (function () {
         this.config.cookieParser = opts;
         return this;
     };
-    /**
-     * Configures the logger used by the server.
-     *
-     * @param opts - Logger configuration options
-     * @returns The builder instance for chaining
-     * @default { name: 'express_app', level: 'info', prettyPrint: true in dev, singleLine: false }
-     *
-     * @example
-     * ```typescript
-     * builder.withLogger({
-     *   level: 'info',
-     *   prettyPrint: true,
-     *   singleLine: false
-     * })
-     * ```
-     */
-    ServerConfigBuilder.prototype.withLogger = function (opts) {
-        this.mergeConfig('logger', opts);
-        return this;
-    };
     /**
      * Adds a static folder to serve files from.
      *

package/build/esm/servers/server.builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.builder.js","sourceRoot":"","sources":["../../../src/servers/server.builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAEjD;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,CAAC,IAAM,YAAY,GAAG,MAAM,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;AAEtE;IAAA;QACU,WAAM,GAA0B,EAAE,CAAC;IA4qB7C,CAAC;IA1qBC;;;;;;OAMG;IACK,0CAAY,GAApB,UAAqB,IAAY;QAC/B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,gEAAyD,IAAI,CAAE,CAAC,CAAC;QACnF,CAAC;IACH,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,sCAAQ,GAAR,UAAS,IAAY;QACnB,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QACxB,IAAI,CAAC,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;;;;OAWG;IACH,sCAAQ,GAAR,UAAS,IAAY;QACnB,IAAI,CAAC,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,sCAAQ,GAAR,UAAS,IAA0B;QACjC,IAAI,CAAC,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,wCAAU,GAAV;QACE,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IAED;;;;OAIG;IACH,yCAAW,GAAX;QACE,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,wCAAU,GAAV,UAAW,IAA4B;QACrC,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,0CAAY,GAAZ;QACE,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED;;;;OAIG;IACH,2CAAa,GAAb;QACE,OAAO,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,6CAAe,GAAf,UAAgB,IAAiC;QAC/C,IAAI,CAAC,MAAM,CAAC,WAAW,GAAG,IAAI,CAAC;QAC/B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,+CAAiB,GAAjB;QACE,OAAO,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;IAED;;;;OAIG;IACH,gDAAkB,GAAlB;QACE,OAAO,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,2CAAa,GAAb,UAAc,IAAwC;QACpD,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,IAA8C,CAAC,CAAC;QAC9E,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACH,6CAAe,GAAf,UAAgB,IAA0E;QAA1E,qBAAA,EAAA,SAA0E;QACxF,OAAO,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAClD,CAAC;IAED;;;;OAIG;IACH,8CAAgB,GAAhB;QACE,OAAO,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IAC7C,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,gDAAkB,GAAlB,UAAmB,IAA0D;QAC3E,IAAI,CAAC,WAAW,CAAC,gBAAgB,EAAE,IAAmD,CAAC,CAAC;QACxF,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACH,kDAAoB,GAApB,UAAqB,IAA+E;QAA/E,qBAAA,EAAA,SAA+E;QAClG,OAAO,IAAI,CAAC,UAAU,CAAC,gBAAgB,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IACvD,CAAC;IAED;;;;OAIG;IACH,mDAAqB,GAArB;QACE,OAAO,IAAI,CAAC,UAAU,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAC;IAClD,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,yCAAW,GAAX,UAAY,IAAmD;QAC7D,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,IAA4C,CAAC,CAAC;QAC1E,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACH,2CAAa,GAAb,UAAc,IAAwE;QAAxE,qBAAA,EAAA,SAAwE;QACpF,OAAO,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAChD,CAAC;IAED;;;;OAIG;IACH,4CAAc,GAAd;QACE,OAAO,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAC3C,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,6CAAe,GAAf,UAAgB,IAAuD;QACrE,IAAI,CAAC,WAAW,CAAC,aAAa,EAAE,IAAgD,CAAC,CAAC;QAClF,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,yCAAW,GAAX,UAAY,IAAmD;QAC7D,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,IAA4C,CAAC,CAAC;QAC1E,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;OAMG;IACH,2CAAa,GAAb,UACE,QAAgB,EAChB,IAAqF;QAArF,qBAAA,EAAA,SAAqF;QAErF,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,IAAI,aAAI,QAAQ,UAAA,IAAK,IAAI,EAAG,CAAC;QACxD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,4CAAc,GAAd;QACE,OAAO,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAC3C,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,8CAAgB,GAAhB,UAAiB,IAGhB;QACC,IAAI,CAAC,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC;QAClC,IAAI,CAAC,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAEnC,IAAI,CAAC,WAAW,CAAC,gBAAgB,EAAE,IAAI,CAAC,cAA6D,CAAC,CAAC;QACvG,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,4CAAc,GAAd,UAAe,IAA6C;QAC1D,IAAI,CAAC,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,2CAAa,GAAb,UAAc,IAAqD;QACjE,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,IAA8C,CAAC,CAAC;QAC9E,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,8CAAgB,GAAhB,UAAiB,IAAwD;QACvE,IAAI,CAAC,WAAW,CAAC,cAAc,EAAE,IAAiD,CAAC,CAAC;QACpF,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACH,gDAAkB,GAAlB,UAAmB,IAA6E;QAA7E,qBAAA,EAAA,SAA6E;QAC9F,IAAI,CAAC,UAAU,CAAC,cAAc,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QAC5C,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,iDAAmB,GAAnB;QACE,OAAO,IAAI,CAAC,UAAU,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IAChD,CAAC;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,4CAAc,GAAd,UAAe,IAA6C;;QAC1D,IAAI,CAAC,MAAM,CAAC,UAAU,GAAG,YAAY,CAAC,EAAE,EAAE,MAAA,IAAI,CAAC,MAAM,CAAC,UAAU,mCAAI,EAAE,EAAE,IAAI,CAAC,CAAC;QAC9E,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,yCAAW,GAAX,UAAY,IAAkC;QAC5C,IAAI,CAAC,MAAM,CAAC,YAAY,GAAG,IAAI,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,wCAAU,GAAV,UAAW,IAAkD;QAC3D,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,IAA2C,CAAC,CAAC;QACxE,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,8CAAgB,GAAhB,UAAiB,MAA0D;;QACzE,IAAI,CAAC,MAAM,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;QACnE,IAAM,OAAO,0CAAO,CAAC,MAAA,IAAI,CAAC,MAAM,CAAC,aAAa,mCAAI,EAAE,CAAC,YAAE,MAAM,SAAC,CAAC;QAC/D,IAAI,CAAC,MAAM,CAAC,aAAa,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,UAAA,CAAC,IAAI,OAAA,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,EAAX,CAAW,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QACxF,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,+CAAiB,GAAjB,UAAkB,OAAmD;QACnE,IAAI,CAAC,WAAW,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;QAC3C,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;;;;OAWG;IACH,8CAAgB,GAAhB,UAAiB,MAAc;QAC7B,IAAI,CAAC,MAAM,CAAC,YAAY,GAAG,MAAM,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,wCAAU,GAAV,UAAW,SAAgC;QACzC,IAAI,CAAC,MAAM,GAAG,YAAY,CAAC,EAAE,EAAE,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QACvD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,uCAAS,GAAT,UAAU,IAAwC;QAChD,IAAI,CAAC,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,mCAAK,GAAL;;;QACE,IAAM,MAAM,GAAG,YAAY,CAAC,EAAE,EAAE,mBAAmB,EAAE,IAAI,CAAC,MAAM,CAAiB,CAAC;QAElF,oBAAoB;QACpB,IAAI,CAAA,MAAA,MAAM,CAAC,OAAO,0CAAE,MAAM,KAAI,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;YACvD,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACrE,CAAC;QAED,OAAO,MAAM,CAAC,MAAM,uBACf,MAAM,gBACR,YAAY,IAAG,IAAI,OACpB,CAAC;IACL,CAAC;IAEO,yCAAW,GAAnB,UAAkD,GAAM,EAAE,KAA4C;QACpG,IAAM,OAAO,GACX,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,IAAI;YAC/D,CAAC,CAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAkC;YACpD,CAAC,CAAC,EAAE,CAAC;QACT,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC,EAAE,EAAE,OAAO,EAAE,KAAK,CAAiC,CAAC;IACtF,CAAC;IAEO,wCAAU,GAAlB,UACE,GAAM,EACN,MAAe,EACf,SAAqD;QAArD,0BAAA,EAAA,cAAqD;QAErD,IAAI,CAAC,WAAW,CAAC,GAAG,wBAAO,SAAS,KAAE,MAAM,QAAA,IAAG,CAAC;QAChD,OAAO,IAAI,CAAC;IACd,CAAC;IACH,0BAAC;AAAD,CAAC,AA7qBD,IA6qBC","sourcesContent":["/*\n * The MIT License\n *\n * Copyright (c) 2025 Catbee Technologies\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { deepObjMerge } from '../utils/obj.utils';\nimport { ServerConfig } from '../types/server';\nimport { defaultServerConfig } from '../config';\nimport { isPort } from '../utils/validate.utils';\n\n/**\n * Builder class for creating and configuring an Express server configuration.\n *\n * This class provides a fluent interface to configure all aspects of the Express server\n * including security settings, middleware, routing, and more.\n *\n * @example\n * ```typescript\n * const serverConfig = new ServerConfigBuilder()\n *   .withPort(3000)\n *   .withHost('localhost')\n *   .enableCors()\n *   .enableHelmet()\n *   .build();\n * ```\n */\n\nexport const BUILD_MARKER = Symbol.for('catbee.express.server.build');\n\nexport class ServerConfigBuilder {\n  private config: Partial<ServerConfig> = {};\n\n  /**\n   * Validates that a port number is valid and usable.\n   *\n   * @private\n   * @param port - The port number to validate\n   * @throws {Error} If port is not an integer or is outside the valid range (1-65535)\n   */\n  private validatePort(port: number): void {\n    if (!isPort(port)) {\n      throw new Error(`Port must be a valid number between 1 and 65535, got: ${port}`);\n    }\n  }\n\n  /**\n   * Sets the port the server will listen on.\n   *\n   * @param port - The port number (1-65535)\n   * @returns The builder instance for chaining\n   * @throws {Error} If port is invalid\n   * @default 3000 (can be overridden via PORT env variable)\n   *\n   * @example\n   * ```typescript\n   * builder.withPort(3000)\n   * ```\n   */\n  withPort(port: number): this {\n    this.validatePort(port);\n    this.config.port = port;\n    return this;\n  }\n\n  /**\n   * Sets the hostname the server will bind to.\n   *\n   * @param host - The hostname (e.g., 'localhost', '0.0.0.0', '127.0.0.1')\n   * @returns The builder instance for chaining\n   * @default '0.0.0.0' (can be overridden via HOST env variable)\n   *\n   * @example\n   * ```typescript\n   * builder.withHost('0.0.0.0') // Listen on all interfaces\n   * ```\n   */\n  withHost(host: string): this {\n    this.config.host = host;\n    return this;\n  }\n\n  /**\n   * Configures Cross-Origin Resource Sharing (CORS) for the server.\n   *\n   * @param opts - CORS options object or boolean (true to enable with defaults, false to disable)\n   * @returns The builder instance for chaining\n   * @default false (CORS is disabled by default)\n   *\n   * @example\n   * ```typescript\n   * // Enable CORS with default options\n   * builder.withCors(true)\n   *\n   * // Configure CORS with specific options\n   * builder.withCors({\n   *   origin: ['https://example.com'],\n   *   methods: ['GET', 'POST']\n   * })\n   * ```\n   */\n  withCors(opts: ServerConfig['cors']): this {\n    this.config.cors = opts;\n    return this;\n  }\n\n  /**\n   * Enables CORS with default settings\n   *\n   * @returns The builder instance for chaining\n   */\n  enableCors(): this {\n    return this.withCors(true);\n  }\n\n  /**\n   * Disables CORS\n   *\n   * @returns The builder instance for chaining\n   */\n  disableCors(): this {\n    return this.withCors(false);\n  }\n\n  /**\n   * Configures the Helmet middleware for setting HTTP security headers.\n   *\n   * @param opts - Helmet options object or boolean (true to enable with defaults, false to disable)\n   * @returns The builder instance for chaining\n   * @default false (Helmet is disabled by default)\n   *\n   * @example\n   * ```typescript\n   * // Enable Helmet with default settings\n   * builder.withHelmet(true)\n   *\n   * // Configure Helmet with specific options\n   * builder.withHelmet({\n   *   contentSecurityPolicy: false,\n   *   xssFilter: true\n   * })\n   * ```\n   */\n  withHelmet(opts: ServerConfig['helmet']): this {\n    this.config.helmet = opts;\n    return this;\n  }\n\n  /**\n   * Enables Helmet with default settings\n   *\n   * @returns The builder instance for chaining\n   */\n  enableHelmet(): this {\n    return this.withHelmet(true);\n  }\n\n  /**\n   * Disables Helmet\n   *\n   * @returns The builder instance for chaining\n   */\n  disableHelmet(): this {\n    return this.withHelmet(false);\n  }\n\n  /**\n   * Configures response compression middleware.\n   *\n   * @param opts - Compression options object or boolean (true to enable with defaults, false to disable)\n   * @returns The builder instance for chaining\n   * @default false (Compression is disabled by default)\n   *\n   * @example\n   * ```typescript\n   * // Enable compression with default settings\n   * builder.withCompression(true)\n   *\n   * // Configure compression with specific options\n   * builder.withCompression({\n   *   level: 6,\n   *   threshold: 1024\n   * })\n   * ```\n   */\n  withCompression(opts: ServerConfig['compression']): this {\n    this.config.compression = opts;\n    return this;\n  }\n\n  /**\n   * Enables compression with default settings\n   *\n   * @returns The builder instance for chaining\n   */\n  enableCompression(): this {\n    return this.withCompression(true);\n  }\n\n  /**\n   * Disables compression\n   *\n   * @returns The builder instance for chaining\n   */\n  disableCompression(): this {\n    return this.withCompression(false);\n  }\n\n  /**\n   * Configures rate limiting to protect against brute-force attacks.\n   *\n   * @param opts - Rate limit configuration options\n   * @returns The builder instance for chaining\n   * @default { enable: false, windowMs: 15 * 60 * 1000, max: 100, message: 'Too many requests', standardHeaders: true, legacyHeaders: false }\n   *\n   * @example\n   * ```typescript\n   * builder.withRateLimit({\n   *   enable: true,\n   *   windowMs: 15 * 60 * 1000, // 15 minutes\n   *   max: 100 // limit each IP to 100 requests per windowMs\n   * })\n   * ```\n   */\n  withRateLimit(opts: Partial<ServerConfig['rateLimit']>): this {\n    this.mergeConfig('rateLimit', opts as NonNullable<ServerConfig['rateLimit']>);\n    return this;\n  }\n\n  /**\n   * Enables rate limiting with default or custom settings\n   *\n   * @param opts - Optional rate limit configuration (max requests, window, etc.)\n   * @returns The builder instance for chaining\n   */\n  enableRateLimit(opts: Omit<Partial<NonNullable<ServerConfig['rateLimit']>>, 'enable'> = {}): this {\n    return this.setEnabled('rateLimit', true, opts);\n  }\n\n  /**\n   * Disables rate limiting\n   *\n   * @returns The builder instance for chaining\n   */\n  disableRateLimit(): this {\n    return this.setEnabled('rateLimit', false);\n  }\n\n  /**\n   * Configures HTTP request logging middleware.\n   *\n   * @param opts - Request logging configuration options\n   * @returns The builder instance for chaining\n   * @default { enable: true in dev/false in prod, ignorePaths: ['/healthz', '/favicon.ico', '/metrics', '/docs', '/.well-known'], skipNotFoundRoutes: false }\n   *\n   * @example\n   * ```typescript\n   * builder.withRequestLogging({\n   *   enable: true,\n   *   ignorePaths: ['/health', '/metrics'],\n   *   skipNotFoundRoutes: true\n   * })\n   * ```\n   */\n  withRequestLogging(opts: Partial<NonNullable<ServerConfig['requestLogging']>>): this {\n    this.mergeConfig('requestLogging', opts as NonNullable<ServerConfig['requestLogging']>);\n    return this;\n  }\n\n  /**\n   * Enables request logging with default or custom settings\n   *\n   * @param opts - Optional request logging configuration\n   * @returns The builder instance for chaining\n   */\n  enableRequestLogging(opts: Omit<Partial<NonNullable<ServerConfig['requestLogging']>>, 'enable'> = {}): this {\n    return this.setEnabled('requestLogging', true, opts);\n  }\n\n  /**\n   * Disables request logging\n   *\n   * @returns The builder instance for chaining\n   */\n  disableRequestLogging(): this {\n    return this.setEnabled('requestLogging', false);\n  }\n\n  /**\n   * Configures server metrics collection and endpoints.\n   *\n   * @param opts - Metrics configuration options\n   * @returns The builder instance for chaining\n   * @default { enable: false, path: '/metrics', withGlobalPrefix: false }\n   *\n   * @example\n   * ```typescript\n   * builder.withMetrics({\n   *   enable: true,\n   *   path: '/metrics'\n   * })\n   * ```\n   */\n  withMetrics(opts: Partial<NonNullable<ServerConfig['metrics']>>): this {\n    this.mergeConfig('metrics', opts as NonNullable<ServerConfig['metrics']>);\n    return this;\n  }\n\n  /**\n   * Enables Prometheus metrics collection and endpoint\n   *\n   * @param opts - Optional metrics configuration\n   * @returns The builder instance for chaining\n   */\n  enableMetrics(opts: Omit<Partial<NonNullable<ServerConfig['metrics']>>, 'enable'> = {}): this {\n    return this.setEnabled('metrics', true, opts);\n  }\n\n  /**\n   * Disables Prometheus metrics\n   *\n   * @returns The builder instance for chaining\n   */\n  disableMetrics(): this {\n    return this.setEnabled('metrics', false);\n  }\n\n  /**\n   * Configures server health check endpoint.\n   *\n   * @param opts - Health check configuration options\n   * @returns The builder instance for chaining\n   * @default { path: '/healthz', detailed: true, withGlobalPrefix: false }\n   *\n   * @example\n   * ```typescript\n   * builder.withHealthCheck({\n   *   path: '/health',\n   *   detailed: true\n   * })\n   * ```\n   */\n  withHealthCheck(opts: Partial<NonNullable<ServerConfig['healthCheck']>>): this {\n    this.mergeConfig('healthCheck', opts as NonNullable<ServerConfig['healthCheck']>);\n    return this;\n  }\n\n  /**\n   * Configures OpenAPI/Swagger documentation for the API.\n   *\n   * @param opts - OpenAPI configuration options\n   * @returns The builder instance for chaining\n   * @default { enable: false, mountPath: '/docs', verbose: false, withGlobalPrefix: false }\n   *\n   * @example\n   * ```typescript\n   * builder.withOpenApi({\n   *   enable: true,\n   *   path: '/api-docs',\n   *   filePath: './openapi.yaml'\n   * })\n   * ```\n   */\n  withOpenApi(opts: Partial<NonNullable<ServerConfig['openApi']>>): this {\n    this.mergeConfig('openApi', opts as NonNullable<ServerConfig['openApi']>);\n    return this;\n  }\n\n  /**\n   * Enables OpenAPI documentation with required file path\n   *\n   * @param filePath - Path to OpenAPI specification file (required)\n   * @param opts - Optional OpenAPI configuration\n   * @returns The builder instance for chaining\n   */\n  enableOpenApi(\n    filePath: string,\n    opts: Omit<Partial<NonNullable<ServerConfig['openApi']>>, 'enable' | 'filePath'> = {}\n  ): this {\n    this.setEnabled('openApi', true, { filePath, ...opts });\n    return this;\n  }\n\n  /**\n   * Disables OpenAPI documentation\n   *\n   * @returns The builder instance for chaining\n   */\n  disableOpenApi(): this {\n    return this.setEnabled('openApi', false);\n  }\n\n  /**\n   * Configures the server as a microservice with versioning.\n   *\n   * @param opts - Microservice configuration options including app name and service version\n   * @returns The builder instance for chaining\n   * @default { isMicroservice: false, appName: 'express_app' }\n   *\n   * @example\n   * ```typescript\n   * builder.withMicroService({\n   *   appName: 'user-service',\n   *   serviceVersion: {\n   *     enable: true,\n   *     version: '1.2.3'\n   *   }\n   * })\n   * ```\n   */\n  withMicroService(opts: {\n    appName: NonNullable<ServerConfig['appName']>;\n    serviceVersion: Partial<NonNullable<ServerConfig['serviceVersion']>>;\n  }): this {\n    this.config.isMicroservice = true;\n    this.config.appName = opts.appName;\n\n    this.mergeConfig('serviceVersion', opts.serviceVersion as NonNullable<ServerConfig['serviceVersion']>);\n    return this;\n  }\n\n  /**\n   * Configures the trust proxy settings to determine if X-Forwarded-* headers should be trusted.\n   *\n   * @param opts - Trust proxy configuration options\n   * @returns The builder instance for chaining\n   * @default false\n   *\n   * @example\n   * ```typescript\n   * // Trust proxy headers (useful when behind a load balancer)\n   * builder.withTrustProxy(true)\n   * ```\n   */\n  withTrustProxy(opts: NonNullable<ServerConfig['trustProxy']>): this {\n    this.config.trustProxy = opts;\n    return this;\n  }\n\n  /**\n   * Configures the request ID middleware for tracing requests across services.\n   *\n   * @param opts - Request ID configuration options\n   * @returns The builder instance for chaining\n   * @default { headerName: 'x-request-id', exposeHeader: true }\n   *\n   * @example\n   * ```typescript\n   * builder.withRequestId({\n   *   headerName: 'X-Request-Id',\n   *   generator: () => crypto.randomUUID()\n   * })\n   * ```\n   */\n  withRequestId(opts: Partial<NonNullable<ServerConfig['requestId']>>): this {\n    this.mergeConfig('requestId', opts as NonNullable<ServerConfig['requestId']>);\n    return this;\n  }\n\n  /**\n   * Configures the response time middleware for measuring request processing times.\n   *\n   * @param opts - Response time configuration options\n   * @returns The builder instance for chaining\n   * @default { enable: false, addHeader: true, logOnComplete: false }\n   *\n   * @example\n   * ```typescript\n   * builder.withResponseTime({\n   *   enable: true,\n   *   addHeader: true,\n   *   logOnComplete: true\n   * })\n   * ```\n   */\n  withResponseTime(opts: Partial<NonNullable<ServerConfig['responseTime']>>): this {\n    this.mergeConfig('responseTime', opts as NonNullable<ServerConfig['responseTime']>);\n    return this;\n  }\n\n  /**\n   * Enables response time tracking with default or custom settings\n   *\n   * @param opts - Optional response time configuration\n   * @returns The builder instance for chaining\n   */\n  enableResponseTime(opts: Omit<Partial<NonNullable<ServerConfig['responseTime']>>, 'enable'> = {}): this {\n    this.setEnabled('responseTime', true, opts);\n    return this;\n  }\n\n  /**\n   * Disables response time tracking\n   *\n   * @returns The builder instance for chaining\n   */\n  disableResponseTime(): this {\n    return this.setEnabled('responseTime', false);\n  }\n\n  /**\n   * Configures the body parser middleware options for parsing request bodies.\n   *\n   * @param opts - Body parser configuration options\n   * @returns The builder instance for chaining\n   * @default { json: { limit: '1mb' }, urlencoded: { extended: true, limit: '1mb' } }\n   *\n   * @example\n   * ```typescript\n   * builder.withBodyParser({\n   *   json: {\n   *     limit: '1mb'\n   *   },\n   *   urlencoded: {\n   *     extended: true,\n   *     limit: '1mb'\n   *   }\n   * })\n   * ```\n   */\n  withBodyParser(opts: NonNullable<ServerConfig['bodyParser']>): this {\n    this.config.bodyParser = deepObjMerge({}, this.config.bodyParser ?? {}, opts);\n    return this;\n  }\n\n  /**\n   * Configures cookie parsing middleware.\n   *\n   * @param opts - Cookie parser options or boolean (true to enable with defaults, false to disable)\n   * @returns The builder instance for chaining\n   * @default false\n   *\n   * @example\n   * ```typescript\n   * // Enable cookie parsing with default options\n   * builder.withCookies(true)\n   *\n   * // Enable cookie parsing with specific options\n   * builder.withCookies({\n   *   secret: 'your-secret-key',\n   *   secure: true\n   * })\n   * ```\n   */\n  withCookies(opts: ServerConfig['cookieParser']): this {\n    this.config.cookieParser = opts;\n    return this;\n  }\n\n  /**\n   * Configures the logger used by the server.\n   *\n   * @param opts - Logger configuration options\n   * @returns The builder instance for chaining\n   * @default { name: 'express_app', level: 'info', prettyPrint: true in dev, singleLine: false }\n   *\n   * @example\n   * ```typescript\n   * builder.withLogger({\n   *   level: 'info',\n   *   prettyPrint: true,\n   *   singleLine: false\n   * })\n   * ```\n   */\n  withLogger(opts: Partial<NonNullable<ServerConfig['logger']>>): this {\n    this.mergeConfig('logger', opts as NonNullable<ServerConfig['logger']>);\n    return this;\n  }\n\n  /**\n   * Adds a static folder to serve files from.\n   *\n   * @param folder - Static folder configuration\n   * @returns The builder instance for chaining\n   *\n   * @example\n   * ```typescript\n   * builder.withStaticFolder({\n   *   path: '/assets',\n   *   directory: './public',\n   *   options: { maxAge: '1d' }\n   * })\n   * ```\n   */\n  withStaticFolder(folder: NonNullable<ServerConfig['staticFolders']>[number]): this {\n    if (!folder.path) throw new Error('Static folder requires a path');\n    const folders = [...(this.config.staticFolders ?? []), folder];\n    this.config.staticFolders = Array.from(new Map(folders.map(f => [f.path, f])).values());\n    return this;\n  }\n\n  /**\n   * Sets global headers to be included in all responses.\n   *\n   * @param headers - Object containing header name/value pairs or functions that return values\n   * @returns The builder instance for chaining\n   * @default {}\n   *\n   * @example\n   * ```typescript\n   * builder.withGlobalHeaders({\n   *   'X-Powered-By': 'Catbee',\n   *   'Server-Time': () => new Date().toISOString()\n   * })\n   * ```\n   */\n  withGlobalHeaders(headers: NonNullable<ServerConfig['globalHeaders']>): this {\n    this.mergeConfig('globalHeaders', headers);\n    return this;\n  }\n\n  /**\n   * Sets a global prefix for all routes.\n   *\n   * @param prefix - The prefix to prepend to all routes (e.g., '/api/v1')\n   * @returns The builder instance for chaining\n   * @default '/'\n   *\n   * @example\n   * ```typescript\n   * builder.withGlobalPrefix('/api/v1')\n   * ```\n   */\n  withGlobalPrefix(prefix: string): this {\n    this.config.globalPrefix = prefix;\n    return this;\n  }\n\n  /**\n   * Applies custom configuration overrides directly.\n   *\n   * @param overrides - Custom configuration options to merge\n   * @returns The builder instance for chaining\n   *\n   * @example\n   * ```typescript\n   * builder.withCustom({\n   *   port: 8080,\n   *   customMiddleware: myMiddlewareFunction\n   * })\n   * ```\n   */\n  withCustom(overrides: Partial<ServerConfig>): this {\n    this.config = deepObjMerge({}, this.config, overrides);\n    return this;\n  }\n\n  /**\n   * Configures HTTPS server options.\n   *\n   * @param opts - HTTPS configuration (key, cert, ca, passphrase, etc.)\n   * @returns The builder instance for chaining\n   *\n   * @example\n   * ```typescript\n   * builder.withHttps({\n   *   key: './localhost-key.pem',\n   *   cert: './localhost-cert.pem'\n   * })\n   * ```\n   */\n  withHttps(opts: NonNullable<ServerConfig['https']>): this {\n    this.config.https = opts;\n    return this;\n  }\n\n  /**\n   * Builds and returns the final server configuration.\n   *\n   * This method merges the user-specified configuration with default values,\n   * ensures all sections with 'enable' flags are properly structured, and\n   * produces the final configuration to be used by the server.\n   *\n   * @returns The complete ServerConfig object\n   *\n   * @example\n   * ```typescript\n   * const config = new ServerConfigBuilder()\n   *   .withPort(3000)\n   *   .withHost('localhost')\n   *   .withCors(true)\n   *   .build();\n   * ```\n   */\n  build() {\n    const config = deepObjMerge({}, defaultServerConfig, this.config) as ServerConfig;\n\n    // Common validation\n    if (config.openApi?.enable && !config.openApi.filePath) {\n      throw new Error('OpenAPI is enabled but no filePath is specified');\n    }\n\n    return Object.freeze({\n      ...config,\n      [BUILD_MARKER]: true\n    });\n  }\n\n  private mergeConfig<K extends keyof ServerConfig>(key: K, value: Partial<NonNullable<ServerConfig[K]>>): void {\n    const current =\n      typeof this.config[key] === 'object' && this.config[key] !== null\n        ? (this.config[key] as NonNullable<ServerConfig[K]>)\n        : {};\n    this.config[key] = deepObjMerge({}, current, value) as NonNullable<ServerConfig[K]>;\n  }\n\n  private setEnabled<K extends keyof ServerConfig>(\n    key: K,\n    enable: boolean,\n    overrides: Partial<NonNullable<ServerConfig[K]>> = {}\n  ): this {\n    this.mergeConfig(key, { ...overrides, enable });\n    return this;\n  }\n}\n"]}
+{"version":3,"file":"server.builder.js","sourceRoot":"","sources":["../../../src/servers/server.builder.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * The MIT License\n *\n * Copyright (c) 2025 Catbee Technologies\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { deepObjMerge } from '../utils/obj.utils';\nimport { ServerConfig } from '../types/server';\nimport { defaultServerConfig } from '../config';\nimport { isPort } from '../utils/validate.utils';\n\n/**\n * Builder class for creating and configuring an Express server configuration.\n *\n * This class provides a fluent interface to configure all aspects of the Express server\n * including security settings, middleware, routing, and more.\n *\n * @example\n * ```typescript\n * const serverConfig = new ServerConfigBuilder()\n *   .withPort(3000)\n *   .withHost('localhost')\n *   .enableCors()\n *   .enableHelmet()\n *   .build();\n * ```\n */\n\nexport const BUILD_MARKER = Symbol.for('catbee.express.server.build');\n\nexport class ServerConfigBuilder {\n  private config: Partial<ServerConfig> = {};\n\n  /**\n   * Validates that a port number is valid and usable.\n   *\n   * @private\n   * @param port - The port number to validate\n   * @throws {Error} If port is not an integer or is outside the valid range (1-65535)\n   */\n  private validatePort(port: number): void {\n    if (!isPort(port)) {\n      throw new Error(`Port must be a valid number between 1 and 65535, got: ${port}`);\n    }\n  }\n\n  /**\n   * Sets the port the server will listen on.\n   *\n   * @param port - The port number (1-65535)\n   * @returns The builder instance for chaining\n   * @throws {Error} If port is invalid\n   * @default 3000 (can be overridden via PORT env variable)\n   *\n   * @example\n   * ```typescript\n   * builder.withPort(3000)\n   * ```\n   */\n  withPort(port: number): this {\n    this.validatePort(port);\n    this.config.port = port;\n    return this;\n  }\n\n  /**\n   * Sets the hostname the server will bind to.\n   *\n   * @param host - The hostname (e.g., 'localhost', '0.0.0.0', '127.0.0.1')\n   * @returns The builder instance for chaining\n   * @default '0.0.0.0' (can be overridden via HOST env variable)\n   *\n   * @example\n   * ```typescript\n   * builder.withHost('0.0.0.0') // Listen on all interfaces\n   * ```\n   */\n  withHost(host: string): this {\n    this.config.host = host;\n    return this;\n  }\n\n  /**\n   * Configures Cross-Origin Resource Sharing (CORS) for the server.\n   *\n   * @param opts - CORS options object or boolean (true to enable with defaults, false to disable)\n   * @returns The builder instance for chaining\n   * @default false (CORS is disabled by default)\n   *\n   * @example\n   * ```typescript\n   * // Enable CORS with default options\n   * builder.withCors(true)\n   *\n   * // Configure CORS with specific options\n   * builder.withCors({\n   *   origin: ['https://example.com'],\n   *   methods: ['GET', 'POST']\n   * })\n   * ```\n   */\n  withCors(opts: ServerConfig['cors']): this {\n    this.config.cors = opts;\n    return this;\n  }\n\n  /**\n   * Enables CORS with default settings\n   *\n   * @returns The builder instance for chaining\n   */\n  enableCors(): this {\n    return this.withCors(true);\n  }\n\n  /**\n   * Disables CORS\n   *\n   * @returns The builder instance for chaining\n   */\n  disableCors(): this {\n    return this.withCors(false);\n  }\n\n  /**\n   * Configures the Helmet middleware for setting HTTP security headers.\n   *\n   * @param opts - Helmet options object or boolean (true to enable with defaults, false to disable)\n   * @returns The builder instance for chaining\n   * @default false (Helmet is disabled by default)\n   *\n   * @example\n   * ```typescript\n   * // Enable Helmet with default settings\n   * builder.withHelmet(true)\n   *\n   * // Configure Helmet with specific options\n   * builder.withHelmet({\n   *   contentSecurityPolicy: false,\n   *   xssFilter: true\n   * })\n   * ```\n   */\n  withHelmet(opts: ServerConfig['helmet']): this {\n    this.config.helmet = opts;\n    return this;\n  }\n\n  /**\n   * Enables Helmet with default settings\n   *\n   * @returns The builder instance for chaining\n   */\n  enableHelmet(): this {\n    return this.withHelmet(true);\n  }\n\n  /**\n   * Disables Helmet\n   *\n   * @returns The builder instance for chaining\n   */\n  disableHelmet(): this {\n    return this.withHelmet(false);\n  }\n\n  /**\n   * Configures response compression middleware.\n   *\n   * @param opts - Compression options object or boolean (true to enable with defaults, false to disable)\n   * @returns The builder instance for chaining\n   * @default false (Compression is disabled by default)\n   *\n   * @example\n   * ```typescript\n   * // Enable compression with default settings\n   * builder.withCompression(true)\n   *\n   * // Configure compression with specific options\n   * builder.withCompression({\n   *   level: 6,\n   *   threshold: 1024\n   * })\n   * ```\n   */\n  withCompression(opts: ServerConfig['compression']): this {\n    this.config.compression = opts;\n    return this;\n  }\n\n  /**\n   * Enables compression with default settings\n   *\n   * @returns The builder instance for chaining\n   */\n  enableCompression(): this {\n    return this.withCompression(true);\n  }\n\n  /**\n   * Disables compression\n   *\n   * @returns The builder instance for chaining\n   */\n  disableCompression(): this {\n    return this.withCompression(false);\n  }\n\n  /**\n   * Configures rate limiting to protect against brute-force attacks.\n   *\n   * @param opts - Rate limit configuration options\n   * @returns The builder instance for chaining\n   * @default { enable: false, windowMs: 15 * 60 * 1000, max: 100, message: 'Too many requests', standardHeaders: true, legacyHeaders: false }\n   *\n   * @example\n   * ```typescript\n   * builder.withRateLimit({\n   *   enable: true,\n   *   windowMs: 15 * 60 * 1000, // 15 minutes\n   *   max: 100 // limit each IP to 100 requests per windowMs\n   * })\n   * ```\n   */\n  withRateLimit(opts: Partial<ServerConfig['rateLimit']>): this {\n    this.mergeConfig('rateLimit', opts as NonNullable<ServerConfig['rateLimit']>);\n    return this;\n  }\n\n  /**\n   * Enables rate limiting with default or custom settings\n   *\n   * @param opts - Optional rate limit configuration (max requests, window, etc.)\n   * @returns The builder instance for chaining\n   */\n  enableRateLimit(opts: Omit<Partial<NonNullable<ServerConfig['rateLimit']>>, 'enable'> = {}): this {\n    return this.setEnabled('rateLimit', true, opts);\n  }\n\n  /**\n   * Disables rate limiting\n   *\n   * @returns The builder instance for chaining\n   */\n  disableRateLimit(): this {\n    return this.setEnabled('rateLimit', false);\n  }\n\n  /**\n   * Configures HTTP request logging middleware.\n   *\n   * @param opts - Request logging configuration options\n   * @returns The builder instance for chaining\n   * @default { enable: true in dev/false in prod, ignorePaths: ['/healthz', '/favicon.ico', '/metrics', '/docs', '/.well-known'], skipNotFoundRoutes: false }\n   *\n   * @example\n   * ```typescript\n   * builder.withRequestLogging({\n   *   enable: true,\n   *   ignorePaths: ['/health', '/metrics'],\n   *   skipNotFoundRoutes: true\n   * })\n   * ```\n   */\n  withRequestLogging(opts: Partial<NonNullable<ServerConfig['requestLogging']>>): this {\n    this.mergeConfig('requestLogging', opts as NonNullable<ServerConfig['requestLogging']>);\n    return this;\n  }\n\n  /**\n   * Enables request logging with default or custom settings\n   *\n   * @param opts - Optional request logging configuration\n   * @returns The builder instance for chaining\n   */\n  enableRequestLogging(opts: Omit<Partial<NonNullable<ServerConfig['requestLogging']>>, 'enable'> = {}): this {\n    return this.setEnabled('requestLogging', true, opts);\n  }\n\n  /**\n   * Disables request logging\n   *\n   * @returns The builder instance for chaining\n   */\n  disableRequestLogging(): this {\n    return this.setEnabled('requestLogging', false);\n  }\n\n  /**\n   * Configures server metrics collection and endpoints.\n   *\n   * @param opts - Metrics configuration options\n   * @returns The builder instance for chaining\n   * @default { enable: false, path: '/metrics', withGlobalPrefix: false }\n   *\n   * @example\n   * ```typescript\n   * builder.withMetrics({\n   *   enable: true,\n   *   path: '/metrics'\n   * })\n   * ```\n   */\n  withMetrics(opts: Partial<NonNullable<ServerConfig['metrics']>>): this {\n    this.mergeConfig('metrics', opts as NonNullable<ServerConfig['metrics']>);\n    return this;\n  }\n\n  /**\n   * Enables Prometheus metrics collection and endpoint\n   *\n   * @param opts - Optional metrics configuration\n   * @returns The builder instance for chaining\n   */\n  enableMetrics(opts: Omit<Partial<NonNullable<ServerConfig['metrics']>>, 'enable'> = {}): this {\n    return this.setEnabled('metrics', true, opts);\n  }\n\n  /**\n   * Disables Prometheus metrics\n   *\n   * @returns The builder instance for chaining\n   */\n  disableMetrics(): this {\n    return this.setEnabled('metrics', false);\n  }\n\n  /**\n   * Configures server health check endpoint.\n   *\n   * @param opts - Health check configuration options\n   * @returns The builder instance for chaining\n   * @default { path: '/healthz', detailed: true, withGlobalPrefix: false }\n   *\n   * @example\n   * ```typescript\n   * builder.withHealthCheck({\n   *   path: '/health',\n   *   detailed: true\n   * })\n   * ```\n   */\n  withHealthCheck(opts: Partial<NonNullable<ServerConfig['healthCheck']>>): this {\n    this.mergeConfig('healthCheck', opts as NonNullable<ServerConfig['healthCheck']>);\n    return this;\n  }\n\n  /**\n   * Configures OpenAPI/Swagger documentation for the API.\n   *\n   * @param opts - OpenAPI configuration options\n   * @returns The builder instance for chaining\n   * @default { enable: false, mountPath: '/docs', verbose: false, withGlobalPrefix: false }\n   *\n   * @example\n   * ```typescript\n   * builder.withOpenApi({\n   *   enable: true,\n   *   path: '/api-docs',\n   *   filePath: './openapi.yaml'\n   * })\n   * ```\n   */\n  withOpenApi(opts: Partial<NonNullable<ServerConfig['openApi']>>): this {\n    this.mergeConfig('openApi', opts as NonNullable<ServerConfig['openApi']>);\n    return this;\n  }\n\n  /**\n   * Enables OpenAPI documentation with required file path\n   *\n   * @param filePath - Path to OpenAPI specification file (required)\n   * @param opts - Optional OpenAPI configuration\n   * @returns The builder instance for chaining\n   */\n  enableOpenApi(\n    filePath: string,\n    opts: Omit<Partial<NonNullable<ServerConfig['openApi']>>, 'enable' | 'filePath'> = {}\n  ): this {\n    this.setEnabled('openApi', true, { filePath, ...opts });\n    return this;\n  }\n\n  /**\n   * Disables OpenAPI documentation\n   *\n   * @returns The builder instance for chaining\n   */\n  disableOpenApi(): this {\n    return this.setEnabled('openApi', false);\n  }\n\n  /**\n   * Configures the server as a microservice with versioning.\n   *\n   * @param opts - Microservice configuration options including app name and service version\n   * @returns The builder instance for chaining\n   * @default { isMicroservice: false, appName: 'express_app' }\n   *\n   * @example\n   * ```typescript\n   * builder.withMicroService({\n   *   appName: 'user-service',\n   *   serviceVersion: {\n   *     enable: true,\n   *     version: '1.2.3'\n   *   }\n   * })\n   * ```\n   */\n  withMicroService(opts: {\n    appName: NonNullable<ServerConfig['appName']>;\n    serviceVersion: Partial<NonNullable<ServerConfig['serviceVersion']>>;\n  }): this {\n    this.config.isMicroservice = true;\n    this.config.appName = opts.appName;\n\n    this.mergeConfig('serviceVersion', opts.serviceVersion as NonNullable<ServerConfig['serviceVersion']>);\n    return this;\n  }\n\n  /**\n   * Configures the trust proxy settings to determine if X-Forwarded-* headers should be trusted.\n   *\n   * @param opts - Trust proxy configuration options\n   * @returns The builder instance for chaining\n   * @default false\n   *\n   * @example\n   * ```typescript\n   * // Trust proxy headers (useful when behind a load balancer)\n   * builder.withTrustProxy(true)\n   * ```\n   */\n  withTrustProxy(opts: NonNullable<ServerConfig['trustProxy']>): this {\n    this.config.trustProxy = opts;\n    return this;\n  }\n\n  /**\n   * Configures the request ID middleware for tracing requests across services.\n   *\n   * @param opts - Request ID configuration options\n   * @returns The builder instance for chaining\n   * @default { headerName: 'x-request-id', exposeHeader: true }\n   *\n   * @example\n   * ```typescript\n   * builder.withRequestId({\n   *   headerName: 'X-Request-Id',\n   *   generator: () => crypto.randomUUID()\n   * })\n   * ```\n   */\n  withRequestId(opts: Partial<NonNullable<ServerConfig['requestId']>>): this {\n    this.mergeConfig('requestId', opts as NonNullable<ServerConfig['requestId']>);\n    return this;\n  }\n\n  /**\n   * Configures the response time middleware for measuring request processing times.\n   *\n   * @param opts - Response time configuration options\n   * @returns The builder instance for chaining\n   * @default { enable: false, addHeader: true, logOnComplete: false }\n   *\n   * @example\n   * ```typescript\n   * builder.withResponseTime({\n   *   enable: true,\n   *   addHeader: true,\n   *   logOnComplete: true\n   * })\n   * ```\n   */\n  withResponseTime(opts: Partial<NonNullable<ServerConfig['responseTime']>>): this {\n    this.mergeConfig('responseTime', opts as NonNullable<ServerConfig['responseTime']>);\n    return this;\n  }\n\n  /**\n   * Enables response time tracking with default or custom settings\n   *\n   * @param opts - Optional response time configuration\n   * @returns The builder instance for chaining\n   */\n  enableResponseTime(opts: Omit<Partial<NonNullable<ServerConfig['responseTime']>>, 'enable'> = {}): this {\n    this.setEnabled('responseTime', true, opts);\n    return this;\n  }\n\n  /**\n   * Disables response time tracking\n   *\n   * @returns The builder instance for chaining\n   */\n  disableResponseTime(): this {\n    return this.setEnabled('responseTime', false);\n  }\n\n  /**\n   * Configures the body parser middleware options for parsing request bodies.\n   *\n   * @param opts - Body parser configuration options\n   * @returns The builder instance for chaining\n   * @default { json: { limit: '1mb' }, urlencoded: { extended: true, limit: '1mb' } }\n   *\n   * @example\n   * ```typescript\n   * builder.withBodyParser({\n   *   json: {\n   *     limit: '1mb'\n   *   },\n   *   urlencoded: {\n   *     extended: true,\n   *     limit: '1mb'\n   *   }\n   * })\n   * ```\n   */\n  withBodyParser(opts: NonNullable<ServerConfig['bodyParser']>): this {\n    this.config.bodyParser = deepObjMerge({}, this.config.bodyParser ?? {}, opts);\n    return this;\n  }\n\n  /**\n   * Configures cookie parsing middleware.\n   *\n   * @param opts - Cookie parser options or boolean (true to enable with defaults, false to disable)\n   * @returns The builder instance for chaining\n   * @default false\n   *\n   * @example\n   * ```typescript\n   * // Enable cookie parsing with default options\n   * builder.withCookies(true)\n   *\n   * // Enable cookie parsing with specific options\n   * builder.withCookies({\n   *   secret: 'your-secret-key',\n   *   secure: true\n   * })\n   * ```\n   */\n  withCookies(opts: ServerConfig['cookieParser']): this {\n    this.config.cookieParser = opts;\n    return this;\n  }\n\n  /**\n   * Adds a static folder to serve files from.\n   *\n   * @param folder - Static folder configuration\n   * @returns The builder instance for chaining\n   *\n   * @example\n   * ```typescript\n   * builder.withStaticFolder({\n   *   path: '/assets',\n   *   directory: './public',\n   *   options: { maxAge: '1d' }\n   * })\n   * ```\n   */\n  withStaticFolder(folder: NonNullable<ServerConfig['staticFolders']>[number]): this {\n    if (!folder.path) throw new Error('Static folder requires a path');\n    const folders = [...(this.config.staticFolders ?? []), folder];\n    this.config.staticFolders = Array.from(new Map(folders.map(f => [f.path, f])).values());\n    return this;\n  }\n\n  /**\n   * Sets global headers to be included in all responses.\n   *\n   * @param headers - Object containing header name/value pairs or functions that return values\n   * @returns The builder instance for chaining\n   * @default {}\n   *\n   * @example\n   * ```typescript\n   * builder.withGlobalHeaders({\n   *   'X-Powered-By': 'Catbee',\n   *   'Server-Time': () => new Date().toISOString()\n   * })\n   * ```\n   */\n  withGlobalHeaders(headers: NonNullable<ServerConfig['globalHeaders']>): this {\n    this.mergeConfig('globalHeaders', headers);\n    return this;\n  }\n\n  /**\n   * Sets a global prefix for all routes.\n   *\n   * @param prefix - The prefix to prepend to all routes (e.g., '/api/v1')\n   * @returns The builder instance for chaining\n   * @default '/'\n   *\n   * @example\n   * ```typescript\n   * builder.withGlobalPrefix('/api/v1')\n   * ```\n   */\n  withGlobalPrefix(prefix: string): this {\n    this.config.globalPrefix = prefix;\n    return this;\n  }\n\n  /**\n   * Applies custom configuration overrides directly.\n   *\n   * @param overrides - Custom configuration options to merge\n   * @returns The builder instance for chaining\n   *\n   * @example\n   * ```typescript\n   * builder.withCustom({\n   *   port: 8080,\n   *   customMiddleware: myMiddlewareFunction\n   * })\n   * ```\n   */\n  withCustom(overrides: Partial<ServerConfig>): this {\n    this.config = deepObjMerge({}, this.config, overrides);\n    return this;\n  }\n\n  /**\n   * Configures HTTPS server options.\n   *\n   * @param opts - HTTPS configuration (key, cert, ca, passphrase, etc.)\n   * @returns The builder instance for chaining\n   *\n   * @example\n   * ```typescript\n   * builder.withHttps({\n   *   key: './localhost-key.pem',\n   *   cert: './localhost-cert.pem'\n   * })\n   * ```\n   */\n  withHttps(opts: NonNullable<ServerConfig['https']>): this {\n    this.config.https = opts;\n    return this;\n  }\n\n  /**\n   * Builds and returns the final server configuration.\n   *\n   * This method merges the user-specified configuration with default values,\n   * ensures all sections with 'enable' flags are properly structured, and\n   * produces the final configuration to be used by the server.\n   *\n   * @returns The complete ServerConfig object\n   *\n   * @example\n   * ```typescript\n   * const config = new ServerConfigBuilder()\n   *   .withPort(3000)\n   *   .withHost('localhost')\n   *   .withCors(true)\n   *   .build();\n   * ```\n   */\n  build(): Readonly<ServerConfig> {\n    const config = deepObjMerge({}, defaultServerConfig, this.config) as ServerConfig;\n\n    // Common validation\n    if (config.openApi?.enable && !config.openApi.filePath) {\n      throw new Error('OpenAPI is enabled but no filePath is specified');\n    }\n\n    return Object.freeze({\n      ...config,\n      [BUILD_MARKER]: true\n    });\n  }\n\n  private mergeConfig<K extends keyof ServerConfig>(key: K, value: Partial<NonNullable<ServerConfig[K]>>): void {\n    const current =\n      typeof this.config[key] === 'object' && this.config[key] !== null\n        ? (this.config[key] as NonNullable<ServerConfig[K]>)\n        : {};\n    this.config[key] = deepObjMerge({}, current, value) as NonNullable<ServerConfig[K]>;\n  }\n\n  private setEnabled<K extends keyof ServerConfig>(\n    key: K,\n    enable: boolean,\n    overrides: Partial<NonNullable<ServerConfig[K]>> = {}\n  ): this {\n    this.mergeConfig(key, { ...overrides, enable });\n    return this;\n  }\n}\n"]}

package/build/esm/servers/server.d.ts

@@ -183,12 +183,12 @@ export declare class ExpressServer {
      *
      * @param signals Array of process signals to listen for (default: SIGINT, SIGTERM)
      */
-    enableGracefulShutdown(signals?: NodeJS.Signals[]): void;
+    enableGracefulShutdown(signals?: NodeJS.Signals[]): this;
     /**
      * Set an externally created base router.
      * This will override the internal rootRouter.
      */
-    setBaseRouter(router: Router): void;
+    setBaseRouter(router: Router): this;
     /**
      * Create and register a new router (only used if not injecting one externally - use `setBaseRouter` instead).
      */

package/build/esm/servers/server.js

@@ -110,7 +110,7 @@ import client, { Counter, Histogram } from 'prom-client';
 import { NotFoundException } from '../utils/exception.utils';
 import fs from 'fs';
 import { apiReference } from '@scalar/express-api-reference';
-import { defaultServerConfig, setConfig } from '../config';
+import { defaultServerConfig } from '../config';
 import { deepObjMerge } from '../utils/obj.utils';
 import { fileExists } from '../utils/fs.utils';
 import { BUILD_MARKER } from './server.builder';
@@ -214,18 +214,6 @@ var ExpressServer = /** @class */ (function () {
         if ((_c = config.healthCheck) === null || _c === void 0 ? void 0 : _c.checks) {
             (_a = this.healthChecks).push.apply(_a, __spreadArray([], __read(config.healthCheck.checks), false));
         }
-        // Logger
-        if (this.config.logger) {
-            var _e = this.config.logger, name_1 = _e.name, level = _e.level, pretty = _e.prettyPrint, singleLine = _e.singleLine;
-            setConfig({
-                logger: {
-                    name: name_1 !== null && name_1 !== void 0 ? name_1 : 'express_app',
-                    level: level !== null && level !== void 0 ? level : 'info',
-                    pretty: pretty !== null && pretty !== void 0 ? pretty : Env.isDev(),
-                    singleLine: singleLine !== null && singleLine !== void 0 ? singleLine : false
-                }
-            });
-        }
         // Set global prefix (normalize to empty string or "/prefix" without trailing slash)
         this.globalPrefix = this.normalizePath((_d = this.config.globalPrefix) !== null && _d !== void 0 ? _d : '', false);
         this.hooks = hooks;
@@ -962,6 +950,7 @@ var ExpressServer = /** @class */ (function () {
                 });
             }); });
         });
+        return this;
     };
     /**
      * Set an externally created base router.
@@ -969,6 +958,7 @@ var ExpressServer = /** @class */ (function () {
      */
     ExpressServer.prototype.setBaseRouter = function (router) {
         this.externalRouter = router;
+        return this;
     };
     /**
      * Create and register a new router (only used if not injecting one externally - use `setBaseRouter` instead).