@dynamic-labs-sdk/react-hooks 1.30.3 → 1.31.1

package/dist/core.cjs

@@ -1,4 +1,4 @@
-const require_useBaseState = require('./useBaseState-CI69lvc_.cjs');
+const require_useBaseState = require('./useBaseState-CG4VKkZG.cjs');
 let _dynamic_labs_sdk_assert_package_version = require("@dynamic-labs-sdk/assert-package-version");
 
 //#region src/exports/core.ts

package/dist/core.esm.js

@@ -1,4 +1,4 @@
-import { a as useDynamicClient, c as version, i as useBaseMutation, n as useBaseQuery, s as name, t as useBaseState } from "./useBaseState-dkF7NJuA.esm.js";
+import { a as useDynamicClient, c as version, i as useBaseMutation, n as useBaseQuery, s as name, t as useBaseState } from "./useBaseState-Dpb-P_Py.esm.js";
 import { assertPackageVersion } from "@dynamic-labs-sdk/assert-package-version";
 
 //#region src/exports/core.ts

package/dist/hooks/wrappers/functions/useGetWalletOptionsCatalogue/useGetWalletOptionsCatalogue.d.ts

@@ -10,6 +10,16 @@ export type UseGetWalletOptionsCatalogueParams = GetWalletOptionsCatalogueArgs &
      * hook's CDN-aware defaults.
      */
     queryParams?: UseBaseQueryParams<GetWalletOptionsCatalogueResult>['queryParams'];
+    /**
+     * When `includeMobileOptions` is true, returns the installed wallets
+     * immediately while the full catalogue loads, then swaps in the full
+     * result once it's ready. Defaults to `true`.
+     *
+     * While the installed wallets stand in for the full catalogue, `status` is
+     * already `'success'` and `isLoading` is false — read `isPlaceholderData`
+     * to tell the two apart.
+     */
+    returnInstalledOptionsWhileLoading?: boolean;
 };
 /**
  * Wraps `getWalletOptionsCatalogue` from `@dynamic-labs-sdk/client`. Returns the catalogue of wallet options the project supports.
@@ -20,11 +30,21 @@ export type UseGetWalletOptionsCatalogueParams = GetWalletOptionsCatalogueArgs &
  * `walletProviderUnregistered` (on removal). Wiring both keeps the catalogue in
  * sync without consumers pairing the hook with a manual listener.
  *
+ * Also refetches on `networkProviderBuilderRegistered`: the catalogue is scoped
+ * to the chains the client has an extension for, and an extension added after
+ * the first fetch emits no wallet provider event of its own.
+ *
+ * With `includeMobileOptions: true` the installed wallets are returned as
+ * react-query placeholder data while the wallet book loads, so `data` is
+ * populated before the full catalogue resolves and `status` is `'success'`
+ * from the start — `isPlaceholderData` is what tells a partial catalogue from
+ * the complete one.
+ *
  * @example
  * ```tsx
  * const { data: catalogue, isLoading } = useGetWalletOptionsCatalogue();
  * ```
  */
-export declare const useGetWalletOptionsCatalogue: ({ queryParams, ...args }?: UseGetWalletOptionsCatalogueParams) => UseQueryResult<GetWalletOptionsCatalogueResult, Error>;
+export declare const useGetWalletOptionsCatalogue: ({ queryParams, returnInstalledOptionsWhileLoading, ...args }?: UseGetWalletOptionsCatalogueParams) => UseQueryResult<GetWalletOptionsCatalogueResult, Error>;
 export {};
 //# sourceMappingURL=useGetWalletOptionsCatalogue.d.ts.map

package/dist/hooks/wrappers/functions/useGetWalletOptionsCatalogue/useGetWalletOptionsCatalogue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useGetWalletOptionsCatalogue.d.ts","sourceRoot":"","sources":["../../../../../src/hooks/wrappers/functions/useGetWalletOptionsCatalogue/useGetWalletOptionsCatalogue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAI9E,KAAK,+BAA+B,GAAG,OAAO,CAC5C,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAC7C,CAAC;AACF,KAAK,6BAA6B,GAAG,WAAW,CAC9C,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAAC,CAAC,CAAC,CAChD,CAAC;AAgBF,MAAM,MAAM,kCAAkC,GAC5C,6BAA6B,GAAG;IAC9B;;;;OAIG;IACH,WAAW,CAAC,EAAE,kBAAkB,CAAC,+BAA+B,CAAC,CAAC,aAAa,CAAC,CAAC;CAClF,CAAC;AAEJ;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,4BAA4B,8BAGtC,kCAAkC,KAAQ,cAAc,CACzD,+BAA+B,EAC/B,KAAK,CAkBH,CAAC"}
+{"version":3,"file":"useGetWalletOptionsCatalogue.d.ts","sourceRoot":"","sources":["../../../../../src/hooks/wrappers/functions/useGetWalletOptionsCatalogue/useGetWalletOptionsCatalogue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AAErE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAG5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAI9E,KAAK,+BAA+B,GAAG,OAAO,CAC5C,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAC7C,CAAC;AACF,KAAK,6BAA6B,GAAG,WAAW,CAC9C,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAAC,CAAC,CAAC,CAChD,CAAC;AAgBF,MAAM,MAAM,kCAAkC,GAC5C,6BAA6B,GAAG;IAC9B;;;;OAIG;IACH,WAAW,CAAC,EAAE,kBAAkB,CAAC,+BAA+B,CAAC,CAAC,aAAa,CAAC,CAAC;IACjF;;;;;;;;OAQG;IACH,kCAAkC,CAAC,EAAE,OAAO,CAAC;CAC9C,CAAC;AAEJ;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,4BAA4B,kEAItC,kCAAkC,KAAQ,cAAc,CACzD,+BAA+B,EAC/B,KAAK,CA2EN,CAAC"}

package/dist/index.cjs

@@ -1,4 +1,4 @@
-const require_useBaseState = require('./useBaseState-CI69lvc_.cjs');
+const require_useBaseState = require('./useBaseState-CG4VKkZG.cjs');
 let _dynamic_labs_sdk_assert_package_version = require("@dynamic-labs-sdk/assert-package-version");
 let _dynamic_labs_sdk_client = require("@dynamic-labs-sdk/client");
 let _tanstack_react_query = require("@tanstack/react-query");
@@ -2538,21 +2538,62 @@ const CATALOGUE_STALE_TIME_MS = 36e5;
 * `walletProviderUnregistered` (on removal). Wiring both keeps the catalogue in
 * sync without consumers pairing the hook with a manual listener.
 *
+* Also refetches on `networkProviderBuilderRegistered`: the catalogue is scoped
+* to the chains the client has an extension for, and an extension added after
+* the first fetch emits no wallet provider event of its own.
+*
+* With `includeMobileOptions: true` the installed wallets are returned as
+* react-query placeholder data while the wallet book loads, so `data` is
+* populated before the full catalogue resolves and `status` is `'success'`
+* from the start — `isPlaceholderData` is what tells a partial catalogue from
+* the complete one.
+*
 * @example
 * ```tsx
 * const { data: catalogue, isLoading } = useGetWalletOptionsCatalogue();
 * ```
 */
-const useGetWalletOptionsCatalogue = ({ queryParams, ...args } = {}) => require_useBaseState.useBaseQuery({
-	middlewares: [invalidateOnEvent({ event: "walletProviderChanged" }), invalidateOnEvent({ event: "walletProviderUnregistered" })],
-	queryFn: (client) => (0, _dynamic_labs_sdk_client.getWalletOptionsCatalogue)(args, client),
-	queryKey: ["useGetWalletOptionsCatalogue", args],
-	queryParams: {
-		retry: false,
-		staleTime: CATALOGUE_STALE_TIME_MS,
-		...queryParams
-	}
-});
+const useGetWalletOptionsCatalogue = ({ queryParams, returnInstalledOptionsWhileLoading = true, ...args } = {}) => {
+	const wantsInstalledPlaceholder = (args.includeMobileOptions ?? false) && returnInstalledOptionsWhileLoading && queryParams?.enabled !== false;
+	const middlewares = [
+		invalidateOnEvent({ event: "walletProviderChanged" }),
+		invalidateOnEvent({ event: "walletProviderUnregistered" }),
+		invalidateOnEvent({ event: "networkProviderBuilderRegistered" })
+	];
+	const catalogueArgs = {
+		...args,
+		includeMobileOptions: args.includeMobileOptions ?? false
+	};
+	const installedOnlyArgs = {
+		...args,
+		includeMobileOptions: false
+	};
+	const catalogueCacheKey = (0, _tanstack_react_query.hashKey)([catalogueArgs]);
+	const loadedCatalogueCacheKeyRef = (0, react.useRef)(void 0);
+	const installedOnlyResult = require_useBaseState.useBaseQuery({
+		enabled: wantsInstalledPlaceholder && loadedCatalogueCacheKeyRef.current !== catalogueCacheKey,
+		middlewares,
+		queryFn: (client) => (0, _dynamic_labs_sdk_client.getWalletOptionsCatalogue)(installedOnlyArgs, client),
+		queryKey: ["useGetWalletOptionsCatalogue", installedOnlyArgs],
+		queryParams: {
+			retry: false,
+			staleTime: CATALOGUE_STALE_TIME_MS
+		}
+	});
+	const fullCatalogueResult = require_useBaseState.useBaseQuery({
+		middlewares,
+		queryFn: (client) => (0, _dynamic_labs_sdk_client.getWalletOptionsCatalogue)(catalogueArgs, client),
+		queryKey: ["useGetWalletOptionsCatalogue", catalogueArgs],
+		queryParams: {
+			retry: false,
+			staleTime: CATALOGUE_STALE_TIME_MS,
+			...wantsInstalledPlaceholder ? { placeholderData: () => installedOnlyResult.data } : {},
+			...queryParams
+		}
+	});
+	loadedCatalogueCacheKeyRef.current = fullCatalogueResult.data !== void 0 && !fullCatalogueResult.isPlaceholderData ? catalogueCacheKey : void 0;
+	return fullCatalogueResult;
+};
 
 //#endregion
 //#region src/hooks/wrappers/functions/useGetWalletPolicyLayer/useGetWalletPolicyLayer.ts