@astroscope/boot 0.5.0 → 0.6.0

package/README.md

@@ -89,45 +89,47 @@ Called when the server is shutting down (SIGTERM in production, server close in
 - Cleaning up resources
 - Graceful shutdown of external services
 
-## V8 Warmup
+## Warmup
 
-The package includes a warmup utility that pre-imports all page modules and middleware to warm up the V8 JIT compiler, reducing cold start latency for the first requests.
+Pre-imports server modules at startup to eliminate cold-start latency on the first request. At build time, a virtual module is generated that statically imports all matched files. At runtime, this module is loaded in parallel with `onStartup`, so warmup doesn't delay server readiness.
+
+### Enable warmup
 
 ```ts
-// src/boot.ts
-import type { BootContext } from "@astroscope/boot";
-import { warmup } from "@astroscope/boot/warmup";
+boot({ warmup: true });
+```
 
-export async function onStartup({ host, port }: BootContext) {
-  const result = await warmup();
+This uses the default glob patterns (`WARMUP_MODULES`) which cover:
 
-  if (result.success.length > 0) {
-    console.log(`Warmed up ${result.success.length} modules in ${result.duration}ms`);
-  }
+- `src/pages/**/*.{astro,ts,tsx,js,jsx,md,mdx}`
+- `src/middleware.{ts,js}` / `src/middleware/index.{ts,js}`
 
-  if (result.failed.length > 0) {
-    console.warn(`Failed to warm up: ${result.failed.join(", ")}`);
-  }
+### Custom patterns
 
-  console.log(`Server ready at ${host}:${port}`);
-}
+Pass an array of glob patterns to control exactly which files are warmed up:
+
+```ts
+import { WARMUP_MODULES } from "@astroscope/boot";
+
+// defaults + custom patterns
+boot({ warmup: [...WARMUP_MODULES, "src/components/**/*.tsx"] });
+
+// only custom patterns (no defaults)
+boot({ warmup: ["src/lib/heavy-module.ts"] });
 ```
 
-### `WarmupResult`
+### Exported constants
+
+The default glob patterns are exported for composition:
 
 ```ts
-interface WarmupResult {
-  /** Modules that were successfully loaded */
-  success: string[];
-  /** Modules that failed to load */
-  failed: string[];
-  /** Time taken in milliseconds */
-  duration: number;
-}
+import {
+  WARMUP_PAGE_MODULES,
+  WARMUP_MIDDLEWARE_MODULES,
+  WARMUP_MODULES,
+} from "@astroscope/boot";
 ```
 
-In development mode, `warmup()` is a no-op that returns empty results. In production, it reads a manifest generated during the build and imports all discovered page modules and middleware in parallel.
-
 ## Options
 
 ### `entry`
@@ -152,14 +154,30 @@ Re-run `onStartup` when the boot file changes during development. This is disabl
 boot({ hmr: true });
 ```
 
+### `warmup`
+
+Pre-import server modules on startup to eliminate cold-start latency.
+
+- **Type**: `boolean | string[]`
+- **Default**: `false`
+
+```ts
+// use default patterns
+boot({ warmup: true });
+
+// custom patterns
+boot({ warmup: [...WARMUP_MODULES, "src/components/**/*.tsx"] });
+```
+
 ## How it works
 
 - **Development**: The boot file runs _after_ the dev server starts listening (Vite limitation). `onShutdown` is called when the dev server closes.
-- **Production**: `onStartup` runs _before_ the server starts handling requests. `onShutdown` is called on SIGTERM.
+- **Production**: `onStartup` runs _before_ the server starts handling requests. `onShutdown` is called on SIGTERM. When warmup is enabled, module pre-loading runs in parallel with `onStartup`.
 
 ## Requirements
 
-- Only works with SSR output mode (`output: "server"`)
+- Node.js runtime
+- SSR output mode (`output: "server"`)
 
 ## License
 

package/dist/events.d.cts

@@ -1,4 +1,4 @@
-import { B as BootContext } from './types-CxpusND2.cjs';
+import { B as BootContext } from './types-Ccbd5qoU.cjs';
 
 type BootEventName = 'beforeOnStartup' | 'afterOnStartup' | 'beforeOnShutdown' | 'afterOnShutdown';
 type BootEventHandler = (context: BootContext) => Promise<void> | void;

package/dist/events.d.ts

@@ -1,4 +1,4 @@
-import { B as BootContext } from './types-CxpusND2.js';
+import { B as BootContext } from './types-Ccbd5qoU.js';
 
 type BootEventName = 'beforeOnStartup' | 'afterOnStartup' | 'beforeOnShutdown' | 'afterOnShutdown';
 type BootEventHandler = (context: BootContext) => Promise<void> | void;

package/dist/index.cjs

@@ -30,6 +30,9 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  WARMUP_MIDDLEWARE_MODULES: () => WARMUP_MIDDLEWARE_MODULES,
+  WARMUP_MODULES: () => WARMUP_MODULES,
+  WARMUP_PAGE_MODULES: () => WARMUP_PAGE_MODULES,
   boot: () => boot,
   default: () => boot,
   prepend: () => prepend
@@ -38,6 +41,7 @@ module.exports = __toCommonJS(index_exports);
 
 // src/integration.ts
 var import_node_fs2 = __toESM(require("fs"), 1);
+var import_node_url = require("url");
 var import_magic_string = __toESM(require("magic-string"), 1);
 var import_vite2 = require("vite");
 
@@ -194,58 +198,30 @@ function getPrependCode() {
   return code;
 }
 
-// src/warmup-manifest.ts
+// src/warmup.ts
 var import_node_fs = __toESM(require("fs"), 1);
 var import_node_path2 = __toESM(require("path"), 1);
-var WARMUP_MANIFEST_FILE = "warmup-manifest.json";
-var MIDDLEWARE_VIRTUAL_ID = "\0virtual:astro:middleware";
-function collectWarmupModules(bundle) {
-  const pageModules = [];
-  let middlewarePath = null;
-  for (const [fileName, chunk] of Object.entries(bundle)) {
-    if (chunk.type === "chunk" && chunk.facadeModuleId === MIDDLEWARE_VIRTUAL_ID) {
-      middlewarePath = fileName;
-      break;
+var WARMUP_PAGE_MODULES = ["src/pages/**/*.{astro,ts,tsx,js,jsx,md,mdx}"];
+var WARMUP_MIDDLEWARE_MODULES = ["src/middleware.{ts,js}", "src/middleware/index.{ts,js}"];
+var WARMUP_MODULES = [...WARMUP_PAGE_MODULES, ...WARMUP_MIDDLEWARE_MODULES];
+var VIRTUAL_MODULE_ID = "virtual:@astroscope/boot/warmup";
+var RESOLVED_VIRTUAL_MODULE_ID = `\0${VIRTUAL_MODULE_ID}`;
+async function resolveWarmupFiles(patterns, projectRoot) {
+  const files = [];
+  for (const pattern of patterns) {
+    for await (const entry of import_node_fs.default.promises.glob(pattern, {
+      cwd: projectRoot,
+      exclude: (name) => name === "node_modules"
+    })) {
+      files.push(import_node_path2.default.resolve(projectRoot, entry));
     }
   }
-  const entryChunk = bundle["entry.mjs"];
-  if (entryChunk?.type !== "chunk") {
-    return { pageModules, middlewarePath };
-  }
-  let serverChunk = null;
-  for (const imp of entryChunk.imports) {
-    const chunk = bundle[imp];
-    if (chunk?.type !== "chunk") continue;
-    if (!serverChunk || chunk.dynamicImports.length > serverChunk.dynamicImports.length) {
-      serverChunk = chunk;
-    }
-  }
-  if (serverChunk) {
-    const skip = /* @__PURE__ */ new Set([middlewarePath]);
-    for (const dynImport of serverChunk.dynamicImports) {
-      if (skip.has(dynImport)) continue;
-      const chunk = bundle[dynImport];
-      if (chunk?.type !== "chunk") continue;
-      const facadeId = chunk.facadeModuleId ?? "";
-      if (facadeId.includes("noop-") || facadeId.includes("virtual:astro:server-island") || facadeId.includes("virtual:astro:session")) {
-        continue;
-      }
-      pageModules.push(dynImport);
-    }
-  }
-  return { pageModules, middlewarePath };
+  return [...new Set(files)];
 }
-function writeWarmupManifest(outDir, { pageModules, middlewarePath }, logger) {
-  const modules = [];
-  if (middlewarePath) {
-    modules.push(`./${middlewarePath}`);
-  }
-  for (const page of pageModules) {
-    modules.push(`./${page}`);
-  }
-  const manifestPath = import_node_path2.default.join(outDir, "chunks", WARMUP_MANIFEST_FILE);
-  import_node_fs.default.writeFileSync(manifestPath, JSON.stringify({ modules }));
-  logger.info(`generated warmup for ${pageModules.length} pages`);
+function generateWarmupCode(files) {
+  if (files.length === 0) return "";
+  return `${files.map((f) => `import ${JSON.stringify(f)};`).join("\n")}
+`;
 }
 
 // src/integration.ts
@@ -269,12 +245,20 @@ function getBootContext(server, config) {
   const { host, port } = getServerDefaults(config);
   return { dev: true, host, port };
 }
-var getState = (0, import_vite2.perEnvironmentState)(() => ({ bootChunkRef: null, warmupModules: null }));
+function resolveWarmupPatterns(warmup) {
+  if (!warmup) return null;
+  if (Array.isArray(warmup)) {
+    return warmup;
+  }
+  return WARMUP_MODULES;
+}
+var getState = (0, import_vite2.perEnvironmentState)(() => ({ bootChunkRef: null, warmupChunkRef: null }));
 function boot(options = {}) {
   const entry = resolveEntry(options.entry);
   const hmr = options.hmr ?? false;
-  const enableWarmup = options.warmup ?? false;
+  const warmupPatterns = resolveWarmupPatterns(options.warmup);
   let astroConfig = null;
+  let warmupCode = null;
   return {
     name: "@astroscope/boot",
     hooks: {
@@ -283,16 +267,38 @@ function boot(options = {}) {
         updateConfig({
           vite: {
             plugins: [
-              // build plugin: handles entry.mjs injection, warmup manifest
+              // build plugin: handles entry.mjs injection and warmup virtual module
               {
                 name: "@astroscope/boot",
-                buildStart() {
+                resolveId(id) {
+                  if (id === VIRTUAL_MODULE_ID) return RESOLVED_VIRTUAL_MODULE_ID;
+                },
+                load(id) {
+                  if (id === RESOLVED_VIRTUAL_MODULE_ID) return warmupCode ?? "";
+                },
+                async buildStart() {
                   if (this.environment.name !== "ssr") return;
                   const state = getState(this);
                   try {
                     state.bootChunkRef = this.emitFile({ type: "chunk", id: entry, name: "boot" });
                   } catch {
                   }
+                  if (warmupPatterns) {
+                    const projectRoot = astroConfig?.root ? (0, import_node_url.fileURLToPath)(astroConfig.root) : process.cwd();
+                    const files = await resolveWarmupFiles(warmupPatterns, projectRoot);
+                    warmupCode = generateWarmupCode(files);
+                    if (files.length > 0) {
+                      try {
+                        state.warmupChunkRef = this.emitFile({
+                          type: "chunk",
+                          id: VIRTUAL_MODULE_ID,
+                          name: "warmup"
+                        });
+                      } catch {
+                      }
+                      logger.info(`warmup: ${files.length} files`);
+                    }
+                  }
                 },
                 generateBundle(_, bundle) {
                   const state = getState(this);
@@ -307,18 +313,26 @@ function boot(options = {}) {
                     logger.warn("entry.mjs not found - boot injection skipped");
                     return;
                   }
-                  if (enableWarmup) {
-                    state.warmupModules = collectWarmupModules(bundle);
-                  }
                   const { host, port } = getServerDefaults(astroConfig);
                   const prependCode = getPrependCode();
                   const prefix = prependCode.length ? `${prependCode.join("\n")}
 ` : "";
-                  const injection = `${prefix}globalThis.__astroscope_server_url = import.meta.url;
-import * as __astroscope_boot from './${bootChunkName}';
-import { setup as __astroscope_bootSetup } from '@astroscope/boot/setup';
-await __astroscope_bootSetup(__astroscope_boot, ${JSON.stringify({ host, port, warmup: enableWarmup })});
+                  let warmupStart = "";
+                  let warmupEnd = "";
+                  if (state.warmupChunkRef) {
+                    const warmupChunkName = this.getFileName(state.warmupChunkRef);
+                    if (warmupChunkName) {
+                      warmupStart = `const __astroscope_warmup = import('./${warmupChunkName}');
+`;
+                      warmupEnd = `await __astroscope_warmup;
 `;
+                    }
+                  }
+                  const setupConfig = JSON.stringify({ host, port });
+                  const injection = `${prefix}${warmupStart}import * as __astroscope_boot from './${bootChunkName}';
+import { setup as __astroscope_bootSetup } from '@astroscope/boot/setup';
+await __astroscope_bootSetup(__astroscope_boot, ${setupConfig});
+${warmupEnd}`;
                   const s = new import_magic_string.default(entryChunk.code);
                   s.prepend(injection);
                   entryChunk.code = s.toString();
@@ -326,13 +340,6 @@ await __astroscope_bootSetup(__astroscope_boot, ${JSON.stringify({ host, port, w
                     entryChunk.map = s.generateMap({ hires: true });
                   }
                   logger.info(`injected ${bootChunkName} into entry.mjs`);
-                },
-                writeBundle(outputOptions) {
-                  const state = getState(this);
-                  if (!state.warmupModules) return;
-                  const outDir = outputOptions.dir;
-                  if (!outDir) return;
-                  writeWarmupManifest(outDir, state.warmupModules, logger);
                 }
               },
               // startup plugin: runs after all other configureServer hooks
@@ -371,6 +378,9 @@ await __astroscope_bootSetup(__astroscope_boot, ${JSON.stringify({ host, port, w
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  WARMUP_MIDDLEWARE_MODULES,
+  WARMUP_MODULES,
+  WARMUP_PAGE_MODULES,
   boot,
   prepend
 });

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import { AstroIntegration } from 'astro';
-export { B as BootContext, W as WarmupResult } from './types-CxpusND2.cjs';
+export { B as BootContext } from './types-Ccbd5qoU.cjs';
 export { BootEventHandler, BootEventName } from './events.cjs';
 export { prepend } from './prepend.cjs';
 
@@ -15,12 +15,14 @@ interface BootOptions {
      */
     hmr?: boolean | undefined;
     /**
-     * Pre-import all page modules and middleware on startup to eliminate cold-start latency
-     * on first request. When enabled, a warmup manifest is generated at build time and all
-     * discovered modules are imported before `onStartup` runs.
+     * Pre-import all page modules and middleware on startup to eliminate cold-start latency.
+     *
+     * - `true` — warmup using default glob patterns ({@link WARMUP_MODULES})
+     * - `string[]` — custom glob patterns (use `{@link WARMUP_MODULES}` to include defaults)
+     *
      * @default false
      */
-    warmup?: boolean | undefined;
+    warmup?: boolean | string[] | undefined;
 }
 /**
  * Astro integration for application lifecycle hooks.
@@ -30,4 +32,14 @@ interface BootOptions {
  */
 declare function boot(options?: BootOptions): AstroIntegration;
 
-export { type BootOptions, boot, boot as default };
+/**
+ * Default warmup glob patterns covering Astro pages and middleware.
+ */
+declare const WARMUP_PAGE_MODULES: string[];
+declare const WARMUP_MIDDLEWARE_MODULES: string[];
+/**
+ * All default warmup glob patterns.
+ */
+declare const WARMUP_MODULES: string[];
+
+export { type BootOptions, WARMUP_MIDDLEWARE_MODULES, WARMUP_MODULES, WARMUP_PAGE_MODULES, boot, boot as default };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { AstroIntegration } from 'astro';
-export { B as BootContext, W as WarmupResult } from './types-CxpusND2.js';
+export { B as BootContext } from './types-Ccbd5qoU.js';
 export { BootEventHandler, BootEventName } from './events.js';
 export { prepend } from './prepend.js';
 
@@ -15,12 +15,14 @@ interface BootOptions {
      */
     hmr?: boolean | undefined;
     /**
-     * Pre-import all page modules and middleware on startup to eliminate cold-start latency
-     * on first request. When enabled, a warmup manifest is generated at build time and all
-     * discovered modules are imported before `onStartup` runs.
+     * Pre-import all page modules and middleware on startup to eliminate cold-start latency.
+     *
+     * - `true` — warmup using default glob patterns ({@link WARMUP_MODULES})
+     * - `string[]` — custom glob patterns (use `{@link WARMUP_MODULES}` to include defaults)
+     *
      * @default false
      */
-    warmup?: boolean | undefined;
+    warmup?: boolean | string[] | undefined;
 }
 /**
  * Astro integration for application lifecycle hooks.
@@ -30,4 +32,14 @@ interface BootOptions {
  */
 declare function boot(options?: BootOptions): AstroIntegration;
 
-export { type BootOptions, boot, boot as default };
+/**
+ * Default warmup glob patterns covering Astro pages and middleware.
+ */
+declare const WARMUP_PAGE_MODULES: string[];
+declare const WARMUP_MIDDLEWARE_MODULES: string[];
+/**
+ * All default warmup glob patterns.
+ */
+declare const WARMUP_MODULES: string[];
+
+export { type BootOptions, WARMUP_MIDDLEWARE_MODULES, WARMUP_MODULES, WARMUP_PAGE_MODULES, boot, boot as default };

package/dist/index.js

@@ -10,6 +10,7 @@ import "./chunk-I62ZQYTP.js";
 
 // src/integration.ts
 import fs2 from "fs";
+import { fileURLToPath } from "url";
 import MagicString from "magic-string";
 import { perEnvironmentState } from "vite";
 
@@ -124,58 +125,30 @@ function setupBootHmr(server, entry, logger, getBootContext2) {
   });
 }
 
-// src/warmup-manifest.ts
+// src/warmup.ts
 import fs from "fs";
 import path2 from "path";
-var WARMUP_MANIFEST_FILE = "warmup-manifest.json";
-var MIDDLEWARE_VIRTUAL_ID = "\0virtual:astro:middleware";
-function collectWarmupModules(bundle) {
-  const pageModules = [];
-  let middlewarePath = null;
-  for (const [fileName, chunk] of Object.entries(bundle)) {
-    if (chunk.type === "chunk" && chunk.facadeModuleId === MIDDLEWARE_VIRTUAL_ID) {
-      middlewarePath = fileName;
-      break;
+var WARMUP_PAGE_MODULES = ["src/pages/**/*.{astro,ts,tsx,js,jsx,md,mdx}"];
+var WARMUP_MIDDLEWARE_MODULES = ["src/middleware.{ts,js}", "src/middleware/index.{ts,js}"];
+var WARMUP_MODULES = [...WARMUP_PAGE_MODULES, ...WARMUP_MIDDLEWARE_MODULES];
+var VIRTUAL_MODULE_ID = "virtual:@astroscope/boot/warmup";
+var RESOLVED_VIRTUAL_MODULE_ID = `\0${VIRTUAL_MODULE_ID}`;
+async function resolveWarmupFiles(patterns, projectRoot) {
+  const files = [];
+  for (const pattern of patterns) {
+    for await (const entry of fs.promises.glob(pattern, {
+      cwd: projectRoot,
+      exclude: (name) => name === "node_modules"
+    })) {
+      files.push(path2.resolve(projectRoot, entry));
     }
   }
-  const entryChunk = bundle["entry.mjs"];
-  if (entryChunk?.type !== "chunk") {
-    return { pageModules, middlewarePath };
-  }
-  let serverChunk = null;
-  for (const imp of entryChunk.imports) {
-    const chunk = bundle[imp];
-    if (chunk?.type !== "chunk") continue;
-    if (!serverChunk || chunk.dynamicImports.length > serverChunk.dynamicImports.length) {
-      serverChunk = chunk;
-    }
-  }
-  if (serverChunk) {
-    const skip = /* @__PURE__ */ new Set([middlewarePath]);
-    for (const dynImport of serverChunk.dynamicImports) {
-      if (skip.has(dynImport)) continue;
-      const chunk = bundle[dynImport];
-      if (chunk?.type !== "chunk") continue;
-      const facadeId = chunk.facadeModuleId ?? "";
-      if (facadeId.includes("noop-") || facadeId.includes("virtual:astro:server-island") || facadeId.includes("virtual:astro:session")) {
-        continue;
-      }
-      pageModules.push(dynImport);
-    }
-  }
-  return { pageModules, middlewarePath };
+  return [...new Set(files)];
 }
-function writeWarmupManifest(outDir, { pageModules, middlewarePath }, logger) {
-  const modules = [];
-  if (middlewarePath) {
-    modules.push(`./${middlewarePath}`);
-  }
-  for (const page of pageModules) {
-    modules.push(`./${page}`);
-  }
-  const manifestPath = path2.join(outDir, "chunks", WARMUP_MANIFEST_FILE);
-  fs.writeFileSync(manifestPath, JSON.stringify({ modules }));
-  logger.info(`generated warmup for ${pageModules.length} pages`);
+function generateWarmupCode(files) {
+  if (files.length === 0) return "";
+  return `${files.map((f) => `import ${JSON.stringify(f)};`).join("\n")}
+`;
 }
 
 // src/integration.ts
@@ -199,12 +172,20 @@ function getBootContext(server, config) {
   const { host, port } = getServerDefaults(config);
   return { dev: true, host, port };
 }
-var getState = perEnvironmentState(() => ({ bootChunkRef: null, warmupModules: null }));
+function resolveWarmupPatterns(warmup) {
+  if (!warmup) return null;
+  if (Array.isArray(warmup)) {
+    return warmup;
+  }
+  return WARMUP_MODULES;
+}
+var getState = perEnvironmentState(() => ({ bootChunkRef: null, warmupChunkRef: null }));
 function boot(options = {}) {
   const entry = resolveEntry(options.entry);
   const hmr = options.hmr ?? false;
-  const enableWarmup = options.warmup ?? false;
+  const warmupPatterns = resolveWarmupPatterns(options.warmup);
   let astroConfig = null;
+  let warmupCode = null;
   return {
     name: "@astroscope/boot",
     hooks: {
@@ -213,16 +194,38 @@ function boot(options = {}) {
         updateConfig({
           vite: {
             plugins: [
-              // build plugin: handles entry.mjs injection, warmup manifest
+              // build plugin: handles entry.mjs injection and warmup virtual module
               {
                 name: "@astroscope/boot",
-                buildStart() {
+                resolveId(id) {
+                  if (id === VIRTUAL_MODULE_ID) return RESOLVED_VIRTUAL_MODULE_ID;
+                },
+                load(id) {
+                  if (id === RESOLVED_VIRTUAL_MODULE_ID) return warmupCode ?? "";
+                },
+                async buildStart() {
                   if (this.environment.name !== "ssr") return;
                   const state = getState(this);
                   try {
                     state.bootChunkRef = this.emitFile({ type: "chunk", id: entry, name: "boot" });
                   } catch {
                   }
+                  if (warmupPatterns) {
+                    const projectRoot = astroConfig?.root ? fileURLToPath(astroConfig.root) : process.cwd();
+                    const files = await resolveWarmupFiles(warmupPatterns, projectRoot);
+                    warmupCode = generateWarmupCode(files);
+                    if (files.length > 0) {
+                      try {
+                        state.warmupChunkRef = this.emitFile({
+                          type: "chunk",
+                          id: VIRTUAL_MODULE_ID,
+                          name: "warmup"
+                        });
+                      } catch {
+                      }
+                      logger.info(`warmup: ${files.length} files`);
+                    }
+                  }
                 },
                 generateBundle(_, bundle) {
                   const state = getState(this);
@@ -237,18 +240,26 @@ function boot(options = {}) {
                     logger.warn("entry.mjs not found - boot injection skipped");
                     return;
                   }
-                  if (enableWarmup) {
-                    state.warmupModules = collectWarmupModules(bundle);
-                  }
                   const { host, port } = getServerDefaults(astroConfig);
                   const prependCode = getPrependCode();
                   const prefix = prependCode.length ? `${prependCode.join("\n")}
 ` : "";
-                  const injection = `${prefix}globalThis.__astroscope_server_url = import.meta.url;
-import * as __astroscope_boot from './${bootChunkName}';
-import { setup as __astroscope_bootSetup } from '@astroscope/boot/setup';
-await __astroscope_bootSetup(__astroscope_boot, ${JSON.stringify({ host, port, warmup: enableWarmup })});
+                  let warmupStart = "";
+                  let warmupEnd = "";
+                  if (state.warmupChunkRef) {
+                    const warmupChunkName = this.getFileName(state.warmupChunkRef);
+                    if (warmupChunkName) {
+                      warmupStart = `const __astroscope_warmup = import('./${warmupChunkName}');
+`;
+                      warmupEnd = `await __astroscope_warmup;
 `;
+                    }
+                  }
+                  const setupConfig = JSON.stringify({ host, port });
+                  const injection = `${prefix}${warmupStart}import * as __astroscope_boot from './${bootChunkName}';
+import { setup as __astroscope_bootSetup } from '@astroscope/boot/setup';
+await __astroscope_bootSetup(__astroscope_boot, ${setupConfig});
+${warmupEnd}`;
                   const s = new MagicString(entryChunk.code);
                   s.prepend(injection);
                   entryChunk.code = s.toString();
@@ -256,13 +267,6 @@ await __astroscope_bootSetup(__astroscope_boot, ${JSON.stringify({ host, port, w
                     entryChunk.map = s.generateMap({ hires: true });
                   }
                   logger.info(`injected ${bootChunkName} into entry.mjs`);
-                },
-                writeBundle(outputOptions) {
-                  const state = getState(this);
-                  if (!state.warmupModules) return;
-                  const outDir = outputOptions.dir;
-                  if (!outDir) return;
-                  writeWarmupManifest(outDir, state.warmupModules, logger);
                 }
               },
               // startup plugin: runs after all other configureServer hooks
@@ -300,6 +304,9 @@ await __astroscope_bootSetup(__astroscope_boot, ${JSON.stringify({ host, port, w
   };
 }
 export {
+  WARMUP_MIDDLEWARE_MODULES,
+  WARMUP_MODULES,
+  WARMUP_PAGE_MODULES,
   boot,
   boot as default,
   prepend

package/dist/lifecycle.d.cts

@@ -1,4 +1,4 @@
-import { B as BootContext } from './types-CxpusND2.cjs';
+import { B as BootContext } from './types-Ccbd5qoU.cjs';
 
 interface BootModule {
     onStartup?: ((context: BootContext) => Promise<void> | void) | undefined;

package/dist/lifecycle.d.ts

@@ -1,4 +1,4 @@
-import { B as BootContext } from './types-CxpusND2.js';
+import { B as BootContext } from './types-Ccbd5qoU.js';
 
 interface BootModule {
     onStartup?: ((context: BootContext) => Promise<void> | void) | undefined;

package/dist/setup.cjs

@@ -57,61 +57,6 @@ async function runShutdown(boot, context) {
   }
 }
 
-// src/warmup.ts
-var import_node_fs = require("fs");
-var import_node_path = require("path");
-var import_node_url = require("url");
-var import_meta = {};
-var WARMUP_MANIFEST_FILE = "warmup-manifest.json";
-function isDevMode() {
-  return Boolean(import_meta.env?.["DEV"]);
-}
-function loadManifest() {
-  if (isDevMode()) {
-    return null;
-  }
-  const serverUrl = globalThis.__astroscope_server_url;
-  if (!serverUrl) {
-    return null;
-  }
-  const serverDir = (0, import_node_path.dirname)((0, import_node_url.fileURLToPath)(serverUrl));
-  const manifestPath = (0, import_node_path.join)(serverDir, "chunks", WARMUP_MANIFEST_FILE);
-  if (!(0, import_node_fs.existsSync)(manifestPath)) {
-    return null;
-  }
-  const manifest = JSON.parse((0, import_node_fs.readFileSync)(manifestPath, "utf-8"));
-  return {
-    modules: manifest.modules ?? [],
-    serverDir
-  };
-}
-async function warmup() {
-  const manifest = loadManifest();
-  if (!manifest || manifest.modules.length === 0) {
-    return { success: [], failed: [], duration: 0 };
-  }
-  const { modules, serverDir } = manifest;
-  const start = Date.now();
-  const resolvedModules = modules.map((mod) => {
-    const absolutePath = (0, import_node_path.resolve)(serverDir, mod);
-    return (0, import_node_url.pathToFileURL)(absolutePath).href;
-  });
-  const results = await Promise.allSettled(resolvedModules.map((mod) => import(
-    /* @vite-ignore */
-    mod
-  )));
-  const success = [];
-  const failed = [];
-  for (let i = 0; i < results.length; i++) {
-    if (results[i].status === "fulfilled") {
-      success.push(modules[i]);
-    } else {
-      failed.push(modules[i]);
-    }
-  }
-  return { success, failed, duration: Date.now() - start };
-}
-
 // src/setup.ts
 async function setup(boot, config) {
   const context = {
@@ -120,16 +65,7 @@ async function setup(boot, config) {
     port: process.env["PORT"] ? Number(process.env["PORT"]) : config.port
   };
   try {
-    const warmupPromise = config.warmup ? warmup().then((result) => {
-      if (result.success.length > 0) {
-        console.log(`[boot] warmed up ${result.success.length} modules in ${result.duration}ms`);
-      }
-      if (result.failed.length > 0) {
-        console.warn(`[boot] failed to warm up ${result.failed.length} modules`);
-      }
-    }) : void 0;
     await runStartup(boot, context);
-    await warmupPromise;
   } catch (err) {
     console.error("[boot] startup failed:", err);
     try {

package/dist/setup.d.cts

@@ -1,10 +1,9 @@
 import { BootModule } from './lifecycle.cjs';
-import './types-CxpusND2.cjs';
+import './types-Ccbd5qoU.cjs';
 
 declare function setup(boot: BootModule, config: {
     host: string;
     port: number;
-    warmup?: boolean | undefined;
 }): Promise<void>;
 
 export { setup };

package/dist/setup.d.ts

@@ -1,10 +1,9 @@
 import { BootModule } from './lifecycle.js';
-import './types-CxpusND2.js';
+import './types-Ccbd5qoU.js';
 
 declare function setup(boot: BootModule, config: {
     host: string;
     port: number;
-    warmup?: boolean | undefined;
 }): Promise<void>;
 
 export { setup };

package/dist/setup.js

@@ -3,9 +3,6 @@ import {
   runStartup
 } from "./chunk-LUFQ5I47.js";
 import "./chunk-I62ZQYTP.js";
-import {
-  warmup
-} from "./chunk-SXYYPF3C.js";
 
 // src/setup.ts
 async function setup(boot, config) {
@@ -15,16 +12,7 @@ async function setup(boot, config) {
     port: process.env["PORT"] ? Number(process.env["PORT"]) : config.port
   };
   try {
-    const warmupPromise = config.warmup ? warmup().then((result) => {
-      if (result.success.length > 0) {
-        console.log(`[boot] warmed up ${result.success.length} modules in ${result.duration}ms`);
-      }
-      if (result.failed.length > 0) {
-        console.warn(`[boot] failed to warm up ${result.failed.length} modules`);
-      }
-    }) : void 0;
     await runStartup(boot, context);
-    await warmupPromise;
   } catch (err) {
     console.error("[boot] startup failed:", err);
     try {

package/dist/types-Ccbd5qoU.d.cts

@@ -0,0 +1,10 @@
+interface BootContext {
+    /** Whether running in development mode (vite dev server) */
+    dev: boolean;
+    /** Server host from Astro config */
+    host: string;
+    /** Server port from Astro config */
+    port: number;
+}
+
+export type { BootContext as B };

package/dist/types-Ccbd5qoU.d.ts

@@ -0,0 +1,10 @@
+interface BootContext {
+    /** Whether running in development mode (vite dev server) */
+    dev: boolean;
+    /** Server host from Astro config */
+    host: string;
+    /** Server port from Astro config */
+    port: number;
+}
+
+export type { BootContext as B };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astroscope/boot",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Startup and graceful shutdown hooks for Astro SSR",
   "type": "module",
   "main": "./dist/index.js",
@@ -11,10 +11,6 @@
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
     },
-    "./warmup": {
-      "types": "./dist/warmup.d.ts",
-      "import": "./dist/warmup.js"
-    },
     "./events": {
       "types": "./dist/events.d.ts",
       "import": "./dist/events.js"
@@ -65,7 +61,7 @@
     "magic-string": "^0.30.21"
   },
   "scripts": {
-    "build": "tsup src/index.ts src/warmup.ts src/events.ts src/lifecycle.ts src/setup.ts src/prepend.ts --format esm,cjs --dts",
+    "build": "tsup src/index.ts src/events.ts src/lifecycle.ts src/setup.ts src/prepend.ts --format esm,cjs --dts",
     "typecheck": "tsc --noEmit",
     "lint": "eslint src",
     "lint:fix": "eslint src --fix"

package/dist/chunk-SXYYPF3C.js

@@ -1,57 +0,0 @@
-// src/warmup.ts
-import { existsSync, readFileSync } from "fs";
-import { dirname, join, resolve } from "path";
-import { fileURLToPath, pathToFileURL } from "url";
-var WARMUP_MANIFEST_FILE = "warmup-manifest.json";
-function isDevMode() {
-  return Boolean(import.meta.env?.["DEV"]);
-}
-function loadManifest() {
-  if (isDevMode()) {
-    return null;
-  }
-  const serverUrl = globalThis.__astroscope_server_url;
-  if (!serverUrl) {
-    return null;
-  }
-  const serverDir = dirname(fileURLToPath(serverUrl));
-  const manifestPath = join(serverDir, "chunks", WARMUP_MANIFEST_FILE);
-  if (!existsSync(manifestPath)) {
-    return null;
-  }
-  const manifest = JSON.parse(readFileSync(manifestPath, "utf-8"));
-  return {
-    modules: manifest.modules ?? [],
-    serverDir
-  };
-}
-async function warmup() {
-  const manifest = loadManifest();
-  if (!manifest || manifest.modules.length === 0) {
-    return { success: [], failed: [], duration: 0 };
-  }
-  const { modules, serverDir } = manifest;
-  const start = Date.now();
-  const resolvedModules = modules.map((mod) => {
-    const absolutePath = resolve(serverDir, mod);
-    return pathToFileURL(absolutePath).href;
-  });
-  const results = await Promise.allSettled(resolvedModules.map((mod) => import(
-    /* @vite-ignore */
-    mod
-  )));
-  const success = [];
-  const failed = [];
-  for (let i = 0; i < results.length; i++) {
-    if (results[i].status === "fulfilled") {
-      success.push(modules[i]);
-    } else {
-      failed.push(modules[i]);
-    }
-  }
-  return { success, failed, duration: Date.now() - start };
-}
-
-export {
-  warmup
-};

package/dist/types-CxpusND2.d.cts

@@ -1,18 +0,0 @@
-interface BootContext {
-    /** Whether running in development mode (vite dev server) */
-    dev: boolean;
-    /** Server host from Astro config */
-    host: string;
-    /** Server port from Astro config */
-    port: number;
-}
-interface WarmupResult {
-    /** Modules that were successfully loaded */
-    success: string[];
-    /** Modules that failed to load */
-    failed: string[];
-    /** Time taken in milliseconds */
-    duration: number;
-}
-
-export type { BootContext as B, WarmupResult as W };

package/dist/types-CxpusND2.d.ts

@@ -1,18 +0,0 @@
-interface BootContext {
-    /** Whether running in development mode (vite dev server) */
-    dev: boolean;
-    /** Server host from Astro config */
-    host: string;
-    /** Server port from Astro config */
-    port: number;
-}
-interface WarmupResult {
-    /** Modules that were successfully loaded */
-    success: string[];
-    /** Modules that failed to load */
-    failed: string[];
-    /** Time taken in milliseconds */
-    duration: number;
-}
-
-export type { BootContext as B, WarmupResult as W };

package/dist/warmup.cjs

@@ -1,82 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/warmup.ts
-var warmup_exports = {};
-__export(warmup_exports, {
-  warmup: () => warmup
-});
-module.exports = __toCommonJS(warmup_exports);
-var import_node_fs = require("fs");
-var import_node_path = require("path");
-var import_node_url = require("url");
-var import_meta = {};
-var WARMUP_MANIFEST_FILE = "warmup-manifest.json";
-function isDevMode() {
-  return Boolean(import_meta.env?.["DEV"]);
-}
-function loadManifest() {
-  if (isDevMode()) {
-    return null;
-  }
-  const serverUrl = globalThis.__astroscope_server_url;
-  if (!serverUrl) {
-    return null;
-  }
-  const serverDir = (0, import_node_path.dirname)((0, import_node_url.fileURLToPath)(serverUrl));
-  const manifestPath = (0, import_node_path.join)(serverDir, "chunks", WARMUP_MANIFEST_FILE);
-  if (!(0, import_node_fs.existsSync)(manifestPath)) {
-    return null;
-  }
-  const manifest = JSON.parse((0, import_node_fs.readFileSync)(manifestPath, "utf-8"));
-  return {
-    modules: manifest.modules ?? [],
-    serverDir
-  };
-}
-async function warmup() {
-  const manifest = loadManifest();
-  if (!manifest || manifest.modules.length === 0) {
-    return { success: [], failed: [], duration: 0 };
-  }
-  const { modules, serverDir } = manifest;
-  const start = Date.now();
-  const resolvedModules = modules.map((mod) => {
-    const absolutePath = (0, import_node_path.resolve)(serverDir, mod);
-    return (0, import_node_url.pathToFileURL)(absolutePath).href;
-  });
-  const results = await Promise.allSettled(resolvedModules.map((mod) => import(
-    /* @vite-ignore */
-    mod
-  )));
-  const success = [];
-  const failed = [];
-  for (let i = 0; i < results.length; i++) {
-    if (results[i].status === "fulfilled") {
-      success.push(modules[i]);
-    } else {
-      failed.push(modules[i]);
-    }
-  }
-  return { success, failed, duration: Date.now() - start };
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  warmup
-});

package/dist/warmup.d.cts

@@ -1,22 +0,0 @@
-import { W as WarmupResult } from './types-CxpusND2.cjs';
-
-declare global {
-    var __astroscope_server_url: string | undefined;
-}
-/**
- * Warms up V8 by importing all page modules and middleware.
- *
- * In development mode, this is a no-op that returns empty results.
- * In production, reads the warmup manifest and imports all discovered modules.
- *
- * @example
- * ```ts
- * import { warmup } from '@astroscope/boot/warmup';
- *
- * const result = await warmup();
- * console.log(`warmed up ${result.success.length} modules`);
- * ```
- */
-declare function warmup(): Promise<WarmupResult>;
-
-export { WarmupResult, warmup };

package/dist/warmup.d.ts

@@ -1,22 +0,0 @@
-import { W as WarmupResult } from './types-CxpusND2.js';
-
-declare global {
-    var __astroscope_server_url: string | undefined;
-}
-/**
- * Warms up V8 by importing all page modules and middleware.
- *
- * In development mode, this is a no-op that returns empty results.
- * In production, reads the warmup manifest and imports all discovered modules.
- *
- * @example
- * ```ts
- * import { warmup } from '@astroscope/boot/warmup';
- *
- * const result = await warmup();
- * console.log(`warmed up ${result.success.length} modules`);
- * ```
- */
-declare function warmup(): Promise<WarmupResult>;
-
-export { WarmupResult, warmup };

package/dist/warmup.js

@@ -1,6 +0,0 @@
-import {
-  warmup
-} from "./chunk-SXYYPF3C.js";
-export {
-  warmup
-};