npm - @astroscope/boot - Versions diffs - 0.2.3 → 0.3.1 - Mend

@astroscope/boot 0.2.3 → 0.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (19) hide show

package/dist/chunk-I62ZQYTP.js ADDED Viewed

@@ -0,0 +1,36 @@
+// src/events.ts
+var STORE_KEY = /* @__PURE__ */ Symbol.for("@astroscope/boot/events");
+function getStore() {
+  const existing = globalThis[STORE_KEY];
+  if (existing) return existing;
+  const store = { listeners: /* @__PURE__ */ new Map() };
+  globalThis[STORE_KEY] = store;
+  return store;
+}
+function on(event, handler) {
+  const store = getStore();
+  let handlers = store.listeners.get(event);
+  if (!handlers) {
+    handlers = /* @__PURE__ */ new Set();
+    store.listeners.set(event, handlers);
+  }
+  handlers.add(handler);
+}
+function off(event, handler) {
+  const store = getStore();
+  store.listeners.get(event)?.delete(handler);
+}
+async function emit(event, context) {
+  const store = getStore();
+  const handlers = store.listeners.get(event);
+  if (!handlers) return;
+  for (const handler of handlers) {
+    await handler(context);
+  }
+}
+export {
+  on,
+  off,
+  emit
+};

package/dist/chunk-LUFQ5I47.js ADDED Viewed

@@ -0,0 +1,23 @@
+import {
+  emit
+} from "./chunk-I62ZQYTP.js";
+// src/lifecycle.ts
+async function runStartup(boot, context) {
+  await emit("beforeOnStartup", context);
+  await boot.onStartup?.(context);
+  await emit("afterOnStartup", context);
+}
+async function runShutdown(boot, context) {
+  try {
+    await emit("beforeOnShutdown", context);
+    await boot.onShutdown?.(context);
+  } finally {
+    await emit("afterOnShutdown", context);
+  }
+}
+export {
+  runStartup,
+  runShutdown
+};

package/dist/events.cjs ADDED Viewed

@@ -0,0 +1,62 @@
+"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/events.ts
+var events_exports = {};
+__export(events_exports, {
+  emit: () => emit,
+  off: () => off,
+  on: () => on
+});
+module.exports = __toCommonJS(events_exports);
+var STORE_KEY = /* @__PURE__ */ Symbol.for("@astroscope/boot/events");
+function getStore() {
+  const existing = globalThis[STORE_KEY];
+  if (existing) return existing;
+  const store = { listeners: /* @__PURE__ */ new Map() };
+  globalThis[STORE_KEY] = store;
+  return store;
+}
+function on(event, handler) {
+  const store = getStore();
+  let handlers = store.listeners.get(event);
+  if (!handlers) {
+    handlers = /* @__PURE__ */ new Set();
+    store.listeners.set(event, handlers);
+  }
+  handlers.add(handler);
+}
+function off(event, handler) {
+  const store = getStore();
+  store.listeners.get(event)?.delete(handler);
+}
+async function emit(event, context) {
+  const store = getStore();
+  const handlers = store.listeners.get(event);
+  if (!handlers) return;
+  for (const handler of handlers) {
+    await handler(context);
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  emit,
+  off,
+  on
+});

package/dist/events.d.cts ADDED Viewed

@@ -0,0 +1,18 @@
+import { B as BootContext } from './types-CxpusND2.cjs';
+type BootEventName = 'beforeOnStartup' | 'afterOnStartup' | 'beforeOnShutdown' | 'afterOnShutdown';
+type BootEventHandler = (context: BootContext) => Promise<void> | void;
+/**
+ * Register a handler for a boot lifecycle event.
+ */
+declare function on(event: BootEventName, handler: BootEventHandler): void;
+/**
+ * Remove a previously registered handler.
+ */
+declare function off(event: BootEventName, handler: BootEventHandler): void;
+/**
+ * Emit a boot lifecycle event, running all registered handlers sequentially.
+ */
+declare function emit(event: BootEventName, context: BootContext): Promise<void>;
+export { type BootEventHandler, type BootEventName, emit, off, on };

package/dist/events.d.ts ADDED Viewed

@@ -0,0 +1,18 @@
+import { B as BootContext } from './types-CxpusND2.js';
+type BootEventName = 'beforeOnStartup' | 'afterOnStartup' | 'beforeOnShutdown' | 'afterOnShutdown';
+type BootEventHandler = (context: BootContext) => Promise<void> | void;
+/**
+ * Register a handler for a boot lifecycle event.
+ */
+declare function on(event: BootEventName, handler: BootEventHandler): void;
+/**
+ * Remove a previously registered handler.
+ */
+declare function off(event: BootEventName, handler: BootEventHandler): void;
+/**
+ * Emit a boot lifecycle event, running all registered handlers sequentially.
+ */
+declare function emit(event: BootEventName, context: BootContext): Promise<void>;
+export { type BootEventHandler, type BootEventName, emit, off, on };

package/dist/events.js ADDED Viewed

@@ -0,0 +1,10 @@
+import {
+  emit,
+  off,
+  on
+} from "./chunk-I62ZQYTP.js";
+export {
+  emit,
+  off,
+  on
+};

package/dist/index.cjs CHANGED Viewed

@@ -36,10 +36,12 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 // src/integration.ts
-var import_node_fs = __toESM(require("fs"), 1);
-var import_node_path = __toESM(require("path"), 1);
+var import_node_fs2 = __toESM(require("fs"), 1);
 var import_magic_string = __toESM(require("magic-string"), 1);
+// src/hmr.ts
+var import_node_path = __toESM(require("path"), 1);
 // src/ignored.ts
 var ignoredSuffixes = [
   // type definitions
@@ -83,13 +85,123 @@ var ignoredSuffixes = [
   ".less"
 ];
+// src/events.ts
+var STORE_KEY = /* @__PURE__ */ Symbol.for("@astroscope/boot/events");
+function getStore() {
+  const existing = globalThis[STORE_KEY];
+  if (existing) return existing;
+  const store = { listeners: /* @__PURE__ */ new Map() };
+  globalThis[STORE_KEY] = store;
+  return store;
+}
+async function emit(event, context) {
+  const store = getStore();
+  const handlers = store.listeners.get(event);
+  if (!handlers) return;
+  for (const handler of handlers) {
+    await handler(context);
+  }
+}
+// src/lifecycle.ts
+async function runStartup(boot2, context) {
+  await emit("beforeOnStartup", context);
+  await boot2.onStartup?.(context);
+  await emit("afterOnStartup", context);
+}
+async function runShutdown(boot2, context) {
+  try {
+    await emit("beforeOnShutdown", context);
+    await boot2.onShutdown?.(context);
+  } finally {
+    await emit("afterOnShutdown", context);
+  }
+}
+// src/hmr.ts
+function setupBootHmr(server, entry, logger, getBootContext) {
+  const bootModuleId = `/${entry}`;
+  const bootFilePath = import_node_path.default.resolve(server.config.root, entry);
+  const getBootDependencies = () => {
+    const deps = /* @__PURE__ */ new Set();
+    const bootModules = server.moduleGraph.getModulesByFile(bootFilePath);
+    const bootModule = bootModules ? [...bootModules][0] : void 0;
+    if (!bootModule) return deps;
+    const collectDeps = (mod, visited = /* @__PURE__ */ new Set()) => {
+      if (!mod?.file || visited.has(mod.file)) return;
+      visited.add(mod.file);
+      deps.add(mod.file);
+      for (const imported of mod.importedModules) {
+        collectDeps(imported, visited);
+      }
+    };
+    collectDeps(bootModule);
+    return deps;
+  };
+  const shouldIgnore = (filePath) => {
+    const p = filePath.toLowerCase();
+    return ignoredSuffixes.some((suffix) => p.endsWith(suffix));
+  };
+  server.watcher.on("change", async (changedPath) => {
+    if (shouldIgnore(changedPath)) return;
+    const bootDeps = getBootDependencies();
+    if (bootDeps.has(changedPath)) {
+      logger.info(`boot dependency changed: ${changedPath}, rerunning hooks...`);
+      const bootContext = getBootContext();
+      try {
+        const oldModule = await server.ssrLoadModule(bootModuleId);
+        await runShutdown(oldModule, bootContext);
+      } catch (error) {
+        logger.error(`Error during boot HMR shutdown: ${error}`);
+      }
+      server.moduleGraph.invalidateAll();
+      try {
+        const newModule = await server.ssrLoadModule(bootModuleId);
+        await runStartup(newModule, bootContext);
+      } catch (error) {
+        logger.error(`Error during boot HMR startup: ${error}`);
+      }
+    }
+  });
+}
+// src/warmup-manifest.ts
+var import_node_fs = __toESM(require("fs"), 1);
+var import_node_path2 = __toESM(require("path"), 1);
+var WARMUP_MANIFEST_FILE = "warmup-manifest.json";
+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")) {
+      middlewarePath = fileName;
+    }
+  }
+  return { pageModules, middlewarePath };
+}
+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`);
+}
 // src/integration.ts
 function resolveEntry(entry) {
   if (entry) return entry;
-  if (import_node_fs.default.existsSync("src/boot/index.ts")) return "src/boot/index.ts";
+  if (import_node_fs2.default.existsSync("src/boot/index.ts")) return "src/boot/index.ts";
   return "src/boot.ts";
 }
-var WARMUP_MANIFEST_FILE = "warmup-manifest.json";
 function getServerDefaults(config) {
   return {
     host: typeof config?.server?.host === "string" ? config.server.host : config?.server?.host === true ? "0.0.0.0" : "localhost",
@@ -103,8 +215,7 @@ function boot(options = {}) {
   let isSSR = false;
   let bootChunkRef = null;
   let astroConfig = null;
-  let pageModules = [];
-  let middlewarePath = null;
+  let warmupModules = null;
   return {
     name: "@astroscope/boot",
     hooks: {
@@ -117,7 +228,7 @@ function boot(options = {}) {
               {
                 name: "@astroscope/boot",
                 enforce: "pre",
-                configureServer(server) {
+                async configureServer(server) {
                   if (isBuild) return;
                   const getBootContext = () => {
                     const addr = server.httpServer?.address();
@@ -125,72 +236,27 @@ function boot(options = {}) {
                       const host2 = addr.address === "::" || addr.address === "0.0.0.0" ? "localhost" : addr.address;
                       return { dev: true, host: host2, port: addr.port };
                     }
-                    const defaults = getServerDefaults(astroConfig);
-                    const host = process.env["HOST"] ?? defaults.host;
-                    const port = process.env["PORT"] ? Number(process.env["PORT"]) : defaults.port;
+                    const { host, port } = getServerDefaults(astroConfig);
                     return { dev: true, host, port };
                   };
-                  server.httpServer?.once("listening", async () => {
-                    try {
-                      const bootContext = getBootContext();
-                      const module2 = await server.ssrLoadModule(`/${entry}`);
-                      await module2.onStartup?.(bootContext);
-                    } catch (error) {
-                      logger.error(`Error running startup script: ${error}`);
-                    }
-                  });
+                  try {
+                    const bootContext = getBootContext();
+                    const module2 = await server.ssrLoadModule(`/${entry}`);
+                    await runStartup(module2, bootContext);
+                  } catch (error) {
+                    logger.error(`Error running startup script: ${error}`);
+                  }
                   server.httpServer?.once("close", async () => {
                     try {
                       const bootContext = getBootContext();
                       const module2 = await server.ssrLoadModule(`/${entry}`);
-                      await module2.onShutdown?.(bootContext);
+                      await runShutdown(module2, bootContext);
                     } catch (error) {
                       logger.error(`Error running shutdown script: ${error}`);
                     }
                   });
                   if (hmr) {
-                    const bootModuleId = `/${entry}`;
-                    const bootFilePath = import_node_path.default.resolve(server.config.root, entry);
-                    const getBootDependencies = () => {
-                      const deps = /* @__PURE__ */ new Set();
-                      const bootModules = server.moduleGraph.getModulesByFile(bootFilePath);
-                      const bootModule = bootModules ? [...bootModules][0] : void 0;
-                      if (!bootModule) return deps;
-                      const collectDeps = (mod, visited = /* @__PURE__ */ new Set()) => {
-                        if (!mod?.file || visited.has(mod.file)) return;
-                        visited.add(mod.file);
-                        deps.add(mod.file);
-                        for (const imported of mod.importedModules) {
-                          collectDeps(imported, visited);
-                        }
-                      };
-                      collectDeps(bootModule);
-                      return deps;
-                    };
-                    const rerunBoot = async (changedFile) => {
-                      logger.info(`boot dependency changed: ${changedFile}, rerunning hooks...`);
-                      try {
-                        const bootContext = getBootContext();
-                        const oldModule = await server.ssrLoadModule(bootModuleId);
-                        await oldModule.onShutdown?.(bootContext);
-                        server.moduleGraph.invalidateAll();
-                        const newModule = await server.ssrLoadModule(bootModuleId);
-                        await newModule.onStartup?.(bootContext);
-                      } catch (error) {
-                        logger.error(`Error during boot HMR: ${error}`);
-                      }
-                    };
-                    const shouldIgnore = (filePath) => {
-                      const p = filePath.toLowerCase();
-                      return ignoredSuffixes.some((suffix) => p.endsWith(suffix));
-                    };
-                    server.watcher.on("change", async (changedPath) => {
-                      if (shouldIgnore(changedPath)) return;
-                      const bootDeps = getBootDependencies();
-                      if (bootDeps.has(changedPath)) {
-                        await rerunBoot(changedPath);
-                      }
-                    });
+                    setupBootHmr(server, entry, logger, getBootContext);
                   }
                 },
                 configResolved(config2) {
@@ -215,39 +281,12 @@ function boot(options = {}) {
                     logger.warn("entry.mjs not found - boot injection skipped");
                     return;
                   }
-                  pageModules = [];
-                  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")) {
-                      middlewarePath = fileName;
-                    }
-                  }
+                  warmupModules = collectWarmupModules(bundle);
                   const { host, port } = getServerDefaults(astroConfig);
                   const bootImport = `globalThis.__astroscope_server_url = import.meta.url;
-import * as __boot from './${bootChunkName}';
-const __bootContext = { dev: false, host: process.env.HOST ?? '${host}', port: process.env.PORT ? Number(process.env.PORT) : ${port} };
-try {
-  await __boot.onStartup?.(__bootContext);
-} catch (err) {
-  console.error('[boot] startup failed:', err);
-  try { await __boot.onShutdown?.(__bootContext); } catch {}
-  process.exit(1);
-}
-if (__boot.onShutdown) {
-  process.on('SIGTERM', async () => {
-    try {
-      await __boot.onShutdown(__bootContext);
-      process.exit(0);
-    } catch (err) {
-      console.error('[boot] shutdown failed:', err);
-      process.exit(1);
-    }
-  });
-}
+import * as __astroscope_boot from './${bootChunkName}';
+import { setup as __astroscope_bootSetup } from '@astroscope/boot/setup';
+await __astroscope_bootSetup(__astroscope_boot, ${JSON.stringify({ host, port })});
 `;
                   const s = new import_magic_string.default(entryChunk.code);
                   s.prepend(bootImport);
@@ -258,19 +297,10 @@ if (__boot.onShutdown) {
                   logger.info(`injected ${bootChunkName} into entry.mjs`);
                 },
                 writeBundle(outputOptions) {
-                  if (!isSSR) return;
+                  if (!isSSR || !warmupModules) return;
                   const outDir = outputOptions.dir;
                   if (!outDir) return;
-                  const modules = [];
-                  if (middlewarePath) {
-                    modules.push(`./${middlewarePath}`);
-                  }
-                  for (const page of pageModules) {
-                    modules.push(`./${page}`);
-                  }
-                  const manifestPath = import_node_path.default.join(outDir, "chunks", WARMUP_MANIFEST_FILE);
-                  import_node_fs.default.writeFileSync(manifestPath, JSON.stringify({ modules }));
-                  logger.info(`generated warmup for ${pageModules.length} pages`);
+                  writeWarmupManifest(outDir, warmupModules, logger);
                 }
               }
             ]

package/dist/index.d.cts CHANGED Viewed

@@ -1,5 +1,6 @@
 import { AstroIntegration } from 'astro';
 export { B as BootContext, W as WarmupResult } from './types-CxpusND2.cjs';
+export { BootEventHandler, BootEventName } from './events.cjs';
 interface BootOptions {
     /**

package/dist/index.d.ts CHANGED Viewed

@@ -1,5 +1,6 @@
 import { AstroIntegration } from 'astro';
 export { B as BootContext, W as WarmupResult } from './types-CxpusND2.js';
+export { BootEventHandler, BootEventName } from './events.js';
 interface BootOptions {
     /**

package/dist/index.js CHANGED Viewed

@@ -1,8 +1,16 @@
+import {
+  runShutdown,
+  runStartup
+} from "./chunk-LUFQ5I47.js";
+import "./chunk-I62ZQYTP.js";
 // src/integration.ts
-import fs from "fs";
-import path from "path";
+import fs2 from "fs";
 import MagicString from "magic-string";
+// src/hmr.ts
+import path from "path";
 // src/ignored.ts
 var ignoredSuffixes = [
   // type definitions
@@ -46,13 +54,90 @@ var ignoredSuffixes = [
   ".less"
 ];
+// src/hmr.ts
+function setupBootHmr(server, entry, logger, getBootContext) {
+  const bootModuleId = `/${entry}`;
+  const bootFilePath = path.resolve(server.config.root, entry);
+  const getBootDependencies = () => {
+    const deps = /* @__PURE__ */ new Set();
+    const bootModules = server.moduleGraph.getModulesByFile(bootFilePath);
+    const bootModule = bootModules ? [...bootModules][0] : void 0;
+    if (!bootModule) return deps;
+    const collectDeps = (mod, visited = /* @__PURE__ */ new Set()) => {
+      if (!mod?.file || visited.has(mod.file)) return;
+      visited.add(mod.file);
+      deps.add(mod.file);
+      for (const imported of mod.importedModules) {
+        collectDeps(imported, visited);
+      }
+    };
+    collectDeps(bootModule);
+    return deps;
+  };
+  const shouldIgnore = (filePath) => {
+    const p = filePath.toLowerCase();
+    return ignoredSuffixes.some((suffix) => p.endsWith(suffix));
+  };
+  server.watcher.on("change", async (changedPath) => {
+    if (shouldIgnore(changedPath)) return;
+    const bootDeps = getBootDependencies();
+    if (bootDeps.has(changedPath)) {
+      logger.info(`boot dependency changed: ${changedPath}, rerunning hooks...`);
+      const bootContext = getBootContext();
+      try {
+        const oldModule = await server.ssrLoadModule(bootModuleId);
+        await runShutdown(oldModule, bootContext);
+      } catch (error) {
+        logger.error(`Error during boot HMR shutdown: ${error}`);
+      }
+      server.moduleGraph.invalidateAll();
+      try {
+        const newModule = await server.ssrLoadModule(bootModuleId);
+        await runStartup(newModule, bootContext);
+      } catch (error) {
+        logger.error(`Error during boot HMR startup: ${error}`);
+      }
+    }
+  });
+}
+// src/warmup-manifest.ts
+import fs from "fs";
+import path2 from "path";
+var WARMUP_MANIFEST_FILE = "warmup-manifest.json";
+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")) {
+      middlewarePath = fileName;
+    }
+  }
+  return { pageModules, middlewarePath };
+}
+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`);
+}
 // src/integration.ts
 function resolveEntry(entry) {
   if (entry) return entry;
-  if (fs.existsSync("src/boot/index.ts")) return "src/boot/index.ts";
+  if (fs2.existsSync("src/boot/index.ts")) return "src/boot/index.ts";
   return "src/boot.ts";
 }
-var WARMUP_MANIFEST_FILE = "warmup-manifest.json";
 function getServerDefaults(config) {
   return {
     host: typeof config?.server?.host === "string" ? config.server.host : config?.server?.host === true ? "0.0.0.0" : "localhost",
@@ -66,8 +151,7 @@ function boot(options = {}) {
   let isSSR = false;
   let bootChunkRef = null;
   let astroConfig = null;
-  let pageModules = [];
-  let middlewarePath = null;
+  let warmupModules = null;
   return {
     name: "@astroscope/boot",
     hooks: {
@@ -80,7 +164,7 @@ function boot(options = {}) {
               {
                 name: "@astroscope/boot",
                 enforce: "pre",
-                configureServer(server) {
+                async configureServer(server) {
                   if (isBuild) return;
                   const getBootContext = () => {
                     const addr = server.httpServer?.address();
@@ -88,72 +172,27 @@ function boot(options = {}) {
                       const host2 = addr.address === "::" || addr.address === "0.0.0.0" ? "localhost" : addr.address;
                       return { dev: true, host: host2, port: addr.port };
                     }
-                    const defaults = getServerDefaults(astroConfig);
-                    const host = process.env["HOST"] ?? defaults.host;
-                    const port = process.env["PORT"] ? Number(process.env["PORT"]) : defaults.port;
+                    const { host, port } = getServerDefaults(astroConfig);
                     return { dev: true, host, port };
                   };
-                  server.httpServer?.once("listening", async () => {
-                    try {
-                      const bootContext = getBootContext();
-                      const module = await server.ssrLoadModule(`/${entry}`);
-                      await module.onStartup?.(bootContext);
-                    } catch (error) {
-                      logger.error(`Error running startup script: ${error}`);
-                    }
-                  });
+                  try {
+                    const bootContext = getBootContext();
+                    const module = await server.ssrLoadModule(`/${entry}`);
+                    await runStartup(module, bootContext);
+                  } catch (error) {
+                    logger.error(`Error running startup script: ${error}`);
+                  }
                   server.httpServer?.once("close", async () => {
                     try {
                       const bootContext = getBootContext();
                       const module = await server.ssrLoadModule(`/${entry}`);
-                      await module.onShutdown?.(bootContext);
+                      await runShutdown(module, bootContext);
                     } catch (error) {
                       logger.error(`Error running shutdown script: ${error}`);
                     }
                   });
                   if (hmr) {
-                    const bootModuleId = `/${entry}`;
-                    const bootFilePath = path.resolve(server.config.root, entry);
-                    const getBootDependencies = () => {
-                      const deps = /* @__PURE__ */ new Set();
-                      const bootModules = server.moduleGraph.getModulesByFile(bootFilePath);
-                      const bootModule = bootModules ? [...bootModules][0] : void 0;
-                      if (!bootModule) return deps;
-                      const collectDeps = (mod, visited = /* @__PURE__ */ new Set()) => {
-                        if (!mod?.file || visited.has(mod.file)) return;
-                        visited.add(mod.file);
-                        deps.add(mod.file);
-                        for (const imported of mod.importedModules) {
-                          collectDeps(imported, visited);
-                        }
-                      };
-                      collectDeps(bootModule);
-                      return deps;
-                    };
-                    const rerunBoot = async (changedFile) => {
-                      logger.info(`boot dependency changed: ${changedFile}, rerunning hooks...`);
-                      try {
-                        const bootContext = getBootContext();
-                        const oldModule = await server.ssrLoadModule(bootModuleId);
-                        await oldModule.onShutdown?.(bootContext);
-                        server.moduleGraph.invalidateAll();
-                        const newModule = await server.ssrLoadModule(bootModuleId);
-                        await newModule.onStartup?.(bootContext);
-                      } catch (error) {
-                        logger.error(`Error during boot HMR: ${error}`);
-                      }
-                    };
-                    const shouldIgnore = (filePath) => {
-                      const p = filePath.toLowerCase();
-                      return ignoredSuffixes.some((suffix) => p.endsWith(suffix));
-                    };
-                    server.watcher.on("change", async (changedPath) => {
-                      if (shouldIgnore(changedPath)) return;
-                      const bootDeps = getBootDependencies();
-                      if (bootDeps.has(changedPath)) {
-                        await rerunBoot(changedPath);
-                      }
-                    });
+                    setupBootHmr(server, entry, logger, getBootContext);
                   }
                 },
                 configResolved(config2) {
@@ -178,39 +217,12 @@ function boot(options = {}) {
                     logger.warn("entry.mjs not found - boot injection skipped");
                     return;
                   }
-                  pageModules = [];
-                  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")) {
-                      middlewarePath = fileName;
-                    }
-                  }
+                  warmupModules = collectWarmupModules(bundle);
                   const { host, port } = getServerDefaults(astroConfig);
                   const bootImport = `globalThis.__astroscope_server_url = import.meta.url;
-import * as __boot from './${bootChunkName}';
-const __bootContext = { dev: false, host: process.env.HOST ?? '${host}', port: process.env.PORT ? Number(process.env.PORT) : ${port} };
-try {
-  await __boot.onStartup?.(__bootContext);
-} catch (err) {
-  console.error('[boot] startup failed:', err);
-  try { await __boot.onShutdown?.(__bootContext); } catch {}
-  process.exit(1);
-}
-if (__boot.onShutdown) {
-  process.on('SIGTERM', async () => {
-    try {
-      await __boot.onShutdown(__bootContext);
-      process.exit(0);
-    } catch (err) {
-      console.error('[boot] shutdown failed:', err);
-      process.exit(1);
-    }
-  });
-}
+import * as __astroscope_boot from './${bootChunkName}';
+import { setup as __astroscope_bootSetup } from '@astroscope/boot/setup';
+await __astroscope_bootSetup(__astroscope_boot, ${JSON.stringify({ host, port })});
 `;
                   const s = new MagicString(entryChunk.code);
                   s.prepend(bootImport);
@@ -221,19 +233,10 @@ if (__boot.onShutdown) {
                   logger.info(`injected ${bootChunkName} into entry.mjs`);
                 },
                 writeBundle(outputOptions) {
-                  if (!isSSR) return;
+                  if (!isSSR || !warmupModules) return;
                   const outDir = outputOptions.dir;
                   if (!outDir) return;
-                  const modules = [];
-                  if (middlewarePath) {
-                    modules.push(`./${middlewarePath}`);
-                  }
-                  for (const page of pageModules) {
-                    modules.push(`./${page}`);
-                  }
-                  const manifestPath = path.join(outDir, "chunks", WARMUP_MANIFEST_FILE);
-                  fs.writeFileSync(manifestPath, JSON.stringify({ modules }));
-                  logger.info(`generated warmup for ${pageModules.length} pages`);
+                  writeWarmupManifest(outDir, warmupModules, logger);
                 }
               }
             ]

package/dist/lifecycle.cjs ADDED Viewed

@@ -0,0 +1,64 @@
+"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/lifecycle.ts
+var lifecycle_exports = {};
+__export(lifecycle_exports, {
+  runShutdown: () => runShutdown,
+  runStartup: () => runStartup
+});
+module.exports = __toCommonJS(lifecycle_exports);
+// src/events.ts
+var STORE_KEY = /* @__PURE__ */ Symbol.for("@astroscope/boot/events");
+function getStore() {
+  const existing = globalThis[STORE_KEY];
+  if (existing) return existing;
+  const store = { listeners: /* @__PURE__ */ new Map() };
+  globalThis[STORE_KEY] = store;
+  return store;
+}
+async function emit(event, context) {
+  const store = getStore();
+  const handlers = store.listeners.get(event);
+  if (!handlers) return;
+  for (const handler of handlers) {
+    await handler(context);
+  }
+}
+// src/lifecycle.ts
+async function runStartup(boot, context) {
+  await emit("beforeOnStartup", context);
+  await boot.onStartup?.(context);
+  await emit("afterOnStartup", context);
+}
+async function runShutdown(boot, context) {
+  try {
+    await emit("beforeOnShutdown", context);
+    await boot.onShutdown?.(context);
+  } finally {
+    await emit("afterOnShutdown", context);
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  runShutdown,
+  runStartup
+});

package/dist/lifecycle.d.cts ADDED Viewed

@@ -0,0 +1,10 @@
+import { B as BootContext } from './types-CxpusND2.cjs';
+interface BootModule {
+    onStartup?: ((context: BootContext) => Promise<void> | void) | undefined;
+    onShutdown?: ((context: BootContext) => Promise<void> | void) | undefined;
+}
+declare function runStartup(boot: BootModule, context: BootContext): Promise<void>;
+declare function runShutdown(boot: BootModule, context: BootContext): Promise<void>;
+export { type BootModule, runShutdown, runStartup };

package/dist/lifecycle.d.ts ADDED Viewed

@@ -0,0 +1,10 @@
+import { B as BootContext } from './types-CxpusND2.js';
+interface BootModule {
+    onStartup?: ((context: BootContext) => Promise<void> | void) | undefined;
+    onShutdown?: ((context: BootContext) => Promise<void> | void) | undefined;
+}
+declare function runStartup(boot: BootModule, context: BootContext): Promise<void>;
+declare function runShutdown(boot: BootModule, context: BootContext): Promise<void>;
+export { type BootModule, runShutdown, runStartup };

package/dist/lifecycle.js ADDED Viewed

@@ -0,0 +1,9 @@
+import {
+  runShutdown,
+  runStartup
+} from "./chunk-LUFQ5I47.js";
+import "./chunk-I62ZQYTP.js";
+export {
+  runShutdown,
+  runStartup
+};

package/dist/setup.cjs ADDED Viewed

@@ -0,0 +1,89 @@
+"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/setup.ts
+var setup_exports = {};
+__export(setup_exports, {
+  setup: () => setup
+});
+module.exports = __toCommonJS(setup_exports);
+// src/events.ts
+var STORE_KEY = /* @__PURE__ */ Symbol.for("@astroscope/boot/events");
+function getStore() {
+  const existing = globalThis[STORE_KEY];
+  if (existing) return existing;
+  const store = { listeners: /* @__PURE__ */ new Map() };
+  globalThis[STORE_KEY] = store;
+  return store;
+}
+async function emit(event, context) {
+  const store = getStore();
+  const handlers = store.listeners.get(event);
+  if (!handlers) return;
+  for (const handler of handlers) {
+    await handler(context);
+  }
+}
+// src/lifecycle.ts
+async function runStartup(boot, context) {
+  await emit("beforeOnStartup", context);
+  await boot.onStartup?.(context);
+  await emit("afterOnStartup", context);
+}
+async function runShutdown(boot, context) {
+  try {
+    await emit("beforeOnShutdown", context);
+    await boot.onShutdown?.(context);
+  } finally {
+    await emit("afterOnShutdown", context);
+  }
+}
+// src/setup.ts
+async function setup(boot, config) {
+  const context = {
+    dev: false,
+    host: process.env["HOST"] ?? config.host,
+    port: process.env["PORT"] ? Number(process.env["PORT"]) : config.port
+  };
+  try {
+    await runStartup(boot, context);
+  } catch (err) {
+    console.error("[boot] startup failed:", err);
+    try {
+      await runShutdown(boot, context);
+    } catch {
+    }
+    process.exit(1);
+  }
+  process.on("SIGTERM", async () => {
+    try {
+      await runShutdown(boot, context);
+    } catch (err) {
+      console.error("[boot] shutdown failed:", err);
+    }
+    process.exit(0);
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  setup
+});

package/dist/setup.d.cts ADDED Viewed

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

package/dist/setup.d.ts ADDED Viewed

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

package/dist/setup.js ADDED Viewed

@@ -0,0 +1,35 @@
+import {
+  runShutdown,
+  runStartup
+} from "./chunk-LUFQ5I47.js";
+import "./chunk-I62ZQYTP.js";
+// src/setup.ts
+async function setup(boot, config) {
+  const context = {
+    dev: false,
+    host: process.env["HOST"] ?? config.host,
+    port: process.env["PORT"] ? Number(process.env["PORT"]) : config.port
+  };
+  try {
+    await runStartup(boot, context);
+  } catch (err) {
+    console.error("[boot] startup failed:", err);
+    try {
+      await runShutdown(boot, context);
+    } catch {
+    }
+    process.exit(1);
+  }
+  process.on("SIGTERM", async () => {
+    try {
+      await runShutdown(boot, context);
+    } catch (err) {
+      console.error("[boot] shutdown failed:", err);
+    }
+    process.exit(0);
+  });
+}
+export {
+  setup
+};

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@astroscope/boot",
-  "version": "0.2.3",
+  "version": "0.3.1",
   "description": "Startup and graceful shutdown hooks for Astro SSR",
   "type": "module",
   "main": "./dist/index.js",
@@ -14,6 +14,14 @@
     "./warmup": {
       "types": "./dist/warmup.d.ts",
       "import": "./dist/warmup.js"
+    },
+    "./events": {
+      "types": "./dist/events.d.ts",
+      "import": "./dist/events.js"
+    },
+    "./setup": {
+      "types": "./dist/setup.d.ts",
+      "import": "./dist/setup.js"
     }
   },
   "files": [
@@ -41,7 +49,7 @@
   },
   "homepage": "https://github.com/smnbbrv/astroscope/tree/main/packages/boot#readme",
   "scripts": {
-    "build": "tsup src/index.ts src/warmup.ts --format esm,cjs --dts",
+    "build": "tsup src/index.ts src/warmup.ts src/events.ts src/lifecycle.ts src/setup.ts --format esm,cjs --dts",
     "typecheck": "tsc --noEmit",
     "lint": "eslint 'src/**/*.{ts,tsx}'",
     "lint:fix": "eslint 'src/**/*.{ts,tsx}' --fix"
@@ -49,7 +57,8 @@
   "devDependencies": {
     "astro": "^5.17.1",
     "tsup": "^8.5.1",
-    "typescript": "^5.9.3"
+    "typescript": "^5.9.3",
+    "vite": "^6.4.1"
   },
   "peerDependencies": {
     "astro": "^5.0.0"