feat(api): add time range filters to event list method

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 175
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/gitpod%2Fgitpod-1923b5d3865532d64d80c22746aa63991bbf227cf1cbefc8cdb14a374c4c5b89.yml
-openapi_spec_hash: 304200ebfa8622f5f6846895528f06e3
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/gitpod%2Fgitpod-18081d3ce0bf5a7c07f195ffcf7934a53c1822f2439270d4e03b89a3993aa3e1.yml
+openapi_spec_hash: 38600260362ddb6b1419e21838e97783
 config_hash: 469d30a2d44895c8c53a5aac370a56f1

src/gitpod/resources/events.py

@@ -86,6 +86,16 @@ def list(
             pageSize: 20
           ```
 
+        - Filter by time range:
+
+          ```yaml
+          filter:
+            from: "2024-01-01T00:00:00Z"
+            to: "2024-02-01T00:00:00Z"
+          pagination:
+            pageSize: 20
+          ```
+
         Args:
           pagination: pagination contains the pagination options for listing environments
 
@@ -251,6 +261,16 @@ def list(
             pageSize: 20
           ```
 
+        - Filter by time range:
+
+          ```yaml
+          filter:
+            from: "2024-01-01T00:00:00Z"
+            to: "2024-02-01T00:00:00Z"
+          pagination:
+            pageSize: 20
+          ```
+
         Args:
           pagination: pagination contains the pagination options for listing environments
 

src/gitpod/types/event_list_params.py

@@ -2,7 +2,8 @@
 
 from __future__ import annotations
 
-from typing import List
+from typing import List, Union
+from datetime import datetime
 from typing_extensions import Annotated, TypedDict
 
 from .._types import SequenceNotStr
@@ -24,7 +25,16 @@ class EventListParams(TypedDict, total=False):
     """pagination contains the pagination options for listing environments"""
 
 
-class Filter(TypedDict, total=False):
+_FilterReservedKeywords = TypedDict(
+    "_FilterReservedKeywords",
+    {
+        "from": Union[str, datetime, None],
+    },
+    total=False,
+)
+
+
+class Filter(_FilterReservedKeywords, total=False):
     actor_ids: Annotated[SequenceNotStr[str], PropertyInfo(alias="actorIds")]
 
     actor_principals: Annotated[List[Principal], PropertyInfo(alias="actorPrincipals")]
@@ -33,6 +43,9 @@ class Filter(TypedDict, total=False):
 
     subject_types: Annotated[List[ResourceType], PropertyInfo(alias="subjectTypes")]
 
+    to: Annotated[Union[str, datetime, None], PropertyInfo(format="iso8601")]
+    """to filters audit logs created before this timestamp (exclusive)."""
+
 
 class Pagination(TypedDict, total=False):
     """pagination contains the pagination options for listing environments"""

tests/api_resources/test_events.py

@@ -10,6 +10,7 @@
 from gitpod import Gitpod, AsyncGitpod
 from tests.utils import assert_matches_type
 from gitpod.types import EventListResponse, EventWatchResponse
+from gitpod._utils import parse_datetime
 from gitpod.pagination import SyncEntriesPage, AsyncEntriesPage
 from gitpod._decoders.jsonl import JSONLDecoder, AsyncJSONLDecoder
 
@@ -34,8 +35,10 @@ def test_method_list_with_all_params(self, client: Gitpod) -> None:
             filter={
                 "actor_ids": ["d2c94c27-3b76-4a42-b88c-95a85e392c68"],
                 "actor_principals": ["PRINCIPAL_USER"],
+                "from": parse_datetime("2019-12-27T18:11:19.117Z"),
                 "subject_ids": ["182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e"],
                 "subject_types": ["RESOURCE_TYPE_UNSPECIFIED"],
+                "to": parse_datetime("2019-12-27T18:11:19.117Z"),
             },
             pagination={
                 "token": "token",
@@ -123,8 +126,10 @@ async def test_method_list_with_all_params(self, async_client: AsyncGitpod) -> N
             filter={
                 "actor_ids": ["d2c94c27-3b76-4a42-b88c-95a85e392c68"],
                 "actor_principals": ["PRINCIPAL_USER"],
+                "from": parse_datetime("2019-12-27T18:11:19.117Z"),
                 "subject_ids": ["182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e"],
                 "subject_types": ["RESOURCE_TYPE_UNSPECIFIED"],
+                "to": parse_datetime("2019-12-27T18:11:19.117Z"),
             },
             pagination={
                 "token": "token",