@steve31415/baselib 3.21.0 → 3.22.0

package/dist/app-update-browser/build-update.d.ts

@@ -26,8 +26,17 @@ export interface BuildUpdateDeps {
     reload?: () => void;
     pollMs?: number;
     onTrafficBuildChange?: (buildId: string) => void;
+    /** Whether this document's HTML came from the browser cache without a
+     * request (default: `shellServedFromCache`). */
+    shellFromCache?: () => boolean;
 }
 export declare function pageBuildId(): string;
+/** True when this page's HTML was served from the browser cache without
+ * reaching the server. Android Chrome does this when it restores a tab whose
+ * renderer it killed in the background, even for a `no-cache` shell, so the
+ * restored page can run a build older than current traffic (reader,
+ * 2026-09-26/27: 9 of 15 phone page loads). */
+export declare function shellServedFromCache(): boolean;
 export declare class BuildUpdateMonitor {
     private deps;
     private state;
@@ -40,8 +49,10 @@ export declare class BuildUpdateMonitor {
     private appliedRequestNumber;
     private trafficBuild;
     private checkFailure;
-    /** When the page last went from hidden to visible (not page load). */
+    /** When the page last went from hidden to visible, or was loaded visible
+     * from a cached shell (a restored tab is a return in all but name). */
     private returnedAt;
+    private restoredFromCache;
     private deferUntilHidden;
     constructor(deps: BuildUpdateDeps);
     getState: () => BuildUpdateState;

package/dist/app-update-browser/build-update.js

@@ -12,6 +12,19 @@ const LEGACY_BUILD = 'legacy-pre-build-id';
 export function pageBuildId() {
     return document.querySelector('meta[name="pw-build-id"]')?.content || 'development';
 }
+/** True when this page's HTML was served from the browser cache without
+ * reaching the server. Android Chrome does this when it restores a tab whose
+ * renderer it killed in the background, even for a `no-cache` shell, so the
+ * restored page can run a build older than current traffic (reader,
+ * 2026-09-26/27: 9 of 15 phone page loads). */
+export function shellServedFromCache() {
+    const entry = globalThis.performance?.getEntriesByType?.('navigation')[0];
+    if (!entry)
+        return false;
+    if (entry.deliveryType === 'cache')
+        return true;
+    return entry.transferSize === 0 && entry.decodedBodySize > 0;
+}
 export class BuildUpdateMonitor {
     deps;
     state = { kind: 'current' };
@@ -24,8 +37,10 @@ export class BuildUpdateMonitor {
     appliedRequestNumber = 0;
     trafficBuild = null;
     checkFailure = false;
-    /** When the page last went from hidden to visible (not page load). */
+    /** When the page last went from hidden to visible, or was loaded visible
+     * from a cached shell (a restored tab is a return in all but name). */
     returnedAt = null;
+    restoredFromCache = false;
     deferUntilHidden = false;
     constructor(deps) {
         this.deps = deps;
@@ -41,6 +56,13 @@ export class BuildUpdateMonitor {
         this.started = true;
         this.lifecycle += 1;
         this.stopSafety = this.deps.safety.subscribe(() => this.maybeReload());
+        // A tab restored from the cache shows whatever build it last loaded; a
+        // reload now would replace it just as it appears. Treat it as a return.
+        // (A hidden restore needs nothing: its reload is out of sight anyway.)
+        if (document.visibilityState === 'visible' && (this.deps.shellFromCache ?? shellServedFromCache)()) {
+            this.returnedAt = Date.now();
+            this.restoredFromCache = true;
+        }
         if (document.visibilityState === 'visible')
             this.startPolling();
         document.addEventListener('visibilitychange', this.onVisibility);
@@ -145,6 +167,7 @@ export class BuildUpdateMonitor {
                     pageBuildId: this.deps.currentBuildId,
                     observedBuildId: buildId,
                     sinceReturnMs: Date.now() - (this.returnedAt ?? Date.now()),
+                    restoredFromCache: this.restoredFromCache,
                 });
             }
         }
@@ -191,6 +214,7 @@ export class BuildUpdateMonitor {
     onVisibility = () => {
         if (document.visibilityState === 'visible') {
             this.returnedAt = Date.now();
+            this.restoredFromCache = false;
             this.startPolling();
             void this.checkNow();
         }

package/package.json

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