@bcrumbs.net/inbox 0.0.73 → 0.0.74

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@bcrumbs.net/inbox",
   "description": "Inbox widget for Bread Crumbs portals",
-  "version": "0.0.73",
+  "version": "0.0.74",
   "keyword": [
     "bcrumbs",
     "bc-ui",

package/src/app/generic/components/NewVersionBanner.d.ts

@@ -0,0 +1,4 @@
+import { type FC } from 'react';
+/** Non-blocking notice that a newer build is deployed, with a reload onto it. */
+declare const NewVersionBanner: FC;
+export default NewVersionBanner;

package/src/app/generic/hooks/useNewerBuild.d.ts

@@ -0,0 +1,13 @@
+type NewerBuild = {
+    /** Commit of a deployed build newer than the running one; null while the running build is current. */
+    newerSha: string | null;
+    /** Hides the notice until the next check finds the newer build again. */
+    dismiss: () => void;
+};
+/**
+ * Watches for a deploy newer than the running build. It checks when the tab
+ * becomes visible or regains focus, which is when a long-open tab comes back
+ * into use; the checker throttles both events to one request per interval.
+ */
+export declare function useNewerBuild(): NewerBuild;
+export {};

package/src/app/generic/utils/versionCheck.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Hashed chunks from earlier deploys stay on static hosting, so a tab left open
+ * across a deploy keeps running its old build, and fixes never reach it until
+ * the user reloads by hand. Every deploy serves /version.json with the commit
+ * it was built from (tools/scripts/generate-build-info.js writes it together
+ * with build-info.json), so comparing that commit with the one this bundle was
+ * built from tells the tab it is out of date.
+ */
+export declare const VERSION_CHECK_INTERVAL_MS: number;
+/** Commit this bundle was built from. */
+export declare const RUNNING_BUILD_SHA: string;
+/** Commit of the deployed build, or null when version.json cannot be read. */
+export declare function fetchDeployedSha(): Promise<string | null>;
+type VersionCheckerOptions = {
+    runningSha: string;
+    fetchSha?: () => Promise<string | null>;
+    intervalMs?: number;
+    now?: () => number;
+};
+/**
+ * Returns a check that reads the deployed commit at most once per interval and
+ * resolves to it when it differs from the running build, otherwise to null.
+ * The interval starts at creation: a page that just loaded runs the latest build.
+ */
+export declare function createVersionChecker({ runningSha, fetchSha, intervalMs, now, }: VersionCheckerOptions): () => Promise<string | null>;
+/** Reloads onto the deployed build. index.html is served no-cache, so the reload pulls the new entry. */
+export declare function reloadToDeployedBuild(deployedSha: string): void;
+export {};

package/src/assets/locales/translations.d.ts

@@ -1238,6 +1238,12 @@ export declare const convertLanguageJsonToObject: (json: any, objToConvertTo?: C
         installApp: string;
         addAppToHomeScreen: string;
     };
+    appVersion: {
+        newVersionTitle: string;
+        newVersionDescription: string;
+        reload: string;
+        later: string;
+    };
     offline: {
         title: string;
         message: string;