@ai-ecoverse/slicc-shared-web 1.9.0 → 1.9.1

package/README.md

@@ -59,7 +59,7 @@ test('boots', async (t) => {
 | `isolated` | Send COOP, COEP and CORP on every response, so pages are cross-origin isolated | `false` |
 | `coverage` | URL prefixes whose `.js`/`.mjs` scripts count for coverage. `node_modules/` never does. A `.map` next to a file is used | `['/']` |
 | `exits` | `{ urlPath: [regex, ...] }`: a breakpoint on the first line matching each pattern in that worker script, where the harness takes the worker's coverage and profile before it closes itself | none |
-| `intercept` | Remote URL prefixes answered from a disk cache in `node_modules/.cache/` | none |
+| `intercept` | Remote URL prefixes answered from a disk cache in `node_modules/.cache/`. Registry documents (anything on a `registry.*` host but a `/-/….tgz` tarball: packuments, abbreviated or full, and dist-tags) are fetched fresh once per test process and only served from the disk cache when the registry can't be reached (a `4xx` is passed on) | none |
 | `extensions` | Unpacked extension directories to load. Their scripts are covered and profiled like the repo's own, and tests then run in the default browser context, closing their tabs when they end, because Chrome does not run extensions in the per-test contexts | none |
 | `args` | Extra Chromium flags, such as `--host-resolver-rules` or `--ignore-certificate-errors` | none |
 | `timeout` | How long `page.until` polls and `page.evaluate` waits, in ms | `30000` |
@@ -89,6 +89,7 @@ Why it works the way it does:
 - `takePreciseCoverage` resets the counters, so every snapshot is a delta, and all of them are kept and summed.
 - monocart's `add()` from parallel test processes loses data, so each test writes raw JSON and the teardown merges it once.
 - Coverage of a script served from `chrome.overrides` would be mapped onto the file on disk, so a path overridden during a test is left out of that test's coverage.
+- A CI cache restored with a prefix key kept packuments from before a release, so pnpm in the page saw an outdated `latest` and failed with `ERR_PNPM_NO_MATCHING_VERSION`. Tarballs and versioned CDN files never change and stay cached forever; registry documents do change, so the disk copy is only the offline fallback.
 - `--disable-extensions --disable-component-extensions-with-background-pages` keeps a Hangouts service worker out of every run.
 - The attach event can arrive before `Target.createTarget` returns, so new tabs wait on a slot keyed by target id.
 - A worker blocked in `Atomics.wait`, or one that is already gone, may never answer; snapshots give up after 3 s, and closing a context or the browser after 10 s. A call to a target that detaches or crashes fails instead of waiting forever, and a new tab that never attaches fails after 10 s.

package/harness/cdn.mjs

@@ -21,18 +21,47 @@ export async function fetched(url, { attempts = 3, ms = DOWNLOAD_TIMEOUT, fetche
   }
 }
 
+const fresh = new Map();
+
+export function mutable(url) {
+  const { hostname, pathname } = new URL(url);
+  return hostname.startsWith('registry.') && !/\/-\/[^/]+\.tgz$/.test(pathname);
+}
+
+async function save(file, body) {
+  await mkdir(dirname(fileURLToPath(file)), { recursive: true });
+  const partial = new URL(`${file.href}.${process.pid}`);
+  await writeFile(partial, body);
+  await rename(partial, file);
+  return body;
+}
+
+async function refresh(url, file) {
+  const body = await fetched(url).catch(async (error) => {
+    if (/^4\d\d /.test(error.message)) throw error;
+    const stale = await readFile(file).catch(ignore);
+    if (!stale) throw error;
+    console.warn(`harness: serving cached ${url}: ${error.message}`);
+    return null;
+  });
+  return body ? save(file, body) : readFile(file);
+}
+
 export async function download(url) {
   const { host, pathname, search } = new URL(url);
   const query = search ? encodeURIComponent(search) : '';
   const file = new URL(`./${host}${pathname}${query}`.replaceAll('%', '%25'), store);
+  if (mutable(url)) {
+    if (!fresh.has(url)) {
+      const pending = refresh(url, file);
+      fresh.set(url, pending);
+      pending.catch(() => fresh.delete(url));
+    }
+    return fresh.get(url);
+  }
   const hit = await readFile(file).catch(ignore);
   if (hit) return hit;
-  const body = await fetched(url);
-  await mkdir(dirname(fileURLToPath(file)), { recursive: true });
-  const partial = new URL(`${file.href}.${process.pid}`);
-  await writeFile(partial, body);
-  await rename(partial, file);
-  return body;
+  return save(file, await fetched(url));
 }
 
 export async function cdn(cdp, remotes) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-ecoverse/slicc-shared-web",
-  "version": "1.9.0",
+  "version": "1.9.1",
   "description": "Shared Renovate, Biome, TypeScript, lefthook and GitHub Actions configuration, plus the CDP integration-test harness, for SLICC's web repos",
   "type": "module",
   "license": "Apache-2.0",