@alviere/core 0.16.3 → 0.17.0

package/dist/index.mjs

@@ -420,7 +420,7 @@ class Validator {
    * @param date - The date string to validate
    * @param format - The expected date format (default: 'YYYY-MM-DD')
    */
-  date(date, format = "YYYY-MM-DD") {
+  date(date, _format = "YYYY-MM-DD") {
     if (!date || typeof date !== "string") {
       return "Please enter a valid date.";
     }
@@ -526,6 +526,26 @@ class Validator {
     }
     return null;
   }
+  /**
+   * Validates that a value is a valid human name.
+   * Accepts Unicode letters (including diacritics), combining marks, spaces,
+   * digits, hyphens, apostrophes, periods, and commas. Diacritics, periods,
+   * and commas are accepted here so the user is never shown a validation error
+   * for a legitimate name — callers are responsible for normalising the value
+   * to the API-accepted character set before sending (API regex:
+   * ^[a-zA-Z0-9' -]{1,40}$).
+   * @param value - The value to validate
+   * @param fieldName - Optional field name for error message
+   */
+  nameField(value, fieldName) {
+    if (!value || typeof value !== "string") {
+      return fieldName ? `${fieldName} is required.` : "This field is required.";
+    }
+    if (!/^[-.,\p{L}\p{M}\s\d\u0027\u2019]+$/u.test(value.trim())) {
+      return fieldName ? `${fieldName} must contain only letters, numbers, spaces, hyphens, apostrophes, periods, and commas.` : "Must contain only letters, numbers, spaces, hyphens, apostrophes, periods, and commas.";
+    }
+    return null;
+  }
   /**
    * Validates that a value contains only letters and numbers
    * @param value - The value to validate