orbsim-sdk 0.1.0__tar.gz

orbsim_sdk-0.1.0/PKG-INFO

@@ -0,0 +1,61 @@
+Metadata-Version: 2.4
+Name: orbsim-sdk
+Version: 0.1.0
+Summary: Python SDK for the OrbSim API
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: pydantic>=2.8.0
+
+# OrbSim SDK
+
+Typed Python client for the OrbSim API.
+
+## Install
+
+```bash
+pip install /path/to/orbsim/sdk
+```
+
+## Quick Start
+
+```python
+from orbsim_sdk import OrbitSource, OrbsimClient, SatelliteCreate, TLEDefinition
+
+client = OrbsimClient("http://127.0.0.1:8000/api")
+auth = client.login("admin@example.com", "supersecret123", token_name="SDK Session")
+projects = client.list_projects()
+
+satellite = client.create_satellite(
+    projects[0].id,
+    SatelliteCreate(
+        name="ISS Copy",
+        source=OrbitSource.TLE,
+        tle=TLEDefinition(
+            line1="1 25544U 98067A   26099.50000000  .00016717  00000+0  30747-3 0  9991",
+            line2="2 25544  51.6400  54.1200 0003870 123.4567 321.6543 15.50000000123456",
+        ),
+    ),
+)
+
+state = client.get_satellite_state(projects[0].id, satellite.id, "2026-04-09T12:00:00Z")
+print(state.latitude_deg, state.longitude_deg, state.altitude_m)
+```
+
+## Async Quick Start
+
+```python
+import asyncio
+
+from orbsim_sdk import AsyncOrbsimClient
+
+
+async def main():
+    async with AsyncOrbsimClient("http://127.0.0.1:8000/api") as client:
+        await client.login("admin@example.com", "supersecret123", token_name="Async SDK Session")
+        projects = await client.list_projects()
+        print([project.name for project in projects])
+
+
+asyncio.run(main())
+```

orbsim_sdk-0.1.0/README.md

@@ -0,0 +1,52 @@
+# OrbSim SDK
+
+Typed Python client for the OrbSim API.
+
+## Install
+
+```bash
+pip install /path/to/orbsim/sdk
+```
+
+## Quick Start
+
+```python
+from orbsim_sdk import OrbitSource, OrbsimClient, SatelliteCreate, TLEDefinition
+
+client = OrbsimClient("http://127.0.0.1:8000/api")
+auth = client.login("admin@example.com", "supersecret123", token_name="SDK Session")
+projects = client.list_projects()
+
+satellite = client.create_satellite(
+    projects[0].id,
+    SatelliteCreate(
+        name="ISS Copy",
+        source=OrbitSource.TLE,
+        tle=TLEDefinition(
+            line1="1 25544U 98067A   26099.50000000  .00016717  00000+0  30747-3 0  9991",
+            line2="2 25544  51.6400  54.1200 0003870 123.4567 321.6543 15.50000000123456",
+        ),
+    ),
+)
+
+state = client.get_satellite_state(projects[0].id, satellite.id, "2026-04-09T12:00:00Z")
+print(state.latitude_deg, state.longitude_deg, state.altitude_m)
+```
+
+## Async Quick Start
+
+```python
+import asyncio
+
+from orbsim_sdk import AsyncOrbsimClient
+
+
+async def main():
+    async with AsyncOrbsimClient("http://127.0.0.1:8000/api") as client:
+        await client.login("admin@example.com", "supersecret123", token_name="Async SDK Session")
+        projects = await client.list_projects()
+        print([project.name for project in projects])
+
+
+asyncio.run(main())
+```

orbsim_sdk-0.1.0/pyproject.toml

@@ -0,0 +1,20 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "orbsim-sdk"
+version = "0.1.0"
+description = "Python SDK for the OrbSim API"
+readme = "README.md"
+requires-python = ">=3.11"
+dependencies = [
+  "httpx>=0.27.0",
+  "pydantic>=2.8.0",
+]
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]

orbsim_sdk-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

orbsim_sdk-0.1.0/src/orbsim_sdk/__init__.py

@@ -0,0 +1,93 @@
+from .client import AsyncOrbsimClient, OrbsimClient
+from .exceptions import OrbsimAPIError, OrbsimSDKError
+from .models import (
+    AdminDashboard,
+    AdminProjectInfo,
+    AnomalyKind,
+    AttitudeMode,
+    AttitudeSample,
+    AuthTokenResponse,
+    BootstrapAdminRequest,
+    CartesianState,
+    Constellation,
+    ConstellationCreate,
+    ConstellationDesignCreate,
+    ConstellationDesignResponse,
+    ConstellationDesignType,
+    ContactInterval,
+    GroundStation,
+    GroundStationCreate,
+    HealthResponse,
+    KeplerianDefinition,
+    LinkBudgetRequest,
+    LinkBudgetResponse,
+    LinkKind,
+    LoginRequest,
+    NetworkResponse,
+    OrbitalStateResponse,
+    OrbitSource,
+    Project,
+    ProjectCreate,
+    PublicContactQuery,
+    PublicSatelliteQuery,
+    PublicTLE,
+    RegisterRequest,
+    Satellite,
+    SatelliteCreate,
+    SatelliteSubsystemState,
+    TLEDefinition,
+    TimeRangeQuery,
+    TokenCreateRequest,
+    TokenCreateResponse,
+    TokenInfo,
+    UserProfile,
+    WalkerDeltaDefinition,
+)
+
+__all__ = [
+    "AdminDashboard",
+    "AdminProjectInfo",
+    "AnomalyKind",
+    "AttitudeMode",
+    "AttitudeSample",
+    "AuthTokenResponse",
+    "BootstrapAdminRequest",
+    "CartesianState",
+    "Constellation",
+    "ConstellationCreate",
+    "ConstellationDesignCreate",
+    "ConstellationDesignResponse",
+    "ConstellationDesignType",
+    "ContactInterval",
+    "GroundStation",
+    "GroundStationCreate",
+    "HealthResponse",
+    "KeplerianDefinition",
+    "LinkBudgetRequest",
+    "LinkBudgetResponse",
+    "LinkKind",
+    "LoginRequest",
+    "NetworkResponse",
+    "OrbitalStateResponse",
+    "OrbitSource",
+    "AsyncOrbsimClient",
+    "OrbsimAPIError",
+    "OrbsimClient",
+    "OrbsimSDKError",
+    "Project",
+    "ProjectCreate",
+    "PublicContactQuery",
+    "PublicSatelliteQuery",
+    "PublicTLE",
+    "RegisterRequest",
+    "Satellite",
+    "SatelliteCreate",
+    "SatelliteSubsystemState",
+    "TLEDefinition",
+    "TimeRangeQuery",
+    "TokenCreateRequest",
+    "TokenCreateResponse",
+    "TokenInfo",
+    "UserProfile",
+    "WalkerDeltaDefinition",
+]

orbsim_sdk-0.1.0/src/orbsim_sdk/client.py

@@ -0,0 +1,393 @@
+from __future__ import annotations
+
+from datetime import datetime
+from typing import Any, TypeVar
+
+import httpx
+from pydantic import BaseModel
+
+from .exceptions import OrbsimAPIError
+from .models import (
+    AdminDashboard,
+    AdminProjectInfo,
+    AttitudeSample,
+    AuthTokenResponse,
+    BootstrapAdminRequest,
+    Constellation,
+    ConstellationCreate,
+    ConstellationDesignCreate,
+    ConstellationDesignResponse,
+    ContactInterval,
+    GroundStation,
+    GroundStationCreate,
+    HealthResponse,
+    LinkBudgetRequest,
+    LinkBudgetResponse,
+    LoginRequest,
+    NetworkResponse,
+    OrbitalStateResponse,
+    Project,
+    ProjectCreate,
+    PublicContactQuery,
+    PublicSatelliteQuery,
+    PublicTLE,
+    RegisterRequest,
+    Satellite,
+    SatelliteCreate,
+    SatelliteSubsystemState,
+    TimeRangeQuery,
+    TokenCreateRequest,
+    TokenCreateResponse,
+    TokenInfo,
+    UserProfile,
+)
+
+ModelT = TypeVar("ModelT", bound=BaseModel)
+
+
+class _OrbsimClientBase:
+    def _model(self, model_type: type[ModelT], data: Any) -> ModelT:
+        return model_type.model_validate(data)
+
+    def _models(self, model_type: type[ModelT], data: list[Any]) -> list[ModelT]:
+        return [self._model(model_type, item) for item in data]
+
+
+class OrbsimClient(_OrbsimClientBase):
+    def __init__(
+        self,
+        base_url: str,
+        token: str | None = None,
+        timeout: float = 30.0,
+        client: httpx.Client | None = None,
+    ) -> None:
+        self.base_url = base_url.rstrip("/")
+        self._client = client or httpx.Client(base_url=self.base_url, timeout=timeout)
+        self._owns_client = client is None
+        if token:
+            self.set_token(token)
+
+    def close(self) -> None:
+        if self._owns_client:
+            self._client.close()
+
+    def __enter__(self) -> "OrbsimClient":
+        return self
+
+    def __exit__(self, exc_type, exc, tb) -> None:
+        self.close()
+
+    @property
+    def token(self) -> str | None:
+        auth = self._client.headers.get("Authorization", "")
+        if auth.startswith("Bearer "):
+            return auth.removeprefix("Bearer ")
+        return None
+
+    def set_token(self, token: str | None) -> None:
+        if token:
+            self._client.headers["Authorization"] = f"Bearer {token}"
+        else:
+            self._client.headers.pop("Authorization", None)
+
+    def _request(self, method: str, path: str, *, params: dict[str, Any] | None = None, payload: BaseModel | dict[str, Any] | None = None) -> Any:
+        json_payload: dict[str, Any] | None = None
+        if payload is not None:
+            json_payload = payload.model_dump(mode="json", exclude_none=True) if isinstance(payload, BaseModel) else payload
+        response = self._client.request(method, path, params=params, json=json_payload)
+        if response.is_error:
+            try:
+                detail = response.json().get("detail", response.text)
+            except Exception:
+                detail = response.text
+            raise OrbsimAPIError(response.status_code, detail)
+        if not response.content:
+            return None
+        return response.json()
+
+    def bootstrap_admin(self, email: str, password: str, full_name: str) -> AuthTokenResponse:
+        result = self._model(AuthTokenResponse, self._request("POST", "/auth/bootstrap-admin", payload=BootstrapAdminRequest(email=email, password=password, full_name=full_name)))
+        self.set_token(result.token)
+        return result
+
+    def register(self, email: str, password: str, full_name: str) -> AuthTokenResponse:
+        result = self._model(AuthTokenResponse, self._request("POST", "/auth/register", payload=RegisterRequest(email=email, password=password, full_name=full_name)))
+        self.set_token(result.token)
+        return result
+
+    def login(self, email: str, password: str, token_name: str = "Default API Token") -> AuthTokenResponse:
+        result = self._model(AuthTokenResponse, self._request("POST", "/auth/login", payload=LoginRequest(email=email, password=password, token_name=token_name)))
+        self.set_token(result.token)
+        return result
+
+    def me(self) -> UserProfile:
+        return self._model(UserProfile, self._request("GET", "/auth/me"))
+
+    def list_tokens(self) -> list[TokenInfo]:
+        return self._models(TokenInfo, self._request("GET", "/auth/tokens"))
+
+    def create_token(self, name: str) -> TokenCreateResponse:
+        return self._model(TokenCreateResponse, self._request("POST", "/auth/tokens", payload=TokenCreateRequest(name=name)))
+
+    def revoke_own_token(self, token_id: str) -> TokenInfo:
+        return self._model(TokenInfo, self._request("DELETE", f"/auth/tokens/{token_id}"))
+
+    def health(self) -> HealthResponse:
+        return self._model(HealthResponse, self._request("GET", "/health"))
+
+    def get_public_tle(self, query: PublicSatelliteQuery) -> PublicTLE:
+        return self._model(PublicTLE, self._request("POST", "/public/tle", payload=query))
+
+    def get_public_state(self, query: PublicSatelliteQuery, timestamp: datetime | str) -> OrbitalStateResponse:
+        return self._model(OrbitalStateResponse, self._request("POST", "/public/state", params={"timestamp": timestamp}, payload=query))
+
+    def get_public_contacts(self, query: PublicContactQuery) -> list[ContactInterval]:
+        return self._models(ContactInterval, self._request("POST", "/public/contacts", payload=query))
+
+    def create_project(self, payload: ProjectCreate) -> Project:
+        return self._model(Project, self._request("POST", "/projects", payload=payload))
+
+    def list_projects(self) -> list[Project]:
+        return self._models(Project, self._request("GET", "/projects"))
+
+    def delete_project(self, project_id: str) -> Project:
+        return self._model(Project, self._request("DELETE", f"/projects/{project_id}"))
+
+    def create_satellite(self, project_id: str, payload: SatelliteCreate) -> Satellite:
+        return self._model(Satellite, self._request("POST", f"/projects/{project_id}/satellites", payload=payload))
+
+    def list_satellites(self, project_id: str) -> list[Satellite]:
+        return self._models(Satellite, self._request("GET", f"/projects/{project_id}/satellites"))
+
+    def delete_satellite(self, project_id: str, satellite_id: str) -> Satellite:
+        return self._model(Satellite, self._request("DELETE", f"/projects/{project_id}/satellites/{satellite_id}"))
+
+    def create_groundstation(self, project_id: str, payload: GroundStationCreate) -> GroundStation:
+        return self._model(GroundStation, self._request("POST", f"/projects/{project_id}/groundstations", payload=payload))
+
+    def list_groundstations(self, project_id: str) -> list[GroundStation]:
+        return self._models(GroundStation, self._request("GET", f"/projects/{project_id}/groundstations"))
+
+    def delete_groundstation(self, project_id: str, groundstation_id: str) -> GroundStation:
+        return self._model(GroundStation, self._request("DELETE", f"/projects/{project_id}/groundstations/{groundstation_id}"))
+
+    def get_satellite_state(self, project_id: str, satellite_id: str, timestamp: datetime | str) -> OrbitalStateResponse:
+        return self._model(OrbitalStateResponse, self._request("POST", f"/projects/{project_id}/satellites/{satellite_id}/state", params={"timestamp": timestamp}))
+
+    def get_satellite_states(self, project_id: str, satellite_id: str, payload: TimeRangeQuery) -> list[OrbitalStateResponse]:
+        return self._models(OrbitalStateResponse, self._request("POST", f"/projects/{project_id}/satellites/{satellite_id}/states", payload=payload))
+
+    def get_satellite_attitude(self, project_id: str, satellite_id: str, timestamp: datetime | str) -> AttitudeSample:
+        return self._model(AttitudeSample, self._request("POST", f"/projects/{project_id}/satellites/{satellite_id}/attitude", params={"timestamp": timestamp}))
+
+    def get_satellite_subsystems(self, project_id: str, satellite_id: str, timestamp: datetime | str) -> SatelliteSubsystemState:
+        return self._model(SatelliteSubsystemState, self._request("POST", f"/projects/{project_id}/satellites/{satellite_id}/subsystems", params={"timestamp": timestamp}))
+
+    def get_contacts(self, project_id: str, satellite_id: str, groundstation_id: str, payload: TimeRangeQuery) -> list[ContactInterval]:
+        return self._models(ContactInterval, self._request("POST", f"/projects/{project_id}/contacts/{satellite_id}/{groundstation_id}", payload=payload))
+
+    def get_link_budget(self, project_id: str, payload: LinkBudgetRequest) -> LinkBudgetResponse:
+        return self._model(LinkBudgetResponse, self._request("POST", f"/projects/{project_id}/links/budget", payload=payload))
+
+    def create_constellation(self, project_id: str, payload: ConstellationCreate) -> Constellation:
+        return self._model(Constellation, self._request("POST", f"/projects/{project_id}/constellations", payload=payload))
+
+    def design_constellation(self, project_id: str, payload: ConstellationDesignCreate) -> ConstellationDesignResponse:
+        return self._model(ConstellationDesignResponse, self._request("POST", f"/projects/{project_id}/constellations/design", payload=payload))
+
+    def list_constellations(self, project_id: str) -> list[Constellation]:
+        return self._models(Constellation, self._request("GET", f"/projects/{project_id}/constellations"))
+
+    def delete_constellation(self, project_id: str, constellation_id: str) -> Constellation:
+        return self._model(Constellation, self._request("DELETE", f"/projects/{project_id}/constellations/{constellation_id}"))
+
+    def get_constellation_network(self, project_id: str, constellation_id: str, timestamp: datetime | str, kind: str = "rf") -> NetworkResponse:
+        return self._model(NetworkResponse, self._request("POST", f"/projects/{project_id}/constellations/{constellation_id}/network", params={"timestamp": timestamp, "kind": kind}))
+
+    def admin_dashboard(self) -> AdminDashboard:
+        return self._model(AdminDashboard, self._request("GET", "/admin/dashboard"))
+
+    def admin_list_users(self) -> list[UserProfile]:
+        return self._models(UserProfile, self._request("GET", "/admin/users"))
+
+    def admin_list_projects(self) -> list[AdminProjectInfo]:
+        return self._models(AdminProjectInfo, self._request("GET", "/admin/projects"))
+
+    def admin_user_tokens(self, user_id: str) -> list[TokenInfo]:
+        return self._models(TokenInfo, self._request("GET", f"/admin/users/{user_id}/tokens"))
+
+    def admin_toggle_admin(self, user_id: str) -> UserProfile:
+        return self._model(UserProfile, self._request("POST", f"/admin/users/{user_id}/toggle-admin"))
+
+    def admin_revoke_token(self, token_id: str) -> TokenInfo:
+        return self._model(TokenInfo, self._request("POST", f"/admin/tokens/{token_id}/revoke"))
+
+
+class AsyncOrbsimClient(_OrbsimClientBase):
+    def __init__(
+        self,
+        base_url: str,
+        token: str | None = None,
+        timeout: float = 30.0,
+        client: httpx.AsyncClient | None = None,
+    ) -> None:
+        self.base_url = base_url.rstrip("/")
+        self._client = client or httpx.AsyncClient(base_url=self.base_url, timeout=timeout)
+        self._owns_client = client is None
+        if token:
+            self.set_token(token)
+
+    async def aclose(self) -> None:
+        if self._owns_client:
+            await self._client.aclose()
+
+    async def __aenter__(self) -> "AsyncOrbsimClient":
+        return self
+
+    async def __aexit__(self, exc_type, exc, tb) -> None:
+        await self.aclose()
+
+    @property
+    def token(self) -> str | None:
+        auth = self._client.headers.get("Authorization", "")
+        if auth.startswith("Bearer "):
+            return auth.removeprefix("Bearer ")
+        return None
+
+    def set_token(self, token: str | None) -> None:
+        if token:
+            self._client.headers["Authorization"] = f"Bearer {token}"
+        else:
+            self._client.headers.pop("Authorization", None)
+
+    async def _request(self, method: str, path: str, *, params: dict[str, Any] | None = None, payload: BaseModel | dict[str, Any] | None = None) -> Any:
+        json_payload: dict[str, Any] | None = None
+        if payload is not None:
+            json_payload = payload.model_dump(mode="json", exclude_none=True) if isinstance(payload, BaseModel) else payload
+        response = await self._client.request(method, path, params=params, json=json_payload)
+        if response.is_error:
+            try:
+                detail = response.json().get("detail", response.text)
+            except Exception:
+                detail = response.text
+            raise OrbsimAPIError(response.status_code, detail)
+        if not response.content:
+            return None
+        return response.json()
+
+    async def bootstrap_admin(self, email: str, password: str, full_name: str) -> AuthTokenResponse:
+        result = self._model(AuthTokenResponse, await self._request("POST", "/auth/bootstrap-admin", payload=BootstrapAdminRequest(email=email, password=password, full_name=full_name)))
+        self.set_token(result.token)
+        return result
+
+    async def register(self, email: str, password: str, full_name: str) -> AuthTokenResponse:
+        result = self._model(AuthTokenResponse, await self._request("POST", "/auth/register", payload=RegisterRequest(email=email, password=password, full_name=full_name)))
+        self.set_token(result.token)
+        return result
+
+    async def login(self, email: str, password: str, token_name: str = "Default API Token") -> AuthTokenResponse:
+        result = self._model(AuthTokenResponse, await self._request("POST", "/auth/login", payload=LoginRequest(email=email, password=password, token_name=token_name)))
+        self.set_token(result.token)
+        return result
+
+    async def me(self) -> UserProfile:
+        return self._model(UserProfile, await self._request("GET", "/auth/me"))
+
+    async def list_tokens(self) -> list[TokenInfo]:
+        return self._models(TokenInfo, await self._request("GET", "/auth/tokens"))
+
+    async def create_token(self, name: str) -> TokenCreateResponse:
+        return self._model(TokenCreateResponse, await self._request("POST", "/auth/tokens", payload=TokenCreateRequest(name=name)))
+
+    async def revoke_own_token(self, token_id: str) -> TokenInfo:
+        return self._model(TokenInfo, await self._request("DELETE", f"/auth/tokens/{token_id}"))
+
+    async def health(self) -> HealthResponse:
+        return self._model(HealthResponse, await self._request("GET", "/health"))
+
+    async def get_public_tle(self, query: PublicSatelliteQuery) -> PublicTLE:
+        return self._model(PublicTLE, await self._request("POST", "/public/tle", payload=query))
+
+    async def get_public_state(self, query: PublicSatelliteQuery, timestamp: datetime | str) -> OrbitalStateResponse:
+        return self._model(OrbitalStateResponse, await self._request("POST", "/public/state", params={"timestamp": timestamp}, payload=query))
+
+    async def get_public_contacts(self, query: PublicContactQuery) -> list[ContactInterval]:
+        return self._models(ContactInterval, await self._request("POST", "/public/contacts", payload=query))
+
+    async def create_project(self, payload: ProjectCreate) -> Project:
+        return self._model(Project, await self._request("POST", "/projects", payload=payload))
+
+    async def list_projects(self) -> list[Project]:
+        return self._models(Project, await self._request("GET", "/projects"))
+
+    async def delete_project(self, project_id: str) -> Project:
+        return self._model(Project, await self._request("DELETE", f"/projects/{project_id}"))
+
+    async def create_satellite(self, project_id: str, payload: SatelliteCreate) -> Satellite:
+        return self._model(Satellite, await self._request("POST", f"/projects/{project_id}/satellites", payload=payload))
+
+    async def list_satellites(self, project_id: str) -> list[Satellite]:
+        return self._models(Satellite, await self._request("GET", f"/projects/{project_id}/satellites"))
+
+    async def delete_satellite(self, project_id: str, satellite_id: str) -> Satellite:
+        return self._model(Satellite, await self._request("DELETE", f"/projects/{project_id}/satellites/{satellite_id}"))
+
+    async def create_groundstation(self, project_id: str, payload: GroundStationCreate) -> GroundStation:
+        return self._model(GroundStation, await self._request("POST", f"/projects/{project_id}/groundstations", payload=payload))
+
+    async def list_groundstations(self, project_id: str) -> list[GroundStation]:
+        return self._models(GroundStation, await self._request("GET", f"/projects/{project_id}/groundstations"))
+
+    async def delete_groundstation(self, project_id: str, groundstation_id: str) -> GroundStation:
+        return self._model(GroundStation, await self._request("DELETE", f"/projects/{project_id}/groundstations/{groundstation_id}"))
+
+    async def get_satellite_state(self, project_id: str, satellite_id: str, timestamp: datetime | str) -> OrbitalStateResponse:
+        return self._model(OrbitalStateResponse, await self._request("POST", f"/projects/{project_id}/satellites/{satellite_id}/state", params={"timestamp": timestamp}))
+
+    async def get_satellite_states(self, project_id: str, satellite_id: str, payload: TimeRangeQuery) -> list[OrbitalStateResponse]:
+        return self._models(OrbitalStateResponse, await self._request("POST", f"/projects/{project_id}/satellites/{satellite_id}/states", payload=payload))
+
+    async def get_satellite_attitude(self, project_id: str, satellite_id: str, timestamp: datetime | str) -> AttitudeSample:
+        return self._model(AttitudeSample, await self._request("POST", f"/projects/{project_id}/satellites/{satellite_id}/attitude", params={"timestamp": timestamp}))
+
+    async def get_satellite_subsystems(self, project_id: str, satellite_id: str, timestamp: datetime | str) -> SatelliteSubsystemState:
+        return self._model(SatelliteSubsystemState, await self._request("POST", f"/projects/{project_id}/satellites/{satellite_id}/subsystems", params={"timestamp": timestamp}))
+
+    async def get_contacts(self, project_id: str, satellite_id: str, groundstation_id: str, payload: TimeRangeQuery) -> list[ContactInterval]:
+        return self._models(ContactInterval, await self._request("POST", f"/projects/{project_id}/contacts/{satellite_id}/{groundstation_id}", payload=payload))
+
+    async def get_link_budget(self, project_id: str, payload: LinkBudgetRequest) -> LinkBudgetResponse:
+        return self._model(LinkBudgetResponse, await self._request("POST", f"/projects/{project_id}/links/budget", payload=payload))
+
+    async def create_constellation(self, project_id: str, payload: ConstellationCreate) -> Constellation:
+        return self._model(Constellation, await self._request("POST", f"/projects/{project_id}/constellations", payload=payload))
+
+    async def design_constellation(self, project_id: str, payload: ConstellationDesignCreate) -> ConstellationDesignResponse:
+        return self._model(ConstellationDesignResponse, await self._request("POST", f"/projects/{project_id}/constellations/design", payload=payload))
+
+    async def list_constellations(self, project_id: str) -> list[Constellation]:
+        return self._models(Constellation, await self._request("GET", f"/projects/{project_id}/constellations"))
+
+    async def delete_constellation(self, project_id: str, constellation_id: str) -> Constellation:
+        return self._model(Constellation, await self._request("DELETE", f"/projects/{project_id}/constellations/{constellation_id}"))
+
+    async def get_constellation_network(self, project_id: str, constellation_id: str, timestamp: datetime | str, kind: str = "rf") -> NetworkResponse:
+        return self._model(NetworkResponse, await self._request("POST", f"/projects/{project_id}/constellations/{constellation_id}/network", params={"timestamp": timestamp, "kind": kind}))
+
+    async def admin_dashboard(self) -> AdminDashboard:
+        return self._model(AdminDashboard, await self._request("GET", "/admin/dashboard"))
+
+    async def admin_list_users(self) -> list[UserProfile]:
+        return self._models(UserProfile, await self._request("GET", "/admin/users"))
+
+    async def admin_list_projects(self) -> list[AdminProjectInfo]:
+        return self._models(AdminProjectInfo, await self._request("GET", "/admin/projects"))
+
+    async def admin_user_tokens(self, user_id: str) -> list[TokenInfo]:
+        return self._models(TokenInfo, await self._request("GET", f"/admin/users/{user_id}/tokens"))
+
+    async def admin_toggle_admin(self, user_id: str) -> UserProfile:
+        return self._model(UserProfile, await self._request("POST", f"/admin/users/{user_id}/toggle-admin"))
+
+    async def admin_revoke_token(self, token_id: str) -> TokenInfo:
+        return self._model(TokenInfo, await self._request("POST", f"/admin/tokens/{token_id}/revoke"))

orbsim_sdk-0.1.0/src/orbsim_sdk/exceptions.py

@@ -0,0 +1,9 @@
+class OrbsimSDKError(Exception):
+    """Base SDK exception."""
+
+
+class OrbsimAPIError(OrbsimSDKError):
+    def __init__(self, status_code: int, detail: str):
+        self.status_code = status_code
+        self.detail = detail
+        super().__init__(f"OrbSim API error {status_code}: {detail}")

orbsim_sdk-0.1.0/src/orbsim_sdk/models.py

@@ -0,0 +1,317 @@
+from __future__ import annotations
+
+from datetime import datetime
+from enum import Enum
+from typing import Any, Literal
+
+from pydantic import BaseModel, Field, HttpUrl
+
+
+class OrbitSource(str, Enum):
+    TLE = "tle"
+    EPHEMERIS = "ephemeris"
+    KEPLERIAN = "keplerian"
+
+
+class AnomalyKind(str, Enum):
+    TRUE = "true"
+    MEAN = "mean"
+    ECCENTRIC = "eccentric"
+
+
+class AttitudeMode(str, Enum):
+    LVLH = "lvlh"
+    NADIR = "nadir"
+    SUN_POINTING = "sun_pointing"
+    INERTIAL = "inertial"
+
+
+class LinkKind(str, Enum):
+    RF = "rf"
+    OPTICAL = "optical"
+
+
+class ConstellationDesignType(str, Enum):
+    WALKER_DELTA = "walker_delta"
+
+
+class LoginRequest(BaseModel):
+    email: str
+    password: str
+    token_name: str = "Default API Token"
+
+
+class RegisterRequest(BaseModel):
+    email: str
+    password: str
+    full_name: str
+
+
+class BootstrapAdminRequest(RegisterRequest):
+    pass
+
+
+class UserProfile(BaseModel):
+    id: str
+    email: str
+    full_name: str
+    is_admin: bool
+    is_active: bool
+    created_at: datetime
+
+
+class AuthTokenResponse(BaseModel):
+    token: str
+    token_type: Literal["bearer"] = "bearer"
+    user: UserProfile
+
+
+class TokenCreateRequest(BaseModel):
+    name: str
+
+
+class TokenInfo(BaseModel):
+    id: str
+    name: str
+    token_prefix: str
+    created_at: datetime
+    last_used_at: datetime | None = None
+    revoked_at: datetime | None = None
+
+
+class TokenCreateResponse(BaseModel):
+    token: str
+    token_info: TokenInfo
+
+
+class ProjectCreate(BaseModel):
+    name: str
+    description: str | None = None
+
+
+class Project(BaseModel):
+    id: str
+    name: str
+    description: str | None = None
+    created_at: datetime
+
+
+class CartesianState(BaseModel):
+    timestamp: datetime
+    position_m: list[float] = Field(min_length=3, max_length=3)
+    velocity_mps: list[float] = Field(min_length=3, max_length=3)
+
+
+class TLEDefinition(BaseModel):
+    line1: str
+    line2: str
+
+
+class KeplerianDefinition(BaseModel):
+    semi_major_axis_m: float
+    eccentricity: float
+    inclination_deg: float
+    raan_deg: float
+    arg_perigee_deg: float
+    anomaly_deg: float
+    anomaly_kind: AnomalyKind = AnomalyKind.TRUE
+    epoch: datetime
+
+
+class SatelliteSubsystemState(BaseModel):
+    power_w: float = 0.0
+    battery_soc: float = 1.0
+    thermal_c: float = 20.0
+    payload_active: bool = False
+    comms_margin_db: float = 0.0
+
+
+class SatelliteCreate(BaseModel):
+    name: str
+    source: OrbitSource
+    tle: TLEDefinition | None = None
+    ephemeris: list[CartesianState] | None = None
+    keplerian: KeplerianDefinition | None = None
+    attitude_mode: AttitudeMode = AttitudeMode.NADIR
+    dry_mass_kg: float = 100.0
+    subsystems: SatelliteSubsystemState = Field(default_factory=SatelliteSubsystemState)
+
+
+class Satellite(BaseModel):
+    id: str
+    name: str
+    source: OrbitSource
+    tle: TLEDefinition | None = None
+    ephemeris: list[CartesianState] | None = None
+    keplerian: KeplerianDefinition | None = None
+    attitude_mode: AttitudeMode
+    dry_mass_kg: float
+    subsystems: SatelliteSubsystemState
+
+
+class GroundStationCreate(BaseModel):
+    name: str
+    latitude_deg: float
+    longitude_deg: float
+    altitude_m: float = 0.0
+    min_elevation_deg: float = 5.0
+
+
+class GroundStation(BaseModel):
+    id: str
+    name: str
+    latitude_deg: float
+    longitude_deg: float
+    altitude_m: float = 0.0
+    min_elevation_deg: float = 5.0
+
+
+class TimeRangeQuery(BaseModel):
+    start: datetime
+    end: datetime
+    step_seconds: int = 60
+
+
+class AttitudeSample(BaseModel):
+    timestamp: datetime
+    quaternion_xyzw: list[float]
+    euler_deg: list[float]
+    mode: AttitudeMode
+
+
+class OrbitalStateResponse(BaseModel):
+    satellite_id: str
+    timestamp: datetime
+    position_m: list[float]
+    velocity_mps: list[float]
+    inertial_position_m: list[float] | None = None
+    inertial_velocity_mps: list[float] | None = None
+    altitude_m: float
+    latitude_deg: float
+    longitude_deg: float
+
+
+class ContactInterval(BaseModel):
+    start: datetime
+    end: datetime
+    max_elevation_deg: float
+    satellite_id: str
+    groundstation_id: str
+
+
+class LinkBudgetRequest(BaseModel):
+    source_satellite_id: str
+    target_satellite_id: str | None = None
+    groundstation_id: str | None = None
+    kind: LinkKind
+    timestamp: datetime
+    frequency_hz: float = 8.2e9
+    tx_power_dbw: float = 10.0
+    tx_gain_dbi: float = 25.0
+    rx_gain_dbi: float = 25.0
+    bandwidth_hz: float = 1e6
+    system_temperature_k: float = 500.0
+    optical_wavelength_nm: float = 1550.0
+    aperture_m: float = 0.12
+
+
+class LinkBudgetResponse(BaseModel):
+    kind: LinkKind
+    range_m: float
+    free_space_loss_db: float
+    rx_power_dbw: float
+    snr_db: float
+    visible: bool
+
+
+class ConstellationCreate(BaseModel):
+    name: str
+    satellite_ids: list[str]
+    isl_max_range_m: float = 3_500_000.0
+    max_degree: int = 4
+
+
+class WalkerDeltaDefinition(BaseModel):
+    total_satellites: int
+    plane_count: int
+    relative_spacing: int
+    semi_major_axis_m: float
+    eccentricity: float
+    inclination_deg: float
+    arg_perigee_deg: float = 0.0
+    start_raan_deg: float = 0.0
+    start_anomaly_deg: float = 0.0
+    anomaly_kind: AnomalyKind = AnomalyKind.MEAN
+    satellite_name_prefix: str | None = None
+    attitude_mode: AttitudeMode = AttitudeMode.NADIR
+    dry_mass_kg: float = 100.0
+    subsystems: SatelliteSubsystemState = Field(default_factory=SatelliteSubsystemState)
+
+
+class ConstellationDesignCreate(BaseModel):
+    name: str
+    type: ConstellationDesignType
+    walker_delta: WalkerDeltaDefinition | None = None
+    isl_max_range_m: float = 3_500_000.0
+    max_degree: int = 4
+
+
+class Constellation(BaseModel):
+    id: str
+    name: str
+    satellite_ids: list[str]
+    isl_max_range_m: float
+    max_degree: int
+
+
+class ConstellationDesignResponse(BaseModel):
+    constellation: Constellation
+    satellites: list[Satellite]
+
+
+class PublicSatelliteQuery(BaseModel):
+    norad_id: str | None = None
+    name: str | None = None
+    source_url: HttpUrl | None = None
+
+
+class PublicTLE(BaseModel):
+    name: str
+    line1: str
+    line2: str
+    source: str
+
+
+class PublicContactQuery(BaseModel):
+    satellite: PublicSatelliteQuery
+    groundstation: GroundStationCreate
+    start: datetime
+    end: datetime
+    step_seconds: int = 60
+
+
+class AdminDashboard(BaseModel):
+    user_count: int
+    project_count: int
+    token_count: int
+    active_token_count: int
+
+
+class HealthResponse(BaseModel):
+    status: Literal["ok"]
+    orekit_available: bool
+
+
+class AdminProjectInfo(BaseModel):
+    id: str
+    name: str
+    description: str | None = None
+    created_at: datetime
+    owner_email: str
+
+
+class NetworkResponse(BaseModel):
+    timestamp: datetime
+    kind: str
+    nodes: dict[str, OrbitalStateResponse]
+    adjacency: dict[str, list[dict[str, Any]]]

orbsim_sdk-0.1.0/src/orbsim_sdk.egg-info/PKG-INFO

@@ -0,0 +1,61 @@
+Metadata-Version: 2.4
+Name: orbsim-sdk
+Version: 0.1.0
+Summary: Python SDK for the OrbSim API
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: pydantic>=2.8.0
+
+# OrbSim SDK
+
+Typed Python client for the OrbSim API.
+
+## Install
+
+```bash
+pip install /path/to/orbsim/sdk
+```
+
+## Quick Start
+
+```python
+from orbsim_sdk import OrbitSource, OrbsimClient, SatelliteCreate, TLEDefinition
+
+client = OrbsimClient("http://127.0.0.1:8000/api")
+auth = client.login("admin@example.com", "supersecret123", token_name="SDK Session")
+projects = client.list_projects()
+
+satellite = client.create_satellite(
+    projects[0].id,
+    SatelliteCreate(
+        name="ISS Copy",
+        source=OrbitSource.TLE,
+        tle=TLEDefinition(
+            line1="1 25544U 98067A   26099.50000000  .00016717  00000+0  30747-3 0  9991",
+            line2="2 25544  51.6400  54.1200 0003870 123.4567 321.6543 15.50000000123456",
+        ),
+    ),
+)
+
+state = client.get_satellite_state(projects[0].id, satellite.id, "2026-04-09T12:00:00Z")
+print(state.latitude_deg, state.longitude_deg, state.altitude_m)
+```
+
+## Async Quick Start
+
+```python
+import asyncio
+
+from orbsim_sdk import AsyncOrbsimClient
+
+
+async def main():
+    async with AsyncOrbsimClient("http://127.0.0.1:8000/api") as client:
+        await client.login("admin@example.com", "supersecret123", token_name="Async SDK Session")
+        projects = await client.list_projects()
+        print([project.name for project in projects])
+
+
+asyncio.run(main())
+```

orbsim_sdk-0.1.0/src/orbsim_sdk.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+README.md
+pyproject.toml
+src/orbsim_sdk/__init__.py
+src/orbsim_sdk/client.py
+src/orbsim_sdk/exceptions.py
+src/orbsim_sdk/models.py
+src/orbsim_sdk.egg-info/PKG-INFO
+src/orbsim_sdk.egg-info/SOURCES.txt
+src/orbsim_sdk.egg-info/dependency_links.txt
+src/orbsim_sdk.egg-info/requires.txt
+src/orbsim_sdk.egg-info/top_level.txt

orbsim_sdk-0.1.0/src/orbsim_sdk.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

orbsim_sdk-0.1.0/src/orbsim_sdk.egg-info/requires.txt

@@ -0,0 +1,2 @@
+httpx>=0.27.0
+pydantic>=2.8.0

orbsim_sdk-0.1.0/src/orbsim_sdk.egg-info/top_level.txt

@@ -0,0 +1 @@
+orbsim_sdk