rexfect 0.0.7

package/dist/abortableContext.d.ts

@@ -0,0 +1,3 @@
+import { type AbortableContext } from "./types";
+export declare function abortableContext(controller: AbortController, prevController?: AbortController | null): AbortableContext;
+//# sourceMappingURL=abortableContext.d.ts.map

package/dist/abortableContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abortableContext.d.ts","sourceRoot":"","sources":["../src/abortableContext.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEhD,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,eAAe,EAC3B,cAAc,CAAC,EAAE,eAAe,GAAG,IAAI,GACtC,gBAAgB,CA0DlB"}

package/dist/abortableContext.js

@@ -0,0 +1,48 @@
+export function abortableContext(controller, prevController) {
+    const ctx = {
+        signal: controller.signal,
+        abort() {
+            controller.abort();
+        },
+        abortPrev(message) {
+            prevController?.abort(message);
+        },
+        safe(promiseOrCallback) {
+            if (typeof promiseOrCallback === "function") {
+                return (...args) => {
+                    if (!controller.signal.aborted) {
+                        return promiseOrCallback(...args);
+                    }
+                };
+            }
+            return new Promise((resolve, reject) => {
+                promiseOrCallback.then((value) => {
+                    if (!controller.signal.aborted) {
+                        resolve(value);
+                    }
+                }, (error) => {
+                    if (!controller.signal.aborted) {
+                        reject(error);
+                    }
+                });
+            });
+        },
+        fork() {
+            const childController = new AbortController();
+            const handler = () => {
+                controller.signal.removeEventListener("abort", handler);
+                childController.abort();
+            };
+            controller.signal.addEventListener("abort", handler);
+            return abortableContext(childController);
+        },
+        spawn() {
+            return abortableContext(new AbortController());
+        },
+        use(plugin, ...args) {
+            return plugin(ctx, ...args);
+        },
+    };
+    return ctx;
+}
+//# sourceMappingURL=abortableContext.js.map

package/dist/abortableContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abortableContext.js","sourceRoot":"","sources":["../src/abortableContext.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,gBAAgB,CAC9B,UAA2B,EAC3B,cAAuC;IAEvC,MAAM,GAAG,GAAqB;QAC5B,MAAM,EAAE,UAAU,CAAC,MAAM;QAEzB,KAAK;YACH,UAAU,CAAC,KAAK,EAAE,CAAC;QACrB,CAAC;QAED,SAAS,CAAC,OAAgB;YACxB,cAAc,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QACjC,CAAC;QAED,IAAI,CACF,iBAA8D;YAE9D,IAAI,OAAO,iBAAiB,KAAK,UAAU,EAAE,CAAC;gBAC5C,OAAO,CAAC,GAAG,IAAW,EAAE,EAAE;oBACxB,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;wBAC/B,OAAO,iBAAiB,CAAC,GAAG,IAAI,CAAC,CAAC;oBACpC,CAAC;gBACH,CAAC,CAAC;YACJ,CAAC;YACD,OAAO,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBACxC,iBAAiB,CAAC,IAAI,CACpB,CAAC,KAAK,EAAE,EAAE;oBACR,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;wBAC/B,OAAO,CAAC,KAAK,CAAC,CAAC;oBACjB,CAAC;gBACH,CAAC,EACD,CAAC,KAAK,EAAE,EAAE;oBACR,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;wBAC/B,MAAM,CAAC,KAAK,CAAC,CAAC;oBAChB,CAAC;gBACH,CAAC,CACF,CAAC;YACJ,CAAC,CAAC,CAAC;QACL,CAAC;QAED,IAAI;YACF,MAAM,eAAe,GAAG,IAAI,eAAe,EAAE,CAAC;YAC9C,MAAM,OAAO,GAAG,GAAG,EAAE;gBACnB,UAAU,CAAC,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBACxD,eAAe,CAAC,KAAK,EAAE,CAAC;YAC1B,CAAC,CAAC;YACF,UAAU,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACrD,OAAO,gBAAgB,CAAC,eAAe,CAAC,CAAC;QAC3C,CAAC;QAED,KAAK;YACH,OAAO,gBAAgB,CAAC,IAAI,eAAe,EAAE,CAAC,CAAC;QACjD,CAAC;QAED,GAAG,CAAC,MAAM,EAAE,GAAG,IAAI;YACjB,OAAO,MAAM,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;QAC9B,CAAC;KACF,CAAC;IAEF,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/action.d.ts

@@ -0,0 +1,64 @@
+import type { ActionOptions, Action } from "./types";
+/**
+ * Creates an action - the core primitive for dispatch and notification.
+ *
+ * ## Two Patterns
+ *
+ * **Void action** (`action<T>()`):
+ * - For notifications/events (use "on" prefix naming: `onClick`, `onSubmit`)
+ * - Dispatching returns void
+ * - Listeners receive the payload
+ *
+ * **Action with handler** (`action<T, R>(handler)`):
+ * - For commands that return results (use verb naming: `addToCart`, `fetchUser`)
+ * - Handler executes first, returns result to caller
+ * - Listeners still receive the original payload (not the result)
+ *
+ * ## Key Features
+ *
+ * - **Thenable**: Actions implement PromiseLike, so `await action` waits for next dispatch
+ * - **Sealed**: With `{ sealed: true }`, action fires once then ignores subsequent calls
+ * - **Late subscribers**: On sealed actions, late `.on()` calls fire immediately with last payload
+ * - **Simple**: Handlers and listeners are plain functions - no context needed
+ *
+ * @example
+ * // Void action for notifications (use "on" prefix naming)
+ * const onClick = action<MouseEvent>();
+ * onClick.on((e) => {
+ *   console.log("Clicked at:", e.clientX, e.clientY);
+ * });
+ * onClick(mouseEvent); // dispatch → void
+ *
+ * @example
+ * // Action with handler (use verb naming)
+ * const addToCart = action((product: Product) => {
+ *   const item = createCartItem(product);
+ *   setCart([...cart(), item]);
+ *   return item; // returned to caller
+ * });
+ * const item = addToCart(product); // dispatch → CartItem
+ * addToCart.on((product) => {
+ *   // Listeners receive payload, not result
+ *   analytics.track('add_to_cart', product);
+ * });
+ *
+ * @example
+ * // Async handler (for cancellation, use abortable wrapper)
+ * const searchAbortable = abortable(async ({ signal, abort }, query: string) => {
+ *   abort(); // Cancel previous
+ *   const res = await fetch(`/search?q=${query}`, { signal });
+ *   return res.json();
+ * });
+ * const search = action((query: string) => searchAbortable(query));
+ * const results = await search("hello");
+ *
+ * @example
+ * // Sealed action for one-time initialization
+ * const onAppReady = action<Config>({ sealed: true });
+ * onAppReady(config); // fires listeners
+ * onAppReady(config); // no-op (already sealed)
+ * onAppReady.on(cb);  // late subscriber → cb fires immediately with last payload
+ */
+export declare function action<T = void>(options?: ActionOptions): Action<T, void>;
+export declare function action<H extends (payload: any) => any>(handler: H, options?: ActionOptions): Action<Parameters<H>[0], ReturnType<H>>;
+//# sourceMappingURL=action.d.ts.map

package/dist/action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action.d.ts","sourceRoot":"","sources":["../src/action.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAuBrD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2DG;AACH,wBAAgB,MAAM,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;AAC3E,wBAAgB,MAAM,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,GAAG,KAAK,GAAG,EACpD,OAAO,EAAE,CAAC,EACV,OAAO,CAAC,EAAE,aAAa,GACtB,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC"}

package/dist/action.js

@@ -0,0 +1,208 @@
+import { batch } from "./batch";
+import { defer } from "./defer";
+/** No-op function returned for sealed action late subscribers */
+const noop = () => { };
+export function action(handlerOrOptions, maybeOptions) {
+    // ---------------------------------------------------------------------------
+    // Parse arguments: action(options?) or action(handler, options?)
+    // ---------------------------------------------------------------------------
+    const handler = typeof handlerOrOptions === "function" ? handlerOrOptions : undefined;
+    const options = typeof handlerOrOptions === "object"
+        ? handlerOrOptions
+        : maybeOptions ?? {};
+    // ---------------------------------------------------------------------------
+    // Internal State
+    // ---------------------------------------------------------------------------
+    /**
+     * Set of active listener entries.
+     * Lazily created on first `.on()` call to avoid allocation for actions
+     * that are only used for their handler (no listeners).
+     */
+    let listeners;
+    /** True after first dispatch if options.sealed is true */
+    let isSealed = false;
+    /** True after dispose() is called */
+    let disposed = false;
+    /**
+     * Stores the most recent dispatch payload and its associated promise.
+     * Used for:
+     * - `.latest()` to return last value without waiting
+     * - Late subscribers on sealed actions
+     * - `.fired()` check
+     */
+    let lastDispatch;
+    /**
+     * Deferred promise for the NEXT dispatch.
+     * Created lazily when someone awaits the action or calls `.then()`.
+     * Resolved when dispatch() is called, then cleared.
+     */
+    let nextDispatch;
+    // ---------------------------------------------------------------------------
+    // Internal Helpers
+    // ---------------------------------------------------------------------------
+    /**
+     * Returns a promise that resolves on the next dispatch.
+     * If already sealed, returns the last dispatch promise immediately.
+     */
+    const next = () => {
+        // Sealed actions always resolve to the last payload
+        if (isSealed && lastDispatch) {
+            return lastDispatch.promise;
+        }
+        // Create deferred if not exists (lazy)
+        nextDispatch = defer();
+        return nextDispatch.promise;
+    };
+    /**
+     * Invokes a single listener with the given payload.
+     *
+     * Simple function call - no context, no error handling.
+     * Errors propagate normally (can be caught by caller if needed).
+     */
+    const fire = (payload, entry) => {
+        if (!entry.active)
+            return;
+        entry.fn(payload);
+    };
+    // ---------------------------------------------------------------------------
+    // Dispatch Function (the callable part of the action)
+    // ---------------------------------------------------------------------------
+    /**
+     * Main dispatch function - called when you invoke the action: `myAction(payload)`.
+     *
+     * Execution order:
+     * 1. Execute handler (if exists) and capture result (wrapped in batch)
+     * 2. If sealed/disposed, return result early (skip listeners)
+     * 3. Resolve any pending `await action` promises
+     * 4. Store this dispatch as lastDispatch
+     * 5. If options.sealed, mark as sealed (subsequent dispatches become no-ops)
+     * 6. Fire all listeners with the payload
+     * 7. Return handler result (or undefined for void actions)
+     */
+    const dispatch = (payload) => {
+        // Step 1: Execute handler first (if exists), get result
+        // Handler runs in a batch to coalesce any atom updates it makes
+        let result = undefined;
+        if (handler) {
+            result = batch(() => handler(payload));
+        }
+        // Step 2: Early exit if sealed or disposed
+        // Note: handler still executes even if sealed (for actions with handlers)
+        // but listeners don't fire
+        if (isSealed || disposed)
+            return result;
+        // Step 3: Resolve any awaiting promises
+        nextDispatch?.resolve(payload);
+        // Step 4: Store this dispatch
+        lastDispatch = {
+            payload,
+            promise: nextDispatch?.promise ?? Promise.resolve(payload),
+        };
+        // Clear the deferred - next await will create a new one
+        nextDispatch = undefined;
+        // Step 5: Seal if configured
+        if (options.sealed) {
+            isSealed = true;
+        }
+        // Step 6: Fire all listeners
+        // Copy the set to avoid issues if listeners unsubscribe during iteration
+        if (listeners?.size) {
+            const copyListeners = [...listeners];
+            for (const entry of copyListeners) {
+                fire(payload, entry);
+            }
+        }
+        // Step 7: Return handler result
+        return result;
+    };
+    // ---------------------------------------------------------------------------
+    // Build the Action Object
+    // ---------------------------------------------------------------------------
+    /**
+     * The action object combines the dispatch function with additional methods.
+     * This uses Object.assign to make dispatch callable while adding properties.
+     */
+    const actionObj = Object.assign(dispatch, {
+        as() {
+            return dispatch;
+        },
+        /** Returns true if this action is sealed (no more dispatches will fire listeners) */
+        sealed: () => isSealed,
+        /** Returns true if this action has been dispatched at least once */
+        fired: () => !!lastDispatch,
+        /**
+         * Returns a promise that resolves with the last dispatched payload,
+         * or waits for the next dispatch if never fired.
+         *
+         * Unlike `await action` (which always waits for NEXT dispatch),
+         * `.latest()` returns immediately if there's already a value.
+         */
+        latest() {
+            if (lastDispatch) {
+                return lastDispatch.promise;
+            }
+            return next();
+        },
+        /**
+         * Subscribes a listener to this action.
+         *
+         * @param listener - Called on each dispatch with payload
+         * @returns Unsubscribe function
+         *
+         * Special behavior for sealed actions:
+         * - If already sealed AND fired, listener is called immediately
+         *   with the last payload, and returns a no-op unsubscribe
+         */
+        on(listener) {
+            // Create entry for this subscription
+            const entry = {
+                fn: listener,
+                active: true,
+            };
+            // Late subscriber on sealed action: fire immediately
+            if (isSealed && lastDispatch) {
+                fire(lastDispatch.payload, entry);
+                return noop; // No need to unsubscribe - won't fire again
+            }
+            // Lazy create listeners Set on first subscription
+            if (!listeners)
+                listeners = new Set();
+            listeners.add(entry);
+            // Return unsubscribe function
+            return () => {
+                if (!entry.active)
+                    return; // Already unsubscribed
+                entry.active = false;
+                listeners?.delete(entry);
+            };
+        },
+        /**
+         * Makes the action thenable (PromiseLike).
+         *
+         * This enables `await action` to wait for the next dispatch.
+         * Always waits for the NEXT dispatch, even if action has fired before.
+         * (Use `.latest()` to get the last value immediately if available)
+         */
+        then(onFulfilled, onRejected) {
+            return next().then(onFulfilled, onRejected);
+        },
+        /**
+         * Disposes the action, clearing all listeners and state.
+         *
+         * After dispose:
+         * - Dispatch still works (handler executes) but listeners don't fire
+         * - New `.on()` calls still work but listeners won't fire
+         * - `await action` will hang forever
+         */
+        dispose() {
+            if (disposed)
+                return;
+            disposed = true;
+            listeners?.clear();
+            lastDispatch = undefined;
+            nextDispatch = undefined;
+        },
+    });
+    return actionObj;
+}
+//# sourceMappingURL=action.js.map

package/dist/action.js.map

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

package/dist/action.test.d.ts

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

package/dist/action.test.d.ts.map

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

package/dist/action.test.js

@@ -0,0 +1,189 @@
+import { describe, it, expect, vi } from "vitest";
+import { action } from "./action";
+describe("action", () => {
+    describe("void action (no handler)", () => {
+        describe("dispatch", () => {
+            it("should dispatch action to listeners", () => {
+                const onClick = action();
+                const listener = vi.fn();
+                onClick.on(listener);
+                onClick(42);
+                expect(listener).toHaveBeenCalledWith(42);
+            });
+            it("should support void payload", () => {
+                const onReset = action();
+                const listener = vi.fn();
+                onReset.on(listener);
+                onReset();
+                expect(listener).toHaveBeenCalled();
+            });
+            it("should return void for void actions", () => {
+                const onClick = action();
+                const result = onClick(42);
+                expect(result).toBeUndefined();
+            });
+        });
+        describe("fired", () => {
+            it("should track if action has been fired", () => {
+                const onClick = action();
+                expect(onClick.fired()).toBe(false);
+                expect(!onClick.fired()).toBe(true);
+                onClick(1);
+                expect(onClick.fired()).toBe(true);
+                expect(!onClick.fired()).toBe(false);
+            });
+        });
+        describe("sealed", () => {
+            it("should auto-seal after first dispatch", () => {
+                const onInit = action({ sealed: true });
+                expect(onInit.sealed()).toBe(false);
+                onInit("first");
+                expect(onInit.sealed()).toBe(true);
+            });
+            it("should ignore subsequent dispatches when sealed", () => {
+                const onInit = action({ sealed: true });
+                const listener = vi.fn();
+                onInit.on(listener);
+                onInit("first");
+                onInit("second");
+                expect(listener).toHaveBeenCalledTimes(1);
+                expect(listener).toHaveBeenCalledWith("first");
+            });
+            it("should call late listeners immediately with sealed value", () => {
+                const onInit = action({ sealed: true });
+                onInit("config");
+                const lateListener = vi.fn();
+                onInit.on(lateListener);
+                expect(lateListener).toHaveBeenCalledWith("config");
+            });
+        });
+        describe("latest", () => {
+            it("should resolve immediately if already dispatched", async () => {
+                const onData = action();
+                onData(42);
+                const result = await onData.latest();
+                expect(result).toBe(42);
+            });
+            it("should wait for dispatch if not fired", async () => {
+                const onData = action();
+                const promise = onData.latest();
+                setTimeout(() => onData(100), 10);
+                const result = await promise;
+                expect(result).toBe(100);
+            });
+        });
+        describe("thenable (await action)", () => {
+            it("should wait for next dispatch", async () => {
+                const onClick = action();
+                const promise = onClick.then((value) => value.toUpperCase());
+                setTimeout(() => onClick("hello"), 10);
+                const result = await promise;
+                expect(result).toBe("HELLO");
+            });
+            it("should resolve immediately if sealed", async () => {
+                const onInit = action({ sealed: true });
+                onInit("sealed-value");
+                const result = await onInit;
+                expect(result).toBe("sealed-value");
+            });
+        });
+        describe("on listener", () => {
+            it("should return unsubscribe function", () => {
+                const onClick = action();
+                const listener = vi.fn();
+                const unsubscribe = onClick.on(listener);
+                onClick(1);
+                expect(listener).toHaveBeenCalledTimes(1);
+                unsubscribe();
+                onClick(2);
+                expect(listener).toHaveBeenCalledTimes(1);
+            });
+        });
+    });
+    describe("action with handler", () => {
+        it("should execute handler and return result", () => {
+            const addToCart = action((product) => {
+                return {
+                    ...product,
+                    cartItemId: `cart-${product.id}`,
+                    addedAt: Date.now(),
+                };
+            });
+            const result = addToCart({ id: "prod-1", price: 100 });
+            expect(result.cartItemId).toBe("cart-prod-1");
+            expect(result.id).toBe("prod-1");
+            expect(result.price).toBe(100);
+            expect(result.addedAt).toBeTypeOf("number");
+        });
+        it("should notify listeners with original payload", () => {
+            const listener = vi.fn();
+            const addToCart = action((product) => {
+                return { ...product, processed: true };
+            });
+            addToCart.on(listener);
+            addToCart({ id: "prod-1" });
+            // Listener receives original payload, not the result
+            expect(listener).toHaveBeenCalledWith({ id: "prod-1" });
+        });
+        it("should execute handler synchronously", () => {
+            const order = [];
+            const doSomething = action((value) => {
+                order.push(`handler:${value}`);
+                return value.toUpperCase();
+            });
+            doSomething.on((value) => {
+                order.push(`listener:${value}`);
+            });
+            const result = doSomething("test");
+            expect(result).toBe("TEST");
+            expect(order).toEqual(["handler:test", "listener:test"]);
+        });
+        it("should still support await for payload", async () => {
+            const addToCart = action((product) => {
+                return { ...product, cartItemId: `cart-${product.id}` };
+            });
+            const promise = addToCart.then((payload) => payload.id);
+            setTimeout(() => addToCart({ id: "prod-1" }), 10);
+            const result = await promise;
+            expect(result).toBe("prod-1"); // Gets payload.id, not result
+        });
+        it("should support async handlers", async () => {
+            const fetchUser = action(async (id) => {
+                // Simulating async operation
+                await new Promise((r) => setTimeout(r, 10));
+                return { id, name: `User ${id}` };
+            });
+            const resultPromise = fetchUser("123");
+            expect(resultPromise).toBeInstanceOf(Promise);
+            const result = await resultPromise;
+            expect(result).toEqual({ id: "123", name: "User 123" });
+        });
+        it("should execute handler even when sealed", () => {
+            let handlerCallCount = 0;
+            const onInit = action((value) => {
+                handlerCallCount++;
+                return value.toUpperCase();
+            }, { sealed: true });
+            const result1 = onInit("first");
+            expect(result1).toBe("FIRST");
+            expect(handlerCallCount).toBe(1);
+            // Handler still executes even when sealed
+            const result2 = onInit("second");
+            expect(result2).toBe("SECOND");
+            expect(handlerCallCount).toBe(2);
+        });
+        it("should not notify listeners after sealed", () => {
+            const listener = vi.fn();
+            const onInit = action((value) => value.toUpperCase(), {
+                sealed: true,
+            });
+            onInit.on(listener);
+            onInit("first");
+            onInit("second");
+            // Listener only called once (sealed after first)
+            expect(listener).toHaveBeenCalledTimes(1);
+            expect(listener).toHaveBeenCalledWith("first");
+        });
+    });
+});
+//# sourceMappingURL=action.test.js.map

package/dist/action.test.js.map

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

package/dist/async/abortable-guard.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Abortable type guard.
+ *
+ * Extracted to a separate file to avoid circular dependencies
+ * between safe.ts and abortable.ts.
+ */
+/**
+ * Symbol used to identify Abortable functions.
+ * @internal
+ */
+export declare const abortableSymbol: unique symbol;
+/**
+ * Check if a value is an Abortable function.
+ *
+ * @example
+ * ```ts
+ * if (isAbortable(fn)) {
+ *   fn.withSignal(signal, ...args);
+ * }
+ * ```
+ */
+export declare function isAbortable(fn: unknown): fn is {
+    withSignal: Function;
+};
+//# sourceMappingURL=abortable-guard.d.ts.map

package/dist/async/abortable-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abortable-guard.d.ts","sourceRoot":"","sources":["../../src/async/abortable-guard.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;;GAGG;AACH,eAAO,MAAM,eAAe,eAA0B,CAAC;AAMvD;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,OAAO,GAAG,EAAE,IAAI;IAAE,UAAU,EAAE,QAAQ,CAAA;CAAE,CAMvE"}

package/dist/async/abortable-guard.js

@@ -0,0 +1,33 @@
+/**
+ * Abortable type guard.
+ *
+ * Extracted to a separate file to avoid circular dependencies
+ * between safe.ts and abortable.ts.
+ */
+// =============================================================================
+// SYMBOL
+// =============================================================================
+/**
+ * Symbol used to identify Abortable functions.
+ * @internal
+ */
+export const abortableSymbol = Symbol.for("abortable");
+// =============================================================================
+// TYPE GUARD
+// =============================================================================
+/**
+ * Check if a value is an Abortable function.
+ *
+ * @example
+ * ```ts
+ * if (isAbortable(fn)) {
+ *   fn.withSignal(signal, ...args);
+ * }
+ * ```
+ */
+export function isAbortable(fn) {
+    return (typeof fn === "function" &&
+        abortableSymbol in fn &&
+        fn[abortableSymbol] === true);
+}
+//# sourceMappingURL=abortable-guard.js.map

package/dist/async/abortable-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abortable-guard.js","sourceRoot":"","sources":["../../src/async/abortable-guard.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,gFAAgF;AAChF,SAAS;AACT,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;AAEvD,gFAAgF;AAChF,aAAa;AACb,gFAAgF;AAEhF;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW,CAAC,EAAW;IACrC,OAAO,CACL,OAAO,EAAE,KAAK,UAAU;QACxB,eAAe,IAAI,EAAE;QACpB,EAAU,CAAC,eAAe,CAAC,KAAK,IAAI,CACtC,CAAC;AACJ,CAAC"}