vite-plugin-build-version-file 0.1.6 → 0.1.7

package/README.md

@@ -6,7 +6,6 @@
 
 - 构建产物中生成 `version.json`
 - 可选地向 HTML 注入 `window["__VERSION__"]`
-- 通过 `import.meta.env.__VERSION__` 在代码中直接读取版本号
 - 支持自定义版本号、文件名、全局变量名和额外数据
 
 这个插件只负责产出和暴露版本信息。
@@ -107,7 +106,7 @@ export default defineConfig({
 
 如果你的项目要做“检测到新版本后提示刷新”，推荐做法是：
 
-- 用 `import.meta.env.__VERSION__` 读取当前页面版本
+- 用 `window["__VERSION__"]` 读取当前页面版本
 - 请求 `version.json` 读取服务端版本
 - 在业务项目里自行决定提示方式和刷新时机
 
@@ -337,36 +336,9 @@ export default defineConfig({
 
 ## 在项目中读取版本
 
-插件提供三种方式读取版本号，可根据场景选择：
+插件提供两种方式读取版本号，可根据场景选择：
 
-### 方式一：通过 `import.meta.env` 读取（推荐）
-
-版本号会被注入到 `import.meta.env` 中，可以直接在代码中使用：
-
-```ts
-const version = import.meta.env.__VERSION__
-console.log(version) // '20260401153045' 或 '1.2.3'
-```
-
-**优势：**
-- 无需等待页面加载或发起请求
-- 类型安全，可在 `vite-env.d.ts` 中声明类型
-- 适合在应用初始化时读取版本
-
-**TypeScript 类型声明：**
-
-```ts
-// vite-env.d.ts
-interface ImportMetaEnv {
-  readonly __VERSION__: string
-}
-
-interface ImportMeta {
-  readonly env: ImportMetaEnv
-}
-```
-
-### 方式二：读取注入的全局变量
+### 方式一：读取注入的全局变量
 
 ```ts
 const payload = window['__VERSION__']
@@ -381,7 +353,7 @@ console.log(payload.env)
 - 这里读到的是完整对象，不是单独字符串
 - 如果配置了 `data`，这里也可以直接读取对应字段
 
-### 方式三：读取 `version.json`
+### 方式二：读取 `version.json`
 
 ```ts
 const response = await fetch('/version.json')
@@ -417,8 +389,9 @@ async function checkVersion() {
     })
 
     const payload = await response.json()
+    const currentPayload = window.__VERSION__
 
-    if (payload.time !== import.meta.env.__VERSION__) {
+    if (currentPayload && payload.time !== currentPayload.time) {
       const shouldReload = await showUpdatePrompt()
 
       if (shouldReload) {
@@ -447,7 +420,7 @@ checkVersion()
 
 建议：
 
-- 版本比较只判断 `payload.time` 和 `import.meta.env.__VERSION__` 是否一致
+- 版本比较只判断 `payload.time` 和当前页面里的 `window.__VERSION__.time` 是否一致
 - 提示方式由业务项目自己决定，可以是弹窗、消息条、通知或静默刷新
 - 轮询间隔不要过短，通常用 1 分钟或更长更合适
 - 请求失败后继续下一轮检查，避免一次失败后整个流程中断

package/dist/index.cjs

@@ -116,6 +116,27 @@ function toRequestPath(base, fileName) {
   const baseWithoutTrailingSlash = withLeadingSlash.endsWith("/") ? withLeadingSlash.slice(0, -1) : withLeadingSlash;
   return `${baseWithoutTrailingSlash}/${fileName}`.replace(/\/{2,}/g, "/");
 }
+function resolveVersion(options, context) {
+  if (typeof options.version === "function") {
+    return options.version(context);
+  }
+  if (options.version !== void 0) {
+    return options.version;
+  }
+  return createDefaultVersion(context.command);
+}
+function createPayload(options, context, data, packageInfo = {}) {
+  let nextPayload = {
+    ...data,
+    ...packageInfo,
+    time: resolveVersion(options, context),
+    env: context.mode
+  };
+  if (options.payload) {
+    nextPayload = options.payload(nextPayload);
+  }
+  return nextPayload;
+}
 function buildVersionPlugin(options = {}) {
   const fileName = normalizeFileName(options.filename ?? DEFAULT_FILENAME);
   const globalName = normalizeGlobalName(
@@ -123,52 +144,16 @@ function buildVersionPlugin(options = {}) {
   );
   const injectToHtml = options.injectToHtml ?? true;
   const data = normalizeData(options.data);
-  let packageInfo = {};
   let payload;
   return {
     name: PLUGIN_NAME,
-    config(config, { command }) {
-      const context = {
-        command,
-        mode: config.mode || "development"
-      };
-      let version;
-      if (typeof options.version === "function") {
-        version = options.version(context);
-      } else if (options.version !== void 0) {
-        version = options.version;
-      } else {
-        version = createDefaultVersion(context.command);
-      }
-      return {
-        define: {
-          [`import.meta.env.${globalName}`]: JSON.stringify(version)
-        }
-      };
-    },
     configResolved(config) {
-      packageInfo = readPackageInfo(config.root);
       const context = {
         command: config.command,
         mode: config.mode
       };
-      let version;
-      if (typeof options.version === "function") {
-        version = options.version(context);
-      } else if (options.version !== void 0) {
-        version = options.version;
-      } else {
-        version = createDefaultVersion(context.command);
-      }
-      payload = {
-        ...data,
-        ...packageInfo,
-        time: version,
-        env: config.mode
-      };
-      if (options.payload) {
-        payload = options.payload(payload);
-      }
+      const packageInfo = readPackageInfo(config.root);
+      payload = createPayload(options, context, data, packageInfo);
     },
     configureServer(server) {
       const requestPath = toRequestPath(server.config.base, fileName);

package/dist/index.mjs

@@ -91,6 +91,27 @@ function toRequestPath(base, fileName) {
   const baseWithoutTrailingSlash = withLeadingSlash.endsWith("/") ? withLeadingSlash.slice(0, -1) : withLeadingSlash;
   return `${baseWithoutTrailingSlash}/${fileName}`.replace(/\/{2,}/g, "/");
 }
+function resolveVersion(options, context) {
+  if (typeof options.version === "function") {
+    return options.version(context);
+  }
+  if (options.version !== void 0) {
+    return options.version;
+  }
+  return createDefaultVersion(context.command);
+}
+function createPayload(options, context, data, packageInfo = {}) {
+  let nextPayload = {
+    ...data,
+    ...packageInfo,
+    time: resolveVersion(options, context),
+    env: context.mode
+  };
+  if (options.payload) {
+    nextPayload = options.payload(nextPayload);
+  }
+  return nextPayload;
+}
 function buildVersionPlugin(options = {}) {
   const fileName = normalizeFileName(options.filename ?? DEFAULT_FILENAME);
   const globalName = normalizeGlobalName(
@@ -98,52 +119,16 @@ function buildVersionPlugin(options = {}) {
   );
   const injectToHtml = options.injectToHtml ?? true;
   const data = normalizeData(options.data);
-  let packageInfo = {};
   let payload;
   return {
     name: PLUGIN_NAME,
-    config(config, { command }) {
-      const context = {
-        command,
-        mode: config.mode || "development"
-      };
-      let version;
-      if (typeof options.version === "function") {
-        version = options.version(context);
-      } else if (options.version !== void 0) {
-        version = options.version;
-      } else {
-        version = createDefaultVersion(context.command);
-      }
-      return {
-        define: {
-          [`import.meta.env.${globalName}`]: JSON.stringify(version)
-        }
-      };
-    },
     configResolved(config) {
-      packageInfo = readPackageInfo(config.root);
       const context = {
         command: config.command,
         mode: config.mode
       };
-      let version;
-      if (typeof options.version === "function") {
-        version = options.version(context);
-      } else if (options.version !== void 0) {
-        version = options.version;
-      } else {
-        version = createDefaultVersion(context.command);
-      }
-      payload = {
-        ...data,
-        ...packageInfo,
-        time: version,
-        env: config.mode
-      };
-      if (options.payload) {
-        payload = options.payload(payload);
-      }
+      const packageInfo = readPackageInfo(config.root);
+      payload = createPayload(options, context, data, packageInfo);
     },
     configureServer(server) {
       const requestPath = toRequestPath(server.config.base, fileName);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vite-plugin-build-version-file",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "description": "A Vite plugin that emits version.json and injects version metadata into HTML.",
   "license": "MIT",
   "type": "module",