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

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@catbee/utils",
-  "version": "0.0.8-rc.2",
+  "version": "0.0.8-rc.4",
   "description": "A modular, production-grade utility toolkit for Node.js and TypeScript, designed for robust, scalable applications (including Express-based services). All utilities are tree-shakable and can be imported independently.",
-  "main": "build/esm/index.js",
-  "module": "build/esm/index.js",
-  "types": "build/esm/index.d.ts",
+  "main": "build/index.cjs",
+  "module": "build/index.mjs",
+  "types": "build/index.d.ts",
   "publishConfig": {
     "access": "public"
   },
@@ -13,35 +13,6 @@
     "email": "hprasath.dev@gmail.com"
   },
   "license": "MIT",
-  "keywords": [
-    "utils",
-    "utility",
-    "helpers",
-    "typescript",
-    "nodejs",
-    "env",
-    "config",
-    "logger",
-    "pino",
-    "context",
-    "context-store",
-    "async",
-    "validation",
-    "filesystem",
-    "object",
-    "string",
-    "array",
-    "crypto",
-    "catbee",
-    "express",
-    "http",
-    "middleware",
-    "metrics",
-    "monitoring",
-    "decorators",
-    "functional",
-    "tools"
-  ],
   "optionalDependencies": {
     "@scalar/express-api-reference": "^0.8.18",
     "abort-controller": "^3.0.0",
@@ -55,19 +26,24 @@
     "prom-client": "^15.1.3"
   },
   "peerDependencies": {
-    "express": "^5.1.0"
+    "express": "^5.1.0",
+    "reflect-metadata": "^0.2.2"
   },
   "peerDependenciesMeta": {
     "express": {
       "optional": true
+    },
+    "reflect-metadata": {
+      "optional": true
     }
   },
   "engines": {
     "node": ">=18.4"
   },
   "files": [
-    "build/esm/**/*.js",
-    "build/esm/**/*.d.ts",
+    "build/**/*.mjs",
+    "build/**/*.cjs",
+    "build/**/*.d.ts",
     "LICENSE",
     "README.md"
   ]

package/build/esm/config.d.ts

@@ -1,121 +0,0 @@
-import { Logger, LoggerLevels } from './utils/logger.utils';
-/**
- * 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;
-        }
-    }
-}
-/**
- * Application runtime configuration loaded from environment variables.
- */
-export declare let config: {
-    logger: {
-        /**
-         * Logging level (e.g., 'info', 'debug', 'warn', 'error').
-         */
-        level: LoggerLevels;
-        /**
-         * Name of the logger instance (defaults to npm package name).
-         */
-        name: string;
-        /**
-         * Enables pretty-print logging in development.
-         * Has no effect in production.
-         */
-        pretty: boolean;
-        /**
-         * Single line output for pretty-print (default: false)
-         */
-        singleLine: boolean;
-    };
-    cache: {
-        /**
-         * Default TTL (time to live) for cache entries in seconds
-         */
-        defaultTtl: number;
-    };
-};
-export declare const defaultServerConfig: {
-    port: number;
-    host: string;
-    cors: false;
-    helmet: false;
-    compression: false;
-    bodyParser: {
-        json: {
-            limit: string;
-        };
-        urlencoded: {
-            extended: true;
-            limit: string;
-        };
-    };
-    cookieParser: false;
-    isMicroservice: false;
-    appName: string;
-    globalHeaders: {};
-    rateLimit: {
-        enable: false;
-        windowMs: number;
-        max: number;
-        message: string;
-        standardHeaders: true;
-        legacyHeaders: false;
-    };
-    requestLogging: {
-        enable: boolean;
-        ignorePaths: (req: import("express").Request<import("express-serve-static-core").ParamsDictionary, any, any, import("qs").ParsedQs, Record<string, any>>, _res: import("express").Response<any, Record<string, any>>) => boolean;
-        skipNotFoundRoutes: false;
-    };
-    openApi: {
-        enable: false;
-        mountPath: string;
-        verbose: false;
-        withGlobalPrefix: false;
-    };
-    healthCheck: {
-        path: string;
-        detailed: true;
-    };
-    requestTimeout: number;
-    responseTime: {
-        enable: false;
-        addHeader: true;
-        logOnComplete: false;
-    };
-    requestId: {
-        headerName: string;
-        exposeHeader: true;
-        generator: () => string;
-    };
-    metrics: {
-        enable: false;
-        path: string;
-        withGlobalPrefix: false;
-    };
-    serviceVersion: {
-        enable: false;
-        headerName: string;
-        version: string;
-    };
-};
-/**
- * Update the @catbee/utils configuration.
- * @param value Partial configuration object.
- */
-export declare function setConfig(value: Partial<typeof config>): void;
-/**
- * Get the current @catbee/utils configuration.
- * @returns The current configuration object.
- */
-export declare function getConfig(): typeof config;

package/build/esm/config.js

@@ -1,132 +0,0 @@
-/*
- * The MIT License
- *
- * Copyright (c) 2025 Catbee Technologies. https://catbee-utils.npm.hprasath.com/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 './utils/env.utils';
-import { uuid } from './utils/id.utils';
-import { deepObjMerge } from './utils/obj.utils';
-/**
- * Application runtime configuration loaded from environment variables.
- */
-export let config = {
-    logger: {
-        /**
-         * Logging level (e.g., 'info', 'debug', 'warn', 'error').
-         */
-        level: Env.get('LOGGER_LEVEL', 'info'),
-        /**
-         * Name of the logger instance (defaults to npm package name).
-         */
-        name: Env.get('LOGGER_NAME', Env.get('npm_package_name', '@catbee/utils')),
-        /**
-         * Enables pretty-print logging in development.
-         * Has no effect in production.
-         */
-        pretty: Env.getBoolean('LOGGER_PRETTY', true),
-        /**
-         * Single line output for pretty-print (default: false)
-         */
-        singleLine: Env.getBoolean('LOGGER_PRETTY_SINGLE_LINE', false)
-    },
-    cache: {
-        /**
-         * Default TTL (time to live) for cache entries in seconds
-         */
-        defaultTtl: Env.getNumber('CACHE_DEFAULT_TTL_SECONDS', 3600) * 1000
-    }
-};
-export const defaultServerConfig = {
-    port: 3000,
-    host: '0.0.0.0',
-    cors: false,
-    helmet: false,
-    compression: false,
-    bodyParser: {
-        json: { limit: '1mb' },
-        urlencoded: { extended: true, limit: '1mb' }
-    },
-    cookieParser: false,
-    isMicroservice: false,
-    appName: 'express_app',
-    globalHeaders: {},
-    rateLimit: {
-        enable: false,
-        windowMs: 15 * 60 * 1000,
-        max: 100,
-        message: 'Too many requests',
-        standardHeaders: true,
-        legacyHeaders: false
-    },
-    requestLogging: {
-        enable: Env.isDev(),
-        ignorePaths: (req, _res) => {
-            const skipPaths = ['/healthz', '/favicon.ico', '/metrics', '/docs', '/.well-known'];
-            return skipPaths.some(path => req.path.startsWith(path));
-        },
-        skipNotFoundRoutes: false
-    },
-    openApi: {
-        enable: false,
-        mountPath: '/docs',
-        verbose: false,
-        withGlobalPrefix: false
-    },
-    healthCheck: {
-        path: '/healthz',
-        detailed: true
-    },
-    requestTimeout: 30000,
-    responseTime: {
-        enable: false,
-        addHeader: true,
-        logOnComplete: false
-    },
-    requestId: {
-        headerName: 'x-request-id',
-        exposeHeader: true,
-        generator: () => uuid()
-    },
-    metrics: {
-        enable: false,
-        path: '/metrics',
-        withGlobalPrefix: false
-    },
-    serviceVersion: {
-        enable: false,
-        headerName: 'x-service-version',
-        version: '0.0.0'
-    }
-};
-/**
- * Update the @catbee/utils configuration.
- * @param value Partial configuration object.
- */
-export function setConfig(value) {
-    deepObjMerge(config, value);
-}
-/**
- * Get the current @catbee/utils configuration.
- * @returns The current configuration object.
- */
-export function getConfig() {
-    return config;
-}

package/build/esm/index.d.ts

@@ -1,26 +0,0 @@
-export { setConfig, getConfig } from './config';
-export * from './utils/array.utils';
-export * from './utils/async.utils';
-export * from './utils/cache.utils';
-export * from './utils/context-store.utils';
-export * from './utils/crypto.utils';
-export * from './utils/decorators.utils';
-export * from './utils/dir.utils';
-export * from './utils/env.utils';
-export * from './utils/exception.utils';
-export * from './utils/fs.utils';
-export * from './utils/http-status-codes';
-export * from './utils/id.utils';
-export * from './utils/logger.utils';
-export * from './utils/middleware.utils';
-export * from './utils/obj.utils';
-export * from './utils/request.utils';
-export * from './utils/response.utils';
-export * from './utils/string.utils';
-export * from './utils/url.utils';
-export * from './utils/validate.utils';
-export * from './types/index';
-export * from './types/server';
-export * from './types/api-response';
-export * from './servers/server';
-export * from './servers/server.builder';

package/build/esm/index.js

@@ -1,49 +0,0 @@
-/*
- * The MIT License
- *
- * Copyright (c) 2025 Catbee Technologies. https://catbee-utils.npm.hprasath.com/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.
- */
-export { setConfig, getConfig } from './config';
-export * from './utils/array.utils';
-export * from './utils/async.utils';
-export * from './utils/cache.utils';
-export * from './utils/context-store.utils';
-export * from './utils/crypto.utils';
-export * from './utils/decorators.utils';
-export * from './utils/dir.utils';
-export * from './utils/env.utils';
-export * from './utils/exception.utils';
-export * from './utils/fs.utils';
-export * from './utils/http-status-codes';
-export * from './utils/id.utils';
-export * from './utils/logger.utils';
-export * from './utils/middleware.utils';
-export * from './utils/obj.utils';
-export * from './utils/request.utils';
-export * from './utils/response.utils';
-export * from './utils/string.utils';
-export * from './utils/url.utils';
-export * from './utils/validate.utils';
-export * from './types/index';
-export * from './types/server';
-export * from './types/api-response';
-export * from './servers/server';
-export * from './servers/server.builder';