@awesomate/sdk 0.9.0 → 0.10.0

package/README.md

@@ -146,6 +146,11 @@ and takes a fresh copy when it does. Up to 200 rows a list and 20 lists a connec
 `{ onRows, onError }` to hear about a list the server refused (a column that does not exist).
 Outside a browser, give it a WebSocket: `createAppClient({ publishableKey, WebSocket })`.
 
+While a list is open in a browser, the connection also tells the hub whether the tab is in front.
+If the account switched on reply emails, someone looking at the app isn't emailed about a reply,
+but a tab left open in the background doesn't count as looking, and closing the last one counts as
+leaving straight away.
+
 ### Staff find a customer
 
 People in an app read no contacts but their own, so by default staff cannot put a job under a

package/dist/index.js

@@ -553,6 +553,10 @@ function unref(t) {
     t.unref?.();
     return t;
 }
+/** The page's document, when there is one: the part live() reads to say whether the tab is in front. */
+function pageDocument() {
+    return globalThis.document;
+}
 /** The one WebSocket behind live(). */
 class LiveSocket {
     o;
@@ -569,6 +573,15 @@ class LiveSocket {
     connecting = false;
     constructor(o) {
         this.o = o;
+        // Reply emails wait only while one of the person's tabs is in front, so the hub hears when this
+        // one goes to the back or comes forward. Outside a browser there is no tab, and nothing is sent.
+        pageDocument()?.addEventListener?.('visibilitychange', () => this.sendPresence());
+    }
+    /** Whether this tab is in front, to the hub (from 0.10.0; an older hub ignores the frame). */
+    sendPresence() {
+        const d = pageDocument();
+        if (this.ready && typeof d?.visibilityState === 'string')
+            this.send({ type: 'presence', visible: d.visibilityState === 'visible' });
     }
     add(spec, handlers) {
         const id = `l${++this.seq}`;
@@ -632,6 +645,7 @@ class LiveSocket {
             this.attempt = 0;
             for (const [id, e] of this.entries)
                 this.send({ type: 'sub', id, spec: e.spec });
+            this.sendPresence();
             this.pinger = unref(setInterval(() => this.send({ type: 'ping' }), 25_000));
             return;
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@awesomate/sdk",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "Your own Awesomate data from Node and the browser: query contacts and app data with generated types, and sign your app's own users in",
   "license": "MIT",
   "type": "module",