@astroscope/boot 0.4.0 → 0.5.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-2026 Simon Bobrov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/chunk-SXYYPF3C.js

@@ -0,0 +1,57 @@
+// 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/index.cjs

@@ -198,16 +198,39 @@ function getPrependCode() {
 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") continue;
-    if (fileName.startsWith("pages/") && fileName.endsWith(".mjs")) {
-      pageModules.push(fileName);
-    }
-    if (fileName.includes("_astro-internal_middleware") || fileName.includes("_noop-middleware")) {
+    if (chunk.type === "chunk" && chunk.facadeModuleId === MIDDLEWARE_VIRTUAL_ID) {
       middlewarePath = fileName;
+      break;
+    }
+  }
+  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 };
@@ -250,6 +273,7 @@ var getState = (0, import_vite2.perEnvironmentState)(() => ({ bootChunkRef: null
 function boot(options = {}) {
   const entry = resolveEntry(options.entry);
   const hmr = options.hmr ?? false;
+  const enableWarmup = options.warmup ?? false;
   let astroConfig = null;
   return {
     name: "@astroscope/boot",
@@ -283,7 +307,9 @@ function boot(options = {}) {
                     logger.warn("entry.mjs not found - boot injection skipped");
                     return;
                   }
-                  state.warmupModules = collectWarmupModules(bundle);
+                  if (enableWarmup) {
+                    state.warmupModules = collectWarmupModules(bundle);
+                  }
                   const { host, port } = getServerDefaults(astroConfig);
                   const prependCode = getPrependCode();
                   const prefix = prependCode.length ? `${prependCode.join("\n")}
@@ -291,7 +317,7 @@ function boot(options = {}) {
                   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 })});
+await __astroscope_bootSetup(__astroscope_boot, ${JSON.stringify({ host, port, warmup: enableWarmup })});
 `;
                   const s = new import_magic_string.default(entryChunk.code);
                   s.prepend(injection);

package/dist/index.d.cts

@@ -14,6 +14,13 @@ interface BootOptions {
      * @default false
      */
     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.
+     * @default false
+     */
+    warmup?: boolean | undefined;
 }
 /**
  * Astro integration for application lifecycle hooks.

package/dist/index.d.ts

@@ -14,6 +14,13 @@ interface BootOptions {
      * @default false
      */
     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.
+     * @default false
+     */
+    warmup?: boolean | undefined;
 }
 /**
  * Astro integration for application lifecycle hooks.

package/dist/index.js

@@ -128,16 +128,39 @@ function setupBootHmr(server, entry, logger, getBootContext2) {
 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") continue;
-    if (fileName.startsWith("pages/") && fileName.endsWith(".mjs")) {
-      pageModules.push(fileName);
-    }
-    if (fileName.includes("_astro-internal_middleware") || fileName.includes("_noop-middleware")) {
+    if (chunk.type === "chunk" && chunk.facadeModuleId === MIDDLEWARE_VIRTUAL_ID) {
       middlewarePath = fileName;
+      break;
+    }
+  }
+  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 };
@@ -180,6 +203,7 @@ var getState = perEnvironmentState(() => ({ bootChunkRef: null, warmupModules: n
 function boot(options = {}) {
   const entry = resolveEntry(options.entry);
   const hmr = options.hmr ?? false;
+  const enableWarmup = options.warmup ?? false;
   let astroConfig = null;
   return {
     name: "@astroscope/boot",
@@ -213,7 +237,9 @@ function boot(options = {}) {
                     logger.warn("entry.mjs not found - boot injection skipped");
                     return;
                   }
-                  state.warmupModules = collectWarmupModules(bundle);
+                  if (enableWarmup) {
+                    state.warmupModules = collectWarmupModules(bundle);
+                  }
                   const { host, port } = getServerDefaults(astroConfig);
                   const prependCode = getPrependCode();
                   const prefix = prependCode.length ? `${prependCode.join("\n")}
@@ -221,7 +247,7 @@ function boot(options = {}) {
                   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 })});
+await __astroscope_bootSetup(__astroscope_boot, ${JSON.stringify({ host, port, warmup: enableWarmup })});
 `;
                   const s = new MagicString(entryChunk.code);
                   s.prepend(injection);

package/dist/setup.cjs

@@ -57,6 +57,61 @@ 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 = {
@@ -65,7 +120,16 @@ 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

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

package/dist/setup.d.ts

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

package/dist/setup.js

@@ -3,6 +3,9 @@ import {
   runStartup
 } from "./chunk-LUFQ5I47.js";
 import "./chunk-I62ZQYTP.js";
+import {
+  warmup
+} from "./chunk-SXYYPF3C.js";
 
 // src/setup.ts
 async function setup(boot, config) {
@@ -12,7 +15,16 @@ 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/warmup.js

@@ -1,56 +1,6 @@
-// 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 };
-}
+import {
+  warmup
+} from "./chunk-SXYYPF3C.js";
 export {
   warmup
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astroscope/boot",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Startup and graceful shutdown hooks for Astro SSR",
   "type": "module",
   "main": "./dist/index.js",
@@ -52,14 +52,8 @@
     "url": "https://github.com/smnbbrv/astroscope/issues"
   },
   "homepage": "https://github.com/smnbbrv/astroscope/tree/main/packages/boot#readme",
-  "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",
-    "typecheck": "tsc --noEmit",
-    "lint": "eslint src",
-    "lint:fix": "eslint src --fix"
-  },
   "devDependencies": {
-    "astro": "^6.0.2",
+    "astro": "^6.0.7",
     "tsup": "^8.5.1",
     "typescript": "^5.9.3"
   },
@@ -69,5 +63,11 @@
   },
   "dependencies": {
     "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",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src",
+    "lint:fix": "eslint src --fix"
   }
-}
+}