From 3e2001f5b9784bda5db156e44c43f659ca93fb12 Mon Sep 17 00:00:00 2001
From: David Kalianko <david.kalianko@digital.cz>
Date: Mon, 20 Jan 2025 15:30:22 +0100
Subject: [PATCH] Add `MultiSign.get` endpoint

---
 CHANGELOG.md                             |  1 +
 src/DigiSign.php                         |  6 +++
 src/Endpoint/MultiSignEndpoint.php       | 22 +++++++++
 src/Resource/MultiSign.php               | 60 ++++++++++++++++++++++++
 tests/Endpoint/MultiSignEndpointTest.php | 22 +++++++++
 5 files changed, 111 insertions(+)
 create mode 100644 src/Endpoint/MultiSignEndpoint.php
 create mode 100644 src/Resource/MultiSign.php
 create mode 100644 tests/Endpoint/MultiSignEndpointTest.php

diff --git a/CHANGELOG.md b/CHANGELOG.md
index d33d7a4..1cb731e 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -21,6 +21,7 @@ Updates should follow the [Keep a CHANGELOG](http://keepachangelog.com/) princip
 - Add `AccountEndpoint.createDefaultSubscription` endpoint
 - Add `SignatureScenario.latestVersionInfo`
 - Add `EnvelopeTemplateTag`.`customIdentifier` in to resource
+- Add `MultiSign.get` endpoint
 
 ## [2.5.0] - 2024-10-14
 - Add `AccountBilling.automaticTagsPlacement`
diff --git a/src/DigiSign.php b/src/DigiSign.php
index 4052a3e..fc4f5c6 100644
--- a/src/DigiSign.php
+++ b/src/DigiSign.php
@@ -19,6 +19,7 @@
 use DigitalCz\DigiSign\Endpoint\IdentificationsEndpoint;
 use DigitalCz\DigiSign\Endpoint\ImagesEndpoint;
 use DigitalCz\DigiSign\Endpoint\LabelsEndpoint;
+use DigitalCz\DigiSign\Endpoint\MultiSignEndpoint;
 use DigitalCz\DigiSign\Endpoint\MyEndpoint;
 use DigitalCz\DigiSign\Endpoint\ReportEndpoint;
 use DigitalCz\DigiSign\Endpoint\WebhooksEndpoint;
@@ -289,6 +290,11 @@ public function report(): ReportEndpoint
         return new ReportEndpoint($this);
     }
 
+    public function multiSign(): MultiSignEndpoint
+    {
+        return new MultiSignEndpoint($this);
+    }
+
     private function createUserAgent(): string
     {
         $userAgent = '';
diff --git a/src/Endpoint/MultiSignEndpoint.php b/src/Endpoint/MultiSignEndpoint.php
new file mode 100644
index 0000000..5c32184
--- /dev/null
+++ b/src/Endpoint/MultiSignEndpoint.php
@@ -0,0 +1,22 @@
+<?php
+
+declare(strict_types=1);
+
+namespace DigitalCz\DigiSign\Endpoint;
+
+use DigitalCz\DigiSign\DigiSign;
+use DigitalCz\DigiSign\Endpoint\Traits\GetEndpointTrait;
+use DigitalCz\DigiSign\Resource\MultiSign;
+
+/**
+ * @extends ResourceEndpoint<MultiSign>
+ */
+final class MultiSignEndpoint extends ResourceEndpoint
+{
+    use GetEndpointTrait;
+
+    public function __construct(DigiSign $parent)
+    {
+        parent::__construct($parent, '/api/multi-signs', MultiSign::class);
+    }
+}
diff --git a/src/Resource/MultiSign.php b/src/Resource/MultiSign.php
new file mode 100644
index 0000000..0e287f3
--- /dev/null
+++ b/src/Resource/MultiSign.php
@@ -0,0 +1,60 @@
+<?php
+
+declare(strict_types=1);
+
+namespace DigitalCz\DigiSign\Resource;
+
+use DateTime;
+use DigitalCz\DigiSign\Resource\Traits\EntityResourceTrait;
+
+final class MultiSign extends BaseResource
+{
+    use EntityResourceTrait;
+
+    public ?string $alias;
+
+    public string $name;
+
+    public string $email;
+
+    public ?string $mobile;
+
+    public ?DateTime $birthdate;
+
+    public ?string $birthnumber;
+
+    public string $role;
+
+    public string $signatureType;
+
+    public string $authenticationOnOpen;
+
+    public string $authenticationOnSignature;
+
+    public string $status;
+
+    public ?SignatureScenarioVersion $scenarioVersion;
+
+    /**
+     * @var string[]
+     */
+    public array $visibleFields;
+
+    public ?DateTime $sentAt;
+
+    public ?DateTime $deliveredAt;
+
+    public ?DateTime $validTo;
+
+    public ?DateTime $expiredAt;
+
+    public int $expiration;
+
+    public ?User $sender;
+
+    public ?string $emailBody;
+
+    public string $language;
+
+    public ?Branding $branding;
+}
diff --git a/tests/Endpoint/MultiSignEndpointTest.php b/tests/Endpoint/MultiSignEndpointTest.php
new file mode 100644
index 0000000..5f433ec
--- /dev/null
+++ b/tests/Endpoint/MultiSignEndpointTest.php
@@ -0,0 +1,22 @@
+<?php
+
+declare(strict_types=1);
+
+namespace DigitalCz\DigiSign\Endpoint;
+
+/**
+ * @covers \DigitalCz\DigiSign\Endpoint\MultiSignEndpoint
+ */
+final class MultiSignEndpointTest extends EndpointTestCase
+{
+    public function testGet(): void
+    {
+        self::endpoint()->get('foo');
+        self::assertLastRequest('GET', '/api/multi-signs/foo');
+    }
+
+    protected static function endpoint(): MultiSignEndpoint
+    {
+        return self::dgs()->multiSign();
+    }
+}