From 43777ee6d99b79cc940c98be080247c8b3cd46d9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Matej=20Ba=C4=8Do?= <matejbaco2000@gmail.com>
Date: Sat, 9 May 2026 10:16:19 +0200
Subject: [PATCH] Add unit tests for github hints

---
 tests/unit/Vcs/CommentTest.php | 144 +++++++++++++++++++++++++++++++++
 1 file changed, 144 insertions(+)
 create mode 100644 tests/unit/Vcs/CommentTest.php

diff --git a/tests/unit/Vcs/CommentTest.php b/tests/unit/Vcs/CommentTest.php
new file mode 100644
index 0000000000..c6f69e2f1b
--- /dev/null
+++ b/tests/unit/Vcs/CommentTest.php
@@ -0,0 +1,144 @@
+<?php
+
+namespace Tests\Unit\Vcs;
+
+use Appwrite\Vcs\Comment;
+use PHPUnit\Framework\TestCase;
+use Utopia\Database\Document;
+
+class CommentTest extends TestCase
+{
+    public function testTipIsPreservedAcrossMultipleGenerations(): void
+    {
+        $comment = new Comment(['consoleHostname' => 'localhost']);
+        $comment->addBuild(
+            new Document(['$id' => 'project1', 'name' => 'Test Project', 'region' => 'default']),
+            new Document(['$id' => 'func1', 'name' => 'Test Function']),
+            'function',
+            'ready',
+            'dep1',
+            ['type' => 'logs'],
+            ''
+        );
+
+        $first = $comment->generateComment();
+        $firstTip = $this->extractTip($first);
+
+        $this->assertNotNull($firstTip);
+        $this->assertNotEmpty($firstTip);
+
+        $second = $comment->generateComment();
+        $secondTip = $this->extractTip($second);
+
+        $this->assertEquals($firstTip, $secondTip);
+    }
+
+    public function testTipIsRestoredFromParsedComment(): void
+    {
+        $comment = new Comment(['consoleHostname' => 'localhost']);
+        $comment->addBuild(
+            new Document(['$id' => 'project1', 'name' => 'Test Project', 'region' => 'default']),
+            new Document(['$id' => 'func1', 'name' => 'Test Function']),
+            'function',
+            'ready',
+            'dep1',
+            ['type' => 'logs'],
+            ''
+        );
+
+        $original = $comment->generateComment();
+        $originalTip = $this->extractTip($original);
+
+        $parsed = new Comment(['consoleHostname' => 'localhost']);
+        $parsed->parseComment($original);
+        $parsed->addBuild(
+            new Document(['$id' => 'project1', 'name' => 'Test Project', 'region' => 'default']),
+            new Document(['$id' => 'func2', 'name' => 'Another Function']),
+            'function',
+            'building',
+            'dep2',
+            ['type' => 'logs'],
+            ''
+        );
+
+        $regenerated = $parsed->generateComment();
+        $regeneratedTip = $this->extractTip($regenerated);
+
+        $this->assertEquals($originalTip, $regeneratedTip);
+    }
+
+    public function testBackwardCompatibilityWithOldStateFormat(): void
+    {
+        $oldBuilds = [
+            'project1_func1' => [
+                'projectName' => 'Test Project',
+                'projectId' => 'project1',
+                'region' => 'default',
+                'resourceName' => 'Test Function',
+                'resourceId' => 'func1',
+                'resourceType' => 'function',
+                'buildStatus' => 'ready',
+                'deploymentId' => 'dep1',
+                'action' => ['type' => 'logs'],
+                'previewUrl' => '',
+            ],
+        ];
+
+        $oldState = '[appwrite]: #' . \base64_encode(\json_encode($oldBuilds)) . "\n\n";
+        $oldState .= "> [!TIP]\n> Old tip that should be ignored\n\n";
+
+        $comment = new Comment(['consoleHostname' => 'localhost']);
+        $comment->parseComment($oldState);
+
+        $new = $comment->generateComment();
+        $newTip = $this->extractTip($new);
+
+        $this->assertNotNull($newTip);
+        $this->assertNotEquals('Old tip that should be ignored', $newTip);
+    }
+
+    public function testParseOldStateFormatWithOnlyBuilds(): void
+    {
+        $oldBuilds = [
+            'project1_func1' => [
+                'projectName' => 'Test Project',
+                'projectId' => 'project1',
+                'region' => 'default',
+                'resourceName' => 'Test Function',
+                'resourceId' => 'func1',
+                'resourceType' => 'function',
+                'buildStatus' => 'ready',
+                'deploymentId' => 'dep1',
+                'action' => ['type' => 'logs'],
+                'previewUrl' => '',
+            ],
+        ];
+
+        $state = '[appwrite]: #' . \base64_encode(\json_encode($oldBuilds)) . "\n\n";
+
+        $comment = new Comment(['consoleHostname' => 'localhost']);
+        $comment->parseComment($state);
+
+        $this->assertEquals(false, $comment->isEmpty());
+
+        $first = $comment->generateComment();
+        $firstTip = $this->extractTip($first);
+
+        $this->assertNotNull($firstTip);
+        $this->assertNotEmpty($firstTip);
+
+        $second = $comment->generateComment();
+        $secondTip = $this->extractTip($second);
+
+        $this->assertEquals($firstTip, $secondTip);
+    }
+
+    private function extractTip(string $comment): ?string
+    {
+        if (\preg_match('/> \[!TIP\]\n> (.+)/', $comment, $matches)) {
+            return $matches[1];
+        }
+
+        return null;
+    }
+}