big restructure

2026-02-11 19:28:12 +01:00
parent cd59ccd99b
commit 3eb9cc0ac4
209 changed files with 5101 additions and 2459 deletions
--- a/lib/Repository/Support/RepoQuery.php
+++ b/lib/Repository/Support/RepoQuery.php
@@ -0,0 +1,120 @@
+<?php
+
+namespace MintyPHP\Repository\Support;
+
+class RepoQuery
+{
+    private static function normalizeLikeValue(string $value): string
+    {
+        $value = trim($value);
+        if ($value === '') {
+            return '';
+        }
+        $value = str_replace('\\', '\\\\', $value);
+        $value = str_replace('_', '\\_', $value);
+        $value = str_replace('*', '%', $value);
+        if (!str_starts_with($value, '%')) {
+            $value = '%' . $value;
+        }
+        if (!str_ends_with($value, '%')) {
+            $value = $value . '%';
+        }
+        return $value;
+    }
+    public static function sanitizeLimitOffset(
+        array $options,
+        int $defaultLimit = 10,
+        int $minLimit = 1,
+        int $maxLimit = 100,
+        int $defaultOffset = 0
+    ): array {
+        $limit = (int) ($options['limit'] ?? $defaultLimit);
+        if ($limit < $minLimit) {
+            $limit = $defaultLimit;
+        } elseif ($limit > $maxLimit) {
+            $limit = $maxLimit;
+        }
+
+        $offset = (int) ($options['offset'] ?? $defaultOffset);
+        if ($offset < 0) {
+            $offset = 0;
+        }
+
+        return [$limit, $offset];
+    }
+
+    public static function sanitizeOrder(
+        array $options,
+        array $allowedOrder,
+        string $defaultOrder = 'id',
+        string $defaultDir = 'desc'
+    ): array {
+        $order = (string) ($options['order'] ?? $defaultOrder);
+        $dir = strtolower((string) ($options['dir'] ?? $defaultDir));
+        if (!in_array($order, $allowedOrder, true)) {
+            $order = $defaultOrder;
+        }
+        if (!in_array($dir, ['asc', 'desc'], true)) {
+            $dir = $defaultDir;
+        }
+        return [$order, $dir];
+    }
+
+    public static function addLikeFilter(array &$where, array &$params, array $fields, string $value): void
+    {
+        $like = self::normalizeLikeValue($value);
+        if ($like === '') {
+            return;
+        }
+        $clauses = [];
+        foreach ($fields as $field) {
+            $clauses[] = $field . " like ? escape '\\\\'";
+            $params[] = $like;
+        }
+        if ($clauses) {
+            $where[] = '(' . implode(' or ', $clauses) . ')';
+        }
+    }
+
+    public static function addEnumFilter(array &$where, array &$params, $value, array $map): void
+    {
+        if ($value === null) {
+            return;
+        }
+        $normalized = strtolower(trim((string) $value));
+        if ($normalized === '' || $normalized === 'all') {
+            return;
+        }
+        foreach ($map as $entry) {
+            $aliases = $entry['aliases'] ?? [];
+            $aliases = array_map('strtolower', $aliases);
+            if (!in_array($normalized, $aliases, true)) {
+                continue;
+            }
+            $sql = (string) ($entry['sql'] ?? '');
+            if ($sql === '') {
+                return;
+            }
+            $where[] = $sql;
+            $paramsToAdd = $entry['params'] ?? [];
+            foreach ($paramsToAdd as $param) {
+                $params[] = $param;
+            }
+            return;
+        }
+    }
+
+    public static function addEqualsFilter(array &$where, array &$params, $value, string $sql, bool $allowEmpty = false): void
+    {
+        // Use for simple "= ?" filters; skip when empty to keep WHERE clean.
+        if ($value === null) {
+            return;
+        }
+        $normalized = trim((string) $value);
+        if ($normalized === '' && !$allowEmpty) {
+            return;
+        }
+        $where[] = $sql;
+        $params[] = $normalized;
+    }
+}