@steve31415/baselib 3.48.0 → 3.48.2

package/dist/extension-self-update.d.ts

@@ -1,5 +1,12 @@
 export declare const STABLE_MS: number;
 export declare const RETRY_MS: number;
+/**
+ * How long one renewal keeps the extension busy. Renewals come every ~10 s from
+ * an open overlay, but Chrome's intensive throttling slows a page's chained
+ * timers to one wake-up a minute once its tab has been hidden 5 minutes, so the
+ * lease must outlast a 60 s gap with room to spare (an overlay left open in a
+ * background tab must still hold off a reload).
+ */
 export declare const BUSY_LEASE_MS: number;
 export declare const CODE_MANIFEST_FILE = "mac-code.json";
 /** chrome.storage.session: { code, since } — the shipped code first seen verified on disk. */
@@ -10,6 +17,16 @@ export declare const ATTEMPT_KEY = "selfUpdateAttempt";
 export declare const LOADED_KEY = "selfUpdateLoaded";
 /** chrome.storage.session: epoch ms until which the extension is busy (an open overlay renews it). */
 export declare const BUSY_LEASE_KEY = "selfUpdateBusyUntil";
+/** chrome.storage.session: epoch ms of the previous check (to notice the machine just woke). */
+export declare const LAST_CHECK_KEY = "selfUpdateLastCheck";
+/**
+ * A check that comes more than this long after the previous one follows a
+ * sleep (checks run on a 1-minute alarm): it only waits. Chrome fires the
+ * overdue alarm the moment the machine wakes, before a page's lease-renewal
+ * timer has had its turn, so a lease that lapsed during the sleep must not
+ * count as "not busy" yet.
+ */
+export declare const WOKE_GAP_MS: number;
 interface Seen {
     code: string;
     since: number;
@@ -58,10 +75,12 @@ export declare function decideUpdate(input: {
 /**
  * Check and reload when the rules allow. `shipped`: the code the server last
  * said it deployed (null when unknown). `busy`: the extension's own work in
- * flight; the busy lease and open extension pages are checked here too.
+ * flight — pass a function, so it is read at the moment of the reload rather
+ * than before the disk checks; the busy lease and open extension pages are
+ * checked here too. The first check after a sleep only waits (WOKE_GAP_MS).
  */
 export declare function maybeSelfUpdate(options: {
-    busy: boolean;
+    busy: boolean | (() => boolean);
     shipped: string | null | undefined;
     log?: (message: string) => void;
 }): Promise<UpdateAction | 'busy'>;

package/dist/extension-self-update.js

@@ -18,7 +18,14 @@
 // test in each repo.
 export const STABLE_MS = 60 * 1000;
 export const RETRY_MS = 6 * 60 * 60 * 1000;
-export const BUSY_LEASE_MS = 30 * 1000;
+/**
+ * How long one renewal keeps the extension busy. Renewals come every ~10 s from
+ * an open overlay, but Chrome's intensive throttling slows a page's chained
+ * timers to one wake-up a minute once its tab has been hidden 5 minutes, so the
+ * lease must outlast a 60 s gap with room to spare (an overlay left open in a
+ * background tab must still hold off a reload).
+ */
+export const BUSY_LEASE_MS = 150 * 1000;
 export const CODE_MANIFEST_FILE = 'mac-code.json';
 /** chrome.storage.session: { code, since } — the shipped code first seen verified on disk. */
 export const SEEN_KEY = 'selfUpdateSeen';
@@ -28,6 +35,16 @@ export const ATTEMPT_KEY = 'selfUpdateAttempt';
 export const LOADED_KEY = 'selfUpdateLoaded';
 /** chrome.storage.session: epoch ms until which the extension is busy (an open overlay renews it). */
 export const BUSY_LEASE_KEY = 'selfUpdateBusyUntil';
+/** chrome.storage.session: epoch ms of the previous check (to notice the machine just woke). */
+export const LAST_CHECK_KEY = 'selfUpdateLastCheck';
+/**
+ * A check that comes more than this long after the previous one follows a
+ * sleep (checks run on a 1-minute alarm): it only waits. Chrome fires the
+ * overdue alarm the moment the machine wakes, before a page's lease-renewal
+ * timer has had its turn, so a lease that lapsed during the sleep must not
+ * count as "not busy" yet.
+ */
+export const WOKE_GAP_MS = 2 * 60 * 1000;
 function hex(bytes) {
     return Array.from(new Uint8Array(bytes), (b) => b.toString(16).padStart(2, '0')).join('');
 }
@@ -142,9 +159,15 @@ export function decideUpdate(input) {
 /**
  * Check and reload when the rules allow. `shipped`: the code the server last
  * said it deployed (null when unknown). `busy`: the extension's own work in
- * flight; the busy lease and open extension pages are checked here too.
+ * flight — pass a function, so it is read at the moment of the reload rather
+ * than before the disk checks; the busy lease and open extension pages are
+ * checked here too. The first check after a sleep only waits (WOKE_GAP_MS).
  */
 export async function maybeSelfUpdate(options) {
+    const { [LAST_CHECK_KEY]: lastCheck } = await chrome.storage.session.get(LAST_CHECK_KEY);
+    const started = Date.now();
+    await chrome.storage.session.set({ [LAST_CHECK_KEY]: started });
+    const justWoke = typeof lastCheck === 'number' && started - lastCheck > WOKE_GAP_MS;
     const loaded = await loadedCode();
     const disk = await diskCode();
     const { [SEEN_KEY]: seen } = await chrome.storage.session.get(SEEN_KEY);
@@ -162,7 +185,10 @@ export async function maybeSelfUpdate(options) {
     if (decision.action !== 'reload' || !decision.seen)
         return decision.action;
     const target = decision.seen.code;
-    if (options.busy || (await busyLeaseActive(now)) || (await extensionPageOpen()))
+    if (justWoke)
+        return 'wait';
+    const busy = typeof options.busy === 'function' ? options.busy() : options.busy;
+    if (busy || (await busyLeaseActive(Date.now())) || (await extensionPageOpen()))
         return 'busy';
     options.log?.(`code ${target} is deployed and on disk (running ${loaded}): reloading.`);
     await chrome.storage.local.set({ [ATTEMPT_KEY]: { code: target, at: now } });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@steve31415/baselib",
-  "version": "3.48.0",
+  "version": "3.48.2",
   "description": "Plasticine new-world shared platform library: logging, auth, service-to-service auth, db, HTTP, sync, app updates",
   "type": "module",
   "license": "MIT",