chore(api): update composite API spec

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 2013
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare%2Fcloudflare-47182e36d18529e4e1ef4528a8357dd54320a127f8951bd59e65f0bfc644d087.yml
-openapi_spec_hash: bdb0da399347091b2e6c2a4e3b4a553c
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare%2Fcloudflare-83f49bc3fa9273ef989d3e8bcd27f6fdaa7d04ae2519a91f4878f46acc501bb9.yml
+openapi_spec_hash: 3f4be3af6f51eea4787dc8345f9ca9c1
 config_hash: 0c792bb64d06ffbdec9629c954299519

api.md

@@ -7604,7 +7604,7 @@ from cloudflare.types.radar.ai import ToMarkdownCreateResponse
 
 Methods:
 
-- <code title="post /accounts/{account_id}/ai/tomarkdown">client.radar.ai.to_markdown.<a href="./src/cloudflare/resources/radar/ai/to_markdown.py">create</a>(body, \*, account_id, \*\*<a href="src/cloudflare/types/radar/ai/to_markdown_create_params.py">params</a>) -> <a href="./src/cloudflare/types/radar/ai/to_markdown_create_response.py">SyncSinglePage[ToMarkdownCreateResponse]</a></code>
+- <code title="post /accounts/{account_id}/ai/tomarkdown">client.radar.ai.to_markdown.<a href="./src/cloudflare/resources/radar/ai/to_markdown.py">create</a>(\*, account_id, \*\*<a href="src/cloudflare/types/radar/ai/to_markdown_create_params.py">params</a>) -> <a href="./src/cloudflare/types/radar/ai/to_markdown_create_response.py">SyncSinglePage[ToMarkdownCreateResponse]</a></code>
 
 ### Inference
 
@@ -10642,7 +10642,7 @@ from cloudflare.types.ai import ToMarkdownSupportedResponse, ToMarkdownTransform
 Methods:
 
 - <code title="get /accounts/{account_id}/ai/tomarkdown/supported">client.ai.to_markdown.<a href="./src/cloudflare/resources/ai/to_markdown.py">supported</a>(\*, account_id) -> <a href="./src/cloudflare/types/ai/to_markdown_supported_response.py">SyncSinglePage[ToMarkdownSupportedResponse]</a></code>
-- <code title="post /accounts/{account_id}/ai/tomarkdown">client.ai.to_markdown.<a href="./src/cloudflare/resources/ai/to_markdown.py">transform</a>(file, \*, account_id, \*\*<a href="src/cloudflare/types/ai/to_markdown_transform_params.py">params</a>) -> <a href="./src/cloudflare/types/ai/to_markdown_transform_response.py">SyncSinglePage[ToMarkdownTransformResponse]</a></code>
+- <code title="post /accounts/{account_id}/ai/tomarkdown">client.ai.to_markdown.<a href="./src/cloudflare/resources/ai/to_markdown.py">transform</a>(\*, account_id, \*\*<a href="src/cloudflare/types/ai/to_markdown_transform_params.py">params</a>) -> <a href="./src/cloudflare/types/ai/to_markdown_transform_response.py">SyncSinglePage[ToMarkdownTransformResponse]</a></code>
 
 # AISearch
 

src/cloudflare/resources/ai/to_markdown.py

@@ -2,13 +2,14 @@
 
 from __future__ import annotations
 
-import os
+from typing import Mapping, cast
 
 import httpx
 
-from ..._files import read_file_content
-from ..._types import Body, Query, Headers, NotGiven, BinaryTypes, FileContent, not_given
+from ..._types import Body, Query, Headers, NotGiven, not_given
+from ..._utils import extract_files, maybe_transform, deepcopy_minimal
 from ..._compat import cached_property
+from ...types.ai import to_markdown_transform_params
 from ..._resource import SyncAPIResource, AsyncAPIResource
 from ..._response import (
     to_raw_response_wrapper,
@@ -80,9 +81,9 @@ def supported(
 
     def transform(
         self,
-        file: FileContent | BinaryTypes,
         *,
         account_id: str,
+        file: to_markdown_transform_params.File,
         # 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,
@@ -104,11 +105,17 @@ def transform(
         """
         if not account_id:
             raise ValueError(f"Expected a non-empty value for `account_id` but received {account_id!r}")
-        extra_headers = {"Content-Type": "application/octet-stream", **(extra_headers or {})}
+        body = deepcopy_minimal(file)
+        files = extract_files(cast(Mapping[str, object], body), paths=[["files", "<array>"]])
+        # It should be noted that the actual Content-Type header that will be
+        # sent to the server will contain a `boundary` parameter, e.g.
+        # multipart/form-data; boundary=---abc--
+        extra_headers = {"Content-Type": "multipart/form-data", **(extra_headers or {})}
         return self._get_api_list(
             f"/accounts/{account_id}/ai/tomarkdown",
             page=SyncSinglePage[ToMarkdownTransformResponse],
-            content=read_file_content(file) if isinstance(file, os.PathLike) else file,
+            body=maybe_transform(body, to_markdown_transform_params.ToMarkdownTransformParams),
+            files=files,
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
@@ -173,9 +180,9 @@ def supported(
 
     def transform(
         self,
-        file: FileContent | BinaryTypes,
         *,
         account_id: str,
+        file: to_markdown_transform_params.File,
         # 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,
@@ -197,11 +204,17 @@ def transform(
         """
         if not account_id:
             raise ValueError(f"Expected a non-empty value for `account_id` but received {account_id!r}")
-        extra_headers = {"Content-Type": "application/octet-stream", **(extra_headers or {})}
+        body = deepcopy_minimal(file)
+        files = extract_files(cast(Mapping[str, object], body), paths=[["files", "<array>"]])
+        # It should be noted that the actual Content-Type header that will be
+        # sent to the server will contain a `boundary` parameter, e.g.
+        # multipart/form-data; boundary=---abc--
+        extra_headers = {"Content-Type": "multipart/form-data", **(extra_headers or {})}
         return self._get_api_list(
             f"/accounts/{account_id}/ai/tomarkdown",
             page=AsyncSinglePage[ToMarkdownTransformResponse],
-            content=read_file_content(file) if isinstance(file, os.PathLike) else file,
+            body=maybe_transform(body, to_markdown_transform_params.ToMarkdownTransformParams),
+            files=files,
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),

src/cloudflare/resources/radar/ai/to_markdown.py

@@ -2,21 +2,21 @@
 
 from __future__ import annotations
 
-import os
 import typing_extensions
+from typing import Mapping, cast
 
 import httpx
 
-from ...._files import read_file_content
 from ...._types import (
     Body,
     Query,
     Headers,
     NotGiven,
-    BinaryTypes,
-    FileContent,
+    FileTypes,
+    SequenceNotStr,
     not_given,
 )
+from ...._utils import extract_files, maybe_transform, deepcopy_minimal
 from ...._compat import cached_property
 from ...._resource import SyncAPIResource, AsyncAPIResource
 from ...._response import (
@@ -27,6 +27,7 @@
 )
 from ....pagination import SyncSinglePage, AsyncSinglePage
 from ...._base_client import AsyncPaginator, make_request_options
+from ....types.radar.ai import to_markdown_create_params
 from ....types.radar.ai.to_markdown_create_response import ToMarkdownCreateResponse
 
 __all__ = ["ToMarkdownResource", "AsyncToMarkdownResource"]
@@ -57,9 +58,9 @@ def with_streaming_response(self) -> ToMarkdownResourceWithStreamingResponse:
     )
     def create(
         self,
-        body: FileContent | BinaryTypes,
         *,
         account_id: str,
+        files: SequenceNotStr[FileTypes],
         # 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,
@@ -81,11 +82,17 @@ def create(
         """
         if not account_id:
             raise ValueError(f"Expected a non-empty value for `account_id` but received {account_id!r}")
-        extra_headers = {"Content-Type": "application/octet-stream", **(extra_headers or {})}
+        body = deepcopy_minimal({"files": files})
+        extracted_files = extract_files(cast(Mapping[str, object], body), paths=[["files", "<array>"]])
+        # It should be noted that the actual Content-Type header that will be
+        # sent to the server will contain a `boundary` parameter, e.g.
+        # multipart/form-data; boundary=---abc--
+        extra_headers = {"Content-Type": "multipart/form-data", **(extra_headers or {})}
         return self._get_api_list(
             f"/accounts/{account_id}/ai/tomarkdown",
             page=SyncSinglePage[ToMarkdownCreateResponse],
-            content=read_file_content(body) if isinstance(body, os.PathLike) else body,
+            body=maybe_transform(body, to_markdown_create_params.ToMarkdownCreateParams),
+            files=extracted_files,
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
@@ -119,9 +126,9 @@ def with_streaming_response(self) -> AsyncToMarkdownResourceWithStreamingRespons
     )
     def create(
         self,
-        body: FileContent | BinaryTypes,
         *,
         account_id: str,
+        files: SequenceNotStr[FileTypes],
         # 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,
@@ -143,11 +150,17 @@ def create(
         """
         if not account_id:
             raise ValueError(f"Expected a non-empty value for `account_id` but received {account_id!r}")
-        extra_headers = {"Content-Type": "application/octet-stream", **(extra_headers or {})}
+        body = deepcopy_minimal({"files": files})
+        extracted_files = extract_files(cast(Mapping[str, object], body), paths=[["files", "<array>"]])
+        # It should be noted that the actual Content-Type header that will be
+        # sent to the server will contain a `boundary` parameter, e.g.
+        # multipart/form-data; boundary=---abc--
+        extra_headers = {"Content-Type": "multipart/form-data", **(extra_headers or {})}
         return self._get_api_list(
             f"/accounts/{account_id}/ai/tomarkdown",
             page=AsyncSinglePage[ToMarkdownCreateResponse],
-            content=read_file_content(body) if isinstance(body, os.PathLike) else body,
+            body=maybe_transform(body, to_markdown_create_params.ToMarkdownCreateParams),
+            files=extracted_files,
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),

src/cloudflare/types/ai/to_markdown_transform_params.py

@@ -4,8 +4,16 @@
 
 from typing_extensions import Required, TypedDict
 
-__all__ = ["ToMarkdownTransformParams"]
+from ..._types import FileTypes, SequenceNotStr
+
+__all__ = ["ToMarkdownTransformParams", "File"]
 
 
 class ToMarkdownTransformParams(TypedDict, total=False):
     account_id: Required[str]
+
+    file: Required[File]
+
+
+class File(TypedDict, total=False):
+    files: Required[SequenceNotStr[FileTypes]]

src/cloudflare/types/radar/ai/to_markdown_create_params.py

@@ -4,8 +4,12 @@
 
 from typing_extensions import Required, TypedDict
 
+from ...._types import FileTypes, SequenceNotStr
+
 __all__ = ["ToMarkdownCreateParams"]
 
 
 class ToMarkdownCreateParams(TypedDict, total=False):
     account_id: Required[str]
+
+    files: Required[SequenceNotStr[FileTypes]]

tests/api_resources/ai/test_to_markdown.py

@@ -59,16 +59,16 @@ def test_path_params_supported(self, client: Cloudflare) -> None:
     @parametrize
     def test_method_transform(self, client: Cloudflare) -> None:
         to_markdown = client.ai.to_markdown.transform(
-            file=b"raw file contents",
             account_id="023e105f4ecef8ad9ca31a8372d0c353",
+            file={"files": [b"raw file contents"]},
         )
         assert_matches_type(SyncSinglePage[ToMarkdownTransformResponse], to_markdown, path=["response"])
 
     @parametrize
     def test_raw_response_transform(self, client: Cloudflare) -> None:
         response = client.ai.to_markdown.with_raw_response.transform(
-            file=b"raw file contents",
             account_id="023e105f4ecef8ad9ca31a8372d0c353",
+            file={"files": [b"raw file contents"]},
         )
 
         assert response.is_closed is True
@@ -79,8 +79,8 @@ def test_raw_response_transform(self, client: Cloudflare) -> None:
     @parametrize
     def test_streaming_response_transform(self, client: Cloudflare) -> None:
         with client.ai.to_markdown.with_streaming_response.transform(
-            file=b"raw file contents",
             account_id="023e105f4ecef8ad9ca31a8372d0c353",
+            file={"files": [b"raw file contents"]},
         ) as response:
             assert not response.is_closed
             assert response.http_request.headers.get("X-Stainless-Lang") == "python"
@@ -94,8 +94,8 @@ def test_streaming_response_transform(self, client: Cloudflare) -> None:
     def test_path_params_transform(self, client: Cloudflare) -> None:
         with pytest.raises(ValueError, match=r"Expected a non-empty value for `account_id` but received ''"):
             client.ai.to_markdown.with_raw_response.transform(
-                file=b"raw file contents",
                 account_id="",
+                file={"files": [b"raw file contents"]},
             )
 
 
@@ -145,16 +145,16 @@ async def test_path_params_supported(self, async_client: AsyncCloudflare) -> Non
     @parametrize
     async def test_method_transform(self, async_client: AsyncCloudflare) -> None:
         to_markdown = await async_client.ai.to_markdown.transform(
-            file=b"raw file contents",
             account_id="023e105f4ecef8ad9ca31a8372d0c353",
+            file={"files": [b"raw file contents"]},
         )
         assert_matches_type(AsyncSinglePage[ToMarkdownTransformResponse], to_markdown, path=["response"])
 
     @parametrize
     async def test_raw_response_transform(self, async_client: AsyncCloudflare) -> None:
         response = await async_client.ai.to_markdown.with_raw_response.transform(
-            file=b"raw file contents",
             account_id="023e105f4ecef8ad9ca31a8372d0c353",
+            file={"files": [b"raw file contents"]},
         )
 
         assert response.is_closed is True
@@ -165,8 +165,8 @@ async def test_raw_response_transform(self, async_client: AsyncCloudflare) -> No
     @parametrize
     async def test_streaming_response_transform(self, async_client: AsyncCloudflare) -> None:
         async with async_client.ai.to_markdown.with_streaming_response.transform(
-            file=b"raw file contents",
             account_id="023e105f4ecef8ad9ca31a8372d0c353",
+            file={"files": [b"raw file contents"]},
         ) as response:
             assert not response.is_closed
             assert response.http_request.headers.get("X-Stainless-Lang") == "python"
@@ -180,6 +180,6 @@ async def test_streaming_response_transform(self, async_client: AsyncCloudflare)
     async def test_path_params_transform(self, async_client: AsyncCloudflare) -> None:
         with pytest.raises(ValueError, match=r"Expected a non-empty value for `account_id` but received ''"):
             await async_client.ai.to_markdown.with_raw_response.transform(
-                file=b"raw file contents",
                 account_id="",
+                file={"files": [b"raw file contents"]},
             )

tests/api_resources/radar/ai/test_to_markdown.py

@@ -25,8 +25,8 @@ class TestToMarkdown:
     def test_method_create(self, client: Cloudflare) -> None:
         with pytest.warns(DeprecationWarning):
             to_markdown = client.radar.ai.to_markdown.create(
-                body=b"raw file contents",
                 account_id="023e105f4ecef8ad9ca31a8372d0c353",
+                files=[b"raw file contents"],
             )
 
         assert_matches_type(SyncSinglePage[ToMarkdownCreateResponse], to_markdown, path=["response"])
@@ -36,8 +36,8 @@ def test_method_create(self, client: Cloudflare) -> None:
     def test_raw_response_create(self, client: Cloudflare) -> None:
         with pytest.warns(DeprecationWarning):
             response = client.radar.ai.to_markdown.with_raw_response.create(
-                body=b"raw file contents",
                 account_id="023e105f4ecef8ad9ca31a8372d0c353",
+                files=[b"raw file contents"],
             )
 
         assert response.is_closed is True
@@ -50,8 +50,8 @@ def test_raw_response_create(self, client: Cloudflare) -> None:
     def test_streaming_response_create(self, client: Cloudflare) -> None:
         with pytest.warns(DeprecationWarning):
             with client.radar.ai.to_markdown.with_streaming_response.create(
-                body=b"raw file contents",
                 account_id="023e105f4ecef8ad9ca31a8372d0c353",
+                files=[b"raw file contents"],
             ) as response:
                 assert not response.is_closed
                 assert response.http_request.headers.get("X-Stainless-Lang") == "python"
@@ -67,8 +67,8 @@ def test_path_params_create(self, client: Cloudflare) -> None:
         with pytest.warns(DeprecationWarning):
             with pytest.raises(ValueError, match=r"Expected a non-empty value for `account_id` but received ''"):
                 client.radar.ai.to_markdown.with_raw_response.create(
-                    body=b"raw file contents",
                     account_id="",
+                    files=[b"raw file contents"],
                 )
 
 
@@ -82,8 +82,8 @@ class TestAsyncToMarkdown:
     async def test_method_create(self, async_client: AsyncCloudflare) -> None:
         with pytest.warns(DeprecationWarning):
             to_markdown = await async_client.radar.ai.to_markdown.create(
-                body=b"raw file contents",
                 account_id="023e105f4ecef8ad9ca31a8372d0c353",
+                files=[b"raw file contents"],
             )
 
         assert_matches_type(AsyncSinglePage[ToMarkdownCreateResponse], to_markdown, path=["response"])
@@ -93,8 +93,8 @@ async def test_method_create(self, async_client: AsyncCloudflare) -> None:
     async def test_raw_response_create(self, async_client: AsyncCloudflare) -> None:
         with pytest.warns(DeprecationWarning):
             response = await async_client.radar.ai.to_markdown.with_raw_response.create(
-                body=b"raw file contents",
                 account_id="023e105f4ecef8ad9ca31a8372d0c353",
+                files=[b"raw file contents"],
             )
 
         assert response.is_closed is True
@@ -107,8 +107,8 @@ async def test_raw_response_create(self, async_client: AsyncCloudflare) -> None:
     async def test_streaming_response_create(self, async_client: AsyncCloudflare) -> None:
         with pytest.warns(DeprecationWarning):
             async with async_client.radar.ai.to_markdown.with_streaming_response.create(
-                body=b"raw file contents",
                 account_id="023e105f4ecef8ad9ca31a8372d0c353",
+                files=[b"raw file contents"],
             ) as response:
                 assert not response.is_closed
                 assert response.http_request.headers.get("X-Stainless-Lang") == "python"
@@ -124,6 +124,6 @@ async def test_path_params_create(self, async_client: AsyncCloudflare) -> None:
         with pytest.warns(DeprecationWarning):
             with pytest.raises(ValueError, match=r"Expected a non-empty value for `account_id` but received ''"):
                 await async_client.radar.ai.to_markdown.with_raw_response.create(
-                    body=b"raw file contents",
                     account_id="",
+                    files=[b"raw file contents"],
                 )