Support editing login ids

example/lib/main.dart

@@ -623,6 +623,36 @@ class _MyAppState extends State<MyApp> {
                           _onPressAddUsername(context);
                         },
                 ),
+                SessionStateButton(
+                  sessionState: _authgear.sessionState,
+                  targetState: SessionState.authenticated,
+                  label: "Change Email",
+                  onPressed: _unconfigured || _loading
+                      ? null
+                      : () {
+                          _onPressChangeEmail(context);
+                        },
+                ),
+                SessionStateButton(
+                  sessionState: _authgear.sessionState,
+                  targetState: SessionState.authenticated,
+                  label: "Change Phone",
+                  onPressed: _unconfigured || _loading
+                      ? null
+                      : () {
+                          _onPressChangePhoneNumber(context);
+                        },
+                ),
+                SessionStateButton(
+                  sessionState: _authgear.sessionState,
+                  targetState: SessionState.authenticated,
+                  label: "Change Username",
+                  onPressed: _unconfigured || _loading
+                      ? null
+                      : () {
+                          _onPressChangeUsername(context);
+                        },
+                ),
                 SessionStateButton(
                   sessionState: _authgear.sessionState,
                   targetState: SessionState.authenticated,
@@ -1019,6 +1049,78 @@ class _MyAppState extends State<MyApp> {
     }
   }
 
+  Future<void> _onPressChangeEmail(BuildContext context) async {
+    try {
+      setState(() {
+        _loading = true;
+      });
+      final info = await _authgear.getUserInfo();
+      final email = info.email;
+      if (email == null) {
+        throw Exception("User have no email");
+      }
+      await _authgear.changeEmail(
+        redirectURI: redirectURI,
+        colorScheme: _getColorScheme(context),
+        originalEmail: email,
+      );
+    } catch (e) {
+      onError(context, e);
+    } finally {
+      setState(() {
+        _loading = false;
+      });
+    }
+  }
+
+  Future<void> _onPressChangePhoneNumber(BuildContext context) async {
+    try {
+      setState(() {
+        _loading = true;
+      });
+      final info = await _authgear.getUserInfo();
+      final phoneNumber = info.phoneNumber;
+      if (phoneNumber == null) {
+        throw Exception("User have no phone");
+      }
+      await _authgear.changePhoneNumber(
+        redirectURI: redirectURI,
+        colorScheme: _getColorScheme(context),
+        originalPhoneNumber: phoneNumber,
+      );
+    } catch (e) {
+      onError(context, e);
+    } finally {
+      setState(() {
+        _loading = false;
+      });
+    }
+  }
+
+  Future<void> _onPressChangeUsername(BuildContext context) async {
+    try {
+      setState(() {
+        _loading = true;
+      });
+      final info = await _authgear.getUserInfo();
+      final username = info.preferredUsername;
+      if (username == null) {
+        throw Exception("User have no username");
+      }
+      await _authgear.changeUsername(
+        redirectURI: redirectURI,
+        colorScheme: _getColorScheme(context),
+        originalUsername: username,
+      );
+    } catch (e) {
+      onError(context, e);
+    } finally {
+      setState(() {
+        _loading = false;
+      });
+    }
+  }
+
   Future<void> _onPressShowAuthTime(BuildContext context) async {
     showDialog(
       context: context,

lib/src/client.dart

@@ -24,6 +24,7 @@ class OIDCAuthenticationRequest {
   final String? wechatRedirectURI;
   final String? oauthProviderAlias;
   final SettingsAction? settingsAction;
+  final String? settingsActionQuery;
   final String? authenticationFlowGroup;
   final ResponseMode? responseMode;
   final String? xPreAuthenticatedURLToken;
@@ -47,6 +48,7 @@ class OIDCAuthenticationRequest {
     this.wechatRedirectURI,
     this.oauthProviderAlias,
     this.settingsAction,
+    this.settingsActionQuery,
     this.authenticationFlowGroup,
     this.responseMode,
     this.xPreAuthenticatedURLToken,
@@ -144,6 +146,11 @@ class OIDCAuthenticationRequest {
       q["x_settings_action"] = settingsAction.value;
     }
 
+    final settingsActionQuery = this.settingsActionQuery;
+    if (settingsActionQuery != null) {
+      q["x_settings_action_query"] = settingsActionQuery;
+    }
+
     final authenticationFlowGroup = this.authenticationFlowGroup;
     if (authenticationFlowGroup != null) {
       q["x_authentication_flow_group"] = authenticationFlowGroup;

lib/src/container.dart

@@ -167,15 +167,31 @@ class SettingsActionOptions {
   final List<String>? uiLocales;
   final ColorScheme? colorScheme;
 
+  // For change_email, change_phone, change_password
+  final String? qLoginID;
+
   SettingsActionOptions({
     required this.settingAction,
     required this.redirectURI,
     this.uiLocales,
     this.colorScheme,
+    this.qLoginID,
   });
 
   OIDCAuthenticationRequest toRequest(String clientID, String idTokenHint,
       String loginHint, CodeVerifier verifier) {
+    final Map<String, String> xSettingsActionQueryMap = {};
+    final qLoginID = this.qLoginID;
+    if (qLoginID != null) {
+      xSettingsActionQueryMap["q_login_id"] = qLoginID;
+    }
+
+    String? xSettingsActionQuery;
+    if (xSettingsActionQueryMap.isNotEmpty) {
+      final u = Uri(queryParameters: xSettingsActionQueryMap);
+      xSettingsActionQuery = u.query;
+    }
+
     return OIDCAuthenticationRequest(
       clientID: clientID,
       redirectURI: redirectURI,
@@ -195,6 +211,7 @@ class SettingsActionOptions {
       idTokenHint: idTokenHint,
       loginHint: loginHint,
       settingsAction: settingAction,
+      settingsActionQuery: xSettingsActionQuery,
     );
   }
 }
@@ -559,6 +576,7 @@ class Authgear implements AuthgearHttpClientDelegate {
     required String redirectURI,
     List<String>? uiLocales,
     ColorScheme? colorScheme,
+    String? qLoginID,
   }) async {
     final idTokenHint = this.idTokenHint;
     final refreshToken = _refreshToken;
@@ -578,6 +596,7 @@ class Authgear implements AuthgearHttpClientDelegate {
       redirectURI: redirectURI,
       uiLocales: uiLocales,
       colorScheme: colorScheme,
+      qLoginID: qLoginID,
     );
 
     final request = await internalCreateSettingsActionRequest(
@@ -655,6 +674,48 @@ class Authgear implements AuthgearHttpClientDelegate {
     );
   }
 
+  Future<void> changeEmail(
+      {required String redirectURI,
+      required String originalEmail,
+      List<String>? uiLocales,
+      ColorScheme? colorScheme}) async {
+    await _openSettingsAction(
+      action: SettingsAction.changeEmail,
+      redirectURI: redirectURI,
+      uiLocales: uiLocales,
+      colorScheme: colorScheme,
+      qLoginID: originalEmail,
+    );
+  }
+
+  Future<void> changePhoneNumber(
+      {required String redirectURI,
+      required String originalPhoneNumber,
+      List<String>? uiLocales,
+      ColorScheme? colorScheme}) async {
+    await _openSettingsAction(
+      action: SettingsAction.changePhone,
+      redirectURI: redirectURI,
+      uiLocales: uiLocales,
+      colorScheme: colorScheme,
+      qLoginID: originalPhoneNumber,
+    );
+  }
+
+  Future<void> changeUsername(
+      {required String redirectURI,
+      required String originalUsername,
+      List<String>? uiLocales,
+      ColorScheme? colorScheme}) async {
+    await _openSettingsAction(
+      action: SettingsAction.changeUsername,
+      redirectURI: redirectURI,
+      uiLocales: uiLocales,
+      colorScheme: colorScheme,
+      qLoginID: originalUsername,
+    );
+  }
+
   Future<void> refreshIDToken() async {
     if (shouldRefreshAccessToken) {
       await refreshAccessToken();

lib/src/type.dart

@@ -164,6 +164,9 @@ enum SettingsAction {
   addEmail,
   addPhone,
   addUsername,
+  changeEmail,
+  changePhone,
+  changeUsername,
 }
 
 extension SettingsActionExtension on SettingsAction {
@@ -179,6 +182,12 @@ extension SettingsActionExtension on SettingsAction {
         return "add_phone";
       case SettingsAction.addUsername:
         return "add_username";
+      case SettingsAction.changeEmail:
+        return "change_email";
+      case SettingsAction.changePhone:
+        return "change_phone";
+      case SettingsAction.changeUsername:
+        return "change_username";
     }
   }
 }