docs: update clerk docs

README.md

@@ -439,6 +439,14 @@ Returned Object:
 - `isCreating`: A boolean indicating whether an identifier is currently being added.
 - `isVerifying`: A boolean indicating whether a verification code is currently being processed.
 
+#### `useUpdateIdentifier`
+
+Hook to update the user's primary identifier (email or phone): add and verify a new one, then set it as primary and remove the old one.
+
+Returned Object:
+
+- `createIdentifier`, `verifyCode`, `isCreating`, `isVerifying`, `isUpdating` — see JSDoc.
+
 #### `useOtpVerification`
 
 Hook provides functionality for managing OTP (One Time Password) verification in user authentication workflows, supporting both sign-up and sign-in processes.
@@ -459,3 +467,11 @@ Returned Object:
 - `resetPassword`: A function to reset the user's password by verifying the code and setting a new password.
 - `isCodeSending`: A boolean indicating if the verification code is being sent.
 - `isResetting`: A boolean indicating if the password is being reset.
+
+#### `useChangePassword`
+
+Hook to update the current user's password (requires current and new password).
+
+Returned Object:
+
+- `updatePassword`, `isPasswordUpdating` — see JSDoc.

src/lib/src/features/clerk/hooks/use-reset-password.ts

@@ -1,5 +1,3 @@
-
-
 import { useState } from 'react';
 import { OtpMethod, UseResetPasswordReturn } from '../types';
 import { useClerkResources } from './use-clerk-resources';

src/lib/src/features/clerk/hooks/use-update-password.ts

@@ -2,6 +2,17 @@ import { useUser } from '@clerk/clerk-expo';
 import { useState } from 'react';
 import { UseUpdatePasswordReturn } from '../types';
 
+/**
+ * Hook that provides functionality to update the current user's password.
+ *
+ * Requires the user to supply both the current password (for verification) and
+ * the new password. On success, the user's password is updated in Clerk; on
+ * failure, the hook returns an error without throwing.
+ *
+ * @returns {UseUpdatePasswordReturn} Object containing:
+ * - `updatePassword` — Updates the user's password using current and new password
+ * - `isPasswordUpdating` — Indicates whether a password update is currently in progress
+ */
 export const useChangePassword = (): UseUpdatePasswordReturn => {
   const { user } = useUser();
   const [isPasswordUpdating, setIsPasswordUpdating] = useState(false);