Class ApiClient

frontend/src/api/client.ts:65–187

 * and share across the application.
 */
export class ApiClient {
  private _baseUrl: string;
  private _defaultTimeoutMs: number;

  constructor(baseUrl?: string, defaultTimeoutMs = DEFAULT_TIMEOUT_MS) {
    this._baseUrl = baseUrl !== undefined ? baseUrl : resolveApiBase();
    this._defaultTimeoutMs = defaultTimeoutMs;
  }

  /** Current base URL (without trailing slash). */
  get baseUrl(): string {
    return this._baseUrl;
  }

  /** Update the base URL and persist it to localStorage if non-empty. */
  setBaseUrl(value: string): void {
    const normalized = (value || '').trim().replace(/\/$/, '');
    this._baseUrl = normalized === window.location.origin ? '' : normalized;
    if (this._baseUrl) {
      localStorage.setItem('space_api_base', this._baseUrl);
    } else {
      localStorage.removeItem('space_api_base');
    }
  }

  /** Build a fully-qualified URL for the given API path. */
  url(path: string): string {
    return `${this._baseUrl}${path}`;
  }

  /**
   * Execute an HTTP request and return the parsed JSON response.
   *
   * - Injects `Authorization: Bearer <token>` when `smartnode_token` is set
   *   in localStorage and no `Authorization` header was provided.
   * - Unwraps backend envelope `{ code: 0, data: T }` transparently.
   * - Throws `ApiError` on non-2xx responses or timeout.
   */
  async request<T>(path: string, options: RequestOptions = {}): Promise<T> {
    const { timeoutMs = this._defaultTimeoutMs, ...fetchOptions } = options;

    const headers: Record<string, string> = {
      'Content-Type': 'application/json',
      ...((fetchOptions.headers as Record<string, string>) || {}),
    };

    const token = localStorage.getItem('smartnode_token');
    if (token && !headers['Authorization']) {
      headers['Authorization'] = `Bearer ${token}`;
    }

    let abortController: AbortController | undefined;
    let timeoutId: ReturnType<typeof setTimeout> | undefined;

    if (timeoutMs > 0) {
      abortController = new AbortController();
      timeoutId = setTimeout(() => abortController!.abort(), timeoutMs);
    }