supabase / supabase-flutter / 29003395872

87%

push

github

feat(gotrue): add channel parameter to mfa.challenge() (#1547)

## What

Adds an optional `channel` parameter (`sms` / `whatsapp`) to
`GoTrueMFAApi.challenge()` for phone factors, matching supabase-js.

```dart
await supabase.auth.mfa.challenge(
  factorId: factorId,
  channel: OtpChannel.whatsapp,
);
```

## Why

Parity gap tracked in `sdk-compliance.yaml` (`auth.mfa.challenge` was
`partially_implemented`): there was no way to pick the messaging channel
for phone MFA challenges, so it always used SMS.

## How

- Reuses the existing `OtpChannel` enum (already used by
`signInWithOtp`, `signUp`, `resend`) instead of introducing a new type.
- The parameter is nullable and only added to the request body when
provided, so when omitted the server's existing SMS default applies.
This keeps the change non-breaking; existing callers send the exact same
request as before.
- Updated `sdk-compliance.yaml` to mark `auth.mfa.challenge` as
`implemented`.

## Tests

Added `packages/gotrue/test/mfa_challenge_mock_test.dart` covering the
default (no channel), `whatsapp`, and `sms` cases via a mock HTTP client
that asserts the forwarded request body.

Resolves SDK-1260.

1 of 1 new or added line in 1 file covered. (100.0%)

4476 of 5178 relevant lines covered (86.44%)

4.03 hits per line