signInWithOtp method

Future<AuthEmailOtpSignInResult> signInWithOtp({
  1. required TContext context,
  2. required String email,
  3. required String code,
  4. String? name,
  5. String? image,
  6. DateTime? now,
})

Consumes an OTP and signs in or creates its verified user.

When disableSignUp is true, an unknown email maps to user_not_found. Invalid, expired, and locked codes throw AuthFlowException.

Implementation

Future<AuthEmailOtpSignInResult> signInWithOtp({
  required TContext context,
  required String email,
  required String code,
  String? name,
  String? image,
  DateTime? now,
}) async {
  _ensureConfigured();
  final normalizedEmail = _email(email);
  final result = await Future.sync(
    () => _backend.signInWithEmailOtp(
      AuthEmailOtpSignInCommand(
        email: normalizedEmail,
        codeHash: _digestCode(code),
        now: now ?? DateTime.now(),
        candidate: AuthUser(
          id: secureRandomToken(length: 24),
          email: normalizedEmail,
          name: name?.trim().isEmpty ?? false ? null : name?.trim(),
          image: image?.trim().isEmpty ?? false ? null : image?.trim(),
        ),
        disableSignUp: disableSignUp,
      ),
    ),
  );
  final user = _requireAppliedTransition(result);
  return AuthEmailOtpSignInResult(user: user);
}