feat: vehicle capacity info endpoint

Author: PalaashPandey

src/api.ts

@@ -20,6 +20,16 @@ export async function getMapVehicles(auth: string) {
     return await res.json()
 }
 
+/**
+ * get a list of the capacity information for all active buses
+ * @returns {VehicleCapacity[]} list of all capacity information for active buses
+*/
+export async function getVehicleCapacities() {
+    var res = await fetch('https://ridebtd.org/Services/JSONPRelay.svc/GetVehicleCapacities')
+
+    return await res.json()
+}
+
 /**
  * get the next stop times for a given route(s)
  * @param {string[]} routes route ids to get stop times for

src/index.ts

@@ -5,6 +5,7 @@ export {
 export {
     getRoutes,
     getMapVehicles,
+    getVehicleCapacities,
     getStopArrivalTimes,
     getAnnouncements
 } from "./api.js"

types/index.d.ts

@@ -83,6 +83,13 @@ declare module 'brazos-transit-api' {
         VehicleID: number;
     }
 
+    export interface VehicleCapacity {
+        Capacity: number;
+        CurrentOccupation: number;
+        Percentage: number;
+        VehicleID: number;
+    }
+
     interface TimeEstimate {
         EstimateTime: string; 
         IsArriving: boolean;
@@ -136,6 +143,12 @@ declare module 'brazos-transit-api' {
     */
     export async function getMapVehicles(auth: string): Promise<Vehicle[]>
 
+    /**
+     * get a list of the capacity information for all active buses
+     * @returns {VehicleCapacity[]} list of all capacity information for active buses
+    */
+    export async function getVehicleCapacities(): Promise<VehicleCapacity[]>
+
     /**
      * get the next stop times for a given route(s)
      * @param {string[]} routes route ids to get stop times for