bun-plugin-stx 0.2.103 → 0.2.105

package/dist/serve.d.ts

@@ -17,6 +17,24 @@ export declare function buildDynamicRouteRegexes(fileRouteBase: string): RegExp[
  * `NODE_ENV=development`, so it keeps the helpful list.
  */
 export declare function isProductionServe(): boolean;
+/**
+ * `Cache-Control` for a file served straight out of `publicDir`.
+ *
+ * Development says `no-store`, so a swapped favicon or hero image appears on
+ * the next reload rather than an hour later.
+ *
+ * Production does not: this server IS production for a server-rendered deploy,
+ * with no CDN in front stamping cache headers on the way past. Sending
+ * `no-store` there told every browser, proxy and link-preview crawler to
+ * re-fetch every image on every request, and made messengers that cache a
+ * preview by its headers throw the card away.
+ *
+ * An hour for ordinary assets, because they are replaced in place by a deploy
+ * and a share card that changed with a copy edit should not be stale for a
+ * year. A fingerprinted name (a content hash in it) can never change under a
+ * given URL, so it gets the long immutable lifetime.
+ */
+export declare function staticCacheControl(pathname: string, production?: boolean): string;
 /**
  * Render the built-in fallback 404 page.
  *
@@ -98,6 +116,11 @@ export declare interface ServeOptions {
   | null
   | undefined
   | Promise<Response | Record<string, unknown> | null | undefined>
+  onResponse?: (req: Request, response: Response) =>
+  | Response
+  | null
+  | undefined
+  | Promise<Response | null | undefined>
   middleware?: Record<string, MiddlewareHandler>
   globalMiddleware?: string[]
   middlewareGroups?: Record<string, string[]>

package/dist/serve.js

@@ -8726,6 +8726,12 @@ function isProductionServe() {
   const devEnvs = new Set(["development", "dev", "local", "test", "testing"]);
   return !(devEnvs.has(node) || devEnvs.has(app));
 }
+function staticCacheControl(pathname, production = isProductionServe()) {
+  if (!production)
+    return "no-store";
+  const fingerprinted = /[.-][0-9a-f]{8,}\.[a-z0-9]+$/i.test(pathname);
+  return fingerprinted ? "public, max-age=31536000, immutable" : "public, max-age=3600";
+}
 function render404Page(opts) {
   const { path, routes = [], isProduction } = opts;
   const baseStyles = `
@@ -10263,7 +10269,7 @@ ${pageSetupScripts.join(`
                           return new Response(file, {
                             headers: {
                               "Content-Type": staticContentTypes[ext || ""] || "application/octet-stream",
-                              "Cache-Control": "no-store"
+                              "Cache-Control": staticCacheControl(resolvedPath)
                             }
                           });
                         }
@@ -10321,7 +10327,13 @@ ${pageSetupScripts.join(`
               activeServeIp = "";
             }
           })();
-          return applyI18nToResponse(_i18nResp, i18nLocale ?? (i18nConfig?.defaultLocale ?? "en"), path);
+          const _finalResp = await applyI18nToResponse(_i18nResp, i18nLocale ?? (i18nConfig?.defaultLocale ?? "en"), path);
+          if (options.onResponse) {
+            const hooked = await options.onResponse(req, _finalResp);
+            if (hooked instanceof Response)
+              return hooked;
+          }
+          return _finalResp;
         }
       });
       break;
@@ -10399,6 +10411,7 @@ if (import.meta.main) {
   main().catch(console.error);
 }
 export {
+  staticCacheControl,
   serve,
   render404Page,
   isProductionServe,

package/package.json

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