@provable-games/budokan-sdk 0.1.8 → 0.1.10

package/dist/react.d.cts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
-import { m as BudokanClientConfig, B as BudokanClient, T as Tournament, b as PaginatedResult, e as TournamentListParams, q as Phase, L as LeaderboardEntry, R as Registration, h as PlayerTournament, f as PlayerStats, g as PlayerTournamentParams, c as RewardClaim, d as RewardClaimSummary, k as PrizeStats, a as Prize, P as PrizeAggregation, Q as QualificationEntry, i as PlatformStats, s as WSEventMessage, r as WSChannel, C as ConnectionMode } from './client-CYj1Iw_w.cjs';
+import { m as BudokanClientConfig, B as BudokanClient, T as Tournament, b as PaginatedResult, e as TournamentListParams, q as Phase, L as LeaderboardEntry, R as Registration, h as PlayerTournament, f as PlayerStats, g as PlayerTournamentParams, c as RewardClaim, d as RewardClaimSummary, k as PrizeStats, a as Prize, P as PrizeAggregation, Q as QualificationEntry, i as PlatformStats, s as WSEventMessage, r as WSChannel, C as ConnectionMode } from './client-ugXv3NlV.cjs';
 import 'starknet';
 import '@provable-games/metagame-sdk';
 
@@ -79,6 +79,9 @@ interface UseRegistrationsResult {
  */
 declare function useRegistrations(tournamentId: string | undefined, params?: {
     playerAddress?: string;
+    gameTokenIds?: string[];
+    hasSubmitted?: boolean;
+    isBanned?: boolean;
     limit?: number;
     offset?: number;
 }): UseRegistrationsResult;
@@ -92,7 +95,7 @@ interface UsePlayerResult {
 /**
  * Hook to fetch a player's tournament history and stats.
  */
-declare function usePlayer(address: string | undefined): UsePlayerResult;
+declare function usePlayer(address: string | undefined, params?: PlayerTournamentParams): UsePlayerResult;
 interface UsePlayerStatsResult {
     stats: PlayerStats | null;
     loading: boolean;
@@ -123,7 +126,10 @@ interface UseRewardClaimsResult {
 /**
  * Hook to fetch reward claims for a tournament.
  */
-declare function useRewardClaims(tournamentId: string | undefined): UseRewardClaimsResult;
+declare function useRewardClaims(tournamentId: string | undefined, params?: {
+    limit?: number;
+    offset?: number;
+}): UseRewardClaimsResult;
 interface UseRewardClaimsSummaryResult {
     summary: RewardClaimSummary | null;
     loading: boolean;
@@ -176,7 +182,10 @@ interface UseQualificationsResult {
 /**
  * Hook to fetch qualification entries for a tournament.
  */
-declare function useQualifications(tournamentId: string | undefined): UseQualificationsResult;
+declare function useQualifications(tournamentId: string | undefined, params?: {
+    limit?: number;
+    offset?: number;
+}): UseQualificationsResult;
 
 interface UseActivityStatsResult {
     stats: PlatformStats | null;

package/dist/react.d.ts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
-import { m as BudokanClientConfig, B as BudokanClient, T as Tournament, b as PaginatedResult, e as TournamentListParams, q as Phase, L as LeaderboardEntry, R as Registration, h as PlayerTournament, f as PlayerStats, g as PlayerTournamentParams, c as RewardClaim, d as RewardClaimSummary, k as PrizeStats, a as Prize, P as PrizeAggregation, Q as QualificationEntry, i as PlatformStats, s as WSEventMessage, r as WSChannel, C as ConnectionMode } from './client-CYj1Iw_w.js';
+import { m as BudokanClientConfig, B as BudokanClient, T as Tournament, b as PaginatedResult, e as TournamentListParams, q as Phase, L as LeaderboardEntry, R as Registration, h as PlayerTournament, f as PlayerStats, g as PlayerTournamentParams, c as RewardClaim, d as RewardClaimSummary, k as PrizeStats, a as Prize, P as PrizeAggregation, Q as QualificationEntry, i as PlatformStats, s as WSEventMessage, r as WSChannel, C as ConnectionMode } from './client-ugXv3NlV.js';
 import 'starknet';
 import '@provable-games/metagame-sdk';
 
@@ -79,6 +79,9 @@ interface UseRegistrationsResult {
  */
 declare function useRegistrations(tournamentId: string | undefined, params?: {
     playerAddress?: string;
+    gameTokenIds?: string[];
+    hasSubmitted?: boolean;
+    isBanned?: boolean;
     limit?: number;
     offset?: number;
 }): UseRegistrationsResult;
@@ -92,7 +95,7 @@ interface UsePlayerResult {
 /**
  * Hook to fetch a player's tournament history and stats.
  */
-declare function usePlayer(address: string | undefined): UsePlayerResult;
+declare function usePlayer(address: string | undefined, params?: PlayerTournamentParams): UsePlayerResult;
 interface UsePlayerStatsResult {
     stats: PlayerStats | null;
     loading: boolean;
@@ -123,7 +126,10 @@ interface UseRewardClaimsResult {
 /**
  * Hook to fetch reward claims for a tournament.
  */
-declare function useRewardClaims(tournamentId: string | undefined): UseRewardClaimsResult;
+declare function useRewardClaims(tournamentId: string | undefined, params?: {
+    limit?: number;
+    offset?: number;
+}): UseRewardClaimsResult;
 interface UseRewardClaimsSummaryResult {
     summary: RewardClaimSummary | null;
     loading: boolean;
@@ -176,7 +182,10 @@ interface UseQualificationsResult {
 /**
  * Hook to fetch qualification entries for a tournament.
  */
-declare function useQualifications(tournamentId: string | undefined): UseQualificationsResult;
+declare function useQualifications(tournamentId: string | undefined, params?: {
+    limit?: number;
+    offset?: number;
+}): UseQualificationsResult;
 
 interface UseActivityStatsResult {
     stats: PlatformStats | null;

package/dist/react.js

@@ -247,6 +247,10 @@ async function getTournamentLeaderboard(baseUrl, tournamentId, ctx) {
 }
 async function getTournamentRegistrations(baseUrl, tournamentId, params, ctx) {
   const qs = buildQueryString({
+    player_address: params?.playerAddress,
+    game_token_ids: params?.gameTokenIds?.length ? params.gameTokenIds.join(",") : void 0,
+    has_submitted: params?.hasSubmitted,
+    is_banned: params?.isBanned,
     limit: params?.limit,
     offset: params?.offset
   });
@@ -1110,7 +1114,9 @@ async function viewerTournamentsByPhase(contract, phase, offset, limit) {
 async function viewerTournamentDetail(contract, tournamentId) {
   return wrapRpcCall(async () => {
     const result = await contract.call("tournament_detail", [tournamentId]);
-    return parseTournamentFullState(result);
+    const tournament = parseTournamentFullState(result);
+    if (!tournament.gameAddress || tournament.gameAddress === "0x0") return null;
+    return tournament;
   }, contract.address);
 }
 async function viewerTournamentsBatch(contract, tournamentIds) {
@@ -1133,6 +1139,34 @@ async function viewerRegistrations(contract, tournamentId, offset, limit) {
     };
   }, contract.address);
 }
+async function viewerRegistrationsByOwner(contract, tournamentId, owner, offset, limit) {
+  return wrapRpcCall(async () => {
+    const result = await contract.call("tournament_registrations_by_owner", [tournamentId, owner, offset, limit]);
+    const obj = result;
+    const entries = obj.entries ?? [];
+    const total = Number(obj.total ?? 0);
+    return {
+      data: entries.map((e) => parseRegistration(e, tournamentId)),
+      total,
+      limit,
+      offset
+    };
+  }, contract.address);
+}
+async function viewerRegistrationsByTokenIds(contract, tournamentId, tokenIds, offset, limit) {
+  return wrapRpcCall(async () => {
+    const result = await contract.call("tournament_registrations_by_token_ids", [tournamentId, tokenIds, offset, limit]);
+    const obj = result;
+    const entries = obj.entries ?? [];
+    const total = Number(obj.total ?? 0);
+    return {
+      data: entries.map((e) => parseRegistration(e, tournamentId)),
+      total,
+      limit,
+      offset
+    };
+  }, contract.address);
+}
 async function viewerLeaderboard(contract, tournamentId, offset, limit) {
   return wrapRpcCall(async () => {
     const result = await contract.call("leaderboard", [tournamentId, offset, limit]);
@@ -2519,11 +2553,16 @@ var BudokanClient = class {
     if (this.resolvedConfig.primarySource === "rpc") {
       return rpcFallback();
     }
-    return withFallback(
-      () => getTournament(this.resolvedConfig.apiBaseUrl, tournamentId, this.apiCtx),
-      rpcFallback,
-      this.connectionStatus
-    );
+    try {
+      return await getTournament(this.resolvedConfig.apiBaseUrl, tournamentId, this.apiCtx);
+    } catch {
+      try {
+        this.connectionStatus.markApiUnavailable();
+        return await rpcFallback();
+      } catch {
+        return null;
+      }
+    }
   }
   /**
    * Fetch the leaderboard for a tournament.
@@ -2546,13 +2585,21 @@ var BudokanClient = class {
   /**
    * Fetch registrations for a tournament.
    * Supports RPC fallback when API is unavailable.
-   * Note: In RPC mode, `playerAddress` and `gameAddress` fields will be empty strings.
+   * Note: In RPC mode, `playerAddress` and `gameAddress` fields will be empty strings,
+   * and filter params (`playerAddress`, `gameTokenIds`, `hasSubmitted`, `isBanned`)
+   * are applied via on-chain viewer functions where supported.
    */
   async getTournamentRegistrations(tournamentId, params) {
     const rpcFallback = async () => {
       const contract = await this.getViewerContract();
       const offset = params?.offset ?? 0;
       const limit = params?.limit ?? 20;
+      if (params?.playerAddress) {
+        return viewerRegistrationsByOwner(contract, tournamentId, params.playerAddress, offset, limit);
+      }
+      if (params?.gameTokenIds?.length) {
+        return viewerRegistrationsByTokenIds(contract, tournamentId, params.gameTokenIds, offset, limit);
+      }
       return viewerRegistrations(contract, tournamentId, offset, limit);
     };
     if (this.resolvedConfig.primarySource === "rpc") {
@@ -2957,20 +3004,21 @@ function useRegistrations(tournamentId, params) {
   }, [fetch2]);
   return { registrations, loading, error, refetch: fetch2 };
 }
-function usePlayer(address) {
+function usePlayer(address, params) {
   const client = useBudokanClient();
   const [tournaments, setTournaments] = useState(null);
   const [stats, setStats] = useState(null);
   const [loading, setLoading] = useState(!!address);
   const [error, setError] = useState(null);
   useResetOnClient(client, setTournaments, setStats, setError);
+  const paramsKey = JSON.stringify(params);
   const fetch2 = useCallback(async () => {
     if (!address) return;
     setLoading(true);
     setError(null);
     try {
       const [tournamentsResult, statsResult] = await Promise.all([
-        client.getPlayerTournaments(address),
+        client.getPlayerTournaments(address, params),
         client.getPlayerStats(address)
       ]);
       setTournaments(tournamentsResult);
@@ -2980,7 +3028,7 @@ function usePlayer(address) {
     } finally {
       setLoading(false);
     }
-  }, [client, address]);
+  }, [client, address, paramsKey]);
   useEffect(() => {
     fetch2();
   }, [fetch2]);
@@ -3035,25 +3083,26 @@ function usePlayerTournaments(address, params) {
   }, [fetch2]);
   return { tournaments, loading, error, refetch: fetch2 };
 }
-function useRewardClaims(tournamentId) {
+function useRewardClaims(tournamentId, params) {
   const client = useBudokanClient();
   const [rewardClaims, setRewardClaims] = useState(null);
   const [loading, setLoading] = useState(!!tournamentId);
   const [error, setError] = useState(null);
   useResetOnClient(client, setRewardClaims, setError);
+  const paramsKey = JSON.stringify(params);
   const fetch2 = useCallback(async () => {
     if (!tournamentId) return;
     setLoading(true);
     setError(null);
     try {
-      const result = await client.getTournamentRewardClaims(tournamentId);
+      const result = await client.getTournamentRewardClaims(tournamentId, params);
       setRewardClaims(result);
     } catch (e) {
       setError(e);
     } finally {
       setLoading(false);
     }
-  }, [client, tournamentId]);
+  }, [client, tournamentId, paramsKey]);
   useEffect(() => {
     fetch2();
   }, [fetch2]);
@@ -3154,25 +3203,26 @@ function usePrizeAggregation(tournamentId) {
   }, [fetch2]);
   return { prizeAggregation, loading, error, refetch: fetch2 };
 }
-function useQualifications(tournamentId) {
+function useQualifications(tournamentId, params) {
   const client = useBudokanClient();
   const [qualifications, setQualifications] = useState(null);
   const [loading, setLoading] = useState(!!tournamentId);
   const [error, setError] = useState(null);
   useResetOnClient(client, setQualifications, setError);
+  const paramsKey = JSON.stringify(params);
   const fetch2 = useCallback(async () => {
     if (!tournamentId) return;
     setLoading(true);
     setError(null);
     try {
-      const result = await client.getTournamentQualifications(tournamentId);
+      const result = await client.getTournamentQualifications(tournamentId, params);
       setQualifications(result);
     } catch (e) {
       setError(e);
     } finally {
       setLoading(false);
     }
-  }, [client, tournamentId]);
+  }, [client, tournamentId, paramsKey]);
   useEffect(() => {
     fetch2();
   }, [fetch2]);