feat: field validation, term resolution, post guard and revision points

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01At3V6SjwbMe6eMzVGW3Hs7
2026-09-25 22:29:15 +02:00
parent 98a910f056
commit 95aae74466
11 changed files with 748 additions and 0 deletions
@@ -0,0 +1,182 @@
+<?php
+
+declare(strict_types=1);
+
+namespace LIT\MCP\Integrations\WordPress\Schema;
+
+use DateTimeImmutable;
+
+/**
+ * Checks field values against the detected schema before anything is written.
+ */
+final class FieldValidator
+{
+    private const LIST_TYPES = ['relation', 'file', 'choice', 'array'];
+
+    /**
+     * @param array<string, FieldDefinition> $definitions
+     * @param array<string, mixed>           $values
+     * @return array{values: array<string, mixed>, errors: array<string, string>, warnings: list<string>}
+     */
+    public function validate(array $definitions, array $values, bool $isCreate): array
+    {
+        $clean = [];
+        $errors = [];
+        $warnings = [];
+
+        foreach ($values as $key => $value) {
+            $key = (string) $key;
+            $field = $definitions[$key] ?? null;
+            if ($field === null) {
+                $errors[$key] = 'Unbekanntes Feld; verfügbare Felder über lit-content-types abrufen.';
+                continue;
+            }
+
+            if ($field->status === FieldDefinition::READONLY) {
+                $errors[$key] = 'Feld ist schreibgeschützt.';
+                continue;
+            }
+
+            $error = $value === null ? null : $this->check($field, $value);
+            if ($error !== null) {
+                $errors[$key] = $error;
+                continue;
+            }
+
+            if ($field->status === FieldDefinition::UNKNOWN) {
+                $warnings[] = sprintf(
+                    'Feld "%s" hat keinen bekannten Typ; der Wert wurde unverändert gespeichert.',
+                    $key
+                );
+            }
+
+            $clean[$key] = $value;
+        }
+
+        foreach ($definitions as $key => $field) {
+            if (! $field->required || isset($errors[$key])) {
+                continue;
+            }
+
+            $provided = array_key_exists($key, $clean);
+            if ($isCreate && (! $provided || $this->isEmpty($clean[$key]))) {
+                $errors[$key] = 'Pflichtfeld fehlt.';
+            } elseif (! $isCreate && $provided && $this->isEmpty($clean[$key])) {
+                $errors[$key] = 'Pflichtfeld darf nicht geleert werden.';
+            }
+        }
+
+        return ['values' => $clean, 'errors' => $errors, 'warnings' => $warnings];
+    }
+
+    private function check(FieldDefinition $field, mixed $value): ?string
+    {
+        if ($field->multiple && in_array($field->type, self::LIST_TYPES, true)) {
+            if (! is_array($value) || ! array_is_list($value)) {
+                return 'Liste erwartet.';
+            }
+
+            if ($field->type === 'array') {
+                return null;
+            }
+
+            foreach ($value as $item) {
+                $error = $this->checkScalar($field, $item);
+                if ($error !== null) {
+                    return $error;
+                }
+            }
+
+            return null;
+        }
+
+        return $this->checkScalar($field, $value);
+    }
+
+    private function checkScalar(FieldDefinition $field, mixed $value): ?string
+    {
+        switch ($field->type) {
+            case 'string':
+            case 'text':
+                return is_string($value) ? null : 'Text erwartet.';
+            case 'integer':
+                return is_int($value) ? null : 'Ganzzahl erwartet.';
+            case 'number':
+                return (is_int($value) || is_float($value)) ? null : 'Zahl erwartet.';
+            case 'boolean':
+                return is_bool($value) ? null : 'true oder false erwartet.';
+            case 'date':
+                return $this->matchesFormat($value, 'Y-m-d') ? null : 'Datum im Format JJJJ-MM-TT erwartet.';
+            case 'datetime':
+                return $this->matchesFormat($value, 'Y-m-d H:i:s')
+                    ? null
+                    : 'Datum und Uhrzeit im Format JJJJ-MM-TT HH:MM:SS erwartet.';
+            case 'time':
+                return $this->matchesFormat($value, 'H:i:s') ? null : 'Uhrzeit im Format HH:MM:SS erwartet.';
+            case 'choice':
+                return $this->checkChoice($field, $value);
+            case 'relation':
+            case 'file':
+                return $this->checkRelation($field, $value);
+            case 'array':
+                return (is_array($value) && array_is_list($value)) ? null : 'Liste erwartet.';
+            case 'object':
+                return is_array($value) ? null : 'Objekt erwartet.';
+            default:
+                return null;
+        }
+    }
+
+    private function checkChoice(FieldDefinition $field, mixed $value): ?string
+    {
+        $allowed = array_column($field->choices ?? [], 'value');
+
+        return is_string($value) && in_array($value, $allowed, true)
+            ? null
+            : sprintf('Erlaubte Werte: %s.', implode(', ', $allowed));
+    }
+
+    private function checkRelation(FieldDefinition $field, mixed $value): ?string
+    {
+        if (! is_int($value) || $value <= 0) {
+            return 'ID (positive Ganzzahl) erwartet.';
+        }
+
+        $objectType = $field->related['object_type'] ?? '';
+        if ($objectType === 'media') {
+            return get_post_type($value) === 'attachment'
+                ? null
+                : sprintf('%d ist kein Medium der Mediathek.', $value);
+        }
+
+        if ($objectType === 'post_type') {
+            $actual = get_post_type($value);
+            if ($actual === false) {
+                return sprintf('Eintrag %d existiert nicht.', $value);
+            }
+
+            $expected = $field->related['name'] ?? null;
+            if ($expected !== null && $actual !== $expected) {
+                return sprintf('Eintrag %d ist vom Typ %s, erwartet %s.', $value, $actual, $expected);
+            }
+        }
+
+        return null;
+    }
+
+    private function matchesFormat(mixed $value, string $format): bool
+    {
+        if (! is_string($value)) {
+            return false;
+        }
+
+        $parsed = DateTimeImmutable::createFromFormat('!' . $format, $value);
+
+        return $parsed !== false && $parsed->format($format) === $value;
+    }
+
+    private function isEmpty(mixed $value): bool
+    {
+        return $value === null || $value === '' || $value === [];
+    }
+}