Add MyEndpoint.updatePreferences endpoint and MyPreferences resou…

…rce (#284)

CHANGELOG.md

@@ -5,6 +5,7 @@ All notable changes will be documented in this file.
 Updates should follow the [Keep a CHANGELOG](http://keepachangelog.com/) principles.
 
 ## [Unreleased]
+- Add `MyEndpoint.updatePreferences` endpoint and `MyPreferences` resource
 - Add `SignatureScenarioVersionInfo.role`
 - Add `BatchSendingsEndpoint.send` endpoint
 - Add `BatchSendingsEndpoint.list` endpoint

src/Endpoint/MyEndpoint.php

@@ -7,6 +7,7 @@
 use DigitalCz\DigiSign\DigiSign;
 use DigitalCz\DigiSign\Resource\BaseResource;
 use DigitalCz\DigiSign\Resource\MyInfo;
+use DigitalCz\DigiSign\Resource\MyPreferences;
 
 /**
  * @extends ResourceEndpoint<BaseResource>
@@ -47,4 +48,15 @@ public function identifications(): MyIdentificationsEndpoint
     {
         return new MyIdentificationsEndpoint($this);
     }
+
+    /**
+     * @param mixed[] $body
+     */
+    public function updatePreferences(array $body): MyPreferences
+    {
+        return $this->createResource(
+            $this->putRequest('/preferences', ['json' => $body]),
+            MyPreferences::class,
+        );
+    }
 }

src/Resource/MyInfo.php

@@ -13,4 +13,5 @@ class MyInfo extends BaseResource
     /** @var string[] */
     public array $permissions;
     public ?MyAccount $account;
+    public MyPreferences $preferences;
 }

src/Resource/MyPreferences.php

@@ -0,0 +1,13 @@
+<?php
+
+declare(strict_types=1);
+
+namespace DigitalCz\DigiSign\Resource;
+
+class MyPreferences extends BaseResource
+{
+    public bool $prefillAsRecipient;
+    public bool $autoscrollTags;
+    public bool $welcomeVideoHide;
+    public bool $welcomeVideoClose;
+}

tests/Endpoint/MyEndpointTest.php

@@ -24,6 +24,12 @@ public function testInfo(): void
         self::assertLastRequest('GET', '/api/my/info');
     }
 
+    public function testUpdatePreferences(): void
+    {
+        self::endpoint()->updatePreferences(['foo' => 'bar']);
+        self::assertLastRequest('PUT', '/api/my/preferences', ['foo' => 'bar']);
+    }
+
     private static function endpoint(): MyEndpoint
     {
         return self::dgs()->my();