feat(api): OpenAPI spec update via Stainless API (#1192)

.stats.yml

@@ -1,2 +1,2 @@
 configured_endpoints: 1256
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare%2Fcloudflare-dc191ddbe3d3013cd1f90d1747ebd7022d0f938d1e547eb284ae675d34c87e78.yml
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare%2Fcloudflare-2a553d49ea7dea09efa86fd5af7cdaba8c2a757071c4114a4d8de234cbcdc740.yml

src/cloudflare/resources/d1/database.py

@@ -3,6 +3,7 @@
 from __future__ import annotations
 
 from typing import Any, List, Type, cast
+from typing_extensions import Literal
 
 import httpx
 
@@ -47,6 +48,7 @@ def create(
         *,
         account_id: str,
         name: str,
+        primary_location_hint: Literal["wnam", "enam", "weur", "eeur", "apac", "oc"] | NotGiven = NOT_GIVEN,
         # 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,
@@ -60,6 +62,9 @@ def create(
         Args:
           account_id: Account identifier tag.
 
+          primary_location_hint: Specify the region to create the D1 primary, if available. If this option is
+              omitted, the D1 will be created as close as possible to the current user.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -72,7 +77,13 @@ def create(
             raise ValueError(f"Expected a non-empty value for `account_id` but received {account_id!r}")
         return self._post(
             f"/accounts/{account_id}/d1/database",
-            body=maybe_transform({"name": name}, database_create_params.DatabaseCreateParams),
+            body=maybe_transform(
+                {
+                    "name": name,
+                    "primary_location_hint": primary_location_hint,
+                },
+                database_create_params.DatabaseCreateParams,
+            ),
             options=make_request_options(
                 extra_headers=extra_headers,
                 extra_query=extra_query,
@@ -248,6 +259,9 @@ def query(
         Args:
           account_id: Account identifier tag.
 
+          sql: Your SQL query. Supports multiple statements, joined by semicolons, which will
+              be executed as a batch.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -301,6 +315,9 @@ def raw(
         Args:
           account_id: Account identifier tag.
 
+          sql: Your SQL query. Supports multiple statements, joined by semicolons, which will
+              be executed as a batch.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -347,6 +364,7 @@ async def create(
         *,
         account_id: str,
         name: str,
+        primary_location_hint: Literal["wnam", "enam", "weur", "eeur", "apac", "oc"] | NotGiven = NOT_GIVEN,
         # 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,
@@ -360,6 +378,9 @@ async def create(
         Args:
           account_id: Account identifier tag.
 
+          primary_location_hint: Specify the region to create the D1 primary, if available. If this option is
+              omitted, the D1 will be created as close as possible to the current user.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -372,7 +393,13 @@ async def create(
             raise ValueError(f"Expected a non-empty value for `account_id` but received {account_id!r}")
         return await self._post(
             f"/accounts/{account_id}/d1/database",
-            body=await async_maybe_transform({"name": name}, database_create_params.DatabaseCreateParams),
+            body=await async_maybe_transform(
+                {
+                    "name": name,
+                    "primary_location_hint": primary_location_hint,
+                },
+                database_create_params.DatabaseCreateParams,
+            ),
             options=make_request_options(
                 extra_headers=extra_headers,
                 extra_query=extra_query,
@@ -548,6 +575,9 @@ async def query(
         Args:
           account_id: Account identifier tag.
 
+          sql: Your SQL query. Supports multiple statements, joined by semicolons, which will
+              be executed as a batch.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -601,6 +631,9 @@ async def raw(
         Args:
           account_id: Account identifier tag.
 
+          sql: Your SQL query. Supports multiple statements, joined by semicolons, which will
+              be executed as a batch.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request

src/cloudflare/types/d1/database_create_params.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing_extensions import Required, TypedDict
+from typing_extensions import Literal, Required, TypedDict
 
 __all__ = ["DatabaseCreateParams"]
 
@@ -12,3 +12,10 @@ class DatabaseCreateParams(TypedDict, total=False):
     """Account identifier tag."""
 
     name: Required[str]
+
+    primary_location_hint: Literal["wnam", "enam", "weur", "eeur", "apac", "oc"]
+    """Specify the region to create the D1 primary, if available.
+
+    If this option is omitted, the D1 will be created as close as possible to the
+    current user.
+    """

src/cloudflare/types/d1/database_query_params.py

@@ -13,5 +13,10 @@ class DatabaseQueryParams(TypedDict, total=False):
     """Account identifier tag."""
 
     sql: Required[str]
+    """Your SQL query.
+
+    Supports multiple statements, joined by semicolons, which will be executed as a
+    batch.
+    """
 
     params: List[str]

src/cloudflare/types/d1/database_raw_params.py

@@ -13,5 +13,10 @@ class DatabaseRawParams(TypedDict, total=False):
     """Account identifier tag."""
 
     sql: Required[str]
+    """Your SQL query.
+
+    Supports multiple statements, joined by semicolons, which will be executed as a
+    batch.
+    """
 
     params: List[str]

tests/api_resources/d1/test_database.py

@@ -33,6 +33,15 @@ def test_method_create(self, client: Cloudflare) -> None:
         )
         assert_matches_type(DatabaseCreateResponse, database, path=["response"])
 
+    @parametrize
+    def test_method_create_with_all_params(self, client: Cloudflare) -> None:
+        database = client.d1.database.create(
+            account_id="023e105f4ecef8ad9ca31a8372d0c353",
+            name="my-database",
+            primary_location_hint="wnam",
+        )
+        assert_matches_type(DatabaseCreateResponse, database, path=["response"])
+
     @parametrize
     def test_raw_response_create(self, client: Cloudflare) -> None:
         response = client.d1.database.with_raw_response.create(
@@ -349,6 +358,15 @@ async def test_method_create(self, async_client: AsyncCloudflare) -> None:
         )
         assert_matches_type(DatabaseCreateResponse, database, path=["response"])
 
+    @parametrize
+    async def test_method_create_with_all_params(self, async_client: AsyncCloudflare) -> None:
+        database = await async_client.d1.database.create(
+            account_id="023e105f4ecef8ad9ca31a8372d0c353",
+            name="my-database",
+            primary_location_hint="wnam",
+        )
+        assert_matches_type(DatabaseCreateResponse, database, path=["response"])
+
     @parametrize
     async def test_raw_response_create(self, async_client: AsyncCloudflare) -> None:
         response = await async_client.d1.database.with_raw_response.create(