71 lines
1.8 KiB
TypeScript
71 lines
1.8 KiB
TypeScript
/**
|
|
* Lightweight HTTP client for the RuView sensing-server.
|
|
*
|
|
* Uses Node's built-in `fetch` (available since Node 18). All requests respect
|
|
* the optional RUVIEW_API_TOKEN bearer header and a 10-second hard timeout.
|
|
*
|
|
* Failure model: every public function returns a typed `Result<T>` tuple to
|
|
* avoid try/catch proliferation in callers.
|
|
*/
|
|
|
|
const REQUEST_TIMEOUT_MS = 10_000;
|
|
|
|
export type Ok<T> = { ok: true; data: T };
|
|
export type Err = { ok: false; error: string };
|
|
export type Result<T> = Ok<T> | Err;
|
|
|
|
export function ok<T>(data: T): Ok<T> {
|
|
return { ok: true, data };
|
|
}
|
|
|
|
export function err(error: string): Err {
|
|
return { ok: false, error };
|
|
}
|
|
|
|
/**
|
|
* Perform an authenticated GET against the sensing-server.
|
|
*/
|
|
export async function sensingGet<T>(
|
|
baseUrl: string,
|
|
path: string,
|
|
token: string | undefined
|
|
): Promise<Result<T>> {
|
|
const url = `${baseUrl.replace(/\/$/, "")}${path}`;
|
|
const headers: Record<string, string> = {
|
|
Accept: "application/json",
|
|
};
|
|
if (token) {
|
|
headers["Authorization"] = `Bearer ${token}`;
|
|
}
|
|
|
|
const controller = new AbortController();
|
|
const timer = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
|
|
|
|
try {
|
|
const res = await fetch(url, {
|
|
headers,
|
|
signal: controller.signal,
|
|
});
|
|
clearTimeout(timer);
|
|
|
|
if (!res.ok) {
|
|
return err(`HTTP ${res.status} from ${url}: ${await res.text().catch(() => "(no body)")}`);
|
|
}
|
|
|
|
let body: unknown;
|
|
try {
|
|
body = await res.json();
|
|
} catch {
|
|
return err(`Non-JSON response from ${url}`);
|
|
}
|
|
|
|
return ok(body as T);
|
|
} catch (e: unknown) {
|
|
clearTimeout(timer);
|
|
if (e instanceof Error && e.name === "AbortError") {
|
|
return err(`Request to ${url} timed out after ${REQUEST_TIMEOUT_MS} ms`);
|
|
}
|
|
return err(`Network error fetching ${url}: ${String(e)}`);
|
|
}
|
|
}
|