Rename list() -> all() and show() -> get()

Author: GIGABAIT93

docs/applications.md

@@ -40,8 +40,8 @@ Detailed documentation and DTOs are in [Servers (admin)](servers.md).
 
 Key entry points:
 
-- `list(): ServersListBuilder`
-- `show(int $id): ServersItemBuilder`
+- `all(): ServersListBuilder`
+- `get(int $id): ServersItemBuilder`
 - `external(string $externalId): ServersItemBuilder`
 - `create(CreateServerParams): ItemResponse`
 - `update(int $id, ServerDetailsParams): ItemResponse`
@@ -57,7 +57,7 @@ Key entry points:
 Filters & sort
 
 ```php
-$servers = $p->servers->list()
+$servers = $p->servers->all()
     ->filterName('prod')
     ->filterUuid('54f52795-...')
     ->filterExternalId('ext-123')
@@ -71,8 +71,8 @@ $servers = $p->servers->list()
 
 Namespace: `Gigabait93\Applications\Users\Users`
 
-- `list(): UsersListBuilder` → `ListResponse`
-- `show(int $id): UsersItemBuilder` → `ItemResponse`
+- `all(): UsersListBuilder` → `ListResponse`
+- `get(int $id): UsersItemBuilder` → `ItemResponse`
 - `external(string $externalId): UsersItemBuilder`
 - `create(UserCreateParams $params): ItemResponse`
 - `update(int $id, UserUpdateParams $params): ItemResponse`
@@ -100,7 +100,7 @@ $upd = (new \Gigabait93\Applications\Users\Params\UserUpdateParams())
 $update = $p->users->update(42, $upd);
 
 // Filters & sort
-$users = $p->users->list()
+$users = $p->users->all()
     ->filterEmail('john@example.com')
     ->filterUsername('john')
     ->sort('created_at', true)
@@ -111,8 +111,8 @@ $users = $p->users->list()
 
 Namespace: `Gigabait93\Applications\Nodes\Nodes`
 
-- `list(): NodesListBuilder` → `ListResponse`
-- `show(int $id): NodesItemBuilder` → `ItemResponse`
+- `all(): NodesListBuilder` → `ListResponse`
+- `get(int $id): NodesItemBuilder` → `ItemResponse`
 - `create(NodeCreateParams $params): ItemResponse`
 - `update(int $id, NodeUpdateParams $params): ItemResponse`
 - `destroy(int $id): ActionResponse`
@@ -137,7 +137,7 @@ $upd = (new \Gigabait93\Applications\Nodes\Params\NodeUpdateParams())
 $p->nodes->update(10, $upd);
 
 // Filters & sort
-$nodes = $p->nodes->list()
+$nodes = $p->nodes->all()
     ->filterName('eu-')
     ->filterFqdn('node1.example.com')
     ->sort('name')
@@ -148,8 +148,8 @@ $nodes = $p->nodes->list()
 
 Namespace: `Gigabait93\Applications\Locations\Locations`
 
-- `list(): LocationsListBuilder` → `ListResponse`
-- `show(int $id): LocationsItemBuilder` → `ItemResponse`
+- `all(): LocationsListBuilder` → `ListResponse`
+- `get(int $id): LocationsItemBuilder` → `ItemResponse`
 - `create(LocationParams $params): ItemResponse`
 - `update(int $id, LocationParams $params): ItemResponse`
 - `destroy(int $id): ActionResponse`
@@ -159,7 +159,7 @@ DTO
 - `LocationParams(short, long)`
 
 ```php
-$loc = $p->locations->list()
+$loc = $p->locations->all()
     ->filterShort('EU')
     ->sort('created_at', true)
     ->send();
@@ -169,21 +169,21 @@ $loc = $p->locations->list()
 
 Namespace: `Gigabait93\Applications\Nests\Nests`
 
-- `list(): NestsListBuilder` → `ListResponse`
-- `show(int $id): NestsItemBuilder` → `ItemResponse`
+- `all(): NestsListBuilder` → `ListResponse`
+- `get(int $id): NestsItemBuilder` → `ItemResponse`
 
 ## Eggs (admin)
 
 Namespace: `Gigabait93\Applications\Eggs\Eggs`
 
-- `list(int $nestId): EggsListBuilder` → `ListResponse`
-- `show(int $nestId, int $eggId): EggsItemBuilder` → `ItemResponse`
+- `all(int $nestId): EggsListBuilder` → `ListResponse`
+- `get(int $nestId, int $eggId): EggsItemBuilder` → `ItemResponse`
 
 ## Allocations (admin)
 
 Namespace: `Gigabait93\Applications\Allocations\Allocations`
 
-- `list(int $nodeId): ListBuilder` (returns `ListResponse`)
+- `all(int $nodeId): ListBuilder` (returns `ListResponse`)
 - `create(int $nodeId, AllocationCreateParams $params): ActionResponse`
 - `destroy(int $nodeId, int $allocationId): ActionResponse`
 

docs/client.md

@@ -47,7 +47,7 @@ $p->server->command($uuid, 'say hello');
 
 Namespace: `Gigabait93\Client\Files\Files`
 
-- `list(string $uuidShort, string $path = '/'): ListBuilder`
+- `all(string $uuidShort, string $path = '/'): ListBuilder`
 - `read(string $uuidShort, string $filePath): ItemResponse`
 - `download(string $uuidShort, string $filePath): ItemResponse`
 - `rename(string $uuidShort, string $old, string $new, string $path = '/'): ActionResponse`
@@ -69,13 +69,13 @@ UploadBuilder (namespace `Gigabait93\Client\Files\Builders`):
 - `addContents(string $name, string $contents, ?string $mime = null): self`
 - `addMany(array $items): self`
 - `send(?string $signedUrl = null): ActionResponse`
-- `sendAndVerify(?string $signedUrl = null): ActionResponse` — verifies with Files::list()
+- `sendAndVerify(?string $signedUrl = null): ActionResponse` — verifies with Files::all()
 
 ### Database
 
 Namespace: `Gigabait93\Client\Database\Database`
 
-- `list(string $uuidShort): ListBuilder`
+- `all(string $uuidShort): ListBuilder`
 - `create(string $uuidShort, string $database, string $remote = '%'): ItemResponse`
 - `resetPassword(string $uuidShort, string $database): ActionResponse`
 - `destroy(string $uuidShort, string $database): ActionResponse`
@@ -84,8 +84,8 @@ Namespace: `Gigabait93\Client\Database\Database`
 
 Namespace: `Gigabait93\Client\Backups\Backups`
 
-- `list(string $uuidShort): ListBuilder`
-- `show(string $uuidShort, string $backup): ItemResponse`
+- `all(string $uuidShort): ListBuilder`
+- `get(string $uuidShort, string $backup): ItemResponse`
 - `download(string $uuidShort, string $backup): ItemResponse`
 - `create(string $uuidShort, string $name, string $ignored = ''): ItemResponse`
 - `destroy(string $uuidShort, string $backup): ActionResponse`
@@ -96,8 +96,8 @@ Namespace: `Gigabait93\Client\Backups\Backups`
 
 Namespace: `Gigabait93\Client\Schedules\Schedules`
 
-- `list(string $uuidShort): ListBuilder`
-- `show(string $uuidShort, string $scheduleId): ItemResponse`
+- `all(string $uuidShort): ListBuilder`
+- `get(string $uuidShort, string $scheduleId): ItemResponse`
 - `create(string $uuidShort, ...): ItemResponse`
 - `update(string $uuidShort, int $scheduleId, ...): ItemResponse`
 - `execute(string $uuidShort, int $scheduleId): ActionResponse`
@@ -110,7 +110,7 @@ Namespace: `Gigabait93\Client\Schedules\Schedules`
 
 Namespace: `Gigabait93\Client\Network\Network`
 
-- `list(string $uuidShort): ListBuilder`
+- `all(string $uuidShort): ListBuilder`
 - `assignAllocation(string $uuidShort): ActionResponse`
 - `setNote(string $uuidShort, string $allocationId, string $note): ActionResponse`
 - `setPrimary(string $uuidShort, string $allocationId): ActionResponse`
@@ -135,7 +135,7 @@ Namespace: `Gigabait93\Client\Settings\Settings`
 
 Namespace: `Gigabait93\Client\Subusers\Subusers`
 
-- `list(string $uuidShort): ListBuilder`
+- `all(string $uuidShort): ListBuilder`
 - `create(string $uuidShort, string $email, array $permissions): ItemResponse`
 - `update(string $uuidShort, string $subuserUuid, array $permissions): ItemResponse`
 - `destroy(string $uuidShort, string $subuserUuid): ActionResponse`
@@ -145,7 +145,7 @@ Namespace: `Gigabait93\Client\Subusers\Subusers`
 List files and download one:
 
 ```php
-$files = $p->files->list($uuid, '/')->send();
+$files = $p->files->all($uuid, '/')->send();
 foreach ($files->data as $it) {
     $name = $it['attributes']['name'] ?? '';
     if ($name === 'server.properties') {

docs/responses.md

@@ -81,7 +81,7 @@ Represents `/{id}` endpoints and holds `id` as `readonly`.
 ## Notes
 
 - All Client and Application modules follow the same patterns:
-  - `list()` returns a `ListBuilder`
-  - `show(...)` returns an `ItemBuilder`
+  - `all()` returns a `ListBuilder`
+  - `get(...)` returns an `ItemBuilder`
   - write operations return `ItemResponse` or `ActionResponse`
 - Use `->ok` to check success and `->explain()` to get human-friendly error context.

docs/servers.md

@@ -17,25 +17,25 @@ use Gigabait93\Pterodactyl;
 $p = Pterodactyl::make('https://panel.example.com', 'ptlc_xxx'); // Client Admin token
 ```
 
-## List and show
+## List and get
 
-- `Servers::list(): ServersListBuilder` — call `->send()` to get `ServersListResponse` (ListResponse subtype)
-- `Servers::show(int $id): ServersItemBuilder` — resolves an item context (admin)
+- `Servers::all(): ServersListBuilder` — call `->send()` to get `ServersListResponse` (ListResponse subtype)
+- `Servers::get(int $id): ServersItemBuilder` — resolves an item context (admin)
 - `Servers::external(string $externalId): ServersItemBuilder` — by external id
 
 Example
 
 ```php
-$list = $p->servers->list()->perPage(50)->send();
+$list = $p->servers->all()->perPage(50)->send();
 $firstId = $list->ok ? (int)($list->data[0]['attributes']['id'] ?? 0) : 0;
-$server = $p->servers->show($firstId); // ServersItemBuilder
+$server = $p->servers->get($firstId); // ServersItemBuilder
 ```
 
 ### Filters & Sort (list)
 
 ```php
 // Filter servers and order
-$list = $p->servers->list()
+$list = $p->servers->all()
     ->filterName('prod')
     ->filterExternalId('crm-42')
     ->sort('name')        // asc
@@ -138,7 +138,7 @@ Client shortcuts (uuidShort auto-resolved and cached):
 - Startup (client): `startupVars()`, `startupVarsUpdate(array $data)`
 - Settings (client): `settingsRename(name)`, `settingsSetDockerImage(image)`
 
-The builder resolves `uuidShort` on first use via admin `show()` data and caches it.
+The builder resolves `uuidShort` on first use via admin `get()` data and caches it.
 
 ## Responses and errors
 
@@ -169,7 +169,7 @@ $resp = $p->servers->create($params);
 Suspend then rename via client Settings:
 
 ```php
-$server = $p->servers->show(123);
+$server = $p->servers->get(123);
 $server->suspend();
 $server->settingsRename('Maintenance');
 ```

src/Applications/Allocations/Allocations.php

@@ -17,7 +17,7 @@ public function __construct(Pterodactyl $ptero)
         parent::__construct($ptero, 'api/application/nodes');
     }
 
-    public function list(int $nodeId): ListBuilder
+    public function all(int $nodeId): ListBuilder
     {
         return new ListBuilder($this, '/' . $nodeId . '/allocations', ListResponse::class);
     }

src/Applications/Eggs/Eggs.php

@@ -17,12 +17,12 @@ public function __construct(Pterodactyl $ptero)
         parent::__construct($ptero, 'api/application/nests');
     }
 
-    public function list(int $nestId): EggsListBuilder
+    public function all(int $nestId): EggsListBuilder
     {
         return new EggsListBuilder($this, '/' . $nestId . '/eggs', EggsListResponse::class);
     }
 
-    public function show(int $nestId, int $eggId): EggsItemBuilder
+    public function get(int $nestId, int $eggId): EggsItemBuilder
     {
         return new EggsItemBuilder($this, $nestId, $eggId);
     }

src/Applications/Locations/Locations.php

@@ -20,12 +20,12 @@ public function __construct(Pterodactyl $ptero)
         parent::__construct($ptero, 'api/application/locations');
     }
 
-    public function list(): LocationsListBuilder
+    public function all(): LocationsListBuilder
     {
         return new LocationsListBuilder($this, '', LocationsListResponse::class);
     }
 
-    public function show(int $id): LocationsItemBuilder
+    public function get(int $id): LocationsItemBuilder
     {
         return new LocationsItemBuilder($this, $id);
     }

src/Applications/Nests/Nests.php

@@ -10,21 +10,37 @@
 use Gigabait93\Pterodactyl;
 use Gigabait93\Support\SubClient;
 
+/**
+ * Application API for panel nests.
+ */
 class Nests extends SubClient
 {
+    /**
+     * @param Pterodactyl $ptero Pterodactyl client instance
+     */
     public function __construct(Pterodactyl $ptero)
     {
         parent::__construct($ptero, 'api/application/nests');
     }
 
-    public function list(): NestsListBuilder
+    /**
+     * List all nests.
+     *
+     * @return NestsListBuilder
+     */
+    public function all(): NestsListBuilder
     {
         return new NestsListBuilder($this, '', NestsListResponse::class);
     }
 
-    public function show(int $id): NestsItemBuilder
+    /**
+     * Get a nest by its identifier.
+     *
+     * @param int $id Nest identifier
+     * @return NestsItemBuilder
+     */
+    public function get(int $id): NestsItemBuilder
     {
         return new NestsItemBuilder($this, $id);
     }
-
 }

src/Applications/Nodes/Builders/NodesItemBuilder.php

@@ -19,7 +19,7 @@ class NodesItemBuilder extends \Gigabait93\Support\Builders\ItemBuilder
 
     public function allocations(): ListBuilder
     {
-        return $this->client->ptero()->allocations->list($this->getId());
+        return $this->client->ptero()->allocations->all($this->getId());
     }
 
     public function createAllocation(array $params): ActionResponse

src/Applications/Nodes/Nodes.php

@@ -21,12 +21,12 @@ public function __construct(Pterodactyl $ptero)
         parent::__construct($ptero, 'api/application/nodes');
     }
 
-    public function list(): NodesListBuilder
+    public function all(): NodesListBuilder
     {
         return new NodesListBuilder($this, '', NodesListResponse::class);
     }
 
-    public function show(int $id): NodesItemBuilder
+    public function get(int $id): NodesItemBuilder
     {
         return new NodesItemBuilder($this, $id);
     }