Refactoring api/controllers/game/draw.js to extract the game logic to helper methods

[Hakaabi]

Issue number

Relevant issue number

• Resolves Refactor Backend Endpoints to Use Helper Functions #12

Please check the following

• Do the tests still pass? (see Run the Tests)
• Is the code formatted properly? (see Linting (Formatting))
• For New Features:
  • Have tests been added to cover any new features or fixes?
  • Has the documentation been updated accordingly?

Please describe additional details for testing this change

---

Description:
with this pull request I aimed to introduce significant enhancement and refactoring to the backend game logic for better modularity, reusability, and maintainability according to the description written in the original issue cuttle-cards#505 in the of the original repository (cuttle-cards#505). Additionally, I have implemented unit tests h to validate the functionality of the refactored helper methods, ensuring style consistency with the existing test units.

Modification made to the files:

-Code Refactoring:
I extracted the omplex game logic from api/controllers/game/draw.js into and turned them into helper methods under the api/helpers/game-logic/ folder.
In this folder I created modular helper functions:

1. validateDrawConditions.js, which handles validation logic for drawing a card.
2. updateGameStateAfterDraw.js, which updates game state after a card is drawn.
3. publishGameState.j, which publishes game state changes to connected clients.
4. errorHandling.js, which manages error responses and logging.
   the was done with the aim of Improving readability, reusability, and for separation of concerns across the backend logic.

Lastly, Unit Testing:
I wrote a test suite located in tests/unit/specs/gameLogicHelpers.spec.js to validate each helper method:
validateDrawConditions, to ensure proper validation for various game scenarios.
updateGameStateAfterDraw, this confirms accurate updates to the game state.
publishGameState, validates correct broadcasting of game state changes.
errorHandling, Tests appropriate error response handling.