@provable-games/budokan-sdk 0.1.1 → 0.1.3

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, L as LeaderboardEntry, h as PlayerTournament, f as PlayerStats, g as PlayerTournamentParams, c as RewardClaim, d as RewardClaimSummary, k as PrizeStats, a as Prize, Q as QualificationEntry, s as WSEventMessage, r as WSChannel, C as ConnectionMode } from './client-BtC3ngNe.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-BtC3ngNe.cjs';
 
 interface BudokanProviderProps {
     children: ReactNode;
@@ -26,6 +26,7 @@ interface UseTournamentsResult {
 }
 /**
  * Hook to fetch a paginated list of tournaments.
+ * Pass `undefined` to skip fetching (useful for conditional queries).
  */
 declare function useTournaments(params?: TournamentListParams): UseTournamentsResult;
 interface UseTournamentResult {
@@ -39,6 +40,21 @@ interface UseTournamentResult {
  */
 declare function useTournament(tournamentId: string | undefined): UseTournamentResult;
 
+interface UseTournamentCountResult {
+    count: number | null;
+    loading: boolean;
+    error: Error | null;
+    refetch: () => void;
+}
+/**
+ * Hook to fetch the total count of tournaments matching a phase filter.
+ */
+declare function useTournamentCount(phase?: Phase): UseTournamentCountResult;
+/**
+ * Hook to fetch the total count of tournaments a player is registered for.
+ */
+declare function usePlayerTournamentCount(address: string | undefined, phase?: Phase): UseTournamentCountResult;
+
 interface UseLeaderboardResult {
     leaderboard: LeaderboardEntry[] | null;
     loading: boolean;
@@ -50,6 +66,21 @@ interface UseLeaderboardResult {
  */
 declare function useLeaderboard(tournamentId: string | undefined): UseLeaderboardResult;
 
+interface UseRegistrationsResult {
+    registrations: PaginatedResult<Registration> | null;
+    loading: boolean;
+    error: Error | null;
+    refetch: () => void;
+}
+/**
+ * Hook to fetch registrations for a tournament.
+ */
+declare function useRegistrations(tournamentId: string | undefined, params?: {
+    playerAddress?: string;
+    limit?: number;
+    offset?: number;
+}): UseRegistrationsResult;
+
 interface UsePlayerResult {
     tournaments: PaginatedResult<PlayerTournament> | null;
     stats: PlayerStats | null;
@@ -123,6 +154,17 @@ interface UsePrizeStatsResult {
  */
 declare function usePrizeStats(): UsePrizeStatsResult;
 
+interface UsePrizeAggregationResult {
+    prizeAggregation: PrizeAggregation[] | null;
+    loading: boolean;
+    error: Error | null;
+    refetch: () => void;
+}
+/**
+ * Hook to fetch prize aggregation for a tournament.
+ */
+declare function usePrizeAggregation(tournamentId: string | undefined): UsePrizeAggregationResult;
+
 interface UseQualificationsResult {
     qualifications: PaginatedResult<QualificationEntry> | null;
     loading: boolean;
@@ -134,6 +176,17 @@ interface UseQualificationsResult {
  */
 declare function useQualifications(tournamentId: string | undefined): UseQualificationsResult;
 
+interface UseActivityStatsResult {
+    stats: PlatformStats | null;
+    loading: boolean;
+    error: Error | null;
+    refetch: () => void;
+}
+/**
+ * Hook to fetch platform-wide activity stats.
+ */
+declare function useActivityStats(): UseActivityStatsResult;
+
 interface UseSubscriptionResult {
     lastMessage: WSEventMessage | null;
     isConnected: boolean;
@@ -157,4 +210,4 @@ declare function useConnectionStatus(): {
     datasourceMode: ConnectionMode;
 };
 
-export { BudokanProvider, type BudokanProviderProps, type UseLeaderboardResult, type UsePlayerResult, type UsePlayerStatsResult, type UsePlayerTournamentsResult, type UsePrizeStatsResult, type UsePrizesResult, type UseQualificationsResult, type UseRewardClaimsResult, type UseRewardClaimsSummaryResult, type UseSubscriptionResult, type UseTournamentResult, type UseTournamentsResult, useBudokanClient, useConnectionStatus, useLeaderboard, usePlayer, usePlayerStats, usePlayerTournaments, usePrizeStats, usePrizes, useQualifications, useRewardClaims, useRewardClaimsSummary, useSubscription, useTournament, useTournaments };
+export { BudokanProvider, type BudokanProviderProps, type UseActivityStatsResult, type UseLeaderboardResult, type UsePlayerResult, type UsePlayerStatsResult, type UsePlayerTournamentsResult, type UsePrizeAggregationResult, type UsePrizeStatsResult, type UsePrizesResult, type UseQualificationsResult, type UseRegistrationsResult, type UseRewardClaimsResult, type UseRewardClaimsSummaryResult, type UseSubscriptionResult, type UseTournamentCountResult, type UseTournamentResult, type UseTournamentsResult, useActivityStats, useBudokanClient, useConnectionStatus, useLeaderboard, usePlayer, usePlayerStats, usePlayerTournamentCount, usePlayerTournaments, usePrizeAggregation, usePrizeStats, usePrizes, useQualifications, useRegistrations, useRewardClaims, useRewardClaimsSummary, useSubscription, useTournament, useTournamentCount, useTournaments };

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, L as LeaderboardEntry, h as PlayerTournament, f as PlayerStats, g as PlayerTournamentParams, c as RewardClaim, d as RewardClaimSummary, k as PrizeStats, a as Prize, Q as QualificationEntry, s as WSEventMessage, r as WSChannel, C as ConnectionMode } from './client-BtC3ngNe.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-BtC3ngNe.js';
 
 interface BudokanProviderProps {
     children: ReactNode;
@@ -26,6 +26,7 @@ interface UseTournamentsResult {
 }
 /**
  * Hook to fetch a paginated list of tournaments.
+ * Pass `undefined` to skip fetching (useful for conditional queries).
  */
 declare function useTournaments(params?: TournamentListParams): UseTournamentsResult;
 interface UseTournamentResult {
@@ -39,6 +40,21 @@ interface UseTournamentResult {
  */
 declare function useTournament(tournamentId: string | undefined): UseTournamentResult;
 
+interface UseTournamentCountResult {
+    count: number | null;
+    loading: boolean;
+    error: Error | null;
+    refetch: () => void;
+}
+/**
+ * Hook to fetch the total count of tournaments matching a phase filter.
+ */
+declare function useTournamentCount(phase?: Phase): UseTournamentCountResult;
+/**
+ * Hook to fetch the total count of tournaments a player is registered for.
+ */
+declare function usePlayerTournamentCount(address: string | undefined, phase?: Phase): UseTournamentCountResult;
+
 interface UseLeaderboardResult {
     leaderboard: LeaderboardEntry[] | null;
     loading: boolean;
@@ -50,6 +66,21 @@ interface UseLeaderboardResult {
  */
 declare function useLeaderboard(tournamentId: string | undefined): UseLeaderboardResult;
 
+interface UseRegistrationsResult {
+    registrations: PaginatedResult<Registration> | null;
+    loading: boolean;
+    error: Error | null;
+    refetch: () => void;
+}
+/**
+ * Hook to fetch registrations for a tournament.
+ */
+declare function useRegistrations(tournamentId: string | undefined, params?: {
+    playerAddress?: string;
+    limit?: number;
+    offset?: number;
+}): UseRegistrationsResult;
+
 interface UsePlayerResult {
     tournaments: PaginatedResult<PlayerTournament> | null;
     stats: PlayerStats | null;
@@ -123,6 +154,17 @@ interface UsePrizeStatsResult {
  */
 declare function usePrizeStats(): UsePrizeStatsResult;
 
+interface UsePrizeAggregationResult {
+    prizeAggregation: PrizeAggregation[] | null;
+    loading: boolean;
+    error: Error | null;
+    refetch: () => void;
+}
+/**
+ * Hook to fetch prize aggregation for a tournament.
+ */
+declare function usePrizeAggregation(tournamentId: string | undefined): UsePrizeAggregationResult;
+
 interface UseQualificationsResult {
     qualifications: PaginatedResult<QualificationEntry> | null;
     loading: boolean;
@@ -134,6 +176,17 @@ interface UseQualificationsResult {
  */
 declare function useQualifications(tournamentId: string | undefined): UseQualificationsResult;
 
+interface UseActivityStatsResult {
+    stats: PlatformStats | null;
+    loading: boolean;
+    error: Error | null;
+    refetch: () => void;
+}
+/**
+ * Hook to fetch platform-wide activity stats.
+ */
+declare function useActivityStats(): UseActivityStatsResult;
+
 interface UseSubscriptionResult {
     lastMessage: WSEventMessage | null;
     isConnected: boolean;
@@ -157,4 +210,4 @@ declare function useConnectionStatus(): {
     datasourceMode: ConnectionMode;
 };
 
-export { BudokanProvider, type BudokanProviderProps, type UseLeaderboardResult, type UsePlayerResult, type UsePlayerStatsResult, type UsePlayerTournamentsResult, type UsePrizeStatsResult, type UsePrizesResult, type UseQualificationsResult, type UseRewardClaimsResult, type UseRewardClaimsSummaryResult, type UseSubscriptionResult, type UseTournamentResult, type UseTournamentsResult, useBudokanClient, useConnectionStatus, useLeaderboard, usePlayer, usePlayerStats, usePlayerTournaments, usePrizeStats, usePrizes, useQualifications, useRewardClaims, useRewardClaimsSummary, useSubscription, useTournament, useTournaments };
+export { BudokanProvider, type BudokanProviderProps, type UseActivityStatsResult, type UseLeaderboardResult, type UsePlayerResult, type UsePlayerStatsResult, type UsePlayerTournamentsResult, type UsePrizeAggregationResult, type UsePrizeStatsResult, type UsePrizesResult, type UseQualificationsResult, type UseRegistrationsResult, type UseRewardClaimsResult, type UseRewardClaimsSummaryResult, type UseSubscriptionResult, type UseTournamentCountResult, type UseTournamentResult, type UseTournamentsResult, useActivityStats, useBudokanClient, useConnectionStatus, useLeaderboard, usePlayer, usePlayerStats, usePlayerTournamentCount, usePlayerTournaments, usePrizeAggregation, usePrizeStats, usePrizes, useQualifications, useRegistrations, useRewardClaims, useRewardClaimsSummary, useSubscription, useTournament, useTournamentCount, useTournaments };

package/dist/react.js

@@ -2531,10 +2531,11 @@ function useBudokanClient() {
 function useTournaments(params) {
   const client = useBudokanClient();
   const [tournaments, setTournaments] = useState(null);
-  const [loading, setLoading] = useState(true);
+  const [loading, setLoading] = useState(!!params);
   const [error, setError] = useState(null);
   const paramsKey = JSON.stringify(params);
   const fetch2 = useCallback(() => {
+    if (params === void 0) return;
     setLoading(true);
     setError(null);
     client.getTournaments(params).then(setTournaments).catch(setError).finally(() => setLoading(false));
@@ -2560,6 +2561,37 @@ function useTournament(tournamentId) {
   }, [fetch2]);
   return { tournament, loading, error, refetch: fetch2 };
 }
+function useTournamentCount(phase) {
+  const client = useBudokanClient();
+  const [count, setCount] = useState(null);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState(null);
+  const fetch2 = useCallback(() => {
+    setLoading(true);
+    setError(null);
+    client.getTournaments({ phase, limit: 1 }).then((r) => setCount(r.total ?? 0)).catch(setError).finally(() => setLoading(false));
+  }, [client, phase]);
+  useEffect(() => {
+    fetch2();
+  }, [fetch2]);
+  return { count, loading, error, refetch: fetch2 };
+}
+function usePlayerTournamentCount(address, phase) {
+  const client = useBudokanClient();
+  const [count, setCount] = useState(null);
+  const [loading, setLoading] = useState(!!address);
+  const [error, setError] = useState(null);
+  const fetch2 = useCallback(() => {
+    if (!address) return;
+    setLoading(true);
+    setError(null);
+    client.getPlayerTournaments(address, { phase, limit: 1 }).then((r) => setCount(r.total ?? 0)).catch(setError).finally(() => setLoading(false));
+  }, [client, address, phase]);
+  useEffect(() => {
+    fetch2();
+  }, [fetch2]);
+  return { count, loading, error, refetch: fetch2 };
+}
 function useLeaderboard(tournamentId) {
   const client = useBudokanClient();
   const [leaderboard, setLeaderboard] = useState(null);
@@ -2576,6 +2608,23 @@ function useLeaderboard(tournamentId) {
   }, [fetch2]);
   return { leaderboard, loading, error, refetch: fetch2 };
 }
+function useRegistrations(tournamentId, params) {
+  const client = useBudokanClient();
+  const [registrations, setRegistrations] = useState(null);
+  const [loading, setLoading] = useState(!!tournamentId);
+  const [error, setError] = useState(null);
+  const paramsKey = JSON.stringify(params);
+  const fetch2 = useCallback(() => {
+    if (!tournamentId) return;
+    setLoading(true);
+    setError(null);
+    client.getTournamentRegistrations(tournamentId, params).then(setRegistrations).catch(setError).finally(() => setLoading(false));
+  }, [client, tournamentId, paramsKey]);
+  useEffect(() => {
+    fetch2();
+  }, [fetch2]);
+  return { registrations, loading, error, refetch: fetch2 };
+}
 function usePlayer(address) {
   const client = useBudokanClient();
   const [tournaments, setTournaments] = useState(null);
@@ -2620,12 +2669,13 @@ function usePlayerTournaments(address, params) {
   const [tournaments, setTournaments] = useState(null);
   const [loading, setLoading] = useState(!!address);
   const [error, setError] = useState(null);
+  const paramsKey = JSON.stringify(params);
   const fetch2 = useCallback(() => {
     if (!address) return;
     setLoading(true);
     setError(null);
     client.getPlayerTournaments(address, params).then(setTournaments).catch(setError).finally(() => setLoading(false));
-  }, [client, address, params]);
+  }, [client, address, paramsKey]);
   useEffect(() => {
     fetch2();
   }, [fetch2]);
@@ -2694,6 +2744,22 @@ function usePrizeStats() {
   }, [fetch2]);
   return { prizeStats, loading, error, refetch: fetch2 };
 }
+function usePrizeAggregation(tournamentId) {
+  const client = useBudokanClient();
+  const [prizeAggregation, setPrizeAggregation] = useState(null);
+  const [loading, setLoading] = useState(!!tournamentId);
+  const [error, setError] = useState(null);
+  const fetch2 = useCallback(() => {
+    if (!tournamentId) return;
+    setLoading(true);
+    setError(null);
+    client.getTournamentPrizeAggregation(tournamentId).then(setPrizeAggregation).catch(setError).finally(() => setLoading(false));
+  }, [client, tournamentId]);
+  useEffect(() => {
+    fetch2();
+  }, [fetch2]);
+  return { prizeAggregation, loading, error, refetch: fetch2 };
+}
 function useQualifications(tournamentId) {
   const client = useBudokanClient();
   const [qualifications, setQualifications] = useState(null);
@@ -2710,6 +2776,21 @@ function useQualifications(tournamentId) {
   }, [fetch2]);
   return { qualifications, loading, error, refetch: fetch2 };
 }
+function useActivityStats() {
+  const client = useBudokanClient();
+  const [stats, setStats] = useState(null);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState(null);
+  const fetch2 = useCallback(() => {
+    setLoading(true);
+    setError(null);
+    client.getActivityStats().then(setStats).catch(setError).finally(() => setLoading(false));
+  }, [client]);
+  useEffect(() => {
+    fetch2();
+  }, [fetch2]);
+  return { stats, loading, error, refetch: fetch2 };
+}
 function useSubscription(channels, tournamentIds) {
   const client = useBudokanClient();
   const [lastMessage, setLastMessage] = useState(null);
@@ -2755,6 +2836,6 @@ function useConnectionStatus() {
   return { isConnected, datasourceMode };
 }
 
-export { BudokanProvider, useBudokanClient, useConnectionStatus, useLeaderboard, usePlayer, usePlayerStats, usePlayerTournaments, usePrizeStats, usePrizes, useQualifications, useRewardClaims, useRewardClaimsSummary, useSubscription, useTournament, useTournaments };
+export { BudokanProvider, useActivityStats, useBudokanClient, useConnectionStatus, useLeaderboard, usePlayer, usePlayerStats, usePlayerTournamentCount, usePlayerTournaments, usePrizeAggregation, usePrizeStats, usePrizes, useQualifications, useRegistrations, useRewardClaims, useRewardClaimsSummary, useSubscription, useTournament, useTournamentCount, useTournaments };
 //# sourceMappingURL=react.js.map
 //# sourceMappingURL=react.js.map