@pear-protocol/symmio-client 0.3.2 → 0.3.5

package/dist/react/index.d.mts

@@ -35,16 +35,15 @@ type UseSymmAuthParams = {
     siweDomain?: string;
 };
 /**
- * Use case: Manage SYMM auth token lifecycle (read, refresh, clear) for an address and chain.
+ * Manages SYMM auth token state. Reads cached / persisted tokens on mount
+ * without any side effects — the wallet signature flow is only triggered
+ * when the caller explicitly invokes `signIn()`.
  */
 declare function useSymmAuth(params?: UseSymmAuthParams): {
     accessToken: string | null;
-    authToken: string | null;
     isAuthenticated: boolean;
-    isLoading: boolean;
-    isFetching: boolean;
     error: Error | null;
-    refresh: (accountAddress?: Address, options?: {
+    signIn: (accountAddress?: Address, options?: {
         force?: boolean;
     }) => Promise<string | null>;
     refreshAuth: (accountAddress?: Address, options?: {

package/dist/react/index.d.ts

@@ -35,16 +35,15 @@ type UseSymmAuthParams = {
     siweDomain?: string;
 };
 /**
- * Use case: Manage SYMM auth token lifecycle (read, refresh, clear) for an address and chain.
+ * Manages SYMM auth token state. Reads cached / persisted tokens on mount
+ * without any side effects — the wallet signature flow is only triggered
+ * when the caller explicitly invokes `signIn()`.
  */
 declare function useSymmAuth(params?: UseSymmAuthParams): {
     accessToken: string | null;
-    authToken: string | null;
     isAuthenticated: boolean;
-    isLoading: boolean;
-    isFetching: boolean;
     error: Error | null;
-    refresh: (accountAddress?: Address, options?: {
+    signIn: (accountAddress?: Address, options?: {
         force?: boolean;
     }) => Promise<string | null>;
     refreshAuth: (accountAddress?: Address, options?: {

package/dist/react/index.js

@@ -677,6 +677,9 @@ function useSymmWs(params = {}) {
   }, [symmCoreClient, accountAddress, chainId, queryClient, setConnected]);
   return { isConnected };
 }
+function trimTrailingSlashes(value) {
+  return value.replace(/\/+$/, "");
+}
 function SymmProvider({
   chainId = 42161,
   address,
@@ -688,13 +691,21 @@ function SymmProvider({
   symmioConfig,
   children
 }) {
+  const normalizedApiUrl = react.useMemo(
+    () => trimTrailingSlashes(symmCoreConfig.apiUrl),
+    [symmCoreConfig.apiUrl]
+  );
+  const normalizedWsUrl = react.useMemo(
+    () => symmCoreConfig.wsUrl ? trimTrailingSlashes(symmCoreConfig.wsUrl) : void 0,
+    [symmCoreConfig.wsUrl]
+  );
   const symmCoreClient = react.useMemo(() => {
     return symmCore.createSymmSDK({
-      apiUrl: symmCoreConfig.apiUrl,
-      wsUrl: symmCoreConfig.wsUrl,
+      apiUrl: normalizedApiUrl,
+      wsUrl: normalizedWsUrl,
       defaultChainId: chainId
     });
-  }, [chainId, symmCoreConfig.apiUrl, symmCoreConfig.wsUrl]);
+  }, [chainId, normalizedApiUrl, normalizedWsUrl]);
   const value = react.useMemo(
     () => ({
       symmCoreClient,
@@ -895,27 +906,116 @@ async function fetchAccessTokenEntry(walletClient, signerAddress, accountAddress
   writeStoredToken(accountAddress, chainId, cachedToken);
   return cachedToken;
 }
+function authStoreKey(accountAddress, chainId, signerAddress) {
+  return `${accountAddress}:${chainId}:${signerAddress ?? ""}`;
+}
+function getEntryFromSnapshot(state, accountAddress, chainId, signerAddress) {
+  const signerScoped = state.entries[authStoreKey(accountAddress, chainId, signerAddress)];
+  if (signerScoped) {
+    return signerScoped;
+  }
+  return state.entries[authStoreKey(accountAddress, chainId)] ?? null;
+}
+function getStatusFromSnapshot(state, accountAddress, chainId, signerAddress) {
+  const signerScoped = state.status[authStoreKey(accountAddress, chainId, signerAddress)];
+  if (signerScoped) {
+    return signerScoped;
+  }
+  return state.status[authStoreKey(accountAddress, chainId)] ?? {
+    error: null,
+    isLoading: false
+  };
+}
+var useSymmAuthStore = zustand.create((set) => ({
+  entries: {},
+  status: {},
+  setEntry: (accountAddress, chainId, signerAddress, entry) => set((state) => ({
+    entries: {
+      ...state.entries,
+      [authStoreKey(accountAddress, chainId, signerAddress)]: entry
+    },
+    status: {
+      ...state.status,
+      [authStoreKey(accountAddress, chainId, signerAddress)]: {
+        error: null,
+        isLoading: false
+      }
+    }
+  })),
+  clearEntry: (accountAddress, chainId, signerAddress) => set((state) => {
+    const nextEntries = { ...state.entries };
+    const nextStatus = { ...state.status };
+    delete nextEntries[authStoreKey(accountAddress, chainId, signerAddress)];
+    delete nextStatus[authStoreKey(accountAddress, chainId, signerAddress)];
+    return {
+      entries: nextEntries,
+      status: nextStatus
+    };
+  }),
+  setStatus: (accountAddress, chainId, signerAddress, status) => set((state) => ({
+    status: {
+      ...state.status,
+      [authStoreKey(accountAddress, chainId, signerAddress)]: {
+        error: null,
+        isLoading: false,
+        ...state.status[authStoreKey(accountAddress, chainId, signerAddress)],
+        ...status
+      }
+    }
+  })),
+  reset: () => set({
+    entries: {},
+    status: {}
+  })
+}));
+function getAuthStoreEntry(accountAddress, chainId, signerAddress) {
+  return getEntryFromSnapshot(
+    useSymmAuthStore.getState(),
+    accountAddress,
+    chainId,
+    signerAddress
+  );
+}
+function selectAuthStoreEntry(state, accountAddress, chainId, signerAddress) {
+  if (!accountAddress || chainId == null) {
+    return null;
+  }
+  return getEntryFromSnapshot(state, accountAddress, chainId, signerAddress);
+}
+function selectAuthStoreStatus(state, accountAddress, chainId, signerAddress) {
+  if (!accountAddress || chainId == null) {
+    return {
+      error: null,
+      isLoading: false
+    };
+  }
+  return getStatusFromSnapshot(state, accountAddress, chainId, signerAddress);
+}
+function setAuthStoreEntry(accountAddress, chainId, signerAddress, entry) {
+  useSymmAuthStore.getState().setEntry(accountAddress, chainId, signerAddress, entry);
+}
+function setAuthStoreStatus(accountAddress, chainId, signerAddress, status) {
+  useSymmAuthStore.getState().setStatus(accountAddress, chainId, signerAddress, status);
+}
+function clearAuthStoreEntry(accountAddress, chainId, signerAddress) {
+  useSymmAuthStore.getState().clearEntry(accountAddress, chainId, signerAddress);
+}
 
 // src/react/auth-cache.ts
-function getAuthQueryData(queryClient, accountAddress, chainId, signerAddress) {
-  return queryClient.getQueryData(
-    symmKeys.auth(accountAddress, chainId, signerAddress)
-  ) ?? null;
+function getAuthQueryData(accountAddress, chainId, signerAddress) {
+  return getAuthStoreEntry(accountAddress, chainId, signerAddress);
 }
-function setAuthQueryData(queryClient, accountAddress, chainId, signerAddress, entry) {
-  queryClient.setQueryData(symmKeys.auth(accountAddress, chainId, signerAddress), entry);
+function setAuthQueryData(accountAddress, chainId, signerAddress, entry) {
+  setAuthStoreEntry(accountAddress, chainId, signerAddress, entry);
 }
-function clearAuthQueryData(queryClient, accountAddress, chainId, signerAddress) {
-  queryClient.removeQueries({
-    queryKey: symmKeys.auth(accountAddress, chainId, signerAddress),
-    exact: true
-  });
+function clearAuthQueryData(accountAddress, chainId, signerAddress) {
+  clearAuthStoreEntry(accountAddress, chainId, signerAddress);
 }
 function clearPersistedAuthState(accountAddress, chainId) {
   clearCachedToken(accountAddress, chainId);
 }
-function getAuthTokenFromRuntimeCache(queryClient, accountAddress, chainId, signerAddress) {
-  const inQuery = getAuthQueryData(queryClient, accountAddress, chainId, signerAddress) ?? getAuthQueryData(queryClient, accountAddress, chainId);
+function getAuthTokenFromRuntimeCache(accountAddress, chainId, signerAddress) {
+  const inQuery = getAuthQueryData(accountAddress, chainId, signerAddress) ?? getAuthQueryData(accountAddress, chainId);
   if (inQuery && inQuery.expiresAt > Date.now()) {
     return inQuery.token;
   }
@@ -923,11 +1023,10 @@ function getAuthTokenFromRuntimeCache(queryClient, accountAddress, chainId, sign
   if (!persisted) {
     return null;
   }
-  setAuthQueryData(queryClient, accountAddress, chainId, signerAddress, persisted);
+  setAuthQueryData(accountAddress, chainId, signerAddress, persisted);
   return persisted.token;
 }
 async function resolveAuthTokenEntry({
-  queryClient,
   walletClient,
   signerAddress,
   accountAddress,
@@ -939,13 +1038,13 @@ async function resolveAuthTokenEntry({
     return null;
   }
   if (!force) {
-    const inQuery = getAuthQueryData(queryClient, accountAddress, chainId, signerAddress);
+    const inQuery = getAuthQueryData(accountAddress, chainId, signerAddress);
     if (inQuery && inQuery.expiresAt > Date.now()) {
       return inQuery;
     }
     const persisted = getCachedTokenEntry(accountAddress, chainId);
     if (persisted) {
-      setAuthQueryData(queryClient, accountAddress, chainId, signerAddress, persisted);
+      setAuthQueryData(accountAddress, chainId, signerAddress, persisted);
       return persisted;
     }
   }
@@ -956,25 +1055,33 @@ async function resolveAuthTokenEntry({
     chainId,
     siweDomain
   );
-  setAuthQueryData(queryClient, accountAddress, chainId, signerAddress, fresh);
+  setAuthQueryData(accountAddress, chainId, signerAddress, fresh);
   return fresh;
 }
-function clearAuthState(queryClient, accountAddress, chainId, signerAddress) {
+function clearAuthState(accountAddress, chainId, signerAddress) {
   clearPersistedAuthState(accountAddress, chainId);
-  clearAuthQueryData(queryClient, accountAddress, chainId, signerAddress);
+  clearAuthQueryData(accountAddress, chainId, signerAddress);
 }
 
 // src/react/hooks/use-symm-auth.ts
 function useSymmAuth(params) {
   const context = useSymmContext();
-  const queryClient = reactQuery.useQueryClient();
   const address = params?.address ?? context.address;
   const chainId = params?.chainId ?? context.chainId ?? 42161;
   const walletClient = params?.walletClient ?? context.walletClient;
   const siweDomain = params?.siweDomain;
   const activeAccountAddress = params?.activeAccountAddress;
-  const canBootstrap = !!walletClient && !!address && !!activeAccountAddress;
-  const refreshAuth = react.useCallback(
+  const authEntry = useSymmAuthStore(
+    (state) => selectAuthStoreEntry(state, activeAccountAddress, chainId, address)
+  );
+  useSymmAuthStore(
+    (state) => selectAuthStoreStatus(state, activeAccountAddress, chainId, address).isLoading
+  );
+  const error = useSymmAuthStore(
+    (state) => selectAuthStoreStatus(state, activeAccountAddress, chainId, address).error
+  );
+  const persistedEntry = !authEntry && activeAccountAddress ? getCachedTokenEntry(activeAccountAddress, chainId) : null;
+  const signIn = react.useCallback(
     async (accountAddress, options) => {
       const resolvedAccountAddress = accountAddress ?? activeAccountAddress;
       if (!resolvedAccountAddress) {
@@ -982,8 +1089,11 @@ function useSymmAuth(params) {
       }
       if (!walletClient || !address) return null;
       try {
-        const tokenEntry = await resolveAuthTokenEntry({
-          queryClient,
+        setAuthStoreStatus(resolvedAccountAddress, chainId, address, {
+          error: null,
+          isLoading: true
+        });
+        const tokenEntry2 = await resolveAuthTokenEntry({
           walletClient,
           signerAddress: address,
           accountAddress: resolvedAccountAddress,
@@ -991,10 +1101,16 @@ function useSymmAuth(params) {
           siweDomain,
           force: options?.force
         });
-        const token2 = tokenEntry?.token ?? null;
-        return token2;
-      } catch (error) {
-        clearPersistedAuthState(resolvedAccountAddress, chainId);
+        setAuthStoreStatus(resolvedAccountAddress, chainId, address, {
+          error: null,
+          isLoading: false
+        });
+        return tokenEntry2?.token ?? null;
+      } catch (error2) {
+        clearAuthState(resolvedAccountAddress, chainId, address);
+        setAuthStoreStatus(resolvedAccountAddress, chainId, address, {
+          error: error2 instanceof Error ? error2 : new Error("failed to sign in")
+        });
         return null;
       }
     },
@@ -1003,46 +1119,22 @@ function useSymmAuth(params) {
       address,
       activeAccountAddress,
       chainId,
-      siweDomain,
-      queryClient
+      siweDomain
     ]
   );
-  const authQuery = reactQuery.useQuery({
-    queryKey: symmKeys.auth(activeAccountAddress, chainId, address),
-    queryFn: async () => {
-      const tokenEntry = await resolveAuthTokenEntry({
-        queryClient,
-        walletClient,
-        signerAddress: address,
-        accountAddress: activeAccountAddress,
-        chainId,
-        siweDomain
-      });
-      if (!tokenEntry) {
-        return null;
-      }
-      return tokenEntry;
-    },
-    enabled: canBootstrap,
-    retry: false,
-    refetchOnWindowFocus: false,
-    refetchOnReconnect: false
-  });
   const clearAuth = react.useCallback(() => {
     if (activeAccountAddress) {
-      clearAuthState(queryClient, activeAccountAddress, chainId, address);
+      clearAuthState(activeAccountAddress, chainId, address);
     }
-  }, [activeAccountAddress, address, chainId, queryClient]);
-  const token = authQuery.data?.token ?? null;
+  }, [activeAccountAddress, address, chainId]);
+  const tokenEntry = authEntry ?? persistedEntry;
+  const token = tokenEntry?.token ?? null;
   return {
     accessToken: token,
-    authToken: token,
     isAuthenticated: !!token,
-    isLoading: authQuery.isLoading,
-    isFetching: authQuery.isFetching,
-    error: authQuery.error,
-    refresh: refreshAuth,
-    refreshAuth,
+    error,
+    signIn,
+    refreshAuth: signIn,
     clear: clearAuth
   };
 }
@@ -1846,7 +1938,6 @@ async function ensureInstantTradeReady(deps, queryClient, request) {
     throw new Error("at least one delegation selector is required");
   }
   const accessToken = getAuthTokenFromRuntimeCache(
-    queryClient,
     accountAddress,
     chainId,
     signerAddress
@@ -2256,7 +2347,6 @@ function splitTradeHookArgs(paramsOrOptions, options) {
 }
 function useResolveTradeAuthToken(params = {}) {
   const context = useSymmContext();
-  const queryClient = reactQuery.useQueryClient();
   const address = params.address ?? context.address;
   const chainId = params.chainId ?? context.chainId;
   return react.useCallback(
@@ -2270,7 +2360,6 @@ function useResolveTradeAuthToken(params = {}) {
         return null;
       }
       const inMemoryToken = getAuthTokenFromRuntimeCache(
-        queryClient,
         resolvedAccountAddress,
         resolvedChainId,
         address
@@ -2280,7 +2369,7 @@ function useResolveTradeAuthToken(params = {}) {
       }
       return null;
     },
-    [address, chainId, queryClient]
+    [address, chainId]
   );
 }
 
@@ -26242,7 +26331,6 @@ function useSymmPendingInstantOpens(params) {
     chainId: ctxChainId,
     address
   } = useSymmContext();
-  const queryClient = reactQuery.useQueryClient();
   const { accountAddress, authToken: providedAuthToken } = params;
   const chainId = params.chainId ?? ctxChainId;
   const internalEnabled = !!symmCoreClient && !!accountAddress;
@@ -26251,7 +26339,6 @@ function useSymmPendingInstantOpens(params) {
     queryKey: symmKeys.pendingInstantOpens(accountAddress, chainId),
     queryFn: async () => {
       const authToken = providedAuthToken ?? getAuthTokenFromRuntimeCache(
-        queryClient,
         accountAddress,
         chainId,
         address