From 17cb0982352eb7c80b8cd50cb23afe36e9634a99 Mon Sep 17 00:00:00 2001
From: team 1 <team1@mitho-media.de>
Date: Fri, 1 May 2026 12:25:40 +0200
Subject: [PATCH] add CommerceReferenceResolverConfig

---
 .../CommerceReferenceResolverConfig.php       | 124 ++++++++++++++++++
 1 file changed, 124 insertions(+)
 create mode 100644 src/Config/CommerceReferenceResolverConfig.php

diff --git a/src/Config/CommerceReferenceResolverConfig.php b/src/Config/CommerceReferenceResolverConfig.php
new file mode 100644
index 0000000..bf1aaa5
--- /dev/null
+++ b/src/Config/CommerceReferenceResolverConfig.php
@@ -0,0 +1,124 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Config;
+
+use InvalidArgumentException;
+
+final class CommerceReferenceResolverConfig
+{
+    /**
+     * @param array<string, mixed> $config
+     */
+    public function __construct(
+        private readonly array $config = [],
+    ) {
+    }
+
+    /**
+     * @return string[]
+     */
+    public function getConversationProductPatterns(): array
+    {
+        return $this->stringList('conversation_product_patterns');
+    }
+
+    /**
+     * @return array<string, string>
+     */
+    public function getFocusTermPatterns(): array
+    {
+        return $this->stringMap('focus_term_patterns');
+    }
+
+    /**
+     * @return string[]
+     */
+    private function stringList(string $path): array
+    {
+        $value = $this->value($path);
+
+        if (!is_array($value)) {
+            throw $this->invalid($path, 'must be a list of non-empty strings');
+        }
+
+        $out = [];
+
+        foreach ($value as $item) {
+            if (!is_scalar($item)) {
+                continue;
+            }
+
+            $item = trim((string) $item);
+
+            if ($item !== '' && !in_array($item, $out, true)) {
+                $out[] = $item;
+            }
+        }
+
+        if ($out === []) {
+            throw $this->invalid($path, 'must contain at least one non-empty string');
+        }
+
+        return $out;
+    }
+
+    /**
+     * @return array<string, string>
+     */
+    private function stringMap(string $path): array
+    {
+        $value = $this->value($path);
+
+        if (!is_array($value)) {
+            throw $this->invalid($path, 'must be a map of non-empty strings');
+        }
+
+        $out = [];
+
+        foreach ($value as $key => $item) {
+            if (!is_scalar($key) || !is_scalar($item)) {
+                continue;
+            }
+
+            $cleanKey = trim((string) $key);
+            $cleanValue = trim((string) $item);
+
+            if ($cleanKey !== '' && $cleanValue !== '') {
+                $out[$cleanKey] = $cleanValue;
+            }
+        }
+
+        if ($out === []) {
+            throw $this->invalid($path, 'must contain at least one non-empty mapping');
+        }
+
+        return $out;
+    }
+
+    private function value(string $path): mixed
+    {
+        $current = $this->config;
+
+        foreach (explode('.', $path) as $segment) {
+            if (!is_array($current) || !array_key_exists($segment, $current)) {
+                throw $this->missing($path);
+            }
+
+            $current = $current[$segment];
+        }
+
+        return $current;
+    }
+
+    private function missing(string $path): InvalidArgumentException
+    {
+        return new InvalidArgumentException(sprintf('RetrieX commerce reference resolver config "%s" is missing.', $path));
+    }
+
+    private function invalid(string $path, string $reason): InvalidArgumentException
+    {
+        return new InvalidArgumentException(sprintf('RetrieX commerce reference resolver config "%s" %s.', $path, $reason));
+    }
+}