Add EnvelopeTemplateDocumentAssignments endpoint

CHANGELOG.md

@@ -19,6 +19,7 @@ Updates should follow the [Keep a CHANGELOG](http://keepachangelog.com/) princip
 - Extend `AccountBilling` resource with identify limits
 - Add `AccountBilling.userContactLimit`
 - Add `IdentifyScenarioVersion.restrictedCountries`
+- Add `EnvelopeTemplateDocumentAssignments` endpoint
 
 ## [2.4.0] - 2024-05-14
 ### Added

src/Endpoint/EnvelopeTemplateDocumentAssignmentEndpoint.php

@@ -0,0 +1,37 @@
+<?php
+
+declare(strict_types=1);
+
+namespace DigitalCz\DigiSign\Endpoint;
+
+use DigitalCz\DigiSign\Resource\BaseResource;
+
+/**
+ * @extends ResourceEndpoint<BaseResource>
+ */
+final class EnvelopeTemplateDocumentAssignmentEndpoint extends ResourceEndpoint
+{
+    public function __construct(EnvelopeTemplateDocumentsEndpoint $parent)
+    {
+        parent::__construct($parent, '/assignments');
+    }
+
+    /**
+     * @return array<string, array<string, string>>
+     */
+    public function get(): array
+    {
+        /** @var array<string, array<string, string>> $result */
+        $result = $this->parseResponse($this->getRequest());
+
+        return $result;
+    }
+
+    /**
+     * @param array<string, array<string, string>> $body
+     */
+    public function set(array $body): void
+    {
+        $this->putRequest('', ['json' => $body]);
+    }
+}

src/Endpoint/EnvelopeTemplateDocumentsEndpoint.php

@@ -55,4 +55,9 @@ public function replaceFile(EnvelopeTemplateDocument|string $document, array $bo
             $this->postRequest('/{document}/replace-file', ['document' => $document, 'json' => $body]),
         );
     }
+
+    public function assignments(): EnvelopeTemplateDocumentAssignmentEndpoint
+    {
+        return new EnvelopeTemplateDocumentAssignmentEndpoint($this);
+    }
 }

tests/Endpoint/EnvelopeTemplateDocumentAssignmentsEndpointTest.php

@@ -0,0 +1,39 @@
+<?php
+
+declare(strict_types=1);
+
+namespace DigitalCz\DigiSign\Endpoint;
+
+/**
+ * @covers \DigitalCz\DigiSign\Endpoint\EnvelopeTemplateDocumentAssignmentEndpoint
+ */
+final class EnvelopeTemplateDocumentAssignmentsEndpointTest extends EndpointTestCase
+{
+    public function testGet(): void
+    {
+        self::endpoint()->get();
+        self::assertLastRequest('GET', '/api/envelope-templates/bar/documents/assignments');
+    }
+
+    public function testSet(): void
+    {
+        self::endpoint()->set([
+            '8a071df9-aa9a-4607-9bc4-1c148ae6d384' => [
+                'd73be485-731a-45b4-9566-489643952db0' => 'show',
+                'ed37dd22-cd24-47c6-ab22-f014bcd30c9d' => 'hide',
+            ],
+        ]);
+
+        self::assertLastRequest('PUT', '/api/envelope-templates/bar/documents/assignments', [
+            '8a071df9-aa9a-4607-9bc4-1c148ae6d384' => [
+                'd73be485-731a-45b4-9566-489643952db0' => 'show',
+                'ed37dd22-cd24-47c6-ab22-f014bcd30c9d' => 'hide',
+            ],
+        ]);
+    }
+
+    protected static function endpoint(): EnvelopeTemplateDocumentAssignmentEndpoint
+    {
+        return self::dgs()->envelopeTemplates()->documents('bar')->assignments();
+    }
+}

tests/Endpoint/EnvelopeTemplateDocumentsEndpointTest.php

@@ -9,6 +9,14 @@
  */
 class EnvelopeTemplateDocumentsEndpointTest extends EndpointTestCase
 {
+    public function testChildren(): void
+    {
+        self::assertDefaultEndpointPath(
+            self::endpoint()->assignments(),
+            '/api/envelope-templates/bar/documents/assignments',
+        );
+    }
+
     public function testCRUD(): void
     {
         self::assertCrudRequests(self::endpoint(), '/api/envelope-templates/bar/documents');