@djangocfg/centrifugo 2.1.49 → 2.1.51

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@djangocfg/centrifugo",
-  "version": "2.1.49",
+  "version": "2.1.51",
   "description": "Production-ready Centrifugo WebSocket client for React with real-time subscriptions, RPC patterns, and connection state management",
   "keywords": [
     "centrifugo",
@@ -51,9 +51,9 @@
     "centrifuge": "^5.2.2"
   },
   "peerDependencies": {
-    "@djangocfg/api": "^2.1.49",
-    "@djangocfg/ui-nextjs": "^2.1.49",
-    "@djangocfg/layouts": "^2.1.49",
+    "@djangocfg/api": "^2.1.51",
+    "@djangocfg/ui-nextjs": "^2.1.51",
+    "@djangocfg/layouts": "^2.1.51",
     "consola": "^3.4.2",
     "lucide-react": "^0.545.0",
     "moment": "^2.30.1",
@@ -61,7 +61,7 @@
     "react-dom": "^19.1.0"
   },
   "devDependencies": {
-    "@djangocfg/typescript-config": "^2.1.49",
+    "@djangocfg/typescript-config": "^2.1.51",
     "@types/react": "^19.1.0",
     "@types/react-dom": "^19.1.0",
     "moment": "^2.30.1",

package/src/core/client/CentrifugoRPCClient.ts

@@ -8,6 +8,7 @@
 import { Centrifuge } from 'centrifuge';
 
 import { getConsolaLogger } from '../logger/consolaLogger';
+import { dispatchCentrifugoError } from '../../events';
 
 import type { Logger } from '../logger';
 export interface CentrifugoClientOptions {
@@ -589,6 +590,17 @@ export class CentrifugoRPCClient {
       return result.data as TResponse;
     } catch (error) {
       this.logger.error(`Native RPC failed: ${method}`, error);
+
+      // Dispatch error event for ErrorsTracker
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      const errorCode = (error as any)?.code;
+      dispatchCentrifugoError({
+        method,
+        error: errorMessage,
+        code: errorCode,
+        data,
+      });
+
       throw error;
     }
   }

package/src/events.ts

@@ -2,6 +2,7 @@
  * Centrifugo Package Events
  *
  * Event-driven communication for Centrifugo monitor dialog
+ * and error tracking via CustomEvents
  */
 
 import { events } from '@djangocfg/ui-nextjs';
@@ -15,6 +16,11 @@ export const CENTRIFUGO_MONITOR_EVENTS = {
   CLOSE_MONITOR_DIALOG: 'CENTRIFUGO_CLOSE_MONITOR_DIALOG',
 } as const;
 
+/**
+ * Error event name for ErrorsTracker integration
+ */
+export const CENTRIFUGO_ERROR_EVENT = 'centrifugo-error' as const;
+
 // ─────────────────────────────────────────────────────────────────────────
 // Event Payload Types
 // ─────────────────────────────────────────────────────────────────────────
@@ -24,6 +30,21 @@ export interface OpenMonitorDialogPayload {
   defaultTab?: 'connection' | 'messages' | 'subscriptions';
 }
 
+/**
+ * Payload for centrifugo-error CustomEvent
+ * Compatible with ErrorsTracker CentrifugoErrorDetail
+ */
+export interface CentrifugoErrorPayload {
+  /** RPC method that failed */
+  method: string;
+  /** Error message */
+  error: string;
+  /** Error code from Centrifugo */
+  code?: number;
+  /** Additional data sent with the request */
+  data?: any;
+}
+
 // ─────────────────────────────────────────────────────────────────────────
 // Event Emitters
 // ─────────────────────────────────────────────────────────────────────────
@@ -42,3 +63,42 @@ export const emitCloseMonitorDialog = () => {
   });
 };
 
+// ─────────────────────────────────────────────────────────────────────────
+// Error Event Dispatcher (CustomEvent for ErrorsTracker)
+// ─────────────────────────────────────────────────────────────────────────
+
+/**
+ * Dispatch Centrifugo error event for ErrorsTracker
+ *
+ * Uses window.dispatchEvent with CustomEvent to integrate with
+ * ErrorsTracker from @djangocfg/layouts package.
+ *
+ * @example
+ * ```ts
+ * dispatchCentrifugoError({
+ *   method: 'terminal.input',
+ *   error: 'timeout',
+ *   code: 1,
+ *   data: { session_id: 'abc-123' },
+ * });
+ * ```
+ */
+export const dispatchCentrifugoError = (payload: CentrifugoErrorPayload): void => {
+  if (typeof window === 'undefined') {
+    return;
+  }
+
+  try {
+    window.dispatchEvent(new CustomEvent(CENTRIFUGO_ERROR_EVENT, {
+      detail: {
+        ...payload,
+        timestamp: new Date(),
+      },
+      bubbles: true,
+      cancelable: false,
+    }));
+  } catch (eventError) {
+    // Silently fail - event dispatch should never crash the app
+  }
+};
+