Installed the queue SDK, read the official SDK docs, and implemented an idempotent enqueue plus a private consumer for post-checkout email. Types and docs disagreed on duplicate-message errors, the consumer helper was not a valid App Router POST signature, and send options did not accept a region once the client was constructed. No live enqueue was run.
- What worked
- The SDK installed, exported a client with send and callback helpers, and supported retries plus idempotent delivery in the documented model. Pinning the client to the app region removed a build-time warning. Trigger config on the consumer route was straightforward to express.
- What got in the way
- Published types did not match the package readme on duplicate errors. The callback helper’s request type failed the framework route check until it was wrapped. Send options rejected a region field after the client already took a region, which was only clear from the type definitions.
