@djangocfg/centrifugo 2.1.52 → 2.1.54

package/README.md

@@ -443,6 +443,56 @@ interface UseNamedRPCResult {
 
 > **Note:** `useNamedRPC` uses native Centrifugo RPC which requires RPC proxy to be configured in Centrifugo server. See the [Setup Guide](https://djangocfg.com/docs/features/integrations/centrifugo/client-generation/) for configuration details.
 
+### namedRPCNoWait() - Fire-and-Forget RPC
+
+For latency-sensitive operations (like terminal input), use the fire-and-forget variant that returns immediately without waiting for a response.
+
+**When to use:**
+- Terminal input (user typing)
+- Real-time cursor position updates
+- Any operation where you don't need the response
+
+**Direct Client Usage:**
+
+```tsx
+import { useCentrifugo } from '@djangocfg/centrifugo';
+
+function TerminalInput() {
+  const { client } = useCentrifugo();
+
+  const handleKeyPress = (key: string) => {
+    // Fire-and-forget: returns immediately, doesn't wait for response
+    client?.namedRPCNoWait('terminal.input', {
+      session_id: 'abc-123',
+      data: btoa(key)
+    });
+  };
+
+  return <input onKeyPress={(e) => handleKeyPress(e.key)} />;
+}
+```
+
+**Backend Handler (Django):**
+
+```python
+@websocket_rpc("terminal.input", no_wait=True)
+async def terminal_input(conn, params: TerminalInputParams) -> SuccessResult:
+    """Handle terminal input (fire-and-forget)."""
+    import asyncio
+
+    # Spawn background task, return immediately
+    asyncio.create_task(_send_input_to_agent(params.session_id, params.data))
+
+    return SuccessResult(success=True, message="Input queued")
+```
+
+**Performance comparison:**
+
+| Method | Latency | Use Case |
+|--------|---------|----------|
+| `namedRPC()` | ~800-1800ms | Commands that need response |
+| `namedRPCNoWait()` | ~10-30ms | Real-time input, fire-and-forget |
+
 ## Auto-Generated Type-Safe Clients
 
 Django-CFG can auto-generate TypeScript clients from your `@websocket_rpc` handlers, providing full type safety and eliminating manual RPC calls.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@djangocfg/centrifugo",
-  "version": "2.1.52",
+  "version": "2.1.54",
   "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.52",
-    "@djangocfg/ui-nextjs": "^2.1.52",
-    "@djangocfg/layouts": "^2.1.52",
+    "@djangocfg/api": "^2.1.54",
+    "@djangocfg/ui-nextjs": "^2.1.54",
+    "@djangocfg/layouts": "^2.1.54",
     "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.52",
+    "@djangocfg/typescript-config": "^2.1.54",
     "@types/react": "^19.1.0",
     "@types/react-dom": "^19.1.0",
     "moment": "^2.30.1",

package/src/core/client/CentrifugoRPCClient.ts

@@ -604,4 +604,34 @@ export class CentrifugoRPCClient {
       throw error;
     }
   }
+
+  /**
+   * Fire-and-forget RPC call - sends without waiting for response.
+   * Use for latency-sensitive operations like terminal input.
+   *
+   * Flow:
+   * 1. Client calls namedRPCNoWait('terminal.input', data)
+   * 2. Centrifuge.js sends RPC over WebSocket
+   * 3. Client returns immediately (doesn't wait for response)
+   * 4. Backend processes asynchronously
+   *
+   * @param method - RPC method name (e.g., 'terminal.input')
+   * @param data - Request data
+   *
+   * @example
+   * // Terminal input - user types, we send immediately
+   * client.namedRPCNoWait('terminal.input', {
+   *   session_id: 'abc-123',
+   *   data: btoa('ls')
+   * });
+   */
+  namedRPCNoWait<TRequest = any>(method: string, data: TRequest): void {
+    this.logger.info(`Native RPC (fire-and-forget): ${method}`, { data });
+
+    // Fire and forget - don't await the promise
+    this.centrifuge.rpc(method, data).catch((error) => {
+      // Log but don't throw - this is fire-and-forget
+      this.logger.warning(`Fire-and-forget RPC failed: ${method}`, error);
+    });
+  }
 }