@djangocfg/monitor 2.1.230 → 2.1.231

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@djangocfg/monitor",
-  "version": "2.1.230",
+  "version": "2.1.231",
   "description": "Browser error and event monitoring SDK for django-cfg backends. Captures JS errors, network failures, console logs, and performance metrics.",
   "keywords": [
     "django",
@@ -83,7 +83,7 @@
     }
   },
   "devDependencies": {
-    "@djangocfg/typescript-config": "^2.1.230",
+    "@djangocfg/typescript-config": "^2.1.231",
     "p-retry": "^6.2.0",
     "@types/node": "^24.7.2",
     "@types/react": "^19.1.0",

package/src/client/hooks/useDebugMode.ts

@@ -7,6 +7,7 @@
  * - development: always true (no localStorage needed)
  * - production:
  *   - ?debug=1 in URL → persist to localStorage, remove param from URL
+ *   - ?debug=0 in URL → clear localStorage, disable debug mode
  *   - localStorage.__debug_mode__ === '1' → true
  *   - otherwise → false
  *
@@ -35,18 +36,31 @@ function persistToStorage(): void {
   }
 }
 
-function consumeDebugParam(): boolean {
-  if (typeof window === 'undefined') return false
+function clearFromStorage(): void {
+  try {
+    localStorage.removeItem(LS_KEY)
+  } catch {
+    // ignore
+  }
+}
+
+function consumeDebugParam(): boolean | null {
+  if (typeof window === 'undefined') return null
   const params = new URLSearchParams(window.location.search)
   const value = params.get('debug')
-  if (!value) return false
+  if (value === null) return null
 
-  persistToStorage()
+  if (value === '1') {
+    persistToStorage()
+  } else {
+    // ?debug=0 or any other value → explicitly disable and clear stored flag
+    clearFromStorage()
+  }
 
   params.delete('debug')
   const newUrl = `${window.location.pathname}${params.toString() ? `?${params.toString()}` : ''}${window.location.hash}`
   window.history.replaceState(null, '', newUrl)
-  return true
+  return value === '1'
 }
 
 export function useDebugMode(): boolean {
@@ -59,8 +73,8 @@ export function useDebugMode(): boolean {
   // eslint-disable-next-line react-hooks/rules-of-hooks
   useEffect(() => {
     const fromUrl = consumeDebugParam()
-    if (fromUrl) {
-      setIsDebug(true)
+    if (fromUrl !== null) {
+      setIsDebug(fromUrl)
       return
     }
     setIsDebug(readFromStorage())

package/src/client/index.ts

@@ -37,7 +37,7 @@ export { initWindowMonitor } from './window'
 export type { WindowMonitorAPI } from './window'
 export { monitorStore } from './store'
 export { useDebugMode } from './hooks/useDebugMode'
-export { isDevelopment, isProduction } from './utils/env'
+export { isDevelopment, isProduction, MONITOR_VERSION } from './utils/env'
 
 let flushInterval: ReturnType<typeof setInterval> | null = null
 const cleanupFns: Array<() => void> = []

package/src/client/store/index.ts

@@ -1,6 +1,7 @@
 import { createStore } from 'zustand/vanilla'
 import type { MonitorEvent, MonitorConfig } from '../../types'
 import { sendBatch } from '../transport/ingest'
+import { MONITOR_VERSION } from '../utils/env'
 
 // Circuit breaker: pause flushing after N consecutive transport failures
 const CIRCUIT_BREAKER_THRESHOLD = 3
@@ -28,6 +29,7 @@ export const monitorStore = createStore<MonitorState>((set, get) => ({
     const { config, buffer } = get()
     const maxSize = config.maxBufferSize ?? 20
     const sanitized: MonitorEvent = {
+      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

package/src/client/utils/env.ts

@@ -11,3 +11,6 @@ export const isDevelopment = process.env.NODE_ENV === 'development'
 
 /** True in production builds and test environments */
 export const isProduction = process.env.NODE_ENV !== 'development'
+
+/** Package version — injected at build time via tsup define, falls back to package.json value */
+export const MONITOR_VERSION: string = (process.env.MONITOR_VERSION as string) ?? '2.1.230'

package/src/client/window.ts

@@ -16,6 +16,7 @@
 import { monitorStore } from './store'
 import { EventType, EventLevel } from '../_api'
 import { getSessionId } from './capture/session'
+import { MONITOR_VERSION } from './utils/env'
 import type { MonitorEvent } from '../types'
 
 export interface WindowMonitorAPI {
@@ -105,6 +106,8 @@ export function initWindowMonitor(): void {
     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)