@sudobility/sudojo_lib 0.0.201 → 0.0.203

package/dist/hooks/useLearning.js.map

@@ -1 +1 @@
-{"version":3,"file":"useLearning.js","sourceRoot":"","sources":["../../src/hooks/useLearning.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Hook for fetching and managing learning materials for techniques\n */\n\nimport { useMemo } from 'react';\nimport type { Learning } from '@sudobility/sudojo_types';\nimport type { NetworkClient } from '@sudobility/types';\nimport {\n  useSudojoLearning,\n  useSudojoLearningItem,\n} from '@sudobility/sudojo_client';\n\nexport interface UseLearningOptions {\n  /** Network client for API calls */\n  networkClient: NetworkClient;\n  /** Base URL for the Sudojo API */\n  baseUrl: string;\n  /** Access token for authentication (optional for public data) */\n  token?: string;\n  /** Optional technique number to filter learning materials */\n  technique?: number;\n  /** Optional language code to filter learning materials */\n  languageCode?: string;\n  /** Whether to enable the query */\n  enabled?: boolean;\n}\n\nexport interface UseLearningResult {\n  /** All learning materials (optionally filtered) */\n  learningMaterials: Learning[];\n  /** Whether learning materials are loading */\n  isLoading: boolean;\n  /** Error if loading failed */\n  error: Error | null;\n  /** Refetch learning materials */\n  refetch: () => void;\n  /** Get learning material by UUID */\n  getLearningByUuid: (uuid: string) => Learning | undefined;\n  /** Learning materials sorted by index */\n  sortedLearning: Learning[];\n  /** Group learning materials by technique number */\n  learningByTechnique: Map<number, Learning[]>;\n  /** Group learning materials by language code */\n  learningByLanguage: Map<string, Learning[]>;\n}\n\n/**\n * Hook for fetching and managing learning materials\n *\n * @param options - Hook options\n * @returns Learning materials data and utilities\n *\n * @example\n * ```tsx\n * function LearningContent({ technique }: { technique: number }) {\n *   const { learningMaterials, isLoading, sortedLearning } = useLearning({\n *     networkClient,\n *     baseUrl: 'https://api.sudojo.com',\n *     technique,\n *     languageCode: 'en',\n *   });\n *\n *   if (isLoading) return <Loading />;\n *\n *   return (\n *     <div>\n *       {sortedLearning.map(item => (\n *         <div key={item.uuid}>\n *           <p>{item.text}</p>\n *           {item.image_url && <img src={item.image_url} alt=\"\" />}\n *         </div>\n *       ))}\n *     </div>\n *   );\n * }\n * ```\n */\nexport function useLearning(options: UseLearningOptions): UseLearningResult {\n  const {\n    networkClient,\n    baseUrl,\n    token = '',\n    technique,\n    languageCode,\n    enabled = true,\n  } = options;\n\n  const queryParams = useMemo(() => {\n    // Only return params if at least one filter is provided\n    if (technique === undefined && !languageCode) return undefined;\n    return {\n      technique: technique ?? undefined,\n      language_code: languageCode ?? undefined,\n    };\n  }, [technique, languageCode]);\n\n  const { data, isLoading, error, refetch } = useSudojoLearning(\n    networkClient,\n    baseUrl,\n    token,\n    queryParams,\n    { enabled }\n  );\n\n  const learningMaterials = useMemo(() => {\n    if (!data?.success || !data.data) return [];\n    return data.data;\n  }, [data]);\n\n  const sortedLearning = useMemo(() => {\n    return [...learningMaterials].sort((a, b) => {\n      // First sort by technique number, then by index\n      if (a.technique !== b.technique) {\n        return (a.technique ?? 0) - (b.technique ?? 0);\n      }\n      return a.index - b.index;\n    });\n  }, [learningMaterials]);\n\n  const getLearningByUuid = useMemo(() => {\n    const learningMap = new Map(learningMaterials.map(l => [l.uuid, l]));\n    return (uuid: string) => learningMap.get(uuid);\n  }, [learningMaterials]);\n\n  const learningByTechnique = useMemo(() => {\n    const byTechnique = new Map<number, Learning[]>();\n    for (const learning of sortedLearning) {\n      const key = learning.technique ?? 0;\n      const existing = byTechnique.get(key) ?? [];\n      existing.push(learning);\n      byTechnique.set(key, existing);\n    }\n    return byTechnique;\n  }, [sortedLearning]);\n\n  const learningByLanguage = useMemo(() => {\n    const byLanguage = new Map<string, Learning[]>();\n    for (const learning of sortedLearning) {\n      const key = learning.language_code;\n      const existing = byLanguage.get(key) ?? [];\n      existing.push(learning);\n      byLanguage.set(key, existing);\n    }\n    return byLanguage;\n  }, [sortedLearning]);\n\n  return {\n    learningMaterials,\n    isLoading,\n    error: error ?? null,\n    refetch: () => {\n      refetch();\n    },\n    getLearningByUuid,\n    sortedLearning,\n    learningByTechnique,\n    learningByLanguage,\n  };\n}\n\nexport interface UseLearningItemOptions {\n  /** Network client for API calls */\n  networkClient: NetworkClient;\n  /** Base URL for the Sudojo API */\n  baseUrl: string;\n  /** Access token for authentication (optional for public data) */\n  token?: string;\n  /** Learning item UUID to fetch */\n  learningUuid: string;\n  /** Whether to enable the query */\n  enabled?: boolean;\n}\n\nexport interface UseLearningItemResult {\n  /** The fetched learning item */\n  learningItem: Learning | null;\n  /** Whether learning item is loading */\n  isLoading: boolean;\n  /** Error if loading failed */\n  error: Error | null;\n  /** Refetch learning item */\n  refetch: () => void;\n}\n\n/**\n * Hook for fetching a single learning item by UUID\n *\n * @param options - Hook options\n * @returns Learning item data\n */\nexport function useLearningItem(\n  options: UseLearningItemOptions\n): UseLearningItemResult {\n  const {\n    networkClient,\n    baseUrl,\n    token = '',\n    learningUuid,\n    enabled = true,\n  } = options;\n\n  const { data, isLoading, error, refetch } = useSudojoLearningItem(\n    networkClient,\n    baseUrl,\n    token,\n    learningUuid,\n    {\n      enabled: enabled && !!learningUuid,\n    }\n  );\n\n  const learningItem = useMemo(() => {\n    if (!data?.success || !data.data) return null;\n    return data.data;\n  }, [data]);\n\n  return {\n    learningItem,\n    isLoading,\n    error: error ?? null,\n    refetch: () => {\n      refetch();\n    },\n  };\n}\n"]}
+{"version":3,"file":"useLearning.js","sourceRoot":"","sources":["../../src/hooks/useLearning.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Hook for fetching and managing learning materials for techniques\n */\n\nimport { useMemo } from 'react';\nimport type { Learning } from '@sudobility/sudojo_types';\nimport type { NetworkClient } from '@sudobility/types';\nimport { useResolvedSudojoApi } from '../context/SudojoApiContext';\nimport {\n  useSudojoLearning,\n  useSudojoLearningItem,\n} from '@sudobility/sudojo_client';\n\nexport interface UseLearningOptions {\n  /** Network client for API calls (default: SudojoApiProvider) */\n  networkClient?: NetworkClient | undefined;\n  /** Base URL for the Sudojo API (default: SudojoApiProvider) */\n  baseUrl?: string | undefined;\n  /** Access token for authentication (optional for public data) */\n  token?: string;\n  /** Optional technique number to filter learning materials */\n  technique?: number;\n  /** Optional language code to filter learning materials */\n  languageCode?: string;\n  /** Whether to enable the query */\n  enabled?: boolean;\n}\n\nexport interface UseLearningResult {\n  /** All learning materials (optionally filtered) */\n  learningMaterials: Learning[];\n  /** Whether learning materials are loading */\n  isLoading: boolean;\n  /** Error if loading failed */\n  error: Error | null;\n  /** Refetch learning materials */\n  refetch: () => void;\n  /** Get learning material by UUID */\n  getLearningByUuid: (uuid: string) => Learning | undefined;\n  /** Learning materials sorted by index */\n  sortedLearning: Learning[];\n  /** Group learning materials by technique number */\n  learningByTechnique: Map<number, Learning[]>;\n  /** Group learning materials by language code */\n  learningByLanguage: Map<string, Learning[]>;\n}\n\n/**\n * Hook for fetching and managing learning materials\n *\n * @param options - Hook options\n * @returns Learning materials data and utilities\n *\n * @example\n * ```tsx\n * function LearningContent({ technique }: { technique: number }) {\n *   const { learningMaterials, isLoading, sortedLearning } = useLearning({\n *     networkClient,\n *     baseUrl: 'https://api.sudojo.com',\n *     technique,\n *     languageCode: 'en',\n *   });\n *\n *   if (isLoading) return <Loading />;\n *\n *   return (\n *     <div>\n *       {sortedLearning.map(item => (\n *         <div key={item.uuid}>\n *           <p>{item.text}</p>\n *           {item.image_url && <img src={item.image_url} alt=\"\" />}\n *         </div>\n *       ))}\n *     </div>\n *   );\n * }\n * ```\n */\nexport function useLearning(options: UseLearningOptions): UseLearningResult {\n  const { technique, languageCode, enabled = true } = options;\n  const { networkClient, baseUrl, token } = useResolvedSudojoApi(\n    options,\n    'useLearning'\n  );\n\n  const queryParams = useMemo(() => {\n    // Only return params if at least one filter is provided\n    if (technique === undefined && !languageCode) return undefined;\n    return {\n      technique: technique ?? undefined,\n      language_code: languageCode ?? undefined,\n    };\n  }, [technique, languageCode]);\n\n  const { data, isLoading, error, refetch } = useSudojoLearning(\n    networkClient,\n    baseUrl,\n    token,\n    queryParams,\n    { enabled }\n  );\n\n  const learningMaterials = useMemo(() => {\n    if (!data?.success || !data.data) return [];\n    return data.data;\n  }, [data]);\n\n  const sortedLearning = useMemo(() => {\n    return [...learningMaterials].sort((a, b) => {\n      // First sort by technique number, then by index\n      if (a.technique !== b.technique) {\n        return (a.technique ?? 0) - (b.technique ?? 0);\n      }\n      return a.index - b.index;\n    });\n  }, [learningMaterials]);\n\n  const getLearningByUuid = useMemo(() => {\n    const learningMap = new Map(learningMaterials.map(l => [l.uuid, l]));\n    return (uuid: string) => learningMap.get(uuid);\n  }, [learningMaterials]);\n\n  const learningByTechnique = useMemo(() => {\n    const byTechnique = new Map<number, Learning[]>();\n    for (const learning of sortedLearning) {\n      const key = learning.technique ?? 0;\n      const existing = byTechnique.get(key) ?? [];\n      existing.push(learning);\n      byTechnique.set(key, existing);\n    }\n    return byTechnique;\n  }, [sortedLearning]);\n\n  const learningByLanguage = useMemo(() => {\n    const byLanguage = new Map<string, Learning[]>();\n    for (const learning of sortedLearning) {\n      const key = learning.language_code;\n      const existing = byLanguage.get(key) ?? [];\n      existing.push(learning);\n      byLanguage.set(key, existing);\n    }\n    return byLanguage;\n  }, [sortedLearning]);\n\n  return {\n    learningMaterials,\n    isLoading,\n    error: error ?? null,\n    refetch: () => {\n      refetch();\n    },\n    getLearningByUuid,\n    sortedLearning,\n    learningByTechnique,\n    learningByLanguage,\n  };\n}\n\nexport interface UseLearningItemOptions {\n  /** Network client for API calls (default: SudojoApiProvider) */\n  networkClient?: NetworkClient | undefined;\n  /** Base URL for the Sudojo API (default: SudojoApiProvider) */\n  baseUrl?: string | undefined;\n  /** Access token for authentication (optional for public data) */\n  token?: string;\n  /** Learning item UUID to fetch */\n  learningUuid: string;\n  /** Whether to enable the query */\n  enabled?: boolean;\n}\n\nexport interface UseLearningItemResult {\n  /** The fetched learning item */\n  learningItem: Learning | null;\n  /** Whether learning item is loading */\n  isLoading: boolean;\n  /** Error if loading failed */\n  error: Error | null;\n  /** Refetch learning item */\n  refetch: () => void;\n}\n\n/**\n * Hook for fetching a single learning item by UUID\n *\n * @param options - Hook options\n * @returns Learning item data\n */\nexport function useLearningItem(\n  options: UseLearningItemOptions\n): UseLearningItemResult {\n  const { learningUuid, enabled = true } = options;\n  const { networkClient, baseUrl, token } = useResolvedSudojoApi(\n    options,\n    'useLearningItem'\n  );\n\n  const { data, isLoading, error, refetch } = useSudojoLearningItem(\n    networkClient,\n    baseUrl,\n    token,\n    learningUuid,\n    {\n      enabled: enabled && !!learningUuid,\n    }\n  );\n\n  const learningItem = useMemo(() => {\n    if (!data?.success || !data.data) return null;\n    return data.data;\n  }, [data]);\n\n  return {\n    learningItem,\n    isLoading,\n    error: error ?? null,\n    refetch: () => {\n      refetch();\n    },\n  };\n}\n"]}

package/dist/hooks/useLevelGame.d.ts

@@ -4,15 +4,15 @@
  */
 import type { Board } from '@sudobility/sudojo_types';
 import type { NetworkClient } from '@sudobility/types';
-/** Game fetch status indicating what screen to show */
-export type GameFetchStatus = 'loading' | 'success' | 'auth_required' | 'subscription_required' | 'entitlement_required' | 'error';
+import { type GameFetchStatus } from '../utils/gameFetchStatus';
+export type { GameFetchStatus } from '../utils/gameFetchStatus';
 export interface UseLevelGameOptions {
-    /** Network client for API calls */
-    networkClient: NetworkClient;
-    /** Base URL for the Sudojo API */
-    baseUrl: string;
+    /** Network client for API calls (default: SudojoApiProvider) */
+    networkClient?: NetworkClient | undefined;
+    /** Base URL for the Sudojo API (default: SudojoApiProvider) */
+    baseUrl?: string | undefined;
     /** Access token for authentication */
-    token: string;
+    token?: string | undefined;
     /** Level number (1-12) to fetch game for */
     level: number;
     /** Whether to fetch only symmetrical puzzles */

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

@@ -1 +1 @@
-{"version":3,"file":"useLevelGame.d.ts","sourceRoot":"","sources":["../../src/hooks/useLevelGame.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAEtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAIvD,uDAAuD;AACvD,MAAM,MAAM,eAAe,GACvB,SAAS,GACT,SAAS,GACT,eAAe,GACf,uBAAuB,GACvB,sBAAsB,GACtB,OAAO,CAAC;AAuDZ,MAAM,WAAW,mBAAmB;IAClC,mCAAmC;IACnC,aAAa,EAAE,aAAa,CAAC;IAC7B,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,+CAA+C;IAC/C,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,8EAA8E;IAC9E,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,gFAAgF;IAChF,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,kCAAkC;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,0BAA0B;IAC1B,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,uCAAuC;IACvC,MAAM,EAAE,eAAe,CAAC;IACxB,8BAA8B;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,4BAA4B;IAC5B,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,6BAA6B;IAC7B,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,8CAA8C;IAC9C,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,2EAA2E;IAC3E,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,kBAAkB,CAgF7E"}
+{"version":3,"file":"useLevelGame.d.ts","sourceRoot":"","sources":["../../src/hooks/useLevelGame.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAEtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAIvD,OAAO,EAEL,KAAK,eAAe,EAErB,MAAM,0BAA0B,CAAC;AAElC,YAAY,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAEhE,MAAM,WAAW,mBAAmB;IAClC,gEAAgE;IAChE,aAAa,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IAC1C,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,+CAA+C;IAC/C,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,8EAA8E;IAC9E,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,gFAAgF;IAChF,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,kCAAkC;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,0BAA0B;IAC1B,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,uCAAuC;IACvC,MAAM,EAAE,eAAe,CAAC;IACxB,8BAA8B;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,4BAA4B;IAC5B,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,6BAA6B;IAC7B,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,8CAA8C;IAC9C,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,2EAA2E;IAC3E,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,kBAAkB,CA8E7E"}

package/dist/hooks/useLevelGame.js

@@ -3,37 +3,11 @@
  * Handles auth and subscription status with automatic refresh
  */
 import { useMemo } from 'react';
-import { hasRequiredEntitlement } from '@sudobility/sudojo_types';
+import { hasRequiredEntitlement, isValidLevel } from '@sudobility/sudojo_types';
+import { useResolvedSudojoApi } from '../context/SudojoApiContext';
 import { useSudojoRandomBoard } from '@sudobility/sudojo_client';
 import { useQueryClient } from '@tanstack/react-query';
-/** Check if response indicates auth is required */
-function isAuthRequired(response, error) {
-    if (response?.success === false &&
-        response.action?.type === 'auth_required') {
-        return true;
-    }
-    if (error && typeof error === 'object') {
-        const err = error;
-        if (err.message?.includes('Account required'))
-            return true;
-    }
-    return false;
-}
-/** Check if response indicates subscription is required */
-function isSubscriptionRequired(response, error) {
-    if (response?.success === false &&
-        response.action?.type === 'subscription_required') {
-        return true;
-    }
-    if (error && typeof error === 'object') {
-        const err = error;
-        if (err.message?.includes('Daily limit reached') ||
-            err.message?.includes('subscription')) {
-            return true;
-        }
-    }
-    return false;
-}
+import { getGameFetchStatus, } from '../utils/gameFetchStatus';
 /**
  * Hook for fetching a game board for a specific level
  *
@@ -64,7 +38,8 @@ function isSubscriptionRequired(response, error) {
  * ```
  */
 export function useLevelGame(options) {
-    const { networkClient, baseUrl, token, level, symmetrical, userEntitlements, levelEntitlement, enabled = true, } = options;
+    const { level, symmetrical, userEntitlements, levelEntitlement, enabled = true, } = options;
+    const { networkClient, baseUrl, token } = useResolvedSudojoApi(options, 'useLevelGame');
     // Client-side entitlement check before making API call
     const entitlementDenied = useMemo(() => !hasRequiredEntitlement(levelEntitlement, userEntitlements ?? []), [levelEntitlement, userEntitlements]);
     const queryClient = useQueryClient();
@@ -76,25 +51,14 @@ export function useLevelGame(options) {
         techniques: undefined,
         technique_bit: undefined,
     }), [level, symmetrical]);
-    const { data, isLoading, error, refetch } = useSudojoRandomBoard(networkClient, baseUrl, token, queryParams, { enabled: enabled && level >= 1 && level <= 12 && !entitlementDenied });
-    // Determine status based on response
-    // Cast to SudojoApiResponse to check for action field
-    const apiResponse = data;
-    const status = useMemo(() => {
-        if (entitlementDenied)
-            return 'entitlement_required';
-        if (isLoading)
-            return 'loading';
-        if (isAuthRequired(apiResponse, error))
-            return 'auth_required';
-        if (isSubscriptionRequired(apiResponse, error))
-            return 'subscription_required';
-        if (error)
-            return 'error';
-        if (apiResponse?.success && apiResponse.data)
-            return 'success';
-        return 'loading';
-    }, [entitlementDenied, isLoading, apiResponse, error]);
+    const { data, isLoading, error, refetch } = useSudojoRandomBoard(networkClient, baseUrl, token, queryParams, { enabled: enabled && isValidLevel(level) && !entitlementDenied });
+    // Determine status based on response (incl. the legacy `action` field)
+    const status = useMemo(() => getGameFetchStatus({
+        isLoading,
+        response: data,
+        error,
+        entitlementDenied,
+    }), [entitlementDenied, isLoading, data, error]);
     const board = useMemo(() => {
         if (data?.success && data.data) {
             return data.data;

package/dist/hooks/useLevelGame.js.map

@@ -1 +1 @@
-{"version":3,"file":"useLevelGame.js","sourceRoot":"","sources":["../../src/hooks/useLevelGame.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Hook for fetching and managing game board for a specific level\n * Handles auth and subscription status with automatic refresh\n */\n\nimport { useMemo } from 'react';\nimport type { Board } from '@sudobility/sudojo_types';\nimport { hasRequiredEntitlement } from '@sudobility/sudojo_types';\nimport type { NetworkClient } from '@sudobility/types';\nimport { useSudojoRandomBoard } from '@sudobility/sudojo_client';\nimport { useQueryClient } from '@tanstack/react-query';\n\n/** Game fetch status indicating what screen to show */\nexport type GameFetchStatus =\n  | 'loading'\n  | 'success'\n  | 'auth_required'\n  | 'subscription_required'\n  | 'entitlement_required'\n  | 'error';\n\n/** Extended API response with action field from Sudojo API */\ninterface SudojoApiResponse<T> {\n  success: boolean;\n  data?: T;\n  error?: string | null;\n  message?: string;\n  action?: {\n    type: string;\n    options?: string[];\n  };\n}\n\n/** Check if response indicates auth is required */\nfunction isAuthRequired(\n  response: SudojoApiResponse<unknown> | undefined,\n  error: unknown\n): boolean {\n  if (\n    response?.success === false &&\n    response.action?.type === 'auth_required'\n  ) {\n    return true;\n  }\n  if (error && typeof error === 'object') {\n    const err = error as { message?: string };\n    if (err.message?.includes('Account required')) return true;\n  }\n  return false;\n}\n\n/** Check if response indicates subscription is required */\nfunction isSubscriptionRequired(\n  response: SudojoApiResponse<unknown> | undefined,\n  error: unknown\n): boolean {\n  if (\n    response?.success === false &&\n    response.action?.type === 'subscription_required'\n  ) {\n    return true;\n  }\n  if (error && typeof error === 'object') {\n    const err = error as { message?: string };\n    if (\n      err.message?.includes('Daily limit reached') ||\n      err.message?.includes('subscription')\n    ) {\n      return true;\n    }\n  }\n  return false;\n}\n\nexport interface UseLevelGameOptions {\n  /** Network client for API calls */\n  networkClient: NetworkClient;\n  /** Base URL for the Sudojo API */\n  baseUrl: string;\n  /** Access token for authentication */\n  token: string;\n  /** Level number (1-12) to fetch game for */\n  level: number;\n  /** Whether to fetch only symmetrical puzzles */\n  symmetrical?: boolean;\n  /** Whether subscription is currently active */\n  subscriptionActive?: boolean;\n  /** The user's active entitlement IDs (e.g., ['blue_belt'] or ['red_belt']) */\n  userEntitlements?: string[];\n  /** The entitlement field from the current level (e.g., \"blue_belt,red_belt\") */\n  levelEntitlement?: string | null;\n  /** Whether to enable the query */\n  enabled?: boolean;\n}\n\nexport interface UseLevelGameResult {\n  /** The game board data */\n  board: Board | null;\n  /** Current status of the game fetch */\n  status: GameFetchStatus;\n  /** Whether data is loading */\n  isLoading: boolean;\n  /** Error if fetch failed */\n  error: Error | null;\n  /** Refetch the game board */\n  refetch: () => void;\n  /** Fetch a new random board for this level */\n  nextPuzzle: () => void;\n  /** The entitlement string required for this level (for paywall display) */\n  requiredEntitlement: string | null;\n}\n\n/**\n * Hook for fetching a game board for a specific level\n *\n * Automatically refetches when auth token or subscription status changes.\n * Returns status indicating whether auth or subscription is required.\n *\n * @param options - Hook options\n * @returns Game board data and status\n *\n * @example\n * ```tsx\n * function LevelPlayPage({ level }: { level: number }) {\n *   const { board, status, refetch, nextPuzzle } = useLevelGame({\n *     networkClient,\n *     config,\n *     auth,\n *     level,\n *     subscriptionActive: subscription.isActive,\n *   });\n *\n *   if (status === 'loading') return <Loading />;\n *   if (status === 'auth_required') return <AuthRequired onLogin={openAuthModal} />;\n *   if (status === 'subscription_required') return <SubscriptionPaywall onSuccess={refetch} />;\n *   if (status === 'error') return <Error />;\n *\n *   return <SudokuGame puzzle={board.board} solution={board.solution} />;\n * }\n * ```\n */\nexport function useLevelGame(options: UseLevelGameOptions): UseLevelGameResult {\n  const {\n    networkClient,\n    baseUrl,\n    token,\n    level,\n    symmetrical,\n    userEntitlements,\n    levelEntitlement,\n    enabled = true,\n  } = options;\n\n  // Client-side entitlement check before making API call\n  const entitlementDenied = useMemo(\n    () => !hasRequiredEntitlement(levelEntitlement, userEntitlements ?? []),\n    [levelEntitlement, userEntitlements]\n  );\n\n  const queryClient = useQueryClient();\n\n  const queryParams = useMemo(\n    () => ({\n      level,\n      symmetrical: symmetrical || undefined,\n      limit: undefined,\n      offset: undefined,\n      techniques: undefined,\n      technique_bit: undefined,\n    }),\n    [level, symmetrical]\n  );\n\n  const { data, isLoading, error, refetch } = useSudojoRandomBoard(\n    networkClient,\n    baseUrl,\n    token,\n    queryParams,\n    { enabled: enabled && level >= 1 && level <= 12 && !entitlementDenied }\n  );\n\n  // Determine status based on response\n  // Cast to SudojoApiResponse to check for action field\n  const apiResponse = data as SudojoApiResponse<Board> | undefined;\n\n  const status = useMemo((): GameFetchStatus => {\n    if (entitlementDenied) return 'entitlement_required';\n    if (isLoading) return 'loading';\n    if (isAuthRequired(apiResponse, error)) return 'auth_required';\n    if (isSubscriptionRequired(apiResponse, error))\n      return 'subscription_required';\n    if (error) return 'error';\n    if (apiResponse?.success && apiResponse.data) return 'success';\n    return 'loading';\n  }, [entitlementDenied, isLoading, apiResponse, error]);\n\n  const board = useMemo(() => {\n    if (data?.success && data.data) {\n      return data.data;\n    }\n    return null;\n  }, [data]);\n\n  const nextPuzzle = useMemo(() => {\n    return () => {\n      queryClient.invalidateQueries({\n        queryKey: ['sudojo', 'boards', 'random'],\n      });\n      refetch();\n    };\n  }, [queryClient, refetch]);\n\n  return {\n    board,\n    status,\n    isLoading,\n    error: error ?? null,\n    refetch: () => refetch(),\n    nextPuzzle,\n    requiredEntitlement: levelEntitlement ?? null,\n  };\n}\n"]}
+{"version":3,"file":"useLevelGame.js","sourceRoot":"","sources":["../../src/hooks/useLevelGame.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAEhC,OAAO,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAEhF,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAGL,kBAAkB,GACnB,MAAM,0BAA0B,CAAC;AA0ClC;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,UAAU,YAAY,CAAC,OAA4B;IACvD,MAAM,EACJ,KAAK,EACL,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,OAAO,GAAG,IAAI,GACf,GAAG,OAAO,CAAC;IACZ,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,oBAAoB,CAC5D,OAAO,EACP,cAAc,CACf,CAAC;IAEF,uDAAuD;IACvD,MAAM,iBAAiB,GAAG,OAAO,CAC/B,GAAG,EAAE,CAAC,CAAC,sBAAsB,CAAC,gBAAgB,EAAE,gBAAgB,IAAI,EAAE,CAAC,EACvE,CAAC,gBAAgB,EAAE,gBAAgB,CAAC,CACrC,CAAC;IAEF,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;IAErC,MAAM,WAAW,GAAG,OAAO,CACzB,GAAG,EAAE,CAAC,CAAC;QACL,KAAK;QACL,WAAW,EAAE,WAAW,IAAI,SAAS;QACrC,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE,SAAS;QACjB,UAAU,EAAE,SAAS;QACrB,aAAa,EAAE,SAAS;KACzB,CAAC,EACF,CAAC,KAAK,EAAE,WAAW,CAAC,CACrB,CAAC;IAEF,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,oBAAoB,CAC9D,aAAa,EACb,OAAO,EACP,KAAK,EACL,WAAW,EACX,EAAE,OAAO,EAAE,OAAO,IAAI,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAClE,CAAC;IAEF,uEAAuE;IACvE,MAAM,MAAM,GAAG,OAAO,CACpB,GAAoB,EAAE,CACpB,kBAAkB,CAAC;QACjB,SAAS;QACT,QAAQ,EAAE,IAAqC;QAC/C,KAAK;QACL,iBAAiB;KAClB,CAAC,EACJ,CAAC,iBAAiB,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,CAAC,CAC5C,CAAC;IAEF,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,EAAE;QACzB,IAAI,IAAI,EAAE,OAAO,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YAC/B,OAAO,IAAI,CAAC,IAAI,CAAC;QACnB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IAEX,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,EAAE;QAC9B,OAAO,GAAG,EAAE;YACV,WAAW,CAAC,iBAAiB,CAAC;gBAC5B,QAAQ,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC;aACzC,CAAC,CAAC;YACH,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;IAE3B,OAAO;QACL,KAAK;QACL,MAAM;QACN,SAAS;QACT,KAAK,EAAE,KAAK,IAAI,IAAI;QACpB,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE;QACxB,UAAU;QACV,mBAAmB,EAAE,gBAAgB,IAAI,IAAI;KAC9C,CAAC;AACJ,CAAC","sourcesContent":["/**\n * Hook for fetching and managing game board for a specific level\n * Handles auth and subscription status with automatic refresh\n */\n\nimport { useMemo } from 'react';\nimport type { Board } from '@sudobility/sudojo_types';\nimport { hasRequiredEntitlement, isValidLevel } from '@sudobility/sudojo_types';\nimport type { NetworkClient } from '@sudobility/types';\nimport { useResolvedSudojoApi } from '../context/SudojoApiContext';\nimport { useSudojoRandomBoard } from '@sudobility/sudojo_client';\nimport { useQueryClient } from '@tanstack/react-query';\nimport {\n  type GameFetchResponse,\n  type GameFetchStatus,\n  getGameFetchStatus,\n} from '../utils/gameFetchStatus';\n\nexport type { GameFetchStatus } from '../utils/gameFetchStatus';\n\nexport interface UseLevelGameOptions {\n  /** Network client for API calls (default: SudojoApiProvider) */\n  networkClient?: NetworkClient | undefined;\n  /** Base URL for the Sudojo API (default: SudojoApiProvider) */\n  baseUrl?: string | undefined;\n  /** Access token for authentication */\n  token?: string | undefined;\n  /** Level number (1-12) to fetch game for */\n  level: number;\n  /** Whether to fetch only symmetrical puzzles */\n  symmetrical?: boolean;\n  /** Whether subscription is currently active */\n  subscriptionActive?: boolean;\n  /** The user's active entitlement IDs (e.g., ['blue_belt'] or ['red_belt']) */\n  userEntitlements?: string[];\n  /** The entitlement field from the current level (e.g., \"blue_belt,red_belt\") */\n  levelEntitlement?: string | null;\n  /** Whether to enable the query */\n  enabled?: boolean;\n}\n\nexport interface UseLevelGameResult {\n  /** The game board data */\n  board: Board | null;\n  /** Current status of the game fetch */\n  status: GameFetchStatus;\n  /** Whether data is loading */\n  isLoading: boolean;\n  /** Error if fetch failed */\n  error: Error | null;\n  /** Refetch the game board */\n  refetch: () => void;\n  /** Fetch a new random board for this level */\n  nextPuzzle: () => void;\n  /** The entitlement string required for this level (for paywall display) */\n  requiredEntitlement: string | null;\n}\n\n/**\n * Hook for fetching a game board for a specific level\n *\n * Automatically refetches when auth token or subscription status changes.\n * Returns status indicating whether auth or subscription is required.\n *\n * @param options - Hook options\n * @returns Game board data and status\n *\n * @example\n * ```tsx\n * function LevelPlayPage({ level }: { level: number }) {\n *   const { board, status, refetch, nextPuzzle } = useLevelGame({\n *     networkClient,\n *     config,\n *     auth,\n *     level,\n *     subscriptionActive: subscription.isActive,\n *   });\n *\n *   if (status === 'loading') return <Loading />;\n *   if (status === 'auth_required') return <AuthRequired onLogin={openAuthModal} />;\n *   if (status === 'subscription_required') return <SubscriptionPaywall onSuccess={refetch} />;\n *   if (status === 'error') return <Error />;\n *\n *   return <SudokuGame puzzle={board.board} solution={board.solution} />;\n * }\n * ```\n */\nexport function useLevelGame(options: UseLevelGameOptions): UseLevelGameResult {\n  const {\n    level,\n    symmetrical,\n    userEntitlements,\n    levelEntitlement,\n    enabled = true,\n  } = options;\n  const { networkClient, baseUrl, token } = useResolvedSudojoApi(\n    options,\n    'useLevelGame'\n  );\n\n  // Client-side entitlement check before making API call\n  const entitlementDenied = useMemo(\n    () => !hasRequiredEntitlement(levelEntitlement, userEntitlements ?? []),\n    [levelEntitlement, userEntitlements]\n  );\n\n  const queryClient = useQueryClient();\n\n  const queryParams = useMemo(\n    () => ({\n      level,\n      symmetrical: symmetrical || undefined,\n      limit: undefined,\n      offset: undefined,\n      techniques: undefined,\n      technique_bit: undefined,\n    }),\n    [level, symmetrical]\n  );\n\n  const { data, isLoading, error, refetch } = useSudojoRandomBoard(\n    networkClient,\n    baseUrl,\n    token,\n    queryParams,\n    { enabled: enabled && isValidLevel(level) && !entitlementDenied }\n  );\n\n  // Determine status based on response (incl. the legacy `action` field)\n  const status = useMemo(\n    (): GameFetchStatus =>\n      getGameFetchStatus({\n        isLoading,\n        response: data as GameFetchResponse | undefined,\n        error,\n        entitlementDenied,\n      }),\n    [entitlementDenied, isLoading, data, error]\n  );\n\n  const board = useMemo(() => {\n    if (data?.success && data.data) {\n      return data.data;\n    }\n    return null;\n  }, [data]);\n\n  const nextPuzzle = useMemo(() => {\n    return () => {\n      queryClient.invalidateQueries({\n        queryKey: ['sudojo', 'boards', 'random'],\n      });\n      refetch();\n    };\n  }, [queryClient, refetch]);\n\n  return {\n    board,\n    status,\n    isLoading,\n    error: error ?? null,\n    refetch: () => refetch(),\n    nextPuzzle,\n    requiredEntitlement: levelEntitlement ?? null,\n  };\n}\n"]}

package/dist/hooks/useLevels.d.ts

@@ -4,10 +4,10 @@
 import type { Level } from '@sudobility/sudojo_types';
 import type { NetworkClient } from '@sudobility/types';
 export interface UseLevelsOptions {
-    /** Network client for API calls */
-    networkClient: NetworkClient;
-    /** Base URL for the Sudojo API */
-    baseUrl: string;
+    /** Network client for API calls (default: SudojoApiProvider) */
+    networkClient?: NetworkClient | undefined;
+    /** Base URL for the Sudojo API (default: SudojoApiProvider) */
+    baseUrl?: string | undefined;
     /** Access token for authentication (optional for public data) */
     token?: string;
     /** Whether to enable the query */
@@ -59,10 +59,10 @@ export interface UseLevelsResult {
  */
 export declare function useLevels(options: UseLevelsOptions): UseLevelsResult;
 export interface UseLevelOptions {
-    /** Network client for API calls */
-    networkClient: NetworkClient;
-    /** Base URL for the Sudojo API */
-    baseUrl: string;
+    /** Network client for API calls (default: SudojoApiProvider) */
+    networkClient?: NetworkClient | undefined;
+    /** Base URL for the Sudojo API (default: SudojoApiProvider) */
+    baseUrl?: string | undefined;
     /** Access token for authentication (optional for public data) */
     token?: string;
     /** Level number (1-12) to fetch */

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

@@ -1 +1 @@
-{"version":3,"file":"useLevels.d.ts","sourceRoot":"","sources":["../../src/hooks/useLevels.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGvD,MAAM,WAAW,gBAAgB;IAC/B,mCAAmC;IACnC,aAAa,EAAE,aAAa,CAAC;IAC7B,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,2BAA2B;IAC3B,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,iCAAiC;IACjC,SAAS,EAAE,OAAO,CAAC;IACnB,8BAA8B;IAC9B,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,qBAAqB;IACrB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,qCAAqC;IACrC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,KAAK,GAAG,SAAS,CAAC;IAC/C,oCAAoC;IACpC,YAAY,EAAE,KAAK,EAAE,CAAC;IACtB,6CAA6C;IAC7C,UAAU,EAAE,KAAK,EAAE,CAAC;IACpB,6CAA6C;IAC7C,aAAa,EAAE,KAAK,EAAE,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,eAAe,CA4CpE;AAED,MAAM,WAAW,eAAe;IAC9B,mCAAmC;IACnC,aAAa,EAAE,aAAa,CAAC;IAC7B,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,wBAAwB;IACxB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,+BAA+B;IAC/B,SAAS,EAAE,OAAO,CAAC;IACnB,8BAA8B;IAC9B,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,oBAAoB;IACpB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,cAAc,CA0BjE"}
+{"version":3,"file":"useLevels.d.ts","sourceRoot":"","sources":["../../src/hooks/useLevels.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAEtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAIvD,MAAM,WAAW,gBAAgB;IAC/B,gEAAgE;IAChE,aAAa,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IAC1C,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,2BAA2B;IAC3B,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,iCAAiC;IACjC,SAAS,EAAE,OAAO,CAAC;IACnB,8BAA8B;IAC9B,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,qBAAqB;IACrB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,qCAAqC;IACrC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,KAAK,GAAG,SAAS,CAAC;IAC/C,oCAAoC;IACpC,YAAY,EAAE,KAAK,EAAE,CAAC;IACtB,6CAA6C;IAC7C,UAAU,EAAE,KAAK,EAAE,CAAC;IACpB,6CAA6C;IAC7C,aAAa,EAAE,KAAK,EAAE,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,eAAe,CAgDpE;AAED,MAAM,WAAW,eAAe;IAC9B,gEAAgE;IAChE,aAAa,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IAC1C,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,wBAAwB;IACxB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,+BAA+B;IAC/B,SAAS,EAAE,OAAO,CAAC;IACnB,8BAA8B;IAC9B,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,oBAAoB;IACpB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,cAAc,CA8BjE"}

package/dist/hooks/useLevels.js

@@ -2,6 +2,8 @@
  * Hook for fetching and managing Sudoku difficulty levels
  */
 import { useMemo } from 'react';
+import { isValidLevel } from '@sudobility/sudojo_types';
+import { useResolvedSudojoApi } from '../context/SudojoApiContext';
 import { useSudojoLevel, useSudojoLevels } from '@sudobility/sudojo_client';
 /**
  * Hook for fetching and managing difficulty levels
@@ -30,7 +32,8 @@ import { useSudojoLevel, useSudojoLevels } from '@sudobility/sudojo_client';
  * ```
  */
 export function useLevels(options) {
-    const { networkClient, baseUrl, token = '', enabled = true } = options;
+    const { enabled = true } = options;
+    const { networkClient, baseUrl, token } = useResolvedSudojoApi(options, 'useLevels');
     const { data, isLoading, error, refetch } = useSudojoLevels(networkClient, baseUrl, token, { enabled });
     const levels = useMemo(() => {
         if (!data?.success || !data.data)
@@ -70,9 +73,10 @@ export function useLevels(options) {
  * @returns Level data
  */
 export function useLevel(options) {
-    const { networkClient, baseUrl, token = '', level, enabled = true } = options;
+    const { level, enabled = true } = options;
+    const { networkClient, baseUrl, token } = useResolvedSudojoApi(options, 'useLevel');
     const { data, isLoading, error, refetch } = useSudojoLevel(networkClient, baseUrl, token, level, {
-        enabled: enabled && level >= 1 && level <= 12,
+        enabled: enabled && isValidLevel(level),
     });
     const levelData = useMemo(() => {
         if (!data?.success || !data.data)

package/dist/hooks/useLevels.js.map

@@ -1 +1 @@
-{"version":3,"file":"useLevels.js","sourceRoot":"","sources":["../../src/hooks/useLevels.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Hook for fetching and managing Sudoku difficulty levels\n */\n\nimport { useMemo } from 'react';\nimport type { Level } from '@sudobility/sudojo_types';\nimport type { NetworkClient } from '@sudobility/types';\nimport { useSudojoLevel, useSudojoLevels } from '@sudobility/sudojo_client';\n\nexport interface UseLevelsOptions {\n  /** Network client for API calls */\n  networkClient: NetworkClient;\n  /** Base URL for the Sudojo API */\n  baseUrl: string;\n  /** Access token for authentication (optional for public data) */\n  token?: string;\n  /** Whether to enable the query */\n  enabled?: boolean;\n}\n\nexport interface UseLevelsResult {\n  /** All available levels */\n  levels: Level[];\n  /** Whether levels are loading */\n  isLoading: boolean;\n  /** Error if loading failed */\n  error: Error | null;\n  /** Refetch levels */\n  refetch: () => void;\n  /** Get level by its number (1-12) */\n  getLevel: (level: number) => Level | undefined;\n  /** Levels sorted by level number */\n  sortedLevels: Level[];\n  /** Free levels (no subscription required) */\n  freeLevels: Level[];\n  /** Premium levels (subscription required) */\n  premiumLevels: Level[];\n}\n\n/**\n * Hook for fetching and managing difficulty levels\n *\n * @param options - Hook options\n * @returns Levels data and utilities\n *\n * @example\n * ```tsx\n * function LevelSelector() {\n *   const { levels, isLoading, sortedLevels } = useLevels({\n *     networkClient,\n *     baseUrl: 'https://api.sudojo.com',\n *   });\n *\n *   if (isLoading) return <Loading />;\n *\n *   return (\n *     <ul>\n *       {sortedLevels.map(level => (\n *         <li key={level.level}>{level.title}</li>\n *       ))}\n *     </ul>\n *   );\n * }\n * ```\n */\nexport function useLevels(options: UseLevelsOptions): UseLevelsResult {\n  const { networkClient, baseUrl, token = '', enabled = true } = options;\n\n  const { data, isLoading, error, refetch } = useSudojoLevels(\n    networkClient,\n    baseUrl,\n    token,\n    { enabled }\n  );\n\n  const levels = useMemo(() => {\n    if (!data?.success || !data.data) return [];\n    return data.data;\n  }, [data]);\n\n  const sortedLevels = useMemo(() => {\n    return [...levels].sort((a, b) => a.level - b.level);\n  }, [levels]);\n\n  const freeLevels = useMemo(() => {\n    return sortedLevels.filter(level => !level.requires_subscription);\n  }, [sortedLevels]);\n\n  const premiumLevels = useMemo(() => {\n    return sortedLevels.filter(level => level.requires_subscription);\n  }, [sortedLevels]);\n\n  const getLevel = useMemo(() => {\n    const levelMap = new Map(levels.map(l => [l.level, l]));\n    return (level: number) => levelMap.get(level);\n  }, [levels]);\n\n  return {\n    levels,\n    isLoading,\n    error: error ?? null,\n    refetch: () => {\n      refetch();\n    },\n    getLevel,\n    sortedLevels,\n    freeLevels,\n    premiumLevels,\n  };\n}\n\nexport interface UseLevelOptions {\n  /** Network client for API calls */\n  networkClient: NetworkClient;\n  /** Base URL for the Sudojo API */\n  baseUrl: string;\n  /** Access token for authentication (optional for public data) */\n  token?: string;\n  /** Level number (1-12) to fetch */\n  level: number;\n  /** Whether to enable the query */\n  enabled?: boolean;\n}\n\nexport interface UseLevelResult {\n  /** The fetched level */\n  level: Level | null;\n  /** Whether level is loading */\n  isLoading: boolean;\n  /** Error if loading failed */\n  error: Error | null;\n  /** Refetch level */\n  refetch: () => void;\n}\n\n/**\n * Hook for fetching a single level by number\n *\n * @param options - Hook options\n * @returns Level data\n */\nexport function useLevel(options: UseLevelOptions): UseLevelResult {\n  const { networkClient, baseUrl, token = '', level, enabled = true } = options;\n\n  const { data, isLoading, error, refetch } = useSudojoLevel(\n    networkClient,\n    baseUrl,\n    token,\n    level,\n    {\n      enabled: enabled && level >= 1 && level <= 12,\n    }\n  );\n\n  const levelData = useMemo(() => {\n    if (!data?.success || !data.data) return null;\n    return data.data;\n  }, [data]);\n\n  return {\n    level: levelData,\n    isLoading,\n    error: error ?? null,\n    refetch: () => {\n      refetch();\n    },\n  };\n}\n"]}
+{"version":3,"file":"useLevels.js","sourceRoot":"","sources":["../../src/hooks/useLevels.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Hook for fetching and managing Sudoku difficulty levels\n */\n\nimport { useMemo } from 'react';\nimport type { Level } from '@sudobility/sudojo_types';\nimport { isValidLevel } from '@sudobility/sudojo_types';\nimport type { NetworkClient } from '@sudobility/types';\nimport { useResolvedSudojoApi } from '../context/SudojoApiContext';\nimport { useSudojoLevel, useSudojoLevels } from '@sudobility/sudojo_client';\n\nexport interface UseLevelsOptions {\n  /** Network client for API calls (default: SudojoApiProvider) */\n  networkClient?: NetworkClient | undefined;\n  /** Base URL for the Sudojo API (default: SudojoApiProvider) */\n  baseUrl?: string | undefined;\n  /** Access token for authentication (optional for public data) */\n  token?: string;\n  /** Whether to enable the query */\n  enabled?: boolean;\n}\n\nexport interface UseLevelsResult {\n  /** All available levels */\n  levels: Level[];\n  /** Whether levels are loading */\n  isLoading: boolean;\n  /** Error if loading failed */\n  error: Error | null;\n  /** Refetch levels */\n  refetch: () => void;\n  /** Get level by its number (1-12) */\n  getLevel: (level: number) => Level | undefined;\n  /** Levels sorted by level number */\n  sortedLevels: Level[];\n  /** Free levels (no subscription required) */\n  freeLevels: Level[];\n  /** Premium levels (subscription required) */\n  premiumLevels: Level[];\n}\n\n/**\n * Hook for fetching and managing difficulty levels\n *\n * @param options - Hook options\n * @returns Levels data and utilities\n *\n * @example\n * ```tsx\n * function LevelSelector() {\n *   const { levels, isLoading, sortedLevels } = useLevels({\n *     networkClient,\n *     baseUrl: 'https://api.sudojo.com',\n *   });\n *\n *   if (isLoading) return <Loading />;\n *\n *   return (\n *     <ul>\n *       {sortedLevels.map(level => (\n *         <li key={level.level}>{level.title}</li>\n *       ))}\n *     </ul>\n *   );\n * }\n * ```\n */\nexport function useLevels(options: UseLevelsOptions): UseLevelsResult {\n  const { enabled = true } = options;\n  const { networkClient, baseUrl, token } = useResolvedSudojoApi(\n    options,\n    'useLevels'\n  );\n\n  const { data, isLoading, error, refetch } = useSudojoLevels(\n    networkClient,\n    baseUrl,\n    token,\n    { enabled }\n  );\n\n  const levels = useMemo(() => {\n    if (!data?.success || !data.data) return [];\n    return data.data;\n  }, [data]);\n\n  const sortedLevels = useMemo(() => {\n    return [...levels].sort((a, b) => a.level - b.level);\n  }, [levels]);\n\n  const freeLevels = useMemo(() => {\n    return sortedLevels.filter(level => !level.requires_subscription);\n  }, [sortedLevels]);\n\n  const premiumLevels = useMemo(() => {\n    return sortedLevels.filter(level => level.requires_subscription);\n  }, [sortedLevels]);\n\n  const getLevel = useMemo(() => {\n    const levelMap = new Map(levels.map(l => [l.level, l]));\n    return (level: number) => levelMap.get(level);\n  }, [levels]);\n\n  return {\n    levels,\n    isLoading,\n    error: error ?? null,\n    refetch: () => {\n      refetch();\n    },\n    getLevel,\n    sortedLevels,\n    freeLevels,\n    premiumLevels,\n  };\n}\n\nexport interface UseLevelOptions {\n  /** Network client for API calls (default: SudojoApiProvider) */\n  networkClient?: NetworkClient | undefined;\n  /** Base URL for the Sudojo API (default: SudojoApiProvider) */\n  baseUrl?: string | undefined;\n  /** Access token for authentication (optional for public data) */\n  token?: string;\n  /** Level number (1-12) to fetch */\n  level: number;\n  /** Whether to enable the query */\n  enabled?: boolean;\n}\n\nexport interface UseLevelResult {\n  /** The fetched level */\n  level: Level | null;\n  /** Whether level is loading */\n  isLoading: boolean;\n  /** Error if loading failed */\n  error: Error | null;\n  /** Refetch level */\n  refetch: () => void;\n}\n\n/**\n * Hook for fetching a single level by number\n *\n * @param options - Hook options\n * @returns Level data\n */\nexport function useLevel(options: UseLevelOptions): UseLevelResult {\n  const { level, enabled = true } = options;\n  const { networkClient, baseUrl, token } = useResolvedSudojoApi(\n    options,\n    'useLevel'\n  );\n\n  const { data, isLoading, error, refetch } = useSudojoLevel(\n    networkClient,\n    baseUrl,\n    token,\n    level,\n    {\n      enabled: enabled && isValidLevel(level),\n    }\n  );\n\n  const levelData = useMemo(() => {\n    if (!data?.success || !data.data) return null;\n    return data.data;\n  }, [data]);\n\n  return {\n    level: levelData,\n    isLoading,\n    error: error ?? null,\n    refetch: () => {\n      refetch();\n    },\n  };\n}\n"]}

package/dist/hooks/usePracticeGame.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Hook for fetching a random practice puzzle for a technique, with the
+ * auth / subscription / empty states the practice screens show.
+ */
+import type { TechniquePractice } from '@sudobility/sudojo_types';
+import type { NetworkClient } from '@sudobility/types';
+import { type PracticeFetchStatus } from '../utils/gameFetchStatus';
+export interface UsePracticeGameOptions {
+    /** Network client for API calls (default: SudojoApiProvider) */
+    networkClient?: NetworkClient | undefined;
+    /** Base URL for the Sudojo API (default: SudojoApiProvider) */
+    baseUrl?: string | undefined;
+    /** Access token (default: SudojoApiProvider) */
+    token?: string | null | undefined;
+    /** Technique number (1-60); the query is idle for anything below 1 */
+    techniqueId: number | null | undefined;
+    /** Whether to enable the query (default true) */
+    enabled?: boolean;
+}
+export interface UsePracticeGameResult {
+    /** The practice puzzle, when loaded */
+    practice: TechniquePractice | null;
+    /** Which screen to show */
+    status: PracticeFetchStatus;
+    /** Whether the request is in flight */
+    isLoading: boolean;
+    /** The request error, if any */
+    error: Error | null;
+    /** Ask again (e.g. after a paywall purchase) */
+    refetch: () => void;
+    /** Drop the cached practice and fetch another random one */
+    nextPractice: () => void;
+}
+/**
+ * Fetch a random practice for a technique.
+ *
+ * The practice query is not keyed on the token, so when the status is
+ * `auth_required` and the token changes (the reader signed in over the
+ * screen) it refetches, as both apps did.
+ *
+ * @example
+ * ```tsx
+ * const { practice, status, refetch, nextPractice } = usePracticeGame({
+ *   networkClient, baseUrl, token, techniqueId,
+ * });
+ * if (status === 'auth_required') return <SignInGate />;
+ * if (status === 'subscription_required') return <Paywall onSuccess={refetch} />;
+ * if (status === 'no_practices') return <Empty />;
+ * if (status === 'ready') return <SudokuGame puzzle={practice.board} ... />;
+ * ```
+ */
+export declare function usePracticeGame(options: UsePracticeGameOptions): UsePracticeGameResult;
+//# sourceMappingURL=usePracticeGame.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"usePracticeGame.d.ts","sourceRoot":"","sources":["../../src/hooks/usePracticeGame.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAIvD,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,0BAA0B,CAAC;AAElC,MAAM,WAAW,sBAAsB;IACrC,gEAAgE;IAChE,aAAa,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IAC1C,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAClC,sEAAsE;IACtE,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACvC,iDAAiD;IACjD,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,uCAAuC;IACvC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACnC,2BAA2B;IAC3B,MAAM,EAAE,mBAAmB,CAAC;IAC5B,uCAAuC;IACvC,SAAS,EAAE,OAAO,CAAC;IACnB,gCAAgC;IAChC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,gDAAgD;IAChD,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,4DAA4D;IAC5D,YAAY,EAAE,MAAM,IAAI,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,sBAAsB,GAC9B,qBAAqB,CAsDvB"}

package/dist/hooks/usePracticeGame.js

@@ -0,0 +1,72 @@
+/**
+ * Hook for fetching a random practice puzzle for a technique, with the
+ * auth / subscription / empty states the practice screens show.
+ */
+import { useCallback, useEffect, useMemo, useRef } from 'react';
+import { queryKeys, useSudojoRandomPractice } from '@sudobility/sudojo_client';
+import { useQueryClient } from '@tanstack/react-query';
+import { useResolvedSudojoApi } from '../context/SudojoApiContext';
+import { getPracticeFetchStatus, } from '../utils/gameFetchStatus';
+/**
+ * Fetch a random practice for a technique.
+ *
+ * The practice query is not keyed on the token, so when the status is
+ * `auth_required` and the token changes (the reader signed in over the
+ * screen) it refetches, as both apps did.
+ *
+ * @example
+ * ```tsx
+ * const { practice, status, refetch, nextPractice } = usePracticeGame({
+ *   networkClient, baseUrl, token, techniqueId,
+ * });
+ * if (status === 'auth_required') return <SignInGate />;
+ * if (status === 'subscription_required') return <Paywall onSuccess={refetch} />;
+ * if (status === 'no_practices') return <Empty />;
+ * if (status === 'ready') return <SudokuGame puzzle={practice.board} ... />;
+ * ```
+ */
+export function usePracticeGame(options) {
+    const { techniqueId, enabled = true } = options;
+    const { networkClient, baseUrl, token } = useResolvedSudojoApi(options, 'usePracticeGame');
+    const technique = techniqueId ?? 0;
+    const validTechnique = Number.isInteger(technique) && technique >= 1;
+    const queryClient = useQueryClient();
+    const { data: response, isLoading, error, refetch, } = useSudojoRandomPractice(networkClient, baseUrl, token, technique, {
+        enabled: enabled && validTechnique,
+        staleTime: 0, // Always fetch fresh for random
+        refetchOnWindowFocus: false, // Keep the current practice on focus
+        retry: false,
+    });
+    const practice = response?.success ? (response.data ?? null) : null;
+    const status = useMemo(() => {
+        if (!validTechnique)
+            return 'no_practices';
+        return getPracticeFetchStatus({ isLoading, response, error });
+    }, [validTechnique, isLoading, response, error]);
+    // Signing in from the auth_required state asks again with the new token.
+    const lastTokenRef = useRef(token);
+    useEffect(() => {
+        if (lastTokenRef.current === token)
+            return;
+        lastTokenRef.current = token;
+        if (status === 'auth_required')
+            refetch();
+    }, [token, status, refetch]);
+    const nextPractice = useCallback(() => {
+        queryClient.invalidateQueries({
+            queryKey: queryKeys.sudojo.practiceRandom(technique),
+        });
+        refetch();
+    }, [queryClient, technique, refetch]);
+    return {
+        practice,
+        status,
+        isLoading,
+        error: error ?? null,
+        refetch: () => {
+            refetch();
+        },
+        nextPractice,
+    };
+}
+//# sourceMappingURL=usePracticeGame.js.map

package/dist/hooks/usePracticeGame.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePracticeGame.js","sourceRoot":"","sources":["../../src/hooks/usePracticeGame.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAGhE,OAAO,EAAE,SAAS,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EACL,sBAAsB,GAEvB,MAAM,0BAA0B,CAAC;AA8BlC;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,eAAe,CAC7B,OAA+B;IAE/B,MAAM,EAAE,WAAW,EAAE,OAAO,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IAChD,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,oBAAoB,CAC5D,OAAO,EACP,iBAAiB,CAClB,CAAC;IACF,MAAM,SAAS,GAAG,WAAW,IAAI,CAAC,CAAC;IACnC,MAAM,cAAc,GAAG,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,SAAS,IAAI,CAAC,CAAC;IACrE,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;IAErC,MAAM,EACJ,IAAI,EAAE,QAAQ,EACd,SAAS,EACT,KAAK,EACL,OAAO,GACR,GAAG,uBAAuB,CAAC,aAAa,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE;QACpE,OAAO,EAAE,OAAO,IAAI,cAAc;QAClC,SAAS,EAAE,CAAC,EAAE,gCAAgC;QAC9C,oBAAoB,EAAE,KAAK,EAAE,qCAAqC;QAClE,KAAK,EAAE,KAAK;KACb,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAEpE,MAAM,MAAM,GAAG,OAAO,CAAC,GAAwB,EAAE;QAC/C,IAAI,CAAC,cAAc;YAAE,OAAO,cAAc,CAAC;QAC3C,OAAO,sBAAsB,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;IAChE,CAAC,EAAE,CAAC,cAAc,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;IAEjD,yEAAyE;IACzE,MAAM,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IACnC,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,YAAY,CAAC,OAAO,KAAK,KAAK;YAAE,OAAO;QAC3C,YAAY,CAAC,OAAO,GAAG,KAAK,CAAC;QAC7B,IAAI,MAAM,KAAK,eAAe;YAAE,OAAO,EAAE,CAAC;IAC5C,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAE7B,MAAM,YAAY,GAAG,WAAW,CAAC,GAAG,EAAE;QACpC,WAAW,CAAC,iBAAiB,CAAC;YAC5B,QAAQ,EAAE,SAAS,CAAC,MAAM,CAAC,cAAc,CAAC,SAAS,CAAC;SACrD,CAAC,CAAC;QACH,OAAO,EAAE,CAAC;IACZ,CAAC,EAAE,CAAC,WAAW,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;IAEtC,OAAO;QACL,QAAQ;QACR,MAAM;QACN,SAAS;QACT,KAAK,EAAE,KAAK,IAAI,IAAI;QACpB,OAAO,EAAE,GAAG,EAAE;YACZ,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,YAAY;KACb,CAAC;AACJ,CAAC","sourcesContent":["/**\n * Hook for fetching a random practice puzzle for a technique, with the\n * auth / subscription / empty states the practice screens show.\n */\n\nimport { useCallback, useEffect, useMemo, useRef } from 'react';\nimport type { TechniquePractice } from '@sudobility/sudojo_types';\nimport type { NetworkClient } from '@sudobility/types';\nimport { queryKeys, useSudojoRandomPractice } from '@sudobility/sudojo_client';\nimport { useQueryClient } from '@tanstack/react-query';\nimport { useResolvedSudojoApi } from '../context/SudojoApiContext';\nimport {\n  getPracticeFetchStatus,\n  type PracticeFetchStatus,\n} from '../utils/gameFetchStatus';\n\nexport interface UsePracticeGameOptions {\n  /** Network client for API calls (default: SudojoApiProvider) */\n  networkClient?: NetworkClient | undefined;\n  /** Base URL for the Sudojo API (default: SudojoApiProvider) */\n  baseUrl?: string | undefined;\n  /** Access token (default: SudojoApiProvider) */\n  token?: string | null | undefined;\n  /** Technique number (1-60); the query is idle for anything below 1 */\n  techniqueId: number | null | undefined;\n  /** Whether to enable the query (default true) */\n  enabled?: boolean;\n}\n\nexport interface UsePracticeGameResult {\n  /** The practice puzzle, when loaded */\n  practice: TechniquePractice | null;\n  /** Which screen to show */\n  status: PracticeFetchStatus;\n  /** Whether the request is in flight */\n  isLoading: boolean;\n  /** The request error, if any */\n  error: Error | null;\n  /** Ask again (e.g. after a paywall purchase) */\n  refetch: () => void;\n  /** Drop the cached practice and fetch another random one */\n  nextPractice: () => void;\n}\n\n/**\n * Fetch a random practice for a technique.\n *\n * The practice query is not keyed on the token, so when the status is\n * `auth_required` and the token changes (the reader signed in over the\n * screen) it refetches, as both apps did.\n *\n * @example\n * ```tsx\n * const { practice, status, refetch, nextPractice } = usePracticeGame({\n *   networkClient, baseUrl, token, techniqueId,\n * });\n * if (status === 'auth_required') return <SignInGate />;\n * if (status === 'subscription_required') return <Paywall onSuccess={refetch} />;\n * if (status === 'no_practices') return <Empty />;\n * if (status === 'ready') return <SudokuGame puzzle={practice.board} ... />;\n * ```\n */\nexport function usePracticeGame(\n  options: UsePracticeGameOptions\n): UsePracticeGameResult {\n  const { techniqueId, enabled = true } = options;\n  const { networkClient, baseUrl, token } = useResolvedSudojoApi(\n    options,\n    'usePracticeGame'\n  );\n  const technique = techniqueId ?? 0;\n  const validTechnique = Number.isInteger(technique) && technique >= 1;\n  const queryClient = useQueryClient();\n\n  const {\n    data: response,\n    isLoading,\n    error,\n    refetch,\n  } = useSudojoRandomPractice(networkClient, baseUrl, token, technique, {\n    enabled: enabled && validTechnique,\n    staleTime: 0, // Always fetch fresh for random\n    refetchOnWindowFocus: false, // Keep the current practice on focus\n    retry: false,\n  });\n\n  const practice = response?.success ? (response.data ?? null) : null;\n\n  const status = useMemo((): PracticeFetchStatus => {\n    if (!validTechnique) return 'no_practices';\n    return getPracticeFetchStatus({ isLoading, response, error });\n  }, [validTechnique, isLoading, response, error]);\n\n  // Signing in from the auth_required state asks again with the new token.\n  const lastTokenRef = useRef(token);\n  useEffect(() => {\n    if (lastTokenRef.current === token) return;\n    lastTokenRef.current = token;\n    if (status === 'auth_required') refetch();\n  }, [token, status, refetch]);\n\n  const nextPractice = useCallback(() => {\n    queryClient.invalidateQueries({\n      queryKey: queryKeys.sudojo.practiceRandom(technique),\n    });\n    refetch();\n  }, [queryClient, technique, refetch]);\n\n  return {\n    practice,\n    status,\n    isLoading,\n    error: error ?? null,\n    refetch: () => {\n      refetch();\n    },\n    nextPractice,\n  };\n}\n"]}

package/dist/hooks/usePuzzleDistribution.d.ts

@@ -8,6 +8,8 @@ import type { Level } from '@sudobility/sudojo_types';
  * - No offerId — only free levels (no subscription required)
  * - `'1_blue_belt'` — free levels + blue_belt levels
  * - Anything else — returns 1.0 (all puzzles)
+ *
+ * Memoized wrapper around the pure getPuzzleDistribution.
  */
 export declare function usePuzzleDistribution(levels: Level[], offerId?: string | null): number;
 //# sourceMappingURL=usePuzzleDistribution.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"usePuzzleDistribution.d.ts","sourceRoot":"","sources":["../../src/hooks/usePuzzleDistribution.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAGtD;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,KAAK,EAAE,EACf,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,GACtB,MAAM,CAgBR"}
+{"version":3,"file":"usePuzzleDistribution.d.ts","sourceRoot":"","sources":["../../src/hooks/usePuzzleDistribution.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAGtD;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,KAAK,EAAE,EACf,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,GACtB,MAAM,CAKR"}

package/dist/hooks/usePuzzleDistribution.js

@@ -1,5 +1,5 @@
 import { useMemo } from 'react';
-import { getSubscriptionOfferId } from '@sudobility/sudojo_types';
+import { getPuzzleDistribution } from '../utils/subscription';
 /**
  * Compute the fraction of puzzles accessible for a given offering.
  *
@@ -9,20 +9,10 @@ import { getSubscriptionOfferId } from '@sudobility/sudojo_types';
  * - No offerId — only free levels (no subscription required)
  * - `'1_blue_belt'` — free levels + blue_belt levels
  * - Anything else — returns 1.0 (all puzzles)
+ *
+ * Memoized wrapper around the pure getPuzzleDistribution.
  */
 export function usePuzzleDistribution(levels, offerId) {
-    return useMemo(() => {
-        if (offerId && offerId !== '1_blue_belt')
-            return 1.0;
-        let total = 0;
-        for (const level of levels) {
-            const levelOfferId = getSubscriptionOfferId(level.entitlement);
-            if (!levelOfferId ||
-                (offerId === '1_blue_belt' && levelOfferId === '1_blue_belt')) {
-                total += level.percentage ?? 0;
-            }
-        }
-        return total;
-    }, [levels, offerId]);
+    return useMemo(() => getPuzzleDistribution(levels, offerId), [levels, offerId]);
 }
 //# sourceMappingURL=usePuzzleDistribution.js.map

package/dist/hooks/usePuzzleDistribution.js.map

@@ -1 +1 @@
-{"version":3,"file":"usePuzzleDistribution.js","sourceRoot":"","sources":["../../src/hooks/usePuzzleDistribution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAEhC,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAElE;;;;;;;;;GASG;AACH,MAAM,UAAU,qBAAqB,CACnC,MAAe,EACf,OAAuB;IAEvB,OAAO,OAAO,CAAC,GAAG,EAAE;QAClB,IAAI,OAAO,IAAI,OAAO,KAAK,aAAa;YAAE,OAAO,GAAG,CAAC;QAErD,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,MAAM,YAAY,GAAG,sBAAsB,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YAC/D,IACE,CAAC,YAAY;gBACb,CAAC,OAAO,KAAK,aAAa,IAAI,YAAY,KAAK,aAAa,CAAC,EAC7D,CAAC;gBACD,KAAK,IAAI,KAAK,CAAC,UAAU,IAAI,CAAC,CAAC;YACjC,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AACxB,CAAC","sourcesContent":["import { useMemo } from 'react';\nimport type { Level } from '@sudobility/sudojo_types';\nimport { getSubscriptionOfferId } from '@sudobility/sudojo_types';\n\n/**\n * Compute the fraction of puzzles accessible for a given offering.\n *\n * Sums the `percentage` field (decimal 0–1) of matching levels based\n * on their derived subscription offer ID:\n *\n * - No offerId — only free levels (no subscription required)\n * - `'1_blue_belt'` — free levels + blue_belt levels\n * - Anything else — returns 1.0 (all puzzles)\n */\nexport function usePuzzleDistribution(\n  levels: Level[],\n  offerId?: string | null\n): number {\n  return useMemo(() => {\n    if (offerId && offerId !== '1_blue_belt') return 1.0;\n\n    let total = 0;\n    for (const level of levels) {\n      const levelOfferId = getSubscriptionOfferId(level.entitlement);\n      if (\n        !levelOfferId ||\n        (offerId === '1_blue_belt' && levelOfferId === '1_blue_belt')\n      ) {\n        total += level.percentage ?? 0;\n      }\n    }\n    return total;\n  }, [levels, offerId]);\n}\n"]}
+{"version":3,"file":"usePuzzleDistribution.js","sourceRoot":"","sources":["../../src/hooks/usePuzzleDistribution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAEhC,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAE9D;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,qBAAqB,CACnC,MAAe,EACf,OAAuB;IAEvB,OAAO,OAAO,CACZ,GAAG,EAAE,CAAC,qBAAqB,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5C,CAAC,MAAM,EAAE,OAAO,CAAC,CAClB,CAAC;AACJ,CAAC","sourcesContent":["import { useMemo } from 'react';\nimport type { Level } from '@sudobility/sudojo_types';\nimport { getPuzzleDistribution } from '../utils/subscription';\n\n/**\n * Compute the fraction of puzzles accessible for a given offering.\n *\n * Sums the `percentage` field (decimal 0–1) of matching levels based\n * on their derived subscription offer ID:\n *\n * - No offerId — only free levels (no subscription required)\n * - `'1_blue_belt'` — free levels + blue_belt levels\n * - Anything else — returns 1.0 (all puzzles)\n *\n * Memoized wrapper around the pure getPuzzleDistribution.\n */\nexport function usePuzzleDistribution(\n  levels: Level[],\n  offerId?: string | null\n): number {\n  return useMemo(\n    () => getPuzzleDistribution(levels, offerId),\n    [levels, offerId]\n  );\n}\n"]}

package/dist/hooks/usePuzzleProgress.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Hook for the player's puzzle progress (completed puzzles, streak, stats),
+ * persisted in localStorage under PROGRESS_STORAGE_KEY.
+ *
+ * The web ProgressProvider's logic. RN does not track progress today; where
+ * it shims localStorage (as it does for the game store) the hook works there
+ * too.
+ */
+import type { UserProgress } from '../types/progress';
+import { type PuzzleCompletion } from '../utils/progress';
+export interface UsePuzzleProgressOptions {
+    /** localStorage key (default PROGRESS_STORAGE_KEY, 'sudojo-progress') */
+    storageKey?: string;
+}
+export interface UsePuzzleProgressResult {
+    /** The stored progress */
+    progress: UserProgress;
+    /** Record a completion (no-op when the puzzle is already completed) */
+    markCompleted: (puzzle: PuzzleCompletion) => void;
+    /** Whether a puzzle has been completed */
+    isCompleted: (type: 'daily' | 'level', id: string) => boolean;
+    /** Ids of completed level puzzles */
+    getCompletedLevelIds: () => string[];
+    /** Dates (YYYY-MM-DD) of completed dailies */
+    getCompletedDailyDates: () => string[];
+    /** Reset to DEFAULT_PROGRESS */
+    resetProgress: () => void;
+}
+/**
+ * @example
+ * ```tsx
+ * const { markCompleted, isCompleted } = usePuzzleProgress();
+ * markCompleted({ type: 'daily', id: '2026-10-05', timeSeconds: 312 });
+ * ```
+ */
+export declare function usePuzzleProgress(options?: UsePuzzleProgressOptions): UsePuzzleProgressResult;
+//# sourceMappingURL=usePuzzleProgress.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"usePuzzleProgress.d.ts","sourceRoot":"","sources":["../../src/hooks/usePuzzleProgress.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,OAAO,EAKL,KAAK,gBAAgB,EACtB,MAAM,mBAAmB,CAAC;AAG3B,MAAM,WAAW,wBAAwB;IACvC,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,uBAAuB;IACtC,0BAA0B;IAC1B,QAAQ,EAAE,YAAY,CAAC;IACvB,uEAAuE;IACvE,aAAa,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAClD,0CAA0C;IAC1C,WAAW,EAAE,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,EAAE,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC;IAC9D,qCAAqC;IACrC,oBAAoB,EAAE,MAAM,MAAM,EAAE,CAAC;IACrC,8CAA8C;IAC9C,sBAAsB,EAAE,MAAM,MAAM,EAAE,CAAC;IACvC,gCAAgC;IAChC,aAAa,EAAE,MAAM,IAAI,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,GAAE,wBAA6B,GACrC,uBAAuB,CAoDzB"}