@privy-io/react-auth 3.23.1 → 3.24.0-snapshot-20260512163502

package/dist/dts/events-context-C317AaBW.d.ts

@@ -1,328 +0,0 @@
-import { Chain } from '@privy-io/js-sdk-core';
-import { P as PrivyErrorCode, U as User, L as LoginMethod, a as LinkedAccountWithMetadata, B as BaseConnectedEthereumWallet, b as BaseConnectedSolanaWallet, W as Wallet, M as MfaMethod, c as UserRecoveryMethod, O as OAuthTokens, F as FundingMethod, S as SolanaChain } from './types-DGtFUGql.js';
-
-/**
- * `CallbackError` optionally includes a second parameter with further error details.
- */
-type CallbackError<Details extends Record<string, any> | undefined = undefined> = Details extends Record<string, any> ? (error: PrivyErrorCode, details: Details) => void : (error: PrivyErrorCode) => void;
-interface PrivyEvents {
-    login: {
-        /**
-         * Callback that will execute once a `login` flow successfully completes.
-         * - If `config.embeddedWallets.createOnLogin` is set to 'off' or a wallet creation flow is not applicable,
-         *   this will run after the user successfully authenticates.
-         * - If `config.embeddedWallets.createOnLogin` is set to 'users-without-wallets' or 'all-users',
-         *   this will run after the user successfully authenticates _and_ creates their wallet (if applicable).
-         * - If a user is already authenticated, this will run immediately and the `wasAlreadyAuthenticated` flag will be set to `true`.
-         *
-         * @param params.user {@link User} the `user` oject corresponding to the authenticated user
-         * @param params.isNewUser {boolean} boolean flag indicating if this is the user's first time logging in to your app
-         * @param params.wasAlreadyAuthenticated {boolean} - boolean flag indicating whether the user entered the application already authenticated
-         * @param params.loginMethod {string} - the method used by the user to login
-         * @param params.loginAccount - the account corresponding to the loginMethod used
-         */
-        onComplete?: (params: {
-            user: User;
-            isNewUser: boolean;
-            wasAlreadyAuthenticated: boolean;
-            loginMethod: LoginMethod | null;
-            loginAccount: LinkedAccountWithMetadata | null;
-        }) => void;
-        /**
-         * Callback that will execute in the case of a non-successful login.
-         *
-         * @param error {@link PrivyErrorCode} - the corresponding error code
-         */
-        onError?: CallbackError;
-    };
-    logout: {
-        /**
-         * Callback that will execute when a user successfully logs out.
-         */
-        onSuccess?: () => void;
-    };
-    connectWallet: {
-        /**
-         * Callback that will execute once a successful `connectWallet` completes.
-         * This will not run in the case of a wallet-based authentication or link flow.
-         *
-         * @param params.wallet {@link BaseConnectedEthereumWallet | BaseConnectedSolanaWallet} the `wallet` object correspending to the connection
-         */
-        onSuccess?: (params: {
-            wallet: BaseConnectedEthereumWallet | BaseConnectedSolanaWallet;
-        }) => void;
-        /**
-         * Callback that will execute in the case of a non-successful wallet connection.
-         *
-         * @param params.error {@link PrivyErrorCode} - the corresponding error code
-         */
-        onError?: CallbackError;
-    };
-    connectOrCreateWallet: {
-        /**
-         * Callback that will execute once a successful `connectWallet` completes.
-         * This will not run in the case of a wallet-based authentication or link flow.
-         *
-         * @param params.wallet {@link BaseConnectedEthereumWallet | BaseConnectedSolanaWallet} the `wallet` object correspending to the connection
-         */
-        onSuccess?: (params: {
-            wallet: BaseConnectedEthereumWallet | BaseConnectedSolanaWallet;
-        }) => void;
-        /**
-         * Callback that will execute in the case of a non-successful wallet connection.
-         *
-         * @param params.error {@link PrivyErrorCode} - the corresponding error code
-         */
-        onError?: CallbackError;
-    };
-    createWallet: {
-        /**
-         * Callback that will execute once on a successful embedded wallet creation.
-         * This will run when `createWallet` is called manually, or when `config.embeddedWallets.createOnLogin` triggers
-         * an automatic wallet creation.
-         *
-         * @param params.wallet {@link BaseConnectedWallet}- the created `wallet` object
-         */
-        onSuccess?: (params: {
-            wallet: Wallet;
-        }) => void;
-        /**
-         * Callback that will execute in the case of a non-successful wallet creation.
-         *
-         * @param params.error {@link PrivyErrorCode} - the corresponding error code
-         */
-        onError?: CallbackError;
-    };
-    linkAccount: {
-        /**
-         * Callback that will execute once on a successful linking of a new account/login method.
-         * This will run when any of the 'link' methods are called manually.
-         * @param params.user {@link User}- the user the account was linked to
-         * @param params.linkMethod {@link LoginMethod}- the type of linked account
-         * @param params.linkedAccount - the newly linked account
-         */
-        onSuccess?: (params: {
-            user: User;
-            linkMethod: LoginMethod;
-            linkedAccount: LinkedAccountWithMetadata;
-        }) => void;
-        /**
-         * Callback that will execute in the case of a non-successful account linking.
-         *
-         * @param error {PrivyErrorCode} - the corresponding error code
-         * @param details.linkMethod {LoginMethod} - the type of (attempted) linked account
-         */
-        onError?: CallbackError<{
-            linkMethod: LoginMethod;
-        }>;
-    };
-    update: {
-        /**
-         * Callback that will execute once on a successful updating of an account.
-         * This will run when any of the 'updateAccount' methods are called manually.
-         * @param params.user {@link User}- the user the account was linked to
-         * @param params.updateMethod {@link LoginMethod}- the type of updated account
-         * @param params.updatedAccount - the newly updated account
-         */
-        onSuccess?: (params: {
-            user: User;
-            updateMethod: LoginMethod;
-            updatedAccount: LinkedAccountWithMetadata;
-        }) => void;
-        /**
-         * Callback that will execute in the case of a non-successful account linking.
-         *
-         * @param error {PrivyErrorCode} - the corresponding error code
-         * @param details.linkMethod {LoginMethod} - the type of (attempted) linked account
-         */
-        onError?: CallbackError<{
-            linkMethod: LoginMethod;
-        }>;
-    };
-    configureMfa: {
-        /**
-         * Callback that will execute when MFA is required to complete a given action.
-         * @param params.mfaMethods {@link MfaMethod[]} - List of MFA methods that the user can choose from
-         */
-        onMfaRequired: (params: {
-            mfaMethods: MfaMethod[];
-        }) => void;
-    };
-    setWalletPassword: {
-        /**
-         * Callback that will execute once a successful `setWalletPassword` completes.
-         * @param params.wallet {@link Wallet}- the `wallet` object that the password was set for
-         */
-        onSuccess?: (params: {
-            wallet: Wallet;
-        }) => void;
-        /**
-         * Callback that will execute in the case of a non-successful setWalletPassword.
-         *
-         * @param params.error {PrivyErrorCode} - the corresponding error code
-         */
-        onError?: CallbackError;
-    };
-    setWalletRecovery: {
-        /**
-         * Callback that will execute once a successful `setWalletRecovery` completes.
-         * @param params.method {@link UserRecoveryMethod} - the recovery method that was set
-         * @param params.wallet {@link Wallet}- the wallet object that the recovery was set for
-         */
-        onSuccess?: (params: {
-            method: UserRecoveryMethod;
-            wallet: Wallet;
-        }) => void;
-        /**
-         * Callback that will execute in the case of a non-successful setWalletRecovery.
-         *
-         * @param params.error {PrivyErrorCode} - the corresponding error code
-         */
-        onError?: CallbackError;
-    };
-    signMessage: {
-        /**
-         * Callback that will execute once a successful `signMessage` completes.
-         * This will not run in the case of a wallet-based authentication or link flow.
-         * @param params.signature - the signature (type string) of the embedded wallet used to sign message
-         */
-        onSuccess?: (params: {
-            signature: string;
-        }) => void;
-        /**
-         * Callback that will execute in the case of a non-successful signMessage.
-         *
-         * @param params.error {@link PrivyErrorCode} - the corresponding error code
-         */
-        onError?: CallbackError;
-    };
-    signTypedData: {
-        /**
-         * Callback that will execute once a successful `signTypedData` completes.
-         * @param params.signature - the signature (type string) of the embedded wallet used to sign
-         */
-        onSuccess?: (params: {
-            signature: string;
-        }) => void;
-        /**
-         * Callback that will execute in the case of a non-successful signTypedData.
-         *
-         * @param params.error {@link PrivyErrorCode} - the corresponding error code
-         */
-        onError?: CallbackError;
-    };
-    sendTransaction: {
-        /**
-         * Callback that will execute once a successful `sendTransaction` completes.
-         * This will not run for transactions with external wallets.
-         * @param an object with the transaction hash
-         */
-        onSuccess?: (params: {
-            hash: `0x${string}`;
-        }) => void;
-        /**
-         * Callback that will execute in the case of a non-successful sendTransaction.
-         *
-         * @param params.error {@link PrivyErrorCode} - the corresponding error code
-         */
-        onError?: CallbackError;
-    };
-    signTransaction: {
-        /**
-         * Callback that will execute once a successful `signTransaction` completes.
-         * This will not run for transactions with external wallets.
-         * @param an object with the transaction signature
-         */
-        onSuccess?: (params: {
-            signature: `0x${string}`;
-        }) => void;
-        /**
-         * Callback that will execute in the case of a non-successful signTransaction.
-         *
-         * @param params.error {@link PrivyErrorCode} - the corresponding error code
-         */
-        onError?: CallbackError;
-    };
-    accessToken: {
-        /**
-         * Callback that will execute when a user's access token is granted.
-         * @param params.accessToken - The user's access token
-         */
-        onAccessTokenGranted: (params: {
-            accessToken: string;
-        }) => void;
-        /**
-         * Callback that will execute when a user's access token is removed.
-         */
-        onAccessTokenRemoved: () => void;
-    };
-    oAuthAuthorization: {
-        /**
-         * Callback that will execute when a user successfully authorizes an OAuth flow.
-         *
-         * @param params.oAuthTokens {@link OAuthTokens} - the OAuth tokens returned from the OAuth provider:
-         * @param params.oAuthTokens.provider - {string}  The OAuth provider type.
-         * @param params.oAuthTokens.accessToken - {string} The OAuth access token.
-         * @param params.oAuthTokens.accessTokenExpiresInSeconds - {number} (optional) The number of seconds until the OAuth access token expires.
-         * @param params.oAuthTokens.refreshToken - {string} (optional) The OAuth refresh token.
-         * @param params.oAuthTokens.refreshTokenExpiresInSeconds - {number} (optional) The number of seconds until the OAuth refresh token expires.
-         * if the refresh token is present and this field is undefined, it is assumed
-         * that the refresh token does not have an expiration date.
-         * @param params.oAuthTokens.scopes -  {string[]} (optional) The list of OAuth scopes the access token is approved for.
-         *
-         * @param params.user {@link User} The authenticated user
-         */
-        onOAuthTokenGrant: (params: {
-            oAuthTokens: OAuthTokens;
-            user: User;
-        }) => void;
-    };
-    fundWallet: {
-        /**
-         * Callback that will execute when a funding flow is exited. This fires when a user closes a funding flow modal, for any reason.
-         *
-         * @param params.address {string} The address of the wallet being funded
-         * @param params.chain {Chain} The chain of the wallet being funded
-         * @param params.fundingMethod {@link FundingMethod} The funding method associated with the flow at time of exit. If the user had not yet selected
-         * a recovery method, this will be null.
-         * @param params.balance {bigint} The value for the funded wallet at the point of user exit.
-         */
-        onUserExited?: (params: {
-            address: string;
-            chain: Chain;
-            fundingMethod: FundingMethod | 'manual' | null;
-            balance: bigint | undefined;
-        }) => void;
-    };
-    fundSolanaWallet: {
-        /**
-         * Callback that will execute when a funding flow is exited. This fires when a user closes a funding flow modal, for any reason.
-         *
-         * @param params.address {string} The address of the wallet being funded
-         * @param params.fundingMethod {@link FundingMethod} The funding method associated with the flow at time of exit. If the user had not yet selected
-         * a recovery method, this will be null.
-         * @param params.balance {bigint} The value for the funded wallet at the point of user exit.
-         */
-        onUserExited?: (params: {
-            address: string;
-            fundingMethod: FundingMethod | 'manual' | null;
-            chain: SolanaChain;
-            balance: bigint | undefined;
-        }) => void;
-    };
-    customAuth: {
-        /**
-         * Callback that will execute when Privy successfully exchanges a custom auth JWT for a Privy JWT
-         * @param params.user - The Privy user
-         */
-        onAuthenticated: (params: {
-            user: User;
-        }) => void;
-        /**
-         * Callback that will execute when Privy detects a user is logged out from the third-party auth system, and correspondingly logs the user out.
-         */
-        onUnauthenticated: () => void;
-    };
-}
-
-export type { CallbackError as C, PrivyEvents as P };