Cursor rule

1---
2description: Rules for working in the WebSocket service (real-time delivery)
3globs: apps/ws/**/*
4alwaysApply: false
5---
6 
7## WebSocket Service
8 
9**Stack:** NestJS · Socket.io with Redis adapter (horizontal scaling)
10 
11**Run:** `pnpm start:ws` — only needed for real-time features (live inbox, read/unread sync). Skip for most tasks.
12 
13**Key directories:**
14```
15apps/ws/src/   # Socket gateways, guards, and event handlers
16```
17 
18### WebSocket Conventions
19 
20**Authentication:** Clients authenticate via JWT on the Socket.io handshake.
21 
22**Scaling:** The Redis adapter is required in production — multiple ws instances share socket state through it.
23 
24**Client packages:** Events emitted here are consumed by `@novu/js` and `@novu/react`. New Socket.io event types require matching updates in both packages.
25