@dynamic-labs-sdk/react-hooks 1.13.0 → 1.16.1

package/dist/index.esm.js

@@ -7,7 +7,7 @@ import { getCore } from "@dynamic-labs-sdk/client/core";
 
 //#region package.json
 var name = "@dynamic-labs-sdk/react-hooks";
-var version = "1.13.0";
+var version = "1.16.1";
 
 //#endregion
 //#region src/modules/DynamicContext/DynamicContext.ts
@@ -57,6 +57,7 @@ const useDynamicClient = () => {
 
 //#endregion
 //#region src/foundation/useBaseMutation/useBaseMutation.ts
+const EMPTY_MIDDLEWARES$1 = [];
 /**
 * Internal hook that wraps a react-query `useMutation` with the conventions
 * used by every async-write hook in this package:
@@ -67,12 +68,15 @@ const useDynamicClient = () => {
 * - Callers pass `mutateParams` to override any default
 *   `UseMutationOptions`, so consumers can wire `onSuccess` / `onError` /
 *   etc.
+* - Callers pass `middlewares` (named hooks like `invalidatesQueries`) and
+*   each contributed `onSuccess` runs, in order, ahead of the consumer's own.
 *
 * Returns the full `useMutation` result — `mutate`, `mutateAsync`, `data`,
 * `error`, `isPending`, `isSuccess`, `reset`, `status`, etc.
 */
-const useBaseMutation = ({ mutationFn, mutateParams }) => {
+const useBaseMutation = ({ middlewares = EMPTY_MIDDLEWARES$1, mutationFn, mutateParams }) => {
 	const client = useDynamicClient();
+	const contributions = middlewares.map((useMiddleware) => useMiddleware());
 	return useMutation({
 		mutationFn: async (variables) => {
 			await waitForClientInitialized(client);
@@ -81,7 +85,11 @@ const useBaseMutation = ({ mutationFn, mutateParams }) => {
 				variables
 			});
 		},
-		...mutateParams
+		...mutateParams,
+		onSuccess: async (...args) => {
+			for (const contribution of contributions) await contribution.onSuccess?.(...args);
+			return mutateParams?.onSuccess?.(...args);
+		}
 	});
 };
 
@@ -103,9 +111,32 @@ const useAcknowledgeRecoveryCodes = ({ mutateParams } = {}) => useBaseMutation({
 	mutationFn: ({ client }) => acknowledgeRecoveryCodes(client)
 });
 
+//#endregion
+//#region src/foundation/hookKeyNamespace/hookKeyNamespace.ts
+/**
+* Root namespace shared by every react-query key this package creates.
+* Both `QUERY_KEY_PREFIX` (async-read hooks) and the state-hook key
+* prefix derive from this constant so the namespace is defined exactly
+* once.
+*/
+const HOOK_KEY_NAMESPACE = "@dynamic-labs-sdk/react-hooks";
+
+//#endregion
+//#region src/foundation/useBaseQuery/queryKeyPrefix.ts
+/**
+* Shared prefix for all query keys created by `useBaseQuery`. Mutation hooks
+* reference this when invalidating related queries on success.
+*/
+const QUERY_KEY_PREFIX = [HOOK_KEY_NAMESPACE, "query"];
+
 //#endregion
 //#region src/foundation/useBaseQuery/useBaseQuery.ts
 /**
+* Stable empty default for the `middlewares` param so the common (ungated)
+* case never allocates a fresh array per render.
+*/
+const EMPTY_MIDDLEWARES = [];
+/**
 * Internal hook that wraps a react-query `useQuery` with the conventions used
 * by every async-read hook in this package:
 *
@@ -116,24 +147,23 @@ const useAcknowledgeRecoveryCodes = ({ mutateParams } = {}) => useBaseMutation({
 *   so consumers can opt into retries / custom staleTime / etc.
 * - Callers pass `enabled: false` (typically derived from whether their
 *   pseudo-required arguments are present) to short-circuit fetches.
+* - Callers pass `middlewares` (named gating hooks like `requiresUser`) and
+*   the query only runs when every one returns `true`.
 *
 * Returns the full `useQuery` result — `data`, `error`, `isLoading`,
 * `isFetching`, `isSuccess`, `refetch`, `status`, etc.
 */
-const useBaseQuery = ({ queryFn, queryKey, queryParams, enabled = true }) => {
+const useBaseQuery = ({ enabled = true, middlewares = EMPTY_MIDDLEWARES, queryFn, queryKey, queryParams }) => {
 	const client = useDynamicClient();
+	const middlewaresAllow = middlewares.map((useMiddleware) => useMiddleware()).every(Boolean);
 	return useQuery({
 		queryFn: async () => {
 			await waitForClientInitialized(client);
 			return queryFn(client);
 		},
-		queryKey: useMemo(() => [
-			"@dynamic-labs-sdk/react-hooks",
-			"query",
-			...queryKey
-		], [queryKey]),
+		queryKey: useMemo(() => [...QUERY_KEY_PREFIX, ...queryKey], [queryKey]),
 		...queryParams,
-		enabled: enabled && queryParams?.enabled !== false
+		enabled: enabled && middlewaresAllow && queryParams?.enabled !== false
 	});
 };
 
@@ -363,7 +393,7 @@ const useBaseState = ({ event, queryKey, queryParams, selector, defaultValue, sk
 		return Object.keys(map).sort((a, b) => a.localeCompare(b));
 	}, [eventsMapJson]);
 	const fullQueryKey = useMemo(() => [
-		"@dynamic-labs-sdk/react-hooks",
+		HOOK_KEY_NAMESPACE,
 		"state",
 		...queryKey
 	], [JSON.stringify(queryKey)]);