Schedule warehouse ship-out dates

curl --request POST \
  --url https://api.goshippo.com/v2/estimates \
  --header 'Authorization: ShippoToken <API_TOKEN>' \
  --header 'Content-Type: application/json' \
  --data '{
    "origin": {
      "zip": "95122"
    },
    "destination": {
      "zip": "94103"
    },
    "parcel": {
      "length": 10,
      "width": 8,
      "height": 4,
      "distance_unit": "in",
      "weight": 2,
      "mass_unit": "lb"
    },
    "planned_ship_date": "2026-05-01T22:00:00Z"
  }'

{
  "object_id": "2b3c4d5e-...",
  "planned_ship_date": "2026-05-01T22:00:00Z",
  "confidence_level": "DEFAULT",
  "predictions": [
    {
      "provider": "FedEx",
      "servicelevel": {
        "name": "Priority Overnight",
        "token": "fedex_priority_overnight"
      },
      "estimated_delivery_date_utc": "2026-05-02T20:00:00Z",
      "estimated_transit_days": 1
    },
    {
      "provider": "USPS",
      "servicelevel": {
        "name": "Priority Mail",
        "token": "usps_priority"
      },
      "estimated_delivery_date_utc": "2026-05-03T20:00:00Z",
      "estimated_transit_days": 2
    },
    {
      "provider": "UPS",
      "servicelevel": {
        "name": "Ground",
        "token": "ups_ground"
      },
      "estimated_delivery_date_utc": "2026-05-05T20:00:00Z",
      "estimated_transit_days": 4
    }
  ],
  "test": false
}

const CUSTOMER_SELECTED_TOKEN = "usps_priority";
const WAREHOUSE_TIMEZONE = "America/Los_Angeles";

// Find the prediction matching what the customer chose
const selectedPrediction = estimatesResponse.predictions.find(
  p => p.servicelevel.token === CUSTOMER_SELECTED_TOKEN
);

// A partial response can omit a service level. Check messages[] for the reason.
if (!selectedPrediction) {
  throw new Error(`No prediction for ${CUSTOMER_SELECTED_TOKEN}`);
}

// planned_ship_date is the cutoff the warehouse must meet
const shipByLocal = new Date(estimatesResponse.planned_ship_date)
  .toLocaleString("en-US", {
    timeZone: WAREHOUSE_TIMEZONE,
    dateStyle: "short",
    timeStyle: "short"
  });

const warehouseTask = {
  orderId: order.id,
  carrier: selectedPrediction.provider,
  service: selectedPrediction.servicelevel.name,
  servicelevelToken: selectedPrediction.servicelevel.token,
  shipBy: estimatesResponse.planned_ship_date,     // "2026-05-01T22:00:00Z" — UTC for storage
  shipByLocal: shipByLocal,                        // "5/1/26, 3:00 PM" — local time for display
  estimatedDeliveryUtc: selectedPrediction.estimated_delivery_date_utc,
  transitDays: selectedPrediction.estimated_transit_days,
  priority: isCutoffApproaching(estimatesResponse.planned_ship_date) ? "URGENT" : "STANDARD",
};

// Send to your WMS or fulfillment queue
await warehouseQueue.enqueue(warehouseTask);

function getNextShipDate(cutoffHourUTC = 22) {
  const now = new Date();
  const cutoff = new Date(now);
  cutoff.setUTCHours(cutoffHourUTC, 0, 0, 0);

  // If we've passed today's cutoff, ship tomorrow
  if (now >= cutoff) {
    cutoff.setUTCDate(cutoff.getUTCDate() + 1);
  }
  return cutoff.toISOString();
}

function isCutoffApproaching(plannedShipDateUtc, warningWindowMinutes = 60) {
  const cutoff = new Date(plannedShipDateUtc);
  const now = new Date();
  const msUntilCutoff = cutoff - now;
  return msUntilCutoff > 0 && msUntilCutoff <= warningWindowMinutes * 60 * 1000;
}

// Use the result as planned_ship_date in your estimates request
const plannedShipDate = getNextShipDate(22); // 22:00 UTC = 3 PM PDT (2 PM PST)