| 1 | /** Character name rules shared by create UI and authoritative server create. */ |
| 2 | |
| 3 | export const CHARACTER_NAME_MAX_LENGTH = 24; |
| 4 | |
| 5 | /** Letters and hyphen only (no spaces, digits, or other punctuation). */ |
| 6 | export const CHARACTER_NAME_PATTERN = /^[A-Za-z-]+$/u; |
| 7 | |
| 8 | /** Reserved surname — only game admins may claim it. */ |
| 9 | export const RESERVED_ADMIN_SURNAME = "questward"; |
| 10 | |
| 11 | /** |
| 12 | * @param {unknown} value |
| 13 | * @param {"first"|"last"} part |
| 14 | * @returns {{ ok: true, value: string } | { ok: false, reason: string }} |
| 15 | */ |
| 16 | export function validateCharacterNamePart (value, part = "first") |
| 17 | { |
| 18 | const label = part === "last" ? "Last name" : "First name"; |
| 19 | const trimmed = String(value ?? "").trim(); |
| 20 | if (!trimmed) |
| 21 | { return { ok: false, reason: `${label} is required.` }; } |
| 22 | if (trimmed.length > CHARACTER_NAME_MAX_LENGTH) |
| 23 | { return { ok: false, reason: `${label} is too long.` }; } |
| 24 | if (!CHARACTER_NAME_PATTERN.test(trimmed)) |
| 25 | { |
| 26 | return { |
| 27 | ok: false, |
| 28 | reason: `${label} may only use letters A–Z and hyphens.` |
| 29 | }; |
| 30 | } |
| 31 | if (/^-+$/u.test(trimmed)) |
| 32 | { return { ok: false, reason: `${label} must include a letter.` }; } |
| 33 | return { ok: true, value: trimmed }; |
| 34 | } |
| 35 | |
| 36 | /** |
| 37 | * @param {{ firstName: unknown, lastName: unknown, isAdmin?: boolean }} opts |
| 38 | * @returns {{ ok: true, firstName: string, lastName: string } | { ok: false, reason: string }} |
| 39 | */ |
| 40 | export function validateCharacterNames ({ firstName, lastName, isAdmin = false }) |
| 41 | { |
| 42 | const first = validateCharacterNamePart(firstName, "first"); |
| 43 | if (!first.ok) |
| 44 | { return first; } |
| 45 | const last = validateCharacterNamePart(lastName, "last"); |
| 46 | if (!last.ok) |
| 47 | { return last; } |
| 48 | if (last.value.toLocaleLowerCase() === RESERVED_ADMIN_SURNAME && !isAdmin) |
| 49 | { |
| 50 | return { |
| 51 | ok: false, |
| 52 | reason: "That last name is reserved." |
| 53 | }; |
| 54 | } |
| 55 | return { ok: true, firstName: first.value, lastName: last.value }; |
| 56 | } |