Add new endpoints and resources (#182)

Added the `MyEndpoint.info` and `MyAccountEndpoint.switch` endpoints, and the `MyInfo` resource. These updates provide users the ability to access additional information and functionality within the application. Tests for these additions have also been implemented to ensure their correct function. Also, conducted a small cleanup in the `MyAccount` resource.

CHANGELOG.md

@@ -6,6 +6,8 @@ Updates should follow the [Keep a CHANGELOG](http://keepachangelog.com/) princip
 
 ## [Unreleased]
 ### Added
+- Add `MyEndpoint.info` endpoint and `MyInfo` resource
+- Add `MyAccountEndpoint.switch` endpoint
 - Add `AccountSmsSendersEndpoint` and `AccountSmsSender` resource
 - Add `envelopeAnonymizeRetention` and `envelopeAnonymizeGroups` to `AccountSecurity`
 - Add `anonymizeAt` and `anonymizedAt` to `Envelope`

src/Endpoint/MyAccountsEndpoint.php

@@ -41,4 +41,9 @@ public function decline(string $id): void
     {
         $this->postRequest('/{id}/decline', ['id' => $id]);
     }
+
+    public function switch(string $id): void
+    {
+        $this->postRequest('/{id}/switch', ['id' => $id]);
+    }
 }

src/Endpoint/MyEndpoint.php

@@ -6,6 +6,7 @@
 
 use DigitalCz\DigiSign\DigiSign;
 use DigitalCz\DigiSign\Resource\BaseResource;
+use DigitalCz\DigiSign\Resource\MyInfo;
 
 /**
  * @extends ResourceEndpoint<BaseResource>
@@ -36,4 +37,9 @@ public function contacts(): MyContactsEndpoint
     {
         return new MyContactsEndpoint($this);
     }
+
+    public function info(): MyInfo
+    {
+        return $this->createResource($this->getRequest('/info'), MyInfo::class);
+    }
 }

src/Resource/MyAccount.php

@@ -7,12 +7,8 @@
 class MyAccount extends BaseResource
 {
     public string $id;
-
     public string $name;
-
     public string $status;
-
     public bool $active;
-
     public ?string $idpDomain;
 }

src/Resource/MyInfo.php

@@ -0,0 +1,16 @@
+<?php
+
+declare(strict_types=1);
+
+namespace DigitalCz\DigiSign\Resource;
+
+class MyInfo extends BaseResource
+{
+    public string $email;
+    public ?string $firstName;
+    public ?string $lastName;
+
+    /** @var string[] */
+    public array $permission;
+    public ?MyAccount $account;
+}

tests/Endpoint/MyAccountsEndpointTest.php

@@ -33,6 +33,12 @@ public function testDecline(): void
         self::assertLastRequest('POST', '/api/my/accounts/foo/decline');
     }
 
+    public function testSwitch(): void
+    {
+        self::endpoint()->switch('foo');
+        self::assertLastRequest('POST', '/api/my/accounts/foo/switch');
+    }
+
     private static function endpoint(): MyAccountsEndpoint
     {
         return self::dgs()->my()->accounts();

tests/Endpoint/MyEndpointTest.php

@@ -17,6 +17,12 @@ public function testChildren(): void
         self::assertDefaultEndpointPath(self::endpoint()->contacts(), '/api/my/contacts');
     }
 
+    public function testInfo(): void
+    {
+        self::endpoint()->info();
+        self::assertLastRequest('GET', '/api/my/info');
+    }
+
     private static function endpoint(): MyEndpoint
     {
         return self::dgs()->my();