docs(function): return results directly in managing-idp-users samples (#156)

* docs(function): return results directly in managing-idp-users samples

The `tailor.idp` client methods reject on failure, so wrapping their
results in a `{ success }` object made the samples read as if they
presuppose try/catch-based error handling — and implicitly recommended
returning a result object. Return the meaningful value directly and let
errors propagate as thrown exceptions, so the samples reflect the
recommended "throw unless you need to control the error or its message"
style rather than a success/error result object.

* docs(function): drop redundant return await and report only unenrolled factors

Apply Copilot review feedback on the managing-idp-users samples.

- Drop the redundant `await` from the `deleteUser`, `sendPasswordResetEmail`,
  and single-factor `unenrollMfa` samples. With no surrounding `try`/`catch`,
  returning the promise directly is equivalent and reads more simply.
- In the reset-all-MFA sample, filter `user.mfaFactorIds` by the boolean
  results of `unenrollMfa()` so `unenrolledFactorIds` reflects the factors
  that were actually unenrolled, rather than assuming every factor succeeded.

Author: k1LoW

docs/guides/function/managing-idp-users.md

@@ -214,7 +214,6 @@ export default async (args) => {
   });
 
   return {
-    success: true,
     userId: newUser.id,
     userName: newUser.name,
   };
@@ -238,7 +237,6 @@ export default async (args) => {
   });
 
   return {
-    success: true,
     userId: newUser.id,
     userName: newUser.name,
   };
@@ -264,7 +262,6 @@ export default async (args) => {
   });
 
   return {
-    success: true,
     userId: updatedUser.id,
     disabled: updatedUser.disabled,
   };
@@ -283,7 +280,6 @@ export default async (args) => {
   });
 
   return {
-    success: true,
     userId: updatedUser.id,
   };
 };
@@ -297,11 +293,7 @@ The `deleteUser` method deletes a user by their ID.
 export default async (args) => {
   const idpClient = new tailor.idp.Client({ namespace: args.namespaceName });
 
-  const success = await idpClient.deleteUser(args.userId);
-
-  return {
-    success: success,
-  };
+  return idpClient.deleteUser(args.userId);
 };
 ```
 
@@ -313,16 +305,12 @@ The `sendPasswordResetEmail` method sends a password reset email to a user. This
 export default async (args) => {
   const idpClient = new tailor.idp.Client({ namespace: args.namespaceName });
 
-  const success = await idpClient.sendPasswordResetEmail({
+  return idpClient.sendPasswordResetEmail({
     userId: args.userId,
     redirectUri: "https://your-app.com/reset-password-complete",
     fromName: "My App Support",
     subject: "Password Reset for Your My App Account",
   });
-
-  return {
-    success: success,
-  };
 };
 ```
 
@@ -346,11 +334,10 @@ To remove one specific factor:
 ```js
 export default async (args) => {
   const idpClient = new tailor.idp.Client({ namespace: args.namespaceName });
-  const success = await idpClient.unenrollMfa({
+  return idpClient.unenrollMfa({
     userId: args.userId,
     mfaFactorId: args.mfaFactorId,
   });
-  return { success };
 };
 ```
 
@@ -361,17 +348,18 @@ export default async (args) => {
   const idpClient = new tailor.idp.Client({ namespace: args.namespaceName });
 
   const user = await idpClient.user(args.userId);
-  if (!user.mfaEnrolled) {
-    return { success: false, reason: "User has no enrolled MFA factors" };
-  }
 
   const results = await Promise.all(
     user.mfaFactorIds.map((mfaFactorId) =>
       idpClient.unenrollMfa({ userId: user.id, mfaFactorId }),
     ),
   );
 
-  return { success: results.every(Boolean) };
+  const unenrolledFactorIds = user.mfaFactorIds.filter(
+    (_, index) => results[index],
+  );
+
+  return { unenrolledFactorIds };
 };
 ```