@use-glyph/sdk-react 2.1.11 → 2.2.0

package/dist/types/components/ui/drawer.d.ts

@@ -1,18 +1,16 @@
-import { default as react, ComponentProps, HTMLAttributes, PropsWithChildren } from 'react';
+import { default as react, ComponentProps, ComponentPropsWithoutRef, ComponentRef, HTMLAttributes, PropsWithChildren } from 'react';
 import { Drawer as DrawerPrimitive } from 'vaul';
 declare const Drawer: ({ shouldScaleBackground, repositionInputs, ...props }: ComponentProps<typeof DrawerPrimitive.Root>) => import("react/jsx-runtime").JSX.Element;
-declare const DrawerTrigger: react.ForwardRefExoticComponent<import('@radix-ui/react-dialog').DialogTriggerProps & react.RefAttributes<HTMLButtonElement>>;
+declare const DrawerTrigger: typeof DrawerPrimitive.Trigger;
 declare const DrawerPortal: react.FC<PropsWithChildren>;
-declare const DrawerClose: react.ForwardRefExoticComponent<import('@radix-ui/react-dialog').DialogCloseProps & react.RefAttributes<HTMLButtonElement>>;
-declare const DrawerHandle: react.ForwardRefExoticComponent<Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & {
-    preventCycle?: boolean | undefined;
-} & react.RefAttributes<HTMLDivElement>>;
-declare const DrawerOverlay: react.ForwardRefExoticComponent<Omit<Omit<import('@radix-ui/react-dialog').DialogOverlayProps & react.RefAttributes<HTMLDivElement>, "ref"> & react.RefAttributes<HTMLDivElement>, "ref"> & react.RefAttributes<HTMLDivElement>>;
-declare const DrawerContent: react.ForwardRefExoticComponent<Omit<Omit<import('@radix-ui/react-dialog').DialogContentProps & react.RefAttributes<HTMLDivElement>, "ref"> & react.RefAttributes<HTMLDivElement>, "ref"> & {
+declare const DrawerClose: typeof DrawerPrimitive.Close;
+declare const DrawerHandle: typeof DrawerPrimitive.Handle;
+declare const DrawerOverlay: react.ForwardRefExoticComponent<ComponentPropsWithoutRef<typeof DrawerPrimitive.Overlay> & react.RefAttributes<ComponentRef<typeof DrawerPrimitive.Overlay>>>;
+declare const DrawerContent: react.ForwardRefExoticComponent<ComponentPropsWithoutRef<typeof DrawerPrimitive.Content> & {
     childrenWrapperClassName?: string;
-} & react.RefAttributes<HTMLDivElement>>;
+} & react.RefAttributes<ComponentRef<typeof DrawerPrimitive.Content>>>;
 declare const DrawerHeader: ({ className, ...props }: HTMLAttributes<HTMLDivElement>) => import("react/jsx-runtime").JSX.Element;
 declare const DrawerFooter: ({ className, ...props }: HTMLAttributes<HTMLDivElement>) => import("react/jsx-runtime").JSX.Element;
-declare const DrawerTitle: react.ForwardRefExoticComponent<Omit<import('@radix-ui/react-dialog').DialogTitleProps & react.RefAttributes<HTMLHeadingElement>, "ref"> & react.RefAttributes<HTMLHeadingElement>>;
-declare const DrawerDescription: react.ForwardRefExoticComponent<Omit<import('@radix-ui/react-dialog').DialogDescriptionProps & react.RefAttributes<HTMLParagraphElement>, "ref"> & react.RefAttributes<HTMLParagraphElement>>;
+declare const DrawerTitle: react.ForwardRefExoticComponent<ComponentPropsWithoutRef<typeof DrawerPrimitive.Title> & react.RefAttributes<ComponentRef<typeof DrawerPrimitive.Title>>>;
+declare const DrawerDescription: react.ForwardRefExoticComponent<ComponentPropsWithoutRef<typeof DrawerPrimitive.Description> & react.RefAttributes<ComponentRef<typeof DrawerPrimitive.Description>>>;
 export { Drawer, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHandle, DrawerHeader, DrawerOverlay, DrawerPortal, DrawerTitle, DrawerTrigger };

package/dist/types/context/glyphDataQuery.d.ts

@@ -0,0 +1,11 @@
+import { GlyphApiFetch } from './GlyphContext';
+export type ScopedGlyphData<T> = {
+    scope: string;
+    value: T;
+};
+export declare class GlyphDataRequestError extends Error {
+    readonly status: number;
+    constructor(status: number);
+}
+export declare function fetchScopedGlyphData<T>(apiFetch: GlyphApiFetch | null, path: string, signal: AbortSignal, isCurrent: () => boolean, scope: string): Promise<ScopedGlyphData<T>>;
+export declare function shouldRetryGlyphData(error: Error, failureCount: number, limit: number): boolean;

package/dist/types/context/strategies/privyWallet.d.ts

@@ -0,0 +1,11 @@
+import { User } from '@privy-io/react-auth';
+/** Select supported EVM signers, preserving Glyph > other cross-app > native precedence. */
+export declare function selectPrivyWallet(user: User | null, glyphAppId?: string): {
+    address: string;
+    usesCrossapp: boolean;
+    providerAppId: string;
+} | {
+    address: string;
+    usesCrossapp: boolean;
+    providerAppId: null;
+} | null;

package/dist/types/hooks/useBalancesForChain.d.ts

@@ -1,2 +1,2 @@
 import { GlyphWidgetBalances } from '../types';
-export declare function useBalancesForChain(chainId?: number | "all"): import('@tanstack/react-query').UseQueryResult<GlyphWidgetBalances | null, Error>;
+export declare function useBalancesForChain(chainId?: number | "all"): import('@tanstack/react-query').UseQueryResult<NoInfer<GlyphWidgetBalances | null>, Error>;

package/dist/types/hooks/useGlyph.d.ts

@@ -1,5 +1,5 @@
 import { SignTypedDataParams, UnsignedTransactionRequest } from '@privy-io/react-auth';
-import { GlyphWidgetBalances, GlyphWidgetUser } from '../types';
+import { GlyphAuthError, GlyphWidgetBalances, GlyphWidgetUser } from '../types';
 export interface GlyphInterface {
     /**
      * Check whether the `GlyphContext` is ready to be used. You should wait for this to
@@ -27,6 +27,10 @@ export interface GlyphInterface {
         transaction: UnsignedTransactionRequest;
     }) => Promise<string>;
     login: () => void;
+    /** Retry wallet authentication from a fresh click. False means deferred or failed. */
+    signIn: () => Promise<boolean>;
+    needsSignature: boolean;
+    authError: GlyphAuthError | null;
     logout: () => void;
     /**
      * The base URL for the Glyph Widget API (optional, uses default DASHBOARD_BASE_URL from envs if not provided)

package/dist/types/hooks/useRelayQuote.d.ts

@@ -5,7 +5,7 @@ export declare const checkIfGasIsEnough: (gasCurrencyAddress: string, sourceToke
 export declare const useRelayQuote: (enabled?: boolean) => {
     appFeesWaived: boolean;
     operation: string;
-    data: Execute;
+    data: NoInfer<Execute>;
     error: Error;
     isError: true;
     isPending: false;
@@ -28,13 +28,13 @@ export declare const useRelayQuote: (enabled?: boolean) => {
     isRefetching: boolean;
     isStale: boolean;
     isEnabled: boolean;
-    refetch: (options?: import('@tanstack/react-query').RefetchOptions) => Promise<import('@tanstack/react-query').QueryObserverResult<Execute, Error>>;
+    refetch: (options?: import('@tanstack/react-query').RefetchOptions) => Promise<import('@tanstack/react-query').QueryObserverResult<NoInfer<Execute>, Error>>;
     fetchStatus: import('@tanstack/react-query').FetchStatus;
-    promise: Promise<Execute>;
+    promise: Promise<NoInfer<Execute>>;
 } | {
     appFeesWaived: boolean;
     operation: string;
-    data: Execute;
+    data: NoInfer<Execute>;
     error: null;
     isError: false;
     isPending: false;
@@ -57,9 +57,9 @@ export declare const useRelayQuote: (enabled?: boolean) => {
     isRefetching: boolean;
     isStale: boolean;
     isEnabled: boolean;
-    refetch: (options?: import('@tanstack/react-query').RefetchOptions) => Promise<import('@tanstack/react-query').QueryObserverResult<Execute, Error>>;
+    refetch: (options?: import('@tanstack/react-query').RefetchOptions) => Promise<import('@tanstack/react-query').QueryObserverResult<NoInfer<Execute>, Error>>;
     fetchStatus: import('@tanstack/react-query').FetchStatus;
-    promise: Promise<Execute>;
+    promise: Promise<NoInfer<Execute>>;
 } | {
     appFeesWaived: boolean;
     operation: string;
@@ -86,9 +86,9 @@ export declare const useRelayQuote: (enabled?: boolean) => {
     isRefetching: boolean;
     isStale: boolean;
     isEnabled: boolean;
-    refetch: (options?: import('@tanstack/react-query').RefetchOptions) => Promise<import('@tanstack/react-query').QueryObserverResult<Execute, Error>>;
+    refetch: (options?: import('@tanstack/react-query').RefetchOptions) => Promise<import('@tanstack/react-query').QueryObserverResult<NoInfer<Execute>, Error>>;
     fetchStatus: import('@tanstack/react-query').FetchStatus;
-    promise: Promise<Execute>;
+    promise: Promise<NoInfer<Execute>>;
 } | {
     appFeesWaived: boolean;
     operation: string;
@@ -115,9 +115,9 @@ export declare const useRelayQuote: (enabled?: boolean) => {
     isRefetching: boolean;
     isStale: boolean;
     isEnabled: boolean;
-    refetch: (options?: import('@tanstack/react-query').RefetchOptions) => Promise<import('@tanstack/react-query').QueryObserverResult<Execute, Error>>;
+    refetch: (options?: import('@tanstack/react-query').RefetchOptions) => Promise<import('@tanstack/react-query').QueryObserverResult<NoInfer<Execute>, Error>>;
     fetchStatus: import('@tanstack/react-query').FetchStatus;
-    promise: Promise<Execute>;
+    promise: Promise<NoInfer<Execute>>;
 } | {
     appFeesWaived: boolean;
     operation: string;
@@ -144,13 +144,13 @@ export declare const useRelayQuote: (enabled?: boolean) => {
     isRefetching: boolean;
     isStale: boolean;
     isEnabled: boolean;
-    refetch: (options?: import('@tanstack/react-query').RefetchOptions) => Promise<import('@tanstack/react-query').QueryObserverResult<Execute, Error>>;
+    refetch: (options?: import('@tanstack/react-query').RefetchOptions) => Promise<import('@tanstack/react-query').QueryObserverResult<NoInfer<Execute>, Error>>;
     fetchStatus: import('@tanstack/react-query').FetchStatus;
-    promise: Promise<Execute>;
+    promise: Promise<NoInfer<Execute>>;
 } | {
     appFeesWaived: boolean;
     operation: string;
-    data: Execute;
+    data: NoInfer<Execute>;
     isError: false;
     error: null;
     isPending: false;
@@ -173,7 +173,7 @@ export declare const useRelayQuote: (enabled?: boolean) => {
     isRefetching: boolean;
     isStale: boolean;
     isEnabled: boolean;
-    refetch: (options?: import('@tanstack/react-query').RefetchOptions) => Promise<import('@tanstack/react-query').QueryObserverResult<Execute, Error>>;
+    refetch: (options?: import('@tanstack/react-query').RefetchOptions) => Promise<import('@tanstack/react-query').QueryObserverResult<NoInfer<Execute>, Error>>;
     fetchStatus: import('@tanstack/react-query').FetchStatus;
-    promise: Promise<Execute>;
+    promise: Promise<NoInfer<Execute>>;
 };

package/dist/types/hooks/useRelayTokenList.d.ts

@@ -7,7 +7,7 @@ export type GetCurrenciesResponse = paths["/currencies/v2"]["post"]["responses"]
 type QueryType = typeof useQuery<GetCurrenciesResponse, DefaultError, GetCurrenciesResponse, QueryKey>;
 type QueryOptions = Parameters<QueryType>["0"];
 export declare const queryTokenList: (options?: GetCurrenciesBody, headers?: Record<string, string>) => Promise<GetCurrenciesResponse>;
-export default function (options?: GetCurrenciesBody, queryOptions?: Partial<QueryOptions>): Omit<import('@tanstack/react-query').UseQueryResult<{
+export default function (options?: GetCurrenciesBody, queryOptions?: Partial<QueryOptions>): Omit<import('@tanstack/react-query').UseQueryResult<NoInfer<{
     chainId?: number;
     address?: string;
     symbol?: string;
@@ -19,7 +19,7 @@ export default function (options?: GetCurrenciesBody, queryOptions?: Partial<Que
         verified?: boolean;
         isNative?: boolean;
     };
-}[], Error>, "data"> & {
+}[]>, Error>, "data"> & {
     data?: GetCurrenciesResponse;
 };
 export {};

package/dist/types/index.d.ts

@@ -16,7 +16,7 @@ export { useGlyphTokenGate, useGlyphOwnershipCheck, type GlyphOwnershipCheckRequ
 export { useGlyphView } from './hooks/useGlyphView';
 export { glyphConnectorDetails } from './lib/constants';
 export { GlyphViewType as GlyphView, StrategyType, WalletClientType } from './types';
-export type { GlyphWidgetUser } from './types';
+export type { GlyphWidgetUser, GlyphAuthError, GlyphAuthErrorReason } from './types';
 export { GlyphProvider, GlyphWidget, LoginButton, LogoutButton, SignUpButton, Wallet, ChainSelector };
 export { NativeGlyphConnectButton } from './components/NativeGlyphConnectButton';
 export { useNativeGlyphConnection } from './hooks/useNativeGlyphConnection';

package/dist/types/lib/rpcPublic.d.ts

@@ -0,0 +1,5 @@
+import { PublicClient } from 'viem';
+/**
+ * Intended primarily for client-side code. Could be used as a fallback on server-side code, but bear in mind we could be rate-limited.
+ */
+export declare function createDefaultPublicClient(chainId: number): PublicClient;

package/dist/types/lib/walletAuth.d.ts

@@ -0,0 +1,15 @@
+import { GlyphAuthError, GlyphAuthErrorReason } from '../types';
+export declare class WalletAuthFailure extends Error {
+    readonly reason: GlyphAuthErrorReason;
+    readonly retryAfterMs?: number | undefined;
+    constructor(reason: GlyphAuthErrorReason, message: string, retryAfterMs?: number | undefined);
+}
+export declare function walletAuthOrigin(value: string): string | null;
+export declare function hasWalletActivation(): boolean;
+export declare function signingFailure(error: unknown): WalletAuthFailure;
+export declare function fetchWalletMessage(origin: string, address: string, signal: AbortSignal): Promise<{
+    message: string;
+    nonce: string;
+}>;
+export declare function verifyWalletSignature(origin: string, address: string, signature: string, nonce: string, signal: AbortSignal): Promise<string>;
+export declare function publicAuthError(error: unknown): GlyphAuthError;

package/dist/types/lib/walletAuthSession.d.ts

@@ -0,0 +1,36 @@
+import { GlyphApiFetch } from '../context/GlyphContext';
+import { GlyphAuthError } from '../types';
+type Snapshot = {
+    generation: number;
+    ready: boolean;
+    authenticated: boolean;
+    needsSignature: boolean;
+    authError: GlyphAuthError | null;
+    apiFetch: GlyphApiFetch | null;
+};
+type Options = {
+    address: string;
+    origin: string;
+    /** Stable connector family; runtime instance identity is fenced by isCurrent. */
+    connector: string;
+    popup: boolean;
+    isCurrent: () => boolean;
+    sign: (message: string) => Promise<string>;
+    onLogin: () => void;
+    onAuthError: (error: GlyphAuthError) => void;
+    storage?: Pick<Storage, "getItem" | "setItem" | "removeItem">;
+    activation?: () => boolean;
+};
+/** One mounted wallet/origin/connector capability. No async result can change another generation. */
+export declare function createWalletAuthSession(options: Options): {
+    subscribe(listener: () => void): () => void;
+    getSnapshot: () => Readonly<Snapshot>;
+    current: (generation?: number) => boolean;
+    signIn: (generation: number) => Promise<boolean>;
+    automatic(): void;
+    start(): void;
+    stop(forget?: boolean): void;
+    logout(): void;
+    forget(): void;
+};
+export {};

package/dist/types/types/GlyphWidgetTypes.d.ts

@@ -29,11 +29,19 @@ export declare const GlyphViewType: {
     readonly OPEN: "open";
 };
 export type GlyphViewType = (typeof GlyphViewType)[keyof typeof GlyphViewType];
+export type GlyphAuthErrorReason = "popup_blocked" | "rejected" | "verify_failed" | "network";
+/** Static, credential-free failure information. No raw provider causes are exposed. */
+export type GlyphAuthError = {
+    reason: GlyphAuthErrorReason;
+    message: string;
+    retryAt?: number;
+};
 export interface BaseGlyphProviderOptions extends PropsWithChildren {
     glyphUrl?: string;
     useStagingTenant?: boolean;
     onLogin?: () => void;
     onLogout?: () => void;
+    onAuthError?: (error: GlyphAuthError) => void;
     /**
      * Optional per-chain RPC override. Maps a chainId to a single RPC URL or an array of URLs
      * (used as a viem `fallback` transport). Chains without an entry keep the default RPC
@@ -119,7 +127,8 @@ export type GlyphWidgetProps = {
 };
 export type GlyphWidgetUser = {
     hasProfile: boolean;
-    id: string;
+    /** Legacy field; the current widget user API does not return an id. */
+    id?: string;
     name: string;
     picture: string;
     evmWallet: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@use-glyph/sdk-react",
-  "version": "2.1.11",
+  "version": "2.2.0",
   "type": "module",
   "license": "GLYPH-1.0",
   "sideEffects": false,
@@ -29,6 +29,17 @@
     "README.md"
   ],
   "devDependencies": {
+    "@privy-io/cross-app-connect": "0.7.3",
+    "@privy-io/react-auth": "3.48.1",
+    "@privy-io/wagmi": "4.0.19",
+    "@rainbow-me/rainbowkit": "2.2.11",
+    "@tanstack/react-query": "5.101.1",
+    "@types/react": "19.1.1",
+    "@types/react-dom": "19.1.1",
+    "react": "19.1.3",
+    "react-dom": "19.1.3",
+    "viem": "2.57.5",
+    "wagmi": "2.19.5",
     "@eslint/js": "^9.34.0",
     "@types/node": "^24.3.0",
     "@vitejs/plugin-react": "^5.0.2",
@@ -48,21 +59,21 @@
     "tailwindcss-animate": "^1.0.7",
     "typescript": "~5.9.3",
     "typescript-eslint": "^8.41.0",
-    "vite": "7.1.3",
+    "vite": "7.3.7",
     "vite-plugin-dts": "^4.5.4"
   },
   "peerDependencies": {
-    "@privy-io/cross-app-connect": ">=0.2.1",
-    "@privy-io/react-auth": ">=3.9.0",
-    "@privy-io/wagmi": ">=2.0.0",
-    "@rainbow-me/rainbowkit": ">=2.2.8",
-    "@tanstack/react-query": ">=5.76.0",
+    "@privy-io/cross-app-connect": ">=0.2.1 <0.8",
+    "@privy-io/react-auth": ">=3.14.1 <3.49.0",
+    "@privy-io/wagmi": ">=4.0.19 <5",
+    "@rainbow-me/rainbowkit": ">=2.2.11 <3",
+    "@tanstack/react-query": ">=5.76.0 <6",
     "@types/react": "^18.x || ^19.x",
     "@types/react-dom": "^18.x || ^19.x",
     "react": "^18.x || ^19.x",
     "react-dom": "^18.x || ^19.x",
-    "viem": ">=2.30.0",
-    "wagmi": ">=2.10.0"
+    "viem": ">=2.57.5 <3",
+    "wagmi": ">=2.19.5 <3"
   },
   "dependencies": {
     "@radix-ui/react-accordion": "^1.2.12",
@@ -70,7 +81,7 @@
     "@radix-ui/react-popover": "^1.1.15",
     "@radix-ui/react-slot": "^1.2.3",
     "@radix-ui/react-tooltip": "1.2.8",
-    "@relayprotocol/relay-sdk": "3.1.0",
+    "@relayprotocol/relay-sdk": "3.2.0",
     "@types/throttle-debounce": "5.0.2",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",