@alviere/core 0.16.3 → 0.17.1

package/dist/index.mjs

@@ -398,6 +398,10 @@ class Validator {
     if (trimmed.includes("..")) {
       return "Please enter a valid email address.";
     }
+    const localPart = trimmed.split("@")[0];
+    if (localPart.startsWith(".") || localPart.endsWith(".")) {
+      return "Please enter a valid email address.";
+    }
     const emailRegEx = /^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+@[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(?:\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)+$/;
     if (!emailRegEx.test(trimmed)) {
       return "Please enter a valid email address.";
@@ -420,7 +424,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 +530,31 @@ 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}$).
+   * Length is enforced to match API limits: min 1, max 40 characters.
+   * @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.";
+    }
+    const trimmed = value.trim();
+    if (trimmed.length > 40) {
+      return fieldName ? `${fieldName} must be no more than 40 characters long.` : "Must be no more than 40 characters long.";
+    }
+    if (!/^[-.,\p{L}\p{M}\s\d\u0027\u2019]+$/u.test(trimmed)) {
+      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