createPerson

​

Function Signature

async function createPerson(
  prevState: PersonPrevState,
  formData: FormData
): Promise<PersonPrevState>

​

Parameters

​

Return Value

​

Validation Schema

const personSchema = z.object({
  name: z.string().min(1, "Name cannot be empty"),
  phone: z
    .string()
    .regex(/^8801\d{9}$/, "Invalid phone number format. Must be 8801XXXXXXXXX"),
});

​

Behavior

1. Validation: Form data is validated against the Zod schema
2. API Call: Makes a POST request to {BACKEND_URL}/people/create-one
3. Authentication: Uses Basic Auth with environment credentials
4. Revalidation: Calls revalidatePath("/") on success to refresh the home page
5. Error Handling: Returns structured error messages for validation, backend, or network errors

​

Usage Example

import { useActionState } from "react";
import createPerson from "@/lib/actions/people/createPerson";

function PersonForm() {
  const [state, formAction] = useActionState(createPerson, {});
  
  return (
    <form action={formAction}>
      <input name="name" placeholder="Full Name" required />
      <input name="phone" placeholder="8801XXXXXXXXX" required />
      <button type="submit">Create Person</button>
      {state.error && <p className="error">{state.error}</p>}
      {state.success && <p className="success">Person created!</p>}
    </form>
  );
}

​

Backend Endpoint

• Authorization: Basic authentication
• Content-Type: application/json

{
  "name": "John Doe",
  "phone": "8801234567890"
}

​

Phone Number Format

• Prefix: 8801 (country code 880 + mobile prefix 1)
• Digits: Exactly 9 additional digits
• Total Length: 13 characters
• Example: 8801712345678

​

Valid Examples

• 8801712345678 (Grameenphone)
• 8801812345678 (Robi)
• 8801912345678 (Banglalink)
• 8801612345678 (Airtel)
• 8801512345678 (Teletalk)

​

Invalid Examples

• 01712345678 (missing country code)
• +8801712345678 (includes + symbol)
• 88017123456 (too few digits)
• 880171234567890 (too many digits)