bun-plugin-stx 0.2.140 → 0.2.142

package/dist/serve.d.ts

@@ -65,6 +65,7 @@ export declare function render404Page(opts: {
   routes?: string[]
   isProduction: boolean
 }): string;
+export declare function isRenderableCacheCandidate(html: string): boolean;
 export declare function bundleBrowserAsset(entrypoint: string): Promise<Response>;
 /**
  * Start the STX development server
@@ -114,6 +115,10 @@ export declare interface ServeOptions {
   componentsDir?: string
   layoutsDir?: string
   partialsDir?: string
+  watchDirs?: string[]
+  renderCache?: boolean
+  renderCacheVary?: 'request' | 'source'
+  prewarmRenderCache?: boolean | number
   publicDir?: string
   quiet?: boolean
   autoIncrementPort?: boolean | number

package/dist/serve.js

@@ -8860,6 +8860,9 @@ function render404Page(opts) {
   </body>
 </html>`;
 }
+function isRenderableCacheCandidate(html) {
+  return !html.includes("<!-- Template Processing failed:") && !html.includes("<!-- stx rendering error -->");
+}
 var defaultStxConfig = {
   partialsDir: "partials",
   componentsDir: "components",
@@ -8995,7 +8998,8 @@ After installing: bun add bun-plugin-stx`);
   let discoveredPagePaths = null;
   let assetsInitialized = false;
   const htmlCache = new Map;
-  const ENABLE_HTML_CACHE = false;
+  const ENABLE_HTML_CACHE = options.renderCache === true;
+  const RENDER_CACHE_VARY = options.renderCacheVary ?? "request";
   const crosswindCssCache = new Map;
   const hmrClients = new Set;
   const hmrEncoder = new TextEncoder;
@@ -9031,12 +9035,15 @@ After installing: bun add bun-plugin-stx`);
           return;
         const f = String(filename);
         const isStxLike = f.endsWith(".stx") || f.endsWith(".md") || f.endsWith(".html");
+        const isCode = f.endsWith(".js") || f.endsWith(".ts") || f.endsWith(".tsx") || f.endsWith(".mts") || f.endsWith(".cts");
+        const isData = f.endsWith(".json");
         const isCss = f.endsWith(".css");
-        const isAsset = isCss || f.endsWith(".js") || f.endsWith(".ts") || f.endsWith(".tsx") || f.endsWith(".mts") || f.endsWith(".cts") || f.endsWith(".jpg") || f.endsWith(".jpeg") || f.endsWith(".png") || f.endsWith(".gif") || f.endsWith(".svg") || f.endsWith(".webp") || f.endsWith(".avif") || f.endsWith(".woff") || f.endsWith(".woff2") || f.endsWith(".ttf") || f.endsWith(".otf");
-        if (!isStxLike && !isAsset)
+        const isAsset = isCss || isCode || f.endsWith(".jpg") || f.endsWith(".jpeg") || f.endsWith(".png") || f.endsWith(".gif") || f.endsWith(".svg") || f.endsWith(".webp") || f.endsWith(".avif") || f.endsWith(".woff") || f.endsWith(".woff2") || f.endsWith(".ttf") || f.endsWith(".otf");
+        if (!isStxLike && !isAsset && !isData)
           return;
-        if (isStxLike) {
-          sourceFiles = null;
+        if (isStxLike || isCode || isData) {
+          if (isStxLike)
+            sourceFiles = null;
           routes.clear();
           htmlCache.clear();
           crosswindCssCache.clear();
@@ -9053,7 +9060,8 @@ After installing: bun add bun-plugin-stx`);
     layoutsDir,
     partialsDir,
     publicDir,
-    "resources/assets"
+    "resources/assets",
+    ...options.watchDirs ?? []
   ]) {
     if (!dir)
       continue;
@@ -9209,14 +9217,24 @@ After installing: bun add bun-plugin-stx`);
     context.__stxServeContext = full;
     globalThis.__stxServeContext = full;
   }
-  function htmlCacheKey(filePath) {
+  function htmlCacheKey(filePath, reqCtx) {
+    if (RENDER_CACHE_VARY === "source")
+      return filePath;
+    if (reqCtx) {
+      try {
+        return `${filePath}\x00${JSON.stringify(reqCtx)}`;
+      } catch {
+        return `${filePath}\x00uncacheable:${crypto.randomUUID()}`;
+      }
+    }
     const loc = i18nConfig ? activeServeLocale ?? i18nConfig.defaultLocale : "";
     const search = activeServeSearch || "";
     const host = activeServeHost || "";
     const cookies = activeServeCookieHeader;
-    if (!loc && !search && !host && !cookies)
+    const ip = activeServeIp;
+    if (!loc && !search && !host && !cookies && !ip)
       return filePath;
-    return `${filePath}\x00${loc}\x00${search}\x00${host}\x00${cookies}`;
+    return `${filePath}\x00${loc}\x00${search}\x00${host}\x00${cookies}\x00${ip}`;
   }
   const builtInMiddleware = authConfig === null ? {} : {
     auth: (_req, ctx) => {
@@ -9517,7 +9535,7 @@ After installing: bun add bun-plugin-stx`);
       reqCtx.responseStatus = extractPageResponseStatus(content) ?? 200;
     const skipCacheHint = /(?:^|[^\w$])__stx_skip_cache\s*=\s*true/.test(content);
     if (ENABLE_HTML_CACHE && !skipCacheHint) {
-      const cacheKey = htmlCacheKey(filePath);
+      const cacheKey = htmlCacheKey(filePath, reqCtx);
       const cachedEntry = htmlCache.get(cacheKey);
       if (cachedEntry && await templateSignatureFresh(cachedEntry.signature))
         return cachedEntry.html;
@@ -9582,9 +9600,9 @@ After installing: bun add bun-plugin-stx`);
     } else {
       output = output.replace(/<template[^>]*>/gi, "").replace(/<\/template>/gi, "");
     }
-    if (ENABLE_HTML_CACHE && !context.__stx_skip_cache && !skipCacheHint) {
+    if (ENABLE_HTML_CACHE && !context.__stx_skip_cache && !skipCacheHint && isRenderableCacheCandidate(output)) {
       const signature = await buildTemplateSignature(filePath, dependencies);
-      htmlCache.set(htmlCacheKey(filePath), { html: output, signature });
+      htmlCache.set(htmlCacheKey(filePath, reqCtx), { html: output, signature });
     }
     return output;
   }
@@ -10472,6 +10490,24 @@ ${trailingPageScripts.join(`
   if (actualPort !== port && !options.quiet) {
     console.warn(`\x1B[33m[stx]\x1B[0m port ${port} in use \u2014 using \x1B[1m${actualPort}\x1B[0m instead`);
   }
+  if (ENABLE_HTML_CACHE && options.prewarmRenderCache) {
+    const requestedConcurrency = typeof options.prewarmRenderCache === "number" ? Math.floor(options.prewarmRenderCache) : 4;
+    const concurrency = Math.max(1, requestedConcurrency);
+    (async () => {
+      const files = await discoverFiles();
+      const pending = [...new Set(files.map(stxViewFileToRoutePath).filter((routePath) => routePath !== null))];
+      let nextIndex = 0;
+      await Promise.all(Array.from({ length: Math.min(concurrency, pending.length) }, async () => {
+        while (nextIndex < pending.length) {
+          const routePath = pending[nextIndex++];
+          try {
+            const response = await fetch(`http://127.0.0.1:${actualPort}${routePath}`);
+            await response.arrayBuffer();
+          } catch {}
+        }
+      }));
+    })().catch(() => {});
+  }
   if (options.reusePort) {
     const graceMs = Number(process19.env.SHUTDOWN_GRACE_MS) || 15000;
     process19.once("SIGTERM", () => {
@@ -10528,6 +10564,7 @@ export {
   staticCacheControl,
   serve,
   render404Page,
+  isRenderableCacheCandidate,
   isProductionServe,
   extractServerScriptsFromTemplate,
   bundleBrowserAsset,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "bun-plugin-stx",
   "type": "module",
-  "version": "0.2.140",
+  "version": "0.2.142",
   "description": "A Bun plugin that allows for using Laravel Blade-like syntax.",
   "author": "Chris Breuer <chris@stacksjs.org>",
   "license": "MIT",