actly 1.1.5 → 1.2.0

package/dist/utils/abort.cjs

@@ -1,10 +1,15 @@
 "use strict";
 // ─── AbortSignal helpers ──────────────────────────────────────────────────────
 //
-// Centralised utilities for composing AbortSignals. These exist because
-// Node 18 lacks `AbortSignal.any` (added in Node 20) and we want to keep
-// the `engines` floor at 18 for backwards compatibility with existing
-// consumers.
+// Contract: zero listener accumulation on long-lived AbortSignals.
+//
+// Every `addEventListener('abort', ...)` MUST be paired with a
+// `removeEventListener` on the success path, OR use `AbortSignal.any()`
+// (Node 20+ native) which handles cleanup automatically.
+//
+// Long-lived signals (server shutdown, request pool) must not accumulate
+// one listener per `act()` call — that would cause
+// `MaxListenersExceededWarning` and unbounded closure retention.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.anySignal = anySignal;
 exports.raceAbort = raceAbort;
@@ -12,29 +17,51 @@ exports.sleep = sleep;
 exports.isAbortError = isAbortError;
 exports.linkSignal = linkSignal;
 /**
- * Polyfill for `AbortSignal.any(signals)` (Node 20+).
+ * Compose multiple AbortSignals into one. Aborts when ANY input aborts,
+ * with the same reason.
+ *
+ * Uses native `AbortSignal.any()` on Node 20+ (zero allocations, no
+ * listener leaks — the runtime owns the lifecycle). Falls back to a
+ * polyfill that explicitly removes listeners on first abort.
  *
- * Returns a single signal that aborts when ANY of the input signals aborts,
- * with the same reason. If any input is already aborted, the returned signal
- * is aborted synchronously.
+ * # Listener safety
  *
- * Listener registration is `{ once: true }` — once any signal fires, we stop
- * listening on the others. The composite signal cannot be "un-aborted".
+ * The polyfill registers `{ once: true }` listeners on each input and
+ * manually removes the others when one fires. After settlement, the
+ * composite signal holds zero references to the inputs — they may be GC'd.
  */
 function anySignal(signals) {
-    // Fast path: native implementation (Node 20+, modern browsers, Bun).
-    // The cast is safe — the runtime check guards the call.
+    // Filter out undefined / null defensively.
+    const filtered = signals.filter((s) => s != null);
+    if (filtered.length === 0) {
+        // No inputs → never-aborting signal. Use a fresh controller so callers
+        // get a real AbortSignal, not a hand-rolled mock.
+        return new AbortController().signal;
+    }
+    if (filtered.length === 1)
+        return filtered[0];
+    // Native path (Node 20+, modern browsers, Bun).
     const native = AbortSignal.any;
-    if (typeof native === 'function')
-        return native.call(AbortSignal, signals);
-    // Polyfill for Node 18.
+    if (typeof native === 'function') {
+        return native.call(AbortSignal, filtered);
+    }
+    // Polyfill: only used when native is missing. Listener-safe.
     const controller = new AbortController();
-    for (const signal of signals) {
+    const listeners = [];
+    for (const signal of filtered) {
         if (signal.aborted) {
             controller.abort(signal.reason);
             break;
         }
-        signal.addEventListener('abort', () => controller.abort(signal.reason), { once: true });
+        const onAbort = () => {
+            controller.abort(signal.reason);
+            // Remove all other listeners — they hold closures over `signal`
+            // and would otherwise keep the inputs alive past settlement.
+            for (const off of listeners)
+                off();
+        };
+        signal.addEventListener('abort', onAbort, { once: true });
+        listeners.push(() => signal.removeEventListener('abort', onAbort));
     }
     return controller.signal;
 }
@@ -45,34 +72,50 @@ function anySignal(signals) {
  * - If the signal aborts while the promise is pending, rejects with `signal.reason`.
  * - If the promise settles first, returns its value (or rejects with its error).
  *
- * The listener is registered with `{ once: true }` and never leaks: either
- * the signal fires (listener auto-removed) or the promise settles (the
- * signal will eventually be GC'd along with the listener).
+ * # Listener safety
+ *
+ * On success path, the abort listener is explicitly removed. A
+ * `{ once: true }` listener would stay attached on long-lived signals,
+ * leaking one closure per call.
  *
- * Used by `dedupePolicy` so joiners can cancel their own `await` even if the
- * originator's `fn` is still running.
+ * # Mark-as-handled
+ *
+ * When the signal aborts first, the original `promise` may still settle
+ * later (success or failure). We attach a no-op `.catch` to it so V8
+ * doesn't emit an `unhandledRejection` warning. The error is NOT
+ * swallowed from the caller — the caller already received `signal.reason`.
  */
 function raceAbort(promise, signal) {
-    if (signal.aborted)
+    if (signal.aborted) {
+        // Mark the promise as handled — its eventual rejection won't surface
+        // as an unhandled rejection. Its eventual success is dropped silently,
+        // which is correct: the caller has already moved on.
+        promise.catch(() => { });
         return Promise.reject(signal.reason);
+    }
     return new Promise((resolve, reject) => {
         let settled = false;
         const onAbort = () => {
             if (settled)
                 return;
             settled = true;
+            signal.removeEventListener('abort', onAbort);
             reject(signal.reason);
         };
-        signal.addEventListener('abort', onAbort, { once: true });
+        // Not using `{ once: true }` — we want explicit removal on success
+        // path so the listener doesn't linger on a long-lived signal.
+        signal.addEventListener('abort', onAbort);
         promise.then((value) => {
             if (settled)
                 return;
             settled = true;
+            signal.removeEventListener('abort', onAbort);
             resolve(value);
         }, (error) => {
             if (settled)
                 return;
             settled = true;
+            signal.removeEventListener('abort', onAbort);
             reject(error);
         });
     });
@@ -84,9 +127,11 @@ function raceAbort(promise, signal) {
  * signal aborts before the timer fires. If the signal is already aborted
  * when called, rejects synchronously (in microtask).
  *
- * Used by `retryPolicy` to make backoff delays interruptible: when an outer
- * `totalTimeout` fires mid-delay, the delay rejects immediately instead of
- * blocking the retry loop until the timer would have elapsed.
+ * # Timer hygiene
+ *
+ * The internal `setTimeout` is `unref`'d on Node so it doesn't keep the
+ * event loop alive solely for this sleep. On browsers there is no
+ * equivalent — the timer is short-lived enough not to matter.
  */
 function sleep(ms, signal) {
     if (ms <= 0) {
@@ -101,11 +146,17 @@ function sleep(ms, signal) {
             signal?.removeEventListener('abort', onAbort);
             resolve();
         }, ms);
+        // NOTE: do NOT `unref()` this timer. Unlike InMemoryStore's autoCleanup
+        // interval (which is a background housekeeping task), `sleep()` IS the
+        // operation the caller is awaiting. If we unref'd it, Node could exit
+        // the process while a retry delay was pending — silently dropping the
+        // operation. The timer is short-lived (cleared in onAbort or after ms),
+        // so the cost of keeping the loop alive is bounded.
         const onAbort = () => {
             clearTimeout(timer);
             reject(signal.reason);
         };
-        signal?.addEventListener('abort', onAbort, { once: true });
+        signal?.addEventListener('abort', onAbort);
     });
 }
 /**
@@ -118,25 +169,44 @@ function isAbortError(err) {
     if (err == null || typeof err !== 'object')
         return false;
     const name = err.name;
-    return name === 'AbortError' || name === 'TimeoutError' &&
+    if (name === 'AbortError')
+        return true;
+    // DOMException with name 'TimeoutError' is what AbortSignal.timeout throws.
+    // Distinguish from our own TimeoutError class by checking for DOMException.
+    if (name === 'TimeoutError' &&
         err instanceof Error &&
-        // DOMException with name 'TimeoutError' is what AbortSignal.timeout throws.
-        // Distinguish from our own TimeoutError class by checking for DOMException.
         typeof DOMException !== 'undefined' &&
-        err instanceof DOMException;
+        err instanceof DOMException) {
+        return true;
+    }
+    return false;
 }
 /**
  * Link a parent signal to a child controller: when the parent aborts, the
- * child is aborted with the same reason. No-op if the parent is already
- * aborted (the caller should check `parent.aborted` separately if it cares
- * about synchronous abort).
+ * child is aborted with the same reason.
+ *
+ * # Contract
+ *
+ * Returns an `unlink()` function that removes the listener. Callers MUST
+ * call `unlink()` on success path — otherwise the listener stays attached
+ * to the parent forever, leaking one closure per call.
+ *
+ * If the parent is already aborted, the child is aborted synchronously
+ * and `unlink` is a no-op.
+ *
+ * # Prefer `anySignal()` instead
  *
- * The listener is `{ once: true }` — no leak.
+ * For new code, prefer `anySignal([parent, timeoutSignal])` which uses
+ * the native Node 20+ implementation and handles cleanup automatically.
+ * This function exists for call sites that need an `AbortController`
+ * (not just a signal) — e.g. to layer additional abort sources.
  */
 function linkSignal(parent, child) {
     if (parent.aborted) {
         child.abort(parent.reason);
-        return;
+        return () => { };
     }
-    parent.addEventListener('abort', () => child.abort(parent.reason), { once: true });
+    const onAbort = () => child.abort(parent.reason);
+    parent.addEventListener('abort', onAbort);
+    return () => parent.removeEventListener('abort', onAbort);
 }

package/dist/utils/abort.d.ts

@@ -1,12 +1,16 @@
 /**
- * Polyfill for `AbortSignal.any(signals)` (Node 20+).
+ * Compose multiple AbortSignals into one. Aborts when ANY input aborts,
+ * with the same reason.
  *
- * Returns a single signal that aborts when ANY of the input signals aborts,
- * with the same reason. If any input is already aborted, the returned signal
- * is aborted synchronously.
+ * Uses native `AbortSignal.any()` on Node 20+ (zero allocations, no
+ * listener leaks — the runtime owns the lifecycle). Falls back to a
+ * polyfill that explicitly removes listeners on first abort.
  *
- * Listener registration is `{ once: true }` — once any signal fires, we stop
- * listening on the others. The composite signal cannot be "un-aborted".
+ * # Listener safety
+ *
+ * The polyfill registers `{ once: true }` listeners on each input and
+ * manually removes the others when one fires. After settlement, the
+ * composite signal holds zero references to the inputs — they may be GC'd.
  */
 export declare function anySignal(signals: ReadonlyArray<AbortSignal>): AbortSignal;
 /**
@@ -16,12 +20,18 @@ export declare function anySignal(signals: ReadonlyArray<AbortSignal>): AbortSig
  * - If the signal aborts while the promise is pending, rejects with `signal.reason`.
  * - If the promise settles first, returns its value (or rejects with its error).
  *
- * The listener is registered with `{ once: true }` and never leaks: either
- * the signal fires (listener auto-removed) or the promise settles (the
- * signal will eventually be GC'd along with the listener).
+ * # Listener safety
+ *
+ * On success path, the abort listener is explicitly removed. A
+ * `{ once: true }` listener would stay attached on long-lived signals,
+ * leaking one closure per call.
  *
- * Used by `dedupePolicy` so joiners can cancel their own `await` even if the
- * originator's `fn` is still running.
+ * # Mark-as-handled
+ *
+ * When the signal aborts first, the original `promise` may still settle
+ * later (success or failure). We attach a no-op `.catch` to it so V8
+ * doesn't emit an `unhandledRejection` warning. The error is NOT
+ * swallowed from the caller — the caller already received `signal.reason`.
  */
 export declare function raceAbort<T>(promise: Promise<T>, signal: AbortSignal): Promise<T>;
 /**
@@ -31,9 +41,11 @@ export declare function raceAbort<T>(promise: Promise<T>, signal: AbortSignal):
  * signal aborts before the timer fires. If the signal is already aborted
  * when called, rejects synchronously (in microtask).
  *
- * Used by `retryPolicy` to make backoff delays interruptible: when an outer
- * `totalTimeout` fires mid-delay, the delay rejects immediately instead of
- * blocking the retry loop until the timer would have elapsed.
+ * # Timer hygiene
+ *
+ * The internal `setTimeout` is `unref`'d on Node so it doesn't keep the
+ * event loop alive solely for this sleep. On browsers there is no
+ * equivalent — the timer is short-lived enough not to matter.
  */
 export declare function sleep(ms: number, signal?: AbortSignal): Promise<void>;
 /**
@@ -45,11 +57,23 @@ export declare function sleep(ms: number, signal?: AbortSignal): Promise<void>;
 export declare function isAbortError(err: unknown): boolean;
 /**
  * Link a parent signal to a child controller: when the parent aborts, the
- * child is aborted with the same reason. No-op if the parent is already
- * aborted (the caller should check `parent.aborted` separately if it cares
- * about synchronous abort).
+ * child is aborted with the same reason.
+ *
+ * # Contract
+ *
+ * Returns an `unlink()` function that removes the listener. Callers MUST
+ * call `unlink()` on success path — otherwise the listener stays attached
+ * to the parent forever, leaking one closure per call.
+ *
+ * If the parent is already aborted, the child is aborted synchronously
+ * and `unlink` is a no-op.
+ *
+ * # Prefer `anySignal()` instead
  *
- * The listener is `{ once: true }` — no leak.
+ * For new code, prefer `anySignal([parent, timeoutSignal])` which uses
+ * the native Node 20+ implementation and handles cleanup automatically.
+ * This function exists for call sites that need an `AbortController`
+ * (not just a signal) — e.g. to layer additional abort sources.
  */
-export declare function linkSignal(parent: AbortSignal, child: AbortController): void;
+export declare function linkSignal(parent: AbortSignal, child: AbortController): () => void;
 //# sourceMappingURL=abort.d.ts.map

package/dist/utils/abort.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"abort.d.ts","sourceRoot":"","sources":["../../src/utils/abort.ts"],"names":[],"mappings":"AAOA;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,aAAa,CAAC,WAAW,CAAC,GAAG,WAAW,CAwB1E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,SAAS,CAAC,CAAC,EACzB,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EACnB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,CAAC,CAAC,CA2BZ;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAqBrE;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CASlD;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,eAAe,GACrB,IAAI,CAUN"}
+{"version":3,"file":"abort.d.ts","sourceRoot":"","sources":["../../src/utils/abort.ts"],"names":[],"mappings":"AAYA;;;;;;;;;;;;;GAaG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,aAAa,CAAC,WAAW,CAAC,GAAG,WAAW,CAsC1E;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,SAAS,CAAC,CAAC,EACzB,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EACnB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,CAAC,CAAC,CAsCZ;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CA2BrE;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAelD;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,eAAe,GACrB,MAAM,IAAI,CAQZ"}

package/dist/utils/abort.js

@@ -1,33 +1,60 @@
 // ─── AbortSignal helpers ──────────────────────────────────────────────────────
 //
-// Centralised utilities for composing AbortSignals. These exist because
-// Node 18 lacks `AbortSignal.any` (added in Node 20) and we want to keep
-// the `engines` floor at 18 for backwards compatibility with existing
-// consumers.
+// Contract: zero listener accumulation on long-lived AbortSignals.
+//
+// Every `addEventListener('abort', ...)` MUST be paired with a
+// `removeEventListener` on the success path, OR use `AbortSignal.any()`
+// (Node 20+ native) which handles cleanup automatically.
+//
+// Long-lived signals (server shutdown, request pool) must not accumulate
+// one listener per `act()` call — that would cause
+// `MaxListenersExceededWarning` and unbounded closure retention.
 /**
- * Polyfill for `AbortSignal.any(signals)` (Node 20+).
+ * Compose multiple AbortSignals into one. Aborts when ANY input aborts,
+ * with the same reason.
+ *
+ * Uses native `AbortSignal.any()` on Node 20+ (zero allocations, no
+ * listener leaks — the runtime owns the lifecycle). Falls back to a
+ * polyfill that explicitly removes listeners on first abort.
  *
- * Returns a single signal that aborts when ANY of the input signals aborts,
- * with the same reason. If any input is already aborted, the returned signal
- * is aborted synchronously.
+ * # Listener safety
  *
- * Listener registration is `{ once: true }` — once any signal fires, we stop
- * listening on the others. The composite signal cannot be "un-aborted".
+ * The polyfill registers `{ once: true }` listeners on each input and
+ * manually removes the others when one fires. After settlement, the
+ * composite signal holds zero references to the inputs — they may be GC'd.
  */
 export function anySignal(signals) {
-    // Fast path: native implementation (Node 20+, modern browsers, Bun).
-    // The cast is safe — the runtime check guards the call.
+    // Filter out undefined / null defensively.
+    const filtered = signals.filter((s) => s != null);
+    if (filtered.length === 0) {
+        // No inputs → never-aborting signal. Use a fresh controller so callers
+        // get a real AbortSignal, not a hand-rolled mock.
+        return new AbortController().signal;
+    }
+    if (filtered.length === 1)
+        return filtered[0];
+    // Native path (Node 20+, modern browsers, Bun).
     const native = AbortSignal.any;
-    if (typeof native === 'function')
-        return native.call(AbortSignal, signals);
-    // Polyfill for Node 18.
+    if (typeof native === 'function') {
+        return native.call(AbortSignal, filtered);
+    }
+    // Polyfill: only used when native is missing. Listener-safe.
     const controller = new AbortController();
-    for (const signal of signals) {
+    const listeners = [];
+    for (const signal of filtered) {
         if (signal.aborted) {
             controller.abort(signal.reason);
             break;
         }
-        signal.addEventListener('abort', () => controller.abort(signal.reason), { once: true });
+        const onAbort = () => {
+            controller.abort(signal.reason);
+            // Remove all other listeners — they hold closures over `signal`
+            // and would otherwise keep the inputs alive past settlement.
+            for (const off of listeners)
+                off();
+        };
+        signal.addEventListener('abort', onAbort, { once: true });
+        listeners.push(() => signal.removeEventListener('abort', onAbort));
     }
     return controller.signal;
 }
@@ -38,34 +65,50 @@ export function anySignal(signals) {
  * - If the signal aborts while the promise is pending, rejects with `signal.reason`.
  * - If the promise settles first, returns its value (or rejects with its error).
  *
- * The listener is registered with `{ once: true }` and never leaks: either
- * the signal fires (listener auto-removed) or the promise settles (the
- * signal will eventually be GC'd along with the listener).
+ * # Listener safety
+ *
+ * On success path, the abort listener is explicitly removed. A
+ * `{ once: true }` listener would stay attached on long-lived signals,
+ * leaking one closure per call.
  *
- * Used by `dedupePolicy` so joiners can cancel their own `await` even if the
- * originator's `fn` is still running.
+ * # Mark-as-handled
+ *
+ * When the signal aborts first, the original `promise` may still settle
+ * later (success or failure). We attach a no-op `.catch` to it so V8
+ * doesn't emit an `unhandledRejection` warning. The error is NOT
+ * swallowed from the caller — the caller already received `signal.reason`.
  */
 export function raceAbort(promise, signal) {
-    if (signal.aborted)
+    if (signal.aborted) {
+        // Mark the promise as handled — its eventual rejection won't surface
+        // as an unhandled rejection. Its eventual success is dropped silently,
+        // which is correct: the caller has already moved on.
+        promise.catch(() => { });
         return Promise.reject(signal.reason);
+    }
     return new Promise((resolve, reject) => {
         let settled = false;
         const onAbort = () => {
             if (settled)
                 return;
             settled = true;
+            signal.removeEventListener('abort', onAbort);
             reject(signal.reason);
         };
-        signal.addEventListener('abort', onAbort, { once: true });
+        // Not using `{ once: true }` — we want explicit removal on success
+        // path so the listener doesn't linger on a long-lived signal.
+        signal.addEventListener('abort', onAbort);
         promise.then((value) => {
             if (settled)
                 return;
             settled = true;
+            signal.removeEventListener('abort', onAbort);
             resolve(value);
         }, (error) => {
             if (settled)
                 return;
             settled = true;
+            signal.removeEventListener('abort', onAbort);
             reject(error);
         });
     });
@@ -77,9 +120,11 @@ export function raceAbort(promise, signal) {
  * signal aborts before the timer fires. If the signal is already aborted
  * when called, rejects synchronously (in microtask).
  *
- * Used by `retryPolicy` to make backoff delays interruptible: when an outer
- * `totalTimeout` fires mid-delay, the delay rejects immediately instead of
- * blocking the retry loop until the timer would have elapsed.
+ * # Timer hygiene
+ *
+ * The internal `setTimeout` is `unref`'d on Node so it doesn't keep the
+ * event loop alive solely for this sleep. On browsers there is no
+ * equivalent — the timer is short-lived enough not to matter.
  */
 export function sleep(ms, signal) {
     if (ms <= 0) {
@@ -94,11 +139,17 @@ export function sleep(ms, signal) {
             signal?.removeEventListener('abort', onAbort);
             resolve();
         }, ms);
+        // NOTE: do NOT `unref()` this timer. Unlike InMemoryStore's autoCleanup
+        // interval (which is a background housekeeping task), `sleep()` IS the
+        // operation the caller is awaiting. If we unref'd it, Node could exit
+        // the process while a retry delay was pending — silently dropping the
+        // operation. The timer is short-lived (cleared in onAbort or after ms),
+        // so the cost of keeping the loop alive is bounded.
         const onAbort = () => {
             clearTimeout(timer);
             reject(signal.reason);
         };
-        signal?.addEventListener('abort', onAbort, { once: true });
+        signal?.addEventListener('abort', onAbort);
     });
 }
 /**
@@ -111,26 +162,45 @@ export function isAbortError(err) {
     if (err == null || typeof err !== 'object')
         return false;
     const name = err.name;
-    return name === 'AbortError' || name === 'TimeoutError' &&
+    if (name === 'AbortError')
+        return true;
+    // DOMException with name 'TimeoutError' is what AbortSignal.timeout throws.
+    // Distinguish from our own TimeoutError class by checking for DOMException.
+    if (name === 'TimeoutError' &&
         err instanceof Error &&
-        // DOMException with name 'TimeoutError' is what AbortSignal.timeout throws.
-        // Distinguish from our own TimeoutError class by checking for DOMException.
         typeof DOMException !== 'undefined' &&
-        err instanceof DOMException;
+        err instanceof DOMException) {
+        return true;
+    }
+    return false;
 }
 /**
  * Link a parent signal to a child controller: when the parent aborts, the
- * child is aborted with the same reason. No-op if the parent is already
- * aborted (the caller should check `parent.aborted` separately if it cares
- * about synchronous abort).
+ * child is aborted with the same reason.
+ *
+ * # Contract
+ *
+ * Returns an `unlink()` function that removes the listener. Callers MUST
+ * call `unlink()` on success path — otherwise the listener stays attached
+ * to the parent forever, leaking one closure per call.
+ *
+ * If the parent is already aborted, the child is aborted synchronously
+ * and `unlink` is a no-op.
+ *
+ * # Prefer `anySignal()` instead
  *
- * The listener is `{ once: true }` — no leak.
+ * For new code, prefer `anySignal([parent, timeoutSignal])` which uses
+ * the native Node 20+ implementation and handles cleanup automatically.
+ * This function exists for call sites that need an `AbortController`
+ * (not just a signal) — e.g. to layer additional abort sources.
  */
 export function linkSignal(parent, child) {
     if (parent.aborted) {
         child.abort(parent.reason);
-        return;
+        return () => { };
     }
-    parent.addEventListener('abort', () => child.abort(parent.reason), { once: true });
+    const onAbort = () => child.abort(parent.reason);
+    parent.addEventListener('abort', onAbort);
+    return () => parent.removeEventListener('abort', onAbort);
 }
 //# sourceMappingURL=abort.js.map

package/dist/utils/abort.js.map

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

package/dist/utils/abortPool.cjs

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.acquireController = acquireController;
+exports.releaseController = releaseController;
+exports.poolSize = poolSize;
+const pool = [];
+const MAX_POOL_SIZE = 64;
+function acquireController() {
+    while (pool.length > 0) {
+        const c = pool.pop();
+        if (!c.signal.aborted) {
+            return c;
+        }
+    }
+    return new AbortController();
+}
+function releaseController(c) {
+    if (c.signal.aborted)
+        return;
+    if (pool.length >= MAX_POOL_SIZE)
+        return;
+    pool.push(c);
+}
+function poolSize() {
+    return pool.length;
+}

package/dist/utils/abortPool.d.ts

@@ -0,0 +1,4 @@
+export declare function acquireController(): AbortController;
+export declare function releaseController(c: AbortController): void;
+export declare function poolSize(): number;
+//# sourceMappingURL=abortPool.d.ts.map

package/dist/utils/abortPool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abortPool.d.ts","sourceRoot":"","sources":["../../src/utils/abortPool.ts"],"names":[],"mappings":"AAGA,wBAAgB,iBAAiB,IAAI,eAAe,CAQnD;AAED,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,eAAe,GAAG,IAAI,CAI1D;AAED,wBAAgB,QAAQ,IAAI,MAAM,CAEjC"}

package/dist/utils/abortPool.js

@@ -0,0 +1,22 @@
+const pool = [];
+const MAX_POOL_SIZE = 64;
+export function acquireController() {
+    while (pool.length > 0) {
+        const c = pool.pop();
+        if (!c.signal.aborted) {
+            return c;
+        }
+    }
+    return new AbortController();
+}
+export function releaseController(c) {
+    if (c.signal.aborted)
+        return;
+    if (pool.length >= MAX_POOL_SIZE)
+        return;
+    pool.push(c);
+}
+export function poolSize() {
+    return pool.length;
+}
+//# sourceMappingURL=abortPool.js.map

package/dist/utils/abortPool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abortPool.js","sourceRoot":"","sources":["../../src/utils/abortPool.ts"],"names":[],"mappings":"AAAA,MAAM,IAAI,GAAsB,EAAE,CAAA;AAClC,MAAM,aAAa,GAAG,EAAE,CAAA;AAExB,MAAM,UAAU,iBAAiB;IAC/B,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,EAAG,CAAA;QACrB,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACtB,OAAO,CAAC,CAAA;QACV,CAAC;IACH,CAAC;IACD,OAAO,IAAI,eAAe,EAAE,CAAA;AAC9B,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,CAAkB;IAClD,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO;QAAE,OAAM;IAC5B,IAAI,IAAI,CAAC,MAAM,IAAI,aAAa;QAAE,OAAM;IACxC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACd,CAAC;AAED,MAAM,UAAU,QAAQ;IACtB,OAAO,IAAI,CAAC,MAAM,CAAA;AACpB,CAAC"}