2021-06-26 11:23:15 -04:00
|
|
|
<?php
|
|
|
|
|
|
|
|
namespace Tests\Api;
|
2019-12-30 14:42:46 -05:00
|
|
|
|
2023-03-14 15:29:08 -04:00
|
|
|
use BookStack\Auth\User;
|
|
|
|
|
2019-12-30 14:42:46 -05:00
|
|
|
trait TestsApi
|
|
|
|
{
|
2023-03-14 15:29:08 -04:00
|
|
|
protected string $apiTokenId = 'apitoken';
|
|
|
|
protected string $apiTokenSecret = 'password';
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Set the given user as the current logged-in user via the API driver.
|
|
|
|
* This does not ensure API access. The user may still lack required role permissions.
|
|
|
|
*/
|
|
|
|
protected function actingAsForApi(User $user): static
|
|
|
|
{
|
|
|
|
parent::actingAs($user, 'api');
|
|
|
|
|
|
|
|
return $this;
|
|
|
|
}
|
2019-12-30 14:42:46 -05:00
|
|
|
|
2019-12-30 15:48:23 -05:00
|
|
|
/**
|
|
|
|
* Set the API editor role as the current user via the API driver.
|
|
|
|
*/
|
2023-03-14 15:29:08 -04:00
|
|
|
protected function actingAsApiEditor(): static
|
2019-12-30 14:42:46 -05:00
|
|
|
{
|
2023-01-21 06:08:34 -05:00
|
|
|
$this->actingAs($this->users->editor(), 'api');
|
2021-06-26 11:23:15 -04:00
|
|
|
|
2019-12-30 15:48:23 -05:00
|
|
|
return $this;
|
2019-12-30 14:42:46 -05:00
|
|
|
}
|
|
|
|
|
2021-10-19 19:58:56 -04:00
|
|
|
/**
|
|
|
|
* Set the API admin role as the current user via the API driver.
|
|
|
|
*/
|
2023-03-14 15:29:08 -04:00
|
|
|
protected function actingAsApiAdmin(): static
|
2021-10-19 19:58:56 -04:00
|
|
|
{
|
2023-01-21 06:08:34 -05:00
|
|
|
$this->actingAs($this->users->admin(), 'api');
|
2021-10-19 19:58:56 -04:00
|
|
|
|
|
|
|
return $this;
|
|
|
|
}
|
|
|
|
|
2019-12-30 15:48:23 -05:00
|
|
|
/**
|
|
|
|
* Format the given items into a standardised error format.
|
|
|
|
*/
|
|
|
|
protected function errorResponse(string $message, int $code): array
|
|
|
|
{
|
2021-06-26 11:23:15 -04:00
|
|
|
return ['error' => ['code' => $code, 'message' => $message]];
|
2019-12-30 15:48:23 -05:00
|
|
|
}
|
|
|
|
|
2022-02-03 19:26:19 -05:00
|
|
|
/**
|
|
|
|
* Get the structure that matches a permission error response.
|
|
|
|
*/
|
|
|
|
protected function permissionErrorResponse(): array
|
|
|
|
{
|
|
|
|
return $this->errorResponse('You do not have permission to perform the requested action.', 403);
|
|
|
|
}
|
|
|
|
|
2020-05-22 19:28:41 -04:00
|
|
|
/**
|
|
|
|
* Format the given (field_name => ["messages"]) array
|
|
|
|
* into a standard validation response format.
|
|
|
|
*/
|
|
|
|
protected function validationResponse(array $messages): array
|
|
|
|
{
|
2021-06-26 11:23:15 -04:00
|
|
|
$err = $this->errorResponse('The given data was invalid.', 422);
|
2020-05-22 19:28:41 -04:00
|
|
|
$err['error']['validation'] = $messages;
|
2021-06-26 11:23:15 -04:00
|
|
|
|
2020-05-22 19:28:41 -04:00
|
|
|
return $err;
|
|
|
|
}
|
2021-06-26 11:23:15 -04:00
|
|
|
|
2019-12-30 15:48:23 -05:00
|
|
|
/**
|
|
|
|
* Get an approved API auth header.
|
|
|
|
*/
|
|
|
|
protected function apiAuthHeader(): array
|
2019-12-30 14:51:41 -05:00
|
|
|
{
|
|
|
|
return [
|
2021-06-26 11:23:15 -04:00
|
|
|
'Authorization' => "Token {$this->apiTokenId}:{$this->apiTokenSecret}",
|
2019-12-30 14:51:41 -05:00
|
|
|
];
|
|
|
|
}
|
2021-06-26 11:23:15 -04:00
|
|
|
}
|