Support /last and /set-last-id endpoints

src/FioApi/Downloader.php

@@ -58,31 +58,59 @@ public function getClient(): ClientInterface
 
     public function downloadFromTo(\DateTimeInterface $from, \DateTimeInterface $to): TransactionList
     {
-        $client = $this->getClient();
         $url = $this->urlBuilder->buildPeriodsUrl($from, $to);
+        return $this->downloadTransactionsList($url);
+    }
+
+    public function downloadSince(\DateTimeInterface $since): TransactionList
+    {
+        return $this->downloadFromTo($since, new \DateTimeImmutable());
+    }
+
+    public function downloadLast(): TransactionList
+    {
+        $url = $this->urlBuilder->buildLastUrl();
+        return $this->downloadTransactionsList($url);
+    }
+
+    public function setLastId(string $id): void
+    {
+        $client = $this->getClient();
+        $url = $this->urlBuilder->buildSetLastIdUrl($id);
+
+        try {
+            $client->request('get', $url, ['verify' => $this->getCertificatePath()]);
+        } catch (\GuzzleHttp\Exception\BadResponseException $e) {
+            $this->handleException($e);
+        }
+    }
+
+    private function downloadTransactionsList(string $url): TransactionList
+    {
+        $client = $this->getClient();
 
         try {
             /** @var ResponseInterface $response */
             $response = $client->request('get', $url, ['verify' => $this->getCertificatePath()]);
         } catch (\GuzzleHttp\Exception\BadResponseException $e) {
-            if ($e->getCode() == 409) {
-                throw new TooGreedyException('You can use one token for API call every 30 seconds', $e->getCode(), $e);
-            }
-            if ($e->getCode() == 500) {
-                throw new InternalErrorException(
-                    'Server returned 500 Internal Error (probably invalid token?)',
-                    $e->getCode(),
-                    $e
-                );
-            }
-            throw $e;
+            $this->handleException($e);
         }
 
         return TransactionList::create(json_decode($response->getBody()->getContents())->accountStatement);
     }
 
-    public function downloadSince(\DateTimeInterface $since): TransactionList
+    private function handleException(\GuzzleHttp\Exception\BadResponseException $e): void
     {
-        return $this->downloadFromTo($since, new \DateTimeImmutable());
+        if ($e->getCode() == 409) {
+            throw new TooGreedyException('You can use one token for API call every 30 seconds', $e->getCode(), $e);
+        }
+        if ($e->getCode() == 500) {
+            throw new InternalErrorException(
+                'Server returned 500 Internal Error (probably invalid token?)',
+                $e->getCode(),
+                $e
+            );
+        }
+        throw $e;
     }
 }

src/FioApi/UrlBuilder.php

@@ -41,4 +41,21 @@ public function buildPeriodsUrl(\DateTimeInterface $from, \DateTimeInterface $to
             $to->format('Y-m-d')
         );
     }
+
+    public function buildLastUrl(): string
+    {
+        return sprintf(
+            self::BASE_URL . 'last/%s/transactions.json',
+            $this->getToken()
+        );
+    }
+
+    public function buildSetLastIdUrl(string $id): string
+    {
+        return sprintf(
+            self::BASE_URL . 'set-last-id/%s/%s',
+            $this->getToken(),
+            $id
+        );
+    }
 }

tests/FioApi/DownloaderTest.php

@@ -3,7 +3,6 @@
 
 namespace FioApi;
 
-use FioApi\Exceptions;
 use GuzzleHttp\Client;
 use GuzzleHttp\Handler\MockHandler;
 use GuzzleHttp\HandlerStack;
@@ -60,6 +59,29 @@ public function testDownloaderDownloadsData()
         $this->assertInstanceOf(TransactionList::class, $transactionList);
     }
 
+    public function testDownloaderDownloadsLast()
+    {
+        $handler = HandlerStack::create(new MockHandler([
+            new Response(200, [], file_get_contents(__DIR__ . '/data/example-response.json')),
+        ]));
+        $downloader = new Downloader('validToken', new Client(['handler' => $handler]));
+
+        $transactionList = $downloader->downloadLast();
+
+        $this->assertInstanceOf(TransactionList::class, $transactionList);
+    }
+
+    public function testDownloaderSetsLastId()
+    {
+        $handler = HandlerStack::create(new MockHandler([
+            new Response(200),
+        ]));
+        $downloader = new Downloader('validToken', new Client(['handler' => $handler]));
+
+        $downloader->setLastId('123456');
+        $this->addToAssertionCount(1);
+    }
+
     public function testDownloaderSetCertificatePath()
     {
         $downloader = new Downloader('validToken');