jrx 0.2.0 → 0.2.1

package/README.md

@@ -30,6 +30,7 @@ npm i jrx
 - [`addTransition(cb, durationMs)`](#addtransitioncb-durationms) - Progress-based animations
 - [`computed(fn, getDeps?)`](#computedfn-getdeps) - Memoized computed values
 - [`retry(cb, options?)`](#retrycb-options) - Async retry with exponential backoff
+- [`addRetry(cb, options?)`](#addretrycb-options) - Fire-and-forget retry with disposal
 
 ## API
 
@@ -321,6 +322,37 @@ console.log(data) // T | undefined
 - `disposer`: A disposer for the current retry attempt. Check `disposer.signal.aborted` to handle cancellation
 - `info.resetBackoff()`: Call this to reset the backoff counter to the beginning (useful when making partial progress)
 
+### `addRetry(cb, options?)`
+
+Fire-and-forget version of `retry`. Starts the retry loop in the background and returns a dispose function to cancel it.
+
+```typescript
+import {addRetry} from 'jrx'
+
+// Start a retry loop in the background
+const dispose = addRetry(async (disposer, { resetBackoff }) => {
+  const response = await fetch('/api/data')
+  if (!response.ok) throw new Error('Failed')
+  processData(await response.json())
+})
+
+// Cancel the retry loop
+dispose()
+
+// With custom backoff
+const dispose2 = addRetry(
+  async (disposer) => {
+    await connectWebSocket()
+  },
+  { backoffSec: [1, 2, 5, -1] }
+)
+
+dispose2()
+```
+
+**Options:**
+- `backoffSec`: Array of retry delays in seconds (same as `retry`)
+
 ## Cleanup Pattern
 
 All functions return disposer functions that clean up resources:

package/index.d.ts

@@ -1,8 +1,8 @@
 import { type Disposer } from 'jdisposer';
-import retry from './retry.js';
+import retry, { addRetry } from './retry.js';
 import computed from './computed.js';
 import addEvtListener from './addEvtListener.js';
-export { retry, computed, addEvtListener };
+export { retry, computed, addEvtListener, addRetry };
 export declare function makeRenderLoop(): {
     loop(this: void, time: DOMHighResTimeStamp): void;
     setLoop(this: void, loop: (time: DOMHighResTimeStamp) => void | (() => void)): () => void;

package/index.js

@@ -1,8 +1,8 @@
 import { makeDisposer, makeReset } from 'jdisposer';
-import retry from './retry.js';
+import retry, { addRetry } from './retry.js';
 import computed from './computed.js';
 import addEvtListener from './addEvtListener.js';
-export { retry, computed, addEvtListener };
+export { retry, computed, addEvtListener, addRetry };
 export function makeRenderLoop() {
     let loop_;
     const reset = makeReset();

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "jrx",
-	"version": "0.2.0",
+	"version": "0.2.1",
 	"type": "module",
 	"scripts": {
 		"prepublishOnly": "npx tsc",

package/retry.d.ts

@@ -10,3 +10,8 @@ export default function retry<T>(cb: (disposer: Disposer, info: {
     backoffSec?: number[];
     disposer: Disposer;
 }): Promise<T | undefined>;
+export declare function addRetry<T>(cb: (disposer: Disposer, info: {
+    resetBackoff(): void;
+}) => T | Promise<T>, options?: {
+    backoffSec?: number[];
+}): (this: void) => void;

package/retry.js

@@ -1,4 +1,4 @@
-import { makeReset } from 'jdisposer';
+import { makeDisposer, makeReset } from 'jdisposer';
 export default async function retry(cb, { backoffSec = [5, 5, 10, 10, 20, 20, 40, 40, 60, -1], // -1: retry forever with the last backoff . first element must not be -1
 disposer, } = {}) {
     const reset = makeReset();
@@ -30,3 +30,8 @@ disposer, } = {}) {
         }
     }
 }
+export function addRetry(cb, options) {
+    const disposer = makeDisposer();
+    void retry(cb, { ...options, disposer });
+    return disposer.dispose;
+}