Happy Returns

// Happy Returns API: initiate a return for a UCP-verified order
// Agent uses UCP identity token to prove shopper consent

const HAPPY_RETURNS_API = 'https://api.happyreturns.com/v1';

async function initiateAgentReturn(ucpOrderId: string, identityToken: string, items: Array<{ sku: string; quantity: number; reason: string }>) {
  // Step 1: Validate return eligibility
  const eligibility = await fetch(`${HAPPY_RETURNS_API}/eligibility`, {
    method: 'POST',
    headers: {
      Authorization: `Bearer ${process.env.HAPPY_RETURNS_API_KEY}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({ order_id: ucpOrderId, items }),
  }).then(r => r.json());

  if (!eligibility.eligible) {
    throw new Error(`Return not eligible: ${eligibility.reason}`);
  }

  // Step 2: Create return and get QR code
  const returnRequest = await fetch(`${HAPPY_RETURNS_API}/returns`, {
    method: 'POST',
    headers: {
      Authorization: `Bearer ${process.env.HAPPY_RETURNS_API_KEY}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      order_id: ucpOrderId,
      ucp_identity_token: identityToken,
      items,
      return_method: 'drop_off',
    }),
  }).then(r => r.json());

  // QR code surfaces to shopper via agent UI
  return {
    return_id: returnRequest.return_id,
    qr_code_url: returnRequest.qr_code_url,
    nearest_bar: returnRequest.nearest_drop_off_location,
    refund_eta: returnRequest.estimated_refund_date,
  };
}