perfect-payload 1.2.3 → 1.3.0

package/index.js

@@ -1280,6 +1280,47 @@ function perfectPayloadStructured(
 
           break;
 
+        // ==================================================
+        // CUSTOM VALIDATOR
+        // ==================================================
+
+        case "customValidator":
+          if (addNextError && attrExist && attributeValue !== null) {
+            const validator = attributeRules?.[ruleName];
+
+            if (typeof validator !== "function") {
+              throw new Error(
+                `perfect-payload:- customValidator must be a function for attribute ${attributePath}`,
+              );
+            }
+
+            const validationResult = validator(attributeValue, data);
+
+            if (
+              validationResult &&
+              typeof validationResult.then === "function"
+            ) {
+              throw new Error(
+                `perfect-payload:- customValidator must be synchronous for attribute ${attributePath}`,
+              );
+            }
+
+            if (validationResult !== true) {
+              addStructuredError(
+                rowErrors,
+                attributePath,
+                attributeRules?.["customValidatorCode"] ||
+                  "CUSTOM_VALIDATION_FAILED",
+                attributeRules?.["customValidatorError"] ||
+                  `Custom validation failed for attribute ${attributePath}`,
+              );
+
+              addNextError = false;
+            }
+          }
+
+          break;
+
         default:
           break;
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "perfect-payload",
-  "version": "1.2.3",
+  "version": "1.3.0",
   "type": "module",
   "description": "Lightweight JSON payload validation library with structured errors, nested validation, field paths, and customizable validation rules.",
   "main": "index.js",