@catbee/utils 0.0.8-rc.1 → 0.0.8-rc.3

package/build/{esnext → cjs}/config.d.ts

@@ -119,4 +119,3 @@ export declare function setConfig(value: Partial<typeof config>): void;
  * @returns The current configuration object.
  */
 export declare function getConfig(): typeof config;
-//# sourceMappingURL=config.d.ts.map

package/build/{src → cjs}/config.js

@@ -135,4 +135,3 @@ function setConfig(value) {
 function getConfig() {
     return exports.config;
 }
-//# sourceMappingURL=config.js.map

package/build/{esnext → cjs}/index.d.ts

@@ -24,4 +24,3 @@ export * from './types/server';
 export * from './types/api-response';
 export * from './servers/server';
 export * from './servers/server.builder';
-//# sourceMappingURL=index.d.ts.map

package/build/{src → cjs}/index.js

@@ -66,4 +66,3 @@ __exportStar(require("./types/server"), exports);
 __exportStar(require("./types/api-response"), exports);
 __exportStar(require("./servers/server"), exports);
 __exportStar(require("./servers/server.builder"), exports);
-//# sourceMappingURL=index.js.map

package/build/{esnext → cjs}/servers/server.builder.d.ts

@@ -505,4 +505,3 @@ export declare class ServerConfigBuilder {
     private mergeConfig;
     private setEnabled;
 }
-//# sourceMappingURL=server.builder.d.ts.map

package/build/{src → cjs}/servers/server.builder.js

@@ -45,9 +45,7 @@ const validate_utils_1 = require("../utils/validate.utils");
  */
 exports.BUILD_MARKER = Symbol.for('catbee.express.server.build');
 class ServerConfigBuilder {
-    constructor() {
-        this.config = {};
-    }
+    config = {};
     /**
      * Validates that a port number is valid and usable.
      *
@@ -368,7 +366,7 @@ class ServerConfigBuilder {
      * @returns The builder instance for chaining
      */
     enableOpenApi(filePath, opts = {}) {
-        this.setEnabled('openApi', true, Object.assign({ filePath }, opts));
+        this.setEnabled('openApi', true, { filePath, ...opts });
         return this;
     }
     /**
@@ -498,8 +496,7 @@ class ServerConfigBuilder {
      * ```
      */
     withBodyParser(opts) {
-        var _a;
-        this.config.bodyParser = (0, obj_utils_1.deepObjMerge)({}, (_a = this.config.bodyParser) !== null && _a !== void 0 ? _a : {}, opts);
+        this.config.bodyParser = (0, obj_utils_1.deepObjMerge)({}, this.config.bodyParser ?? {}, opts);
         return this;
     }
     /**
@@ -541,10 +538,9 @@ class ServerConfigBuilder {
      * ```
      */
     withStaticFolder(folder) {
-        var _a;
         if (!folder.path)
             throw new Error('Static folder requires a path');
-        const folders = [...((_a = this.config.staticFolders) !== null && _a !== void 0 ? _a : []), folder];
+        const folders = [...(this.config.staticFolders ?? []), folder];
         this.config.staticFolders = Array.from(new Map(folders.map(f => [f.path, f])).values());
         return this;
     }
@@ -638,13 +634,15 @@ class ServerConfigBuilder {
      * ```
      */
     build() {
-        var _a;
         const config = (0, obj_utils_1.deepObjMerge)({}, config_1.defaultServerConfig, this.config);
         // Common validation
-        if (((_a = config.openApi) === null || _a === void 0 ? void 0 : _a.enable) && !config.openApi.filePath) {
+        if (config.openApi?.enable && !config.openApi.filePath) {
             throw new Error('OpenAPI is enabled but no filePath is specified');
         }
-        return Object.freeze(Object.assign(Object.assign({}, config), { [exports.BUILD_MARKER]: true }));
+        return Object.freeze({
+            ...config,
+            [exports.BUILD_MARKER]: true
+        });
     }
     mergeConfig(key, value) {
         const current = typeof this.config[key] === 'object' && this.config[key] !== null
@@ -653,9 +651,8 @@ class ServerConfigBuilder {
         this.config[key] = (0, obj_utils_1.deepObjMerge)({}, current, value);
     }
     setEnabled(key, enable, overrides = {}) {
-        this.mergeConfig(key, Object.assign(Object.assign({}, overrides), { enable }));
+        this.mergeConfig(key, { ...overrides, enable });
         return this;
     }
 }
 exports.ServerConfigBuilder = ServerConfigBuilder;
-//# sourceMappingURL=server.builder.js.map

package/build/{src → cjs}/servers/server.d.ts

@@ -253,4 +253,3 @@ export declare class ExpressServer {
     private static isBuiltServerConfig;
     private static optionalRequire;
 }
-//# sourceMappingURL=server.d.ts.map

package/build/{src → cjs}/servers/server.js

@@ -57,6 +57,38 @@ const validate_utils_1 = require("../utils/validate.utils");
  * Includes K8s readiness probes and zero-downtime support.
  */
 class ExpressServer {
+    /** Prometheus client registry for metrics collection */
+    register = null;
+    /** HTTP server instance (null when not running) */
+    server = null;
+    /** Merged configuration with defaults applied */
+    config;
+    /** User-defined lifecycle hooks */
+    hooks;
+    /** Global API prefix (from config) */
+    globalPrefix;
+    /** Internal fallback router */
+    rootRouter;
+    /** User-supplied router */
+    externalRouter;
+    /** Internal Express app instance */
+    app;
+    /** Set of active WebSocket connections */
+    connections = new Set();
+    /** Flag indicating if the server is shutting down */
+    isShuttingDown = false;
+    /**
+     * Collection of registered health check functions.
+     * These are executed when the health check endpoint is accessed.
+     */
+    healthChecks = [];
+    /** Prometheus metrics for monitoring */
+    requestCounter;
+    routeTimings;
+    requestSizes;
+    clientIPs;
+    /** Promise that resolves when initialization (middleware + routes) is complete */
+    initPromise;
     /**
      * Initializes server with intelligent defaults and security best practices.
      * All settings can be customized via config and hooks.
@@ -75,20 +107,6 @@ class ExpressServer {
      * - Request tracing
      */
     constructor(config, hooks = {}) {
-        var _a, _b, _c;
-        /** Prometheus client registry for metrics collection */
-        this.register = null;
-        /** HTTP server instance (null when not running) */
-        this.server = null;
-        /** Set of active WebSocket connections */
-        this.connections = new Set();
-        /** Flag indicating if the server is shutting down */
-        this.isShuttingDown = false;
-        /**
-         * Collection of registered health check functions.
-         * These are executed when the health check endpoint is accessed.
-         */
-        this.healthChecks = [];
         if (ExpressServer.isBuiltServerConfig(config)) {
             this.config = config;
         }
@@ -102,7 +120,7 @@ class ExpressServer {
         }
         // Sanitize app name for metrics (replace invalid characters with underscore)
         const safeAppName = (this.config.appName || 'express_app').toLowerCase().replace(/[^a-z0-9_]/g, '_');
-        if ((_a = this.config.metrics) === null || _a === void 0 ? void 0 : _a.enable) {
+        if (this.config.metrics?.enable) {
             const client = ExpressServer.optionalRequire('prom-client');
             if (!client) {
                 (0, logger_utils_1.getLogger)().error({ command: 'npm install prom-client' }, 'prom-client is required for metrics but not installed. Please add it to your dependencies');
@@ -143,11 +161,11 @@ class ExpressServer {
             });
         }
         // Health checks
-        if ((_b = config.healthCheck) === null || _b === void 0 ? void 0 : _b.checks) {
+        if (config.healthCheck?.checks) {
             this.healthChecks.push(...config.healthCheck.checks);
         }
         // Set global prefix (normalize to empty string or "/prefix" without trailing slash)
-        this.globalPrefix = this.normalizePath((_c = this.config.globalPrefix) !== null && _c !== void 0 ? _c : '', false);
+        this.globalPrefix = this.normalizePath(this.config.globalPrefix ?? '', false);
         this.hooks = hooks;
         this.app = (0, express_1.default)();
         this.rootRouter = express_1.default.Router();
@@ -202,7 +220,6 @@ class ExpressServer {
      * 14. Custom response hooks
      */
     async setupMiddleware() {
-        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r;
         if (this.config.https) {
             await this.validateHttpsFiles();
         }
@@ -213,13 +230,13 @@ class ExpressServer {
         }
         // Request ID generation - must be first for proper tracing
         this.app.use((0, middleware_utils_1.requestId)({
-            headerName: (_a = this.config.requestId) === null || _a === void 0 ? void 0 : _a.headerName,
-            exposeHeader: (_b = this.config.requestId) === null || _b === void 0 ? void 0 : _b.exposeHeader,
-            generator: (_c = this.config.requestId) === null || _c === void 0 ? void 0 : _c.generator
+            headerName: this.config.requestId?.headerName,
+            exposeHeader: this.config.requestId?.exposeHeader,
+            generator: this.config.requestId?.generator
         }));
         // Request context setup for logging correlation
         this.app.use((0, middleware_utils_1.setupRequestContext)({
-            headerName: (_d = this.config.requestId) === null || _d === void 0 ? void 0 : _d.headerName,
+            headerName: this.config.requestId?.headerName,
             autoLog: false
         }));
         // Early shutdown-awareness middleware (lets load balancers drain connections gracefully)
@@ -258,7 +275,6 @@ class ExpressServer {
         }
         // Global headers
         this.app.use((_req, res, next) => {
-            var _a, _b, _c, _d;
             if (this.config.globalHeaders) {
                 for (const key in this.config.globalHeaders) {
                     const value = this.config.globalHeaders[key];
@@ -268,11 +284,11 @@ class ExpressServer {
             if (this.config.isMicroservice) {
                 res.setHeader('X-Microservice', this.config.appName || 'express_app');
             }
-            if ((_a = this.config.serviceVersion) === null || _a === void 0 ? void 0 : _a.enable) {
-                const version = typeof ((_b = this.config.serviceVersion) === null || _b === void 0 ? void 0 : _b.version) === 'function'
+            if (this.config.serviceVersion?.enable) {
+                const version = typeof this.config.serviceVersion?.version === 'function'
                     ? this.config.serviceVersion.version()
-                    : (_c = this.config.serviceVersion) === null || _c === void 0 ? void 0 : _c.version;
-                res.setHeader(((_d = this.config.serviceVersion) === null || _d === void 0 ? void 0 : _d.headerName) || 'x-service-version', version || '0.0.0');
+                    : this.config.serviceVersion?.version;
+                res.setHeader(this.config.serviceVersion?.headerName || 'x-service-version', version || '0.0.0');
             }
             next();
         });
@@ -281,43 +297,41 @@ class ExpressServer {
             this.app.use((0, middleware_utils_1.timeout)(this.config.requestTimeout));
         }
         // Response time tracking for performance monitoring
-        if ((_e = this.config.responseTime) === null || _e === void 0 ? void 0 : _e.enable) {
+        if (this.config.responseTime?.enable) {
             this.app.use((0, middleware_utils_1.responseTime)({
                 addHeader: this.config.responseTime.addHeader,
                 logOnComplete: this.config.responseTime.logOnComplete
             }));
         }
         // Rate limiting should be early to prevent unnecessary processing
-        if ((_f = this.config.rateLimit) === null || _f === void 0 ? void 0 : _f.enable) {
+        if (this.config.rateLimit?.enable) {
             const rateLimit = ExpressServer.optionalRequire('express-rate-limit');
             if (!rateLimit) {
                 (0, logger_utils_1.getLogger)().error({ command: 'npm install express-rate-limit' }, 'express-rate-limit is required but not installed. Please add it to your dependencies');
                 process.exit(1);
             }
             this.app.use(rateLimit({
-                windowMs: (_g = this.config.rateLimit.windowMs) !== null && _g !== void 0 ? _g : 15 * 60 * 1000,
-                max: (_h = this.config.rateLimit.max) !== null && _h !== void 0 ? _h : 100,
+                windowMs: this.config.rateLimit.windowMs ?? 15 * 60 * 1000,
+                max: this.config.rateLimit.max ?? 100,
                 handler: (req, res) => {
-                    var _a;
                     const status = http_status_codes_1.HttpStatusCodes.TOO_MANY_REQUESTS;
-                    const response = (0, response_utils_1.createFinalErrorResponse)(req, status, ((_a = this.config.rateLimit) === null || _a === void 0 ? void 0 : _a.message) || 'Too many requests');
+                    const response = (0, response_utils_1.createFinalErrorResponse)(req, status, this.config.rateLimit?.message || 'Too many requests');
                     res.status(status).json(response);
                 },
-                standardHeaders: (_j = this.config.rateLimit.standardHeaders) !== null && _j !== void 0 ? _j : true,
-                legacyHeaders: (_k = this.config.rateLimit.legacyHeaders) !== null && _k !== void 0 ? _k : false
+                standardHeaders: this.config.rateLimit.standardHeaders ?? true,
+                legacyHeaders: this.config.rateLimit.legacyHeaders ?? false
             }));
         }
         // Request logging with filtering
-        if ((_l = this.config.requestLogging) === null || _l === void 0 ? void 0 : _l.enable) {
+        if (this.config.requestLogging?.enable) {
             this.app.use((req, res, next) => {
-                var _a, _b, _c, _d, _e, _f;
-                if (typeof ((_a = this.config.requestLogging) === null || _a === void 0 ? void 0 : _a.ignorePaths) === 'function') {
-                    const skip = (_c = (_b = this.config.requestLogging) === null || _b === void 0 ? void 0 : _b.ignorePaths) === null || _c === void 0 ? void 0 : _c.call(_b, req, res);
+                if (typeof this.config.requestLogging?.ignorePaths === 'function') {
+                    const skip = this.config.requestLogging?.ignorePaths?.(req, res);
                     if (skip)
                         return next();
                 }
-                else if (Array.isArray((_d = this.config.requestLogging) === null || _d === void 0 ? void 0 : _d.ignorePaths)) {
-                    const skip = (_f = (_e = this.config.requestLogging) === null || _e === void 0 ? void 0 : _e.ignorePaths) === null || _f === void 0 ? void 0 : _f.includes(req.path);
+                else if (Array.isArray(this.config.requestLogging?.ignorePaths)) {
+                    const skip = this.config.requestLogging?.ignorePaths?.includes(req.path);
                     if (skip)
                         return next();
                 }
@@ -353,8 +367,7 @@ class ExpressServer {
         // Static file serving (do NOT normalize filesystem path; only normalize route)
         if (this.config.staticFolders) {
             this.config.staticFolders.forEach(folder => {
-                var _a;
-                this.app.use(this.normalizePath((_a = folder.path) !== null && _a !== void 0 ? _a : '/'), express_1.default.static(folder.directory, {
+                this.app.use(this.normalizePath(folder.path ?? '/'), express_1.default.static(folder.directory, {
                     maxAge: folder.maxAge || 0,
                     etag: folder.etag !== false,
                     immutable: folder.immutable === true,
@@ -388,9 +401,9 @@ class ExpressServer {
             }
         }
         // OpenAPI docs via @scalar/express-api-reference
-        if ((_m = this.config.openApi) === null || _m === void 0 ? void 0 : _m.enable) {
+        if (this.config.openApi?.enable) {
             try {
-                const openApiMountPath = this.normalizePath((_o = this.config.openApi.mountPath) !== null && _o !== void 0 ? _o : '/docs', this.config.openApi.withGlobalPrefix);
+                const openApiMountPath = this.normalizePath(this.config.openApi.mountPath ?? '/docs', this.config.openApi.withGlobalPrefix);
                 const openApiFilePath = this.config.openApi.filePath;
                 if (!openApiFilePath) {
                     (0, logger_utils_1.getLogger)().error('OpenAPI file path is required');
@@ -401,7 +414,7 @@ class ExpressServer {
                     (0, logger_utils_1.getLogger)().error(`OpenAPI spec file not found at ${openApiFilePath}`);
                     process.exit(1);
                 }
-                if ((_p = this.config.openApi) === null || _p === void 0 ? void 0 : _p.verbose) {
+                if (this.config.openApi?.verbose) {
                     (0, logger_utils_1.getLogger)().info(`Mounting OpenAPI docs at ${openApiMountPath}`);
                     (0, logger_utils_1.getLogger)().info(`Using OpenAPI spec file at ${openApiFilePath}`);
                 }
@@ -415,7 +428,7 @@ class ExpressServer {
                         content: await fs_1.default.promises.readFile(openApiFilePath, 'utf8')
                     }
                 }));
-                if ((_q = this.config.openApi) === null || _q === void 0 ? void 0 : _q.verbose) {
+                if (this.config.openApi?.verbose) {
                     (0, logger_utils_1.getLogger)().info(`Mounted OpenAPI docs at ${openApiMountPath}`);
                 }
             }
@@ -427,32 +440,30 @@ class ExpressServer {
         if (this.hooks.onResponse) {
             this.app.use(this.globalPrefix, this.hooks.onResponse);
         }
-        if ((_r = this.config.metrics) === null || _r === void 0 ? void 0 : _r.enable) {
+        if (this.config.metrics?.enable) {
             // Add metrics tracking middleware
             this.app.use((req, res, next) => {
-                var _a, _b;
                 const start = process.hrtime();
                 // Track client IPs
-                (_a = this.clientIPs) === null || _a === void 0 ? void 0 : _a.inc({ ip: req.ip, method: req.method });
+                this.clientIPs?.inc({ ip: req.ip, method: req.method });
                 // Track request sizes (parse safely)
                 const cl = req.headers['content-length'];
                 if (cl) {
                     const size = Number(cl);
                     if (!Number.isNaN(size) && size >= 0) {
                         const route = this.normalizeRouteForMetrics(req, res);
-                        (_b = this.requestSizes) === null || _b === void 0 ? void 0 : _b.observe({ method: req.method, route }, size);
+                        this.requestSizes?.observe({ method: req.method, route }, size);
                     }
                 }
                 res.once('finish', () => {
-                    var _a, _b;
                     const [seconds, nanoseconds] = process.hrtime(start);
                     const finalRoute = this.normalizeRouteForMetrics(req, res);
-                    (_a = this.requestCounter) === null || _a === void 0 ? void 0 : _a.inc({
+                    this.requestCounter?.inc({
                         method: req.method,
                         route: finalRoute,
                         status: res.statusCode.toString()
                     });
-                    (_b = this.routeTimings) === null || _b === void 0 ? void 0 : _b.observe({
+                    this.routeTimings?.observe({
                         method: req.method,
                         route: finalRoute,
                         status: res.statusCode.toString()
@@ -472,11 +483,9 @@ class ExpressServer {
      * 4. Error handler
      */
     async setupRoutes() {
-        var _a, _b, _c, _d, _e;
         // Health check endpoint
-        const healthCheckPath = this.normalizePath(((_a = this.config.healthCheck) === null || _a === void 0 ? void 0 : _a.path) || '/healthz', (_b = this.config.healthCheck) === null || _b === void 0 ? void 0 : _b.withGlobalPrefix);
+        const healthCheckPath = this.normalizePath(this.config.healthCheck?.path || '/healthz', this.config.healthCheck?.withGlobalPrefix);
         this.app.get(healthCheckPath, async (_req, res) => {
-            var _a;
             try {
                 if (!this.healthChecks.length) {
                     return res.status(http_status_codes_1.HttpStatusCodes.OK).json(new response_utils_1.SuccessResponse('OK'));
@@ -500,19 +509,19 @@ class ExpressServer {
                 const response = new response_utils_1.SuccessResponse(allOk ? 'OK' : 'Service unavailable');
                 if (!allOk)
                     response.error = true;
-                if ((_a = this.config.healthCheck) === null || _a === void 0 ? void 0 : _a.detailed)
+                if (this.config.healthCheck?.detailed)
                     response.data = { checks: results };
                 return res.status(status).json(response);
             }
-            catch (_b) {
+            catch {
                 return res
                     .status(http_status_codes_1.HttpStatusCodes.INTERNAL_SERVER_ERROR)
                     .json(new exception_utils_1.InternalServerErrorException('Health check failed'));
             }
         });
         // Metrics endpoint
-        if ((_c = this.config.metrics) === null || _c === void 0 ? void 0 : _c.enable) {
-            const metricsPath = this.normalizePath((_d = this.config.metrics.path) !== null && _d !== void 0 ? _d : '/metrics', (_e = this.config.metrics) === null || _e === void 0 ? void 0 : _e.withGlobalPrefix);
+        if (this.config.metrics?.enable) {
+            const metricsPath = this.normalizePath(this.config.metrics.path ?? '/metrics', this.config.metrics?.withGlobalPrefix);
             this.app.get(metricsPath, async (_req, res) => {
                 res.set('Content-Type', this.register.contentType);
                 res.end(await this.register.metrics());
@@ -529,12 +538,11 @@ class ExpressServer {
         });
         // Global error handler (must be the last middleware)
         this.app.use((err, req, res, next) => {
-            var _a;
             // Check if this is a 404 error that should be handled with special logging rules
             const isNotFoundError = err instanceof exception_utils_2.NotFoundException;
             const shouldSkipLogging = !this.hooks.onError &&
                 isNotFoundError &&
-                ((_a = this.config.requestLogging) === null || _a === void 0 ? void 0 : _a.enable) &&
+                this.config.requestLogging?.enable &&
                 this.config.requestLogging.skipNotFoundRoutes === true;
             if (this.hooks.onError) {
                 // Use custom error handler if provided
@@ -612,17 +620,16 @@ class ExpressServer {
                     this.config.port,
                     this.config.host,
                     async () => {
-                        var _a, _b, _c;
                         const protocol = this.config.https ? 'https' : 'http';
                         const url = `${protocol}://${this.config.host}:${this.config.port}`;
                         (0, logger_utils_1.getLogger)().info(`Server running on ${url}`);
-                        if ((_a = this.config.healthCheck) === null || _a === void 0 ? void 0 : _a.path) {
+                        if (this.config.healthCheck?.path) {
                             (0, logger_utils_1.getLogger)().info(`Health check available at ${url}${this.normalizePath(this.config.healthCheck.path, this.config.healthCheck.withGlobalPrefix)}`);
                         }
-                        if (((_b = this.config.metrics) === null || _b === void 0 ? void 0 : _b.enable) && this.config.metrics.path) {
+                        if (this.config.metrics?.enable && this.config.metrics.path) {
                             (0, logger_utils_1.getLogger)().info(`Metrics available at ${url}${this.normalizePath(this.config.metrics.path, this.config.metrics.withGlobalPrefix)}`);
                         }
-                        if ((_c = this.config.openApi) === null || _c === void 0 ? void 0 : _c.enable) {
+                        if (this.config.openApi?.enable) {
                             (0, logger_utils_1.getLogger)().info(`API docs available at ${url}${this.normalizePath(this.config.openApi.mountPath, this.config.openApi.withGlobalPrefix)}`);
                         }
                         if (this.server)
@@ -631,7 +638,11 @@ class ExpressServer {
                     }
                 ];
                 if (this.config.https) {
-                    const httpsOptions = Object.assign(Object.assign({}, this.config.https), { key: fs_1.default.readFileSync(this.config.https.key), cert: fs_1.default.readFileSync(this.config.https.cert) });
+                    const httpsOptions = {
+                        ...this.config.https,
+                        key: fs_1.default.readFileSync(this.config.https.key),
+                        cert: fs_1.default.readFileSync(this.config.https.cert)
+                    };
                     if (this.config.https.ca) {
                         httpsOptions.ca = fs_1.default.readFileSync(this.config.https.ca);
                     }
@@ -687,7 +698,7 @@ class ExpressServer {
         }
         this.isShuttingDown = true;
         await this.runHook('beforeStop', this.server);
-        const shutdownTimeout = 10000; // 10s max wait
+        const shutdownTimeout = 10_000; // 10s max wait
         const serverClosePromise = new Promise((resolve, reject) => {
             this.server.close(async (err) => {
                 if (err) {
@@ -847,8 +858,7 @@ class ExpressServer {
      * @return {*}  {client.Registry}
      */
     getMetricsRegistry() {
-        var _a;
-        if (!((_a = this.config.metrics) === null || _a === void 0 ? void 0 : _a.enable)) {
+        if (!this.config.metrics?.enable) {
             throw new Error('Metrics are not enabled in the server configuration');
         }
         return this.register;
@@ -886,9 +896,8 @@ class ExpressServer {
         return sanitize(prefix + '/' + path);
     }
     normalizeRouteForMetrics(req, res) {
-        var _a;
         // Prevent high cardinality metrics by normalizing routes
-        if ((_a = req === null || req === void 0 ? void 0 : req.route) === null || _a === void 0 ? void 0 : _a.path) {
+        if (req?.route?.path) {
             // Use Express route pattern instead of actual URL
             return req.route.path;
         }
@@ -953,10 +962,9 @@ class ExpressServer {
         try {
             return require(name);
         }
-        catch (_a) {
+        catch {
             return null;
         }
     }
 }
 exports.ExpressServer = ExpressServer;
-//# sourceMappingURL=server.js.map

package/build/{src → cjs}/types/api-response.d.ts

@@ -149,4 +149,3 @@ export interface PaginationParams {
  * Type that combines pagination parameters with additional data.
  */
 export type WithPagination<T = {}> = PaginationParams & T;
-//# sourceMappingURL=api-response.d.ts.map

package/build/{src → cjs}/types/api-response.js

@@ -34,4 +34,3 @@ var SortDirection;
     /** Descending sort order */
     SortDirection["DESC"] = "desc";
 })(SortDirection || (exports.SortDirection = SortDirection = {}));
-//# sourceMappingURL=api-response.js.map

package/build/{src → cjs}/types/index.d.ts

@@ -122,4 +122,3 @@ export type Optional2<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
 export type Without<T, U> = {
     [P in keyof T as T[P] extends U ? never : P]: T[P];
 };
-//# sourceMappingURL=index.d.ts.map

package/build/{src → cjs}/types/index.js

@@ -23,4 +23,3 @@
  * SOFTWARE.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=index.js.map

package/build/{src → cjs}/types/server.d.ts

@@ -265,4 +265,3 @@ export interface ServerHooks {
     /** Called before response is sent - good for response modification */
     onResponse?: (req: Request, res: Response, next: NextFunction) => void;
 }
-//# sourceMappingURL=server.d.ts.map

package/build/{src → cjs}/types/server.js

@@ -23,4 +23,3 @@
  * SOFTWARE.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=server.js.map

package/build/{src → cjs}/utils/array.utils.d.ts

@@ -165,4 +165,3 @@ export declare function compact<T>(array: T[]): NonNullable<T>[];
  * @returns {Record<string, number>} Object with counts by key.
  */
 export declare function countBy<T>(array: T[], keyFn: (item: T) => string | number | symbol): Record<string, number>;
-//# sourceMappingURL=array.utils.d.ts.map

package/build/{src → cjs}/utils/array.utils.js

@@ -361,4 +361,3 @@ function countBy(array, keyFn) {
         return acc;
     }, {});
 }
-//# sourceMappingURL=array.utils.js.map

package/build/{src → cjs}/utils/async.utils.d.ts

@@ -262,4 +262,3 @@ export declare function runWithConcurrency<T>(tasks: Array<() => Promise<T>>, op
     /** Abort signal to cancel execution */
     signal?: AbortSignal;
 }): Promise<T[]>;
-//# sourceMappingURL=async.utils.d.ts.map

package/build/{src → cjs}/utils/async.utils.js

@@ -580,7 +580,7 @@ async function runWithConcurrency(tasks, options = {}) {
     if (totalTasks === 0)
         return results;
     // Check if execution is already aborted
-    if (signal === null || signal === void 0 ? void 0 : signal.aborted) {
+    if (signal?.aborted) {
         throw new Error('Aborted');
     }
     return new Promise((resolve, reject) => {
@@ -596,7 +596,7 @@ async function runWithConcurrency(tasks, options = {}) {
                 // Run the task
                 const result = await tasks[currentTaskIndex]();
                 // Check if aborted during task execution
-                if (signal === null || signal === void 0 ? void 0 : signal.aborted) {
+                if (signal?.aborted) {
                     reject(new Error('Aborted'));
                     return;
                 }
@@ -638,4 +638,3 @@ async function runWithConcurrency(tasks, options = {}) {
         }
     });
 }
-//# sourceMappingURL=async.utils.js.map

package/build/{esnext → cjs}/utils/cache.utils.d.ts

@@ -150,4 +150,3 @@ export declare class TTLCache<K, V> {
      */
     private evictLRU;
 }
-//# sourceMappingURL=cache.utils.d.ts.map

package/build/{src → cjs}/utils/cache.utils.js

@@ -37,13 +37,15 @@ const config_1 = require("../config");
  * const value = cache.get("x"); // 123
  */
 class TTLCache {
+    cache = new Map();
+    ttlMs;
+    maxSize;
+    cleanupInterval;
     /**
      * @param options - Configuration options for the cache
      */
     constructor(options = {}) {
-        var _a;
-        this.cache = new Map();
-        this.ttlMs = (_a = options.ttlMs) !== null && _a !== void 0 ? _a : config_1.config.cache.defaultTtl;
+        this.ttlMs = options.ttlMs ?? config_1.config.cache.defaultTtl;
         this.maxSize = options.maxSize;
         // Setup auto-cleanup if enabled
         const autoCleanupMs = options.autoCleanupMs;
@@ -115,7 +117,7 @@ class TTLCache {
         if (value !== undefined)
             return value;
         const newValue = await producer();
-        this.setWithTTL(key, newValue, ttlMs !== null && ttlMs !== void 0 ? ttlMs : this.ttlMs);
+        this.setWithTTL(key, newValue, ttlMs ?? this.ttlMs);
         return newValue;
     }
     /**
@@ -237,7 +239,7 @@ class TTLCache {
             this.cache.delete(key);
             return false;
         }
-        entry.expiresAt = now + (ttlMs !== null && ttlMs !== void 0 ? ttlMs : this.ttlMs);
+        entry.expiresAt = now + (ttlMs ?? this.ttlMs);
         entry.lastAccessed = now;
         return true;
     }
@@ -294,4 +296,3 @@ class TTLCache {
     }
 }
 exports.TTLCache = TTLCache;
-//# sourceMappingURL=cache.utils.js.map

package/build/{esnext → cjs}/utils/context-store.utils.d.ts

@@ -144,7 +144,7 @@ export declare class ContextStore {
      * @param {(req: any) => Partial<Record<symbol, unknown>>} initialValuesFactory - Function that returns initial context values.
      * @returns Express middleware function.
      */
-    static createExpressMiddleware(initialValuesFactory?: (req: any) => Partial<Record<symbol, unknown>>): (req: any, res: any, next: any) => void;
+    static createExpressMiddleware(initialValuesFactory?: (req: any) => Partial<Record<symbol, unknown>>): (req: any, _res: any, next: any) => void;
 }
 /**
  * Type-safe wrapper for accessing and modifying context values with specific types.
@@ -186,4 +186,3 @@ export declare class TypedContextKey<T> {
      */
     delete(): boolean;
 }
-//# sourceMappingURL=context-store.utils.d.ts.map