@agg-build/hooks 2.1.2 → 2.2.0

package/dist/index.d.ts

@@ -118,6 +118,7 @@ type UnifiedBalanceResponse = {
         chains: {
             chainId: number;
             tokenAddress: string;
+            tokenSymbol?: string | undefined;
             balanceRaw: string;
             heldRaw?: string | undefined;
             availableRaw?: string | undefined;
@@ -236,7 +237,8 @@ type VenueMarket = {
     question: string;
     venueMarketOutcomes: {
         id: string;
-        price: number;
+        /** REMOVED — no longer returned; use GET /midpoints for live prices. */
+        price?: number | undefined;
         venueMarketId: string;
         label: string;
         title?: string | null | undefined;
@@ -275,6 +277,10 @@ type VenueMarket = {
     period?: string | null | undefined;
     /** Normalized subject category for prop-tab grouping (e.g., game_lines, exact_score, etc.). */
     marketCategory?: string | null | undefined;
+    /** Section/tab grouping key for sports markets (e.g. "player_props", "totals"). */
+    marketGroup?: string | null | undefined;
+    /** Fine-grained sub-classification within a marketGroup (e.g. "moneyline", "rushing_yards"). */
+    marketSubtype?: string | null | undefined;
     /** Line value for spread/total markets (e.g., 2.5 for totals, 3 for spreads). */
     lineValue?: number | null | undefined;
     matchedVenueMarkets?: {
@@ -286,7 +292,8 @@ type VenueMarket = {
         conditionId?: string | null | undefined;
         venueMarketOutcomes?: {
             id: string;
-            price: number;
+            /** REMOVED — no longer returned; use GET /midpoints for live prices. */
+            price?: number | undefined;
             venueMarketId: string;
             label: string;
             winner?: boolean | null | undefined;
@@ -350,8 +357,12 @@ type VenueEvent = {
      * enum values.
      */
     recurrence?: string | null | undefined;
+    /** Deterministic game-level canonical key for cross-venue sports detail loading. */
+    aggKey?: string | null | undefined;
     /** Type-aware structure classification used to sort markets under this event. */
     structureType?: "candidate" | "sport" | "axis" | "dates" | null | undefined;
+    /** Canonical sport slug for sports events (e.g. "basketball", "soccer"); null for non-sports. */
+    sport?: string | null | undefined;
 };
 type Orderbook = {
     bids: {
@@ -374,7 +385,12 @@ type MatchedVenueMarketOutcomeRef = {
 };
 type VenueMarketOutcome = {
     id: string;
-    price: number;
+    /**
+     * REMOVED — /venue-events and /venue-markets no longer return outcome
+     * prices. Fetch live prices from GET /midpoints (or the live-price hooks),
+     * keyed by this outcome's `id`.
+     */
+    price?: number | undefined;
     venueMarketId: string;
     label: string;
     title?: string | null | undefined;
@@ -892,6 +908,8 @@ interface AggUiLabels {
         showOutcomeAria: (label: string) => string;
         viewResolved: string;
         hideResolved: string;
+        resolvingTitle: string;
+        resolvingDescription: string;
         volumeUnavailable: string;
         tabs: {
             orderBook: string;
@@ -1233,6 +1251,50 @@ interface AggUiLabels {
         resolvedOutcome: (label: string) => string;
         marketDetailsAriaByDate: (dateLabel: string) => string;
         marketDetailsAriaByQuestion: (question: string) => string;
+        sports: {
+            summaryAria: string;
+            sectionTabsAria: string;
+            lineSelectorAria: (marketTitle: string) => string;
+            previousLineAria: (marketTitle: string) => string;
+            nextLineAria: (marketTitle: string) => string;
+            comparisonToggleAria: (marketTitle: string, expanded: boolean) => string;
+            comparisonTitle: string;
+            compareVenues: (count: number) => string;
+            marketCount: (count: number) => string;
+            venueCount: (count: number) => string;
+            volumeShort: string;
+            totalVolumeShort: string;
+            gameStarts: string;
+            moreMarketsTitle: string;
+            gameLinesTab: string;
+            halvesTab: string;
+            exactScoreTab: string;
+            cornersTab: string;
+            goalsTab: string;
+            assistsTab: string;
+            shotsTab: string;
+            otherTab: string;
+            moneylineTitle: string;
+            spreadTitle: string;
+            totalTitle: string;
+            fullPeriod: string;
+            firstHalfPeriod: string;
+            secondHalfPeriod: string;
+            quarterOnePeriod: string;
+            quarterTwoPeriod: string;
+            quarterThreePeriod: string;
+            quarterFourPeriod: string;
+            overtimePeriod: string;
+            otherPeriod: string;
+            loadingTitle: string;
+            loadingDescription: string;
+            emptyTitle: string;
+            emptyDescription: (sectionLabel: string) => string;
+            loadMore: string;
+            loadingMore: string;
+            bestPriceBadge: string;
+            selectOutcomeAria: (marketTitle: string, outcomeLabel: string, priceLabel: string) => string;
+        };
     };
     header: {
         bannerAria: string;
@@ -1347,6 +1409,14 @@ interface AggUiFeatureFlagsConfig {
      * for ad-hoc partner-fired toasts).
      */
     enableNotifications: boolean;
+    /**
+     * Enable the experimental sports event-details view. When `true` and the
+     * event's `structureType === "sport"`, the event page renders the sports
+     * market browser; otherwise the default event-details page is used. Defaults
+     * to `false` (feature-flagged). Driven by `NEXT_PUBLIC_AGG_SHOW_SPORT_MARKETS`
+     * in the demo app / Storybook, threaded through this config.
+     */
+    showSportsMarkets: boolean;
 }
 type AggUiFeatureFlagsConfigInput = Partial<AggUiFeatureFlagsConfig>;
 interface AggUiMarketConfig {
@@ -2057,6 +2127,7 @@ interface ExecutionTerminalOrderEvent {
 }
 interface UseExecutionProgressOptions {
     orderIds: string[] | null;
+    quoteId?: string | null;
     enabled: boolean;
     mode?: "live" | "paper";
 }
@@ -2067,7 +2138,7 @@ interface UseExecutionProgressResult {
     dagProgress: DagStepProgress | null;
     terminalOrderEvents: ExecutionTerminalOrderEvent[];
 }
-declare function useExecutionProgress({ orderIds, enabled, mode, }: UseExecutionProgressOptions): UseExecutionProgressResult;
+declare function useExecutionProgress({ orderIds, quoteId, enabled, mode, }: UseExecutionProgressOptions): UseExecutionProgressResult;
 
 interface ClosedPositionTotals {
     totalTraded: number;
@@ -3352,9 +3423,6 @@ declare function useLiveMarketStores(venueMarketIds: string[]): CandleBuilder[];
  * on `agg.orderbook.outcome`). The midpoint from each outcome's book is its
  * price — no complement derivation needed.
  *
- * Falls back to the static `outcome.price` from the event payload when no
- * live data is available.
- *
  * Returns a stable Map<outcomeId, price> that updates only when cache entries
  * change.
  */
@@ -3530,41 +3598,6 @@ interface UseMidpointsResult {
  */
 declare function useMidpoints(venueMarkets: VenueMarket[] | null | undefined, options?: UseMidpointsOptions): UseMidpointsResult;
 
-interface UseTradableVenuesResult {
-    /**
-     * Set of venue strings that have at least one outcome with a non-null
-     * midpoint from the engine. When non-null, this is the authoritative
-     * set of venues that have a live orderbook for the given cluster.
-     *
-     * `null` while midpoints are still loading — callers should treat this
-     * as "unknown, don't filter yet" and show all venues optimistically.
-     */
-    tradableVenues: ReadonlySet<string> | null;
-    /** True while the underlying midpoints fetch is in flight. */
-    isLoading: boolean;
-}
-/**
- * Dynamic venue-orderbook availability check.
- *
- * Walks the cluster's midpoints (already fetched via /midpoints by the
- * surrounding component, or fetched fresh here if not) and returns the
- * set of venues that have at least one outcome with a non-null midpoint.
- * A venue with NO non-null midpoints across all its outcomes is treated
- * as "no live orderbook" — it appeared in matching/discovery but the
- * engine isn't quoting it (e.g. opinion).
- *
- * The signal is purely runtime: no hardcoded venue allowlist. New
- * venues that join without orderbook support get filtered automatically;
- * venues whose orderbook stream temporarily drops also get filtered
- * until midpoints come back. This keeps the FE in lockstep with what the
- * engine is actually able to quote, without coordinating constants
- * across BE/FE on every venue addition.
- *
- * Use this in surfaces that need to show "X tradeable venues" or filter
- * a venue logo strip — see `getVenueSummary`'s `tradableVenues` option.
- */
-declare function useTradableVenues(venueMarkets: VenueMarket[] | null | undefined): UseTradableVenuesResult;
-
 interface UseMarketChartOptions {
     /** VenueMarketOutcome.id */
     marketId: string | null;
@@ -4164,6 +4197,21 @@ interface UseSmartRouteOptions {
     enabled?: boolean;
     /** Cache freshness and polling interval in milliseconds. Defaults to SMART_ROUTE_STALE_TIME_MS. */
     staleTimeMs?: number;
+    /**
+     * UI activity hints used by the centralized refresh policy. These do not
+     * affect the fetched payload, only whether quote polling should stay active
+     * and whether thin-liquidity quotes should refresh more aggressively.
+     */
+    refreshContext?: {
+        /** True when the quote panel is the visible/active surface. Defaults to true. */
+        isPanelActive?: boolean;
+        /** True while the user is actively editing the quote inputs. Defaults to false. */
+        isEditing?: boolean;
+        /** True when the market is open for trading. Defaults to true. */
+        isMarketOpen?: boolean;
+        /** True while the trade is being submitted or executed. Defaults to false. */
+        isSubmitting?: boolean;
+    };
 }
 /**
  * Why the smart route query is currently loading.
@@ -4812,6 +4860,11 @@ interface UseVenueEventsOptions {
     maxYesPrice?: number;
     /** ISO-8601 timestamp. When set, hides events with endDate <= value; NULL-endDate events are kept. */
     endDateFrom?: string;
+    /**
+     * When true, fold same-venue companion events into one tile per game
+     * (`groupParentId IS NULL`). Default (omitted/false) = ungrouped.
+     */
+    grouped?: boolean;
     /**
      * When restoring from a navigation snapshot, eagerly fetch this many pages
      * on mount (pages are likely cached by React Query from the prior visit).
@@ -5060,6 +5113,16 @@ interface UseVenueMarketsOptions {
     matchStatus?: MatchStatus;
     /** Filter by category IDs. */
     categoryIds?: string[];
+    /** Canonical game or market key filter. */
+    aggKey?: string[];
+    /** Sports section filter: moneyline, spread, total, prop, ... */
+    sportsMarketType?: string[];
+    /** Sports period filter: full, 1h, 2h, q1, ... */
+    period?: string[];
+    /** Sports prop-category filter: corners, goals, assists, ... */
+    marketCategory?: string[];
+    /** Sports section/tab grouping filter: game_lines, spreads, totals, player_props, ... */
+    marketGroup?: string[];
     /** Page size when using cursor pagination. Default 20. */
     limit?: number;
     /** Enable/disable the query. Default true. */
@@ -5068,6 +5131,9 @@ interface UseVenueMarketsOptions {
     sortBy?: "volume" | "volume24hr" | "createdAt" | "yesPrice" | "updatedAt";
     /** Sort direction: "asc" or "desc". */
     sortDir?: "asc" | "desc";
+    /** Sort surface. "list" makes axis/dates events sort by volume (matches the
+     *  tile top-3); omit or "detail" on the detail page to keep structured order. */
+    context?: "list" | "detail";
 }
 /**
  * Fetch venue markets with cursor-based pagination.
@@ -5580,4 +5646,4 @@ declare function useAppConfig(): UseAppConfigResult;
  */
 declare function useCachedAppConfig(): UseAppConfigResult;
 
-export { AUTH_CHOOSER_OPEN_EVENT, type AggAuthContextValue, type AggAuthSignInOptions, type AggBalanceContextValue, AggBalanceProvider, AggProvider, type AggProviderProps, AggProvider as AggSdkProvider, type AggProviderProps as AggSdkProviderProps, type AggUiConfig, type AggUiConfigInput, type AggUiLabels, type AggUiLabelsInput, AggUiProvider, type AggUiTradingExecutionMode, CHART_TIME_RANGES, CONFIRMED_MATCH_STATUSES, type ChartTimeRange, type ClosedPositionTotals, type ComputePriceGapsOptions, DEFAULT_AGG_ROOT_CLASS_NAME, type DagStepProgress, type EventListStateContextValue, EventListStateProvider, type EventListStateSnapshot, type EventTradingContextValue, type EventTradingState, type ExecutionProgressPhase, type ExecutionTerminalOrderEvent, type GeoBlockState, type GetOrdersQuery, type GetPositionsQuery, type InvalidateUserActivityOptions, type InvalidateUserMoneyStateOptions, type LiveBestPriceCandidate, type LiveBestPriceCandidates, type LiveBestPrices, type LiveCandle, MAX_PRICE_GAP_PCT, MIN_PRICE_GAP_PCT, type MarketChartCandle, type MarketChartData, type MarketChartVenueData, type MarketOrderbookData, type MarketOrderbookIntegrity, MarketStatus, type MarketTradingState, MatchStatus, MatchType, type OrderEligibility, type OrderEligibilityReason, type OrderListItem, type OrderbookResult, type PositionGroup, type PriceGapValue, type RedeemEvent, type RedeemLegLifecycle, type RedeemLifecycleState, RedeemRejectedError, type RollingChartWindow, type ScaledCandlePoint, type SdkUiConfig, type SdkUiConfigInput, type SdkUiProviderProps, type SmartRouteLoadingReason, type ThemeMode, TradeSide, type TradingAction, type TradingState, type TradingStateBase, type TradingStateKind, type UseAggAuthOptions, type UseAggAuthReturn, type UseAppConfigResult, type UseArbFeedResult, type UseCategoriesOptions, type UseCategoryChildrenOptions, type UseEnrichedVenueEventOptions, type UseExecuteManagedOptions, type UseExecutionOrdersOptions, type UseExecutionPositionsOptions, type UseExecutionProgressOptions, type UseExecutionProgressResult, type UseExternalIdOptions, type UseExternalIdReturn, type UseLinkAccountReturn, type UseLiveCandleOverlayOptions, type UseLiveCandleOverlayResult, type UseLiveCandlesOptions, type UseLiveCandlesResult, type UseLiveMarketResult, type UseMarketArbResult, type UseMarketChartOptions, type UseMarketChartResult, type UseMarketOrderbookOptions, type UseMarketOrderbookResult, type UseMarketOrderbookVenueOutcome, type UseMarketSearchOptions, type UseMidpointsOptions, type UseMidpointsResult, type UseOrderBookOptions, type UseOrderbookQuoteOptions, type UseOrderbookQuoteResult, type UseOrdersOptions, type UsePositionsOptions, type UseQuoteManagedOptions, type UseRedeemLifecycleInput, type UseRollingChartWindowOptions, type UseSearchOptions, type UseSmartRouteOptions, type UseSmartRouteResult, type UseTradableVenuesResult, type UseUserActivityOptions, type UseUserHoldingsOptions, type UseVenueEventOptions, type UseVenueEventsOptions, type UseVenueMarketMidpointsOptions, type UseVenueMarketsOptions, type UseViewportMidpointsOptions, type UseVisibleIdsOptions, type UseVisibleIdsResult, type UserActivityInvalidationStrategy, Venue, type VenueAvailabilityState, type VenueEvent, type VenueEventWithMarkets, type VenueMarket, type VenueMarketOutcome, type WalletActionSendTokenParams, type WalletActions, buildLiveBestPriceCandidates, computeClosedPositionTotals, computePriceGaps, defaultAggUiConfig, defaultAggUiConfig as defaultSdkUiConfig, executionKeys, extractOutcomeBestCandidate, findLivePriceById, getBuilder, getOrCreateBuilder, getVenueAvailabilityState, getVisibleVenueIdsByConfig, getVisibleVenuesByConfig, getWalletAddressFromUserProfile, invalidateBalanceQueries, invalidatePositionQueries, invalidateUserActivityQueries, invalidateUserClaimState, invalidateUserMoneyState, isVenueDisabledByConfig, mergeBestPricesPreferringLive, normalizeVenueId, optimizedImageUrl, parseEmail, parseEmailStrict, rangeToSeconds, requestAggAuthChooserOpen, resolveAggUiLabels, resolveDefaultMarket as resolveDefaultTradingMarket, resolveEventTradingState, resolveMarketTradingState, resolveMarketWinningOutcome, resolveOrderEligibility, resolveRollingWindow, resolveTradingStateKind, sortVenues, timeRangeToInterval, tradingReducer, useAggAuth, useAggAuthContext, useAggAuthState, useAggBalance, useAggBalanceContext, useAggBalanceState, useAggClient, useAggLabels, useAggUiConfig, useAggWebSocket, useAppConfig, useArbFeed, useCachedAppConfig, useCategories, useCategoryChildren, useDebouncedValue, useEnrichedVenueEvent, useEventListState, useEventOrderbookData, useEventTradingContext, useExecuteManaged, useExecutionOrders, useExecutionPositions, useExecutionProgress, useExternalId, useGeoBlock, useLabels, useLinkAccount, useLiveBestPriceCandidates, useLiveBestPrices, useLiveCandleOverlay, useLiveCandles, useLiveMarket, useLiveMarketStores, useLiveOutcomePrices, useLiveTrades, useMarketArb, useMarketChart, useMarketOrderbook, useMarketSearch, useMidpoints, useOnBalanceUpdate, useOnOrderEvent, useOnOrderSubmitted, useOnRedeemEvent, useOnWithdrawalLifecycle, useOptionalAggClient, useOrderBook, useOrderbookQuote, useOrders, usePositions, useQuoteManaged, useRampQuotes, useRampSession, useRedeem, useRedeemEligibleCount, useRedeemLifecycle, useRedeemLifecycles, useRollingChartWindow, useSdkLabels, useSdkUiConfig, useSearch, useSmartRoute, useTradableVenues, useUserActivity, useUserHoldings, useVenueEvent, useVenueEvents, useVenueMarketMidpoints, useVenueMarkets, useViewportMidpoints, useVisibleIds, userActivityQueryKeys };
+export { AUTH_CHOOSER_OPEN_EVENT, type AggAuthContextValue, type AggAuthSignInOptions, type AggBalanceContextValue, AggBalanceProvider, AggProvider, type AggProviderProps, AggProvider as AggSdkProvider, type AggProviderProps as AggSdkProviderProps, type AggUiConfig, type AggUiConfigInput, type AggUiLabels, type AggUiLabelsInput, AggUiProvider, type AggUiTradingExecutionMode, CHART_TIME_RANGES, CONFIRMED_MATCH_STATUSES, type ChartTimeRange, type ClosedPositionTotals, type ComputePriceGapsOptions, DEFAULT_AGG_ROOT_CLASS_NAME, type DagStepProgress, type EventListStateContextValue, EventListStateProvider, type EventListStateSnapshot, type EventTradingContextValue, type EventTradingState, type ExecutionProgressPhase, type ExecutionTerminalOrderEvent, type GeoBlockState, type GetOrdersQuery, type GetPositionsQuery, type InvalidateUserActivityOptions, type InvalidateUserMoneyStateOptions, type LiveBestPriceCandidate, type LiveBestPriceCandidates, type LiveBestPrices, type LiveCandle, MAX_PRICE_GAP_PCT, MIN_PRICE_GAP_PCT, type MarketChartCandle, type MarketChartData, type MarketChartVenueData, type MarketOrderbookData, type MarketOrderbookIntegrity, MarketStatus, type MarketTradingState, MatchStatus, MatchType, type OrderEligibility, type OrderEligibilityReason, type OrderListItem, type OrderbookResult, type PositionGroup, type PriceGapValue, type RedeemEvent, type RedeemLegLifecycle, type RedeemLifecycleState, RedeemRejectedError, type RollingChartWindow, type ScaledCandlePoint, type SdkUiConfig, type SdkUiConfigInput, type SdkUiProviderProps, type SmartRouteLoadingReason, type ThemeMode, TradeSide, type TradingAction, type TradingState, type TradingStateBase, type TradingStateKind, type UseAggAuthOptions, type UseAggAuthReturn, type UseAppConfigResult, type UseArbFeedResult, type UseCategoriesOptions, type UseCategoryChildrenOptions, type UseEnrichedVenueEventOptions, type UseExecuteManagedOptions, type UseExecutionOrdersOptions, type UseExecutionPositionsOptions, type UseExecutionProgressOptions, type UseExecutionProgressResult, type UseExternalIdOptions, type UseExternalIdReturn, type UseLinkAccountReturn, type UseLiveCandleOverlayOptions, type UseLiveCandleOverlayResult, type UseLiveCandlesOptions, type UseLiveCandlesResult, type UseLiveMarketResult, type UseMarketArbResult, type UseMarketChartOptions, type UseMarketChartResult, type UseMarketOrderbookOptions, type UseMarketOrderbookResult, type UseMarketOrderbookVenueOutcome, type UseMarketSearchOptions, type UseMidpointsOptions, type UseMidpointsResult, type UseOrderBookOptions, type UseOrderbookQuoteOptions, type UseOrderbookQuoteResult, type UseOrdersOptions, type UsePositionsOptions, type UseQuoteManagedOptions, type UseRedeemLifecycleInput, type UseRollingChartWindowOptions, type UseSearchOptions, type UseSmartRouteOptions, type UseSmartRouteResult, type UseUserActivityOptions, type UseUserHoldingsOptions, type UseVenueEventOptions, type UseVenueEventsOptions, type UseVenueMarketMidpointsOptions, type UseVenueMarketsOptions, type UseViewportMidpointsOptions, type UseVisibleIdsOptions, type UseVisibleIdsResult, type UserActivityInvalidationStrategy, Venue, type VenueAvailabilityState, type VenueEvent, type VenueEventWithMarkets, type VenueMarket, type VenueMarketOutcome, type WalletActionSendTokenParams, type WalletActions, buildLiveBestPriceCandidates, computeClosedPositionTotals, computePriceGaps, defaultAggUiConfig, defaultAggUiConfig as defaultSdkUiConfig, executionKeys, extractOutcomeBestCandidate, findLivePriceById, getBuilder, getOrCreateBuilder, getVenueAvailabilityState, getVisibleVenueIdsByConfig, getVisibleVenuesByConfig, getWalletAddressFromUserProfile, invalidateBalanceQueries, invalidatePositionQueries, invalidateUserActivityQueries, invalidateUserClaimState, invalidateUserMoneyState, isVenueDisabledByConfig, mergeBestPricesPreferringLive, normalizeVenueId, optimizedImageUrl, parseEmail, parseEmailStrict, rangeToSeconds, requestAggAuthChooserOpen, resolveAggUiLabels, resolveDefaultMarket as resolveDefaultTradingMarket, resolveEventTradingState, resolveMarketTradingState, resolveMarketWinningOutcome, resolveOrderEligibility, resolveRollingWindow, resolveTradingStateKind, sortVenues, timeRangeToInterval, tradingReducer, useAggAuth, useAggAuthContext, useAggAuthState, useAggBalance, useAggBalanceContext, useAggBalanceState, useAggClient, useAggLabels, useAggUiConfig, useAggWebSocket, useAppConfig, useArbFeed, useCachedAppConfig, useCategories, useCategoryChildren, useDebouncedValue, useEnrichedVenueEvent, useEventListState, useEventOrderbookData, useEventTradingContext, useExecuteManaged, useExecutionOrders, useExecutionPositions, useExecutionProgress, useExternalId, useGeoBlock, useLabels, useLinkAccount, useLiveBestPriceCandidates, useLiveBestPrices, useLiveCandleOverlay, useLiveCandles, useLiveMarket, useLiveMarketStores, useLiveOutcomePrices, useLiveTrades, useMarketArb, useMarketChart, useMarketOrderbook, useMarketSearch, useMidpoints, useOnBalanceUpdate, useOnOrderEvent, useOnOrderSubmitted, useOnRedeemEvent, useOnWithdrawalLifecycle, useOptionalAggClient, useOrderBook, useOrderbookQuote, useOrders, usePositions, useQuoteManaged, useRampQuotes, useRampSession, useRedeem, useRedeemEligibleCount, useRedeemLifecycle, useRedeemLifecycles, useRollingChartWindow, useSdkLabels, useSdkUiConfig, useSearch, useSmartRoute, useUserActivity, useUserHoldings, useVenueEvent, useVenueEvents, useVenueMarketMidpoints, useVenueMarkets, useViewportMidpoints, useVisibleIds, userActivityQueryKeys };