@agg-build/hooks 2.0.0 → 2.1.1

package/dist/index.d.ts

@@ -5,7 +5,7 @@ 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, 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';
 
@@ -313,6 +313,8 @@ type VenueEvent = {
             displayName: string | null;
             parentId: string | null;
             eventCount: number;
+            volume24hr: number;
+            volume: number;
         };
     }[];
     status?: MarketStatus | undefined;
@@ -433,6 +435,8 @@ interface AggUiLabels {
         errorPrefix: string;
         tabsAria: string;
         hiddenTabsAria: string;
+        scrollTabsLeft: string;
+        scrollTabsRight: string;
         selectAria: string;
         lineChartAria: string;
         candlestickChartAria: string;
@@ -586,6 +590,7 @@ interface AggUiLabels {
             networkReserveTooltipLineTwo: string;
             youReceive: string;
             confirm: string;
+            calculatingFees: string;
             successTitle: string;
             successDescription: (tokenSymbol: string) => string;
             successTitleCompleted: string;
@@ -671,6 +676,13 @@ interface AggUiLabels {
         categoryTabsAria: string;
     };
     userProfile: {
+        balance: {
+            availableBalance: string;
+            balanceByNetwork: string;
+            paperModeNetwork: string;
+            paperModeWarning: string;
+            networkTooltipDescription: string;
+        };
         activity: {
             depositType: string;
             redeemType: string;
@@ -1041,6 +1053,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;
@@ -1282,6 +1297,7 @@ declare const resolveAggUiLabels: (locale: string) => AggUiLabels;
 
 type ThemeMode = "light" | "dark";
 type ChartTimeRange = "1H" | "6H" | "1D" | "1W" | "1M" | "ALL";
+type AggUiTradingExecutionMode = "live" | "paper";
 interface AggUiGeneralConfig {
     /** Locale for number and date formatting */
     locale: string;
@@ -1321,6 +1337,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 {
@@ -1363,6 +1384,11 @@ interface AggUiSearchConfig {
     isShowingAllResults: boolean;
 }
 type AggUiSearchConfigInput = Partial<AggUiSearchConfig>;
+interface AggUiTradingConfig {
+    /** Default execution mode used by trading surfaces unless a component prop overrides it. */
+    executionMode: AggUiTradingExecutionMode;
+}
+type AggUiTradingConfigInput = Partial<AggUiTradingConfig>;
 interface AggUiConfig {
     /** Enable AGG development logs */
     enableLogs: boolean;
@@ -1386,6 +1412,8 @@ interface AggUiConfig {
     formatting: AggUiFormattingConfig;
     /** Search configuration */
     search: AggUiSearchConfig;
+    /** Trading configuration */
+    trading: AggUiTradingConfig;
     /**
      * Optional wallet action implementations.
      * When walletActions.sendToken is provided, DepositModal uses it for the
@@ -1419,6 +1447,8 @@ interface AggUiConfigInput {
     formatting?: AggUiFormattingConfigInput;
     /** Search config overrides */
     search?: AggUiSearchConfigInput;
+    /** Trading config overrides */
+    trading?: AggUiTradingConfigInput;
     /**
      * Optional wallet action implementations for deposit flows.
      * Provide this once at the provider level for plug-and-play deposit UX.
@@ -3359,6 +3389,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>;
@@ -3419,7 +3452,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 {
     /**
@@ -4056,12 +4089,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.
@@ -5176,6 +5218,7 @@ declare function useVenueMarkets(options?: UseVenueMarketsOptions): {
 interface UseVenueMarketMidpointsOptions {
     venueMarketIds: string[];
     enabled?: boolean;
+    maxMidpointIdsPerRequest?: number;
 }
 declare function useVenueMarketMidpoints(options: UseVenueMarketMidpointsOptions): {
     midpointRows: (MidpointRow & {
@@ -5405,7 +5448,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`.
@@ -5458,4 +5504,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, 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 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 };