Merge branch 'main' into pr/542

Author: saade

.gitignore

@@ -2,6 +2,7 @@
 /node_modules
 /node_modules.nosync
 /public/build
+/public/api
 /public/hot
 /public/storage
 /storage/*.key

app/Http/Controllers/Api/AuthorController.php

@@ -0,0 +1,19 @@
+<?php
+
+namespace App\Http\Controllers\Api;
+
+use App\Http\Controllers\Controller;
+use App\Models\Author;
+
+class AuthorController extends Controller
+{
+    public function index()
+    {
+        return Author::paginate();
+    }
+
+    public function show(Author $author)
+    {
+        return $author->append('stars_count');
+    }
+}

app/Models/Author.php

@@ -3,6 +3,7 @@
 namespace App\Models;
 
 use Illuminate\Database\Eloquent\Builder;
+use Illuminate\Database\Eloquent\Casts\Attribute;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\HasMany;
@@ -63,6 +64,13 @@ public function getStarsCount(): int
         );
     }
 
+    protected function starsCount(): Attribute
+    {
+        return Attribute::make(
+            get: fn () => $this->getStarsCount(),
+        );
+    }
+
     public function cacheStarsCount(): void
     {
         cache()->forget($this->getStarsCountCacheKey());

build/api.sh

@@ -0,0 +1,35 @@
+#!/bin/bash
+
+set -e
+
+base=$(pwd)
+doctum=${base}/build/doctum
+
+if [ ! -f ${base}/composer.json ]; then
+    echo "Please make sure to run this script from the root directory of this repo."
+    exit 1
+fi
+
+cd $doctum
+composer install
+
+# Cleanup Before
+rm -rf ${doctum}/build
+rm -rf ${doctum}/cache
+rm -rf ${doctum}/filament
+
+# Run API Docs
+git clone [email protected]:filamentphp/filament.git ${doctum}/filament
+
+${doctum}/vendor/bin/doctum.php update ${doctum}/doctum.php -v --ignore-parse-errors
+
+# Delete old directory before copying new one
+rm -rf ${base}/public/api
+
+# Copy new docs to public path
+cp -R ${doctum}/build ${base}/public/api
+
+# Cleanup After
+rm -rf ${doctum}/build
+rm -rf ${doctum}/cache
+rm -rf ${doctum}/filament

build/doctum/.gitignore

@@ -0,0 +1 @@
+/vendor

build/doctum/composer.json

@@ -0,0 +1,5 @@
+{
+    "require": {
+        "code-lts/doctum": "^5.5"
+    }
+}