@catbee/utils 1.1.0 → 2.0.0-next.1

package/cache/index.mjs

@@ -0,0 +1,290 @@
+/*
+ * The MIT License
+ * 
+ * Copyright (c) 2025 Catbee Technologies. https://catbee.in/license
+ * 
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ * 
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ * 
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+import { getCatbeeGlobalConfig } from '@catbee/utils/config';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var TTLCache = class {
+  static {
+    __name(this, "TTLCache");
+  }
+  cache = /* @__PURE__ */ new Map();
+  ttlMs;
+  maxSize;
+  cleanupInterval;
+  /**
+  * @param options - Configuration options for the cache
+  */
+  constructor(options = {}) {
+    this.ttlMs = options.ttlMs ?? getCatbeeGlobalConfig().cache.defaultTtl;
+    this.maxSize = options.maxSize;
+    const autoCleanupMs = options.autoCleanupMs;
+    if (autoCleanupMs && autoCleanupMs > 0) {
+      this.cleanupInterval = setInterval(() => {
+        this.cleanup();
+      }, autoCleanupMs);
+    }
+  }
+  /**
+  * Sets a key-value pair in the cache with the default TTL.
+  *
+  * @param key - The key to set.
+  * @param value - The value to associate with the key.
+  */
+  set(key, value) {
+    this.setWithTTL(key, value, this.ttlMs);
+  }
+  /**
+  * Sets a key-value pair in the cache with a custom TTL.
+  *
+  * @param key - The key to set.
+  * @param value - The value to associate with the key.
+  * @param ttlMs - Time-to-live in milliseconds.
+  */
+  setWithTTL(key, value, ttlMs) {
+    const now = Date.now();
+    const expiresAt = now + ttlMs;
+    if (this.cache.has(key)) {
+      this.cache.delete(key);
+    }
+    this.cache.set(key, {
+      value,
+      expiresAt,
+      lastAccessed: now
+    });
+    if (this.maxSize && this.cache.size > this.maxSize) {
+      this.evictLRU();
+    }
+  }
+  /**
+  * Retrieves the value for a given key if it hasn't expired.
+  *
+  * @param key - The key to retrieve.
+  * @returns The cached value, or undefined if not found or expired.
+  */
+  get(key) {
+    const entry = this.cache.get(key);
+    if (!entry) return void 0;
+    const now = Date.now();
+    if (now > entry.expiresAt) {
+      this.cache.delete(key);
+      return void 0;
+    }
+    entry.lastAccessed = now;
+    this.cache.delete(key);
+    this.cache.set(key, entry);
+    return entry.value;
+  }
+  /**
+  * Retrieves or computes a value if it's not in the cache or has expired.
+  *
+  * @param key - The key to retrieve
+  * @param producer - Function to generate the value if not cached
+  * @param ttlMs - Optional custom TTL for the computed value
+  * @returns The cached or computed value
+  */
+  async getOrCompute(key, producer, ttlMs) {
+    const value = this.get(key);
+    if (value !== void 0) return value;
+    const newValue = await producer();
+    this.setWithTTL(key, newValue, ttlMs ?? this.ttlMs);
+    return newValue;
+  }
+  /**
+  * Checks if the key exists and hasn't expired.
+  *
+  * @param key - The key to check.
+  * @returns `true` if key exists and is valid, otherwise `false`.
+  */
+  has(key) {
+    return this.get(key) !== void 0;
+  }
+  /**
+  * Deletes a key from the cache.
+  *
+  * @param key - The key to delete.
+  * @returns `true` if the key existed and was removed, `false` otherwise.
+  */
+  delete(key) {
+    return this.cache.delete(key);
+  }
+  /**
+  * Clears all entries from the cache.
+  */
+  clear() {
+    this.cache.clear();
+  }
+  /**
+  * Returns the number of entries currently in the cache (includes expired entries until next access/cleanup).
+  *
+  * @returns Number of items in the cache (may include expired keys).
+  */
+  size() {
+    return this.cache.size;
+  }
+  /**
+  * Set multiple key-value pairs at once with the default TTL.
+  *
+  * @param entries - Array of [key, value] tuples to set
+  */
+  setMany(entries) {
+    for (const [key, value] of entries) {
+      this.set(key, value);
+    }
+  }
+  /**
+  * Get multiple values at once.
+  *
+  * @param keys - Array of keys to retrieve
+  * @returns Array of values (undefined for keys that don't exist or expired)
+  */
+  getMany(keys) {
+    return keys.map((key) => this.get(key));
+  }
+  /**
+  * Removes all expired entries from the cache.
+  *
+  * @returns Number of entries removed.
+  */
+  cleanup() {
+    let removed = 0;
+    const now = Date.now();
+    for (const [key, entry] of this.cache.entries()) {
+      if (now > entry.expiresAt) {
+        this.cache.delete(key);
+        removed++;
+      }
+    }
+    return removed;
+  }
+  /**
+  * Returns an iterator of all current valid [key, value] pairs.
+  *
+  * @returns IterableIterator<[K, V]>
+  */
+  *entries() {
+    for (const [key, entry] of this.cache.entries()) {
+      if (Date.now() <= entry.expiresAt) {
+        yield [
+          key,
+          entry.value
+        ];
+      }
+    }
+  }
+  /**
+  * Returns an iterator of all current valid keys.
+  *
+  * @returns IterableIterator<K>
+  */
+  *keys() {
+    for (const [key, entry] of this.cache.entries()) {
+      if (Date.now() <= entry.expiresAt) {
+        yield key;
+      }
+    }
+  }
+  /**
+  * Returns an iterator of all current valid values.
+  *
+  * @returns IterableIterator<V>
+  */
+  *values() {
+    for (const entry of this.cache.values()) {
+      if (Date.now() <= entry.expiresAt) {
+        yield entry.value;
+      }
+    }
+  }
+  /**
+  * Extends the expiration of a key by the specified time or default TTL.
+  *
+  * @param key - The key to refresh
+  * @param ttlMs - Optional new TTL in milliseconds (uses default if not specified)
+  * @returns true if the key was found and refreshed, false otherwise
+  */
+  refresh(key, ttlMs) {
+    const entry = this.cache.get(key);
+    if (!entry) return false;
+    const now = Date.now();
+    if (now > entry.expiresAt) {
+      this.cache.delete(key);
+      return false;
+    }
+    entry.expiresAt = now + (ttlMs ?? this.ttlMs);
+    entry.lastAccessed = now;
+    return true;
+  }
+  /**
+  * Returns a snapshot of cache stats.
+  *
+  * @returns Object containing cache statistics
+  */
+  stats() {
+    const now = Date.now();
+    let expired = 0;
+    let valid = 0;
+    for (const entry of this.cache.values()) {
+      if (now > entry.expiresAt) {
+        expired++;
+      } else {
+        valid++;
+      }
+    }
+    return {
+      size: this.cache.size,
+      validEntries: valid,
+      expiredEntries: expired,
+      maxSize: this.maxSize
+    };
+  }
+  /**
+  * Stop the auto-cleanup interval if it's running.
+  */
+  destroy() {
+    if (this.cleanupInterval) {
+      clearInterval(this.cleanupInterval);
+      this.cleanupInterval = void 0;
+    }
+  }
+  /**
+  * Evict the least recently used entry from the cache.
+  * @private
+  */
+  evictLRU() {
+    const now = Date.now();
+    for (const [key, entry] of Array.from(this.cache.entries())) {
+      if (now > entry.expiresAt) {
+        this.cache.delete(key);
+      }
+    }
+    while (this.maxSize && this.cache.size > this.maxSize) {
+      const oldestKey = this.cache.keys().next().value;
+      this.cache.delete(oldestKey);
+    }
+  }
+};
+
+export { TTLCache };

package/config/index.cjs

@@ -0,0 +1,150 @@
+/*
+ * The MIT License
+ * 
+ * Copyright (c) 2025 Catbee Technologies. https://catbee.in/license
+ * 
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ * 
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ * 
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+'use strict';
+
+var env = require('@catbee/utils/env');
+var id = require('@catbee/utils/id');
+var obj = require('@catbee/utils/obj');
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var defaultServerConfig = {
+  port: env.Env.getNumber("SERVER_PORT", 0) || env.Env.getNumber("PORT", 3e3),
+  host: env.Env.get("SERVER_HOST", "") || env.Env.get("HOST", "0.0.0.0"),
+  cors: env.Env.getBoolean("SERVER_CORS_ENABLE", false) ? {} : false,
+  helmet: env.Env.getBoolean("SERVER_HELMET_ENABLE", false) ? {} : false,
+  compression: env.Env.getBoolean("SERVER_COMPRESSION_ENABLE", false) ? {} : false,
+  bodyParser: {
+    json: {
+      limit: env.Env.get("SERVER_BODY_PARSER_JSON_LIMIT", "1mb")
+    },
+    urlencoded: {
+      extended: true,
+      limit: env.Env.get("SERVER_BODY_PARSER_URLENCODED_LIMIT", "1mb")
+    }
+  },
+  cookieParser: env.Env.getBoolean("SERVER_COOKIE_PARSER_ENABLE", false) ? {} : false,
+  isMicroservice: env.Env.getBoolean("SERVER_IS_MICROSERVICE", false),
+  appName: env.Env.get("SERVER_APP_NAME", env.Env.get("npm_package_name", "catbee_server")),
+  globalHeaders: env.Env.getJSON("SERVER_GLOBAL_HEADERS", {}),
+  rateLimit: {
+    enable: env.Env.getBoolean("SERVER_RATE_LIMIT_ENABLE", false),
+    windowMs: env.Env.getDuration("SERVER_RATE_LIMIT_WINDOW_MS", 15 * 60 * 1e3),
+    max: env.Env.getNumber("SERVER_RATE_LIMIT_MAX", 100),
+    message: env.Env.get("SERVER_RATE_LIMIT_MESSAGE", "Too many requests, please try again later."),
+    standardHeaders: env.Env.getBoolean("SERVER_RATE_LIMIT_STANDARD_HEADERS", true),
+    legacyHeaders: env.Env.getBoolean("SERVER_RATE_LIMIT_LEGACY_HEADERS", false)
+  },
+  requestLogging: {
+    enable: env.Env.getBoolean("SERVER_REQUEST_LOGGING_ENABLE", env.Env.isDev()),
+    ignorePaths: /* @__PURE__ */ __name((req, _res) => {
+      const skipPaths = [
+        "/healthz",
+        "/favicon.ico",
+        "/metrics",
+        "/docs",
+        "/.well-known"
+      ];
+      return skipPaths.some((path) => req.path.startsWith(path));
+    }, "ignorePaths"),
+    skipNotFoundRoutes: env.Env.getBoolean("SERVER_REQUEST_LOGGING_SKIP_NOT_FOUND_ROUTES", true)
+  },
+  trustProxy: env.Env.getBoolean("SERVER_TRUST_PROXY_ENABLE", false),
+  openApi: {
+    enable: env.Env.getBoolean("SERVER_OPENAPI_ENABLE", false),
+    mountPath: env.Env.get("SERVER_OPENAPI_MOUNT_PATH", "/docs"),
+    verbose: env.Env.getBoolean("SERVER_OPENAPI_VERBOSE", false),
+    withGlobalPrefix: env.Env.getBoolean("SERVER_OPENAPI_WITH_GLOBAL_PREFIX", false)
+  },
+  healthCheck: {
+    path: env.Env.get("SERVER_HEALTH_CHECK_PATH", "/healthz"),
+    detailed: env.Env.getBoolean("SERVER_HEALTH_CHECK_DETAILED_OUTPUT", true),
+    withGlobalPrefix: env.Env.getBoolean("SERVER_HEALTH_CHECK_WITH_GLOBAL_PREFIX", false)
+  },
+  requestTimeout: env.Env.getDuration("SERVER_REQUEST_TIMEOUT_MS", 0),
+  responseTime: {
+    enable: env.Env.getBoolean("SERVER_RESPONSE_TIME_ENABLE", false),
+    addHeader: env.Env.getBoolean("SERVER_RESPONSE_TIME_ADD_HEADER", true),
+    logOnComplete: env.Env.getBoolean("SERVER_RESPONSE_TIME_LOG_ON_COMPLETE", false)
+  },
+  requestId: {
+    headerName: env.Env.get("SERVER_REQUEST_ID_HEADER_NAME", "x-request-id"),
+    exposeHeader: env.Env.getBoolean("SERVER_REQUEST_ID_EXPOSE_HEADER", true),
+    generator: /* @__PURE__ */ __name(() => id.uuid(), "generator")
+  },
+  metrics: {
+    enable: env.Env.getBoolean("SERVER_METRICS_ENABLE", false),
+    path: env.Env.get("SERVER_METRICS_PATH", "/metrics"),
+    withGlobalPrefix: env.Env.getBoolean("SERVER_METRICS_WITH_GLOBAL_PREFIX", false)
+  },
+  serviceVersion: {
+    enable: env.Env.getBoolean("SERVER_SERVICE_VERSION_ENABLE", false),
+    headerName: env.Env.get("SERVER_SERVICE_VERSION_HEADER_NAME", "x-service-version"),
+    version: env.Env.get("SERVER_SERVICE_VERSION", "0.0.0")
+  },
+  skipHealthz: env.Env.getBoolean("SERVER_SKIP_HEALTHZ", false)
+};
+var defaultCatbeeConfig = {
+  logger: {
+    level: env.Env.get("LOGGER_LEVEL", env.Env.isDev() || env.Env.isTest() ? "debug" : "info"),
+    name: env.Env.get("LOGGER_NAME", env.Env.get("npm_package_name", "@catbee/utils")),
+    pretty: env.Env.getBoolean("LOGGER_PRETTY", false),
+    colorize: env.Env.getBoolean("LOGGER_PRETTY_COLORIZE", true),
+    singleLine: env.Env.getBoolean("LOGGER_PRETTY_SINGLE_LINE", false),
+    dir: env.Env.getPath("LOGGER_DIR", "", {
+      mustExist: false
+    })
+  },
+  cache: {
+    defaultTtl: env.Env.getNumber("CACHE_DEFAULT_TTL_SECONDS", 3600) * 1e3
+  },
+  server: defaultServerConfig
+};
+var _config = obj.deepClone(defaultCatbeeConfig);
+function getCatbeeGlobalConfig() {
+  return obj.deepClone(_config);
+}
+__name(getCatbeeGlobalConfig, "getCatbeeGlobalConfig");
+var getConfig = getCatbeeGlobalConfig;
+function setCatbeeGlobalConfig(value) {
+  _config = obj.deepObjMerge(_config, value);
+}
+__name(setCatbeeGlobalConfig, "setCatbeeGlobalConfig");
+var setConfig = setCatbeeGlobalConfig;
+function setCatbeeServerGlobalConfig(value) {
+  _config.server = obj.deepObjMerge(_config.server, value);
+}
+__name(setCatbeeServerGlobalConfig, "setCatbeeServerGlobalConfig");
+function getCatbeeServerGlobalConfig() {
+  return getCatbeeGlobalConfig().server;
+}
+__name(getCatbeeServerGlobalConfig, "getCatbeeServerGlobalConfig");
+
+exports.getCatbeeGlobalConfig = getCatbeeGlobalConfig;
+exports.getCatbeeServerGlobalConfig = getCatbeeServerGlobalConfig;
+exports.getConfig = getConfig;
+exports.setCatbeeGlobalConfig = setCatbeeGlobalConfig;
+exports.setCatbeeServerGlobalConfig = setCatbeeServerGlobalConfig;
+exports.setConfig = setConfig;

package/config/index.d.ts

@@ -0,0 +1,88 @@
+/*
+ * The MIT License
+ * 
+ * Copyright (c) 2025 Catbee Technologies. https://catbee.in/license
+ * 
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ * 
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ * 
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+import { CatbeeConfig, CatbeeGlobalServerConfig } from '@catbee/utils/types';
+import { Logger } from '@catbee/utils/logger';
+
+/**
+ * Extends Express Request interface to add request ID tracking.
+ * Added by requestId middleware during request processing.
+ */
+declare global {
+    namespace Express {
+        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;
+        }
+    }
+}
+/**
+ * Gets the global Catbee configuration.
+ *
+ * @returns The current Catbee configuration.
+ */
+declare function getCatbeeGlobalConfig(): CatbeeConfig;
+/**
+ * Gets the global Catbee configuration.
+ *
+ * @deprecated Use `getCatbeeGlobalConfig` from `@catbee/utils/config` instead.
+ * @alias getCatbeeGlobalConfig
+ * @returns The current Catbee configuration.
+ */
+declare const getConfig: typeof getCatbeeGlobalConfig;
+/**
+ * Sets the global Catbee configuration.
+ * Merges the provided partial configuration with the existing one.
+ *
+ * @param value - Partial Catbee configuration to set
+ */
+declare function setCatbeeGlobalConfig(value: Partial<CatbeeConfig>): void;
+/**
+ * Sets the global Catbee configuration.
+ * Merges the provided partial configuration with the existing one.
+ *
+ * @deprecated Use `setCatbeeGlobalConfig` from `@catbee/utils/config` instead.
+ * @alias setCatbeeGlobalConfig
+ * @param value - Partial Catbee configuration to set
+ */
+declare const setConfig: typeof setCatbeeGlobalConfig;
+/**
+ * Sets the global Catbee server configuration.
+ * Merges the provided partial server configuration with the existing one.
+ *
+ * @param value - Partial Catbee server configuration to set
+ */
+declare function setCatbeeServerGlobalConfig(value: Partial<CatbeeGlobalServerConfig>): void;
+/**
+ * Gets the global Catbee server configuration.
+ *
+ * @returns The current Catbee server configuration.
+ */
+declare function getCatbeeServerGlobalConfig(): CatbeeGlobalServerConfig;
+
+export { getCatbeeGlobalConfig, getCatbeeServerGlobalConfig, getConfig, setCatbeeGlobalConfig, setCatbeeServerGlobalConfig, setConfig };

package/config/index.mjs

@@ -0,0 +1,143 @@
+/*
+ * The MIT License
+ * 
+ * Copyright (c) 2025 Catbee Technologies. https://catbee.in/license
+ * 
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ * 
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ * 
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+import { Env } from '@catbee/utils/env';
+import { uuid } from '@catbee/utils/id';
+import { deepClone, deepObjMerge } from '@catbee/utils/obj';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var defaultServerConfig = {
+  port: Env.getNumber("SERVER_PORT", 0) || Env.getNumber("PORT", 3e3),
+  host: Env.get("SERVER_HOST", "") || Env.get("HOST", "0.0.0.0"),
+  cors: Env.getBoolean("SERVER_CORS_ENABLE", false) ? {} : false,
+  helmet: Env.getBoolean("SERVER_HELMET_ENABLE", false) ? {} : false,
+  compression: Env.getBoolean("SERVER_COMPRESSION_ENABLE", false) ? {} : false,
+  bodyParser: {
+    json: {
+      limit: Env.get("SERVER_BODY_PARSER_JSON_LIMIT", "1mb")
+    },
+    urlencoded: {
+      extended: true,
+      limit: Env.get("SERVER_BODY_PARSER_URLENCODED_LIMIT", "1mb")
+    }
+  },
+  cookieParser: Env.getBoolean("SERVER_COOKIE_PARSER_ENABLE", false) ? {} : false,
+  isMicroservice: Env.getBoolean("SERVER_IS_MICROSERVICE", false),
+  appName: Env.get("SERVER_APP_NAME", Env.get("npm_package_name", "catbee_server")),
+  globalHeaders: Env.getJSON("SERVER_GLOBAL_HEADERS", {}),
+  rateLimit: {
+    enable: Env.getBoolean("SERVER_RATE_LIMIT_ENABLE", false),
+    windowMs: Env.getDuration("SERVER_RATE_LIMIT_WINDOW_MS", 15 * 60 * 1e3),
+    max: Env.getNumber("SERVER_RATE_LIMIT_MAX", 100),
+    message: Env.get("SERVER_RATE_LIMIT_MESSAGE", "Too many requests, please try again later."),
+    standardHeaders: Env.getBoolean("SERVER_RATE_LIMIT_STANDARD_HEADERS", true),
+    legacyHeaders: Env.getBoolean("SERVER_RATE_LIMIT_LEGACY_HEADERS", false)
+  },
+  requestLogging: {
+    enable: Env.getBoolean("SERVER_REQUEST_LOGGING_ENABLE", Env.isDev()),
+    ignorePaths: /* @__PURE__ */ __name((req, _res) => {
+      const skipPaths = [
+        "/healthz",
+        "/favicon.ico",
+        "/metrics",
+        "/docs",
+        "/.well-known"
+      ];
+      return skipPaths.some((path) => req.path.startsWith(path));
+    }, "ignorePaths"),
+    skipNotFoundRoutes: Env.getBoolean("SERVER_REQUEST_LOGGING_SKIP_NOT_FOUND_ROUTES", true)
+  },
+  trustProxy: Env.getBoolean("SERVER_TRUST_PROXY_ENABLE", false),
+  openApi: {
+    enable: Env.getBoolean("SERVER_OPENAPI_ENABLE", false),
+    mountPath: Env.get("SERVER_OPENAPI_MOUNT_PATH", "/docs"),
+    verbose: Env.getBoolean("SERVER_OPENAPI_VERBOSE", false),
+    withGlobalPrefix: Env.getBoolean("SERVER_OPENAPI_WITH_GLOBAL_PREFIX", false)
+  },
+  healthCheck: {
+    path: Env.get("SERVER_HEALTH_CHECK_PATH", "/healthz"),
+    detailed: Env.getBoolean("SERVER_HEALTH_CHECK_DETAILED_OUTPUT", true),
+    withGlobalPrefix: Env.getBoolean("SERVER_HEALTH_CHECK_WITH_GLOBAL_PREFIX", false)
+  },
+  requestTimeout: Env.getDuration("SERVER_REQUEST_TIMEOUT_MS", 0),
+  responseTime: {
+    enable: Env.getBoolean("SERVER_RESPONSE_TIME_ENABLE", false),
+    addHeader: Env.getBoolean("SERVER_RESPONSE_TIME_ADD_HEADER", true),
+    logOnComplete: Env.getBoolean("SERVER_RESPONSE_TIME_LOG_ON_COMPLETE", false)
+  },
+  requestId: {
+    headerName: Env.get("SERVER_REQUEST_ID_HEADER_NAME", "x-request-id"),
+    exposeHeader: Env.getBoolean("SERVER_REQUEST_ID_EXPOSE_HEADER", true),
+    generator: /* @__PURE__ */ __name(() => uuid(), "generator")
+  },
+  metrics: {
+    enable: Env.getBoolean("SERVER_METRICS_ENABLE", false),
+    path: Env.get("SERVER_METRICS_PATH", "/metrics"),
+    withGlobalPrefix: Env.getBoolean("SERVER_METRICS_WITH_GLOBAL_PREFIX", false)
+  },
+  serviceVersion: {
+    enable: Env.getBoolean("SERVER_SERVICE_VERSION_ENABLE", false),
+    headerName: Env.get("SERVER_SERVICE_VERSION_HEADER_NAME", "x-service-version"),
+    version: Env.get("SERVER_SERVICE_VERSION", "0.0.0")
+  },
+  skipHealthz: Env.getBoolean("SERVER_SKIP_HEALTHZ", false)
+};
+var defaultCatbeeConfig = {
+  logger: {
+    level: Env.get("LOGGER_LEVEL", Env.isDev() || Env.isTest() ? "debug" : "info"),
+    name: Env.get("LOGGER_NAME", Env.get("npm_package_name", "@catbee/utils")),
+    pretty: Env.getBoolean("LOGGER_PRETTY", false),
+    colorize: Env.getBoolean("LOGGER_PRETTY_COLORIZE", true),
+    singleLine: Env.getBoolean("LOGGER_PRETTY_SINGLE_LINE", false),
+    dir: Env.getPath("LOGGER_DIR", "", {
+      mustExist: false
+    })
+  },
+  cache: {
+    defaultTtl: Env.getNumber("CACHE_DEFAULT_TTL_SECONDS", 3600) * 1e3
+  },
+  server: defaultServerConfig
+};
+var _config = deepClone(defaultCatbeeConfig);
+function getCatbeeGlobalConfig() {
+  return deepClone(_config);
+}
+__name(getCatbeeGlobalConfig, "getCatbeeGlobalConfig");
+var getConfig = getCatbeeGlobalConfig;
+function setCatbeeGlobalConfig(value) {
+  _config = deepObjMerge(_config, value);
+}
+__name(setCatbeeGlobalConfig, "setCatbeeGlobalConfig");
+var setConfig = setCatbeeGlobalConfig;
+function setCatbeeServerGlobalConfig(value) {
+  _config.server = deepObjMerge(_config.server, value);
+}
+__name(setCatbeeServerGlobalConfig, "setCatbeeServerGlobalConfig");
+function getCatbeeServerGlobalConfig() {
+  return getCatbeeGlobalConfig().server;
+}
+__name(getCatbeeServerGlobalConfig, "getCatbeeServerGlobalConfig");
+
+export { getCatbeeGlobalConfig, getCatbeeServerGlobalConfig, getConfig, setCatbeeGlobalConfig, setCatbeeServerGlobalConfig, setConfig };