@solarpunkltd/swarm-id 0.10.1 → 0.10.2

package/dist/sync/timing-constants.d.ts

@@ -8,24 +8,27 @@
  * in each module.
  */
 /**
- * Client-side timeout for a single cross-device SOC/feed read (roster entry,
- * partition-intent, lock SOC, state-pointer). Bee has no fast authoritative
+ * Client-side timeout for a single cross-device SOC/feed read whose miss is
+ * not the answer: a rival's partition intent, and the lock reads inside a claim.
+ * {@link MISS_READ_TIMEOUT_MS} covers the reads whose miss is. Bee has no fast authoritative
  * "not found" — a retrieval of an absent chunk fails only after exhausting
  * peers — so an absent target would otherwise block for tens of seconds. A
- * present chunk in its neighborhood retrieves well under this; a timed-out read
- * is treated as inconclusive (see each caller's sentinel handling).
+ * present chunk in its neighborhood retrieves well under this. Each caller says
+ * what a timed-out read means for it.
  */
 export declare const SYNC_READ_TIMEOUT_MS = 2500;
 /**
- * Client-side timeout for a single device-roster slot read. Longer than
- * {@link SYNC_READ_TIMEOUT_MS}, because the roster is read through the account's
- * gateway, by default the public one, and an empty roster can only be confirmed
- * by a miss: the public gateway answers an absent chunk with Bee's own 404 after
- * 3.4 to 4.8 s (measured 2026-10-18), and does not route `GET /soc`, so a shorter
- * limit made every empty roster inconclusive. No device then ever wrote its first
- * entry, and signing in on another device always failed.
+ * Client-side timeout for a read whose miss is itself the answer: a
+ * device-roster slot, a partition's lock SOC in the lease refresh, and a
+ * partition's state pointer. Each is read through the account's gateway, by
+ * default the public one, which answers an absent chunk with Bee's own 404 only
+ * after 3.4 to 4.8 s (measured 2026-10-18) and does not route `GET /soc`. Under
+ * {@link SYNC_READ_TIMEOUT_MS} such a miss timed out and read as inconclusive:
+ * no device wrote its first roster entry, and a site's frame on a fresh drive
+ * went read-only and never stamped. Kept under `LEASE_REFRESH_MS` (10 s), since
+ * the lease refresh reads every lock with it.
  */
-export declare const ROSTER_READ_TIMEOUT_MS = 10000;
+export declare const MISS_READ_TIMEOUT_MS = 8000;
 /**
  * Partition-lease lifetime. A device holds its partition for this long before
  * the lease must be refreshed; if it crashes without refreshing, peers can

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@solarpunkltd/swarm-id",
-  "version": "0.10.1",
+  "version": "0.10.2",
   "type": "module",
   "description": "Swarm ID library for authentication and Bee API operations",
   "main": "dist/swarm-id.esm.js",