MfaWebAuthnRoamingChallengeMembers

export interface MfaWebAuthnRoamingChallengeMembers extends BaseMembers {
  /**
   * Propriétés et données propres à l'écran, y compris les options de défi WebAuthn.
   * @type {ScreenMembersOnMfaWebAuthnRoamingChallenge}
   */
  screen: ScreenMembersOnMfaWebAuthnRoamingChallenge;

  /**
   * Lance le défi WebAuthn en appelant `navigator.credentials.get()` avec les
   * options fournies dans `screen.data.publicKeyChallengeOptions`.
   * En cas de succès, soumet les informations d'identification résultantes à Auth0 avec `action: "default"`.
   * Si `navigator.credentials.get()` échoue avec une erreur d'API WebAuthn connue (comme `NotAllowedError`),
   * cette méthode appellera `reportWebAuthnError` en interne pour en informer Auth0.
   *
   * @param {VerifySecurityKeyOptions} [options] - Paramètres facultatifs pour le processus de vérification,
   * tels que `rememberDevice` et d'autres options personnalisées.
   * @returns {Promise<void>} Une promesse qui se résout lorsque la tentative de vérification est soumise.
   *                          Elle ne retourne pas directement de données, car une opération réussie entraîne généralement une redirection.
   * @throws {Error} Génère une erreur si `screen.data.publicKeyChallengeOptions` est absent,
   *                 si `navigator.credentials.get()` échoue avec une erreur inattendue,
   *                 ou si la soumission du formulaire à Auth0 échoue.
   *
   * @example
   * ```typescript
   * // En supposant que 'sdk' est une instance de MfaWebAuthnRoamingChallenge
   * try {
   *   await sdk.verify({ rememberDevice: true });
   *   // En cas de succès, Auth0 gère la redirection.
   * } catch (error) {
   *   console.error("Échec de la vérification de la clé de sécurité :", error);
   *   // Vérifiez sdk.transaction.errors pour les messages de validation côté serveur si la page se recharge.
   * }
   * ```
   */
  verify(options?: VerifySecurityKeyOptions): Promise<void>;

  /**
   * Signale une erreur d'API WebAuthn spécifique à Auth0.
   * Cette méthode doit être utilisée si `navigator.credentials.get()` échoue d'une façon que
   * `verify()` ne gère pas automatiquement, ou si le développeur souhaite signaler explicitement
   * une erreur avant de tenter une autre action.
   * Elle soumet les détails de l'erreur avec `action: "showError::{errorDetails}"`.
   *
   * @param {ReportWebAuthnErrorOptions} options - Contient l'objet `error` avec `name` et `message`
   * provenant de l'API WebAuthn, ainsi que toute autre option personnalisée.
   * @returns {Promise<void>} Une promesse qui se résout lorsque le rapport d'erreur est soumis.
   * @throws {Error} Génère une erreur si la soumission du formulaire échoue.
   *
   * @example
   * ```typescript
   * // En supposant que 'sdk' est une instance de MfaWebAuthnRoamingChallenge
   * // Et que webAuthnError est un objet d'erreur provenant d'un appel échoué à navigator.credentials.get().
   * try {
   *   await sdk.reportWebAuthnError({
   *     error: { name: webAuthnError.name, message: webAuthnError.message }
   *   });
   * } catch (submitError) {
   *   console.error("Échec du signalement de l'erreur WebAuthn :", submitError);
   * }
   * ```
   */
  reportWebAuthnError(options: ReportWebAuthnErrorOptions): Promise<void>;

  /**
   * Permet à l'utilisateur de se soustraire au défi WebAuthn et de sélectionner une méthode d'AMF différente.
   * Cette action soumet `action: "pick-authenticator"` à Auth0, ce qui devrait diriger
   * l'utilisateur vers un écran de sélection de facteur d'AMF.
   *
   * @param {TryAnotherMethodOptions} [options] - Paramètres personnalisés facultatifs pour la requête.
   * @returns {Promise<void>} Une promesse qui se résout lorsque l'action est soumise.
   * @throws {Error} Génère une erreur si la soumission du formulaire échoue.
   *
   * @example
   * ```typescript
   * // En supposant que 'sdk' est une instance de MfaWebAuthnRoamingChallenge
   * try {
   *   await sdk.tryAnotherMethod();
   *   // En cas de succès, Auth0 gère la redirection vers la sélection d'AMF.
   * } catch (error) {
   *   console.error("Échec du changement de méthode d'AMF :", error);
   * }
   * ```
   */
  tryAnotherMethod(options?: TryAnotherMethodOptions): Promise<void>;
}