@djangocfg/monitor 2.1.229 → 2.1.231

package/dist/client.d.cts

@@ -150,6 +150,22 @@ 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;
+/** Package version — injected at build time via tsup define, falls back to package.json value */
+declare const MONITOR_VERSION: string;
+
 /**
  * @djangocfg/monitor/client
  *
@@ -178,4 +194,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, MONITOR_VERSION, 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,22 @@ 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;
+/** Package version — injected at build time via tsup define, falls back to package.json value */
+declare const MONITOR_VERSION: string;
+
 /**
  * @djangocfg/monitor/client
  *
@@ -178,4 +194,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, MONITOR_VERSION, type MonitorConfig, type FrontendEventIngestRequest as MonitorEvent, MonitorProvider, type MonitorProviderProps, type WindowMonitorAPI, getSessionId, initWindowMonitor, isDevelopment, isProduction, monitorStore, monitoredFetch, useDebugMode };

package/dist/client.mjs

@@ -1334,6 +1334,11 @@ async function sendBatch(batch, useBeacon = false) {
 }
 __name(sendBatch, "sendBatch");
 
+// src/client/utils/env.ts
+var isDevelopment = true;
+var isProduction = false;
+var MONITOR_VERSION = "2.1.231";
+
 // src/client/store/index.ts
 var CIRCUIT_BREAKER_THRESHOLD = 3;
 var CIRCUIT_BREAKER_COOLDOWN_MS = 6e4;
@@ -1347,6 +1352,7 @@ var monitorStore = createStore((set, get) => ({
     const { config, buffer } = get();
     const maxSize = config.maxBufferSize ?? 20;
     const sanitized = {
+      build_id: event.build_id ?? config.buildId ?? `sdk:${MONITOR_VERSION}`,
       ...event,
       // Enforce field size limits before buffering (last-resort backstop)
       message: event.message && event.message.length > 4997 ? event.message.slice(0, 4997) + "..." : event.message,
@@ -1708,6 +1714,8 @@ function initWindowMonitor() {
     status() {
       const state = monitorStore.getState();
       console.group("[monitor] status");
+      console.log("sdk version:", MONITOR_VERSION);
+      console.log("build_id:", state.config.buildId ?? `sdk:${MONITOR_VERSION}`);
       console.log("config:", state.config);
       console.log("buffer size:", state.buffer.length);
       console.log("initialized:", state.initialized);
@@ -1730,6 +1738,62 @@ function MonitorProvider({ children, ...config }) {
 }
 __name(MonitorProvider, "MonitorProvider");
 
+// src/client/hooks/useDebugMode.ts
+import { useEffect as useEffect2, useState } from "react";
+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 clearFromStorage() {
+  try {
+    localStorage.removeItem(LS_KEY);
+  } catch {
+  }
+}
+__name(clearFromStorage, "clearFromStorage");
+function consumeDebugParam() {
+  if (typeof window === "undefined") return null;
+  const params = new URLSearchParams(window.location.search);
+  const value = params.get("debug");
+  if (value === null) return null;
+  if (value === "1") {
+    persistToStorage();
+  } else {
+    clearFromStorage();
+  }
+  params.delete("debug");
+  const newUrl = `${window.location.pathname}${params.toString() ? `?${params.toString()}` : ""}${window.location.hash}`;
+  window.history.replaceState(null, "", newUrl);
+  return value === "1";
+}
+__name(consumeDebugParam, "consumeDebugParam");
+function useDebugMode() {
+  if (isDevelopment) return true;
+  const [isDebug, setIsDebug] = useState(false);
+  useEffect2(() => {
+    const fromUrl = consumeDebugParam();
+    if (fromUrl !== null) {
+      setIsDebug(fromUrl);
+      return;
+    }
+    setIsDebug(readFromStorage());
+  }, []);
+  return isDebug;
+}
+__name(useDebugMode, "useDebugMode");
+
 // src/client/index.ts
 var flushInterval = null;
 var cleanupFns = [];
@@ -1771,10 +1835,14 @@ export {
   FrontendEventIngestRequestLevel as EventLevel,
   FrontendEventIngestRequestEventType as EventType,
   FrontendMonitor,
+  MONITOR_VERSION,
   MonitorProvider,
   getSessionId,
   initWindowMonitor,
+  isDevelopment,
+  isProduction,
   monitorStore,
-  monitoredFetch
+  monitoredFetch,
+  useDebugMode
 };
 //# sourceMappingURL=client.mjs.map