@liberfi.io/react 0.1.10 → 0.1.12

package/README.md

@@ -121,11 +121,15 @@ Each subscription hook manages WebSocket lifecycle automatically (subscribe on m
 
 ### Types
 
-| Name                     | Definition                                                        | Description                     |
-| ------------------------ | ----------------------------------------------------------------- | ------------------------------- |
-| `DexClientProviderProps` | `PropsWithChildren<{ client, subscribeClient, queryKeyPrefix? }>` | Props for `DexClientProvider`.  |
-| `DexClientContextValue`  | `{ client, subscribeClient, queryKeyPrefix }`                     | Shape of the context value.     |
-| `SubscriptionOptions`    | `{ enabled?: boolean; onError?: (error: Error) => void }`         | Options for subscription hooks. |
+| Name                      | Definition                                                        | Description                               |
+| ------------------------- | ----------------------------------------------------------------- | ----------------------------------------- |
+| `DexClientProviderProps`  | `PropsWithChildren<{ client, subscribeClient, queryKeyPrefix? }>` | Props for `DexClientProvider`.            |
+| `DexClientContextValue`   | `{ client, subscribeClient, queryKeyPrefix }`                     | Shape of the context value.               |
+| `SubscriptionOptions`     | `{ enabled?: boolean; onError?: (error: Error) => void }`         | Options for subscription hooks.           |
+| `QueryHookConfig`         | `{ name, queryKey, fetch, defaultOptions? }`                      | Config for `createQueryHook`.             |
+| `QueryHookReturn`         | `{ queryKey, fetch, useQuery }`                                   | Return type of `createQueryHook`.         |
+| `InfiniteQueryHookConfig` | `{ name, queryKey, fetch }`                                       | Config for `createInfiniteQueryHook`.     |
+| `InfiniteQueryHookReturn` | `{ queryKey, useInfiniteQuery }`                                  | Return type of `createInfiniteQueryHook`. |
 
 ### Constants
 
@@ -133,6 +137,33 @@ Each subscription hook manages WebSocket lifecycle automatically (subscribe on m
 | -------------------------- | ----------- | ---------------------------------- |
 | `DEFAULT_QUERY_KEY_PREFIX` | `"liberfi"` | Default prefix for all query keys. |
 
+### Factory Functions
+
+#### `createQueryHook<TParams, TData>(config): QueryHookReturn<TParams, TData>`
+
+Creates a `useQuery`-based hook, its `queryKey` builder, and a standalone `fetch` function from a single declarative config.
+
+| Config Field     | Type                                                       | Description                                    |
+| ---------------- | ---------------------------------------------------------- | ---------------------------------------------- |
+| `name`           | `string`                                                   | Key name segment (e.g. `"token"`).             |
+| `queryKey`       | `(params: TParams) => string[]`                            | Builds the variable segments of the query key. |
+| `fetch`          | `(client: API.IClient, params: TParams) => Promise<TData>` | Fetches data using the API client.             |
+| `defaultOptions` | `Partial<Omit<UseQueryOptions, "queryKey" \| "queryFn">>`  | Default options merged below caller options.   |
+
+Returns `{ queryKey, fetch, useQuery }`.
+
+#### `createInfiniteQueryHook<TParams, TData>(config): InfiniteQueryHookReturn<TParams, TData>`
+
+Creates a `useInfiniteQuery`-based hook and its `queryKey` builder for cursor-paginated endpoints. `TData` must extend `{ hasNext?: boolean; endCursor?: string }`.
+
+| Config Field | Type                                                                                    | Description                                    |
+| ------------ | --------------------------------------------------------------------------------------- | ---------------------------------------------- |
+| `name`       | `string`                                                                                | Key name segment (e.g. `"walletPortfolios"`).  |
+| `queryKey`   | `(params: TParams) => string[]`                                                         | Builds the variable segments of the query key. |
+| `fetch`      | `(client: API.IClient, params: TParams, cursor: string \| undefined) => Promise<TData>` | Fetches a single page of data.                 |
+
+Returns `{ queryKey, useInfiniteQuery }`.
+
 ### Utility Functions
 
 | Function             | Signature                                                                     | Description                                                   |
@@ -236,6 +267,33 @@ function RefreshButton({ address }: { address: string }) {
 }
 ```
 
+### Creating a custom query hook
+
+```tsx
+import { createQueryHook } from "@liberfi.io/react";
+
+interface MyDataParams {
+  chain: string;
+  id: string;
+}
+
+interface MyData {
+  value: number;
+}
+
+const {
+  queryKey: myDataQueryKey,
+  fetch: fetchMyData,
+  useQuery: useMyDataQuery,
+} = createQueryHook<MyDataParams, MyData>({
+  name: "myData",
+  queryKey: (p) => [p.chain, p.id],
+  fetch: (client, p) => client.getMyData(p.chain, p.id),
+});
+
+export { myDataQueryKey, fetchMyData, useMyDataQuery };
+```
+
 ### Infinite scrolling
 
 ```tsx
@@ -269,9 +327,49 @@ function PortfolioList({ walletAddress }: { walletAddress: string }) {
 }
 ```
 
+## Testing
+
+### Unit Tests
+
+Unit tests mock the API client and verify hook behavior (query keys, fetch delegation, subscription lifecycle).
+
+```bash
+pnpm test
+```
+
+### Integration Tests
+
+Integration tests use the real `@liberfi.io/client` to verify end-to-end API communication.
+
+**Setup:**
+
+```bash
+cp .env.test.example .env.test   # review and adjust URLs if needed
+```
+
+Required environment variables (in `.env.test`):
+
+| Variable                 | Description                                       |
+| ------------------------ | ------------------------------------------------- |
+| `CHAINSTREAM_BASE_URL`   | REST API server URL                               |
+| `API_BASE_URL`           | Auth API base URL (for fetching the access token) |
+| `CHAINSTREAM_STREAM_URL` | _(optional)_ WebSocket URL, defaults to SDK value |
+
+**Run:**
+
+```bash
+pnpm test:integration
+```
+
+When the environment variables are not set, integration tests are automatically skipped.
+
+**Architecture:**
+
+- `src/__integration__/fetch.integration.test.ts` — Tests standalone `fetch*` functions against the real API in a Node environment. Validates API response shapes and end-to-end data flow.
+- `src/__integration__/hooks.integration.test.tsx` — Tests hooks via `renderHook` with a real client, verifying provider injection and full end-to-end data fetching through React Query. Uses a custom jsdom environment (`jsdom-with-fetch.js`) that injects Node's native `fetch` and removes `XMLHttpRequest` to bypass CORS.
+
 ## Future Improvements
 
-- Export `createQueryHook` and `createInfiniteQueryHook` factories so consumers can create custom hooks.
 - Add a standalone `fetch` function to infinite query hooks for API consistency.
 - Add a mutation key to `useSendTxMutation` for cache introspection.
 - Consolidate `version.ts` global side effect into a shared utility.

package/dist/index.d.mts

@@ -3,7 +3,7 @@ import { PropsWithChildren } from 'react';
 import * as _liberfi_io_types from '@liberfi.io/types';
 import { API, Chain, Token, TokenResolution, TokenCandle, TokenHolder, TokenMarketData, TokenSecurity, TokenStats, Trade, WalletPnl, WalletPortfolioPnls, WalletPortfolios, Portfolio, PortfolioPnl, Activity } from '@liberfi.io/types';
 import * as _tanstack_react_query from '@tanstack/react-query';
-import { UseQueryOptions, UseMutationOptions } from '@tanstack/react-query';
+import { UseQueryOptions, UseQueryResult, UseInfiniteQueryOptions, InfiniteData, UseInfiniteQueryResult, UseMutationOptions } from '@tanstack/react-query';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 
 declare global {
@@ -45,6 +45,65 @@ declare const DexClientContext: react.Context<DexClientContextValue | null>;
  */
 declare function useDexClient(): DexClientContextValue;
 
+interface QueryHookConfig<TParams, TData> {
+    /** Key name segment (e.g. `"token"`, `"newTokens"`). */
+    name: string;
+    /** Builds the variable segments of the query key from `params`. */
+    queryKey: (params: TParams) => string[];
+    /** Fetches data using the API client. */
+    fetch: (client: API.IClient, params: TParams) => Promise<TData>;
+    /** Default options merged *below* caller-supplied options. */
+    defaultOptions?: Partial<Omit<UseQueryOptions<TData, Error, TData, string[]>, "queryKey" | "queryFn">>;
+}
+interface QueryHookReturn<TParams, TData> {
+    /**
+     * Builds the full query key including the namespace prefix.
+     *
+     * Useful for manual cache operations such as `queryClient.invalidateQueries`
+     * or `queryClient.prefetchQuery`.
+     *
+     * @param params - Hook parameters.
+     * @param prefix - Override the default prefix (`DEFAULT_QUERY_KEY_PREFIX`).
+     */
+    queryKey: (params: TParams, prefix?: string) => string[];
+    /** Fetches data using the API client (for use outside React). */
+    fetch: (client: API.IClient, params: TParams) => Promise<TData>;
+    /** React hook that fetches and caches data via TanStack Query. */
+    useQuery: (params: TParams, options?: Omit<UseQueryOptions<TData, Error, TData, string[]>, "queryKey" | "queryFn">) => UseQueryResult<TData, Error>;
+}
+/**
+ * Creates a `useQuery`-based hook, its `queryKey` builder and a standalone
+ * `fetch` function from a single declarative config object.
+ */
+declare function createQueryHook<TParams, TData>(config: QueryHookConfig<TParams, TData>): QueryHookReturn<TParams, TData>;
+
+interface CursorPaginatedResult {
+    hasNext?: boolean;
+    endCursor?: string;
+}
+interface InfiniteQueryHookConfig<TParams, TData extends CursorPaginatedResult> {
+    /** Key name segment (e.g. `"walletPortfolios"`). */
+    name: string;
+    /** Builds the variable segments of the query key from `params`. */
+    queryKey: (params: TParams) => string[];
+    /** Fetches a single page of data. */
+    fetch: (client: API.IClient, params: TParams, cursor: string | undefined) => Promise<TData>;
+}
+interface InfiniteQueryHookReturn<TParams, TData extends CursorPaginatedResult> {
+    /**
+     * Builds the full query key including the namespace prefix and an
+     * `"infinite"` tag to distinguish it from the non-infinite variant.
+     */
+    queryKey: (params: TParams, prefix?: string) => string[];
+    /** React hook that fetches cursor-paginated data via TanStack Query. */
+    useInfiniteQuery: (params: TParams, options?: Omit<UseInfiniteQueryOptions<TData, Error, InfiniteData<TData>, string[], string | undefined>, "queryKey" | "queryFn" | "initialPageParam" | "getNextPageParam">) => UseInfiniteQueryResult<InfiniteData<TData>, Error>;
+}
+/**
+ * Creates a `useInfiniteQuery`-based hook and its `queryKey` builder for
+ * cursor-paginated endpoints.
+ */
+declare function createInfiniteQueryHook<TParams, TData extends CursorPaginatedResult>(config: InfiniteQueryHookConfig<TParams, TData>): InfiniteQueryHookReturn<TParams, TData>;
+
 interface SubscriptionOptions {
     /** Set to `false` to pause the subscription. Defaults to `true`. */
     enabled?: boolean;
@@ -439,4 +498,4 @@ type DexClientProviderProps = PropsWithChildren<{
  */
 declare function DexClientProvider({ client, subscribeClient, queryKeyPrefix, children, }: DexClientProviderProps): react_jsx_runtime.JSX.Element;
 
-export { DEFAULT_QUERY_KEY_PREFIX, DexClientContext, type DexClientContextValue, DexClientProvider, type DexClientProviderProps, type SubscriptionOptions, type UseFinalStretchTokensQueryParams, type UseFinalStretchTokensSubscriptionParams, type UseMigratedTokensQueryParams, type UseMigratedTokensSubscriptionParams, type UseNewTokensQueryParams, type UseNewTokensSubscriptionParams, type UseSearchTokensQueryParams, type UseSendTxMutationParams, type UseStockTokensQueryParams, type UseStockTokensSubscriptionParams, type UseSwapRouteQueryParams, type UseTokenActivitiesQueryParams, type UseTokenActivitiesSubscriptionParams, type UseTokenCandlesQueryParams, type UseTokenCandlesSubscriptionParams, type UseTokenHoldersQueryParams, type UseTokenMarketDataQueryParams, type UseTokenQueryParams, type UseTokenSecurityQueryParams, type UseTokenStatsQueryParams, type UseTokenSubscriptionParams, type UseTokenTradesQueryParams, type UseTokenTradesSubscriptionParams, type UseTokensQueryParams, type UseTrendingTokensQueryParams, type UseTrendingTokensSubscriptionParams, type UseTxSuccessQueryParams, type UseWalletActivitiesQueryParams, type UseWalletActivitiesSubscriptionParams, type UseWalletPnlQueryParams, type UseWalletPnlSubscriptionParams, type UseWalletPortfolioPnlsByTokensQueryParams, type UseWalletPortfolioPnlsInfiniteQueryParams, type UseWalletPortfolioPnlsQueryParams, type UseWalletPortfolioPnlsSubscriptionParams, type UseWalletPortfoliosByTokensQueryParams, type UseWalletPortfoliosInfiniteQueryParams, type UseWalletPortfoliosQueryParams, type UseWalletPortfoliosSubscriptionParams, type UseWalletTradesQueryParams, type UseWalletTradesSubscriptionParams, fetchFinalStretchTokens, fetchMigratedTokens, fetchNewTokens, fetchPresignedUploadUrl, fetchSearchTokens, fetchStockTokens, fetchSwapRoute, fetchToken, fetchTokenActivities, fetchTokenCandles, fetchTokenHolders, fetchTokenMarketData, fetchTokenSecurity, fetchTokenStats, fetchTokenTrades, fetchTokens, fetchTrendingTokens, fetchTxSuccess, fetchWalletActivities, fetchWalletPnl, fetchWalletPortfolioPnls, fetchWalletPortfolioPnlsByTokens, fetchWalletPortfolios, fetchWalletPortfoliosByTokens, fetchWalletTrades, finalStretchTokensQueryKey, migratedTokensQueryKey, newTokensQueryKey, presignedUploadUrlQueryKey, searchTokensQueryKey, sendTx, stockTokensQueryKey, swapRouteQueryKey, toKeySegment, toSortedKeySegment, tokenActivitiesQueryKey, tokenCandlesQueryKey, tokenHoldersQueryKey, tokenMarketDataQueryKey, tokenQueryKey, tokenSecurityQueryKey, tokenStatsQueryKey, tokenTradesQueryKey, tokensQueryKey, trendingTokensQueryKey, txSuccessQueryKey, useDexClient, useFinalStretchTokensQuery, useFinalStretchTokensSubscription, useMigratedTokensQuery, useMigratedTokensSubscription, useNewTokensQuery, useNewTokensSubscription, usePresignedUploadUrlQuery, useSearchTokensQuery, useSendTxMutation, useStockTokensQuery, useStockTokensSubscription, useSwapRouteQuery, useTokenActivitiesQuery, useTokenActivitiesSubscription, useTokenCandlesQuery, useTokenCandlesSubscription, useTokenHoldersQuery, useTokenMarketDataQuery, useTokenQuery, useTokenSecurityQuery, useTokenStatsQuery, useTokenSubscription, useTokenTradesQuery, useTokenTradesSubscription, useTokensQuery, useTrendingTokensQuery, useTrendingTokensSubscription, useTxSuccessQuery, useWalletActivitiesQuery, useWalletActivitiesSubscription, useWalletPnlQuery, useWalletPnlSubscription, useWalletPortfolioPnlsByTokensQuery, useWalletPortfolioPnlsInfiniteQuery, useWalletPortfolioPnlsQuery, useWalletPortfolioPnlsSubscription, useWalletPortfoliosByTokensQuery, useWalletPortfoliosInfiniteQuery, useWalletPortfoliosQuery, useWalletPortfoliosSubscription, useWalletTradesQuery, useWalletTradesSubscription, walletActivitiesQueryKey, walletPnlQueryKey, walletPortfolioPnlsByTokensQueryKey, walletPortfolioPnlsInfiniteQueryKey, walletPortfolioPnlsQueryKey, walletPortfoliosByTokensQueryKey, walletPortfoliosInfiniteQueryKey, walletPortfoliosQueryKey, walletTradesQueryKey };
+export { DEFAULT_QUERY_KEY_PREFIX, DexClientContext, type DexClientContextValue, DexClientProvider, type DexClientProviderProps, type InfiniteQueryHookConfig, type InfiniteQueryHookReturn, type QueryHookConfig, type QueryHookReturn, type SubscriptionOptions, type UseFinalStretchTokensQueryParams, type UseFinalStretchTokensSubscriptionParams, type UseMigratedTokensQueryParams, type UseMigratedTokensSubscriptionParams, type UseNewTokensQueryParams, type UseNewTokensSubscriptionParams, type UseSearchTokensQueryParams, type UseSendTxMutationParams, type UseStockTokensQueryParams, type UseStockTokensSubscriptionParams, type UseSwapRouteQueryParams, type UseTokenActivitiesQueryParams, type UseTokenActivitiesSubscriptionParams, type UseTokenCandlesQueryParams, type UseTokenCandlesSubscriptionParams, type UseTokenHoldersQueryParams, type UseTokenMarketDataQueryParams, type UseTokenQueryParams, type UseTokenSecurityQueryParams, type UseTokenStatsQueryParams, type UseTokenSubscriptionParams, type UseTokenTradesQueryParams, type UseTokenTradesSubscriptionParams, type UseTokensQueryParams, type UseTrendingTokensQueryParams, type UseTrendingTokensSubscriptionParams, type UseTxSuccessQueryParams, type UseWalletActivitiesQueryParams, type UseWalletActivitiesSubscriptionParams, type UseWalletPnlQueryParams, type UseWalletPnlSubscriptionParams, type UseWalletPortfolioPnlsByTokensQueryParams, type UseWalletPortfolioPnlsInfiniteQueryParams, type UseWalletPortfolioPnlsQueryParams, type UseWalletPortfolioPnlsSubscriptionParams, type UseWalletPortfoliosByTokensQueryParams, type UseWalletPortfoliosInfiniteQueryParams, type UseWalletPortfoliosQueryParams, type UseWalletPortfoliosSubscriptionParams, type UseWalletTradesQueryParams, type UseWalletTradesSubscriptionParams, createInfiniteQueryHook, createQueryHook, fetchFinalStretchTokens, fetchMigratedTokens, fetchNewTokens, fetchPresignedUploadUrl, fetchSearchTokens, fetchStockTokens, fetchSwapRoute, fetchToken, fetchTokenActivities, fetchTokenCandles, fetchTokenHolders, fetchTokenMarketData, fetchTokenSecurity, fetchTokenStats, fetchTokenTrades, fetchTokens, fetchTrendingTokens, fetchTxSuccess, fetchWalletActivities, fetchWalletPnl, fetchWalletPortfolioPnls, fetchWalletPortfolioPnlsByTokens, fetchWalletPortfolios, fetchWalletPortfoliosByTokens, fetchWalletTrades, finalStretchTokensQueryKey, migratedTokensQueryKey, newTokensQueryKey, presignedUploadUrlQueryKey, searchTokensQueryKey, sendTx, stockTokensQueryKey, swapRouteQueryKey, toKeySegment, toSortedKeySegment, tokenActivitiesQueryKey, tokenCandlesQueryKey, tokenHoldersQueryKey, tokenMarketDataQueryKey, tokenQueryKey, tokenSecurityQueryKey, tokenStatsQueryKey, tokenTradesQueryKey, tokensQueryKey, trendingTokensQueryKey, txSuccessQueryKey, useDexClient, useFinalStretchTokensQuery, useFinalStretchTokensSubscription, useMigratedTokensQuery, useMigratedTokensSubscription, useNewTokensQuery, useNewTokensSubscription, usePresignedUploadUrlQuery, useSearchTokensQuery, useSendTxMutation, useStockTokensQuery, useStockTokensSubscription, useSwapRouteQuery, useTokenActivitiesQuery, useTokenActivitiesSubscription, useTokenCandlesQuery, useTokenCandlesSubscription, useTokenHoldersQuery, useTokenMarketDataQuery, useTokenQuery, useTokenSecurityQuery, useTokenStatsQuery, useTokenSubscription, useTokenTradesQuery, useTokenTradesSubscription, useTokensQuery, useTrendingTokensQuery, useTrendingTokensSubscription, useTxSuccessQuery, useWalletActivitiesQuery, useWalletActivitiesSubscription, useWalletPnlQuery, useWalletPnlSubscription, useWalletPortfolioPnlsByTokensQuery, useWalletPortfolioPnlsInfiniteQuery, useWalletPortfolioPnlsQuery, useWalletPortfolioPnlsSubscription, useWalletPortfoliosByTokensQuery, useWalletPortfoliosInfiniteQuery, useWalletPortfoliosQuery, useWalletPortfoliosSubscription, useWalletTradesQuery, useWalletTradesSubscription, walletActivitiesQueryKey, walletPnlQueryKey, walletPortfolioPnlsByTokensQueryKey, walletPortfolioPnlsInfiniteQueryKey, walletPortfolioPnlsQueryKey, walletPortfoliosByTokensQueryKey, walletPortfoliosInfiniteQueryKey, walletPortfoliosQueryKey, walletTradesQueryKey };

package/dist/index.d.ts

@@ -3,7 +3,7 @@ import { PropsWithChildren } from 'react';
 import * as _liberfi_io_types from '@liberfi.io/types';
 import { API, Chain, Token, TokenResolution, TokenCandle, TokenHolder, TokenMarketData, TokenSecurity, TokenStats, Trade, WalletPnl, WalletPortfolioPnls, WalletPortfolios, Portfolio, PortfolioPnl, Activity } from '@liberfi.io/types';
 import * as _tanstack_react_query from '@tanstack/react-query';
-import { UseQueryOptions, UseMutationOptions } from '@tanstack/react-query';
+import { UseQueryOptions, UseQueryResult, UseInfiniteQueryOptions, InfiniteData, UseInfiniteQueryResult, UseMutationOptions } from '@tanstack/react-query';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 
 declare global {
@@ -45,6 +45,65 @@ declare const DexClientContext: react.Context<DexClientContextValue | null>;
  */
 declare function useDexClient(): DexClientContextValue;
 
+interface QueryHookConfig<TParams, TData> {
+    /** Key name segment (e.g. `"token"`, `"newTokens"`). */
+    name: string;
+    /** Builds the variable segments of the query key from `params`. */
+    queryKey: (params: TParams) => string[];
+    /** Fetches data using the API client. */
+    fetch: (client: API.IClient, params: TParams) => Promise<TData>;
+    /** Default options merged *below* caller-supplied options. */
+    defaultOptions?: Partial<Omit<UseQueryOptions<TData, Error, TData, string[]>, "queryKey" | "queryFn">>;
+}
+interface QueryHookReturn<TParams, TData> {
+    /**
+     * Builds the full query key including the namespace prefix.
+     *
+     * Useful for manual cache operations such as `queryClient.invalidateQueries`
+     * or `queryClient.prefetchQuery`.
+     *
+     * @param params - Hook parameters.
+     * @param prefix - Override the default prefix (`DEFAULT_QUERY_KEY_PREFIX`).
+     */
+    queryKey: (params: TParams, prefix?: string) => string[];
+    /** Fetches data using the API client (for use outside React). */
+    fetch: (client: API.IClient, params: TParams) => Promise<TData>;
+    /** React hook that fetches and caches data via TanStack Query. */
+    useQuery: (params: TParams, options?: Omit<UseQueryOptions<TData, Error, TData, string[]>, "queryKey" | "queryFn">) => UseQueryResult<TData, Error>;
+}
+/**
+ * Creates a `useQuery`-based hook, its `queryKey` builder and a standalone
+ * `fetch` function from a single declarative config object.
+ */
+declare function createQueryHook<TParams, TData>(config: QueryHookConfig<TParams, TData>): QueryHookReturn<TParams, TData>;
+
+interface CursorPaginatedResult {
+    hasNext?: boolean;
+    endCursor?: string;
+}
+interface InfiniteQueryHookConfig<TParams, TData extends CursorPaginatedResult> {
+    /** Key name segment (e.g. `"walletPortfolios"`). */
+    name: string;
+    /** Builds the variable segments of the query key from `params`. */
+    queryKey: (params: TParams) => string[];
+    /** Fetches a single page of data. */
+    fetch: (client: API.IClient, params: TParams, cursor: string | undefined) => Promise<TData>;
+}
+interface InfiniteQueryHookReturn<TParams, TData extends CursorPaginatedResult> {
+    /**
+     * Builds the full query key including the namespace prefix and an
+     * `"infinite"` tag to distinguish it from the non-infinite variant.
+     */
+    queryKey: (params: TParams, prefix?: string) => string[];
+    /** React hook that fetches cursor-paginated data via TanStack Query. */
+    useInfiniteQuery: (params: TParams, options?: Omit<UseInfiniteQueryOptions<TData, Error, InfiniteData<TData>, string[], string | undefined>, "queryKey" | "queryFn" | "initialPageParam" | "getNextPageParam">) => UseInfiniteQueryResult<InfiniteData<TData>, Error>;
+}
+/**
+ * Creates a `useInfiniteQuery`-based hook and its `queryKey` builder for
+ * cursor-paginated endpoints.
+ */
+declare function createInfiniteQueryHook<TParams, TData extends CursorPaginatedResult>(config: InfiniteQueryHookConfig<TParams, TData>): InfiniteQueryHookReturn<TParams, TData>;
+
 interface SubscriptionOptions {
     /** Set to `false` to pause the subscription. Defaults to `true`. */
     enabled?: boolean;
@@ -439,4 +498,4 @@ type DexClientProviderProps = PropsWithChildren<{
  */
 declare function DexClientProvider({ client, subscribeClient, queryKeyPrefix, children, }: DexClientProviderProps): react_jsx_runtime.JSX.Element;
 
-export { DEFAULT_QUERY_KEY_PREFIX, DexClientContext, type DexClientContextValue, DexClientProvider, type DexClientProviderProps, type SubscriptionOptions, type UseFinalStretchTokensQueryParams, type UseFinalStretchTokensSubscriptionParams, type UseMigratedTokensQueryParams, type UseMigratedTokensSubscriptionParams, type UseNewTokensQueryParams, type UseNewTokensSubscriptionParams, type UseSearchTokensQueryParams, type UseSendTxMutationParams, type UseStockTokensQueryParams, type UseStockTokensSubscriptionParams, type UseSwapRouteQueryParams, type UseTokenActivitiesQueryParams, type UseTokenActivitiesSubscriptionParams, type UseTokenCandlesQueryParams, type UseTokenCandlesSubscriptionParams, type UseTokenHoldersQueryParams, type UseTokenMarketDataQueryParams, type UseTokenQueryParams, type UseTokenSecurityQueryParams, type UseTokenStatsQueryParams, type UseTokenSubscriptionParams, type UseTokenTradesQueryParams, type UseTokenTradesSubscriptionParams, type UseTokensQueryParams, type UseTrendingTokensQueryParams, type UseTrendingTokensSubscriptionParams, type UseTxSuccessQueryParams, type UseWalletActivitiesQueryParams, type UseWalletActivitiesSubscriptionParams, type UseWalletPnlQueryParams, type UseWalletPnlSubscriptionParams, type UseWalletPortfolioPnlsByTokensQueryParams, type UseWalletPortfolioPnlsInfiniteQueryParams, type UseWalletPortfolioPnlsQueryParams, type UseWalletPortfolioPnlsSubscriptionParams, type UseWalletPortfoliosByTokensQueryParams, type UseWalletPortfoliosInfiniteQueryParams, type UseWalletPortfoliosQueryParams, type UseWalletPortfoliosSubscriptionParams, type UseWalletTradesQueryParams, type UseWalletTradesSubscriptionParams, fetchFinalStretchTokens, fetchMigratedTokens, fetchNewTokens, fetchPresignedUploadUrl, fetchSearchTokens, fetchStockTokens, fetchSwapRoute, fetchToken, fetchTokenActivities, fetchTokenCandles, fetchTokenHolders, fetchTokenMarketData, fetchTokenSecurity, fetchTokenStats, fetchTokenTrades, fetchTokens, fetchTrendingTokens, fetchTxSuccess, fetchWalletActivities, fetchWalletPnl, fetchWalletPortfolioPnls, fetchWalletPortfolioPnlsByTokens, fetchWalletPortfolios, fetchWalletPortfoliosByTokens, fetchWalletTrades, finalStretchTokensQueryKey, migratedTokensQueryKey, newTokensQueryKey, presignedUploadUrlQueryKey, searchTokensQueryKey, sendTx, stockTokensQueryKey, swapRouteQueryKey, toKeySegment, toSortedKeySegment, tokenActivitiesQueryKey, tokenCandlesQueryKey, tokenHoldersQueryKey, tokenMarketDataQueryKey, tokenQueryKey, tokenSecurityQueryKey, tokenStatsQueryKey, tokenTradesQueryKey, tokensQueryKey, trendingTokensQueryKey, txSuccessQueryKey, useDexClient, useFinalStretchTokensQuery, useFinalStretchTokensSubscription, useMigratedTokensQuery, useMigratedTokensSubscription, useNewTokensQuery, useNewTokensSubscription, usePresignedUploadUrlQuery, useSearchTokensQuery, useSendTxMutation, useStockTokensQuery, useStockTokensSubscription, useSwapRouteQuery, useTokenActivitiesQuery, useTokenActivitiesSubscription, useTokenCandlesQuery, useTokenCandlesSubscription, useTokenHoldersQuery, useTokenMarketDataQuery, useTokenQuery, useTokenSecurityQuery, useTokenStatsQuery, useTokenSubscription, useTokenTradesQuery, useTokenTradesSubscription, useTokensQuery, useTrendingTokensQuery, useTrendingTokensSubscription, useTxSuccessQuery, useWalletActivitiesQuery, useWalletActivitiesSubscription, useWalletPnlQuery, useWalletPnlSubscription, useWalletPortfolioPnlsByTokensQuery, useWalletPortfolioPnlsInfiniteQuery, useWalletPortfolioPnlsQuery, useWalletPortfolioPnlsSubscription, useWalletPortfoliosByTokensQuery, useWalletPortfoliosInfiniteQuery, useWalletPortfoliosQuery, useWalletPortfoliosSubscription, useWalletTradesQuery, useWalletTradesSubscription, walletActivitiesQueryKey, walletPnlQueryKey, walletPortfolioPnlsByTokensQueryKey, walletPortfolioPnlsInfiniteQueryKey, walletPortfolioPnlsQueryKey, walletPortfoliosByTokensQueryKey, walletPortfoliosInfiniteQueryKey, walletPortfoliosQueryKey, walletTradesQueryKey };
+export { DEFAULT_QUERY_KEY_PREFIX, DexClientContext, type DexClientContextValue, DexClientProvider, type DexClientProviderProps, type InfiniteQueryHookConfig, type InfiniteQueryHookReturn, type QueryHookConfig, type QueryHookReturn, type SubscriptionOptions, type UseFinalStretchTokensQueryParams, type UseFinalStretchTokensSubscriptionParams, type UseMigratedTokensQueryParams, type UseMigratedTokensSubscriptionParams, type UseNewTokensQueryParams, type UseNewTokensSubscriptionParams, type UseSearchTokensQueryParams, type UseSendTxMutationParams, type UseStockTokensQueryParams, type UseStockTokensSubscriptionParams, type UseSwapRouteQueryParams, type UseTokenActivitiesQueryParams, type UseTokenActivitiesSubscriptionParams, type UseTokenCandlesQueryParams, type UseTokenCandlesSubscriptionParams, type UseTokenHoldersQueryParams, type UseTokenMarketDataQueryParams, type UseTokenQueryParams, type UseTokenSecurityQueryParams, type UseTokenStatsQueryParams, type UseTokenSubscriptionParams, type UseTokenTradesQueryParams, type UseTokenTradesSubscriptionParams, type UseTokensQueryParams, type UseTrendingTokensQueryParams, type UseTrendingTokensSubscriptionParams, type UseTxSuccessQueryParams, type UseWalletActivitiesQueryParams, type UseWalletActivitiesSubscriptionParams, type UseWalletPnlQueryParams, type UseWalletPnlSubscriptionParams, type UseWalletPortfolioPnlsByTokensQueryParams, type UseWalletPortfolioPnlsInfiniteQueryParams, type UseWalletPortfolioPnlsQueryParams, type UseWalletPortfolioPnlsSubscriptionParams, type UseWalletPortfoliosByTokensQueryParams, type UseWalletPortfoliosInfiniteQueryParams, type UseWalletPortfoliosQueryParams, type UseWalletPortfoliosSubscriptionParams, type UseWalletTradesQueryParams, type UseWalletTradesSubscriptionParams, createInfiniteQueryHook, createQueryHook, fetchFinalStretchTokens, fetchMigratedTokens, fetchNewTokens, fetchPresignedUploadUrl, fetchSearchTokens, fetchStockTokens, fetchSwapRoute, fetchToken, fetchTokenActivities, fetchTokenCandles, fetchTokenHolders, fetchTokenMarketData, fetchTokenSecurity, fetchTokenStats, fetchTokenTrades, fetchTokens, fetchTrendingTokens, fetchTxSuccess, fetchWalletActivities, fetchWalletPnl, fetchWalletPortfolioPnls, fetchWalletPortfolioPnlsByTokens, fetchWalletPortfolios, fetchWalletPortfoliosByTokens, fetchWalletTrades, finalStretchTokensQueryKey, migratedTokensQueryKey, newTokensQueryKey, presignedUploadUrlQueryKey, searchTokensQueryKey, sendTx, stockTokensQueryKey, swapRouteQueryKey, toKeySegment, toSortedKeySegment, tokenActivitiesQueryKey, tokenCandlesQueryKey, tokenHoldersQueryKey, tokenMarketDataQueryKey, tokenQueryKey, tokenSecurityQueryKey, tokenStatsQueryKey, tokenTradesQueryKey, tokensQueryKey, trendingTokensQueryKey, txSuccessQueryKey, useDexClient, useFinalStretchTokensQuery, useFinalStretchTokensSubscription, useMigratedTokensQuery, useMigratedTokensSubscription, useNewTokensQuery, useNewTokensSubscription, usePresignedUploadUrlQuery, useSearchTokensQuery, useSendTxMutation, useStockTokensQuery, useStockTokensSubscription, useSwapRouteQuery, useTokenActivitiesQuery, useTokenActivitiesSubscription, useTokenCandlesQuery, useTokenCandlesSubscription, useTokenHoldersQuery, useTokenMarketDataQuery, useTokenQuery, useTokenSecurityQuery, useTokenStatsQuery, useTokenSubscription, useTokenTradesQuery, useTokenTradesSubscription, useTokensQuery, useTrendingTokensQuery, useTrendingTokensSubscription, useTxSuccessQuery, useWalletActivitiesQuery, useWalletActivitiesSubscription, useWalletPnlQuery, useWalletPnlSubscription, useWalletPortfolioPnlsByTokensQuery, useWalletPortfolioPnlsInfiniteQuery, useWalletPortfolioPnlsQuery, useWalletPortfolioPnlsSubscription, useWalletPortfoliosByTokensQuery, useWalletPortfoliosInfiniteQuery, useWalletPortfoliosQuery, useWalletPortfoliosSubscription, useWalletTradesQuery, useWalletTradesSubscription, walletActivitiesQueryKey, walletPnlQueryKey, walletPortfolioPnlsByTokensQueryKey, walletPortfolioPnlsInfiniteQueryKey, walletPortfolioPnlsQueryKey, walletPortfoliosByTokensQueryKey, walletPortfoliosInfiniteQueryKey, walletPortfoliosQueryKey, walletTradesQueryKey };

package/dist/index.js

@@ -1,2 +1,2 @@
-'use strict';var react=require('react'),reactQuery=require('@tanstack/react-query'),jsxRuntime=require('react/jsx-runtime');typeof window<"u"&&(window.__LIBERFI_VERSION__=window.__LIBERFI_VERSION__||{},window.__LIBERFI_VERSION__["@liberfi.io/react"]="0.1.10");var y="liberfi",d=react.createContext(null);function a(){let e=react.useContext(d);if(e===null)throw new Error("useDexClient must be used within a DexClientProvider");return e}function i(e){return e==null?"":e instanceof Date?e.toISOString():String(e)}function c(e){return !e||e.length===0?"[]":JSON.stringify([...e].sort())}function s(e){function r(n,l=y){return [l,e.name,...e.queryKey(n)]}function t(n,l){return e.fetch(n,l)}function o(n,l={}){let{client:m,queryKeyPrefix:f}=a();return reactQuery.useQuery({queryKey:r(n,f),queryFn:()=>e.fetch(m,n),...e.defaultOptions,...l})}return {queryKey:r,fetch:t,useQuery:o}}var {queryKey:L,fetch:N,useQuery:G}=s({name:"finalStretchTokens",queryKey:e=>[e.chain,i(e.sortBy),i(e.sortDirection),c(e.keywords),c(e.excludeKeywords),c(e.filters)],fetch:(e,{chain:r,...t})=>e.getFinalStretchTokens(r,t)});var {queryKey:J,fetch:j,useQuery:z}=s({name:"migratedTokens",queryKey:e=>[e.chain,i(e.sortBy),i(e.sortDirection),c(e.keywords),c(e.excludeKeywords),c(e.filters)],fetch:(e,{chain:r,...t})=>e.getMigratedTokens(r,t)});var {queryKey:re,fetch:te,useQuery:oe}=s({name:"newTokens",queryKey:e=>[e.chain,i(e.sortBy),i(e.sortDirection),c(e.keywords),c(e.excludeKeywords),c(e.filters)],fetch:(e,{chain:r,...t})=>e.getNewTokens(r,t)});function b(e=y){return [e,"presignedUploadUrl"]}async function S(e){return await e.getPresignedUploadUrl()}function ce(e={}){let{client:r,queryKeyPrefix:t}=a();return reactQuery.useQuery({queryKey:b(t),queryFn:async()=>S(r),staleTime:0,...e})}var {queryKey:me,fetch:de,useQuery:pe}=s({name:"searchTokens",queryKey:e=>[i(e.cursor),i(e.limit),i(e.direction),c(e.chains),i(e.keyword),c(e.filters),i(e.sortBy),i(e.sortDirection)],fetch:(e,r)=>e.searchTokens(r)});async function C(e,r){return await e.sendTx(r)}function xe(e={}){let{client:r}=a();return reactQuery.useMutation({mutationFn:async t=>C(r,t),...e})}var {queryKey:Ce,fetch:ge,useQuery:Ae}=s({name:"stockTokens",queryKey:e=>[e.chain,i(e.sortBy),i(e.sortDirection),c(e.keywords),c(e.excludeKeywords),c(e.filters)],fetch:(e,{chain:r,...t})=>e.getStockTokens(r,t)});var {queryKey:De,fetch:qe,useQuery:We}=s({name:"swapRoute",queryKey:e=>[e.chain,e.userAddress,e.input,e.output,e.mode,e.amount,i(e.slippage),i(e.priorityFee),i(e.tipFee),i(e.isAntiMev)],fetch:(e,r)=>e.swapRoute(r)});var {queryKey:ve,fetch:He,useQuery:Re}=s({name:"tokenCandles",queryKey:e=>[e.chain,e.address,e.resolution,i(e.after),i(e.before),i(e.limit)],fetch:(e,{chain:r,address:t,resolution:o,...n})=>e.getTokenCandles(r,t,o,n)});var {queryKey:Me,fetch:Le,useQuery:Ne}=s({name:"tokenHolders",queryKey:e=>[e.chain,e.address,i(e.cursor),i(e.limit),i(e.direction)],fetch:(e,{chain:r,address:t,...o})=>e.getTokenHolders(r,t,o)});var {queryKey:Ye,fetch:Xe,useQuery:Je}=s({name:"tokenMarketData",queryKey:e=>[e.chain,e.address],fetch:(e,r)=>e.getTokenMarketData(r.chain,r.address)});var {queryKey:Ze,fetch:$e,useQuery:er}=s({name:"token",queryKey:e=>[e.chain,e.address],fetch:(e,r)=>e.getToken(r.chain,r.address)});var {queryKey:or,fetch:ir,useQuery:nr}=s({name:"tokenSecurity",queryKey:e=>[e.chain,e.address],fetch:(e,r)=>e.getTokenSecurity(r.chain,r.address)});var {queryKey:ur,fetch:cr,useQuery:fr}=s({name:"tokens",queryKey:e=>[e.chain,[...e.addresses].sort().join(",")],fetch:(e,r)=>e.getTokens(r.chain,r.addresses)});var {queryKey:mr,fetch:dr,useQuery:pr}=s({name:"tokenStats",queryKey:e=>[e.chain,e.address],fetch:(e,r)=>e.getTokenStats(r.chain,r.address)});var {queryKey:kr,fetch:xr,useQuery:br}=s({name:"tokenTrades",queryKey:e=>[e.chain,e.address,i(e.before),i(e.after),i(e.beforeBlockHeight),i(e.afterBlockHeight),i(e.type),i(e.poolAddress)],fetch:(e,{chain:r,address:t,...o})=>e.getTokenTrades(r,t,o)});var {queryKey:gr,fetch:Ar,useQuery:Kr}=s({name:"trendingTokens",queryKey:e=>[e.chain,e.resolution,i(e.sortBy),i(e.sortDirection),c(e.keywords),c(e.excludeKeywords),c(e.filters)],fetch:(e,{chain:r,resolution:t,...o})=>e.getTrendingTokens(r,t,o)});var {queryKey:qr,fetch:Wr,useQuery:Or}=s({name:"txSuccess",queryKey:e=>[e.chain,e.txHash,i(e.timeout)],fetch:(e,{chain:r,txHash:t,timeout:o})=>e.checkTxSuccess(r,t,o)});var {queryKey:Hr,fetch:Rr,useQuery:Fr}=s({name:"walletPnl",queryKey:e=>[e.chain,e.address,i(e.resolution??"all")],fetch:(e,{chain:r,address:t,resolution:o})=>e.getWalletPnl(r,t,o)});var {queryKey:Lr,fetch:Nr,useQuery:Gr}=s({name:"walletPortfolioPnls",queryKey:e=>[e.chain,e.address,i(e.cursor),i(e.limit)],fetch:(e,{chain:r,address:t,cursor:o,limit:n})=>e.getWalletPortfolioPnls(r,t,{cursor:o,limit:n})});function p(e){function r(o,n=y){return [n,e.name,"infinite",...e.queryKey(o)]}function t(o,n={}){let{client:l,queryKeyPrefix:m}=a();return reactQuery.useInfiniteQuery({queryKey:r(o,m),queryFn:({pageParam:f})=>e.fetch(l,o,f),initialPageParam:void 0,getNextPageParam:f=>f.hasNext?f.endCursor:void 0,...n})}return {queryKey:r,useInfiniteQuery:t}}var {queryKey:$r,useInfiniteQuery:et}=p({name:"walletPortfolioPnls",queryKey:e=>[e.chain,e.address,i(e.limit)],fetch:(e,r,t)=>e.getWalletPortfolioPnls(r.chain,r.address,{cursor:t,limit:r.limit??100})});var {queryKey:it,fetch:nt,useQuery:st}=s({name:"walletPortfolios",queryKey:e=>[e.chain,e.address,i(e.cursor),i(e.limit)],fetch:(e,{chain:r,address:t,cursor:o,limit:n})=>e.getWalletPortfolios(r,t,{cursor:o,limit:n})});var {queryKey:ct,fetch:ft,useQuery:lt}=s({name:"walletPortfoliosByTokens",queryKey:e=>[e.chain,e.address,...[...e.tokenAddresses].sort()],fetch:(e,{chain:r,address:t,tokenAddresses:o})=>e.getWalletPortfoliosByTokens(r,t,o)});var {queryKey:pt,useInfiniteQuery:Pt}=p({name:"walletPortfolios",queryKey:e=>[e.chain,e.address,i(e.limit)],fetch:(e,r,t)=>e.getWalletPortfolios(r.chain,r.address,{cursor:t,limit:r.limit??100})});var {queryKey:kt,fetch:xt,useQuery:bt}=s({name:"walletPortfolioPnlsByTokens",queryKey:e=>[e.chain,e.address,...[...e.tokenAddresses].sort()],fetch:(e,{chain:r,address:t,tokenAddresses:o})=>e.getWalletPortfolioPnlsByTokens(r,t,o)});var {queryKey:gt,fetch:At,useQuery:Kt}=s({name:"walletTrades",queryKey:e=>[e.chain,e.address,i(e.before),i(e.after),i(e.beforeBlockHeight),i(e.afterBlockHeight),i(e.type),i(e.poolAddress)],fetch:(e,{chain:r,address:t,...o})=>e.getWalletTrades(r,t,o)});var {queryKey:qt,fetch:Wt,useQuery:Ot}=s({name:"tokenActivities",queryKey:e=>[e.chain,e.address,i(e.before),i(e.after),i(e.beforeBlockHeight),i(e.afterBlockHeight),i(e.type),i(e.poolAddress)],fetch:(e,{chain:r,address:t,...o})=>e.getTokenActivities(r,t,o)});var {queryKey:Ht,fetch:Rt,useQuery:Ft}=s({name:"walletActivities",queryKey:e=>[e.chain,e.address,i(e.before),i(e.after),i(e.beforeBlockHeight),i(e.afterBlockHeight),i(e.type),i(e.poolAddress)],fetch:(e,{chain:r,address:t,...o})=>e.getWalletActivities(r,t,o)});function u(e,r,t,o){let n=react.useRef(r);n.current=r;let l=react.useRef(o?.onError);l.current=o?.onError,react.useEffect(()=>{if(o?.enabled===false)return;let m;try{m=e(f=>n.current(f));}catch(f){l.current?.(f instanceof Error?f:new Error(String(f)));}return ()=>m?.unsubscribe()},t);}function Gt(e,r,t){let{subscribeClient:o}=a();u(n=>o.subscribeToken(e.chain,e.address,n),r,[o,e.chain,e.address,t?.enabled],t);}function Jt(e,r,t){let{subscribeClient:o}=a();u(n=>o.subscribeTokenCandles(e.chain,e.address,e.resolution,n),r,[o,e.chain,e.address,e.resolution,t?.enabled],t);}function $t(e,r,t){let{subscribeClient:o}=a();u(n=>o.subscribeTokenTrades(e.chain,e.address,n),r,[o,e.chain,e.address,t?.enabled],t);}function oo(e,r,t){let{subscribeClient:o}=a();u(n=>o.subscribeWalletPnl(e.chain,e.address,n),r,[o,e.chain,e.address,t?.enabled],t);}function ao(e,r,t){let{subscribeClient:o}=a();u(n=>o.subscribeWalletPortfolios(e.chain,e.address,n),r,[o,e.chain,e.address,t?.enabled],t);}function lo(e,r,t){let{subscribeClient:o}=a();u(n=>o.subscribeWalletPortfolioPnls(e.chain,e.address,n),r,[o,e.chain,e.address,t?.enabled],t);}function Po(e,r,t){let{subscribeClient:o}=a();u(n=>o.subscribeWalletTrades(e.chain,e.address,n),r,[o,e.chain,e.address,t?.enabled],t);}function xo(e,r,t){let{subscribeClient:o}=a();u(n=>o.subscribeTokenActivities(e.chain,e.address,n),r,[o,e.chain,e.address,t?.enabled],t);}function Co(e,r,t){let{subscribeClient:o}=a();u(n=>o.subscribeWalletActivities(e.chain,e.address,n),r,[o,e.chain,e.address,t?.enabled],t);}function Io(e,r,t){let{subscribeClient:o}=a();u(n=>o.subscribeNewTokens(e.chain,n),r,[o,e.chain,t?.enabled],t);}function Wo(e,r,t){let{subscribeClient:o}=a();u(n=>o.subscribeTrendingTokens(e.chain,n),r,[o,e.chain,t?.enabled],t);}function vo(e,r,t){let{subscribeClient:o}=a();u(n=>o.subscribeMigratedTokens(e.chain,n),r,[o,e.chain,t?.enabled],t);}function _o(e,r,t){let{subscribeClient:o}=a();u(n=>o.subscribeFinalStretchTokens(e.chain,n),r,[o,e.chain,t?.enabled],t);}function No(e,r,t){let{subscribeClient:o}=a();u(n=>o.subscribeStockTokens(e.chain,n),r,[o,e.chain,t?.enabled],t);}function Bi({client:e,subscribeClient:r,queryKeyPrefix:t=y,children:o}){let n=react.useMemo(()=>({client:e,subscribeClient:r,queryKeyPrefix:t}),[e,r,t]);return jsxRuntime.jsx(d.Provider,{value:n,children:o})}exports.DEFAULT_QUERY_KEY_PREFIX=y;exports.DexClientContext=d;exports.DexClientProvider=Bi;exports.fetchFinalStretchTokens=N;exports.fetchMigratedTokens=j;exports.fetchNewTokens=te;exports.fetchPresignedUploadUrl=S;exports.fetchSearchTokens=de;exports.fetchStockTokens=ge;exports.fetchSwapRoute=qe;exports.fetchToken=$e;exports.fetchTokenActivities=Wt;exports.fetchTokenCandles=He;exports.fetchTokenHolders=Le;exports.fetchTokenMarketData=Xe;exports.fetchTokenSecurity=ir;exports.fetchTokenStats=dr;exports.fetchTokenTrades=xr;exports.fetchTokens=cr;exports.fetchTrendingTokens=Ar;exports.fetchTxSuccess=Wr;exports.fetchWalletActivities=Rt;exports.fetchWalletPnl=Rr;exports.fetchWalletPortfolioPnls=Nr;exports.fetchWalletPortfolioPnlsByTokens=xt;exports.fetchWalletPortfolios=nt;exports.fetchWalletPortfoliosByTokens=ft;exports.fetchWalletTrades=At;exports.finalStretchTokensQueryKey=L;exports.migratedTokensQueryKey=J;exports.newTokensQueryKey=re;exports.presignedUploadUrlQueryKey=b;exports.searchTokensQueryKey=me;exports.sendTx=C;exports.stockTokensQueryKey=Ce;exports.swapRouteQueryKey=De;exports.toKeySegment=i;exports.toSortedKeySegment=c;exports.tokenActivitiesQueryKey=qt;exports.tokenCandlesQueryKey=ve;exports.tokenHoldersQueryKey=Me;exports.tokenMarketDataQueryKey=Ye;exports.tokenQueryKey=Ze;exports.tokenSecurityQueryKey=or;exports.tokenStatsQueryKey=mr;exports.tokenTradesQueryKey=kr;exports.tokensQueryKey=ur;exports.trendingTokensQueryKey=gr;exports.txSuccessQueryKey=qr;exports.useDexClient=a;exports.useFinalStretchTokensQuery=G;exports.useFinalStretchTokensSubscription=_o;exports.useMigratedTokensQuery=z;exports.useMigratedTokensSubscription=vo;exports.useNewTokensQuery=oe;exports.useNewTokensSubscription=Io;exports.usePresignedUploadUrlQuery=ce;exports.useSearchTokensQuery=pe;exports.useSendTxMutation=xe;exports.useStockTokensQuery=Ae;exports.useStockTokensSubscription=No;exports.useSwapRouteQuery=We;exports.useTokenActivitiesQuery=Ot;exports.useTokenActivitiesSubscription=xo;exports.useTokenCandlesQuery=Re;exports.useTokenCandlesSubscription=Jt;exports.useTokenHoldersQuery=Ne;exports.useTokenMarketDataQuery=Je;exports.useTokenQuery=er;exports.useTokenSecurityQuery=nr;exports.useTokenStatsQuery=pr;exports.useTokenSubscription=Gt;exports.useTokenTradesQuery=br;exports.useTokenTradesSubscription=$t;exports.useTokensQuery=fr;exports.useTrendingTokensQuery=Kr;exports.useTrendingTokensSubscription=Wo;exports.useTxSuccessQuery=Or;exports.useWalletActivitiesQuery=Ft;exports.useWalletActivitiesSubscription=Co;exports.useWalletPnlQuery=Fr;exports.useWalletPnlSubscription=oo;exports.useWalletPortfolioPnlsByTokensQuery=bt;exports.useWalletPortfolioPnlsInfiniteQuery=et;exports.useWalletPortfolioPnlsQuery=Gr;exports.useWalletPortfolioPnlsSubscription=lo;exports.useWalletPortfoliosByTokensQuery=lt;exports.useWalletPortfoliosInfiniteQuery=Pt;exports.useWalletPortfoliosQuery=st;exports.useWalletPortfoliosSubscription=ao;exports.useWalletTradesQuery=Kt;exports.useWalletTradesSubscription=Po;exports.walletActivitiesQueryKey=Ht;exports.walletPnlQueryKey=Hr;exports.walletPortfolioPnlsByTokensQueryKey=kt;exports.walletPortfolioPnlsInfiniteQueryKey=$r;exports.walletPortfolioPnlsQueryKey=Lr;exports.walletPortfoliosByTokensQueryKey=ct;exports.walletPortfoliosInfiniteQueryKey=pt;exports.walletPortfoliosQueryKey=it;exports.walletTradesQueryKey=gt;//# sourceMappingURL=index.js.map
+'use strict';var react=require('react'),reactQuery=require('@tanstack/react-query'),jsxRuntime=require('react/jsx-runtime');typeof window<"u"&&(window.__LIBERFI_VERSION__=window.__LIBERFI_VERSION__||{},window.__LIBERFI_VERSION__["@liberfi.io/react"]="0.1.12");var y="liberfi",p=react.createContext(null);function a(){let e=react.useContext(p);if(e===null)throw new Error("useDexClient must be used within a DexClientProvider");return e}function s(e){function r(n,l=y){return [l,e.name,...e.queryKey(n)]}function t(n,l){return e.fetch(n,l)}function o(n,l={}){let{client:m,queryKeyPrefix:f}=a();return reactQuery.useQuery({queryKey:r(n,f),queryFn:()=>e.fetch(m,n),...e.defaultOptions,...l})}return {queryKey:r,fetch:t,useQuery:o}}function d(e){function r(o,n=y){return [n,e.name,"infinite",...e.queryKey(o)]}function t(o,n={}){let{client:l,queryKeyPrefix:m}=a();return reactQuery.useInfiniteQuery({queryKey:r(o,m),queryFn:({pageParam:f})=>e.fetch(l,o,f),initialPageParam:void 0,getNextPageParam:f=>f.hasNext?f.endCursor:void 0,...n})}return {queryKey:r,useInfiniteQuery:t}}function i(e){return e==null?"":e instanceof Date?e.toISOString():String(e)}function c(e){return !e||e.length===0?"[]":JSON.stringify([...e].sort())}var {queryKey:Y,fetch:X,useQuery:J}=s({name:"finalStretchTokens",queryKey:e=>[e.chain,i(e.sortBy),i(e.sortDirection),c(e.keywords),c(e.excludeKeywords),c(e.filters)],fetch:(e,{chain:r,...t})=>e.getFinalStretchTokens(r,t)});var {queryKey:$,fetch:ee,useQuery:re}=s({name:"migratedTokens",queryKey:e=>[e.chain,i(e.sortBy),i(e.sortDirection),c(e.keywords),c(e.excludeKeywords),c(e.filters)],fetch:(e,{chain:r,...t})=>e.getMigratedTokens(r,t)});var {queryKey:ne,fetch:se,useQuery:ae}=s({name:"newTokens",queryKey:e=>[e.chain,i(e.sortBy),i(e.sortDirection),c(e.keywords),c(e.excludeKeywords),c(e.filters)],fetch:(e,{chain:r,...t})=>e.getNewTokens(r,t)});function S(e=y){return [e,"presignedUploadUrl"]}async function Q(e){return await e.getPresignedUploadUrl()}function me(e={}){let{client:r,queryKeyPrefix:t}=a();return reactQuery.useQuery({queryKey:S(t),queryFn:async()=>Q(r),staleTime:0,...e})}var {queryKey:he,fetch:Te,useQuery:ke}=s({name:"searchTokens",queryKey:e=>[i(e.cursor),i(e.limit),i(e.direction),c(e.chains),i(e.keyword),c(e.filters),i(e.sortBy),i(e.sortDirection)],fetch:(e,r)=>e.searchTokens(r)});async function g(e,r){return await e.sendTx(r)}function Ce(e={}){let{client:r}=a();return reactQuery.useMutation({mutationFn:async t=>g(r,t),...e})}var {queryKey:Ie,fetch:Ue,useQuery:De}=s({name:"stockTokens",queryKey:e=>[e.chain,i(e.sortBy),i(e.sortDirection),c(e.keywords),c(e.excludeKeywords),c(e.filters)],fetch:(e,{chain:r,...t})=>e.getStockTokens(r,t)});var {queryKey:we,fetch:Ee,useQuery:He}=s({name:"swapRoute",queryKey:e=>[e.chain,e.userAddress,e.input,e.output,e.mode,e.amount,i(e.slippage),i(e.priorityFee),i(e.tipFee),i(e.isAntiMev)],fetch:(e,r)=>e.swapRoute(r)});var {queryKey:_e,fetch:Be,useQuery:Me}=s({name:"tokenCandles",queryKey:e=>[e.chain,e.address,e.resolution,i(e.after),i(e.before),i(e.limit)],fetch:(e,{chain:r,address:t,resolution:o,...n})=>e.getTokenCandles(r,t,o,n)});var {queryKey:Ve,fetch:Ye,useQuery:Xe}=s({name:"tokenHolders",queryKey:e=>[e.chain,e.address,i(e.cursor),i(e.limit),i(e.direction)],fetch:(e,{chain:r,address:t,...o})=>e.getTokenHolders(r,t,o)});var {queryKey:ze,fetch:Ze,useQuery:$e}=s({name:"tokenMarketData",queryKey:e=>[e.chain,e.address],fetch:(e,r)=>e.getTokenMarketData(r.chain,r.address)});var {queryKey:tr,fetch:or,useQuery:ir}=s({name:"token",queryKey:e=>[e.chain,e.address],fetch:(e,r)=>e.getToken(r.chain,r.address)});var {queryKey:ar,fetch:ur,useQuery:cr}=s({name:"tokenSecurity",queryKey:e=>[e.chain,e.address],fetch:(e,r)=>e.getTokenSecurity(r.chain,r.address)});var {queryKey:yr,fetch:mr,useQuery:dr}=s({name:"tokens",queryKey:e=>[e.chain,[...e.addresses].sort().join(",")],fetch:(e,r)=>e.getTokens(r.chain,r.addresses)});var {queryKey:hr,fetch:Tr,useQuery:kr}=s({name:"tokenStats",queryKey:e=>[e.chain,e.address],fetch:(e,r)=>e.getTokenStats(r.chain,r.address)});var {queryKey:Qr,fetch:Cr,useQuery:gr}=s({name:"tokenTrades",queryKey:e=>[e.chain,e.address,i(e.before),i(e.after),i(e.beforeBlockHeight),i(e.afterBlockHeight),i(e.type),i(e.poolAddress)],fetch:(e,{chain:r,address:t,...o})=>e.getTokenTrades(r,t,o)});var {queryKey:Ur,fetch:Dr,useQuery:qr}=s({name:"trendingTokens",queryKey:e=>[e.chain,e.resolution,i(e.sortBy),i(e.sortDirection),c(e.keywords),c(e.excludeKeywords),c(e.filters)],fetch:(e,{chain:r,resolution:t,...o})=>e.getTrendingTokens(r,t,o)});var {queryKey:Er,fetch:Hr,useQuery:vr}=s({name:"txSuccess",queryKey:e=>[e.chain,e.txHash,i(e.timeout)],fetch:(e,{chain:r,txHash:t,timeout:o})=>e.checkTxSuccess(r,t,o)});var {queryKey:Br,fetch:Mr,useQuery:Lr}=s({name:"walletPnl",queryKey:e=>[e.chain,e.address,i(e.resolution??"all")],fetch:(e,{chain:r,address:t,resolution:o})=>e.getWalletPnl(r,t,o)});var {queryKey:Yr,fetch:Xr,useQuery:Jr}=s({name:"walletPortfolioPnls",queryKey:e=>[e.chain,e.address,i(e.cursor),i(e.limit)],fetch:(e,{chain:r,address:t,cursor:o,limit:n})=>e.getWalletPortfolioPnls(r,t,{cursor:o,limit:n})});var {queryKey:$r,useInfiniteQuery:et}=d({name:"walletPortfolioPnls",queryKey:e=>[e.chain,e.address,i(e.limit)],fetch:(e,r,t)=>e.getWalletPortfolioPnls(r.chain,r.address,{cursor:t,limit:r.limit??100})});var {queryKey:it,fetch:nt,useQuery:st}=s({name:"walletPortfolios",queryKey:e=>[e.chain,e.address,i(e.cursor),i(e.limit)],fetch:(e,{chain:r,address:t,cursor:o,limit:n})=>e.getWalletPortfolios(r,t,{cursor:o,limit:n})});var {queryKey:ct,fetch:ft,useQuery:lt}=s({name:"walletPortfoliosByTokens",queryKey:e=>[e.chain,e.address,...[...e.tokenAddresses].sort()],fetch:(e,{chain:r,address:t,tokenAddresses:o})=>e.getWalletPortfoliosByTokens(r,t,o)});var {queryKey:pt,useInfiniteQuery:Pt}=d({name:"walletPortfolios",queryKey:e=>[e.chain,e.address,i(e.limit)],fetch:(e,r,t)=>e.getWalletPortfolios(r.chain,r.address,{cursor:t,limit:r.limit??100})});var {queryKey:kt,fetch:xt,useQuery:bt}=s({name:"walletPortfolioPnlsByTokens",queryKey:e=>[e.chain,e.address,...[...e.tokenAddresses].sort()],fetch:(e,{chain:r,address:t,tokenAddresses:o})=>e.getWalletPortfolioPnlsByTokens(r,t,o)});var {queryKey:gt,fetch:At,useQuery:Kt}=s({name:"walletTrades",queryKey:e=>[e.chain,e.address,i(e.before),i(e.after),i(e.beforeBlockHeight),i(e.afterBlockHeight),i(e.type),i(e.poolAddress)],fetch:(e,{chain:r,address:t,...o})=>e.getWalletTrades(r,t,o)});var {queryKey:qt,fetch:Wt,useQuery:Ot}=s({name:"tokenActivities",queryKey:e=>[e.chain,e.address,i(e.before),i(e.after),i(e.beforeBlockHeight),i(e.afterBlockHeight),i(e.type),i(e.poolAddress)],fetch:(e,{chain:r,address:t,...o})=>e.getTokenActivities(r,t,o)});var {queryKey:vt,fetch:Rt,useQuery:Ft}=s({name:"walletActivities",queryKey:e=>[e.chain,e.address,i(e.before),i(e.after),i(e.beforeBlockHeight),i(e.afterBlockHeight),i(e.type),i(e.poolAddress)],fetch:(e,{chain:r,address:t,...o})=>e.getWalletActivities(r,t,o)});function u(e,r,t,o){let n=react.useRef(r);n.current=r;let l=react.useRef(o?.onError);l.current=o?.onError,react.useEffect(()=>{if(o?.enabled===false)return;let m;try{m=e(f=>n.current(f));}catch(f){l.current?.(f instanceof Error?f:new Error(String(f)));}return ()=>m?.unsubscribe()},t);}function Gt(e,r,t){let{subscribeClient:o}=a();u(n=>o.subscribeToken(e.chain,e.address,n),r,[o,e.chain,e.address,t?.enabled],t);}function Jt(e,r,t){let{subscribeClient:o}=a();u(n=>o.subscribeTokenCandles(e.chain,e.address,e.resolution,n),r,[o,e.chain,e.address,e.resolution,t?.enabled],t);}function $t(e,r,t){let{subscribeClient:o}=a();u(n=>o.subscribeTokenTrades(e.chain,e.address,n),r,[o,e.chain,e.address,t?.enabled],t);}function oo(e,r,t){let{subscribeClient:o}=a();u(n=>o.subscribeWalletPnl(e.chain,e.address,n),r,[o,e.chain,e.address,t?.enabled],t);}function ao(e,r,t){let{subscribeClient:o}=a();u(n=>o.subscribeWalletPortfolios(e.chain,e.address,n),r,[o,e.chain,e.address,t?.enabled],t);}function lo(e,r,t){let{subscribeClient:o}=a();u(n=>o.subscribeWalletPortfolioPnls(e.chain,e.address,n),r,[o,e.chain,e.address,t?.enabled],t);}function Po(e,r,t){let{subscribeClient:o}=a();u(n=>o.subscribeWalletTrades(e.chain,e.address,n),r,[o,e.chain,e.address,t?.enabled],t);}function xo(e,r,t){let{subscribeClient:o}=a();u(n=>o.subscribeTokenActivities(e.chain,e.address,n),r,[o,e.chain,e.address,t?.enabled],t);}function Co(e,r,t){let{subscribeClient:o}=a();u(n=>o.subscribeWalletActivities(e.chain,e.address,n),r,[o,e.chain,e.address,t?.enabled],t);}function Io(e,r,t){let{subscribeClient:o}=a();u(n=>o.subscribeNewTokens(e.chain,n),r,[o,e.chain,t?.enabled],t);}function Wo(e,r,t){let{subscribeClient:o}=a();u(n=>o.subscribeTrendingTokens(e.chain,n),r,[o,e.chain,t?.enabled],t);}function Ho(e,r,t){let{subscribeClient:o}=a();u(n=>o.subscribeMigratedTokens(e.chain,n),r,[o,e.chain,t?.enabled],t);}function _o(e,r,t){let{subscribeClient:o}=a();u(n=>o.subscribeFinalStretchTokens(e.chain,n),r,[o,e.chain,t?.enabled],t);}function No(e,r,t){let{subscribeClient:o}=a();u(n=>o.subscribeStockTokens(e.chain,n),r,[o,e.chain,t?.enabled],t);}function Li({client:e,subscribeClient:r,queryKeyPrefix:t=y,children:o}){let n=react.useMemo(()=>({client:e,subscribeClient:r,queryKeyPrefix:t}),[e,r,t]);return jsxRuntime.jsx(p.Provider,{value:n,children:o})}exports.DEFAULT_QUERY_KEY_PREFIX=y;exports.DexClientContext=p;exports.DexClientProvider=Li;exports.createInfiniteQueryHook=d;exports.createQueryHook=s;exports.fetchFinalStretchTokens=X;exports.fetchMigratedTokens=ee;exports.fetchNewTokens=se;exports.fetchPresignedUploadUrl=Q;exports.fetchSearchTokens=Te;exports.fetchStockTokens=Ue;exports.fetchSwapRoute=Ee;exports.fetchToken=or;exports.fetchTokenActivities=Wt;exports.fetchTokenCandles=Be;exports.fetchTokenHolders=Ye;exports.fetchTokenMarketData=Ze;exports.fetchTokenSecurity=ur;exports.fetchTokenStats=Tr;exports.fetchTokenTrades=Cr;exports.fetchTokens=mr;exports.fetchTrendingTokens=Dr;exports.fetchTxSuccess=Hr;exports.fetchWalletActivities=Rt;exports.fetchWalletPnl=Mr;exports.fetchWalletPortfolioPnls=Xr;exports.fetchWalletPortfolioPnlsByTokens=xt;exports.fetchWalletPortfolios=nt;exports.fetchWalletPortfoliosByTokens=ft;exports.fetchWalletTrades=At;exports.finalStretchTokensQueryKey=Y;exports.migratedTokensQueryKey=$;exports.newTokensQueryKey=ne;exports.presignedUploadUrlQueryKey=S;exports.searchTokensQueryKey=he;exports.sendTx=g;exports.stockTokensQueryKey=Ie;exports.swapRouteQueryKey=we;exports.toKeySegment=i;exports.toSortedKeySegment=c;exports.tokenActivitiesQueryKey=qt;exports.tokenCandlesQueryKey=_e;exports.tokenHoldersQueryKey=Ve;exports.tokenMarketDataQueryKey=ze;exports.tokenQueryKey=tr;exports.tokenSecurityQueryKey=ar;exports.tokenStatsQueryKey=hr;exports.tokenTradesQueryKey=Qr;exports.tokensQueryKey=yr;exports.trendingTokensQueryKey=Ur;exports.txSuccessQueryKey=Er;exports.useDexClient=a;exports.useFinalStretchTokensQuery=J;exports.useFinalStretchTokensSubscription=_o;exports.useMigratedTokensQuery=re;exports.useMigratedTokensSubscription=Ho;exports.useNewTokensQuery=ae;exports.useNewTokensSubscription=Io;exports.usePresignedUploadUrlQuery=me;exports.useSearchTokensQuery=ke;exports.useSendTxMutation=Ce;exports.useStockTokensQuery=De;exports.useStockTokensSubscription=No;exports.useSwapRouteQuery=He;exports.useTokenActivitiesQuery=Ot;exports.useTokenActivitiesSubscription=xo;exports.useTokenCandlesQuery=Me;exports.useTokenCandlesSubscription=Jt;exports.useTokenHoldersQuery=Xe;exports.useTokenMarketDataQuery=$e;exports.useTokenQuery=ir;exports.useTokenSecurityQuery=cr;exports.useTokenStatsQuery=kr;exports.useTokenSubscription=Gt;exports.useTokenTradesQuery=gr;exports.useTokenTradesSubscription=$t;exports.useTokensQuery=dr;exports.useTrendingTokensQuery=qr;exports.useTrendingTokensSubscription=Wo;exports.useTxSuccessQuery=vr;exports.useWalletActivitiesQuery=Ft;exports.useWalletActivitiesSubscription=Co;exports.useWalletPnlQuery=Lr;exports.useWalletPnlSubscription=oo;exports.useWalletPortfolioPnlsByTokensQuery=bt;exports.useWalletPortfolioPnlsInfiniteQuery=et;exports.useWalletPortfolioPnlsQuery=Jr;exports.useWalletPortfolioPnlsSubscription=lo;exports.useWalletPortfoliosByTokensQuery=lt;exports.useWalletPortfoliosInfiniteQuery=Pt;exports.useWalletPortfoliosQuery=st;exports.useWalletPortfoliosSubscription=ao;exports.useWalletTradesQuery=Kt;exports.useWalletTradesSubscription=Po;exports.walletActivitiesQueryKey=vt;exports.walletPnlQueryKey=Br;exports.walletPortfolioPnlsByTokensQueryKey=kt;exports.walletPortfolioPnlsInfiniteQueryKey=$r;exports.walletPortfolioPnlsQueryKey=Yr;exports.walletPortfoliosByTokensQueryKey=ct;exports.walletPortfoliosInfiniteQueryKey=pt;exports.walletPortfoliosQueryKey=it;exports.walletTradesQueryKey=gt;//# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map