feat: ✨ basic implementation of mobility page (for ISBs)

Author: kagiura

package-lock.json

@@ -0,0 +1,5 @@
+{
+  "devDependencies": {
+    "@svgr/webpack": "^8.1.0"
+  }
+}

package.json

@@ -146,6 +146,7 @@
     "json2mq": "0.2.0",
     "leaflet": "1.9.4",
     "leaflet-gesture-handling": "1.2.2",
+    "leaflet-polylineoffset": "^1.1.1",
     "lodash": "4.17.21",
     "mousetrap": "1.6.5",
     "nusmoderator": "3.0.0",

website/package.json

@@ -0,0 +1,60 @@
+import axios from 'axios';
+import { BusStop } from 'types/buses';
+
+import { NextBus, NextBusTime, NextBusTimings } from 'types/venues';
+
+const baseUrl = 'https://nnextbus.nus.edu.sg';
+
+interface ShuttleServiceResult {
+  caption: string;
+  name: string;
+  shuttles: Shuttle[];
+}
+
+interface Shuttle {
+  arrivalTime: string;
+  name: string;
+  nextArrivalTime: string;
+  nextPassengers: string;
+  passengers: string;
+}
+
+function convertArrivalTime(arrivalTime: string): NextBusTime {
+  const numericTime = +arrivalTime;
+  if (!Number.isNaN(numericTime)) return numericTime;
+  if (arrivalTime === 'Arr' || arrivalTime === '-') return arrivalTime;
+  throw new Error(`Unknown arrival time ${arrivalTime}`);
+}
+
+export function getStops(): Promise<BusStop[]> {
+  const url = `${baseUrl}/BusStops`;
+  return axios
+    .get(url, {
+      headers: {
+        Authorization: process.env?.NEXTBUS_API_AUTH || '',
+      },
+    })
+    .then((response) => response.data.BusStopsResult.busstops);
+}
+
+export function nextBus(code: string): Promise<any> {
+  const url = `${baseUrl}/arrival`;
+  return axios
+    .get<{
+      ShuttleServiceResult: ShuttleServiceResult;
+    }>(url, { params: { busstopname: code } })
+    .then((response) => {
+      const shuttles: NextBusTimings = {};
+
+      response.data.ShuttleServiceResult.shuttles.forEach((arrival: Shuttle) => {
+        const timing: NextBus = {
+          arrivalTime: convertArrivalTime(arrival.arrivalTime),
+          nextArrivalTime: convertArrivalTime(arrival.nextArrivalTime),
+        };
+
+        shuttles[arrival.name] = timing;
+      });
+
+      return shuttles;
+    });
+}