feat(api): aggregated API specs update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 645
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/gcore%2Fgcore-24b39742987350e54c3a309a2a9befa3fa5baa2d0eb2ed61511dab58c4ae9ed2.yml
-openapi_spec_hash: b59285fd083fd6f39f9670071b09d035
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/gcore%2Fgcore-ae604d09a1ce100f6fd1d87cbd55a2ec19894ed1cd3e69fa26a2dbe50d5ca363.yml
+openapi_spec_hash: 8785c579d5c735be99ba4a6e56504c1d
 config_hash: 59388520da4ff5c0c55372621be2a8bb

src/gcore/resources/waap/domains/statistics.py

@@ -407,6 +407,7 @@ def get_requests_series(
             model=WaapRequestSummary,
         )
 
+    @typing_extensions.deprecated("deprecated")
     def get_traffic_series(
         self,
         domain_id: int,
@@ -421,10 +422,11 @@ def get_traffic_series(
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> StatisticGetTrafficSeriesResponse:
-        """
-        Retrieves a comprehensive report on a domain's traffic statistics based on
-        Clickhouse. The report includes details such as API requests, blocked events,
-        error counts, and many more traffic-related metrics.
+        """Deprecated.
+
+        Use
+        [GET /v1/analytics/traffic](/docs/api-reference/waap/analytics/get-traffic-data)
+        instead.
 
         Args:
           domain_id: The domain ID
@@ -833,6 +835,7 @@ def get_requests_series(
             model=WaapRequestSummary,
         )
 
+    @typing_extensions.deprecated("deprecated")
     async def get_traffic_series(
         self,
         domain_id: int,
@@ -847,10 +850,11 @@ async def get_traffic_series(
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> StatisticGetTrafficSeriesResponse:
-        """
-        Retrieves a comprehensive report on a domain's traffic statistics based on
-        Clickhouse. The report includes details such as API requests, blocked events,
-        error counts, and many more traffic-related metrics.
+        """Deprecated.
+
+        Use
+        [GET /v1/analytics/traffic](/docs/api-reference/waap/analytics/get-traffic-data)
+        instead.
 
         Args:
           domain_id: The domain ID
@@ -911,8 +915,10 @@ def __init__(self, statistics: StatisticsResource) -> None:
                 statistics.get_requests_series,  # pyright: ignore[reportDeprecated],
             )
         )
-        self.get_traffic_series = to_raw_response_wrapper(
-            statistics.get_traffic_series,
+        self.get_traffic_series = (  # pyright: ignore[reportDeprecated]
+            to_raw_response_wrapper(
+                statistics.get_traffic_series,  # pyright: ignore[reportDeprecated],
+            )
         )
 
 
@@ -937,8 +943,10 @@ def __init__(self, statistics: AsyncStatisticsResource) -> None:
                 statistics.get_requests_series,  # pyright: ignore[reportDeprecated],
             )
         )
-        self.get_traffic_series = async_to_raw_response_wrapper(
-            statistics.get_traffic_series,
+        self.get_traffic_series = (  # pyright: ignore[reportDeprecated]
+            async_to_raw_response_wrapper(
+                statistics.get_traffic_series,  # pyright: ignore[reportDeprecated],
+            )
         )
 
 
@@ -963,8 +971,10 @@ def __init__(self, statistics: StatisticsResource) -> None:
                 statistics.get_requests_series,  # pyright: ignore[reportDeprecated],
             )
         )
-        self.get_traffic_series = to_streamed_response_wrapper(
-            statistics.get_traffic_series,
+        self.get_traffic_series = (  # pyright: ignore[reportDeprecated]
+            to_streamed_response_wrapper(
+                statistics.get_traffic_series,  # pyright: ignore[reportDeprecated],
+            )
         )
 
 
@@ -989,6 +999,8 @@ def __init__(self, statistics: AsyncStatisticsResource) -> None:
                 statistics.get_requests_series,  # pyright: ignore[reportDeprecated],
             )
         )
-        self.get_traffic_series = async_to_streamed_response_wrapper(
-            statistics.get_traffic_series,
+        self.get_traffic_series = (  # pyright: ignore[reportDeprecated]
+            async_to_streamed_response_wrapper(
+                statistics.get_traffic_series,  # pyright: ignore[reportDeprecated],
+            )
         )

src/gcore/types/waap/domains/waap_request_details.py

@@ -1,6 +1,6 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-from typing import Dict, List
+from typing import Dict, List, Optional
 from datetime import datetime
 from typing_extensions import Literal
 
@@ -196,3 +196,9 @@ class WaapRequestDetails(BaseModel):
 
     user_agent: UserAgent
     """User agent"""
+
+    decision: Optional[Literal["passed", "allowed", "monitored", "blocked", ""]] = None
+    """The decision made for processing the request through the WAAP."""
+
+    optional_action: Optional[Literal["captcha", "challenge", ""]] = None
+    """An optional action that may be applied in addition to the primary decision."""

src/gcore/types/waap/domains/waap_request_summary.py

@@ -22,12 +22,21 @@ class WaapRequestSummary(BaseModel):
     country: str
     """Country code"""
 
+    decision: Literal["passed", "allowed", "monitored", "blocked", ""]
+    """The decision made for processing the request through the WAAP."""
+
     domain: str
     """Domain name"""
 
+    domain_id: int
+    """Domain ID"""
+
     method: str
     """HTTP method"""
 
+    optional_action: Literal["captcha", "challenge", ""]
+    """An optional action that may be applied in addition to the primary decision."""
+
     organization: str
     """Organization"""
 

tests/api_resources/waap/domains/test_statistics.py

@@ -270,30 +270,35 @@ def test_streaming_response_get_requests_series(self, client: Gcore) -> None:
 
     @parametrize
     def test_method_get_traffic_series(self, client: Gcore) -> None:
-        statistic = client.waap.domains.statistics.get_traffic_series(
-            domain_id=1,
-            resolution="daily",
-            start="2024-04-13T00:00:00+01:00",
-        )
+        with pytest.warns(DeprecationWarning):
+            statistic = client.waap.domains.statistics.get_traffic_series(
+                domain_id=1,
+                resolution="daily",
+                start="2024-04-13T00:00:00+01:00",
+            )
+
         assert_matches_type(StatisticGetTrafficSeriesResponse, statistic, path=["response"])
 
     @parametrize
     def test_method_get_traffic_series_with_all_params(self, client: Gcore) -> None:
-        statistic = client.waap.domains.statistics.get_traffic_series(
-            domain_id=1,
-            resolution="daily",
-            start="2024-04-13T00:00:00+01:00",
-            end="2024-04-14T12:00:00Z",
-        )
+        with pytest.warns(DeprecationWarning):
+            statistic = client.waap.domains.statistics.get_traffic_series(
+                domain_id=1,
+                resolution="daily",
+                start="2024-04-13T00:00:00+01:00",
+                end="2024-04-14T12:00:00Z",
+            )
+
         assert_matches_type(StatisticGetTrafficSeriesResponse, statistic, path=["response"])
 
     @parametrize
     def test_raw_response_get_traffic_series(self, client: Gcore) -> None:
-        response = client.waap.domains.statistics.with_raw_response.get_traffic_series(
-            domain_id=1,
-            resolution="daily",
-            start="2024-04-13T00:00:00+01:00",
-        )
+        with pytest.warns(DeprecationWarning):
+            response = client.waap.domains.statistics.with_raw_response.get_traffic_series(
+                domain_id=1,
+                resolution="daily",
+                start="2024-04-13T00:00:00+01:00",
+            )
 
         assert response.is_closed is True
         assert response.http_request.headers.get("X-Stainless-Lang") == "python"
@@ -302,16 +307,17 @@ def test_raw_response_get_traffic_series(self, client: Gcore) -> None:
 
     @parametrize
     def test_streaming_response_get_traffic_series(self, client: Gcore) -> None:
-        with client.waap.domains.statistics.with_streaming_response.get_traffic_series(
-            domain_id=1,
-            resolution="daily",
-            start="2024-04-13T00:00:00+01:00",
-        ) as response:
-            assert not response.is_closed
-            assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+        with pytest.warns(DeprecationWarning):
+            with client.waap.domains.statistics.with_streaming_response.get_traffic_series(
+                domain_id=1,
+                resolution="daily",
+                start="2024-04-13T00:00:00+01:00",
+            ) as response:
+                assert not response.is_closed
+                assert response.http_request.headers.get("X-Stainless-Lang") == "python"
 
-            statistic = response.parse()
-            assert_matches_type(StatisticGetTrafficSeriesResponse, statistic, path=["response"])
+                statistic = response.parse()
+                assert_matches_type(StatisticGetTrafficSeriesResponse, statistic, path=["response"])
 
         assert cast(Any, response.is_closed) is True
 
@@ -563,30 +569,35 @@ async def test_streaming_response_get_requests_series(self, async_client: AsyncG
 
     @parametrize
     async def test_method_get_traffic_series(self, async_client: AsyncGcore) -> None:
-        statistic = await async_client.waap.domains.statistics.get_traffic_series(
-            domain_id=1,
-            resolution="daily",
-            start="2024-04-13T00:00:00+01:00",
-        )
+        with pytest.warns(DeprecationWarning):
+            statistic = await async_client.waap.domains.statistics.get_traffic_series(
+                domain_id=1,
+                resolution="daily",
+                start="2024-04-13T00:00:00+01:00",
+            )
+
         assert_matches_type(StatisticGetTrafficSeriesResponse, statistic, path=["response"])
 
     @parametrize
     async def test_method_get_traffic_series_with_all_params(self, async_client: AsyncGcore) -> None:
-        statistic = await async_client.waap.domains.statistics.get_traffic_series(
-            domain_id=1,
-            resolution="daily",
-            start="2024-04-13T00:00:00+01:00",
-            end="2024-04-14T12:00:00Z",
-        )
+        with pytest.warns(DeprecationWarning):
+            statistic = await async_client.waap.domains.statistics.get_traffic_series(
+                domain_id=1,
+                resolution="daily",
+                start="2024-04-13T00:00:00+01:00",
+                end="2024-04-14T12:00:00Z",
+            )
+
         assert_matches_type(StatisticGetTrafficSeriesResponse, statistic, path=["response"])
 
     @parametrize
     async def test_raw_response_get_traffic_series(self, async_client: AsyncGcore) -> None:
-        response = await async_client.waap.domains.statistics.with_raw_response.get_traffic_series(
-            domain_id=1,
-            resolution="daily",
-            start="2024-04-13T00:00:00+01:00",
-        )
+        with pytest.warns(DeprecationWarning):
+            response = await async_client.waap.domains.statistics.with_raw_response.get_traffic_series(
+                domain_id=1,
+                resolution="daily",
+                start="2024-04-13T00:00:00+01:00",
+            )
 
         assert response.is_closed is True
         assert response.http_request.headers.get("X-Stainless-Lang") == "python"
@@ -595,15 +606,16 @@ async def test_raw_response_get_traffic_series(self, async_client: AsyncGcore) -
 
     @parametrize
     async def test_streaming_response_get_traffic_series(self, async_client: AsyncGcore) -> None:
-        async with async_client.waap.domains.statistics.with_streaming_response.get_traffic_series(
-            domain_id=1,
-            resolution="daily",
-            start="2024-04-13T00:00:00+01:00",
-        ) as response:
-            assert not response.is_closed
-            assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+        with pytest.warns(DeprecationWarning):
+            async with async_client.waap.domains.statistics.with_streaming_response.get_traffic_series(
+                domain_id=1,
+                resolution="daily",
+                start="2024-04-13T00:00:00+01:00",
+            ) as response:
+                assert not response.is_closed
+                assert response.http_request.headers.get("X-Stainless-Lang") == "python"
 
-            statistic = await response.parse()
-            assert_matches_type(StatisticGetTrafficSeriesResponse, statistic, path=["response"])
+                statistic = await response.parse()
+                assert_matches_type(StatisticGetTrafficSeriesResponse, statistic, path=["response"])
 
         assert cast(Any, response.is_closed) is True