1package server
2
3import (
4 "context"
5 "encoding/json"
6 "errors"
7 "log"
8 "sync"
9 "time"
10
11 "github.com/gofrs/uuid"
12 "github.com/speps/go-hashids"
13 "github.com/zikaeroh/codies/internal/game"
14 "github.com/zikaeroh/codies/internal/protocol"
15 "go.uber.org/atomic"
16 "golang.org/x/sync/errgroup"
17 "nhooyr.io/websocket"
18 "nhooyr.io/websocket/wsjson"
19)
20
21const maxRooms = 1000
22
23var (
24 ErrRoomExists = errors.New("server: rooms exist")
25 ErrTooManyRooms = errors.New("server: too many rooms")
26)
27
28type Server struct {
29 clientCount atomic.Int64
30 roomCount atomic.Int64
31 doPrune chan struct{}
32 ready chan struct{}
33
34 mu sync.Mutex
35
36 ctx context.Context
37 rooms map[string]*Room
38 roomIDs map[string]*Room
39
40 hid *hashids.HashID
41 nextID int64
42}
43
44func NewServer() *Server {
45 hd := hashids.NewData()
46 hd.MinLength = 8
47 hd.Salt = uuid.Must(uuid.NewV4()).String() // IDs are only valid for this server instance; ok to randomize salt.
48 hid, err := hashids.NewWithData(hd)
49 if err != nil {
50 panic(err)
51 }
52
53 return &Server{
54 ready: make(chan struct{}),
55 doPrune: make(chan struct{}, 1),
56 rooms: make(map[string]*Room),
57 roomIDs: make(map[string]*Room),
58 hid: hid,
59 }
60}
61
62func (s *Server) Run(ctx context.Context) error {
63 s.ctx = ctx
64
65 close(s.ready)
66 ticker := time.NewTicker(5 * time.Minute)
67 defer ticker.Stop()
68
69 for {
70 select {
71 case <-ctx.Done():
72 return ctx.Err()
73
74 case <-s.doPrune:
75 s.prune()
76
77 case <-ticker.C:
78 s.prune()
79 }
80 }
81}
82
83func (s *Server) FindRoom(name string) *Room {
84 <-s.ready
85
86 s.mu.Lock()
87 defer s.mu.Unlock()
88 return s.rooms[name]
89}
90
91func (s *Server) FindRoomByID(id string) *Room {
92 <-s.ready
93
94 s.mu.Lock()
95 defer s.mu.Unlock()
96 return s.roomIDs[id]
97}
98
99func (s *Server) CreateRoom(name, password string) (*Room, error) {
100 <-s.ready
101
102 s.mu.Lock()
103 defer s.mu.Unlock()
104
105 room := s.rooms[name]
106 if room != nil {
107 return nil, ErrRoomExists
108 }
109
110 if len(s.rooms) >= maxRooms {
111 return nil, ErrTooManyRooms
112 }
113
114 id, err := s.hid.EncodeInt64([]int64{s.nextID})
115 if err != nil {
116 return nil, err
117 }
118 s.nextID++
119
120 ctx, cancel := context.WithCancel(s.ctx)
121
122 room = &Room{
123 Name: name,
124 Password: password,
125 ID: id,
126 clientCount: &s.clientCount,
127 roomCount: &s.roomCount,
128 ctx: ctx,
129 cancel: cancel,
130 room: game.NewRoom(nil),
131 players: make(map[game.PlayerID]noteSender),
132 turnSeconds: 60,
133 }
134
135 room.lastSeen.Store(time.Now())
136
137 room.room.NewGame()
138
139 s.rooms[name] = room
140 s.roomIDs[room.ID] = room
141 s.roomCount.Inc()
142 metricRooms.Inc()
143
144 log.Printf("created new room '%s' (%s)", name, room.ID)
145
146 if s.nextID%100 == 0 {
147 s.triggerPrune()
148 }
149
150 return room, nil
151}
152
153func (s *Server) triggerPrune() {
154 select {
155 case s.doPrune <- struct{}{}:
156 default:
157 }
158}
159
160func (s *Server) prune() {
161 s.mu.Lock()
162 defer s.mu.Unlock()
163
164 toRemove := make([]string, 0, 1)
165
166 for name, room := range s.rooms {
167 lastSeen := room.lastSeen.Load().(time.Time)
168 if time.Since(lastSeen) > 10*time.Minute {
169 toRemove = append(toRemove, name)
170 }
171 }
172
173 if len(toRemove) == 0 {
174 return
175 }
176
177 for _, name := range toRemove {
178 room := s.rooms[name]
179 room.mu.Lock()
180 room.stopTimer()
181 room.mu.Unlock()
182
183 room.cancel()
184 delete(s.rooms, name)
185 delete(s.roomIDs, room.ID)
186 s.roomCount.Dec()
187 metricRooms.Dec()
188 }
189
190 log.Printf("pruned %d rooms", len(toRemove))
191}
192
193func (s *Server) Stats() (rooms, clients int) {
194 s.mu.Lock()
195 defer s.mu.Unlock()
196 return len(s.rooms), int(s.clientCount.Load())
197}
198
199type Room struct {
200 Name string
201 Password string
202 ID string
203
204 ctx context.Context
205 cancel context.CancelFunc
206 clientCount *atomic.Int64
207 roomCount *atomic.Int64
208
209 mu sync.Mutex
210 room *game.Room
211 players map[game.PlayerID]noteSender
212 state *stateCache
213 lastSeen atomic.Value
214
215 timed bool
216 turnSeconds int
217 turnDeadline *time.Time
218 turnTimer *time.Timer
219
220 hideBomb bool
221}
222
223type noteSender func(protocol.ServerNote)
224
225func (r *Room) HandleConn(playerID uuid.UUID, nickname string, c *websocket.Conn) {
226 metricClients.Inc()
227 defer metricClients.Dec()
228
229 clientCount := r.clientCount.Inc()
230 log.Printf("client connected to room '%s' (%s); %v clients currently connected to %v rooms", r.Name, r.ID, clientCount, r.roomCount.Load())
231
232 defer func() {
233 clientCount := r.clientCount.Dec()
234 log.Printf("client disconnected from room '%s' (%s); %v clients currently connected to %v rooms", r.Name, r.ID, clientCount, r.roomCount.Load())
235 }()
236
237 defer c.Close(websocket.StatusGoingAway, "going away")
238 g, ctx := errgroup.WithContext(r.ctx)
239
240 r.mu.Lock()
241 r.players[playerID] = func(s protocol.ServerNote) {
242 if ctx.Err() != nil {
243 return
244 }
245
246 // It's not safe to start more group goroutines concurrently; just use a regular
247 // goroutine and hope that errors here will be reflected later via ping/receive failures.
248 go func() {
249 ctx, cancel := context.WithTimeout(ctx, time.Second)
250 defer cancel()
251 if err := wsjson.Write(ctx, c, &s); err != nil {
252 return
253 }
254 metricSent.Inc()
255 }()
256 }
257 r.room.AddPlayer(playerID, nickname)
258 r.sendAll()
259 r.mu.Unlock()
260
261 defer func() {
262 r.mu.Lock()
263 defer r.mu.Unlock()
264 delete(r.players, playerID)
265 r.room.RemovePlayer(playerID)
266 r.sendAll()
267 }()
268
269 g.Go(func() error {
270 ticker := time.NewTicker(time.Minute)
271 defer ticker.Stop()
272
273 for {
274 select {
275 case <-ctx.Done():
276 return ctx.Err()
277 case <-ticker.C:
278 }
279
280 if err := c.Ping(ctx); err != nil {
281 return err
282 }
283
284 r.lastSeen.Store(time.Now())
285 }
286 })
287
288 g.Go(func() error {
289 for {
290 var note protocol.ClientNote
291
292 if err := wsjson.Read(ctx, c, ¬e); err != nil {
293 return err
294 }
295
296 r.lastSeen.Store(time.Now())
297 metricReceived.Inc()
298
299 if err := r.handleNote(playerID, ¬e); err != nil {
300 metricHandleErrors.Inc()
301 log.Println("error handling note:", err)
302 return err
303 }
304 }
305 })
306
307 _ = g.Wait()
308}
309
310var errMissingPlayer = errors.New("missing player during handleNote")
311
312func (r *Room) handleNote(playerID game.PlayerID, note *protocol.ClientNote) error {
313 r.mu.Lock()
314 defer r.mu.Unlock()
315
316 // The client's version was wrong; reject and send them the current state.
317 if note.Version != r.room.Version {
318 p := r.players[playerID]
319 if p == nil {
320 return errMissingPlayer
321 }
322 r.sendOne(playerID, p)
323 return nil
324 }
325
326 before := r.room.Version
327 resetTimer := false
328
329 defer func() {
330 if r.room.Version != before {
331 if r.timed && resetTimer {
332 r.startTimer()
333 }
334 r.sendAll()
335 }
336 }()
337
338 switch note.Method {
339 case protocol.RevealMethod:
340 var params protocol.RevealParams
341 if err := json.Unmarshal(note.Params, ¶ms); err != nil {
342 return err
343 }
344 prevTurn := r.room.Turn
345 r.room.Reveal(playerID, params.Row, params.Col)
346 resetTimer = prevTurn != r.room.Turn
347
348 case protocol.NewGameMethod:
349 var params protocol.NewGameParams
350 if err := json.Unmarshal(note.Params, ¶ms); err != nil {
351 return err
352 }
353 resetTimer = true
354 r.room.NewGame()
355
356 case protocol.EndTurnMethod:
357 var params protocol.EndTurnParams
358 if err := json.Unmarshal(note.Params, ¶ms); err != nil {
359 return err
360 }
361 resetTimer = true
362 r.room.EndTurn(playerID)
363
364 case protocol.RandomizeTeamsMethod:
365 var params protocol.RandomizeTeamsParams
366 if err := json.Unmarshal(note.Params, ¶ms); err != nil {
367 return err
368 }
369 r.room.RandomizeTeams()
370
371 case protocol.ChangeTeamMethod:
372 var params protocol.ChangeTeamParams
373 if err := json.Unmarshal(note.Params, ¶ms); err != nil {
374 return err
375 }
376 r.room.ChangeTeam(playerID, params.Team)
377
378 case protocol.ChangeNicknameMethod:
379 var params protocol.ChangeNicknameParams
380 if err := json.Unmarshal(note.Params, ¶ms); err != nil {
381 return err
382 }
383
384 // Sync with protocol.go's validation method.
385 if len(params.Nickname) == 0 || len(params.Nickname) > 16 {
386 return nil
387 }
388
389 r.room.AddPlayer(playerID, params.Nickname)
390
391 case protocol.ChangeRoleMethod:
392 var params protocol.ChangeRoleParams
393 if err := json.Unmarshal(note.Params, ¶ms); err != nil {
394 return err
395 }
396 r.room.ChangeRole(playerID, params.Spymaster)
397
398 case protocol.ChangePackMethod:
399 var params protocol.ChangePackParams
400 if err := json.Unmarshal(note.Params, ¶ms); err != nil {
401 return err
402 }
403 r.room.ChangePack(params.Num, params.Enable)
404
405 case protocol.ChangeTurnModeMethod:
406 var params protocol.ChangeTurnModeParams
407 if err := json.Unmarshal(note.Params, ¶ms); err != nil {
408 return err
409 }
410 r.changeTurnMode(params.Timed)
411
412 case protocol.ChangeTurnTimeMethod:
413 var params protocol.ChangeTurnTimeParams
414 if err := json.Unmarshal(note.Params, ¶ms); err != nil {
415 return err
416 }
417 r.changeTurnTime(params.Seconds)
418
419 case protocol.AddPacksMethod:
420 var params protocol.AddPacksParams
421 if err := json.Unmarshal(note.Params, ¶ms); err != nil {
422 return err
423 }
424 for _, p := range params.Packs {
425 if len(p.Words) < 25 {
426 continue
427 }
428 r.room.AddPack(p.Name, p.Words)
429 }
430
431 case protocol.RemovePackMethod:
432 var params protocol.RemovePackParams
433 if err := json.Unmarshal(note.Params, ¶ms); err != nil {
434 return err
435 }
436 r.room.RemovePack(params.Num)
437
438 case protocol.ChangeHideBombMethod:
439 var params protocol.ChangeHideBombParams
440 if err := json.Unmarshal(note.Params, ¶ms); err != nil {
441 return err
442 }
443 r.changeHideBomb(params.HideBomb)
444
445 default:
446 log.Printf("unhandled method: %s", note.Method)
447 }
448
449 return nil
450}
451
452// Must be called with r.mu locked.
453func (r *Room) sendAll() {
454 for playerID, sender := range r.players {
455 r.sendOne(playerID, sender)
456 }
457}
458
459// Must be called with r.mu locked.
460func (r *Room) sendOne(playerID game.PlayerID, sender noteSender) {
461 state := r.createStateFor(playerID)
462 note := protocol.StateNote(state)
463 sender(note)
464}
465
466// Must be called with r.mu locked.
467func (r *Room) createStateFor(playerID game.PlayerID) *protocol.State {
468 if r.state == nil || r.state.version != r.room.Version {
469 r.state = r.createStateCache()
470 }
471
472 // Temporary verbose access to attempt to figure out which of these is (impossibly) failing.
473 room := r.room
474 players := room.Players
475 player := players[playerID]
476 spymaster := player.Spymaster
477
478 if spymaster {
479 return r.state.spymaster
480 }
481 return r.state.guesser
482}
483
484type stateCache struct {
485 version int
486 guesser *protocol.State
487 spymaster *protocol.State
488}
489
490func (r *Room) createStateCache() *stateCache {
491 return &stateCache{
492 version: r.room.Version,
493 guesser: r.createRoomState(false),
494 spymaster: r.createRoomState(true),
495 }
496}
497
498func (r *Room) createRoomState(spymaster bool) *protocol.State {
499 room := r.room
500
501 s := &protocol.State{
502 Version: room.Version,
503 Teams: make([][]*protocol.StatePlayer, len(room.Teams)),
504 Turn: room.Turn,
505 Winner: room.Winner,
506 Board: make([][]*protocol.StateTile, room.Board.Rows),
507 WordsLeft: room.Board.WordCounts,
508 Lists: make([]*protocol.StateWordList, len(room.WordLists)),
509 HideBomb: r.hideBomb,
510 }
511
512 if r.turnDeadline != nil {
513 s.Timer = &protocol.StateTimer{
514 TurnTime: r.turnSeconds,
515 TurnEnd: *r.turnDeadline,
516 }
517 }
518
519 for team, members := range room.Teams {
520 for _, id := range members {
521 p := room.Players[id]
522 s.Teams[team] = append(s.Teams[team], &protocol.StatePlayer{
523 PlayerID: id,
524 Nickname: p.Nickname,
525 Spymaster: p.Spymaster,
526 })
527 }
528
529 if s.Teams[team] == nil {
530 s.Teams[team] = []*protocol.StatePlayer{}
531 }
532 }
533
534 for row := range s.Board {
535 tiles := make([]*protocol.StateTile, room.Board.Cols)
536 for col := range tiles {
537 tile := room.Board.Get(row, col)
538 sTile := &protocol.StateTile{
539 Word: tile.Word,
540 Revealed: tile.Revealed,
541 }
542
543 if spymaster || tile.Revealed || room.Winner != nil {
544 view := &protocol.StateView{
545 Team: tile.Team,
546 Neutral: tile.Neutral,
547 Bomb: tile.Bomb,
548 }
549
550 if view.Bomb && !tile.Revealed && room.Winner == nil && r.hideBomb {
551 view.Neutral = true
552 view.Bomb = false
553 }
554
555 sTile.View = view
556 }
557
558 tiles[col] = sTile
559 }
560
561 s.Board[row] = tiles
562 }
563
564 for i, wl := range room.WordLists {
565 s.Lists[i] = &protocol.StateWordList{
566 Name: wl.Name,
567 Count: wl.List.Len(),
568 Custom: wl.Custom,
569 Enabled: wl.Enabled,
570 }
571 }
572
573 return s
574}
575
576// Must be called with r.mu locked.
577func (r *Room) changeTurnMode(timed bool) {
578 if r.timed == timed {
579 return
580 }
581
582 r.timed = timed
583
584 if timed {
585 r.startTimer()
586 } else {
587 r.stopTimer()
588 }
589
590 r.room.Version++
591}
592
593// Must be called with r.mu locked.
594func (r *Room) changeTurnTime(seconds int) {
595 if seconds <= 0 || r.turnSeconds == seconds {
596 return
597 }
598
599 r.turnSeconds = seconds
600
601 if r.timed {
602 r.startTimer()
603 }
604
605 r.room.Version++
606}
607
608func (r *Room) timerEndTurn() {
609 r.mu.Lock()
610 defer r.mu.Unlock()
611
612 stopped := r.stopTimer()
613 if !stopped {
614 // Room was pruned.
615 return
616 }
617
618 r.turnTimer = nil
619 r.turnDeadline = nil
620
621 if r.room.Winner != nil || r.turnSeconds == 0 {
622 return
623 }
624
625 r.room.ForceEndTurn()
626 r.startTimer()
627 r.sendAll()
628}
629
630// Must be called with r.mu locked.
631func (r *Room) stopTimer() (stopped bool) {
632 if r.turnTimer != nil {
633 r.turnTimer.Stop()
634 stopped = true
635 }
636 r.turnTimer = nil
637 r.turnDeadline = nil
638 return stopped
639}
640
641// Must be called with r.mu locked.
642func (r *Room) startTimer() {
643 if !r.timed {
644 panic("startTimer called on non-timed room")
645 }
646
647 if r.turnTimer != nil {
648 r.turnTimer.Stop()
649 }
650
651 dur := time.Second * time.Duration(r.turnSeconds)
652 deadline := time.Now().Add(dur)
653 r.turnDeadline = &deadline
654 r.turnTimer = time.AfterFunc(dur, r.timerEndTurn)
655}
656
657// Must be called with r.mu locked.
658func (r *Room) changeHideBomb(HideBomb bool) {
659 if r.hideBomb == HideBomb {
660 return
661 }
662
663 r.hideBomb = HideBomb
664 r.room.Version++
665}