Remote / foldkit-remote-domain

Failure modes and current limits

  • Lagging Views: reads wait up to confirmWithin (default 2 seconds); if still behind, Remote keeps its optimistic/written row and retries with exponential backoff (1s to 30s). Tokens over 512 characters cannot set a floor.
  • Monotonic revisions: Remote drops any row or live frame older than the held revision, including resurrected rows after a delete. Ensure every Event advances revision.
  • Principal switches: calling Data.forget on sign-out clears all cached rows; the adapter itself caches no rows.
  • Internal defects: lowered writes log unexpected failures via RemoteServer.report (ServerDefect) and return only Internal error, incident <id> over the wire (mapped to RemoteUnreachable).
  • written authorization safety: DomainRemote.command refuses written if the Entity's Update rules do not imply its Read rules or if a field has its own Read rule.
  • Upstream 2.0.0-beta.86 limits: tested against Domain.InMemory and Domain.protocolHttp (not Durable Objects or WebSockets); live reads with relations fail RemoteLiveError; each listed row costs one View snapshot (16 concurrent).