Merge branch 'utopia-php:main' into feat/gitea-git-operations

Author: jaysomani

src/VCS/Adapter/Git.php

@@ -45,7 +45,7 @@ public function getType(): string
      * @param string $message Commit message
      * @return array<mixed> Response from API
      */
-    abstract public function createFile(string $owner, string $repositoryName, string $filepath, string $content, string $message = 'Add file'): array;
+    abstract public function createFile(string $owner, string $repositoryName, string $filepath, string $content, string $message = 'Add file', string $branch = ''): array;
 
     /**
      * Create a branch in a repository
@@ -57,4 +57,17 @@ abstract public function createFile(string $owner, string $repositoryName, strin
      * @return array<mixed> Response from API
      */
     abstract public function createBranch(string $owner, string $repositoryName, string $newBranchName, string $oldBranchName): array;
+
+    /**
+    * Create a pull request
+    *
+    * @param  string  $owner  Owner of the repository
+    * @param  string  $repositoryName  Name of the repository
+    * @param  string  $title  PR title
+    * @param  string  $head  Source branch
+    * @param  string  $base  Target branch
+    * @param  string  $body  PR description (optional)
+    * @return array<mixed> Created PR details
+    */
+    abstract public function createPullRequest(string $owner, string $repositoryName, string $title, string $head, string $base, string $body = ''): array;
 }

src/VCS/Adapter/Git/GitHub.php

@@ -93,20 +93,61 @@ public function createRepository(string $owner, string $repositoryName, bool $pr
 
         return $response['body'] ?? [];
     }
+    /**
+     * Create a pull request
+     *
+     * @param  string  $owner  Owner of the repository
+     * @param  string  $repositoryName  Name of the repository
+     * @param  string  $title  PR title
+     * @param  string  $head  Source branch
+     * @param  string  $base  Target branch
+     * @param  string  $body  PR description (optional)
+     * @return array<mixed> Created PR details
+     */
+    public function createPullRequest(string $owner, string $repositoryName, string $title, string $head, string $base, string $body = ''): array
+    {
+        throw new Exception('Not implemented');
+    }
 
     /**
      * Create a file in a repository
      *
-     * @param string $owner Owner of the repository
-     * @param string $repositoryName Name of the repository
-     * @param string $filepath Path where file should be created
-     * @param string $content Content of the file
-     * @param string $message Commit message
+     * @param  string  $owner  Owner of the repository
+     * @param  string  $repositoryName  Name of the repository
+     * @param  string  $filepath  Path where file should be created
+     * @param  string  $content  Content of the file
+     * @param  string  $message  Commit message
+     * @param  string  $branch  Branch to create file on (optional)
      * @return array<mixed> Response from API
      */
-    public function createFile(string $owner, string $repositoryName, string $filepath, string $content, string $message = 'Add file'): array
+    public function createFile(string $owner, string $repositoryName, string $filepath, string $content, string $message = 'Add file', string $branch = ''): array
     {
-        throw new Exception("Not implemented");
+        $url = "/repos/{$owner}/{$repositoryName}/contents/{$filepath}";
+
+        $payload = [
+            'message' => $message,
+            'content' => base64_encode($content),
+        ];
+
+        // GitHub supports branch parameter
+        if (! empty($branch)) {
+            $payload['branch'] = $branch;
+        }
+
+        $response = $this->call(
+            self::METHOD_PUT,
+            $url,
+            ['Authorization' => "Bearer $this->accessToken"],
+            $payload
+        );
+
+        $responseHeaders = $response['headers'] ?? [];
+        $responseHeadersStatusCode = $responseHeaders['status-code'] ?? 0;
+        if ($responseHeadersStatusCode >= 400) {
+            throw new Exception("Failed to create file {$filepath}: HTTP {$responseHeadersStatusCode}");
+        }
+
+        return $response['body'] ?? [];
     }
 
     /**