Add support for posting content via a REST API

app/Http/Controllers/Articles/ArticlesController.php

@@ -6,6 +6,7 @@
 use App\Http\Controllers\Controller;
 use App\Http\Middleware\Authenticate;
 use App\Http\Requests\ArticleRequest;
+use App\Http\Resources\ArticleResource;
 use App\Jobs\CreateArticle;
 use App\Jobs\DeleteArticle;
 use App\Jobs\UpdateArticle;
@@ -101,11 +102,13 @@ public function create()
 
     public function store(ArticleRequest $request)
     {
-        $article = $this->dispatchNow(CreateArticle::fromRequest($request));
+        $article = $this->dispatchSync(CreateArticle::fromRequest($request));
 
         $this->success($request->shouldBeSubmitted() ? 'articles.submitted' : 'articles.created');
 
-        return redirect()->route('articles.show', $article->slug());
+        return $request->expectsJson()
+            ? ArticleResource::make($article)
+            : redirect()->route('articles.show', $article->slug());
     }
 
     public function edit(Article $article)

app/Http/Controllers/Settings/ApiTokenController.php

@@ -0,0 +1,34 @@
+<?php
+
+namespace App\Http\Controllers\Settings;
+
+use App\Http\Controllers\Controller;
+use App\Http\Requests\DeleteApiTokenRequest;
+use App\Http\Requests\CreateApiTokenRequest;
+use App\Jobs\CreateApiToken;
+use App\Jobs\DeleteApiToken;
+use Illuminate\Auth\Middleware\Authenticate;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\Auth;
+
+class ApiTokenController extends Controller
+{
+    public function __construct()
+    {
+        $this->middleware(Authenticate::class);
+    }
+
+    public function store(CreateApiTokenRequest $request)
+    {
+        $this->dispatchSync(new CreateApiToken(Auth::user(), $request->name()));
+
+        return redirect()->route('settings.profile');
+    }
+
+    public function destroy(DeleteApiTokenRequest $request)
+    {
+        $this->dispatchSync(new DeleteApiToken(Auth::user(), $request->id()));
+
+        return redirect()->route('settings.profile');
+    }
+}

app/Http/Requests/CreateApiTokenRequest.php

@@ -0,0 +1,22 @@
+<?php
+
+namespace App\Http\Requests;
+
+use Illuminate\Foundation\Http\FormRequest;
+
+class CreateApiTokenRequest extends FormRequest
+{
+
+    public function rules(): array
+    {
+        return [
+            'name' => ['required', 'string', 'max:255']
+        ];
+    }
+
+    public function name(): string
+    {
+        return (string) $this->get('name');
+    }
+
+}

app/Http/Requests/DeleteApiTokenRequest.php

@@ -0,0 +1,22 @@
+<?php
+
+namespace App\Http\Requests;
+
+use Illuminate\Foundation\Http\FormRequest;
+
+class DeleteApiTokenRequest extends FormRequest
+{
+
+    public function rules(): array
+    {
+        return [
+            'id' => ['required', 'exists:personal_access_tokens,id'],
+        ];
+    }
+
+    public function id(): string
+    {
+        return (string) $this->get('id');
+    }
+
+}

app/Http/Resources/ArticleResource.php

@@ -0,0 +1,27 @@
+<?php
+
+namespace App\Http\Resources;
+
+use Illuminate\Http\Resources\Json\JsonResource;
+
+class ArticleResource extends JsonResource
+{
+    /**
+     * @param  \Illuminate\Http\Request  $request
+     */
+    public function toArray($request): array
+    {
+        return [
+            'id' => $this->getKey(),
+            'url' => route('articles.show', $this->slug()),
+            'title' => $this->title(),
+            'body' => $this->body(),
+            'original_url' => $this->originalUrl(),
+            'author' => AuthorResource::make($this->author()),
+            'tags' => TagResource::collection($this->tags()),
+            'is_submitted' => $this->isSubmitted(),
+            'created_at' => $this->createdAt(),
+            'updated_at' => $this->updatedAt(),
+        ];
+    }
+}

app/Http/Resources/AuthorResource.php

@@ -0,0 +1,23 @@
+<?php
+
+namespace App\Http\Resources;
+
+use Illuminate\Http\Resources\Json\JsonResource;
+
+class AuthorResource extends JsonResource
+{
+    /**
+     * @param  \Illuminate\Http\Request  $request
+     */
+    public function toArray($request): array
+    {
+        return [
+            'id' => $this->getKey(),
+            'email' => $this->emailAddress(),
+            'name' => $this->name(),
+            'bio' => $this->bio(),
+            'twitter_handle' => $this->twitter(),
+            'github_username' => $this->githubUsername(),
+        ];
+    }
+}

app/Http/Resources/TagResource.php

@@ -0,0 +1,20 @@
+<?php
+
+namespace App\Http\Resources;
+
+use Illuminate\Http\Resources\Json\JsonResource;
+
+class TagResource extends JsonResource
+{
+    /**
+     * @param \Illuminate\Http\Request $request
+     */
+    public function toArray($request): array
+    {
+        return [
+            'id' => $this->getKey(),
+            'name' => $this->name(),
+            'slug' => $this->slug(),
+        ];
+    }
+}

app/Jobs/CreateApiToken.php

@@ -0,0 +1,28 @@
+<?php
+
+namespace App\Jobs;
+
+use App\Models\User;
+use Illuminate\Bus\Queueable;
+use Illuminate\Contracts\Queue\ShouldBeUnique;
+use Illuminate\Contracts\Queue\ShouldQueue;
+use Illuminate\Foundation\Bus\Dispatchable;
+use Illuminate\Queue\InteractsWithQueue;
+use Illuminate\Queue\SerializesModels;
+
+class CreateApiToken implements ShouldQueue
+{
+    use Dispatchable, InteractsWithQueue, Queueable, SerializesModels;
+
+    public function __construct(
+        private User $user,
+        private string $name,
+    )
+    {
+    }
+
+    public function handle(): void
+    {
+        $this->user->createToken($this->name);
+    }
+}

app/Jobs/DeleteApiToken.php

@@ -0,0 +1,25 @@
+<?php
+
+namespace App\Jobs;
+
+use App\Models\User;
+use Illuminate\Bus\Queueable;
+use Illuminate\Contracts\Queue\ShouldBeUnique;
+use Illuminate\Contracts\Queue\ShouldQueue;
+use Illuminate\Foundation\Bus\Dispatchable;
+use Illuminate\Queue\InteractsWithQueue;
+use Illuminate\Queue\SerializesModels;
+
+class DeleteApiToken implements ShouldQueue
+{
+    use Dispatchable, InteractsWithQueue, Queueable, SerializesModels;
+
+    public function __construct(private User $user, private int $tokenId)
+    {
+    }
+
+    public function handle(): void
+    {
+        $this->user->tokens()->where('id', $this->tokenId)->delete();
+    }
+}

app/Models/User.php

@@ -10,9 +10,11 @@
 use Illuminate\Foundation\Auth\User as Authenticatable;
 use Illuminate\Notifications\Notifiable;
 use Illuminate\Support\Facades\Auth;
+use Laravel\Sanctum\HasApiTokens;
 
 final class User extends Authenticatable implements MustVerifyEmail
 {
+    use HasApiTokens;
     use HasFactory;
     use HasTimestamps;
     use Notifiable;

app/Providers/RouteServiceProvider.php

@@ -4,6 +4,7 @@
 
 use Illuminate\Cache\RateLimiting\Limit;
 use Illuminate\Foundation\Support\Providers\RouteServiceProvider as ServiceProvider;
+use Illuminate\Http\Request;
 use Illuminate\Support\Facades\RateLimiter;
 use Illuminate\Support\Facades\Route;
 

composer.json

@@ -21,6 +21,7 @@
         "laravel-notification-channels/twitter": "^5.0",
         "laravel/framework": "8.75.0",
         "laravel/horizon": "^5.2",
+        "laravel/sanctum": "^2.13",
         "laravel/slack-notification-channel": "^2.3",
         "laravel/socialite": "^5.0",
         "laravel/ui": "^3.0",