{
  "type": "pickup_point_options",
  "handle": "dhl-packstation",
  "title": "DHL Packstation",
  "entrypoint": "dist/pickup-points.wasm",
  "network_access": true,
  "allowed_hosts": ["api.dhl.com"],
  "inputFields": {
    "shippingAddress": {
      "country": true,
      "city": true,
      "zip": true
    }
  }
}

interface PickupPointOptionsFunctionInput {
  cart: {
    items: CartItem[];        // same line shape as other function types
    totalPrice: number;       // Subtotal in display currency
    itemCount: number;        // Sum of quantities
    currency: string;         // e.g. "INR", "USD"
    localization?: { country: string; language: string };
    metafields?: MetafieldBag;
  };
  shippingAddress: {
    firstName?: string;
    lastName?: string;
    address1?: string;
    address2?: string;
    city?: string;
    province?: string;
    country?: string;         // country as entered — NOT `countryCode`
    zip?: string;             // NOT `postalCode`
    phone?: string;
  };
  currency: string;           // ISO-4217 of the cart presentment currency
  settings: Record<string, any>;  // Merchant-configured values from the install
}

interface CartItem {
  id: string;                 // lineItemId
  variantId: string;
  productId: string;
  title: string;
  quantity: number;
  price: number;              // Effective unit price (display currency)
  originalPrice: number;
}

interface PickupPointOptionsFunctionOutput {
  pickupOptions: Array<{
    id: string;             // carrier point id, e.g. "DHL_PACKSTATION_104"
    title: string;          // shown in checkout, e.g. "Packstation 104 - Berlin"
    address: {
      address1?: string;
      address2?: string;
      city?: string;
      province?: string;
      countryCode?: string;
      postalCode?: string;
      latitude?: number;
      longitude?: number;
    };
    hours?: string;         // free-text, e.g. "24/7"
    distance?: number;      // straight-line km from shippingAddress
    fee?: number;           // surcharge in cart currency (default 0)
  }>;
}

export default async function main(input) {
  const ship = input.shippingAddress;
  // Country arrives as `country` and postal code as `zip`
  if (!ship?.zip || ship.country !== 'DE') {
    return { pickupOptions: [] };
  }

  const res = await fetch(
    `https://api.dhl.com/location-finder/v1/find-by-address?countryCode=DE&postalCode=${encodeURIComponent(ship.zip)}&limit=5`,
    { headers: { 'DHL-API-Key': '<your-key>' } },
  );

  if (!res.ok) return { pickupOptions: [] };
  const data = await res.json();

  const pickupOptions = (data.locations ?? []).map((loc) => ({
    id: `DHL_${loc.locationType}_${loc.id}`,
    title: loc.name,
    address: {
      address1: loc.address.streetAddress,
      city: loc.address.addressLocality,
      countryCode: 'DE',
      postalCode: loc.address.postalCode,
      latitude: loc.geo?.latitude,
      longitude: loc.geo?.longitude,
    },
    hours: loc.openingHours ?? '24/7',
    distance: loc.distance,
    fee: 0,
  }));

  return { pickupOptions };
}