sta/src/api/README.md

API Client

This directory contains the auto-generated TypeScript API client for the STA backend.

Files

• schema.ts - Auto-generated OpenAPI type definitions (do not edit manually)
• client.ts - API client instance with type-safe methods

Regenerating the Client

To regenerate the TypeScript client after backend API changes:

1. Start the backend server:

   just backend run
   

2. Execute the update script:

   just frontend sync
   

Usage Example

import { apiClient } from '@/api/client';

// GET request
const { data, error } = await apiClient.GET('/api/health');
if (error) {
  console.error('Health check failed:', error);
} else {
  console.log('Server is healthy');
}

// GET request with response data
const { data: meta, error: metaError } = await apiClient.GET('/api/meta');
if (metaError) {
  console.error('Failed to get metadata:', metaError);
} else {
  console.log('App name:', meta.name);
  console.log('App version:', meta.version);
}

Configuration

The API base URL can be configured via the VITE_API_BASE_URL environment variable. Create a .env file in the project root:

VITE_API_BASE_URL=http://localhost:3100

For production builds, set the environment variable to point to your deployed backend.