update changelog

CHANGELOG.md

@@ -4,7 +4,25 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [Unreleased](https://git.d3data.de/D3Public/klicktipp-php-client/compare/1.0.0...rel_1.x)
+## [Unreleased](https://git.d3data.de/D3Public/klicktipp-php-client/compare/1.0.3...rel_1.x)
+
+## [1.0.3](https://git.d3data.de/D3Public/klicktipp-php-client/compare/1.0.2...1.0.3) - 2025-03-06
+### Fixed
+- handle different cases in subscribed status
+
+## [1.0.2](https://git.d3data.de/D3Public/klicktipp-php-client/compare/1.0.1...1.0.2) - 2025-02-05
+### Added
+- reset subscription method
+
+### Changed
+- endpoint related task with missing endpoint instance throws an exception instead skipping it
+
+### Fixed
+- test for index null values in entities
+
+## [1.0.1](https://git.d3data.de/D3Public/klicktipp-php-client/compare/1.0.0...1.0.1) - 2025-01-13
+### Changed
+- badges in README
 
 ## [1.0.0](https://git.d3data.de/D3Public/klicktipp-php-client/releases/tag/1.0.0) - 2025-01-09
 ### Added

README.md

@@ -1,12 +1,12 @@
 ![stability-mature](https://img.shields.io/badge/stability-mature-008000.svg)
-![GitHub Tag](https://img.shields.io/github/v/tag/d3datadevelopment/klicktipp-php-client?label=release)
-[![MIT License](https://img.shields.io/github/license/d3datadevelopment/klicktipp-php-client)](https://git.d3data.de/D3Public/klicktipp-php-client/raw/branch/main/LICENSE.md)
+[![latest tag](https://img.shields.io/packagist/v/d3/klicktipp-php-client?label=release)](https://packagist.org/packages/d3/klicktipp-php-client)
+[![MIT License](https://img.shields.io/packagist/l/d3/klicktipp-php-client)](https://git.d3data.de/D3Public/klicktipp-php-client/raw/branch/main/LICENSE.md)
 
 [![english version](https://logos.oxidmodule.com/en2_xs.svg)](README.md)
 
 # Klicktipp PHP Client
 
-An unofficial client for the Klicktipp API.
+A client for the Klicktipp API.
 
 ## Installation
 This project can easily be installed through Composer.

src/Entities/Account.php

@@ -19,11 +19,14 @@ namespace D3\KlicktippPhpClient\Entities;
 
 use D3\KlicktippPhpClient\Exceptions\CommunicationException;
 use D3\KlicktippPhpClient\Exceptions\InvalidCredentialTypeException;
+use D3\KlicktippPhpClient\Exceptions\MissingEndpointException;
 use D3\KlicktippPhpClient\Resources\Account as AccountEndpoint;
 use Doctrine\Common\Collections\ArrayCollection;
 
 class Account extends Entity
 {
+    use EndpointTrait;
+
     private ?AccountEndpoint $endpoint;
 
     public function __construct(array $elements = [], ?AccountEndpoint $endpoint = null)
@@ -193,9 +196,10 @@ class Account extends Entity
     /**
      * @return null|bool
      * @throws CommunicationException
+     * @throws MissingEndpointException
      */
     public function persist(): ?bool
     {
-        return $this->endpoint?->update();
+        return $this->getEndpoint()->update();
     }
 }

src/Entities/EndpointTrait.php

@@ -0,0 +1,36 @@
+<?php
+
+/**
+ * Copyright (c) D3 Data Development (Inh. Thomas Dartsch)
+ *
+ * For the full copyright and license information, please view
+ * the LICENSE file that was distributed with this source code.
+ *
+ * https://www.d3data.de
+ *
+ * @copyright (C) D3 Data Development (Inh. Thomas Dartsch)
+ * @author    D3 Data Development - Daniel Seifert <info@shopmodule.com>
+ * @link      https://www.oxidmodule.com
+ */
+
+declare(strict_types=1);
+
+namespace D3\KlicktippPhpClient\Entities;
+
+use Assert\Assert;
+use D3\KlicktippPhpClient\Exceptions\MissingEndpointException;
+use D3\KlicktippPhpClient\Resources\Model;
+
+trait EndpointTrait
+{
+    private function getEndpoint(): Model
+    {
+        Assert::lazy()
+              ->setExceptionClass(MissingEndpointException::class)
+              ->that($this->endpoint)
+              ->isInstanceOf(Model::class)
+              ->verifyNow();
+
+        return $this->endpoint;
+    }
+}

src/Entities/Field.php

@@ -18,10 +18,13 @@ declare(strict_types=1);
 namespace D3\KlicktippPhpClient\Entities;
 
 use D3\KlicktippPhpClient\Exceptions\CommunicationException;
+use D3\KlicktippPhpClient\Exceptions\MissingEndpointException;
 use D3\KlicktippPhpClient\Resources\Field as FieldEndpoint;
 
 class Field extends Entity
 {
+    use EndpointTrait;
+
     private ?FieldEndpoint $endpoint;
 
     public function __construct(array $elements = [], ?FieldEndpoint $endpoint = null)
@@ -50,12 +53,15 @@ class Field extends Entity
     /**
      * @return null|bool
      * @throws CommunicationException
+     * @throws MissingEndpointException
      */
     public function persist(): ?bool
     {
-        return $this->endpoint?->update(
-            $this->getId(),
-            $this->getName()
-        );
+        return !is_null($this->getId()) ?
+            $this->getEndpoint()->update(
+                $this->getId(),
+                $this->getName() ?? ''
+            ) :
+            null;
     }
 }

src/Entities/Subscriber.php

@@ -18,12 +18,15 @@ declare(strict_types=1);
 namespace D3\KlicktippPhpClient\Entities;
 
 use D3\KlicktippPhpClient\Exceptions\CommunicationException;
+use D3\KlicktippPhpClient\Exceptions\MissingEndpointException;
 use D3\KlicktippPhpClient\Resources\Subscriber as SubscriberEndpoint;
 use DateTime;
 use Doctrine\Common\Collections\ArrayCollection;
 
 class Subscriber extends Entity
 {
+    use EndpointTrait;
+
     public const STATUS_SUBSCRIBED = 'subscribed';
     public const BOUNCE_NOTBOUNCED = 'Not Bounced';
 
@@ -81,7 +84,7 @@ class Subscriber extends Entity
 
     public function isSubscribed(): bool
     {
-        return $this->getStatus() === self::STATUS_SUBSCRIBED;
+        return strtolower($this->getStatus()) === strtolower(self::STATUS_SUBSCRIBED);
     }
 
     public function getBounce(): ?string
@@ -91,7 +94,7 @@ class Subscriber extends Entity
 
     public function isBounced(): bool
     {
-        return $this->getBounce() !== self::BOUNCE_NOTBOUNCED;
+        return strtolower($this->getBounce()) !== strtolower(self::BOUNCE_NOTBOUNCED);
     }
 
     public function getDate(): ?DateTime
@@ -175,7 +178,7 @@ class Subscriber extends Entity
         // use persist method to send to Klicktipp
     }
 
-    protected function getFieldLongName(string $fieldId): ?string
+    protected function getFieldLongName(string $fieldId): string
     {
         return str_starts_with($fieldId, 'field') ? trim($fieldId) : 'field'.trim($fieldId);
     }
@@ -193,15 +196,15 @@ class Subscriber extends Entity
     public function clearTags(): void
     {
         $tags = $this->getTags();
-        $tags->clear();
-        $this->set(SubscriberEndpoint::TAGS, $tags->toArray());
+        $tags?->clear();
+        $this->set(SubscriberEndpoint::TAGS, $tags?->toArray());
 
         // use persist method to send to Klicktipp
     }
 
     public function addTag(string $tagId): void
     {
-        $tags = $this->getTags();
+        $tags = $this->getTags() ?: new ArrayCollection();
         $tags->add($tagId);
         $this->set(SubscriberEndpoint::TAGS, $tags->toArray());
 
@@ -211,8 +214,8 @@ class Subscriber extends Entity
     public function removeTag(string $tagId): void
     {
         $tags = $this->getTags();
-        $tags->removeElement($tagId);
-        $this->set(SubscriberEndpoint::TAGS, $tags->toArray());
+        $tags?->removeElement($tagId);
+        $this->set(SubscriberEndpoint::TAGS, $tags?->toArray());
 
         // use persist method to send to Klicktipp
     }
@@ -232,7 +235,7 @@ class Subscriber extends Entity
 
     public function getManualTagTime(string $tagId): ?DateTime
     {
-        return $this->getDateTimeFromValue($this->getManualTags()->get($tagId));
+        return $this->getDateTimeFromValue($this->getManualTags()?->get($tagId));
     }
 
     public function getSmartTags(): ?ArrayCollection
@@ -314,42 +317,81 @@ class Subscriber extends Entity
     /**
      * @return null|bool
      * @throws CommunicationException
+     * @throws MissingEndpointException
      */
     public function persist(): ?bool
     {
-        $return = $this->endpoint?->update(
-            $this->getId(),
-            $this->getFields()->toArray(),
-            $this->getEmailAddress(),
-            $this->getSmsPhone()
-        );
+        if (!is_null($this->getId())) {
+            $return = $this->getEndpoint()->update(
+                $this->getId(),
+                $this->getFields()->toArray(),
+                $this->getEmailAddress() ?? '',
+                $this->getSmsPhone() ?? ''
+            );
 
-        $this->persistTags();
+            $this->persistTags();
 
-        return $return;
+            return $return;
+        }
+
+        return null;
     }
 
     /**
      * @throws CommunicationException
+     * @throws MissingEndpointException
      */
     protected function persistTags(): void
     {
-        if (!$this->endpoint instanceof SubscriberEndpoint) {
-            return;
-        }
+        $currentTags = $this->getEndpoint()->getEntity($this->getId() ?? '')->getTags();
 
-        $currentTags = $this->endpoint->getEntity($this->getId())->getTags();
+        $removeTags = array_diff(
+            $currentTags?->toArray() ?? [],
+            $this->getTags()?->toArray() ?? []
+        );
 
-        $removeTags = array_diff($currentTags->toArray(), $this->getTags()->toArray());
         if (count($removeTags)) {
             foreach ($removeTags as $removeTag) {
-                $this->endpoint->untag($this->getEmailAddress(), $removeTag);
+                if (!is_null($this->getEmailAddress())) {
+                    $this->getEndpoint()->untag($this->getEmailAddress(), $removeTag);
+                }
             }
         }
 
-        $addTags = array_diff($this->getTags()->toArray(), $currentTags->toArray());
+        $addTags = array_diff(
+            $this->getTags()?->toArray() ?? [],
+            $currentTags?->toArray() ?? []
+        );
         if (count($addTags)) {
-            $this->endpoint->tag($this->getEmailAddress(), $addTags);
+            if (!is_null($this->getEmailAddress())) {
+                $this->getEndpoint()->tag($this->getEmailAddress(), $addTags);
+            }
+        }
+    }
+
+    /**
+     * @param string      $listId
+     * @param string|null $tagId
+     * @param array|null  $fields
+     * @param string|null $smsNumber
+     *
+     * @return void
+     * @throws CommunicationException
+     */
+    public function resubscribe(
+        string $listId,
+        ?string $tagId = null,
+        ?array $fields = null,
+        ?string $smsNumber = null
+    ): void {
+        if (!$this->isSubscribed()) {
+            $this->getEndpoint()->subscribe(
+                $this->getEmailAddress(),
+                $listId,
+                $tagId,
+                $fields,
+                $smsNumber
+            );
         }
     }
 

src/Entities/Subscription.php

@@ -18,10 +18,13 @@ declare(strict_types=1);
 namespace D3\KlicktippPhpClient\Entities;
 
 use D3\KlicktippPhpClient\Exceptions\CommunicationException;
+use D3\KlicktippPhpClient\Exceptions\MissingEndpointException;
 use D3\KlicktippPhpClient\Resources\SubscriptionProcess;
 
 class Subscription extends Entity
 {
+    use EndpointTrait;
+
     private ?SubscriptionProcess $endpoint;
 
     public function __construct(array $elements = [], ?SubscriptionProcess $endpoint = null)
@@ -78,12 +81,15 @@ class Subscription extends Entity
     /**
      * @return null|bool
      * @throws CommunicationException
+     * @throws MissingEndpointException
      */
     public function persist(): ?bool
     {
-        return $this->endpoint?->update(
-            $this->getListId(),
-            $this->getName()
-        );
+        return !is_null($this->getListId()) ?
+            $this->getEndpoint()->update(
+                $this->getListId(),
+                $this->getName() ?? ''
+            ) :
+            null;
     }
 }

src/Entities/Tag.php

@@ -18,10 +18,13 @@ declare(strict_types=1);
 namespace D3\KlicktippPhpClient\Entities;
 
 use D3\KlicktippPhpClient\Exceptions\CommunicationException;
+use D3\KlicktippPhpClient\Exceptions\MissingEndpointException;
 use D3\KlicktippPhpClient\Resources\Tag as TagEndpoint;
 
 class Tag extends Entity
 {
+    use EndpointTrait;
+
     private ?TagEndpoint $endpoint;
 
     public function __construct(array $elements = [], ?TagEndpoint $endpoint = null)
@@ -62,13 +65,16 @@ class Tag extends Entity
     /**
      * @return null|bool
      * @throws CommunicationException
+     * @throws MissingEndpointException
      */
     public function persist(): ?bool
     {
-        return $this->endpoint?->update(
-            $this->getId(),
-            $this->getName(),
-            $this->getText()
-        );
+        return !is_null($this->getId()) ?
+            $this->getEndpoint()->update(
+                $this->getId(),
+                $this->getName() ?? '',
+                $this->getText() ?? ''
+            ) :
+            null;
     }
 }

src/Exceptions/MissingEndpointException.php

@@ -0,0 +1,29 @@
+<?php
+
+/**
+ * Copyright (c) D3 Data Development (Inh. Thomas Dartsch)
+ *
+ * For the full copyright and license information, please view
+ * the LICENSE file that was distributed with this source code.
+ *
+ * https://www.d3data.de
+ *
+ * @copyright (C) D3 Data Development (Inh. Thomas Dartsch)
+ * @author    D3 Data Development - Daniel Seifert <info@shopmodule.com>
+ * @link      https://www.oxidmodule.com
+ */
+
+declare(strict_types=1);
+
+namespace D3\KlicktippPhpClient\Exceptions;
+
+use Assert\LazyAssertionException;
+
+class MissingEndpointException extends LazyAssertionException implements KlicktippExceptionInterface
+{
+    public function __construct($message, array $errors)
+    {
+        unset($message);
+        parent::__construct('required endpoint for this action missing', $errors);
+    }
+}

tests/unit/Entities/AccountTest.php

@@ -19,6 +19,7 @@ namespace D3\KlicktippPhpClient\tests\unit\Entities;
 
 use D3\KlicktippPhpClient\Entities\Account;
 use D3\KlicktippPhpClient\Exceptions\InvalidCredentialTypeException;
+use D3\KlicktippPhpClient\Exceptions\MissingEndpointException;
 use D3\KlicktippPhpClient\Resources\Account as AccountEndpoint;
 use D3\KlicktippPhpClient\tests\TestCase;
 use Doctrine\Common\Collections\ArrayCollection;
@@ -526,6 +527,10 @@ class AccountTest extends TestCase
 
         $sut = new Account([AccountEndpoint::UID => 'foo'], $endpointSet ? $endpointMock : null);
 
+        if (!$endpointSet) {
+            $this->expectException(MissingEndpointException::class);
+        }
+
         $this->assertSame(
             $expectedReturn,
             $this->callMethod(

tests/unit/Entities/FieldTest.php

@@ -19,6 +19,7 @@ namespace D3\KlicktippPhpClient\tests\unit\Entities;
 
 use D3\KlicktippPhpClient\Entities\Field;
 use D3\KlicktippPhpClient\Exceptions\InvalidCredentialTypeException;
+use D3\KlicktippPhpClient\Exceptions\MissingEndpointException;
 use D3\KlicktippPhpClient\Resources\Field as FieldEndpoint;
 use D3\KlicktippPhpClient\tests\TestCase;
 use Generator;
@@ -184,6 +185,10 @@ class FieldTest extends TestCase
             $endpointSet ? $endpointMock : null
         );
 
+        if (!$endpointSet) {
+            $this->expectException(MissingEndpointException::class);
+        }
+
         $this->assertSame(
             $expectedReturn,
             $this->callMethod(

tests/unit/Entities/SubscriberTest.php

@@ -19,6 +19,7 @@ namespace D3\KlicktippPhpClient\tests\unit\Entities;
 
 use D3\KlicktippPhpClient\Entities\Subscriber;
 use D3\KlicktippPhpClient\Exceptions\InvalidCredentialTypeException;
+use D3\KlicktippPhpClient\Exceptions\MissingEndpointException;
 use D3\KlicktippPhpClient\Resources\Subscriber as SubscriberEndpoint;
 use D3\KlicktippPhpClient\tests\TestCase;
 use DateTime;
@@ -706,12 +707,11 @@ class SubscriberTest extends TestCase
      * @covers \D3\KlicktippPhpClient\Entities\Subscriber::isTagSet
      * @dataProvider isTagSetDataProvider
      */
-    public function testIsTagSet(string $searchTagId, bool $expected): void
+    public function testIsTagSet(?array $currentTags, string $searchTagId, bool $expected): void
     {
-        $tagList = new ArrayCollection([
-            "12494453",
-            "12494463",
-        ]);
+        $tagList = is_null($currentTags) ?
+            null :
+            new ArrayCollection($currentTags);
 
         $sut = $this->getMockBuilder(Subscriber::class)
             ->onlyMethods(['getTags'])
@@ -730,8 +730,9 @@ class SubscriberTest extends TestCase
 
     public static function isTagSetDataProvider(): Generator
     {
-        yield 'existing tag' => ['12494463', true];
-        yield 'missing tag' => ['12495463', false];
+        yield 'existing tag' => [["12494453", "12494463"], '12494463', true];
+        yield 'missing tag' => [["12494453", "12494463"], '12495463', false];
+        yield 'null tag' => [null, '12495463', false];
     }
 
     /**
@@ -739,15 +740,27 @@ class SubscriberTest extends TestCase
      * @return void
      * @covers \D3\KlicktippPhpClient\Entities\Subscriber::clearTags
      * @throws ReflectionException
+     * @dataProvider clearTagsDataProvider
      */
-    public function testClearTags(): void
+    public function testClearTags(?array $currentTagList, ?array $expectedTags): void
     {
+        $entityMock = new Subscriber([SubscriberEndpoint::TAGS  => $currentTagList]);
+
         $this->callMethod(
-            $this->entity,
+            $entityMock,
             'clearTags'
         );
 
-        $this->assertCount(0, $this->callMethod($this->entity, 'getTags'));
+        is_null($expectedTags) ?
+            $this->assertNull($this->callMethod($entityMock, 'getTags')) :
+            $this->assertEquals(new ArrayCollection($expectedTags), $this->callMethod($entityMock, 'getTags'));
+    }
+
+    public static function clearTagsDataProvider(): Generator
+    {
+        yield 'tag list exists' => [["12494453","12494463"], []];
+        yield 'tag list empty' => [[], []];
+        yield 'tag list null' => [null, null];
     }
 
     /**
@@ -755,36 +768,56 @@ class SubscriberTest extends TestCase
      * @return void
      * @covers \D3\KlicktippPhpClient\Entities\Subscriber::addTag
      * @throws ReflectionException
+     * @dataProvider addTagDataProvider
      */
-    public function testAddTag(): void
+    public function testAddTag(?array $currentTagList, ?array $expectedTagList): void
     {
+        $entityMock = new Subscriber([SubscriberEndpoint::TAGS  => $currentTagList]);
+
         $this->callMethod(
-            $this->entity,
+            $entityMock,
             'addTag',
             ['78546214']
         );
 
-        $this->assertCount(3, $this->callMethod($this->entity, 'getTags'));
-        $this->assertContains('78546214', $this->callMethod($this->entity, 'getTags'));
+        is_null($expectedTagList) ?
+            $this->assertNull($this->callMethod($entityMock, 'getTags')) :
+            $this->assertEquals(new ArrayCollection($expectedTagList), $this->callMethod($entityMock, 'getTags'));
+    }
+
+    public static function addTagDataProvider(): Generator
+    {
+        yield 'tag list exists' => [["12494453","12494463"], ["12494453","12494463", "78546214"]];
+        yield 'tag list empty' => [[], ["78546214"]];
+        yield 'tag list null' => [null, ["78546214"]];
     }
 
     /**
      * @test
-     * @return void
-     * @covers \D3\KlicktippPhpClient\Entities\Subscriber::removeTag
      * @throws ReflectionException
+     * @covers       \D3\KlicktippPhpClient\Entities\Subscriber::removeTag
+     * @dataProvider removeTagDataProvider
      */
-    public function testRemoveTag(): void
+    public function testRemoveTag(?array $currentTagList, ?array $expectedTags): void
     {
+        $entityMock = new Subscriber([SubscriberEndpoint::TAGS  => $currentTagList]);
+
         $this->callMethod(
-            $this->entity,
+            $entityMock,
             'removeTag',
             ['12494453']
         );
 
-        $this->assertCount(1, $this->callMethod($this->entity, 'getTags'));
-        $this->assertContains('12494463', $this->callMethod($this->entity, 'getTags'));
-        $this->assertNotContains('12494453', $this->callMethod($this->entity, 'getTags'));
+        is_null($expectedTags) ?
+            $this->assertNull($this->callMethod($entityMock, 'getTags')) :
+            $this->assertEquals(new ArrayCollection($expectedTags), $this->callMethod($entityMock, 'getTags'));
+    }
+
+    public static function removeTagDataProvider(): Generator
+    {
+        yield 'tag list exists' => [["12494453","12494463"], [1 => "12494463"]];
+        yield 'tag list empty' => [[], []];
+        yield 'tag list null' => [null, null];
     }
 
     /**
@@ -795,7 +828,9 @@ class SubscriberTest extends TestCase
      */
     public function testPersist(
         bool $endpointSet,
+        ?string $currentId,
         InvokedCount $endpointInvocation,
+        InvokedCount $persistTagsInvocation,
         ?bool $expectedReturn
     ): void {
         $endpointMock = $this->getMockBuilder(SubscriberEndpoint::class)
@@ -805,10 +840,14 @@ class SubscriberTest extends TestCase
         $endpointMock->expects($endpointInvocation)->method('update')->willReturn(true);
 
         $sut = $this->getMockBuilder(Subscriber::class)
-            ->setConstructorArgs([[SubscriberEndpoint::ID => 'foo'], $endpointSet ? $endpointMock : null])
+            ->setConstructorArgs([[SubscriberEndpoint::ID => $currentId], $endpointSet ? $endpointMock : null])
             ->onlyMethods(['persistTags'])
             ->getMock();
-        $sut->expects($this->once())->method('persistTags');
+        $sut->expects($persistTagsInvocation)->method('persistTags');
+
+        if (!$endpointSet) {
+            $this->expectException(MissingEndpointException::class);
+        }
 
         $this->assertSame(
             $expectedReturn,
@@ -821,8 +860,9 @@ class SubscriberTest extends TestCase
 
     public static function persistDataProvider(): Generator
     {
-        yield 'has endpoint'    => [true, self::once(), true];
-        yield 'has no endpoint'    => [false, self::never(), null];
+        yield 'has endpoint'    => [true, 'fixture', self::once(), self::once(), true];
+        yield 'has no endpoint'    => [false, 'fixture', self::never(), self::never(), null];
+        yield 'has endpoint, no id' => [true, null, self::never(), self::never(), null];
     }
 
     /**
@@ -834,6 +874,7 @@ class SubscriberTest extends TestCase
     public function testPersistTags(
         bool $endpointSet,
         InvokedCount $endpointInvocation,
+        ?array $currentTagList,
         ?array $newTagList,
         InvokedCount $removeTagInvocation,
         InvokedCount $setTagInvocation
@@ -842,10 +883,9 @@ class SubscriberTest extends TestCase
             ->disableOriginalConstructor()
             ->onlyMethods(['getTags'])
             ->getMock();
-        $entityMock->method('getTags')->willReturn(new ArrayCollection([
-            "12494453",
-            "12494463",
-        ]));
+        $entityMock->method('getTags')->willReturn(
+            is_null($currentTagList) ? null : new ArrayCollection($currentTagList)
+        );
 
         $endpointMock = $this->getMockBuilder(SubscriberEndpoint::class)
             ->disableOriginalConstructor()
@@ -860,6 +900,10 @@ class SubscriberTest extends TestCase
             $sut->set('tags', $newTagList);
         }
 
+        if (!$endpointSet) {
+            $this->expectException(MissingEndpointException::class);
+        }
+
         $this->callMethod(
             $sut,
             'persistTags'
@@ -868,10 +912,11 @@ class SubscriberTest extends TestCase
 
     public static function persistTagsDataProvider(): Generator
     {
-        yield 'has endpoint, tag removed' => [true, self::once(), ["12494453"], self::once(), self::never()];
-        yield 'has endpoint, tag added' => [true, self::once(), ["12494453","12494463","12494464"], self::never(), self::once()];
-        yield 'has endpoint, taglist equals' => [true, self::once(), ["12494453","12494463"], self::never(), self::never()];
-        yield 'has no endpoint'    => [false, self::never(), null, self::never(), self::never()];
+        yield 'has endpoint, tag removed' => [true, self::once(), ["12494453", "12494463"], ["12494453"], self::once(), self::never()];
+        yield 'has endpoint, tag added' => [true, self::once(), ["12494453", "12494463"], ["12494453","12494463","12494464"], self::never(), self::once()];
+        yield 'has endpoint, taglist equals' => [true, self::once(), ["12494453", "12494463"], ["12494453","12494463"], self::never(), self::never()];
+        yield 'has no endpoint'    => [false, self::never(), ["12494453", "12494463"], null, self::never(), self::never()];
+        yield 'has endpoint, taglist null'    => [true, self::once(), null, null, self::never(), self::never()];
     }
 
     /**
@@ -942,4 +987,48 @@ class SubscriberTest extends TestCase
         yield ['getStartedCampaignTime', 'getStartedCampaigns'];
         yield ['getFinishedCampaignTime', 'getFinishedCampaigns'];
     }
+
+    /**
+     * @test
+     * @throws ReflectionException
+     * @covers \D3\KlicktippPhpClient\Entities\Subscriber::resubscribe
+     * @covers \D3\KlicktippPhpClient\Entities\Subscriber::getEndpoint
+     * @dataProvider  resubscribeDataProvider
+     */
+    public function testReSubscribe(
+        bool $endpointSet,
+        InvokedCount $subscribeExpections,
+        bool $isSubscribed
+    ): void {
+        $endpointMock = $this->getMockBuilder(SubscriberEndpoint::class)
+            ->disableOriginalConstructor()
+            ->onlyMethods(['subscribe'])
+            ->getMock();
+        $endpointMock->expects($subscribeExpections)->method('subscribe');
+
+        $sut = $this->getMockBuilder(Subscriber::class)
+            ->setConstructorArgs([[], $endpointSet ? $endpointMock : null])
+            ->onlyMethods(['isSubscribed', 'getEmailAddress'])
+            ->getMock();
+        $sut->method('isSubscribed')->willReturn($isSubscribed);
+        $sut->method('getEmailAddress')->willReturn('mail@mydomain.tld');
+
+        if (!$endpointSet && !$isSubscribed) {
+            $this->expectException(MissingEndpointException::class);
+        }
+
+        $this->callMethod(
+            $sut,
+            'resubscribe',
+            ['listId', 'tagid']
+        );
+    }
+
+    public static function resubscribeDataProvider(): Generator
+    {
+        yield 'already subscribed, has endpoint' => [true, self::never(), true];
+        yield 'unsubscribed, has endpoint' => [true, self::once(), false];
+        yield 'already subscribed, no endpoint' => [false, self::never(), true];
+        yield 'unsubscribed, no endpoint' => [false, self::never(), false];
+    }
 }

tests/unit/Entities/SubscriptionTest.php

@@ -19,6 +19,7 @@ namespace D3\KlicktippPhpClient\tests\unit\Entities;
 
 use D3\KlicktippPhpClient\Entities\Subscription;
 use D3\KlicktippPhpClient\Exceptions\InvalidCredentialTypeException;
+use D3\KlicktippPhpClient\Exceptions\MissingEndpointException;
 use D3\KlicktippPhpClient\Resources\SubscriptionProcess as SubscriptionEndpoint;
 use D3\KlicktippPhpClient\tests\TestCase;
 use Generator;
@@ -205,6 +206,7 @@ class SubscriptionTest extends TestCase
      */
     public function testPersist(
         bool $endpointSet,
+        ?string $id,
         InvokedCount $endpointInvocation,
         ?bool $expectedReturn
     ): void {
@@ -213,15 +215,19 @@ class SubscriptionTest extends TestCase
             ->onlyMethods(['update'])
             ->getMock();
         $endpointMock->expects($endpointInvocation)->method('update')->with(
-            $this->identicalTo('foo'),
+            $this->identicalTo($id),
             $this->identicalTo('bar'),
         )->willReturn(true);
 
         $sut = new Subscription(
-            [SubscriptionEndpoint::LISTID => 'foo', SubscriptionEndpoint::NAME  => 'bar'],
+            [SubscriptionEndpoint::LISTID => $id, SubscriptionEndpoint::NAME  => 'bar'],
             $endpointSet ? $endpointMock : null
         );
 
+        if (!$endpointSet) {
+            $this->expectException(MissingEndpointException::class);
+        }
+
         $this->assertSame(
             $expectedReturn,
             $this->callMethod(
@@ -233,7 +239,8 @@ class SubscriptionTest extends TestCase
 
     public static function persistDataProvider(): Generator
     {
-        yield 'has endpoint'    => [true, self::once(), true];
-        yield 'has no endpoint'    => [false, self::never(), null];
+        yield 'has endpoint'        => [true, 'fixture', self::once(), true];
+        yield 'has no endpoint'     => [false, 'fixture', self::never(), null];
+        yield 'has endpoint, no id' => [true, null, self::never(), null];
     }
 }

tests/unit/Entities/TagTest.php

@@ -19,6 +19,7 @@ namespace D3\KlicktippPhpClient\tests\unit\Entities;
 
 use D3\KlicktippPhpClient\Entities\Tag;
 use D3\KlicktippPhpClient\Exceptions\InvalidCredentialTypeException;
+use D3\KlicktippPhpClient\Exceptions\MissingEndpointException;
 use D3\KlicktippPhpClient\Resources\Tag as TagEndpoint;
 use D3\KlicktippPhpClient\tests\TestCase;
 use Generator;
@@ -198,6 +199,10 @@ class TagTest extends TestCase
             $endpointSet ? $endpointMock : null
         );
 
+        if (!$endpointSet) {
+            $this->expectException(MissingEndpointException::class);
+        }
+
         $this->assertSame(
             $expectedReturn,
             $this->callMethod(

tests/unit/Exceptions/MissingEndpointExceptionTest.php

@@ -0,0 +1,54 @@
+<?php
+
+/**
+ * Copyright (c) D3 Data Development (Inh. Thomas Dartsch)
+ *
+ * For the full copyright and license information, please view
+ * the LICENSE file that was distributed with this source code.
+ *
+ * https://www.d3data.de
+ *
+ * @copyright (C) D3 Data Development (Inh. Thomas Dartsch)
+ * @author    D3 Data Development - Daniel Seifert <info@shopmodule.com>
+ * @link      https://www.oxidmodule.com
+ */
+
+declare(strict_types=1);
+
+namespace D3\KlicktippPhpClient\tests\unit\Exceptions;
+
+use D3\KlicktippPhpClient\Exceptions\CommunicationException;
+use D3\KlicktippPhpClient\Exceptions\MissingEndpointException;
+use D3\KlicktippPhpClient\tests\TestCase;
+use ReflectionException;
+
+/**
+ * @covers \D3\KlicktippPhpClient\Exceptions\MissingEndpointException
+ */
+class MissingEndpointExceptionTest extends TestCase
+{
+    /**
+     * @test
+     * @return void
+     * @throws ReflectionException
+     * @covers \D3\KlicktippPhpClient\Exceptions\MissingEndpointException::__construct
+     */
+    public function testConstructor(): void
+    {
+        /** @var MissingEndpointException $sutMock */
+        $sutMock = $this->getMockBuilder(MissingEndpointException::class)
+            ->disableOriginalConstructor()
+            ->getMock();
+
+        $this->callMethod(
+            $sutMock,
+            '__construct',
+            ['myMessage', []]
+        );
+
+        $this->assertMatchesRegularExpression(
+            '/.*?endpoint.*?missing.*/i',
+            $sutMock->getMessage()
+        );
+    }
+}