Refactor changeContactPerson method into linkContactPerson and unlinkContactPerson. Add corresponding unit tests and events for state changes. Update CHANGELOG to reflect these changes.

Signed-off-by: mesilov <[email protected]>

Author: mesilov

CHANGELOG.md

@@ -109,6 +109,9 @@
     - added method `isApplicationTokenValid`
     - changed method `public function applicationInstalled(?string $applicationToken): void` application token now is nullable
     - changed method `public function applicationUninstalled(?string $applicationToken): void` application token now is nullable
+    - added method `linkContactPerson(Uuid $uuid)`
+    - added method `unlinkContactPerson()`
+    - remove method `changeContactPerson(?Uuid $uuid)`
 
 ### Statistics
 

src/Application/Contracts/ApplicationInstallations/Docs/ApplicationInstallations.md

@@ -14,7 +14,8 @@ Optional can store links to:
 | `getUpdatedAt()`                       | `CarbonImmutable`               | Returns date and time of last application installation change                          |                            |
 | `getBitrix24AccountId()`               | `Uuid`                          | Returns Bitrix24 Account id related to this installation                               |                            |
 | `getContactPersonId()`                 | `?Uuid`                         | Returns contact person id who installed the application on portal (optional)           |                            |
-| `changeContactPerson()`                | `void`                          | Changes client contact person                                                          |                            |
+| `linkContactPerson()`                  | `void`                          | Link client contact person                                                             |                            |
+| `unlinkContactPerson()`                | `void`                          | Unlink client contact person                                                           |                            |
 | `getBitrix24PartnerContactPersonId()`  | `?Uuid`                         | Returns Bitrix24 partner contact person id (optional)                                  |                            |
 | `changeBitrix24PartnerContactPerson()` | `void`                          | Changes Bitrix24 partner contact person                                                |                            |
 | `getBitrix24PartnerId()`               | `?Uuid`                         | Returns Bitrix24 Partner id related to this installation (optional)                    |                            |

src/Application/Contracts/ApplicationInstallations/Entity/ApplicationInstallationInterface.php

@@ -57,11 +57,18 @@ public function getBitrix24AccountId(): Uuid;
     public function getContactPersonId(): ?Uuid;
 
     /**
-     * Change contact person
+     * Link contact person
      *
-     * Change client contact person if client say he has new responsible for the application
+     * Link client contact person if a client says they have new responsible for the application
      */
-    public function changeContactPerson(?Uuid $uuid): void;
+    public function linkContactPerson(Uuid $uuid): void;
+
+    /**
+     * Unlink contact person
+     *
+     * Unlink a client contact person if the client says the contact person has changed
+     */
+    public function unlinkContactPerson(): void;
 
     /**
      * Get Bitrix24 Partner contact person id, optional

src/Application/Contracts/ApplicationInstallations/Events/ApplicationInstallationContactPersonLinkedEvent.php

@@ -0,0 +1,28 @@
+<?php
+
+/**
+ * This file is part of the bitrix24-php-sdk package.
+ *
+ * © Maksim Mesilov <[email protected]>
+ *
+ * For the full copyright and license information, please view the MIT-LICENSE.txt
+ * file that was distributed with this source code.
+ */
+
+declare(strict_types=1);
+
+namespace Bitrix24\SDK\Application\Contracts\ApplicationInstallations\Events;
+
+use Carbon\CarbonImmutable;
+use Symfony\Component\Uid\Uuid;
+use Symfony\Contracts\EventDispatcher\Event;
+
+class ApplicationInstallationContactPersonLinkedEvent extends Event
+{
+    public function __construct(
+        public readonly Uuid $applicationInstallationId,
+        public readonly CarbonImmutable $timestamp,
+        public readonly Uuid $contactPersonId
+    ) {
+    }
+}

src/Application/Contracts/ApplicationInstallations/Events/ApplicationInstallationContactPersonUnlinkedEvent.php

@@ -0,0 +1,28 @@
+<?php
+
+/**
+ * This file is part of the bitrix24-php-sdk package.
+ *
+ * © Maksim Mesilov <[email protected]>
+ *
+ * For the full copyright and license information, please view the MIT-LICENSE.txt
+ * file that was distributed with this source code.
+ */
+
+declare(strict_types=1);
+
+namespace Bitrix24\SDK\Application\Contracts\ApplicationInstallations\Events;
+
+use Carbon\CarbonImmutable;
+use Symfony\Component\Uid\Uuid;
+use Symfony\Contracts\EventDispatcher\Event;
+
+class ApplicationInstallationContactPersonUnlinkedEvent extends Event
+{
+    public function __construct(
+        public readonly Uuid $applicationInstallationId,
+        public readonly CarbonImmutable $timestamp,
+        public readonly Uuid $unlinkedContactPersonId
+    ) {
+    }
+}