#42, Can use private access tokens (Bearer) for non-public repositories

Author: Holger Lösken

README.md

@@ -16,6 +16,16 @@ Usually you need this when distributing a self-hosted Laravel application
 that needs some updating mechanism, as you do not want to bother your
 lovely users with Git and/or Composer commands ;-)
 
+## Compatibility
+
+* PHP:
+  * 7.2
+  * 7.3
+  * 7.4
+* Laravel:
+  * 5.8
+  * 6.x
+  
 ## Install with Composer
 
 To install the latest version from the master using [Composer](https://getcomposer.org/):

config/self-update.php

@@ -43,12 +43,14 @@
             'repository_name' => env('SELF_UPDATER_REPO_NAME', ''),
             'repository_url' => '',
             'download_path' => env('SELF_UPDATER_DOWNLOAD_PATH', '/tmp'),
+            'private_access_token' => env('SELF_UPDATER_GITHUB_PRIVATE_ACCESS_TOKEN', ''),
         ],
         'http' => [
             'type' => 'http',
             'repository_url' => env('SELF_UPDATER_REPO_URL', ''),
             'pkg_filename_format' => env('SELF_UPDATER_PKG_FILENAME_FORMAT', 'v_VERSION_'),
             'download_path' => env('SELF_UPDATER_DOWNLOAD_PATH', '/tmp'),
+            'private_access_token' => env('SELF_UPDATER_HTTP_PRIVATE_ACCESS_TOKEN', ''),
         ],
     ],
 

src/AbstractRepositoryType.php

@@ -1,4 +1,4 @@
-<?php
+<?php declare(strict_types=1);
 
 namespace Codedge\Updater;
 
@@ -15,11 +15,18 @@
  */
 abstract class AbstractRepositoryType
 {
+    const ACCESS_TOKEN_PREFIX = 'Bearer ';
+
     /**
      * @var array
      */
     protected $config;
 
+    /**
+     * Access token for private repository access.
+     */
+    private $accessToken = '';
+
     /**
      * @var Finder|SplFileInfo[]
      */
@@ -99,8 +106,21 @@ protected function hasCorrectPermissionForUpdate() : bool
      */
     protected function downloadRelease(Client $client, $source, $storagePath)
     {
+        $headers = [];
+
+        if($this->hasAccessToken()) {
+            $headers = [
+                'Authorization' => $this->getAccessToken()
+            ];
+        }
+
         return $client->request(
-            'GET', $source, ['sink' => $storagePath]
+            'GET',
+            $source,
+            [
+                'sink' => $storagePath,
+                'headers' => $headers,
+            ]
         );
     }
 
@@ -159,4 +179,40 @@ public function createReleaseFolder($storagePath, $releaseName)
 
         File::deleteDirectory($subDirName[0]);
     }
+
+    /**
+     * Get the access token.
+     *
+     * @param bool $withPrefix
+     *
+     * @return string
+     */
+    public function getAccessToken($withPrefix = true): string
+    {
+        if($withPrefix) {
+            return self::ACCESS_TOKEN_PREFIX . $this->accessToken;
+        }
+
+        return $this->accessToken;
+    }
+
+    /**
+     * Set access token.
+     *
+     * @param string $token
+     */
+    public function setAccessToken(string $token): void
+    {
+        $this->accessToken = $token;
+    }
+
+    /**
+     * Check if an access token has been set.
+     *
+     * @return bool
+     */
+    public function hasAccessToken(): bool
+    {
+        return !empty($this->accessToken);
+    }
 }

src/SourceRepositoryTypes/GithubRepositoryType.php

@@ -1,4 +1,4 @@
-<?php
+<?php declare(strict_types=1);
 
 namespace Codedge\Updater\SourceRepositoryTypes;
 
@@ -40,6 +40,8 @@ public function __construct(Client $client, array $config)
         $this->config = $config;
         $this->config['version_installed'] = config('self-update.version_installed');
         $this->config['exclude_folders'] = config('self-update.exclude_folders');
+
+        $this->setAccessToken($config['private_access_token']);
     }
 
     /**
@@ -214,9 +216,20 @@ protected function getRepositoryReleases()
             throw new \Exception('No repository specified. Please enter a valid Github repository owner and name in your config.');
         }
 
+        $headers = [];
+
+        if($this->hasAccessToken()) {
+            $headers = [
+                'Authorization' => $this->getAccessToken()
+            ];
+        }
+
         return $this->client->request(
             'GET',
-            self::GITHUB_API_URL.'/repos/'.$this->config['repository_vendor'].'/'.$this->config['repository_name'].'/tags'
+            self::GITHUB_API_URL.'/repos/'.$this->config['repository_vendor'].'/'.$this->config['repository_name'].'/tags',
+            [
+                'headers' => $headers
+            ]
         );
     }
 

src/SourceRepositoryTypes/HttpRepositoryType.php

@@ -1,4 +1,4 @@
-<?php
+<?php declare(strict_types=1);
 
 namespace Codedge\Updater\SourceRepositoryTypes;
 
@@ -10,6 +10,7 @@
 use File;
 use GuzzleHttp\Client;
 use Illuminate\Database\Eloquent\Collection;
+use Psr\Http\Message\ResponseInterface;
 use Storage;
 use Symfony\Component\Finder\Finder;
 
@@ -29,7 +30,7 @@ class HttpRepositoryType extends AbstractRepositoryType implements SourceReposit
     protected $client;
 
     /**
-     * @var Version prepand string
+     * @var Version prepend string
      */
     protected $prepend;
 
@@ -53,6 +54,8 @@ public function __construct(Client $client, array $config)
         // Get prepend and append strings
         $this->prepend = preg_replace('/_VERSION_.*$/', '', $this->config['pkg_filename_format']);
         $this->append = preg_replace('/^.*_VERSION_/', '', $this->config['pkg_filename_format']);
+
+        $this->setAccessToken($config['private_access_token']);
     }
 
     /**
@@ -194,9 +197,10 @@ public function getVersionInstalled($prepend = '', $append = '') : string
      * Example: 2.6.5 or v2.6.5.
      *
      * @param string $prepend Prepend a string to the latest version
-     * @param string $append  Append a string to the latest version
+     * @param string $append Append a string to the latest version
      *
      * @return string
+     * @throws \Exception
      */
     public function getVersionAvailable($prepend = '', $append = '') : string
     {
@@ -217,9 +221,9 @@ public function getVersionAvailable($prepend = '', $append = '') : string
     /**
      * Retrieve html body with list of all releases from archive URL.
      *
-     * @throws \Exception
+     * @return mixed|ResponseInterface
+     *@throws \Exception
      *
-     * @return mixed|\Psr\Http\Message\ResponseInterface
      */
     protected function getPackageReleases()
     {

tests/SourceRepositoryTypes/GithubRepositoryTypeTest.php

@@ -1,4 +1,4 @@
-<?php
+<?php declare(strict_types=1);
 
 namespace Codedge\Updater\Tests\SourceRepositoryTypes;
 
@@ -106,4 +106,21 @@ public function testFetchingFailsWithException()
         $this->expectException(Exception::class);
         $class->fetch();
     }
+
+    public function testHasAccessTokenSet()
+    {
+        $config = $this->config;
+        $config['private_access_token'] = 'abc123';
+
+        $class = new GithubRepositoryType($this->client, $config);
+        $this->assertTrue($class->hasAccessToken());
+        $this->assertEquals($class->getAccessToken(), 'Bearer abc123');
+    }
+
+    public function testHasAccessTokenNotSet()
+    {
+        $class = new GithubRepositoryType($this->client, $this->config);
+        $this->assertFalse($class->hasAccessToken());
+        $this->assertEquals($class->getAccessToken(), 'Bearer ');
+    }
 }

tests/TestCase.php

@@ -28,12 +28,14 @@ protected function getEnvironmentSetUp($app)
                     'repository_name' => 'laravel',
                     'repository_url' => '',
                     'download_path' => '/tmp',
+                    'private_access_token' => '',
                 ],
                 'http' => [
                     'type' => 'http',
                     'repository_url' => env('SELF_UPDATER_REPO_URL', ''),
                     'pkg_filename_format' => env('SELF_UPDATER_PKG_FILENAME_FORMAT', 'v_VERSION_'),
                     'download_path' => env('SELF_UPDATER_DOWNLOAD_PATH', '/tmp'),
+                    'private_access_token' => '',
                 ],
             ],
             'log_events' => false,