feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 33
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/nen-labs%2Fsteel-44f289567c281ce445273c28f44fe7ccd44979172c4933bfbfe63bb5f119640c.yml
-openapi_spec_hash: 449cf480b2d477ef67ff32992734fb8c
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/nen-labs%2Fsteel-b5496a8d20faef3918563bbf1563b9c1f0ab280fa0aa32baca55faa95c8d8266.yml
+openapi_spec_hash: b776cb76def983d026964ea90cdb3e29
 config_hash: 3dda15a7a3da8ba8e97a8ec239cbcb80

api.md

@@ -115,9 +115,9 @@ from steel.types import (
 
 Methods:
 
-- <code title="put /v1/extensions/{extensionId}">client.extensions.<a href="./src/steel/resources/extensions.py">update</a>(extension_id) -> <a href="./src/steel/types/extension_update_response.py">ExtensionUpdateResponse</a></code>
+- <code title="put /v1/extensions/{extensionId}">client.extensions.<a href="./src/steel/resources/extensions.py">update</a>(extension_id, \*\*<a href="src/steel/types/extension_update_params.py">params</a>) -> <a href="./src/steel/types/extension_update_response.py">ExtensionUpdateResponse</a></code>
 - <code title="get /v1/extensions">client.extensions.<a href="./src/steel/resources/extensions.py">list</a>() -> <a href="./src/steel/types/extension_list_response.py">ExtensionListResponse</a></code>
 - <code title="delete /v1/extensions/{extensionId}">client.extensions.<a href="./src/steel/resources/extensions.py">delete</a>(extension_id) -> <a href="./src/steel/types/extension_delete_response.py">ExtensionDeleteResponse</a></code>
 - <code title="delete /v1/extensions">client.extensions.<a href="./src/steel/resources/extensions.py">delete_all</a>() -> <a href="./src/steel/types/extension_delete_all_response.py">ExtensionDeleteAllResponse</a></code>
 - <code title="get /v1/extensions/{extensionId}">client.extensions.<a href="./src/steel/resources/extensions.py">download</a>(extension_id) -> str</code>
-- <code title="post /v1/extensions">client.extensions.<a href="./src/steel/resources/extensions.py">upload</a>() -> <a href="./src/steel/types/extension_upload_response.py">ExtensionUploadResponse</a></code>
+- <code title="post /v1/extensions">client.extensions.<a href="./src/steel/resources/extensions.py">upload</a>(\*\*<a href="src/steel/types/extension_upload_params.py">params</a>) -> <a href="./src/steel/types/extension_upload_response.py">ExtensionUploadResponse</a></code>

src/steel/resources/extensions.py

@@ -4,7 +4,9 @@
 
 import httpx
 
+from ..types import extension_update_params, extension_upload_params
 from .._types import NOT_GIVEN, Body, Query, Headers, NotGiven
+from .._utils import maybe_transform, async_maybe_transform
 from .._compat import cached_property
 from .._resource import SyncAPIResource, AsyncAPIResource
 from .._response import (
@@ -47,6 +49,8 @@ def update(
         self,
         extension_id: str,
         *,
+        file: object | NotGiven = NOT_GIVEN,
+        url: str | 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,
@@ -55,9 +59,14 @@ def update(
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> ExtensionUpdateResponse:
         """
-        Update a Chrome extension (.zip/.crx file) for the organization
+        Update a Chrome extension (.zip/.crx file or Chrome Web Store URL) for the
+        organization
 
         Args:
+          file: Extension .zip/.crx file
+
+          url: Extension URL
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -68,8 +77,19 @@ def update(
         """
         if not extension_id:
             raise ValueError(f"Expected a non-empty value for `extension_id` but received {extension_id!r}")
+        # 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._put(
             f"/v1/extensions/{extension_id}",
+            body=maybe_transform(
+                {
+                    "file": file,
+                    "url": url,
+                },
+                extension_update_params.ExtensionUpdateParams,
+            ),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
@@ -183,16 +203,45 @@ def download(
     def upload(
         self,
         *,
+        file: object | NotGiven = NOT_GIVEN,
+        url: str | 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,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> ExtensionUploadResponse:
-        """Upload a Chrome extension (.zip/.crx file) for the organization"""
+        """
+        Upload a Chrome extension (.zip/.crx file or Chrome Web Store URL) for the
+        organization
+
+        Args:
+          file: Extension .zip/.crx file
+
+          url: Extension URL
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        # 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._post(
             "/v1/extensions",
+            body=maybe_transform(
+                {
+                    "file": file,
+                    "url": url,
+                },
+                extension_upload_params.ExtensionUploadParams,
+            ),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
@@ -224,6 +273,8 @@ async def update(
         self,
         extension_id: str,
         *,
+        file: object | NotGiven = NOT_GIVEN,
+        url: str | 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,
@@ -232,9 +283,14 @@ async def update(
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> ExtensionUpdateResponse:
         """
-        Update a Chrome extension (.zip/.crx file) for the organization
+        Update a Chrome extension (.zip/.crx file or Chrome Web Store URL) for the
+        organization
 
         Args:
+          file: Extension .zip/.crx file
+
+          url: Extension URL
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -245,8 +301,19 @@ async def update(
         """
         if not extension_id:
             raise ValueError(f"Expected a non-empty value for `extension_id` but received {extension_id!r}")
+        # 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 await self._put(
             f"/v1/extensions/{extension_id}",
+            body=await async_maybe_transform(
+                {
+                    "file": file,
+                    "url": url,
+                },
+                extension_update_params.ExtensionUpdateParams,
+            ),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
@@ -360,16 +427,45 @@ async def download(
     async def upload(
         self,
         *,
+        file: object | NotGiven = NOT_GIVEN,
+        url: str | 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,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> ExtensionUploadResponse:
-        """Upload a Chrome extension (.zip/.crx file) for the organization"""
+        """
+        Upload a Chrome extension (.zip/.crx file or Chrome Web Store URL) for the
+        organization
+
+        Args:
+          file: Extension .zip/.crx file
+
+          url: Extension URL
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        # 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 await self._post(
             "/v1/extensions",
+            body=await async_maybe_transform(
+                {
+                    "file": file,
+                    "url": url,
+                },
+                extension_upload_params.ExtensionUploadParams,
+            ),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),

src/steel/types/__init__.py

@@ -17,6 +17,8 @@
 from .session_create_params import SessionCreateParams as SessionCreateParams
 from .credential_list_params import CredentialListParams as CredentialListParams
 from .extension_list_response import ExtensionListResponse as ExtensionListResponse
+from .extension_update_params import ExtensionUpdateParams as ExtensionUpdateParams
+from .extension_upload_params import ExtensionUploadParams as ExtensionUploadParams
 from .session_events_response import SessionEventsResponse as SessionEventsResponse
 from .client_screenshot_params import ClientScreenshotParams as ClientScreenshotParams
 from .credential_create_params import CredentialCreateParams as CredentialCreateParams

src/steel/types/extension_update_params.py

@@ -0,0 +1,15 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import TypedDict
+
+__all__ = ["ExtensionUpdateParams"]
+
+
+class ExtensionUpdateParams(TypedDict, total=False):
+    file: object
+    """Extension .zip/.crx file"""
+
+    url: str
+    """Extension URL"""

src/steel/types/extension_upload_params.py

@@ -0,0 +1,15 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import TypedDict
+
+__all__ = ["ExtensionUploadParams"]
+
+
+class ExtensionUploadParams(TypedDict, total=False):
+    file: object
+    """Extension .zip/.crx file"""
+
+    url: str
+    """Extension URL"""

tests/api_resources/test_extensions.py

@@ -26,14 +26,23 @@ class TestExtensions:
     @parametrize
     def test_method_update(self, client: Steel) -> None:
         extension = client.extensions.update(
-            "extensionId",
+            extension_id="extensionId",
+        )
+        assert_matches_type(ExtensionUpdateResponse, extension, path=["response"])
+
+    @parametrize
+    def test_method_update_with_all_params(self, client: Steel) -> None:
+        extension = client.extensions.update(
+            extension_id="extensionId",
+            file={},
+            url="https://example.com",
         )
         assert_matches_type(ExtensionUpdateResponse, extension, path=["response"])
 
     @parametrize
     def test_raw_response_update(self, client: Steel) -> None:
         response = client.extensions.with_raw_response.update(
-            "extensionId",
+            extension_id="extensionId",
         )
 
         assert response.is_closed is True
@@ -44,7 +53,7 @@ def test_raw_response_update(self, client: Steel) -> None:
     @parametrize
     def test_streaming_response_update(self, client: Steel) -> None:
         with client.extensions.with_streaming_response.update(
-            "extensionId",
+            extension_id="extensionId",
         ) as response:
             assert not response.is_closed
             assert response.http_request.headers.get("X-Stainless-Lang") == "python"
@@ -58,7 +67,7 @@ def test_streaming_response_update(self, client: Steel) -> None:
     def test_path_params_update(self, client: Steel) -> None:
         with pytest.raises(ValueError, match=r"Expected a non-empty value for `extension_id` but received ''"):
             client.extensions.with_raw_response.update(
-                "",
+                extension_id="",
             )
 
     @parametrize
@@ -192,6 +201,14 @@ def test_method_upload(self, client: Steel) -> None:
         extension = client.extensions.upload()
         assert_matches_type(ExtensionUploadResponse, extension, path=["response"])
 
+    @parametrize
+    def test_method_upload_with_all_params(self, client: Steel) -> None:
+        extension = client.extensions.upload(
+            file={},
+            url="https://example.com",
+        )
+        assert_matches_type(ExtensionUploadResponse, extension, path=["response"])
+
     @parametrize
     def test_raw_response_upload(self, client: Steel) -> None:
         response = client.extensions.with_raw_response.upload()
@@ -221,14 +238,23 @@ class TestAsyncExtensions:
     @parametrize
     async def test_method_update(self, async_client: AsyncSteel) -> None:
         extension = await async_client.extensions.update(
-            "extensionId",
+            extension_id="extensionId",
+        )
+        assert_matches_type(ExtensionUpdateResponse, extension, path=["response"])
+
+    @parametrize
+    async def test_method_update_with_all_params(self, async_client: AsyncSteel) -> None:
+        extension = await async_client.extensions.update(
+            extension_id="extensionId",
+            file={},
+            url="https://example.com",
         )
         assert_matches_type(ExtensionUpdateResponse, extension, path=["response"])
 
     @parametrize
     async def test_raw_response_update(self, async_client: AsyncSteel) -> None:
         response = await async_client.extensions.with_raw_response.update(
-            "extensionId",
+            extension_id="extensionId",
         )
 
         assert response.is_closed is True
@@ -239,7 +265,7 @@ async def test_raw_response_update(self, async_client: AsyncSteel) -> None:
     @parametrize
     async def test_streaming_response_update(self, async_client: AsyncSteel) -> None:
         async with async_client.extensions.with_streaming_response.update(
-            "extensionId",
+            extension_id="extensionId",
         ) as response:
             assert not response.is_closed
             assert response.http_request.headers.get("X-Stainless-Lang") == "python"
@@ -253,7 +279,7 @@ async def test_streaming_response_update(self, async_client: AsyncSteel) -> None
     async def test_path_params_update(self, async_client: AsyncSteel) -> None:
         with pytest.raises(ValueError, match=r"Expected a non-empty value for `extension_id` but received ''"):
             await async_client.extensions.with_raw_response.update(
-                "",
+                extension_id="",
             )
 
     @parametrize
@@ -387,6 +413,14 @@ async def test_method_upload(self, async_client: AsyncSteel) -> None:
         extension = await async_client.extensions.upload()
         assert_matches_type(ExtensionUploadResponse, extension, path=["response"])
 
+    @parametrize
+    async def test_method_upload_with_all_params(self, async_client: AsyncSteel) -> None:
+        extension = await async_client.extensions.upload(
+            file={},
+            url="https://example.com",
+        )
+        assert_matches_type(ExtensionUploadResponse, extension, path=["response"])
+
     @parametrize
     async def test_raw_response_upload(self, async_client: AsyncSteel) -> None:
         response = await async_client.extensions.with_raw_response.upload()