HTTP

// GET
const { data, status } = await seed.http.get<User>('https://api.example.com/users/1')

// POST
const { data } = await seed.http.post<User>('https://api.example.com/users', {
  name: 'Alice',
  email: 'alice@example.com',
})

// PUT
await seed.http.put('https://api.example.com/users/1', { name: 'Alice Updated' })

// PATCH
await seed.http.patch('https://api.example.com/users/1', { name: 'Alice' })

// DELETE
await seed.http.delete('https://api.example.com/users/1')

// HEAD
const { headers } = await seed.http.head('https://api.example.com/health')

const { data } = await seed.http.get<SearchResult>('https://api.example.com/search', {
  params: { q: 'seed cli', page: 1 },
  headers: { Authorization: 'Bearer token123' },
  timeout: 5000,
  retry: 3,
})

await seed.http.get('https://api.example.com/data', {
  retry: {
    count: 3,
    delay: 1000,
    backoff: 'exponential',  // 1s, 2s, 4s
    retryOn: [503, 429],     // Only retry these status codes
  },
})

const api = seed.http.create({
  baseURL: 'https://api.example.com',
  headers: {
    Authorization: `Bearer ${token}`,
    'Content-Type': 'application/json',
  },
  timeout: 10000,
  retry: 2,
})

// All requests use the base config
const { data: users } = await api.get<User[]>('/users')
const { data: user } = await api.post<User>('/users', { name: 'Alice' })

const api = seed.http.create({
  baseURL: 'https://api.example.com',
  interceptors: {
    request: async (url, init) => {
      // Add timestamp to every request
      init.headers = { ...init.headers, 'X-Request-Time': Date.now().toString() }
      return init
    },
    response: async (response) => {
      // Log all responses
      seed.print.debug(`${response.status} ${response.statusText}`)
      return response
    },
  },
})

await seed.http.download('https://example.com/archive.zip', './downloads/archive.zip', {
  onProgress: (progress) => {
    console.log(`${progress.percent}% - ${progress.speed} bytes/s`)
  },
})

import { createOpenAPIClient } from '@seedcli/http'
import type { paths } from './api-schema'  // Generated from OpenAPI spec

const api = await createOpenAPIClient<paths>({
  baseUrl: 'https://api.example.com',
  headers: { Authorization: `Bearer ${token}` },
})

npm install openapi-fetch

// Fully typed request and response
const { data, error } = await api.GET('/users/{id}', {
  params: { path: { id: '123' } },
})

const { data } = await api.POST('/users', {
  body: { name: 'Alice', email: 'alice@example.com' },
})

npx openapi-typescript https://api.example.com/openapi.json -o src/api-schema.ts

import { HttpError, HttpTimeoutError } from '@seedcli/http'