vite-plugin-enter-dev 0.0.10-alpha.0 → 0.0.11

package/README.md

@@ -0,0 +1,5 @@
+# vite-plugin-enter-dev
+
+Version 0.0.11 adds recovery for full reloads missed before the first HMR connection or while disconnected. Each served HTML document includes the server instance and reload revision. The client compares that generation on initial connection and reconnection; a stale document reloads once, while a current document remains in place.
+
+The plugin uses Vite's public WebSocket and HTML transform hooks. It does not depend on optimizer internals or an arbitrary sleep. Existing workspaces must install this version and restart Vite to activate it. Publish 0.0.11 before deploying a Gateway that requires that version.

package/dist/index.js

@@ -1,4 +1,5 @@
 import react from '@vitejs/plugin-react';
+import { randomUUID } from 'crypto';
 
 // src/index.ts
 
@@ -283,13 +284,64 @@ function getParentElementType(parentNode) {
   }
   return null;
 }
+function reloadGenerationPlugin() {
+  const instance = randomUUID();
+  let revision = 0;
+  let base = "/";
+  const generation = () => `${instance}:${revision}`;
+  return {
+    name: "enter-dev-reload-generation",
+    apply: "serve",
+    configResolved(config) {
+      base = config.base;
+    },
+    configureServer(server) {
+      const originalSend = server.ws.send.bind(server.ws);
+      const send = (payload, data) => {
+        if (typeof payload === "string") {
+          originalSend(payload, data);
+          return;
+        }
+        if (payload.type === "full-reload") revision += 1;
+        originalSend(payload);
+      };
+      server.ws.send = send;
+      server.ws.on("enter:check-generation", (data, client) => {
+        if (data?.generation !== generation()) {
+          client.send("enter:reload-required", { generation: generation() });
+        }
+      });
+      server.httpServer?.once("close", () => {
+        if (server.ws.send === send) server.ws.send = originalSend;
+      });
+    },
+    transformIndexHtml() {
+      return [
+        {
+          tag: "script",
+          attrs: { type: "module" },
+          injectTo: "head-prepend",
+          children: `import { createHotContext } from ${JSON.stringify(`${base}@vite/client`)};
+const generation = ${JSON.stringify(generation())};
+const hot = createHotContext('/@enter/reload-generation');
+let reloading = false;
+hot.on('enter:reload-required', () => {
+  if (reloading) return;
+  reloading = true;
+  window.location.reload();
+});
+const check = () => hot.send('enter:check-generation', { generation });
+hot.on('vite:ws:connect', check);
+check();`
+        }
+      ];
+    }
+  };
+}
 
 // src/index.ts
 function enterDevPlugin(options = {}) {
-  const {
-    injectMessageListener = true,
-    react: enableReact = true
-  } = options;
+  const { injectMessageListener = true, react: enableReact = true } = options;
   const reactPlugin = enableReact ? react({
     // 确保在开发模式下启用JSX源码映射
     jsxImportSource: void 0,
@@ -502,7 +554,14 @@ function enterDevPlugin(options = {}) {
       }
     }
   };
-  return [...reactPlugin, htmlInjectPlugin, sandboxServerPlugin, routerBasePlugin, publicAssetReloadPlugin];
+  return [
+    ...reactPlugin,
+    htmlInjectPlugin,
+    sandboxServerPlugin,
+    routerBasePlugin,
+    publicAssetReloadPlugin,
+    reloadGenerationPlugin()
+  ];
 }
 function enterProdPlugin(options = {}) {
   const {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vite-plugin-enter-dev",
-  "version": "0.0.10-alpha.0",
+  "version": "0.0.11",
   "type": "module",
   "private": false,
   "description": "A Vite plugin for development enhancements",