Add MyEnvelopeRecipients.embed endpoint

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 `MyEnvelopeRecipients.embed` endpoint
 - Add `MyIdentifications.info` endpoint
 - Add `EnvelopeRecipient.certificateInfo` endpoint
 

src/Endpoint/MyEnvelopeRecipientsEndpoint.php

@@ -0,0 +1,27 @@
+<?php
+
+declare(strict_types=1);
+
+namespace DigitalCz\DigiSign\Endpoint;
+
+use DigitalCz\DigiSign\Resource\BaseResource;
+use DigitalCz\DigiSign\Resource\Envelope;
+
+/**
+ * @extends ResourceEndpoint<BaseResource>
+ */
+final class MyEnvelopeRecipientsEndpoint extends ResourceEndpoint
+{
+    public function __construct(MyEnvelopesEndpoint $parent, string|Envelope $envelope)
+    {
+        parent::__construct($parent, '{envelope}/recipients', resourceOptions: ['envelope' => $envelope]);
+    }
+
+    /**
+     * @param mixed[] $body
+     */
+    public function embed(string $recipient, array $body): void
+    {
+        $this->postRequest('/{recipient}/embed', ['recipient' => $recipient, 'json' => $body]);
+    }
+}

src/Endpoint/MyEnvelopesEndpoint.php

@@ -6,6 +6,7 @@
 
 use DigitalCz\DigiSign\Endpoint\Traits\GetEndpointTrait;
 use DigitalCz\DigiSign\Endpoint\Traits\ListEndpointTrait;
+use DigitalCz\DigiSign\Resource\Envelope;
 use DigitalCz\DigiSign\Resource\ListResource;
 use DigitalCz\DigiSign\Resource\MyEnvelope;
 use DigitalCz\DigiSign\Resource\MyEnvelopeInfo;
@@ -46,4 +47,9 @@ public function info(string $id): MyEnvelopeInfo
     {
         return $this->createResource($this->getRequest('/{id}/info', ['id' => $id]), MyEnvelopeInfo::class);
     }
+
+    public function recipients(string|Envelope $envelope): MyEnvelopeRecipientsEndpoint
+    {
+        return new MyEnvelopeRecipientsEndpoint($this, $envelope);
+    }
 }

tests/Endpoint/MyEnvelopeRecipientsEndpointTest.php

@@ -0,0 +1,22 @@
+<?php
+
+declare(strict_types=1);
+
+namespace DigitalCz\DigiSign\Endpoint;
+
+/**
+ * @covers \DigitalCz\DigiSign\Endpoint\MyEnvelopeRecipientsEndpoint
+ */
+class MyEnvelopeRecipientsEndpointTest extends EndpointTestCase
+{
+    public function testEmbed(): void
+    {
+        self::endpoint()->embed('bar', []);
+        self::assertLastRequest('POST', '/api/my/envelopes/foo/recipients/bar/embed');
+    }
+
+    protected static function endpoint(): MyEnvelopeRecipientsEndpoint
+    {
+        return self::dgs()->my()->envelopes()->recipients('foo');
+    }
+}