feat(ui,clerk-js,shared,react,localizations): Rename the SSO fallback sign-in flow to SSO bypass (#9822)

Author: mauricioabreu

.changeset/rename-sso-fallback-to-sso-bypass.md

@@ -0,0 +1,9 @@
+---
+'@clerk/localizations': minor
+'@clerk/clerk-js': minor
+'@clerk/shared': minor
+'@clerk/react': minor
+'@clerk/ui': minor
+---
+
+Rename the SSO fallback sign-in flow to SSO bypass, matching the name the feature ships under. The sign-in resource's `ssoFallbackFirstFactors` is now `ssoBypassFirstFactors` and reads the `sso_bypass_first_factors` field from the API, the `signIn.ssoFallback` localization keys are now `signIn.ssoBypass`, and the `ssoFallback` card action element id is now `ssoBypass`. The flow has not been enabled on any instance, so no application is affected by the old names going away.

packages/clerk-js/src/core/resources/SignIn.ts

@@ -118,7 +118,7 @@ export class SignIn extends BaseResource implements SignInResource {
   supportedIdentifiers: SignInIdentifier[] = [];
   supportedFirstFactors: SignInFirstFactor[] | null = [];
   supportedSecondFactors: SignInSecondFactor[] | null = null;
-  ssoFallbackFirstFactors: SignInFirstFactor[] | null = null;
+  ssoBypassFirstFactors: SignInFirstFactor[] | null = null;
   firstFactorVerification: VerificationResource = new Verification(null);
   secondFactorVerification: VerificationResource = new Verification(null);
   identifier: string | null = null;
@@ -640,7 +640,7 @@ export class SignIn extends BaseResource implements SignInResource {
       this.identifier = data.identifier;
       this.supportedFirstFactors = deepSnakeToCamel(data.supported_first_factors) as SignInFirstFactor[] | null;
       this.supportedSecondFactors = deepSnakeToCamel(data.supported_second_factors) as SignInSecondFactor[] | null;
-      this.ssoFallbackFirstFactors = deepSnakeToCamel(data.sso_fallback_first_factors ?? null) as
+      this.ssoBypassFirstFactors = deepSnakeToCamel(data.sso_bypass_first_factors ?? null) as
         | SignInFirstFactor[]
         | null;
       this.firstFactorVerification = new Verification(data.first_factor_verification);
@@ -712,7 +712,7 @@ export class SignIn extends BaseResource implements SignInResource {
       supported_identifiers: this.supportedIdentifiers,
       supported_first_factors: deepCamelToSnake(this.supportedFirstFactors),
       supported_second_factors: deepCamelToSnake(this.supportedSecondFactors),
-      sso_fallback_first_factors: deepCamelToSnake(this.ssoFallbackFirstFactors) ?? undefined,
+      sso_bypass_first_factors: deepCamelToSnake(this.ssoBypassFirstFactors) ?? undefined,
       first_factor_verification: this.firstFactorVerification.__internal_toSnapshot(),
       second_factor_verification: this.secondFactorVerification.__internal_toSnapshot(),
       identifier: this.identifier,
@@ -832,8 +832,8 @@ class SignInFuture implements SignInFutureResource {
     return this.#resource.supportedSecondFactors ?? [];
   }
 
-  get ssoFallbackFirstFactors() {
-    return this.#resource.ssoFallbackFirstFactors ?? [];
+  get ssoBypassFirstFactors() {
+    return this.#resource.ssoBypassFirstFactors ?? [];
   }
 
   get isTransferable() {

packages/clerk-js/src/core/resources/__tests__/SignIn.test.ts

@@ -3292,7 +3292,7 @@ describe('SignIn', () => {
     });
   });
 
-  describe('ssoFallbackFirstFactors', () => {
+  describe('ssoBypassFirstFactors', () => {
     const baseJSON = {
       id: 'signin_123',
       object: 'sign_in',
@@ -3310,29 +3310,29 @@ describe('SignIn', () => {
     it('defaults to null when the field is absent', () => {
       const signIn = new SignIn(baseJSON);
 
-      expect(signIn.ssoFallbackFirstFactors).toBeNull();
-      expect(signIn.__internal_future.ssoFallbackFirstFactors).toEqual([]);
-      expect(signIn.__internal_toSnapshot().sso_fallback_first_factors).toBeUndefined();
+      expect(signIn.ssoBypassFirstFactors).toBeNull();
+      expect(signIn.__internal_future.ssoBypassFirstFactors).toEqual([]);
+      expect(signIn.__internal_toSnapshot().sso_bypass_first_factors).toBeUndefined();
     });
 
     it('round-trips the field through the snapshot', () => {
       const signIn = new SignIn({
         ...baseJSON,
-        sso_fallback_first_factors: [
+        sso_bypass_first_factors: [
           { strategy: 'email_code', safe_identifier: 'user@corp.com', email_address_id: 'idn_hmac' },
         ],
       });
 
-      expect(signIn.ssoFallbackFirstFactors).toEqual([
+      expect(signIn.ssoBypassFirstFactors).toEqual([
         { strategy: 'email_code', safeIdentifier: 'user@corp.com', emailAddressId: 'idn_hmac' },
       ]);
-      expect(signIn.__internal_future.ssoFallbackFirstFactors).toEqual(signIn.ssoFallbackFirstFactors);
+      expect(signIn.__internal_future.ssoBypassFirstFactors).toEqual(signIn.ssoBypassFirstFactors);
 
       const snapshot = signIn.__internal_toSnapshot();
-      expect(snapshot.sso_fallback_first_factors).toEqual([
+      expect(snapshot.sso_bypass_first_factors).toEqual([
         { strategy: 'email_code', safe_identifier: 'user@corp.com', email_address_id: 'idn_hmac' },
       ]);
-      expect(new SignIn(snapshot).ssoFallbackFirstFactors).toEqual(signIn.ssoFallbackFirstFactors);
+      expect(new SignIn(snapshot).ssoBypassFirstFactors).toEqual(signIn.ssoBypassFirstFactors);
     });
   });
 });

packages/localizations/src/ar-SA.ts

@@ -1687,7 +1687,7 @@ export const arSA: LocalizationResource = {
     resetPasswordMfa: {
       detailsLabel: 'نريد التحقق من هويتك قبل أعادة تعيين كلمة المرور',
     },
-    ssoFallback: {
+    ssoBypass: {
       actionLink: undefined,
       code: {
         resendButton: undefined,

packages/localizations/src/be-BY.ts

@@ -1694,7 +1694,7 @@ export const beBY: LocalizationResource = {
     resetPasswordMfa: {
       detailsLabel: 'Неабходна верыфікаваць вашу асобу перад аднаўленнем пароля',
     },
-    ssoFallback: {
+    ssoBypass: {
       actionLink: undefined,
       code: {
         resendButton: undefined,

packages/localizations/src/bg-BG.ts

@@ -1690,7 +1690,7 @@ export const bgBG: LocalizationResource = {
     resetPasswordMfa: {
       detailsLabel: 'Трябва да потвърдим вашата самоличност, преди да нулираме паролата ви.',
     },
-    ssoFallback: {
+    ssoBypass: {
       actionLink: undefined,
       code: {
         resendButton: undefined,

packages/localizations/src/bn-IN.ts

@@ -1700,7 +1700,7 @@ export const bnIN: LocalizationResource = {
     resetPasswordMfa: {
       detailsLabel: 'আপনার পাসওয়ার্ড রিসেট করার আগে আমাদের আপনার পরিচয় যাচাই করতে হবে।',
     },
-    ssoFallback: {
+    ssoBypass: {
       actionLink: undefined,
       code: {
         resendButton: undefined,

packages/localizations/src/ca-ES.ts

@@ -1699,7 +1699,7 @@ export const caES: LocalizationResource = {
     resetPasswordMfa: {
       detailsLabel: 'Necessitem verificar la teva identitat abans de restablir la teva contrasenya.',
     },
-    ssoFallback: {
+    ssoBypass: {
       actionLink: undefined,
       code: {
         resendButton: undefined,

packages/localizations/src/cs-CZ.ts

@@ -1698,7 +1698,7 @@ export const csCZ: LocalizationResource = {
     resetPasswordMfa: {
       detailsLabel: 'Před resetováním hesla musíme ověřit vaši identitu.',
     },
-    ssoFallback: {
+    ssoBypass: {
       actionLink: undefined,
       code: {
         resendButton: undefined,

packages/localizations/src/da-DK.ts

@@ -1688,7 +1688,7 @@ export const daDK: LocalizationResource = {
     resetPasswordMfa: {
       detailsLabel: 'Vi skal bekræfte din identitet, før du nulstiller din adgangskode.',
     },
-    ssoFallback: {
+    ssoBypass: {
       actionLink: undefined,
       code: {
         resendButton: undefined,