[UC-3] Add update by custom id endpoint

Author: DominikWolos

src/Api/UserApi.php

@@ -9,8 +9,9 @@
 
 final class UserApi extends AbstractClient implements UserApiInterface
 {
-    const PARENT = 'parent';
-    const USERS_LIST = 'users_list';
+    public const PARENT = 'parent';
+
+    public const USERS_LIST = 'users_list';
 
     public function findUser(
         UserComApiAwareInterface $resource,
@@ -94,4 +95,15 @@ public function mergeUsers(UserComApiAwareInterface $resource, int $parentId, ar
             ]),
         );
     }
+
+    public function updateUserByCustomId(UserComApiAwareInterface $resource, string $customId, array $data): ?array
+    {
+        $url = $this->getApiEndpointUrl($resource, sprintf(self::UPDATE_USER_BY_CUSTOM_ID_ENDPOINT, $customId));
+
+        return $this->request(
+            $url,
+            Request::METHOD_PUT,
+            $this->buildOptions($resource, ['json' => $data]),
+        );
+    }
 }

src/Api/UserApiInterface.php

@@ -18,6 +18,8 @@ interface UserApiInterface
 
     public const UPDATE_USER_ENDPOINT = '/users/%s';
 
+    public const UPDATE_USER_BY_CUSTOM_ID_ENDPOINT = '/users-by-id/%s';
+
     public const GET_USER_ENDPOINT = '/users/%s';
 
     public const CREATE_USER_ENDPOINT = '/users/';