Implement Release Notes page

app/Providers/AppServiceProvider.php

@@ -26,7 +26,10 @@ public function boot(): void
 
     private function registerSharedViewVariables(): void
     {
-        View::share('electronGitHubVersion', GitHub::electron()->latestVersion());
+        View::share('electronGitHubVersion', app()->environment('production')
+            ? GitHub::electron()->latestVersion()
+            : 'dev'
+        );
         View::share('discordLink', 'https://discord.gg/X62tWNStZK');
         View::share('bskyLink', 'https://bsky.app/profile/nativephp.bsky.social');
         View::share('openCollectiveLink', 'https://opencollective.com/nativephp');

app/Support/GitHub.php

@@ -2,6 +2,8 @@
 
 namespace App\Support;
 
+use App\Support\GitHub\Release;
+use Illuminate\Support\Collection;
 use Illuminate\Support\Facades\Cache;
 use Illuminate\Support\Facades\Http;
 
@@ -27,18 +29,25 @@ public static function laravel(): static
 
     public function latestVersion()
     {
-        $version = Cache::remember(
+        $release = Cache::remember(
             $this->getCacheKey('latest-version'),
             now()->addHour(),
-            function () {
-                return $this->fetchLatestVersion();
-            }
+            fn () => $this->fetchLatestVersion()
         );
 
-        return $version['name'] ?? 'Unknown';
+        return $release?->name ?? 'Unknown';
     }
 
-    private function fetchLatestVersion()
+    public function releases(): Collection
+    {
+        return Cache::remember(
+            $this->getCacheKey('releases'),
+            now()->addHour(),
+            fn () => $this->fetchReleases()
+        ) ?? collect();
+    }
+
+    private function fetchLatestVersion(): ?Release
     {
         // Make a request to GitHub
         $response = Http::get('https://api.github.com/repos/'.$this->package.'/releases/latest');
@@ -48,11 +57,24 @@ private function fetchLatestVersion()
             return null;
         }
 
-        return $response->json();
+        return new Release($response->json());
     }
 
     private function getCacheKey(string $string): string
     {
         return sprintf('%s-%s', $this->package, $string);
     }
+
+    private function fetchReleases(): ?Collection
+    {
+        // Make a request to GitHub
+        $response = Http::get('https://api.github.com/repos/'.$this->package.'/releases');
+
+        // Check if the request was successful
+        if ($response->failed()) {
+            return collect();
+        }
+
+        return collect($response->json())->map(fn (array $release) => new Release($release));
+    }
 }

app/Support/GitHub/Release.php

@@ -0,0 +1,92 @@
+<?php
+
+namespace App\Support\GitHub;
+
+/**
+ * @property string $url
+ * @property string $assets_url
+ * @property string $upload_url
+ * @property string $html_url
+ * @property int $id
+ * @property array $author
+ * @property string $node_id
+ * @property string $tag_name
+ * @property string $target_commitish
+ * @property string $name
+ * @property bool $draft
+ * @property bool $prerelease
+ * @property string $created_at
+ * @property string $published_at
+ * @property array $assets
+ * @property string $tarball_url
+ * @property string $zipball_url
+ * @property string $body
+ * @property int $mentions_count
+ */
+class Release
+{
+    private bool $withUserLinks = true;
+
+    private bool $convertLinks = true;
+
+    public function __construct(
+        private array $data
+    ) {
+        //
+    }
+
+    public function __get(string $name)
+    {
+        return $this->data[$name] ?? null;
+    }
+
+    public function __isset(string $name): bool
+    {
+        return isset($this->data[$name]);
+    }
+
+    public function getBodyForMarkdown(): string
+    {
+        $body = $this->body;
+
+        // Convert any URLs to Markdown links
+        if ($this->convertLinks) {
+            $body = preg_replace(
+                '/https?:\/\/[^\s]+\/pull\/(\d+)/',
+                '[#$1]($0)',
+                $body
+            );
+
+            $body = preg_replace(
+                '/(https?:\/\/(?![^\s]+\/pull\/\d+)[^\s]+)/',
+                '[$1]($1)',
+                $body
+            );
+        }
+
+        // Change any @ tags to markdown links to GitHub
+        if ($this->withUserLinks) {
+            $body = preg_replace(
+                '/@([a-zA-Z0-9_]+)/',
+                '[@$1](https://github.com/$1)',
+                $body
+            );
+        }
+
+        return preg_replace('/^#/m', '##', $body);
+    }
+
+    public function withoutUserLinks(bool $withoutUserLinks = true): static
+    {
+        $this->withUserLinks = ! $withoutUserLinks;
+
+        return $this;
+    }
+
+    public function withoutLinkConversion(bool $convertLinks = true): static
+    {
+        $this->convertLinks = ! $convertLinks;
+
+        return $this;
+    }
+}