/** Character name rules shared by create UI and authoritative server create. */ export const CHARACTER_NAME_MAX_LENGTH = 24; /** Letters and hyphen only (no spaces, digits, or other punctuation). */ export const CHARACTER_NAME_PATTERN = /^[A-Za-z-]+$/u; /** Reserved surname — only game admins may claim it. */ export const RESERVED_ADMIN_SURNAME = "questward"; /** * @param {unknown} value * @param {"first"|"last"} part * @returns {{ ok: true, value: string } | { ok: false, reason: string }} */ export function validateCharacterNamePart (value, part = "first") { const label = part === "last" ? "Last name" : "First name"; const trimmed = String(value ?? "").trim(); if (!trimmed) { return { ok: false, reason: `${label} is required.` }; } if (trimmed.length > CHARACTER_NAME_MAX_LENGTH) { return { ok: false, reason: `${label} is too long.` }; } if (!CHARACTER_NAME_PATTERN.test(trimmed)) { return { ok: false, reason: `${label} may only use letters A–Z and hyphens.` }; } if (/^-+$/u.test(trimmed)) { return { ok: false, reason: `${label} must include a letter.` }; } return { ok: true, value: trimmed }; } /** * @param {{ firstName: unknown, lastName: unknown, isAdmin?: boolean }} opts * @returns {{ ok: true, firstName: string, lastName: string } | { ok: false, reason: string }} */ export function validateCharacterNames ({ firstName, lastName, isAdmin = false }) { const first = validateCharacterNamePart(firstName, "first"); if (!first.ok) { return first; } const last = validateCharacterNamePart(lastName, "last"); if (!last.ok) { return last; } if (last.value.toLocaleLowerCase() === RESERVED_ADMIN_SURNAME && !isAdmin) { return { ok: false, reason: "That last name is reserved." }; } return { ok: true, firstName: first.value, lastName: last.value }; }