archastro.platform.v1.resources.relays

  1# Copyright (c) 2026 ArchAstro Inc. Licensed under the MIT License.
  2# This file is auto-generated by @archastro/sdk-generator. Do not edit.
  3# Content hash: b775160d8a63
  4
  5from __future__ import annotations
  6
  7from typing import TypedDict
  8
  9from ...runtime.http_client import HttpClient, SyncHttpClient
 10from ...types.relays import Relay
 11
 12
 13class RelayCreateInput(TypedDict):
 14    "Create an owner-only relay"
 15
 16    purpose: str
 17    ttl_seconds: int
 18
 19
 20class RelayExtendInput(TypedDict):
 21    "Extend an owner-only relay"
 22
 23    ttl_seconds: int
 24
 25
 26class AsyncRelayResource:
 27    def __init__(self, http: HttpClient):
 28        self._http = http
 29
 30    async def create(self, input: RelayCreateInput) -> Relay:
 31        """
 32        Create an owner-only relay
 33        Only the owning user in the same app may access this relay.
 34
 35        Args:
 36            input: Request body.
 37
 38        Returns:
 39            Successful response
 40        """
 41        return await self._http.request(
 42            "/api/v1/relays",
 43            method="POST",
 44            body=input,
 45            response_type=Relay,
 46        )
 47
 48    async def delete(self, relay: str) -> Relay:
 49        """
 50        Delete an owner-only relay
 51        Only the owning user in the same app may access this relay.
 52
 53        Returns:
 54            Successful response
 55        """
 56        return await self._http.request(
 57            f"/api/v1/relays/{relay}",
 58            method="DELETE",
 59            response_type=Relay,
 60        )
 61
 62    async def get(self, relay: str) -> Relay:
 63        """
 64        Show an owner-only relay
 65        Only the owning user in the same app may access this relay.
 66
 67        Returns:
 68            Successful response
 69        """
 70        return await self._http.request(f"/api/v1/relays/{relay}", response_type=Relay)
 71
 72    async def extend(self, relay: str, input: RelayExtendInput) -> Relay:
 73        """
 74        Extend an owner-only relay
 75        Only the owning user in the same app may access this relay.
 76
 77        Args:
 78            input: Request body.
 79
 80        Returns:
 81            Successful response
 82        """
 83        return await self._http.request(
 84            f"/api/v1/relays/{relay}/extend",
 85            method="POST",
 86            body=input,
 87            response_type=Relay,
 88        )
 89
 90
 91class RelayResource:
 92    def __init__(self, http: SyncHttpClient):
 93        self._http = http
 94
 95    def create(self, input: RelayCreateInput) -> Relay:
 96        """
 97        Create an owner-only relay
 98        Only the owning user in the same app may access this relay.
 99
100        Args:
101            input: Request body.
102
103        Returns:
104            Successful response
105        """
106        return self._http.request("/api/v1/relays", method="POST", body=input, response_type=Relay)
107
108    def delete(self, relay: str) -> Relay:
109        """
110        Delete an owner-only relay
111        Only the owning user in the same app may access this relay.
112
113        Returns:
114            Successful response
115        """
116        return self._http.request(f"/api/v1/relays/{relay}", method="DELETE", response_type=Relay)
117
118    def get(self, relay: str) -> Relay:
119        """
120        Show an owner-only relay
121        Only the owning user in the same app may access this relay.
122
123        Returns:
124            Successful response
125        """
126        return self._http.request(f"/api/v1/relays/{relay}", response_type=Relay)
127
128    def extend(self, relay: str, input: RelayExtendInput) -> Relay:
129        """
130        Extend an owner-only relay
131        Only the owning user in the same app may access this relay.
132
133        Args:
134            input: Request body.
135
136        Returns:
137            Successful response
138        """
139        return self._http.request(
140            f"/api/v1/relays/{relay}/extend",
141            method="POST",
142            body=input,
143            response_type=Relay,
144        )