From 5a7fcf7982eaf4218f928cbc039c39b003c20139 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Tomasz=20Wolda=C5=84ski?= <t.woldanski@macopedia.com>
Date: Wed, 10 May 2023 09:58:51 +0200
Subject: [PATCH] [FEATURE] Allow non cachable plugins to return null on empty

---
 Classes/ContentObject/JsonContentObject.php |  2 +-
 Classes/Utility/HeadlessUserInt.php         | 83 ++++++++++++++-------
 2 files changed, 55 insertions(+), 30 deletions(-)

diff --git a/Classes/ContentObject/JsonContentObject.php b/Classes/ContentObject/JsonContentObject.php
index 1555ad1b..14f29664 100755
--- a/Classes/ContentObject/JsonContentObject.php
+++ b/Classes/ContentObject/JsonContentObject.php
@@ -114,7 +114,7 @@ public function cObjGet(array $setup, string $addKey = ''): array
                     $content[$theKey] = (bool)$content[$theKey];
                 }
                 if ($theValue === 'USER_INT' || strpos((string)$content[$theKey], '<!--INT_SCRIPT.') === 0) {
-                    $content[$theKey] = $this->headlessUserInt->wrap($content[$theKey]);
+                    $content[$theKey] = $this->headlessUserInt->wrap($content[$theKey], (int)($conf['ifEmptyReturnNull'] ?? 0) === 1 ? HeadlessUserInt::STANDARD_NULLABLE : HeadlessUserInt::STANDARD);
                 }
                 if ((int)($conf['ifEmptyReturnNull'] ?? 0) === 1 && $content[$theKey] === '') {
                     $content[$theKey] = null;
diff --git a/Classes/Utility/HeadlessUserInt.php b/Classes/Utility/HeadlessUserInt.php
index a940e9a9..bcb923fc 100644
--- a/Classes/Utility/HeadlessUserInt.php
+++ b/Classes/Utility/HeadlessUserInt.php
@@ -17,43 +17,17 @@
 use function preg_replace;
 use function preg_replace_callback;
 use function sprintf;
-use function strpos;
+use function str_contains;
 use function substr;
 
 class HeadlessUserInt
 {
     public const STANDARD = 'HEADLESS_INT';
     public const NESTED = 'NESTED_HEADLESS_INT';
+    public const STANDARD_NULLABLE = 'HEADLESS_NULL_INT';
+    public const NESTED_NULLABLE = 'NESTED_HEADLESS_NULL_INT';
     private const REGEX = '/("|)%s_START<<(.*?)>>%s_END("|)/s';
 
-    /**
-     * for use in preg_replace_callback
-     * to unwrap all HEADLESS_INT<<>>HEADLESS_INT blocks
-     *
-     * @param array<int, string> $input
-     * @return string
-     */
-    private function replace(array $input): string
-    {
-        $content = $input[2];
-        if ($input[1] === $input[3] && $input[1] === '"') {
-            // have a look inside if it might be json already
-            $decoded = json_decode($content);
-
-            if ($decoded !== null) {
-                return $content;
-            }
-            return json_encode($content);
-        }
-
-        // trim one occurrence of double quotes at both ends
-        $jsonEncoded = json_encode($content);
-        if ($jsonEncoded[0] === '"' && $jsonEncoded[-1] === '"') {
-            $jsonEncoded = substr($jsonEncoded, 1, -1);
-        }
-        return $jsonEncoded;
-    }
-
     public function wrap(string $content, string $type = self::STANDARD): string
     {
         return preg_replace(
@@ -73,10 +47,61 @@ public function unwrap(string $content): string
             );
         }
 
+        if (strpos($content, self::NESTED_NULLABLE) !== false) {
+            $content = preg_replace_callback(
+                sprintf(self::REGEX, self::NESTED_NULLABLE, self::NESTED_NULLABLE),
+                function (array $content) {
+                    return $this->replace($content, true);
+                },
+                $content
+            );
+        }
+
+        if (strpos($content, self::STANDARD_NULLABLE) !== false) {
+            $content = preg_replace_callback(
+                sprintf(self::REGEX, self::STANDARD_NULLABLE, self::STANDARD_NULLABLE),
+                function (array $content) {
+                    return $this->replace($content, true);
+                },
+                $content
+            );
+        }
+
         return preg_replace_callback(
             sprintf(self::REGEX, self::STANDARD, self::STANDARD),
             [$this, 'replace'],
             $content
         );
     }
+
+    /**
+     * for use in preg_replace_callback
+     * to unwrap all HEADLESS_INT<<>>HEADLESS_INT blocks
+     *
+     * @param array<int, string> $input
+     */
+    private function replace(array $input, bool $returnNull = false): ?string
+    {
+        $content = $input[2];
+        if ($input[1] === $input[3] && $input[1] === '"') {
+            // have a look inside if it might be json already
+            $decoded = json_decode($content);
+
+            if ($decoded === null && $returnNull) {
+                return null;
+            }
+
+            if ($decoded !== null) {
+                return $content;
+            }
+            return json_encode($content);
+        }
+
+        // trim one occurrence of double quotes at both ends
+        $jsonEncoded = json_encode($content);
+        if ($jsonEncoded[0] === '"' && $jsonEncoded[-1] === '"') {
+            $jsonEncoded = substr($jsonEncoded, 1, -1);
+        }
+        return $jsonEncoded;
+    }
 }