I expose a set of REST API endpoints that cover health checks, authentication, product browsing, cart/checkout, payments, and recommendations for the ShopAI platform.
I expose a liveness health probe at GET /health/live.
I expose a readiness health probe at GET /health/ready.
I allow new users to register via POST /auth/register.
I allow existing users to log in with email and password via POST /auth/login.
I provide a token refresh endpoint using an httpOnly cookie via POST /auth/refresh.
I let clients read or mutate the shopping cart via GET /cart and POST /cart.
I place an order with atomic stock reservation using POST /orders.
I create a Stripe payment intent via POST /payments/intent.
I ingest user interaction events for recommendations via POST /events.