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

package/build/esm/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/esm/config.js

@@ -27,7 +27,7 @@ import { deepObjMerge } from './utils/obj.utils';
 /**
  * Application runtime configuration loaded from environment variables.
  */
-export var config = {
+export let config = {
     logger: {
         /**
          * Logging level (e.g., 'info', 'debug', 'warn', 'error').
@@ -54,7 +54,7 @@ export var config = {
         defaultTtl: Env.getNumber('CACHE_DEFAULT_TTL_SECONDS', 3600) * 1000
     }
 };
-export var defaultServerConfig = {
+export const defaultServerConfig = {
     port: 3000,
     host: '0.0.0.0',
     cors: false,
@@ -78,9 +78,9 @@ export var defaultServerConfig = {
     },
     requestLogging: {
         enable: Env.isDev(),
-        ignorePaths: function (req, _res) {
-            var skipPaths = ['/healthz', '/favicon.ico', '/metrics', '/docs', '/.well-known'];
-            return skipPaths.some(function (path) { return req.path.startsWith(path); });
+        ignorePaths: (req, _res) => {
+            const skipPaths = ['/healthz', '/favicon.ico', '/metrics', '/docs', '/.well-known'];
+            return skipPaths.some(path => req.path.startsWith(path));
         },
         skipNotFoundRoutes: false
     },
@@ -103,7 +103,7 @@ export var defaultServerConfig = {
     requestId: {
         headerName: 'x-request-id',
         exposeHeader: true,
-        generator: function () { return uuid(); }
+        generator: () => uuid()
     },
     metrics: {
         enable: false,
@@ -130,4 +130,3 @@ export function setConfig(value) {
 export function getConfig() {
     return config;
 }
-//# sourceMappingURL=config.js.map

package/build/esm/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/esm/index.js

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

package/build/esm/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/esm/servers/server.builder.js

@@ -21,42 +21,6 @@
  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  * SOFTWARE.
  */
-var __assign = (this && this.__assign) || function () {
-    __assign = Object.assign || function(t) {
-        for (var s, i = 1, n = arguments.length; i < n; i++) {
-            s = arguments[i];
-            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
-                t[p] = s[p];
-        }
-        return t;
-    };
-    return __assign.apply(this, arguments);
-};
-var __read = (this && this.__read) || function (o, n) {
-    var m = typeof Symbol === "function" && o[Symbol.iterator];
-    if (!m) return o;
-    var i = m.call(o), r, ar = [], e;
-    try {
-        while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
-    }
-    catch (error) { e = { error: error }; }
-    finally {
-        try {
-            if (r && !r.done && (m = i["return"])) m.call(i);
-        }
-        finally { if (e) throw e.error; }
-    }
-    return ar;
-};
-var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
-    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
-        if (ar || !(i in from)) {
-            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
-            ar[i] = from[i];
-        }
-    }
-    return to.concat(ar || Array.prototype.slice.call(from));
-};
 import { deepObjMerge } from '../utils/obj.utils';
 import { defaultServerConfig } from '../config';
 import { isPort } from '../utils/validate.utils';
@@ -76,11 +40,9 @@ import { isPort } from '../utils/validate.utils';
  *   .build();
  * ```
  */
-export var BUILD_MARKER = Symbol.for('catbee.express.server.build');
-var ServerConfigBuilder = /** @class */ (function () {
-    function ServerConfigBuilder() {
-        this.config = {};
-    }
+export const BUILD_MARKER = Symbol.for('catbee.express.server.build');
+export class ServerConfigBuilder {
+    config = {};
     /**
      * Validates that a port number is valid and usable.
      *
@@ -88,11 +50,11 @@ var ServerConfigBuilder = /** @class */ (function () {
      * @param port - The port number to validate
      * @throws {Error} If port is not an integer or is outside the valid range (1-65535)
      */
-    ServerConfigBuilder.prototype.validatePort = function (port) {
+    validatePort(port) {
         if (!isPort(port)) {
-            throw new Error("Port must be a valid number between 1 and 65535, got: ".concat(port));
+            throw new Error(`Port must be a valid number between 1 and 65535, got: ${port}`);
         }
-    };
+    }
     /**
      * Sets the port the server will listen on.
      *
@@ -106,11 +68,11 @@ var ServerConfigBuilder = /** @class */ (function () {
      * builder.withPort(3000)
      * ```
      */
-    ServerConfigBuilder.prototype.withPort = function (port) {
+    withPort(port) {
         this.validatePort(port);
         this.config.port = port;
         return this;
-    };
+    }
     /**
      * Sets the hostname the server will bind to.
      *
@@ -123,10 +85,10 @@ var ServerConfigBuilder = /** @class */ (function () {
      * builder.withHost('0.0.0.0') // Listen on all interfaces
      * ```
      */
-    ServerConfigBuilder.prototype.withHost = function (host) {
+    withHost(host) {
         this.config.host = host;
         return this;
-    };
+    }
     /**
      * Configures Cross-Origin Resource Sharing (CORS) for the server.
      *
@@ -146,26 +108,26 @@ var ServerConfigBuilder = /** @class */ (function () {
      * })
      * ```
      */
-    ServerConfigBuilder.prototype.withCors = function (opts) {
+    withCors(opts) {
         this.config.cors = opts;
         return this;
-    };
+    }
     /**
      * Enables CORS with default settings
      *
      * @returns The builder instance for chaining
      */
-    ServerConfigBuilder.prototype.enableCors = function () {
+    enableCors() {
         return this.withCors(true);
-    };
+    }
     /**
      * Disables CORS
      *
      * @returns The builder instance for chaining
      */
-    ServerConfigBuilder.prototype.disableCors = function () {
+    disableCors() {
         return this.withCors(false);
-    };
+    }
     /**
      * Configures the Helmet middleware for setting HTTP security headers.
      *
@@ -185,26 +147,26 @@ var ServerConfigBuilder = /** @class */ (function () {
      * })
      * ```
      */
-    ServerConfigBuilder.prototype.withHelmet = function (opts) {
+    withHelmet(opts) {
         this.config.helmet = opts;
         return this;
-    };
+    }
     /**
      * Enables Helmet with default settings
      *
      * @returns The builder instance for chaining
      */
-    ServerConfigBuilder.prototype.enableHelmet = function () {
+    enableHelmet() {
         return this.withHelmet(true);
-    };
+    }
     /**
      * Disables Helmet
      *
      * @returns The builder instance for chaining
      */
-    ServerConfigBuilder.prototype.disableHelmet = function () {
+    disableHelmet() {
         return this.withHelmet(false);
-    };
+    }
     /**
      * Configures response compression middleware.
      *
@@ -224,26 +186,26 @@ var ServerConfigBuilder = /** @class */ (function () {
      * })
      * ```
      */
-    ServerConfigBuilder.prototype.withCompression = function (opts) {
+    withCompression(opts) {
         this.config.compression = opts;
         return this;
-    };
+    }
     /**
      * Enables compression with default settings
      *
      * @returns The builder instance for chaining
      */
-    ServerConfigBuilder.prototype.enableCompression = function () {
+    enableCompression() {
         return this.withCompression(true);
-    };
+    }
     /**
      * Disables compression
      *
      * @returns The builder instance for chaining
      */
-    ServerConfigBuilder.prototype.disableCompression = function () {
+    disableCompression() {
         return this.withCompression(false);
-    };
+    }
     /**
      * Configures rate limiting to protect against brute-force attacks.
      *
@@ -260,28 +222,27 @@ var ServerConfigBuilder = /** @class */ (function () {
      * })
      * ```
      */
-    ServerConfigBuilder.prototype.withRateLimit = function (opts) {
+    withRateLimit(opts) {
         this.mergeConfig('rateLimit', opts);
         return this;
-    };
+    }
     /**
      * Enables rate limiting with default or custom settings
      *
      * @param opts - Optional rate limit configuration (max requests, window, etc.)
      * @returns The builder instance for chaining
      */
-    ServerConfigBuilder.prototype.enableRateLimit = function (opts) {
-        if (opts === void 0) { opts = {}; }
+    enableRateLimit(opts = {}) {
         return this.setEnabled('rateLimit', true, opts);
-    };
+    }
     /**
      * Disables rate limiting
      *
      * @returns The builder instance for chaining
      */
-    ServerConfigBuilder.prototype.disableRateLimit = function () {
+    disableRateLimit() {
         return this.setEnabled('rateLimit', false);
-    };
+    }
     /**
      * Configures HTTP request logging middleware.
      *
@@ -298,28 +259,27 @@ var ServerConfigBuilder = /** @class */ (function () {
      * })
      * ```
      */
-    ServerConfigBuilder.prototype.withRequestLogging = function (opts) {
+    withRequestLogging(opts) {
         this.mergeConfig('requestLogging', opts);
         return this;
-    };
+    }
     /**
      * Enables request logging with default or custom settings
      *
      * @param opts - Optional request logging configuration
      * @returns The builder instance for chaining
      */
-    ServerConfigBuilder.prototype.enableRequestLogging = function (opts) {
-        if (opts === void 0) { opts = {}; }
+    enableRequestLogging(opts = {}) {
         return this.setEnabled('requestLogging', true, opts);
-    };
+    }
     /**
      * Disables request logging
      *
      * @returns The builder instance for chaining
      */
-    ServerConfigBuilder.prototype.disableRequestLogging = function () {
+    disableRequestLogging() {
         return this.setEnabled('requestLogging', false);
-    };
+    }
     /**
      * Configures server metrics collection and endpoints.
      *
@@ -335,28 +295,27 @@ var ServerConfigBuilder = /** @class */ (function () {
      * })
      * ```
      */
-    ServerConfigBuilder.prototype.withMetrics = function (opts) {
+    withMetrics(opts) {
         this.mergeConfig('metrics', opts);
         return this;
-    };
+    }
     /**
      * Enables Prometheus metrics collection and endpoint
      *
      * @param opts - Optional metrics configuration
      * @returns The builder instance for chaining
      */
-    ServerConfigBuilder.prototype.enableMetrics = function (opts) {
-        if (opts === void 0) { opts = {}; }
+    enableMetrics(opts = {}) {
         return this.setEnabled('metrics', true, opts);
-    };
+    }
     /**
      * Disables Prometheus metrics
      *
      * @returns The builder instance for chaining
      */
-    ServerConfigBuilder.prototype.disableMetrics = function () {
+    disableMetrics() {
         return this.setEnabled('metrics', false);
-    };
+    }
     /**
      * Configures server health check endpoint.
      *
@@ -372,10 +331,10 @@ var ServerConfigBuilder = /** @class */ (function () {
      * })
      * ```
      */
-    ServerConfigBuilder.prototype.withHealthCheck = function (opts) {
+    withHealthCheck(opts) {
         this.mergeConfig('healthCheck', opts);
         return this;
-    };
+    }
     /**
      * Configures OpenAPI/Swagger documentation for the API.
      *
@@ -392,10 +351,10 @@ var ServerConfigBuilder = /** @class */ (function () {
      * })
      * ```
      */
-    ServerConfigBuilder.prototype.withOpenApi = function (opts) {
+    withOpenApi(opts) {
         this.mergeConfig('openApi', opts);
         return this;
-    };
+    }
     /**
      * Enables OpenAPI documentation with required file path
      *
@@ -403,19 +362,18 @@ var ServerConfigBuilder = /** @class */ (function () {
      * @param opts - Optional OpenAPI configuration
      * @returns The builder instance for chaining
      */
-    ServerConfigBuilder.prototype.enableOpenApi = function (filePath, opts) {
-        if (opts === void 0) { opts = {}; }
-        this.setEnabled('openApi', true, __assign({ filePath: filePath }, opts));
+    enableOpenApi(filePath, opts = {}) {
+        this.setEnabled('openApi', true, { filePath, ...opts });
         return this;
-    };
+    }
     /**
      * Disables OpenAPI documentation
      *
      * @returns The builder instance for chaining
      */
-    ServerConfigBuilder.prototype.disableOpenApi = function () {
+    disableOpenApi() {
         return this.setEnabled('openApi', false);
-    };
+    }
     /**
      * Configures the server as a microservice with versioning.
      *
@@ -434,12 +392,12 @@ var ServerConfigBuilder = /** @class */ (function () {
      * })
      * ```
      */
-    ServerConfigBuilder.prototype.withMicroService = function (opts) {
+    withMicroService(opts) {
         this.config.isMicroservice = true;
         this.config.appName = opts.appName;
         this.mergeConfig('serviceVersion', opts.serviceVersion);
         return this;
-    };
+    }
     /**
      * Configures the trust proxy settings to determine if X-Forwarded-* headers should be trusted.
      *
@@ -453,10 +411,10 @@ var ServerConfigBuilder = /** @class */ (function () {
      * builder.withTrustProxy(true)
      * ```
      */
-    ServerConfigBuilder.prototype.withTrustProxy = function (opts) {
+    withTrustProxy(opts) {
         this.config.trustProxy = opts;
         return this;
-    };
+    }
     /**
      * Configures the request ID middleware for tracing requests across services.
      *
@@ -472,10 +430,10 @@ var ServerConfigBuilder = /** @class */ (function () {
      * })
      * ```
      */
-    ServerConfigBuilder.prototype.withRequestId = function (opts) {
+    withRequestId(opts) {
         this.mergeConfig('requestId', opts);
         return this;
-    };
+    }
     /**
      * Configures the response time middleware for measuring request processing times.
      *
@@ -492,29 +450,28 @@ var ServerConfigBuilder = /** @class */ (function () {
      * })
      * ```
      */
-    ServerConfigBuilder.prototype.withResponseTime = function (opts) {
+    withResponseTime(opts) {
         this.mergeConfig('responseTime', opts);
         return this;
-    };
+    }
     /**
      * Enables response time tracking with default or custom settings
      *
      * @param opts - Optional response time configuration
      * @returns The builder instance for chaining
      */
-    ServerConfigBuilder.prototype.enableResponseTime = function (opts) {
-        if (opts === void 0) { opts = {}; }
+    enableResponseTime(opts = {}) {
         this.setEnabled('responseTime', true, opts);
         return this;
-    };
+    }
     /**
      * Disables response time tracking
      *
      * @returns The builder instance for chaining
      */
-    ServerConfigBuilder.prototype.disableResponseTime = function () {
+    disableResponseTime() {
         return this.setEnabled('responseTime', false);
-    };
+    }
     /**
      * Configures the body parser middleware options for parsing request bodies.
      *
@@ -535,11 +492,10 @@ var ServerConfigBuilder = /** @class */ (function () {
      * })
      * ```
      */
-    ServerConfigBuilder.prototype.withBodyParser = function (opts) {
-        var _a;
-        this.config.bodyParser = deepObjMerge({}, (_a = this.config.bodyParser) !== null && _a !== void 0 ? _a : {}, opts);
+    withBodyParser(opts) {
+        this.config.bodyParser = deepObjMerge({}, this.config.bodyParser ?? {}, opts);
         return this;
-    };
+    }
     /**
      * Configures cookie parsing middleware.
      *
@@ -559,10 +515,10 @@ var ServerConfigBuilder = /** @class */ (function () {
      * })
      * ```
      */
-    ServerConfigBuilder.prototype.withCookies = function (opts) {
+    withCookies(opts) {
         this.config.cookieParser = opts;
         return this;
-    };
+    }
     /**
      * Adds a static folder to serve files from.
      *
@@ -578,14 +534,13 @@ var ServerConfigBuilder = /** @class */ (function () {
      * })
      * ```
      */
-    ServerConfigBuilder.prototype.withStaticFolder = function (folder) {
-        var _a;
+    withStaticFolder(folder) {
         if (!folder.path)
             throw new Error('Static folder requires a path');
-        var folders = __spreadArray(__spreadArray([], __read(((_a = this.config.staticFolders) !== null && _a !== void 0 ? _a : [])), false), [folder], false);
-        this.config.staticFolders = Array.from(new Map(folders.map(function (f) { return [f.path, f]; })).values());
+        const folders = [...(this.config.staticFolders ?? []), folder];
+        this.config.staticFolders = Array.from(new Map(folders.map(f => [f.path, f])).values());
         return this;
-    };
+    }
     /**
      * Sets global headers to be included in all responses.
      *
@@ -601,10 +556,10 @@ var ServerConfigBuilder = /** @class */ (function () {
      * })
      * ```
      */
-    ServerConfigBuilder.prototype.withGlobalHeaders = function (headers) {
+    withGlobalHeaders(headers) {
         this.mergeConfig('globalHeaders', headers);
         return this;
-    };
+    }
     /**
      * Sets a global prefix for all routes.
      *
@@ -617,10 +572,10 @@ var ServerConfigBuilder = /** @class */ (function () {
      * builder.withGlobalPrefix('/api/v1')
      * ```
      */
-    ServerConfigBuilder.prototype.withGlobalPrefix = function (prefix) {
+    withGlobalPrefix(prefix) {
         this.config.globalPrefix = prefix;
         return this;
-    };
+    }
     /**
      * Applies custom configuration overrides directly.
      *
@@ -635,10 +590,10 @@ var ServerConfigBuilder = /** @class */ (function () {
      * })
      * ```
      */
-    ServerConfigBuilder.prototype.withCustom = function (overrides) {
+    withCustom(overrides) {
         this.config = deepObjMerge({}, this.config, overrides);
         return this;
-    };
+    }
     /**
      * Configures HTTPS server options.
      *
@@ -653,10 +608,10 @@ var ServerConfigBuilder = /** @class */ (function () {
      * })
      * ```
      */
-    ServerConfigBuilder.prototype.withHttps = function (opts) {
+    withHttps(opts) {
         this.config.https = opts;
         return this;
-    };
+    }
     /**
      * Builds and returns the final server configuration.
      *
@@ -675,28 +630,25 @@ var ServerConfigBuilder = /** @class */ (function () {
      *   .build();
      * ```
      */
-    ServerConfigBuilder.prototype.build = function () {
-        var _a;
-        var _b;
-        var config = deepObjMerge({}, defaultServerConfig, this.config);
+    build() {
+        const config = deepObjMerge({}, defaultServerConfig, this.config);
         // Common validation
-        if (((_b = config.openApi) === null || _b === void 0 ? void 0 : _b.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(__assign(__assign({}, config), (_a = {}, _a[BUILD_MARKER] = true, _a)));
-    };
-    ServerConfigBuilder.prototype.mergeConfig = function (key, value) {
-        var current = typeof this.config[key] === 'object' && this.config[key] !== null
+        return Object.freeze({
+            ...config,
+            [BUILD_MARKER]: true
+        });
+    }
+    mergeConfig(key, value) {
+        const current = typeof this.config[key] === 'object' && this.config[key] !== null
             ? this.config[key]
             : {};
         this.config[key] = deepObjMerge({}, current, value);
-    };
-    ServerConfigBuilder.prototype.setEnabled = function (key, enable, overrides) {
-        if (overrides === void 0) { overrides = {}; }
-        this.mergeConfig(key, __assign(__assign({}, overrides), { enable: enable }));
+    }
+    setEnabled(key, enable, overrides = {}) {
+        this.mergeConfig(key, { ...overrides, enable });
         return this;
-    };
-    return ServerConfigBuilder;
-}());
-export { ServerConfigBuilder };
-//# sourceMappingURL=server.builder.js.map
+    }
+}

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

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