trysafely/dist/index.js

A robust async helper to wrap promises and functions, returning [result, error] for graceful error handling.

"use strict";
Object.defineProperty(exports, "__esModule", { value: true });
exports.trySafely = trySafely;
/**
 * A robust asynchronous helper designed to simplify error handling by wrapping
 * a function that returns a Promise. It consistently returns a `Result<T>` object
 * (`{ result: T, error: null }` on success or `{ result: null, error: Error }` on failure),
 * allowing consumers to destructure and handle errors explicitly.
 *
 * This function defers the execution of the async operation until `trySafely` is invoked,
 * and also catches synchronous errors that might occur when `fn` is called.
 *
 * @template T The expected type of the successful asynchronous result.
 * @param {() => Promise<T>} fn The asynchronous function to execute. This function
 *   should return a Promise that resolves with type T or rejects with an error.
 * @returns {Promise<Result<T>>} A Promise that resolves to a `Result<T>` object.
 *   - On success: `{ result: T, error: null }`
 *   - On failure: `{ result: null, error: Error }`
 */
async function trySafely(fn) {
    try {
        const data = await fn();
        return { result: data, error: null };
    }
    catch (error) {
        const err = error instanceof Error ? error : new Error(String(error));
        return { result: null, error: err };
    }
}
//# sourceMappingURL=index.js.map