@catbee/utils

🧰 Utility Modules for Node.js

A modular, production-grade utility toolkit for Node.js and TypeScript, designed for robust, scalable applications. All utilities are tree-shakable and can be imported independently.

🚀 Key Features

• Modular: Import only what you need
• TypeScript-first: Full typings and type safety
• Production-ready: Robust, well-tested utilities
• Tree-shakable: Zero bloat in your bundle
• Express-friendly: Designed for scalable server apps

📦 Installation

npm i @catbee/utils

⚡ Quick Start

import { chunk, sleep, getLogger, uuid, isEmail } from "@catbee/utils";

// Chunk an array
const result = chunk([1, 2, 3, 4, 5], 2); // [[1, 2], [3, 4], [5]]

// Sleep for 1 second
await sleep(1000);

// Log with context
getLogger().info("App started");

// Generate a secure UUID
console.log(uuid()); // e.g. 2a563ec1-caf6-4fe2-b60c-9cf7fb1bdb7f

// Basic validation
console.log(isEmail("[email protected]")); // true

📚 Modules Overview

| Module | Description | | ------ | ----------- | | Express Server | Fast, secure, and scalable server setup | | Array Utilities | Advanced array manipulation | | Async Utilities | Promise helpers, concurrency, timing | | Cache Utilities | In-memory caching with TTL | | Context Store | Per-request context via AsyncLocalStorage | | Crypto Utilities | Hashing, encryption, tokens | | Date Utilities | Date/time manipulation | | Decorators Utilities | TypeScript decorators for Express | | Directory Utilities | Directory and file system helpers | | Environment Utilities | Env variable management | | Exception Utilities | HTTP and error handling | | File System Utilities | File operations | | HTTP Status Codes | Typed status codes | | ID Utilities | UUID and ID generation | | Logger Utilities | Structured logging with Pino | | Middleware Utilities | Express middleware collection | | Object Utilities | Deep merge, flatten, pick/omit, etc. | | Performance Utilities | Timing, memoization, memory tracking | | Request Utilities | HTTP request parameter parsing/validation | | Response Utilities | Standardized API response formatting | | Stream Utilities | Stream conversion, batching, throttling, line splitting | | String Utilities | Casing, masking, slugifying, formatting | | Type Utilities | Type checking, conversion, guards | | URL Utilities | URL parsing, query manipulation, normalization | | Validate Utilities | Input validation functions |

🏁 Usage

Import only what you need:

import { chunk, sleep, TTLCache, getLogger } from "@catbee/utils";

📖 Documentation

• Full API Docs & Examples

📜 License

MIT © Catbee Technologies (see the LICENSE file for the full text)