@catbee/utils 0.0.8-rc.3 → 1.0.1

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@catbee/utils",
-  "version": "0.0.8-rc.3",
+  "version": "1.0.1",
   "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/cjs/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"
   },
@@ -26,304 +26,25 @@
     "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/cjs/**/*.js",
-    "build/cjs/**/*.d.ts",
+    "build/**/*.mjs",
+    "build/**/*.cjs",
+    "build/**/*.d.ts",
     "LICENSE",
     "README.md"
-  ],
-  "exports": {
-    ".": {
-      "import": {
-        "types": "./build/esm/index.d.ts",
-        "default": "./build/esm/index.js"
-      },
-      "require": {
-        "types": "./build/cjs/index.d.ts",
-        "default": "./build/cjs/index.js"
-      }
-    },
-    "./array": {
-      "import": {
-        "types": "./build/esm/utils/array.utils.d.ts",
-        "default": "./build/esm/utils/array.utils.js"
-      },
-      "require": {
-        "types": "./build/cjs/utils/array.utils.d.ts",
-        "default": "./build/cjs/utils/array.utils.js"
-      }
-    },
-    "./async": {
-      "import": {
-        "types": "./build/esm/utils/async.utils.d.ts",
-        "default": "./build/esm/utils/async.utils.js"
-      },
-      "require": {
-        "types": "./build/cjs/utils/async.utils.d.ts",
-        "default": "./build/cjs/utils/async.utils.js"
-      }
-    },
-    "./cache": {
-      "import": {
-        "types": "./build/esm/utils/cache.utils.d.ts",
-        "default": "./build/esm/utils/cache.utils.js"
-      },
-      "require": {
-        "types": "./build/cjs/utils/cache.utils.d.ts",
-        "default": "./build/cjs/utils/cache.utils.js"
-      }
-    },
-    "./context-store": {
-      "import": {
-        "types": "./build/esm/utils/context-store.utils.d.ts",
-        "default": "./build/esm/utils/context-store.utils.js"
-      },
-      "require": {
-        "types": "./build/cjs/utils/context-store.utils.d.ts",
-        "default": "./build/cjs/utils/context-store.utils.js"
-      }
-    },
-    "./crypto": {
-      "import": {
-        "types": "./build/esm/utils/crypto.utils.d.ts",
-        "default": "./build/esm/utils/crypto.utils.js"
-      },
-      "require": {
-        "types": "./build/cjs/utils/crypto.utils.d.ts",
-        "default": "./build/cjs/utils/crypto.utils.js"
-      }
-    },
-    "./date": {
-      "import": {
-        "types": "./build/esm/utils/date.utils.d.ts",
-        "default": "./build/esm/utils/date.utils.js"
-      },
-      "require": {
-        "types": "./build/cjs/utils/date.utils.d.ts",
-        "default": "./build/cjs/utils/date.utils.js"
-      }
-    },
-    "./decorators": {
-      "import": {
-        "types": "./build/esm/utils/decorators.utils.d.ts",
-        "default": "./build/esm/utils/decorators.utils.js"
-      },
-      "require": {
-        "types": "./build/cjs/utils/decorators.utils.d.ts",
-        "default": "./build/cjs/utils/decorators.utils.js"
-      }
-    },
-    "./dir": {
-      "import": {
-        "types": "./build/esm/utils/dir.utils.d.ts",
-        "default": "./build/esm/utils/dir.utils.js"
-      },
-      "require": {
-        "types": "./build/cjs/utils/dir.utils.d.ts",
-        "default": "./build/cjs/utils/dir.utils.js"
-      }
-    },
-    "./env": {
-      "import": {
-        "types": "./build/esm/utils/env.utils.d.ts",
-        "default": "./build/esm/utils/env.utils.js"
-      },
-      "require": {
-        "types": "./build/cjs/utils/env.utils.d.ts",
-        "default": "./build/cjs/utils/env.utils.js"
-      }
-    },
-    "./exception": {
-      "import": {
-        "types": "./build/esm/utils/exception.utils.d.ts",
-        "default": "./build/esm/utils/exception.utils.js"
-      },
-      "require": {
-        "types": "./build/cjs/utils/exception.utils.d.ts",
-        "default": "./build/cjs/utils/exception.utils.js"
-      }
-    },
-    "./fs": {
-      "import": {
-        "types": "./build/esm/utils/fs.utils.d.ts",
-        "default": "./build/esm/utils/fs.utils.js"
-      },
-      "require": {
-        "types": "./build/cjs/utils/fs.utils.d.ts",
-        "default": "./build/cjs/utils/fs.utils.js"
-      }
-    },
-    "./http-status-codes": {
-      "import": {
-        "types": "./build/esm/utils/http-status-codes.d.ts",
-        "default": "./build/esm/utils/http-status-codes.js"
-      },
-      "require": {
-        "types": "./build/cjs/utils/http-status-codes.d.ts",
-        "default": "./build/cjs/utils/http-status-codes.js"
-      }
-    },
-    "./id": {
-      "import": {
-        "types": "./build/esm/utils/id.utils.d.ts",
-        "default": "./build/esm/utils/id.utils.js"
-      },
-      "require": {
-        "types": "./build/cjs/utils/id.utils.d.ts",
-        "default": "./build/cjs/utils/id.utils.js"
-      }
-    },
-    "./logger": {
-      "import": {
-        "types": "./build/esm/utils/logger.utils.d.ts",
-        "default": "./build/esm/utils/logger.utils.js"
-      },
-      "require": {
-        "types": "./build/cjs/utils/logger.utils.d.ts",
-        "default": "./build/cjs/utils/logger.utils.js"
-      }
-    },
-    "./middleware": {
-      "import": {
-        "types": "./build/esm/utils/middleware.utils.d.ts",
-        "default": "./build/esm/utils/middleware.utils.js"
-      },
-      "require": {
-        "types": "./build/cjs/utils/middleware.utils.d.ts",
-        "default": "./build/cjs/utils/middleware.utils.js"
-      }
-    },
-    "./obj": {
-      "import": {
-        "types": "./build/esm/utils/obj.utils.d.ts",
-        "default": "./build/esm/utils/obj.utils.js"
-      },
-      "require": {
-        "types": "./build/cjs/utils/obj.utils.d.ts",
-        "default": "./build/cjs/utils/obj.utils.js"
-      }
-    },
-    "./performance": {
-      "import": {
-        "types": "./build/esm/utils/performance.utils.d.ts",
-        "default": "./build/esm/utils/performance.utils.js"
-      },
-      "require": {
-        "types": "./build/cjs/utils/performance.utils.d.ts",
-        "default": "./build/cjs/utils/performance.utils.js"
-      }
-    },
-    "./request": {
-      "import": {
-        "types": "./build/esm/utils/request.utils.d.ts",
-        "default": "./build/esm/utils/request.utils.js"
-      },
-      "require": {
-        "types": "./build/cjs/utils/request.utils.d.ts",
-        "default": "./build/cjs/utils/request.utils.js"
-      }
-    },
-    "./response": {
-      "import": {
-        "types": "./build/esm/utils/response.utils.d.ts",
-        "default": "./build/esm/utils/response.utils.js"
-      },
-      "require": {
-        "types": "./build/cjs/utils/response.utils.d.ts",
-        "default": "./build/cjs/utils/response.utils.js"
-      }
-    },
-    "./stream": {
-      "import": {
-        "types": "./build/esm/utils/stream.utils.d.ts",
-        "default": "./build/esm/utils/stream.utils.js"
-      },
-      "require": {
-        "types": "./build/cjs/utils/stream.utils.d.ts",
-        "default": "./build/cjs/utils/stream.utils.js"
-      }
-    },
-    "./string": {
-      "import": {
-        "types": "./build/esm/utils/string.utils.d.ts",
-        "default": "./build/esm/utils/string.utils.js"
-      },
-      "require": {
-        "types": "./build/cjs/utils/string.utils.d.ts",
-        "default": "./build/cjs/utils/string.utils.js"
-      }
-    },
-    "./type": {
-      "import": {
-        "types": "./build/esm/utils/type.utils.d.ts",
-        "default": "./build/esm/utils/type.utils.js"
-      },
-      "require": {
-        "types": "./build/cjs/utils/type.utils.d.ts",
-        "default": "./build/cjs/utils/type.utils.js"
-      }
-    },
-    "./url": {
-      "import": {
-        "types": "./build/esm/utils/url.utils.d.ts",
-        "default": "./build/esm/utils/url.utils.js"
-      },
-      "require": {
-        "types": "./build/cjs/utils/url.utils.d.ts",
-        "default": "./build/cjs/utils/url.utils.js"
-      }
-    },
-    "./validate": {
-      "import": {
-        "types": "./build/esm/utils/validate.utils.d.ts",
-        "default": "./build/esm/utils/validate.utils.js"
-      },
-      "require": {
-        "types": "./build/cjs/utils/validate.utils.d.ts",
-        "default": "./build/cjs/utils/validate.utils.js"
-      }
-    },
-    "./types/api-response": {
-      "import": {
-        "types": "./build/esm/types/api-response.d.ts",
-        "default": "./build/esm/types/api-response.js"
-      },
-      "require": {
-        "types": "./build/cjs/types/api-response.d.ts",
-        "default": "./build/cjs/types/api-response.js"
-      }
-    },
-    "./types/index": {
-      "import": {
-        "types": "./build/esm/types/index.d.ts",
-        "default": "./build/esm/types/index.js"
-      },
-      "require": {
-        "types": "./build/cjs/types/index.d.ts",
-        "default": "./build/cjs/types/index.js"
-      }
-    },
-    "./types/server": {
-      "import": {
-        "types": "./build/esm/types/server.d.ts",
-        "default": "./build/esm/types/server.js"
-      },
-      "require": {
-        "types": "./build/cjs/types/server.d.ts",
-        "default": "./build/cjs/types/server.js"
-      }
-    }
-  }
+  ]
 }

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

@@ -1,137 +0,0 @@
-"use strict";
-/*
- * 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.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.defaultServerConfig = exports.config = void 0;
-exports.setConfig = setConfig;
-exports.getConfig = getConfig;
-const env_utils_1 = require("./utils/env.utils");
-const id_utils_1 = require("./utils/id.utils");
-const obj_utils_1 = require("./utils/obj.utils");
-/**
- * Application runtime configuration loaded from environment variables.
- */
-exports.config = {
-    logger: {
-        /**
-         * Logging level (e.g., 'info', 'debug', 'warn', 'error').
-         */
-        level: env_utils_1.Env.get('LOGGER_LEVEL', 'info'),
-        /**
-         * Name of the logger instance (defaults to npm package name).
-         */
-        name: env_utils_1.Env.get('LOGGER_NAME', env_utils_1.Env.get('npm_package_name', '@catbee/utils')),
-        /**
-         * Enables pretty-print logging in development.
-         * Has no effect in production.
-         */
-        pretty: env_utils_1.Env.getBoolean('LOGGER_PRETTY', true),
-        /**
-         * Single line output for pretty-print (default: false)
-         */
-        singleLine: env_utils_1.Env.getBoolean('LOGGER_PRETTY_SINGLE_LINE', false)
-    },
-    cache: {
-        /**
-         * Default TTL (time to live) for cache entries in seconds
-         */
-        defaultTtl: env_utils_1.Env.getNumber('CACHE_DEFAULT_TTL_SECONDS', 3600) * 1000
-    }
-};
-exports.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_utils_1.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: () => (0, id_utils_1.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.
- */
-function setConfig(value) {
-    (0, obj_utils_1.deepObjMerge)(exports.config, value);
-}
-/**
- * Get the current @catbee/utils configuration.
- * @returns The current configuration object.
- */
-function getConfig() {
-    return exports.config;
-}

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

@@ -1,68 +0,0 @@
-"use strict";
-/*
- * 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.
- */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getConfig = exports.setConfig = void 0;
-var config_1 = require("./config");
-Object.defineProperty(exports, "setConfig", { enumerable: true, get: function () { return config_1.setConfig; } });
-Object.defineProperty(exports, "getConfig", { enumerable: true, get: function () { return config_1.getConfig; } });
-__exportStar(require("./utils/array.utils"), exports);
-__exportStar(require("./utils/async.utils"), exports);
-__exportStar(require("./utils/cache.utils"), exports);
-__exportStar(require("./utils/context-store.utils"), exports);
-__exportStar(require("./utils/crypto.utils"), exports);
-__exportStar(require("./utils/decorators.utils"), exports);
-__exportStar(require("./utils/dir.utils"), exports);
-__exportStar(require("./utils/env.utils"), exports);
-__exportStar(require("./utils/exception.utils"), exports);
-__exportStar(require("./utils/fs.utils"), exports);
-__exportStar(require("./utils/http-status-codes"), exports);
-__exportStar(require("./utils/id.utils"), exports);
-__exportStar(require("./utils/logger.utils"), exports);
-__exportStar(require("./utils/middleware.utils"), exports);
-__exportStar(require("./utils/obj.utils"), exports);
-__exportStar(require("./utils/request.utils"), exports);
-__exportStar(require("./utils/response.utils"), exports);
-__exportStar(require("./utils/string.utils"), exports);
-__exportStar(require("./utils/url.utils"), exports);
-__exportStar(require("./utils/validate.utils"), exports);
-__exportStar(require("./types/index"), exports);
-__exportStar(require("./types/server"), exports);
-__exportStar(require("./types/api-response"), exports);
-__exportStar(require("./servers/server"), exports);
-__exportStar(require("./servers/server.builder"), exports);