Character Name Generator API

Endpoint:
  /generator

Description:
  Generates a fantasy-style character name. You can optionally provide a custom pattern via the 'pattern' query parameter.

Pattern Symbols:
  _ → Random consonant (e.g., B, D, G)
  - → Random vowel (e.g., A, E, I)
  * → Random letter (either consonant or vowel)
  $n → Variable (where n is a digit 0-9) that can be reused multiple times
  (funcName, params) → Function that applies special rules for character selection

Available Functions:
  (oneOf, abc) → Selects one character from the provided set (e.g., either a, b, or c)
  (anyExcept, xyz) → Selects any letter except those specified (e.g., any letter except x, y, or z)

Examples:

1. Randomly generated name (default pattern):
  GET /generator

2. Custom pattern with fixed letters:
  GET /generator?pattern=Br_-d*

  Example output: "Braidu" — where:
    B and r are fixed
    _ becomes random consonant
    - becomes random vowel
    d is fixed
    * becomes random letter

3. Custom pattern with only random letters:
  GET /generator?pattern=_-_*_-

  Example output: "Daebim"

4. Pattern with variables (repeated characters):
  GET /generator?pattern=$1a$1a

  Example output: "Baba" or "Tata" — where:
    $1 is assigned a random consonant
    The same consonant is reused where $1 appears again

5. Pattern with variable definitions:
  GET /generator?pattern=$1$1$2$2&$1=-&$2=_

  Example output: "Aabb" — where:
    $1 is defined as a vowel (-) and reused
    $2 is defined as a consonant (_) and reused

6. Pattern with complex variable definitions:
  GET /generator?pattern=$1$2$1$2&$1=g-t&$2=_-

  Example output: "GatGat" or "GetBet" — where:
    $1 is defined as "g-t" which generates "gat", "get", "git", etc.
    $2 is defined as "_-" which generates a consonant+vowel pair
    Variables can contain multiple characters and pattern symbols

7. Pattern with functions:
  GET /generator?pattern=(oneOf, aeiou)_(oneOf, aeiou)

  Example output: "Iae" — where:
    (oneOf, aeiou) selects one character from the vowels
    _ generates a random consonant

8. Pattern with anyExcept function:
  GET /generator?pattern=(anyExcept, qzx)(anyExcept, qzx)

  Example output: "Fa" — where:
    (anyExcept, qzx) selects any letter except q, z, or x

9. Pattern combining variables and functions:
  GET /generator?pattern=$1$1$2&$1=(oneOf, aeiou)&$2=(anyExcept, qzx)

  Example output: "AaP" — where:
    $1 is defined as one of the vowels and reused
    $2 is any letter except q, z, or x

10. Functions embedded within patterns:
  GET /generator?pattern=_a(oneOf,tp)

  Example output: "Cat" or "Rap" — where:
    _ generates a random consonant
    a is fixed
    (oneOf,tp) selects either 't' or 'p'

Notes:
- If no pattern is supplied, the generator will choose from a list of defaults.
- Variables ($1, $2, etc.) generate strings based on their definition and reuse them.
- Variable definitions can include:
  * Pattern symbols (-, _, *)
  * Literal characters
  * Functions like (oneOf, ...) and (anyExcept, ...)
  * Any combination of the above
- Functions can be used directly in patterns or as part of variable definitions
- Output is returned in JSON format:
  { "name": "GeneratedName" }

Enjoy!