feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 29
+configured_endpoints: 30
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/arcade-ai%2Farcade-engine-4dc4e58ef402ce5362e0a8988b3928a8bfa0d5ba847f7ad8b14226a0cf282f28.yml
 openapi_spec_hash: fb72b9121306240c419669a3d42e45f6
-config_hash: f0d78fdab30e3346ae9b6804632ae8b6
+config_hash: 7d1d98a4a1938a6884fa81ccfa3184c5

api.md

@@ -50,6 +50,7 @@ from arcadepy.types.admin import SecretResponse, SecretListResponse
 
 Methods:
 
+- <code title="post /v1/admin/secrets/{secret_key}">client.admin.secrets.<a href="./src/arcadepy/resources/admin/secrets.py">create</a>(secret_key, \*\*<a href="src/arcadepy/types/admin/secret_create_params.py">params</a>) -> <a href="./src/arcadepy/types/admin/secret_response.py">SecretResponse</a></code>
 - <code title="get /v1/admin/secrets">client.admin.secrets.<a href="./src/arcadepy/resources/admin/secrets.py">list</a>() -> <a href="./src/arcadepy/types/admin/secret_list_response.py">SecretListResponse</a></code>
 - <code title="delete /v1/admin/secrets/{secret_id}">client.admin.secrets.<a href="./src/arcadepy/resources/admin/secrets.py">delete</a>(secret_id) -> None</code>
 

src/arcadepy/resources/admin/secrets.py

@@ -4,7 +4,8 @@
 
 import httpx
 
-from ..._types import Body, Query, Headers, NoneType, NotGiven, not_given
+from ..._types import Body, Omit, Query, Headers, NoneType, NotGiven, omit, not_given
+from ..._utils import maybe_transform, async_maybe_transform
 from ..._compat import cached_property
 from ..._resource import SyncAPIResource, AsyncAPIResource
 from ..._response import (
@@ -13,7 +14,9 @@
     async_to_raw_response_wrapper,
     async_to_streamed_response_wrapper,
 )
+from ...types.admin import secret_create_params
 from ..._base_client import make_request_options
+from ...types.admin.secret_response import SecretResponse
 from ...types.admin.secret_list_response import SecretListResponse
 
 __all__ = ["SecretsResource", "AsyncSecretsResource"]
@@ -39,6 +42,48 @@ def with_streaming_response(self) -> SecretsResourceWithStreamingResponse:
         """
         return SecretsResourceWithStreamingResponse(self)
 
+    def create(
+        self,
+        secret_key: str,
+        *,
+        value: str,
+        description: str | Omit = omit,
+        # 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,
+    ) -> SecretResponse:
+        """
+        Create or update a secret
+
+        Args:
+          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
+        """
+        if not secret_key:
+            raise ValueError(f"Expected a non-empty value for `secret_key` but received {secret_key!r}")
+        return self._post(
+            f"/v1/admin/secrets/{secret_key}",
+            body=maybe_transform(
+                {
+                    "value": value,
+                    "description": description,
+                },
+                secret_create_params.SecretCreateParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=SecretResponse,
+        )
+
     def list(
         self,
         *,
@@ -113,6 +158,48 @@ def with_streaming_response(self) -> AsyncSecretsResourceWithStreamingResponse:
         """
         return AsyncSecretsResourceWithStreamingResponse(self)
 
+    async def create(
+        self,
+        secret_key: str,
+        *,
+        value: str,
+        description: str | Omit = omit,
+        # 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,
+    ) -> SecretResponse:
+        """
+        Create or update a secret
+
+        Args:
+          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
+        """
+        if not secret_key:
+            raise ValueError(f"Expected a non-empty value for `secret_key` but received {secret_key!r}")
+        return await self._post(
+            f"/v1/admin/secrets/{secret_key}",
+            body=await async_maybe_transform(
+                {
+                    "value": value,
+                    "description": description,
+                },
+                secret_create_params.SecretCreateParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=SecretResponse,
+        )
+
     async def list(
         self,
         *,
@@ -171,6 +258,9 @@ class SecretsResourceWithRawResponse:
     def __init__(self, secrets: SecretsResource) -> None:
         self._secrets = secrets
 
+        self.create = to_raw_response_wrapper(
+            secrets.create,
+        )
         self.list = to_raw_response_wrapper(
             secrets.list,
         )
@@ -183,6 +273,9 @@ class AsyncSecretsResourceWithRawResponse:
     def __init__(self, secrets: AsyncSecretsResource) -> None:
         self._secrets = secrets
 
+        self.create = async_to_raw_response_wrapper(
+            secrets.create,
+        )
         self.list = async_to_raw_response_wrapper(
             secrets.list,
         )
@@ -195,6 +288,9 @@ class SecretsResourceWithStreamingResponse:
     def __init__(self, secrets: SecretsResource) -> None:
         self._secrets = secrets
 
+        self.create = to_streamed_response_wrapper(
+            secrets.create,
+        )
         self.list = to_streamed_response_wrapper(
             secrets.list,
         )
@@ -207,6 +303,9 @@ class AsyncSecretsResourceWithStreamingResponse:
     def __init__(self, secrets: AsyncSecretsResource) -> None:
         self._secrets = secrets
 
+        self.create = async_to_streamed_response_wrapper(
+            secrets.create,
+        )
         self.list = async_to_streamed_response_wrapper(
             secrets.list,
         )

src/arcadepy/types/admin/__init__.py

@@ -3,6 +3,7 @@
 from __future__ import annotations
 
 from .secret_response import SecretResponse as SecretResponse
+from .secret_create_params import SecretCreateParams as SecretCreateParams
 from .secret_list_response import SecretListResponse as SecretListResponse
 from .auth_provider_response import AuthProviderResponse as AuthProviderResponse
 from .user_connection_response import UserConnectionResponse as UserConnectionResponse

src/arcadepy/types/admin/secret_create_params.py

@@ -0,0 +1,13 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Required, TypedDict
+
+__all__ = ["SecretCreateParams"]
+
+
+class SecretCreateParams(TypedDict, total=False):
+    value: Required[str]
+
+    description: str

tests/api_resources/admin/test_secrets.py

@@ -9,14 +9,65 @@
 
 from arcadepy import Arcade, AsyncArcade
 from tests.utils import assert_matches_type
-from arcadepy.types.admin import SecretListResponse
+from arcadepy.types.admin import SecretResponse, SecretListResponse
 
 base_url = os.environ.get("TEST_API_BASE_URL", "http://127.0.0.1:4010")
 
 
 class TestSecrets:
     parametrize = pytest.mark.parametrize("client", [False, True], indirect=True, ids=["loose", "strict"])
 
+    @parametrize
+    def test_method_create(self, client: Arcade) -> None:
+        secret = client.admin.secrets.create(
+            secret_key="secret_key",
+            value="value",
+        )
+        assert_matches_type(SecretResponse, secret, path=["response"])
+
+    @parametrize
+    def test_method_create_with_all_params(self, client: Arcade) -> None:
+        secret = client.admin.secrets.create(
+            secret_key="secret_key",
+            value="value",
+            description="description",
+        )
+        assert_matches_type(SecretResponse, secret, path=["response"])
+
+    @parametrize
+    def test_raw_response_create(self, client: Arcade) -> None:
+        response = client.admin.secrets.with_raw_response.create(
+            secret_key="secret_key",
+            value="value",
+        )
+
+        assert response.is_closed is True
+        assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+        secret = response.parse()
+        assert_matches_type(SecretResponse, secret, path=["response"])
+
+    @parametrize
+    def test_streaming_response_create(self, client: Arcade) -> None:
+        with client.admin.secrets.with_streaming_response.create(
+            secret_key="secret_key",
+            value="value",
+        ) as response:
+            assert not response.is_closed
+            assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+
+            secret = response.parse()
+            assert_matches_type(SecretResponse, secret, path=["response"])
+
+        assert cast(Any, response.is_closed) is True
+
+    @parametrize
+    def test_path_params_create(self, client: Arcade) -> None:
+        with pytest.raises(ValueError, match=r"Expected a non-empty value for `secret_key` but received ''"):
+            client.admin.secrets.with_raw_response.create(
+                secret_key="",
+                value="value",
+            )
+
     @parametrize
     def test_method_list(self, client: Arcade) -> None:
         secret = client.admin.secrets.list()
@@ -86,6 +137,57 @@ class TestAsyncSecrets:
         "async_client", [False, True, {"http_client": "aiohttp"}], indirect=True, ids=["loose", "strict", "aiohttp"]
     )
 
+    @parametrize
+    async def test_method_create(self, async_client: AsyncArcade) -> None:
+        secret = await async_client.admin.secrets.create(
+            secret_key="secret_key",
+            value="value",
+        )
+        assert_matches_type(SecretResponse, secret, path=["response"])
+
+    @parametrize
+    async def test_method_create_with_all_params(self, async_client: AsyncArcade) -> None:
+        secret = await async_client.admin.secrets.create(
+            secret_key="secret_key",
+            value="value",
+            description="description",
+        )
+        assert_matches_type(SecretResponse, secret, path=["response"])
+
+    @parametrize
+    async def test_raw_response_create(self, async_client: AsyncArcade) -> None:
+        response = await async_client.admin.secrets.with_raw_response.create(
+            secret_key="secret_key",
+            value="value",
+        )
+
+        assert response.is_closed is True
+        assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+        secret = await response.parse()
+        assert_matches_type(SecretResponse, secret, path=["response"])
+
+    @parametrize
+    async def test_streaming_response_create(self, async_client: AsyncArcade) -> None:
+        async with async_client.admin.secrets.with_streaming_response.create(
+            secret_key="secret_key",
+            value="value",
+        ) as response:
+            assert not response.is_closed
+            assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+
+            secret = await response.parse()
+            assert_matches_type(SecretResponse, secret, path=["response"])
+
+        assert cast(Any, response.is_closed) is True
+
+    @parametrize
+    async def test_path_params_create(self, async_client: AsyncArcade) -> None:
+        with pytest.raises(ValueError, match=r"Expected a non-empty value for `secret_key` but received ''"):
+            await async_client.admin.secrets.with_raw_response.create(
+                secret_key="",
+                value="value",
+            )
+
     @parametrize
     async def test_method_list(self, async_client: AsyncArcade) -> None:
         secret = await async_client.admin.secrets.list()