feat: Add ParentValidation, ScopedExistsRule, and ScopedUniqueRule for enhanced validation

Author: promatik

composer.json

@@ -17,12 +17,12 @@
     "require": {
         "php": "^8.3|^8.4|^8.5",
         "illuminate/support": "~12",
-        "laravel/framework": "^12.40",
+        "laravel/framework": "^12.49",
         "laravel/tinker": "^2.10"
     },
     "require-dev": {
         "rector/rector": "^2.2",
-        "larastan/larastan": "^3.8",
+        "larastan/larastan": "^3.9",
         "laravel/pint": "^1.26"
     },
     "repositories": [

package.json

@@ -1,7 +1,7 @@
 {
     "private": true,
     "dependencies": {
-        "cantil": "^1.1.2",
+        "cantil": "^1.1.6",
         "normalize.css": "^8.0.1"
     }
 }

src/app/Rules/ParentValidation.php

@@ -0,0 +1,53 @@
+<?php
+
+namespace GemaDigital\Rules;
+
+use Closure;
+use Illuminate\Contracts\Validation\ValidationRule;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Support\Facades\DB;
+
+class ParentValidation implements ValidationRule
+{
+    public function __construct(
+        protected ?Model $model = null,
+    ) {}
+
+    /**
+     * Run the validation rule.
+     */
+    public function validate(string $attribute, mixed $value, Closure $fail): void
+    {
+        if ($this->model === null) {
+            return;
+        }
+
+        if ($this->isDescendantOf($value)) {
+            $fail(__('validation.parent_recursive', [
+                'model' => class_basename($this->model),
+            ]));
+        }
+    }
+
+    /**
+     * Check if this model is descendant of the given parent model or a recursive parent.
+     */
+    public function isDescendantOf(mixed $value): bool
+    {
+        if ($this->model->getKey() == $value) {
+            return true;
+        }
+
+        $tableName = $this->model->getTable();
+        $result = DB::select(
+            "WITH RECURSIVE descendants AS (
+                SELECT id, parent_id FROM $tableName WHERE parent_id = ?
+                UNION ALL
+                SELECT b.id, b.parent_id FROM $tableName b INNER JOIN descendants d ON b.parent_id = d.id
+            )
+            SELECT id FROM descendants WHERE id = ?;", [$this->model->getKey(), (int) $value]
+        );
+
+        return count($result) > 0;
+    }
+}

src/app/Rules/ScopedExistsRule.php

@@ -0,0 +1,54 @@
+<?php
+
+namespace GemaDigital\Rules;
+
+use Closure;
+use Illuminate\Contracts\Validation\ValidationRule;
+
+final class ScopedExistsRule implements ValidationRule
+{
+    public function __construct(
+        protected string $model,
+        protected ?string $field = null,
+    ) {}
+
+    /**
+     * Create a new instance from a var_export export.
+     *
+     * @param  array<string, mixed>  $state
+     */
+    public static function __set_state(array $state): static
+    {
+        return new self(
+            model: $state['model'],
+            field: $state['field'] ?? null,
+        );
+    }
+
+    /**
+     * Run the validation rule.
+     *
+     * @param  \Closure(string): \Illuminate\Translation\PotentiallyTranslatedString  $fail
+     */
+    public function validate(string $attribute, mixed $value, Closure $fail): void
+    {
+        if ($value === null) {
+            return;
+        }
+
+        $model = app($this->model);
+        $field = $this->field ?? $model->getKeyName();
+
+        if (is_array($value) && $model->whereIn($field, $value)->count() !== count($value)) {
+            $fail(__('validation.exists'));
+
+            return;
+        }
+
+        if ($model->where($field, $value)->count() === 0) {
+            $fail(__('validation.exists'));
+
+            return;
+        }
+    }
+}

src/app/Rules/ScopedUniqueRule.php

@@ -0,0 +1,63 @@
+<?php
+
+namespace GemaDigital\Rules;
+
+use Closure;
+use Illuminate\Contracts\Validation\ValidationRule;
+use Illuminate\Database\Query\Builder;
+
+final class ScopedUniqueRule implements ValidationRule
+{
+    public function __construct(
+        protected string $model,
+        protected ?string $field = null,
+        protected ?int $ignoreId = null,
+    ) {}
+
+    /**
+     * Create a new instance from a var_export export.
+     *
+     * @param  array<string, mixed>  $state
+     */
+    public static function __set_state(array $state): static
+    {
+        return new self(
+            model: $state['model'],
+            field: $state['field'] ?? null,
+            ignoreId: $state['ignoreId'] ?? null,
+        );
+    }
+
+    /**
+     * Run the validation rule.
+     *
+     * @param  \Closure(string): \Illuminate\Translation\PotentiallyTranslatedString  $fail
+     */
+    public function validate(string $attribute, mixed $value, Closure $fail): void
+    {
+        if ($value === null) {
+            return;
+        }
+
+        $model = app($this->model);
+        $field = $this->field ?? $model->getKeyName();
+
+        /** @var Builder */
+        $query = is_array($value)
+            ? $model->whereIn($field, $value)
+            : $model->where($field, $value);
+
+        if ($this->ignoreId) {
+            is_array($value)
+                ? $model->whereNotIn($model->getKeyName(), $this->ignoreId)
+                : $query->whereNot($model->getKeyName(), $this->ignoreId);
+
+        }
+
+        if ($query->count() > 0) {
+            $fail(__('validation.unique'));
+
+            return;
+        }
+    }
+}