Add a way fetch community memebers

Intereacts with the `community_members` endpoint.

Author: adrorocker

src/Endpoint/Member/Members.php

@@ -13,6 +13,29 @@
 
 final class Members extends AbstractEndpoint implements EndpointInterface
 {
+    public function communityMembers(
+        ?string $sortBy = null,
+        ?int $perPage = null,
+        ?int $page = null,
+        ?string $status = null,
+        ?int $communityId = null,
+    ): mixed {
+        $this->ensureCommunityIdIsPresent($communityId);
+
+        $query = [
+            'sort' => $sortBy ?? 'latest',
+            'per_page' => $perPage ?? 10,
+            'page' => $page ?? 1,
+            'status' => $status ?? 'active',
+        ];
+
+        return $this->factorResponse(
+            $this->circleSo->getHttpClient()->get(
+                "/community_members?" . http_build_query($query)
+            )
+        );
+    }
+
     /**
      * @throws CommunityIdNotPresentException
      */

tests/CircleSoTest.php

@@ -46,6 +46,23 @@ public function test_get_me_not_authorized(): void
         $circleSo->me()->info();
     }
 
+    public function test_community_members_ok(): void
+    {
+        $circleSo = $this->getSdkWithMockedClient([
+            new Response(200, [], json_response('community_members')),
+        ]);
+
+        $communityMembers = $circleSo->members()
+            ->communityId(1)
+            ->communityMembers(perPage: 2);
+
+        $this->assertCount(2, $communityMembers);
+
+        $this->assertSame(1, $communityMembers[0]['id']);
+        $this->assertSame('Adro', $communityMembers[0]['first_name']);
+        $this->assertSame('Adro Morelos', $communityMembers[0]['name']);
+    }
+
     public function test_member_search_ok(): void
     {
         $circleSo = $this->getSdkWithMockedClient([

tests/stubs/responses/community_members.json

@@ -0,0 +1,69 @@
+[
+    {
+        "id": 1,
+        "first_name": "Adro",
+        "last_name": "Morelos",
+        "headline": "",
+        "bio": "",
+        "created_at": "2022-09-26T19:42:37.862Z",
+        "updated_at": "2023-03-30T14:51:42.959Z",
+        "community_id": 1,
+        "member_tags": [],
+        "last_seen_at": "2023-03-30T14:51:42.000Z",
+        "profile_url": "https://circle.com/u/123456",
+        "public_uid": "123456",
+        "profile_fields": [],
+        "avatar_url": "https://ui-avatars.com/api/?name=Adro+Morelos",
+        "user_id": 2,
+        "name": "Adro Morelos",
+        "email": "[email protected]",
+        "topics_count": 0,
+        "posts_count": 0,
+        "comments_count": 0,
+        "location": "",
+        "website_url": "",
+        "instagram_url": "",
+        "twitter_url": "",
+        "linkedin_url": "",
+        "facebook_url": "",
+        "accepted_invitation": "2023-01-01T00:00:00.000Z",
+        "active": true,
+        "sso_provider_user_id": "123456"
+    },
+    {
+        "id": 2,
+        "first_name": "Adro",
+        "last_name": "Rocker",
+        "headline": "",
+        "bio": "",
+        "created_at": "2022-09-26T19:42:37.862Z",
+        "updated_at": "2023-03-30T14:51:42.959Z",
+        "community_id": 1,
+        "member_tags": [
+            {
+                "name": "Member Tag",
+                "id": 123
+            }
+        ],
+        "last_seen_at": "2023-03-30T14:51:42.000Z",
+        "profile_url": "https://circle.com/u/123456",
+        "public_uid": "123456",
+        "profile_fields": [],
+        "avatar_url": "https://ui-avatars.com/api/?name=Adro+Morelos",
+        "user_id": 2,
+        "name": "Adro Morelos",
+        "email": "[email protected]",
+        "topics_count": 0,
+        "posts_count": 0,
+        "comments_count": 0,
+        "location": "",
+        "website_url": "",
+        "instagram_url": "",
+        "twitter_url": "",
+        "linkedin_url": "",
+        "facebook_url": "",
+        "accepted_invitation": "2023-01-01T00:00:00.000Z",
+        "active": true,
+        "sso_provider_user_id": "123456"
+    }
+]