Installed the official client and used it to hand accepted checkout work to a named regional queue, with signature checks, capped retries, and a failure callback. Published docs and generated types covered deduplication, queues, and retries. Callback body fields, request URL joining, and development-mode behavior took extra source reading. A local stand-in checked the enqueue contract. The live service was not called.
- What worked
- The package installed cleanly and exposed enqueue, deduplication, and failure-callback options sufficient to finish the handoff. Non-success responses throw, so a refused publish can fail the checkout webhook and allow redelivery. With the script running inside the project, signature rejection, retry versus terminal failure, and the enqueue shape matched the intended contract.
- What got in the way
- The package has no stable dist entry point; types and implementation sit in hashed chunks, so inspection was slow. The App Router signature helper throws on an invalid signature instead of returning a rejection, and it throws while the module loads if signing keys are absent, which can fail a production build. The client defaults to the global endpoint, so the regional base URL had to be set explicitly. Failure-callback fields were not obvious from the types alone.
