@provable-games/budokan-sdk 0.1.18 → 0.1.20

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, p 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-C4PUxzuO.cjs';
+import { j as BudokanClientConfig, B as BudokanClient, T as Tournament, b as PaginatedResult, e as TournamentListParams, n as Phase, m as LeaderboardEntry, R as Registration, c as RewardClaim, d as RewardClaimSummary, h as PrizeStats, a as Prize, P as PrizeAggregation, Q as QualificationEntry, f as PlatformStats, p as WSEventMessage, o as WSChannel, C as ConnectionMode } from './client-CoWIQozF.cjs';
 import 'starknet';
 import '@provable-games/metagame-sdk';
 
@@ -52,10 +52,6 @@ interface UseTournamentCountResult {
  * 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;
@@ -78,7 +74,6 @@ interface UseRegistrationsResult {
  * Hook to fetch registrations for a tournament.
  */
 declare function useRegistrations(tournamentId: string | undefined, params?: {
-    playerAddress?: string;
     gameTokenIds?: string[];
     hasSubmitted?: boolean;
     isBanned?: boolean;
@@ -86,36 +81,43 @@ declare function useRegistrations(tournamentId: string | undefined, params?: {
     offset?: number;
 }): UseRegistrationsResult;
 
-interface UsePlayerResult {
-    tournaments: PaginatedResult<PlayerTournament> | null;
-    stats: PlayerStats | null;
-    loading: boolean;
-    error: Error | null;
-}
 /**
- * Hook to fetch a player's tournament history and stats.
+ * Tournaments where `owner` currently holds at least one Budokan-minted token.
+ * Stitches denshokan ownership → unique `contextId`s → `useTournaments`
+ * filtered by those IDs. Stays correct under transfers; transferred tokens
+ * drop out of the result, received tokens appear.
+ *
+ * Requires the consuming app to wrap its tree in a `DenshokanProvider`
+ * alongside the `BudokanProvider`.
  */
-declare function usePlayer(address: string | undefined, params?: PlayerTournamentParams): UsePlayerResult;
-interface UsePlayerStatsResult {
-    stats: PlayerStats | null;
-    loading: boolean;
-    error: Error | null;
-    refetch: () => Promise<void>;
-}
+declare function useTournamentsByOwner(owner: string | undefined, params?: {
+    phase?: Phase;
+    limit?: number;
+    offset?: number;
+    sort?: TournamentListParams["sort"];
+    includePrizeSummary?: TournamentListParams["includePrizeSummary"];
+}): UseTournamentsResult;
 /**
- * Hook to fetch stats for a player.
+ * Count of tournaments where `owner` currently holds a Budokan-minted token.
+ * When `phase` is omitted the count comes for free from the denshokan result;
+ * when phase-filtered it makes a second `useTournaments` call (with limit=1)
+ * and reads `.total`.
  */
-declare function usePlayerStats(address: string | undefined): UsePlayerStatsResult;
-interface UsePlayerTournamentsResult {
-    tournaments: PaginatedResult<PlayerTournament> | null;
-    loading: boolean;
-    error: Error | null;
-    refetch: () => Promise<void>;
-}
+declare function useTournamentsByOwnerCount(owner: string | undefined, params?: {
+    phase?: Phase;
+}): UseTournamentCountResult;
 /**
- * Hook to fetch tournaments a player has registered for.
+ * Registrations in `tournamentId` for tokens that `owner` currently holds.
+ * Source of truth is denshokan ownership scoped to the tournament's
+ * `contextId`; registration metadata (ban / submission / entry-number) is
+ * fetched by `gameTokenIds` filter against the tournament.
  */
-declare function usePlayerTournaments(address: string | undefined, params?: PlayerTournamentParams): UsePlayerTournamentsResult;
+declare function useRegistrationsByOwner(tournamentId: string | undefined, owner: string | undefined, params?: {
+    hasSubmitted?: boolean;
+    isBanned?: boolean;
+    limit?: number;
+    offset?: number;
+}): UseRegistrationsResult;
 
 interface UseRewardClaimsResult {
     rewardClaims: PaginatedResult<RewardClaim> | null;
@@ -221,4 +223,4 @@ declare function useConnectionStatus(): {
     datasourceMode: ConnectionMode;
 };
 
-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 };
+export { BudokanProvider, type BudokanProviderProps, type UseActivityStatsResult, type UseLeaderboardResult, 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, usePrizeAggregation, usePrizeStats, usePrizes, useQualifications, useRegistrations, useRegistrationsByOwner, useRewardClaims, useRewardClaimsSummary, useSubscription, useTournament, useTournamentCount, useTournaments, useTournamentsByOwner, useTournamentsByOwnerCount };

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, p 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-C4PUxzuO.js';
+import { j as BudokanClientConfig, B as BudokanClient, T as Tournament, b as PaginatedResult, e as TournamentListParams, n as Phase, m as LeaderboardEntry, R as Registration, c as RewardClaim, d as RewardClaimSummary, h as PrizeStats, a as Prize, P as PrizeAggregation, Q as QualificationEntry, f as PlatformStats, p as WSEventMessage, o as WSChannel, C as ConnectionMode } from './client-CoWIQozF.js';
 import 'starknet';
 import '@provable-games/metagame-sdk';
 
@@ -52,10 +52,6 @@ interface UseTournamentCountResult {
  * 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;
@@ -78,7 +74,6 @@ interface UseRegistrationsResult {
  * Hook to fetch registrations for a tournament.
  */
 declare function useRegistrations(tournamentId: string | undefined, params?: {
-    playerAddress?: string;
     gameTokenIds?: string[];
     hasSubmitted?: boolean;
     isBanned?: boolean;
@@ -86,36 +81,43 @@ declare function useRegistrations(tournamentId: string | undefined, params?: {
     offset?: number;
 }): UseRegistrationsResult;
 
-interface UsePlayerResult {
-    tournaments: PaginatedResult<PlayerTournament> | null;
-    stats: PlayerStats | null;
-    loading: boolean;
-    error: Error | null;
-}
 /**
- * Hook to fetch a player's tournament history and stats.
+ * Tournaments where `owner` currently holds at least one Budokan-minted token.
+ * Stitches denshokan ownership → unique `contextId`s → `useTournaments`
+ * filtered by those IDs. Stays correct under transfers; transferred tokens
+ * drop out of the result, received tokens appear.
+ *
+ * Requires the consuming app to wrap its tree in a `DenshokanProvider`
+ * alongside the `BudokanProvider`.
  */
-declare function usePlayer(address: string | undefined, params?: PlayerTournamentParams): UsePlayerResult;
-interface UsePlayerStatsResult {
-    stats: PlayerStats | null;
-    loading: boolean;
-    error: Error | null;
-    refetch: () => Promise<void>;
-}
+declare function useTournamentsByOwner(owner: string | undefined, params?: {
+    phase?: Phase;
+    limit?: number;
+    offset?: number;
+    sort?: TournamentListParams["sort"];
+    includePrizeSummary?: TournamentListParams["includePrizeSummary"];
+}): UseTournamentsResult;
 /**
- * Hook to fetch stats for a player.
+ * Count of tournaments where `owner` currently holds a Budokan-minted token.
+ * When `phase` is omitted the count comes for free from the denshokan result;
+ * when phase-filtered it makes a second `useTournaments` call (with limit=1)
+ * and reads `.total`.
  */
-declare function usePlayerStats(address: string | undefined): UsePlayerStatsResult;
-interface UsePlayerTournamentsResult {
-    tournaments: PaginatedResult<PlayerTournament> | null;
-    loading: boolean;
-    error: Error | null;
-    refetch: () => Promise<void>;
-}
+declare function useTournamentsByOwnerCount(owner: string | undefined, params?: {
+    phase?: Phase;
+}): UseTournamentCountResult;
 /**
- * Hook to fetch tournaments a player has registered for.
+ * Registrations in `tournamentId` for tokens that `owner` currently holds.
+ * Source of truth is denshokan ownership scoped to the tournament's
+ * `contextId`; registration metadata (ban / submission / entry-number) is
+ * fetched by `gameTokenIds` filter against the tournament.
  */
-declare function usePlayerTournaments(address: string | undefined, params?: PlayerTournamentParams): UsePlayerTournamentsResult;
+declare function useRegistrationsByOwner(tournamentId: string | undefined, owner: string | undefined, params?: {
+    hasSubmitted?: boolean;
+    isBanned?: boolean;
+    limit?: number;
+    offset?: number;
+}): UseRegistrationsResult;
 
 interface UseRewardClaimsResult {
     rewardClaims: PaginatedResult<RewardClaim> | null;
@@ -221,4 +223,4 @@ declare function useConnectionStatus(): {
     datasourceMode: ConnectionMode;
 };
 
-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 };
+export { BudokanProvider, type BudokanProviderProps, type UseActivityStatsResult, type UseLeaderboardResult, 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, usePrizeAggregation, usePrizeStats, usePrizes, useQualifications, useRegistrations, useRegistrationsByOwner, useRewardClaims, useRewardClaimsSummary, useSubscription, useTournament, useTournamentCount, useTournaments, useTournamentsByOwner, useTournamentsByOwnerCount };