Fixed #54 - Array of Object validation

.github/workflows/tests.yml

@@ -9,7 +9,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        node-version: [18.x, 20.x, 21.x]
+        node-version: [18.x, 20.x, 22.x, 23.x]
     steps:
       - uses: actions/checkout@v2
       - name: Use Node.js ${{ matrix.node-version }}
@@ -24,7 +24,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        node-version: [18.x, 20.x, 21.x]
+        node-version: [18.x, 20.x, 22.x, 23.x]
     steps:
       - uses: actions/checkout@v2
       - name: Use Node.js ${{ matrix.node-version }}
@@ -42,7 +42,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        node-version: [ 20.x ]
+        node-version: [ 22.x ]
     steps:
       - uses: actions/checkout@v2
       - name: Use Node.js ${{ matrix.node-version }}

CHANGELOG.md

@@ -1,5 +1,9 @@
 # Release Notes
 
+## [2.2.0 (2025-01-13)](https://github.com/axe-api/axe-api/compare/2.2.0...2.2.1)
+
+- Array and object validation [#54](https://github.com/axe-api/validator/issues/54)
+
 ## [2.1.1 (2024-10-27)](https://github.com/axe-api/axe-api/compare/2.1.1...2.1.0)
 
 - TypeError: list.map is not a function [#62](https://github.com/axe-api/validator/issues/62)

docs/getting-started.md

@@ -89,3 +89,90 @@ By the example, you would get the following response:
   }
 }
 ```
+
+## Nested data validation
+
+This feature allows dynamic traversal of nested data structures, supporting complex validation rules for paths like `users.*.addresses.*.city`.
+
+It is inspired by Laravel's validation system and works seamlessly with arrays and objects, including deeply nested data.
+
+```ts
+import { validate, setLocales, en } from "robust-validator";
+
+setLocales(en);
+
+const data = {
+  secret: "some secret",
+  users: [
+    {
+      addresses: [
+        {
+          city: "New York",
+        },
+        {
+          city: "Istanbul",
+        },
+      ],
+    },
+    {
+      addresses: [
+        {
+          city: "New York",
+        },
+        {
+          street: "Wall Street",
+        },
+      ],
+    },
+  ],
+  permissons: {
+    read: true,
+    write: true,
+  },
+};
+
+const definition = {
+  secret: "required|min:100",
+  "users.*.addresses.*.city": "required",
+  "permissons.read": "required|boolean",
+  "permissons.delete": "required|boolean",
+};
+
+const result = await validate(data, definition);
+console.log(result);
+```
+
+And this is the content of the `result` variable:
+
+```json
+{
+  "isValid": false,
+  "isInvalid": true,
+  "fields": {
+    "secret": false,
+    "users.*.addresses.*.city": false,
+    "permissons.read": true,
+    "permissons.delete": false
+  },
+  "errors": {
+    "secret": [
+      {
+        "rule": "min",
+        "message": "The field must be at least 100."
+      }
+    ],
+    "users.1.addresses.1.city": [
+      {
+        "rule": "required",
+        "message": "The field is required."
+      }
+    ],
+    "permissons.delete": [
+      {
+        "rule": "required",
+        "message": "The field is required."
+      }
+    ]
+  }
+}
+```

docs/index.md

@@ -6,6 +6,9 @@ hero:
   name: "Robust Validator"
   text: "Rule-based data validation in JS"
   tagline: Extendable, function-oriented, i18n-supported
+  image:
+    src: /logo.png
+    alt: Robust Validator
   actions:
     - theme: brand
       text: Getting started
@@ -15,9 +18,9 @@ features:
   - title: Declarative ✍🏽
     details: Declarative rule definition allows you to save your rules in different places such as configuration files, databases, etc.
   - title: Simple 🐤
-    details: Starting to validate data is very fast instead of creating complicated validation rules. You just need seconds.
+    details: Starting to validate data is very fast. Instead of creating complicated validation rules, you just need seconds.
   - title: Proof of work 💪
     details: Laravel-ish data validation rules are well-tested as a concept. This library is just another implementation for JavaScript.
   - title: i18n 🇺🇳
-    details: Multi-language error messages are supported internally, unlike other libraries. It provides consistency.
+    details: Multi-language error messages are supported internally, unlike other libraries.
 ---

package.json

@@ -1,6 +1,6 @@
 {
   "name": "robust-validator",
-  "version": "2.1.1",
+  "version": "2.2.0",
   "description": "Rule-based data validation library",
   "type": "module",
   "main": "dist/index.cjs",

readme.md

@@ -1,4 +1,26 @@
-# Robust Validator
+#
+
+<h1 align="center">
+  <br>
+  <a href="https://validator.axe-api.com/">
+    <img src="https://validator.axe-api.com/logo.png" width="200">
+  </a>
+  <br>
+  Robust Validator
+  <br>
+  <a href="https://badge.fury.io/js/robust-validator">
+    <img src="https://badge.fury.io/js/robust-validator.svg" alt="npm version" height="18">
+  </a>
+  <a href="https://github.com/axe-api/validator/actions/workflows/npm-release-publish.yml" target="_blank">
+    <img src="https://github.com/axe-api/validator/actions/workflows/npm-release-publish.yml/badge.svg?branch=master">
+  </a>
+  <a href="https://github.com/axe-api/validator/issues" target="_blank">
+    <img src="https://img.shields.io/github/issues/axe-api/validator.svg">
+  </a>
+  <a href="https://opensource.org/licenses/MIT" target="_blank">
+    <img src="https://img.shields.io/badge/license-MIT-blue.svg">
+  </a>
+</h1>
 
 Rule-based data validation in JS. Extendable, function-oriented, i18n-supported
 

src/Interface.ts

@@ -44,3 +44,14 @@ export interface ILocale {
   key: LanguageType;
   values: Translation;
 }
+
+export interface ITraversePair {
+  path: string;
+  value: any;
+}
+
+export interface ITraverseItem {
+  path: string;
+  rules: string | string[];
+  resolved: Array<ITraversePair>;
+}