@djangocfg/monitor 2.1.237 → 2.1.239

package/dist/index.d.cts

@@ -85,6 +85,10 @@ interface MonitorConfig {
     captureJsErrors?: boolean;
     /** Log debug info to console. Default: false */
     debug?: boolean;
+    /** Deduplication TTL in ms for per-capture-source filtering. Default: 5000 */
+    dedupeTtl?: number;
+    /** Deduplication TTL in ms for the global store-level filter (cross-source). Default: 30000 */
+    dedupeStoreTtl?: number;
 }
 interface ServerMonitorConfig {
     /** Base URL for the django-cfg backend (absolute URL required on server) */

package/dist/index.d.ts

@@ -85,6 +85,10 @@ interface MonitorConfig {
     captureJsErrors?: boolean;
     /** Log debug info to console. Default: false */
     debug?: boolean;
+    /** Deduplication TTL in ms for per-capture-source filtering. Default: 5000 */
+    dedupeTtl?: number;
+    /** Deduplication TTL in ms for the global store-level filter (cross-source). Default: 30000 */
+    dedupeStoreTtl?: number;
 }
 interface ServerMonitorConfig {
     /** Base URL for the django-cfg backend (absolute URL required on server) */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@djangocfg/monitor",
-  "version": "2.1.237",
+  "version": "2.1.239",
   "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.237",
+    "@djangocfg/typescript-config": "^2.1.239",
     "p-retry": "^6.2.0",
     "@types/node": "^24.7.2",
     "@types/react": "^19.1.0",

package/src/client/capture/console.ts

@@ -1,7 +1,7 @@
 import { computeFingerprint } from './fingerprint'
 import { getSessionId } from './session'
 import { monitorStore } from '../store'
-import { MONITOR_INGEST_PATTERN } from '../constants'
+import { MONITOR_INGEST_PATTERN, DEFAULT_DEDUPE_TTL } from '../constants'
 import { EventType, EventLevel } from '../../_api'
 import type { FrontendEventIngestRequestEventType, FrontendEventIngestRequestLevel } from '../../_api/generated/cfg_monitor/enums'
 
@@ -18,6 +18,22 @@ const typeMap: Record<ConsoleLevel, FrontendEventIngestRequestEventType> = {
 
 const ARG_MAX = 500
 
+// Dedup: skip re-sending the same console message within TTL (read from config)
+const recentConsoleFingerprints = new Map<string, number>()
+
+function isRecentConsole(fingerprint: string): boolean {
+  const ttl = monitorStore.getState().config.dedupeTtl ?? DEFAULT_DEDUPE_TTL
+  const now = Date.now()
+  const last = recentConsoleFingerprints.get(fingerprint)
+  if (last !== undefined && now - last < ttl) return true
+  recentConsoleFingerprints.set(fingerprint, now)
+  if (recentConsoleFingerprints.size > 100) {
+    const oldest = [...recentConsoleFingerprints.entries()].sort((a, b) => a[1] - b[1])[0]
+    recentConsoleFingerprints.delete(oldest[0])
+  }
+  return false
+}
+
 function stringifyArg(a: unknown): string {
   let s: string
   if (typeof a === 'string') s = a
@@ -36,6 +52,7 @@ async function captureConsoleEvent(level: ConsoleLevel, args: unknown[]) {
     if (MONITOR_INGEST_PATTERN.test(message)) return
     const url = typeof window !== 'undefined' ? window.location.href : ''
     const fingerprint = await computeFingerprint(message, '', url)
+    if (isRecentConsole(fingerprint)) return
     const { config } = monitorStore.getState()
     monitorStore.getState().push({
       event_type: typeMap[level],

package/src/client/capture/js-errors.ts

@@ -1,7 +1,7 @@
 import { computeFingerprint } from './fingerprint'
 import { getSessionId } from './session'
 import { monitorStore } from '../store'
-import { MONITOR_INGEST_PATTERN } from '../constants'
+import { MONITOR_INGEST_PATTERN, DEFAULT_DEDUPE_TTL } from '../constants'
 import { EventType, EventLevel } from '../../_api'
 
 const MSG_MAX = 2000
@@ -29,17 +29,16 @@ function isHydrationNoise(msg: string): boolean {
   return HYDRATION_NOISE.some((p) => p.test(msg))
 }
 
-// Client-side dedup: skip re-sending the same fingerprint within CLIENT_DEDUP_TTL ms.
+// Client-side dedup: skip re-sending the same fingerprint within dedupeTtl.
 // Protects against crash-loop pages flooding the ingest endpoint.
-const CLIENT_DEDUP_TTL = 5 * 60 * 1000 // 5 minutes
 const recentFingerprints = new Map<string, number>()
 
 function isRecentlySent(fingerprint: string): boolean {
+  const ttl = monitorStore.getState().config.dedupeTtl ?? DEFAULT_DEDUPE_TTL
   const now = Date.now()
   const last = recentFingerprints.get(fingerprint)
-  if (last !== undefined && now - last < CLIENT_DEDUP_TTL) return true
+  if (last !== undefined && now - last < ttl) return true
   recentFingerprints.set(fingerprint, now)
-  // Cap map size to avoid memory growth — evict oldest entry when over limit
   if (recentFingerprints.size > 100) {
     const oldest = [...recentFingerprints.entries()].sort((a, b) => a[1] - b[1])[0]
     recentFingerprints.delete(oldest[0])

package/src/client/capture/network.ts

@@ -1,7 +1,25 @@
 import { getSessionId } from './session'
 import { monitorStore } from '../store'
+import { DEFAULT_DEDUPE_TTL } from '../constants'
 import { EventType, EventLevel } from '../../_api'
 
+// Dedup: skip re-sending the same network error within TTL (read from config)
+const recentNetworkErrors = new Map<string, number>()
+
+function isRecentNetwork(key: string): boolean {
+  const ttl = monitorStore.getState().config.dedupeTtl ?? DEFAULT_DEDUPE_TTL
+  const now = Date.now()
+  const last = recentNetworkErrors.get(key)
+  if (last !== undefined && now - last < ttl) return true
+  recentNetworkErrors.set(key, now)
+  if (recentNetworkErrors.size > 100) {
+    for (const [k, ts] of recentNetworkErrors) {
+      if (now - ts > ttl) recentNetworkErrors.delete(k)
+    }
+  }
+  return false
+}
+
 export async function monitoredFetch(
   input: RequestInfo | URL,
   init?: RequestInit,
@@ -12,6 +30,8 @@ export async function monitoredFetch(
   try {
     const response = await fetch(input, init)
     if (!response.ok) {
+      const netKey = `${response.status}:${method}:${url}`
+      if (isRecentNetwork(netKey)) return response
       const { config } = monitorStore.getState()
       monitorStore.getState().push({
         event_type: EventType.NETWORK_ERROR,
@@ -29,19 +49,23 @@ export async function monitoredFetch(
     }
     return response
   } catch (err) {
-    const { config } = monitorStore.getState()
-    monitorStore.getState().push({
-      event_type: EventType.NETWORK_ERROR,
-      level: EventLevel.ERROR,
-      message: err instanceof Error ? err.message : `Network error — ${method} ${url}`,
-      url: typeof window !== 'undefined' ? window.location.href : '',
-      http_method: method,
-      http_url: url,
-      session_id: getSessionId(),
-      user_agent: typeof navigator !== 'undefined' ? navigator.userAgent : '',
-      project_name: config.project,
-      environment: config.environment,
-    })
+    const errMsg = err instanceof Error ? err.message : 'network-error'
+    const netKey = `err:${errMsg.slice(0, 50)}:${method}:${url}`
+    if (!isRecentNetwork(netKey)) {
+      const { config } = monitorStore.getState()
+      monitorStore.getState().push({
+        event_type: EventType.NETWORK_ERROR,
+        level: EventLevel.ERROR,
+        message: err instanceof Error ? err.message : `Network error — ${method} ${url}`,
+        url: typeof window !== 'undefined' ? window.location.href : '',
+        http_method: method,
+        http_url: url,
+        session_id: getSessionId(),
+        user_agent: typeof navigator !== 'undefined' ? navigator.userAgent : '',
+        project_name: config.project,
+        environment: config.environment,
+      })
+    }
     throw err
   }
 }

package/src/client/capture/validation.ts

@@ -1,7 +1,25 @@
 import { getSessionId } from './session'
 import { monitorStore } from '../store'
+import { DEFAULT_DEDUPE_TTL } from '../constants'
 import { EventType, EventLevel } from '../../_api'
 
+// Dedup: skip re-sending the same validation error within TTL (read from config)
+const recentValidations = new Map<string, number>()
+
+function isRecentValidation(key: string): boolean {
+  const ttl = monitorStore.getState().config.dedupeTtl ?? DEFAULT_DEDUPE_TTL
+  const now = Date.now()
+  const last = recentValidations.get(key)
+  if (last !== undefined && now - last < ttl) return true
+  recentValidations.set(key, now)
+  if (recentValidations.size > 50) {
+    for (const [k, ts] of recentValidations) {
+      if (now - ts > ttl) recentValidations.delete(k)
+    }
+  }
+  return false
+}
+
 interface ValidationErrorDetail {
   operation: string
   path: string
@@ -16,6 +34,8 @@ export function installValidationCapture(): () => void {
     if (!(event instanceof CustomEvent)) return
     try {
       const detail = event.detail as ValidationErrorDetail
+      const dedupeKey = `${detail.operation}:${detail.path}:${detail.method}`
+      if (isRecentValidation(dedupeKey)) return
       const { config } = monitorStore.getState()
       const rawMsg = `Zod validation error in ${detail.operation}: ${detail.error?.message ?? 'unknown'}`
       monitorStore.getState().push({

package/src/client/constants.ts

@@ -5,3 +5,9 @@
 
 /** Matches any request to the monitor ingest endpoint */
 export const MONITOR_INGEST_PATTERN = /cfg\/monitor\/ingest/
+
+/** Default deduplication TTL for per-capture-source filtering (ms) */
+export const DEFAULT_DEDUPE_TTL = 5_000
+
+/** Default deduplication TTL for global store-level filtering (ms) */
+export const DEFAULT_DEDUPE_STORE_TTL = 30_000

package/src/client/store/index.ts

@@ -2,11 +2,36 @@ import { createStore } from 'zustand/vanilla'
 import type { MonitorEvent, MonitorConfig } from '../../types'
 import { sendBatch } from '../transport/ingest'
 import { MONITOR_VERSION } from '../utils/env'
+import { DEFAULT_DEDUPE_STORE_TTL } from '../constants'
 
 // Circuit breaker: pause flushing after N consecutive transport failures
 const CIRCUIT_BREAKER_THRESHOLD = 3
 const CIRCUIT_BREAKER_COOLDOWN_MS = 60_000 // 1 minute
 
+// Global deduplication: skip pushing identical events within this window.
+// Protects against multiple capture sources (js-errors, console, ErrorTrackingProvider)
+// all firing for the same underlying error.
+const STORE_DEDUP_MAX = 200
+const _recentPushKeys = new Map<string, number>()
+
+function _pushDedupeKey(event: MonitorEvent): string {
+  const msg = (event.message ?? '').slice(0, 100)
+  return `${event.event_type}:${event.level}:${msg}:${event.http_url ?? event.url ?? ''}`
+}
+
+function _isRecentPush(key: string, ttl: number): boolean {
+  const now = Date.now()
+  const last = _recentPushKeys.get(key)
+  if (last !== undefined && now - last < ttl) return true
+  _recentPushKeys.set(key, now)
+  if (_recentPushKeys.size > STORE_DEDUP_MAX) {
+    for (const [k, ts] of _recentPushKeys) {
+      if (now - ts > ttl) _recentPushKeys.delete(k)
+    }
+  }
+  return false
+}
+
 interface MonitorState {
   config: MonitorConfig
   buffer: MonitorEvent[]
@@ -26,7 +51,11 @@ export const monitorStore = createStore<MonitorState>((set, get) => ({
   _pausedUntil: 0,
 
   push(event) {
+    // Global dedup: skip if an identical event was pushed recently
     const { config, buffer } = get()
+    const storeTtl = config.dedupeStoreTtl ?? DEFAULT_DEDUPE_STORE_TTL
+    const dedupeKey = _pushDedupeKey(event)
+    if (_isRecentPush(dedupeKey, storeTtl)) return
     const maxSize = config.maxBufferSize ?? 20
     const sanitized: MonitorEvent = {
       build_id: event.build_id ?? config.buildId ?? `sdk:${MONITOR_VERSION}`,

package/src/types/config.ts

@@ -21,6 +21,10 @@ export interface MonitorConfig {
   captureJsErrors?: boolean
   /** Log debug info to console. Default: false */
   debug?: boolean
+  /** Deduplication TTL in ms for per-capture-source filtering. Default: 5000 */
+  dedupeTtl?: number
+  /** Deduplication TTL in ms for the global store-level filter (cross-source). Default: 30000 */
+  dedupeStoreTtl?: number
 }
 
 export interface ServerMonitorConfig {