Add application API and OpenAPI docs

app/Http/Controllers/Api/Settings/GitConnectionController.php

@@ -0,0 +1,68 @@
+<?php
+
+namespace App\Http\Controllers\Api\Settings;
+
+use App\Actions\UserGitConnections\DeleteUserGitConnection;
+use App\Actions\UserGitConnections\StoreUserGitConnection;
+use App\Actions\UserGitConnections\UpdateUserGitConnection;
+use App\Http\Controllers\Api\ApiController;
+use App\Http\Requests\Settings\StoreUserGitConnectionRequest;
+use App\Http\Requests\Settings\UpdateUserGitConnectionRequest;
+use App\Http\Resources\UserGitConnectionResource;
+use App\Models\UserGitConnection;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+use Illuminate\Http\Resources\Json\AnonymousResourceCollection;
+
+class GitConnectionController extends ApiController
+{
+    public function __construct(
+        private readonly DeleteUserGitConnection $deleteUserGitConnection,
+        private readonly StoreUserGitConnection $storeUserGitConnection,
+        private readonly UpdateUserGitConnection $updateUserGitConnection,
+    ) {}
+
+    public function index(Request $request): AnonymousResourceCollection
+    {
+        return UserGitConnectionResource::collection(
+            $this->authenticatedUser($request)
+                ->gitConnections()
+                ->get(),
+        );
+    }
+
+    public function store(StoreUserGitConnectionRequest $request): JsonResponse
+    {
+        $gitConnection = $this->storeUserGitConnection->handle($this->authenticatedUser($request), $request->validated());
+
+        return UserGitConnectionResource::make($gitConnection)
+            ->additional(['meta' => ['message' => 'Git connection was added.']])
+            ->response()
+            ->setStatusCode(201);
+    }
+
+    public function update(UpdateUserGitConnectionRequest $request, UserGitConnection $gitConnection): JsonResponse
+    {
+        $this->abortUnlessOwner($request, $gitConnection);
+
+        $gitConnection = $this->updateUserGitConnection->handle($gitConnection, $request->validated());
+
+        return UserGitConnectionResource::make($gitConnection)
+            ->additional(['meta' => ['message' => 'Git connection was updated.']])
+            ->response();
+    }
+
+    public function destroy(Request $request, UserGitConnection $gitConnection): JsonResponse
+    {
+        $this->abortUnlessOwner($request, $gitConnection);
+
+        $this->deleteUserGitConnection->handle($gitConnection);
+
+        return response()->json(null, 204);
+    }
+
+    private function abortUnlessOwner(Request $request, UserGitConnection $gitConnection): void
+    {
+        abort_unless($gitConnection->user_id === $this->authenticatedUser($request)->id, 403);
+    }
+}