@djangocfg/monitor 2.1.227 → 2.1.229

package/src/_api/generated/cfg_monitor/monitor/models.ts

@@ -3,7 +3,7 @@
 import * as Enums from "../enums";
 
 /**
- * Wraps a list of events. Enforces max batch size.
+ * Batch of up to 50 browser events.
  * 
  * Request model (no read-only fields).
  */
@@ -12,25 +12,24 @@ export interface IngestBatchRequest {
 }
 
 /**
- * Validates a single event from the browser.
+ * Single browser event payload.
  * 
  * Request model (no read-only fields).
  */
 export interface FrontendEventIngestRequest {
-  /** * `ERROR` - Error
-  * `WARNING` - Warning
-  * `INFO` - Info
-  * `PAGE_VIEW` - Page View
-  * `PERFORMANCE` - Performance
-  * `NETWORK_ERROR` - Network Error
-  * `JS_ERROR` - JS Error
-  * `CONSOLE` - Console */
+  /** * `JS_ERROR` - JS_ERROR
+  * `NETWORK_ERROR` - NETWORK_ERROR
+  * `ERROR` - ERROR
+  * `WARNING` - WARNING
+  * `PAGE_VIEW` - PAGE_VIEW
+  * `PERFORMANCE` - PERFORMANCE
+  * `CONSOLE` - CONSOLE */
   event_type: Enums.FrontendEventIngestRequestEventType;
   message: string;
-  /** * `error` - Error
-  * `warn` - Warning
-  * `info` - Info
-  * `debug` - Debug */
+  /** * `error` - error
+  * `warning` - warning
+  * `info` - info
+  * `debug` - debug */
   level?: Enums.FrontendEventIngestRequestLevel;
   stack_trace?: string;
   url?: string;
@@ -38,12 +37,11 @@ export interface FrontendEventIngestRequest {
   http_status?: number | null;
   http_method?: string;
   http_url?: string;
+  session_id?: string;
   user_agent?: string;
-  session_id?: string | null;
-  browser_fingerprint?: string;
+  build_id?: string;
+  environment?: string;
   extra?: Record<string, any>;
   project_name?: string;
-  environment?: string;
-  build_id?: string;
 }
 

package/src/_api/generated/cfg_monitor/schema.json

@@ -7,7 +7,7 @@
     "x-django-metadata": {
       "group": "cfg_monitor",
       "apps": [
-        "django_cfg_monitor"
+        "django_monitor"
       ],
       "generator": "django-client",
       "generator_version": "1.0.0"
@@ -17,7 +17,7 @@
     "/cfg/monitor/ingest/": {
       "post": {
         "operationId": "cfg_monitor_ingest_create",
-        "description": "Accepts a batch of up to 50 frontend events. No authentication required.",
+        "description": "Accepts a batch of up to 50 frontend events. No authentication required — anonymous visitors can send events.",
         "summary": "Ingest browser events",
         "tags": [
           "monitor"
@@ -58,22 +58,21 @@
     "schemas": {
       "FrontendEventIngestRequest": {
         "type": "object",
-        "description": "Validates a single event from the browser.",
+        "description": "Single browser event payload.",
         "properties": {
           "event_type": {
             "enum": [
+              "JS_ERROR",
+              "NETWORK_ERROR",
               "ERROR",
               "WARNING",
-              "INFO",
               "PAGE_VIEW",
               "PERFORMANCE",
-              "NETWORK_ERROR",
-              "JS_ERROR",
               "CONSOLE"
             ],
             "type": "string",
-            "description": "* `ERROR` - Error\n* `WARNING` - Warning\n* `INFO` - Info\n* `PAGE_VIEW` - Page View\n* `PERFORMANCE` - Performance\n* `NETWORK_ERROR` - Network Error\n* `JS_ERROR` - JS Error\n* `CONSOLE` - Console",
-            "x-spec-enum-id": "de9da4754700e7fc"
+            "description": "* `JS_ERROR` - JS_ERROR\n* `NETWORK_ERROR` - NETWORK_ERROR\n* `ERROR` - ERROR\n* `WARNING` - WARNING\n* `PAGE_VIEW` - PAGE_VIEW\n* `PERFORMANCE` - PERFORMANCE\n* `CONSOLE` - CONSOLE",
+            "x-spec-enum-id": "33f6281564c4f844"
           },
           "message": {
             "type": "string",
@@ -83,14 +82,14 @@
           "level": {
             "enum": [
               "error",
-              "warn",
+              "warning",
               "info",
               "debug"
             ],
             "type": "string",
-            "description": "* `error` - Error\n* `warn` - Warning\n* `info` - Info\n* `debug` - Debug",
-            "x-spec-enum-id": "bef029ce9fe8228d",
-            "default": "info"
+            "description": "* `error` - error\n* `warning` - warning\n* `info` - info\n* `debug` - debug",
+            "x-spec-enum-id": "00cfb519712ff1ce",
+            "default": "error"
           },
           "stack_trace": {
             "type": "string",
@@ -123,25 +122,17 @@
             "default": "",
             "maxLength": 2000
           },
-          "user_agent": {
+          "session_id": {
             "type": "string",
             "default": "",
-            "maxLength": 500
-          },
-          "session_id": {
-            "type": [
-              "string",
-              "null"
-            ],
-            "format": "uuid"
+            "maxLength": 64
           },
-          "browser_fingerprint": {
+          "user_agent": {
             "type": "string",
             "default": "",
-            "maxLength": 64
+            "maxLength": 500
           },
-          "extra": {},
-          "project_name": {
+          "build_id": {
             "type": "string",
             "default": "",
             "maxLength": 100
@@ -151,7 +142,8 @@
             "default": "",
             "maxLength": 20
           },
-          "build_id": {
+          "extra": {},
+          "project_name": {
             "type": "string",
             "default": "",
             "maxLength": 100
@@ -164,7 +156,7 @@
       },
       "IngestBatchRequest": {
         "type": "object",
-        "description": "Wraps a list of events. Enforces max batch size.",
+        "description": "Batch of up to 50 browser events.",
         "properties": {
           "events": {
             "type": "array",

package/src/client/capture/console.ts

@@ -1,13 +1,14 @@
 import { computeFingerprint } from './fingerprint'
 import { getSessionId } from './session'
 import { monitorStore } from '../store'
+import { MONITOR_INGEST_PATTERN } from '../constants'
 import { EventType, EventLevel } from '../../_api'
 import type { FrontendEventIngestRequestEventType, FrontendEventIngestRequestLevel } from '../../_api/generated/cfg_monitor/enums'
 
 type ConsoleLevel = 'warn' | 'error'
 
 const levelMap: Record<ConsoleLevel, FrontendEventIngestRequestLevel> = {
-  warn: EventLevel.WARN,
+  warn: EventLevel.WARNING,
   error: EventLevel.ERROR,
 }
 const typeMap: Record<ConsoleLevel, FrontendEventIngestRequestEventType> = {
@@ -32,6 +33,7 @@ function stringify(args: unknown[]): string {
 async function captureConsoleEvent(level: ConsoleLevel, args: unknown[]) {
   try {
     const message = stringify(args)
+    if (MONITOR_INGEST_PATTERN.test(message)) return
     const url = typeof window !== 'undefined' ? window.location.href : ''
     const fingerprint = await computeFingerprint(message, '', url)
     const { config } = monitorStore.getState()

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

@@ -1,6 +1,7 @@
 import { computeFingerprint } from './fingerprint'
 import { getSessionId } from './session'
 import { monitorStore } from '../store'
+import { MONITOR_INGEST_PATTERN } from '../constants'
 import { EventType, EventLevel } from '../../_api'
 
 const MSG_MAX = 2000
@@ -9,6 +10,10 @@ function truncate(s: string, max = MSG_MAX): string {
   return s.length > max ? s.slice(0, max - 1) + '…' : s
 }
 
+function isMonitorOwnError(msg: string, stack?: string): boolean {
+  return MONITOR_INGEST_PATTERN.test(msg) || MONITOR_INGEST_PATTERN.test(stack ?? '')
+}
+
 // Hydration mismatches caused by browser extensions (Grammarly, translators, etc.)
 // These are not application bugs — filtering them prevents alert noise.
 const HYDRATION_NOISE: RegExp[] = [
@@ -56,6 +61,7 @@ export function installJsErrorCapture(): () => void {
       const msg = truncate(typeof message === 'string' ? message : String(message))
       if (isHydrationNoise(msg)) return
       const stack = error?.stack ?? `at ${source}:${lineno}:${colno}`
+      if (isMonitorOwnError(msg, stack)) return
       const url = window.location.href
       const fingerprint = await computeFingerprint(msg, stack, url)
       if (isRecentlySent(fingerprint)) return
@@ -84,6 +90,7 @@ export function installJsErrorCapture(): () => void {
         : 'Unhandled promise rejection')
       if (isHydrationNoise(msg)) return
       const stack = reason instanceof Error ? (reason.stack ?? '') : ''
+      if (isMonitorOwnError(msg, stack)) return
       const url = window.location.href
       const fingerprint = await computeFingerprint(msg, stack, url)
       if (isRecentlySent(fingerprint)) return

package/src/client/capture/network.ts

@@ -15,7 +15,7 @@ export async function monitoredFetch(
       const { config } = monitorStore.getState()
       monitorStore.getState().push({
         event_type: EventType.NETWORK_ERROR,
-        level: response.status >= 500 ? EventLevel.ERROR : EventLevel.WARN,
+        level: response.status >= 500 ? EventLevel.ERROR : EventLevel.WARNING,
         message: `HTTP ${response.status} ${response.statusText} — ${method} ${url}`,
         url: typeof window !== 'undefined' ? window.location.href : '',
         http_status: response.status,

package/src/client/capture/validation.ts

@@ -20,7 +20,7 @@ export function installValidationCapture(): () => void {
       const rawMsg = `Zod validation error in ${detail.operation}: ${detail.error?.message ?? 'unknown'}`
       monitorStore.getState().push({
         event_type: EventType.WARNING,
-        level: EventLevel.WARN,
+        level: EventLevel.WARNING,
         message: rawMsg.length > 500 ? rawMsg.slice(0, 499) + '…' : rawMsg,
         url: window.location.href,
         http_method: detail.method,

package/src/client/constants.ts

@@ -0,0 +1,7 @@
+/**
+ * Internal URL patterns for the monitor transport.
+ * Used to filter out self-generated errors and prevent capture→flush feedback loops.
+ */
+
+/** Matches any request to the monitor ingest endpoint */
+export const MONITOR_INGEST_PATTERN = /cfg\/monitor\/ingest/

package/src/client/index.ts

@@ -27,7 +27,8 @@ import { monitorStore } from './store'
 import { configureMonitorApi } from '../_api'
 import type { MonitorConfig, MonitorEvent } from '../types'
 
-export type { MonitorConfig, MonitorEvent, EventType, EventLevel } from '../types'
+export type { MonitorConfig, MonitorEvent } from '../types'
+export { EventType, EventLevel } from '../types'
 export { monitoredFetch } from './capture/network'
 export { getSessionId } from './capture/session'
 export { MonitorProvider } from './MonitorProvider'

package/src/client/store/index.ts

@@ -2,10 +2,16 @@ import { createStore } from 'zustand/vanilla'
 import type { MonitorEvent, MonitorConfig } from '../../types'
 import { sendBatch } from '../transport/ingest'
 
+// Circuit breaker: pause flushing after N consecutive transport failures
+const CIRCUIT_BREAKER_THRESHOLD = 3
+const CIRCUIT_BREAKER_COOLDOWN_MS = 60_000 // 1 minute
+
 interface MonitorState {
   config: MonitorConfig
   buffer: MonitorEvent[]
   initialized: boolean
+  _consecutiveFailures: number
+  _pausedUntil: number
   push: (event: MonitorEvent) => void
   flush: (useBeacon?: boolean) => void
   setConfig: (config: MonitorConfig) => void
@@ -15,6 +21,8 @@ export const monitorStore = createStore<MonitorState>((set, get) => ({
   config: {},
   buffer: [],
   initialized: false,
+  _consecutiveFailures: 0,
+  _pausedUntil: 0,
 
   push(event) {
     const { config, buffer } = get()
@@ -45,11 +53,29 @@ export const monitorStore = createStore<MonitorState>((set, get) => ({
   },
 
   flush(useBeacon = false) {
-    const { buffer } = get()
+    const { buffer, _pausedUntil } = get()
     if (buffer.length === 0) return
+
+    // Circuit breaker: skip sending while paused
+    if (Date.now() < _pausedUntil) return
+
     const batch = buffer.slice(0, 50)
     set({ buffer: buffer.slice(50) })
-    sendBatch({ events: batch }, useBeacon)
+
+    sendBatch({ events: batch }, useBeacon).then(
+      () => {
+        // Success: reset failure counter
+        set({ _consecutiveFailures: 0, _pausedUntil: 0 })
+      },
+      () => {
+        // Failure: increment counter and maybe open circuit
+        const failures = get()._consecutiveFailures + 1
+        const pausedUntil = failures >= CIRCUIT_BREAKER_THRESHOLD
+          ? Date.now() + CIRCUIT_BREAKER_COOLDOWN_MS
+          : get()._pausedUntil
+        set({ _consecutiveFailures: failures, _pausedUntil: pausedUntil })
+      }
+    )
   },
 
   setConfig(config) {

package/src/client/transport/ingest.ts

@@ -18,14 +18,10 @@ export async function sendBatch(
 ): Promise<void> {
   if (batch.events.length === 0) return
 
-  try {
-    if (useBeacon) {
-      syncBeaconBaseUrl()
-      await monitorApiBeacon.monitor.ingestCreate(batch)
-    } else {
-      await monitorApi.monitor.ingestCreate(batch)
-    }
-  } catch {
-    // Transport errors silently ignored — monitoring must never crash the app
+  if (useBeacon) {
+    syncBeaconBaseUrl()
+    await monitorApiBeacon.monitor.ingestCreate(batch)
+  } else {
+    await monitorApi.monitor.ingestCreate(batch)
   }
 }

package/src/client/window.ts

@@ -72,19 +72,19 @@ export function initWindowMonitor(): void {
     },
 
     warn(message, extra) {
-      monitorStore.getState().push(makeEvent(EventType.WARNING, EventLevel.WARN, message, extra))
+      monitorStore.getState().push(makeEvent(EventType.WARNING, EventLevel.WARNING, message, extra))
       console.log('[monitor] warn captured →', message)
     },
 
     info(message, extra) {
-      monitorStore.getState().push(makeEvent(EventType.INFO, EventLevel.INFO, message, extra))
+      monitorStore.getState().push(makeEvent(EventType.WARNING, EventLevel.INFO, message, extra))
       console.log('[monitor] info captured →', message)
     },
 
     network(status, method, url, extra) {
       const event = makeEvent(
         EventType.NETWORK_ERROR,
-        status >= 500 ? EventLevel.ERROR : EventLevel.WARN,
+        status >= 500 ? EventLevel.ERROR : EventLevel.WARNING,
         `${method} ${url} → ${status}`,
         extra,
       )

package/src/server/index.ts

@@ -69,7 +69,7 @@ export const serverMonitor = {
   ): Promise<void> {
     await send([withDefaults({
       event_type: EventType.NETWORK_ERROR,
-      level: status >= 500 ? EventLevel.ERROR : EventLevel.WARN,
+      level: status >= 500 ? EventLevel.ERROR : EventLevel.WARNING,
       message: `HTTP ${status} — ${method} ${apiUrl}`,
       url: ctx?.pageUrl ?? '',
       http_status: status,