feat(auth): improve invalid password guidance for OAuth accounts

packages/react/src/auth/oauth/oauth-button.test.tsx

@@ -429,7 +429,13 @@ describe("useSignInWithProvider", () => {
     // First call fails, second call succeeds
     mockSignInWithProvider
       .mockRejectedValueOnce(
-        new FirebaseUIError(ui.get(), new FirebaseError("auth/wrong-password", "Incorrect password"))
+        new FirebaseUIError(
+          ui.get(),
+          new FirebaseError(
+            "auth/wrong-password",
+            "Incorrect email or password. If you previously signed in using another provider, try using that sign-in method instead."
+          )
+        )
       )
       .mockResolvedValueOnce({} as UserCredential);
 
@@ -444,7 +450,9 @@ describe("useSignInWithProvider", () => {
       await result.current.callback();
     });
 
-    expect(result.current.error).toBe("Incorrect password");
+    expect(result.current.error).toBe(
+      "Incorrect email or password. If you previously signed in using another provider, try using that sign-in method instead."
+    );
 
     // Second call - should clear error
     await act(async () => {

packages/shadcn/src/components/oauth-button.test.tsx

@@ -268,7 +268,13 @@ describe("<OAuthButton />", () => {
     // First call fails, second call succeeds
     mockSignInWithProvider
       .mockRejectedValueOnce(
-        new FirebaseUIError(ui.get(), new FirebaseError("auth/wrong-password", "Incorrect password"))
+        new FirebaseUIError(
+          ui.get(),
+          new FirebaseError(
+            "auth/wrong-password",
+            "Incorrect email or password. If you previously signed in using another provider, try using that sign-in method instead."
+          )
+        )
       )
       .mockResolvedValueOnce({} as UserCredential);
 
@@ -284,14 +290,20 @@ describe("<OAuthButton />", () => {
     fireEvent.click(button);
 
     await waitFor(() => {
-      const errorMessage = screen.getByText("Incorrect password");
+      const errorMessage = screen.getByText(
+        "Incorrect email or password. If you previously signed in using another provider, try using that sign-in method instead."
+      );
       expect(errorMessage).toBeDefined();
     });
 
     // Second click - should clear error
     fireEvent.click(button);
     await waitFor(() => {
-      expect(screen.queryByText("Incorrect password")).toBeNull();
+      expect(
+        screen.queryByText(
+          "Incorrect email or password. If you previously signed in using another provider, try using that sign-in method instead."
+        )
+      ).toBeNull();
     });
   });
 

packages/translations/src/index.test.ts

@@ -678,7 +678,9 @@ describe("index.ts", () => {
     it("should have valid error translations", () => {
       const errors = enUs.translations.errors;
       expect(errors?.userNotFound).toBe("No account found with this email address");
-      expect(errors?.wrongPassword).toBe("Incorrect password");
+      expect(errors?.wrongPassword).toBe(
+        "Incorrect email or password. If you previously signed in using another provider, try using that sign-in method instead."
+      );
       expect(errors?.invalidEmail).toBe("Please enter a valid email address");
       expect(errors?.unknownError).toBe("An unexpected error occurred");
     });

packages/translations/src/locales/en-gb.ts

@@ -20,7 +20,8 @@ import { type Translations } from "../types";
 export const enGB = {
   errors: {
     userNotFound: "No account found with this email address",
-    wrongPassword: "Incorrect password",
+    wrongPassword:
+      "Incorrect email or password. If you previously signed in using another provider, try using that sign-in method instead.",
     invalidEmail: "Please enter a valid email address",
     userDisabled: "This account has been disabled",
     networkRequestFailed: "Unable to connect to the server. Please check your internet connection",

packages/translations/src/locales/en-us.ts

@@ -20,7 +20,8 @@ import { type Translations } from "../types";
 export const enUS = {
   errors: {
     userNotFound: "No account found with this email address",
-    wrongPassword: "Incorrect password",
+    wrongPassword:
+      "Incorrect email or password. If you previously signed in using another provider, try using that sign-in method instead.",
     invalidEmail: "Please enter a valid email address",
     userDisabled: "This account has been disabled",
     networkRequestFailed: "Unable to connect to the server. Please check your internet connection",

packages/translations/src/mapping.test.ts

@@ -154,7 +154,9 @@ describe("mapping.ts", () => {
       expect(getTranslation(locale, "errors", "userNotFound")).toBe("Custom error message");
 
       // Should fall back to English when not available
-      expect(getTranslation(locale, "errors", "wrongPassword")).toBe("Incorrect password");
+      expect(getTranslation(locale, "errors", "wrongPassword")).toBe(
+        "Incorrect email or password. If you previously signed in using another provider, try using that sign-in method instead."
+      );
       expect(getTranslation(locale, "labels", "emailAddress")).toBe("Email Address");
     });
 

packages/translations/src/types.ts

@@ -44,7 +44,7 @@ export type Translations = {
   errors?: {
     /** Translation for when a user is not found. */
     userNotFound?: string;
-    /** Translation for incorrect password. */
+    /** Translation for incorrect password or OAuth accounts. */
     wrongPassword?: string;
     /** Translation for invalid email address. */
     invalidEmail?: string;