@paypal/commerce-cart-zod

Zod validation schemas for PayPal Cart API v1.

Installation

npm install @paypal/commerce-cart-zod

Usage

import {
  PayPalCartSchema,
  validatePayPalCart,
} from "@paypal/commerce-cart-zod";

// Validate data at runtime
const result = PayPalCartSchema.safeParse(cartData);
if (result.success) {
  console.log("Valid cart:", result.data);
} else {
  console.error("Validation errors:", result.error);
}

// Or use helper function
try {
  const validCart = validatePayPalCart(cartData);
  console.log("Valid cart:", validCart);
} catch (error) {
  console.error("Validation failed:", error);
}

Features

• Runtime validation with Zod
• Type-safe validation schemas
• Helper functions for common validation tasks
• Inferred TypeScript types from schemas
• Generated from the official OpenAPI specification

Available Schemas

• PayPalCartSchema - Main cart object
• CartItemSchema - Individual cart items
• CustomerSchema - Customer information
• MoneySchema - Monetary amounts
• ValidationIssueSchema - Error handling
• And many more...

API Reference

See the full API documentation for complete schema reference.