ourseams-sdk 0.1.0__py3-none-any.whl

ourseams_sdk-0.1.0.dist-info/METADATA

@@ -0,0 +1,60 @@
+Metadata-Version: 2.5
+Name: ourseams-sdk
+Version: 0.1.0
+Summary: The typed Python client for the seams control plane, generated from its OpenAPI document.
+Project-URL: Homepage, https://ourseams.com
+License-Expression: MIT
+License-File: LICENSE
+Requires-Python: >=3.10
+Requires-Dist: httpx<1,>=0.27
+Requires-Dist: pydantic<3,>=2.7
+Description-Content-Type: text/markdown
+
+# seams
+
+The typed Python client for the seams control plane. **Generated from the OpenAPI document**, which is
+emitted from the API's route table — so it cannot describe a shape the API does not serve, and it stays
+in step with `@ourseams/sdk`.
+
+```python
+import os
+from seams import Seams
+
+seams = Seams(api_key=os.environ["SEAMS_SECRET_KEY"])
+
+seams.users.create("alice", models.CreateEndUserRequest(email="alice@firm.com"))
+key = seams.keys.mint(models.MintKeyRequest(end_user_id="alice", bundle="pro"))
+print(key.key)
+```
+
+## One namespace per CLI command group
+
+`operationId` carries the CLI's own verb, so the method reads like the command:
+
+```text
+seams models add smart …        →  seams.models.add("smart", …)
+seams bundles price pro fast …  →  seams.bundles.price("pro", …)
+seams outcomes runs             →  seams.outcomes.runs()
+seams usage --by model          →  seams.usage(by="model")
+```
+
+Top-level commands stay top-level: `usage`, `margin`, `audit`, `doctor`, `capabilities`. Routes the API
+serves but does not offer a client carry `x-seams-internal: true` and get no method.
+
+## Sync and async
+
+`Seams` and `AsyncSeams` are generated from the same document and carry the same 76 methods.
+
+## Two runtime dependencies
+
+`httpx` for the transport and `pydantic` for the models. Field names are Python's — `end_users`, not
+`endUsers` — with the wire name kept as an alias.
+
+## Regenerating
+
+```bash
+uv run python scripts/generate.py   # models and facade
+```
+
+`src/seams/_generated/` is written by the generator. Do not edit it. The document it reads,
+`../openapi.json`, is emitted by [the TypeScript client](../typescript) from the API's route table.

ourseams_sdk-0.1.0.dist-info/RECORD

@@ -0,0 +1,10 @@
+seams/__init__.py,sha256=z2-CZy7ibTT-1bVAC62UXWWKSXBDZMOEA7mmWcW4wzA,1458
+seams/_transport.py,sha256=GunsrDZuU8S60Clak0F9cxhCpClGj9NRBVXFmONfLnU,3589
+seams/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+seams/_generated/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+seams/_generated/client.py,sha256=PBATmHBw6Em9F0oRoRLOWoTXBdqc9CsjfWwJr1xy8BE,44046
+seams/_generated/models.py,sha256=AaLUeUb_ie6vYrbr_34lJu_EF4yJ-dJBY5Ki6v9mYFk,35757
+ourseams_sdk-0.1.0.dist-info/METADATA,sha256=-YZ7Dq2pgWeSdaE7TC3hrK9Rj7hrbm0dgs_5TMfl1iI,2063
+ourseams_sdk-0.1.0.dist-info/WHEEL,sha256=zOwg4jB6zX2kU910N-cMawjivD6tO8NEWvE12je1bVk,87
+ourseams_sdk-0.1.0.dist-info/licenses/LICENSE,sha256=7tGH164rlpABjKpS4F8c5gvvZ52M23vUFAJmZTRVR1U,1062
+ourseams_sdk-0.1.0.dist-info/RECORD,,

ourseams_sdk-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.32.0
+Root-Is-Purelib: true
+Tag: py3-none-any

ourseams_sdk-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Seams
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

seams/__init__.py

@@ -0,0 +1,55 @@
+"""The seams control plane, one namespace per CLI command group."""
+
+from __future__ import annotations
+
+import httpx
+
+from ._generated import models
+from ._generated.client import AsyncSurface, Surface
+from ._transport import DEFAULT_BASE_URL, AsyncTransport, SeamsError, Transport
+
+__all__ = ["AsyncSeams", "Seams", "SeamsError", "models"]
+
+
+class Seams(Surface):
+    """
+    >>> seams = Seams(api_key=os.environ["SEAMS_SECRET_KEY"])
+    >>> seams.users.create("alice", email="alice@firm.com")
+    >>> seams.keys.mint(end_user_id="alice", bundle="pro").key
+    """
+
+    def __init__(
+        self,
+        api_key: str,
+        base_url: str = DEFAULT_BASE_URL,
+        http_client: httpx.Client | None = None,
+    ) -> None:
+        super().__init__(Transport(api_key, base_url, http_client))
+
+    def close(self) -> None:
+        self._t.close()
+
+    def __enter__(self) -> Seams:
+        return self
+
+    def __exit__(self, *_: object) -> None:
+        self.close()
+
+
+class AsyncSeams(AsyncSurface):
+    def __init__(
+        self,
+        api_key: str,
+        base_url: str = DEFAULT_BASE_URL,
+        http_client: httpx.AsyncClient | None = None,
+    ) -> None:
+        super().__init__(AsyncTransport(api_key, base_url, http_client))
+
+    async def aclose(self) -> None:
+        await self._t.aclose()
+
+    async def __aenter__(self) -> AsyncSeams:
+        return self
+
+    async def __aexit__(self, *_: object) -> None:
+        await self.aclose()