feat: Add IP management support to the API client

Introduced an `IP` class with methods for handling IP operations such as listing, creating, and deleting IP addresses. Updated the `Client` class to include an `ip()` method for accessing the `IP` class instance. This enhancement extends the API client's functionality to manage IP-related resources.

Author: efebagri

src/Client.php

@@ -6,6 +6,7 @@
 use FireAPI\DedicatedServer\DedicatedServer;
 use FireAPI\Domain\Domain;
 use FireAPI\Exceptions\ParameterException;
+use FireAPI\IP\IP;
 use FireAPI\RootServer\RootServer;
 use GuzzleHttp\Exception\GuzzleException;
 use Psr\Http\Message\ResponseInterface;
@@ -21,6 +22,7 @@ class Client
     private ?Domain $domainHandler = null;
     private ?RootServer $rootServerHandler = null;
     private ?DedicatedServer $dedicatedServerHandler = null;
+    private ?IP $IpHandler = null;
 
     /**
      * Client constructor.
@@ -223,4 +225,14 @@ public function dedicatedServer(): DedicatedServer
     {
         return $this->dedicatedServerHandler ??= new DedicatedServer($this);
     }
+
+    /**
+     * Retrieves the IP instance, initializing it if not already created.
+     *
+     * @return IP The IP instance.
+     */
+    public function ip(): IP
+    {
+        return $this->IpHandler ??= new IP($this);
+    }
 }

src/IP/IP.php

@@ -0,0 +1,68 @@
+<?php
+
+namespace FireAPI\IP;
+
+use FireAPI\Client;
+use GuzzleHttp\Exception\GuzzleException;
+
+class IP
+{
+    private Client $client;
+
+    /**
+     * Constructor method for initializing dependencies.
+     *
+     * @param Client $client An instance of the Client class.
+     * @return void
+     */
+    public function __construct(Client $client)
+    {
+        $this->client = $client;
+    }
+
+    /**
+     * Retrieves a list of available IP addresses from the client.
+     *
+     * @return mixed The list of available IP addresses.
+     * @throws GuzzleException
+     */
+    public function getAvailable(): mixed
+    {
+        return $this->client->get('ip/available');
+    }
+
+    /**
+     * Initiates the purchase of an IP address for the specified network ID.
+     *
+     * @param int $netID The ID of the network for which the IP address is to be purchased.
+     * @return mixed The result of the purchase operation.
+     * @throws GuzzleException
+     */
+    public function create(int $netID): mixed
+    {
+        return $this->client->post('ip/purchase', ['netID' => $netID]);
+    }
+
+    /**
+     * Fetches the list of IP addresses from the client.
+     *
+     * @return mixed The list of IP addresses.
+     * @throws GuzzleException
+     */
+    public function getList(): mixed
+    {
+        return $this->client->get('ip/list');
+    }
+
+    /**
+     * Deletes a network resource using the provided network ID.
+     *
+     * @param int $netID The unique identifier of the network to be deleted.
+     * @return mixed The response from the client after performing the deletion.
+     * @throws GuzzleException
+     */
+    public function delete(int $netID): mixed
+    {
+        return $this->client->delete('ip/delete', ['netID' => $netID]);
+    }
+}