@gylautorun/dev-proxy-cookie 1.0.0 → 1.0.1

package/dist/index.mjs

@@ -118,6 +118,102 @@ function watchCookieFile(cookieFile, onCookieChange, onError) {
   return watcher;
 }
 
+// src/utils/env-detector.ts
+function isProductionValue(value) {
+  const productionValues = [
+    "production",
+    // 生产环境
+    "prod",
+    // 生产环境
+    "prd",
+    // 生产环境
+    "release",
+    // 发布环境
+    "staging",
+    // 预发布环境
+    "uat"
+    // 预发布环境
+  ];
+  return productionValues.includes(value.toLowerCase().trim());
+}
+function detectProductionEnvironment(customEnvs = [], debug = false, loggerPrefix = "[env-detector]") {
+  const env = process.env;
+  if (customEnvs.length > 0) {
+    for (const envName of customEnvs) {
+      const envValue = env[envName];
+      if (envValue && isProductionValue(envValue)) {
+        if (debug) {
+          console.log(`${loggerPrefix} Detected production via custom env: ${envName}=${envValue}`);
+        }
+        return true;
+      }
+    }
+  }
+  const commonEnvNames = [
+    "NODE_ENV",
+    "BUILD_MODE",
+    "VUE_APP_ENV",
+    "VITE_NODE_ENV",
+    "WEBPACK_MODE",
+    "CI_ENV",
+    "APP_ENV",
+    "ENV",
+    "DEPLOY_ENV",
+    "RUN_MODE"
+  ];
+  for (const envName of commonEnvNames) {
+    const envValue = env[envName];
+    if (envValue && isProductionValue(envValue)) {
+      if (debug) {
+        console.log(`${loggerPrefix} Detected production via env: ${envName}=${envValue}`);
+      }
+      return true;
+    }
+  }
+  if (env.CI === "true" || env.CI === "1" || env.CI === "yes") {
+    if (debug) {
+      console.log(`${loggerPrefix} Detected production via CI env`);
+    }
+    return true;
+  }
+  if (env.npm_lifecycle_event) {
+    const lifecycleEvent = env.npm_lifecycle_event.toLowerCase();
+    if (lifecycleEvent.includes("build") || lifecycleEvent.includes("prod") || lifecycleEvent.includes("prd") || lifecycleEvent.includes("release")) {
+      if (debug) {
+        console.log(`${loggerPrefix} Detected production via lifecycle event: ${env.npm_lifecycle_event}`);
+      }
+      return true;
+    }
+  }
+  const processArgs = process.argv.join("").toLowerCase();
+  if (processArgs.includes("build") || processArgs.includes("production") || processArgs.includes("--mode=production") || processArgs.includes("--prod") || processArgs.includes("--release")) {
+    if (debug) {
+      console.log(`${loggerPrefix} Detected production via process arguments`);
+    }
+    return true;
+  }
+  return false;
+}
+function shouldEnableWatch(watch, customEnvs = [], debug = false, loggerPrefix = "[env-detector]") {
+  if (typeof watch === "boolean") {
+    if (debug && !watch) {
+      console.log(`${loggerPrefix} Watch disabled by user setting`);
+    }
+    return watch;
+  }
+  const isProduction = detectProductionEnvironment(customEnvs, debug, loggerPrefix);
+  if (isProduction) {
+    if (debug) {
+      console.log(`${loggerPrefix} Auto-detected production mode - disabling watch`);
+    }
+    return false;
+  }
+  if (debug) {
+    console.log(`${loggerPrefix} Auto-detected development mode - enabling watch`);
+  }
+  return true;
+}
+
 // src/proxy/apply-dev-cookie-header.ts
 function applyDevCookieHeader(proxyReq, cookie) {
   if (!cookie) return;
@@ -390,13 +486,29 @@ var AutoProxyCookie = class {
     }
   }
   startFileWatch() {
-    this.watcher = watchCookieFile(
-      this.options.cookieFile,
-      this.handleCookieChange,
-      (error) => {
-        this.log("error", "[AutoProxyCookie] File watch error:", error.message);
+    let shouldWatch;
+    if (this.options.isDev !== void 0) {
+      shouldWatch = this.options.isDev;
+      if (this.options.debug) {
+        console.log(`[AutoProxyCookie] isDev=${this.options.isDev}, ${shouldWatch ? "enabling" : "disabling"} watch`);
       }
-    );
+    } else {
+      shouldWatch = true;
+      if (this.options.debug) {
+        console.log("[AutoProxyCookie] Default behavior: enabling watch (dev mode)");
+      }
+    }
+    if (shouldWatch) {
+      this.watcher = watchCookieFile(
+        this.options.cookieFile,
+        this.handleCookieChange,
+        (error) => {
+          this.log("error", "[AutoProxyCookie] File watch error:", error.message);
+        }
+      );
+    } else if (this.options.debug) {
+      console.log("[AutoProxyCookie] File watch disabled");
+    }
   }
   stop() {
     if (this.watcher) {
@@ -421,6 +533,7 @@ function createAutoProxyCookie(options) {
 function viteAutoProxyCookie(options) {
   const {
     name = "vite-auto-proxy-cookie",
+    isDev,
     ...autoProxyOptions
   } = options;
   let autoProxy = null;
@@ -431,7 +544,8 @@ function viteAutoProxyCookie(options) {
       autoProxy = createAutoProxyCookie({
         ...autoProxyOptions,
         debug: options.debug ?? false,
-        autoRestart: options.autoRestart ?? true
+        autoRestart: options.autoRestart ?? true,
+        isDev
       });
       try {
         await autoProxy.setup(server);
@@ -450,7 +564,7 @@ function viteAutoProxyCookie(options) {
 
 // src/proxy/vite-cookie-plugin.ts
 function viteDevProxyCookie(options) {
-  const { cookieFile, debug = false, onCookieChange } = options;
+  const { cookieFile, debug = false, onCookieChange, watch = "auto", isDev } = options;
   let watcher = null;
   let currentCookie = "";
   const cookieReader = new CookieReader({ cookieFile });
@@ -474,17 +588,30 @@ function viteDevProxyCookie(options) {
       } else {
         console.warn("[vite-dev-proxy-cookie] Could not access middleware stack, cookie injection disabled");
       }
-      watcher = watchCookieFile(
-        cookieFile,
-        (newCookie) => {
-          currentCookie = newCookie;
-          onCookieChange?.(newCookie);
-          console.log("[vite-dev-proxy-cookie] Cookie changed, please restart server for full effect");
-        },
-        (error) => {
-          console.error("[vite-dev-proxy-cookie] Watch error:", error.message);
+      let shouldWatch;
+      if (isDev !== void 0) {
+        shouldWatch = isDev;
+        if (debug) {
+          console.log(`[vite-dev-proxy-cookie] isDev=${isDev}, ${shouldWatch ? "enabling" : "disabling"} watch`);
         }
-      );
+      } else {
+        shouldWatch = shouldEnableWatch(watch, [], debug, "[vite-dev-proxy-cookie]");
+      }
+      if (shouldWatch) {
+        watcher = watchCookieFile(
+          cookieFile,
+          (newCookie) => {
+            currentCookie = newCookie;
+            onCookieChange?.(newCookie);
+            console.log("[vite-dev-proxy-cookie] Cookie changed, please restart server for full effect");
+          },
+          (error) => {
+            console.error("[vite-dev-proxy-cookie] Watch error:", error.message);
+          }
+        );
+      } else if (debug) {
+        console.log("[vite-dev-proxy-cookie] File watch disabled");
+      }
     },
     closeBundle() {
       watcher?.stop();
@@ -527,9 +654,23 @@ function createVueProxyConfig(target, options = {}) {
   return config;
 }
 function createFileCookieGetter(cookieFile, options = {}) {
-  const { watch = true, debug = false } = options;
+  const {
+    watch = "auto",
+    debug = false,
+    productionEnvs = [],
+    isDev
+  } = options;
   const reader = new CookieReader({ cookieFile: path4.resolve(cookieFile) });
-  if (watch) {
+  let shouldWatch;
+  if (isDev !== void 0) {
+    shouldWatch = isDev;
+    if (debug) {
+      console.log(`[CookieFile] isDev=${isDev}, ${shouldWatch ? "enabling" : "disabling"} watch`);
+    }
+  } else {
+    shouldWatch = shouldEnableWatch(watch, productionEnvs, debug, "[CookieFile]");
+  }
+  if (shouldWatch) {
     watchCookieFile(
       path4.resolve(cookieFile),
       (newCookie) => {
@@ -541,6 +682,8 @@ function createFileCookieGetter(cookieFile, options = {}) {
         console.error("[CookieFile] Watch error:", error.message);
       }
     );
+  } else if (debug) {
+    console.log("[CookieFile] File watch disabled");
   }
   return () => reader.readCookie();
 }
@@ -602,6 +745,8 @@ function detectViteVersion() {
 function createDevProxyCookie(options) {
   const {
     mode = "auto",
+    watch = "auto",
+    isDev,
     ...restOptions
   } = options;
   const version = detectViteVersion();
@@ -612,7 +757,9 @@ function createDevProxyCookie(options) {
     return viteDevProxyCookie({
       cookieFile: options.cookieFile,
       debug: options.debug,
-      onCookieChange: options.onCookieChange
+      onCookieChange: options.onCookieChange,
+      watch,
+      isDev
     });
   }
   const pluginOptions = {
@@ -643,8 +790,11 @@ export {
   createDevProxyCookie,
   createFileCookieGetter,
   createVueProxyConfig,
+  detectProductionEnvironment,
   getViteMajorVersion,
   getViteVersion,
+  isProductionValue,
+  shouldEnableWatch,
   viteAutoProxyCookie,
   viteDevProxyCookie,
   watchCookieFile

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gylautorun/dev-proxy-cookie",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "开发环境代理Cookie注入工具，支持文件监听自动重载和自动代理",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/proxy/core.ts

@@ -60,6 +60,15 @@ export interface AutoProxyCookieOptions {
   cookiePathRewrite?: false | string | { [oldPath: string]: string };
   headers?: { [header: string]: string };
   hooks?: ProxyHooks;
+  /**
+   * 是否为开发环境（优先级最高）
+   * 设置此参数后，将直接决定是否启用文件监听：
+   * - true: 启用监听（开发模式）
+   * - false: 禁用监听（生产模式）
+   * 
+   * 使用示例: isDev: process.env.NODE_ENV === 'development'
+   */
+  isDev?: boolean;
 }
 
 export class AutoProxyCookie {
@@ -368,13 +377,34 @@ export class AutoProxyCookie {
   }
 
   private startFileWatch(): void {
-    this.watcher = watchCookieFile(
-      this.options.cookieFile,
-      this.handleCookieChange,
-      (error) => {
-        this.log('error', '[AutoProxyCookie] File watch error:', error.message);
+    // 判断是否应该启用监听
+    // isDev 参数优先级最高
+    let shouldWatch: boolean;
+    
+    if (this.options.isDev !== undefined) {
+      shouldWatch = this.options.isDev;
+      if (this.options.debug) {
+        console.log(`[AutoProxyCookie] isDev=${this.options.isDev}, ${shouldWatch ? 'enabling' : 'disabling'} watch`);
       }
-    );
+    } else {
+      // 默认启用监听（因为 AutoProxyCookie 主要用于开发环境）
+      shouldWatch = true;
+      if (this.options.debug) {
+        console.log('[AutoProxyCookie] Default behavior: enabling watch (dev mode)');
+      }
+    }
+    
+    if (shouldWatch) {
+      this.watcher = watchCookieFile(
+        this.options.cookieFile,
+        this.handleCookieChange,
+        (error) => {
+          this.log('error', '[AutoProxyCookie] File watch error:', error.message);
+        }
+      );
+    } else if (this.options.debug) {
+      console.log('[AutoProxyCookie] File watch disabled');
+    }
   }
 
   stop(): void {

package/src/proxy/vite-adapter.ts

@@ -32,11 +32,30 @@ export interface UnifiedProxyCookieOptions {
   includePaths?: string[];
   onCookieChange?: (cookie: string) => void;
   mode?: 'auto' | 'proxy' | 'cookie';
+  /**
+   * 是否监听文件变化
+   * - true: 始终监听
+   * - false: 从不监听
+   * - 'auto': 根据环境自动判断（默认）
+   * @default 'auto'
+   */
+  watch?: boolean | 'auto';
+  /**
+   * 是否为开发环境（优先级最高）
+   * 设置此参数后，将直接决定是否启用文件监听：
+   * - true: 启用监听（开发模式）
+   * - false: 禁用监听（生产模式）
+   * 
+   * 使用示例: isDev: process.env.NODE_ENV === 'development'
+   */
+  isDev?: boolean;
 }
 
 export function createDevProxyCookie(options: UnifiedProxyCookieOptions): Plugin {
   const {
     mode = 'auto',
+    watch = 'auto',
+    isDev,
     ...restOptions
   } = options;
 
@@ -51,6 +70,8 @@ export function createDevProxyCookie(options: UnifiedProxyCookieOptions): Plugin
       cookieFile: options.cookieFile,
       debug: options.debug,
       onCookieChange: options.onCookieChange,
+      watch,
+      isDev,
     });
   }
 

package/src/proxy/vite-cookie-plugin.ts

@@ -1,15 +1,32 @@
 import type { Plugin, ViteDevServer } from 'vite';
-import { CookieReader, CookieWatcher, watchCookieFile } from '../utils';
+import { CookieReader, watchCookieFile, shouldEnableWatch } from '../utils';
 
 export interface ViteDevProxyCookieOptions {
   cookieFile: string;
   debug?: boolean;
   onCookieChange?: (cookie: string) => void;
+  /**
+   * 是否监听文件变化
+   * - true: 始终监听
+   * - false: 从不监听
+   * - 'auto': 根据环境自动判断（默认）
+   * @default 'auto'
+   */
+  watch?: boolean | 'auto';
+  /**
+   * 是否为开发环境（优先级最高）
+   * 设置此参数后，将直接决定是否启用文件监听：
+   * - true: 启用监听（开发模式）
+   * - false: 禁用监听（生产模式）
+   * 
+   * 使用示例: isDev: process.env.NODE_ENV === 'development'
+   */
+  isDev?: boolean;
 }
 
 export function viteDevProxyCookie(options: ViteDevProxyCookieOptions): Plugin {
-  const { cookieFile, debug = false, onCookieChange } = options;
-  let watcher: CookieWatcher | null = null;
+  const { cookieFile, debug = false, onCookieChange, watch = 'auto', isDev } = options;
+  let watcher: any = null;
   let currentCookie: string = '';
 
   const cookieReader = new CookieReader({ cookieFile });
@@ -40,21 +57,38 @@ export function viteDevProxyCookie(options: ViteDevProxyCookieOptions): Plugin {
         console.warn('[vite-dev-proxy-cookie] Could not access middleware stack, cookie injection disabled');
       }
 
-      watcher = watchCookieFile(
-        cookieFile,
-        (newCookie) => {
-          currentCookie = newCookie;
-          onCookieChange?.(newCookie);
-          console.log('[vite-dev-proxy-cookie] Cookie changed, please restart server for full effect');
-        },
-        (error) => {
-          console.error('[vite-dev-proxy-cookie] Watch error:', error.message);
+      // 判断是否应该启用监听
+      // isDev 参数优先级最高
+      let shouldWatch: boolean;
+      
+      if (isDev !== undefined) {
+        shouldWatch = isDev;
+        if (debug) {
+          console.log(`[vite-dev-proxy-cookie] isDev=${isDev}, ${shouldWatch ? 'enabling' : 'disabling'} watch`);
         }
-      );
+      } else {
+        shouldWatch = shouldEnableWatch(watch, [], debug, '[vite-dev-proxy-cookie]');
+      }
+      
+      if (shouldWatch) {
+        watcher = watchCookieFile(
+          cookieFile,
+          (newCookie) => {
+            currentCookie = newCookie;
+            onCookieChange?.(newCookie);
+            console.log('[vite-dev-proxy-cookie] Cookie changed, please restart server for full effect');
+          },
+          (error) => {
+            console.error('[vite-dev-proxy-cookie] Watch error:', error.message);
+          }
+        );
+      } else if (debug) {
+        console.log('[vite-dev-proxy-cookie] File watch disabled');
+      }
     },
 
     closeBundle() {
       watcher?.stop();
     },
   };
-}
+}

package/src/proxy/vite-plugin.ts

@@ -3,6 +3,15 @@ import { AutoProxyCookie, createAutoProxyCookie, type AutoProxyCookieOptions } f
 
 export interface ViteAutoProxyCookiePluginOptions extends AutoProxyCookieOptions {
   name?: string;
+  /**
+   * 是否为开发环境（优先级最高）
+   * 设置此参数后，将直接决定是否启用文件监听：
+   * - true: 启用监听（开发模式）
+   * - false: 禁用监听（生产模式）
+   * 
+   * 使用示例: isDev: process.env.NODE_ENV === 'development'
+   */
+  isDev?: boolean;
 }
 
 function getHttpServer(server: ViteDevServer): any {
@@ -18,6 +27,7 @@ function getHttpServer(server: ViteDevServer): any {
 export function viteAutoProxyCookie(options: ViteAutoProxyCookiePluginOptions): Plugin {
   const {
     name = 'vite-auto-proxy-cookie',
+    isDev,
     ...autoProxyOptions
   } = options;
 
@@ -32,6 +42,7 @@ export function viteAutoProxyCookie(options: ViteAutoProxyCookiePluginOptions):
         ...autoProxyOptions,
         debug: options.debug ?? false,
         autoRestart: options.autoRestart ?? true,
+        isDev,
       });
 
       try {

package/src/proxy/vue-proxy-config.ts

@@ -1,18 +1,37 @@
 import type { IncomingMessage } from 'http';
 import * as path from 'path';
-import { CookieReader, watchCookieFile } from '../utils';
+import { CookieReader, watchCookieFile, shouldEnableWatch } from '../utils';
 import { applyDevCookieHeader } from './apply-dev-cookie-header';
 
 /** Options for {@link createFileCookieGetter}. */
 export interface CreateFileCookieGetterOptions {
   /**
-   * Watch the file for logging when it changes. Cookie value is always read from disk on each proxy request,
-   * so you do not need a dev-server restart when this is false.
-   * @default true
+   * 是否监听文件变化
+   * - true: 始终监听
+   * - false: 从不监听
+   * - 'auto': 根据环境自动判断（默认）
+   * 
+   * Cookie 值每次代理请求时都会从磁盘读取，因此即使 watch 为 false，
+   * 修改 cookie 文件后也不需要重启开发服务器。
+   * @default 'auto'
    */
-  watch?: boolean;
+  watch?: boolean | 'auto';
   /** Log when the cookie file changes (only if `watch` is true). @default false */
   debug?: boolean;
+  /** 
+   * 自定义生产环境变量名称列表，用于判断是否禁用监听
+   * 例如: ['MY_APP_ENV', 'BUILD_TYPE']
+   */
+  productionEnvs?: string[];
+  /**
+   * 是否为开发环境（优先级最高）
+   * 设置此参数后，将直接决定是否启用文件监听：
+   * - true: 启用监听（开发模式）
+   * - false: 禁用监听（生产模式）
+   * 
+   * 使用示例: isDev: process.env.NODE_ENV === 'development'
+   */
+  isDev?: boolean;
 }
 
 export interface VueProxyConfigOptions {
@@ -78,10 +97,30 @@ export function createFileCookieGetter(
   cookieFile: string,
   options: CreateFileCookieGetterOptions = {}
 ): () => string {
-  const { watch = true, debug = false } = options;
+  const { 
+    watch = 'auto', 
+    debug = false,
+    productionEnvs = [],
+    isDev 
+  } = options;
   const reader = new CookieReader({ cookieFile: path.resolve(cookieFile) });
 
-  if (watch) {
+  // 判断是否应该启用监听
+  // isDev 参数优先级最高，直接决定是否启用监听
+  let shouldWatch: boolean;
+  
+  if (isDev !== undefined) {
+    // 用户显式设置了 isDev 参数
+    shouldWatch = isDev;
+    if (debug) {
+      console.log(`[CookieFile] isDev=${isDev}, ${shouldWatch ? 'enabling' : 'disabling'} watch`);
+    }
+  } else {
+    // 使用智能环境检测
+    shouldWatch = shouldEnableWatch(watch, productionEnvs, debug, '[CookieFile]');
+  }
+  
+  if (shouldWatch) {
     watchCookieFile(
       path.resolve(cookieFile),
       (newCookie) => {
@@ -93,6 +132,8 @@ export function createFileCookieGetter(
         console.error('[CookieFile] Watch error:', error.message);
       }
     );
+  } else if (debug) {
+    console.log('[CookieFile] File watch disabled');
   }
 
   return () => reader.readCookie();