@camstack/server 1.2.48 → 1.2.49

package/dist/api/static/precompressed-asset.js

@@ -54,6 +54,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.acceptsBrotli = acceptsBrotli;
 exports.isCompressibleAsset = isCompressibleAsset;
 exports.resolvePrecompressedAsset = resolvePrecompressedAsset;
+exports.warmPrecompressedAssets = warmPrecompressedAssets;
 exports.resetPrecompressedWarning = resetPrecompressedWarning;
 exports.precompressedSiblingExists = precompressedSiblingExists;
 const fs = __importStar(require("node:fs"));
@@ -166,6 +167,50 @@ async function resolvePrecompressedAsset(filePath, acceptEncoding, log) {
         inFlight.delete(filePath);
     }
 }
+/**
+ * Compress a dist's assets in the background, so no CLIENT pays for the first
+ * one.
+ *
+ * Measured on the live hub: the viewer's 5 MB bundle takes 6.7 s at quality 11.
+ * Every request after it is served in 14 ms — but without this, one unlucky
+ * operator right after a deploy waits those 6.7 s, which is WORSE than the
+ * 0.6 s the per-request compression used to cost. Warming turns a cliff into a
+ * bit of boot-time CPU nobody is waiting on.
+ *
+ * Deliberately not awaited by the caller, and deliberately serial: this runs
+ * while the hub is booting the rest of itself, and saturating the CPU to make
+ * a page load faster would be a bad trade. Failures are silent here — the
+ * request path logs them if it ever hits one.
+ */
+function warmPrecompressedAssets(root, log) {
+    void (async () => {
+        let warmed = 0;
+        for (const file of await listCompressible(root)) {
+            const resolved = await resolvePrecompressedAsset(file, 'br').catch(() => null);
+            if (resolved?.encoding === 'br')
+                warmed += 1;
+        }
+        if (warmed > 0)
+            log?.('warmed the precompressed asset cache', { root, files: warmed });
+    })();
+}
+async function listCompressible(dir, out = []) {
+    let entries;
+    try {
+        entries = await fsp.readdir(dir, { withFileTypes: true });
+    }
+    catch {
+        return out;
+    }
+    for (const entry of entries) {
+        const full = path.join(dir, entry.name);
+        if (entry.isDirectory())
+            await listCompressible(full, out);
+        else if (isCompressibleAsset(entry.name) && !entry.name.endsWith('.br'))
+            out.push(full);
+    }
+    return out;
+}
 /** Test seam — the "read-only dist" warning is once per process. */
 function resetPrecompressedWarning() {
     warnedUnwritable = false;

package/dist/main.js

@@ -1136,6 +1136,10 @@ async function bootstrap() {
                     reply.header('cache-control', 'no-cache, must-revalidate');
                     return reply.type('text/html').send(fs.createReadStream(spaIndexHtml));
                 });
+                // Compress the dist in the background so the first CLIENT does not pay
+                // for it — a 5 MB bundle takes ~6.7s at quality 11, and that is a worse
+                // first load than the per-request compression this replaced.
+                (0, precompressed_asset_js_1.warmPrecompressedAssets)(staticDir, (msg, meta) => console.log(`[static] ${msg} ${JSON.stringify(meta)}`));
                 const { version } = await adminUI.getVersion();
                 console.log(`[bootstrap] Admin UI served from: ${staticDir} (v${version})`);
             }
@@ -1215,6 +1219,7 @@ async function bootstrap() {
                     reply.header('cache-control', 'no-cache, must-revalidate');
                     return reply.type('text/html').send(fs.createReadStream(indexPath));
                 });
+                (0, precompressed_asset_js_1.warmPrecompressedAssets)(staticDir, (msg, meta) => console.log(`[static] ${msg} ${JSON.stringify(meta)}`));
                 const { version } = await viewerUI.getVersion();
                 console.log(`[bootstrap] Viewer UI served from: ${staticDir} at ${VIEWER_MOUNT} (v${version})`);
             }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/server",
-  "version": "1.2.48",
+  "version": "1.2.49",
   "private": false,
   "files": [
     "dist",
@@ -39,7 +39,7 @@
     "@camstack/addon-decoder-nodeav": "1.2.9",
     "@camstack/addon-notifiers": "1.2.12",
     "@camstack/addon-pipeline": "1.2.40",
-    "@camstack/addon-pipeline-orchestrator": "1.2.21",
+    "@camstack/addon-pipeline-orchestrator": "1.2.22",
     "@camstack/addon-post-analysis": "1.2.31",
     "@camstack/sdk": "1.2.9",
     "@camstack/shm-ring": "1.1.9",