Add EnvelopeRecipient.certificateInfo endpoint (#238)

* Add EnvelopeRecipient.certificateInfo endpoint

* Fix after CR

---------

Co-authored-by: David Kalianko <david.kalianko@digital.cz>

CHANGELOG.md

@@ -6,6 +6,7 @@ Updates should follow the [Keep a CHANGELOG](http://keepachangelog.com/) princip
 
 ## [Unreleased]
 - Add `MyIdentifications.info` endpoint
+- Add `EnvelopeRecipient.certificateInfo` endpoint
 
 ## [2.4.0] - 2024-05-14
 ### Added

src/Endpoint/EnvelopeRecipientsEndpoint.php

@@ -5,6 +5,7 @@
 namespace DigitalCz\DigiSign\Endpoint;
 
 use DigitalCz\DigiSign\Endpoint\Traits\CRUDEndpointTrait;
+use DigitalCz\DigiSign\Resource\CertificateInfo;
 use DigitalCz\DigiSign\Resource\Collection;
 use DigitalCz\DigiSign\Resource\Envelope;
 use DigitalCz\DigiSign\Resource\EnvelopeRecipient;
@@ -121,4 +122,12 @@ public function scenario(EnvelopeRecipient|string $recipient): SignatureScenario
             SignatureScenarioVersion::class,
         );
     }
+
+    public function certificateInfo(EnvelopeRecipient|string $recipient): CertificateInfo
+    {
+        return $this->createResource(
+            $this->getRequest('/{id}/certificate-info', ['id' => $recipient]),
+            CertificateInfo::class,
+        );
+    }
 }

src/Resource/CertificateInfo.php

@@ -0,0 +1,54 @@
+<?php
+
+declare(strict_types=1);
+
+namespace DigitalCz\DigiSign\Resource;
+
+use DateTime;
+
+final class CertificateInfo extends BaseResource
+{
+    public string $subjectCommonName;
+
+    public string $issuerCommonName;
+
+    public DateTime $issuedAt;
+
+    public DateTime $expiresAt;
+
+    public ?string $subjectCountry;
+
+    public ?string $subjectOrganizationName;
+
+    public ?string $subjectOrganizationalUnitName;
+
+    public ?string $subjectOtherName;
+
+    public ?string $subjectLocality;
+
+    public ?string $subjectState;
+
+    public ?string $subjectTitle;
+
+    public ?string $subjectGivenName;
+
+    public ?string $subjectInitials;
+
+    public ?string $subjectSurname;
+
+    public ?string $subjectDomainComponent;
+
+    public ?string $subjectEmail;
+
+    public ?string $subjectStreetAddress;
+
+    public ?string $issuerCountry;
+
+    public ?string $issuerOtherName;
+
+    public ?string $issuerOrganizationName;
+
+    public ?string $serialNumber;
+
+    public ?string $version;
+}

tests/Endpoint/EnvelopeRecipientsEndpointTest.php

@@ -77,6 +77,12 @@ public function testScenario(): void
         self::assertLastRequest('GET', '/api/envelopes/bar/recipients/foo/scenario');
     }
 
+    public function testCertificateInfo(): void
+    {
+        self::endpoint()->certificateInfo('foo');
+        self::assertLastRequest('GET', '/api/envelopes/bar/recipients/foo/certificate-info');
+    }
+
     protected static function endpoint(): EnvelopeRecipientsEndpoint
     {
         return self::dgs()->envelopes()->recipients('bar');