mirror of
https://github.com/BookStackApp/BookStack.git
synced 2024-08-28 21:22:30 +00:00
![Dan Brown](/assets/img/avatar_default.png)
Made the following changes, many of these are just to align with existing conventions. - Updated urls to be hypenated, instead of underscored, to match other system endpoints. - Updated URL parameter to be `deletionId` instead of `id`, and removed the ID-based comment on controller methods, so the required ID model is clear from the URL alone, since its not clear from the URL endpoint alone like existing endpoints. This follows the pattern used in the "web" routes. - Added extra detail on some controller method comments, and copied permission comment to each method. - Removed existing field visibility mechanisms to use simpler model-based visibility since we didn't need anything too special here (After some of my other changes). - Allowed the "deletable" model to be shown in response to provide a little more detail on the main deleted item. - Updated parent/child-count loading to be on the "deletable" model instead of additional properties which results in simpler controller logic and enforces the idea these are relations on the deletable, not the deletion itself. It also removes additional exposure of model namespacing. - Updated (int) casts to intval, just since that's our most common conversion method in the codebase. - Testing: Removed `actingAsAuthorizedUser` and used the admin user instead to prevent extra auth steps on each test. - Testing: Cut logic/data-checks from tests if already covered by other tests. - Testing: Added simple assertions for delete/restore response data. - Examples: Updated list example to reflect changes. Review of PR #3377 To be followed up with changes to polymorphic relations to hide namespacing.
185 lines
5.4 KiB
PHP
185 lines
5.4 KiB
PHP
<?php
|
|
|
|
namespace Tests\Api;
|
|
|
|
use BookStack\Entities\Models\Book;
|
|
use BookStack\Entities\Models\Deletion;
|
|
use BookStack\Entities\Models\Page;
|
|
use Illuminate\Support\Collection;
|
|
use Tests\TestCase;
|
|
|
|
class RecycleBinApiTest extends TestCase
|
|
{
|
|
use TestsApi;
|
|
|
|
protected string $baseEndpoint = '/api/recycle-bin';
|
|
|
|
protected array $endpointMap = [
|
|
['get', '/api/recycle-bin'],
|
|
['put', '/api/recycle-bin/1'],
|
|
['delete', '/api/recycle-bin/1'],
|
|
];
|
|
|
|
public function test_settings_manage_permission_needed_for_all_endpoints()
|
|
{
|
|
$editor = $this->getEditor();
|
|
$this->giveUserPermissions($editor, ['settings-manage']);
|
|
$this->actingAs($editor);
|
|
|
|
foreach ($this->endpointMap as [$method, $uri]) {
|
|
$resp = $this->json($method, $uri);
|
|
$resp->assertStatus(403);
|
|
$resp->assertJson($this->permissionErrorResponse());
|
|
}
|
|
}
|
|
|
|
public function test_restrictions_manage_all_permission_needed_for_all_endpoints()
|
|
{
|
|
$editor = $this->getEditor();
|
|
$this->giveUserPermissions($editor, ['restrictions-manage-all']);
|
|
$this->actingAs($editor);
|
|
|
|
foreach ($this->endpointMap as [$method, $uri]) {
|
|
$resp = $this->json($method, $uri);
|
|
$resp->assertStatus(403);
|
|
$resp->assertJson($this->permissionErrorResponse());
|
|
}
|
|
}
|
|
|
|
public function test_index_endpoint_returns_expected_page()
|
|
{
|
|
$admin = $this->getAdmin();
|
|
|
|
$page = Page::query()->first();
|
|
$book = Book::query()->first();
|
|
$this->actingAs($admin)->delete($page->getUrl());
|
|
$this->delete($book->getUrl());
|
|
|
|
$deletions = Deletion::query()->orderBy('id')->get();
|
|
|
|
$resp = $this->getJson($this->baseEndpoint);
|
|
|
|
$expectedData = $deletions
|
|
->zip([$page, $book])
|
|
->map(function (Collection $data) use ($admin) {
|
|
return [
|
|
'id' => $data[0]->id,
|
|
'deleted_by' => $admin->id,
|
|
'created_at' => $data[0]->created_at->toJson(),
|
|
'updated_at' => $data[0]->updated_at->toJson(),
|
|
'deletable_type' => $data[1]->getMorphClass(),
|
|
'deletable_id' => $data[1]->id,
|
|
'deletable' => [
|
|
'name' => $data[1]->name,
|
|
],
|
|
];
|
|
});
|
|
|
|
$resp->assertJson([
|
|
'data' => $expectedData->values()->all(),
|
|
'total' => 2,
|
|
]);
|
|
}
|
|
|
|
public function test_index_endpoint_returns_children_count()
|
|
{
|
|
$admin = $this->getAdmin();
|
|
|
|
$book = Book::query()->whereHas('pages')->whereHas('chapters')->withCount(['pages', 'chapters'])->first();
|
|
$this->actingAs($admin)->delete($book->getUrl());
|
|
|
|
$deletion = Deletion::query()->orderBy('id')->first();
|
|
|
|
$resp = $this->getJson($this->baseEndpoint);
|
|
|
|
$expectedData = [
|
|
[
|
|
'id' => $deletion->id,
|
|
'deletable' => [
|
|
'pages_count' => $book->pages_count,
|
|
'chapters_count' => $book->chapters_count,
|
|
],
|
|
],
|
|
];
|
|
|
|
$resp->assertJson([
|
|
'data' => $expectedData,
|
|
'total' => 1,
|
|
]);
|
|
}
|
|
|
|
public function test_index_endpoint_returns_parent()
|
|
{
|
|
$admin = $this->getAdmin();
|
|
$page = Page::query()->whereHas('chapter')->with('chapter')->first();
|
|
|
|
$this->actingAs($admin)->delete($page->getUrl());
|
|
$deletion = Deletion::query()->orderBy('id')->first();
|
|
|
|
$resp = $this->getJson($this->baseEndpoint);
|
|
|
|
$expectedData = [
|
|
[
|
|
'id' => $deletion->id,
|
|
'deletable' => [
|
|
'parent' => [
|
|
'id' => $page->chapter->id,
|
|
'name' => $page->chapter->name,
|
|
'type' => 'chapter'
|
|
]
|
|
]
|
|
],
|
|
];
|
|
|
|
$resp->assertJson([
|
|
'data' => $expectedData,
|
|
'total' => 1,
|
|
]);
|
|
}
|
|
|
|
public function test_restore_endpoint()
|
|
{
|
|
$page = Page::query()->first();
|
|
$this->asAdmin()->delete($page->getUrl());
|
|
$page->refresh();
|
|
|
|
$deletion = Deletion::query()->orderBy('id')->first();
|
|
|
|
$this->assertDatabaseHas('pages', [
|
|
'id' => $page->id,
|
|
'deleted_at' => $page->deleted_at,
|
|
]);
|
|
|
|
$resp = $this->putJson($this->baseEndpoint . '/' . $deletion->id);
|
|
$resp->assertJson([
|
|
'restore_count' => 1
|
|
]);
|
|
|
|
$this->assertDatabaseHas('pages', [
|
|
'id' => $page->id,
|
|
'deleted_at' => null,
|
|
]);
|
|
}
|
|
|
|
public function test_destroy_endpoint()
|
|
{
|
|
$page = Page::query()->first();
|
|
$this->asAdmin()->delete($page->getUrl());
|
|
$page->refresh();
|
|
|
|
$deletion = Deletion::query()->orderBy('id')->first();
|
|
|
|
$this->assertDatabaseHas('pages', [
|
|
'id' => $page->id,
|
|
'deleted_at' => $page->deleted_at,
|
|
]);
|
|
|
|
$resp = $this->deleteJson($this->baseEndpoint . '/' . $deletion->id);
|
|
$resp->assertJson([
|
|
'delete_count' => 1
|
|
]);
|
|
|
|
$this->assertDatabaseMissing('pages', ['id' => $page->id]);
|
|
}
|
|
}
|