aimage-sdk 0.1.0__tar.gz

aimage_sdk-0.1.0/.gitignore

@@ -0,0 +1,67 @@
+# Dependencies
+node_modules/
+.pnpm-store/
+
+# Build outputs
+dist/
+.next/
+.turbo/
+out/
+next-env.d.ts
+storybook-static/
+
+# Python
+__pycache__/
+*.pyc
+*.pyo
+.venv/
+venv/
+*.egg-info/
+
+# Terraform
+.terraform/
+*.tfstate
+*.tfstate.backup
+*.tfplan
+tfplan-*
+
+# Environment
+.env
+.env.*
+!.env.example
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Test & coverage
+coverage/
+.vitest/
+
+# Lint cache
+.eslintcache
+
+# Misc
+*.log
+*.tsbuildinfo
+
+
+# Rust
+/target
+infra/tfplan
+
+# Local-only artifacts
+.claude/scheduled_tasks.lock
+.claude/settings.local.json
+.playwright-mcp/
+insights-*.png
+tsup.config.bundled_*.mjs
+audit/
+.bdd-logs/
+.bdd-snapshots/

aimage_sdk-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AI-Mage Inc.
+
+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.

aimage_sdk-0.1.0/PKG-INFO

@@ -0,0 +1,90 @@
+Metadata-Version: 2.4
+Name: aimage-sdk
+Version: 0.1.0
+Summary: Python SDK for the AI-Mage Search public API
+Project-URL: Documentation, https://api.search.ai-mage.jp/docs
+Project-URL: Repository, https://github.com/aimagexyz/aimage-monorepo
+Author: AI-Mage
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Typing :: Typed
+Requires-Python: >=3.12
+Requires-Dist: httpx<1,>=0.28
+Description-Content-Type: text/markdown
+
+# aimage-sdk
+
+Python SDK for the AI-Mage Search public API (`/v0`). Python 3.12+, `httpx`
+is the only dependency.
+
+## Install
+
+The package is not yet published to PyPI. Install from the repository:
+
+```sh
+uv add "aimage-sdk @ file:///path/to/aimage-monorepo/sdks/python"
+# or: pip install /path/to/aimage-monorepo/sdks/python
+```
+
+## Quickstart
+
+```python
+import os
+
+from aimage_sdk import AimageClient
+
+client = AimageClient(
+    api_key=os.environ["AIMAGE_API_KEY"],  # "aimage_api_..."
+    base_url="https://api.search.ai-mage.jp",  # API server origin; the client calls {base_url}/v0/...
+)
+
+# Discover accessible projects.
+me = client.me()
+project_id = me["projects"][0]["id"]
+
+# Upload a video: mints a presigned URL, PUTs the bytes, registers the video.
+video = client.upload_video(
+    project_id=project_id,
+    file="./episode-01.mp4",  # str | pathlib.Path | bytes (bytes need file_name=)
+    name="Episode 1",
+    season=1,
+    episode=1,
+    on_progress=print,
+)
+
+# Wait until clip extraction and AI tagging finish.
+processed = client.wait_for_processing(video["id"], poll_interval_s=10, timeout_s=1800)
+if processed["processing_status"] == "failed":
+    raise RuntimeError(processed["processing_error"])
+
+# Search clips with a natural-language query.
+result = client.search_clips(project_id=project_id, query="two characters arguing in the rain")
+for clip in result["clips"]:
+    print(clip["start_time"], clip["subtitle"], clip["tags"], clip["characters"])
+```
+
+## API surface
+
+- `ping()` / `me()`
+- `mint_upload_url(project_id=, file_name=, content_type=)`
+- `register_video(project_id=, name=, file_name=|s3_key=, season=, episode=, auto_process=)`
+- `get_video(video_id)` / `list_videos(project_id=, page=, page_size=)` / `delete_video(video_id)`
+- `search_clips(project_id=, query=, page=, page_size=)`
+- `upload_video(project_id=, file=, name=, ...)` — full 3-step upload orchestration
+- `wait_for_processing(video_id, poll_interval_s=, timeout_s=)`
+
+Failed API calls raise `AimageApiError` with `code`, `message`, and HTTP
+`status` parsed from the `{"error": {"code", "message"}}` envelope.
+
+## Development
+
+```sh
+cd sdks/python
+uv sync
+uv run pytest
+uv run ruff check .
+```

aimage_sdk-0.1.0/README.md

@@ -0,0 +1,72 @@
+# aimage-sdk
+
+Python SDK for the AI-Mage Search public API (`/v0`). Python 3.12+, `httpx`
+is the only dependency.
+
+## Install
+
+The package is not yet published to PyPI. Install from the repository:
+
+```sh
+uv add "aimage-sdk @ file:///path/to/aimage-monorepo/sdks/python"
+# or: pip install /path/to/aimage-monorepo/sdks/python
+```
+
+## Quickstart
+
+```python
+import os
+
+from aimage_sdk import AimageClient
+
+client = AimageClient(
+    api_key=os.environ["AIMAGE_API_KEY"],  # "aimage_api_..."
+    base_url="https://api.search.ai-mage.jp",  # API server origin; the client calls {base_url}/v0/...
+)
+
+# Discover accessible projects.
+me = client.me()
+project_id = me["projects"][0]["id"]
+
+# Upload a video: mints a presigned URL, PUTs the bytes, registers the video.
+video = client.upload_video(
+    project_id=project_id,
+    file="./episode-01.mp4",  # str | pathlib.Path | bytes (bytes need file_name=)
+    name="Episode 1",
+    season=1,
+    episode=1,
+    on_progress=print,
+)
+
+# Wait until clip extraction and AI tagging finish.
+processed = client.wait_for_processing(video["id"], poll_interval_s=10, timeout_s=1800)
+if processed["processing_status"] == "failed":
+    raise RuntimeError(processed["processing_error"])
+
+# Search clips with a natural-language query.
+result = client.search_clips(project_id=project_id, query="two characters arguing in the rain")
+for clip in result["clips"]:
+    print(clip["start_time"], clip["subtitle"], clip["tags"], clip["characters"])
+```
+
+## API surface
+
+- `ping()` / `me()`
+- `mint_upload_url(project_id=, file_name=, content_type=)`
+- `register_video(project_id=, name=, file_name=|s3_key=, season=, episode=, auto_process=)`
+- `get_video(video_id)` / `list_videos(project_id=, page=, page_size=)` / `delete_video(video_id)`
+- `search_clips(project_id=, query=, page=, page_size=)`
+- `upload_video(project_id=, file=, name=, ...)` — full 3-step upload orchestration
+- `wait_for_processing(video_id, poll_interval_s=, timeout_s=)`
+
+Failed API calls raise `AimageApiError` with `code`, `message`, and HTTP
+`status` parsed from the `{"error": {"code", "message"}}` envelope.
+
+## Development
+
+```sh
+cd sdks/python
+uv sync
+uv run pytest
+uv run ruff check .
+```

aimage_sdk-0.1.0/pyproject.toml

@@ -0,0 +1,43 @@
+[project]
+name = "aimage-sdk"
+version = "0.1.0"
+description = "Python SDK for the AI-Mage Search public API"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "AI-Mage" }]
+requires-python = ">=3.12"
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Intended Audience :: Developers",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Typing :: Typed",
+]
+dependencies = [
+  "httpx>=0.28,<1",
+]
+
+[project.urls]
+Documentation = "https://api.search.ai-mage.jp/docs"
+Repository = "https://github.com/aimagexyz/aimage-monorepo"
+
+[dependency-groups]
+dev = [
+  "pytest>=9,<10",
+  "ruff>=0.7,<1",
+]
+
+[tool.uv]
+default-groups = ["dev"]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.ruff]
+line-length = 100
+target-version = "py312"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "B", "UP"]

aimage_sdk-0.1.0/src/aimage_sdk/__init__.py

@@ -0,0 +1,34 @@
+"""Python SDK for the AI-Mage Search public API."""
+
+from .client import AimageClient, ProgressStage
+from .errors import AimageApiError
+from .types import (
+    Clip,
+    DeleteVideoResponse,
+    MeProject,
+    MeResponse,
+    PingResponse,
+    ProcessingStatus,
+    ProjectRole,
+    SearchClipsResponse,
+    UploadUrlResponse,
+    Video,
+    VideoListResponse,
+)
+
+__all__ = [
+    "AimageApiError",
+    "AimageClient",
+    "Clip",
+    "DeleteVideoResponse",
+    "MeProject",
+    "MeResponse",
+    "PingResponse",
+    "ProcessingStatus",
+    "ProgressStage",
+    "ProjectRole",
+    "SearchClipsResponse",
+    "UploadUrlResponse",
+    "Video",
+    "VideoListResponse",
+]

aimage_sdk-0.1.0/src/aimage_sdk/client.py

@@ -0,0 +1,236 @@
+import mimetypes
+import time
+from collections.abc import Callable
+from pathlib import Path
+from typing import Any, Literal, cast
+
+import httpx
+
+from .errors import AimageApiError
+from .types import (
+    DeleteVideoResponse,
+    MeResponse,
+    PingResponse,
+    SearchClipsResponse,
+    UploadUrlResponse,
+    Video,
+    VideoListResponse,
+)
+
+ProgressStage = Literal["minting_upload_url", "uploading", "registering", "done"]
+
+
+class AimageClient:
+    """Thin client for the AI-Mage Search public API (/v0), httpx-based.
+
+    ``base_url`` is the API server origin, e.g. ``https://api.search.ai-mage.jp``;
+    the client calls ``{base_url}/v0/...``. ``transport`` exists for testing
+    with ``httpx.MockTransport``.
+    """
+
+    def __init__(
+        self,
+        api_key: str,
+        base_url: str,
+        *,
+        timeout: float = 30.0,
+        transport: httpx.BaseTransport | None = None,
+    ) -> None:
+        self._api_key = api_key
+        self._base_url = base_url.rstrip("/")
+        # No default Authorization header: presigned S3 PUTs go through the
+        # same client and S3 rejects requests carrying both auth mechanisms.
+        self._client = httpx.Client(timeout=timeout, transport=transport)
+
+    def close(self) -> None:
+        self._client.close()
+
+    def __enter__(self) -> "AimageClient":
+        return self
+
+    def __exit__(self, *exc_info: object) -> None:
+        self.close()
+
+    # -- thin endpoint wrappers ------------------------------------------------
+
+    def ping(self) -> PingResponse:
+        return cast(PingResponse, self._request("GET", "/ping"))
+
+    def me(self) -> MeResponse:
+        return cast(MeResponse, self._request("GET", "/me"))
+
+    def mint_upload_url(
+        self, *, project_id: str, file_name: str, content_type: str
+    ) -> UploadUrlResponse:
+        body = {"project_id": project_id, "file_name": file_name, "content_type": content_type}
+        return cast(UploadUrlResponse, self._request("POST", "/videos/upload-url", json=body))
+
+    def register_video(
+        self,
+        *,
+        project_id: str,
+        name: str,
+        file_name: str | None = None,
+        s3_key: str | None = None,
+        season: int | None = None,
+        episode: int | None = None,
+        auto_process: bool = True,
+    ) -> Video:
+        if (file_name is None) == (s3_key is None):
+            raise ValueError("Provide exactly one of file_name or s3_key.")
+        body: dict[str, Any] = {
+            "project_id": project_id,
+            "name": name,
+            "auto_process": auto_process,
+        }
+        if file_name is not None:
+            body["file_name"] = file_name
+        if s3_key is not None:
+            body["s3_key"] = s3_key
+        if season is not None:
+            body["season"] = season
+        if episode is not None:
+            body["episode"] = episode
+        return cast(Video, self._request("POST", "/videos", json=body))
+
+    def get_video(self, video_id: str) -> Video:
+        return cast(Video, self._request("GET", f"/videos/{video_id}"))
+
+    def list_videos(
+        self, *, project_id: str, page: int = 1, page_size: int = 20
+    ) -> VideoListResponse:
+        params = {"project_id": project_id, "page": page, "page_size": page_size}
+        return cast(VideoListResponse, self._request("GET", "/videos", params=params))
+
+    def delete_video(self, video_id: str) -> DeleteVideoResponse:
+        return cast(DeleteVideoResponse, self._request("DELETE", f"/videos/{video_id}"))
+
+    def search_clips(
+        self, *, project_id: str, query: str, page: int = 1, page_size: int = 20
+    ) -> SearchClipsResponse:
+        body = {"project_id": project_id, "query": query, "page": page, "page_size": page_size}
+        return cast(SearchClipsResponse, self._request("POST", "/search/clips", json=body))
+
+    # -- high-level orchestration ----------------------------------------------
+
+    def upload_video(
+        self,
+        *,
+        project_id: str,
+        file: str | Path | bytes,
+        name: str,
+        file_name: str | None = None,
+        content_type: str | None = None,
+        season: int | None = None,
+        episode: int | None = None,
+        auto_process: bool = True,
+        on_progress: Callable[[ProgressStage], None] | None = None,
+    ) -> Video:
+        """Full upload orchestration: mint a presigned URL, PUT the file bytes
+        with the exact Content-Type, then register the video via its s3_key.
+        """
+        if isinstance(file, bytes):
+            if file_name is None:
+                raise ValueError("file_name is required when uploading bytes.")
+            data = file
+        else:
+            path = Path(file)
+            file_name = file_name or path.name
+            data = path.read_bytes()
+
+        if content_type is None:
+            content_type, _ = mimetypes.guess_type(file_name)
+        if content_type is None:
+            raise ValueError(
+                f'Cannot infer content_type from file name "{file_name}". Pass it explicitly.'
+            )
+
+        if on_progress:
+            on_progress("minting_upload_url")
+        minted = self.mint_upload_url(
+            project_id=project_id, file_name=file_name, content_type=content_type
+        )
+
+        if on_progress:
+            on_progress("uploading")
+        upload_response = self._client.put(
+            minted["upload_url"], content=data, headers={"Content-Type": content_type}
+        )
+        if upload_response.is_error:
+            raise AimageApiError(
+                code="UPLOAD_FAILED",
+                message=f"Upload to presigned URL failed with status {upload_response.status_code}",
+                status=upload_response.status_code,
+            )
+
+        if on_progress:
+            on_progress("registering")
+        video = self.register_video(
+            project_id=project_id,
+            name=name,
+            s3_key=minted["s3_key"],
+            season=season,
+            episode=episode,
+            auto_process=auto_process,
+        )
+
+        if on_progress:
+            on_progress("done")
+        return video
+
+    def wait_for_processing(
+        self,
+        video_id: str,
+        *,
+        poll_interval_s: float = 5.0,
+        timeout_s: float = 600.0,
+    ) -> Video:
+        """Polls GET /videos/{id} until processing reaches a terminal state and
+        returns the final video — check processing_status ('completed' or
+        'failed') and processing_error yourself. Raises TimeoutError on timeout.
+        """
+        deadline = time.monotonic() + timeout_s
+        while True:
+            video = self.get_video(video_id)
+            if video["processing_status"] in ("completed", "failed"):
+                return video
+            if time.monotonic() + poll_interval_s >= deadline:
+                raise TimeoutError(
+                    f"Timed out waiting for video {video_id} to finish processing "
+                    f"after {timeout_s}s"
+                )
+            time.sleep(poll_interval_s)
+
+    # -- internals ---------------------------------------------------------------
+
+    def _request(
+        self,
+        method: str,
+        path: str,
+        *,
+        params: dict[str, Any] | None = None,
+        json: dict[str, Any] | None = None,
+    ) -> Any:
+        response = self._client.request(
+            method,
+            f"{self._base_url}/v0{path}",
+            params=params,
+            json=json,
+            headers={"Authorization": f"Bearer {self._api_key}"},
+        )
+        if response.is_error:
+            raise _to_api_error(response)
+        return response.json()
+
+
+def _to_api_error(response: httpx.Response) -> AimageApiError:
+    code = "UNKNOWN"
+    message = f"Request failed with status {response.status_code}"
+    try:
+        envelope = response.json().get("error")
+        if isinstance(envelope, dict):
+            code = str(envelope.get("code", code))
+            message = str(envelope.get("message", message))
+    except ValueError:
+        pass
+    return AimageApiError(code=code, message=message, status=response.status_code)

aimage_sdk-0.1.0/src/aimage_sdk/errors.py

@@ -0,0 +1,12 @@
+class AimageApiError(Exception):
+    """Raised when the AI-Mage Search API responds with a non-2xx status.
+
+    ``code`` and ``message`` come from the API error envelope
+    ``{"error": {"code", "message"}}``; ``status`` is the HTTP status code.
+    """
+
+    def __init__(self, code: str, message: str, status: int) -> None:
+        super().__init__(message)
+        self.code = code
+        self.message = message
+        self.status = status

aimage_sdk-0.1.0/src/aimage_sdk/types.py

@@ -0,0 +1,84 @@
+"""Wire-format types of the AI-Mage Search public API (/v0).
+
+Field names are snake_case to match the HTTP payloads exactly; the source of
+truth is packages/api-contract/src/schemas/public-api.ts in the monorepo.
+"""
+
+from typing import Literal, TypedDict
+
+ProcessingStatus = Literal["pending", "queued", "processing", "completed", "failed"]
+
+ProjectRole = Literal["viewer", "admin"]
+
+
+class Video(TypedDict):
+    id: str
+    project_id: str
+    name: str
+    season: int | None
+    episode: int | None
+    duration: int
+    width: int
+    height: int
+    processing_status: ProcessingStatus
+    processing_error: str | None
+    created_at: str
+
+
+class Clip(TypedDict):
+    clip_id: str
+    video_id: str
+    project_id: str
+    start_time: float
+    end_time: float
+    subtitle: str | None
+    similarity: float
+    thumbnail_url: str
+    episode_title: str | None
+    season: int | None
+    episode: int | None
+    tags: list[str]
+    characters: list[str]
+
+
+class UploadUrlResponse(TypedDict):
+    upload_url: str
+    s3_key: str
+    expires_at: str
+
+
+class VideoListResponse(TypedDict):
+    videos: list[Video]
+    total: int
+    page: int
+    page_size: int
+
+
+class DeleteVideoResponse(TypedDict):
+    deleted: Literal[True]
+    id: str
+
+
+class SearchClipsResponse(TypedDict):
+    clips: list[Clip]
+    total_available: int
+    page: int
+    page_size: int
+
+
+class MeProject(TypedDict):
+    id: str
+    name: str
+    role: ProjectRole
+
+
+class MeResponse(TypedDict):
+    key_name: str
+    key_preview: str
+    projects: list[MeProject]
+
+
+class PingResponse(TypedDict):
+    status: Literal["ok"]
+    version: str
+    time: str

aimage_sdk-0.1.0/tests/test_client.py

@@ -0,0 +1,222 @@
+import json
+
+import httpx
+import pytest
+
+from aimage_sdk import AimageApiError, AimageClient
+
+BASE_URL = "https://api.test"
+PROJECT_ID = "22222222-2222-2222-2222-222222222222"
+VIDEO_ID = "11111111-1111-1111-1111-111111111111"
+
+SAMPLE_VIDEO = {
+    "id": VIDEO_ID,
+    "project_id": PROJECT_ID,
+    "name": "Episode 1",
+    "season": 1,
+    "episode": 1,
+    "duration": 0,
+    "width": 0,
+    "height": 0,
+    "processing_status": "queued",
+    "processing_error": None,
+    "created_at": "2026-06-11T00:00:00.000Z",
+}
+
+
+def make_client(handler) -> AimageClient:
+    return AimageClient("aimage_api_test", BASE_URL, transport=httpx.MockTransport(handler))
+
+
+def test_sends_bearer_token_and_parses_json() -> None:
+    seen: list[httpx.Request] = []
+
+    def handler(request: httpx.Request) -> httpx.Response:
+        seen.append(request)
+        return httpx.Response(
+            200, json={"status": "ok", "version": "0.1.0", "time": "2026-06-11T00:00:00.000Z"}
+        )
+
+    with make_client(handler) as client:
+        result = client.ping()
+
+    assert result["status"] == "ok"
+    assert seen[0].url == f"{BASE_URL}/v0/ping"
+    assert seen[0].headers["authorization"] == "Bearer aimage_api_test"
+
+
+def test_list_videos_sends_query_params() -> None:
+    seen: list[httpx.Request] = []
+
+    def handler(request: httpx.Request) -> httpx.Response:
+        seen.append(request)
+        return httpx.Response(200, json={"videos": [], "total": 0, "page": 2, "page_size": 50})
+
+    with make_client(handler) as client:
+        client.list_videos(project_id=PROJECT_ID, page=2, page_size=50)
+
+    params = dict(seen[0].url.params)
+    assert seen[0].url.path == "/v0/videos"
+    assert params == {"project_id": PROJECT_ID, "page": "2", "page_size": "50"}
+
+
+def test_error_envelope_is_parsed() -> None:
+    def handler(request: httpx.Request) -> httpx.Response:
+        return httpx.Response(
+            404, json={"error": {"code": "NOT_FOUND", "message": "Video not found"}}
+        )
+
+    with make_client(handler) as client:
+        with pytest.raises(AimageApiError) as exc_info:
+            client.get_video(VIDEO_ID)
+
+    assert exc_info.value.code == "NOT_FOUND"
+    assert exc_info.value.message == "Video not found"
+    assert exc_info.value.status == 404
+
+
+def test_non_json_error_falls_back_to_unknown() -> None:
+    def handler(request: httpx.Request) -> httpx.Response:
+        return httpx.Response(500, text="oops")
+
+    with make_client(handler) as client:
+        with pytest.raises(AimageApiError) as exc_info:
+            client.ping()
+
+    assert exc_info.value.code == "UNKNOWN"
+    assert exc_info.value.status == 500
+
+
+def test_register_video_requires_exactly_one_source() -> None:
+    def handler(request: httpx.Request) -> httpx.Response:
+        raise AssertionError("no request expected")
+
+    with make_client(handler) as client:
+        with pytest.raises(ValueError):
+            client.register_video(project_id=PROJECT_ID, name="Episode 1")
+        with pytest.raises(ValueError):
+            client.register_video(
+                project_id=PROJECT_ID, name="Episode 1", file_name="a.mp4", s3_key="k"
+            )
+
+
+def test_upload_video_orchestration() -> None:
+    upload_url = "https://uploads.test/bucket/videos/abc.mp4?signature=xyz"
+    s3_key = "videos/22222222/abc.mp4"
+    seen: list[httpx.Request] = []
+
+    def handler(request: httpx.Request) -> httpx.Response:
+        seen.append(request)
+        if request.url.path == "/v0/videos/upload-url":
+            return httpx.Response(
+                200,
+                json={
+                    "upload_url": upload_url,
+                    "s3_key": s3_key,
+                    "expires_at": "2026-06-11T01:00:00.000Z",
+                },
+            )
+        if request.url.host == "uploads.test":
+            return httpx.Response(200)
+        if request.url.path == "/v0/videos":
+            return httpx.Response(200, json=SAMPLE_VIDEO)
+        raise AssertionError(f"unexpected request: {request.url}")
+
+    stages: list[str] = []
+    with make_client(handler) as client:
+        video = client.upload_video(
+            project_id=PROJECT_ID,
+            file=b"video-bytes",
+            file_name="episode-01.mp4",
+            name="Episode 1",
+            season=1,
+            episode=1,
+            on_progress=stages.append,
+        )
+
+    assert video == SAMPLE_VIDEO
+    assert stages == ["minting_upload_url", "uploading", "registering", "done"]
+    assert [str(r.url) for r in seen] == [
+        f"{BASE_URL}/v0/videos/upload-url",
+        upload_url,
+        f"{BASE_URL}/v0/videos",
+    ]
+
+    mint_body = json.loads(seen[0].content)
+    assert mint_body == {
+        "project_id": PROJECT_ID,
+        "file_name": "episode-01.mp4",
+        "content_type": "video/mp4",
+    }
+
+    put = seen[1]
+    assert put.method == "PUT"
+    assert put.headers["content-type"] == "video/mp4"
+    assert "authorization" not in put.headers
+    assert put.content == b"video-bytes"
+
+    register_body = json.loads(seen[2].content)
+    assert register_body == {
+        "project_id": PROJECT_ID,
+        "name": "Episode 1",
+        "s3_key": s3_key,
+        "season": 1,
+        "episode": 1,
+        "auto_process": True,
+    }
+
+
+def test_upload_video_raises_on_failed_put() -> None:
+    def handler(request: httpx.Request) -> httpx.Response:
+        if request.url.path == "/v0/videos/upload-url":
+            return httpx.Response(
+                200,
+                json={
+                    "upload_url": "https://uploads.test/k?sig=1",
+                    "s3_key": "k",
+                    "expires_at": "2026-06-11T01:00:00.000Z",
+                },
+            )
+        return httpx.Response(403, text="denied")
+
+    with make_client(handler) as client:
+        with pytest.raises(AimageApiError) as exc_info:
+            client.upload_video(
+                project_id=PROJECT_ID,
+                file=b"video-bytes",
+                file_name="episode-01.mp4",
+                name="Episode 1",
+            )
+
+    assert exc_info.value.code == "UPLOAD_FAILED"
+    assert exc_info.value.status == 403
+
+
+def test_upload_video_requires_file_name_for_bytes() -> None:
+    def handler(request: httpx.Request) -> httpx.Response:
+        raise AssertionError("no request expected")
+
+    with make_client(handler) as client:
+        with pytest.raises(ValueError):
+            client.upload_video(project_id=PROJECT_ID, file=b"x", name="Episode 1")
+
+
+def test_wait_for_processing_polls_until_terminal() -> None:
+    statuses = iter(["processing", "processing", "completed"])
+
+    def handler(request: httpx.Request) -> httpx.Response:
+        return httpx.Response(200, json={**SAMPLE_VIDEO, "processing_status": next(statuses)})
+
+    with make_client(handler) as client:
+        video = client.wait_for_processing(VIDEO_ID, poll_interval_s=0)
+
+    assert video["processing_status"] == "completed"
+
+
+def test_wait_for_processing_times_out() -> None:
+    def handler(request: httpx.Request) -> httpx.Response:
+        return httpx.Response(200, json={**SAMPLE_VIDEO, "processing_status": "processing"})
+
+    with make_client(handler) as client:
+        with pytest.raises(TimeoutError):
+            client.wait_for_processing(VIDEO_ID, poll_interval_s=0, timeout_s=0)

aimage_sdk-0.1.0/uv.lock

@@ -0,0 +1,189 @@
+version = 1
+revision = 3
+requires-python = ">=3.12"
+
+[[package]]
+name = "aimage-sdk"
+version = "0.1.0"
+source = { editable = "." }
+dependencies = [
+    { name = "httpx" },
+]
+
+[package.dev-dependencies]
+dev = [
+    { name = "pytest" },
+    { name = "ruff" },
+]
+
+[package.metadata]
+requires-dist = [{ name = "httpx", specifier = ">=0.28,<1" }]
+
+[package.metadata.requires-dev]
+dev = [
+    { name = "pytest", specifier = ">=9,<10" },
+    { name = "ruff", specifier = ">=0.7,<1" },
+]
+
+[[package]]
+name = "anyio"
+version = "4.13.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "idna" },
+    { name = "typing-extensions", marker = "python_full_version < '3.13'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/19/14/2c5dd9f512b66549ae92767a9c7b330ae88e1932ca57876909410251fe13/anyio-4.13.0.tar.gz", hash = "sha256:334b70e641fd2221c1505b3890c69882fe4a2df910cba14d97019b90b24439dc", size = 231622, upload-time = "2026-03-24T12:59:09.671Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/da/42/e921fccf5015463e32a3cf6ee7f980a6ed0f395ceeaa45060b61d86486c2/anyio-4.13.0-py3-none-any.whl", hash = "sha256:08b310f9e24a9594186fd75b4f73f4a4152069e3853f1ed8bfbf58369f4ad708", size = 114353, upload-time = "2026-03-24T12:59:08.246Z" },
+]
+
+[[package]]
+name = "certifi"
+version = "2026.5.20"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/f3/ce/ee2ecad540810a79593028e88299baeae54d346cc7a0d94b6199988b89b1/certifi-2026.5.20.tar.gz", hash = "sha256:69dea482ab64caa7b9f6aba1c6bf48bb6a5448d1c0f1b17ab42ad8c763a5344d", size = 135422, upload-time = "2026-05-20T11:46:50.073Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/59/8c/57e832b7af6d7c5abe66eb3fbe3a3a32f4d11ea23a1aa7131371035be991/certifi-2026.5.20-py3-none-any.whl", hash = "sha256:3c52e209ba0a4ad7aebe60436a4ab349c39e1e602e8c134221e546902ad25897", size = 134134, upload-time = "2026-05-20T11:46:48.578Z" },
+]
+
+[[package]]
+name = "colorama"
+version = "0.4.6"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/d8/53/6f443c9a4a8358a93a6792e2acffb9d9d5cb0a5cfd8802644b7b1c9a02e4/colorama-0.4.6.tar.gz", hash = "sha256:08695f5cb7ed6e0531a20572697297273c47b8cae5a63ffc6d6ed5c201be6e44", size = 27697, upload-time = "2022-10-25T02:36:22.414Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/d1/d6/3965ed04c63042e047cb6a3e6ed1a63a35087b6a609aa3a15ed8ac56c221/colorama-0.4.6-py2.py3-none-any.whl", hash = "sha256:4f1d9991f5acc0ca119f9d443620b77f9d6b33703e51011c16baf57afb285fc6", size = 25335, upload-time = "2022-10-25T02:36:20.889Z" },
+]
+
+[[package]]
+name = "h11"
+version = "0.16.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/01/ee/02a2c011bdab74c6fb3c75474d40b3052059d95df7e73351460c8588d963/h11-0.16.0.tar.gz", hash = "sha256:4e35b956cf45792e4caa5885e69fba00bdbc6ffafbfa020300e549b208ee5ff1", size = 101250, upload-time = "2025-04-24T03:35:25.427Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/04/4b/29cac41a4d98d144bf5f6d33995617b185d14b22401f75ca86f384e87ff1/h11-0.16.0-py3-none-any.whl", hash = "sha256:63cf8bbe7522de3bf65932fda1d9c2772064ffb3dae62d55932da54b31cb6c86", size = 37515, upload-time = "2025-04-24T03:35:24.344Z" },
+]
+
+[[package]]
+name = "httpcore"
+version = "1.0.9"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "certifi" },
+    { name = "h11" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/06/94/82699a10bca87a5556c9c59b5963f2d039dbd239f25bc2a63907a05a14cb/httpcore-1.0.9.tar.gz", hash = "sha256:6e34463af53fd2ab5d807f399a9b45ea31c3dfa2276f15a2c3f00afff6e176e8", size = 85484, upload-time = "2025-04-24T22:06:22.219Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/7e/f5/f66802a942d491edb555dd61e3a9961140fd64c90bce1eafd741609d334d/httpcore-1.0.9-py3-none-any.whl", hash = "sha256:2d400746a40668fc9dec9810239072b40b4484b640a8c38fd654a024c7a1bf55", size = 78784, upload-time = "2025-04-24T22:06:20.566Z" },
+]
+
+[[package]]
+name = "httpx"
+version = "0.28.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "anyio" },
+    { name = "certifi" },
+    { name = "httpcore" },
+    { name = "idna" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/b1/df/48c586a5fe32a0f01324ee087459e112ebb7224f646c0b5023f5e79e9956/httpx-0.28.1.tar.gz", hash = "sha256:75e98c5f16b0f35b567856f597f06ff2270a374470a5c2392242528e3e3e42fc", size = 141406, upload-time = "2024-12-06T15:37:23.222Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/2a/39/e50c7c3a983047577ee07d2a9e53faf5a69493943ec3f6a384bdc792deb2/httpx-0.28.1-py3-none-any.whl", hash = "sha256:d909fcccc110f8c7faf814ca82a9a4d816bc5a6dbfea25d6591d6985b8ba59ad", size = 73517, upload-time = "2024-12-06T15:37:21.509Z" },
+]
+
+[[package]]
+name = "idna"
+version = "3.18"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/cd/63/9496c57188a2ee585e0f1db071d75089a11e98aa86eb99d9d7618fc1edce/idna-3.18.tar.gz", hash = "sha256:ffb385a7e039654cef1ab9ef32c6fafe283c0c0467bba1d9029738ce4a14a848", size = 196711, upload-time = "2026-06-02T14:34:07.794Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/1e/5e/d4e9f1a599fb8e573b7b87160658329fbf28d19eac2718f51fc3def3aa5a/idna-3.18-py3-none-any.whl", hash = "sha256:7f952cbe720b688055e3f87de14f5c3e5fdaa8bc3928985c4077ca689de849a2", size = 65455, upload-time = "2026-06-02T14:34:06.319Z" },
+]
+
+[[package]]
+name = "iniconfig"
+version = "2.3.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/72/34/14ca021ce8e5dfedc35312d08ba8bf51fdd999c576889fc2c24cb97f4f10/iniconfig-2.3.0.tar.gz", hash = "sha256:c76315c77db068650d49c5b56314774a7804df16fee4402c1f19d6d15d8c4730", size = 20503, upload-time = "2025-10-18T21:55:43.219Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/cb/b1/3846dd7f199d53cb17f49cba7e651e9ce294d8497c8c150530ed11865bb8/iniconfig-2.3.0-py3-none-any.whl", hash = "sha256:f631c04d2c48c52b84d0d0549c99ff3859c98df65b3101406327ecc7d53fbf12", size = 7484, upload-time = "2025-10-18T21:55:41.639Z" },
+]
+
+[[package]]
+name = "packaging"
+version = "26.2"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/d7/f1/e7a6dd94a8d4a5626c03e4e99c87f241ba9e350cd9e6d75123f992427270/packaging-26.2.tar.gz", hash = "sha256:ff452ff5a3e828ce110190feff1178bb1f2ea2281fa2075aadb987c2fb221661", size = 228134, upload-time = "2026-04-24T20:15:23.917Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/df/b2/87e62e8c3e2f4b32e5fe99e0b86d576da1312593b39f47d8ceef365e95ed/packaging-26.2-py3-none-any.whl", hash = "sha256:5fc45236b9446107ff2415ce77c807cee2862cb6fac22b8a73826d0693b0980e", size = 100195, upload-time = "2026-04-24T20:15:22.081Z" },
+]
+
+[[package]]
+name = "pluggy"
+version = "1.6.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/f9/e2/3e91f31a7d2b083fe6ef3fa267035b518369d9511ffab804f839851d2779/pluggy-1.6.0.tar.gz", hash = "sha256:7dcc130b76258d33b90f61b658791dede3486c3e6bfb003ee5c9bfb396dd22f3", size = 69412, upload-time = "2025-05-15T12:30:07.975Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/54/20/4d324d65cc6d9205fabedc306948156824eb9f0ee1633355a8f7ec5c66bf/pluggy-1.6.0-py3-none-any.whl", hash = "sha256:e920276dd6813095e9377c0bc5566d94c932c33b27a3e3945d8389c374dd4746", size = 20538, upload-time = "2025-05-15T12:30:06.134Z" },
+]
+
+[[package]]
+name = "pygments"
+version = "2.20.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/c3/b2/bc9c9196916376152d655522fdcebac55e66de6603a76a02bca1b6414f6c/pygments-2.20.0.tar.gz", hash = "sha256:6757cd03768053ff99f3039c1a36d6c0aa0b263438fcab17520b30a303a82b5f", size = 4955991, upload-time = "2026-03-29T13:29:33.898Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/f4/7e/a72dd26f3b0f4f2bf1dd8923c85f7ceb43172af56d63c7383eb62b332364/pygments-2.20.0-py3-none-any.whl", hash = "sha256:81a9e26dd42fd28a23a2d169d86d7ac03b46e2f8b59ed4698fb4785f946d0176", size = 1231151, upload-time = "2026-03-29T13:29:30.038Z" },
+]
+
+[[package]]
+name = "pytest"
+version = "9.0.3"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "colorama", marker = "sys_platform == 'win32'" },
+    { name = "iniconfig" },
+    { name = "packaging" },
+    { name = "pluggy" },
+    { name = "pygments" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/7d/0d/549bd94f1a0a402dc8cf64563a117c0f3765662e2e668477624baeec44d5/pytest-9.0.3.tar.gz", hash = "sha256:b86ada508af81d19edeb213c681b1d48246c1a91d304c6c81a427674c17eb91c", size = 1572165, upload-time = "2026-04-07T17:16:18.027Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/d4/24/a372aaf5c9b7208e7112038812994107bc65a84cd00e0354a88c2c77a617/pytest-9.0.3-py3-none-any.whl", hash = "sha256:2c5efc453d45394fdd706ade797c0a81091eccd1d6e4bccfcd476e2b8e0ab5d9", size = 375249, upload-time = "2026-04-07T17:16:16.13Z" },
+]
+
+[[package]]
+name = "ruff"
+version = "0.15.16"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/a6/bd/5f7ec371001337d8fa61701c186ff8b613ecac1651848c5950f4c4d5f2e9/ruff-0.15.16.tar.gz", hash = "sha256:d05e78d38c78caf020b03789e25106c93017db5a0cb6e2819885018c61343b78", size = 4714267, upload-time = "2026-06-04T16:33:09.974Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/0c/42/53ef1c3953f157956db9bf7861e3bc50b9b887ce93300aa48cdba8336fe6/ruff-0.15.16-py3-none-linux_armv6l.whl", hash = "sha256:6ac3c0b3969cc6cf6b158c4e2f8f682acb58e7d700d8a44b65ecdc72d66ab0b2", size = 10709025, upload-time = "2026-06-04T16:32:51.935Z" },
+    { url = "https://files.pythonhosted.org/packages/93/9a/a79159346f19134a956607754e57d8d128f7a4c00f4ad2f7514d224c172c/ruff-0.15.16-py3-none-macosx_10_12_x86_64.whl", hash = "sha256:197c207ed75ffba54a0dec23db4aa939a27a3053073e085e0042433cbdc58e4a", size = 11063550, upload-time = "2026-06-04T16:32:42.24Z" },
+    { url = "https://files.pythonhosted.org/packages/bc/72/3ce2ac000a5299ec238e01f51397b3b653c93b077d9b1bfe8715bb895f20/ruff-0.15.16-py3-none-macosx_11_0_arm64.whl", hash = "sha256:3a39fec45ab316cc23e7558f23fea4a70403ddb5648ea9a4a3854a16973d0071", size = 10421345, upload-time = "2026-06-04T16:32:37.251Z" },
+    { url = "https://files.pythonhosted.org/packages/b0/c2/cc7fad3ec9169373f5b6a18f1917b91080feec40c3f9658334a1d28e2f03/ruff-0.15.16-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:ba93191d79003116b95128c9d306e045200fdbd0bccb782b110f3cd1d4abc5cf", size = 10757217, upload-time = "2026-06-04T16:32:54.722Z" },
+    { url = "https://files.pythonhosted.org/packages/69/d2/3474009eaa0a65b31fa7152a2fad5e2f050c640ceb1e6b02ee6922e94c82/ruff-0.15.16-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:c6ee4b90520630120ef032aa5cc10db483852dff950e78b1d717e2993a61ac8d", size = 10507035, upload-time = "2026-06-04T16:33:05.343Z" },
+    { url = "https://files.pythonhosted.org/packages/ca/81/b7ae6ccbd11f0c8dc3d5d67fc4be9b57ff57ca86ba56152021378e1277f2/ruff-0.15.16-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:4e4215bc938bc3c8215c1472c1aa437e310fee20cd427335fec9d7e609563628", size = 11255291, upload-time = "2026-06-04T16:32:49.49Z" },
+    { url = "https://files.pythonhosted.org/packages/d9/e1/46e526f1a7cc90857ce6ddf25fbb77eb6568651ac38d71b033af07076dd5/ruff-0.15.16-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:7c8d26be963b090f10e29abc8b3e74a2a321f6fa34e02424e30b5af89350ecbb", size = 12124922, upload-time = "2026-06-04T16:33:07.821Z" },
+    { url = "https://files.pythonhosted.org/packages/1a/da/5c791b088b596b24d0deb967fa28ae02ad751a140c0b9ea81c5ab915d6c0/ruff-0.15.16-py3-none-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:f198cf4123602a2280ed46c307bcbafe41758d6fee5b456b6b6058ca1514b3b4", size = 11332186, upload-time = "2026-06-04T16:33:02.971Z" },
+    { url = "https://files.pythonhosted.org/packages/72/11/5da87abe20047c8962361473923ebb2f62b595250126aadfad8c20649c1e/ruff-0.15.16-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:bb27515fa6240fb586ae82b901a59e67d24acff86f2190b433dc542fe0435aeb", size = 11373541, upload-time = "2026-06-04T16:32:47.007Z" },
+    { url = "https://files.pythonhosted.org/packages/fe/2a/8554754c23a854ae3fd6b507e36ad61ddb121e298c6d5d617dec94ed0f14/ruff-0.15.16-py3-none-manylinux_2_31_riscv64.whl", hash = "sha256:a267c46ba1593fc26b8eecbea050b39d40c0b6bb7781ee11c90a02cd10032951", size = 11353014, upload-time = "2026-06-04T16:32:34.795Z" },
+    { url = "https://files.pythonhosted.org/packages/62/25/62ea41529ec89f742ea3fed9cb1059c72877ec7cf9b9e99ac9cf3294d1d9/ruff-0.15.16-py3-none-musllinux_1_2_aarch64.whl", hash = "sha256:528c68f39a91498a8d50e91ff5985df3d105782bab49cc378e73ac26bff083e8", size = 10737467, upload-time = "2026-06-04T16:32:26.348Z" },
+    { url = "https://files.pythonhosted.org/packages/90/17/334d3ad9de4d40f9dd58fdd09e35ce64553bb501e2f19a839e2fb6be14fc/ruff-0.15.16-py3-none-musllinux_1_2_armv7l.whl", hash = "sha256:7ed55c58950df60589a9a7a5d2f8fa5f54ebd287163be805adfe6ee95a9de123", size = 10521910, upload-time = "2026-06-04T16:32:32.54Z" },
+    { url = "https://files.pythonhosted.org/packages/4d/bd/3ac7c6ae77a885c1004b3dda2446ea401768d24f851c14b4ad4b24f6639c/ruff-0.15.16-py3-none-musllinux_1_2_i686.whl", hash = "sha256:d482feaf51512b50f9790ceb417a56a61dd1e9d9bf967662b9ed27c01b34f53a", size = 10979190, upload-time = "2026-06-04T16:32:57.492Z" },
+    { url = "https://files.pythonhosted.org/packages/33/d7/609546e6a413c3f216fbf2a50c928f97c80939154f6a0503114094a86191/ruff-0.15.16-py3-none-musllinux_1_2_x86_64.whl", hash = "sha256:1e15bc8c94513dae2a40cc9ef07c94fdd4ecc9e29dabebeebe170f952322c9e3", size = 11477014, upload-time = "2026-06-04T16:32:44.687Z" },
+    { url = "https://files.pythonhosted.org/packages/74/0d/f2cd247ad32633a5c36e97141a2c21b11c6279f7957bc2ff360b1e08fddd/ruff-0.15.16-py3-none-win32.whl", hash = "sha256:580378f7bd4aa25f72e74aa54948a9622f142b1e509521dd10902e886681cc1e", size = 10735541, upload-time = "2026-06-04T16:32:30.145Z" },
+    { url = "https://files.pythonhosted.org/packages/8b/9e/02e845ef151b1dee585e55c4739f8e1734ae1d9f1221dff65761c162208b/ruff-0.15.16-py3-none-win_amd64.whl", hash = "sha256:408256017284eddf98fff77b29aa4fb30f586042d535b2d9befc6512f400aaec", size = 11843403, upload-time = "2026-06-04T16:32:39.76Z" },
+    { url = "https://files.pythonhosted.org/packages/15/19/016553f86f207450aebebc2b2b5088d086b901cc8186c02ac4284db3bd88/ruff-0.15.16-py3-none-win_arm64.whl", hash = "sha256:8cd61783afb39638a7133ef0d2dfb1e91277593962f81b5a8423eb0b888a6121", size = 11134555, upload-time = "2026-06-04T16:33:00.136Z" },
+]
+
+[[package]]
+name = "typing-extensions"
+version = "4.15.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/72/94/1a15dd82efb362ac84269196e94cf00f187f7ed21c242792a923cdb1c61f/typing_extensions-4.15.0.tar.gz", hash = "sha256:0cea48d173cc12fa28ecabc3b837ea3cf6f38c6d1136f85cbaaf598984861466", size = 109391, upload-time = "2025-08-25T13:49:26.313Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/18/67/36e9267722cc04a6b9f15c7f3441c2363321a3ea07da7ae0c0707beb2a9c/typing_extensions-4.15.0-py3-none-any.whl", hash = "sha256:f0fa19c6845758ab08074a0cfa8b7aecb71c999ca73d62883bc25cc018c4e548", size = 44614, upload-time = "2025-08-25T13:49:24.86Z" },
+]