Introduction

@catbee/utils – The Ultimate Utility Toolkit for Node.js & TypeScript

A modular, production-grade utility library for Node.js and TypeScript, built for robust, scalable applications and enterprise Express services. Every utility is tree-shakable, fully typed, and can be imported independently for optimal bundle size.

🚀 Features

Type-safe: All utilities are fully typed for maximum safety and IDE support.
Tree-shakable: Import only what you need—no bloat, no dead code.
Production-ready: Designed for high-performance, scalable Node.js apps.
Express-friendly: Includes context, middleware, decorators, and server helpers.
Comprehensive: Covers arrays, objects, strings, streams, requests, responses, performance, caching, validation, and more.
Configurable: Global config system with environment variable support.
Minimal dependencies: Minimal footprint, maximum reliability.

📦 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('user@example.com')); // true

🏁 Usage Philosophy

Import only what you need to keep your bundle size small and your codebase clean:

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

⚙️ Configuration

Global configuration management with environment variable support:

Config – Centralized runtime configuration

🏢 Express Server

Enterprise-grade Express server utilities:

Express Server – Fast, secure, and scalable server setup

🧩 Utility Modules

Explore the full suite of utilities, each with detailed API docs and examples:

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

@catbee/utils – The Ultimate Utility Toolkit for Node.js & TypeScript​

🚀 Features​

📦 Installation​

⚡ Quick Start​

🏁 Usage Philosophy​

⚙️ Configuration​

🏢 Express Server​

🧩 Utility Modules​

📜 License​