Add ref to list contents

Author: vermakhushboo

src/VCS/Adapter.php

@@ -227,9 +227,10 @@ abstract public function listRepositoryLanguages(string $owner, string $reposito
      * @param  string  $owner Owner name of the repository
      * @param  string  $repositoryName Name of the repository
      * @param  string  $path Path to list contents from
+     * @param  string  $ref The name of the commit/branch/tag
      * @return array<mixed> List of contents at the specified path
      */
-    abstract public function listRepositoryContents(string $owner, string $repositoryName, string $path = ''): array;
+    abstract public function listRepositoryContents(string $owner, string $repositoryName, string $path = '', string $ref = ''): array;
 
     /**
      * Get details of a commit using commit hash

src/VCS/Adapter/Git/GitHub.php

@@ -202,14 +202,18 @@ public function listRepositoryLanguages(string $owner, string $repositoryName):
      * @param  string  $owner Owner name of the repository
      * @param  string  $repositoryName Name of the GitHub repository
      * @param  string  $path Path to list contents from
+     * @param  string  $ref The name of the commit/branch/tag
      * @return array<mixed> List of contents at the specified path
      */
-    public function listRepositoryContents(string $owner, string $repositoryName, string $path = ''): array
+    public function listRepositoryContents(string $owner, string $repositoryName, string $path = '', string $ref = ''): array
     {
         $url = "/repos/$owner/$repositoryName/contents";
         if (!empty($path)) {
             $url .= "/$path";
         }
+        if (!empty($ref)) {
+            $url .= "?ref=$ref";
+        }
 
         $response = $this->call(self::METHOD_GET, $url, ['Authorization' => "Bearer $this->accessToken"]);
 

tests/VCS/Base.php

@@ -85,12 +85,17 @@ public function testListRepositoryContents(): void
         $this->assertIsArray($contents);
         $this->assertNotEmpty($contents);
 
-
         $contents = $this->vcsAdapter->listRepositoryContents('appwrite', 'appwrite', '');
         $this->assertIsArray($contents);
         $this->assertNotEmpty($contents);
         $this->assertGreaterThan(0, \count($contents));
 
+        // Test with ref parameter
+        $contents = $this->vcsAdapter->listRepositoryContents('appwrite', 'appwrite', '', 'main');
+        $this->assertIsArray($contents);
+        $this->assertNotEmpty($contents);
+        $this->assertGreaterThan(0, \count($contents));
+
         $fileContent = null;
         foreach ($contents as $content) {
             if ($content['type'] === GitHub::CONTENTS_FILE) {