packages/shipping-calculator/
├── src/
│   ├── schemas/shipping.schema.ts  # Zod schemas for Coordinates, DistanceTier, DeliverySlot
│   ├── haversine/haversine.ts      # calculateHaversineDistance, isWithinRadius
│   ├── pricing/pricing-engine.ts   # calculateShippingFee, isPeakHourTime, isNightDeliveryTime
│   ├── slots/slot-validator.ts     # validateDeliverySlot, getAvailableDeliverySlots, STANDARD_DELIVERY_SLOTS
│   ├── adapters/                   # Carrier integration adapters
│   │   ├── types.ts                # ShippingCarrierAdapter interface
│   │   ├── ahamove.adapter.ts      # AhaMove On-Demand API Adapter
│   │   ├── grabexpress.adapter.ts  # GrabExpress Delivery API Adapter
│   │   ├── ghtk.adapter.ts         # Giao Hang Tiet Kiem (GHTK) API Adapter
│   │   └── index.ts                # getAllCarrierQuotes, defaultCarrierAdapters
│   └── index.ts                    # SSoT Unified Barrel

import {
  calculateShippingFee,
  calculateHaversineDistance,
  validateDeliverySlot,
  getAvailableDeliverySlots,
  getAllCarrierQuotes,
  AhaMoveAdapter,
  GrabExpressAdapter,
  GHTKAdapter,
  type Coordinates,
} from '@kido/shipping-calculator';

// 1. Define Warehouse / Store Origin (District 1, Ho Chi Minh City)
const storeCoords: Coordinates = { latitude: 10.7769, longitude: 106.7009 };

// 2. Customer Delivery Destination (District 7, ~6.4 km)
const customerCoords: Coordinates = { latitude: 10.7327, longitude: 106.7188 };

// 3. Compute High-Speed Geodesic Distance
const distanceKm = calculateHaversineDistance(storeCoords, customerCoords);
console.log(`Estimated Direct Distance: ${distanceKm.toFixed(2)} km`);

// 4. Calculate Delivery Fee via Internal Fallback Engine
const feeResult = calculateShippingFee({
  origin: storeCoords,
  destination: customerCoords,
  orderValue: 180_000, // Order subtotal
  orderTime: new Date('2026-11-20T11:45:00+07:00'), // Peak lunch hour
});

console.log('Internal Tiered Fee Calculation:', {
  distanceKm: feeResult.distanceKm,
  baseFee: `${feeResult.baseFee.toLocaleString()}₫`,
  distanceSurcharges: `${feeResult.distanceFee.toLocaleString()}₫`,
  peakHourSurcharge: `${feeResult.peakHourSurcharge.toLocaleString()}₫`,
  totalShippingFee: `${feeResult.totalFee.toLocaleString()}₫`, // e.g. 39,500₫
  freeShippingApplied: feeResult.isFreeShipping,
});

// 5. Validate Customer's Selected Delivery Time Slot
const availableSlots = getAvailableDeliverySlots(new Date(), 45); // 45-minute kitchen prep time
console.log(`Available delivery windows today: ${availableSlots.length} slots`);

const slotValidation = validateDeliverySlot(
  'slot-afternoon-14-16',
  new Date(),
  45 // 45 min lead time
);
console.log('Slot Validation:', {
  slotId: 'slot-afternoon-14-16',
  isValid: slotValidation.isValid,
  reason: slotValidation.reason,
});

// 6. Query Live External Logistics Carriers in Parallel
async function fetchCarrierRates() {
  const adapters = [
    new AhaMoveAdapter({ apiKey: process.env.AHAMOVE_API_KEY || 'mock' }),
    new GrabExpressAdapter({ clientId: 'mock', clientSecret: 'mock' }),
    new GHTKAdapter({ apiToken: 'mock' }),
  ];

  const quotes = await getAllCarrierQuotes(
    {
      origin: storeCoords,
      destination: customerCoords,
      weightGrams: 1500, // 1.5kg
      orderValue: 180_000,
    },
    adapters
  );

  console.log('Multi-Carrier Real-Time Quotes:');
  quotes.forEach((q) => {
    console.log(`- [${q.carrierName}] ${q.serviceName}: ${q.fee.toLocaleString()}₫ (ETA: ${q.estimatedMinutes} mins)`);
  });
}

fetchCarrierRates();