updated based on requirement

Author: Your Name

src/VCS/Adapter.php

@@ -7,20 +7,31 @@
 abstract class Adapter
 {
     public const CLONE_TYPE_BRANCH = 'branch';
+
     public const CLONE_TYPE_TAG = 'tag';
+
     public const CLONE_TYPE_COMMIT = 'commit';
 
     public const METHOD_GET = 'GET';
+
     public const METHOD_POST = 'POST';
+
     public const METHOD_PUT = 'PUT';
+
     public const METHOD_PATCH = 'PATCH';
+
     public const METHOD_DELETE = 'DELETE';
+
     public const METHOD_HEAD = 'HEAD';
+
     public const METHOD_OPTIONS = 'OPTIONS';
+
     public const METHOD_CONNECT = 'CONNECT';
+
     public const METHOD_TRACE = 'TRACE';
 
     public const TYPE_GIT = 'git';
+
     public const TYPE_SVN = 'svn';
 
     protected bool $selfSigned = true;
@@ -36,61 +47,44 @@ abstract class Adapter
 
     /**
      * Get Adapter Name
-     *
-     * @return string
      */
     abstract public function getName(): string;
 
     /**
      * Get Adapter Type
-     *
-     * @return string
      */
     abstract public function getType(): string;
 
     /**
      * Initialize Variables
-     *
-     * @param string $installationId
-     * @param string $privateKey
-     * @param string|null $appId
-     * @param string|null $accessToken
-     * @param string|null $refreshToken
-     * @return void
      */
     abstract public function initializeVariables(string $installationId, string $privateKey, ?string $appId = null, ?string $accessToken = null, ?string $refreshToken = null): void;
 
     /**
      * Generate Access Token
-     *
-     * @param string $privateKey
-     * @param string $appId
-     * @return void
      */
     abstract protected function generateAccessToken(string $privateKey, string $appId): void;
 
     /**
      * Get user
      *
      * @return array<mixed>
-     *
      */
     abstract public function getUser(string $username): array;
 
     /**
      * Get owner name of the installation
-     *
-     * @return string
      */
     abstract public function getOwnerName(string $installationId): string;
 
     /**
      * Search repositories for GitHub App
-     * @param string $installationId ID of the installation
-     * @param string $owner Name of user or org
-     * @param int $page page number
-     * @param int $per_page number of results per page
-     * @param string $search Query to be searched to filter repo names
+     *
+     * @param  string  $installationId  ID of the installation
+     * @param  string  $owner  Name of user or org
+     * @param  int  $page  page number
+     * @param  int  $per_page  number of results per page
+     * @param  string  $search  Query to be searched to filter repo names
      * @return array<mixed>
      *
      * @throws Exception
@@ -100,7 +94,6 @@ abstract public function searchRepositories(string $installationId, string $owne
     /**
      * Get repository for the installation
      *
-     * @param string $repositoryName
      * @return array<mixed>
      */
     abstract public function getInstallationRepository(string $repositoryName): array;
@@ -126,6 +119,7 @@ abstract public function deleteRepository(string $owner, string $repositoryName)
 
     /**
      * Get latest opened pull request with specific base branch
+     *
      * @return array<mixed>
      */
     abstract public function getPullRequestFromBranch(string $owner, string $repositoryName, string $branch): array;
@@ -139,29 +133,27 @@ abstract public function getPullRequest(string $owner, string $repositoryName, i
 
     /**
      * Add Comment to Pull Request
-     *
-     * @return string
      */
     abstract public function createComment(string $owner, string $repositoryName, int $pullRequestNumber, string $comment): string;
 
     /**
      * Get Comment of Pull Request
      *
-     * @param string $owner       The owner of the repository
-     * @param string $repositoryName    The name of the repository
-     * @param string $commentId   The ID of the comment to retrieve
-     * @return string              The retrieved comment
+     * @param  string  $owner  The owner of the repository
+     * @param  string  $repositoryName  The name of the repository
+     * @param  string  $commentId  The ID of the comment to retrieve
+     * @return string The retrieved comment
      */
     abstract public function getComment(string $owner, string $repositoryName, string $commentId): string;
 
     /**
      * Update Pull Request Comment
      *
-     * @param string $owner      The owner of the repository
-     * @param string $repositoryName   The name of the repository
-     * @param int $commentId  The ID of the comment to update
-     * @param string $comment    The updated comment content
-     * @return string            The ID of the updated comment
+     * @param  string  $owner  The owner of the repository
+     * @param  string  $repositoryName  The name of the repository
+     * @param  int  $commentId  The ID of the comment to update
+     * @param  string  $comment  The updated comment content
+     * @return string The ID of the updated comment
      */
     abstract public function updateComment(string $owner, string $repositoryName, int $commentId, string $comment): string;
 
@@ -173,35 +165,34 @@ abstract public function generateCloneCommand(string $owner, string $repositoryN
     /**
      * Parses webhook event payload
      *
-     * @param  string  $payload Raw body of HTTP request
-     * @param  string  $signature Signature provided by Git provider in header
-     * @param  string  $signatureKey Webhook secret configured on Git provider
-     * @return bool
+     * @param  string  $payload  Raw body of HTTP request
+     * @param  string  $signature  Signature provided by Git provider in header
+     * @param  string  $signatureKey  Webhook secret configured on Git provider
      */
     abstract public function validateWebhookEvent(string $payload, string $signature, string $signatureKey): bool;
 
     /**
      * Parses webhook event payload
      *
-     * @param string $event Type of event: push, pull_request etc
-     * @param string $payload The webhook payload received from Git provider
+     * @param  string  $event  Type of event: push, pull_request etc
+     * @param  string  $payload  The webhook payload received from Git provider
      * @return array<mixed> Parsed payload as a json object
      */
     abstract public function getEvent(string $event, string $payload): array;
 
     /**
      * Fetches repository name using repository id
      *
-     * @param string $repositoryId ID of the repository
+     * @param  string  $repositoryId  ID of the repository
      * @return string name of the repository
      */
     abstract public function getRepositoryName(string $repositoryId): string;
 
     /**
      * Lists branches for a given repository
      *
-     * @param string $owner Owner name of the repository
-     * @param string $repositoryName Name of the repository
+     * @param  string  $owner  Owner name of the repository
+     * @param  string  $repositoryName  Name of the repository
      * @return array<string> List of branch names as array
      */
     abstract public function listBranches(string $owner, string $repositoryName): array;
@@ -215,61 +206,61 @@ abstract public function updateCommitStatus(string $repositoryName, string $SHA,
     /**
      * Get repository tree
      *
-     * @param string $owner Owner name of the repository
-     * @param string $repositoryName Name of the GitHub repository
-     * @param string $branch Name of the branch
-     * @param bool $recursive Whether to fetch the tree recursively
+     * @param  string  $owner  Owner name of the repository
+     * @param  string  $repositoryName  Name of the GitHub repository
+     * @param  string  $branch  Name of the branch
+     * @param  bool  $recursive  Whether to fetch the tree recursively
      * @return array<string> List of files in the repository
      */
     abstract public function getRepositoryTree(string $owner, string $repositoryName, string $branch, bool $recursive = false): array;
 
     /**
      * Get repository languages
      *
-     * @param string $owner Owner name of the repository
-     * @param string $repositoryName Name of the repository
+     * @param  string  $owner  Owner name of the repository
+     * @param  string  $repositoryName  Name of the repository
      * @return array<mixed> List of repository languages
      */
     abstract public function listRepositoryLanguages(string $owner, string $repositoryName): array;
 
     /**
      * List contents of the specified root directory.
      *
-     * @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
+     * @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 = '', string $ref = ''): array;
 
     /**
      * Get contents of the specified file.
      *
-     * @param  string  $owner Owner name
-     * @param  string  $repositoryName Name of the repository
-     * @param  string  $path Path to the file
-     * @param  string  $ref The name of the commit/branch/tag
+     * @param  string  $owner  Owner name
+     * @param  string  $repositoryName  Name of the repository
+     * @param  string  $path  Path to the file
+     * @param  string  $ref  The name of the commit/branch/tag
      * @return array<string, mixed> File details
      */
     abstract public function getRepositoryContent(string $owner, string $repositoryName, string $path, string $ref = ''): array;
 
     /**
      * Get details of a commit using commit hash
      *
-     * @param  string  $owner Owner name of the repository
-     * @param  string  $repositoryName Name of the GitHub repository
-     * @param  string  $commitHash SHA of the commit
+     * @param  string  $owner  Owner name of the repository
+     * @param  string  $repositoryName  Name of the GitHub repository
+     * @param  string  $commitHash  SHA of the commit
      * @return array<mixed> Details of the commit
      */
     abstract public function getCommit(string $owner, string $repositoryName, string $commitHash): array;
 
     /**
      * Get latest commit of a branch
      *
-     * @param  string  $owner Owner name of the repository
-     * @param  string  $repositoryName Name of the GitHub repository
-     * @param  string  $branch Name of the branch
+     * @param  string  $owner  Owner name of the repository
+     * @param  string  $repositoryName  Name of the GitHub repository
+     * @param  string  $branch  Name of the branch
      * @return array<mixed> Details of the commit
      */
     abstract public function getLatestCommit(string $owner, string $repositoryName, string $branch): array;
@@ -279,21 +270,18 @@ abstract public function getLatestCommit(string $owner, string $repositoryName,
      *
      * Make an API call
      *
-     * @param  string  $method
-     * @param  string  $path
      * @param  array<mixed>  $params
      * @param  array<string, string>  $headers
-     * @param  bool  $decode
      * @return array<mixed>
      *
      * @throws Exception
      */
     protected function call(string $method, string $path = '', array $headers = [], array $params = [], bool $decode = true)
     {
         $headers = array_merge($this->headers, $headers);
-        $ch = curl_init($this->endpoint . $path . (($method == self::METHOD_GET && !empty($params)) ? '?' . http_build_query($params) : ''));
+        $ch = curl_init($this->endpoint.$path.(($method == self::METHOD_GET && ! empty($params)) ? '?'.http_build_query($params) : ''));
 
-        if (!$ch) {
+        if (! $ch) {
             throw new Exception('Curl failed to initialize');
         }
 
@@ -321,7 +309,7 @@ protected function call(string $method, string $path = '', array $headers = [],
         }
 
         foreach ($headers as $i => $header) {
-            $headers[] = $i . ':' . $header;
+            $headers[] = $i.':'.$header;
             unset($headers[$i]);
         }
 
@@ -372,7 +360,7 @@ protected function call(string $method, string $path = '', array $headers = [],
                     $json = \json_decode($responseBody, true);
 
                     if ($json === null) {
-                        throw new Exception('Failed to parse response: ' . $responseBody);
+                        throw new Exception('Failed to parse response: '.$responseBody);
                     }
 
                     $responseBody = $json;
@@ -381,16 +369,16 @@ protected function call(string $method, string $path = '', array $headers = [],
             }
         }
 
-        if ((curl_errno($ch)/* || 200 != $responseStatus*/)) {
-            throw new Exception(curl_error($ch) . ' with status code ' . $responseStatus, $responseStatus);
+        if ((curl_errno($ch)/* || 200 != $responseStatus */)) {
+            throw new Exception(curl_error($ch).' with status code '.$responseStatus, $responseStatus);
         }
 
         curl_close($ch);
 
         $responseHeaders['status-code'] = $responseStatus;
 
         if ($responseStatus === 500) {
-            echo 'Server error(' . $method . ': ' . $path . '. Params: ' . json_encode($params) . '): ' . json_encode($responseBody) . "\n";
+            echo 'Server error('.$method.': '.$path.'. Params: '.json_encode($params).'): '.json_encode($responseBody)."\n";
         }
 
         return [
@@ -403,7 +391,6 @@ protected function call(string $method, string $path = '', array $headers = [],
      * Flatten params array to PHP multiple format
      *
      * @param  array<mixed>  $data
-     * @param  string  $prefix
      * @return array<mixed>
      */
     protected function flatten(array $data, string $prefix = ''): array