gameEvents: created `ANNOUNCE_UNO` event

[sethdivyansh]

Fixes: #132

Description

In short:

• Created announced_uno event.
• Added runningEvents with vulnerableToUNO and hasAnnouncedUNO subfields in engine.ts.
• Created getThrowableCards() in eventHandlerUtils.
• Handled corner cases related to the announced_uno event.
• Created tests for the announced_uno event and its corner cases.

The plan this PR followed to handle ANNOUNCE_UNO event:

• Players can announce UNO only if:
  • It's their turn and they have 2 cards, with at least one throwable card.
  • OR before the other players catch him not saying UNO.
• If a player fails to say "UNO" and isn't caught before the next player plays, they are considered to have announced UNO.
• Added runningEvents field in GameEngine with sub-fields vulnerableToUNO and hasAnnouncedUNO.
• Checked if the new player can announce UNO on each turn change.
• if the player is in position to say UNO, set vulnerableToUNO to this player.
• if the player announces UNO, it will set hasAnnounedUNO to this player, and set vulnerableToUNO to null.
• set vulnerableToUNO to null when the next player plays his turn.

  How to Test

  I have created some tests in events.test.ts

Checklist

• [x] I have tested these changes locally.
• [x] I have reviewed the code and ensured it follows the project's coding guidelines.
• [ ] I have updated the documentation, if necessary.
• [ ] I have assigned reviewers to this pull request.

Screenshots (if applicable)

[If your changes include any visual updates, provide screenshots here.]

[vercel[bot]]

@sethdivyansh is attempting to deploy a commit to the Shivansh Bhatanagar's projects Team on Vercel.

A member of the Team first needs to authorize it.

[sethdivyansh]

@kuv2707 According to the game rules, the vulnerable duration lasts until the next player has played their turn. Should I keep it this way, or should I set the vulnerable duration based on the number of players?

[kuv2707]

In that case, we'll go with the rules. It'll be easier to implement too

[sethdivyansh]

@kuv2707 I have made the changes and followed your structure with some modifications. Please see the updated structure in the PR description.

[kuv2707]

Please address this to fix the CI test.

[sethdivyansh]

Seems like we are allowing announce_uno when either the player has 2 cards and one of them is throwable, or he has only one card. This means we allow the player to announce uno even when its next player's turn now(which wasn't originally what I had thought). I am a little worried it would lead to race conditions, but the idea seems exciting right now (and would add to the thrill), so we can integrate this for now and see if it works well.

Seems good enough to merge, once the minor remarks are addressed

Yes, you are right. I have made it such that players can announce UNO even if it's next player's turn. As players can be caught not saying "UNO" before the next player has taken their turn.

[kuv2707]

This seems good for now, we can optimize this code later if need arises.

[kuv2707]

Merged, thanks @sethdivyansh