Struct UseReverification 

pub struct UseReverification { /* private fields */ }

Reactive handle returned by use_reverification, mirroring Clerk React’s useReverification.

The handle is Copy, so it can be captured into event handlers. Wrap a sensitive action with UseReverification::guard; if the action reports that step-up reverification is needed, clerk-js’s reverification UI is shown and the action resumes on success.

Implementations

impl UseReverification

pub async fn guard<T, F, Fut>(&self, action: F) -> Result<T, ClerkError>

where F: Fn() -> Fut, Fut: Future<Output = Result<T, ClerkError>>,

Run a sensitive action, guarding it with step-up reverification.

action is the gated call. Typically it is a #[server] function that maps a clerk reverification hint onto ClerkError::NeedsReverification via ClerkError::from_reverification_hint; an action calling clerk-js directly instead constructs that variant from its own caught throw. When action reports that reverification is needed, clerk-js prompts the user for a fresh factor and action is retried on success. action may therefore run twice, so it takes no arguments and is invoked fresh each time.

• action succeeds → its value
• action needs reverification, user completes it → the retry’s result
• action needs reverification, user cancels → ClerkError::ReverificationCancelled
• any other action error → propagated unchanged

Example

use dioxus::prelude::*;
use dioxus_clerk::*;

#[component]
fn DangerZone() -> Element {
    let reverify = use_reverification();

    rsx! {
        button {
            onclick: move |_| async move {
                let _ = reverify.guard(|| delete_account()).await;
            },
            "Delete account"
        }
    }
}

Trait Implementations

impl Clone for UseReverification

fn clone(&self) -> UseReverification

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for UseReverification

impl Debug for UseReverification

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.