bun-plugin-stx 0.2.319 → 0.2.321

package/dist/serve.d.ts

@@ -227,6 +227,17 @@ export declare function isRenderableCacheCandidate(html: string): boolean;
  */
 export declare function usableErrorPage(rendered: string | null): string | null;
 export declare function bundleBrowserAsset(entrypoint: string): Promise<Response>;
+/**
+ * The bind budget from an option or config value. Anything that is not a
+ * finite, non-negative number falls back to the default rather than to
+ * "forever", since an unbounded wait is the failure the budget exists to stop.
+ */
+export declare function resolveImageWarmupBindBudget(value: unknown): number;
+/**
+ * Whether `promise` settles within `ms`. It is not cancelled either way: the
+ * caller decides what to do with work that is still running.
+ */
+export declare function settleWithin(promise: Promise<unknown>, ms: number): Promise<boolean>;
 /**
  * Start the STX development server
  * @param options Server options with patterns and port
@@ -256,6 +267,8 @@ export declare const ROUTE_PARAMS_PLACEHOLDER: '__STX_ROUTE_PARAMS__';
 export declare const CSRF_COOKIE: 'X-CSRF-Token';
 /** `/_stx/runtime.js`, `/_stx/router.<16 hex>.js`, … — the shared client scripts. */
 export declare const SHARED_SCRIPT_PATH: unknown;
+/** Default for `imageWarmupBindBudgetMs`: well inside ts-cloud's 180s bind window. */
+export declare const DEFAULT_IMAGE_WARMUP_BIND_BUDGET_MS: unknown;
 /**
  * Build the candidate regexes for a dynamic route file (stacksjs/stx#1927).
  *
@@ -314,6 +327,7 @@ export declare interface ServeOptions {
   cssCacheLimit?: number
   prewarmRenderCache?: boolean | number
   imageWarmupGraceMs?: number
+  imageWarmupBindBudgetMs?: number
   imageWarmup?: boolean | 'auto'
   publicDir?: string
   quiet?: boolean

package/dist/serve.js

@@ -9216,6 +9216,28 @@ async function bundleBrowserAsset(entrypoint) {
     }
   });
 }
+var DEFAULT_IMAGE_WARMUP_BIND_BUDGET_MS = 45000;
+function resolveImageWarmupBindBudget(value) {
+  const ms = typeof value === "string" && value.trim() !== "" ? Number(value) : value;
+  return typeof ms === "number" && Number.isFinite(ms) && ms >= 0 ? ms : DEFAULT_IMAGE_WARMUP_BIND_BUDGET_MS;
+}
+async function settleWithin(promise, ms) {
+  let timer;
+  const settled = promise.then(() => true, () => true);
+  try {
+    return await Promise.race([
+      settled,
+      new Promise((resolve13) => {
+        timer = setTimeout(resolve13, ms, false);
+      })
+    ]);
+  } finally {
+    clearTimeout(timer);
+  }
+}
+function formatSeconds(ms) {
+  return `${(ms / 1000).toFixed(ms < 1e4 ? 1 : 0)}s`;
+}
 async function serve(options) {
   const stxConfig = await loadConfig6({
     name: "stx",
@@ -9260,6 +9282,7 @@ async function serve(options) {
   let placeholdersAreReady = false;
   const imageWarmupSetting = options.imageWarmup ?? stxConfig.imageWarmup ?? "auto";
   const imageWarmupGraceMs = Math.max(0, options.imageWarmupGraceMs ?? 1000);
+  const imageWarmupBindBudgetMs = resolveImageWarmupBindBudget(options.imageWarmupBindBudgetMs ?? stxConfig.imageWarmupBindBudgetMs);
   function awaitImageWarmup() {
     if (placeholdersAreReady || imageWarmupGraceMs === 0)
       return;
@@ -10387,8 +10410,17 @@ ${block}`;
       markPlaceholdersReady();
     }
   }
-  if (production)
-    await runImageWarmup();
+  if (production) {
+    const warmupStartedAt = performance.now();
+    const warmup = runImageWarmup();
+    const bound = await settleWithin(warmup, imageWarmupBindBudgetMs);
+    if (!bound) {
+      console.warn(`[stx] image warm-up still running after ${formatSeconds(imageWarmupBindBudgetMs)}; binding now and finishing it in the background. Images fall back to the original files until it completes. A cold image cache (first deploy, a cleared STX_IMAGE_CACHE_DIR, an encoder upgrade) is the usual cause; the next start reuses what this one encodes.`);
+      warmup.then(() => {
+        console.log(`[stx] image warm-up finished after ${formatSeconds(performance.now() - warmupStartedAt)}`);
+      });
+    }
+  }
   const portAutoIncrement = options.autoIncrementPort ?? true;
   const maxPortAttempts = portAutoIncrement === false ? 1 : typeof portAutoIncrement === "number" ? Math.max(1, portAutoIncrement) : 10;
   let actualPort = port;
@@ -11216,12 +11248,14 @@ export {
   usableErrorPage,
   staticCacheControl,
   sharedScriptCacheControl,
+  settleWithin,
   serverScriptsReadParams,
   serve,
   serializeRouteParams,
   routeSpecificity,
   responseTakesCsrfCookie,
   resolveServeOpenUrl,
+  resolveImageWarmupBindBudget,
   render404Page,
   publicFileExists,
   projectUsesImageBuiltins,
@@ -11241,5 +11275,6 @@ export {
   boundedCache,
   SHARED_SCRIPT_PATH,
   ROUTE_PARAMS_PLACEHOLDER,
+  DEFAULT_IMAGE_WARMUP_BIND_BUDGET_MS,
   CSRF_COOKIE
 };

package/package.json

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