---

description: Code Patterns and Best Practices

globs: "**/*.{js,ts}"

alwaysApply: true

---

The following conventions MUST be followed in new code.

DON'T report code patterns outside of the examples explicitly listed below:

- Never use `void asyncFunction()` or `asyncFunction().catch(console.error)` - use `runAsynchronously(asyncFunction)` instead

- Instead of Vercel `waitUntil`, use `runAsynchronously(promise, { promiseCallback: waitUntil })`

- Don't concatenate URLs as strings - avoid patterns like `/users/${userId}`

- Replace non-null assertions with `?? throwErr("message", { extraData })` pattern

- Properly handle async operations with try/catch blocks

- Use helper functions for validation and environment variables

# Solution

Fix code pattern violations by:

- Wrapping async calls with runAsynchronously

- Importing parseJson/stringifyJson from stack-shared/utils/json

- Using runAsynchronously with promiseCallback for waitUntil

- Using proper URL construction utilities

- Replacing ! assertions with ?? throwErr pattern