Identifications (#213)

* Add `Identification.result` and its sub-entities

* Add `IdentificationEndpoint.cancel|discard|restore`

CHANGELOG.md

@@ -6,6 +6,12 @@ Updates should follow the [Keep a CHANGELOG](http://keepachangelog.com/) princip
 
 ## [Unreleased]
 ### Added
+- Add `Identificaiton.cancelledAt`
+- Add `Identificaiton.discardedAt`
+- Add `Identification.result` and its sub-entities
+- Add `IdentificationsEndpoint.cancel`
+- Add `IdentificationsEndpoint.discard`
+- Add `IdentificationsEndpoint.restore`
 - Add `Identification.forReviewAt`
 - Add `EnvelopeRecipient.channelForNotifications`
 - Add `EnvelopeTemplateRecipient.channelForNotifications`

src/Endpoint/IdentificationsEndpoint.php

@@ -36,4 +36,22 @@ public function deny(Identification|string $id, array $body = []): Identificatio
     {
         return $this->makeResource($this->postRequest('/{id}/deny', ['id' => $id, 'json' => $body]));
     }
+
+    public function cancel(Identification|string $id): Identification
+    {
+        return $this->makeResource($this->postRequest('/{id}/cancel', ['id' => $id]));
+    }
+
+    /**
+     * @param mixed[] $body
+     */
+    public function discard(Identification|string $id, array $body = []): Identification
+    {
+        return $this->makeResource($this->postRequest('/{id}/discard', ['id' => $id, 'json' => $body]));
+    }
+
+    public function restore(Identification|string $id): Identification
+    {
+        return $this->makeResource($this->postRequest('/{id}/restore', ['id' => $id]));
+    }
 }

src/Resource/Identification.php

@@ -22,6 +22,9 @@ class Identification extends BaseResource
     public ?DateTime $approvedAt;
     public ?DateTime $deniedAt;
     public ?DateTime $forReviewAt;
+    public ?DateTime $cancelledAt;
+    public ?DateTime $discardedAt;
     public ?string $denialMessage;
+    public ?IdentificationResult $result;
     public ?IdentifyScenarioVersionInfo $scenarioVersion;
 }

src/Resource/IdentificationBankStatement.php

@@ -0,0 +1,14 @@
+<?php
+
+declare(strict_types=1);
+
+namespace DigitalCz\DigiSign\Resource;
+
+use DigitalCz\DigiSign\Resource\Traits\EntityResourceTrait;
+
+class IdentificationBankStatement extends BaseResource
+{
+    use EntityResourceTrait;
+
+    public File $file;
+}

src/Resource/IdentificationDocument.php

@@ -0,0 +1,16 @@
+<?php
+
+declare(strict_types=1);
+
+namespace DigitalCz\DigiSign\Resource;
+
+use DigitalCz\DigiSign\Resource\Traits\EntityResourceTrait;
+
+class IdentificationDocument extends BaseResource
+{
+    use EntityResourceTrait;
+
+    public string $type;
+    public File $front;
+    public ?File $back;
+}

src/Resource/IdentificationInspection.php

@@ -0,0 +1,12 @@
+<?php
+
+declare(strict_types=1);
+
+namespace DigitalCz\DigiSign\Resource;
+
+use DigitalCz\DigiSign\Resource\Traits\EntityResourceTrait;
+
+class IdentificationInspection extends BaseResource
+{
+    use EntityResourceTrait;
+}

src/Resource/IdentificationResult.php

@@ -0,0 +1,18 @@
+<?php
+
+declare(strict_types=1);
+
+namespace DigitalCz\DigiSign\Resource;
+
+use DigitalCz\DigiSign\Resource\Traits\EntityResourceTrait;
+
+class IdentificationResult extends BaseResource
+{
+    use EntityResourceTrait;
+
+    public ?IdentificationDocument $primaryDocument;
+    public ?IdentificationDocument $secondaryDocument;
+    public ?IdentificationBankStatement $bankStatement;
+    public ?IdentificationSelfie $selfie;
+    public ?IdentificationInspection $inspection;
+}

src/Resource/IdentificationSelfie.php

@@ -0,0 +1,14 @@
+<?php
+
+declare(strict_types=1);
+
+namespace DigitalCz\DigiSign\Resource;
+
+use DigitalCz\DigiSign\Resource\Traits\EntityResourceTrait;
+
+class IdentificationSelfie extends BaseResource
+{
+    use EntityResourceTrait;
+
+    public Image $image;
+}

tests/Endpoint/IdentificationsEndpointTest.php

@@ -26,6 +26,36 @@ public function testDeny(): void
         self::assertLastRequest('POST', '/api/identifications/foo/deny');
     }
 
+    public function testDenyWithBody(): void
+    {
+        self::endpoint()->deny('foo', ['foo' => 'bar']);
+        self::assertLastRequest('POST', '/api/identifications/foo/deny', ['foo' => 'bar']);
+    }
+
+    public function testCancel(): void
+    {
+        self::endpoint()->cancel('foo');
+        self::assertLastRequest('POST', '/api/identifications/foo/cancel');
+    }
+
+    public function testDiscard(): void
+    {
+        self::endpoint()->discard('foo');
+        self::assertLastRequest('POST', '/api/identifications/foo/discard');
+    }
+
+    public function testDiscardWithBody(): void
+    {
+        self::endpoint()->discard('foo', ['foo' => 'bar']);
+        self::assertLastRequest('POST', '/api/identifications/foo/discard', ['foo' => 'bar']);
+    }
+
+    public function testRestore(): void
+    {
+        self::endpoint()->restore('foo');
+        self::assertLastRequest('POST', '/api/identifications/foo/restore');
+    }
+
     protected static function endpoint(): IdentificationsEndpoint
     {
         return self::dgs()->identifications();