@djangocfg/monitor 2.1.228 → 2.1.230

package/dist/client.d.cts

@@ -150,6 +150,20 @@ interface MonitorState {
 }
 declare const monitorStore: zustand_vanilla.StoreApi<MonitorState>;
 
+declare function useDebugMode(): boolean;
+
+/**
+ * Environment utilities.
+ *
+ * Use these constants instead of inline process.env.NODE_ENV checks.
+ * Webpack/esbuild replaces process.env.NODE_ENV statically at build time,
+ * so these are zero-cost — they tree-shake correctly in both client and server bundles.
+ */
+/** True only in `next dev` / jest / vitest */
+declare const isDevelopment: boolean;
+/** True in production builds and test environments */
+declare const isProduction: boolean;
+
 /**
  * @djangocfg/monitor/client
  *
@@ -178,4 +192,4 @@ declare const FrontendMonitor: {
     destroy(): void;
 };
 
-export { FrontendEventIngestRequestLevel as EventLevel, FrontendEventIngestRequestEventType as EventType, FrontendMonitor, type MonitorConfig, type FrontendEventIngestRequest as MonitorEvent, MonitorProvider, type MonitorProviderProps, type WindowMonitorAPI, getSessionId, initWindowMonitor, monitorStore, monitoredFetch };
+export { FrontendEventIngestRequestLevel as EventLevel, FrontendEventIngestRequestEventType as EventType, FrontendMonitor, type MonitorConfig, type FrontendEventIngestRequest as MonitorEvent, MonitorProvider, type MonitorProviderProps, type WindowMonitorAPI, getSessionId, initWindowMonitor, isDevelopment, isProduction, monitorStore, monitoredFetch, useDebugMode };

package/dist/client.d.ts

@@ -150,6 +150,20 @@ interface MonitorState {
 }
 declare const monitorStore: zustand_vanilla.StoreApi<MonitorState>;
 
+declare function useDebugMode(): boolean;
+
+/**
+ * Environment utilities.
+ *
+ * Use these constants instead of inline process.env.NODE_ENV checks.
+ * Webpack/esbuild replaces process.env.NODE_ENV statically at build time,
+ * so these are zero-cost — they tree-shake correctly in both client and server bundles.
+ */
+/** True only in `next dev` / jest / vitest */
+declare const isDevelopment: boolean;
+/** True in production builds and test environments */
+declare const isProduction: boolean;
+
 /**
  * @djangocfg/monitor/client
  *
@@ -178,4 +192,4 @@ declare const FrontendMonitor: {
     destroy(): void;
 };
 
-export { FrontendEventIngestRequestLevel as EventLevel, FrontendEventIngestRequestEventType as EventType, FrontendMonitor, type MonitorConfig, type FrontendEventIngestRequest as MonitorEvent, MonitorProvider, type MonitorProviderProps, type WindowMonitorAPI, getSessionId, initWindowMonitor, monitorStore, monitoredFetch };
+export { FrontendEventIngestRequestLevel as EventLevel, FrontendEventIngestRequestEventType as EventType, FrontendMonitor, type MonitorConfig, type FrontendEventIngestRequest as MonitorEvent, MonitorProvider, type MonitorProviderProps, type WindowMonitorAPI, getSessionId, initWindowMonitor, isDevelopment, isProduction, monitorStore, monitoredFetch, useDebugMode };

package/dist/client.mjs

@@ -1730,6 +1730,57 @@ function MonitorProvider({ children, ...config }) {
 }
 __name(MonitorProvider, "MonitorProvider");
 
+// src/client/hooks/useDebugMode.ts
+import { useEffect as useEffect2, useState } from "react";
+
+// src/client/utils/env.ts
+var isDevelopment = true;
+var isProduction = false;
+
+// src/client/hooks/useDebugMode.ts
+var LS_KEY = "__debug_mode__";
+function readFromStorage() {
+  try {
+    return localStorage.getItem(LS_KEY) === "1";
+  } catch {
+    return false;
+  }
+}
+__name(readFromStorage, "readFromStorage");
+function persistToStorage() {
+  try {
+    localStorage.setItem(LS_KEY, "1");
+  } catch {
+  }
+}
+__name(persistToStorage, "persistToStorage");
+function consumeDebugParam() {
+  if (typeof window === "undefined") return false;
+  const params = new URLSearchParams(window.location.search);
+  const value = params.get("debug");
+  if (!value) return false;
+  persistToStorage();
+  params.delete("debug");
+  const newUrl = `${window.location.pathname}${params.toString() ? `?${params.toString()}` : ""}${window.location.hash}`;
+  window.history.replaceState(null, "", newUrl);
+  return true;
+}
+__name(consumeDebugParam, "consumeDebugParam");
+function useDebugMode() {
+  if (isDevelopment) return true;
+  const [isDebug, setIsDebug] = useState(false);
+  useEffect2(() => {
+    const fromUrl = consumeDebugParam();
+    if (fromUrl) {
+      setIsDebug(true);
+      return;
+    }
+    setIsDebug(readFromStorage());
+  }, []);
+  return isDebug;
+}
+__name(useDebugMode, "useDebugMode");
+
 // src/client/index.ts
 var flushInterval = null;
 var cleanupFns = [];
@@ -1774,7 +1825,10 @@ export {
   MonitorProvider,
   getSessionId,
   initWindowMonitor,
+  isDevelopment,
+  isProduction,
   monitorStore,
-  monitoredFetch
+  monitoredFetch,
+  useDebugMode
 };
 //# sourceMappingURL=client.mjs.map