@reown/appkit-controllers 1.8.17-fetchwallets-networkids.0 → 1.8.17-headless-deeplink-improvement-0.1.0

package/dist/types/exports/react.d.ts

@@ -1,4 +1,4 @@
-import { type CaipNetworkId, type ChainNamespace, type Connection } from '@reown/appkit-common';
+import { type ChainNamespace, type Connection } from '@reown/appkit-common';
 import { type WalletItem } from '../src/utils/ConnectUtil.js';
 import type { UseAppKitAccountReturn, UseAppKitNetworkReturn } from '../src/utils/TypeUtil.js';
 export type { Connection } from '@reown/appkit-common';
@@ -25,11 +25,6 @@ interface DeleteRecentConnectionProps {
     address: string;
     connectorId: string;
 }
-interface FetchWalletsProps {
-    page?: number;
-    query?: string;
-    caipNetworkIds?: CaipNetworkId[];
-}
 export declare function useAppKitProvider<T>(chainNamespace: ChainNamespace): {
     walletProvider: T;
     walletProviderType: import("./index.js").ConnectorType | undefined;
@@ -125,7 +120,10 @@ export interface UseAppKitWalletsReturn {
      * @param options.page - Page number to fetch (default: 1)
      * @param options.query - Search query to filter wallets (default: '')
      */
-    fetchWallets: (options?: FetchWalletsProps) => Promise<void>;
+    fetchWallets: (options?: {
+        page?: number;
+        query?: string;
+    }) => Promise<void>;
     /**
      * Function to connect to a wallet.
      * - For WalletConnect wallets: initiates WC connection and returns the URI with the `wcUri` state.
@@ -140,6 +138,26 @@ export interface UseAppKitWalletsReturn {
      * Function to reset the WC URI. Useful to keep `connectingWallet` state sync with the WC URI. Can be called when the QR code is closed.
      */
     resetWcUri: () => void;
+    /**
+     * Status of the last mobile deeplink attempt.
+     */
+    deeplinkStatus: 'idle' | 'pending' | 'success' | 'failed';
+    /**
+     * Error reason for the last deeplink attempt (best-effort heuristic).
+     */
+    deeplinkError?: 'timeout';
+    /**
+     * Clears the last deeplink status and error.
+     */
+    resetDeeplinkStatus: () => void;
+    /**
+     * Whether a deeplink is ready and waiting for user action.
+     */
+    deeplinkReady: boolean;
+    /**
+     * Opens the deeplink for the currently connecting wallet.
+     */
+    openDeeplink: () => void;
 }
 /**
  * Headless hook for wallet connection.

package/dist/types/src/controllers/ApiController.d.ts

@@ -1,4 +1,4 @@
-import type { CaipNetworkId, ChainNamespace } from '@reown/appkit-common';
+import type { ChainNamespace } from '@reown/appkit-common';
 import { FetchUtil } from '../utils/FetchUtil.js';
 import type { ApiGetWalletsRequest, ProjectLimits, Tier, WcWallet } from '../utils/TypeUtil.js';
 export declare const api: FetchUtil;
@@ -35,12 +35,6 @@ interface PrefetchParameters {
     fetchNetworkImages?: boolean;
     fetchWalletRanks?: boolean;
 }
-interface SearchWalletParams extends Pick<ApiGetWalletsRequest, 'search' | 'badge'> {
-    caipNetworkIds?: CaipNetworkId[];
-}
-interface FetchWalletsByPageParams extends Pick<ApiGetWalletsRequest, 'page'> {
-    caipNetworkIds?: CaipNetworkId[];
-}
 type StateKey = keyof ApiControllerState;
 export declare const ApiController: {
     state: ApiControllerState;
@@ -77,11 +71,11 @@ export declare const ApiController: {
     prefetchWalletRanks(): Promise<void>;
     fetchFeaturedWallets(): Promise<void>;
     fetchRecommendedWallets(): Promise<void>;
-    fetchWalletsByPage({ page, caipNetworkIds }: FetchWalletsByPageParams): Promise<void>;
+    fetchWalletsByPage({ page }: Pick<ApiGetWalletsRequest, "page">): Promise<void>;
     initializeExcludedWallets({ ids }: {
         ids: string[];
     }): Promise<void>;
-    searchWallet({ search, badge, caipNetworkIds }: SearchWalletParams): Promise<void>;
+    searchWallet({ search, badge }: Pick<ApiGetWalletsRequest, "search" | "badge">): Promise<void>;
     initPromise(key: string, fetchFn: () => Promise<void>): Promise<unknown>;
     prefetch({ fetchConnectorImages, fetchFeaturedWallets, fetchRecommendedWallets, fetchNetworkImages, fetchWalletRanks }?: PrefetchParameters): Promise<PromiseSettledResult<unknown>[]>;
     prefetchAnalyticsConfig(): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reown/appkit-controllers",
-  "version": "1.8.17-fetchwallets-networkids.0",
+  "version": "1.8.17-headless-deeplink-improvement-0.1.0",
   "sideEffects": false,
   "type": "module",
   "main": "./dist/esm/exports/index.js",
@@ -56,8 +56,8 @@
     "@walletconnect/universal-provider": "2.23.1",
     "valtio": "2.1.7",
     "viem": ">=2.37.9",
-    "@reown/appkit-common": "1.8.17-fetchwallets-networkids.0",
-    "@reown/appkit-wallet": "1.8.17-fetchwallets-networkids.0"
+    "@reown/appkit-common": "1.8.17-headless-deeplink-improvement-0.1.0",
+    "@reown/appkit-wallet": "1.8.17-headless-deeplink-improvement-0.1.0"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "2.1.9",