@raf-query/core 0.0.16 → 0.0.17

package/CHANGELOG.md

@@ -1,10 +1,16 @@
 # Changelog
 
+## [0.0.17](https://github.com/KATT/raf-query/compare/0.0.16...0.0.17) (2026-10-12)
+
+### Features
+
+* **core:** pause retries while the browser is offline ([#18](https://github.com/KATT/raf-query/issues/18)) ([a25c664](https://github.com/KATT/raf-query/commit/a25c664359fe7248cdc8d91a14d524e37b467c6c))
+
 ## [0.0.16](https://github.com/KATT/raf-query/compare/0.0.15...0.0.16) (2026-10-12)
 
 ### Bug Fixes
 
-* **core:** don't revalidate cached data in server verbs ([#19](https://github.com/KATT/raf-query/issues/19)) ([0ed7d9f](https://github.com/KATT/raf-query/commit/0ed7d9fefd0b70a8aa9a85c8d2c309a9fed42903))
+- **core:** don't revalidate cached data in server verbs ([#19](https://github.com/KATT/raf-query/issues/19)) ([0ed7d9f](https://github.com/KATT/raf-query/commit/0ed7d9fefd0b70a8aa9a85c8d2c309a9fed42903))
 
 ## [0.0.15](https://github.com/KATT/raf-query/compare/0.0.14...0.0.15) (2026-10-12)
 

package/README.md

@@ -556,6 +556,8 @@ Query options, accepted by `queryOptions`, `infiniteQueryOptions` and `config.de
 
 `infiniteQueryOptions` also takes `getPreviousPageParam` and `maxPages`.
 
+In the browser, retries pause while `navigator.onLine` is `false`: after the retry delay, the next attempt waits for the window's `online` event. The request stays fetching meanwhile, and cancelling it (`remove`, `clear`, a restart) stops the wait. The first attempt runs regardless.
+
 `@raf-query/core`:
 
 | Export                                         | Use                                                              |

package/dist/online.mjs

@@ -0,0 +1,16 @@
+import { Effect } from "effect";
+//#region src/online.ts
+function isOffline() {
+	return "window" in globalThis && "navigator" in globalThis && "onLine" in navigator && !navigator.onLine;
+}
+/**
+* Succeeds now if the browser is online, else on the window's next `online`
+* event. Interrupting it removes the listener.
+*/
+const whenOnline = Effect.suspend(() => isOffline() ? Effect.callback((resume) => {
+	const onOnline = () => resume(Effect.void);
+	window.addEventListener("online", onOnline, { once: true });
+	return Effect.sync(() => window.removeEventListener("online", onOnline));
+}) : Effect.void);
+//#endregion
+export { whenOnline };

package/dist/query.mjs

@@ -1,4 +1,5 @@
 import { scheduleNotify } from "./notify.mjs";
+import { whenOnline } from "./online.mjs";
 import { replaceEqualDeep } from "./share.mjs";
 import { fulfilled, pending } from "./thenable.mjs";
 import { Cause, Effect, Exit, Predicate, Schedule } from "effect";
@@ -382,7 +383,16 @@ var QueryEntry = class {
 		const retry = this.#behavior("retry") ?? (this.#host.isServer ? 0 : 3);
 		const countFailure = Effect.sync(() => this.#set({ failureCount: this.#state.failureCount + 1 }));
 		const counted = once.pipe(Effect.tapError(() => countFailure));
-		if (Schedule.isSchedule(retry)) return Effect.retry(counted, retry);
+		const online = this.#host.isServer ? Effect.void : whenOnline;
+		if (Schedule.isSchedule(retry)) return Effect.suspend(() => {
+			let first = true;
+			const each = Effect.suspend(() => {
+				const wait = first ? Effect.void : online;
+				first = false;
+				return wait.pipe(Effect.andThen(counted));
+			});
+			return Effect.retry(each, retry);
+		});
 		const retryDelay = this.#behavior("retryDelay");
 		const delayFor = (failureCount, error) => {
 			if (retryDelay === void 0) return Math.min(1e3 * 2 ** (failureCount - 1), 3e4);
@@ -391,7 +401,7 @@ var QueryEntry = class {
 		const attempt = counted.pipe(Effect.catch((error) => {
 			const failureCount = this.#state.failureCount;
 			if (!shouldRetry(retry, failureCount, error)) return Effect.fail(error);
-			return Effect.sleep(delayFor(failureCount, error)).pipe(Effect.andThen(Effect.suspend(() => attempt)));
+			return Effect.sleep(delayFor(failureCount, error)).pipe(Effect.andThen(online), Effect.andThen(Effect.suspend(() => attempt)));
 		}));
 		return attempt;
 	}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@raf-query/core",
-  "version": "0.0.16",
+  "version": "0.0.17",
   "description": "Framework-agnostic core of raf-query, a render-as-you-fetch query library",
   "keywords": [
     "query",