fix: add withTimeout utility

[Rasagnika-GR]

🎯 Overview

Implements a reusable withTimeout() utility that wraps a Promise and rejects it if it exceeds a specified timeout duration. This addresses the need for fail-safe mechanisms in async operations like API calls and database requests that may hang or never resolve.

Closes #55

🔧 Changes Made

New File: utils/withTimeout.js

• Implemented withTimeout(promise, timeout) using Promise.race()
• Timer is cleared via .finally() after the promise settles to prevent memory leaks
• Exported as a named ES6 export

Edge Cases Handled

• Non-Promise input → rejects with TypeError
• timeout <= 0 → rejects immediately with RangeError
• Promise resolves before timeout → resolves normally
• Promise never resolves → rejects with timeout error

🧪 Testing

// Happy path
const data = await withTimeout(fetchData(), 2000);

// Edge cases
withTimeout('not-a-promise', 1000); // TypeError: First argument must be a Promise
withTimeout(fetchData(), 0);        // RangeError: Timeout must be greater than 0
withTimeout(fetchData(), -1);       // RangeError: Timeout must be greater than 0