refactor: debugLog for frontend (#5587)

src/utils/debug.ts

@@ -0,0 +1,64 @@
+const envVarValue = (import.meta.env.VITE_ENABLE_DEBUG_LOGS ?? "").toString();
+
+let runtimeOverride: boolean | null = null;
+
+const parseStringFlag = (value: string) => {
+  if (!value) return false;
+  const normalized = value.trim().toLowerCase();
+  return normalized === "1" || normalized === "true" || normalized === "yes";
+};
+
+let cachedDebugEnabled: boolean | null = null;
+
+const computeDebugEnabled = () => {
+  if (import.meta.env.DEV) {
+    return true;
+  }
+
+  if (parseStringFlag(envVarValue)) {
+    return true;
+  }
+
+  if (typeof window !== "undefined") {
+    const globalFlag = (window as any).__VERGE_ENABLE_DEBUG_LOGS__;
+    if (typeof globalFlag === "boolean") {
+      return globalFlag;
+    }
+
+    try {
+      const stored = window.localStorage?.getItem("VERGE_DEBUG_LOGS");
+      if (stored) {
+        return parseStringFlag(stored);
+      }
+    } catch {
+      // ignore storage access errors
+    }
+  }
+
+  return false;
+};
+
+const isEnvDebugEnabled = () => {
+  if (runtimeOverride !== null) {
+    return runtimeOverride;
+  }
+
+  if (cachedDebugEnabled !== null) {
+    return cachedDebugEnabled;
+  }
+
+  cachedDebugEnabled = computeDebugEnabled();
+  return cachedDebugEnabled;
+};
+
+export const setDebugLoggingEnabled = (enabled: boolean) => {
+  runtimeOverride = enabled;
+  cachedDebugEnabled = enabled;
+};
+
+export const isDebugLoggingEnabled = () => isEnvDebugEnabled();
+
+export const debugLog = (...args: any[]) => {
+  if (!isEnvDebugEnabled()) return;
+  console.log(...args);
+};