docs: cache-bust app and worker with build sha

Author: ClaudiuCeia

.github/workflows/pages.yml

@@ -36,6 +36,9 @@ jobs:
       - name: Build docs bundle
         run: deno task docs:bundle
 
+      - name: Stamp build SHA (cache bust)
+        run: sed -i "s/__BUILD_SHA__/${GITHUB_SHA}/g" docs/index.html
+
       - name: Configure Pages
         uses: actions/configure-pages@v5
 

docs/app.js

@@ -164,6 +164,8 @@ let activeEntEl = null;
 let cardPinned = false;
 let cardHideTimer = 0;
 
+const BUILD = globalThis.__TS_DUCKLING_BUILD__ || "dev";
+
 const ATOMIC_KINDS = new Set([
   "ip",
   "url",
@@ -251,7 +253,9 @@ const setSelection = (set) => {
 
 const ensureWorker = () => {
   if (worker) return worker;
-  worker = new Worker(new URL("./worker.js", import.meta.url), {
+  const u = new URL("./worker.js", import.meta.url);
+  u.searchParams.set("v", BUILD);
+  worker = new Worker(u, {
     type: "module",
   });
   worker.onmessage = (ev) => {

docs/index.html

@@ -375,6 +375,9 @@ <h2 class="text-sm font-semibold tracking-wide text-slate-900">
       </div>
     </div>
 
-    <script type="module" src="./app.js?v=20260208-1"></script>
+    <script>
+      globalThis.__TS_DUCKLING_BUILD__ = "__BUILD_SHA__";
+    </script>
+    <script type="module" src="./app.js?v=__BUILD_SHA__"></script>
   </body>
 </html>

docs/worker.js

@@ -7,7 +7,11 @@ const loadModule = () => {
   // Prefer local bundle for development/preview, but fall back to esm.sh for
   // production (GitHub Pages) or when the bundle is missing.
   modPromise = (async () => {
-    const local = new URL("./vendor/ts-duckling.js", import.meta.url).href;
+    const build = globalThis.__TS_DUCKLING_BUILD__ || "dev";
+    const local = new URL(
+      `./vendor/ts-duckling.js?v=${encodeURIComponent(build)}`,
+      import.meta.url,
+    ).href;
     try {
       return await import(local);
     } catch {