Error Handling

const result = await client.catalogue.getProducts();

if (!result.ok) {
  console.log(result.error.code);       // "UNAUTHORIZED"
  console.log(result.error.message);    // "Authentication is missing..."
  console.log(result.error.retryable);  // true | false
  console.log(result.error.suggestion); // "Ensure a valid access token..."
  console.log(result.error.docs_url);   // "https://docs.cimplify.io/reference/error-codes#unauthorized"
  return;
}

const products = result.value;

class CimplifyError extends Error {
  code: string;        // e.g. "CART_NOT_FOUND"
  message: string;     // Human-readable description
  retryable: boolean;  // Safe to retry automatically?
  suggestion?: string; // Developer-facing fix suggestion
  docs_url?: string;   // Link to error code reference
}

import { ErrorCode } from "@cimplify/sdk";

const result = await client.cart.addItem({ item_id: "prod_123", quantity: 1 });

if (!result.ok) {
  if (result.error.retryable) {
    // Safe to retry with backoff
    showToast("Connection issue. Retrying...");
  } else {
    // Show error, don't retry
    switch (result.error.code) {
      case ErrorCode.ITEM_UNAVAILABLE:
        showToast("This item is no longer available");
        break;
      case ErrorCode.OUT_OF_STOCK:
        showToast("This item is out of stock");
        break;
      default:
        showToast(result.error.message);
    }
  }
}