Feature request: Client-side helper to unwrap SafeAction results and throw on serverError

[aress31]

When consuming next-safe-action results on the client, it is common to repeat the same pattern:

const result = await action();
if (result.serverError) throw result.serverError;
return result.data;

This pattern is especially frequent when integrating with libraries such as:

• SWR / React Query
• toast.promise (e.g. Sonner)
• React transitions

To avoid repetition, many users end up creating a small utility like:

export async function unwrapSafeAction<T>(
  action: Promise<{ data?: T; serverError?: unknown }>
): Promise<T> {
  const result = await action;
  if (result.serverError) throw result.serverError;
  return result.data!;
}

Providing a built-in, configurable client-side helper (e.g. allowing behaviours such as automatic throwing on serverError) would reduce boilerplate and encourage a consistent, ergonomic error-handling pattern across client code.