@steve31415/baselib 3.48.2 → 3.48.3

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

@@ -46,13 +46,25 @@ export declare function codeIdOf(files: Record<string, string>): Promise<string>
  */
 export declare function diskCode(): Promise<string | null>;
 /**
- * Record the code Chrome just loaded. Call from runtime.onInstalled and
- * runtime.onStartup — the moments Chrome reads the extension from disk — and
- * nowhere else: a worker restarting after eviction runs the code loaded
- * earlier, whatever the disk holds now.
+ * Record the code Chrome just loaded. Call from runtime.onInstalled ONLY: that
+ * is when Chrome registers the worker script afresh from disk (install,
+ * chrome.runtime.reload(), a click on reload). Not from runtime.onStartup: a
+ * browser restart re-reads an unpacked extension's manifest and content
+ * scripts from disk but keeps running the worker script it registered
+ * earlier, even when the file on disk changed (measured 2026-11-02: Lurch's
+ * card said 2.6 after a restart while its worker still ran 2.5's code). And
+ * never on a worker restart after eviction, which also runs the registered
+ * script whatever the disk holds now.
  */
 export declare function recordLoadedCode(): Promise<string>;
-/** The code this extension runs: the record from its last load (re-taken when the record predates this manifest). */
+/**
+ * The code this extension runs: the record from its last load. 'unverified'
+ * when there is no record, or when the record predates the manifest Chrome now
+ * shows (a browser restart picked up a new manifest while the worker may still
+ * be the old script) — never re-read from disk, which would label an old
+ * worker as the new code. 'unverified' differs from every deployed id, so the
+ * extension reloads itself into the deployed code once it is on disk.
+ */
 export declare function loadedCode(): Promise<string>;
 /** Mark the extension busy for BUSY_LEASE_MS (an open overlay calls this through the worker every ~10 s). */
 export declare function extendBusyLease(now?: number): Promise<void>;

package/dist/extension-self-update.js

@@ -105,10 +105,15 @@ export async function diskCode() {
     return id;
 }
 /**
- * Record the code Chrome just loaded. Call from runtime.onInstalled and
- * runtime.onStartup — the moments Chrome reads the extension from disk — and
- * nowhere else: a worker restarting after eviction runs the code loaded
- * earlier, whatever the disk holds now.
+ * Record the code Chrome just loaded. Call from runtime.onInstalled ONLY: that
+ * is when Chrome registers the worker script afresh from disk (install,
+ * chrome.runtime.reload(), a click on reload). Not from runtime.onStartup: a
+ * browser restart re-reads an unpacked extension's manifest and content
+ * scripts from disk but keeps running the worker script it registered
+ * earlier, even when the file on disk changed (measured 2026-11-02: Lurch's
+ * card said 2.6 after a restart while its worker still ran 2.5's code). And
+ * never on a worker restart after eviction, which also runs the registered
+ * script whatever the disk holds now.
  */
 export async function recordLoadedCode() {
     const code = (await diskCode()) ?? 'unverified';
@@ -116,13 +121,20 @@ export async function recordLoadedCode() {
     await chrome.storage.local.set({ [LOADED_KEY]: record });
     return code;
 }
-/** The code this extension runs: the record from its last load (re-taken when the record predates this manifest). */
+/**
+ * The code this extension runs: the record from its last load. 'unverified'
+ * when there is no record, or when the record predates the manifest Chrome now
+ * shows (a browser restart picked up a new manifest while the worker may still
+ * be the old script) — never re-read from disk, which would label an old
+ * worker as the new code. 'unverified' differs from every deployed id, so the
+ * extension reloads itself into the deployed code once it is on disk.
+ */
 export async function loadedCode() {
     const { [LOADED_KEY]: stored } = await chrome.storage.local.get(LOADED_KEY);
     const record = stored;
     if (record && typeof record.code === 'string' && record.version === chrome.runtime.getManifest().version)
         return record.code;
-    return recordLoadedCode();
+    return 'unverified';
 }
 /** Mark the extension busy for BUSY_LEASE_MS (an open overlay calls this through the worker every ~10 s). */
 export async function extendBusyLease(now = Date.now()) {

package/package.json

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