BlueGit

timfa questward

Files

questward / shared / characters / names.js

names.js

names.js 1.8 KiB Download Raw
1/** Character name rules shared by create UI and authoritative server create. */
2
3export const CHARACTER_NAME_MAX_LENGTH = 24;
4
5/** Letters and hyphen only (no spaces, digits, or other punctuation). */
6export const CHARACTER_NAME_PATTERN = /^[A-Za-z-]+$/u;
7
8/** Reserved surname — only game admins may claim it. */
9export 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 */
16export 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 */
40export 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}