feat(api): add sort option to ListAuditLogs

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 180
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/gitpod%2Fgitpod-6afce08fcd8bf2db43a1bf23cd3d0e26cfd58038a4886a0b93905ed32a270976.yml
-openapi_spec_hash: 7e68abc261b93d149fe5274a4033fe7f
-config_hash: 929b044c214da0da793e235847333d89
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/gitpod%2Fgitpod-426f3adea47f1f9969b3ace193806d0b5c6cca002b59f1306ff55a53ba184d41.yml
+openapi_spec_hash: c4f8786a933b74d658f315ed5587b4bd
+config_hash: 65442903d648b9f87a032fc0a4823e62

api.md

@@ -18,6 +18,8 @@ from gitpod.types import (
     ResourceType,
     RunsOn,
     SecretRef,
+    Sort,
+    SortOrder,
     State,
     Subject,
     Task,
@@ -572,8 +574,6 @@ from gitpod.types import (
     ProjectPhase,
     ProjectPrebuildConfiguration,
     RecommendedEditors,
-    Sort,
-    SortOrder,
     ProjectCreateResponse,
     ProjectRetrieveResponse,
     ProjectUpdateResponse,

src/gitpod/resources/events.py

@@ -20,6 +20,7 @@
 from ..pagination import SyncEntriesPage, AsyncEntriesPage
 from .._base_client import AsyncPaginator, make_request_options
 from .._decoders.jsonl import JSONLDecoder, AsyncJSONLDecoder
+from ..types.shared_params.sort import Sort
 from ..types.event_list_response import EventListResponse
 from ..types.event_watch_response import EventWatchResponse
 
@@ -53,6 +54,7 @@ def list(
         page_size: int | Omit = omit,
         filter: event_list_params.Filter | Omit = omit,
         pagination: event_list_params.Pagination | Omit = omit,
+        sort: 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,
@@ -99,7 +101,10 @@ def list(
           ```
 
         Args:
-          pagination: pagination contains the pagination options for listing environments
+          pagination: pagination contains the pagination options for listing audit logs
+
+          sort: sort specifies the order of results. When unspecified, results are sorted by
+              creation time descending (newest first). Supported sort fields: createdAt.
 
           extra_headers: Send extra headers
 
@@ -116,6 +121,7 @@ def list(
                 {
                     "filter": filter,
                     "pagination": pagination,
+                    "sort": sort,
                 },
                 event_list_params.EventListParams,
             ),
@@ -235,6 +241,7 @@ def list(
         page_size: int | Omit = omit,
         filter: event_list_params.Filter | Omit = omit,
         pagination: event_list_params.Pagination | Omit = omit,
+        sort: 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,
@@ -281,7 +288,10 @@ def list(
           ```
 
         Args:
-          pagination: pagination contains the pagination options for listing environments
+          pagination: pagination contains the pagination options for listing audit logs
+
+          sort: sort specifies the order of results. When unspecified, results are sorted by
+              creation time descending (newest first). Supported sort fields: createdAt.
 
           extra_headers: Send extra headers
 
@@ -298,6 +308,7 @@ def list(
                 {
                     "filter": filter,
                     "pagination": pagination,
+                    "sort": sort,
                 },
                 event_list_params.EventListParams,
             ),

src/gitpod/resources/projects/projects.py

@@ -38,7 +38,6 @@
 from ...pagination import SyncProjectsPage, AsyncProjectsPage
 from ..._base_client import AsyncPaginator, make_request_options
 from ...types.project import Project
-from ...types.sort_param import SortParam
 from .environment_clases import (
     EnvironmentClasesResource,
     AsyncEnvironmentClasesResource,
@@ -47,6 +46,7 @@
     EnvironmentClasesResourceWithStreamingResponse,
     AsyncEnvironmentClasesResourceWithStreamingResponse,
 )
+from ...types.shared_params.sort import Sort
 from ...types.project_create_response import ProjectCreateResponse
 from ...types.project_update_response import ProjectUpdateResponse
 from ...types.project_retrieve_response import ProjectRetrieveResponse
@@ -365,7 +365,7 @@ def list(
         page_size: int | Omit = omit,
         filter: project_list_params.Filter | Omit = omit,
         pagination: project_list_params.Pagination | Omit = omit,
-        sort: SortParam | Omit = omit,
+        sort: 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,
@@ -1020,7 +1020,7 @@ def list(
         page_size: int | Omit = omit,
         filter: project_list_params.Filter | Omit = omit,
         pagination: project_list_params.Pagination | Omit = omit,
-        sort: SortParam | Omit = omit,
+        sort: 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,

src/gitpod/types/__init__.py

@@ -12,6 +12,7 @@
 from .runner import Runner as Runner
 from .secret import Secret as Secret
 from .shared import (
+    Sort as Sort,
     Task as Task,
     State as State,
     RunsOn as RunsOn,
@@ -21,6 +22,7 @@
     ErrorCode as ErrorCode,
     Principal as Principal,
     SecretRef as SecretRef,
+    SortOrder as SortOrder,
     FieldValue as FieldValue,
     UserStatus as UserStatus,
     ResourceRole as ResourceRole,
@@ -46,8 +48,6 @@
 from .log_level import LogLevel as LogLevel
 from .warm_pool import WarmPool as WarmPool
 from .agent_mode import AgentMode as AgentMode
-from .sort_order import SortOrder as SortOrder
-from .sort_param import SortParam as SortParam
 from .veto_param import VetoParam as VetoParam
 from .environment import Environment as Environment
 from .error_level import ErrorLevel as ErrorLevel

src/gitpod/types/event_list_params.py

@@ -9,6 +9,7 @@
 from .._types import SequenceNotStr
 from .._utils import PropertyInfo
 from .shared.principal import Principal
+from .shared_params.sort import Sort
 from .shared.resource_type import ResourceType
 
 __all__ = ["EventListParams", "Filter", "Pagination"]
@@ -22,7 +23,14 @@ class EventListParams(TypedDict, total=False):
     filter: Filter
 
     pagination: Pagination
-    """pagination contains the pagination options for listing environments"""
+    """pagination contains the pagination options for listing audit logs"""
+
+    sort: Sort
+    """sort specifies the order of results.
+
+    When unspecified, results are sorted by creation time descending (newest first).
+    Supported sort fields: createdAt.
+    """
 
 
 _FilterReservedKeywords = TypedDict(
@@ -48,7 +56,7 @@ class Filter(_FilterReservedKeywords, total=False):
 
 
 class Pagination(TypedDict, total=False):
-    """pagination contains the pagination options for listing environments"""
+    """pagination contains the pagination options for listing audit logs"""
 
     token: str
     """

src/gitpod/types/organization_list_members_params.py

@@ -7,7 +7,7 @@
 
 from .._types import SequenceNotStr
 from .._utils import PropertyInfo
-from .sort_order import SortOrder
+from .shared.sort_order import SortOrder
 from .shared.user_status import UserStatus
 from .shared.organization_role import OrganizationRole
 

src/gitpod/types/project_list_params.py

@@ -7,8 +7,8 @@
 
 from .._types import SequenceNotStr
 from .._utils import PropertyInfo
-from .sort_param import SortParam
 from .runner_kind import RunnerKind
+from .shared_params.sort import Sort
 
 __all__ = ["ProjectListParams", "Filter", "Pagination"]
 
@@ -23,7 +23,7 @@ class ProjectListParams(TypedDict, total=False):
     pagination: Pagination
     """pagination contains the pagination options for listing organizations"""
 
-    sort: SortParam
+    sort: Sort
     """sort specifies the order of results. Defaults to popularity descending.
 
     Supported fields:

src/gitpod/types/shared/__init__.py

@@ -1,5 +1,6 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+from .sort import Sort as Sort
 from .task import Task as Task
 from .state import State as State
 from .gateway import Gateway as Gateway
@@ -9,6 +10,7 @@
 from .task_spec import TaskSpec as TaskSpec
 from .error_code import ErrorCode as ErrorCode
 from .secret_ref import SecretRef as SecretRef
+from .sort_order import SortOrder as SortOrder
 from .field_value import FieldValue as FieldValue
 from .user_status import UserStatus as UserStatus
 from .resource_role import ResourceRole as ResourceRole

src/gitpod/types/shared/sort.py

@@ -0,0 +1,15 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+
+from ..._models import BaseModel
+from .sort_order import SortOrder
+
+__all__ = ["Sort"]
+
+
+class Sort(BaseModel):
+    field: Optional[str] = None
+    """Field name to sort by, in camelCase."""
+
+    order: Optional[SortOrder] = None