chore(release): 3.17.11 [skip ci]

## [3.17.11](https://github.com/antialias/soroban-abacus-flashcards/compare/v3.17.10...v3.17.11) (2025-10-15)

### Bug Fixes

* **memory-quiz:** fix playMode persistence by updating validator ([de0efd5](de0efd5932))

CHANGELOG.md

@@ -1,3 +1,31 @@
+## [3.17.11](https://github.com/antialias/soroban-abacus-flashcards/compare/v3.17.10...v3.17.11) (2025-10-15)
+
+
+### Bug Fixes
+
+* **memory-quiz:** fix playMode persistence by updating validator ([de0efd5](https://github.com/antialias/soroban-abacus-flashcards/commit/de0efd59321ec779cddb900724035884290419b7))
+
+## [3.17.10](https://github.com/antialias/soroban-abacus-flashcards/compare/v3.17.9...v3.17.10) (2025-10-15)
+
+
+### Bug Fixes
+
+* **memory-quiz:** persist playMode setting across game switches ([487ca7f](https://github.com/antialias/soroban-abacus-flashcards/commit/487ca7fba62e370c85bc3779ca8a96eb2c2cc3e3))
+
+## [3.17.9](https://github.com/antialias/soroban-abacus-flashcards/compare/v3.17.8...v3.17.9) (2025-10-15)
+
+
+### Bug Fixes
+
+* **arcade:** read nested gameConfig correctly when creating sessions ([94ef392](https://github.com/antialias/soroban-abacus-flashcards/commit/94ef39234d362b82e032cb69d3561b9fcb436eaf))
+
+## [3.17.8](https://github.com/antialias/soroban-abacus-flashcards/compare/v3.17.7...v3.17.8) (2025-10-15)
+
+
+### Bug Fixes
+
+* **arcade:** preserve game settings when returning to game selection ([0ee7739](https://github.com/antialias/soroban-abacus-flashcards/commit/0ee7739091d60580d2f98cfe288b8586b03348f3))
+
 ## [3.17.7](https://github.com/antialias/soroban-abacus-flashcards/compare/v3.17.6...v3.17.7) (2025-10-15)
 
 

apps/web/src/app/api/arcade/rooms/[roomId]/settings/route.ts

@@ -27,6 +27,36 @@ export async function PATCH(req: NextRequest, context: RouteContext) {
     const viewerId = await getViewerId()
     const body = await req.json()
 
+    console.log(
+      '[Settings API] PATCH request received:',
+      JSON.stringify(
+        {
+          roomId,
+          body,
+        },
+        null,
+        2
+      )
+    )
+
+    // Read current room state from database BEFORE any changes
+    const [currentRoom] = await db
+      .select()
+      .from(schema.arcadeRooms)
+      .where(eq(schema.arcadeRooms.id, roomId))
+
+    console.log(
+      '[Settings API] Current room state in database BEFORE update:',
+      JSON.stringify(
+        {
+          gameName: currentRoom?.gameName,
+          gameConfig: currentRoom?.gameConfig,
+        },
+        null,
+        2
+      )
+    )
+
     // Check if user is the host
     const members = await getRoomMembers(roomId)
     const currentMember = members.find((m) => m.userId === viewerId)
@@ -97,6 +127,11 @@ export async function PATCH(req: NextRequest, context: RouteContext) {
       updateData.gameConfig = body.gameConfig
     }
 
+    console.log(
+      '[Settings API] Update data to be written to database:',
+      JSON.stringify(updateData, null, 2)
+    )
+
     // If game is being changed (or cleared), delete the existing arcade session
     // This ensures a fresh session will be created with the new game settings
     if (body.gameName !== undefined) {
@@ -111,6 +146,18 @@ export async function PATCH(req: NextRequest, context: RouteContext) {
       .where(eq(schema.arcadeRooms.id, roomId))
       .returning()
 
+    console.log(
+      '[Settings API] Room state in database AFTER update:',
+      JSON.stringify(
+        {
+          gameName: updatedRoom.gameName,
+          gameConfig: updatedRoom.gameConfig,
+        },
+        null,
+        2
+      )
+    )
+
     // Broadcast game change to all room members
     if (body.gameName !== undefined) {
       const io = await getSocketIO()

apps/web/src/app/api/arcade/rooms/current/route.ts

@@ -28,6 +28,19 @@ export async function GET() {
       return NextResponse.json({ error: 'Room not found' }, { status: 404 })
     }
 
+    console.log(
+      '[Current Room API] Room data READ from database:',
+      JSON.stringify(
+        {
+          roomId,
+          gameName: room.gameName,
+          gameConfig: room.gameConfig,
+        },
+        null,
+        2
+      )
+    )
+
     // Get members
     const members = await getRoomMembers(roomId)
 

apps/web/src/app/arcade/matching/context/RoomMemoryPairsProvider.tsx

@@ -248,6 +248,22 @@ export function RoomMemoryPairsProvider({ children }: { children: ReactNode }) {
   // Derive game mode from active player count
   const gameMode = activePlayerCount > 1 ? 'multiplayer' : 'single'
 
+  // Track roomData.gameConfig changes
+  useEffect(() => {
+    console.log(
+      '[RoomMemoryPairsProvider] roomData.gameConfig changed:',
+      JSON.stringify(
+        {
+          gameConfig: roomData?.gameConfig,
+          roomId: roomData?.id,
+          gameName: roomData?.gameName,
+        },
+        null,
+        2
+      )
+    )
+  }, [roomData?.gameConfig, roomData?.id, roomData?.gameName])
+
   // Merge saved game config from room with initialState
   // Settings are scoped by game name to preserve settings when switching games
   const mergedInitialState = useMemo(() => {

apps/web/src/app/arcade/memory-quiz/context/RoomMemoryQuizProvider.tsx

@@ -210,19 +210,32 @@ export function RoomMemoryQuizProvider({ children }: { children: ReactNode }) {
   // Settings are scoped by game name to preserve settings when switching games
   const mergedInitialState = useMemo(() => {
     const gameConfig = roomData?.gameConfig as Record<string, any> | null | undefined
-    console.log('[RoomMemoryQuizProvider] Initializing - gameConfig:', gameConfig)
+    console.log(
+      '[RoomMemoryQuizProvider] Initializing - Full roomData.gameConfig:',
+      JSON.stringify(gameConfig, null, 2)
+    )
 
     if (!gameConfig) {
-      console.log('[RoomMemoryQuizProvider] No gameConfig, using initialState')
+      console.log(
+        '[RoomMemoryQuizProvider] No gameConfig, using initialState with playMode:',
+        initialState.playMode
+      )
       return initialState
     }
 
     // Get settings for this specific game (memory-quiz)
     const savedConfig = gameConfig['memory-quiz'] as Record<string, any> | null | undefined
-    console.log('[RoomMemoryQuizProvider] Loading saved config for memory-quiz:', savedConfig)
+    console.log(
+      '[RoomMemoryQuizProvider] Extracted memory-quiz config:',
+      JSON.stringify(savedConfig, null, 2)
+    )
+    console.log('[RoomMemoryQuizProvider] savedConfig.playMode value:', savedConfig?.playMode)
 
     if (!savedConfig) {
-      console.log('[RoomMemoryQuizProvider] No saved config for memory-quiz, using initialState')
+      console.log(
+        '[RoomMemoryQuizProvider] No saved config for memory-quiz, using initialState with playMode:',
+        initialState.playMode
+      )
       return initialState
     }
 
@@ -234,12 +247,20 @@ export function RoomMemoryQuizProvider({ children }: { children: ReactNode }) {
       selectedDifficulty: savedConfig.selectedDifficulty ?? initialState.selectedDifficulty,
       playMode: savedConfig.playMode ?? initialState.playMode,
     }
-    console.log('[RoomMemoryQuizProvider] Merged state:', {
-      selectedCount: merged.selectedCount,
-      displayTime: merged.displayTime,
-      selectedDifficulty: merged.selectedDifficulty,
-      playMode: merged.playMode,
-    })
+    console.log(
+      '[RoomMemoryQuizProvider] Merged state:',
+      JSON.stringify(
+        {
+          selectedCount: merged.selectedCount,
+          displayTime: merged.displayTime,
+          selectedDifficulty: merged.selectedDifficulty,
+          playMode: merged.playMode,
+        },
+        null,
+        2
+      )
+    )
+    console.log('[RoomMemoryQuizProvider] Final merged.playMode:', merged.playMode)
 
     return merged
   }, [roomData?.gameConfig])

apps/web/src/hooks/useRoomData.ts

@@ -634,6 +634,8 @@ export function useSetRoomGame() {
 
 /**
  * Clear/reset game for a room (host only)
+ * This only clears gameName (returns to game selection) but preserves gameConfig
+ * so settings persist when the user selects a game again.
  */
 async function clearRoomGameApi(roomId: string): Promise<void> {
   const response = await fetch(`/api/arcade/rooms/${roomId}/settings`, {
@@ -641,7 +643,7 @@ async function clearRoomGameApi(roomId: string): Promise<void> {
     headers: { 'Content-Type': 'application/json' },
     body: JSON.stringify({
       gameName: null,
-      gameConfig: null,
+      // DO NOT send gameConfig: null - we want to preserve settings!
     }),
   })
 

apps/web/src/lib/arcade/validation/MemoryQuizGameValidator.ts

@@ -405,8 +405,14 @@ export class MemoryQuizGameValidator
     selectedCount: number
     displayTime: number
     selectedDifficulty: DifficultyLevel
+    playMode?: 'cooperative' | 'competitive'
   }): SorobanQuizState {
-    return {
+    console.log(
+      '[MemoryQuizValidator] getInitialState called with config:',
+      JSON.stringify(config, null, 2)
+    )
+
+    const initialState: SorobanQuizState = {
       cards: [],
       quizCards: [],
       correctAnswers: [],
@@ -422,7 +428,7 @@ export class MemoryQuizGameValidator
       activePlayers: [],
       playerMetadata: {},
       playerScores: {},
-      playMode: 'cooperative',
+      playMode: config.playMode || 'cooperative',
       numberFoundBy: {},
       // UI state
       gamePhase: 'setup',
@@ -433,6 +439,9 @@ export class MemoryQuizGameValidator
       testingMode: false,
       showOnScreenKeyboard: false,
     }
+
+    console.log('[MemoryQuizValidator] getInitialState returning playMode:', initialState.playMode)
+    return initialState
   }
 }
 

apps/web/src/socket-server.ts

@@ -84,17 +84,45 @@ export function initializeSocketServer(httpServer: HTTPServer) {
               // Different games have different initial configs
               let initialState: any
               if (room.gameName === 'matching') {
+                // Access nested gameConfig: { matching: { gameType, difficulty, turnTimer } }
+                const matchingConfig = (room.gameConfig as any)?.matching || {}
                 initialState = validator.getInitialState({
-                  difficulty: (room.gameConfig as any)?.difficulty || 6,
-                  gameType: (room.gameConfig as any)?.gameType || 'abacus-numeral',
-                  turnTimer: (room.gameConfig as any)?.turnTimer || 30,
+                  difficulty: matchingConfig.difficulty || 6,
+                  gameType: matchingConfig.gameType || 'abacus-numeral',
+                  turnTimer: matchingConfig.turnTimer || 30,
                 })
               } else if (room.gameName === 'memory-quiz') {
-                initialState = validator.getInitialState({
-                  selectedCount: (room.gameConfig as any)?.selectedCount || 5,
-                  displayTime: (room.gameConfig as any)?.displayTime || 2.0,
-                  selectedDifficulty: (room.gameConfig as any)?.selectedDifficulty || 'easy',
-                })
+                // Access nested gameConfig: { 'memory-quiz': { selectedCount, displayTime, selectedDifficulty, playMode } }
+                const memoryQuizConfig = (room.gameConfig as any)?.['memory-quiz'] || {}
+                console.log(
+                  '[join-arcade-session] memory-quiz - Full room.gameConfig:',
+                  JSON.stringify(room.gameConfig, null, 2)
+                )
+                console.log(
+                  '[join-arcade-session] memory-quiz - Extracted memoryQuizConfig:',
+                  JSON.stringify(memoryQuizConfig, null, 2)
+                )
+                console.log(
+                  '[join-arcade-session] memory-quiz - playMode from config:',
+                  memoryQuizConfig.playMode
+                )
+
+                const configToPass = {
+                  selectedCount: memoryQuizConfig.selectedCount || 5,
+                  displayTime: memoryQuizConfig.displayTime || 2.0,
+                  selectedDifficulty: memoryQuizConfig.selectedDifficulty || 'easy',
+                  playMode: memoryQuizConfig.playMode || 'cooperative',
+                }
+                console.log(
+                  '[join-arcade-session] memory-quiz - Config being passed to getInitialState:',
+                  JSON.stringify(configToPass, null, 2)
+                )
+
+                initialState = validator.getInitialState(configToPass)
+                console.log(
+                  '[join-arcade-session] memory-quiz - initialState.playMode after getInitialState:',
+                  initialState.playMode
+                )
               } else {
                 // Fallback for other games
                 initialState = validator.getInitialState(room.gameConfig || {})
@@ -124,7 +152,17 @@ export function initializeSocketServer(httpServer: HTTPServer) {
               roomId,
               version: session.version,
               sessionUserId: session.userId,
+              gameName: session.currentGame,
             })
+
+            // Log playMode specifically for memory-quiz
+            if (session.currentGame === 'memory-quiz') {
+              console.log(
+                '[join-arcade-session] memory-quiz session - gameState.playMode:',
+                (session.gameState as any).playMode
+              )
+            }
+
             socket.emit('session-state', {
               gameState: session.gameState,
               currentGame: session.currentGame,

package.json

@@ -1,6 +1,6 @@
 {
   "name": "soroban-monorepo",
-  "version": "3.17.7",
+  "version": "3.17.11",
   "private": true,
   "description": "Beautiful Soroban Flashcard Generator - Monorepo",
   "workspaces": [