Add application API and OpenAPI docs
linter / quality (pull_request) Successful in 1m18s
tests / ci (8.4) (pull_request) Successful in 1m28s

This commit is contained in:
2026-04-20 13:22:56 +02:00
parent 70d760e3a6
commit 8b25421e7c
80 changed files with 6908 additions and 1277 deletions
@@ -2,8 +2,9 @@
namespace App\Http\Controllers\Settings;
use App\Actions\Git\GitProviderKey;
use App\Actions\Git\GitProviderManager;
use App\Actions\UserGitConnections\DeleteUserGitConnection;
use App\Actions\UserGitConnections\StoreUserGitConnection;
use App\Actions\UserGitConnections\UpdateUserGitConnection;
use App\Http\Controllers\Controller;
use App\Http\Requests\Settings\StoreUserGitConnectionRequest;
use App\Http\Requests\Settings\UpdateUserGitConnectionRequest;
@@ -11,15 +12,15 @@ use App\Http\Resources\UserGitConnectionResource;
use App\Models\UserGitConnection;
use Illuminate\Http\RedirectResponse;
use Illuminate\Http\Request;
use Illuminate\Support\Arr;
use Inertia\Inertia;
use Inertia\Response;
use Throwable;
class GitConnectionController extends Controller
{
public function __construct(
private readonly GitProviderManager $gitProviderManager,
private readonly DeleteUserGitConnection $deleteUserGitConnection,
private readonly StoreUserGitConnection $storeUserGitConnection,
private readonly UpdateUserGitConnection $updateUserGitConnection,
) {}
public function edit(Request $request): Response
@@ -33,35 +34,7 @@ class GitConnectionController extends Controller
public function store(StoreUserGitConnectionRequest $request): RedirectResponse
{
$validated = $request->validated();
$apiToken = Arr::get($validated, 'api_token');
$baseUrl = Arr::get($validated, 'base_url');
$provider = GitProviderKey::from(Arr::get($validated, 'provider'));
$user = $request->user();
try {
$gitProvider = $this->gitProviderManager->client($provider);
$authenticatedUser = $gitProvider->getAuthenticatedUser(
$baseUrl,
$apiToken,
);
} catch (Throwable) {
return back()
->withErrors([
'api_token' => sprintf('%s could not authenticate against Gitea with this base URL and token.', config('app.name')),
]);
}
UserGitConnection::query()->create([
'account_login' => $authenticatedUser->login,
'account_name' => $authenticatedUser->name,
'api_token' => $apiToken,
'base_url' => $baseUrl,
'provider' => $provider,
'provider_user_id' => $authenticatedUser->providerUserId,
'user_id' => $user->id,
]);
$this->storeUserGitConnection->handle($request->user(), $request->validated());
return to_route('git-connections.edit')
->with('status', 'Git connection was added.');
@@ -73,32 +46,7 @@ class GitConnectionController extends Controller
): RedirectResponse {
$this->abortUnlessOwner($request, $gitConnection);
$validated = $request->validated();
$apiToken = Arr::get($validated, 'api_token');
$baseUrl = Arr::get($validated, 'base_url');
$provider = GitProviderKey::from(Arr::get($validated, 'provider'));
try {
$gitProvider = $this->gitProviderManager->client($provider);
$authenticatedUser = $gitProvider->getAuthenticatedUser(
$baseUrl,
$apiToken,
);
} catch (Throwable) {
return back()
->withErrors([
'api_token' => sprintf('%s could not authenticate against Gitea with this base URL and token.', config('app.name')),
]);
}
$gitConnection->update([
'account_login' => $authenticatedUser->login,
'account_name' => $authenticatedUser->name,
'api_token' => $apiToken,
'base_url' => $baseUrl,
'provider' => $provider,
'provider_user_id' => $authenticatedUser->providerUserId,
]);
$this->updateUserGitConnection->handle($gitConnection, $request->validated());
return to_route('git-connections.edit')
->with('status', 'Git connection was updated.');
@@ -108,9 +56,7 @@ class GitConnectionController extends Controller
{
$this->abortUnlessOwner($request, $gitConnection);
$label = "{$gitConnection->account_login} @ {$gitConnection->base_url}";
$gitConnection->delete();
$label = $this->deleteUserGitConnection->handle($gitConnection);
return to_route('git-connections.edit')
->with('status', "{$label} was removed.");