interface ProductsResponse {
  status: boolean;
  message: string;
  data: {
    products: Product[];
    pagination: {
      page: number;
      limit: number;
      total: number;
    };
  };
}

interface ShippingRuleDestinations {
  enabled: boolean;
  options: ShippingDestination[];
}

interface ShippingDestination {
  rule_id: number;
  rule_name: string;
  destination_type: "nationwide" | "specific_states" | "specific_locations" | "international";
  destination_country_code: string | null;
  destination_states: string[];
  destination_locations: string[];
  destination_countries: Array<{ code: string; name: string }>;
  international_any_country: boolean;
}

interface CartValidationRequest {
  cart: CartItem[];
  currency: string;              // e.g., "USD", "NGN"
  discount_code?: string;
  delivery_details: DeliveryDetails;
}

interface DeliveryDetails {
  save_for_future_checkout: boolean;
  store_pick_up: boolean;
  national_delivery: boolean;
  international_delivery: boolean;
  address: [{
    name: string;
    email: string;           // Must be lowercase
    address: string;
    city: string;
    location?: string;       // For specific_locations shipping rules
    state: string;
    zip_code: string;
    country: string;         // Full country name
    country_code: string;    // ISO 2-letter code
    phone_number?: string;
  }];
}

interface CartValidationResponse {
  status: boolean;
  message: string;
  data: {
    cart_unique_id: string;
    total_sum: number;
    shipping_fee: number;
    total_sum_with_shipping_fee: number;
    cart_details: CartDetailItem[];
    pricing_summary: PricingSummary;
  };
}

interface PricingSummary {
  cart_subtotal: number;
  shipping_cost: number;
  cart_final_total: number;
  shipping_details: ShippingDetails;
}

interface ShippingDetails {
  source: "shipping_rules" | "easypost" | "uber_direct" | "standard";
  can_switch_rates: boolean;
  matched_rules: MatchedShippingRule[];
  available_destinations: ShippingDestination[];
}

interface PaymentIntentRequest {
  cart_unique_id: string;        // From cart validation
  cart: CartItem[];
  email: string;
  first_name: string;
  last_name: string;
  currency: string;
  payment_type: "one" | "subscription";
  payment_by: "customer";
  product_type: string;
  product_title: string;
  is_coupon_used: boolean;
  is_second_time_payment: boolean;
  order_total_charge: number;    // Subtotal in cents
  delivery_details: DeliveryDetails;
  // Note: Shipping selection is done via `location` field in delivery_details during cart validation
}

interface PaymentIntentResponse {
  status: boolean;
  message: string;
  data: {
    secret: string;              // Stripe client secret
    publishable_key: string;     // Stripe publishable key
    amount_to_pay: number;       // Final amount in cents
    currency: string;
    shipping_fee?: number;
    data?: {
      stripe_account_id?: string;
    };
  };
}

interface PricingResponse {
  status: boolean;
  data: {
    customer: {
      currency: { code: string; symbol: string };
      location: { country: string; country_code: string };
    };
    pricing: {
      original: { amount: number; currency: string; formatted: string };
      local: { amount: number; currency: string; formatted: string };
      conversion: { rate: number; applied: boolean };
    };
  };
}

await Khaime.confirmPayment({
  // Required
  secret: string;              // From payment intent
  publishable_key: string;     // From payment intent

  // Recommended
  stripe_account_id?: string;  // For Connect accounts
  amount?: number;             // Display amount in cents
  currency?: string;           // Currency code

  // Display mode
  display: "modal" | "inline";
  container?: HTMLElement;     // Required for inline mode

  // Callbacks
  onReady?: () => void;
  onSuccess?: (result: { paymentIntent: unknown }) => void;
  onError?: (error: Error) => void;
});

interface ErrorResponse {
  status: false;
  message: string;
  errors?: Record<string, string[]>;
}