@astroscope/boot 0.3.1 → 0.3.3

package/dist/chunk-4PQTRKEQ.js

@@ -0,0 +1,13 @@
+// src/prepend.ts
+var code = [];
+function prepend(value) {
+  code.push(value);
+}
+function getPrependCode() {
+  return code;
+}
+
+export {
+  prepend,
+  getPrependCode
+};

package/dist/index.cjs

@@ -31,7 +31,8 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   boot: () => boot,
-  default: () => boot
+  default: () => boot,
+  prepend: () => prepend
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -118,8 +119,16 @@ async function runShutdown(boot2, context) {
   }
 }
 
+// src/utils.ts
+function serializeError(error) {
+  if (error instanceof Error) {
+    return error.stack ?? error.message;
+  }
+  return JSON.stringify(error);
+}
+
 // src/hmr.ts
-function setupBootHmr(server, entry, logger, getBootContext) {
+function setupBootHmr(server, entry, logger, getBootContext2) {
   const bootModuleId = `/${entry}`;
   const bootFilePath = import_node_path.default.resolve(server.config.root, entry);
   const getBootDependencies = () => {
@@ -147,24 +156,33 @@ function setupBootHmr(server, entry, logger, getBootContext) {
     const bootDeps = getBootDependencies();
     if (bootDeps.has(changedPath)) {
       logger.info(`boot dependency changed: ${changedPath}, rerunning hooks...`);
-      const bootContext = getBootContext();
+      const bootContext = getBootContext2();
       try {
         const oldModule = await server.ssrLoadModule(bootModuleId);
         await runShutdown(oldModule, bootContext);
       } catch (error) {
-        logger.error(`Error during boot HMR shutdown: ${error}`);
+        logger.error(`Error during boot HMR shutdown: ${serializeError(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}`);
+        logger.error(`Error during boot HMR startup: ${serializeError(error)}`);
       }
     }
   });
 }
 
+// src/prepend.ts
+var code = [];
+function prepend(value) {
+  code.push(value);
+}
+function getPrependCode() {
+  return code;
+}
+
 // src/warmup-manifest.ts
 var import_node_fs = __toESM(require("fs"), 1);
 var import_node_path2 = __toESM(require("path"), 1);
@@ -208,6 +226,15 @@ function getServerDefaults(config) {
     port: config?.server?.port ?? 4321
   };
 }
+function getBootContext(server, config) {
+  const addr = server.httpServer?.address();
+  if (addr && typeof addr === "object" && "address" in addr && "port" in addr) {
+    const host2 = addr.address === "::" || addr.address === "0.0.0.0" ? "localhost" : addr.address;
+    return { dev: true, host: host2, port: addr.port };
+  }
+  const { host, port } = getServerDefaults(config);
+  return { dev: true, host, port };
+}
 function boot(options = {}) {
   const entry = resolveEntry(options.entry);
   const hmr = options.hmr ?? false;
@@ -225,40 +252,9 @@ function boot(options = {}) {
         updateConfig({
           vite: {
             plugins: [
+              // build plugin: handles entry.mjs injection, warmup manifest
               {
                 name: "@astroscope/boot",
-                enforce: "pre",
-                async configureServer(server) {
-                  if (isBuild) return;
-                  const getBootContext = () => {
-                    const addr = server.httpServer?.address();
-                    if (addr && typeof addr === "object") {
-                      const host2 = addr.address === "::" || addr.address === "0.0.0.0" ? "localhost" : addr.address;
-                      return { dev: true, host: host2, port: addr.port };
-                    }
-                    const { host, port } = getServerDefaults(astroConfig);
-                    return { dev: true, host, port };
-                  };
-                  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 runShutdown(module2, bootContext);
-                    } catch (error) {
-                      logger.error(`Error running shutdown script: ${error}`);
-                    }
-                  });
-                  if (hmr) {
-                    setupBootHmr(server, entry, logger, getBootContext);
-                  }
-                },
                 configResolved(config2) {
                   isSSR = !!config2.build?.ssr;
                 },
@@ -283,13 +279,16 @@ function boot(options = {}) {
                   }
                   warmupModules = collectWarmupModules(bundle);
                   const { host, port } = getServerDefaults(astroConfig);
-                  const bootImport = `globalThis.__astroscope_server_url = import.meta.url;
+                  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 })});
 `;
                   const s = new import_magic_string.default(entryChunk.code);
-                  s.prepend(bootImport);
+                  s.prepend(injection);
                   entryChunk.code = s.toString();
                   if (entryChunk.map) {
                     entryChunk.map = s.generateMap({ hires: true });
@@ -302,6 +301,33 @@ await __astroscope_bootSetup(__astroscope_boot, ${JSON.stringify({ host, port })
                   if (!outDir) return;
                   writeWarmupManifest(outDir, warmupModules, logger);
                 }
+              },
+              // startup plugin: runs after all other configureServer hooks
+              {
+                name: "@astroscope/boot/startup",
+                enforce: "post",
+                async configureServer(server) {
+                  if (isBuild) return;
+                  try {
+                    const bootContext = getBootContext(server, astroConfig);
+                    const module2 = await server.ssrLoadModule(`/${entry}`);
+                    await runStartup(module2, bootContext);
+                  } catch (error) {
+                    logger.error(`Error running startup script: ${serializeError(error)}`);
+                  }
+                  server.httpServer?.once("close", async () => {
+                    try {
+                      const bootContext = getBootContext(server, astroConfig);
+                      const module2 = await server.ssrLoadModule(`/${entry}`);
+                      await runShutdown(module2, bootContext);
+                    } catch (error) {
+                      logger.error(`Error running shutdown script: ${serializeError(error)}`);
+                    }
+                  });
+                  if (hmr) {
+                    setupBootHmr(server, entry, logger, () => getBootContext(server, astroConfig));
+                  }
+                }
               }
             ]
           }
@@ -312,5 +338,6 @@ await __astroscope_bootSetup(__astroscope_boot, ${JSON.stringify({ host, port })
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  boot
+  boot,
+  prepend
 });

package/dist/index.d.cts

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

package/dist/index.d.ts

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

package/dist/index.js

@@ -1,3 +1,7 @@
+import {
+  getPrependCode,
+  prepend
+} from "./chunk-4PQTRKEQ.js";
 import {
   runShutdown,
   runStartup
@@ -54,8 +58,16 @@ var ignoredSuffixes = [
   ".less"
 ];
 
+// src/utils.ts
+function serializeError(error) {
+  if (error instanceof Error) {
+    return error.stack ?? error.message;
+  }
+  return JSON.stringify(error);
+}
+
 // src/hmr.ts
-function setupBootHmr(server, entry, logger, getBootContext) {
+function setupBootHmr(server, entry, logger, getBootContext2) {
   const bootModuleId = `/${entry}`;
   const bootFilePath = path.resolve(server.config.root, entry);
   const getBootDependencies = () => {
@@ -83,19 +95,19 @@ function setupBootHmr(server, entry, logger, getBootContext) {
     const bootDeps = getBootDependencies();
     if (bootDeps.has(changedPath)) {
       logger.info(`boot dependency changed: ${changedPath}, rerunning hooks...`);
-      const bootContext = getBootContext();
+      const bootContext = getBootContext2();
       try {
         const oldModule = await server.ssrLoadModule(bootModuleId);
         await runShutdown(oldModule, bootContext);
       } catch (error) {
-        logger.error(`Error during boot HMR shutdown: ${error}`);
+        logger.error(`Error during boot HMR shutdown: ${serializeError(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}`);
+        logger.error(`Error during boot HMR startup: ${serializeError(error)}`);
       }
     }
   });
@@ -144,6 +156,15 @@ function getServerDefaults(config) {
     port: config?.server?.port ?? 4321
   };
 }
+function getBootContext(server, config) {
+  const addr = server.httpServer?.address();
+  if (addr && typeof addr === "object" && "address" in addr && "port" in addr) {
+    const host2 = addr.address === "::" || addr.address === "0.0.0.0" ? "localhost" : addr.address;
+    return { dev: true, host: host2, port: addr.port };
+  }
+  const { host, port } = getServerDefaults(config);
+  return { dev: true, host, port };
+}
 function boot(options = {}) {
   const entry = resolveEntry(options.entry);
   const hmr = options.hmr ?? false;
@@ -161,40 +182,9 @@ function boot(options = {}) {
         updateConfig({
           vite: {
             plugins: [
+              // build plugin: handles entry.mjs injection, warmup manifest
               {
                 name: "@astroscope/boot",
-                enforce: "pre",
-                async configureServer(server) {
-                  if (isBuild) return;
-                  const getBootContext = () => {
-                    const addr = server.httpServer?.address();
-                    if (addr && typeof addr === "object") {
-                      const host2 = addr.address === "::" || addr.address === "0.0.0.0" ? "localhost" : addr.address;
-                      return { dev: true, host: host2, port: addr.port };
-                    }
-                    const { host, port } = getServerDefaults(astroConfig);
-                    return { dev: true, host, port };
-                  };
-                  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 runShutdown(module, bootContext);
-                    } catch (error) {
-                      logger.error(`Error running shutdown script: ${error}`);
-                    }
-                  });
-                  if (hmr) {
-                    setupBootHmr(server, entry, logger, getBootContext);
-                  }
-                },
                 configResolved(config2) {
                   isSSR = !!config2.build?.ssr;
                 },
@@ -219,13 +209,16 @@ function boot(options = {}) {
                   }
                   warmupModules = collectWarmupModules(bundle);
                   const { host, port } = getServerDefaults(astroConfig);
-                  const bootImport = `globalThis.__astroscope_server_url = import.meta.url;
+                  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 })});
 `;
                   const s = new MagicString(entryChunk.code);
-                  s.prepend(bootImport);
+                  s.prepend(injection);
                   entryChunk.code = s.toString();
                   if (entryChunk.map) {
                     entryChunk.map = s.generateMap({ hires: true });
@@ -238,6 +231,33 @@ await __astroscope_bootSetup(__astroscope_boot, ${JSON.stringify({ host, port })
                   if (!outDir) return;
                   writeWarmupManifest(outDir, warmupModules, logger);
                 }
+              },
+              // startup plugin: runs after all other configureServer hooks
+              {
+                name: "@astroscope/boot/startup",
+                enforce: "post",
+                async configureServer(server) {
+                  if (isBuild) return;
+                  try {
+                    const bootContext = getBootContext(server, astroConfig);
+                    const module = await server.ssrLoadModule(`/${entry}`);
+                    await runStartup(module, bootContext);
+                  } catch (error) {
+                    logger.error(`Error running startup script: ${serializeError(error)}`);
+                  }
+                  server.httpServer?.once("close", async () => {
+                    try {
+                      const bootContext = getBootContext(server, astroConfig);
+                      const module = await server.ssrLoadModule(`/${entry}`);
+                      await runShutdown(module, bootContext);
+                    } catch (error) {
+                      logger.error(`Error running shutdown script: ${serializeError(error)}`);
+                    }
+                  });
+                  if (hmr) {
+                    setupBootHmr(server, entry, logger, () => getBootContext(server, astroConfig));
+                  }
+                }
               }
             ]
           }
@@ -248,5 +268,6 @@ await __astroscope_bootSetup(__astroscope_boot, ${JSON.stringify({ host, port })
 }
 export {
   boot,
-  boot as default
+  boot as default,
+  prepend
 };

package/dist/prepend.cjs

@@ -0,0 +1,38 @@
+"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/prepend.ts
+var prepend_exports = {};
+__export(prepend_exports, {
+  getPrependCode: () => getPrependCode,
+  prepend: () => prepend
+});
+module.exports = __toCommonJS(prepend_exports);
+var code = [];
+function prepend(value) {
+  code.push(value);
+}
+function getPrependCode() {
+  return code;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getPrependCode,
+  prepend
+});

package/dist/prepend.d.cts

@@ -0,0 +1,14 @@
+/**
+ * Register code to prepend to `entry.mjs` before boot's startup.
+ *
+ * Used by integrations (e.g. `@astroscope/health`) to ensure their
+ * setup runs before `onStartup` in production builds.
+ */
+declare function prepend(value: string): void;
+/**
+ * Get all registered prepend code strings.
+ * Used internally by boot's generateBundle.
+ */
+declare function getPrependCode(): string[];
+
+export { getPrependCode, prepend };

package/dist/prepend.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Register code to prepend to `entry.mjs` before boot's startup.
+ *
+ * Used by integrations (e.g. `@astroscope/health`) to ensure their
+ * setup runs before `onStartup` in production builds.
+ */
+declare function prepend(value: string): void;
+/**
+ * Get all registered prepend code strings.
+ * Used internally by boot's generateBundle.
+ */
+declare function getPrependCode(): string[];
+
+export { getPrependCode, prepend };

package/dist/prepend.js

@@ -0,0 +1,8 @@
+import {
+  getPrependCode,
+  prepend
+} from "./chunk-4PQTRKEQ.js";
+export {
+  getPrependCode,
+  prepend
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astroscope/boot",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "description": "Startup and graceful shutdown hooks for Astro SSR",
   "type": "module",
   "main": "./dist/index.js",
@@ -19,6 +19,10 @@
       "types": "./dist/events.d.ts",
       "import": "./dist/events.js"
     },
+    "./prepend": {
+      "types": "./dist/prepend.d.ts",
+      "import": "./dist/prepend.js"
+    },
     "./setup": {
       "types": "./dist/setup.d.ts",
       "import": "./dist/setup.js"
@@ -49,7 +53,7 @@
   },
   "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 --format esm,cjs --dts",
+    "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/**/*.{ts,tsx}'",
     "lint:fix": "eslint 'src/**/*.{ts,tsx}' --fix"