flyio-sdk-patterns

# Fly.io SDK Patterns ## Overview Production-ready patterns for the Fly.io Machines REST API at `https://api.machines.dev`. Fly.io exposes both GraphQL (organization queries) and REST (machine lifecycle) APIs. The Machines REST API is the primary integration surface for creating, starting, stopping, and destroying VMs across 30+ global regions. A structured client ensures consistent auth, typed machine states, and reliable wait-for-state polling. ## Singleton Client ```typescript const FLY_API = 'https://api.machines.dev'; let _client: FlyClient | null = null; export function getClient(appName: string): FlyClient { if (!_client) { const token = process.env.FLY_API_TOKEN; if (!token) throw new Error('FLY_API_TOKEN must be set'); _client = new FlyClient(appName, token); } return _client; } class FlyClient { private h: Record<string, string>; constructor(private app: string, token: string) { this.h = { 'Authorization': `Bearer ${token}`, 'Content-Type': 'application/json' }; } async listMachines(): Promise<FlyMachine[]> { const r = await fetch(`${FLY_API}/v1/apps/${this.app}/machines`, { headers: this.h }); if (!r.ok) throw new FlyError(r.status, await r.text()); return r.json(); } async createMachine(config: MachineConfig, region: string): Promise<FlyMachine> { const r = await fetch(`${FLY_API}/v1/apps/${this.app}/machines`, { method: 'POST', headers: this.h, body: JSON.stringify({ region, config }) }); if (!r.ok) throw ...