@greendrake/vue-api 0.6.0 → 0.7.0

package/README.md

@@ -25,7 +25,7 @@ export interface Methods {
     'host.get': (id: number) => Host
     'host.update': (record: { id: number } & Partial<Host>) => Host
     'host.delete': (args: { id: number }) => void
-    'vlan.list': (query: Record<string, never>) => Vlan[]
+    'vlan.list': () => Vlan[]
 }
 
 export const api = new ApiClient<Methods>({
@@ -83,15 +83,15 @@ Calls from components and stores:
 import { ref } from 'vue'
 import { api } from '@/api'
 
-const host = await api.call('host.get', [42]) // Host; the global spinner shows while pending
+const host = await api.call('host.get', 42) // Host; the global spinner shows while pending
 
 const saving = ref(false)
-await api.call('host.update', [{ id: 42, name: 'nas' }], { pending: saving }) // this ref instead
+await api.with({ pending: saving }).call('host.update', { id: 42, name: 'nas' }) // this ref instead
 
-const vlans = await api.call('vlan.list', [{}], { silent: true }) // no spinner, no toast; errors reject
+const vlans = await api.with({ silent: true }).call('vlan.list') // no spinner, no toast; errors reject
 ```
 
-`call(method, args, options?)` takes the arguments as a tuple (`Parameters<M[K]>`), unlike `RpcClient.call`'s variadic form.
+`call(method, ...args)` takes a method's own arguments, as `RpcClient.call` does (`@greendrake/rpc`'s `Caller`), and a method that takes none is called with none. `with(options)` is the calls made under `CallOptions`: a separate entry point, because nothing at runtime tells trailing options from a last argument. `ApiCaller<M>` is the two together, for a library typing the client it is handed.
 
 ## ApiClient
 
@@ -109,7 +109,7 @@ const vlans = await api.call('vlan.list', [{}], { silent: true }) // no spinner,
 - `silent: true` — no loading indication and no error UX; errors reject straight to the caller. For background calls and callers owning their own error presentation.
 - `cache: false` — reads past the cache and does not store the answer. Cannot opt an unlisted method in and leaves the nonce rule alone.
 
-Cache access on the client: `invalidateCache(method, ...args)` (with args, that entry; without, the whole method), `clearCache()`, `primeCache(method, args, data)`.
+Cache access on the client: `invalidateCache(method, ...args)` (with args, that entry; without, the whole method), `clearCache()`.
 
 `setDebugDelay(method, ms)` — dev builds only: holds a call pending for `ms` so its loading state can be inspected; `0` clears. Inert in production.
 
@@ -158,6 +158,12 @@ import { retryWhenOnline } from '@greendrake/vue-api'
 const strings = await retryWhenOnline(() => fetchJson<Strings>(`/locales/${locale}.json`))
 ```
 
+`keepConnected<Methods>(transport, method)` keeps a `WsTransport` (any `Revivable`: `probe` and `pipe.reconnectNow`) connected for the page's life and returns the teardown. The window's `online` event collapses a waiting reconnect's delay. While the page is visible — on becoming visible, then every 60 s — it reconnects a socket waiting out a backoff and probes with `method`, so a socket that died silently (a backgrounded app, an expired NAT mapping) is abandoned and reconnected. Nothing runs while the page is hidden. `method` is a key of the app's method map: a probe takes any answer, a refusal included, as proof of life, so a method the server lacks would report every socket alive.
+
+```ts
+keepConnected<Methods>(transport, 'app.ping')
+```
+
 ## Live updates
 
 `bindLive(transport, options)` is `@greendrake/rpc`'s `liveBinding` under this package's UX policy, and `useLive` is the component-scoped form that releases on unmount.
@@ -171,19 +177,19 @@ useLive(transport, {
         'thread.message': { when: pushed => pushed.thread_id === props.threadId }
     },
     resync: async () => {
-        thread.value = await api.call('thread.get', [props.threadId], backgroundCall(true))
+        thread.value = await api.with(backgroundCall(true)).call('thread.get', props.threadId)
     }
 })
 ```
 
 The mechanism — relevance, `apply` versus `resync`, the reconnect re-read, coalescing, release — is documented in `@greendrake/rpc`. What this package adds is what happens around a `resync`:
 
-- It runs unseen. `backgroundCall(background)` is the one place that decides what that means: `{ silent: true }`, which bypasses both the loading counter and the error-UX pipeline. `pending: false` is not enough — it suppresses the spinner and still raises the blocking retry toast over a screen the user is reading.
+- It runs unseen. `backgroundCall(background)` is the one place that decides what that means: `{ silent: true }` (and `{}` for a load somebody asked for), which bypasses both the loading counter and the error-UX pipeline. `pending: false` is not enough — it suppresses the spinner and still raises the blocking retry toast over a screen the user is reading.
 - Its failure neither interrupts nor vanishes. A `NotFoundError` is dropped (the entity went away while the socket was down; the next navigation says so), a `NetworkError` is dropped (the socket went again mid-read, and the binding's own reconnect rule re-reads when it returns), and anything else goes to the `errorSink` configured through `configureApiUX` — reported, never toasted.
 - It must read past a response cache the missed pushes would have invalidated: invalidate the entries the read would hit, then read, so the stale entry is repaired rather than stepped around.
 
 `backgroundCall` also serves any loader told whether anybody asked for its load — a table re-reading after a push, say, which is where a panel's re-read actually calls the API:
 
 ```ts
-const load = (args: ListArgs, background: boolean) => api.call('admin.thread.list', [args], backgroundCall(background))
+const load = (args: ListArgs, background: boolean) => api.with(backgroundCall(background)).call('admin.thread.list', args)
 ```

package/catalogue/af.yaml

@@ -0,0 +1,7 @@
+# GENERATED by bin/l1 translate from the en-GB master. Do not add or remove keys.
+# An edit to a value here is kept until its source string, this locale's
+# rendering of the terms (translation/glossary/, beside translate.yaml) or the
+# translation policy changes, at which point the string is rendered again.
+connection:
+    device_offline: Dit lyk of jy nie aanlyn is nie — wag vir jou konneksie…
+    unreachable: Kan nie @:brand.name bereik nie — wag vir die konneksie…

package/catalogue/ar.yaml

@@ -0,0 +1,7 @@
+# GENERATED by bin/l1 translate from the en-GB master. Do not add or remove keys.
+# An edit to a value here is kept until its source string, this locale's
+# rendering of the terms (translation/glossary/, beside translate.yaml) or the
+# translation policy changes, at which point the string is rendered again.
+connection:
+    device_offline: يبدو أنك غير متصل بالإنترنت — جاري انتظار اتصالك…
+    unreachable: تعذر الوصول إلى @:brand.name — جاري انتظار الاتصال…

package/catalogue/az.yaml

@@ -0,0 +1,7 @@
+# GENERATED by bin/l1 translate from the en-GB master. Do not add or remove keys.
+# An edit to a value here is kept until its source string, this locale's
+# rendering of the terms (translation/glossary/, beside translate.yaml) or the
+# translation policy changes, at which point the string is rendered again.
+connection:
+    device_offline: Görünür, internet bağlantınız yoxdur — bağlantı gözlənilir…
+    unreachable: '@:brand.name ilə əlaqə qurmaq mümkün olmadı — bağlantı gözlənilir…'

package/catalogue/be.yaml

@@ -0,0 +1,7 @@
+# GENERATED by bin/l1 translate from the en-GB master. Do not add or remove keys.
+# An edit to a value here is kept until its source string, this locale's
+# rendering of the terms (translation/glossary/, beside translate.yaml) or the
+# translation policy changes, at which point the string is rendered again.
+connection:
+    device_offline: Вы ўзяліся ў аўтаномны рэжым — чакаем падключэння…
+    unreachable: Не удаецца звязацца з @:brand.name — чакаем падключэння…

package/catalogue/bg.yaml

@@ -0,0 +1,7 @@
+# GENERATED by bin/l1 translate from the en-GB master. Do not add or remove keys.
+# An edit to a value here is kept until its source string, this locale's
+# rendering of the terms (translation/glossary/, beside translate.yaml) or the
+# translation policy changes, at which point the string is rendered again.
+connection:
+    device_offline: Изглежда, че сте офлайн — очакване на връзка…
+    unreachable: Няма връзка с @:brand.name — очакване на връзка…

package/catalogue/bn.yaml

@@ -0,0 +1,7 @@
+# GENERATED by bin/l1 translate from the en-GB master. Do not add or remove keys.
+# An edit to a value here is kept until its source string, this locale's
+# rendering of the terms (translation/glossary/, beside translate.yaml) or the
+# translation policy changes, at which point the string is rendered again.
+connection:
+    device_offline: মনে হচ্ছে আপনি অফলাইনে আছেন — সংযোগের জন্য অপেক্ষা করা হচ্ছে…
+    unreachable: '@:brand.name-এর সাথে সংযোগ করা যাচ্ছে না — সংযোগের জন্য অপেক্ষা করা হচ্ছে…'

package/catalogue/bs.yaml

@@ -0,0 +1,7 @@
+# GENERATED by bin/l1 translate from the en-GB master. Do not add or remove keys.
+# An edit to a value here is kept until its source string, this locale's
+# rendering of the terms (translation/glossary/, beside translate.yaml) or the
+# translation policy changes, at which point the string is rendered again.
+connection:
+    device_offline: Izgleda da niste povezani na internet — čekanje povezivanja…
+    unreachable: Ne može se uspostaviti veza sa @:brand.name — čekanje povezivanja…

package/catalogue/cs.yaml

@@ -0,0 +1,7 @@
+# GENERATED by bin/l1 translate from the en-GB master. Do not add or remove keys.
+# An edit to a value here is kept until its source string, this locale's
+# rendering of the terms (translation/glossary/, beside translate.yaml) or the
+# translation policy changes, at which point the string is rendered again.
+connection:
+    device_offline: Vypadá to, že jste odpojeni — čekáme na připojení…
+    unreachable: Nelze připojit k @:brand.name — čekáme na připojení…

package/catalogue/da.yaml

@@ -0,0 +1,7 @@
+# GENERATED by bin/l1 translate from the en-GB master. Do not add or remove keys.
+# An edit to a value here is kept until its source string, this locale's
+# rendering of the terms (translation/glossary/, beside translate.yaml) or the
+# translation policy changes, at which point the string is rendered again.
+connection:
+    device_offline: Det ser ud til, at du er offline — venter på forbindelse…
+    unreachable: Kan ikke få forbindelse til @:brand.name — venter på forbindelse…

package/catalogue/de.yaml

@@ -0,0 +1,7 @@
+# GENERATED by bin/l1 translate from the en-GB master. Do not add or remove keys.
+# An edit to a value here is kept until its source string, this locale's
+# rendering of the terms (translation/glossary/, beside translate.yaml) or the
+# translation policy changes, at which point the string is rendered again.
+connection:
+    device_offline: Du scheinst offline zu sein – warte auf deine Verbindung…
+    unreachable: '@:brand.name ist nicht erreichbar – warte auf die Verbindung…'

package/catalogue/en-GB.yaml

@@ -0,0 +1,14 @@
+# This package's strings (en-GB), the master every other locale is rendered
+# from by fe/lib/translate.yaml. A host serves them merged under its own
+# catalogue (@greendrake/i18n), and may reword one by defining its key.
+#
+# vue-i18n syntax. @:brand.name is the host's name for itself, which every
+# host supplies (setupI18n's constants).
+
+connection:
+    # Two readings of the same fact — calls cannot get through. Only the device
+    # signal tells them apart, which is the whole of what it is trusted for.
+    # A linked message must be closed by whitespace: '@:brand.name.' would read
+    # the trailing period as part of the key and render the key verbatim.
+    device_offline: 'You appear to be offline — waiting for your connection…'
+    unreachable: 'Cannot reach @:brand.name — waiting for the connection…'

package/catalogue/en-US.yaml

@@ -0,0 +1,7 @@
+# GENERATED by bin/l1 translate from the en-GB master. Do not add or remove keys.
+# An edit to a value here is kept until its source string, this locale's
+# rendering of the terms (translation/glossary/, beside translate.yaml) or the
+# translation policy changes, at which point the string is rendered again.
+connection:
+    device_offline: You appear to be offline — waiting for your connection…
+    unreachable: Cannot reach @:brand.name — waiting for the connection…

package/catalogue/es-419.yaml

@@ -0,0 +1,7 @@
+# GENERATED by bin/l1 translate from the en-GB master. Do not add or remove keys.
+# An edit to a value here is kept until its source string, this locale's
+# rendering of the terms (translation/glossary/, beside translate.yaml) or the
+# translation policy changes, at which point the string is rendered again.
+connection:
+    device_offline: Parece que estás sin conexión — esperando tu conexión…
+    unreachable: No se puede alcanzar @:brand.name — esperando la conexión…

package/catalogue/es-ES.yaml

@@ -0,0 +1,7 @@
+# GENERATED by bin/l1 translate from the en-GB master. Do not add or remove keys.
+# An edit to a value here is kept until its source string, this locale's
+# rendering of the terms (translation/glossary/, beside translate.yaml) or the
+# translation policy changes, at which point the string is rendered again.
+connection:
+    device_offline: Parece que estás sin conexión — esperando a que se restablezca la conexión…
+    unreachable: No se puede alcanzar @:brand.name — esperando la conexión…

package/catalogue/fa.yaml

@@ -0,0 +1,7 @@
+# GENERATED by bin/l1 translate from the en-GB master. Do not add or remove keys.
+# An edit to a value here is kept until its source string, this locale's
+# rendering of the terms (translation/glossary/, beside translate.yaml) or the
+# translation policy changes, at which point the string is rendered again.
+connection:
+    device_offline: به نظر می‌رسد آفلاین هستید — در انتظار اتصال…
+    unreachable: اتصال به @:brand.name برقرار نمی‌شود — در انتظار اتصال…

package/catalogue/fi.yaml

@@ -0,0 +1,7 @@
+# GENERATED by bin/l1 translate from the en-GB master. Do not add or remove keys.
+# An edit to a value here is kept until its source string, this locale's
+# rendering of the terms (translation/glossary/, beside translate.yaml) or the
+# translation policy changes, at which point the string is rendered again.
+connection:
+    device_offline: Näytät olevan offline-tilassa – odotetaan yhteyttä…
+    unreachable: '@:brand.name ei tavoita – odotetaan yhteyttä…'

package/catalogue/fil.yaml

@@ -0,0 +1,7 @@
+# GENERATED by bin/l1 translate from the en-GB master. Do not add or remove keys.
+# An edit to a value here is kept until its source string, this locale's
+# rendering of the terms (translation/glossary/, beside translate.yaml) or the
+# translation policy changes, at which point the string is rendered again.
+connection:
+    device_offline: Mukhang offline ka — naghihintay ng iyong koneksyon…
+    unreachable: Hindi maabot ang @:brand.name — naghihintay ng koneksyon…

package/catalogue/fr.yaml

@@ -0,0 +1,7 @@
+# GENERATED by bin/l1 translate from the en-GB master. Do not add or remove keys.
+# An edit to a value here is kept until its source string, this locale's
+# rendering of the terms (translation/glossary/, beside translate.yaml) or the
+# translation policy changes, at which point the string is rendered again.
+connection:
+    device_offline: Vous semblez être hors ligne — attente de votre connexion…
+    unreachable: Impossible de joindre @:brand.name — attente de la connexion…

package/catalogue/gl.yaml

@@ -0,0 +1,7 @@
+# GENERATED by bin/l1 translate from the en-GB master. Do not add or remove keys.
+# An edit to a value here is kept until its source string, this locale's
+# rendering of the terms (translation/glossary/, beside translate.yaml) or the
+# translation policy changes, at which point the string is rendered again.
+connection:
+    device_offline: Parece que estás sen conexión — agardando a que conectes…
+    unreachable: Non se pode conectar con @:brand.name — agardando a conexión…

package/catalogue/gu.yaml

@@ -0,0 +1,7 @@
+# GENERATED by bin/l1 translate from the en-GB master. Do not add or remove keys.
+# An edit to a value here is kept until its source string, this locale's
+# rendering of the terms (translation/glossary/, beside translate.yaml) or the
+# translation policy changes, at which point the string is rendered again.
+connection:
+    device_offline: તમે ઓફલાઇન હોવ તેમ લાગે છે — તમારા કનેક્શનની રાહ જોઈ રહ્યા છીએ…
+    unreachable: '@:brand.name સુધી પહોંચી શકાય તેમ નથી — કનેક્શનની રાહ જોઈ રહ્યા છીએ…'

package/catalogue/he.yaml

@@ -0,0 +1,7 @@
+# GENERATED by bin/l1 translate from the en-GB master. Do not add or remove keys.
+# An edit to a value here is kept until its source string, this locale's
+# rendering of the terms (translation/glossary/, beside translate.yaml) or the
+# translation policy changes, at which point the string is rendered again.
+connection:
+    device_offline: נראה שאתה לא מחובר — ממתין לחיבור שלך...
+    unreachable: לא ניתן להגיע ל-@:brand.name — ממתין לחיבור...

package/catalogue/hi.yaml

@@ -0,0 +1,7 @@
+# GENERATED by bin/l1 translate from the en-GB master. Do not add or remove keys.
+# An edit to a value here is kept until its source string, this locale's
+# rendering of the terms (translation/glossary/, beside translate.yaml) or the
+# translation policy changes, at which point the string is rendered again.
+connection:
+    device_offline: ऐसा लगता है कि आप ऑफलाइन हैं — आपके कनेक्शन का इंतज़ार है…
+    unreachable: '@:brand.name से संपर्क नहीं हो पा रहा है — कनेक्शन का इंतज़ार है…'

package/catalogue/id.yaml

@@ -0,0 +1,7 @@
+# GENERATED by bin/l1 translate from the en-GB master. Do not add or remove keys.
+# An edit to a value here is kept until its source string, this locale's
+# rendering of the terms (translation/glossary/, beside translate.yaml) or the
+# translation policy changes, at which point the string is rendered again.
+connection:
+    device_offline: Anda tampaknya sedang luring — menunggu koneksi Anda…
+    unreachable: Tidak dapat menjangkau @:brand.name — menunggu koneksi…

package/catalogue/it.yaml

@@ -0,0 +1,7 @@
+# GENERATED by bin/l1 translate from the en-GB master. Do not add or remove keys.
+# An edit to a value here is kept until its source string, this locale's
+# rendering of the terms (translation/glossary/, beside translate.yaml) or the
+# translation policy changes, at which point the string is rendered again.
+connection:
+    device_offline: Sembra che tu sia offline — in attesa della connessione…
+    unreachable: Impossibile raggiungere @:brand.name — in attesa della connessione…

package/catalogue/ja.yaml

@@ -0,0 +1,7 @@
+# GENERATED by bin/l1 translate from the en-GB master. Do not add or remove keys.
+# An edit to a value here is kept until its source string, this locale's
+# rendering of the terms (translation/glossary/, beside translate.yaml) or the
+# translation policy changes, at which point the string is rendered again.
+connection:
+    device_offline: オフラインのようです — 接続を待機しています…
+    unreachable: '@:brand.name に接続できません — 接続を待機しています…'

package/catalogue/jv.yaml

@@ -0,0 +1,7 @@
+# GENERATED by bin/l1 translate from the en-GB master. Do not add or remove keys.
+# An edit to a value here is kept until its source string, this locale's
+# rendering of the terms (translation/glossary/, beside translate.yaml) or the
+# translation policy changes, at which point the string is rendered again.
+connection:
+    device_offline: Sampeyan ketoke offline — ngenteni koneksi…
+    unreachable: Ora bisa nyambung menyang @:brand.name — ngenteni koneksi…

package/catalogue/kk.yaml

@@ -0,0 +1,7 @@
+# GENERATED by bin/l1 translate from the en-GB master. Do not add or remove keys.
+# An edit to a value here is kept until its source string, this locale's
+# rendering of the terms (translation/glossary/, beside translate.yaml) or the
+# translation policy changes, at which point the string is rendered again.
+connection:
+    device_offline: Сіз офлайн көрінесіз — байланыс күтілуде…
+    unreachable: '@:brand.name сервисіне қосылу мүмкін емес — байланыс күтілуде…'

package/catalogue/ko.yaml

@@ -0,0 +1,7 @@
+# GENERATED by bin/l1 translate from the en-GB master. Do not add or remove keys.
+# An edit to a value here is kept until its source string, this locale's
+# rendering of the terms (translation/glossary/, beside translate.yaml) or the
+# translation policy changes, at which point the string is rendered again.
+connection:
+    device_offline: 오프라인 상태인 것 같습니다 — 연결을 기다리는 중입니다…
+    unreachable: '@:brand.name에 연결할 수 없습니다 — 연결을 기다리는 중입니다…'

package/catalogue/lb.yaml

@@ -0,0 +1,7 @@
+# GENERATED by bin/l1 translate from the en-GB master. Do not add or remove keys.
+# An edit to a value here is kept until its source string, this locale's
+# rendering of the terms (translation/glossary/, beside translate.yaml) or the
+# translation policy changes, at which point the string is rendered again.
+connection:
+    device_offline: Dir schéngt offline ze sinn — waart op Är Verbindung…
+    unreachable: '@:brand.name kann net erreecht ginn — waart op d''Verbindung…'

package/catalogue/lt.yaml

@@ -0,0 +1,7 @@
+# GENERATED by bin/l1 translate from the en-GB master. Do not add or remove keys.
+# An edit to a value here is kept until its source string, this locale's
+# rendering of the terms (translation/glossary/, beside translate.yaml) or the
+# translation policy changes, at which point the string is rendered again.
+connection:
+    device_offline: Atrodo, kad esate be interneto – laukiam ryšio...
+    unreachable: Nepavyko prisijungti prie @:brand.name – laukiam ryšio...

package/catalogue/mk.yaml

@@ -0,0 +1,7 @@
+# GENERATED by bin/l1 translate from the en-GB master. Do not add or remove keys.
+# An edit to a value here is kept until its source string, this locale's
+# rendering of the terms (translation/glossary/, beside translate.yaml) or the
+# translation policy changes, at which point the string is rendered again.
+connection:
+    device_offline: Изгледа дека сте офлајн — се чека поврзување…
+    unreachable: Не може да се поврзе со @:brand.name — се чека поврзување…

package/catalogue/mn.yaml

@@ -0,0 +1,7 @@
+# GENERATED by bin/l1 translate from the en-GB master. Do not add or remove keys.
+# An edit to a value here is kept until its source string, this locale's
+# rendering of the terms (translation/glossary/, beside translate.yaml) or the
+# translation policy changes, at which point the string is rendered again.
+connection:
+    device_offline: Та интернэтгүй байгаа бололтой — холболтыг хүлээж байна…
+    unreachable: '@:brand.name-тэй холбогдож чадсангүй — холболтыг хүлээж байна…'

package/catalogue/mr.yaml

@@ -0,0 +1,7 @@
+# GENERATED by bin/l1 translate from the en-GB master. Do not add or remove keys.
+# An edit to a value here is kept until its source string, this locale's
+# rendering of the terms (translation/glossary/, beside translate.yaml) or the
+# translation policy changes, at which point the string is rendered again.
+connection:
+    device_offline: तुम्ही ऑफलाइन असल्याचे दिसते — कनेक्शनची प्रतीक्षा करत आहे…
+    unreachable: '@:brand.name शी संपर्क होऊ शकत नाही — कनेक्शनची प्रतीक्षा करत आहे…'

package/catalogue/ms.yaml

@@ -0,0 +1,7 @@
+# GENERATED by bin/l1 translate from the en-GB master. Do not add or remove keys.
+# An edit to a value here is kept until its source string, this locale's
+# rendering of the terms (translation/glossary/, beside translate.yaml) or the
+# translation policy changes, at which point the string is rendered again.
+connection:
+    device_offline: Anda kelihatan tidak berada dalam talian — menunggu sambungan anda…
+    unreachable: Tidak dapat menghubungi @:brand.name — menunggu sambungan…

package/catalogue/my.yaml

@@ -0,0 +1,7 @@
+# GENERATED by bin/l1 translate from the en-GB master. Do not add or remove keys.
+# An edit to a value here is kept until its source string, this locale's
+# rendering of the terms (translation/glossary/, beside translate.yaml) or the
+# translation policy changes, at which point the string is rendered again.
+connection:
+    device_offline: သင်သည် အင်တာနက်လိုင်း ပြတ်တောက်နေပုံရသည် — ချိတ်ဆက်မှုကို စောင့်ဆိုင်းနေသည်…
+    unreachable: '@:brand.name သို့ ချိတ်ဆက်၍မရပါ — ချိတ်ဆက်မှုကို စောင့်ဆိုင်းနေသည်…'

package/catalogue/nb.yaml

@@ -0,0 +1,7 @@
+# GENERATED by bin/l1 translate from the en-GB master. Do not add or remove keys.
+# An edit to a value here is kept until its source string, this locale's
+# rendering of the terms (translation/glossary/, beside translate.yaml) or the
+# translation policy changes, at which point the string is rendered again.
+connection:
+    device_offline: Det ser ut til at du er frakoblet – venter på tilkobling…
+    unreachable: Kan ikke nå @:brand.name – venter på tilkobling…

package/catalogue/ne.yaml

@@ -0,0 +1,7 @@
+# GENERATED by bin/l1 translate from the en-GB master. Do not add or remove keys.
+# An edit to a value here is kept until its source string, this locale's
+# rendering of the terms (translation/glossary/, beside translate.yaml) or the
+# translation policy changes, at which point the string is rendered again.
+connection:
+    device_offline: तपाईं अफलाइन हुनुहुन्छ जस्तो देखिन्छ — जडानको प्रतीक्षा गर्दै…
+    unreachable: '@:brand.name सँग सम्पर्क हुन सकेन — जडानको प्रतीक्षा गर्दै…'

package/catalogue/nl.yaml

@@ -0,0 +1,7 @@
+# GENERATED by bin/l1 translate from the en-GB master. Do not add or remove keys.
+# An edit to a value here is kept until its source string, this locale's
+# rendering of the terms (translation/glossary/, beside translate.yaml) or the
+# translation policy changes, at which point the string is rendered again.
+connection:
+    device_offline: Je lijkt offline te zijn — wachten op verbinding…
+    unreachable: '@:brand.name is niet bereikbaar — wachten op verbinding…'

package/catalogue/pa.yaml

@@ -0,0 +1,7 @@
+# GENERATED by bin/l1 translate from the en-GB master. Do not add or remove keys.
+# An edit to a value here is kept until its source string, this locale's
+# rendering of the terms (translation/glossary/, beside translate.yaml) or the
+# translation policy changes, at which point the string is rendered again.
+connection:
+    device_offline: ਲੱਗਦਾ ਹੈ ਕਿ ਤੁਸੀਂ ਆਫਲਾਈਨ ਹੋ — ਤੁਹਾਡੇ ਕਨੈਕਸ਼ਨ ਦੀ ਉਡੀਕ ਕੀਤੀ ਜਾ ਰਹੀ ਹੈ…
+    unreachable: '@:brand.name ਤੱਕ ਪਹੁੰਚ ਨਹੀਂ ਕੀਤੀ ਜਾ ਸਕਦੀ — ਕਨੈਕਸ਼ਨ ਦੀ ਉਡੀਕ ਕੀਤੀ ਜਾ ਰਹੀ ਹੈ…'

package/catalogue/pl.yaml

@@ -0,0 +1,7 @@
+# GENERATED by bin/l1 translate from the en-GB master. Do not add or remove keys.
+# An edit to a value here is kept until its source string, this locale's
+# rendering of the terms (translation/glossary/, beside translate.yaml) or the
+# translation policy changes, at which point the string is rendered again.
+connection:
+    device_offline: Wygląda na to, że jesteś offline — czekamy na połączenie…
+    unreachable: Nie można połączyć się z @:brand.name — czekamy na połączenie…

package/catalogue/pt-BR.yaml

@@ -0,0 +1,7 @@
+# GENERATED by bin/l1 translate from the en-GB master. Do not add or remove keys.
+# An edit to a value here is kept until its source string, this locale's
+# rendering of the terms (translation/glossary/, beside translate.yaml) or the
+# translation policy changes, at which point the string is rendered again.
+connection:
+    device_offline: Você parece estar offline — aguardando sua conexão…
+    unreachable: Não é possível alcançar o @:brand.name — aguardando a conexão…

package/catalogue/pt-PT.yaml

@@ -0,0 +1,7 @@
+# GENERATED by bin/l1 translate from the en-GB master. Do not add or remove keys.
+# An edit to a value here is kept until its source string, this locale's
+# rendering of the terms (translation/glossary/, beside translate.yaml) or the
+# translation policy changes, at which point the string is rendered again.
+connection:
+    device_offline: Parece que está offline — a aguardar a ligação…
+    unreachable: Não é possível aceder ao @:brand.name — a aguardar a ligação…

package/catalogue/ro.yaml

@@ -0,0 +1,7 @@
+# GENERATED by bin/l1 translate from the en-GB master. Do not add or remove keys.
+# An edit to a value here is kept until its source string, this locale's
+# rendering of the terms (translation/glossary/, beside translate.yaml) or the
+# translation policy changes, at which point the string is rendered again.
+connection:
+    device_offline: Se pare că ești offline — se așteaptă după conexiune…
+    unreachable: Nu se poate ajunge la @:brand.name — se așteaptă după conexiune…

package/catalogue/ru.yaml

@@ -0,0 +1,7 @@
+# GENERATED by bin/l1 translate from the en-GB master. Do not add or remove keys.
+# An edit to a value here is kept until its source string, this locale's
+# rendering of the terms (translation/glossary/, beside translate.yaml) or the
+# translation policy changes, at which point the string is rendered again.
+connection:
+    device_offline: Похоже, вы не в сети — ожидаем подключения…
+    unreachable: Не удалось связаться с @:brand.name — ожидаем подключения…

package/catalogue/sk.yaml

@@ -0,0 +1,7 @@
+# GENERATED by bin/l1 translate from the en-GB master. Do not add or remove keys.
+# An edit to a value here is kept until its source string, this locale's
+# rendering of the terms (translation/glossary/, beside translate.yaml) or the
+# translation policy changes, at which point the string is rendered again.
+connection:
+    device_offline: Zjavuje sa, že ste odpojení — čakáme na pripojenie…
+    unreachable: Nie je možné nájsť @:brand.name — čakáme na pripojenie…

package/catalogue/sm.yaml

@@ -0,0 +1,7 @@
+# GENERATED by bin/l1 translate from the en-GB master. Do not add or remove keys.
+# An edit to a value here is kept until its source string, this locale's
+# rendering of the terms (translation/glossary/, beside translate.yaml) or the
+# translation policy changes, at which point the string is rendered again.
+connection:
+    device_offline: E foliga mai e le o oe i luga o le initaneti — o lo'o fa'atali mo lau feso'ota'iga…
+    unreachable: E le mafai ona fesootai ma le @:brand.name — o lo'o fa'atali mo le feso'ota'iga…

package/catalogue/sq.yaml

@@ -0,0 +1,7 @@
+# GENERATED by bin/l1 translate from the en-GB master. Do not add or remove keys.
+# An edit to a value here is kept until its source string, this locale's
+# rendering of the terms (translation/glossary/, beside translate.yaml) or the
+# translation policy changes, at which point the string is rendered again.
+connection:
+    device_offline: Duket se je offline — po pritet lidhja…
+    unreachable: Nuk mund të lidhem me @:brand.name — po pritet lidhja…

package/catalogue/sr.yaml

@@ -0,0 +1,7 @@
+# GENERATED by bin/l1 translate from the en-GB master. Do not add or remove keys.
+# An edit to a value here is kept until its source string, this locale's
+# rendering of the terms (translation/glossary/, beside translate.yaml) or the
+# translation policy changes, at which point the string is rendered again.
+connection:
+    device_offline: Izgleda da niste povezani na internet — čekanje veze…
+    unreachable: Ne može se uspostaviti veza sa @:brand.name — čekanje veze…

package/catalogue/su.yaml

@@ -0,0 +1,7 @@
+# GENERATED by bin/l1 translate from the en-GB master. Do not add or remove keys.
+# An edit to a value here is kept until its source string, this locale's
+# rendering of the terms (translation/glossary/, beside translate.yaml) or the
+# translation policy changes, at which point the string is rendered again.
+connection:
+    device_offline: Anjeun sigana nuju offline — ngantosan koneksi…
+    unreachable: Teu tiasa ngahubungi @:brand.name — ngantosan koneksi…

package/catalogue/sv.yaml

@@ -0,0 +1,7 @@
+# GENERATED by bin/l1 translate from the en-GB master. Do not add or remove keys.
+# An edit to a value here is kept until its source string, this locale's
+# rendering of the terms (translation/glossary/, beside translate.yaml) or the
+# translation policy changes, at which point the string is rendered again.
+connection:
+    device_offline: Det ser ut som att du är offline – väntar på anslutning…
+    unreachable: Kan inte nå @:brand.name – väntar på anslutning…

package/catalogue/sw.yaml

@@ -0,0 +1,7 @@
+# GENERATED by bin/l1 translate from the en-GB master. Do not add or remove keys.
+# An edit to a value here is kept until its source string, this locale's
+# rendering of the terms (translation/glossary/, beside translate.yaml) or the
+# translation policy changes, at which point the string is rendered again.
+connection:
+    device_offline: Inaonekana hauko mtandaoni — tunasubiri muunganisho wako…
+    unreachable: Hatuwezi kuifikia @:brand.name — tunasubiri muunganisho…

package/catalogue/te.yaml

@@ -0,0 +1,7 @@
+# GENERATED by bin/l1 translate from the en-GB master. Do not add or remove keys.
+# An edit to a value here is kept until its source string, this locale's
+# rendering of the terms (translation/glossary/, beside translate.yaml) or the
+# translation policy changes, at which point the string is rendered again.
+connection:
+    device_offline: మీరు ఆఫ్‌లైన్‌లో ఉన్నట్లు కనిపిస్తోంది — మీ కనెక్షన్ కోసం వేచి ఉంది…
+    unreachable: '@:brand.nameని సంప్రదించలేకపోతున్నాము — కనెక్షన్ కోసం వేచి ఉంది…'

package/catalogue/th.yaml

@@ -0,0 +1,7 @@
+# GENERATED by bin/l1 translate from the en-GB master. Do not add or remove keys.
+# An edit to a value here is kept until its source string, this locale's
+# rendering of the terms (translation/glossary/, beside translate.yaml) or the
+# translation policy changes, at which point the string is rendered again.
+connection:
+    device_offline: ดูเหมือนว่าคุณจะไม่ได้เชื่อมต่ออินเทอร์เน็ต — กำลังรอการเชื่อมต่อ…
+    unreachable: ไม่สามารถเชื่อมต่อกับ @:brand.name ได้ — กำลังรอการเชื่อมต่อ…

package/catalogue/to.yaml

@@ -0,0 +1,7 @@
+# GENERATED by bin/l1 translate from the en-GB master. Do not add or remove keys.
+# An edit to a value here is kept until its source string, this locale's
+# rendering of the terms (translation/glossary/, beside translate.yaml) or the
+# translation policy changes, at which point the string is rendered again.
+connection:
+    device_offline: ‘Oku hā mai ‘oku ‘ikai ke koe faka‘amanatu‘i ki he initaneti — ‘oku tatali ki ho faka‘amanatu‘i…
+    unreachable: ‘Oku ‘ikai ke lava ‘o faka‘amanatu‘i ki he @:brand.name — ‘oku tatali ki he faka‘amanatu‘i…

package/catalogue/tr.yaml

@@ -0,0 +1,7 @@
+# GENERATED by bin/l1 translate from the en-GB master. Do not add or remove keys.
+# An edit to a value here is kept until its source string, this locale's
+# rendering of the terms (translation/glossary/, beside translate.yaml) or the
+# translation policy changes, at which point the string is rendered again.
+connection:
+    device_offline: Çevrimdışı görünüyorsunuz — bağlantınız bekleniyor…
+    unreachable: '@:brand.name adresine ulaşılamıyor — bağlantı bekleniyor…'

package/catalogue/uk.yaml

@@ -0,0 +1,7 @@
+# GENERATED by bin/l1 translate from the en-GB master. Do not add or remove keys.
+# An edit to a value here is kept until its source string, this locale's
+# rendering of the terms (translation/glossary/, beside translate.yaml) or the
+# translation policy changes, at which point the string is rendered again.
+connection:
+    device_offline: Схоже, ви офлайн — чекаємо на з'єднання…
+    unreachable: Не вдається зв'язатися з @:brand.name — чекаємо на з'єднання…

package/catalogue/uz.yaml

@@ -0,0 +1,7 @@
+# GENERATED by bin/l1 translate from the en-GB master. Do not add or remove keys.
+# An edit to a value here is kept until its source string, this locale's
+# rendering of the terms (translation/glossary/, beside translate.yaml) or the
+# translation policy changes, at which point the string is rendered again.
+connection:
+    device_offline: Sizda internet aloqasi yo‘qdek — ulanish kutilmoqda…
+    unreachable: '@:brand.name bilan bog‘lanib bo‘lmadi — ulanish kutilmoqda…'

package/catalogue/vi.yaml

@@ -0,0 +1,7 @@
+# GENERATED by bin/l1 translate from the en-GB master. Do not add or remove keys.
+# An edit to a value here is kept until its source string, this locale's
+# rendering of the terms (translation/glossary/, beside translate.yaml) or the
+# translation policy changes, at which point the string is rendered again.
+connection:
+    device_offline: Có vẻ như bạn đang ngoại tuyến — đang chờ kết nối…
+    unreachable: Không thể kết nối với @:brand.name — đang chờ kết nối…

package/catalogue/yo.yaml

@@ -0,0 +1,7 @@
+# GENERATED by bin/l1 translate from the en-GB master. Do not add or remove keys.
+# An edit to a value here is kept until its source string, this locale's
+# rendering of the terms (translation/glossary/, beside translate.yaml) or the
+# translation policy changes, at which point the string is rendered again.
+connection:
+    device_offline: Ó dàbí ẹni pé o kò lọ́wọ́ sí ẹ̀rọ ayélujára — a ń dúró fún ìsopọ̀ rẹ…
+    unreachable: A kò le kan @:brand.name — a ń dúró fún ìsopọ̀…

package/catalogue/zh-Hans.yaml

@@ -0,0 +1,7 @@
+# GENERATED by bin/l1 translate from the en-GB master. Do not add or remove keys.
+# An edit to a value here is kept until its source string, this locale's
+# rendering of the terms (translation/glossary/, beside translate.yaml) or the
+# translation policy changes, at which point the string is rendered again.
+connection:
+    device_offline: 你似乎已离线 — 正在等待连接…
+    unreachable: 无法连接到 @:brand.name — 正在等待连接…

package/catalogue/zh-Hant.yaml

@@ -0,0 +1,7 @@
+# GENERATED by bin/l1 translate from the en-GB master. Do not add or remove keys.
+# An edit to a value here is kept until its source string, this locale's
+# rendering of the terms (translation/glossary/, beside translate.yaml) or the
+# translation policy changes, at which point the string is rendered again.
+connection:
+    device_offline: 你似乎已離線 — 正在等待連線…
+    unreachable: 無法連線至 @:brand.name — 正在等待連線…

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@greendrake/vue-api",
-    "version": "0.6.0",
+    "version": "0.7.0",
     "description": "Vue binding of @greendrake/rpc: loading-state wiring, response cache, error-UX pipeline, silent calls, live bindings to server push",
     "license": "MIT",
     "author": "Eugene Greendrake <eugene@greendrake.nz>",
@@ -23,8 +23,10 @@
         }
     },
     "files": [
-        "src"
+        "src",
+        "catalogue"
     ],
+    "catalogue": "catalogue",
     "sideEffects": false,
     "publishConfig": {
         "access": "public"
@@ -34,17 +36,17 @@
     },
     "prettier": "@greendrake/dev-config/prettier",
     "dependencies": {
-        "@greendrake/rpc": "0.6.0",
-        "@greendrake/ui": "0.6.0",
-        "@greendrake/util": "0.6.0",
-        "@greendrake/vue-kit": "0.6.0"
+        "@greendrake/rpc": "0.7.0",
+        "@greendrake/ui": "0.7.0",
+        "@greendrake/util": "0.7.0",
+        "@greendrake/vue-kit": "0.7.0"
     },
     "peerDependencies": {
         "pinia": "^3.0.4",
         "vue": "^3.5.34"
     },
     "devDependencies": {
-        "@greendrake/dev-config": "0.6.0",
+        "@greendrake/dev-config": "0.7.0",
         "pinia": "^3.0.4",
         "typescript": "6.0.3",
         "vue": "^3.5.34",

package/src/ApiClient.ts

@@ -1,7 +1,7 @@
 import { isRef, type Ref } from 'vue'
 import { createDeferred, NetworkError, TimeOutPromise } from '@greendrake/util'
 import { ResponseCache, WebSocketClosedError, codeOf, packRequest } from '@greendrake/rpc'
-import type { CacheConfig, MethodMap, MethodMapConstraint, Transport } from '@greendrake/rpc'
+import type { CacheConfig, Caller, MethodMap, MethodMapConstraint, Transport } from '@greendrake/rpc'
 import { useAppState } from '@greendrake/vue-kit'
 import { useConnectivity } from './connectivity'
 import { useExceptionState } from './exceptionState'
@@ -56,9 +56,18 @@ export interface ApiClientOptions {
     locale?: () => string | undefined
 }
 
+// What calls the methods of M as ApiClient does: its own calls, under no options,
+// and those made under some.
+export interface ApiCaller<M extends MethodMapConstraint<M>> extends Caller<M> {
+    // The calls made under options. A separate entry point rather than a trailing
+    // parameter: nothing at runtime tells trailing options from a last argument.
+    //    api.with({ pending: false }).call('listing.get', { listing_id })
+    with(options: CallOptions): Caller<M>
+}
+
 // The Vue-facing API client: typed calls with loading-state wiring, response
 // caching, and the blocking-toast retry pipeline.
-export class ApiClient<M extends MethodMapConstraint<M> = MethodMap> {
+export class ApiClient<M extends MethodMapConstraint<M> = MethodMap> implements ApiCaller<M> {
     readonly transport: Transport
     readonly #cache?: ResponseCache
     readonly #errorHandlers?: Record<string, (e: Error) => void>
@@ -103,7 +112,17 @@ export class ApiClient<M extends MethodMapConstraint<M> = MethodMap> {
         }
     }
 
-    // The one way to invoke a method. Whether the request carries a nonce is
+    call<K extends keyof M & string>(method: K, ...args: Parameters<M[K]>): Promise<Awaited<ReturnType<M[K]>>> {
+        return this.#call({}, method, args)
+    }
+
+    with(options: CallOptions): Caller<M> {
+        return {
+            call: <K extends keyof M & string>(method: K, ...args: Parameters<M[K]>) => this.#call(options, method, args)
+        }
+    }
+
+    // What every call comes down to. Whether the request carries a nonce is
     // not a per-call-site choice: it follows from the cache config, which is
     // the single declaration of "this answer may be reused".
     //
@@ -126,7 +145,7 @@ export class ApiClient<M extends MethodMapConstraint<M> = MethodMap> {
     // server-side response caching is built (there is none today, so nonce-less
     // buys nothing extra), or if `Request.Abort` (which cancels by nonce) gets
     // wired up on a cacheable method.
-    async call<K extends keyof M & string>(method: K, args: Parameters<M[K]>, options?: CallOptions): Promise<Awaited<ReturnType<M[K]>>> {
+    async #call<K extends keyof M & string>(options: CallOptions, method: K, args: Parameters<M[K]>): Promise<Awaited<ReturnType<M[K]>>> {
         const cacheable = this.#cache?.ttlFor(method) !== false && this.#cache !== undefined
         // Refusing the cache is about this answer, not about the method: it
         // suppresses the lookup and the store, and deliberately does NOT touch
@@ -135,7 +154,7 @@ export class ApiClient<M extends MethodMapConstraint<M> = MethodMap> {
         // and keeps what nonce-lessness buys it, which is not only the Redis
         // write it saves but offline parking: a nonce-less read dropped in
         // flight waits out the outage instead of asking the user to retry it.
-        const useCache = cacheable && options?.cache !== false
+        const useCache = cacheable && options.cache !== false
         if (useCache) {
             const cached = this.#cache!.get(method, args)
             if (cached.hit) {
@@ -158,16 +177,10 @@ export class ApiClient<M extends MethodMapConstraint<M> = MethodMap> {
         this.#cache?.clear()
     }
 
-    // Seed the cache from a server push already carrying the full DTO a read
-    // would return. `args` must match the read's args to hit the same key.
-    primeCache(method: keyof M & string, args: unknown[], data: unknown): void {
-        this.#cache?.prime(method, args, data)
-    }
-
-    async #run<K extends keyof M & string>(nonce: boolean, store: boolean, method: K, args: Parameters<M[K]>, options?: CallOptions): Promise<Awaited<ReturnType<M[K]>>> {
+    async #run<K extends keyof M & string>(nonce: boolean, store: boolean, method: K, args: Parameters<M[K]>, options: CallOptions): Promise<Awaited<ReturnType<M[K]>>> {
         const send = async (): Promise<Awaited<ReturnType<M[K]>>> => {
             const result = await this.transport.send(packRequest(method, args, nonce, this.#locale?.()))
-            if (options?.validate) {
+            if (options.validate) {
                 const verdict = options.validate(result)
                 if (verdict instanceof Error) {
                     throw verdict
@@ -186,14 +199,14 @@ export class ApiClient<M extends MethodMapConstraint<M> = MethodMap> {
             return result as Awaited<ReturnType<M[K]>>
         }
 
-        if (options?.silent) {
+        if (options.silent) {
             return send()
         }
 
         const appState = useAppState()
         const exceptionState = useExceptionState()
         const connectivity = useConnectivity()
-        const pending = options?.pending
+        const pending = options.pending
         const switchLoading = (on: boolean): void => {
             if (isRef(pending)) {
                 pending.value = on

package/src/connectivity.ts

@@ -1,4 +1,4 @@
-import { ref } from 'vue'
+import { computed, ref, type ComputedRef } from 'vue'
 import { defineStore } from 'pinia'
 import { createDeferred } from '@greendrake/util'
 import { getConnectionSource } from './uxConfig'
@@ -76,3 +76,14 @@ export const useConnectivity = defineStore('connectivity', () => {
         whenOnline
     }
 })
+
+// The catalogue key of the offline message to show (this package's
+// `connection` namespace). The device's own claim picks between them: "your
+// connection is gone" and "the site cannot be reached" are materially
+// different things to tell someone, and the device signal — useless as a
+// verdict on whether calls can succeed — is the only thing that distinguishes
+// them.
+export const useConnectionMessageKey = (): ComputedRef<string> => {
+    const connectivity = useConnectivity()
+    return computed(() => (connectivity.deviceOffline ? 'connection.device_offline' : 'connection.unreachable'))
+}

package/src/keepConnected.ts

@@ -0,0 +1,68 @@
+import type { WebSocketPipe, WsTransport } from '@greendrake/rpc'
+
+// What keeping a socket connected asks of it — @greendrake/rpc's WsTransport
+// as-is.
+export type Revivable = Pick<WsTransport, 'probe'> & { readonly pipe: Pick<WebSocketPipe, 'reconnectNow'> }
+
+// How often a visible page asks whether its socket is still alive.
+const BEAT_MS = 60_000
+
+// Keeps the socket carrying the app's calls connected for as long as the page
+// lives; returns the teardown.
+//
+// The device coming back is a hint, not a verdict — it only collapses a
+// waiting reconnect's remaining delay so the socket re-attempts at once
+// instead of sitting out a timer that started before connectivity returned.
+// A device that reports wrongly (a WKWebView, a captive portal) costs nothing
+// here: the attempt either opens the socket or it does not.
+//
+// A socket can also die without saying so: a backgrounded mobile app, an idle
+// NAT or VPN mapping expiring under a tab that never lost focus. Nothing fires
+// then — no close, no online, no visibility change — so the only way to learn
+// it is to ask, with `method`, the cheapest question the API answers. Silence
+// past the transport's deadline abandons the socket and reconnects, which puts
+// everything hanging off the reconnect back in charge.
+//
+// Asked at the two moments it can matter: when the page comes back to the
+// user, and — because a visible tab can be sitting on a dead socket just as
+// easily — on a slow beat while it stays visible. Nothing runs while hidden: a
+// hidden tab has no reader to be stale for, and its timers are throttled
+// anyway.
+//
+// `method` is typed against the app's method map (`keepConnected<Methods>`)
+// rather than taken as a bare string: a probe reads any answer as proof of
+// life, a refusal included, so a method the server does not have would report
+// every socket alive forever. This way a rename is a compile error.
+export const keepConnected = <M>(transport: Revivable, method: keyof M & string): (() => void) => {
+    let beat: ReturnType<typeof setInterval> | undefined
+
+    const reconnect = (): void => transport.pipe.reconnectNow()
+
+    const probe = (): void => {
+        void transport.probe(method)
+    }
+
+    const onVisibility = (): void => {
+        clearInterval(beat)
+        beat = undefined
+        if (document.visibilityState !== 'visible') {
+            return
+        }
+        // A socket that DID close while hidden is waiting out a backoff whose
+        // timer was throttled with the tab; collapse it rather than make the
+        // reader wait.
+        reconnect()
+        probe()
+        beat = setInterval(probe, BEAT_MS)
+    }
+
+    addEventListener('online', reconnect)
+    addEventListener('visibilitychange', onVisibility)
+    onVisibility()
+
+    return () => {
+        removeEventListener('online', reconnect)
+        removeEventListener('visibilitychange', onVisibility)
+        clearInterval(beat)
+    }
+}

package/src/live.ts

@@ -10,7 +10,7 @@ import { getErrorSink } from './uxConfig'
 // is the option that matters: it bypasses the loading counter AND the
 // error-UX pipeline, whereas `pending: false` suppresses only the spinner and
 // would still put the blocking retry toast over a screen the user is reading.
-export const backgroundCall = (background: boolean): CallOptions | undefined => (background ? { silent: true } : undefined)
+export const backgroundCall = (background: boolean): CallOptions => (background ? { silent: true } : {})
 
 // @greendrake/rpc's liveBinding under this package's UX policy: a resync runs
 // unseen, and its failure neither interrupts the user nor vanishes.

package/src/main.ts

@@ -1,7 +1,8 @@
-export { ApiClient, UnacceptableResultError, type ApiClientOptions, type CallOptions } from './ApiClient'
+export { ApiClient, UnacceptableResultError, type ApiCaller, type ApiClientOptions, type CallOptions } from './ApiClient'
 export { useExceptionState, classifyException, type ExceptionKind, type FailOptions } from './exceptionState'
 export { configureApiUX, getGoHome, type ConnectionSource, type ErrorSink } from './uxConfig'
 export { apiUXHooks } from './apiUXHooks'
-export { useConnectivity } from './connectivity'
+export { useConnectivity, useConnectionMessageKey } from './connectivity'
 export { retryWhenOnline } from './retryWhenOnline'
+export { keepConnected, type Revivable } from './keepConnected'
 export { backgroundCall, bindLive, useLive } from './live'