@djangocfg/monitor 2.1.227 → 2.1.229

package/dist/client.d.cts

@@ -2,58 +2,55 @@ import * as react from 'react';
 import * as zustand_vanilla from 'zustand/vanilla';
 
 /**
- * * `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
  */
 declare enum FrontendEventIngestRequestEventType {
+    JS_ERROR = "JS_ERROR",
+    NETWORK_ERROR = "NETWORK_ERROR",
     ERROR = "ERROR",
     WARNING = "WARNING",
-    INFO = "INFO",
     PAGE_VIEW = "PAGE_VIEW",
     PERFORMANCE = "PERFORMANCE",
-    NETWORK_ERROR = "NETWORK_ERROR",
-    JS_ERROR = "JS_ERROR",
     CONSOLE = "CONSOLE"
 }
 /**
- * * `error` - Error
- * * `warn` - Warning
- * * `info` - Info
- * * `debug` - Debug
+ * * `error` - error
+ * * `warning` - warning
+ * * `info` - info
+ * * `debug` - debug
  */
 declare enum FrontendEventIngestRequestLevel {
     ERROR = "error",
-    WARN = "warn",
+    WARNING = "warning",
     INFO = "info",
     DEBUG = "debug"
 }
 
 /**
- * Validates a single event from the browser.
+ * Single browser event payload.
  *
  * Request model (no read-only fields).
  */
 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: FrontendEventIngestRequestEventType;
     message: string;
-    /** * `error` - Error
-    * `warn` - Warning
-    * `info` - Info
-    * `debug` - Debug */
+    /** * `error` - error
+    * `warning` - warning
+    * `info` - info
+    * `debug` - debug */
     level?: FrontendEventIngestRequestLevel;
     stack_trace?: string;
     url?: string;
@@ -61,13 +58,12 @@ 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;
 }
 
 /**
@@ -146,6 +142,8 @@ interface MonitorState {
     config: MonitorConfig;
     buffer: FrontendEventIngestRequest[];
     initialized: boolean;
+    _consecutiveFailures: number;
+    _pausedUntil: number;
     push: (event: FrontendEventIngestRequest) => void;
     flush: (useBeacon?: boolean) => void;
     setConfig: (config: MonitorConfig) => void;

package/dist/client.d.ts

@@ -2,58 +2,55 @@ import * as react from 'react';
 import * as zustand_vanilla from 'zustand/vanilla';
 
 /**
- * * `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
  */
 declare enum FrontendEventIngestRequestEventType {
+    JS_ERROR = "JS_ERROR",
+    NETWORK_ERROR = "NETWORK_ERROR",
     ERROR = "ERROR",
     WARNING = "WARNING",
-    INFO = "INFO",
     PAGE_VIEW = "PAGE_VIEW",
     PERFORMANCE = "PERFORMANCE",
-    NETWORK_ERROR = "NETWORK_ERROR",
-    JS_ERROR = "JS_ERROR",
     CONSOLE = "CONSOLE"
 }
 /**
- * * `error` - Error
- * * `warn` - Warning
- * * `info` - Info
- * * `debug` - Debug
+ * * `error` - error
+ * * `warning` - warning
+ * * `info` - info
+ * * `debug` - debug
  */
 declare enum FrontendEventIngestRequestLevel {
     ERROR = "error",
-    WARN = "warn",
+    WARNING = "warning",
     INFO = "info",
     DEBUG = "debug"
 }
 
 /**
- * Validates a single event from the browser.
+ * Single browser event payload.
  *
  * Request model (no read-only fields).
  */
 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: FrontendEventIngestRequestEventType;
     message: string;
-    /** * `error` - Error
-    * `warn` - Warning
-    * `info` - Info
-    * `debug` - Debug */
+    /** * `error` - error
+    * `warning` - warning
+    * `info` - info
+    * `debug` - debug */
     level?: FrontendEventIngestRequestLevel;
     stack_trace?: string;
     url?: string;
@@ -61,13 +58,12 @@ 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;
 }
 
 /**
@@ -146,6 +142,8 @@ interface MonitorState {
     config: MonitorConfig;
     buffer: FrontendEventIngestRequest[];
     initialized: boolean;
+    _consecutiveFailures: number;
+    _pausedUntil: number;
     push: (event: FrontendEventIngestRequest) => void;
     flush: (useBeacon?: boolean) => void;
     setConfig: (config: MonitorConfig) => void;

package/dist/client.mjs

@@ -325,7 +325,8 @@ var _Monitor = class _Monitor {
   /**
    * Ingest browser events
    * 
-   * Accepts a batch of up to 50 frontend events. No authentication required.
+   * Accepts a batch of up to 50 frontend events. No authentication required
+   * — anonymous visitors can send events.
    */
   async ingestCreate(data) {
     const response = await this.client.request("POST", "/cfg/monitor/ingest/", { body: data });
@@ -1103,19 +1104,18 @@ var MemoryStorageAdapter = _MemoryStorageAdapter;
 
 // src/_api/generated/cfg_monitor/enums.ts
 var FrontendEventIngestRequestEventType = /* @__PURE__ */ ((FrontendEventIngestRequestEventType2) => {
+  FrontendEventIngestRequestEventType2["JS_ERROR"] = "JS_ERROR";
+  FrontendEventIngestRequestEventType2["NETWORK_ERROR"] = "NETWORK_ERROR";
   FrontendEventIngestRequestEventType2["ERROR"] = "ERROR";
   FrontendEventIngestRequestEventType2["WARNING"] = "WARNING";
-  FrontendEventIngestRequestEventType2["INFO"] = "INFO";
   FrontendEventIngestRequestEventType2["PAGE_VIEW"] = "PAGE_VIEW";
   FrontendEventIngestRequestEventType2["PERFORMANCE"] = "PERFORMANCE";
-  FrontendEventIngestRequestEventType2["NETWORK_ERROR"] = "NETWORK_ERROR";
-  FrontendEventIngestRequestEventType2["JS_ERROR"] = "JS_ERROR";
   FrontendEventIngestRequestEventType2["CONSOLE"] = "CONSOLE";
   return FrontendEventIngestRequestEventType2;
 })(FrontendEventIngestRequestEventType || {});
 var FrontendEventIngestRequestLevel = /* @__PURE__ */ ((FrontendEventIngestRequestLevel2) => {
   FrontendEventIngestRequestLevel2["ERROR"] = "error";
-  FrontendEventIngestRequestLevel2["WARN"] = "warn";
+  FrontendEventIngestRequestLevel2["WARNING"] = "warning";
   FrontendEventIngestRequestLevel2["INFO"] = "info";
   FrontendEventIngestRequestLevel2["DEBUG"] = "debug";
   return FrontendEventIngestRequestLevel2;
@@ -1133,13 +1133,12 @@ var FrontendEventIngestRequestSchema = z.object({
   http_status: z.number().int().nullable().optional(),
   http_method: z.string().max(10).optional(),
   http_url: z.string().max(2e3).optional(),
+  session_id: z.string().max(64).optional(),
   user_agent: z.string().max(500).optional(),
-  session_id: z.string().regex(/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i).nullable().optional(),
-  browser_fingerprint: z.string().max(64).optional(),
-  extra: z.record(z.string(), z.any()).optional(),
-  project_name: z.string().max(100).optional(),
+  build_id: z.string().max(100).optional(),
   environment: z.string().max(20).optional(),
-  build_id: z.string().max(100).optional()
+  extra: z.record(z.string(), z.any()).optional(),
+  project_name: z.string().max(100).optional()
 });
 
 // src/_api/generated/cfg_monitor/_utils/schemas/IngestBatchRequest.schema.ts
@@ -1326,23 +1325,24 @@ function syncBeaconBaseUrl() {
 __name(syncBeaconBaseUrl, "syncBeaconBaseUrl");
 async function sendBatch(batch, useBeacon = false) {
   if (batch.events.length === 0) return;
-  try {
-    if (useBeacon) {
-      syncBeaconBaseUrl();
-      await monitorApiBeacon.monitor.ingestCreate(batch);
-    } else {
-      await monitorApi.monitor.ingestCreate(batch);
-    }
-  } catch {
+  if (useBeacon) {
+    syncBeaconBaseUrl();
+    await monitorApiBeacon.monitor.ingestCreate(batch);
+  } else {
+    await monitorApi.monitor.ingestCreate(batch);
   }
 }
 __name(sendBatch, "sendBatch");
 
 // src/client/store/index.ts
+var CIRCUIT_BREAKER_THRESHOLD = 3;
+var CIRCUIT_BREAKER_COOLDOWN_MS = 6e4;
 var monitorStore = createStore((set, get) => ({
   config: {},
   buffer: [],
   initialized: false,
+  _consecutiveFailures: 0,
+  _pausedUntil: 0,
   push(event) {
     const { config, buffer } = get();
     const maxSize = config.maxBufferSize ?? 20;
@@ -1368,23 +1368,40 @@ var monitorStore = createStore((set, get) => ({
     }
   },
   flush(useBeacon = false) {
-    const { buffer } = get();
+    const { buffer, _pausedUntil } = get();
     if (buffer.length === 0) return;
+    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(
+      () => {
+        set({ _consecutiveFailures: 0, _pausedUntil: 0 });
+      },
+      () => {
+        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) {
     set({ config, initialized: true });
   }
 }));
 
+// src/client/constants.ts
+var MONITOR_INGEST_PATTERN = /cfg\/monitor\/ingest/;
+
 // src/client/capture/js-errors.ts
 var MSG_MAX = 2e3;
 function truncate(s, max = MSG_MAX) {
   return s.length > max ? s.slice(0, max - 1) + "\u2026" : s;
 }
 __name(truncate, "truncate");
+function isMonitorOwnError(msg, stack) {
+  return MONITOR_INGEST_PATTERN.test(msg) || MONITOR_INGEST_PATTERN.test(stack ?? "");
+}
+__name(isMonitorOwnError, "isMonitorOwnError");
 var HYDRATION_NOISE = [
   /hydration failed/i,
   /there was an error while hydrating/i,
@@ -1419,6 +1436,7 @@ function installJsErrorCapture() {
       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;
@@ -1445,6 +1463,7 @@ function installJsErrorCapture() {
       const msg = truncate(reason instanceof Error ? reason.message : typeof reason === "string" ? reason : "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;
@@ -1477,7 +1496,7 @@ __name(installJsErrorCapture, "installJsErrorCapture");
 
 // src/client/capture/console.ts
 var levelMap = {
-  warn: "warn" /* WARN */,
+  warn: "warning" /* WARNING */,
   error: "error" /* ERROR */
 };
 var typeMap = {
@@ -1506,6 +1525,7 @@ __name(stringify, "stringify");
 async function captureConsoleEvent(level, args) {
   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();
@@ -1571,7 +1591,7 @@ function installValidationCapture() {
       const rawMsg = `Zod validation error in ${detail.operation}: ${detail.error?.message ?? "unknown"}`;
       monitorStore.getState().push({
         event_type: "WARNING" /* WARNING */,
-        level: "warn" /* WARN */,
+        level: "warning" /* WARNING */,
         message: rawMsg.length > 500 ? rawMsg.slice(0, 499) + "\u2026" : rawMsg,
         url: window.location.href,
         http_method: detail.method,
@@ -1600,7 +1620,7 @@ async function monitoredFetch(input, init) {
       const { config } = monitorStore.getState();
       monitorStore.getState().push({
         event_type: "NETWORK_ERROR" /* NETWORK_ERROR */,
-        level: response.status >= 500 ? "error" /* ERROR */ : "warn" /* WARN */,
+        level: response.status >= 500 ? "error" /* ERROR */ : "warning" /* WARNING */,
         message: `HTTP ${response.status} ${response.statusText} \u2014 ${method} ${url}`,
         url: typeof window !== "undefined" ? window.location.href : "",
         http_status: response.status,
@@ -1660,17 +1680,17 @@ function initWindowMonitor() {
       console.log("[monitor] error captured \u2192", message);
     },
     warn(message, extra) {
-      monitorStore.getState().push(makeEvent("WARNING" /* WARNING */, "warn" /* WARN */, message, extra));
+      monitorStore.getState().push(makeEvent("WARNING" /* WARNING */, "warning" /* WARNING */, message, extra));
       console.log("[monitor] warn captured \u2192", message);
     },
     info(message, extra) {
-      monitorStore.getState().push(makeEvent("INFO" /* INFO */, "info" /* INFO */, message, extra));
+      monitorStore.getState().push(makeEvent("WARNING" /* WARNING */, "info" /* INFO */, message, extra));
       console.log("[monitor] info captured \u2192", message);
     },
     network(status, method, url, extra) {
       const event = makeEvent(
         "NETWORK_ERROR" /* NETWORK_ERROR */,
-        status >= 500 ? "error" /* ERROR */ : "warn" /* WARN */,
+        status >= 500 ? "error" /* ERROR */ : "warning" /* WARNING */,
         `${method} ${url} \u2192 ${status}`,
         extra
       );
@@ -1748,6 +1768,8 @@ var FrontendMonitor = {
   }
 };
 export {
+  FrontendEventIngestRequestLevel as EventLevel,
+  FrontendEventIngestRequestEventType as EventType,
   FrontendMonitor,
   MonitorProvider,
   getSessionId,