Error Codes

{
  "error": "VALIDATION_ERROR",
  "message": "The 'quantity' field must be a positive integer.",
  "statusCode": 400
}

import { ApiError } from '@craveup/storefront-sdk';

try {
  await storefront.cart.addItem(locationId, cartId, payload);
} catch (error) {
  if (error instanceof ApiError) {
    console.error({
      status: error.status,       // e.g. 400
      statusText: error.statusText, // e.g. "Bad Request"
      url: error.url,             // the request URL
      body: error.body,           // raw response body (string)
    });

    // Parse the body for structured error info
    const parsed = JSON.parse(error.body ?? '{}');
    showToast(parsed.message);
  }
}

async function withRetry<T>(fn: () => Promise<T>, maxRetries = 3): Promise<T> {
  for (let attempt = 0; attempt <= maxRetries; attempt++) {
    try {
      return await fn();
    } catch (error) {
      if (
        error instanceof ApiError &&
        [429, 500, 502, 503].includes(error.status) &&
        attempt < maxRetries
      ) {
        const delay = Math.min(1000 * 2 ** attempt, 10_000);
        await new Promise((resolve) => setTimeout(resolve, delay));
        continue;
      }
      throw error;
    }
  }
  throw new Error('Max retries exceeded');
}

// Usage
const cart = await withRetry(() => storefront.cart.get(locationId, cartId));

function getUserMessage(error: ApiError): string {
  const body = JSON.parse(error.body ?? '{}');

  switch (error.status) {
    case 400:
      return body.message ?? 'Please check your input and try again.';
    case 401:
      return 'Your session has expired. Please refresh the page.';
    case 404:
      return 'This item is no longer available.';
    case 409:
      return body.message ?? 'This action conflicts with your current order.';
    case 422:
      return body.message ?? 'We cannot process this request right now.';
    case 429:
      return 'Too many requests. Please wait a moment and try again.';
    default:
      return 'Something went wrong. Please try again.';
  }
}