@agg-build/hooks 1.3.0 → 2.1.0

package/dist/index.d.ts

@@ -2,10 +2,10 @@ import * as _tanstack_react_query from '@tanstack/react-query';
 import { QueryClient } from '@tanstack/react-query';
 export { QueryClient, QueryClientProvider, useQueryClient } from '@tanstack/react-query';
 import * as _agg_build_sdk from '@agg-build/sdk';
-import { CandleBuilder, AggAuthStartBody, AggAuthStartResult, AggClientSessionInput, AggClient, RampQuote, RampQuoteRequest, RampWidgetSession, RampSessionRequest, QuoteManagedResponse, QuoteManagedParams, ExecuteManagedResponse, ExecuteManagedParams, GetPositionsParams, WsOrderSubmitted, WsBalanceUpdate, RedeemResponse, RedeemRequest, WsRedeemEvent, AggWebSocket, WsOrderEvent, WsWithdrawalLifecycleEvent, WsCandleInterval, WsTrade, AggregatedOrderbookResponse, AggLinkAccountBody, AggLinkAccountResult, AggLinkAccountConfirmResult, Category, UserActivityQuery, UserActivityItem, PaginatedResponse, CandleInterval, OrderbookState, OrderbookQuoteResponse, OrderListQuery, TradeExecutorOrder, SmartRouteSide, ExecutionMode, SmartRouteResponse, MidpointRow, BatchMidpointsResponse, AppClientConfigResponse } from '@agg-build/sdk';
+import { CandleBuilder, AggAuthStartBody, AggAuthStartResult, AggClientSessionInput, AggClient, RampQuote, RampQuoteRequest, RampWidgetSession, RampSessionRequest, QuoteManagedResponse, QuoteManagedParams, ExecuteManagedResponse, ExecuteManagedParams, GetPositionsParams, WsOrderSubmitted, WsBalanceUpdate, RedeemResponse, RedeemRequest, WsRedeemEvent, AggWebSocket, WsOrderEvent, WsWithdrawalLifecycleEvent, WsCandleInterval, WsTrade, AggregatedOrderbookResponse, AggLinkAccountBody, AggLinkAccountResult, AggLinkAccountConfirmResult, Category, UserActivityQuery, UserActivityItem, PaginatedResponse, CandleInterval, OrderbookState, OrderbookQuoteResponse, OrderListQuery, TradeExecutorOrder, SmartRouteSide, ExecutionMode, SmartRouteResponse, RecurrenceFilter, MidpointRow, BatchMidpointsResponse, AppClientConfigResponse } from '@agg-build/sdk';
 export { TurnstileChallengeError } from '@agg-build/sdk';
 import React, { ReactNode } from 'react';
-export { UseManagedBalancesOptions, UseWithdrawEstimateParams, UseWithdrawFlowOptions, UseWithdrawFlowResult, UseWithdrawManagedOptions, UseWithdrawalLifecycleResult, WithdrawFeeEstimate, WithdrawalLifecycleState, useManagedBalances, useWithdrawEstimate, useWithdrawFlow, useWithdrawManaged, useWithdrawalLifecycle } from './withdraw.js';
+export { UseManagedBalancesOptions, UseWithdrawEstimateParams, UseWithdrawFlowOptions, UseWithdrawFlowResult, UseWithdrawManagedOptions, UseWithdrawPreviewParams, UseWithdrawalLifecycleResult, WithdrawFeeEstimate, WithdrawalLifecycleState, useManagedBalances, useWithdrawEstimate, useWithdrawFlow, useWithdrawManaged, useWithdrawPreview, useWithdrawalLifecycle } from './withdraw.js';
 export { U as UseDepositAddressesOptions, g as getDepositAddress, u as useDepositAddresses } from './use-deposit-addresses-B9ICS-3U.js';
 export { U as UseSyncBalancesOptions, u as useSyncBalances } from './use-sync-balances-CeD8qZWP.js';
 
@@ -69,8 +69,14 @@ declare enum OrderStatus {
     pending_bridge = "pending_bridge",
     submitting = "submitting",
     submitted = "submitted",
+    open = "open",
+    partially_filled_open = "partially_filled_open",
+    cancel_pending = "cancel_pending",
     filled = "filled",
-    partial_fill = "partial_fill"
+    partial_fill = "partial_fill",
+    failed = "failed",
+    expired = "expired",
+    cancelled = "cancelled"
 }
 
 /**
@@ -106,11 +112,15 @@ type UnifiedBalanceResponse = {
     cash: {
         tokenSymbol: string;
         totalRaw: string;
+        availableRaw?: string | undefined;
+        reservedRaw?: string | undefined;
         decimals: number;
         chains: {
             chainId: number;
             tokenAddress: string;
             balanceRaw: string;
+            heldRaw?: string | undefined;
+            availableRaw?: string | undefined;
             decimals: number;
             lastSyncedAt: string;
         }[];
@@ -257,6 +267,10 @@ type VenueMarket = {
     endDate?: string | null | undefined;
     creationDate?: string | null | undefined;
     resolutionDate?: string | null | undefined;
+    /** Sports market classification for type-aware sorting (moneyline, spread, total, etc.). */
+    sportsMarketType?: string | null | undefined;
+    /** Sort rank within a sports section (0=moneyline, 1=spread, 2=total, 3+=other). */
+    sectionRank?: number | null | undefined;
     matchedVenueMarkets?: {
         id: string;
         venue: Venue;
@@ -299,6 +313,8 @@ type VenueEvent = {
             displayName: string | null;
             parentId: string | null;
             eventCount: number;
+            volume24hr: number;
+            volume: number;
         };
     }[];
     status?: MarketStatus | undefined;
@@ -316,10 +332,12 @@ type VenueEvent = {
     /**
      * ISO-8601 duration denormalized from Series.recurrence. `null` means
      * the event has no recurring schedule (one-off). Use this value with
-     * the `?recurrence=` filter on /venue-events; discover all available
-     * values via GET /recurrences.
+     * the `?recurrence=` filter on /venue-events using public recurrence
+     * enum values.
      */
     recurrence?: string | null | undefined;
+    /** Type-aware structure classification used to sort markets under this event. */
+    structureType?: "candidate" | "sport" | "axis" | "dates" | null | undefined;
 };
 type Orderbook = {
     bids: {
@@ -417,6 +435,8 @@ interface AggUiLabels {
         errorPrefix: string;
         tabsAria: string;
         hiddenTabsAria: string;
+        scrollTabsLeft: string;
+        scrollTabsRight: string;
         selectAria: string;
         lineChartAria: string;
         candlestickChartAria: string;
@@ -570,6 +590,7 @@ interface AggUiLabels {
             networkReserveTooltipLineTwo: string;
             youReceive: string;
             confirm: string;
+            calculatingFees: string;
             successTitle: string;
             successDescription: (tokenSymbol: string) => string;
             successTitleCompleted: string;
@@ -1025,6 +1046,9 @@ interface AggUiLabels {
         buyingOutcome: (label: string) => string;
         sellingOutcome: (label: string) => string;
         findingBestRoute: string;
+        findingBestOdds: string;
+        updatingRoute: string;
+        refreshingQuotes: string;
         checkingBalance: string;
         submittingOrderProgress: string;
         orderSubmittedProgress: (orderId: string) => string;
@@ -1305,6 +1329,11 @@ type AggUiFeatureFlagsConfigInput = Partial<AggUiFeatureFlagsConfig>;
 interface AggUiMarketConfig {
     /** Arbitrage threshold for the UI */
     arbitrageThreshold: number;
+    /**
+     * Maximum venue market IDs sent in each REST `/midpoints` request.
+     * Lower this when proxy/CDN URL limits are stricter than AGG's backend cap.
+     */
+    maxMidpointIdsPerRequest: number;
 }
 type AggUiMarketConfigInput = Partial<AggUiMarketConfig>;
 interface AggUiChartConfig {
@@ -3343,6 +3372,9 @@ declare function mergeBestPricesPreferringLive(rest: ReadonlyMap<string, {
  */
 declare function useLiveTrades(canonicalMarketId: string | null): WsTrade[];
 
+interface UseMidpointsOptions {
+    maxMidpointIdsPerRequest?: number;
+}
 interface UseMidpointsResult {
     /** Map of outcomeId → price. Empty while loading. */
     prices: Map<string, number>;
@@ -3403,7 +3435,7 @@ interface UseMidpointsResult {
  * sides because MVMO links same-side counterparts regardless of label
  * inversion. No label heuristics; no `1 - midpoint` flips.
  */
-declare function useMidpoints(venueMarkets: VenueMarket[] | null | undefined): UseMidpointsResult;
+declare function useMidpoints(venueMarkets: VenueMarket[] | null | undefined, options?: UseMidpointsOptions): UseMidpointsResult;
 
 interface UseTradableVenuesResult {
     /**
@@ -4040,12 +4072,21 @@ interface UseSmartRouteOptions {
     /** Cache freshness and polling interval in milliseconds. Defaults to SMART_ROUTE_STALE_TIME_MS. */
     staleTimeMs?: number;
 }
+/**
+ * Why the smart route query is currently loading.
+ * - `"finding-best-odds"` — first fetch, no prior data in cache
+ * - `"updating-route"`    — query key changed (e.g. amount changed), placeholder data shown
+ * - `"refreshing-quotes"` — background poll/revalidation with existing data
+ */
+type SmartRouteLoadingReason = "finding-best-odds" | "updating-route" | "refreshing-quotes";
 interface UseSmartRouteResult {
     data: SmartRouteResponse | null;
     isLoading: boolean;
     isFetching: boolean;
     error: Error | null;
     refetch: () => Promise<unknown>;
+    /** Null when not loading. See {@link SmartRouteLoadingReason}. */
+    loadingReason: SmartRouteLoadingReason | null;
 }
 /**
  * Compute optimal order routing across venues via the MILP solver.
@@ -4666,8 +4707,8 @@ interface UseVenueEventsOptions {
     sortBy?: string;
     /** Sort direction: "asc" or "desc". */
     sortDir?: string;
-    /** Recurrence filter (for venue events that support recurrence dimensions). */
-    recurrence?: string;
+    /** Recurrence filter. Uses public ISO-8601 cadence enum values, or "null" for one-off events. */
+    recurrence?: RecurrenceFilter | RecurrenceFilter[];
     /** If provided, enable the query. */
     enabled?: boolean;
     /** Page size when using cursor pagination. Default 20. */
@@ -5160,6 +5201,7 @@ declare function useVenueMarkets(options?: UseVenueMarketsOptions): {
 interface UseVenueMarketMidpointsOptions {
     venueMarketIds: string[];
     enabled?: boolean;
+    maxMidpointIdsPerRequest?: number;
 }
 declare function useVenueMarketMidpoints(options: UseVenueMarketMidpointsOptions): {
     midpointRows: (MidpointRow & {
@@ -5389,7 +5431,10 @@ declare const computePriceGaps: ({ markets, midpointsByVenueMarketId, }: Compute
  * outcome — semantically correct for both Yes and No sides because MVMO
  * links same-side counterparts regardless of label inversion.
  */
-declare function useViewportMidpoints(visibleMarkets: VenueMarket[]): {
+interface UseViewportMidpointsOptions {
+    maxMidpointIdsPerRequest?: number;
+}
+declare function useViewportMidpoints(visibleMarkets: VenueMarket[], options?: UseViewportMidpointsOptions): {
     prices: Map<string, number>;
     /**
      * Map of outcomeId → venue name that provided the price in `prices`.
@@ -5442,4 +5487,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, 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 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 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 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 UseVisibleIdsOptions, type UseVisibleIdsResult, type UserActivityInvalidationStrategy, Venue, type VenueAvailabilityState, type VenueEvent, type VenueEventWithMarkets, type VenueMarket, type VenueMarketOutcome, type WalletActionSendTokenParams, type WalletActions, computeClosedPositionTotals, computePriceGaps, defaultAggUiConfig, defaultAggUiConfig as defaultSdkUiConfig, executionKeys, 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, 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, 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 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, computeClosedPositionTotals, computePriceGaps, defaultAggUiConfig, defaultAggUiConfig as defaultSdkUiConfig, executionKeys, 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, 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 };