vtex-io-events-and-workers

What problem does it solve?

Apply when designing or implementing asynchronous processing in VTEX IO services through events, workers, and background handlers. Covers event handler structure, idempotency, retry-safe processing, and moving expensive work out of request-response routes. Use for event-driven integrations, delayed processing, or background jobs in VTEX IO apps.

Core Features & Use Cases

• Idempotent event handlers and workers to tolerate duplicate deliveries
• Explicitly declare events and workers in service.json to wire runtime behavior
• Move heavy or delayed work out of HTTP routes to improve request-response latency and reliability

Quick Start

Create an event-driven VTEX IO app that uses idempotent event handlers and a background worker to process long-running tasks.