@solarpunkltd/swarm-id 0.10.0 → 0.10.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -8,14 +8,27 @@
8
8
  * in each module.
9
9
  */
10
10
  /**
11
- * Client-side timeout for a single cross-device SOC/feed read (roster entry,
12
- * partition-intent, lock SOC, state-pointer). Bee has no fast authoritative
11
+ * Client-side timeout for a single cross-device SOC/feed read whose miss is
12
+ * not the answer: a rival's partition intent, and the lock reads inside a claim.
13
+ * {@link MISS_READ_TIMEOUT_MS} covers the reads whose miss is. Bee has no fast authoritative
13
14
  * "not found" — a retrieval of an absent chunk fails only after exhausting
14
15
  * peers — so an absent target would otherwise block for tens of seconds. A
15
- * present chunk in its neighborhood retrieves well under this; a timed-out read
16
- * is treated as inconclusive (see each caller's sentinel handling).
16
+ * present chunk in its neighborhood retrieves well under this. Each caller says
17
+ * what a timed-out read means for it.
17
18
  */
18
19
  export declare const SYNC_READ_TIMEOUT_MS = 2500;
20
+ /**
21
+ * Client-side timeout for a read whose miss is itself the answer: a
22
+ * device-roster slot, a partition's lock SOC in the lease refresh, and a
23
+ * partition's state pointer. Each is read through the account's gateway, by
24
+ * default the public one, which answers an absent chunk with Bee's own 404 only
25
+ * after 3.4 to 4.8 s (measured 2026-10-18) and does not route `GET /soc`. Under
26
+ * {@link SYNC_READ_TIMEOUT_MS} such a miss timed out and read as inconclusive:
27
+ * no device wrote its first roster entry, and a site's frame on a fresh drive
28
+ * went read-only and never stamped. Kept under `LEASE_REFRESH_MS` (10 s), since
29
+ * the lease refresh reads every lock with it.
30
+ */
31
+ export declare const MISS_READ_TIMEOUT_MS = 8000;
19
32
  /**
20
33
  * Partition-lease lifetime. A device holds its partition for this long before
21
34
  * the lease must be refreshed; if it crashes without refreshing, peers can
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@solarpunkltd/swarm-id",
3
- "version": "0.10.0",
3
+ "version": "0.10.2",
4
4
  "type": "module",
5
5
  "description": "Swarm ID library for authentication and Bee API operations",
6
6
  "main": "dist/swarm-id.esm.js",