Match My Mind Game - Complete API Guide

class MatchMyMindService {
    private let baseURL = "https://your-api.com/api/games/match-my-mind"
    
    // Step 0: Check Current Game with Partner (NEW!)
    func getCurrentGame(userId: String) async throws -> CurrentGameResponse {
        let url = "(baseURL)?action=current_game&userId=(userId)"
        // ... networking code
    }
    
    // Step 1: Get Categories
    func getCategories() async throws -> CategoriesResponse {
        let url = "(baseURL)?action=categories"
        // ... networking code
    }
    
    // Step 2: Create Game
    func createGame(categoryId: String, playerId: String) async throws -> CreateGameResponse {
        let body = [
            "action": "create_game",
            "categoryId": categoryId,
            "playerId": playerId
        ]
        // ... POST request
    }
    
    // Step 3: Check Status (MOST IMPORTANT!)
    func getGameStatus(gameSessionId: String, playerId: String) async throws -> GameStatusResponse {
        let url = "(baseURL)?action=game_status&gameSessionId=(gameSessionId)&playerId=(playerId)"
        // ... networking code
    }
    
    // Step 4: Get Questions
    func getQuestions(categoryId: String) async throws -> QuestionsResponse {
        let url = "(baseURL)/categories?categoryId=(categoryId)"
        // ... networking code
    }
    
    // Step 4A: Get My Answers (waiting screen)
    func getMyAnswers(gameSessionId: String, playerId: String) async throws -> MyAnswersResponse {
        let url = "(baseURL)?action=my_answers&gameSessionId=(gameSessionId)&playerId=(playerId)"
        // ... networking code
    }
    
    // Step 4B: Submit Answer
    func submitAnswer(gameSessionId: String, playerId: String, questionId: String, 
                     selectedOption: String, answerType: String) async throws -> SubmitResponse {
        let body = [
            "action": "submit_answer",
            "gameSessionId": gameSessionId,
            "playerId": playerId,
            "questionId": questionId,
            "selectedOption": selectedOption,
            "answerType": answerType
        ]
        // ... POST request
    }
    
    // Step 5: Get Final Results
    func getGameComparison(gameSessionId: String, playerId: String) async throws -> ComparisonResponse {
        let url = "(baseURL)?action=game_comparison&gameSessionId=(gameSessionId)&playerId=(playerId)"
        // ... networking code
    }
}

// Usage in ViewController
class GameViewController: UIViewController {
    func viewDidLoad() {
        super.viewDidLoad()
        checkForCurrentGame()
    }
    
    // NEW: Check for existing game with partner first
    func checkForCurrentGame() {
        Task {
            let currentGame = try await gameService.getCurrentGame(userId: currentUserId)
            
            await MainActor.run {
                if let game = currentGame.currentGame {
                    // User has active game with partner - continue it
                    self.currentGameId = game._id
                    self.handleGameFlow()
                } else {
                    // No active game - show category selection
                    self.showCategorySelection()
                }
            }
        }
    }
    
    func handleGameFlow() {
        Task {
            // Always check status first!
            let status = try await gameService.getGameStatus(gameSessionId: currentGameId, playerId: currentUserId)
            
            await MainActor.run {
                switch status.gameStatus.currentAction {
                case "answer_for_self":
                    showQuestionScreen(answerType: "self")
                case "wait_for_partner_self":
                    showMyAnswersScreen()
                case "answer_for_partner": 
                    showQuestionScreen(answerType: "guess_partner")
                case "game_completed":
                    showResultsScreen()
                default:
                    break
                }
            }
        }
    }
    
    func onAnswerSubmitted() {
        // After submitting any answer, check status again!
        handleGameFlow()
    }
}