Add anonymize action and property values to AccountSecurity.php and E…

…nvelope.php (#175)

Co-authored-by: Vladimír Votava <vladimir.votava@digital.cz>

CHANGELOG.md

@@ -4,6 +4,12 @@ All notable changes will be documented in this file.
 
 Updates should follow the [Keep a CHANGELOG](http://keepachangelog.com/) principles.
 
+## [Unreleased]
+### Added
+- Add `envelopeAnonymizeRetention` and `envelopeAnonymizeGroups` to `AccountSecurity`
+- Add `anonymizeAt` and `anonymizedAt` to `Envelope`
+- Add anonymize action to `Envelope`
+
 ## [2.1.0] - 2023-07-12
 ### Added
 - Add `AccountSecurity.auditLogDownloadDefaultUnchecked`

src/Endpoint/EnvelopesEndpoint.php

@@ -122,6 +122,14 @@ public function discard(Envelope|string $id, array $body = []): Envelope
         return $this->makeResource($this->postRequest('/{id}/discard', ['id' => $id, 'json' => $body]));
     }
 
+    /**
+     * @param mixed[] $body
+     */
+    public function anonymize(Envelope|string $id, array $body = []): Envelope
+    {
+        return $this->makeResource($this->postRequest('/{id}/anonymize', ['id' => $id, 'json' => $body]));
+    }
+
     public function restore(Envelope|string $id): Envelope
     {
         return $this->makeResource($this->postRequest('/{id}/restore', ['id' => $id]));

src/Resource/AccountSecurity.php

@@ -20,6 +20,13 @@ class AccountSecurity extends BaseResource
 
     public int $discardedEnvelopeRetention;
 
+    public ?int $envelopeAnonymizeRetention;
+
+    /**
+     * @var array<string>
+     */
+    public array $envelopeAnonymizeGroups;
+
     public bool $continuousSigning;
 
     public bool $auditLogDownloadDefaultUnchecked;

src/Resource/Envelope.php

@@ -57,6 +57,10 @@ class Envelope extends BaseResource
 
     public ?DateTime $discardedAt = null;
 
+    public ?DateTime $anonymizeAt = null;
+
+    public ?DateTime $anonymizedAt = null;
+
     /** @var Collection<EnvelopeRecipient> */
     public Collection $recipients;
 

tests/Endpoint/EnvelopesEndpointTest.php

@@ -89,6 +89,12 @@ public function testDiscard(): void
         self::assertLastRequest('POST', '/api/envelopes/foo/discard');
     }
 
+    public function testAnonymize(): void
+    {
+        self::endpoint()->anonymize('foo', ['foo' => 'bar']);
+        self::assertLastRequest('POST', '/api/envelopes/foo/anonymize');
+    }
+
     public function testValidate(): void
     {
         self::endpoint()->validate('foo');