@sudobility/sudojo_lib 0.0.68 → 0.0.73

package/dist/config/authProviders.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Shared auth provider configuration
+ *
+ * Single source of truth for which authentication providers are enabled
+ * across all Sudojo apps (web and mobile).
+ */
+/** Available authentication provider types */
+export type AuthProviderType = 'google' | 'apple' | 'email';
+/** Configuration for enabled auth providers */
+export interface AuthProvidersConfig {
+    /** Which providers to enable */
+    providers: AuthProviderType[];
+    /** Enable anonymous sign-in fallback */
+    enableAnonymous?: boolean;
+}
+/** Default auth providers config used by all apps */
+export declare const DEFAULT_AUTH_PROVIDERS: AuthProvidersConfig;
+//# sourceMappingURL=authProviders.d.ts.map

package/dist/config/authProviders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authProviders.d.ts","sourceRoot":"","sources":["../../src/config/authProviders.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,8CAA8C;AAC9C,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAC;AAE5D,+CAA+C;AAC/C,MAAM,WAAW,mBAAmB;IAClC,gCAAgC;IAChC,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,wCAAwC;IACxC,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,qDAAqD;AACrD,eAAO,MAAM,sBAAsB,EAAE,mBAGpC,CAAC"}

package/dist/config/authProviders.js

@@ -0,0 +1,12 @@
+/**
+ * Shared auth provider configuration
+ *
+ * Single source of truth for which authentication providers are enabled
+ * across all Sudojo apps (web and mobile).
+ */
+/** Default auth providers config used by all apps */
+export const DEFAULT_AUTH_PROVIDERS = {
+    providers: ['google', 'email'],
+    enableAnonymous: true,
+};
+//# sourceMappingURL=authProviders.js.map

package/dist/config/authProviders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"authProviders.js","sourceRoot":"","sources":["../../src/config/authProviders.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAaH,qDAAqD;AACrD,MAAM,CAAC,MAAM,sBAAsB,GAAwB;IACzD,SAAS,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC9B,eAAe,EAAE,IAAI;CACtB,CAAC"}

package/dist/config/index.d.ts

@@ -0,0 +1,3 @@
+export type { AuthProviderType, AuthProvidersConfig } from './authProviders';
+export { DEFAULT_AUTH_PROVIDERS } from './authProviders';
+//# sourceMappingURL=index.d.ts.map

package/dist/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAC7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/config/index.js

@@ -0,0 +1,2 @@
+export { DEFAULT_AUTH_PROVIDERS } from './authProviders';
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/hooks/index.d.ts

@@ -26,4 +26,8 @@ export { useHint } from './useHint';
 export type { UseHintOptions, UseHintResult, HintBoardData, HintReceivedData, HintAccessError, } from './useHint';
 export { useGamePlay } from './useGamePlay';
 export type { UseGamePlayOptions, UseGamePlayResult } from './useGamePlay';
+export { useBoardEntry } from './useBoardEntry';
+export type { UseBoardEntryOptions, UseBoardEntryReturn, ValidatedPuzzle, } from './useBoardEntry';
+export { useGameSession } from './useGameSession';
+export type { UseGameSessionOptions, GameSessionResult, GameFinishResult, } from './useGameSession';
 //# sourceMappingURL=index.d.ts.map

package/dist/hooks/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAClD,YAAY,EACV,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,eAAe,GAChB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC9D,YAAY,EACV,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC7D,YAAY,EACV,sBAAsB,EACtB,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAG/D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EACV,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGrE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EACV,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,GAChB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAG9E,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAG9E,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACvE,YAAY,EACV,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGpD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,YAAY,EACV,cAAc,EACd,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,eAAe,GAChB,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAClD,YAAY,EACV,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,eAAe,GAChB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC9D,YAAY,EACV,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC7D,YAAY,EACV,sBAAsB,EACtB,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAG/D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EACV,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGrE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EACV,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,GAChB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAG9E,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAG9E,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACvE,YAAY,EACV,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGpD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,YAAY,EACV,cAAc,EACd,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,eAAe,GAChB,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAG3E,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EACV,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,GAChB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EACV,qBAAqB,EACrB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,kBAAkB,CAAC"}

package/dist/hooks/index.js

@@ -26,4 +26,8 @@ export { useLocalStorage } from './useLocalStorage';
 export { useHint } from './useHint';
 // Game play hook (current game management)
 export { useGamePlay } from './useGamePlay';
+// Board entry hook
+export { useBoardEntry } from './useBoardEntry';
+// Game session hook
+export { useGameSession } from './useGameSession';
 //# sourceMappingURL=index.js.map

package/dist/hooks/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAe;AACf,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAQlD,mBAAmB;AACnB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAQ9D,iBAAiB;AACjB,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAQ7D,sBAAsB;AACtB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,iBAAiB;AACjB,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAMpD,wCAAwC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC,wDAAwD;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAO9C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C,kBAAkB;AAClB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C,yBAAyB;AACzB,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAMvE,qBAAqB;AACrB,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,YAAY;AACZ,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASpC,2CAA2C;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAe;AACf,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAQlD,mBAAmB;AACnB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAQ9D,iBAAiB;AACjB,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAQ7D,sBAAsB;AACtB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,iBAAiB;AACjB,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAMpD,wCAAwC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC,wDAAwD;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAO9C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C,kBAAkB;AAClB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C,yBAAyB;AACzB,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAMvE,qBAAqB;AACrB,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,YAAY;AACZ,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASpC,2CAA2C;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C,mBAAmB;AACnB,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAOhD,oBAAoB;AACpB,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/hooks/useBoardEntry.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Hook for managing Sudoku board entry mode state
+ * Allows users to enter given clues for a custom puzzle
+ */
+import type { SudokuCell } from '../types';
+import type { NetworkClient } from '@sudobility/types';
+export interface ValidatedPuzzle {
+    puzzle: string;
+    solution: string;
+}
+export interface UseBoardEntryOptions {
+    networkClient: NetworkClient;
+    baseUrl: string;
+    token: string;
+}
+export interface UseBoardEntryReturn {
+    /** 81 cells with given values only */
+    cells: SudokuCell[];
+    /** Currently selected cell index */
+    selectedIndex: number | null;
+    /** Whether validation is in progress */
+    isValidating: boolean;
+    /** Validation error message key */
+    validationError: string | null;
+    /** Validated puzzle data (puzzle + solution) */
+    validatedPuzzle: ValidatedPuzzle | null;
+    /** Select a cell by index */
+    selectCell: (index: number) => void;
+    /** Set a given value at the selected cell */
+    setGiven: (value: number) => void;
+    /** Erase the selected cell */
+    erase: () => void;
+    /** Get the puzzle as an 81-character string */
+    getPuzzleString: () => string;
+    /** Trigger validation */
+    validate: () => void;
+    /** Reset to empty board */
+    reset: () => void;
+    /** Number of clues entered */
+    clueCount: number;
+    /** Set cells from an 81-character puzzle string */
+    setCellsFromPuzzle: (puzzle: string) => void;
+}
+export declare function useBoardEntry({ networkClient, baseUrl, token, }: UseBoardEntryOptions): UseBoardEntryReturn;
+//# sourceMappingURL=useBoardEntry.d.ts.map

package/dist/hooks/useBoardEntry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBoardEntry.d.ts","sourceRoot":"","sources":["../../src/hooks/useBoardEntry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,aAAa,EAAE,aAAa,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,sCAAsC;IACtC,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,oCAAoC;IACpC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,wCAAwC;IACxC,YAAY,EAAE,OAAO,CAAC;IACtB,mCAAmC;IACnC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,gDAAgD;IAChD,eAAe,EAAE,eAAe,GAAG,IAAI,CAAC;IACxC,6BAA6B;IAC7B,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,6CAA6C;IAC7C,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,8BAA8B;IAC9B,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,+CAA+C;IAC/C,eAAe,EAAE,MAAM,MAAM,CAAC;IAC9B,yBAAyB;IACzB,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,2BAA2B;IAC3B,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,kBAAkB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9C;AAsDD,wBAAgB,aAAa,CAAC,EAC5B,aAAa,EACb,OAAO,EACP,KAAK,GACN,EAAE,oBAAoB,GAAG,mBAAmB,CAoK5C"}

package/dist/hooks/useBoardEntry.js

@@ -0,0 +1,197 @@
+/**
+ * Hook for managing Sudoku board entry mode state
+ * Allows users to enter given clues for a custom puzzle
+ */
+import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
+import { useSolverValidate } from '@sudobility/sudojo_client';
+/**
+ * Create an empty 81-cell board for entry mode
+ */
+function createEmptyBoard() {
+    return Array.from({ length: 81 }, (_, index) => ({
+        index,
+        solution: null,
+        given: null,
+        input: null,
+        pencilmarks: null,
+    }));
+}
+/**
+ * Convert cells to 81-character puzzle string
+ * '0' for empty, '1'-'9' for given values
+ */
+function cellsToPuzzleString(cells) {
+    return cells.map(cell => cell.given?.toString() ?? '0').join('');
+}
+/**
+ * Count the number of non-empty cells (clues)
+ */
+function countClues(cells) {
+    return cells.filter(cell => cell.given !== null).length;
+}
+/**
+ * Create a board from an 81-character puzzle string
+ * '0' or '.' for empty, '1'-'9' for given values
+ */
+function puzzleStringToCells(puzzle) {
+    if (puzzle.length !== 81) {
+        return createEmptyBoard();
+    }
+    return Array.from({ length: 81 }, (_, index) => {
+        const char = puzzle.charAt(index);
+        const value = parseInt(char, 10);
+        const given = value >= 1 && value <= 9 ? value : null;
+        return {
+            index,
+            solution: null,
+            given,
+            input: null,
+            pencilmarks: null,
+        };
+    });
+}
+export function useBoardEntry({ networkClient, baseUrl, token, }) {
+    const [cells, setCells] = useState(createEmptyBoard);
+    const [selectedIndex, setSelectedIndex] = useState(null);
+    const [validationError, setValidationError] = useState(null);
+    const [validatedPuzzle, setValidatedPuzzle] = useState(null);
+    const [shouldValidate, setShouldValidate] = useState(false);
+    // Compute puzzle string for validation
+    const puzzleString = useMemo(() => cellsToPuzzleString(cells), [cells]);
+    const clueCount = useMemo(() => countClues(cells), [cells]);
+    // Use the solver validate hook
+    const { data: validateData, isLoading: isValidating } = useSolverValidate(networkClient, baseUrl, token, { original: puzzleString }, {
+        enabled: shouldValidate && clueCount >= 17,
+        retry: false,
+    });
+    // Track whether we've already processed this validation result
+    const processedDataRef = useRef(null);
+    // Handle validation result
+    useEffect(() => {
+        if (!shouldValidate || isValidating)
+            return;
+        if (!validateData)
+            return;
+        // Avoid re-processing the same result
+        if (processedDataRef.current === validateData)
+            return;
+        processedDataRef.current = validateData;
+        // ValidateData has board.solution
+        const solution = validateData.data?.board?.solution;
+        if (validateData.success && solution) {
+            setValidatedPuzzle({
+                puzzle: puzzleString,
+                solution,
+            });
+            setValidationError(null);
+        }
+        else if (validateData.error) {
+            // Validation failed with specific error
+            const errorMsg = validateData.error.toLowerCase();
+            if (errorMsg.includes('multiple') || errorMsg.includes('not unique')) {
+                setValidationError('enter.errors.multipleSolutions');
+            }
+            else if (errorMsg.includes('cannot solve') ||
+                errorMsg.includes('no solution')) {
+                setValidationError('enter.errors.noSolution');
+            }
+            else {
+                setValidationError('enter.errors.validationFailed');
+            }
+            setValidatedPuzzle(null);
+        }
+        else {
+            // Unexpected response - success but no solution
+            console.error('Unexpected validation response:', validateData);
+            setValidationError('enter.errors.validationFailed');
+            setValidatedPuzzle(null);
+        }
+        setShouldValidate(false);
+    }, [validateData, shouldValidate, isValidating, puzzleString]);
+    // Select a cell
+    const selectCell = useCallback((index) => {
+        if (index >= 0 && index < 81) {
+            setSelectedIndex(index);
+        }
+    }, []);
+    // Set a given value at the selected cell
+    const setGiven = useCallback((value) => {
+        if (selectedIndex === null || value < 1 || value > 9)
+            return;
+        setCells(prevCells => {
+            const newCells = [...prevCells];
+            const existing = newCells[selectedIndex];
+            if (existing) {
+                newCells[selectedIndex] = { ...existing, given: value };
+            }
+            return newCells;
+        });
+        // Clear validation state when board changes
+        setValidationError(null);
+        setValidatedPuzzle(null);
+    }, [selectedIndex]);
+    // Erase the selected cell
+    const erase = useCallback(() => {
+        if (selectedIndex === null)
+            return;
+        setCells(prevCells => {
+            const newCells = [...prevCells];
+            const existing = newCells[selectedIndex];
+            if (existing) {
+                newCells[selectedIndex] = { ...existing, given: null };
+            }
+            return newCells;
+        });
+        // Clear validation state when board changes
+        setValidationError(null);
+        setValidatedPuzzle(null);
+    }, [selectedIndex]);
+    // Get puzzle string
+    const getPuzzleString = useCallback(() => {
+        return puzzleString;
+    }, [puzzleString]);
+    // Trigger validation
+    const validate = useCallback(() => {
+        // Check minimum clues
+        if (clueCount < 17) {
+            setValidationError('enter.errors.notEnoughClues');
+            return;
+        }
+        // Clear previous state and trigger validation
+        setValidationError(null);
+        setValidatedPuzzle(null);
+        setShouldValidate(true);
+    }, [clueCount]);
+    // Reset to empty board
+    const reset = useCallback(() => {
+        setCells(createEmptyBoard());
+        setSelectedIndex(null);
+        setValidationError(null);
+        setValidatedPuzzle(null);
+        setShouldValidate(false);
+    }, []);
+    // Set cells from puzzle string
+    const setCellsFromPuzzle = useCallback((puzzle) => {
+        setCells(puzzleStringToCells(puzzle));
+        setSelectedIndex(null);
+        setValidationError(null);
+        setValidatedPuzzle(null);
+        setShouldValidate(false);
+    }, []);
+    return {
+        cells,
+        selectedIndex,
+        isValidating,
+        validationError,
+        validatedPuzzle,
+        selectCell,
+        setGiven,
+        erase,
+        getPuzzleString,
+        validate,
+        reset,
+        clueCount,
+        setCellsFromPuzzle,
+    };
+}
+//# sourceMappingURL=useBoardEntry.js.map

package/dist/hooks/useBoardEntry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBoardEntry.js","sourceRoot":"","sources":["../../src/hooks/useBoardEntry.ts"],"names":[],"mappings":"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"}

package/dist/hooks/useGamePlay.d.ts

@@ -2,11 +2,12 @@
  * Hook for managing the current game
  *
  * Provides a clean API for starting, updating, and clearing the current game.
- * Includes debounced auto-save to avoid excessive localStorage writes.
+ * The `slot` option selects which independent store slot to use ('daily' or 'play'),
+ * keeping the returned function signatures identical to before.
  *
  * @example
  * ```tsx
- * const { currentGame, startGame, updateProgress, clearGame } = useGamePlay();
+ * const { currentGame, startGame, updateProgress, clearGame } = useGamePlay({ slot: 'daily' });
  *
  * // Start a new game
  * startGame('daily', puzzle, solution, { dailyDate: '2024-01-15' });
@@ -18,8 +19,10 @@
  * clearGame();
  * ```
  */
-import type { CurrentGame, CurrentGameMeta, GameSource } from '../types/currentGame';
+import type { CurrentGame, CurrentGameMeta, GameSlot, GameSource } from '../types/currentGame';
 export interface UseGamePlayOptions {
+    /** Which game slot to use (default: 'play') */
+    slot?: GameSlot;
     /** Debounce delay for auto-save in ms (default: 2000) */
     autoSaveDelay?: number;
 }

package/dist/hooks/useGamePlay.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useGamePlay.d.ts","sourceRoot":"","sources":["../../src/hooks/useGamePlay.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH,OAAO,KAAK,EACV,WAAW,EACX,eAAe,EACf,UAAU,EACX,MAAM,sBAAsB,CAAC;AAK9B,MAAM,WAAW,kBAAkB;IACjC,yDAAyD;IACzD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,wCAAwC;IACxC,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;IAChC,qCAAqC;IACrC,cAAc,EAAE,OAAO,CAAC;IACxB,uBAAuB;IACvB,SAAS,EAAE,CACT,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,eAAe,KACnB,IAAI,CAAC;IACV,6CAA6C;IAC7C,cAAc,EAAE,CACd,WAAW,EAAE,MAAM,EACnB,iBAAiB,EAAE,MAAM,EACzB,YAAY,EAAE,OAAO,EACrB,WAAW,EAAE,MAAM,KAChB,IAAI,CAAC;IACV,8CAA8C;IAC9C,SAAS,EAAE,MAAM,IAAI,CAAC;CACvB;AAED,wBAAgB,WAAW,CACzB,OAAO,GAAE,kBAAuB,GAC/B,iBAAiB,CAwDnB"}
+{"version":3,"file":"useGamePlay.d.ts","sourceRoot":"","sources":["../../src/hooks/useGamePlay.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,OAAO,KAAK,EACV,WAAW,EACX,eAAe,EACf,QAAQ,EACR,UAAU,EACX,MAAM,sBAAsB,CAAC;AAE9B,MAAM,WAAW,kBAAkB;IACjC,+CAA+C;IAC/C,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,yDAAyD;IACzD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,wCAAwC;IACxC,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;IAChC,qCAAqC;IACrC,cAAc,EAAE,OAAO,CAAC;IACxB,uBAAuB;IACvB,SAAS,EAAE,CACT,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,eAAe,KACnB,IAAI,CAAC;IACV,6CAA6C;IAC7C,cAAc,EAAE,CACd,WAAW,EAAE,MAAM,EACnB,iBAAiB,EAAE,MAAM,EACzB,YAAY,EAAE,OAAO,EACrB,WAAW,EAAE,MAAM,KAChB,IAAI,CAAC;IACV,8CAA8C;IAC9C,SAAS,EAAE,MAAM,IAAI,CAAC;CACvB;AAED,wBAAgB,WAAW,CACzB,OAAO,GAAE,kBAAuB,GAC/B,iBAAiB,CAmFnB"}

package/dist/hooks/useGamePlay.js

@@ -2,11 +2,12 @@
  * Hook for managing the current game
  *
  * Provides a clean API for starting, updating, and clearing the current game.
- * Includes debounced auto-save to avoid excessive localStorage writes.
+ * The `slot` option selects which independent store slot to use ('daily' or 'play'),
+ * keeping the returned function signatures identical to before.
  *
  * @example
  * ```tsx
- * const { currentGame, startGame, updateProgress, clearGame } = useGamePlay();
+ * const { currentGame, startGame, updateProgress, clearGame } = useGamePlay({ slot: 'daily' });
  *
  * // Start a new game
  * startGame('daily', puzzle, solution, { dailyDate: '2024-01-15' });
@@ -20,14 +21,23 @@
  */
 import { useCallback, useEffect, useRef } from 'react';
 import { useGamePlayStore } from '../stores/gamePlayStore';
-// Get stable reference to store actions (doesn't change on state updates)
-const getStoreActions = () => useGamePlayStore.getState();
 export function useGamePlay(options = {}) {
-    const { autoSaveDelay = 2000 } = options;
-    const store = useGamePlayStore();
+    const { slot = 'play', autoSaveDelay = 2000 } = options;
+    // Select the correct slot from the store
+    const currentGame = useGamePlayStore(s => slot === 'daily' ? s.dailyGame : s.playGame);
     const timeoutRef = useRef(null);
     const pendingUpdate = useRef(null);
-    // Debounced update - uses getState() for stable reference
+    // Curry slot into startGame so callers keep the same signature
+    const startGame = useCallback((source, puzzle, solution, meta) => {
+        useGamePlayStore
+            .getState()
+            .startGame(slot, source, puzzle, solution, meta);
+    }, [slot]);
+    // Curry slot into clearGame
+    const clearGame = useCallback(() => {
+        useGamePlayStore.getState().clearGame(slot);
+    }, [slot]);
+    // Debounced update — curries slot
     const updateProgress = useCallback((inputString, pencilmarksString, isPencilMode, elapsedTime) => {
         pendingUpdate.current = [
             inputString,
@@ -40,12 +50,13 @@ export function useGamePlay(options = {}) {
         }
         timeoutRef.current = setTimeout(() => {
             if (pendingUpdate.current) {
-                // Use getState() to get stable reference that doesn't trigger re-renders
-                getStoreActions().updateProgress(...pendingUpdate.current);
+                useGamePlayStore
+                    .getState()
+                    .updateProgress(slot, ...pendingUpdate.current);
                 pendingUpdate.current = null;
             }
         }, autoSaveDelay);
-    }, [autoSaveDelay]);
+    }, [slot, autoSaveDelay]);
     // Flush pending updates on unmount only
     useEffect(() => {
         return () => {
@@ -53,17 +64,18 @@ export function useGamePlay(options = {}) {
                 clearTimeout(timeoutRef.current);
             }
             if (pendingUpdate.current) {
-                // Use getState() to get stable reference that doesn't trigger re-renders
-                getStoreActions().updateProgress(...pendingUpdate.current);
+                useGamePlayStore
+                    .getState()
+                    .updateProgress(slot, ...pendingUpdate.current);
             }
         };
-    }, []); // Empty deps - only run cleanup on actual unmount
+    }, [slot]);
     return {
-        currentGame: store.currentGame,
-        hasCurrentGame: store.currentGame !== null,
-        startGame: store.startGame,
+        currentGame,
+        hasCurrentGame: currentGame !== null,
+        startGame,
         updateProgress,
-        clearGame: store.clearGame,
+        clearGame,
     };
 }
 //# sourceMappingURL=useGamePlay.js.map

package/dist/hooks/useGamePlay.js.map

@@ -1 +1 @@
-{"version":3,"file":"useGamePlay.js","sourceRoot":"","sources":["../../src/hooks/useGamePlay.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAO3D,0EAA0E;AAC1E,MAAM,eAAe,GAAG,GAAG,EAAE,CAAC,gBAAgB,CAAC,QAAQ,EAAE,CAAC;AA8B1D,MAAM,UAAU,WAAW,CACzB,UAA8B,EAAE;IAEhC,MAAM,EAAE,aAAa,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IACzC,MAAM,KAAK,GAAG,gBAAgB,EAAE,CAAC;IACjC,MAAM,UAAU,GAAG,MAAM,CAAuC,IAAI,CAAC,CAAC;IACtE,MAAM,aAAa,GAAG,MAAM,CAA2C,IAAI,CAAC,CAAC;IAE7E,0DAA0D;IAC1D,MAAM,cAAc,GAAG,WAAW,CAChC,CACE,WAAmB,EACnB,iBAAyB,EACzB,YAAqB,EACrB,WAAmB,EACnB,EAAE;QACF,aAAa,CAAC,OAAO,GAAG;YACtB,WAAW;YACX,iBAAiB;YACjB,YAAY;YACZ,WAAW;SACZ,CAAC;QAEF,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;YACvB,YAAY,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QACnC,CAAC;QAED,UAAU,CAAC,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;YACnC,IAAI,aAAa,CAAC,OAAO,EAAE,CAAC;gBAC1B,yEAAyE;gBACzE,eAAe,EAAE,CAAC,cAAc,CAAC,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;gBAC3D,aAAa,CAAC,OAAO,GAAG,IAAI,CAAC;YAC/B,CAAC;QACH,CAAC,EAAE,aAAa,CAAC,CAAC;IACpB,CAAC,EACD,CAAC,aAAa,CAAC,CAChB,CAAC;IAEF,wCAAwC;IACxC,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,GAAG,EAAE;YACV,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;gBACvB,YAAY,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;YACnC,CAAC;YACD,IAAI,aAAa,CAAC,OAAO,EAAE,CAAC;gBAC1B,yEAAyE;gBACzE,eAAe,EAAE,CAAC,cAAc,CAAC,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;YAC7D,CAAC;QACH,CAAC,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,kDAAkD;IAE1D,OAAO;QACL,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,cAAc,EAAE,KAAK,CAAC,WAAW,KAAK,IAAI;QAC1C,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,cAAc;QACd,SAAS,EAAE,KAAK,CAAC,SAAS;KAC3B,CAAC;AACJ,CAAC"}
+{"version":3,"file":"useGamePlay.js","sourceRoot":"","sources":["../../src/hooks/useGamePlay.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAsC3D,MAAM,UAAU,WAAW,CACzB,UAA8B,EAAE;IAEhC,MAAM,EAAE,IAAI,GAAG,MAAM,EAAE,aAAa,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IAExD,yCAAyC;IACzC,MAAM,WAAW,GAAG,gBAAgB,CAAC,CAAC,CAAC,EAAE,CACvC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAC5C,CAAC;IAEF,MAAM,UAAU,GAAG,MAAM,CAAuC,IAAI,CAAC,CAAC;IACtE,MAAM,aAAa,GAAG,MAAM,CAA2C,IAAI,CAAC,CAAC;IAE7E,+DAA+D;IAC/D,MAAM,SAAS,GAAG,WAAW,CAC3B,CACE,MAAkB,EAClB,MAAc,EACd,QAAgB,EAChB,IAAsB,EACtB,EAAE;QACF,gBAAgB;aACb,QAAQ,EAAE;aACV,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;IACrD,CAAC,EACD,CAAC,IAAI,CAAC,CACP,CAAC;IAEF,4BAA4B;IAC5B,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE;QACjC,gBAAgB,CAAC,QAAQ,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC9C,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IAEX,kCAAkC;IAClC,MAAM,cAAc,GAAG,WAAW,CAChC,CACE,WAAmB,EACnB,iBAAyB,EACzB,YAAqB,EACrB,WAAmB,EACnB,EAAE;QACF,aAAa,CAAC,OAAO,GAAG;YACtB,WAAW;YACX,iBAAiB;YACjB,YAAY;YACZ,WAAW;SACZ,CAAC;QAEF,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;YACvB,YAAY,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QACnC,CAAC;QAED,UAAU,CAAC,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;YACnC,IAAI,aAAa,CAAC,OAAO,EAAE,CAAC;gBAC1B,gBAAgB;qBACb,QAAQ,EAAE;qBACV,cAAc,CAAC,IAAI,EAAE,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;gBAClD,aAAa,CAAC,OAAO,GAAG,IAAI,CAAC;YAC/B,CAAC;QACH,CAAC,EAAE,aAAa,CAAC,CAAC;IACpB,CAAC,EACD,CAAC,IAAI,EAAE,aAAa,CAAC,CACtB,CAAC;IAEF,wCAAwC;IACxC,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,GAAG,EAAE;YACV,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;gBACvB,YAAY,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;YACnC,CAAC;YACD,IAAI,aAAa,CAAC,OAAO,EAAE,CAAC;gBAC1B,gBAAgB;qBACb,QAAQ,EAAE;qBACV,cAAc,CAAC,IAAI,EAAE,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;YACpD,CAAC;QACH,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IAEX,OAAO;QACL,WAAW;QACX,cAAc,EAAE,WAAW,KAAK,IAAI;QACpC,SAAS;QACT,cAAc;QACd,SAAS;KACV,CAAC;AACJ,CAAC"}

package/dist/hooks/useGameSession.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Hook for managing game sessions with gamification
+ *
+ * Handles:
+ * - Starting game sessions on the server
+ * - Finishing game sessions and receiving rewards
+ * - Tracking achievement results for display
+ */
+import type { GameFinishResponse, GameStartRequest } from '@sudobility/sudojo_types';
+import type { NetworkClient } from '@sudobility/types';
+export interface UseGameSessionOptions {
+    networkClient: NetworkClient;
+    baseUrl: string;
+    token: string | null;
+    userId: string | null;
+}
+export interface GameSessionResult {
+    /** Whether a server session was started */
+    sessionStarted: boolean;
+    /** Session ID from server (if started) */
+    sessionId?: string;
+}
+export interface GameFinishResult {
+    /** The full response from the server */
+    response?: GameFinishResponse;
+    /** Whether the user leveled up */
+    leveledUp: boolean;
+    /** New badges earned */
+    newBadges: Array<{
+        badgeKey: string;
+        title: string;
+        description: string | null;
+    }>;
+    /** Total points earned */
+    totalPointsEarned: number;
+}
+export declare function useGameSession({ networkClient, baseUrl, token, userId, }: UseGameSessionOptions): {
+    startSession: (data: GameStartRequest) => Promise<GameSessionResult>;
+    finishSession: (elapsedTime: number) => Promise<GameFinishResult>;
+    isStarting: boolean;
+    isFinishing: boolean;
+    isAuthenticated: boolean;
+    sessionId: string | null;
+};
+//# sourceMappingURL=useGameSession.d.ts.map

package/dist/hooks/useGameSession.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGameSession.d.ts","sourceRoot":"","sources":["../../src/hooks/useGameSession.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,KAAK,EACV,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,MAAM,WAAW,qBAAqB;IACpC,aAAa,EAAE,aAAa,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,2CAA2C;IAC3C,cAAc,EAAE,OAAO,CAAC;IACxB,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,wCAAwC;IACxC,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,kCAAkC;IAClC,SAAS,EAAE,OAAO,CAAC;IACnB,wBAAwB;IACxB,SAAS,EAAE,KAAK,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;KAC5B,CAAC,CAAC;IACH,0BAA0B;IAC1B,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAgB,cAAc,CAAC,EAC7B,aAAa,EACb,OAAO,EACP,KAAK,EACL,MAAM,GACP,EAAE,qBAAqB;yBAaP,gBAAgB,KAAG,OAAO,CAAC,iBAAiB,CAAC;iCAqCtC,MAAM,KAAG,OAAO,CAAC,gBAAgB,CAAC;;;;;EA4DzD"}

package/dist/hooks/useGameSession.js

@@ -0,0 +1,108 @@
+/**
+ * Hook for managing game sessions with gamification
+ *
+ * Handles:
+ * - Starting game sessions on the server
+ * - Finishing game sessions and receiving rewards
+ * - Tracking achievement results for display
+ */
+import { useCallback, useRef, useState } from 'react';
+import { useSudojoPlayFinish, useSudojoPlayStart, } from '@sudobility/sudojo_client';
+export function useGameSession({ networkClient, baseUrl, token, userId, }) {
+    const [isStarting, setIsStarting] = useState(false);
+    const [isFinishing, setIsFinishing] = useState(false);
+    const sessionIdRef = useRef(null);
+    const playStartMutation = useSudojoPlayStart(networkClient, baseUrl);
+    const playFinishMutation = useSudojoPlayFinish(networkClient, baseUrl);
+    /**
+     * Start a game session on the server
+     * Only works if user is authenticated
+     */
+    const startSession = useCallback(async (data) => {
+        // Skip if not authenticated
+        if (!userId || !token) {
+            return { sessionStarted: false };
+        }
+        setIsStarting(true);
+        try {
+            const response = await playStartMutation.mutateAsync({
+                token,
+                data,
+            });
+            if (response.success && response.data) {
+                sessionIdRef.current = response.data.sessionId;
+                return {
+                    sessionStarted: true,
+                    sessionId: response.data.sessionId,
+                };
+            }
+            return { sessionStarted: false };
+        }
+        catch (error) {
+            console.error('Failed to start game session:', error);
+            return { sessionStarted: false };
+        }
+        finally {
+            setIsStarting(false);
+        }
+    }, [userId, token, playStartMutation]);
+    /**
+     * Finish the game session and get rewards
+     * Only works if user is authenticated and session was started
+     */
+    const finishSession = useCallback(async (elapsedTime) => {
+        // Skip if not authenticated
+        if (!userId || !token) {
+            return {
+                leveledUp: false,
+                newBadges: [],
+                totalPointsEarned: 0,
+            };
+        }
+        setIsFinishing(true);
+        try {
+            const response = await playFinishMutation.mutateAsync({
+                token,
+                data: { elapsedTime },
+            });
+            sessionIdRef.current = null;
+            if (response.success && response.data) {
+                return {
+                    response: response.data,
+                    leveledUp: !!response.data.level,
+                    newBadges: response.data.badges ?? [],
+                    totalPointsEarned: response.data.points.totalPoints,
+                };
+            }
+            return {
+                leveledUp: false,
+                newBadges: [],
+                totalPointsEarned: 0,
+            };
+        }
+        catch (error) {
+            console.error('Failed to finish game session:', error);
+            return {
+                leveledUp: false,
+                newBadges: [],
+                totalPointsEarned: 0,
+            };
+        }
+        finally {
+            setIsFinishing(false);
+        }
+    }, [userId, token, playFinishMutation]);
+    /**
+     * Check if user is authenticated (can use gamification)
+     */
+    const isAuthenticated = !!userId && !!token;
+    return {
+        startSession,
+        finishSession,
+        isStarting,
+        isFinishing,
+        isAuthenticated,
+        sessionId: sessionIdRef.current,
+    };
+}
+//# sourceMappingURL=useGameSession.js.map