packages/geocoding-routing/
├── src/
│   ├── schemas.ts          # Zod schemas for Coordinates, Quotes, FareBreakdown
│   ├── haversine.ts        # haversineDistance, estimateRoadDistance, estimateTravelTimeMinutes
│   ├── osrm-client.ts      # getOsrmRoute, calculateOsrmDistanceAndDuration (OpenStreetMap Routing)
│   ├── airports.ts         # VIETNAM_AIRPORTS, AIRPORT_FIXED_ROUTES, findMatchingAirportRoute
│   ├── fare-calculator.ts  # calculateFare, createRouteQuote, isNightTime, isPeakHour
│   ├── geo-guard/          # 4-Layer Anti-Mock GPS, Vincenty & EXIF Verifier
│   │   ├── geofence.ts     # vincentyDistance, isInsideGeofence
│   │   ├── mock-detector.ts# detectMockLocation, checkTeleportation, checkAccuracyAnomaly
│   │   ├── exif-verifier.ts# extractExifFromBuffer, verifyPhotoProof
│   │   └── index.ts        # Geo-Guard Barrel
│   └── index.ts            # SSoT Unified Barrel

import {
  vincentyDistance,
  haversineDistance,
  detectMockLocation,
  isInsideGeofence,
  findMatchingAirportRoute,
  calculateFare,
  type CoordinatesInput,
  type MockDetectionInput,
} from '@kido/geocoding-routing';

// 1. Store Coordinates (Landmark 81, Ho Chi Minh City)
const storeLocation: CoordinatesInput = { lat: 10.7951, lon: 106.7218 };

// 2. Incoming Field Worker Telemetry
const incomingWorkerLocation: CoordinatesInput = { lat: 10.7954, lon: 106.7220 };

// 3. Compute High-Precision Vincenty Ellipsoidal Distance
const distanceMeters = vincentyDistance(storeLocation, incomingWorkerLocation);
console.log(`Worker distance to store: ${distanceMeters.toFixed(2)} meters`);

// 4. Verify Worker within 50m Geofence
const geofenceCheck = isInsideGeofence(
  incomingWorkerLocation,
  { ...storeLocation, radiusMeters: 50 },
  { formula: 'vincenty' }
);
console.log(`Is inside geofence: ${geofenceCheck.isInside}`);

// 5. 4-Layer Anti-Mock GPS Inspection
const mockInspectionInput: MockDetectionInput = {
  currentLocation: {
    lat: incomingWorkerLocation.lat,
    lon: incomingWorkerLocation.lon,
    accuracyMeters: 4.5,
    altitudeAccuracyMeters: 2.0,
    isMock: false, // Hardware reported flag
  },
  previousLocation: {
    lat: 10.7725, // Ben Thanh Market
    lon: 106.6980,
    timestampMs: Date.now() - 30_000, // 30 seconds ago (~3.5km away = 420 km/h impossible velocity!)
  },
  currentTimestampMs: Date.now(),
};

const mockResult = detectMockLocation(mockInspectionInput);
console.log('Mock Detection Report:', {
  isMockSuspected: mockResult.isMockSuspected,
  fraudRiskLevel: mockResult.fraudRiskLevel, // 'CRITICAL' due to teleportation velocity
  speedKmh: Math.round(mockResult.layers.teleportation.calculatedSpeedKmh || 0),
  reason: mockResult.reasons[0],
});

// 6. Airport Route & Tiered Fare Quoting (Noi Bai Airport to Hoan Kiem Lake)
const noiBaiCoords = { lat: 21.2212, lon: 105.8072 };
const hoanKiemCoords = { lat: 21.0285, lon: 105.8542 };

// Check for official fixed-fare package
const airportRoute = findMatchingAirportRoute(noiBaiCoords, hoanKiemCoords);
console.log('Airport Fixed Route Found:', airportRoute?.name ?? 'Standard Metered Fare');

// Compute Fare with Night / Surge rules
const fareQuote = calculateFare({
  distanceKm: 28.5,
  durationMinutes: 45,
  vehicleType: 'SEDAN_4_SEAT',
  time: new Date('2026-11-20T23:30:00+07:00'), // Night delivery
});

console.log('Fare Breakdown:', {
  baseFare: `${fareQuote.baseFare.toLocaleString()}₫`,
  nightSurcharge: `${fareQuote.nightSurcharge.toLocaleString()}₫`,
  totalFare: `${fareQuote.totalFare.toLocaleString()}₫`,
  depositRequired: `${fareQuote.depositAmount.toLocaleString()}₫`,
});