convex-functions

Convex functions define backend logic using queries for reactive reads, mutations for transactional writes, and actions for external API integrations. Argument validation and error handling ensure secure, efficient data operations across these function types.

Internal functions handle standard database operations via queries and mutations, while HTTP actions process incoming webhooks and external API requests. HTTP actions expose endpoints for external integrations, distinct from internal reactive query flows.

Convex mutations require strict argument validation and explicit error handling to execute transactional write operations securely. Validating inputs before writing data prevents runtime errors and maintains robust application state.

Convex actions specifically handle external API calls, enabling integrations like sending real-time notifications via external services. They operate alongside queries and mutations to manage asynchronous, non-transactional operations.

Convex HTTP actions process incoming webhook requests by exposing API endpoints. They handle external HTTP payloads, validating incoming data before triggering internal mutations or actions for downstream processing.

Reactive queries in Convex require runtime considerations to maintain efficient, cached, read-only data fetching. Properly structuring these queries ensures real-time UI updates without hitting performance bottlenecks.