feat: [backend] Introduce role and member status filtering for ListMembers

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 160
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/gitpod%2Fgitpod-3a8fb9d6b9645a483a08206e944cc388325e210f0bd54daa9e15ee561a37fabc.yml
-openapi_spec_hash: fe42cbf3b012e4aebf56f64a675c3dd3
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/gitpod%2Fgitpod-13ed0159480c5c02ed02394764e7c528c1110cdc42d2a0ff5fac228f48403a08.yml
+openapi_spec_hash: e1b4c20a8a5faee0f2dd22b449e7a106
 config_hash: f36d04c8359fe8baec226396a18b309e

src/gitpod/types/organization_list_members_params.py

@@ -2,9 +2,12 @@
 
 from __future__ import annotations
 
+from typing import List
 from typing_extensions import Literal, Required, Annotated, TypedDict
 
 from .._utils import PropertyInfo
+from .shared.user_status import UserStatus
+from .shared.organization_role import OrganizationRole
 
 __all__ = ["OrganizationListMembersParams", "Filter", "Pagination", "Sort"]
 
@@ -33,9 +36,15 @@ class OrganizationListMembersParams(TypedDict, total=False):
 
 
 class Filter(TypedDict, total=False):
+    roles: List[OrganizationRole]
+    """roles filters members by their organization role"""
+
     search: str
     """search performs case-insensitive search across member name and email"""
 
+    statuses: List[UserStatus]
+    """status filters members by their user status"""
+
 
 class Pagination(TypedDict, total=False):
     """pagination contains the pagination options for listing members"""

src/gitpod/types/shared_params/__init__.py

@@ -7,6 +7,7 @@
 from .task_spec import TaskSpec as TaskSpec
 from .secret_ref import SecretRef as SecretRef
 from .field_value import FieldValue as FieldValue
+from .user_status import UserStatus as UserStatus
 from .resource_type import ResourceType as ResourceType
 from .task_metadata import TaskMetadata as TaskMetadata
 from .environment_class import EnvironmentClass as EnvironmentClass

src/gitpod/types/shared_params/user_status.py

@@ -0,0 +1,11 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Literal, TypeAlias
+
+__all__ = ["UserStatus"]
+
+UserStatus: TypeAlias = Literal[
+    "USER_STATUS_UNSPECIFIED", "USER_STATUS_ACTIVE", "USER_STATUS_SUSPENDED", "USER_STATUS_LEFT"
+]

tests/api_resources/test_organizations.py

@@ -266,7 +266,11 @@ def test_method_list_members_with_all_params(self, client: Gitpod) -> None:
             organization_id="b0e12f6c-4c67-429d-a4a6-d9838b5da047",
             token="token",
             page_size=0,
-            filter={"search": "search"},
+            filter={
+                "roles": ["ORGANIZATION_ROLE_UNSPECIFIED"],
+                "search": "search",
+                "statuses": ["USER_STATUS_UNSPECIFIED"],
+            },
             pagination={
                 "token": "token",
                 "page_size": 20,
@@ -599,7 +603,11 @@ async def test_method_list_members_with_all_params(self, async_client: AsyncGitp
             organization_id="b0e12f6c-4c67-429d-a4a6-d9838b5da047",
             token="token",
             page_size=0,
-            filter={"search": "search"},
+            filter={
+                "roles": ["ORGANIZATION_ROLE_UNSPECIFIED"],
+                "search": "search",
+                "statuses": ["USER_STATUS_UNSPECIFIED"],
+            },
             pagination={
                 "token": "token",
                 "page_size": 20,