feat: add useValidatePasswordMutation hook

packages/react/src/auth/index.ts

@@ -28,7 +28,7 @@ export { useSignInAnonymouslyMutation } from "./useSignInAnonymouslyMutation";
 // useSignInWithRedirectMutation
 // useSignOutMutation
 // useUpdateCurrentUserMutation
-// useValidatePasswordMutation
+export { useValidatePasswordMutation } from "./useValidatePasswordMutation";
 // useVerifyPasswordResetCodeMutation
 // useDeleteUserMutation
 // useLinkWithCredentialMutation

packages/react/src/auth/useValidatePasswordMutation.test.tsx

@@ -0,0 +1,37 @@
+import React from "react";
+import { describe, expect, test, beforeEach, afterEach } from "vitest";
+import { renderHook, act, waitFor } from "@testing-library/react";
+import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
+import { useValidatePasswordMutation } from "./useValidatePasswordMutation";
+import { auth, wipeAuth } from "~/testing-utils";
+
+const queryClient = new QueryClient({
+  defaultOptions: {
+    queries: { retry: false },
+    mutations: { retry: false },
+  },
+});
+
+const wrapper = ({ children }: { children: React.ReactNode }) => (
+  <QueryClientProvider client={queryClient}>{children}</QueryClientProvider>
+);
+
+describe("useValidatePasswordMutation", () => {
+  const validPassword = "ValidPassword123!";
+  const invalidPassword = "short";
+
+  beforeEach(async () => {
+    queryClient.clear();
+    await wipeAuth();
+  });
+
+  test("validates a password successfully", async () => {
+    const { result } = renderHook(() => useValidatePasswordMutation(auth), {
+      wrapper,
+    });
+
+    act(() => {
+      result.current.mutate(validPassword);
+    });
+  });
+});

packages/react/src/auth/useValidatePasswordMutation.ts

@@ -0,0 +1,23 @@
+import { useMutation, type UseMutationOptions } from "@tanstack/react-query";
+import {
+  type Auth,
+  type AuthError,
+  type PasswordValidationStatus,
+  validatePassword,
+} from "firebase/auth";
+
+type AuthUseMutationOptions<
+  TData = unknown,
+  TError = Error,
+  TVariables = void
+> = Omit<UseMutationOptions<TData, TError, TVariables>, "mutationFn">;
+
+export function useValidatePasswordMutation(
+  auth: Auth,
+  options?: AuthUseMutationOptions<PasswordValidationStatus, AuthError, string>
+) {
+  return useMutation<PasswordValidationStatus, AuthError, string>({
+    ...options,
+    mutationFn: (password: string) => validatePassword(auth, password),
+  });
+}