bun-plugin-stx 0.2.616 → 0.2.618

package/dist/serve.d.ts

@@ -239,6 +239,12 @@ export declare function bundleBrowserAsset(entrypoint: string): Promise<Response
  * "forever", since an unbounded wait is the failure the budget exists to stop.
  */
 export declare function resolveImageWarmupBindBudget(value: unknown): number;
+/**
+ * `pageWarmup` from an option or config value. Anything unusable falls back to
+ * the default, and a path that is not a same-origin absolute path is dropped:
+ * the warm-up only ever asks this server for its own pages.
+ */
+export declare function resolvePageWarmup(value: unknown): ResolvedPageWarmup;
 /**
  * Whether `promise` settles within `ms`. It is not cancelled either way: the
  * caller decides what to do with work that is still running.
@@ -285,6 +291,10 @@ export declare const SHARED_SCRIPT_PATH: unknown;
 export declare const MODULE_BUNDLE_PATH: unknown;
 /** Default for `imageWarmupBindBudgetMs`: well inside ts-cloud's 180s bind window. */
 export declare const DEFAULT_IMAGE_WARMUP_BIND_BUDGET_MS: unknown;
+/** The header every page warm-up request carries. */
+export declare const PAGE_WARMUP_HEADER: 'x-stx-warmup';
+/** Default for `pageWarmup.budgetMs`: beside the image budget, inside ts-cloud's 180s bind window. */
+export declare const DEFAULT_PAGE_WARMUP_BUDGET_MS: unknown;
 /**
  * Build the candidate regexes for a dynamic route file (stacksjs/stx#1927).
  *
@@ -347,6 +357,7 @@ export declare interface ServeOptions {
   imageWarmupGraceMs?: number
   imageWarmupBindBudgetMs?: number
   imageWarmup?: boolean | 'auto'
+  pageWarmup?: boolean | PageWarmupOptions
   publicDir?: string
   quiet?: boolean
   autoIncrementPort?: boolean | number
@@ -378,6 +389,17 @@ export declare interface ServeOptions {
     protectedPaths?: string[]
   }
 }
+export declare interface PageWarmupOptions {
+  paths?: string[]
+  budgetMs?: number
+  concurrency?: number
+}
+export declare interface ResolvedPageWarmup {
+  enabled: boolean
+  paths: string[]
+  budgetMs: number
+  concurrency: number
+}
 /**
  * The slice of Css this server calls, taken from the package's own types
  * rather than restated here.