rexfect 0.0.7

package/dist/async/safe.d.ts

@@ -0,0 +1,230 @@
+/**
+ * Safe execution utilities.
+ *
+ * Creates a `safe` function that wraps operations to be aware of cancellation/staleness.
+ * Reused by both effect context and async context.
+ */
+import type { Abortable } from "./abortable";
+/**
+ * Check if a value is a PromiseLike (has a .then method).
+ *
+ * @example
+ * isPromiseLike(Promise.resolve(1)) // true
+ * isPromiseLike({ then: () => {} }) // true
+ * isPromiseLike(42) // false
+ */
+export declare function isPromiseLike(value: unknown): value is PromiseLike<unknown>;
+/**
+ * Safe input: any value or parameterless function.
+ * Functions are invoked and their return value is processed.
+ */
+export type SafeInput<T> = T | (() => T);
+/**
+ * Extract the resolved type from a SafeInput.
+ */
+export type SafeInputResult<T> = T extends () => infer R ? Awaited<R> : Awaited<T>;
+type SafeAllArrayResult<T extends readonly SafeInput<any>[]> = {
+    -readonly [K in keyof T]: SafeInputResult<T[K]>;
+};
+type SafeAllObjectResult<T extends Record<string, SafeInput<any>>> = {
+    [K in keyof T]: SafeInputResult<T[K]>;
+};
+export interface SafeAll {
+    /**
+     * Wait for all inputs to complete. Returns array preserving order and types.
+     *
+     * @example
+     * const [user, posts] = await safe.all([fetchUser(), () => fetchPosts()]);
+     */
+    <T extends readonly SafeInput<any>[]>(inputs: [...T]): Promise<SafeAllArrayResult<T>>;
+    /**
+     * Wait for all inputs to complete. Returns object preserving keys.
+     *
+     * @example
+     * const { user, posts } = await safe.all({
+     *   user: fetchUser(),
+     *   posts: () => fetchPosts(),
+     * });
+     */
+    <T extends Record<string, SafeInput<any>>>(inputs: T): Promise<SafeAllObjectResult<T>>;
+}
+type SafeRaceArrayResult<T extends readonly SafeInput<any>[]> = SafeInputResult<T[number]>;
+type SafeRaceObjectResult<T extends Record<string, SafeInput<any>>> = {
+    [K in keyof T]: [K, SafeInputResult<T[K]>];
+}[keyof T];
+export interface SafeRace {
+    /**
+     * Race inputs. Returns the first value to resolve.
+     *
+     * @example
+     * const fastest = await safe.race([api1(), api2(), api3()]);
+     */
+    <T extends readonly SafeInput<any>[]>(inputs: [...T]): Promise<SafeRaceArrayResult<T>>;
+    /**
+     * Race inputs. Returns [winnerKey, value] tuple.
+     *
+     * @example
+     * const [winner, value] = await safe.race({
+     *   primary: primaryApi(),
+     *   fallback: fallbackApi(),
+     * });
+     * // winner: "primary" | "fallback"
+     */
+    <T extends Record<string, SafeInput<any>>>(inputs: T): Promise<SafeRaceObjectResult<T>>;
+}
+type SafeSettledArrayResult<T extends readonly SafeInput<any>[]> = {
+    -readonly [K in keyof T]: PromiseSettledResult<SafeInputResult<T[K]>>;
+};
+type SafeSettledObjectResult<T extends Record<string, SafeInput<any>>> = {
+    [K in keyof T]: PromiseSettledResult<SafeInputResult<T[K]>>;
+};
+export interface SafeSettled {
+    /**
+     * Wait for all inputs to settle (resolve or reject).
+     *
+     * @example
+     * const results = await safe.settled([api1(), api2()]);
+     * results.forEach(r => {
+     *   if (r.status === "fulfilled") console.log(r.value);
+     *   else console.error(r.reason);
+     * });
+     */
+    <T extends readonly SafeInput<any>[]>(inputs: [...T]): Promise<SafeSettledArrayResult<T>>;
+    /**
+     * Wait for all inputs to settle. Returns object with PromiseSettledResult values.
+     *
+     * @example
+     * const { user, posts } = await safe.settled({
+     *   user: fetchUser(),
+     *   posts: fetchPosts(),
+     * });
+     * if (user.status === "fulfilled") console.log(user.value);
+     */
+    <T extends Record<string, SafeInput<any>>>(inputs: T): Promise<SafeSettledObjectResult<T>>;
+}
+export interface SafeAny {
+    /**
+     * Returns the first successful result. Throws AggregateError if all fail.
+     *
+     * @example
+     * const result = await safe.any([api1(), api2(), api3()]);
+     */
+    <T extends readonly SafeInput<any>[]>(inputs: [...T]): Promise<SafeRaceArrayResult<T>>;
+    /**
+     * Returns [winnerKey, value] for first success. Throws AggregateError if all fail.
+     *
+     * @example
+     * const [winner, value] = await safe.any({
+     *   primary: primaryApi(),
+     *   fallback: fallbackApi(),
+     * });
+     */
+    <T extends Record<string, SafeInput<any>>>(inputs: T): Promise<SafeRaceObjectResult<T>>;
+}
+export interface SafeCallback {
+    /**
+     * Wrap a callback to only execute if not cancelled.
+     * If cancelled, the callback is a no-op.
+     *
+     * @example
+     * const handleClick = safe.callback((e: MouseEvent) => {
+     *   state.clicked = true;
+     * });
+     * document.addEventListener('click', handleClick);
+     */
+    <TArgs extends any[]>(callback: (...args: TArgs) => void): (...args: TArgs) => void;
+}
+export interface SafeDelay {
+    /**
+     * Delay execution for specified milliseconds.
+     * Never resolves if cancelled.
+     *
+     * @example
+     * // Wait 1 second
+     * await safe.delay(1000);
+     *
+     * // Wait and return a value
+     * const result = await safe.delay(500, "done");
+     */
+    <T = void>(ms: number, resolved?: T): Promise<T>;
+}
+/**
+ * Safe function type returned by createSafe.
+ *
+ * Overloads:
+ * 1. `safe(promise)` - Wrap promise, never resolve/reject if cancelled
+ * 2. `safe(normalFn, ...args)` - Call function, wrap result if promise
+ * 3. `safe(Abortable, ...args)` - Call with signal, wrap result if promise
+ */
+export interface SafeFn {
+    /**
+     * Wrap a promise to never resolve/reject if cancelled.
+     *
+     * @example
+     * ctx.safe(fetchData()).then(data => {
+     *   // Only runs if not cancelled
+     *   state.data = data;
+     * });
+     */
+    <T>(promise: PromiseLike<T>): Promise<T>;
+    /**
+     * Call a normal function and wrap result if it's a promise.
+     *
+     * @example
+     * const result = await ctx.safe(myAsyncFn, arg1, arg2);
+     */
+    <TArgs extends any[], TResult>(fn: (...args: TArgs) => TResult, ...args: TArgs): TResult extends PromiseLike<infer U> ? Promise<U> : TResult;
+    /**
+     * Call an abortable function with the context's signal.
+     * Wraps result if it's a promise.
+     *
+     * @example
+     * const user = await ctx.safe(getUser, userId);
+     */
+    <TArgs extends any[], TResult>(fn: Abortable<TArgs, TResult>, ...args: TArgs): TResult extends PromiseLike<infer U> ? Promise<U> : TResult;
+}
+/**
+ * Safe function with utility methods for concurrent operations.
+ */
+export interface SafeFnWithUtils extends SafeFn {
+    /** Wait for all inputs to complete */
+    all: SafeAll;
+    /** Race inputs, return first to resolve */
+    race: SafeRace;
+    /** Wait for all inputs to settle (resolve or reject) */
+    settled: SafeSettled;
+    /** Return first successful result */
+    any: SafeAny;
+    /** Wrap callback to only execute if not cancelled */
+    callback: SafeCallback;
+    /** Delay execution, never resolves if cancelled */
+    delay: SafeDelay;
+}
+/**
+ * Create a safe function for a given context.
+ *
+ * @param getSignal - Function to get the current AbortSignal
+ * @param isCancelled - Function to check if the context is cancelled/stale
+ * @returns A safe function with utility methods
+ *
+ * @example
+ * ```ts
+ * const safe = createSafe(
+ *   () => abortController.signal,
+ *   () => abortController.signal.aborted
+ * );
+ *
+ * // Wrap promise
+ * await safe(fetchData());
+ *
+ * // Call abortable function
+ * await safe(getUser, userId);
+ *
+ * // Concurrent operations
+ * const [a, b] = await safe.all([fetchA(), fetchB()]);
+ * const fastest = await safe.race([api1(), api2()]);
+ * ```
+ */
+export declare function createSafe(getSignal: () => AbortSignal | undefined, isCancelled: () => boolean): SafeFnWithUtils;
+export {};
+//# sourceMappingURL=safe.d.ts.map

package/dist/async/safe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe.d.ts","sourceRoot":"","sources":["../../src/async/safe.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAO7C;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAAC,OAAO,CAAC,CAO3E;AA6CD;;;GAGG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;AAEzC;;GAEG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,MAAM,CAAC,GACpD,OAAO,CAAC,CAAC,CAAC,GACV,OAAO,CAAC,CAAC,CAAC,CAAC;AAMf,KAAK,kBAAkB,CAAC,CAAC,SAAS,SAAS,SAAS,CAAC,GAAG,CAAC,EAAE,IAAI;IAC7D,CAAC,UAAU,CAAC,IAAI,MAAM,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAChD,CAAC;AAEF,KAAK,mBAAmB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI;KAClE,CAAC,IAAI,MAAM,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CACtC,CAAC;AAEF,MAAM,WAAW,OAAO;IACtB;;;;;OAKG;IACH,CAAC,CAAC,SAAS,SAAS,SAAS,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,OAAO,CAC5D,kBAAkB,CAAC,CAAC,CAAC,CACtB,CAAC;IAEF;;;;;;;;OAQG;IACH,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,OAAO,CAC5D,mBAAmB,CAAC,CAAC,CAAC,CACvB,CAAC;CACH;AAMD,KAAK,mBAAmB,CAAC,CAAC,SAAS,SAAS,SAAS,CAAC,GAAG,CAAC,EAAE,IAAI,eAAe,CAC7E,CAAC,CAAC,MAAM,CAAC,CACV,CAAC;AAEF,KAAK,oBAAoB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI;KACnE,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAC3C,CAAC,MAAM,CAAC,CAAC,CAAC;AAEX,MAAM,WAAW,QAAQ;IACvB;;;;;OAKG;IACH,CAAC,CAAC,SAAS,SAAS,SAAS,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,OAAO,CAC5D,mBAAmB,CAAC,CAAC,CAAC,CACvB,CAAC;IAEF;;;;;;;;;OASG;IACH,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,OAAO,CAC5D,oBAAoB,CAAC,CAAC,CAAC,CACxB,CAAC;CACH;AAMD,KAAK,sBAAsB,CAAC,CAAC,SAAS,SAAS,SAAS,CAAC,GAAG,CAAC,EAAE,IAAI;IACjE,CAAC,UAAU,CAAC,IAAI,MAAM,CAAC,GAAG,oBAAoB,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CACtE,CAAC;AAEF,KAAK,uBAAuB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI;KACtE,CAAC,IAAI,MAAM,CAAC,GAAG,oBAAoB,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAC5D,CAAC;AAEF,MAAM,WAAW,WAAW;IAC1B;;;;;;;;;OASG;IACH,CAAC,CAAC,SAAS,SAAS,SAAS,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,OAAO,CAC5D,sBAAsB,CAAC,CAAC,CAAC,CAC1B,CAAC;IAEF;;;;;;;;;OASG;IACH,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,OAAO,CAC5D,uBAAuB,CAAC,CAAC,CAAC,CAC3B,CAAC;CACH;AAMD,MAAM,WAAW,OAAO;IACtB;;;;;OAKG;IACH,CAAC,CAAC,SAAS,SAAS,SAAS,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,OAAO,CAC5D,mBAAmB,CAAC,CAAC,CAAC,CACvB,CAAC;IAEF;;;;;;;;OAQG;IACH,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,OAAO,CAC5D,oBAAoB,CAAC,CAAC,CAAC,CACxB,CAAC;CACH;AAMD,MAAM,WAAW,YAAY;IAC3B;;;;;;;;;OASG;IACH,CAAC,KAAK,SAAS,GAAG,EAAE,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,IAAI,GAAG,CACzD,GAAG,IAAI,EAAE,KAAK,KACX,IAAI,CAAC;CACX;AAMD,MAAM,WAAW,SAAS;IACxB;;;;;;;;;;OAUG;IACH,CAAC,CAAC,GAAG,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAClD;AAMD;;;;;;;GAOG;AACH,MAAM,WAAW,MAAM;IACrB;;;;;;;;OAQG;IACH,CAAC,CAAC,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAEzC;;;;;OAKG;IACH,CAAC,KAAK,SAAS,GAAG,EAAE,EAAE,OAAO,EAC3B,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,EAC/B,GAAG,IAAI,EAAE,KAAK,GACb,OAAO,SAAS,WAAW,CAAC,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC;IAE/D;;;;;;OAMG;IACH,CAAC,KAAK,SAAS,GAAG,EAAE,EAAE,OAAO,EAC3B,EAAE,EAAE,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,EAC7B,GAAG,IAAI,EAAE,KAAK,GACb,OAAO,SAAS,WAAW,CAAC,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC;CAChE;AAED;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,MAAM;IAC7C,sCAAsC;IACtC,GAAG,EAAE,OAAO,CAAC;IACb,2CAA2C;IAC3C,IAAI,EAAE,QAAQ,CAAC;IACf,wDAAwD;IACxD,OAAO,EAAE,WAAW,CAAC;IACrB,qCAAqC;IACrC,GAAG,EAAE,OAAO,CAAC;IACb,qDAAqD;IACrD,QAAQ,EAAE,YAAY,CAAC;IACvB,mDAAmD;IACnD,KAAK,EAAE,SAAS,CAAC;CAClB;AAMD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,UAAU,CACxB,SAAS,EAAE,MAAM,WAAW,GAAG,SAAS,EACxC,WAAW,EAAE,MAAM,OAAO,GACzB,eAAe,CA4NjB"}

package/dist/async/safe.js

@@ -0,0 +1,247 @@
+/**
+ * Safe execution utilities.
+ *
+ * Creates a `safe` function that wraps operations to be aware of cancellation/staleness.
+ * Reused by both effect context and async context.
+ */
+import { isAbortable } from "./abortable-guard";
+import { toPromise } from "./utils";
+// =============================================================================
+// UTILITY: isPromiseLike & toPromise
+// =============================================================================
+/**
+ * Check if a value is a PromiseLike (has a .then method).
+ *
+ * @example
+ * isPromiseLike(Promise.resolve(1)) // true
+ * isPromiseLike({ then: () => {} }) // true
+ * isPromiseLike(42) // false
+ */
+export function isPromiseLike(value) {
+    return (value !== null &&
+        typeof value === "object" &&
+        "then" in value &&
+        typeof value.then === "function");
+}
+/**
+ * AggregateError polyfill for environments without ES2021 support.
+ */
+class AggregateErrorImpl extends Error {
+    errors;
+    constructor(errors, message) {
+        super(message);
+        this.name = "AggregateError";
+        this.errors = errors;
+    }
+}
+/**
+ * Polyfill for Promise.any (ES2021).
+ * Returns first fulfilled promise, or rejects with AggregateError if all reject.
+ */
+function promiseAny(promises) {
+    return new Promise((resolve, reject) => {
+        const promiseArray = Array.from(promises);
+        if (promiseArray.length === 0) {
+            reject(new AggregateErrorImpl([], "All promises were rejected"));
+            return;
+        }
+        const errors = [];
+        let rejectedCount = 0;
+        promiseArray.forEach((promise, index) => {
+            Promise.resolve(promise).then(resolve, (error) => {
+                errors[index] = error;
+                rejectedCount++;
+                if (rejectedCount === promiseArray.length) {
+                    reject(new AggregateErrorImpl(errors, "All promises were rejected"));
+                }
+            });
+        });
+    });
+}
+// =============================================================================
+// CREATE SAFE
+// =============================================================================
+/**
+ * Create a safe function for a given context.
+ *
+ * @param getSignal - Function to get the current AbortSignal
+ * @param isCancelled - Function to check if the context is cancelled/stale
+ * @returns A safe function with utility methods
+ *
+ * @example
+ * ```ts
+ * const safe = createSafe(
+ *   () => abortController.signal,
+ *   () => abortController.signal.aborted
+ * );
+ *
+ * // Wrap promise
+ * await safe(fetchData());
+ *
+ * // Call abortable function
+ * await safe(getUser, userId);
+ *
+ * // Concurrent operations
+ * const [a, b] = await safe.all([fetchA(), fetchB()]);
+ * const fastest = await safe.race([api1(), api2()]);
+ * ```
+ */
+export function createSafe(getSignal, isCancelled) {
+    /**
+     * Wrap a promise to never resolve/reject if cancelled.
+     */
+    function wrapPromise(promise) {
+        return new Promise((resolve, reject) => {
+            promise.then((value) => {
+                if (!isCancelled()) {
+                    resolve(value);
+                }
+                // Never resolve/reject if cancelled - promise stays pending
+            }, (error) => {
+                if (!isCancelled()) {
+                    reject(error);
+                }
+                // Never resolve/reject if cancelled
+            });
+        });
+    }
+    /**
+     * Wrap a value - if it's a promise-like, wrap it.
+     */
+    function wrapResult(result) {
+        if (isPromiseLike(result)) {
+            return wrapPromise(result);
+        }
+        return result;
+    }
+    /**
+     * Convert and wrap input with never-resolve-if-cancelled behavior.
+     */
+    function wrapInput(input) {
+        return wrapPromise(toPromise(input));
+    }
+    /**
+     * The safe function implementation.
+     */
+    function safe(input, ...args) {
+        // Check if cancelled before doing anything
+        if (isCancelled()) {
+            // Return a never-resolving promise for consistency
+            if (isPromiseLike(input)) {
+                return new Promise(() => { });
+            }
+            // For functions, still call but wrap result
+        }
+        // Case 1: PromiseLike - wrap it
+        if (isPromiseLike(input)) {
+            return wrapPromise(input);
+        }
+        // Case 2: Abortable - call with signal and wrap result
+        if (isAbortable(input)) {
+            const signal = getSignal();
+            const result = input.withSignal(signal, ...args);
+            return wrapResult(result);
+        }
+        // Case 3: Normal function - call and wrap result
+        if (typeof input === "function") {
+            const result = input(...args);
+            return wrapResult(result);
+        }
+        // Fallback - shouldn't happen with proper types
+        return input;
+    }
+    // ---------------------------------------------------------------------------
+    // safe.all
+    // ---------------------------------------------------------------------------
+    const all = ((inputs) => {
+        if (isCancelled()) {
+            return new Promise(() => { });
+        }
+        if (Array.isArray(inputs)) {
+            return Promise.all(inputs.map(wrapInput));
+        }
+        // Object case
+        const obj = inputs;
+        const keys = Object.keys(obj);
+        return Promise.all(keys.map((k) => wrapInput(obj[k]))).then((values) => Object.fromEntries(keys.map((k, i) => [k, values[i]])));
+    });
+    // ---------------------------------------------------------------------------
+    // safe.race
+    // ---------------------------------------------------------------------------
+    const race = ((inputs) => {
+        if (isCancelled()) {
+            return new Promise(() => { });
+        }
+        if (Array.isArray(inputs)) {
+            return Promise.race(inputs.map(wrapInput));
+        }
+        // Object case - return [key, value] tuple
+        const obj = inputs;
+        const keys = Object.keys(obj);
+        return Promise.race(keys.map((k) => wrapInput(obj[k]).then((v) => [k, v])));
+    });
+    // ---------------------------------------------------------------------------
+    // safe.settled
+    // ---------------------------------------------------------------------------
+    const settled = ((inputs) => {
+        if (isCancelled()) {
+            return new Promise(() => { });
+        }
+        if (Array.isArray(inputs)) {
+            return wrapPromise(Promise.allSettled(inputs.map(toPromise)));
+        }
+        // Object case
+        const obj = inputs;
+        const keys = Object.keys(obj);
+        return wrapPromise(Promise.allSettled(keys.map((k) => toPromise(obj[k])))).then((results) => Object.fromEntries(keys.map((k, i) => [k, results[i]])));
+    });
+    // ---------------------------------------------------------------------------
+    // safe.any
+    // ---------------------------------------------------------------------------
+    const any = ((inputs) => {
+        if (isCancelled()) {
+            return new Promise(() => { });
+        }
+        if (Array.isArray(inputs)) {
+            return wrapPromise(promiseAny(inputs.map(toPromise)));
+        }
+        // Object case - return [key, value] tuple
+        const obj = inputs;
+        const keys = Object.keys(obj);
+        return wrapPromise(promiseAny(keys.map((k) => toPromise(obj[k]).then((v) => [k, v]))));
+    });
+    // ---------------------------------------------------------------------------
+    // safe.callback
+    // ---------------------------------------------------------------------------
+    const callback = ((cb) => {
+        return (...args) => {
+            if (isCancelled()) {
+                return;
+            }
+            cb(...args);
+        };
+    });
+    // ---------------------------------------------------------------------------
+    // safe.delay
+    // ---------------------------------------------------------------------------
+    const delay = ((ms, resolved) => {
+        if (isCancelled()) {
+            return new Promise(() => { });
+        }
+        return wrapPromise(new Promise((resolve) => {
+            setTimeout(() => resolve(resolved), ms);
+        }));
+    });
+    // ---------------------------------------------------------------------------
+    // Return safe with utilities attached
+    // ---------------------------------------------------------------------------
+    return Object.assign(safe, {
+        all,
+        race,
+        settled,
+        any,
+        callback,
+        delay,
+    });
+}
+//# sourceMappingURL=safe.js.map

package/dist/async/safe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe.js","sourceRoot":"","sources":["../../src/async/safe.ts"],"names":[],"mappings":"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"}

package/dist/async/safe.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=safe.test.d.ts.map

package/dist/async/safe.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe.test.d.ts","sourceRoot":"","sources":["../../src/async/safe.test.ts"],"names":[],"mappings":""}