fix: add validation for nested and unbalanced parentheses in path

Author: MarcusDragsten

src/common/providers/address_resolver/path_to_path_items.py

@@ -28,6 +28,20 @@ def path_to_path_items(path: str) -> list[AttributeItem | QueryItem | IdItem]:
     """Split up the path into path items.
     The path used as input to this function should not include protocol or data source.
     """
+    # Validate no nested or unbalanced parentheses in path
+    depth = 0
+    for char in path:
+        if char == "(":
+            depth += 1
+            if depth > 1:
+                raise ValueError(f"Nested parentheses are not supported in path: {path}")
+        elif char == ")":
+            depth -= 1
+            if depth < 0:
+                raise ValueError(f"Unbalanced parentheses in path: {path}")
+    if depth != 0:
+        raise ValueError(f"Unbalanced parentheses in path: {path}")
+
     queries = re.findall(r"\(([^()]+)\)", path)
     if queries:
         # Split the path into the pieces surrounding the queries and remove trailing [( and )]