Server Actions

type ActionResult<T = undefined> =
  | { success: true; data?: T }
  | { success: false; error: string };

// Get authenticated profile ID
async function getProfileId(): Promise<string> {
  const { userId } = await auth();
  if (!userId) throw new Error("Not authenticated");
  const profile = await ensureProfile(userId);
  if (!profile) throw new Error("Profile creation failed");
  return profile.id;
}

// Error handling pattern
try {
  const profileId = await getProfileId();
  // ... business logic
  revalidatePath("/path");
  return { success: true };
} catch (error) {
  if (isUniqueViolation(error, "constraint_name")) {
    return { success: false, error: "User-friendly message" };
  }
  Sentry.captureException(error, {
    tags: { component: "server-action", action: "actionName" },
    extra: { /* context */ },
  });
  return { success: false, error: "Generic error message" };
}

const result = await checkUsernameAvailability("alice");
// { success: true, data: { available: true } }

import { isUniqueViolation } from "@/lib/db/errors";

try {
  await db.insert(profiles).values({ username: "alice" });
} catch (error) {
  if (isUniqueViolation(error, "profiles_username_unique")) {
    return { success: false, error: "Username is already taken" };
  }
  throw error;
}

Sentry.captureException(error, {
  tags: {
    component: "server-action",
    action: "actionName",
  },
  extra: {
    projectId: data.projectId,
    // ... other context
  },
});