feat: [api] sorting 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-47577991d03c0dab9d0f219bd3f6cf8cb3ea386a919a10c949318091aca5b10f.yml
-openapi_spec_hash: ad236fd154210c60d9aca150a3fd51bc
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/gitpod%2Fgitpod-3a8fb9d6b9645a483a08206e944cc388325e210f0bd54daa9e15ee561a37fabc.yml
+openapi_spec_hash: fe42cbf3b012e4aebf56f64a675c3dd3
 config_hash: f36d04c8359fe8baec226396a18b309e

src/gitpod/resources/organizations/organizations.py

@@ -507,6 +507,7 @@ def list_members(
         page_size: int | Omit = omit,
         filter: organization_list_members_params.Filter | Omit = omit,
         pagination: organization_list_members_params.Pagination | Omit = omit,
+        sort: organization_list_members_params.Sort | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -551,6 +552,11 @@ def list_members(
 
           pagination: pagination contains the pagination options for listing members
 
+          sort: sort specifies the order of results. When unspecified, the authenticated user is
+              returned first, followed by other members sorted by name ascending. When an
+              explicit sort is specified, results are sorted purely by the requested field
+              without any special handling for the authenticated user.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -567,6 +573,7 @@ def list_members(
                     "organization_id": organization_id,
                     "filter": filter,
                     "pagination": pagination,
+                    "sort": sort,
                 },
                 organization_list_members_params.OrganizationListMembersParams,
             ),
@@ -1086,6 +1093,7 @@ def list_members(
         page_size: int | Omit = omit,
         filter: organization_list_members_params.Filter | Omit = omit,
         pagination: organization_list_members_params.Pagination | Omit = omit,
+        sort: organization_list_members_params.Sort | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -1130,6 +1138,11 @@ def list_members(
 
           pagination: pagination contains the pagination options for listing members
 
+          sort: sort specifies the order of results. When unspecified, the authenticated user is
+              returned first, followed by other members sorted by name ascending. When an
+              explicit sort is specified, results are sorted purely by the requested field
+              without any special handling for the authenticated user.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -1146,6 +1159,7 @@ def list_members(
                     "organization_id": organization_id,
                     "filter": filter,
                     "pagination": pagination,
+                    "sort": sort,
                 },
                 organization_list_members_params.OrganizationListMembersParams,
             ),

src/gitpod/types/organization_list_members_params.py

@@ -2,11 +2,11 @@
 
 from __future__ import annotations
 
-from typing_extensions import Required, Annotated, TypedDict
+from typing_extensions import Literal, Required, Annotated, TypedDict
 
 from .._utils import PropertyInfo
 
-__all__ = ["OrganizationListMembersParams", "Filter", "Pagination"]
+__all__ = ["OrganizationListMembersParams", "Filter", "Pagination", "Sort"]
 
 
 class OrganizationListMembersParams(TypedDict, total=False):
@@ -22,6 +22,15 @@ class OrganizationListMembersParams(TypedDict, total=False):
     pagination: Pagination
     """pagination contains the pagination options for listing members"""
 
+    sort: Sort
+    """sort specifies the order of results.
+
+    When unspecified, the authenticated user is returned first, followed by other
+    members sorted by name ascending. When an explicit sort is specified, results
+    are sorted purely by the requested field without any special handling for the
+    authenticated user.
+    """
+
 
 class Filter(TypedDict, total=False):
     search: str
@@ -42,3 +51,17 @@ class Pagination(TypedDict, total=False):
 
     Maximum 100.
     """
+
+
+class Sort(TypedDict, total=False):
+    """sort specifies the order of results.
+
+    When unspecified, the authenticated user is
+     returned first, followed by other members sorted by name ascending. When an explicit
+     sort is specified, results are sorted purely by the requested field without any
+     special handling for the authenticated user.
+    """
+
+    field: Literal["SORT_FIELD_UNSPECIFIED", "SORT_FIELD_NAME", "SORT_FIELD_DATE_JOINED"]
+
+    order: Literal["SORT_ORDER_UNSPECIFIED", "SORT_ORDER_ASC", "SORT_ORDER_DESC"]

tests/api_resources/test_organizations.py

@@ -271,6 +271,10 @@ def test_method_list_members_with_all_params(self, client: Gitpod) -> None:
                 "token": "token",
                 "page_size": 20,
             },
+            sort={
+                "field": "SORT_FIELD_UNSPECIFIED",
+                "order": "SORT_ORDER_UNSPECIFIED",
+            },
         )
         assert_matches_type(SyncMembersPage[OrganizationMember], organization, path=["response"])
 
@@ -600,6 +604,10 @@ async def test_method_list_members_with_all_params(self, async_client: AsyncGitp
                 "token": "token",
                 "page_size": 20,
             },
+            sort={
+                "field": "SORT_FIELD_UNSPECIFIED",
+                "order": "SORT_ORDER_UNSPECIFIED",
+            },
         )
         assert_matches_type(AsyncMembersPage[OrganizationMember], organization, path=["response"])