Chargeback & Dispute Proof-of-Delivery Tracking API (Stripe, Shopify, PayPal & Escrow)

import Stripe from "stripe";

const stripe = new Stripe(process.env.STRIPE_SECRET_KEY!);

export async function attachTrackingEvidenceToStripeDispute(
  disputeId: string,
  trackingNumber: string,
  shippingAddress: string,
  customerName: string,
) {
  // 1. Fetch live normalized tracking history from lastscanned
  const res = await fetch(
    `https://api.lastscanned.com/v1/track/${encodeURIComponent(trackingNumber)}`,
    { headers: { Authorization: `Bearer ${process.env.LASTSCANNED_API_KEY}` } },
  );
  if (!res.ok) throw new Error(`Tracking lookup failed: ${res.status}`);
  const pkg = await res.json();

  // 2. If cross-border parcel handed off to a domestic last-mile courier, fetch the doorstep leg too
  let lastMilePkg = null;
  const handoffMatch = pkg.message?.match(/Handed to .+ as ([A-Z0-9]{8,34})/i);
  if (handoffMatch) {
    const lmRes = await fetch(
      `https://api.lastscanned.com/v1/track/${encodeURIComponent(handoffMatch[1])}`,
      { headers: { Authorization: `Bearer ${process.env.LASTSCANNED_API_KEY}` } },
    );
    if (lmRes.ok) lastMilePkg = await lmRes.json();
  }

  const activePkg = lastMilePkg ?? pkg;
  const timelineLines = activePkg.events.map(
    (e: { timestamp: string | null; localTime: string | null; status: string; location: string | null; description: string }) =>
      `${e.timestamp ?? e.localTime ?? "N/A"} | [${e.status.toUpperCase()}] ${e.location ?? "Carrier Network"} — ${e.description}`,
  );

  const evidenceSummary = [
    `CARRIER PROOF OF DELIVERY AUDIT LOG`,
    `Primary Tracking Number: ${pkg.trackingNumber} (${pkg.carrier.toUpperCase()})`,
    lastMilePkg ? `Final-Mile Tracking Number: ${lastMilePkg.trackingNumber} (${lastMilePkg.carrier.toUpperCase()})` : null,
    `Terminal Status: ${activePkg.status.toUpperCase()} (${activePkg.statusDescription ?? ""})`,
    `Delivered Timestamp (UTC): ${activePkg.deliveredAt ?? "See scan log"}`,
    `Delivered Timestamp (Local): ${activePkg.deliveredAtLocal ?? "See scan log"}`,
    activePkg.signedBy ? `Signed By: ${activePkg.signedBy}` : null,
    `Chronological Carrier Scans (${activePkg.events.length} checkpoints):`,
    ...timelineLines,
  ]
    .filter(Boolean)
    .join("\n");

  // 3. Submit structured fields + chronological checkpoint log to Stripe Dispute API
  await stripe.disputes.update(disputeId, {
    evidence: {
      customer_name: customerName,
      shipping_address: shippingAddress,
      shipping_carrier: activePkg.carrier.toUpperCase(),
      shipping_tracking_number: activePkg.trackingNumber,
      shipping_date: activePkg.events.at(-1)?.localTime?.slice(0, 10) ?? undefined,
      uncategorized_text: evidenceSummary,
    },
    submit: false, // Set true to auto-submit when activePkg.status === "delivered"
  });
}