Services

External API integrations (pure API calls only).

Services should:

  • Be single-purpose functions that make direct API calls to external systems
  • Be pure functions that handle HTTP transport layer (response.ok)
  • Return consistent { success: boolean, data?: any, error?: string } format
  • NOT handle environment variables, business logic, or orchestrate multiple calls