@provable-games/budokan-sdk 0.1.13 → 0.1.16

package/dist/{client-ugXv3NlV.d.cts → client-CP4dxHGv.d.cts}

@@ -151,6 +151,9 @@ interface Prize {
     tokenId: string | null;
     distributionType: string | null;
     distributionWeight: number | null;
+    /** Populated only when `distributionType === "custom"`. Each entry is a u16
+     *  basis-point share summing to 10000, one per paid position. */
+    distributionShares: number[] | null;
     distributionCount: number | null;
     sponsorAddress: string;
 }
@@ -328,6 +331,7 @@ declare class BudokanClient {
     private readonly connectionStatus;
     private cachedProvider;
     private cachedViewerContract;
+    private cachedBudokanContract;
     constructor(config: BudokanClientConfig);
     /** Returns the resolved configuration. */
     get clientConfig(): BudokanClientConfig;
@@ -339,6 +343,7 @@ declare class BudokanClient {
     onConnectionStatusChange(listener: (status: ConnectionStatusState) => void): () => void;
     private getProvider;
     private getViewerContract;
+    private getBudokanContract;
     private get apiCtx();
     /**
      * Fetch a paginated list of tournaments with optional filtering.
@@ -348,8 +353,39 @@ declare class BudokanClient {
     /**
      * Fetch a single tournament by its ID.
      * Supports RPC fallback when API is unavailable.
+     *
+     * On the RPC-fallback path, Custom distribution shares are populated via
+     * a follow-up call to `tournament_distribution_shares(id)` so callers see
+     * the same shape regardless of data source (the API/indexer path fills
+     * shares from the `TournamentCreated` event).
      */
     getTournament(tournamentId: string): Promise<Tournament | null>;
+    /**
+     * If the tournament's entry-fee distribution is `Custom` with an empty
+     * shares array (the on-chain `tournament()` view returns empty spans by
+     * design to keep the hot path small), fetch the shares via the
+     * dedicated view and graft them back onto the distribution object.
+     *
+     * Detection is tolerant: the Distribution shape may appear as
+     * `{ variant: { Custom: [] } }` or a flattened `{ Custom: [] }`
+     * depending on the starknet.js version / serialization path.
+     */
+    private fillCustomSharesIfEmpty;
+    /**
+     * Fetch the Custom distribution shares for a tournament via the Budokan
+     * contract's `tournament_distribution_shares(id)` view.
+     *
+     * Returns an empty array for tournaments configured with
+     * `Linear` / `Exponential` / `Uniform` distributions (those don't have a
+     * shares array), and for tournaments without an entry fee.
+     *
+     * This is a direct RPC call — consumers going through the primary API
+     * path typically don't need it, since the indexer sources Custom shares
+     * from the `TournamentCreated` event and exposes them via
+     * `getTournament()`'s `entryFee.distribution`. Use this when you need a
+     * fresh on-chain read or you're operating in RPC-only mode.
+     */
+    getTournamentDistributionShares(tournamentId: string): Promise<number[]>;
     /**
      * Fetch the leaderboard for a tournament.
      * Supports RPC fallback when API is unavailable.

package/dist/{client-ugXv3NlV.d.ts → client-CP4dxHGv.d.ts}

@@ -151,6 +151,9 @@ interface Prize {
     tokenId: string | null;
     distributionType: string | null;
     distributionWeight: number | null;
+    /** Populated only when `distributionType === "custom"`. Each entry is a u16
+     *  basis-point share summing to 10000, one per paid position. */
+    distributionShares: number[] | null;
     distributionCount: number | null;
     sponsorAddress: string;
 }
@@ -328,6 +331,7 @@ declare class BudokanClient {
     private readonly connectionStatus;
     private cachedProvider;
     private cachedViewerContract;
+    private cachedBudokanContract;
     constructor(config: BudokanClientConfig);
     /** Returns the resolved configuration. */
     get clientConfig(): BudokanClientConfig;
@@ -339,6 +343,7 @@ declare class BudokanClient {
     onConnectionStatusChange(listener: (status: ConnectionStatusState) => void): () => void;
     private getProvider;
     private getViewerContract;
+    private getBudokanContract;
     private get apiCtx();
     /**
      * Fetch a paginated list of tournaments with optional filtering.
@@ -348,8 +353,39 @@ declare class BudokanClient {
     /**
      * Fetch a single tournament by its ID.
      * Supports RPC fallback when API is unavailable.
+     *
+     * On the RPC-fallback path, Custom distribution shares are populated via
+     * a follow-up call to `tournament_distribution_shares(id)` so callers see
+     * the same shape regardless of data source (the API/indexer path fills
+     * shares from the `TournamentCreated` event).
      */
     getTournament(tournamentId: string): Promise<Tournament | null>;
+    /**
+     * If the tournament's entry-fee distribution is `Custom` with an empty
+     * shares array (the on-chain `tournament()` view returns empty spans by
+     * design to keep the hot path small), fetch the shares via the
+     * dedicated view and graft them back onto the distribution object.
+     *
+     * Detection is tolerant: the Distribution shape may appear as
+     * `{ variant: { Custom: [] } }` or a flattened `{ Custom: [] }`
+     * depending on the starknet.js version / serialization path.
+     */
+    private fillCustomSharesIfEmpty;
+    /**
+     * Fetch the Custom distribution shares for a tournament via the Budokan
+     * contract's `tournament_distribution_shares(id)` view.
+     *
+     * Returns an empty array for tournaments configured with
+     * `Linear` / `Exponential` / `Uniform` distributions (those don't have a
+     * shares array), and for tournaments without an entry fee.
+     *
+     * This is a direct RPC call — consumers going through the primary API
+     * path typically don't need it, since the indexer sources Custom shares
+     * from the `TournamentCreated` event and exposes them via
+     * `getTournament()`'s `entryFee.distribution`. Use this when you need a
+     * fresh on-chain read or you're operating in RPC-only mode.
+     */
+    getTournamentDistributionShares(tournamentId: string): Promise<number[]>;
     /**
      * Fetch the leaderboard for a tournament.
      * Supports RPC fallback when API is unavailable.