WebSocket gateways को साथ real-time features कसरी बनाउनुहुन्छ?

Question

Accepted Answer

NestJS ले **real-time, bidirectional communication** को समर्थन गर्छ **WebSocket gateways** मार्फत — `@WebSocketGateway()` decorator को साथ decorated classes जो WebSocket connections र messages (सामान्यतः Socket.IO मा) को संचालना गर्छन्। तिनीहरूले chat, live notifications, र live dashboards जस्ता features सक्षम गर्छन्, एक समान NestJS structure (DI, decorators) को प्रयोग गरेर।

## Gateway परिभाषित गर्दै

```ts
import { WebSocketGateway, SubscribeMessage, MessageBody, WebSocketServer } from "@nestjs/websockets";
import { Server } from "socket.io";

@WebSocketGateway({ cors: true })
export class ChatGateway {
  @WebSocketServer()
  server: Server;                        // the Socket.IO server instance

// handle a 'message' event from a client
  @SubscribeMessage("message")
  handleMessage(@MessageBody() data: { text: string }) {
    // BROADCAST to all connected clients
    this.server.emit("message", data);   // everyone receives the message
  }
}
```

एक gateway ले `@SubscribeMessage("event")` को प्रयोग गर्छ incoming events को संचालना गर्न (HTTP को लागि `@Post` सँग सादृश्य) र injected `server` लाई clients मा events **emit** गर्न — `server.emit` सबैलाई broadcast गर्छ।

## Connection lifecycle hooks

```ts
export class ChatGateway implements OnGatewayConnection, OnGatewayDisconnect {
  handleConnection(client: Socket) {
    console.log(`Client connected: ${client.id}`);   // a user joined
  }
  handleDisconnect(client: Socket) {
    console.log(`Client disconnected: ${client.id}`); // a user left — clean up
  }
}
```

Gateways ले clients को connecting र disconnecting मा प्रतिक्रिया दिन सक्छन् — presence tracking र cleanup को लागि उपयोगी।

## विशेष clients र rooms लाई लक्ष्य गर्दै

```ts
@SubscribeMessage("joinRoom")
handleJoin(@ConnectedSocket() client: Socket, @MessageBody() room: string) {
  client.join(room);                              // add the client to a room
}

@SubscribeMessage("roomMessage")
sendToRoom(@MessageBody() data: { room: string; text: string }) {
  this.server.to(data.room).emit("message", data.text);   // emit only to that room
  // client.emit(...) → just that client; server.emit(...) → everyone
}
```

**Rooms** ले clients को समूह बनाउछन् (जस्तै चुरोट कक्ष, कागजातका सहयोगी), सबैको सट्टा विशेष subsets मा broadcast गर्न दिन्छन् — scoped real-time features को लागि आवश्यक।

## Gateways ले NestJS features को पुनः प्रयोग गर्छन्

```text
Gateways are providers → they support dependency injection (inject services),
and can use guards, pipes, interceptors, and filters — just like HTTP controllers.
→ The same structure/patterns apply to real-time as to REST.
```

## WebSockets को मापन

```text
⚠️ WebSocket connections are STATEFUL and live on ONE server instance.
To scale across multiple instances, use a Redis adapter (socket.io-redis) so
broadcasts/rooms work across all instances. (Like sessions, don't keep state in
one process's memory when scaling horizontally.)
```

## किन यो महत्त्वपूर्ण छ

WebSocket gateways यो हो कसरी NestJS ले **real-time, bidirectional features** को समर्थन गर्छ — chat, live notifications, presence, collaborative editing, live dashboards, multiplayer interactions — कि REST को request-response model प्रदान गर्न सक्दैन (सर्वरले clients मा push गर्न सक्छ, केवल requests को प्रतिक्रिया जनाउन सक्दैन)।

यो understanding आधुनिक interactive applications बनाउन को लागि senior-level मूल्यवान ज्ञान हो।

मुख्य शक्ति यो हो कि gateways NestJS को परिचित structure मा फिट हुन्छन्: तिनीहरू providers हुन् जो **dependency injection** को समर्थन गर्छन् र HTTP controllers जस्तै **guards, pipes, interceptors, र filters** प्रयोग गर्न सक्छन्, त्यसैले एक समान patterns र code organization real-time र REST दोनै मा लागू हुन्छ।

यो जान्नु कसरी events (`@SubscribeMessage`) को संचालना गर्ने, clients मा broadcast गर्ने (`server.emit`), relevant subsets (chat rooms, document collaborators) मा broadcasts लाई scope गर्न **rooms** को प्रयोग गर्ने, र connection lifecycle (presence, cleanup) को संचालना गर्ने, यो practical real-time toolkit लाई cover गर्छ।

अत्यन्त महत्त्वपूर्ण **scaling consideration** हो: WebSocket connections stateful हुन् र एक सर्वर instance मा बाँधिएका हुन्छन्, त्यसैले horizontally मापन गर्न **Redis adapter** को आवश्यकता पर्छ instances मा broadcasts/rooms को coordinate गर्न (एक सामान्य pitfall — sessions जस्तै, real-time state एक process को memory मा रहन सक्दैन जब बहुविध instances चलिरहेको हुन्छ)।

यो एक महत्त्वपूर्ण, बढ्दो-प्रासंगिक capability हो real-time, interactive experiences बनाउन को लागि जो आधुनिक users को उम्मीद गर्छन्, र NestJS को स्वच्छ integration यसलाई सुलभ बनाउछ जबकि framework को structure लाई पुनः प्रयोग गर्छ।